From 564398d0ddbce6ead340287aaee80fdba4f23969 Mon Sep 17 00:00:00 2001 From: ada-dmitry Date: Mon, 26 Aug 2024 20:22:16 +0300 Subject: [PATCH] init new bot --- .gitignore | 5 +- bot.log | 2 + bot.py | 114 - .../typing_extensions.cpython-311.pyc | Bin 0 -> 151464 bytes .../aiofiles-23.2.1.dist-info/INSTALLER | 1 + .../aiofiles-23.2.1.dist-info/METADATA | 291 + .../aiofiles-23.2.1.dist-info/RECORD | 26 + .../aiofiles-23.2.1.dist-info/WHEEL | 4 + .../licenses/LICENSE | 202 + .../aiofiles-23.2.1.dist-info/licenses/NOTICE | 2 + env/Lib/site-packages/aiofiles/__init__.py | 22 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 612 bytes .../aiofiles/__pycache__/base.cpython-311.pyc | Bin 0 -> 6913 bytes .../aiofiles/__pycache__/os.cpython-311.pyc | Bin 0 -> 1651 bytes .../__pycache__/ospath.cpython-311.pyc | Bin 0 -> 1721 bytes env/Lib/site-packages/aiofiles/base.py | 113 + env/Lib/site-packages/aiofiles/os.py | 51 + env/Lib/site-packages/aiofiles/ospath.py | 28 + .../aiofiles/tempfile/__init__.py | 357 ++ .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 9347 bytes .../__pycache__/temptypes.cpython-311.pyc | Bin 0 -> 3934 bytes .../aiofiles/tempfile/temptypes.py | 69 + .../aiofiles/threadpool/__init__.py | 141 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 5195 bytes .../__pycache__/binary.cpython-311.pyc | Bin 0 -> 3558 bytes .../__pycache__/text.cpython-311.pyc | Bin 0 -> 1823 bytes .../__pycache__/utils.cpython-311.pyc | Bin 0 -> 4135 bytes .../aiofiles/threadpool/binary.py | 104 + .../site-packages/aiofiles/threadpool/text.py | 64 + .../aiofiles/threadpool/utils.py | 72 + .../aiogram-3.12.0.dist-info/INSTALLER | 1 + .../aiogram-3.12.0.dist-info/METADATA | 163 + .../aiogram-3.12.0.dist-info/RECORD | 961 ++++ .../aiogram-3.12.0.dist-info/REQUESTED | 0 .../aiogram-3.12.0.dist-info/WHEEL | 4 + .../aiogram-3.12.0.dist-info/licenses/LICENSE | 18 + env/Lib/site-packages/aiogram/__init__.py | 41 + env/Lib/site-packages/aiogram/__meta__.py | 2 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 1614 bytes .../__pycache__/__meta__.cpython-311.pyc | Bin 0 -> 229 bytes .../__pycache__/exceptions.cpython-311.pyc | Bin 0 -> 10244 bytes .../__pycache__/loggers.cpython-311.pyc | Bin 0 -> 598 bytes .../site-packages/aiogram/client/__init__.py | 0 .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 184 bytes .../client/__pycache__/bot.cpython-311.pyc | Bin 0 -> 251914 bytes .../context_controller.cpython-311.pyc | Bin 0 -> 1844 bytes .../__pycache__/default.cpython-311.pyc | Bin 0 -> 3822 bytes .../__pycache__/telegram.cpython-311.pyc | Bin 0 -> 6080 bytes env/Lib/site-packages/aiogram/client/bot.py | 4761 +++++++++++++++++ .../aiogram/client/context_controller.py | 33 + .../site-packages/aiogram/client/default.py | 85 + .../aiogram/client/session/__init__.py | 0 .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 192 bytes .../__pycache__/aiohttp.cpython-311.pyc | Bin 0 -> 11243 bytes .../session/__pycache__/base.cpython-311.pyc | Bin 0 -> 11434 bytes .../aiogram/client/session/aiohttp.py | 215 + .../aiogram/client/session/base.py | 265 + .../client/session/middlewares/__init__.py | 0 .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 204 bytes .../__pycache__/base.cpython-311.pyc | Bin 0 -> 2553 bytes .../__pycache__/manager.cpython-311.pyc | Bin 0 -> 3792 bytes .../request_logging.cpython-311.pyc | Bin 0 -> 2269 bytes .../client/session/middlewares/base.py | 53 + .../client/session/middlewares/manager.py | 62 + .../session/middlewares/request_logging.py | 37 + .../site-packages/aiogram/client/telegram.py | 103 + .../aiogram/dispatcher/__init__.py | 0 .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 188 bytes .../__pycache__/dispatcher.cpython-311.pyc | Bin 0 -> 29372 bytes .../__pycache__/flags.cpython-311.pyc | Bin 0 -> 6939 bytes .../__pycache__/router.cpython-311.pyc | Bin 0 -> 12836 bytes .../aiogram/dispatcher/dispatcher.py | 598 +++ .../aiogram/dispatcher/event/__init__.py | 0 .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 194 bytes .../event/__pycache__/bases.cpython-311.pyc | Bin 0 -> 1806 bytes .../event/__pycache__/event.cpython-311.pyc | Bin 0 -> 2661 bytes .../event/__pycache__/handler.cpython-311.pyc | Bin 0 -> 6941 bytes .../__pycache__/telegram.cpython-311.pyc | Bin 0 -> 7459 bytes .../aiogram/dispatcher/event/bases.py | 35 + .../aiogram/dispatcher/event/event.py | 53 + .../aiogram/dispatcher/event/handler.py | 99 + .../aiogram/dispatcher/event/telegram.py | 141 + .../site-packages/aiogram/dispatcher/flags.py | 127 + .../dispatcher/middlewares/__init__.py | 0 .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 200 bytes .../__pycache__/base.cpython-311.pyc | Bin 0 -> 1551 bytes .../__pycache__/error.cpython-311.pyc | Bin 0 -> 2260 bytes .../__pycache__/manager.cpython-311.pyc | Bin 0 -> 4299 bytes .../__pycache__/user_context.cpython-311.pyc | Bin 0 -> 7767 bytes .../aiogram/dispatcher/middlewares/base.py | 29 + .../aiogram/dispatcher/middlewares/error.py | 36 + .../aiogram/dispatcher/middlewares/manager.py | 65 + .../dispatcher/middlewares/user_context.py | 178 + .../aiogram/dispatcher/router.py | 271 + .../site-packages/aiogram/enums/__init__.py | 59 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 2410 bytes .../bot_command_scope_type.cpython-311.pyc | Bin 0 -> 946 bytes .../__pycache__/chat_action.cpython-311.pyc | Bin 0 -> 1446 bytes .../chat_boost_source_type.cpython-311.pyc | Bin 0 -> 731 bytes .../chat_member_status.cpython-311.pyc | Bin 0 -> 793 bytes .../__pycache__/chat_type.cpython-311.pyc | Bin 0 -> 727 bytes .../__pycache__/content_type.cpython-311.pyc | Bin 0 -> 2948 bytes .../__pycache__/currency.cpython-311.pyc | Bin 0 -> 2262 bytes .../__pycache__/dice_emoji.cpython-311.pyc | Bin 0 -> 772 bytes ...encrypted_passport_element.cpython-311.pyc | Bin 0 -> 1197 bytes .../inline_query_result_type.cpython-311.pyc | Bin 0 -> 951 bytes .../input_media_type.cpython-311.pyc | Bin 0 -> 745 bytes .../input_paid_media_type.cpython-311.pyc | Bin 0 -> 697 bytes ...oard_button_poll_type_type.cpython-311.pyc | Bin 0 -> 783 bytes .../mask_position_point.cpython-311.pyc | Bin 0 -> 744 bytes .../menu_button_type.cpython-311.pyc | Bin 0 -> 712 bytes .../message_entity_type.cpython-311.pyc | Bin 0 -> 1203 bytes .../message_origin_type.cpython-311.pyc | Bin 0 -> 733 bytes .../paid_media_type.cpython-311.pyc | Bin 0 -> 708 bytes .../__pycache__/parse_mode.cpython-311.pyc | Bin 0 -> 675 bytes ...assport_element_error_type.cpython-311.pyc | Bin 0 -> 950 bytes .../__pycache__/poll_type.cpython-311.pyc | Bin 0 -> 638 bytes .../reaction_type_type.cpython-311.pyc | Bin 0 -> 680 bytes ...enue_withdrawal_state_type.cpython-311.pyc | Bin 0 -> 751 bytes .../sticker_format.cpython-311.pyc | Bin 0 -> 681 bytes .../__pycache__/sticker_type.cpython-311.pyc | Bin 0 -> 722 bytes .../topic_icon_color.cpython-311.pyc | Bin 0 -> 838 bytes .../transaction_partner_type.cpython-311.pyc | Bin 0 -> 764 bytes .../__pycache__/update_type.cpython-311.pyc | Bin 0 -> 1599 bytes .../aiogram/enums/bot_command_scope_type.py | 17 + .../aiogram/enums/chat_action.py | 32 + .../aiogram/enums/chat_boost_source_type.py | 13 + .../aiogram/enums/chat_member_status.py | 16 + .../site-packages/aiogram/enums/chat_type.py | 15 + .../aiogram/enums/content_type.py | 66 + .../site-packages/aiogram/enums/currency.py | 96 + .../site-packages/aiogram/enums/dice_emoji.py | 16 + .../enums/encrypted_passport_element.py | 23 + .../aiogram/enums/inline_query_result_type.py | 23 + .../aiogram/enums/input_media_type.py | 15 + .../aiogram/enums/input_paid_media_type.py | 12 + .../enums/keyboard_button_poll_type_type.py | 12 + .../aiogram/enums/mask_position_point.py | 14 + .../aiogram/enums/menu_button_type.py | 13 + .../aiogram/enums/message_entity_type.py | 29 + .../aiogram/enums/message_origin_type.py | 14 + .../aiogram/enums/paid_media_type.py | 13 + .../site-packages/aiogram/enums/parse_mode.py | 13 + .../enums/passport_element_error_type.py | 19 + .../site-packages/aiogram/enums/poll_type.py | 12 + .../aiogram/enums/reaction_type_type.py | 12 + .../enums/revenue_withdrawal_state_type.py | 13 + .../aiogram/enums/sticker_format.py | 13 + .../aiogram/enums/sticker_type.py | 13 + .../aiogram/enums/topic_icon_color.py | 16 + .../aiogram/enums/transaction_partner_type.py | 14 + .../aiogram/enums/update_type.py | 32 + env/Lib/site-packages/aiogram/exceptions.py | 199 + .../site-packages/aiogram/filters/__init__.py | 51 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 1311 bytes .../filters/__pycache__/base.cpython-311.pyc | Bin 0 -> 3457 bytes .../__pycache__/callback_data.cpython-311.pyc | Bin 0 -> 10040 bytes .../chat_member_updated.cpython-311.pyc | Bin 0 -> 12390 bytes .../__pycache__/command.cpython-311.pyc | Bin 0 -> 13577 bytes .../__pycache__/exception.cpython-311.pyc | Bin 0 -> 3324 bytes .../filters/__pycache__/logic.cpython-311.pyc | Bin 0 -> 4841 bytes .../__pycache__/magic_data.cpython-311.pyc | Bin 0 -> 1773 bytes .../filters/__pycache__/state.cpython-311.pyc | Bin 0 -> 2624 bytes env/Lib/site-packages/aiogram/filters/base.py | 55 + .../aiogram/filters/callback_data.py | 207 + .../aiogram/filters/chat_member_updated.py | 204 + .../site-packages/aiogram/filters/command.py | 298 ++ .../aiogram/filters/exception.py | 55 + .../site-packages/aiogram/filters/logic.py | 77 + .../aiogram/filters/magic_data.py | 27 + .../site-packages/aiogram/filters/state.py | 43 + env/Lib/site-packages/aiogram/fsm/__init__.py | 0 .../fsm/__pycache__/__init__.cpython-311.pyc | Bin 0 -> 181 bytes .../fsm/__pycache__/context.cpython-311.pyc | Bin 0 -> 3128 bytes .../__pycache__/middleware.cpython-311.pyc | Bin 0 -> 5408 bytes .../fsm/__pycache__/scene.cpython-311.pyc | Bin 0 -> 47876 bytes .../fsm/__pycache__/state.cpython-311.pyc | Bin 0 -> 10518 bytes .../fsm/__pycache__/strategy.cpython-311.pyc | Bin 0 -> 1548 bytes env/Lib/site-packages/aiogram/fsm/context.py | 32 + .../site-packages/aiogram/fsm/middleware.py | 113 + env/Lib/site-packages/aiogram/fsm/scene.py | 912 ++++ env/Lib/site-packages/aiogram/fsm/state.py | 172 + .../aiogram/fsm/storage/__init__.py | 0 .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 189 bytes .../storage/__pycache__/base.cpython-311.pyc | Bin 0 -> 8565 bytes .../__pycache__/memory.cpython-311.pyc | Bin 0 -> 5502 bytes .../storage/__pycache__/mongo.cpython-311.pyc | Bin 0 -> 7664 bytes .../storage/__pycache__/redis.cpython-311.pyc | Bin 0 -> 9175 bytes .../site-packages/aiogram/fsm/storage/base.py | 183 + .../aiogram/fsm/storage/memory.py | 74 + .../aiogram/fsm/storage/mongo.py | 130 + .../aiogram/fsm/storage/redis.py | 169 + env/Lib/site-packages/aiogram/fsm/strategy.py | 37 + .../aiogram/handlers/__init__.py | 25 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 1030 bytes .../handlers/__pycache__/base.cpython-311.pyc | Bin 0 -> 2918 bytes .../callback_query.cpython-311.pyc | Bin 0 -> 2033 bytes .../__pycache__/chat_member.cpython-311.pyc | Bin 0 -> 985 bytes .../chosen_inline_result.cpython-311.pyc | Bin 0 -> 1243 bytes .../__pycache__/error.cpython-311.pyc | Bin 0 -> 1169 bytes .../__pycache__/inline_query.cpython-311.pyc | Bin 0 -> 1198 bytes .../__pycache__/message.cpython-311.pyc | Bin 0 -> 2004 bytes .../handlers/__pycache__/poll.cpython-311.pyc | Bin 0 -> 1235 bytes .../pre_checkout_query.cpython-311.pyc | Bin 0 -> 998 bytes .../shipping_query.cpython-311.pyc | Bin 0 -> 986 bytes .../site-packages/aiogram/handlers/base.py | 46 + .../aiogram/handlers/callback_query.py | 43 + .../aiogram/handlers/chat_member.py | 14 + .../aiogram/handlers/chosen_inline_result.py | 18 + .../site-packages/aiogram/handlers/error.py | 17 + .../aiogram/handlers/inline_query.py | 18 + .../site-packages/aiogram/handlers/message.py | 28 + .../site-packages/aiogram/handlers/poll.py | 19 + .../aiogram/handlers/pre_checkout_query.py | 14 + .../aiogram/handlers/shipping_query.py | 14 + env/Lib/site-packages/aiogram/loggers.py | 7 + .../site-packages/aiogram/methods/__init__.py | 259 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 10593 bytes .../add_sticker_to_set.cpython-311.pyc | Bin 0 -> 1790 bytes .../answer_callback_query.cpython-311.pyc | Bin 0 -> 2471 bytes .../answer_inline_query.cpython-311.pyc | Bin 0 -> 4142 bytes .../answer_pre_checkout_query.cpython-311.pyc | Bin 0 -> 2066 bytes .../answer_shipping_query.cpython-311.pyc | Bin 0 -> 2153 bytes .../answer_web_app_query.cpython-311.pyc | Bin 0 -> 3394 bytes .../approve_chat_join_request.cpython-311.pyc | Bin 0 -> 1746 bytes .../ban_chat_member.cpython-311.pyc | Bin 0 -> 2250 bytes .../ban_chat_sender_chat.cpython-311.pyc | Bin 0 -> 1945 bytes .../methods/__pycache__/base.cpython-311.pyc | Bin 0 -> 5123 bytes .../methods/__pycache__/close.cpython-311.pyc | Bin 0 -> 1066 bytes .../close_forum_topic.cpython-311.pyc | Bin 0 -> 1772 bytes .../close_general_forum_topic.cpython-311.pyc | Bin 0 -> 1715 bytes .../__pycache__/copy_message.cpython-311.pyc | Bin 0 -> 4262 bytes .../__pycache__/copy_messages.cpython-311.pyc | Bin 0 -> 3008 bytes .../create_chat_invite_link.cpython-311.pyc | Bin 0 -> 2455 bytes ...t_subscription_invite_link.cpython-311.pyc | Bin 0 -> 2532 bytes .../create_forum_topic.cpython-311.pyc | Bin 0 -> 2114 bytes .../create_invoice_link.cpython-311.pyc | Bin 0 -> 3682 bytes .../create_new_sticker_set.cpython-311.pyc | Bin 0 -> 2362 bytes .../decline_chat_join_request.cpython-311.pyc | Bin 0 -> 1746 bytes .../delete_chat_photo.cpython-311.pyc | Bin 0 -> 1667 bytes .../delete_chat_sticker_set.cpython-311.pyc | Bin 0 -> 1834 bytes .../delete_forum_topic.cpython-311.pyc | Bin 0 -> 1770 bytes .../delete_message.cpython-311.pyc | Bin 0 -> 2335 bytes .../delete_messages.cpython-311.pyc | Bin 0 -> 1713 bytes .../delete_my_commands.cpython-311.pyc | Bin 0 -> 2491 bytes .../delete_sticker_from_set.cpython-311.pyc | Bin 0 -> 1528 bytes .../delete_sticker_set.cpython-311.pyc | Bin 0 -> 1477 bytes .../delete_webhook.cpython-311.pyc | Bin 0 -> 1643 bytes .../edit_chat_invite_link.cpython-311.pyc | Bin 0 -> 2413 bytes ...t_subscription_invite_link.cpython-311.pyc | Bin 0 -> 2026 bytes .../edit_forum_topic.cpython-311.pyc | Bin 0 -> 2023 bytes .../edit_general_forum_topic.cpython-311.pyc | Bin 0 -> 1778 bytes .../edit_message_caption.cpython-311.pyc | Bin 0 -> 3215 bytes ...edit_message_live_location.cpython-311.pyc | Bin 0 -> 3088 bytes .../edit_message_media.cpython-311.pyc | Bin 0 -> 3196 bytes .../edit_message_reply_markup.cpython-311.pyc | Bin 0 -> 2514 bytes .../edit_message_text.cpython-311.pyc | Bin 0 -> 3633 bytes .../export_chat_invite_link.cpython-311.pyc | Bin 0 -> 2282 bytes .../forward_message.cpython-311.pyc | Bin 0 -> 2408 bytes .../forward_messages.cpython-311.pyc | Bin 0 -> 2574 bytes .../get_business_connection.cpython-311.pyc | Bin 0 -> 1705 bytes .../__pycache__/get_chat.cpython-311.pyc | Bin 0 -> 1587 bytes .../get_chat_administrators.cpython-311.pyc | Bin 0 -> 2100 bytes .../get_chat_member.cpython-311.pyc | Bin 0 -> 2135 bytes .../get_chat_member_count.cpython-311.pyc | Bin 0 -> 1537 bytes .../get_chat_menu_button.cpython-311.pyc | Bin 0 -> 1907 bytes .../get_custom_emoji_stickers.cpython-311.pyc | Bin 0 -> 1722 bytes .../__pycache__/get_file.cpython-311.pyc | Bin 0 -> 2131 bytes ..._forum_topic_icon_stickers.cpython-311.pyc | Bin 0 -> 1123 bytes .../get_game_high_scores.cpython-311.pyc | Bin 0 -> 2352 bytes .../__pycache__/get_me.cpython-311.pyc | Bin 0 -> 934 bytes .../get_my_commands.cpython-311.pyc | Bin 0 -> 2513 bytes ...fault_administrator_rights.cpython-311.pyc | Bin 0 -> 1830 bytes .../get_my_description.cpython-311.pyc | Bin 0 -> 1707 bytes .../__pycache__/get_my_name.cpython-311.pyc | Bin 0 -> 1602 bytes .../get_my_short_description.cpython-311.pyc | Bin 0 -> 1761 bytes .../get_star_transactions.cpython-311.pyc | Bin 0 -> 1800 bytes .../get_sticker_set.cpython-311.pyc | Bin 0 -> 1530 bytes .../__pycache__/get_updates.cpython-311.pyc | Bin 0 -> 2228 bytes .../get_user_chat_boosts.cpython-311.pyc | Bin 0 -> 1743 bytes .../get_user_profile_photos.cpython-311.pyc | Bin 0 -> 1862 bytes .../get_webhook_info.cpython-311.pyc | Bin 0 -> 1070 bytes .../hide_general_forum_topic.cpython-311.pyc | Bin 0 -> 1759 bytes .../__pycache__/leave_chat.cpython-311.pyc | Bin 0 -> 1503 bytes .../__pycache__/log_out.cpython-311.pyc | Bin 0 -> 1135 bytes .../pin_chat_message.cpython-311.pyc | Bin 0 -> 2109 bytes .../promote_chat_member.cpython-311.pyc | Bin 0 -> 3546 bytes .../refund_star_payment.cpython-311.pyc | Bin 0 -> 1601 bytes .../reopen_forum_topic.cpython-311.pyc | Bin 0 -> 1780 bytes ...reopen_general_forum_topic.cpython-311.pyc | Bin 0 -> 1782 bytes .../replace_sticker_in_set.cpython-311.pyc | Bin 0 -> 2050 bytes .../restrict_chat_member.cpython-311.pyc | Bin 0 -> 2289 bytes .../revoke_chat_invite_link.cpython-311.pyc | Bin 0 -> 1943 bytes .../send_animation.cpython-311.pyc | Bin 0 -> 4883 bytes .../__pycache__/send_audio.cpython-311.pyc | Bin 0 -> 4730 bytes .../send_chat_action.cpython-311.pyc | Bin 0 -> 2502 bytes .../__pycache__/send_contact.cpython-311.pyc | Bin 0 -> 3570 bytes .../__pycache__/send_dice.cpython-311.pyc | Bin 0 -> 3369 bytes .../__pycache__/send_document.cpython-311.pyc | Bin 0 -> 4371 bytes .../__pycache__/send_game.cpython-311.pyc | Bin 0 -> 3092 bytes .../__pycache__/send_invoice.cpython-311.pyc | Bin 0 -> 5305 bytes .../__pycache__/send_location.cpython-311.pyc | Bin 0 -> 4006 bytes .../send_media_group.cpython-311.pyc | Bin 0 -> 3603 bytes .../__pycache__/send_message.cpython-311.pyc | Bin 0 -> 4212 bytes .../send_paid_media.cpython-311.pyc | Bin 0 -> 3219 bytes .../__pycache__/send_photo.cpython-311.pyc | Bin 0 -> 4271 bytes .../__pycache__/send_poll.cpython-311.pyc | Bin 0 -> 5237 bytes .../__pycache__/send_sticker.cpython-311.pyc | Bin 0 -> 3619 bytes .../__pycache__/send_venue.cpython-311.pyc | Bin 0 -> 4126 bytes .../__pycache__/send_video.cpython-311.pyc | Bin 0 -> 5024 bytes .../send_video_note.cpython-311.pyc | Bin 0 -> 3835 bytes .../__pycache__/send_voice.cpython-311.pyc | Bin 0 -> 4304 bytes ...administrator_custom_title.cpython-311.pyc | Bin 0 -> 1792 bytes .../set_chat_description.cpython-311.pyc | Bin 0 -> 1835 bytes .../set_chat_menu_button.cpython-311.pyc | Bin 0 -> 1942 bytes .../set_chat_permissions.cpython-311.pyc | Bin 0 -> 2008 bytes .../set_chat_photo.cpython-311.pyc | Bin 0 -> 1792 bytes .../set_chat_sticker_set.cpython-311.pyc | Bin 0 -> 1886 bytes .../set_chat_title.cpython-311.pyc | Bin 0 -> 1719 bytes ...moji_sticker_set_thumbnail.cpython-311.pyc | Bin 0 -> 1765 bytes .../set_game_score.cpython-311.pyc | Bin 0 -> 2465 bytes .../set_message_reaction.cpython-311.pyc | Bin 0 -> 2400 bytes .../set_my_commands.cpython-311.pyc | Bin 0 -> 2534 bytes ...fault_administrator_rights.cpython-311.pyc | Bin 0 -> 2054 bytes .../set_my_description.cpython-311.pyc | Bin 0 -> 1716 bytes .../__pycache__/set_my_name.cpython-311.pyc | Bin 0 -> 1612 bytes .../set_my_short_description.cpython-311.pyc | Bin 0 -> 1806 bytes .../set_passport_data_errors.cpython-311.pyc | Bin 0 -> 2967 bytes .../set_sticker_emoji_list.cpython-311.pyc | Bin 0 -> 1708 bytes .../set_sticker_keywords.cpython-311.pyc | Bin 0 -> 1777 bytes .../set_sticker_mask_position.cpython-311.pyc | Bin 0 -> 1891 bytes ...et_sticker_position_in_set.cpython-311.pyc | Bin 0 -> 1632 bytes .../set_sticker_set_thumbnail.cpython-311.pyc | Bin 0 -> 1993 bytes .../set_sticker_set_title.cpython-311.pyc | Bin 0 -> 1563 bytes .../__pycache__/set_webhook.cpython-311.pyc | Bin 0 -> 3400 bytes ...stop_message_live_location.cpython-311.pyc | Bin 0 -> 2376 bytes .../__pycache__/stop_poll.cpython-311.pyc | Bin 0 -> 1955 bytes .../unban_chat_member.cpython-311.pyc | Bin 0 -> 2189 bytes .../unban_chat_sender_chat.cpython-311.pyc | Bin 0 -> 1758 bytes ...unhide_general_forum_topic.cpython-311.pyc | Bin 0 -> 1718 bytes .../unpin_all_chat_messages.cpython-311.pyc | Bin 0 -> 1792 bytes ...n_all_forum_topic_messages.cpython-311.pyc | Bin 0 -> 1821 bytes ...neral_forum_topic_messages.cpython-311.pyc | Bin 0 -> 1793 bytes .../unpin_chat_message.cpython-311.pyc | Bin 0 -> 2047 bytes .../upload_sticker_file.cpython-311.pyc | Bin 0 -> 2010 bytes .../aiogram/methods/add_sticker_to_set.py | 42 + .../aiogram/methods/answer_callback_query.py | 56 + .../aiogram/methods/answer_inline_query.py | 145 + .../methods/answer_pre_checkout_query.py | 46 + .../aiogram/methods/answer_shipping_query.py | 51 + .../aiogram/methods/answer_web_app_query.py | 103 + .../methods/approve_chat_join_request.py | 34 + .../aiogram/methods/ban_chat_member.py | 51 + .../aiogram/methods/ban_chat_sender_chat.py | 38 + env/Lib/site-packages/aiogram/methods/base.py | 95 + .../site-packages/aiogram/methods/close.py | 14 + .../aiogram/methods/close_forum_topic.py | 40 + .../methods/close_general_forum_topic.py | 32 + .../aiogram/methods/copy_message.py | 116 + .../aiogram/methods/copy_messages.py | 61 + .../methods/create_chat_invite_link.py | 56 + .../create_chat_subscription_invite_link.py | 52 + .../aiogram/methods/create_forum_topic.py | 51 + .../aiogram/methods/create_invoice_link.py | 115 + .../aiogram/methods/create_new_sticker_set.py | 68 + .../methods/decline_chat_join_request.py | 34 + .../aiogram/methods/delete_chat_photo.py | 32 + .../methods/delete_chat_sticker_set.py | 32 + .../aiogram/methods/delete_forum_topic.py | 40 + .../aiogram/methods/delete_message.py | 56 + .../aiogram/methods/delete_messages.py | 36 + .../aiogram/methods/delete_my_commands.py | 67 + .../methods/delete_sticker_from_set.py | 30 + .../aiogram/methods/delete_sticker_set.py | 30 + .../aiogram/methods/delete_webhook.py | 35 + .../aiogram/methods/edit_chat_invite_link.py | 60 + .../edit_chat_subscription_invite_link.py | 44 + .../aiogram/methods/edit_forum_topic.py | 50 + .../methods/edit_general_forum_topic.py | 34 + .../aiogram/methods/edit_message_caption.py | 74 + .../methods/edit_message_live_location.py | 79 + .../aiogram/methods/edit_message_media.py | 75 + .../methods/edit_message_reply_markup.py | 55 + .../aiogram/methods/edit_message_text.py | 91 + .../methods/export_chat_invite_link.py | 34 + .../aiogram/methods/forward_message.py | 61 + .../aiogram/methods/forward_messages.py | 57 + .../methods/get_business_connection.py | 34 + .../site-packages/aiogram/methods/get_chat.py | 33 + .../methods/get_chat_administrators.py | 62 + .../aiogram/methods/get_chat_member.py | 60 + .../aiogram/methods/get_chat_member_count.py | 32 + .../aiogram/methods/get_chat_menu_button.py | 35 + .../methods/get_custom_emoji_stickers.py | 33 + .../site-packages/aiogram/methods/get_file.py | 32 + .../methods/get_forum_topic_icon_stickers.py | 17 + .../aiogram/methods/get_game_high_scores.py | 53 + .../site-packages/aiogram/methods/get_me.py | 15 + .../aiogram/methods/get_my_commands.py | 68 + .../get_my_default_administrator_rights.py | 33 + .../aiogram/methods/get_my_description.py | 33 + .../aiogram/methods/get_my_name.py | 31 + .../methods/get_my_short_description.py | 33 + .../aiogram/methods/get_star_transactions.py | 39 + .../aiogram/methods/get_sticker_set.py | 31 + .../aiogram/methods/get_updates.py | 57 + .../aiogram/methods/get_user_chat_boosts.py | 33 + .../methods/get_user_profile_photos.py | 42 + .../aiogram/methods/get_webhook_info.py | 15 + .../methods/hide_general_forum_topic.py | 32 + .../aiogram/methods/leave_chat.py | 32 + .../site-packages/aiogram/methods/log_out.py | 14 + .../aiogram/methods/pin_chat_message.py | 50 + .../aiogram/methods/promote_chat_member.py | 102 + .../aiogram/methods/refund_star_payment.py | 42 + .../aiogram/methods/reopen_forum_topic.py | 40 + .../methods/reopen_general_forum_topic.py | 32 + .../aiogram/methods/replace_sticker_in_set.py | 51 + .../aiogram/methods/restrict_chat_member.py | 56 + .../methods/revoke_chat_invite_link.py | 39 + .../aiogram/methods/send_animation.py | 141 + .../aiogram/methods/send_audio.py | 132 + .../aiogram/methods/send_chat_action.py | 54 + .../aiogram/methods/send_contact.py | 113 + .../aiogram/methods/send_dice.py | 101 + .../aiogram/methods/send_document.py | 123 + .../aiogram/methods/send_game.py | 90 + .../aiogram/methods/send_invoice.py | 166 + .../aiogram/methods/send_location.py | 121 + .../aiogram/methods/send_media_group.py | 99 + .../aiogram/methods/send_message.py | 128 + .../aiogram/methods/send_paid_media.py | 97 + .../aiogram/methods/send_photo.py | 125 + .../aiogram/methods/send_poll.py | 156 + .../aiogram/methods/send_sticker.py | 106 + .../aiogram/methods/send_venue.py | 129 + .../aiogram/methods/send_video.py | 145 + .../aiogram/methods/send_video_note.py | 114 + .../aiogram/methods/send_voice.py | 119 + .../set_chat_administrator_custom_title.py | 43 + .../aiogram/methods/set_chat_description.py | 38 + .../aiogram/methods/set_chat_menu_button.py | 41 + .../aiogram/methods/set_chat_permissions.py | 47 + .../aiogram/methods/set_chat_photo.py | 39 + .../aiogram/methods/set_chat_sticker_set.py | 40 + .../aiogram/methods/set_chat_title.py | 34 + .../set_custom_emoji_sticker_set_thumbnail.py | 38 + .../aiogram/methods/set_game_score.py | 63 + .../aiogram/methods/set_message_reaction.py | 53 + .../aiogram/methods/set_my_commands.py | 73 + .../set_my_default_administrator_rights.py | 39 + .../aiogram/methods/set_my_description.py | 40 + .../aiogram/methods/set_my_name.py | 36 + .../methods/set_my_short_description.py | 42 + .../methods/set_passport_data_errors.py | 74 + .../aiogram/methods/set_sticker_emoji_list.py | 34 + .../aiogram/methods/set_sticker_keywords.py | 38 + .../methods/set_sticker_mask_position.py | 39 + .../methods/set_sticker_position_in_set.py | 34 + .../methods/set_sticker_set_thumbnail.py | 47 + .../aiogram/methods/set_sticker_set_title.py | 34 + .../aiogram/methods/set_webhook.py | 73 + .../methods/stop_message_live_location.py | 55 + .../aiogram/methods/stop_poll.py | 51 + .../aiogram/methods/unban_chat_member.py | 46 + .../aiogram/methods/unban_chat_sender_chat.py | 38 + .../methods/unhide_general_forum_topic.py | 32 + .../methods/unpin_all_chat_messages.py | 32 + .../methods/unpin_all_forum_topic_messages.py | 40 + .../unpin_all_general_forum_topic_messages.py | 30 + .../aiogram/methods/unpin_chat_message.py | 46 + .../aiogram/methods/upload_sticker_file.py | 47 + env/Lib/site-packages/aiogram/py.typed | 0 .../site-packages/aiogram/types/__init__.py | 490 ++ .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 20805 bytes .../__pycache__/animation.cpython-311.pyc | Bin 0 -> 2127 bytes .../types/__pycache__/audio.cpython-311.pyc | Bin 0 -> 2161 bytes .../background_fill.cpython-311.pyc | Bin 0 -> 944 bytes ...und_fill_freeform_gradient.cpython-311.pyc | Bin 0 -> 1671 bytes .../background_fill_gradient.cpython-311.pyc | Bin 0 -> 1644 bytes .../background_fill_solid.cpython-311.pyc | Bin 0 -> 1505 bytes .../background_type.cpython-311.pyc | Bin 0 -> 971 bytes ...background_type_chat_theme.cpython-311.pyc | Bin 0 -> 1546 bytes .../background_type_fill.cpython-311.pyc | Bin 0 -> 1994 bytes .../background_type_pattern.cpython-311.pyc | Bin 0 -> 2456 bytes .../background_type_wallpaper.cpython-311.pyc | Bin 0 -> 1926 bytes .../types/__pycache__/base.cpython-311.pyc | Bin 0 -> 3030 bytes .../__pycache__/birthdate.cpython-311.pyc | Bin 0 -> 1501 bytes .../__pycache__/bot_command.cpython-311.pyc | Bin 0 -> 1388 bytes .../bot_command_scope.cpython-311.pyc | Bin 0 -> 1415 bytes ...pe_all_chat_administrators.cpython-311.pyc | Bin 0 -> 1801 bytes ...mand_scope_all_group_chats.cpython-311.pyc | Bin 0 -> 1719 bytes ...nd_scope_all_private_chats.cpython-311.pyc | Bin 0 -> 1720 bytes .../bot_command_scope_chat.cpython-311.pyc | Bin 0 -> 1768 bytes ..._scope_chat_administrators.cpython-311.pyc | Bin 0 -> 1922 bytes ..._command_scope_chat_member.cpython-311.pyc | Bin 0 -> 1908 bytes .../bot_command_scope_default.cpython-311.pyc | Bin 0 -> 1802 bytes .../bot_description.cpython-311.pyc | Bin 0 -> 1291 bytes .../__pycache__/bot_name.cpython-311.pyc | Bin 0 -> 1206 bytes .../bot_short_description.cpython-311.pyc | Bin 0 -> 1331 bytes .../business_connection.cpython-311.pyc | Bin 0 -> 1811 bytes .../business_intro.cpython-311.pyc | Bin 0 -> 1696 bytes .../business_location.cpython-311.pyc | Bin 0 -> 1595 bytes .../business_messages_deleted.cpython-311.pyc | Bin 0 -> 1659 bytes .../business_opening_hours.cpython-311.pyc | Bin 0 -> 1610 bytes ...ess_opening_hours_interval.cpython-311.pyc | Bin 0 -> 1508 bytes .../__pycache__/callback_game.cpython-311.pyc | Bin 0 -> 755 bytes .../callback_query.cpython-311.pyc | Bin 0 -> 5741 bytes .../types/__pycache__/chat.cpython-311.pyc | Bin 0 -> 52859 bytes .../chat_administrator_rights.cpython-311.pyc | Bin 0 -> 2617 bytes .../chat_background.cpython-311.pyc | Bin 0 -> 1793 bytes .../__pycache__/chat_boost.cpython-311.pyc | Bin 0 -> 1962 bytes .../chat_boost_added.cpython-311.pyc | Bin 0 -> 1313 bytes .../chat_boost_removed.cpython-311.pyc | Bin 0 -> 2036 bytes .../chat_boost_source.cpython-311.pyc | Bin 0 -> 910 bytes ...hat_boost_source_gift_code.cpython-311.pyc | Bin 0 -> 1896 bytes ...chat_boost_source_giveaway.cpython-311.pyc | Bin 0 -> 2110 bytes .../chat_boost_source_premium.cpython-311.pyc | Bin 0 -> 1809 bytes .../chat_boost_updated.cpython-311.pyc | Bin 0 -> 1548 bytes .../chat_full_info.cpython-311.pyc | Bin 0 -> 7374 bytes .../chat_invite_link.cpython-311.pyc | Bin 0 -> 2198 bytes .../chat_join_request.cpython-311.pyc | Bin 0 -> 88120 bytes .../__pycache__/chat_location.cpython-311.pyc | Bin 0 -> 1470 bytes .../__pycache__/chat_member.cpython-311.pyc | Bin 0 -> 1180 bytes .../chat_member_administrator.cpython-311.pyc | Bin 0 -> 3469 bytes .../chat_member_banned.cpython-311.pyc | Bin 0 -> 1918 bytes .../chat_member_left.cpython-311.pyc | Bin 0 -> 1770 bytes .../chat_member_member.cpython-311.pyc | Bin 0 -> 1954 bytes .../chat_member_owner.cpython-311.pyc | Bin 0 -> 1968 bytes .../chat_member_restricted.cpython-311.pyc | Bin 0 -> 3252 bytes .../chat_member_updated.cpython-311.pyc | Bin 0 -> 74610 bytes .../chat_permissions.cpython-311.pyc | Bin 0 -> 2691 bytes .../__pycache__/chat_photo.cpython-311.pyc | Bin 0 -> 1538 bytes .../__pycache__/chat_shared.cpython-311.pyc | Bin 0 -> 1948 bytes .../chosen_inline_result.cpython-311.pyc | Bin 0 -> 2313 bytes .../types/__pycache__/contact.cpython-311.pyc | Bin 0 -> 1700 bytes .../types/__pycache__/custom.cpython-311.pyc | Bin 0 -> 1301 bytes .../types/__pycache__/dice.cpython-311.pyc | Bin 0 -> 1741 bytes .../__pycache__/document.cpython-311.pyc | Bin 0 -> 2093 bytes .../__pycache__/downloadable.cpython-311.pyc | Bin 0 -> 526 bytes .../encrypted_credentials.cpython-311.pyc | Bin 0 -> 1758 bytes ...encrypted_passport_element.cpython-311.pyc | Bin 0 -> 2417 bytes .../__pycache__/error_event.cpython-311.pyc | Bin 0 -> 1514 bytes .../external_reply_info.cpython-311.pyc | Bin 0 -> 5836 bytes .../types/__pycache__/file.cpython-311.pyc | Bin 0 -> 1943 bytes .../__pycache__/force_reply.cpython-311.pyc | Bin 0 -> 2903 bytes .../__pycache__/forum_topic.cpython-311.pyc | Bin 0 -> 1604 bytes .../forum_topic_closed.cpython-311.pyc | Bin 0 -> 771 bytes .../forum_topic_created.cpython-311.pyc | Bin 0 -> 1616 bytes .../forum_topic_edited.cpython-311.pyc | Bin 0 -> 1551 bytes .../forum_topic_reopened.cpython-311.pyc | Bin 0 -> 779 bytes .../types/__pycache__/game.cpython-311.pyc | Bin 0 -> 2096 bytes .../game_high_score.cpython-311.pyc | Bin 0 -> 1730 bytes ...general_forum_topic_hidden.cpython-311.pyc | Bin 0 -> 741 bytes ...neral_forum_topic_unhidden.cpython-311.pyc | Bin 0 -> 749 bytes .../__pycache__/giveaway.cpython-311.pyc | Bin 0 -> 2229 bytes .../giveaway_completed.cpython-311.pyc | Bin 0 -> 1756 bytes .../giveaway_created.cpython-311.pyc | Bin 0 -> 704 bytes .../giveaway_winners.cpython-311.pyc | Bin 0 -> 2567 bytes .../inaccessible_message.cpython-311.pyc | Bin 0 -> 1711 bytes .../inline_keyboard_button.cpython-311.pyc | Bin 0 -> 2765 bytes .../inline_keyboard_markup.cpython-311.pyc | Bin 0 -> 1651 bytes .../__pycache__/inline_query.cpython-311.pyc | Bin 0 -> 7378 bytes .../inline_query_result.cpython-311.pyc | Bin 0 -> 2649 bytes ...nline_query_result_article.cpython-311.pyc | Bin 0 -> 3306 bytes .../inline_query_result_audio.cpython-311.pyc | Bin 0 -> 3735 bytes ..._query_result_cached_audio.cpython-311.pyc | Bin 0 -> 3551 bytes ...ery_result_cached_document.cpython-311.pyc | Bin 0 -> 3729 bytes ...ne_query_result_cached_gif.cpython-311.pyc | Bin 0 -> 3857 bytes ...ry_result_cached_mpeg4_gif.cpython-311.pyc | Bin 0 -> 3940 bytes ..._query_result_cached_photo.cpython-311.pyc | Bin 0 -> 3938 bytes ...uery_result_cached_sticker.cpython-311.pyc | Bin 0 -> 2987 bytes ..._query_result_cached_video.cpython-311.pyc | Bin 0 -> 3921 bytes ..._query_result_cached_voice.cpython-311.pyc | Bin 0 -> 3617 bytes ...nline_query_result_contact.cpython-311.pyc | Bin 0 -> 3490 bytes ...line_query_result_document.cpython-311.pyc | Bin 0 -> 4096 bytes .../inline_query_result_game.cpython-311.pyc | Bin 0 -> 1997 bytes .../inline_query_result_gif.cpython-311.pyc | Bin 0 -> 4304 bytes ...line_query_result_location.cpython-311.pyc | Bin 0 -> 3775 bytes ...ine_query_result_mpeg4_gif.cpython-311.pyc | Bin 0 -> 4328 bytes .../inline_query_result_photo.cpython-311.pyc | Bin 0 -> 4131 bytes .../inline_query_result_venue.cpython-311.pyc | Bin 0 -> 3776 bytes .../inline_query_result_video.cpython-311.pyc | Bin 0 -> 4664 bytes .../inline_query_result_voice.cpython-311.pyc | Bin 0 -> 3703 bytes ...nline_query_results_button.cpython-311.pyc | Bin 0 -> 1803 bytes ...ut_contact_message_content.cpython-311.pyc | Bin 0 -> 1829 bytes .../__pycache__/input_file.cpython-311.pyc | Bin 0 -> 8127 bytes ...ut_invoice_message_content.cpython-311.pyc | Bin 0 -> 3713 bytes ...t_location_message_content.cpython-311.pyc | Bin 0 -> 2060 bytes .../__pycache__/input_media.cpython-311.pyc | Bin 0 -> 1071 bytes .../input_media_animation.cpython-311.pyc | Bin 0 -> 3081 bytes .../input_media_audio.cpython-311.pyc | Bin 0 -> 2711 bytes .../input_media_document.cpython-311.pyc | Bin 0 -> 2565 bytes .../input_media_photo.cpython-311.pyc | Bin 0 -> 2604 bytes .../input_media_video.cpython-311.pyc | Bin 0 -> 3095 bytes .../input_message_content.cpython-311.pyc | Bin 0 -> 1255 bytes .../input_paid_media.cpython-311.pyc | Bin 0 -> 812 bytes .../input_paid_media_photo.cpython-311.pyc | Bin 0 -> 1745 bytes .../input_paid_media_video.cpython-311.pyc | Bin 0 -> 2273 bytes .../input_poll_option.cpython-311.pyc | Bin 0 -> 1935 bytes .../__pycache__/input_sticker.cpython-311.pyc | Bin 0 -> 1951 bytes ...input_text_message_content.cpython-311.pyc | Bin 0 -> 2606 bytes ...nput_venue_message_content.cpython-311.pyc | Bin 0 -> 2143 bytes .../types/__pycache__/invoice.cpython-311.pyc | Bin 0 -> 1584 bytes .../keyboard_button.cpython-311.pyc | Bin 0 -> 3203 bytes .../keyboard_button_poll_type.cpython-311.pyc | Bin 0 -> 1522 bytes ...yboard_button_request_chat.cpython-311.pyc | Bin 0 -> 2870 bytes ...yboard_button_request_user.cpython-311.pyc | Bin 0 -> 1988 bytes ...board_button_request_users.cpython-311.pyc | Bin 0 -> 2405 bytes .../__pycache__/labeled_price.cpython-311.pyc | Bin 0 -> 1427 bytes .../link_preview_options.cpython-311.pyc | Bin 0 -> 2611 bytes .../__pycache__/location.cpython-311.pyc | Bin 0 -> 1829 bytes .../__pycache__/login_url.cpython-311.pyc | Bin 0 -> 2158 bytes .../__pycache__/mask_position.cpython-311.pyc | Bin 0 -> 1548 bytes ...maybe_inaccessible_message.cpython-311.pyc | Bin 0 -> 831 bytes .../__pycache__/menu_button.cpython-311.pyc | Bin 0 -> 2161 bytes .../menu_button_commands.cpython-311.pyc | Bin 0 -> 1562 bytes .../menu_button_default.cpython-311.pyc | Bin 0 -> 1551 bytes .../menu_button_web_app.cpython-311.pyc | Bin 0 -> 1814 bytes .../types/__pycache__/message.cpython-311.pyc | Bin 0 -> 198575 bytes ..._auto_delete_timer_changed.cpython-311.pyc | Bin 0 -> 1472 bytes .../message_entity.cpython-311.pyc | Bin 0 -> 2475 bytes .../__pycache__/message_id.cpython-311.pyc | Bin 0 -> 1325 bytes .../message_origin.cpython-311.pyc | Bin 0 -> 949 bytes .../message_origin_channel.cpython-311.pyc | Bin 0 -> 2032 bytes .../message_origin_chat.cpython-311.pyc | Bin 0 -> 1972 bytes ...message_origin_hidden_user.cpython-311.pyc | Bin 0 -> 1780 bytes .../message_origin_user.cpython-311.pyc | Bin 0 -> 1819 bytes ...age_reaction_count_updated.cpython-311.pyc | Bin 0 -> 1851 bytes .../message_reaction_updated.cpython-311.pyc | Bin 0 -> 2442 bytes .../__pycache__/order_info.cpython-311.pyc | Bin 0 -> 1747 bytes .../__pycache__/paid_media.cpython-311.pyc | Bin 0 -> 825 bytes .../paid_media_info.cpython-311.pyc | Bin 0 -> 1740 bytes .../paid_media_photo.cpython-311.pyc | Bin 0 -> 1690 bytes .../paid_media_preview.cpython-311.pyc | Bin 0 -> 1827 bytes .../paid_media_video.cpython-311.pyc | Bin 0 -> 1643 bytes .../__pycache__/passport_data.cpython-311.pyc | Bin 0 -> 1657 bytes .../passport_element_error.cpython-311.pyc | Bin 0 -> 1677 bytes ...t_element_error_data_field.cpython-311.pyc | Bin 0 -> 1999 bytes ...assport_element_error_file.cpython-311.pyc | Bin 0 -> 1885 bytes ...ssport_element_error_files.cpython-311.pyc | Bin 0 -> 1941 bytes ...t_element_error_front_side.cpython-311.pyc | Bin 0 -> 1948 bytes ...element_error_reverse_side.cpython-311.pyc | Bin 0 -> 1959 bytes ...sport_element_error_selfie.cpython-311.pyc | Bin 0 -> 1904 bytes ...ent_error_translation_file.cpython-311.pyc | Bin 0 -> 2000 bytes ...nt_error_translation_files.cpython-311.pyc | Bin 0 -> 2050 bytes ..._element_error_unspecified.cpython-311.pyc | Bin 0 -> 1922 bytes .../__pycache__/passport_file.cpython-311.pyc | Bin 0 -> 1699 bytes .../__pycache__/photo_size.cpython-311.pyc | Bin 0 -> 1761 bytes .../types/__pycache__/poll.cpython-311.pyc | Bin 0 -> 2694 bytes .../__pycache__/poll_answer.cpython-311.pyc | Bin 0 -> 1793 bytes .../__pycache__/poll_option.cpython-311.pyc | Bin 0 -> 1679 bytes .../pre_checkout_query.cpython-311.pyc | Bin 0 -> 4106 bytes .../proximity_alert_triggered.cpython-311.pyc | Bin 0 -> 1657 bytes .../reaction_count.cpython-311.pyc | Bin 0 -> 1789 bytes .../__pycache__/reaction_type.cpython-311.pyc | Bin 0 -> 871 bytes ...reaction_type_custom_emoji.cpython-311.pyc | Bin 0 -> 1660 bytes .../reaction_type_emoji.cpython-311.pyc | Bin 0 -> 1605 bytes .../reaction_type_paid.cpython-311.pyc | Bin 0 -> 1418 bytes .../refunded_payment.cpython-311.pyc | Bin 0 -> 1829 bytes .../reply_keyboard_markup.cpython-311.pyc | Bin 0 -> 2332 bytes .../reply_keyboard_remove.cpython-311.pyc | Bin 0 -> 2031 bytes .../reply_parameters.cpython-311.pyc | Bin 0 -> 2474 bytes .../response_parameters.cpython-311.pyc | Bin 0 -> 1529 bytes .../revenue_withdrawal_state.cpython-311.pyc | Bin 0 -> 1056 bytes ...ue_withdrawal_state_failed.cpython-311.pyc | Bin 0 -> 1651 bytes ...e_withdrawal_state_pending.cpython-311.pyc | Bin 0 -> 1633 bytes ...withdrawal_state_succeeded.cpython-311.pyc | Bin 0 -> 1843 bytes .../sent_web_app_message.cpython-311.pyc | Bin 0 -> 1521 bytes .../__pycache__/shared_user.cpython-311.pyc | Bin 0 -> 1972 bytes .../shipping_address.cpython-311.pyc | Bin 0 -> 1655 bytes .../shipping_option.cpython-311.pyc | Bin 0 -> 1571 bytes .../shipping_query.cpython-311.pyc | Bin 0 -> 3846 bytes .../star_transaction.cpython-311.pyc | Bin 0 -> 2305 bytes .../star_transactions.cpython-311.pyc | Bin 0 -> 1483 bytes .../types/__pycache__/sticker.cpython-311.pyc | Bin 0 -> 4754 bytes .../__pycache__/sticker_set.cpython-311.pyc | Bin 0 -> 2197 bytes .../types/__pycache__/story.cpython-311.pyc | Bin 0 -> 1398 bytes .../successful_payment.cpython-311.pyc | Bin 0 -> 2016 bytes ...h_inline_query_chosen_chat.cpython-311.pyc | Bin 0 -> 2062 bytes .../__pycache__/text_quote.cpython-311.pyc | Bin 0 -> 1810 bytes .../transaction_partner.cpython-311.pyc | Bin 0 -> 1060 bytes ...ansaction_partner_fragment.cpython-311.pyc | Bin 0 -> 2235 bytes .../transaction_partner_other.cpython-311.pyc | Bin 0 -> 1610 bytes ...ction_partner_telegram_ads.cpython-311.pyc | Bin 0 -> 1658 bytes .../transaction_partner_user.cpython-311.pyc | Bin 0 -> 2280 bytes .../types/__pycache__/update.cpython-311.pyc | Bin 0 -> 7746 bytes .../types/__pycache__/user.cpython-311.pyc | Bin 0 -> 5032 bytes .../user_chat_boosts.cpython-311.pyc | Bin 0 -> 1470 bytes .../user_profile_photos.cpython-311.pyc | Bin 0 -> 1545 bytes .../__pycache__/user_shared.cpython-311.pyc | Bin 0 -> 1572 bytes .../__pycache__/users_shared.cpython-311.pyc | Bin 0 -> 1936 bytes .../types/__pycache__/venue.cpython-311.pyc | Bin 0 -> 1908 bytes .../types/__pycache__/video.cpython-311.pyc | Bin 0 -> 2056 bytes .../video_chat_ended.cpython-311.pyc | Bin 0 -> 1376 bytes ..._chat_participants_invited.cpython-311.pyc | Bin 0 -> 1516 bytes .../video_chat_scheduled.cpython-311.pyc | Bin 0 -> 1460 bytes .../video_chat_started.cpython-311.pyc | Bin 0 -> 771 bytes .../__pycache__/video_note.cpython-311.pyc | Bin 0 -> 1993 bytes .../types/__pycache__/voice.cpython-311.pyc | Bin 0 -> 1672 bytes .../__pycache__/web_app_data.cpython-311.pyc | Bin 0 -> 1434 bytes .../__pycache__/web_app_info.cpython-311.pyc | Bin 0 -> 1315 bytes .../__pycache__/webhook_info.cpython-311.pyc | Bin 0 -> 2255 bytes .../write_access_allowed.cpython-311.pyc | Bin 0 -> 1945 bytes .../site-packages/aiogram/types/animation.py | 70 + env/Lib/site-packages/aiogram/types/audio.py | 70 + .../aiogram/types/background_fill.py | 13 + .../background_fill_freeform_gradient.py | 33 + .../aiogram/types/background_fill_gradient.py | 45 + .../aiogram/types/background_fill_solid.py | 33 + .../aiogram/types/background_type.py | 14 + .../types/background_type_chat_theme.py | 33 + .../aiogram/types/background_type_fill.py | 47 + .../aiogram/types/background_type_pattern.py | 63 + .../types/background_type_wallpaper.py | 54 + env/Lib/site-packages/aiogram/types/base.py | 51 + .../site-packages/aiogram/types/birthdate.py | 38 + .../aiogram/types/bot_command.py | 31 + .../aiogram/types/bot_command_scope.py | 19 + ...t_command_scope_all_chat_administrators.py | 37 + .../bot_command_scope_all_group_chats.py | 35 + .../bot_command_scope_all_private_chats.py | 35 + .../aiogram/types/bot_command_scope_chat.py | 36 + .../bot_command_scope_chat_administrators.py | 40 + .../types/bot_command_scope_chat_member.py | 39 + .../types/bot_command_scope_default.py | 33 + .../aiogram/types/bot_description.py | 25 + .../site-packages/aiogram/types/bot_name.py | 25 + .../aiogram/types/bot_short_description.py | 27 + .../aiogram/types/business_connection.py | 59 + .../aiogram/types/business_intro.py | 41 + .../aiogram/types/business_location.py | 38 + .../types/business_messages_deleted.py | 46 + .../aiogram/types/business_opening_hours.py | 40 + .../types/business_opening_hours_interval.py | 37 + .../aiogram/types/callback_game.py | 11 + .../aiogram/types/callback_query.py | 109 + env/Lib/site-packages/aiogram/types/chat.py | 1320 +++++ .../types/chat_administrator_rights.py | 94 + .../aiogram/types/chat_background.py | 44 + .../site-packages/aiogram/types/chat_boost.py | 55 + .../aiogram/types/chat_boost_added.py | 25 + .../aiogram/types/chat_boost_removed.py | 56 + .../aiogram/types/chat_boost_source.py | 13 + .../types/chat_boost_source_gift_code.py | 39 + .../types/chat_boost_source_giveaway.py | 51 + .../types/chat_boost_source_premium.py | 39 + .../aiogram/types/chat_boost_updated.py | 35 + .../aiogram/types/chat_full_info.py | 225 + .../aiogram/types/chat_invite_link.py | 71 + .../aiogram/types/chat_join_request.py | 2702 ++++++++++ .../aiogram/types/chat_location.py | 34 + .../aiogram/types/chat_member.py | 18 + .../types/chat_member_administrator.py | 111 + .../aiogram/types/chat_member_banned.py | 43 + .../aiogram/types/chat_member_left.py | 39 + .../aiogram/types/chat_member_member.py | 43 + .../aiogram/types/chat_member_owner.py | 51 + .../aiogram/types/chat_member_restricted.py | 108 + .../aiogram/types/chat_member_updated.py | 1413 +++++ .../aiogram/types/chat_permissions.py | 87 + .../site-packages/aiogram/types/chat_photo.py | 47 + .../aiogram/types/chat_shared.py | 54 + .../aiogram/types/chosen_inline_result.py | 58 + .../site-packages/aiogram/types/contact.py | 51 + env/Lib/site-packages/aiogram/types/custom.py | 30 + env/Lib/site-packages/aiogram/types/dice.py | 40 + .../site-packages/aiogram/types/document.py | 58 + .../aiogram/types/downloadable.py | 5 + .../aiogram/types/encrypted_credentials.py | 33 + .../types/encrypted_passport_element.py | 74 + .../aiogram/types/error_event.py | 28 + .../aiogram/types/external_reply_info.py | 158 + env/Lib/site-packages/aiogram/types/file.py | 49 + .../aiogram/types/force_reply.py | 50 + .../aiogram/types/forum_topic.py | 47 + .../aiogram/types/forum_topic_closed.py | 11 + .../aiogram/types/forum_topic_created.py | 43 + .../aiogram/types/forum_topic_edited.py | 35 + .../aiogram/types/forum_topic_reopened.py | 11 + env/Lib/site-packages/aiogram/types/game.py | 60 + .../aiogram/types/game_high_score.py | 39 + .../types/general_forum_topic_hidden.py | 9 + .../types/general_forum_topic_unhidden.py | 9 + .../site-packages/aiogram/types/giveaway.py | 67 + .../aiogram/types/giveaway_completed.py | 46 + .../aiogram/types/giveaway_created.py | 9 + .../aiogram/types/giveaway_winners.py | 80 + .../aiogram/types/inaccessible_message.py | 41 + .../aiogram/types/inline_keyboard_button.py | 77 + .../aiogram/types/inline_keyboard_markup.py | 35 + .../aiogram/types/inline_query.py | 155 + .../aiogram/types/inline_query_result.py | 34 + .../types/inline_query_result_article.py | 96 + .../types/inline_query_result_audio.py | 102 + .../types/inline_query_result_cached_audio.py | 90 + .../inline_query_result_cached_document.py | 98 + .../types/inline_query_result_cached_gif.py | 100 + .../inline_query_result_cached_mpeg4_gif.py | 100 + .../types/inline_query_result_cached_photo.py | 104 + .../inline_query_result_cached_sticker.py | 76 + .../types/inline_query_result_cached_video.py | 104 + .../types/inline_query_result_cached_voice.py | 94 + .../types/inline_query_result_contact.py | 100 + .../types/inline_query_result_document.py | 114 + .../aiogram/types/inline_query_result_game.py | 51 + .../aiogram/types/inline_query_result_gif.py | 121 + .../types/inline_query_result_location.py | 112 + .../types/inline_query_result_mpeg4_gif.py | 120 + .../types/inline_query_result_photo.py | 116 + .../types/inline_query_result_venue.py | 116 + .../types/inline_query_result_video.py | 126 + .../types/inline_query_result_voice.py | 98 + .../types/inline_query_results_button.py | 43 + .../types/input_contact_message_content.py | 47 + .../site-packages/aiogram/types/input_file.py | 149 + .../types/input_invoice_message_content.py | 114 + .../types/input_location_message_content.py | 55 + .../aiogram/types/input_media.py | 17 + .../aiogram/types/input_media_animation.py | 83 + .../aiogram/types/input_media_audio.py | 73 + .../aiogram/types/input_media_document.py | 65 + .../aiogram/types/input_media_photo.py | 67 + .../aiogram/types/input_media_video.py | 87 + .../aiogram/types/input_message_content.py | 17 + .../aiogram/types/input_paid_media.py | 12 + .../aiogram/types/input_paid_media_photo.py | 37 + .../aiogram/types/input_paid_media_video.py | 61 + .../aiogram/types/input_poll_option.py | 47 + .../aiogram/types/input_sticker.py | 55 + .../types/input_text_message_content.py | 65 + .../types/input_venue_message_content.py | 63 + .../site-packages/aiogram/types/invoice.py | 51 + .../aiogram/types/keyboard_button.py | 78 + .../types/keyboard_button_poll_type.py | 29 + .../types/keyboard_button_request_chat.py | 78 + .../types/keyboard_button_request_user.py | 44 + .../types/keyboard_button_request_users.py | 57 + .../aiogram/types/labeled_price.py | 31 + .../aiogram/types/link_preview_options.py | 56 + .../site-packages/aiogram/types/location.py | 55 + .../site-packages/aiogram/types/login_url.py | 50 + .../aiogram/types/mask_position.py | 43 + .../types/maybe_inaccessible_message.py | 12 + .../aiogram/types/menu_button.py | 47 + .../aiogram/types/menu_button_commands.py | 33 + .../aiogram/types/menu_button_default.py | 33 + .../aiogram/types/menu_button_web_app.py | 42 + .../site-packages/aiogram/types/message.py | 4229 +++++++++++++++ .../message_auto_delete_timer_changed.py | 31 + .../aiogram/types/message_entity.py | 68 + .../site-packages/aiogram/types/message_id.py | 27 + .../aiogram/types/message_origin.py | 14 + .../aiogram/types/message_origin_channel.py | 56 + .../aiogram/types/message_origin_chat.py | 52 + .../types/message_origin_hidden_user.py | 40 + .../aiogram/types/message_origin_user.py | 43 + .../types/message_reaction_count_updated.py | 52 + .../aiogram/types/message_reaction_updated.py | 71 + .../site-packages/aiogram/types/order_info.py | 50 + .../site-packages/aiogram/types/paid_media.py | 13 + .../aiogram/types/paid_media_info.py | 40 + .../aiogram/types/paid_media_photo.py | 39 + .../aiogram/types/paid_media_preview.py | 44 + .../aiogram/types/paid_media_video.py | 39 + .../aiogram/types/passport_data.py | 39 + .../aiogram/types/passport_element_error.py | 21 + .../passport_element_error_data_field.py | 52 + .../types/passport_element_error_file.py | 44 + .../types/passport_element_error_files.py | 48 + .../passport_element_error_front_side.py | 46 + .../passport_element_error_reverse_side.py | 46 + .../types/passport_element_error_selfie.py | 44 + ...passport_element_error_translation_file.py | 48 + ...assport_element_error_translation_files.py | 52 + .../passport_element_error_unspecified.py | 50 + .../aiogram/types/passport_file.py | 48 + .../site-packages/aiogram/types/photo_size.py | 51 + env/Lib/site-packages/aiogram/types/poll.py | 92 + .../aiogram/types/poll_answer.py | 51 + .../aiogram/types/poll_option.py | 46 + .../aiogram/types/pre_checkout_query.py | 98 + .../types/proximity_alert_triggered.py | 43 + .../aiogram/types/reaction_count.py | 40 + .../aiogram/types/reaction_type.py | 13 + .../types/reaction_type_custom_emoji.py | 34 + .../aiogram/types/reaction_type_emoji.py | 34 + .../aiogram/types/reaction_type_paid.py | 28 + .../aiogram/types/refunded_payment.py | 49 + .../aiogram/types/reply_keyboard_markup.py | 58 + .../aiogram/types/reply_keyboard_remove.py | 37 + .../aiogram/types/reply_parameters.py | 67 + .../aiogram/types/response_parameters.py | 37 + .../aiogram/types/revenue_withdrawal_state.py | 15 + .../types/revenue_withdrawal_state_failed.py | 33 + .../types/revenue_withdrawal_state_pending.py | 33 + .../revenue_withdrawal_state_succeeded.py | 42 + .../aiogram/types/sent_web_app_message.py | 32 + .../aiogram/types/shared_user.py | 54 + .../aiogram/types/shipping_address.py | 55 + .../aiogram/types/shipping_option.py | 41 + .../aiogram/types/shipping_query.py | 90 + .../aiogram/types/star_transaction.py | 86 + .../aiogram/types/star_transactions.py | 32 + .../site-packages/aiogram/types/sticker.py | 152 + .../aiogram/types/sticker_set.py | 71 + env/Lib/site-packages/aiogram/types/story.py | 32 + .../aiogram/types/successful_payment.py | 62 + .../types/switch_inline_query_chosen_chat.py | 49 + .../site-packages/aiogram/types/text_quote.py | 50 + .../aiogram/types/transaction_partner.py | 14 + .../types/transaction_partner_fragment.py | 53 + .../types/transaction_partner_other.py | 33 + .../types/transaction_partner_telegram_ads.py | 35 + .../aiogram/types/transaction_partner_user.py | 56 + env/Lib/site-packages/aiogram/types/update.py | 211 + env/Lib/site-packages/aiogram/types/user.py | 140 + .../aiogram/types/user_chat_boosts.py | 32 + .../aiogram/types/user_profile_photos.py | 38 + .../aiogram/types/user_shared.py | 32 + .../aiogram/types/users_shared.py | 48 + env/Lib/site-packages/aiogram/types/venue.py | 62 + env/Lib/site-packages/aiogram/types/video.py | 70 + .../aiogram/types/video_chat_ended.py | 27 + .../types/video_chat_participants_invited.py | 30 + .../aiogram/types/video_chat_scheduled.py | 30 + .../aiogram/types/video_chat_started.py | 11 + .../site-packages/aiogram/types/video_note.py | 58 + env/Lib/site-packages/aiogram/types/voice.py | 51 + .../aiogram/types/web_app_data.py | 31 + .../aiogram/types/web_app_info.py | 27 + .../aiogram/types/webhook_info.py | 68 + .../aiogram/types/write_access_allowed.py | 41 + .../site-packages/aiogram/utils/__init__.py | 0 .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 183 bytes .../__pycache__/auth_widget.cpython-311.pyc | Bin 0 -> 2088 bytes .../utils/__pycache__/backoff.cpython-311.pyc | Bin 0 -> 5160 bytes .../callback_answer.cpython-311.pyc | Bin 0 -> 10428 bytes .../__pycache__/chat_action.cpython-311.pyc | Bin 0 -> 15456 bytes .../__pycache__/chat_member.cpython-311.pyc | Bin 0 -> 1338 bytes .../__pycache__/deep_linking.cpython-311.pyc | Bin 0 -> 3814 bytes .../__pycache__/formatting.cpython-311.pyc | Bin 0 -> 29125 bytes .../__pycache__/keyboard.cpython-311.pyc | Bin 0 -> 19088 bytes .../utils/__pycache__/link.cpython-311.pyc | Bin 0 -> 3649 bytes .../__pycache__/magic_filter.cpython-311.pyc | Bin 0 -> 1836 bytes .../__pycache__/markdown.cpython-311.pyc | Bin 0 -> 8145 bytes .../__pycache__/media_group.cpython-311.pyc | Bin 0 -> 17076 bytes .../utils/__pycache__/mixins.cpython-311.pyc | Bin 0 -> 5547 bytes .../__pycache__/mypy_hacks.cpython-311.pyc | Bin 0 -> 1076 bytes .../utils/__pycache__/payload.cpython-311.pyc | Bin 0 -> 4025 bytes .../__pycache__/serialization.cpython-311.pyc | Bin 0 -> 3892 bytes .../text_decorations.cpython-311.pyc | Bin 0 -> 15536 bytes .../utils/__pycache__/token.cpython-311.pyc | Bin 0 -> 2187 bytes .../__pycache__/warnings.cpython-311.pyc | Bin 0 -> 603 bytes .../utils/__pycache__/web_app.cpython-311.pyc | Bin 0 -> 6981 bytes .../aiogram/utils/auth_widget.py | 34 + .../site-packages/aiogram/utils/backoff.py | 83 + .../aiogram/utils/callback_answer.py | 211 + .../aiogram/utils/chat_action.py | 379 ++ .../aiogram/utils/chat_member.py | 37 + .../aiogram/utils/deep_linking.py | 112 + .../site-packages/aiogram/utils/formatting.py | 632 +++ .../aiogram/utils/i18n/__init__.py | 21 + .../i18n/__pycache__/__init__.cpython-311.pyc | Bin 0 -> 665 bytes .../i18n/__pycache__/context.cpython-311.pyc | Bin 0 -> 1287 bytes .../i18n/__pycache__/core.cpython-311.pyc | Bin 0 -> 6572 bytes .../__pycache__/lazy_proxy.cpython-311.pyc | Bin 0 -> 1058 bytes .../__pycache__/middleware.cpython-311.pyc | Bin 0 -> 10034 bytes .../aiogram/utils/i18n/context.py | 23 + .../site-packages/aiogram/utils/i18n/core.py | 123 + .../aiogram/utils/i18n/lazy_proxy.py | 13 + .../aiogram/utils/i18n/middleware.py | 187 + .../site-packages/aiogram/utils/keyboard.py | 421 ++ env/Lib/site-packages/aiogram/utils/link.py | 74 + .../aiogram/utils/magic_filter.py | 22 + .../site-packages/aiogram/utils/markdown.py | 209 + .../aiogram/utils/media_group.py | 368 ++ env/Lib/site-packages/aiogram/utils/mixins.py | 95 + .../site-packages/aiogram/utils/mypy_hacks.py | 16 + .../site-packages/aiogram/utils/payload.py | 109 + .../aiogram/utils/serialization.py | 89 + .../aiogram/utils/text_decorations.py | 274 + env/Lib/site-packages/aiogram/utils/token.py | 42 + .../site-packages/aiogram/utils/warnings.py | 6 + .../site-packages/aiogram/utils/web_app.py | 183 + .../site-packages/aiogram/webhook/__init__.py | 0 .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 185 bytes .../aiohttp_server.cpython-311.pyc | Bin 0 -> 17416 bytes .../__pycache__/security.cpython-311.pyc | Bin 0 -> 3210 bytes .../aiogram/webhook/aiohttp_server.py | 295 + .../site-packages/aiogram/webhook/security.py | 41 + .../INSTALLER | 1 + .../aiohappyeyeballs-2.4.0.dist-info/LICENSE | 279 + .../aiohappyeyeballs-2.4.0.dist-info/METADATA | 122 + .../aiohappyeyeballs-2.4.0.dist-info/RECORD | 14 + .../aiohappyeyeballs-2.4.0.dist-info/WHEEL | 4 + .../aiohappyeyeballs/__init__.py | 13 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 517 bytes .../__pycache__/impl.cpython-311.pyc | Bin 0 -> 8927 bytes .../__pycache__/types.cpython-311.pyc | Bin 0 -> 511 bytes .../__pycache__/utils.cpython-311.pyc | Bin 0 -> 4154 bytes .../site-packages/aiohappyeyeballs/impl.py | 205 + .../site-packages/aiohappyeyeballs/py.typed | 0 .../site-packages/aiohappyeyeballs/types.py | 12 + .../site-packages/aiohappyeyeballs/utils.py | 97 + .../aiohttp-3.10.5.dist-info/INSTALLER | 1 + .../aiohttp-3.10.5.dist-info/LICENSE.txt | 13 + .../aiohttp-3.10.5.dist-info/METADATA | 246 + .../aiohttp-3.10.5.dist-info/RECORD | 119 + .../aiohttp-3.10.5.dist-info/WHEEL | 5 + .../aiohttp-3.10.5.dist-info/top_level.txt | 1 + .../aiohttp/.hash/_cparser.pxd.hash | 1 + .../aiohttp/.hash/_find_header.pxd.hash | 1 + .../aiohttp/.hash/_helpers.pyi.hash | 1 + .../aiohttp/.hash/_helpers.pyx.hash | 1 + .../aiohttp/.hash/_http_parser.pyx.hash | 1 + .../aiohttp/.hash/_http_writer.pyx.hash | 1 + .../aiohttp/.hash/_websocket.pyx.hash | 1 + .../site-packages/aiohttp/.hash/hdrs.py.hash | 1 + env/Lib/site-packages/aiohttp/__init__.py | 254 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 5958 bytes .../aiohttp/__pycache__/abc.cpython-311.pyc | Bin 0 -> 12464 bytes .../__pycache__/base_protocol.cpython-311.pyc | Bin 0 -> 4622 bytes .../__pycache__/client.cpython-311.pyc | Bin 0 -> 57552 bytes .../client_exceptions.cpython-311.pyc | Bin 0 -> 19021 bytes .../__pycache__/client_proto.cpython-311.pyc | Bin 0 -> 12792 bytes .../__pycache__/client_reqrep.cpython-311.pyc | Bin 0 -> 58042 bytes .../__pycache__/client_ws.cpython-311.pyc | Bin 0 -> 21331 bytes .../compression_utils.cpython-311.pyc | Bin 0 -> 9111 bytes .../__pycache__/connector.cpython-311.pyc | Bin 0 -> 71790 bytes .../__pycache__/cookiejar.cpython-311.pyc | Bin 0 -> 20805 bytes .../__pycache__/formdata.cpython-311.pyc | Bin 0 -> 8432 bytes .../aiohttp/__pycache__/hdrs.cpython-311.pyc | Bin 0 -> 9599 bytes .../__pycache__/helpers.cpython-311.pyc | Bin 0 -> 50446 bytes .../aiohttp/__pycache__/http.cpython-311.pyc | Bin 0 -> 2101 bytes .../http_exceptions.cpython-311.pyc | Bin 0 -> 6723 bytes .../__pycache__/http_parser.cpython-311.pyc | Bin 0 -> 37969 bytes .../http_websocket.cpython-311.pyc | Bin 0 -> 29761 bytes .../__pycache__/http_writer.cpython-311.pyc | Bin 0 -> 9445 bytes .../aiohttp/__pycache__/locks.cpython-311.pyc | Bin 0 -> 2577 bytes .../aiohttp/__pycache__/log.cpython-311.pyc | Bin 0 -> 693 bytes .../__pycache__/multipart.cpython-311.pyc | Bin 0 -> 52959 bytes .../__pycache__/payload.cpython-311.pyc | Bin 0 -> 24222 bytes .../payload_streamer.cpython-311.pyc | Bin 0 -> 4691 bytes .../__pycache__/pytest_plugin.cpython-311.pyc | Bin 0 -> 18995 bytes .../__pycache__/resolver.cpython-311.pyc | Bin 0 -> 7924 bytes .../__pycache__/streams.cpython-311.pyc | Bin 0 -> 31812 bytes .../__pycache__/tcp_helpers.cpython-311.pyc | Bin 0 -> 1996 bytes .../__pycache__/test_utils.cpython-311.pyc | Bin 0 -> 35984 bytes .../__pycache__/tracing.cpython-311.pyc | Bin 0 -> 24319 bytes .../__pycache__/typedefs.cpython-311.pyc | Bin 0 -> 2642 bytes .../aiohttp/__pycache__/web.cpython-311.pyc | Bin 0 -> 18019 bytes .../__pycache__/web_app.cpython-311.pyc | Bin 0 -> 28750 bytes .../web_exceptions.cpython-311.pyc | Bin 0 -> 18171 bytes .../web_fileresponse.cpython-311.pyc | Bin 0 -> 15608 bytes .../__pycache__/web_log.cpython-311.pyc | Bin 0 -> 11396 bytes .../web_middlewares.cpython-311.pyc | Bin 0 -> 6072 bytes .../__pycache__/web_protocol.cpython-311.pyc | Bin 0 -> 32515 bytes .../__pycache__/web_request.cpython-311.pyc | Bin 0 -> 41203 bytes .../__pycache__/web_response.cpython-311.pyc | Bin 0 -> 38936 bytes .../__pycache__/web_routedef.cpython-311.pyc | Bin 0 -> 12847 bytes .../__pycache__/web_runner.cpython-311.pyc | Bin 0 -> 20675 bytes .../__pycache__/web_server.cpython-311.pyc | Bin 0 -> 5407 bytes .../web_urldispatcher.cpython-311.pyc | Bin 0 -> 75548 bytes .../__pycache__/web_ws.cpython-311.pyc | Bin 0 -> 31482 bytes .../__pycache__/worker.cpython-311.pyc | Bin 0 -> 12202 bytes env/Lib/site-packages/aiohttp/_cparser.pxd | 158 + .../site-packages/aiohttp/_find_header.pxd | 2 + env/Lib/site-packages/aiohttp/_headers.pxi | 83 + .../aiohttp/_helpers.cp311-win_amd64.pyd | Bin 0 -> 54784 bytes env/Lib/site-packages/aiohttp/_helpers.pyi | 6 + env/Lib/site-packages/aiohttp/_helpers.pyx | 35 + .../aiohttp/_http_parser.cp311-win_amd64.pyd | Bin 0 -> 266240 bytes .../site-packages/aiohttp/_http_parser.pyx | 841 +++ .../aiohttp/_http_writer.cp311-win_amd64.pyd | Bin 0 -> 49152 bytes .../site-packages/aiohttp/_http_writer.pyx | 163 + .../aiohttp/_websocket.cp311-win_amd64.pyd | Bin 0 -> 36864 bytes env/Lib/site-packages/aiohttp/_websocket.pyx | 56 + env/Lib/site-packages/aiohttp/abc.py | 234 + .../site-packages/aiohttp/base_protocol.py | 95 + env/Lib/site-packages/aiohttp/client.py | 1522 ++++++ .../aiohttp/client_exceptions.py | 396 ++ env/Lib/site-packages/aiohttp/client_proto.py | 304 ++ .../site-packages/aiohttp/client_reqrep.py | 1231 +++++ env/Lib/site-packages/aiohttp/client_ws.py | 386 ++ .../aiohttp/compression_utils.py | 159 + env/Lib/site-packages/aiohttp/connector.py | 1608 ++++++ env/Lib/site-packages/aiohttp/cookiejar.py | 425 ++ env/Lib/site-packages/aiohttp/formdata.py | 182 + env/Lib/site-packages/aiohttp/hdrs.py | 108 + env/Lib/site-packages/aiohttp/helpers.py | 1001 ++++ env/Lib/site-packages/aiohttp/http.py | 72 + .../site-packages/aiohttp/http_exceptions.py | 105 + env/Lib/site-packages/aiohttp/http_parser.py | 1023 ++++ .../site-packages/aiohttp/http_websocket.py | 737 +++ env/Lib/site-packages/aiohttp/http_writer.py | 198 + env/Lib/site-packages/aiohttp/locks.py | 41 + env/Lib/site-packages/aiohttp/log.py | 8 + env/Lib/site-packages/aiohttp/multipart.py | 1056 ++++ env/Lib/site-packages/aiohttp/payload.py | 464 ++ .../site-packages/aiohttp/payload_streamer.py | 75 + env/Lib/site-packages/aiohttp/py.typed | 1 + .../site-packages/aiohttp/pytest_plugin.py | 407 ++ env/Lib/site-packages/aiohttp/resolver.py | 188 + env/Lib/site-packages/aiohttp/streams.py | 684 +++ env/Lib/site-packages/aiohttp/tcp_helpers.py | 37 + env/Lib/site-packages/aiohttp/test_utils.py | 731 +++ env/Lib/site-packages/aiohttp/tracing.py | 470 ++ env/Lib/site-packages/aiohttp/typedefs.py | 67 + env/Lib/site-packages/aiohttp/web.py | 590 ++ env/Lib/site-packages/aiohttp/web_app.py | 590 ++ .../site-packages/aiohttp/web_exceptions.py | 452 ++ .../site-packages/aiohttp/web_fileresponse.py | 357 ++ env/Lib/site-packages/aiohttp/web_log.py | 213 + .../site-packages/aiohttp/web_middlewares.py | 116 + env/Lib/site-packages/aiohttp/web_protocol.py | 714 +++ env/Lib/site-packages/aiohttp/web_request.py | 914 ++++ env/Lib/site-packages/aiohttp/web_response.py | 820 +++ env/Lib/site-packages/aiohttp/web_routedef.py | 214 + env/Lib/site-packages/aiohttp/web_runner.py | 397 ++ env/Lib/site-packages/aiohttp/web_server.py | 82 + .../aiohttp/web_urldispatcher.py | 1302 +++++ env/Lib/site-packages/aiohttp/web_ws.py | 600 +++ env/Lib/site-packages/aiohttp/worker.py | 247 + .../aiosignal-1.3.1.dist-info/INSTALLER | 1 + .../aiosignal-1.3.1.dist-info/LICENSE | 201 + .../aiosignal-1.3.1.dist-info/METADATA | 128 + .../aiosignal-1.3.1.dist-info/RECORD | 10 + .../aiosignal-1.3.1.dist-info/WHEEL | 5 + .../aiosignal-1.3.1.dist-info/top_level.txt | 1 + env/Lib/site-packages/aiosignal/__init__.py | 36 + env/Lib/site-packages/aiosignal/__init__.pyi | 12 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 1847 bytes env/Lib/site-packages/aiosignal/py.typed | 0 .../annotated_types-0.7.0.dist-info/INSTALLER | 1 + .../annotated_types-0.7.0.dist-info/METADATA | 295 + .../annotated_types-0.7.0.dist-info/RECORD | 10 + .../annotated_types-0.7.0.dist-info/WHEEL | 4 + .../licenses/LICENSE | 21 + .../site-packages/annotated_types/__init__.py | 432 ++ .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 20552 bytes .../__pycache__/test_cases.cpython-311.pyc | Bin 0 -> 15443 bytes .../site-packages/annotated_types/py.typed | 0 .../annotated_types/test_cases.py | 151 + .../async_timeout-4.0.3.dist-info/INSTALLER | 1 + .../async_timeout-4.0.3.dist-info/LICENSE | 13 + .../async_timeout-4.0.3.dist-info/METADATA | 131 + .../async_timeout-4.0.3.dist-info/RECORD | 10 + .../async_timeout-4.0.3.dist-info/WHEEL | 5 + .../top_level.txt | 1 + .../async_timeout-4.0.3.dist-info/zip-safe | 1 + .../site-packages/async_timeout/__init__.py | 239 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 10188 bytes env/Lib/site-packages/async_timeout/py.typed | 1 + .../asyncpg-0.29.0.dist-info/AUTHORS | 6 + .../asyncpg-0.29.0.dist-info/INSTALLER | 1 + .../asyncpg-0.29.0.dist-info/LICENSE | 204 + .../asyncpg-0.29.0.dist-info/METADATA | 127 + .../asyncpg-0.29.0.dist-info/RECORD | 111 + .../asyncpg-0.29.0.dist-info/REQUESTED | 0 .../asyncpg-0.29.0.dist-info/WHEEL | 5 + .../asyncpg-0.29.0.dist-info/top_level.txt | 1 + env/Lib/site-packages/asyncpg/__init__.py | 19 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 599 bytes .../_asyncio_compat.cpython-311.pyc | Bin 0 -> 3065 bytes .../__pycache__/_version.cpython-311.pyc | Bin 0 -> 200 bytes .../__pycache__/cluster.cpython-311.pyc | Bin 0 -> 35040 bytes .../__pycache__/compat.cpython-311.pyc | Bin 0 -> 2245 bytes .../__pycache__/connect_utils.cpython-311.pyc | Bin 0 -> 41337 bytes .../__pycache__/connection.cpython-311.pyc | Bin 0 -> 109731 bytes .../__pycache__/connresource.cpython-311.pyc | Bin 0 -> 2243 bytes .../__pycache__/cursor.cpython-311.pyc | Bin 0 -> 13845 bytes .../__pycache__/introspection.cpython-311.pyc | Bin 0 -> 8174 bytes .../asyncpg/__pycache__/pool.cpython-311.pyc | Bin 0 -> 47537 bytes .../__pycache__/prepared_stmt.cpython-311.pyc | Bin 0 -> 12355 bytes .../__pycache__/serverversion.cpython-311.pyc | Bin 0 -> 2030 bytes .../__pycache__/transaction.cpython-311.pyc | Bin 0 -> 11090 bytes .../asyncpg/__pycache__/types.cpython-311.pyc | Bin 0 -> 6412 bytes .../asyncpg/__pycache__/utils.cpython-311.pyc | Bin 0 -> 2570 bytes .../site-packages/asyncpg/_asyncio_compat.py | 87 + .../asyncpg/_testbase/__init__.py | 527 ++ .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 27866 bytes .../__pycache__/fuzzer.cpython-311.pyc | Bin 0 -> 19879 bytes .../site-packages/asyncpg/_testbase/fuzzer.py | 306 ++ env/Lib/site-packages/asyncpg/_version.py | 13 + env/Lib/site-packages/asyncpg/cluster.py | 688 +++ env/Lib/site-packages/asyncpg/compat.py | 61 + .../site-packages/asyncpg/connect_utils.py | 1081 ++++ env/Lib/site-packages/asyncpg/connection.py | 2655 +++++++++ env/Lib/site-packages/asyncpg/connresource.py | 44 + env/Lib/site-packages/asyncpg/cursor.py | 323 ++ .../asyncpg/exceptions/__init__.py | 1198 +++++ .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 56536 bytes .../__pycache__/_base.cpython-311.pyc | Bin 0 -> 15384 bytes .../site-packages/asyncpg/exceptions/_base.py | 299 ++ .../site-packages/asyncpg/introspection.py | 292 + .../asyncpg/pgproto/__init__.pxd | 5 + .../site-packages/asyncpg/pgproto/__init__.py | 5 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 185 bytes .../pgproto/__pycache__/types.cpython-311.pyc | Bin 0 -> 21953 bytes .../site-packages/asyncpg/pgproto/buffer.pxd | 136 + .../site-packages/asyncpg/pgproto/buffer.pyx | 817 +++ .../asyncpg/pgproto/codecs/__init__.pxd | 157 + .../asyncpg/pgproto/codecs/bits.pyx | 47 + .../asyncpg/pgproto/codecs/bytea.pyx | 34 + .../asyncpg/pgproto/codecs/context.pyx | 26 + .../asyncpg/pgproto/codecs/datetime.pyx | 423 ++ .../asyncpg/pgproto/codecs/float.pyx | 34 + .../asyncpg/pgproto/codecs/geometry.pyx | 164 + .../asyncpg/pgproto/codecs/hstore.pyx | 73 + .../asyncpg/pgproto/codecs/int.pyx | 144 + .../asyncpg/pgproto/codecs/json.pyx | 57 + .../asyncpg/pgproto/codecs/jsonpath.pyx | 29 + .../asyncpg/pgproto/codecs/misc.pyx | 16 + .../asyncpg/pgproto/codecs/network.pyx | 139 + .../asyncpg/pgproto/codecs/numeric.pyx | 356 ++ .../asyncpg/pgproto/codecs/pg_snapshot.pyx | 63 + .../asyncpg/pgproto/codecs/text.pyx | 48 + .../asyncpg/pgproto/codecs/tid.pyx | 51 + .../asyncpg/pgproto/codecs/uuid.pyx | 27 + .../site-packages/asyncpg/pgproto/consts.pxi | 12 + .../asyncpg/pgproto/cpythonx.pxd | 23 + .../site-packages/asyncpg/pgproto/debug.pxd | 10 + env/Lib/site-packages/asyncpg/pgproto/frb.pxd | 48 + env/Lib/site-packages/asyncpg/pgproto/frb.pyx | 12 + .../site-packages/asyncpg/pgproto/hton.pxd | 24 + .../pgproto/pgproto.cp311-win_amd64.pyd | Bin 0 -> 239104 bytes .../site-packages/asyncpg/pgproto/pgproto.pxd | 19 + .../site-packages/asyncpg/pgproto/pgproto.pyx | 49 + .../site-packages/asyncpg/pgproto/tohex.pxd | 10 + .../site-packages/asyncpg/pgproto/types.py | 423 ++ .../site-packages/asyncpg/pgproto/uuid.pyx | 353 ++ env/Lib/site-packages/asyncpg/pool.py | 1130 ++++ .../site-packages/asyncpg/prepared_stmt.py | 259 + .../asyncpg/protocol/__init__.py | 9 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 332 bytes .../asyncpg/protocol/codecs/__init__.py | 0 .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 193 bytes .../asyncpg/protocol/codecs/array.pyx | 875 +++ .../asyncpg/protocol/codecs/base.pxd | 187 + .../asyncpg/protocol/codecs/base.pyx | 895 ++++ .../asyncpg/protocol/codecs/pgproto.pyx | 484 ++ .../asyncpg/protocol/codecs/range.pyx | 207 + .../asyncpg/protocol/codecs/record.pyx | 71 + .../asyncpg/protocol/codecs/textutils.pyx | 99 + .../site-packages/asyncpg/protocol/consts.pxi | 12 + .../asyncpg/protocol/coreproto.pxd | 195 + .../asyncpg/protocol/coreproto.pyx | 1153 ++++ .../asyncpg/protocol/cpythonx.pxd | 19 + .../asyncpg/protocol/encodings.pyx | 63 + .../asyncpg/protocol/pgtypes.pxi | 266 + .../asyncpg/protocol/prepared_stmt.pxd | 39 + .../asyncpg/protocol/prepared_stmt.pyx | 395 ++ .../protocol/protocol.cp311-win_amd64.pyd | Bin 0 -> 639488 bytes .../asyncpg/protocol/protocol.pxd | 78 + .../asyncpg/protocol/protocol.pyx | 1064 ++++ .../asyncpg/protocol/record/__init__.pxd | 19 + .../site-packages/asyncpg/protocol/scram.pxd | 31 + .../site-packages/asyncpg/protocol/scram.pyx | 341 ++ .../asyncpg/protocol/settings.pxd | 30 + .../asyncpg/protocol/settings.pyx | 106 + .../site-packages/asyncpg/serverversion.py | 60 + env/Lib/site-packages/asyncpg/transaction.py | 246 + env/Lib/site-packages/asyncpg/types.py | 177 + env/Lib/site-packages/asyncpg/utils.py | 45 + env/Lib/site-packages/attr/__init__.py | 103 + env/Lib/site-packages/attr/__init__.pyi | 388 ++ .../attr/__pycache__/__init__.cpython-311.pyc | Bin 0 -> 3168 bytes .../attr/__pycache__/_cmp.cpython-311.pyc | Bin 0 -> 5377 bytes .../attr/__pycache__/_compat.cpython-311.pyc | Bin 0 -> 3918 bytes .../attr/__pycache__/_config.cpython-311.pyc | Bin 0 -> 1163 bytes .../attr/__pycache__/_funcs.cpython-311.pyc | Bin 0 -> 16976 bytes .../attr/__pycache__/_make.cpython-311.pyc | Bin 0 -> 102234 bytes .../__pycache__/_next_gen.cpython-311.pyc | Bin 0 -> 25139 bytes .../__pycache__/_version_info.cpython-311.pyc | Bin 0 -> 3603 bytes .../__pycache__/converters.cpython-311.pyc | Bin 0 -> 4540 bytes .../__pycache__/exceptions.cpython-311.pyc | Bin 0 -> 4145 bytes .../attr/__pycache__/filters.cpython-311.pyc | Bin 0 -> 3177 bytes .../attr/__pycache__/setters.cpython-311.pyc | Bin 0 -> 2082 bytes .../__pycache__/validators.cpython-311.pyc | Bin 0 -> 28449 bytes env/Lib/site-packages/attr/_cmp.py | 160 + env/Lib/site-packages/attr/_cmp.pyi | 13 + env/Lib/site-packages/attr/_compat.py | 103 + env/Lib/site-packages/attr/_config.py | 31 + env/Lib/site-packages/attr/_funcs.py | 522 ++ env/Lib/site-packages/attr/_make.py | 2960 ++++++++++ env/Lib/site-packages/attr/_next_gen.py | 631 +++ env/Lib/site-packages/attr/_typing_compat.pyi | 15 + env/Lib/site-packages/attr/_version_info.py | 86 + env/Lib/site-packages/attr/_version_info.pyi | 9 + env/Lib/site-packages/attr/converters.py | 151 + env/Lib/site-packages/attr/converters.pyi | 13 + env/Lib/site-packages/attr/exceptions.py | 95 + env/Lib/site-packages/attr/exceptions.pyi | 17 + env/Lib/site-packages/attr/filters.py | 72 + env/Lib/site-packages/attr/filters.pyi | 6 + env/Lib/site-packages/attr/py.typed | 0 env/Lib/site-packages/attr/setters.py | 79 + env/Lib/site-packages/attr/setters.pyi | 20 + env/Lib/site-packages/attr/validators.py | 711 +++ env/Lib/site-packages/attr/validators.pyi | 83 + .../attrs-24.2.0.dist-info/INSTALLER | 1 + .../attrs-24.2.0.dist-info/METADATA | 242 + .../attrs-24.2.0.dist-info/RECORD | 55 + .../attrs-24.2.0.dist-info/WHEEL | 4 + .../attrs-24.2.0.dist-info/licenses/LICENSE | 21 + env/Lib/site-packages/attrs/__init__.py | 67 + env/Lib/site-packages/attrs/__init__.pyi | 252 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 1356 bytes .../__pycache__/converters.cpython-311.pyc | Bin 0 -> 219 bytes .../__pycache__/exceptions.cpython-311.pyc | Bin 0 -> 219 bytes .../attrs/__pycache__/filters.cpython-311.pyc | Bin 0 -> 213 bytes .../attrs/__pycache__/setters.cpython-311.pyc | Bin 0 -> 213 bytes .../__pycache__/validators.cpython-311.pyc | Bin 0 -> 219 bytes env/Lib/site-packages/attrs/converters.py | 3 + env/Lib/site-packages/attrs/exceptions.py | 3 + env/Lib/site-packages/attrs/filters.py | 3 + env/Lib/site-packages/attrs/py.typed | 0 env/Lib/site-packages/attrs/setters.py | 3 + env/Lib/site-packages/attrs/validators.py | 3 + .../frozenlist-1.4.1.dist-info/INSTALLER | 1 + .../frozenlist-1.4.1.dist-info/LICENSE | 201 + .../frozenlist-1.4.1.dist-info/METADATA | 420 ++ .../frozenlist-1.4.1.dist-info/RECORD | 12 + .../frozenlist-1.4.1.dist-info/WHEEL | 5 + .../frozenlist-1.4.1.dist-info/top_level.txt | 1 + env/Lib/site-packages/frozenlist/__init__.py | 95 + env/Lib/site-packages/frozenlist/__init__.pyi | 47 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 4773 bytes .../_frozenlist.cp311-win_amd64.pyd | Bin 0 -> 86016 bytes .../site-packages/frozenlist/_frozenlist.pyx | 123 + env/Lib/site-packages/frozenlist/py.typed | 1 + .../logging-0.4.9.6.dist-info/INSTALLER | 1 + .../logging-0.4.9.6.dist-info/LICENSE | 16 + .../logging-0.4.9.6.dist-info/METADATA | 13 + .../logging-0.4.9.6.dist-info/RECORD | 10 + .../logging-0.4.9.6.dist-info/REQUESTED | 0 .../logging-0.4.9.6.dist-info/WHEEL | 5 + .../logging-0.4.9.6.dist-info/top_level.txt | 1 + env/Lib/site-packages/logging/__init__.py | 1327 +++++ env/Lib/site-packages/logging/handlers.py | 975 ++++ .../magic_filter-1.0.12.dist-info/INSTALLER | 1 + .../magic_filter-1.0.12.dist-info/METADATA | 37 + .../magic_filter-1.0.12.dist-info/RECORD | 40 + .../magic_filter-1.0.12.dist-info/WHEEL | 4 + .../licenses/LICENSE | 18 + .../site-packages/magic_filter/__init__.py | 17 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 516 bytes .../__pycache__/attrdict.cpython-311.pyc | Bin 0 -> 1153 bytes .../__pycache__/exceptions.cpython-311.pyc | Bin 0 -> 1598 bytes .../__pycache__/helper.cpython-311.pyc | Bin 0 -> 640 bytes .../__pycache__/magic.cpython-311.pyc | Bin 0 -> 23382 bytes .../__pycache__/util.cpython-311.pyc | Bin 0 -> 1582 bytes .../site-packages/magic_filter/attrdict.py | 14 + .../site-packages/magic_filter/exceptions.py | 23 + env/Lib/site-packages/magic_filter/helper.py | 10 + env/Lib/site-packages/magic_filter/magic.py | 290 + .../magic_filter/operations/__init__.py | 26 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 1048 bytes .../__pycache__/base.cpython-311.pyc | Bin 0 -> 884 bytes .../__pycache__/call.cpython-311.pyc | Bin 0 -> 1451 bytes .../__pycache__/cast.cpython-311.pyc | Bin 0 -> 1335 bytes .../__pycache__/combination.cpython-311.pyc | Bin 0 -> 2450 bytes .../__pycache__/comparator.cpython-311.pyc | Bin 0 -> 1362 bytes .../__pycache__/extract.cpython-311.pyc | Bin 0 -> 1450 bytes .../__pycache__/function.cpython-311.pyc | Bin 0 -> 2499 bytes .../__pycache__/getattr.cpython-311.pyc | Bin 0 -> 1373 bytes .../__pycache__/getitem.cpython-311.pyc | Bin 0 -> 1751 bytes .../__pycache__/selector.cpython-311.pyc | Bin 0 -> 1333 bytes .../magic_filter/operations/base.py | 10 + .../magic_filter/operations/call.py | 17 + .../magic_filter/operations/cast.py | 17 + .../magic_filter/operations/combination.py | 36 + .../magic_filter/operations/comparator.py | 18 + .../magic_filter/operations/extract.py | 23 + .../magic_filter/operations/function.py | 32 + .../magic_filter/operations/getattr.py | 18 + .../magic_filter/operations/getitem.py | 25 + .../magic_filter/operations/selector.py | 19 + env/Lib/site-packages/magic_filter/py.typed | 0 env/Lib/site-packages/magic_filter/util.py | 37 + .../multidict-6.0.5.dist-info/INSTALLER | 1 + .../multidict-6.0.5.dist-info/LICENSE | 13 + .../multidict-6.0.5.dist-info/METADATA | 132 + .../multidict-6.0.5.dist-info/RECORD | 19 + .../multidict-6.0.5.dist-info/WHEEL | 5 + .../multidict-6.0.5.dist-info/top_level.txt | 1 + env/Lib/site-packages/multidict/__init__.py | 48 + env/Lib/site-packages/multidict/__init__.pyi | 152 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 1141 bytes .../__pycache__/_abc.cpython-311.pyc | Bin 0 -> 2745 bytes .../__pycache__/_compat.cpython-311.pyc | Bin 0 -> 708 bytes .../_multidict_base.cpython-311.pyc | Bin 0 -> 6742 bytes .../__pycache__/_multidict_py.cpython-311.pyc | Bin 0 -> 29031 bytes env/Lib/site-packages/multidict/_abc.py | 48 + env/Lib/site-packages/multidict/_compat.py | 14 + .../multidict/_multidict.cp311-win_amd64.pyd | Bin 0 -> 46592 bytes .../multidict/_multidict_base.py | 144 + .../site-packages/multidict/_multidict_py.py | 527 ++ env/Lib/site-packages/multidict/py.typed | 1 + .../psycopg2-2.9.9.dist-info/INSTALLER | 1 + .../psycopg2-2.9.9.dist-info/LICENSE | 49 + .../psycopg2-2.9.9.dist-info/METADATA | 110 + .../psycopg2-2.9.9.dist-info/RECORD | 30 + .../psycopg2-2.9.9.dist-info/REQUESTED | 0 .../psycopg2-2.9.9.dist-info/WHEEL | 5 + .../psycopg2-2.9.9.dist-info/top_level.txt | 1 + env/Lib/site-packages/psycopg2/__init__.py | 126 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 4085 bytes .../__pycache__/_ipaddress.cpython-311.pyc | Bin 0 -> 2904 bytes .../__pycache__/_json.cpython-311.pyc | Bin 0 -> 7970 bytes .../__pycache__/_range.cpython-311.pyc | Bin 0 -> 22672 bytes .../__pycache__/errorcodes.cpython-311.pyc | Bin 0 -> 14493 bytes .../__pycache__/errors.cpython-311.pyc | Bin 0 -> 566 bytes .../__pycache__/extensions.cpython-311.pyc | Bin 0 -> 9200 bytes .../__pycache__/extras.cpython-311.pyc | Bin 0 -> 68261 bytes .../psycopg2/__pycache__/pool.cpython-311.pyc | Bin 0 -> 8283 bytes .../psycopg2/__pycache__/sql.cpython-311.pyc | Bin 0 -> 20520 bytes .../psycopg2/__pycache__/tz.cpython-311.pyc | Bin 0 -> 6425 bytes env/Lib/site-packages/psycopg2/_ipaddress.py | 90 + env/Lib/site-packages/psycopg2/_json.py | 199 + .../psycopg2/_psycopg.cp311-win_amd64.pyd | Bin 0 -> 2416128 bytes env/Lib/site-packages/psycopg2/_range.py | 554 ++ env/Lib/site-packages/psycopg2/errorcodes.py | 449 ++ env/Lib/site-packages/psycopg2/errors.py | 38 + env/Lib/site-packages/psycopg2/extensions.py | 213 + env/Lib/site-packages/psycopg2/extras.py | 1340 +++++ env/Lib/site-packages/psycopg2/pool.py | 187 + env/Lib/site-packages/psycopg2/sql.py | 455 ++ env/Lib/site-packages/psycopg2/tz.py | 158 + .../pydantic-2.8.2.dist-info/INSTALLER | 1 + .../pydantic-2.8.2.dist-info/METADATA | 1271 +++++ .../pydantic-2.8.2.dist-info/RECORD | 207 + .../pydantic-2.8.2.dist-info/WHEEL | 4 + .../pydantic-2.8.2.dist-info/licenses/LICENSE | 21 + env/Lib/site-packages/pydantic/__init__.py | 409 ++ .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 12099 bytes .../__pycache__/_migration.cpython-311.pyc | Bin 0 -> 11378 bytes .../alias_generators.cpython-311.pyc | Bin 0 -> 3514 bytes .../__pycache__/aliases.cpython-311.pyc | Bin 0 -> 7078 bytes .../annotated_handlers.cpython-311.pyc | Bin 0 -> 5774 bytes .../class_validators.cpython-311.pyc | Bin 0 -> 387 bytes .../__pycache__/color.cpython-311.pyc | Bin 0 -> 32513 bytes .../__pycache__/config.cpython-311.pyc | Bin 0 -> 6310 bytes .../__pycache__/dataclasses.cpython-311.pyc | Bin 0 -> 13401 bytes .../datetime_parse.cpython-311.pyc | Bin 0 -> 387 bytes .../__pycache__/decorator.cpython-311.pyc | Bin 0 -> 377 bytes .../__pycache__/env_settings.cpython-311.pyc | Bin 0 -> 383 bytes .../error_wrappers.cpython-311.pyc | Bin 0 -> 387 bytes .../__pycache__/errors.cpython-311.pyc | Bin 0 -> 7134 bytes .../__pycache__/fields.cpython-311.pyc | Bin 0 -> 57318 bytes .../functional_serializers.cpython-311.pyc | Bin 0 -> 17127 bytes .../functional_validators.cpython-311.pyc | Bin 0 -> 29453 bytes .../__pycache__/generics.cpython-311.pyc | Bin 0 -> 375 bytes .../pydantic/__pycache__/json.cpython-311.pyc | Bin 0 -> 367 bytes .../__pycache__/json_schema.cpython-311.pyc | Bin 0 -> 119193 bytes .../pydantic/__pycache__/main.cpython-311.pyc | Bin 0 -> 71061 bytes .../pydantic/__pycache__/mypy.cpython-311.pyc | Bin 0 -> 65064 bytes .../__pycache__/networks.cpython-311.pyc | Bin 0 -> 20679 bytes .../__pycache__/parse.cpython-311.pyc | Bin 0 -> 369 bytes .../__pycache__/root_model.cpython-311.pyc | Bin 0 -> 8524 bytes .../__pycache__/schema.cpython-311.pyc | Bin 0 -> 371 bytes .../__pycache__/tools.cpython-311.pyc | Bin 0 -> 369 bytes .../__pycache__/type_adapter.cpython-311.pyc | Bin 0 -> 29265 bytes .../__pycache__/types.cpython-311.pyc | Bin 0 -> 97931 bytes .../__pycache__/typing.cpython-311.pyc | Bin 0 -> 367 bytes .../__pycache__/utils.cpython-311.pyc | Bin 0 -> 369 bytes .../validate_call_decorator.cpython-311.pyc | Bin 0 -> 3364 bytes .../__pycache__/validators.cpython-311.pyc | Bin 0 -> 379 bytes .../__pycache__/version.cpython-311.pyc | Bin 0 -> 4215 bytes .../__pycache__/warnings.cpython-311.pyc | Bin 0 -> 4808 bytes .../pydantic/_internal/__init__.py | 0 .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 188 bytes .../__pycache__/_config.cpython-311.pyc | Bin 0 -> 17280 bytes .../_core_metadata.cpython-311.pyc | Bin 0 -> 4438 bytes .../__pycache__/_core_utils.cpython-311.pyc | Bin 0 -> 30714 bytes .../__pycache__/_dataclasses.cpython-311.pyc | Bin 0 -> 10796 bytes .../__pycache__/_decorators.cpython-311.pyc | Bin 0 -> 39708 bytes .../_decorators_v1.cpython-311.pyc | Bin 0 -> 9945 bytes .../_discriminated_union.cpython-311.pyc | Bin 0 -> 24014 bytes .../_docs_extraction.cpython-311.pyc | Bin 0 -> 5667 bytes .../__pycache__/_fields.cpython-311.pyc | Bin 0 -> 15588 bytes .../__pycache__/_forward_ref.cpython-311.pyc | Bin 0 -> 1462 bytes .../_generate_schema.cpython-311.pyc | Bin 0 -> 122132 bytes .../__pycache__/_generics.cpython-311.pyc | Bin 0 -> 25696 bytes .../__pycache__/_git.cpython-311.pyc | Bin 0 -> 1722 bytes .../_internal_dataclass.cpython-311.pyc | Bin 0 -> 335 bytes .../_known_annotated_metadata.cpython-311.pyc | Bin 0 -> 15080 bytes .../__pycache__/_mock_val_ser.cpython-311.pyc | Bin 0 -> 10338 bytes .../_model_construction.cpython-311.pyc | Bin 0 -> 34535 bytes .../__pycache__/_repr.cpython-311.pyc | Bin 0 -> 7833 bytes .../_schema_generation_shared.cpython-311.pyc | Bin 0 -> 6767 bytes .../__pycache__/_signature.cpython-311.pyc | Bin 0 -> 7068 bytes .../_std_types_schema.cpython-311.pyc | Bin 0 -> 35061 bytes .../__pycache__/_typing_extra.cpython-311.pyc | Bin 0 -> 23391 bytes .../__pycache__/_utils.cpython-311.pyc | Bin 0 -> 18255 bytes .../_validate_call.cpython-311.pyc | Bin 0 -> 4655 bytes .../__pycache__/_validators.cpython-311.pyc | Bin 0 -> 14114 bytes .../pydantic/_internal/_config.py | 341 ++ .../pydantic/_internal/_core_metadata.py | 92 + .../pydantic/_internal/_core_utils.py | 568 ++ .../pydantic/_internal/_dataclasses.py | 231 + .../pydantic/_internal/_decorators.py | 817 +++ .../pydantic/_internal/_decorators_v1.py | 174 + .../_internal/_discriminated_union.py | 503 ++ .../pydantic/_internal/_docs_extraction.py | 108 + .../pydantic/_internal/_fields.py | 361 ++ .../pydantic/_internal/_forward_ref.py | 23 + .../pydantic/_internal/_generate_schema.py | 2376 ++++++++ .../pydantic/_internal/_generics.py | 516 ++ .../site-packages/pydantic/_internal/_git.py | 27 + .../pydantic/_internal/_internal_dataclass.py | 7 + .../_internal/_known_annotated_metadata.py | 359 ++ .../pydantic/_internal/_mock_val_ser.py | 194 + .../pydantic/_internal/_model_construction.py | 708 +++ .../site-packages/pydantic/_internal/_repr.py | 118 + .../_internal/_schema_generation_shared.py | 125 + .../pydantic/_internal/_signature.py | 164 + .../pydantic/_internal/_std_types_schema.py | 722 +++ .../pydantic/_internal/_typing_extra.py | 508 ++ .../pydantic/_internal/_utils.py | 362 ++ .../pydantic/_internal/_validate_call.py | 99 + .../pydantic/_internal/_validators.py | 308 ++ env/Lib/site-packages/pydantic/_migration.py | 308 ++ .../pydantic/alias_generators.py | 62 + env/Lib/site-packages/pydantic/aliases.py | 132 + .../pydantic/annotated_handlers.py | 121 + .../pydantic/class_validators.py | 5 + env/Lib/site-packages/pydantic/color.py | 604 +++ env/Lib/site-packages/pydantic/dataclasses.py | 338 ++ .../site-packages/pydantic/datetime_parse.py | 5 + env/Lib/site-packages/pydantic/decorator.py | 5 + .../pydantic/deprecated/__init__.py | 0 .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 189 bytes .../class_validators.cpython-311.pyc | Bin 0 -> 12882 bytes .../__pycache__/config.cpython-311.pyc | Bin 0 -> 4855 bytes .../copy_internals.cpython-311.pyc | Bin 0 -> 9643 bytes .../__pycache__/decorator.cpython-311.pyc | Bin 0 -> 15619 bytes .../__pycache__/json.cpython-311.pyc | Bin 0 -> 6759 bytes .../__pycache__/parse.cpython-311.pyc | Bin 0 -> 3657 bytes .../__pycache__/tools.cpython-311.pyc | Bin 0 -> 3901 bytes .../pydantic/deprecated/class_validators.py | 256 + .../pydantic/deprecated/copy_internals.py | 224 + .../pydantic/deprecated/decorator.py | 279 + .../site-packages/pydantic/deprecated/json.py | 140 + .../pydantic/deprecated/parse.py | 80 + .../pydantic/deprecated/tools.py | 103 + .../site-packages/pydantic/env_settings.py | 5 + .../site-packages/pydantic/error_wrappers.py | 5 + env/Lib/site-packages/pydantic/errors.py | 156 + .../pydantic/experimental/__init__.py | 10 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 592 bytes .../__pycache__/pipeline.cpython-311.pyc | Bin 0 -> 38828 bytes .../pydantic/experimental/pipeline.py | 669 +++ env/Lib/site-packages/pydantic/fields.py | 1255 +++++ .../pydantic/functional_serializers.py | 395 ++ .../pydantic/functional_validators.py | 697 +++ env/Lib/site-packages/pydantic/generics.py | 5 + env/Lib/site-packages/pydantic/json.py | 5 + env/Lib/site-packages/pydantic/json_schema.py | 2520 +++++++++ env/Lib/site-packages/pydantic/main.py | 1580 ++++++ env/Lib/site-packages/pydantic/mypy.py | 1313 +++++ env/Lib/site-packages/pydantic/networks.py | 761 +++ env/Lib/site-packages/pydantic/parse.py | 5 + .../site-packages/pydantic/plugin/__init__.py | 171 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 8302 bytes .../__pycache__/_loader.cpython-311.pyc | Bin 0 -> 2500 bytes .../_schema_validator.cpython-311.pyc | Bin 0 -> 7605 bytes .../site-packages/pydantic/plugin/_loader.py | 56 + .../pydantic/plugin/_schema_validator.py | 139 + env/Lib/site-packages/pydantic/py.typed | 0 env/Lib/site-packages/pydantic/root_model.py | 154 + env/Lib/site-packages/pydantic/schema.py | 5 + env/Lib/site-packages/pydantic/tools.py | 5 + .../site-packages/pydantic/type_adapter.py | 601 +++ env/Lib/site-packages/pydantic/types.py | 3043 +++++++++++ env/Lib/site-packages/pydantic/typing.py | 5 + env/Lib/site-packages/pydantic/utils.py | 5 + env/Lib/site-packages/pydantic/v1/__init__.py | 131 + .../v1/__pycache__/__init__.cpython-311.pyc | Bin 0 -> 2439 bytes .../_hypothesis_plugin.cpython-311.pyc | Bin 0 -> 20240 bytes .../annotated_types.cpython-311.pyc | Bin 0 -> 4686 bytes .../class_validators.cpython-311.pyc | Bin 0 -> 22799 bytes .../v1/__pycache__/color.cpython-311.pyc | Bin 0 -> 28218 bytes .../v1/__pycache__/config.cpython-311.pyc | Bin 0 -> 10046 bytes .../__pycache__/dataclasses.cpython-311.pyc | Bin 0 -> 25817 bytes .../datetime_parse.cpython-311.pyc | Bin 0 -> 11977 bytes .../v1/__pycache__/decorator.cpython-311.pyc | Bin 0 -> 15680 bytes .../__pycache__/env_settings.cpython-311.pyc | Bin 0 -> 20031 bytes .../error_wrappers.cpython-311.pyc | Bin 0 -> 10048 bytes .../v1/__pycache__/errors.cpython-311.pyc | Bin 0 -> 36540 bytes .../v1/__pycache__/fields.cpython-311.pyc | Bin 0 -> 62980 bytes .../v1/__pycache__/generics.cpython-311.pyc | Bin 0 -> 19719 bytes .../v1/__pycache__/json.cpython-311.pyc | Bin 0 -> 5688 bytes .../v1/__pycache__/main.cpython-311.pyc | Bin 0 -> 54948 bytes .../v1/__pycache__/mypy.cpython-311.pyc | Bin 0 -> 50332 bytes .../v1/__pycache__/networks.cpython-311.pyc | Bin 0 -> 34178 bytes .../v1/__pycache__/parse.cpython-311.pyc | Bin 0 -> 3036 bytes .../v1/__pycache__/schema.cpython-311.pyc | Bin 0 -> 54603 bytes .../v1/__pycache__/tools.cpython-311.pyc | Bin 0 -> 4463 bytes .../v1/__pycache__/types.cpython-311.pyc | Bin 0 -> 55095 bytes .../v1/__pycache__/typing.cpython-311.pyc | Bin 0 -> 25273 bytes .../v1/__pycache__/utils.cpython-311.pyc | Bin 0 -> 40726 bytes .../v1/__pycache__/validators.cpython-311.pyc | Bin 0 -> 34657 bytes .../v1/__pycache__/version.cpython-311.pyc | Bin 0 -> 2198 bytes .../pydantic/v1/_hypothesis_plugin.py | 391 ++ .../pydantic/v1/annotated_types.py | 72 + .../pydantic/v1/class_validators.py | 361 ++ env/Lib/site-packages/pydantic/v1/color.py | 494 ++ .../site-packages/pydantic/v1/dataclasses.py | 500 ++ .../pydantic/v1/datetime_parse.py | 248 + .../site-packages/pydantic/v1/decorator.py | 264 + .../site-packages/pydantic/v1/env_settings.py | 350 ++ .../pydantic/v1/error_wrappers.py | 161 + env/Lib/site-packages/pydantic/v1/errors.py | 646 +++ env/Lib/site-packages/pydantic/v1/fields.py | 1253 +++++ env/Lib/site-packages/pydantic/v1/generics.py | 400 ++ env/Lib/site-packages/pydantic/v1/json.py | 112 + env/Lib/site-packages/pydantic/v1/main.py | 1107 ++++ env/Lib/site-packages/pydantic/v1/mypy.py | 945 ++++ env/Lib/site-packages/pydantic/v1/networks.py | 747 +++ env/Lib/site-packages/pydantic/v1/parse.py | 66 + env/Lib/site-packages/pydantic/v1/py.typed | 0 env/Lib/site-packages/pydantic/v1/schema.py | 1163 ++++ env/Lib/site-packages/pydantic/v1/tools.py | 92 + env/Lib/site-packages/pydantic/v1/types.py | 1205 +++++ env/Lib/site-packages/pydantic/v1/typing.py | 608 +++ env/Lib/site-packages/pydantic/v1/utils.py | 803 +++ .../site-packages/pydantic/v1/validators.py | 765 +++ env/Lib/site-packages/pydantic/v1/version.py | 38 + .../pydantic/validate_call_decorator.py | 69 + env/Lib/site-packages/pydantic/validators.py | 5 + env/Lib/site-packages/pydantic/version.py | 78 + env/Lib/site-packages/pydantic/warnings.py | 72 + .../pydantic_core-2.20.1.dist-info/INSTALLER | 1 + .../pydantic_core-2.20.1.dist-info/METADATA | 161 + .../pydantic_core-2.20.1.dist-info/RECORD | 12 + .../pydantic_core-2.20.1.dist-info/WHEEL | 4 + .../license_files/LICENSE | 21 + .../site-packages/pydantic_core/__init__.py | 139 + .../__pycache__/__init__.cpython-311.pyc | Bin 0 -> 3720 bytes .../__pycache__/core_schema.cpython-311.pyc | Bin 0 -> 146328 bytes .../_pydantic_core.cp311-win_amd64.pyd | Bin 0 -> 5021696 bytes .../pydantic_core/_pydantic_core.pyi | 899 ++++ .../pydantic_core/core_schema.py | 4061 ++++++++++++++ env/Lib/site-packages/pydantic_core/py.typed | 0 .../INSTALLER | 1 + .../LICENSE | 279 + .../METADATA | 67 + .../typing_extensions-4.12.2.dist-info/RECORD | 7 + .../typing_extensions-4.12.2.dist-info/WHEEL | 4 + env/Lib/site-packages/typing_extensions.py | 3641 +++++++++++++ .../yarl-1.9.4.dist-info/INSTALLER | 1 + .../yarl-1.9.4.dist-info/LICENSE | 202 + .../yarl-1.9.4.dist-info/METADATA | 1086 ++++ .../site-packages/yarl-1.9.4.dist-info/NOTICE | 13 + .../site-packages/yarl-1.9.4.dist-info/RECORD | 20 + .../site-packages/yarl-1.9.4.dist-info/WHEEL | 5 + .../yarl-1.9.4.dist-info/top_level.txt | 1 + env/Lib/site-packages/yarl/__init__.py | 5 + env/Lib/site-packages/yarl/__init__.pyi | 121 + .../yarl/__pycache__/__init__.cpython-311.pyc | Bin 0 -> 352 bytes .../yarl/__pycache__/_quoting.cpython-311.pyc | Bin 0 -> 786 bytes .../__pycache__/_quoting_py.cpython-311.pyc | Bin 0 -> 9602 bytes .../yarl/__pycache__/_url.cpython-311.pyc | Bin 0 -> 50941 bytes env/Lib/site-packages/yarl/_quoting.py | 18 + .../yarl/_quoting_c.cp311-win_amd64.pyd | Bin 0 -> 95744 bytes env/Lib/site-packages/yarl/_quoting_c.pyi | 16 + env/Lib/site-packages/yarl/_quoting_c.pyx | 371 ++ env/Lib/site-packages/yarl/_quoting_py.py | 197 + env/Lib/site-packages/yarl/_url.py | 1200 +++++ env/Lib/site-packages/yarl/py.typed | 1 + project/__pycache__/config.cpython-311.pyc | Bin 0 -> 607 bytes project/__pycache__/db.cpython-311.pyc | Bin 0 -> 8728 bytes project/bot.py | 178 + 1675 files changed, 164420 insertions(+), 115 deletions(-) create mode 100644 bot.log delete mode 100644 bot.py create mode 100644 env/Lib/site-packages/__pycache__/typing_extensions.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiofiles-23.2.1.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/aiofiles-23.2.1.dist-info/METADATA create mode 100644 env/Lib/site-packages/aiofiles-23.2.1.dist-info/RECORD create mode 100644 env/Lib/site-packages/aiofiles-23.2.1.dist-info/WHEEL create mode 100644 env/Lib/site-packages/aiofiles-23.2.1.dist-info/licenses/LICENSE create mode 100644 env/Lib/site-packages/aiofiles-23.2.1.dist-info/licenses/NOTICE create mode 100644 env/Lib/site-packages/aiofiles/__init__.py create mode 100644 env/Lib/site-packages/aiofiles/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiofiles/__pycache__/base.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiofiles/__pycache__/os.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiofiles/__pycache__/ospath.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiofiles/base.py create mode 100644 env/Lib/site-packages/aiofiles/os.py create mode 100644 env/Lib/site-packages/aiofiles/ospath.py create mode 100644 env/Lib/site-packages/aiofiles/tempfile/__init__.py create mode 100644 env/Lib/site-packages/aiofiles/tempfile/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiofiles/tempfile/__pycache__/temptypes.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiofiles/tempfile/temptypes.py create mode 100644 env/Lib/site-packages/aiofiles/threadpool/__init__.py create mode 100644 env/Lib/site-packages/aiofiles/threadpool/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiofiles/threadpool/__pycache__/binary.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiofiles/threadpool/__pycache__/text.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiofiles/threadpool/__pycache__/utils.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiofiles/threadpool/binary.py create mode 100644 env/Lib/site-packages/aiofiles/threadpool/text.py create mode 100644 env/Lib/site-packages/aiofiles/threadpool/utils.py create mode 100644 env/Lib/site-packages/aiogram-3.12.0.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/aiogram-3.12.0.dist-info/METADATA create mode 100644 env/Lib/site-packages/aiogram-3.12.0.dist-info/RECORD create mode 100644 env/Lib/site-packages/aiogram-3.12.0.dist-info/REQUESTED create mode 100644 env/Lib/site-packages/aiogram-3.12.0.dist-info/WHEEL create mode 100644 env/Lib/site-packages/aiogram-3.12.0.dist-info/licenses/LICENSE create mode 100644 env/Lib/site-packages/aiogram/__init__.py create mode 100644 env/Lib/site-packages/aiogram/__meta__.py create mode 100644 env/Lib/site-packages/aiogram/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/__pycache__/__meta__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/__pycache__/exceptions.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/__pycache__/loggers.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/client/__init__.py create mode 100644 env/Lib/site-packages/aiogram/client/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/client/__pycache__/bot.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/client/__pycache__/context_controller.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/client/__pycache__/default.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/client/__pycache__/telegram.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/client/bot.py create mode 100644 env/Lib/site-packages/aiogram/client/context_controller.py create mode 100644 env/Lib/site-packages/aiogram/client/default.py create mode 100644 env/Lib/site-packages/aiogram/client/session/__init__.py create mode 100644 env/Lib/site-packages/aiogram/client/session/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/client/session/__pycache__/aiohttp.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/client/session/__pycache__/base.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/client/session/aiohttp.py create mode 100644 env/Lib/site-packages/aiogram/client/session/base.py create mode 100644 env/Lib/site-packages/aiogram/client/session/middlewares/__init__.py create mode 100644 env/Lib/site-packages/aiogram/client/session/middlewares/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/client/session/middlewares/__pycache__/base.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/client/session/middlewares/__pycache__/manager.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/client/session/middlewares/__pycache__/request_logging.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/client/session/middlewares/base.py create mode 100644 env/Lib/site-packages/aiogram/client/session/middlewares/manager.py create mode 100644 env/Lib/site-packages/aiogram/client/session/middlewares/request_logging.py create mode 100644 env/Lib/site-packages/aiogram/client/telegram.py create mode 100644 env/Lib/site-packages/aiogram/dispatcher/__init__.py create mode 100644 env/Lib/site-packages/aiogram/dispatcher/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/dispatcher/__pycache__/dispatcher.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/dispatcher/__pycache__/flags.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/dispatcher/__pycache__/router.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/dispatcher/dispatcher.py create mode 100644 env/Lib/site-packages/aiogram/dispatcher/event/__init__.py create mode 100644 env/Lib/site-packages/aiogram/dispatcher/event/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/dispatcher/event/__pycache__/bases.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/dispatcher/event/__pycache__/event.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/dispatcher/event/__pycache__/handler.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/dispatcher/event/__pycache__/telegram.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/dispatcher/event/bases.py create mode 100644 env/Lib/site-packages/aiogram/dispatcher/event/event.py create mode 100644 env/Lib/site-packages/aiogram/dispatcher/event/handler.py create mode 100644 env/Lib/site-packages/aiogram/dispatcher/event/telegram.py create mode 100644 env/Lib/site-packages/aiogram/dispatcher/flags.py create mode 100644 env/Lib/site-packages/aiogram/dispatcher/middlewares/__init__.py create mode 100644 env/Lib/site-packages/aiogram/dispatcher/middlewares/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/dispatcher/middlewares/__pycache__/base.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/dispatcher/middlewares/__pycache__/error.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/dispatcher/middlewares/__pycache__/manager.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/dispatcher/middlewares/__pycache__/user_context.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/dispatcher/middlewares/base.py create mode 100644 env/Lib/site-packages/aiogram/dispatcher/middlewares/error.py create mode 100644 env/Lib/site-packages/aiogram/dispatcher/middlewares/manager.py create mode 100644 env/Lib/site-packages/aiogram/dispatcher/middlewares/user_context.py create mode 100644 env/Lib/site-packages/aiogram/dispatcher/router.py create mode 100644 env/Lib/site-packages/aiogram/enums/__init__.py create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/bot_command_scope_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/chat_action.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/chat_boost_source_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/chat_member_status.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/chat_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/content_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/currency.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/dice_emoji.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/encrypted_passport_element.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/inline_query_result_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/input_media_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/input_paid_media_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/keyboard_button_poll_type_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/mask_position_point.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/menu_button_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/message_entity_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/message_origin_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/paid_media_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/parse_mode.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/passport_element_error_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/poll_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/reaction_type_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/revenue_withdrawal_state_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/sticker_format.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/sticker_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/topic_icon_color.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/transaction_partner_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/__pycache__/update_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/enums/bot_command_scope_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/chat_action.py create mode 100644 env/Lib/site-packages/aiogram/enums/chat_boost_source_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/chat_member_status.py create mode 100644 env/Lib/site-packages/aiogram/enums/chat_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/content_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/currency.py create mode 100644 env/Lib/site-packages/aiogram/enums/dice_emoji.py create mode 100644 env/Lib/site-packages/aiogram/enums/encrypted_passport_element.py create mode 100644 env/Lib/site-packages/aiogram/enums/inline_query_result_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/input_media_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/input_paid_media_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/keyboard_button_poll_type_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/mask_position_point.py create mode 100644 env/Lib/site-packages/aiogram/enums/menu_button_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/message_entity_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/message_origin_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/paid_media_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/parse_mode.py create mode 100644 env/Lib/site-packages/aiogram/enums/passport_element_error_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/poll_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/reaction_type_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/revenue_withdrawal_state_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/sticker_format.py create mode 100644 env/Lib/site-packages/aiogram/enums/sticker_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/topic_icon_color.py create mode 100644 env/Lib/site-packages/aiogram/enums/transaction_partner_type.py create mode 100644 env/Lib/site-packages/aiogram/enums/update_type.py create mode 100644 env/Lib/site-packages/aiogram/exceptions.py create mode 100644 env/Lib/site-packages/aiogram/filters/__init__.py create mode 100644 env/Lib/site-packages/aiogram/filters/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/filters/__pycache__/base.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/filters/__pycache__/callback_data.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/filters/__pycache__/chat_member_updated.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/filters/__pycache__/command.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/filters/__pycache__/exception.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/filters/__pycache__/logic.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/filters/__pycache__/magic_data.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/filters/__pycache__/state.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/filters/base.py create mode 100644 env/Lib/site-packages/aiogram/filters/callback_data.py create mode 100644 env/Lib/site-packages/aiogram/filters/chat_member_updated.py create mode 100644 env/Lib/site-packages/aiogram/filters/command.py create mode 100644 env/Lib/site-packages/aiogram/filters/exception.py create mode 100644 env/Lib/site-packages/aiogram/filters/logic.py create mode 100644 env/Lib/site-packages/aiogram/filters/magic_data.py create mode 100644 env/Lib/site-packages/aiogram/filters/state.py create mode 100644 env/Lib/site-packages/aiogram/fsm/__init__.py create mode 100644 env/Lib/site-packages/aiogram/fsm/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/fsm/__pycache__/context.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/fsm/__pycache__/middleware.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/fsm/__pycache__/scene.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/fsm/__pycache__/state.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/fsm/__pycache__/strategy.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/fsm/context.py create mode 100644 env/Lib/site-packages/aiogram/fsm/middleware.py create mode 100644 env/Lib/site-packages/aiogram/fsm/scene.py create mode 100644 env/Lib/site-packages/aiogram/fsm/state.py create mode 100644 env/Lib/site-packages/aiogram/fsm/storage/__init__.py create mode 100644 env/Lib/site-packages/aiogram/fsm/storage/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/fsm/storage/__pycache__/base.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/fsm/storage/__pycache__/memory.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/fsm/storage/__pycache__/mongo.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/fsm/storage/__pycache__/redis.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/fsm/storage/base.py create mode 100644 env/Lib/site-packages/aiogram/fsm/storage/memory.py create mode 100644 env/Lib/site-packages/aiogram/fsm/storage/mongo.py create mode 100644 env/Lib/site-packages/aiogram/fsm/storage/redis.py create mode 100644 env/Lib/site-packages/aiogram/fsm/strategy.py create mode 100644 env/Lib/site-packages/aiogram/handlers/__init__.py create mode 100644 env/Lib/site-packages/aiogram/handlers/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/handlers/__pycache__/base.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/handlers/__pycache__/callback_query.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/handlers/__pycache__/chat_member.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/handlers/__pycache__/chosen_inline_result.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/handlers/__pycache__/error.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/handlers/__pycache__/inline_query.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/handlers/__pycache__/message.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/handlers/__pycache__/poll.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/handlers/__pycache__/pre_checkout_query.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/handlers/__pycache__/shipping_query.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/handlers/base.py create mode 100644 env/Lib/site-packages/aiogram/handlers/callback_query.py create mode 100644 env/Lib/site-packages/aiogram/handlers/chat_member.py create mode 100644 env/Lib/site-packages/aiogram/handlers/chosen_inline_result.py create mode 100644 env/Lib/site-packages/aiogram/handlers/error.py create mode 100644 env/Lib/site-packages/aiogram/handlers/inline_query.py create mode 100644 env/Lib/site-packages/aiogram/handlers/message.py create mode 100644 env/Lib/site-packages/aiogram/handlers/poll.py create mode 100644 env/Lib/site-packages/aiogram/handlers/pre_checkout_query.py create mode 100644 env/Lib/site-packages/aiogram/handlers/shipping_query.py create mode 100644 env/Lib/site-packages/aiogram/loggers.py create mode 100644 env/Lib/site-packages/aiogram/methods/__init__.py create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/add_sticker_to_set.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/answer_callback_query.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/answer_inline_query.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/answer_pre_checkout_query.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/answer_shipping_query.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/answer_web_app_query.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/approve_chat_join_request.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/ban_chat_member.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/ban_chat_sender_chat.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/base.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/close.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/close_forum_topic.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/close_general_forum_topic.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/copy_message.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/copy_messages.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/create_chat_invite_link.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/create_chat_subscription_invite_link.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/create_forum_topic.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/create_invoice_link.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/create_new_sticker_set.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/decline_chat_join_request.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/delete_chat_photo.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/delete_chat_sticker_set.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/delete_forum_topic.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/delete_message.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/delete_messages.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/delete_my_commands.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/delete_sticker_from_set.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/delete_sticker_set.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/delete_webhook.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/edit_chat_invite_link.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/edit_chat_subscription_invite_link.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/edit_forum_topic.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/edit_general_forum_topic.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/edit_message_caption.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/edit_message_live_location.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/edit_message_media.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/edit_message_reply_markup.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/edit_message_text.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/export_chat_invite_link.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/forward_message.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/forward_messages.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_business_connection.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_chat.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_chat_administrators.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_chat_member.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_chat_member_count.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_chat_menu_button.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_custom_emoji_stickers.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_file.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_forum_topic_icon_stickers.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_game_high_scores.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_me.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_my_commands.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_my_default_administrator_rights.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_my_description.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_my_name.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_my_short_description.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_star_transactions.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_sticker_set.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_updates.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_user_chat_boosts.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_user_profile_photos.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/get_webhook_info.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/hide_general_forum_topic.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/leave_chat.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/log_out.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/pin_chat_message.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/promote_chat_member.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/refund_star_payment.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/reopen_forum_topic.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/reopen_general_forum_topic.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/replace_sticker_in_set.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/restrict_chat_member.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/revoke_chat_invite_link.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_animation.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_audio.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_chat_action.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_contact.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_dice.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_document.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_game.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_invoice.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_location.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_media_group.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_message.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_paid_media.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_photo.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_poll.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_sticker.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_venue.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_video.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_video_note.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/send_voice.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_administrator_custom_title.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_description.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_menu_button.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_permissions.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_photo.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_sticker_set.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_title.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_custom_emoji_sticker_set_thumbnail.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_game_score.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_message_reaction.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_my_commands.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_my_default_administrator_rights.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_my_description.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_my_name.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_my_short_description.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_passport_data_errors.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_sticker_emoji_list.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_sticker_keywords.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_sticker_mask_position.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_sticker_position_in_set.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_sticker_set_thumbnail.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_sticker_set_title.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/set_webhook.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/stop_message_live_location.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/stop_poll.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/unban_chat_member.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/unban_chat_sender_chat.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/unhide_general_forum_topic.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/unpin_all_chat_messages.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/unpin_all_forum_topic_messages.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/unpin_all_general_forum_topic_messages.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/unpin_chat_message.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/__pycache__/upload_sticker_file.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/methods/add_sticker_to_set.py create mode 100644 env/Lib/site-packages/aiogram/methods/answer_callback_query.py create mode 100644 env/Lib/site-packages/aiogram/methods/answer_inline_query.py create mode 100644 env/Lib/site-packages/aiogram/methods/answer_pre_checkout_query.py create mode 100644 env/Lib/site-packages/aiogram/methods/answer_shipping_query.py create mode 100644 env/Lib/site-packages/aiogram/methods/answer_web_app_query.py create mode 100644 env/Lib/site-packages/aiogram/methods/approve_chat_join_request.py create mode 100644 env/Lib/site-packages/aiogram/methods/ban_chat_member.py create mode 100644 env/Lib/site-packages/aiogram/methods/ban_chat_sender_chat.py create mode 100644 env/Lib/site-packages/aiogram/methods/base.py create mode 100644 env/Lib/site-packages/aiogram/methods/close.py create mode 100644 env/Lib/site-packages/aiogram/methods/close_forum_topic.py create mode 100644 env/Lib/site-packages/aiogram/methods/close_general_forum_topic.py create mode 100644 env/Lib/site-packages/aiogram/methods/copy_message.py create mode 100644 env/Lib/site-packages/aiogram/methods/copy_messages.py create mode 100644 env/Lib/site-packages/aiogram/methods/create_chat_invite_link.py create mode 100644 env/Lib/site-packages/aiogram/methods/create_chat_subscription_invite_link.py create mode 100644 env/Lib/site-packages/aiogram/methods/create_forum_topic.py create mode 100644 env/Lib/site-packages/aiogram/methods/create_invoice_link.py create mode 100644 env/Lib/site-packages/aiogram/methods/create_new_sticker_set.py create mode 100644 env/Lib/site-packages/aiogram/methods/decline_chat_join_request.py create mode 100644 env/Lib/site-packages/aiogram/methods/delete_chat_photo.py create mode 100644 env/Lib/site-packages/aiogram/methods/delete_chat_sticker_set.py create mode 100644 env/Lib/site-packages/aiogram/methods/delete_forum_topic.py create mode 100644 env/Lib/site-packages/aiogram/methods/delete_message.py create mode 100644 env/Lib/site-packages/aiogram/methods/delete_messages.py create mode 100644 env/Lib/site-packages/aiogram/methods/delete_my_commands.py create mode 100644 env/Lib/site-packages/aiogram/methods/delete_sticker_from_set.py create mode 100644 env/Lib/site-packages/aiogram/methods/delete_sticker_set.py create mode 100644 env/Lib/site-packages/aiogram/methods/delete_webhook.py create mode 100644 env/Lib/site-packages/aiogram/methods/edit_chat_invite_link.py create mode 100644 env/Lib/site-packages/aiogram/methods/edit_chat_subscription_invite_link.py create mode 100644 env/Lib/site-packages/aiogram/methods/edit_forum_topic.py create mode 100644 env/Lib/site-packages/aiogram/methods/edit_general_forum_topic.py create mode 100644 env/Lib/site-packages/aiogram/methods/edit_message_caption.py create mode 100644 env/Lib/site-packages/aiogram/methods/edit_message_live_location.py create mode 100644 env/Lib/site-packages/aiogram/methods/edit_message_media.py create mode 100644 env/Lib/site-packages/aiogram/methods/edit_message_reply_markup.py create mode 100644 env/Lib/site-packages/aiogram/methods/edit_message_text.py create mode 100644 env/Lib/site-packages/aiogram/methods/export_chat_invite_link.py create mode 100644 env/Lib/site-packages/aiogram/methods/forward_message.py create mode 100644 env/Lib/site-packages/aiogram/methods/forward_messages.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_business_connection.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_chat.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_chat_administrators.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_chat_member.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_chat_member_count.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_chat_menu_button.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_custom_emoji_stickers.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_file.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_forum_topic_icon_stickers.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_game_high_scores.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_me.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_my_commands.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_my_default_administrator_rights.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_my_description.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_my_name.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_my_short_description.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_star_transactions.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_sticker_set.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_updates.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_user_chat_boosts.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_user_profile_photos.py create mode 100644 env/Lib/site-packages/aiogram/methods/get_webhook_info.py create mode 100644 env/Lib/site-packages/aiogram/methods/hide_general_forum_topic.py create mode 100644 env/Lib/site-packages/aiogram/methods/leave_chat.py create mode 100644 env/Lib/site-packages/aiogram/methods/log_out.py create mode 100644 env/Lib/site-packages/aiogram/methods/pin_chat_message.py create mode 100644 env/Lib/site-packages/aiogram/methods/promote_chat_member.py create mode 100644 env/Lib/site-packages/aiogram/methods/refund_star_payment.py create mode 100644 env/Lib/site-packages/aiogram/methods/reopen_forum_topic.py create mode 100644 env/Lib/site-packages/aiogram/methods/reopen_general_forum_topic.py create mode 100644 env/Lib/site-packages/aiogram/methods/replace_sticker_in_set.py create mode 100644 env/Lib/site-packages/aiogram/methods/restrict_chat_member.py create mode 100644 env/Lib/site-packages/aiogram/methods/revoke_chat_invite_link.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_animation.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_audio.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_chat_action.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_contact.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_dice.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_document.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_game.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_invoice.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_location.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_media_group.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_message.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_paid_media.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_photo.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_poll.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_sticker.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_venue.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_video.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_video_note.py create mode 100644 env/Lib/site-packages/aiogram/methods/send_voice.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_chat_administrator_custom_title.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_chat_description.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_chat_menu_button.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_chat_permissions.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_chat_photo.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_chat_sticker_set.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_chat_title.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_custom_emoji_sticker_set_thumbnail.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_game_score.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_message_reaction.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_my_commands.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_my_default_administrator_rights.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_my_description.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_my_name.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_my_short_description.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_passport_data_errors.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_sticker_emoji_list.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_sticker_keywords.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_sticker_mask_position.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_sticker_position_in_set.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_sticker_set_thumbnail.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_sticker_set_title.py create mode 100644 env/Lib/site-packages/aiogram/methods/set_webhook.py create mode 100644 env/Lib/site-packages/aiogram/methods/stop_message_live_location.py create mode 100644 env/Lib/site-packages/aiogram/methods/stop_poll.py create mode 100644 env/Lib/site-packages/aiogram/methods/unban_chat_member.py create mode 100644 env/Lib/site-packages/aiogram/methods/unban_chat_sender_chat.py create mode 100644 env/Lib/site-packages/aiogram/methods/unhide_general_forum_topic.py create mode 100644 env/Lib/site-packages/aiogram/methods/unpin_all_chat_messages.py create mode 100644 env/Lib/site-packages/aiogram/methods/unpin_all_forum_topic_messages.py create mode 100644 env/Lib/site-packages/aiogram/methods/unpin_all_general_forum_topic_messages.py create mode 100644 env/Lib/site-packages/aiogram/methods/unpin_chat_message.py create mode 100644 env/Lib/site-packages/aiogram/methods/upload_sticker_file.py create mode 100644 env/Lib/site-packages/aiogram/py.typed create mode 100644 env/Lib/site-packages/aiogram/types/__init__.py create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/animation.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/audio.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/background_fill.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/background_fill_freeform_gradient.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/background_fill_gradient.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/background_fill_solid.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/background_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/background_type_chat_theme.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/background_type_fill.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/background_type_pattern.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/background_type_wallpaper.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/base.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/birthdate.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/bot_command.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_all_chat_administrators.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_all_group_chats.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_all_private_chats.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_chat.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_chat_administrators.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_chat_member.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_default.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/bot_description.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/bot_name.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/bot_short_description.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/business_connection.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/business_intro.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/business_location.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/business_messages_deleted.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/business_opening_hours.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/business_opening_hours_interval.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/callback_game.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/callback_query.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_administrator_rights.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_background.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_boost.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_boost_added.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_boost_removed.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_boost_source.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_boost_source_gift_code.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_boost_source_giveaway.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_boost_source_premium.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_boost_updated.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_full_info.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_invite_link.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_join_request.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_location.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_member.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_member_administrator.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_member_banned.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_member_left.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_member_member.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_member_owner.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_member_restricted.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_member_updated.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_permissions.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_photo.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chat_shared.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/chosen_inline_result.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/contact.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/custom.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/dice.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/document.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/downloadable.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/encrypted_credentials.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/encrypted_passport_element.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/error_event.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/external_reply_info.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/file.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/force_reply.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/forum_topic.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/forum_topic_closed.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/forum_topic_created.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/forum_topic_edited.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/forum_topic_reopened.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/game.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/game_high_score.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/general_forum_topic_hidden.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/general_forum_topic_unhidden.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/giveaway.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/giveaway_completed.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/giveaway_created.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/giveaway_winners.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inaccessible_message.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_keyboard_button.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_keyboard_markup.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_article.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_audio.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_cached_audio.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_cached_document.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_cached_gif.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_cached_mpeg4_gif.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_cached_photo.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_cached_sticker.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_cached_video.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_cached_voice.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_contact.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_document.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_game.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_gif.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_location.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_mpeg4_gif.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_photo.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_venue.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_video.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_voice.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/inline_query_results_button.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_contact_message_content.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_file.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_invoice_message_content.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_location_message_content.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_media.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_media_animation.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_media_audio.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_media_document.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_media_photo.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_media_video.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_message_content.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_paid_media.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_paid_media_photo.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_paid_media_video.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_poll_option.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_sticker.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_text_message_content.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/input_venue_message_content.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/invoice.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/keyboard_button.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/keyboard_button_poll_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/keyboard_button_request_chat.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/keyboard_button_request_user.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/keyboard_button_request_users.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/labeled_price.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/link_preview_options.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/location.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/login_url.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/mask_position.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/maybe_inaccessible_message.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/menu_button.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/menu_button_commands.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/menu_button_default.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/menu_button_web_app.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/message.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/message_auto_delete_timer_changed.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/message_entity.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/message_id.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/message_origin.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/message_origin_channel.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/message_origin_chat.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/message_origin_hidden_user.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/message_origin_user.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/message_reaction_count_updated.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/message_reaction_updated.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/order_info.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/paid_media.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/paid_media_info.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/paid_media_photo.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/paid_media_preview.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/paid_media_video.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/passport_data.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_data_field.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_file.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_files.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_front_side.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_reverse_side.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_selfie.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_translation_file.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_translation_files.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_unspecified.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/passport_file.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/photo_size.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/poll.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/poll_answer.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/poll_option.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/pre_checkout_query.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/proximity_alert_triggered.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/reaction_count.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/reaction_type.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/reaction_type_custom_emoji.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/reaction_type_emoji.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/reaction_type_paid.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/refunded_payment.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/reply_keyboard_markup.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/reply_keyboard_remove.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/reply_parameters.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/response_parameters.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/revenue_withdrawal_state.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/revenue_withdrawal_state_failed.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/revenue_withdrawal_state_pending.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/revenue_withdrawal_state_succeeded.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/sent_web_app_message.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/shared_user.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/shipping_address.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/shipping_option.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/shipping_query.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/star_transaction.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/star_transactions.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/sticker.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/sticker_set.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/story.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/successful_payment.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/switch_inline_query_chosen_chat.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/text_quote.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/transaction_partner.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/transaction_partner_fragment.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/transaction_partner_other.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/transaction_partner_telegram_ads.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/transaction_partner_user.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/update.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/user.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/user_chat_boosts.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/user_profile_photos.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/user_shared.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/users_shared.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/venue.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/video.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/video_chat_ended.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/video_chat_participants_invited.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/video_chat_scheduled.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/video_chat_started.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/video_note.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/voice.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/web_app_data.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/web_app_info.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/webhook_info.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/__pycache__/write_access_allowed.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/types/animation.py create mode 100644 env/Lib/site-packages/aiogram/types/audio.py create mode 100644 env/Lib/site-packages/aiogram/types/background_fill.py create mode 100644 env/Lib/site-packages/aiogram/types/background_fill_freeform_gradient.py create mode 100644 env/Lib/site-packages/aiogram/types/background_fill_gradient.py create mode 100644 env/Lib/site-packages/aiogram/types/background_fill_solid.py create mode 100644 env/Lib/site-packages/aiogram/types/background_type.py create mode 100644 env/Lib/site-packages/aiogram/types/background_type_chat_theme.py create mode 100644 env/Lib/site-packages/aiogram/types/background_type_fill.py create mode 100644 env/Lib/site-packages/aiogram/types/background_type_pattern.py create mode 100644 env/Lib/site-packages/aiogram/types/background_type_wallpaper.py create mode 100644 env/Lib/site-packages/aiogram/types/base.py create mode 100644 env/Lib/site-packages/aiogram/types/birthdate.py create mode 100644 env/Lib/site-packages/aiogram/types/bot_command.py create mode 100644 env/Lib/site-packages/aiogram/types/bot_command_scope.py create mode 100644 env/Lib/site-packages/aiogram/types/bot_command_scope_all_chat_administrators.py create mode 100644 env/Lib/site-packages/aiogram/types/bot_command_scope_all_group_chats.py create mode 100644 env/Lib/site-packages/aiogram/types/bot_command_scope_all_private_chats.py create mode 100644 env/Lib/site-packages/aiogram/types/bot_command_scope_chat.py create mode 100644 env/Lib/site-packages/aiogram/types/bot_command_scope_chat_administrators.py create mode 100644 env/Lib/site-packages/aiogram/types/bot_command_scope_chat_member.py create mode 100644 env/Lib/site-packages/aiogram/types/bot_command_scope_default.py create mode 100644 env/Lib/site-packages/aiogram/types/bot_description.py create mode 100644 env/Lib/site-packages/aiogram/types/bot_name.py create mode 100644 env/Lib/site-packages/aiogram/types/bot_short_description.py create mode 100644 env/Lib/site-packages/aiogram/types/business_connection.py create mode 100644 env/Lib/site-packages/aiogram/types/business_intro.py create mode 100644 env/Lib/site-packages/aiogram/types/business_location.py create mode 100644 env/Lib/site-packages/aiogram/types/business_messages_deleted.py create mode 100644 env/Lib/site-packages/aiogram/types/business_opening_hours.py create mode 100644 env/Lib/site-packages/aiogram/types/business_opening_hours_interval.py create mode 100644 env/Lib/site-packages/aiogram/types/callback_game.py create mode 100644 env/Lib/site-packages/aiogram/types/callback_query.py create mode 100644 env/Lib/site-packages/aiogram/types/chat.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_administrator_rights.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_background.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_boost.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_boost_added.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_boost_removed.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_boost_source.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_boost_source_gift_code.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_boost_source_giveaway.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_boost_source_premium.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_boost_updated.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_full_info.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_invite_link.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_join_request.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_location.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_member.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_member_administrator.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_member_banned.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_member_left.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_member_member.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_member_owner.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_member_restricted.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_member_updated.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_permissions.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_photo.py create mode 100644 env/Lib/site-packages/aiogram/types/chat_shared.py create mode 100644 env/Lib/site-packages/aiogram/types/chosen_inline_result.py create mode 100644 env/Lib/site-packages/aiogram/types/contact.py create mode 100644 env/Lib/site-packages/aiogram/types/custom.py create mode 100644 env/Lib/site-packages/aiogram/types/dice.py create mode 100644 env/Lib/site-packages/aiogram/types/document.py create mode 100644 env/Lib/site-packages/aiogram/types/downloadable.py create mode 100644 env/Lib/site-packages/aiogram/types/encrypted_credentials.py create mode 100644 env/Lib/site-packages/aiogram/types/encrypted_passport_element.py create mode 100644 env/Lib/site-packages/aiogram/types/error_event.py create mode 100644 env/Lib/site-packages/aiogram/types/external_reply_info.py create mode 100644 env/Lib/site-packages/aiogram/types/file.py create mode 100644 env/Lib/site-packages/aiogram/types/force_reply.py create mode 100644 env/Lib/site-packages/aiogram/types/forum_topic.py create mode 100644 env/Lib/site-packages/aiogram/types/forum_topic_closed.py create mode 100644 env/Lib/site-packages/aiogram/types/forum_topic_created.py create mode 100644 env/Lib/site-packages/aiogram/types/forum_topic_edited.py create mode 100644 env/Lib/site-packages/aiogram/types/forum_topic_reopened.py create mode 100644 env/Lib/site-packages/aiogram/types/game.py create mode 100644 env/Lib/site-packages/aiogram/types/game_high_score.py create mode 100644 env/Lib/site-packages/aiogram/types/general_forum_topic_hidden.py create mode 100644 env/Lib/site-packages/aiogram/types/general_forum_topic_unhidden.py create mode 100644 env/Lib/site-packages/aiogram/types/giveaway.py create mode 100644 env/Lib/site-packages/aiogram/types/giveaway_completed.py create mode 100644 env/Lib/site-packages/aiogram/types/giveaway_created.py create mode 100644 env/Lib/site-packages/aiogram/types/giveaway_winners.py create mode 100644 env/Lib/site-packages/aiogram/types/inaccessible_message.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_keyboard_button.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_keyboard_markup.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_article.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_audio.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_cached_audio.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_cached_document.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_cached_gif.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_cached_mpeg4_gif.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_cached_photo.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_cached_sticker.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_cached_video.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_cached_voice.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_contact.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_document.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_game.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_gif.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_location.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_mpeg4_gif.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_photo.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_venue.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_video.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_result_voice.py create mode 100644 env/Lib/site-packages/aiogram/types/inline_query_results_button.py create mode 100644 env/Lib/site-packages/aiogram/types/input_contact_message_content.py create mode 100644 env/Lib/site-packages/aiogram/types/input_file.py create mode 100644 env/Lib/site-packages/aiogram/types/input_invoice_message_content.py create mode 100644 env/Lib/site-packages/aiogram/types/input_location_message_content.py create mode 100644 env/Lib/site-packages/aiogram/types/input_media.py create mode 100644 env/Lib/site-packages/aiogram/types/input_media_animation.py create mode 100644 env/Lib/site-packages/aiogram/types/input_media_audio.py create mode 100644 env/Lib/site-packages/aiogram/types/input_media_document.py create mode 100644 env/Lib/site-packages/aiogram/types/input_media_photo.py create mode 100644 env/Lib/site-packages/aiogram/types/input_media_video.py create mode 100644 env/Lib/site-packages/aiogram/types/input_message_content.py create mode 100644 env/Lib/site-packages/aiogram/types/input_paid_media.py create mode 100644 env/Lib/site-packages/aiogram/types/input_paid_media_photo.py create mode 100644 env/Lib/site-packages/aiogram/types/input_paid_media_video.py create mode 100644 env/Lib/site-packages/aiogram/types/input_poll_option.py create mode 100644 env/Lib/site-packages/aiogram/types/input_sticker.py create mode 100644 env/Lib/site-packages/aiogram/types/input_text_message_content.py create mode 100644 env/Lib/site-packages/aiogram/types/input_venue_message_content.py create mode 100644 env/Lib/site-packages/aiogram/types/invoice.py create mode 100644 env/Lib/site-packages/aiogram/types/keyboard_button.py create mode 100644 env/Lib/site-packages/aiogram/types/keyboard_button_poll_type.py create mode 100644 env/Lib/site-packages/aiogram/types/keyboard_button_request_chat.py create mode 100644 env/Lib/site-packages/aiogram/types/keyboard_button_request_user.py create mode 100644 env/Lib/site-packages/aiogram/types/keyboard_button_request_users.py create mode 100644 env/Lib/site-packages/aiogram/types/labeled_price.py create mode 100644 env/Lib/site-packages/aiogram/types/link_preview_options.py create mode 100644 env/Lib/site-packages/aiogram/types/location.py create mode 100644 env/Lib/site-packages/aiogram/types/login_url.py create mode 100644 env/Lib/site-packages/aiogram/types/mask_position.py create mode 100644 env/Lib/site-packages/aiogram/types/maybe_inaccessible_message.py create mode 100644 env/Lib/site-packages/aiogram/types/menu_button.py create mode 100644 env/Lib/site-packages/aiogram/types/menu_button_commands.py create mode 100644 env/Lib/site-packages/aiogram/types/menu_button_default.py create mode 100644 env/Lib/site-packages/aiogram/types/menu_button_web_app.py create mode 100644 env/Lib/site-packages/aiogram/types/message.py create mode 100644 env/Lib/site-packages/aiogram/types/message_auto_delete_timer_changed.py create mode 100644 env/Lib/site-packages/aiogram/types/message_entity.py create mode 100644 env/Lib/site-packages/aiogram/types/message_id.py create mode 100644 env/Lib/site-packages/aiogram/types/message_origin.py create mode 100644 env/Lib/site-packages/aiogram/types/message_origin_channel.py create mode 100644 env/Lib/site-packages/aiogram/types/message_origin_chat.py create mode 100644 env/Lib/site-packages/aiogram/types/message_origin_hidden_user.py create mode 100644 env/Lib/site-packages/aiogram/types/message_origin_user.py create mode 100644 env/Lib/site-packages/aiogram/types/message_reaction_count_updated.py create mode 100644 env/Lib/site-packages/aiogram/types/message_reaction_updated.py create mode 100644 env/Lib/site-packages/aiogram/types/order_info.py create mode 100644 env/Lib/site-packages/aiogram/types/paid_media.py create mode 100644 env/Lib/site-packages/aiogram/types/paid_media_info.py create mode 100644 env/Lib/site-packages/aiogram/types/paid_media_photo.py create mode 100644 env/Lib/site-packages/aiogram/types/paid_media_preview.py create mode 100644 env/Lib/site-packages/aiogram/types/paid_media_video.py create mode 100644 env/Lib/site-packages/aiogram/types/passport_data.py create mode 100644 env/Lib/site-packages/aiogram/types/passport_element_error.py create mode 100644 env/Lib/site-packages/aiogram/types/passport_element_error_data_field.py create mode 100644 env/Lib/site-packages/aiogram/types/passport_element_error_file.py create mode 100644 env/Lib/site-packages/aiogram/types/passport_element_error_files.py create mode 100644 env/Lib/site-packages/aiogram/types/passport_element_error_front_side.py create mode 100644 env/Lib/site-packages/aiogram/types/passport_element_error_reverse_side.py create mode 100644 env/Lib/site-packages/aiogram/types/passport_element_error_selfie.py create mode 100644 env/Lib/site-packages/aiogram/types/passport_element_error_translation_file.py create mode 100644 env/Lib/site-packages/aiogram/types/passport_element_error_translation_files.py create mode 100644 env/Lib/site-packages/aiogram/types/passport_element_error_unspecified.py create mode 100644 env/Lib/site-packages/aiogram/types/passport_file.py create mode 100644 env/Lib/site-packages/aiogram/types/photo_size.py create mode 100644 env/Lib/site-packages/aiogram/types/poll.py create mode 100644 env/Lib/site-packages/aiogram/types/poll_answer.py create mode 100644 env/Lib/site-packages/aiogram/types/poll_option.py create mode 100644 env/Lib/site-packages/aiogram/types/pre_checkout_query.py create mode 100644 env/Lib/site-packages/aiogram/types/proximity_alert_triggered.py create mode 100644 env/Lib/site-packages/aiogram/types/reaction_count.py create mode 100644 env/Lib/site-packages/aiogram/types/reaction_type.py create mode 100644 env/Lib/site-packages/aiogram/types/reaction_type_custom_emoji.py create mode 100644 env/Lib/site-packages/aiogram/types/reaction_type_emoji.py create mode 100644 env/Lib/site-packages/aiogram/types/reaction_type_paid.py create mode 100644 env/Lib/site-packages/aiogram/types/refunded_payment.py create mode 100644 env/Lib/site-packages/aiogram/types/reply_keyboard_markup.py create mode 100644 env/Lib/site-packages/aiogram/types/reply_keyboard_remove.py create mode 100644 env/Lib/site-packages/aiogram/types/reply_parameters.py create mode 100644 env/Lib/site-packages/aiogram/types/response_parameters.py create mode 100644 env/Lib/site-packages/aiogram/types/revenue_withdrawal_state.py create mode 100644 env/Lib/site-packages/aiogram/types/revenue_withdrawal_state_failed.py create mode 100644 env/Lib/site-packages/aiogram/types/revenue_withdrawal_state_pending.py create mode 100644 env/Lib/site-packages/aiogram/types/revenue_withdrawal_state_succeeded.py create mode 100644 env/Lib/site-packages/aiogram/types/sent_web_app_message.py create mode 100644 env/Lib/site-packages/aiogram/types/shared_user.py create mode 100644 env/Lib/site-packages/aiogram/types/shipping_address.py create mode 100644 env/Lib/site-packages/aiogram/types/shipping_option.py create mode 100644 env/Lib/site-packages/aiogram/types/shipping_query.py create mode 100644 env/Lib/site-packages/aiogram/types/star_transaction.py create mode 100644 env/Lib/site-packages/aiogram/types/star_transactions.py create mode 100644 env/Lib/site-packages/aiogram/types/sticker.py create mode 100644 env/Lib/site-packages/aiogram/types/sticker_set.py create mode 100644 env/Lib/site-packages/aiogram/types/story.py create mode 100644 env/Lib/site-packages/aiogram/types/successful_payment.py create mode 100644 env/Lib/site-packages/aiogram/types/switch_inline_query_chosen_chat.py create mode 100644 env/Lib/site-packages/aiogram/types/text_quote.py create mode 100644 env/Lib/site-packages/aiogram/types/transaction_partner.py create mode 100644 env/Lib/site-packages/aiogram/types/transaction_partner_fragment.py create mode 100644 env/Lib/site-packages/aiogram/types/transaction_partner_other.py create mode 100644 env/Lib/site-packages/aiogram/types/transaction_partner_telegram_ads.py create mode 100644 env/Lib/site-packages/aiogram/types/transaction_partner_user.py create mode 100644 env/Lib/site-packages/aiogram/types/update.py create mode 100644 env/Lib/site-packages/aiogram/types/user.py create mode 100644 env/Lib/site-packages/aiogram/types/user_chat_boosts.py create mode 100644 env/Lib/site-packages/aiogram/types/user_profile_photos.py create mode 100644 env/Lib/site-packages/aiogram/types/user_shared.py create mode 100644 env/Lib/site-packages/aiogram/types/users_shared.py create mode 100644 env/Lib/site-packages/aiogram/types/venue.py create mode 100644 env/Lib/site-packages/aiogram/types/video.py create mode 100644 env/Lib/site-packages/aiogram/types/video_chat_ended.py create mode 100644 env/Lib/site-packages/aiogram/types/video_chat_participants_invited.py create mode 100644 env/Lib/site-packages/aiogram/types/video_chat_scheduled.py create mode 100644 env/Lib/site-packages/aiogram/types/video_chat_started.py create mode 100644 env/Lib/site-packages/aiogram/types/video_note.py create mode 100644 env/Lib/site-packages/aiogram/types/voice.py create mode 100644 env/Lib/site-packages/aiogram/types/web_app_data.py create mode 100644 env/Lib/site-packages/aiogram/types/web_app_info.py create mode 100644 env/Lib/site-packages/aiogram/types/webhook_info.py create mode 100644 env/Lib/site-packages/aiogram/types/write_access_allowed.py create mode 100644 env/Lib/site-packages/aiogram/utils/__init__.py create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/auth_widget.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/backoff.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/callback_answer.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/chat_action.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/chat_member.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/deep_linking.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/formatting.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/keyboard.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/link.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/magic_filter.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/markdown.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/media_group.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/mixins.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/mypy_hacks.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/payload.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/serialization.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/text_decorations.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/token.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/warnings.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/__pycache__/web_app.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/auth_widget.py create mode 100644 env/Lib/site-packages/aiogram/utils/backoff.py create mode 100644 env/Lib/site-packages/aiogram/utils/callback_answer.py create mode 100644 env/Lib/site-packages/aiogram/utils/chat_action.py create mode 100644 env/Lib/site-packages/aiogram/utils/chat_member.py create mode 100644 env/Lib/site-packages/aiogram/utils/deep_linking.py create mode 100644 env/Lib/site-packages/aiogram/utils/formatting.py create mode 100644 env/Lib/site-packages/aiogram/utils/i18n/__init__.py create mode 100644 env/Lib/site-packages/aiogram/utils/i18n/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/i18n/__pycache__/context.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/i18n/__pycache__/core.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/i18n/__pycache__/lazy_proxy.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/i18n/__pycache__/middleware.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/utils/i18n/context.py create mode 100644 env/Lib/site-packages/aiogram/utils/i18n/core.py create mode 100644 env/Lib/site-packages/aiogram/utils/i18n/lazy_proxy.py create mode 100644 env/Lib/site-packages/aiogram/utils/i18n/middleware.py create mode 100644 env/Lib/site-packages/aiogram/utils/keyboard.py create mode 100644 env/Lib/site-packages/aiogram/utils/link.py create mode 100644 env/Lib/site-packages/aiogram/utils/magic_filter.py create mode 100644 env/Lib/site-packages/aiogram/utils/markdown.py create mode 100644 env/Lib/site-packages/aiogram/utils/media_group.py create mode 100644 env/Lib/site-packages/aiogram/utils/mixins.py create mode 100644 env/Lib/site-packages/aiogram/utils/mypy_hacks.py create mode 100644 env/Lib/site-packages/aiogram/utils/payload.py create mode 100644 env/Lib/site-packages/aiogram/utils/serialization.py create mode 100644 env/Lib/site-packages/aiogram/utils/text_decorations.py create mode 100644 env/Lib/site-packages/aiogram/utils/token.py create mode 100644 env/Lib/site-packages/aiogram/utils/warnings.py create mode 100644 env/Lib/site-packages/aiogram/utils/web_app.py create mode 100644 env/Lib/site-packages/aiogram/webhook/__init__.py create mode 100644 env/Lib/site-packages/aiogram/webhook/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/webhook/__pycache__/aiohttp_server.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/webhook/__pycache__/security.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiogram/webhook/aiohttp_server.py create mode 100644 env/Lib/site-packages/aiogram/webhook/security.py create mode 100644 env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/LICENSE create mode 100644 env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/METADATA create mode 100644 env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/RECORD create mode 100644 env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/WHEEL create mode 100644 env/Lib/site-packages/aiohappyeyeballs/__init__.py create mode 100644 env/Lib/site-packages/aiohappyeyeballs/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohappyeyeballs/__pycache__/impl.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohappyeyeballs/__pycache__/types.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohappyeyeballs/__pycache__/utils.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohappyeyeballs/impl.py create mode 100644 env/Lib/site-packages/aiohappyeyeballs/py.typed create mode 100644 env/Lib/site-packages/aiohappyeyeballs/types.py create mode 100644 env/Lib/site-packages/aiohappyeyeballs/utils.py create mode 100644 env/Lib/site-packages/aiohttp-3.10.5.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/aiohttp-3.10.5.dist-info/LICENSE.txt create mode 100644 env/Lib/site-packages/aiohttp-3.10.5.dist-info/METADATA create mode 100644 env/Lib/site-packages/aiohttp-3.10.5.dist-info/RECORD create mode 100644 env/Lib/site-packages/aiohttp-3.10.5.dist-info/WHEEL create mode 100644 env/Lib/site-packages/aiohttp-3.10.5.dist-info/top_level.txt create mode 100644 env/Lib/site-packages/aiohttp/.hash/_cparser.pxd.hash create mode 100644 env/Lib/site-packages/aiohttp/.hash/_find_header.pxd.hash create mode 100644 env/Lib/site-packages/aiohttp/.hash/_helpers.pyi.hash create mode 100644 env/Lib/site-packages/aiohttp/.hash/_helpers.pyx.hash create mode 100644 env/Lib/site-packages/aiohttp/.hash/_http_parser.pyx.hash create mode 100644 env/Lib/site-packages/aiohttp/.hash/_http_writer.pyx.hash create mode 100644 env/Lib/site-packages/aiohttp/.hash/_websocket.pyx.hash create mode 100644 env/Lib/site-packages/aiohttp/.hash/hdrs.py.hash create mode 100644 env/Lib/site-packages/aiohttp/__init__.py create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/abc.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/base_protocol.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/client.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/client_exceptions.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/client_proto.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/client_reqrep.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/client_ws.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/compression_utils.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/connector.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/cookiejar.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/formdata.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/hdrs.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/helpers.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/http.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/http_exceptions.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/http_parser.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/http_websocket.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/http_writer.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/locks.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/log.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/multipart.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/payload.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/payload_streamer.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/pytest_plugin.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/resolver.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/streams.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/tcp_helpers.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/test_utils.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/tracing.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/typedefs.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/web.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/web_app.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/web_exceptions.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/web_fileresponse.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/web_log.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/web_middlewares.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/web_protocol.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/web_request.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/web_response.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/web_routedef.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/web_runner.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/web_server.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/web_urldispatcher.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/web_ws.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/__pycache__/worker.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiohttp/_cparser.pxd create mode 100644 env/Lib/site-packages/aiohttp/_find_header.pxd create mode 100644 env/Lib/site-packages/aiohttp/_headers.pxi create mode 100644 env/Lib/site-packages/aiohttp/_helpers.cp311-win_amd64.pyd create mode 100644 env/Lib/site-packages/aiohttp/_helpers.pyi create mode 100644 env/Lib/site-packages/aiohttp/_helpers.pyx create mode 100644 env/Lib/site-packages/aiohttp/_http_parser.cp311-win_amd64.pyd create mode 100644 env/Lib/site-packages/aiohttp/_http_parser.pyx create mode 100644 env/Lib/site-packages/aiohttp/_http_writer.cp311-win_amd64.pyd create mode 100644 env/Lib/site-packages/aiohttp/_http_writer.pyx create mode 100644 env/Lib/site-packages/aiohttp/_websocket.cp311-win_amd64.pyd create mode 100644 env/Lib/site-packages/aiohttp/_websocket.pyx create mode 100644 env/Lib/site-packages/aiohttp/abc.py create mode 100644 env/Lib/site-packages/aiohttp/base_protocol.py create mode 100644 env/Lib/site-packages/aiohttp/client.py create mode 100644 env/Lib/site-packages/aiohttp/client_exceptions.py create mode 100644 env/Lib/site-packages/aiohttp/client_proto.py create mode 100644 env/Lib/site-packages/aiohttp/client_reqrep.py create mode 100644 env/Lib/site-packages/aiohttp/client_ws.py create mode 100644 env/Lib/site-packages/aiohttp/compression_utils.py create mode 100644 env/Lib/site-packages/aiohttp/connector.py create mode 100644 env/Lib/site-packages/aiohttp/cookiejar.py create mode 100644 env/Lib/site-packages/aiohttp/formdata.py create mode 100644 env/Lib/site-packages/aiohttp/hdrs.py create mode 100644 env/Lib/site-packages/aiohttp/helpers.py create mode 100644 env/Lib/site-packages/aiohttp/http.py create mode 100644 env/Lib/site-packages/aiohttp/http_exceptions.py create mode 100644 env/Lib/site-packages/aiohttp/http_parser.py create mode 100644 env/Lib/site-packages/aiohttp/http_websocket.py create mode 100644 env/Lib/site-packages/aiohttp/http_writer.py create mode 100644 env/Lib/site-packages/aiohttp/locks.py create mode 100644 env/Lib/site-packages/aiohttp/log.py create mode 100644 env/Lib/site-packages/aiohttp/multipart.py create mode 100644 env/Lib/site-packages/aiohttp/payload.py create mode 100644 env/Lib/site-packages/aiohttp/payload_streamer.py create mode 100644 env/Lib/site-packages/aiohttp/py.typed create mode 100644 env/Lib/site-packages/aiohttp/pytest_plugin.py create mode 100644 env/Lib/site-packages/aiohttp/resolver.py create mode 100644 env/Lib/site-packages/aiohttp/streams.py create mode 100644 env/Lib/site-packages/aiohttp/tcp_helpers.py create mode 100644 env/Lib/site-packages/aiohttp/test_utils.py create mode 100644 env/Lib/site-packages/aiohttp/tracing.py create mode 100644 env/Lib/site-packages/aiohttp/typedefs.py create mode 100644 env/Lib/site-packages/aiohttp/web.py create mode 100644 env/Lib/site-packages/aiohttp/web_app.py create mode 100644 env/Lib/site-packages/aiohttp/web_exceptions.py create mode 100644 env/Lib/site-packages/aiohttp/web_fileresponse.py create mode 100644 env/Lib/site-packages/aiohttp/web_log.py create mode 100644 env/Lib/site-packages/aiohttp/web_middlewares.py create mode 100644 env/Lib/site-packages/aiohttp/web_protocol.py create mode 100644 env/Lib/site-packages/aiohttp/web_request.py create mode 100644 env/Lib/site-packages/aiohttp/web_response.py create mode 100644 env/Lib/site-packages/aiohttp/web_routedef.py create mode 100644 env/Lib/site-packages/aiohttp/web_runner.py create mode 100644 env/Lib/site-packages/aiohttp/web_server.py create mode 100644 env/Lib/site-packages/aiohttp/web_urldispatcher.py create mode 100644 env/Lib/site-packages/aiohttp/web_ws.py create mode 100644 env/Lib/site-packages/aiohttp/worker.py create mode 100644 env/Lib/site-packages/aiosignal-1.3.1.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/aiosignal-1.3.1.dist-info/LICENSE create mode 100644 env/Lib/site-packages/aiosignal-1.3.1.dist-info/METADATA create mode 100644 env/Lib/site-packages/aiosignal-1.3.1.dist-info/RECORD create mode 100644 env/Lib/site-packages/aiosignal-1.3.1.dist-info/WHEEL create mode 100644 env/Lib/site-packages/aiosignal-1.3.1.dist-info/top_level.txt create mode 100644 env/Lib/site-packages/aiosignal/__init__.py create mode 100644 env/Lib/site-packages/aiosignal/__init__.pyi create mode 100644 env/Lib/site-packages/aiosignal/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/aiosignal/py.typed create mode 100644 env/Lib/site-packages/annotated_types-0.7.0.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/annotated_types-0.7.0.dist-info/METADATA create mode 100644 env/Lib/site-packages/annotated_types-0.7.0.dist-info/RECORD create mode 100644 env/Lib/site-packages/annotated_types-0.7.0.dist-info/WHEEL create mode 100644 env/Lib/site-packages/annotated_types-0.7.0.dist-info/licenses/LICENSE create mode 100644 env/Lib/site-packages/annotated_types/__init__.py create mode 100644 env/Lib/site-packages/annotated_types/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/annotated_types/__pycache__/test_cases.cpython-311.pyc create mode 100644 env/Lib/site-packages/annotated_types/py.typed create mode 100644 env/Lib/site-packages/annotated_types/test_cases.py create mode 100644 env/Lib/site-packages/async_timeout-4.0.3.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/async_timeout-4.0.3.dist-info/LICENSE create mode 100644 env/Lib/site-packages/async_timeout-4.0.3.dist-info/METADATA create mode 100644 env/Lib/site-packages/async_timeout-4.0.3.dist-info/RECORD create mode 100644 env/Lib/site-packages/async_timeout-4.0.3.dist-info/WHEEL create mode 100644 env/Lib/site-packages/async_timeout-4.0.3.dist-info/top_level.txt create mode 100644 env/Lib/site-packages/async_timeout-4.0.3.dist-info/zip-safe create mode 100644 env/Lib/site-packages/async_timeout/__init__.py create mode 100644 env/Lib/site-packages/async_timeout/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/async_timeout/py.typed create mode 100644 env/Lib/site-packages/asyncpg-0.29.0.dist-info/AUTHORS create mode 100644 env/Lib/site-packages/asyncpg-0.29.0.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/asyncpg-0.29.0.dist-info/LICENSE create mode 100644 env/Lib/site-packages/asyncpg-0.29.0.dist-info/METADATA create mode 100644 env/Lib/site-packages/asyncpg-0.29.0.dist-info/RECORD create mode 100644 env/Lib/site-packages/asyncpg-0.29.0.dist-info/REQUESTED create mode 100644 env/Lib/site-packages/asyncpg-0.29.0.dist-info/WHEEL create mode 100644 env/Lib/site-packages/asyncpg-0.29.0.dist-info/top_level.txt create mode 100644 env/Lib/site-packages/asyncpg/__init__.py create mode 100644 env/Lib/site-packages/asyncpg/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/__pycache__/_asyncio_compat.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/__pycache__/_version.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/__pycache__/cluster.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/__pycache__/compat.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/__pycache__/connect_utils.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/__pycache__/connection.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/__pycache__/connresource.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/__pycache__/cursor.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/__pycache__/introspection.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/__pycache__/pool.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/__pycache__/prepared_stmt.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/__pycache__/serverversion.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/__pycache__/transaction.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/__pycache__/types.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/__pycache__/utils.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/_asyncio_compat.py create mode 100644 env/Lib/site-packages/asyncpg/_testbase/__init__.py create mode 100644 env/Lib/site-packages/asyncpg/_testbase/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/_testbase/__pycache__/fuzzer.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/_testbase/fuzzer.py create mode 100644 env/Lib/site-packages/asyncpg/_version.py create mode 100644 env/Lib/site-packages/asyncpg/cluster.py create mode 100644 env/Lib/site-packages/asyncpg/compat.py create mode 100644 env/Lib/site-packages/asyncpg/connect_utils.py create mode 100644 env/Lib/site-packages/asyncpg/connection.py create mode 100644 env/Lib/site-packages/asyncpg/connresource.py create mode 100644 env/Lib/site-packages/asyncpg/cursor.py create mode 100644 env/Lib/site-packages/asyncpg/exceptions/__init__.py create mode 100644 env/Lib/site-packages/asyncpg/exceptions/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/exceptions/__pycache__/_base.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/exceptions/_base.py create mode 100644 env/Lib/site-packages/asyncpg/introspection.py create mode 100644 env/Lib/site-packages/asyncpg/pgproto/__init__.pxd create mode 100644 env/Lib/site-packages/asyncpg/pgproto/__init__.py create mode 100644 env/Lib/site-packages/asyncpg/pgproto/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/pgproto/__pycache__/types.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/pgproto/buffer.pxd create mode 100644 env/Lib/site-packages/asyncpg/pgproto/buffer.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/__init__.pxd create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/bits.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/bytea.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/context.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/datetime.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/float.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/geometry.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/hstore.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/int.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/json.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/jsonpath.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/misc.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/network.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/numeric.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/pg_snapshot.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/text.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/tid.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/codecs/uuid.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/consts.pxi create mode 100644 env/Lib/site-packages/asyncpg/pgproto/cpythonx.pxd create mode 100644 env/Lib/site-packages/asyncpg/pgproto/debug.pxd create mode 100644 env/Lib/site-packages/asyncpg/pgproto/frb.pxd create mode 100644 env/Lib/site-packages/asyncpg/pgproto/frb.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/hton.pxd create mode 100644 env/Lib/site-packages/asyncpg/pgproto/pgproto.cp311-win_amd64.pyd create mode 100644 env/Lib/site-packages/asyncpg/pgproto/pgproto.pxd create mode 100644 env/Lib/site-packages/asyncpg/pgproto/pgproto.pyx create mode 100644 env/Lib/site-packages/asyncpg/pgproto/tohex.pxd create mode 100644 env/Lib/site-packages/asyncpg/pgproto/types.py create mode 100644 env/Lib/site-packages/asyncpg/pgproto/uuid.pyx create mode 100644 env/Lib/site-packages/asyncpg/pool.py create mode 100644 env/Lib/site-packages/asyncpg/prepared_stmt.py create mode 100644 env/Lib/site-packages/asyncpg/protocol/__init__.py create mode 100644 env/Lib/site-packages/asyncpg/protocol/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/protocol/codecs/__init__.py create mode 100644 env/Lib/site-packages/asyncpg/protocol/codecs/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/asyncpg/protocol/codecs/array.pyx create mode 100644 env/Lib/site-packages/asyncpg/protocol/codecs/base.pxd create mode 100644 env/Lib/site-packages/asyncpg/protocol/codecs/base.pyx create mode 100644 env/Lib/site-packages/asyncpg/protocol/codecs/pgproto.pyx create mode 100644 env/Lib/site-packages/asyncpg/protocol/codecs/range.pyx create mode 100644 env/Lib/site-packages/asyncpg/protocol/codecs/record.pyx create mode 100644 env/Lib/site-packages/asyncpg/protocol/codecs/textutils.pyx create mode 100644 env/Lib/site-packages/asyncpg/protocol/consts.pxi create mode 100644 env/Lib/site-packages/asyncpg/protocol/coreproto.pxd create mode 100644 env/Lib/site-packages/asyncpg/protocol/coreproto.pyx create mode 100644 env/Lib/site-packages/asyncpg/protocol/cpythonx.pxd create mode 100644 env/Lib/site-packages/asyncpg/protocol/encodings.pyx create mode 100644 env/Lib/site-packages/asyncpg/protocol/pgtypes.pxi create mode 100644 env/Lib/site-packages/asyncpg/protocol/prepared_stmt.pxd create mode 100644 env/Lib/site-packages/asyncpg/protocol/prepared_stmt.pyx create mode 100644 env/Lib/site-packages/asyncpg/protocol/protocol.cp311-win_amd64.pyd create mode 100644 env/Lib/site-packages/asyncpg/protocol/protocol.pxd create mode 100644 env/Lib/site-packages/asyncpg/protocol/protocol.pyx create mode 100644 env/Lib/site-packages/asyncpg/protocol/record/__init__.pxd create mode 100644 env/Lib/site-packages/asyncpg/protocol/scram.pxd create mode 100644 env/Lib/site-packages/asyncpg/protocol/scram.pyx create mode 100644 env/Lib/site-packages/asyncpg/protocol/settings.pxd create mode 100644 env/Lib/site-packages/asyncpg/protocol/settings.pyx create mode 100644 env/Lib/site-packages/asyncpg/serverversion.py create mode 100644 env/Lib/site-packages/asyncpg/transaction.py create mode 100644 env/Lib/site-packages/asyncpg/types.py create mode 100644 env/Lib/site-packages/asyncpg/utils.py create mode 100644 env/Lib/site-packages/attr/__init__.py create mode 100644 env/Lib/site-packages/attr/__init__.pyi create mode 100644 env/Lib/site-packages/attr/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/attr/__pycache__/_cmp.cpython-311.pyc create mode 100644 env/Lib/site-packages/attr/__pycache__/_compat.cpython-311.pyc create mode 100644 env/Lib/site-packages/attr/__pycache__/_config.cpython-311.pyc create mode 100644 env/Lib/site-packages/attr/__pycache__/_funcs.cpython-311.pyc create mode 100644 env/Lib/site-packages/attr/__pycache__/_make.cpython-311.pyc create mode 100644 env/Lib/site-packages/attr/__pycache__/_next_gen.cpython-311.pyc create mode 100644 env/Lib/site-packages/attr/__pycache__/_version_info.cpython-311.pyc create mode 100644 env/Lib/site-packages/attr/__pycache__/converters.cpython-311.pyc create mode 100644 env/Lib/site-packages/attr/__pycache__/exceptions.cpython-311.pyc create mode 100644 env/Lib/site-packages/attr/__pycache__/filters.cpython-311.pyc create mode 100644 env/Lib/site-packages/attr/__pycache__/setters.cpython-311.pyc create mode 100644 env/Lib/site-packages/attr/__pycache__/validators.cpython-311.pyc create mode 100644 env/Lib/site-packages/attr/_cmp.py create mode 100644 env/Lib/site-packages/attr/_cmp.pyi create mode 100644 env/Lib/site-packages/attr/_compat.py create mode 100644 env/Lib/site-packages/attr/_config.py create mode 100644 env/Lib/site-packages/attr/_funcs.py create mode 100644 env/Lib/site-packages/attr/_make.py create mode 100644 env/Lib/site-packages/attr/_next_gen.py create mode 100644 env/Lib/site-packages/attr/_typing_compat.pyi create mode 100644 env/Lib/site-packages/attr/_version_info.py create mode 100644 env/Lib/site-packages/attr/_version_info.pyi create mode 100644 env/Lib/site-packages/attr/converters.py create mode 100644 env/Lib/site-packages/attr/converters.pyi create mode 100644 env/Lib/site-packages/attr/exceptions.py create mode 100644 env/Lib/site-packages/attr/exceptions.pyi create mode 100644 env/Lib/site-packages/attr/filters.py create mode 100644 env/Lib/site-packages/attr/filters.pyi create mode 100644 env/Lib/site-packages/attr/py.typed create mode 100644 env/Lib/site-packages/attr/setters.py create mode 100644 env/Lib/site-packages/attr/setters.pyi create mode 100644 env/Lib/site-packages/attr/validators.py create mode 100644 env/Lib/site-packages/attr/validators.pyi create mode 100644 env/Lib/site-packages/attrs-24.2.0.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/attrs-24.2.0.dist-info/METADATA create mode 100644 env/Lib/site-packages/attrs-24.2.0.dist-info/RECORD create mode 100644 env/Lib/site-packages/attrs-24.2.0.dist-info/WHEEL create mode 100644 env/Lib/site-packages/attrs-24.2.0.dist-info/licenses/LICENSE create mode 100644 env/Lib/site-packages/attrs/__init__.py create mode 100644 env/Lib/site-packages/attrs/__init__.pyi create mode 100644 env/Lib/site-packages/attrs/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/attrs/__pycache__/converters.cpython-311.pyc create mode 100644 env/Lib/site-packages/attrs/__pycache__/exceptions.cpython-311.pyc create mode 100644 env/Lib/site-packages/attrs/__pycache__/filters.cpython-311.pyc create mode 100644 env/Lib/site-packages/attrs/__pycache__/setters.cpython-311.pyc create mode 100644 env/Lib/site-packages/attrs/__pycache__/validators.cpython-311.pyc create mode 100644 env/Lib/site-packages/attrs/converters.py create mode 100644 env/Lib/site-packages/attrs/exceptions.py create mode 100644 env/Lib/site-packages/attrs/filters.py create mode 100644 env/Lib/site-packages/attrs/py.typed create mode 100644 env/Lib/site-packages/attrs/setters.py create mode 100644 env/Lib/site-packages/attrs/validators.py create mode 100644 env/Lib/site-packages/frozenlist-1.4.1.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/frozenlist-1.4.1.dist-info/LICENSE create mode 100644 env/Lib/site-packages/frozenlist-1.4.1.dist-info/METADATA create mode 100644 env/Lib/site-packages/frozenlist-1.4.1.dist-info/RECORD create mode 100644 env/Lib/site-packages/frozenlist-1.4.1.dist-info/WHEEL create mode 100644 env/Lib/site-packages/frozenlist-1.4.1.dist-info/top_level.txt create mode 100644 env/Lib/site-packages/frozenlist/__init__.py create mode 100644 env/Lib/site-packages/frozenlist/__init__.pyi create mode 100644 env/Lib/site-packages/frozenlist/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/frozenlist/_frozenlist.cp311-win_amd64.pyd create mode 100644 env/Lib/site-packages/frozenlist/_frozenlist.pyx create mode 100644 env/Lib/site-packages/frozenlist/py.typed create mode 100644 env/Lib/site-packages/logging-0.4.9.6.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/logging-0.4.9.6.dist-info/LICENSE create mode 100644 env/Lib/site-packages/logging-0.4.9.6.dist-info/METADATA create mode 100644 env/Lib/site-packages/logging-0.4.9.6.dist-info/RECORD create mode 100644 env/Lib/site-packages/logging-0.4.9.6.dist-info/REQUESTED create mode 100644 env/Lib/site-packages/logging-0.4.9.6.dist-info/WHEEL create mode 100644 env/Lib/site-packages/logging-0.4.9.6.dist-info/top_level.txt create mode 100644 env/Lib/site-packages/logging/__init__.py create mode 100644 env/Lib/site-packages/logging/handlers.py create mode 100644 env/Lib/site-packages/magic_filter-1.0.12.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/magic_filter-1.0.12.dist-info/METADATA create mode 100644 env/Lib/site-packages/magic_filter-1.0.12.dist-info/RECORD create mode 100644 env/Lib/site-packages/magic_filter-1.0.12.dist-info/WHEEL create mode 100644 env/Lib/site-packages/magic_filter-1.0.12.dist-info/licenses/LICENSE create mode 100644 env/Lib/site-packages/magic_filter/__init__.py create mode 100644 env/Lib/site-packages/magic_filter/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/__pycache__/attrdict.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/__pycache__/exceptions.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/__pycache__/helper.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/__pycache__/magic.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/__pycache__/util.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/attrdict.py create mode 100644 env/Lib/site-packages/magic_filter/exceptions.py create mode 100644 env/Lib/site-packages/magic_filter/helper.py create mode 100644 env/Lib/site-packages/magic_filter/magic.py create mode 100644 env/Lib/site-packages/magic_filter/operations/__init__.py create mode 100644 env/Lib/site-packages/magic_filter/operations/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/operations/__pycache__/base.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/operations/__pycache__/call.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/operations/__pycache__/cast.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/operations/__pycache__/combination.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/operations/__pycache__/comparator.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/operations/__pycache__/extract.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/operations/__pycache__/function.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/operations/__pycache__/getattr.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/operations/__pycache__/getitem.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/operations/__pycache__/selector.cpython-311.pyc create mode 100644 env/Lib/site-packages/magic_filter/operations/base.py create mode 100644 env/Lib/site-packages/magic_filter/operations/call.py create mode 100644 env/Lib/site-packages/magic_filter/operations/cast.py create mode 100644 env/Lib/site-packages/magic_filter/operations/combination.py create mode 100644 env/Lib/site-packages/magic_filter/operations/comparator.py create mode 100644 env/Lib/site-packages/magic_filter/operations/extract.py create mode 100644 env/Lib/site-packages/magic_filter/operations/function.py create mode 100644 env/Lib/site-packages/magic_filter/operations/getattr.py create mode 100644 env/Lib/site-packages/magic_filter/operations/getitem.py create mode 100644 env/Lib/site-packages/magic_filter/operations/selector.py create mode 100644 env/Lib/site-packages/magic_filter/py.typed create mode 100644 env/Lib/site-packages/magic_filter/util.py create mode 100644 env/Lib/site-packages/multidict-6.0.5.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/multidict-6.0.5.dist-info/LICENSE create mode 100644 env/Lib/site-packages/multidict-6.0.5.dist-info/METADATA create mode 100644 env/Lib/site-packages/multidict-6.0.5.dist-info/RECORD create mode 100644 env/Lib/site-packages/multidict-6.0.5.dist-info/WHEEL create mode 100644 env/Lib/site-packages/multidict-6.0.5.dist-info/top_level.txt create mode 100644 env/Lib/site-packages/multidict/__init__.py create mode 100644 env/Lib/site-packages/multidict/__init__.pyi create mode 100644 env/Lib/site-packages/multidict/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/multidict/__pycache__/_abc.cpython-311.pyc create mode 100644 env/Lib/site-packages/multidict/__pycache__/_compat.cpython-311.pyc create mode 100644 env/Lib/site-packages/multidict/__pycache__/_multidict_base.cpython-311.pyc create mode 100644 env/Lib/site-packages/multidict/__pycache__/_multidict_py.cpython-311.pyc create mode 100644 env/Lib/site-packages/multidict/_abc.py create mode 100644 env/Lib/site-packages/multidict/_compat.py create mode 100644 env/Lib/site-packages/multidict/_multidict.cp311-win_amd64.pyd create mode 100644 env/Lib/site-packages/multidict/_multidict_base.py create mode 100644 env/Lib/site-packages/multidict/_multidict_py.py create mode 100644 env/Lib/site-packages/multidict/py.typed create mode 100644 env/Lib/site-packages/psycopg2-2.9.9.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/psycopg2-2.9.9.dist-info/LICENSE create mode 100644 env/Lib/site-packages/psycopg2-2.9.9.dist-info/METADATA create mode 100644 env/Lib/site-packages/psycopg2-2.9.9.dist-info/RECORD create mode 100644 env/Lib/site-packages/psycopg2-2.9.9.dist-info/REQUESTED create mode 100644 env/Lib/site-packages/psycopg2-2.9.9.dist-info/WHEEL create mode 100644 env/Lib/site-packages/psycopg2-2.9.9.dist-info/top_level.txt create mode 100644 env/Lib/site-packages/psycopg2/__init__.py create mode 100644 env/Lib/site-packages/psycopg2/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/psycopg2/__pycache__/_ipaddress.cpython-311.pyc create mode 100644 env/Lib/site-packages/psycopg2/__pycache__/_json.cpython-311.pyc create mode 100644 env/Lib/site-packages/psycopg2/__pycache__/_range.cpython-311.pyc create mode 100644 env/Lib/site-packages/psycopg2/__pycache__/errorcodes.cpython-311.pyc create mode 100644 env/Lib/site-packages/psycopg2/__pycache__/errors.cpython-311.pyc create mode 100644 env/Lib/site-packages/psycopg2/__pycache__/extensions.cpython-311.pyc create mode 100644 env/Lib/site-packages/psycopg2/__pycache__/extras.cpython-311.pyc create mode 100644 env/Lib/site-packages/psycopg2/__pycache__/pool.cpython-311.pyc create mode 100644 env/Lib/site-packages/psycopg2/__pycache__/sql.cpython-311.pyc create mode 100644 env/Lib/site-packages/psycopg2/__pycache__/tz.cpython-311.pyc create mode 100644 env/Lib/site-packages/psycopg2/_ipaddress.py create mode 100644 env/Lib/site-packages/psycopg2/_json.py create mode 100644 env/Lib/site-packages/psycopg2/_psycopg.cp311-win_amd64.pyd create mode 100644 env/Lib/site-packages/psycopg2/_range.py create mode 100644 env/Lib/site-packages/psycopg2/errorcodes.py create mode 100644 env/Lib/site-packages/psycopg2/errors.py create mode 100644 env/Lib/site-packages/psycopg2/extensions.py create mode 100644 env/Lib/site-packages/psycopg2/extras.py create mode 100644 env/Lib/site-packages/psycopg2/pool.py create mode 100644 env/Lib/site-packages/psycopg2/sql.py create mode 100644 env/Lib/site-packages/psycopg2/tz.py create mode 100644 env/Lib/site-packages/pydantic-2.8.2.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/pydantic-2.8.2.dist-info/METADATA create mode 100644 env/Lib/site-packages/pydantic-2.8.2.dist-info/RECORD create mode 100644 env/Lib/site-packages/pydantic-2.8.2.dist-info/WHEEL create mode 100644 env/Lib/site-packages/pydantic-2.8.2.dist-info/licenses/LICENSE create mode 100644 env/Lib/site-packages/pydantic/__init__.py create mode 100644 env/Lib/site-packages/pydantic/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/_migration.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/alias_generators.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/aliases.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/annotated_handlers.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/class_validators.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/color.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/config.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/dataclasses.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/datetime_parse.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/decorator.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/env_settings.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/error_wrappers.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/errors.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/fields.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/functional_serializers.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/functional_validators.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/generics.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/json.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/json_schema.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/main.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/mypy.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/networks.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/parse.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/root_model.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/schema.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/tools.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/type_adapter.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/types.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/typing.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/utils.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/validate_call_decorator.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/validators.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/version.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/__pycache__/warnings.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__init__.py create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_config.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_core_metadata.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_core_utils.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_dataclasses.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_decorators.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_decorators_v1.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_discriminated_union.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_docs_extraction.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_fields.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_forward_ref.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_generate_schema.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_generics.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_git.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_internal_dataclass.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_known_annotated_metadata.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_mock_val_ser.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_model_construction.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_repr.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_schema_generation_shared.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_signature.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_std_types_schema.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_typing_extra.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_utils.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_validate_call.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/__pycache__/_validators.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/_internal/_config.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_core_metadata.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_core_utils.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_dataclasses.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_decorators.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_decorators_v1.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_discriminated_union.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_docs_extraction.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_fields.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_forward_ref.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_generate_schema.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_generics.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_git.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_internal_dataclass.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_known_annotated_metadata.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_mock_val_ser.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_model_construction.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_repr.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_schema_generation_shared.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_signature.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_std_types_schema.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_typing_extra.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_utils.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_validate_call.py create mode 100644 env/Lib/site-packages/pydantic/_internal/_validators.py create mode 100644 env/Lib/site-packages/pydantic/_migration.py create mode 100644 env/Lib/site-packages/pydantic/alias_generators.py create mode 100644 env/Lib/site-packages/pydantic/aliases.py create mode 100644 env/Lib/site-packages/pydantic/annotated_handlers.py create mode 100644 env/Lib/site-packages/pydantic/class_validators.py create mode 100644 env/Lib/site-packages/pydantic/color.py create mode 100644 env/Lib/site-packages/pydantic/dataclasses.py create mode 100644 env/Lib/site-packages/pydantic/datetime_parse.py create mode 100644 env/Lib/site-packages/pydantic/decorator.py create mode 100644 env/Lib/site-packages/pydantic/deprecated/__init__.py create mode 100644 env/Lib/site-packages/pydantic/deprecated/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/deprecated/__pycache__/class_validators.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/deprecated/__pycache__/config.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/deprecated/__pycache__/copy_internals.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/deprecated/__pycache__/decorator.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/deprecated/__pycache__/json.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/deprecated/__pycache__/parse.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/deprecated/__pycache__/tools.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/deprecated/class_validators.py create mode 100644 env/Lib/site-packages/pydantic/deprecated/copy_internals.py create mode 100644 env/Lib/site-packages/pydantic/deprecated/decorator.py create mode 100644 env/Lib/site-packages/pydantic/deprecated/json.py create mode 100644 env/Lib/site-packages/pydantic/deprecated/parse.py create mode 100644 env/Lib/site-packages/pydantic/deprecated/tools.py create mode 100644 env/Lib/site-packages/pydantic/env_settings.py create mode 100644 env/Lib/site-packages/pydantic/error_wrappers.py create mode 100644 env/Lib/site-packages/pydantic/errors.py create mode 100644 env/Lib/site-packages/pydantic/experimental/__init__.py create mode 100644 env/Lib/site-packages/pydantic/experimental/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/experimental/__pycache__/pipeline.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/experimental/pipeline.py create mode 100644 env/Lib/site-packages/pydantic/fields.py create mode 100644 env/Lib/site-packages/pydantic/functional_serializers.py create mode 100644 env/Lib/site-packages/pydantic/functional_validators.py create mode 100644 env/Lib/site-packages/pydantic/generics.py create mode 100644 env/Lib/site-packages/pydantic/json.py create mode 100644 env/Lib/site-packages/pydantic/json_schema.py create mode 100644 env/Lib/site-packages/pydantic/main.py create mode 100644 env/Lib/site-packages/pydantic/mypy.py create mode 100644 env/Lib/site-packages/pydantic/networks.py create mode 100644 env/Lib/site-packages/pydantic/parse.py create mode 100644 env/Lib/site-packages/pydantic/plugin/__init__.py create mode 100644 env/Lib/site-packages/pydantic/plugin/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/plugin/__pycache__/_loader.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/plugin/__pycache__/_schema_validator.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/plugin/_loader.py create mode 100644 env/Lib/site-packages/pydantic/plugin/_schema_validator.py create mode 100644 env/Lib/site-packages/pydantic/py.typed create mode 100644 env/Lib/site-packages/pydantic/root_model.py create mode 100644 env/Lib/site-packages/pydantic/schema.py create mode 100644 env/Lib/site-packages/pydantic/tools.py create mode 100644 env/Lib/site-packages/pydantic/type_adapter.py create mode 100644 env/Lib/site-packages/pydantic/types.py create mode 100644 env/Lib/site-packages/pydantic/typing.py create mode 100644 env/Lib/site-packages/pydantic/utils.py create mode 100644 env/Lib/site-packages/pydantic/v1/__init__.py create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/_hypothesis_plugin.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/annotated_types.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/class_validators.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/color.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/config.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/dataclasses.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/datetime_parse.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/decorator.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/env_settings.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/error_wrappers.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/errors.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/fields.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/generics.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/json.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/main.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/mypy.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/networks.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/parse.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/schema.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/tools.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/types.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/typing.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/utils.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/validators.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/__pycache__/version.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic/v1/_hypothesis_plugin.py create mode 100644 env/Lib/site-packages/pydantic/v1/annotated_types.py create mode 100644 env/Lib/site-packages/pydantic/v1/class_validators.py create mode 100644 env/Lib/site-packages/pydantic/v1/color.py create mode 100644 env/Lib/site-packages/pydantic/v1/dataclasses.py create mode 100644 env/Lib/site-packages/pydantic/v1/datetime_parse.py create mode 100644 env/Lib/site-packages/pydantic/v1/decorator.py create mode 100644 env/Lib/site-packages/pydantic/v1/env_settings.py create mode 100644 env/Lib/site-packages/pydantic/v1/error_wrappers.py create mode 100644 env/Lib/site-packages/pydantic/v1/errors.py create mode 100644 env/Lib/site-packages/pydantic/v1/fields.py create mode 100644 env/Lib/site-packages/pydantic/v1/generics.py create mode 100644 env/Lib/site-packages/pydantic/v1/json.py create mode 100644 env/Lib/site-packages/pydantic/v1/main.py create mode 100644 env/Lib/site-packages/pydantic/v1/mypy.py create mode 100644 env/Lib/site-packages/pydantic/v1/networks.py create mode 100644 env/Lib/site-packages/pydantic/v1/parse.py create mode 100644 env/Lib/site-packages/pydantic/v1/py.typed create mode 100644 env/Lib/site-packages/pydantic/v1/schema.py create mode 100644 env/Lib/site-packages/pydantic/v1/tools.py create mode 100644 env/Lib/site-packages/pydantic/v1/types.py create mode 100644 env/Lib/site-packages/pydantic/v1/typing.py create mode 100644 env/Lib/site-packages/pydantic/v1/utils.py create mode 100644 env/Lib/site-packages/pydantic/v1/validators.py create mode 100644 env/Lib/site-packages/pydantic/v1/version.py create mode 100644 env/Lib/site-packages/pydantic/validate_call_decorator.py create mode 100644 env/Lib/site-packages/pydantic/validators.py create mode 100644 env/Lib/site-packages/pydantic/version.py create mode 100644 env/Lib/site-packages/pydantic/warnings.py create mode 100644 env/Lib/site-packages/pydantic_core-2.20.1.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/pydantic_core-2.20.1.dist-info/METADATA create mode 100644 env/Lib/site-packages/pydantic_core-2.20.1.dist-info/RECORD create mode 100644 env/Lib/site-packages/pydantic_core-2.20.1.dist-info/WHEEL create mode 100644 env/Lib/site-packages/pydantic_core-2.20.1.dist-info/license_files/LICENSE create mode 100644 env/Lib/site-packages/pydantic_core/__init__.py create mode 100644 env/Lib/site-packages/pydantic_core/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic_core/__pycache__/core_schema.cpython-311.pyc create mode 100644 env/Lib/site-packages/pydantic_core/_pydantic_core.cp311-win_amd64.pyd create mode 100644 env/Lib/site-packages/pydantic_core/_pydantic_core.pyi create mode 100644 env/Lib/site-packages/pydantic_core/core_schema.py create mode 100644 env/Lib/site-packages/pydantic_core/py.typed create mode 100644 env/Lib/site-packages/typing_extensions-4.12.2.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/typing_extensions-4.12.2.dist-info/LICENSE create mode 100644 env/Lib/site-packages/typing_extensions-4.12.2.dist-info/METADATA create mode 100644 env/Lib/site-packages/typing_extensions-4.12.2.dist-info/RECORD create mode 100644 env/Lib/site-packages/typing_extensions-4.12.2.dist-info/WHEEL create mode 100644 env/Lib/site-packages/typing_extensions.py create mode 100644 env/Lib/site-packages/yarl-1.9.4.dist-info/INSTALLER create mode 100644 env/Lib/site-packages/yarl-1.9.4.dist-info/LICENSE create mode 100644 env/Lib/site-packages/yarl-1.9.4.dist-info/METADATA create mode 100644 env/Lib/site-packages/yarl-1.9.4.dist-info/NOTICE create mode 100644 env/Lib/site-packages/yarl-1.9.4.dist-info/RECORD create mode 100644 env/Lib/site-packages/yarl-1.9.4.dist-info/WHEEL create mode 100644 env/Lib/site-packages/yarl-1.9.4.dist-info/top_level.txt create mode 100644 env/Lib/site-packages/yarl/__init__.py create mode 100644 env/Lib/site-packages/yarl/__init__.pyi create mode 100644 env/Lib/site-packages/yarl/__pycache__/__init__.cpython-311.pyc create mode 100644 env/Lib/site-packages/yarl/__pycache__/_quoting.cpython-311.pyc create mode 100644 env/Lib/site-packages/yarl/__pycache__/_quoting_py.cpython-311.pyc create mode 100644 env/Lib/site-packages/yarl/__pycache__/_url.cpython-311.pyc create mode 100644 env/Lib/site-packages/yarl/_quoting.py create mode 100644 env/Lib/site-packages/yarl/_quoting_c.cp311-win_amd64.pyd create mode 100644 env/Lib/site-packages/yarl/_quoting_c.pyi create mode 100644 env/Lib/site-packages/yarl/_quoting_c.pyx create mode 100644 env/Lib/site-packages/yarl/_quoting_py.py create mode 100644 env/Lib/site-packages/yarl/_url.py create mode 100644 env/Lib/site-packages/yarl/py.typed create mode 100644 project/__pycache__/config.cpython-311.pyc create mode 100644 project/__pycache__/db.cpython-311.pyc create mode 100644 project/bot.py diff --git a/.gitignore b/.gitignore index f85c6b1..ed683d3 100644 --- a/.gitignore +++ b/.gitignore @@ -1 +1,4 @@ -config.py \ No newline at end of file +config.py +project/config.py +project/bot.log + diff --git a/bot.log b/bot.log new file mode 100644 index 0000000..59023d6 --- /dev/null +++ b/bot.log @@ -0,0 +1,2 @@ +2024-08-26 16:15:10 - INFO - /start 451218808 +2024-08-26 16:15:10 - INFO - 451218808 diff --git a/bot.py b/bot.py deleted file mode 100644 index 6bccbce..0000000 --- a/bot.py +++ /dev/null @@ -1,114 +0,0 @@ -import telebot -from telebot import types - -# Укажите свой токен бота -API_TOKEN = '7092073070:AAGFOnZHUR86RdAjb7pgSN7plOiQe1_4Qow' -bot = telebot.TeleBot(API_TOKEN) - -# Словари для хранения данных пользователей -users = {} - -# Enum для ролей -class Role: - CURATOR = "Куратор" - FRESHMAN = "Первокурсник" - -# Стартовая команда -@bot.message_handler(commands=['start']) -def start(message): - markup = types.ReplyKeyboardMarkup(resize_keyboard=True) - item1 = types.KeyboardButton("Куратор") - item2 = types.KeyboardButton("Первокурсник") - markup.add(item1, item2) - - bot.send_message(message.chat.id, "Привет! Выберите, кем вы являетесь:", reply_markup=markup) - bot.register_next_step_handler(message, handle_role_selection) - -# Обработка выбора роли -def handle_role_selection(message): - if message.text == "Куратор": - role = Role.CURATOR - elif message.text == "Первокурсник": - role = Role.FRESHMAN - else: - bot.send_message(message.chat.id, "Некорректный выбор. Пожалуйста, выберите 'Куратор' или 'Первокурсник'.") - return - - # Сохраняем данные пользователя - user_id = message.from_user.id - users[user_id] = { - "role": role, - "name": "", - "group": "" - } - - bot.send_message(message.chat.id, "Введите ваше ФИО:") - bot.register_next_step_handler(message, enter_name) - -# Ввод ФИО -def enter_name(message): - user_id = message.from_user.id - users[user_id]["name"] = message.text - - bot.send_message(message.chat.id, "Введите вашу группу:") - bot.register_next_step_handler(message, enter_group) - -# Ввод группы -def enter_group(message): - user_id = message.from_user.id - users[user_id]["group"] = message.text - - role = users[user_id]["role"] - - markup = types.ReplyKeyboardMarkup(resize_keyboard=True) - if role == Role.CURATOR: - item1 = types.KeyboardButton("Отчитаться за мероприятие") - item2 = types.KeyboardButton("Добавить мероприятие") - markup.add(item1, item2) - bot.send_message(message.chat.id, "Вы куратор. Вы можете выбрать действие:", reply_markup=markup) - elif role == Role.FRESHMAN: - item1 = types.KeyboardButton("Задать вопрос куратору") - item2 = types.KeyboardButton("Поблагодарить куратора") - markup.add(item1, item2) - bot.send_message(message.chat.id, "Вы первокурсник. Вы можете выбрать действие:", reply_markup=markup) - -# Обработка инструкций для кураторов - -@bot.message_handler(func=lambda message: users.get(message.from_user.id, {}).get('role') == Role.CURATOR) -def handle_curator_actions(message): - if message.text == 'Отчитаться за мероприятие': - bot.send_message(message.chat.id, "Пожалуйста, пришлите фото мероприятия:") - bot.register_next_step_handler(message, upload_activity_photo) - elif message.text == 'Добавить мероприятие': - bot.send_message(message.chat.id, "Пожалуйста, опишите мероприятие:") - bot.register_next_step_handler(message, add_activity) - -def upload_activity_photo(message): - user_id = message.from_user.id - bot.send_message(message.chat.id, "Спасибо! Фото получено.") - -def add_activity(message): - description = message.text - bot.send_message(message.chat.id, f"Мероприятие добавлено: {description}") - -# Обработка инструкций для первокурсников -@bot.message_handler(func=lambda message: users.get(message.from_user.id, {}).get('role') == Role.FRESHMAN) -def handle_freshman_actions(message): - if message.text == 'Задать вопрос куратору': - bot.send_message(message.chat.id, "Пожалуйста, напишите свой вопрос:") - bot.register_next_step_handler(message, submit_question) - elif message.text == 'Поблагодарить куратора': - bot.send_message(message.chat.id, "Пожалуйста, пришлите фото с вашим куратором:") - bot.register_next_step_handler(message, upload_thank_you_photo) - -def submit_question(message): - question = message.text - bot.send_message(message.chat.id, f"Ваш вопрос отправлен: {question}") - -def upload_thank_you_photo(message): - user_id = message.from_user.id - bot.send_message(message.chat.id, "Спасибо! Фото получено.") - -# Запуск бота -if __name__ == '__main__': - bot.polling(none_stop=True) \ No newline at end of file diff --git a/env/Lib/site-packages/__pycache__/typing_extensions.cpython-311.pyc b/env/Lib/site-packages/__pycache__/typing_extensions.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0f399d7f7d75d34e51e844cab7b90bdc9ca96135 GIT binary patch literal 151464 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�}_Ryz_ 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 +License: Apache-2.0 +License-File: LICENSE +License-File: NOTICE +Classifier: Development Status :: 5 - Production/Stable +Classifier: Framework :: AsyncIO +Classifier: License :: OSI Approved :: Apache Software License +Classifier: Operating System :: OS Independent +Classifier: Programming Language :: Python :: 3.7 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy +Requires-Python: >=3.7 +Description-Content-Type: text/markdown + +# aiofiles: file support for asyncio + +[![PyPI](https://img.shields.io/pypi/v/aiofiles.svg)](https://pypi.python.org/pypi/aiofiles) +[![Build](https://github.com/Tinche/aiofiles/workflows/CI/badge.svg)](https://github.com/Tinche/aiofiles/actions) +[![Coverage](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/Tinche/882f02e3df32136c847ba90d2688f06e/raw/covbadge.json)](https://github.com/Tinche/aiofiles/actions/workflows/main.yml) +[![Supported Python versions](https://img.shields.io/pypi/pyversions/aiofiles.svg)](https://github.com/Tinche/aiofiles) +[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) + +**aiofiles** is an Apache2 licensed library, written in Python, for handling local +disk files in asyncio applications. + +Ordinary local file IO is blocking, and cannot easily and portably be made +asynchronous. This means doing file IO may interfere with asyncio applications, +which shouldn't block the executing thread. aiofiles helps with this by +introducing asynchronous versions of files that support delegating operations to +a separate thread pool. + +```python +async with aiofiles.open('filename', mode='r') as f: + contents = await f.read() +print(contents) +'My file contents' +``` + +Asynchronous iteration is also supported. + +```python +async with aiofiles.open('filename') as f: + async for line in f: + ... +``` + +Asynchronous interface to tempfile module. + +```python +async with aiofiles.tempfile.TemporaryFile('wb') as f: + await f.write(b'Hello, World!') +``` + +## Features + +- a file API very similar to Python's standard, blocking API +- support for buffered and unbuffered binary files, and buffered text files +- support for `async`/`await` ([PEP 492](https://peps.python.org/pep-0492/)) constructs +- async interface to tempfile module + +## Installation + +To install aiofiles, simply: + +```bash +$ pip install aiofiles +``` + +## Usage + +Files are opened using the `aiofiles.open()` coroutine, which in addition to +mirroring the builtin `open` accepts optional `loop` and `executor` +arguments. If `loop` is absent, the default loop will be used, as per the +set asyncio policy. If `executor` is not specified, the default event loop +executor will be used. + +In case of success, an asynchronous file object is returned with an +API identical to an ordinary file, except the following methods are coroutines +and delegate to an executor: + +- `close` +- `flush` +- `isatty` +- `read` +- `readall` +- `read1` +- `readinto` +- `readline` +- `readlines` +- `seek` +- `seekable` +- `tell` +- `truncate` +- `writable` +- `write` +- `writelines` + +In case of failure, one of the usual exceptions will be raised. + +`aiofiles.stdin`, `aiofiles.stdout`, `aiofiles.stderr`, +`aiofiles.stdin_bytes`, `aiofiles.stdout_bytes`, and +`aiofiles.stderr_bytes` provide async access to `sys.stdin`, +`sys.stdout`, `sys.stderr`, and their corresponding `.buffer` properties. + +The `aiofiles.os` module contains executor-enabled coroutine versions of +several useful `os` functions that deal with files: + +- `stat` +- `statvfs` +- `sendfile` +- `rename` +- `renames` +- `replace` +- `remove` +- `unlink` +- `mkdir` +- `makedirs` +- `rmdir` +- `removedirs` +- `link` +- `symlink` +- `readlink` +- `listdir` +- `scandir` +- `access` +- `path.exists` +- `path.isfile` +- `path.isdir` +- `path.islink` +- `path.ismount` +- `path.getsize` +- `path.getatime` +- `path.getctime` +- `path.samefile` +- `path.sameopenfile` + +### Tempfile + +**aiofiles.tempfile** implements the following interfaces: + +- TemporaryFile +- NamedTemporaryFile +- SpooledTemporaryFile +- TemporaryDirectory + +Results return wrapped with a context manager allowing use with async with and async for. + +```python +async with aiofiles.tempfile.NamedTemporaryFile('wb+') as f: + await f.write(b'Line1\n Line2') + await f.seek(0) + async for line in f: + print(line) + +async with aiofiles.tempfile.TemporaryDirectory() as d: + filename = os.path.join(d, "file.ext") +``` + +### Writing tests for aiofiles + +Real file IO can be mocked by patching `aiofiles.threadpool.sync_open` +as desired. The return type also needs to be registered with the +`aiofiles.threadpool.wrap` dispatcher: + +```python +aiofiles.threadpool.wrap.register(mock.MagicMock)( + lambda *args, **kwargs: threadpool.AsyncBufferedIOBase(*args, **kwargs)) + +async def test_stuff(): + data = 'data' + mock_file = mock.MagicMock() + + with mock.patch('aiofiles.threadpool.sync_open', return_value=mock_file) as mock_open: + async with aiofiles.open('filename', 'w') as f: + await f.write(data) + + mock_file.write.assert_called_once_with(data) +``` + +### History + +#### 23.2.1 (2023-08-09) + +- Import `os.statvfs` conditionally to fix importing on non-UNIX systems. + [#171](https://github.com/Tinche/aiofiles/issues/171) [#172](https://github.com/Tinche/aiofiles/pull/172) + +#### 23.2.0 (2023-08-09) + +- aiofiles is now tested on Python 3.12 too. + [#166](https://github.com/Tinche/aiofiles/issues/166) [#168](https://github.com/Tinche/aiofiles/pull/168) +- On Python 3.12, `aiofiles.tempfile.NamedTemporaryFile` now accepts a `delete_on_close` argument, just like the stdlib version. +- On Python 3.12, `aiofiles.tempfile.NamedTemporaryFile` no longer exposes a `delete` attribute, just like the stdlib version. +- Added `aiofiles.os.statvfs` and `aiofiles.os.path.ismount`. + [#162](https://github.com/Tinche/aiofiles/pull/162) +- Use [PDM](https://pdm.fming.dev/latest/) instead of Poetry. + [#169](https://github.com/Tinche/aiofiles/pull/169) + +#### 23.1.0 (2023-02-09) + +- Added `aiofiles.os.access`. + [#146](https://github.com/Tinche/aiofiles/pull/146) +- Removed `aiofiles.tempfile.temptypes.AsyncSpooledTemporaryFile.softspace`. + [#151](https://github.com/Tinche/aiofiles/pull/151) +- Added `aiofiles.stdin`, `aiofiles.stdin_bytes`, and other stdio streams. + [#154](https://github.com/Tinche/aiofiles/pull/154) +- Transition to `asyncio.get_running_loop` (vs `asyncio.get_event_loop`) internally. + +#### 22.1.0 (2022-09-04) + +- Added `aiofiles.os.path.islink`. + [#126](https://github.com/Tinche/aiofiles/pull/126) +- Added `aiofiles.os.readlink`. + [#125](https://github.com/Tinche/aiofiles/pull/125) +- Added `aiofiles.os.symlink`. + [#124](https://github.com/Tinche/aiofiles/pull/124) +- Added `aiofiles.os.unlink`. + [#123](https://github.com/Tinche/aiofiles/pull/123) +- Added `aiofiles.os.link`. + [#121](https://github.com/Tinche/aiofiles/pull/121) +- Added `aiofiles.os.renames`. + [#120](https://github.com/Tinche/aiofiles/pull/120) +- Added `aiofiles.os.{listdir, scandir}`. + [#143](https://github.com/Tinche/aiofiles/pull/143) +- Switched to CalVer. +- Dropped Python 3.6 support. If you require it, use version 0.8.0. +- aiofiles is now tested on Python 3.11. + +#### 0.8.0 (2021-11-27) + +- aiofiles is now tested on Python 3.10. +- Added `aiofiles.os.replace`. + [#107](https://github.com/Tinche/aiofiles/pull/107) +- Added `aiofiles.os.{makedirs, removedirs}`. +- Added `aiofiles.os.path.{exists, isfile, isdir, getsize, getatime, getctime, samefile, sameopenfile}`. + [#63](https://github.com/Tinche/aiofiles/pull/63) +- Added `suffix`, `prefix`, `dir` args to `aiofiles.tempfile.TemporaryDirectory`. + [#116](https://github.com/Tinche/aiofiles/pull/116) + +#### 0.7.0 (2021-05-17) + +- Added the `aiofiles.tempfile` module for async temporary files. + [#56](https://github.com/Tinche/aiofiles/pull/56) +- Switched to Poetry and GitHub actions. +- Dropped 3.5 support. + +#### 0.6.0 (2020-10-27) + +- `aiofiles` is now tested on ppc64le. +- Added `name` and `mode` properties to async file objects. + [#82](https://github.com/Tinche/aiofiles/pull/82) +- Fixed a DeprecationWarning internally. + [#75](https://github.com/Tinche/aiofiles/pull/75) +- Python 3.9 support and tests. + +#### 0.5.0 (2020-04-12) + +- Python 3.8 support. Code base modernization (using `async/await` instead of `asyncio.coroutine`/`yield from`). +- Added `aiofiles.os.remove`, `aiofiles.os.rename`, `aiofiles.os.mkdir`, `aiofiles.os.rmdir`. + [#62](https://github.com/Tinche/aiofiles/pull/62) + +#### 0.4.0 (2018-08-11) + +- Python 3.7 support. +- Removed Python 3.3/3.4 support. If you use these versions, stick to aiofiles 0.3.x. + +#### 0.3.2 (2017-09-23) + +- The LICENSE is now included in the sdist. + [#31](https://github.com/Tinche/aiofiles/pull/31) + +#### 0.3.1 (2017-03-10) + +- Introduced a changelog. +- `aiofiles.os.sendfile` will now work if the standard `os` module contains a `sendfile` function. + +### Contributing + +Contributions are very welcome. Tests can be run with `tox`, please ensure +the coverage at least stays the same before you submit a pull request. diff --git a/env/Lib/site-packages/aiofiles-23.2.1.dist-info/RECORD b/env/Lib/site-packages/aiofiles-23.2.1.dist-info/RECORD new file mode 100644 index 0000000..9e403d8 --- /dev/null +++ b/env/Lib/site-packages/aiofiles-23.2.1.dist-info/RECORD @@ -0,0 +1,26 @@ +aiofiles-23.2.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +aiofiles-23.2.1.dist-info/METADATA,sha256=cot28p_PNjdl_MK--l9Qu2e6QOv9OxdHrKbjLmYf9Uw,9673 +aiofiles-23.2.1.dist-info/RECORD,, +aiofiles-23.2.1.dist-info/WHEEL,sha256=KGYbc1zXlYddvwxnNty23BeaKzh7YuoSIvIMO4jEhvw,87 +aiofiles-23.2.1.dist-info/licenses/LICENSE,sha256=y16Ofl9KOYjhBjwULGDcLfdWBfTEZRXnduOspt-XbhQ,11325 +aiofiles-23.2.1.dist-info/licenses/NOTICE,sha256=EExY0dRQvWR0wJ2LZLwBgnM6YKw9jCU-M0zegpRSD_E,55 +aiofiles/__init__.py,sha256=1iAMJQyJtX3LGIS0AoFTJeO1aJ_RK2jpBSBhg0VoIrE,344 +aiofiles/__pycache__/__init__.cpython-311.pyc,, +aiofiles/__pycache__/base.cpython-311.pyc,, +aiofiles/__pycache__/os.cpython-311.pyc,, +aiofiles/__pycache__/ospath.cpython-311.pyc,, +aiofiles/base.py,sha256=rZwA151Ji8XlBkzvDmcF1CgDTY2iKNuJMfvNlM0s0E0,2684 +aiofiles/os.py,sha256=zuFGaIyGCGUuFb7trFFEm6SLdCRqTFsSV0mY6SO8z3M,970 +aiofiles/ospath.py,sha256=zqG2VFzRb6yYiIOWipqsdgvZmoMTFvZmBdkxkAl1FT4,764 +aiofiles/tempfile/__init__.py,sha256=hFSNTOjOUv371Ozdfy6FIxeln46Nm3xOVh4ZR3Q94V0,10244 +aiofiles/tempfile/__pycache__/__init__.cpython-311.pyc,, +aiofiles/tempfile/__pycache__/temptypes.cpython-311.pyc,, +aiofiles/tempfile/temptypes.py,sha256=ddEvNjMLVlr7WUILCe6ypTqw77yREeIonTk16Uw_NVs,2093 +aiofiles/threadpool/__init__.py,sha256=c_aexl1t193iKdPZaolPEEbHDrQ0RrsH_HTAToMPQBo,3171 +aiofiles/threadpool/__pycache__/__init__.cpython-311.pyc,, +aiofiles/threadpool/__pycache__/binary.cpython-311.pyc,, +aiofiles/threadpool/__pycache__/text.cpython-311.pyc,, +aiofiles/threadpool/__pycache__/utils.cpython-311.pyc,, +aiofiles/threadpool/binary.py,sha256=hp-km9VCRu0MLz_wAEUfbCz7OL7xtn9iGAawabpnp5U,2315 +aiofiles/threadpool/text.py,sha256=fNmpw2PEkj0BZSldipJXAgZqVGLxALcfOMiuDQ54Eas,1223 +aiofiles/threadpool/utils.py,sha256=B59dSZwO_WZs2dFFycKeA91iD2Xq2nNw1EFF8YMBI5k,1868 diff --git a/env/Lib/site-packages/aiofiles-23.2.1.dist-info/WHEEL b/env/Lib/site-packages/aiofiles-23.2.1.dist-info/WHEEL new file mode 100644 index 0000000..9a7c9d3 --- /dev/null +++ b/env/Lib/site-packages/aiofiles-23.2.1.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: hatchling 1.17.1 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/env/Lib/site-packages/aiofiles-23.2.1.dist-info/licenses/LICENSE b/env/Lib/site-packages/aiofiles-23.2.1.dist-info/licenses/LICENSE new file mode 100644 index 0000000..e06d208 --- /dev/null +++ b/env/Lib/site-packages/aiofiles-23.2.1.dist-info/licenses/LICENSE @@ -0,0 +1,202 @@ +Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright {yyyy} {name of copyright owner} + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + diff --git a/env/Lib/site-packages/aiofiles-23.2.1.dist-info/licenses/NOTICE b/env/Lib/site-packages/aiofiles-23.2.1.dist-info/licenses/NOTICE new file mode 100644 index 0000000..d134f28 --- /dev/null +++ b/env/Lib/site-packages/aiofiles-23.2.1.dist-info/licenses/NOTICE @@ -0,0 +1,2 @@ +Asyncio support for files +Copyright 2016 Tin Tvrtkovic diff --git a/env/Lib/site-packages/aiofiles/__init__.py b/env/Lib/site-packages/aiofiles/__init__.py new file mode 100644 index 0000000..9e75111 --- /dev/null +++ b/env/Lib/site-packages/aiofiles/__init__.py @@ -0,0 +1,22 @@ +"""Utilities for asyncio-friendly file handling.""" +from .threadpool import ( + open, + stdin, + stdout, + stderr, + stdin_bytes, + stdout_bytes, + stderr_bytes, +) +from . import tempfile + +__all__ = [ + "open", + "tempfile", + "stdin", + "stdout", + "stderr", + "stdin_bytes", + "stdout_bytes", + "stderr_bytes", +] diff --git a/env/Lib/site-packages/aiofiles/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiofiles/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..86986e8c437c10a08475b80367a06af908a99409 GIT binary patch literal 612 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiofiles/base.py b/env/Lib/site-packages/aiofiles/base.py new file mode 100644 index 0000000..07f2c2e --- /dev/null +++ b/env/Lib/site-packages/aiofiles/base.py @@ -0,0 +1,113 @@ +"""Various base classes.""" +from types import coroutine +from collections.abc import Coroutine +from asyncio import get_running_loop + + +class AsyncBase: + def __init__(self, file, loop, executor): + self._file = file + self._executor = executor + self._ref_loop = loop + + @property + def _loop(self): + return self._ref_loop or get_running_loop() + + def __aiter__(self): + """We are our own iterator.""" + return self + + def __repr__(self): + return super().__repr__() + " wrapping " + repr(self._file) + + async def __anext__(self): + """Simulate normal file iteration.""" + line = await self.readline() + if line: + return line + else: + raise StopAsyncIteration + + +class AsyncIndirectBase(AsyncBase): + def __init__(self, name, loop, executor, indirect): + self._indirect = indirect + self._name = name + super().__init__(None, loop, executor) + + @property + def _file(self): + return self._indirect() + + @_file.setter + def _file(self, v): + pass # discard writes + + +class _ContextManager(Coroutine): + __slots__ = ("_coro", "_obj") + + def __init__(self, coro): + self._coro = coro + self._obj = None + + def send(self, value): + return self._coro.send(value) + + def throw(self, typ, val=None, tb=None): + if val is None: + return self._coro.throw(typ) + elif tb is None: + return self._coro.throw(typ, val) + else: + return self._coro.throw(typ, val, tb) + + def close(self): + return self._coro.close() + + @property + def gi_frame(self): + return self._coro.gi_frame + + @property + def gi_running(self): + return self._coro.gi_running + + @property + def gi_code(self): + return self._coro.gi_code + + def __next__(self): + return self.send(None) + + @coroutine + def __iter__(self): + resp = yield from self._coro + return resp + + def __await__(self): + resp = yield from self._coro + return resp + + async def __anext__(self): + resp = await self._coro + return resp + + async def __aenter__(self): + self._obj = await self._coro + return self._obj + + async def __aexit__(self, exc_type, exc, tb): + self._obj.close() + self._obj = None + + +class AiofilesContextManager(_ContextManager): + """An adjusted async context manager for aiofiles.""" + + async def __aexit__(self, exc_type, exc_val, exc_tb): + await get_running_loop().run_in_executor( + None, self._obj._file.__exit__, exc_type, exc_val, exc_tb + ) + self._obj = None diff --git a/env/Lib/site-packages/aiofiles/os.py b/env/Lib/site-packages/aiofiles/os.py new file mode 100644 index 0000000..29bc748 --- /dev/null +++ b/env/Lib/site-packages/aiofiles/os.py @@ -0,0 +1,51 @@ +"""Async executor versions of file functions from the os module.""" +import os + +from . import ospath as path +from .ospath import wrap + +__all__ = [ + "path", + "stat", + "statvfs", + "rename", + "renames", + "replace", + "remove", + "unlink", + "mkdir", + "makedirs", + "rmdir", + "removedirs", + "link", + "symlink", + "readlink", + "listdir", + "scandir", + "access", + "sendfile", + "wrap", +] + + +stat = wrap(os.stat) +rename = wrap(os.rename) +renames = wrap(os.renames) +replace = wrap(os.replace) +remove = wrap(os.remove) +unlink = wrap(os.unlink) +mkdir = wrap(os.mkdir) +makedirs = wrap(os.makedirs) +rmdir = wrap(os.rmdir) +removedirs = wrap(os.removedirs) +link = wrap(os.link) +symlink = wrap(os.symlink) +readlink = wrap(os.readlink) +listdir = wrap(os.listdir) +scandir = wrap(os.scandir) +access = wrap(os.access) + +if hasattr(os, "sendfile"): + sendfile = wrap(os.sendfile) +if hasattr(os, "statvfs"): + statvfs = wrap(os.statvfs) diff --git a/env/Lib/site-packages/aiofiles/ospath.py b/env/Lib/site-packages/aiofiles/ospath.py new file mode 100644 index 0000000..5f32a43 --- /dev/null +++ b/env/Lib/site-packages/aiofiles/ospath.py @@ -0,0 +1,28 @@ +"""Async executor versions of file functions from the os.path module.""" +import asyncio +from functools import partial, wraps +from os import path + + +def wrap(func): + @wraps(func) + async def run(*args, loop=None, executor=None, **kwargs): + if loop is None: + loop = asyncio.get_running_loop() + pfunc = partial(func, *args, **kwargs) + return await loop.run_in_executor(executor, pfunc) + + return run + + +exists = wrap(path.exists) +isfile = wrap(path.isfile) +isdir = wrap(path.isdir) +islink = wrap(path.islink) +ismount = wrap(path.ismount) +getsize = wrap(path.getsize) +getmtime = wrap(path.getmtime) +getatime = wrap(path.getatime) +getctime = wrap(path.getctime) +samefile = wrap(path.samefile) +sameopenfile = wrap(path.sameopenfile) diff --git a/env/Lib/site-packages/aiofiles/tempfile/__init__.py b/env/Lib/site-packages/aiofiles/tempfile/__init__.py new file mode 100644 index 0000000..75d10b6 --- /dev/null +++ b/env/Lib/site-packages/aiofiles/tempfile/__init__.py @@ -0,0 +1,357 @@ +import asyncio +from functools import partial, singledispatch +from io import BufferedRandom, BufferedReader, BufferedWriter, FileIO, TextIOBase +from tempfile import NamedTemporaryFile as syncNamedTemporaryFile +from tempfile import SpooledTemporaryFile as syncSpooledTemporaryFile +from tempfile import TemporaryDirectory as syncTemporaryDirectory +from tempfile import TemporaryFile as syncTemporaryFile +from tempfile import _TemporaryFileWrapper as syncTemporaryFileWrapper + +from ..base import AiofilesContextManager +from ..threadpool.binary import AsyncBufferedIOBase, AsyncBufferedReader, AsyncFileIO +from ..threadpool.text import AsyncTextIOWrapper +from .temptypes import AsyncSpooledTemporaryFile, AsyncTemporaryDirectory +import sys + +__all__ = [ + "NamedTemporaryFile", + "TemporaryFile", + "SpooledTemporaryFile", + "TemporaryDirectory", +] + + +# ================================================================ +# Public methods for async open and return of temp file/directory +# objects with async interface +# ================================================================ +if sys.version_info >= (3, 12): + + def NamedTemporaryFile( + mode="w+b", + buffering=-1, + encoding=None, + newline=None, + suffix=None, + prefix=None, + dir=None, + delete=True, + delete_on_close=True, + loop=None, + executor=None, + ): + """Async open a named temporary file""" + return AiofilesContextManager( + _temporary_file( + named=True, + mode=mode, + buffering=buffering, + encoding=encoding, + newline=newline, + suffix=suffix, + prefix=prefix, + dir=dir, + delete=delete, + delete_on_close=delete_on_close, + loop=loop, + executor=executor, + ) + ) + +else: + + def NamedTemporaryFile( + mode="w+b", + buffering=-1, + encoding=None, + newline=None, + suffix=None, + prefix=None, + dir=None, + delete=True, + loop=None, + executor=None, + ): + """Async open a named temporary file""" + return AiofilesContextManager( + _temporary_file( + named=True, + mode=mode, + buffering=buffering, + encoding=encoding, + newline=newline, + suffix=suffix, + prefix=prefix, + dir=dir, + delete=delete, + loop=loop, + executor=executor, + ) + ) + + +def TemporaryFile( + mode="w+b", + buffering=-1, + encoding=None, + newline=None, + suffix=None, + prefix=None, + dir=None, + loop=None, + executor=None, +): + """Async open an unnamed temporary file""" + return AiofilesContextManager( + _temporary_file( + named=False, + mode=mode, + buffering=buffering, + encoding=encoding, + newline=newline, + suffix=suffix, + prefix=prefix, + dir=dir, + loop=loop, + executor=executor, + ) + ) + + +def SpooledTemporaryFile( + max_size=0, + mode="w+b", + buffering=-1, + encoding=None, + newline=None, + suffix=None, + prefix=None, + dir=None, + loop=None, + executor=None, +): + """Async open a spooled temporary file""" + return AiofilesContextManager( + _spooled_temporary_file( + max_size=max_size, + mode=mode, + buffering=buffering, + encoding=encoding, + newline=newline, + suffix=suffix, + prefix=prefix, + dir=dir, + loop=loop, + executor=executor, + ) + ) + + +def TemporaryDirectory(suffix=None, prefix=None, dir=None, loop=None, executor=None): + """Async open a temporary directory""" + return AiofilesContextManagerTempDir( + _temporary_directory( + suffix=suffix, prefix=prefix, dir=dir, loop=loop, executor=executor + ) + ) + + +# ========================================================= +# Internal coroutines to open new temp files/directories +# ========================================================= +if sys.version_info >= (3, 12): + + async def _temporary_file( + named=True, + mode="w+b", + buffering=-1, + encoding=None, + newline=None, + suffix=None, + prefix=None, + dir=None, + delete=True, + delete_on_close=True, + loop=None, + executor=None, + max_size=0, + ): + """Async method to open a temporary file with async interface""" + if loop is None: + loop = asyncio.get_running_loop() + + if named: + cb = partial( + syncNamedTemporaryFile, + mode=mode, + buffering=buffering, + encoding=encoding, + newline=newline, + suffix=suffix, + prefix=prefix, + dir=dir, + delete=delete, + delete_on_close=delete_on_close, + ) + else: + cb = partial( + syncTemporaryFile, + mode=mode, + buffering=buffering, + encoding=encoding, + newline=newline, + suffix=suffix, + prefix=prefix, + dir=dir, + ) + + f = await loop.run_in_executor(executor, cb) + + # Wrap based on type of underlying IO object + if type(f) is syncTemporaryFileWrapper: + # _TemporaryFileWrapper was used (named files) + result = wrap(f.file, f, loop=loop, executor=executor) + result._closer = f._closer + return result + else: + # IO object was returned directly without wrapper + return wrap(f, f, loop=loop, executor=executor) + +else: + + async def _temporary_file( + named=True, + mode="w+b", + buffering=-1, + encoding=None, + newline=None, + suffix=None, + prefix=None, + dir=None, + delete=True, + loop=None, + executor=None, + max_size=0, + ): + """Async method to open a temporary file with async interface""" + if loop is None: + loop = asyncio.get_running_loop() + + if named: + cb = partial( + syncNamedTemporaryFile, + mode=mode, + buffering=buffering, + encoding=encoding, + newline=newline, + suffix=suffix, + prefix=prefix, + dir=dir, + delete=delete, + ) + else: + cb = partial( + syncTemporaryFile, + mode=mode, + buffering=buffering, + encoding=encoding, + newline=newline, + suffix=suffix, + prefix=prefix, + dir=dir, + ) + + f = await loop.run_in_executor(executor, cb) + + # Wrap based on type of underlying IO object + if type(f) is syncTemporaryFileWrapper: + # _TemporaryFileWrapper was used (named files) + result = wrap(f.file, f, loop=loop, executor=executor) + # add delete property + result.delete = f.delete + return result + else: + # IO object was returned directly without wrapper + return wrap(f, f, loop=loop, executor=executor) + + +async def _spooled_temporary_file( + max_size=0, + mode="w+b", + buffering=-1, + encoding=None, + newline=None, + suffix=None, + prefix=None, + dir=None, + loop=None, + executor=None, +): + """Open a spooled temporary file with async interface""" + if loop is None: + loop = asyncio.get_running_loop() + + cb = partial( + syncSpooledTemporaryFile, + max_size=max_size, + mode=mode, + buffering=buffering, + encoding=encoding, + newline=newline, + suffix=suffix, + prefix=prefix, + dir=dir, + ) + + f = await loop.run_in_executor(executor, cb) + + # Single interface provided by SpooledTemporaryFile for all modes + return AsyncSpooledTemporaryFile(f, loop=loop, executor=executor) + + +async def _temporary_directory( + suffix=None, prefix=None, dir=None, loop=None, executor=None +): + """Async method to open a temporary directory with async interface""" + if loop is None: + loop = asyncio.get_running_loop() + + cb = partial(syncTemporaryDirectory, suffix, prefix, dir) + f = await loop.run_in_executor(executor, cb) + + return AsyncTemporaryDirectory(f, loop=loop, executor=executor) + + +class AiofilesContextManagerTempDir(AiofilesContextManager): + """With returns the directory location, not the object (matching sync lib)""" + + async def __aenter__(self): + self._obj = await self._coro + return self._obj.name + + +@singledispatch +def wrap(base_io_obj, file, *, loop=None, executor=None): + """Wrap the object with interface based on type of underlying IO""" + raise TypeError("Unsupported IO type: {}".format(base_io_obj)) + + +@wrap.register(TextIOBase) +def _(base_io_obj, file, *, loop=None, executor=None): + return AsyncTextIOWrapper(file, loop=loop, executor=executor) + + +@wrap.register(BufferedWriter) +def _(base_io_obj, file, *, loop=None, executor=None): + return AsyncBufferedIOBase(file, loop=loop, executor=executor) + + +@wrap.register(BufferedReader) +@wrap.register(BufferedRandom) +def _(base_io_obj, file, *, loop=None, executor=None): + return AsyncBufferedReader(file, loop=loop, executor=executor) + + +@wrap.register(FileIO) +def _(base_io_obj, file, *, loop=None, executor=None): + return AsyncFileIO(file, loop=loop, executor=executor) diff --git a/env/Lib/site-packages/aiofiles/tempfile/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiofiles/tempfile/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..49a695bc76503d9c3c22ae4348c573b8098924e0 GIT binary patch literal 9347 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiofiles/tempfile/__pycache__/temptypes.cpython-311.pyc b/env/Lib/site-packages/aiofiles/tempfile/__pycache__/temptypes.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..959020b57f5c7d9999dd82d4d25242240c027d63 GIT binary patch literal 3934 zcmeHKL2nz!6`on{l1oaKLdlXyMY8F{O-kF8)7nX3p-mH2u;Zjq4=z%G5U^P7jO?|R zTy}OPTPzI(a8Rg)f!3}88Lffpq}uSshX%;8KcELHAW&j~0tRwPZWQEGPJM4yyB0-D zLC|Z5JKw&UeKYfR-nVZa|9<31hCuoJum4&s>4bcRji~hR3OjF6Le>c*Wx^;^99mJz z3MDMTR3}kU%c_($N2?^u$x5o6s_12%5{2*-OS06aLdX-SVS(Nx(^;BjSRd~EYPR3qx<_{wLGjg-u)Jb&YoefULnPa`uiVvt5vITLzuN17hYk}6$P*6x(;Ur zpI2&yMcd(C!L05!nJu{GyJEHAE?fu6`vwgw(jZkcg>ReAH@J(?PRogBOpg~6LEdt! z%wXK%S52QAzH9KC+**ctf}=0(9jgiV=Bfb*R{5(&xU91pB+;I#8|cDy9Cw9_K(idz zC!>T$jls6Ka`K=;LR)dHJ>q?`tZ@T%o9 zyLvTHD=y=KS~V*?(5w6g&f{63A3}`WvU3vJ>x7ds1p+FJmJ>|*jFeTD0MwWYm}DAk zcrwV#eYp~D@vmTqU15sVi||(UGhM!ru6UVV!E#K`v!cb(6x{RMPIra`WQ z9G2^`u22}c()}!E{Vm#{;=8!>OAneg7ts|H2deTD#aD9=ku? z8h&$4Z}$yj_iGQ-hnc?({$+40S8U~qk3Re|cfOfB-yRxWFWoEMJ$wIbv;V|FS0@1z z$XQ?rTsyEbv0`6B1AQSmkpu4^%8B>=IC7D0Zp8j?(C*lBO97t5-rm?V9_Zl6>q7)y;MAKkI=)tcvVUo>J{=>ssG?|rRMMo zullBMyVZj4LbUU3%dSCKC`4gquBeMim{=S`zXFgmqlE77RilG3@G#z?P0h z@j9p%HBrD()C&}AAy6gD6|v&s-W9Nj*FX|)0@RNm%r?0wPUzhQ2+8&=CR-{!`k!p> z!O@4~t$gv(kG8Uc8|Xygvz(05MPBJAJowztrqM-g~u&N7gQjlVH{Vc?g@(RlbXd;tf#m zrC3IKTOK^(hoB*f2&WMCa!Lmt3Uk5X;tW12Axr`6=hj=$S3mh3+>)!w(SHW@!w5F@ zRNu;8Xk{<_F9bV&@AyV;D|@PyJ@tJkHdjmqx?$kqY#2etFyOFWc2Mp&jNdGq&hC?x zVKCP+47p$O;}WEq`45YQu4vAqj zmR|Is6t04E2PwR(=PatQY4Pt;4mIlOlBQlUQ63~jz7d*2C9(lz?7#1Zvk(fnQ#yLsC zK$W3UkCHtP*N#IS`p>S~zG3X1uDvEtMH)YYf!?bCaI%i%*VH?i=$1bLt${W8g`p=l z7?jc6+faAj1Bi~m4Ul_F&j-3MNeN$;ig#gXk;+%}aH-v>-3MZQ@&NZt$<%TdR6P7X zcN2txp+7o*aDHFCQ*G)K2VL@==88%2V;CsTA)H5e8{wx2xUzT$;Ut1QLoT3%Fb&m1 z*hAjvpX$eDfkkKly|p}GKBzQA)Vc*Vbl zi8f}pQ_H>$8cFCDcs2|8>lS`y(zJaxf2;o_{DR*TGoXiC>&*i~o{=J>90`O*-CI`{dQ%Rx@pNpsfx{0p;!C zjG{az0G&~y03Lfi)ZR~rFfYY6TfziFAc4 max_size: + await self.rollover() + + async def write(self, s): + """Implementation to anticipate rollover""" + if self._file._rolled: + cb = partial(self._file.write, s) + return await self._loop.run_in_executor(self._executor, cb) + else: + file = self._file._file # reference underlying base IO object + rv = file.write(s) + await self._check() + return rv + + async def writelines(self, iterable): + """Implementation to anticipate rollover""" + if self._file._rolled: + cb = partial(self._file.writelines, iterable) + return await self._loop.run_in_executor(self._executor, cb) + else: + file = self._file._file # reference underlying base IO object + rv = file.writelines(iterable) + await self._check() + return rv + + +@delegate_to_executor("cleanup") +@proxy_property_directly("name") +class AsyncTemporaryDirectory: + """Async wrapper for TemporaryDirectory class""" + + def __init__(self, file, loop, executor): + self._file = file + self._loop = loop + self._executor = executor + + async def close(self): + await self.cleanup() diff --git a/env/Lib/site-packages/aiofiles/threadpool/__init__.py b/env/Lib/site-packages/aiofiles/threadpool/__init__.py new file mode 100644 index 0000000..a1cc673 --- /dev/null +++ b/env/Lib/site-packages/aiofiles/threadpool/__init__.py @@ -0,0 +1,141 @@ +"""Handle files using a thread pool executor.""" +import asyncio +import sys +from functools import partial, singledispatch +from io import ( + BufferedIOBase, + BufferedRandom, + BufferedReader, + BufferedWriter, + FileIO, + TextIOBase, +) +from types import coroutine + +from ..base import AiofilesContextManager +from .binary import ( + AsyncBufferedIOBase, + AsyncBufferedReader, + AsyncFileIO, + AsyncIndirectBufferedIOBase, +) +from .text import AsyncTextIndirectIOWrapper, AsyncTextIOWrapper + +sync_open = open + +__all__ = ( + "open", + "stdin", + "stdout", + "stderr", + "stdin_bytes", + "stdout_bytes", + "stderr_bytes", +) + + +def open( + file, + mode="r", + buffering=-1, + encoding=None, + errors=None, + newline=None, + closefd=True, + opener=None, + *, + loop=None, + executor=None, +): + return AiofilesContextManager( + _open( + file, + mode=mode, + buffering=buffering, + encoding=encoding, + errors=errors, + newline=newline, + closefd=closefd, + opener=opener, + loop=loop, + executor=executor, + ) + ) + + +@coroutine +def _open( + file, + mode="r", + buffering=-1, + encoding=None, + errors=None, + newline=None, + closefd=True, + opener=None, + *, + loop=None, + executor=None, +): + """Open an asyncio file.""" + if loop is None: + loop = asyncio.get_running_loop() + cb = partial( + sync_open, + file, + mode=mode, + buffering=buffering, + encoding=encoding, + errors=errors, + newline=newline, + closefd=closefd, + opener=opener, + ) + f = yield from loop.run_in_executor(executor, cb) + + return wrap(f, loop=loop, executor=executor) + + +@singledispatch +def wrap(file, *, loop=None, executor=None): + raise TypeError("Unsupported io type: {}.".format(file)) + + +@wrap.register(TextIOBase) +def _(file, *, loop=None, executor=None): + return AsyncTextIOWrapper(file, loop=loop, executor=executor) + + +@wrap.register(BufferedWriter) +@wrap.register(BufferedIOBase) +def _(file, *, loop=None, executor=None): + return AsyncBufferedIOBase(file, loop=loop, executor=executor) + + +@wrap.register(BufferedReader) +@wrap.register(BufferedRandom) +def _(file, *, loop=None, executor=None): + return AsyncBufferedReader(file, loop=loop, executor=executor) + + +@wrap.register(FileIO) +def _(file, *, loop=None, executor=None): + return AsyncFileIO(file, loop=loop, executor=executor) + + +stdin = AsyncTextIndirectIOWrapper("sys.stdin", None, None, indirect=lambda: sys.stdin) +stdout = AsyncTextIndirectIOWrapper( + "sys.stdout", None, None, indirect=lambda: sys.stdout +) +stderr = AsyncTextIndirectIOWrapper( + "sys.stderr", None, None, indirect=lambda: sys.stderr +) +stdin_bytes = AsyncIndirectBufferedIOBase( + "sys.stdin.buffer", None, None, indirect=lambda: sys.stdin.buffer +) +stdout_bytes = AsyncIndirectBufferedIOBase( + "sys.stdout.buffer", None, None, indirect=lambda: sys.stdout.buffer +) +stderr_bytes = AsyncIndirectBufferedIOBase( + "sys.stderr.buffer", None, None, indirect=lambda: sys.stderr.buffer +) diff --git a/env/Lib/site-packages/aiofiles/threadpool/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiofiles/threadpool/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ea5209d6c86670d541180b034e994b6e5ef31e58 GIT binary patch literal 5195 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 Y^H6~+id<3Tit<+YXk1p<3bSPPUy(CHb^rhX literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiofiles/threadpool/__pycache__/binary.cpython-311.pyc b/env/Lib/site-packages/aiofiles/threadpool/__pycache__/binary.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..30133f7d43e5c533f4a0b9b4932c929fac52cf6b GIT binary patch literal 3558 zcmcIk&rcgi6rNeHjWG})3E+^BIHV=e1ZW{94JwwJv+Y@- z%&CX|0rZqez2roRa_Oc2MGuR_!J1R0o^mrHr=0rUtPM3a2p3|{d^GQ;ud_1PPXq{gNf=?&Bw3oIStY4Z!W0%T16ehxW`oIKHk1re zq7be!l?7RdHL);jW)arHT3H*rz}i^{>tq+V+6j3J-T#4okX>SzS=Sbv@fP~Qe28_k z9u{R+wp3VwUR`-YSntn-UFEcP&lVWGt(uXO-jYp{=d~>gJD~eNg@ETi@O+&&o#Z(g zu2Fg8lqyl90_Q=mp2txmDmK8&1e`6JWFanX!(IC6yQaK0wOi2Ab0h3azC6k*pc zg`c!w7DC`)rlRbd0fK#j2r;J?FM# zSh<*$i5b?&!^)OL z*0eWdA4z|h{bn+?XxVG2M;3&2CAC(tbx57IY`H0(d!G8vSWY=`=x|<7ujwn?N$G}# z@o`4oRg8PyvdqzCBd6QNk$lmPfl~=V7&un|emeM<2T5?Adg`3t?Aujaq2?iBXA0(1 zpu+8qsRn}SZ;`=#3K6xkBeV8Rq%?pa$qnM@P8F`f!084!l=PSS#H%)c3tEdNjEruY z4N7W}_3;>@J2SWO*(s#>rpNFeLEZ=`%83FT^2SueJ@ua7eCBA{AmOXE7eZ}e&!PaM za#@^1h1X5a=Rn#<_!4@ZdRu~e`@wI%O0+!}m6eKn{C`xQw)DnO9l{){J6d}4o?213UD=E`3l|D4nNeQXgLp?a7t*688c`nS?#~ybu2NZXKL9 zAoquT%A1)T+P6#l(D$_TT@St9VRSxC(fKq*r`HcRRb17oZ>wr;Kz;8Hy}L{A9%!G~ zp4g#dyL1fM#ZmZC*p#BCLle8oQSr5JbaSY^=4CImw zU24-RIc$$zGc;y4LZJ39Tz&$Qt9Iw;30}HSSORx-OSb_6! z;n>9tyha&c5%~C90v81xuRX?u7o#-tZ%^LDdu4kG*k{Y4 zq#YT5lJl?Iel&bD!8yo)^XKHm(0cRW-ezq_s{PvCtkc?lTlu($ye`w4h@aLTg!Nj2 z65eY0!M?vMlA0e%qgS$??wNgPNg1uD$bPNWQCD!v3~Y3gGQu~fzy7Dh-s-Z?a#Ph& z>O0DH{!FgnfjpCK)5sPM!|$k{x@rhrH;_@gVZ56oxQ0%$f-v6CHtn)|x#d-+;9<3> zSsni+%6xDXL(q0R4WmRkCNN>Zd}(sIvNgunedBKB+xNLz$2@a}l9!160;RM^*1K=B z9@**sv-KTfEp_Q)kDbeGvd2n2Hl5kb$j>8~fbrSE#TmK)U=HZ@Ib)BoyXe2VP6`~`}$=6wJF literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiofiles/threadpool/__pycache__/utils.cpython-311.pyc b/env/Lib/site-packages/aiofiles/threadpool/__pycache__/utils.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f942125eebdfb2b0aa62e8357a4b87d98dafb47e GIT binary patch literal 4135 zcmdT{U1$_n6ux)=H`!!O)=k)ex;1OtwfSi_+h~g$7!Xl{;VnPrlaXhJti78RNAPb9j-JX&Z-HS4bOma%poj6n! z)E5rVy*wB19r;9NlOr)%NN2`JCZ}0am04m`R!79l#gVh=(GexBitX8CYBD)4DkI6X zJeHP3rBl7Y#H5gwWvO#oO-o8gc1Ev-*%G7EX-N>-Y}8zhDksFtVrm*RcN~-CR8ms< zIxM12SdDT7;KdwS4eebg)O&&&IDcx*7q}U_8~QEMvm7l%;#wqL@C|Cd!94G){>J&5 z4S1C-l0_SiynGCOC5(=>a~DwGh?OiZcL%(hm-uis>) z7`IZ4TC8+YC0+D?(t$ebS5xI>CS{C%URverZb6j#>_#w*BmZ7 zb%!EKW4a^B#ueQ)d5NEGsZoYihJuR?Lz^=aiOa~Vvj?_Kx8;keKwLI!$C)khm0{7s;az-!z!RR$8HXKP1wF*qICsv7y5=T;H~-}h zLke-fZuA0R5oD{_UtoDt`L#`!&(YEzD%u^suNAZ~%-B%}LxR~sg!d4*#c-pU2IEA` z?zhHc!!(;s)dg=Us1+*^fBV;$ZmPFt7kUc*cFo`ZP|f@MmM#Kd_w<$dW*zvRmFOVc zUEI93C6E2`9pnW&X{epGF?h(Wv(lwkAflvsRD-9{7qKI^PYB2a+KwnnavwbII7FMwI6@{=W zPG!TqByJ0r>ddg5k!Hf_u`rV*E+cb^usk{e^;N|`f*FASf`yj?FgOKV8LjLdY{(jd z%K=#RmSlM#H7{N(Fq`3c!3@Br0vNzbFm~|v>c9+c{hI68;?_|Q_h{XnF!*9`!F+5# z0(bWVIC>l59Rwc3DkHPu=m)Fk{PHF=0zf|~Qf>egWAkdQ|9Y=hyJwv^yfM1g(4sZ$ z|MAGf?w@<1o^9>dTKn@2!z*zBqdz%eoaYBtLwoMEJPRFq8alKTe>}7@PzasWLMQWq zE!}tW_dwU}BX_&+^)Ad50$p05YpFXQ7+5|GfZaFns?f3rza0U8Zp|3(ayqdJuY&dE z_!9LRwBm0MFRXcC$IA&LJ@C-Qor%xH3-x*w#($`no?}z8FfECFtOqVJWGmkQtlKH2 wt7KQc)Yn}u+PqFoXf#Ls-VT>e+6doLf?W +Maintainer-email: Alex Root Junior +License-Expression: MIT +License-File: LICENSE +Keywords: api,asyncio,bot,framework,telegram,wrapper +Classifier: Development Status :: 5 - Production/Stable +Classifier: Environment :: Console +Classifier: Framework :: AsyncIO +Classifier: Intended Audience :: Developers +Classifier: Intended Audience :: System Administrators +Classifier: License :: OSI Approved :: MIT License +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: Implementation :: PyPy +Classifier: Topic :: Communications :: Chat +Classifier: Topic :: Software Development :: Libraries :: Application Frameworks +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Classifier: Typing :: Typed +Requires-Python: >=3.8 +Requires-Dist: aiofiles~=23.2.1 +Requires-Dist: aiohttp<3.11,>=3.9.0 +Requires-Dist: certifi>=2023.7.22 +Requires-Dist: magic-filter<1.1,>=1.0.12 +Requires-Dist: pydantic<2.9,>=2.4.1 +Requires-Dist: typing-extensions<=5.0,>=4.7.0 +Provides-Extra: cli +Requires-Dist: aiogram-cli~=1.0.3; extra == 'cli' +Provides-Extra: dev +Requires-Dist: black~=24.4.2; extra == 'dev' +Requires-Dist: isort~=5.13.2; extra == 'dev' +Requires-Dist: motor-types~=1.0.0b4; extra == 'dev' +Requires-Dist: mypy~=1.10.0; extra == 'dev' +Requires-Dist: packaging~=24.1; extra == 'dev' +Requires-Dist: pre-commit~=3.5; extra == 'dev' +Requires-Dist: ruff~=0.5.1; extra == 'dev' +Requires-Dist: toml~=0.10.2; extra == 'dev' +Provides-Extra: docs +Requires-Dist: furo~=2023.9.10; extra == 'docs' +Requires-Dist: markdown-include~=0.8.1; extra == 'docs' +Requires-Dist: pygments~=2.16.1; extra == 'docs' +Requires-Dist: pymdown-extensions~=10.3; extra == 'docs' +Requires-Dist: sphinx-autobuild~=2021.3.14; extra == 'docs' +Requires-Dist: sphinx-copybutton~=0.5.2; extra == 'docs' +Requires-Dist: sphinx-intl~=2.1.0; extra == 'docs' +Requires-Dist: sphinx-substitution-extensions~=2022.2.16; extra == 'docs' +Requires-Dist: sphinxcontrib-towncrier~=0.4.0a0; extra == 'docs' +Requires-Dist: sphinx~=7.2.6; extra == 'docs' +Requires-Dist: towncrier~=24.7.1; extra == 'docs' +Provides-Extra: fast +Requires-Dist: aiodns>=3.0.0; extra == 'fast' +Requires-Dist: uvloop>=0.17.0; ((sys_platform == 'darwin' or sys_platform == 'linux') and platform_python_implementation != 'PyPy') and extra == 'fast' +Provides-Extra: i18n +Requires-Dist: babel~=2.13.0; extra == 'i18n' +Provides-Extra: mongo +Requires-Dist: motor~=3.3.2; extra == 'mongo' +Provides-Extra: proxy +Requires-Dist: aiohttp-socks~=0.8.3; extra == 'proxy' +Provides-Extra: redis +Requires-Dist: redis[hiredis]~=5.0.1; extra == 'redis' +Provides-Extra: test +Requires-Dist: aresponses~=2.1.6; extra == 'test' +Requires-Dist: pycryptodomex~=3.19.0; extra == 'test' +Requires-Dist: pytest-aiohttp~=1.0.5; extra == 'test' +Requires-Dist: pytest-asyncio~=0.21.1; extra == 'test' +Requires-Dist: pytest-cov~=4.1.0; extra == 'test' +Requires-Dist: pytest-html~=4.0.2; extra == 'test' +Requires-Dist: pytest-lazy-fixture~=0.6.3; extra == 'test' +Requires-Dist: pytest-mock~=3.12.0; extra == 'test' +Requires-Dist: pytest-mypy~=0.10.3; extra == 'test' +Requires-Dist: pytest~=7.4.2; extra == 'test' +Requires-Dist: pytz~=2023.3; extra == 'test' +Description-Content-Type: text/x-rst + +####### +aiogram +####### + +.. image:: https://img.shields.io/pypi/l/aiogram.svg?style=flat-square + :target: https://opensource.org/licenses/MIT + :alt: MIT License + +.. image:: https://img.shields.io/pypi/status/aiogram.svg?style=flat-square + :target: https://pypi.python.org/pypi/aiogram + :alt: PyPi status + +.. image:: https://img.shields.io/pypi/v/aiogram.svg?style=flat-square + :target: https://pypi.python.org/pypi/aiogram + :alt: PyPi Package Version + +.. image:: https://img.shields.io/pypi/dm/aiogram.svg?style=flat-square + :target: https://pypi.python.org/pypi/aiogram + :alt: Downloads + +.. image:: https://img.shields.io/pypi/pyversions/aiogram.svg?style=flat-square + :target: https://pypi.python.org/pypi/aiogram + :alt: Supported python versions + +.. image:: https://img.shields.io/badge/dynamic/json?color=blue&logo=telegram&label=Telegram%20Bot%20API&query=%24.api.version&url=https%3A%2F%2Fraw.githubusercontent.com%2Faiogram%2Faiogram%2Fdev-3.x%2F.butcher%2Fschema%2Fschema.json&style=flat-square + :target: https://core.telegram.org/bots/api + :alt: Telegram Bot API + +.. image:: https://img.shields.io/github/actions/workflow/status/aiogram/aiogram/tests.yml?branch=dev-3.x&style=flat-square + :target: https://github.com/aiogram/aiogram/actions + :alt: Tests + +.. image:: https://img.shields.io/codecov/c/github/aiogram/aiogram?style=flat-square + :target: https://app.codecov.io/gh/aiogram/aiogram + :alt: Codecov + +**aiogram** is a modern and fully asynchronous framework for +`Telegram Bot API `_ written in Python 3.8+ using +`asyncio `_ and +`aiohttp `_. + +Make your bots faster and more powerful! + +Documentation: + - 🇺🇸 `English `_ + - 🇺🇦 `Ukrainian `_ + + +Features +======== + +- Asynchronous (`asyncio docs `_, :pep:`492`) +- Has type hints (:pep:`484`) and can be used with `mypy `_ +- Supports `PyPy `_ +- Supports `Telegram Bot API 7.9 `_ and gets fast updates to the latest versions of the Bot API +- Telegram Bot API integration code was `autogenerated `_ and can be easily re-generated when API gets updated +- Updates router (Blueprints) +- Has Finite State Machine +- Uses powerful `magic filters `_ +- Middlewares (incoming updates and API calls) +- Provides `Replies into Webhook `_ +- Integrated I18n/L10n support with GNU Gettext (or Fluent) + + +.. warning:: + + It is strongly advised that you have prior experience working + with `asyncio `_ + before beginning to use **aiogram**. + + If you have any questions, you can visit our community chats on Telegram: + + - 🇺🇸 `@aiogram `_ + - 🇺🇦 `@aiogramua `_ + - 🇺🇿 `@aiogram_uz `_ + - 🇰🇿 `@aiogram_kz `_ + - 🇷🇺 `@aiogram_ru `_ + - 🇮🇷 `@aiogram_fa `_ + - 🇮🇹 `@aiogram_it `_ + - 🇧🇷 `@aiogram_br `_ diff --git a/env/Lib/site-packages/aiogram-3.12.0.dist-info/RECORD b/env/Lib/site-packages/aiogram-3.12.0.dist-info/RECORD new file mode 100644 index 0000000..4bcde9a --- /dev/null +++ b/env/Lib/site-packages/aiogram-3.12.0.dist-info/RECORD @@ -0,0 +1,961 @@ +aiogram-3.12.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +aiogram-3.12.0.dist-info/METADATA,sha256=xLpro6MzAiOqnI3s9iwMQa4utDb-lP5628N1tsZdgN4,7344 +aiogram-3.12.0.dist-info/RECORD,, +aiogram-3.12.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +aiogram-3.12.0.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87 +aiogram-3.12.0.dist-info/licenses/LICENSE,sha256=kTEqDVZ6fYSuFKAER9NvxX60epaWBKI_h-xGsoiU6Iw,1070 +aiogram/__init__.py,sha256=hzEKX_gFXmp5n4GXZEU80SJep1_FAH9owAnFTqd9nK0,948 +aiogram/__meta__.py,sha256=55lJQIAoSsYeR0jyyKdVygUQrmEXQxbAvKlsKTLaShU,47 +aiogram/__pycache__/__init__.cpython-311.pyc,, +aiogram/__pycache__/__meta__.cpython-311.pyc,, +aiogram/__pycache__/exceptions.cpython-311.pyc,, +aiogram/__pycache__/loggers.cpython-311.pyc,, +aiogram/client/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +aiogram/client/__pycache__/__init__.cpython-311.pyc,, +aiogram/client/__pycache__/bot.cpython-311.pyc,, +aiogram/client/__pycache__/context_controller.cpython-311.pyc,, +aiogram/client/__pycache__/default.cpython-311.pyc,, +aiogram/client/__pycache__/telegram.cpython-311.pyc,, +aiogram/client/bot.py,sha256=gYy_a9F6Hass5YwsobSFeOu15mDrnR1u6N1x0YohQnA,262513 +aiogram/client/context_controller.py,sha256=rAminUBsB3K5FDyj-WQopkD1e94c7GrGVXNyaqPbXZ0,761 +aiogram/client/default.py,sha256=sqctTqHKsc69UBGh4sJeFbihGH5feDudb685CbMtdDU,2750 +aiogram/client/session/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +aiogram/client/session/__pycache__/__init__.cpython-311.pyc,, +aiogram/client/session/__pycache__/aiohttp.cpython-311.pyc,, +aiogram/client/session/__pycache__/base.cpython-311.pyc,, +aiogram/client/session/aiohttp.py,sha256=q2OZLVEdz3LghDlEC5KfDEJJLtwYEbfJMXEmsVNnRcQ,7197 +aiogram/client/session/base.py,sha256=e3n5NrwL6L-pFhLetTgBg76uLJDxDP6jQqyxPgjtI_0,8335 +aiogram/client/session/middlewares/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +aiogram/client/session/middlewares/__pycache__/__init__.cpython-311.pyc,, +aiogram/client/session/middlewares/__pycache__/base.cpython-311.pyc,, +aiogram/client/session/middlewares/__pycache__/manager.cpython-311.pyc,, +aiogram/client/session/middlewares/__pycache__/request_logging.cpython-311.pyc,, +aiogram/client/session/middlewares/base.py,sha256=ck8-iOnaYO2FHb3Yjq6E_TZwiPMg8w8THOXqyHDLjro,1394 +aiogram/client/session/middlewares/manager.py,sha256=c1CS6S_UvxYVAfCq6MZ4Laet6sxReEmQ915XltTJR5o,1903 +aiogram/client/session/middlewares/request_logging.py,sha256=_nUsciMnQeTZ-_nJw3A3NNBlGWzGqKMqYw2oJqJw3s8,1183 +aiogram/client/telegram.py,sha256=cu0HUZqwPzvZp-tMI3yewmnNZ78aTpFfEF0ZZVf0qAw,3080 +aiogram/dispatcher/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +aiogram/dispatcher/__pycache__/__init__.cpython-311.pyc,, +aiogram/dispatcher/__pycache__/dispatcher.cpython-311.pyc,, +aiogram/dispatcher/__pycache__/flags.cpython-311.pyc,, +aiogram/dispatcher/__pycache__/router.cpython-311.pyc,, +aiogram/dispatcher/dispatcher.py,sha256=j3V5oi-nBUT1CBSBAs8lbCRQNIveZ9sVOJmUHnuJEqE,23205 +aiogram/dispatcher/event/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +aiogram/dispatcher/event/__pycache__/__init__.cpython-311.pyc,, +aiogram/dispatcher/event/__pycache__/bases.cpython-311.pyc,, +aiogram/dispatcher/event/__pycache__/event.cpython-311.pyc,, +aiogram/dispatcher/event/__pycache__/handler.cpython-311.pyc,, +aiogram/dispatcher/event/__pycache__/telegram.cpython-311.pyc,, +aiogram/dispatcher/event/bases.py,sha256=Piod0CEyGvBOwEuE7e70JMQal4XFilFD3NMinR2bEyE,871 +aiogram/dispatcher/event/event.py,sha256=YXOroGX5Mj-5w6Jgl9oPf-muIp6ijeWjNJ3hEr2mA68,1352 +aiogram/dispatcher/event/handler.py,sha256=rgV8j1x2a8qpmWCue1-uQ3fRzrc8qDdhKNJBkBnFSYo,3631 +aiogram/dispatcher/event/telegram.py,sha256=BjptMwTbDVdpiIkngGyy8zY2b3i5__gwnuyA7uw9HoY,4767 +aiogram/dispatcher/flags.py,sha256=vEevCfweZKDCEW2tA5E3UbqMH-TjDBI0ujf7ktzsx9o,3479 +aiogram/dispatcher/middlewares/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +aiogram/dispatcher/middlewares/__pycache__/__init__.cpython-311.pyc,, +aiogram/dispatcher/middlewares/__pycache__/base.cpython-311.pyc,, +aiogram/dispatcher/middlewares/__pycache__/error.cpython-311.pyc,, +aiogram/dispatcher/middlewares/__pycache__/manager.cpython-311.pyc,, +aiogram/dispatcher/middlewares/__pycache__/user_context.cpython-311.pyc,, +aiogram/dispatcher/middlewares/base.py,sha256=czbD9IDLoHb6pf6HisRGyG8pAQMLbC4R5k-iuTIWSNU,784 +aiogram/dispatcher/middlewares/error.py,sha256=xDfQxTo9PT1qXvE35OGesDi7WydeQeB4zgT07eXM5G4,1119 +aiogram/dispatcher/middlewares/manager.py,sha256=-ivUdff-Addpd_s_AlDA4RaVsMJmzgWwvt2DIqITnBw,2166 +aiogram/dispatcher/middlewares/user_context.py,sha256=kc2ONIgh_b4MlItGxH-7RkxZ6zCevY2sfplJl1keyVU,7115 +aiogram/dispatcher/router.py,sha256=vnAvQQANQ85JXE84s7JXkVo60uKUvyqg0bcIFGJ8we8,10512 +aiogram/enums/__init__.py,sha256=oQH8dIPtHKcgQwX6k6-EIda0PLM_HWyyPy5Oft1BSoY,2014 +aiogram/enums/__pycache__/__init__.cpython-311.pyc,, +aiogram/enums/__pycache__/bot_command_scope_type.cpython-311.pyc,, +aiogram/enums/__pycache__/chat_action.cpython-311.pyc,, +aiogram/enums/__pycache__/chat_boost_source_type.cpython-311.pyc,, +aiogram/enums/__pycache__/chat_member_status.cpython-311.pyc,, +aiogram/enums/__pycache__/chat_type.cpython-311.pyc,, +aiogram/enums/__pycache__/content_type.cpython-311.pyc,, +aiogram/enums/__pycache__/currency.cpython-311.pyc,, +aiogram/enums/__pycache__/dice_emoji.cpython-311.pyc,, +aiogram/enums/__pycache__/encrypted_passport_element.cpython-311.pyc,, +aiogram/enums/__pycache__/inline_query_result_type.cpython-311.pyc,, +aiogram/enums/__pycache__/input_media_type.cpython-311.pyc,, +aiogram/enums/__pycache__/input_paid_media_type.cpython-311.pyc,, +aiogram/enums/__pycache__/keyboard_button_poll_type_type.cpython-311.pyc,, +aiogram/enums/__pycache__/mask_position_point.cpython-311.pyc,, +aiogram/enums/__pycache__/menu_button_type.cpython-311.pyc,, +aiogram/enums/__pycache__/message_entity_type.cpython-311.pyc,, +aiogram/enums/__pycache__/message_origin_type.cpython-311.pyc,, +aiogram/enums/__pycache__/paid_media_type.cpython-311.pyc,, +aiogram/enums/__pycache__/parse_mode.cpython-311.pyc,, +aiogram/enums/__pycache__/passport_element_error_type.cpython-311.pyc,, +aiogram/enums/__pycache__/poll_type.cpython-311.pyc,, +aiogram/enums/__pycache__/reaction_type_type.cpython-311.pyc,, +aiogram/enums/__pycache__/revenue_withdrawal_state_type.cpython-311.pyc,, +aiogram/enums/__pycache__/sticker_format.cpython-311.pyc,, +aiogram/enums/__pycache__/sticker_type.cpython-311.pyc,, +aiogram/enums/__pycache__/topic_icon_color.cpython-311.pyc,, +aiogram/enums/__pycache__/transaction_partner_type.cpython-311.pyc,, +aiogram/enums/__pycache__/update_type.cpython-311.pyc,, +aiogram/enums/bot_command_scope_type.py,sha256=aPn5UKE6AN5BpK9kTH1ffJzG3qUOWFu5lyZOifMu5so,477 +aiogram/enums/chat_action.py,sha256=KKItRU_RQuNzFMrAtc67Pn0aT4rZuuynpH6-yXfBhRY,972 +aiogram/enums/chat_boost_source_type.py,sha256=80MfT0G_9-uv-7MsTs0lZjtJiA7EaUmqYd5b3vH6JtU,277 +aiogram/enums/chat_member_status.py,sha256=OLr5ZfkZocicy1t5i30g7ufR8kujBPHENzR5UHnsDpc,334 +aiogram/enums/chat_type.py,sha256=1Oi1TYITumT8jZritu1fgHNKDvK9otlAhPm4soyBKQQ,280 +aiogram/enums/content_type.py,sha256=sSTHtq4LqeYB4J3zFug1HkhVuORSdcT7g91ZQTjOZrE,2311 +aiogram/enums/currency.py,sha256=P5S_e7Y3wYmODiaK_8Fz0MHVwJXkt1P9Y3gd2SGo1iU,1563 +aiogram/enums/dice_emoji.py,sha256=9KlOPTQlgt-6d3myDEWWUTB9H8BrE_LRaOZvBM2ceWs,303 +aiogram/enums/encrypted_passport_element.py,sha256=m0-tAF9myf6FwPbsuJgj4AYvywzLMzzltUgrqWgGVws,704 +aiogram/enums/inline_query_result_type.py,sha256=HGNN5aOg_jZbE4NNfHs21M-xK5cj2rBar4-C77T73YI,465 +aiogram/enums/input_media_type.py,sha256=BfCDkzFOjrzJSo2syY2lq3E3JP8AdlGemp7qMnAupw0,291 +aiogram/enums/input_paid_media_type.py,sha256=KoqJo7AelAiY8pmS1mRBuQLz97hedWFImEEVFnEoMmY,247 +aiogram/enums/keyboard_button_poll_type_type.py,sha256=vPjequaOO5zySi7hiQjyVIfQl-jhtpgCGHYMR7DOYWY,324 +aiogram/enums/mask_position_point.py,sha256=lhlx8U-9gtGn_LPiSOHWBe1u8YTLZCERs5x8DRmUubM,290 +aiogram/enums/menu_button_type.py,sha256=4FDz7HKaVtfBlvXObCOVAUmyQQvRsyPi0Vu_Kc-HbDs,264 +aiogram/enums/message_entity_type.py,sha256=00ioN4bPLNUYvCL_nJzp7rNUPhIqNOqoWY3PjiC4ob8,703 +aiogram/enums/message_origin_type.py,sha256=qWHgXPzpuhsTcLx-huqNS1l36JSwqbsCY70_d20nreM,279 +aiogram/enums/paid_media_type.py,sha256=FrGQyXq9bimIb8_b0hpuqYG4mWVruoBYkSC6drd7hw4,261 +aiogram/enums/parse_mode.py,sha256=t5F3LaNLsUOaNQuYlQseWt36suA-oRgr_uScGEU8TKU,234 +aiogram/enums/passport_element_error_type.py,sha256=HCcvvc8DDUNRD-mdFgFqMEFlr_4pa5Us5_U6pO2wXsc,471 +aiogram/enums/poll_type.py,sha256=DluT-wQcOGqBgQimYLlO6OlTIIYnnbtHOmY9pjqVToo,200 +aiogram/enums/reaction_type_type.py,sha256=HfSXXZFcMXjIoD0Q8B_lZju6mPuB4jNIBbRyIfLYnEI,233 +aiogram/enums/revenue_withdrawal_state_type.py,sha256=ZVw59f9-RYG00TJdSHnZo_LTbdR_J8RmkhDCV4C8AFg,290 +aiogram/enums/sticker_format.py,sha256=UmbwulTvkG7TFwS2twsblqiBj89jeEWY-y7P7Ah2qgo,235 +aiogram/enums/sticker_type.py,sha256=XonGtnasf3tXwoD2DVRx5E16rHCE5VqgAFSfcFMIAGU,278 +aiogram/enums/topic_icon_color.py,sha256=q-DilvJsgVmz5VafMOxj1BKJcMoHzpRrbatTPE4inxk,399 +aiogram/enums/transaction_partner_type.py,sha256=VSLiUN_53Ggi9_YrrxoF8OeltgiLY2jJGkAYQJcaHWI,305 +aiogram/enums/update_type.py,sha256=WAXTSDLbOXyzjLanGn_22HsALq96OVdd5q8HunubdG8,1086 +aiogram/exceptions.py,sha256=Y6wDVG2fyoczPn15U5epm_nnTx8eTC3CgX19SzyiqOE,5153 +aiogram/filters/__init__.py,sha256=w7mWuJOIpLDZyUt1eznzMeF-o1UrstHQ-OYbBHHG6ek,1031 +aiogram/filters/__pycache__/__init__.cpython-311.pyc,, +aiogram/filters/__pycache__/base.cpython-311.pyc,, +aiogram/filters/__pycache__/callback_data.cpython-311.pyc,, +aiogram/filters/__pycache__/chat_member_updated.cpython-311.pyc,, +aiogram/filters/__pycache__/command.cpython-311.pyc,, +aiogram/filters/__pycache__/exception.cpython-311.pyc,, +aiogram/filters/__pycache__/logic.cpython-311.pyc,, +aiogram/filters/__pycache__/magic_data.cpython-311.pyc,, +aiogram/filters/__pycache__/state.cpython-311.pyc,, +aiogram/filters/base.py,sha256=6mCB2nSjqskDDl9mKCZ3SghhwQ1jryaSTd5PvWii3bM,2005 +aiogram/filters/callback_data.py,sha256=nxRCCPXX4iuk1bnVpg3MdLOCeGlmJFKIcS6yjPkM2V8,6225 +aiogram/filters/chat_member_updated.py,sha256=3VsiMYLK6L7AfLS7RQRWwjXThWGN7gj4NAYnR0Wdr8I,7484 +aiogram/filters/command.py,sha256=IXb54dwKHLz-Jaq2_HHn2si7r5iAr9pYW3sSxD8szCk,9957 +aiogram/filters/exception.py,sha256=HbJIOVrXHh0_LkID6b-yn8Xow-llmLqKYmK0_tqB4YA,1488 +aiogram/filters/logic.py,sha256=2M-fYY8m1ybX00wFn_8toRHj5alTfy4T6zkIkYrQZbM,2174 +aiogram/filters/magic_data.py,sha256=Y07K9NLDXpXV0EuFR7GR7Yq4SzCYaD3XJsvDH-6JFkQ,718 +aiogram/filters/state.py,sha256=A4GuSAo5KPdSZMetCC9crrfbJ-yghLunJUVYkOdBPTI,1448 +aiogram/fsm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +aiogram/fsm/__pycache__/__init__.cpython-311.pyc,, +aiogram/fsm/__pycache__/context.cpython-311.pyc,, +aiogram/fsm/__pycache__/middleware.cpython-311.pyc,, +aiogram/fsm/__pycache__/scene.cpython-311.pyc,, +aiogram/fsm/__pycache__/state.cpython-311.pyc,, +aiogram/fsm/__pycache__/strategy.cpython-311.pyc,, +aiogram/fsm/context.py,sha256=o0cKPtB43Z2S8DgSD9be5moF8FqOboBca8Wyd6qvUgU,1072 +aiogram/fsm/middleware.py,sha256=4MsKWzr93tzLTmv3dph3pKhznuX9EGsrhBhCb6mhzPo,3755 +aiogram/fsm/scene.py,sha256=7a5zMRvfE2vHQ-3zSCHiBDa93QedmOr6kgLs1svjHAg,31903 +aiogram/fsm/state.py,sha256=T0sPq1_JV5Jq1jVKu67bUQ0-y9Kqsk3hGpj7PgjpacQ,5640 +aiogram/fsm/storage/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +aiogram/fsm/storage/__pycache__/__init__.cpython-311.pyc,, +aiogram/fsm/storage/__pycache__/base.cpython-311.pyc,, +aiogram/fsm/storage/__pycache__/memory.cpython-311.pyc,, +aiogram/fsm/storage/__pycache__/mongo.cpython-311.pyc,, +aiogram/fsm/storage/__pycache__/redis.cpython-311.pyc,, +aiogram/fsm/storage/base.py,sha256=5SVkAFfcCLN8uZkE1EX7DFFcGJ89p4fp3wB9R8FU2no,5023 +aiogram/fsm/storage/memory.py,sha256=xG3507DVY01GTntkGSG1-2fPlWkcDL48QUTIE5WFowQ,2133 +aiogram/fsm/storage/mongo.py,sha256=xGvz9rLr6ji8BhumZb1FTvQ5RvmlGquhLAPe1-vi9ms,4880 +aiogram/fsm/storage/redis.py,sha256=7ZyaB-AMNEITjdYVn24Bha28_MIFRPX41mn5_0sEtiY,5322 +aiogram/fsm/strategy.py,sha256=RUDc6kMae9ZFbyC1bdbAIRz6GoeaIHFzXCXRu8p3Kn0,1147 +aiogram/handlers/__init__.py,sha256=XVErtJHhSmg4ytiDTP9J5pQY0RwBN1TsjT5v-Ls7RE4,800 +aiogram/handlers/__pycache__/__init__.cpython-311.pyc,, +aiogram/handlers/__pycache__/base.cpython-311.pyc,, +aiogram/handlers/__pycache__/callback_query.cpython-311.pyc,, +aiogram/handlers/__pycache__/chat_member.cpython-311.pyc,, +aiogram/handlers/__pycache__/chosen_inline_result.cpython-311.pyc,, +aiogram/handlers/__pycache__/error.cpython-311.pyc,, +aiogram/handlers/__pycache__/inline_query.cpython-311.pyc,, +aiogram/handlers/__pycache__/message.cpython-311.pyc,, +aiogram/handlers/__pycache__/poll.cpython-311.pyc,, +aiogram/handlers/__pycache__/pre_checkout_query.cpython-311.pyc,, +aiogram/handlers/__pycache__/shipping_query.cpython-311.pyc,, +aiogram/handlers/base.py,sha256=SKLNknDSxAItRHwPMJanOPFztWakJQCun4myH9TBNik,1097 +aiogram/handlers/callback_query.py,sha256=XWGgkmyt2Bgnh1B_3ivIZ_jMRJIQUEXPeKSUO4VW_zg,1036 +aiogram/handlers/chat_member.py,sha256=TCr1m47duHFUpL92W56ok0hF1k0NN3Yk88-1zzEsYmw,322 +aiogram/handlers/chosen_inline_result.py,sha256=NjAPc5EgBb8V4p3WVpcPNPd8b1OApymvBN-I75EYMQo,410 +aiogram/handlers/error.py,sha256=86pedHPBgYxXYwrW00s0cadf_lRP6TeHEG0goJ6zNJk,352 +aiogram/handlers/inline_query.py,sha256=sOkT3uMuvamMnSTxct-cdQFng6GBqaOlSNV4aHUbVPQ,381 +aiogram/handlers/message.py,sha256=I6R4TJ8V6bbGVppmxmGSxIkCzeN9JMn1CDojywWrt50,721 +aiogram/handlers/poll.py,sha256=Bn075JIux1lNPjKWH3woV_OzMcvPgPvtkgp4W22mUX8,396 +aiogram/handlers/pre_checkout_query.py,sha256=ZO0iZFVwRz4CtBWIVLds8JoHhMPqCahz6lwOfR4dEkg,321 +aiogram/handlers/shipping_query.py,sha256=ku14YRYvddTbHeKoIwb2oDpfrpsetFC1m2BwIsNwoAs,314 +aiogram/loggers.py,sha256=3MCGSmwgXXsWbgtSaTc6bPSwVOIe8FkQZglc0QLVvsY,257 +aiogram/methods/__init__.py,sha256=v4-H0SB9W9Z7rY4Y_uF5Z86dUZje0aI0cafAxDbL2W0,9575 +aiogram/methods/__pycache__/__init__.cpython-311.pyc,, +aiogram/methods/__pycache__/add_sticker_to_set.cpython-311.pyc,, +aiogram/methods/__pycache__/answer_callback_query.cpython-311.pyc,, +aiogram/methods/__pycache__/answer_inline_query.cpython-311.pyc,, +aiogram/methods/__pycache__/answer_pre_checkout_query.cpython-311.pyc,, +aiogram/methods/__pycache__/answer_shipping_query.cpython-311.pyc,, +aiogram/methods/__pycache__/answer_web_app_query.cpython-311.pyc,, +aiogram/methods/__pycache__/approve_chat_join_request.cpython-311.pyc,, +aiogram/methods/__pycache__/ban_chat_member.cpython-311.pyc,, +aiogram/methods/__pycache__/ban_chat_sender_chat.cpython-311.pyc,, +aiogram/methods/__pycache__/base.cpython-311.pyc,, +aiogram/methods/__pycache__/close.cpython-311.pyc,, +aiogram/methods/__pycache__/close_forum_topic.cpython-311.pyc,, +aiogram/methods/__pycache__/close_general_forum_topic.cpython-311.pyc,, +aiogram/methods/__pycache__/copy_message.cpython-311.pyc,, +aiogram/methods/__pycache__/copy_messages.cpython-311.pyc,, +aiogram/methods/__pycache__/create_chat_invite_link.cpython-311.pyc,, +aiogram/methods/__pycache__/create_chat_subscription_invite_link.cpython-311.pyc,, +aiogram/methods/__pycache__/create_forum_topic.cpython-311.pyc,, +aiogram/methods/__pycache__/create_invoice_link.cpython-311.pyc,, +aiogram/methods/__pycache__/create_new_sticker_set.cpython-311.pyc,, +aiogram/methods/__pycache__/decline_chat_join_request.cpython-311.pyc,, +aiogram/methods/__pycache__/delete_chat_photo.cpython-311.pyc,, +aiogram/methods/__pycache__/delete_chat_sticker_set.cpython-311.pyc,, +aiogram/methods/__pycache__/delete_forum_topic.cpython-311.pyc,, +aiogram/methods/__pycache__/delete_message.cpython-311.pyc,, +aiogram/methods/__pycache__/delete_messages.cpython-311.pyc,, +aiogram/methods/__pycache__/delete_my_commands.cpython-311.pyc,, +aiogram/methods/__pycache__/delete_sticker_from_set.cpython-311.pyc,, +aiogram/methods/__pycache__/delete_sticker_set.cpython-311.pyc,, +aiogram/methods/__pycache__/delete_webhook.cpython-311.pyc,, +aiogram/methods/__pycache__/edit_chat_invite_link.cpython-311.pyc,, +aiogram/methods/__pycache__/edit_chat_subscription_invite_link.cpython-311.pyc,, +aiogram/methods/__pycache__/edit_forum_topic.cpython-311.pyc,, +aiogram/methods/__pycache__/edit_general_forum_topic.cpython-311.pyc,, +aiogram/methods/__pycache__/edit_message_caption.cpython-311.pyc,, +aiogram/methods/__pycache__/edit_message_live_location.cpython-311.pyc,, +aiogram/methods/__pycache__/edit_message_media.cpython-311.pyc,, +aiogram/methods/__pycache__/edit_message_reply_markup.cpython-311.pyc,, +aiogram/methods/__pycache__/edit_message_text.cpython-311.pyc,, +aiogram/methods/__pycache__/export_chat_invite_link.cpython-311.pyc,, +aiogram/methods/__pycache__/forward_message.cpython-311.pyc,, +aiogram/methods/__pycache__/forward_messages.cpython-311.pyc,, +aiogram/methods/__pycache__/get_business_connection.cpython-311.pyc,, +aiogram/methods/__pycache__/get_chat.cpython-311.pyc,, +aiogram/methods/__pycache__/get_chat_administrators.cpython-311.pyc,, +aiogram/methods/__pycache__/get_chat_member.cpython-311.pyc,, +aiogram/methods/__pycache__/get_chat_member_count.cpython-311.pyc,, +aiogram/methods/__pycache__/get_chat_menu_button.cpython-311.pyc,, +aiogram/methods/__pycache__/get_custom_emoji_stickers.cpython-311.pyc,, +aiogram/methods/__pycache__/get_file.cpython-311.pyc,, +aiogram/methods/__pycache__/get_forum_topic_icon_stickers.cpython-311.pyc,, +aiogram/methods/__pycache__/get_game_high_scores.cpython-311.pyc,, +aiogram/methods/__pycache__/get_me.cpython-311.pyc,, +aiogram/methods/__pycache__/get_my_commands.cpython-311.pyc,, +aiogram/methods/__pycache__/get_my_default_administrator_rights.cpython-311.pyc,, +aiogram/methods/__pycache__/get_my_description.cpython-311.pyc,, +aiogram/methods/__pycache__/get_my_name.cpython-311.pyc,, +aiogram/methods/__pycache__/get_my_short_description.cpython-311.pyc,, +aiogram/methods/__pycache__/get_star_transactions.cpython-311.pyc,, +aiogram/methods/__pycache__/get_sticker_set.cpython-311.pyc,, +aiogram/methods/__pycache__/get_updates.cpython-311.pyc,, +aiogram/methods/__pycache__/get_user_chat_boosts.cpython-311.pyc,, +aiogram/methods/__pycache__/get_user_profile_photos.cpython-311.pyc,, +aiogram/methods/__pycache__/get_webhook_info.cpython-311.pyc,, +aiogram/methods/__pycache__/hide_general_forum_topic.cpython-311.pyc,, +aiogram/methods/__pycache__/leave_chat.cpython-311.pyc,, +aiogram/methods/__pycache__/log_out.cpython-311.pyc,, +aiogram/methods/__pycache__/pin_chat_message.cpython-311.pyc,, +aiogram/methods/__pycache__/promote_chat_member.cpython-311.pyc,, +aiogram/methods/__pycache__/refund_star_payment.cpython-311.pyc,, +aiogram/methods/__pycache__/reopen_forum_topic.cpython-311.pyc,, +aiogram/methods/__pycache__/reopen_general_forum_topic.cpython-311.pyc,, +aiogram/methods/__pycache__/replace_sticker_in_set.cpython-311.pyc,, +aiogram/methods/__pycache__/restrict_chat_member.cpython-311.pyc,, +aiogram/methods/__pycache__/revoke_chat_invite_link.cpython-311.pyc,, +aiogram/methods/__pycache__/send_animation.cpython-311.pyc,, +aiogram/methods/__pycache__/send_audio.cpython-311.pyc,, +aiogram/methods/__pycache__/send_chat_action.cpython-311.pyc,, +aiogram/methods/__pycache__/send_contact.cpython-311.pyc,, +aiogram/methods/__pycache__/send_dice.cpython-311.pyc,, +aiogram/methods/__pycache__/send_document.cpython-311.pyc,, +aiogram/methods/__pycache__/send_game.cpython-311.pyc,, +aiogram/methods/__pycache__/send_invoice.cpython-311.pyc,, +aiogram/methods/__pycache__/send_location.cpython-311.pyc,, +aiogram/methods/__pycache__/send_media_group.cpython-311.pyc,, +aiogram/methods/__pycache__/send_message.cpython-311.pyc,, +aiogram/methods/__pycache__/send_paid_media.cpython-311.pyc,, +aiogram/methods/__pycache__/send_photo.cpython-311.pyc,, +aiogram/methods/__pycache__/send_poll.cpython-311.pyc,, +aiogram/methods/__pycache__/send_sticker.cpython-311.pyc,, +aiogram/methods/__pycache__/send_venue.cpython-311.pyc,, +aiogram/methods/__pycache__/send_video.cpython-311.pyc,, +aiogram/methods/__pycache__/send_video_note.cpython-311.pyc,, +aiogram/methods/__pycache__/send_voice.cpython-311.pyc,, +aiogram/methods/__pycache__/set_chat_administrator_custom_title.cpython-311.pyc,, +aiogram/methods/__pycache__/set_chat_description.cpython-311.pyc,, +aiogram/methods/__pycache__/set_chat_menu_button.cpython-311.pyc,, +aiogram/methods/__pycache__/set_chat_permissions.cpython-311.pyc,, +aiogram/methods/__pycache__/set_chat_photo.cpython-311.pyc,, +aiogram/methods/__pycache__/set_chat_sticker_set.cpython-311.pyc,, +aiogram/methods/__pycache__/set_chat_title.cpython-311.pyc,, +aiogram/methods/__pycache__/set_custom_emoji_sticker_set_thumbnail.cpython-311.pyc,, +aiogram/methods/__pycache__/set_game_score.cpython-311.pyc,, +aiogram/methods/__pycache__/set_message_reaction.cpython-311.pyc,, +aiogram/methods/__pycache__/set_my_commands.cpython-311.pyc,, +aiogram/methods/__pycache__/set_my_default_administrator_rights.cpython-311.pyc,, +aiogram/methods/__pycache__/set_my_description.cpython-311.pyc,, +aiogram/methods/__pycache__/set_my_name.cpython-311.pyc,, +aiogram/methods/__pycache__/set_my_short_description.cpython-311.pyc,, +aiogram/methods/__pycache__/set_passport_data_errors.cpython-311.pyc,, +aiogram/methods/__pycache__/set_sticker_emoji_list.cpython-311.pyc,, +aiogram/methods/__pycache__/set_sticker_keywords.cpython-311.pyc,, +aiogram/methods/__pycache__/set_sticker_mask_position.cpython-311.pyc,, +aiogram/methods/__pycache__/set_sticker_position_in_set.cpython-311.pyc,, +aiogram/methods/__pycache__/set_sticker_set_thumbnail.cpython-311.pyc,, +aiogram/methods/__pycache__/set_sticker_set_title.cpython-311.pyc,, +aiogram/methods/__pycache__/set_webhook.cpython-311.pyc,, +aiogram/methods/__pycache__/stop_message_live_location.cpython-311.pyc,, +aiogram/methods/__pycache__/stop_poll.cpython-311.pyc,, +aiogram/methods/__pycache__/unban_chat_member.cpython-311.pyc,, +aiogram/methods/__pycache__/unban_chat_sender_chat.cpython-311.pyc,, +aiogram/methods/__pycache__/unhide_general_forum_topic.cpython-311.pyc,, +aiogram/methods/__pycache__/unpin_all_chat_messages.cpython-311.pyc,, +aiogram/methods/__pycache__/unpin_all_forum_topic_messages.cpython-311.pyc,, +aiogram/methods/__pycache__/unpin_all_general_forum_topic_messages.cpython-311.pyc,, +aiogram/methods/__pycache__/unpin_chat_message.cpython-311.pyc,, +aiogram/methods/__pycache__/upload_sticker_file.cpython-311.pyc,, +aiogram/methods/add_sticker_to_set.py,sha256=PR2B-SDNNYLaH70oevadRNAoiUjFQXLffGSIhQ7uah4,1443 +aiogram/methods/answer_callback_query.py,sha256=YVozC3bMDE8YoH6x5TipzWiXCwdWLAU96GWOJTxf1AE,2903 +aiogram/methods/answer_inline_query.py,sha256=039jip6Ty3cdvEuYbfougTO-DZIzi1f5hisl6yRg8qw,6017 +aiogram/methods/answer_pre_checkout_query.py,sha256=5peOULN2DO0VoK3nEAnsN-E9RWAH5ab64UUc-4apRHk,2172 +aiogram/methods/answer_shipping_query.py,sha256=oiq-B_Go-J_sRalwvgyFjUUZDEF1MX5IGNKV6khU0N8,2254 +aiogram/methods/answer_web_app_query.py,sha256=AXM-hDf_xIarwburmGT27ZoKFoGsbcVbPNM_EHUHKVo,3676 +aiogram/methods/approve_chat_join_request.py,sha256=KUetMV7jHSB9_v702JlSI-CVlJMHUCNstvjUC0GU3i4,1281 +aiogram/methods/ban_chat_member.py,sha256=hfHkT_Ucg-26oVtvRQwGvijDMn7uaV84agEY7vIEp-E,2481 +aiogram/methods/ban_chat_sender_chat.py,sha256=rr77ixJufnD9bWevxTaSHCcJVh3lIf19JGLEctMMm7A,1569 +aiogram/methods/base.py,sha256=VH-3rKUGvNYoiQ9Tw78FujrzlJLs9smBhmI8ejx3-2Y,2734 +aiogram/methods/close.py,sha256=Bnzle__tO6tCMMLHkN1E00ypkrdQ0RjhkBNxhjDOq3k,593 +aiogram/methods/close_forum_topic.py,sha256=njPMjFb7CkLYbjEuNWPrSDh2HSpqlmO76B9Xs_Xahco,1475 +aiogram/methods/close_general_forum_topic.py,sha256=lLWx-ZgE4eV15D2yLXg1wWVECfcN7_1y2XA5vqr1d84,1223 +aiogram/methods/copy_message.py,sha256=jvPiwstYa8Lt0XNeI15_HyrwAvnPdgmi0KJZI3GuXOs,6109 +aiogram/methods/copy_messages.py,sha256=PbxTovACFr7NM8Te3iN2tq7VLLKvxGDzr_Gp8hrjukA,3293 +aiogram/methods/create_chat_invite_link.py,sha256=Snalw6e_zk5g5FI2wKB4Pr0qbGS1PbjIcq7567RC5YE,2545 +aiogram/methods/create_chat_subscription_invite_link.py,sha256=ulylrmNJXJa7hipKx7j_2wOeZSVgufPaW2h5JFO2OIw,2508 +aiogram/methods/create_forum_topic.py,sha256=FuJ8R-jkpfk7hPKe6pffiUQE21Hhh22G7cFMCFe5kok,2188 +aiogram/methods/create_invoice_link.py,sha256=PsgrJvP9W55DuTBmGut1puRNYQOuE6xvRHmblwv64lM,6655 +aiogram/methods/create_new_sticker_set.py,sha256=0LwiOVBGTo-sJLOd76Au3_G2-d6YtqFHfju6TU0A2vw,2928 +aiogram/methods/decline_chat_join_request.py,sha256=19Sj8OHe6erv3_E4p-Sw_y8XygNYOWrPI5S23CU5P1w,1281 +aiogram/methods/delete_chat_photo.py,sha256=0nrFbxWyO7R0pVMAWook7VRXAIU-AeEr_wpiFvyLssQ,1194 +aiogram/methods/delete_chat_sticker_set.py,sha256=KaRyvzLt1ystCbkptimtxqUM_4_RzpI7Sl91heSVlKc,1348 +aiogram/methods/delete_forum_topic.py,sha256=LrncMipGRW2Be4bYFzSYMjydvRijmPU5Owtmb61e374,1470 +aiogram/methods/delete_message.py,sha256=wCMd8oHwYETY1Nk2vP4DYhu-sdrm-LqhQBKPAgQQhSY,1956 +aiogram/methods/delete_messages.py,sha256=Hp9tfOVK4T9y3SuAAlfLo58_58CP83JWfpLnN3jkbiM,1401 +aiogram/methods/delete_my_commands.py,sha256=LiYVWXeqBxs_hUbq6pQ1h3zSKUyzw7ahdaXb1esAH8Q,2608 +aiogram/methods/delete_sticker_from_set.py,sha256=J2PsBRRTBks5TDlp4mlmubem7MSWKh8jzJMmLJQV9CI,944 +aiogram/methods/delete_sticker_set.py,sha256=csUT6RkdqmOy0K7vT2QXXR_YJfpQ78S31WYttFqEPY8,908 +aiogram/methods/delete_webhook.py,sha256=7kfmOOSlujfXV5JZEozbuQQzNrX5YV0f6nMvUo5aw_k,1155 +aiogram/methods/edit_chat_invite_link.py,sha256=N2RqH2DHbRK-zF97jtHlhMV2YykBgHgpqw_iDz8KQRw,2564 +aiogram/methods/edit_chat_subscription_invite_link.py,sha256=AvDlMClqa00KJnf4sXZkdOYGBErGtuwLMeHEM0AND5E,1610 +aiogram/methods/edit_forum_topic.py,sha256=hELFkBuB_6I3_y2xencOolPXPUjEK3xXCgfzC4lAuCA,2195 +aiogram/methods/edit_general_forum_topic.py,sha256=PK37qgJRVISQWhYAWlg3LNGmgneVdQxpJCa1dMiq_uY,1306 +aiogram/methods/edit_message_caption.py,sha256=wv-USNcfyHIjskv6PaSQAABE9yDK8lr9lgDS5yBfiVM,3995 +aiogram/methods/edit_message_live_location.py,sha256=akOy16TytMIR1ONYR8lu8W48HplUl9ugqW-tttrn2Zk,4205 +aiogram/methods/edit_message_media.py,sha256=fjDjBVQ6jbHoSDsxX3_19Q_TF-WzACaItS4gfdKtGuw,3529 +aiogram/methods/edit_message_reply_markup.py,sha256=H5elelToPCzLoOsGDDfOa7nXRQ10AMhxP13quMGRt1k,2658 +aiogram/methods/edit_message_text.py,sha256=IQPTgqWDn-xK5L7hjJ3FOhJqe8DJC9uRnnVWE-gmWcs,4345 +aiogram/methods/export_chat_invite_link.py,sha256=oC00_UAsmJ7icNtjmnCbQ9sYyJLoOujNJsLIRMyx9qg,1792 +aiogram/methods/forward_message.py,sha256=KM6v9CrqMnwC0YLgiIEVxTFBUmb5GhFfAMycrxY0IJ4,2655 +aiogram/methods/forward_messages.py,sha256=BIUEDoLp8jD5YglFN2pbHp6FtuhMFMB1VCSzMPhtOPs,2774 +aiogram/methods/get_business_connection.py,sha256=wJhKMcBoLcOXTxK1_xG8SR2h85e1sW1C4sWD6L6bTTM,1200 +aiogram/methods/get_chat.py,sha256=yOPjLV12HVZOk6ch2bUOfyrZBPIhyAXhhHEhiZKEdro,1145 +aiogram/methods/get_chat_administrators.py,sha256=uxzQWmNc0EJRJ-c0ecJmjLPWDOwlMD1KWDiOAnqofxs,1815 +aiogram/methods/get_chat_member.py,sha256=pltcJQL_aSljObA_XAVa9chzyC5saahC-jCA85U0Z_E,1857 +aiogram/methods/get_chat_member_count.py,sha256=phZ05LJUn3EAXBuH_7HqMFOuTg99nyVNjNEVWry1sto,1067 +aiogram/methods/get_chat_menu_button.py,sha256=Ko5U5PMvTP08x8SkCUddFASaGr-LbtP_4GhvbM-TP7c,1362 +aiogram/methods/get_custom_emoji_stickers.py,sha256=ob0rvnUFtuDlZ6GmNHlFZH2hNZNITf2k0mjBBvmeNY0,1201 +aiogram/methods/get_file.py,sha256=FutkpYaOz_xjdU_1FwGY75ZYZ-uqBCZapZBiE5K9sC0,1571 +aiogram/methods/get_forum_topic_icon_stickers.py,sha256=TUAX41OPjlluu3zxI-_lYCzBHzX-Wa_Fgde727H4llg,557 +aiogram/methods/get_game_high_scores.py,sha256=IhEZ81rRGOh_pkq54qGys0RGoywhTG7I5UdYikoVS8A,2156 +aiogram/methods/get_me.py,sha256=gA4vD-v3WYPpZaSTy6mpGZmsV5WXdSHv06EymV9ZQnU,439 +aiogram/methods/get_my_commands.py,sha256=67G3OlYrwZAnQZM8D2nQwNwEhPB1siDqOvMkc9saSgo,2464 +aiogram/methods/get_my_default_administrator_rights.py,sha256=dw1MnQACVfVsQeYs5ikZG1jThB15HR8Trv1xHg_oSLY,1359 +aiogram/methods/get_my_description.py,sha256=UzgJhr6sl4i4RD9LIYxvTx4z4V3cZMGQavCFucWwv1I,1156 +aiogram/methods/get_my_name.py,sha256=GGY2ZnZ_uXL5GqRKHJ2uXs5v_LUBqg6yx0NdrBLZoy8,1057 +aiogram/methods/get_my_short_description.py,sha256=yRQ0ertSdcbEy32FC07FAo12q7eyLEN04h0gkxzpmGE,1203 +aiogram/methods/get_star_transactions.py,sha256=kCp-vAuYCbogKN6PQ4_ulx4ByBatWbMwuXUTsMib22M,1374 +aiogram/methods/get_sticker_set.py,sha256=oh9jEInEgKDfOhAu58ex4rUYRCJCk-BTsOAvNa7GPMg,965 +aiogram/methods/get_updates.py,sha256=dMl44T18fGWKDG2ZK-GQ2OJu7PIYe3GJ93IzX26LXqs,3024 +aiogram/methods/get_user_chat_boosts.py,sha256=2HYUsuZMxrP-YdZO7S4rX0QItzjUN8H01mmwvm2SSkc,1255 +aiogram/methods/get_user_profile_photos.py,sha256=URseFqr69kRj4-gqNkSl4TsiEaAK78iAyjYrTv4tCpA,1507 +aiogram/methods/get_webhook_info.py,sha256=8h38GW1au2fAZau2qmXuOnmu-H6kIjXQEms3VKLJf5c,576 +aiogram/methods/hide_general_forum_topic.py,sha256=dKPkMB4okbduRG9K-Mah5hf6OsKzGg8NrtnTQdcVu78,1270 +aiogram/methods/leave_chat.py,sha256=m3F4mKwOmJaxk958rbBZqGIRcM7007JMce1S2zpEvPY,1063 +aiogram/methods/log_out.py,sha256=yBkCbabI7CRBkTHwhJ61KmqazMxiUuGRMhxlzl7BWB4,660 +aiogram/methods/pin_chat_message.py,sha256=njAbF_yEAZobt9b-0CqxblQpJ2M-jAgZHDpKdw_THAI,2143 +aiogram/methods/promote_chat_member.py,sha256=BDT9L1MIVTwWrmph-HUe0Rh7kKMPQt4bkMkICPiDfgE,5568 +aiogram/methods/refund_star_payment.py,sha256=s-eELWhpYoE8ubWNvlYc0dmPGCcBiATS0fU50IXXZ5g,1264 +aiogram/methods/reopen_forum_topic.py,sha256=TfJtX4zGVNYjjhivHRwBFV9sbWINhr8k_q5lXoLtITw,1480 +aiogram/methods/reopen_general_forum_topic.py,sha256=kxJtoOauJNWYxqesoT6qeDvXAJujUZvK-3QO5lnFEw8,1287 +aiogram/methods/replace_sticker_in_set.py,sha256=df80oQuwZsYrbmUixIPxtQ75iUqIMZXsiIyoMZHious,1858 +aiogram/methods/restrict_chat_member.py,sha256=KFAtkHVDqA4Ny4quy1jCnqH1mxf_5kSo8kDlA_ben4Q,2751 +aiogram/methods/revoke_chat_invite_link.py,sha256=RrIN4jcxTHaoThF0Dru3d4z7RGEQk0u0cTkNx13Do-s,1526 +aiogram/methods/send_animation.py,sha256=axQu7PxIUqpMtxCJH-7-5aUxzTl1UnUexDMkXXzRK3c,7678 +aiogram/methods/send_audio.py,sha256=6SrnsKd4smXuDLR3PfpgV9gf2TXBb42GtBxJGt6jeBY,7134 +aiogram/methods/send_chat_action.py,sha256=sOrGWv2bA9Przot-gPT1ksZ8UEhPpJeEsd7tPd-06gg,3187 +aiogram/methods/send_contact.py,sha256=zyup2lC1OQ94IXs1yW0Or4j8SaAqUe_a_AVTIE1rlJs,5053 +aiogram/methods/send_dice.py,sha256=v4j0-lETnu_rjj8oD3KdvOwMUh_IkXXcnWJW7jZmg-E,4823 +aiogram/methods/send_document.py,sha256=-ANAOHscFJhk3Y0LfmvAO_1_u3BUhEdBQ3YYafc5u64,6886 +aiogram/methods/send_game.py,sha256=gtcKxuwixa1N3JXOY8bLqCuvQ30QYrhi89VChwRTDmU,4243 +aiogram/methods/send_invoice.py,sha256=grSq2uQhWGWI4VLTCVBsuzbkrnrOkLAlBALUb8NLmbE,10135 +aiogram/methods/send_location.py,sha256=52UX5uvJBNfA80CEdmSEPTAmymurXXkYeEPXNitaY38,5851 +aiogram/methods/send_media_group.py,sha256=C67CTZUPPgqrDLGwP1mxzREridLXhBMpVKyfzL2wS-c,4430 +aiogram/methods/send_message.py,sha256=pMW81tP9p21i6iMo_KWYBhgy_uM2k_oa1_7kLQ81HN4,6112 +aiogram/methods/send_paid_media.py,sha256=Wf66l54kgMqWGTfMioVe0xdS-P3x2NQ4MpZkcHfson0,4658 +aiogram/methods/send_photo.py,sha256=2mN1S3ppYKaTzs6omllqGEZiRbd7Hx3XD5V1fxiOdwo,6492 +aiogram/methods/send_poll.py,sha256=_ATWrR7o6OeI8bllk83HRsG24-8w7TQzif3qpxFxYrs,8387 +aiogram/methods/send_sticker.py,sha256=mfqQAqLimwwNMhWwqokA7SQoNV17z1_cO-SiBBZFHAU,5284 +aiogram/methods/send_venue.py,sha256=rYIxNQbd_fZJybWLcFS4OmbE2EYvKrReqQyegMpNoxo,5820 +aiogram/methods/send_video.py,sha256=LfebSy4ucxxQi-euGGfTpXfLjWfn_AcCN7NkUh76tbk,7894 +aiogram/methods/send_video_note.py,sha256=dAXiWtv1hngrGQONybstfrC_Q29po0BpKHuVzGKx9I4,6038 +aiogram/methods/send_voice.py,sha256=Dk-oqbTfs_ZAHLpAyFgDlKd2sU0IVc8-8JAitlVNKRA,6282 +aiogram/methods/set_chat_administrator_custom_title.py,sha256=lOizk5Z8-tUh6EOiZ2hRyVSUrP2qQzDHlcKIbJCKgSg,1490 +aiogram/methods/set_chat_description.py,sha256=AvzTU_XRaTuI9s9iKX_hihCLpsH4F8du3dBQ-wrNZnU,1407 +aiogram/methods/set_chat_menu_button.py,sha256=5y8sOvgs6cH4sWBa_NuBnsRH7sE8ch0_s4YygG1PbZY,1622 +aiogram/methods/set_chat_permissions.py,sha256=x42Gmf910ycY0Nf5lCnM1Xe6z5bhjNqUMHA673X1J_A,2159 +aiogram/methods/set_chat_photo.py,sha256=kHjTl8U-i5B03KaFIEKxQnT8Sgl8CAa_F9kQeFUW_9M,1394 +aiogram/methods/set_chat_sticker_set.py,sha256=RFNtIcj8Lq8It6L6qoJLCk247RYVgGROdJM5UoF0HSQ,1571 +aiogram/methods/set_chat_title.py,sha256=X21F3pX37t3z13-4o6WJfQHKVfLPr8c_HGO-vNqI3k0,1275 +aiogram/methods/set_custom_emoji_sticker_set_thumbnail.py,sha256=E8zURRFNnJnjzxVnYchBta807eCrarjMzpKWp0R5Ypg,1309 +aiogram/methods/set_game_score.py,sha256=RDiYH61W1aN6WZoRLKI_vDQJz8-7V1I8tP__UbZLw1s,2626 +aiogram/methods/set_message_reaction.py,sha256=bEK822WDw3OqvO99WU3IV543yYI7tWpA-mIJVgv2rGg,2457 +aiogram/methods/set_my_commands.py,sha256=sjd1da-uPfDIH0OGTpuyZzBl8ARwbWPiMoAHenQc530,2803 +aiogram/methods/set_my_default_administrator_rights.py,sha256=DKX3KXLXbfv-heE5uJfPbcFXQRvNG6ps3ih1bQNa5RY,1750 +aiogram/methods/set_my_description.py,sha256=ww9IAjtC4X6Ti9cFlnE3dleZ_FKE6byjblGUYn2EqwI,1489 +aiogram/methods/set_my_name.py,sha256=xqSgEYS3Rgr2ETQlvBuD_VopBsuDX_DZY_MnbsOoJgs,1274 +aiogram/methods/set_my_short_description.py,sha256=ONiD6HfZxxnHRjPstEmuBqedjQVjZ-lSJPY14sTRPyc,1639 +aiogram/methods/set_passport_data_errors.py,sha256=Z4SjM_CHHzXw_SQ5TsIFXvsrI5GTrgx0xO0kKrtnE7c,2922 +aiogram/methods/set_sticker_emoji_list.py,sha256=rgUpD35X_QHAJmIbdgRBsXtF4p-wQcuRFFYmNBjDPpo,1201 +aiogram/methods/set_sticker_keywords.py,sha256=usS8uLY4YghFWwNyJnpG9C5X9eRQ1PzGWfIxSKhPTOg,1320 +aiogram/methods/set_sticker_mask_position.py,sha256=eoT5D9VmWuRNsUqyzrHlYWd_bVaK583o3hP_KsoevaI,1450 +aiogram/methods/set_sticker_position_in_set.py,sha256=QJI3x-tobyjpFoEThjcqGQLjXWdCZTd59ei49Gi2Mcg,1100 +aiogram/methods/set_sticker_set_thumbnail.py,sha256=l6hozWYpPQI-Y-QI2YxyXopG8ZXzGme-q2vdl4SUJvk,2891 +aiogram/methods/set_sticker_set_title.py,sha256=kf1H5K3capHR5wlu91DXmP6Q1G_TG_AEJeivppuM-58,1011 +aiogram/methods/set_webhook.py,sha256=5mPLVBDfSDbw2BEsSThw6wfErFTta_55UtyisYA4o1k,4476 +aiogram/methods/stop_message_live_location.py,sha256=ZvsRZ_qADXt3Oxxk8-6nvOAHT5b-yL2v4isAxNChE7M,2539 +aiogram/methods/stop_poll.py,sha256=xs5Bhzdwrny9CueVr1qfe6lOWjPqKoS8te9PYvpTZs4,1933 +aiogram/methods/unban_chat_member.py,sha256=kCOiIN03O3RZG4esxneAnt87-iC24TKqW4FeAOcBPCY,1919 +aiogram/methods/unban_chat_sender_chat.py,sha256=JwiCTYpl797vXH1iKEmHdvngNgmN3N5MzTM6Bd5QI3o,1376 +aiogram/methods/unhide_general_forum_topic.py,sha256=vDxVKNhnBifPmhBxDtIgEGq9DLw5U0E-HUPoIVOEL_I,1223 +aiogram/methods/unpin_all_chat_messages.py,sha256=1eYhMh4IsLV4x94XEC7oJkkFeiwe1LSpr_sj2ywyvUY,1303 +aiogram/methods/unpin_all_forum_topic_messages.py,sha256=RDUz0D8kSuayzY0DU0DVo6ez2dUH8VdqBmTSthCECCc,1489 +aiogram/methods/unpin_all_general_forum_topic_messages.py,sha256=O_PhZuwarHW9I2iFIHggOqgc7QfXtF1GEqZYweOH5PA,1248 +aiogram/methods/unpin_chat_message.py,sha256=9iiJcGt8sU1vYKKeMGpk7KgMvTXnLysywExpsjWckgs,1978 +aiogram/methods/upload_sticker_file.py,sha256=TgGArcP8fVpAOM7GRmpbk7GO3sKn2PfBEV--WOo0NKo,1951 +aiogram/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +aiogram/types/__init__.py,sha256=YUQNYA592qPfHdhV_Lv90St1aCXLaMYyzOm-QQhLcNw,18420 +aiogram/types/__pycache__/__init__.cpython-311.pyc,, +aiogram/types/__pycache__/animation.cpython-311.pyc,, +aiogram/types/__pycache__/audio.cpython-311.pyc,, +aiogram/types/__pycache__/background_fill.cpython-311.pyc,, +aiogram/types/__pycache__/background_fill_freeform_gradient.cpython-311.pyc,, +aiogram/types/__pycache__/background_fill_gradient.cpython-311.pyc,, +aiogram/types/__pycache__/background_fill_solid.cpython-311.pyc,, +aiogram/types/__pycache__/background_type.cpython-311.pyc,, +aiogram/types/__pycache__/background_type_chat_theme.cpython-311.pyc,, +aiogram/types/__pycache__/background_type_fill.cpython-311.pyc,, +aiogram/types/__pycache__/background_type_pattern.cpython-311.pyc,, +aiogram/types/__pycache__/background_type_wallpaper.cpython-311.pyc,, +aiogram/types/__pycache__/base.cpython-311.pyc,, +aiogram/types/__pycache__/birthdate.cpython-311.pyc,, +aiogram/types/__pycache__/bot_command.cpython-311.pyc,, +aiogram/types/__pycache__/bot_command_scope.cpython-311.pyc,, +aiogram/types/__pycache__/bot_command_scope_all_chat_administrators.cpython-311.pyc,, +aiogram/types/__pycache__/bot_command_scope_all_group_chats.cpython-311.pyc,, +aiogram/types/__pycache__/bot_command_scope_all_private_chats.cpython-311.pyc,, +aiogram/types/__pycache__/bot_command_scope_chat.cpython-311.pyc,, +aiogram/types/__pycache__/bot_command_scope_chat_administrators.cpython-311.pyc,, +aiogram/types/__pycache__/bot_command_scope_chat_member.cpython-311.pyc,, +aiogram/types/__pycache__/bot_command_scope_default.cpython-311.pyc,, +aiogram/types/__pycache__/bot_description.cpython-311.pyc,, +aiogram/types/__pycache__/bot_name.cpython-311.pyc,, +aiogram/types/__pycache__/bot_short_description.cpython-311.pyc,, +aiogram/types/__pycache__/business_connection.cpython-311.pyc,, +aiogram/types/__pycache__/business_intro.cpython-311.pyc,, +aiogram/types/__pycache__/business_location.cpython-311.pyc,, +aiogram/types/__pycache__/business_messages_deleted.cpython-311.pyc,, +aiogram/types/__pycache__/business_opening_hours.cpython-311.pyc,, +aiogram/types/__pycache__/business_opening_hours_interval.cpython-311.pyc,, +aiogram/types/__pycache__/callback_game.cpython-311.pyc,, +aiogram/types/__pycache__/callback_query.cpython-311.pyc,, +aiogram/types/__pycache__/chat.cpython-311.pyc,, +aiogram/types/__pycache__/chat_administrator_rights.cpython-311.pyc,, +aiogram/types/__pycache__/chat_background.cpython-311.pyc,, +aiogram/types/__pycache__/chat_boost.cpython-311.pyc,, +aiogram/types/__pycache__/chat_boost_added.cpython-311.pyc,, +aiogram/types/__pycache__/chat_boost_removed.cpython-311.pyc,, +aiogram/types/__pycache__/chat_boost_source.cpython-311.pyc,, +aiogram/types/__pycache__/chat_boost_source_gift_code.cpython-311.pyc,, +aiogram/types/__pycache__/chat_boost_source_giveaway.cpython-311.pyc,, +aiogram/types/__pycache__/chat_boost_source_premium.cpython-311.pyc,, +aiogram/types/__pycache__/chat_boost_updated.cpython-311.pyc,, +aiogram/types/__pycache__/chat_full_info.cpython-311.pyc,, +aiogram/types/__pycache__/chat_invite_link.cpython-311.pyc,, +aiogram/types/__pycache__/chat_join_request.cpython-311.pyc,, +aiogram/types/__pycache__/chat_location.cpython-311.pyc,, +aiogram/types/__pycache__/chat_member.cpython-311.pyc,, +aiogram/types/__pycache__/chat_member_administrator.cpython-311.pyc,, +aiogram/types/__pycache__/chat_member_banned.cpython-311.pyc,, +aiogram/types/__pycache__/chat_member_left.cpython-311.pyc,, +aiogram/types/__pycache__/chat_member_member.cpython-311.pyc,, +aiogram/types/__pycache__/chat_member_owner.cpython-311.pyc,, +aiogram/types/__pycache__/chat_member_restricted.cpython-311.pyc,, +aiogram/types/__pycache__/chat_member_updated.cpython-311.pyc,, +aiogram/types/__pycache__/chat_permissions.cpython-311.pyc,, +aiogram/types/__pycache__/chat_photo.cpython-311.pyc,, +aiogram/types/__pycache__/chat_shared.cpython-311.pyc,, +aiogram/types/__pycache__/chosen_inline_result.cpython-311.pyc,, +aiogram/types/__pycache__/contact.cpython-311.pyc,, +aiogram/types/__pycache__/custom.cpython-311.pyc,, +aiogram/types/__pycache__/dice.cpython-311.pyc,, +aiogram/types/__pycache__/document.cpython-311.pyc,, +aiogram/types/__pycache__/downloadable.cpython-311.pyc,, +aiogram/types/__pycache__/encrypted_credentials.cpython-311.pyc,, +aiogram/types/__pycache__/encrypted_passport_element.cpython-311.pyc,, +aiogram/types/__pycache__/error_event.cpython-311.pyc,, +aiogram/types/__pycache__/external_reply_info.cpython-311.pyc,, +aiogram/types/__pycache__/file.cpython-311.pyc,, +aiogram/types/__pycache__/force_reply.cpython-311.pyc,, +aiogram/types/__pycache__/forum_topic.cpython-311.pyc,, +aiogram/types/__pycache__/forum_topic_closed.cpython-311.pyc,, +aiogram/types/__pycache__/forum_topic_created.cpython-311.pyc,, +aiogram/types/__pycache__/forum_topic_edited.cpython-311.pyc,, +aiogram/types/__pycache__/forum_topic_reopened.cpython-311.pyc,, +aiogram/types/__pycache__/game.cpython-311.pyc,, +aiogram/types/__pycache__/game_high_score.cpython-311.pyc,, +aiogram/types/__pycache__/general_forum_topic_hidden.cpython-311.pyc,, +aiogram/types/__pycache__/general_forum_topic_unhidden.cpython-311.pyc,, +aiogram/types/__pycache__/giveaway.cpython-311.pyc,, +aiogram/types/__pycache__/giveaway_completed.cpython-311.pyc,, +aiogram/types/__pycache__/giveaway_created.cpython-311.pyc,, +aiogram/types/__pycache__/giveaway_winners.cpython-311.pyc,, +aiogram/types/__pycache__/inaccessible_message.cpython-311.pyc,, +aiogram/types/__pycache__/inline_keyboard_button.cpython-311.pyc,, +aiogram/types/__pycache__/inline_keyboard_markup.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_article.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_audio.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_cached_audio.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_cached_document.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_cached_gif.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_cached_mpeg4_gif.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_cached_photo.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_cached_sticker.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_cached_video.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_cached_voice.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_contact.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_document.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_game.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_gif.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_location.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_mpeg4_gif.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_photo.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_venue.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_video.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_result_voice.cpython-311.pyc,, +aiogram/types/__pycache__/inline_query_results_button.cpython-311.pyc,, +aiogram/types/__pycache__/input_contact_message_content.cpython-311.pyc,, +aiogram/types/__pycache__/input_file.cpython-311.pyc,, +aiogram/types/__pycache__/input_invoice_message_content.cpython-311.pyc,, +aiogram/types/__pycache__/input_location_message_content.cpython-311.pyc,, +aiogram/types/__pycache__/input_media.cpython-311.pyc,, +aiogram/types/__pycache__/input_media_animation.cpython-311.pyc,, +aiogram/types/__pycache__/input_media_audio.cpython-311.pyc,, +aiogram/types/__pycache__/input_media_document.cpython-311.pyc,, +aiogram/types/__pycache__/input_media_photo.cpython-311.pyc,, +aiogram/types/__pycache__/input_media_video.cpython-311.pyc,, +aiogram/types/__pycache__/input_message_content.cpython-311.pyc,, +aiogram/types/__pycache__/input_paid_media.cpython-311.pyc,, +aiogram/types/__pycache__/input_paid_media_photo.cpython-311.pyc,, +aiogram/types/__pycache__/input_paid_media_video.cpython-311.pyc,, +aiogram/types/__pycache__/input_poll_option.cpython-311.pyc,, +aiogram/types/__pycache__/input_sticker.cpython-311.pyc,, +aiogram/types/__pycache__/input_text_message_content.cpython-311.pyc,, +aiogram/types/__pycache__/input_venue_message_content.cpython-311.pyc,, +aiogram/types/__pycache__/invoice.cpython-311.pyc,, +aiogram/types/__pycache__/keyboard_button.cpython-311.pyc,, +aiogram/types/__pycache__/keyboard_button_poll_type.cpython-311.pyc,, +aiogram/types/__pycache__/keyboard_button_request_chat.cpython-311.pyc,, +aiogram/types/__pycache__/keyboard_button_request_user.cpython-311.pyc,, +aiogram/types/__pycache__/keyboard_button_request_users.cpython-311.pyc,, +aiogram/types/__pycache__/labeled_price.cpython-311.pyc,, +aiogram/types/__pycache__/link_preview_options.cpython-311.pyc,, +aiogram/types/__pycache__/location.cpython-311.pyc,, +aiogram/types/__pycache__/login_url.cpython-311.pyc,, +aiogram/types/__pycache__/mask_position.cpython-311.pyc,, +aiogram/types/__pycache__/maybe_inaccessible_message.cpython-311.pyc,, +aiogram/types/__pycache__/menu_button.cpython-311.pyc,, +aiogram/types/__pycache__/menu_button_commands.cpython-311.pyc,, +aiogram/types/__pycache__/menu_button_default.cpython-311.pyc,, +aiogram/types/__pycache__/menu_button_web_app.cpython-311.pyc,, +aiogram/types/__pycache__/message.cpython-311.pyc,, +aiogram/types/__pycache__/message_auto_delete_timer_changed.cpython-311.pyc,, +aiogram/types/__pycache__/message_entity.cpython-311.pyc,, +aiogram/types/__pycache__/message_id.cpython-311.pyc,, +aiogram/types/__pycache__/message_origin.cpython-311.pyc,, +aiogram/types/__pycache__/message_origin_channel.cpython-311.pyc,, +aiogram/types/__pycache__/message_origin_chat.cpython-311.pyc,, +aiogram/types/__pycache__/message_origin_hidden_user.cpython-311.pyc,, +aiogram/types/__pycache__/message_origin_user.cpython-311.pyc,, +aiogram/types/__pycache__/message_reaction_count_updated.cpython-311.pyc,, +aiogram/types/__pycache__/message_reaction_updated.cpython-311.pyc,, +aiogram/types/__pycache__/order_info.cpython-311.pyc,, +aiogram/types/__pycache__/paid_media.cpython-311.pyc,, +aiogram/types/__pycache__/paid_media_info.cpython-311.pyc,, +aiogram/types/__pycache__/paid_media_photo.cpython-311.pyc,, +aiogram/types/__pycache__/paid_media_preview.cpython-311.pyc,, +aiogram/types/__pycache__/paid_media_video.cpython-311.pyc,, +aiogram/types/__pycache__/passport_data.cpython-311.pyc,, +aiogram/types/__pycache__/passport_element_error.cpython-311.pyc,, +aiogram/types/__pycache__/passport_element_error_data_field.cpython-311.pyc,, +aiogram/types/__pycache__/passport_element_error_file.cpython-311.pyc,, +aiogram/types/__pycache__/passport_element_error_files.cpython-311.pyc,, +aiogram/types/__pycache__/passport_element_error_front_side.cpython-311.pyc,, +aiogram/types/__pycache__/passport_element_error_reverse_side.cpython-311.pyc,, +aiogram/types/__pycache__/passport_element_error_selfie.cpython-311.pyc,, +aiogram/types/__pycache__/passport_element_error_translation_file.cpython-311.pyc,, +aiogram/types/__pycache__/passport_element_error_translation_files.cpython-311.pyc,, +aiogram/types/__pycache__/passport_element_error_unspecified.cpython-311.pyc,, +aiogram/types/__pycache__/passport_file.cpython-311.pyc,, +aiogram/types/__pycache__/photo_size.cpython-311.pyc,, +aiogram/types/__pycache__/poll.cpython-311.pyc,, +aiogram/types/__pycache__/poll_answer.cpython-311.pyc,, +aiogram/types/__pycache__/poll_option.cpython-311.pyc,, +aiogram/types/__pycache__/pre_checkout_query.cpython-311.pyc,, +aiogram/types/__pycache__/proximity_alert_triggered.cpython-311.pyc,, +aiogram/types/__pycache__/reaction_count.cpython-311.pyc,, +aiogram/types/__pycache__/reaction_type.cpython-311.pyc,, +aiogram/types/__pycache__/reaction_type_custom_emoji.cpython-311.pyc,, +aiogram/types/__pycache__/reaction_type_emoji.cpython-311.pyc,, +aiogram/types/__pycache__/reaction_type_paid.cpython-311.pyc,, +aiogram/types/__pycache__/refunded_payment.cpython-311.pyc,, +aiogram/types/__pycache__/reply_keyboard_markup.cpython-311.pyc,, +aiogram/types/__pycache__/reply_keyboard_remove.cpython-311.pyc,, +aiogram/types/__pycache__/reply_parameters.cpython-311.pyc,, +aiogram/types/__pycache__/response_parameters.cpython-311.pyc,, +aiogram/types/__pycache__/revenue_withdrawal_state.cpython-311.pyc,, +aiogram/types/__pycache__/revenue_withdrawal_state_failed.cpython-311.pyc,, +aiogram/types/__pycache__/revenue_withdrawal_state_pending.cpython-311.pyc,, +aiogram/types/__pycache__/revenue_withdrawal_state_succeeded.cpython-311.pyc,, +aiogram/types/__pycache__/sent_web_app_message.cpython-311.pyc,, +aiogram/types/__pycache__/shared_user.cpython-311.pyc,, +aiogram/types/__pycache__/shipping_address.cpython-311.pyc,, +aiogram/types/__pycache__/shipping_option.cpython-311.pyc,, +aiogram/types/__pycache__/shipping_query.cpython-311.pyc,, +aiogram/types/__pycache__/star_transaction.cpython-311.pyc,, +aiogram/types/__pycache__/star_transactions.cpython-311.pyc,, +aiogram/types/__pycache__/sticker.cpython-311.pyc,, +aiogram/types/__pycache__/sticker_set.cpython-311.pyc,, +aiogram/types/__pycache__/story.cpython-311.pyc,, +aiogram/types/__pycache__/successful_payment.cpython-311.pyc,, +aiogram/types/__pycache__/switch_inline_query_chosen_chat.cpython-311.pyc,, +aiogram/types/__pycache__/text_quote.cpython-311.pyc,, +aiogram/types/__pycache__/transaction_partner.cpython-311.pyc,, +aiogram/types/__pycache__/transaction_partner_fragment.cpython-311.pyc,, +aiogram/types/__pycache__/transaction_partner_other.cpython-311.pyc,, +aiogram/types/__pycache__/transaction_partner_telegram_ads.cpython-311.pyc,, +aiogram/types/__pycache__/transaction_partner_user.cpython-311.pyc,, +aiogram/types/__pycache__/update.cpython-311.pyc,, +aiogram/types/__pycache__/user.cpython-311.pyc,, +aiogram/types/__pycache__/user_chat_boosts.cpython-311.pyc,, +aiogram/types/__pycache__/user_profile_photos.cpython-311.pyc,, +aiogram/types/__pycache__/user_shared.cpython-311.pyc,, +aiogram/types/__pycache__/users_shared.cpython-311.pyc,, +aiogram/types/__pycache__/venue.cpython-311.pyc,, +aiogram/types/__pycache__/video.cpython-311.pyc,, +aiogram/types/__pycache__/video_chat_ended.cpython-311.pyc,, +aiogram/types/__pycache__/video_chat_participants_invited.cpython-311.pyc,, +aiogram/types/__pycache__/video_chat_scheduled.cpython-311.pyc,, +aiogram/types/__pycache__/video_chat_started.cpython-311.pyc,, +aiogram/types/__pycache__/video_note.cpython-311.pyc,, +aiogram/types/__pycache__/voice.cpython-311.pyc,, +aiogram/types/__pycache__/web_app_data.cpython-311.pyc,, +aiogram/types/__pycache__/web_app_info.cpython-311.pyc,, +aiogram/types/__pycache__/webhook_info.cpython-311.pyc,, +aiogram/types/__pycache__/write_access_allowed.cpython-311.pyc,, +aiogram/types/animation.py,sha256=W9LGC1-JeWGolCU3OI1a3dXjtD5pCnaOd_J7ulWhau8,2673 +aiogram/types/audio.py,sha256=2WPtZmAQfW6ewCb6ozlcfXXZACQEX7c1MYTEVMAy9Lw,2823 +aiogram/types/background_fill.py,sha256=sJj85JGxTXOJVd_dq0jpgH5TbBPlvRKFNjk2CNoM5Bw,513 +aiogram/types/background_fill_freeform_gradient.py,sha256=R74cAjirD-pqisj3KiMKuQj5uALD7ZY5DagTNYZ18Xk,1207 +aiogram/types/background_fill_gradient.py,sha256=bSkNQPDrdWCrSIoCSBE3iFI3NaOAk2cktmLOFUbX2qA,1434 +aiogram/types/background_fill_solid.py,sha256=cL3N_tRhRdpM3rGYjHqh1c05Ys1_w5Sn5RVFX4Kzrhc,1022 +aiogram/types/background_type.py,sha256=_UKdw_LQfpR4z7W8wdtEmKV38EUlsSCheh0l4O0d90Y,540 +aiogram/types/background_type_chat_theme.py,sha256=1mylq_KCHfLYikVuv2FVNHTK-FivuOc3fIN16ThxGX0,1077 +aiogram/types/background_type_fill.py,sha256=P3mjIBc_oZspRCYLZvep1Tjx2F2r3Gz8QnK3ZhBRXr0,1656 +aiogram/types/background_type_pattern.py,sha256=7y5N7vxg4EauwCLqAf_7VjfYGcdDLWt5P2wieNZl9i4,2514 +aiogram/types/background_type_wallpaper.py,sha256=6uYeiZ4xQBTmJY0jCTeUFAj65Q872NZL7D2-WMeSLac,1868 +aiogram/types/base.py,sha256=ZAKfSk-DVyoBoYdyyZUTkoIKzuaj0kJS0ophsohsdI4,1762 +aiogram/types/birthdate.py,sha256=ev957uyU2tG4cRqQ838h8LHW0uIPFUu0TdC1YfL0mnY,1056 +aiogram/types/bot_command.py,sha256=rJuwZroECtHDZxhyv92K2vyTUlXdieXdCEhewEsIPk0,1017 +aiogram/types/bot_command_scope.py,sha256=rs7YoyRACVLm4tMMEQ01LM6ckWbF7o81edYEAnWXoyY,951 +aiogram/types/bot_command_scope_all_chat_administrators.py,sha256=3wvcWAh_yZADVbqPQD09kd1hyjmDL_KuoYR8us7A0jI,1311 +aiogram/types/bot_command_scope_all_group_chats.py,sha256=BElN12t3RwjYAFgo__K4PSUA5Mf0Vgzx6lzrhO1_kOY,1225 +aiogram/types/bot_command_scope_all_private_chats.py,sha256=1Ww3HUSSJINy4qNSqF5lybQJwWHpflhMM2So6EMplyg,1226 +aiogram/types/bot_command_scope_chat.py,sha256=chjf7klLRhCM8AB1xwkfkPfUXcw-_vnQekRVkiIB1Rs,1327 +aiogram/types/bot_command_scope_chat_administrators.py,sha256=ezkiv48UyMIlKyZXvmlmsLi9cop5pk6cZW6FLgFJr-E,1518 +aiogram/types/bot_command_scope_chat_member.py,sha256=IvFP2cemuZtMFdIn7T7hfo4o4-35_1ZBTOHV5pARCQI,1513 +aiogram/types/bot_command_scope_default.py,sha256=Aqa5eiFS2_2rd8S19i7qfBPIk8TNPVdOEOMR1oSPMuI,1270 +aiogram/types/bot_description.py,sha256=daKHDJ4d2c9j7wCTKwDLgbXy1HNrjbYkZkwC9D7FiPQ,781 +aiogram/types/bot_name.py,sha256=ut3sf9j5LYd2xki-_pZ1lnVvN7HOUr6v37llIi75j6w,717 +aiogram/types/bot_short_description.py,sha256=UdHLoRvp1hdhEg-W1XYUoDwPeCxvuU2H430JrNDiY4U,849 +aiogram/types/business_connection.py,sha256=B3LuYw0bZwli2E2d6L9CGE_Rm1IvnzpD0RyCmZWxljU,2056 +aiogram/types/business_intro.py,sha256=TTTNSlPX-bvzbDqKd-YzwXaUjgznpZxnBDGtAKpmSBc,1303 +aiogram/types/business_location.py,sha256=OHFm2V3jLoRWJdXS3ubflMjFGd2Wo6sMhMhvsHbJUUY,1103 +aiogram/types/business_messages_deleted.py,sha256=AZvMF6tTIcq1pRoY2lHE8VPNJ26l5lgaeXLZ0rwZEq0,1478 +aiogram/types/business_opening_hours.py,sha256=R0il4hXIel_WWaB0DZUR3lgd816IDxXZFwmEi04glSE,1282 +aiogram/types/business_opening_hours_interval.py,sha256=NFi-_QWLEN_0D1fPpqqp2TlrdWBJ71Rz7c4P-lSWj9Y,1329 +aiogram/types/callback_game.py,sha256=AF-WqkqFcC6nG_tKoNX1sRjRiKEstbEFJfLy4NPKtRQ,298 +aiogram/types/callback_query.py,sha256=JBnbrz0j0C6zK1eMeCgQ7l28ytKVxxkExVbwDsc2u4Y,6017 +aiogram/types/chat.py,sha256=LnnFHYcYdWkXZ3KNIedhnXpqbt_d_jDoan2fQdATNpA,64452 +aiogram/types/chat_administrator_rights.py,sha256=xwIgM6y2daN5FSYNJagmhBtgEy88S9GTSQk_OWgrykU,4578 +aiogram/types/chat_background.py,sha256=tGylRgxxa5pMDsuQFkG2XrY7mKQCsA9lc-BsaArwXEE,1400 +aiogram/types/chat_boost.py,sha256=iAbDstYKPATDpf9C0UTaeeipi1kcFedXhiTC6INxEuQ,1879 +aiogram/types/chat_boost_added.py,sha256=4WPPng6cqzhb0qpepGeu4mAoga2ieA2vmqIxWQR5n-A,811 +aiogram/types/chat_boost_removed.py,sha256=phu1WXsR6noLlEuiwyF1S0HzlwDmFsk2vwc9TRJ00K0,1768 +aiogram/types/chat_boost_source.py,sha256=-s9Um1lFg4ab2MiQpb1SpJlKM2hJHZkpM43TQE6GEMo,476 +aiogram/types/chat_boost_source_gift_code.py,sha256=VkPQktCIZdyI7wvhR-c7hgDs8lI2XySv_tCX1IJoFDc,1378 +aiogram/types/chat_boost_source_giveaway.py,sha256=ncM8YI0ra6Jb_cDeOFFfm1l0sDwaZT4TNVGbFbas6Zo,1976 +aiogram/types/chat_boost_source_premium.py,sha256=nN3o9Kvt5JHXcp1RpYq1WDX8Szzn9so1-FgGR1Olf38,1278 +aiogram/types/chat_boost_updated.py,sha256=L0LKL6jutsHYPbCDQoXHaZVjIS5y7uIDXlacKNIFvE0,1002 +aiogram/types/chat_full_info.py,sha256=gYA2B-STpK5Iz3sGxlKYBdJ1tDJNNC_LgJbJGI47dlY,13713 +aiogram/types/chat_invite_link.py,sha256=BBsofu3IJb7dpZvZHnZNStaaVWYhb8Bn9AhMq6jc_d4,2638 +aiogram/types/chat_join_request.py,sha256=IeM2JRKIMVyVBXA1309TLoNuBo-ExjIbkNJL53YUYeU,171076 +aiogram/types/chat_location.py,sha256=qZUA9NnQBDCHRLvKDP1Oo0wDX5T5tw-j14-NX8tlXSM,1062 +aiogram/types/chat_member.py,sha256=sq0RhcwghiW4Gy9XJTskFA3dHxaol5EA5Oify1QJfz4,722 +aiogram/types/chat_member_administrator.py,sha256=d7se9Lm1AWDuZRNYGbK3ZLC2NkZVkSzegziJ0Lx66Qc,5453 +aiogram/types/chat_member_banned.py,sha256=bvvMSTPn4iNy6N5nGoPYoxR3pjqDZhFFqvGC_Jb1T3M,1500 +aiogram/types/chat_member_left.py,sha256=YhW1LjLUG5TDTARmj44DaJ0OyX2Gm8CW9-K6EA7LYgI,1254 +aiogram/types/chat_member_member.py,sha256=2AtZsJz3aICbn2eqCmG1p0UsBYSqlNLmN-wnqnC6uks,1482 +aiogram/types/chat_member_owner.py,sha256=2gV3f1ubns_eORZjJocWSuwH8IW_cv2j2I0MuHbVa68,1676 +aiogram/types/chat_member_restricted.py,sha256=7F40ERHf29ihfrB4tTc9JWL5w5xRBjqVLGoMWMgyWlg,4545 +aiogram/types/chat_member_updated.py,sha256=AS5_q6EXSBL2Wuy6lQXzn7gaXUPGZJWOWgGK1GCvx2c,87547 +aiogram/types/chat_permissions.py,sha256=A6I6DuCQGRWBqhQuVe8xMnRkd9i0iD7gOZm6Qg7m0LY,4382 +aiogram/types/chat_photo.py,sha256=BouKO-6NIn5d17fB9acX9iAbv_gjYzbeKuTqN3BcFD4,1872 +aiogram/types/chat_shared.py,sha256=O6taLjKlBX-z15XYZ6Hcp9SsUCYhBa9Sz7hKzAvi2as,2260 +aiogram/types/chosen_inline_result.py,sha256=VFMo9FklvYjWrPbwrxeIyHrDwLlRvnFObUV5EhaannU,2399 +aiogram/types/contact.py,sha256=jWvv9gc-4LyFyBLeAeucyr7A8yjBk7-sJQH10NKoydU,1848 +aiogram/types/custom.py,sha256=3Xqsx2Llx47Hu1v4hGEFOjbMzkgkdQ9lmKW87Atulp4,819 +aiogram/types/dice.py,sha256=QOFOqUx3jqVtqU_nwuWhhSthy5CBR_mNTMuIpwiD2KY,1165 +aiogram/types/document.py,sha256=6tKzYSPyON6BoWLn3F3tiXHUxaQNG1YNl6kC6bO-0ZE,2425 +aiogram/types/downloadable.py,sha256=FbRdIM3Cpw3tcDzZvwy__u98aSKqMMJn2kKh9mK62B0,77 +aiogram/types/encrypted_credentials.py,sha256=1ZC-Q3c84mEVZGEK_cXTkqzX4FzBujn0_necxJ1uSPc,1521 +aiogram/types/encrypted_passport_element.py,sha256=9RmD1xbkrWw-DFb8QCUCWENswXBKklGqy0G3SX_TB78,4733 +aiogram/types/error_event.py,sha256=m0QrLksRJ0-x0q5xpb6iyI4rqPfiz3XJom_Gh75CJ-8,714 +aiogram/types/external_reply_info.py,sha256=aYYuCYyyz5DL3zhDgdECSkdvf6HyiiHSTN61dyVMGmU,7185 +aiogram/types/file.py,sha256=52bE-c7RjZmTdXk8ij8PJ5fsx2-1IfgedM763PmzGnQ,2166 +aiogram/types/force_reply.py,sha256=YkTteaPMOUH544hl9h6VDypMxyiLIKFd9KXryouTmVM,3024 +aiogram/types/forum_topic.py,sha256=CchPMME1NgB8WT9FWLgQ5mYZ7uXFG2yuTmDMaDZ6kcU,1422 +aiogram/types/forum_topic_closed.py,sha256=aw1K6fIadwJtSTZnyTQq3xtEf7920vodFjK5lHeKVgs,309 +aiogram/types/forum_topic_created.py,sha256=OPYpne_Zz5tdOpzjYOXGplCxLhF1aeKnHFzpn3qXIRg,1321 +aiogram/types/forum_topic_edited.py,sha256=Fq8QDirNBsymOKbAxBYnFqhmXL52XuqKAQrLxePRyA8,1230 +aiogram/types/forum_topic_reopened.py,sha256=MloV3nhDpHSLe5VoVgmC99u7ch3IYahIHH2EokGCWgY,315 +aiogram/types/game.py,sha256=AUnwPfixbvWpzxfoHziedT7WJtoF02vxBNz791j0fro,2365 +aiogram/types/game_high_score.py,sha256=rwCyO24y4BkcTJSmoLPA7pGEsgfA6-_3i40uvCgxp6k,1203 +aiogram/types/general_forum_topic_hidden.py,sha256=QC3u0Qpt3nptdhl3dxqgNXVrptwSAdnEzI-OWP8QMMw,301 +aiogram/types/general_forum_topic_unhidden.py,sha256=W8HRGyB81eyooaucgD0ojeAzywD8AjnMnUf2hf7r5Nk,307 +aiogram/types/giveaway.py,sha256=N5k2AXEdBRKRaHfDbYl_YuRGARaIAiOP1S49cAkGgc4,3042 +aiogram/types/giveaway_completed.py,sha256=m6QrBVrfT5s2W4mt-LoJwvHodkV7eIc112HOHLf9Z3k,1515 +aiogram/types/giveaway_created.py,sha256=6HYs2dBo4V6OBZpfoOAB7CxlMZQB_jPb01rEAw3RLe8,275 +aiogram/types/giveaway_winners.py,sha256=t2b4tX6twU0wlOEJLvrTbD_PB2pAcL3LDSycXhvQNw0,3321 +aiogram/types/inaccessible_message.py,sha256=Wn3WocufH3a8g0BE0S0TIK1pUQrt3NQBPAm-_9HhjSs,1288 +aiogram/types/inline_keyboard_button.py,sha256=1AwstgKnWwqrt0dI57_bMZNQWXAuEP74gxpYtHKN024,4769 +aiogram/types/inline_keyboard_markup.py,sha256=b6dxsxzM93LZyG41mXHPX4JKyKlPr3bqc-8s4zuUCpk,1273 +aiogram/types/inline_query.py,sha256=XCXCRESvVpbepiIYiJLcF48rc35K8sKrmeFw8iciLf4,7410 +aiogram/types/inline_query_result.py,sha256=8Ve8Fe1Yf6O7NHWCYdTVIgnbawI6hIo5B0l2cV5ZN20,2189 +aiogram/types/inline_query_result_article.py,sha256=Keq9BuANquPGxWDw9D8Yra7_vNDSvYSRfqK5Ml9e9yE,3759 +aiogram/types/inline_query_result_audio.py,sha256=6r3mHQQ4tA0kouOznWvE4izEJ9NarZBP-40-BOdn0Mo,4367 +aiogram/types/inline_query_result_cached_audio.py,sha256=7oYplK6rrWZrDAcXQqZvpnKOW_Kuj1vQ1oa3sqj-VcQ,4018 +aiogram/types/inline_query_result_cached_document.py,sha256=qvNPpMWQfJ-i_SCLDIHWDvuuRqFqYLuxqdLuaVq0_Nk,4360 +aiogram/types/inline_query_result_cached_gif.py,sha256=Mawa0gyeGd4-MSjVAJ1Pm62pBSakp9SpvOsGXOhpQ7Q,4601 +aiogram/types/inline_query_result_cached_mpeg4_gif.py,sha256=UtOhg-YOQPO3H3JkJZeZcUloxXgDmoaHHOBOg6x-GO0,4699 +aiogram/types/inline_query_result_cached_photo.py,sha256=LQPdR2UW9hvnz68YOziipLaajVqCPzVzK8yhjHJZSxc,4769 +aiogram/types/inline_query_result_cached_sticker.py,sha256=hqZ8ZvEv0jA0rf7WDVa4SVkaX5khDncpdSPoH5LWEcU,3100 +aiogram/types/inline_query_result_cached_video.py,sha256=Uyr7rlAZO4djHXnhfyoEItN_Mu30W8NkooZICLN8LKk,4739 +aiogram/types/inline_query_result_cached_voice.py,sha256=kvsqjskDe_Aor7WZvrijUsfZnJdum-krGxMwYl4GEGQ,4144 +aiogram/types/inline_query_result_contact.py,sha256=vAmYCE49k7pWHNA-1-L0p7pD2TljNdzitFgsE_hrYDI,4111 +aiogram/types/inline_query_result_document.py,sha256=yYEqSbiWqW3zDl2xX7WNcf2oraOu8zp7hr1BIqLrUeo,5047 +aiogram/types/inline_query_result_game.py,sha256=9t2HzFgVgHjPW_pQZ4YBTeGptSbn9KOHcGsbEPpUwzQ,1758 +aiogram/types/inline_query_result_gif.py,sha256=MNmFu5R4Jz1MbiDoznpsI7GBdy7-BB83QhVnF16HyhM,5577 +aiogram/types/inline_query_result_location.py,sha256=FX_eYlVfcRkcTTxubrTu1m3jGFWbgLEyg0R0TFp3ybY,4961 +aiogram/types/inline_query_result_mpeg4_gif.py,sha256=uL9AGdWYTaUJf3mM1v4iR-An8ZtWt-8XVpZY03vmZRI,5645 +aiogram/types/inline_query_result_photo.py,sha256=zWHeeIKMYQWHYzdIg9li93ziZ8acH9m-MSDmOLAiJA4,5245 +aiogram/types/inline_query_result_venue.py,sha256=pln1TVUl5cLvgxTxR1PEYLA7K69L9ZGAGxR_YQ0eQyY,4904 +aiogram/types/inline_query_result_video.py,sha256=9u6L-4nZVtUspl4nomPe3d0AuQHDv7EA3H1CmZQaJs8,5842 +aiogram/types/inline_query_result_voice.py,sha256=LUGfZZgL66NH6wppO9kpVnBoiCbC_zV6SBV3PBIBQJQ,4310 +aiogram/types/inline_query_results_button.py,sha256=mcDUu9wvU35tBvH1BhICorSlJ25XUVbpJlh9BWE3HNQ,1878 +aiogram/types/input_contact_message_content.py,sha256=GR2RDpizrX7rlxjf05CKzRT3zmLEO1yJSpqbmxCLwQA,1599 +aiogram/types/input_file.py,sha256=oCElYrCtJgfP5_ck0MQxvGppVZyXW5BnsHcmSg1Ds1o,4672 +aiogram/types/input_invoice_message_content.py,sha256=L4QePd9Bw7Mqy9L6vFTLL6iRsyJDB-YfOGfKNfVs24k,6899 +aiogram/types/input_location_message_content.py,sha256=UmmTHtSm-0MbIp2pISbl6FoPo9rjKeBK0pKzKg66GvE,2374 +aiogram/types/input_media.py,sha256=2nTD1Wg9VX8x74KTAf2d6OjjGTwPTUXaQL5Ty5TxvYQ,619 +aiogram/types/input_media_animation.py,sha256=BLpBBGSBzSRKpG-K7mQwguiof4cR58ElSNPwH9PdefQ,4373 +aiogram/types/input_media_audio.py,sha256=615pBywXCgGPIoeiqGep4D8SiMwTa83kmhasp0qqgHE,3706 +aiogram/types/input_media_document.py,sha256=2Z89Foqhnh3LviuiMcaU9rWg2kCVPQdNMvL_KrGckFM,3628 +aiogram/types/input_media_photo.py,sha256=QGqJC6qCGyEzbBLHsX8vw6pbnsk3l7eYA8AKmKA6WY4,3127 +aiogram/types/input_media_video.py,sha256=Yugn-j1NmMjMFP7ztI8XQMJVDZ_2KV_xJYdOCFSBk2I,4509 +aiogram/types/input_message_content.py,sha256=wj0C4RyiLpVP4yz0LmmO4qMNNIwRMihjnoMrjBSxjDE,793 +aiogram/types/input_paid_media.py,sha256=z-STAz_0G590-eFlOYNTv_HP1LOWbACXM0XMYbEBXrg,380 +aiogram/types/input_paid_media_photo.py,sha256=AHnkA6yvhhxdt_ffpCplgOxtqeh0YiDZ0WjVYj0boSA,1498 +aiogram/types/input_paid_media_video.py,sha256=nKQwP5BtYARot0LjkAr-EOa7UfbL8DwtFqexwoTNIY4,2977 +aiogram/types/input_poll_option.py,sha256=ky4L3A9Z2PuNTJL-WxMJ3o2zysphXaV2OukDdhXrLM4,1791 +aiogram/types/input_sticker.py,sha256=8smkhrtpZraqVrA_v87UuO4uNqzK_9bvPPVvDRrmCuY,2438 +aiogram/types/input_text_message_content.py,sha256=Er1EsUzQKV_p-spafMGNKL1saWlvvOmu4IBqFk03BaA,2720 +aiogram/types/input_venue_message_content.py,sha256=CZsCPYQrFdP_BrYBzNJ_Ik39PlJ1VLOsvI5q9vRS0Ns,2411 +aiogram/types/invoice.py,sha256=gOiw5G9yXJ8ZkAVupt2ww-mcooYanTix6t7KarSni9Y,1932 +aiogram/types/keyboard_button.py,sha256=L0cHsJEsKQziqK3zJN6laQL9drC36AhbhMOG20vhzcE,4352 +aiogram/types/keyboard_button_poll_type.py,sha256=tPGlW_jRXaDxZML1_vK080sp6BO86DO5cbBP-TEOf4Q,1153 +aiogram/types/keyboard_button_request_chat.py,sha256=N8UBPPlrQ07OSCO-33mfP5lKJ744sugaS86dYWpxMRQ,4448 +aiogram/types/keyboard_button_request_user.py,sha256=89efkQPnTYrtpBozhTvXp00YE8uKqgJInVUafJV7nkI,1990 +aiogram/types/keyboard_button_request_users.py,sha256=bhj4_scIdCcKxWeuC8f8guU_tcWTvwrbISe_PycG-XE,2747 +aiogram/types/labeled_price.py,sha256=7kRZPTy8HgJG4FYrix21xGfhgT_u93fROUBOj1wB4Rk,1330 +aiogram/types/link_preview_options.py,sha256=xv8Z-qE_NBfojELQHSlgegmsXso661AL8562z8i0dls,2747 +aiogram/types/location.py,sha256=0X9SBlANNn_ODEByFE0oDiJxpKtGEQ6OI6fDXB_1loA,2115 +aiogram/types/login_url.py,sha256=VxZTVG1LbmKeon_spDg17HJiPh1l1buOI5eFBNLu1Rk,2771 +aiogram/types/mask_position.py,sha256=ZH0pNJ8u4Xlos2MwCtsnSzMNfhgGvacCGdJ42qFp9no,1627 +aiogram/types/maybe_inaccessible_message.py,sha256=TbxUHEoW88w4nWer6zhQhWaAjTqr2Xi3H9-ZJRfvA9Q,388 +aiogram/types/menu_button.py,sha256=4Q2I_AlbnRe2fQ0f1a-LNl0toGOHI73ehjhMQmLngV4,2103 +aiogram/types/menu_button_commands.py,sha256=NMmH1S0jcEivjXmzRfMTLJAO4UBKVhFuo8wS4ONgZwc,1038 +aiogram/types/menu_button_default.py,sha256=FnjUz1-aXR3-0oHPv0pNU5yi1M86wnzwCbNnzEMu094,1027 +aiogram/types/menu_button_web_app.py,sha256=G-yWLPg91mgaMP672VRj6xmB8_UqDpMeH2iePvY0rw0,1715 +aiogram/types/message.py,sha256=AlHRfaN9KyEJjT887Jv6P52WLaMZvOKx_SgBEMcP7eM,240867 +aiogram/types/message_auto_delete_timer_changed.py,sha256=D9GoK5tOtxWTksB_yaIKthfiHWJhOI6SUBWWpW_PRTY,1020 +aiogram/types/message_entity.py,sha256=q_dWKJhMNVg8zGzIUy40b0viRNnBaZSPT_7ySANbwDw,3287 +aiogram/types/message_id.py,sha256=4I7m_laQsIwLiTOVG3B59BJLvlzGTkf0gai9aazqs0I,805 +aiogram/types/message_origin.py,sha256=uSs6n9q5JhIzaV42ldMJJL_8nAx_aCQ3xNqrRVMJsWg,518 +aiogram/types/message_origin_channel.py,sha256=tgCfiuS81A0oWD9EY90F0P3B9s-Avsm0FJlw5ra8umA,1795 +aiogram/types/message_origin_chat.py,sha256=_EE8lVR8Kp745dHTlT1zHYXEDImbGhq_nuZgteu9lbc,1725 +aiogram/types/message_origin_hidden_user.py,sha256=N8WXMNcBlWSuDMRYUxsUiZubnOxsDFOr7GyYQKRrij4,1377 +aiogram/types/message_origin_user.py,sha256=FTu0wnkg8AElOQtMjy2Ee-ApL2eX57a5qMrudWMWf90,1349 +aiogram/types/message_reaction_count_updated.py,sha256=TKCPGGl2hKGFg4hizjdclB8hMzLjDsVP_48-uk_pKmI,1521 +aiogram/types/message_reaction_updated.py,sha256=_-QSyiZFNlEy9s-aZp61AFq8yRUT3Kp_T1x7SDbKv34,2616 +aiogram/types/order_info.py,sha256=ECWERhAIl3kkclMOwnNN9NHGQLUtW0B6oElkLubPPr4,1516 +aiogram/types/paid_media.py,sha256=gw3vvGNuZugsvlWpqxuZs1Q81ALL9MTZ6RVP5EFMbmk,399 +aiogram/types/paid_media_info.py,sha256=vCXLSVj5f9BHeI5t60EWllCMZykOtWFaVOglXZQKzC0,1327 +aiogram/types/paid_media_photo.py,sha256=uRakDZNVUOHpvLoxMPxI0eKdfp1_x-hs1KEMvDriSEc,1130 +aiogram/types/paid_media_preview.py,sha256=9ZIG6wR-De8VPU2y5Rn77czZFOdLcW_JxKXQeYsiycw,1522 +aiogram/types/paid_media_video.py,sha256=afHhTgBEXuyms9V1FaGqJutjveZeHjESmYvav3D3_ck,1095 +aiogram/types/passport_data.py,sha256=PT4TKdMo9drK6LeK_FgGS98wE8c-kCwHkB7HcjthguQ,1318 +aiogram/types/passport_element_error.py,sha256=0MooyVK2Yoz-6MTnBDqbyiR9o-cYM5GoM6HC-p6X9jQ,1214 +aiogram/types/passport_element_error_data_field.py,sha256=NQXIJOOjXP56vbMTgKl2z9QqTs7FyHlxURO2xSOMQI0,1850 +aiogram/types/passport_element_error_file.py,sha256=tlUpJBAJFPUzHnCgd07gIS1c_HvFXFTpQWlB6Kipo_w,1619 +aiogram/types/passport_element_error_files.py,sha256=UKY3feWaWnV7E0gVs2nTys43bbYmB-C3flQ2j0DbAdg,1734 +aiogram/types/passport_element_error_front_side.py,sha256=669dn7UWwY4GnNnmaUBipHj8U22PahkJFmzLVerAGXk,1721 +aiogram/types/passport_element_error_reverse_side.py,sha256=ZVfTzKDmrZqzwcOBNuzsSwfEUip8hHCzeRk2jyiWDak,1704 +aiogram/types/passport_element_error_selfie.py,sha256=KR-TG1DguG1w9Kv1rIJRf7qkI_L7euSwr9h5IC8DAJU,1623 +aiogram/types/passport_element_error_translation_file.py,sha256=Zm4DzT7yQoHHdANCgq0uW6kmskULr56hwjv0GFPWTGI,1843 +aiogram/types/passport_element_error_translation_files.py,sha256=I_i-u15lAHxpCzhzj7Iiu8aTdbwyhQJfGeYp9p3woIs,1952 +aiogram/types/passport_element_error_unspecified.py,sha256=KqvSPstDlkcEJRDA-JkFX5JK97uO9R4Nqx_Sbp5iW4Q,1651 +aiogram/types/passport_file.py,sha256=tN7IbA6M4Zk6WH4CpVeI0exfi_UKoKOUiz1iT1e1epo,1599 +aiogram/types/photo_size.py,sha256=J1rOX1QxScCjA0LPm4KgdLZBpsAQfscAaDfuocE4cC0,1664 +aiogram/types/poll.py,sha256=dgCODf8MlNQKh74LfWuwfdOXli-N55kqwRWS3wl1pcg,3737 +aiogram/types/poll_answer.py,sha256=HZoZQ4SiytyywLPa3ACX617QJ4zy3REXG_puRmtJdww,1614 +aiogram/types/poll_option.py,sha256=KhsgOD64wZu2RCD6F6gsuT9z-5RKnOWMOFs-Cjwdnh4,1445 +aiogram/types/pre_checkout_query.py,sha256=CaYsF1zvPb1k5cgka1GC12VMS3eZc3RWVba7VmRr6L4,4410 +aiogram/types/proximity_alert_triggered.py,sha256=b2zF9r0sjf-cp6Gj-pyTIJq9x5a_JBjdp-DseDGpM_0,1253 +aiogram/types/reaction_count.py,sha256=wmMH5iR_tOJ3ieSezjBzRCPQyt7RhH3Lbw8emodaxqE,1332 +aiogram/types/reaction_type.py,sha256=EBHvWnPblOe2T6ey0_V9m6vReAX8VcHX4wuzKLVMR0w,442 +aiogram/types/reaction_type_custom_emoji.py,sha256=dzZSLhEtBke35GtTgfSxrijMu9jQzob6drdFkYReR7w,1150 +aiogram/types/reaction_type_emoji.py,sha256=F5WoRrUm9tOV3YJVNh8quD4D2OfsU53Y-mbqggbnm-w,1682 +aiogram/types/reaction_type_paid.py,sha256=zXzhLH6g8HeyIOO1dhsZwG4_Mh52Yw5sC5mucpffnTY,854 +aiogram/types/refunded_payment.py,sha256=yaj69LD-j7ffwtTk69ozl0MXz3r2kUlBTgOuWEqvxto,2180 +aiogram/types/reply_keyboard_markup.py,sha256=Ey04kT-CDRoFk4Ofqe-U6-SUi_SYaXtYQ72NqzNwgq4,3373 +aiogram/types/reply_keyboard_remove.py,sha256=vt2LTPCyoNO1SzO7JLJAUTLxfcyVh5eVKTkFmjQVvag,2093 +aiogram/types/reply_parameters.py,sha256=2DWrO4V2Vxdc42OnEuHjfLS60PaNO01rtcvlt-H4aCY,3502 +aiogram/types/response_parameters.py,sha256=qPu3C079bJZRdUIQwr-r9WIcW6yYW7rdWJlraZQbw-M,1550 +aiogram/types/revenue_withdrawal_state.py,sha256=rUzcoQ2Nbmm-2EwkoD-g_xWUp9o3mIsthyE2ZWrg0ZY,585 +aiogram/types/revenue_withdrawal_state_failed.py,sha256=uhCBqAV8SpbCkL364ygkvGg7TzarISQ6NniBeHvn3HE,1133 +aiogram/types/revenue_withdrawal_state_pending.py,sha256=rVieabsj2ayXpzN7yW8uGN-8p6Qy_lQyrKYFSKH5qmw,1115 +aiogram/types/revenue_withdrawal_state_succeeded.py,sha256=d2cBJbxXEPhtSLWb-TzyDy-iumMWkG7G6LWNRBmH7oI,1409 +aiogram/types/sent_web_app_message.py,sha256=1p2Xr_3czwPbZd8PpylTSo31ZgeAEBLnlnlRcBY31xc,1168 +aiogram/types/shared_user.py,sha256=L_PyLNJ0I75E9OykdQA5Nk5j56QjmwEgD8jPIYxFGYA,2340 +aiogram/types/shipping_address.py,sha256=9JTEnZoNaPa-T1p_YolL1ErIGWJol8lAU4F8ycsQ8ZY,1550 +aiogram/types/shipping_option.py,sha256=5jI1LADtNbe2oZC0a2G3f7Fh6J8CZ0wfCBqVFOUlqIw,1098 +aiogram/types/shipping_query.py,sha256=22pK3KfuxTTkZm-GFxrgphBmldqT4iIifVY-6vmF-qk,3458 +aiogram/types/star_transaction.py,sha256=zGrNLgJeDuv4AWfr8tiCWLHM_KgNO-d9rYiiaiUe8A8,3087 +aiogram/types/star_transactions.py,sha256=n4NDZK71RgvVbuiCAzdjKBc5p6PyezzYQFjJkiewunw,954 +aiogram/types/sticker.py,sha256=Tcz8iqKzCbfvP7MdV3NVwUEt9u27EmB7_R-N_BxSd6M,5902 +aiogram/types/sticker_set.py,sha256=OGKkpMzsQxRcuAGLt9ZJOaLwv9IKndmTaaKl5fyiNLo,2388 +aiogram/types/story.py,sha256=2Bm9ZHpfr4_yeBPWFgwnqTs-y4xFgKqW8NLRVWzMdqM,884 +aiogram/types/successful_payment.py,sha256=nNUteKAYhz_PI3EuoDkd8zX1dDal_NLMSy08fnwjC98,2574 +aiogram/types/switch_inline_query_chosen_chat.py,sha256=KH9p_x5aY6XxQn71LRa92cVQMl8glZKdc2m2935i_Yo,2002 +aiogram/types/text_quote.py,sha256=2bmMetBcRCIUu5GPlGUC8IpRLqPEAOmirvpsmzOPrrA,1863 +aiogram/types/transaction_partner.py,sha256=WtOmiGbZhHF_1vidNsULzjypaypxdHfif3nGcOwNIjg,625 +aiogram/types/transaction_partner_fragment.py,sha256=sHfiApYXz8E4Jr40pb0szs4b94aAp0UTE6UGQ1xFFdo,1962 +aiogram/types/transaction_partner_other.py,sha256=iHViDYZ62dQS3z6k1YkMOqFELyBM4wpAkGzRlif-_xw,1104 +aiogram/types/transaction_partner_telegram_ads.py,sha256=QmVjyRZUGNTpxRIFZF4F_pAPj9i4224E1PsnA9GS8YU,1185 +aiogram/types/transaction_partner_user.py,sha256=rslWGfJ7C-ptPRXACLyB3vxrbDyu1yd9LJX0pTNiLV8,1979 +aiogram/types/update.py,sha256=5FVm6IcFT8INyU3GPNVBxL0s3-g7cJpeO3vUUogzoo4,11481 +aiogram/types/user.py,sha256=DW0Xg1Lld2oB5wwOZtBIJggt-WiNLKOY-4HHSpU_t1k,6001 +aiogram/types/user_chat_boosts.py,sha256=Qpvrxc-BGYuyKbC8kLIrmQqNpfYi3jXXYY_234NWb0M,946 +aiogram/types/user_profile_photos.py,sha256=VKpZMznwuIUQ4sWxjDgNv3tSr6AW2fwG4AIwgztwL-w,1124 +aiogram/types/user_shared.py,sha256=1yGKAO67fshHSOCtVl3dO_oD1-VOyzPBC4Ak-hflMOQ,1534 +aiogram/types/users_shared.py,sha256=Fdjww27YYlWMVzYOhpBp54RL_N_Zh7_meWgpqBxfkjQ,1986 +aiogram/types/venue.py,sha256=wEmGfGAiqdhDhTskRoxOKiNVliUaPpPOxBmohfDlL5I,2147 +aiogram/types/video.py,sha256=e-uI5iQSKAdhPK-vVz5kiQCIV22kaxmylzN8gzmtwnk,2575 +aiogram/types/video_chat_ended.py,sha256=eL3ZSR0WfVcHEEpXrdLm1mvuogXS7RAoxLwX2AwMdeg,839 +aiogram/types/video_chat_participants_invited.py,sha256=zV4sR4Mi_BmHeS60I4C-KzrAhOAh2weIFuEE8CmhmZI,943 +aiogram/types/video_chat_scheduled.py,sha256=G-a24czeK7NVzJ88SKFNutPd_SGnRgTBLy85rHozNLo,990 +aiogram/types/video_chat_started.py,sha256=FYHVcH-a5knoXIYMmCQThFt8hjjPwAiZ8QvGLNVWgl4,309 +aiogram/types/video_note.py,sha256=Hwa8uTCnyb9yT9eGikFwyVfk6X779md3DNAPbav6VrM,2059 +aiogram/types/voice.py,sha256=AMyEJovxyDl2TRVpEfpHLMSmsXNjXIrNDH73HxQUxqg,1932 +aiogram/types/web_app_data.py,sha256=CzkuU2VwVYQ7WBkFA6Zh8BL-qUKQeB__mcmhmVZnT2A,1107 +aiogram/types/web_app_info.py,sha256=aPH4uLFFLKNLEF3RUm3uYCkg9Hk545kMoUvrkg4TUds,931 +aiogram/types/webhook_info.py,sha256=TAfcO66tpfH5XolOI90pg_sHowUkV4hHjzp3tWhpj_w,2992 +aiogram/types/write_access_allowed.py,sha256=3GiPknn_fKHAJ53FROE4AK4MtpwluNlAuZvFuOP6diA,1912 +aiogram/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +aiogram/utils/__pycache__/__init__.cpython-311.pyc,, +aiogram/utils/__pycache__/auth_widget.cpython-311.pyc,, +aiogram/utils/__pycache__/backoff.cpython-311.pyc,, +aiogram/utils/__pycache__/callback_answer.cpython-311.pyc,, +aiogram/utils/__pycache__/chat_action.cpython-311.pyc,, +aiogram/utils/__pycache__/chat_member.cpython-311.pyc,, +aiogram/utils/__pycache__/deep_linking.cpython-311.pyc,, +aiogram/utils/__pycache__/formatting.cpython-311.pyc,, +aiogram/utils/__pycache__/keyboard.cpython-311.pyc,, +aiogram/utils/__pycache__/link.cpython-311.pyc,, +aiogram/utils/__pycache__/magic_filter.cpython-311.pyc,, +aiogram/utils/__pycache__/markdown.cpython-311.pyc,, +aiogram/utils/__pycache__/media_group.cpython-311.pyc,, +aiogram/utils/__pycache__/mixins.cpython-311.pyc,, +aiogram/utils/__pycache__/mypy_hacks.cpython-311.pyc,, +aiogram/utils/__pycache__/payload.cpython-311.pyc,, +aiogram/utils/__pycache__/serialization.cpython-311.pyc,, +aiogram/utils/__pycache__/text_decorations.cpython-311.pyc,, +aiogram/utils/__pycache__/token.cpython-311.pyc,, +aiogram/utils/__pycache__/warnings.cpython-311.pyc,, +aiogram/utils/__pycache__/web_app.cpython-311.pyc,, +aiogram/utils/auth_widget.py,sha256=kcNMXu7hA4kWHw_PeZsGFaeC0m0Sbtbd2-8Q9rWfkHg,981 +aiogram/utils/backoff.py,sha256=D_d7z94PyR5USzeoIednnCgW07qQgwQNgVdPGkgrmJM,2123 +aiogram/utils/callback_answer.py,sha256=_NHsLMjfZBKOXtyCSHBh4s9V3go-U8Wsk5JqpMh-O4c,6573 +aiogram/utils/chat_action.py,sha256=3GW2mDqQQ5fv6LMpeqB0j-J1d1blml2aF4q7vqlnMBQ,12201 +aiogram/utils/chat_member.py,sha256=WwMEi__6DYeF55TFuLxPS-OQaDdTa0I2f-yJkt3Dio0,942 +aiogram/utils/deep_linking.py,sha256=D89nv29pnL63_N_E_ZfLjiarTQZhg0oq6RnRdWRDSTE,2980 +aiogram/utils/formatting.py,sha256=7je7KplskUsRgo4DFVWwnN0g4C8JMBYC4tTVxw-3zr4,16902 +aiogram/utils/i18n/__init__.py,sha256=mwTwSL1cuXYi3a3LBICqoH66y4kHVML24YNPbGlZ55M,440 +aiogram/utils/i18n/__pycache__/__init__.cpython-311.pyc,, +aiogram/utils/i18n/__pycache__/context.cpython-311.pyc,, +aiogram/utils/i18n/__pycache__/core.cpython-311.pyc,, +aiogram/utils/i18n/__pycache__/lazy_proxy.cpython-311.pyc,, +aiogram/utils/i18n/__pycache__/middleware.cpython-311.pyc,, +aiogram/utils/i18n/context.py,sha256=fhLzDZvxqRMvPu2-lEUrH7n09oHl-H0qo2mLFyKzCJk,549 +aiogram/utils/i18n/core.py,sha256=XX_iuwylDTfrfCrafnqiFq28LDr-bvoO4Qnkhy81d_M,3542 +aiogram/utils/i18n/lazy_proxy.py,sha256=0yHtyrejG9wG4yzLl1cDEsFomww2nyR7KFSbFyp7_NA,472 +aiogram/utils/i18n/middleware.py,sha256=lqeui9-x7ztMQPI0IeQeRawe6orMjpsg2EtvXTzAQj4,5874 +aiogram/utils/keyboard.py,sha256=zxXdpmRr5x-4kaczAGWvlElMoWzRKF5PvDyxSJ9_4HY,13234 +aiogram/utils/link.py,sha256=z7Zp5uk5z3iNO26-wZrhoCDNLt1N0KjbPYhthOq-50o,2261 +aiogram/utils/magic_filter.py,sha256=WGHOC9k2acxrcpkFF-ViQv3LbzRAKtJj5MRv7IEi75c,666 +aiogram/utils/markdown.py,sha256=3T1UVSzaAwnYnTNNq6pklq-TTs6Y6zINp-LIWgwrAyU,4481 +aiogram/utils/media_group.py,sha256=E28oJhPoTQ4iKXr0QUx5W1nd7VPHAJf0PQz0MeqG46E,14804 +aiogram/utils/mixins.py,sha256=ox0Q6BlxcyTfAtzLVMEY9eUfXXhnXtkkLBQlUQ6uL4o,2923 +aiogram/utils/mypy_hacks.py,sha256=cm5_tBzfrkG5OOIs2m5U4JfQKohj1KkmCRXNLTJFDy0,433 +aiogram/utils/payload.py,sha256=mGJdQryRHL07VbSjdzGbN1NbYzd_mN2MGY1RiY3_KX4,2942 +aiogram/utils/serialization.py,sha256=SMiqv2TQed_GOhvhWoaABFM65jjIiXqBJTRRdMQ9nXY,2765 +aiogram/utils/text_decorations.py,sha256=tJwFV-zefED_z70wQsGWXIhD85m8Ee12mk3VrWN8Koo,8248 +aiogram/utils/token.py,sha256=iFfmK-pHGyPsF4ekWWcOlfH4OR9xGNAyCIavND8Ykrc,936 +aiogram/utils/warnings.py,sha256=xGsQcxrMXtdZfLOGRCqKRIJbw80DA39COcctikBfYAE,89 +aiogram/utils/web_app.py,sha256=pYFAohjk8OW3qRQkJebMtKaFJ7vOL4OJivUEh171kkI,7105 +aiogram/webhook/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +aiogram/webhook/__pycache__/__init__.cpython-311.pyc,, +aiogram/webhook/__pycache__/aiohttp_server.cpython-311.pyc,, +aiogram/webhook/__pycache__/security.cpython-311.pyc,, +aiogram/webhook/aiohttp_server.py,sha256=3uto1_vwf6h73SXFNSoDxGt49gFHFYDI1wf4uRcxWUg,10454 +aiogram/webhook/security.py,sha256=ifd2TrPSOlXfutYyAmRh0LT3hJkB4o79XmEV1lo6fv0,1350 diff --git a/env/Lib/site-packages/aiogram-3.12.0.dist-info/REQUESTED b/env/Lib/site-packages/aiogram-3.12.0.dist-info/REQUESTED new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/aiogram-3.12.0.dist-info/WHEEL b/env/Lib/site-packages/aiogram-3.12.0.dist-info/WHEEL new file mode 100644 index 0000000..cdd68a4 --- /dev/null +++ b/env/Lib/site-packages/aiogram-3.12.0.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: hatchling 1.25.0 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/env/Lib/site-packages/aiogram-3.12.0.dist-info/licenses/LICENSE b/env/Lib/site-packages/aiogram-3.12.0.dist-info/licenses/LICENSE new file mode 100644 index 0000000..caa060c --- /dev/null +++ b/env/Lib/site-packages/aiogram-3.12.0.dist-info/licenses/LICENSE @@ -0,0 +1,18 @@ +Copyright (c) 2017 - present Alex Root Junior + +Permission is hereby granted, free of charge, to any person obtaining a copy of this +software and associated documentation files (the "Software"), to deal in the Software +without restriction, including without limitation the rights to use, copy, modify, +merge, publish, distribute, sublicense, and/or sell copies of the Software, +and to permit persons to whom the Software is furnished to do so, subject to the +following conditions: + +The above copyright notice and this permission notice shall be included in all copies +or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, +INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR +PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS +BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE +OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/env/Lib/site-packages/aiogram/__init__.py b/env/Lib/site-packages/aiogram/__init__.py new file mode 100644 index 0000000..1fbee0e --- /dev/null +++ b/env/Lib/site-packages/aiogram/__init__.py @@ -0,0 +1,41 @@ +import asyncio as _asyncio +from contextlib import suppress + +from aiogram.dispatcher.flags import FlagGenerator + +from . import enums, methods, types +from .__meta__ import __api_version__, __version__ +from .client import session +from .client.bot import Bot +from .dispatcher.dispatcher import Dispatcher +from .dispatcher.middlewares.base import BaseMiddleware +from .dispatcher.router import Router +from .utils.magic_filter import MagicFilter +from .utils.text_decorations import html_decoration as html +from .utils.text_decorations import markdown_decoration as md + +with suppress(ImportError): + import uvloop as _uvloop + + _asyncio.set_event_loop_policy(_uvloop.EventLoopPolicy()) + + +F = MagicFilter() +flags = FlagGenerator() + +__all__ = ( + "__api_version__", + "__version__", + "types", + "methods", + "enums", + "Bot", + "session", + "Dispatcher", + "Router", + "BaseMiddleware", + "F", + "html", + "md", + "flags", +) diff --git a/env/Lib/site-packages/aiogram/__meta__.py b/env/Lib/site-packages/aiogram/__meta__.py new file mode 100644 index 0000000..c36e738 --- /dev/null +++ b/env/Lib/site-packages/aiogram/__meta__.py @@ -0,0 +1,2 @@ +__version__ = "3.12.0" +__api_version__ = "7.9" diff --git a/env/Lib/site-packages/aiogram/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..84bce6dfe91d7a5d2c3d0686e03a8c36622b504e GIT binary patch literal 1614 zcmZ`%O>Epm6dteb^=AL`OGrvvvJ`2BvIrzpDI`6FG=OLjf&=hLp?`1*aPoy87M3@&^t(22f4@QLv&ym=po#u^O(=_xed6@zUF(wueo=8 z;|tWRKUb8WHVs)2{a%j~Aplo4sn`9GgoJx>#Gk8@nx?c#*k?jIjKsTJk1lbCFpOOQQ6Y%6e zkNUBWmA1TY(Af;=(5&sojAEa3B1mmWIn6x2=SK(ORdI&rI*wJE_ zT@MYocyoT7J=tem1o^8b=%H(#Dj z(PEO7|MDy+C?hGln`9+Lcap56=&d9xDSAK2N{ZH!teo1F!Bqat?Q)_AP(TTN`G**7Pd(v1rZmga(R*$W<6KgH8*3O*KA${_1#qrN2(U|fYIzK@%xY$_*U#2sL$o++12Oo6pMDdfj<8ZGiq4 DsCvVl literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/__pycache__/__meta__.cpython-311.pyc b/env/Lib/site-packages/aiogram/__pycache__/__meta__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d1b1a9c1153603e19796739e4c5431a3b0d703fc GIT binary patch literal 229 zcmZ3^%ge<81lwkxNz(_?k3k$5V1zP0^8p#t8B!Rc7*ZIc7*m*n88n%z*o^fIjr0tv zn9cPp{WO_wamUA(r4|)u=I6!7-{OytPb|np2&`oI3^MGOi;GoEcz#iKjB|cUW?p(s zc4<*!Nq$j$QhrHHYF=54Pi9g~ab`)XZb4#lc4B&JaZF-netJ=2u6}%cZfZ$le7s&k udUwNRFlbKKkZsOP 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/__pycache__/loggers.cpython-311.pyc b/env/Lib/site-packages/aiogram/__pycache__/loggers.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ba3d0c167cdca2b056660ff55e9029b17adc6050 GIT binary patch literal 598 zcmZXRF-yZh6vr=Z)5MgEpi`-|Zqh>2!P-H@rH;kLp-=*n_Rci6&6P{qVy2A!1`6(q z2#$UVhXyi~OoEe}(5;h~+E|J2;P}7yyZ3(&?h!%>uz0@v77*ED{GR9Leo{Dik#`zde$9NiX7oaG7hU=X>JDNds zstpumSVPV3bTM^cRKsIz+Rkp24h)3)c%o5kIonZjg43lq z+Vo+5Ryg!v)rVDAnv2<~;EUP2iYJzQvE=e|xiHmzxiH&5^5mK?*WAop%1sY^DL30I Tdy?WyiYxr@b9tAi88-794R4-M literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/client/__init__.py b/env/Lib/site-packages/aiogram/client/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/aiogram/client/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/client/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0f57daf13cf66936683524f9a421008de97a2d55 GIT binary patch literal 184 zcmZ3^%ge<81lwkxNdwW3K?DpiLK&agfQ;!3DGb33nv8xc8H$*I{LdiCU*0ZOG2!_| z*)h)fDVcfcG1;X>i6!|(@k#k5F{ycFF+Q0|F~ylBsk#M;$=QkNsl_pgnfd8OiMjg8 zIhm<>CHnF4nR%Hd@$q^EmA^P_a`RJ4b5iY!Sb=7PY%k^q5+9fu85ut?z=$Gdpcnv1 Cp)bAw literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/client/__pycache__/bot.cpython-311.pyc b/env/Lib/site-packages/aiogram/client/__pycache__/bot.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4ee2c62fad6e25a3db729c8c07de37954b2d8ea4 GIT binary patch literal 251914 zcmeFa31D1Tc{V)S7t4}tS#rFOx7bo7d5se*3-J;=2HP=S61a(xN1Bm5@!T14XU2|% z41uK7ZBuF>{Rl0K)2{?V(w45IEp35rw1rkq4N<2BLRnhqW|~l_yZrz2yyu*|%%a7z zo$!%Ke0A@+=brUF?|$C%(b==>L-_sH&wqa4&1IFLuk*qDD%DNdivzfOUnm-imL)=V znN?QC`|?D&RW5%ktP1&CX;tEHMWV{CwyGshWunHewQA+QDp6yWL@R*f&@=*qv6V-DP#z-B!1~&RS=$x7OPmtPS=?Yooo%+GKCGHrqE^H`-gQ zE%r^;P4>;!&GuGntKDPu*tb}>*tc4@+P7J^*|%G_+pn=+W8Y!jVQ;gx+1st{_6}=@ zz0=xh-)Y@x@3MB;yRF^!UDjRp9&3;NTI;p;>#Wz=d#%0pK5L)7-`a2AZQX4junyR- zw_a}_v<}*btV8x;>#%*qI%3~r-DBTt-D|(WdV~E&>y5T$S@wO_efIs<{q|AosQo7E zO?I!=)O+9@k#4_QO@o2@t7j^)^CD{W`2jGeWz_DSoceabpzKWIH@4_m|bh&5ur#d?c9 zYK_{bt<&~ft+(25v)*PuWIbfR-FmzI4(lEE!`8$0Bi1AKk6AxvzteiB{o~e;+h?pZ z_D@(pVgID{llD(pKV?5^J!=27_0#sdtasTzWBrVM);epy+j_VC9_u~!d#(4{k6Dk| zKWqK0{eP_gW53UOpTIyJ;OcSfar^z&`|Y2ze$M`R>*wtcSRb%IXnoNBko6(^!`6rG zbJjWg3F`^_7pz~f|F89b?O(Kh(f)|_5&KE&N&BPLN9~VUAG4pbp0Yn~ecXQ9dfI-* zddB`G>zC|bwtm_E73){*PgtL@f7SX```4^rvwz+Cb^AB0->`qv`c3<{tlzRfX?@au z)_T_dZR@w~-?4tj{$1;L?N3>svVYI|J^S~q-?#t3`UCsZ)~D^ySf8;!Ykk)KL+cOi zKeGPF{$uNp?LV>p#Qsz3PwmfHpR@nW`ZN2_tv|Q_!ukvQ^Va9>FIZo&|I+$P`>(9O zvd643`@D7De$IN%{%h;6?F-fg`-|2W?JrqhvY)q}x5uq<`){njv2#|={#)yB?Z31B z&i=CXW&11ESM0A^U$tMbUa-Grea-%R>+kKaTVJ=oVSU5?ru9wxTh_Pif3W_+{zvN{ z?QdJ(w!dS2$NnelpX`6O{@MN)>tF1Dwf@!qH|yW*i`GT^yViH@f4BbKe$jf-e#v^t z{+{(cjDLM}R^mVG?_1xue_;JUo*NSXXvfQjlGMUOmGVxS0y¨k@Rq~ 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/client/__pycache__/default.cpython-311.pyc b/env/Lib/site-packages/aiogram/client/__pycache__/default.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..685d80f56b2ae966df04c9facf2e619b30b4090d GIT binary patch literal 3822 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/client/bot.py b/env/Lib/site-packages/aiogram/client/bot.py new file mode 100644 index 0000000..397e1a1 --- /dev/null +++ b/env/Lib/site-packages/aiogram/client/bot.py @@ -0,0 +1,4761 @@ +from __future__ import annotations + +import datetime +import io +import pathlib +from contextlib import asynccontextmanager +from types import TracebackType +from typing import ( + Any, + AsyncGenerator, + AsyncIterator, + BinaryIO, + List, + Optional, + Type, + TypeVar, + Union, + cast, +) + +import aiofiles + +from aiogram.utils.token import extract_bot_id, validate_token + +from ..methods import ( + AddStickerToSet, + AnswerCallbackQuery, + AnswerInlineQuery, + AnswerPreCheckoutQuery, + AnswerShippingQuery, + AnswerWebAppQuery, + ApproveChatJoinRequest, + BanChatMember, + BanChatSenderChat, + Close, + CloseForumTopic, + CloseGeneralForumTopic, + CopyMessage, + CopyMessages, + CreateChatInviteLink, + CreateChatSubscriptionInviteLink, + CreateForumTopic, + CreateInvoiceLink, + CreateNewStickerSet, + DeclineChatJoinRequest, + DeleteChatPhoto, + DeleteChatStickerSet, + DeleteForumTopic, + DeleteMessage, + DeleteMessages, + DeleteMyCommands, + DeleteStickerFromSet, + DeleteStickerSet, + DeleteWebhook, + EditChatInviteLink, + EditChatSubscriptionInviteLink, + EditForumTopic, + EditGeneralForumTopic, + EditMessageCaption, + EditMessageLiveLocation, + EditMessageMedia, + EditMessageReplyMarkup, + EditMessageText, + ExportChatInviteLink, + ForwardMessage, + ForwardMessages, + GetBusinessConnection, + GetChat, + GetChatAdministrators, + GetChatMember, + GetChatMemberCount, + GetChatMenuButton, + GetCustomEmojiStickers, + GetFile, + GetForumTopicIconStickers, + GetGameHighScores, + GetMe, + GetMyCommands, + GetMyDefaultAdministratorRights, + GetMyDescription, + GetMyName, + GetMyShortDescription, + GetStarTransactions, + GetStickerSet, + GetUpdates, + GetUserChatBoosts, + GetUserProfilePhotos, + GetWebhookInfo, + HideGeneralForumTopic, + LeaveChat, + LogOut, + PinChatMessage, + PromoteChatMember, + RefundStarPayment, + ReopenForumTopic, + ReopenGeneralForumTopic, + ReplaceStickerInSet, + RestrictChatMember, + RevokeChatInviteLink, + SendAnimation, + SendAudio, + SendChatAction, + SendContact, + SendDice, + SendDocument, + SendGame, + SendInvoice, + SendLocation, + SendMediaGroup, + SendMessage, + SendPaidMedia, + SendPhoto, + SendPoll, + SendSticker, + SendVenue, + SendVideo, + SendVideoNote, + SendVoice, + SetChatAdministratorCustomTitle, + SetChatDescription, + SetChatMenuButton, + SetChatPermissions, + SetChatPhoto, + SetChatStickerSet, + SetChatTitle, + SetCustomEmojiStickerSetThumbnail, + SetGameScore, + SetMessageReaction, + SetMyCommands, + SetMyDefaultAdministratorRights, + SetMyDescription, + SetMyName, + SetMyShortDescription, + SetPassportDataErrors, + SetStickerEmojiList, + SetStickerKeywords, + SetStickerMaskPosition, + SetStickerPositionInSet, + SetStickerSetThumbnail, + SetStickerSetTitle, + SetWebhook, + StopMessageLiveLocation, + StopPoll, + TelegramMethod, + UnbanChatMember, + UnbanChatSenderChat, + UnhideGeneralForumTopic, + UnpinAllChatMessages, + UnpinAllForumTopicMessages, + UnpinAllGeneralForumTopicMessages, + UnpinChatMessage, + UploadStickerFile, +) +from ..types import ( + BotCommand, + BotCommandScopeAllChatAdministrators, + BotCommandScopeAllGroupChats, + BotCommandScopeAllPrivateChats, + BotCommandScopeChat, + BotCommandScopeChatAdministrators, + BotCommandScopeChatMember, + BotCommandScopeDefault, + BotDescription, + BotName, + BotShortDescription, + BusinessConnection, + ChatAdministratorRights, + ChatFullInfo, + ChatInviteLink, + ChatMemberAdministrator, + ChatMemberBanned, + ChatMemberLeft, + ChatMemberMember, + ChatMemberOwner, + ChatMemberRestricted, + ChatPermissions, + Downloadable, + File, + ForceReply, + ForumTopic, + GameHighScore, + InlineKeyboardMarkup, + InlineQueryResultArticle, + InlineQueryResultAudio, + InlineQueryResultCachedAudio, + InlineQueryResultCachedDocument, + InlineQueryResultCachedGif, + InlineQueryResultCachedMpeg4Gif, + InlineQueryResultCachedPhoto, + InlineQueryResultCachedSticker, + InlineQueryResultCachedVideo, + InlineQueryResultCachedVoice, + InlineQueryResultContact, + InlineQueryResultDocument, + InlineQueryResultGame, + InlineQueryResultGif, + InlineQueryResultLocation, + InlineQueryResultMpeg4Gif, + InlineQueryResultPhoto, + InlineQueryResultsButton, + InlineQueryResultVenue, + InlineQueryResultVideo, + InlineQueryResultVoice, + InputFile, + InputMediaAnimation, + InputMediaAudio, + InputMediaDocument, + InputMediaPhoto, + InputMediaVideo, + InputPaidMediaPhoto, + InputPaidMediaVideo, + InputPollOption, + InputSticker, + LabeledPrice, + LinkPreviewOptions, + MaskPosition, + MenuButtonCommands, + MenuButtonDefault, + MenuButtonWebApp, + Message, + MessageEntity, + MessageId, + PassportElementErrorDataField, + PassportElementErrorFile, + PassportElementErrorFiles, + PassportElementErrorFrontSide, + PassportElementErrorReverseSide, + PassportElementErrorSelfie, + PassportElementErrorTranslationFile, + PassportElementErrorTranslationFiles, + PassportElementErrorUnspecified, + Poll, + ReactionTypeCustomEmoji, + ReactionTypeEmoji, + ReactionTypePaid, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, + SentWebAppMessage, + ShippingOption, + StarTransactions, + Sticker, + StickerSet, + Update, + User, + UserChatBoosts, + UserProfilePhotos, + WebhookInfo, +) +from .default import Default, DefaultBotProperties +from .session.aiohttp import AiohttpSession +from .session.base import BaseSession + +T = TypeVar("T") + + +class Bot: + def __init__( + self, + token: str, + session: Optional[BaseSession] = None, + default: Optional[DefaultBotProperties] = None, + **kwargs: Any, + ) -> None: + """ + Bot class + + :param token: Telegram Bot token `Obtained from @BotFather `_ + :param session: HTTP Client session (For example AiohttpSession). + If not specified it will be automatically created. + :param default: Default bot properties. + If specified it will be propagated into the API methods at runtime. + :raise TokenValidationError: When token has invalid format this exception will be raised + """ + + validate_token(token) + + if session is None: + session = AiohttpSession() + if default is None: + default = DefaultBotProperties() + + self.session = session + + # Few arguments are completely removed in 3.7.0 version + # Temporary solution to raise an error if user passed these arguments + # with explanation how to fix it + parse_mode = kwargs.get("parse_mode", None) + link_preview_is_disabled = kwargs.get("disable_web_page_preview", None) + protect_content = kwargs.get("protect_content", None) + if ( + parse_mode is not None + or link_preview_is_disabled is not None + or protect_content is not None + ): + example_kwargs = { + "parse_mode": parse_mode, + "link_preview_is_disabled": link_preview_is_disabled, + "protect_content": protect_content, + } + replacement_spec = ", ".join( + f"{k}={v!r}" for k, v in example_kwargs.items() if v is not None + ) + raise TypeError( + "Passing `parse_mode`, `disable_web_page_preview` or `protect_content` " + "to Bot initializer is not supported anymore. These arguments have been removed " + f"in 3.7.0 version. Use `default=DefaultBotProperties({replacement_spec})` argument instead." + ) + + self.default = default + + self.__token = token + self._me: Optional[User] = None + + async def __aenter__(self) -> "Bot": + return self + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc_value: Optional[BaseException], + traceback: Optional[TracebackType], + ) -> None: + await self.session.close() + + @property + def token(self) -> str: + return self.__token + + @property + def id(self) -> int: + """ + Get bot ID from token + + :return: + """ + return extract_bot_id(self.__token) + + @asynccontextmanager + async def context(self, auto_close: bool = True) -> AsyncIterator[Bot]: + """ + Generate bot context + + :param auto_close: close session on exit + :return: + """ + try: + yield self + finally: + if auto_close: + await self.session.close() + + async def me(self) -> User: + """ + Cached alias for getMe method + + :return: + """ + if self._me is None: # pragma: no cover + self._me = await self.get_me() + return self._me + + @classmethod + async def __download_file_binary_io( + cls, destination: BinaryIO, seek: bool, stream: AsyncGenerator[bytes, None] + ) -> BinaryIO: + async for chunk in stream: + destination.write(chunk) + destination.flush() + if seek is True: + destination.seek(0) + return destination + + @classmethod + async def __download_file( + cls, destination: Union[str, pathlib.Path], stream: AsyncGenerator[bytes, None] + ) -> None: + async with aiofiles.open(destination, "wb") as f: + async for chunk in stream: + await f.write(chunk) + + @classmethod + async def __aiofiles_reader( + cls, file: str, chunk_size: int = 65536 + ) -> AsyncGenerator[bytes, None]: + async with aiofiles.open(file, "rb") as f: + while chunk := await f.read(chunk_size): + yield chunk + + async def download_file( + self, + file_path: str, + destination: Optional[Union[BinaryIO, pathlib.Path, str]] = None, + timeout: int = 30, + chunk_size: int = 65536, + seek: bool = True, + ) -> Optional[BinaryIO]: + """ + Download file by file_path to destination. + + If you want to automatically create destination (:class:`io.BytesIO`) use default + value of destination and handle result of this method. + + :param file_path: File path on Telegram server (You can get it from :obj:`aiogram.types.File`) + :param destination: Filename, file path or instance of :class:`io.IOBase`. For e.g. :class:`io.BytesIO`, defaults to None + :param timeout: Total timeout in seconds, defaults to 30 + :param chunk_size: File chunks size, defaults to 64 kb + :param seek: Go to start of file when downloading is finished. Used only for destination with :class:`typing.BinaryIO` type, defaults to True + """ + if destination is None: + destination = io.BytesIO() + + close_stream = False + if self.session.api.is_local: + stream = self.__aiofiles_reader( + str(self.session.api.wrap_local_file.to_local(file_path)), chunk_size=chunk_size + ) + close_stream = True + else: + url = self.session.api.file_url(self.__token, file_path) + stream = self.session.stream_content( + url=url, + timeout=timeout, + chunk_size=chunk_size, + raise_for_status=True, + ) + + try: + if isinstance(destination, (str, pathlib.Path)): + await self.__download_file(destination=destination, stream=stream) + return None + return await self.__download_file_binary_io( + destination=destination, seek=seek, stream=stream + ) + finally: + if close_stream: + await stream.aclose() + + async def download( + self, + file: Union[str, Downloadable], + destination: Optional[Union[BinaryIO, pathlib.Path, str]] = None, + timeout: int = 30, + chunk_size: int = 65536, + seek: bool = True, + ) -> Optional[BinaryIO]: + """ + Download file by file_id or Downloadable object to destination. + + If you want to automatically create destination (:class:`io.BytesIO`) use default + value of destination and handle result of this method. + + :param file: file_id or Downloadable object + :param destination: Filename, file path or instance of :class:`io.IOBase`. For e.g. :class:`io.BytesIO`, defaults to None + :param timeout: Total timeout in seconds, defaults to 30 + :param chunk_size: File chunks size, defaults to 64 kb + :param seek: Go to start of file when downloading is finished. Used only for destination with :class:`typing.BinaryIO` type, defaults to True + """ + if isinstance(file, str): + file_id = file + else: + # type is ignored in due to: + # Incompatible types in assignment (expression has type "Optional[Any]", variable has type "str") + file_id = getattr(file, "file_id", None) # type: ignore + if file_id is None: + raise TypeError("file can only be of the string or Downloadable type") + + file_ = await self.get_file(file_id) + + # `file_path` can be None for large files but this files can't be downloaded + # So we need to do type-cast + # https://github.com/aiogram/aiogram/pull/282/files#r394110017 + file_path = cast(str, file_.file_path) + + return await self.download_file( + file_path, destination=destination, timeout=timeout, chunk_size=chunk_size, seek=seek + ) + + async def __call__( + self, method: TelegramMethod[T], request_timeout: Optional[int] = None + ) -> T: + """ + Call API method + + :param method: + :return: + """ + return await self.session(self, method, timeout=request_timeout) + + def __hash__(self) -> int: + """ + Get hash for the token + + :return: + """ + return hash(self.__token) + + def __eq__(self, other: Any) -> bool: + """ + Compare current bot with another bot instance + + :param other: + :return: + """ + if not isinstance(other, Bot): + return False + return hash(self) == hash(other) + + async def add_sticker_to_set( + self, + user_id: int, + name: str, + sticker: InputSticker, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to add a new sticker to a set created by the bot. Emoji sticker sets can have up to 200 stickers. Other sticker sets can have up to 120 stickers. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#addstickertoset + + :param user_id: User identifier of sticker set owner + :param name: Sticker set name + :param sticker: A JSON-serialized object with information about the added sticker. If exactly the same sticker had already been added to the set, then the set isn't changed. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = AddStickerToSet( + user_id=user_id, + name=name, + sticker=sticker, + ) + return await self(call, request_timeout=request_timeout) + + async def answer_callback_query( + self, + callback_query_id: str, + text: Optional[str] = None, + show_alert: Optional[bool] = None, + url: Optional[str] = None, + cache_time: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to send answers to callback queries sent from `inline keyboards `_. The answer will be displayed to the user as a notification at the top of the chat screen or as an alert. On success, :code:`True` is returned. + + Alternatively, the user can be redirected to the specified Game URL. For this option to work, you must first create a game for your bot via `@BotFather `_ and accept the terms. Otherwise, you may use links like :code:`t.me/your_bot?start=XXXX` that open your bot with a parameter. + + Source: https://core.telegram.org/bots/api#answercallbackquery + + :param callback_query_id: Unique identifier for the query to be answered + :param text: Text of the notification. If not specified, nothing will be shown to the user, 0-200 characters + :param show_alert: If :code:`True`, an alert will be shown by the client instead of a notification at the top of the chat screen. Defaults to *false*. + :param url: URL that will be opened by the user's client. If you have created a :class:`aiogram.types.game.Game` and accepted the conditions via `@BotFather `_, specify the URL that opens your game - note that this will only work if the query comes from a `https://core.telegram.org/bots/api#inlinekeyboardbutton `_ *callback_game* button. + :param cache_time: The maximum amount of time in seconds that the result of the callback query may be cached client-side. Telegram apps will support caching starting in version 3.14. Defaults to 0. + :param request_timeout: Request timeout + :return: Otherwise, you may use links like :code:`t.me/your_bot?start=XXXX` that open your bot with a parameter. + """ + + call = AnswerCallbackQuery( + callback_query_id=callback_query_id, + text=text, + show_alert=show_alert, + url=url, + cache_time=cache_time, + ) + return await self(call, request_timeout=request_timeout) + + async def answer_inline_query( + self, + inline_query_id: str, + results: List[ + Union[ + InlineQueryResultCachedAudio, + InlineQueryResultCachedDocument, + InlineQueryResultCachedGif, + InlineQueryResultCachedMpeg4Gif, + InlineQueryResultCachedPhoto, + InlineQueryResultCachedSticker, + InlineQueryResultCachedVideo, + InlineQueryResultCachedVoice, + InlineQueryResultArticle, + InlineQueryResultAudio, + InlineQueryResultContact, + InlineQueryResultGame, + InlineQueryResultDocument, + InlineQueryResultGif, + InlineQueryResultLocation, + InlineQueryResultMpeg4Gif, + InlineQueryResultPhoto, + InlineQueryResultVenue, + InlineQueryResultVideo, + InlineQueryResultVoice, + ] + ], + cache_time: Optional[int] = None, + is_personal: Optional[bool] = None, + next_offset: Optional[str] = None, + button: Optional[InlineQueryResultsButton] = None, + switch_pm_parameter: Optional[str] = None, + switch_pm_text: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to send answers to an inline query. On success, :code:`True` is returned. + + No more than **50** results per query are allowed. + + Source: https://core.telegram.org/bots/api#answerinlinequery + + :param inline_query_id: Unique identifier for the answered query + :param results: A JSON-serialized array of results for the inline query + :param cache_time: The maximum amount of time in seconds that the result of the inline query may be cached on the server. Defaults to 300. + :param is_personal: Pass :code:`True` if results may be cached on the server side only for the user that sent the query. By default, results may be returned to any user who sends the same query. + :param next_offset: Pass the offset that a client should send in the next query with the same text to receive more results. Pass an empty string if there are no more results or if you don't support pagination. Offset length can't exceed 64 bytes. + :param button: A JSON-serialized object describing a button to be shown above inline query results + :param switch_pm_parameter: `Deep-linking `_ parameter for the /start message sent to the bot when user presses the switch button. 1-64 characters, only :code:`A-Z`, :code:`a-z`, :code:`0-9`, :code:`_` and :code:`-` are allowed. + :param switch_pm_text: If passed, clients will display a button with specified text that switches the user to a private chat with the bot and sends the bot a start message with the parameter *switch_pm_parameter* + :param request_timeout: Request timeout + :return: On success, :code:`True` is returned. + """ + + call = AnswerInlineQuery( + inline_query_id=inline_query_id, + results=results, + cache_time=cache_time, + is_personal=is_personal, + next_offset=next_offset, + button=button, + switch_pm_parameter=switch_pm_parameter, + switch_pm_text=switch_pm_text, + ) + return await self(call, request_timeout=request_timeout) + + async def answer_pre_checkout_query( + self, + pre_checkout_query_id: str, + ok: bool, + error_message: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Once the user has confirmed their payment and shipping details, the Bot API sends the final confirmation in the form of an :class:`aiogram.types.update.Update` with the field *pre_checkout_query*. Use this method to respond to such pre-checkout queries. On success, :code:`True` is returned. **Note:** The Bot API must receive an answer within 10 seconds after the pre-checkout query was sent. + + Source: https://core.telegram.org/bots/api#answerprecheckoutquery + + :param pre_checkout_query_id: Unique identifier for the query to be answered + :param ok: Specify :code:`True` if everything is alright (goods are available, etc.) and the bot is ready to proceed with the order. Use :code:`False` if there are any problems. + :param error_message: Required if *ok* is :code:`False`. Error message in human readable form that explains the reason for failure to proceed with the checkout (e.g. "Sorry, somebody just bought the last of our amazing black T-shirts while you were busy filling out your payment details. Please choose a different color or garment!"). Telegram will display this message to the user. + :param request_timeout: Request timeout + :return: **Note:** The Bot API must receive an answer within 10 seconds after the pre-checkout query was sent. + """ + + call = AnswerPreCheckoutQuery( + pre_checkout_query_id=pre_checkout_query_id, + ok=ok, + error_message=error_message, + ) + return await self(call, request_timeout=request_timeout) + + async def answer_shipping_query( + self, + shipping_query_id: str, + ok: bool, + shipping_options: Optional[List[ShippingOption]] = None, + error_message: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + If you sent an invoice requesting a shipping address and the parameter *is_flexible* was specified, the Bot API will send an :class:`aiogram.types.update.Update` with a *shipping_query* field to the bot. Use this method to reply to shipping queries. On success, :code:`True` is returned. + + Source: https://core.telegram.org/bots/api#answershippingquery + + :param shipping_query_id: Unique identifier for the query to be answered + :param ok: Pass :code:`True` if delivery to the specified address is possible and :code:`False` if there are any problems (for example, if delivery to the specified address is not possible) + :param shipping_options: Required if *ok* is :code:`True`. A JSON-serialized array of available shipping options. + :param error_message: Required if *ok* is :code:`False`. Error message in human readable form that explains why it is impossible to complete the order (e.g. "Sorry, delivery to your desired address is unavailable'). Telegram will display this message to the user. + :param request_timeout: Request timeout + :return: On success, :code:`True` is returned. + """ + + call = AnswerShippingQuery( + shipping_query_id=shipping_query_id, + ok=ok, + shipping_options=shipping_options, + error_message=error_message, + ) + return await self(call, request_timeout=request_timeout) + + async def answer_web_app_query( + self, + web_app_query_id: str, + result: Union[ + InlineQueryResultCachedAudio, + InlineQueryResultCachedDocument, + InlineQueryResultCachedGif, + InlineQueryResultCachedMpeg4Gif, + InlineQueryResultCachedPhoto, + InlineQueryResultCachedSticker, + InlineQueryResultCachedVideo, + InlineQueryResultCachedVoice, + InlineQueryResultArticle, + InlineQueryResultAudio, + InlineQueryResultContact, + InlineQueryResultGame, + InlineQueryResultDocument, + InlineQueryResultGif, + InlineQueryResultLocation, + InlineQueryResultMpeg4Gif, + InlineQueryResultPhoto, + InlineQueryResultVenue, + InlineQueryResultVideo, + InlineQueryResultVoice, + ], + request_timeout: Optional[int] = None, + ) -> SentWebAppMessage: + """ + Use this method to set the result of an interaction with a `Web App `_ and send a corresponding message on behalf of the user to the chat from which the query originated. On success, a :class:`aiogram.types.sent_web_app_message.SentWebAppMessage` object is returned. + + Source: https://core.telegram.org/bots/api#answerwebappquery + + :param web_app_query_id: Unique identifier for the query to be answered + :param result: A JSON-serialized object describing the message to be sent + :param request_timeout: Request timeout + :return: On success, a :class:`aiogram.types.sent_web_app_message.SentWebAppMessage` object is returned. + """ + + call = AnswerWebAppQuery( + web_app_query_id=web_app_query_id, + result=result, + ) + return await self(call, request_timeout=request_timeout) + + async def approve_chat_join_request( + self, + chat_id: Union[int, str], + user_id: int, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to approve a chat join request. The bot must be an administrator in the chat for this to work and must have the *can_invite_users* administrator right. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#approvechatjoinrequest + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param user_id: Unique identifier of the target user + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = ApproveChatJoinRequest( + chat_id=chat_id, + user_id=user_id, + ) + return await self(call, request_timeout=request_timeout) + + async def ban_chat_member( + self, + chat_id: Union[int, str], + user_id: int, + until_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + revoke_messages: Optional[bool] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to ban a user in a group, a supergroup or a channel. In the case of supergroups and channels, the user will not be able to return to the chat on their own using invite links, etc., unless `unbanned `_ first. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#banchatmember + + :param chat_id: Unique identifier for the target group or username of the target supergroup or channel (in the format :code:`@channelusername`) + :param user_id: Unique identifier of the target user + :param until_date: Date when the user will be unbanned; Unix time. If user is banned for more than 366 days or less than 30 seconds from the current time they are considered to be banned forever. Applied for supergroups and channels only. + :param revoke_messages: Pass :code:`True` to delete all messages from the chat for the user that is being removed. If :code:`False`, the user will be able to see messages in the group that were sent before the user was removed. Always :code:`True` for supergroups and channels. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = BanChatMember( + chat_id=chat_id, + user_id=user_id, + until_date=until_date, + revoke_messages=revoke_messages, + ) + return await self(call, request_timeout=request_timeout) + + async def ban_chat_sender_chat( + self, + chat_id: Union[int, str], + sender_chat_id: int, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to ban a channel chat in a supergroup or a channel. Until the chat is `unbanned `_, the owner of the banned chat won't be able to send messages on behalf of **any of their channels**. The bot must be an administrator in the supergroup or channel for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#banchatsenderchat + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param sender_chat_id: Unique identifier of the target sender chat + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = BanChatSenderChat( + chat_id=chat_id, + sender_chat_id=sender_chat_id, + ) + return await self(call, request_timeout=request_timeout) + + async def close( + self, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to close the bot instance before moving it from one local server to another. You need to delete the webhook before calling this method to ensure that the bot isn't launched again after server restart. The method will return error 429 in the first 10 minutes after the bot is launched. Returns :code:`True` on success. Requires no parameters. + + Source: https://core.telegram.org/bots/api#close + + :param request_timeout: Request timeout + :return: Requires no parameters. + """ + + call = Close() + return await self(call, request_timeout=request_timeout) + + async def close_forum_topic( + self, + chat_id: Union[int, str], + message_thread_id: int, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to close an open topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights, unless it is the creator of the topic. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#closeforumtopic + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param message_thread_id: Unique identifier for the target message thread of the forum topic + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = CloseForumTopic( + chat_id=chat_id, + message_thread_id=message_thread_id, + ) + return await self(call, request_timeout=request_timeout) + + async def copy_message( + self, + chat_id: Union[int, str], + from_chat_id: Union[int, str], + message_id: int, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> MessageId: + """ + Use this method to copy messages of any kind. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz :class:`aiogram.methods.poll.Poll` can be copied only if the value of the field *correct_option_id* is known to the bot. The method is analogous to the method :class:`aiogram.methods.forward_message.ForwardMessage`, but the copied message doesn't have a link to the original message. Returns the :class:`aiogram.types.message_id.MessageId` of the sent message on success. + + Source: https://core.telegram.org/bots/api#copymessage + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param from_chat_id: Unique identifier for the chat where the original message was sent (or channel username in the format :code:`@channelusername`) + :param message_id: Message identifier in the chat specified in *from_chat_id* + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param caption: New caption for media, 0-1024 characters after entities parsing. If not specified, the original caption is kept + :param parse_mode: Mode for parsing entities in the new caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the new caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media. Ignored if a new caption isn't specified. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: Returns the :class:`aiogram.types.message_id.MessageId` of the sent message on success. + """ + + call = CopyMessage( + chat_id=chat_id, + from_chat_id=from_chat_id, + message_id=message_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + disable_notification=disable_notification, + protect_content=protect_content, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def create_chat_invite_link( + self, + chat_id: Union[int, str], + name: Optional[str] = None, + expire_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + member_limit: Optional[int] = None, + creates_join_request: Optional[bool] = None, + request_timeout: Optional[int] = None, + ) -> ChatInviteLink: + """ + Use this method to create an additional invite link for a chat. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. The link can be revoked using the method :class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink`. Returns the new invite link as :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + + Source: https://core.telegram.org/bots/api#createchatinvitelink + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param name: Invite link name; 0-32 characters + :param expire_date: Point in time (Unix timestamp) when the link will expire + :param member_limit: The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 + :param creates_join_request: :code:`True`, if users joining the chat via the link need to be approved by chat administrators. If :code:`True`, *member_limit* can't be specified + :param request_timeout: Request timeout + :return: Returns the new invite link as :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + """ + + call = CreateChatInviteLink( + chat_id=chat_id, + name=name, + expire_date=expire_date, + member_limit=member_limit, + creates_join_request=creates_join_request, + ) + return await self(call, request_timeout=request_timeout) + + async def create_forum_topic( + self, + chat_id: Union[int, str], + name: str, + icon_color: Optional[int] = None, + icon_custom_emoji_id: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> ForumTopic: + """ + Use this method to create a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights. Returns information about the created topic as a :class:`aiogram.types.forum_topic.ForumTopic` object. + + Source: https://core.telegram.org/bots/api#createforumtopic + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param name: Topic name, 1-128 characters + :param icon_color: Color of the topic icon in RGB format. Currently, must be one of 7322096 (0x6FB9F0), 16766590 (0xFFD67E), 13338331 (0xCB86DB), 9367192 (0x8EEE98), 16749490 (0xFF93B2), or 16478047 (0xFB6F5F) + :param icon_custom_emoji_id: Unique identifier of the custom emoji shown as the topic icon. Use :class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers` to get all allowed custom emoji identifiers. + :param request_timeout: Request timeout + :return: Returns information about the created topic as a :class:`aiogram.types.forum_topic.ForumTopic` object. + """ + + call = CreateForumTopic( + chat_id=chat_id, + name=name, + icon_color=icon_color, + icon_custom_emoji_id=icon_custom_emoji_id, + ) + return await self(call, request_timeout=request_timeout) + + async def create_invoice_link( + self, + title: str, + description: str, + payload: str, + currency: str, + prices: List[LabeledPrice], + provider_token: Optional[str] = None, + max_tip_amount: Optional[int] = None, + suggested_tip_amounts: Optional[List[int]] = None, + provider_data: Optional[str] = None, + photo_url: Optional[str] = None, + photo_size: Optional[int] = None, + photo_width: Optional[int] = None, + photo_height: Optional[int] = None, + need_name: Optional[bool] = None, + need_phone_number: Optional[bool] = None, + need_email: Optional[bool] = None, + need_shipping_address: Optional[bool] = None, + send_phone_number_to_provider: Optional[bool] = None, + send_email_to_provider: Optional[bool] = None, + is_flexible: Optional[bool] = None, + request_timeout: Optional[int] = None, + ) -> str: + """ + Use this method to create a link for an invoice. Returns the created invoice link as *String* on success. + + Source: https://core.telegram.org/bots/api#createinvoicelink + + :param title: Product name, 1-32 characters + :param description: Product description, 1-255 characters + :param payload: Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use for your internal processes. + :param currency: Three-letter ISO 4217 currency code, see `more on currencies `_. Pass 'XTR' for payments in `Telegram Stars `_. + :param prices: Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.). Must contain exactly one item for payments in `Telegram Stars `_. + :param provider_token: Payment provider token, obtained via `@BotFather `_. Pass an empty string for payments in `Telegram Stars `_. + :param max_tip_amount: The maximum accepted amount for tips in the *smallest units* of the currency (integer, **not** float/double). For example, for a maximum tip of :code:`US$ 1.45` pass :code:`max_tip_amount = 145`. See the *exp* parameter in `currencies.json `_, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0. Not supported for payments in `Telegram Stars `_. + :param suggested_tip_amounts: A JSON-serialized array of suggested amounts of tips in the *smallest units* of the currency (integer, **not** float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed *max_tip_amount*. + :param provider_data: JSON-serialized data about the invoice, which will be shared with the payment provider. A detailed description of required fields should be provided by the payment provider. + :param photo_url: URL of the product photo for the invoice. Can be a photo of the goods or a marketing image for a service. + :param photo_size: Photo size in bytes + :param photo_width: Photo width + :param photo_height: Photo height + :param need_name: Pass :code:`True` if you require the user's full name to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_phone_number: Pass :code:`True` if you require the user's phone number to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_email: Pass :code:`True` if you require the user's email address to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_shipping_address: Pass :code:`True` if you require the user's shipping address to complete the order. Ignored for payments in `Telegram Stars `_. + :param send_phone_number_to_provider: Pass :code:`True` if the user's phone number should be sent to the provider. Ignored for payments in `Telegram Stars `_. + :param send_email_to_provider: Pass :code:`True` if the user's email address should be sent to the provider. Ignored for payments in `Telegram Stars `_. + :param is_flexible: Pass :code:`True` if the final price depends on the shipping method. Ignored for payments in `Telegram Stars `_. + :param request_timeout: Request timeout + :return: Returns the created invoice link as *String* on success. + """ + + call = CreateInvoiceLink( + title=title, + description=description, + payload=payload, + currency=currency, + prices=prices, + provider_token=provider_token, + max_tip_amount=max_tip_amount, + suggested_tip_amounts=suggested_tip_amounts, + provider_data=provider_data, + photo_url=photo_url, + photo_size=photo_size, + photo_width=photo_width, + photo_height=photo_height, + need_name=need_name, + need_phone_number=need_phone_number, + need_email=need_email, + need_shipping_address=need_shipping_address, + send_phone_number_to_provider=send_phone_number_to_provider, + send_email_to_provider=send_email_to_provider, + is_flexible=is_flexible, + ) + return await self(call, request_timeout=request_timeout) + + async def create_new_sticker_set( + self, + user_id: int, + name: str, + title: str, + stickers: List[InputSticker], + sticker_type: Optional[str] = None, + needs_repainting: Optional[bool] = None, + sticker_format: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> 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. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#createnewstickerset + + :param user_id: User identifier of created sticker set owner + :param name: 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 :code:`"_by_"`. :code:`` is case insensitive. 1-64 characters. + :param title: Sticker set title, 1-64 characters + :param stickers: A JSON-serialized list of 1-50 initial stickers to be added to the sticker set + :param sticker_type: Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created. + :param needs_repainting: Pass :code:`True` if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only + :param sticker_format: Format of stickers in the set, must be one of 'static', 'animated', 'video' + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = CreateNewStickerSet( + user_id=user_id, + name=name, + title=title, + stickers=stickers, + sticker_type=sticker_type, + needs_repainting=needs_repainting, + sticker_format=sticker_format, + ) + return await self(call, request_timeout=request_timeout) + + async def decline_chat_join_request( + self, + chat_id: Union[int, str], + user_id: int, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to decline a chat join request. The bot must be an administrator in the chat for this to work and must have the *can_invite_users* administrator right. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#declinechatjoinrequest + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param user_id: Unique identifier of the target user + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = DeclineChatJoinRequest( + chat_id=chat_id, + user_id=user_id, + ) + return await self(call, request_timeout=request_timeout) + + async def delete_chat_photo( + self, + chat_id: Union[int, str], + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to delete a chat photo. Photos can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletechatphoto + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = DeleteChatPhoto( + chat_id=chat_id, + ) + return await self(call, request_timeout=request_timeout) + + async def delete_chat_sticker_set( + self, + chat_id: Union[int, str], + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to delete a group sticker set from a supergroup. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Use the field *can_set_sticker_set* optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests to check if the bot can use this method. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletechatstickerset + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = DeleteChatStickerSet( + chat_id=chat_id, + ) + return await self(call, request_timeout=request_timeout) + + async def delete_forum_topic( + self, + chat_id: Union[int, str], + message_thread_id: int, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to delete a forum topic along with all its messages in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_delete_messages* administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deleteforumtopic + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param message_thread_id: Unique identifier for the target message thread of the forum topic + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = DeleteForumTopic( + chat_id=chat_id, + message_thread_id=message_thread_id, + ) + return await self(call, request_timeout=request_timeout) + + async def delete_message( + self, + chat_id: Union[int, str], + message_id: int, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to delete a message, including service messages, with the following limitations: + + - A message can only be deleted if it was sent less than 48 hours ago. + + - Service messages about a supergroup, channel, or forum topic creation can't be deleted. + + - A dice message in a private chat can only be deleted if it was sent more than 24 hours ago. + + - Bots can delete outgoing messages in private chats, groups, and supergroups. + + - Bots can delete incoming messages in private chats. + + - Bots granted *can_post_messages* permissions can delete outgoing messages in channels. + + - If the bot is an administrator of a group, it can delete any message there. + + - If the bot has *can_delete_messages* permission in a supergroup or a channel, it can delete any message there. + + Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletemessage + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param message_id: Identifier of the message to delete + :param request_timeout: Request timeout + :return: Use this method to delete a message, including service messages, with the following limitations: + """ + + call = DeleteMessage( + chat_id=chat_id, + message_id=message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def delete_my_commands( + self, + scope: Optional[ + Union[ + BotCommandScopeDefault, + BotCommandScopeAllPrivateChats, + BotCommandScopeAllGroupChats, + BotCommandScopeAllChatAdministrators, + BotCommandScopeChat, + BotCommandScopeChatAdministrators, + BotCommandScopeChatMember, + ] + ] = None, + language_code: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to delete the list of the bot's commands for the given scope and user language. After deletion, `higher level commands `_ will be shown to affected users. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletemycommands + + :param scope: A JSON-serialized object, describing scope of users for which the commands are relevant. Defaults to :class:`aiogram.types.bot_command_scope_default.BotCommandScopeDefault`. + :param language_code: A two-letter ISO 639-1 language code. If empty, commands will be applied to all users from the given scope, for whose language there are no dedicated commands + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = DeleteMyCommands( + scope=scope, + language_code=language_code, + ) + return await self(call, request_timeout=request_timeout) + + async def delete_sticker_from_set( + self, + sticker: str, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to delete a sticker from a set created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletestickerfromset + + :param sticker: File identifier of the sticker + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = DeleteStickerFromSet( + sticker=sticker, + ) + return await self(call, request_timeout=request_timeout) + + async def delete_webhook( + self, + drop_pending_updates: Optional[bool] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to remove webhook integration if you decide to switch back to :class:`aiogram.methods.get_updates.GetUpdates`. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletewebhook + + :param drop_pending_updates: Pass :code:`True` to drop all pending updates + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = DeleteWebhook( + drop_pending_updates=drop_pending_updates, + ) + return await self(call, request_timeout=request_timeout) + + async def edit_chat_invite_link( + self, + chat_id: Union[int, str], + invite_link: str, + name: Optional[str] = None, + expire_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + member_limit: Optional[int] = None, + creates_join_request: Optional[bool] = None, + request_timeout: Optional[int] = None, + ) -> ChatInviteLink: + """ + Use this method to edit a non-primary invite link created by the bot. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the edited invite link as a :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + + Source: https://core.telegram.org/bots/api#editchatinvitelink + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param invite_link: The invite link to edit + :param name: Invite link name; 0-32 characters + :param expire_date: Point in time (Unix timestamp) when the link will expire + :param member_limit: The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 + :param creates_join_request: :code:`True`, if users joining the chat via the link need to be approved by chat administrators. If :code:`True`, *member_limit* can't be specified + :param request_timeout: Request timeout + :return: Returns the edited invite link as a :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + """ + + call = EditChatInviteLink( + chat_id=chat_id, + invite_link=invite_link, + name=name, + expire_date=expire_date, + member_limit=member_limit, + creates_join_request=creates_join_request, + ) + return await self(call, request_timeout=request_timeout) + + async def edit_forum_topic( + self, + chat_id: Union[int, str], + message_thread_id: int, + name: Optional[str] = None, + icon_custom_emoji_id: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to edit name and icon of a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights, unless it is the creator of the topic. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#editforumtopic + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param message_thread_id: Unique identifier for the target message thread of the forum topic + :param name: New topic name, 0-128 characters. If not specified or empty, the current name of the topic will be kept + :param icon_custom_emoji_id: New unique identifier of the custom emoji shown as the topic icon. Use :class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers` to get all allowed custom emoji identifiers. Pass an empty string to remove the icon. If not specified, the current icon will be kept + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = EditForumTopic( + chat_id=chat_id, + message_thread_id=message_thread_id, + name=name, + icon_custom_emoji_id=icon_custom_emoji_id, + ) + return await self(call, request_timeout=request_timeout) + + async def edit_message_caption( + self, + business_connection_id: Optional[str] = None, + chat_id: Optional[Union[int, str]] = None, + message_id: Optional[int] = None, + inline_message_id: Optional[str] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + reply_markup: Optional[InlineKeyboardMarkup] = None, + request_timeout: Optional[int] = None, + ) -> Union[Message, bool]: + """ + Use this method to edit captions of messages. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + + Source: https://core.telegram.org/bots/api#editmessagecaption + + :param business_connection_id: Unique identifier of the business connection on behalf of which the message to be edited was sent + :param chat_id: Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param message_id: Required if *inline_message_id* is not specified. Identifier of the message to edit + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param caption: New caption of the message, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the message caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media. Supported only for animation, photo and video messages. + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. + :param request_timeout: Request timeout + :return: Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + """ + + call = EditMessageCaption( + business_connection_id=business_connection_id, + chat_id=chat_id, + message_id=message_id, + inline_message_id=inline_message_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + reply_markup=reply_markup, + ) + return await self(call, request_timeout=request_timeout) + + async def edit_message_live_location( + self, + latitude: float, + longitude: float, + business_connection_id: Optional[str] = None, + chat_id: Optional[Union[int, str]] = None, + message_id: Optional[int] = None, + inline_message_id: Optional[str] = None, + live_period: Optional[int] = None, + horizontal_accuracy: Optional[float] = None, + heading: Optional[int] = None, + proximity_alert_radius: Optional[int] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + request_timeout: Optional[int] = None, + ) -> Union[Message, bool]: + """ + Use this method to edit live location messages. A location can be edited until its *live_period* expires or editing is explicitly disabled by a call to :class:`aiogram.methods.stop_message_live_location.StopMessageLiveLocation`. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. + + Source: https://core.telegram.org/bots/api#editmessagelivelocation + + :param latitude: Latitude of new location + :param longitude: Longitude of new location + :param business_connection_id: Unique identifier of the business connection on behalf of which the message to be edited was sent + :param chat_id: Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param message_id: Required if *inline_message_id* is not specified. Identifier of the message to edit + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param live_period: New period in seconds during which the location can be updated, starting from the message send date. If 0x7FFFFFFF is specified, then the location can be updated forever. Otherwise, the new value must not exceed the current *live_period* by more than a day, and the live location expiration date must remain within the next 90 days. If not specified, then *live_period* remains unchanged + :param horizontal_accuracy: The radius of uncertainty for the location, measured in meters; 0-1500 + :param heading: Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified. + :param proximity_alert_radius: The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified. + :param reply_markup: A JSON-serialized object for a new `inline keyboard `_. + :param request_timeout: Request timeout + :return: On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. + """ + + call = EditMessageLiveLocation( + latitude=latitude, + longitude=longitude, + business_connection_id=business_connection_id, + chat_id=chat_id, + message_id=message_id, + inline_message_id=inline_message_id, + live_period=live_period, + horizontal_accuracy=horizontal_accuracy, + heading=heading, + proximity_alert_radius=proximity_alert_radius, + reply_markup=reply_markup, + ) + return await self(call, request_timeout=request_timeout) + + async def edit_message_media( + self, + media: Union[ + InputMediaAnimation, + InputMediaDocument, + InputMediaAudio, + InputMediaPhoto, + InputMediaVideo, + ], + business_connection_id: Optional[str] = None, + chat_id: Optional[Union[int, str]] = None, + message_id: Optional[int] = None, + inline_message_id: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + request_timeout: Optional[int] = None, + ) -> Union[Message, bool]: + """ + Use this method to edit animation, audio, document, photo, or video messages. If a message is part of a message album, then it can be edited only to an audio for audio albums, only to a document for document albums and to a photo or a video otherwise. When an inline message is edited, a new file can't be uploaded; use a previously uploaded file via its file_id or specify a URL. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + + Source: https://core.telegram.org/bots/api#editmessagemedia + + :param media: A JSON-serialized object for a new media content of the message + :param business_connection_id: Unique identifier of the business connection on behalf of which the message to be edited was sent + :param chat_id: Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param message_id: Required if *inline_message_id* is not specified. Identifier of the message to edit + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param reply_markup: A JSON-serialized object for a new `inline keyboard `_. + :param request_timeout: Request timeout + :return: Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + """ + + call = EditMessageMedia( + media=media, + business_connection_id=business_connection_id, + chat_id=chat_id, + message_id=message_id, + inline_message_id=inline_message_id, + reply_markup=reply_markup, + ) + return await self(call, request_timeout=request_timeout) + + async def edit_message_reply_markup( + self, + business_connection_id: Optional[str] = None, + chat_id: Optional[Union[int, str]] = None, + message_id: Optional[int] = None, + inline_message_id: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + request_timeout: Optional[int] = None, + ) -> Union[Message, bool]: + """ + Use this method to edit only the reply markup of messages. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + + Source: https://core.telegram.org/bots/api#editmessagereplymarkup + + :param business_connection_id: Unique identifier of the business connection on behalf of which the message to be edited was sent + :param chat_id: Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param message_id: Required if *inline_message_id* is not specified. Identifier of the message to edit + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. + :param request_timeout: Request timeout + :return: Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + """ + + call = EditMessageReplyMarkup( + business_connection_id=business_connection_id, + chat_id=chat_id, + message_id=message_id, + inline_message_id=inline_message_id, + reply_markup=reply_markup, + ) + return await self(call, request_timeout=request_timeout) + + async def edit_message_text( + self, + text: str, + business_connection_id: Optional[str] = None, + chat_id: Optional[Union[int, str]] = None, + message_id: Optional[int] = None, + inline_message_id: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + entities: Optional[List[MessageEntity]] = None, + link_preview_options: Optional[LinkPreviewOptions] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + disable_web_page_preview: Optional[Union[bool, Default]] = Default( + "link_preview_is_disabled" + ), + request_timeout: Optional[int] = None, + ) -> Union[Message, bool]: + """ + Use this method to edit text and `game `_ messages. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + + Source: https://core.telegram.org/bots/api#editmessagetext + + :param text: New text of the message, 1-4096 characters after entities parsing + :param business_connection_id: Unique identifier of the business connection on behalf of which the message to be edited was sent + :param chat_id: Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param message_id: Required if *inline_message_id* is not specified. Identifier of the message to edit + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param parse_mode: Mode for parsing entities in the message text. See `formatting options `_ for more details. + :param entities: A JSON-serialized list of special entities that appear in message text, which can be specified instead of *parse_mode* + :param link_preview_options: Link preview generation options for the message + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. + :param disable_web_page_preview: Disables link previews for links in this message + :param request_timeout: Request timeout + :return: Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + """ + + call = EditMessageText( + text=text, + business_connection_id=business_connection_id, + chat_id=chat_id, + message_id=message_id, + inline_message_id=inline_message_id, + parse_mode=parse_mode, + entities=entities, + link_preview_options=link_preview_options, + reply_markup=reply_markup, + disable_web_page_preview=disable_web_page_preview, + ) + return await self(call, request_timeout=request_timeout) + + async def export_chat_invite_link( + self, + chat_id: Union[int, str], + request_timeout: Optional[int] = None, + ) -> str: + """ + Use this method to generate a new primary invite link for a chat; any previously generated primary link is revoked. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the new invite link as *String* on success. + + Note: Each administrator in a chat generates their own invite links. Bots can't use invite links generated by other administrators. If you want your bot to work with invite links, it will need to generate its own link using :class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` or by calling the :class:`aiogram.methods.get_chat.GetChat` method. If your bot needs to generate a new primary invite link replacing its previous one, use :class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` again. + + Source: https://core.telegram.org/bots/api#exportchatinvitelink + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param request_timeout: Request timeout + :return: If your bot needs to generate a new primary invite link replacing its previous one, use :class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` again. + """ + + call = ExportChatInviteLink( + chat_id=chat_id, + ) + return await self(call, request_timeout=request_timeout) + + async def forward_message( + self, + chat_id: Union[int, str], + from_chat_id: Union[int, str], + message_id: int, + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to forward messages of any kind. Service messages and messages with protected content can't be forwarded. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#forwardmessage + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param from_chat_id: Unique identifier for the chat where the original message was sent (or channel username in the format :code:`@channelusername`) + :param message_id: Message identifier in the chat specified in *from_chat_id* + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the forwarded message from forwarding and saving + :param request_timeout: Request timeout + :return: On success, the sent :class:`aiogram.types.message.Message` is returned. + """ + + call = ForwardMessage( + chat_id=chat_id, + from_chat_id=from_chat_id, + message_id=message_id, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + ) + return await self(call, request_timeout=request_timeout) + + async def get_chat( + self, + chat_id: Union[int, str], + request_timeout: Optional[int] = None, + ) -> ChatFullInfo: + """ + Use this method to get up-to-date information about the chat. Returns a :class:`aiogram.types.chat_full_info.ChatFullInfo` object on success. + + Source: https://core.telegram.org/bots/api#getchat + + :param chat_id: Unique identifier for the target chat or username of the target supergroup or channel (in the format :code:`@channelusername`) + :param request_timeout: Request timeout + :return: Returns a :class:`aiogram.types.chat_full_info.ChatFullInfo` object on success. + """ + + call = GetChat( + chat_id=chat_id, + ) + return await self(call, request_timeout=request_timeout) + + async def get_chat_administrators( + self, + chat_id: Union[int, str], + request_timeout: Optional[int] = None, + ) -> List[ + Union[ + ChatMemberOwner, + ChatMemberAdministrator, + ChatMemberMember, + ChatMemberRestricted, + ChatMemberLeft, + ChatMemberBanned, + ] + ]: + """ + Use this method to get a list of administrators in a chat, which aren't bots. Returns an Array of :class:`aiogram.types.chat_member.ChatMember` objects. + + Source: https://core.telegram.org/bots/api#getchatadministrators + + :param chat_id: Unique identifier for the target chat or username of the target supergroup or channel (in the format :code:`@channelusername`) + :param request_timeout: Request timeout + :return: Returns an Array of :class:`aiogram.types.chat_member.ChatMember` objects. + """ + + call = GetChatAdministrators( + chat_id=chat_id, + ) + return await self(call, request_timeout=request_timeout) + + async def get_chat_member( + self, + chat_id: Union[int, str], + user_id: int, + request_timeout: Optional[int] = None, + ) -> Union[ + ChatMemberOwner, + ChatMemberAdministrator, + ChatMemberMember, + ChatMemberRestricted, + ChatMemberLeft, + ChatMemberBanned, + ]: + """ + Use this method to get information about a member of a chat. The method is only guaranteed to work for other users if the bot is an administrator in the chat. Returns a :class:`aiogram.types.chat_member.ChatMember` object on success. + + Source: https://core.telegram.org/bots/api#getchatmember + + :param chat_id: Unique identifier for the target chat or username of the target supergroup or channel (in the format :code:`@channelusername`) + :param user_id: Unique identifier of the target user + :param request_timeout: Request timeout + :return: Returns a :class:`aiogram.types.chat_member.ChatMember` object on success. + """ + + call = GetChatMember( + chat_id=chat_id, + user_id=user_id, + ) + return await self(call, request_timeout=request_timeout) + + async def get_chat_member_count( + self, + chat_id: Union[int, str], + request_timeout: Optional[int] = None, + ) -> int: + """ + Use this method to get the number of members in a chat. Returns *Int* on success. + + Source: https://core.telegram.org/bots/api#getchatmembercount + + :param chat_id: Unique identifier for the target chat or username of the target supergroup or channel (in the format :code:`@channelusername`) + :param request_timeout: Request timeout + :return: Returns *Int* on success. + """ + + call = GetChatMemberCount( + chat_id=chat_id, + ) + return await self(call, request_timeout=request_timeout) + + async def get_chat_menu_button( + self, + chat_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Union[MenuButtonDefault, MenuButtonWebApp, MenuButtonCommands]: + """ + Use this method to get the current value of the bot's menu button in a private chat, or the default menu button. Returns :class:`aiogram.types.menu_button.MenuButton` on success. + + Source: https://core.telegram.org/bots/api#getchatmenubutton + + :param chat_id: Unique identifier for the target private chat. If not specified, default bot's menu button will be returned + :param request_timeout: Request timeout + :return: Returns :class:`aiogram.types.menu_button.MenuButton` on success. + """ + + call = GetChatMenuButton( + chat_id=chat_id, + ) + return await self(call, request_timeout=request_timeout) + + async def get_custom_emoji_stickers( + self, + custom_emoji_ids: List[str], + request_timeout: Optional[int] = None, + ) -> List[Sticker]: + """ + Use this method to get information about custom emoji stickers by their identifiers. Returns an Array of :class:`aiogram.types.sticker.Sticker` objects. + + Source: https://core.telegram.org/bots/api#getcustomemojistickers + + :param custom_emoji_ids: A JSON-serialized list of custom emoji identifiers. At most 200 custom emoji identifiers can be specified. + :param request_timeout: Request timeout + :return: Returns an Array of :class:`aiogram.types.sticker.Sticker` objects. + """ + + call = GetCustomEmojiStickers( + custom_emoji_ids=custom_emoji_ids, + ) + return await self(call, request_timeout=request_timeout) + + async def get_file( + self, + file_id: str, + request_timeout: Optional[int] = None, + ) -> File: + """ + Use this method to get basic information about a file and prepare it for downloading. For the moment, bots can download files of up to 20MB in size. On success, a :class:`aiogram.types.file.File` object is returned. The file can then be downloaded via the link :code:`https://api.telegram.org/file/bot/`, where :code:`` is taken from the response. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling :class:`aiogram.methods.get_file.GetFile` again. + **Note:** This function may not preserve the original file name and MIME type. You should save the file's MIME type and name (if available) when the File object is received. + + Source: https://core.telegram.org/bots/api#getfile + + :param file_id: File identifier to get information about + :param request_timeout: Request timeout + :return: You should save the file's MIME type and name (if available) when the File object is received. + """ + + call = GetFile( + file_id=file_id, + ) + return await self(call, request_timeout=request_timeout) + + async def get_forum_topic_icon_stickers( + self, + request_timeout: Optional[int] = None, + ) -> List[Sticker]: + """ + Use this method to get custom emoji stickers, which can be used as a forum topic icon by any user. Requires no parameters. Returns an Array of :class:`aiogram.types.sticker.Sticker` objects. + + Source: https://core.telegram.org/bots/api#getforumtopiciconstickers + + :param request_timeout: Request timeout + :return: Returns an Array of :class:`aiogram.types.sticker.Sticker` objects. + """ + + call = GetForumTopicIconStickers() + return await self(call, request_timeout=request_timeout) + + async def get_game_high_scores( + self, + user_id: int, + chat_id: Optional[int] = None, + message_id: Optional[int] = None, + inline_message_id: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> List[GameHighScore]: + """ + Use this method to get data for high score tables. Will return the score of the specified user and several of their neighbors in a game. Returns an Array of :class:`aiogram.types.game_high_score.GameHighScore` objects. + + This method will currently return scores for the target user, plus two of their closest neighbors on each side. Will also return the top three users if the user and their neighbors are not among them. Please note that this behavior is subject to change. + + Source: https://core.telegram.org/bots/api#getgamehighscores + + :param user_id: Target user id + :param chat_id: Required if *inline_message_id* is not specified. Unique identifier for the target chat + :param message_id: Required if *inline_message_id* is not specified. Identifier of the sent message + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param request_timeout: Request timeout + :return: Please note that this behavior is subject to change. + """ + + call = GetGameHighScores( + user_id=user_id, + chat_id=chat_id, + message_id=message_id, + inline_message_id=inline_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def get_me( + self, + request_timeout: Optional[int] = None, + ) -> User: + """ + A simple method for testing your bot's authentication token. Requires no parameters. Returns basic information about the bot in form of a :class:`aiogram.types.user.User` object. + + Source: https://core.telegram.org/bots/api#getme + + :param request_timeout: Request timeout + :return: Returns basic information about the bot in form of a :class:`aiogram.types.user.User` object. + """ + + call = GetMe() + return await self(call, request_timeout=request_timeout) + + async def get_my_commands( + self, + scope: Optional[ + Union[ + BotCommandScopeDefault, + BotCommandScopeAllPrivateChats, + BotCommandScopeAllGroupChats, + BotCommandScopeAllChatAdministrators, + BotCommandScopeChat, + BotCommandScopeChatAdministrators, + BotCommandScopeChatMember, + ] + ] = None, + language_code: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> List[BotCommand]: + """ + Use this method to get the current list of the bot's commands for the given scope and user language. Returns an Array of :class:`aiogram.types.bot_command.BotCommand` objects. If commands aren't set, an empty list is returned. + + Source: https://core.telegram.org/bots/api#getmycommands + + :param scope: A JSON-serialized object, describing scope of users. Defaults to :class:`aiogram.types.bot_command_scope_default.BotCommandScopeDefault`. + :param language_code: A two-letter ISO 639-1 language code or an empty string + :param request_timeout: Request timeout + :return: If commands aren't set, an empty list is returned. + """ + + call = GetMyCommands( + scope=scope, + language_code=language_code, + ) + return await self(call, request_timeout=request_timeout) + + async def get_my_default_administrator_rights( + self, + for_channels: Optional[bool] = None, + request_timeout: Optional[int] = None, + ) -> ChatAdministratorRights: + """ + Use this method to get the current default administrator rights of the bot. Returns :class:`aiogram.types.chat_administrator_rights.ChatAdministratorRights` on success. + + Source: https://core.telegram.org/bots/api#getmydefaultadministratorrights + + :param for_channels: Pass :code:`True` to get default administrator rights of the bot in channels. Otherwise, default administrator rights of the bot for groups and supergroups will be returned. + :param request_timeout: Request timeout + :return: Returns :class:`aiogram.types.chat_administrator_rights.ChatAdministratorRights` on success. + """ + + call = GetMyDefaultAdministratorRights( + for_channels=for_channels, + ) + return await self(call, request_timeout=request_timeout) + + async def get_sticker_set( + self, + name: str, + request_timeout: Optional[int] = None, + ) -> StickerSet: + """ + Use this method to get a sticker set. On success, a :class:`aiogram.types.sticker_set.StickerSet` object is returned. + + Source: https://core.telegram.org/bots/api#getstickerset + + :param name: Name of the sticker set + :param request_timeout: Request timeout + :return: On success, a :class:`aiogram.types.sticker_set.StickerSet` object is returned. + """ + + call = GetStickerSet( + name=name, + ) + return await self(call, request_timeout=request_timeout) + + async def get_updates( + self, + offset: Optional[int] = None, + limit: Optional[int] = None, + timeout: Optional[int] = None, + allowed_updates: Optional[List[str]] = None, + request_timeout: Optional[int] = None, + ) -> List[Update]: + """ + Use this method to receive incoming updates using long polling (`wiki `_). Returns an Array of :class:`aiogram.types.update.Update` objects. + + **Notes** + + **1.** This method will not work if an outgoing webhook is set up. + + **2.** In order to avoid getting duplicate updates, recalculate *offset* after each server response. + + Source: https://core.telegram.org/bots/api#getupdates + + :param offset: Identifier of the first update to be returned. Must be greater by one than the highest among the identifiers of previously received updates. By default, updates starting with the earliest unconfirmed update are returned. An update is considered confirmed as soon as :class:`aiogram.methods.get_updates.GetUpdates` is called with an *offset* higher than its *update_id*. The negative offset can be specified to retrieve updates starting from *-offset* update from the end of the updates queue. All previous updates will be forgotten. + :param limit: Limits the number of updates to be retrieved. Values between 1-100 are accepted. Defaults to 100. + :param timeout: Timeout in seconds for long polling. Defaults to 0, i.e. usual short polling. Should be positive, short polling should be used for testing purposes only. + :param allowed_updates: A JSON-serialized list of the update types you want your bot to receive. For example, specify :code:`["message", "edited_channel_post", "callback_query"]` to only receive updates of these types. See :class:`aiogram.types.update.Update` for a complete list of available update types. Specify an empty list to receive all update types except *chat_member*, *message_reaction*, and *message_reaction_count* (default). If not specified, the previous setting will be used. + :param request_timeout: Request timeout + :return: Returns an Array of :class:`aiogram.types.update.Update` objects. + """ + + call = GetUpdates( + offset=offset, + limit=limit, + timeout=timeout, + allowed_updates=allowed_updates, + ) + return await self(call, request_timeout=request_timeout) + + async def get_user_profile_photos( + self, + user_id: int, + offset: Optional[int] = None, + limit: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> UserProfilePhotos: + """ + Use this method to get a list of profile pictures for a user. Returns a :class:`aiogram.types.user_profile_photos.UserProfilePhotos` object. + + Source: https://core.telegram.org/bots/api#getuserprofilephotos + + :param user_id: Unique identifier of the target user + :param offset: Sequential number of the first photo to be returned. By default, all photos are returned. + :param limit: Limits the number of photos to be retrieved. Values between 1-100 are accepted. Defaults to 100. + :param request_timeout: Request timeout + :return: Returns a :class:`aiogram.types.user_profile_photos.UserProfilePhotos` object. + """ + + call = GetUserProfilePhotos( + user_id=user_id, + offset=offset, + limit=limit, + ) + return await self(call, request_timeout=request_timeout) + + async def get_webhook_info( + self, + request_timeout: Optional[int] = None, + ) -> WebhookInfo: + """ + Use this method to get current webhook status. Requires no parameters. On success, returns a :class:`aiogram.types.webhook_info.WebhookInfo` object. If the bot is using :class:`aiogram.methods.get_updates.GetUpdates`, will return an object with the *url* field empty. + + Source: https://core.telegram.org/bots/api#getwebhookinfo + + :param request_timeout: Request timeout + :return: If the bot is using :class:`aiogram.methods.get_updates.GetUpdates`, will return an object with the *url* field empty. + """ + + call = GetWebhookInfo() + return await self(call, request_timeout=request_timeout) + + async def leave_chat( + self, + chat_id: Union[int, str], + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method for your bot to leave a group, supergroup or channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#leavechat + + :param chat_id: Unique identifier for the target chat or username of the target supergroup or channel (in the format :code:`@channelusername`) + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = LeaveChat( + chat_id=chat_id, + ) + return await self(call, request_timeout=request_timeout) + + async def log_out( + self, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to log out from the cloud Bot API server before launching the bot locally. You **must** log out the bot before running it locally, otherwise there is no guarantee that the bot will receive updates. After a successful call, you can immediately log in on a local server, but will not be able to log in back to the cloud Bot API server for 10 minutes. Returns :code:`True` on success. Requires no parameters. + + Source: https://core.telegram.org/bots/api#logout + + :param request_timeout: Request timeout + :return: Requires no parameters. + """ + + call = LogOut() + return await self(call, request_timeout=request_timeout) + + async def pin_chat_message( + self, + chat_id: Union[int, str], + message_id: int, + business_connection_id: Optional[str] = None, + disable_notification: Optional[bool] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to add a message to the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' administrator right in a supergroup or 'can_edit_messages' administrator right in a channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#pinchatmessage + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param message_id: Identifier of a message to pin + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be pinned + :param disable_notification: Pass :code:`True` if it is not necessary to send a notification to all chat members about the new pinned message. Notifications are always disabled in channels and private chats. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = PinChatMessage( + chat_id=chat_id, + message_id=message_id, + business_connection_id=business_connection_id, + disable_notification=disable_notification, + ) + return await self(call, request_timeout=request_timeout) + + async def promote_chat_member( + self, + chat_id: Union[int, str], + user_id: int, + is_anonymous: Optional[bool] = None, + can_manage_chat: Optional[bool] = None, + can_delete_messages: Optional[bool] = None, + can_manage_video_chats: Optional[bool] = None, + can_restrict_members: Optional[bool] = None, + can_promote_members: Optional[bool] = None, + can_change_info: Optional[bool] = None, + can_invite_users: Optional[bool] = None, + can_post_stories: Optional[bool] = None, + can_edit_stories: Optional[bool] = None, + can_delete_stories: Optional[bool] = None, + can_post_messages: Optional[bool] = None, + can_edit_messages: Optional[bool] = None, + can_pin_messages: Optional[bool] = None, + can_manage_topics: Optional[bool] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to promote or demote a user in a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Pass :code:`False` for all boolean parameters to demote a user. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#promotechatmember + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param user_id: Unique identifier of the target user + :param is_anonymous: Pass :code:`True` if the administrator's presence in the chat is hidden + :param can_manage_chat: Pass :code:`True` if the administrator can access the chat event log, get boost list, see hidden supergroup and channel members, report spam messages and ignore slow mode. Implied by any other administrator privilege. + :param can_delete_messages: Pass :code:`True` if the administrator can delete messages of other users + :param can_manage_video_chats: Pass :code:`True` if the administrator can manage video chats + :param can_restrict_members: Pass :code:`True` if the administrator can restrict, ban or unban chat members, or access supergroup statistics + :param can_promote_members: Pass :code:`True` if the administrator can add new administrators with a subset of their own privileges or demote administrators that they have promoted, directly or indirectly (promoted by administrators that were appointed by him) + :param can_change_info: Pass :code:`True` if the administrator can change chat title, photo and other settings + :param can_invite_users: Pass :code:`True` if the administrator can invite new users to the chat + :param can_post_stories: Pass :code:`True` if the administrator can post stories to the chat + :param can_edit_stories: Pass :code:`True` if the administrator can edit stories posted by other users, post stories to the chat page, pin chat stories, and access the chat's story archive + :param can_delete_stories: Pass :code:`True` if the administrator can delete stories posted by other users + :param can_post_messages: Pass :code:`True` if the administrator can post messages in the channel, or access channel statistics; for channels only + :param can_edit_messages: Pass :code:`True` if the administrator can edit messages of other users and can pin messages; for channels only + :param can_pin_messages: Pass :code:`True` if the administrator can pin messages; for supergroups only + :param can_manage_topics: Pass :code:`True` if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = PromoteChatMember( + chat_id=chat_id, + user_id=user_id, + is_anonymous=is_anonymous, + can_manage_chat=can_manage_chat, + can_delete_messages=can_delete_messages, + can_manage_video_chats=can_manage_video_chats, + can_restrict_members=can_restrict_members, + can_promote_members=can_promote_members, + can_change_info=can_change_info, + can_invite_users=can_invite_users, + can_post_stories=can_post_stories, + can_edit_stories=can_edit_stories, + can_delete_stories=can_delete_stories, + can_post_messages=can_post_messages, + can_edit_messages=can_edit_messages, + can_pin_messages=can_pin_messages, + can_manage_topics=can_manage_topics, + ) + return await self(call, request_timeout=request_timeout) + + async def reopen_forum_topic( + self, + chat_id: Union[int, str], + message_thread_id: int, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to reopen a closed topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights, unless it is the creator of the topic. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#reopenforumtopic + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param message_thread_id: Unique identifier for the target message thread of the forum topic + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = ReopenForumTopic( + chat_id=chat_id, + message_thread_id=message_thread_id, + ) + return await self(call, request_timeout=request_timeout) + + async def restrict_chat_member( + self, + chat_id: Union[int, str], + user_id: int, + permissions: ChatPermissions, + use_independent_chat_permissions: Optional[bool] = None, + until_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to restrict a user in a supergroup. The bot must be an administrator in the supergroup for this to work and must have the appropriate administrator rights. Pass :code:`True` for all permissions to lift restrictions from a user. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#restrictchatmember + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param user_id: Unique identifier of the target user + :param permissions: A JSON-serialized object for new user permissions + :param use_independent_chat_permissions: Pass :code:`True` if chat permissions are set independently. Otherwise, the *can_send_other_messages* and *can_add_web_page_previews* permissions will imply the *can_send_messages*, *can_send_audios*, *can_send_documents*, *can_send_photos*, *can_send_videos*, *can_send_video_notes*, and *can_send_voice_notes* permissions; the *can_send_polls* permission will imply the *can_send_messages* permission. + :param until_date: Date when restrictions will be lifted for the user; Unix time. If user is restricted for more than 366 days or less than 30 seconds from the current time, they are considered to be restricted forever + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = RestrictChatMember( + chat_id=chat_id, + user_id=user_id, + permissions=permissions, + use_independent_chat_permissions=use_independent_chat_permissions, + until_date=until_date, + ) + return await self(call, request_timeout=request_timeout) + + async def revoke_chat_invite_link( + self, + chat_id: Union[int, str], + invite_link: str, + request_timeout: Optional[int] = None, + ) -> ChatInviteLink: + """ + Use this method to revoke an invite link created by the bot. If the primary link is revoked, a new link is automatically generated. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the revoked invite link as :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + + Source: https://core.telegram.org/bots/api#revokechatinvitelink + + :param chat_id: Unique identifier of the target chat or username of the target channel (in the format :code:`@channelusername`) + :param invite_link: The invite link to revoke + :param request_timeout: Request timeout + :return: Returns the revoked invite link as :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + """ + + call = RevokeChatInviteLink( + chat_id=chat_id, + invite_link=invite_link, + ) + return await self(call, request_timeout=request_timeout) + + async def send_animation( + self, + chat_id: Union[int, str], + animation: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + duration: Optional[int] = None, + width: Optional[int] = None, + height: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to send animation files (GIF or H.264/MPEG-4 AVC video without sound). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send animation files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendanimation + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param animation: Animation to send. Pass a file_id as String to send an animation that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an animation from the Internet, or upload a new animation using multipart/form-data. :ref:`More information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param duration: Duration of sent animation in seconds + :param width: Animation width + :param height: Animation height + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Animation caption (may also be used when resending animation by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the animation caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the animation needs to be covered with a spoiler animation + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: Bots can currently send animation files of up to 50 MB in size, this limit may be changed in the future. + """ + + call = SendAnimation( + chat_id=chat_id, + animation=animation, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + duration=duration, + width=width, + height=height, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_audio( + self, + chat_id: Union[int, str], + audio: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + performer: Optional[str] = None, + title: Optional[str] = None, + thumbnail: Optional[InputFile] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to send audio files, if you want Telegram clients to display them in the music player. Your audio must be in the .MP3 or .M4A format. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future. + For sending voice messages, use the :class:`aiogram.methods.send_voice.SendVoice` method instead. + + Source: https://core.telegram.org/bots/api#sendaudio + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param audio: Audio file to send. Pass a file_id as String to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param caption: Audio caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the audio caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param duration: Duration of the audio in seconds + :param performer: Performer + :param title: Track name + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future. + """ + + call = SendAudio( + chat_id=chat_id, + audio=audio, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + duration=duration, + performer=performer, + title=title, + thumbnail=thumbnail, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_chat_action( + self, + chat_id: Union[int, str], + action: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method when you need to tell the user that something is happening on the bot's side. The status is set for 5 seconds or less (when a message arrives from your bot, Telegram clients clear its typing status). Returns :code:`True` on success. + + Example: The `ImageBot `_ needs some time to process a request and upload the image. Instead of sending a text message along the lines of 'Retrieving image, please wait…', the bot may use :class:`aiogram.methods.send_chat_action.SendChatAction` with *action* = *upload_photo*. The user will see a 'sending photo' status for the bot. + + We only recommend using this method when a response from the bot will take a **noticeable** amount of time to arrive. + + Source: https://core.telegram.org/bots/api#sendchataction + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param action: Type of action to broadcast. Choose one, depending on what the user is about to receive: *typing* for `text messages `_, *upload_photo* for `photos `_, *record_video* or *upload_video* for `videos `_, *record_voice* or *upload_voice* for `voice notes `_, *upload_document* for `general files `_, *choose_sticker* for `stickers `_, *find_location* for `location data `_, *record_video_note* or *upload_video_note* for `video notes `_. + :param business_connection_id: Unique identifier of the business connection on behalf of which the action will be sent + :param message_thread_id: Unique identifier for the target message thread; for supergroups only + :param request_timeout: Request timeout + :return: The user will see a 'sending photo' status for the bot. + """ + + call = SendChatAction( + chat_id=chat_id, + action=action, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_contact( + self, + chat_id: Union[int, str], + phone_number: str, + first_name: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + last_name: Optional[str] = None, + vcard: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to send phone contacts. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendcontact + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param phone_number: Contact's phone number + :param first_name: Contact's first name + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param last_name: Contact's last name + :param vcard: Additional data about the contact in the form of a `vCard `_, 0-2048 bytes + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: On success, the sent :class:`aiogram.types.message.Message` is returned. + """ + + call = SendContact( + chat_id=chat_id, + phone_number=phone_number, + first_name=first_name, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + last_name=last_name, + vcard=vcard, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_dice( + self, + chat_id: Union[int, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + emoji: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to send an animated emoji that will display a random value. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#senddice + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param emoji: Emoji on which the dice throw animation is based. Currently, must be one of '🎲', '🎯', '🏀', '⚽', '🎳', or '🎰'. Dice can have values 1-6 for '🎲', '🎯' and '🎳', values 1-5 for '🏀' and '⚽', and values 1-64 for '🎰'. Defaults to '🎲' + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: On success, the sent :class:`aiogram.types.message.Message` is returned. + """ + + call = SendDice( + chat_id=chat_id, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + emoji=emoji, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_document( + self, + chat_id: Union[int, str], + document: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + disable_content_type_detection: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to send general files. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#senddocument + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param document: File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), 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 information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Document caption (may also be used when resending documents by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the document caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param disable_content_type_detection: Disables automatic server-side content type detection for files uploaded using multipart/form-data + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future. + """ + + call = SendDocument( + chat_id=chat_id, + document=document, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + disable_content_type_detection=disable_content_type_detection, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_game( + self, + chat_id: int, + game_short_name: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to send a game. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendgame + + :param chat_id: Unique identifier for the target chat + :param game_short_name: Short name of the game, serves as the unique identifier for the game. Set up your games via `@BotFather `_. + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game. + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: On success, the sent :class:`aiogram.types.message.Message` is returned. + """ + + call = SendGame( + chat_id=chat_id, + game_short_name=game_short_name, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_invoice( + self, + chat_id: Union[int, str], + title: str, + description: str, + payload: str, + currency: str, + prices: List[LabeledPrice], + message_thread_id: Optional[int] = None, + provider_token: Optional[str] = None, + max_tip_amount: Optional[int] = None, + suggested_tip_amounts: Optional[List[int]] = None, + start_parameter: Optional[str] = None, + provider_data: Optional[str] = None, + photo_url: Optional[str] = None, + photo_size: Optional[int] = None, + photo_width: Optional[int] = None, + photo_height: Optional[int] = None, + need_name: Optional[bool] = None, + need_phone_number: Optional[bool] = None, + need_email: Optional[bool] = None, + need_shipping_address: Optional[bool] = None, + send_phone_number_to_provider: Optional[bool] = None, + send_email_to_provider: Optional[bool] = None, + is_flexible: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to send invoices. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendinvoice + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param title: Product name, 1-32 characters + :param description: Product description, 1-255 characters + :param payload: Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use for your internal processes. + :param currency: Three-letter ISO 4217 currency code, see `more on currencies `_. Pass 'XTR' for payments in `Telegram Stars `_. + :param prices: Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.). Must contain exactly one item for payments in `Telegram Stars `_. + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param provider_token: Payment provider token, obtained via `@BotFather `_. Pass an empty string for payments in `Telegram Stars `_. + :param max_tip_amount: The maximum accepted amount for tips in the *smallest units* of the currency (integer, **not** float/double). For example, for a maximum tip of :code:`US$ 1.45` pass :code:`max_tip_amount = 145`. See the *exp* parameter in `currencies.json `_, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0. Not supported for payments in `Telegram Stars `_. + :param suggested_tip_amounts: A JSON-serialized array of suggested amounts of tips in the *smallest units* of the currency (integer, **not** float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed *max_tip_amount*. + :param start_parameter: Unique deep-linking parameter. If left empty, **forwarded copies** of the sent message will have a *Pay* button, allowing multiple users to pay directly from the forwarded message, using the same invoice. If non-empty, forwarded copies of the sent message will have a *URL* button with a deep link to the bot (instead of a *Pay* button), with the value used as the start parameter + :param provider_data: JSON-serialized data about the invoice, which will be shared with the payment provider. A detailed description of required fields should be provided by the payment provider. + :param photo_url: URL of the product photo for the invoice. Can be a photo of the goods or a marketing image for a service. People like it better when they see what they are paying for. + :param photo_size: Photo size in bytes + :param photo_width: Photo width + :param photo_height: Photo height + :param need_name: Pass :code:`True` if you require the user's full name to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_phone_number: Pass :code:`True` if you require the user's phone number to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_email: Pass :code:`True` if you require the user's email address to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_shipping_address: Pass :code:`True` if you require the user's shipping address to complete the order. Ignored for payments in `Telegram Stars `_. + :param send_phone_number_to_provider: Pass :code:`True` if the user's phone number should be sent to the provider. Ignored for payments in `Telegram Stars `_. + :param send_email_to_provider: Pass :code:`True` if the user's email address should be sent to the provider. Ignored for payments in `Telegram Stars `_. + :param is_flexible: Pass :code:`True` if the final price depends on the shipping method. Ignored for payments in `Telegram Stars `_. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Pay :code:`total price`' button will be shown. If not empty, the first button must be a Pay button. + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: On success, the sent :class:`aiogram.types.message.Message` is returned. + """ + + call = SendInvoice( + chat_id=chat_id, + title=title, + description=description, + payload=payload, + currency=currency, + prices=prices, + message_thread_id=message_thread_id, + provider_token=provider_token, + max_tip_amount=max_tip_amount, + suggested_tip_amounts=suggested_tip_amounts, + start_parameter=start_parameter, + provider_data=provider_data, + photo_url=photo_url, + photo_size=photo_size, + photo_width=photo_width, + photo_height=photo_height, + need_name=need_name, + need_phone_number=need_phone_number, + need_email=need_email, + need_shipping_address=need_shipping_address, + send_phone_number_to_provider=send_phone_number_to_provider, + send_email_to_provider=send_email_to_provider, + is_flexible=is_flexible, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_location( + self, + chat_id: Union[int, str], + latitude: float, + longitude: float, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + horizontal_accuracy: Optional[float] = None, + live_period: Optional[int] = None, + heading: Optional[int] = None, + proximity_alert_radius: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to send point on the map. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendlocation + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param latitude: Latitude of the location + :param longitude: Longitude of the location + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param horizontal_accuracy: The radius of uncertainty for the location, measured in meters; 0-1500 + :param live_period: Period in seconds during which the location will be updated (see `Live Locations `_, should be between 60 and 86400, or 0x7FFFFFFF for live locations that can be edited indefinitely. + :param heading: For live locations, a direction in which the user is moving, in degrees. Must be between 1 and 360 if specified. + :param proximity_alert_radius: For live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: On success, the sent :class:`aiogram.types.message.Message` is returned. + """ + + call = SendLocation( + chat_id=chat_id, + latitude=latitude, + longitude=longitude, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + horizontal_accuracy=horizontal_accuracy, + live_period=live_period, + heading=heading, + proximity_alert_radius=proximity_alert_radius, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_media_group( + self, + chat_id: Union[int, str], + media: List[Union[InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo]], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> List[Message]: + """ + Use this method to send a group of photos, videos, documents or audios as an album. Documents and audio files can be only grouped in an album with messages of the same type. On success, an array of `Messages `_ that were sent is returned. + + Source: https://core.telegram.org/bots/api#sendmediagroup + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param media: A JSON-serialized array describing messages to be sent, must include 2-10 items + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param disable_notification: Sends messages `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent messages from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the messages are a reply, ID of the original message + :param request_timeout: Request timeout + :return: On success, an array of `Messages `_ that were sent is returned. + """ + + call = SendMediaGroup( + chat_id=chat_id, + media=media, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_message( + self, + chat_id: Union[int, str], + text: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + entities: Optional[List[MessageEntity]] = None, + link_preview_options: Optional[Union[LinkPreviewOptions, Default]] = Default( + "link_preview" + ), + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + disable_web_page_preview: Optional[Union[bool, Default]] = Default( + "link_preview_is_disabled" + ), + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to send text messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendmessage + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param text: Text of the message to be sent, 1-4096 characters after entities parsing + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param parse_mode: Mode for parsing entities in the message text. See `formatting options `_ for more details. + :param entities: A JSON-serialized list of special entities that appear in message text, which can be specified instead of *parse_mode* + :param link_preview_options: Link preview generation options for the message + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param disable_web_page_preview: Disables link previews for links in this message + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: On success, the sent :class:`aiogram.types.message.Message` is returned. + """ + + call = SendMessage( + chat_id=chat_id, + text=text, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + parse_mode=parse_mode, + entities=entities, + link_preview_options=link_preview_options, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + disable_web_page_preview=disable_web_page_preview, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_photo( + self, + chat_id: Union[int, str], + photo: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to send photos. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendphoto + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param photo: Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data. The photo must be at most 10 MB in size. The photo's width and height must not exceed 10000 in total. Width and height ratio must be at most 20. :ref:`More information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param caption: Photo caption (may also be used when resending photos by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the photo caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the photo needs to be covered with a spoiler animation + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: On success, the sent :class:`aiogram.types.message.Message` is returned. + """ + + call = SendPhoto( + chat_id=chat_id, + photo=photo, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_poll( + self, + chat_id: Union[int, str], + question: str, + options: List[Union[InputPollOption, str]], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + question_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + question_entities: Optional[List[MessageEntity]] = None, + is_anonymous: Optional[bool] = None, + type: Optional[str] = None, + allows_multiple_answers: Optional[bool] = None, + correct_option_id: Optional[int] = None, + explanation: Optional[str] = None, + explanation_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + explanation_entities: Optional[List[MessageEntity]] = None, + open_period: Optional[int] = None, + close_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + is_closed: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to send a native poll. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendpoll + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param question: Poll question, 1-300 characters + :param options: A JSON-serialized list of 2-10 answer options + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param question_parse_mode: Mode for parsing entities in the question. See `formatting options `_ for more details. Currently, only custom emoji entities are allowed + :param question_entities: A JSON-serialized list of special entities that appear in the poll question. It can be specified instead of *question_parse_mode* + :param is_anonymous: :code:`True`, if the poll needs to be anonymous, defaults to :code:`True` + :param type: Poll type, 'quiz' or 'regular', defaults to 'regular' + :param allows_multiple_answers: :code:`True`, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to :code:`False` + :param correct_option_id: 0-based identifier of the correct answer option, required for polls in quiz mode + :param explanation: Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing + :param explanation_parse_mode: Mode for parsing entities in the explanation. See `formatting options `_ for more details. + :param explanation_entities: A JSON-serialized list of special entities that appear in the poll explanation. It can be specified instead of *explanation_parse_mode* + :param open_period: Amount of time in seconds the poll will be active after creation, 5-600. Can't be used together with *close_date*. + :param close_date: Point in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future. Can't be used together with *open_period*. + :param is_closed: Pass :code:`True` if the poll needs to be immediately closed. This can be useful for poll preview. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: On success, the sent :class:`aiogram.types.message.Message` is returned. + """ + + call = SendPoll( + chat_id=chat_id, + question=question, + options=options, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + question_parse_mode=question_parse_mode, + question_entities=question_entities, + is_anonymous=is_anonymous, + type=type, + allows_multiple_answers=allows_multiple_answers, + correct_option_id=correct_option_id, + explanation=explanation, + explanation_parse_mode=explanation_parse_mode, + explanation_entities=explanation_entities, + open_period=open_period, + close_date=close_date, + is_closed=is_closed, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_sticker( + self, + chat_id: Union[int, str], + sticker: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + emoji: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to send static .WEBP, `animated `_ .TGS, or `video `_ .WEBM stickers. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendsticker + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP, .TGS, or .WEBM sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video and animated stickers can't be sent via an HTTP URL. + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param emoji: Emoji associated with the sticker; only for just uploaded stickers + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: On success, the sent :class:`aiogram.types.message.Message` is returned. + """ + + call = SendSticker( + chat_id=chat_id, + sticker=sticker, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + emoji=emoji, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_venue( + self, + chat_id: Union[int, str], + latitude: float, + longitude: float, + title: str, + address: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + foursquare_id: Optional[str] = None, + foursquare_type: Optional[str] = None, + google_place_id: Optional[str] = None, + google_place_type: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to send information about a venue. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvenue + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param latitude: Latitude of the venue + :param longitude: Longitude of the venue + :param title: Name of the venue + :param address: Address of the venue + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param foursquare_id: Foursquare identifier of the venue + :param foursquare_type: Foursquare type of the venue, if known. (For example, 'arts_entertainment/default', 'arts_entertainment/aquarium' or 'food/icecream'.) + :param google_place_id: Google Places identifier of the venue + :param google_place_type: Google Places type of the venue. (See `supported types `_.) + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: On success, the sent :class:`aiogram.types.message.Message` is returned. + """ + + call = SendVenue( + chat_id=chat_id, + latitude=latitude, + longitude=longitude, + title=title, + address=address, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + foursquare_id=foursquare_id, + foursquare_type=foursquare_type, + google_place_id=google_place_id, + google_place_type=google_place_type, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_video( + self, + chat_id: Union[int, str], + video: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + duration: Optional[int] = None, + width: Optional[int] = None, + height: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + supports_streaming: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to send video files, Telegram clients support MPEG4 videos (other formats may be sent as :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvideo + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param video: Video to send. Pass a file_id as String to send a video that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a video from the Internet, or upload a new video using multipart/form-data. :ref:`More information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param duration: Duration of sent video in seconds + :param width: Video width + :param height: Video height + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Video caption (may also be used when resending videos by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the video caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the video needs to be covered with a spoiler animation + :param supports_streaming: Pass :code:`True` if the uploaded video is suitable for streaming + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future. + """ + + call = SendVideo( + chat_id=chat_id, + video=video, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + duration=duration, + width=width, + height=height, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + supports_streaming=supports_streaming, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_video_note( + self, + chat_id: Union[int, str], + video_note: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + duration: Optional[int] = None, + length: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + As of `v.4.0 `_, Telegram clients support rounded square MPEG4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvideonote + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param video_note: Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data. :ref:`More information on Sending Files » `. Sending video notes by a URL is currently unsupported + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param duration: Duration of sent video in seconds + :param length: Video width and height, i.e. diameter of the video message + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: On success, the sent :class:`aiogram.types.message.Message` is returned. + """ + + call = SendVideoNote( + chat_id=chat_id, + video_note=video_note, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + duration=duration, + length=length, + thumbnail=thumbnail, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def send_voice( + self, + chat_id: Union[int, str], + voice: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to send audio files, if you want Telegram clients to display the file as a playable voice message. For this to work, your audio must be in an .OGG file encoded with OPUS, or in .MP3 format, or in .M4A format (other formats may be sent as :class:`aiogram.types.audio.Audio` or :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send voice messages of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvoice + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param voice: Audio file to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), 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 information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param caption: Voice message caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the voice message caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param duration: Duration of the voice message in seconds + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :param request_timeout: Request timeout + :return: Bots can currently send voice messages of up to 50 MB in size, this limit may be changed in the future. + """ + + call = SendVoice( + chat_id=chat_id, + voice=voice, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + duration=duration, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def set_chat_administrator_custom_title( + self, + chat_id: Union[int, str], + user_id: int, + custom_title: str, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to set a custom title for an administrator in a supergroup promoted by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatadministratorcustomtitle + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param user_id: Unique identifier of the target user + :param custom_title: New custom title for the administrator; 0-16 characters, emoji are not allowed + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetChatAdministratorCustomTitle( + chat_id=chat_id, + user_id=user_id, + custom_title=custom_title, + ) + return await self(call, request_timeout=request_timeout) + + async def set_chat_description( + self, + chat_id: Union[int, str], + description: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change the description of a group, a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatdescription + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param description: New chat description, 0-255 characters + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetChatDescription( + chat_id=chat_id, + description=description, + ) + return await self(call, request_timeout=request_timeout) + + async def set_chat_menu_button( + self, + chat_id: Optional[int] = None, + menu_button: Optional[ + Union[MenuButtonCommands, MenuButtonWebApp, MenuButtonDefault] + ] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change the bot's menu button in a private chat, or the default menu button. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatmenubutton + + :param chat_id: Unique identifier for the target private chat. If not specified, default bot's menu button will be changed + :param menu_button: A JSON-serialized object for the bot's new menu button. Defaults to :class:`aiogram.types.menu_button_default.MenuButtonDefault` + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetChatMenuButton( + chat_id=chat_id, + menu_button=menu_button, + ) + return await self(call, request_timeout=request_timeout) + + async def set_chat_permissions( + self, + chat_id: Union[int, str], + permissions: ChatPermissions, + use_independent_chat_permissions: Optional[bool] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to set default chat permissions for all members. The bot must be an administrator in the group or a supergroup for this to work and must have the *can_restrict_members* administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatpermissions + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param permissions: A JSON-serialized object for new default chat permissions + :param use_independent_chat_permissions: Pass :code:`True` if chat permissions are set independently. Otherwise, the *can_send_other_messages* and *can_add_web_page_previews* permissions will imply the *can_send_messages*, *can_send_audios*, *can_send_documents*, *can_send_photos*, *can_send_videos*, *can_send_video_notes*, and *can_send_voice_notes* permissions; the *can_send_polls* permission will imply the *can_send_messages* permission. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetChatPermissions( + chat_id=chat_id, + permissions=permissions, + use_independent_chat_permissions=use_independent_chat_permissions, + ) + return await self(call, request_timeout=request_timeout) + + async def set_chat_photo( + self, + chat_id: Union[int, str], + photo: InputFile, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to set a new profile photo for the chat. Photos can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatphoto + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param photo: New chat photo, uploaded using multipart/form-data + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetChatPhoto( + chat_id=chat_id, + photo=photo, + ) + return await self(call, request_timeout=request_timeout) + + async def set_chat_sticker_set( + self, + chat_id: Union[int, str], + sticker_set_name: str, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to set a new group sticker set for a supergroup. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Use the field *can_set_sticker_set* optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests to check if the bot can use this method. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatstickerset + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param sticker_set_name: Name of the sticker set to be set as the group sticker set + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetChatStickerSet( + chat_id=chat_id, + sticker_set_name=sticker_set_name, + ) + return await self(call, request_timeout=request_timeout) + + async def set_chat_title( + self, + chat_id: Union[int, str], + title: str, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change the title of a chat. Titles can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchattitle + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param title: New chat title, 1-128 characters + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetChatTitle( + chat_id=chat_id, + title=title, + ) + return await self(call, request_timeout=request_timeout) + + async def set_game_score( + self, + user_id: int, + score: int, + force: Optional[bool] = None, + disable_edit_message: Optional[bool] = None, + chat_id: Optional[int] = None, + message_id: Optional[int] = None, + inline_message_id: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> Union[Message, bool]: + """ + Use this method to set the score of the specified user in a game message. On success, if the message is not an inline message, the :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. Returns an error, if the new score is not greater than the user's current score in the chat and *force* is :code:`False`. + + Source: https://core.telegram.org/bots/api#setgamescore + + :param user_id: User identifier + :param score: New score, must be non-negative + :param force: Pass :code:`True` if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters + :param disable_edit_message: Pass :code:`True` if the game message should not be automatically edited to include the current scoreboard + :param chat_id: Required if *inline_message_id* is not specified. Unique identifier for the target chat + :param message_id: Required if *inline_message_id* is not specified. Identifier of the sent message + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param request_timeout: Request timeout + :return: Returns an error, if the new score is not greater than the user's current score in the chat and *force* is :code:`False`. + """ + + call = SetGameScore( + user_id=user_id, + score=score, + force=force, + disable_edit_message=disable_edit_message, + chat_id=chat_id, + message_id=message_id, + inline_message_id=inline_message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def set_my_commands( + self, + commands: List[BotCommand], + scope: Optional[ + Union[ + BotCommandScopeDefault, + BotCommandScopeAllPrivateChats, + BotCommandScopeAllGroupChats, + BotCommandScopeAllChatAdministrators, + BotCommandScopeChat, + BotCommandScopeChatAdministrators, + BotCommandScopeChatMember, + ] + ] = None, + language_code: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change the list of the bot's commands. See `this manual `_ for more details about bot commands. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmycommands + + :param commands: A JSON-serialized list of bot commands to be set as the list of the bot's commands. At most 100 commands can be specified. + :param scope: A JSON-serialized object, describing scope of users for which the commands are relevant. Defaults to :class:`aiogram.types.bot_command_scope_default.BotCommandScopeDefault`. + :param language_code: A two-letter ISO 639-1 language code. If empty, commands will be applied to all users from the given scope, for whose language there are no dedicated commands + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetMyCommands( + commands=commands, + scope=scope, + language_code=language_code, + ) + return await self(call, request_timeout=request_timeout) + + async def set_my_default_administrator_rights( + self, + rights: Optional[ChatAdministratorRights] = None, + for_channels: Optional[bool] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmydefaultadministratorrights + + :param rights: A JSON-serialized object describing new default administrator rights. If not specified, the default administrator rights will be cleared. + :param for_channels: Pass :code:`True` to change the default administrator rights of the bot in channels. Otherwise, the default administrator rights of the bot for groups and supergroups will be changed. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetMyDefaultAdministratorRights( + rights=rights, + for_channels=for_channels, + ) + return await self(call, request_timeout=request_timeout) + + async def set_passport_data_errors( + self, + user_id: int, + errors: List[ + Union[ + PassportElementErrorDataField, + PassportElementErrorFrontSide, + PassportElementErrorReverseSide, + PassportElementErrorSelfie, + PassportElementErrorFile, + PassportElementErrorFiles, + PassportElementErrorTranslationFile, + PassportElementErrorTranslationFiles, + PassportElementErrorUnspecified, + ] + ], + request_timeout: Optional[int] = None, + ) -> bool: + """ + Informs a user that some of the Telegram Passport elements they provided contains errors. The user will not be able to re-submit their Passport to you until the errors are fixed (the contents of the field for which you returned the error must change). Returns :code:`True` on success. + Use this if the data submitted by the user doesn't satisfy the standards your service requires for any reason. For example, if a birthday date seems invalid, a submitted document is blurry, a scan shows evidence of tampering, etc. Supply some details in the error message to make sure the user knows how to correct the issues. + + Source: https://core.telegram.org/bots/api#setpassportdataerrors + + :param user_id: User identifier + :param errors: A JSON-serialized array describing the errors + :param request_timeout: Request timeout + :return: Supply some details in the error message to make sure the user knows how to correct the issues. + """ + + call = SetPassportDataErrors( + user_id=user_id, + errors=errors, + ) + return await self(call, request_timeout=request_timeout) + + async def set_sticker_position_in_set( + self, + sticker: str, + position: int, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to move a sticker in a set created by the bot to a specific position. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickerpositioninset + + :param sticker: File identifier of the sticker + :param position: New sticker position in the set, zero-based + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetStickerPositionInSet( + sticker=sticker, + position=position, + ) + return await self(call, request_timeout=request_timeout) + + async def set_webhook( + self, + url: str, + certificate: Optional[InputFile] = None, + ip_address: Optional[str] = None, + max_connections: Optional[int] = None, + allowed_updates: Optional[List[str]] = None, + drop_pending_updates: Optional[bool] = None, + secret_token: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to specify a URL and receive incoming updates via an outgoing webhook. Whenever there is an update for the bot, we will send an HTTPS POST request to the specified URL, containing a JSON-serialized :class:`aiogram.types.update.Update`. In case of an unsuccessful request, we will give up after a reasonable amount of attempts. Returns :code:`True` on success. + If you'd like to make sure that the webhook was set by you, you can specify secret data in the parameter *secret_token*. If specified, the request will contain a header 'X-Telegram-Bot-Api-Secret-Token' with the secret token as content. + + **Notes** + + **1.** You will not be able to receive updates using :class:`aiogram.methods.get_updates.GetUpdates` for as long as an outgoing webhook is set up. + + **2.** To use a self-signed certificate, you need to upload your `public key certificate `_ using *certificate* parameter. Please upload as InputFile, sending a String will not work. + + **3.** Ports currently supported *for webhooks*: **443, 80, 88, 8443**. + If you're having any trouble setting up webhooks, please check out this `amazing guide to webhooks `_. + + Source: https://core.telegram.org/bots/api#setwebhook + + :param url: HTTPS URL to send updates to. Use an empty string to remove webhook integration + :param certificate: Upload your public key certificate so that the root certificate in use can be checked. See our `self-signed guide `_ for details. + :param ip_address: The fixed IP address which will be used to send webhook requests instead of the IP address resolved through DNS + :param max_connections: The maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery, 1-100. Defaults to *40*. Use lower values to limit the load on your bot's server, and higher values to increase your bot's throughput. + :param allowed_updates: A JSON-serialized list of the update types you want your bot to receive. For example, specify :code:`["message", "edited_channel_post", "callback_query"]` to only receive updates of these types. See :class:`aiogram.types.update.Update` for a complete list of available update types. Specify an empty list to receive all update types except *chat_member*, *message_reaction*, and *message_reaction_count* (default). If not specified, the previous setting will be used. + :param drop_pending_updates: Pass :code:`True` to drop all pending updates + :param secret_token: A secret token to be sent in a header 'X-Telegram-Bot-Api-Secret-Token' in every webhook request, 1-256 characters. Only characters :code:`A-Z`, :code:`a-z`, :code:`0-9`, :code:`_` and :code:`-` are allowed. The header is useful to ensure that the request comes from a webhook set by you. + :param request_timeout: Request timeout + :return: Please upload as InputFile, sending a String will not work. + """ + + call = SetWebhook( + url=url, + certificate=certificate, + ip_address=ip_address, + max_connections=max_connections, + allowed_updates=allowed_updates, + drop_pending_updates=drop_pending_updates, + secret_token=secret_token, + ) + return await self(call, request_timeout=request_timeout) + + async def stop_message_live_location( + self, + business_connection_id: Optional[str] = None, + chat_id: Optional[Union[int, str]] = None, + message_id: Optional[int] = None, + inline_message_id: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + request_timeout: Optional[int] = None, + ) -> Union[Message, bool]: + """ + Use this method to stop updating a live location message before *live_period* expires. On success, if the message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. + + Source: https://core.telegram.org/bots/api#stopmessagelivelocation + + :param business_connection_id: Unique identifier of the business connection on behalf of which the message to be edited was sent + :param chat_id: Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param message_id: Required if *inline_message_id* is not specified. Identifier of the message with live location to stop + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param reply_markup: A JSON-serialized object for a new `inline keyboard `_. + :param request_timeout: Request timeout + :return: On success, if the message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. + """ + + call = StopMessageLiveLocation( + business_connection_id=business_connection_id, + chat_id=chat_id, + message_id=message_id, + inline_message_id=inline_message_id, + reply_markup=reply_markup, + ) + return await self(call, request_timeout=request_timeout) + + async def stop_poll( + self, + chat_id: Union[int, str], + message_id: int, + business_connection_id: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + request_timeout: Optional[int] = None, + ) -> Poll: + """ + Use this method to stop a poll which was sent by the bot. On success, the stopped :class:`aiogram.types.poll.Poll` is returned. + + Source: https://core.telegram.org/bots/api#stoppoll + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param message_id: Identifier of the original message with the poll + :param business_connection_id: Unique identifier of the business connection on behalf of which the message to be edited was sent + :param reply_markup: A JSON-serialized object for a new message `inline keyboard `_. + :param request_timeout: Request timeout + :return: On success, the stopped :class:`aiogram.types.poll.Poll` is returned. + """ + + call = StopPoll( + chat_id=chat_id, + message_id=message_id, + business_connection_id=business_connection_id, + reply_markup=reply_markup, + ) + return await self(call, request_timeout=request_timeout) + + async def unban_chat_member( + self, + chat_id: Union[int, str], + user_id: int, + only_if_banned: Optional[bool] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to unban a previously banned user in a supergroup or channel. The user will **not** return to the group or channel automatically, but will be able to join via link, etc. The bot must be an administrator for this to work. By default, this method guarantees that after the call the user is not a member of the chat, but will be able to join it. So if the user is a member of the chat they will also be **removed** from the chat. If you don't want this, use the parameter *only_if_banned*. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unbanchatmember + + :param chat_id: Unique identifier for the target group or username of the target supergroup or channel (in the format :code:`@channelusername`) + :param user_id: Unique identifier of the target user + :param only_if_banned: Do nothing if the user is not banned + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = UnbanChatMember( + chat_id=chat_id, + user_id=user_id, + only_if_banned=only_if_banned, + ) + return await self(call, request_timeout=request_timeout) + + async def unban_chat_sender_chat( + self, + chat_id: Union[int, str], + sender_chat_id: int, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to unban a previously banned channel chat in a supergroup or channel. The bot must be an administrator for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unbanchatsenderchat + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param sender_chat_id: Unique identifier of the target sender chat + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = UnbanChatSenderChat( + chat_id=chat_id, + sender_chat_id=sender_chat_id, + ) + return await self(call, request_timeout=request_timeout) + + async def unpin_all_chat_messages( + self, + chat_id: Union[int, str], + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to clear the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' administrator right in a supergroup or 'can_edit_messages' administrator right in a channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unpinallchatmessages + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = UnpinAllChatMessages( + chat_id=chat_id, + ) + return await self(call, request_timeout=request_timeout) + + async def unpin_all_forum_topic_messages( + self, + chat_id: Union[int, str], + message_thread_id: int, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to clear the list of pinned messages in a forum topic. The bot must be an administrator in the chat for this to work and must have the *can_pin_messages* administrator right in the supergroup. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unpinallforumtopicmessages + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param message_thread_id: Unique identifier for the target message thread of the forum topic + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = UnpinAllForumTopicMessages( + chat_id=chat_id, + message_thread_id=message_thread_id, + ) + return await self(call, request_timeout=request_timeout) + + async def unpin_chat_message( + self, + chat_id: Union[int, str], + business_connection_id: Optional[str] = None, + message_id: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to remove a message from the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' administrator right in a supergroup or 'can_edit_messages' administrator right in a channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unpinchatmessage + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be unpinned + :param message_id: Identifier of the message to unpin. Required if *business_connection_id* is specified. If not specified, the most recent pinned message (by sending date) will be unpinned. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = UnpinChatMessage( + chat_id=chat_id, + business_connection_id=business_connection_id, + message_id=message_id, + ) + return await self(call, request_timeout=request_timeout) + + async def upload_sticker_file( + self, + user_id: int, + sticker: InputFile, + sticker_format: str, + request_timeout: Optional[int] = None, + ) -> File: + """ + Use this method to upload a file with a sticker for later use in the :class:`aiogram.methods.create_new_sticker_set.CreateNewStickerSet`, :class:`aiogram.methods.add_sticker_to_set.AddStickerToSet`, or :class:`aiogram.methods.replace_sticker_in_set.ReplaceStickerInSet` methods (the file can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success. + + Source: https://core.telegram.org/bots/api#uploadstickerfile + + :param user_id: User identifier of sticker file owner + :param sticker: A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See `https://core.telegram.org/stickers `_`https://core.telegram.org/stickers `_ for technical requirements. :ref:`More information on Sending Files » ` + :param sticker_format: Format of the sticker, must be one of 'static', 'animated', 'video' + :param request_timeout: Request timeout + :return: Returns the uploaded :class:`aiogram.types.file.File` on success. + """ + + call = UploadStickerFile( + user_id=user_id, + sticker=sticker, + sticker_format=sticker_format, + ) + return await self(call, request_timeout=request_timeout) + + async def close_general_forum_topic( + self, + chat_id: Union[int, str], + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to close an open 'General' topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#closegeneralforumtopic + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = CloseGeneralForumTopic( + chat_id=chat_id, + ) + return await self(call, request_timeout=request_timeout) + + async def edit_general_forum_topic( + self, + chat_id: Union[int, str], + name: str, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to edit the name of the 'General' topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#editgeneralforumtopic + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param name: New topic name, 1-128 characters + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = EditGeneralForumTopic( + chat_id=chat_id, + name=name, + ) + return await self(call, request_timeout=request_timeout) + + async def hide_general_forum_topic( + self, + chat_id: Union[int, str], + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to hide the 'General' topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights. The topic will be automatically closed if it was open. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#hidegeneralforumtopic + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = HideGeneralForumTopic( + chat_id=chat_id, + ) + return await self(call, request_timeout=request_timeout) + + async def reopen_general_forum_topic( + self, + chat_id: Union[int, str], + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to reopen a closed 'General' topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights. The topic will be automatically unhidden if it was hidden. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#reopengeneralforumtopic + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = ReopenGeneralForumTopic( + chat_id=chat_id, + ) + return await self(call, request_timeout=request_timeout) + + async def unhide_general_forum_topic( + self, + chat_id: Union[int, str], + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to unhide the 'General' topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unhidegeneralforumtopic + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = UnhideGeneralForumTopic( + chat_id=chat_id, + ) + return await self(call, request_timeout=request_timeout) + + async def delete_sticker_set( + self, + name: str, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to delete a sticker set that was created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletestickerset + + :param name: Sticker set name + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = DeleteStickerSet( + name=name, + ) + return await self(call, request_timeout=request_timeout) + + async def get_my_description( + self, + language_code: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> BotDescription: + """ + Use this method to get the current bot description for the given user language. Returns :class:`aiogram.types.bot_description.BotDescription` on success. + + Source: https://core.telegram.org/bots/api#getmydescription + + :param language_code: A two-letter ISO 639-1 language code or an empty string + :param request_timeout: Request timeout + :return: Returns :class:`aiogram.types.bot_description.BotDescription` on success. + """ + + call = GetMyDescription( + language_code=language_code, + ) + return await self(call, request_timeout=request_timeout) + + async def get_my_short_description( + self, + language_code: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> BotShortDescription: + """ + Use this method to get the current bot short description for the given user language. Returns :class:`aiogram.types.bot_short_description.BotShortDescription` on success. + + Source: https://core.telegram.org/bots/api#getmyshortdescription + + :param language_code: A two-letter ISO 639-1 language code or an empty string + :param request_timeout: Request timeout + :return: Returns :class:`aiogram.types.bot_short_description.BotShortDescription` on success. + """ + + call = GetMyShortDescription( + language_code=language_code, + ) + return await self(call, request_timeout=request_timeout) + + async def set_custom_emoji_sticker_set_thumbnail( + self, + name: str, + custom_emoji_id: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to set the thumbnail of a custom emoji sticker set. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setcustomemojistickersetthumbnail + + :param name: Sticker set name + :param custom_emoji_id: Custom emoji identifier of a sticker from the sticker set; pass an empty string to drop the thumbnail and use the first sticker as the thumbnail. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetCustomEmojiStickerSetThumbnail( + name=name, + custom_emoji_id=custom_emoji_id, + ) + return await self(call, request_timeout=request_timeout) + + async def set_my_description( + self, + description: Optional[str] = None, + language_code: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmydescription + + :param description: New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language. + :param language_code: A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetMyDescription( + description=description, + language_code=language_code, + ) + return await self(call, request_timeout=request_timeout) + + async def set_my_short_description( + self, + short_description: Optional[str] = None, + language_code: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmyshortdescription + + :param short_description: New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language. + :param language_code: A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetMyShortDescription( + short_description=short_description, + language_code=language_code, + ) + return await self(call, request_timeout=request_timeout) + + async def set_sticker_emoji_list( + self, + sticker: str, + emoji_list: List[str], + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickeremojilist + + :param sticker: File identifier of the sticker + :param emoji_list: A JSON-serialized list of 1-20 emoji associated with the sticker + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetStickerEmojiList( + sticker=sticker, + emoji_list=emoji_list, + ) + return await self(call, request_timeout=request_timeout) + + async def set_sticker_keywords( + self, + sticker: str, + keywords: Optional[List[str]] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change search keywords assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickerkeywords + + :param sticker: File identifier of the sticker + :param keywords: A JSON-serialized list of 0-20 search keywords for the sticker with total length of up to 64 characters + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetStickerKeywords( + sticker=sticker, + keywords=keywords, + ) + return await self(call, request_timeout=request_timeout) + + async def set_sticker_mask_position( + self, + sticker: str, + mask_position: Optional[MaskPosition] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change the `mask position `_ of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickermaskposition + + :param sticker: File identifier of the sticker + :param mask_position: A JSON-serialized object with the position where the mask should be placed on faces. Omit the parameter to remove the mask position. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetStickerMaskPosition( + sticker=sticker, + mask_position=mask_position, + ) + return await self(call, request_timeout=request_timeout) + + async def set_sticker_set_thumbnail( + self, + name: str, + user_id: int, + format: str, + thumbnail: Optional[Union[InputFile, str]] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail file must match the format of the stickers in the set. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickersetthumbnail + + :param name: Sticker set name + :param user_id: User identifier of the sticker set owner + :param format: Format of the thumbnail, must be one of 'static' for a **.WEBP** or **.PNG** image, 'animated' for a **.TGS** animation, or 'video' for a **WEBM** video + :param thumbnail: A **.WEBP** or **.PNG** image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a **.TGS** animation with a thumbnail up to 32 kilobytes in size (see `https://core.telegram.org/stickers#animation-requirements `_`https://core.telegram.org/stickers#animation-requirements `_ for animated sticker technical requirements), or a **WEBM** video with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#video-requirements `_`https://core.telegram.org/stickers#video-requirements `_ for video sticker technical requirements. 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 information on Sending Files » `. Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetStickerSetThumbnail( + name=name, + user_id=user_id, + format=format, + thumbnail=thumbnail, + ) + return await self(call, request_timeout=request_timeout) + + async def set_sticker_set_title( + self, + name: str, + title: str, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to set the title of a created sticker set. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickersettitle + + :param name: Sticker set name + :param title: Sticker set title, 1-64 characters + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetStickerSetTitle( + name=name, + title=title, + ) + return await self(call, request_timeout=request_timeout) + + async def get_my_name( + self, + language_code: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> BotName: + """ + Use this method to get the current bot name for the given user language. Returns :class:`aiogram.types.bot_name.BotName` on success. + + Source: https://core.telegram.org/bots/api#getmyname + + :param language_code: A two-letter ISO 639-1 language code or an empty string + :param request_timeout: Request timeout + :return: Returns :class:`aiogram.types.bot_name.BotName` on success. + """ + + call = GetMyName( + language_code=language_code, + ) + return await self(call, request_timeout=request_timeout) + + async def set_my_name( + self, + name: Optional[str] = None, + language_code: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change the bot's name. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmyname + + :param name: New bot name; 0-64 characters. Pass an empty string to remove the dedicated name for the given language. + :param language_code: A two-letter ISO 639-1 language code. If empty, the name will be shown to all users for whose language there is no dedicated name. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetMyName( + name=name, + language_code=language_code, + ) + return await self(call, request_timeout=request_timeout) + + async def unpin_all_general_forum_topic_messages( + self, + chat_id: Union[int, str], + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to clear the list of pinned messages in a General forum topic. The bot must be an administrator in the chat for this to work and must have the *can_pin_messages* administrator right in the supergroup. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unpinallgeneralforumtopicmessages + + :param chat_id: Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`) + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = UnpinAllGeneralForumTopicMessages( + chat_id=chat_id, + ) + return await self(call, request_timeout=request_timeout) + + async def copy_messages( + self, + chat_id: Union[int, str], + from_chat_id: Union[int, str], + message_ids: List[int], + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + remove_caption: Optional[bool] = None, + request_timeout: Optional[int] = None, + ) -> List[MessageId]: + """ + Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz :class:`aiogram.methods.poll.Poll` can be copied only if the value of the field *correct_option_id* is known to the bot. The method is analogous to the method :class:`aiogram.methods.forward_messages.ForwardMessages`, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of :class:`aiogram.types.message_id.MessageId` of the sent messages is returned. + + Source: https://core.telegram.org/bots/api#copymessages + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param from_chat_id: Unique identifier for the chat where the original messages were sent (or channel username in the format :code:`@channelusername`) + :param message_ids: A JSON-serialized list of 1-100 identifiers of messages in the chat *from_chat_id* to copy. The identifiers must be specified in a strictly increasing order. + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param disable_notification: Sends the messages `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent messages from forwarding and saving + :param remove_caption: Pass :code:`True` to copy the messages without their captions + :param request_timeout: Request timeout + :return: On success, an array of :class:`aiogram.types.message_id.MessageId` of the sent messages is returned. + """ + + call = CopyMessages( + chat_id=chat_id, + from_chat_id=from_chat_id, + message_ids=message_ids, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + remove_caption=remove_caption, + ) + return await self(call, request_timeout=request_timeout) + + async def delete_messages( + self, + chat_id: Union[int, str], + message_ids: List[int], + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to delete multiple messages simultaneously. If some of the specified messages can't be found, they are skipped. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletemessages + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param message_ids: A JSON-serialized list of 1-100 identifiers of messages to delete. See :class:`aiogram.methods.delete_message.DeleteMessage` for limitations on which messages can be deleted + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = DeleteMessages( + chat_id=chat_id, + message_ids=message_ids, + ) + return await self(call, request_timeout=request_timeout) + + async def forward_messages( + self, + chat_id: Union[int, str], + from_chat_id: Union[int, str], + message_ids: List[int], + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + request_timeout: Optional[int] = None, + ) -> List[MessageId]: + """ + Use this method to forward multiple messages of any kind. If some of the specified messages can't be found or forwarded, they are skipped. Service messages and messages with protected content can't be forwarded. Album grouping is kept for forwarded messages. On success, an array of :class:`aiogram.types.message_id.MessageId` of the sent messages is returned. + + Source: https://core.telegram.org/bots/api#forwardmessages + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param from_chat_id: Unique identifier for the chat where the original messages were sent (or channel username in the format :code:`@channelusername`) + :param message_ids: A JSON-serialized list of 1-100 identifiers of messages in the chat *from_chat_id* to forward. The identifiers must be specified in a strictly increasing order. + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param disable_notification: Sends the messages `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the forwarded messages from forwarding and saving + :param request_timeout: Request timeout + :return: On success, an array of :class:`aiogram.types.message_id.MessageId` of the sent messages is returned. + """ + + call = ForwardMessages( + chat_id=chat_id, + from_chat_id=from_chat_id, + message_ids=message_ids, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + ) + return await self(call, request_timeout=request_timeout) + + async def get_user_chat_boosts( + self, + chat_id: Union[int, str], + user_id: int, + request_timeout: Optional[int] = None, + ) -> UserChatBoosts: + """ + Use this method to get the list of boosts added to a chat by a user. Requires administrator rights in the chat. Returns a :class:`aiogram.types.user_chat_boosts.UserChatBoosts` object. + + Source: https://core.telegram.org/bots/api#getuserchatboosts + + :param chat_id: Unique identifier for the chat or username of the channel (in the format :code:`@channelusername`) + :param user_id: Unique identifier of the target user + :param request_timeout: Request timeout + :return: Returns a :class:`aiogram.types.user_chat_boosts.UserChatBoosts` object. + """ + + call = GetUserChatBoosts( + chat_id=chat_id, + user_id=user_id, + ) + return await self(call, request_timeout=request_timeout) + + async def set_message_reaction( + self, + chat_id: Union[int, str], + message_id: int, + reaction: Optional[ + List[Union[ReactionTypeEmoji, ReactionTypeCustomEmoji, ReactionTypePaid]] + ] = None, + is_big: Optional[bool] = None, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to change the chosen reactions on a message. Service messages can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. Bots can't use paid reactions. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmessagereaction + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param message_id: Identifier of the target message. If the message belongs to a media group, the reaction is set to the first non-deleted message in the group instead. + :param reaction: A JSON-serialized list of reaction types to set on the message. Currently, as non-premium users, bots can set up to one reaction per message. A custom emoji reaction can be used if it is either already present on the message or explicitly allowed by chat administrators. Paid reactions can't be used by bots. + :param is_big: Pass :code:`True` to set the reaction with a big animation + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = SetMessageReaction( + chat_id=chat_id, + message_id=message_id, + reaction=reaction, + is_big=is_big, + ) + return await self(call, request_timeout=request_timeout) + + async def get_business_connection( + self, + business_connection_id: str, + request_timeout: Optional[int] = None, + ) -> BusinessConnection: + """ + Use this method to get information about the connection of the bot with a business account. Returns a :class:`aiogram.types.business_connection.BusinessConnection` object on success. + + Source: https://core.telegram.org/bots/api#getbusinessconnection + + :param business_connection_id: Unique identifier of the business connection + :param request_timeout: Request timeout + :return: Returns a :class:`aiogram.types.business_connection.BusinessConnection` object on success. + """ + + call = GetBusinessConnection( + business_connection_id=business_connection_id, + ) + return await self(call, request_timeout=request_timeout) + + async def replace_sticker_in_set( + self, + user_id: int, + name: str, + old_sticker: str, + sticker: InputSticker, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Use this method to replace an existing sticker in a sticker set with a new one. The method is equivalent to calling :class:`aiogram.methods.delete_sticker_from_set.DeleteStickerFromSet`, then :class:`aiogram.methods.add_sticker_to_set.AddStickerToSet`, then :class:`aiogram.methods.set_sticker_position_in_set.SetStickerPositionInSet`. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#replacestickerinset + + :param user_id: User identifier of the sticker set owner + :param name: Sticker set name + :param old_sticker: File identifier of the replaced sticker + :param sticker: A JSON-serialized object with information about the added sticker. If exactly the same sticker had already been added to the set, then the set remains unchanged. + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = ReplaceStickerInSet( + user_id=user_id, + name=name, + old_sticker=old_sticker, + sticker=sticker, + ) + return await self(call, request_timeout=request_timeout) + + async def refund_star_payment( + self, + user_id: int, + telegram_payment_charge_id: str, + request_timeout: Optional[int] = None, + ) -> bool: + """ + Refunds a successful payment in `Telegram Stars `_. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#refundstarpayment + + :param user_id: Identifier of the user whose payment will be refunded + :param telegram_payment_charge_id: Telegram payment identifier + :param request_timeout: Request timeout + :return: Returns :code:`True` on success. + """ + + call = RefundStarPayment( + user_id=user_id, + telegram_payment_charge_id=telegram_payment_charge_id, + ) + return await self(call, request_timeout=request_timeout) + + async def get_star_transactions( + self, + offset: Optional[int] = None, + limit: Optional[int] = None, + request_timeout: Optional[int] = None, + ) -> StarTransactions: + """ + Returns the bot's Telegram Star transactions in chronological order. On success, returns a :class:`aiogram.types.star_transactions.StarTransactions` object. + + Source: https://core.telegram.org/bots/api#getstartransactions + + :param offset: Number of transactions to skip in the response + :param limit: The maximum number of transactions to be retrieved. Values between 1-100 are accepted. Defaults to 100. + :param request_timeout: Request timeout + :return: On success, returns a :class:`aiogram.types.star_transactions.StarTransactions` object. + """ + + call = GetStarTransactions( + offset=offset, + limit=limit, + ) + return await self(call, request_timeout=request_timeout) + + async def send_paid_media( + self, + chat_id: Union[int, str], + star_count: int, + media: List[Union[InputPaidMediaPhoto, InputPaidMediaVideo]], + business_connection_id: Optional[str] = None, + caption: Optional[str] = None, + parse_mode: Optional[str] = None, + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + request_timeout: Optional[int] = None, + ) -> Message: + """ + Use this method to send paid media. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendpaidmedia + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`). If the chat is a channel, all Telegram Star proceeds from this media will be credited to the chat's balance. Otherwise, they will be credited to the bot's balance. + :param star_count: The number of Telegram Stars that must be paid to buy access to the media + :param media: A JSON-serialized array describing the media to be sent; up to 10 items + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param caption: Media caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the media caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param request_timeout: Request timeout + :return: On success, the sent :class:`aiogram.types.message.Message` is returned. + """ + + call = SendPaidMedia( + chat_id=chat_id, + star_count=star_count, + media=media, + business_connection_id=business_connection_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + disable_notification=disable_notification, + protect_content=protect_content, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + ) + return await self(call, request_timeout=request_timeout) + + async def create_chat_subscription_invite_link( + self, + chat_id: Union[int, str], + subscription_period: Union[datetime.datetime, datetime.timedelta, int], + subscription_price: int, + name: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> ChatInviteLink: + """ + Use this method to create a `subscription invite link `_ for a channel chat. The bot must have the *can_invite_users* administrator rights. The link can be edited using the method :class:`aiogram.methods.edit_chat_subscription_invite_link.EditChatSubscriptionInviteLink` or revoked using the method :class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink`. Returns the new invite link as a :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + + Source: https://core.telegram.org/bots/api#createchatsubscriptioninvitelink + + :param chat_id: Unique identifier for the target channel chat or username of the target channel (in the format :code:`@channelusername`) + :param subscription_period: The number of seconds the subscription will be active for before the next payment. Currently, it must always be 2592000 (30 days). + :param subscription_price: The amount of Telegram Stars a user must pay initially and after each subsequent subscription period to be a member of the chat; 1-2500 + :param name: Invite link name; 0-32 characters + :param request_timeout: Request timeout + :return: Returns the new invite link as a :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + """ + + call = CreateChatSubscriptionInviteLink( + chat_id=chat_id, + subscription_period=subscription_period, + subscription_price=subscription_price, + name=name, + ) + return await self(call, request_timeout=request_timeout) + + async def edit_chat_subscription_invite_link( + self, + chat_id: Union[int, str], + invite_link: str, + name: Optional[str] = None, + request_timeout: Optional[int] = None, + ) -> ChatInviteLink: + """ + Use this method to edit a subscription invite link created by the bot. The bot must have the *can_invite_users* administrator rights. Returns the edited invite link as a :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + + Source: https://core.telegram.org/bots/api#editchatsubscriptioninvitelink + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param invite_link: The invite link to edit + :param name: Invite link name; 0-32 characters + :param request_timeout: Request timeout + :return: Returns the edited invite link as a :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + """ + + call = EditChatSubscriptionInviteLink( + chat_id=chat_id, + invite_link=invite_link, + name=name, + ) + return await self(call, request_timeout=request_timeout) diff --git a/env/Lib/site-packages/aiogram/client/context_controller.py b/env/Lib/site-packages/aiogram/client/context_controller.py new file mode 100644 index 0000000..97795a7 --- /dev/null +++ b/env/Lib/site-packages/aiogram/client/context_controller.py @@ -0,0 +1,33 @@ +from typing import TYPE_CHECKING, Any, Optional + +from pydantic import BaseModel, PrivateAttr +from typing_extensions import Self + +if TYPE_CHECKING: + from aiogram.client.bot import Bot + + +class BotContextController(BaseModel): + _bot: Optional["Bot"] = PrivateAttr() + + def model_post_init(self, __context: Any) -> None: + self._bot = __context.get("bot") if __context else None + + def as_(self, bot: Optional["Bot"]) -> Self: + """ + Bind object to a bot instance. + + :param bot: Bot instance + :return: self + """ + self._bot = bot + return self + + @property + def bot(self) -> Optional["Bot"]: + """ + Get bot instance. + + :return: Bot instance + """ + return self._bot diff --git a/env/Lib/site-packages/aiogram/client/default.py b/env/Lib/site-packages/aiogram/client/default.py new file mode 100644 index 0000000..6c857be --- /dev/null +++ b/env/Lib/site-packages/aiogram/client/default.py @@ -0,0 +1,85 @@ +from __future__ import annotations + +import sys +from dataclasses import dataclass +from typing import TYPE_CHECKING, Any, Dict, Optional + +if TYPE_CHECKING: + from aiogram.types import LinkPreviewOptions + + +# @dataclass ?? +class Default: + # Is not a dataclass because of JSON serialization. + + __slots__ = ("_name",) + + def __init__(self, name: str) -> None: + self._name = name + + @property + def name(self) -> str: + return self._name + + def __str__(self) -> str: + return f"Default({self._name!r})" + + def __repr__(self) -> str: + return f"<{self}>" + + +_dataclass_properties: Dict[str, Any] = {} +if sys.version_info >= (3, 10): + # Speedup attribute access for dataclasses in Python 3.10+ + _dataclass_properties.update({"slots": True, "kw_only": True}) + + +@dataclass(**_dataclass_properties) +class DefaultBotProperties: + """ + Default bot properties. + """ + + parse_mode: Optional[str] = None + """Default parse mode for messages.""" + disable_notification: Optional[bool] = None + """Sends the message silently. Users will receive a notification with no sound.""" + protect_content: Optional[bool] = None + """Protects content from copying.""" + allow_sending_without_reply: Optional[bool] = None + """Allows to send messages without reply.""" + link_preview: Optional[LinkPreviewOptions] = None + """Link preview settings.""" + link_preview_is_disabled: Optional[bool] = None + """Disables link preview.""" + link_preview_prefer_small_media: Optional[bool] = None + """Prefer small media in link preview.""" + link_preview_prefer_large_media: Optional[bool] = None + """Prefer large media in link preview.""" + link_preview_show_above_text: Optional[bool] = None + """Show link preview above text.""" + show_caption_above_media: Optional[bool] = None + """Show caption above media.""" + + def __post_init__(self) -> None: + has_any_link_preview_option = any( + ( + self.link_preview_is_disabled, + self.link_preview_prefer_small_media, + self.link_preview_prefer_large_media, + self.link_preview_show_above_text, + ) + ) + + if has_any_link_preview_option and self.link_preview is None: + from ..types import LinkPreviewOptions + + self.link_preview = LinkPreviewOptions( + is_disabled=self.link_preview_is_disabled, + prefer_small_media=self.link_preview_prefer_small_media, + prefer_large_media=self.link_preview_prefer_large_media, + show_above_text=self.link_preview_show_above_text, + ) + + def __getitem__(self, item: str) -> Any: + return getattr(self, item, None) diff --git a/env/Lib/site-packages/aiogram/client/session/__init__.py b/env/Lib/site-packages/aiogram/client/session/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/aiogram/client/session/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/client/session/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b9e3c263e29902f6d4a5842b6aa59b21d615b12e GIT binary patch literal 192 zcmZ3^%ge<81lwkxNdwW3K?DpiLK&agfQ;!3DGb33nv8xc8H$*I{LdiCU%@U`G2!_| z*)h)fDVcfcG1;X>i6!|(@k#k5F{ycFF+Q0|F~ylBsk#M;$=QkNsl_pgnfd8OiMjg8 zIhm<>CHlpw#l@NVdHV73nR%Hd@$q^EmA^P_a`RJ4b5iY!Sb=tcTv5yqBt9@RGBSQ( KfDuK^KrsL%OfvZZ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/client/session/__pycache__/aiohttp.cpython-311.pyc b/env/Lib/site-packages/aiogram/client/session/__pycache__/aiohttp.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1f1da0f47505aa5b3ddcabcd99a8d550f9b52585 GIT binary patch literal 11243 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/client/session/__pycache__/base.cpython-311.pyc b/env/Lib/site-packages/aiogram/client/session/__pycache__/base.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..41405967faf2cd2f99c84fd5bc5ebd8a199bfe88 GIT binary patch literal 11434 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/client/session/aiohttp.py b/env/Lib/site-packages/aiogram/client/session/aiohttp.py new file mode 100644 index 0000000..69f36bf --- /dev/null +++ b/env/Lib/site-packages/aiogram/client/session/aiohttp.py @@ -0,0 +1,215 @@ +from __future__ import annotations + +import asyncio +import ssl +from typing import ( + TYPE_CHECKING, + Any, + AsyncGenerator, + Dict, + Iterable, + List, + Optional, + Tuple, + Type, + Union, + cast, +) + +import certifi +from aiohttp import BasicAuth, ClientError, ClientSession, FormData, TCPConnector +from aiohttp.hdrs import USER_AGENT +from aiohttp.http import SERVER_SOFTWARE + +from aiogram.__meta__ import __version__ +from aiogram.methods import TelegramMethod + +from ...exceptions import TelegramNetworkError +from ...methods.base import TelegramType +from ...types import InputFile +from .base import BaseSession + +if TYPE_CHECKING: + from ..bot import Bot + +_ProxyBasic = Union[str, Tuple[str, BasicAuth]] +_ProxyChain = Iterable[_ProxyBasic] +_ProxyType = Union[_ProxyChain, _ProxyBasic] + + +def _retrieve_basic(basic: _ProxyBasic) -> Dict[str, Any]: + from aiohttp_socks.utils import parse_proxy_url # type: ignore + + proxy_auth: Optional[BasicAuth] = None + + if isinstance(basic, str): + proxy_url = basic + else: + proxy_url, proxy_auth = basic + + proxy_type, host, port, username, password = parse_proxy_url(proxy_url) + if isinstance(proxy_auth, BasicAuth): + username = proxy_auth.login + password = proxy_auth.password + + return { + "proxy_type": proxy_type, + "host": host, + "port": port, + "username": username, + "password": password, + "rdns": True, + } + + +def _prepare_connector(chain_or_plain: _ProxyType) -> Tuple[Type["TCPConnector"], Dict[str, Any]]: + from aiohttp_socks import ( # type: ignore + ChainProxyConnector, + ProxyConnector, + ProxyInfo, + ) + + # since tuple is Iterable(compatible with _ProxyChain) object, we assume that + # user wants chained proxies if tuple is a pair of string(url) and BasicAuth + if isinstance(chain_or_plain, str) or ( + isinstance(chain_or_plain, tuple) and len(chain_or_plain) == 2 + ): + chain_or_plain = cast(_ProxyBasic, chain_or_plain) + return ProxyConnector, _retrieve_basic(chain_or_plain) + + chain_or_plain = cast(_ProxyChain, chain_or_plain) + infos: List[ProxyInfo] = [] + for basic in chain_or_plain: + infos.append(ProxyInfo(**_retrieve_basic(basic))) + + return ChainProxyConnector, {"proxy_infos": infos} + + +class AiohttpSession(BaseSession): + def __init__( + self, proxy: Optional[_ProxyType] = None, limit: int = 100, **kwargs: Any + ) -> None: + """ + Client session based on aiohttp. + + :param proxy: The proxy to be used for requests. Default is None. + :param limit: The total number of simultaneous connections. Default is 100. + :param kwargs: Additional keyword arguments. + """ + super().__init__(**kwargs) + + self._session: Optional[ClientSession] = None + self._connector_type: Type[TCPConnector] = TCPConnector + self._connector_init: Dict[str, Any] = { + "ssl": ssl.create_default_context(cafile=certifi.where()), + "limit": limit, + "ttl_dns_cache": 3600, # Workaround for https://github.com/aiogram/aiogram/issues/1500 + } + self._should_reset_connector = True # flag determines connector state + self._proxy: Optional[_ProxyType] = None + + if proxy is not None: + try: + self._setup_proxy_connector(proxy) + except ImportError as exc: # pragma: no cover + raise RuntimeError( + "In order to use aiohttp client for proxy requests, install " + "https://pypi.org/project/aiohttp-socks/" + ) from exc + + def _setup_proxy_connector(self, proxy: _ProxyType) -> None: + self._connector_type, self._connector_init = _prepare_connector(proxy) + self._proxy = proxy + + @property + def proxy(self) -> Optional[_ProxyType]: + return self._proxy + + @proxy.setter + def proxy(self, proxy: _ProxyType) -> None: + self._setup_proxy_connector(proxy) + self._should_reset_connector = True + + async def create_session(self) -> ClientSession: + if self._should_reset_connector: + await self.close() + + if self._session is None or self._session.closed: + self._session = ClientSession( + connector=self._connector_type(**self._connector_init), + headers={ + USER_AGENT: f"{SERVER_SOFTWARE} aiogram/{__version__}", + }, + ) + self._should_reset_connector = False + + return self._session + + async def close(self) -> None: + if self._session is not None and not self._session.closed: + await self._session.close() + + # Wait 250 ms for the underlying SSL connections to close + # https://docs.aiohttp.org/en/stable/client_advanced.html#graceful-shutdown + await asyncio.sleep(0.25) + + def build_form_data(self, bot: Bot, method: TelegramMethod[TelegramType]) -> FormData: + form = FormData(quote_fields=False) + files: Dict[str, InputFile] = {} + for key, value in method.model_dump(warnings=False).items(): + value = self.prepare_value(value, bot=bot, files=files) + if not value: + continue + form.add_field(key, value) + for key, value in files.items(): + form.add_field( + key, + value.read(bot), + filename=value.filename or key, + ) + return form + + async def make_request( + self, bot: Bot, method: TelegramMethod[TelegramType], timeout: Optional[int] = None + ) -> TelegramType: + session = await self.create_session() + + url = self.api.api_url(token=bot.token, method=method.__api_method__) + form = self.build_form_data(bot=bot, method=method) + + try: + async with session.post( + url, data=form, timeout=self.timeout if timeout is None else timeout + ) as resp: + raw_result = await resp.text() + except asyncio.TimeoutError: + raise TelegramNetworkError(method=method, message="Request timeout error") + except ClientError as e: + raise TelegramNetworkError(method=method, message=f"{type(e).__name__}: {e}") + response = self.check_response( + bot=bot, method=method, status_code=resp.status, content=raw_result + ) + return cast(TelegramType, response.result) + + async def stream_content( + self, + url: str, + headers: Optional[Dict[str, Any]] = None, + timeout: int = 30, + chunk_size: int = 65536, + raise_for_status: bool = True, + ) -> AsyncGenerator[bytes, None]: + if headers is None: + headers = {} + + session = await self.create_session() + + async with session.get( + url, timeout=timeout, headers=headers, raise_for_status=raise_for_status + ) as resp: + async for chunk in resp.content.iter_chunked(chunk_size): + yield chunk + + async def __aenter__(self) -> AiohttpSession: + await self.create_session() + return self diff --git a/env/Lib/site-packages/aiogram/client/session/base.py b/env/Lib/site-packages/aiogram/client/session/base.py new file mode 100644 index 0000000..82ec469 --- /dev/null +++ b/env/Lib/site-packages/aiogram/client/session/base.py @@ -0,0 +1,265 @@ +from __future__ import annotations + +import abc +import datetime +import json +import secrets +from enum import Enum +from http import HTTPStatus +from types import TracebackType +from typing import ( + TYPE_CHECKING, + Any, + AsyncGenerator, + Callable, + Dict, + Final, + Optional, + Type, + cast, +) + +from pydantic import ValidationError + +from aiogram.exceptions import ( + ClientDecodeError, + RestartingTelegram, + TelegramAPIError, + TelegramBadRequest, + TelegramConflictError, + TelegramEntityTooLarge, + TelegramForbiddenError, + TelegramMigrateToChat, + TelegramNotFound, + TelegramRetryAfter, + TelegramServerError, + TelegramUnauthorizedError, +) + +from ...methods import Response, TelegramMethod +from ...methods.base import TelegramType +from ...types import InputFile, TelegramObject +from ..default import Default +from ..telegram import PRODUCTION, TelegramAPIServer +from .middlewares.manager import RequestMiddlewareManager + +if TYPE_CHECKING: + from ..bot import Bot + +_JsonLoads = Callable[..., Any] +_JsonDumps = Callable[..., str] + +DEFAULT_TIMEOUT: Final[float] = 60.0 + + +class BaseSession(abc.ABC): + """ + This is base class for all HTTP sessions in aiogram. + + If you want to create your own session, you must inherit from this class. + """ + + def __init__( + self, + api: TelegramAPIServer = PRODUCTION, + json_loads: _JsonLoads = json.loads, + json_dumps: _JsonDumps = json.dumps, + timeout: float = DEFAULT_TIMEOUT, + ) -> None: + """ + + :param api: Telegram Bot API URL patterns + :param json_loads: JSON loader + :param json_dumps: JSON dumper + :param timeout: Session scope request timeout + """ + self.api = api + self.json_loads = json_loads + self.json_dumps = json_dumps + self.timeout = timeout + + self.middleware = RequestMiddlewareManager() + + def check_response( + self, bot: Bot, method: TelegramMethod[TelegramType], status_code: int, content: str + ) -> Response[TelegramType]: + """ + Check response status + """ + try: + json_data = self.json_loads(content) + except Exception as e: + # Handled error type can't be classified as specific error + # in due to decoder can be customized and raise any exception + + raise ClientDecodeError("Failed to decode object", e, content) + + try: + response_type = Response[method.__returning__] # type: ignore + response = response_type.model_validate(json_data, context={"bot": bot}) + except ValidationError as e: + raise ClientDecodeError("Failed to deserialize object", e, json_data) + + if HTTPStatus.OK <= status_code <= HTTPStatus.IM_USED and response.ok: + return response + + description = cast(str, response.description) + + if parameters := response.parameters: + if parameters.retry_after: + raise TelegramRetryAfter( + method=method, message=description, retry_after=parameters.retry_after + ) + if parameters.migrate_to_chat_id: + raise TelegramMigrateToChat( + method=method, + message=description, + migrate_to_chat_id=parameters.migrate_to_chat_id, + ) + if status_code == HTTPStatus.BAD_REQUEST: + raise TelegramBadRequest(method=method, message=description) + if status_code == HTTPStatus.NOT_FOUND: + raise TelegramNotFound(method=method, message=description) + if status_code == HTTPStatus.CONFLICT: + raise TelegramConflictError(method=method, message=description) + if status_code == HTTPStatus.UNAUTHORIZED: + raise TelegramUnauthorizedError(method=method, message=description) + if status_code == HTTPStatus.FORBIDDEN: + raise TelegramForbiddenError(method=method, message=description) + if status_code == HTTPStatus.REQUEST_ENTITY_TOO_LARGE: + raise TelegramEntityTooLarge(method=method, message=description) + if status_code >= HTTPStatus.INTERNAL_SERVER_ERROR: + if "restart" in description: + raise RestartingTelegram(method=method, message=description) + raise TelegramServerError(method=method, message=description) + + raise TelegramAPIError( + method=method, + message=description, + ) + + @abc.abstractmethod + async def close(self) -> None: # pragma: no cover + """ + Close client session + """ + pass + + @abc.abstractmethod + async def make_request( + self, + bot: Bot, + method: TelegramMethod[TelegramType], + timeout: Optional[int] = None, + ) -> TelegramType: # pragma: no cover + """ + Make request to Telegram Bot API + + :param bot: Bot instance + :param method: Method instance + :param timeout: Request timeout + :return: + :raise TelegramApiError: + """ + pass + + @abc.abstractmethod + async def stream_content( + self, + url: str, + headers: Optional[Dict[str, Any]] = None, + timeout: int = 30, + chunk_size: int = 65536, + raise_for_status: bool = True, + ) -> AsyncGenerator[bytes, None]: # pragma: no cover + """ + Stream reader + """ + yield b"" + + def prepare_value( + self, + value: Any, + bot: Bot, + files: Dict[str, Any], + _dumps_json: bool = True, + ) -> Any: + """ + Prepare value before send + """ + if value is None: + return None + if isinstance(value, str): + return value + if isinstance(value, Default): + default_value = bot.default[value.name] + return self.prepare_value(default_value, bot=bot, files=files, _dumps_json=_dumps_json) + if isinstance(value, InputFile): + key = secrets.token_urlsafe(10) + files[key] = value + return f"attach://{key}" + if isinstance(value, dict): + value = { + key: prepared_item + for key, item in value.items() + if ( + prepared_item := self.prepare_value( + item, bot=bot, files=files, _dumps_json=False + ) + ) + is not None + } + if _dumps_json: + return self.json_dumps(value) + return value + if isinstance(value, list): + value = [ + prepared_item + for item in value + if ( + prepared_item := self.prepare_value( + item, bot=bot, files=files, _dumps_json=False + ) + ) + is not None + ] + if _dumps_json: + return self.json_dumps(value) + return value + if isinstance(value, datetime.timedelta): + now = datetime.datetime.now() + return str(round((now + value).timestamp())) + if isinstance(value, datetime.datetime): + return str(round(value.timestamp())) + if isinstance(value, Enum): + return self.prepare_value(value.value, bot=bot, files=files) + if isinstance(value, TelegramObject): + return self.prepare_value( + value.model_dump(warnings=False), + bot=bot, + files=files, + _dumps_json=_dumps_json, + ) + if _dumps_json: + return self.json_dumps(value) + return value + + async def __call__( + self, + bot: Bot, + method: TelegramMethod[TelegramType], + timeout: Optional[int] = None, + ) -> TelegramType: + middleware = self.middleware.wrap_middlewares(self.make_request, timeout=timeout) + return cast(TelegramType, await middleware(bot, method)) + + async def __aenter__(self) -> BaseSession: + return self + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc_value: Optional[BaseException], + traceback: Optional[TracebackType], + ) -> None: + await self.close() diff --git a/env/Lib/site-packages/aiogram/client/session/middlewares/__init__.py b/env/Lib/site-packages/aiogram/client/session/middlewares/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/aiogram/client/session/middlewares/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/client/session/middlewares/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e13aa3e027f63e17157e48cd72cfac4f1cb409ec GIT binary patch literal 204 zcmZ3^%ge<81lwkxNdwW3K?DpiLK&agfQ;!3DGb33nv8xc8H$*I{LdiCU-2$hG2!_| z*)h)fDVcfcG1;X>i6!|(@k#k5F{ycFF+Q0|F~ylBsk#M;$=QkNsl_pgnfd8OiMjg8 zIhm<>CHlpw#l@NVdHT7TDJeOr<%vb9#rpB_nR%Hd@$q^EmA^P_a`RJ4b5iY!Sb_F| WTvW^tBt9@RGBSQ(fDuK^KrsLv?l;8% literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/client/session/middlewares/__pycache__/base.cpython-311.pyc b/env/Lib/site-packages/aiogram/client/session/middlewares/__pycache__/base.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1ecc3eed2450e33bf817c934b25d0803ba0fbe10 GIT binary patch literal 2553 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/client/session/middlewares/base.py b/env/Lib/site-packages/aiogram/client/session/middlewares/base.py new file mode 100644 index 0000000..c5f3e7c --- /dev/null +++ b/env/Lib/site-packages/aiogram/client/session/middlewares/base.py @@ -0,0 +1,53 @@ +from __future__ import annotations + +from abc import ABC, abstractmethod +from typing import TYPE_CHECKING, Protocol + +from aiogram.methods import Response, TelegramMethod +from aiogram.methods.base import TelegramType + +if TYPE_CHECKING: + from ...bot import Bot + + +class NextRequestMiddlewareType(Protocol[TelegramType]): # pragma: no cover + async def __call__( + self, + bot: "Bot", + method: TelegramMethod[TelegramType], + ) -> Response[TelegramType]: + pass + + +class RequestMiddlewareType(Protocol): # pragma: no cover + async def __call__( + self, + make_request: NextRequestMiddlewareType[TelegramType], + bot: "Bot", + method: TelegramMethod[TelegramType], + ) -> Response[TelegramType]: + pass + + +class BaseRequestMiddleware(ABC): + """ + Generic middleware class + """ + + @abstractmethod + async def __call__( + self, + make_request: NextRequestMiddlewareType[TelegramType], + bot: "Bot", + method: TelegramMethod[TelegramType], + ) -> Response[TelegramType]: + """ + Execute middleware + + :param make_request: Wrapped make_request in middlewares chain + :param bot: bot for request making + :param method: Request method (Subclass of :class:`aiogram.methods.base.TelegramMethod`) + + :return: :class:`aiogram.methods.Response` + """ + pass diff --git a/env/Lib/site-packages/aiogram/client/session/middlewares/manager.py b/env/Lib/site-packages/aiogram/client/session/middlewares/manager.py new file mode 100644 index 0000000..2346715 --- /dev/null +++ b/env/Lib/site-packages/aiogram/client/session/middlewares/manager.py @@ -0,0 +1,62 @@ +from __future__ import annotations + +from functools import partial +from typing import Any, Callable, List, Optional, Sequence, Union, cast, overload + +from aiogram.client.session.middlewares.base import ( + NextRequestMiddlewareType, + RequestMiddlewareType, +) +from aiogram.methods.base import TelegramType + + +class RequestMiddlewareManager(Sequence[RequestMiddlewareType]): + def __init__(self) -> None: + self._middlewares: List[RequestMiddlewareType] = [] + + def register( + self, + middleware: RequestMiddlewareType, + ) -> RequestMiddlewareType: + self._middlewares.append(middleware) + return middleware + + def unregister(self, middleware: RequestMiddlewareType) -> None: + self._middlewares.remove(middleware) + + def __call__( + self, + middleware: Optional[RequestMiddlewareType] = None, + ) -> Union[ + Callable[[RequestMiddlewareType], RequestMiddlewareType], + RequestMiddlewareType, + ]: + if middleware is None: + return self.register + return self.register(middleware) + + @overload + def __getitem__(self, item: int) -> RequestMiddlewareType: + pass + + @overload + def __getitem__(self, item: slice) -> Sequence[RequestMiddlewareType]: + pass + + def __getitem__( + self, item: Union[int, slice] + ) -> Union[RequestMiddlewareType, Sequence[RequestMiddlewareType]]: + return self._middlewares[item] + + def __len__(self) -> int: + return len(self._middlewares) + + def wrap_middlewares( + self, + callback: NextRequestMiddlewareType[TelegramType], + **kwargs: Any, + ) -> NextRequestMiddlewareType[TelegramType]: + middleware = partial(callback, **kwargs) + for m in reversed(self._middlewares): + middleware = partial(m, middleware) + return cast(NextRequestMiddlewareType[TelegramType], middleware) diff --git a/env/Lib/site-packages/aiogram/client/session/middlewares/request_logging.py b/env/Lib/site-packages/aiogram/client/session/middlewares/request_logging.py new file mode 100644 index 0000000..af7b9d6 --- /dev/null +++ b/env/Lib/site-packages/aiogram/client/session/middlewares/request_logging.py @@ -0,0 +1,37 @@ +import logging +from typing import TYPE_CHECKING, Any, List, Optional, Type + +from aiogram import loggers +from aiogram.methods import TelegramMethod +from aiogram.methods.base import Response, TelegramType + +from .base import BaseRequestMiddleware, NextRequestMiddlewareType + +if TYPE_CHECKING: + from ...bot import Bot + +logger = logging.getLogger(__name__) + + +class RequestLogging(BaseRequestMiddleware): + def __init__(self, ignore_methods: Optional[List[Type[TelegramMethod[Any]]]] = None): + """ + Middleware for logging outgoing requests + + :param ignore_methods: methods to ignore in logging middleware + """ + self.ignore_methods = ignore_methods if ignore_methods else [] + + async def __call__( + self, + make_request: NextRequestMiddlewareType[TelegramType], + bot: "Bot", + method: TelegramMethod[TelegramType], + ) -> Response[TelegramType]: + if type(method) not in self.ignore_methods: + loggers.middlewares.info( + "Make request with method=%r by bot id=%d", + type(method).__name__, + bot.id, + ) + return await make_request(bot, method) diff --git a/env/Lib/site-packages/aiogram/client/telegram.py b/env/Lib/site-packages/aiogram/client/telegram.py new file mode 100644 index 0000000..5e29722 --- /dev/null +++ b/env/Lib/site-packages/aiogram/client/telegram.py @@ -0,0 +1,103 @@ +from abc import ABC, abstractmethod +from dataclasses import dataclass +from pathlib import Path +from typing import Any, Union + + +class FilesPathWrapper(ABC): + @abstractmethod + def to_local(self, path: Union[Path, str]) -> Union[Path, str]: + pass + + @abstractmethod + def to_server(self, path: Union[Path, str]) -> Union[Path, str]: + pass + + +class BareFilesPathWrapper(FilesPathWrapper): + def to_local(self, path: Union[Path, str]) -> Union[Path, str]: + return path + + def to_server(self, path: Union[Path, str]) -> Union[Path, str]: + return path + + +class SimpleFilesPathWrapper(FilesPathWrapper): + def __init__(self, server_path: Path, local_path: Path) -> None: + self.server_path = server_path + self.local_path = local_path + + @classmethod + def _resolve( + cls, base1: Union[Path, str], base2: Union[Path, str], value: Union[Path, str] + ) -> Path: + relative = Path(value).relative_to(base1) + return base2 / relative + + def to_local(self, path: Union[Path, str]) -> Union[Path, str]: + return self._resolve(base1=self.server_path, base2=self.local_path, value=path) + + def to_server(self, path: Union[Path, str]) -> Union[Path, str]: + return self._resolve(base1=self.local_path, base2=self.server_path, value=path) + + +@dataclass(frozen=True) +class TelegramAPIServer: + """ + Base config for API Endpoints + """ + + base: str + """Base URL""" + file: str + """Files URL""" + is_local: bool = False + """Mark this server is + in `local mode `_.""" + wrap_local_file: FilesPathWrapper = BareFilesPathWrapper() + """Callback to wrap files path in local mode""" + + def api_url(self, token: str, method: str) -> str: + """ + Generate URL for API methods + + :param token: Bot token + :param method: API method name (case insensitive) + :return: URL + """ + return self.base.format(token=token, method=method) + + def file_url(self, token: str, path: str) -> str: + """ + Generate URL for downloading files + + :param token: Bot token + :param path: file path + :return: URL + """ + return self.file.format(token=token, path=path) + + @classmethod + def from_base(cls, base: str, **kwargs: Any) -> "TelegramAPIServer": + """ + Use this method to auto-generate TelegramAPIServer instance from base URL + + :param base: Base URL + :return: instance of :class:`TelegramAPIServer` + """ + base = base.rstrip("/") + return cls( + base=f"{base}/bot{{token}}/{{method}}", + file=f"{base}/file/bot{{token}}/{{path}}", + **kwargs, + ) + + +PRODUCTION = TelegramAPIServer( + base="https://api.telegram.org/bot{token}/{method}", + file="https://api.telegram.org/file/bot{token}/{path}", +) +TEST = TelegramAPIServer( + base="https://api.telegram.org/bot{token}/test/{method}", + file="https://api.telegram.org/file/bot{token}/test/{path}", +) diff --git a/env/Lib/site-packages/aiogram/dispatcher/__init__.py b/env/Lib/site-packages/aiogram/dispatcher/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/aiogram/dispatcher/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/dispatcher/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f299e3c08e916429b9137209927369a8360ba50b GIT binary patch literal 188 zcmZ3^%ge<81lwkxNdwW3K?DpiLK&agfQ;!3DGb33nv8xc8H$*I{LdiCU;ZvuG2!_| z*)h)fDVcfcG1;X>i6!|(@k#k5F{ycFF+Q0|F~ylBsk#M;$=QkNsl_pgnfd8OiMjeI znZ*T(CCM47Mf&manR%Hd@$q^EmA^P_a`RJ4b5iY!Sb^q)Tu{spBt9@RGBSQ(fDuK^ GKrsL}iZN;c literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/dispatcher/__pycache__/dispatcher.cpython-311.pyc b/env/Lib/site-packages/aiogram/dispatcher/__pycache__/dispatcher.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..75a1afa70796dbf000a990142f13e7027afec6e7 GIT binary patch literal 29372 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 z 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 NikAPOPAy%W{{uOs1 None: + """ + Root router + + :param storage: Storage for FSM + :param fsm_strategy: FSM strategy + :param events_isolation: Events isolation + :param disable_fsm: Disable FSM, note that if you disable FSM + then you should not use storage and events isolation + :param kwargs: Other arguments, will be passed as keyword arguments to handlers + """ + super(Dispatcher, self).__init__(name=name) + + if storage and not isinstance(storage, BaseStorage): + raise TypeError( + f"FSM storage should be instance of 'BaseStorage' not {type(storage).__name__}" + ) + + # Telegram API provides originally only one event type - Update + # For making easily interactions with events here is registered handler which helps + # to separate Update to different event types like Message, CallbackQuery etc. + self.update = self.observers["update"] = TelegramEventObserver( + router=self, event_name="update" + ) + self.update.register(self._listen_update) + + # Error handlers should work is out of all other functions + # and should be registered before all others middlewares + self.update.outer_middleware(ErrorsMiddleware(self)) + + # User context middleware makes small optimization for all other builtin + # middlewares via caching the user and chat instances in the event context + self.update.outer_middleware(UserContextMiddleware()) + + # FSM middleware should always be registered after User context middleware + # because here is used context from previous step + self.fsm = FSMContextMiddleware( + storage=storage or MemoryStorage(), + strategy=fsm_strategy, + events_isolation=events_isolation or DisabledEventIsolation(), + ) + if not disable_fsm: + # Note that when FSM middleware is disabled, the event isolation is also disabled + # Because the isolation mechanism is a part of the FSM + self.update.outer_middleware(self.fsm) + self.shutdown.register(self.fsm.close) + + self.workflow_data: Dict[str, Any] = kwargs + self._running_lock = Lock() + self._stop_signal: Optional[Event] = None + self._stopped_signal: Optional[Event] = None + self._handle_update_tasks: Set[asyncio.Task[Any]] = set() + + def __getitem__(self, item: str) -> Any: + return self.workflow_data[item] + + def __setitem__(self, key: str, value: Any) -> None: + self.workflow_data[key] = value + + def __delitem__(self, key: str) -> None: + del self.workflow_data[key] + + def get(self, key: str, /, default: Optional[Any] = None) -> Optional[Any]: + return self.workflow_data.get(key, default) + + @property + def storage(self) -> BaseStorage: + return self.fsm.storage + + @property + def parent_router(self) -> Optional[Router]: + """ + Dispatcher has no parent router and can't be included to any other routers or dispatchers + + :return: + """ + return None # noqa: RET501 + + @parent_router.setter + def parent_router(self, value: Router) -> None: + """ + Dispatcher is root Router then configuring parent router is not allowed + + :param value: + :return: + """ + raise RuntimeError("Dispatcher can not be attached to another Router.") + + async def feed_update(self, bot: Bot, update: Update, **kwargs: Any) -> Any: + """ + Main entry point for incoming updates + Response of this method can be used as Webhook response + + :param bot: + :param update: + """ + loop = asyncio.get_running_loop() + handled = False + start_time = loop.time() + + if update.bot != bot: + # Re-mounting update to the current bot instance for making possible to + # use it in shortcuts. + # Here is update is re-created because we need to propagate context to + # all nested objects and attributes of the Update, but it + # is impossible without roundtrip to JSON :( + # The preferred way is that pass already mounted Bot instance to this update + # before call feed_update method + update = Update.model_validate(update.model_dump(), context={"bot": bot}) + + try: + response = await self.update.wrap_outer_middleware( + self.update.trigger, + update, + { + **self.workflow_data, + **kwargs, + "bot": bot, + }, + ) + handled = response is not UNHANDLED + return response + finally: + finish_time = loop.time() + duration = (finish_time - start_time) * 1000 + loggers.event.info( + "Update id=%s is %s. Duration %d ms by bot id=%d", + update.update_id, + "handled" if handled else "not handled", + duration, + bot.id, + ) + + async def feed_raw_update(self, bot: Bot, update: Dict[str, Any], **kwargs: Any) -> Any: + """ + Main entry point for incoming updates with automatic Dict->Update serializer + + :param bot: + :param update: + :param kwargs: + """ + parsed_update = Update.model_validate(update, context={"bot": bot}) + return await self._feed_webhook_update(bot=bot, update=parsed_update, **kwargs) + + @classmethod + async def _listen_updates( + cls, + bot: Bot, + polling_timeout: int = 30, + backoff_config: BackoffConfig = DEFAULT_BACKOFF_CONFIG, + allowed_updates: Optional[List[str]] = None, + ) -> AsyncGenerator[Update, None]: + """ + Endless updates reader with correctly handling any server-side or connection errors. + + So you may not worry that the polling will stop working. + """ + backoff = Backoff(config=backoff_config) + get_updates = GetUpdates(timeout=polling_timeout, allowed_updates=allowed_updates) + kwargs = {} + if bot.session.timeout: + # Request timeout can be lower than session timeout and that's OK. + # To prevent false-positive TimeoutError we should wait longer than polling timeout + kwargs["request_timeout"] = int(bot.session.timeout + polling_timeout) + failed = False + while True: + try: + updates = await bot(get_updates, **kwargs) + except Exception as e: + failed = True + # In cases when Telegram Bot API was inaccessible don't need to stop polling + # process because some developers can't make auto-restarting of the script + loggers.dispatcher.error("Failed to fetch updates - %s: %s", type(e).__name__, e) + # And also backoff timeout is best practice to retry any network activity + loggers.dispatcher.warning( + "Sleep for %f seconds and try again... (tryings = %d, bot id = %d)", + backoff.next_delay, + backoff.counter, + bot.id, + ) + await backoff.asleep() + continue + + # In case when network connection was fixed let's reset the backoff + # to initial value and then process updates + if failed: + loggers.dispatcher.info( + "Connection established (tryings = %d, bot id = %d)", + backoff.counter, + bot.id, + ) + backoff.reset() + failed = False + + for update in updates: + yield update + # The getUpdates method returns the earliest 100 unconfirmed updates. + # To confirm an update, use the offset parameter when calling getUpdates + # All updates with update_id less than or equal to offset will be marked + # as confirmed on the server and will no longer be returned. + get_updates.offset = update.update_id + 1 + + async def _listen_update(self, update: Update, **kwargs: Any) -> Any: + """ + Main updates listener + + Workflow: + - Detect content type and propagate to observers in current router + - If no one filter is pass - propagate update to child routers as Update + + :param update: + :param kwargs: + :return: + """ + try: + update_type = update.event_type + event = update.event + except UpdateTypeLookupError as e: + warnings.warn( + "Detected unknown update type.\n" + "Seems like Telegram Bot API was updated and you have " + "installed not latest version of aiogram framework" + f"\nUpdate: {update.model_dump_json(exclude_unset=True)}", + RuntimeWarning, + ) + raise SkipHandler() from e + + kwargs.update(event_update=update) + + return await self.propagate_event(update_type=update_type, event=event, **kwargs) + + @classmethod + async def silent_call_request(cls, bot: Bot, result: TelegramMethod[Any]) -> None: + """ + Simulate answer into WebHook + + :param bot: + :param result: + :return: + """ + try: + await bot(result) + except TelegramAPIError as e: + # In due to WebHook mechanism doesn't allow getting response for + # requests called in answer to WebHook request. + # Need to skip unsuccessful responses. + # For debugging here is added logging. + loggers.event.error("Failed to make answer: %s: %s", e.__class__.__name__, e) + + async def _process_update( + self, bot: Bot, update: Update, call_answer: bool = True, **kwargs: Any + ) -> bool: + """ + Propagate update to event listeners + + :param bot: instance of Bot + :param update: instance of Update + :param call_answer: need to execute response as Telegram method (like answer into webhook) + :param kwargs: contextual data for middlewares, filters and handlers + :return: status + """ + try: + response = await self.feed_update(bot, update, **kwargs) + if call_answer and isinstance(response, TelegramMethod): + await self.silent_call_request(bot=bot, result=response) + return response is not UNHANDLED + + except Exception as e: + loggers.event.exception( + "Cause exception while process update id=%d by bot id=%d\n%s: %s", + update.update_id, + bot.id, + e.__class__.__name__, + e, + ) + return True # because update was processed but unsuccessful + + async def _polling( + self, + bot: Bot, + polling_timeout: int = 30, + handle_as_tasks: bool = True, + backoff_config: BackoffConfig = DEFAULT_BACKOFF_CONFIG, + allowed_updates: Optional[List[str]] = None, + **kwargs: Any, + ) -> None: + """ + Internal polling process + + :param bot: + :param kwargs: + :return: + """ + user: User = await bot.me() + loggers.dispatcher.info( + "Run polling for bot @%s id=%d - %r", user.username, bot.id, user.full_name + ) + try: + async for update in self._listen_updates( + bot, + polling_timeout=polling_timeout, + backoff_config=backoff_config, + allowed_updates=allowed_updates, + ): + handle_update = self._process_update(bot=bot, update=update, **kwargs) + if handle_as_tasks: + handle_update_task = asyncio.create_task(handle_update) + self._handle_update_tasks.add(handle_update_task) + handle_update_task.add_done_callback(self._handle_update_tasks.discard) + else: + await handle_update + finally: + loggers.dispatcher.info( + "Polling stopped for bot @%s id=%d - %r", user.username, bot.id, user.full_name + ) + + async def _feed_webhook_update(self, bot: Bot, update: Update, **kwargs: Any) -> Any: + """ + The same with `Dispatcher.process_update()` but returns real response instead of bool + """ + try: + return await self.feed_update(bot, update, **kwargs) + except Exception as e: + loggers.event.exception( + "Cause exception while process update id=%d by bot id=%d\n%s: %s", + update.update_id, + bot.id, + e.__class__.__name__, + e, + ) + raise + + async def feed_webhook_update( + self, bot: Bot, update: Union[Update, Dict[str, Any]], _timeout: float = 55, **kwargs: Any + ) -> Optional[TelegramMethod[TelegramType]]: + if not isinstance(update, Update): # Allow to use raw updates + update = Update.model_validate(update, context={"bot": bot}) + + ctx = contextvars.copy_context() + loop = asyncio.get_running_loop() + waiter = loop.create_future() + + def release_waiter(*_: Any) -> None: + if not waiter.done(): + waiter.set_result(None) + + timeout_handle = loop.call_later(_timeout, release_waiter) + + process_updates: Future[Any] = asyncio.ensure_future( + self._feed_webhook_update(bot=bot, update=update, **kwargs) + ) + process_updates.add_done_callback(release_waiter, context=ctx) + + def process_response(task: Future[Any]) -> None: + warnings.warn( + "Detected slow response into webhook.\n" + "Telegram is waiting for response only first 60 seconds and then re-send update.\n" + "For preventing this situation response into webhook returned immediately " + "and handler is moved to background and still processing update.", + RuntimeWarning, + ) + try: + result = task.result() + except Exception as e: + raise e + if isinstance(result, TelegramMethod): + asyncio.ensure_future(self.silent_call_request(bot=bot, result=result)) + + try: + try: + await waiter + except CancelledError: # pragma: no cover + process_updates.remove_done_callback(release_waiter) + process_updates.cancel() + raise + + if process_updates.done(): + # TODO: handle exceptions + response: Any = process_updates.result() + if isinstance(response, TelegramMethod): + return response + + else: + process_updates.remove_done_callback(release_waiter) + process_updates.add_done_callback(process_response, context=ctx) + + finally: + timeout_handle.cancel() + + return None + + async def stop_polling(self) -> None: + """ + Execute this method if you want to stop polling programmatically + + :return: + """ + if not self._running_lock.locked(): + raise RuntimeError("Polling is not started") + if not self._stop_signal or not self._stopped_signal: + return + self._stop_signal.set() + await self._stopped_signal.wait() + + def _signal_stop_polling(self, sig: signal.Signals) -> None: + if not self._running_lock.locked(): + return + + loggers.dispatcher.warning("Received %s signal", sig.name) + if not self._stop_signal: + return + self._stop_signal.set() + + async def start_polling( + self, + *bots: Bot, + polling_timeout: int = 10, + handle_as_tasks: bool = True, + backoff_config: BackoffConfig = DEFAULT_BACKOFF_CONFIG, + allowed_updates: Optional[Union[List[str], UNSET_TYPE]] = UNSET, + handle_signals: bool = True, + close_bot_session: bool = True, + **kwargs: Any, + ) -> None: + """ + Polling runner + + :param bots: Bot instances (one or more) + :param polling_timeout: Long-polling wait time + :param handle_as_tasks: Run task for each event and no wait result + :param backoff_config: backoff-retry config + :param allowed_updates: List of the update types you want your bot to receive + By default, all used update types are enabled (resolved from handlers) + :param handle_signals: handle signals (SIGINT/SIGTERM) + :param close_bot_session: close bot sessions on shutdown + :param kwargs: contextual data + :return: + """ + if not bots: + raise ValueError("At least one bot instance is required to start polling") + if "bot" in kwargs: + raise ValueError( + "Keyword argument 'bot' is not acceptable, " + "the bot instance should be passed as positional argument" + ) + + async with self._running_lock: # Prevent to run this method twice at a once + if self._stop_signal is None: + self._stop_signal = Event() + if self._stopped_signal is None: + self._stopped_signal = Event() + + if allowed_updates is UNSET: + allowed_updates = self.resolve_used_update_types() + + self._stop_signal.clear() + self._stopped_signal.clear() + + if handle_signals: + loop = asyncio.get_running_loop() + with suppress(NotImplementedError): # pragma: no cover + # Signals handling is not supported on Windows + # It also can't be covered on Windows + loop.add_signal_handler( + signal.SIGTERM, self._signal_stop_polling, signal.SIGTERM + ) + loop.add_signal_handler( + signal.SIGINT, self._signal_stop_polling, signal.SIGINT + ) + + workflow_data = { + "dispatcher": self, + "bots": bots, + **self.workflow_data, + **kwargs, + } + if "bot" in workflow_data: + workflow_data.pop("bot") + + await self.emit_startup(bot=bots[-1], **workflow_data) + loggers.dispatcher.info("Start polling") + try: + tasks: List[asyncio.Task[Any]] = [ + asyncio.create_task( + self._polling( + bot=bot, + handle_as_tasks=handle_as_tasks, + polling_timeout=polling_timeout, + backoff_config=backoff_config, + allowed_updates=allowed_updates, + **workflow_data, + ) + ) + for bot in bots + ] + tasks.append(asyncio.create_task(self._stop_signal.wait())) + done, pending = await asyncio.wait(tasks, return_when=asyncio.FIRST_COMPLETED) + + for task in pending: + # (mostly) Graceful shutdown unfinished tasks + task.cancel() + with suppress(CancelledError): + await task + # Wait finished tasks to propagate unhandled exceptions + await asyncio.gather(*done) + + finally: + loggers.dispatcher.info("Polling stopped") + try: + await self.emit_shutdown(bot=bots[-1], **workflow_data) + finally: + if close_bot_session: + await asyncio.gather(*(bot.session.close() for bot in bots)) + self._stopped_signal.set() + + def run_polling( + self, + *bots: Bot, + polling_timeout: int = 10, + handle_as_tasks: bool = True, + backoff_config: BackoffConfig = DEFAULT_BACKOFF_CONFIG, + allowed_updates: Optional[Union[List[str], UNSET_TYPE]] = UNSET, + handle_signals: bool = True, + close_bot_session: bool = True, + **kwargs: Any, + ) -> None: + """ + Run many bots with polling + + :param bots: Bot instances (one or more) + :param polling_timeout: Long-polling wait time + :param handle_as_tasks: Run task for each event and no wait result + :param backoff_config: backoff-retry config + :param allowed_updates: List of the update types you want your bot to receive + :param handle_signals: handle signals (SIGINT/SIGTERM) + :param close_bot_session: close bot sessions on shutdown + :param kwargs: contextual data + :return: + """ + with suppress(KeyboardInterrupt): + return asyncio.run( + self.start_polling( + *bots, + **kwargs, + polling_timeout=polling_timeout, + handle_as_tasks=handle_as_tasks, + backoff_config=backoff_config, + allowed_updates=allowed_updates, + handle_signals=handle_signals, + close_bot_session=close_bot_session, + ) + ) diff --git a/env/Lib/site-packages/aiogram/dispatcher/event/__init__.py b/env/Lib/site-packages/aiogram/dispatcher/event/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/aiogram/dispatcher/event/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/dispatcher/event/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..86e914cc3e2aabe3ed6f6cf6c0c70b133a85c88c GIT binary patch literal 194 zcmZ3^%ge<81lwkxNdwW3K?DpiLK&agfQ;!3DGb33nv8xc8H$*I{LdiCU!g8mG2!_| z*)h)fDVcfcG1;X>i6!|(@k#k5F{ycFF+Q0|F~ylBsk#M;$=QkNsl_pgnfd8OiMjeI znZ*T(CCM47Mf#~_sd**(@$s2?nI-Y@dIgogIBatBQ%ZAE?TT1|wt(DG%nu|!Ff%eT MeqewRMa)1k0H3il!2kdN literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/dispatcher/event/__pycache__/bases.cpython-311.pyc b/env/Lib/site-packages/aiogram/dispatcher/event/__pycache__/bases.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b11bc8220829a5460f2418f0d4dc488a48f58540 GIT binary patch literal 1806 zcmbVMJ#5=n5PnajBvOBoEK6}>M^@`D8e+%pRulnTNvLb23hJK}Wz`Cl_^dJ}DfN*` z;-DymB2&@9n};r)TmE4LxUbwDIq&VBN{b`Nfk=b4j2JbPy|y{L^G%a&5#l@ z!%Enc6v>no*^DR=KTj~CW=x5JEowm{ZYGoj*dZ-!TrrbMl9B*nvL>;_Px5YnkUe;Y zqNG@mrC5lKF<~QcZR94+027&Twm%|D*Yv7GX0{lRsM+wk7gb{^mLD^CSas?{vjWVMyTWxHrO=eeBy@i#{X}aB3oyHf8&oR9GTpfzDXWLtR9Dsdw6^x@Rpt`4@z9@A| z{Q4;4KNJ}+s#b#;qcS;Ch9d=sXp?B=M#|q!od(fg@xmsvZK&ZSKAPpHw!=U3LfjuQ z$Jep(cc;N51g8lPJ$eg_9papeeMQ<-qr2eQJN14;3xUVENFHQG)oqqnt^B#k_<_f9 zf6{pyCe~(Jf%=VtuW9%R8=>+XFYk$%!DqnqBiPC=`BNg%>~_=5-uhwsMP$AgnRmr` zzy1QP6ht3{=OLB9feH&MOd<(3IzVC|0mqWOkh9f>VRI3af~Z2M!l>{Jmr>#W7LS7R z;vGwO9A-PSW~;HuW9SP42D3Tx(My`AoVI6?20V#pQy3GV#okzjJ#x;-jy(4guk7XZ z%F<$`bf;YMq?Ph=xwrr1KaneP%%syuNl2*J=m5QE`kAv6}~CI(3o&-7xsuH28Nd(o+`Gzd{D56ES;UHAjN Z$7dnwa*}^=`-4lFB3&4ee^Wk7{{qF)y`}&F literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/dispatcher/event/__pycache__/event.cpython-311.pyc b/env/Lib/site-packages/aiogram/dispatcher/event/__pycache__/event.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4e1b355826ae8d08fcf6727149523717113d796e GIT binary patch literal 2661 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/dispatcher/event/__pycache__/telegram.cpython-311.pyc b/env/Lib/site-packages/aiogram/dispatcher/event/__pycache__/telegram.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..eb2991967df4acc6c89a0e7f72cbbef3bc641269 GIT binary patch literal 7459 zcmbVRTWlLwdOkD5%a9^PN|q(+W{<8mW1Dv3tmQbecO6TPHi>1!mJ@`w%Z@lBnbz>q zGebL4DOBhh4UMWrwrJr1o1j9Gb?uFT`l-m{cAxst2T~wlVgLgMiUpcC8cqtsPyPQh zoFS>pZrj7rKWEPMKj-|H@BI4bV9-w>{p+v(W8oh=3HeX_u#?Nma4)}u%zdH|h0{oy zi*p?2d5upCaUt!ByVCBsJMD>k(%!f?EyhJwFKE8BKkkRTOL1#$=|DWd@*XXiZjZOK zyjKgQ!|^cWMa8Feq&wrC={@m1>8^NJdT)F$EB9;N>7IB`Iuehhd*i(vQ3dLO`P;O< zbbq{`BRqMZD1o~~2|nNn`4;}H6dzF9uaIcyd;E-YW}BSJWDVI!WixuzV+Q9wy)>OT zH#2?i!=KN-ZwhBK%cgiv)--uuQ%%=YDruOmk5al}iWhU(N!DPHjteP8(bPLKRWHaH zc~Pa`3)b*`S2KD(m&;N^RX$Xg?_{ZRmM-SgYQ}(mp7SZqP$}fv=TuEyq;mS={4F(U ze9vKbmnmMJ{$Tpt-1L;`yE;2_c6RC`$hJ3Tn_JGQX4{peRBlGj00%TGm;q#WUQRBt z%78V6HLMw|H?uyGgUi`GaFE2^uoJQliF^4cK<^Wk#5sk;d4-D$%6>(>3umiHN*lc0 z%8(L-w?}DLLSJ#pu(J2AC+<~7ls+gGl~JW1-adE_z}sJMHKy!?R&DGY#?8I<%BOF` zrd*uYReD>cD-ZkxI%nmP&SWNyYZMpS7D&sVXgJ^HNgINK{>f15&AU)7lg1 zPRh6`EwHVQvF39(Q+i|6J1I?*bR(OyhLmzNo0AurNJw{Xsu}1?b;B7Ay5?kEw?;BO zlx-mGfxR;QjHg6KPOGM%8x(3)BTqA?Yc`uvll6_o%_XQt@Xfva4P@?<0#_gjEN7{} z!xxGGON#`)904}Gb~zyrAp5QJ39ahNNyr~;<+i&RK|4o4jqj30@|bT`7Z}r-Pa&W< z!fcDIAd`D=86L=hHQ=BLKRfq`&><*ziNn9XI(6#$Ct135{ajW_Wfre5<*96BX<|NW zTvs!IX6Jw3gVaP^#Q-oGbb4;%# zEqYX>eNadHftX@lo^*=V(e$Ssr8mP&2ojAF+Rb_->RmuBUAn3*G)B`=7(l}5h}E#p z>&m`Ayp~>Qt#wSQ6rTb9hG zbGwRp-LN$Yx!ofM1L+cwHBuV8Vm-h0{#tu7Q67J{GXAbpXeod|-+;DE3QUjsnW1Ks zC{GXBWzBq<9&6T>ft|(GszrIy-)HmJ0wfS#KV4~)N^J+LqvOS?^$V52P*n`92SGNU zildw2sKw8}Pr$o8cBKMToU4d)CHrA)z8*#Qd#%+6UbES-9NUc>+fIqu+D+gEPpS2U z3{=H>0%>(5^OjTIdV;NAQ{=|!RldOALOo$=!?CY+3BF-uv^Xraj<6~e1lm{NHXKW9 zx5IZqxFy=(t^GK%ex?Ar@Q9m@`b?36bW>ebOt+EG0Te*PW%`phVvKia zdklutQ$WC&O`a*XJ?q~0b$(;+n`@P^cgy=HEBhzQ-KQ(vr)xy;on)kVzS=Wb={fMU z=g?-)p@&nCFP3{ID?O9NnQEw~M!4X~YPkPtcz82Bym7KJa-tlbsDvj<;fYtzLwzN& zk4ez%BhGX$X!4>?$6#{$9+1}&8_r!rjCT#3_hAXZ-;EolX9;i}w8c|R+QNYfj>i>3 z!*~Y1z%aV#Tg{5Ea4mx6+S%kifI%8Ay!C*81qShJp|$KUxdOk&rwE9g0HSwf)!pps z3vR;^7Jvu9Z3Fqz?t*(4(c~YyT4w>#iZu)D&Z22_0Q2=!;1o9)Z{VqQMFsw`=K(0v zx4S442L=+%xp(EDV`3e1Zkg-43w5exA8hv}Kwy9+BssGz$%

  • m>_fOK@NeW9yQU z1=FwAF(H+ylva(KSw#YG0JvXrz8O^KGtvn!0Et_4E zWJ5}3DQHQKp(IJkCfO1!914I`1;}|xQ)L}jlg{1-USMG>{Y{HqpxLzL=@7}p{Im2d z9M3je`2Y7<^eBu+ncku%)GYx$4*8Y0c2<0Qo0?IW?Vvt^ezt>(oG-EG$;8(K8;j-M zSfw{+l>oIJ6w_C9D@JvZ2~QEMe*W z0j%=Kxg7X72Gyb-%h5Ro!2&~5*vOIYk$^xxW>CXKIVS(lkw=o?tkh3P5-08$AjguiOSeStqrScq(NT@-aYL<5Fj<; z4Yt=hNuZ;6y4uxUoPOTbUn9J4f|26XvrzAsqrdi)LkB9M185Q_s^PAu;pk>K`ovud zN6X<8mGFsD_{6K{=zO1w1DoQ&vp{dPcc{t^;JZcG@N(pQC33#n-Cy&%g6%H|kROn| z5IjEr4+Kb!kuV8IiXnD9rkm+2ZD)H1n=Zd@Z?&aK^dEM@JlF*8WgIfCuyO;f>$cSF zngLX`*tS&{5B3+XO+srq0IicSP*h+p&J5q7a<181(J0oso6a7wHN6PL3}WM)sw5b; z*U|hp9sgc7)K=KPa%g8I*s(EQuXSV(1j9pm2fqqEjhx(!oU8`I2#o?=FWf>eY&MW$ zuqKl5U~%=!s~c10P_z928hlOP};5^jswfID1AELDI|#UwO^)eAeX z`4`|=|6KT(+!y}JbsYq0)wSvd_pKH9ot<>Sz12PXaAzHtwt>RDEfvVl?skiV6q;~h zt5ADj1s;eDY`K#+bD!inxRs9(1GTQ6MhO)-@+ny_-XWg}pOQP=`rjB~yOyw9{K_vK ze|o7N?ojL3BXDi@MHk$w!XhIO@@NW*fM2shB5AywTY(T%jTtB20+%o5KQ+zvpLicj z8M=L+V!pHyM#0{uw>~YPS&9alehkF)SO%PFD!q)wKf_`ddN>N6j8H@&QSTOkrJrIe zh`;E0&Df&QsZ0jkGr~8V7m|f%y#`G!LhNp3aA#4jSEEAd{|)57;0LPfCy{}_U#*dV zZ;+AV`&H>c@%$I>lmmm+q1Z;xH-iuJrJIY<+=9}^q8uK_ST3mI9LsL z-w*y>@Jpo}9;t*!O5u?j@9h|@jvlOxzVmeSgU!(os*!=GkvBIZZX$o{Va zU@ykH!Cs7Ye{liq#qiM$nEA;Zho|2vQWy*=*Vb#g#okDr4R!7%ByYnZbmkT(uX zEuRh=K_id$ia}@zGM|&rxzG8}1qdU#i+qtQ3PrNuQe1ZftFD3zK%!^mlq0oMDxf6{ zBeC1Q?Q0R5wV+1b>0n`fjBe0DAPyUlXKXM~6oZd{aG~M6=V}S=&~O5BMOETwEiA&(3(y&S34;(0MxkgunQU4fWDQbX+${e>SB~y1Zixhncysuw z-r*jMs3Q=21r{{Wi&yC{50(N`8=nBNo+s1r{_bPvySk^pc+mn;t}PqE0zNESXZykT zkYlz0#``=@hX?hikm{-;+RW_+e(d_cz|NrcDbpUgCl5`&sxV^U5UEf&{l^}&%K{Krm{l`>z5 zW|mnKddX>twSXTR^;sjDjeNj)-EUyOX41*I-v*1+LOgri zy*1KGj^X&;b~gk7{wT3_02eydIy9HR98;rl?6QZT%0Z9wt^lORDT&MY?rc3Dgl&Y#y$1)+NOa)2h0KoZVQg zQ}ox&v(Zk>F-M0k%~Dqk8(Jae-W_;p`j>=t&O_LI7|93_h@4wOb%y5P6Ya2m04SJy zj;oU4QtR`aOqc#I&vP NoReturn: + """ + Raise an SkipHandler + """ + raise SkipHandler(message or "Event skipped") diff --git a/env/Lib/site-packages/aiogram/dispatcher/event/event.py b/env/Lib/site-packages/aiogram/dispatcher/event/event.py new file mode 100644 index 0000000..3cbcffe --- /dev/null +++ b/env/Lib/site-packages/aiogram/dispatcher/event/event.py @@ -0,0 +1,53 @@ +from __future__ import annotations + +from typing import Any, Callable, List + +from .handler import CallbackType, HandlerObject + + +class EventObserver: + """ + Simple events observer + + Is used for managing events is not related with Telegram + (For example startup/shutdown processes) + + Handlers can be registered via decorator or method + + .. code-block:: python + + .register(my_handler) + + .. code-block:: python + + @() + async def my_handler(*args, **kwargs): ... + """ + + def __init__(self) -> None: + self.handlers: List[HandlerObject] = [] + + def register(self, callback: CallbackType) -> None: + """ + Register callback with filters + """ + self.handlers.append(HandlerObject(callback=callback)) + + async def trigger(self, *args: Any, **kwargs: Any) -> None: + """ + Propagate event to handlers. + Handler will be called when all its filters is pass. + """ + for handler in self.handlers: + await handler.call(*args, **kwargs) + + def __call__(self) -> Callable[[CallbackType], CallbackType]: + """ + Decorator for registering event handlers + """ + + def wrapper(callback: CallbackType) -> CallbackType: + self.register(callback) + return callback + + return wrapper diff --git a/env/Lib/site-packages/aiogram/dispatcher/event/handler.py b/env/Lib/site-packages/aiogram/dispatcher/event/handler.py new file mode 100644 index 0000000..8c283dd --- /dev/null +++ b/env/Lib/site-packages/aiogram/dispatcher/event/handler.py @@ -0,0 +1,99 @@ +import asyncio +import contextvars +import inspect +import warnings +from dataclasses import dataclass, field +from functools import partial +from typing import Any, Callable, Dict, List, Optional, Set, Tuple + +from magic_filter.magic import MagicFilter as OriginalMagicFilter + +from aiogram.dispatcher.flags import extract_flags_from_object +from aiogram.filters.base import Filter +from aiogram.handlers import BaseHandler +from aiogram.utils.magic_filter import MagicFilter +from aiogram.utils.warnings import Recommendation + +CallbackType = Callable[..., Any] + + +@dataclass +class CallableObject: + callback: CallbackType + awaitable: bool = field(init=False) + params: Set[str] = field(init=False) + varkw: bool = field(init=False) + + def __post_init__(self) -> None: + callback = inspect.unwrap(self.callback) + self.awaitable = inspect.isawaitable(callback) or inspect.iscoroutinefunction(callback) + spec = inspect.getfullargspec(callback) + self.params = {*spec.args, *spec.kwonlyargs} + self.varkw = spec.varkw is not None + + def _prepare_kwargs(self, kwargs: Dict[str, Any]) -> Dict[str, Any]: + if self.varkw: + return kwargs + + return {k: kwargs[k] for k in self.params if k in kwargs} + + async def call(self, *args: Any, **kwargs: Any) -> Any: + wrapped = partial(self.callback, *args, **self._prepare_kwargs(kwargs)) + if self.awaitable: + return await wrapped() + + loop = asyncio.get_event_loop() + context = contextvars.copy_context() + wrapped = partial(context.run, wrapped) + return await loop.run_in_executor(None, wrapped) + + +@dataclass +class FilterObject(CallableObject): + magic: Optional[MagicFilter] = None + + def __post_init__(self) -> None: + if isinstance(self.callback, OriginalMagicFilter): + # MagicFilter instance is callable but generates + # only "CallOperation" instead of applying the filter + self.magic = self.callback + self.callback = self.callback.resolve + if not isinstance(self.magic, MagicFilter): + # Issue: https://github.com/aiogram/aiogram/issues/990 + warnings.warn( + category=Recommendation, + message="You are using F provided by magic_filter package directly, " + "but it lacks `.as_()` extension." + "\n Please change the import statement: from `from magic_filter import F` " + "to `from aiogram import F` to silence this warning.", + stacklevel=6, + ) + + super(FilterObject, self).__post_init__() + + if isinstance(self.callback, Filter): + self.awaitable = True + + +@dataclass +class HandlerObject(CallableObject): + filters: Optional[List[FilterObject]] = None + flags: Dict[str, Any] = field(default_factory=dict) + + def __post_init__(self) -> None: + super(HandlerObject, self).__post_init__() + callback = inspect.unwrap(self.callback) + if inspect.isclass(callback) and issubclass(callback, BaseHandler): + self.awaitable = True + self.flags.update(extract_flags_from_object(callback)) + + async def check(self, *args: Any, **kwargs: Any) -> Tuple[bool, Dict[str, Any]]: + if not self.filters: + return True, kwargs + for event_filter in self.filters: + check = await event_filter.call(*args, **kwargs) + if not check: + return False, kwargs + if isinstance(check, dict): + kwargs.update(check) + return True, kwargs diff --git a/env/Lib/site-packages/aiogram/dispatcher/event/telegram.py b/env/Lib/site-packages/aiogram/dispatcher/event/telegram.py new file mode 100644 index 0000000..afa8938 --- /dev/null +++ b/env/Lib/site-packages/aiogram/dispatcher/event/telegram.py @@ -0,0 +1,141 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional + +from aiogram.dispatcher.middlewares.manager import MiddlewareManager + +from ...exceptions import UnsupportedKeywordArgument +from ...filters.base import Filter +from ...types import TelegramObject +from .bases import REJECTED, UNHANDLED, MiddlewareType, SkipHandler +from .handler import CallbackType, FilterObject, HandlerObject + +if TYPE_CHECKING: + from aiogram.dispatcher.router import Router + + +class TelegramEventObserver: + """ + Event observer for Telegram events + + Here you can register handler with filter. + This observer will stop event propagation when first handler is pass. + """ + + def __init__(self, router: Router, event_name: str) -> None: + self.router: Router = router + self.event_name: str = event_name + + self.handlers: List[HandlerObject] = [] + + self.middleware = MiddlewareManager() + self.outer_middleware = MiddlewareManager() + + # Re-used filters check method from already implemented handler object + # with dummy callback which never will be used + self._handler = HandlerObject(callback=lambda: True, filters=[]) + + def filter(self, *filters: CallbackType) -> None: + """ + Register filter for all handlers of this event observer + + :param filters: positional filters + """ + if self._handler.filters is None: + self._handler.filters = [] + self._handler.filters.extend([FilterObject(filter_) for filter_ in filters]) + + def _resolve_middlewares(self) -> List[MiddlewareType[TelegramObject]]: + middlewares: List[MiddlewareType[TelegramObject]] = [] + for router in reversed(tuple(self.router.chain_head)): + observer = router.observers.get(self.event_name) + if observer: + middlewares.extend(observer.middleware) + + return middlewares + + def register( + self, + callback: CallbackType, + *filters: CallbackType, + flags: Optional[Dict[str, Any]] = None, + **kwargs: Any, + ) -> CallbackType: + """ + Register event handler + """ + if kwargs: + raise UnsupportedKeywordArgument( + "Passing any additional keyword arguments to the registrar method " + "is not supported.\n" + "This error may be caused when you are trying to register filters like in 2.x " + "version of this framework, if it's true just look at correspoding " + "documentation pages.\n" + f"Please remove the {set(kwargs.keys())} arguments from this call.\n" + ) + + if flags is None: + flags = {} + + for item in filters: + if isinstance(item, Filter): + item.update_handler_flags(flags=flags) + + self.handlers.append( + HandlerObject( + callback=callback, + filters=[FilterObject(filter_) for filter_ in filters], + flags=flags, + ) + ) + + return callback + + def wrap_outer_middleware( + self, callback: Any, event: TelegramObject, data: Dict[str, Any] + ) -> Any: + wrapped_outer = self.middleware.wrap_middlewares( + self.outer_middleware, + callback, + ) + return wrapped_outer(event, data) + + def check_root_filters(self, event: TelegramObject, **kwargs: Any) -> Any: + return self._handler.check(event, **kwargs) + + async def trigger(self, event: TelegramObject, **kwargs: Any) -> Any: + """ + Propagate event to handlers and stops propagation on first match. + Handler will be called when all its filters are pass. + """ + for handler in self.handlers: + kwargs["handler"] = handler + result, data = await handler.check(event, **kwargs) + if result: + kwargs.update(data) + try: + wrapped_inner = self.outer_middleware.wrap_middlewares( + self._resolve_middlewares(), + handler.call, + ) + return await wrapped_inner(event, kwargs) + except SkipHandler: + continue + + return UNHANDLED + + def __call__( + self, + *filters: CallbackType, + flags: Optional[Dict[str, Any]] = None, + **kwargs: Any, + ) -> Callable[[CallbackType], CallbackType]: + """ + Decorator for registering event handlers + """ + + def wrapper(callback: CallbackType) -> CallbackType: + self.register(callback, *filters, flags=flags, **kwargs) + return callback + + return wrapper diff --git a/env/Lib/site-packages/aiogram/dispatcher/flags.py b/env/Lib/site-packages/aiogram/dispatcher/flags.py new file mode 100644 index 0000000..aad8a29 --- /dev/null +++ b/env/Lib/site-packages/aiogram/dispatcher/flags.py @@ -0,0 +1,127 @@ +from dataclasses import dataclass +from typing import TYPE_CHECKING, Any, Callable, Dict, Optional, Union, cast, overload + +from magic_filter import AttrDict, MagicFilter + +if TYPE_CHECKING: + from aiogram.dispatcher.event.handler import HandlerObject + + +@dataclass(frozen=True) +class Flag: + name: str + value: Any + + +@dataclass(frozen=True) +class FlagDecorator: + flag: Flag + + @classmethod + def _with_flag(cls, flag: Flag) -> "FlagDecorator": + return cls(flag) + + def _with_value(self, value: Any) -> "FlagDecorator": + new_flag = Flag(self.flag.name, value) + return self._with_flag(new_flag) + + @overload + def __call__(self, value: Callable[..., Any], /) -> Callable[..., Any]: # type: ignore + pass + + @overload + def __call__(self, value: Any, /) -> "FlagDecorator": + pass + + @overload + def __call__(self, **kwargs: Any) -> "FlagDecorator": + pass + + def __call__( + self, + value: Optional[Any] = None, + **kwargs: Any, + ) -> Union[Callable[..., Any], "FlagDecorator"]: + if value and kwargs: + raise ValueError("The arguments `value` and **kwargs can not be used together") + + if value is not None and callable(value): + value.aiogram_flag = { + **extract_flags_from_object(value), + self.flag.name: self.flag.value, + } + return cast(Callable[..., Any], value) + return self._with_value(AttrDict(kwargs) if value is None else value) + + +if TYPE_CHECKING: + + class _ChatActionFlagProtocol(FlagDecorator): + def __call__( # type: ignore[override] + self, + action: str = ..., + interval: float = ..., + initial_sleep: float = ..., + **kwargs: Any, + ) -> FlagDecorator: + pass + + +class FlagGenerator: + def __getattr__(self, name: str) -> FlagDecorator: + if name[0] == "_": + raise AttributeError("Flag name must NOT start with underscore") + return FlagDecorator(Flag(name, True)) + + if TYPE_CHECKING: + chat_action: _ChatActionFlagProtocol + + +def extract_flags_from_object(obj: Any) -> Dict[str, Any]: + if not hasattr(obj, "aiogram_flag"): + return {} + return cast(Dict[str, Any], obj.aiogram_flag) + + +def extract_flags(handler: Union["HandlerObject", Dict[str, Any]]) -> Dict[str, Any]: + """ + Extract flags from handler or middleware context data + + :param handler: handler object or data + :return: dictionary with all handler flags + """ + if isinstance(handler, dict) and "handler" in handler: + handler = handler["handler"] + if hasattr(handler, "flags"): + return handler.flags + return {} + + +def get_flag( + handler: Union["HandlerObject", Dict[str, Any]], + name: str, + *, + default: Optional[Any] = None, +) -> Any: + """ + Get flag by name + + :param handler: handler object or data + :param name: name of the flag + :param default: default value (None) + :return: value of the flag or default + """ + flags = extract_flags(handler) + return flags.get(name, default) + + +def check_flags(handler: Union["HandlerObject", Dict[str, Any]], magic: MagicFilter) -> Any: + """ + Check flags via magic filter + + :param handler: handler object or data + :param magic: instance of the magic + :return: the result of magic filter check + """ + flags = extract_flags(handler) + return magic.resolve(AttrDict(flags)) diff --git a/env/Lib/site-packages/aiogram/dispatcher/middlewares/__init__.py b/env/Lib/site-packages/aiogram/dispatcher/middlewares/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/aiogram/dispatcher/middlewares/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/dispatcher/middlewares/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0cf8139c055e11a9bf215297ebfb01dc84dc3683 GIT binary patch literal 200 zcmZ3^%ge<81lwkxNdwW3K?DpiLK&agfQ;!3DGb33nv8xc8H$*I{LdiCU(qgBG2!_| z*)h)fDVcfcG1;X>i6!|(@k#k5F{ycFF+Q0|F~ylBsk#M;$=QkNsl_pgnfd8OiMjeI znZ*T(CCM47Mf$m!DJeOr<%vb9#rpB_nR%Hd@$q^EmA^P_a`RJ4b5iY!Sb=tdTvN;s SBt9@RGBSQ(fDuK^KrsLvNH#VA literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/dispatcher/middlewares/__pycache__/base.cpython-311.pyc b/env/Lib/site-packages/aiogram/dispatcher/middlewares/__pycache__/base.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d4a6c6aea3d6023be8d5e9b8967971236374ac98 GIT binary patch literal 1551 zcma)6J8#=o6ux|lqAbNhUPy+3XcudUJTyZ=1O^f%Fw(g0V50^Iq4Xv1wal0g^^!_r zPcCYp89I1N(C%&vckonn=+Ga~K|_atlYuVn#=xC2^&Cp3tt3OQ$WQ0Ndmi7p6Ocn{#_6XCtbO4zT;hy+rSZ#&0jek&W%eiv*UN>)1 zFU0DH`xU6lbRZN18~{1a)bxtj8DL$rWMaRFf#AVsnZc$JPXnR&HPO+=Fi5R&X=tZwsXUE zeK_W>yK`;&sB}&pSW?;q_#1w^q_|1y&FAU~7|3#a1_Q)2;;x&Ut{Ww67@|Dmx?ciU z6Hm=`S>n5{zQ~6JW)uX$ zAo}G(ZfVWqi`QQ+{CN9FIa)a~eqI>euz!8{yZ_tr=*B01UVKz&@JOMP*_%ZTC4*eJ zwExjdW&h)EE@h7fa5T57#@&8`}4k?7V&_gUpI2Hi{g(M{r)U6tzWfQd8csIdh*EVn0gtP`B zKoy6o;?$rPq#i2TiXyd_p3A)lBjsSNgoM;fBUP%a^nh~e%yaBueh!^|{ycBq+wr__ zW}d%~$0LC9>o>p8>oUL}G-->{QrP;}sH}hqCbPj|8e^mf?0_R_k|S%fqiBkwYN`{| zf=);a;ksnXcG!t%5htoe#ayvtPF#zlu9`tR;Uu-BlhRU7T1%rXWQOe?r&sG`U`brX zJrR4Gvt8THAOI)8jNSq>X7xUh03PC}C0fRePeU%TM$;VgqeiJz_6)CBF1b0?kDosG z;e`JpkxwuL5-7Ym**7Yx^1Bj>q*pEzyV)&e)2 z59TgfxTv0~n1*NJk3=RoFY}4ZR>@ln&}PXGpUF>-=EqM>jQjC1qg1f$Nuy-i7Wbpm zi^a<3WR10=OdK~{>;0mM84nq;T0}e{D9LrzI(tTK1V9cen{7grJ|?npZ33eoRRiY5`%E#2-l&J z*>zj~B6=I2bu@q6uAjGo~lm8+18opn<-nMbi~ibr&{^+a0( zs0F%Xs>wgSWHF_C82NYXOZH;CSCyLLrMCQ384uQ!Lf{;p>8gAU&vRo_TVhLaMLGvd zET`m=SxPk4lv)+NzIPczv^@}sjqpLsHLcy;LTZ4 zq@Nas5zz%N)T|#B^*b_${|c@sTT$?$^nIDEyqBEPg)CTY9k!c*jnI)6Wk>nDxR3s6 z+`kc;5@W0Zd+Oce8N65jKjRtftG{kEUNJV{SpChT0oi)@cqXMVH7whZ2kYIVsb(0a S=vBCL?H{uK`n1fH~&? literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/dispatcher/middlewares/__pycache__/manager.cpython-311.pyc b/env/Lib/site-packages/aiogram/dispatcher/middlewares/__pycache__/manager.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..96bf53e4380f9c43c37f3c285a7e0c095edb7071 GIT binary patch literal 4299 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 Any: # pragma: no cover + """ + Execute middleware + + :param handler: Wrapped handler in middlewares chain + :param event: Incoming event (Subclass of :class:`aiogram.types.base.TelegramObject`) + :param data: Contextual data. Will be mapped to handler arguments + :return: :class:`Any` + """ + pass diff --git a/env/Lib/site-packages/aiogram/dispatcher/middlewares/error.py b/env/Lib/site-packages/aiogram/dispatcher/middlewares/error.py new file mode 100644 index 0000000..4b68c0b --- /dev/null +++ b/env/Lib/site-packages/aiogram/dispatcher/middlewares/error.py @@ -0,0 +1,36 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Awaitable, Callable, Dict, cast + +from ...types import TelegramObject, Update +from ...types.error_event import ErrorEvent +from ..event.bases import UNHANDLED, CancelHandler, SkipHandler +from .base import BaseMiddleware + +if TYPE_CHECKING: + from ..router import Router + + +class ErrorsMiddleware(BaseMiddleware): + def __init__(self, router: Router): + self.router = router + + async def __call__( + self, + handler: Callable[[TelegramObject, Dict[str, Any]], Awaitable[Any]], + event: TelegramObject, + data: Dict[str, Any], + ) -> Any: + try: + return await handler(event, data) + except (SkipHandler, CancelHandler): # pragma: no cover + raise + except Exception as e: + response = await self.router.propagate_event( + update_type="error", + event=ErrorEvent(update=cast(Update, event), exception=e), + **data, + ) + if response is not UNHANDLED: + return response + raise diff --git a/env/Lib/site-packages/aiogram/dispatcher/middlewares/manager.py b/env/Lib/site-packages/aiogram/dispatcher/middlewares/manager.py new file mode 100644 index 0000000..bcad4de --- /dev/null +++ b/env/Lib/site-packages/aiogram/dispatcher/middlewares/manager.py @@ -0,0 +1,65 @@ +import functools +from typing import Any, Callable, Dict, List, Optional, Sequence, Union, overload + +from aiogram.dispatcher.event.bases import ( + MiddlewareEventType, + MiddlewareType, + NextMiddlewareType, +) +from aiogram.dispatcher.event.handler import CallbackType +from aiogram.types import TelegramObject + + +class MiddlewareManager(Sequence[MiddlewareType[TelegramObject]]): + def __init__(self) -> None: + self._middlewares: List[MiddlewareType[TelegramObject]] = [] + + def register( + self, + middleware: MiddlewareType[TelegramObject], + ) -> MiddlewareType[TelegramObject]: + self._middlewares.append(middleware) + return middleware + + def unregister(self, middleware: MiddlewareType[TelegramObject]) -> None: + self._middlewares.remove(middleware) + + def __call__( + self, + middleware: Optional[MiddlewareType[TelegramObject]] = None, + ) -> Union[ + Callable[[MiddlewareType[TelegramObject]], MiddlewareType[TelegramObject]], + MiddlewareType[TelegramObject], + ]: + if middleware is None: + return self.register + return self.register(middleware) + + @overload + def __getitem__(self, item: int) -> MiddlewareType[TelegramObject]: + pass + + @overload + def __getitem__(self, item: slice) -> Sequence[MiddlewareType[TelegramObject]]: + pass + + def __getitem__( + self, item: Union[int, slice] + ) -> Union[MiddlewareType[TelegramObject], Sequence[MiddlewareType[TelegramObject]]]: + return self._middlewares[item] + + def __len__(self) -> int: + return len(self._middlewares) + + @staticmethod + def wrap_middlewares( + middlewares: Sequence[MiddlewareType[MiddlewareEventType]], handler: CallbackType + ) -> NextMiddlewareType[MiddlewareEventType]: + @functools.wraps(handler) + def handler_wrapper(event: TelegramObject, kwargs: Dict[str, Any]) -> Any: + return handler(event, **kwargs) + + middleware = handler_wrapper + for m in reversed(middlewares): + middleware = functools.partial(m, middleware) # type: ignore[assignment] + return middleware diff --git a/env/Lib/site-packages/aiogram/dispatcher/middlewares/user_context.py b/env/Lib/site-packages/aiogram/dispatcher/middlewares/user_context.py new file mode 100644 index 0000000..aa03ee6 --- /dev/null +++ b/env/Lib/site-packages/aiogram/dispatcher/middlewares/user_context.py @@ -0,0 +1,178 @@ +from dataclasses import dataclass +from typing import Any, Awaitable, Callable, Dict, Optional + +from aiogram.dispatcher.middlewares.base import BaseMiddleware +from aiogram.types import ( + Chat, + ChatBoostSourcePremium, + InaccessibleMessage, + TelegramObject, + Update, + User, +) + +EVENT_CONTEXT_KEY = "event_context" + +EVENT_FROM_USER_KEY = "event_from_user" +EVENT_CHAT_KEY = "event_chat" +EVENT_THREAD_ID_KEY = "event_thread_id" + + +@dataclass(frozen=True) +class EventContext: + chat: Optional[Chat] = None + user: Optional[User] = None + thread_id: Optional[int] = None + business_connection_id: Optional[str] = None + + @property + def user_id(self) -> Optional[int]: + return self.user.id if self.user else None + + @property + def chat_id(self) -> Optional[int]: + return self.chat.id if self.chat else None + + +class UserContextMiddleware(BaseMiddleware): + async def __call__( + self, + handler: Callable[[TelegramObject, Dict[str, Any]], Awaitable[Any]], + event: TelegramObject, + data: Dict[str, Any], + ) -> Any: + if not isinstance(event, Update): + raise RuntimeError("UserContextMiddleware got an unexpected event type!") + event_context = data[EVENT_CONTEXT_KEY] = self.resolve_event_context(event=event) + + # Backward compatibility + if event_context.user is not None: + data[EVENT_FROM_USER_KEY] = event_context.user + if event_context.chat is not None: + data[EVENT_CHAT_KEY] = event_context.chat + if event_context.thread_id is not None: + data[EVENT_THREAD_ID_KEY] = event_context.thread_id + + return await handler(event, data) + + @classmethod + def resolve_event_context(cls, event: Update) -> EventContext: + """ + Resolve chat and user instance from Update object + """ + if event.message: + return EventContext( + chat=event.message.chat, + user=event.message.from_user, + thread_id=( + event.message.message_thread_id if event.message.is_topic_message else None + ), + ) + if event.edited_message: + return EventContext( + chat=event.edited_message.chat, + user=event.edited_message.from_user, + thread_id=( + event.edited_message.message_thread_id + if event.edited_message.is_topic_message + else None + ), + ) + if event.channel_post: + return EventContext(chat=event.channel_post.chat) + if event.edited_channel_post: + return EventContext(chat=event.edited_channel_post.chat) + if event.inline_query: + return EventContext(user=event.inline_query.from_user) + if event.chosen_inline_result: + return EventContext(user=event.chosen_inline_result.from_user) + if event.callback_query: + callback_query_message = event.callback_query.message + if callback_query_message: + return EventContext( + chat=callback_query_message.chat, + user=event.callback_query.from_user, + thread_id=( + callback_query_message.message_thread_id + if not isinstance(callback_query_message, InaccessibleMessage) + and callback_query_message.is_topic_message + else None + ), + business_connection_id=( + callback_query_message.business_connection_id + if not isinstance(callback_query_message, InaccessibleMessage) + else None + ), + ) + return EventContext(user=event.callback_query.from_user) + if event.shipping_query: + return EventContext(user=event.shipping_query.from_user) + if event.pre_checkout_query: + return EventContext(user=event.pre_checkout_query.from_user) + if event.poll_answer: + return EventContext( + chat=event.poll_answer.voter_chat, + user=event.poll_answer.user, + ) + if event.my_chat_member: + return EventContext( + chat=event.my_chat_member.chat, user=event.my_chat_member.from_user + ) + if event.chat_member: + return EventContext(chat=event.chat_member.chat, user=event.chat_member.from_user) + if event.chat_join_request: + return EventContext( + chat=event.chat_join_request.chat, user=event.chat_join_request.from_user + ) + if event.message_reaction: + return EventContext( + chat=event.message_reaction.chat, + user=event.message_reaction.user, + ) + if event.message_reaction_count: + return EventContext(chat=event.message_reaction_count.chat) + if event.chat_boost: + # We only check the premium source, because only it has a sender user, + # other sources have a user, but it is not the sender, but the recipient + if isinstance(event.chat_boost.boost.source, ChatBoostSourcePremium): + return EventContext( + chat=event.chat_boost.chat, + user=event.chat_boost.boost.source.user, + ) + + return EventContext(chat=event.chat_boost.chat) + if event.removed_chat_boost: + return EventContext(chat=event.removed_chat_boost.chat) + if event.deleted_business_messages: + return EventContext( + chat=event.deleted_business_messages.chat, + business_connection_id=event.deleted_business_messages.business_connection_id, + ) + if event.business_connection: + return EventContext( + user=event.business_connection.user, + business_connection_id=event.business_connection.id, + ) + if event.business_message: + return EventContext( + chat=event.business_message.chat, + user=event.business_message.from_user, + thread_id=( + event.business_message.message_thread_id + if event.business_message.is_topic_message + else None + ), + business_connection_id=event.business_message.business_connection_id, + ) + if event.edited_business_message: + return EventContext( + chat=event.edited_business_message.chat, + user=event.edited_business_message.from_user, + thread_id=( + event.edited_business_message.message_thread_id + if event.edited_business_message.is_topic_message + else None + ), + business_connection_id=event.edited_business_message.business_connection_id, + ) + return EventContext() diff --git a/env/Lib/site-packages/aiogram/dispatcher/router.py b/env/Lib/site-packages/aiogram/dispatcher/router.py new file mode 100644 index 0000000..400c1c0 --- /dev/null +++ b/env/Lib/site-packages/aiogram/dispatcher/router.py @@ -0,0 +1,271 @@ +from __future__ import annotations + +from typing import Any, Dict, Final, Generator, List, Optional, Set + +from ..types import TelegramObject +from .event.bases import REJECTED, UNHANDLED +from .event.event import EventObserver +from .event.telegram import TelegramEventObserver + +INTERNAL_UPDATE_TYPES: Final[frozenset[str]] = frozenset({"update", "error"}) + + +class Router: + """ + Router can route update, and it nested update types like messages, callback query, + polls and all other event types. + + Event handlers can be registered in observer by two ways: + + - By observer method - :obj:`router..register(handler, )` + - By decorator - :obj:`@router.()` + """ + + def __init__(self, *, name: Optional[str] = None) -> None: + """ + :param name: Optional router name, can be useful for debugging + """ + + self.name = name or hex(id(self)) + + self._parent_router: Optional[Router] = None + self.sub_routers: List[Router] = [] + + # Observers + self.message = TelegramEventObserver(router=self, event_name="message") + self.edited_message = TelegramEventObserver(router=self, event_name="edited_message") + self.channel_post = TelegramEventObserver(router=self, event_name="channel_post") + self.edited_channel_post = TelegramEventObserver( + router=self, event_name="edited_channel_post" + ) + self.inline_query = TelegramEventObserver(router=self, event_name="inline_query") + self.chosen_inline_result = TelegramEventObserver( + router=self, event_name="chosen_inline_result" + ) + self.callback_query = TelegramEventObserver(router=self, event_name="callback_query") + self.shipping_query = TelegramEventObserver(router=self, event_name="shipping_query") + self.pre_checkout_query = TelegramEventObserver( + router=self, event_name="pre_checkout_query" + ) + self.poll = TelegramEventObserver(router=self, event_name="poll") + self.poll_answer = TelegramEventObserver(router=self, event_name="poll_answer") + self.my_chat_member = TelegramEventObserver(router=self, event_name="my_chat_member") + self.chat_member = TelegramEventObserver(router=self, event_name="chat_member") + self.chat_join_request = TelegramEventObserver(router=self, event_name="chat_join_request") + self.message_reaction = TelegramEventObserver(router=self, event_name="message_reaction") + self.message_reaction_count = TelegramEventObserver( + router=self, event_name="message_reaction_count" + ) + self.chat_boost = TelegramEventObserver(router=self, event_name="chat_boost") + self.removed_chat_boost = TelegramEventObserver( + router=self, event_name="removed_chat_boost" + ) + self.deleted_business_messages = TelegramEventObserver( + router=self, event_name="deleted_business_messages" + ) + self.business_connection = TelegramEventObserver( + router=self, event_name="business_connection" + ) + self.edited_business_message = TelegramEventObserver( + router=self, event_name="edited_business_message" + ) + self.business_message = TelegramEventObserver(router=self, event_name="business_message") + + self.errors = self.error = TelegramEventObserver(router=self, event_name="error") + + self.startup = EventObserver() + self.shutdown = EventObserver() + + self.observers: Dict[str, TelegramEventObserver] = { + "message": self.message, + "edited_message": self.edited_message, + "channel_post": self.channel_post, + "edited_channel_post": self.edited_channel_post, + "inline_query": self.inline_query, + "chosen_inline_result": self.chosen_inline_result, + "callback_query": self.callback_query, + "shipping_query": self.shipping_query, + "pre_checkout_query": self.pre_checkout_query, + "poll": self.poll, + "poll_answer": self.poll_answer, + "my_chat_member": self.my_chat_member, + "chat_member": self.chat_member, + "chat_join_request": self.chat_join_request, + "message_reaction": self.message_reaction, + "message_reaction_count": self.message_reaction_count, + "chat_boost": self.chat_boost, + "removed_chat_boost": self.removed_chat_boost, + "deleted_business_messages": self.deleted_business_messages, + "business_connection": self.business_connection, + "edited_business_message": self.edited_business_message, + "business_message": self.business_message, + "error": self.errors, + } + + def __str__(self) -> str: + return f"{type(self).__name__} {self.name!r}" + + def __repr__(self) -> str: + return f"<{self}>" + + def resolve_used_update_types(self, skip_events: Optional[Set[str]] = None) -> List[str]: + """ + Resolve registered event names + + Is useful for getting updates only for registered event types. + + :param skip_events: skip specified event names + :return: set of registered names + """ + handlers_in_use: Set[str] = set() + if skip_events is None: + skip_events = set() + skip_events = {*skip_events, *INTERNAL_UPDATE_TYPES} + + for router in self.chain_tail: + for update_name, observer in router.observers.items(): + if observer.handlers and update_name not in skip_events: + handlers_in_use.add(update_name) + + return list(sorted(handlers_in_use)) # NOQA: C413 + + async def propagate_event(self, update_type: str, event: TelegramObject, **kwargs: Any) -> Any: + kwargs.update(event_router=self) + observer = self.observers.get(update_type) + + async def _wrapped(telegram_event: TelegramObject, **data: Any) -> Any: + return await self._propagate_event( + observer=observer, update_type=update_type, event=telegram_event, **data + ) + + if observer: + return await observer.wrap_outer_middleware(_wrapped, event=event, data=kwargs) + return await _wrapped(event, **kwargs) + + async def _propagate_event( + self, + observer: Optional[TelegramEventObserver], + update_type: str, + event: TelegramObject, + **kwargs: Any, + ) -> Any: + response = UNHANDLED + if observer: + # Check globally defined filters before any other handler will be checked. + # This check is placed here instead of `trigger` method to add possibility + # to pass context to handlers from global filters. + result, data = await observer.check_root_filters(event, **kwargs) + if not result: + return UNHANDLED + kwargs.update(data) + + response = await observer.trigger(event, **kwargs) + if response is REJECTED: # pragma: no cover + # Possible only if some handler returns REJECTED + return UNHANDLED + if response is not UNHANDLED: + return response + + for router in self.sub_routers: + response = await router.propagate_event(update_type=update_type, event=event, **kwargs) + if response is not UNHANDLED: + break + + return response + + @property + def chain_head(self) -> Generator[Router, None, None]: + router: Optional[Router] = self + while router: + yield router + router = router.parent_router + + @property + def chain_tail(self) -> Generator[Router, None, None]: + yield self + for router in self.sub_routers: + yield from router.chain_tail + + @property + def parent_router(self) -> Optional[Router]: + return self._parent_router + + @parent_router.setter + def parent_router(self, router: Router) -> None: + """ + Internal property setter of parent router fot this router. + Do not use this method in own code. + All routers should be included via `include_router` method. + + Self- and circular- referencing are not allowed here + + :param router: + """ + if not isinstance(router, Router): + raise ValueError(f"router should be instance of Router not {type(router).__name__!r}") + if self._parent_router: + raise RuntimeError(f"Router is already attached to {self._parent_router!r}") + if self == router: + raise RuntimeError("Self-referencing routers is not allowed") + + parent: Optional[Router] = router + while parent is not None: + if parent == self: + raise RuntimeError("Circular referencing of Router is not allowed") + + parent = parent.parent_router + + self._parent_router = router + router.sub_routers.append(self) + + def include_routers(self, *routers: Router) -> None: + """ + Attach multiple routers. + + :param routers: + :return: + """ + if not routers: + raise ValueError("At least one router must be provided") + for router in routers: + self.include_router(router) + + def include_router(self, router: Router) -> Router: + """ + Attach another router. + + :param router: + :return: + """ + if not isinstance(router, Router): + raise ValueError( + f"router should be instance of Router not {type(router).__class__.__name__}" + ) + router.parent_router = self + return router + + async def emit_startup(self, *args: Any, **kwargs: Any) -> None: + """ + Recursively call startup callbacks + + :param args: + :param kwargs: + :return: + """ + kwargs.update(router=self) + await self.startup.trigger(*args, **kwargs) + for router in self.sub_routers: + await router.emit_startup(*args, **kwargs) + + async def emit_shutdown(self, *args: Any, **kwargs: Any) -> None: + """ + Recursively call shutdown callbacks to graceful shutdown + + :param args: + :param kwargs: + :return: + """ + kwargs.update(router=self) + await self.shutdown.trigger(*args, **kwargs) + for router in self.sub_routers: + await router.emit_shutdown(*args, **kwargs) diff --git a/env/Lib/site-packages/aiogram/enums/__init__.py b/env/Lib/site-packages/aiogram/enums/__init__.py new file mode 100644 index 0000000..f8c4532 --- /dev/null +++ b/env/Lib/site-packages/aiogram/enums/__init__.py @@ -0,0 +1,59 @@ +from .bot_command_scope_type import BotCommandScopeType +from .chat_action import ChatAction +from .chat_boost_source_type import ChatBoostSourceType +from .chat_member_status import ChatMemberStatus +from .chat_type import ChatType +from .content_type import ContentType +from .currency import Currency +from .dice_emoji import DiceEmoji +from .encrypted_passport_element import EncryptedPassportElement +from .inline_query_result_type import InlineQueryResultType +from .input_media_type import InputMediaType +from .input_paid_media_type import InputPaidMediaType +from .keyboard_button_poll_type_type import KeyboardButtonPollTypeType +from .mask_position_point import MaskPositionPoint +from .menu_button_type import MenuButtonType +from .message_entity_type import MessageEntityType +from .message_origin_type import MessageOriginType +from .paid_media_type import PaidMediaType +from .parse_mode import ParseMode +from .passport_element_error_type import PassportElementErrorType +from .poll_type import PollType +from .reaction_type_type import ReactionTypeType +from .revenue_withdrawal_state_type import RevenueWithdrawalStateType +from .sticker_format import StickerFormat +from .sticker_type import StickerType +from .topic_icon_color import TopicIconColor +from .transaction_partner_type import TransactionPartnerType +from .update_type import UpdateType + +__all__ = ( + "BotCommandScopeType", + "ChatAction", + "ChatBoostSourceType", + "ChatMemberStatus", + "ChatType", + "ContentType", + "Currency", + "DiceEmoji", + "EncryptedPassportElement", + "InlineQueryResultType", + "InputMediaType", + "InputPaidMediaType", + "KeyboardButtonPollTypeType", + "MaskPositionPoint", + "MenuButtonType", + "MessageEntityType", + "MessageOriginType", + "PaidMediaType", + "ParseMode", + "PassportElementErrorType", + "PollType", + "ReactionTypeType", + "RevenueWithdrawalStateType", + "StickerFormat", + "StickerType", + "TopicIconColor", + "TransactionPartnerType", + "UpdateType", +) diff --git a/env/Lib/site-packages/aiogram/enums/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/enums/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..46aed5f41918aec629f427700ecb5df057fc6957 GIT binary patch literal 2410 zcmZuyOK%)S5bpIO-iLR+ey`scV}g@7&I4l}fe<^6WWZo-qe!ilTH~3HGq`(t=$TEl zH~s|&egNVR@GCgXanuJcoVZ2GEhoBaW}S@f-O{ITs;hgts=nI&qh7BP`}ynlzn}dx zM99DJ(EIe|Z_Q!L6Qx`cdGyeF6GGV(F;zFeUz$j8M8a+R(kpAa9)>-0ME zN%4_fqie{g#0`0q-b6kvZpn4Jj=Uvq%MH4Ld`8@ncj;Z^v*Mn-Pwyk26CcY>x`}*V zd?L5#mgNidQ*ZHztS$X#>r2*3W_(-4J4#9?@Qz#+^5bsEt-HGO+=(B#v9AIMf~Rez zqWDO4wA%}6f_tCK6RwY9C+&DP?;P~FV z-q~+?_e43`+wR1%3J#PI5TEZE-FKq10~Ps@>4Ea`osE4Sbh7aCFdjwDDc=oZKki;| z{-FI+KggZ+i|?--I6C6{%7e1DE+n|CwbJ>{a_?$3u6f8EEIzE|>$8Xag}oPl>c`JL z?YwjZ6uq}vKZ0ch6P9juJ}SfT?5c1X1=Hd&fB7y_-~j z3ccRR^Sa*(MGpWB0$c;IV@q@ypaKB%tZM+n0Cj){zz9GSU=&~sU>slqU=m;oU>cwW zFat0PFb6OXumG@V;rq4E%+!gBnVTt=MIc!g+alpLP0h9HV_8mkXETMK6VNV;P`p_< z_{-SwS-nipFx7S*!F+)GW+Z z&3GnjER|{bsBHENNSkTYc6L4#(KLO~H}BLTk&T{K_}m?D4c+71=?#y zF5VCNZK@%R0+V(Yu=i%}Vr3YIfyfR5VVKH!3aAk?rt`tTm@E)L!hG9wt28?;C_~eV-wurJDNamw0}!aGb#Q7j z52)1)G3M9?us_Lb`$*n=^Z4`jQ>D+^JIeEe)Am_MJF!jID!R>s7wzx-leTROUk@Gk z%>LR$ZO2!q+L0T!F*4d<%n$sSvD;zyP5FT>V@L3>^h0|z{Fp~&`{((pzf>xvWGg9J zN>-AhT@`aDAq7jxQc|>(tR_WE$zoEplq@GjOUc(s(Ngk7QnZxZN{W_}&7^24d6E<@ zCHIn|U3Jdon9H6U2`SiBSv*Qe!LF)Lp@6oYDcMbmmXfukXjfJBay1?#q+pkO`f6aI O*7xfWeD#-B5&r`hdGTie literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/enums/__pycache__/bot_command_scope_type.cpython-311.pyc b/env/Lib/site-packages/aiogram/enums/__pycache__/bot_command_scope_type.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..925763458f076751aac07e2758fea2c1df42ded9 GIT binary patch literal 946 zcmZuv&u`N(6n5J5$J$NPn8wBs5NQWgAzE%o6GC)r858X`wHZuNB+HGxHY}-w?GBAo z4_rBK5_b^d&R@Zy$H)>VPTY#dX(#NoLqhC1d4B#r`+LcI{xmmN0Ls38_;&c+0N{sS zTv~P-oIg;(DZl_50SFDpFhB}y0i1dVaGIou@zDg}i+U&Kq_NosrOZ#gEE&?Q_XnXj zC6h@dO6rc*$GV_@KsFKiub{|ZQ^BQ>PLUj!IZO`G zAP{l^1p$nhe~biyUJnT_=QY%2bP!E}WesQ!A{_dCp9_WrWn7vXl#5qU#RLpV*dc7E zRFruL`zRz3$^wKT#e+b{vk<->pkT`6AjH&DaIRK=THSBha-rI2z`fS?i>h6Ro6o9t zTh41}tF^noHwBh8pgCBrHMe)R+jgsJ@3z{~)Sz6viYg{xv)Ui8<&zhB~zOE16W!?GOcV1bdi5FDf(k}OD**U=S}6tX~QsL cur&Jj8E5AVYYhH(XKQETm&SizK_=<`0Mncn&Hw-a literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/enums/__pycache__/chat_action.cpython-311.pyc b/env/Lib/site-packages/aiogram/enums/__pycache__/chat_action.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ccea966c21305584c247d84e757588c45050f223 GIT binary patch literal 1446 zcmZuxy>A;g6zA#7iXzD{QU@J6FbRUfsBLvNiU7t*Nrc)u!v7%pQCBMST{syb~Rkq>ZV^zP#?)mpw&9Afj zeuLHhCTl>LrmndostyAciikP|glZU8e-tKIT)g6e!ji|5Cp=OKz7PsiOHKA`mgtUz zNH`V|-^Gl_JYr!q1c+aQSFA=HrwNxBywMAh!j1rc0S~YFLFQl&tGBWF=2A$k_#1^M zJW1$~C%ZPl9!}%2pp3*L0UsNd)s|*(CnO`+A>#srHK%9T(5-fdF2VrPUePVKbgM-| z-N}H7Ae}%TY!X8raY@JcG90gnf$auKR2W=A)y7?}FXLZ^5hG&}P}6YBSOP{BT@<}u z6*0-I=W0sLHkb8bn{YmqGm*-GAK;NvadOaVL4)|d;$uFPbh0nxumyumS~L!yz+71X zqspdgJFY9)M09<<^SZvC($Z#|yRwv#0ldN8~72f8r_`_pmzVDO`mR|8j=!!)=`B~?NanAw0w*Mp<* zVvvN2@5MB@G6!WqLt!S{;&4+WEi+D%&2v9~E6d>13Uk9G=OCub-@LF{uFjDWk5TjC z^!e<;qv_FS#lx?s-fa8nv^V?W$@F;kZ#*Jvozf1<^OjoA>6u-|ywU$;a*OI#BZE{nv2=0`Ofs7gF9B z>)XmW1q2W{0}*r~1P15Mw-DDP))8oyerUG|Gpie?k-rJ%n<|vc z`li}W0R=83z%>X|P{Xx|>6VD)mPtv`l(Q?H36}R56Y_|q+^55NLf^ct+e(I$P}pqr zlKRr-G~raxSPC24QsvleZ2Jmok2Ka6Ik;8Nfdy0Bo=BO9w&VDW)0U(&8gLx77!RBg zlfuDCxTh&{hJql6XBAZ|3eza71>smCpAni>gYbmn*LZ%|tYlS$VjNL~vN}Q$Bk4@r zTL`^M@oW>RAViq2jw_F!bO-&XgRIu;-yfpRql0c%?e(8^_mB5qd;)7dtn=pwZSR=z zsn=m7j010)ax57~>O(ympLh?$ktae)Zzb5D;(!VdhfKHQP&I$y=sr}k8U-pkL3&87 zWX?;9K3Dn*MN_H8pS3cqQgsEi+5$UQ7ro`~jYWUCb8YcJFMjC)d)TxxOIPBiI?7BT zc|p9ZGxD^{$~v#!DW-9kHnrfDI@>#wKlS;q{{-`L FzX2f<$&mm6 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/enums/__pycache__/chat_member_status.cpython-311.pyc b/env/Lib/site-packages/aiogram/enums/__pycache__/chat_member_status.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..56fc5f05420b3550a496437187110ff308fdb79c GIT binary patch literal 793 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 DcjDp~ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/enums/__pycache__/currency.cpython-311.pyc b/env/Lib/site-packages/aiogram/enums/__pycache__/currency.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e09e3c099765642d0f2be45c396c6c8a4282a06d GIT binary patch literal 2262 zcmeIzJ5w816bJBKBtQr-FN1Bswrrj<5BZ6WjIs4tR?n4KNeG>2W+QYqgcuN6Ntq#& zf+9uAbS~1zlS!Y?kRnA&kJ?n}$T*d&oWGDglbPfLWF{-|(>?c`J$t2qlU3qz>u)^x0a-@=~DqV`MaM#xgyX-Do{obu8Kg!?5K`wUZ z6o2>c2>oiytsOUys-0x}MePJ{Ka8=!au0d9m-^U4 zUhboQ_R;|N(;yGfB_5<9zC^=3L?b**qdY=mJW7{&jK=vgP4GBf;R(9RSLhmFrAfX< zQ#?u2JVn=enr`rQy2&@l$2aK~`{*{`q8YwTvphp{JWKODM+-bpi@ZR7UZgwhrzO5a z%e+J@yiBXSLIGZ-yBwfMwoXqSsr;$68VrIshsbR7G*div#8UY{JD@W8J7 z>dljrn$xh^w|DBx+lThPQ#ta5YYks08~3)WbG4>ZwS&G-8;z5CFc7HL9DB9VDP65O z`+>b$qaHY^oF3W7jrz=omMhhZ%gS}yjasgd78SM(A(ax+2+f>Oz=$Lf4yA=?UeFO5 zk_czQf+=T&OEMP;$y_A1C8V-~Q4%s3nGu1KEmt%NFc&2$)^r(ZdFi4R%$7?JOQ>to zPtR|+T(P8-#0&{zrkoZlNauJ|>f$L`THL@WCy4}>o5;%5lA0uvIxvd@$#PR@no3G> z8tY3(rC-{RL>iY&?|@xdeY%7Z-l~B&Xv8x@M%o)$Nf=meHY6*}YLd;yq-hpSvnhln zz2({tNoZyyG;>mH7Nj_bxtu0la=OgrV=|Xd$olf8EH|IWToI7W6+$sV-xbiHP$~#W z?BK&LY0`>9rs1cS$FhzqN490Pyq0xTBjE?-t*E?9M1$pG&3Rdl)cD|dzx=Z4 zR2ntMlAm#% ze~gND*`AEvc{VP#i%rLtP`(OE9bd(Bm#V67l<{Bx{ygs~tLpH%^3Q%#|2FzZJNM_m IRJ1Sr7n@jS#Q*>R literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/enums/__pycache__/dice_emoji.cpython-311.pyc b/env/Lib/site-packages/aiogram/enums/__pycache__/dice_emoji.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f44f8960a913ff01e0898776fe2d8878ca46241a GIT binary patch literal 772 zcmZuv&x_MQ6rM@apLW%*Tf|$yQw1B3Qbg!4yVYz9wy+QaLz)@e*d|jaiHn|c@T_}V z(1SNcJSYm@{0}^MEII1QTcn=$78v zvKz9x#>ol50K++Op#dR~Ko?-?3BWRu2z;dg@Rq-8Gi0m`K{fM3xK$V{9WQk4jhJq{ zP-?3yd^-UI7!U(P!jNB;3ey2?m=YE95Kb69QZ3JMt-#^3OEDB{VeS7|StGwTmkNs*f&LiYmE~9E;bv(JDpLpq3dz})?lz^rJ+6;p@T+i zzt``?x#r+d@AbQHz)FntRBzYKL&|1mi(s0cD8yV-oM7sXJrScLH*CVc9cl zLVVM5sOVZF{44pIXcrMN;M(F5%kY#bh~E9{9HKufk(5k60Rl>(v>UaTXUZJP7o*$D zb9>SL^1`J^U!L8Ix?-{NHdVi>#EK}!#MENh57@fSc@dF@?Q(XSzp&qf|UgP3&-;D=%+aU^&c@U_Z!l<&^`bF literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/enums/__pycache__/encrypted_passport_element.cpython-311.pyc b/env/Lib/site-packages/aiogram/enums/__pycache__/encrypted_passport_element.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0f12c3b0db9c476447f1b8b57c98ecac06549184 GIT binary patch literal 1197 zcmZuw&5zqe6dxzfCQY4eR=a7p2qdFYq!h71LR?k|$-5c07Kt~qT~J4nrjBQtHS5@B zW>P7fa^T9jNL)C95O>b}0UUCS=E{j%&~oaDalWJ#ePchruiu;JH*bEa)v7?z??3+e z;*SCVf91-S_BO)JM@o1F2q0Pv#v0NzPyiQz6utwbNDEZ^SqI=Z^{xpOiSB_`>F-=^ zX;O#DWE^gstB*O13B3E4Cgl=K76vy=%K(=koNx8GMyMgCR9&2;!R4TZ^Q z#wb@lZi;C}&Gdyyw`eolz)iZwpHx?PFP*TEo|;!eWc;+<4pT-?go+ulV0@CYQG1vQ z-VUc9I zQ6ebIp*uu5AVmEOm&QayaUMC0;#k&)L2`|`2*j!fvcXgyg$qWEt}V@N3e4yz;(`St zN)vfc0aWt>Hoa{(va2+qSe@mNGFhTyRk_nTkQI!RU`#QVRgA|enZ&tlVEoM_h&P@x z#v~1uxzUHNcj;JN+=0GjcRg9@Tb|dybbVRxxb~OO#a;UxIv$iYy8|8H_MhQ%%k9Vm z+wq~BLwAU>)#@%86UiIPHX;6cB>v0Eb_l7;E;VuD}z)g~7Ko8+V!us^)}4l2H$D zH&4@al5Drz9-(+M#Ub{o8*LKmw~tAhwB1Q?yVxV&VzGnBz*ILw0bx2KUKZgvWwIZf zuu3$+{+1)4IyogNVOo*~-WXG+o(BjMK9Rt~Omivsha7k$PF*i$itk34=^^plG$1i2 z;yA;D)+*B-C+0E7VO7V82+Bf%YmRf4x#1$BISxMwcdMPFu4Oa5Ya2&>b1-Cb&)Q*? z{=V7Uas*WOckQ9gw8NogJT?!Q`qb*0HlJ+EFqzgl;Ql=h40|x_7(=G?I(?Jrd$!RT zTK0ew&B2lR9$bm0Uc>J8=oz8okwH)p`=fD2-IP#=mv4mQ^U+>#JW7HT-=DbN*!6KT zaswiY+~&87l6FyDeiPmyr>L)!^6qU;E~v^A|8?+Rrh|^J-yO^A$v^dHg z!N_U%IJ(v!7QJ{xTig_{Jn3^amnBJ>fsN09fAjL1v_1#_s#nIF_3y&}<3GVX-A@Md B7MlP7 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/enums/__pycache__/input_media_type.cpython-311.pyc b/env/Lib/site-packages/aiogram/enums/__pycache__/input_media_type.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..47e46d27bfb234682b2b241c3b6eadd780cd87cb GIT binary patch literal 745 zcmZuv&5P4O6ragQo7S!(?g|SY0xLofZUt{egt9Gez&2vL3L!A0nXw()Wa4D9u%3GG z5Ae2vcSXGWS9tJP=IY5?rJnZWOxhJh-%Q@TkKcQ5-kW^f*{K6XU*3OxaR34Mu9Zuw zY=!kbC7c5cFr0$~1`q-RJObEw1F%U90zX&)d{*Cv0ux(9(6oPOwF#xwON%7lI?F>9 zDrtR39p`|60Adgr7^+Ysu&^1}*a|Ax4yw2kIJm0PIr6HPW`*bzOrz0RMqbbBuAC`LqXT`E^9R!IoOC^3I$i(hq~9Bir2XXBANkUL=5>4i zC$QFIyLj4dhtCc!K7UUD$&If$1w*n({e4HlM#VX`w##$ee-)?zj^cKL#NY1AfMlTIr#m=$TV3Dz6l7^?>W zE)Yi%W+-wPhEgZ;m>c$m;(pcTGJ`-w`z(bS*U~$f|)V79)w{c74I9q;8R7@zEsn2 zB8?7dE*=WohNY+(>*~_aXVS>hKNXD2gI=R-5|YuB6H>MaNhK>57Pkp`UC_lQa*Gfq z6L9;7yQA@_^k44n3`ZZ)%8umvcxMnFOEr(TB@@{+o)?N5sR;BD^XxQ!AttdFhCj|} zGKY)kme|8 zIkZdNxhXs7d8KF1P%gMiR~xnFylpe;w7Y<=n@`vGex|x$+IQCbpeh$*e1-0R{rjsL WO}tg1f7NC8lKrs$pZ^Kg$NdK6YP|&j literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/enums/__pycache__/keyboard_button_poll_type_type.cpython-311.pyc b/env/Lib/site-packages/aiogram/enums/__pycache__/keyboard_button_poll_type_type.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..616b2359aad31c77cdc5d8ff8446e757e0ee3e36 GIT binary patch literal 783 zcmZuv&2Q5%6t~m#Lsd5r69VmI2`-hO;anjkpi_ky6YN7sQ6%HUZ*6EAXST!CoqFJZ z*n!JVAjF;j0f__0DOXP1ipFUt?4(6P@EkwC=lAjZ+0KWxwKg*H`Q6vU0Y>P%bym_? z8W;DBaf&$NI6+hFV~iX$MBI6ccnuuD?_GpGnOTWnd5@|s_-S`?d4VHOG|`J-HGkvmg#H6w$5y!xZ79<1`NnqM|Eak)&nmkB}9-D}e zrdK9X9;YJ`mhiUTA}HX!c8R_xav4FNjJ3{G-}6ir^fV+el5E-&a^!_VE01OIt;zBv zRV&NNaxA+P?ol3}6io@EJYjOD+bCL;rfdq77HvwWg6D~~JCq*fELldHlyVW7ZTH2& z6TfKgZVeB%AMSoc7xs29Uk&=fOCcx0V`0w_OmfMzkkl{=Abk^T$6=si4Rva(NK^2OD!pZ`kN7R}?RRpQD)2wJlJQqGYv;ry9?9jG- zE?7shh|L6vJ6z1{3745o((s<5NjE#GYD;qp*#RT8)Y%2gN+agE3`*S(!erPsOVjfb z5;M;$o1PbQnnwz^JnvObqD`dXd6fI$HXoln@AZ3+x-hqwy-{flPR_>tQa|oL9ezS9 zHMi@t?xFjFi@AHuX_(C1c`k_L!h=1!EID_dg%cM>#qOuXpOYEOToQ715}UzQWVSkj zw><*@7-uKF5C(8pN?m2v0ag5YmNnflmq@7=x_P(gFK+A>-9>A^=vAob7G1HwB^b7K zm<99_8n{X=lVZ)jr!uOvTY#?3hwE`1i92Ab-y$1;T51^M1-kw1?{`^m;=LvMS6yjW Np#J&-EZ4^%tZhI literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/enums/__pycache__/menu_button_type.cpython-311.pyc b/env/Lib/site-packages/aiogram/enums/__pycache__/menu_button_type.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3c9d400f090303c48c811e1f032814ddadd1508f GIT binary patch literal 712 zcmZuuy^qr{6t|PK3Dtc7(ure1kznaS!(1Vx-nEqBT28d+q$rZ*#=c&zO&n|oRHhF6 z0c?lF4npkw6%34(S0=WiGTnro_K*-f+t2Uo_nzPL$L;MJ(Ddc~*HaGy@ZBg^RNV-x z2U@rQ1Q0j{DGVV57U%+Ey#d6g7KI-i06y!prqCwN0Msi#j9Q1v>10J3Z=B_&3zf9G zqpu46DH+P8*DmgAtP=z#p(;%5X{%QZZEaGvkbIr^x``;mZffb$d$^v$ qBfh6q^X;Oi+0up(F2LTmzxT3w4el?&zwGVc-Myd2{_8)^vfOXYR literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/enums/__pycache__/message_entity_type.cpython-311.pyc b/env/Lib/site-packages/aiogram/enums/__pycache__/message_entity_type.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fc266ea0416ca9e9bd89864c4aee841b9b570dfe GIT binary patch literal 1203 zcmZux&5zqe6d%Vh|OV|3fQr2O;iU`3E@kXw8)qx1imUEV#fEpdf$(xCFTH9l#uj6)0k90?vwmWagQ` zB-M{SdpDUsgq?Bwn1h#q04QJp3s~UP0+g@_i&%msT!b<%!7`R%1(#tJS6~fSp@M6$ zjum)->+ldCz$1JJ8~6ww;|4sz$M6)Nz$QM0cW{%JafdZ@5{A}-sD9)`H|EWnyojqU zF6Pn+TXg=E*ikDW>wtvBkHS{OBUoHC(tV3Uj1GK$vWMZ0a&fSgCf zC5yoF&S|h{&uJ94t+jK1N8hot^_c8s7WJ9Dw8CX%EtqWYK#lW|O+C-@F%#p!Wkupy zj?0wwlKKSkPdFz5ljhXLtmH(N>)5Ok`$B3(>}bOtt4v3Ib*v3XDyvV-@$gDD2V-M; zIbibS+8An_Q0;0)@9OKRVXCaDKDy@VJ6%mhZ@HzO(N~#xJyu!8R3Dj$C%j@x4)+Bs zz3Id>bfoIW!{JZhHf!8B)BeTm8yc);J&GNFF$mguO;F^ybCsQ>@C8@NKVwsniscQ+lmZUlNiNfa zyL)x~L2{K=50hT1oFr;`@?oN-wMNoU>&@h=^yuAWn4aEG^evg1cc^1PEYI%g&UWE~_$|_!sRUuVP@1Jm`f*F4kO6F6}h+G`X6W0A{{_nmo`rK<0`p^&_n@g<+hAnpk{bEhIxZjeUz zcY$TDB3P4LajBd0h%uhfLLlKh$aD=bN%(Tqt?N3aNf2{Nb%WAauzYFw7NxKAV7ar@ zC}ko9H8~v*U+Cu1)4^akqJ=;Xj-E_(4RACX9)ChxGpwuALEnEVY>e?5-TwCX-c%d-&IbJpm-gl4r_ulVkFhBC8?ji(*#H0l literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/enums/__pycache__/paid_media_type.cpython-311.pyc b/env/Lib/site-packages/aiogram/enums/__pycache__/paid_media_type.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..433b4a3a5bd49b0ea593cf29f00631a6ecc4b652 GIT binary patch literal 708 zcmZuuy>AmS6u0jq2~mRhNX3RuV#+{{IYKP$sZ^p(piwKGPO>g%H#w3!AGQ-zrXcYL zuoa0NgxL8j7#Jh3Ol(16>csOUMMCgwKfll4dw%}dY}OIbm-k=KT#V3nqg+vCE36-Y zaDgbIc#1L{VvH=bkErzqQJYx|e{c}`3}-{3O`T)Zc7GVPjkOcxvn<&<%L@vXw7v`1 z1!5?~6onSWkZOevwL_OWVTHN?Q_;9P^n-Sl1gXRmiUICtR?OVpBE}an|8t zKY+=oH0Ulosf*v+0@7lLSD?` z>DE&vgz^N;ZvSy_(9_lav*6?)IMwdS!Cuh&gw|#_mrwV)(J2>`XqVG8A4QXyh!qzE znu=IHkDjE%NT!P2FXChZuaZ%ma?`rcVBXRuOB{P2|+rSoo*2;3+ z+6o!gK+V=7SYE%g*k3koF9Nf~&8ys_wxb{V`bNu;x@7Z7coh-&ER@Q0B z;RzD$U1TUZ|Ak(re-e zyc7xRcV8$~$bJwcT(F*EQ#KYP>v1s-j=7QnDbiaf7ZSTG38P$jArTYGU+2&7RPKsb zXzwr_j{LRC#W*J!!?^M=&NwZnhHqm0vLw?svxYI{i4Jds_n++#o*a#EBi1^?)ir+t z3)6!0;h-NMaWRP>aH`9RC#4{Y3#{)Mv;0*&OpjxkDz;mYWJ1PF#w6vYnt(W%L8xuP)$i%5ateiMZ2&r0AR4Col6p*4ID~sJOERBQhP8z2k z_CE}X3nvib&R@Y{HzHp-aVr|9ov_muiI3;_=lAt{FM9TeO2q(DKEM4k_^JW$O&JR* z&XtS1QaJ+%AT0tT&DAuJ0}lbpodT4{Ijp_c0r({MOx!%u9Z)NLS7uEUx*d;4!9189 zvQZ`%_vCQ~FmN>l+#J#*HRtLm?-r2m7E!@nLPfWPmfU4jat*ZXmXYC_s4UByVq@QD zEFqNJ5gy@~+msU8KS}WGQ^S(dKMa{g4qoDbTNEc0GnvFJ-%92@3(traR!oaa>b8+l z9Wtf?-mwljPuNbq9uSJRxlA8Yf3!{Luzo-|tNTfKYf)@oD=U@N5IXX?FN^^tF^4Qf zSeO(aW6JQ%Dl!}mLM-$_7-3OR$ixb#e#|1Dha`qsp!&CmiSjsR2@XQZM%`LPlpu`# z5r$A05RM2MM@ly#d^Pr?d1MJfL;~s7n~i=$7_Hu3w-23m(-vmWerER^duA0KyVGjh zLT|M@wkRlc#7e){=sKN7zrELmS)ls2#}VbHU1#6kZA*6ZBe+mkeEFie<2@(z$lE0- zjECOQnEIShDCg(l_}J@&2ObMKzLWUDkw3)D^FyMhT*va&u=--Wa6Vs{4H#y3m7LIm z?2&2=E|F)P&Kh4=8Clv5sa=-t&u0ICZb?%;a`r^RG_Pq| d3f9m6{HDb#nl%Og!W;Ik`9t}C{wJ8V`vsvN8I}M5 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/enums/__pycache__/poll_type.cpython-311.pyc b/env/Lib/site-packages/aiogram/enums/__pycache__/poll_type.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e23f58ee235624b9c40519e2ce78ec38d1f9b7f8 GIT binary patch literal 638 zcmZuuy>HYo6n{>9chS*OK7@prBEfP47v@uigt+R2C>8WWNKqs!7n?L(5~sF<)J``r zFtT-E2O)O;1_lPk$}1CF&@pww&RvlZJljA2-lzTS59{lFF!K4`*B4*R{@p4U(p{0o zJwr}`0!29#C`1Sxm;iNN19h3h(0dH<$*iS>F2#E===`wi0BO8c)%wi{Y0i(7`A z0)r4y2px({suN=BhMi>z?LFmrzJFY?6VmsM>>p;*=hK%gQNCc6V3L(e`jv_Dl?m&& zQG2`=2^;x`N>y?c1PK>xs94TY5f?))(qPJ!4B{%gZ8O^(-4iUW^H^wnRA(nUgRb@n zDdU0>qWgptoYuMJYlIxtalZ2O2%$VN=HBks3uEx&}9)%xaVS7A(JRU{QxtK){ zInBy6n$;p!To7}9#L8FEb~cSR5D4#TM*S z%R2_ qdtY2Ps{Jha#6aUBgwEi`x4&o8_0Y8j{)IR4?f9p)|N4)!J?=L`X{R{= literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/enums/__pycache__/reaction_type_type.cpython-311.pyc b/env/Lib/site-packages/aiogram/enums/__pycache__/reaction_type_type.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3511a4ddc7318f957b336e3dbf004adb0e28ed0a GIT binary patch literal 680 zcmZuuy^qr{6o1Y~sj3!EI#`&($I^j@xk4;=)d_UHlV}lA6v;~CM=#eV4z_dBF?HY% zU^^ss5Mt-AU|>9DWnv2|(@oe(i-h3W{`vPl{cL~i^*W&C%loe{f9U&3e7;cv_|>iS+pF6l3KH%mqr!l+?6|_LL4C zbn4IvFGP$(??kCw4t+o70tX70I2Tbm;9~C2xRQR9C-=7LCcDlpT}=6DQg-7)DxT6> zJLHaW$!Nnrn<1ESM;i3?c;)3d)Ld?#>!(HV%6u+|_=R<8(Km`d9vS7+U%p4&kl(;oju@vWbkdhp!v1LrZ{OD( zCHtdDILY7$Lg{cwIS7cQaHw($q;qlwb%e$`Qh{p)wx47?gr+l+G8IkN4HFIx2@@D{ zI&CC;=nfJoT$)CY)@;{g1y{k6+lMro0L#lM#4L)3c~xX#2*7~#>gBvbNKB_dNM0jk zny_r5?F~ZSWOTC5lnG%;sKWN{^X{J4&dV>oUc1}td9S@b~89g z_&8`Kx>_*KIF$(}>RSVdkAuBv5Qs>^6JKZHjG1tqhIW zk|(s?JdtuC+F_V5PFs@B>6GKF#rQNlW>SQBk={)>#ggXqtRfIpmK4ep5^GN7<2=v_D18*c+gdTXE-?OjQc(1 zJ{$DpZtq#}MZm%A#>o-?@Gx&|m zv%|nqj;X+H?NYXod`o=YWRz*U8eRAY+Xg(~``R@BDvq=&YzW~R?0@}x7Ty)OSAc)j Qo9^4apT_^|Kf$uxZ&AEc?Epdu!8&?y5s<_IBGZ4?1XDmAH)PA6H;*-5T<7az8-s7x6c z7`t^~2O)NT1p{N`m5D7VOr5YVDH4Lm_UrfavG4VL+}^GMjW6%Nj_*PMz8m8j<&Cm> ztd&bZ0D%cep${RjKnD=(Eg&|vDE#06@L8`le497}&?x;dW&SmZrmyKPi^)U{q z%V~mTbVgmt+}G16oED)Ji`W%YmM6p=>8eDhl4h--8L*s(wB=5v%tXucLdI!R(u7Vp zPMeHRyb+Va!&$UvXfh@u8L?SWt16sM@&t3`n3$@ExsWVHG-anzzfndm=eBk!TS&ep zzGX6swA)&{syL)&dBtSuzb;<7MIb|&eN-JQ4}f*vFX z@u-4_7Q8Fs&4b|Ipok|a>(P@JiPTd)=*%V+ioV(X&F_8ed$aG&%bA%15c2lQSO{yiBsD>YV z&cvB+qEISFm&LXZD6k*_R)#?FX~t5CVr7YHOqQB;^|KYSA9mA{n7E5u!0)Yi_P;T^@KiDi_k&7LNmmHnhDc8iWm9@3Ckv z?vx$w=@E5lFTft5VP9m?qZ86`c}K6;m%6l4UvjFLE?=oFR!Oaf@k*DFN(I;I4(={r ztvi*f-kzk<$E7xyOGBOD2&aI=X<`qhrz|^z!9}yWv|v`3)5EdRI}X@`&%Xit^5{Ka z2j3q9_U4&T5&s3YONAtlkdHlzP*On1<0N(^FCug&#_q&3g%IJ6FsrNPO(V(OHcWG8 zH_6@F+A)oGlHF_?#&)7McUnfGG>!FF;7E?+xVhf2cX`ma*EnH*&+f+oj(C7NJhG{O z*EU(l4p~GO2H5H29t~~GxNMkC#e_pW{U;%qKG<)sU62pB04!b33s>GU(o72(_n{0mQ82bX?G`_KP4({g_R4bkig literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/enums/__pycache__/transaction_partner_type.cpython-311.pyc b/env/Lib/site-packages/aiogram/enums/__pycache__/transaction_partner_type.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4067baa9cf03e6af8c56ea3aaeecd960676a872a GIT binary patch literal 764 zcmZuvJ&)5c7`D@-jY>}f%7?@h4weqI$66tziiY0M7SskIMUgBwcH7W44z`1IOcmlk z91;r?2(j}k7#ORpOl(DEx(PdN;Sjt|9>1T@8^6wngM%_q^7-wT@m&bOH*M^txKlPq zN;w4t5I6@5=tBq$&;i7F4M>3+6uvhB_@v&g_yuAPLCyNE%^J*1H%=GfE|_nsQ7)T9 zwVeVAd`N(A5U5HG-y{X!BBoy?mR}-8MODhKc^t5^ov_ zhmD@mP&%9@oC+FC;b2Fq9EXh^`KQ`Rw&nG5UOHqc4{6hxN|}geqY*Mr>ypmtgyTh> z@kwLEq-fwIx^<3Z$B{E+_L$?zLUqh6Ca08VW-1g`_ACe!(XZK=jZlmi6rrq)(1MY4 zuJsB+&r>|#MM?+}7Am*>aM0@X+`gAtkGx}dkeN@03M-!5bvuJr54GCEk6@$6c;>g8 z!BfU(!2?F3coNJ~jwRzreR)9R7eO}~1tOC4PJ+W3o=_3si0Sh+sJa=^ICn6#I~mfG zt0yPiQVnv@*DLA@mcQ59FfDrxG*rOF8_VNWrMh%i7cMQ^tLn{VS1(@O6ZC6lX6lB# zpj=r&NWNvitTXboD@r@F?`>yupI=v|{#8Uz!MXq;T!E`!|9;lRGCW*^f8ovW-R&RR K|MNe=yxlJ+f7ZYN literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/enums/__pycache__/update_type.cpython-311.pyc b/env/Lib/site-packages/aiogram/enums/__pycache__/update_type.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..53f49c2cfbac807122479fbaa950eaa0317a8983 GIT binary patch literal 1599 zcmZuxOK;mo5GEzcb|hKW!?tXvZdepO7)7l1(57&T0J2QjiY3Ywr3P6DSWw)JMVsQX zB$dEDsX%`~E=3N#wa zggYXa6nio@5@YlyCgAD}ls5tukVpiSA|iyQkVMibLnO37GH8)3pe3@1?vW*wCHGK{ zWKo{v&@#!R0$D~Yq=1TK1(iq47l29&hPvwer? zKJ8sN^!p#OGOXUn^kg^M9{IlG?bT`qbLp;6Eqdze<6Y*S)`raYYPw^790x~Hd~r-YPd}x+ zK#A#7g6BAIjC9+k7Iv8D^Gag9Ne(BTX+u0V7`Pg~$!uP{Cg+)|N$efNCV}$8J#Sk) zUQB|qOZ7PK`fUa_o!CClo3;f-;O{2Xz2K|Hh(Y^sLP9Smmd^_Y^lhjc=ZROr8<~z{ z+NTLFL({P_qQ*I!_z5RD%(8eclvuaDSJdT&@dbG4KJ;ij1e|*xlp=7(OdD#3VxVc+ zh#Io6fn}GD*-JRnfXgyv@tT)O1zSdMB9ydDR+UPYqDlcA>^Gwww_KsomKxrxA zp0_O;FDAjbtJLGX>$e%$w6FGfzNxmL2>eZ7=|1PHjiZjHs5l|Jiq>!Sc%e~mwf5_c z$z2b_B! zlp^r7(^R2mCBjuPiN9vP}-h84I(G-gU5X|uT$NTxD+16 zO#{W#p6|wo_%if}+`a73^2THy*7x;v?z*!ur|B-TrPYd?p_La#p}vz O@=wVB`#;8LyZ- None: + self.message = message + + def __str__(self) -> str: + message = self.message + if self.url: + message += f"\n(background on this error at: {self.url})" + return message + + def __repr__(self) -> str: + return f"{type(self).__name__}('{self}')" + + +class CallbackAnswerException(AiogramError): + """ + Exception for callback answer. + """ + + +class SceneException(AiogramError): + """ + Exception for scenes. + """ + + +class UnsupportedKeywordArgument(DetailedAiogramError): + """ + Exception raised when a keyword argument is passed as filter. + """ + + url = docs_url("migration_2_to_3.html", fragment_="filtering-events") + + +class TelegramAPIError(DetailedAiogramError): + """ + Base exception for all Telegram API errors. + """ + + label: str = "Telegram server says" + + def __init__( + self, + method: TelegramMethod[TelegramType], + message: str, + ) -> None: + super().__init__(message=message) + self.method = method + + def __str__(self) -> str: + original_message = super().__str__() + return f"{self.label} - {original_message}" + + +class TelegramNetworkError(TelegramAPIError): + """ + Base exception for all Telegram network errors. + """ + + label = "HTTP Client says" + + +class TelegramRetryAfter(TelegramAPIError): + """ + Exception raised when flood control exceeds. + """ + + url = "https://core.telegram.org/bots/faq#my-bot-is-hitting-limits-how-do-i-avoid-this" + + def __init__( + self, + method: TelegramMethod[TelegramType], + message: str, + retry_after: int, + ) -> None: + description = f"Flood control exceeded on method {type(method).__name__!r}" + if chat_id := getattr(method, "chat_id", None): + description += f" in chat {chat_id}" + description += f". Retry in {retry_after} seconds." + description += f"\nOriginal description: {message}" + + super().__init__(method=method, message=description) + self.retry_after = retry_after + + +class TelegramMigrateToChat(TelegramAPIError): + """ + Exception raised when chat has been migrated to a supergroup. + """ + + url = "https://core.telegram.org/bots/api#responseparameters" + + def __init__( + self, + method: TelegramMethod[TelegramType], + message: str, + migrate_to_chat_id: int, + ) -> None: + description = f"The group has been migrated to a supergroup with id {migrate_to_chat_id}" + if chat_id := getattr(method, "chat_id", None): + description += f" from {chat_id}" + description += f"\nOriginal description: {message}" + super().__init__(method=method, message=message) + self.migrate_to_chat_id = migrate_to_chat_id + + +class TelegramBadRequest(TelegramAPIError): + """ + Exception raised when request is malformed. + """ + + +class TelegramNotFound(TelegramAPIError): + """ + Exception raised when chat, message, user, etc. not found. + """ + + +class TelegramConflictError(TelegramAPIError): + """ + Exception raised when bot token is already used by another application in polling mode. + """ + + +class TelegramUnauthorizedError(TelegramAPIError): + """ + Exception raised when bot token is invalid. + """ + + +class TelegramForbiddenError(TelegramAPIError): + """ + Exception raised when bot is kicked from chat or etc. + """ + + +class TelegramServerError(TelegramAPIError): + """ + Exception raised when Telegram server returns 5xx error. + """ + + +class RestartingTelegram(TelegramServerError): + """ + Exception raised when Telegram server is restarting. + + It seems like this error is not used by Telegram anymore, + but it's still here for backward compatibility. + + Currently, you should expect that Telegram can raise RetryAfter (with timeout 5 seconds) + error instead of this one. + """ + + +class TelegramEntityTooLarge(TelegramNetworkError): + """ + Exception raised when you are trying to send a file that is too large. + """ + + url = "https://core.telegram.org/bots/api#sending-files" + + +class ClientDecodeError(AiogramError): + """ + Exception raised when client can't decode response. (Malformed response, etc.) + """ + + def __init__(self, message: str, original: Exception, data: Any) -> None: + self.message = message + self.original = original + self.data = data + + def __str__(self) -> str: + original_type = type(self.original) + return ( + f"{self.message}\n" + f"Caused from error: " + f"{original_type.__module__}.{original_type.__name__}: {self.original}\n" + f"Content: {self.data}" + ) diff --git a/env/Lib/site-packages/aiogram/filters/__init__.py b/env/Lib/site-packages/aiogram/filters/__init__.py new file mode 100644 index 0000000..bcadc17 --- /dev/null +++ b/env/Lib/site-packages/aiogram/filters/__init__.py @@ -0,0 +1,51 @@ +from .base import Filter +from .chat_member_updated import ( + ADMINISTRATOR, + CREATOR, + IS_ADMIN, + IS_MEMBER, + IS_NOT_MEMBER, + JOIN_TRANSITION, + KICKED, + LEAVE_TRANSITION, + LEFT, + MEMBER, + PROMOTED_TRANSITION, + RESTRICTED, + ChatMemberUpdatedFilter, +) +from .command import Command, CommandObject, CommandStart +from .exception import ExceptionMessageFilter, ExceptionTypeFilter +from .logic import and_f, invert_f, or_f +from .magic_data import MagicData +from .state import StateFilter + +BaseFilter = Filter + +__all__ = ( + "Filter", + "BaseFilter", + "Command", + "CommandObject", + "CommandStart", + "ExceptionMessageFilter", + "ExceptionTypeFilter", + "StateFilter", + "MagicData", + "ChatMemberUpdatedFilter", + "CREATOR", + "ADMINISTRATOR", + "MEMBER", + "RESTRICTED", + "LEFT", + "KICKED", + "IS_MEMBER", + "IS_ADMIN", + "PROMOTED_TRANSITION", + "IS_NOT_MEMBER", + "JOIN_TRANSITION", + "LEAVE_TRANSITION", + "and_f", + "or_f", + "invert_f", +) diff --git a/env/Lib/site-packages/aiogram/filters/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/filters/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ae5acd030d82281390dbc0d8b2f620716bb8b366 GIT binary patch literal 1311 zcmd6m&uInB9O2o@jT*2Ac~_PV;N#N25}q*1uKxi2}t53s91#*PC*){LBkrX z;1$T=j943WS78mW!8%@tEY6Ca>~6p&-h>>^i8|(PK_2I!fD2H>MbV49+pvRoM6S4Z zpoB{jvL$@iO5l4|vW?2>Pl<^wOEiAuxS{QrHL4v{>qf(9cUlLXW{WD7mM)Tn(I(;+ zO|q=6*AMj;)mYkSc9v!4Mbl^ywzAPSI!3cW$JU(CtA zY&Gl6j$Xa_7qz7`6-I@%=~m^f8P;v++5W4sWrnu35FBL+JpglLQEibld++RiNYjh5 z9h!bvj?kR`zHg61#~an{ATWpad;-n>?sv||i)J}WV{9ZD(1bHOv;B}|vgeZlvnp9P zhfcq0h9)agY%Ln*yJd36gXBnVjS#^LcYe4;Yf4v z_sv&0;v6d+363O3iX+F7=h$Lsly|AzV+!VCvVCS80pT1uom)5GNNg#Fit*P&#g<~S zP#^?}eT6D6mn!|a=YKpOP1;M3uOF4hT#p$xm&p|htyBeWBVlK03Lj`J;8xC!*%q4+ zV!AFNU(h8h(N(Rw-+klxC*6u?Iiq3s2<18vk(iG(qn yzoCSr{Rw*dub864$=_m%9!~xpQ?xs|9aB`A+>Y;B_ClS>#Z=@%;XnUAGw>H%zEl7J literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/filters/__pycache__/base.cpython-311.pyc b/env/Lib/site-packages/aiogram/filters/__pycache__/base.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b4feacc3dbcb938b9e1453984ebbdcd80800fbf8 GIT binary patch literal 3457 zcmb7GO>7&-6`uVexuisq)K41Mk+F&G*0deUty92YR2QyfJ4Omdg>5up6|9%sA+^?W zmziBkmOvRg=%5w`Vgo5GzzCpTTqO<~9fCl;sXg_O0}Zf+uqOjWi}uDqJ?YfOd@*X_$5yUQsn$bPSrkqiID5pQhd6+k%*@ zx^1Ys!C3=MRNeEKS*Ur`&2YwyuXJ|$vd+q`AD*2LdPcn(vx`F4gM{GtWBBhP=--7Y zpjrTzh>L&b($F2)ZlTI;9o!kGW*KUMb`&?Lor(3ZUnv%8)pJ$TE;<#oi_TGSCTic_ z9q6JK9LJ)%tvXCK0HO!PWCN}&xCH%|y@Tv`kh!yfxc)U{#d#I5|6$;&Kx0+SeMZuf zFT2z#u>_dMl0aO{G2qyHXEHneD~HWaPdMn#>De07J%?!p$D5}1-1INZ!n6y~d$Xz+ zXZ135r*+dQGrcm_hQL@scWI`&zy?6#Vj@6LrsMlp@T@qHf5UH?v<68$wK};A3xr{g z^+W-6!vF3mAQ%CtBT!eC1gsHtp-!GcoSt>#2Jw+{OaxxYWyR#Ftd*cljI>qEv{lSl zPT4H7SCLa>!_e`ui(6HdjX>weG_5T`TTFG0=q$YsEbbdXmdTFt<3{iEBJsV|du#G< z?mxKSP(~S=?1xI0UUqXuJfhQ3ac*8123>&tsf(B^mg}fyZ_?3w9tE__0AwskJuWrK zmYN$R3IH-NvnvPFuMID=QnhFWF~^fFK<-P7W~(|xGLV{8={?AA6v|IIuNDE2fbLq= z&^^dw!(_DRSqt5Ba%>0;>3H-wjC(vf9BkCux@%nO;__^QmE z*@F?hdl1FDe+Pn2TmfWElHQWIB-N#Lcz?JVBJhjrT@3B#=#_C$W-s;x;&pC85OENh zcQMSoJ%M}9kk{qTe1Bh;dSwD{=u;U`9nKvx89lvw9>`--hT}d=EeYN}BkDr0s7K<1 z!J8zAkKoIURvF}ln7QCfSOfO~e=jy}LD-=_RWC1&b%5`hWm|_TNj1;WpsoNaGUJv5 zmDs%ugU*Hvppbh4$TDdp&jrt#`@7+X#Ye|JIo4e|I*QyR40+q6foV`{Nmvr=;vXY* z0lXp9#V6vY5*U-fTAbSxej1o0F-%BbnDvFZP9@`M%ud4kcQ)fku*v-)5HMrpz2N!1 zxBk(_>)WaA(Y4e=>!G#wOQhSQ_~Z8M31=3?^Xi_EPKW$(kf(kKDrLp>WpAMh-yND} z>lLbLzI@j)?X(<}o^B0h=kQ#F1{C6U85-7(aD6vvj(RzULhf?qcX$le4RHMPYszJJoFx&{p4(O@N^^b zHar{hm(kCoo2Q?jxzs#!DOf|QynQ&H-O`44%VPj2Dikz`oRCWk{Ca>6tFMdfZG)ql zrsJ2IrY$Br=NfFikikSVVQyiK4=L;!M==FDZ`rMOMr70#!&)vvTeuHJ@`&^VJF6j8^FGg zqfsR2cZSH}kmPy=5X9S#A;F{E*TB~0eZQ6{hm;mU(od9;7DkS2;=bW~}B=%}cRHCU3sYRgMba}T`+rIVJ zw;EG78@JzYOuhfj<;K+ynm^0)cQ47e66}6(g70q)OQ91j(o15IP<-RmhPyejaqo*v zi@1F=Y6O&9T6}ejprs%6Nc_%Pb3gh&=ZRkd`C}!VWpvIO^FU*BjsE jc_AfRL=fKEkuNrSpH_HG0J{&9)tleq>VJ=T#a;40Fxy>W literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/filters/__pycache__/callback_data.cpython-311.pyc b/env/Lib/site-packages/aiogram/filters/__pycache__/callback_data.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..eb0cdb3a33149726d971de7062a7a02389c3d4c0 GIT binary patch literal 10040 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/filters/__pycache__/exception.cpython-311.pyc b/env/Lib/site-packages/aiogram/filters/__pycache__/exception.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d3b9229c1c9f245f2357aef4ccc3084ce3095f84 GIT binary patch literal 3324 zcmb7GOKj9e7#@4q-bWt0c@UBSiD^Q}f(S@FOKB^_BhZ9^%A=AM;cnKGu)(_yGY%zD zkfOpNs(RoMiAWVvDzy{@NSrDTJ#gruhaNU)C03S@ka}rvi$X7)`v2oyXEz~89ozpr z{@?ch{APZstBVq7zy9#&Xig#IFPxMc%tc%N4!XOhwB^$fTc`>TP0%Xykr?kVo)%O|KWc zFz_O4crjBtPZH68P;@Avx`CtFDK~gLopRjJxuoMzmUV*{rY5MXT+F6zn52^2Nl31G zGHn4DM)en{MaNh&b9Q8$rjQps!I;fXT&GzlRZ>E9;nHOJG7Rn#N_5F2x@<~%z?Ai% z8K4SP+x$01Wixm?sE162hE0`5Xq48_T3R&-Bj6mgqQ+(^+02b4zr zJ$0vdMm1O&Qb-Odk;cLah!@B*BX-%J9RQZ-UUOmnVGT>Fq}y z&7u$t&Cb%5mxQ2}<{G2dCew_XLkZc9UP@Y%R76FX0ZTzntx+-IGN`X<@6H@QJp7f- zt_~lw&2)Bb`06A}IyN&#Y-gBeuMZEVM}~RYp}QuMsjJB`%7>F_8{@uvRHOpm?K`V) zV#*C0Mmn2z3}bq;Z^cR=`pVom{G4wGGE0hK5^paODRN4B)wnsg<>XRhf4;FlSKD7` z@16^OADe?~8AOR2ut&ySl~HGsWmBksxv4O?1<&%=Kn92eajA@n<5vYCP7p*&ZAQ8e zUwPzzY225aA>+PWwG2d08cHZ`G|kgl?j*A*$}q!O4G=ftJEP=r)_}YXKuQj0jVK3h zN+m68eK&dBR(x+8kiX%YC9h&__qy**KiIp}zB`Zi$Itft_W4q5ARimZg$GzONDd`p z`1NcuLk+`?8b-!8CoLS;8pgHBq*daC48ycjupBWAZrKhu42EuWBYxai6U-Un8pDKl zgCn+WG4zWY;0|NxE!Ga?ArZe8rm;F)MG}FB&jOkCuc9m~;UYm2CJox`>0(e-wk;li z(Du{WB7xy*5|@-gX|WH|1Nx^IpY40z{5G;FJoOr2+;;0EVM5R|I0IAH=M%z^n+uu-oFh{0!wBimU`% zyF}d!*jfj*GM>DUdnmb~2@kv(mR41TVAL>P%cH{B%IcVr9KQkxsm^xR?38yec(0;9 zR-xQY59RPLqKW-Qp5EgFR|(}x`W@E3q+|5PgjSmSVo+HOlb(G9#FZI!Ln%8mk+!HX zDIt6HgyvP&lgQNR&iA{~2c0f_YY&iF@^6^bw%i%J$Cqll@-w|KnADgYe5ktOs5KaBenu zdMuj+bfbo28&F~Z$e!Jju$$v|G!H?ben9{Lq+?yH1%D^J!n=XYl0vNMWvur_thdnI zIzLzpka*$^k>k;~NT4bsQO{6BtE%L|O1TBk@;nd^Uco3Bdu`D-ue^eNW#Tx9AEoA$ z>kj5?0N78q>P@tIc2k~_Ih-HP!vShWPUBG~Fm%$5iCx{G#+2e;0P#>7pslfGe)G$Qt``kmKOcJ%e4;;V zTI&5Yk9Yr4_o;mMsilU~`G(VTY9Y1(bFZz?)Ou%sA-;9-KrXf;7v3QP0Z`61!DrcK zBwLVlAn8Pc9`$TOpLtNd3r7O4x8ew^aRsCqroR_p+=AG)GQqF&AAzig(_1{8?p#zB zQx6V4-TU}RuIFH0JA`1}xthcSN_3&ANT6Fyq9JAH>$*)v1^S{&qOm#W&V_}p1-{Tb ze>oTH%1643A>@&Dh^IX&o`|yqbgl}=HY^ehnrE-@25w}YhcMaP=F*X+uXJST8%c7? zaDQ^^$}Bwpap63-t!k~0;<47Cc&-(jytl&%_f@;}UHFK%*?z|GY=~9CT_DAPBuNDl znH5)o9LoKl`!(5~tG)}QH&=ZZ$evvFT~y=Jpj0I9rwcuA1m|rfzh{#Ku3t+QF1^9k Kx9?$zfcyt;+4B1U literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/filters/__pycache__/logic.cpython-311.pyc b/env/Lib/site-packages/aiogram/filters/__pycache__/logic.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..381aa49e484c3dc4c0c7f187c62688d9e684aa04 GIT binary patch literal 4841 zcmcgvO>7&-6`tY#h!jbY79~-NWm$C!yNqNyjhm!M6h#tg*{%(ytsNI7lrAXlN?D6P z>g>v`RVolrqg4twWq}kH5Fd0%)d&U(oeCdw=plz5sDeO=1p*i-3ba5EGUP+xQ{S7R zC@w|Y4bWzG_RY_GyYuF~_s!2Ag27G#=}#a1W$ryMA%Dllep2g|y?;aH4$+BDb0kmG zlw#eJ^W>$pl$XOF66uH0{SrnVjHkkv;t9 znez;QyhyIPs{7!ZPF(@x_?@73v2ep+wy@3?Sl`aDdBbLX@F~Nw z9hDjO5-X&#p8D^wz&gg%UJsBvq(nxk9#RiuFPh93WdpZjS%Z!q0|>SvM5u z2D4z=nzr2MQX;KY17e|hhMOjfQtc)y`q7ToIFNtBvr0aXL@Pt_b^Y!_btt|q zSBBoauL8l`-B{Wg-PH^kQsj_ zP6Y|tjvYsWE0!Z!He+AIW*7;NPjnqaWjVqBSqw;1EQgP-Ufh+ba%`8liAt48x{<){ zNxFSjl=ol$wC7X%vqa^4S3kS(=l3d;Z&zQxCRk6WLLJoPD}+m@Hd)XcSm_X0vDi1z z9taj;ZC5;EgrQxZh!h@C>=cM>c|;81@0y{)J+vG-7`p)xblqMZBGDm$NMH>fVVXuH zy3|3(a(Mg^DgquRS&;w~&=x64-bt>=02KKEDDB~~qLdU%g3St6S{oy%o=S?nzvV&C zCYaz}18A(bByGt1lFemFal?(0+viFW^OU43ut~ylC8egX#uQ=gVffPNG%d4W*_lGt zaAX~K5p`)%&)7yxZ9$_Gm@^BRoW=}mDJNDpT-dN-p{f8>NPJ=95#M5Mfzcrlw0;dl zV6+w;SPMMpd+x*BE>V1=oUBdPj-Fh9^iFuB8Xl>HN4|LAj{?&-T#Fp91di82 zku{rpdrNK&LUsZaZ3XU0>_gHIuVn&h2JWB$?r{WOGf@Ld58@UIge??LKrL`MyB!fh ziDQ3-c=c&-F#%T&uvQznkntse%3eV8;RpLMgFsyFZj9Cd=!?+LMv(B;^BI`D3xWcZ zEqI(wWQ*SJcVSU}3Kl^=>!Gl%**+M$o=Pp-o{$iysnm2c0NH8ygvF8I zt^q9f9w@eJys6l z1H0_H`rEM&#{f$r*FrsOOTt$#ffj8+^eto{!P)=!Ao41`2qGvDL{K~dM8M(fc0_2# z72tagdX4WnE==L-%D0@?pz=!!7Y+)S47hOoic;4)y+-G#F5U8$NRn)V>^*oz`T$}g zCZ`z2_!i}Rn+q&B1o~u~>7XzfH3RnXXo;Pj3^UiHT-a-7dC6^l4hW;V-kI&kZ|xd``LhOib_0TpYwh&Z8rl+>@Z z%!@3pE?<85xtHH=QE`5{;Hx9Y1a}2jwdE-C*gGb!-s9{7e1>-{>n_k;iBei4k%~Ll z$V-)HC-4qT)he>(xA@)8xV7<^qVbwoO%7KU2`{;mmLZatrIkii$+*lT68yb*kl9tDj blcXD_DBDnwJ5&Ap5e#e1NZxp*b!SFS z9R%?q&>R8{G~hrlz9hvYft*T@J@!zF5&|&`g+MRqO-4E8)Hk#GiImLlzW2?0^Jd@s z=FP9OvmS!++b@6B|27c%S51b)9)SM00Co^X6i29ueT)@0BBN>gX4CR5JvSq}>G+Pu zR+MSFzKfB8K0(yJh^WJy8zw?G;Y){~rJ1i$$^B1FOE@u4wzf(};+~X}FNZam%zP0v z!rI4SBpC<4GeU<>vxqf#(EM`sEUU@dU_-6k!KD8wfE~n;k16sEihYwBzC}%DQ;XVl zi#iuA-=P_np)PZ27Cwu)b(eZz&jR-92Au&sLv2Vimt=K1%Yh8ef9MrpoL&n>p{~;_ ztg&cA6l6S{vrX2Lg>#`?E7anaWIxDu5EUo{>(D)%cuiFuQ6@eExh4*0vdvqS8l1vt zD6AOkFM-%W9o#`=a#3)Tv7N3BLYS5T7BeYDH%Or(+in z(bHNE`xA^5cW{VhX6%>QG42>QV27KdT_$JOamT!lCvB56;Mu6~1=z4;r>B+SOvKS9 z;}#ebi>ijrvR1pvfMQm%_#v?C2)?M0IzOS-s?Ong0E*385Jl5$rZyEMPJws?4=|cv zynNw7{@A_zv43()R~pya-4{;Xwr+oSNA8hZ1GCOp^K1`%EX&R1zcTCL__x+Ui4|owA>Zrw!AbKXocpn|^PQDLOx%<5L gA$p@b`R=1)ck=By3mD3MR$Orol=bm*TsqPJ0edu`&Hw-a literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/filters/__pycache__/state.cpython-311.pyc b/env/Lib/site-packages/aiogram/filters/__pycache__/state.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..00fc235642ba55fa43605202bd8c1ca7547979d9 GIT binary patch literal 2624 zcmb6a-)j^{c=p%b?d5*tve6nf=~hFNR1+&$p|vqF(TKH1Fww#`?Q*%Dq-S<-C2V0P<-k)vzI$BN};o}-+c4U zeBaFXbH0toqX^oMU;R9DM?vUUHrZ_98nUqh$Sq_cOR$k67=plX(H0%akQ~{N9mP|j0B%6cG77zS_On7IAw)!94BxXCptDy zM>9$TH`+vW5?SHv$co^W+Y&5Dkyjc01t;6qDovT+%ZTL>dVu#h2If+1O=AzKnwEZI_KWGi%C zHbRz+!!shNB^wbHSuLQPYNX*Fm4*s&N9-lrsG&Nx@zH5W!xa`J+p2Jw_$d# zPWePA2nA%;=N5wNh~rngj(NI`!MwVg!#Y1z&r+R$AF>2nVCv|Fw4KK%2yqF&4v=Ju z?HN9yBAl-4Pfs0xYwA6h%uS8DRyH>~HJ2x8&n4!x>rLU@<*9eG(^E9-;r{t_W-dL8 z=~O!FGEW@{^ri>+(F5}fe#A7hxvXcJSKGN|0$UAiQrqA_+6`b4Rg&APNKl6!x9u)< z4z9HwEw>#l#g49T-@PQ?Xjy`91NNck%*IT&p#!*uL{vZ*0Sg-7bpw3{2D&SZgSPD^ z&Ccf1-~w!Vu1P%t8V05i$Tr}lj7cZk0s3K+ZGg*b&6nrI9c(iT6L$CBC9j<9t;AC| z-mgkxYqW|)HA>hPUvj4}`YK6Z0a*|RnR-6KVhH|E;otZePCbnTP~us?d(0uV=E<8F zLXF@ACF}BT!|r=^j%!juI*va0;+pKK4bFn>@j4VxnmMRgkQZAEvL(!MDKu07N`Mmy zYKb_3ZuD)D7Hi1%5)FJtY?e(@;2asER=h85S=p3)!DIPRYX!ME;z_@!ZLT4Z^z2z% zRWdH*?1sAzkZ2bTvwAG$eoM|-H2w2?J!q^ylRE9sv~ zvVAGfvy1EmrTbc0oynygY?^-5G#%H<+YFDH=B0evuB|{eTW$u(Dx|gTdek(@9$+Ug zG0@GxZU$Hw6PB5TC5|soyRJ=`KL|@f(hJ}&3QlKLg0yY|_9)Ts04&zOswgTEPz*o> zrFJi#s>-s`xuRAP40kL(Yy~k%i59ggf?+F&p`lTsDkT)Cl>jQ*D|}KJIJ`>lI~-qE z6HDImWN~ki7JF}gSW50KtKC&)lZEqb0f8<|jlOnx)pK+n-rFFAL*BwXE0A1sZUb%@ zmJTGs05cI!5x>3m2n^I7fr05X#e~_!Pt}*GGr+50BUK>qgU4e4j)F&$Tfdu0<-Xy@ zJ;0`{nDS(J8hJbL@KN#x&{(~uzW}I8f*@4Tu2OTapwZI*@9U_i)Z8oR_0o%a1@)Gi w`+6+3ym#3vo?kh=+P*qhJ~&cp8!5*|7u9M=7r=GTgXLHMWYoW2u*4Pr7wt}S8~^|S literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/filters/base.py b/env/Lib/site-packages/aiogram/filters/base.py new file mode 100644 index 0000000..94f9b6d --- /dev/null +++ b/env/Lib/site-packages/aiogram/filters/base.py @@ -0,0 +1,55 @@ +from abc import ABC, abstractmethod +from typing import TYPE_CHECKING, Any, Awaitable, Callable, Dict, Union + +if TYPE_CHECKING: + from aiogram.filters.logic import _InvertFilter + + +class Filter(ABC): + """ + If you want to register own filters like builtin filters you will need to write subclass + of this class with overriding the :code:`__call__` + method and adding filter attributes. + """ + + if TYPE_CHECKING: + # This checking type-hint is needed because mypy checks validity of overrides and raises: + # error: Signature of "__call__" incompatible with supertype "BaseFilter" [override] + # https://mypy.readthedocs.io/en/latest/error_code_list.html#check-validity-of-overrides-override + __call__: Callable[..., Awaitable[Union[bool, Dict[str, Any]]]] + else: # pragma: no cover + + @abstractmethod + async def __call__(self, *args: Any, **kwargs: Any) -> Union[bool, Dict[str, Any]]: + """ + This method should be overridden. + + Accepts incoming event and should return boolean or dict. + + :return: :class:`bool` or :class:`Dict[str, Any]` + """ + pass + + def __invert__(self) -> "_InvertFilter": + from aiogram.filters.logic import invert_f + + return invert_f(self) + + def update_handler_flags(self, flags: Dict[str, Any]) -> None: + """ + Also if you want to extend handler flags with using this filter + you should implement this method + + :param flags: existing flags, can be updated directly + """ + pass + + def _signature_to_string(self, *args: Any, **kwargs: Any) -> str: + items = [repr(arg) for arg in args] + items.extend([f"{k}={v!r}" for k, v in kwargs.items() if v is not None]) + + return f"{type(self).__name__}({', '.join(items)})" + + def __await__(self): # type: ignore # pragma: no cover + # Is needed only for inspection and this method is never be called + return self.__call__ diff --git a/env/Lib/site-packages/aiogram/filters/callback_data.py b/env/Lib/site-packages/aiogram/filters/callback_data.py new file mode 100644 index 0000000..17ccffb --- /dev/null +++ b/env/Lib/site-packages/aiogram/filters/callback_data.py @@ -0,0 +1,207 @@ +from __future__ import annotations + +import sys +import types +import typing +from decimal import Decimal +from enum import Enum +from fractions import Fraction +from typing import ( + TYPE_CHECKING, + Any, + ClassVar, + Dict, + Literal, + Optional, + Type, + TypeVar, + Union, +) +from uuid import UUID + +from magic_filter import MagicFilter +from pydantic import BaseModel +from pydantic.fields import FieldInfo + +from aiogram.filters.base import Filter +from aiogram.types import CallbackQuery + +T = TypeVar("T", bound="CallbackData") + +MAX_CALLBACK_LENGTH: int = 64 + + +_UNION_TYPES = {typing.Union} +if sys.version_info >= (3, 10): # pragma: no cover + _UNION_TYPES.add(types.UnionType) + + +class CallbackDataException(Exception): + pass + + +class CallbackData(BaseModel): + """ + Base class for callback data wrapper + + This class should be used as super-class of user-defined callbacks. + + The class-keyword :code:`prefix` is required to define prefix + and also the argument :code:`sep` can be passed to define separator (default is :code:`:`). + """ + + if TYPE_CHECKING: + __separator__: ClassVar[str] + """Data separator (default is :code:`:`)""" + __prefix__: ClassVar[str] + """Callback prefix""" + + def __init_subclass__(cls, **kwargs: Any) -> None: + if "prefix" not in kwargs: + raise ValueError( + f"prefix required, usage example: " + f"`class {cls.__name__}(CallbackData, prefix='my_callback'): ...`" + ) + cls.__separator__ = kwargs.pop("sep", ":") + cls.__prefix__ = kwargs.pop("prefix") + if cls.__separator__ in cls.__prefix__: + raise ValueError( + f"Separator symbol {cls.__separator__!r} can not be used " + f"inside prefix {cls.__prefix__!r}" + ) + super().__init_subclass__(**kwargs) + + def _encode_value(self, key: str, value: Any) -> str: + if value is None: + return "" + if isinstance(value, Enum): + return str(value.value) + if isinstance(value, UUID): + return value.hex + if isinstance(value, bool): + return str(int(value)) + if isinstance(value, (int, str, float, Decimal, Fraction)): + return str(value) + raise ValueError( + f"Attribute {key}={value!r} of type {type(value).__name__!r}" + f" can not be packed to callback data" + ) + + def pack(self) -> str: + """ + Generate callback data string + + :return: valid callback data for Telegram Bot API + """ + result = [self.__prefix__] + for key, value in self.model_dump(mode="json").items(): + encoded = self._encode_value(key, value) + if self.__separator__ in encoded: + raise ValueError( + f"Separator symbol {self.__separator__!r} can not be used " + f"in value {key}={encoded!r}" + ) + result.append(encoded) + callback_data = self.__separator__.join(result) + if len(callback_data.encode()) > MAX_CALLBACK_LENGTH: + raise ValueError( + f"Resulted callback data is too long! " + f"len({callback_data!r}.encode()) > {MAX_CALLBACK_LENGTH}" + ) + return callback_data + + @classmethod + def unpack(cls: Type[T], value: str) -> T: + """ + Parse callback data string + + :param value: value from Telegram + :return: instance of CallbackData + """ + prefix, *parts = value.split(cls.__separator__) + names = cls.model_fields.keys() + if len(parts) != len(names): + raise TypeError( + f"Callback data {cls.__name__!r} takes {len(names)} arguments " + f"but {len(parts)} were given" + ) + if prefix != cls.__prefix__: + raise ValueError(f"Bad prefix ({prefix!r} != {cls.__prefix__!r})") + payload = {} + for k, v in zip(names, parts): # type: str, Optional[str] + if field := cls.model_fields.get(k): + if v == "" and _check_field_is_nullable(field): + v = None + payload[k] = v + return cls(**payload) + + @classmethod + def filter(cls, rule: Optional[MagicFilter] = None) -> CallbackQueryFilter: + """ + Generates a filter for callback query with rule + + :param rule: magic rule + :return: instance of filter + """ + return CallbackQueryFilter(callback_data=cls, rule=rule) + + +class CallbackQueryFilter(Filter): + """ + This filter helps to handle callback query. + + Should not be used directly, you should create the instance of this filter + via callback data instance + """ + + __slots__ = ( + "callback_data", + "rule", + ) + + def __init__( + self, + *, + callback_data: Type[CallbackData], + rule: Optional[MagicFilter] = None, + ): + """ + :param callback_data: Expected type of callback data + :param rule: Magic rule + """ + self.callback_data = callback_data + self.rule = rule + + def __str__(self) -> str: + return self._signature_to_string( + callback_data=self.callback_data, + rule=self.rule, + ) + + async def __call__(self, query: CallbackQuery) -> Union[Literal[False], Dict[str, Any]]: + if not isinstance(query, CallbackQuery) or not query.data: + return False + try: + callback_data = self.callback_data.unpack(query.data) + except (TypeError, ValueError): + return False + + if self.rule is None or self.rule.resolve(callback_data): + return {"callback_data": callback_data} + return False + + +def _check_field_is_nullable(field: FieldInfo) -> bool: + """ + Check if the given field is nullable. + + :param field: The FieldInfo object representing the field to check. + :return: True if the field is nullable, False otherwise. + + """ + if not field.is_required(): + return True + + return typing.get_origin(field.annotation) in _UNION_TYPES and type(None) in typing.get_args( + field.annotation + ) diff --git a/env/Lib/site-packages/aiogram/filters/chat_member_updated.py b/env/Lib/site-packages/aiogram/filters/chat_member_updated.py new file mode 100644 index 0000000..23cf0e9 --- /dev/null +++ b/env/Lib/site-packages/aiogram/filters/chat_member_updated.py @@ -0,0 +1,204 @@ +from typing import Any, Dict, Optional, TypeVar, Union + +from aiogram.filters.base import Filter +from aiogram.types import ChatMember, ChatMemberUpdated + +MarkerT = TypeVar("MarkerT", bound="_MemberStatusMarker") +MarkerGroupT = TypeVar("MarkerGroupT", bound="_MemberStatusGroupMarker") +TransitionT = TypeVar("TransitionT", bound="_MemberStatusTransition") + + +class _MemberStatusMarker: + __slots__ = ( + "name", + "is_member", + ) + + def __init__(self, name: str, *, is_member: Optional[bool] = None) -> None: + self.name = name + self.is_member = is_member + + def __str__(self) -> str: + result = self.name.upper() + if self.is_member is not None: + result = ("+" if self.is_member else "-") + result + return result # noqa: RET504 + + def __pos__(self: MarkerT) -> MarkerT: + return type(self)(name=self.name, is_member=True) + + def __neg__(self: MarkerT) -> MarkerT: + return type(self)(name=self.name, is_member=False) + + def __or__( + self, other: Union["_MemberStatusMarker", "_MemberStatusGroupMarker"] + ) -> "_MemberStatusGroupMarker": + if isinstance(other, _MemberStatusMarker): + return _MemberStatusGroupMarker(self, other) + if isinstance(other, _MemberStatusGroupMarker): + return other | self + raise TypeError( + f"unsupported operand type(s) for |: " + f"{type(self).__name__!r} and {type(other).__name__!r}" + ) + + __ror__ = __or__ + + def __rshift__( + self, other: Union["_MemberStatusMarker", "_MemberStatusGroupMarker"] + ) -> "_MemberStatusTransition": + old = _MemberStatusGroupMarker(self) + if isinstance(other, _MemberStatusMarker): + return _MemberStatusTransition(old=old, new=_MemberStatusGroupMarker(other)) + if isinstance(other, _MemberStatusGroupMarker): + return _MemberStatusTransition(old=old, new=other) + raise TypeError( + f"unsupported operand type(s) for >>: " + f"{type(self).__name__!r} and {type(other).__name__!r}" + ) + + def __lshift__( + self, other: Union["_MemberStatusMarker", "_MemberStatusGroupMarker"] + ) -> "_MemberStatusTransition": + new = _MemberStatusGroupMarker(self) + if isinstance(other, _MemberStatusMarker): + return _MemberStatusTransition(old=_MemberStatusGroupMarker(other), new=new) + if isinstance(other, _MemberStatusGroupMarker): + return _MemberStatusTransition(old=other, new=new) + raise TypeError( + f"unsupported operand type(s) for <<: " + f"{type(self).__name__!r} and {type(other).__name__!r}" + ) + + def __hash__(self) -> int: + return hash((self.name, self.is_member)) + + def check(self, *, member: ChatMember) -> bool: + # Not all member types have `is_member` attribute + is_member = getattr(member, "is_member", None) + status = getattr(member, "status", None) + if self.is_member is not None and is_member != self.is_member: + return False + return self.name == status + + +class _MemberStatusGroupMarker: + __slots__ = ("statuses",) + + def __init__(self, *statuses: _MemberStatusMarker) -> None: + if not statuses: + raise ValueError("Member status group should have at least one status included") + self.statuses = frozenset(statuses) + + def __or__( + self: MarkerGroupT, other: Union["_MemberStatusMarker", "_MemberStatusGroupMarker"] + ) -> MarkerGroupT: + if isinstance(other, _MemberStatusMarker): + return type(self)(*self.statuses, other) + if isinstance(other, _MemberStatusGroupMarker): + return type(self)(*self.statuses, *other.statuses) + raise TypeError( + f"unsupported operand type(s) for |: " + f"{type(self).__name__!r} and {type(other).__name__!r}" + ) + + def __rshift__( + self, other: Union["_MemberStatusMarker", "_MemberStatusGroupMarker"] + ) -> "_MemberStatusTransition": + if isinstance(other, _MemberStatusMarker): + return _MemberStatusTransition(old=self, new=_MemberStatusGroupMarker(other)) + if isinstance(other, _MemberStatusGroupMarker): + return _MemberStatusTransition(old=self, new=other) + raise TypeError( + f"unsupported operand type(s) for >>: " + f"{type(self).__name__!r} and {type(other).__name__!r}" + ) + + def __lshift__( + self, other: Union["_MemberStatusMarker", "_MemberStatusGroupMarker"] + ) -> "_MemberStatusTransition": + if isinstance(other, _MemberStatusMarker): + return _MemberStatusTransition(old=_MemberStatusGroupMarker(other), new=self) + if isinstance(other, _MemberStatusGroupMarker): + return _MemberStatusTransition(old=other, new=self) + raise TypeError( + f"unsupported operand type(s) for <<: " + f"{type(self).__name__!r} and {type(other).__name__!r}" + ) + + def __str__(self) -> str: + result = " | ".join(map(str, sorted(self.statuses, key=str))) + if len(self.statuses) != 1: + return f"({result})" + return result + + def check(self, *, member: ChatMember) -> bool: + return any(status.check(member=member) for status in self.statuses) + + +class _MemberStatusTransition: + __slots__ = ( + "old", + "new", + ) + + def __init__(self, *, old: _MemberStatusGroupMarker, new: _MemberStatusGroupMarker) -> None: + self.old = old + self.new = new + + def __str__(self) -> str: + return f"{self.old} >> {self.new}" + + def __invert__(self: TransitionT) -> TransitionT: + return type(self)(old=self.new, new=self.old) + + def check(self, *, old: ChatMember, new: ChatMember) -> bool: + return self.old.check(member=old) and self.new.check(member=new) + + +CREATOR = _MemberStatusMarker("creator") +ADMINISTRATOR = _MemberStatusMarker("administrator") +MEMBER = _MemberStatusMarker("member") +RESTRICTED = _MemberStatusMarker("restricted") +LEFT = _MemberStatusMarker("left") +KICKED = _MemberStatusMarker("kicked") + +IS_MEMBER = CREATOR | ADMINISTRATOR | MEMBER | +RESTRICTED +IS_ADMIN = CREATOR | ADMINISTRATOR +IS_NOT_MEMBER = LEFT | KICKED | -RESTRICTED + +JOIN_TRANSITION = IS_NOT_MEMBER >> IS_MEMBER +LEAVE_TRANSITION = ~JOIN_TRANSITION +PROMOTED_TRANSITION = (MEMBER | RESTRICTED | LEFT | KICKED) >> ADMINISTRATOR + + +class ChatMemberUpdatedFilter(Filter): + __slots__ = ("member_status_changed",) + + def __init__( + self, + member_status_changed: Union[ + _MemberStatusMarker, + _MemberStatusGroupMarker, + _MemberStatusTransition, + ], + ): + self.member_status_changed = member_status_changed + + def __str__(self) -> str: + return self._signature_to_string( + member_status_changed=self.member_status_changed, + ) + + async def __call__(self, member_updated: ChatMemberUpdated) -> Union[bool, Dict[str, Any]]: + old = member_updated.old_chat_member + new = member_updated.new_chat_member + rule = self.member_status_changed + + if isinstance(rule, (_MemberStatusMarker, _MemberStatusGroupMarker)): + return rule.check(member=new) + if isinstance(rule, _MemberStatusTransition): + return rule.check(old=old, new=new) + + # Impossible variant in due to pydantic validation + return False # pragma: no cover diff --git a/env/Lib/site-packages/aiogram/filters/command.py b/env/Lib/site-packages/aiogram/filters/command.py new file mode 100644 index 0000000..f52ac26 --- /dev/null +++ b/env/Lib/site-packages/aiogram/filters/command.py @@ -0,0 +1,298 @@ +from __future__ import annotations + +import re +from dataclasses import dataclass, field, replace +from typing import ( + TYPE_CHECKING, + Any, + Dict, + Iterable, + Match, + Optional, + Pattern, + Sequence, + Union, + cast, +) + +from magic_filter import MagicFilter + +from aiogram.filters.base import Filter +from aiogram.types import BotCommand, Message +from aiogram.utils.deep_linking import decode_payload + +if TYPE_CHECKING: + from aiogram import Bot + +# TODO: rm type ignore after py3.8 support expiration or mypy bug fix +CommandPatternType = Union[str, re.Pattern, BotCommand] # type: ignore[type-arg] + + +class CommandException(Exception): + pass + + +class Command(Filter): + """ + This filter can be helpful for handling commands from the text messages. + + Works only with :class:`aiogram.types.message.Message` events which have the :code:`text`. + """ + + __slots__ = ( + "commands", + "prefix", + "ignore_case", + "ignore_mention", + "magic", + ) + + def __init__( + self, + *values: CommandPatternType, + commands: Optional[Union[Sequence[CommandPatternType], CommandPatternType]] = None, + prefix: str = "/", + ignore_case: bool = False, + ignore_mention: bool = False, + magic: Optional[MagicFilter] = None, + ): + """ + List of commands (string or compiled regexp patterns) + + :param prefix: Prefix for command. + Prefix is always a single char but here you can pass all of allowed prefixes, + for example: :code:`"/!"` will work with commands prefixed + by :code:`"/"` or :code:`"!"`. + :param ignore_case: Ignore case (Does not work with regexp, use flags instead) + :param ignore_mention: Ignore bot mention. By default, + bot can not handle commands intended for other bots + :param magic: Validate command object via Magic filter after all checks done + """ + if commands is None: + commands = [] + if isinstance(commands, (str, re.Pattern, BotCommand)): + commands = [commands] + + if not isinstance(commands, Iterable): + raise ValueError( + "Command filter only supports str, re.Pattern, BotCommand object" + " or their Iterable" + ) + + items = [] + for command in (*values, *commands): + if isinstance(command, BotCommand): + command = command.command + if not isinstance(command, (str, re.Pattern)): + raise ValueError( + "Command filter only supports str, re.Pattern, BotCommand object" + " or their Iterable" + ) + if ignore_case and isinstance(command, str): + command = command.casefold() + items.append(command) + + if not items: + raise ValueError("At least one command should be specified") + + self.commands = tuple(items) + self.prefix = prefix + self.ignore_case = ignore_case + self.ignore_mention = ignore_mention + self.magic = magic + + def __str__(self) -> str: + return self._signature_to_string( + *self.commands, + prefix=self.prefix, + ignore_case=self.ignore_case, + ignore_mention=self.ignore_mention, + magic=self.magic, + ) + + def update_handler_flags(self, flags: Dict[str, Any]) -> None: + commands = flags.setdefault("commands", []) + commands.append(self) + + async def __call__(self, message: Message, bot: Bot) -> Union[bool, Dict[str, Any]]: + if not isinstance(message, Message): + return False + + text = message.text or message.caption + if not text: + return False + + try: + command = await self.parse_command(text=text, bot=bot) + except CommandException: + return False + result = {"command": command} + if command.magic_result and isinstance(command.magic_result, dict): + result.update(command.magic_result) + return result + + def extract_command(self, text: str) -> CommandObject: + # First step: separate command with arguments + # "/command@mention arg1 arg2" -> "/command@mention", ["arg1 arg2"] + try: + full_command, *args = text.split(maxsplit=1) + except ValueError: + raise CommandException("not enough values to unpack") + + # Separate command into valuable parts + # "/command@mention" -> "/", ("command", "@", "mention") + prefix, (command, _, mention) = full_command[0], full_command[1:].partition("@") + return CommandObject( + prefix=prefix, + command=command, + mention=mention or None, + args=args[0] if args else None, + ) + + def validate_prefix(self, command: CommandObject) -> None: + if command.prefix not in self.prefix: + raise CommandException("Invalid command prefix") + + async def validate_mention(self, bot: Bot, command: CommandObject) -> None: + if command.mention and not self.ignore_mention: + me = await bot.me() + if me.username and command.mention.lower() != me.username.lower(): + raise CommandException("Mention did not match") + + def validate_command(self, command: CommandObject) -> CommandObject: + for allowed_command in cast(Sequence[CommandPatternType], self.commands): + # Command can be presented as regexp pattern or raw string + # then need to validate that in different ways + if isinstance(allowed_command, Pattern): # Regexp + result = allowed_command.match(command.command) + if result: + return replace(command, regexp_match=result) + + command_name = command.command + if self.ignore_case: + command_name = command_name.casefold() + + if command_name == allowed_command: # String + return command + raise CommandException("Command did not match pattern") + + async def parse_command(self, text: str, bot: Bot) -> CommandObject: + """ + Extract command from the text and validate + + :param text: + :param bot: + :return: + """ + command = self.extract_command(text) + self.validate_prefix(command=command) + await self.validate_mention(bot=bot, command=command) + command = self.validate_command(command) + command = self.do_magic(command=command) + return command # noqa: RET504 + + def do_magic(self, command: CommandObject) -> Any: + if self.magic is None: + return command + result = self.magic.resolve(command) + if not result: + raise CommandException("Rejected via magic filter") + return replace(command, magic_result=result) + + +@dataclass(frozen=True) +class CommandObject: + """ + Instance of this object is always has command and it prefix. + Can be passed as keyword argument **command** to the handler + """ + + prefix: str = "/" + """Command prefix""" + command: str = "" + """Command without prefix and mention""" + mention: Optional[str] = None + """Mention (if available)""" + args: Optional[str] = field(repr=False, default=None) + """Command argument""" + regexp_match: Optional[Match[str]] = field(repr=False, default=None) + """Will be presented match result if the command is presented as regexp in filter""" + magic_result: Optional[Any] = field(repr=False, default=None) + + @property + def mentioned(self) -> bool: + """ + This command has mention? + """ + return bool(self.mention) + + @property + def text(self) -> str: + """ + Generate original text from object + """ + line = self.prefix + self.command + if self.mention: + line += "@" + self.mention + if self.args: + line += " " + self.args + return line + + +class CommandStart(Command): + def __init__( + self, + deep_link: bool = False, + deep_link_encoded: bool = False, + ignore_case: bool = False, + ignore_mention: bool = False, + magic: Optional[MagicFilter] = None, + ): + super().__init__( + "start", + prefix="/", + ignore_case=ignore_case, + ignore_mention=ignore_mention, + magic=magic, + ) + self.deep_link = deep_link + self.deep_link_encoded = deep_link_encoded + + def __str__(self) -> str: + return self._signature_to_string( + ignore_case=self.ignore_case, + ignore_mention=self.ignore_mention, + magic=self.magic, + deep_link=self.deep_link, + deep_link_encoded=self.deep_link_encoded, + ) + + async def parse_command(self, text: str, bot: Bot) -> CommandObject: + """ + Extract command from the text and validate + + :param text: + :param bot: + :return: + """ + command = self.extract_command(text) + self.validate_prefix(command=command) + await self.validate_mention(bot=bot, command=command) + command = self.validate_command(command) + command = self.validate_deeplink(command=command) + command = self.do_magic(command=command) + return command # noqa: RET504 + + def validate_deeplink(self, command: CommandObject) -> CommandObject: + if not self.deep_link: + return command + if not command.args: + raise CommandException("Deep-link was missing") + args = command.args + if self.deep_link_encoded: + try: + args = decode_payload(args) + except UnicodeDecodeError as e: + raise CommandException(f"Failed to decode Base64: {e}") + return replace(command, args=args) + return command diff --git a/env/Lib/site-packages/aiogram/filters/exception.py b/env/Lib/site-packages/aiogram/filters/exception.py new file mode 100644 index 0000000..2530d75 --- /dev/null +++ b/env/Lib/site-packages/aiogram/filters/exception.py @@ -0,0 +1,55 @@ +import re +from typing import Any, Dict, Pattern, Type, Union, cast + +from aiogram.filters.base import Filter +from aiogram.types import TelegramObject +from aiogram.types.error_event import ErrorEvent + + +class ExceptionTypeFilter(Filter): + """ + Allows to match exception by type + """ + + __slots__ = ("exceptions",) + + def __init__(self, *exceptions: Type[Exception]): + """ + :param exceptions: Exception type(s) + """ + if not exceptions: + raise ValueError("At least one exception type is required") + self.exceptions = exceptions + + async def __call__(self, obj: TelegramObject) -> Union[bool, Dict[str, Any]]: + return isinstance(cast(ErrorEvent, obj).exception, self.exceptions) + + +class ExceptionMessageFilter(Filter): + """ + Allow to match exception by message + """ + + __slots__ = ("pattern",) + + def __init__(self, pattern: Union[str, Pattern[str]]): + """ + :param pattern: Regexp pattern + """ + if isinstance(pattern, str): + pattern = re.compile(pattern) + self.pattern = pattern + + def __str__(self) -> str: + return self._signature_to_string( + pattern=self.pattern, + ) + + async def __call__( + self, + obj: TelegramObject, + ) -> Union[bool, Dict[str, Any]]: + result = self.pattern.match(str(cast(ErrorEvent, obj).exception)) + if not result: + return False + return {"match_exception": result} diff --git a/env/Lib/site-packages/aiogram/filters/logic.py b/env/Lib/site-packages/aiogram/filters/logic.py new file mode 100644 index 0000000..7cd2503 --- /dev/null +++ b/env/Lib/site-packages/aiogram/filters/logic.py @@ -0,0 +1,77 @@ +from abc import ABC +from typing import TYPE_CHECKING, Any, Dict, Union + +from aiogram.filters import Filter + +if TYPE_CHECKING: + from aiogram.dispatcher.event.handler import CallbackType, FilterObject + + +class _LogicFilter(Filter, ABC): + pass + + +class _InvertFilter(_LogicFilter): + __slots__ = ("target",) + + def __init__(self, target: "FilterObject") -> None: + self.target = target + + async def __call__(self, *args: Any, **kwargs: Any) -> Union[bool, Dict[str, Any]]: + return not bool(await self.target.call(*args, **kwargs)) + + +class _AndFilter(_LogicFilter): + __slots__ = ("targets",) + + def __init__(self, *targets: "FilterObject") -> None: + self.targets = targets + + async def __call__(self, *args: Any, **kwargs: Any) -> Union[bool, Dict[str, Any]]: + final_result = {} + + for target in self.targets: + result = await target.call(*args, **kwargs) + if not result: + return False + if isinstance(result, dict): + final_result.update(result) + + if final_result: + return final_result + return True + + +class _OrFilter(_LogicFilter): + __slots__ = ("targets",) + + def __init__(self, *targets: "FilterObject") -> None: + self.targets = targets + + async def __call__(self, *args: Any, **kwargs: Any) -> Union[bool, Dict[str, Any]]: + for target in self.targets: + result = await target.call(*args, **kwargs) + if not result: + continue + if isinstance(result, dict): + return result + return bool(result) + return False + + +def and_f(*targets: "CallbackType") -> _AndFilter: + from aiogram.dispatcher.event.handler import FilterObject + + return _AndFilter(*(FilterObject(target) for target in targets)) + + +def or_f(*targets: "CallbackType") -> _OrFilter: + from aiogram.dispatcher.event.handler import FilterObject + + return _OrFilter(*(FilterObject(target) for target in targets)) + + +def invert_f(target: "CallbackType") -> _InvertFilter: + from aiogram.dispatcher.event.handler import FilterObject + + return _InvertFilter(FilterObject(target)) diff --git a/env/Lib/site-packages/aiogram/filters/magic_data.py b/env/Lib/site-packages/aiogram/filters/magic_data.py new file mode 100644 index 0000000..5c0d474 --- /dev/null +++ b/env/Lib/site-packages/aiogram/filters/magic_data.py @@ -0,0 +1,27 @@ +from typing import Any + +from magic_filter import AttrDict, MagicFilter + +from aiogram.filters.base import Filter +from aiogram.types import TelegramObject + + +class MagicData(Filter): + """ + This filter helps to filter event with contextual data + """ + + __slots__ = ("magic_data",) + + def __init__(self, magic_data: MagicFilter) -> None: + self.magic_data = magic_data + + async def __call__(self, event: TelegramObject, *args: Any, **kwargs: Any) -> Any: + return self.magic_data.resolve( + AttrDict({"event": event, **dict(enumerate(args)), **kwargs}) + ) + + def __str__(self) -> str: + return self._signature_to_string( + magic_data=self.magic_data, + ) diff --git a/env/Lib/site-packages/aiogram/filters/state.py b/env/Lib/site-packages/aiogram/filters/state.py new file mode 100644 index 0000000..82a141c --- /dev/null +++ b/env/Lib/site-packages/aiogram/filters/state.py @@ -0,0 +1,43 @@ +from inspect import isclass +from typing import Any, Dict, Optional, Sequence, Type, Union, cast + +from aiogram.filters.base import Filter +from aiogram.fsm.state import State, StatesGroup +from aiogram.types import TelegramObject + +StateType = Union[str, None, State, StatesGroup, Type[StatesGroup]] + + +class StateFilter(Filter): + """ + State filter + """ + + __slots__ = ("states",) + + def __init__(self, *states: StateType) -> None: + if not states: + raise ValueError("At least one state is required") + + self.states = states + + def __str__(self) -> str: + return self._signature_to_string( + *self.states, + ) + + async def __call__( + self, obj: TelegramObject, raw_state: Optional[str] = None + ) -> Union[bool, Dict[str, Any]]: + allowed_states = cast(Sequence[StateType], self.states) + for allowed_state in allowed_states: + if isinstance(allowed_state, str) or allowed_state is None: + if allowed_state == "*" or raw_state == allowed_state: + return True + elif isinstance(allowed_state, (State, StatesGroup)): + if allowed_state(event=obj, raw_state=raw_state): + return True + elif isclass(allowed_state) and issubclass(allowed_state, StatesGroup): + if allowed_state()(event=obj, raw_state=raw_state): + return True + return False diff --git a/env/Lib/site-packages/aiogram/fsm/__init__.py b/env/Lib/site-packages/aiogram/fsm/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/aiogram/fsm/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/fsm/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6550804e7edae4a24e86bf7f8cd87324a04d6962 GIT binary patch literal 181 zcmZ3^%ge<81lwkxNdwW3K?DpiLK&agfQ;!3DGb33nv8xc8H$*I{LdiCUmh-2G2!_| z*)h)fDVcfcG1;X>i6!|(@k#k5F{ycFF+Q0|F~ylBsk#M;$=QkNsl_pgnfd8OiMje| z#ku#Lo literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/fsm/__pycache__/context.cpython-311.pyc b/env/Lib/site-packages/aiogram/fsm/__pycache__/context.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..109c39e63660e8b559e314d6e4210806d668d604 GIT binary patch literal 3128 zcmcgu&2JM&6rcUfI&n4uvLVny+{QxrXaW)(2<4*%R8mn=wMLX$R;|UeN!|D(o!zt~ z^#K)BMHGo1Dg~)M>>;8?x~^J9C~0pelzoC z=Iy-S`_0?^t-HIEK>7WbKW2`Jg#3wvMuD+cHm9IjA(T)qNAg^f%kxP-FC+yHb$m|D zOGzm&C*^!cvV$W$xkRXNhfwh$Psn5V`z5JRDM3c$zi~JsxWfB|MOVC-%~-DT@w}BS z7W5pbyUy#Tk+6zPpEcY_!qP3{>f*fNb_Tl3#$qP0=rxgGuvvx93Nc8Mqa?{w&JZYX zh*Y5Bj7+6FVp5_#R5oN!BhrpLQnG^zhGIkxg!X25s=&%l8Zo+zh!LIPx8{OSafA(SPQH$oe@GG2tCB_2jxV@OGYJmRKDc-93f76kz@ z5KSXDv!yZ7SS%KMdFkS*)MrIDm%31-*}`mUZh`4=n)HpLl`;z7q&~{tNSRs77@yZO za}Yl>rDuz?OwS*kG4n?=z6TTYi>{JRXA4;?onG3v<=R9;*#VC;`#{_xwf%>e#e31( zzJ6$wW%zA^p16{U#K?r?0v*!zHvBiQgSbpM^qhPJeZSbD&kYT>up+ck;?}rU%H9To zefU>~=W2XIjhFk@2A*n;8n3A5s_HpM*|oBLus_r6CkD>LYMrO*%boRhjf$cSWjO`s*hJ!Vr++4LE*-6bc3xPt?K*T+zab!=Pxn290gV zn087GZKy+KaZOpb9CfIop028=9c9=0+9|;Xni0U*h6u2O=ui_CVlZy;ys;dwRyz|$ zH?+~RwRY3dMl0IMs&>-pX{*Xfp9%8Zw>q0O+qm!}Sl;{|L~t26rj>Xb#_grFjrtrW zi|``YVcKZk2`li*d8Nd^DxD+gor!D@8Si4NBMyEeX|jjzX_ z3_t64wDF2IRn?}Pp0=t?y@FLY;dzZjV?)2aQ1Yszf++8ts=Z$pQ?M$chMY@o~el(r_dO^?mGfalHOhK_11->19 z?+_oJLgA$MI3N^A`*Xj28u!~Bq|8aD?1A#o>LHvwwOzpU8T&+8C@0Fw>RFsU zvrfHcyMUFGwrD5HL-zGm6=x^63xymzQ5PiXLpUDFTHl)wuG&MkX%GMUMYZo8f39}! zyx(~d>0ZwKbbR^Cdxz`N)-HcZ~g5m{gAov!V zfN!CR;3ID027K)L0rtY`McIqa7={Sn=iWVkshsx7ah6Sh4zrMHf~X4|$JNLYXZQMo YTyl1=b@?C%F13q)Q1|Z+6W*cz14ewA`~Uy| literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/fsm/__pycache__/middleware.cpython-311.pyc b/env/Lib/site-packages/aiogram/fsm/__pycache__/middleware.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a4bc62b4c99539a72a2addf5882f0d7929af3bb8 GIT binary patch literal 5408 zcmbUlTWk~A_0EjP@3$wh2?+$u!a6*|(gl{sDlb?THmFTPiZ`umJd@zyM>;bBk{XE> zXq68>P(?+gQYjx*3JsO`sH)X!rEc5bemIe4Y{z%b zoOAEF=iIsHanJa7KA)Sw^`~F|eR9Q5$Ul*&U3?YU_&p#GiAY2yNAgUP$+Jl|&n3CM zEosa1Nj`5++8G>YbB??->7+Q9bLHJhH^pr^Pu`pK=6y*YrTLscA4mo$ZqEhtp=2l@ zPKNW5WF#*n1={b(wdLEB?fGajN@-^v%BWh7jPf5DFikz3`K%obuji_>3 zm8Rx&e|lynHCeR%4rF zL`LF8RSK?(gwNo6f} zaMld0+hs|el?%fe%VJ;%7H;(QjY9w)k`hxQDZtFD!~q5Nu2L*e$WJekjF2bHaDtPg zK+CuxatuJirrQ)LH)(cb4;@obX*XQoemwZW#CTD@HZf2XvxTXNYqQ{xMLBh)s7^?Q z>k}8US0?|Fw*u(E%$)8_rLu*rno7-gwc3{hwc#)* zSGob*CWe>9wlCQ3d9_$KJbYUBp#@vT*;S@(19*t;xSB3Nn94d&w^O%?X*J!nZFXS0 z1NX*Pus!Dq16!wB8%2m}Z4)6SPGsutvJ4|D*61x;i7Z(Z>aJZSTZ!Am%a_Qsm6kv% zdlHySynGM(Et4+Q5^PNneU|uXTrs_#a?7yN6>GIe$Q=mfUvQVmL+*1M1M6LK)OZ`8 zCBDQjIU9Rw_%a|XH3GJ!E={yOVw<&Lss$%wH@{uutPBfjAAZg6e+PQ&s~jP5(n}iq z6x$8I^4Eb=y*Af)(Vodeg?J>XrC3~AcLq$Y4mb4}iZy!P1{@FEa3C8-K^(z5 z0CY!HmV#!(u<7oWx8VSId1rfV zi6j;{E!@5y-nSOs_ju&luGR3-O8Dr4L)*6VQEtJu@RL>NR?QPO2=6*<*h#Fj65Y2R z?OluZKAZaEwQ{s~HQHZ^_8Wxt9exX-1%-#6UwW3NzTUImKeE<8vf4jZ=^rbfe64j} zDtBI54USiWk0P&@A#XO0a!J@C@E^TFxQlE z(CcWT{t}QkWE-}1K2fdsC!{$do1=_oBrBVMD(ix%wM|>u1#n9u;8w-}+{zIp?kTej zTq_nQ#2Y*O#9s69t7$cr6?Mm~BFTuj)T^?T77=Z~GOJ_@lA>T#6`&e{(gylvJf>h7`1?y&`*7Kp3|;%kAp7K~`Z zj*5_|!uEKjeZLkzREeL}gsp~;1b4k4j-dM`0)seQZn+!e%Prn8W0?XNET_2(1f1^d zZAiSg*b@8M@e=ph(Z(YSQ!*SnWZF6yz)W}=wB+G!c zE^eSyBGXp!_WfsLJji%XS8HgU&*X}b327D0P={A=N#@Bf_W?TJ(Q*^%ydsP%mjRe3 zzUB|#%dPvn*Zke9{+$*7&a$&b1FniczV1(~`4g-Dy%qo7vhzC|_0R+>cYu=NL=0<@ zLOL&{Qo1{p$`{4i9OB+o>gTiRoH-(6<*j?iMuvWrIyame_^5AG#!pE(fM7cU^j=v& zfX9T+!S{-cUN2+fkq;t(KM~A|OU4j4{SK3|&SeWKjdB@XjBe2rLYGOaCAl4Y5uk%A z9x&Ez>u0#hj(wHxV}{Gg_ZkGi^H8V3BVi|7_ZtqxoFuZ%WN;I=-|*B}DZdGX0N?XG zv}N)1<0H?wXCu#?PfwRSKKSC?*O{+|%N-wALgx)0SU_lSo8dsrNdl4k?=5ookKHR6 zF6;r}KEs0;X$Czcw#RV!d2nd}&wW9IN5bAH!GS$a5^ggYL00&FPsP<`cxvNSRs@1FeD)LJS2q zfF73L2US{YVEPGq$8ch+Zdd1K;B&OW^{8W_PnuqbXQ}R}ev6v*f4oW^5VOimTFqRQ zP$78+hO z&}eEFnz_w?fM{&e16TLe#$gjA#f(N8J0Iavx)I>l$G6UtW|*Ire+VQdCnW*U;24I{ zNMHH;wC5yRZf+VmU2bj~885eL8tExFH-qIF7Cu(~FW@E2sWLhFdeg|e<>qGCf5tH2 SQ?23R=@)e5<#&wJt^6;}s^FXe literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/fsm/__pycache__/scene.cpython-311.pyc b/env/Lib/site-packages/aiogram/fsm/__pycache__/scene.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a55a4fba0e3ac4e64dbdde0c1bc5e66db3cd180f GIT binary patch literal 47876 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 m#G1OT%Z0CD76^ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/fsm/__pycache__/state.cpython-311.pyc b/env/Lib/site-packages/aiogram/fsm/__pycache__/state.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a3f4cacffb72d0aad3da47d4f91d3a1b3e7b6e17 GIT binary patch literal 10518 zcmb7KZ)_V!cHbp;DN-awNu*?1e`!myEZLTw*tz-~o#G^tFR|}r-^uY^6+1M|UD>iF zQkkXVL?<6~R|D0hZqGfqHFL3BesFzGlcM=l7)1;CLq7CFKP-&}LM#x#KvCe@4}}8f z!@(bl{@x6^+9f6TZnSzkGjC>g=FNL=-h0E}M5B!o(m#Ft@3X;nN%{{eRFhiCJpE^6 zZcCb^$@9_-y?yiYf^WvR;Ggj?C^O1}I-@QGW&#ThGYvA~{qw< z>V2OieTsjPW*Rvr08E1(zV8PP{}o(>8I5W(o7T8Y2nWz z_hr=MU!<9sCQnPl(f^|2)NsJ|zncBP4!)V!SvsF%cJSn4elC|y&)e$hrNw#OR!)Dg zsN2zOE|o_nmARy6t_;g|(`kKPzsS-HCof#qGxZdr6rTP!GPfmNnvpeW#;3_M zeyv^e>x!;!ciL-8OcwMPkS`hWBx7Vys3)Qs?X&qYlx-!$K zMYIMjs;in9y9sq+jG&@d4Ecy2nTcxKwPw9ZYw?bYRx!+`6|-s9;(7}&D_R1*T9J=q zgf`?8nh!+nwAJZ+IYjSLAL`;&o8lT#@TC7 zhIoR?PY(dxmR95yDTSO!D?XH*{nR9s93Il7Y3UPrYS?cFQsPtLl>1wv0JLK0^Rq01 z5m^+#ps!)d&n731oc&RbT{-)DPMgbKJbPt{vqkDcE`L_fzIXO}a~IAUb9sH=Vmfmr zeNi{grss0R2K#4?h5h`Kql@6DRBA3emrtdZn>ZClt7ZD4(G9RFmD{`4lpEo4*Wj9B z1v|lf_1e<&$&SWIFpnl2dPV*vH}+&W`+WDVv{L&?gzou}@@{ zK&3&mO0qV>tGxMgSS*?sTBykYz^e2l7QgY6bx97rCV$o1YxW&2wZ3Y#zG_BZEfdBJ zcCu|~xcM^g0pnff&%*A7Xz~@#2CTtdJ57Xf$hMk5$zc{2b(bzXB)cYOTim@^&|L!7 zr}?hQEAq!sYQSJ#B7H2~^@E(slr4`ulaD@=j|?k}md{!Va013tsoACZc^6ZrQlI!Z z9T~BOL9p3mctcOEi#9xBJT-Fn%K^a5vv zyUcL^1LdJlRpAM-jigevSehVIR;yUPyKaQKP(P@x3geYKd)FpzoG1q)zl?nt zE2yPluNCYytIu;JnfM&0gGUW5%9@YlsUktk!7)CG5&nJ~Fcma7v1A4arCq^a>#o#(IMEMXk-2os- zf20t99PT#5-4OPhhsv>z!o;29k7K*c;I1mSFD$!mH~?fh+;&qhoWAo;DZJMT?_OKvF%>h`PvX?ixJ6#Izu);g2!BC~av$>FXT|!=U>~0!6zLQw)r1zT0{~|e z2_nz)+9{zm+Q@hjn!s*Mr51A9(mb?+4IT0BQhL6Ef#7Mm40eUoIXglCu7YF-7g=sm zXZa7r;9O`)0kJ&<$eg3$nZ5`qWg#jm7jn6I_7b5<*4P+T`scEF_6l;JNPO~KO|dZH z36OzpEJ6>gI)CdvpBh}32n7A=VH|Mk;lib&ac6;N9|iv{{za5$%|AZJ-?gAo3N)?z z{Aw2=1o+yIy6Zm{wE`bjci()!=)ZMsT|#yPI8CXx)30{ZC~nZ`SNqJJFHv>h!)g9{ zbeg|vL8GkhFT}xY>i${~keauxzOkxMpf-C zyuL2sRh;0jTF@k`$wEJUF}WoWn?YNU!M~HLXZq8>$DaHt7{2QAyahF{`!yeJDjXlb zrcjPt3=Pi5h7$x#pn?h1VHzr!1}(VJqpnqG%aI$m968J}!8K`C)*{z~HEvc2{$o@R zz{P>XRD%m^F*srF`9!_tSw(9m*9s#jUW|9<7`+AUqP$%VRe);+u8HGn=mK0ExR{pE zn}Kh^_s9`zMV@Bdj(i;Xgxl3b{WjFMtx508GwnE_I_wx%jlxR$zMfAncUAr0x9i-G zbEFT1i3Ii2!`x^g0<=c2g=vr(d;8 zwe0jt2z;eXN(fyuio=1DM28PC=F^8bX#Ps}DqZjHZDC50pXpoi-^Zw*IwN0GFG|+} z_-|P87o8)_^Umsafi;Y#B`&~Qcwa`k#7V`|%&GR}ub2UXf z!c%@jbfuLBZ)>!3*5qjysB1^ZSKWA;d|g@zOw{Z|UEf%>FV;&2a$WN7BxdDM5ItP< z+vr%=gPc5`(1VPUx>VPL{AQk3RPOC~ykBCtgZO_s0B}N*xfOaYOy1{)y?I8uErT&4 zj^!`xO`q)>J;03!w^8&gGhCYI@#T>k;YXArt6zn{j?L#_d>Z4UPTP0zeeT8o zR{E{9Dw+Kgcs`#jPTo5q@@^>XjdnzPmS79muod{Qwu->Xg24`BEPjmJf%M{{p4IFI z*n5kJq9J2&bC1z_tD0dE<^miup&Zx=U~Dx{u{lP56Z<}aDXNX7F2al1&?D@mw^nEm zc8Y4-oVISA!hQhUaM<=QWDM>n+3JO~p&NFHs~iM<5U{#(HO(#>wm&m(*a6Yo4hYR< z`+>4mUSQnPBmqERsghQOA@gHYE^pg{`m`S7Fb>k+txEsd6#vD=8yA0>`!H9?6c0UU z`#e-?I$|{)S@S<>iLV991fFc)`L}()?kjB{v9^!kR1Xbu@QXLsCT{kVzuJFysT3Qu zVyIW5gXQM-+tFV|3z<^$POEvR$)B%UI&Sq9FyHNO??deW2pvgg3#o&%+x7p6Ni%Y?9BaL?Vg|beiD(3mqe$w8ljs;S zM4}bh6?ff&L^T>s-iXGoP^4W>{{?vYl#t;hmyFRy9u6j%_z`RbJ(<=h*qS^Ki8`O0 z&9UTM-VjX@kJ+2NiWc)mE}7MJEt$_HnGWrgS(=AM;S2<)Hwi5P!vK-|JAKc)sC|AkIXwr@Gf4yT*(OD>iBwgZ83;gOf*kGi7dFw}WIE4#QGk?UQlrVAja$nujyhq4S z(a0DDK=h?0ajO?9x2@yWJ0xrHzyJ_YjkMm>t@d4|$gZ_xYsbp5wzcRVzDUT3NUlZF zM(|X>NWVDt_yI`gS!KEGUF1a|*|XO3sD92`4Q`xYN24v)x`)=f$64!0DKhe$wJI2h zZ|FEOUPGLlYOV;#^NqIW7(_2(XvZLG^%_L~7}~@Cb4mJpdI0DRIh7oGQNcX!45_$lQGE*4ud1Je*4qlOf}ZTO}+@qYx`pc$5Tm zdGPm|(}&b`CjiBN65>k_GS=u(WJ`%t7GUg@6+2}HPx0^C3Rz(|D5_>1Q6jw?e6QPaMB7>2qi=p zGKGUy*FiIW(2N|USfX}!vJ~EFg?AEuw1VGf#`l?#eFA@SBN$nOC-u4X9L+*ez1p}s zV(LB~Q}<6TH;I_KaQ2f!jMUn&ER2zwz&elAZDyhJX!~E&nkn1|r5GD4DpvBa85^rS z!LjE|afDCN!yGPUP-{q4t}!^LG9e%}^W+z;IPkGc9re2e1_$ONnl1TdmB6T#7%Ihf zTe00{aJP`aZQK@Puc8fm4S-@4=`1cm)AUmSict`c2@c{6MP4@}cb<_Y&n5`$AV9|@ zql1N=CqUvWqMFAjca^{a0t$hj0NBw=fIFj8@E_a3y#^VmqvDw2+)9AHV*C#<@C!En z%FX*sg`SeKuiU)fROl%w`^(J~+n&C8*=pWlD)f|;9p$#p!oi}yaQIfrR0i;rl!0<$ zdtsn(&Fb9uz%V;s#5JL*&{I+l5^As*FN|1;K~tfpqzslj`-=YJbTN1bUmC_!Qih+X zt?Rx{6){T>pqOa<`Z<9*TnVps7ZHW@ghrjvDb+Sc)HXOeQLF!3>k{%04?T)nFHiA& zE$CL%_M%$U9(>2z_3eiT&0XVG@)h_vYI`k+h?e?;>EdN8`9dw4cZtaA59Ff$;Pubr z58k+!gMgyE2@Et~hW>R4uLlZ$)q+-8{f-FWeuw(IK|ofA3%iRi-Ql6#VM6~ufU_vq zSs5^Zld6HAry8m@0)Ejhn5L4DemEWE;Vw@oQ zHXvXa*63b4#Qkx8Rp2q-=v?5ZJ@L5Ld|So6825*q*=+7*-3R_tr%lz6^9h$JNER8( z<0`r=CtPwrT5b9_z!?1i72n7V?|@^pcAWg5pMDwJg$pyU4wzyupf$gj^IQQc zsO5_zWr@Z4yt>P)u{M5aKu3|Iz4G`S2e+~rzssZH93zzOJ-kbRKH&F&_keMfY{%V+ zV&bFYcaB@#FPpKK&EU)RO4gYwX&5>Oe!r>WR}1vp9bB`EYqHAmfV1)E80R^sL)=aH z%029FXwt-cbTW+J)ryBcx_sxd)r-SnoSxvgVCQBu8IIJd-7xpG;K5zWX^iXGRkY*R zM6P=#u1fiR5m%*eP!sxLgix2{hj2!{i;Qstz@;nIX1dB5E+h&I)^^FU^{6 ziHDon+j!XlFb!Nhad^FGxh; z?GS$0BeKj(y=TEOao;!2K14q{g^d3NSoh1aT$Y+v`CnN&X8s}16KS{UebxgzSO)FuLE$8?{hCnUY~Z`4miC+KUpCxoSdEq= XEo+knzZvN+MY^p>_iBj#_@@0ICpz|l literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/fsm/__pycache__/strategy.cpython-311.pyc b/env/Lib/site-packages/aiogram/fsm/__pycache__/strategy.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0df1f7f0ae1a5984368c4e70c4bd457e4780c2d0 GIT binary patch literal 1548 zcmZux&2Jk;6rb4-@7j*-Bu!1Ca&VKhlC986P;vkSDoK+T(gfA6idIIWt!L~Sd%b47 zMl!g_haQTQgCiLw5*JQIRj-J@g2NK^u-a24PTUrSQ%}6Hy{3g7@BH?C{O0++nK%1$ zDwRMme*N*c>bD9)e+VTUnW=Dg2*NR;l^-Fh zF#JSD=o!q(Fk*2;=V*+@sKzv^!;CY9X)7TC(F9W&_+GbG<$oE~1Wi6t4V|h*lu!LB zR^}yNxzXxczG8MA8#Mi(?bPj-+4R*?x7}owS$q(rsdDxm2*-#a15;#36dSUHnDPXy z&!!ZF3^fi5{%3_cBCJ}ZRgbjBsRa4UesZUHyXbJ!VYS{jZzpmvz>@1sO}VPgL9w}6 zW4Q+FtL z-nc_+~`7DHYfLOr_5Skm-p)T%bmKz-fEkb24vqUn{~U!P3vm4V_gmFyVCA)9m0)4 z1))O#2D4uvNva+o0XkY*9$q`z9BmHvJmp<4nR$He`_046!M3N|@fNeg^`pz9%Y#on z|4ccB-wp+M1Wio@hTUxtU9@e#z4^ z!c{oc3a(a&a&4Sy8?Lr7ajm$Sf~yy%tMaE>-qrH2xn3j}hr1^wH+j)jE=~^l0;G|T z`wD~40~gyj>HnD1YeUm=(Q!N`Ks2E**IUlG1imP2<2DgxzSKXMT&oXx4pecpo!w7T`81ND7_^69wav{{h&(W)=Vd literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/fsm/context.py b/env/Lib/site-packages/aiogram/fsm/context.py new file mode 100644 index 0000000..53a8ea4 --- /dev/null +++ b/env/Lib/site-packages/aiogram/fsm/context.py @@ -0,0 +1,32 @@ +from typing import Any, Dict, Optional + +from aiogram.fsm.storage.base import BaseStorage, StateType, StorageKey + + +class FSMContext: + def __init__(self, storage: BaseStorage, key: StorageKey) -> None: + self.storage = storage + self.key = key + + async def set_state(self, state: StateType = None) -> None: + await self.storage.set_state(key=self.key, state=state) + + async def get_state(self) -> Optional[str]: + return await self.storage.get_state(key=self.key) + + async def set_data(self, data: Dict[str, Any]) -> None: + await self.storage.set_data(key=self.key, data=data) + + async def get_data(self) -> Dict[str, Any]: + return await self.storage.get_data(key=self.key) + + async def update_data( + self, data: Optional[Dict[str, Any]] = None, **kwargs: Any + ) -> Dict[str, Any]: + if data: + kwargs.update(data) + return await self.storage.update_data(key=self.key, data=kwargs) + + async def clear(self) -> None: + await self.set_state(state=None) + await self.set_data({}) diff --git a/env/Lib/site-packages/aiogram/fsm/middleware.py b/env/Lib/site-packages/aiogram/fsm/middleware.py new file mode 100644 index 0000000..de93457 --- /dev/null +++ b/env/Lib/site-packages/aiogram/fsm/middleware.py @@ -0,0 +1,113 @@ +from typing import Any, Awaitable, Callable, Dict, Optional, cast + +from aiogram import Bot +from aiogram.dispatcher.middlewares.base import BaseMiddleware +from aiogram.dispatcher.middlewares.user_context import EVENT_CONTEXT_KEY, EventContext +from aiogram.fsm.context import FSMContext +from aiogram.fsm.storage.base import ( + DEFAULT_DESTINY, + BaseEventIsolation, + BaseStorage, + StorageKey, +) +from aiogram.fsm.strategy import FSMStrategy, apply_strategy +from aiogram.types import TelegramObject + + +class FSMContextMiddleware(BaseMiddleware): + def __init__( + self, + storage: BaseStorage, + events_isolation: BaseEventIsolation, + strategy: FSMStrategy = FSMStrategy.USER_IN_CHAT, + ) -> None: + self.storage = storage + self.strategy = strategy + self.events_isolation = events_isolation + + async def __call__( + self, + handler: Callable[[TelegramObject, Dict[str, Any]], Awaitable[Any]], + event: TelegramObject, + data: Dict[str, Any], + ) -> Any: + bot: Bot = cast(Bot, data["bot"]) + context = self.resolve_event_context(bot, data) + data["fsm_storage"] = self.storage + if context: + # Bugfix: https://github.com/aiogram/aiogram/issues/1317 + # State should be loaded after lock is acquired + async with self.events_isolation.lock(key=context.key): + data.update({"state": context, "raw_state": await context.get_state()}) + return await handler(event, data) + return await handler(event, data) + + def resolve_event_context( + self, + bot: Bot, + data: Dict[str, Any], + destiny: str = DEFAULT_DESTINY, + ) -> Optional[FSMContext]: + event_context: EventContext = cast(EventContext, data.get(EVENT_CONTEXT_KEY)) + return self.resolve_context( + bot=bot, + chat_id=event_context.chat_id, + user_id=event_context.user_id, + thread_id=event_context.thread_id, + business_connection_id=event_context.business_connection_id, + destiny=destiny, + ) + + def resolve_context( + self, + bot: Bot, + chat_id: Optional[int], + user_id: Optional[int], + thread_id: Optional[int] = None, + business_connection_id: Optional[str] = None, + destiny: str = DEFAULT_DESTINY, + ) -> Optional[FSMContext]: + if chat_id is None: + chat_id = user_id + + if chat_id is not None and user_id is not None: + chat_id, user_id, thread_id = apply_strategy( + chat_id=chat_id, + user_id=user_id, + thread_id=thread_id, + strategy=self.strategy, + ) + return self.get_context( + bot=bot, + chat_id=chat_id, + user_id=user_id, + thread_id=thread_id, + business_connection_id=business_connection_id, + destiny=destiny, + ) + return None + + def get_context( + self, + bot: Bot, + chat_id: int, + user_id: int, + thread_id: Optional[int] = None, + business_connection_id: Optional[str] = None, + destiny: str = DEFAULT_DESTINY, + ) -> FSMContext: + return FSMContext( + storage=self.storage, + key=StorageKey( + user_id=user_id, + chat_id=chat_id, + bot_id=bot.id, + thread_id=thread_id, + business_connection_id=business_connection_id, + destiny=destiny, + ), + ) + + async def close(self) -> None: + await self.storage.close() + await self.events_isolation.close() diff --git a/env/Lib/site-packages/aiogram/fsm/scene.py b/env/Lib/site-packages/aiogram/fsm/scene.py new file mode 100644 index 0000000..fe4de5c --- /dev/null +++ b/env/Lib/site-packages/aiogram/fsm/scene.py @@ -0,0 +1,912 @@ +from __future__ import annotations + +import inspect +from collections import defaultdict +from dataclasses import dataclass, replace +from enum import Enum, auto +from typing import Any, ClassVar, Dict, List, Optional, Tuple, Type, Union + +from typing_extensions import Self + +from aiogram import loggers +from aiogram.dispatcher.dispatcher import Dispatcher +from aiogram.dispatcher.event.bases import NextMiddlewareType +from aiogram.dispatcher.event.handler import CallableObject, CallbackType +from aiogram.dispatcher.flags import extract_flags_from_object +from aiogram.dispatcher.router import Router +from aiogram.exceptions import SceneException +from aiogram.filters import StateFilter +from aiogram.fsm.context import FSMContext +from aiogram.fsm.state import State +from aiogram.fsm.storage.memory import MemoryStorageRecord +from aiogram.types import TelegramObject, Update + + +class HistoryManager: + def __init__(self, state: FSMContext, destiny: str = "scenes_history", size: int = 10): + self._size = size + self._state = state + self._history_state = FSMContext( + storage=state.storage, key=replace(state.key, destiny=destiny) + ) + + async def push(self, state: Optional[str], data: Dict[str, Any]) -> None: + history_data = await self._history_state.get_data() + history = history_data.setdefault("history", []) + history.append({"state": state, "data": data}) + if len(history) > self._size: + history = history[-self._size :] + loggers.scene.debug("Push state=%s data=%s to history", state, data) + + await self._history_state.update_data(history=history) + + async def pop(self) -> Optional[MemoryStorageRecord]: + history_data = await self._history_state.get_data() + history = history_data.setdefault("history", []) + if not history: + return None + record = history.pop() + state = record["state"] + data = record["data"] + if not history: + await self._history_state.set_data({}) + else: + await self._history_state.update_data(history=history) + loggers.scene.debug("Pop state=%s data=%s from history", state, data) + return MemoryStorageRecord(state=state, data=data) + + async def get(self) -> Optional[MemoryStorageRecord]: + history_data = await self._history_state.get_data() + history = history_data.setdefault("history", []) + if not history: + return None + return MemoryStorageRecord(**history[-1]) + + async def all(self) -> List[MemoryStorageRecord]: + history_data = await self._history_state.get_data() + history = history_data.setdefault("history", []) + return [MemoryStorageRecord(**item) for item in history] + + async def clear(self) -> None: + loggers.scene.debug("Clear history") + await self._history_state.set_data({}) + + async def snapshot(self) -> None: + state = await self._state.get_state() + data = await self._state.get_data() + await self.push(state, data) + + async def _set_state(self, state: Optional[str], data: Dict[str, Any]) -> None: + await self._state.set_state(state) + await self._state.set_data(data) + + async def rollback(self) -> Optional[str]: + previous_state = await self.pop() + if not previous_state: + await self._set_state(None, {}) + return None + + loggers.scene.debug( + "Rollback to state=%s data=%s", + previous_state.state, + previous_state.data, + ) + await self._set_state(previous_state.state, previous_state.data) + return previous_state.state + + +class ObserverDecorator: + def __init__( + self, + name: str, + filters: tuple[CallbackType, ...], + action: SceneAction | None = None, + after: Optional[After] = None, + ) -> None: + self.name = name + self.filters = filters + self.action = action + self.after = after + + def _wrap_filter(self, target: Type[Scene] | CallbackType) -> None: + handlers = getattr(target, "__aiogram_handler__", None) + if not handlers: + handlers = [] + setattr(target, "__aiogram_handler__", handlers) + + handlers.append( + HandlerContainer( + name=self.name, + handler=target, + filters=self.filters, + after=self.after, + ) + ) + + def _wrap_action(self, target: CallbackType) -> None: + assert self.action is not None, "Scene action is not specified" + + action = getattr(target, "__aiogram_action__", None) + if action is None: + action = defaultdict(dict) + setattr(target, "__aiogram_action__", action) + action[self.action][self.name] = CallableObject(target) + + def __call__(self, target: CallbackType) -> CallbackType: + if inspect.isfunction(target): + if self.action is None: + self._wrap_filter(target) + else: + self._wrap_action(target) + else: + raise TypeError("Only function or method is allowed") + return target + + def leave(self) -> ActionContainer: + return ActionContainer(self.name, self.filters, SceneAction.leave) + + def enter(self, target: Type[Scene]) -> ActionContainer: + return ActionContainer(self.name, self.filters, SceneAction.enter, target) + + def exit(self) -> ActionContainer: + return ActionContainer(self.name, self.filters, SceneAction.exit) + + def back(self) -> ActionContainer: + return ActionContainer(self.name, self.filters, SceneAction.back) + + +class SceneAction(Enum): + enter = auto() + leave = auto() + exit = auto() + back = auto() + + +class ActionContainer: + def __init__( + self, + name: str, + filters: Tuple[CallbackType, ...], + action: SceneAction, + target: Optional[Union[Type[Scene], str]] = None, + ) -> None: + self.name = name + self.filters = filters + self.action = action + self.target = target + + async def execute(self, wizard: SceneWizard) -> None: + if self.action == SceneAction.enter and self.target is not None: + await wizard.goto(self.target) + elif self.action == SceneAction.leave: + await wizard.leave() + elif self.action == SceneAction.exit: + await wizard.exit() + elif self.action == SceneAction.back: + await wizard.back() + + +class HandlerContainer: + def __init__( + self, + name: str, + handler: CallbackType, + filters: Tuple[CallbackType, ...], + after: Optional[After] = None, + ) -> None: + self.name = name + self.handler = handler + self.filters = filters + self.after = after + + +@dataclass() +class SceneConfig: + state: Optional[str] + """Scene state""" + handlers: List[HandlerContainer] + """Scene handlers""" + actions: Dict[SceneAction, Dict[str, CallableObject]] + """Scene actions""" + reset_data_on_enter: Optional[bool] = None + """Reset scene data on enter""" + reset_history_on_enter: Optional[bool] = None + """Reset scene history on enter""" + callback_query_without_state: Optional[bool] = None + """Allow callback query without state""" + + +async def _empty_handler(*args: Any, **kwargs: Any) -> None: + pass + + +class SceneHandlerWrapper: + def __init__( + self, + scene: Type[Scene], + handler: CallbackType, + after: Optional[After] = None, + ) -> None: + self.scene = scene + self.handler = CallableObject(handler) + self.after = after + + async def __call__( + self, + event: TelegramObject, + **kwargs: Any, + ) -> Any: + state: FSMContext = kwargs["state"] + scenes: ScenesManager = kwargs["scenes"] + event_update: Update = kwargs["event_update"] + scene = self.scene( + wizard=SceneWizard( + scene_config=self.scene.__scene_config__, + manager=scenes, + state=state, + update_type=event_update.event_type, + event=event, + data=kwargs, + ) + ) + + result = await self.handler.call(scene, event, **kwargs) + + if self.after: + action_container = ActionContainer( + "after", + (), + self.after.action, + self.after.scene, + ) + await action_container.execute(scene.wizard) + return result + + def __await__(self) -> Self: + return self + + def __str__(self) -> str: + result = f"SceneHandlerWrapper({self.scene}, {self.handler.callback}" + if self.after: + result += f", after={self.after}" + result += ")" + return result + + +class Scene: + """ + Represents a scene in a conversation flow. + + A scene is a specific state in a conversation where certain actions can take place. + + Each scene has a set of filters that determine when it should be triggered, + and a set of handlers that define the actions to be executed when the scene is active. + + .. note:: + This class is not meant to be used directly. Instead, it should be subclassed + to define custom scenes. + """ + + __scene_config__: ClassVar[SceneConfig] + """Scene configuration.""" + + def __init__( + self, + wizard: SceneWizard, + ) -> None: + self.wizard = wizard + self.wizard.scene = self + + def __init_subclass__(cls, **kwargs: Any) -> None: + state_name = kwargs.pop("state", None) + reset_data_on_enter = kwargs.pop("reset_data_on_enter", None) + reset_history_on_enter = kwargs.pop("reset_history_on_enter", None) + callback_query_without_state = kwargs.pop("callback_query_without_state", None) + + super().__init_subclass__(**kwargs) + + handlers: list[HandlerContainer] = [] + actions: defaultdict[SceneAction, Dict[str, CallableObject]] = defaultdict(dict) + + for base in cls.__bases__: + if not issubclass(base, Scene): + continue + + parent_scene_config = getattr(base, "__scene_config__", None) + if not parent_scene_config: + continue + + handlers.extend(parent_scene_config.handlers) + for action, action_handlers in parent_scene_config.actions.items(): + actions[action].update(action_handlers) + + if reset_data_on_enter is None: + reset_data_on_enter = parent_scene_config.reset_data_on_enter + if reset_history_on_enter is None: + reset_history_on_enter = parent_scene_config.reset_history_on_enter + if callback_query_without_state is None: + callback_query_without_state = parent_scene_config.callback_query_without_state + + for name in vars(cls): + value = getattr(cls, name) + + if scene_handlers := getattr(value, "__aiogram_handler__", None): + handlers.extend(scene_handlers) + if isinstance(value, ObserverDecorator): + handlers.append( + HandlerContainer( + value.name, + _empty_handler, + value.filters, + after=value.after, + ) + ) + if hasattr(value, "__aiogram_action__"): + for action, action_handlers in value.__aiogram_action__.items(): + actions[action].update(action_handlers) + + cls.__scene_config__ = SceneConfig( + state=state_name, + handlers=handlers, + actions=dict(actions), + reset_data_on_enter=reset_data_on_enter, + reset_history_on_enter=reset_history_on_enter, + callback_query_without_state=callback_query_without_state, + ) + + @classmethod + def add_to_router(cls, router: Router) -> None: + """ + Adds the scene to the given router. + + :param router: + :return: + """ + scene_config = cls.__scene_config__ + used_observers = set() + + for handler in scene_config.handlers: + router.observers[handler.name].register( + SceneHandlerWrapper( + cls, + handler.handler, + after=handler.after, + ), + *handler.filters, + flags=extract_flags_from_object(handler.handler), + ) + used_observers.add(handler.name) + + for observer_name in used_observers: + if scene_config.callback_query_without_state and observer_name == "callback_query": + continue + router.observers[observer_name].filter(StateFilter(scene_config.state)) + + @classmethod + def as_router(cls, name: Optional[str] = None) -> Router: + """ + Returns the scene as a router. + + :return: new router + """ + if name is None: + name = ( + f"Scene '{cls.__module__}.{cls.__qualname__}' " + f"for state {cls.__scene_config__.state!r}" + ) + router = Router(name=name) + cls.add_to_router(router) + return router + + @classmethod + def as_handler(cls, **kwargs: Any) -> CallbackType: + """ + Create an entry point handler for the scene, can be used to simplify the handler + that starts the scene. + + >>> router.message.register(MyScene.as_handler(), Command("start")) + """ + + async def enter_to_scene_handler(event: TelegramObject, scenes: ScenesManager) -> None: + await scenes.enter(cls, **kwargs) + + return enter_to_scene_handler + + +class SceneWizard: + """ + A class that represents a wizard for managing scenes in a Telegram bot. + + Instance of this class is passed to each scene as a parameter. + So, you can use it to transition between scenes, get and set data, etc. + + .. note:: + + This class is not meant to be used directly. Instead, it should be used + as a parameter in the scene constructor. + + """ + + def __init__( + self, + scene_config: SceneConfig, + manager: ScenesManager, + state: FSMContext, + update_type: str, + event: TelegramObject, + data: Dict[str, Any], + ): + """ + A class that represents a wizard for managing scenes in a Telegram bot. + + :param scene_config: The configuration of the scene. + :param manager: The scene manager. + :param state: The FSMContext object for storing the state of the scene. + :param update_type: The type of the update event. + :param event: The TelegramObject represents the event. + :param data: Additional data for the scene. + """ + self.scene_config = scene_config + self.manager = manager + self.state = state + self.update_type = update_type + self.event = event + self.data = data + + self.scene: Optional[Scene] = None + + async def enter(self, **kwargs: Any) -> None: + """ + Enter method is used to transition into a scene in the SceneWizard class. + It sets the state, clears data and history if specified, + and triggers entering event of the scene. + + :param kwargs: Additional keyword arguments. + :return: None + """ + loggers.scene.debug("Entering scene %r", self.scene_config.state) + if self.scene_config.reset_data_on_enter: + await self.state.set_data({}) + if self.scene_config.reset_history_on_enter: + await self.manager.history.clear() + await self.state.set_state(self.scene_config.state) + await self._on_action(SceneAction.enter, **kwargs) + + async def leave(self, _with_history: bool = True, **kwargs: Any) -> None: + """ + Leaves the current scene. + This method is used to exit a scene and transition to the next scene. + + :param _with_history: Whether to include history in the snapshot. Defaults to True. + :param kwargs: Additional keyword arguments. + :return: None + + """ + loggers.scene.debug("Leaving scene %r", self.scene_config.state) + if _with_history: + await self.manager.history.snapshot() + await self._on_action(SceneAction.leave, **kwargs) + + async def exit(self, **kwargs: Any) -> None: + """ + Exit the current scene and enter the default scene/state. + + :param kwargs: Additional keyword arguments. + :return: None + """ + loggers.scene.debug("Exiting scene %r", self.scene_config.state) + await self.manager.history.clear() + await self._on_action(SceneAction.exit, **kwargs) + await self.manager.enter(None, _check_active=False, **kwargs) + + async def back(self, **kwargs: Any) -> None: + """ + This method is used to go back to the previous scene. + + :param kwargs: Keyword arguments that can be passed to the method. + :return: None + """ + loggers.scene.debug("Back to previous scene from scene %s", self.scene_config.state) + await self.leave(_with_history=False, **kwargs) + new_scene = await self.manager.history.rollback() + await self.manager.enter(new_scene, _check_active=False, **kwargs) + + async def retake(self, **kwargs: Any) -> None: + """ + This method allows to re-enter the current scene. + + :param kwargs: Additional keyword arguments to pass to the scene. + :return: None + """ + assert self.scene_config.state is not None, "Scene state is not specified" + await self.goto(self.scene_config.state, **kwargs) + + async def goto(self, scene: Union[Type[Scene], str], **kwargs: Any) -> None: + """ + The `goto` method transitions to a new scene. + It first calls the `leave` method to perform any necessary cleanup + in the current scene, then calls the `enter` event to enter the specified scene. + + :param scene: The scene to transition to. Can be either a `Scene` instance + or a string representing the scene. + :param kwargs: Additional keyword arguments to pass to the `enter` + method of the scene manager. + :return: None + """ + await self.leave(**kwargs) + await self.manager.enter(scene, _check_active=False, **kwargs) + + async def _on_action(self, action: SceneAction, **kwargs: Any) -> bool: + if not self.scene: + raise SceneException("Scene is not initialized") + + loggers.scene.debug("Call action %r in scene %r", action.name, self.scene_config.state) + action_config = self.scene_config.actions.get(action, {}) + if not action_config: + loggers.scene.debug( + "Action %r not found in scene %r", action.name, self.scene_config.state + ) + return False + + event_type = self.update_type + if event_type not in action_config: + loggers.scene.debug( + "Action %r for event %r not found in scene %r", + action.name, + event_type, + self.scene_config.state, + ) + return False + + await action_config[event_type].call(self.scene, self.event, **{**self.data, **kwargs}) + return True + + async def set_data(self, data: Dict[str, Any]) -> None: + """ + Sets custom data in the current state. + + :param data: A dictionary containing the custom data to be set in the current state. + :return: None + """ + await self.state.set_data(data=data) + + async def get_data(self) -> Dict[str, Any]: + """ + This method returns the data stored in the current state. + + :return: A dictionary containing the data stored in the scene state. + """ + return await self.state.get_data() + + async def update_data( + self, data: Optional[Dict[str, Any]] = None, **kwargs: Any + ) -> Dict[str, Any]: + """ + This method updates the data stored in the current state + + :param data: Optional dictionary of data to update. + :param kwargs: Additional key-value pairs of data to update. + :return: Dictionary of updated data + """ + if data: + kwargs.update(data) + return await self.state.update_data(data=kwargs) + + async def clear_data(self) -> None: + """ + Clears the data. + + :return: None + """ + await self.set_data({}) + + +class ScenesManager: + """ + The ScenesManager class is responsible for managing scenes in an application. + It provides methods for entering and exiting scenes, as well as retrieving the active scene. + """ + + def __init__( + self, + registry: SceneRegistry, + update_type: str, + event: TelegramObject, + state: FSMContext, + data: Dict[str, Any], + ) -> None: + self.registry = registry + self.update_type = update_type + self.event = event + self.state = state + self.data = data + + self.history = HistoryManager(self.state) + + async def _get_scene(self, scene_type: Optional[Union[Type[Scene], str]]) -> Scene: + scene_type = self.registry.get(scene_type) + return scene_type( + wizard=SceneWizard( + scene_config=scene_type.__scene_config__, + manager=self, + state=self.state, + update_type=self.update_type, + event=self.event, + data=self.data, + ), + ) + + async def _get_active_scene(self) -> Optional[Scene]: + state = await self.state.get_state() + try: + return await self._get_scene(state) + except SceneException: + return None + + async def enter( + self, + scene_type: Optional[Union[Type[Scene], str]], + _check_active: bool = True, + **kwargs: Any, + ) -> None: + """ + Enters the specified scene. + + :param scene_type: Optional Type[Scene] or str representing the scene type to enter. + :param _check_active: Optional bool indicating whether to check if + there is an active scene to exit before entering the new scene. Defaults to True. + :param kwargs: Additional keyword arguments to pass to the scene's wizard.enter() method. + :return: None + """ + if _check_active: + active_scene = await self._get_active_scene() + if active_scene is not None: + await active_scene.wizard.exit(**kwargs) + + try: + scene = await self._get_scene(scene_type) + except SceneException: + if scene_type is not None: + raise + await self.state.set_state(None) + else: + await scene.wizard.enter(**kwargs) + + async def close(self, **kwargs: Any) -> None: + """ + Close method is used to exit the currently active scene in the ScenesManager. + + :param kwargs: Additional keyword arguments passed to the scene's exit method. + :return: None + """ + scene = await self._get_active_scene() + if not scene: + return + await scene.wizard.exit(**kwargs) + + +class SceneRegistry: + """ + A class that represents a registry for scenes in a Telegram bot. + """ + + def __init__(self, router: Router, register_on_add: bool = True) -> None: + """ + Initialize a new instance of the SceneRegistry class. + + :param router: The router instance used for scene registration. + :param register_on_add: Whether to register the scenes to the router when they are added. + """ + self.router = router + self.register_on_add = register_on_add + + self._scenes: Dict[Optional[str], Type[Scene]] = {} + self._setup_middleware(router) + + def _setup_middleware(self, router: Router) -> None: + if isinstance(router, Dispatcher): + # Small optimization for Dispatcher + # - we don't need to set up middleware for all observers + router.update.outer_middleware(self._update_middleware) + return + + for observer in router.observers.values(): + if observer.event_name in {"update", "error"}: + continue + observer.outer_middleware(self._middleware) + + async def _update_middleware( + self, + handler: NextMiddlewareType[TelegramObject], + event: TelegramObject, + data: Dict[str, Any], + ) -> Any: + assert isinstance(event, Update), "Event must be an Update instance" + + data["scenes"] = ScenesManager( + registry=self, + update_type=event.event_type, + event=event.event, + state=data["state"], + data=data, + ) + return await handler(event, data) + + async def _middleware( + self, + handler: NextMiddlewareType[TelegramObject], + event: TelegramObject, + data: Dict[str, Any], + ) -> Any: + update: Update = data["event_update"] + data["scenes"] = ScenesManager( + registry=self, + update_type=update.event_type, + event=event, + state=data["state"], + data=data, + ) + return await handler(event, data) + + def add(self, *scenes: Type[Scene], router: Optional[Router] = None) -> None: + """ + This method adds the specified scenes to the registry + and optionally registers it to the router. + + If a scene with the same state already exists in the registry, a SceneException is raised. + + .. warning:: + + If the router is not specified, the scenes will not be registered to the router. + You will need to include the scenes manually to the router or use the register method. + + :param scenes: A variable length parameter that accepts one or more types of scenes. + These scenes are instances of the Scene class. + :param router: An optional parameter that specifies the router + to which the scenes should be added. + :return: None + """ + if not scenes: + raise ValueError("At least one scene must be specified") + + for scene in scenes: + if scene.__scene_config__.state in self._scenes: + raise SceneException( + f"Scene with state {scene.__scene_config__.state!r} already exists" + ) + + self._scenes[scene.__scene_config__.state] = scene + + if router: + router.include_router(scene.as_router()) + elif self.register_on_add: + self.router.include_router(scene.as_router()) + + def register(self, *scenes: Type[Scene]) -> None: + """ + Registers one or more scenes to the SceneRegistry. + + :param scenes: One or more scene classes to register. + :return: None + """ + self.add(*scenes, router=self.router) + + def get(self, scene: Optional[Union[Type[Scene], str]]) -> Type[Scene]: + """ + This method returns the registered Scene object for the specified scene. + The scene parameter can be either a Scene object or a string representing + the name of the scene. If a Scene object is provided, the state attribute + of the SceneConfig object associated with the Scene object will be used as the scene name. + If None or an invalid type is provided, a SceneException will be raised. + + If the specified scene is not registered in the SceneRegistry object, + a SceneException will be raised. + + :param scene: A Scene object or a string representing the name of the scene. + :return: The registered Scene object corresponding to the given scene parameter. + + """ + if inspect.isclass(scene) and issubclass(scene, Scene): + scene = scene.__scene_config__.state + if isinstance(scene, State): + scene = scene.state + if scene is not None and not isinstance(scene, str): + raise SceneException("Scene must be a subclass of Scene or a string") + + try: + return self._scenes[scene] + except KeyError: + raise SceneException(f"Scene {scene!r} is not registered") + + +@dataclass +class After: + action: SceneAction + scene: Optional[Union[Type[Scene], str]] = None + + @classmethod + def exit(cls) -> After: + return cls(action=SceneAction.exit) + + @classmethod + def back(cls) -> After: + return cls(action=SceneAction.back) + + @classmethod + def goto(cls, scene: Optional[Union[Type[Scene], str]]) -> After: + return cls(action=SceneAction.enter, scene=scene) + + +class ObserverMarker: + def __init__(self, name: str) -> None: + self.name = name + + def __call__( + self, + *filters: CallbackType, + after: Optional[After] = None, + ) -> ObserverDecorator: + return ObserverDecorator( + self.name, + filters, + after=after, + ) + + def enter(self, *filters: CallbackType) -> ObserverDecorator: + return ObserverDecorator(self.name, filters, action=SceneAction.enter) + + def leave(self) -> ObserverDecorator: + return ObserverDecorator(self.name, (), action=SceneAction.leave) + + def exit(self) -> ObserverDecorator: + return ObserverDecorator(self.name, (), action=SceneAction.exit) + + def back(self) -> ObserverDecorator: + return ObserverDecorator(self.name, (), action=SceneAction.back) + + +class OnMarker: + """ + The `OnMarker` class is used as a marker class to define different + types of events in the Scenes. + + Attributes: + + - :code:`message`: Event marker for handling `Message` events. + - :code:`edited_message`: Event marker for handling edited `Message` events. + - :code:`channel_post`: Event marker for handling channel `Post` events. + - :code:`edited_channel_post`: Event marker for handling edited channel `Post` events. + - :code:`inline_query`: Event marker for handling `InlineQuery` events. + - :code:`chosen_inline_result`: Event marker for handling chosen `InlineResult` events. + - :code:`callback_query`: Event marker for handling `CallbackQuery` events. + - :code:`shipping_query`: Event marker for handling `ShippingQuery` events. + - :code:`pre_checkout_query`: Event marker for handling `PreCheckoutQuery` events. + - :code:`poll`: Event marker for handling `Poll` events. + - :code:`poll_answer`: Event marker for handling `PollAnswer` events. + - :code:`my_chat_member`: Event marker for handling my chat `Member` events. + - :code:`chat_member`: Event marker for handling chat `Member` events. + - :code:`chat_join_request`: Event marker for handling chat `JoinRequest` events. + - :code:`error`: Event marker for handling `Error` events. + + .. note:: + + This is a marker class and does not contain any methods or implementation logic. + """ + + message = ObserverMarker("message") + edited_message = ObserverMarker("edited_message") + channel_post = ObserverMarker("channel_post") + edited_channel_post = ObserverMarker("edited_channel_post") + inline_query = ObserverMarker("inline_query") + chosen_inline_result = ObserverMarker("chosen_inline_result") + callback_query = ObserverMarker("callback_query") + shipping_query = ObserverMarker("shipping_query") + pre_checkout_query = ObserverMarker("pre_checkout_query") + poll = ObserverMarker("poll") + poll_answer = ObserverMarker("poll_answer") + my_chat_member = ObserverMarker("my_chat_member") + chat_member = ObserverMarker("chat_member") + chat_join_request = ObserverMarker("chat_join_request") + + +on = OnMarker() diff --git a/env/Lib/site-packages/aiogram/fsm/state.py b/env/Lib/site-packages/aiogram/fsm/state.py new file mode 100644 index 0000000..6b8c737 --- /dev/null +++ b/env/Lib/site-packages/aiogram/fsm/state.py @@ -0,0 +1,172 @@ +import inspect +from typing import Any, Iterator, Optional, Tuple, Type, no_type_check + +from aiogram.types import TelegramObject + + +class State: + """ + State object + """ + + def __init__(self, state: Optional[str] = None, group_name: Optional[str] = None) -> None: + self._state = state + self._group_name = group_name + self._group: Optional[Type[StatesGroup]] = None + + @property + def group(self) -> "Type[StatesGroup]": + if not self._group: + raise RuntimeError("This state is not in any group.") + return self._group + + @property + def state(self) -> Optional[str]: + if self._state is None or self._state == "*": + return self._state + + if self._group_name is None and self._group: + group = self._group.__full_group_name__ + elif self._group_name: + group = self._group_name + else: + group = "@" + + return f"{group}:{self._state}" + + def set_parent(self, group: "Type[StatesGroup]") -> None: + if not issubclass(group, StatesGroup): + raise ValueError("Group must be subclass of StatesGroup") + self._group = group + + def __set_name__(self, owner: "Type[StatesGroup]", name: str) -> None: + if self._state is None: + self._state = name + self.set_parent(owner) + + def __str__(self) -> str: + return f"" + + __repr__ = __str__ + + def __call__(self, event: TelegramObject, raw_state: Optional[str] = None) -> bool: + if self.state == "*": + return True + return raw_state == self.state + + def __eq__(self, other: Any) -> bool: + if isinstance(other, self.__class__): + return self.state == other.state + if isinstance(other, str): + return self.state == other + return NotImplemented + + def __hash__(self) -> int: + return hash(self.state) + + +class StatesGroupMeta(type): + __parent__: "Optional[Type[StatesGroup]]" + __childs__: "Tuple[Type[StatesGroup], ...]" + __states__: Tuple[State, ...] + __state_names__: Tuple[str, ...] + __all_childs__: Tuple[Type["StatesGroup"], ...] + __all_states__: Tuple[State, ...] + __all_states_names__: Tuple[str, ...] + + @no_type_check + def __new__(mcs, name, bases, namespace, **kwargs): + cls = super().__new__(mcs, name, bases, namespace) + + states = [] + childs = [] + + for name, arg in namespace.items(): + if isinstance(arg, State): + states.append(arg) + elif inspect.isclass(arg) and issubclass(arg, StatesGroup): + child = cls._prepare_child(arg) + childs.append(child) + + cls.__parent__ = None + cls.__childs__ = tuple(childs) + cls.__states__ = tuple(states) + cls.__state_names__ = tuple(state.state for state in states) + + cls.__all_childs__ = cls._get_all_childs() + cls.__all_states__ = cls._get_all_states() + + # In order to ensure performance, we calculate this parameter + # in advance already during the production of the class. + # Depending on the relationship, it should be recalculated + cls.__all_states_names__ = cls._get_all_states_names() + + return cls + + @property + def __full_group_name__(cls) -> str: + if cls.__parent__: + return ".".join((cls.__parent__.__full_group_name__, cls.__name__)) + return cls.__name__ + + def _prepare_child(cls, child: Type["StatesGroup"]) -> Type["StatesGroup"]: + """Prepare child. + + While adding `cls` for its children, we also need to recalculate + the parameter `__all_states_names__` for each child + `StatesGroup`. Since the child class appears before the + parent, at the time of adding the parent, the child's + `__all_states_names__` is already recorded without taking into + account the name of current parent. + """ + child.__parent__ = cls # type: ignore[assignment] + child.__all_states_names__ = child._get_all_states_names() + return child + + def _get_all_childs(cls) -> Tuple[Type["StatesGroup"], ...]: + result = cls.__childs__ + for child in cls.__childs__: + result += child.__childs__ + return result + + def _get_all_states(cls) -> Tuple[State, ...]: + result = cls.__states__ + for group in cls.__childs__: + result += group.__all_states__ + return result + + def _get_all_states_names(cls) -> Tuple[str, ...]: + return tuple(state.state for state in cls.__all_states__ if state.state) + + def __contains__(cls, item: Any) -> bool: + if isinstance(item, str): + return item in cls.__all_states_names__ + if isinstance(item, State): + return item in cls.__all_states__ + if isinstance(item, StatesGroupMeta): + return item in cls.__all_childs__ + return False + + def __str__(self) -> str: + return f"" + + def __iter__(self) -> Iterator[State]: + return iter(self.__all_states__) + + +class StatesGroup(metaclass=StatesGroupMeta): + @classmethod + def get_root(cls) -> Type["StatesGroup"]: + if cls.__parent__ is None: + return cls + return cls.__parent__.get_root() + + def __call__(self, event: TelegramObject, raw_state: Optional[str] = None) -> bool: + return raw_state in type(self).__all_states_names__ + + def __str__(self) -> str: + return f"StatesGroup {type(self).__full_group_name__}" + + +default_state = State() +any_state = State(state="*") diff --git a/env/Lib/site-packages/aiogram/fsm/storage/__init__.py b/env/Lib/site-packages/aiogram/fsm/storage/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/aiogram/fsm/storage/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/fsm/storage/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..accd5184f4ff788b6f29dfe3e40e986c8c88f4de GIT binary patch literal 189 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 NXcMcS?!e%gz`U_Q$z1 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 F_z!EN5pDng literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/fsm/storage/__pycache__/redis.cpython-311.pyc b/env/Lib/site-packages/aiogram/fsm/storage/__pycache__/redis.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0b86cfe153311d91f509c9df94bb57159eeac5c4 GIT binary patch literal 9175 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 str: + """ + Build key to be used in storage's db queries + + :param key: contextual key + :param part: part of the record + :return: key to be used in storage's db queries + """ + pass + + +class DefaultKeyBuilder(KeyBuilder): + """ + Simple key builder with default prefix. + + Generates a colon-joined string with prefix, chat_id, user_id, + optional bot_id, business_connection_id, destiny and field. + + Format: + :code:`::::::` + """ + + def __init__( + self, + *, + prefix: str = "fsm", + separator: str = ":", + with_bot_id: bool = False, + with_business_connection_id: bool = False, + with_destiny: bool = False, + ) -> None: + """ + :param prefix: prefix for all records + :param separator: separator + :param with_bot_id: include Bot id in the key + :param with_business_connection_id: include business connection id + :param with_destiny: include destiny key + """ + self.prefix = prefix + self.separator = separator + self.with_bot_id = with_bot_id + self.with_business_connection_id = with_business_connection_id + self.with_destiny = with_destiny + + def build( + self, + key: StorageKey, + part: Optional[Literal["data", "state", "lock"]] = None, + ) -> str: + parts = [self.prefix] + if self.with_bot_id: + parts.append(str(key.bot_id)) + if self.with_business_connection_id and key.business_connection_id: + parts.append(str(key.business_connection_id)) + parts.append(str(key.chat_id)) + if key.thread_id: + parts.append(str(key.thread_id)) + parts.append(str(key.user_id)) + if self.with_destiny: + parts.append(key.destiny) + elif key.destiny != DEFAULT_DESTINY: + error_message = ( + "Default key builder is not configured to use key destiny other than the default." + "\n\nProbably, you should set `with_destiny=True` in for DefaultKeyBuilder." + ) + raise ValueError(error_message) + if part: + parts.append(part) + return self.separator.join(parts) + + +class BaseStorage(ABC): + """ + Base class for all FSM storages + """ + + @abstractmethod + async def set_state(self, key: StorageKey, state: StateType = None) -> None: + """ + Set state for specified key + + :param key: storage key + :param state: new state + """ + pass + + @abstractmethod + async def get_state(self, key: StorageKey) -> Optional[str]: + """ + Get key state + + :param key: storage key + :return: current state + """ + pass + + @abstractmethod + async def set_data(self, key: StorageKey, data: Dict[str, Any]) -> None: + """ + Write data (replace) + + :param key: storage key + :param data: new data + """ + pass + + @abstractmethod + async def get_data(self, key: StorageKey) -> Dict[str, Any]: + """ + Get current data for key + + :param key: storage key + :return: current data + """ + pass + + async def update_data(self, key: StorageKey, data: Dict[str, Any]) -> Dict[str, Any]: + """ + Update date in the storage for key (like dict.update) + + :param key: storage key + :param data: partial data + :return: new data + """ + current_data = await self.get_data(key=key) + current_data.update(data) + await self.set_data(key=key, data=current_data) + return current_data.copy() + + @abstractmethod + async def close(self) -> None: # pragma: no cover + """ + Close storage (database connection, file or etc.) + """ + pass + + +class BaseEventIsolation(ABC): + @abstractmethod + @asynccontextmanager + async def lock(self, key: StorageKey) -> AsyncGenerator[None, None]: + """ + Isolate events with lock. + Will be used as context manager + + :param key: storage key + :return: An async generator + """ + yield None + + @abstractmethod + async def close(self) -> None: + pass diff --git a/env/Lib/site-packages/aiogram/fsm/storage/memory.py b/env/Lib/site-packages/aiogram/fsm/storage/memory.py new file mode 100644 index 0000000..d80a9ff --- /dev/null +++ b/env/Lib/site-packages/aiogram/fsm/storage/memory.py @@ -0,0 +1,74 @@ +from asyncio import Lock +from collections import defaultdict +from contextlib import asynccontextmanager +from dataclasses import dataclass, field +from typing import Any, AsyncGenerator, DefaultDict, Dict, Hashable, Optional + +from aiogram.fsm.state import State +from aiogram.fsm.storage.base import ( + BaseEventIsolation, + BaseStorage, + StateType, + StorageKey, +) + + +@dataclass +class MemoryStorageRecord: + data: Dict[str, Any] = field(default_factory=dict) + state: Optional[str] = None + + +class MemoryStorage(BaseStorage): + """ + Default FSM storage, stores all data in :class:`dict` and loss everything on shutdown + + .. warning:: + + Is not recommended using in production in due to you will lose all data + when your bot restarts + """ + + def __init__(self) -> None: + self.storage: DefaultDict[StorageKey, MemoryStorageRecord] = defaultdict( + MemoryStorageRecord + ) + + async def close(self) -> None: + pass + + async def set_state(self, key: StorageKey, state: StateType = None) -> None: + self.storage[key].state = state.state if isinstance(state, State) else state + + async def get_state(self, key: StorageKey) -> Optional[str]: + return self.storage[key].state + + async def set_data(self, key: StorageKey, data: Dict[str, Any]) -> None: + self.storage[key].data = data.copy() + + async def get_data(self, key: StorageKey) -> Dict[str, Any]: + return self.storage[key].data.copy() + + +class DisabledEventIsolation(BaseEventIsolation): + @asynccontextmanager + async def lock(self, key: StorageKey) -> AsyncGenerator[None, None]: + yield + + async def close(self) -> None: + pass + + +class SimpleEventIsolation(BaseEventIsolation): + def __init__(self) -> None: + # TODO: Unused locks cleaner is needed + self._locks: DefaultDict[Hashable, Lock] = defaultdict(Lock) + + @asynccontextmanager + async def lock(self, key: StorageKey) -> AsyncGenerator[None, None]: + lock = self._locks[key] + async with lock: + yield + + async def close(self) -> None: + self._locks.clear() diff --git a/env/Lib/site-packages/aiogram/fsm/storage/mongo.py b/env/Lib/site-packages/aiogram/fsm/storage/mongo.py new file mode 100644 index 0000000..b4b1eea --- /dev/null +++ b/env/Lib/site-packages/aiogram/fsm/storage/mongo.py @@ -0,0 +1,130 @@ +from typing import Any, Dict, Optional, cast + +from motor.motor_asyncio import AsyncIOMotorClient + +from aiogram.fsm.state import State +from aiogram.fsm.storage.base import ( + BaseStorage, + DefaultKeyBuilder, + KeyBuilder, + StateType, + StorageKey, +) + + +class MongoStorage(BaseStorage): + """ + MongoDB storage required :code:`motor` package installed (:code:`pip install motor`) + """ + + def __init__( + self, + client: AsyncIOMotorClient, + key_builder: Optional[KeyBuilder] = None, + db_name: str = "aiogram_fsm", + collection_name: str = "states_and_data", + ) -> None: + """ + :param client: Instance of AsyncIOMotorClient + :param key_builder: builder that helps to convert contextual key to string + :param db_name: name of the MongoDB database for FSM + :param collection_name: name of the collection for storing FSM states and data + """ + if key_builder is None: + key_builder = DefaultKeyBuilder() + self._client = client + self._database = self._client[db_name] + self._collection = self._database[collection_name] + self._key_builder = key_builder + + @classmethod + def from_url( + cls, url: str, connection_kwargs: Optional[Dict[str, Any]] = None, **kwargs: Any + ) -> "MongoStorage": + """ + Create an instance of :class:`MongoStorage` with specifying the connection string + + :param url: for example :code:`mongodb://user:password@host:port` + :param connection_kwargs: see :code:`motor` docs + :param kwargs: arguments to be passed to :class:`MongoStorage` + :return: an instance of :class:`MongoStorage` + """ + if connection_kwargs is None: + connection_kwargs = {} + client = AsyncIOMotorClient(url, **connection_kwargs) + return cls(client=client, **kwargs) + + async def close(self) -> None: + """Cleanup client resources and disconnect from MongoDB.""" + self._client.close() + + def resolve_state(self, value: StateType) -> Optional[str]: + if value is None: + return None + if isinstance(value, State): + return value.state + return str(value) + + async def set_state(self, key: StorageKey, state: StateType = None) -> None: + document_id = self._key_builder.build(key) + if state is None: + updated = await self._collection.find_one_and_update( + filter={"_id": document_id}, + update={"$unset": {"state": 1}}, + projection={"_id": 0}, + return_document=True, + ) + if updated == {}: + await self._collection.delete_one({"_id": document_id}) + else: + await self._collection.update_one( + filter={"_id": document_id}, + update={"$set": {"state": self.resolve_state(state)}}, + upsert=True, + ) + + async def get_state(self, key: StorageKey) -> Optional[str]: + document_id = self._key_builder.build(key) + document = await self._collection.find_one({"_id": document_id}) + if document is None: + return None + return document.get("state") + + async def set_data(self, key: StorageKey, data: Dict[str, Any]) -> None: + document_id = self._key_builder.build(key) + if not data: + updated = await self._collection.find_one_and_update( + filter={"_id": document_id}, + update={"$unset": {"data": 1}}, + projection={"_id": 0}, + return_document=True, + ) + if updated == {}: + await self._collection.delete_one({"_id": document_id}) + else: + await self._collection.update_one( + filter={"_id": document_id}, + update={"$set": {"data": data}}, + upsert=True, + ) + + async def get_data(self, key: StorageKey) -> Dict[str, Any]: + document_id = self._key_builder.build(key) + document = await self._collection.find_one({"_id": document_id}) + if document is None or not document.get("data"): + return {} + return cast(Dict[str, Any], document["data"]) + + async def update_data(self, key: StorageKey, data: Dict[str, Any]) -> Dict[str, Any]: + document_id = self._key_builder.build(key) + update_with = {f"data.{key}": value for key, value in data.items()} + update_result = await self._collection.find_one_and_update( + filter={"_id": document_id}, + update={"$set": update_with}, + upsert=True, + return_document=True, + projection={"_id": 0}, + ) + if not update_result: + await self._collection.delete_one({"_id": document_id}) + return update_result.get("data", {}) diff --git a/env/Lib/site-packages/aiogram/fsm/storage/redis.py b/env/Lib/site-packages/aiogram/fsm/storage/redis.py new file mode 100644 index 0000000..edcf9d6 --- /dev/null +++ b/env/Lib/site-packages/aiogram/fsm/storage/redis.py @@ -0,0 +1,169 @@ +import json +from contextlib import asynccontextmanager +from typing import Any, AsyncGenerator, Callable, Dict, Optional, cast + +from redis.asyncio.client import Redis +from redis.asyncio.connection import ConnectionPool +from redis.asyncio.lock import Lock +from redis.typing import ExpiryT + +from aiogram.fsm.state import State +from aiogram.fsm.storage.base import ( + BaseEventIsolation, + BaseStorage, + DefaultKeyBuilder, + KeyBuilder, + StateType, + StorageKey, +) + +DEFAULT_REDIS_LOCK_KWARGS = {"timeout": 60} +_JsonLoads = Callable[..., Any] +_JsonDumps = Callable[..., str] + + +class RedisStorage(BaseStorage): + """ + Redis storage required :code:`redis` package installed (:code:`pip install redis`) + """ + + def __init__( + self, + redis: Redis, + key_builder: Optional[KeyBuilder] = None, + state_ttl: Optional[ExpiryT] = None, + data_ttl: Optional[ExpiryT] = None, + json_loads: _JsonLoads = json.loads, + json_dumps: _JsonDumps = json.dumps, + ) -> None: + """ + :param redis: Instance of Redis connection + :param key_builder: builder that helps to convert contextual key to string + :param state_ttl: TTL for state records + :param data_ttl: TTL for data records + """ + if key_builder is None: + key_builder = DefaultKeyBuilder() + self.redis = redis + self.key_builder = key_builder + self.state_ttl = state_ttl + self.data_ttl = data_ttl + self.json_loads = json_loads + self.json_dumps = json_dumps + + @classmethod + def from_url( + cls, url: str, connection_kwargs: Optional[Dict[str, Any]] = None, **kwargs: Any + ) -> "RedisStorage": + """ + Create an instance of :class:`RedisStorage` with specifying the connection string + + :param url: for example :code:`redis://user:password@host:port/db` + :param connection_kwargs: see :code:`redis` docs + :param kwargs: arguments to be passed to :class:`RedisStorage` + :return: an instance of :class:`RedisStorage` + """ + if connection_kwargs is None: + connection_kwargs = {} + pool = ConnectionPool.from_url(url, **connection_kwargs) + redis = Redis(connection_pool=pool) + return cls(redis=redis, **kwargs) + + def create_isolation(self, **kwargs: Any) -> "RedisEventIsolation": + return RedisEventIsolation(redis=self.redis, key_builder=self.key_builder, **kwargs) + + async def close(self) -> None: + await self.redis.aclose(close_connection_pool=True) + + async def set_state( + self, + key: StorageKey, + state: StateType = None, + ) -> None: + redis_key = self.key_builder.build(key, "state") + if state is None: + await self.redis.delete(redis_key) + else: + await self.redis.set( + redis_key, + cast(str, state.state if isinstance(state, State) else state), + ex=self.state_ttl, + ) + + async def get_state( + self, + key: StorageKey, + ) -> Optional[str]: + redis_key = self.key_builder.build(key, "state") + value = await self.redis.get(redis_key) + if isinstance(value, bytes): + return value.decode("utf-8") + return cast(Optional[str], value) + + async def set_data( + self, + key: StorageKey, + data: Dict[str, Any], + ) -> None: + redis_key = self.key_builder.build(key, "data") + if not data: + await self.redis.delete(redis_key) + return + await self.redis.set( + redis_key, + self.json_dumps(data), + ex=self.data_ttl, + ) + + async def get_data( + self, + key: StorageKey, + ) -> Dict[str, Any]: + redis_key = self.key_builder.build(key, "data") + value = await self.redis.get(redis_key) + if value is None: + return {} + if isinstance(value, bytes): + value = value.decode("utf-8") + return cast(Dict[str, Any], self.json_loads(value)) + + +class RedisEventIsolation(BaseEventIsolation): + def __init__( + self, + redis: Redis, + key_builder: Optional[KeyBuilder] = None, + lock_kwargs: Optional[Dict[str, Any]] = None, + ) -> None: + if key_builder is None: + key_builder = DefaultKeyBuilder() + if lock_kwargs is None: + lock_kwargs = DEFAULT_REDIS_LOCK_KWARGS + self.redis = redis + self.key_builder = key_builder + self.lock_kwargs = lock_kwargs + + @classmethod + def from_url( + cls, + url: str, + connection_kwargs: Optional[Dict[str, Any]] = None, + **kwargs: Any, + ) -> "RedisEventIsolation": + if connection_kwargs is None: + connection_kwargs = {} + pool = ConnectionPool.from_url(url, **connection_kwargs) + redis = Redis(connection_pool=pool) + return cls(redis=redis, **kwargs) + + @asynccontextmanager + async def lock( + self, + key: StorageKey, + ) -> AsyncGenerator[None, None]: + redis_key = self.key_builder.build(key, "lock") + async with self.redis.lock(name=redis_key, **self.lock_kwargs, lock_class=Lock): + yield None + + async def close(self) -> None: + pass diff --git a/env/Lib/site-packages/aiogram/fsm/strategy.py b/env/Lib/site-packages/aiogram/fsm/strategy.py new file mode 100644 index 0000000..da2d94e --- /dev/null +++ b/env/Lib/site-packages/aiogram/fsm/strategy.py @@ -0,0 +1,37 @@ +from enum import Enum, auto +from typing import Optional, Tuple + + +class FSMStrategy(Enum): + """ + FSM strategy for storage key generation. + """ + + USER_IN_CHAT = auto() + """State will be stored for each user in chat.""" + CHAT = auto() + """State will be stored for each chat globally without separating by users.""" + GLOBAL_USER = auto() + """State will be stored globally for each user globally.""" + USER_IN_TOPIC = auto() + """State will be stored for each user in chat and topic.""" + CHAT_TOPIC = auto() + """State will be stored for each chat and topic, but not separated by users.""" + + +def apply_strategy( + strategy: FSMStrategy, + chat_id: int, + user_id: int, + thread_id: Optional[int] = None, +) -> Tuple[int, int, Optional[int]]: + if strategy == FSMStrategy.CHAT: + return chat_id, chat_id, None + if strategy == FSMStrategy.GLOBAL_USER: + return user_id, user_id, None + if strategy == FSMStrategy.USER_IN_TOPIC: + return chat_id, user_id, thread_id + if strategy == FSMStrategy.CHAT_TOPIC: + return chat_id, chat_id, thread_id + + return chat_id, user_id, None diff --git a/env/Lib/site-packages/aiogram/handlers/__init__.py b/env/Lib/site-packages/aiogram/handlers/__init__.py new file mode 100644 index 0000000..5483788 --- /dev/null +++ b/env/Lib/site-packages/aiogram/handlers/__init__.py @@ -0,0 +1,25 @@ +from .base import BaseHandler, BaseHandlerMixin +from .callback_query import CallbackQueryHandler +from .chat_member import ChatMemberHandler +from .chosen_inline_result import ChosenInlineResultHandler +from .error import ErrorHandler +from .inline_query import InlineQueryHandler +from .message import MessageHandler, MessageHandlerCommandMixin +from .poll import PollHandler +from .pre_checkout_query import PreCheckoutQueryHandler +from .shipping_query import ShippingQueryHandler + +__all__ = ( + "BaseHandler", + "BaseHandlerMixin", + "CallbackQueryHandler", + "ChatMemberHandler", + "ChosenInlineResultHandler", + "ErrorHandler", + "InlineQueryHandler", + "MessageHandler", + "MessageHandlerCommandMixin", + "PollHandler", + "PreCheckoutQueryHandler", + "ShippingQueryHandler", +) diff --git a/env/Lib/site-packages/aiogram/handlers/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/handlers/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..829da162a2147f825b78161c297f81ee2e70a53c GIT binary patch literal 1030 zcmZuvPjAyO9CgyPX`4S=yN(Ia1lJ;<+$I46iGTzWMS~rXtVmXxm^P}NWKN3MjWb_> z10MkK1^5&ka*TZC#BI`UJ7K#SUBr^7r}wk1pP!%o-EsOrd_TYa`f$4iz;9Vxe0nX; zz6kLZL?F@#pc>Su4s}h|I%!b@8cMfFn|5GFX@i)w3%g3UNssnnU+E69s10qUP2x}& zx^xR}sk%$H=>QIt?vWwgfjdg~$%yX4U7;;_EwYcm*!iOgLt~v=&w?Dk43dao#F3C^d_ANuc8w)DL;5=r^X6$^@#p;=n^IQi(mj%R)z7x-Q# z-h;TK+z;Y(&H_4FtY1(*LE=bpfzbWz79yb2X~ zP&QG4J7p6UcvLn~fm>x06}VeAQGuuBRj9yz*+c~n$|nAIb!s@4{@Ij2yD1L!7l)-X Ai2wiq literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/handlers/__pycache__/base.cpython-311.pyc b/env/Lib/site-packages/aiogram/handlers/__pycache__/base.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f4e3835b75aa8964d33f9ed15c8adf05ddbfe3b8 GIT binary patch literal 2918 zcmb7GU1%It6ux)t?m zlco?g52+OGLnT2A<|!HiA|m?glTSWuBw!dQ1VqrcE$LIAJm=14e@uMv&Yd&oo^y8Q z-0%F{{W=l}5*R;z`Rl}xLdYMu*d3bB(4Aj^St1s(Xr2^khEn9Eyi|}gazV)`VlC&@ zf|k(=flQ#FXY@i#rlka98cxgk1~R1zB689g|mKKkIN;E!(Zo2uXzh#$|$f zA=9>tuIc8Awv&)N`St#k7d6Knmz!C)z}zcEE1`Lj(aUe0HBxV$O`RJ`4}z6F<0%8V ztm_2^nay}E>jg$j$yf6?{mXtwHtcvM}dJ11bdL>S3X zi)5rrgvmT?QKneZ8PHfVaEjp65daHZ*Syw#(_wF#wv}gmICnE=^B9FvIYIhEXV5r9ARs!?;#5^S*{-ti70FG@xP_Yh(w+ za>0Mae;x3LZOR5N4ZU*L&$UFYHf4Z2|w)O?yCd0R@Yi`LqCAutk-@w zLfn?!-#`&5&0Xaqno!dmjd=u!Cqn|y9)lu{=WNF{?JSE!Pk>03Yzstj_X-5BXuIsD z3uP3jCN;-xaYT><_{0leEZJ_Zz|L}BW2BSuHLX(iDx zy|CzGhQCTE0$q-q5ny}rBy-oOfY-qt_-V=$z|OWe0_(p30e4;kGEe@Db$tHD^1y?k zuZF)E{-*c4fggr`8vcIx=j6ue3!A4eY;;}R?7FxS8`+GFl=Tq-ViSJ&wU04v@vJ;Y zD5fsd6Mqht{2&r+<_%7HnqS$?e)%%=*TKa33oeX%cv0E=Neqh!SsEB9ZL$K-y`#B< ztuzF-Zrf~AbsO?D2_{|(wEP<;R{6j8z!AII1C7AeZ2LgvbOC|dk9B-@>yuk|Zr{EA zd+hjcvEv)D-pyEVS??8_N++~>U*nkXqN(v`kvjqe91%Pg%r1{H-{r9hBtje;4L^Y7 zDIi|JFsx!0oIZ*xeVP}i8Fyzym5Get*lNTU#XkHfi30TE~zgf*GP1tMJtl34$umz(?>Fh7v8NZqQZu%qhM2~H5(z)h}Kz=s2V{NpP)hK z!Uw)oqiOjozwnNu7DFS>CI9pm*omyK;rT>A?~@8{EeMSE9cI!56(XEh^P1@P;5m(zvPz!)mBqq^|e5^_0-q=a$wj- zVA^I-u`5B^cF9w0m1|y!>z$IP?rBdT`mC5|m(!TR%_$wgX=iYi z99Nye>1S{YUKywx$;BB)Ia9W&5K^VkzS!Y{)2^g#(1E%>lah8KLET&j`V9&}cQS>f zRZVAo@PGw9pEuJEE@N5LjXb{5_9J(<*`&Qeyc2~P7~|MFA_^$$M%#h~)?`824SJD? z>AWgur(0H@JX?*@_e9i>xv(asI%%ovjiM+7W{kE5Iq~&*c^Xq5leL)~gf8`XCuhDc zx!-BfjT`i4IA{W0E6tLW1&{k8bV1Idp|8Sw{2G{j@-4YngzgnM*c)Z|R#ED0Ntxee znf7=2eICXZ>gDv|blojrjZ&hg!K6||pDKxl)k$2NzPR&#v-MRZc3Yc~*A2H@yM4jp zNI2~%Zt?Jb>*H>_CA%@-=)oz6lPp{LmRy@`$+cNQt=>SKhoy%r^R$~*xeOSIz(-_U zB}*3{4-e0;jm))U7$PqzP^L0&$~=LB>@J>^N1TIXiIGRd67(`%#4F&6SHTQlpUWek zvWhcKvA8lauZRl}cu5v-7W+4kg~wucmV$=Er|VB@#nxbWSf9&e2J;5;K~aibdHnsz zTuJGC(pXGP#|c@$9Ve+eP7ry0AN@rKE)(FB`qZ2N*9-9K!Gqt_pB^G=b!tvPPmE@jW4$Pm%G$2L3!RkX zK@aX!$~jp&{Zl4%#MCCkfaOx)f4xi|q@L-Ps(}Y>s?ZDb-Aw!&;wl92D$5_hj8#QZ zj>v`4>~lmek7l30$ogpZIU=8p{_h!=*A(D=)*M{_<>BGwcYc@8G5GHsL|XfQWYzY! literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/handlers/__pycache__/chat_member.cpython-311.pyc b/env/Lib/site-packages/aiogram/handlers/__pycache__/chat_member.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..809e5134b14e3e51b5919c15b9955bcb76d9f5ed GIT binary patch literal 985 zcmZuvy=xRf6o0c{w%=KEDOWj&fMja-P?0!FOZ;+ zBBgx-_7O=h{t*^eqzGFDtn4nFRVv@??p+M#?d+T1y!UwT_ukCcYIOoozJK}ITqFR$ z^kF1U35Kf(_J9K?5yZqNL}Mc|V$(NsY(`dW`*!U34gmvR0=IU7+rkv~%~3WG=~!ku?etNhl-8p+IOi%YmoE;1!vu?~-ftQpz0r8Snm5phGvl`dzg;F-0egbd3p z`DT`fVI9F92=EC9-{8bIg~bhFHw|v?S_kMoEJFc&hg(?R{4R4{^gO9L2cCC-&kOf)BUhO5aqvEo8^Kb-+nrXh(UUAqByA*VAUd1D>vkhh?Nr?D zvT%d7gbG+YX-O6@tQGTA3%Und^ic0^$tldcefxaGW&iat10A5MsCM9FX7=;;(ac=m zog1P7mTQ&FrL@ChL1{KYX`Jw0r12D`A9^e*JrzoM5~A7d%A_k~x+V3?%4>fEIivBk zR_;hu5U3ZZcE;bpFl=`KTDjm%4-8_@?>`s-Zs+RMMAzcO_Ax zpk!A8*vB_-X35nSp;r1MrZtktPv+)vD9<^ZK6e7wqpT(+*XLJ5PJ(hGrk7P2pg-p9G)#mG)AMC1$C_Vpb1}y=-oiG z1MgvN0Id!37GaMpU`|7j*~?*M(O}bh)m*lCGop7}PJP{3q1~KBp5Ji)1gcSA<`O@N#Np1VXoS=b zU649-KnfB|r$W`8zk(q{2jr;|VqkL>rcS)G9j8&@Y=8HjzjuD$dw2daK0X3CzJ2~) zeoX*=N~brp*yygH(FPlA;y{fQ36ZwqC^faH5>Vhd*y+=@fPNsXQEDjIEIP$V`K6`K?>jjgbBS;4fa zBV_$k4h zvXIO37pu<}jF&FoG?rYuTCW(JO>TNFrzO`jSbfWQQ7svw>ap2|X>FPnCJeLcR=8Q4 z>xrKWizzg={R#HYVhykA*27$_+m{OYcW zUM`DO|H@uJc=&PQ!_NLrCo{z-ky+C-d`y0LgwmR8Hyv!ZKSt@>rs+h@_lGF8T}$pq zgS!pJy=|Vu6kQs!Fxwft18tO`!mDub=+pLTPX9W8F3CUt IhzM2u1;rf{Z4gl4B~Wb(sLoWTPxe;> zMs_uTeY~?~7pSoa<-%V%Et5ojK0Aj)an=*;l^0T<@v@Q>Ux$7@WD8BkTZ#5gFka1{ zPX{%h^xj~y4Ge5T!B!}-Ri;se={1F_TiPz7`#BZBHd3sBn05g(sgA0QucXrTZE>-t#V%UZaSRFvC1KuL+ zk$H5lvvn56$xw|)f!jp$dnC~W^J_vd^}Kf|(Z!-WwXJf2IFyy%j2K!Mxu(CrxNxcT{P2V zN?e8l-onSQIk>utqMKci!31Nps}TL}&f_lNa2k$PgtnGauxsQr>#L9q>olC9ovCI* z0lW}Rrep4bsp3J literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/handlers/__pycache__/message.cpython-311.pyc b/env/Lib/site-packages/aiogram/handlers/__pycache__/message.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cea51412d43cf4b50b02f2cb5aac6a075335c285 GIT binary patch literal 2004 zcmbVN&2Jk;6rb5IufO7e8!td)=|IB|27o_gZF-St<7D-$lhbofUe8k^kgtfP>=7%)RF+#D>_`|rk_b70CvN&o#8iQq zX6bR}kqA6^5?;Z|Y!EH`FAg;tieKJb(}YmH+wvQ3)3igWW_mt2@@uZ+m`&?$b&J(} zpk!~F9{U<*Y{tXcvB90j4~?cKhSJ&t(+^X3nCF?BER??S7_TMUMn40wXWznbpD?0R zi|B$yb&*Myz+|S30;~&`xF;O}^JKV&o{D%X_@pUc+L9qKC7ekFBvLzCrUVW3mTI=? zd8N9`OHM4Z^dOGMi#VaencwEk8XfLP2-E?x>0BQOy`Cs9w|4p4ux4jrGTicT>lyHRd4PxHMWOhp(=A*L)T?JO zLH&%Y>?7 zG);#YMwl@S$F43*h1KuP+F)+9wDqQD*uAl|MN6?C{o;)jk1p1g9dn_wGf6zLHQcKemu@c?4s$ zvDsJ*N;tn3J_XOH7MN&JCNX)U4uq*(S1b{7T?#Kw9(Gc)Q9*M2{u3WshKVSX??qc$ zbUc@L2rv2QO`4C#o3wGBMMu((;2u1ICvF>X*MTTuJxtZ&s{`)@%k)i-J9E4wr&8t$ zOm?okIf`O9+^daoUv7LYRlgTLl=UO;67E1yR0muyDBCUHqs| zz#hRc2_|OarE$S^Z8j9mYK`Mrhl;=3f_orVgQpZ0l7cVS8@A857ikRV2D5`}pj?If zjHloYuHtL?0Ra|dUR(_L|0*t!s0vCroQ(68x)RshD%Ze^ca--xKwqSk_DC_9>^-s+ zoY!9vEtu>*@%FGq~`WC~|L4Z+gK&#rZs OZk(d;iNikt literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/handlers/__pycache__/poll.cpython-311.pyc b/env/Lib/site-packages/aiogram/handlers/__pycache__/poll.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dc9831261d69762bd3402874adfa6cf0c13cc79d GIT binary patch literal 1235 zcmbVL&r2IY6n?Y6ji$CL6x&OTP@0zNy_7<=&=$lNgtjb!Wz9@%bT=DkHiDrC4<4oT zW}ugzEaJU?MGrZ6kUa@K^%hA_p8DSAhY5P>?94ZB-uw3L_hx2)WV0E-_Ve4X@&N<* zO^bfBdPaw%aR?kZ3m{}JV`OWA7V55^+InDwrfa6Q5m=$^+M(k*3^aHJ+}sCl2~*g! z{mdZPkpXamqubmuZm&VX`9sSBOY|2@%QzV;6&2$=zT_+M+OP6J$byy_@1h_`GK6ny zaV4sjdTG+BpS1HHmxmz0WgJ|MGglV|*MwQtxV~>3Vf1A1o@=EsTR2xDk!M`vjd2r& zTFE$ly(g*hAd|yJB6Fp{S1MPIWUhvU+^4Q+l@bz5inuPTCEV#jBU{JOxrcBFpJ8(l z+8prK;Fzsq<)+vX)i`ms>q1fC$GAsI1Z73c+~u2>Pm3QSxm8?_c%`~g+^S1Ij-eZfCpEvcH?tT~1bc8k zIepMLoy@nKd2Hp1TEX=|G4w1L0@>sDK1=6rL$4LDuFg^r>9k7=-N^=SF#Omp*e zwm`J}6%28Qyj?YKu9~dwaKu8=y6xRYR)EzzLdSHa6V}_Pv5zyczFyjE2$#rht$#(-zjtqcf z{Kw`Ln6(bo!Y{R~l0;u#S;gt*iYNIiugwB3s#-GhM)1{b?zf_D{I<(QFEQRpF8pkh zbkeiMsD`8u92~;H(HL=bZZM6Tb&cr<#t}x3vs3`bVg{BsliPn+$cpdPiWM{^r{V{m zl$ClUDjmV+{Y+0~dn{9?iHRk6+!bvf`#3ShmAuhigg$(Lok?hCl7}+L8lKhUySyDI zH|in^X%|n4?Jy({>QbdvE;gPoxf_vaxvLRtwi|A%E4(-obSsKo-rjXzH@95bjQM=W z^IKknOV?{g4dI0gxzGiaPjmV7z3OMJ(-Tv;{oeim^r1G9qtavvVIR)Qv!C`(%5wvI zZiEh4s}>TQ(zX|JN|Pd`VZ^$D;!_msctI8^P|6}7-F8Pr9WLUYP|qw?@D)T^@o5Ei z4h1Cg1;YO18)}+q4?%$q*7Q&#=7Yn>L%``0&UFkOY^K3W@3?~6e64CHy0_&Ebv?;U z)~Q`gh;ITN}$?mhE-n+bXyM$+aRF8YoOW@P@SnvzguJjMou(< zQ~bwbm#EQzTIr8G)<~+pSX;;K=9(wi8!x0j<25C%G~snOHkxiXsb54bGA-51Tl{iAXHjjqai9!vXA0T)UGvWI;BtPo3?tFiCH; zcoeu@Y!XMI3Ffzi47IKrFISxp5$`zb5yfdZoi6v1h`U=+;;?YfdE4G{L_1+ivDfT) z+e|oKJKE-6uv`#bE*fyN2I_H-&tdBQ2eU>{pYV_|qJruWE~*Qk_s^<}19NeN2H2>T zQqy%qFJP{lmR&c9XxEo`&c!00pL None: + self.event: T = event + self.data: Dict[str, Any] = kwargs + + @property + def bot(self) -> Bot: + from aiogram import Bot + + if "bot" in self.data: + return cast(Bot, self.data["bot"]) + raise RuntimeError("Bot instance not found in the context") + + @property + def update(self) -> Update: + return cast(Update, self.data.get("update", self.data.get("event_update"))) + + @abstractmethod + async def handle(self) -> Any: # pragma: no cover + pass + + def __await__(self) -> Any: + return self.handle().__await__() diff --git a/env/Lib/site-packages/aiogram/handlers/callback_query.py b/env/Lib/site-packages/aiogram/handlers/callback_query.py new file mode 100644 index 0000000..342b11b --- /dev/null +++ b/env/Lib/site-packages/aiogram/handlers/callback_query.py @@ -0,0 +1,43 @@ +from abc import ABC +from typing import Optional + +from aiogram.handlers import BaseHandler +from aiogram.types import CallbackQuery, MaybeInaccessibleMessage, Message, User + + +class CallbackQueryHandler(BaseHandler[CallbackQuery], ABC): + """ + There is base class for callback query handlers. + + Example: + .. code-block:: python + + from aiogram.handlers import CallbackQueryHandler + + ... + + @router.callback_query() + class MyHandler(CallbackQueryHandler): + async def handle(self) -> Any: ... + """ + + @property + def from_user(self) -> User: + """ + Is alias for `event.from_user` + """ + return self.event.from_user + + @property + def message(self) -> Optional[MaybeInaccessibleMessage]: + """ + Is alias for `event.message` + """ + return self.event.message + + @property + def callback_data(self) -> Optional[str]: + """ + Is alias for `event.data` + """ + return self.event.data diff --git a/env/Lib/site-packages/aiogram/handlers/chat_member.py b/env/Lib/site-packages/aiogram/handlers/chat_member.py new file mode 100644 index 0000000..bf668ac --- /dev/null +++ b/env/Lib/site-packages/aiogram/handlers/chat_member.py @@ -0,0 +1,14 @@ +from abc import ABC + +from aiogram.handlers import BaseHandler +from aiogram.types import ChatMemberUpdated, User + + +class ChatMemberHandler(BaseHandler[ChatMemberUpdated], ABC): + """ + Base class for chat member updated events + """ + + @property + def from_user(self) -> User: + return self.event.from_user diff --git a/env/Lib/site-packages/aiogram/handlers/chosen_inline_result.py b/env/Lib/site-packages/aiogram/handlers/chosen_inline_result.py new file mode 100644 index 0000000..d6b66c5 --- /dev/null +++ b/env/Lib/site-packages/aiogram/handlers/chosen_inline_result.py @@ -0,0 +1,18 @@ +from abc import ABC + +from aiogram.handlers import BaseHandler +from aiogram.types import ChosenInlineResult, User + + +class ChosenInlineResultHandler(BaseHandler[ChosenInlineResult], ABC): + """ + Base class for chosen inline result handlers + """ + + @property + def from_user(self) -> User: + return self.event.from_user + + @property + def query(self) -> str: + return self.event.query diff --git a/env/Lib/site-packages/aiogram/handlers/error.py b/env/Lib/site-packages/aiogram/handlers/error.py new file mode 100644 index 0000000..51ccf07 --- /dev/null +++ b/env/Lib/site-packages/aiogram/handlers/error.py @@ -0,0 +1,17 @@ +from abc import ABC + +from aiogram.handlers.base import BaseHandler + + +class ErrorHandler(BaseHandler[Exception], ABC): + """ + Base class for errors handlers + """ + + @property + def exception_name(self) -> str: + return self.event.__class__.__name__ + + @property + def exception_message(self) -> str: + return str(self.event) diff --git a/env/Lib/site-packages/aiogram/handlers/inline_query.py b/env/Lib/site-packages/aiogram/handlers/inline_query.py new file mode 100644 index 0000000..022d8f2 --- /dev/null +++ b/env/Lib/site-packages/aiogram/handlers/inline_query.py @@ -0,0 +1,18 @@ +from abc import ABC + +from aiogram.handlers import BaseHandler +from aiogram.types import InlineQuery, User + + +class InlineQueryHandler(BaseHandler[InlineQuery], ABC): + """ + Base class for inline query handlers + """ + + @property + def from_user(self) -> User: + return self.event.from_user + + @property + def query(self) -> str: + return self.event.query diff --git a/env/Lib/site-packages/aiogram/handlers/message.py b/env/Lib/site-packages/aiogram/handlers/message.py new file mode 100644 index 0000000..4fbecec --- /dev/null +++ b/env/Lib/site-packages/aiogram/handlers/message.py @@ -0,0 +1,28 @@ +from abc import ABC +from typing import Optional, cast + +from aiogram.filters import CommandObject +from aiogram.handlers.base import BaseHandler, BaseHandlerMixin +from aiogram.types import Chat, Message, User + + +class MessageHandler(BaseHandler[Message], ABC): + """ + Base class for message handlers + """ + + @property + def from_user(self) -> Optional[User]: + return self.event.from_user + + @property + def chat(self) -> Chat: + return self.event.chat + + +class MessageHandlerCommandMixin(BaseHandlerMixin[Message]): + @property + def command(self) -> Optional[CommandObject]: + if "command" in self.data: + return cast(CommandObject, self.data["command"]) + return None diff --git a/env/Lib/site-packages/aiogram/handlers/poll.py b/env/Lib/site-packages/aiogram/handlers/poll.py new file mode 100644 index 0000000..2183d84 --- /dev/null +++ b/env/Lib/site-packages/aiogram/handlers/poll.py @@ -0,0 +1,19 @@ +from abc import ABC +from typing import List + +from aiogram.handlers import BaseHandler +from aiogram.types import Poll, PollOption + + +class PollHandler(BaseHandler[Poll], ABC): + """ + Base class for poll handlers + """ + + @property + def question(self) -> str: + return self.event.question + + @property + def options(self) -> List[PollOption]: + return self.event.options diff --git a/env/Lib/site-packages/aiogram/handlers/pre_checkout_query.py b/env/Lib/site-packages/aiogram/handlers/pre_checkout_query.py new file mode 100644 index 0000000..34290f2 --- /dev/null +++ b/env/Lib/site-packages/aiogram/handlers/pre_checkout_query.py @@ -0,0 +1,14 @@ +from abc import ABC + +from aiogram.handlers import BaseHandler +from aiogram.types import PreCheckoutQuery, User + + +class PreCheckoutQueryHandler(BaseHandler[PreCheckoutQuery], ABC): + """ + Base class for pre-checkout handlers + """ + + @property + def from_user(self) -> User: + return self.event.from_user diff --git a/env/Lib/site-packages/aiogram/handlers/shipping_query.py b/env/Lib/site-packages/aiogram/handlers/shipping_query.py new file mode 100644 index 0000000..64a5645 --- /dev/null +++ b/env/Lib/site-packages/aiogram/handlers/shipping_query.py @@ -0,0 +1,14 @@ +from abc import ABC + +from aiogram.handlers import BaseHandler +from aiogram.types import ShippingQuery, User + + +class ShippingQueryHandler(BaseHandler[ShippingQuery], ABC): + """ + Base class for shipping query handlers + """ + + @property + def from_user(self) -> User: + return self.event.from_user diff --git a/env/Lib/site-packages/aiogram/loggers.py b/env/Lib/site-packages/aiogram/loggers.py new file mode 100644 index 0000000..942c124 --- /dev/null +++ b/env/Lib/site-packages/aiogram/loggers.py @@ -0,0 +1,7 @@ +import logging + +dispatcher = logging.getLogger("aiogram.dispatcher") +event = logging.getLogger("aiogram.event") +middlewares = logging.getLogger("aiogram.middlewares") +webhook = logging.getLogger("aiogram.webhook") +scene = logging.getLogger("aiogram.scene") diff --git a/env/Lib/site-packages/aiogram/methods/__init__.py b/env/Lib/site-packages/aiogram/methods/__init__.py new file mode 100644 index 0000000..66214ac --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/__init__.py @@ -0,0 +1,259 @@ +from .add_sticker_to_set import AddStickerToSet +from .answer_callback_query import AnswerCallbackQuery +from .answer_inline_query import AnswerInlineQuery +from .answer_pre_checkout_query import AnswerPreCheckoutQuery +from .answer_shipping_query import AnswerShippingQuery +from .answer_web_app_query import AnswerWebAppQuery +from .approve_chat_join_request import ApproveChatJoinRequest +from .ban_chat_member import BanChatMember +from .ban_chat_sender_chat import BanChatSenderChat +from .base import Request, Response, TelegramMethod +from .close import Close +from .close_forum_topic import CloseForumTopic +from .close_general_forum_topic import CloseGeneralForumTopic +from .copy_message import CopyMessage +from .copy_messages import CopyMessages +from .create_chat_invite_link import CreateChatInviteLink +from .create_chat_subscription_invite_link import CreateChatSubscriptionInviteLink +from .create_forum_topic import CreateForumTopic +from .create_invoice_link import CreateInvoiceLink +from .create_new_sticker_set import CreateNewStickerSet +from .decline_chat_join_request import DeclineChatJoinRequest +from .delete_chat_photo import DeleteChatPhoto +from .delete_chat_sticker_set import DeleteChatStickerSet +from .delete_forum_topic import DeleteForumTopic +from .delete_message import DeleteMessage +from .delete_messages import DeleteMessages +from .delete_my_commands import DeleteMyCommands +from .delete_sticker_from_set import DeleteStickerFromSet +from .delete_sticker_set import DeleteStickerSet +from .delete_webhook import DeleteWebhook +from .edit_chat_invite_link import EditChatInviteLink +from .edit_chat_subscription_invite_link import EditChatSubscriptionInviteLink +from .edit_forum_topic import EditForumTopic +from .edit_general_forum_topic import EditGeneralForumTopic +from .edit_message_caption import EditMessageCaption +from .edit_message_live_location import EditMessageLiveLocation +from .edit_message_media import EditMessageMedia +from .edit_message_reply_markup import EditMessageReplyMarkup +from .edit_message_text import EditMessageText +from .export_chat_invite_link import ExportChatInviteLink +from .forward_message import ForwardMessage +from .forward_messages import ForwardMessages +from .get_business_connection import GetBusinessConnection +from .get_chat import GetChat +from .get_chat_administrators import GetChatAdministrators +from .get_chat_member import GetChatMember +from .get_chat_member_count import GetChatMemberCount +from .get_chat_menu_button import GetChatMenuButton +from .get_custom_emoji_stickers import GetCustomEmojiStickers +from .get_file import GetFile +from .get_forum_topic_icon_stickers import GetForumTopicIconStickers +from .get_game_high_scores import GetGameHighScores +from .get_me import GetMe +from .get_my_commands import GetMyCommands +from .get_my_default_administrator_rights import GetMyDefaultAdministratorRights +from .get_my_description import GetMyDescription +from .get_my_name import GetMyName +from .get_my_short_description import GetMyShortDescription +from .get_star_transactions import GetStarTransactions +from .get_sticker_set import GetStickerSet +from .get_updates import GetUpdates +from .get_user_chat_boosts import GetUserChatBoosts +from .get_user_profile_photos import GetUserProfilePhotos +from .get_webhook_info import GetWebhookInfo +from .hide_general_forum_topic import HideGeneralForumTopic +from .leave_chat import LeaveChat +from .log_out import LogOut +from .pin_chat_message import PinChatMessage +from .promote_chat_member import PromoteChatMember +from .refund_star_payment import RefundStarPayment +from .reopen_forum_topic import ReopenForumTopic +from .reopen_general_forum_topic import ReopenGeneralForumTopic +from .replace_sticker_in_set import ReplaceStickerInSet +from .restrict_chat_member import RestrictChatMember +from .revoke_chat_invite_link import RevokeChatInviteLink +from .send_animation import SendAnimation +from .send_audio import SendAudio +from .send_chat_action import SendChatAction +from .send_contact import SendContact +from .send_dice import SendDice +from .send_document import SendDocument +from .send_game import SendGame +from .send_invoice import SendInvoice +from .send_location import SendLocation +from .send_media_group import SendMediaGroup +from .send_message import SendMessage +from .send_paid_media import SendPaidMedia +from .send_photo import SendPhoto +from .send_poll import SendPoll +from .send_sticker import SendSticker +from .send_venue import SendVenue +from .send_video import SendVideo +from .send_video_note import SendVideoNote +from .send_voice import SendVoice +from .set_chat_administrator_custom_title import SetChatAdministratorCustomTitle +from .set_chat_description import SetChatDescription +from .set_chat_menu_button import SetChatMenuButton +from .set_chat_permissions import SetChatPermissions +from .set_chat_photo import SetChatPhoto +from .set_chat_sticker_set import SetChatStickerSet +from .set_chat_title import SetChatTitle +from .set_custom_emoji_sticker_set_thumbnail import SetCustomEmojiStickerSetThumbnail +from .set_game_score import SetGameScore +from .set_message_reaction import SetMessageReaction +from .set_my_commands import SetMyCommands +from .set_my_default_administrator_rights import SetMyDefaultAdministratorRights +from .set_my_description import SetMyDescription +from .set_my_name import SetMyName +from .set_my_short_description import SetMyShortDescription +from .set_passport_data_errors import SetPassportDataErrors +from .set_sticker_emoji_list import SetStickerEmojiList +from .set_sticker_keywords import SetStickerKeywords +from .set_sticker_mask_position import SetStickerMaskPosition +from .set_sticker_position_in_set import SetStickerPositionInSet +from .set_sticker_set_thumbnail import SetStickerSetThumbnail +from .set_sticker_set_title import SetStickerSetTitle +from .set_webhook import SetWebhook +from .stop_message_live_location import StopMessageLiveLocation +from .stop_poll import StopPoll +from .unban_chat_member import UnbanChatMember +from .unban_chat_sender_chat import UnbanChatSenderChat +from .unhide_general_forum_topic import UnhideGeneralForumTopic +from .unpin_all_chat_messages import UnpinAllChatMessages +from .unpin_all_forum_topic_messages import UnpinAllForumTopicMessages +from .unpin_all_general_forum_topic_messages import UnpinAllGeneralForumTopicMessages +from .unpin_chat_message import UnpinChatMessage +from .upload_sticker_file import UploadStickerFile + +__all__ = ( + "AddStickerToSet", + "AnswerCallbackQuery", + "AnswerInlineQuery", + "AnswerPreCheckoutQuery", + "AnswerShippingQuery", + "AnswerWebAppQuery", + "ApproveChatJoinRequest", + "BanChatMember", + "BanChatSenderChat", + "Close", + "CloseForumTopic", + "CloseGeneralForumTopic", + "CopyMessage", + "CopyMessages", + "CreateChatInviteLink", + "CreateChatSubscriptionInviteLink", + "CreateForumTopic", + "CreateInvoiceLink", + "CreateNewStickerSet", + "DeclineChatJoinRequest", + "DeleteChatPhoto", + "DeleteChatStickerSet", + "DeleteForumTopic", + "DeleteMessage", + "DeleteMessages", + "DeleteMyCommands", + "DeleteStickerFromSet", + "DeleteStickerSet", + "DeleteWebhook", + "EditChatInviteLink", + "EditChatSubscriptionInviteLink", + "EditForumTopic", + "EditGeneralForumTopic", + "EditMessageCaption", + "EditMessageLiveLocation", + "EditMessageMedia", + "EditMessageReplyMarkup", + "EditMessageText", + "ExportChatInviteLink", + "ForwardMessage", + "ForwardMessages", + "GetBusinessConnection", + "GetChat", + "GetChatAdministrators", + "GetChatMember", + "GetChatMemberCount", + "GetChatMenuButton", + "GetCustomEmojiStickers", + "GetFile", + "GetForumTopicIconStickers", + "GetGameHighScores", + "GetMe", + "GetMyCommands", + "GetMyDefaultAdministratorRights", + "GetMyDescription", + "GetMyName", + "GetMyShortDescription", + "GetStarTransactions", + "GetStickerSet", + "GetUpdates", + "GetUserChatBoosts", + "GetUserProfilePhotos", + "GetWebhookInfo", + "HideGeneralForumTopic", + "LeaveChat", + "LogOut", + "PinChatMessage", + "PromoteChatMember", + "RefundStarPayment", + "ReopenForumTopic", + "ReopenGeneralForumTopic", + "ReplaceStickerInSet", + "Request", + "Response", + "RestrictChatMember", + "RevokeChatInviteLink", + "SendAnimation", + "SendAudio", + "SendChatAction", + "SendContact", + "SendDice", + "SendDocument", + "SendGame", + "SendInvoice", + "SendLocation", + "SendMediaGroup", + "SendMessage", + "SendPaidMedia", + "SendPhoto", + "SendPoll", + "SendSticker", + "SendVenue", + "SendVideo", + "SendVideoNote", + "SendVoice", + "SetChatAdministratorCustomTitle", + "SetChatDescription", + "SetChatMenuButton", + "SetChatPermissions", + "SetChatPhoto", + "SetChatStickerSet", + "SetChatTitle", + "SetCustomEmojiStickerSetThumbnail", + "SetGameScore", + "SetMessageReaction", + "SetMyCommands", + "SetMyDefaultAdministratorRights", + "SetMyDescription", + "SetMyName", + "SetMyShortDescription", + "SetPassportDataErrors", + "SetStickerEmojiList", + "SetStickerKeywords", + "SetStickerMaskPosition", + "SetStickerPositionInSet", + "SetStickerSetThumbnail", + "SetStickerSetTitle", + "SetWebhook", + "StopMessageLiveLocation", + "StopPoll", + "TelegramMethod", + "UnbanChatMember", + "UnbanChatSenderChat", + "UnhideGeneralForumTopic", + "UnpinAllChatMessages", + "UnpinAllForumTopicMessages", + "UnpinAllGeneralForumTopicMessages", + "UnpinChatMessage", + "UploadStickerFile", +) diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..82ae6e785f131df6d813dd1076827f71d1c97638 GIT binary patch literal 10593 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 Vys+rlf`$cG>z}~?!D5Vx{tp1D_RjzS literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/add_sticker_to_set.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/add_sticker_to_set.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b8758a7bebde0ae20951951776c243034ae301d8 GIT binary patch literal 1790 zcmbVM&2Jnv6t`z)KeL++r7cM*$N_=0mDrSsQ&b^Jh(bgf5J{;REpcbZPBP8xc(FY# zK{;%tN)!nY7w7>Fl|V(%3n$L}0UT1Pht-@S^_1J9a6morJhR&-pn+%hXIqk4JIh;^Kdcu^#@rvnkG zx|LK{K74PE&b~c2`_97Bd}5!Ew)U*dva%3$V!f;bf0N5SoGC|Fc*xhK*S^5@hG4$& zI$VP{@%}1kK7*_{axp`$brG_2ZSJ@^X1RH0^8$0uflUeW0X{$A3&0mMo)=}Ajow6S zm{o67+|o_-33kiNX!yTgOKRsC8w9r^mbvyS5Mr6Yx~MqO8-XJ2G)AHY@faf>iTE|5 zvV2k{QCt&Wa!+$cT3c|5la|m8GS?PYf=8xcrHJoEWW&44N!&4ar_Y`po~s6V7jDX- zY`p%<{?+M&_V05Y%Se$KUobv%c}2$jG7%9`vF~%G8s#*PWf4oC&yWqRJ8EWX$`_J1 z^Z@^ckn2+rteWyV!HbaJATcfA`Sf~H1MNYC5<7@=Qiv6oG+>FXv`n1HYjatEVkCuu zhh&l-ftJ$F7V{!Nj&5G_ybr5)t=JgP3Ky!1x|Q0-J4T!hs&f$ zX%GdP(t18Qb|6@)c(_LCk(=@uTu(}r`k|*3rOM2r=^N60_`zE<%}YXVHfIG3qV?ux zEIlnG1)!Tey4qX}T1^#b{z}L5H@$VPnqDBxI80@|2GwAU4uGUuKm@wc*^=Y%#HZs& zU~LS;ejZNMG?2f$s6URX&wV-f`TQ62_baD&Dyz3I{rcMP&j4fg;zt7}6DzCxa0{k8 zOR)-khEUCL2Bx&MX~t>IypP6m6!(jj5>WKNXesrO`8h!4>0$6ofGeQ67Q=u8n$k=|lGj@u z04zfz9i1F#xXR|vX?ZY_CTlr4bR$n1F7;}_d00G`)#r7221J9J`W8sv#u)d|3p%~0}?6{y&$0i>YcxWLn8HH?I{wc-du$P%856-w$q4INQ`Hn=e;-Y&70qQ zGrPa!a#;lJ_aFbL+!#XWPtEjOG8!1W77XqqhM3`^x?vfH9>?5RJ#NM8re)R>Rsv*k zX1d9G%1Rk1hL#XZ+(j(OQ#?J<_lO?G5qbnq)T|6kT|#k9|_FbGE;&|JN8)<8H>`XtxyLXKjil!7o+bVaOdT%u1cfWYuj5t6a~+T48gH%nR4|Fp zRF!JTg;L4(1uv=|a7ACNm)3kGOBGI4Q*b#GS)LwPo?RtHyj%+}pmoL;(k}549@Rxkk4V$^l5g5HbkcYxF?jqAp?6+HAv-ytgWCX)rNluqJ`l zcpr+;p}S>wn4?Z z6#8Nal2I)MX4&_+t*;Z^v?>D+T!zN(B^Z2f+=uH-_4Ocm2+t#UqW0-P!(yApW^6OQ zX>KN%@gT98{Mq<6ye#38i6JyFIo|q8ttqJT!x~!Q-tCpk&f1D} z6hGa7YlyCMxk4RZU#q3)?vbS^-Q-|yi;b2z0qcBz@(|pM{hiFf40#2}-)+=AiE>ll zT>NV3>!ruTC%Y(>%Xdz_-Wi|hoS5s39S7PS0$Hf&4x`c8Zf?Np$&o^jcEKSkOO0_dOS>^imBVv zqzGZY4PsMQY>BOdW#8P5l1iUYcvaw`I;necPPt#!#Xh>r70w7q`r*sBfE7T5KmfcvjDzjrz7Z ztHoc$c2Z+qG?B=|+A}YA3a7zo=au>H$an^F_Wwvmy9<2|hu07EebCtjhdL%Bm`1_l|=3|xO?d{QO?hbd0;i_vJIpgHw>eL qPHi3RJE*kv{Jw+m*1_IQzGlE){!M-;{yO$}viMZ1{yIb-M)(f^th|%} literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/answer_inline_query.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/answer_inline_query.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f1152a379ad515e9466ec3d456bf64e1892cfa5d GIT binary patch literal 4142 zcmds4O>7&-6`m!RzY?im>R;B%rkqfbDL0K0M0L{0vZJQ46{of(bWCBh=8mL|c6Qm> zWgP`Ns6c?GKwI=uq(F1Xp>SQe=bn2kiXJGy2V#K&E_(8ffs3Nhsqf8-v;vZb(PM|R zAK#nz=IzdVZ{F8wH` zWQ~}~&xn~~v+V46a|Psnl#qvTg^ivw(>F<>=Lxa}CFn66$Mp^0aviS_3o^HUc;l+R z`n{{G@4vUc7DQK^{Xo5Dd47=mpn^(<9mH-sK)~GCyB4#}ClR!i3&!4aY|CLER+-rU z0rRT1zao6AY_njbT~akIH<)T0Up30R%v_PunJ&^RZn?^t;|CL66xOWmpxfl@6}Iyl zDs;Q|ja}DwgEL)B--HG2G0}DQhGnwu>)LRwGV9={RoC&2vLB4M-LOvUUiX0sh( z@axRqb}0$IJrX7xEFpdd-B{Zw^?>9|!M4#y`ZYmyKrR%%K<1 z%u3DSP?PnEL9qGkm-{kqPJT|d6?5XVEbafCe4@~So22<)mweW9ibsY60ETu#!qTd2MHFO4#UrJT4#4PYf%SV&+%b5@5zeO!BjVY$%?bJ6(mmbcl|ii zJlO77j=vS8%XkLqzQx&bwk5jjy7pGkV|hB{yNAc%sdsd(1yR+nU&x zYA3~WD~R6>t7zI}6~UlBGxHW4sskT`dEJ9&;D!z+g%J#S_bk7>t5>*QF`zy&AC92x zvq2x!3UM(Hi34fZ&|oRy=gQvTqs=oN4;rJwxnxB8HmraQ6r5y6dnq z7H4cpxO(C0Aw+q44TxVWU%)$u-;~41eYhUN6}FFC5;Jn397GPH2kJrWAbyZINSex* z$%EAIlwZpCD0m-Q{+5KQ3Lf z?v^~uXBR3)dC%BkUdgarJj)itiVQ_gmST8Xd`SxHRM58eh2hXqb3lgycnK*Pg#uDCt6o7$rq%_dWPU9oC6i2!VWtU5p+jXl ziPw>O1E4U7;c_5&M z9(on{KH#6d!Gdn5)JfqZw6=m!kwwR&aT)P4vu(&BMZ5*09wzQP;%(GA*MwOVR6qi8 zc=l^V;<03dAoP>m_~G?>?&ZVv$Ld&3_9JzyuD;rcjK<;((uA)ib&KqR9X#HDDhws+ZrLZ5VOLcXt zUMN1uJ@Eh1Tic+uwL7&!>8Mb8R4CQd(V7Z~{YWh}BGK52(nylI`LC`%$p86L?Zex( z%Nw=)=23q0QGWAqy{2x4{Yc$B(N2?Ou0dXpWgG7(q;R1=U#tVZ`4&7!ec@tbRe3c9 z`Srg+3e8H}EfC*rhG4yr$F$k5!n+Bijlgf3Anxy1ATz?4V)+vI$tLi9QDDgmlFb?? zFbjeh=rd2?{uWryL5faxF{qg|HCWt{pk96BXSetl88FOHtV^ zTd08M5iQ0r`LbJ~6_BgB%&MYJ%d~daqC0P+u0?m;nsRHm z(Px%BaRrUvja})!v$0%bVo|WU9`jduUwzPLV&J84<{E}^IrbS=J%;;|3EcA}_Icb5 zM8v3G4g^lTLBwK(y_jOz3z8&=S1@JD3qpCqY(2*nKD&4kOBPdUR=NS;GWKLp#6g^E zxQHiEQ5yelJ3iu zi_fJ!wWSj2H0*f}LlV%`xz2f*7WiuWaeZ9cAA|k1w9bU!fm)*WbBHP*w*J$UZJ zlaEiIXlP;GS}&~I)Vgc0J3m_An#%y1*lss$Q3rFeLlb@2Ur?iv7G*zSBCQY-#DOBD zQA&6J>##(!uuI5uJH>9;o>mDl#Y%|OSCMWUJbZlZe5>;z7pt8)PN69}t9{`q018sn zVe!q*`@!{&3=}(=c>XFNCp+7vKAYDmYuK5!0?oVP~KFyd_HiF>1A2mEbq?$6S_#Dp*^_Mb>s%@9E^QhH10G&k1J>LJiQ~1gQ$^{ zLm-)LS=I=>zVYnbM6(ebcea=T8hIo}<- z=ccZLWTZ+I33x-TL?2NB^_{;0fg|f534fbzubozJBr5)$k6cxGpIcIP)U z>mMqW5`yvbcfT}$Eglv!q`Bp(M0H38fyVxq}B?YNy9?|@LL<_9Mh7PAEpeGrGp29a7dYKlNP_6V_iZvx1 zG91VC4c~GdQPaZ8@{Ow($lSt(xsNX{&WD*8>dSureE!dUk^9uxJpM-89Vug5jJuQ*t=O%vid4Ht1Kn^{@rZMK5J0cU=jJB-##F-S{p zo11I~ulv3yW~Qf2m$SOxPk!CyYtwMPm^M7?q!ELio)%vbiEQx*Lmo$I@cFDQoj)x<6UHbt^nL*zLwuEA}db9pL>|SYe#IoU|ZN zV~y2RJ_gmsUjY)nN%pA?Lc9(&9N#j@#-_p71kXy_T!KlcExHafWe3P1%N!aV4I!lL zo(JYz9*#sDO_imh@ zX?)`HjmDfyq3jzQZEpC08)UY@oI8z6)@nmoK6}eE%nbliH2PILom3m7KTbUvjc8~fO3Oqcxn1yvYUKon1HdO(jz}&Bv?@7S27Fu+iA|ho{;K5Uqgty- zlpSbsLc$UuEtj@!$(IR~s$usvc|xdb0_4(nSOF&P9sm(chY5kUfa;SS3GxAuUp&KL zJ4h~RQ7cP|Iy zQ{BZKZK4;?ZEYgZ-Vd~LccHuR`9h?k>}P85-kF{@*3*E>xviZEwAJ9`WcPAUn@r}m zHYshlGCTRP2p!4}N2BPRa$X5eO-Ge#5y1a{q$pj*{sx2}Pa|A}ECBY+HoQoHJ(quP zVGdqOz&C+RwkMbWu3Xl0n2ldiE|GzE#1M=_bD}so32v`RG4_vv+bf(+^7;XH4ms@{9%58x1_9;!VRaq7)gIG~<*Z`MwO>@5;U#=AeidGF24oA>6u z*`M?IEP?juhhHlzeT4jhopwuwgtqethz=u+aln zW|9ZIPC8McbV?eQ?FN$_{CUHya%)aW4@OAOx@JRg#}CFM6c+4C z5H)zQ&ez^Xg{ZYJR$bo>4n$173>#YKGII1a+v3sty5`y@@8YL<*YOS055_uH-Q8=U zL$qKB9t?M~VQ-!DTyRYl$u6Q@k90;U^hGEC8h0Aqq8jeLi@w_T;4%d5Ixo-F>xuez3rC$QaG=TqCc44f|^t2m*WMQH3QWEYL|1Wj5onzG`& z$4Z<6oeZ3Ppi?2u(=u!2?vjdT_1?+R%w6)SMzhPL{a?%ngL96z!DVQfI=#jhU|3d% zcGcs$U$s45D9d!;)jjS5i|bMyaow%xhNIh#&n1Kq(m~&_{i<&0t1zJsd(}@>eZTI_ z&divuxWSVm9iowAXCM@VQmeKX7!fVVW@EG%Pb~)(p>^ zT{UbM15ole>)b1W4L$?A7#PM{YnM90x2n748{G7D@Q>tvLpm^jR{3q&ZAg>P>i@EJ zqi!EIl=nj?C~MUO!C=S-CxQ=ERD!tY%V3~wmeOUm_4`q%KdKOY+>s1>%E`1IA#JBv zqykinNLf31A{A5$MM_)cBvP&tDq4zZ)kWGWyWJ#MSiA6B1*nSzt4tU6E1cHdUF`zY zWv*BFFv@$X0Ckxv%3rGReiEd@oDB}Mj+AGtzG)c_ly|niVaPR4CZU$#2t3z8V##&5 ziRB6#UU+!d_Y$J*oB`rH?H(}wwj4P3;e7~i*lz4ftk`YscFfX#jNOj^qkz9$7>bFUJjDSU}TVCOl34<9&P|@ z*w%{=&(5w~cjfxZyo=RjWxXK{-<1r?&kA>Ltz59nE1vE1H|mDD4t3dEX_bSSuGUtR z@E@K_cVp5GEPG+%5wDoi}b1R1e})dLKg$$eGb@+Ynt|i9NPZp z^OQ_)M?cNPh!$&-|2ve3_S!bl_ddG zuGgyw#_tdQ*uVvZo)}>?iaCQ1Twv}ajyMibh+T{gZv|FpyLRZfPFQdYuxE28D264s zgpq|75ii_DyeLYdJT>x&9@+>!f|U=q!b>ZtQGRN~22RIV6vdipKaNzxPV1{5f3!g7 z-&>gf@cq_eYR^U6X<;pb)2BE$7+)2E=tve`6}lU9FL#^M;aBj%GRR**`~ta{BiCAk zJX~8iZh>2Fk=vrgolBrofrx=G=DaA&DzDu`8<>yXt+|zZ=rinASJ3FcQBNo5dOaC$ ziTN(mAH;sNEN&%2X*LDXRSAqWC5Z0&iiBBsM8|~XCWH|WtjJ9;BQm#ZlGUyt>#-(b zqBL0-ghhn$(2snjCDXAapsYbBGu;3=a}Hi_$8r<2d2ZQdTjslhocCBn{bjJMGY%0sH7)kTBc9~ zUsKvBq$i(=k}45wPod(7Kp9iiIHkIluH$y?8qCF@n1foh6EM{U>JmXq+IJLitawK)p^ zHBeG-1No{gP*9pyDGg(u1ct9sdMjbU@T5d3k3HCS*5f!x>wsidX@Cbd z$0>zIqK4Q&AVX^C^i==q-sy||*1j{no6SF+={@Jpo^ztV)L;61Y0qiymrf1PSYZ_p%B2cW z^uK5&^N{;_hRQReXj_e{fo~&$%MI{J^B|^0z1;(Z^7KuANplSVLk8E&(ho{oI)Z|5l-d$P970t=(<*IAU6iD%*gBf5cgFUT{V+4T z38`{0QYDJS*9G-J4;)Yt>Zuq03J!_XgSDqfoO(e<;ec}D&1~&7q7sPN+2{9W-aNne zd+*KuR4Nq^j9iU&~H*0j!eR6yDebuBZ{czB2P0lP4c>{n>zfa+>~dShL<+e zUdGILSu+d!22Hy;FK^~Gq@y`RGj|cqvOFuC7+OaUQwTkRHyP#_)fZ7E_f(1%EgrLc zKM1YR34Bqn7;$OoqYp2W*(;Z4Ke$?-i&O9W8*%PNSMFPGoWAJ;^HfXDmY0~z+T8N4 zv#=9TJNbu%8p)5gdk2`$AuNVWjUrRO3E`P3W|(QJn;Dv7S!$dIojjsx;4{zoteK-Z zknAW)>IG@V7DliG%zCSGOi>XaFFc|z{cDvzUqSw zhHVRs1+C}w1h#xS)DzQ6OBr5wTo(i6xXG~9bis!Ja~4J%ECq=%a25y3u)}e%?t@2; z-v*b~oRDGH@mIkh3+?JOj(nF1fmb3QeD@i}=R0B86*IM(9dK3+pCzao@OG^kgra73 zo!68ygb;cPk_#&Yw;V3QDqezEKn;75NE`$dsOR{O2)PwP=m3j~SGw2&Spf)suLpcp zMXXMCtTl-(1laBJpvxT#{61)iJMB&=s(3+#F7S*UP&TuQyMgBOu)LuA#0%GF{J zahuKH{}3GDupgQ_9G75izXJBgRT1BI{BRmWT+4A*9v}{lQ?M3iWtu>$@4Y*$``gJ0 z3Soqf$ErhS8V|XuT&K(pt!cn0Twaa~ksmrPkqUd|k)dV~xXbZ4XKTSKBOXL(wV9~s zd;(g49|01dAs3%_myqrTwZN85R@W`w7CbGrGD*$EMm_MEEgMn}*>yR1#}LwXF9GwN zb{{T=aJUaE58-_TZ!$g}?NEJF+tfExn+DY$7@O%IwXf9$1eZk$E(TtP1N@LABUgV$ z6+KR?-iULAK$(PuRI>5Jb3PNn+!i4(I?j)RwKz|R?OH+*BC;UM&cwL4w|Hr$aSMv7 zF&j`Q{>Eyg3Xni`HkiNGn0J~D0qtf${_645QBwU+?4EAP);_bx=T) zX9r^=QEDa|lG_Dqs8UQ~F9Dz6H!e8^;$g|jr1MEhBpxce{Fvm91F4iGvcBapLgE4; zUO*#P@Ei7fZoPL>cF*syHK0*gxkxauoF4i?LVK-)vL$y*xaagg_Keb60cl*s$g0Lq!+l~$_%##HadmNAvgZDUF< zUom#FM+WG4x;&Ubx3t?@zxvjoG?@qd{~yUqQ_9|m@H4|0D@BQZD}s9((B~;wk8{K3 zk2B#$7obkilkLgnH=WCRhK#_sflG||SxFRZ^6Q)!mr(BI&L?@jz|VmwF&5td8Kg8# y>!Vk<4$d7k-cwH>y|eXia|hwAgL9CX(jd@(l5gujy#3_Jn}5iyKVPt~9R3@XuzF+w literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/ban_chat_sender_chat.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/ban_chat_sender_chat.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..63700c646fc7a31c042f49ee7ea147b70842ccde GIT binary patch literal 1945 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 T#y4mFJogAG9zTPO+xve27E35N literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/close.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/close.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c15575aef187231801d66877d4fe5d1a05f75414 GIT binary patch literal 1066 zcmZuw&ubGw6rRa%VpCMep`!3mL2@ur>BS&kDvDqO+KLzg)5*>xS+YBm&dj!W>%oKn zK?Tn$;@!W(Lk}KGPJ*Z2BK6dhZ+4SP)!E(0n>X)$?|bjo`9q6)a4TM2FyT8L9ra2f*dfkp{^?I2XvaTVZ34z!UF>zz;y zA#^Y>ItHyIL^|LRSZQ{o@ck}} zOJN70u?}wEf;d!(lXebwTE0C^*Mw&&hJ|*Zg=}wannZ442f!vlAg%Qd+ewHNKxvq8 zoE4UAY_poSdP65BkZl+_H?i$jE5LR(-F&D`ZH6uEw{7uBcr6`48Z<4YdZ$sIRv1%= z$k?>XSgb`7d3}ko?Sx13lQLsM2WT$zwT`AW#TOXtpqzO2WV@um0k7xnd(VD;@BQAh zf2`N52*%If{@VMcfY5JR7>{DkSVtZ(_Yp!{YL*1wt zm%NgNY_yJO;Vz;@R$}Gz;}g*X2cd`X<-@Dc(gtdjpJ=gRWmA5VaOJCzC$iyW_0G+A z*U0MCwbggtZm(y~LJ)2pL zxMXi}k;WZ93Im=9S33fPas1pBzB?XgUUO!Ng$ zhd3Dcs);)ThPSxFaVizwGL}A#!z7eS_=*c{tYDAct*`4#v|_;(O5U}4W?3&NW2no%2sZ5 zM9OYqo9HVyEe7H zvv-{ztS`;Afp&M=4O`SnqgCdsVg!;=~jp@08|nN6dkPPv)NivN?|Td03Ti0{L?fjpk7Og)i1VTmO9hacyyg z?E3V<{DuA3uZ$dEbNTAciC{Dnas;QqlaS|H1Kyw{rZuOtHnkG7nmYreF{M#U{Fo7v zRSAhXO(V_M2>B@Wqmz{qA(RK8cDFc>vO0iiiVX;Xa+(lmK#~Ih@(jq6mk9Q{+MR|# zTN=y*7DZ4eOU#2->XKg)`k52@IW?rL7rq7pm`r{n+bxtwNRt{mcYg2s!MRuV+K2Aq zzL}5Q#gUB)m+b?0Vc*P0?!tk4?XYxqgk}rVqjJ3h82%qp(PqZ>DG>|fAlr?qMy;2^ zT?W*Iel)Y9+8F{cdDgnKguVa(oiCZtX^9J(m`u-V&K#$+KQ3R)3-E?`6+{h-+ygRl uEXz7TFYTY6hiG~Kzvm&s`={rqh%LzFpX96L`_ALJrQh|^AOEs$BK!-Vujs@8 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/close_general_forum_topic.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/close_general_forum_topic.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1361dcf4e9e2fab5012405ff9a881fea3d55f8a4 GIT binary patch literal 1715 zcmbVM&2Jnv6t`z*KeL;lstv7_2n&SDR_!j_P*hcfGz|zEA(E(K*y1{4XLrcVc(FY# zK|SP9iGqLw5-JiG4yb^7=U?E$AxJ$`bBfecZ;QeK<;1fm+cqM-;PJe9&+o(U{hmEP zw^|JZ`ENVPwNbB03ui z)mJhbl5oIGhpY|+S(k<+nKoqI#b7*%(nuS{j8xXyfQ_}bF^ZjG%NtT{!j8P~9I)#) zDM8MJETsucSzl1MyFNn>2UJmiV04GPFHELVP3A($#oV=3m5FOarjTM73avX0SL}++ zR4C@iz?h+)>vlt_M8_QTq$5?o3)$-~8%8fV5c&mfu3ERhi;_<}<$plkpK{IqFiOo? z0u^7)tF}-Y@%$BfbRQ@kZgG~HD5RS=nCfd)hR)^{<;uzZWtoc59v(aF*QzIg-MawH zclZvRTr<|g%3XNx!CQ=vA8WYB@l71zo8C|O8+RYz9G8|=3k-inZ7(moUgkAQp<9O1 zwx1t+Dmkh}yg{k6SCinB*C`ESrZuG+?jeGcw7q}z;#}_vbh5V~d6f2ho0;o61yFk; zz218_TJPz|h;u_0ZbDCWk44g6hi-BBbk_k(4`8Pb_oDHg;g&iM`+WAo(Li>_iQBuY zJ3#)~Mx#m8n*Dn5i>0rY?l)(4ns37V@rwPvI$ubS=^l8XcBLq=3B0S)bwf>A@j0uX zumGhj5tQZ)N)ySm*z!$EKgn2pps7;IWeCgux|DI=0^D3X0TNi8q!i8~KL!#EUi3@yQG8dTag^$qpBwX*+0M`~8_EfA>s$usi&a&3exX`&OSwl6<8 zac+Bg*Pq#O^G|>?mT<$BC>OMjw&ay#o}oC{YSrCyg&QeUrzn^GmKoW{{mfH-v$5x literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/copy_message.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/copy_message.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..add1a79678138b266966291ab0e64a2fe97718f2 GIT binary patch literal 4262 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 WX84Ev*GG2x#$NK_@4knL+wH%86RoZQ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/copy_messages.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/copy_messages.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..bd95073f3d96b28f7dcb768a9cf85c0a5c59d640 GIT binary patch literal 3008 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/create_chat_subscription_invite_link.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/create_chat_subscription_invite_link.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5424dac50318316851fc4762d98c9fc90b027d1c GIT binary patch literal 2532 zcmbVO&2Jk;6rWwMzwLx34gGEhQmJxjY=H!oqN)O=QD|ubYFZ(-t|ptEiM`E!n3-`( zP=sz~Ty0)qDIcaN7I=Mnl{P5Ld95XLqK;y$8?8a@gP+b|Su`lfBdJLRVW%eI2FoenZ~ zCdk@Z;9E59=YqVQ2RcKuejzB@MFW{=2GQJIMDwi3@<;lb(8Cl$kKjp~U83eZsuZ58 zX~l?(P8degkzN#vxr!B+uYdHxG?{vLdg{H)b2D-3op3eIz28!N$B)xDLLi=+$=RW) zrXw$hE1qOmy>R)d(ObUGeAeJjFw0~!qOQ`^Z&pGW+Y*Q`z;cFcgCg6!0SMSBX4z?K z+8LT+S!!K?J$XdaKxcY%7U*1$&f7U!fO#>Qvpg@;JS{yi=*T^^WY7b5hwQ>V^od~? z=TZM%8IAE2XO3j*^7HLQ;c`!#w`+*=IT%>L&~6BZWz!Ql(57G+VOJl<4qgxghq0$& zz&_xBFEpiWiOE_`_JF8Hyir^9qee}%Ta3F+0G;__LP&>CfIL^jKQSm!jBDnerHcy$ zFGU=5_avydtm5lUh8H7=gSL>k>8z+bGkn%{LXupIv<2hhEOuz%g`SYyksyY9jiwaI zaeZ$%fEO8N6dX!%TXH3ZklM9X)DeqR3Wl>f8iMk0Hylr2#l3bmJEmQxB z_X1Y8VJp${e^HwpNEG+X)Vi)|K}y@MM;EI28k21v3T;rx?(A`xBLLIq&6BGwCaT)5 zLGjNC#?j(!=E`b8$IE=w<}RDW{Qz(y&Z>K(Ad;fyw7l^oj+FR8)Dlg~4lOV4g_}}3 zKM-!amhBAdl)UMM@*D=w-iouymFdpw35P(TWr%Q6$;KlCcP4`QON6}W zI6nk3;yfWbV+avhn5%k%@%m2l(q#R^h%eWtA_^H+UvBGkB#^;%7OvEF)|Cz2H?1pbWfoSBZRoyf z9aAgU%+Ar1>z6jHlS$vSPIj!6S)|DjlazJRYy_#2HH?!N#4 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/create_forum_topic.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/create_forum_topic.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..58e8227494b68d371d6a9b196995ae13a3cedd3a GIT binary patch literal 2114 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/create_new_sticker_set.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/create_new_sticker_set.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d13b1111e87ea20a7eb01fa05565a71f3bb77161 GIT binary patch literal 2362 zcmbVO&2QX96d$kc{mSm}-GJbh)-pres z_xsIDzRTyc2-;6y|GHZ5LFhMObXzi3q}?l^+(ZNs$woCvmn5Ml>_ko0<(i@^HC0z@ zNj({j%XX@k*3+OXM71-uteyouNm6!CEvM%slt43xq;DXSp*fl#>F$PZ%Lv_tFK&8) zWEW7W=e{sYQqW^Kj_Vno6J4wfv&;?3?o07tVUgN&jTyCb)LVCnDYol2HCCkEpF#N;Qb3U| z5u_*1Ln?HcD!NJ%dXmUAMU>MpCxeIzdh#JX)zQ;1p6TdWJxzMR&h6V7k_WpG+X+Oo zBujcppC$d+e;ZDJSKJ_KdQY@+Af8EctQTgApTS!)8TkaQO62g3f}Z~bU6u600_y%Q zjRu2Lj2a%T(#=i^7N~da_pAo(Jg1tsZgH&^B|-CC&5R~%hUU;sjmJ6DIQ2Al)1gFL z*#cLCQ&!d%*QvJRdfKLC+u91%j1?QAxf&&w2T|#P)!ur8cVd&W_Ad1r%;DOk=@L45 zX^}PPCCzm--Y`wdc{v-MZozFZlTK>uo>%9Sm5S*yTJ}1ym0h-0f$e$4s9R6Qr-mbU zP7DW*LIi`c=fLFy*>b!fC2oN&63ErC}5bDCithpGZyOFDV`7YBg zz{-n3uH(VpR-Nt@_MI!PYhMid97+ktjMfd<)pFK?ETMHqO@M?f0$2MlbJxM#T&Fby z)2kjcf^DISCZLbAORZ{Vhlv^6n+Gz7}vLm0ehHuW7A-3oCzKWNfsqLP^zv& zO~HQAQt-jM7oW5{2g;YyO?aVR*AFAN;kyf8+%E5XNTMk<6HU3PG}UIZnIh7yR5Sgp z^hH!3;O)xQQi}D%GBzm0At8o^ICzWiQ7I9qyiuntNMmd{mWOdE8w@;j5zMK*it&Gl z#-4y3f(*u{ZE%h;7xhhWJZh~y{q@P^C6{e1Pq_q8Sl(zb!*dx13N2IT%JRImvdk@y zo~j$>hOtKZvSGQRK2+kj!7DM7Fpvy)@d28Z>szb{TU|Ty2uRA^YfZomz5wE{778_# zANzdz)0xj^?&XezD3dSvhmZP0BmVH?{>U+ZtmGei&Odr8>;+Hc4*SqxG3?(r#gf<| zv|R{`N&|6@`aqAFeJtz6dn^=L?}^+BUZ6!Or$X)4m&C|4MeF|;3FOg z#z7Y2noAnC&~q4n*f8vlCxtO_O&C@L^MgFV7BLU94TA-Y;i2LW0lySTJnT)J0W zYE|3HQrx$dr7$6@XQVKT(nBE{Qw!lRnyC1d=lzq)mjEEHl+!yTWZlbDy zE1Y3+mEKWKtC cOuj5ZR{klzD&IMDZ?yb}aQ*oRe{`3>0nv|v`~Uy| literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/decline_chat_join_request.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/decline_chat_join_request.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e1132373467d70d4f108f4c2b0acc3140e7cd2fb GIT binary patch literal 1746 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/delete_message.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/delete_message.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4d313b856a62064cc644f904934849e7f8ef417a GIT binary patch literal 2335 zcmbVO&2Jnv6!+}Req^(oKxrdd1=RwivQ?6;P!A}oP(vGq3X-5EQOU5#os7MkAv5E} z_BN!-AxM=d2oOR-J(NQaRT1hP@kek7QV-FbB5~?%Q8=KSc=pUDo2rEh@64O$ujk+U zy=QxWs#ePg$}e|+Yu+y+^oOqWN+DIOJr|Tah$3o*D6(A3(t0k;MYd~4j_X8uHxF$# zb;3eabc+_sp&3N;w-7C`A}gKjSws(PgdW117I%Oa7f`MASXXOSGU&xISDp%ZENgaB zU0nWPnp}E!`qFz>=4KLmD&9!)OEL65w$cehi!5X<;YG7dt#az8W>cB1V(ndp`WJwo zA=jeF%`Jf+uFV`bPjha8+N?;O3ovE?5QAPwbygB(TDgsy79G4*aR+Xr&n&mRfO_9r zHK|^P)fJm%QhF`seGe;^F_b0Auv!fyjtnZSIHqPK_MpiO9>YQGhaDQkEi9S15%{dv zCCBi3pjN>G!%ZHBd|eL;gDA+DnJk-C#_?2d3iiDi^ElkVD=b@z;-HBGh1Wd^3&aYC zurSz!f#=`CtGpv5_F8eCHw0kBf;zg|;15q2)^u%7o2uaF>M4Wa)tyc*7wBvs%5#<$*&F?lkS6 zIIV?o`MB1MIZeZU=|UQbx5XK#YJTKbAiB0?Sv%;}?W4~w8ry#Mvy1Td(WhHD2Y*w# Y=;`vixqIgy9e?9b)BV>o1{tjX0B+N&1poj5 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/delete_messages.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/delete_messages.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ae95e3e1613f0a2a135df1df12995bf776399ea4 GIT binary patch literal 1713 zcmbVM&1)n@6tDi6&&*8RXtE^6rBQ+m>WsLTB`mU%gc#fe*(5CX4%T+MYLYhHU2Rph z?t~yYEV#ldIjn5ZJ>(!OvUl;1@Q{T)ggz~Zhum7?LH6XU?irJyB3NDZ`qlfWe((2Q z*Z1{$6~XxN+n>9=0z$v2&0rM!%<(l~?jwST=A%HfwLrJ^z_5+Lv`q~Wofv*0DB490 z>1ZAi^EM&{TBN1%!Aa<$fzTsZ`LN5RxQv>mBeiXsNqyym_vi4;yK^(|EiBC^#yepz zF|T?;CWY0|W8sme?6jn@LVdcih&l648o6+gdQx&X9Em-W4E61R7m0<>B7||&BTgti7jJ&*@O6Ay~&(fPAgp2caD3LGlpRBUt(P=r0Y?x3z7ZXb<#l<2&su4H_Cja~exc zo!7va*MalBzxAXQ8?Hoxw zz_%6k`15f5*7>v8wFbee#uje^`C|vAW2pYpmvdjt-<^L_n>?u9*uVbMYw%KY!R|Bp zwszwfd{FZ_m3HU^6yv0dallCIE53&D$Fbx0H6@G*b3tsbG3FeIK7gum`b!l)@5tW`gGDFj)z7G}9_$Ww)D&`eF zrmWO;mJxNj_!S5weDb8aStzGSks2Bu-&s5yo!VJ?S|8cHxM%EMx{D9YNtln#$wPDN z@Z9LGdvE-}oPhb*oJe(4xTQZWy^x~eLPtx>LlvM!H1^`&#eHM%(mkA(GEo^#T-b9T zjHi`sTSYHVr9&B8LyeKNp0VhE(MtB^{QIXUKR?KO39gu;>_ve2Dey8ZGr-L?M^LV= zOFlX9;pY^W9ic#cR=%7U_-#G~TZOLp3`lBdns$iZI{2^o6j=vnXIi|V0aoar>F$U7 Rvrk5wzh&y*|HUYa?@!no%)|fy literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/delete_my_commands.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/delete_my_commands.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9519683e201233b3e54477530a3fb13a69a862cb GIT binary patch literal 2491 zcmcIm-)kI29G~6Wy*oQtyrT8xX5rPr=5cWX|J{5e}5+5W_erGq=OOq1?ac=f|-}!#O zJM*2-_s89LhEYT?e)#66#u?y#lZ)QSri`-r2{88%K}7M8uULvAdDT<>jFs^Mv6s9o(h5NE>#?3!f?}Amyvn zqfKu6b2Mx*;z*o&LrWQDa~YUVA&wMT3PF~74dQ8KsAlOzwX!5*<%mY}L_Y_11&E|o zAX!-F(lsseGDJ5+^7mCzzKa?PG47PDp}XjoVwDz9@4GS_ja&q8LOR#o23pwH!Ox-z zsm*m8yGCytsSGf83$Qfhh-0h2Wnewl?6!gSJ53A4d?B5t~?G%$q>oe42CJA!i4 zvx8>GZqlkb-3VcwYzaX>Z7#LkW=mSoRqFM3JJ$-swwS8b9L8xi+y<}8c(VrQikjVa zPY}2Qmst@sC#7SPtTEYh=ll{jZ@QjmE>lyq*v&v*#BMaG6VlWtQ8nMCVTT98oN^eU zQ%hHQhc1~6obNae6{1>95LsXy?$9aoUwI^9^}9VUlJ}#L6u>^(^IO06l7BJD{l&q_ zbK2Y`hg#T~$Ak3!Dj1~QTSrT46kL~vS)K$f(&kw}9a&v+$lf8F;SfT~<^^EB zR_=i??CC-B5T5VhNyi7zHAKCw+*XNlU%j3AR{1h%ozTiM^ISH&N2sF0Z8~iz@jS+m zY$3)KJ=(v+JuIl#z_@=K{xZB76)<)@TL_GW^jsF#+SYp)r|Q=kU#ZV90(o0s=_Cye zLsHjiuv&lHU9Jl^q?2viS%HEPb=zgKZ`9Iy6ty&&u-^p`lP)Q$?JhUrgpbB{V_5BZ zTm`i_1LV&&6u*j$qhDP5Z1(fn$E73drNsxY{b<0KoR_U_CS8^mH{l&r$)|T41wIKE zKO{MM%OoiL70Dd|QZXb-f$dX_qawyWBOOojC5%7p*xt4#hcRIeh_z+LyvP9XlBfbA zAS`1H<&Dz|Z{r#bgRuXb0#cbaT(-{S?sAU=ZHIauL`dP|pb|357x)Qjb)ZM~NyX1V z0E_-7Ry92zBS}hVbZl*IV{~F|K0b^JMm&o2VvLHq(I?N6qMe~3$Q}}nHG{=)4g|4ezJGN`N{zaexn2J4Z!E} zXFAG;-8SHxLM9WE%YxxKsnbD61usZ}{I|iOju0$^# zE;(Hyy_G+ghW$K03riUS@jH+>qbSM-8ee~LK0&Xq|I>`MyrRbF{~-I3a(o?`J7=6d atH?kNreA&hfIL2Q>RF=x<8O=-H2wky7uIM1 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/delete_sticker_from_set.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/delete_sticker_from_set.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..eddd32be4820cd8e8fe9ee97457e518a98c8436b GIT binary patch literal 1528 zcmbVM&5zqe6rZsjC(b5YD7!@!tzRO0n(P7#V02 z(b6uWHnUmz^dcI%5Ah$sQ!KAS%U#r{JknwVXG?yPaOJCzC$eE=_3e*7*dXigZmhrm zUS~5iFC~*lxUgK_W)T|-KfcP;4yQp8ub}hr`0xtIUqR6fd6**4xCX_0CbPT}H9VV| ztW2$oVB;WG5mj2fg9ey7yEV_bgTBCCwTl+-#!|L&88Rx?Rben<;)>vLm#JI7S6x`w zBy-hHDBU=(##P*+)BC8M* zCZQsvVPz+uD~?DO4G78YMID?nhmauhr6fdJAj6$apL~3|-MhiXsJG5(m<)TPRQQSu z0uc6C@>y>y?Du4-*oCnljQk;!JwN1n=32!y%T@s-nS(|&%8*($#}n}qWVv+B>j+yrJK3T`Huf^bkBy!!DWwa8cf2eiLF@ zizl>xNrRL4F(V|a5)yNoMw+h?@@eWvb4{5L$^$sI`kY5u9WcwU65xQtWkO(*NYO3G zCqRDofr71uGVfG-=J*CIir_l1SOt~T7y7n1rLCL=sc6MrAkg)*-^{Q|l^N2chE`8c zukNqDIqe)+FHEamxqlgw6=F+fuEn~%KJ_azf$?R941DqhrF9!a~OvFXT^hY zMR8AWhsqmfk$75oEVJ~er*dOYaSb+9d)KM*0?Dc7%yc_Tn}LwLp=UregzPurGS#G`@Xb7g+57N( z=ARzVkB@RlEv02@$8^ZkGvxUU2^ozUjUfp#xK3qX$s(YYIx>qkwc8@*fhmX?W;f~u zU=J<=^9#NMZJ_6RIJpPwKCFCvaj0PhhHu~y-zfZsf65vQn!;+!Dj5EOpb?5H8F87G z2?^s+6H>R+SDy-wC?0JQlG)1|IHfKjK}3}zMA;xinI=!JUTSqe6LQd96)cSV-9aL$ z7LovFT^@hc{W$D(RjBzpBN_~7pQ|nng=w*7URl-5(IYcd;Z@xjjpYe=U}yPx>>Be} zP4BA)kbfs=T0ylpeq8%u{r38U>gnC;3e3A_&HnbgxpYVmzysBtJSV^uWr<}4kc&n< zX7mdN6H`4x(h4C%!IH@ERYJZ@Xf)H52w@_CW4k9rl-2;Mtb%|794-<99YgXYK|TiZ z(Ps#@2Ei;#RV7UY;W$O5zJZY@lIVl^(H$Wikqu;b(7t2#*NEIzDPcH8* zotw1x?b>8xvhm%9r|xix;NlqI+SAUWT~FE%QAj^3*(@cHK1qZ6)xX0YK9H zN2HD(j{t)_!K}6I9#veHjMwS8t9-?9*-a+LC*_qK=8N(yh$eZp17vDpjQ7x)-Dl@M ldTaMZb02xT&(5iH5<>$2CqI9CmpwRj{*h5Vet|xV?LQs?l6n9D literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/delete_webhook.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/delete_webhook.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..038dddcd8c54f33719a702772325f40bdc4458b6 GIT binary patch literal 1643 zcmbtU&5ImG6t9};`P`X_giTD)VB-fkh|?eeWe7pptm9Y4kliKNnNZu?RXf{mPgh%2 zopnME3kHm$;ze@Mg9nL7?*0`XM#y35(?SlC+sJy5J^5bujLCvISzZ15RlTa$@Avyv z_s`8{ok08b`` zaVaNmVGW?TMPa!mUU192=vKHTs=Ra#*42opsV0Ca|3G=;Hrb?n;a1D7-zJ|@cVUIh zpY3Maya4Yu;)>YVl5+dTA9WkrnijU%3bZ}S3bKu~l^DtE!rsZ(*+FEmV#HwwoAy{H zHWz-tVV|`1PGI~kd&Bd$aoF`kPwVcw7f1xz$&>2NP#BiP+%rOVdcv&b?s~_*EKH&z z4I3pF-St(Kh;BeoIKEV(V`fZtq#8OK(rCwvgBN&) zaaMb_Ic?^1Gu-{d)?AdU8&ZbX(nYRh%wiGoAR5lgY*W<)dei6F5!M)s$J~od;Ir)= zPYtyy;i|IAaHLjWM#4v}vEdWL3n=P&aK58=;H;T>9A@sqeGl%uef)2P7dX911A4RY z6a6MT!Eo}5{j8>6NV|}hbP@}dRv8PTz%bUf(&LX6$FvAH8OzqI7GzIrjAi05rtzSG z^t*?bFLVc2q}m=VNyI+bPC#d=7_d1I(e=Rx!Nx!bM!Xt>zTQyi!Aw|ZCajZF%VvCc z;;~wU%-73b^uFrdZ#+9`46wiUHrn^D&W8D9V{ial zNV}Y)X@H+W%BWYzaQGC)8^}iFjRa$9ow1SRNr--fu}=~&oJA^(ap}Xfh3cnGASu%h zwP$IIF*rpmhd1LdJqDAHK6RKy0yChvJ!91uVF)5nbrM1vWqeaTjjQl~m6<9AP;S8f z=$aO+QguquG{}k5yBGIPytv!nf5n+trzRFy?7v&ip7r{EWpPScrE7HBB4^*2R_Zly z$^W*sEM=bfF{@6^3-7n#iK7{shI+zI7zy}I+DV5R)JYjBCvBvi zjFEwP%2RgM$r(A&(>!D6oq|!&NPbj)t^)!_Qcxqs z6GoaRMTXO};FBXf1$uf@&lp*r1v}TXb36}rp=alLAK1m7UEn3K`(s=5$pN0(d)0q(k~ zyPkWhAuY$0%etlD(QUv-uS;PDg6p+q_)zFIFR19(VnuhFexTQcZo0b39m}=+K$?Lk zA%JqO1JwFF*lI~w>%J$Kz?;WkE}HjnH}HL@xS3a;2{6h>iDpgK;PhSOu0NDqZEI-qk8N&V?PACjq2jZZ0Z_ z2MtRKh8|nO<7Cw52&X0_VB=W9Mya<<&GYQJXeds<&+d4Z%cQv56n;>qatK&1ccIvW zVjqa;2%CKEc+A>1PeXf|9TE8-Qyeu2mdOFKU<_TN{R=*ocw(1i>ViVBOQ`0mcl&;!;$0R@LrS$ z%Hh#>J4F~)bDa{|d8E_dGtobuKy4jjlJYdaRQmsgD!kiE5kfX;YBcS7{Z;KTWJfAx5Bq7;psD-9lLXo$^R#E7*56P35g_AsFaJCv-u_zZpfKT!g!SJ)~F~A)fqAr zLya{-;_a6i^h&A99jBAlOkYT-2%AtJL`|)M@NZ<##-w;(o(2>1;(rgKlhiaVB!}DE x`x@zQsV5}wwEwHGZT}WRg+y;}@16A98X)kx_-6E{(u=)ke#fal-Y~C@@He`2p&S4J literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/edit_chat_subscription_invite_link.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/edit_chat_subscription_invite_link.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..130c845cb113aba9c241baab3d72b4fc52e87031 GIT binary patch literal 2026 zcmbVNOK%)S5boKTecEd$#)bgSX23$xhOp)W2P;B^jb#GKf^aNgywDj>x4mP}W9jZS zIP$@VNCXMEp&*e12NXcLAP$Hh!NHbtSk1{2C*KyC1M-Qgp555y5hU6@<*M$k>Z-4* zdcQ4~O9aMGU;VQDT8@xkQ5X!6aTxonKyMR9m=TcBa0~z5mIiFq;FND6PXaoY`&>_P<0UM5u?skdBpIa>D> zzv4%0dq#ix8V~r2aKo!ywPNPsMT23bjIrMW=3@w$6USi0$t*zNj>#=2%Q8-mnLN*| z3vi|gAp)Q4^LeKL;pJH|m3dK=S)P^d80^F?vTU%?n5LvSz=-xxvY5*NS(JK zMl!65R;)kG-$AKP##p>qCRRxZpf>K7>A-ro~N@9y@}HH26H3jdvxtXSFA{p zMYWvJxF%L3j<|>AiUV6C58n{B;VZy=VcdphQiFY1xeMPt_|mcZV25Qkjm^xa$&5SZ zruB{Sxo%r%FSAiK#R)hr#*m=X-;-)4$;wWfi=;pyN4}!8noGuxI7=lDmMQ&tOlPO!MtntTpQ~^P`pKT1QtBg}gO+wBEepFEu3;&~t6qTXR>q zZ1(GAIxTQHjX9$_4@XmbtcKbf;z_vj#@UCXUK>PJfy1&6hAZqVP!Q_5lwFfW2mQU*rX2w(|EM<|8brzun*kAi&o zT*6uH0X}LPAXL{m@^}zHat(1Bwj`Fz%K||Wy6Y1j#U&nA*D9 zop@oZv1?6k>$zi1cC8y-YkXVJ9c#R6J=J}pvUO?Os-$zrs&uVqck|;tGL{|bjghId zy`hmJ;Qaqc5v^!b4~RH32%-TP1G38Gtm6c`V&C z5F;OaKnanOC{h%02!|XZqKG@cB8RoaVKpa9IdPlFIYd6Cs)sdkf)pt|JvCKbUDZ`z zRqy^>uh$5S$3OhK@?C|H-%uEiQqCCL*MPZCIN^p*0>d^8?K{AH0oe#*8=TnYWys1d2+J;V(=PFXD0Ay9?5RTRz?Yu!WxK*FAXj(gs+McH zENZgB%kYdmF!_OdWX0h7?>6j_d*n029=$|{-{x4_nCD*nP9&3HDe8Hya|NQWQ5ct% zpmEnzG|=JGIHCf!($EP6bwW-(HwtOALLE?nCG|pJSI`qxNl(a*jFKL8yH4DqOI<;i zqnHMXis>@iQ-=p$=&4vbaU{_=hCR3&edH&@k+&ncs!!9FUFQ}CCFr#4ge-7Erz4m? zT}}VPq4YZ4Se>Rx=nJJN1P-a_Bc#wLLgXlF>lXc3#EA?QopmEFX0I>FL|mtkpGsU8 z>{~UB$)zZfu9&6WIPR(0nHe{dq7^?Yb1Raa8AwviI6dzqVx_^*2WacGfs4FRon3*yuvg2B~UY1L8j}P_g$;E zCMV#8JBRlI+!{uH9F*#PAb)O!dDAVMkg~;sy7Bljt@?}F&IBOIQ3>$ zg$2Eu)yTn@vyoj9cjgM@w!s@|j^^3dfzJ`#hn$A-0CHG&sX0VM*H?}s_Y#n19kIpc zVJxjN7DPPpksoF3X5#qIG-bwkDc+MPH6Ma25t%-qkVK6bZG1s@I^0{eE4Xm4k=~mx5(zk%(+_YL~ z+O@XIhca@w*vQ7n$yWxipULV6s{sH1BUN;yz3mb?HB51_IfCe~B=F+{=u7+?N=xxt z4*=LG;Kgy|0dsF`*H5cc=LBu{qX|5j`J^Sb|`!R literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/edit_general_forum_topic.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/edit_general_forum_topic.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..997b0175e1513acdefd13befe4de34a8e2d1aca7 GIT binary patch literal 1778 zcmbVM&2Jk;6rb5$f5uLrY7h+pMsSE61-plyOjWfCAw)D5Y7$i}M$^sC*j}=`V`kPZ zK{*(y5(NP_R3s4MfC{J=PW%-dg49E_r%0T7GYSWk6K`g1(n5M+JoEhC%zJO%`@OgG zL$z8)Fn;;^*UnrHq2IMI8TpLCM=mgT5km}zD8eqrnzuqLvRylJTqnx8IoPwA6Xv6W zTfoRdtBB=pBbMg{UOYGPi0;`4-G`M8x5Nq?s8)Qa#Trhhyf_w#mjohKH9M_tzWvq; zU4CO_`OUS~YHDAJchlTf45trqW-z_UL*A8Mw9b>BV1DK{qvKof(KV1ihWI&hF+;Ak z1$nqOcibGa+&r^+fjJjJrvwoLpU-$+lx0@AgF2W^-LAN$JLm)KmN(GkzgA6WS6Gm& z@|a66d|k*vv?=<5?_Gl6$^^!i;w0$>ibN(lk_f`V0`@qGy@(UhG5o^V#{y`80}{l< zBOUFKs6n60t`vhl@q1oUC!1iqEfNw9R6@2n@j#bFK^&+=dWn$QSo_!7+D8@u+EB%dP&k(%|^o)lGl@QmFhxv8xXx}c>UmIjYT&@&m?QEH%`)7efA$@ zk7rEr-wEPmi9o*ZrUjiQ4OnV}m^vENbb+2)7E1fO%!`x2r#rVi*;NwS9i@3`(n_6{ zh`F!ZN)HQ`?*1u+@X=*pzQlK7Gnt&j&OKQ7VP)gJe@>XShxaUozp?i0@9`JrTY(<8 zTQy5oL0QfK`3cpmG-ryN7Ab}DC6v~3>6u5Oq>6_fN>7aBQ(&2vDD^{6DN2=2K=;}3 zxcyqQeH{wiUKT8fyX~EUX$A^dw|RWCeKpu_t03X8^gVwEO0C*nAoO?B$XZi1G~jex z4Qk4fwL`tXE1!XTK78R+RO^%Ap939r9>`xqG@3@$=RaThWc9Pv2bKB#%KCTLf4%^J zdcJyf%w%F^{RnK}3CPl{0B-=2)0)!>n=;9#HFpL`ZAt^C3r%TSrZf_45Nf_c>H7mO z9G?^@Wx|JTXIqFctpbjw&HxT*%V%L% z>1tn=`dO3u`81@c555Hg2%P*zmXj-vkR}y0dv3UXFuOEt9Xj*-X8z{Pk1UkCVjVcu z;o5NRqqPHP@vv}qgr;&WJSrASK+*rACF3FU^9Yr5lYm>bvPQ5ofbSX*l={I;^T}=> zK*|u%4JP$>05E!rOP!*8Q4^E(S(^b literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/edit_message_caption.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/edit_message_caption.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e4195ca2d7050eb8980e0928a9373f78deedc46e GIT binary patch literal 3215 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 AqyPW_ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/edit_message_media.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/edit_message_media.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d5142c69ce1796810dc6b88cedf314b01312464e GIT binary patch literal 3196 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 Fe*>X(@v#5^ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/export_chat_invite_link.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/export_chat_invite_link.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..66c47df437befd6de081952eee4f734f6b59fa97 GIT binary patch literal 2282 zcmbVN&2Jk;6rc6Coj9qg6benG5fvbpU~>*tL>oegXe~q%RcwtWlbx|Wc)e?8#&KO0 zDThiF#K#F0i3~oRCieZ?zEe~hi*A;VFQi+OHa9*F^-7cK z^L2apL{oR#rrljEIG<91hRyaRp$Oj%n5LTT^|rbPfT zackeYvH?P5y->D5n#Gz;x@%$w{Z2=Q5T=cJ!jKe=rdDPA0oPp_C@XDp8qb9)d}%{V z5i~C0Fu`2??d%Cn<%J&Fido| zB3%V3<0a3hN-b?u5t_Cv$8Dg>+;$ByB_?sa#AuaI>ZWZBHG}9q>Vr(fqI{a&2G`bT zd5zni+#WXGD9boG6FI>7uX<7Pj!!+~*Q7Vm-X<)E{C#Ff$mln+7TCHCkDkBM1!GitY|J~O}>{$vvykC6oFpE@HTuD zW#bC4=oNAj^n`T!4EjQNq}8Lcp=25cLzI!W;iFU)VDQZBG0XfL_7rRnmtpg*a~}qu z9`WJH1Gpc;9j}j%IV{1PJC1PfBz|{xI_alcN8m6tQ16y*uAtw)GT!5K!;-qFpsmuffQ9j~o~3<_Fnb?rPL0B4N{yR~a# zr>0gQ`; zu05Kb-=Dq;*AF+${~K50(=j~+4OGg+$xXxFW@sxRXU*}9;ZGTG0@~(;LMte{;y38=r^wPMmhr0?q>k*A%cixp_Zgc62}QE(MoE`maNIGl$L6x zwKS|JiEL$BSuHDY%F4C!T3+C^HP9+(1;81SwTdl8QzVo?vxwyGAd;sF%|Fw7GkTar z=n*{8&`M;Wfy#v^TrErCfNtB4r+cPjyJa~n&VMjBgQqXgOuzefZ8l84Wv_?XdYhYd zD@-le0G=eGt(l9osdp?7qGYa6*VR`jz@dd&V`d)DyKxITBu>jf9l2q1GB%!5Al4gi}0eo_hBfzN` zrvYbT3|S*N(DVCxjtqcai1Y-ac~X1`hkC>hCWbaZ6!0iU9<;!QNtR@v=1EEql4R&E zYD#4Aj-nOsqE94EX`tT!^0834VZckq;RIB5x#Of^>8?9@T{j(Gm5R6CrfwxZNhLo0brsIbsMldO1j>u=XgD2a z&`EXG^V;rYwQ4wwR=l{l6^E@TUD+`1|6ZVt1&-i}4%wN`hG*nzlEtx*l5! zGsdd!VUvV~CUaW2rzOE7%*Ua?T-z)5*vU69g@=1KZ1e~OjlpF zCR2YRvhirE-!T2i`D#(b%&fLKXKH9pm;o(QVH( z@EUMo#bun~VLHlWDAydD8a?{)2Ep6M07BC4WdPqw_uxuQM{|A@+oFy(gIl!aN0P22P^ zF6Y7{fBORLQmcvazXxKY5IoFbELerHn**J*o{!DF#>L6Ss}5URoOXz5uPm;0nC>|Y z15*~MeRJ_Wb9vDH`bt=xQj6@tI=g~t1)YET;xi7ot=hP+&niBznQm!c z<^GX@qg{xJ%7>zK90nXES0It$LB1x^e2gQ(l3|WGRoDm@JXwMg>;y+AL6l3p0Jh$u z7>9X`TMp>}QE^zn_~VXl#g+`l#4(^6oH1b$fViBHQ*c!WjH0j|TGXKtAP*xh0?KCQ#~~L?9pCtZ&votq1bO;OseH9`a?7d~V6- z0{KR8uIkIfz6_GjExF1!HWIUCMasLs`Hgk05HI zawHDG>$I1>5V2>9y$UKXp!*m^Hz`R{fKL1Ua|ccM|222e8NYu9XvFWI0jl`@GeD}} eKfCFdCCJ=A#Wx>)H@iJF{yR7Q@f5rGy1xLd%aNY| literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/forward_messages.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/forward_messages.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3358a8ae0c4c61e5ecb8cae618ef0e9fc102ae6d GIT binary patch literal 2574 zcma(SOK%fLc=q9EVmnVrLP8fP4->E}LRA`}s)#~}3JFqz+FB9AW@nr%ws+l`H4qe} z9FR&?TIG;xj0lcqPbe#7oV7b^Q{) zc;(W?&nKrQJmrG56L5LS+t2EOt)5dh-?u!{0*c@Q9&Z8Am4y=3kp?fWINPCl*ok`jYBfYqP)$g9Yi?~ zh7#zlGBuQ`G_gx3(&Uq9p_8We$YO0-8f2MWdhxcb>kU~V^wrHKNHq8**A=3?85dFC z!izw@J7R>k?TU-Ucl#rWJ#+`{A)O>z?0STX5=lKw7kVF|ds3lq2DSdPX)klxW_NW) z!bWlZH>iD5gLQ*b%~>?LRtY+#Ikr}8p4BR~vSU`u6huLLxn>tN-CEL0rbTkvWKrXG zg$ky#NHt!ihFLTz**OcDU0) zsqOo&=`3nhW;@hyz=>g74z(O@hmRmbVdz46zE;r|m|d%y)`AAfm1xxw&bI?-8_sFd zmd0y_0ZE>M^dKgtFNv(ijk3=9_$}SE#VF^Tr7GpQFd%G_Tv*LXa;seg5mGy3aLlMv zV-^IJ45~e2*O)=awMECN^6`A$uo=xc;k%Nv*+PEac6eT|nn%Jew2TGnUMA#*p1Bt@ z7Ig<=@j8pluHY8c5vqZNPkG%f%2{MoC*pV?F}Xfprr5F_=$fI67u(B(^~GUzvkL2h zmyGoa& zI8Whu4o`F4ZcB)~EG^5+%Cfo~S&kBEJ-QrwBK;u2m51QUQl_#|mH{Q!C4jhC_Qd-u z%F14Z*Q%6xag0sNbTG~)yq+ClV@}IOjQ`&d>j&dr0^?vNFy;xM#rq@H%In$B#^=7U zS!wQ~Os%qIfBwf~ki>!1*-BFwT&d_z-|deB(UDv>Z?24)Zb~wqOW@0puVL22RXOFm;|f zZ`40e9A_|sZ$hf>bb|bp$@~|REJ&lzT30EuGDAh@wI$IJp_AGJ><(M za#eP_`&W&%!G<~nds7_}+>-1bA8n}ptM@jPwFeCq@X<|m)Kzc0qo6-fKe2IkJ=ahH z&u^-Ep)xDG$4;(HuYOr4Yd0I}N!Xj}NmreH8SC@Wfk@i#Lm!-V$3Aj%XZ-H{3FuiH zMA5zj^|1}5er^r>F~N?b1KNhNF|!e0&-)3%Nur^Hbz^7=vJ7BEjX`958iW=ah--q}k#Dfd%G7+h51eH)r(|b{a@A4}2AXuSk;Q uqVtV++b_{bWA}EE*4VxM=oty}dK0W#8?(={PwZ_ap literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/get_business_connection.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/get_business_connection.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..43a163f0f6727f850c01e78a046574e79596b7c0 GIT binary patch literal 1705 zcmbVM&2QX96rWjpz22`BMNKK9PzzL5E6VN#aaffI2qAoRg-9!eS!v?6XE$za&oVQn z1oeMgH-xdl5oDr2ym<$<@b)t?pV5tNn>iAC*a@bJ+ z88GSG3gx!rIfHrDj_3Oz8S0c-TmzArJqG=tT0sr< zRq8shhpWK+fcK#-Wub>Z_u#z`Z$555(FCOc-^L-nUHTb+r<)#{)adah82*Z&G0P$y zQ=Zv`gh?m~X_?vbvEYcH(U1^r&zE3PRwYE2h!6pX4MAhARP2XDCx^%&)@MzRP^WN?c}{AI)E%$fM9#P%g@3tUp~JO#dZ<( zvtT1SK>pc7vnAAg?%VaRH@?|;(6}&ZY^nLmdy4kRT+DwqwhmzlYFT-D4d8W-x)%J5 z5}#7~x`HS1VoFF>BP3=)8Y#X($Y-e+%{3K50_Fo&>dwiU!01{69$>me2s9VT(*^kq z$VV3h*eWb_s%oVM*r!nh^}zfbsD!HM>-=eDrEWV-6eGR|0$CqDvyxf1XGoC-TDiP; z?O^4~UT-Ag6?MN`K!yK!TCmYFfI zRS!8-B1pgi2^9$r98eMJonL`Oka~!Gio_|mMd5&Q;>~!sO(c3@cKrO_yf<&(_q`ea z+-^4!j9sD%IwXl}ip`AIQ18X&Er}fMY zUC$kB|Mj% zTG_t&!F$VO>7C`JcURX|%G%X@R5}|ucn_^=Lu+X(QrC(!UCsOa5Lb({H(AOCBFb(s zwZ&6(W~@=w;OZ80yW_&;9}6-gmBeKG(?|@YaDc$FE)1a3UgJ57b&vGWZ|$A| z_2>#H-{J>wYSh#ZD-Yp$1Wz^YJn>MA;(Iv3_pG1r*XCTp8LF*`ISBj(b*$2n#gK`z zL4ct|5z?{CvnPrplBIn@OuRS)n@W!mLp321?gN4r?i^o#d$D(mi|yVLr%68OZ5JX^ zToB-?$MR2l*OSejOcYxfM)7tuV6r!9Q@856>;iQ}lN1a`;(17W_soQ-U|QGiE&F{6|g8Abu{eI(WWj&Ecumg4K6@XdL4GP1ycut#VwSPtv zkVhFKq-+wBaayEWZxQlw5v3E4O9ANKs%Le8pn;GP?!8D|NP8?FZu{V(a63{{>JQs{=5O4oosAgy1(T?EpE{%(|Y zxPU-Rg<2n8p}&@;WA0@|puHJMCiLgE0(?$uCaWglxN*5^!xixwn3^5=1Bh`AW4w=E u**iTC(51a+&jaM|ou2!rP4JHE7qBMjzvXWJUGMSi>wg*d-_Hm#)&C2~EvY~N literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/get_chat_administrators.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/get_chat_administrators.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..834aa56d46bde0fde9a1a76748d4f4cc6143dba8 GIT binary patch literal 2100 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 FJ^)DFoLK+> literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/get_chat_menu_button.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/get_chat_menu_button.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3307b674744fafa2c35b03acea4e85aaac740615 GIT binary patch literal 1907 zcmbtU&2Jk;6rb^~zwLyiiBLi#ZRi19TAK?TqBM}YkwK*LG_n6bTR))B_wipd!>W9Qg}+Sfm`HJw@V_n^8ER91w4I<2q5PI53`le)HbEH}C!4 zoB6R^E+81ceEYbwnnvh%xfqOm!r+a~S=d1?)-jfR%1OD3uDGhMx@kS_X7mim z6-#xpZcfj+c|GqI^a9AzR>mp1CB1}E3N?_G-9uK6mS~3NX@TZC%GBUQG~^yC2t9%? z8G6~uuc1oeNG>ZlDjJ^W3q#nx$17@7zWx645~;tnRKNLlvk@ta-cFQzwSo>~X&bcL!k4OwT;W~}F|l%BT~yy7lci1Z3M;&Yx_eS*cee@~TN7m5bzfz9I8dTIb4Ka-N?%xFs#yY2(*tEIk#$js0 z*Sb`Ih-zlQ81;m?>6j#rtHW6DXuhZMz%(i6)j}NinjbKe&S{%M z^!Qw@X8Md)#VO=fpLJ^xDX$ql`x4|M!;-EO&#{AO4CLn_X`Yk^&G3Qki4UW!v?I1v z!E7AxjxLd>U?ilsV;P>XO|tcg!MdEm^*~XE#c4)r)Ay(;TS5-`FV#h0j~9UX20wsa z7Xv*=9>VtszGQs#L}R5ad=K0BUg`(@ReZCc&y{8z*H5UDiqbsjQ5NM0u{~Q50_{G2 zCOE>W(;+0@&n|%XC{IXS0z$a#N9cv!llN}SwKjaV)vEiJ?R8sQ0W*Zp2w>Tw-gfI9 zyWQfppjUf_xn*=IZ=IH}mb4GA0jMNK?QA7`J51i#yVFm>R~>|V5%jzYT^2^eLip?vQc6bdo@)FvhO(JK9?i;##JUr}bqB1Oe50cb+;RXg0Y=^gmXSmP9;M?KAVzx#ex$YyPFY#* ziXnPla`7P&wv*g^Qp^Q*8I}@H{wt8af-ycoFNWvmA$mRhuX%`WhR>b{NDI%;er6g= oME{*0sN-M17EWCbugr%F%i+}W{)Lr&b@dNLZvXQcMsa@s0E?mx(f|Me literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/get_custom_emoji_stickers.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/get_custom_emoji_stickers.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..32a662eb6f085520832a9892cb714a6cb7c1807b GIT binary patch literal 1722 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/get_game_high_scores.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/get_game_high_scores.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cb994801033d70c153c6ea27dd7ea5f6ac988e8e GIT binary patch literal 2352 zcmbVN&2JM&6rZ)%pNaDUqy!3O0%^f~I0w{AimD<&rZl9e0nu)ahVkyiS+d@BXU3ta za&RT2Qi=9ffmAB>Q1wIH`&aZ}q#RaziqsP~SLvbR)c1DdBnG5P9nU_$H}mH0d%ySQ z?JuQLk-+%<`#%=FJRyIg&>y*kF*a9#c}N`M7#?XFmSG^D@>0#Tm2R4r+00m(X4cBW zdfG9)Tr+RwfzLQuuh1-7MT4YBl{mS3#L0`I$cX%b{yWGH_j8(%C-5Z08gdE?q+EQ4 zV%dm>xbFv=Yd7#!*^ElpKe={^UATPd!UylqSEKZKe>F1aT&1J@hb>g%-m_G4vQ*_w zaoKGwE!cq+&x~Ys41{)@2K76_)~ZsB z7*ur2TXiHnn(j~21YIbG@vsuwwwOk2gW2PQxHN#u( zF^C-DMRXHbVi2QoSRa5{MQPX9Q4S+ut~39<)W1TX!uqW!2M%c1h>A_26mJONcj+iC zZ$;y-@43EUI~wJ*+ymD^?nN>IBs#{bFTRYlF62td3~FYRij2(pz!x^& zSR8mQp+}J+LX6Fez^seJWt?B#+~gQC$(m*rPk7Grei!d*D^mD-^N`G zI!t=LY|1e>@PfO)k#Z`^sCG-pD9@PdyPC0bF50upXQqU=$k?ln%h$kURA4MFd&U%Y zQ@o^85Dpt?SMs7JD;k#O<| z&ez`zkDl!nU?E=Z70KS|-q5y)n#l%on_!KUhZ7J+flq)OM=nl&%wYw{eMk_PIL&fD za+5&HqX@B&y?{kU#+rfC_K+WD?6WrawsvxiIe`s$XYpVGNK^tTZZ-fT=#MZ4l@C>j zJsspxkaxZtpgUNS5=$z^3=PGZvW4eCo(=g1Y$+_D_v8`OD)kAzSFHm92zP$HR5p_b zP=Jh)i35)gukSnFxf)KK=*(}JW1YFq+?R8qIT;?F>QuYtR5G8MQ=!R2I^DU_HK&vL z)SM1YD?EOxYff}cpg5nJr$W=&$nEQq{h1MX!&@iA6Q{$Ov%S*Z0_5WVkpkL^4Q>-j z`(e(PhcOk4ZTL1oDkOfHqbzi7KsvzEdDPb85vBRP#IC9)yCtdV<>huD`v=I22aP|_f4L^fX&*@6JPl{pi6?-B9| z|JtIaY;Tg)g(EjzrPFhwD3ld8RfRcf)NB4T1NsOhxdZ2)LIxu(@;=yYB@-7nH+KY$ z9$!VjPk=;JlBgkR@Z%!09LF=D%_ z)NG*aZNo%qx1q3UQmJEBjiCtH2JDon2Ez))CIWSV1#R5AEp=hoK$tXPX@R799ViB> zv<$f%FYdT}Ia5O>STD(hF}*F3Dpz7?cPC)N63Y)=54M;Zynw`pol5s6YD=KUwym9* zUbmYl4WT`4PpI^$iwR6uOwyYpusKvg(*SWF)>m88Hs=NE<$T)VJXf;J9A4ynrxe-g zPK$G?63%siEuAhQsOrMj;L-D(BRQ|z#`#Bb?Am|w_)#x@uJky5s3abY$E6llX^v`Q zC|<@-(m`xe3wI_W8H*8^__W?`&1AYL5n02@u3kXG%C!)fTj=)wezS%jv}eS*MY6oI z*FRjowzuv+eQ_S<>cr}XCEf;Br`^Mw2323{l6<@%(2l*%b-|%3{1T#*_Px3>_w{9* zx(8+~x|v5QJtQ{{&W`Wo%E8%jNZ7&IF>AKz^%?osy;*;I_uC@->9&6VXTMVQ2d|d~ At^fc4 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/get_my_commands.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/get_my_commands.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ac6a5349ee06ab717502b0868f88b48532761d9d GIT binary patch literal 2513 zcmcIm&2Jk;6rWx1`YT?iO_S1;wrtx#lu~R&%O$E%Lt2H3##E#gV&iJM*%>=-c6QCo zxM0*n4wWbpATCfOdguWGRqu#DfKT{chUa!5Rtx!y7oM%xU4`3%se$k7OL^lN~+lcEMS`$#xx zqB|LqaO;B4dH-ydN6WcPh>r{e@+Fpxu8c5p*JnXO*>y|<}DQqtR zQP{PR$Lf0H77c8nfV2T!yCo>MeK)AL+&V4U?^D_0fdG>|!@1j5yG?t(E5!5-w-Ks@ zm1Mg~MG5xD-Q7$5RNt_}rJK}~qGVsH_22Ho@g}7$s64H0^4Qa+Az zA#8DvPTR{;HpO(g?1h|`WEZVc$m?ZzwJ5vI#z}~uwR<7P4@Va0`q`^&{obqa#kjy1 z`$vt7xmy*d?Ol2(^6dpW$lfpSLDs!3vd2rg3{>tc@_{Z%kzcen#thr*A*lTi-ixIQr!>g1|ZR<{-|Ojkb$`AT&*B#oe6 zU1`N*3Pa^oX>hB0xv^9g4M|^Xy50&DzNmJKyPPzaC_@=x*6vlfC^g&s1Z@B5!5!Hv z_0C!bn|K|_U#qBd3Ry?Ly!iRt7jx@{BWs1l2XFpr!H>EwIb9|Z3yYiZ3{2c4suzHd zQQ~U8#PP*&@S{pRraX%(KY`0A#!(()7Lt~)_yWcswOqez$zV)E50a(O;_9mwSs=xY z2KfO0BF4}`I0?6#)o2)${VxY-RmE^M4&&g}9&xTc>id9?#wWle6vpTI%gSr4M@E$4 zF%ZZ{|F5GPX10SADWI|O?+&kzPOQ#vj7_XoI)_ls>Wm>X-$8lP>XT=&co3Oa^^KF0 ztMhBdWO6+=CO3?kCz;U>8aJz2=LFh6w()AYb95{R68g_H7w?+vy^Zo$dNEd}Mim6L z7K}`QfUD1Ol!oaD8BUU>3NnE}{rkYP%E64sXN(DlK0>^ph^0tTkzqylDY73(WGuNb zp${lIPOh!E_y{WDTiJ6-1-!-2fT)lV&|0XI(ll)Yomks>JwfNz{@v9va+=;j|1TLu o+VM4HZ@)U}H#CLbVET3C!P%el>nG2wkDh%N`~3M2o^gu)22GsLcmMzZ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/get_my_default_administrator_rights.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/get_my_default_administrator_rights.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dc47504f869556610e288dccdf0113781085adc5 GIT binary patch literal 1830 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 E0lcuOf&c&j literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/get_my_short_description.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/get_my_short_description.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..88844bf57a470c7a529c9137ac653b3cd0c8c25d GIT binary patch literal 1761 zcmbtV&2Jk;6rb5$f7>aP1{GA$iXL1Gu{g@|Vrw+r?2Mfy`(b8g3$A+b zp%O&`Zm3AW4Yi;ik@zb(7^#P7Pmy}c%_tmDPQ00on*`hw&$Dme%zN|Zz2AE~eo(8G z5zuen|33KDLg=xY%qgDcRjGQtpZJ*ywu7p^L*C6Tq z513Z(q5-CrJ4;UaF8Ulhl?^n1H)`o}hso~v-;v!qDBD2S1heIqFYHhUX3N+fG6_q} z_7cunB<;;u+Ct@J)1$=fLCm$)(7(wdI}wcAfg24IcgULd2TUeB5_a1QTp`*wTt8OH zH|2Q5L=zkm?T{RE*j#|#4Lgo(k$4^xqFL7QZo~=qSlix`awOWVmKSr@l!xFpV?Jzw zchPc3{&~nF9P4wA9iyG3%b@!&B)x;$yr$QMza z2ob6mp(`c_{Y&lshcVyouf^1lhW+h?yE5hk(CxG6X8(PEvoCzfULU#MHq>174{O}Y z8cDPOViJxQ6nZq~&%-gdUS0@ea~}4KU?ZBq{+^)O5~{uQ_4=2cuR4#a=cd&jjGy07 z@0D&gd&2i&2WsTA^p-%@IqF*QXVvty(pMEcksC5X(lQ}oOp`##RYE>Z+~81CAcV#q zU{!=YX$=HjOTYt6mk5C_BU!qKc&4Xd@#yA&RRyR{S8dlQdn^c`D43rGl~84Ui>qsi zSLdvx6c2zw=10GoVdaW5q*xU#Uzl`vmS3CncF)%*-Kka2#vfLF$GW&%I5R_)++{o~ zqcz;YGqX^F3Hsl>q@8B2k8!R_rNi$vDhkd)0-ry?$<_Uu=HaUc$TBEY({pvTr#XEY zWYAihE?gk$zaT^5jFPlhh0H;5B`eS>uftS9CVm7qGcm?H=#}Zov5Q*Mr;lA!pPn2$ h$ex}Yv;0}C09(wz>rG!>eRS^4Kehg^r&#Im{{ah4?O6Z- literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/get_star_transactions.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/get_star_transactions.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5ad40b6ebc64b2acf349c64340d66190e84699e6 GIT binary patch literal 1800 zcmbtV&2Jk;6rb4-+w0g)Y1#_fKv$HgG6I_;m;basJC@0?R+T?@u#Q4qIH}l@Seed_) zj(;wfiwMTA-~ZPB#6;+KwU~@tCg7bm2zL-g6bC584#rB>0xi@XJv1C6G#wN6bZP{- zFz@6+Hfb&>gqCArq@hJb^S2N!FpK4%nRrL{bc7zj%!X5>)-tLVx7D(WlPNcfV(Cgh zjzm>Y$}3mjTOjjqFU-IDPIEEQ-;6er!j-O4yTP`WojJBFUB1HINVr~la2sce$_fiu zhr8htlWQ^c)H^1_$OOEz3c?qVCqoXV$k9H4d>x$`j!88qM|CGp4OXD$1+cRqTgOV* zxopjfyaEX5G=Ep4<=d!@Y3WwQnYxWW$4+S(O`g?CGPB6!;Ye@(QM6&a&t#8B!j@~y zUXA5>VNW8r)d^efOV0Kq+gsyt6bEs~_uRmaIc2*FV=`Qn}ynJ#~@HfadUPn!DvmIY06v`Einq+ik&QVg`Qb%ljIi2Hg2EV96Xg z0zpE$8`O=Y?~(P-T;35J`WYp;41vUG#u4*WKd7M^Mz!}8LU`vQ2;bs6uqh{c*trMu z0nBV%|5rn`O}wd5d{^7lf5P9S9|JV5-sDe#>3vky5>xcLj3)&`{K%JtRL$i0zVL`( zL7R}hg!pkdnOKCRB_c$q$W=S^cdx$HXnh#-_11h${ixGg?{QbgoB+rz7Jb^f?604dT@E36_n zWP~I|Lc*B#0wtFSxzTfju_jLljXeOa0B4di2x)TzEMQt81bU8SS&zX@reSmM8i8Ha zK3skAY4*xT3c1IE0Lp~Wlo0vMNoOr4$c=0Tg?`k!F~M5mKy#PR{k0h9_U_ zH@9Z({-uFoXY|OhhsLYJGiUn?1LJH)kBqZJ`gQ7y>TCz6=yO_70ath$16^_P)B zb4p36R|VH@;X+orH+U763P_U>{?pYq6H-zMdGq0k%$!xRRK@33`Q^ zaW%1g3nLA+5v|@p)M6GhpINMo?!sR8;4PbPQ@e{A&XF=3IA06WG?RghvQ#v*yngAE zkG9Fyd)r&@?{wO^{&u>5q?I$Bu8hJV<6S0?a5=PoiN$QdgXAKUdl?PYnu|8y5g)$` zBVPk1hI~wsuU!UgzRnE4LN(u{I;&D+6Xw{6S=^z{O|*-teWT{vH_;c^ce-ftZLH<> zHj~RduKnh?&@Kz+%DqUqNs)#tGk3tG8@Qs(*cD8A?uV%>#$m{WcpY4=Fb;%hT?wL0 z0r2GhhzV~VKvckTn=5YCzsf@C!WNv#F;5xwoMP*4Hs&E~xqDKMM61~hGtN9YXT{6- zpxMu)Xa=L`Wk_khJgi;>=XDrcZjWpY=Y7`aKaz_Qog(hrxh}-n>f9vcRGVype}%HQMJJ zu==$#E3A2oET09R@Id@CK{E%{pZ|9IoA#~t{n~TW+9vcn=hXMLH%se89zz6bm?fGz z=mn&Ldj6O)A6Nc0#fB;xA-O|HlF@Oj^co?bj)QpasS-l75U8m_OkM}2I7k2=rmhnL zCxn#fz&-``@>;@NMO}eVMHYO9ERKPG%%1|6Pz8L8Kdoj#)k|S3$Cn@g^zxZ$M#Y*T zC2DBn?BwFX#<@x7(5O##COcp492hSiR!`56T{%CqD)#vq`ai-}VMXkT;Oa+IB-Lp+ zil5yvTp-|ws~<#e!o33yN`S?gt`s-1q{-+9f^h|;g!QD-iUk$a2i9gu_67bbn2G~& z3&c#v7$2aQrmOuBy)u1NKSVD~SNj2Sr>lKtp22|ZzvBDOo!0%+-e1b~_app8w*La6 CZ=kaP literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/get_updates.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/get_updates.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..71c341292fe07afd7599f7fd509fc8a5297a8eaf GIT binary patch literal 2228 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 JJjE&w|3Bm+0M-Bi literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/get_webhook_info.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/get_webhook_info.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..bcad95575519053a71cd618179dc3574676da3de GIT binary patch literal 1070 zcmZuw&1(}u6ragvlQgygl_Gj^@C#b%#&Zx66iU%n=m&)*IGyZFk~N#1?aZvDw;uch zy!GJ4lOo>zD?Iezq2wfZ$}Lh)J^5yLBMtTK?BmUwdGGyx@9lnGSg0eAZy&yQpOz5% zWj9l)`kFKydmWG*7#(E4WGT*M~^ralE#a%hZxv#M;BGFT9xGqdz z^1y~q#a;oyXSYBfBY}L(kzeB2cSPBDc?pU-P_#U1tO|1>IopQNIsw_yf|!1&$uLV# zj3hl_NRTQeVnYscKtu!5RC{Do?5Cj;n#7VM3{VLp6!>4oM5jR@v|b@fm{i4@FwzPl zrgdwNh0-$c%wZz5SLCE2u=Fl~+9R^_Mg+zqYhA!3NJkn1$Wk4~y-T@ryxIe_G)*`& zkQqqs34-DBx?0 z_-*@T*lFv~h=&Oa2COG^yO=|>=v~wHZe|+Ep_+r#nW}=J?}0k{_e@GCjm&7(zf zw0^pH|7gQL>e@8SG6tUA6g~prsq7Chaiz4FFMcdO`fZQ?{O3GF^%o}_ BIPd@f literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/hide_general_forum_topic.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/hide_general_forum_topic.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1eff9227768cd60a0b0ac3055f45b6fb6ff9daa6 GIT binary patch literal 1759 zcmbVM&2Jnv6t{P0KeL;ls)1HYkp)80R$;dXPEl16LYgAz3Xw!rhpk*^?A;wQGhS>@ zLr@PnRH7i@fP{*~g##*}-uWvy1gVE=PLVkEwkQapocip^_5;!j9?u&;zYo9nd(ZPz zvsp(le*ONp{@)%#e^_QR%J~8x_^`NxIN~@$G4?UG>q1nBi+(Zod@nBfCD|~{l1f&mfZZN$rA~8@bzAVg8@*sDc)1y=H!A0OdgZKsVF-Lx3 z1M={T!t+bK;Foz(RJeB@bZSUcRh`#wqdw-fTMfT<8-0TP`Wl*iTT|KWrI3qNkqE`2 zi&CZWx*UZ83n8F7fw7?lF~d-k*hNH)Btx)(JwfJ=?B-z?j7XReM*7wX(dkI2fs*Nn z1Vd)pWF7Q3r6F;u4cQcgfi923B-BPRBb7C_KCQO(ksk`DZA-NU+B~-$vK#r?X9Jed zm?dl=s5@Ps{g*=(4u(eOC+G2Phf(CtPK}JADgle49TG%R3r@m52@Tn1n#hqz+T;Ua zQk7`37)UM_udl0ATqiPt%z{8@-L5-$)?}&zu}Fr-jPzos6G$c6=BS8msRkWLT6fqe zeAU7>$bohkxtN@jY}U&DQ-s4A*Bc*(iCG{3)3vN((V-#F=IOCzqja>xSpu2St!<_T zT9u#=va)iyWL{S$BCxGyhy7ad6f6%ez~Wnc2m0Jhh#q#7-cm|gNSKOsfJsN zpz(GOdv7oHu0ZvB%aVu5ptqH}PN9HkPb4>b?}eK^9UAfahy`2F2fD{XX)jMF?^WHg zu+k&UsRKRlmG)>yorGgPefd}z+mo>EJ=bj@|LmgiG-{stYUT6QFIVq3=JpzI!TjNh z{hnLOxySSXEKsYQr`LeB%hA`|3z!gL+6i`$4@0gX%&Io|Xv$nmh>@OdnV_GPimO5jJ z%k+d@Id?Yu!|M6G02kD2z*<=J7eK~EjPV2X%HFecA1&-Xf9@l)_v{>(PhpG2@$|dy S&u`qHJNKs(|MeUt7waQEneIaX literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/leave_chat.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/leave_chat.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8c4ad6abdeff8d0ec926311952bafb801876c8b8 GIT binary patch literal 1503 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 G^7vnCW3P_@ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/refund_star_payment.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/refund_star_payment.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9d31f7e62d79d64178f162766154721f90e098e8 GIT binary patch literal 1601 zcmb7E&2Jk;6rb5$uRmft4Iz-0uT?`47GQJ5ib^4k0wT4lCQz}mG}-Kooh9pCGc!wZ zl!K8fQKZ5R6$uU;P!Z}KiT{B^D)nIPDH5mN7KH=qi8s66q*Z!hJoEhCypMhF_h#nT zTCIX${Ql#gy~IH1FD2x|%ou$12{3mMMHKsJfNhKwuld?QxAlQx8zAe{@CyUeHZjuB z8lr`ph?>k~#j|-dbXP~{9;|HGC0g7-jnYFUHgG)S1VJbr>4kx4XmM@x)2pjw<%89g zk3Q_I#rk`}=poK5>zmAHeeMjdFu4;_H;b3iX?T2e4dkyOX@+b}k*$3U$=f;lzn zlj^KUjb*SYL#n`=8P7_*LaVn>57U{ORl9r(eTnVL2Fm{%wRr9t>qPtC97{y5%Y^7fzBSBDEHALO^0Y1GE3D-mDTkunYRTq+wcZb9husjZciz6Z zMVb&yMm!K!+YKpeZ*B63ZCPQEhi+EVPi}+}cUjxYBe@}GO*uuU8S;K>JCvg3480|u zW-Z{$)0ENx@m#k5ST(Wk1u`y1f^p)}SQnDV=kl0j>P*}nhxeH>SR$tYA!InBP9Qy( z?A`!7!3%(NZ1S|I*yw}-b5%3d&|s;9HiHm8x&+Mk_zrB!Tn{^UVcmn3jn9rXRNKe< z8pS_p`}!~VyYyJXkzCWz>mlFmu7uPJ`rX}#J2K=1knXbJi|)F&-4&i>Zw(!H z*Xc9Sb-YlW*47|BuA-GePE;>)Je$K2Uw}{SojV0)Gtc=2(2L7J{vD&_IaGV;+tqK@ zZm&J4zL+4RR-Y`sGI?V)DFBxQ=FYDCg^)o=BVX}VLOzcif2t`GLPHm}jqNb>;~GGkwj6MR%{n1)5=jOF z$g?1y+Pcy~3^4s4QdVxM?=j)( z(MxmeG|CFEUIf<}@Z#!yicL8h0wh_z>D4f{9k_2r<@Ivz%I6iAMp7j|DlKQIU*xZW zsIU-wKoT8eJVECVo}7p1!okz#A+iphoQZiJLjkAB5A~nrgT*)hR;quVqEB=C5A-sx AHUIzs literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/reopen_forum_topic.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/reopen_forum_topic.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..437e3c671ba2dc6f5b34e8575f08c2d4b81300d2 GIT binary patch literal 1780 zcmb7E&2Jnv6!(1WXLj>ZwWSF`waTH|5_S*Vq6)R7Aw{$iqzS0QB6l+O?hct5FSe&8 zC_*_@qDX)c66ygC98eMJoxgzthpp5@G^a?MdRr6@C?}ph*)9!m!0UPY-m{Z zC9h;58?7K(xQl3!l~{RpbRv4-AoLKve0UXFx`7(yCt7S+*@T}YT=^>GiEKDoef{QJ z%Vg>5^3t1ctgd9vr)#EhCkIm_k7wcdRJ>@Fv4P?4@y-gi;A#aiNVB?9sdR8M#Mrb%%>B*iCcGo_|{h z!|;W`Pe|-1ewPvBU0yhLpa{D?B^Pj-L`+H?Dhw$Y7lIj&ykkUT-Nb85r6Q4dG2oOf z-dYzayM=iInFImYH>(DV8$1;OTf{x3`f{<=3bCGeqob7)A(RK8b~ibXvO2(N$_*HSa*`0}LXtxO@)XG97YX*d z+MUKgTN=~@7DZ4gOPm3%)J4A}^m8Zlvua3LFMJIIFd6@bwp%C4eWCO literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/reopen_general_forum_topic.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/reopen_general_forum_topic.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c0131336488966febc123a664455e16f6f7af917 GIT binary patch literal 1782 zcmbVN&2Jnv6t{P0KeL;lswJ(IA`677t;#Oq7*!P^qya%Alx$QnZ0kB>@9vP9@nX*; z1oe1=x!0Ad+@m7*LYlHT>Fb^eOi1YiROrP35zzLXJeTEE1tu zbXlq_?#fXZuq_CwPGGESLDFHUNo->xsU*tU5JrMXYQf35BlB}01X~g&AnO}nL}w$R z21;fl5)4_|Cf%VR8!{zvrc<&Z2m@Unhe@bY#Zsw^aSA#{+xT#2!=c+!ZGtv;mP58> z!V=_sz!Dm>gbf6>r|a|oa;U<=FxBp47vFXmMfU70l`)hjU{SO~vSb)?E)o*L zHRwR%y2D1{D-OYdL){`}BeQPuSttEZO%7*lvwRdL=>-CCUCS#5B^vU)MOTlnBc-Dq z&JxIxZf-L*&I_UolDmcLrQ z-<_CKT>&nsSAjLK=r4hcix}ev=;gg<=RUfy_x!n!$lkMa cTt1Br7RS@?lV7^`UwY$DEB@;_N;cMi02C7Uga7~l literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/replace_sticker_in_set.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/replace_sticker_in_set.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ee763ca3b4c29254651c3f7e24b654fb30667d8f GIT binary patch literal 2050 zcmb7F&2Jnv6!(1WXLdKCNmLS2F)CDO3+xJxs|rz)5Ejy?YEmIaD>;*~lT0%^v$Z`< zgL2qPl_*l-hKdA7R6cs=$X~!Am3kP>DN;|lEeZ$J6VIO6Z6ksNj{Wldp8fOl?>*1{ zSgn>3v|qpbee;6?LQmyn*z&2O9dCg001-qqA9Xcb)1%?y#zLj$2lFw$n1Nof_;%SUor*OD?z5$jm;8qmb8bP*x9d2hE)UF_I-H_3S$f~CivaRMuD0tK9d9P*J$Vl-52undElbI(A zL)Q(7smB9G<1IQa4!*Hn0gPUXtPrh@TO>%^Z($aXsOA%Rlu>_p5FA;XZ44h?Q~mc5M*lmdOb z=eRr07Ui9+h?`jvH?ypaN++wB-X4=*q0i?|;kq%rgas@3#~}Xdqrohyp8IO?%cc8E zPbzZ*l&{v}mtT#iXX3dxKpB+4psa&3ntXjQHk!(nsY7bVfQIUol!z+mDVgI^Q;aH2 z(yFRLk)u-0rlf5eM14%sEUO6Pq>OPlB#|%m3dT1h$ImvuT z2dY0dX9haT`TAjDYJkq>YJ=ir35fkaq9nJey(7WS4TE0+UV+Wc2tF9VCX>GqNnY&r zfUuMe_2P11p*(%E=7s|=Ti%+TAHuM+Qd6jsoM**LX@1^gZ^Bfv#_xj|7@DTV=={OS reuyp{oYoJKb#SuBC#T>YRDQU{b)?vEwjO``+VP?lI zK{*(yf+7JoR3v&qLM^CwuKWWW9H|FuPeGh|GYSWk6YuS2okj&AF&;m^uX!`?_uh=} zmr8j8wZT?u+{v!D=_ED)BxMOcm(cyTJ(iQG#O@&LZ^FiT9mLMr)3C{~oP zV0oS|Eou8+P^)NRY32RPm+1U!m*(Gmy|xghE_fSZ_N@-uEhp5kdcZtVCg0t9A?Yo^XrGtE*w z!?bhYlOs$AKE20hfY0vnIWx=hAQwh*juk;J#WK%}GRwiId{<=?w@FiBhi{e5!fo=g zVivEEzjxX~-3cDdOqb2UHaba1IP2PZUHQ z00zN~)v-?`h&2FUHv%|{5RNB?edKq?qAt5;d-Ajac&&yRTt#gbra%{F5OR=24%#Cu zJeF8(x16-P33J*=xGL%yccgV1 zDlS)7!+h71wnNdOqKZj4k9YZqRbakR?!XO~i5)ce;QIi+@%V6LVd|!`scxn=wN0HVclFKm56aiky8`z< zRjcUY5G)bnNDdVYl!nU2+1w^}@?Tegoc z$xM9rf|;aU;zGuqRPAhtW3bI9N1sH!n&fc;9D*evfAz?4nv|aV>e3erUoJc>P7g_@ zR30389_RF_!P&P5M_(KkKo=Q?MRNG$urw0UIW{1-0|7~;9K$gNe2nW;$VK2{5o3fW zki+f}Pa{E`q7D%FREuYUR7wcDXStlxFi)xLv#x`DkcczLd`o$PBsac*gIxa5QMptjt5qpvN;b4y!B^>S)EGchDndU-fO&MOy{!8_(~ zY%&Lx`F|vbp`v&rB913HSISt8W*44BsD?;^KFlVMLYS5t9e_SY6Ys6SKX;KqFCA<= zh#x9#&4PCeE;JFRkVKG9BNuIiFz;s1#WjCLoCOi_555O7Oeu;oAjkU$=QbJZMV|qA pssCSdo1Ew$oC9L?56)q_ssId6l5daws6CuI^9P##{0DoK!ryvUfl&Ye literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/revoke_chat_invite_link.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/revoke_chat_invite_link.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a24d8d83813dd55a791e5fe18f0e8552143b787b GIT binary patch literal 1943 zcmbVN&2Jk;6rc63zwHEyTLDech)76QgUywws)|AsBH9QgsVX)`)A7#O-g-aG>^i|H zha4(VB;baMM1?q@0O}p_M{sbZ9-=)(>M1v)AcS(_&5Yf|D7`SAefwtSy*Kau-h1nx z%jE)s@!R)*wEj*b^h_=$BcmDPxCP8Z#1Jz)y@J?sL@Z=h=7NG_{JQlvo;#x!=r zAgY>4dGq6smdVlw%S#`wuB{~Id%++{-wxpPD5VufhpVCuEK^KN;i8jpKFL`2s@Z$Tk?VQ@0^h+vJv=W+^+vOrB-dHIT_eV8CZI&vT-{ zN)J%WV8#0-JO2QEX4r)dG%`mRv)t2IW!u6>bXgM&Y4X_1Falm(;Z_|Dp`T(axJ#T>9 zJm5lFtl>><5BvQn#!W77rp$K(H;O?b6yS%t#{qb83)aeE@N_2>U65v4vqQIKETG@( zi4dFu>;Ew%+;%69YIvQ;eGx=TdhG2~ur$Jpjz^GajXO&7X{K zRO>>UnQPUQm<3_+GLTM5T(5 zNCqH_dhcZG{l&%|sE)=`$lRda==N155x~2_gYCvmx7moGPv7oQr%T&BYK-$-*L@Jx zHR?p8s`@}Dyf+Z9!Zn{?IS|JBVLl63|A#dydt>@kZMuF6;PiOk`xH>L)P~sUn1nw zKJ~^YSwdLo0CqXhNy@;eBm*)aIztFlAkl%tdKT8FUp|nviDl02r2LX1-i^DwEzGB literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/send_animation.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/send_animation.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..54aff8fed80c45dea99e064980f7deef6f997e15 GIT binary patch literal 4883 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/send_dice.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/send_dice.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fd297ad9c402bfa7fb898fb94ebdb819e471f249 GIT binary patch literal 3369 zcmb_e&2QYs6(8=B`=$NRw`5ti=&!mPtGkYs$cT^#ZDm;vQptj4Cn>!GL+y+tTI6y& z4Yw?Z zg%Be7S z-Qjh1lQpf~aQNMZWj5G*Y(y{CzO~CAfhRO`=3g+y-}ONhWIwO=u~a zWN9kD4aQkQ6)i(kAg6nBmS#ZC_T-$<=X!DRjD2TzBpx!*tN`6>qo6+=?ATs&WXek5pIzXI_gp7_H>Q%GR6~ z0CP^=_PnM$SFP3^&MMv^eku;%s%|)*TQ!>IIb1P?J&Ar{21VTBK}n$hj@j_0RoCO| zVY&{R&`r8>Q0Rup9ibTAXt{uV*VXGzqrvJJK4ABP84R)>4jisq_qI7RC|HDwIGuxH zZ@dl1vDU+3I3#1kVmidCxoOr#yoRMFcRUy!XYt^44o>&F#Y@G`)9PV#uD>uL+uX!{ zu%r{cF0TaHdf3k~jP+(O?hfwsjN|c-3-D?6n7DqWF^=nL^(a}u;_~rycAO@1lr=en zjWT)*63)O~7mm=aZ!_D_*~cC?!jpz&IrnvRkJ;GL@0)*}H95qwYJi_6`fh9=rlJJC+I<+jpJwbSiPJKN5+ z`>6DJUpxON>9^t@fgGM(DfjU)=>ETN>q}Bjgo@j0G9G4h-E5eiu9u79;0v3CleIQ= z{X5RUUxS5(SzQ+atLttNWK0pgvUjk2ZLao#!*^;64!W?m)8dBba2+DC#v1o(KQ%XM zuIaHKG>!TWTp4cdFzl;wdU31hd>v!8(%j{jVTK0-U3XQw+xjsyyE>46?vZGk6i)qS z@mEW~UfR!3Mx;%pmVFufF!g0Fa;@3#OE~%eC(ESeRu(1?UqN zfDsuJV@VH-x(=xjf(O$$$R&`E9tvQ4TqNO>=-6<|prRL3Tt*SSg|iBL)R|=g0406} zT3rl2cH}Cy zuO))ncfQ*4=WldoSNCUE_ip&|YFs<=Y9KEhHw6u@%=+@MF9XHek!J(>a+D(3LZlF7 zAR-B+a74ZlVu~n^99+5j)rBCF|KsFi&sX1wl8KoVsAp2&B7qfSuhbF2uBj-MRIW); zhP+mNJo4E4Ti$=jLJM10(Psy#8i1buJ6x@ZCrjXA@KQ2!EsN`<3zt z;&`(KH#*>$CqWUW;OYmg#$dus%<BC?AervzEp2 K+kayu&gox?;*pmC literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/send_document.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/send_document.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c99a437035432764cab14a8a697cfd345f8dfbb3 GIT binary patch literal 4371 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/send_game.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/send_game.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6119721e256780ea937e8fe20f849a4f224c01f5 GIT binary patch literal 3092 zcmbVO&2JmW6`v)S-(UK)W%)yE$Bx5TCH>Jzu$rh%ZAT3v(L!W5>6*f1#Tij+EqB@3 zWgP`Xp#lNw7Huy@kpj)3hr)HC9&#%BC-hLD%R-06o(%Nl8w2N1_|*4iMcNJ&w9WAC z(|hwiW_I51&FYVZLYBbz%kTca`Rfrv{)Nh5BqKq2@^cVAA&fA^A}vK%6qI9DtQFVe zEmc=r2|dwD>Pa~tw^FUNo(5TE2`kge>RBl#tz0Xw=UWB6&?@Rhm`ky=RcejsBMOO; zCBiZv6PD#8yl`x=1M(nF$R0e=&_`Krjg<3`Q7tQB&aiFAGd$C=-Le`MZv9~O2EF#Z z8`s`>yS5a@-?Vqa^vyP!4J%CCwn2cX#9Jn}*yC7~BXyl`8Xe0k$HR%YZOgRzJA7xu zF$7yN#CE40rdGJ?8ciOS-sNp;XVnl!i+fzSkCiAx@fNpu6J}Sqx8<+~Zf-E-;S!=e zSq0~x!Xa{^D~#x|+i;kAoU3|*#q=bL^AuBGho}r;36PTqa!OCLH0YV3o`EAuvD{G4 zvOMU8NRJVoW5oxs)*fz74n5CG;87e#6lBJcp_UmB{mNF#4zIs6l#(kF_k|b zeE^5HhX)sB9+hiP{STgFa@WTqPd+YAK~DG`w%^Di`Shn5rrjr-3Y+=3s88G{A1eCf z8X5d8pAOS&+-6HqkdOAV8jRa6*Ssy$)u2RB3(a#h7d$jWYl2fnyJ>4~r_q3l&VnCD zqo*x2EW>pdJ}^uN%UJPt+T5+QqOw;G%Kw1|Sq1kx!se`!m8-2e9ns(m+Lq_F-Gyqk z;Rs&w4$x3>M6hqX%z5y)D5Fh91RXq7BEf*24*A zy2ggZDYTKfX*Oglg{8J|JV=Y_JvgAJr-os&hwfnTtai{i>(8ykH#ad3RysBe`BK-c zha&>}h_;7~^j!YKI&eMAM-i>4A+wCP1&6(Ib_?2h^sWo9?>4r0%b@&2PZ;5G!?K)v z6c5?7oAjOuSm=0EW(mimWS&C@=VP*RMoa;u#Wb=L$W9`gL3SG1OUPbEb{<$bP1grZ!Cvf$713Sz-fM*Y$ zXxtrISgfmbW8HXH?Iya(ZmOH^X1dvKjwzq!y7@mSzmk_ST#oTtIVUC{TpU66|Gd_p zNI4cJ+)kT|Fiojxn;xa*VmS8POTwXAo0NXd6~rsBr!YgQ>^Mr@BIww+!?F8x<@!SX zJx6TUuQ^z~`gTVco+Bu?SumFO*^019)Sfmv0GUyw;TR|^@{_G13zF$Hce*F&Z zq%<0a?IcuGu~4|6ghqo~7GO^i7h%@LF8GePgkGZqhWm5>0Tw9WvtK`^CenR^EKep+ z?5+fpGrP4%>d5Z$?($ET1GO5cQ@*60I@OPnL@gG~Ui8&zUj>fTQ!fVUMsWUuuTJ_Z zaHO7kAyDrI7pgKAI8sloVurO?F!#o1O@HxbZ*FyeZguyjudYVaQ&$7Ec33VJT%PmQ z310<{)KljISoq5P?y|4WN7Pg2F+Yn3m*+n_7o_vQKk?A>wQu(0u`9{X39v7a`RYuc z#1hG83~Zn#|)u4I>wiGPh_-oUD>%HFM`}>RU-{TJyGIqSbj0r{@~)f5oTf06phnxepQ9?tLo__xjd(#xMq^A}&?B;WZz DOtVGw literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/send_invoice.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/send_invoice.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a1ce63e2bfa5c21b470e710f3d4cf8015a1972d1 GIT binary patch literal 5305 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 VpJYDodfJx$hGl>IFAA~w{{y7kgpB|I literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/send_location.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/send_location.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..effb9fa519a45d05656a1881cd5a5a794a9b8d05 GIT binary patch literal 4006 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 WAAghiwtKrh{gzLE_W>sE!G8fMu6%d^ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/send_paid_media.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/send_paid_media.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..656e2e662d6edfc5aea4508450c26207d2bfb270 GIT binary patch literal 3219 zcmcgu&2JmW6`v(%`6VtXiIghaQoKr}B(xRMwQCzuUBiy+sBR+4jqDa#%Uv(IBWWw{ zE<3wSs(?UQAV5=~335quXbwFDDT-W+{uMotKn{yN8R*Hk4ctS)Q{S5%oJwHpxKTsK$R4ho3KLFulViHqo5nIwE3FSm9VJEeu zO*LxEnrx@El%3Yn(3do6D`RK1tew+x_LMed=e4}8Xo_9X3U*N|+SA&!J)_Nlt!$=R zvvx@E`L%8BtV$Y)7HK8GhRTG`BQlS=Lpsud}mG91VC4c~GduOf%a zoi}ga)NlOg=8e~G)i=WAb>}douUnoUX13aBWVAy0t^>lO1Wu3*bFaF*$=+b?)?rw_ z<+Ln^y~Yk3uEEVsgCBI-Vd<9B?)bM2%iLt9W!&C(efR0cpIRn!!}KQeJY$cA%1F5B z_?CYdmc;Z=PkXHK4Q9JqoAaQ5C)U{vpEI*x`7L~s zHJ^Ep>`La+y9I6bJ@P9_D{YhUf8}(jY%|B4xa^(3=2R$mJ*N8mmZ!qq!X>J{t9oFj zw!yW~2EMJTTaM~=noaQI8rU*4@YVHZ%kaGQ2ZrUM532rQn|W0`c6N2->jx^#%$eWe z4l}DcvEsJd0dlRY`@Y}y)@!w<%URVQxw7i=y;{Tdy_(Usp2MBsM#MhE;84M~$svYC z!P|S59%XK;nHNR*u$|vfF-6!V|2Jz z%eR;}EKCM8T(@;UT=4eYxAn1^(SWef#lFI_X?aGY#dL^xYu9Rus1J*6?)tDP+?)@y z4o^%bd@7h=b&hea!*)mUHM}=59^ckiGr*d9EL7vP@Kj?QziaAIHi5(D=ikMIIQ1>r0}cv|0n(*3&LJ~R!uw5ERWw!!y2E~8Z{W?V??E_epB z1(rNK)9_4TTDSwkN7BcTVEu7Fw0s87=kUbk7n2?{(UrQ1Zn8_eayQjYcQf5=H`kr& z=1u97d{_BY`arw@APFbyl|08p%}*gLA$*%7{)JQ$q3m_qjE5Orw;apY^-3|Eed4UT z$6C9({=Y24*I;8|R@X%o>$+D29rM9a=?%AkxW4l(%Jso;eljO69-29@i<>dS#z3qW3~L?^&d zSVt#GX(c)}QE`U21Et5X3aKo{cens@?5~q338yWhBs}*FN-Bbo1Wkn`xcV%12*R$Q zBv>mXL0usU{=SI4NMe2l0qwsRsmCn}sbfHfHu?}brXV^{z&!6dS z_34?o4(OSH)`Rnx#H@f=2lP@v&qXPcRU(INNJTD0WpeT5 zV6_swxE5S}CAj?k;KJpgdOldc3bV}2Ma!#MpzVJLS)5-iG68;R?5KKW4q3L_fwwcT zjN|8In1a_hFe&ytCR2`IygZGNK?7O5=Q(~~amb{EV_M}30`ie#9^sf~`3wSlKa-F) z43F_L>VhWcP!jt<>I^eiVy0i^H$X*Bc`3jsDM?a5p6ws656PAOe^w)!lM)g6f5AMF jmit6~vPP-8B!LIM9zU%A>GBulvtNqte}03JxTk*u`H5{& literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/send_photo.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/send_photo.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7779dcbb88d3fd6bdd2c5a59995cae09a74662df GIT binary patch literal 4271 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/send_sticker.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/send_sticker.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b586954a55d71290a909ea0b1bf48ae89c7079b1 GIT binary patch literal 3619 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/send_video_note.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/send_video_note.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b783f9697cef4acbbcde9e0a474565f3b6c7b7ac GIT binary patch literal 3835 zcmcInOK%*<5$@UTeR3as>Pbo?inP2ExvQ6{h_HzmdeDL+iZCTx8Ic(cx0~ch^Vsyv zN~W;~9*o2R5+j$yK;nZBfucY;_!Q(P!A4fzo8l&T)?QdE=&^62fY zt?H`ouI~P-y7#xmVxB|9m_RIZ*`~`(>Nym)x;#a_YK^S3*MQlY=6yy_D!cJ;Q zn`+cfX(>CcrDc24%Gg;g3p`~hD`)4myyVkXpIy)jc2O(ZC9PzawX)r>_1gp5fIX-U zf=z~Hts#3@8&*hy%oCRTl(0M>=H-K3kI17WAy42N7j1;~Es;v$If@k}>N6b2^$p*2 z9j`*8;?3_bUePbTcjeOi*B0iZ1at#wG>NeX_n*}M&AbG9APQo(>r`d%d#xUxt^SZJZHg76X>d<4Ed!Ntg;mDvzj4EB2TOAm&7@&FqF{l1<&$o7MLpf}jLakdScYIIvnvI4ld{wwj zhjFHQKWrL;tJfE=%%4}~aB}KqL-k$tjB1-s)90$?I_p*Smd90p!}L^u9pDQsJn%p6 z28|NOURAx}z%=zb$Wvg?(a2Y4>z3hpvv&>CMTl1Y%?9_XJDsXKL2y@v(FOOL!r`o% zmwU0~HX)j3)$T6TUBRn+x5D+kn$a+iqc?I55Y1e6j*8gU+u`l94Bk7Y<4>ucFIJ*V zeZ%l|lWmX0nqFY;=<{+s9S2<4E_Rc^9ocu^YSV+*_B_4rIu5U6g2176&0wCDXkcfN zy1yZ~!N4NQvZj#fCQ4h}S@$=#hk8TzJXncx{zlVYbqv$mF7@=Qu4}DC!_4%IRg0r% z=9*cLM=Li3I9m77As=>q`$(@_ygckYrS7Dvm6v?uYirmKyg%6M@=BUniTVZRG`-Qw zJll7A#@+4v`)oI*z9zH1(ims9DRnnkmypY17x`DA7mER9~xra6DhPx$9RtDf(sbwX15Zk2I1RB zi1Ok#Fuzc~fZNOO>Y?Qke4oHKF86vGmS`!hL@U{%tyC-B%CxerTr1z|YZY3>R*5NJ zmRjZCD4)yQ7H+xZLZu`Qz#!rflK*1Czay1Il!6SxMU>Tb(=mNruM9+kFRdJQ-&)i4 z|ILKrGwkkNM|z1r9mGceUB`}Q1gwY%nPpz}6>{B?_T&XVHT z&#wGr{-^U#3!@#C2JKZ%^gyzGI%kH^Eakq8%OkUI;cau9Lhz_Ucxqr9%$ zE^9)H(xZZ|!#!i|XfnFa+&X{+gCHsbBQrk6tR9tg9a1?2DPA!kmqFfroq_E?2Qa=$ zUmLbrRP+aX8_ zWMp*fdN?w%weXCN2C}y4Xh=T^>0}^ln@)BTB(+MzsnY>H6i}d8+w^ouSHlyh0y+{< zpjg}VR7mfIN5;3_3+Q-U+jKmH=23O)YCzSvwy7G@%i&~Y>sml7ac$EIPGo1pQ?-B| z2q;jjZCbQ3k;?tSMts4PdjBA@NhIHX|uCVazOhAVN3KVOb&V=-I zCrxt2PKu-kIwX-Q?vih$m?kNghG#E)JsD;TUyVNY1ND3-nK+jQ^||!7NCJ8kd!=^? zc1?HE$<$?~lO-o>k4GN+e<}nYYQg-Spt9VqEI+L*2Xucxfnsgb_TB?n>m zpOGBSDJSj`G26w?LS-LD#99;HHV_d4|BFOvcmx6JV=&@nA@Hx0$e=FUy-WlmH!8&s zxGIbPWeCK1l#-7q0e1)y1tj>&mr*6k$n_(^oEgzo!{cHIWeMl=$VulA;@jD`<4~Ow znA#BgUO&)IQc;wUj0bz`GcptWtNM%_3ij4#WFpvGJBh54=#c*h86?WFfT%CmPWlIm a0tfVZ`tyaaE<7DR^^H`2`wxudj{ObR+#DVN literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/send_voice.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/send_voice.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..14a3fb7b5b4296aad7a760c603de6f302f0aa258 GIT binary patch literal 4304 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 X%iqa2$&agdo@o81O~3zx-DLPD^H=c= literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_description.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_description.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c007e9a9809b37286fbfec5b25fabb13ce8638f9 GIT binary patch literal 1835 zcmbtU&2Jnv6t`z*zju=o2q?5v!$%|*+TENuL=`GZqfnJDh$JdZ7F=iS-5oMt*xr^@ zk;tJEMFPYH6^R}=paSX@A^r#sTd9X=PLVkEwkRA>PCR?EBvC;e@YrwO^YeT2-tRrn z_w{-O!T9-`U%MaY5&BIF<59>My!SpZw-G}O2PniY#+tVRE6lmM(01)G@8-jTTY&u> zvx8z-a!VLlXbG|WO~eYk#LF{dujpsQGH)Jp$XDavE%h=)YH4% zVTUG8+;yna6Y(H91B@IbTo}oT1<2Yc;z83{0kid3IpIJmXPrAVawrS^$d^h`1!w)p zxCR5|bU`*>htFP*#Ri;anPs0|%R-<@BH~2&RDrK!j)dRqE7^43=4v1!>CAgEexORjWuN0K)l z(kW0Z90ziL(v*D7kJK3lGJG#BYE$B~_I`cb7i&gQJ>su{#R({C`T}{hHiRUbj7G}$ z$i{UldQ!keKxsjkG*i1BN8HmbriTSf--{|jc<($gU*X%Zsm6NPxeMzatZaPnw}x3; zc*|n=jTS>- zmmTWI`VO_S{**1K0WlCCfwP%xil^WkH%>kZXLB6&NjM}Qy(#As-HCaG)s?!eS4$?e#bg(mDWW3Jj>g<^&MD4wLUMN)~BFBGE<pMU@ihtJ5e^Q95eq=u$vwlD8YH@4fm z_Nk$n_w7?V_KlrqXSXj6?b&SJw`X_kx!vLuBQ%-s;L!>6Qgc+UmVrh8o0g5s%<&N_ zbP-K1?M79D+a18&2XI9W6lpvqFmv{IqyFPx I4w;Dm0?!Tq+W-In literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_menu_button.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_menu_button.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..895f3b7e4435b5aea59be860061e0c306b56eeed GIT binary patch literal 1942 zcmbtVJ!~9B6rSDNy+7Zbv56tE5?B-Qb70O?6jp>19LtG}4Z=2t^;zTf&e&eOKgY~$ zz>y0Vkq8pdp&*eW1qzBHQAV`XP+X)G)>f9N+#NCna>aYQzMQQPQSff|?faYA_r5nX z_fxf6CO{8<_GJ_$5i(@@rZJ;>R)z_5+Lw9O!I=fR$1 zhF=JZb}=Z~rJ!t=!Dh0&-xpNuibixYMOfhmVMSiy)ide($nNF{xerf9c8!(hNWHv| zYF$hEoG^@(qr51Tbt9?HfAYa3owzbNF@1G*D#=|6x02%fEp$76VlIRr?CUr+mkiGE zFn%{yDhel}AaFt^lYyS?GGB9IUnS4ivFeSQ-FK6Gq1lx=(tX$alYu#|CN><^%l7(jWeaFQa!YM^(hAZvEfrbrh7+!% zm0PQkdKFz^Y^|nHSYBv3R!ex-9K|tGjardNV_AmC@#u#2Ay=^or8VwGjE}F(io3U_IBq;Q& z$-`^S_q^4n^b~)y<+z*9I+snyi||y8W&2HzLE~uJnPXTsT3g~QeB=7?6EHTqNuyuB z1?=w~(itYzbKgvUHTCt>qsrNKW$Di1FK@sL$5s1C$kfWx0n8!wVpiS&$Z5;OvnXMq zX1Z~m}#@_V=R@^!Q?}oH^Tq6bC<-QM1(!>kklGx~r;zf+=@3Im)egy_t^nM-P zFpC|6tU`v)?9A*Ay|y#EcWz{7s%?y9AKnK$GEV%HO<1U1#qv$aDf2a0`K@FueMr%Xa*AQ zLV>456wqgak4u4A2>fdjaCiu`!;xH6QGXd(irFwq7Ba-~uy`SB>N}zVDgrEj2G+@G znzl<`YM&f?@hp8iN literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_permissions.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_permissions.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..72408ce70c192f734d9f94ba1a18924bd09356ed GIT binary patch literal 2008 zcmbVM&2Jnv6t{P0Ka)+Gv_UDP#i9{tt2PlAkkSgZq*XxBP)H(Ry2YK0o!x2XW3jz0 zK{@15i6Q|v)JpV-3aEE3{0kg5QV**+MdH-kpm0Dr@!m|f`9ea%>v{X^_hG-^d(S`B zYE=T`*B^dgiOPihfs6hqW(?iF4a@@~h@d_Rs7)#IIX@TV?R;R_R#31DLD4S4eqLC9 zDJa`z;0vPYSAwctr6fn@h$!77qAaU&;AH;<@;Fb(6Zo=W4~ohHsaK!jvQFaxCk!Lw z7%vKS-HL0ApI*PpXWzLx``)|rb8-H1xE7Z`XrtKi(Pir)P zMzj5)Md{0?a)N8pv?Af+N&R7E4Bc)4^A$uaiA@Eub4w7potKtf5IMUj^0FkXi=b11 z7=bVD@+G?r@s&g+Tg!^7iIS*3qT<+nvO>l1y&=1LpL{{>fd$h4uaCr|3(_3Au5%IY zTV*hov}C5`X%?gxW+q}<8Ybk5)A0>+AxzfZi<7NHiaEXy>cO&9dWtQ!BwLOQ3p(1c zWyze7IU?{vPaEYJ(Dp(&K(eNaI&Fs5On1Ozwnlg9@o?_lNUego$XvCYJ9sn6&bm&> zl>~R5YxwTDXAd2syk^V5Z9bBwqe9JQ+(^ioTZ^hAZ?PzZBVAW&JylJEUWhu%l{2hm zOk2-PPrH$lQ)V}FQ;}*;LqvMoX?te?48&j`1gVF36a)u1QHsa+U_%{Q*|8OO!A}o0*iEzzB>)0e}}WB8uHmyO%cB_g*@ z*K_N6K_BJUtsm)kX|F<0<>%{pbqv(i2ok*LFQlG}3u&(7GKbJS!+E_JkM6rH*V13% z{E($O0p@XqbJusY=3L`TfyK%;c0Rc>)A$$)r7;@`FKjkeJ86}1NLWLLcN*_|%MI-r zdA{wqt4>quhT}!pkkeU#>uE^b5p1X0YwATf?Fu)|tO z0aT;NAr@&i)fjRw0I3fmprI2;&f_ZQK_ogp@`Idz-f{e0Nr`h2xv*_vg~c_%IV}f( z4K{~3hx&$o!gmVR!?50a4nY@lsPN57kwNn`9j^3!$Rkw~AktVFm((fLs`Uv5pnn4b zIPLwCoK+|%1j!&7JGpVKH&)-6-?ApU>D;s?k{l^q&h;$TP3NY?de&_3%?n*?vTFgw zxoKTMwaPnl1^uMXo)d-1PD7fn*AU~C4m>P?vBK_& zi)O72FlO*zt0^o|gI{+;qjBU?|A^a8`C^v8x70aUBB1&q zkR(qj?U7fy2j>=fqx)ZTi=62moIS$22WL`zl|s-*$-~n>TTf4({}V-j{fj)k`9EHF BEE50# literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_photo.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_photo.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0ce412e9ab39b44d73e1088a515cd94b048f601a GIT binary patch literal 1792 zcmbVN&2Jk;6rWwMzwHFt1XM_?5k;yj6`OOERz)F%3hG8pqKd_6I@uZ9OZJPIaYCvb za;QX+0C7P*P@x`B5$c5#e+36u>LJ=wBu=>*g#*foH?wg*Bzj>y`}WP7_ujnsdvDgi z)aw-lP13%#VRwkKP;Q{Xn8s6fn zA2UyT9*?7Qt%Ext`3kb*$h8=9?N!Lq&2h)gGuth&94|6w4s^#-i7PsAY>L{$;>K zr)_{RwrLGS$9Nu2n%aNrN9rnutUgPNTAlbzl%QB?-WaBr$mt>wl58;=Dc>XOn^g3q z?s$|Igb6-%+Hu4^-8*{duF@BvijZ}11DGGIM<7(=eULnb=NUZN`22W>+1u8(&8)}v zcJ62EJ9Ay2wR7!;Eha%(yaMD`)UeaM93)(%B|@M$ijYP=J$EWfB6-jy|EAwxfAaQ=^H=^d+kd}A$wdDzGW+aV literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_sticker_set.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_sticker_set.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9fe2e2a9f317ef4df15b017f7d6ab6b60f27f942 GIT binary patch literal 1886 zcmb7E&2Jk;6rcU@XKbgb+A1kQ9gzdL3bw@2s!-cB1O$yxov5%FO*T7Yd+~aAJ2Tr5 zltT`cC=zf$LPdfD2ULW5?_a^em3oNw6sf1)jKTrs#G6^CNhll`&py95Z{EE3e(%lv zTCJ85jK@Fz-d)He^h^my17tOf0|)2>L=iOtG&CH;P`nwKL(8#-wqp--P7c;AY6tmY z!6_KXL@S8q?jf3I1y-EX=P2^fLg*2E*>Fm<&_?y*b0yY|bjl6GNV?LGLQ%KU>e|O2 zE|aBqmzUmuZ*?WLu7%raZaoC;b0agTt+9ahxI4VbWIv)_c5Fr`UW|iVAb$z*GvpW) zIp#X#;aJRea@2J4)M5o{Ux7U(h#2^M#1j76*2^din0a?%}*i1(V{Ks4RhUw}kZOq0Ao z(g&n7z@4t<;k0hHPyA3WLbdp(X+aqhpQaXw>6sJIkkB2nbb+-0c?co#Hg!X&H5qKV zyeD`LdM(Xo@TK-@6f#e>vl=FR>efxETXz+h?~MnrD3A28@({j9@MYt(7aD5r7&|64 zelmBgUyN_{9fiAPt=3Imh0S~#$Zx1_ra9eaX^{}kJazn*^}#u<&l@1Ant4e97L7U2ov_nCMJ8 zq&ex3CV;Lxe z5lsTcR|vV2xWPnIAcRI9EZdt=6r@!^R5vof1dBC7pcP4m0?5-KAHRLD*H-Qn2+C3e z@3A0&Vi|lER)wnjRjwXZt{!kric0Yv5WwX4H#Y5Daf}qHp!0LPH}}rJvAeo&&yVzc zV$Y9Fl)Gl`*>fX3pV)JI_Kp3*xiOl_)yBnY2{8OWq@>KW?F+&$9tF8tFDul#3A`SF z8duMBnwQ%#0Fz~{+Ka1O0MNODag`Roq=?S+oZ|FxD*MCYm8<}7^VdOCu!vnCW6Lm% rJ@ne>^xQ{_qyL`!2#-$BaUL6x%gf}4+RyUo?BX9v_2<9nb%cKd>)I1V literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_title.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_chat_title.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..66668e41191b430de6b0e518d190db5573e70ff3 GIT binary patch literal 1719 zcmbVM&2Jnv6u0MNzp|S^X%H;|MiePpRCbZLMWreVQ6SK5l@C=6i(F^y-5oL?i|tKG zmBS)cq98zAP!HwM11dtjaN@7v5TqWWIYr{s+oEtl>7~z}EJ-AK!E3*LeqVm?_dNc& zR;wTwzuo=4^VmV?PrVtBLeAiQADBCcA%-IqV;^J9Tagvpz8yQh6T7|(GMhP3Aujqw zj4ZT>n0pJc0x$B?nQ=sP-$v*GtbF)oR$M{#(j&dC<7|Q^Nvfy{(?r(othV~m)de#D z-opF`@3$5+`<-MfbJr5kKEk=fX&b$&#_-wLF4~=Evv3@HQ%FZ zHB=F&Z$VBK55}70p6Z3ti%n9VO1+>*ldhJ+(#Bre@u-%nhG)E`7tmx@dF%YpmU*32 zczqFWQe|XHf+_f~r^<^5(wNf3qbv@SP%1$c*oTQZLkBkgCJi|MMk+Quny}onM>q3a zXumH~I71(CGLQ(nJ$>RbR|AnqZ!Sm~pS!*)2K>60CY~Gw0hh8-F%_?*0}=2!ucuUB z&NZ7sDtJR3wx*GaZWFSWP1+C7Nv?Eu1_k4rRY5dAM)6?E^!MX1QRh9V>XWRf%}K~I z8@8Ei9J80nap(!@Z!wyvFd!Q@sOU=JLOZj9Fv(|5D@}NyZ;T!mEPb&j5W@SHfcXL6 z0ihb}L2@6~16cX^^j{6Lw(+*b@Q>EE{S*Gqd1WD|6+b&qY=u z1e&7=sk_;!V_6c(qYfcQPU0Ex%*uoW5tWhw?p*sCw68s%vM}kkHwLEF z1Q2cWWV8KYxZakb;&1e6utB?AwrQB^PokM$KiLF)i2>1I*XVDF=OOyd>EjSK#+kkd zD)}ame}-r@iE1x>yYSWGH;WIeGdtBQ_pbfA0DpSE-8y9QZS~4N_`s)}*Hi`GpdltT zr>iqP5zlJw6p;FaMkk>$CnT#75~pksX}(IxX9F4?YKnxgGyt))o~BV&1JF!U0SORJ z5(0OMkQyK1^9%1^|FH6>H|V~`T8meed7T`D!I`0iB~i+C7;%u z38!H=C|$@qaZ${|R^ubT1~RfS#=Gd%os)A9o!@!-+(X{Z$vG;V#TtwMrr%$@_u9kf OX8$tkzn@}ca(x29QrLR{ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_custom_emoji_sticker_set_thumbnail.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_custom_emoji_sticker_set_thumbnail.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c87dcf27a68604ff1a500c6bb887a21930a427f2 GIT binary patch literal 1765 zcmbtU&2Jnv6u0MNzp@{tYAaeOO!*KD61xa4D2h-~h(c7lMQkd>u)&>-on(@k@nU;` zR5>hCB?Nddl+lph>Y0u%-Hg**!FCYnbe9( zaoHT0C`oMewDKO+= ziag^oq~e*(@@#5&C2F!VwPxT<6@vCEI%rxh_N*!z)TWi2m^QDY6-*n~nqKWX`Urbd zJv8~ct?XQnso7L29?!*mJ?yD4*kA&Li)(4TocLjM_1BsMt~(;#3{wrjbk9#2KU zrkypV26DR73AkWwHHNFr#cF4nE7|b};gevs@RmCp`vT!XM7hE29Ekoq$;^~WWLDzG zth?Ws6zg3OE@iF41<8Gokh)m30QBr7(tD6uLI#`EPXGh5@u4qPrGREdSxMwTWLB3a zEYKaHhXG6X?i50J?>sPH;Ts@S6Fo?7!MY8r80!ZbYHZ;xgW{XUmiaCIGVgTgP_yeA zq5+5VfPX-)k=ZgGFp*UV36oF};@a8qd!i(gMJt3HUJ}RPdR8SQhl#YkHiTp~LSjzSNb_|< z-cS8#tSJ*hc>rQ-ne!-X0K$0(0Bj&^5(3Rk3RGaVMIOywnH3Akz zP(dsn29?y!a9-#)OX#;TCl#&u2?)S&_!}9PT^S)w>geR@;l-VkFAuxBR%5s@T=;ll z$2zm~v^%`CZMnt#-Ev0;virtv`NRmd?Dz2K7;3*bs!mmbMgN;tbCZSPd#E@wNu%r5 zG`K4%JRbnA&@XXTQkw(7ufRojrOhPY-~3VCd3NT{T>aO54&|}_1Fx>_ Ap#T5? literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_game_score.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_game_score.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..eba6dc404f0a8626a35de773f629a5c9781fa05b GIT binary patch literal 2465 zcmbVN&2Jk;6rZ(s{T18!4sFwxO`6cUO>K#yRzy_=Eg=xn6g907ORCAnGftM+yJmJx zN#%npRia3MxS&>Q4@E+ys25J0`2#pOQVy#lZs*}3i6S1q!Klv71dBHnxR!< zMhw=YOfAPN2_pf##$x4UC1s=(5+SpM#qSW7;3*#C3EoqR9PGS@Jm(%q33&=nIE*w) zE|Og88Hzb2=rL{E@l4NhY&WL{nQI@uKSM9QGjr*^cNb=Z=$rONkhoGswOJ0d>ozdY zBH`BfW$wD>Du1Sga`qZ8^HpJ1E^}|qVMTmHXT(BA+4%*S&mnV8422ORavcybqFm(~ zkL``$h_i^1U{RiA>Ur3c1RQ|Z+I-ANu{g+yuG}N#WLHkJ6zF@paz@JOuAF5V&}T!L z_lkZN>;8HlYHau}DJg8|PS)tVOFmPK{zcOH&y57>Mefa-6~0(>1UDZ50x2EFb(ibj zn&s*h34!i8y30LS;<}5Lx>E{;Dlb|ki!;6Ea-mzcZtAPx4)#e%^ZFHAcWcEWh*P>1 zZffgva1SNZO&j)=ExWsEO1hpdmQB~4UN$WUYmxUhs@%sO_sHlE^MPHBe9MYo1qirwau{Gw-zhf}l(*NL19D;WRNlImBQ|jXNilkah9quc4seLvI;VE?s&>j?9hRR;ZS2u(X zuede5w+8u69mNHUZ454`M;jN+Vp9r@8ofBa0V z7c^4c>LY^_t^TfvTS5hLJK&b&20~DJfe&$(oCJFS*JQ&;PIk>OuF2Ms9QKbmfCO=q zogzk&I}9W@fCaHJR~n=!tvIX(%}s+erJvNya$6IplsQGH4mOiW0tr++7C{Eq%l)aN?k+@xlkW7v$&P6R?#*zo5Z|ijH-33@&A1i@aQhE>Xldth(5fZ-`?+MW#bA z4tE4Jfc*1cE23(N7D19G!-wu4fAre@(_2F)8khayV~vGvwXZSXn7=*ms|S5G+n8(2 z-JbK+oPStv%rsR!oSUlNiV*E$#6MMNst1}XP@J1;!B;*1$XH{xsg8wnQyueF)7K{& zb4_(3oSW)|uNwaGQ%!ZasRG5hsh;vxwjCd8kt15RH9#hF{+V+=&=XUB;Y@4rU=nKo z|40%&O1E7iCOSYZ8u11Z zIV2MPqsU4BSd!hu`LJ;=h*v?xTDji=X+;%9@yU2||J){LoBuYq$!K%`^oicwKU=Z0 i3MBn^^38=ulTYG54L!+hji22bJoh`={P6-qnZjRW7njZe literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_message_reaction.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_message_reaction.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1a9d887e263b87e2bd84a91d39c7f7b4efb93973 GIT binary patch literal 2400 zcmb6aO>Y}TboR?%iJioWn}&RJLtBs~>KuBhq82D=NP*^qCQ;f|r0Hg7>}<0iW@a5o z6^S5KB1i@0P}CrL;D8FKcYXy2SIWWKQzcHlZIvESPrO;%Nvag7jAx$Tyf^Rr?aXi4 zYzD#j^XI?HKcx}+TWs1R(L(lb1M&b7L?j2fk|DXWA-js9xT>MLnxRRE$V71xZqi7) zDI?{kjWp0yqB$A2!|0HZjHVDt+(jfwJ80)X+X8x|AoLhka~N5Ynn%U-GqEjdVRqr> z+$5g3Iyv##Co@x_a@pGm)oV5n!qjXvuzk;TLT%9lOSBXIaz$O=VslQ_jr_Z718TLEd+heBD|#y^5exKz&XGuXI2tP}>GPDW+ZJsTxNe!=yMew!n-Y|Ox{`jm1`S{awq-ibhF%`_(jdN%ty~6xjRbMsNn_h9#rMkIp+K##6v~0mKuA3r^*f*}* zUMqrFX-WUc2c1p-Y7lc3TJ12dl75{AH3lliEuYZwTMMj4Z;5Dm&9XpcDHCUF-mfu> zj_a#IQ03!eW0ucoDQGon$!C?Z6)-bqR_)WA1}$IO*^4!Vd0#4WuR)S4JWQ}SE=zn=VyLiEusUGv zUjgu=^Z@RKpv?!$BUq1NHOK7(4v{ydO?gw`419*60L#={U%qCqEOR@c=c=Z)2CdJRP1_gu$yl?~`4|)e zxAWajb*Z|+-U2Ik29IaA)Q&)h1N>6}|7@XX1Z9W6pZsp>-qc>_P=pfMT;t@a#^Bk; zz-Xg?I7$N{rbZdmdnW2Q*ou=)hQRhg8!Da|VH!qog3G z(7;fX7FY)LpK5gX?JU*@->a7<>r+eh!KJ;zjlJ%h;75Nh>JX>8QDJy@;r>iha~{2Y zHtH4hK9tKx1%Vw}djl*joQ*v`0Boe4^O<5UOavQM=!PSOi)$NKIqnAy4p82#b6jyz zZ0IMGQzjl)cDk*OofKHCUDWnv>SD7i-)HAwD~ir{0Yr)WmU42|_*&c1M0!_Xf^A7pxbr;m4l;3sS0p7ytkO literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_my_commands.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_my_commands.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..230613428c965e4b06599adab704024daf8801ac GIT binary patch literal 2534 zcmcIm&2QX96d!x-{Yt#~Xf`yECJrft6(uVq5K557j%PMm;<1+* zZ|R~Oa;QW>fViL@=z#+&pxzOG1cy}WA@TuL;?$c99dg7M3Dztwj@`$HO?kxmq4=L=BoB7%tGBBof1B6ZbOS;|T=&C-}|=`3xf zS;oqMFGVyr%W_tZ<*hvHv3gjq)yoXaU}}M zVd{d{4zWE*?h7%`D9{JRf6G9d#TcJE0KH|DW z>vqcxo+t@Kg=^HMtK4RbG+6VABa!P2Em4#m50uX!!xUKxL6&+QGHs=(X6Zz=(j-MQ zM4N?}9OTT(k~G+veLDv^%aB}R(>yOgUUibcr;`3VsIHK{+XbuV4!WgSy;aotUm6IF zDh(Ffd*}<>fCJ}E7}o_ggSCb*S$twM@J(mU_EzOAHC;%B>DOa@#Sf;0=_L6R(`J=Y zb2(XRdo9~FXV-$DDQ3!L$LDl9*h6C4=c{E{E6R0h2Q5y;WM_}_%h;^@+++}M5*pYI zSD5yS-wI4vaNwifr?Aiy=8WSLIFx41)R%zrtC-E2$> z8nAZf81drJfVnO}yZw^MH@ewg3bUQ~%I@zSg5QYweIP96@*XM9ncd|bjvwUbN&YUo zPx49vALi<@C>e6%GIKH$L>Oz*}uCaejD9EMIaDf*sdzE6DhLXyk2a@tp5aBpJ zL@$h+ZDM;t!@=vH*nCxRT}GvOoX1eB_#Sm+$;cu5O$Oc`gp{3&pnR*`g$@;T{4jGL z-Usj|cbPgG3zMB7h;md_by`vFQjl%ZG#81UvS(E}jnYgmtHR74B*nw@JzbDsy z4)g>q`F#+lmA@c0dHXnjd`xQNAWDXW(6brEILu?reA05I-iz_a&;MpQ(4K0h|Q+=Hiw%l{^o%DY>+vKF$n9XjCsmXVE}$`_*zZemV!a_-`U7H;Q-L z7ksL7#Y(9t(XY2;TLr*mC57pr-2{LW%w*YdNmni_jAvzl4gpkf`9p+5%^}_^g&{>j ziasg&r5FGKxw8f3r=)#OiWuMtsm14zpzmg969$~;Z-ObaA^rprr4&WkMlWt1ejcOQ ut!H~8EvKjv`hUd`QYN;LdGLwSZz%x#aq&&%`!^m9z4BDL{yM=QWAYE|wbA+j literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_my_default_administrator_rights.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_my_default_administrator_rights.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..24499eb2ebe2af263a7ad59a2197eb0cb2543996 GIT binary patch literal 2054 zcmbtVO^g&p6t4c6-<_FN1PKwOgv52SI)ll^#0?s7ftARvhFxN8h7>(rH8bt@&rsFv zI)=j@NW?_F84m7&gTW9ko(yNt9)^UNO`kUL#BB^7%$|I&dq!9TaoN&z}zGi6}^17${hGqDsW%@ZQ2Qq`3 zUfwTQ1>kc$?-l)$Rnmw~76~t0BfKa|qI@8=iR6|+$Q^jHVNLPU3aOVL;IghIQ+5!9 zksY~Vpz20aUH#;v(`@1W(+eM*U0zI#lffVry6v%C%~Dp@paepXj@Pfce~jo za4J?ps@G{dj_|$#wWXjPDZtl|`XP5anI9gc2+npwP=gn4(4Dx~pyx#t%Rte2C*)%O z@~Vu*Wf}%>kK+iX8s!v~l`xi$n5Vrc>Z|!?(*aYBXq@3jD7#IFRWsPg_I@dP!tHux7w`rF{M;gm=4{W$i>Uxq>abL)!$QZO(#8^F-?0L*R zri9mF>``#?1vr_M7;`*ZDaI6fjupMJ(>*oc`Z$zptp%uwpxauD(}rb`vz7=xYn^l3 zE#*eyjlS)y*-&0B+YPaIn^_a6CZvn`12#@8+m%OuNPOXZ@!B&mZcHLN2)orW zAb)L;(Tk*d=$q4DEq=XtzjAO`xp?!;UHrp&)*3U}vU2euoFVmM7JCi&G`sRSu=e`+(G|h+<&-g0ZB`7<5MLAzxwaN^E;$O@T2UIv_T&jFKvVn`Rvl17VFZsBV@4 zGR8fb2H~SuCrGi%B);BKD9}cl4M%t$WKfeYfl6T&oRAp3tV~D=6~6!hEFS$vx|u7E z2$BlfcVJ^_Yu{TN%iG81HqH#qxoqAu=SDiot?FAxXEx3a&6#Z8GiOlzp0QonJ0jD$ zmNu%9x8K>CZH`J)C0LRFO-rfO%=Tkc9-0KTT(2PBofuv*fVadCP?C=ZeSkDW32Rhh z4<$Je3nh!ln{69jZ1}O1N06i_?ME&(jmYg3k7sFoSI)u`Ayu0|Muw(oTja=a_uMAU p;nU|fnH}z)TZ9gG&r$wm4N-eCy&3$pdjHk=KT`FdPuY}u|2I>4QUw42 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_my_description.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_my_description.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7dbdbcda32ff9e2a194d61aef439b2d2ff5ba736 GIT binary patch literal 1716 zcmbVM&2Jk;6rb4-f5q#jRa*!Yv9yXTQ?Tz*g<8@mMI{E26x7Albh9(Dm+Xg`853Lu zYLrTP6}KY&%Avf^TzM}-kbTw zvMLD1??3*rwrwKxrxM1akTZDC0p>2Eh~fZ+*uhxwTA+oxqlboLgr;MHPNzmt2#Zb; zBMmJgYTib)z>2IiGd>aB*AaRMD<4jo7MD?@^jL`voJ_e<6iZk7aU>dgVy#?%e}T+j zS(v~2PJ1!YFGa(o^j=??-QY3KeQGN#U|sHpOHB4+>g6Zr)W|=0ZxxuYAO(gTOp&8q zgH#-y8IDOcr$BY5NDWq^<^|YShD0DRB^Pp;Rd@}O(`oUZMy)$&4b$rFnlp6=eU6># zG8%sywPbpk$)(|CCOqzEf!<0gHjHb6*|O&gJItcAWo&yrH|i=avsYtT7dD-EyM(~mLhA(?#H``yE7+^OG`*PT{KVWjeBVo^ZF=cZ%SNMS4wByJY z1J7eZG%Hz9%khAFY|idU*%x!ImKSr@lm~D&W8Q5+V4~&r{d0oJaCj)d%s-h1^^t7b z`_{NV9}CHEBvXfc5-Wg=2X2=U71jfdTL3q&0ZGo1=Yb=nKcsFXeUGefxV$Skv?odm zJWDMx+Hu4@)dOm1uvE8BA%yoX0`mjD3rab*gXTW0hp_VT$ukSpHu0uL@jY!*{~3Rm z^)~dR-sZ<(>jTu#5>pKNj3*^R{K%JtG|c40q40=c!5SfxZ1^;ICS^jrz!icJp(0mZ zFxvm{@?7Vmn6G!{W9moU&ia76GUfz;?y%^y&b$6}BlKuUC6KUUq{${RM_^5g&MVeLHIaB}j zi&O_L7q48O2$^O=_TUh>v3asp;IsPij8kc6RpQ4LcS7y76l{?jGD4CHAz@4hf#R!# zd^&K0151$*8hfBNR^vEGEI>0WGe88&8X?ewBuC%?=;RnEC$9x)RUdJ6<1;YS85#T@ z3j!z^<}ZRtsIp(=>OJD>-OETx8GZu-;7oq0W|*ZEDN;qJW=2apr|P5j?rXE7t6Row zKDUk8R72+5+RnN9Xlcu+=X2YrEAB1ommp{S9_p+cyr>V*@31qWB^!P-+KPQ5Kk4<#qw?AnPVsKo5d+j*b+-tW!q zuen?X!T9~BKQ@k3g#HxFcqB%f!v<^~AcBZwBS$hMM>b?fF%$_AnJBjEXoe;s8PyO` z?;xU4jV8{Iqo79$LQi1D!$^|E3MwX_3$~~Pxz)ALmT~o?9gHIZPZt7n;E!NR2yGRsx68kbyPg_Byry`Oh&5;yQHc~riLn7%rc_Y7r zZb`=U3L3wQnIOGF{d%uqI`sCvj1J=lr@Ft{=DHJ=r~966ZJKUNNU6T=`30`KU|!Nc zr+$~YT(4Ljp_QAftV?g|o~!e&Wl_#cnJC_h*JT#1=$pRZ;gxdP@)#}oBM3_#Yn34; zFPokA0;j&y6R{)5APsz+S|d<}ILO(MNY`vpEI#>IW>Wwe%K`~5;NwCt?(~T1`fUqu zeQUB74-za&)e;>PLxv>|lyE=13gk!W0SNuE9wd)oJ%JUEuZ}fD-j=pyBJIoD$}iGA z3633tBcwD~4on}Tq8w24b82s3e3CoMgJ+P&*s@K|G3FZZ zq80t4>(?sHFFdx@ta_yFwwhaAX8In(09li|-!wmMuQz$yr%N5v+5%j7(`AaF;t~-j^ZTp_kg_YqwpNcz4gQL_qDsVXW6+ycJ1NfZw|b~ ztbIA!#B6r$5PVSajHp(81LGirvEz}hE%sTAzwVm$NRz~vcovA&bSUHxXKLv6)37qgp5G6sBHuA5}O4T7tOoM z&Iv1VK_epC&;JGj1)n^jtZJzc36e##=lk{Htln=NygA>$w)4*JrMpW5bspwZb$+O_ z;X%L7D5?mb@?FqdWfbqLkja~p)h>69Hytzz@Z76KxZ%PUAn&% zCL>`A%`HBx?q3;MX3)jA!>LG^ Yhv>iQZhp^yc4qOfNd4j!Mp0(}0D|tJ#Q*>R literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_my_short_description.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_my_short_description.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..402faddb84a0c4d5c7cea172de3a36a9397425fd GIT binary patch literal 1806 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_sticker_mask_position.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_sticker_mask_position.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7b4df04dcdc5b84bc7b270012f15a6d54232a331 GIT binary patch literal 1891 zcmbtV&2Jk;6rb4-f5lEhX(I|P3~;G|+Tp-~D5{FmC?I0DBB?4Cx0CVC*fHJ@Gqa`y zr6bZPYB9Q|JR6cq|6@LVWAoURKDH5mLjKTrs#G75aNu*RlVm$lyeayUl@Auw} ze=L;>2*$(jesBF^BlM>h#v_w5c)tbAJ;V{m9`dn+vE~iW@J+|`Eywb0#|E9rEidC| zoh-!7y%wsDR`20dIk_r4(U#1w ziD*6KuJ%73R?6W01~8vPjsiKDBgeQ7xjLq>9Ge?XhMOYGt$A3Jhs>ND&w!jwWs#R9 z$Tqiy`Q%;H!n|~6(ka|UpI~QV1&!b3sd#2ZL@QCp?FxA`O!g|oSs*a3D?y_5jv{^% zD2YPiuCt)6wSuhqkQ?cZk|Xo$QPfj&)v6mxQHe$=RzlgXHp56&S+Dc5-Z9>AX^oPw zMHorks5FiWSq0A{f%ttDk*4s%psl~n9vhU1AOseX+e{Hx3Kj`Ynj1-2@UaScPegqg zC^F}UT+FSl%Dz}5VL(*hb%j!uLXzJ~*q5%DBmW_C_~Iz4qd6pA;u$cWfMaZ`NXFUG zw)(-$xH&$k9chZ2aY=imV_3>qJ_TisFVK^#Luqe=vjE_t-P=sIm4rir;*3l(j;(qa z2v;|n9=Z$lnVCQc?_UPy8+;Fx(bx`}`|vz~CmkO?ws2z;ZyFqL8Jp%0`0M0^!D%q- zWkXKE;v~wSQQ3%X)$a)z=P2z2oru!19iKW9B~`*}QF^#Zo`UUho>JFiN>QqG0=nG> z2REA~_~`LpF6>%z`! zvxC~UHJi>qtl6P~?5oCZ_Vf@<*=u+>jox^3n4ic4i~cvwCoWURN2t_AOme9M%m8ky z5BC9pEA{OjXQGWB;Fsc}yHDyv65F5_O6D|gHJK7p{}agKnFB*3gQUCw| literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_sticker_position_in_set.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_sticker_position_in_set.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..06fa42a84029b61263a2071c44d00478bffdceaa GIT binary patch literal 1632 zcmbVMy^kA36rb5$ufHz|a5}~5|(4jm7S-4h1IZA1|MAo<}RX$;t-9ni?Qa7&={GnIkH>}WRqH9W@NiI zMh4nOG_#MW&1{xEyYhzan+QFCl@2#Yvu#w#Jlr54g~L-%yKi- zaBXU`EVV9xP98!9-cEUz69rnjgZh{j_e*a64!VimLL06AE9H2j%~V?j{*Z~wTn0Mc zOA+kd`lH~$*pbXpyMc5@NpOzh&WPV&j_1hK$O$4XFy;7yd5Te|Hw6pk^tjU6a5iRs z&<}iPy!2mnt}rzbk#y=lr>uUxBPQ&+!y`vde4j~KEhKlh`9%1v?(8Zxmi1cA=Ymz$ z609m0gBsi+Yu-3`6YgKev$`aRU@vhKZvb~vim@q`h_g$>*bE{S=T`P{g|tsLBV;_K zUIgir;TN75NRa{HV_PIi#a4?)%-6Nm!+@pxu80smx(Lj7_%3X!)j90khxGtfIzIdF zgc^Hz&!G4RW6%5vf17kEbeP$y7@`EqVhzZz2%0M+Cu1h!93epzC_*Zk_=TsUB$9=F zLXM5ZDX@(5g!rK+B_UELpsPK5Og^f2uW>Q#ZgLt#gYIx5JjDe8q`NG-(QO31E_4Zd zXYBbyZ@^^N3%G9HTG}A824IsVq+|sq#05d9>Ub*F;i_BCbD*uRGI$lVqqKZ$B)(c2L^+@!D@U;ZM)a&XP&R(#{dsz$;911<+HJL|Jn>>!eoVwC2tL zsT4J8kvC$5#05e|oK8Z`mk9ZM;)TnTEFqNpux<4?592a`nG_okg3UETpa)3`0LZ66 zK7Rb53m+nsB(5zJ%zYMyP$w)l;7IC{UlcEEt^A7Q^uawKfWYx@VOW{m0%=l0>t|=p z`FeHMI)Zk?GmXU*Hqx%K{G_N4_XX0GBzE}I96{uj+B9#TI~QK7$t zNxZE}USrpvz@rB2g#Kv7wwjIso;3I5fml6HGLh9*=T@fTMa?Cibo!5T7t#uRAl?E| z<0AKgEKH2?9KCVy>^wy04^Eng$T@g+F6>vZ2H<3RFZ!kP@Z5WUC&&LhM=6Q&2_bF4 Ac>n+a literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_sticker_set_thumbnail.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_sticker_set_thumbnail.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0a1b7c89501f404fc1a0f8786dc2d1e69a91de3f GIT binary patch literal 1993 zcmbVN&1)n@6tDi6&t#HpzBFOuHj3haJHrZDAuNlM#5g27$|ga!cVca)t7g)h{uryO z)yNzsu;2>nO?JUOc#u`ui>Ez`e}IPwdl>o@@RZv~JV;Ky>YkYx3<%a#zji)h^$Rij}zxlPkI)u>gQs|F#!YIdgfq8%kB8rPV#Z(l@tFG#4rsnCU?xoC>mp0R& z*NELsx(PX(8r97dQOz{bXol$5z$XXU z0iW*iQlIJZkUPnNoKIw$V+E2WLyr`4;XbM>WbEFEnZJ)dQOu!r)c-GzN7L(6tP989 zr3|=@ozUC%EyuNn;QV<5#wMqR*m1bw#R(W9FgO*UlIotf5!4OKV6+js7Bd27coyF^ zcoJ5+my8YYuLsPtgmgZ;x(;|5UdRQk6ZTGQJ?q;G#SO=gt#QbkRD{gu#)2IXx^QQM zh4hXQ_y!Mcn{r;t$LC)ULT1wiV@HT4UnrODfYFlZ6{QrgMtM6Bylgd{mmq3?BPs^T z#ZjVZFrI@`q;bI_-M2g%X^t`x!?2WNT@m_I|*2 zYl{JK{6=jzWR?gRhQigT|50tt*{*R%(92EB-nAN(*DNQHcdnfDEH6XxaIds*2!RKP zmzsO*B5d{PrSlOl^;0pxi7x~BtBty|s4(~C^5-jGtUMdO*hOk#q%$@1?HfN`{pD6y z11VA6v`>Xtb4rdO5GoEQNQ?rXpm{-ZF{H6h;>so^k?6#=X3t6Pc_77MiL-1xjH5ip zUO+-u^1~Q^7+P-6lEIh+HmLROAaJ7sz#lgY;0VeQjG^&y0u#uiAfLYcz&AdE?4%ea zxjZhAOZxoONivM4X4*G8Q>{CY9j zyip2llrsqgfN#NT0d68#PK##FRe-($y42>7W-6&dx)0 q_29qeA(}flJ3GiYI6J%PR}@J4-{j#3KP)|)yYh!L{dtZ(KKb8F4e3s!2mbHF%7$B@`7Wv#9%`|Uld=~@TzM+sk*pg@b?f>k>tyZn`r1eB z&PHN>5bZw1nPqK@g=`?a(G{k4IQ27s8C|%?^Q$0#13@$7Vv1bj8U*i}%yMmNxH)RF zJhd)@O%Xx|-p+Vd5G7i^jry3D_A74jHu@U7r7l{2>y>1s%T!kd{*VdawgMHhn+GKa z#x==UL3!k-|9i_&y)ol7)u!dTI(cogx+~!I)y>ak1cwJloTzY%zAz1hOs9x8VhVJtkw1pz#JEc&wdaj@N!fnpcNolSQgwU$l5l`Ig4ixo+MY>aos zNx01f(-)M9S$@(*lVTntMfCmNitm%!DK*LPng%q2?=ud=Y!$Vkb`swHPPrmc!gQqUWB zfdB%>znNj#g&ESMf=;bYu1rtWC!Hg!I%!YZx7t(d^wg?NHYc06HmBA*NBNU8RJJ$q ztdK7PMgNNyQxBP+C#ZOR8EU6q)Y$c7c&~t+(Em3{PVJ5Xo-FtDRao1eWFoImon0Ok zE1F9^>GU5LE@l;YUz`U~<0AKg%uI~&6uou$^gKf64_`EokaPI-oaIhq4Zw@(-8T=c Q2dftzrQ3hM#3+sOU#di-zyJUM literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/set_webhook.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/set_webhook.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2de18393fce76166b75aa8303429e65773d20d0d GIT binary patch literal 3400 zcmbVP&2JmW72hS7q)3UBW!bUaSi!`Vtdf!_r*@H4FoLA6E7@@*A(Y{ok-Hl04#^Fd zJDb^A$ux9efdEZ`w&U*;!B?oO>bU8bE zZ|2SW{LRejFU4X(gXil%{;hE^rD=ahX82?iLVx}d5T9wbX6vrj(d)X7bjnS2()D!5 zs2iP3J=4k7voM~v4L8>rtB(Plv9oTzQ>YhoEv2n$cJ33+9%BVIeraey`!cO*U%{I^ z^$9y))5?Ws$d>hZoO&LYR65)X%0^t=dboMpytQ`w)_Zr>SL5`%UN<)GIf0DFHhdJK z?z2>~GJnVOL-{kuWzY0vq_o9c))ch!K9enOTWDhV4=O*KMtyx(^}O z)6A%6>{LB#r&-Q6Zh}l6f~$|&S>SUcJ`cg=?EHu?*ahInNBp=w0eo@9PuL~kCr5ly ztv{3StR&7t0#ANZpJ(k0pK1-=e&v%=eezT7v0gt@(}sV`7vn;W$p>t=#d(`v$!J=E zz;i!fM7ErObX3?xauWE=avEJi$^8%R5$f4QFpD{Rj5wafJC4^Rp>I>k0H&29dQxeT zl68C;RLKWShQbTL5pJ`Uoh=cv9l|{_Fi};xztbRH9?sjub=pt`PC69+1|cL&wkQM+ zQ4cao_Gth)l4Q4wYZkEs=Rx71SOK#HOhZ{Hlu0f1DTL0@-AXcRO5SE(1p;rJWOGr; z4s)$)F-R>$*<#d&_47Yp8t#szpK!VKuJ0_>l)1>|N+Nc>K2Kg1Yot8)y8uKKm@hep&j}JWt*X6DtVk_h&iKo8v zeQQP*9e3RO?fYasF zl;g=q@nnZSHer`|%u@H*Ddl)|eTeHpin=b}XZ8@^$EA^hUC!M{@i|*?-}K=Wg|rQ& z;)&B6znm3k;cgP=uzLl&i`ab+yH}x$FPpVdxTfiMZR$zKGTZx9Gy?%Qh8Abxkb#3O zHr6>fj8`Wlqryi8Kho=t~`ac@Zc6Q&A4Ei9d3s% z(i5inaY)_4OwKfIZo#mDSdNQOB84(UvKg056Sk(ABo6pV;7>mLK=wO9Eev!9(~Ejl zIW6Y8fDK*D!f1dm*qPn9xbeGNOJoxjw3KRW+U9n(OkK=acGp2c4U-MRHUPY zWgK2k+L5u0!@tPE@S$<>^mt^v8C|*ByLV_@P1=!h6=mDT)7-hfHj^nq?XTU4ey|uV zy%Al16I-R)pT3j_0Q`Sl9+fK1qfT5Mrfj`j#0ob;I3A$FA`KI97QVZnh)E6b{1Esr zgTUh=&ZuuPfvJYN!zCv01Q83^sX`E>lzuGE@z~7-J#UK}z+%;cKSS3~>$)CkR}Non vPqiN%zN|gfW)5F$kwy+*Z2jyzx(-qQ=l=Jv{mJ-dYVIFu`k((rNX77P#)9At literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/stop_message_live_location.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/stop_message_live_location.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..da8a6dfbea69791af69d8016b867ba05a9df333e GIT binary patch literal 2376 zcmbVN&2QX96d&)}`@P#HP5RwpwL$H+$)=^0h^2*=w1miaM(yWSUyGKRB>4p4k!o2d-m?86{(Pz9lw1u@68*( z-}}w@VLqQB(0=~m*Xr+SLVm+Rr==oATK^K1yMz%YS)?Xul7xE9iq+y;ye4aMP0^HE zLQBAWoXJ+QmeNwSw3ddk!V*@dmesNniIFkFlD7#<@hng9G|yFIdpdiOP3=LPkSFj& zP0O?N6e(t&;jkzLS>3iBPxnm6c8hY5zxwfq7wPEx7e_B&nj8z_=k3KHb)}AG-3pXx z8l8^UHj3*3ku<(8WTd9waBY>*{m-nG|hMxXLX)C-m9`_vRgD;J%%f zh!ko45hz~)CY)#zBU)@4u+idN<_b?dpOuzmF)hX7TAIl`!;~|yE)6JYS(botvOCTJ zDjAmUj`N{^raLaMEZB3=m~Rt3fOO}Vzpt&`)<_$jX7$JiCIY>IALYsEE>dl+3S_`vQJx6t6joPR)@U-VtUA17LYPDB_Ux=DI z%d3vy>M^v^Iv1wHj;Z`s-4xs{saI^(Z5Rgl4ytAqcHrHGuoo0k)os-b%hE9nhF+YR z9%pLVuyofgU)N0sOH%R{>kziRcd4DxbroU>?lpwX*`VscF5;#M36%|p@$&VnqQPJA zDP_W(r<{f`cv+qIyt-Q+9yTD6lGm<&$q{qIvySHu>vi)mV$t3e6YZc7h6#3|wf!#7 zqdU2g?=bP2>xr3Q=WN3T0=h0W9NXpwvXq)^V^7yD4-CCrz@CZCsL=W&%>_E|vVke5-Ac7)&33Vu~ zFEZWsOoJ}m)Ww`D6!cF-bqM512NJ|1g$+$`yO1m)()xR#d@tRF`@rkiVdeomPvD8# zr(Fw+ElEqUrTCJ(q%i5evXuBq`YybI;8uuF3cNQSkpZ=J z2uO;B2$}7mM?~mFEo4I;EAm3@LV=KlWf%KU+Yh4Hixsf-8mBbKP+D_X!$Lhr z>1PeyYFm<&GRJ^&Byk~rf&zKgajYN@bKyw_lwnnYQaFBq8(zij>IK_ia`Phqvs(~X z$QW3~zz{O5slhD^Xd#IZMkLrdaTvV{9f1^e{{{j0ZvI*^SxL1BiX7?Rd+*4PuiqP5 z?K`?W;rEx8C)Wl~H08Zb86@@<`GhYo_{E{+v8Fr}^%Z%j6(dS5=BoqCA2j8GsISNa zzFhZ@9B<0~O&KKi75TU?Gyl}c@_17oiTa8>;>%yGCHq=rk5XtA$muuzlc)WogZ}U- z|E+gg+xpW`&;KXV7%>dn6=I+R$YimAMXWa9ZiONW{3-_txP+lP5yE(~1%4L8N(M@J zK??-3Q&rvNB8TH5iV*9AsD+y#{u`+?5lh|{ufY%t<30q@ic6B@lS9oH`x<$p`ComF uoNR8@eWEsB?5#veg8ct2?%9u~pN{-;;py4cq4TQ;-~9u9{@lVbOynPZO_-hl literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/stop_poll.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/stop_poll.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..334f1ee141429c4f0323d44b874016891e7150fa GIT binary patch literal 1955 zcmbVNOK%)S5bl|seLqa>JdKkK2?#9;yO9t?nDCMlnUL6y%8m!jUBU=c9O5d5q9Ct2s+%)%u4ZU%-pIQJqX6?c zra48oWR%>pQ3g5B3QonX8dZg;WR|evZNf^t%FD-wyO8@iLLR`#no(orMbfN1MzN{H zRnznQ&xT@ z!0m=n-6EeVMs1M{|C!Ghpu+U9C03-d@nr*G= zw@j%^?uGht4~)6K?1wFV!P8~evbdCI(n(wvaHdaNjw$8zP1E)fjaJwTxNM=f7Vdjf zhs^{JyTaqFRY`+b^t;01)B0K%26DRHwtT@`;U1hVU#zxaN7*(5`*gYsxJlQ=B^1%? z?pT_x>$Vr3fdhyeanV{cLu#`)2Xk@7g*eSs4iodc^R{+Jb;n4k474%ZYrDVW^Pks$~|o}|AX>% zdbObZbMsA29DoI40?8=KpRlg;vKw#_mngM8JEXK(jK}{GGnL#~p>)6H;wX5F%ao?+ zrc}a}Cs<3 zRZBZ7L)pf}(zIxTo;U%nHx3LjZ4HCfVOqWqPSS(Oo7}Ecq7ePcHn1#&p;bTE=BGja+qXs7zu)q zrc~e~Bqo70>jTbmlB{h>A$X&aF?(O>894>1qFVQ1lDYvPhTj3pk&F=mQBe;4doQFDdbZB2;*+)e3sI; zL>olJSAGv9$tj8wkyC@G`!;!P@LzqKv1Edo*_X4^;iR Ik3Nn6ZxIX+l>h($ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/unban_chat_member.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/unban_chat_member.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4bd802547bf5f4fdb8a3bbe1aa4f7b2e0c7e377a GIT binary patch literal 2189 zcmbVM&2Jk;6rc63KNCCYN1zp{Ius~cD|I9e9HI(ALlp|CK_n4k>oOhhjO}f9cg*Z= zicuttR6&sdaX~%M0|!)udgH)f!6B7;i1rkTQ*TD$fO6u^Y@L!&fy8*``Mr5>X5ah0 z_vXiHwSr*$^4+hUPl^crriAe*WQ?)<0Wh}_L(K3|U^s@M_?({$Ovel?#|rXJJ}5W^ z*f*Kw7lV>hGEfdJA(p?1Sb>*#`Q-Rkbk{`a9;|FQ6;@n9cIlxKZ6lqaVJKo6dm@Z% zE3K}+|IS6S_{PP>w=Ol8QuDQNke1%=D>e1g{8|XiLnAv{Tjf6QN*Y||aZfNe`#?sm z?9bTk0rNRT!;xb!MD#zrOlV>@nz)W6b)_JfggYUo>9`Qw|#7ZESGntoVl@(d# zj=`pHp^m|(Zq}U2E%cG$Ost^szkMW~S_|7WT

    KG7s8ZQkp}kf?=#h9LGH`!h!Y{ z#{wtH7E|1pe8Uq-81#ovVVcAu0H|H+`-3^$PGYQ&w>hS5AKVl8x`3~4coh3yxITw@>}KC; zix>w<6k}xzezCv{y(pG62Cq7>bZBtF4I$SX_`(1)-l2&f&m9Q5n@~x^nDYp>X^d$n zhCr3G$|ucap+^`Zg75>4A{L#@2+sVA-(K9nD*}6&@%W-AU7~IqWWiHE5-O^CUGhL| za0WPbqzLvu*ua-McpwtYMED{g2L6N2i{?}Uv{fI1f~-O$brJdl;&n)t$9e<5t5Xu; z1y?Y>aBWp4{2CS^44508_vVMcgZY1-{u8@^rYBfd3UDc>+n6TirK@$iWyBC1@ z*0>GtMLgES&RtmdU}fX_zJ}#Cjm_Mq$&5SZruBpIwSJA@1u>hpDQjRZrxj6N{)FsY zn%5nZmI#3gjR~;}>CwMAOCs)f2sw089)sg)nGn~fQA9|j-a^&2c(}Lr`a_WY>4 zFDkQ4p}1YR3fYw`>?-gXYEz0+(8(i;C=_%a<#EN$0I??(lp)kNA!&t>K(NGD{3IbC zCe(kVDH6hj3)_||qqGVL>%s@XV6#RDlrG8e0C@`J$Im|4Y8TX-tzl8ebs}8u`;b9H zJ_D*q)x@iER#`zIWu&AOKLY`r9{)x;D_HVgnX|*@jy1cb=Y4B-ltcM9 zbKBPRaCx}=>GHPK*nYttHn%K0oA)gn_I8TLM`$Kr8y!WBmqrsu%7EzqBV~1qzG|OH zm17-A)1FY!b`p5K0a~frB`w5*KAwBq!g3ZlKz z`7Bkh$U2A$yXZ3@BhxU9ZFFYq;M_qkZ~fQYL3r!n92L$Q5Y|7*H{tiI51y+3u2g?K IL9hM%3s<*mH2?qr literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/unban_chat_sender_chat.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/unban_chat_sender_chat.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a67b3aa744481216cf83c0d5925934c643e18138 GIT binary patch literal 1758 zcmbVM&2Jnv6t`z)KeL-ao3^wB7!@J3RoUgjC8|(ShysEJ)Fi5yE;zGeXLrcVc(6Sw zsdC7n5(NP_R3s4MfC{L0#2>+7EA?lipGUGypT>Pu++Z#DDND@o5! z<_5l6VhLqJbN(d=t?oiwk<3+tP`a^+%~jmZw7%=RsbCu+&t$aef*@hk4F>uj>A!MA zts}FPiN4@j>T)q&Z@bF_=JvR9<4h{I$6W1?#$gglC42>%YcR~Vu-`2%)+> zM+7!$DtIbFUjcv2ScLt7l5O`oQ<+GlI~#DyW>=R*##UXPKu|%zq-@tshD$sX0h@IP zN~LnP(+Rj>ZFNwQHW&R4L@GOe8op>U*U3qPl;(_!{Ipq_gZUwb`%|XKH^W3-b|J41 z^NKbgAPACK+=_d6P6$WJemM{8J!0|?TS(wyvXOSl?(8owO3x+=J z6A0nGtH6AN?}1Q_*Fkb0#se5d`}n^VYHi^yi{kICE&C_@wYeK`rtQU+C7Pftrhxp4 zT2@{%CC#gZK)Dnltx|sKNR&jfXpN9VBk>ei<~2fs$d{53sT0sAYkS{&bGCZ}irbyz zG)(&4^~@BX0N!1eY;@lZdtDhS_Dbpp>wcfft{-xJPdde6lpO~js*aE*4Rq%G_O+cem$nyootdHO51pAE=k|_sZfN>L=iH9-+HPffgr-V8 zJgQFAfTI6JYsN$2=Li)S#sM$3>Kehd4DK}`DD>l)m(^wpAQcGc!zJ_`02qDAgicYs zpoz(PT64yoMqh~yVQMmENH2VEQ<@4M*o@X37_xx?dqRDK?7EKa81 Uwtty^bfNv1S^oP8N+#BS0YeMxMF0Q* literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/unhide_general_forum_topic.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/unhide_general_forum_topic.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4e2719df7adcc66803ba6e204a8f62c4741baad0 GIT binary patch literal 1718 zcmbVM&2Jnv6t`z*KeL;lswJ(IA`677t;#Oqz#*zCLP!IGMu==wF)X;w*x4O2GhS>@ zOHdCvRH7i@fP{*~g##*}-uV}}a0pTl)tn;r)Z3zPKsoX3+3g3A3m(s#_xwKm-tXD- zW2@CbFn;;&x2<1&gzj5mIw}Q&4+3CrA&xkXQGx@EE$_u%QVL3mANWZ*D8pKb`*9_y z233qaw2FB72I3V_6}3~-i0F0+p*!#vBdGK0I%?M*Sh0=s8J4EfFcZmCw@Z1e_wL&( zboup_uh6MYa6537WTU))izl3!gI*3+KdD_ z8?uxpEM)^h-R}DAKLV;~Ff_VD-Vr8KsV0k|V9?rRDzZa$E9D$nO z&#Sgn8u7eMkLUxXqaDst6NPm98dC$U%Fx=pqFhC}za~==+S6l){aW=5um=}_`3B#D zqid#mSh)@F9e9iJ;X@7gIKGY}eBJv2f8{O&9OTlPYJuU;sO{xt*Ur2~DKyMb+V=Bf zk0nR7h_@(p_G%WK@;aqq%(SLd!$m}Jl6DV2cx|zN8JgK&mOM%a{q4*(o&v6YkzVb; z6>au)WW)<27H&gZb)QAj-iK~+_;j~`mQIkT4*H_`ozadu4jX+!j)1Z=P2FB!-2w8~ zE*j6G*6A--K3n}_^=@-vulXv>?=Rc$i%W&{kRE^sYFCO9o4~s|T|d;E6`!*D84FR$ z5Hg879i&u3ZTH^ETwSBXi+oBb09zZlYp%S z)D>$z9m=7IV`vIiPlHO^w!Wg~t(E;9I#RQWuYo|-kDjsTmuq8WNfVtowR`E_iO%lY zzQ3^N=I{Q(*hA$dZ@+qcjAqKqcwDR2fujFK>n=hO=P{~IPLo_~H!Nyf8QfPuP1&Db zUNJi(0H&zgo^NIUa?eOcL&d7>7H?L zl!FhE2#AM-go4C{0}7zr`4t?DltVNpOF8AX$Q+PQRP}iCk|QB{duqD69#i#Ib?-0D zW}U$J{l`CgXG(=mUGl*5W! zp`<`oh%DV8vaBkqdT#8I+%6Jw2cCSmHCb6Ft?C10TQr*xQ4}X4@#Dy}idl2xqYsw( z(!0w`?_FG5$%>27ZdTfiK>C2@29p~qP<<`JRh0~4>E&*7di)i7_zv)&L;Q-kR1&wa z33<3h<+vqTaLcl&D$=!8g( zR7t8M!{)tMs`)D$I#pL#9D#4o14P<&3*>s7YER9xL6Qv3e5d2ZTD6noYPVzE?*Im- zBZmG~#@9ZlI5y6i{E90SZg&MIiheVM(=PpU5G!(Az&#P|62 zRiXPv!$BcgS=&T1XDyDDhYg7X-zc7d<>3M>zNfd~G$dm=?A(Uu4m|nzpbyqe;@7{d)O}m9JLrHfHu4Z^8WO z629M9%(;j35G+WmoF~_Swaw60LQf(49LgsUoJfR<^Q_K!7|S%kb%XOyQxP0XDxAyM zgKcLkj)SZTnAuVS9I!dbIdm1YG~Ot{PXYhvS^`~!(q@X57GF;R7`#RG^B^)<&^PrN z)WW;fk}3+m1p-+=`i%-ssX8J^8szl3z14fCU)x(daAx-H{L`7a=Uh9eOpnM!X^D=i zl^Rg;zi7>R$o)J<_1STRYpps$)=S}Z0%RJm&#av6!rAKQDPvn}{7(Sfgi#uE(z8fx znx}AO-C^oS)eAZL3;Gpc5fk$zkWrCRdXK!g|KvO%bNkPp2ZZfEIY;HQ6tOs&{;=@t R%XeSs{AI;|KSRmJ`Y%eW`b_`; literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/unpin_all_forum_topic_messages.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/unpin_all_forum_topic_messages.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3e00676977760e9927796976a7f8d557cab10817 GIT binary patch literal 1821 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/__pycache__/upload_sticker_file.cpython-311.pyc b/env/Lib/site-packages/aiogram/methods/__pycache__/upload_sticker_file.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7f4fb5c9482d5f9f2299d89876e4b3258eb1a55e GIT binary patch literal 2010 zcmb7F&2Jk;6rc63Kh}wzrfr%OTDl^DYSh~Is6vzwLPTPrCQ-%8VzSv8CrkFj%!~=C zaxhXQiUb^xP?12u0TrR%`6CbqSL(sqQ>319TNDncC*I7iU7Dr`CbKW^&Aj*Kz2AE? z{`{+(iTt%}0S|YntS9elE~$JuqwoWStm(J}B6Q zplBCC&Xa;)3QXJ7P!263QoM~wiJG)}57LPe$7zsys zQOIk#xU%-a`wMvf-G%x0mYR#Pem&ef%t_5$Y`o+7G&YyQPFG0wP)j{j*Qigom=ml} zu^katIv$SfSncRTSos{1qsZ0>vUBT@q^(oK&Xb&7AUZ7);~MCgkP`5Pj4uLTN_kph zWm3I^+8U|c9=FXq=u^!uucG1q+C)6L-ti-ctP0QFp-jf;`~g9hEg0*ZT4LMdR-mG^ zL}Yc9w&hrD(6n|vu?;*=jjeXXEZ-57SzWO7LNKP*oa;NB&uutfBonTuzIfeb6jX6Y zcX4KqITiJJwcMn;SwyQ;Y+QM+6NiwIwTP61>tvYBT9g_?RL={7(T?x9bmYSem5&?g zau&i;DE(w0aO<+nN~P~Qp|we6vcw9yzVJGLiSPo-Yjx`e6~$!w zOJ{Wn{e~5V7Vo+)<-A^2HCTs+w7nn@T+8aN`J#p}o01mn&gaY86P z-r0577H4_sr@&O+vC)h|>dJPPL-sUWVKj!2cJvl7-)eW^@`>R-tlWd|K78r;XtYCe z``UhPUnklR`o8gt_O-g=a2@q#O=lCJ&Q3{k8pv<*&gFTxLs?wH*b6;@ajg)a{!g$_ zV84y=F-vv^%wrQ{)vXwF`M}6KVD%o~e0#2SGh#cf`G|PoR%@rr91$@Lz_)1lNo(2L zY;jM}s~yMPakeOLWxd|WdcBcWVAN%*-km)r-*BX9-JSekkj_!K!=e+3_# zl$=CD)smf++!T=7n1nNQ0*Y~5#yE&b*O&Y_#vgYbKier{Od=Psm8Fg=z^GmT%s{n@ zF*GSoApv;;S0hgrq|Qh zbl|qi-@`QdX~`+C5|GEGYiUW|V6THHk>cL~Npwxq2I%Gf)AInm+COO?pxORObAYV= d(=#c&ra_X=lJBZNi-$8;{*qgNpRliD{ufvXG%^4H literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/methods/add_sticker_to_set.py b/env/Lib/site-packages/aiogram/methods/add_sticker_to_set.py new file mode 100644 index 0000000..cc2e31d --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/add_sticker_to_set.py @@ -0,0 +1,42 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from ..types import InputSticker +from .base import TelegramMethod + + +class AddStickerToSet(TelegramMethod[bool]): + """ + Use this method to add a new sticker to a set created by the bot. Emoji sticker sets can have up to 200 stickers. Other sticker sets can have up to 120 stickers. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#addstickertoset + """ + + __returning__ = bool + __api_method__ = "addStickerToSet" + + user_id: int + """User identifier of sticker set owner""" + name: str + """Sticker set name""" + sticker: InputSticker + """A JSON-serialized object with information about the added sticker. If exactly the same sticker had already been added to the set, then the set isn't changed.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + user_id: int, + name: str, + sticker: InputSticker, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(user_id=user_id, name=name, sticker=sticker, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/answer_callback_query.py b/env/Lib/site-packages/aiogram/methods/answer_callback_query.py new file mode 100644 index 0000000..15ed1bf --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/answer_callback_query.py @@ -0,0 +1,56 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramMethod + + +class AnswerCallbackQuery(TelegramMethod[bool]): + """ + Use this method to send answers to callback queries sent from `inline keyboards `_. The answer will be displayed to the user as a notification at the top of the chat screen or as an alert. On success, :code:`True` is returned. + + Alternatively, the user can be redirected to the specified Game URL. For this option to work, you must first create a game for your bot via `@BotFather `_ and accept the terms. Otherwise, you may use links like :code:`t.me/your_bot?start=XXXX` that open your bot with a parameter. + + Source: https://core.telegram.org/bots/api#answercallbackquery + """ + + __returning__ = bool + __api_method__ = "answerCallbackQuery" + + callback_query_id: str + """Unique identifier for the query to be answered""" + text: Optional[str] = None + """Text of the notification. If not specified, nothing will be shown to the user, 0-200 characters""" + show_alert: Optional[bool] = None + """If :code:`True`, an alert will be shown by the client instead of a notification at the top of the chat screen. Defaults to *false*.""" + url: Optional[str] = None + """URL that will be opened by the user's client. If you have created a :class:`aiogram.types.game.Game` and accepted the conditions via `@BotFather `_, specify the URL that opens your game - note that this will only work if the query comes from a `https://core.telegram.org/bots/api#inlinekeyboardbutton `_ *callback_game* button.""" + cache_time: Optional[int] = None + """The maximum amount of time in seconds that the result of the callback query may be cached client-side. Telegram apps will support caching starting in version 3.14. Defaults to 0.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + callback_query_id: str, + text: Optional[str] = None, + show_alert: Optional[bool] = None, + url: Optional[str] = None, + cache_time: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + callback_query_id=callback_query_id, + text=text, + show_alert=show_alert, + url=url, + cache_time=cache_time, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/answer_inline_query.py b/env/Lib/site-packages/aiogram/methods/answer_inline_query.py new file mode 100644 index 0000000..acfb80a --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/answer_inline_query.py @@ -0,0 +1,145 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from ..types import ( + InlineQueryResultArticle, + InlineQueryResultAudio, + InlineQueryResultCachedAudio, + InlineQueryResultCachedDocument, + InlineQueryResultCachedGif, + InlineQueryResultCachedMpeg4Gif, + InlineQueryResultCachedPhoto, + InlineQueryResultCachedSticker, + InlineQueryResultCachedVideo, + InlineQueryResultCachedVoice, + InlineQueryResultContact, + InlineQueryResultDocument, + InlineQueryResultGame, + InlineQueryResultGif, + InlineQueryResultLocation, + InlineQueryResultMpeg4Gif, + InlineQueryResultPhoto, + InlineQueryResultsButton, + InlineQueryResultVenue, + InlineQueryResultVideo, + InlineQueryResultVoice, +) +from .base import TelegramMethod + + +class AnswerInlineQuery(TelegramMethod[bool]): + """ + Use this method to send answers to an inline query. On success, :code:`True` is returned. + + No more than **50** results per query are allowed. + + Source: https://core.telegram.org/bots/api#answerinlinequery + """ + + __returning__ = bool + __api_method__ = "answerInlineQuery" + + inline_query_id: str + """Unique identifier for the answered query""" + results: List[ + Union[ + InlineQueryResultCachedAudio, + InlineQueryResultCachedDocument, + InlineQueryResultCachedGif, + InlineQueryResultCachedMpeg4Gif, + InlineQueryResultCachedPhoto, + InlineQueryResultCachedSticker, + InlineQueryResultCachedVideo, + InlineQueryResultCachedVoice, + InlineQueryResultArticle, + InlineQueryResultAudio, + InlineQueryResultContact, + InlineQueryResultGame, + InlineQueryResultDocument, + InlineQueryResultGif, + InlineQueryResultLocation, + InlineQueryResultMpeg4Gif, + InlineQueryResultPhoto, + InlineQueryResultVenue, + InlineQueryResultVideo, + InlineQueryResultVoice, + ] + ] + """A JSON-serialized array of results for the inline query""" + cache_time: Optional[int] = None + """The maximum amount of time in seconds that the result of the inline query may be cached on the server. Defaults to 300.""" + is_personal: Optional[bool] = None + """Pass :code:`True` if results may be cached on the server side only for the user that sent the query. By default, results may be returned to any user who sends the same query.""" + next_offset: Optional[str] = None + """Pass the offset that a client should send in the next query with the same text to receive more results. Pass an empty string if there are no more results or if you don't support pagination. Offset length can't exceed 64 bytes.""" + button: Optional[InlineQueryResultsButton] = None + """A JSON-serialized object describing a button to be shown above inline query results""" + switch_pm_parameter: Optional[str] = Field(None, json_schema_extra={"deprecated": True}) + """`Deep-linking `_ parameter for the /start message sent to the bot when user presses the switch button. 1-64 characters, only :code:`A-Z`, :code:`a-z`, :code:`0-9`, :code:`_` and :code:`-` are allowed. + +.. deprecated:: API:6.7 + https://core.telegram.org/bots/api-changelog#april-21-2023""" + switch_pm_text: Optional[str] = Field(None, json_schema_extra={"deprecated": True}) + """If passed, clients will display a button with specified text that switches the user to a private chat with the bot and sends the bot a start message with the parameter *switch_pm_parameter* + +.. deprecated:: API:6.7 + https://core.telegram.org/bots/api-changelog#april-21-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + inline_query_id: str, + results: List[ + Union[ + InlineQueryResultCachedAudio, + InlineQueryResultCachedDocument, + InlineQueryResultCachedGif, + InlineQueryResultCachedMpeg4Gif, + InlineQueryResultCachedPhoto, + InlineQueryResultCachedSticker, + InlineQueryResultCachedVideo, + InlineQueryResultCachedVoice, + InlineQueryResultArticle, + InlineQueryResultAudio, + InlineQueryResultContact, + InlineQueryResultGame, + InlineQueryResultDocument, + InlineQueryResultGif, + InlineQueryResultLocation, + InlineQueryResultMpeg4Gif, + InlineQueryResultPhoto, + InlineQueryResultVenue, + InlineQueryResultVideo, + InlineQueryResultVoice, + ] + ], + cache_time: Optional[int] = None, + is_personal: Optional[bool] = None, + next_offset: Optional[str] = None, + button: Optional[InlineQueryResultsButton] = None, + switch_pm_parameter: Optional[str] = None, + switch_pm_text: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + inline_query_id=inline_query_id, + results=results, + cache_time=cache_time, + is_personal=is_personal, + next_offset=next_offset, + button=button, + switch_pm_parameter=switch_pm_parameter, + switch_pm_text=switch_pm_text, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/answer_pre_checkout_query.py b/env/Lib/site-packages/aiogram/methods/answer_pre_checkout_query.py new file mode 100644 index 0000000..479d76c --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/answer_pre_checkout_query.py @@ -0,0 +1,46 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramMethod + + +class AnswerPreCheckoutQuery(TelegramMethod[bool]): + """ + Once the user has confirmed their payment and shipping details, the Bot API sends the final confirmation in the form of an :class:`aiogram.types.update.Update` with the field *pre_checkout_query*. Use this method to respond to such pre-checkout queries. On success, :code:`True` is returned. **Note:** The Bot API must receive an answer within 10 seconds after the pre-checkout query was sent. + + Source: https://core.telegram.org/bots/api#answerprecheckoutquery + """ + + __returning__ = bool + __api_method__ = "answerPreCheckoutQuery" + + pre_checkout_query_id: str + """Unique identifier for the query to be answered""" + ok: bool + """Specify :code:`True` if everything is alright (goods are available, etc.) and the bot is ready to proceed with the order. Use :code:`False` if there are any problems.""" + error_message: Optional[str] = None + """Required if *ok* is :code:`False`. Error message in human readable form that explains the reason for failure to proceed with the checkout (e.g. "Sorry, somebody just bought the last of our amazing black T-shirts while you were busy filling out your payment details. Please choose a different color or garment!"). Telegram will display this message to the user.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + pre_checkout_query_id: str, + ok: bool, + error_message: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + pre_checkout_query_id=pre_checkout_query_id, + ok=ok, + error_message=error_message, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/answer_shipping_query.py b/env/Lib/site-packages/aiogram/methods/answer_shipping_query.py new file mode 100644 index 0000000..ad0e9dc --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/answer_shipping_query.py @@ -0,0 +1,51 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from ..types import ShippingOption +from .base import TelegramMethod + + +class AnswerShippingQuery(TelegramMethod[bool]): + """ + If you sent an invoice requesting a shipping address and the parameter *is_flexible* was specified, the Bot API will send an :class:`aiogram.types.update.Update` with a *shipping_query* field to the bot. Use this method to reply to shipping queries. On success, :code:`True` is returned. + + Source: https://core.telegram.org/bots/api#answershippingquery + """ + + __returning__ = bool + __api_method__ = "answerShippingQuery" + + shipping_query_id: str + """Unique identifier for the query to be answered""" + ok: bool + """Pass :code:`True` if delivery to the specified address is possible and :code:`False` if there are any problems (for example, if delivery to the specified address is not possible)""" + shipping_options: Optional[List[ShippingOption]] = None + """Required if *ok* is :code:`True`. A JSON-serialized array of available shipping options.""" + error_message: Optional[str] = None + """Required if *ok* is :code:`False`. Error message in human readable form that explains why it is impossible to complete the order (e.g. "Sorry, delivery to your desired address is unavailable'). Telegram will display this message to the user.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + shipping_query_id: str, + ok: bool, + shipping_options: Optional[List[ShippingOption]] = None, + error_message: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + shipping_query_id=shipping_query_id, + ok=ok, + shipping_options=shipping_options, + error_message=error_message, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/answer_web_app_query.py b/env/Lib/site-packages/aiogram/methods/answer_web_app_query.py new file mode 100644 index 0000000..4dc87eb --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/answer_web_app_query.py @@ -0,0 +1,103 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from ..types import ( + InlineQueryResultArticle, + InlineQueryResultAudio, + InlineQueryResultCachedAudio, + InlineQueryResultCachedDocument, + InlineQueryResultCachedGif, + InlineQueryResultCachedMpeg4Gif, + InlineQueryResultCachedPhoto, + InlineQueryResultCachedSticker, + InlineQueryResultCachedVideo, + InlineQueryResultCachedVoice, + InlineQueryResultContact, + InlineQueryResultDocument, + InlineQueryResultGame, + InlineQueryResultGif, + InlineQueryResultLocation, + InlineQueryResultMpeg4Gif, + InlineQueryResultPhoto, + InlineQueryResultVenue, + InlineQueryResultVideo, + InlineQueryResultVoice, + SentWebAppMessage, +) +from .base import TelegramMethod + + +class AnswerWebAppQuery(TelegramMethod[SentWebAppMessage]): + """ + Use this method to set the result of an interaction with a `Web App `_ and send a corresponding message on behalf of the user to the chat from which the query originated. On success, a :class:`aiogram.types.sent_web_app_message.SentWebAppMessage` object is returned. + + Source: https://core.telegram.org/bots/api#answerwebappquery + """ + + __returning__ = SentWebAppMessage + __api_method__ = "answerWebAppQuery" + + web_app_query_id: str + """Unique identifier for the query to be answered""" + result: Union[ + InlineQueryResultCachedAudio, + InlineQueryResultCachedDocument, + InlineQueryResultCachedGif, + InlineQueryResultCachedMpeg4Gif, + InlineQueryResultCachedPhoto, + InlineQueryResultCachedSticker, + InlineQueryResultCachedVideo, + InlineQueryResultCachedVoice, + InlineQueryResultArticle, + InlineQueryResultAudio, + InlineQueryResultContact, + InlineQueryResultGame, + InlineQueryResultDocument, + InlineQueryResultGif, + InlineQueryResultLocation, + InlineQueryResultMpeg4Gif, + InlineQueryResultPhoto, + InlineQueryResultVenue, + InlineQueryResultVideo, + InlineQueryResultVoice, + ] + """A JSON-serialized object describing the message to be sent""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + web_app_query_id: str, + result: Union[ + InlineQueryResultCachedAudio, + InlineQueryResultCachedDocument, + InlineQueryResultCachedGif, + InlineQueryResultCachedMpeg4Gif, + InlineQueryResultCachedPhoto, + InlineQueryResultCachedSticker, + InlineQueryResultCachedVideo, + InlineQueryResultCachedVoice, + InlineQueryResultArticle, + InlineQueryResultAudio, + InlineQueryResultContact, + InlineQueryResultGame, + InlineQueryResultDocument, + InlineQueryResultGif, + InlineQueryResultLocation, + InlineQueryResultMpeg4Gif, + InlineQueryResultPhoto, + InlineQueryResultVenue, + InlineQueryResultVideo, + InlineQueryResultVoice, + ], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(web_app_query_id=web_app_query_id, result=result, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/approve_chat_join_request.py b/env/Lib/site-packages/aiogram/methods/approve_chat_join_request.py new file mode 100644 index 0000000..2f4995b --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/approve_chat_join_request.py @@ -0,0 +1,34 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class ApproveChatJoinRequest(TelegramMethod[bool]): + """ + Use this method to approve a chat join request. The bot must be an administrator in the chat for this to work and must have the *can_invite_users* administrator right. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#approvechatjoinrequest + """ + + __returning__ = bool + __api_method__ = "approveChatJoinRequest" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + user_id: int + """Unique identifier of the target user""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], user_id: int, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, user_id=user_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/ban_chat_member.py b/env/Lib/site-packages/aiogram/methods/ban_chat_member.py new file mode 100644 index 0000000..947fcca --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/ban_chat_member.py @@ -0,0 +1,51 @@ +from __future__ import annotations + +import datetime +from typing import TYPE_CHECKING, Any, Optional, Union + +from .base import TelegramMethod + + +class BanChatMember(TelegramMethod[bool]): + """ + Use this method to ban a user in a group, a supergroup or a channel. In the case of supergroups and channels, the user will not be able to return to the chat on their own using invite links, etc., unless `unbanned `_ first. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#banchatmember + """ + + __returning__ = bool + __api_method__ = "banChatMember" + + chat_id: Union[int, str] + """Unique identifier for the target group or username of the target supergroup or channel (in the format :code:`@channelusername`)""" + user_id: int + """Unique identifier of the target user""" + until_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None + """Date when the user will be unbanned; Unix time. If user is banned for more than 366 days or less than 30 seconds from the current time they are considered to be banned forever. Applied for supergroups and channels only.""" + revoke_messages: Optional[bool] = None + """Pass :code:`True` to delete all messages from the chat for the user that is being removed. If :code:`False`, the user will be able to see messages in the group that were sent before the user was removed. Always :code:`True` for supergroups and channels.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + user_id: int, + until_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + revoke_messages: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + user_id=user_id, + until_date=until_date, + revoke_messages=revoke_messages, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/ban_chat_sender_chat.py b/env/Lib/site-packages/aiogram/methods/ban_chat_sender_chat.py new file mode 100644 index 0000000..cbe6194 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/ban_chat_sender_chat.py @@ -0,0 +1,38 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class BanChatSenderChat(TelegramMethod[bool]): + """ + Use this method to ban a channel chat in a supergroup or a channel. Until the chat is `unbanned `_, the owner of the banned chat won't be able to send messages on behalf of **any of their channels**. The bot must be an administrator in the supergroup or channel for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#banchatsenderchat + """ + + __returning__ = bool + __api_method__ = "banChatSenderChat" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + sender_chat_id: int + """Unique identifier of the target sender chat""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + sender_chat_id: int, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, sender_chat_id=sender_chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/base.py b/env/Lib/site-packages/aiogram/methods/base.py new file mode 100644 index 0000000..b2d35be --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/base.py @@ -0,0 +1,95 @@ +from __future__ import annotations + +from abc import ABC, abstractmethod +from typing import ( + TYPE_CHECKING, + Any, + ClassVar, + Dict, + Generator, + Generic, + Optional, + TypeVar, +) + +from pydantic import BaseModel, ConfigDict +from pydantic.functional_validators import model_validator + +from aiogram.client.context_controller import BotContextController + +from ..types import InputFile, ResponseParameters +from ..types.base import UNSET_TYPE + +if TYPE_CHECKING: + from ..client.bot import Bot + +TelegramType = TypeVar("TelegramType", bound=Any) + + +class Request(BaseModel): + model_config = ConfigDict(arbitrary_types_allowed=True) + + method: str + + data: Dict[str, Optional[Any]] + files: Optional[Dict[str, InputFile]] + + +class Response(BaseModel, Generic[TelegramType]): + ok: bool + result: Optional[TelegramType] = None + description: Optional[str] = None + error_code: Optional[int] = None + parameters: Optional[ResponseParameters] = None + + +class TelegramMethod(BotContextController, BaseModel, Generic[TelegramType], ABC): + model_config = ConfigDict( + extra="allow", + populate_by_name=True, + arbitrary_types_allowed=True, + ) + + @model_validator(mode="before") + @classmethod + def remove_unset(cls, values: Dict[str, Any]) -> Dict[str, Any]: + """ + Remove UNSET before fields validation. + + We use UNSET as a sentinel value for `parse_mode` and replace it to real value later. + It isn't a problem when it's just default value for a model field, + but UNSET might be passing to a model initialization from `Bot.method_name`, + so we must take care of it and remove it before fields validation. + """ + if not isinstance(values, dict): + return values + return {k: v for k, v in values.items() if not isinstance(v, UNSET_TYPE)} + + if TYPE_CHECKING: + __returning__: ClassVar[type] + __api_method__: ClassVar[str] + else: + + @property + @abstractmethod + def __returning__(self) -> type: + pass + + @property + @abstractmethod + def __api_method__(self) -> str: + pass + + async def emit(self, bot: Bot) -> TelegramType: + return await bot(self) + + def __await__(self) -> Generator[Any, None, TelegramType]: + bot = self._bot + if not bot: + raise RuntimeError( + "This method is not mounted to a any bot instance, please call it explicilty " + "with bot instance `await bot(method)`\n" + "or mount method to a bot instance `method.as_(bot)` " + "and then call it `await method()`" + ) + return self.emit(bot).__await__() diff --git a/env/Lib/site-packages/aiogram/methods/close.py b/env/Lib/site-packages/aiogram/methods/close.py new file mode 100644 index 0000000..7c33eca --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/close.py @@ -0,0 +1,14 @@ +from __future__ import annotations + +from .base import TelegramMethod + + +class Close(TelegramMethod[bool]): + """ + Use this method to close the bot instance before moving it from one local server to another. You need to delete the webhook before calling this method to ensure that the bot isn't launched again after server restart. The method will return error 429 in the first 10 minutes after the bot is launched. Returns :code:`True` on success. Requires no parameters. + + Source: https://core.telegram.org/bots/api#close + """ + + __returning__ = bool + __api_method__ = "close" diff --git a/env/Lib/site-packages/aiogram/methods/close_forum_topic.py b/env/Lib/site-packages/aiogram/methods/close_forum_topic.py new file mode 100644 index 0000000..110fbce --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/close_forum_topic.py @@ -0,0 +1,40 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class CloseForumTopic(TelegramMethod[bool]): + """ + Use this method to close an open topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights, unless it is the creator of the topic. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#closeforumtopic + """ + + __returning__ = bool + __api_method__ = "closeForumTopic" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + message_thread_id: int + """Unique identifier for the target message thread of the forum topic""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + message_thread_id: int, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, message_thread_id=message_thread_id, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/methods/close_general_forum_topic.py b/env/Lib/site-packages/aiogram/methods/close_general_forum_topic.py new file mode 100644 index 0000000..3f1a633 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/close_general_forum_topic.py @@ -0,0 +1,32 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class CloseGeneralForumTopic(TelegramMethod[bool]): + """ + Use this method to close an open 'General' topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#closegeneralforumtopic + """ + + __returning__ = bool + __api_method__ = "closeGeneralForumTopic" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/copy_message.py b/env/Lib/site-packages/aiogram/methods/copy_message.py new file mode 100644 index 0000000..ca44f93 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/copy_message.py @@ -0,0 +1,116 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + MessageEntity, + MessageId, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class CopyMessage(TelegramMethod[MessageId]): + """ + Use this method to copy messages of any kind. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz :class:`aiogram.methods.poll.Poll` can be copied only if the value of the field *correct_option_id* is known to the bot. The method is analogous to the method :class:`aiogram.methods.forward_message.ForwardMessage`, but the copied message doesn't have a link to the original message. Returns the :class:`aiogram.types.message_id.MessageId` of the sent message on success. + + Source: https://core.telegram.org/bots/api#copymessage + """ + + __returning__ = MessageId + __api_method__ = "copyMessage" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + from_chat_id: Union[int, str] + """Unique identifier for the chat where the original message was sent (or channel username in the format :code:`@channelusername`)""" + message_id: int + """Message identifier in the chat specified in *from_chat_id*""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + caption: Optional[str] = None + """New caption for media, 0-1024 characters after entities parsing. If not specified, the original caption is kept""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """Mode for parsing entities in the new caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """A JSON-serialized list of special entities that appear in the new caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[Union[bool, Default]] = Default("show_caption_above_media") + """Pass :code:`True`, if the caption must be shown above the message media. Ignored if a new caption isn't specified.""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding and saving""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None + """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + from_chat_id: Union[int, str], + message_id: int, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + from_chat_id=from_chat_id, + message_id=message_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + disable_notification=disable_notification, + protect_content=protect_content, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/copy_messages.py b/env/Lib/site-packages/aiogram/methods/copy_messages.py new file mode 100644 index 0000000..c734d0a --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/copy_messages.py @@ -0,0 +1,61 @@ +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from ..types import MessageId +from .base import TelegramMethod + + +class CopyMessages(TelegramMethod[List[MessageId]]): + """ + Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz :class:`aiogram.methods.poll.Poll` can be copied only if the value of the field *correct_option_id* is known to the bot. The method is analogous to the method :class:`aiogram.methods.forward_messages.ForwardMessages`, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of :class:`aiogram.types.message_id.MessageId` of the sent messages is returned. + + Source: https://core.telegram.org/bots/api#copymessages + """ + + __returning__ = List[MessageId] + __api_method__ = "copyMessages" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + from_chat_id: Union[int, str] + """Unique identifier for the chat where the original messages were sent (or channel username in the format :code:`@channelusername`)""" + message_ids: List[int] + """A JSON-serialized list of 1-100 identifiers of messages in the chat *from_chat_id* to copy. The identifiers must be specified in a strictly increasing order.""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + disable_notification: Optional[bool] = None + """Sends the messages `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[bool] = None + """Protects the contents of the sent messages from forwarding and saving""" + remove_caption: Optional[bool] = None + """Pass :code:`True` to copy the messages without their captions""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + from_chat_id: Union[int, str], + message_ids: List[int], + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + remove_caption: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + from_chat_id=from_chat_id, + message_ids=message_ids, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + remove_caption=remove_caption, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/create_chat_invite_link.py b/env/Lib/site-packages/aiogram/methods/create_chat_invite_link.py new file mode 100644 index 0000000..ff0b386 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/create_chat_invite_link.py @@ -0,0 +1,56 @@ +from __future__ import annotations + +import datetime +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import ChatInviteLink +from .base import TelegramMethod + + +class CreateChatInviteLink(TelegramMethod[ChatInviteLink]): + """ + Use this method to create an additional invite link for a chat. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. The link can be revoked using the method :class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink`. Returns the new invite link as :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + + Source: https://core.telegram.org/bots/api#createchatinvitelink + """ + + __returning__ = ChatInviteLink + __api_method__ = "createChatInviteLink" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + name: Optional[str] = None + """Invite link name; 0-32 characters""" + expire_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None + """Point in time (Unix timestamp) when the link will expire""" + member_limit: Optional[int] = None + """The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999""" + creates_join_request: Optional[bool] = None + """:code:`True`, if users joining the chat via the link need to be approved by chat administrators. If :code:`True`, *member_limit* can't be specified""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + name: Optional[str] = None, + expire_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + member_limit: Optional[int] = None, + creates_join_request: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + name=name, + expire_date=expire_date, + member_limit=member_limit, + creates_join_request=creates_join_request, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/create_chat_subscription_invite_link.py b/env/Lib/site-packages/aiogram/methods/create_chat_subscription_invite_link.py new file mode 100644 index 0000000..1301eb2 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/create_chat_subscription_invite_link.py @@ -0,0 +1,52 @@ +from __future__ import annotations + +import datetime +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import ChatInviteLink +from .base import TelegramMethod + + +class CreateChatSubscriptionInviteLink(TelegramMethod[ChatInviteLink]): + """ + Use this method to create a `subscription invite link `_ for a channel chat. The bot must have the *can_invite_users* administrator rights. The link can be edited using the method :class:`aiogram.methods.edit_chat_subscription_invite_link.EditChatSubscriptionInviteLink` or revoked using the method :class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink`. Returns the new invite link as a :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + + Source: https://core.telegram.org/bots/api#createchatsubscriptioninvitelink + """ + + __returning__ = ChatInviteLink + __api_method__ = "createChatSubscriptionInviteLink" + + chat_id: Union[int, str] + """Unique identifier for the target channel chat or username of the target channel (in the format :code:`@channelusername`)""" + subscription_period: Union[datetime.datetime, datetime.timedelta, int] + """The number of seconds the subscription will be active for before the next payment. Currently, it must always be 2592000 (30 days).""" + subscription_price: int + """The amount of Telegram Stars a user must pay initially and after each subsequent subscription period to be a member of the chat; 1-2500""" + name: Optional[str] = None + """Invite link name; 0-32 characters""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + subscription_period: Union[datetime.datetime, datetime.timedelta, int], + subscription_price: int, + name: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + subscription_period=subscription_period, + subscription_price=subscription_price, + name=name, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/create_forum_topic.py b/env/Lib/site-packages/aiogram/methods/create_forum_topic.py new file mode 100644 index 0000000..8b0f692 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/create_forum_topic.py @@ -0,0 +1,51 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import ForumTopic +from .base import TelegramMethod + + +class CreateForumTopic(TelegramMethod[ForumTopic]): + """ + Use this method to create a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights. Returns information about the created topic as a :class:`aiogram.types.forum_topic.ForumTopic` object. + + Source: https://core.telegram.org/bots/api#createforumtopic + """ + + __returning__ = ForumTopic + __api_method__ = "createForumTopic" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + name: str + """Topic name, 1-128 characters""" + icon_color: Optional[int] = None + """Color of the topic icon in RGB format. Currently, must be one of 7322096 (0x6FB9F0), 16766590 (0xFFD67E), 13338331 (0xCB86DB), 9367192 (0x8EEE98), 16749490 (0xFF93B2), or 16478047 (0xFB6F5F)""" + icon_custom_emoji_id: Optional[str] = None + """Unique identifier of the custom emoji shown as the topic icon. Use :class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers` to get all allowed custom emoji identifiers.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + name: str, + icon_color: Optional[int] = None, + icon_custom_emoji_id: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + name=name, + icon_color=icon_color, + icon_custom_emoji_id=icon_custom_emoji_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/create_invoice_link.py b/env/Lib/site-packages/aiogram/methods/create_invoice_link.py new file mode 100644 index 0000000..2068f75 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/create_invoice_link.py @@ -0,0 +1,115 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from ..types import LabeledPrice +from .base import TelegramMethod + + +class CreateInvoiceLink(TelegramMethod[str]): + """ + Use this method to create a link for an invoice. Returns the created invoice link as *String* on success. + + Source: https://core.telegram.org/bots/api#createinvoicelink + """ + + __returning__ = str + __api_method__ = "createInvoiceLink" + + title: str + """Product name, 1-32 characters""" + description: str + """Product description, 1-255 characters""" + payload: str + """Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use for your internal processes.""" + currency: str + """Three-letter ISO 4217 currency code, see `more on currencies `_. Pass 'XTR' for payments in `Telegram Stars `_.""" + prices: List[LabeledPrice] + """Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.). Must contain exactly one item for payments in `Telegram Stars `_.""" + provider_token: Optional[str] = None + """Payment provider token, obtained via `@BotFather `_. Pass an empty string for payments in `Telegram Stars `_.""" + max_tip_amount: Optional[int] = None + """The maximum accepted amount for tips in the *smallest units* of the currency (integer, **not** float/double). For example, for a maximum tip of :code:`US$ 1.45` pass :code:`max_tip_amount = 145`. See the *exp* parameter in `currencies.json `_, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0. Not supported for payments in `Telegram Stars `_.""" + suggested_tip_amounts: Optional[List[int]] = None + """A JSON-serialized array of suggested amounts of tips in the *smallest units* of the currency (integer, **not** float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed *max_tip_amount*.""" + provider_data: Optional[str] = None + """JSON-serialized data about the invoice, which will be shared with the payment provider. A detailed description of required fields should be provided by the payment provider.""" + photo_url: Optional[str] = None + """URL of the product photo for the invoice. Can be a photo of the goods or a marketing image for a service.""" + photo_size: Optional[int] = None + """Photo size in bytes""" + photo_width: Optional[int] = None + """Photo width""" + photo_height: Optional[int] = None + """Photo height""" + need_name: Optional[bool] = None + """Pass :code:`True` if you require the user's full name to complete the order. Ignored for payments in `Telegram Stars `_.""" + need_phone_number: Optional[bool] = None + """Pass :code:`True` if you require the user's phone number to complete the order. Ignored for payments in `Telegram Stars `_.""" + need_email: Optional[bool] = None + """Pass :code:`True` if you require the user's email address to complete the order. Ignored for payments in `Telegram Stars `_.""" + need_shipping_address: Optional[bool] = None + """Pass :code:`True` if you require the user's shipping address to complete the order. Ignored for payments in `Telegram Stars `_.""" + send_phone_number_to_provider: Optional[bool] = None + """Pass :code:`True` if the user's phone number should be sent to the provider. Ignored for payments in `Telegram Stars `_.""" + send_email_to_provider: Optional[bool] = None + """Pass :code:`True` if the user's email address should be sent to the provider. Ignored for payments in `Telegram Stars `_.""" + is_flexible: Optional[bool] = None + """Pass :code:`True` if the final price depends on the shipping method. Ignored for payments in `Telegram Stars `_.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + title: str, + description: str, + payload: str, + currency: str, + prices: List[LabeledPrice], + provider_token: Optional[str] = None, + max_tip_amount: Optional[int] = None, + suggested_tip_amounts: Optional[List[int]] = None, + provider_data: Optional[str] = None, + photo_url: Optional[str] = None, + photo_size: Optional[int] = None, + photo_width: Optional[int] = None, + photo_height: Optional[int] = None, + need_name: Optional[bool] = None, + need_phone_number: Optional[bool] = None, + need_email: Optional[bool] = None, + need_shipping_address: Optional[bool] = None, + send_phone_number_to_provider: Optional[bool] = None, + send_email_to_provider: Optional[bool] = None, + is_flexible: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + title=title, + description=description, + payload=payload, + currency=currency, + prices=prices, + provider_token=provider_token, + max_tip_amount=max_tip_amount, + suggested_tip_amounts=suggested_tip_amounts, + provider_data=provider_data, + photo_url=photo_url, + photo_size=photo_size, + photo_width=photo_width, + photo_height=photo_height, + need_name=need_name, + need_phone_number=need_phone_number, + need_email=need_email, + need_shipping_address=need_shipping_address, + send_phone_number_to_provider=send_phone_number_to_provider, + send_email_to_provider=send_email_to_provider, + is_flexible=is_flexible, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/create_new_sticker_set.py b/env/Lib/site-packages/aiogram/methods/create_new_sticker_set.py new file mode 100644 index 0000000..c304d85 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/create_new_sticker_set.py @@ -0,0 +1,68 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from pydantic import Field + +from ..types import InputSticker +from .base import TelegramMethod + + +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. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#createnewstickerset + """ + + __returning__ = bool + __api_method__ = "createNewStickerSet" + + 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 :code:`"_by_"`. :code:`` is case insensitive. 1-64 characters.""" + title: str + """Sticker set title, 1-64 characters""" + stickers: List[InputSticker] + """A JSON-serialized list of 1-50 initial stickers to be added to the sticker set""" + sticker_type: Optional[str] = None + """Type of stickers in the set, pass 'regular', 'mask', or 'custom_emoji'. By default, a regular sticker set is created.""" + needs_repainting: Optional[bool] = None + """Pass :code:`True` if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only""" + sticker_format: Optional[str] = Field(None, json_schema_extra={"deprecated": True}) + """Format of stickers in the set, must be one of 'static', 'animated', 'video' + +.. deprecated:: API:7.2 + https://core.telegram.org/bots/api-changelog#march-31-2024""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + user_id: int, + name: str, + title: str, + stickers: List[InputSticker], + sticker_type: Optional[str] = None, + needs_repainting: Optional[bool] = None, + sticker_format: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + user_id=user_id, + name=name, + title=title, + stickers=stickers, + sticker_type=sticker_type, + needs_repainting=needs_repainting, + sticker_format=sticker_format, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/decline_chat_join_request.py b/env/Lib/site-packages/aiogram/methods/decline_chat_join_request.py new file mode 100644 index 0000000..b0fa2c3 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/decline_chat_join_request.py @@ -0,0 +1,34 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class DeclineChatJoinRequest(TelegramMethod[bool]): + """ + Use this method to decline a chat join request. The bot must be an administrator in the chat for this to work and must have the *can_invite_users* administrator right. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#declinechatjoinrequest + """ + + __returning__ = bool + __api_method__ = "declineChatJoinRequest" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + user_id: int + """Unique identifier of the target user""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], user_id: int, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, user_id=user_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/delete_chat_photo.py b/env/Lib/site-packages/aiogram/methods/delete_chat_photo.py new file mode 100644 index 0000000..503ace2 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/delete_chat_photo.py @@ -0,0 +1,32 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class DeleteChatPhoto(TelegramMethod[bool]): + """ + Use this method to delete a chat photo. Photos can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletechatphoto + """ + + __returning__ = bool + __api_method__ = "deleteChatPhoto" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/delete_chat_sticker_set.py b/env/Lib/site-packages/aiogram/methods/delete_chat_sticker_set.py new file mode 100644 index 0000000..50d705f --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/delete_chat_sticker_set.py @@ -0,0 +1,32 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class DeleteChatStickerSet(TelegramMethod[bool]): + """ + Use this method to delete a group sticker set from a supergroup. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Use the field *can_set_sticker_set* optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests to check if the bot can use this method. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletechatstickerset + """ + + __returning__ = bool + __api_method__ = "deleteChatStickerSet" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/delete_forum_topic.py b/env/Lib/site-packages/aiogram/methods/delete_forum_topic.py new file mode 100644 index 0000000..7d23856 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/delete_forum_topic.py @@ -0,0 +1,40 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class DeleteForumTopic(TelegramMethod[bool]): + """ + Use this method to delete a forum topic along with all its messages in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_delete_messages* administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deleteforumtopic + """ + + __returning__ = bool + __api_method__ = "deleteForumTopic" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + message_thread_id: int + """Unique identifier for the target message thread of the forum topic""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + message_thread_id: int, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, message_thread_id=message_thread_id, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/methods/delete_message.py b/env/Lib/site-packages/aiogram/methods/delete_message.py new file mode 100644 index 0000000..59aee04 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/delete_message.py @@ -0,0 +1,56 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class DeleteMessage(TelegramMethod[bool]): + """ + Use this method to delete a message, including service messages, with the following limitations: + + - A message can only be deleted if it was sent less than 48 hours ago. + + - Service messages about a supergroup, channel, or forum topic creation can't be deleted. + + - A dice message in a private chat can only be deleted if it was sent more than 24 hours ago. + + - Bots can delete outgoing messages in private chats, groups, and supergroups. + + - Bots can delete incoming messages in private chats. + + - Bots granted *can_post_messages* permissions can delete outgoing messages in channels. + + - If the bot is an administrator of a group, it can delete any message there. + + - If the bot has *can_delete_messages* permission in a supergroup or a channel, it can delete any message there. + + Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletemessage + """ + + __returning__ = bool + __api_method__ = "deleteMessage" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + message_id: int + """Identifier of the message to delete""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + message_id: int, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, message_id=message_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/delete_messages.py b/env/Lib/site-packages/aiogram/methods/delete_messages.py new file mode 100644 index 0000000..061d12b --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/delete_messages.py @@ -0,0 +1,36 @@ +from typing import TYPE_CHECKING, Any, List, Union + +from .base import TelegramMethod + + +class DeleteMessages(TelegramMethod[bool]): + """ + Use this method to delete multiple messages simultaneously. If some of the specified messages can't be found, they are skipped. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletemessages + """ + + __returning__ = bool + __api_method__ = "deleteMessages" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + message_ids: List[int] + """A JSON-serialized list of 1-100 identifiers of messages to delete. See :class:`aiogram.methods.delete_message.DeleteMessage` for limitations on which messages can be deleted""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + message_ids: List[int], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, message_ids=message_ids, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/delete_my_commands.py b/env/Lib/site-packages/aiogram/methods/delete_my_commands.py new file mode 100644 index 0000000..e35ef67 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/delete_my_commands.py @@ -0,0 +1,67 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import ( + BotCommandScopeAllChatAdministrators, + BotCommandScopeAllGroupChats, + BotCommandScopeAllPrivateChats, + BotCommandScopeChat, + BotCommandScopeChatAdministrators, + BotCommandScopeChatMember, + BotCommandScopeDefault, +) +from .base import TelegramMethod + + +class DeleteMyCommands(TelegramMethod[bool]): + """ + Use this method to delete the list of the bot's commands for the given scope and user language. After deletion, `higher level commands `_ will be shown to affected users. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletemycommands + """ + + __returning__ = bool + __api_method__ = "deleteMyCommands" + + scope: Optional[ + Union[ + BotCommandScopeDefault, + BotCommandScopeAllPrivateChats, + BotCommandScopeAllGroupChats, + BotCommandScopeAllChatAdministrators, + BotCommandScopeChat, + BotCommandScopeChatAdministrators, + BotCommandScopeChatMember, + ] + ] = None + """A JSON-serialized object, describing scope of users for which the commands are relevant. Defaults to :class:`aiogram.types.bot_command_scope_default.BotCommandScopeDefault`.""" + language_code: Optional[str] = None + """A two-letter ISO 639-1 language code. If empty, commands will be applied to all users from the given scope, for whose language there are no dedicated commands""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + scope: Optional[ + Union[ + BotCommandScopeDefault, + BotCommandScopeAllPrivateChats, + BotCommandScopeAllGroupChats, + BotCommandScopeAllChatAdministrators, + BotCommandScopeChat, + BotCommandScopeChatAdministrators, + BotCommandScopeChatMember, + ] + ] = None, + language_code: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(scope=scope, language_code=language_code, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/delete_sticker_from_set.py b/env/Lib/site-packages/aiogram/methods/delete_sticker_from_set.py new file mode 100644 index 0000000..6aae72b --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/delete_sticker_from_set.py @@ -0,0 +1,30 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramMethod + + +class DeleteStickerFromSet(TelegramMethod[bool]): + """ + Use this method to delete a sticker from a set created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletestickerfromset + """ + + __returning__ = bool + __api_method__ = "deleteStickerFromSet" + + sticker: str + """File identifier of the sticker""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__(__pydantic__self__, *, sticker: str, **__pydantic_kwargs: Any) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(sticker=sticker, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/delete_sticker_set.py b/env/Lib/site-packages/aiogram/methods/delete_sticker_set.py new file mode 100644 index 0000000..519c5db --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/delete_sticker_set.py @@ -0,0 +1,30 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramMethod + + +class DeleteStickerSet(TelegramMethod[bool]): + """ + Use this method to delete a sticker set that was created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletestickerset + """ + + __returning__ = bool + __api_method__ = "deleteStickerSet" + + name: str + """Sticker set name""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__(__pydantic__self__, *, name: str, **__pydantic_kwargs: Any) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(name=name, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/delete_webhook.py b/env/Lib/site-packages/aiogram/methods/delete_webhook.py new file mode 100644 index 0000000..05c39f4 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/delete_webhook.py @@ -0,0 +1,35 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramMethod + + +class DeleteWebhook(TelegramMethod[bool]): + """ + Use this method to remove webhook integration if you decide to switch back to :class:`aiogram.methods.get_updates.GetUpdates`. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletewebhook + """ + + __returning__ = bool + __api_method__ = "deleteWebhook" + + drop_pending_updates: Optional[bool] = None + """Pass :code:`True` to drop all pending updates""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + drop_pending_updates: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(drop_pending_updates=drop_pending_updates, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/edit_chat_invite_link.py b/env/Lib/site-packages/aiogram/methods/edit_chat_invite_link.py new file mode 100644 index 0000000..8ec86ca --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/edit_chat_invite_link.py @@ -0,0 +1,60 @@ +from __future__ import annotations + +import datetime +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import ChatInviteLink +from .base import TelegramMethod + + +class EditChatInviteLink(TelegramMethod[ChatInviteLink]): + """ + Use this method to edit a non-primary invite link created by the bot. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the edited invite link as a :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + + Source: https://core.telegram.org/bots/api#editchatinvitelink + """ + + __returning__ = ChatInviteLink + __api_method__ = "editChatInviteLink" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + invite_link: str + """The invite link to edit""" + name: Optional[str] = None + """Invite link name; 0-32 characters""" + expire_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None + """Point in time (Unix timestamp) when the link will expire""" + member_limit: Optional[int] = None + """The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999""" + creates_join_request: Optional[bool] = None + """:code:`True`, if users joining the chat via the link need to be approved by chat administrators. If :code:`True`, *member_limit* can't be specified""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + invite_link: str, + name: Optional[str] = None, + expire_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + member_limit: Optional[int] = None, + creates_join_request: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + invite_link=invite_link, + name=name, + expire_date=expire_date, + member_limit=member_limit, + creates_join_request=creates_join_request, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/edit_chat_subscription_invite_link.py b/env/Lib/site-packages/aiogram/methods/edit_chat_subscription_invite_link.py new file mode 100644 index 0000000..ffb37d8 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/edit_chat_subscription_invite_link.py @@ -0,0 +1,44 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import ChatInviteLink +from .base import TelegramMethod + + +class EditChatSubscriptionInviteLink(TelegramMethod[ChatInviteLink]): + """ + Use this method to edit a subscription invite link created by the bot. The bot must have the *can_invite_users* administrator rights. Returns the edited invite link as a :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + + Source: https://core.telegram.org/bots/api#editchatsubscriptioninvitelink + """ + + __returning__ = ChatInviteLink + __api_method__ = "editChatSubscriptionInviteLink" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + invite_link: str + """The invite link to edit""" + name: Optional[str] = None + """Invite link name; 0-32 characters""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + invite_link: str, + name: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, invite_link=invite_link, name=name, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/methods/edit_forum_topic.py b/env/Lib/site-packages/aiogram/methods/edit_forum_topic.py new file mode 100644 index 0000000..233e9cb --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/edit_forum_topic.py @@ -0,0 +1,50 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from .base import TelegramMethod + + +class EditForumTopic(TelegramMethod[bool]): + """ + Use this method to edit name and icon of a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights, unless it is the creator of the topic. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#editforumtopic + """ + + __returning__ = bool + __api_method__ = "editForumTopic" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + message_thread_id: int + """Unique identifier for the target message thread of the forum topic""" + name: Optional[str] = None + """New topic name, 0-128 characters. If not specified or empty, the current name of the topic will be kept""" + icon_custom_emoji_id: Optional[str] = None + """New unique identifier of the custom emoji shown as the topic icon. Use :class:`aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers` to get all allowed custom emoji identifiers. Pass an empty string to remove the icon. If not specified, the current icon will be kept""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + message_thread_id: int, + name: Optional[str] = None, + icon_custom_emoji_id: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + message_thread_id=message_thread_id, + name=name, + icon_custom_emoji_id=icon_custom_emoji_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/edit_general_forum_topic.py b/env/Lib/site-packages/aiogram/methods/edit_general_forum_topic.py new file mode 100644 index 0000000..f0be56e --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/edit_general_forum_topic.py @@ -0,0 +1,34 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class EditGeneralForumTopic(TelegramMethod[bool]): + """ + Use this method to edit the name of the 'General' topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#editgeneralforumtopic + """ + + __returning__ = bool + __api_method__ = "editGeneralForumTopic" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + name: str + """New topic name, 1-128 characters""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], name: str, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, name=name, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/edit_message_caption.py b/env/Lib/site-packages/aiogram/methods/edit_message_caption.py new file mode 100644 index 0000000..8a759d4 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/edit_message_caption.py @@ -0,0 +1,74 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from ..client.default import Default +from ..types import UNSET_PARSE_MODE, InlineKeyboardMarkup, Message, MessageEntity +from .base import TelegramMethod + + +class EditMessageCaption(TelegramMethod[Union[Message, bool]]): + """ + Use this method to edit captions of messages. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + + Source: https://core.telegram.org/bots/api#editmessagecaption + """ + + __returning__ = Union[Message, bool] + __api_method__ = "editMessageCaption" + + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message to be edited was sent""" + chat_id: Optional[Union[int, str]] = None + """Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + message_id: Optional[int] = None + """Required if *inline_message_id* is not specified. Identifier of the message to edit""" + inline_message_id: Optional[str] = None + """Required if *chat_id* and *message_id* are not specified. Identifier of the inline message""" + caption: Optional[str] = None + """New caption of the message, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """Mode for parsing entities in the message caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[Union[bool, Default]] = Default("show_caption_above_media") + """Pass :code:`True`, if the caption must be shown above the message media. Supported only for animation, photo and video messages.""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """A JSON-serialized object for an `inline keyboard `_.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + business_connection_id: Optional[str] = None, + chat_id: Optional[Union[int, str]] = None, + message_id: Optional[int] = None, + inline_message_id: Optional[str] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + reply_markup: Optional[InlineKeyboardMarkup] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + business_connection_id=business_connection_id, + chat_id=chat_id, + message_id=message_id, + inline_message_id=inline_message_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + reply_markup=reply_markup, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/edit_message_live_location.py b/env/Lib/site-packages/aiogram/methods/edit_message_live_location.py new file mode 100644 index 0000000..6bc5569 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/edit_message_live_location.py @@ -0,0 +1,79 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import InlineKeyboardMarkup, Message +from .base import TelegramMethod + + +class EditMessageLiveLocation(TelegramMethod[Union[Message, bool]]): + """ + Use this method to edit live location messages. A location can be edited until its *live_period* expires or editing is explicitly disabled by a call to :class:`aiogram.methods.stop_message_live_location.StopMessageLiveLocation`. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. + + Source: https://core.telegram.org/bots/api#editmessagelivelocation + """ + + __returning__ = Union[Message, bool] + __api_method__ = "editMessageLiveLocation" + + latitude: float + """Latitude of new location""" + longitude: float + """Longitude of new location""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message to be edited was sent""" + chat_id: Optional[Union[int, str]] = None + """Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + message_id: Optional[int] = None + """Required if *inline_message_id* is not specified. Identifier of the message to edit""" + inline_message_id: Optional[str] = None + """Required if *chat_id* and *message_id* are not specified. Identifier of the inline message""" + live_period: Optional[int] = None + """New period in seconds during which the location can be updated, starting from the message send date. If 0x7FFFFFFF is specified, then the location can be updated forever. Otherwise, the new value must not exceed the current *live_period* by more than a day, and the live location expiration date must remain within the next 90 days. If not specified, then *live_period* remains unchanged""" + horizontal_accuracy: Optional[float] = None + """The radius of uncertainty for the location, measured in meters; 0-1500""" + heading: Optional[int] = None + """Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.""" + proximity_alert_radius: Optional[int] = None + """The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """A JSON-serialized object for a new `inline keyboard `_.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + latitude: float, + longitude: float, + business_connection_id: Optional[str] = None, + chat_id: Optional[Union[int, str]] = None, + message_id: Optional[int] = None, + inline_message_id: Optional[str] = None, + live_period: Optional[int] = None, + horizontal_accuracy: Optional[float] = None, + heading: Optional[int] = None, + proximity_alert_radius: Optional[int] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + latitude=latitude, + longitude=longitude, + business_connection_id=business_connection_id, + chat_id=chat_id, + message_id=message_id, + inline_message_id=inline_message_id, + live_period=live_period, + horizontal_accuracy=horizontal_accuracy, + heading=heading, + proximity_alert_radius=proximity_alert_radius, + reply_markup=reply_markup, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/edit_message_media.py b/env/Lib/site-packages/aiogram/methods/edit_message_media.py new file mode 100644 index 0000000..b898be7 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/edit_message_media.py @@ -0,0 +1,75 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import ( + InlineKeyboardMarkup, + InputMediaAnimation, + InputMediaAudio, + InputMediaDocument, + InputMediaPhoto, + InputMediaVideo, + Message, +) +from .base import TelegramMethod + + +class EditMessageMedia(TelegramMethod[Union[Message, bool]]): + """ + Use this method to edit animation, audio, document, photo, or video messages. If a message is part of a message album, then it can be edited only to an audio for audio albums, only to a document for document albums and to a photo or a video otherwise. When an inline message is edited, a new file can't be uploaded; use a previously uploaded file via its file_id or specify a URL. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + + Source: https://core.telegram.org/bots/api#editmessagemedia + """ + + __returning__ = Union[Message, bool] + __api_method__ = "editMessageMedia" + + media: Union[ + InputMediaAnimation, InputMediaDocument, InputMediaAudio, InputMediaPhoto, InputMediaVideo + ] + """A JSON-serialized object for a new media content of the message""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message to be edited was sent""" + chat_id: Optional[Union[int, str]] = None + """Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + message_id: Optional[int] = None + """Required if *inline_message_id* is not specified. Identifier of the message to edit""" + inline_message_id: Optional[str] = None + """Required if *chat_id* and *message_id* are not specified. Identifier of the inline message""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """A JSON-serialized object for a new `inline keyboard `_.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + media: Union[ + InputMediaAnimation, + InputMediaDocument, + InputMediaAudio, + InputMediaPhoto, + InputMediaVideo, + ], + business_connection_id: Optional[str] = None, + chat_id: Optional[Union[int, str]] = None, + message_id: Optional[int] = None, + inline_message_id: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + media=media, + business_connection_id=business_connection_id, + chat_id=chat_id, + message_id=message_id, + inline_message_id=inline_message_id, + reply_markup=reply_markup, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/edit_message_reply_markup.py b/env/Lib/site-packages/aiogram/methods/edit_message_reply_markup.py new file mode 100644 index 0000000..49052f3 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/edit_message_reply_markup.py @@ -0,0 +1,55 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import InlineKeyboardMarkup, Message +from .base import TelegramMethod + + +class EditMessageReplyMarkup(TelegramMethod[Union[Message, bool]]): + """ + Use this method to edit only the reply markup of messages. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + + Source: https://core.telegram.org/bots/api#editmessagereplymarkup + """ + + __returning__ = Union[Message, bool] + __api_method__ = "editMessageReplyMarkup" + + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message to be edited was sent""" + chat_id: Optional[Union[int, str]] = None + """Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + message_id: Optional[int] = None + """Required if *inline_message_id* is not specified. Identifier of the message to edit""" + inline_message_id: Optional[str] = None + """Required if *chat_id* and *message_id* are not specified. Identifier of the inline message""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """A JSON-serialized object for an `inline keyboard `_.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + business_connection_id: Optional[str] = None, + chat_id: Optional[Union[int, str]] = None, + message_id: Optional[int] = None, + inline_message_id: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + business_connection_id=business_connection_id, + chat_id=chat_id, + message_id=message_id, + inline_message_id=inline_message_id, + reply_markup=reply_markup, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/edit_message_text.py b/env/Lib/site-packages/aiogram/methods/edit_message_text.py new file mode 100644 index 0000000..cfaaa94 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/edit_message_text.py @@ -0,0 +1,91 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + UNSET_PARSE_MODE, + InlineKeyboardMarkup, + LinkPreviewOptions, + Message, + MessageEntity, +) +from .base import TelegramMethod + + +class EditMessageText(TelegramMethod[Union[Message, bool]]): + """ + Use this method to edit text and `game `_ messages. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + + Source: https://core.telegram.org/bots/api#editmessagetext + """ + + __returning__ = Union[Message, bool] + __api_method__ = "editMessageText" + + text: str + """New text of the message, 1-4096 characters after entities parsing""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message to be edited was sent""" + chat_id: Optional[Union[int, str]] = None + """Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + message_id: Optional[int] = None + """Required if *inline_message_id* is not specified. Identifier of the message to edit""" + inline_message_id: Optional[str] = None + """Required if *chat_id* and *message_id* are not specified. Identifier of the inline message""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """Mode for parsing entities in the message text. See `formatting options `_ for more details.""" + entities: Optional[List[MessageEntity]] = None + """A JSON-serialized list of special entities that appear in message text, which can be specified instead of *parse_mode*""" + link_preview_options: Optional[LinkPreviewOptions] = None + """Link preview generation options for the message""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """A JSON-serialized object for an `inline keyboard `_.""" + disable_web_page_preview: Optional[Union[bool, Default]] = Field( + Default("link_preview_is_disabled"), json_schema_extra={"deprecated": True} + ) + """Disables link previews for links in this message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + text: str, + business_connection_id: Optional[str] = None, + chat_id: Optional[Union[int, str]] = None, + message_id: Optional[int] = None, + inline_message_id: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + entities: Optional[List[MessageEntity]] = None, + link_preview_options: Optional[LinkPreviewOptions] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + disable_web_page_preview: Optional[Union[bool, Default]] = Default( + "link_preview_is_disabled" + ), + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + text=text, + business_connection_id=business_connection_id, + chat_id=chat_id, + message_id=message_id, + inline_message_id=inline_message_id, + parse_mode=parse_mode, + entities=entities, + link_preview_options=link_preview_options, + reply_markup=reply_markup, + disable_web_page_preview=disable_web_page_preview, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/export_chat_invite_link.py b/env/Lib/site-packages/aiogram/methods/export_chat_invite_link.py new file mode 100644 index 0000000..271e35d --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/export_chat_invite_link.py @@ -0,0 +1,34 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class ExportChatInviteLink(TelegramMethod[str]): + """ + Use this method to generate a new primary invite link for a chat; any previously generated primary link is revoked. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the new invite link as *String* on success. + + Note: Each administrator in a chat generates their own invite links. Bots can't use invite links generated by other administrators. If you want your bot to work with invite links, it will need to generate its own link using :class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` or by calling the :class:`aiogram.methods.get_chat.GetChat` method. If your bot needs to generate a new primary invite link replacing its previous one, use :class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` again. + + Source: https://core.telegram.org/bots/api#exportchatinvitelink + """ + + __returning__ = str + __api_method__ = "exportChatInviteLink" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/forward_message.py b/env/Lib/site-packages/aiogram/methods/forward_message.py new file mode 100644 index 0000000..01d764a --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/forward_message.py @@ -0,0 +1,61 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..client.default import Default +from ..types import Message +from ..types.base import UNSET_PROTECT_CONTENT +from .base import TelegramMethod + + +class ForwardMessage(TelegramMethod[Message]): + """ + Use this method to forward messages of any kind. Service messages and messages with protected content can't be forwarded. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#forwardmessage + """ + + __returning__ = Message + __api_method__ = "forwardMessage" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + from_chat_id: Union[int, str] + """Unique identifier for the chat where the original message was sent (or channel username in the format :code:`@channelusername`)""" + message_id: int + """Message identifier in the chat specified in *from_chat_id*""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the forwarded message from forwarding and saving""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + from_chat_id: Union[int, str], + message_id: int, + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + from_chat_id=from_chat_id, + message_id=message_id, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/forward_messages.py b/env/Lib/site-packages/aiogram/methods/forward_messages.py new file mode 100644 index 0000000..829545f --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/forward_messages.py @@ -0,0 +1,57 @@ +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from ..types import MessageId +from .base import TelegramMethod + + +class ForwardMessages(TelegramMethod[List[MessageId]]): + """ + Use this method to forward multiple messages of any kind. If some of the specified messages can't be found or forwarded, they are skipped. Service messages and messages with protected content can't be forwarded. Album grouping is kept for forwarded messages. On success, an array of :class:`aiogram.types.message_id.MessageId` of the sent messages is returned. + + Source: https://core.telegram.org/bots/api#forwardmessages + """ + + __returning__ = List[MessageId] + __api_method__ = "forwardMessages" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + from_chat_id: Union[int, str] + """Unique identifier for the chat where the original messages were sent (or channel username in the format :code:`@channelusername`)""" + message_ids: List[int] + """A JSON-serialized list of 1-100 identifiers of messages in the chat *from_chat_id* to forward. The identifiers must be specified in a strictly increasing order.""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + disable_notification: Optional[bool] = None + """Sends the messages `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[bool] = None + """Protects the contents of the forwarded messages from forwarding and saving""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + from_chat_id: Union[int, str], + message_ids: List[int], + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + from_chat_id=from_chat_id, + message_ids=message_ids, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/get_business_connection.py b/env/Lib/site-packages/aiogram/methods/get_business_connection.py new file mode 100644 index 0000000..97cb9ca --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_business_connection.py @@ -0,0 +1,34 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from aiogram.types import BusinessConnection + +from .base import TelegramMethod + + +class GetBusinessConnection(TelegramMethod[BusinessConnection]): + """ + Use this method to get information about the connection of the bot with a business account. Returns a :class:`aiogram.types.business_connection.BusinessConnection` object on success. + + Source: https://core.telegram.org/bots/api#getbusinessconnection + """ + + __returning__ = BusinessConnection + __api_method__ = "getBusinessConnection" + + business_connection_id: str + """Unique identifier of the business connection""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, business_connection_id: str, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(business_connection_id=business_connection_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_chat.py b/env/Lib/site-packages/aiogram/methods/get_chat.py new file mode 100644 index 0000000..6b6b977 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_chat.py @@ -0,0 +1,33 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from ..types import ChatFullInfo +from .base import TelegramMethod + + +class GetChat(TelegramMethod[ChatFullInfo]): + """ + Use this method to get up-to-date information about the chat. Returns a :class:`aiogram.types.chat_full_info.ChatFullInfo` object on success. + + Source: https://core.telegram.org/bots/api#getchat + """ + + __returning__ = ChatFullInfo + __api_method__ = "getChat" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup or channel (in the format :code:`@channelusername`)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_chat_administrators.py b/env/Lib/site-packages/aiogram/methods/get_chat_administrators.py new file mode 100644 index 0000000..99e403e --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_chat_administrators.py @@ -0,0 +1,62 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Union + +from ..types import ( + ChatMemberAdministrator, + ChatMemberBanned, + ChatMemberLeft, + ChatMemberMember, + ChatMemberOwner, + ChatMemberRestricted, +) +from .base import TelegramMethod + + +class GetChatAdministrators( + TelegramMethod[ + List[ + Union[ + ChatMemberOwner, + ChatMemberAdministrator, + ChatMemberMember, + ChatMemberRestricted, + ChatMemberLeft, + ChatMemberBanned, + ] + ] + ] +): + """ + Use this method to get a list of administrators in a chat, which aren't bots. Returns an Array of :class:`aiogram.types.chat_member.ChatMember` objects. + + Source: https://core.telegram.org/bots/api#getchatadministrators + """ + + __returning__ = List[ + Union[ + ChatMemberOwner, + ChatMemberAdministrator, + ChatMemberMember, + ChatMemberRestricted, + ChatMemberLeft, + ChatMemberBanned, + ] + ] + __api_method__ = "getChatAdministrators" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup or channel (in the format :code:`@channelusername`)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_chat_member.py b/env/Lib/site-packages/aiogram/methods/get_chat_member.py new file mode 100644 index 0000000..495f628 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_chat_member.py @@ -0,0 +1,60 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from ..types import ( + ChatMemberAdministrator, + ChatMemberBanned, + ChatMemberLeft, + ChatMemberMember, + ChatMemberOwner, + ChatMemberRestricted, +) +from .base import TelegramMethod + + +class GetChatMember( + TelegramMethod[ + Union[ + ChatMemberOwner, + ChatMemberAdministrator, + ChatMemberMember, + ChatMemberRestricted, + ChatMemberLeft, + ChatMemberBanned, + ] + ] +): + """ + Use this method to get information about a member of a chat. The method is only guaranteed to work for other users if the bot is an administrator in the chat. Returns a :class:`aiogram.types.chat_member.ChatMember` object on success. + + Source: https://core.telegram.org/bots/api#getchatmember + """ + + __returning__ = Union[ + ChatMemberOwner, + ChatMemberAdministrator, + ChatMemberMember, + ChatMemberRestricted, + ChatMemberLeft, + ChatMemberBanned, + ] + __api_method__ = "getChatMember" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup or channel (in the format :code:`@channelusername`)""" + user_id: int + """Unique identifier of the target user""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], user_id: int, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, user_id=user_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_chat_member_count.py b/env/Lib/site-packages/aiogram/methods/get_chat_member_count.py new file mode 100644 index 0000000..fc33c23 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_chat_member_count.py @@ -0,0 +1,32 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class GetChatMemberCount(TelegramMethod[int]): + """ + Use this method to get the number of members in a chat. Returns *Int* on success. + + Source: https://core.telegram.org/bots/api#getchatmembercount + """ + + __returning__ = int + __api_method__ = "getChatMemberCount" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup or channel (in the format :code:`@channelusername`)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_chat_menu_button.py b/env/Lib/site-packages/aiogram/methods/get_chat_menu_button.py new file mode 100644 index 0000000..ee1248d --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_chat_menu_button.py @@ -0,0 +1,35 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import MenuButtonCommands, MenuButtonDefault, MenuButtonWebApp +from .base import TelegramMethod + + +class GetChatMenuButton( + TelegramMethod[Union[MenuButtonDefault, MenuButtonWebApp, MenuButtonCommands]] +): + """ + Use this method to get the current value of the bot's menu button in a private chat, or the default menu button. Returns :class:`aiogram.types.menu_button.MenuButton` on success. + + Source: https://core.telegram.org/bots/api#getchatmenubutton + """ + + __returning__ = Union[MenuButtonDefault, MenuButtonWebApp, MenuButtonCommands] + __api_method__ = "getChatMenuButton" + + chat_id: Optional[int] = None + """Unique identifier for the target private chat. If not specified, default bot's menu button will be returned""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Optional[int] = None, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_custom_emoji_stickers.py b/env/Lib/site-packages/aiogram/methods/get_custom_emoji_stickers.py new file mode 100644 index 0000000..3235d97 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_custom_emoji_stickers.py @@ -0,0 +1,33 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List + +from ..types import Sticker +from .base import TelegramMethod + + +class GetCustomEmojiStickers(TelegramMethod[List[Sticker]]): + """ + Use this method to get information about custom emoji stickers by their identifiers. Returns an Array of :class:`aiogram.types.sticker.Sticker` objects. + + Source: https://core.telegram.org/bots/api#getcustomemojistickers + """ + + __returning__ = List[Sticker] + __api_method__ = "getCustomEmojiStickers" + + custom_emoji_ids: List[str] + """A JSON-serialized list of custom emoji identifiers. At most 200 custom emoji identifiers can be specified.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, custom_emoji_ids: List[str], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(custom_emoji_ids=custom_emoji_ids, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_file.py b/env/Lib/site-packages/aiogram/methods/get_file.py new file mode 100644 index 0000000..c96ff31 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_file.py @@ -0,0 +1,32 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from ..types import File +from .base import TelegramMethod + + +class GetFile(TelegramMethod[File]): + """ + Use this method to get basic information about a file and prepare it for downloading. For the moment, bots can download files of up to 20MB in size. On success, a :class:`aiogram.types.file.File` object is returned. The file can then be downloaded via the link :code:`https://api.telegram.org/file/bot/`, where :code:`` is taken from the response. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling :class:`aiogram.methods.get_file.GetFile` again. + **Note:** This function may not preserve the original file name and MIME type. You should save the file's MIME type and name (if available) when the File object is received. + + Source: https://core.telegram.org/bots/api#getfile + """ + + __returning__ = File + __api_method__ = "getFile" + + file_id: str + """File identifier to get information about""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__(__pydantic__self__, *, file_id: str, **__pydantic_kwargs: Any) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(file_id=file_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_forum_topic_icon_stickers.py b/env/Lib/site-packages/aiogram/methods/get_forum_topic_icon_stickers.py new file mode 100644 index 0000000..5c23321 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_forum_topic_icon_stickers.py @@ -0,0 +1,17 @@ +from __future__ import annotations + +from typing import List + +from ..types import Sticker +from .base import TelegramMethod + + +class GetForumTopicIconStickers(TelegramMethod[List[Sticker]]): + """ + Use this method to get custom emoji stickers, which can be used as a forum topic icon by any user. Requires no parameters. Returns an Array of :class:`aiogram.types.sticker.Sticker` objects. + + Source: https://core.telegram.org/bots/api#getforumtopiciconstickers + """ + + __returning__ = List[Sticker] + __api_method__ = "getForumTopicIconStickers" diff --git a/env/Lib/site-packages/aiogram/methods/get_game_high_scores.py b/env/Lib/site-packages/aiogram/methods/get_game_high_scores.py new file mode 100644 index 0000000..cac9d61 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_game_high_scores.py @@ -0,0 +1,53 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from ..types import GameHighScore +from .base import TelegramMethod + + +class GetGameHighScores(TelegramMethod[List[GameHighScore]]): + """ + Use this method to get data for high score tables. Will return the score of the specified user and several of their neighbors in a game. Returns an Array of :class:`aiogram.types.game_high_score.GameHighScore` objects. + + This method will currently return scores for the target user, plus two of their closest neighbors on each side. Will also return the top three users if the user and their neighbors are not among them. Please note that this behavior is subject to change. + + Source: https://core.telegram.org/bots/api#getgamehighscores + """ + + __returning__ = List[GameHighScore] + __api_method__ = "getGameHighScores" + + user_id: int + """Target user id""" + chat_id: Optional[int] = None + """Required if *inline_message_id* is not specified. Unique identifier for the target chat""" + message_id: Optional[int] = None + """Required if *inline_message_id* is not specified. Identifier of the sent message""" + inline_message_id: Optional[str] = None + """Required if *chat_id* and *message_id* are not specified. Identifier of the inline message""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + user_id: int, + chat_id: Optional[int] = None, + message_id: Optional[int] = None, + inline_message_id: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + user_id=user_id, + chat_id=chat_id, + message_id=message_id, + inline_message_id=inline_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/get_me.py b/env/Lib/site-packages/aiogram/methods/get_me.py new file mode 100644 index 0000000..c2cc52f --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_me.py @@ -0,0 +1,15 @@ +from __future__ import annotations + +from ..types import User +from .base import TelegramMethod + + +class GetMe(TelegramMethod[User]): + """ + A simple method for testing your bot's authentication token. Requires no parameters. Returns basic information about the bot in form of a :class:`aiogram.types.user.User` object. + + Source: https://core.telegram.org/bots/api#getme + """ + + __returning__ = User + __api_method__ = "getMe" diff --git a/env/Lib/site-packages/aiogram/methods/get_my_commands.py b/env/Lib/site-packages/aiogram/methods/get_my_commands.py new file mode 100644 index 0000000..b3386b6 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_my_commands.py @@ -0,0 +1,68 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from ..types import ( + BotCommand, + BotCommandScopeAllChatAdministrators, + BotCommandScopeAllGroupChats, + BotCommandScopeAllPrivateChats, + BotCommandScopeChat, + BotCommandScopeChatAdministrators, + BotCommandScopeChatMember, + BotCommandScopeDefault, +) +from .base import TelegramMethod + + +class GetMyCommands(TelegramMethod[List[BotCommand]]): + """ + Use this method to get the current list of the bot's commands for the given scope and user language. Returns an Array of :class:`aiogram.types.bot_command.BotCommand` objects. If commands aren't set, an empty list is returned. + + Source: https://core.telegram.org/bots/api#getmycommands + """ + + __returning__ = List[BotCommand] + __api_method__ = "getMyCommands" + + scope: Optional[ + Union[ + BotCommandScopeDefault, + BotCommandScopeAllPrivateChats, + BotCommandScopeAllGroupChats, + BotCommandScopeAllChatAdministrators, + BotCommandScopeChat, + BotCommandScopeChatAdministrators, + BotCommandScopeChatMember, + ] + ] = None + """A JSON-serialized object, describing scope of users. Defaults to :class:`aiogram.types.bot_command_scope_default.BotCommandScopeDefault`.""" + language_code: Optional[str] = None + """A two-letter ISO 639-1 language code or an empty string""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + scope: Optional[ + Union[ + BotCommandScopeDefault, + BotCommandScopeAllPrivateChats, + BotCommandScopeAllGroupChats, + BotCommandScopeAllChatAdministrators, + BotCommandScopeChat, + BotCommandScopeChatAdministrators, + BotCommandScopeChatMember, + ] + ] = None, + language_code: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(scope=scope, language_code=language_code, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_my_default_administrator_rights.py b/env/Lib/site-packages/aiogram/methods/get_my_default_administrator_rights.py new file mode 100644 index 0000000..4f9ad9a --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_my_default_administrator_rights.py @@ -0,0 +1,33 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from ..types import ChatAdministratorRights +from .base import TelegramMethod + + +class GetMyDefaultAdministratorRights(TelegramMethod[ChatAdministratorRights]): + """ + Use this method to get the current default administrator rights of the bot. Returns :class:`aiogram.types.chat_administrator_rights.ChatAdministratorRights` on success. + + Source: https://core.telegram.org/bots/api#getmydefaultadministratorrights + """ + + __returning__ = ChatAdministratorRights + __api_method__ = "getMyDefaultAdministratorRights" + + for_channels: Optional[bool] = None + """Pass :code:`True` to get default administrator rights of the bot in channels. Otherwise, default administrator rights of the bot for groups and supergroups will be returned.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, for_channels: Optional[bool] = None, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(for_channels=for_channels, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_my_description.py b/env/Lib/site-packages/aiogram/methods/get_my_description.py new file mode 100644 index 0000000..f967faf --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_my_description.py @@ -0,0 +1,33 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from ..types import BotDescription +from .base import TelegramMethod + + +class GetMyDescription(TelegramMethod[BotDescription]): + """ + Use this method to get the current bot description for the given user language. Returns :class:`aiogram.types.bot_description.BotDescription` on success. + + Source: https://core.telegram.org/bots/api#getmydescription + """ + + __returning__ = BotDescription + __api_method__ = "getMyDescription" + + language_code: Optional[str] = None + """A two-letter ISO 639-1 language code or an empty string""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, language_code: Optional[str] = None, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(language_code=language_code, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_my_name.py b/env/Lib/site-packages/aiogram/methods/get_my_name.py new file mode 100644 index 0000000..909ac3f --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_my_name.py @@ -0,0 +1,31 @@ +from typing import TYPE_CHECKING, Any, Optional + +from ..types import BotName +from .base import TelegramMethod + + +class GetMyName(TelegramMethod[BotName]): + """ + Use this method to get the current bot name for the given user language. Returns :class:`aiogram.types.bot_name.BotName` on success. + + Source: https://core.telegram.org/bots/api#getmyname + """ + + __returning__ = BotName + __api_method__ = "getMyName" + + language_code: Optional[str] = None + """A two-letter ISO 639-1 language code or an empty string""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, language_code: Optional[str] = None, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(language_code=language_code, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_my_short_description.py b/env/Lib/site-packages/aiogram/methods/get_my_short_description.py new file mode 100644 index 0000000..a9a5666 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_my_short_description.py @@ -0,0 +1,33 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from ..types import BotShortDescription +from .base import TelegramMethod + + +class GetMyShortDescription(TelegramMethod[BotShortDescription]): + """ + Use this method to get the current bot short description for the given user language. Returns :class:`aiogram.types.bot_short_description.BotShortDescription` on success. + + Source: https://core.telegram.org/bots/api#getmyshortdescription + """ + + __returning__ = BotShortDescription + __api_method__ = "getMyShortDescription" + + language_code: Optional[str] = None + """A two-letter ISO 639-1 language code or an empty string""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, language_code: Optional[str] = None, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(language_code=language_code, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_star_transactions.py b/env/Lib/site-packages/aiogram/methods/get_star_transactions.py new file mode 100644 index 0000000..ee0ea2e --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_star_transactions.py @@ -0,0 +1,39 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from ..types import StarTransactions +from .base import TelegramMethod + + +class GetStarTransactions(TelegramMethod[StarTransactions]): + """ + Returns the bot's Telegram Star transactions in chronological order. On success, returns a :class:`aiogram.types.star_transactions.StarTransactions` object. + + Source: https://core.telegram.org/bots/api#getstartransactions + """ + + __returning__ = StarTransactions + __api_method__ = "getStarTransactions" + + offset: Optional[int] = None + """Number of transactions to skip in the response""" + limit: Optional[int] = None + """The maximum number of transactions to be retrieved. Values between 1-100 are accepted. Defaults to 100.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + offset: Optional[int] = None, + limit: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(offset=offset, limit=limit, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_sticker_set.py b/env/Lib/site-packages/aiogram/methods/get_sticker_set.py new file mode 100644 index 0000000..2700e17 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_sticker_set.py @@ -0,0 +1,31 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from ..types import StickerSet +from .base import TelegramMethod + + +class GetStickerSet(TelegramMethod[StickerSet]): + """ + Use this method to get a sticker set. On success, a :class:`aiogram.types.sticker_set.StickerSet` object is returned. + + Source: https://core.telegram.org/bots/api#getstickerset + """ + + __returning__ = StickerSet + __api_method__ = "getStickerSet" + + name: str + """Name of the sticker set""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__(__pydantic__self__, *, name: str, **__pydantic_kwargs: Any) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(name=name, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_updates.py b/env/Lib/site-packages/aiogram/methods/get_updates.py new file mode 100644 index 0000000..d1f6371 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_updates.py @@ -0,0 +1,57 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from ..types import Update +from .base import TelegramMethod + + +class GetUpdates(TelegramMethod[List[Update]]): + """ + Use this method to receive incoming updates using long polling (`wiki `_). Returns an Array of :class:`aiogram.types.update.Update` objects. + + **Notes** + + **1.** This method will not work if an outgoing webhook is set up. + + **2.** In order to avoid getting duplicate updates, recalculate *offset* after each server response. + + Source: https://core.telegram.org/bots/api#getupdates + """ + + __returning__ = List[Update] + __api_method__ = "getUpdates" + + offset: Optional[int] = None + """Identifier of the first update to be returned. Must be greater by one than the highest among the identifiers of previously received updates. By default, updates starting with the earliest unconfirmed update are returned. An update is considered confirmed as soon as :class:`aiogram.methods.get_updates.GetUpdates` is called with an *offset* higher than its *update_id*. The negative offset can be specified to retrieve updates starting from *-offset* update from the end of the updates queue. All previous updates will be forgotten.""" + limit: Optional[int] = None + """Limits the number of updates to be retrieved. Values between 1-100 are accepted. Defaults to 100.""" + timeout: Optional[int] = None + """Timeout in seconds for long polling. Defaults to 0, i.e. usual short polling. Should be positive, short polling should be used for testing purposes only.""" + allowed_updates: Optional[List[str]] = None + """A JSON-serialized list of the update types you want your bot to receive. For example, specify :code:`["message", "edited_channel_post", "callback_query"]` to only receive updates of these types. See :class:`aiogram.types.update.Update` for a complete list of available update types. Specify an empty list to receive all update types except *chat_member*, *message_reaction*, and *message_reaction_count* (default). If not specified, the previous setting will be used.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + offset: Optional[int] = None, + limit: Optional[int] = None, + timeout: Optional[int] = None, + allowed_updates: Optional[List[str]] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + offset=offset, + limit=limit, + timeout=timeout, + allowed_updates=allowed_updates, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/get_user_chat_boosts.py b/env/Lib/site-packages/aiogram/methods/get_user_chat_boosts.py new file mode 100644 index 0000000..f3eae26 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_user_chat_boosts.py @@ -0,0 +1,33 @@ +from typing import TYPE_CHECKING, Any, Union + +from ..types import UserChatBoosts +from .base import TelegramMethod + + +class GetUserChatBoosts(TelegramMethod[UserChatBoosts]): + """ + Use this method to get the list of boosts added to a chat by a user. Requires administrator rights in the chat. Returns a :class:`aiogram.types.user_chat_boosts.UserChatBoosts` object. + + Source: https://core.telegram.org/bots/api#getuserchatboosts + """ + + __returning__ = UserChatBoosts + __api_method__ = "getUserChatBoosts" + + chat_id: Union[int, str] + """Unique identifier for the chat or username of the channel (in the format :code:`@channelusername`)""" + user_id: int + """Unique identifier of the target user""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], user_id: int, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, user_id=user_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_user_profile_photos.py b/env/Lib/site-packages/aiogram/methods/get_user_profile_photos.py new file mode 100644 index 0000000..488885e --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_user_profile_photos.py @@ -0,0 +1,42 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from ..types import UserProfilePhotos +from .base import TelegramMethod + + +class GetUserProfilePhotos(TelegramMethod[UserProfilePhotos]): + """ + Use this method to get a list of profile pictures for a user. Returns a :class:`aiogram.types.user_profile_photos.UserProfilePhotos` object. + + Source: https://core.telegram.org/bots/api#getuserprofilephotos + """ + + __returning__ = UserProfilePhotos + __api_method__ = "getUserProfilePhotos" + + user_id: int + """Unique identifier of the target user""" + offset: Optional[int] = None + """Sequential number of the first photo to be returned. By default, all photos are returned.""" + limit: Optional[int] = None + """Limits the number of photos to be retrieved. Values between 1-100 are accepted. Defaults to 100.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + user_id: int, + offset: Optional[int] = None, + limit: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(user_id=user_id, offset=offset, limit=limit, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/get_webhook_info.py b/env/Lib/site-packages/aiogram/methods/get_webhook_info.py new file mode 100644 index 0000000..c9f0e46 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/get_webhook_info.py @@ -0,0 +1,15 @@ +from __future__ import annotations + +from ..types import WebhookInfo +from .base import TelegramMethod + + +class GetWebhookInfo(TelegramMethod[WebhookInfo]): + """ + Use this method to get current webhook status. Requires no parameters. On success, returns a :class:`aiogram.types.webhook_info.WebhookInfo` object. If the bot is using :class:`aiogram.methods.get_updates.GetUpdates`, will return an object with the *url* field empty. + + Source: https://core.telegram.org/bots/api#getwebhookinfo + """ + + __returning__ = WebhookInfo + __api_method__ = "getWebhookInfo" diff --git a/env/Lib/site-packages/aiogram/methods/hide_general_forum_topic.py b/env/Lib/site-packages/aiogram/methods/hide_general_forum_topic.py new file mode 100644 index 0000000..a3b6ee3 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/hide_general_forum_topic.py @@ -0,0 +1,32 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class HideGeneralForumTopic(TelegramMethod[bool]): + """ + Use this method to hide the 'General' topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights. The topic will be automatically closed if it was open. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#hidegeneralforumtopic + """ + + __returning__ = bool + __api_method__ = "hideGeneralForumTopic" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/leave_chat.py b/env/Lib/site-packages/aiogram/methods/leave_chat.py new file mode 100644 index 0000000..f9d4312 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/leave_chat.py @@ -0,0 +1,32 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class LeaveChat(TelegramMethod[bool]): + """ + Use this method for your bot to leave a group, supergroup or channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#leavechat + """ + + __returning__ = bool + __api_method__ = "leaveChat" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup or channel (in the format :code:`@channelusername`)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/log_out.py b/env/Lib/site-packages/aiogram/methods/log_out.py new file mode 100644 index 0000000..2a62653 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/log_out.py @@ -0,0 +1,14 @@ +from __future__ import annotations + +from .base import TelegramMethod + + +class LogOut(TelegramMethod[bool]): + """ + Use this method to log out from the cloud Bot API server before launching the bot locally. You **must** log out the bot before running it locally, otherwise there is no guarantee that the bot will receive updates. After a successful call, you can immediately log in on a local server, but will not be able to log in back to the cloud Bot API server for 10 minutes. Returns :code:`True` on success. Requires no parameters. + + Source: https://core.telegram.org/bots/api#logout + """ + + __returning__ = bool + __api_method__ = "logOut" diff --git a/env/Lib/site-packages/aiogram/methods/pin_chat_message.py b/env/Lib/site-packages/aiogram/methods/pin_chat_message.py new file mode 100644 index 0000000..47c28f1 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/pin_chat_message.py @@ -0,0 +1,50 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from .base import TelegramMethod + + +class PinChatMessage(TelegramMethod[bool]): + """ + Use this method to add a message to the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' administrator right in a supergroup or 'can_edit_messages' administrator right in a channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#pinchatmessage + """ + + __returning__ = bool + __api_method__ = "pinChatMessage" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + message_id: int + """Identifier of a message to pin""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be pinned""" + disable_notification: Optional[bool] = None + """Pass :code:`True` if it is not necessary to send a notification to all chat members about the new pinned message. Notifications are always disabled in channels and private chats.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + message_id: int, + business_connection_id: Optional[str] = None, + disable_notification: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + message_id=message_id, + business_connection_id=business_connection_id, + disable_notification=disable_notification, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/promote_chat_member.py b/env/Lib/site-packages/aiogram/methods/promote_chat_member.py new file mode 100644 index 0000000..2ca410f --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/promote_chat_member.py @@ -0,0 +1,102 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from .base import TelegramMethod + + +class PromoteChatMember(TelegramMethod[bool]): + """ + Use this method to promote or demote a user in a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Pass :code:`False` for all boolean parameters to demote a user. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#promotechatmember + """ + + __returning__ = bool + __api_method__ = "promoteChatMember" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + user_id: int + """Unique identifier of the target user""" + is_anonymous: Optional[bool] = None + """Pass :code:`True` if the administrator's presence in the chat is hidden""" + can_manage_chat: Optional[bool] = None + """Pass :code:`True` if the administrator can access the chat event log, get boost list, see hidden supergroup and channel members, report spam messages and ignore slow mode. Implied by any other administrator privilege.""" + can_delete_messages: Optional[bool] = None + """Pass :code:`True` if the administrator can delete messages of other users""" + can_manage_video_chats: Optional[bool] = None + """Pass :code:`True` if the administrator can manage video chats""" + can_restrict_members: Optional[bool] = None + """Pass :code:`True` if the administrator can restrict, ban or unban chat members, or access supergroup statistics""" + can_promote_members: Optional[bool] = None + """Pass :code:`True` if the administrator can add new administrators with a subset of their own privileges or demote administrators that they have promoted, directly or indirectly (promoted by administrators that were appointed by him)""" + can_change_info: Optional[bool] = None + """Pass :code:`True` if the administrator can change chat title, photo and other settings""" + can_invite_users: Optional[bool] = None + """Pass :code:`True` if the administrator can invite new users to the chat""" + can_post_stories: Optional[bool] = None + """Pass :code:`True` if the administrator can post stories to the chat""" + can_edit_stories: Optional[bool] = None + """Pass :code:`True` if the administrator can edit stories posted by other users, post stories to the chat page, pin chat stories, and access the chat's story archive""" + can_delete_stories: Optional[bool] = None + """Pass :code:`True` if the administrator can delete stories posted by other users""" + can_post_messages: Optional[bool] = None + """Pass :code:`True` if the administrator can post messages in the channel, or access channel statistics; for channels only""" + can_edit_messages: Optional[bool] = None + """Pass :code:`True` if the administrator can edit messages of other users and can pin messages; for channels only""" + can_pin_messages: Optional[bool] = None + """Pass :code:`True` if the administrator can pin messages; for supergroups only""" + can_manage_topics: Optional[bool] = None + """Pass :code:`True` if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + user_id: int, + is_anonymous: Optional[bool] = None, + can_manage_chat: Optional[bool] = None, + can_delete_messages: Optional[bool] = None, + can_manage_video_chats: Optional[bool] = None, + can_restrict_members: Optional[bool] = None, + can_promote_members: Optional[bool] = None, + can_change_info: Optional[bool] = None, + can_invite_users: Optional[bool] = None, + can_post_stories: Optional[bool] = None, + can_edit_stories: Optional[bool] = None, + can_delete_stories: Optional[bool] = None, + can_post_messages: Optional[bool] = None, + can_edit_messages: Optional[bool] = None, + can_pin_messages: Optional[bool] = None, + can_manage_topics: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + user_id=user_id, + is_anonymous=is_anonymous, + can_manage_chat=can_manage_chat, + can_delete_messages=can_delete_messages, + can_manage_video_chats=can_manage_video_chats, + can_restrict_members=can_restrict_members, + can_promote_members=can_promote_members, + can_change_info=can_change_info, + can_invite_users=can_invite_users, + can_post_stories=can_post_stories, + can_edit_stories=can_edit_stories, + can_delete_stories=can_delete_stories, + can_post_messages=can_post_messages, + can_edit_messages=can_edit_messages, + can_pin_messages=can_pin_messages, + can_manage_topics=can_manage_topics, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/refund_star_payment.py b/env/Lib/site-packages/aiogram/methods/refund_star_payment.py new file mode 100644 index 0000000..495cc9e --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/refund_star_payment.py @@ -0,0 +1,42 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramMethod + + +class RefundStarPayment(TelegramMethod[bool]): + """ + Refunds a successful payment in `Telegram Stars `_. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#refundstarpayment + """ + + __returning__ = bool + __api_method__ = "refundStarPayment" + + user_id: int + """Identifier of the user whose payment will be refunded""" + telegram_payment_charge_id: str + """Telegram payment identifier""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + user_id: int, + telegram_payment_charge_id: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + user_id=user_id, + telegram_payment_charge_id=telegram_payment_charge_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/reopen_forum_topic.py b/env/Lib/site-packages/aiogram/methods/reopen_forum_topic.py new file mode 100644 index 0000000..45eb18d --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/reopen_forum_topic.py @@ -0,0 +1,40 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class ReopenForumTopic(TelegramMethod[bool]): + """ + Use this method to reopen a closed topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights, unless it is the creator of the topic. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#reopenforumtopic + """ + + __returning__ = bool + __api_method__ = "reopenForumTopic" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + message_thread_id: int + """Unique identifier for the target message thread of the forum topic""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + message_thread_id: int, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, message_thread_id=message_thread_id, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/methods/reopen_general_forum_topic.py b/env/Lib/site-packages/aiogram/methods/reopen_general_forum_topic.py new file mode 100644 index 0000000..a6dc04e --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/reopen_general_forum_topic.py @@ -0,0 +1,32 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class ReopenGeneralForumTopic(TelegramMethod[bool]): + """ + Use this method to reopen a closed 'General' topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights. The topic will be automatically unhidden if it was hidden. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#reopengeneralforumtopic + """ + + __returning__ = bool + __api_method__ = "reopenGeneralForumTopic" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/replace_sticker_in_set.py b/env/Lib/site-packages/aiogram/methods/replace_sticker_in_set.py new file mode 100644 index 0000000..f46eef2 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/replace_sticker_in_set.py @@ -0,0 +1,51 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from ..types import InputSticker +from .base import TelegramMethod + + +class ReplaceStickerInSet(TelegramMethod[bool]): + """ + Use this method to replace an existing sticker in a sticker set with a new one. The method is equivalent to calling :class:`aiogram.methods.delete_sticker_from_set.DeleteStickerFromSet`, then :class:`aiogram.methods.add_sticker_to_set.AddStickerToSet`, then :class:`aiogram.methods.set_sticker_position_in_set.SetStickerPositionInSet`. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#replacestickerinset + """ + + __returning__ = bool + __api_method__ = "replaceStickerInSet" + + user_id: int + """User identifier of the sticker set owner""" + name: str + """Sticker set name""" + old_sticker: str + """File identifier of the replaced sticker""" + sticker: InputSticker + """A JSON-serialized object with information about the added sticker. If exactly the same sticker had already been added to the set, then the set remains unchanged.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + user_id: int, + name: str, + old_sticker: str, + sticker: InputSticker, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + user_id=user_id, + name=name, + old_sticker=old_sticker, + sticker=sticker, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/restrict_chat_member.py b/env/Lib/site-packages/aiogram/methods/restrict_chat_member.py new file mode 100644 index 0000000..5dfbd01 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/restrict_chat_member.py @@ -0,0 +1,56 @@ +from __future__ import annotations + +import datetime +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import ChatPermissions +from .base import TelegramMethod + + +class RestrictChatMember(TelegramMethod[bool]): + """ + Use this method to restrict a user in a supergroup. The bot must be an administrator in the supergroup for this to work and must have the appropriate administrator rights. Pass :code:`True` for all permissions to lift restrictions from a user. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#restrictchatmember + """ + + __returning__ = bool + __api_method__ = "restrictChatMember" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + user_id: int + """Unique identifier of the target user""" + permissions: ChatPermissions + """A JSON-serialized object for new user permissions""" + use_independent_chat_permissions: Optional[bool] = None + """Pass :code:`True` if chat permissions are set independently. Otherwise, the *can_send_other_messages* and *can_add_web_page_previews* permissions will imply the *can_send_messages*, *can_send_audios*, *can_send_documents*, *can_send_photos*, *can_send_videos*, *can_send_video_notes*, and *can_send_voice_notes* permissions; the *can_send_polls* permission will imply the *can_send_messages* permission.""" + until_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None + """Date when restrictions will be lifted for the user; Unix time. If user is restricted for more than 366 days or less than 30 seconds from the current time, they are considered to be restricted forever""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + user_id: int, + permissions: ChatPermissions, + use_independent_chat_permissions: Optional[bool] = None, + until_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + user_id=user_id, + permissions=permissions, + use_independent_chat_permissions=use_independent_chat_permissions, + until_date=until_date, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/revoke_chat_invite_link.py b/env/Lib/site-packages/aiogram/methods/revoke_chat_invite_link.py new file mode 100644 index 0000000..414feb3 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/revoke_chat_invite_link.py @@ -0,0 +1,39 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from ..types import ChatInviteLink +from .base import TelegramMethod + + +class RevokeChatInviteLink(TelegramMethod[ChatInviteLink]): + """ + Use this method to revoke an invite link created by the bot. If the primary link is revoked, a new link is automatically generated. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the revoked invite link as :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + + Source: https://core.telegram.org/bots/api#revokechatinvitelink + """ + + __returning__ = ChatInviteLink + __api_method__ = "revokeChatInviteLink" + + chat_id: Union[int, str] + """Unique identifier of the target chat or username of the target channel (in the format :code:`@channelusername`)""" + invite_link: str + """The invite link to revoke""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + invite_link: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, invite_link=invite_link, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/send_animation.py b/env/Lib/site-packages/aiogram/methods/send_animation.py new file mode 100644 index 0000000..0baab73 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_animation.py @@ -0,0 +1,141 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + InputFile, + Message, + MessageEntity, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class SendAnimation(TelegramMethod[Message]): + """ + Use this method to send animation files (GIF or H.264/MPEG-4 AVC video without sound). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send animation files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendanimation + """ + + __returning__ = Message + __api_method__ = "sendAnimation" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + animation: Union[InputFile, str] + """Animation to send. Pass a file_id as String to send an animation that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an animation from the Internet, or upload a new animation using multipart/form-data. :ref:`More information on Sending Files » `""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + duration: Optional[int] = None + """Duration of sent animation in seconds""" + width: Optional[int] = None + """Animation width""" + height: Optional[int] = None + """Animation height""" + thumbnail: Optional[InputFile] = None + """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" + caption: Optional[str] = None + """Animation caption (may also be used when resending animation by *file_id*), 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """Mode for parsing entities in the animation caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[Union[bool, Default]] = Default("show_caption_above_media") + """Pass :code:`True`, if the caption must be shown above the message media""" + has_spoiler: Optional[bool] = None + """Pass :code:`True` if the animation needs to be covered with a spoiler animation""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding and saving""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None + """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + animation: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + duration: Optional[int] = None, + width: Optional[int] = None, + height: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + animation=animation, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + duration=duration, + width=width, + height=height, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_audio.py b/env/Lib/site-packages/aiogram/methods/send_audio.py new file mode 100644 index 0000000..b15824a --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_audio.py @@ -0,0 +1,132 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + InputFile, + Message, + MessageEntity, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class SendAudio(TelegramMethod[Message]): + """ + Use this method to send audio files, if you want Telegram clients to display them in the music player. Your audio must be in the .MP3 or .M4A format. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future. + For sending voice messages, use the :class:`aiogram.methods.send_voice.SendVoice` method instead. + + Source: https://core.telegram.org/bots/api#sendaudio + """ + + __returning__ = Message + __api_method__ = "sendAudio" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + audio: Union[InputFile, str] + """Audio file to send. Pass a file_id as String to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » `""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + caption: Optional[str] = None + """Audio caption, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """Mode for parsing entities in the audio caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + duration: Optional[int] = None + """Duration of the audio in seconds""" + performer: Optional[str] = None + """Performer""" + title: Optional[str] = None + """Track name""" + thumbnail: Optional[InputFile] = None + """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding and saving""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None + """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + audio: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + performer: Optional[str] = None, + title: Optional[str] = None, + thumbnail: Optional[InputFile] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + audio=audio, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + duration=duration, + performer=performer, + title=title, + thumbnail=thumbnail, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_chat_action.py b/env/Lib/site-packages/aiogram/methods/send_chat_action.py new file mode 100644 index 0000000..a9f452a --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_chat_action.py @@ -0,0 +1,54 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from .base import TelegramMethod + + +class SendChatAction(TelegramMethod[bool]): + """ + Use this method when you need to tell the user that something is happening on the bot's side. The status is set for 5 seconds or less (when a message arrives from your bot, Telegram clients clear its typing status). Returns :code:`True` on success. + + Example: The `ImageBot `_ needs some time to process a request and upload the image. Instead of sending a text message along the lines of 'Retrieving image, please wait…', the bot may use :class:`aiogram.methods.send_chat_action.SendChatAction` with *action* = *upload_photo*. The user will see a 'sending photo' status for the bot. + + We only recommend using this method when a response from the bot will take a **noticeable** amount of time to arrive. + + Source: https://core.telegram.org/bots/api#sendchataction + """ + + __returning__ = bool + __api_method__ = "sendChatAction" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + action: str + """Type of action to broadcast. Choose one, depending on what the user is about to receive: *typing* for `text messages `_, *upload_photo* for `photos `_, *record_video* or *upload_video* for `videos `_, *record_voice* or *upload_voice* for `voice notes `_, *upload_document* for `general files `_, *choose_sticker* for `stickers `_, *find_location* for `location data `_, *record_video_note* or *upload_video_note* for `video notes `_.""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the action will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread; for supergroups only""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + action: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + action=action, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_contact.py b/env/Lib/site-packages/aiogram/methods/send_contact.py new file mode 100644 index 0000000..6c14d56 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_contact.py @@ -0,0 +1,113 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + Message, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class SendContact(TelegramMethod[Message]): + """ + Use this method to send phone contacts. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendcontact + """ + + __returning__ = Message + __api_method__ = "sendContact" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + phone_number: str + """Contact's phone number""" + first_name: str + """Contact's first name""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + last_name: Optional[str] = None + """Contact's last name""" + vcard: Optional[str] = None + """Additional data about the contact in the form of a `vCard `_, 0-2048 bytes""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding and saving""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None + """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + phone_number: str, + first_name: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + last_name: Optional[str] = None, + vcard: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + phone_number=phone_number, + first_name=first_name, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + last_name=last_name, + vcard=vcard, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_dice.py b/env/Lib/site-packages/aiogram/methods/send_dice.py new file mode 100644 index 0000000..42d2bf5 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_dice.py @@ -0,0 +1,101 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + Message, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class SendDice(TelegramMethod[Message]): + """ + Use this method to send an animated emoji that will display a random value. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#senddice + """ + + __returning__ = Message + __api_method__ = "sendDice" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + emoji: Optional[str] = None + """Emoji on which the dice throw animation is based. Currently, must be one of '🎲', '🎯', '🏀', '⚽', '🎳', or '🎰'. Dice can have values 1-6 for '🎲', '🎯' and '🎳', values 1-5 for '🏀' and '⚽', and values 1-64 for '🎰'. Defaults to '🎲'""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None + """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + emoji: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + emoji=emoji, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_document.py b/env/Lib/site-packages/aiogram/methods/send_document.py new file mode 100644 index 0000000..411165d --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_document.py @@ -0,0 +1,123 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + InputFile, + Message, + MessageEntity, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class SendDocument(TelegramMethod[Message]): + """ + Use this method to send general files. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#senddocument + """ + + __returning__ = Message + __api_method__ = "sendDocument" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + document: Union[InputFile, str] + """File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), 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 information on Sending Files » `""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + thumbnail: Optional[InputFile] = None + """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" + caption: Optional[str] = None + """Document caption (may also be used when resending documents by *file_id*), 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """Mode for parsing entities in the document caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + disable_content_type_detection: Optional[bool] = None + """Disables automatic server-side content type detection for files uploaded using multipart/form-data""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding and saving""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None + """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + document: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + disable_content_type_detection: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + document=document, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + disable_content_type_detection=disable_content_type_detection, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_game.py b/env/Lib/site-packages/aiogram/methods/send_game.py new file mode 100644 index 0000000..eb96330 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_game.py @@ -0,0 +1,90 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import InlineKeyboardMarkup, Message, ReplyParameters +from .base import TelegramMethod + + +class SendGame(TelegramMethod[Message]): + """ + Use this method to send a game. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendgame + """ + + __returning__ = Message + __api_method__ = "sendGame" + + chat_id: int + """Unique identifier for the target chat""" + game_short_name: str + """Short name of the game, serves as the unique identifier for the game. Set up your games via `@BotFather `_.""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding and saving""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """A JSON-serialized object for an `inline keyboard `_. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game.""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: int, + game_short_name: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + game_short_name=game_short_name, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_invoice.py b/env/Lib/site-packages/aiogram/methods/send_invoice.py new file mode 100644 index 0000000..108219e --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_invoice.py @@ -0,0 +1,166 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import InlineKeyboardMarkup, LabeledPrice, Message, ReplyParameters +from .base import TelegramMethod + + +class SendInvoice(TelegramMethod[Message]): + """ + Use this method to send invoices. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendinvoice + """ + + __returning__ = Message + __api_method__ = "sendInvoice" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + title: str + """Product name, 1-32 characters""" + description: str + """Product description, 1-255 characters""" + payload: str + """Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use for your internal processes.""" + currency: str + """Three-letter ISO 4217 currency code, see `more on currencies `_. Pass 'XTR' for payments in `Telegram Stars `_.""" + prices: List[LabeledPrice] + """Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.). Must contain exactly one item for payments in `Telegram Stars `_.""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + provider_token: Optional[str] = None + """Payment provider token, obtained via `@BotFather `_. Pass an empty string for payments in `Telegram Stars `_.""" + max_tip_amount: Optional[int] = None + """The maximum accepted amount for tips in the *smallest units* of the currency (integer, **not** float/double). For example, for a maximum tip of :code:`US$ 1.45` pass :code:`max_tip_amount = 145`. See the *exp* parameter in `currencies.json `_, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0. Not supported for payments in `Telegram Stars `_.""" + suggested_tip_amounts: Optional[List[int]] = None + """A JSON-serialized array of suggested amounts of tips in the *smallest units* of the currency (integer, **not** float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed *max_tip_amount*.""" + start_parameter: Optional[str] = None + """Unique deep-linking parameter. If left empty, **forwarded copies** of the sent message will have a *Pay* button, allowing multiple users to pay directly from the forwarded message, using the same invoice. If non-empty, forwarded copies of the sent message will have a *URL* button with a deep link to the bot (instead of a *Pay* button), with the value used as the start parameter""" + provider_data: Optional[str] = None + """JSON-serialized data about the invoice, which will be shared with the payment provider. A detailed description of required fields should be provided by the payment provider.""" + photo_url: Optional[str] = None + """URL of the product photo for the invoice. Can be a photo of the goods or a marketing image for a service. People like it better when they see what they are paying for.""" + photo_size: Optional[int] = None + """Photo size in bytes""" + photo_width: Optional[int] = None + """Photo width""" + photo_height: Optional[int] = None + """Photo height""" + need_name: Optional[bool] = None + """Pass :code:`True` if you require the user's full name to complete the order. Ignored for payments in `Telegram Stars `_.""" + need_phone_number: Optional[bool] = None + """Pass :code:`True` if you require the user's phone number to complete the order. Ignored for payments in `Telegram Stars `_.""" + need_email: Optional[bool] = None + """Pass :code:`True` if you require the user's email address to complete the order. Ignored for payments in `Telegram Stars `_.""" + need_shipping_address: Optional[bool] = None + """Pass :code:`True` if you require the user's shipping address to complete the order. Ignored for payments in `Telegram Stars `_.""" + send_phone_number_to_provider: Optional[bool] = None + """Pass :code:`True` if the user's phone number should be sent to the provider. Ignored for payments in `Telegram Stars `_.""" + send_email_to_provider: Optional[bool] = None + """Pass :code:`True` if the user's email address should be sent to the provider. Ignored for payments in `Telegram Stars `_.""" + is_flexible: Optional[bool] = None + """Pass :code:`True` if the final price depends on the shipping method. Ignored for payments in `Telegram Stars `_.""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding and saving""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """A JSON-serialized object for an `inline keyboard `_. If empty, one 'Pay :code:`total price`' button will be shown. If not empty, the first button must be a Pay button.""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + title: str, + description: str, + payload: str, + currency: str, + prices: List[LabeledPrice], + message_thread_id: Optional[int] = None, + provider_token: Optional[str] = None, + max_tip_amount: Optional[int] = None, + suggested_tip_amounts: Optional[List[int]] = None, + start_parameter: Optional[str] = None, + provider_data: Optional[str] = None, + photo_url: Optional[str] = None, + photo_size: Optional[int] = None, + photo_width: Optional[int] = None, + photo_height: Optional[int] = None, + need_name: Optional[bool] = None, + need_phone_number: Optional[bool] = None, + need_email: Optional[bool] = None, + need_shipping_address: Optional[bool] = None, + send_phone_number_to_provider: Optional[bool] = None, + send_email_to_provider: Optional[bool] = None, + is_flexible: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + title=title, + description=description, + payload=payload, + currency=currency, + prices=prices, + message_thread_id=message_thread_id, + provider_token=provider_token, + max_tip_amount=max_tip_amount, + suggested_tip_amounts=suggested_tip_amounts, + start_parameter=start_parameter, + provider_data=provider_data, + photo_url=photo_url, + photo_size=photo_size, + photo_width=photo_width, + photo_height=photo_height, + need_name=need_name, + need_phone_number=need_phone_number, + need_email=need_email, + need_shipping_address=need_shipping_address, + send_phone_number_to_provider=send_phone_number_to_provider, + send_email_to_provider=send_email_to_provider, + is_flexible=is_flexible, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_location.py b/env/Lib/site-packages/aiogram/methods/send_location.py new file mode 100644 index 0000000..d33f676 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_location.py @@ -0,0 +1,121 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + Message, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class SendLocation(TelegramMethod[Message]): + """ + Use this method to send point on the map. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendlocation + """ + + __returning__ = Message + __api_method__ = "sendLocation" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + latitude: float + """Latitude of the location""" + longitude: float + """Longitude of the location""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + horizontal_accuracy: Optional[float] = None + """The radius of uncertainty for the location, measured in meters; 0-1500""" + live_period: Optional[int] = None + """Period in seconds during which the location will be updated (see `Live Locations `_, should be between 60 and 86400, or 0x7FFFFFFF for live locations that can be edited indefinitely.""" + heading: Optional[int] = None + """For live locations, a direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.""" + proximity_alert_radius: Optional[int] = None + """For live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding and saving""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None + """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + latitude: float, + longitude: float, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + horizontal_accuracy: Optional[float] = None, + live_period: Optional[int] = None, + heading: Optional[int] = None, + proximity_alert_radius: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + latitude=latitude, + longitude=longitude, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + horizontal_accuracy=horizontal_accuracy, + live_period=live_period, + heading=heading, + proximity_alert_radius=proximity_alert_radius, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_media_group.py b/env/Lib/site-packages/aiogram/methods/send_media_group.py new file mode 100644 index 0000000..f8c081a --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_media_group.py @@ -0,0 +1,99 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + InputMediaAudio, + InputMediaDocument, + InputMediaPhoto, + InputMediaVideo, + Message, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class SendMediaGroup(TelegramMethod[List[Message]]): + """ + Use this method to send a group of photos, videos, documents or audios as an album. Documents and audio files can be only grouped in an album with messages of the same type. On success, an array of `Messages `_ that were sent is returned. + + Source: https://core.telegram.org/bots/api#sendmediagroup + """ + + __returning__ = List[Message] + __api_method__ = "sendMediaGroup" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + media: List[Union[InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo]] + """A JSON-serialized array describing messages to be sent, must include 2-10 items""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + disable_notification: Optional[bool] = None + """Sends messages `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent messages from forwarding and saving""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the messages are a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + media: List[ + Union[InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo] + ], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + media=media, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_message.py b/env/Lib/site-packages/aiogram/methods/send_message.py new file mode 100644 index 0000000..caf2852 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_message.py @@ -0,0 +1,128 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + LinkPreviewOptions, + Message, + MessageEntity, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class SendMessage(TelegramMethod[Message]): + """ + Use this method to send text messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendmessage + """ + + __returning__ = Message + __api_method__ = "sendMessage" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + text: str + """Text of the message to be sent, 1-4096 characters after entities parsing""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """Mode for parsing entities in the message text. See `formatting options `_ for more details.""" + entities: Optional[List[MessageEntity]] = None + """A JSON-serialized list of special entities that appear in message text, which can be specified instead of *parse_mode*""" + link_preview_options: Optional[Union[LinkPreviewOptions, Default]] = Default("link_preview") + """Link preview generation options for the message""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding and saving""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None + """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + disable_web_page_preview: Optional[Union[bool, Default]] = Field( + Default("link_preview_is_disabled"), json_schema_extra={"deprecated": True} + ) + """Disables link previews for links in this message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + text: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + entities: Optional[List[MessageEntity]] = None, + link_preview_options: Optional[Union[LinkPreviewOptions, Default]] = Default( + "link_preview" + ), + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + disable_web_page_preview: Optional[Union[bool, Default]] = Default( + "link_preview_is_disabled" + ), + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + text=text, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + parse_mode=parse_mode, + entities=entities, + link_preview_options=link_preview_options, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + disable_web_page_preview=disable_web_page_preview, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_paid_media.py b/env/Lib/site-packages/aiogram/methods/send_paid_media.py new file mode 100644 index 0000000..dd847f5 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_paid_media.py @@ -0,0 +1,97 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + InputPaidMediaPhoto, + InputPaidMediaVideo, + Message, + MessageEntity, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class SendPaidMedia(TelegramMethod[Message]): + """ + Use this method to send paid media. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendpaidmedia + """ + + __returning__ = Message + __api_method__ = "sendPaidMedia" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`). If the chat is a channel, all Telegram Star proceeds from this media will be credited to the chat's balance. Otherwise, they will be credited to the bot's balance.""" + star_count: int + """The number of Telegram Stars that must be paid to buy access to the media""" + media: List[Union[InputPaidMediaPhoto, InputPaidMediaVideo]] + """A JSON-serialized array describing the media to be sent; up to 10 items""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + caption: Optional[str] = None + """Media caption, 0-1024 characters after entities parsing""" + parse_mode: Optional[str] = None + """Mode for parsing entities in the media caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[bool] = None + """Pass :code:`True`, if the caption must be shown above the message media""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[bool] = None + """Protects the contents of the sent message from forwarding and saving""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None + """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + star_count: int, + media: List[Union[InputPaidMediaPhoto, InputPaidMediaVideo]], + business_connection_id: Optional[str] = None, + caption: Optional[str] = None, + parse_mode: Optional[str] = None, + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + star_count=star_count, + media=media, + business_connection_id=business_connection_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + disable_notification=disable_notification, + protect_content=protect_content, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_photo.py b/env/Lib/site-packages/aiogram/methods/send_photo.py new file mode 100644 index 0000000..3ba7da1 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_photo.py @@ -0,0 +1,125 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + InputFile, + Message, + MessageEntity, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class SendPhoto(TelegramMethod[Message]): + """ + Use this method to send photos. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendphoto + """ + + __returning__ = Message + __api_method__ = "sendPhoto" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + photo: Union[InputFile, str] + """Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data. The photo must be at most 10 MB in size. The photo's width and height must not exceed 10000 in total. Width and height ratio must be at most 20. :ref:`More information on Sending Files » `""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + caption: Optional[str] = None + """Photo caption (may also be used when resending photos by *file_id*), 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """Mode for parsing entities in the photo caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[Union[bool, Default]] = Default("show_caption_above_media") + """Pass :code:`True`, if the caption must be shown above the message media""" + has_spoiler: Optional[bool] = None + """Pass :code:`True` if the photo needs to be covered with a spoiler animation""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding and saving""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None + """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + photo: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + photo=photo, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_poll.py b/env/Lib/site-packages/aiogram/methods/send_poll.py new file mode 100644 index 0000000..e791b70 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_poll.py @@ -0,0 +1,156 @@ +from __future__ import annotations + +import datetime +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + InputPollOption, + Message, + MessageEntity, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class SendPoll(TelegramMethod[Message]): + """ + Use this method to send a native poll. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendpoll + """ + + __returning__ = Message + __api_method__ = "sendPoll" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + question: str + """Poll question, 1-300 characters""" + options: List[Union[InputPollOption, str]] + """A JSON-serialized list of 2-10 answer options""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + question_parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """Mode for parsing entities in the question. See `formatting options `_ for more details. Currently, only custom emoji entities are allowed""" + question_entities: Optional[List[MessageEntity]] = None + """A JSON-serialized list of special entities that appear in the poll question. It can be specified instead of *question_parse_mode*""" + is_anonymous: Optional[bool] = None + """:code:`True`, if the poll needs to be anonymous, defaults to :code:`True`""" + type: Optional[str] = None + """Poll type, 'quiz' or 'regular', defaults to 'regular'""" + allows_multiple_answers: Optional[bool] = None + """:code:`True`, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to :code:`False`""" + correct_option_id: Optional[int] = None + """0-based identifier of the correct answer option, required for polls in quiz mode""" + explanation: Optional[str] = None + """Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing""" + explanation_parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """Mode for parsing entities in the explanation. See `formatting options `_ for more details.""" + explanation_entities: Optional[List[MessageEntity]] = None + """A JSON-serialized list of special entities that appear in the poll explanation. It can be specified instead of *explanation_parse_mode*""" + open_period: Optional[int] = None + """Amount of time in seconds the poll will be active after creation, 5-600. Can't be used together with *close_date*.""" + close_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None + """Point in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future. Can't be used together with *open_period*.""" + is_closed: Optional[bool] = None + """Pass :code:`True` if the poll needs to be immediately closed. This can be useful for poll preview.""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding and saving""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None + """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + question: str, + options: List[Union[InputPollOption, str]], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + question_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + question_entities: Optional[List[MessageEntity]] = None, + is_anonymous: Optional[bool] = None, + type: Optional[str] = None, + allows_multiple_answers: Optional[bool] = None, + correct_option_id: Optional[int] = None, + explanation: Optional[str] = None, + explanation_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + explanation_entities: Optional[List[MessageEntity]] = None, + open_period: Optional[int] = None, + close_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + is_closed: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + question=question, + options=options, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + question_parse_mode=question_parse_mode, + question_entities=question_entities, + is_anonymous=is_anonymous, + type=type, + allows_multiple_answers=allows_multiple_answers, + correct_option_id=correct_option_id, + explanation=explanation, + explanation_parse_mode=explanation_parse_mode, + explanation_entities=explanation_entities, + open_period=open_period, + close_date=close_date, + is_closed=is_closed, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_sticker.py b/env/Lib/site-packages/aiogram/methods/send_sticker.py new file mode 100644 index 0000000..236792b --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_sticker.py @@ -0,0 +1,106 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + InputFile, + Message, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class SendSticker(TelegramMethod[Message]): + """ + Use this method to send static .WEBP, `animated `_ .TGS, or `video `_ .WEBM stickers. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendsticker + """ + + __returning__ = Message + __api_method__ = "sendSticker" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + sticker: Union[InputFile, str] + """Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP, .TGS, or .WEBM sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video and animated stickers can't be sent via an HTTP URL.""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + emoji: Optional[str] = None + """Emoji associated with the sticker; only for just uploaded stickers""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding and saving""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None + """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + sticker: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + emoji: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + sticker=sticker, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + emoji=emoji, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_venue.py b/env/Lib/site-packages/aiogram/methods/send_venue.py new file mode 100644 index 0000000..04ebcee --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_venue.py @@ -0,0 +1,129 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + Message, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class SendVenue(TelegramMethod[Message]): + """ + Use this method to send information about a venue. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvenue + """ + + __returning__ = Message + __api_method__ = "sendVenue" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + latitude: float + """Latitude of the venue""" + longitude: float + """Longitude of the venue""" + title: str + """Name of the venue""" + address: str + """Address of the venue""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + foursquare_id: Optional[str] = None + """Foursquare identifier of the venue""" + foursquare_type: Optional[str] = None + """Foursquare type of the venue, if known. (For example, 'arts_entertainment/default', 'arts_entertainment/aquarium' or 'food/icecream'.)""" + google_place_id: Optional[str] = None + """Google Places identifier of the venue""" + google_place_type: Optional[str] = None + """Google Places type of the venue. (See `supported types `_.)""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding and saving""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None + """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + latitude: float, + longitude: float, + title: str, + address: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + foursquare_id: Optional[str] = None, + foursquare_type: Optional[str] = None, + google_place_id: Optional[str] = None, + google_place_type: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + latitude=latitude, + longitude=longitude, + title=title, + address=address, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + foursquare_id=foursquare_id, + foursquare_type=foursquare_type, + google_place_id=google_place_id, + google_place_type=google_place_type, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_video.py b/env/Lib/site-packages/aiogram/methods/send_video.py new file mode 100644 index 0000000..33fb7aa --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_video.py @@ -0,0 +1,145 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + InputFile, + Message, + MessageEntity, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class SendVideo(TelegramMethod[Message]): + """ + Use this method to send video files, Telegram clients support MPEG4 videos (other formats may be sent as :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvideo + """ + + __returning__ = Message + __api_method__ = "sendVideo" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + video: Union[InputFile, str] + """Video to send. Pass a file_id as String to send a video that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a video from the Internet, or upload a new video using multipart/form-data. :ref:`More information on Sending Files » `""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + duration: Optional[int] = None + """Duration of sent video in seconds""" + width: Optional[int] = None + """Video width""" + height: Optional[int] = None + """Video height""" + thumbnail: Optional[InputFile] = None + """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" + caption: Optional[str] = None + """Video caption (may also be used when resending videos by *file_id*), 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """Mode for parsing entities in the video caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[Union[bool, Default]] = Default("show_caption_above_media") + """Pass :code:`True`, if the caption must be shown above the message media""" + has_spoiler: Optional[bool] = None + """Pass :code:`True` if the video needs to be covered with a spoiler animation""" + supports_streaming: Optional[bool] = None + """Pass :code:`True` if the uploaded video is suitable for streaming""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding and saving""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None + """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + video: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + duration: Optional[int] = None, + width: Optional[int] = None, + height: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + supports_streaming: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + video=video, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + duration=duration, + width=width, + height=height, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + supports_streaming=supports_streaming, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_video_note.py b/env/Lib/site-packages/aiogram/methods/send_video_note.py new file mode 100644 index 0000000..43d685b --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_video_note.py @@ -0,0 +1,114 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + InputFile, + Message, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class SendVideoNote(TelegramMethod[Message]): + """ + As of `v.4.0 `_, Telegram clients support rounded square MPEG4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvideonote + """ + + __returning__ = Message + __api_method__ = "sendVideoNote" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + video_note: Union[InputFile, str] + """Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data. :ref:`More information on Sending Files » `. Sending video notes by a URL is currently unsupported""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + duration: Optional[int] = None + """Duration of sent video in seconds""" + length: Optional[int] = None + """Video width and height, i.e. diameter of the video message""" + thumbnail: Optional[InputFile] = None + """Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding and saving""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None + """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + video_note: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + duration: Optional[int] = None, + length: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + video_note=video_note, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + duration=duration, + length=length, + thumbnail=thumbnail, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/send_voice.py b/env/Lib/site-packages/aiogram/methods/send_voice.py new file mode 100644 index 0000000..ccb27d3 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/send_voice.py @@ -0,0 +1,119 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from ..types import ( + ForceReply, + InlineKeyboardMarkup, + InputFile, + Message, + MessageEntity, + ReplyKeyboardMarkup, + ReplyKeyboardRemove, + ReplyParameters, +) +from .base import TelegramMethod + + +class SendVoice(TelegramMethod[Message]): + """ + Use this method to send audio files, if you want Telegram clients to display the file as a playable voice message. For this to work, your audio must be in an .OGG file encoded with OPUS, or in .MP3 format, or in .M4A format (other formats may be sent as :class:`aiogram.types.audio.Audio` or :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send voice messages of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvoice + """ + + __returning__ = Message + __api_method__ = "sendVoice" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + voice: Union[InputFile, str] + """Audio file to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), 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 information on Sending Files » `""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be sent""" + message_thread_id: Optional[int] = None + """Unique identifier for the target message thread (topic) of the forum; for forum supergroups only""" + caption: Optional[str] = None + """Voice message caption, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """Mode for parsing entities in the voice message caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + duration: Optional[int] = None + """Duration of the voice message in seconds""" + disable_notification: Optional[bool] = None + """Sends the message `silently `_. Users will receive a notification with no sound.""" + protect_content: Optional[Union[bool, Default]] = Default("protect_content") + """Protects the contents of the sent message from forwarding and saving""" + message_effect_id: Optional[str] = None + """Unique identifier of the message effect to be added to the message; for private chats only""" + reply_parameters: Optional[ReplyParameters] = None + """Description of the message to reply to""" + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None + """Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user""" + allow_sending_without_reply: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + reply_to_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """If the message is a reply, ID of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + voice: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + voice=voice, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + duration=duration, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/set_chat_administrator_custom_title.py b/env/Lib/site-packages/aiogram/methods/set_chat_administrator_custom_title.py new file mode 100644 index 0000000..a7953c1 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_chat_administrator_custom_title.py @@ -0,0 +1,43 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class SetChatAdministratorCustomTitle(TelegramMethod[bool]): + """ + Use this method to set a custom title for an administrator in a supergroup promoted by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatadministratorcustomtitle + """ + + __returning__ = bool + __api_method__ = "setChatAdministratorCustomTitle" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + user_id: int + """Unique identifier of the target user""" + custom_title: str + """New custom title for the administrator; 0-16 characters, emoji are not allowed""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + user_id: int, + custom_title: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, user_id=user_id, custom_title=custom_title, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/methods/set_chat_description.py b/env/Lib/site-packages/aiogram/methods/set_chat_description.py new file mode 100644 index 0000000..0f8a4a4 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_chat_description.py @@ -0,0 +1,38 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from .base import TelegramMethod + + +class SetChatDescription(TelegramMethod[bool]): + """ + Use this method to change the description of a group, a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatdescription + """ + + __returning__ = bool + __api_method__ = "setChatDescription" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + description: Optional[str] = None + """New chat description, 0-255 characters""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + description: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, description=description, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/set_chat_menu_button.py b/env/Lib/site-packages/aiogram/methods/set_chat_menu_button.py new file mode 100644 index 0000000..97515d5 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_chat_menu_button.py @@ -0,0 +1,41 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import MenuButtonCommands, MenuButtonDefault, MenuButtonWebApp +from .base import TelegramMethod + + +class SetChatMenuButton(TelegramMethod[bool]): + """ + Use this method to change the bot's menu button in a private chat, or the default menu button. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatmenubutton + """ + + __returning__ = bool + __api_method__ = "setChatMenuButton" + + chat_id: Optional[int] = None + """Unique identifier for the target private chat. If not specified, default bot's menu button will be changed""" + menu_button: Optional[Union[MenuButtonCommands, MenuButtonWebApp, MenuButtonDefault]] = None + """A JSON-serialized object for the bot's new menu button. Defaults to :class:`aiogram.types.menu_button_default.MenuButtonDefault`""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Optional[int] = None, + menu_button: Optional[ + Union[MenuButtonCommands, MenuButtonWebApp, MenuButtonDefault] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, menu_button=menu_button, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/set_chat_permissions.py b/env/Lib/site-packages/aiogram/methods/set_chat_permissions.py new file mode 100644 index 0000000..232af08 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_chat_permissions.py @@ -0,0 +1,47 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import ChatPermissions +from .base import TelegramMethod + + +class SetChatPermissions(TelegramMethod[bool]): + """ + Use this method to set default chat permissions for all members. The bot must be an administrator in the group or a supergroup for this to work and must have the *can_restrict_members* administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatpermissions + """ + + __returning__ = bool + __api_method__ = "setChatPermissions" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + permissions: ChatPermissions + """A JSON-serialized object for new default chat permissions""" + use_independent_chat_permissions: Optional[bool] = None + """Pass :code:`True` if chat permissions are set independently. Otherwise, the *can_send_other_messages* and *can_add_web_page_previews* permissions will imply the *can_send_messages*, *can_send_audios*, *can_send_documents*, *can_send_photos*, *can_send_videos*, *can_send_video_notes*, and *can_send_voice_notes* permissions; the *can_send_polls* permission will imply the *can_send_messages* permission.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + permissions: ChatPermissions, + use_independent_chat_permissions: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + permissions=permissions, + use_independent_chat_permissions=use_independent_chat_permissions, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/set_chat_photo.py b/env/Lib/site-packages/aiogram/methods/set_chat_photo.py new file mode 100644 index 0000000..105f8f8 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_chat_photo.py @@ -0,0 +1,39 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from ..types import InputFile +from .base import TelegramMethod + + +class SetChatPhoto(TelegramMethod[bool]): + """ + Use this method to set a new profile photo for the chat. Photos can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatphoto + """ + + __returning__ = bool + __api_method__ = "setChatPhoto" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + photo: InputFile + """New chat photo, uploaded using multipart/form-data""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + photo: InputFile, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, photo=photo, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/set_chat_sticker_set.py b/env/Lib/site-packages/aiogram/methods/set_chat_sticker_set.py new file mode 100644 index 0000000..62ed5d1 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_chat_sticker_set.py @@ -0,0 +1,40 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class SetChatStickerSet(TelegramMethod[bool]): + """ + Use this method to set a new group sticker set for a supergroup. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Use the field *can_set_sticker_set* optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests to check if the bot can use this method. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatstickerset + """ + + __returning__ = bool + __api_method__ = "setChatStickerSet" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + sticker_set_name: str + """Name of the sticker set to be set as the group sticker set""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + sticker_set_name: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, sticker_set_name=sticker_set_name, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/methods/set_chat_title.py b/env/Lib/site-packages/aiogram/methods/set_chat_title.py new file mode 100644 index 0000000..04b52e0 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_chat_title.py @@ -0,0 +1,34 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class SetChatTitle(TelegramMethod[bool]): + """ + Use this method to change the title of a chat. Titles can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchattitle + """ + + __returning__ = bool + __api_method__ = "setChatTitle" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + title: str + """New chat title, 1-128 characters""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], title: str, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, title=title, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/set_custom_emoji_sticker_set_thumbnail.py b/env/Lib/site-packages/aiogram/methods/set_custom_emoji_sticker_set_thumbnail.py new file mode 100644 index 0000000..47e9c03 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_custom_emoji_sticker_set_thumbnail.py @@ -0,0 +1,38 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramMethod + + +class SetCustomEmojiStickerSetThumbnail(TelegramMethod[bool]): + """ + Use this method to set the thumbnail of a custom emoji sticker set. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setcustomemojistickersetthumbnail + """ + + __returning__ = bool + __api_method__ = "setCustomEmojiStickerSetThumbnail" + + name: str + """Sticker set name""" + custom_emoji_id: Optional[str] = None + """Custom emoji identifier of a sticker from the sticker set; pass an empty string to drop the thumbnail and use the first sticker as the thumbnail.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + name: str, + custom_emoji_id: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(name=name, custom_emoji_id=custom_emoji_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/set_game_score.py b/env/Lib/site-packages/aiogram/methods/set_game_score.py new file mode 100644 index 0000000..38e5374 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_game_score.py @@ -0,0 +1,63 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import Message +from .base import TelegramMethod + + +class SetGameScore(TelegramMethod[Union[Message, bool]]): + """ + Use this method to set the score of the specified user in a game message. On success, if the message is not an inline message, the :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. Returns an error, if the new score is not greater than the user's current score in the chat and *force* is :code:`False`. + + Source: https://core.telegram.org/bots/api#setgamescore + """ + + __returning__ = Union[Message, bool] + __api_method__ = "setGameScore" + + user_id: int + """User identifier""" + score: int + """New score, must be non-negative""" + force: Optional[bool] = None + """Pass :code:`True` if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters""" + disable_edit_message: Optional[bool] = None + """Pass :code:`True` if the game message should not be automatically edited to include the current scoreboard""" + chat_id: Optional[int] = None + """Required if *inline_message_id* is not specified. Unique identifier for the target chat""" + message_id: Optional[int] = None + """Required if *inline_message_id* is not specified. Identifier of the sent message""" + inline_message_id: Optional[str] = None + """Required if *chat_id* and *message_id* are not specified. Identifier of the inline message""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + user_id: int, + score: int, + force: Optional[bool] = None, + disable_edit_message: Optional[bool] = None, + chat_id: Optional[int] = None, + message_id: Optional[int] = None, + inline_message_id: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + user_id=user_id, + score=score, + force=force, + disable_edit_message=disable_edit_message, + chat_id=chat_id, + message_id=message_id, + inline_message_id=inline_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/set_message_reaction.py b/env/Lib/site-packages/aiogram/methods/set_message_reaction.py new file mode 100644 index 0000000..d1c061c --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_message_reaction.py @@ -0,0 +1,53 @@ +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from ..types import ReactionTypeCustomEmoji, ReactionTypeEmoji, ReactionTypePaid +from .base import TelegramMethod + + +class SetMessageReaction(TelegramMethod[bool]): + """ + Use this method to change the chosen reactions on a message. Service messages can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. Bots can't use paid reactions. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmessagereaction + """ + + __returning__ = bool + __api_method__ = "setMessageReaction" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + message_id: int + """Identifier of the target message. If the message belongs to a media group, the reaction is set to the first non-deleted message in the group instead.""" + reaction: Optional[ + List[Union[ReactionTypeEmoji, ReactionTypeCustomEmoji, ReactionTypePaid]] + ] = None + """A JSON-serialized list of reaction types to set on the message. Currently, as non-premium users, bots can set up to one reaction per message. A custom emoji reaction can be used if it is either already present on the message or explicitly allowed by chat administrators. Paid reactions can't be used by bots.""" + is_big: Optional[bool] = None + """Pass :code:`True` to set the reaction with a big animation""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + message_id: int, + reaction: Optional[ + List[Union[ReactionTypeEmoji, ReactionTypeCustomEmoji, ReactionTypePaid]] + ] = None, + is_big: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + message_id=message_id, + reaction=reaction, + is_big=is_big, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/set_my_commands.py b/env/Lib/site-packages/aiogram/methods/set_my_commands.py new file mode 100644 index 0000000..2e52771 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_my_commands.py @@ -0,0 +1,73 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from ..types import ( + BotCommand, + BotCommandScopeAllChatAdministrators, + BotCommandScopeAllGroupChats, + BotCommandScopeAllPrivateChats, + BotCommandScopeChat, + BotCommandScopeChatAdministrators, + BotCommandScopeChatMember, + BotCommandScopeDefault, +) +from .base import TelegramMethod + + +class SetMyCommands(TelegramMethod[bool]): + """ + Use this method to change the list of the bot's commands. See `this manual `_ for more details about bot commands. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmycommands + """ + + __returning__ = bool + __api_method__ = "setMyCommands" + + commands: List[BotCommand] + """A JSON-serialized list of bot commands to be set as the list of the bot's commands. At most 100 commands can be specified.""" + scope: Optional[ + Union[ + BotCommandScopeDefault, + BotCommandScopeAllPrivateChats, + BotCommandScopeAllGroupChats, + BotCommandScopeAllChatAdministrators, + BotCommandScopeChat, + BotCommandScopeChatAdministrators, + BotCommandScopeChatMember, + ] + ] = None + """A JSON-serialized object, describing scope of users for which the commands are relevant. Defaults to :class:`aiogram.types.bot_command_scope_default.BotCommandScopeDefault`.""" + language_code: Optional[str] = None + """A two-letter ISO 639-1 language code. If empty, commands will be applied to all users from the given scope, for whose language there are no dedicated commands""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + commands: List[BotCommand], + scope: Optional[ + Union[ + BotCommandScopeDefault, + BotCommandScopeAllPrivateChats, + BotCommandScopeAllGroupChats, + BotCommandScopeAllChatAdministrators, + BotCommandScopeChat, + BotCommandScopeChatAdministrators, + BotCommandScopeChatMember, + ] + ] = None, + language_code: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + commands=commands, scope=scope, language_code=language_code, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/methods/set_my_default_administrator_rights.py b/env/Lib/site-packages/aiogram/methods/set_my_default_administrator_rights.py new file mode 100644 index 0000000..02aa7ad --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_my_default_administrator_rights.py @@ -0,0 +1,39 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from ..types import ChatAdministratorRights +from .base import TelegramMethod + + +class SetMyDefaultAdministratorRights(TelegramMethod[bool]): + """ + Use this method to change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are free to modify the list before adding the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmydefaultadministratorrights + """ + + __returning__ = bool + __api_method__ = "setMyDefaultAdministratorRights" + + rights: Optional[ChatAdministratorRights] = None + """A JSON-serialized object describing new default administrator rights. If not specified, the default administrator rights will be cleared.""" + for_channels: Optional[bool] = None + """Pass :code:`True` to change the default administrator rights of the bot in channels. Otherwise, the default administrator rights of the bot for groups and supergroups will be changed.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + rights: Optional[ChatAdministratorRights] = None, + for_channels: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(rights=rights, for_channels=for_channels, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/set_my_description.py b/env/Lib/site-packages/aiogram/methods/set_my_description.py new file mode 100644 index 0000000..ee192c8 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_my_description.py @@ -0,0 +1,40 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramMethod + + +class SetMyDescription(TelegramMethod[bool]): + """ + Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmydescription + """ + + __returning__ = bool + __api_method__ = "setMyDescription" + + description: Optional[str] = None + """New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language.""" + language_code: Optional[str] = None + """A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + description: Optional[str] = None, + language_code: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + description=description, language_code=language_code, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/methods/set_my_name.py b/env/Lib/site-packages/aiogram/methods/set_my_name.py new file mode 100644 index 0000000..3633fdc --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_my_name.py @@ -0,0 +1,36 @@ +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramMethod + + +class SetMyName(TelegramMethod[bool]): + """ + Use this method to change the bot's name. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmyname + """ + + __returning__ = bool + __api_method__ = "setMyName" + + name: Optional[str] = None + """New bot name; 0-64 characters. Pass an empty string to remove the dedicated name for the given language.""" + language_code: Optional[str] = None + """A two-letter ISO 639-1 language code. If empty, the name will be shown to all users for whose language there is no dedicated name.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + name: Optional[str] = None, + language_code: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(name=name, language_code=language_code, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/set_my_short_description.py b/env/Lib/site-packages/aiogram/methods/set_my_short_description.py new file mode 100644 index 0000000..22fa581 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_my_short_description.py @@ -0,0 +1,42 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramMethod + + +class SetMyShortDescription(TelegramMethod[bool]): + """ + Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmyshortdescription + """ + + __returning__ = bool + __api_method__ = "setMyShortDescription" + + short_description: Optional[str] = None + """New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language.""" + language_code: Optional[str] = None + """A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + short_description: Optional[str] = None, + language_code: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + short_description=short_description, + language_code=language_code, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/set_passport_data_errors.py b/env/Lib/site-packages/aiogram/methods/set_passport_data_errors.py new file mode 100644 index 0000000..0ad7e8b --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_passport_data_errors.py @@ -0,0 +1,74 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Union + +from ..types import ( + PassportElementErrorDataField, + PassportElementErrorFile, + PassportElementErrorFiles, + PassportElementErrorFrontSide, + PassportElementErrorReverseSide, + PassportElementErrorSelfie, + PassportElementErrorTranslationFile, + PassportElementErrorTranslationFiles, + PassportElementErrorUnspecified, +) +from .base import TelegramMethod + + +class SetPassportDataErrors(TelegramMethod[bool]): + """ + Informs a user that some of the Telegram Passport elements they provided contains errors. The user will not be able to re-submit their Passport to you until the errors are fixed (the contents of the field for which you returned the error must change). Returns :code:`True` on success. + Use this if the data submitted by the user doesn't satisfy the standards your service requires for any reason. For example, if a birthday date seems invalid, a submitted document is blurry, a scan shows evidence of tampering, etc. Supply some details in the error message to make sure the user knows how to correct the issues. + + Source: https://core.telegram.org/bots/api#setpassportdataerrors + """ + + __returning__ = bool + __api_method__ = "setPassportDataErrors" + + user_id: int + """User identifier""" + errors: List[ + Union[ + PassportElementErrorDataField, + PassportElementErrorFrontSide, + PassportElementErrorReverseSide, + PassportElementErrorSelfie, + PassportElementErrorFile, + PassportElementErrorFiles, + PassportElementErrorTranslationFile, + PassportElementErrorTranslationFiles, + PassportElementErrorUnspecified, + ] + ] + """A JSON-serialized array describing the errors""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + user_id: int, + errors: List[ + Union[ + PassportElementErrorDataField, + PassportElementErrorFrontSide, + PassportElementErrorReverseSide, + PassportElementErrorSelfie, + PassportElementErrorFile, + PassportElementErrorFiles, + PassportElementErrorTranslationFile, + PassportElementErrorTranslationFiles, + PassportElementErrorUnspecified, + ] + ], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(user_id=user_id, errors=errors, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/set_sticker_emoji_list.py b/env/Lib/site-packages/aiogram/methods/set_sticker_emoji_list.py new file mode 100644 index 0000000..ac268c1 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_sticker_emoji_list.py @@ -0,0 +1,34 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List + +from .base import TelegramMethod + + +class SetStickerEmojiList(TelegramMethod[bool]): + """ + Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickeremojilist + """ + + __returning__ = bool + __api_method__ = "setStickerEmojiList" + + sticker: str + """File identifier of the sticker""" + emoji_list: List[str] + """A JSON-serialized list of 1-20 emoji associated with the sticker""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, sticker: str, emoji_list: List[str], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(sticker=sticker, emoji_list=emoji_list, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/set_sticker_keywords.py b/env/Lib/site-packages/aiogram/methods/set_sticker_keywords.py new file mode 100644 index 0000000..49e68f8 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_sticker_keywords.py @@ -0,0 +1,38 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from .base import TelegramMethod + + +class SetStickerKeywords(TelegramMethod[bool]): + """ + Use this method to change search keywords assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickerkeywords + """ + + __returning__ = bool + __api_method__ = "setStickerKeywords" + + sticker: str + """File identifier of the sticker""" + keywords: Optional[List[str]] = None + """A JSON-serialized list of 0-20 search keywords for the sticker with total length of up to 64 characters""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + sticker: str, + keywords: Optional[List[str]] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(sticker=sticker, keywords=keywords, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/set_sticker_mask_position.py b/env/Lib/site-packages/aiogram/methods/set_sticker_mask_position.py new file mode 100644 index 0000000..617e48b --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_sticker_mask_position.py @@ -0,0 +1,39 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from ..types import MaskPosition +from .base import TelegramMethod + + +class SetStickerMaskPosition(TelegramMethod[bool]): + """ + Use this method to change the `mask position `_ of a mask sticker. The sticker must belong to a sticker set that was created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickermaskposition + """ + + __returning__ = bool + __api_method__ = "setStickerMaskPosition" + + sticker: str + """File identifier of the sticker""" + mask_position: Optional[MaskPosition] = None + """A JSON-serialized object with the position where the mask should be placed on faces. Omit the parameter to remove the mask position.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + sticker: str, + mask_position: Optional[MaskPosition] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(sticker=sticker, mask_position=mask_position, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/set_sticker_position_in_set.py b/env/Lib/site-packages/aiogram/methods/set_sticker_position_in_set.py new file mode 100644 index 0000000..8d30eab --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_sticker_position_in_set.py @@ -0,0 +1,34 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramMethod + + +class SetStickerPositionInSet(TelegramMethod[bool]): + """ + Use this method to move a sticker in a set created by the bot to a specific position. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickerpositioninset + """ + + __returning__ = bool + __api_method__ = "setStickerPositionInSet" + + sticker: str + """File identifier of the sticker""" + position: int + """New sticker position in the set, zero-based""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, sticker: str, position: int, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(sticker=sticker, position=position, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/set_sticker_set_thumbnail.py b/env/Lib/site-packages/aiogram/methods/set_sticker_set_thumbnail.py new file mode 100644 index 0000000..ef83f70 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_sticker_set_thumbnail.py @@ -0,0 +1,47 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import InputFile +from .base import TelegramMethod + + +class SetStickerSetThumbnail(TelegramMethod[bool]): + """ + Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail file must match the format of the stickers in the set. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickersetthumbnail + """ + + __returning__ = bool + __api_method__ = "setStickerSetThumbnail" + + name: str + """Sticker set name""" + user_id: int + """User identifier of the sticker set owner""" + format: str + """Format of the thumbnail, must be one of 'static' for a **.WEBP** or **.PNG** image, 'animated' for a **.TGS** animation, or 'video' for a **WEBM** video""" + thumbnail: Optional[Union[InputFile, str]] = None + """A **.WEBP** or **.PNG** image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a **.TGS** animation with a thumbnail up to 32 kilobytes in size (see `https://core.telegram.org/stickers#animation-requirements `_`https://core.telegram.org/stickers#animation-requirements `_ for animated sticker technical requirements), or a **WEBM** video with the thumbnail up to 32 kilobytes in size; see `https://core.telegram.org/stickers#video-requirements `_`https://core.telegram.org/stickers#video-requirements `_ for video sticker technical requirements. 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 information on Sending Files » `. Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + name: str, + user_id: int, + format: str, + thumbnail: Optional[Union[InputFile, str]] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + name=name, user_id=user_id, format=format, thumbnail=thumbnail, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/methods/set_sticker_set_title.py b/env/Lib/site-packages/aiogram/methods/set_sticker_set_title.py new file mode 100644 index 0000000..ec25473 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_sticker_set_title.py @@ -0,0 +1,34 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramMethod + + +class SetStickerSetTitle(TelegramMethod[bool]): + """ + Use this method to set the title of a created sticker set. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickersettitle + """ + + __returning__ = bool + __api_method__ = "setStickerSetTitle" + + name: str + """Sticker set name""" + title: str + """Sticker set title, 1-64 characters""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, name: str, title: str, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(name=name, title=title, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/set_webhook.py b/env/Lib/site-packages/aiogram/methods/set_webhook.py new file mode 100644 index 0000000..998e51b --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/set_webhook.py @@ -0,0 +1,73 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from ..types import InputFile +from .base import TelegramMethod + + +class SetWebhook(TelegramMethod[bool]): + """ + Use this method to specify a URL and receive incoming updates via an outgoing webhook. Whenever there is an update for the bot, we will send an HTTPS POST request to the specified URL, containing a JSON-serialized :class:`aiogram.types.update.Update`. In case of an unsuccessful request, we will give up after a reasonable amount of attempts. Returns :code:`True` on success. + If you'd like to make sure that the webhook was set by you, you can specify secret data in the parameter *secret_token*. If specified, the request will contain a header 'X-Telegram-Bot-Api-Secret-Token' with the secret token as content. + + **Notes** + + **1.** You will not be able to receive updates using :class:`aiogram.methods.get_updates.GetUpdates` for as long as an outgoing webhook is set up. + + **2.** To use a self-signed certificate, you need to upload your `public key certificate `_ using *certificate* parameter. Please upload as InputFile, sending a String will not work. + + **3.** Ports currently supported *for webhooks*: **443, 80, 88, 8443**. + If you're having any trouble setting up webhooks, please check out this `amazing guide to webhooks `_. + + Source: https://core.telegram.org/bots/api#setwebhook + """ + + __returning__ = bool + __api_method__ = "setWebhook" + + url: str + """HTTPS URL to send updates to. Use an empty string to remove webhook integration""" + certificate: Optional[InputFile] = None + """Upload your public key certificate so that the root certificate in use can be checked. See our `self-signed guide `_ for details.""" + ip_address: Optional[str] = None + """The fixed IP address which will be used to send webhook requests instead of the IP address resolved through DNS""" + max_connections: Optional[int] = None + """The maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery, 1-100. Defaults to *40*. Use lower values to limit the load on your bot's server, and higher values to increase your bot's throughput.""" + allowed_updates: Optional[List[str]] = None + """A JSON-serialized list of the update types you want your bot to receive. For example, specify :code:`["message", "edited_channel_post", "callback_query"]` to only receive updates of these types. See :class:`aiogram.types.update.Update` for a complete list of available update types. Specify an empty list to receive all update types except *chat_member*, *message_reaction*, and *message_reaction_count* (default). If not specified, the previous setting will be used.""" + drop_pending_updates: Optional[bool] = None + """Pass :code:`True` to drop all pending updates""" + secret_token: Optional[str] = None + """A secret token to be sent in a header 'X-Telegram-Bot-Api-Secret-Token' in every webhook request, 1-256 characters. Only characters :code:`A-Z`, :code:`a-z`, :code:`0-9`, :code:`_` and :code:`-` are allowed. The header is useful to ensure that the request comes from a webhook set by you.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + url: str, + certificate: Optional[InputFile] = None, + ip_address: Optional[str] = None, + max_connections: Optional[int] = None, + allowed_updates: Optional[List[str]] = None, + drop_pending_updates: Optional[bool] = None, + secret_token: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + url=url, + certificate=certificate, + ip_address=ip_address, + max_connections=max_connections, + allowed_updates=allowed_updates, + drop_pending_updates=drop_pending_updates, + secret_token=secret_token, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/stop_message_live_location.py b/env/Lib/site-packages/aiogram/methods/stop_message_live_location.py new file mode 100644 index 0000000..f5fe335 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/stop_message_live_location.py @@ -0,0 +1,55 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import InlineKeyboardMarkup, Message +from .base import TelegramMethod + + +class StopMessageLiveLocation(TelegramMethod[Union[Message, bool]]): + """ + Use this method to stop updating a live location message before *live_period* expires. On success, if the message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. + + Source: https://core.telegram.org/bots/api#stopmessagelivelocation + """ + + __returning__ = Union[Message, bool] + __api_method__ = "stopMessageLiveLocation" + + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message to be edited was sent""" + chat_id: Optional[Union[int, str]] = None + """Required if *inline_message_id* is not specified. Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + message_id: Optional[int] = None + """Required if *inline_message_id* is not specified. Identifier of the message with live location to stop""" + inline_message_id: Optional[str] = None + """Required if *chat_id* and *message_id* are not specified. Identifier of the inline message""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """A JSON-serialized object for a new `inline keyboard `_.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + business_connection_id: Optional[str] = None, + chat_id: Optional[Union[int, str]] = None, + message_id: Optional[int] = None, + inline_message_id: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + business_connection_id=business_connection_id, + chat_id=chat_id, + message_id=message_id, + inline_message_id=inline_message_id, + reply_markup=reply_markup, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/stop_poll.py b/env/Lib/site-packages/aiogram/methods/stop_poll.py new file mode 100644 index 0000000..8393a52 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/stop_poll.py @@ -0,0 +1,51 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..types import InlineKeyboardMarkup, Poll +from .base import TelegramMethod + + +class StopPoll(TelegramMethod[Poll]): + """ + Use this method to stop a poll which was sent by the bot. On success, the stopped :class:`aiogram.types.poll.Poll` is returned. + + Source: https://core.telegram.org/bots/api#stoppoll + """ + + __returning__ = Poll + __api_method__ = "stopPoll" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + message_id: int + """Identifier of the original message with the poll""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message to be edited was sent""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """A JSON-serialized object for a new message `inline keyboard `_.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + message_id: int, + business_connection_id: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + message_id=message_id, + business_connection_id=business_connection_id, + reply_markup=reply_markup, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/unban_chat_member.py b/env/Lib/site-packages/aiogram/methods/unban_chat_member.py new file mode 100644 index 0000000..1094db5 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/unban_chat_member.py @@ -0,0 +1,46 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from .base import TelegramMethod + + +class UnbanChatMember(TelegramMethod[bool]): + """ + Use this method to unban a previously banned user in a supergroup or channel. The user will **not** return to the group or channel automatically, but will be able to join via link, etc. The bot must be an administrator for this to work. By default, this method guarantees that after the call the user is not a member of the chat, but will be able to join it. So if the user is a member of the chat they will also be **removed** from the chat. If you don't want this, use the parameter *only_if_banned*. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unbanchatmember + """ + + __returning__ = bool + __api_method__ = "unbanChatMember" + + chat_id: Union[int, str] + """Unique identifier for the target group or username of the target supergroup or channel (in the format :code:`@channelusername`)""" + user_id: int + """Unique identifier of the target user""" + only_if_banned: Optional[bool] = None + """Do nothing if the user is not banned""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + user_id: int, + only_if_banned: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + user_id=user_id, + only_if_banned=only_if_banned, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/unban_chat_sender_chat.py b/env/Lib/site-packages/aiogram/methods/unban_chat_sender_chat.py new file mode 100644 index 0000000..b981698 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/unban_chat_sender_chat.py @@ -0,0 +1,38 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class UnbanChatSenderChat(TelegramMethod[bool]): + """ + Use this method to unban a previously banned channel chat in a supergroup or channel. The bot must be an administrator for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unbanchatsenderchat + """ + + __returning__ = bool + __api_method__ = "unbanChatSenderChat" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + sender_chat_id: int + """Unique identifier of the target sender chat""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + sender_chat_id: int, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, sender_chat_id=sender_chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/unhide_general_forum_topic.py b/env/Lib/site-packages/aiogram/methods/unhide_general_forum_topic.py new file mode 100644 index 0000000..a9149bc --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/unhide_general_forum_topic.py @@ -0,0 +1,32 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class UnhideGeneralForumTopic(TelegramMethod[bool]): + """ + Use this method to unhide the 'General' topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the *can_manage_topics* administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unhidegeneralforumtopic + """ + + __returning__ = bool + __api_method__ = "unhideGeneralForumTopic" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/unpin_all_chat_messages.py b/env/Lib/site-packages/aiogram/methods/unpin_all_chat_messages.py new file mode 100644 index 0000000..aca090f --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/unpin_all_chat_messages.py @@ -0,0 +1,32 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class UnpinAllChatMessages(TelegramMethod[bool]): + """ + Use this method to clear the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' administrator right in a supergroup or 'can_edit_messages' administrator right in a channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unpinallchatmessages + """ + + __returning__ = bool + __api_method__ = "unpinAllChatMessages" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/unpin_all_forum_topic_messages.py b/env/Lib/site-packages/aiogram/methods/unpin_all_forum_topic_messages.py new file mode 100644 index 0000000..f1350ec --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/unpin_all_forum_topic_messages.py @@ -0,0 +1,40 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramMethod + + +class UnpinAllForumTopicMessages(TelegramMethod[bool]): + """ + Use this method to clear the list of pinned messages in a forum topic. The bot must be an administrator in the chat for this to work and must have the *can_pin_messages* administrator right in the supergroup. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unpinallforumtopicmessages + """ + + __returning__ = bool + __api_method__ = "unpinAllForumTopicMessages" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + message_thread_id: int + """Unique identifier for the target message thread of the forum topic""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + message_thread_id: int, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, message_thread_id=message_thread_id, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/methods/unpin_all_general_forum_topic_messages.py b/env/Lib/site-packages/aiogram/methods/unpin_all_general_forum_topic_messages.py new file mode 100644 index 0000000..be76c19 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/unpin_all_general_forum_topic_messages.py @@ -0,0 +1,30 @@ +from typing import TYPE_CHECKING, Any, Union + +from aiogram.methods import TelegramMethod + + +class UnpinAllGeneralForumTopicMessages(TelegramMethod[bool]): + """ + Use this method to clear the list of pinned messages in a General forum topic. The bot must be an administrator in the chat for this to work and must have the *can_pin_messages* administrator right in the supergroup. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unpinallgeneralforumtopicmessages + """ + + __returning__ = bool + __api_method__ = "unpinAllGeneralForumTopicMessages" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat_id: Union[int, str], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat_id=chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/methods/unpin_chat_message.py b/env/Lib/site-packages/aiogram/methods/unpin_chat_message.py new file mode 100644 index 0000000..249aee6 --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/unpin_chat_message.py @@ -0,0 +1,46 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from .base import TelegramMethod + + +class UnpinChatMessage(TelegramMethod[bool]): + """ + Use this method to remove a message from the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' administrator right in a supergroup or 'can_edit_messages' administrator right in a channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unpinchatmessage + """ + + __returning__ = bool + __api_method__ = "unpinChatMessage" + + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)""" + business_connection_id: Optional[str] = None + """Unique identifier of the business connection on behalf of which the message will be unpinned""" + message_id: Optional[int] = None + """Identifier of the message to unpin. Required if *business_connection_id* is specified. If not specified, the most recent pinned message (by sending date) will be unpinned.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat_id: Union[int, str], + business_connection_id: Optional[str] = None, + message_id: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat_id=chat_id, + business_connection_id=business_connection_id, + message_id=message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/methods/upload_sticker_file.py b/env/Lib/site-packages/aiogram/methods/upload_sticker_file.py new file mode 100644 index 0000000..600f83a --- /dev/null +++ b/env/Lib/site-packages/aiogram/methods/upload_sticker_file.py @@ -0,0 +1,47 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from ..types import File, InputFile +from .base import TelegramMethod + + +class UploadStickerFile(TelegramMethod[File]): + """ + Use this method to upload a file with a sticker for later use in the :class:`aiogram.methods.create_new_sticker_set.CreateNewStickerSet`, :class:`aiogram.methods.add_sticker_to_set.AddStickerToSet`, or :class:`aiogram.methods.replace_sticker_in_set.ReplaceStickerInSet` methods (the file can be used multiple times). Returns the uploaded :class:`aiogram.types.file.File` on success. + + Source: https://core.telegram.org/bots/api#uploadstickerfile + """ + + __returning__ = File + __api_method__ = "uploadStickerFile" + + user_id: int + """User identifier of sticker file owner""" + sticker: InputFile + """A file with the sticker in .WEBP, .PNG, .TGS, or .WEBM format. See `https://core.telegram.org/stickers `_`https://core.telegram.org/stickers `_ for technical requirements. :ref:`More information on Sending Files » `""" + sticker_format: str + """Format of the sticker, must be one of 'static', 'animated', 'video'""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + user_id: int, + sticker: InputFile, + sticker_format: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + user_id=user_id, + sticker=sticker, + sticker_format=sticker_format, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/py.typed b/env/Lib/site-packages/aiogram/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/aiogram/types/__init__.py b/env/Lib/site-packages/aiogram/types/__init__.py new file mode 100644 index 0000000..97442b3 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/__init__.py @@ -0,0 +1,490 @@ +from typing import List, Literal, Optional, Union + +from .animation import Animation +from .audio import Audio +from .background_fill import BackgroundFill +from .background_fill_freeform_gradient import BackgroundFillFreeformGradient +from .background_fill_gradient import BackgroundFillGradient +from .background_fill_solid import BackgroundFillSolid +from .background_type import BackgroundType +from .background_type_chat_theme import BackgroundTypeChatTheme +from .background_type_fill import BackgroundTypeFill +from .background_type_pattern import BackgroundTypePattern +from .background_type_wallpaper import BackgroundTypeWallpaper +from .base import UNSET_PARSE_MODE, TelegramObject +from .birthdate import Birthdate +from .bot_command import BotCommand +from .bot_command_scope import BotCommandScope +from .bot_command_scope_all_chat_administrators import ( + BotCommandScopeAllChatAdministrators, +) +from .bot_command_scope_all_group_chats import BotCommandScopeAllGroupChats +from .bot_command_scope_all_private_chats import BotCommandScopeAllPrivateChats +from .bot_command_scope_chat import BotCommandScopeChat +from .bot_command_scope_chat_administrators import BotCommandScopeChatAdministrators +from .bot_command_scope_chat_member import BotCommandScopeChatMember +from .bot_command_scope_default import BotCommandScopeDefault +from .bot_description import BotDescription +from .bot_name import BotName +from .bot_short_description import BotShortDescription +from .business_connection import BusinessConnection +from .business_intro import BusinessIntro +from .business_location import BusinessLocation +from .business_messages_deleted import BusinessMessagesDeleted +from .business_opening_hours import BusinessOpeningHours +from .business_opening_hours_interval import BusinessOpeningHoursInterval +from .callback_game import CallbackGame +from .callback_query import CallbackQuery +from .chat import Chat +from .chat_administrator_rights import ChatAdministratorRights +from .chat_background import ChatBackground +from .chat_boost import ChatBoost +from .chat_boost_added import ChatBoostAdded +from .chat_boost_removed import ChatBoostRemoved +from .chat_boost_source import ChatBoostSource +from .chat_boost_source_gift_code import ChatBoostSourceGiftCode +from .chat_boost_source_giveaway import ChatBoostSourceGiveaway +from .chat_boost_source_premium import ChatBoostSourcePremium +from .chat_boost_updated import ChatBoostUpdated +from .chat_full_info import ChatFullInfo +from .chat_invite_link import ChatInviteLink +from .chat_join_request import ChatJoinRequest +from .chat_location import ChatLocation +from .chat_member import ChatMember +from .chat_member_administrator import ChatMemberAdministrator +from .chat_member_banned import ChatMemberBanned +from .chat_member_left import ChatMemberLeft +from .chat_member_member import ChatMemberMember +from .chat_member_owner import ChatMemberOwner +from .chat_member_restricted import ChatMemberRestricted +from .chat_member_updated import ChatMemberUpdated +from .chat_permissions import ChatPermissions +from .chat_photo import ChatPhoto +from .chat_shared import ChatShared +from .chosen_inline_result import ChosenInlineResult +from .contact import Contact +from .custom import DateTime +from .dice import Dice +from .document import Document +from .downloadable import Downloadable +from .encrypted_credentials import EncryptedCredentials +from .encrypted_passport_element import EncryptedPassportElement +from .error_event import ErrorEvent +from .external_reply_info import ExternalReplyInfo +from .file import File +from .force_reply import ForceReply +from .forum_topic import ForumTopic +from .forum_topic_closed import ForumTopicClosed +from .forum_topic_created import ForumTopicCreated +from .forum_topic_edited import ForumTopicEdited +from .forum_topic_reopened import ForumTopicReopened +from .game import Game +from .game_high_score import GameHighScore +from .general_forum_topic_hidden import GeneralForumTopicHidden +from .general_forum_topic_unhidden import GeneralForumTopicUnhidden +from .giveaway import Giveaway +from .giveaway_completed import GiveawayCompleted +from .giveaway_created import GiveawayCreated +from .giveaway_winners import GiveawayWinners +from .inaccessible_message import InaccessibleMessage +from .inline_keyboard_button import InlineKeyboardButton +from .inline_keyboard_markup import InlineKeyboardMarkup +from .inline_query import InlineQuery +from .inline_query_result import InlineQueryResult +from .inline_query_result_article import InlineQueryResultArticle +from .inline_query_result_audio import InlineQueryResultAudio +from .inline_query_result_cached_audio import InlineQueryResultCachedAudio +from .inline_query_result_cached_document import InlineQueryResultCachedDocument +from .inline_query_result_cached_gif import InlineQueryResultCachedGif +from .inline_query_result_cached_mpeg4_gif import InlineQueryResultCachedMpeg4Gif +from .inline_query_result_cached_photo import InlineQueryResultCachedPhoto +from .inline_query_result_cached_sticker import InlineQueryResultCachedSticker +from .inline_query_result_cached_video import InlineQueryResultCachedVideo +from .inline_query_result_cached_voice import InlineQueryResultCachedVoice +from .inline_query_result_contact import InlineQueryResultContact +from .inline_query_result_document import InlineQueryResultDocument +from .inline_query_result_game import InlineQueryResultGame +from .inline_query_result_gif import InlineQueryResultGif +from .inline_query_result_location import InlineQueryResultLocation +from .inline_query_result_mpeg4_gif import InlineQueryResultMpeg4Gif +from .inline_query_result_photo import InlineQueryResultPhoto +from .inline_query_result_venue import InlineQueryResultVenue +from .inline_query_result_video import InlineQueryResultVideo +from .inline_query_result_voice import InlineQueryResultVoice +from .inline_query_results_button import InlineQueryResultsButton +from .input_contact_message_content import InputContactMessageContent +from .input_file import BufferedInputFile, FSInputFile, InputFile, URLInputFile +from .input_invoice_message_content import InputInvoiceMessageContent +from .input_location_message_content import InputLocationMessageContent +from .input_media import InputMedia +from .input_media_animation import InputMediaAnimation +from .input_media_audio import InputMediaAudio +from .input_media_document import InputMediaDocument +from .input_media_photo import InputMediaPhoto +from .input_media_video import InputMediaVideo +from .input_message_content import InputMessageContent +from .input_paid_media import InputPaidMedia +from .input_paid_media_photo import InputPaidMediaPhoto +from .input_paid_media_video import InputPaidMediaVideo +from .input_poll_option import InputPollOption +from .input_sticker import InputSticker +from .input_text_message_content import InputTextMessageContent +from .input_venue_message_content import InputVenueMessageContent +from .invoice import Invoice +from .keyboard_button import KeyboardButton +from .keyboard_button_poll_type import KeyboardButtonPollType +from .keyboard_button_request_chat import KeyboardButtonRequestChat +from .keyboard_button_request_user import KeyboardButtonRequestUser +from .keyboard_button_request_users import KeyboardButtonRequestUsers +from .labeled_price import LabeledPrice +from .link_preview_options import LinkPreviewOptions +from .location import Location +from .login_url import LoginUrl +from .mask_position import MaskPosition +from .maybe_inaccessible_message import MaybeInaccessibleMessage +from .menu_button import MenuButton +from .menu_button_commands import MenuButtonCommands +from .menu_button_default import MenuButtonDefault +from .menu_button_web_app import MenuButtonWebApp +from .message import ContentType, Message +from .message_auto_delete_timer_changed import MessageAutoDeleteTimerChanged +from .message_entity import MessageEntity +from .message_id import MessageId +from .message_origin import MessageOrigin +from .message_origin_channel import MessageOriginChannel +from .message_origin_chat import MessageOriginChat +from .message_origin_hidden_user import MessageOriginHiddenUser +from .message_origin_user import MessageOriginUser +from .message_reaction_count_updated import MessageReactionCountUpdated +from .message_reaction_updated import MessageReactionUpdated +from .order_info import OrderInfo +from .paid_media import PaidMedia +from .paid_media_info import PaidMediaInfo +from .paid_media_photo import PaidMediaPhoto +from .paid_media_preview import PaidMediaPreview +from .paid_media_video import PaidMediaVideo +from .passport_data import PassportData +from .passport_element_error import PassportElementError +from .passport_element_error_data_field import PassportElementErrorDataField +from .passport_element_error_file import PassportElementErrorFile +from .passport_element_error_files import PassportElementErrorFiles +from .passport_element_error_front_side import PassportElementErrorFrontSide +from .passport_element_error_reverse_side import PassportElementErrorReverseSide +from .passport_element_error_selfie import PassportElementErrorSelfie +from .passport_element_error_translation_file import PassportElementErrorTranslationFile +from .passport_element_error_translation_files import ( + PassportElementErrorTranslationFiles, +) +from .passport_element_error_unspecified import PassportElementErrorUnspecified +from .passport_file import PassportFile +from .photo_size import PhotoSize +from .poll import Poll +from .poll_answer import PollAnswer +from .poll_option import PollOption +from .pre_checkout_query import PreCheckoutQuery +from .proximity_alert_triggered import ProximityAlertTriggered +from .reaction_count import ReactionCount +from .reaction_type import ReactionType +from .reaction_type_custom_emoji import ReactionTypeCustomEmoji +from .reaction_type_emoji import ReactionTypeEmoji +from .reaction_type_paid import ReactionTypePaid +from .refunded_payment import RefundedPayment +from .reply_keyboard_markup import ReplyKeyboardMarkup +from .reply_keyboard_remove import ReplyKeyboardRemove +from .reply_parameters import ReplyParameters +from .response_parameters import ResponseParameters +from .revenue_withdrawal_state import RevenueWithdrawalState +from .revenue_withdrawal_state_failed import RevenueWithdrawalStateFailed +from .revenue_withdrawal_state_pending import RevenueWithdrawalStatePending +from .revenue_withdrawal_state_succeeded import RevenueWithdrawalStateSucceeded +from .sent_web_app_message import SentWebAppMessage +from .shared_user import SharedUser +from .shipping_address import ShippingAddress +from .shipping_option import ShippingOption +from .shipping_query import ShippingQuery +from .star_transaction import StarTransaction +from .star_transactions import StarTransactions +from .sticker import Sticker +from .sticker_set import StickerSet +from .story import Story +from .successful_payment import SuccessfulPayment +from .switch_inline_query_chosen_chat import SwitchInlineQueryChosenChat +from .text_quote import TextQuote +from .transaction_partner import TransactionPartner +from .transaction_partner_fragment import TransactionPartnerFragment +from .transaction_partner_other import TransactionPartnerOther +from .transaction_partner_telegram_ads import TransactionPartnerTelegramAds +from .transaction_partner_user import TransactionPartnerUser +from .update import Update +from .user import User +from .user_chat_boosts import UserChatBoosts +from .user_profile_photos import UserProfilePhotos +from .user_shared import UserShared +from .users_shared import UsersShared +from .venue import Venue +from .video import Video +from .video_chat_ended import VideoChatEnded +from .video_chat_participants_invited import VideoChatParticipantsInvited +from .video_chat_scheduled import VideoChatScheduled +from .video_chat_started import VideoChatStarted +from .video_note import VideoNote +from .voice import Voice +from .web_app_data import WebAppData +from .web_app_info import WebAppInfo +from .webhook_info import WebhookInfo +from .write_access_allowed import WriteAccessAllowed + +__all__ = ( + "Animation", + "Audio", + "BackgroundFill", + "BackgroundFillFreeformGradient", + "BackgroundFillGradient", + "BackgroundFillSolid", + "BackgroundType", + "BackgroundTypeChatTheme", + "BackgroundTypeFill", + "BackgroundTypePattern", + "BackgroundTypeWallpaper", + "Birthdate", + "BotCommand", + "BotCommandScope", + "BotCommandScopeAllChatAdministrators", + "BotCommandScopeAllGroupChats", + "BotCommandScopeAllPrivateChats", + "BotCommandScopeChat", + "BotCommandScopeChatAdministrators", + "BotCommandScopeChatMember", + "BotCommandScopeDefault", + "BotDescription", + "BotName", + "BotShortDescription", + "BufferedInputFile", + "BusinessConnection", + "BusinessIntro", + "BusinessLocation", + "BusinessMessagesDeleted", + "BusinessOpeningHours", + "BusinessOpeningHoursInterval", + "CallbackGame", + "CallbackQuery", + "Chat", + "ChatAdministratorRights", + "ChatBackground", + "ChatBoost", + "ChatBoostAdded", + "ChatBoostRemoved", + "ChatBoostSource", + "ChatBoostSourceGiftCode", + "ChatBoostSourceGiveaway", + "ChatBoostSourcePremium", + "ChatBoostUpdated", + "ChatFullInfo", + "ChatInviteLink", + "ChatJoinRequest", + "ChatLocation", + "ChatMember", + "ChatMemberAdministrator", + "ChatMemberBanned", + "ChatMemberLeft", + "ChatMemberMember", + "ChatMemberOwner", + "ChatMemberRestricted", + "ChatMemberUpdated", + "ChatPermissions", + "ChatPhoto", + "ChatShared", + "ChosenInlineResult", + "Contact", + "ContentType", + "DateTime", + "Dice", + "Document", + "Downloadable", + "EncryptedCredentials", + "EncryptedPassportElement", + "ErrorEvent", + "ExternalReplyInfo", + "FSInputFile", + "File", + "ForceReply", + "ForumTopic", + "ForumTopicClosed", + "ForumTopicCreated", + "ForumTopicEdited", + "ForumTopicReopened", + "Game", + "GameHighScore", + "GeneralForumTopicHidden", + "GeneralForumTopicUnhidden", + "Giveaway", + "GiveawayCompleted", + "GiveawayCreated", + "GiveawayWinners", + "InaccessibleMessage", + "InlineKeyboardButton", + "InlineKeyboardMarkup", + "InlineQuery", + "InlineQueryResult", + "InlineQueryResultArticle", + "InlineQueryResultAudio", + "InlineQueryResultCachedAudio", + "InlineQueryResultCachedDocument", + "InlineQueryResultCachedGif", + "InlineQueryResultCachedMpeg4Gif", + "InlineQueryResultCachedPhoto", + "InlineQueryResultCachedSticker", + "InlineQueryResultCachedVideo", + "InlineQueryResultCachedVoice", + "InlineQueryResultContact", + "InlineQueryResultDocument", + "InlineQueryResultGame", + "InlineQueryResultGif", + "InlineQueryResultLocation", + "InlineQueryResultMpeg4Gif", + "InlineQueryResultPhoto", + "InlineQueryResultVenue", + "InlineQueryResultVideo", + "InlineQueryResultVoice", + "InlineQueryResultsButton", + "InputContactMessageContent", + "InputFile", + "InputInvoiceMessageContent", + "InputLocationMessageContent", + "InputMedia", + "InputMediaAnimation", + "InputMediaAudio", + "InputMediaDocument", + "InputMediaPhoto", + "InputMediaVideo", + "InputMessageContent", + "InputPaidMedia", + "InputPaidMediaPhoto", + "InputPaidMediaVideo", + "InputPollOption", + "InputSticker", + "InputTextMessageContent", + "InputVenueMessageContent", + "Invoice", + "KeyboardButton", + "KeyboardButtonPollType", + "KeyboardButtonRequestChat", + "KeyboardButtonRequestUser", + "KeyboardButtonRequestUsers", + "LabeledPrice", + "LinkPreviewOptions", + "Location", + "LoginUrl", + "MaskPosition", + "MaybeInaccessibleMessage", + "MenuButton", + "MenuButtonCommands", + "MenuButtonDefault", + "MenuButtonWebApp", + "Message", + "MessageAutoDeleteTimerChanged", + "MessageEntity", + "MessageId", + "MessageOrigin", + "MessageOriginChannel", + "MessageOriginChat", + "MessageOriginHiddenUser", + "MessageOriginUser", + "MessageReactionCountUpdated", + "MessageReactionUpdated", + "OrderInfo", + "PaidMedia", + "PaidMediaInfo", + "PaidMediaPhoto", + "PaidMediaPreview", + "PaidMediaVideo", + "PassportData", + "PassportElementError", + "PassportElementErrorDataField", + "PassportElementErrorFile", + "PassportElementErrorFiles", + "PassportElementErrorFrontSide", + "PassportElementErrorReverseSide", + "PassportElementErrorSelfie", + "PassportElementErrorTranslationFile", + "PassportElementErrorTranslationFiles", + "PassportElementErrorUnspecified", + "PassportFile", + "PhotoSize", + "Poll", + "PollAnswer", + "PollOption", + "PreCheckoutQuery", + "ProximityAlertTriggered", + "ReactionCount", + "ReactionType", + "ReactionTypeCustomEmoji", + "ReactionTypeEmoji", + "ReactionTypePaid", + "RefundedPayment", + "ReplyKeyboardMarkup", + "ReplyKeyboardRemove", + "ReplyParameters", + "ResponseParameters", + "RevenueWithdrawalState", + "RevenueWithdrawalStateFailed", + "RevenueWithdrawalStatePending", + "RevenueWithdrawalStateSucceeded", + "SentWebAppMessage", + "SharedUser", + "ShippingAddress", + "ShippingOption", + "ShippingQuery", + "StarTransaction", + "StarTransactions", + "Sticker", + "StickerSet", + "Story", + "SuccessfulPayment", + "SwitchInlineQueryChosenChat", + "TelegramObject", + "TextQuote", + "TransactionPartner", + "TransactionPartnerFragment", + "TransactionPartnerOther", + "TransactionPartnerTelegramAds", + "TransactionPartnerUser", + "UNSET_PARSE_MODE", + "URLInputFile", + "Update", + "User", + "UserChatBoosts", + "UserProfilePhotos", + "UserShared", + "UsersShared", + "Venue", + "Video", + "VideoChatEnded", + "VideoChatParticipantsInvited", + "VideoChatScheduled", + "VideoChatStarted", + "VideoNote", + "Voice", + "WebAppData", + "WebAppInfo", + "WebhookInfo", + "WriteAccessAllowed", +) + +# Load typing forward refs for every TelegramObject +for _entity_name in __all__: + _entity = globals()[_entity_name] + if not hasattr(_entity, "model_rebuild"): + continue + _entity.model_rebuild( + _types_namespace={ + "List": List, + "Optional": Optional, + "Union": Union, + "Literal": Literal, + **{k: v for k, v in globals().items() if k in __all__}, + } + ) + +del _entity +del _entity_name diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a2b9a113fe31a23eef63758b87fc3a8abcd62471 GIT binary patch literal 20805 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/animation.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/animation.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a9479f97bc8b6d07db2ceaf020f06322ee3788ff GIT binary patch literal 2127 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/background_fill_freeform_gradient.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/background_fill_freeform_gradient.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f375c71575837b836104ce7aaff64c76a91319eb GIT binary patch literal 1671 zcma)6&2Jk;6rb5$uRmg^G$BPTAKC(?GN^WixDW-@k|ri3ijY!-SXqoVJ7Z_bewdkc zz*P=8R3bfgkb#q?XRt04215hO*V2v=3o(+8;Bx`eH36D2b!$~x~&I>ZD2$-s{6UXv`vgO z)Iij@ifE3Rw{?W>z#0rYPt7${%|B4vsv#?vKX`Y6%)h-bzr3{Ckov{2CyfiN_4;tK|9t-0uKb0&Pmp7QTewe7`3CposLshFi)V1ObC$@MLJ23-= z7T{#DEyjCRz=Uwx%<@9eVU`PewNmPME$VWY%~~6A+!3?&x*Ks;ic|1EN*|{|0UWZB3jr@puqI#~TmbSlz5$1ECWn*Tu&WSNAMGcKlvNdwN8&u!*y5AJ|5dzmdpuI7UzNdv4fHmsPgO=3!gWxHTKHS^vlb) zUi@JTK5D-H&X5^w%gYB~gQ^t;OXviQ5LqH5h-lYWe3_7syN*AU2k)7O^z#th86#>~DE-pfCk zpkuieoJ^uu7jTlFC<2d0sEMXe^-rDKo2m_k1vGQ=o9XLINio$bq36#e6DeCplT%4$ z#CFur|KW>iB!hTHD1RzTezjVVCUgn3)d+$LRXzaxFTKMHnI%82xYUut^HE`LP{ud; sY1k^DMGr`#V~qFFYyJP4_s}c-@tK%UV};#6(_0_@mP&sA7kL`mpB~`7;s5{u literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/background_fill_gradient.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/background_fill_gradient.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2444fa83fd0e45011c765997128d42e15f843bbb GIT binary patch literal 1644 zcma)6&2Jk;6rb6h-Sv0CNt!k#WZO~|r>cG60E#LEO@e_|7E)RvRu-d;XY4Ln@0!^) zkje)mRU$}$xS&>$BPv3@^H*?iq#Razs>G?cMd1KF@y1_CAV`d7-o7{Q?elxT_p^V> z=Q9Y_FF*X+{9Z%oH)%{3*u!;r10D|$Lkzp9jV;_(ETyelDn?9Us!Q6MrD3F?Dq`e5 zVj9;TsR%uWGg_9;^i5PUo=UT%#`)VHythHu-riWd`A)4Gt8aQcv2n`@xv<@*SjOPE zaKmnFw}jvI*jtY4Hb$97GCwvB_dxjqO5@1F3|Yz@DA7`xViB$}<=pfgt~2#ISZTx! z(8)1fJErSnJtdZ*F=G!i^<*AKxB=}MOox-=X_jW0W^NZXG0WaBSeae)8Md;UX!0!O z;xi}vs0y1o+zamo857p+yWHHGHflP7X`8Kah}nd`%b8)^rr#9}zG~hL!%nbTsWg1S z%OQ6;1h>n+XjQiSFsRra=h9I+`Tiu?FiV`8m@x@=Iy_E?eup-E*B5aP5`=zxY!!qb z+M(ln)b?5~FJX}d_~Mu8>D^G;*rHA z`(nGk<}=4@)wjFC4t+rZz&iInso!$8>H(1XS_cMew|G#u9be9=A~6ptM+2gALUb~d za%V@(!S~!-J{{!pq>n`i3f=|rXCEbtD8Kae#+TKvst36j5~Sw~(fqk+@lv!@ik7b> zX}B2PCK)vQQj(pTGIHdQ+96~^z*fM@v)i1~I74aMXI)q7IZ8k7+V0q6P|Ezq1UUI8 z5zkQIi8rPU;1#Qm7Yh0N7jo{yw&MI4&IX63DNyPRxB@xlH^hRBN>79?9e;s<29G|8 zLbOzZq{yKQSNrR`SH4|2$Se)W3haHd5|P)UnPR`zuYF#N$g5Ften8~jC-V_mjph~x zMDBgE5RsctjJX6YXoaMJO0OiwY#Pv*3LVWZK3q8{ULHA8=3CKwH#V9 zlf2Xl=;GyMMrzNYLNR$>YDcO5hnALQ3~QMRadv`54OpuKae!&Z03D(J4<-r8(h-V9 zsSR^TWS^z3k7oJ0xCo|%Ja9lHD#kcM<-vdNC+OOSuX<*7XJrMet6slX@1x)Qz1P2$ z%LN4M&!7Kl{--1KN(sYd4w&tWz&t?|Q5>Q+c5z#CwYKi+7*UPtq0u&76C(}HA!^)5 z)MVy!i1h+af4LU5mXKq=R-&WJ^40IYoh37uXJ@{dU!0TrSJA4puLKF>Uica-8!Rgq zJ%6Re<8DO14#LpyN9xo3K-gXb<^iO}kc%mDwQG=~t5eN2m`SxycYK&d^>ZNQ5wn3e z27Hbmg96NFnCg4&sljY&u{^bDu9;g$O-%FmD{f&O-N9~g2@T&)K_1+j=TaO7^lqUiV|p zY6)1jxYw@5yj5S06H)g%!O7k5Dzs1^&q7EuG+VG0UA;dqJ*pekQ<7q%w>51md~Il0#h*#w?g&m0zagz)bEuM)ot+)5GZ5! zNj1aFrAUzy`h2o?X?^O)sm;RC4PyfK-^Rq2ab~Mn=`HjY?k#K?=U>|6DLP;-;Ix9i zIF;JPJg{hlTIk@>r&F6_CkDD48b6ZeGlK#;F_{)KwuCBUX?etLG{nd7`7DQiCL@%q zW@Y6rI<~Z+_b@CYnDv2uZy2~ebmE^VE{mbSdzU-cZ`XNV1yP|Y1dvq67;mB4#)tPy a^yS9hom$7R!fJo|wDu;`y#0VaOX`1hR){+Q literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/background_type.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/background_type.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..153c9610de8eb8958a5f1e9737880bd1a5985ead GIT binary patch literal 971 zcmb7@F^|(Q6oBodg%a*MFe7A%sS=m$6=I+W2G9YzN+(qjt`oayXd35i2h@#$AHa44 zI|#A!8yFZEQCB9mqB7mYbJAYb!qS)I<@x#fv-94|$HPMpfqZ%YZFJK?=%*d5rMWVe zJ{aeSBaSmP#RH6ygB~I7yhYp<_=AhkXLxEEIJ|L!I?Z1g#vMFw_eCZW#imcAmm)Ut zI?ldrh?V6HQ0GXX0p4(tCW|(SRj!UZjd_dGoJ|F#bC1%g z6zY{P1wXpOvJ`0p-D26OAyu|NjA$WhFx(sh|NIJ+f_5$nf@57 zYt#vQ7$M*a8oWpX=HNjhl8Yz*3J)vnVJSQWJmuE1IY>^v>Y3S@6&HL{_4@bf)qDNw z_p0ZoTFpivzkdH)`-*|kpURksIR^VT06ahxQ5>NddpOoSE!I69BdSq7GGfy+G1AZq zqQ*T$O=dpU5qbi1BwmS@n#i@DDbv+uZT;g9mdVn)%S-RSx4I(r>&ZY`w?e_VA3eir z50>*c{Gi+6X+NRsgB}Y;nMS%YHukpwdW3+K@2NV{VG@$ z#4NzZ7?=4OIDq*GQ~mIMYA}nIScO`&+%9jUHl~$(^PatpKF8i%6HT73Enhxd=hCJx z);C$q?%uZ@5WvpH!AYDjbA;bzi9q-s0?+x$k0st zJYb8?rVzbsvC#-p&gz0iti%1dp7Ks(BNbW0?}g{4FA|C}$W$aM(nwp`q*#!K@=Log zNaDxL#e5Fs1y|A_BnxL61-jK1n>MP0lK5kDhWlV;ZMF)qu5gh?m} zaZR}}Qya-x)Fxya#A^^KD})4*pJjw(>Qbx53}3WvF19{OdAGHc(lF_?x_$18loOz{ z#gb23x5AB92AA?u5BleKSl05xRFU3L>}8E9+e9spDZlmJfG@y%?m9=XS)Y`D3U+0e zLH#{M`6*O;^_%6dR=!@@t)AVfHh*~ImqmD}as9(F7@5`PKExoms)$hiBShMS#3}7Z z3RemFr0+*#k3|Sgg9$5&0C|iMKS@&Ii!e=q7O7`~bM?V;_!mG$^|Cf*EnrauOk;i$ zT$yUxHU5&?rM|;LskUc-fP!O8f4OFuK! zK3BjhnqSCkGhwqS{tvDcHH<2m(OfmFIPR)z$rAJ&Zp{p5BVzw`E4VcY;>Q&#awzg% xl&_B3^$vHyRIFwhs9eVw@1gq6(c>w)uyc6ir88J@_22qo@>k(`euTd$>K_ACna}_L literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/background_type_fill.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/background_type_fill.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2b6a97d069451753580eb5d7499f12c7eadfd2d8 GIT binary patch literal 1994 zcmbVN&2Jk;6rb50f5smnO$t?-U{X-EYKc!A2o);L7tktvBn7c`HQnrt-6i{BX4lX} zIpk1@A^{QyR3v)ffC{MhUik+&I1&eIPLVkEW)u!6C*JJZaqJ=?F`j+<=DoMG^M1eg z);|@Cc?9F}_rKNeq!Ic3MwhF#=g6Jw=ouIA~c?h%uCDKq7z%{16` zM%;{-HM1CTT};3_<>tJ+nU8&Gcg!o8g;>wHMXzL*Fw)Q}V%fWh<#_g?j?g2xl3|uv zejOQOPt?-Da?JAmAhIGS@I!;h;>JhsF4M&~mlvF zPM$1XvFxpe2wFbd*lu#zYj$8+aa?yra9$6Dw<;{=a6f{G)58%bJg0^|>w)VqJ2`S9 zNpi!7w?O$Eu;a+Y44K+>z|hp0W)i0J6eE|wpF=DKy4KUvpl1@Dr$v!zEc*bn(mhni zta!I%X6~Uo*vzh@{@p0ciNS$XdMcrvZ}Jrw8@G97^Emg46IQHN6nKE4ZMp7tr4FH- zK}ZNP@GB9-hur0M1Zz8R0};;W>Shpy zRjcWo8@w=r)2LU(J4m9`qjHa;8|T&X{7p$z)Y1DfVK)YutbjL$_F`q&*k@wYKFZ-u zsXKloCzvI+C?w`_${f#g{Dy(WGl0B&kq&n514n6dn^`^pM7KV(L?aZc4`f>Ks3m+! z)&if~s;tydrJ8|j3?Y1Y1(a{`eJJRt?+436xE{fkjE|2!Oxwk~+OE#<1AUkLh`)~8 z3d&tyGxYd)q72W7Nf5svLzAhn)#O5EDRq1&qSQ#si4%vVKwF*Cktf9zJT7yT+O8Fb zl!nmcNEJq9@92Z2h1!RK*s3iC3_z)EwS*M~f&z~X)m(7tVH( zRxEX<&ip{yuU_ryut+TL+!`!m%Rn5$KFG)?d5?phz&4>Yg`GI1gn}U^Qk+)WvmlI| z!qT^(EU3&=>IJOjD!oAICoRkEc`}r;!0rJn%aoq@2!U0#dYrK=_CU6|>jFDi%z!IY zd|wu`Dyq~MMdkPz1mr*Xbv2U8c99YVG;?lmsZHjRxliUgq}n01c0BhXy(;7rL4893c1qL{9AzZ*?q$Vk|!YnlY}hs<)sS04t#yK&F9y zD4+xj)h$9*nNW=(%Oh1Ha?1L`39Bj_TJL>-Db!c|0T$|iNj^6kckG6aLvm`=9jZ^U zD1a|P`;5}!!z%`kvX>H)Ul$i)si+Bm1<}t9@Pg8u+$PA-lB literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/background_type_pattern.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/background_type_pattern.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d05c75e70008bc3ab5c682b880d31d5c6e8aee19 GIT binary patch literal 2456 zcmbVN&2Jk;6rc5uzrWIak(9RDCLxK{Hdf&lRkYBiZq?QVk`{IAGFp4b&XWBwv+K60 zd@xca3IfCh6^R~E5$c`4f`fyQSnVki2h^KUkU%-{X4jtqA;kFY^Ka(OzM1#lZ)U$u zrxOU;_h0`|{V|TvFTB%h;Q$Exp8$A*RHO-(#280u`Z4SPIPfnj;JZ^Cq$c5)eJZL`k5N@nCm&_x z_+#`ykP{oI_n({grUt?A)T}EGq|$u&M?!+OxkaUNKXsC3ONz8!EJzlUHVe0;<=R87 zUZ<*LH_A43B&#ZI+$u=-HD^n@arMTURZO|KN;MyRYbaJy>TcCv}nJ zSW=lv70W1VCb;ySIHT)Vp;A(1%d)8{m3Jg=ZP=8pB>c^8SPfR8tJ0R^)a})LzG5-D z;!vH|m}0D0td=iZj-6NP+Wa6UzQgVgd?#MC+dCNVlIqSWP}^cyUnFv^8g^c#!Gw`%c-i^t)bCvx#Qj zqs*ZyOtgt%-P6okPGl3XM|PB}m-%j&$Y3W!WhSJ)qbjDORmk>zh1G1vuLCc_sMBDk zhl`d;EBp-c7J-M~BT0mW{VM>z6rR92c6xRgc?QpOc!KtR-=c<^LNnA9o46TnMpWTx zq#6B2_}sr^;H-B)rL{xtigsAHa7g7xKb(1G4YM2*j*8gyiDh_)rAIrh1i- ze|N-=fnP69NJUp{n-ClBL&T}hTkGKVrPb2A7TYdev{XoBX}iG`$6^GSQ=;a*(siv| zf>O{kbvPADjoKwevpB!z|7AyXL6A4DUSS{zr>NB_*srPeVC7U=6rsz;~bp;l}qw!n2JFO@e%~+r#5ts zQ-plbQ1q@PN(h{mZfU$MAwyR>jP|R{_+{xQ%1d`ERH3>Kl@{0nm~2j{3+xp>Ypkbu z4EC>}AZLSLCxpYX4&o|>q+IJ#8!rd4ixfIP3W*PzP_ZT}3aBMO4xqPg~{?4k4R|0a9rRC`qR#4#X-05yNRJt{7~&>j^R fueL|U#dGaZ=|s*7P^7=BuZq9%(ck~Uw)Dxs)C&?JP05Gp08!r3zN?l`H5KbEn# zCDk4x5s4xJH&mqdh>B3}{VOz&Q8=KScw_Hw5+Fii{O0++c{6Wke(yKl zAB)92g7*CJ&s(cmgnkoFrzxp{kE&oiLJTo%BM0jk3tO@!N7iMB=)_TU#mVRy7?&Bb zvyQ5(7@0E9fUnp&C$Hx*lF%|@nSI2vrutMy=o$31={-zcN9EiL;g)gKW4Nvt7=h)v zewjqYjgN0F(S`Sx7T&+Pwj9atxVuqy)e1~**pd2SUCcA=7dTy9x?$9Iwz=1E*~V_& zgmmhnS8F(?8`RRDOEpPf_-G%DFX4P9(lJB2^bwp>mzks!CYuT)*CC!mOaVL7wzFWX zZ9AuDSRVYIuAfc(Lh73;?`0Cp!Bc!9v;K!@3$woclAe2rKF4}~9d+L2f#~Adz27!$ zyKdA?{@{ze25sZ6sa3nD(=1;zwELYon&oN%Ojx;*nhL{DlxF4!{B3e8fW`7!SxI+%0oL(8 zp}Kqj36-Tt@f!eBq*7|RRzPW4jrvY)o%*J|Md`UY_z2DFq(4YZ3KQdg{XjqusJ{@i9rz ziHhyI)J)rk(qjH9gnU7rxA|*gR-vPSc*y@16u@-y#1c`|7ztHC<5%|jqRp*Fd9vqdITIUtiE`Q$J= z5TjwG6qnHSwK#*OXT#TL;@-g=VE+G9PGn0`b`{q;r(G)-1khUzxQYNY7a#v90~7<2 zrtpai$umO19}$Xr|HecvF6*h9CpcabW13I`+hg^5TFAHfG`IqE|1qdo#u$faymeL% s(VMORl0$T*byg1L3o*iYA|&Ijvl3^nU;yBs>U;NhG5W{9gp$qw1x(8N-2eap literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/base.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/base.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8199e4de370c50e3a1ed27e0bd261c976fc60b0d GIT binary patch literal 3030 zcmaJ@O>7&-6`o!Gh@vP_vVJ1lqOi6U$&4#HEeZ=s3OH75bYSzo$p}f}q zFf+TdB`5#`_>e;mDq7SEiUMkpC<*LC4oTo+FTM4!1au(w6tt(_Xvn?z)c1BNT2$%| zXWsn0H#6^j^WIy2)!m&WP=5H+Kg$1%6Y?*d92b}e<>;b7$RqLr(TFA(#1x8xDHcTm z=b{lYqs3@2ju0o+d7eGma2v?i~IM(?FtvosZGua>+93nHO?G<^ViK86;S;+cTo)#RtN z)G2;{!0&GHdrt8O0)D#1?>)sI4ETM>*UqevZ2!OU;;iULW~?ngIq~T(nCgFsFrvbJph@!Kn=Ri6!TW;9#x%!A5#p&zMt*z z(=MknwOkV+a4Gj=U^Y|y{w5++Ryfz!EfbLR<7H-VQ_JtI*cI1M94eQ#WJ@ur|C+)| zI_zUxva?m8Tn^5sn%||-GG%hf)eX&$muT5$6tIjU?0&p?XPi;TWtJ+o>>vca620%p z0P=`9E#D$!M{rI^9>DlE%{X{0j5oPg-eQb?1d=rQVAfC?o<>8z#|HGB*oGs zMk|J*Qb~6t$A+0=G^G({mTR59;7B^RCLK7o!t9bkP3it!YQerqF5PpvBLU#(r6(>^ zq`=8Tt$)@!s^mINElqv>t^>A76?kl_p$5l$bW3-12##&V0W&3V08_dH0g^MRbJx~_ z*T3`fOm0i}sbr!aj8jUJc|i?&^sbCzucW(HrIiZ_vpO`E6zm z-uGkSW3kOQ#8>;qx94_*9r5?#XQM0R8%!2So$D5N6icOkGI(IQ@av^KWD7C(rY~&x z!X`%_1eIRAJOB3Ds?9dm=4?&3*4H*%hWSD++0GiZHrHR_s_TMi2y;z%GI-FjD^<822=PijN*g&!oHUga=#oPTDC~9&{m#V?p zYrx?dUm3)i49PRa5|u3}({k!6Ot z(@zDyEUQ5ZX9-;DQVsCi&>t{1{X}mr#+(;(|;?D?>=SZqI8UrLgSe5rKd9krtZ0s;LR*&^I z#ID$~us^=fznDW{L^wM`9hVzs3S%k#<9{vWqaX6z9#SJF~Ld{WM z648Q>M9hFZM^e3kztA4s>BoYgV;LMLU#3LAHw?z5ndOzd zeDl_P-XAt}YeTLux~bFqvd(2q=V*uKkA|}I3oA3TH}djoepX(Zc`q+7E$4r=kYDxF zkS87Z=%LFv_!S#$9=?35ke@5abGH@?`NhIwcF2!Is6uRqo)b7yw+s2tp&as^t!}Uw zDw?QlX$t(WP#I>W5TL*hFEk@Qry4q3lnX9=5MCVqi(vS7!5=y$*UZ=q-7$2|0NXcF zHZ9AFW!X-UemR6h6w^t782bgv{}RbnB<=6>B5^GYqwDNCa50(kBG5)e5QI7z@m^8u zb-uomYF`xOnYQ- P7cPT-x)x9v1b+QrW!xgA literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/birthdate.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/birthdate.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ca1bfd4f944599946884cd68fd48a2f142dcbeb7 GIT binary patch literal 1501 zcmbtUL2nyH6rSdhz|P)>cbYnv3&6E8DgzL~f4^xpSo z{JrB;5ZKS({MvC%g#OTrxmh{EM@=Ai5km||sE2)wH7`Vkp5Yrk(>HsTZ^53y%&6Ea z`6Y}BXbUmxHey9yx^E!#0A_B!%}Tq-vmffEht(2|<3v&!CUNQ+%DMLLo10{PdvpEr z>&-1?ycQ3YeWkD6G-S{AQ=(f^G0L5Mi6AuH55pd+v3Uj!WG^%0<1BeYcwoM8MbFJt_O?TB8vpg4gA& zuzDi8jdmi_2JMIE7D2Lu$_Qhr3`U2_>Lszldl2-%@&jiVsRz=h_=mN7A ziKjGM0r1LNrI_|OA*w=1FJXg7^C}@93}`g-ln7x-0NcxioOocMVHRCKlB_J{%;XDr z6oKwooB>y=J9$w&tH07e4;k3n@e=@4`_JFBU|RMRX{aL08EucYZ*5P^^Aoc++8OQK z+L@T%E$YwTq`K=-m0~Qnd^e{ckL1A@jf|Q0P`=RWw0B zkgYR-8xOJxealr5nhv)_WU}ZdA@o&JW}Cuu)ph48oYpLhq?I|gFXZCCDqe!6mMr}Q qU}|8DC+NlT*oMGLJTn+pb)zlYitBYXu4)-xfbkAW(9WWxDG}JnnBFIhnT~i z=MeK1tbDiyR=A8B#rJyKz-fg>QLL!)<487)v^Ib3(lnX+eR}Hr*}0k2JQXd!$GPQ> z3tdIq0iWjq?+6-RY%g+8d3o4e4*w<3_CDmxk&78}jVqA1Ychjd%sc_MCCDAHm1Ay; zGAlno3z(JeRbA%+x{Y1Pa`bIf((>t8O~qkIBX(!8T!%4#!VYx2Whyp&OSvf~&5GQfn@bxTks4!+_<$svv~dPXhQC zKY~Lw(!lY0fna0pXCSf_RCbk+$q6T%<)p z{K!{?H0*TSrYwo%!2%&0PND{$X^9Xopi&Ydbpe{^-j@q!CRMhX@mo4hY`i3;sa>Au1my8;cEQ{?B_|EnX?j}Yl?goWC z2I5l>4Yr`#-oK_F&ipy^e|1m4dj09uH%H*3=UI0M@@@6{I{3hq&Wq7+DWgGTNSBp0 zLu}D#Yi6lwiD<|PNy~(UG3y2zR|&bgoMabi9l492=$GJvP^Rdu{OACAm{hU(=nh0Ibi_UJf)uxh* z!pKXEX_N)gC4VWN$O-*T?1Qc5LiRumOpNg=+TZ_vuAzhdAI&v%xc~heIJ>Z}{l~ID OcIZQ<`uG!rEW@wR2xuDs literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4b23afe85ed6bb5d771d6ed189cfd2a88e0c536e GIT binary patch literal 1415 zcmb_cF>ezw6t;6oT7{+vegLvyibO9X(g{^6sni7uQYs-uhg|3EBu9K_*Y>sQ#=s9? z>%a~|?C>WTI-*QSOx=RY)Cv2XBBcbOM!fSqJ^T56?|XNCe&1|1fR#^gzYIPH0DO0o zOR0GSo=4U=0TfWkK?Zve0$QN~uVg_lfS>|)0Ij|Tw8nyW7UQFRz4WTI-UY3dGdFF) z$qka{!Vr^+T%SR|w!X(W8!D1L?Z0G+NqnT&Zi^Loe%tC3z(5aD(5q0`3uwgx2a}tR zgz1PZBRTCRLNc;xlQ)o+y-})>C^3;@QZdbPqmdagq}@(r1Ued}$q4m@L5auEh$x1L zlssiLM4dt@8^w?BmvIBZxj0JmA$s63{B~VPDU@L}YLuDL28t3+w2t;kDqLxyIhIU^ zHW8jB!X*bx*?<(>gjcHA_RIU%g(I9}snSDY7*0mS=&Qh6oImsaj&m=SV5meP{|dk3 zyvu_-)|k*N%~Nd@F+we>!QpSsZMt?PF45Jm<6xHp`Um6xL>Ff)>oc{8^^?-G@6TUX z6e?j68W|&X)NUt2vCz!AEEHSwmJoKN;NM7c3U+^eo&Y~S@OzV zN|S1zXr|n~=8@N&Rfeov>tgkxuXR)1vQu~a=oeN^0|?<)aQAe6d;{ooeoX64Xc_&f O-sC^r>dytPGW{=~W59j@ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_all_chat_administrators.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_all_chat_administrators.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..467af53bcb93062d724a6a413b0b032f16b62309 GIT binary patch literal 1801 zcmbVN&2Jk;6rb7kuD$-qS3xaO5Gx2mM$|rl5K7a4aib6sTofB27NhBQXY9D%FJ{(- zR6X=ii6T*Ms0TpefC{L0{t6B`6pR7>@8R?gEb4aQWOb9FCo zaZj369G7h04zAZiAlXZy761R?8eg=`OJzUdP_M;8RASghBbfU{b}T-N8dR||N*el>_h-3|vYf#PIHq-&P15HskRFltVQUjywr;{(5M z+OBK%c`yo1K+Y7SknzlPATZND7Fn&BM%E5S++mC6e-8x?liMEOHQn>zjd49cJpqxd zW392i4&`rjNaNB6Ypu0*XQR=%ywUzF&PCv^Vm<{GiQgnA);djuz-Nvmj%@NR-6hHXWl+Au_khRI#1A9);dua0)~+3Ts6z2gJis@V zpYgZpO#z0htu)l%P*sVw6zsS_2oygeq?(K8js!;pb9;oO^Z7LF9vg%>t}O&1LXs9Z za_eAtX|elpz=z#tK%t!7;V2~$fogY|f4#dtxY`wPQ_hFBGqn3mbnQVPDN~oo2}v3< zW(7&vLZC)O7Kt3MQZ3x#&%&uU&i@;bYm=m&gC(K{;_q81Ifp9G-(C57^_$h5^89vr z3Hnb9^8M44XrN1P>^KFk25*G>a0y=V~UMA%8k?oE> zc|vI50Fnh*6Q6wwm(ru+X+n;CdSHzNI?X$-jL~-(07QUuXTc?8x!>XE5s*u)YOso)^7fp1kGp{lQ}fIurqTZDV2?j z3HpD+kQ=4D9SSZ>lLp-aAOXJK2rdA?$K_`^)`1^Ds0;vk1-LGUHRg{zkwH0oiacEY zhh#vUky?6$1m~czlvQV$zYL~CP22^Ms2Jmi=*8{heHYcXpWb)TE8EBW!&8$JeI7%` Rr^T;tKa!(=J;9ZR`wwo=`M&@F literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_all_group_chats.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_all_group_chats.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..50c7af2e32fd1185447e37b38f5c33be2098ec6c GIT binary patch literal 1719 zcmbVM&2QX96rZuZAKs7VqaX?@k_D~MqOyD7L`VZ+8!d#K52y(B&i{bKAxJqymXIQG%570Npq%<;jDG)Ch`U z$u2=$pv9mZnzo6NhB}Cr?jl-d<|7@U$MEK6SE$)VjmnPEu$aGsl*$a(UZ zu|cuY@V*27GboQC8&hO!SD{Q>XU5G@`3TuXs<9H)=V7LaSeefr%~IoAOe^vY(lusX7qS{_el1NC zG1qE&F=x$`1+35Auo?4y>qeZ4mYeu5Lg3{Hs5J}Mi52%O7`4X37a+RDxF7W`Hwdi0 zJlg`qEHOwJ&%2(yOS7Wx(v1h)V{_JjKODAK+o|2uUI!OOj9r@mK{C}`TwW%fEAL;u z3^XsUc0bCD6owm^p8~A2CYe}s3^+oP4eCaz?~(OST;3O4GL{uNO9wp4jFmWIo|J+# z`IYIaq3{$iM3F&qZj%lEG@N$( z{J(+P92fBnOchOVe{Q1T8B~A%{?g~2FFM<`vs<-!Xb;cH@5`^}y+gkbD^R1D7h8u| zRjiod)3Q4w^Hm8}WFNLkRv}0 zm@5HQb!PPu${qtC2xv-`Bx!w1t^1J-q#zvw3OD zaPszx;p`Z#-O^J-G+nqjoJBL|wx?emR%_To zmp{?02;75M@}i}@c~K4*STqPl4%^HLVQ~4!&x=1TBXxuXfZ t7~>uE!q)M&i<(>i+;-7RTgThZiOIv_a~LW<=^noEyBz)FZ&K>IPXN5M;3WV6 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_all_private_chats.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_all_private_chats.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..bcf8045dc269aa88eb945b8bbd9fadad885670e4 GIT binary patch literal 1720 zcmbVM&2QX96rZuZAKs7VqaX?bWI?NH5$wW&OS+9%wo#~vLevc)%%WM>GrMu)FJ`=f zR6XQSi6T)X4yXq>^ni*`@B9&n!-8^%e2T;=H=}SsIrWXb8`2FR!Snd}&AgfS=KbDJ z{=Ql*A&?)x`MLj-hR|6UF2aCV`(d{;;E+UX{P4o%p9z#RCDuQ z!7PBCqj|UJ>86g6f|e02+(xv>^amL(A`F;>tkrVi$rpDFv z57w4Q`>mz++gDeYW3}aP$AuLqV%%~MllT){K&D%<|h^(2rioy=Q)dp+>f=@z-P8(ffV_b?y~Im zA{bxedqB!);)j(7@IHh$lN-k#s!)6jJNTCJ9sV+cuYh+uA?kaRzvf#|VLi0xWJ5F#W4q3t_I?8-v-{eW+F+X00RbvK9HiULlc zfnDZrbyuA0T>-RzCA92KYrsU;astVMhQv%r9*}XPNlE|$9U)JO!IY9n_yYC^?6!&)r@6eEEyz-O970N)yKY^YZ)BrEGSr58(u=<+FmTV5e25 z-QlxxIw$>Q37BtrjF7lQh!@bIEA0v)9}g{e>?sgJ0~^pQ!kKvP6lc;T@eCm+{u;1b z!kX3^SI1b}4B#NZt+XiF+&B0+xvMf!IvCJNe902Y^j z(Krtb0Lo-VOOo@vT+T6n=!r3Kr|7}uFFz~(thCY;5|E=}Gwa17zW`H-l(-8jQ8C7Q p=!MbaV;|K=|2+25#nIzq@6_fb{|ttTPpkXnce(n<-?-B2J_3ah;D!JI literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_chat.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_chat.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..bff4841ff6880c1a9ef28ce77d3e353db5249e48 GIT binary patch literal 1768 zcmbtU&2Jk;6rWk|`r8Rjs|sk47AS(1ip>R(LR2+%lN3lT)T9EoF4OJKIN4@D%*?uw zDu)~@Q6%7oibRn(pd!=@7x)jjad4#^qCG|GDL12VKsoW=u1%9rgb>d&&%c>BZ)V=_ zz1i<;wK4(u`RiXh4TF$}I2Z|xQRwampzjb)IQ2-hXG7HP6pB-+r?-pX6r3wWP4%#X>rMVq6Mg*^ZWZ9z7ey%_s<*kT1GXS1he{ z#SYDE)AgPQ;ASMGKBuoTGwPTyYmTN*0lFci z7cQHQsk*}TI-YB~aCp6(9=;g$q${S(|9%>7l5Vm0>@Y`{4-t<^sW;EhEL}#lJpj6IjFe&onyB{4-wUW&LU!$faI zp>Q$xC|DnP=oPHxGXTD%cVIFe*FwkZ@c4mPT4JbPSIDHum=}6*Kg&oa_T7>x;ddB&W>XFI8JKMd_Mc>{Acr<)yaPK!nY@XEWjVO zHx`B<8&)suf)BBZS%71JQ)=WBh%nSNLGmb~W1y@GQWZLZU@R#!7DT+~Bd#*`VbAf0 zmI7lua)GxJ_#`?OPF5A;jP3hSzyf^4X?#g-$f+xQAM!xu(_m7V(lhb|uBwd`ZmNC) z1;IZ04K&>-4hX6$X`H2-^|_66eSI!#5A?Y${p6ND*-zU8eR7}?V@BI992<~vqeTZ} zU&gUsy}r?WhrmM_5&DOKNq8ssRYTjaU^!M06a?f+Zb hCNK66wk=ZcA8dpC35rBMUVqj2Ew%jq5BBu>e*$GX-7)|G literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_chat_administrators.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_chat_administrators.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..71e028ef81463a464c6ea5ff5da85e67c29d215d GIT binary patch literal 1922 zcmbtU&2Jk;6rWk|uD_cmsSqkbEKms+6}u83q!3j#Zj?qO2F0lmTbJo}XY6dVA7*A< zNR>kml_(N$Lp@L=4yb^7;l#Or00$%G5bY@vr(BS$a6plec(ZGhI4!CW&oj^O&6}_H zd%xN5%jE(B`T6T#+P`ZE{U)7}fG-8_eF*vvqKIM-`Pjl(+KQ+687t$fmg;Mk=IfRY z;~A=YSwCmxz}Bel<^6(Hz(_$0h-Pmgnq!4~8HDabPsJ+Id=r_4UFn)QF4{p5Mt0V;ye$m5_I;SHnnD?XLSG7)}aFvgYg+ zVuWo2Mvc+%X|S#{?gkyh_B_KLJ6}$=4bf$e+jbqJ!^2+J2)QA8UB*+-flF5k$u*l{ zk2`GE`0w|Un~a~FY`A}BSm{egkdmdX)GyRlN$vddVq>wnx>8$xccpnbRwD@QPb9>+ z5@wME z;PDz(x*PmyIP%6TPXxO%%IO)HFV2Aa^ClXcMCE6{nE!0y^M$R_Ouw}J?Wv!#@F&|_ zOG6`dOUrw(2AR1u`(t1yxbfrCk~k#Q{&90S{Dgv13x{E+rMX_pB3sAqe_ zNR|*9Isj@O*2L3~pa$_G2A51f)wblAPr7 z>F}(KX)NgZB87YM5teayUqis2l2&q#1aUt%msapBe;HhfuJ{JjAcHa9MlbZo+YWl8 k|D?8qUh0pxZB*%xw}Ji~mOwsU|1j||iTv>|@#Ok{119Jc-2eap literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_chat_member.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_chat_member.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d06725da0c55377fcacd3eaf3ad9e1ef8dbbb0bc GIT binary patch literal 1908 zcmbtUO>7%Q6rR~#du_*#+q6J|v|1G;FfERRR1Q&yNZcr`a3W}2A+}DYo87Uq&Hgd7 zE~LsKNR=oOa6>&%q#jTa>V;F!aOdDkIaqUw#3|xp6b>jS-t5{m2~-I2JoEg$nR)Z` zz4!LJQmKGI9)10DYd3??FVYwa*i!J`3h2AYK@Rqik4=mvRy@U5P1V;-&Ci$_KWk=T zTy->0_j6_raK_1cdB0#5FjCMwa`fBC$H>7wwdKuL)M;H4P!oGMea)g?39+oXZkuZ z!j=J}#&GyNpqrGrLEEql9#PwExwhda$IG>r(Pm*MGD2qXPDEL1*>J^bA-UXA*kLxE zH2(W-x$)PGqio_$Wm9$VJ#|z27Jr$P6O@3uSW%N( zvg6>xPJsFzRTPm)I2SoW+`x?qsbt02fy)w3y%r%yJlRQb7kNT#&*GdAo&{Uxk+HQ; zE>1Sz57~ON7CI2~=6Z)&amWayM3V+Ln{{`!$)Utvk1TuLYE#~{+)(D#gruCy%p!x- zAxTP+g!43v)o6pg0B7Ag`&6c@!-Za>{@6nOQ>b+Mi@DF{KcC+&j(3YI_h0@& z|M58hvelOdAT^6Cd*B6Mjr7%{fK$?rNhFzLV^T>Hk}$GoBzhK9WkfO=SUx306bSJ{ zr{hUnB;>=6YvnmT6IT1*+<7R1oubL^m};wt!7^@=D|e&Tj!H))6EZPc4qjd#Y$1q z+Uh{n0If_`ipWCZK&GW6$+BWH9hs~kk)c7y=PA#}|CU+|Dr~^mDT$JEB#ZmGsWf!c z>@_eYz5E+ceHCNeLub2(+YY+W{kOJ*Ug;igJyh);ZvE^TEQ$PQeZTx$GV}XW=9BCH E37ZWKVE_OC literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_default.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/bot_command_scope_default.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d639657bee4b25b2254fffbf34a81b0b687c192b GIT binary patch literal 1802 zcmbVN&2QX96rZuZAKvUH^aCgo2n$-3Mar(=Mo1${vIN8uA(9s1E}FQW*^L|9V`gkZ zP!Bm&qDYhj5-JiLIG`fbJAVa-Mam)aDH5mL76l=c6K`y9nkGd8X2;KO-kXp2e(yKl z9~+Gtg7)*bzx4k!5c*9G#;ueqc;5!)E~1EH9|hRPSm~Ot1-h*VhHV5Ty973!8h$yb z*cH%AwCq;{(>5{E&?2IhTZmSfc~3{^K0JA|Yt&pu&Dx$CHgP)PgdvZe*yEvW>S<%; zgLgY*{>{$(+ixu`ruyY@Gp%&Jm6^f&?)lsZyI%=P*noZIIj zOBjL>ty%`fGEaodW~~37bAej6%fb1AC)bWaulUhg=)7_HN_XYM)QDl |UEo4!Df z%`NaEB-*4-7<(>R-*Ci03dM}HELfa~Fg2EV$XrD^)zn+LCls~jK=~Tqg&Po${b0EV z&wY6EcH_`PHHvRy58u>&z+Yx}4DN=$lm+(_YHDdoCJ_^9l@P!;CZuVkr;h|jB=h@( zWb?%o?4Fv0xV|GLAyUyDh_-cbZDFSOJ{Rk~c}}57z4b&mF&6}=(qrMry{>n?C*h7w zM~=Jh44CXW9#?#8E3Bkq94QJ)GFp%V_g1ti9*0vtefH5Xw#H#U36o?C#9v!zbQU$9 zxzqW4@r%Xn`qRVuEcEZstM`kq=A%Qo4=Yf!oTt|SJ1kmG~jNHa>+5mKU#Uhd%Sm%3XEL!+DbUybgLadEeDc7!HNmqwFl z<{iBK%F3uxGcS$M{}ZO#DckN)h^NLuE&*DAQ9l7514cr9m(wzo8F-Ort(Yvz%3NY$ z6385{Qztke)SpP6{TZcYM<_%Nsh)9+l5w$oQoAhWxIqe>}pKh5I*)Is484 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/bot_description.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/bot_description.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..60abf2b720345f6a0705bd11530c76b1f3f0fb35 GIT binary patch literal 1291 zcmbVKy=xRf6rb6z`^a64F=C**eYOUcM=Op<(s`da{+Cfoq6-#ym_Mn*1;jZ98VjmP?hV5yAb{u$=8I(HgZXBU_&-84Aatkl@P49a6j zgdrPKWNSAdAzNn#GpTkKd^yA{K0q~QP@QF{LCrbq37W&ydQ`BpPtZeb=cZA2FK6QZ zi=iB4!sT8hy)an5pD)3fnfF8~O!6pk7I7w6AVo>ev(juRPl^)V4XNalkm<0=T{c{r zmogH=)v6nER*`8*m5|q~5GkrotS9h+D4%cple6cnX zQZK027Mt9WAtwMvjRp5>SG?Jp@FY7OIqsrUXQJkKp=yV!T#A@b=#d_bD$x?}hqspx z?S-n+O>zjFq5|UADr)CZ@#yohr{mAYzZQcxSu;0@ zKOJZzwYR2krpg`CQT|irlD9j5=#hM|oAFfHiY?#?h}|taE~X4t5(c?y&rXpAr6s|t z@SW`04#4O55ik`Zq5-0|_ZJaMbRgYo2>Z3`N?_&W1G=Dj!lz4vC{WwU7n^zrrQ zg)bUH-;~iMv!fhNfU<=sqS!}uY~#9SYZy_D>b_n#Yy%?=O(ANmBWf~ZTSsUIcAIRI zTC*shI8bI@i?VYM?o5)>jmgr@>GD*hUk#QIuyWz3caHh2%ANY{`6cE`w|zmITOH$Y z29#%jh9MhMWNUW;m8~;_nN%ACUkWjc_fw4-RA&ilP;lr(_fu3MHHH*43 zpNJCILRog|Y-KT>1Dad(L@ta0Zq3 zqS;_PN)qA)o+Ko1L<4_7B7*q~gv9Y&J(eg%i0eB-5F!k)p=oQsX0DG`?uEQoDTUMv zs+C%kJ2K=1>aMWhQRS95UlE>Uml}>+bE-^K94}O}F3RNw6RJ@p?rdY3_rawr{hj6% zy0C`eR1|>yTtlri$_~Gn+?;wo^)+*LH!}w7%{e76UT#}Q{17rwKCQ}A_Y)GO38{y) z=_@@$$it@NcRUF~Xz0SRE+mio2yucSl#cYm0E*@6O>+f`(h7U!tSekI4+9h~69 qV5*XZ`dV8$#&{2%-#uyVqulP_t7Q#h0QN822)?V+A1AnC5WfL|06CWc literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/bot_short_description.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/bot_short_description.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fb69b3ebefc8cbb3228cfc06f8dd79b231ec7934 GIT binary patch literal 1331 zcmbVL%WKp?7@x^&AKk6350F}6L5l9d-J4($QQJ~q)XMgOVPQx!(`{@vi8Hfm#e;%i z1@$Hsym$~rdiSsJP{BjVso=?5q#neR-(<74V!b$-`SLyHn|$BzH+fes7ZHpPuRbnb z*Ae=njNULaW&12BYltF>ebmM_ZfmxNm96=D+prCcG&G5*{s>Wn8E@g7by(eDo78Ne zs`XWwRV^;h+?bvqV;3jJu3Va$jP>)uN)^ZbGt6f#?zFEh++?nFv*h$;WybbpP#!}e z4B40>TbqS~Y@Hd*q}myX6%e!d0M(d5b(W(BH5aW_w1}zosAT6?(Oqm88mRZK=Hdev zLfKdfxg2N0*b6Hg|ePJS*8ZplWMRJ7D&;_?HB#-wI;sik`9d*+H2CjY+ zuCPeUjmsH8F7tiB6Y~KG3B|}cKB#u(dP4ma;x!1UedkFu!^|g0i4r<|WWyMO`NPO>Ri+zVWve`xn97r&|B{9D@a`veNxr{V@>JD|Eg%h8 z-sw9oXLQz5I=Q;5-7ZT?OOsXSKl5k02%qJ{U@AyN8$_aGj5pE9#$Iy^o!IzuCe|UW SI^0{ntbI!(-~SO$%lQSHKW5wj literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/business_connection.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/business_connection.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..92cb3cb13c69b4ce5907dc16efc8836a09fd8115 GIT binary patch literal 1811 zcmb7E&1)M+6ra(~u2!-nJN{@$9J?ZM4r-}&>%oN5);3DrA_r_!x(J5V?#SMFKh&93 zQyU#*2sDAVw~|78DU_6wd+8t1g91G)douKt+ZOjwa_XC1$safbI-2?EH}huR?)$wr z`%Af8M9_Zw;g624BlMS?jGLMfe9{5(1lh>OF7mK}vE(^7=P8Eb5re>7v5BjCnxUm! zb@QHX=om4DYhcsdf>$((80Am{+4+aa)|vKHLFgHbtQiw_VGGrYFXXg_;|bIEgU}3} zz!$Y#T;Bfd-a1{qyT1DIN6kj8eBd9vz}e2qHgnl7H@(gFeP)GlR$ntiw(WQfIN1@5 zTiG)*96b`B9K!r72#g^E+sMf6K!Ao~=NPe-J76myn*diwTmzmTaUFPJ#EZZu&hb*l znaYdy^dr>4_LYYvLwkh2#72G#jsI&i@$`p1;rL95)xh`R)gjiy$HgkNH6|?Xw3(=e zd#q}mnyW!4U1)aZ9ID1U$Ay!1lN!*=~K?S?m=911ZBS2c9|V7(aYgd+C8vMKXfd*|G?zCg3F?dHO|5w_hZrwKo^;3 z*)$lkS|<>~CwGB-ho3-2g=0IcJcaQLM%M11TI^gO_j7%vPx@+Kv+<8wKmRlSHmzi+ zI;C0Dco`1yii9Z%S0v0xm<9M1K@qB=*98r9N*&(`DXkUa>2ncK!Q2j|uXn`fz*}6P z)N)NBC>2s%nR3|%FL%~fTAv1dzqK0Jj=$U5?{PB>IE7@jnEyrV6Q|u0PRQQrn%2I# z%S6j`0$Kd^@Sw{?eVj{rmdxeu0iTD59L`_Xe|a3r5^NCn0RA1IWD%7YzFB|V_`30D z=|+O|awVFXi{`FH3pI(?Z$HC zSe~Tx+y@1cM5HGvOI#l1!eXuqImLVdR)s8`_xYmS1@)GJe0}jd0El$n@@_;bgN?z)(MCkpA~H8j`*Sjv{#cv!}q{9EZ}Zm85K)9^5mKjmwW>tU(Py z(Pi4C7m>70xa#@TX!S%GcnU;JCH{__e`8p3~I_t1j? literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/business_intro.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/business_intro.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d5dc4b3a70572fff3e2286d49fa3291b181489af GIT binary patch literal 1696 zcmbtTO>7%Q6rR~#du_)~(o&TQ60)HL@S(N@;zv=1pdm69$gPy3ip6C*-W|JJ?~j?8 z1ybdZLnVp?hzqI&mEeGis$Mwt%oT})BXO|y6p2%BM&W>R;?1r%B#54P`{wO?^LF08 z_q{hi)@l_5^x)fHdyf|o`dt}0fvpJdeE{+{a*>OD6kr=;rE9(x=(ZjhwhSYclh$j?jHr8QB%Lw1Mj7hsvzuWQK-eB&qbG zP}KFLcImx~>tyY%^|iOpw_Az+M!1=jE)12M`VVn-X7&>ES)bG3LiajzBt$Vcq~{D6 zce0;k(#T$T&j;mGsE8pOyU5nwh01K*)ojDnS-~~Vg1-zE+E4@7g#+7ki(s3X%}RXE z)zYVQM|Wp$p&oW?H)rkgE%XVtD;p?(*XNSjxmb816XJX*d358OiUqV5g_3%qu)MGr z@gObQqTMK#mb}I+At{&EkoG}kQhH%uSW(ZSR$i`^2eqiDMpQm_nX~FiY6U;r@Pa%Je5{@xV>M?@qJ%NekCbLPx>q|1IQk7**|vR zo`QTOF+~RVJ)PG8J3gz#Jcwk8c!;vp#+IwevgoURm6|O@uWb&E1JHnIf%#b<*fKqg*7pb{z%FQ7Y&Ab_q4|Jn3 z+~lVq_>GfCAZ+C6E`m?I0OGH0G&zN8i(jmN*805lTXkVnz54x2KRx&JE1)QDlc|!K z)vJ4O3e_uFX;sj(j-{Gv8=q4`RhssPKc=)3AnG#;u8;#m;V|i@6I$mB;dn+057%OAr#a;8n z1kD#Hp3I_Wo*%E&$MrLlnQ9p}(Epa@G;kLFkmL(_ZEXM;VC}_l9ROCYu0T?R>40&{ zz*6^xtC>rTE)|TIl%4jhth5xRlS)ftD&+P{XR|iF#-9aKK`OojG0`!`WAyasDDR@? p=+V53tkF^4)#oP&W5ClI9py>!DXd`oZ~0aGkJR($Bm8Lre*+o2!Hoa_ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/business_location.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/business_location.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..08bfbc2ae9f497307234e5fc4783caff7fe3c4b8 GIT binary patch literal 1595 zcmbtU&5ImG6tC)!neN${-OUn$F$(Rjur%mQ&P$N!xNO8>R@hyG?P$@{RWs>qe~eY# znhlGL5HNy@2$F*VJxGG&;>o|l!w4RRJ}r34ZDc*jo_y6kZFa?+d{g!My?XUtzxR8u z=V7B!LqI=&`^#WkL+E#@l%y8|K7JpBdx#>60~BHhV<{_v5~_|GYK|7_jt*xk)q+Y` zb*dOKl~+L510ysY6C(v}AzHbEXq8nTs0clRU650w#tyR0$5OR%w%|rloVbY}N5WRK z#_l_BZIbr2&Gwsbbhk3~)#xBIwnx(J29I&!v$)FwHso%&-M`7a1fm$7*vn&h#ajvv z1xmulyTCt%k{EI@MUJuur8z29m`2qrU^5Zb9G&W*R|=g~c!O%RdLPrqT{OV7erM6C z-bJ^t1L>Dfdof#nEfs#mgeWt({dLU(YR6IH`jN2wXb|%-PtJ1tahh1k4Q2)Ne64t3 zxmH<^RR*(M&x_M2Y1Z;!J8{ZAwqe~!l9AYGwY-?KW-;>6?s~~)X@4;bG+Tr8@>_@N*y7`ZVDu?(`q4>UXsQ!Sz z%;yhgM(x@PZ@}d|zaNpUWV%R4jAsTRe&i>F*m|~dDoY|*Fd*cK6JG}R%p}AMTp-|w|!>PN%ge#+e><^+)KvFO8I$M5%qpRkuluD9FL)cW2r_#oRT3af*hL&6uOBumU2!_P@+1(&5z2Tc2vpqw4t?TGHRfvt{(s<(au) zf{6Y%H}jB1;8UDGTV~$17bH}J6lNQs;_@FXt3a<|I0`7_>~J~anbvm&quRmA&l3i+Un%& XnpG}g3EO}3uRi`GxBU4OdtSibuSBQI literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/business_messages_deleted.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/business_messages_deleted.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ea9891036d4f5bea5a467cdede194a2c5c77c872 GIT binary patch literal 1659 zcmb7D&2Jk;6rb_Vu0LYCUxd=MRadmAS|RKkho~TE8W}ZP+D5j zSikn}GF^IOdFib;S38OJdbpL4tDcM>;XJ;%&V4=*PVi3e26tn~K$bR~*v+%&vbYTI zzYq53PzpyjX2>qR2PN4WD{;cKOR!f(jDW5ex&eAQ*SRigtZ^6hF{|IH+s0k=3AW2? zX!>t8larT6(hIqiZ^Lp1TwZ~f#hl&Vt(h>^H#})Z*&|KR1b4Z2lQZ+y1`o}kIAS`2 zn=C(P_C*w!j_F2W2$ex-ueiW;TsInpajTYPUW-P;<%{M<91rDUyX{7Tx8eepRwM@P zUKGo=GxW|+GfeL*uFBFRnv6yA>@7xy|zt$z+Y!f1$JqxmL?hyE}BXl1@RNIN{KE$^Aa1|2Qd*!SSR@sp~sZQYsCwRfo-;gX>ooyB|biv%3^AFC26?N5Y9C zL7@R%9^UL;^?F_D#r&nA<8CUBbR92J>}|(eLoVAh@TU!;MTc6$EpZa=xosYTacf$` zS%{Jy5P$8U^f}Zx`_=Lnoi97T)z73zZ!{+tUzyCGnw+_qmchzgX$76QkXC1=3d=W? zwhyV0Rm(xBgPvok_>ci9jwnrGl66%aSK0{>Rz(3DIsvCNsZkn4Y~(AwPU*)Z$1iru zl(NVL_Yq2;`1S#IqB5zXlSToy%Y7fZgvBZFO4aw*#Da*K3kcPPbXwyoXv-1VM4C$m7ht`yxvSJ$EpCx{}EMn zEIT_B;`H>5tJa*tqdx-n10F&#J~4m*z?i&f^?3+ItAz9%$wfuk8Fe$*vufv+FUzSA zIH+98@qJai0H%UQ-UE?p7~=_ge*E;@LobdGpL@t0KRx%fqbb7p^bDaKCy=Re9z&`B Q7T<<{DDR*Dv6VghF@5B>g8%>k literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/business_opening_hours.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/business_opening_hours.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f704a12041dae36b36c95bb75d9b8a07ae0753a8 GIT binary patch literal 1610 zcmb7E&2Jk;6rb4-d+m7L4@LceMzxASTA|vfUZSdMn?`A&xJW62Ze2#}-LbRHewdkY zsiPcvD56Nf4T=OuRD^m*{1F^niGww#NSu1xDjceuc(ZFajW7qEXP)23%$xUq@7cfD zb`=5r_TwKt%|z%grOXI)MR@m9;Ez#&0vw?jyBI53i?mpG_1JKY*mO;>>46cI;<8)D zi0Z5ax*1t<#jRkZp*0kg9-^R3%TIKKp29B3tp?UQaw^Z2>R`FxB}png5vB=ubZOtb z_2DX6xw^XY{A}G7(MSk&W!KX>!-SW27`g!nGP+)*;7BV$iHCT9r zdN`;)thuE}=stGK>uC1v)a2s49JWT)2GAACeHL~pZ-@=rNQ)#J8!F32+G}`??lk{q zH9x-&9-l5ZHiQ`Pmmr>;m2SUGe20KzspsAzT%py7gf1lPk-e zk5jhUSxEyJr_Sb(c_L*5Q18&>Ugvt)?eI|0vjflH^!k){yf9T0*%G4x<*iv$$N?mq zgAqFhZ)`2i1GG8I`%O5)F9Cb`0AVx?ZA+P;%0a`;vQWZ*jimFee2s(k;39xe2)Qjw-It7zZFeUIWfI+qUpG-4MD?^Ia zka=Qk9EbJHI6g7j6XV=CU(bwl6XWtuc`-vr%z9?o6+qL?YeZ{^)r+TLu$jdjW}k$+El3)8r{cLQ z+pK*LO)zWS?F8OE^c4;uz52VqlppydQ<30GU7m3fiRrmClj^+CT;8Pd?fY#X)>*DX z8I8H}sqmw@%}*!3juP&(OoE?(YcmQred>?r@%%{nDa0JK%NSQ7Zpc^sO|55YWjG8| z$p?B~@gSAc;W*W5NN3SUbp+!LkvC07^{j?0AK@R$xq|tyH~N-@a7cE5{ET2UT$RnZ%$tNnBGQEP-Ta+bvLuSf z6G9eFvJ0Mhi;ys;N)e(=0j6DdUeL2EqwA^M8m*=b5E*S{lIm0vfOy2k&C#W3JW`S7 zCuTIz zp5YFZHw~JCCY+GGO-PcmEH-?HkS{YD&n*o?SQ>)*03oluR>0aZkxZp|cMfyN;}}|l z<@=yjrpu@0A#CsrwEhJzN0G?@ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/callback_game.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/callback_game.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..749f55a64dc9bc0868640aceb6e3028daa2a12cf GIT binary patch literal 755 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 Yv%U1HqQH^%=RdfA$(g@jFfVufFVah?K>z>% literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/chat_background.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/chat_background.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cacaec771533ac809f8c414a1ccdab9423b489b1 GIT binary patch literal 1793 zcmb7E&2Jk;6rb5If5eW{v{h)KuoNyv#lE7DMo<$10)y}1eploRjm`lD;$z@U@7 znZWq%$H%=}Dj|QMF&$vzphsVVd_ZhsQD4N*;d`6S29YeuDNAz$yiGDf?M&bMm5!o?y^@iYLrN1o7km$#4hvNLz$3A@MObS zv6ps9z48RjI!%^L-w$Flb^<@D%Sp9;{qh!Ty|>l+;QgKLM1I>pNYtx7pigMFVC|A= z?e|46@a^_N$Xk16+}`6JhrL$w(7TT7g71<^Td|d$J(H7E=+P$FUjdn%7}O?)bQMT7WLx5jEpGr;B3u<^yL6xQs9n5QF|_;S z7BvdHWcsd`lVwa`e!|#|H=9-eg9tXY=Ucx>`@_(QY zpwr?h4xWebJc1`1H)e<}+4K%|=pE^2`d!-d(1Y@hSb@M_NnJ|RXaJQ@ii|nF6Ejv< zlGSGp$0F|b7)#^D30Rbr7_(e6iWrL&u%TvmkFUJ5-nkZt{Z1>e9lzh%9|$uJ1OxIr z-2c4uq0{X|PRw5qp@3$eM;+4%u*;fAPSnKOuz7JB;el9#y>GAONo!0Gc@Ds+0phQ_ zWc(tjp8Iy|>+Ns0f3LhStZcyi=~aBc_GV_yUk9_2t9DsWCaJUK|%|rHf0qPW=QX-y1+XLh=IdexgCOpuAaz*pNa)_t|;n7}k@e<&5#$B#IbtYB8V(S4@-; zT3dv|>?4=;k=I0@~F#PX%D6c>zXp4@N)-XRu${WM{94VW_{2VElhWR-n`Y=Do+DjBF@=x*o Or%%!Q=f6N{wtoZZo&O#H literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/chat_boost.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/chat_boost.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c08148ba1542ecf2186baf0127eae133f5b21396 GIT binary patch literal 1962 zcmb7F&2Jk;6rb_V`uihI+e9HvSy~QQYU6uUA({_`k0z~@R23Ve(Rz36Y_lI`cHJgb z4gpo7NPxJY9^eKlLcQ}>^x#MwR(p!XskcSpfO6u^tnJ2aI52+m{G0dot!IAkz45P= zN)f^M{l^#WdpU&u6pP_dQ-F`Z1n?AD$ifbCv5v9887Jc^y5bU@xT>y#O|giRb#r=7 zV%5pJ1-*a~Q}`tKvQE)0=_TpQIc2w^S0v6mRkxzZycUI`qhbv2;e6+qAD>uEpSiS3k_a#mPs+-JV z9d5X{Tlbk6!YlI2M#wg8mjRw$+BU*P-w(nKzsF6sYPZ8B-#Xj%fEf>sJ&2lmE$R+u zuHAFZbjzt8oB$uUVEq+v$dHaLq-X8|m%3tQ7_pQa;42`D09H@o>;UJ$o=-7TdC{sq zL2YbR9+&m(6SRx<+y)wc*K2WMw5vzEMGeO0wjF4`Jho=~UTD}}pxIvA=dL7BGg^Kx z)C|o8610|JVZJCMQ!*B`?J(>H3yp^9b2c9ih@AI%r_u7mpkZ|Ft0Gp0%D`9&LLTR( zf!Y=?zyagDVOi7y(&HN2?b=-axHO#Hmbuy*?L7VA0iV~j*X+aWoZ(1w^I4n?WFF&L zI*O&VyJs0*Xq$BBp}{)=7u6kSISYH-i^;n0F;i5F7zAb>W(gsDybRz6{1nPF9QwiX z4CZr~>9{}gSebpipV?RTiG_b6`|2H?_WP(2f?L9fez zG)isH4k@kY;>lBcrU7%>l%5sNFTy+G0;Q&71OcT1v@sHy*R+F^Tgwa0dp_T3LOt7F zr@7Mu;(bmbb4}(wXx_40&A<-X^{!#=7#$Wg4cixu(g^puENFz8zbu}r4wV4G&!B*c zSDz$9)O>=3DkF9BVC`V-i?xWn7m=yHltVHVk;RD2^`#t=xg>+sjZ8$g`ce+bRz$8I zMy)3Kiv=L-|EPipld&Vk-yZIIy?#zG)b2qu07G2dTX7aj0BRpG^GLSx=-r%c0d!JoDxQ-Sk%FW$>pg z&j=)UE|@>b-$?WNKEDo2k&@sAs6@dSN9am_T#nGS{(s96()!~Pp-cU7IZ`GPq~Jvy kk>&olL}aNyE)lueAD1Ls$B>6N)%VrEg!S(;T=KO40!_de7ytkO literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/chat_boost_added.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/chat_boost_added.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b239fdd46ccd4d9b5fa3f7fc67ffcbd6716c83e6 GIT binary patch literal 1313 zcmbVLy=xpt6rb6z`|zDVBn20VV8Ns~9N)D@2oYNmilm@~NQv?K$S}7vI<2+0bD5d7 zBjdt_!3xA5O>mJSO;8ft2mcW%E|9`(C2*zgj8Yg?d9!aa*qXm8{kEQ9d?&~OxBh63vwKo!{B;V!dgAyz@$lV_R59cJ?qbC|o~?Vt_Jy!*AF zyn}wgL1hh%*G4HjJ-1?&1j;dkZj$iva2#ra-GU#H8iXmF{^3iDVTXH zf5uOtVR{^g?OmA9U>0)oO$1tu@8SsGwSL2oFti*&EA3TTfrEdVZn`S%bD5P1iIPYY z(r~hgV~~jA@dhFJd1*ehtU^c_Q>6$|4*0TD@ z@_kC*DBBN?(;)8)R1>+xQ>V@;kUTJEGD((s%mfgwy%Vc z#AJ55Nr-q2Bo`IJgpr)gDkJF7##;4k#zy?AmFZgahL@&%c>BZ#?sR?~Q*d z7IO&NFW>#z{4<5nA965k$r#{+#{ixn6PegX4%RT1IAJFoMN=H25htl7VNNlLopRDz zI>Jdi<7BlgMoi%sz?QOePF~ALwzOSvidr$k8GFnrX{88f?Qv&9o4_c6mXVozh|D}o zKUENV20d=tq*+);mEsFItl%)OyRPT!zU8^1qJ+hbPi`&Ih4+>gK6rm^IaIE@yJ7OS z3)UAnb{N}WHfwR+x!JhG3?H`0Eb2bnup9=MENtm=Zbp9J@I2wKdmV1DWvl5gc&1!( z+O)&;yZSDe&Y$qQ#hGJu93wt@tOqy22Mrj10lYG#VH0VI+rY1;m(s$RvQ1 z1Dpb!9^ee%Y>Ziw=giV0)Wqi4!-AH2gg(bwdL0eFE92q#(WyRSj<>_id-roHw2duG zs9wZ^%2}H;!CYUcy4sNUhN)<=+T@-ClLin{%|(teCG+Z*@3+N#t!8+fRs8|2Rgbr7 z4bK-fy=`5QUeR`g-6DT3b1o#(7AnH$VJ2EaEt6-ZB_A)QCdB3NW)!{6qdUYuK4A8$ zdSZSUr!x$3ls*kpB8q5unI8ELc%ihtYwE6V8Fc%u&Rc@Z5(rbA`5o?tWX*G#A=5}U z0zCsgj}Sgs1n@0>0(t8X?J)Bc`ZMTpyK`hQ6MJ|sv8U`26Ms+kl0V|dQB6T!D{B?P z$H9S5N;M_bG^n3ZB@re?r_F#ZN-fv&DXpZ#$zx}xg4s<<&vNJIVUI9NsbT9vP%6?e zmN}rR-NTK=`TEBm->yS~TW+hq-Ql|LaSB1KGk2%{q1C7h%V%%5bz@s^F;UkoPgYRP z-)%EdlW~N_kTY};t$^lsj$Yw8+=VUV=Z|tYf^-(!F*3V35fu{eXveGT`JyKj9o_DP> zCAn#KpeleHE?=}T1-Ssp6B8iIhQr?p6nR4zjLSL+Q$|Plo)eY$%NT{P97~_LGHDAQ zTWY{-%b~bXID6KLxSDxEE-0T~0I!*Rd3h1+G1IdWsZvSy4>Q-|*uKN7FqB~tzk}*4 z7~=q4?v2Vmy4w41*+*(`R01^D8bgcvANRTUMaR6>eQa(uRv9Lb#z+gFsS4155# z4(uSr&Zl5tL=hVkTTqxf@$9=IrD1`0=jZpH{eJfQURH?aSXW-KzKqu4G5alt6kcR6t zk%ri*B*yO~YD^g6;7$_fACf~$ILk>QiOOM&J06GZkv^X@WBMbODtFP)E(&Qv=SsaR ztq^IUWtNs%c;!w{EA!}I;U?+WQm%x&3U~ku`(XbM#8b&$vc)!FWgk@`SE=liskMda zM-f+AhPEzKsPrUClr<46(z`ARJ_l6_e2B-r=CVy`&N4~qvO{U6L^*fz4y7+jHm_H% zQz{gv^aEPEDqjp9_2Xws&tixz%_s4!)XXXkIkvIPPvggF5}VY@y@K%>n@AJa1&Mq? zqOF32#X`Ft^{fekxdZIgpKsM@x7sVT!Su~bhhu23?ncSAYvKygJ&J1U4oDa6`&En& n^e(8bZOsv|Re&-6itc^c{8!g*U^sW1y~%$%>#x5o`NMt#A!G^N literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/chat_boost_source_gift_code.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/chat_boost_source_gift_code.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..068af11a1242d4e2496f36df8a8ae9b983db4754 GIT binary patch literal 1896 zcmbtV&2QX96rZuZ-@8eh1}d5&Ss+pEfn7j=L{zFmnk@NHC}}E$*=pqV%x;|6o@K_S z1mzH z@%~t;6cM!FzWcr1${_To8jKo@Rm1!1ARi!#DE5$#EsT|}d77_Vx^Gy9pRqD9r&Ghr z`Z+5HdWL4bykD>i7%^RBVVv`de#t6fq@f0)`Fn^KSmBY5&|`SgW|e927OIx^)Ub-< zk{tv*v_qE%vZ}|G)emmYl9_jAXBOv|8?pXYuo>r;+>i;|+tbpJ3o~nW_%`PE|Yq;%jhErxw!s&}9 zwAD3cwp3>3U0a&G720mVsM*>yL$El4B|w?HZLTtpb%gDkHwE+E$TvH%nCZZ3(hT`< z5!-YCs+u`#J8PzlKq!aQ2ySXgu$!-%q3c6jn~P+UM&fXv#EA>RWS0lj4LYZHmQhPO z!tE*!YsDmwl$dFAEeyMIx?XpEUph`}JjzA}*yGiXJbRDvB*A^Wq z6zOqRurLxqY%KGDIjX8uQ{?s%_ydjpB#e zmi`0&I=NVI0rcgnmYh(WgNUC{Rf{t+>M{}M32_5AB&3>&CytzwNanQ(c@iYfLu6ba z#PMt?36UxRRYltecWz8K-{)eZ3FQTxH8&KaTo6FL$%2oYOKz(v;a0uawVe&S!(`KT zxhki62*}F1A_bhG5J`$GQM?dEOs%^qF2Y8inr8r88=e0$c*&PQ{IiV)Pov7SU(J5e z__DE6zT7J>en0oiB)n9AV_~SI!}8)j#GqlxIm{7T7)` zBrX!-a~gR{FB9@nWP3wPju6Tn05A_RapACf(mEL@Kr=G=0aBujUZ2N1udQs)^^BFY|6#23jhFkz*!IHq z!ev$EQcR69SccCOK-iAp5&(ok zeYfK*6a`dK3W+K*q3%MQVL{}}6wdRfDn_V3og>60AU&n#lFbxw2l=ZhSJ%W97%D{N zuOJ3G#<-83>mBdAsMb5X@1iTc&Lnl?k7dT& zk}8KBDp91u4HbzVQ4y-RBK`;t8`Oj4QzTBk8HEGNi8uB-P0}JH#?Nox%$s@h=J$T% z{jt%gB51#S|J&lPC4~M^oxBw@18@3ZJVXpJ>>>|a7%RKr7Cg<;JYo^AXcax((qUX< z#4UMcs|2AfVT2+j=CUoeR+?rRn>KGN!3}WSbh*fy?v4+qSc(Z0TSoIPzYtK~I z#Bt5`{UEeMC-9|7;>P^7xoJ9ietPng3$rt^cFtdkOBbDx3)_v$pZ3%|+kIBZ7LQEc zw8IaBK!%rszUcD#l^%bFGvB^FKG=&~mRxkz#(5)|fj1w3@g;!3k%bwu3YP&4OXK9$ z5F~^wofUYAX=h<(1u+74acJvSnU$bl-tJf6;3Zbg`n)O*?To~9cxsO{cHll*#BBe) zrd7L-zQ9)f63TzggYoE|1I#$LxqZi8xw}<0pv~Xp#)3M!amSWMun^jg&zZ5XVuax7 z3Z7zW1dE1k%yXA73EMN~1oxc2XDkh4wIGZmvp6za2#6Y|jnMJ9G!_Gq4zj-3j+RCb zgy6Cl_{{N_UW_jL3$iPmv{tYt z++C#fWy{4VM2jnw0w_{aD&ez&6d?^`ZL2eNrgJqA%bm$UQKPf0h!Y43#qDtacITqA z(2;PPPxb8XGE_o#Y$s66Y==-l*;ciO$-ruwRgmVjYxP#d80>V{_!q=m`B4m*B|irB z_Zmu$qQ=A%j*YKP z4aj&V>tsA4Q_+cuwTlBXk;yulh={#WI+UQ%Vl!!?_vY}^v!898n26qNCykK`;Qjwp zMa4^lZY%Lxe#lv~so-Ah!@UEzh593kbzmFNGeb>XOra~Km>d_m-}hvO|A80yDBz9` zYp&qSz&xg`bVmcMt@7EdxbKTo&{fFGpFt%W#yCQ+4|dB2dUx<&vVkTByCp)c!EV{m g_9qDAV-Yzz*e!`ZfdQZw)px<4YV@y{xYFbN1AEXub^rhX literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/chat_boost_source_premium.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/chat_boost_source_premium.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0159d5b633b53f221cc18ee169e9662239621780 GIT binary patch literal 1809 zcmbtV&2Jk;6rb4-e>-W@Qbbe43Mv&Ju#wj zIRvQ^MFMW9Nc6w~6`>x03;zQW2P5TR?I{wc+>F8j<$!pzyQWUko_L;l`)1yIGxL7$ z&G`FjwS<6v`R2FIKN>=R$iay8RKN!tAlyY1QS2fQn;1)3aTQNBRZlZDPd9a#Q>o_W zyu6tQS*JO-;1$gxMoi^780X!RS2oKSDQE%F!fiy0tax8V=mGSU%nB`CN44_49M*7L zwtPPbtiaA6WbUo`xuvVkg;;&v--`3gPRO|B?klOwnYnc|16faHR^U_PmNa({)5;yx!L)pP!YtlFA7c|j9er!n_}sC>t#IZ!k$3CYk^!{3 z&WyH<%D8C>BWQ<~<1=csw+s=rh0UF|<9CfPFjkq%y4>=N%-;yOwCXyYP+C|g4YCD# z5@or91(2^ZZbX1gy_D>pLOElshhb05G#YlmSv|~lst3H=Xa}KaSUu-C8{kh4DiZj6 zX%xvShZnP4-8dGi%u#*io%w55*RFjK=Tc8z22^8Bo}z~Nq#Qg?jyYyA64KkEmLEDc z*}Q4-uHZ67agMVv;(n|(1E1Nl1|-Qk$w7zZ@xf&fzQT85G92k)=05ZX&{Nv@PeYY$ zysc1tPuW(#!(S%X0LoQu)|BLc{1kZnfNDyti>SwVTp+~posf{49#4&(k_hH@2zltl zPlIP%B*bkiphw#H}#k1Q2gA|D)Ej({2g4126O} zd(-MN(XyOCRzM>JSVco71dO3{ND3^;a#HVY@h4%MThBZi)%xi07r;oo2<-12G(3l@ zPk%B0*}~@wyOj(5%F?%2emV;u*&{uHQ$%K_2)@_~(WP!CW*DI~JKxV#3j&iu#|DVV2E6bqOC4r6IcKzc&XC7Vg$4hyqsre5Qh zU?>q4KLZ=87~=tYwtuwkp?d%EZ4X`QA8msZ#(V0iA;Nfipq=j@ZNuC&mIyzZe@*^O LG=DutpM>-;via$F literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/chat_boost_updated.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/chat_boost_updated.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6d4a39cd14f3a9e11346109a97274b98901ba432 GIT binary patch literal 1548 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/chat_invite_link.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/chat_invite_link.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cc462fda3738d231000f70267f89d7300ad3467f GIT binary patch literal 2198 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/chat_location.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/chat_location.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..26a218b1a5b882a048d79a1e2251a2e785b17b19 GIT binary patch literal 1470 zcmbVM&1)M+6rb5|$t%Z%)GqXc#i4;cRO;D;kfItlt#C?hr*shv>z%Q*@oHC{86~mt z!G%CmXiIx2p|pn{N=nJS^pEI4g&xG73_azh;vPayd9$l+WJoS~dh_*SfrSy% zxdpbF*aIhUFw)QlqSjqRZDu{t5qb!#q@YHfE#%i8DbvUKLYStR3}u|9!q@V~_NO1M zllJ@T?GLYQZshvA>A@phzPY%~64vA4;QH=O7D&1zIk|9 z_kccTL(T+CrSL*8nbqUT%)8x>qdx3K5aY$di?TF@vKejGi@>dH#3Q!m^`#t&wN@+2 zIBUvTi_MJpTDzGPt#BA$R4J;|MJ#uq{M@Pba$QKC+aaY;ipbw2^K}w3JfLAJ`!_EU(4`G#b^M4Q3j_{F2 z@lV>3{tN!5I5041ebd)Cq(i&`;x_~{HpOVjc4Vvh-HB6Yq9KEZN(`Fxn4$ zOmxFIQ)j3p4~9&%6tbj(u{k{87a;ZFEA#j@t1@2$mv{%n<6|^kM2$DTUjK6AtBt?i z*T?S8&;37acqndf&y>=1cTOP&`A*r8np^<|ca^4ED+a>PDQyXa?x2w4 zI!cu867tz7OlBUN5Sm4>eU6a1I|RVNokm3?d1HoI#F7MX#(WuELXGSyUr}$VKY~K2 z35oAOKy%N2Q_V1)DN@2k=E~Su2L8)fo)|YK#?o=;xbt~uVq811FHF&bc>_-!y9N@y zl&lpQ$~<$DzgpF}>DLt=dm}iwfCpC>J-1+xF!{3S;$$1UpTb zTL*R!V&_vZR7@xn5>vOJGIhfCr6myzQO)U3V+~3;DN`0Hr@c*Wd3^}fKTSHWze8&hoIX!w{90s zHwfoK6P*dJ&S4$fI$}8+N>UueFIb|JIKN@jplw{o7U5RnY2sw{=njD~H;0PUbK$%#_oG0BA8UEq=f zTLafcu{hyO27fkiVEyC&&nL9Vc&4-@S}fu`Sd6cLSJPS`RG;e#2$C5#Sz^v%0p-bc za0R5CrFsEl*SITW$EMGgI6QQLBJ1pjB?|O^jbwB%jZ;Fs35G_#?Qm{d>9hD2$#8Iga{* znpTR&mAf-+>O_pcigvR&QkiBuB}v9)$W%1%nx5;L-a^*|*lXlXYq^vyV_mM_t9N-{-Y~9xlIodJ kGao|u4ct0g9^U~vTOPBuO=uYXt=?|`w9#Mxm~!QR131THdjJ3c literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/chat_member_administrator.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/chat_member_administrator.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..315bde11ec09427d5d1c8213b146277c2707ca89 GIT binary patch literal 3469 zcmcImO>7)V6|SDC`Tz63W5;&dKXEciuoHH(8=_z^PS%@j;-J_OV&bUNo^CrGPj?Sh zJqEA(V5F5;BtR>z&_;p-2eb(7p5eY{4n0y1t(K51amuYxI3S;RuX<+O7G5EcC|7^} zUe&AL{@&~PL#dP}Q2z9rzidAkCgg8ubW18C(i;oNXG9~K)F7r*lO*JcM#4ettd0wIOC}=Hn@2FA zcqPXBV!S`b2ReMPmeqz}Ps2SsC+v})ofr0K&n^i2OwTTAV=#U^vh@-hjo*Ye*!w&C z+q5?QG1-wI>=`g#=L>nU>bl)xb^WINUoD}=w=bqSy3kSNljB21`de7O{owA} z-Sv$}%Nq|LJq^-a$dVO7JOOQi3Rl98JcbjUmgr$J6x{AjJgBv7#%#CqRDL27IQ?6 zVj)<;f`trg+Yb70tYPiJrWD*Qk6M~GcN7k9&wzD>5AM6yG7#Hd$7}7V+zr+zc;Kf& zKRSttdM6M~Vy0e`n7nDg@w>+qPMyne?50uYN2T7>aLA`YvEG7JO~o;shF(pxKDcZq zBTOUAAj~412MDUl@k=|QOhsw#YpUfKb!GR*D%;@qZUQjrCIP8S0aI=YFzu!R zGj0Yj>t+FSZVoW-<^cw71Z`qb2a-v!IoK9+2<`DNX+J&d*nWvHGew5t89j`564s$xrseB(xn4 zkA1Qcrm#0n&RuzFh8g5pGIic&ghrWMT=Fh_JFKA5 zN9J#O=f4&9qcPBN8$@F$8b6GDgv@-?o4yu~qH(5UjG-~!G0vhfLFV4^X0L~nXiSmW zx4oIS!gFZI9b+1ena-G5H0C-z=h2uK`}YTC!z!95PcO_ja95;yDH2cxI1_rtTpNjc z0GUv>U_#!435^RTgf5s+yI?}{f(hLVCd4n8hycMv7zid}K`>@z54}->1OhuOi()U z=@FL_R22BC^nPA}r;JOS60eM62TC+3bwZ`CHyRML5?g>)4vHk-WsB%l?gCyk|7)bx z1JeBq6Eu|#2||&)yDGhUXXD^Kk8VV@O*eeH?9=kWy@Pu{z30<8pN@K>w&|!(pZIjd z6SYl8e0tlbW1gsOIu<5K>RHmKlb)z;I_cAgK9xOD+f?@HichCJQQLINr>(d%4tHSq z@q|8AeLC)m+NR?^T{~&sjhi_9MZ%{Oo~Ug);nT=yyp#2i z-0=QWJtTA9$?B6??_@np_Ju@}&h}n>Bo4qZU6&-do73^-i@%GWe|$~9IM}}cs9cdf literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/chat_member_banned.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/chat_member_banned.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7ed43f5cff6fbb71327c4cee7c86416c5e2a47f8 GIT binary patch literal 1918 zcmbtVPiS047@yhq_U->oj1g0t>Z2{l7TgstN(iMk|Jt;MVp7EC%Jl79gH)s!PaZ|^>R}5xEDsL>LC9?-9waBfd9!Oa#U8}TH($P)Z@zi+ z{eIufep{&&5wst^`epUkEJDA@!JxrdHhj1N`aYtFVh{P)!dTiFFXL;L=IfU3XRR#E zX;k+NKWF8@&Qin6`vt3z+BvW2m#h*-OydUl@?P1mSQU&iXaUi}T||ql@K8hO5p>n8 zDlILeTKPZ@Yd9&{K@diE&NE#|ivUxvt79AM=r9y?&?{Hz_Z71w8A>o*1Cj{M}H>B_)|5f~o>3=CPAA}ezf z;IK5N-|54IkY&&e%Ta9_Ru&M|!Or$=1MHl#S)Pv#N74KPOsn_MDyEgYRjY6heTc2% zG8+7^jU+>fTm~2z-Tu93LVKIFITI|1glU_%9LU!6({#=0+fmdOQ;miba#oL+$JV&* z*F(P6XoZnz*lqWmT(6d2yhY4NMsM1}Y^7f?-2kSTnQm$a)O76N<;dhLiaB_~V`s?C z4VP`Il|B=~USpzOOb@sm#@u03=6^bkIzSqKWcDe2@0c+~W&PUKnQL>i?Ns08OhktVToYgDj`oq@@FADDG=g#wh)8}1IDsW z%-y4v*{S9`AzyFKgwzezn(HyQqmUD*h9(O(n%CV{Q^56krENRwlEJ3!hO%ZF(N>#@ zhO7gks)Zg_Fl3O=xX>Pb}VgHyi*Zt)tZzjje?0#(j@HuuTGrwe=K$xgZT_5Ana zKV1Mr$_=}3sA0Kv2vMk3R2hzdtpJiNrzoW)rwON&@p0*RPR5iZYJu%DLXsjOen?|a z+GRpMh;6U$$q_G%;8q<;L@%jnsB4@p%gv_q#ofh^7Q6cSu0GL8 z<*`1|)x-VVcn^(c9o(y;H?H8l*Oz*^ash_uf9pcJt=fD@^D~2lmf#%%I9FqM002%d zZ$n~0aX>XGgyhxXvgDF13u0d=XiGzt!{u*HVmPsgLSHeMmVL@<3f=Q^kMx@o&ZGRa zqVFQV07Hqh_!(4B!x(qb+0IGXNA=FrWgngIoRls)*EuO&G}$>R``Ty^VSKu)ztA}; XJ>x|zq5pUN#r7Ym=g+73(+FU>oMNvse0*;AL)2d=Inr?Q-&L;a|W_Am% zaxhXQiUf!Y>VY0OpdwTW!G*t~2P5TREtg10NV&NR2b2?Uc5Q4+^niGtdHZJGd$aR? zzvunFRLUceU%q+N{6j(Lcd;0Wni}|I4~%=rMmBblhYgH{ExD2>8?vVuil-VX?8&y` zYF@_3fUVk^oAq)=4kIcv4b~Yq?-h&!MiSaUcJ>akb2RrrM(82TRE(mX-$v!au~?RI zTrhn<2+hz5d|sC0(zW;AT_dY+t*vgpy|od`Z}^=!Q+GnjO!rtyQ|4B8&F~%S?NGK2 znGrw6sUtsjz{$#WPMIZMGZH9X2tL^b{V9}7k%4VwNY|lkL#E2!5DtV4&6a4!mX{zh zhinCGHMMD$%}++!+I?&n@1iEQ3wLIW++FlBHlW1Ovs{X2#`mhzW_bIzybf}ewi)Hr z54mpYH!Y}1_mZOYrQI-W^Tle_3K*?~)TJ$EdX<2+syji*t7hA|AmY>T<(otgMYhBJ zOQCK>jKQI92TmQH7c?P&>LTSOeJ6tVm>qpDaD3efg~#L6y+wH?pWJIZh?qqe_5XAU z7wSr~PhS|a_5Qf%l%-02ZT;E@vBne5SOJiYl?XU0V>T-mIvJ-3oCs-mY|{@Ni|l`7 zvKD88o>*fvjF=xQTY*n4LA?;s8yZYF7N1-J<7<2mHp7u0b{@cd2s4$ve>}EyfDa@a z-vN>qCpmTV*M^7@LEPA5d9}RUWk|i?f6{z619wtMUBAEeYV*BxIb#o`TFc zM~LN`oD;%D0fPJP>D4zE8#e;B-&hT7$8REPT(32s=4lDpG3pueOdL!+ESwbd02@oLuwMl7lX$Yi6T^GQ|>^X38 z!Q&NnPDGVPswf;kf`Velzk#Hv*#Q!&h$_p6msh&$J!K^wzbY$z<+Z*t)2(%DpVa!w z#iPub0h(3ocrb%rUB`#7)CQSC4wmSD>s)eddiaE93!?(I;IjeXH6v(s0FR09XRHDB z&?_k-qLrBF_*kWWj!>od7%Q6rS;}*Y^4+Aq_vJKdjnvSVV2$LKQ_-X_};j##Buz#MaexvolGy*&j2r zTS$~ckSb9mKwMA{^uPfXpFWr<;0s^n>ZB+A;xc>-^`mg zGw=J}?040wj-dVU^)Jgm=Mnl<4h9Xzvf(Eipzk7zDE5$#EsUj|^K!moDZXl{e%{La znx(ax+R;4oml$7wJz}woGl#zKfHR60?1(M8J_B35Dj0X<;e)1TMh3|z z0187ErpU@&1#m2dsW!PZ28$6#E4|{sx6ElG;B)U3{a!Z-CHh1Ghu|> zfYT!GIw>i2J-x$17;}eB82{{Q2oC*Aq>o9P%olo2W7H z)Z7~zP=0N|;q^q1gUIy=1yao%e+E|baT#)g>~EdnM@V~}+OXOoYaiNtMQ}-FqHz|* zJV?}L7%)ecjBK(*3((8*d7KC1D|{CUIU4w3=05ZX(6e^)FAvRa;?3NqLh(IiQ~efy zkv=CVbERo2*$u}aCcWnO$jl{q5w{sniiEg<8xdk^$=J|kiD2F`Ax}l}XJL<|M2O?r zLJ%S}7|Z%Fw)Pe;Otjt$`C4l#q;9a%T8p_Ig`7YYv{-Pfb;(_733x`Q+qSc21I;bl z4P~t~qV+Zt4Ot{4qpSZ{Z?E$saKOglr%|mBZv7It#T%gh*h0M*Q1#g7)1S_MHoILp z+NmskGxKo#$5+6Ra@p=1*|4(o1fr0sXBm!y%~OCR^(jjHkhEmNDP{aQX+00htVq-X z+h>F%Iw5{YV^7)@LOzIXukR@kLPG~2EI~}7WhIuLmW&WG^v!`KvUs@s3Z(fa)jq%u z^E_Y%^JCx=lIwH)xLh?dQ1Z6oCs2_8{;!u)^Ti&Ls)AlShqoIuTQeQCFOSukt~$|G zYg=<$b05!j)l=P<&8@kPYG(3SHM?qar!d|_qj?ASYUs>Gy!~c#=k)8na-{?_=zr@{ zx^uSwkmi!lG`l8zi~!r^7@i4W%jMHZG^i9Ptqdvoj<~EpE}u-2XF=?X4D9kyEpd2E z5b4As3VmLY>-Tw1aXc*N(t{u)Db+N6XQwrvz-0d~2S5LHA;NE$*?C9M!!SJRDml5DacW@g=x zDhDG~P^5ympdRQE6`_hNe*!0j94Uv@o+5F|ZBaO&oOrWq=L0Gs7{7UbGjHb2yx;qc z{e7{RL(qQu_Lr5%3PQihLARx110OhGJV6FBu!U@_VJz*0m9Udq(k2?QQ(DSaGzI39 z2C>q1M$3SmG88Lo=d>I~EXfrZr>(qQ&?wPJ5$|NY>`sn5qotT-Lc>l)ybdVf(wu1DW=`pTbL1v*L*Xh=NBHr9P zv8H<;FngKtC5X`!`#5&wjva6Yxh)v4%LBWO#0Eb242;hqd4@D>AT4nlK+uwmtardc zNK=diOB=~CSeZoz0Xx;P6|mDC8z6yX(?%{Hvn=mF8O6vL`KJlv%pVB8|f}Z1BFKjxDKlnALLR(}F&IEHjq3Y_rI;5=HQO@evn&&mdXti2*IjeZg zVyj%YD=uHHF1wzn>J9UXTpusLevhi2-0f~U0xYIRv2@2!*K~+&S*mW>reg|^>z>Qi z1~>1U5R-{YF1pE*+vIgNs{W^A;WWmh?T42-mArGDXk53-#NyQWt%b$Afg++p@&dpe zkR}u^Aj__61qD-3-Eo~Q+ii;Z!(x{Uci^^ngF?M2JlCe4=~=9t;JvV&pOY~z(c{A+ zR4Hw28M@<{b-J;s^HsrRtpkNKugRT&%)1V&OCHH4iIRbyM+hHGg7FQ00_^s>ewcX% z{Wlk;T~U-1m=;{8&|%l?4Mi6AAK4ahn} zDU`yaw44t5PTZLaX01^AqV0SDVgy-A>y|DAr6LVu$skp29WG6d);@IkMs311OlP&W z(Ts{rfhaZR+^@}<%QXQH?ahW>-_W7vHQjV2ovPkegNdr-3XO?Gqmot{Tl@kX@ZkL4 z0Iqazu7X$0g8H+C!XZ?=_~q0W(~qZj3l~D96ifc#MgQDO{>3s#n1zXGHq4>^;V^$R zlq+M0v<@H|Di`AHd%)%qf|4yUjD6CQSn{({NkpRh@F8=@m1*inv;}KHw)p7VwLR```NHM2rix}VuyPW;w1+FNazW{3s2rK{q literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/chat_member_restricted.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/chat_member_restricted.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0bb342c46664c170e8b84b9e40ff7293a1e0e9d1 GIT binary patch literal 3252 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 W0}VL4tHakj|4p9!dyVI^uKqteEo$@t literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/chat_permissions.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/chat_permissions.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..659fdfef0a63de4451981cf981d241b45843e1db GIT binary patch literal 2691 zcmb_d%Wo4$7@xJruOzmUkc99EI6MkYNDKt}h)^F2D4>Fa3RS6_YP8;+Bum!2?(8~g z&>nI?EtT5dDh}m{s1W!53%&HPmU>w238^P;uF^xrsoyu7YyyNH+KxZ}{QbW9=KY)T zPx*Wof%5Z@zb+i=Bjk4^TO}1a%0?BO`$Q+YVv>eZQxxw0fVo9Bv z=|-lOQAmQ!5X{p)oPCD0tc2aFW!bLk8n)$>lVSemr`IpB znah`EKD<($4U->OYhiY-iPft4Oo`eIUTe8(-Q+j9$rpv%n5*CBnyW$kiwEY2*c?sYC2hU4Jj+_~RXf^v~NnlS3zDXE$~w2}*XCADPP z)`Y4z49jp_p}MvxwHz)=1|*uMy~_2HYnNPgnU@R;(lux`*(JNYVYh_Fr%Ow&+jOQY z70niW(%n4UNn0#d>bC1t)TVJ1TQ#@mB%4>C7q$fQS>3kH&%-`VwV1;#oi(`QsEgbQ zi*ZP8>4xou{c%9IwN`^$?#`sUb=MWf(Tgdk zgnMIdyGvYb&ut%8sJhNpd7U+3x~wVqiosVmCjg7KAZS<%cG!!#hP7h2oZ!%uPqiF8As|SMA^6n&JW6ccq-hjdWbxN z?-Te&<#t@7Cp^VVcu9|XDKG71ysVe=y1Z_$$IE*KU3pOOiVv0V<Nt!!xVw05c9!+$A6=ZD z|HKx{^E0+?Sc~(^EqP-Y=zN}AEAv;4`n&^2JkeCOWz_GyYS{SFRot~EcPe-d*p7QJ z*<2H&Fw&jjmyTz0Ytg5n)>#7hYn^l^Nq*$JOW(|XJNsMD!4B!o7lI>GL8%fPJ&y=> z{2jEz6T!*%g0UHljGjR|GSwM@blIkJi0nDmIUG~$C#pbi1I8ldQnamb;G5!;o>ZXp zqzt7ewJ1F)Na;ycN>55tdQzX#lOmO#RI2o(T%{*9D?JphkRBe6)TcOz-UvW>2!&y( z4bE8D#aP4ETPFHFjD68k&CQw&WAIFDsw6Bjw&Pz5qW|??35xT<6Abg4+R?aaf>srA z6rv8^gZITT%)@#@6S2 zIu==*js^5efVo3H1w?DpiGW_+HF3Ab;}xF{`xFqZO)CMd2D=82m)EO4El1X-<$zue zCeQlxfKLI@+VpHdMR59@Pe*(Th}Nd(0?J>R53c80A~-Sb(*d6XqP6LGKx?}Njo>8g z#Vb2`cgLZ?8^oQL@Y5rQ-I7TUy_;LYja?F(2{nL;~#t}}Wf2ZH~1ki)^` zh%t!cTPIsB=TM6aEqFsgiy{dXVH&PJycLmD@R1d14AZ&_e*>t6NEwIGlRcqYo@Xya zihfsAfTE0?uK+qpMNtBB#DCGAl8XO&drD6DFIp!(rzo(F-O(Q!|3g;&`I-bd&%Xfz C>%cGo literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/chat_photo.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/chat_photo.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3797f52e9982f35bf6494c391fb9424ba5535e92 GIT binary patch literal 1538 zcmb7E&1)n@6tC*9`JUAzZqy{w7?-6HGbay*MU-raA4?2uL~I6%p6;5N-t=_$R#mH6 z=CFqaS5WaHd(fk-$R51;S9q9!hoMgaPkU>L2icRasxz~*n2R;9-n_4Ry!yRY{d22T zN3eeT;rISQ1))EsGFxUT;Ij`vcz^;F;0TSdi?NioNE_*{J~CVbbUiR4b7Z*|MjF~f zfq4%F7PTJg2t9&bF1Hd?ZX&1pSgH=r8(thI!V_TI=WjSMu}p_^b!|mry80E)I~ZeGCP=dZ1Aw(652721SEx zEXd}9Y?U%KSv_dpM|~VL?loQOKKcT?Q1o%;zVaV-7m1Z-V zGRkQzxb4|K1lp;L+^Va{n@Prex@`}INcncB<0p)6iSx^CC2Y{?C4zUnG~ASD)lqdY z*STPMi;ui0BK?-UALip@D2;bue&~7pFgXJOYN3hFvYwiiOF&=AUeQX5y zM`LXMguhi|1mmFZI|hT4h&3f^N!AAT3xb(2d6rU^R|yH@P!Qr&@}-5E38zt?kc*D9 zOOPY45#mQ4=Y((=ZzP*#+jpPbxW3)}Bw#0Xc>~J3UYN-F>xko&@{a5cDf^lpvlk%qouxUZTeD)=6ZpwR(tx&>(eW5P1mnZH{UF3U{Kbgj+S358go@fmJTVMK{n(x%L~h=TY{z} zg`AQkd`w9a1l3aZoRppi=2Rt|u{WZGwLKfaB zfGx*B-8pZaqw7-`O5$L)3N9|2{tkOlM%89ajt&167(ns#S7?S=Es$hQWUfw(%Rnc_ zONDh6L+$@%-?jge*1s=ssj~hB6S9Ox literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/chat_shared.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/chat_shared.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..60dc75aee9beb70a446b2ce926ed6064fa9d09ff GIT binary patch literal 1948 zcmbVN&u`pB6rNezyWUMUNt3h?C2idF2i->O9uSwPLO=)!YMN9e2;pv-dOefGjo04J z%o0-Nu$3xNBtTqH5A6{Zq2Bo`I3%J6%cn@3dO$J?2b2?U?CiD?ASA{!pWmA|etz@4 zH}((ZatT5E>Cw+?&rF1VRZ6!RnSc)(AUs4AQS758wlP+6&d)V9TWjjJ-ZX5ZnYZ)l zyyh30rfp)xG@hqAHT+_;WS20?p?O5}_Yo~H^NEJgQy5vZ`>45sD#hnYt>C!N34%~M z(hCDo(c|*!C)el5?84ma)en~DW9^+_JJuIHA!Bp7r4~6pJT$P%e74S==5pgUbLDfK z`6^!D2xYk9-DPg}vJCa?h7az8@CEFSAsbU<=RSg6+8WICEJV)JU(s#~MBH0Igv>K})E zvpySAsFM0-n>#Y(1kzP!!DsbFuTdACWUsdzchgyCqJC68wX}L_X|A$#R$JSA9DLs$ zc|mct8}wN)h-(0Uc2F{b%BR1c`*QxP`DgtT2`ZEaqVWsStCP{G@o4NUVA2P3sUhh{ zBj=NHPgRREgOU!wA*u{ydoP2Wk(f#;lS67Q&3-DW65t~W6e(%C`6(s60#NBw9IL`2 zBrXxs3~Ad}az7z=+Kzu@DG)+K7p4aZdFf*X891IhuD&xVA#wSLe3$t?mbCrgo3_ee~w;fAxKI mY4>>F*M<^=@x@5LuzS2G`DqL+{2jhM^She;;~z|E@P7ewz6Nao literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/chosen_inline_result.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/chosen_inline_result.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0a0ecb02b173e712dc2e028054cd1edc8430fa84 GIT binary patch literal 2313 zcmbVO&2Jk;6rc6(`ZIPQO#)3zwM~kG({_zii9=LXh0vxc#YO!9vACM9z2kJ7^{zX! zP6^7vl`2srKwMBO(E|t63Y9Zb{|63^)PuFBNSu0G6b>jS-rI@YMx_EVo_&7v-rG0t z{ob3g9~O&w0^`>oerwVkA;05dFm%Z%TdTm_B@S^EkF*p^QIJo0sg`P~EzQzex}_&F z)l0WBRt9*@(Yaa^d!Q2X2p&1C zl9Rtk%7v%6EGtpL_WdBVLpSh6S&fR9KKVx+$7uSMDOZB*MHnCquq z<~dIl`EuzJ^Vl-CTj%T7StA5}_FT|NoB^+07K}IKwvuY{OWC>y%$JZmBbMS2D|Hz# zuv90-G)FxSx*TM{bj+e!FDl?~u{Cwh3GmEcL-&X1i)}?|d(E-^&~4C_n>Jq- z9B+px%~{ytexy|cs2-j+9H@fJgg~&$)@fkASMI_=2?u(RJb>pBJaSwgYMj)%vYuL3 z*R^%sQSR&O>7SHulM4qf1GQS#`6#@?$B^tnG7S4?Qcgv>=(GWqETyjRhLo1G(b#jL zQ^C9@r7!itUk8^_j?#u_3qh&K!Wz#KjPCZw@6Xph3HVBFA#k9vYAYRXhXJS1HZ|t2 z*3P;0ns7sQv<;04xQd$X26*dK!nHON66Q^`N8xtfYqVMTeyVYCOzIFmY`;OgP_;Iy2X>LrKPbSUoQcpAG+|bOv z_Eujjb&`nC#U{ z@i;m1cE55g9-YVm`u~sQ&{5)TNci+1w;i_qTrD>$SQLY7aJ_Ov&nazH)t#!gBr*bC#C=l3!5^xp5inV(9f z0)p|&55IO^*ARLlg~?D;2A?*7d4L#V*g;)vU@ZBJlj$mk(j^Azs)hNuJ*UDpfD!1i2USEAC+Cm(LojdwRU-rH)_ zBjqjkAj&m+(rh|UaeAh_!yUdW%x<%Nhg*S_dQK@xfB5ten6DsgjttC@k@*P1Hx!oP zgekYcmWLF8Cu1H`fM5yJ&gCr2ft){=wZvXXWu6n$OijM2hYGuLggThb9F~pz5&9e( zg>5wX>$8!z;kkin1^4Yj1;);v?N_`c^orm;!F}!qe#NZx_B@wYtaS5QA=$j`^@YXP zD|9!Z?D|4>P?Qxs=nFR@4am-tC6q&&^01~5!l&;5^F4k5Z4*rFpm_xAF|2glIk&LP z01q+)Wk3ch!w=O#_DB3((v;9xN<&vg5srwGB$s3T8R?lw_4_?QBS)$2+5x3{E}Fd% zI`z5Jq4b$P#2omI@|0QtnNO*o16h_8#_(+G?e*5jp4e|~c+7TpTl;-s2A-f$q!xGY zw%)hfE#D6KYdzE2H+Q+;GHp+`axFOMaUaT?bjn)qKrDdY`!i!~*Cx?k2d)1BkiUi~ zUP7hiZ#TcLe^dXhxD+F;R1TN*aPda?LN$DTCA_v6Pk}Bm#6>jsQd~M0<>u5Nxl?e6 z^m3Xslw^!v!X*%vr7o%YjO1kDMWT~vBy|>7B{vU5pOWCpHls8uP}=oa-;sQg($D&) zGqz}yGS33_G^H0F0f7E;(S*Fx2^vvpjJm}g2MUM9BA9&H7;lOtxl2A~36Vwde+L3E z{qw~cqUK^GNfD{nMr0o5F_{lZB_wmh=CJu?GbGo;mFjS7M5^gLCe@JW;qvORJ|e5> zJSMAg2B~#5TwED$j>t+nkI70%?wx2?W3-@_<5~3btKkhjtlo^L=koyf|08+nD{**E z#PTH3hMt!gclvP00AnE^+9(Un1l^Y+CvTd_N;PSlaF-=CDNxTzF7YJ6JImclEA@uB w38F;R{{l#?V2nfb;^^``LABAd=LxEeF3&jo3WhZPO^)0@r1sDMFeSnL4VI*=;{X5v literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/custom.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/custom.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..822891b086b359ede7f40c49ee365a474679a55c GIT binary patch literal 1301 zcmah|&ubJ(6t3!D(=(ZIG|8+OST~9o=imyP!-ALvF^GqdD7v@|4MRIs6Fcdy9;&K! zGbqf#gNI!R9yYKlT!m+D!%Ue-mBNIUe)(r z^@Bnohd`d*eO{k65qhmBL&neA&zhbM@GfKdTxehWL2!xwn95{ zDh@^ztqe0DVy_xH8_yDlVv?b5-6HNStCD5zE>Bi_C`1^DS~N>tl6y3^1?Sp^F_5}( zU}&OBj^K-^oPVP|i)BN(#FtbC5mm0nX3S_AtK#|457}!6QP~~tc6V7UQv_Q~Yv5QJ*$fkO6Uz~Q1goUZ z^FatE1~G2nN9L9V>|hL}3EkMVhqK*!3ntqm#}=G#dvr#qfwdSsf!*F{AMkTzGhp?& z?C?A|xX!Q4MAnqe8OH)5`J>KwZtNt<-o*%@^+>cJkwFVU@YKf3>^nGJZO;(4U zf$fHU;N!53E{Zq{&_ca$58w0Jh1uVK`OUlSJ(RbN|6H`Uv`+6|-INb6JjTxsw-3&B z4$gG}znS~HwD6*|&?zl;ON*W2Qn$F&c9(V_6Z)uontR&4c`!DR992#CWOLU{uN=r% zYK`Hl@jVc#vig<@=|_z+POB$$zG=P>FlCp5rYWWXTIiqR1elfv{Rhv z7H8V-44;6{&9Q`qREXnD-&<2z^@P>b*x*K1bxBqB`c=xRiJ+uBrcALW(oPQg>o(Si z&ty>J`U0taumGA?rN2tbL=ZE<9qo4;p)cz(kCYiOnI2HN^YANN0xo}{^du>PckZbu zCP_$t;?uBDGZQZX`XhjOj->7kkS=iXQ7Nc-dW)5uq*bL-Ulk1x!rwmH?eZ2LUk zJl98BKb{!qFXA}1kLh4gIu_LbA&2s%o|W%e6Ro9Q;ZSdKe{cM|e#Ww$e-Xf24SmzL PGjGjI-e|e{N!h;#Nj)>J literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/dice.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/dice.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..11f00a6b0cee2b156aeb13118ab4a04d24a90a60 GIT binary patch literal 1741 zcmbVM%WoS+7@ygf*N&ag5*o@wS`~q01U3ga5LH$4aFaMDLD;BbWofk8nIxO6cg@VY z;3@|r6%iy_!~sVXO*Zv78>$bo~krwC5Hxk?YHC%)OWNdh@BJM-Ib=I8nL zd-}&hA%|f6_VxYsn;JrY%FSr#selhD2)7YM6#J-!ZH%R?_)1H))s|*!uve+(>n+1J zFjCM0qWTR)4QA}A2;G5|4m*=@8Q{!41sGUE#-!OgD&`)@Z4t*~P7s8V6M11Eib`B) zy!Up6%q>>tmX}r*Vs$3yKEUZO#~aLN8{BEFu5B?la#MXN4nK?!tFZqBTwut?6xqtV z;EJtMg=tj12wWCX4P-r)na*=`Y!|I#n!Ay=ja~F1wlj4!dKdGtHt)IY`o}p7Mq|?x zR+xO<;;hY?U_m4-CxGd-oQP42wZbjWiZ-3dqMm5`P8WEKI{^(_)-}iPuu?A3RS!Gd zWz*JX6t%^4x$K6Vm7<}CrI2rw*TP7YowoM^1q+fpu__`S>&Z7_)eE9nPgKU|h_sTB zc9%LqDoQvZ;$soAKBr#0$KLkfI)+J!T~l z%wH$u=n@}?n{k#9*LQ>{=%uhG3hJ3p@7g8_SXl{476NQ{Wl$tEK)~tDJ zP2olC)wbhqI~zv1 za9WV5I7dh;q#a+%c|zXrIR22y5JE#2jwc8?)*KKgXj_yx5Eq6aa+&W#STR2bl#m&^ z%%|k9vLi4h@dW@lck~PtO*aQfLLTW8y=t%eQMIp4_qFj<9w_&o)f)U~@v~Az;#-mlOKv4xfF)i5I7&l* z>`ZSyg)>vVYJXy~x7dI3e6Q9YpX@EjCsib`gNd?e);rM5P&8cn5*tw5&<$y2B;Bs9 zIfC&FkZBFbtN$|Tv3W5qy-WOMU}eC?4*&xdW86m<_D{|O^y2<$^8i`(E d$K6X06Xwxz{&fRCH9-G`hw|*vDMS*GzX75Mv`hd1 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/document.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/document.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..81389ab6971950d94b47235d3cc71f4a65ab1f91 GIT binary patch literal 2093 zcmbVN&2Jk;6rc63Ki09GPe>I?v%(ZumD&==D5_c|QCf)7NC`r?rjw0l;%u`Y?##N7 z%0fY^M38`6>46?m5$c`4fHPmgU)JDk0BdCZm>Txm9B7FHtp>aLDpJKd=JZ_oS(Y z#kEgY7U%PuENpHEg|1K)0N!{t(1O@6)z@fO%^SROOhtv0j$_*CcH z9j}MoW+fjdyy~|_gU=Y}I6CW9E8Z8XG7w=F%Ry}xmSUmp+4tM1FCUNhv2$mDkk3Lr z*lN2Qo@G17#epBW=}v|zPcxnDPs;c4&4t^hE}I!qgiWG^?2I%2Ld;Z{mhBc7 zVUAMUvja*^Jsdlc0hQd@r1ZZ7iPzx`p-ySTv81F_!dHeMq;c#Xe>gu=|HK#D^*Nu} zUbDX47FOU33c##$??HXZ-l$7E;8$B#V;iwpw`?D;dKEh%tNrFzT07z*M1DBhFLkAV z>N1$+3b4O+Npy)6-~4Xjo5gPze=l5&NUm7wUYPDqU+qqn2NV^-9Q&dY8Gkz(9;moJ zaiDYrF^M^nA7`{vXc!#}6c&4}XmH1YmMY>BSS2Fox|qgQ z0JnspAR}Nhx%n~YKR!- z%mEWdzXZ$X5Vl~m4c8M|An|8}u10XaE2J literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/downloadable.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/downloadable.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..77828d51d2fc2f5229c6fc1ae0beb8503bc4d52a GIT binary patch literal 526 zcmZutu}T9$5S_hCG=!YSQvHGyCap-YF<{{t1QFplST@;BIC6Iz_cltp6Z`ztzhNXb(23oxxB7y$=Pd! za-7sL$_;E|CZ&eF34O^pYxyEs?|8nT9&c9iNrBRk1%lF~NNFJX05dcxQF=9C{vu;W zS|yv5vM`jIX-|d`rOz-;hnO`R2kxa*J@-g*FYLO#fnr)J+LGE8;k9dfEjRMC*z2=) zk99@lGEa6D3u=1U7g3F`Ojhj=Rl2XtP((x-M?Oj!hTAc(gN;H(u>-W>#rc z3{@b|w6wjI6xu=$C2h&Q^pEJlhaSY93_azh;2cU$eY2}ol;B)Cnt6I}-n=*O{ob4X zwOTDB7=QfmSND;L&_7DZ2gqvRvk!pYLkuzOqds;pR=nnGecjRfhGT%NGs8FgmSbV0 zp$){$JBV4_y00Vj09H1f0xRsGTJfP0YdBe;K@i3?_QF8cw4}QG@wFCNd%v}|wYj~K z=dx|ZZLfXbR`HH zcw>$?GoG8G%ogsVE@tIB700@ZKE)1%n*Y}-$#N@j#W0FFTN9k|Aoi#)=~ob6*@m&s zr7OG+mo}p@wFSR9@Zg-?4Ta5kYUu?%n+D9LgZNO{yO20+HC>-d**u_Ls1mHl!-&f| z&u=3UXroZX1Q6(hU40hFwW+3+DGuuP4(B#Fw-0i-?EH+q9=Zc%o}z899L8}Zn~jDW z3SN(=;MPOYYvlJ`7To3DEeP?d7eE^Q)N=KJq&ZRB4f~PLV-D%5)FV|zJM5bFw`g9R}Q09jJzCvjVII^&;K_<~w{3 zdOgnduyY^Q16bL(G1D;Z7$0lLI>SHe$Hp)C+w=v&OVGD#x&VhrR1~QK`5nPaFy$cP zA}JE$1zt=@%}OrJ1xqCNyM#PvDHg#zDG`!36d}?AS@otpda}RXZ10ESsJ#|4sA&6W zAZQ#40+_aWaI5{H*J(>H=2s)?9?>3`?P)tU(spdjASZK}*Q23WhC4pHcpkX*Jowk) zhX#4bqc7PS7R-G-DHcjV(f^{Q)I;WHj*3_Fc((y1z@|HZ zZU=0H>hQ#ZfW iou}xnlk?^&vQM6!6YDjsazCGbzxpWEJbr;b4e&ps2<(Ue literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/encrypted_passport_element.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/encrypted_passport_element.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b691eff9e1f6d5fb0e4e4c89d7aece0477a1f768 GIT binary patch literal 2417 zcmbVN&2Jk;6rZ(c{T16uzml{`8ny{LQj8ust0XI~n_K1p5@B9@UY>C5a4=56+-WG)e%8B=Oy>0_k6vl7gzTbOqW<2wL zGy8ommm$!8eDKriC%Xyx6+zVG(2%yOVB9Af(IkU3q_QNT9W!E$csbsnW!jL-awAbr zfIqHLBiTrmQxf5EkpL_k=|-lUkw}az5-o9;Xi1)W6er{{JYg#jX{oD3Nk2iTNZycY znwFzFx@Fo5^>WufxU#^`zq4@u;?nY>7k}H_@aQGocD&T(CMK!I6DjPOzs3!|Ce+5| z>P=pAV65yF)wY|Ka4zTuuZ8o4Ivu{GtzW?S92Uq)S<*;3_C74M9M@u;YVmUrOT%Kp zrhOY0t0e#@2RISn)Bq;~oF3qmmVx}C0ZwaKz_|g=1UNsyLjfKh;B3%;B*Z)?_G2NLDkOhM`xar(^oGCz?=XOo# zRc;qFtJcDRU9d#Ka_U?ZqFpUSeG9P7VUAr_1=k9VGt>rWMoc)O)@*?%(n|>Lw1nx=WmsYjiH{ABaUPx_LZq!LV0y2kB_s#|!2l#pb0 zX+TF7@safjS!`~ILonZ+L(eNN4`SAe>>i%& zT?e?;gMFy<4;GO~o2>j4{2{=!1 z0K@X(MJ5uck{F{^6}}btLH2TkV}|#!z-uim<1|{q6j<8r)VYvgZ-|osvF7#zP<~vJ zB$piS?vzb(ru%QQNebPavKb%oi6p(`(i7dC;wRpeVEunr-+uZVdVl|iQ1Ivf1cm%~ ABLDyZ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/error_event.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/error_event.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2e96c85a24c754f7e461d971645be22516f7b572 GIT binary patch literal 1514 zcmbVM&5ImG6tC*9>6x9$*9P4{j7`KtLw3gV5+t&YYy236-Br>I6g^!vvz_fPtGYMY zu!j`_Mo`g%1X00*L?jna{t@C~1P?=>7ChxPvK}NSUsca!cOkj>rs~c6==bKm-+R+P zwOS1X^y|034}a4T`b#QvGAjWedLZ0K6j2f&<2Pm(nE^Ds?>tCg*d8}E0? z>YLrwx3BlsO8vED7alsb!6G)|e*E6xCJXXMxQewlGwSCos4`c4_CxsaEzm!K78vp{ zMV__^t#~@sm_hZc;Hx8QfNWMWGkJq9+(Sc58+V(Ybr0RfUTq!Czujip=yIO&?hZ@x zJKr}PpzBG_c;ZJ6lg2BK*h-6tIs@huf>9?=9nJz4?l6bRP~qI#3M1xZJPnu-VKQ>6 z281)@Y3$6KY^dbxX~6@w;%w!4CRRF~Amyx`&v0m`eAF4Fx#;*=_>#)Ltcp;f+=l*2 zt5E2a_3rI}WfI`B&Yp-D$x%CmWV_T)@-QIVw|qVlT&_WBah4Z6DUDv5us~ui2{r~< za2F85hu1*(8s7(FKKFy=0o;dhE4ul_L$y7;r&0W!wx|Dyzfd~`yP)@6jYB%bTflxs zum+|mGR8}rkT3~zLR_;vd#p;qq9GwiG5iz+mUTjc$QObTA?ueD+JF4+>nr^aQ@-6_ zO(`JW-!8bHr-w6kO5$0?;^Mh@F#6;f@Q@LuLd^cmFqp&3k+jh3g&qLxn zi$~D4=M`Q6hj<0pzx!xvq1FqZcRyYGZ0*nH#c^}6X(^on=GqdK#E%&vWrL77r9~v=CLtdcel+vc2%%{J=F@~6`-cH& zhRh_}C|fhU0v1I8G3L*KRmf>wwr4T;CFfSmo%V?05Z w$0yGLdU^b`bAXn|C(nU?W{NO=abjE=pFC6RES6|Joqu`hZ{_*t8Gcpzf3paUWdHyG literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/external_reply_info.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/external_reply_info.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cb155873a364250245fdfd839e33bb927e1b7a50 GIT binary patch literal 5836 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 b*2}eO;h(T9*hhPOn)rt1{PREL(}(ZhlU`48 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/file.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/file.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ef730d8f8b3d890337dd67f6e8783edf3d7a7894 GIT binary patch literal 1943 zcmbVN&2Jk;6rWwMKNCA&Ra1pRMg##CtqmNlC<4+X1cHl{pbFP88GFX|*6Uq&W}L(& zhagoVNWcyCK#!;h^$dRiXAY^v!P-+KPQ4k01ImdvyS9_4<-&OO?faN{^WN{hS^tzy zrx1)^fB3z&lR)TCEeuCAWQ>y{Fb@zz%y3Z4C>e(4O~-6SN|BaTvRctn6m$`0Ik8r} z6gQBG))0%{M=ZwUk0J;?h9?}Q1dDH?Y~raFvxYxLUDs1o*`6!25kI~4>BlQ%`TdpU z57&!pe&k)Z>nCouwV66kjc`w9i#xn7XzOO>4zH?e=sBcT_%coeFkeB~9F+`)O6DgJ zeksCCZn4NB*piR}@YaBb6d+iO#Yb|CB|uJwGLMT4i^4DU&}5T`sAjN<`k30~^$r!(Rh%>MOVye4UE6W=;XBl^8LoK(gB5a<3crOLUPt8ctp<0` zHt@Z+4GCU@>|DN!J(uG_{DR-@aH-&kN*8nv1Yd{X9V%sEo7$ePX0F9m!(%d6=Zfe! zb8B3!!h1WH3ZM*7Y0*8q)oF$3Nc$ew=nbLM>Ad|W{^-4M!zRR7LZX6I^wK>sv*@uBzKz58cynInfwG#>ov}zBeAg z6;neyXdc1y7@lz48CjUQZ|s}ViF##d z(A)`lL)q~#O8|d>RKNvrWwcILRZME4GY{%0W;AyRNH(Q0bZHAJ?xzT8d90(W?~fC5 zw?mzQB~A$Qs-T`A2G>Kbl1q= zfB-0GzrGoZCLm29lPEfMuyL^Q{+u%!F*!P_DvMMZT99D4%UyXg>XKx7PR_v z>lt;=636jNeKZ@*^rzA5*LttL(NE7L0n7hKlG;(=ZA8S?VN%6xQbSqmz*PY#h5m2x zW6&VbQ6WnDE{T{{TNNs~&@hCcT-IFRNdtA7SPToYBwhtkBPhQB(vKL1(L*mEU7W`# ffArt;7~!LfvmeVEkjAs*aOp3t{rfqlAh>@4yG;p} literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/force_reply.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/force_reply.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ccf8ed6be7bb00917cad94bcccef620a08fee373 GIT binary patch literal 2903 zcmbVOO>Y~=8QvwApEBh*j*%}1n8r>h3eplTP@olzw6?3Lfn&vpl@?`WtcSZpapUFA zW@c7010RecKvSU2Eyy7`1_^@Pd+JZ-2)$D{AtN- z(aJ20!OnpDf*FbVf~8t0w!(eGxMtztxNV5K235WhLEhSzrmYtS@EEN;NzmEOjc#{b zwnGN_JZ62t!~>(mNMKKFF-Rj?d@NITz+*$3`$}+A?7u!xFgd_bZA7x(AFtE**jB<~ zhB7s5$a5YrU2|WBgAhROB`VzK{+NwqAlTKRF^S&jc73UYYi7Q7rP}KPfbI^kYpR64 zG@G?fv);Jpxole+rqd*miV%k}^M{a|h%_Ut1F7cNi5FmiXZm8uqXClx@VnsudaA=1 zZerZ`Wf~i|nY)s$u5Lcyqa+d=tE=o9%$D#EY&tgCxFgZMjppmpz@&W7JtfmbGnK}0 zPs~nXU6C<3E94Y-ck z4NJGu5RzEfX@($kZwMPt=`2ywhre9bz8wj!MFC_aNUn;_?QE~H_6;ecH5LPIBq$ho zP=v-HR2l)417R{hcWC$)N!(>O1;mV@c?6#v15d%WxY(~7$QW@=b?n;)P|Oa-?YVs5 zEC9wf#rh197KlL@;nOI#?aI9q-`L|wYfk}%Msq1 z2RV<&`RT#gfmHW%=g(a@BjXMnc8UX1HQ5_hvkaZ-Z$Z_BEM%R!x`>>RS} zqIXQK=OyC+2Vm%X_Yb(*(~9oStf~YKr8sl8p#h)nD@tX&HN3cP?WfmK_{{zsm!+Ba zqvdP7-{CFN2aBGd^w54-dRPwZFUt>|uk26rs~A^ld0Rb;!QWb)QdYrfCsbDVJW`S8 zb*kC3Ck*s}Y2bPP0Y{z3^sM1|xu85xS5c>{iak2I^~;Uj-@s+NHzbLD_kOClk;;RN zc166u`*zsh)zIsDg22Tsrgvv@?B;Upo^XYmjMa-+`J?m4yCdRl z&U)U7zcFZCNJY{Aj~sT^ni1@aD1v8f^)k9N`S%yX%drzlx}H|LqU*Lp$`bE z;D;hck?Ir$N9Oc#WUB_%b55S8QobDVbX31uIOPr1MwJNEze6@H+qQjZy*fGlJh6T{ g`Jv~D)t;Pwrqxv&i2gg9oO}Hr)cnu?(U;r!Z_rL_!vFvP literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/forum_topic.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/forum_topic.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9015b624fdf343429775ec756403361183c5abe1 GIT binary patch literal 1604 zcmbVM&2QX96rWj-_bYMIGyzHy(5g_-BC&hu0TERQl!g#Kc99Zvu zQgYZzl_(NaTu=}6h>B2e9QZ3ZY$XnsPmwtFW)u!6C*HF+Nh`{Q@yyTfYo2C)@7X_D zR-M53^@rcKZkdGqfy&7M9S1$?0Ny5o2|w48iUi`0`sT%kQjp zR#W4Ra6hef`{;K32ejBTwIO}Et(>5{xhvh+EixC#iWfcdLHG)eEs0G9u}dGo@ohtt zBooFJ@YRT5Ae&OFW8H8XTNv4hF|<|BL)W8$a^+HECyx7i zsoi!XC0p_MqOC}6w>P6$x1GNCT)sKqo9|2wFO1WfKx*x5OCIki=?LzL)X=d?S?B~Z zt$S`1ayRlL)j76K2>loWK1t^a-$2Jvz-18ada$`k)eNwdF7mTWao*n-P8fSG-}~HA z+gf3Zq-7=JfeKUBi9+dOjc{Ngs<0-ogRX+`J-rQm5ufOAB~Yn;2jqc!Kc0y-A3(HI`TcXg@vVWjqY%aQQH?cUx%IdP;o)T1ZE&wB5A zn?3Et^5wqc?m-1~&+#H`&vv}um%5#oix;)-@2d-t`r7OntF4pcE`me94e15$ja_QBq28P_4)yeGh*~F=ek%a@LBgjUYlf{*x z5@XsdlydHJ8xp9_As`KTQPnI;a{$d65{ga4d0OW@h{V80d6M%_2aZ4XR5%xr3+8Fg zANr($?mRnoLw@tr8k6iw--i-WH4iS0wSQeLU=;q4a=`Ac1g5QuTqnT|wS}MGD zLBf+L<(ZI}$d!2kdN literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/forum_topic_closed.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/forum_topic_closed.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cb759b3c6aea672201bb390ceb904c2af894e9c9 GIT binary patch literal 771 zcmZuvJ&)5s5S_L2rEoa`KLD+uNVr#P*uq^+};X6#M|X zE9gOpo`%0baV1KHM0H(IsIFpmeTNjmc>Of9>v?ZxydMXHKA?Sh|80Jc0Q_{pm9-m( z?8fMvf&f8sC`e2Qh(LsSP=s+vAb`gpT5mzLW%wZk_>6C3aZ7ZLVc0!);gD>u@v>Bw z+f0?_9M#<3;Z){wp?UFi_ClsMZ895lpP-T5O~g}>5EB7$AV?gF0ExrR^+!tA#Z*;U zI?0uh;?>taMVl@&LzQQwT2@*bSz1FmHBz5ssicK8hA$-LGgVvMpF19E9T81E6U|C$ zmy)JSZbx)dYmF57nl4o?3@sI&V^ZO}8TGyDv8r_{$8>3JWyVpIDlJF$vcHkii)f~- ziFlRW@p@jaQS&hvVd# z(yL^mL{=`6Rjs*InxR@E%ai0uHcL!q<=u*>E9}}NJX3DwkzH5PM7|j2t6@z!qiU_Y zNbRA6j=6>K=I^r&TJ7Ez_COD=5{`y#SN*)UwZ`hTyAYe!jN|a#oobj5oaa*x(Yxr~ vZ<>9eZ(!*Dym^kW4GAIN;r7}7`T_K8e{DN$f))J>?_U3MyTAW)V5j2SijMAcPQsHb_ZTVHORJXOcLvJXnC6j22XqirPsq`$}*nIEZ6|(%+%JSQ5 zomFkUmLBNpde4}H_z^DNX>PKZ?T8>*-`ZoL3JcE#+QkE(d?TrpPZ{gYbQe zmY7Ygt6-}kYJ=>IzB>C|1cjcM~v)34k`A7j6|fyPhof}Vbp zi+-}ndr`P7SfCia^=;jSvAG*bm*)Yxg7pNGELGACT*<_ZC}eKJqzrbL8*K5ug8h`; zbhnK&R~c_^Sh#be)K$C84R-_8s^_jZcwdBU$=y||CzsmokPFsQBTiae?6kMIlI@@u zE#wY!eg!B$*kg6yo`!@rzBZX-sT^3CBMXK!%Pg!UxX@=>G3akm!XRm|s6}|`E zqsDgFc>wDntYYk)S!n4HAC?X+itk&8_V@V9yf2}*td3`iNjNT=227kkBCn(!+3zu- ztAs>pqzLiKdgifUiDdCMA^&(&OvCHCMo1V3QW7G|pqu)-gVSqoEOoDQvEN{8m9H8tHYCQAB%4e&eul_pubcUQpb2xW-IKMbtd^xLtmTzTMH2Yju zJ5$ZE!eFEmaD}{jkvJ4$#9PBihCDH4!0?b)Qp^}>7Qm|+GEEl|qU(etoc3cQPZIJ` zKZr+`3L%t-usub{W49fs&b^x(o9C<>BbGxJ$50+DE`v#$g1;(E(!zYJa;O@^cK|@a z-@mM6JJk#sm_$x-D@0G6u);q_A5JE+or`(+YSk0R>`gy@F7&GCNULDDr7}EEL zYjfMbw7$Wd*cpV$9>sxh@DniKKw1o0m?BI04AQeys#x%OmYW*+usl`IfmDQ4t-^CQ zt#4yRK1~(4^nHb@ProG#IvkPaSc>(kkqt7N&*k6>DM_eTA*^8X7*U#pIQbLf-Kk zVdOf?)QuUvwpTJ?HLkeA4718i&LYkP3u0l~reOT4>oC)2LfCC)+UsE_HtoPs|J&Z-&j@+5dIrHsD%luapEwFu- zOu9}O5T_&J&?n3fH(cVEEysc2YuWYNg@%LCx8cdM7%4M*-sH!Bo z=tPVs1w!1wjR~ph$+1H@5y89`A>$Hw89b9BA&zGYL5Ps!E&H+aq_MQn{5<5F&Bc(q zLA$xx;dUHy0^l`SaJ6~SU2h8L;9O)oo6s52wB1n7XFcAEn5bvik_=qZN4FMj@uLv` z+SIeK)rR?=1hbGQ>)#!eoqtZJu)qQ&@Re|lx7cP&5Ofx12 z5Cv5YiG^$@AxVi4KcpQ`@?}E4=-A%Ck|%_Q&JY-hL86M7Cr1degCLA;c?toZtnFML zVGjQVlvR@$1N0o`d4M?P$H63I*Us}v`Bq^_WZ%VKK%lzul`5KENRcFEbn5KR((dfu z{EfM;b_VYI+L@mAUhmCXS9|r=>@V~Cpa;HoU#q1G(l06x^OGq$s#nqqnt7x5&bw*R zC;~Vml0(N&-J1VlF3n3-0nNPi+x+dh{#zw9{dzhf^<`8!mKr0cvHSmXMfu_E>m$NX z469wO=93)E0u0X~$TDz^!Kl=-QQ;DoK1xR^)H|%|W7DNfDaDk*M#<+*- f-Iw1F(QNnWJI$TOknHnh@9V#%_MaD+vQ+*9RFjTD literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/forum_topic_reopened.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/forum_topic_reopened.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d84d429a6e29dd2757eaf6196c09286ccf7ccebd GIT binary patch literal 779 zcmZuvF^|(Q6t(2zWYD>E;ef7gh_X~x z*i4n?64l(^!5DIwX;D0xyoA)IO=g4c6EwOxL_8-zVk$`-NE(MSK;m$9_)zJ(7^^Bv zpMt8O1o`@FkD-m{nPJLvG7Xgm1En=gFa!E5OMw+&jFpE@RH9Tg@tTr4Y@ zodZkf!VcMStu>P5OEy=zG^|v3j%kJOXxQ_*r>fQ|jM&`T%8a5YRT_r&y2qi?vuL8M ziA0s%_KIF`tLGU`2CY?>^HLPR`Krfxp=6yqf1mSLwaBkeI-EniZuj?pj=cOI$sX4f literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/game.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/game.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3a2f37e63f4490200a5c0cc2e268b75e36662d3a GIT binary patch literal 2096 zcmbVN&2Jk;6rc5uzrA+aq%BR_XlYt13mStEs#Hp$v}xMXrj^s@zd zOq<9DBUPeEfViL@=n)lFy~B}zfP*7(SnVki7kV=a2b2@<e_J2}wvLp|dZKrasU ztWyHrNOYbP6(<`%<;S`+@sKQQ&iI3}m48U?YZl-$_^s}X=)B$J8$T3G7&lj4X$J9e zO~G4&OYSRa+U5%Q%$m0(H{TD`1zW9hVXDAv2yQEG+P-6Q$5pYLe9Z*2D@?f>2xa=P zQkwT%&ok|YGHq$LefMsgo2~<~-DQ^xIa`ST{YKCh4Svd8RjMUV)oP7E@L9E+gxNr> z)RqDzYj(?>!TrQ*B3&vGr6C0#kBSbL4dKRl+^JwzZx3^_7^Pd7pM@P`km%d6bTOie z-&Z?_hm-NLk=!mWMg}@D+^}-F+!-Hw4=Z9Z%G<;0(8WGTs5pS^Ah2jZLzEe7tvfaZ zX|T0>wpft@+a<~fuG+$n=tAK0238-A47}K9MMAXgiy(ZhJ%YMd13Sz-f%h4_$+$DL zIH``-Np!XxGxA+8jkMHh4ZKC9|mHrelBoaf2F?G z7PblmgFM%{|8f0_yHuC1;wM^mV-0#u)@?VymaM7u7MHcSEL-csgs2+^LOeUz?J<~= z*Ma@fCH-k)9R6bNv-!{Ge=Z&Blblfw_fLg~jw9c9Fr0ohoSf+!Fdf_aWio!WUm2?C zpBPZuhM1%}mYll+a)M$k#Zd0Wxfst0l;R@Tj}lgbcnKMz66an_p>zmXwTMV#w=fnJ z7;6Sj+e5j;*xk16?OL*oIY9%aD~!Exvq2t4Gbr%diE)XHUGy8=^B{|wI07b##qyq* zL9g2yCu;K~o*JlVb4qbC#Eq$fk_hR3SiOFddmXp>ga^+IYZJJBao>2iO9 z%p4Ejem6YvMt{$NJf!0Pu{_3#0}h!uIym}5bqrBoZbK&m>H@zfQ3k3E$}+(cTUB6F ziY(gbk}bKwa!&G!ts0f#uETFaa#O4e=v@*O;(Lcl_%MhP`p0-rqZI!==3pmxI!X8$ z@j9rO9Qh-#zOHFnNRISIX^Xto`!CueW^a_X^szqCwO2xVv^Pp2J<%JbkRI!eQa@AE T0KdPphi87n+28-c6d&+UGc72= literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/game_high_score.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/game_high_score.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..34a6bf5b88a5bc2d60ab6caff6855572df6d8509 GIT binary patch literal 1730 zcmbVMO>7%Q6rS;}*FUk75-7h#jHpoM2y6*%QB;wJkTlRhl@!EcG#&4b?QPaO&dhFu zQ4X$Di6Q~wf+~Iv98eMJ1qq1@7sQ!E4jiIAMdH+(Q8=KUcr$B5f{H3Jo_T(6-kZ1Y zeecbDQ>~T}j32)ErTx8)&~I9pjC{u6Ll>Bv$VWa7Q4hNqYd#m|dX{VTY}W?a^6fC+ zb6f`_Zb=8^d|2oe-6BRgw1Rx+I`RwLxn&`A8&)>ll3(0FwbC6e)^Iw-qDaIn4n(AC zxwN|Z*6Yi3X?1z&mGkQ>skIml?%>RFdXtB|BU$gY))nr>aMr%0xb!l=86AHHAHD(d z`;Y)fF7}a|y99~2mY?IcZ!LhXgnS$L{FvAKPR8@REc=xksEz%p>lN3zf!@V#VFOM6 zYt^*6!g_o)=yW$cA$hV20hS4j&2FHGFwqgo`;sdj#jq1`BE=37Z4!4m>B2#x^hrfx z)(Sak3rQI1fYZA1vl#hc$>KALu$D+-!ora3@H1CA>4?~vM`EX5Hpb`MWFV4>jzt5q zop5FFe3tY>&J-tJmwQ`8dlHExm%DM?SM!aAj-eipQLPKvX|zPF8f~^s7Vd9z_A(`N zbLSwSmlrRRpMRX2%L3YfZ+Lv3+{Xj!2d8z)8V-Yo$tJaeC{Bxgp#q(PEJCePJApc< zd1IA6MUSCRX@B6eC=NWjwZmjbN!`M!BYB+2D7DuCeNT6g9=bgWu%-~ghv$I#6yJni zjVF58xdrPstZZEQTjS?;@osL{^6{6}uKhLs*xU%{WNW=<$qJauswUGwzD3ZLR5<6vUL)oOJd`uvGD|P3gZ*${9GGmMHZ?rWB>h0a>>e8Q#74(tPtxA-9@K!VjWO zb1RW77Lr2EnmoGNd^Kn_0X6`#7grJPN7;k z%MGv|L!)bH@R4Rur)r8NPiXD|Ahn{#E7F0|v`lGF_(`bw3Z>f#3&)xQrM~cBdxp{@ z&j+9h&lxgVrPVQp9uGqRAInETrF1!8l#gmF{RSGMgHfLYfkglLjdF#2afCFPMfus` zh2e#37xwKJ_U-B6+HmdK8ZbxrnS;VZBQ%wN2ak${5>WKNXvuiU{2Zb3u}QG&wXz1L zoj`X3Fj9AP>Og^^BeLvG``azJ_ENWc)|Cc&lktOk&$!bl+$}C-7@w7=LDcZ5&wz|9 zjPX8tdhhr=K+o*mYaSr7cYGdLCq@Y4C-&{f_m0nza|&yG?oB^g|J`W*_z%4a{V(ZJ B&LaQ- literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/general_forum_topic_hidden.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/general_forum_topic_hidden.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f40accd75b7d640e2152431850e0effcb86092d6 GIT binary patch literal 741 zcmZuvF^|(Q6t;NP5!#h_p?2TRG zj0?mO#}%sa0%H`RBgCUOh{u56#|V9LUnh%*4^Gi^_|v;nyxE^a1%+nyv*ioOZQgGS ziz5uOyX}?>1ZaUdasYS{^T>h3n>$A!L9^ma4U+2P0=5jaUyy%790NB(?;Sm&_*Qu+`cDRclhJiW?%8 zi@QTLvqH&a9Jo(at8C|#sWWlhQ&aj)o#2(*E{E8bGQCB9mqB7lt?W9O2cy^xO%d@}lJ^Otck4MPK*Y_8v_c200yt9`VRS7^5CKLcI45@d)t82%#_TYh}^n{S!1D{PgY=ZzgjnA=j*WwtNMd&AM%2 zafCs3H{EiM04*>_4gfDA-g6+)=GGBN(5!r{bW_b$Ewbmb5S)X2b1@=L=7lgs1!$t7 z)?h$dLl`lj&qM~K0%KSXge_HLNe4$xJszJ-aTyqI-d47 zLrNv9fYQx~(n|5B^!5RzuNzi&k?WLll~MW`?flJMzI-%GUnspw4;2?OPgjj*R%z;J zQ;=urQ?X2quyC(t*~(pmNtsaoH4?k7!6aQ)G^9mCUUZ*WT(7lnfuQ=%Ft?q0`*&=6 z{lRdHt|)zDf8f}?-nb)+1DWvH&@E%%|GIM;WDdE(SI!We%?cfVbo V+iL^tc>h%&CcpgO-~R~(vOiNI(g*+m literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/giveaway.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/giveaway.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..aa83d411ea1d5fbc55c1839deb8bdaaf233ee2eb GIT binary patch literal 2229 zcmbVN&2Jk;6rZ(c?X_dO`EHwj;HH6MRgEd7AVsAD(kgs}6qHcJ*3oFaJ4v?L4>PlF zaAiRcl_(N$Lp{(VDnb=E#9zU|kvOdO6v3%Cqi{eu@!qa&56;&Ug3$Ko{x1IXUHw+1%;%@05aMCn((Rzw$V8ARH(1{xX8Vpc&%`Pjp<-xMaFD{llrL(WyJrZ4zx(2MM>FV?Gd zKaf?UVV~~LjOXp;F)KGP;;WHr!b=J$FcM8}*`CLRWD=a1m@;NTI-<1g1yLbUGShE* z!O~u-pVJ$4-*;A{Vc&CF%;Q_kyZ}CTbITCxQs60zGJ*$9;YD=G_qd4#j7@`HfDUm}b{B#9 zO1Te5C+O>8gnZX9tW`hN97Z`@w{+G4@|wisP_glw-_v3@I6tSRGii zNxQT6=9RhH`@Yz$&HI+^t=Bf2!U%l9px$cSyH#7X>osWy{9MB@H=&kg&9Hqu@718y z;Ii5;$Js_pOoQ*+BmE@I_IL0s49n{Pf7~J6X;M7##nsOiK418`aJ)Ps+TYxCF*8D)w?^a>s$}D`EylC6?SP;%T%h_5q7lPJssE z`q$GFqGh`OeRFV4kl0wQhGxsWz@vg2Lylv?VJljmLt z&tD9y7Z5MM)}1((gVg>%$f3vB?Eu6x{a`IsN|>>=Cfop!F@e9rC<8SNMV~|;uLyy^ zCy_-Rts9byT+HIdD)1K`Wz41wd^f&ilT4IhI9Ud>v!`83isG_(9z;x={2rj2Rum;9 z)18B~LoRmyjdn=6bC7n@!(Eb6PK9);bC5z>?i{3U<|PH9@^`rR@ozZ#`#-4S?feOv CcTKkd literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/giveaway_completed.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/giveaway_completed.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1a6e5d6104170d2a4e67a36b6a43db753b96d5af GIT binary patch literal 1756 zcmbVM&u<$=6rS%~TU8`_L`A3vBo6!)92}_!Yfq6lRa_Q@1ImdvUfXRbT$r7C``*0SH}k&t z&HhlWRuHsbzWcTFyN=Lr${07WRl`T0g1n6wV%SFkwlP+E!7l`wtp&s;fo|(Cr!nFe z1H(2j;+iOet^1{*Y?m=ApeAC)8;BX)xT_&_4@TbX3M;K6tNcKj7EY&}FpLr>@uE;# zT3X%s`2AJ7^499gJ8!QwQ|mD}+j;QX7~2KRYaIKh?nHSQ)5#dwcP>2$f9 zZ<0%rzwl89lrJD7j%>`3UHAYpvo%)WglU(-S4NE3I@7@}PV6F_ov>1Fb3@b^fv0?@ zz-Dfu4ra9*HM?{ZeU9z&IvT&N*>tYyZF6VG*`i>WHMq}aa@qF3w++@|LB3IMd@g{VXpj8kvfV!9ikuK54@S-%{ zWlorQF5TL3L{|#M%(N(Y(i34y)}oNRiVCVJVi_=|6mj1G-Jlt-* z>$O|bOZfA#<8A@HWy|p*Mf^sx8*|y1AUmmFJ>C^(VS~MMkHK0WAA1q}vI*j^>nJ;m zs*7K*e%bu0d4KwRhV*J}uxJgQd1Y|nh0FkJIF*&q>8G>u#8k_2htiH96tXIL-qWDx zu+@~NYAj}zP%sP&DNZYG9)wjQCbrk?u7g5F!3SJ- z1w9DSQ}P8Alqf9~T~Mg5V%D*dPB6BgXT3A;?acVY;o*p&eSY_KahDSE!!3Fnbj~hB z=aNVwX+cUlqm+2$m`Lv}kv`D(J|Um*+1t#M!5JA3ej*zg)6LO26p(6Bp3YxDVv|13 zy|ASrH3T`=Js*E0`W?$ry7I>`TEOjFz8P^| zDt8R@4>*6>h@#uM$+=Vs=O4+=HR$Tu<4OEn>18}sGOyBj*=S*v<|r0JwThqS^VsAT z9@HXPV&NthxpG~P?79XM^=IMTVZwT?-FRCF&@uNA-u%6`UN9JL$u-co`h*jlOfVPN zY&Z5jk^7DI5eMj94Il0+d!&zW=>~0{AZ&d~>371uUB9h~Bl-nY60H3JpSub`7K}v7UH&tEL)!kLq zJ^Ov3kR{N5{O0GSzw(6qhQeM;M2xbt0n7uU6J0ThrBoFK`Is5A;?=lCtJF$V6IQaC zg#Nfr&6Jg{rWL~Dq6g%JnX$6ftkfmVoRzQUC7&`2RO=C*(0a zQLA?8*?CgVJwdUoggMo=9Z&TP$9Bs!EG&HZ{uMU;&Xwu+-kqBX1#a?Xp<35!cev((FFL)V;yZm=_4tBeaqPR{a-l_YN0^FU%FeIAdy_(4fcmRaz@HM9XYG_g1#@3c@Dy#+xP2#nAAt^lO;tTzE`Z~?~{*}YGI!2z00Fv z*NkzOt841|O~baia5uiqmY^-H7;edtfh!4K7u@Bx=a$rx#a&lj<|Vb}_+H6d;U&$n z>L$n7mz*WASZ+Hktr^}*sqWWILjzuVpUg_{^NuexK2=)ryt+G8sc4SilU_Srla5%f z)Ev*PsCDD`p0~CGIb2})Ge6fcG$1#x)GHa!>OaOVF`j`8NS6_zvgPfkX6Vm z$M#m*7X7}hnJSc<&g#P0;O$9^9rrcIF>i<6j%}_po3FtptQw>O7OA>S@Fm~YxxQ~X zt_SNp6#3G5XVP*~48WenAi@yB2*N1BO90^*dn(zC)z@{^_6&`!uBl?#6?p!`q~M+} z?2yhmHrMbtVZ(TKMQ>&2Ixt@=58xnsdwS@31kYo5qIRdF(PIsz5o^R7w2^2e8>vRR zk!fTbIbC^}YvjLEzLeJs9Q*iOIVW%uaR{LYp%6 z0$P^={JBY5CrRPR7gs);`F!S={Ai053dNv*C>TEiNKv$$8EM&jo#qCsIi=0Rlp-|4g9$b7oICDOz;F17aBV!q;mKTEzI+dO~Aj*5e zohx@^nwNaIlOW9k|0;w@I4*F$qHN)%C6WmE?G9;8g_}Hsvb;*<*CMI;uIE_MSAqIq zAmG1GJBP=SlM`ZIcheW5nz|^?frtrre*$R56-5civF1VACg+;}N86;-JV@K|?iPtF kBLN+59;ASlng{9MHm&5eqCm)=jbGWnOU)nup_g0z8!9`fNB{r; literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inaccessible_message.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inaccessible_message.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1d4661bb40683fd5435d368841863497a410ba55 GIT binary patch literal 1711 zcmbtU&2Jk;6rb5$uRmfZApzB-Em}T`v7Yu-o7_)=FPm{ z`;8w~DkTK%=kI>qDdZ6PLmA@+wrcoj8{}O?5yb%tv4gSFwLlAXM-L6h2y;#j=5%TV zW|(*K7%`ojVCRBDSagaQX=oKu^ERS+mVcll^aw`QoDwZuLw518GHskpxlt5LSNd@z zY(1%5|LDCHvh>c%(z{nSRulcLsGH>1eaW~RJjU6U>Q%SfWLF~B^Oz8RGhkQY>$Vt# zGnRH;>19V{(#Sse=o3)BfV>!TFh!2`KIG@+W;2sl zs7Z_WFrB%Bb}*g3J?-T0pwF=b`Ha8zY%+h!#cn<lT>;L3Nk*-hTWW{gWqjWk%51QciaBUlYvI3ry+O|fJh7vE|TbeB$Lv}OMJ>T@Ew;%#rXL3 zt;C?N1km}c+H`@Ok~kslE_Ea6dt`6l<6jTe4)B3?pi_KLKQO+>-=v%cp6MI5&daczPb;Br`UA4H zBqus;#*+dee&kC+Y%`ggxGWJY*dgRUJNYxPJt-361+EZ;2or2oSgUvZ!SZ6`!&L1vb=hq*QJ<^`8G&AFcljAO z;^w(ipskIsejZkciy;2)p8T^ zUC1tFX{yp^C{>iEpyD%1sI1ev@j0c19Gb?YP0nlP846 z9!$>=GV#s<*fhF&nrVVbWrV56f&hwv`Saiss=Sx^f?5Tf$b?eFPaq)MC%>U)c8~dTYJ4TWbU3)qyeJ+w5)L+8h{f49--0%YCDo_1}!@z}Py>KRZOTIf93C$a--& zRW5>x{V)T)%;Y4uW+o>Oz_Nea2+!lkS@Z}JOZDoDkB5JMefJU}n?PxeDp>p#68qRai0 k{ZOABB8<-tjD`NmJ~Usz3e3}Gf8pYvsq3$&EJ!o>2OAH^(*OVf literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inline_keyboard_button.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inline_keyboard_button.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..376d8c608242114da4f561bc3fd70478663e9dff GIT binary patch literal 2765 zcmbVO&2JM&6rc5uKVv%q5|RK(wn>`cQj#E*wu%rfq){3Hfd~-AO*C42$BD^$*PUGh zMn0q!QmNGTR&i)Al`5)=d;ba!wp3NCJw<9S++5K^l~doFwHH#-N_71E^1kNn?3>?v z&X1W)iop8$+b5;(4-)blD%}+g1m)RhAUq@nF%*+jl)R##95EvmHLq4^o>rpyDA-hk znz2eeA6E!h#SrLGGf_$AlhPM6QLLy{|7|Hv@Nb&e1 zm5|5q4OYI-=($RA>8GgX6u(EeEZf!HvTZpz)z4hJd1a9;e7Lx9VR>cASI=2>KXJK= zZryyU1bYT9)m*(`@@w4W8$z#KF5Kcp7m}qHbki*8#jPd1!a+}5v^UDubzy>h^y;0m zTijf>%(BH-Yh2V9Hf@Jn3!6G_P2J#ybJgmyRkDl0NdqoRN{I68chEnF(s7bk43dvr zhZ5#hBf_bno&jHy7&IR>qM*k@Jtp;dsK<>2_>-ZYfC5pYC)ATNJ{{^Qsb@mH$H+o_ zZ>Xn@KF|+@dd4^i`k_GQSutSHmp=X9C5k;-y0&%i*OUh9+Gg3&Y*}zk@T%ZYLKiF+*9tODvrC$8X=PbwZL5=GMq9kA z7hSV1BO%1yY7`xLU6Drc*smj9_FfD z6Gc9+ZMtsNnV+34+Jeux9aPNNVq>;oyUwg$El&jJ=^iJ@B6Ikv;|ia;{I0vQo9ROB zV=%7!YE77arq}@$Gjvzq?GHnqBWB%?-{A$OSF5`RLw6T@>weNi7&1(D$dM>y!Ex9p zh(ll7$H9H6Ju+_Dv*V9^^S3=6SJG)?awX4d|TRY#3IsZ4>HH z)$6&WfT2RfA!Gx{29XUR8%A~%*$A>RVEz=_4@Hbs>xOQ*QpGyMC}dg70Ja2J2SnF(M765oxFm+K4t{jd&x` zNH$W2@?EOY^MmrW9D6W^)RkOH^ugv=dbgiQF5*X>T9pew!Qd{-E@QcjfAEF3V-7b< zjJZ>je~L)JIR^tfUnyOtkYA~x|o7z-5c5O;%2(U9= zCWj{5gQ1Fh0|!daAV0|s1=Z^XIk=w#C`kZHNusbHZ4!!yQIdF+UI|JmNn{>DuY~6@ zln|q06q$w$Q7B$RHV!Oz0Pod;R$$CeF;=mSnu&6nLCfl9#}jAFu!~^sW$cBYF}U?t z=@dcnu~>OO)4BB`H%&m4B94RAK~TRhau|i(AQ=iy89ZP<{UFL$y@2b&Z)Qj4C%@as|U?fE91Y*OGzEjo|(o2qwdwMi$M6gX0guA-e&@69

    Fgu` literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inline_keyboard_markup.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inline_keyboard_markup.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c9505f901802cdfa5a4c8e176872dd979c92ad8d GIT binary patch literal 1651 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_article.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_article.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6bc4c671e939e0fae73d6ae6ead4061a5b1d63a2 GIT binary patch literal 3306 zcmbVO&2Jn<7O$SE`Tp>C9NTd+#<9H}6AuAa5y4`KjMq4EoREb5=(Sa9Pgm^5{V`kJ zlVElv1_^0dY2k)Az;OjaNO0S~Vh?R8hf<#+amsB_IIMhF?W^jZi6>*06*aHl{9e7+ zRbBmlue!b}mGTJMKR^H1z3<8heJ_koOGQ9=@-2YRkbw-vLbjqQiogjgVJEeujWuki zw3MCJ(soA6fG=raD{JSp9N?6Zw(@pCD=3I2*?F)tR?#kLCF#prWqUvykT_=z+C$oq z#CdDj9??c5E?A@Xm^LPH(K=<1YvT$^pfzNaK14>D7QRd(^bK55(@q-$caS>xSeU93 z7IepPecd-*$5T^b>FytIt&){DS68mDZ?1*OtIk1~*)V;|bSuo>tcy56ska>fj}y@t zW9yD(I`pjuWe2yZ*RcG%2X*>biM&I7UYK??>by=5c3hnqH*~h&s6+qcx>IlXE3V_~ zHU9?nJbjl6i#mSSyYAd~%^L0VPRV;W+?rfXpL<-o@6vbs$2~1wzoSm$nNe%vEp=Kh z0?L#B0Qf6poFYvzkd}BGGOr~mekW!GLR#8L(2S8>hR7T;FyPcNoQ`n@`m-_4X;~u= zcA;zMj3U^juAPT$W{iQZU6B64u3eP&P}eRQ!w^5xwad~Tjchu=CXPR`k?Z-5eUUY$ zK0@~tWAekYHuw>GSJ8&g~mz4!AKXt!ydQ4jLwRrCr(?pJ)b zqB|8mimJG*@__DC>X6{2yu9O%+h8?%rLyPyb?-{GT5}m)@~K64nQkw+Y`41O`d(G9 zo3o~z`_F=KFbNPY9#xKWG#?Z8PkoOlc)4`-_TBZBjn(ZC`(TDi&u3x6G{Tf``W8L< zSaKWg1tRvd<@w70U|H-ufk?6EL}JIj6KTC2j+x>?h#l1esYS)Gd33f@jPWXaOKCeS zGFrC|h%GDYsML*y)ozE$2D6UJ-M$^ywYJ0To@r15p0Hq0uf|MS?P1B^YuG!EZd$^3 zY$Vh1x5I&_-Up`P?}dX;JNBr#yXUJ}b_&XXO$&8Ss2QQ26KYndIico3g%?O)#$r+t zQa>pBf%unD22 zg!=hqevQ;bnDQER%EBxmrepeqsO50@*dmEXt$T$0!Wq~CJV}@%q-N=!M~DZXE+mSw z+geB4Z(P~>z03BuR$Rk$cDME$O!r+zpvJbSbAM~Y+}ZMA9M=_hx=7olBi%zXD+%0rl?|YQKz1(;u(?ZSC)C4~u8o zs8lNRu?aph#!pT0`B(Y0%16if#0)>Pz|Su7N|n!CYL7#d3~irABj?)_T~pj1IRttF zQy_IRdY@x}nM~WbKr(j{$plV{KAFWc0!hZ66-d&yB9P>+?2`nRNV536@Cqt3i9{MC zQQ5BqQbDQ1BIk~7Q$oT#A+~EYEP;yz-lcBEo(v&|TLS`!<42f@w=DVi;Q%4WKH3oT z^OR#)%r9~hmSR@asAU1|6jp^^PZYrG>;(}u+EGKou?HT=&C_2yfm7Kw5~_$^URNHz zbgT77fNw=|h;MOR<+#vVYps2-#_?s2%dKmzYad+Wc)FcPr_ycIQ9npjMycodOP5<4 z0lpl`p}6ZWd}6w_65#1b4)HX{3;f({>&*bqMskQ}Io{$kbFJ$Eo{QuV&vE=~KD*Gm z5#WVL4&g@p3ZGM3Hv_Cja)?z9q4O64JQ`roLJsi-j^`g`M%!pHRc@Ej@>|NoSO3r+ zMa!=%Fb`i?71Uc?CV0Qy@up~Ib zG!!0GYLrW{{js!A8KJTwAO!~)+lweOazcHwqKG;bd-mhASNw@!CE=WozBb}30|&5Y zzdB6pBb^vCI)?Sdh@Ce)8;xVdhq1n(K@l_=1^I9!>kAO%3#X!h`{H2M7cmSG5m^@n zlJ8Cs_$a#^71e8O1x&$gZvu2XsVE9Z&jr2m2>mAb|Kt%;gI?k2#h_OnB?p1u%5N2p wmxEs6cs=NqlX`&3J;E{6K#y>|8uUs#eN$0@OegE$+zUTQ*N;CDAYa{o0a%Z(jsO4v literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_audio.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_audio.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..299a86d1058d25bb7211edbe6197689645a473ff GIT binary patch literal 3735 zcmbVPOKcm-5$z$H|BocO9&0{K z&(OO}c%YF5vH_CZ0w1!+z(L?kPQe~?4sxIX9U5~okdtp*IEO%|RQHfvG2~*A9oCep zx@xL_uc}*r&Sa7Zp1=L^p9cd&2>pvI?I#il(%XN4@B-;bmrP_yiX?G4WQMG;61K2{ zt%wq_qDs_?DKRUq#K9icv6--vN>a!XGi9ZfG{{jsW@fCcl9dn%(?!tZ=72S*3<_Jq z9I|psPRL1f*cwqrgq$)*tubXx$Z7MOHLi>cIb)u;CX@*wXU$1#N|};S2o;e&@F~&< zN%mzJp;zz*k20+fJwW-~8?NRhKc(5W<7uAZ*ls@RXCD6SqYZWaM;q&RH+PDDc+IZ* zc*}4-KelCfgleWAzgOnoAVnV8AiN0$kz%*WfmSg+2s*lHn}$t(Tp_f2pSaNYuv#W> zq`+~g#|oc}1dVq|b>GpbzOB)tN*UTGHtll7TX$?vD|y?*b+tpnHDdFQ0_&#z%rQ!& z$2uv#-EvA|dOhZI!u*hY(i?YNn0`X+N^jImE6|4R8D6!-*RlO10zrCv5vKZUzzac& zq$4Ht2yml>34Yqb6GBQ<50RK2z6qZskd8r)oROnvG8& zdc5-+`#i2seTEJsee%<+GV~exL{f4OQ2TFw+8^t|!dgW)9Bm$^l$7DQPs)_Iu-mSz z$pES&*>hygmbX8;CTrYPJ}^vDkZ)CGJ;2|R>^(8SyJM6;HcV6ACo&Hs?^nT2B2488NF%a@DEGB?t~idC}m&Q>_4UYAL|nBJUpJ=rEd=3Br3%L`=6#O2&af zbh+g%8@B5aO_!Ym;ULCTNQ#L)a4NJ!R^=z2S9VudR!R;f1&^5IkZM-Jp@%E`j_0mu zWn<0|+4OUsO|TY_O(Kqnays8i%f~$n$y2Vd_UQKJy*(d$p!i|eqkhQH{e%dhRw(2! zfY>BErj!sUeJ3b=ux#yDH%KE*%GiF{e9(Se5-kv|$ z3aP>_7@k2~KT#(1z@ZkQXSz3RZ_m#L1Jo;2r0(g3PS5?y#Gap~q-<7IOH_^17ai|l zoL`gYOR_NZuMaI_pAyir^ess(Ti=2NOEB6OQ~5YO57|p+IFmV><7}R@OPnomwg}8$ zPECVq zruf_9NqVY@GMOwJJE!BG{dNOy1$2zJ7+z*LRWH_y&x;ISXE;~isqZ}BVR(VzZ2eCC z&htAA53uRkda;3L13JdD3>Vpz>wk@Xkv_h%adKs&ey4#q0y@SU%@B$_4YBX7HtOJY?`wyFObZL>@`0$I^-_yr8woh(svkz{u zcQ3Q0EA0IbA>`0#^Kw1`2>f;|!8;Q@b{PF`dslYy7dUhdDp2wIy~4!F{!}t%|7&-6`m!RT#_OwQGb^8msR|e(y=Mq2`X1HlG-xCsHWsJmQ!>sVX)dA$!qNo zJG+#_ga;J}&;&?xD|~29q$6E0ktHaC!1$OMv*JqJ z5*5)(CbcGf!L7$~5Qm=8QF~%nB%mDo7vx z4Cx~z|0IskQ}~5VnbQk*QE~J+8y1CNNVRRpQ$546-C{DxZT#|sGG2MVymEVWy%NN4 z*o{D}8m<>eRl_4xHG|Zh8q)?YanAMWg`^k4G09W;FhL|3<$~>QkSi9YH_! zSza0b9DOV(BX?2ffAMrM+ZWpvReM168+F}q)K%DYMuzqwsZruW3|(23AyxKd&yiJI zUi;uJS!Js7j$snn^&Coc*|BBs0g*R|Np`7f$u6P$gt{g9W<%D)q`L?j1{iz!?IXi9 zt)Z*nDGl#EQt7Ts zS;+{Jlz4S&2jaS86Rm^&6o|6$8$w8UQ3d9A!eglYUPlfyPvG|yeqnpqmFTgi(2OhHZEl z7l(q;6X(G$F?TTjZ%xuSV8I}bv1Y2Si?Iu*M67s(?cjL(*7D{r9J;r;;^>CGySZ1V zDijP15ZWa6{$|zK-gM#8x>QrOJ-9a9P1SH%0a;{_a2G>_VGc1IVho2M!y#sC4SEUI z{N&t!3RtOg+9gnRKLYa41Ju5Xa&x~ee^L3ea+IBIqf9REPn`D0Cj9v~{i)adnREWa z6@RYipMR%a03p|CkD{@&?Xm8VeH98A_W~@V;&|x2Dc~uO$~5D6XgJ5?Gsot5>dB1b z`M1D0o`h!@$1;(gV}yB`=NSDFW+ag?)*TH3 z%2F^$@Os0y7Yt*3;#mP2d|NDjgAhSQCSaZpa#6H3Vw#XY0$qezmnH2_>1C#Mszb(@ zpb8T3_RGI^OiZNOh>o#A?_N#i}n}^2MQp%0cDV6<=KP#mN@$hvK9! zzU|K~98_B3Lf8+*1z)WAmzVx5eUm-BTt2#7KKNNnEQkG2EVpAQ@i6B9c)2Bxw?v?< zABxMq*zn(4I)GJ|!hXnB`V``u&b13DG2KR~MD8W|fe%MfVoi7^jknPoiF`YcmhT8h zKiOy}(fJGhwfDY}zRez9TRXb8=D&N>f9E|gR+wm?JClYK`Tt0oEyLI95_+ZM-u2=< zi~LR%rZXSfF{5W;pVBB( znhupbcpUaAu+$4?LWOLp s=5|Z$>Atwq>g|39NL@q$He0>Dova7~B7&-6`m!BzapuBS^r)omK`cKWhYH!$ZpbDB2>weoXB#Et|cs1yCZp{{b6U9 za@g{~00Ei;ZEuAS&9QJ%_>xnQW6wnoB%s4$PX==Gje&D0bn2VgB`t5n+YjlCZ#0UqZ&3+W?D*fIcD^k87TvDTuT^PGbiN)M51&7^rX>m4oCysmNEv- zA!&%qX=B(Nkw&=OXN;O-(ioRB#sza+8s~D>m@p@$NiOG%DRWwy7ElDOA+7&2qz#bV z(CFTuM?12Tsi%2k1VwD^!Wy6I*N7pSwx5!6jLMuDOfyUiRiM$X3 z$H6WubQuX6?~=-atx#=Cp~vMCv`?;ErLwzXTdtzITf}jcBf>Odv55lfx^-gfD(SLL z@xGh3%D2~LzQE19nhggkTCVO^RCbQ7FBu5JO9&uVPq6B{&;t3%su0=>fi{6GVDWqYLW9Q`fIXMx^fGRBoe(AQJ;(A}8M-WMCnWr%G zGj`DYllrtQ^vJY(WV9UU{cSx92uWyzZ9S(Afj%7Qq@T{6U$d6flD%eO?eI79MM9hW z932YU#Ai8a;B)keAOY4||K_Lsi(QdlQPf97Tea1)2@zH9!^+bld^@B>i33fJsEB~2 zW6`xiI@Ap!I<8HLCfb(hJ|f~SF~|{BOwl3qgixm--l>RM0L81|p*umZ$GTyN2hbY^ z6%Q)BZyEZCk9GHvs92&M!dg@nE)~QN3_!dE;5i{i<*Hb*%V4ua=p`=b43@GP08&;1 zL@uyZ!UP&DH8cgovxPb(qUwh_tUUADX;JfelX~a>f&JWH{geT~y zOA2*}Y}y(*n`w98RfBcADuyLvfB&4BRhx$$Ikvy=4}?R?5Ix=1iE}pF9FVfY%zY2fi zmnB>}(d~RX*w++{K&Kg-VeG$d^Y17h@ncT8M5v#XW!=(USw;F9bz2H@{b>! z=3#z6CCjRzIF2kkSLsR9*9h78;z*2&(cez51j z-FU5}sK;CHa>-c?5>)0HDhDYl2RSOY(yCCZ&_$T|H*frpfEHT&zXjgT z9TcZ#753 zh5I$f(D0?^g|^E21_ma*gz-^+JUG>HkSUMbB$IgXxWpsKB_76EW)&IZ636XpOy%Hx zok<+Q^GsqerdJqaap35r3ruEzyYUMPy?LzOe>0+frZ1*hPY6PVF2a?dIMS=2K%4Ux0u(378_;; z8!QlySAWe2jwPFju?%`=Lpc4(PHnZ0cLHkQ9S>jka9?e$w)W|ohnGB@t8LUaKHc!} ztcNG+oEmt-!v$|{zIL~c=L2fsc@Mwi&CJ!->Ub`o2A=cqfp>lB%f#22#`WUq^20Z*L<R41OF^5OOvMDXV=n&RBvm_E@7S zV17k&bGFNYq0^rV98TDyw##FLdE{Ep8GgxD z=qNM>5WmJGe$)*1XUW?^F1|71fPHM*Q2?Bt$H?Ln_ O`j(r%`vC`j#{U6N146O@ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_cached_gif.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_cached_gif.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dc38aff11af861fa2d333a08d42b3d1c0aa31dea GIT binary patch literal 3857 zcmbUkOKcm*b(UQIKa!}AWqqubKS?OdlpvPofh#4?)5)_c!Ct9a2nD%k>e;G(n5Mz4C}ne z>k%=cN5!Zf6JvT@jDtL^@LEDoib+OCw3MC}(?Ca+n3mDAVwOWVOy+=(YXkbAILKrP zZAj0FIYuY7VSPj#VRT9x)yKp!MyIuN`nWjG=!|w=pAaV)oz*7wDRGKJAyh)jz!yjv z#M!4|gr33YH*s1SdVun|mz2$OUP?9$)0S=3G^~8o%RKz~{i3w8T3orewpsGRw~dC! zud9~r#nx3D6It`(KdDh|pdyb9AYO)iOR>ASD%Uj|jE=4unrh%r>X#TIlvY}D{e z&Q~1jk;0G>zw;h$luel^8#39e*Pwr5&8XGw71OZgioJm?OWwhh!v>wmm#!K6rdq*0 z(n&UU-K?qR%-o_W*VN=BMbvo{69pxw4Cul3JBNgRLe7 zXrJO5!4^b*muDsI}2sgwie`?dP!xT{w2*-@FwJH zg?V~Mtujl;7lXuq+;b!}sSDuaZI8Es^um@+ypXDRDHtqK$4jcRd7SAKjK?6~_9Bor z8uns=o4jOACKi@-Q^Cj6C#tNp&;j#8P*=9MPl;(sdfb(W+uPn?U{Zo3Qf(Dm-ng}E z9!Q;TxoqykL|9Sf;|phIDx0Quda5__euZh%)uhOgd|lo*|H?b$^cJGSEn5w|KjfQ z*3V3`x3yv_suPz+f~)shO|I<0z5N&qon3zbiq;mOe;=auGRjQMf?@LGNsWwVy zvhL`4cX-sDde%k6j2DI?#}@1jNYbeX6Ug5L z7zFm)^N8?NN>9Se1kq5zng)@^k?YWF(P00Gyic{xbo<^e#BwW;zwNmx;r^@SakRqA6op3%g?#f zvxg;zpY@@|&$@isU0nKG?0LGiSUg%R9{$+jVGxBDUu=g^LMv@nS$ER-j@i*Kj$q6l{-dG^n3*ODa zg+vCZaM~~a^vM8^=d+IuGI&Zy^`Fo^I`IDx@-FyxwBRA#qm-jc6TXrS&*>fo8pz(H zudq)a)jb*`R3qDY4zc^YK}Mm|&xQh}n5$`q9LI0^Y5O5r1(v3cbq8=e%yFEHE;`-t z0u`O_1252JryE?9ce=qv*PU*75gu%#7*}xln@%^l{F>7Z{d(>>d>6R-O!GH!a=~J{@9tl{)&mddy4||@qYn%DrJoT literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_cached_mpeg4_gif.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_cached_mpeg4_gif.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a593a8db88f892f9f5109fc6fe667eb5ecdc2aee GIT binary patch literal 3940 zcmbUkOKcm*b(S1{MN)rR*2h{Wwrk2VWjm^ED6Sn_R%q3h>cmQdt|cs1+@ZA5e%RTi z6t+C5K!Bz|+FN0u&9QJ0_|jA1W6nhnOF)Oko(%Nl8x7}B=+rl}OIj3V1nKDQ<9qYo zy!pJ(jK0lg(+Ju>|Mu_l;{k;J!eNM^&t+jI@;IbWHCtGExTUxSG(jMo!8Jh(zf$@JYSb=#%=mET#7w z1JVGe)B2z>Bn@%8M;|suq!CVM^b^LYG|K6$e$p6|#yFkR$BhYTLO>BzL~8GsNbMuJ zr%{BS!51`XQtf|)@&hj!n-}~Z#WXEPaWu=c^Kn1B`s;^_^1{8vh5Jh@ML&AmtoitX zW;=f3f#wjZ=zj876{ZbT>=P4+myy6y;w~vGRowxj!%L>FndGA?p|y{R4V|mC3VA66 ziv3+u7%~)e-Y2yUOQGtrLbt0G=pS1$D^+K~G99JlEEC&SHVNa1$tDVe zMLvPJk)i~D9>xP{+Q^N&R1;F9d1e5o-PBC;X|d7+FwCTSQ&1kj=TGR#yHB z`%R0`J|-1PYzPNiR78lnZPBrS+R;=3zouqz=Zoj>6|P*Jn_YgmSiCqV-u`qU)Y#RW zEvxE?wpBINyl6WXC8}tdqO(QBRicwksu-e8=nkQFLA+BF)ga7gKtqE$`3x{5v|QG7 zBJOIsE^ZJQW;)_VjoYe%4G=h6FhsP%6cS4crwZb29kR=WweAqTHY3)oD#%O`Mv2oJ zO99ykf?qBL(Lc@h2@|NW*-#XiXA8G0q@5a`#}0J(QQM(@L{t4NwJtMaXS<7|H|kFUwu-?@VJ^uGCZo4!k69 z?<#cDrmR5vaY~#jHGRBdnWWUJZ0wfK!PkS3@cJPTe-WO*P3N@a(DM|&XYd8>^R`5d z)P;Ja9dAVlo>ql#()FId3xDRfIoyiTm3%tb+&EaE6AbhDBqo5`^=)- zYYUdDnVW0dRjNQ4lObc*h`F=&K-*Ze;qty%QA*ozecEe^X0ft1%Tmvt4H8=B87&7X z4N=dktsEpHWOboZqnBXj-=6;wj}}@7@IGkUYk>Z{hnn*!JNc)@KNi0(?q?>ND3i^3 z!zaDLVeixhZ)DsXo$|)ddZ#aY`P<%P-aGexa~M>(UULKuo@t(Fvutc2VAN}{kMg6z zv5o>wx#Pwd#l6QV?!rmd$HSFVB4bZ8!~^#oM)Bx9%P1bg=NQG}n4V{dIf92Ly}+m$ zK>0!Da8ogeEcIZ2-b5Tk z`rEUMVkTuy@v~ugl!&fF=n3=+^x7=?KcMe1trIOY$OP=}1h2gLYesM^*+dLw(AE3G z{?AwU?z(t2fCgUm@MRD8>=pNlzb|_DnukYR4h=lw;W=-7YH!iSQvo#al!vFi$sqDE`~u28hEi8K`}MrU7dIFkc$B`XyADd*SuRF zKHqhVO5@hX{;drcPq-K`g9hI4@VfWjwY>)}z7{}(t?qZt0hG!%`%!GHiITDG8}y2^ z11R>H@FFqPL>FVZW)9taB<%lUtr7f7<6xZAiy;J!_ABN6olmehf-_-d=+g(=UUEM$)93TRjxuYgs7rX5cqLO zTFCOi`>a~hI711Bk_@p&sGlq88eC+B@UcQ!B>6FT&l+|Rg@earJ!RF^9|(K$PCwH*71+_kw|SQm{2zw=u|Uaz7kZZh3uJ#h zP}pJb^e&AdrjcvCn)t0=qr=b{WJ7^b{HR%m93*c9$$OLD1D2(ZeFtzeDhPsy-f=tO z1zL1}3cNsP+)nUN-t7brU2!|%MYOMp5< literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_cached_photo.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_cached_photo.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ebee0bc418c1417b0bc0d006e75bb27cefb26738 GIT binary patch literal 3938 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_cached_sticker.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_cached_sticker.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d8982df61ca1f7af63e331883061f8c3a519c5d6 GIT binary patch literal 2987 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 GAAbWW>Lii? literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_contact.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_contact.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ef8ecf43743219693d4edcae5ca96bc4f4fb9007 GIT binary patch literal 3490 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_game.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_game.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e731d0d31a2f00333bc29ccfea55aec4436d14a0 GIT binary patch literal 1997 zcmbVN&2QX96rZuZ-@Ex}k~UOnSW%?P63Oy$NQpw#DhW%|G(b{>Fk4NX^(5WKAIsPa zY{?-=6%+{&7t{kiq9Rm@BmV*y4jU;4YYr$9r`(Lf0p-Md_HIa&NFZis-u`CZ%p1?| z_s0IARLT=5KY#b@+HYw>e#cI)q!K{)T>y`WMJ#F)hZ>Y3R&2#l4b{;M%}E(4CvBu* zT(vYi<7AC2;FOiNb57pKQ^Hk|hJMB_I7OpKi9)Kx%03`gj_04Kggk|o6r*J2SBPHN z!>&$c!E{|OFoTBY`no1dx88eep3S~7KYQc)QdO$g+_uatHUch8TV~&E;ylydQGFSA*@$`n0C|Uv zfp-iQ2RXRdRqOo|?4vf5)oVBBZ%ZuzELA@cQfXMSAD1)#t|tQK0$e&6?@8Sab6l_6 zvM6}dZZjvAPgleMC?H0_$V=?R#z+Wb&9-H_L8Hz#J~G9+FHl997CdMPS87Y1%j=jp zSTF^$&N(npZfLC+5(PoO=8mXv#k9!uGzo64rTsaf=~wwd~#ejVQ@$a!^1 z*OCW41FOUk8hqp*iLS_$-)eFpvy3&|M!=Y!k!OxPGxNE<#@K1g#aW0UbBxt()At$k zGtkGZD3`YmjJfIByPnvn&3abDU9WAlgc*2(K@QZo`(bUdv0C%tdQCLV`i8mA{hHbE zFjFe1kY7oJX0g&Nk(!}clg+jmgMIFgpUU=R?-*s6<1c{uYl}qZN$J8@^IufItnL)Y zB9bokg(J^|LnC3i5?;`w91O&xQJxGv9~BO}I5Tk|+J|UFFD6v<0~RrzgNR~IV}!(t zVKhijEVej@XcUZIM4~a%7?XL%9M5Xmh>Hx4YT8{-hB3>l1M4|hBQ;Fjcvsoa*pb&3 zOo(^GtcgjHrLGutZrdOw731LYF-NY7XK_|v&lJ(|3mD+%pI@YCscb~h6v<1k)14O= zw&pt8LQ=Q2g;0AT)CybGt?H-MP@4+1(N0{qwb4*3hp$X+Eq1i2q;8}Clikd4M9!u9 zqCWEK65YAH9Hq(3RT`Csa=`8XGdYYG2R$^R+&kHl-iOq#wcvgMwF18YG7VV;X((c< z@B#|>C=r1fD^uKUIexj}uZRig zq6Yp?U?P=L8j|Na$LlV+-1)b-5D`jW3$>Zf@fxKsQDE()>5NVM Mfx~~E;)~DoH!3|GvH$=8 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_gif.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_gif.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cdce8d0631ee2e852ea0b98a2b1768c1be7ff051 GIT binary patch literal 4304 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_mpeg4_gif.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_mpeg4_gif.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8549d039e127fbebf96a73767fbc74c69c0fd5e4 GIT binary patch literal 4328 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_photo.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_photo.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d7cd99ff436303b2560163034126d9bae10a8f39 GIT binary patch literal 4131 zcmb_fOKcm-5$z$HKk*~#YgylsZP}(QQ}!+#dlh57wyemCCD~bf^BGGRj5sZ6toblK zLu;8Z02f#wyFij#;6wHpI0$^nDe!U6K@KFKLt{<`ax!wE;XMR8rMictC6hjEkWsPp zs;j#CS5-apmvp)Z!SnY&{d4;_g9!bL3#}&-0O`#?06axH(j^mFk|IeQhs=-_R>Brm zuoY1vR#b^vF(qcjl{o0bIyMtlkJ2M>#7tT#B?UOD$IP^qQ8E%DVLA(P-0ZcoN>=C+ zW}nrs^b6c$4p@WApukCU$Qo9L1x}eKtPy2I;Iw(t8dXLG&X{A?xH2xG5L!lh@0Uo= zlFYL(LeJqBJj#UL_WQ{qD7!*Y?l zk^;lN4lQ&U3>xo}@|L4feNCf#r6RPCuGqzrx9HfOR`Aw{>uNiMOT^{_1=y(Zkd6UIj^OAK9BX2TDm?*qJ#9H5@FHA=~cJtM`LEaHPlJJ3X@c5LgVhd-UnU zAfIT<{rU*VCj*%b(EQO|(BrMYZnM$jqV=5-MUT;MlDhmA+LrXGFEh&ESLky|8G3+P z|8vv+a7UEg-*r4ky8w&rk>UB26e)2bj$B!jAzb%l&jD2AR(bhWS=NJio|C;@!wuTy zeZw^6Eh6)N@>UsCL@v36g2LOCon~gp1x=v5eA9%au_6AR5VJfdmz@&mY~DqlHF#vJ zRuI!_AqeVOJ`3=!!&I88z&9VsEs}z4Uw+DdwH%!sPP9i5_307xo|Bu! zX>;?4n%A{Q$Fg~I)6X_ts&K-FXAsvPad(}4wbiU`IZt39q8r-bnH% zGnunfoSo+E3}-W(o#!ma*&JtiVE%cvBbM&-tW(uuS=V6O3+mp!Mt5Aw%cUQs#4AzT z$Lo$w3awg|0aZWzk_bs}eh%P|(o?wiyp|qXp26=q{DS9kTcd|6QYBOgS8yd#iB@8j zcqLKksU$0@O1hHKrEfBo-aku!5O+M>mErYVCRpkic%tK+O>p+TSN>O&3;7YZR3y}o ztEyoeo~q{h{Qe^=S6yOmtLpz}Kspce^b@LDFg4dzRksghUi^+e)x$@(7dC$8(7laC zM>p)9jlB}pJcp`KAU25oWMkFX+Hm3ezgW}?dvF1}8=B$pGBVH8-klHXhbjt)8dMNf zq;kGkrdMFdUrlvC@qB9&7Qx6hfc>Y68n+~rp7{OJ*UP_KK1hu>P&S=mLnqn55F0(s zCNHq@b8I5VhQ~Moa%U~5kis2A@+lX8Xl}+;GF7sf#EW{@uL^} zwPme-W9#6?Rt=BWFmO(Fyv6V)`|v8C<<)@de3id$^rJ+&(T5_V4HS>0-?G<2>_?F` z>1AxNfv!X{jSO12CmnqBun|YIc?NX)9Lrr~GdXtc#*5gusrt3GgKKN-<6CTb{o8$( zoqZh+-H|fiA!#;M#^*u8iVxukR!3xJmn7K*Mq|FF8Ks2MpTm^;8Ay8o5;Tws_))oAolpb-KwSX literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_venue.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_venue.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cb3e817a3aa9f5af7bbafac779bbf8de0545ba8a GIT binary patch literal 3776 zcmb_e&2JmW6`v(%`TZe^qCPEY{V7wD#mY)xL^hhZimJ+%r8bsRbS+`A;*O+^_Jf&S z+F{EB4FqTkw7C^NG{+)E5unGO`X}^20X{7DWS}SC7`TT*r@on`C^BS$rs(kP#B0K(h90CQWHh=l1ikfTP*Ov`Dmiy0X+D`z>58$)JJ&T*VD zhRwX3=QwGMm<74OampAq$K){qh0q4l(w`$OLy}*I5&8zcpvdD|_Ax3ByKfU{lpROxwKUrUUxVgRIhwoc8Kf0y6gsO%g+o>=+K;jb%z?)FeM`6=4 zbc_6~N@(pP;#3WHw^ku*=4?(KJ^$^?~>2@`yJ=1kBL?NPOoLQOXnpS0O9Q_ ztnAlt;snWphUCx_IC(it@F#7LKuC^gArjTX_n=7}X&A8B#u32LE*$H!iFe^d8z<$M zmV!3vjvVK5rXwe~obAX-E)R9&l$L|`!yP%T5=*U@Z6!c>qd5Fv7flP9A zs(YncvhO$XRYIHn0v!t4%;y<-_zU!zAm<;W^Z%mckM_9)-+MIy8=H`zd_*dgIB@8W zq)N}&xhzRPs!19-RKdFzCHI&F)zWj_Fr)(_F=OeV#x+%k&?V`<0bXl?FFYegZBeS( zRjI665-6p4oq3sJ2L7d#0|%RzT$}Zy!I*6obnhPXKAj3F>xVkgq_(xBTaHUqO|lO! zrn8jb(|>GNX_>4_$F5s(R!gO_P05l=401$ObIGPhr32e_N@_*Fs`JqKl!Xqg7#7D@ z%X>My)(*UO zr`_YKd0?r!p;W2SwST(h?)%vb?Q>mokNu&GiesW59lON@9fh1gXBm?iyUf@X#;!4T zgRwcrij2(z^KUAB4!{?yD3zL~TCQGJPM)ju$e}C&`4LLoDz$vPZCj+wvM?)I_}~UZ zki~?zGJxL;FX5hW&-GCAHGJQ|7nDyr8ZA^8>Y;kLj_YDQQjgYS^>{r|Pu5fQbUjng zYQk69`p_SRFZs;}w@Y}tm<`rB4t>!{#-x~#bDN&*t=XDx9qpY| zsp{HPfe_y#*0a4W{b0|58}wF1EuX-3=Ip7u%@RS0#fwu4GJwKUfD+^YB}jRd8eN7l ze>pq&_?OPNVhxNO1K7VBsP%z>($l|N|INm4H(sSKwNNgd@d^`OzTiz<_9m}-qf_4a ztT(gZNhL;CR=nw=cjIom=JIlD7FzITEeYkXwJvu=)>WWj=q-$gidTXSF94?etj8GQ z2R^|NKXs1y(Q_?7e~!2l%rHBNF^+gVaKwXxBOV!7nF$Y%>kRQ2;aVOjH(4Ev7RnJj zJ01;mk)d0_iX+TiVH0l!bc(k;e9Obh#zte~#fFFPcsSqKY3#h%@$ia=N1B{Y@rZ}t@o=W` zpz+|v0}o&F@K9r`vGoF)&v;ko8jqTIE}&C9=i&R_^-3@swcN#FwI{}@tsr{-ojN<854vCX36cf`I>{~7lBk_?iU^?#& z827q&W1g=LIHOZM@8KJ-qa!W!u9#_M(CUux>b+gqwZ$KJx0V@|R=m6K!xVA_Z=u90 zmTtFJmgC^({~L?5f%s@0M&CU@&h6p^bG*YUq-StE8U}?Qfh+)NBk&KFziEWAC}S~Z zAj0#?IGcH+!iSDGLHP(_r45Uiy}+{`nsa_}2X!bu=@3 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_video.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_result_video.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b191cc0195c0f30ab21dd44d0643a4f450be40d9 GIT binary patch literal 4664 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 MuKL#-4EP@Z2er*PZ2$lO literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_results_button.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/inline_query_results_button.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..06c3c872e0fd6069fd845eb6515852d0283c583c GIT binary patch literal 1803 zcmbVM&2QX96rb_OekHpJA)o-QWD1BlQg+o7QdA+@5QPPl6cVUvHVoeNY~sdio0)Nw zts=BYl_(N$tBOPq98eMJ5ee}}AdyNORz5}I)SFQ_pqzMP??(&d!g&1r-n^MN^M3C) z{=Qr;A!t8+^Go~vJVL)qW7zae!N(thatArc!5->h3uCD(p3+e*wWC>DN4InsQytCA zb@EmoBdW3-*t%Ef6s;mg3R*=@?j~~bG=EP;=svtzvr0~31DVB#(ll{AVf%g{Y~cnz zH`TbjdG+!NS$<<>`K|ieYOG%LyK!MXly2L5h_f}7P3qBYW_Q+`*Jw*Xl+qR2ycmXc zza6x)eKM(KAAH;f5dL|Ze-`+_?lD5Y?@~k zM}wz$S8=9pp*D6ZH!D`*7TU*FaRUv%=5#z)_dVCA??jY!-=#eA1iuss5%@QLEg8@@ zcU*1+>DdiNLq<9E1vhM?na(mqU^J=0cY;0Nu$#ekYPe}Y<6{{SmZTx8#?>G)78W`Y z7YhqU#Hm5|?UwMmM&MH;Xd7Y&J_GEGwo5&SS4-&$HiC$?=#sG`M97zFwN}7rRSZzA z25h_53xh)!2&jd$dXHFgz)b+^}XV zp5nr0f`m5IkqXL8g-t;r*b^Y)1#%jMgoItk_J!LbyL&d<=1kHy&M_(?=EvF^<4VAG8_R*?`rD1&h}j}w1S->@{`JP&ZnME%K^H^2wQFxv-mu+3-in&&hLqQ` z!jZIcWKcSi)vg+L*&OV2Ah`)L$nM38XU#@(<`o-#RlV=j7lq>zG zp858bpVt!=^lV`Lqp^{WjKwj8L1rn#U=s8U!iv;n+1a!d5|Xs2>`AH3f-p-GS09K% zNL(VM6F8A4^+^Kx+1|jDC&UR_Fg!)bBfk|ueZ(v#{|IUBae07xi+UcE3$tgz#U%k= zW6#N1z?w`*h5rZwFc?3HqUnVMNim7^O0V9le_HQr=lUU zFeQroHi$&U828b+!^is(svVx*kC1Wrct2976NItZAHq7qH^~_oa{jmY`jbE8=%4@L HN{{_F<7?+p literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/input_contact_message_content.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/input_contact_message_content.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..db146dc64152be0fedd182e188643221bac13926 GIT binary patch literal 1829 zcmbVN&2QX96rZuj`<2~I$&ywiEio)ru~f1b#370bC=DTeY!E3zm_<{^o=r@=wmY^9 zsrIl)l_(N$Lp{(VDnh+;h75VT)^{Jr~n0ii#HF>Xq(;G;GucaeoG?4TajF&4VyNIhAXdqgKaMOR=>wun>c z74;%U5?Vu+avNC%R=h7G^Z-WQ^paKFL|W-km>N!|4A=ESBeXp?(B!0c?UN5y>B`%y zEAOti*An?ncP}Yz_`+>Chd6(yvF`d&_&y5)W1FpbZphrw%(u@a$$#(>2jy#sogp1t zNS8i>9CX=|7_sDK@RcDC(8)-LJRo9X6(@EfvrDYEc&wxlS)6+qv)ZeoVH?&Q<`-Q=`11{K` z6gUeb?k1!S5txELq6vDGU`!!|kFJ991HKEC4aa_%xewz3jJ$n5@mNwH_ocqvClaD8sq#~$D9taz5~Zg+MgZiF7Ez?2SiZ+70Zw>p6xvR8b= z+=a^$bPU@Qd}@VzJ_}kIk?5#^bX3922EHu%d;A<6cB^?h?u+Au&cnjs9T0yFP&$Wd z7rtBlX6@Uxht=~bD%9%n1udSx7|%81v-4>gCbHSIf*LQSQxj9H%pF2Ig58i-%|U@$ zjeyOx4Bfhz6V%|DCVUyhrX(psYoK>j~b78_-|O$47GXVlip0>^Fy*9vgt;=7&{fK0%?93pY= zIQ*5MWHx8l6RhF_lpLa2p=DbO*p5rfd3mnzi(m>ogFc8<#u&%w#o@_*fLg=T`vH1w ac(SL3OBnL{w-~LW4z=Tm%HbbkY4{O!5` literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/input_file.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/input_file.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..bf05a261d92d930f8b9510e04e20b5e92b9fc31e GIT binary patch literal 8127 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 StI?fV|Es9_+e;dVb^HUj-`0l! literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/input_location_message_content.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/input_location_message_content.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..64acb26a6dbf800a3f87850a7b9c4643033920df GIT binary patch literal 2060 zcmbVN&2Jk;6rWws`YU$6`$3wNO`E8!Aa)N0swh;TP~57;sR#&RTunB+V`s^F*PR`g zI`Y9tl_(N$gC6J+6`|hwD>yh3ht-}UajLj13P>m?-t5|@fe<0av(N8ic4pr1{hs|@ zKA%M}e)#6c+FKcfeip`HD6t~#mqB@mOk_$nYDg7H61r^5jYK8Uz!lt3Dhl`#CbpA} zR3#-L8I_Q!+(%}TrXD8{dIC>8Drqydj;C3 zUA=L=TnZ9zIPD<4))Zmgek#T9OkH=HE&ew3JiSg=U58VL8}atB9NzqEus?;nQ&f>m zRFU6<94ZM@rr1oZKr91!fR6h*0B%{17Vp`D8C?9fg}_DF2g3>!C<{wMbc zo0AVvO)@9$k5;k|&^@U#vW^Dd+Ej2RO5>($MA;usXXlr!3gaExWYmN7Je6-zb;F30 zRadq+Z+gqcqTw=H;MAsdrZ);Ms~0z2?iKZ>b>0#nHDZwZ?_Jp-s#{Za)$Sjv_Twsd z)lI63lTGw8DVUvDxv^6-tKtpcTHyE+fj zHXy-UCJi#S>(nE)d@wdB|A*14+riY9%d8zhLbr)-7%iq7?SuSqmF4i;!H8|$rKCxj z<(ffii|VH3)Ps{v=H9a!7H<>Xri>E?{+6dn*X zN9xF(L492S)494bz>X))~o84D_C3P?I!h#5naiEC8SRi(r0d=*=93v-p;}?H7N|z zQ(>id3&bB?6rM%-xi7AMR{Fg3Q*Jgy>HMhw+`KKPr3?kH&=-ktxyyqgbQ~7$dT<6GA%)Ld%KL zIC_H;5@ZQ!xMs^1dXA7gE#2-%QiPbU0q!wEp845?!W~g}hQ;mzvmoEEnL%wEYA>-_ z@Opw`ud_L^N^mn0X%YAx1OWHfCzP?04v`Q!q)d0$x@(`T`FP34)4gc!;%Ofj{1=No ze5!{*in)u6KCb%ni`^SNyco}2yco(z;j%wB-!1j)S=dbW`;U2 z@%I%ZfvCXj7+BHmO!RedB4+O22+IVNF|enF7HuuSK1i>`<-NjQ08>=K>wpLok|g=) mT<`GQL&e^|&pq@?@9+$hMG5lyr|6w~`B&lo?TA=(yFUTMO)dEV literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/input_media.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/input_media.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c39aaef8a4b5e06bff2e3749520718a8c6c30c5f GIT binary patch literal 1071 zcmb7D&x_PB6i(XtMR!M7!K(xXWe(fkiwMgu$bz#9yC{@mCT%h^b=syT>B8PT_&@By zyCUBGD?H3m<|KI9+sJs@lSw<{&Y%b9CHZ*oCGX42OY*VXb%2&H@4pTw763ntv65!3 zz=f}sOF#jIDac>|A)pquQ!BFr8v+YF0krWB&?d7#*Z_Riqn4mSTc@DczA|PH&UQ$i zb466bb9n`8-<^J`NR+ZOma>r`*|X?1i&b0`)M!>}fs5N3F98Dqq#&>;3~Xv?etYH| z=S8Xdj3$H_Vh3qC8z&O+iVg`@2qsysBvNCBVxB8)AU;F{WhP9clw`z^;wWOsEOpVb zLUPQ@lo}V$^%y!8HQGmhoDwPh0ZF(?+f^3@lWt=2z!f7Vd6HFUb#JmeSosG3&qH}! zW+tB-nxmy_3l>t+gs)K?7<-HOV$9Wg{BvV(5r3XgwjTe&*n_&9r@Ry~^U+wTLi(N; zbHQA-d=M@dBQN4gdZbA1R|T%>TNUu6*O+xM&Pm2Fo;et2oR+E4cQJlbl5{!K##omT z<4<5=p3-&y$PZs~F$oVjP4ZDVDFsnnV7*Vs^7HU%5`{8RY`-A!L_Z4|F7Mf^?%7+r zXScWzZOvIhODpoOhPQv(+;WK7Uu8F8WE99nD19J?;5QN zxuv!1&ZGL2kHwxg&F_$}G|X)X;Wuz^y4k;jhtthIZ|y*x(cduLd+^h^fBj>w+W$8+ C&OE9B literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/input_media_animation.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/input_media_animation.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e01448840bae1bc2b2a0e23d552f365bdb0ab636 GIT binary patch literal 3081 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/input_media_document.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/input_media_document.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8d4c173be6b06e5941dd2bf7c810d3dd72969f91 GIT binary patch literal 2565 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/input_media_video.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/input_media_video.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d04f2305abcb12f8fcd6b6cd30b75e7c4feb456c GIT binary patch literal 3095 zcmbtWO>7&-6`m!B|38xTXW5c0O0tx!YEyQKw5|}yb!}Q!V=G1N#OPYYV#!@eYwvQ| z*`-wlJn#^pDbNPJ6gecl6)p;2dJ25ZA;%t;fDVH_3Fx8lje&D0c_9T-_hu|Sg1&^J^|%Zq7z-Rh%G6SgnGn^*ij{F zQ-#_wC1%H!xSdcEc2Y@#KdMtJWv7+2&|_A{&MH~Z<9fo%*?A=|5hKd7U?;5+dsG<} zzLa&w9#h675+R#JPk%)8jFEp9CFD6gVN=HS?0q8VUZN>WK}M_998dF1r{>D>Aot)G zKP#y>@04!7yS2R;L~qm%1A5nVy&!Sd^bDq1LGryiMuQf6zXr<7NSG;c%h=T#mIq1m zTeW(_yJzU8_TaE?yp+O-^spO(Qo_1zS_T-odxq<3dq%0|nciU)C)aP;P?28gkmlF0 zkp@vDohXs_VMCRuK_B-vnh+(fM~s9XeFt7i5uJh_>*;YNsVBfr4(ybk0y`br5n`nE z%rh9_IZjqIC8K8{A~Sd+tLMPZpLk>BwKsD5C`615-pK1`z#bdeBf=gZ*rURp7}#g@ zNr;~s*ki&z8`{P=E1p~}9De-U=H2UkZEhId``MCFM|ox9WAZCWnY>T> z|K<5$WOz~^n7ZM7xSuXS`?*nPhHKP3x1bfCqNCtBg^E$YzG7O$+;l$+n z)pm5FJ2!|qF;z}L^evZz(OyawHpcW!!wsh0edj>!cWV{rDGY>b?_PLq zq>AHMmkPt7hO;$m9xU>})V=*6zHgX&`(BXL8%&gMH$TXO8Op(!+o;za=D8}Y($H+P zwijgfH8ATA>hlbwww*uHw9U~`y&5B}`p!d# zJ=wYG=x~ZVPw>bcra~p{7`3N6cg@O<3)l1Ix>kJxx2U_LnGV+58di(DCJHTNn<`4J zSU+S%80f?4*ABASU+G)mbt?e>Y>`fpHCa5}xn&4{zH9^`1)C6;dCg>|P!Qo}}B9WQU@B{>3nT*;hfINj~ zUejztRfDvOH$uZgJ*%p}Y-m=`lTcONsR99z(m_mIQDPavh^n6WutLPJ$bk0$b)_+i z!FW?%f$^&yXrufPLGH~i~FXe`+w2wC#IA04f3v~Kxy zBa}AX;Pf)51z$*;7CI3Udl=)(a%;<{awu&oWA|Z_&n>hzeYy}zn=Wvw@+&|5YvM(= zeWi4CrPTVVPfMY+X$fC?9N|A$_vwUB0a4m?ozp{p{q~Cke^YB;uN+;k_;l8%fGBNR z;k3+W=39_xK9n|{=P=l8p>;c)C?L$0(?xz^v319%i=nikgRXJ;vQMXc3W(Ci1wQ19 zE3J2Zx)Ms8u5hXyCnh>Xj^#Uf^8Fjq(Ob8VFJFa~^J~{%B)-hHuiZPkc8_oTgl}$t zdB8_kzm7)kNcnFFVkb^6zR5vWR{7Pp`D(GVu$%&J|8J1ONr;&YfMFquv)z^_kcztv zxKe?NEDDYw4h0T3LdX-mb6FfAfsjN<0R;J~W#SiF4}YOCq+k#;Y7N^Bshc@*Lonn| zkPdrx@k4=EQjoX9UufYM?U3OO9&+vyYGRtm!*24Ouv#|Q4KR_Q?mqxJQAv_GS@ciK zF)8`qMUKfu|FryjPEMBm({dag?U0C6pDa2o?N zYX^1^V&|`5=!kAYV(NCNOr5Zuw9-K0h-laECRlF57=f7JOi;9MsT%jtS=K1$ERg0_DHrfD(zdFkGGUpaPRM;(;QE`y1u|cMpp${vP@3|YGv!v(%V!fdx@|9DXpL1)fbw^K(i#v=mH%zj z%u7BBQ?9w_bm4KW_ldghn*LVnm(ERN2;p~d?`Zb@0UjL9zSFry=ra1(9oH! literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/input_paid_media.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/input_paid_media.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..79c686d579fe337c71f360fac035a1b7093f9124 GIT binary patch literal 812 zcmb7Cv5wO~5Z#RvE(&)k_yDvL4Usszw-C)CAp{&J?gUa~u~~cPk|mDU?5nVM^HY$`*Qk<67t<|Hqu!e zs}PNIB8j9qnb9Goq($x#*?L1{0Q7x8$R}Kl3|q2&Oa`4Fh(-o<(LaG4#zxE@r!OFL z*(T3_eTtXWHB{#W$dF2c0CX707J>we{{5n?+>uc75lAJ(O+3EGOdho+HkCuKyj8lRB2+BgZ)xuQ!xgctos$!{faL4D=g>6k5aAL zXxQthUjKQPt({JHNw$=^x;b!&Q_xO@1>;Ao0rDf;WbC4K(Y@W=?2hT<)(@3^fNB{~ cO1}~Ib^Bdj=~68Bw|e{hr}zH)N2o6L8%$>6%>V!Z literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/input_paid_media_photo.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/input_paid_media_photo.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c43e53911d9c009ee5081ae7eee3643ec1d37c55 GIT binary patch literal 1745 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/input_sticker.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/input_sticker.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..39a479d25f1702baa30b6b62a23ec709db158443 GIT binary patch literal 1951 zcmbVN&2Jk;6rcUF*Pki*XdBwJZqiDz66{=%Ac`tbNYg4!QYoo`jib@pGfp?&4>P-_ zq_U8aA}A6dE~p23L`A4aB>oBxj?}|yPmwtFwkRBsPrTW+-9&(dn0@>9_vX#Ko%y{t zyFcb~X$0+;?|-d-ok4ygr374H!V+6Td0_R z$<3k=WOUnhJl!)K+bt?VZu`S~D|q?#%JSNsjnzPU*FFg3yN2rp>SmJ<(#=4*Zv%KK z!~yc#)TDb%w>GQ$wB|v`)E&Fo@@^R>1tYtzyN!E}Yw*dncnz_Ze?FWWiaH4G$2z6`Bs8Y9}7uG8-q>*1FwSnEHt4}ahY`0Zvh$D$b`ex?1)t^$Ewsh9)Rx-{5uPgT z#1FzZ(Q$!tmNtqCI|ozPC|BcL4Hx_qDvE*Pwwja$D#nIwco-MeVD!||u}jT5#{U|F zO+v^Zg>lW)T^D0l1)J9hv`%mHy~WD=4r^4F9b(vfl}3x{p2INYwnFWXD|d}*1x^5c zqp8;#`W|&Fy5aCMQ}zy;)GbG;$NjXHng{GEM1M4KnA;nU!9*FpW+LE&YToBDd? z%hj(|Ut}+bD4EOq7q9vkru<7c{3~<*g1S zVm1XvwY^Rc$^#$(WH_O$I+W_!@O{0A_YAEKb7KvqG&_KW(M2bD2{M) z>n%8EKrWNO5hS3XpaNsw_-SJau995wk`3gl?o!5oOhGy>yE=TR863!ddO3SBms1=? zujBmo)TKC&H(3cxPQ3dws8A9F!AH~GvvQ1ERg6dtebUGH!H2;nc(rOu#Roh#|p&WXsQdQ}pr-~!T9(r)394wzAaYE{0Q8-jN^^Lt7vJfQH+40-={NB8I z^WOKyzvlB91mn-2{+|9BxF=j_4moCo^>2ZBfCwUji7Y`A1kNYSge7XCC25i+YqFKp zl2%GfMLN+`thAN}ULvxYv9ekg_#{c0IV-Q_1w=)b16eT(R-4uq>C$Gq)uD9=D1k;0 z$=pLEOY=)2Ld)>PL+d2Daa7Dd5)+n{r?OBdee8+K*eGrai<53V_qF(a)11I*WuM2a+lAT4nflBtO# zK_wy%f-VimrZSP1Ab@2aL^QM{k-BvjA)eFgyydnHv zSc1bY^8?4eGo%gHX5+Oq%MNT80Td~@tx{y~_^=?r0dL_=XI(WnLs_sBvU&UdxR54g8tYD9$Eq`}>Z%7Dstuj$IqDQu`7Wv+?*n^6og-6QHEh$csd}qM z*?cJzg*EQfScML#ZyE*Pt~HX#O(?n^3v&$(=2l^*sxy~j%OP~5w~5GW5g@OD^#^JL zgp-qFTl5^j*GA*B#t5673>7$$;ThE3*thBERcua%JK%h?7!u79i=C(o+;A5$Tz$%< zc#cltDj>XR5oQRlN=5f5xdO=Uxam4Jb}KiirDHe((>L~S?iU9>oX%!k#&4Z4$*5Ojb|{TGHmx-KfveK+WDye9&ja(L z@BsS8YwF?65N`Az{Hmh zo1GYPh+)r6%+{FhISd2bC#ZdU;*v2n;Tj%2TGcDFP%U>tHyqv+ecpVPx_wbML=eMG zyfvDlRGnuBVXM39Ytmn89_TPwxuZb-T|{*i<$J#`e>3vk$ZBq19i{Sxptl(8JrwMI zJ2-SQD4wfl;a#Mt=TO(ddVW*n#<7BP>);R-3vpgLfsYg1&AA96J2@A@WEbZ+R#-15 zJYf+O*jt=affNfo|F&*XjKd7(eN+Ps<1mNut(tB&G%1XUQ-RlQ7;pJLKy?5%uT+@B zDc)A%98Xr5Z`7$mO%qBjuy^6D%b|3Zy~nLOnxu^@&VUB8_TpDhNU~B#oaB(a)0eto zu1MX1^ht2+<3Cc5ax2HmtH;WVpZZcco-0zhocw6v*@F4%d-D;(GR0Oz7OIR-YA z!5Dw1*+(F9aJT`Gx+n-jfDZVra}5ppZ#LJ^9=~<2p@V+w4A61Eb*_o+P+XxDNGJT( d8AwO{)>%*XLj}>R#NYqnGyeMdHoEBK{{hUe&guXF literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/input_venue_message_content.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/input_venue_message_content.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6ef6fc87e9b15183cd9a0bc22fe8aedb528f3e35 GIT binary patch literal 2143 zcmbVNL2nyH6rQzb?X?ppY2$>@lxEu$MVrtVs031}Dj-y$Ax#h|MHolZjd$!WS?{{D z>q06Y9H|mT0&b`WdPJ>IC64?G4vxfOwWmsmLvM@10rkXtvyMq79G zsFP`A%UOk_$Re@S+r-N7?EN$$4`C#&tXbJLVrY+1HI!(;bX_kn1KV?bBOMj4eEQ)< zw($PNg%2*REJo>f+^tAkZKB(B9xKT+qnF%fE4a*k->mZm&keX6RFmZs*+2QupnnBt z=cKGyq@4N~VkoDr6sK1DJos`D2VmO6D&WjMob6$)tXetn<@H~c}EA_#?u1UR+ z=sYJzEUot&x<{?z9a2-Q(c44i{2lV8QXW_%d;i8*G$F&g%H0+}7~`!!@;bDScvEm6 zV)pgmI@hmNlMLwRuLnWXKUXSMJ;CP#?(n)W8}pv1mo~h>FPTky+Q!T^lFap?#;@wy;1S)fS+la)lInKe#Nvso$C!bZP`Mn@d!!-XYh`&1|K1B*IeS7ii#cvjW8$2G9d|@bj@nm>xIvk%2C#J#^ zbD>_se(G#|1e|h4e3Xoyjz{|{K9x8S?ZV2$C?-k63?#*nNLFMBZL%y9$=V!2o1~mX zl6Mjz`GiE6TuCkQ0-^~J#vqo?H5;62Kvs%Dz77a26m%!=uc+)%^`u=+^Ix5X6B!cT}4NNYa_9!TlGzc@uzEhZ=iiCXNe zc2>7nLpmGMVpsMZS`6u2NQXL0ou%!ikWPklq_f;v-d+yriEw(RbGb`rlDfJ9G}`UP(R57GpA{4#nf-l~=HY!XqC4dP literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/invoice.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/invoice.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..82a1f5c7f56320edc4b192421249134626953393 GIT binary patch literal 1584 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 OR=+^?mrt=J5%~{q&zune literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/keyboard_button_poll_type.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/keyboard_button_poll_type.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..406f3b5f675d05bdb4f9fb88479bd5e7fd898659 GIT binary patch literal 1522 zcmbVM&2Jk;6rb^~KjPS__((ZG+vP(7Bd{foA&r1EN>RbBlpw^`Xf)m#+gq=9mYFfZ zRSrR_M3E>r)B_wipd!>e{{s>SBXK}`io~fmqi{eu@!qZ-S`jWh&%F6~GjHDS_n!Cr zdc8_Oe*F69-lr}hzvE&d#e71K+Az6G1Q9eMBkEI%^FmY@IleP;eRov!i?HViH!6+F zewmU2*(RcRi-?je-*X7L4?P#ZBFa0YQF(yN22GcF94pIhsAAJ_()#WP*S6T^<*m&t zZ@0Ho=goMMR<0&!=FtP1-&uWkYU(lO?p&RZ>{*{+vF4KS9Zu^Y}C@TSLCFt zxE61XtyS?g6-B#~MBeVfPILgT3{8c)kaOCw`zJPRj0)$_QQ!1-6ay+IfZJUGgu zNbO1CS><)57ih^XtavOuya?xH?AZZWlm=gkibWXry>9k2-p3b=6wPY(`i>gwK(2WM zYZJ59YQZhpv~!M{O7~k`Wlf7G;q${eirf`Og)wGc+Q;<;-`9=RAEqvv8dTSSsq`gw zIsuF&6TxE}25h*;b>C>Lp0uQ;9qTxC+bWg;rVj;2G%sU}^zny+V@5_j#t26`tIx_ya^G?|9n9#~s6CMnC zUz!dN6;@&kxiYNinNwc6I3xd0Euojp z)rrziE#hkfH9$yj3`GlsX#8rWB}g0;K@J$pR+n(w?Q$bEBFgbShO^8QVm_{{=d^C< zXJLtCn0-()hf?|*d2ae>J0z{?f44*O;`GrrE3Hz1@ozOf_u3!0{pTsREV{n|_XeSR literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/keyboard_button_request_chat.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/keyboard_button_request_chat.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ef02824f6c10e9563f2de2191ad58488b57646dd GIT binary patch literal 2870 zcmbVOO>7%Q6rS~te-k@DO-bAz*z^bDq_JDdsj4bk(}q%-KwE?`X{T%NINoNx>&~tz zL6!(oC5i;xP!IIb11hR|=faIM2V3H>+EXM>y%~iA%8B=8ZIh~rP&=M|``)}a^XAR_ z=BZWbFp3prhEzsQh_cxQ`D=)flagYPQsg6uw4@plP7U=m=#s>s zz(;$0tQ3VfsF4`RF)1epa$L%(ft)agzFH$)Y+$9l zcG0dnqAnAv>1C(s$@wm%t>VE{G}7*vmZg=s=GJrpV|PriCaua2=xW>!T{=Q=x8c}^ zX|HHyxn~V_*ML#jL>~6aH94cV8o*=S=IDLLpTix#^ZVI=4D6l z-bQ;9(H(Bn)qeX`J6-d!C02h?N5Pb_-Pw#|Jw)j5FqS+n9$F67yla zfZ8)RSw1C?_Nvnq6@E(lp9S@Xd3d##s4(c>w$OoGC{Rt?3sSvdW*Px4JB}5MpanBs z25;Nu*5X#Ce{()XgX=-MZviQ4)`KxA)^wNQo^8F(x2+){Fm7y350)sx>N{Mq>p>Q0 zGkyE*W8ujMQ*cH*YtpEJz1DfX%tesyN8_2E#e>nlIM~?0piy%?CzljZy@(h`vIogt zB(ETuL^6dWi)0^=V2ebul+2(lA}1rx%LzG08=OsM~D7i6$6>YUnYR%LL=wf@A>ADq}C{LF|V;1xdy# zmhQTYxfzhLa17e|){S>gEr0BY)#ajtS9f`}DJwFAj4yNhv*q{A^0Eu%WWJ$SR`nI` zF6*X)HND`iHMm>oqo0NFXMHRnTJw!HF%2%iIJ9d*^Zmf*!Omqs{#hs88InHu-T7}8 zzFqiZ_&}GW(;0vNQC}|0P9if~^mAuXgg$)&Xm=8^aiS4n&+DDv;X* z7bLeYJkep`!^GjqgxMQKPC`|360eezpq)UiM6To{e5F=mSaK4`l0!5L$zdWSRK)@0 z4g$%IVb<{;GZv&6t2;*1LVlRB+fCi-Y2u6-P6dWX7~A&s1x&oioe~t?VlIMo4-OS> zS%5c19EMRBk^iwBKBtgbS4W#71UpGRdi7r7hOrjI(OY2KtEp;O#YDavUZOh)F zS)U63$jtiXHk}E3ht8nY?T9~ftWEc}DNyVkdJM-uRQ=ay*O%IKHtZcb>(ej&;zFAq zY*V1vJ9GhUP1Qelp-m68DNyVkdI85*)E!+eM4lV=Y0-aUu1zP}6e#u%o%891oeVeP z6J2sNn(2;{`4j%}xBUE@{-q`Vy+!}naqNYYK)d^=lYp|9BS~Ccx)=~~w4VhiFbI!o z6Te)LcKmY|#NhJ5Z4J|kB~Zk0INiIOd3iTQ9LKWqyRlQj7fGBb)BPH9(j`J*D{(qR z;~8-rM8t;s5J*>56vZcp+Rye4QfTkqH^@x;*}kEUc8Q`C6`!7KKij*pqN2cA>`WhK N{*s!%chSoT{smlx8QTB= literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/keyboard_button_request_user.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/keyboard_button_request_user.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fd9d84200a02b7383ca3a4150f6238e523e3809f GIT binary patch literal 1988 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 DhkJ7- literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/link_preview_options.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/link_preview_options.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dc019e6c4cab4465817d304b544f54d1b60ee59c GIT binary patch literal 2611 zcmb7G%Wo4$7@vLknb>(iNC?ZMg;Qcv6#g+s-u-}sS-lah8k^Z9$v%(uUp z-CqL%KZ5q#&wr+W2ktK>G@Glztb7T~Go&De(@>U6a9KXVXN8226%!(d6kZWDSJs_y z11~Br&6D*eyd2`u6jIy|k>VlV7Xm`BVANZ}r+BZSi0>^EBcdI+{>|01c;fuoiHjGe zr)=R&Zr=7@$(yR4lQi2klLO{0&wM%CGfC1?K{MZSbvbyQXe2|W?3L6lBAYTx*=!vR zX617T{tmW4P=ZrXf}eq{Bm^E2QQ==eqE{?gttDK&O0>oipCTLwy$`mU z@PlvL2AivHt7Ue#WNzO!vu9njwJ(_gT2V2!e5x3e?P1my0 znyzJjrTw`}5k9^Kg;joCH32pseG-aq8++R}_5kTrf{K_9K0;|u>3A4SbUi|MxkUFh z)clWh+TEAb+}u@4ZmZ-@9g@bqhyF0MNn*%UO%Wq(-XvkY23I3oFo+UP>olxETsU73 z3};A=P>BIL>aPV~(+gB4@$gO4%p37oOx7uhnhhvNb()E#bkm4Qd3Bg2YUF85Qp;fX zF#~Q`uxemMHKdeA6uWJmFl`G3s@X#uoFOPpC^oW^rr|76RLSn%Lbqj*CeaLO30kik z*f5iEQ@?|ylzy9FliW4!juypB7Y)L3qU@;BE=G1R(gVcak1uViJ;wQYMar3~jOXsa zN(|dgiCLgIxp{=yt>uH!24m$Mkf+=;xQooD9W*asyn<10w^l6*zrZc<3&Mi9;8M8f zt_Alm+>adGY6xyCVVdrOfR`x3+b*M!C)D<0tmae`$U9*#L}psN|2cC=%^6Id0QbKStW6-bC8J6N%DQkGzB`!UYy zN6(;2-~?GXp~zffO#C@=pbkf_Uup7A?DTIBpznyhgSyFVeRMeqRZm^d0ER7Z~TZ4zJp2KBv7J5aTW$7{h#K~N2+Je|Iu6RJorxF$GPBp#Hiy&ky1~|T)t7dZ$(a6;ge1q z(|2yxcQO4gGr&(K311naaIWp zH^DL;@!M`VcyLnJA#M$|L0MBt&WtMc&z2gp0m_m=DEsoNqpqKEwUi8rAH2uw=i?;( w6hsD5;{gyy;5e>|#>(6EH)wx(W3Qrcd1H6n2jMBA&17lt9n-$w!c<%0KW2@ZPyhe` literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/location.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/location.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..512ef25d949261248a442c1cafb76b75591088e0 GIT binary patch literal 1829 zcmbVM&2Jk;6rWws+H1$oH*EXPQ@n+XHtq2?#zj=Nivv1$~y*K+~ zsZ>C)e*XUH_Og!9uTmK-EftibDhLmejcmn5O{JzNQdV8HnW<%(xQ3frO#@rT#%{Km ztK}4=qE%#T50IUuxyKoVp1@95O}BF!$k3lj)lkHU>3J+PLx*{RkrAcM57$@7@{N_{ zo9|UuMdlr^E%Y^Cx=r_)l0GxKNnP6DW^--pF111{jhymf(%*sp1*A<;O|el;{Q%Oh zWo(sVJ98a;c_;y7+?SyQNEX|~l^2=Uvt>4lC(c0VzB zBjB>3BFkym;-0`&=21(Ifm~VGa(qV+QjTtb@U8L?MlT%r!SWdP6WHmxJM`FUN9m}Y zOb2(gPS#c)Wjnbaly8#JhVjf)jVv$1L%bx}2|53S3{_}B3knxHA&%#Sgcx}-`CJ7g zpzbyy{~d@=!y81N5X&`#fRG>$x||8Qy2tOoyHvl;_-=ifNnq={(1eh20{yL1?_T|u zvsDkAkY4spYu9Yhpl&)$-i=Dw_GwTVw13fW^BIV|H!*;EagcQx%)vUaKf5SCi%N4} zuY9@s)#@+B*%;}i(dgy*Xy#mW{*7q%LUiWU=)#+E3CxKv9z|2<G6Vc2DV+jl6eZ%G*`$Ps0wGOiw_GU~ z3Hi8Xx_wWM5Sv+G9wX$rj|}wVgm!W)qf3B9sox5Vx-PU-;j>^3^gkI~tNQbD>`*%7-<=%@F WXDbSn@lUq@*>BSN#|f?^xxWCCpVF-W literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/login_url.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/login_url.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..df163a31f4bb22c6416811e324a6e20c882f2b08 GIT binary patch literal 2158 zcmbVN&2JPp6!+}RekPlc5EVp0wV;i(pzI#13N=Cq6j0IC^*t;1rGahVj z!qTWsC8ScR?XBWajulnKz5hge2x|DYVu)Ej3aq+i89w7@0=sSpPTdKz^(^RY=J>fF zU(Z`8gXR&-K13|X^G|Jrp23%ndV%GaQKj(0h!rayp%q?7< zyY|u2d~9D1yK&)qWX#lmVWoSD*^x)6WwG&xWA)-A zbl<9%meKHUWg;#tinbTtls>(kL8ydb+*tJ#7D>oh@o9EmXOIID?=1<5-Pssu{PKE!m8GhnyuAbA$e5~kgf{Zu5BbMRLwW3U0fk} zW0i-AFLN%2>|7CeVH>xk2=LH-6<_xKgH<8tOqnd0FgrAjYOe3OYY^)oO&T(A6t+AW zz&3~;AnD=_3bDgBI2`bqO%WYLhiMcktU6I7WU^fGfwKe!Ky_uEO9f4YKd7ERNbyj1 zP4HZcq_DFb@kuIObZwB8)P@|D|CPBX={p85lR$9h3h)a9r;XU~jba&!W zDD(z&57GR-jz?iXF=Yy&)%M2rmo|m)@5ED*-|KLt$%gbaC)9Nz!-_4(;G)QJLneU4 zC&=QUs|ks^3@YNeWDO2!D`{SfI48O8$S`)6M95upUCl6evH;%*Le}mTV7|8=!xN#0 zcF;V9?-_jQxVvv*nN4dmvuSTS%zEN%W`DH4OP(KiLhPlABS&Gwf1>;uRWflFnt{u> zK!_K5nvhC9o_r~0qPX88a;-5Z7&Llg zts|)xk^s039)<^=|U9-kd+OWR5#&FiRBSP3&Px(#sA|A8sXSdLls}E)Sq~x$i@vEO`P<%5=ab`Lu2)WLLV72iL&Lbg{_4z7y22Ly`1Zvp59vAcBa$$+?nnf z__hPo%;!$6=lDDMsXjWE9qS)K=W4yP)!zH(`{koWK=%KUqVbhD+$ZwnFuSEn(E!`( zzzqUmr45ES2YmyLmcnJOn9Lcq)1+{f4IU{vZy7G}WDwgcTu94vQBH$spj4j$>D!iN n_0Z|1NpSxH7He8# literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/mask_position.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/mask_position.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9441953bcd9a53667bd1a550d6038f34f3306af3 GIT binary patch literal 1548 zcmb7EzmFS56rR~%{t??3ju1fzXhlfj0=qv&QPAaNI1VRLE{a$zjmA4;d*k)4nb{@r z$%RjfM34Z{pcDj&0tKNoRMh+d6jxAKTb)FeZqZSoRJ_@>b3SoR#yg+CH*fa&&G+8; z=W4Z#VEp#|AH7d4g#J>-a+o>6N83OiA%+T1cVMk{gH<*3}d?myT z;N}XqR(K)j+!SS2eTaIPRUT9v>mj<29Y}lmU9TmTkEtBq45gq7-WzbiZEBAoj4cOY>@&Ly8-4Hsn?Qgbjs2)m&O+Y` zW8v}*dk{rqxzTL8q2P^ZAxI+>{bo0eWRs4)ODf{>_p)~rT}C1?$DtQQiP`f*8YPAM zL=LANx4DV6VmqIl}VhJ9_B1nvO7;snBM-2mJ5#||$ z@X>W3-{D8l3DMFID^FlPg_)1LFFZ_};;A;(rv}51jj8z){wC`%=oGzOHw1)4qN<># zU=83G1npwVc+5poB*Y86h>&_ASzpPSNbdItIqh|E7GfkNLR_CpNr)_ft%_*dv*$Oi zZ*=a2V%XUXnHTgs!&uNL6a+Nx@Zj^#j@Ru#<@tMK>JDk2%MSHI)tb#{GUl?WN&w0aE^Yd^1c<0yt@3&JO ztbD0Wj*V>P7>*zis#o$8t81OBR#7aIE@MhRkujx0R#WkcV(S3)qS7;~y)p!!Ds z001f+e^Sjbiz!l2LFU?Qd$zs5Jva8|#`>&1Ywx#H4Vl;U6Qy z=Th{lSxbv+B~b5Wprl^Q-hBb$!ZP1Bs07;dVz>vOjZl9;i3Qb%cF6_EE{f5mk_**Z z`BBd)mIYDAe_p(ji+feP3#QUV#sH~~F`lD$4o*IY=<>m7&mpo8PClu12}ADxhi|X` Mtycdz#g(P?AC3f$F8}}l literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/maybe_inaccessible_message.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/maybe_inaccessible_message.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1b3d5602a4beba955ab12ddd47159bf47de57cdd GIT binary patch literal 831 zcmaJHV%6u*lT8il3<6H|2(3mIzf5n=%eRnRiD5>jO8a=v>_Ol)7cyHv`882UdH zi5-O4`70P0QC23lpfGjfo$W-4sCc&Dhwr`L`?&Y1+wBmfuOGf$Tv0-PdSgwkT3Lmt zToXkU%}7oMl#&K{MpWa9r~v54fRHcvRWxX*<{9a=etEM;7YFB%!N`dGW%3%NleJqZ zFkwlndnm36kO5T$0q7u54Fm}m_fNz;f#X6*3D%}b1}7-R2*e=~XHNFICB!sMtef?>5h} zvDa!Z$qqAj*8!)v58a)6Fn;SQM8CzA>pp5X?MGF!kIey^e$VW4WXph3`hz_DzWXlk Uv?=EOm%V@c+yDJ@%Tbx^FRTOVl>h($ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/menu_button.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/menu_button.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6d1200f7c0b8308551ee7bac283ed27c1837f6c1 GIT binary patch literal 2161 zcmbtVO>7%Q6rR~#|He+zHlV14YDFRvORbH#REjD@o0ecfQ=|l?U0kN?opG|wdUu%_ zHx0@mNR=oOa6>)NLl3BcdPiKjb8w{|qCG|8)SFQ_pqzNK-K9A5JO4uJ6&EVZnfq8%^qBuZp>|m^TBQV;gW40~FYG<4b=uBz_ z*>=v!VZ=!4x^h#}K1qQiEC4ya2WWqL!1P8IZFFau%Yn zXkN=K$A_r}pTa|fj@(BrOo#6cJNf(QE_MowX#cx1niQ|Huyd&+CER`0K&WWLSX%Xk z9in6)4gEEBg>_%BRM-EFBbOYUtlF10AiZgjsplj6qL_s`=YcOIq)_GFK1hy+ zU@_`&kImYvQpRGoR`Vjxs)ZdyO!Z_^hD zUJY}hV)8OlAViPZ_Qm{qS0@U(W-h z=6lP1MvJBEyKo9siaMwg@EVh0#i`8kQAJdYX_ojY#f<@}6ctdR+h&9$MMByU?F5Q1 z5%O8b4f>WGAvE$pJwnK#HyU6(C=RaP)ik)I+=tO)K>+w;ei}?dW%OPCn%V_rpowC{ zZ$KdA!KY^wGx;7;WE^FNx9VHJ60&Aff+F3#nJ_`w-<5`!Ow4h7^*m4)g&a$yMzq zSttdl9SxFd6s`&^v6`-69R7PzQtCGxR4qJ61+^uG=~cz0&J}cf`3pKl@9=356{g}5 zke-P#-bQb9kIo%b>mEOM&~*3c+%ZRc2;&L>dw{8Cdf6$g@cVb#J@MwBsp+p{Hlz{! E17OEyf&c&j literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/menu_button_commands.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/menu_button_commands.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4e664939c141569a72dcd7b858688c06c2d0e102 GIT binary patch literal 1562 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/message.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/message.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..79bb2f16c234a52b828483dc93efedfb7a70a151 GIT binary patch literal 198575 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%0A0c=TfqZ>0UGi0Q#(tEqKSsclCQ45EKDvIKKwPxg zVE=D|_Y?4dhy66c2M9hyK;>HdCkZ6w57Q;NU874<`6<`+({xF`KjXTdab3^S^$~*S z2!58}qXZJ;=jb9XYJZ&Ic>=OYZKD46FA#i!;FAOthuWVac#+`K1X9w^(Dh3M92NF2 z6TC$5D+EF5|<3$aSS%SH^Yy30;3o&`%(3|EI3&D|G!C!B+_! zg0B$_5c~zfpA-Bg!T%xnD}q-E{+d8a^>w=bFTvju{0+h16Z{`H<50+~&ceivW63EoNY5yr9U zy5h#34p-x1TV}#z{B+U%e#v$HpzG?T>oS2iuH|A_$t7omOKIN4z%u59MRoiQe1uX0Go1m<++5ITXTBy`d^1~IjaG~-qP-~5}_3&-z^~C#_ zqO{Ug*X8xZnA>%s8UwNhzG>wuvJIuIGwlzs9XRssr(M?v-M0CV>l$<0MA$ZS#woud z>#WQ00*Ycw|9E{r{0RCPw!`?$y~S*Y1!{MEL&{KO+eo=4+aGmD!3cU>R_h^GnI)|0 z^bx0+Q|_F!hg=IJmo2u;XBo#YxHb5M>-q)P^^0_UlHf%GSqnZz*A)(mPt)~F1fL<0 zufOcNKI^)Eg{~`%@sjKMRoC@vbjfJ>b=UPd*Yz8&>+`PbH(l3t*EQz$U&{91{(aXn zMUEqBtvU9~Z2#XQc*S*zg|{#A^-Ba-*zaF*kcRcz%t~tO-^Zs zoMTe1NlIwZ&x#LU({=_agm)}w{icpM9j~-ribIxB(w=QU!_JX)z{94VrQb&go+J44 z8`q$gL2_D0E{YXgD+e1{fkYeUjZ@BEorf>OknJF)nWHEz*0*$w{L^~=(Ah2aL> zum3`qr1EXLKEkixq3a4=|4P@t5xhn)KKR5cq}l$-UHnANR7u+}BxN;TQhEmq0_GeIJMT23H)Arm}^{XO&sa7G8N%mAc6G zmzvB}97dUsUi;5xdtG72cy!^I$7VBIZq7L6S7e=~46_w4bp$wp*CJ!C{TkMO-ni#n zWIIS{st%Z6<7}lQ)5|VT$pXd^;8of~Byuub%5d$BA=B$|CLjanNxEdo6ZBJD9&4_F zF_s}Nnnd#3$aK8eBSqD`5?)}6g1+UHFb8?{YLc@F&R_>k_aU!d4YsgwUR?yOd6xD2 z2!Wu|KTDTvwL-2Bi6YNsF0}>gT&ONNWt_*@rRX&zA&OHwSh7L|^@@^{L<5tk9$lO{ zj1xw#l?CJF4|()KDQlT-W( zP0pMetz;Qy+T)$GbdxLwh4Q;LP}$nr302hA)`9BQ){d@NPdnYUt*!6uiMH!66|Jqf z*&5#Ut*vtMR#_u!ZBHdMPZxVcqKxA?vj{6Q@MF=PIx7YdlT>=rfiL5Qmfh-cXa=JvW zCL%TI_sR4V8JdXCrtx(;fym2d(Pc5c1#k^iLM;UczET(MC_kJbNDw?qP|tAZ>3T20 zj}iO?!TSlW5&Sg4vjoo(JWufR1iwS@y98;1KPLDJ!B+`hCHQNCzajWLg4YSYOAzAJ z3lo$PR1nk?Od*&-FpFR=!F+-U!D5091e*z32(}a4POyjIE`oaq?j_hqaDd8j+nctwswZP@&4xo|CrX{g%lqz2Tg%mx zv6j>Oo^oepQ`(xDwgCBLtR}~L)LGS>wq~U*Kt36(nSn2aou;*EYfjn%P3>}ZJ;eR{Cy_c^z$Nn5ki79gLDwMI%6mI5GfumBI1 zI_o#}9Y|Z7)RVC`Io4%o(Xzff)7CQeWY9=f!dbqG;Z~_9W36(moz8;AeRrp=#p=me ziydpbvv3L9YKeL>))L3sEtPEWSJJWWWP%6%39_6g!p_o_%x9%~GS*7RdIUk!7Rv5r z&aiieojD8o_N1)^>d9CO9BaSRyuRji`0{`7CF|vP>p6*E7X&*RyfvuXy(3q{jKa+N6=4<>mOlv zv5C=i{wCgAAdmG0{G{cON3b;x7AoRCMn^XOVz)V)TBJ1r`DCmXR`H&&v*y;cH7{)e z^2u1YI@Tc>%$Oej!TeBx!XI+xE@WRUR8PiQ=vZ6x{Fu?*;XH4)Wp4X2Xf#})i4Qxg z*Gc&S`DCnh40|kGXgc&17*5-rwHr9ZHmE1VwP9PKdhT)>SIbNWewzjM2s?W8K5x z-Qm2Bp!bnd>0zuu!5%&z#$1<{^CmmPr?@us?ek~K>AA9ri<`gS@62B-8UJLs@cinv zFz@^J2d90Lvm4`ae%b=$ldNeE+iYa$chQbCu41KtQKeUHt_`HlR?M9 zb0bz}RM%UdIra*A<}C#5`aNh-Os{w-v*Mxt6%R4&L+Z&`4`supWqV3sNn>f_GaH|u ze!VGu=xBP^vGkJTnI*^jmmFv4%lCk=+}lCmXP=(ia-SPJhSdLSzw2G5q3mfcyB z4duaViCj{)IU6#-jY$uccuCndepkTveH)I+-(7N`wsEjDe0NFpcS3}S7g_4G z?0RX%^`=bA!Ty$mY}u7f*(p=Yss}>=*&NUuLYFMWwOp__vl@%EvtiqdcfYhRvte)l zhP`aU-S=MK?9?ttE_);wK;(jcN4qhj^c_bsEl2xXj-pZVp>7JgFxz;fq^w~uM3~Ko z-Qn@fl=lm}C#Y!{RsLjaBfl-Qj1AARNiuh!1NN_jw5N^+DLP_h>YHb{Zxv#2d%(cO}f z2ea7HSWkfuj5#BJZPAg-?vw01m<`dbA(rmj?ksuf{_Brqb{y{CahPZVrtE^nL^^;h zV2JL#`+CJIwV9pAU{{TJ1-uR)=R_WE_^&=8xq2`gqFckeO2;+VoEoo-O5PsKhUnJt z-cn);!-5S12az~G%H-@W&i__#HHsIQ#*@jFY zr!YRWX0RYyQ($p}*Kj49dxzA|gV_+>8iI>F;v{p*dc%DH8w+|K+tk4$go>oWdUVU0 z!CAXY%XXEZioQR<cR41=-=^5Wqw zgPkQq)_={dgB43zH3PDADR77-9V}bK&jw`aQsABv^z?ltgQauJZXXO8kflq3J4#3y zE?PENW7)+S(I1 z58fP$pN{slr$pv9P!@;%ucSSh0m_wS9XVqWQz)_yx<_9psHR=!=lJqh=h#AEhm#`r6OEd(Oi-AdPWf))Z16mNrTU>drCwx8Q! zd$qg$B3ckugSPWajk2#S-u4d05;^Q`bct;CcDh7ByOS;v(C(t^w+Zeb5P9uxx=h_*MAb+128bXU}x^-rsDhNskI|&Kibo6-^-8HiO%kx zRO{(Pd)&T{9y64O7^r~AUR$!X_wgHSj5DzQhKtC$?EUmd=AJ*~{XHERi}r!MD00)G zeK5~o?me^*(I16nQZz}Y^HGt0pzuc(^DsWz>p4=7(j_AFV~kJ-qpmP~2m4DlZV$7M z^Xqd2_Y;V${sFo~5dR=t1CzA51a(X0Mf)Lo&NQA~xF<&4??F4T_QU)*E&pT6euQ7< z&2V?TE|oh|fDncT7yOhFVZ z&e8R0f=3BN(V-o#fofUe-r3WI3D!XmOIo9op+w!Fi!M=z=%(vsf_D;phQKBeMTR6@ zqRo(^E6kSap-Xff&eQc-f(ryM5j;j9st*_G`Z~cSf?k4oOkgp=B7oN`w<}eb+w7+? z;NTNV{tqnW+0v4d5+}4c9eiF5)%VFiCv-=8G|#J{IqBe&wXBjbr2nG;wV{$_>CjUD zR0di3Qvc&n zSRHsAYElFq$LK-03K5QxGP>eM$4Ky9QNBaTU*IW}vQ~R=^&cFgMB!>v6iQi3on7&B zp;-B0v=CH@LIDevXLs5PJdjPgVpipFjH-sO%vzkNgo=QU2-THnUBN;=TGX00GFQlJ z)4>O-HLiMtazIk+ilmjpF=`sFG~KcCYYK6D;3*Vqo012+5JFVftsI471-ckL?id{n zS6QP_dGh=HP}&MSj*-2(LfAs>qowe^(GuuB^k$*4p)~_sX?>wG=eK-dQecia)*b2K z12vtz@snS|{E?}(Fx&xCsF(BmJ-_7x6B+Z`5h=GjEM;Vlq+ToBS*#q6QRQ)UdJ3%@ z`MGOd1m7wFO@_czXl&%SPkx#6^IGZZJ1Iwg%GvU}cb1fZE*$z#deZVi_4zx)gpy7A FzX7lb2U`FD literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/message_auto_delete_timer_changed.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/message_auto_delete_timer_changed.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b637a96168049f7449ac8cda87171a09ddd3455e GIT binary patch literal 1472 zcmb7E&5IOA6tC*;>G^PGBBF_h2(2N3IXH7)7Ihhy)qG3@*94n^qNb~Mws-qutg2qK z%N{%kSwV9Pd&nh+UR(ZXz0N(LW(3Cu2Hh~Wsu*vDA&R%FGtZ^w@BfNV1-s>H7EVq~Eu z#42|YbGiEvFdxAxhhJsY>!?$Es>Ke@kI^Ja6;)xH$c~k_mTz8LB>gLk{jaVLmU4R` z*?fvi%l0yl_*l^R+tC^iR8ZoTbPA6TFM#|bILeWa8S=a~WaltzX#N`=W-b{hu!dYXxV z&v~m#P2^m!7o>uB)inHWD#pE0s$`E&!q29+Xvh-L0G4+#1D4xiqVm&IL!vE7X-c$h z-Xre~mypROqlpRwvVNP2u@t%|a#wJbi6nOhX~F|tB0cn1tB(O|YVkAPg=SDQJ*XbS zdIYN+Yp*oSVt5;ec-#67|76+=+Qc3RfI@#DXpM@@CS2q-Lc%0egmj$z#B0tG$)goQ zjJ;^Wp}bB=5K$=!kq*dEvpX+?%X7o;Q?WkmrwkH4T+akmsUVQgAx}1jUx%Zi3>7~= zp}{(|fE>~=)lJt^n-ea3@5-Ve)0B57o8koAw)Mq(v)Y|S@iExSi$Gr7K}8$2&OBJW zw{(B$N%PYJS*^Aq`<;ct24R2kJM%r#9C3#LfjVv(zJAXp2c}k{rNy?^*L3<48goMO z1|f0EvPknyLT+U=nrf!Y6a4yi7MyzoU<_hcFyiQ{e$Ys0<|jbqE@d%0zQP)^)Yky6%jha z#+w0z4?(YF(6|t^(0>}a3w4D?C?hkS?Tjcq;p*&^IIcMZqT_m5n=i9=L3kkQfMo`x qurbE_=-l3$^8kIm_qKU}yuCMP;eLX__y3b$2ha5G^S7vsTmJ#BBaQa} literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/message_entity.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/message_entity.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f0cef5085623f853b096f584bdda695636c6631d GIT binary patch literal 2475 zcma)7O=#Rk6dp;lzusLt@n3AmvEux7+r&#rC?$l@;5dov*h%b!Qq^IQSL3y8{cL8m zscrVKft04u_Eu784s8i(OQ5t+dhVge9@Y@35CjZ8<+i~&v_AEXWN*FHB^`~PzW1JH zM)ThHM&D$!X$0-(FMgZ*^+HVQ*5kZJEq0J zrWn|Y+X*dUC$%K#F(YoJ?6j7a5LH+l^n}%BXS9rjWONZ3$-Br%(ext)p~rAXP0JeT z8I*5(Ce*wXwCRrHdb(%24$mt=_WHY5$H?fVvC)a~sf&Sf&RGePSIWYzThC-MMh3<|U)^Zca-Zy+-$4thL=k%aWFX2<{8AlazD4M8_P@^j21X zOsmkYFPL0)!)>aJmKo*L@xbCxm6vJJ)GZYZ@V;s~s;+u;*;DOko)Pte%T&6o+hvO$ zR~K}?;OQlPT&+N?939>|uHKlw43c`qk#xA+j9XzvdRkrZyfQysC=^{rN4%|QkGQN< zm~%Z|(97nbtyQAc!@+^VJr-bZrA!0Gbi5$$&d+lSPm4MwZ((XPyPf*?;LV$XQeoC+ zu4xlFycuBec|p?Bol*s&5wsU8+;eRLoLDr8Y2-2MhP1I>A@&K;2O=0EE#V`iykh7O znIc(wUuPxG1R;Vrqh5tM0iJ>g76q$BOTgV0-O|R}06vrM1LwVMKUf~Y{TS}3EjB%d zT$QSFRjJ}?tQxN-4Cz6lntUjI8de?TRhh~sSO*Madxhu}Vwdm#P833nSIT1VgqV)$ z5t2^_dv|PvaB9sH@;_!{{jf}sBBW^PoD;&usUheTw%X>^^QULuaoN)BsB4%`X?Cf? zbkAi3k~>SC+q0L=xmj*{^h8-NELaNj{+Ei~G}6S^B6sPk}R zPg4~`B8Na5Ff9Vk0q=|AIN5G-0B}f28>;~Bx1`c*9$pAlrALs;$IWzB(PDEJLs|vS z?6d%GjurDpZ+svN0!FQMHb}ob#RR*6v?+M7q!3LaK+3VmDLVpYE*4f*b_gCp2KK}B zqDSVLYp?dV#&xIfoEUi)L=8P{SD$A3KR>mWQJ-YgFS{NNe0%Gwp&!owH1W&fUte20 zHCewly>@cCesKCpX6Csfccfn+5Dg@!((Euyk>49ps~vFkk$VIRDI21Yw_U;(7GIA* zVFiXZ5d{_^!M?EG*nmL$K|lb+CRsRlXcZ`*6=WA@5g|dE5Zg5>mcSW8ZdG(^%ab6) zaEoAWCuGO}1xjI;N@7^7qYCi~h#6doMk7$ zCX&Rz2hmU@N%GNfy|u5SLjAw{I=WEbt^4R$y|u3^9StN&13vDrxAsQ-O$h?`Z&B~c NKNsc~yZFNW{0;5DZb$$C literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/message_id.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/message_id.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..bd94dba80a77fc80ca9dfd8e54a2154412391946 GIT binary patch literal 1325 zcmbVLy=xRf6rb6zyW8AFiP1)dMM-gmcb!EDL5bmv#zZh8E(gPAXYQP2Z}&2@t40K) z2r8)9ND5ntioJh@MG6bqDqxlFBo<=jo87y7Kx}+F^V|34&Aff@_hvs-DmDW7^6qPE zOh@R4G6rJi3f{Q_$~vNm;sAB9i?PzRK7CF>3>2 zeukNgTcCv-s9M}sW)-JHUKmEP7xO5TRV}S7+`c|drY=uUU7eY0r255hbsOh9hZk7D z+QRG1FD@}Z_Vai-_QT_yNwA+mq71p1B3HW!3A;Mgm_hXk@RblVg-uJ(Q47=J)3R$l zNB6M{DGlCLJ1t#fQhIGRLm%9;9gu}PTsl$qSx2z0V3LKgbUY^s`AWi^PQKsa6xMl* zGf}g%gEyi?_-x#{6USXSUa$L+V70hkM=cWV`eGEzy4U4r`!P7p4yHN}C^T zWH&29x~tTKFZpEoo+sK;s5YgRU~wYC)R>Dx<}22esJC(tftu0t7Oz8p;(;Gr8!$h^ z%w=iULp6#YVvZkb@A2!b3^nRJ;*i-hoy$AnakbYx$0M6#eoNVZ>; z;ZRy4#1A|v36TcaK<(O}*-PWiTaj39PDPZ5?dEbKyf_jBm}#=`ZgZ9|HYJbQxvu9g zLsw+e; zd>O_^TfNUWa%&fN-~_5#c?s$_$?C}X78PX{em4hf3xQ?iI}vAo?#XWfAf?`%oxyv&`mz3Lv1Bz(oWCg!(U2 z3;G0&&8y6AsbJti z2jK#7#BqjlJi!<_=o#Y9IpVIspIwA5VKp>yc<&gE`oFC@!mGU#k%_rt`BD5%BqnLM z)gRm{oBJSKAb}>BBLKh?mpcIBu7!)G#R;p!mAbDEMqh+O-k&41mktjYyFVi^EsS*1nOO`MlI%@kD)cp&({qxIH zWkKf3RF$HQ>$P4;p8$6Ej1;;Ik(2P@JQZvX%Q literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/message_origin_channel.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/message_origin_channel.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a41e8f1c0e23e299e954b767fd364d1641efb8f9 GIT binary patch literal 2032 zcmbVN&2Jk;6rb50+w0Gy`2fO>_n=6$5;@4d5Ztk&aDdVHIP6B~!9wRknyqtdyFv(rOyU zWu2HAOHmcTDLrjwt(=;RaK_AA1+{q`su_pdb;19{Hg3NkB($GBz&%4$c< z)64@YUVQ30b6u^?R=LqO?6s{9JHW9;nb$nFW>^fiC=Shn0aD-4yp{-H&`1pM;Wq$2 z2Vxjfv5r*f10YD18M&Jfhme}qC6>|Ut1vT*bOJb);56V&f)&8o1m{#m&qKcu_gR*Y zpY*8b^x`8)AAf+>u|9Ucq~;!=&#($K4gM<=!NkxZ-~hJG%Kg^L7H#59={!oYF%%`;nX$Sw&ry?t4RD5tmn@QCl~3^zV-N&lyQkfpR`YOYJEt3Y2A1hn4KNAt7I4;{YQtUJ14x0{oou&&n>y?hy+JsBwHZ{W$nXid#xwSz`;+)eY>DA5_e-XCXKKm@*tAmrA zhbiuLP=EGNIE{*DzgqZW@yo@%!gPo-#gaccmB^V3{<+t}Jd8z#uz<#23X8{GF*!B} zbO;Vnr4$n~3YbUCio%NN6?GMJJRy)Enm;F$U@EEsJ|)m;P?drp-qtKeX^^ATa`dh# zaDmcKx|*3-GL-603$h?eB*-K+9fc5#P|$O9lPjv{ zU4Bl?8W|`NxZ4K>eEt0kC6ZD?Bvb*tI*0daOTGC%S&HQ;S@Oy2J{jvZdX3$NPu}!N zskhu)-d*;|J3bljt@c)TSABBXzj&!nCi(=lkf-DlOy18-glH;N3QOq9HN5x6jZi_g z%i+jm78w73Dl6PYK93cj862@u85K0Icf}nBuEZxHNJFhbaq@^WaS?f1DEMrlAjRyi z<;J|HTV2<4toR*L8ZJ#<5KE%#73Du7by|!?dkdnEl&f)i-{v*wiVV2FfC^=dv5#i@ z!?KUA^#4ot(S`o7_-ML6EIz9Ahh<+L4H3p?d~&)!EMfX(4CMV&efQSyV)Tz^n4$yz E1=f)g-T(jq literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/message_origin_chat.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/message_origin_chat.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5383c4283a368e2a991056173b4b35c52e414dc2 GIT binary patch literal 1972 zcmbVNO>7%Q6rQoi>wo8;LI`wAfyx!Ng$fc1RYmhdN+~W8^vd&D3HwTMkMN)e~5l%3YnHq)4$(K5E8DKMTk zn3c72S`Ki=P^`RN&^cTjDjdVNE7l1zNBd* zM)4}CmiDk)rD0Kb9M{)<({;Qm3(LzNf4Io!FD}l%|6XG$OkZ#|!t7TCkga;t0_cBPFs%`W(#66N3TH^sxds+s8nck%xXE>5IIaIO@g7 z8O8f4W9%+jrN-!;idMKwZc`1Y8T_w~hr`Fipf|rQsL+8S8wT_>c;2SEo(#d zgyXBOqppZG-C9-MRaIA8uu}D1KyB%EJ8{2Oh&^3(yRs!_)ivMmc(e6-%ax+$3rn=6 zZr5DduCKVhSJyk{$^M4PUg$D*aB#ezo$Es^V=ij*7cVT|2$>I97J;si8IToOMp%SE z4Iw!?Y8;dYnZ54$@1U@lYD3^6j30H5-l}iJ5!C zTIKv{%jGlRBg}K&vUJbm+{;2AYd}@E53ViDHa~LZdUM`2OsCyk?@HYV-XLd9;e6V> zY_2ptxIAY%dTSl-iPzLk7c*POoOtzqN_mpgI2X0fhMa*dHm9E;xi*OY1lYYxp#I(_ z(KIQ)@b%)COJ6PRlx8BLlq3xCC;%thUi&P)e`dS=(gZIEO2hSM%O}I;{21YZuKo$&JDK( zWanWGJOxmr@vh+r=SSWmn1I=nSS&FiVY#1!mar_yAeAqI$-~lkM;^ynBLju8dcT1J ze*XQ7QY@2;2&xh}bAIQwx$T7>n@i*|n+w?4fQ@fAwi}-{0`_*mrh2hFW>W#H2d|#) zvB@3-jq;eC4%qG8>|{iaWhzmHy!kHOdE-)~kowuEJdp=#|DVdEyV&QUlIq}Kjp`^e zyV}J&2@K(@9x6~vP<#nfcHQhi_k6G#7giYY$eKP@T+NB{r; literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/message_origin_hidden_user.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/message_origin_hidden_user.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1f53c68ef388dfcaa270ca61bc501ef506a79173 GIT binary patch literal 1780 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 vwgNz~a;9`%nJF(Z8M%3X1bD;A)+l literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/order_info.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/order_info.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..08a96239d11fea8ce3939aab39d1ef60a5e05ea0 GIT binary patch literal 1747 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/paid_media_photo.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/paid_media_photo.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c723aecf002b7bc637945b39d71198604915dc1d GIT binary patch literal 1690 zcmbtUOK%)S5bmDGzSj;;AR=+3B|M~w#BM-Hkt_>>Y|Azn$HGP^lZ{%F?Y2GkJeHnW zz?Kg_L?TFlxS$-!fddMlTsXm>;INT=SoO&gC*KyC1M-Qg9`D+gKpd#)uBqzks_y!# zW`3wvO9bebZ+~0eun74bl>ynAKo27j9uiJC4M<2`N>MffBQ#wzv|KB+T|3OVIaoKj z739N$TL9VSxu6)9+!7_ilsVAzK{>3r6-o>;OL*Zv;YCq;Y!dPWW=3w6mzIfBK0wu> zs_aEkoO-DrM~P#p>dNh<88$UHGxhHL;;b^?j<%Gw;3uidFZijDUT|P!j@2d4=kE#b zdn;RQaX_=x;&2sW7nj!KG+y?%MGH?G5a57B57&Wz2AK=uQchgs13H5+ha+6|rMX)xx9%z{1?6ZI0lqT?>#nkO0EfzRkhiL_p|9S< zSbK|mQR=tY<|m$9OC;i@a#Exn87XTqjzkOVfrQn{!7L--H$nJ@K7_?|V272*FrUE8 zXk%#M#tz*vIDKU7nBUW{bX!8}n2U~~FDA#p<0s-6%1%0MAyt7fKk`$?99xZ@x+P0Q zu*%qplROWes>oO?@REeF1QWnw>>j;8J<i0_p!6&- zr;PYSUMLt-CC0*-cLJ0vjD6Jcf@4dbF&?)7tRna*Tla}RLX9$Z>RW{!_#NroRP`9i zmIwkspUTT%O0bYOCFUnb2CRaHpMgQPCr{t7>_VR)tB`9q_MFMx>8>@Iji=UR&$`~T zE_L;IYF+AC=lAm$`ef98hxSLv>u>G7Hr>yci=dJJ&5Jr}7W)*JR|Y98IwOeRY6rR< z@RRs!Q#q(Uv`dBwc9X=WmwB|=BI<-m259M|KO}q-M3r=xumpZm62Zx!x`>iK5#c*3 zOlH-3Q(glVaZP>&);B4oJ#w{scI=Zky8kuy$qU`Hqjy#X>%MuePbht*XT97#JNmiH U6v6&y{`KuYwB^r#vFpVC29Kk;U;qFB literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/paid_media_preview.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/paid_media_preview.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..93aed1e0f8a92d00c3a6543c897d8f4a576acb5f GIT binary patch literal 1827 zcmbVM&u<$=6rQ!m_S&(X&^DmZHd!1*F$G%!4iGAoDlth#NFx%c*gA|ho{6)~{xGxa z1Xn@wp%O&`gg~eVdf-qMs@^&C2XJtt2(9K6iBoQdazHupX4iHSsD#Ax%=3G1-p8qUmK+%p6F!sE8rMaa`Z< zP1o^?SmahdSgMej`O3`OR~F|){Ib&$sRh$#+^~dtwITBi>mU|AoLe$X`VOO}vC?X= z10{;42ho~5q%VW=zJ|!BP#{CPLXjSO4+_=e4BzNwAfzX0jHPJ&5@eH`Rjv=Nt{bd?^fQwQn|J& zun+FyVXn{1b<^=zMPl2e{)R|yFtfhl3zar`$nOKphXGLjgjA=bIt@w`$YA$g*@QG& z)Np*WMmDz%UiY|UMkG1&o7@q2(REl&k}U8s!fQ4d7b+p9WBP;?Q{vRID-w@c z>x4Y6Ha-e_h%_NJ%kVrxycGD7QB7+fuFOtVuep4)I^$B)saH28OfDzDNtHQU)dh2{ z>Otqf)G%tBMxA+8!*nHcWr@01mXwi@Gtwii)M)XuaKg>8e*2cu)(kN&vzv)YY=7ljs9kDM@aq#nUWsF;mP&x0LtJ0h)+ z;LwsR^U#uTgk16`rS%l3VqOC47&aqBWC*cc+O(vdCFG-~Vf9v0giyBzD5v2Wk?M6| zc(52I!Q$bOjS<1#DPSMnI|S5Sb{(XSiB3AKx) z%Ayxv-@7>7p6%f2Xzb$Y0KXiZooH7&cp@6Rcp|`4!8xt{RtIa**u`3a-w4JF?fDKa zL}M2h0(^Bpb*76>C-U7qdiAoh_sV=Qc_DcA`QW)1y1C&r(DDCNT5cKcJ5YS0U+7{n zD`8)6!m9IZfM(c*q>}Acyy_hu@gA!UH6xhw7z> z(>M7=a3$E@H=w$4MNtA&=$st;=(Wy&jeYb?=i~@Zy0F?!PAX9KztvZ*-(~dA$1H`H F{u}3d*?<55 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/paid_media_video.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/paid_media_video.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fb5515cc43f42058676b7cc3d4b9fd5d1708c0f4 GIT binary patch literal 1643 zcmbtU&2Jk;6rb4-+v|@cq(B8tCG#PnMXKF$sT5gIltga8go=iuE=Hs6&cxYdKg{g9 zkSYfwRia3MxS$^BfdeX_iUSw^3Jylf!P-+KPPr`#2b2?UW^Koo+Ed@oynS!pyxI4D z@6G;PsT2{=A3yxL)zlFBTPS1FGXWp(fN&pCM6ri_Y+)>9#Z!FMQhm+ReBIJvO{JQb z^Yd07WS!=`f^S#`Moi^7(DPo=FIgpw6x2kta2HX784p#29>L7WD%0Y1WR{MEYT~41 z2SFIyu^R@FsV0@po7dLJ%GI@%ch@(XiTZZ1m*iV+%((3xDVa;+;&Ik*HtQ=KXo~jMlX&|bB ztYUP(CMI0kfk^a*A zWN8H1$CHl>sA@OXSJ&SEB++6}cnPvgbm?SbJ}b0&?M@HsmQ?i0(kt2OeN8y9)zA02yp{9CdAZ}#i=Ms#Jnv+PM!EO;F%bNIG!Cv zghV0%QGou*2dm5Nk3zoNUJ0oiblST;ZpR@f0BoBDx7#iERy%^uyU?|rUAx1gw(W)j z{+bQhaQdCIvmn;Su`Yozx(MvQK1!cQmGj@MebxNBc~D*&l-GZJ z^%n*&F)m*n37J}6KL#IU7P747K$dvO0?PbkRrsPXoDn-q0-wP486ioL5I>|nPsn9L zKJD4w$dV_7h7N#L03Wz9qBpWOm?vcFR>BT(cVuo!WrU=|JP**v`~@&YqL5eki(*%0 z%*w*>8!*WB^hp&>FQiDYGJ5^;f!XM<4zxx#{?Zyl?cz{d=(qZ4S8yI_7vym#_?~!-39QrdeG_s9v6SGBnPF3UdaFvt;9vg zCprsyev|=OJnaiE{<~APlGr>a*5p?NUMGb{R-QNcYoH1squ+t0D#mz-ULMSjLsT0) tc^smb2D4*0tAh1VT}Tne=ZD(TV0NUrb67z8c>dkZf28H#C)j05{{y3sq^ke` literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/passport_data.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/passport_data.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f6ae9d18a9dc74f0e908fdf22dada175bd2ef0d8 GIT binary patch literal 1657 zcmbVM&2Jk;6rb4-f3BNSrBx}VS^=%PLfD)`R23ywfL3XxBp?=}(Ryd%Y_cC_W=wIF zLl2b*5+Dws9^k+M6`@`b2mT5UuEfFGQ>31HGYSWk6K{6Ci6fB<&u`woH*e;7-tWDc zpBs%D0{Z>?KQ^zK2t89qL0~Jw2iqVYA&MvtQG{KLm9B+aq`P`#xJG2UCd}#72uo4f zEn~!VZh>uvm8j}gGhZpJMRm81k%m?fEk8uG!pe_zgr302$+c*84LP;v%5-pA_u@E_ zo(z&$IC|Px|L|^`EWOiSy7lhrN~*sd4^!iIAmnqLuRpWSLe}G6bf>$`dsE5_~1RTKL-dHaxq1&wgFJMI@Op# z^+oVi5j8+JbDf#IM(cZM6Vuv5%PsAp&#+rwL&evzQmgpeWlwtd_i8rKG7~-zx=h$b z8g{YDrm)NwTOK4~-wWiHEw`B6O{Co&X6isN-mGO|){+7D*@C?#WnV0`T7JS=Q%-?t zCcM{zeWK;{gID|0+*R~!@8J~%=SQc3^KojZrMwC$r*;1r(ew%_j;azOq(7t{fbEl= zdmirzu39NAaV7^mPL0(hX1=PKA`M0fMqPEi&BEZijIcoRPh zJJTv5eh3&5B2)sZNDmJ0EH89ENcc`?DWO5!>+B4;ClgKp)eeh4?c5H!9T7ApUuPCKpiS<*(XbtbDoh zr*(N`ZT$G!ueac%cxipAeB9cBE~xH>i#_sjDWG-tk#CzW~?B>G>n znnlRt%t(HzIOeL;P>^g6pmzZht{#Q71hs_X=XtB%;HrgFqwB#%tSI$7D_$Nlb5ZiE zbLrT3)D3V!)%(NMbDU!|ue9tK3b(_`VqTRS{2G`FQ1KgxiHH6a2t<}w?-#)_0tA}FMgRZ+ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f4eca19091e6d3a5a99ce0071582da1393c0da9c GIT binary patch literal 1677 zcmbVMF>ezw6t;6oTZOg=1QQanU_cp~AjSx>&=w&O^BeU#o(F04S@}EfZV%EG~; z!c6pamu_LU7`ldC&;~BXe~}jy?_eOp-)1KFR+cJ8ycM%_)P^(33 zqD)x$j$FWb^R%cq{qvn>k8-Y6!Ku>NBoKu7$IgD|U!LZ-a#6KZssm`UzO{*IHX4D_ zP`4t}Kkml+#O-0~@u9o1mN8RO1BN-OR(XFYs=1 zmwS%9=%Vb%GDas0_w#`t=qtE%cdvPaZsbu)e~?>;)6Y+G=WzNN&0VI*=zn*3;D&Rl_?AW literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_data_field.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_data_field.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b9c89c67f0f75c9975666400700535bb75ebe476 GIT binary patch literal 1999 zcmbVN&2Jk;6rZto{gv1W`DoLU&{bQ4%!hpeR7IsC$`=vAt&#v@F&b^WV|$zRu9;aU zq{_jODp91;8|r}`Q4#8$|DZPxM#^Eer$~rHZi~VJ<;0s=J2=ASzZhN`PD7dI6< z(Mak^z^a+BQ;oEq#wdnXkeR%X%oI&OjU)67o~Y>=GrfWGnPV}`<6y{e9M>~E%XN4@ z9%MH^yR$?VK3H1#aJ94&#OIy8Ah~9Flo|GMEP7??j=_1;W!{oa8`SZZ7<1X?UXvc< zC}3hxKt(LrYf1$0$wL5N!$B$1v5EB9$8cahPL;b|A`sFOW{f7y_)UmRBU1sa_TfYy zPWItcglUS6^=C8FPp~=i09CP>yPwn3571Xw&upOHcYZXO8MOOF!!wpGYMb|d&uGxr zX_HY7hv%B%Xcp%!s#%WaI#hG3npdZq32$gs@d}5r;c2@D*P6`Tu}o@eTYEC7#VIRj zn-ER~iI7OEfDjPEAP81)?HvHSb?V4?neR2O?HD#JSg9LMjq*Z9ZfV19u?n5j>Ymr+ zbH!rCWwhW?o7R}oD7dUv+;Tl$G@916W>-LP3IXNXV!txIOm;fk75(!;YzVOni}RcF zUjzv*mkr|FV}as3H{tj3uri6FtK*J4hflz{7sC^*rCD-F*OLil7Ez<2mDTmrA>hnc7FJcB1{ch5X# zY#;B(_T&4?zG~tp>VDz}{77CmxF+#ZUX{CLqwpSkNtiKV#=-oA^07eWttMqbiV(}O zJVNrRV61QJgj2gp$P06@2}l&A38~ni2_ZZMV^Ltx+NYJpx$>tj+b%D-rsdSi+bw2z zE+ZghnL0b=HEXNP;c~v!G%DLbEiW6EE95Q;A$YN;GwBLVq|!ucB1I}R_t<4v@!srz zYEkH&?h3^6kHGxZM&UHd&V0M{&C0`-!{O-=C9^sI;*39e$$$A(|ME3|>Pk2SbJ7tG zqw(uu_G~DEBZojIkPzi_5lLCV5!)jINy;UXyh|j=XA%kaWL>aHfi8f_4+$|u@evYa z2x+)x%NBT;kS|+?-Ss31G2IF%BM1)^QOr?Uju6uKlL!Igw@Q)}WVrwwzS@)G$U&*#t+p7nw zVGOBW%vZ+Sx7)W5Zu`pHzB1M>wMz#jU%BclqwTf!+QFKyTs%rngy@o*3v=k!C;0F^ zJxorff!_aT(jt>gcV^fty>pd-UEs9Zf;$MDGV!+(B%s)!IwPXQO=Jl%tx~7e;1RzU z23H~ze}oZhQv%6#1e2$!n~`p}*y}J96!S-5!Z^m*M^`)N`w=R1Ufhq+o1OFBM>jg> Ydzg3w!?FKuI@fRfA*TNv;FJ6P8+J<`ApigX literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_file.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_file.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ba22cb9cd84a3df4d281bf5ee15634286b5ca1e9 GIT binary patch literal 1885 zcmbVNO>7%Q6rR~#du=CnN*V}1jaXW#k`dSk1VT}%K#3D9EUQWah{e@tyF0PB*&j2r zZb+1aBUPeE&>QN39yp*P)C(shZrtHuq#Ud{MdFm(qHsVt@n+X<65(DL&pdxKZ}!d1 z_r2Nup;#;+C_jJu`{sHUp+9A3Trw%Z$0mRW$UzSFkdIA_C00DeS54K|OwG@j85mO? z&CB|_sRPb9Suf}3%{)d5T1Ae27dbhaf21Px7+PA)f|FlI<-(Edma&+!f*_2n$PEKt zRz-2+lN&X%^nPvWgL-pSsP6?kLT|VcWtMlOq>ns*!{WRfvZ&@!p9WElv5;--bm>^9&IzruY{~!y%k2hYIWT!-H|ll zl$%O+A{R>HoLn6#`ROEqq=J=|dZTtzWO=fpP_gC9U5 zM`J&XJc9NZT3T*D@i@vJ-c$C}JAko!kSxdIbF2Gal8EIz0{D{hm z$naj5GLa+14cv&3vMy%N?3r-tZ4xr+adr`6h&&;-2aFTKb?D1XF^vAn&E>_`$06Hl zErpI7v|C#}W^JwDL+$cVyU=g+8~cr+Hh-wk#pq(D6qnHTkMO}eW~|TTf#3gU@-k8q?ulVi z*yKP>U=(=V?7?jU9+`Z}i!9_2Bwb35ylxD>F-T-+(DQl9>2s44jLFYZ%GA6>$vTp~ zliambtLv-`T}dmy4<=SI#zS;@aK0X*%HZks5WO}yUx(=J!TB0zuV6U#f6d_KH~x~t Ke^2lw`~4RW!u@vu literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_files.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_files.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b0712e9c0b54f45cae5092ee419a32c1bf6d9f5c GIT binary patch literal 1941 zcmbVNO>7%Q6rNe{`ZrEOk~U3f=&B$^R*QY907X>+rA`P~p&~{VTeqX_?%3XDf6UCf zAyE#lREZ)1Cr}Uch>B3}oH%pp!4)~I_7sUzZi~VJ<;0s^J0!vgiSf+yH#2YE%zWP) z`-fsNkD&bY-Sg%zX@q_goncWDfDi8gc#KSBVjDSF!&qR+mYkH9a%4?*6iso`S{lYv zrfg@Ntd<3=m}xubh(H2*Y(&@*UB(F$g61C{azqFcgYL3drx*L}-# zc}Wh7^-pe8$?|*E-s!bj0`c=j} zR^RT>1DrU_jB+rth1T8hf|29zMArA>)u%+yuz%pp?- ztPF4(aOT8#Ho-K@rcOpMb5F22@d!1sIsR~5%RNG$VJ*LbhTo;haBkFzS1g5=Uu99S$u!tkay~x9hSy~VT~gb=-{DJ@is3O@_Nh%< zOn1s2YgO)gKCkE<>($OcBA65s#RrP_i31%i4kW!b>fS=i^2%DRx^X*9^LWoN#eEja zKFl2DL{i*>{_U_JLXx)5+mweHhjOmBXbH0k&?>w{Mg@;aC8V=$>aK4YWOGYrEzX48 zVVY6D%iK_2_grd-WD-T>N)}oHA$)ipz_<7@q`5zwhmohyoz2g~E+QqxlZfaLH z@e_Gh`5u2AKPh+ysr8Z^pOd`=tJt(KGhlv1B`H*Rw?kQ&B?JWV2`Od5sS{@=oZ3x7 zMlEM&AV!!Y#IQjDLU;!HB7s!3cXa3aQsbt_HXF;H2|716yG-{zMnJU&b?-N7*4+k& zxAuBRH#UJu-q0;iXj>7)^U6?EGEkMovXWTWa%Y>p414Wd{8!e?!|N=7AAcXrpFI@K zqvFC>)h|}RT-_TxAE9({JeXYw&ddep7lU&bq8tpwqfs7BzZMmayTUV>5a2Wvtl&eJ5}CI~t4lLj6lb7E4$;y@6C+BV3ESxkY*lXuuF!mBtmA}aqG3~=-J zCz50(8zEuF(3>CPy*KK;mA+h0>I=CZ$cuqo?5*|I9;`(YQg)<3p6|!?g*+d~mjijS zSL@Xt)B<^SKQj}dS!FyLM{nQ6d)FFKW;zFC{y&owk>YU2hFut5XT3BgxNLUeVF8y+ z{2PR6NGHg@gdg$p82lk2CQ>z2sM~dTLhjko3CG|i4j7vgDBeu4c$B@Gh<1%#g07&K ye*-2;VT=QGv46VmqbvRYs{812|8xz|Tm92DN-tty;Gd?iUin=N|1n}NKJ{O^aS$y4 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_front_side.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_front_side.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2e2b9ee336c724918868f2f6798d8d554d86967b GIT binary patch literal 1948 zcmbVN&2Jk;6rb5$e^K@8mX-kw2D01B)>$2*SvU+%VvV zDhgX4T`!a6cgxG~RjO-3eJ9uxnRPd!%<_(vM|KAXB*k2R2oz-5L;qkePNAnsL-6h|D2J1Dv{m(-&|i z!8FTeE@p7D53w_G57n_#xI1Cy?xD}Hncqai|Hh=4AGPCE76#F#>(D!YDlW%_!Fx=G5(`6*MR>=Hq>BhHYlkMZFnCExuSP*&(CFhiwl)UOlT3f zMXnCVAWe%mMaHL`TMcSpHUaX95*d~BjAuexdyW-Eu1$7!E!N;nR)I(}8nsyF5n{rG;t zy-=%$7Vni!!CP!vni()ZAVU!;-fmGQvV^#S8xdk;#LR^~6HdK4A){Vr&p-~5BgFPV z0YZ2N#n`>EY>~@*-mXabljj(+i5c^3K;>_YBacATX%2PI9$QkTb8{8Z1S4r zhEm&-6z{O?3yv?r4sPUo6NypD%fSdEbzM`eFeI(5|TH3;gZ*F&1 zyV`crpJ>}XZK0W0$OW;)eQ^`P3*-tTEso%PQ8!Fo@dJIc)V(UsIh ze+Eq(hf{C#$EI^Y^8YhAnJCV7W|&krK2H^B1v2YxxLrUdlivuDhMIyROt_KPkHIGj zi4+amK2L~!c67lp`Bh7Znv*DAN0N7%T}lLdiy1JKtn&L{`YOh_hhFMl?nkKDeR@Aa h3*F1Thpu%m_kQ|S49EVr>ArI9PdWY92w%M4e*lMy79Rir literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_reverse_side.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_reverse_side.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0f4c939c0410c5ffd764a0665629e1c52cb4a915 GIT binary patch literal 1959 zcmbVN&2J+$6t^>z&nEq%OF?X51OhP`G~lG2ax-4m$YPX08^})ILUx8`?<)vBfEE`cXJ_k3&z;Dwj>U}W`$1@iPT+H0 z5rwS}u9eB!+vT-)D%B04yy@?Y^rjP1X1XVdc*zsjOwKz23(GF`s2`RY3)t3vho0cr zVQHF!B{v)wH3s;!2jEk0E^H`Ny)hyJAtPlcXxdh;fM*ujD&XVB zhbwc<^fia`F4gv&u&sq{sFN14G-L1 z0DEofM^T!NJBs=Dcyf<%M9pfOev9&AE;?5|=rW70YV9!W@YPbu3K%Vh)TJ$Edc}aX zO4~umOJ>J;t~1gOCgsthLydNlhl;|T6-SDHIE@ymbg@>xUar;4q+VGsenGGVvXxL@G zP^*DYEtzYw$W+Qen?VSlt^@cI--Y}S$MZ09AKC+Gak=qm#!ejIgT#SypxXGJdXW4E z--+HCybqJq9sE zmJrJY9SGrR=*!H~wB8wAUv0b}u${(QU^{-RvD0N{7%&3bHK@Pa*mSlV9G>FK9n;zY zK6%4*0;zCGGR{k5X~{@i5{XMj>Jlk$v9r&fge`Br_#YA!$9G!+Z(auTXAcdZMun9x z%Aaj~zHyYlJVc4Y>|lB2>-8ThKkp3{=*2@d>%0?&t#}Sf5 zvj|DLBJtUhM3=zmGm?1U^e7=BM~D~LUC1;d@`QZcHQmunnhSFd3OmUeuZ?MbKD?c__Iq@SHVCVdAm{60MA(AGKu3pDS zuW$F>>Z{vveW-2^)Z#!b^eVl|VP&B5fx6hM_Ns@~f%@)1o$qb-HV-!k>hf`VX^1W* zXNQYuK|h**bvUz-1&;rp$;v=cv`26HXiv54D j$LOX0#X3N*^)J?8>Uj*;{-^1`u==|k{$t8qbl$%JfL9yH literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_selfie.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_selfie.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3226ac8e6be4289e327a8faba96162ecdb0e4779 GIT binary patch literal 1904 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_unspecified.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/passport_element_error_unspecified.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b01c7a47ce7b0b05309ce7fbcb479b2970c0af03 GIT binary patch literal 1922 zcmbVN&u`pB6rNdofA1z~nvg~`)Z&-0M0SP50Yw3Ul5JQBQA83U%%X|wnIvw!wwduZ zq{?9{Ria4H8|r}`Q4#7LapNE0u$6MKe2T;=H=}SsIq}BcO}AnZ5|f#iZ{|I}nfbow z^^etR2|@e$``>m%4x!)WWYDrHz-I=42Z$ny9n{7K#u8_oOj|LOwrZ&DtdWH^g{n@j zoj3A;voz-v+C`&?Q3kCbn!k%^ffXMq2t9_8Hlsv~8%Qsm%BhZ{vgx{BUf%iggWz5Q!RgZ44=ITLVY zp_#5`3(;Yk?MmEv8msw^X|bBNxyLjnsewSv0(x!AIHMY5@SIx!4)&OkKo+K7MTryxkk(UhV zTk{Y3EbMsuwf|6{Hn`dxM2io={MAMA3#dBxZR6{eZ&r>gS7Vf`j)gOG;q+`cr-xUr z#YI?1R^t-7{Bm5rn99i1A<-FRLwY5prwTZwcwC}{=LAWzd4eQmNdfRFiKfBmWl6qk zwizK&iIBEOJC4K^LcZvjPT!L!gnAYzA?qV54^?eih~tC|{iH#htfhpYsM?pvVvYj> zWBxq2gshx*`BfQJ8JMDU`~n6Tdiob<)NCO}(p1pfTljc!yL-K-Zm0c;x*e+Xp<3-W zyUjbzQ2i)Wr+Z0%qE3hEE1^2kUG1*kSq;^hll)YSX0v1QB)X&@PrMnIr;9-6|1(9I zD9LtVxYRhg&l>OwZ0>a6H3K%e{1QYtC@!eRlpFaTa`+ITD9hYVTcpfBH@fn;{C1^8 z%}A8&Bgs22ET)RR!*!TSR>gfVv4SxU(Tlxj`w6P`{=J`|*L%Z!8Dq2CryoX4InvXPu9>Xe!Qzh0qYE_>IwWZ`!ZWP7b<$fHcEj4d!e7d%b7vEc6 z{NVlWO0K;V4W20F&gKRU=oWLs8=E(&$KkBCW=vU-BFy%I-2~prt|um zo2E(3_%%PEyMNSd7#rJuYRB@XHlqonDUEn)yLKP;*jW<9E}_Kcu{}x4o1w z>)kk_p6CHFbXX$X6hg}35`b@&htO?&;s?tkSdU?ql_Pdm=eK#aVK zu@?Y?7^fA`MRVBp@ac`Eh2AGI+vzRF#E-UmI~j9%%rLOtqtWNRRe!UW`kY=)TyMwS zqG`|dW6}N{K1gWVnG^*Jp4-WQ%|YFAk)qp zV~#x<1W+M`y$G&Ul>TitFLsHqofK8!_yGh^@!wOZx?vSah&nRP3|EJ%cUMRH`beMK zm-9D$u27NjnL5&EhTUQJZg-@gJMJCn?Ssnm1)4LOg*96Rrv8tpievKZkzg-PuH0?a z1U>x>-UpzEi4RSskT8Bx&j)VflVeU-fq zs^BTT52DZ%MH!)2_D{|O^xFPu^8nfVC+7&A+dnxA^O6FoJuAMs`j@c&eTqw7^k2gU By%Ycd literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/photo_size.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/photo_size.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b096e8642fcdab72a2b85891bf14693fa8a2a44d GIT binary patch literal 1761 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/poll_answer.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/poll_answer.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6276b6661565a011569da396ab596900879281c1 GIT binary patch literal 1793 zcmbVN&2QX96rZtYzntA|K3dv*&=^Wo8Pweqm#9KiNfanyTdAoK?nZ-SPZBr&SZ2H} zsd8APN(2cI7t{kiq9Rmr<;0)BVJr1u`4ov$Z${yOa^j7h-6U!yB*t%^-^a|`dB69@ z`*W?PAsD~?_{T=8h|r%>8H_?M;DZ2!N60}A_K=TFjHRr2im#fgPfX$$%z|Gui(pqB z;+6ceS;mN|yb5~3tN5C!Wxk>};#bWoMhaR+PU#_X%B=iEMd&Hae3&(-atj&S3#l47 z8L@&OjI78F17VP)w)*MKCA#pz(!xg{ww4q1TCkIl6<0(_`9?=Bvb+~K-&tQ}9^2%W ze`EbFvm=N_7PhSHeOoYY=f9V8lE3f)2jMG7mLU^6$W(4a(x&Ptj5z95@KumQKrS4~ zMYG_PKravVqEi7~%XL=bb*Bi=$YaGB+d~`J8GTqc%X{bxY(koYw=te*H$%_67KrZ(8KKPI%gfu1PdaeTLF+pN%gnYBP9!8>Rb=*sGR~|jvnW!S-Nl99%>l{`j(0AM* zT1&JrLmRB3byy!je@6lg&U<0RIJH4J;gg`RB}5+BQ1}FZ$Mn8cW3pTL34fP$HFTcZG6+8d8~B)H!*l+E3?(UuZin%tOsN~V5v4{c89#Am zDwwxH>8rN$*C1L_q15&)At)6k&}Er*y?6NW;(Ys)kZ-paLdOj@+uL1kMIon9mo^LT zwO8Erws0eMrDNIK)+Q5e%ME2~H=~^n6V0qZdEFYF9X(nZrx}4Nbh2jto_~GIvPn0HPtInx|X` zIfrdjN*Q+JQj&${XC;#`WJTrYrE~$9p-Dgk%V(4(8l`^dbUi6oDgC@_c}JcSrA}yr z`3$8eJ_-Q$utr?AM3#P1J3`uK(7V*Y{35u7Y=HOqtXx$au&Q+Y4h%p!eo}=L$|;hp ziV9=BmEOviD>2byGTG1Q8JUa;jo+B-UGI~*oSu=nn5@Oqv%SSWna$}LnT^S3`=zrf zI$x-#1eCcvpo2USa|BqE1(vE9;~2f! wKTZ4S-Tr^kKGOTAXpk%FgVGSxp#FI&>$WekwK%)Y<)m$d%<3RjlSzwAQK)c^nh literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/poll_option.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/poll_option.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..26d011cf9d1459a4fa762956b96d63c96b666e6a GIT binary patch literal 1679 zcmbVMOKTiQ5boZ2>_gg>tOtpSWQI84EWx{nBnX5EP86YtShBzh!Q(ZZ*_oC+);u=d zy|&lrpnxF?Bq5jJgMCaKjPLmsIjkXvWljR0e4C&gj83VV(Mnbl2&AXGrmCyErt7P( z=a*`=LZJQn@VCvM4MLuyF>GLCqX%t}4~R!R8jz6Ml%ie;3ZZ6ep>FG;VH=@on=r3= zdQc2Yc8L!v6VJR)ydp0>)(CkDBX9PISGr2-N z)m1K~v&EMp<*S~Xe=wJN{-Ot8fbunD$caroVi!JxOl{38aNW}uz*i=o4!Uuqo3;Tt z=w2zexhbli>6IT*Z)}fjQm=NuW*7I!U1~#C!*_i=sjSCAke~S8Ud4j8anqMpoE_D2 z<48GvBrQMMj76AbZ#nI_tE@QUmJ`W4Tv&0IFs!j0s{`R0l`PQJxGP*fZ{1X?Bj=k< zHx|61j<9INVyoGXm25g4|2*!>qhvc1O)8P-ir-a<=0_?Sxg9Gmm>YK^wRSi=MEE)a ze*F}fH*O?V+{ZX#>vLJBVglewX4pxljCFdR0}EWXea8`7QXs7oQ*hN4QKGLwaxPX6 z8#1B@V+2|E5hy>>2f!OO^ux?!7*Ap3?bfl!E9}sn!j9(AN7|156a7A8DX>agt81bL z%f&bfJm3>jFC>QScDP7NjQNqT7^|Df#4Cqok_VfN{cWe1gzZV0F*k6eWK5c1Ve0Cx!P2{4wp?V z49hFi==8){h_o&9daaYsFxAF$O$=P zNrka6_PPP;ql|sob%G;LkufiJVS0?QS1vYSn?=W4m?fK3k6?8<0KtGvZ-7f;g)fO2 zTs1lrzz-syfB*vMU3 zrq87XVyqYTi&H6?HfrevS-3>gkuzn$=>Lf_hRI?b3xQS35?HH`B3PSU;6H#Rkn@QN z6adbM3=F&=0*NK?E+l%}kzABft%do|EWdF*f&cCtmDf`o;d~o|@+=0Ps)o!?{0j_RoKDWrzO@ D3v9UG literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/pre_checkout_query.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/pre_checkout_query.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c5a47042c998900f55d5bffdba8f3eee0177eab7 GIT binary patch literal 4106 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 a2Xk*^S=RyLmzSUZ;-6~dUtcq>#QrZSC7jFv literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/proximity_alert_triggered.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/proximity_alert_triggered.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8ade302f715e4aadf7a87063dbbc21ec5ed792f4 GIT binary patch literal 1657 zcmb7E&2Jk;6rb5$uh)+4eu3Hom9~5cRs#Eo6jg{4qEJChrKC_6OQXr|*xqJ8%*;5c zs~lXZ5=DHSP?6w>3aEF)AHg994%YS(332Fct8hR)@n+X{5@-*MXP)1iH}B1RzxQT; ztkm=8L{b?fv2e7szW&kW zWwP|n^3uDP+AFDkF&;g@#mUAx3t5lT=>3gr%#&biToH_Wh2Mfsufh8tfcz;Wz>tf5 z-|93Ngkxl*?=>_VkvCdXSSEb5(GQx+SG>Nw*rsZ z5fg&;*sHJss_j0D*%sq)Ul1sW*@ASX|tM# zvz83G#}@6rlmoHYYIzA~O*zG~nebj~Baxy-2f+(-r@7DRZOqTza0_5dEy?K?*z&Zz zO{E7{rFsy{)bax%Y3#AoAx}Vukip2Ou?#%2xlMUbaMf(7$(bDTI5pZy%sf?VHB=$X zuoe))`)>jB4ZZ_iC1-lrxeMzatYTc7YkX}7?`S)^kH6P1{{n;1Kbe zA`KuvBj~x37!Dv0i;y4=Bq5HOo;(yR5iINy@-It%49wFCAzny@AVioTtLoe1M<2hv z*!eKwo1LY^58_^DbI7SoI02kHEZ*w87i@GyAlYjJ>TN>hMTZ87>g<*r4VY-n%Rurv zka;1RgAsok?zv$<0psQ@hjVaBECKm@jIuMRe(uZV&sM%z`MvgBhO~NPa`yaBum5^A z(}6EGF1ZInzH>nK!3}b%1pulG3jA_TfynEMC_M6t^5cp-0mQKss4DQzpbuJlH-)$f2(RKn`Cglqa0lr$Bow4531pp9YmsHGh+zQK!@=EhnnL z;&UL7`N1#KjFOchMQW&YYTO>TZ?-4K%M;_ocy+vbb9G{zKg7SXSAHr(CrgdYYE%HB z|3fOuEVrE#es&gJ+o>ufxA>v6rb6T`##%oEQ9g^E1+2^+@%NX+R9R@bcalVT=8c2Ho23MhS@i7-@G^T_PyVG zJHOQH6$In=@Bi#xG7);D7Wsg+8u<7I@Oy|NiUSm42V*5`ffnkH9vY4jnvMxNof<(Q zEILJun9dhrZ3d;V?37bmA*h5^r<%&epcdAhIz}2=L$q`o(K0LE*AaREGaJqvt!yB> z`dBS(oK)Q?ilr<4I1;v=)Hgp_UnQ+~S6f%#Yp*5x+tEQ{Zbe{yjI#rCn=D{G?uH+3 z?=nwEby*vg0+Ae))YOkSbYJE)6k<#x>}+(BPpr?`Rgw_Qu>`FC6KAd)wK ztXMFvvp#2nMN(L<#V3haE~SiGG6r49gm8Pza)UVPS^K`+vE&Z3qCvRLxD|IT>BAPw zm)5=uKGeZRC3U?K54guxtQ{%)Vx`&iV$K?Jf?gx$z2y13eEmaS_l7(wLtCtx!d~!q2K*^_(d|+yw^7 zJ$=TSVV1^7u^KYlcxYS$dT3l5883~DrC~}Bjir%s@u;{oM)T%JcwDNMfusM$%c+OV z&lKn9@;KY}yuzeAfc6DUxVlr40+bW#pCzu^gR3r1jBQsiUQ*(jC#6=ECtiA$5vJ}k zURE1U&u+*p>Y`5;XDxmB`#Ag{6YQ3ilt!oUJSknys`VDPVX1%?e*hcn7~>IoWjISm z=)&;%bcC$oEFI|!W2ECZMn-EmOC#gW;Vg}eOT$?j7tUf;m}m3v+JC2(f1YDcll%|X Cyz-#{ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/reaction_type.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/reaction_type.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..71464279b1d93a87661fcd71490d6051c88e5e1e GIT binary patch literal 871 zcmb7CKabNe6n{=zD5ZA;AK+w(sS=m$6}qJ$2GAYiDj`*oT*vmcz9w<79i(mye1O|- zU)Z{dwV@_^!eS_vo8qXhgTZv)WRlo z!X@jaAt-P@~FmbHIX1zEjh4XP9pLI#s1+Vu56>Lbzgte1wg^%Bzz{ z!}z7ri+H5C%xCeU)YK|X+)1&>U&qg65*um7VL{n~&V-5Ukw?|Yqo$B*XTSt1|seT{LQ^(dV dgwS`u-*(^itvkpa_dmNh`sJ;^uW?m}{Q=Gl`HTPn literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/reaction_type_custom_emoji.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/reaction_type_custom_emoji.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1733a5bb002c169d5bb6c9fac5c29910478f8ce0 GIT binary patch literal 1660 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/reply_keyboard_markup.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/reply_keyboard_markup.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..adf898cd7c60e5d09e3cc445e4e097c142292d56 GIT binary patch literal 2332 zcmbVN&5smC6tAAH`P`ZPU_o?2EZJ3efSm!AgM^@hn}q-a5tKO0rs(Oe*=@F`yQ!)H zhKyzpL@`lshJ$-F7{lGa!ozIhq0^^LJaHSd9?YJ6)xAAH1WBl=e)B%6URV9zud073 zl?n*jZ$JIsnkymnr!tb3jumaQ3CewBAxm>mTdQlD(o;^Vt=IK7uH$yPo^EIA8Sv{C zcCzhUJ*Oe2^9W)oojp@q2=$NMZivs>LWa2uz8YjWkFm&_uzOUz|p z3fms2CbpRn#u5`mZJfYbnrzu{TEuGs2ni|3$&RpH7)cD%^g6Dr6e9F4c^z)DW8?+U z7`{CnVUR%6j;au)*qTzjyc&t5NHOCU7sFgKp|&-e5cg`+^PI)7WDDvuE?_b&JRAe$ z?K_Mn6T%74WmMYj$F8l?FolqOG2Csten--l%^ZvRj$yK8&#@Q}^8$(sg}KSfX+91t z<`YWnP-3SNyFi3*(Pt2gQom~%uCz_Ma?9XLf~zYb%y0(Wa6?>!RhjDKsisbmx=Th7 z(l$?n@}qVi&b&##D)L~flcn0~ z)|F3=HLiGkrE$u$Yln0vEv&Tck@E!muJm@A5h4a4@-JyexlpNVQj zn_*RHOq`0}<$K{ZclJJ`1eIhr(=b9@1o6)*8tg-**T0|tcHz5)KZ<(?C|4Q{UVAgx zcQ7E;VE=o;?1#bB^q>UpC^i^HlQV;{p{d5l0i|t1PE;O`ae+_3Hp*j4i@IqD&p|Sr%;Qy!FMa|RS@Nps)TC*WocNTv<=sTqx2%BH#&y19m!H^c_z5WD1GAA zhdMovsvN6VD8RzfcAZS-I8bkm?*p$;wEBp@p+*%G0i;AihX|ne_%}%5bZ&r@D57+^ zk7uE;# z2XjaIcuyaLRDB&E3Gj`8%&ea2rCbS0|fiRSY)`!MHjT z;aGAv(Ps2Tf{{o3GgdzX{ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/reply_keyboard_remove.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/reply_keyboard_remove.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..318cd4dd13c5c0f3c91d0723b3b331cbfbc70cce GIT binary patch literal 2031 zcmbVN&2JPp6!*-|>_^CM3Y30OkgOJ3wj#Sy4^oEKG3#jf+$ugka52@i8}fM`@&!qwOWj-C*M6~6 zA)Vr7ZF-=53!!l2Sqyph6$r^IG23%kiMz}>0rnbz_R0X-WtC#gE3(0C=CbO2n>FsD zp2g~S8ea7-x@~#2IW&4VC$jyQc@p-|^L|%Q$u9FqEOYv?jnEi|b|n!pmfYvTau6?I ziX*NRUEp{n(2H0v1`3ND{c${s2K!;aW36CG7{a&4A*|%sPo)F{ypA0IV_qx_z*8 zg>K>L81vgc&+~)998tz`Pe?3cKB+>?@H?oPs zxE8h2;8VX@$xKCC!n~ z%986;#+fqoYum!?RcqB|)_r@m z^o#Xlet*FEFU`u=VCf^&v@;hH!DUt@B!~k|NYl;sy#S9uR6Rm=0+M^-%dAF7UIv6H zgWR04wXLh4Pj#*exzsr=7#y?CQYxtyk^tKs9xrz;1l^8;+hj7K{t}!%)fv`MJFlVk zOEpw5-b(uNP1xe=L$BbmHA4LstWeV+{$4|aH&FfX4`;rc`F`f<_@M!^>x~WE{_WF2 z3AAE(_S()MpV<+c-~?{SBH(e*^EAqa(M;%hrsO`O?FZ2uGt|X2;)G;lghYa+q0z?) z`6{L1&{83U34h3AHbKY>7cb13N|ENW%tOuULw0>0hL90Uz6~a2vU*Y;G^?N#3IYEd zNIe7raqs*Fw&PX@$cS17ETPhO7*Q0F_fvVG2u{ z!j~0ebGj5RrJ5P%;U6$s?#@uMRXtHq|Cu}rL&KH&2E?FbS=I)6cYSw%hCW&Uul@{u bu)ezw%7-n8=-*=fVEa!q{nsmOImUkg73M{& literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/reply_parameters.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/reply_parameters.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..40ea5e2f810ace5d8e9fb39f6660ddfd4ced0a5a GIT binary patch literal 2474 zcmbVOO>Epm6dwQXUv`tGp+BT;wlr0=lvm{&k|_Ae)s$0PkBQAK%v#NgpoD`Fn0(eOtMK;G9(Fk*_Nw{p;T2vt!jo= z)eXIxGE$&Zm};l186yL{#&kPd%^5j~a7E}Kr|gbu-pETtCR2o^ZxNQ^xqAvB_u);N zQDE6QQp!C>u_T2#({Wti^exx%N?Mq|^znsBI`Q7*#Pr#jsZe>xSqatimgk4**%}&| zcBox;fO#w@3#88QMYC@EkEKK|T;eug5@vO_e2rIpaFKtXd!D((CmrANS1RbZ)lvx~ zZTtz$=MV@^42cm#z6=2|6ee?(DPy3^5T+U$(?He}SteX(se9n{K6;Lukz#4ENVR9A zApk1NZkv(YH6z11z#`wCk!1ytJKJ)Ob%DGmk$H#cXX^7jZ;kF+ovHA2-__ZH+hkE< z`)?JD{B827WEAE|>$h|;?7YZp_R0klg2sI=yqmYPMQCTZR}og3dqsizVy$gZTy#az zzsif%B(lJpe$n!ZWo|i3MUOlFa5i3J&aI0IKUKWy`!(;>$VkN%eAwU0(6B3(M#`@5 zjhHp-SnTAPk9c~hSdJfNx7<*R&1@cQ;owRPgDYS#SoD0cun?vyunjN@drjMRZ&26= zgZy&h{7tkhpknBhDGLl0` zjsOXd(p~waw6?-bSiM4*Z{o1RChhgA{r9kk`KQ9sEa{%Z1zsV}DsS|VJz+ov3vlMSc-A2BH((858-qNHfWo`wAJ1N~(;vr)( zcrge6ieRCl7GoIZx6)SOwhb7N#0ePn5OJpkhEa63NCzqm&_Gb1J&~+x>4+fdAX?Ar z?CR`ivw_+ON<*ttO?4>gYwA!W6RoZU@1A{lB1j*9qR11H{*)kXs(lfWHT@ZR5{o*~ zrq!UgZ*>wZlD-C}unyOP(YJqIdSI`OPCpu*ZmK;^6)5&Kbs8=9!UC{IuNKIt*3e-(x(+5@vn~t=RWxDM9?(^JDipZutT7cPWlIe@yQ2E z5AC(_xkux3!Px0w@YQI4Zw8?8|40Ts#%|k0lv=@_0Te*)7wb?!Aol`4@1YL&0WMII zJ*+T7M}h@Kq|u;Iu`T>Gu%y-s1VN~lO^*xAURY?=`M46U2>8>omEdE@#ojULo9VFx zb>req5D^XDFF+zilB9sV(%jkC$yoEn`a0=v?(6|6Hh1=Qr7I$mG#s?R(?(IGzXiD< R|0LfyPjK|IxZFgqe zuq6^XRH8`04HbzVp{VMeGk*Ywt;AvFQ>31HGYSWk6L0L@Y^%V9@yzpk^Tu!9?>BG! zi)Gaiv|oSxz27Jy^h6o6W)=!Q=zww$QABZohSjxjVH6XtYk1f^lw zDPyFe4Mfd5h?ZFSfsW847)5g`w7iMz%2Q?9I9+hVFp{qHqfpp-YF+!}$~sy5V14b< zhn$O-QX!MzG+-z0UL04c)53jdD1H)7t$zR_`m_>D@dCm2UFx|*CBmJ zrote})2mUI+a7wvt7B(yM2G!sx-PdUSF6v{taHru^?xN4JQ{6$Ne4?&7G}L(`|BgGhsqDcU;j-LXmhL6QZ94ty;c(GfKF} zR-0Q=#$vVI_9D(&atg5(@j<&6Nzry=e~C}GjE}a=BXka}8AqS`q5Lde9QweIWJE^9 z+j1rGX}Z9fQE*}W4sv#{wjD&}&(TPIl zspC*hg8{{Z77)S*=Rx@%--Agx^TW&o7>{5S?Z%OZYP)z>qxinItN(<*%S#K&L+|hg zEPaSsWGwBh*f<7U0Jp2TFnN|t$0#^t^gvwkU%iiJji>uv_ zBfi~Ti>MzCy4wkm6mbIlc3F6<`;p)43SY97*!8yE0TW%=d$2f4lzm#y1;()ZfUEW;G^DXMcMy(?KiDtKQtm zXXfGng23%5&;sAZ5%OG9xbtJ;FDUJ#T3J)Pg;1V^q%}f@5lsT6*9p0qxWUv@CWJ=b zl*IG|Afw-df(fG&Yut{@7Ta7+>y}U&_!)vynB>yJsi%N>;V1 zz}Wv2RTU_Yb|m;~v%EWYRk77ipxA*euKr$W32Fd}rXWJq6jwE$8a-Dqu8$?~^=n3ML_lQ@){p2F_)%>OS6<+J1cKysw+jw@9 zrK!+N$0Ai{xLn&lfCPq;O`eBuAktCkS)$!y1TStIJVAhb%#rVK?7Q4C#P00QOE`iw zhr?KpxMasH=^1`t-;HaN7&#cliim=ma8QwqLr_GIfGE3>hyh_lmL%l(f`y0-WN}cB z?B-HJs*~vh5^EB%l!V4FwZ6?F2H7FqC}B!<`z#hV7f(+!P~MW4Uh>i+D$O9}aXR#_ zKK+Z*+P@~b%A*K?1K&X3TiLH0V8G&JBm3jR*e@&76S<6_OGa8}s@v&ALV~B44fli` zc0!?5hh_2oWvwntRaB}d!G60kYfzf92~av~QaTYlPprO0>D!zoOG}+nE+R_5poP6Q z=l)(dI23Xm>&qaV~*B9wpI@N?W)aTkn3EU9Hf0Mvr5PmNc-SQ<}IrgF55;sZ#*nh uek5<1seKmem4Ug7G5(3}ovx2xh@7sEdF=)^C;A^gy#8ZX|6XA#!v6y~nLZ-` literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/revenue_withdrawal_state_failed.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/revenue_withdrawal_state_failed.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5a08e76f209f309ed94f17df548804574a6967fd GIT binary patch literal 1651 zcmbVM&2Jk;6rb5$ue}>PEu}y}MY1S8xPtW&2x)1Rq@f~;P!rU!xSCFP#?ChTVPB$wh9N76K{6yBvoAwJkPv+Gw;pE@AsbP z*G9ueAiw|kM>jMO`b!N)QYj6*?}G6VF~o3yLhNF!Y%S12-PJ?GHNuKpfjONSff-ia zD%cff2DQ*~EsQj@fLQfDVl{3((h+(Ly%g7G)-r0@durIi*#wQEIH8FjN3x}7jg`+o zohP#&&(D5xb!j2fFGrhMb5HYto1{6YwO0Mv{7p zr{)HgO~Jcq#5i;8V)1gE3Xe}W*OH_!r`v5W7TigAzf-#|jm$`3)WTvCsL32Menp9skp3p4QQ~`KeS?ag z6pG-?6g){qlo?BL#66WjCF-l(6DmU&!T13`gtAITewcX#{W0`XZXbG>#_&Dt<9pgK zc)KWEC^&toxZ-c9rDYYF_PNMvg!qx45YjTTQ^zhxBoDfT6!GE&?4DVKcmb7?5UHvL zlC^a}=cYT?W3k?ujhP?yI_s&RNh}EP+~Luk&Z2*-BcX8L?Ne`^_PFd&KUUdjE5>Ad zm+ZS#qSP5dcnw0O1L~hGl%Gb8H@}#V556jV^-iH;aWtLDIU>A6cyoi%(_>%HZD5@eFazZkjkT7OxpzJy!U#2t|da8u5 z*aO~buqHFh0x5RRP7reJZw?`f#R6W|7*gx;Ab?C@Q6N#dyd17o#pe;TX1#yd}{r*kw}xsXqyOYoHKd~`Ff+SY{}{Xb=? zt&05)m3V!0%Ozk7IO?WQ)4-8X4_{_N%ArO|*s7|9sirINiiNV|YwAVyAk<@BvhcF9 zijx#G2ep|p6Borf7%Ix-HmF?381JID2G6!9$Qiu2J@4H`GlOSaZcbqU{=6ET{otvZ K{(FqCxbMGsJITTT literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/revenue_withdrawal_state_pending.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/revenue_withdrawal_state_pending.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3e3af10529834fc7d8588e95f6fb1b621134d2a8 GIT binary patch literal 1633 zcmbVM&u?Y6H-sPZIvFXocdk^TMifyTpb$G4D_aY+PqhsntOZdrwUpSWdW66sKe#47ycaW6G~#nir! zRx!2iO*+8sQXbp;c<^MA)0m` z(~0}sW7GAuG)=^GtL4RGGc73QJk$Eba418tph@ zp5jW0dMo#YBI7a`KjX*HLFvd3D^K8g22UZk4?R?)_%8PGUF~=LDDP3|Exn!J@ekC{ zWJ&ZB#$|;NKk`#T8iqW1>~ch~V3m+Oo}Ym1(jvqQTpF%wVuXkr- zMOSyd&)qcU1fcG+Xrp`GU+D_y(esJxt-C!Yx~>nbxnWB|CR#%#$PpDJ=YkB$XeL|y zJvi*n=l=<6b5z6!5G$IX{@F&^X;eG&aQ?@I2MasZj|bHm7{8rW?=QYAW`}wocA!SN zD7FT6UUAM0e@9KZ3d`d-CN6G?2`~(VWJo;stQL1D}sVchI!8;e6 z?YV*B6yv4g>>B4^nWr-}S-O->qN{ir?_62QOxwDYq5r2Wl`7A7sQ8DYTebl%0BN-k zZ4DrC^_i1pU>(||C|fl)FRSGee6vDP05PeVWsA{L2 zw4Mf>q$xY&Wc6%>({|3u>v@b4Xc^JWZA7yye_ui90rXh(0?oCMmOqd~4TpKdbv@tk zEzcF25*F7!SZ$EnN~8A9+s)-rdCT1i(^oB@al<}H#9N+vpWS3`z^+;TCgsMqVYk2m zTifZe0~{~O)a8WbFgW3{*~?9Nfr+Rwz=uA7Pk{u6bWD++SO+q6g{e2jBq5}yXo97w zvIHx$h^l~-W1Iq9td2)jQOt($tjbuKXPA;U!Q%AT1FlMF6pd z8A2@A@(IyWVd=zWiC}hzkbmstkHGdYONeP3LJ%TSFqU~N_m60Ov36J-P3$R+e3hJ*u8ZDsW#V;D4Eq}heUsxCvR=;`v`?a400NF0TI|lKvuzCo) zkd})Hm;)U1CyOB>k)M}H@)2c}Uy$fgP+DG+>KYCsB+L=wcr>sjE)eo@VAx|znh@%l zz;FikgxP7;#dS4L$cax0tdeg!3O+23**BSOL)tKZ8caeK!kb*i%Zn2w?<#%)1<@b> zMhP{U86l|(=#6!}zqrw_57dpg{ibdV)#^|!^_%_XUUR6vK2!_+mHx`!%22)XFnwW! zO3C-|sD#eHynpVsQGPB9BlN#@Hu4(#KB4)=Nia>VDB0`;@NR%jF5gO+g3^Ini`kJ6 zi_3xxlkh=xM9gf;4217F@hg7ftRmy^U!>Wb-Jq6esX9e+h5s_t=NSv4SpEjZ!u5Rs literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/sent_web_app_message.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/sent_web_app_message.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dcb85af49588db14953926cb7f02dedf7fcb6fcf GIT binary patch literal 1521 zcmbtU&5ImG6tC)!`P!KYtBHyzwC3Uvo%Y~qS(Yrj%SP0Ru*oiVMk>`^HIvTvmsLH+ z2|45tF@lO0iJ;&`B9glY{{{~uc#t|Rc*?D1J;~#1O*~im`{WwvEV$P0x%i&x&o&hCP#6Q7x`} zb&L$OjhKB4u^O-6H4(Z8vl6et>N}{{xUZKztd?k!q&dyQG?6`1buPU3?iSfNx3%%s zn}cm-t|wE~IG<^lM)z@brh9=$d@N{u-oMI&Jg7WZ8j{e056^-A1j6RX!wh-GMF`(B znc-Q?^N5UD$pE}gJ3`ZR}>#SbM^GvR|ZjcJz&*zEs zQ!#e^G?(r*?$a!jYnO?WCXUaq&}ihOBXBX1T=ZMzJ9pBF2>6QgAHHZ7p4K5$KIcJ| z4hBb^1*w;0F5XwmRpey;5D8fii#AZCPLsznCnTFPn&e?X_ODSfmO{6RstKM?M53%g zn(#o^N{ha0cu5y!4UDhw9q5mIfy2&SnD<~-a`gcMg~2y)h;JC*<1fmtgU&GrWn4d^ zo}p|x$+%DrLc%1>3F%qtsbj$r$)gb=<@2Hg-c^&3Afi$dB6Xuc`EDNVZmtaXQn5eW zNLiSShx-#j^HdNh$B-u<4&M&_p$v2WT1JC?sJk4}FxB1X=F^NzS2Ik2Vghwr@Ym0# z;%Run_2(ZWufGWP8Nj6r>hGJVIEgwhe!lhT_GjC_wO^REclB`3YQ1@JzN|LeyN7TD z^=egCz$z+JD@!1{dU-9F_PDJS6NU0hc_zo1L_3$bT%Wf1%t2TP&)tPl_W}T_V zuhyBuK=!(MP(N9quDyqgE_(fqqTXtPiT<~4mM$yD$Fz8M5%B=X0*Xcx=w6^m=zo=} zL2;oQDhhP}ikjZGd4kNg-^VPcGbM=#GF9S6vr eJ$W1;XZGkQYR_R!$-nEbyMLC*Ur)fxF#iF5+L!PE literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/shared_user.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/shared_user.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..999ce7070e9c2a5e3ce85c83b37e39964e4468e2 GIT binary patch literal 1972 zcmbVN&2Jk;6rc6Z+G{(`XIltKlWmd~xl!!{;u2K|2qFDQ)6%3uY#pX+?`PkvsXNh9=|G`d5J73H7|%41|BTdAU&Vk(N%6V*gbHPsq6aZNL|TGC9y zx@zNUs-~N|f~d-pU~AQMEn{XBlt7EfPCi6-it5i)gr36_4>N1)D=43SACZDtvI{168~5%duRI+?9btJ6q$;R%)}iyrK#Epif#2W_|nM6re zvQs@f71?^v*6lRJXJVVC*`SR(pX^g?4?RNbiaq$S-^@HhpDJc{1$Dpk!$D?c(_+-V z!ztVSJ!8OF-E_F&MF%n}o+~WJ<%Z*~d#n~=WLRadAq>lCz#ciB>`E)G04)(VenqF`JYdLU=A=^g)AiL1bQDxZd%; z8#!;sK3OKeXT%!{nW)|sufZyG&e#;9&gY87ipOX{bQ)9e*hUdb;YF+NOvg3K{L#)p zbzBjoq)i-q`7qb*?_Dm~T98?H7?k5$H5#Ph03B7A@pAESv==Ywaktm{wY5O2OCIDg z8-%8^At{EXI0YgYCr6+YQs1#HS2z{2wQaEt&LmfYB%`9i+yF0oF0Dwq$st{EZBP~= z<=}l#zEd6p(M8t}E6?D04o^Jp_dIr@sWcN!wTYXWtvuD5$?uhKqN@d0L0!&ktRJ?V zRPK)`p9nPGs8bf`ggCAv2+8Zg@Jpo=POIyL{A&(&8j=TTLLwp%!ga7E*N{)< za_^2DL0sq-eGVM_28h2}C>%$*vtKWKvG~>EFMZ=7O6B_fS10|k^Zsko{^&XX%vhL( zwa5|np^=#|*E3~s?2y_4Bt-fC`0P2*V-N?V7BxQ7qV7kUqyQU{LV^;to1Kx`DEwz?DTM83MyO#2enbx&7o{8rk zp7HT*e{#BYwT-9axre8H{DD6))wBjGW+;4ImGYhddmh0k$!gycCoMnyn3VTL)Y7^uQRHwuw;* zts&32hdh&-4>g1y!IKZW?3FiByYg6?ZJeHS!Y~q!@S~8oOR2T>@tsw&a(i{n z4P2k$#tb)SczK3ba!w6a^BVWj4)&~jb=$m;KF2m(r}%C+)8^)`AIE;!zvX$1a(*Cc zEf`z7K5s?p;4MaD@X%23mebo+|BG&J0 zM}l{p*uP$6m?lu$Q;iFj*4=0r3N|8c%;n;wq*TR!qsPn9^D?DL7M1ilthD%}I6v zpk0v#2%P~XB&`uLh`eDSd7Y3?hE6c`lnL=77nYlZ%={-nd32dcYLZ&hD!4QVpqiLn zhE*<`<{frLM#%rQsS2w8AE?T0YVRqqh2kn* z5D;YB8NwR|vN8EzmzvN$&~CXl>J`+t9Zp%f*u~~0Q%R&UPb)Wb-QQ-5U`omO5Fpbq n#tC};=R&H#sbl>E24SQc literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/shipping_option.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/shipping_option.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f0aceb4c7d62b31a4a1442959d3effb70c6d7a61 GIT binary patch literal 1571 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 yoX^IOIh9RC4DHdRId literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/star_transaction.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/star_transaction.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..62e25befcf6b1024925fc38d9d0e5ca538ffcf85 GIT binary patch literal 2305 zcmbVN&5ImG6tC*9>G|G|Y_c1(IGYGEsJoz`5`tvS$3#|VgS$cOOelK0Yd4+kkFmNZ zx^a;S1dN~}g5+S15|P~fD?H4>LsO>(Pw^lf)`R5atL~Y}Om>4{b@iLytKaK4Rqws3 z`ng;#AZWk-_}gZ+gwP*C88kHmc>j9<_mGWj>>>{v7z-@9k|!Iorx=Q-8mgxm8jQ=f z;^sWv&{M3sd9Pp;FrqS>1x|B|Udbq>T+S_f6{C`3-K}~P#zczq?xZ(mOkpIU2C@rx zkX@wu0~w)*@Mg`Jwo7ZMUVbFhI_5>w_k+lcoWKw33NNpJeE9-7cj>~pmG_zrE-(8# zTwiSq+H|>k#Ru>RXP;KqsY|z*>8)1C5eK4lk~ zx#dw`SROmbu141>18V*tHTa`tI|PHH2Mw--lv&vVGpS@hc>fCkUqS{bGO&#d=?Y}R zkZp-7wtNP-JhBzQY9DKWbA7BEs+|YDFx0hFFJ?N;v5Kw3Q@StNQ+LrOwkPjY4E-+p z3>*11H2AGg^Xgh;vXNQeY8PtI&ePCh&IS!@W^J&p1W~wTww+TUco=bze$M4EVq9`;E<1k2HPZ_^e#ArpbH#?N zHJ^MwNb}V+%U4I{+s~hf@~gFju+yfD>x4MI6A@C^`P9hNNl4vILZ0h`&4EjvC&Y5iFeD_@K^KJst^4G|^QT)M z1#G)@F0dVctF_%>W)v_2bz&DQ(QMk{n8`dZtxw#_XXwoE4w+jS}0Y142?lnEKB zlg0K9dlCNN*6cIEUK~vS4Pe6$K>X81$=j$r|ILN38ecblFP%tGu3U+yXX0b?@ywi% za|=lk#!@0Fq3M^B@=z7V86nURSYN^}kHf}c(38|hOE7k5wcjfj< ztSraMRJYk}-fqUqTge2N^%lS z&cFvCUOAPA=>I>F7p_u&L%~iB7T>HN5h35~z#fEF*q)XX@{&V z%w`XB(}78`3eZ_z=LJd^DRTWpKacr8A)rMn(kdLN1=wnj5kjrfC{&~=l7p&lO-GZRv01Vo?#!6h z2vr=Y3Q}A3QgPtWOGT-;_t3wg2P5?m?I}`E+>Fu#%BgR5V{k0E@OI|Sd-LABdGGgT zf3Mf82?U5|VPv2+#GE^bRe0qg-18V_NkNslZPf6dYPEs$Ihv-KqAJQ#*)a3^ z=I57J$;!pml}jIQtmWp1=`gp}BdMO^(tm!F$Gj(K^6A!f9x8~i&{kAz3Ytn9>M&t> zQOOVP#d{Y({~oI1D8LK_#ucb8Fqy$EW}XL|hqx`O%)5)an7MaqfpZsqgM&&NP1Z&= zU!1v0-W*napp`6DG)kpU{TOofv#vi$)7M9Q^)fx#tQKe5*+7JR*}tY#UoN*=VJ3J} z9TeBhM6b1#DcPd^=#+#I(-DgE`^PjaU(955HLp#3=1XM8K@!p*GMcI=B->w8(UU^= zJ$D3G1Ci#|MwaqWgRM!g+B^qh0pTzBJ~UTN>|lBb^D)eluD`G_gW+2^!ncgy@K41P zg0`C*q7IIKpoWp#a?s}@cL|BoNDc~j(bA1|a(;k-{8fE(VwA8TAWlKX# zrV(rQhvFzizjOOx8eauZ^XSKLK$a@i?=6vZ8YXI2HgR?Ou#_spE-A+anR|qQ2jQA zqqnUsD!FjAxH#KX;c2&`+#^~lF3=F{yXQ-QFNjm1YHZ}Mz{V!Vcn2+w4v$@QX7u{8 oi~P~yv1=}l5ytQDSnrJvkFj$MYusMVfByDaVfpVh_M(9Q0ZbE)j{pDw literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/sticker.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/sticker.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e37cf0039e3dbb63c3a77dfa9f5072cec02db752 GIT binary patch literal 4754 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/successful_payment.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/successful_payment.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b7a01a6fcf411ae11218aed1d0596b96ca93b570 GIT binary patch literal 2016 zcmbVN&u`pB6rQoiyX#GM^SdN15iTKxO-ojQdWj+g3Q=evNu>lK%$AX3PZBp?dl`EJ zDSHS~C5i;Sl_Jq2Dnh;Yui&teI9NVK;?$c_IG~((GtO=j0uo~U=J|W`JkR^S_s08E zsZ>NTp8oL5Mj6m=!srYw1NiV001uIa9PFVwHZc}h@szr1s&!(Lx@KyyraHvS)$?W^ zBc}2k*qT?U>!yy8f)WX3;6EqKf`Zm=&D#SiT=bR^$eLSW%PG z+DA9%>D;^XbMM_)UP#op{oSOn(hzRTdxo<;Wg!)^9UAf++e5cNo9nZv=Ms znoN`Ih7Z33@D=35kck~+Djz^@rs^n+IO;6;bmS1g+A$XExl=fQ3Kx#CZfZ^up6lt_ zIj0xwQf9L}FFQJ1r>xag=6}q!HiZ~3UyDfh?l(p$-3 zxaBq)uD?kG*#@xxXsG*0x9+!+Vjy~e3T7$_ABL*(3!st-dX8U88@rC>N3Kn`KZ73? za?$%qj@qdUfXVRD+)M; zCaE!hr}nBcS}hnL*Bc&-%FopdI_ zAFhJ>a}T8kDvf_T|MkK*3%~Y0pCY|fj>j&?> z_*R`!niMIm2Ts!yxR=sTo0fO%$y4eCHZ1p1dg{9eRqK|Ti*J@BD=8gU$Y!1g<;MI4 zaD}3|-r|OMN_3@E0)#0j;O^u~6`~bVBvdcb2KScsmcCp{6{PJbF&Sw~*(W1nINX9e(9TjG?LcYnbf+?5}AAm|#jB$)!Y@d|_RBive93Z28 iRu0tu6k&V?_-&t+H1`IERL`sL%fE}&KmNfbfA(K~)f8v| literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/switch_inline_query_chosen_chat.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/switch_inline_query_chosen_chat.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..acd895514bacdce220edce8fb6414f491452b239 GIT binary patch literal 2062 zcma)7&2Q936d&8;{mSkp5GWv0aMLZYN!V?nYO4sUwo97QkEB(C+OAfN9D9;A@!H$* zY#}H@IUtovw8|kBk;owjL_ys9SM;!{da!&#YA@VerH6`B-`KlLAO&^Se*510&Aj>f zy*KvHxm*Up_~rJm^S>n#`a>Aqp>~w*4?wwvOk_$nYDiV7Ay?&wQdJ~m%BEuDhFVo6 zB%?`W;_Jv%sd`sI=mFgEs3y$B3@Roc3A3mKx!JEjpCFZwCMuttpPCGm_noC6HQnTv z>*)3)NlcQ0{4BNU0@EAQbC;;WjW|>+`#Z*V0VaP3+$gF_CaTI8fMZoLiG{??Dmb$;xhH5G>cLz69aNWU2 z%X&c`%ZSr<{=PRTWs&g(6kcb9!5*p)I7rx~}!3_7mW zId6L7<+9;2TH>A7D7kE*Jm+$+tT(M!V@5I6C`7!e*fR<>6{wLr7|?Coy-WmIB2X{r zk3A5o^|krN^hA~;E2ka0qqOQ!B{%OH!F zb++II2}XH~IfiI|F~sRh!!1H@e+c3y=@y(Z-o?Rl7w!je$Kz5DG38}xSzcC_@v>@4 z8|rf6j`X7hrxn2|RHm3XKKD^k4pgtzq%24gVmTHkq?ii!?qEhdYR?n$+(%>s5GY6! zV%WOp5#pu57L5dB<*|Nly!NHb7HbvPw48<7VvFhAWdxF3qt3UrPp!F{XK{M6sT+&> z0`+RT<%$De=1WcLmE&>(GtsalsvIO;v}~07QgeyzhyAV=UXbQe_sND}ruP|$e^yX9 zgmN$cF!BB5&B@=hLm^7$^8QPQ{a4=bwX#2a+Aq8v_JJ<~!Ymprgt?w6CdYu#wjm%Y z?hy%e^adp)$PfZe-?D|CCBRy@J4lic(>1!;6x9tBkF%hk5NIfu>*DnXNsM|az;mu^ zKhsf6yigeyLOgho>m=TwwhgtD*a7f*q6^+*2gNMWK9NWW-~u4<^iO`FjMY?#gvg>H zZDr!dJFAtOXWRHFTwC~PC?oY_**`wo#`{+5>wL{=W6(#p@TiX`{9_|4)2m;tn`;-_ zcm%F3JmTYX{)w?R-oJWf6R%xsW6;O8@R*M${gF}|A6P%QS=czz#-NwBaLLEx50m>s zbV$vIc~m&zmrwhpQ~v93`lsFs`}e0I)jg3w`-avlYiGlxaHY`EJ8=(hTnlr;%A?_tdxbkk;&=mS__c74@b5+Wz2TtHp6u~Iw6x$F5$*{l zz9mtfr;5oS0o@DjzN1)Ct?`@=uN(NpcFHm+v}mCy)#KEexNY8L1u#VoJqtvrNRs5E fa{Kw$L!`BzzQV+)1RQsZ&C*}O`}co95tV-dEN~m| literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/text_quote.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/text_quote.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..42524f717f1b6597b50046195107cff73517e739 GIT binary patch literal 1810 zcmbVN&2Jk;6rb5IdmY=&M@yBKz(ON|5w)dA2q{zultyVFNsAIdY+a4k-m$aIewdkY zsVg5`sS-s3#0B-x9#IkMg%el)fgW6mgSDqfoO)Xn4k#zy?8c@Mm5`X7d43-=v-5tx zH|rlur2>NX%l*f#wH!jfOJm&hOu+{YQ0^fYx!6YmwlS8v;wyn_tAS=~fo|)8VH@CA zUCqx0c{`60Rha>{?wdiuE?}gfHRKw1kej3VhblskU}Vjna`W4$Vm_5-1;+NT_^2BRdh6$c z1#M^7<5rZO-D*amaJ-OPUf7CQkiua(ji@Uuu}iJb5{g0gNEaI)k6Bl?WoI|blKV!qQjSKwPwUeCw85Xc< zDJIAK300I>=iLrvah?z_^aLT5Ts-^CnF*(Ui;(9nXQyDd*d(OsJDd~3;XWc+6qYqO z+_<=0|1@HI^_9r=!ghVH%N!9g0_4PMfdrB2sP2`P+pTX zk(9h@r^n91&bMYKm{!M!eHr}x0}y`=P;v&97QR{iYVGT_--<6L$S9RZr{+iVugHGp zTw;PF^(F;0x0p;#OgS?PNbLZ2LzQBda0&Dbv=dTGk(-g4WSPxLAwftfWiLqWG>A$; z!WlXNB_u8o5=3s-mwJ&vN{)XN$r0j4O>mzevLfOPDP{ zh)eq4V=u{B#j$|mLHt(`0Lnj4qG)PEV1e5HhX>C=C6312-t_#e?;~q?yzi^i3BtHK b(#{W$_r!P&0|5UP-S0 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/transaction_partner.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/transaction_partner.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7dc88aee9c0a97ec145582b78881f8bcedef6cb3 GIT binary patch literal 1060 zcmbVLy>AmS6t^!4gwS^A#!^{giqzii5kf*mFo0U5rb3ENa(uRPIeIx?Z68uL2L6X4 zv4aphe+2_0%F4tR6sAr*-v^{>7W(e)-ShMF?>)bdkK5Zl1oY+o*U7nu&=0q0s8b6o zAA}1ekiaRL;St8jLr;;g$N!U6#R9<_uAAg#sjP_xW1ZWEQgVA^I|XfBDG5Jv1jgngnkNvt7S@+41WX2}FJs<5$2vUuIp_~fwA8cfppKAa(( zWh4T~%)$0b|KxxSc*=|!j9H@G9eq2`rSaEX(!7eA7Dj6S`fW}@J^p{RiDvN(g4=-j zq~5v#s;x^!nJ^oWn@T%5=H9dElSS|mexDBDHV!S`U$OE2VR~&9)vHI zJ_`?(fK~|43eBw26#RuUdmTPcqR=E(9^{Olu~?e0E_qOvJXi~-DY>7|wHu+5wLvg@ zz~20QmfoFCcZsereYZJq1l`|`7_^5QtqRDEYGttn(q;ESb-9On2bOM_%rjui7RLBH ZBHymQ%UeAR?yj?Ud%v9a_lB*~*&lf=Lh=9r literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/transaction_partner_fragment.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/transaction_partner_fragment.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..bc0135d62eecbf5b9f6649de7a038d78807302f6 GIT binary patch literal 2235 zcmbtV%WoS+7@ygP-|M`Z@@iB!tpr9T0aYLoh0-c7DiSwpTvcqG4x61x>SiBicHNLF zha4&>2)Lmh=z#-jReI;I=)p)iSbK`pQ*N%p0p-LuyWYehj)cT`_Ve$X@7vv(@AsS8 zr<#^Q(Ej-4#metVgkB0KZfXSZ-uD0=A&Mxrkd1YW1(qzymUY=ybj4P6)lTRMJEq*=aouSfvRoV`ud&Moi}Y;3ut|t?61AOIdllNAC%7+Um9Y^gfIvG=pg70is!! zeIg_D9ImM8{WQ0LirTJli#W&{j^p}@%)Ek8SU;#p!9Of)I9!Nt8_9&XEx2`V zva!M)->-RNqobzF*@(|9w#p5A#O14_%dYQ@8nx>Ajz`rZj#k=J2%oh7PMhV$<8u{c zj!fUUIx{y_DlY|!4}NLij@7Ujiea%k9c{iY7P^NI*g7d8(!Hy$F(A)wm}WYubO0S-QcSp7hDGk&ip!e0;S|S%oJJ`O-MQcR~8|>cLl)D z_z?{HaU4dT!1WxisNFq?P-zoyN)$hqHs#;&PvI7attOZFX-IvBic+9@^%~3KQog2Q( z2@qak&b`WPb-Cif#(l45m}|x=^D0Kw6|xu=^m(HldLV5CR9xHuic1qWKY)F!hmpa=7_5b^}YS9n2W^~EL+zt^p_HTkr&4YzBg^WrZ7?}5aK zxwixg7g+$bpBj%ubeX>ouAtd_38p1ujGJhr5a&HUC qxQv_1T;phOD%TrFdsA6x9PO>d+gM1UyKS7i^ePPfbwWZ|gns}6ii^_# literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/transaction_partner_other.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/transaction_partner_other.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cf3777c97208cd61f8d4ddcb1bcb0dd24524591d GIT binary patch literal 1610 zcmbVM&2Jk;6rb5$f2?DtkQQ1bKr5gJSHed0M4DEhBuXnPH;_=o*41dTGjX=woi#IS zLaH8es6>$<2PD)395|pN)H{C#2P5SW?I}`Exh)EZDkt9T+NmSAmp;$Dc{6W5-tYIG z_m5hwfXidMt>a{h3K7LL_9LO{W>Q=I zYI%{&UtOI4^jd2vF+UMoN$I*Db4h~(BR}%`s-!|uPoG()G8SB}ZuR&9&fPPUZcjfp z5`e4)AGSe%2Ov3eF+;BL1%P!;ZrvG@fRI~c1}`yl4tCmzm*vd3ms!7JR(XKdF|+Sa zyY>V0Ep{s_Xf)QRlCzVs+=w^0yt`9zKo+?2q`$_ML!I~;C}-1;HykRQzUYc*Q#dN> zOOHE|bR_rup3g_WXCp9_Zz) zMLLx1nxpeWj&Dr{thsI6SiQRV`R&AtVN%C(8VE`1WO8$cj*#9KqayY_(%q!8qoigu zDM}vqrAVw+B)F%urA3e0J*87}1&p8ZL#Us4ut3<<7B(84TaUKE7xCj(4&O zg~~EpS#*D*x{(xAzsF@#Cd3zhOi0~IX2yaeiU;e2Wc%eQxIM86@dBz8Axf7Cq-gu- z*1~N2%Sd+H^AYn!r`_#K8b^`;Xg-iMD zSRcX(R4?ZEYG7v|vt-Cu^z>EjpVIsY8gfFC3L#;{`hm8qgnZqn!O&A8ghd{ZRfaQ3 zA*+Y%;^Y(|WB*~;p_$8oCAA@)9uERwAIl7g&fmxKoZeL(DH{y+6DUCV?3Wr=p`0SE zs_5c1y!&BmdtqR;^7fC_+Os~|FP%xzbm4M3jV^tLcV};=rHXwyMK7mpeN%Sbv663$ zf@}d-z|eXh$`}}u`lFTT0DmV^Q0QQ{lUL_`M>A* HvUvXozc0EY literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/transaction_partner_telegram_ads.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/transaction_partner_telegram_ads.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..92e0ee540a7bccb2a2321a541e65fb5edab2c656 GIT binary patch literal 1658 zcmbVM&1)n@6tC*;`RMuB&1U^r#f3(9m05J=upk(-%Z4P3Vhmw3BKEcvm9CmeZ~9}b z>M>^7Lk^M{4Erd+Hpa@%w-bFX+)7GIUd#pc_q8nKxsITrq^^otp&|~s=xp`*KF-|Jr`@hP zEEj;R1Rpq{KL?N;*_a_)`vAb&Iydf)NkGUhGL4s*J_|cd#LHrO(#wqRF{?a8UChh} z=WO#K`V8BZRg}LQ)#UQ&yL7nEdx8dYOy2vpVu37h=?ZU+ON&~YUcAl(-K4%1AEUJ5 z$copwmB(5TZ1sH_cOwxrD`}S1XdqlZW39(=U(U2zZX|d!9v{|>M6b0L#j-{F-YXNC z`x$@vKFVa8?C|w5=XcHk09-dai%W~`+jH-exrNn_6C;MT1{UXlr=&&Bh&cvLNPmmb zF!o%su}MWw3PpEP6g(b?Ffo>+kh`jsO4M7qtEyf%!T1J0hUSWMKdd}~=P5jy+&%Iz zjp6&)!}qnH@T0VSq3!hL^p3xvhL#lMpwC58Cd3Q9n2?5%Oix^nNbYwDN%xEMkUcR8 zaeXQ!AyV}aRBrolZDGdwFcKTie8jx4=WGlFjUz#TYlnxQI!oS~BcXlY=u>xt_PBJY z7pd~M6lJnCQ3^7y1<8v+pc>8omUtEpyZ7pUlG@BcJP&(i6V%_^XmknHFMqZ8Mf=P4 zPVJ>(Z5GB4SJeC3+u7_$A3y|Z6f>}Ouv5foWyF-4UQqt3A}gc;CnTv55=3m^E4xO> zCj;t_Jtaa|XJ`y(KQGUA0`9 zV92jQ0np>$NHYrM5mKs#W>)adTh8{v&~UQxyW#8_xAscUjL=l!#%LN{cx`9u`lwnn zZ;a6YQ>IFkW;;^ih5U}oz!>n<9YALTPeOeJlOhxzIwb?GdRr9La)F0~KxUj>Jfkaw z`etYFFDffNL{V~Bp3MqzQ(T3q;z~XOHPSK0yXfWN$+3r;!+#%p=-Tk)*hSZeC&#Gx VA_mN-)$q!jf2!rb&hVx8{RehB%lQBR literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/transaction_partner_user.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/transaction_partner_user.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dd6a7cce7893ac4e1fa08395d435944e68c4aa34 GIT binary patch literal 2280 zcmbVN&2Jk;6rc5u*WZrwRr*N{O(ho5n9?2~st~A&(uR;mBmuE;I@)?C={EaeX4fgH zaxhXQid49vO3))Js(R383I~)E@9oBkO>%+p+vhj$y&cc~e!p4& zTq@-Wj9-5IZS~g-A%EbcJJLxY?fd}2BVrIkvWP8dl7w-}O4+g|+f<`=T1(rCrq~%R zV`sH2)MbNOIXkcAAx;~LRj`X%Q6gLx$6=naN_JT*$F;0AU{|zC9OtY-dq^9Kgq?==cYsXLuWIjv!>^VnOW24Lbt-~jV5+OlwNWmc$rF8I<_cu$I}~FoY#f#aIv`A zYeKijU9ncX<@#PtZ<^_(nEGTTq&~!A5HJcU-aEHj>N3CV`C=s;Fr5w8Y;e}pH!W8; zcBl92sF>wg9n1fw^R4PZ1}X2E$KJ;cyLHGsf$JGu z$+)v$F;ZL7R%%P$qK5RCZl!;czKc&coGN)vrO9@W!CeP?eoE9-nD$zLXP9NobWEQy zH4_f??3sDoT4n60+r=qZEzB|2uyoI3%!9WMLFH7d?OknhqW+mH*6UYY!*tf_>n)-C zu3(^qI(Ihev*xY32S@ipQ*W&6Yuu~rri*&1A-`U&M<_sKd~8`Px#p&L4Swg|*`whe z?>@&lX!2&j{oN+ftE6=1+o^A+A5On0o{or8DhHz{(5kiI)cGg}i8veO$?#ZI*q>r& zQov{jRwHUL!D0kr5#xzkOhA1FBUFPpfe!JB*%qfUIs;BEA<~X+bH>6vW43FwER2hc zebLgby-J2L!)*ZUAOz4kDnI_!aDcI%HzPFc3s9hTVratB9wiNKSwN^HVk}T8ABZvR z8t%FQ2)y6H0Z0d*C`HrRh@dNycdkhmB; z&*gB%c-eg?&UYVhPCbS&ueRW@0n9>%La2bmK$8h#cp8O*4&^KG^obm}FwLEo?IjEh zA0bCk!mi4}JApOv#UaX=9_mdee;5M6?(5&ce+^NAbdQi?Zq8yZehB1iH+v<~$@}6m zOp!=00vE}WBn9O4PQPuFsm_0~ZSrQP-vV-}({I~y1q30T3h3LNehcX3PQM-1bFxGG XEK*bnSUc=GXKH_9`mZBuF(Ur}T=jGf literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/update.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/update.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..21e7fed8ec3899d37d6c998a2d0178cb30838b87 GIT binary patch literal 7746 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

    O+KmQ; zIc~GiazO1k!QhhaXmuUdzs43cz1b|JIiv!@w<6hwWCxO+NOmC^L$Vu*iewLvV2g&{ z(zNEXp*LK!s$IFJ^F@ba5((m*xh>uZ=&TLf5r?+k;aI%rFN_>w`p5x$J>c^vYl$D+nM%2J8MXvXWO|iq~D7?1(77r7P1^S;=@Qb zBl*q-J|Klypupua9warmT+`LG!eB78!DP*0R!!6X@4fh5IAV~}v?>IZqiN0{$oL92 ze4S@MIaQwfh0U+by=@z2V{z_Ei|ekR9AAB zo6IR;lop%Id_OF{l11+o*X%kBT@C~CpAP9xlI*VEo&IFz_ROP!on4a8=KSH!{^%}$ z$ArIq+~2mxA3KPA;iRvY{K*-A|6ADhOm}y{STUiylMKJo-4%(rNT@*WDQrZds6YX$ z0Q{tnqtL#jU*$s18#wCc zhi_l^l4Bev^w~tAL)cUV=5Ak<3mc*ne-*nA_3I(lF!6~94k)^-Ac@!lTT-A3Yx#*+bcR88~uaaDjG|$`dK$$!Wht_kzlrDFXz0M2MN4koTG`ZRBzBoN;pGPY`cvcH zsV~l~=BFOzr@Z7;=+n4et2xZwP^X}>eHbW~SvTDv-b>GzgR7ClKuEw(B;X6O|Wp z+l3{lT-BDV)}WBrnY&~gYFQ+~@_a9O6~k_)xX4@$-vm@p0o1gnKx)O8!MFKnhij%~ zsd~$`>i{LIP(PPdKzY{MW>9;%xzKW%Qw}i%o@xrt0Oh+pFSav{`E?bzNp%sL^bYIV zDx6EzRm*f-)vl?%!>LWP3Kft!!ZKZem7@A{Q56xzJa44P(8ZUT2Rrsd)A=4O>VY0{ zjo%*lz-e)p-Z8@~TsN=W)S+I09T-Vv^#TJh0nbsl)JChmfOxA0<}4o88_e8Zr~J-rP@jF#227^;rgVST^wjO*I~xVeh^ zyr)|&xZeflUSq7GPESq0_L|s5uU1*p#UZD{bHIwW3fkiOw&8Khs@ZT{y-{Uo*!L2D z9N!Kf00Mu+B!q)agCEDv6G&b~jS}Rai*}ChROI_W2DBDXtnvjVOq%PnPvR&X>LBdG zQ0S%6A$%?U4`pQ(LrFZNenkW4e*gq(f03l#^pZz6w#WH#FF)QT%3#_b*?MQjAKvB< zjdl|ti_UJ6$0 z(Y7EbfT-XE8Wo&?q}x#|aH-$~I2D{gsDcwPRd6Z}7TlhQ!-OgzDj!Gg6(CSt1uxFf z%i&m-xY#yQ0jiiSBty@=h3XSX1ShbB9ckRQ+hpzBso zlh8E7u0nTS(>DCQ3y@M=#&-ea9FwlVc0m&S3$WE)4offATV6);BP26Gf@}|KRvCaG z4PeFr=oP5qgn&mpk3*4&=*mG912kO!*Nssn*(FE@h%(Tb>CD`i>BflCram3)ob8;w zan`3(J{|6y>zuoB&Zn>VyT?24cyv5$t90C_C4X#h=Zr`9hHaJZ^=Z)`-`Dw>NB4zo zmG1MYj{?QEN)P+=lK<*~&N+`B2-_+>fM+@x^A8>I z=x&b!#kNY1VE^@)Up(Z|9UcXWZIvGK>Gc;oad0!{?>p$x5sw1Jwn`8Bbmehkqzex? z*Bv4ICt-L0V975``EUFXR`JWn{Uc>;rNiCb6Dfee|C`K8B%bTWWMy}ktdXx}=)3uT z*qau5NjU_#v_~R6cEn|63a7q6(y~%S#S0`y_Dq0xx`{DmTbF!0BA&Dekl8{WBfQqa zdIym!V|>M-puyiLVNi;v5yx(&<(ifgg2A-livl7cx`jW$bx2TvMM#k775y*`ide)% z8E%U3{aNx@_@s{WOCTb|aQ*_MD@&5(lf7PldrV5+H@C-Rr`O+nvd`;pK2g2?_E;VS f4@e~lS+Bo!23+ ztJNUTe*NyZ!7nx;f1)vOZl%zJ8=%}LoN$_wjE0n=ZlzXchj!+KPUeO#tl8X2y{s12 zC=s^uz;@Gm=7&Bd7TF-&yGwXY)E>Y+4`Ea-Z1DOPY5R}RY|~;X%5!NVlgM1R?V`2) z{yXbz?Tz)dx8B^`DC{fwq;Re#+B~Aw{^f0vilK_KxBE9mY`}xRwiB6GrPL;_uBhbE zjr8CW*q=c@f`pWl(7FbBg*LZ@!|jWJ`9!#?!Toz=KzaRcGxY9}PiR=%BJ;W3D3-5j zp^h)ox4viu(6)CH9mq0}K#7qOTI5CtQIJB!fgA*V3=0-G7d$W$kQjmu`V-K`;IY#v z{cOpxip6TMW6VgecDu1uqGOH{?MOB3_NCF?Xp~&QQ|P1eT%JB$L4vLyNB2SDRcH~g z#jqJ0O?Z@>BxbuGM{1}Q*1YhPFk_V$&Zf*oj6`F@8Q~>ROA^1O_o1+6jsx@n#zPoY zyLpUoi__aQp|`Cc>DT4+fs)&sss$T=CT**5^>`#yQD-d46T?{BDNdgVj%kq&7%TUy zWjIv$jKyiBHDlTV8@Ru7`0i_~z4xTr?X5|kX~_5o9!j! zU@(Sf2^=W=mkST724$`i#fPapTz2{q)Ul3g<8d*Sj~mKFPoq}4#^ev{7b|KnsS98t zEBbp7Gn-PnN1mT9_I>iw^vQjn1k=U7Z=aeGN?+V_UYIWSnfDY$#{OG=bK|cP`TGfY GnZUoDK!i~M literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/user_profile_photos.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/user_profile_photos.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8f895d21f84c4870ac541e370b534960f99883c2 GIT binary patch literal 1545 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/video.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/video.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b1a1162c6349b48155d2d02280668a91a1465ef8 GIT binary patch literal 2056 zcmbVN&u~f3sqf7?ZV>6A9nU;}@4eYKe(!rb z{;^mr5Ewsy|LfWWpx;s18%7GW*LMIsC7f{0B^}MuG{hM<)6p%xLoM1dECXyhr*5{B zvvL{{y3B%ZxcQE0nHtHEMZ&X>2+xV!bDfYEu+m`_cz%Uc%~z;awRp_-JU_HU$M=G& z9v5%kx^bB;d~$hV=}KcU)<5<( zO63gjC1+8TQ5*pgmzk;$W8F<|d!f@}8xL%`9!TtfI4ecilU__4z9(APL^w=XMOb5m zXs;Upo@h^@al<`7Sf0ar0V^GMM;@N(YyC`L@6*1~&-QcueBb2SGqYd#LHka%w_j^~7oRmbB)`_f{8aMu|7PjTf@I50LD zYq@q1Fcyr1j(s#7gWbhT=bNAVa-+H6bH`h6ZXlb!WY8Q<;oWa8JFCsW3B|dt-P*9% zMbNYzA78*avK7=-@6@`RvI3DGmJ}DYQ3hZOZh`n~K$0`0c;eg3UoU>M_}lpLgp3tS z(cH=CTKA1WXy@ueVI-3>+lS?bEkShBG z+EncoQUoZZSeQnyYN*4AR97j4ttIDBU9Joq=dFj1%hA( zJW$_%K1qfe`GlYtC&tuZd9b{-9MP4CmbcY>Ny|xw7`HPKEe);?u5Mk8Xf2`>gQdaJ z)>1_45uF-b8(iDE7SV<1Y;|yDn^x2Ll2#*nHaaXq1y4XEx~6FnIlcYn t+#&Vtf1f*~vi;`V(I*q4Y41YKx8Iye_CpOaep@_l{DIa#4{)iU{Wr;D2x0&L literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/video_chat_ended.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/video_chat_ended.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0530974bd59ba626d93ed368b80931d50f6b34ed GIT binary patch literal 1376 zcmbVL&1(}u6rb6zY+_QSeq9t6MKA{w@K{8Y7~)r}XjNQ-!)9litljL!nMt)GSVd4l z#f$Xd#e*o~-M_*^4<2Ms1y9~0^&p;nGuvnjdhuoE?R)cPetGZrX5LmRB?R)}<;S^} ziO?72jK$6kymlIlWkeChG3sLK3PKnoX9)%~j6D$ce9Ns`JyMrk6dMpl`U;qls0@E<~=4EdNM-?#(``zAG*Ma?4+DF0$LQ|&7$pKmu(8YSKK zyed281Q=?wWTAaF>a;~9*`YxY&O;wWJBU(sU+Qvkz(idWNECxaQ&<};@<{-{y?Zlj zwQ-iaASh~}ek`F;303w!Z9Z;2X?-g1St*}@@v5i3ha0)~Td%s*B_j)7Xt zcR)y}<{aZY)vn@LxhilU6cqI5H!>{S9U-O4$evu9UYfo){n@3mHN_JodDihVSI{jQA>v6rb6z+g;x!QAom9kXA$#C*ZE4zzPn?SSBJek?eq24n}i3HkZ^+OLc7`}yLe9QP2e_fXwl!&<|IuQ6h z>Kdgj#|0OqOGuo>ijb~Vo<8z8B6+e&NF6Uuz^2k8Buc21gh&f)NYU*B`u5`BgIsJ6 zmU9+oqrvuAP?ZY;3=ViU8C;2n0|`lewV=^9Bufrxoa<8StDS<&eoZjZ43nc2!;|V# z=oLHS4BU0|r6*C^n?raOLS+xcpSMxvqs|Lot$eZis>rn2) z4%BrTsBO?|ymem0No}6eepgeK(UcQX`h=u88z)+C6Y}YpCNocq5SB-dPwa!BS#X7rd zy}s8vQz6g3RJpcysY3rpczRpC_fUvu<_}rxE@;r3V<=JpE%e_(=|B!4=?yYnroz$7 z){w$?;MS`CB7~=1HKx;As}I#U58R6li%a4Hn3@224@6~RjCawC)8l;)y*&NzzK4S8 k@xEuCsu0G{?^@4IkN3)X3Io=EiU&)->(xL0#Z^E1FYd&krvLx| literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/video_chat_scheduled.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/video_chat_scheduled.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a0132f4b3a989b3406b18a883ed9e499f8a968f8 GIT binary patch literal 1460 zcmbVM&u<(x6t-t(XJQoO)Xn4pmP)d$J)>%Z0c0^Lu{wH-6u< z_d&beL?DlTe7yCCi_o9OnMRG1Cvzh=^CAy?mw9O|^CREd zwX~iEQGk(y`iS|r5UX?lKHxuuUP;to!8+nXz46({t7PT! z>dJ>#*7~LULB9J0S1T7cc*;kTW><&Tc&uS>aEWTZkz_osuq%D|DSU7d{I4Majv~xZ zGzgjOGMeioCfi?7Ia1OTzVs#6h0IHDP2@Z_+#4~Y2`_+YiTwfJg(~ZL976Y@ zKZIV%wWA1g7`}lMe8c$}e`oIy)Zbl`0EK=g3b{R45iH3^gY806EhGW120Y&xe3T3aD$)Gi z35~a*Dr!IzVQy1T?@qYtSt^O)k{prQo$Sgb_`vmZ&$HK^pY~N)pt_)*-bAxS)PC*G z>Novw`@gr&Pg|Fv{n9k!d;Q8g(g&~ub^IzTQ!ksEErDzschSTH!%9vwPDt4#BopQW zg54tI^Ma;_kvbtv#4!C5A;+E*aAxSSDU|I)&SIXXKrxo5Af!x@-j}D%D)WC}Rl@|n z0tE^E`Yai1n|Ef<%lGT2W@w>y1ejW}icq-^&KfBAT3^1s5ttFUmK- zHDsvoLCsu@@g90}da~`Kccw3D`zV~AYOdx<9Tmpy&rqMErdlt@qdsh9boPl-pK5ZO2-vI+hNpODY^))qEoYfSp>OSkRQ%?**~ z$_ksP++3oXiycoOg}D~lv*{~{ZCqE@=srQCyW5E81V~6F2|Y@z-DldIOBHkeiR|3@TumMiqZdjq zqmhzHK982A7FKDFY7ykC=xH*IOk&}FA>t)YZ6c8=+J6m!9x_4c0(r>!%XQeGQcCX!q*fgdB58vIXn)%3iRmm}WSDlCT tu#faD+`2z+ULtILO6hlU_u_E9sLVuZ-2Sy@BgGK`9G&B)2;vj literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/video_note.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/video_note.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cb6bef10221911528049dcb2b7587820b52d9afc GIT binary patch literal 1993 zcmbtV%WvF77@x7d-t{KCdD4`=VhDv=Rdx~L6h##%L}`^rBPD?9E=;}a$;OS>c4xeS zRD0M+l_&@hm#PPPL`A4~{)!$F2?@)mNSt~z3I~)E-`LqD5sw3m$DhB)cxJxe{672p zQmKfb{rK(kje!C}zX+q(a+!h;KL+J7vXPBl)WRmlLYG{rC7W_fF_l)%%z;m~6<2NL z%{)d_W-8b@x6sl|4I>FHAX|Na>^#jsl@WRdch=0JU06eg_ClBjjt4By^Fu3ie2*J) zTw1@iI#1@V&(AI1SXqeWcfFmsa5E5L%YA{fcgpM3rA=nFZr1P8MhLTLtDAo4uQ~T= zBU>huO7_5qUx4x%A>mZfqdHX z>}fHGH~fHJyF>IV*0$xiR^6q#TgABPDbl1|HkF^0s(fCB6#5b=4^KNv!S9ozCk zr$M$pu~?HcQ6RC(XxL_6tgQGRZ3sq+rot^MYXBj9cpa2S_%T#L*o%YbDcsNC&f496 z#Fjd^BX#7C(#dsH8$VGy`S0-8Y1Kic$Sa1*O7IdZ3o$Ijh!Fiv|9}iB&hd6YSzI8* z@tlwlLyJdGWI#A|HwgLniP#yKH`WMgxEAMxa1Ct1OwqbWOYhCpKJ?jEZO*qHuUXp? z*!zss{jf&8?b?!4uW=`&(}C640;2Mo<@lmZtKm*Sc}7km&bboounREv{n0+!mEOju zz|U7f{N6>$B~-fj)%@oRUoQMKcp*WBQaL(18BI<{6BnbGUy065K~GBHPGdMnK{cNZh&R-}w{m%Gcm%aJk{T{gNm_7o%Q`-%}Mm!ruk;hW0(zA_alR}S*y2|AxE zCudOQt>}%b$;gBTp#L|aiHXwL`hw}bOjnEnf$v5e$`9~m;+GPuKrP^62A!x+CMq#j z>K3OAesCx*2IAL1M5Qyq=M1`YLeqs1a2^$Avtzr)u7W9W=8r%mGR8PUukM}h2dKLD o&;0=Dd#C$>Je(kmUk3>HPWMEuV#xTf;+yiX!u#9bgwk#Q0k}R6h5!Hn literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/voice.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/voice.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..26f4d06376b683b24c098d7bcc02f5d5a03980d1 GIT binary patch literal 1672 zcmbVM&2QX96rb_O+Pm4^kdKnKO36Zys8yQ1M->94Aygz=qy!M|!pQMVQa4_EJL4@R ztk71fM34$M)B`=DBGfy71wyIB!SX2*r{0Xh0p-M-@n%U?dSN{C{Cn^DJfmh5i=sI3k|2(Rqi3~^Pd->COYbc&y??E> zlIib6yP18xE8SlB6c;h|4HmL(?scwj-eP{@7nuub6fb=A6@af{+YGswB3Jtmw(sgx zV+Pf)fUgWk0Bj7g3Ai-GmTOWQ^zukA(F*8eh0ZKqrxrZbhZ>#SM_ZUq+^f6xKKcT? z<#lxOcBV4(qd4%{9<4NBY}^b)BUW2(aMtBauqY7?uW?6y)BqaTLPdSK9{0G<78^H{ zq$?JiO+V&rAsHTeA?Dl7%{UQFuN%y(SQV7%BH@{}6@-igG^;Dni-OxdrRzbIWH#+_ z#dYhrcEain2>UcEcY+Qh$!?dO@<0f9R3Z`VF-PMQz#N|fkbEt}?7Kgz(Y30KUf$pjVO;KUf~YdJL-=w?-bS^>JV8 z>wTkdQvA^Dmwv?GsZNA$(p!$ns}RC#QjAM6+Ud{8(K1u?x{PNwAwd)*ggACKd1~uK zuyBiz7v|v8kTNS1;)k9Pga{jSSyLE;v?UY%8v_&L`RSiIrZYeP>vyU z3Mu;P(xy0kNg`QtJ}HG{Le-d`k?3U*PDK(MdC)*4s}RzOX%Cu^WK}|L_q=fEu?V5D z59V<~PThK-eN-zhudkvZs}0HaSr|gSFrNjNkp1vBzaYPoKQ1L?EyQmifT4e%Tr*5N zM^aRgIWbrrtlnKsjrG)+IZ*S7F_UY^yrHGW#9(c(c6Ti`meRTT!L8Ovb$_HhKaB{ku(EkO;^p>ZclfoswTR! z;0i(vB*BBhgMvATB3?Y@ugGBnIV^oz@Z@b|J&32g>Yi~|P=vgxdi}oY@!s!M&Es0F zjDY^S_jhmALg=|xrex;=-u(uIyNDr%Lo~o1##%N)V_Usuy2qwT{yYjiOjl6~vLO8)9<}<%NKa}Y?3TeMXx<5yFiOv`XcCZ=`t|7l1IwziFn{r z_aX$l5be%iQYw*i&88m<-cXam8?op&yRnkZE4)jSM4rA#Tot?O5_iGeC};Us=Lc$<&leq?XpxN_VJK91+E@s`Mz?>w=JEgV9I@K3Ts)MPCX%V|-HNK}D6K`?V$4ihfYA|XK(C_?IX`pLd3iR59AkiA2q1}D=JA$~}uBt+^4 z^klZ)v=-+&7h^*ifBK~*dWpxfcmPn~arZbt@+pGv5|PWxPTXb|f=)l?e^ z&*nm4FhoPxNH)YF$b9Y49(avujh}%-eg*9H78=i>+Ogl3ep&u?`QPf%QMLW&m(R|@ zN3VsoiIA(+_AZ=(>z{X{-(7}-$RyoYHVrYOr2|={#wDTyPDolNWDv7qsO2glKMrX) z@e~MQu@B}0gzS4zfEqk#l(mu8CV=@o3;|>;J_VQ5^Ex9A>!{L{6}96IFlcV?H#RK0 zI7XUPkv+4uvbAz!W!q|RTeG8V{bS9J4P>{CoxGj^4L+kUM&Jjh!P{_x^r<`}oVu^Xdcstib;O=z4UD literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/types/__pycache__/web_app_info.cpython-311.pyc b/env/Lib/site-packages/aiogram/types/__pycache__/web_app_info.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..378c8bcb29c2def766a5104a1060f8c7babf9dc1 GIT binary patch literal 1315 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 None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + file_id=file_id, + file_unique_id=file_unique_id, + width=width, + height=height, + duration=duration, + thumbnail=thumbnail, + file_name=file_name, + mime_type=mime_type, + file_size=file_size, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/audio.py b/env/Lib/site-packages/aiogram/types/audio.py new file mode 100644 index 0000000..8c11412 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/audio.py @@ -0,0 +1,70 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .photo_size import PhotoSize + + +class Audio(TelegramObject): + """ + This object represents an audio file to be treated as music by the Telegram clients. + + Source: https://core.telegram.org/bots/api#audio + """ + + file_id: str + """Identifier for this file, which can be used to download or reuse the file""" + file_unique_id: str + """Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.""" + duration: int + """Duration of the audio in seconds as defined by the sender""" + performer: Optional[str] = None + """*Optional*. Performer of the audio as defined by the sender or by audio tags""" + title: Optional[str] = None + """*Optional*. Title of the audio as defined by the sender or by audio tags""" + file_name: Optional[str] = None + """*Optional*. Original filename as defined by the sender""" + mime_type: Optional[str] = None + """*Optional*. MIME type of the file as defined by the sender""" + file_size: Optional[int] = None + """*Optional*. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.""" + thumbnail: Optional[PhotoSize] = None + """*Optional*. Thumbnail of the album cover to which the music file belongs""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + file_id: str, + file_unique_id: str, + duration: int, + performer: Optional[str] = None, + title: Optional[str] = None, + file_name: Optional[str] = None, + mime_type: Optional[str] = None, + file_size: Optional[int] = None, + thumbnail: Optional[PhotoSize] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + file_id=file_id, + file_unique_id=file_unique_id, + duration=duration, + performer=performer, + title=title, + file_name=file_name, + mime_type=mime_type, + file_size=file_size, + thumbnail=thumbnail, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/background_fill.py b/env/Lib/site-packages/aiogram/types/background_fill.py new file mode 100644 index 0000000..dbeda46 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/background_fill.py @@ -0,0 +1,13 @@ +from .base import TelegramObject + + +class BackgroundFill(TelegramObject): + """ + This object describes the way a background is filled based on the selected colors. Currently, it can be one of + + - :class:`aiogram.types.background_fill_solid.BackgroundFillSolid` + - :class:`aiogram.types.background_fill_gradient.BackgroundFillGradient` + - :class:`aiogram.types.background_fill_freeform_gradient.BackgroundFillFreeformGradient` + + Source: https://core.telegram.org/bots/api#backgroundfill + """ diff --git a/env/Lib/site-packages/aiogram/types/background_fill_freeform_gradient.py b/env/Lib/site-packages/aiogram/types/background_fill_freeform_gradient.py new file mode 100644 index 0000000..916f6a7 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/background_fill_freeform_gradient.py @@ -0,0 +1,33 @@ +from typing import TYPE_CHECKING, Any, List, Literal + +from .background_fill import BackgroundFill + + +class BackgroundFillFreeformGradient(BackgroundFill): + """ + The background is a freeform gradient that rotates after every message in the chat. + + Source: https://core.telegram.org/bots/api#backgroundfillfreeformgradient + """ + + type: Literal["freeform_gradient"] = "freeform_gradient" + """Type of the background fill, always 'freeform_gradient'""" + colors: List[int] + """A list of the 3 or 4 base colors that are used to generate the freeform gradient in the RGB24 format""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal["freeform_gradient"] = "freeform_gradient", + colors: List[int], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, colors=colors, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/background_fill_gradient.py b/env/Lib/site-packages/aiogram/types/background_fill_gradient.py new file mode 100644 index 0000000..abc485c --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/background_fill_gradient.py @@ -0,0 +1,45 @@ +from typing import TYPE_CHECKING, Any, Literal + +from .background_fill import BackgroundFill + + +class BackgroundFillGradient(BackgroundFill): + """ + The background is a gradient fill. + + Source: https://core.telegram.org/bots/api#backgroundfillgradient + """ + + type: Literal["gradient"] = "gradient" + """Type of the background fill, always 'gradient'""" + top_color: int + """Top color of the gradient in the RGB24 format""" + bottom_color: int + """Bottom color of the gradient in the RGB24 format""" + rotation_angle: int + """Clockwise rotation angle of the background fill in degrees; 0-359""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal["gradient"] = "gradient", + top_color: int, + bottom_color: int, + rotation_angle: int, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + top_color=top_color, + bottom_color=bottom_color, + rotation_angle=rotation_angle, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/background_fill_solid.py b/env/Lib/site-packages/aiogram/types/background_fill_solid.py new file mode 100644 index 0000000..f9fe22f --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/background_fill_solid.py @@ -0,0 +1,33 @@ +from typing import TYPE_CHECKING, Any, Literal + +from .background_fill import BackgroundFill + + +class BackgroundFillSolid(BackgroundFill): + """ + The background is filled using the selected color. + + Source: https://core.telegram.org/bots/api#backgroundfillsolid + """ + + type: Literal["solid"] = "solid" + """Type of the background fill, always 'solid'""" + color: int + """The color of the background fill in the RGB24 format""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal["solid"] = "solid", + color: int, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, color=color, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/background_type.py b/env/Lib/site-packages/aiogram/types/background_type.py new file mode 100644 index 0000000..6abccef --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/background_type.py @@ -0,0 +1,14 @@ +from .base import TelegramObject + + +class BackgroundType(TelegramObject): + """ + This object describes the type of a background. Currently, it can be one of + + - :class:`aiogram.types.background_type_fill.BackgroundTypeFill` + - :class:`aiogram.types.background_type_wallpaper.BackgroundTypeWallpaper` + - :class:`aiogram.types.background_type_pattern.BackgroundTypePattern` + - :class:`aiogram.types.background_type_chat_theme.BackgroundTypeChatTheme` + + Source: https://core.telegram.org/bots/api#backgroundtype + """ diff --git a/env/Lib/site-packages/aiogram/types/background_type_chat_theme.py b/env/Lib/site-packages/aiogram/types/background_type_chat_theme.py new file mode 100644 index 0000000..ac93534 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/background_type_chat_theme.py @@ -0,0 +1,33 @@ +from typing import TYPE_CHECKING, Any, Literal + +from .background_type import BackgroundType + + +class BackgroundTypeChatTheme(BackgroundType): + """ + The background is taken directly from a built-in chat theme. + + Source: https://core.telegram.org/bots/api#backgroundtypechattheme + """ + + type: Literal["chat_theme"] = "chat_theme" + """Type of the background, always 'chat_theme'""" + theme_name: str + """Name of the chat theme, which is usually an emoji""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal["chat_theme"] = "chat_theme", + theme_name: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, theme_name=theme_name, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/background_type_fill.py b/env/Lib/site-packages/aiogram/types/background_type_fill.py new file mode 100644 index 0000000..c506e4e --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/background_type_fill.py @@ -0,0 +1,47 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Union + +from .background_type import BackgroundType + +if TYPE_CHECKING: + from .background_fill_freeform_gradient import BackgroundFillFreeformGradient + from .background_fill_gradient import BackgroundFillGradient + from .background_fill_solid import BackgroundFillSolid + + +class BackgroundTypeFill(BackgroundType): + """ + The background is automatically filled based on the selected colors. + + Source: https://core.telegram.org/bots/api#backgroundtypefill + """ + + type: Literal["fill"] = "fill" + """Type of the background, always 'fill'""" + fill: Union[BackgroundFillSolid, BackgroundFillGradient, BackgroundFillFreeformGradient] + """The background fill""" + dark_theme_dimming: int + """Dimming of the background in dark themes, as a percentage; 0-100""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal["fill"] = "fill", + fill: Union[ + BackgroundFillSolid, BackgroundFillGradient, BackgroundFillFreeformGradient + ], + dark_theme_dimming: int, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, fill=fill, dark_theme_dimming=dark_theme_dimming, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/background_type_pattern.py b/env/Lib/site-packages/aiogram/types/background_type_pattern.py new file mode 100644 index 0000000..29c383c --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/background_type_pattern.py @@ -0,0 +1,63 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional, Union + +from .background_type import BackgroundType + +if TYPE_CHECKING: + from .background_fill_freeform_gradient import BackgroundFillFreeformGradient + from .background_fill_gradient import BackgroundFillGradient + from .background_fill_solid import BackgroundFillSolid + from .document import Document + + +class BackgroundTypePattern(BackgroundType): + """ + The background is a PNG or TGV (gzipped subset of SVG with MIME type 'application/x-tgwallpattern') pattern to be combined with the background fill chosen by the user. + + Source: https://core.telegram.org/bots/api#backgroundtypepattern + """ + + type: Literal["pattern"] = "pattern" + """Type of the background, always 'pattern'""" + document: Document + """Document with the pattern""" + fill: Union[BackgroundFillSolid, BackgroundFillGradient, BackgroundFillFreeformGradient] + """The background fill that is combined with the pattern""" + intensity: int + """Intensity of the pattern when it is shown above the filled background; 0-100""" + is_inverted: Optional[bool] = None + """*Optional*. :code:`True`, if the background fill must be applied only to the pattern itself. All other pixels are black in this case. For dark themes only""" + is_moving: Optional[bool] = None + """*Optional*. :code:`True`, if the background moves slightly when the device is tilted""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal["pattern"] = "pattern", + document: Document, + fill: Union[ + BackgroundFillSolid, BackgroundFillGradient, BackgroundFillFreeformGradient + ], + intensity: int, + is_inverted: Optional[bool] = None, + is_moving: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + document=document, + fill=fill, + intensity=intensity, + is_inverted=is_inverted, + is_moving=is_moving, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/background_type_wallpaper.py b/env/Lib/site-packages/aiogram/types/background_type_wallpaper.py new file mode 100644 index 0000000..4ad2905 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/background_type_wallpaper.py @@ -0,0 +1,54 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional + +from .background_type import BackgroundType + +if TYPE_CHECKING: + from .document import Document + + +class BackgroundTypeWallpaper(BackgroundType): + """ + The background is a wallpaper in the JPEG format. + + Source: https://core.telegram.org/bots/api#backgroundtypewallpaper + """ + + type: Literal["wallpaper"] = "wallpaper" + """Type of the background, always 'wallpaper'""" + document: Document + """Document with the wallpaper""" + dark_theme_dimming: int + """Dimming of the background in dark themes, as a percentage; 0-100""" + is_blurred: Optional[bool] = None + """*Optional*. :code:`True`, if the wallpaper is downscaled to fit in a 450x450 square and then box-blurred with radius 12""" + is_moving: Optional[bool] = None + """*Optional*. :code:`True`, if the background moves slightly when the device is tilted""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal["wallpaper"] = "wallpaper", + document: Document, + dark_theme_dimming: int, + is_blurred: Optional[bool] = None, + is_moving: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + document=document, + dark_theme_dimming=dark_theme_dimming, + is_blurred=is_blurred, + is_moving=is_moving, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/base.py b/env/Lib/site-packages/aiogram/types/base.py new file mode 100644 index 0000000..7ae0052 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/base.py @@ -0,0 +1,51 @@ +from typing import Any, Dict +from unittest.mock import sentinel + +from pydantic import BaseModel, ConfigDict, model_validator + +from aiogram.client.context_controller import BotContextController +from aiogram.client.default import Default + + +class TelegramObject(BotContextController, BaseModel): + model_config = ConfigDict( + use_enum_values=True, + extra="allow", + validate_assignment=True, + frozen=True, + populate_by_name=True, + arbitrary_types_allowed=True, + defer_build=True, + ) + + @model_validator(mode="before") + @classmethod + def remove_unset(cls, values: Dict[str, Any]) -> Dict[str, Any]: + """ + Remove UNSET before fields validation. + + We use UNSET as a sentinel value for `parse_mode` and replace it to real value later. + It isn't a problem when it's just default value for a model field, + but UNSET might be passed to a model initialization from `Bot.method_name`, + so we must take care of it and remove it before fields validation. + """ + if not isinstance(values, dict): + return values + return {k: v for k, v in values.items() if not isinstance(v, UNSET_TYPE)} + + +class MutableTelegramObject(TelegramObject): + model_config = ConfigDict( + frozen=False, + ) + + +# special sentinel object which used in a situation when None might be a useful value +UNSET: Any = sentinel.UNSET +UNSET_TYPE: Any = type(UNSET) + +# Unused constants are needed only for backward compatibility with external +# libraries that a working with framework internals +UNSET_PARSE_MODE: Any = Default("parse_mode") +UNSET_DISABLE_WEB_PAGE_PREVIEW: Any = Default("link_preview_is_disabled") +UNSET_PROTECT_CONTENT: Any = Default("protect_content") diff --git a/env/Lib/site-packages/aiogram/types/birthdate.py b/env/Lib/site-packages/aiogram/types/birthdate.py new file mode 100644 index 0000000..6955554 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/birthdate.py @@ -0,0 +1,38 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + + +class Birthdate(TelegramObject): + """ + Describes the birthdate of a user. + + Source: https://core.telegram.org/bots/api#birthdate + """ + + day: int + """Day of the user's birth; 1-31""" + month: int + """Month of the user's birth; 1-12""" + year: Optional[int] = None + """*Optional*. Year of the user's birth""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + day: int, + month: int, + year: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(day=day, month=month, year=year, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/bot_command.py b/env/Lib/site-packages/aiogram/types/bot_command.py new file mode 100644 index 0000000..e4e9175 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/bot_command.py @@ -0,0 +1,31 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import MutableTelegramObject + + +class BotCommand(MutableTelegramObject): + """ + This object represents a bot command. + + Source: https://core.telegram.org/bots/api#botcommand + """ + + command: str + """Text of the command; 1-32 characters. Can contain only lowercase English letters, digits and underscores.""" + description: str + """Description of the command; 1-256 characters.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, command: str, description: str, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(command=command, description=description, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/bot_command_scope.py b/env/Lib/site-packages/aiogram/types/bot_command_scope.py new file mode 100644 index 0000000..dfb1d52 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/bot_command_scope.py @@ -0,0 +1,19 @@ +from __future__ import annotations + +from .base import TelegramObject + + +class BotCommandScope(TelegramObject): + """ + This object represents the scope to which bot commands are applied. Currently, the following 7 scopes are supported: + + - :class:`aiogram.types.bot_command_scope_default.BotCommandScopeDefault` + - :class:`aiogram.types.bot_command_scope_all_private_chats.BotCommandScopeAllPrivateChats` + - :class:`aiogram.types.bot_command_scope_all_group_chats.BotCommandScopeAllGroupChats` + - :class:`aiogram.types.bot_command_scope_all_chat_administrators.BotCommandScopeAllChatAdministrators` + - :class:`aiogram.types.bot_command_scope_chat.BotCommandScopeChat` + - :class:`aiogram.types.bot_command_scope_chat_administrators.BotCommandScopeChatAdministrators` + - :class:`aiogram.types.bot_command_scope_chat_member.BotCommandScopeChatMember` + + Source: https://core.telegram.org/bots/api#botcommandscope + """ diff --git a/env/Lib/site-packages/aiogram/types/bot_command_scope_all_chat_administrators.py b/env/Lib/site-packages/aiogram/types/bot_command_scope_all_chat_administrators.py new file mode 100644 index 0000000..4417363 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/bot_command_scope_all_chat_administrators.py @@ -0,0 +1,37 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import BotCommandScopeType +from .bot_command_scope import BotCommandScope + + +class BotCommandScopeAllChatAdministrators(BotCommandScope): + """ + Represents the `scope `_ of bot commands, covering all group and supergroup chat administrators. + + Source: https://core.telegram.org/bots/api#botcommandscopeallchatadministrators + """ + + type: Literal[BotCommandScopeType.ALL_CHAT_ADMINISTRATORS] = ( + BotCommandScopeType.ALL_CHAT_ADMINISTRATORS + ) + """Scope type, must be *all_chat_administrators*""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[ + BotCommandScopeType.ALL_CHAT_ADMINISTRATORS + ] = BotCommandScopeType.ALL_CHAT_ADMINISTRATORS, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/bot_command_scope_all_group_chats.py b/env/Lib/site-packages/aiogram/types/bot_command_scope_all_group_chats.py new file mode 100644 index 0000000..a17a51d --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/bot_command_scope_all_group_chats.py @@ -0,0 +1,35 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import BotCommandScopeType +from .bot_command_scope import BotCommandScope + + +class BotCommandScopeAllGroupChats(BotCommandScope): + """ + Represents the `scope `_ of bot commands, covering all group and supergroup chats. + + Source: https://core.telegram.org/bots/api#botcommandscopeallgroupchats + """ + + type: Literal[BotCommandScopeType.ALL_GROUP_CHATS] = BotCommandScopeType.ALL_GROUP_CHATS + """Scope type, must be *all_group_chats*""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[ + BotCommandScopeType.ALL_GROUP_CHATS + ] = BotCommandScopeType.ALL_GROUP_CHATS, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/bot_command_scope_all_private_chats.py b/env/Lib/site-packages/aiogram/types/bot_command_scope_all_private_chats.py new file mode 100644 index 0000000..54d406f --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/bot_command_scope_all_private_chats.py @@ -0,0 +1,35 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import BotCommandScopeType +from .bot_command_scope import BotCommandScope + + +class BotCommandScopeAllPrivateChats(BotCommandScope): + """ + Represents the `scope `_ of bot commands, covering all private chats. + + Source: https://core.telegram.org/bots/api#botcommandscopeallprivatechats + """ + + type: Literal[BotCommandScopeType.ALL_PRIVATE_CHATS] = BotCommandScopeType.ALL_PRIVATE_CHATS + """Scope type, must be *all_private_chats*""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[ + BotCommandScopeType.ALL_PRIVATE_CHATS + ] = BotCommandScopeType.ALL_PRIVATE_CHATS, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/bot_command_scope_chat.py b/env/Lib/site-packages/aiogram/types/bot_command_scope_chat.py new file mode 100644 index 0000000..f36c4a1 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/bot_command_scope_chat.py @@ -0,0 +1,36 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Union + +from ..enums import BotCommandScopeType +from .bot_command_scope import BotCommandScope + + +class BotCommandScopeChat(BotCommandScope): + """ + Represents the `scope `_ of bot commands, covering a specific chat. + + Source: https://core.telegram.org/bots/api#botcommandscopechat + """ + + type: Literal[BotCommandScopeType.CHAT] = BotCommandScopeType.CHAT + """Scope type, must be *chat*""" + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[BotCommandScopeType.CHAT] = BotCommandScopeType.CHAT, + chat_id: Union[int, str], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, chat_id=chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/bot_command_scope_chat_administrators.py b/env/Lib/site-packages/aiogram/types/bot_command_scope_chat_administrators.py new file mode 100644 index 0000000..f90623e --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/bot_command_scope_chat_administrators.py @@ -0,0 +1,40 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Union + +from ..enums import BotCommandScopeType +from .bot_command_scope import BotCommandScope + + +class BotCommandScopeChatAdministrators(BotCommandScope): + """ + Represents the `scope `_ of bot commands, covering all administrators of a specific group or supergroup chat. + + Source: https://core.telegram.org/bots/api#botcommandscopechatadministrators + """ + + type: Literal[BotCommandScopeType.CHAT_ADMINISTRATORS] = ( + BotCommandScopeType.CHAT_ADMINISTRATORS + ) + """Scope type, must be *chat_administrators*""" + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[ + BotCommandScopeType.CHAT_ADMINISTRATORS + ] = BotCommandScopeType.CHAT_ADMINISTRATORS, + chat_id: Union[int, str], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, chat_id=chat_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/bot_command_scope_chat_member.py b/env/Lib/site-packages/aiogram/types/bot_command_scope_chat_member.py new file mode 100644 index 0000000..4d20b1f --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/bot_command_scope_chat_member.py @@ -0,0 +1,39 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Union + +from ..enums import BotCommandScopeType +from .bot_command_scope import BotCommandScope + + +class BotCommandScopeChatMember(BotCommandScope): + """ + Represents the `scope `_ of bot commands, covering a specific member of a group or supergroup chat. + + Source: https://core.telegram.org/bots/api#botcommandscopechatmember + """ + + type: Literal[BotCommandScopeType.CHAT_MEMBER] = BotCommandScopeType.CHAT_MEMBER + """Scope type, must be *chat_member*""" + chat_id: Union[int, str] + """Unique identifier for the target chat or username of the target supergroup (in the format :code:`@supergroupusername`)""" + user_id: int + """Unique identifier of the target user""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[BotCommandScopeType.CHAT_MEMBER] = BotCommandScopeType.CHAT_MEMBER, + chat_id: Union[int, str], + user_id: int, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, chat_id=chat_id, user_id=user_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/bot_command_scope_default.py b/env/Lib/site-packages/aiogram/types/bot_command_scope_default.py new file mode 100644 index 0000000..33b7a0c --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/bot_command_scope_default.py @@ -0,0 +1,33 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import BotCommandScopeType +from .bot_command_scope import BotCommandScope + + +class BotCommandScopeDefault(BotCommandScope): + """ + Represents the default `scope `_ of bot commands. Default commands are used if no commands with a `narrower scope `_ are specified for the user. + + Source: https://core.telegram.org/bots/api#botcommandscopedefault + """ + + type: Literal[BotCommandScopeType.DEFAULT] = BotCommandScopeType.DEFAULT + """Scope type, must be *default*""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[BotCommandScopeType.DEFAULT] = BotCommandScopeType.DEFAULT, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/bot_description.py b/env/Lib/site-packages/aiogram/types/bot_description.py new file mode 100644 index 0000000..5d8646d --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/bot_description.py @@ -0,0 +1,25 @@ +from typing import TYPE_CHECKING, Any + +from aiogram.types import TelegramObject + + +class BotDescription(TelegramObject): + """ + This object represents the bot's description. + + Source: https://core.telegram.org/bots/api#botdescription + """ + + description: str + """The bot's description""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__(__pydantic__self__, *, description: str, **__pydantic_kwargs: Any) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(description=description, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/bot_name.py b/env/Lib/site-packages/aiogram/types/bot_name.py new file mode 100644 index 0000000..f2dc074 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/bot_name.py @@ -0,0 +1,25 @@ +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + + +class BotName(TelegramObject): + """ + This object represents the bot's name. + + Source: https://core.telegram.org/bots/api#botname + """ + + name: str + """The bot's name""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__(__pydantic__self__, *, name: str, **__pydantic_kwargs: Any) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(name=name, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/bot_short_description.py b/env/Lib/site-packages/aiogram/types/bot_short_description.py new file mode 100644 index 0000000..86b11cf --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/bot_short_description.py @@ -0,0 +1,27 @@ +from typing import TYPE_CHECKING, Any + +from aiogram.types import TelegramObject + + +class BotShortDescription(TelegramObject): + """ + This object represents the bot's short description. + + Source: https://core.telegram.org/bots/api#botshortdescription + """ + + short_description: str + """The bot's short description""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, short_description: str, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(short_description=short_description, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/business_connection.py b/env/Lib/site-packages/aiogram/types/business_connection.py new file mode 100644 index 0000000..80c472a --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/business_connection.py @@ -0,0 +1,59 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject +from .custom import DateTime + +if TYPE_CHECKING: + from .user import User + + +class BusinessConnection(TelegramObject): + """ + Describes the connection of the bot with a business account. + + Source: https://core.telegram.org/bots/api#businessconnection + """ + + id: str + """Unique identifier of the business connection""" + user: User + """Business account user that created the business connection""" + user_chat_id: int + """Identifier of a private chat with the user who created the business connection. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a 64-bit integer or double-precision float type are safe for storing this identifier.""" + date: DateTime + """Date the connection was established in Unix time""" + can_reply: bool + """True, if the bot can act on behalf of the business account in chats that were active in the last 24 hours""" + is_enabled: bool + """True, if the connection is active""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + id: str, + user: User, + user_chat_id: int, + date: DateTime, + can_reply: bool, + is_enabled: bool, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + id=id, + user=user, + user_chat_id=user_chat_id, + date=date, + can_reply=can_reply, + is_enabled=is_enabled, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/business_intro.py b/env/Lib/site-packages/aiogram/types/business_intro.py new file mode 100644 index 0000000..c360fbe --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/business_intro.py @@ -0,0 +1,41 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .sticker import Sticker + + +class BusinessIntro(TelegramObject): + """ + Contains information about the start page settings of a Telegram Business account. + + Source: https://core.telegram.org/bots/api#businessintro + """ + + title: Optional[str] = None + """*Optional*. Title text of the business intro""" + message: Optional[str] = None + """*Optional*. Message text of the business intro""" + sticker: Optional[Sticker] = None + """*Optional*. Sticker of the business intro""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + title: Optional[str] = None, + message: Optional[str] = None, + sticker: Optional[Sticker] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(title=title, message=message, sticker=sticker, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/business_location.py b/env/Lib/site-packages/aiogram/types/business_location.py new file mode 100644 index 0000000..af7989a --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/business_location.py @@ -0,0 +1,38 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .location import Location + + +class BusinessLocation(TelegramObject): + """ + Contains information about the location of a Telegram Business account. + + Source: https://core.telegram.org/bots/api#businesslocation + """ + + address: str + """Address of the business""" + location: Optional[Location] = None + """*Optional*. Location of the business""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + address: str, + location: Optional[Location] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(address=address, location=location, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/business_messages_deleted.py b/env/Lib/site-packages/aiogram/types/business_messages_deleted.py new file mode 100644 index 0000000..44bc45f --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/business_messages_deleted.py @@ -0,0 +1,46 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List + +from .base import TelegramObject + +if TYPE_CHECKING: + from .chat import Chat + + +class BusinessMessagesDeleted(TelegramObject): + """ + This object is received when messages are deleted from a connected business account. + + Source: https://core.telegram.org/bots/api#businessmessagesdeleted + """ + + business_connection_id: str + """Unique identifier of the business connection""" + chat: Chat + """Information about a chat in the business account. The bot may not have access to the chat or the corresponding user.""" + message_ids: List[int] + """The list of identifiers of deleted messages in the chat of the business account""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + business_connection_id: str, + chat: Chat, + message_ids: List[int], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + business_connection_id=business_connection_id, + chat=chat, + message_ids=message_ids, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/business_opening_hours.py b/env/Lib/site-packages/aiogram/types/business_opening_hours.py new file mode 100644 index 0000000..7fd5c75 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/business_opening_hours.py @@ -0,0 +1,40 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List + +from .base import TelegramObject + +if TYPE_CHECKING: + from .business_opening_hours_interval import BusinessOpeningHoursInterval + + +class BusinessOpeningHours(TelegramObject): + """ + Describes the opening hours of a business. + + Source: https://core.telegram.org/bots/api#businessopeninghours + """ + + time_zone_name: str + """Unique name of the time zone for which the opening hours are defined""" + opening_hours: List[BusinessOpeningHoursInterval] + """List of time intervals describing business opening hours""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + time_zone_name: str, + opening_hours: List[BusinessOpeningHoursInterval], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + time_zone_name=time_zone_name, opening_hours=opening_hours, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/business_opening_hours_interval.py b/env/Lib/site-packages/aiogram/types/business_opening_hours_interval.py new file mode 100644 index 0000000..52efd2c --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/business_opening_hours_interval.py @@ -0,0 +1,37 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + + +class BusinessOpeningHoursInterval(TelegramObject): + """ + Describes an interval of time during which a business is open. + + Source: https://core.telegram.org/bots/api#businessopeninghoursinterval + """ + + opening_minute: int + """The minute's sequence number in a week, starting on Monday, marking the start of the time interval during which the business is open; 0 - 7 * 24 * 60""" + closing_minute: int + """The minute's sequence number in a week, starting on Monday, marking the end of the time interval during which the business is open; 0 - 8 * 24 * 60""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + opening_minute: int, + closing_minute: int, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + opening_minute=opening_minute, closing_minute=closing_minute, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/callback_game.py b/env/Lib/site-packages/aiogram/types/callback_game.py new file mode 100644 index 0000000..6d8c556 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/callback_game.py @@ -0,0 +1,11 @@ +from __future__ import annotations + +from .base import TelegramObject + + +class CallbackGame(TelegramObject): + """ + A placeholder, currently holds no information. Use `BotFather `_ to set up your game. + + Source: https://core.telegram.org/bots/api#callbackgame + """ diff --git a/env/Lib/site-packages/aiogram/types/callback_query.py b/env/Lib/site-packages/aiogram/types/callback_query.py new file mode 100644 index 0000000..c3b33b5 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/callback_query.py @@ -0,0 +1,109 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from pydantic import Field + +from .base import TelegramObject + +if TYPE_CHECKING: + from ..methods import AnswerCallbackQuery + from .inaccessible_message import InaccessibleMessage + from .message import Message + from .user import User + + +class CallbackQuery(TelegramObject): + """ + This object represents an incoming callback query from a callback button in an `inline keyboard `_. If the button that originated the query was attached to a message sent by the bot, the field *message* will be present. If the button was attached to a message sent via the bot (in `inline mode `_), the field *inline_message_id* will be present. Exactly one of the fields *data* or *game_short_name* will be present. + + **NOTE:** After the user presses a callback button, Telegram clients will display a progress bar until you call :class:`aiogram.methods.answer_callback_query.AnswerCallbackQuery`. It is, therefore, necessary to react by calling :class:`aiogram.methods.answer_callback_query.AnswerCallbackQuery` even if no notification to the user is needed (e.g., without specifying any of the optional parameters). + + Source: https://core.telegram.org/bots/api#callbackquery + """ + + id: str + """Unique identifier for this query""" + from_user: User = Field(..., alias="from") + """Sender""" + chat_instance: str + """Global identifier, uniquely corresponding to the chat to which the message with the callback button was sent. Useful for high scores in :class:`aiogram.methods.games.Games`.""" + message: Optional[Union[Message, InaccessibleMessage]] = None + """*Optional*. Message sent by the bot with the callback button that originated the query""" + inline_message_id: Optional[str] = None + """*Optional*. Identifier of the message sent via the bot in inline mode, that originated the query.""" + data: Optional[str] = None + """*Optional*. Data associated with the callback button. Be aware that the message originated the query can contain no callback buttons with this data.""" + game_short_name: Optional[str] = None + """*Optional*. Short name of a `Game `_ to be returned, serves as the unique identifier for the game""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + id: str, + from_user: User, + chat_instance: str, + message: Optional[Union[Message, InaccessibleMessage]] = None, + inline_message_id: Optional[str] = None, + data: Optional[str] = None, + game_short_name: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + id=id, + from_user=from_user, + chat_instance=chat_instance, + message=message, + inline_message_id=inline_message_id, + data=data, + game_short_name=game_short_name, + **__pydantic_kwargs, + ) + + def answer( + self, + text: Optional[str] = None, + show_alert: Optional[bool] = None, + url: Optional[str] = None, + cache_time: Optional[int] = None, + **kwargs: Any, + ) -> AnswerCallbackQuery: + """ + Shortcut for method :class:`aiogram.methods.answer_callback_query.AnswerCallbackQuery` + will automatically fill method attributes: + + - :code:`callback_query_id` + + Use this method to send answers to callback queries sent from `inline keyboards `_. The answer will be displayed to the user as a notification at the top of the chat screen or as an alert. On success, :code:`True` is returned. + + Alternatively, the user can be redirected to the specified Game URL. For this option to work, you must first create a game for your bot via `@BotFather `_ and accept the terms. Otherwise, you may use links like :code:`t.me/your_bot?start=XXXX` that open your bot with a parameter. + + Source: https://core.telegram.org/bots/api#answercallbackquery + + :param text: Text of the notification. If not specified, nothing will be shown to the user, 0-200 characters + :param show_alert: If :code:`True`, an alert will be shown by the client instead of a notification at the top of the chat screen. Defaults to *false*. + :param url: URL that will be opened by the user's client. If you have created a :class:`aiogram.types.game.Game` and accepted the conditions via `@BotFather `_, specify the URL that opens your game - note that this will only work if the query comes from a `https://core.telegram.org/bots/api#inlinekeyboardbutton `_ *callback_game* button. + :param cache_time: The maximum amount of time in seconds that the result of the callback query may be cached client-side. Telegram apps will support caching starting in version 3.14. Defaults to 0. + :return: instance of method :class:`aiogram.methods.answer_callback_query.AnswerCallbackQuery` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import AnswerCallbackQuery + + return AnswerCallbackQuery( + callback_query_id=self.id, + text=text, + show_alert=show_alert, + url=url, + cache_time=cache_time, + **kwargs, + ).as_(self._bot) diff --git a/env/Lib/site-packages/aiogram/types/chat.py b/env/Lib/site-packages/aiogram/types/chat.py new file mode 100644 index 0000000..c4feba4 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat.py @@ -0,0 +1,1320 @@ +from __future__ import annotations + +import datetime +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from .base import TelegramObject +from .custom import DateTime + +if TYPE_CHECKING: + from ..methods import ( + BanChatMember, + BanChatSenderChat, + CreateChatInviteLink, + DeleteChatPhoto, + DeleteChatStickerSet, + DeleteMessage, + EditChatInviteLink, + ExportChatInviteLink, + GetChatAdministrators, + GetChatMember, + GetChatMemberCount, + LeaveChat, + PinChatMessage, + PromoteChatMember, + RestrictChatMember, + RevokeChatInviteLink, + SendChatAction, + SetChatAdministratorCustomTitle, + SetChatDescription, + SetChatPermissions, + SetChatPhoto, + SetChatStickerSet, + SetChatTitle, + UnbanChatMember, + UnbanChatSenderChat, + UnpinAllChatMessages, + UnpinAllGeneralForumTopicMessages, + UnpinChatMessage, + ) + from .birthdate import Birthdate + from .business_intro import BusinessIntro + from .business_location import BusinessLocation + from .business_opening_hours import BusinessOpeningHours + from .chat_location import ChatLocation + from .chat_permissions import ChatPermissions + from .chat_photo import ChatPhoto + from .input_file import InputFile + from .message import Message + from .reaction_type_custom_emoji import ReactionTypeCustomEmoji + from .reaction_type_emoji import ReactionTypeEmoji + from .reaction_type_paid import ReactionTypePaid + + +class Chat(TelegramObject): + """ + This object represents a chat. + + Source: https://core.telegram.org/bots/api#chat + """ + + id: int + """Unique identifier for this chat. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this identifier.""" + type: str + """Type of the chat, can be either 'private', 'group', 'supergroup' or 'channel'""" + title: Optional[str] = None + """*Optional*. Title, for supergroups, channels and group chats""" + username: Optional[str] = None + """*Optional*. Username, for private chats, supergroups and channels if available""" + first_name: Optional[str] = None + """*Optional*. First name of the other party in a private chat""" + last_name: Optional[str] = None + """*Optional*. Last name of the other party in a private chat""" + is_forum: Optional[bool] = None + """*Optional*. :code:`True`, if the supergroup chat is a forum (has `topics `_ enabled)""" + accent_color_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. Identifier of the accent color for the chat name and backgrounds of the chat photo, reply header, and link preview. See `accent colors `_ for more details. Returned only in :class:`aiogram.methods.get_chat.GetChat`. Always returned in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + active_usernames: Optional[List[str]] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. If non-empty, the list of all `active chat usernames `_; for private chats, supergroups and channels. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + available_reactions: Optional[ + List[Union[ReactionTypeEmoji, ReactionTypeCustomEmoji, ReactionTypePaid]] + ] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. List of available reactions allowed in the chat. If omitted, then all `emoji reactions `_ are allowed. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + background_custom_emoji_id: Optional[str] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. Custom emoji identifier of emoji chosen by the chat for the reply header and link preview background. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + bio: Optional[str] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. Bio of the other party in a private chat. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + birthdate: Optional[Birthdate] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. For private chats, the date of birth of the user. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + business_intro: Optional[BusinessIntro] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. For private chats with business accounts, the intro of the business. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + business_location: Optional[BusinessLocation] = Field( + None, json_schema_extra={"deprecated": True} + ) + """*Optional*. For private chats with business accounts, the location of the business. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + business_opening_hours: Optional[BusinessOpeningHours] = Field( + None, json_schema_extra={"deprecated": True} + ) + """*Optional*. For private chats with business accounts, the opening hours of the business. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + can_set_sticker_set: Optional[bool] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. :code:`True`, if the bot can change the group sticker set. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + custom_emoji_sticker_set_name: Optional[str] = Field( + None, json_schema_extra={"deprecated": True} + ) + """*Optional*. For supergroups, the name of the group's custom emoji sticker set. Custom emoji from this set can be used by all users and bots in the group. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + description: Optional[str] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. Description, for groups, supergroups and channel chats. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + emoji_status_custom_emoji_id: Optional[str] = Field( + None, json_schema_extra={"deprecated": True} + ) + """*Optional*. Custom emoji identifier of the emoji status of the chat or the other party in a private chat. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + emoji_status_expiration_date: Optional[DateTime] = Field( + None, json_schema_extra={"deprecated": True} + ) + """*Optional*. Expiration date of the emoji status of the chat or the other party in a private chat, in Unix time, if any. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + has_aggressive_anti_spam_enabled: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """*Optional*. :code:`True`, if aggressive anti-spam checks are enabled in the supergroup. The field is only available to chat administrators. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + has_hidden_members: Optional[bool] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. :code:`True`, if non-administrators can only get the list of bots and administrators in the chat. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + has_private_forwards: Optional[bool] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. :code:`True`, if privacy settings of the other party in the private chat allows to use :code:`tg://user?id=` links only in chats with the user. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + has_protected_content: Optional[bool] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. :code:`True`, if messages from the chat can't be forwarded to other chats. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + has_restricted_voice_and_video_messages: Optional[bool] = Field( + None, json_schema_extra={"deprecated": True} + ) + """*Optional*. :code:`True`, if the privacy settings of the other party restrict sending voice and video note messages in the private chat. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + has_visible_history: Optional[bool] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. :code:`True`, if new chat members will have access to old messages; available only to chat administrators. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + invite_link: Optional[str] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. Primary invite link, for groups, supergroups and channel chats. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + join_by_request: Optional[bool] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. :code:`True`, if all users directly joining the supergroup need to be approved by supergroup administrators. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + join_to_send_messages: Optional[bool] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. :code:`True`, if users need to join the supergroup before they can send messages. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + linked_chat_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. This identifier may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it is smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + location: Optional[ChatLocation] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. For supergroups, the location to which the supergroup is connected. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + message_auto_delete_time: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. The time after which all messages sent to the chat will be automatically deleted; in seconds. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + permissions: Optional[ChatPermissions] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. Default chat member permissions, for groups and supergroups. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + personal_chat: Optional[Chat] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. For private chats, the personal channel of the user. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + photo: Optional[ChatPhoto] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. Chat photo. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + pinned_message: Optional[Message] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. The most recent pinned message (by sending date). Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + profile_accent_color_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. Identifier of the accent color for the chat's profile background. See `profile accent colors `_ for more details. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + profile_background_custom_emoji_id: Optional[str] = Field( + None, json_schema_extra={"deprecated": True} + ) + """*Optional*. Custom emoji identifier of the emoji chosen by the chat for its profile background. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + slow_mode_delay: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user; in seconds. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + sticker_set_name: Optional[str] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. For supergroups, name of group sticker set. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + unrestrict_boost_count: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions. Returned only in :class:`aiogram.methods.get_chat.GetChat`. + +.. deprecated:: API:7.3 + https://core.telegram.org/bots/api-changelog#may-6-2024""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + id: int, + type: str, + title: Optional[str] = None, + username: Optional[str] = None, + first_name: Optional[str] = None, + last_name: Optional[str] = None, + is_forum: Optional[bool] = None, + accent_color_id: Optional[int] = None, + active_usernames: Optional[List[str]] = None, + available_reactions: Optional[ + List[Union[ReactionTypeEmoji, ReactionTypeCustomEmoji, ReactionTypePaid]] + ] = None, + background_custom_emoji_id: Optional[str] = None, + bio: Optional[str] = None, + birthdate: Optional[Birthdate] = None, + business_intro: Optional[BusinessIntro] = None, + business_location: Optional[BusinessLocation] = None, + business_opening_hours: Optional[BusinessOpeningHours] = None, + can_set_sticker_set: Optional[bool] = None, + custom_emoji_sticker_set_name: Optional[str] = None, + description: Optional[str] = None, + emoji_status_custom_emoji_id: Optional[str] = None, + emoji_status_expiration_date: Optional[DateTime] = None, + has_aggressive_anti_spam_enabled: Optional[bool] = None, + has_hidden_members: Optional[bool] = None, + has_private_forwards: Optional[bool] = None, + has_protected_content: Optional[bool] = None, + has_restricted_voice_and_video_messages: Optional[bool] = None, + has_visible_history: Optional[bool] = None, + invite_link: Optional[str] = None, + join_by_request: Optional[bool] = None, + join_to_send_messages: Optional[bool] = None, + linked_chat_id: Optional[int] = None, + location: Optional[ChatLocation] = None, + message_auto_delete_time: Optional[int] = None, + permissions: Optional[ChatPermissions] = None, + personal_chat: Optional[Chat] = None, + photo: Optional[ChatPhoto] = None, + pinned_message: Optional[Message] = None, + profile_accent_color_id: Optional[int] = None, + profile_background_custom_emoji_id: Optional[str] = None, + slow_mode_delay: Optional[int] = None, + sticker_set_name: Optional[str] = None, + unrestrict_boost_count: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + id=id, + type=type, + title=title, + username=username, + first_name=first_name, + last_name=last_name, + is_forum=is_forum, + accent_color_id=accent_color_id, + active_usernames=active_usernames, + available_reactions=available_reactions, + background_custom_emoji_id=background_custom_emoji_id, + bio=bio, + birthdate=birthdate, + business_intro=business_intro, + business_location=business_location, + business_opening_hours=business_opening_hours, + can_set_sticker_set=can_set_sticker_set, + custom_emoji_sticker_set_name=custom_emoji_sticker_set_name, + description=description, + emoji_status_custom_emoji_id=emoji_status_custom_emoji_id, + emoji_status_expiration_date=emoji_status_expiration_date, + has_aggressive_anti_spam_enabled=has_aggressive_anti_spam_enabled, + has_hidden_members=has_hidden_members, + has_private_forwards=has_private_forwards, + has_protected_content=has_protected_content, + has_restricted_voice_and_video_messages=has_restricted_voice_and_video_messages, + has_visible_history=has_visible_history, + invite_link=invite_link, + join_by_request=join_by_request, + join_to_send_messages=join_to_send_messages, + linked_chat_id=linked_chat_id, + location=location, + message_auto_delete_time=message_auto_delete_time, + permissions=permissions, + personal_chat=personal_chat, + photo=photo, + pinned_message=pinned_message, + profile_accent_color_id=profile_accent_color_id, + profile_background_custom_emoji_id=profile_background_custom_emoji_id, + slow_mode_delay=slow_mode_delay, + sticker_set_name=sticker_set_name, + unrestrict_boost_count=unrestrict_boost_count, + **__pydantic_kwargs, + ) + + @property + def shifted_id(self) -> int: + """ + Returns shifted chat ID (positive and without "-100" prefix). + Mostly used for private links like t.me/c/chat_id/message_id + + Currently supergroup/channel IDs have 10-digit ID after "-100" prefix removed. + However, these IDs might become 11-digit in future. So, first we remove "-100" + prefix and count remaining number length. Then we multiple + -1 * 10 ^ (number_length + 2) + Finally, self.id is substracted from that number + """ + short_id = str(self.id).replace("-100", "") + shift = int(-1 * pow(10, len(short_id) + 2)) + return shift - self.id + + @property + def full_name(self) -> str: + """Get full name of the Chat. + + For private chat it is first_name + last_name. + For other chat types it is title. + """ + if self.title is not None: + return self.title + + if self.last_name is not None: + return f"{self.first_name} {self.last_name}" + + return f"{self.first_name}" + + def ban_sender_chat( + self, + sender_chat_id: int, + **kwargs: Any, + ) -> BanChatSenderChat: + """ + Shortcut for method :class:`aiogram.methods.ban_chat_sender_chat.BanChatSenderChat` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to ban a channel chat in a supergroup or a channel. Until the chat is `unbanned `_, the owner of the banned chat won't be able to send messages on behalf of **any of their channels**. The bot must be an administrator in the supergroup or channel for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#banchatsenderchat + + :param sender_chat_id: Unique identifier of the target sender chat + :return: instance of method :class:`aiogram.methods.ban_chat_sender_chat.BanChatSenderChat` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import BanChatSenderChat + + return BanChatSenderChat( + chat_id=self.id, + sender_chat_id=sender_chat_id, + **kwargs, + ).as_(self._bot) + + def unban_sender_chat( + self, + sender_chat_id: int, + **kwargs: Any, + ) -> UnbanChatSenderChat: + """ + Shortcut for method :class:`aiogram.methods.unban_chat_sender_chat.UnbanChatSenderChat` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to unban a previously banned channel chat in a supergroup or channel. The bot must be an administrator for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unbanchatsenderchat + + :param sender_chat_id: Unique identifier of the target sender chat + :return: instance of method :class:`aiogram.methods.unban_chat_sender_chat.UnbanChatSenderChat` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import UnbanChatSenderChat + + return UnbanChatSenderChat( + chat_id=self.id, + sender_chat_id=sender_chat_id, + **kwargs, + ).as_(self._bot) + + def get_administrators( + self, + **kwargs: Any, + ) -> GetChatAdministrators: + """ + Shortcut for method :class:`aiogram.methods.get_chat_administrators.GetChatAdministrators` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to get a list of administrators in a chat, which aren't bots. Returns an Array of :class:`aiogram.types.chat_member.ChatMember` objects. + + Source: https://core.telegram.org/bots/api#getchatadministrators + + :return: instance of method :class:`aiogram.methods.get_chat_administrators.GetChatAdministrators` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import GetChatAdministrators + + return GetChatAdministrators( + chat_id=self.id, + **kwargs, + ).as_(self._bot) + + def delete_message( + self, + message_id: int, + **kwargs: Any, + ) -> DeleteMessage: + """ + Shortcut for method :class:`aiogram.methods.delete_message.DeleteMessage` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to delete a message, including service messages, with the following limitations: + + - A message can only be deleted if it was sent less than 48 hours ago. + + - Service messages about a supergroup, channel, or forum topic creation can't be deleted. + + - A dice message in a private chat can only be deleted if it was sent more than 24 hours ago. + + - Bots can delete outgoing messages in private chats, groups, and supergroups. + + - Bots can delete incoming messages in private chats. + + - Bots granted *can_post_messages* permissions can delete outgoing messages in channels. + + - If the bot is an administrator of a group, it can delete any message there. + + - If the bot has *can_delete_messages* permission in a supergroup or a channel, it can delete any message there. + + Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletemessage + + :param message_id: Identifier of the message to delete + :return: instance of method :class:`aiogram.methods.delete_message.DeleteMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import DeleteMessage + + return DeleteMessage( + chat_id=self.id, + message_id=message_id, + **kwargs, + ).as_(self._bot) + + def revoke_invite_link( + self, + invite_link: str, + **kwargs: Any, + ) -> RevokeChatInviteLink: + """ + Shortcut for method :class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to revoke an invite link created by the bot. If the primary link is revoked, a new link is automatically generated. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the revoked invite link as :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + + Source: https://core.telegram.org/bots/api#revokechatinvitelink + + :param invite_link: The invite link to revoke + :return: instance of method :class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import RevokeChatInviteLink + + return RevokeChatInviteLink( + chat_id=self.id, + invite_link=invite_link, + **kwargs, + ).as_(self._bot) + + def edit_invite_link( + self, + invite_link: str, + name: Optional[str] = None, + expire_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + member_limit: Optional[int] = None, + creates_join_request: Optional[bool] = None, + **kwargs: Any, + ) -> EditChatInviteLink: + """ + Shortcut for method :class:`aiogram.methods.edit_chat_invite_link.EditChatInviteLink` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to edit a non-primary invite link created by the bot. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the edited invite link as a :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + + Source: https://core.telegram.org/bots/api#editchatinvitelink + + :param invite_link: The invite link to edit + :param name: Invite link name; 0-32 characters + :param expire_date: Point in time (Unix timestamp) when the link will expire + :param member_limit: The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 + :param creates_join_request: :code:`True`, if users joining the chat via the link need to be approved by chat administrators. If :code:`True`, *member_limit* can't be specified + :return: instance of method :class:`aiogram.methods.edit_chat_invite_link.EditChatInviteLink` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import EditChatInviteLink + + return EditChatInviteLink( + chat_id=self.id, + invite_link=invite_link, + name=name, + expire_date=expire_date, + member_limit=member_limit, + creates_join_request=creates_join_request, + **kwargs, + ).as_(self._bot) + + def create_invite_link( + self, + name: Optional[str] = None, + expire_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + member_limit: Optional[int] = None, + creates_join_request: Optional[bool] = None, + **kwargs: Any, + ) -> CreateChatInviteLink: + """ + Shortcut for method :class:`aiogram.methods.create_chat_invite_link.CreateChatInviteLink` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to create an additional invite link for a chat. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. The link can be revoked using the method :class:`aiogram.methods.revoke_chat_invite_link.RevokeChatInviteLink`. Returns the new invite link as :class:`aiogram.types.chat_invite_link.ChatInviteLink` object. + + Source: https://core.telegram.org/bots/api#createchatinvitelink + + :param name: Invite link name; 0-32 characters + :param expire_date: Point in time (Unix timestamp) when the link will expire + :param member_limit: The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 + :param creates_join_request: :code:`True`, if users joining the chat via the link need to be approved by chat administrators. If :code:`True`, *member_limit* can't be specified + :return: instance of method :class:`aiogram.methods.create_chat_invite_link.CreateChatInviteLink` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import CreateChatInviteLink + + return CreateChatInviteLink( + chat_id=self.id, + name=name, + expire_date=expire_date, + member_limit=member_limit, + creates_join_request=creates_join_request, + **kwargs, + ).as_(self._bot) + + def export_invite_link( + self, + **kwargs: Any, + ) -> ExportChatInviteLink: + """ + Shortcut for method :class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to generate a new primary invite link for a chat; any previously generated primary link is revoked. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the new invite link as *String* on success. + + Note: Each administrator in a chat generates their own invite links. Bots can't use invite links generated by other administrators. If you want your bot to work with invite links, it will need to generate its own link using :class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` or by calling the :class:`aiogram.methods.get_chat.GetChat` method. If your bot needs to generate a new primary invite link replacing its previous one, use :class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` again. + + Source: https://core.telegram.org/bots/api#exportchatinvitelink + + :return: instance of method :class:`aiogram.methods.export_chat_invite_link.ExportChatInviteLink` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import ExportChatInviteLink + + return ExportChatInviteLink( + chat_id=self.id, + **kwargs, + ).as_(self._bot) + + def do( + self, + action: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + **kwargs: Any, + ) -> SendChatAction: + """ + Shortcut for method :class:`aiogram.methods.send_chat_action.SendChatAction` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method when you need to tell the user that something is happening on the bot's side. The status is set for 5 seconds or less (when a message arrives from your bot, Telegram clients clear its typing status). Returns :code:`True` on success. + + Example: The `ImageBot `_ needs some time to process a request and upload the image. Instead of sending a text message along the lines of 'Retrieving image, please wait…', the bot may use :class:`aiogram.methods.send_chat_action.SendChatAction` with *action* = *upload_photo*. The user will see a 'sending photo' status for the bot. + + We only recommend using this method when a response from the bot will take a **noticeable** amount of time to arrive. + + Source: https://core.telegram.org/bots/api#sendchataction + + :param action: Type of action to broadcast. Choose one, depending on what the user is about to receive: *typing* for `text messages `_, *upload_photo* for `photos `_, *record_video* or *upload_video* for `videos `_, *record_voice* or *upload_voice* for `voice notes `_, *upload_document* for `general files `_, *choose_sticker* for `stickers `_, *find_location* for `location data `_, *record_video_note* or *upload_video_note* for `video notes `_. + :param business_connection_id: Unique identifier of the business connection on behalf of which the action will be sent + :param message_thread_id: Unique identifier for the target message thread; for supergroups only + :return: instance of method :class:`aiogram.methods.send_chat_action.SendChatAction` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendChatAction + + return SendChatAction( + chat_id=self.id, + action=action, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + **kwargs, + ).as_(self._bot) + + def delete_sticker_set( + self, + **kwargs: Any, + ) -> DeleteChatStickerSet: + """ + Shortcut for method :class:`aiogram.methods.delete_chat_sticker_set.DeleteChatStickerSet` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to delete a group sticker set from a supergroup. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Use the field *can_set_sticker_set* optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests to check if the bot can use this method. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletechatstickerset + + :return: instance of method :class:`aiogram.methods.delete_chat_sticker_set.DeleteChatStickerSet` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import DeleteChatStickerSet + + return DeleteChatStickerSet( + chat_id=self.id, + **kwargs, + ).as_(self._bot) + + def set_sticker_set( + self, + sticker_set_name: str, + **kwargs: Any, + ) -> SetChatStickerSet: + """ + Shortcut for method :class:`aiogram.methods.set_chat_sticker_set.SetChatStickerSet` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to set a new group sticker set for a supergroup. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Use the field *can_set_sticker_set* optionally returned in :class:`aiogram.methods.get_chat.GetChat` requests to check if the bot can use this method. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatstickerset + + :param sticker_set_name: Name of the sticker set to be set as the group sticker set + :return: instance of method :class:`aiogram.methods.set_chat_sticker_set.SetChatStickerSet` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SetChatStickerSet + + return SetChatStickerSet( + chat_id=self.id, + sticker_set_name=sticker_set_name, + **kwargs, + ).as_(self._bot) + + def get_member( + self, + user_id: int, + **kwargs: Any, + ) -> GetChatMember: + """ + Shortcut for method :class:`aiogram.methods.get_chat_member.GetChatMember` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to get information about a member of a chat. The method is only guaranteed to work for other users if the bot is an administrator in the chat. Returns a :class:`aiogram.types.chat_member.ChatMember` object on success. + + Source: https://core.telegram.org/bots/api#getchatmember + + :param user_id: Unique identifier of the target user + :return: instance of method :class:`aiogram.methods.get_chat_member.GetChatMember` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import GetChatMember + + return GetChatMember( + chat_id=self.id, + user_id=user_id, + **kwargs, + ).as_(self._bot) + + def get_member_count( + self, + **kwargs: Any, + ) -> GetChatMemberCount: + """ + Shortcut for method :class:`aiogram.methods.get_chat_member_count.GetChatMemberCount` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to get the number of members in a chat. Returns *Int* on success. + + Source: https://core.telegram.org/bots/api#getchatmembercount + + :return: instance of method :class:`aiogram.methods.get_chat_member_count.GetChatMemberCount` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import GetChatMemberCount + + return GetChatMemberCount( + chat_id=self.id, + **kwargs, + ).as_(self._bot) + + def leave( + self, + **kwargs: Any, + ) -> LeaveChat: + """ + Shortcut for method :class:`aiogram.methods.leave_chat.LeaveChat` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method for your bot to leave a group, supergroup or channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#leavechat + + :return: instance of method :class:`aiogram.methods.leave_chat.LeaveChat` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import LeaveChat + + return LeaveChat( + chat_id=self.id, + **kwargs, + ).as_(self._bot) + + def unpin_all_messages( + self, + **kwargs: Any, + ) -> UnpinAllChatMessages: + """ + Shortcut for method :class:`aiogram.methods.unpin_all_chat_messages.UnpinAllChatMessages` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to clear the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' administrator right in a supergroup or 'can_edit_messages' administrator right in a channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unpinallchatmessages + + :return: instance of method :class:`aiogram.methods.unpin_all_chat_messages.UnpinAllChatMessages` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import UnpinAllChatMessages + + return UnpinAllChatMessages( + chat_id=self.id, + **kwargs, + ).as_(self._bot) + + def unpin_message( + self, + business_connection_id: Optional[str] = None, + message_id: Optional[int] = None, + **kwargs: Any, + ) -> UnpinChatMessage: + """ + Shortcut for method :class:`aiogram.methods.unpin_chat_message.UnpinChatMessage` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to remove a message from the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' administrator right in a supergroup or 'can_edit_messages' administrator right in a channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unpinchatmessage + + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be unpinned + :param message_id: Identifier of the message to unpin. Required if *business_connection_id* is specified. If not specified, the most recent pinned message (by sending date) will be unpinned. + :return: instance of method :class:`aiogram.methods.unpin_chat_message.UnpinChatMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import UnpinChatMessage + + return UnpinChatMessage( + chat_id=self.id, + business_connection_id=business_connection_id, + message_id=message_id, + **kwargs, + ).as_(self._bot) + + def pin_message( + self, + message_id: int, + business_connection_id: Optional[str] = None, + disable_notification: Optional[bool] = None, + **kwargs: Any, + ) -> PinChatMessage: + """ + Shortcut for method :class:`aiogram.methods.pin_chat_message.PinChatMessage` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to add a message to the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' administrator right in a supergroup or 'can_edit_messages' administrator right in a channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#pinchatmessage + + :param message_id: Identifier of a message to pin + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be pinned + :param disable_notification: Pass :code:`True` if it is not necessary to send a notification to all chat members about the new pinned message. Notifications are always disabled in channels and private chats. + :return: instance of method :class:`aiogram.methods.pin_chat_message.PinChatMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import PinChatMessage + + return PinChatMessage( + chat_id=self.id, + message_id=message_id, + business_connection_id=business_connection_id, + disable_notification=disable_notification, + **kwargs, + ).as_(self._bot) + + def set_administrator_custom_title( + self, + user_id: int, + custom_title: str, + **kwargs: Any, + ) -> SetChatAdministratorCustomTitle: + """ + Shortcut for method :class:`aiogram.methods.set_chat_administrator_custom_title.SetChatAdministratorCustomTitle` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to set a custom title for an administrator in a supergroup promoted by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatadministratorcustomtitle + + :param user_id: Unique identifier of the target user + :param custom_title: New custom title for the administrator; 0-16 characters, emoji are not allowed + :return: instance of method :class:`aiogram.methods.set_chat_administrator_custom_title.SetChatAdministratorCustomTitle` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SetChatAdministratorCustomTitle + + return SetChatAdministratorCustomTitle( + chat_id=self.id, + user_id=user_id, + custom_title=custom_title, + **kwargs, + ).as_(self._bot) + + def set_permissions( + self, + permissions: ChatPermissions, + use_independent_chat_permissions: Optional[bool] = None, + **kwargs: Any, + ) -> SetChatPermissions: + """ + Shortcut for method :class:`aiogram.methods.set_chat_permissions.SetChatPermissions` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to set default chat permissions for all members. The bot must be an administrator in the group or a supergroup for this to work and must have the *can_restrict_members* administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatpermissions + + :param permissions: A JSON-serialized object for new default chat permissions + :param use_independent_chat_permissions: Pass :code:`True` if chat permissions are set independently. Otherwise, the *can_send_other_messages* and *can_add_web_page_previews* permissions will imply the *can_send_messages*, *can_send_audios*, *can_send_documents*, *can_send_photos*, *can_send_videos*, *can_send_video_notes*, and *can_send_voice_notes* permissions; the *can_send_polls* permission will imply the *can_send_messages* permission. + :return: instance of method :class:`aiogram.methods.set_chat_permissions.SetChatPermissions` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SetChatPermissions + + return SetChatPermissions( + chat_id=self.id, + permissions=permissions, + use_independent_chat_permissions=use_independent_chat_permissions, + **kwargs, + ).as_(self._bot) + + def promote( + self, + user_id: int, + is_anonymous: Optional[bool] = None, + can_manage_chat: Optional[bool] = None, + can_delete_messages: Optional[bool] = None, + can_manage_video_chats: Optional[bool] = None, + can_restrict_members: Optional[bool] = None, + can_promote_members: Optional[bool] = None, + can_change_info: Optional[bool] = None, + can_invite_users: Optional[bool] = None, + can_post_stories: Optional[bool] = None, + can_edit_stories: Optional[bool] = None, + can_delete_stories: Optional[bool] = None, + can_post_messages: Optional[bool] = None, + can_edit_messages: Optional[bool] = None, + can_pin_messages: Optional[bool] = None, + can_manage_topics: Optional[bool] = None, + **kwargs: Any, + ) -> PromoteChatMember: + """ + Shortcut for method :class:`aiogram.methods.promote_chat_member.PromoteChatMember` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to promote or demote a user in a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Pass :code:`False` for all boolean parameters to demote a user. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#promotechatmember + + :param user_id: Unique identifier of the target user + :param is_anonymous: Pass :code:`True` if the administrator's presence in the chat is hidden + :param can_manage_chat: Pass :code:`True` if the administrator can access the chat event log, get boost list, see hidden supergroup and channel members, report spam messages and ignore slow mode. Implied by any other administrator privilege. + :param can_delete_messages: Pass :code:`True` if the administrator can delete messages of other users + :param can_manage_video_chats: Pass :code:`True` if the administrator can manage video chats + :param can_restrict_members: Pass :code:`True` if the administrator can restrict, ban or unban chat members, or access supergroup statistics + :param can_promote_members: Pass :code:`True` if the administrator can add new administrators with a subset of their own privileges or demote administrators that they have promoted, directly or indirectly (promoted by administrators that were appointed by him) + :param can_change_info: Pass :code:`True` if the administrator can change chat title, photo and other settings + :param can_invite_users: Pass :code:`True` if the administrator can invite new users to the chat + :param can_post_stories: Pass :code:`True` if the administrator can post stories to the chat + :param can_edit_stories: Pass :code:`True` if the administrator can edit stories posted by other users, post stories to the chat page, pin chat stories, and access the chat's story archive + :param can_delete_stories: Pass :code:`True` if the administrator can delete stories posted by other users + :param can_post_messages: Pass :code:`True` if the administrator can post messages in the channel, or access channel statistics; for channels only + :param can_edit_messages: Pass :code:`True` if the administrator can edit messages of other users and can pin messages; for channels only + :param can_pin_messages: Pass :code:`True` if the administrator can pin messages; for supergroups only + :param can_manage_topics: Pass :code:`True` if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only + :return: instance of method :class:`aiogram.methods.promote_chat_member.PromoteChatMember` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import PromoteChatMember + + return PromoteChatMember( + chat_id=self.id, + user_id=user_id, + is_anonymous=is_anonymous, + can_manage_chat=can_manage_chat, + can_delete_messages=can_delete_messages, + can_manage_video_chats=can_manage_video_chats, + can_restrict_members=can_restrict_members, + can_promote_members=can_promote_members, + can_change_info=can_change_info, + can_invite_users=can_invite_users, + can_post_stories=can_post_stories, + can_edit_stories=can_edit_stories, + can_delete_stories=can_delete_stories, + can_post_messages=can_post_messages, + can_edit_messages=can_edit_messages, + can_pin_messages=can_pin_messages, + can_manage_topics=can_manage_topics, + **kwargs, + ).as_(self._bot) + + def restrict( + self, + user_id: int, + permissions: ChatPermissions, + use_independent_chat_permissions: Optional[bool] = None, + until_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + **kwargs: Any, + ) -> RestrictChatMember: + """ + Shortcut for method :class:`aiogram.methods.restrict_chat_member.RestrictChatMember` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to restrict a user in a supergroup. The bot must be an administrator in the supergroup for this to work and must have the appropriate administrator rights. Pass :code:`True` for all permissions to lift restrictions from a user. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#restrictchatmember + + :param user_id: Unique identifier of the target user + :param permissions: A JSON-serialized object for new user permissions + :param use_independent_chat_permissions: Pass :code:`True` if chat permissions are set independently. Otherwise, the *can_send_other_messages* and *can_add_web_page_previews* permissions will imply the *can_send_messages*, *can_send_audios*, *can_send_documents*, *can_send_photos*, *can_send_videos*, *can_send_video_notes*, and *can_send_voice_notes* permissions; the *can_send_polls* permission will imply the *can_send_messages* permission. + :param until_date: Date when restrictions will be lifted for the user; Unix time. If user is restricted for more than 366 days or less than 30 seconds from the current time, they are considered to be restricted forever + :return: instance of method :class:`aiogram.methods.restrict_chat_member.RestrictChatMember` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import RestrictChatMember + + return RestrictChatMember( + chat_id=self.id, + user_id=user_id, + permissions=permissions, + use_independent_chat_permissions=use_independent_chat_permissions, + until_date=until_date, + **kwargs, + ).as_(self._bot) + + def unban( + self, + user_id: int, + only_if_banned: Optional[bool] = None, + **kwargs: Any, + ) -> UnbanChatMember: + """ + Shortcut for method :class:`aiogram.methods.unban_chat_member.UnbanChatMember` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to unban a previously banned user in a supergroup or channel. The user will **not** return to the group or channel automatically, but will be able to join via link, etc. The bot must be an administrator for this to work. By default, this method guarantees that after the call the user is not a member of the chat, but will be able to join it. So if the user is a member of the chat they will also be **removed** from the chat. If you don't want this, use the parameter *only_if_banned*. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unbanchatmember + + :param user_id: Unique identifier of the target user + :param only_if_banned: Do nothing if the user is not banned + :return: instance of method :class:`aiogram.methods.unban_chat_member.UnbanChatMember` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import UnbanChatMember + + return UnbanChatMember( + chat_id=self.id, + user_id=user_id, + only_if_banned=only_if_banned, + **kwargs, + ).as_(self._bot) + + def ban( + self, + user_id: int, + until_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + revoke_messages: Optional[bool] = None, + **kwargs: Any, + ) -> BanChatMember: + """ + Shortcut for method :class:`aiogram.methods.ban_chat_member.BanChatMember` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to ban a user in a group, a supergroup or a channel. In the case of supergroups and channels, the user will not be able to return to the chat on their own using invite links, etc., unless `unbanned `_ first. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#banchatmember + + :param user_id: Unique identifier of the target user + :param until_date: Date when the user will be unbanned; Unix time. If user is banned for more than 366 days or less than 30 seconds from the current time they are considered to be banned forever. Applied for supergroups and channels only. + :param revoke_messages: Pass :code:`True` to delete all messages from the chat for the user that is being removed. If :code:`False`, the user will be able to see messages in the group that were sent before the user was removed. Always :code:`True` for supergroups and channels. + :return: instance of method :class:`aiogram.methods.ban_chat_member.BanChatMember` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import BanChatMember + + return BanChatMember( + chat_id=self.id, + user_id=user_id, + until_date=until_date, + revoke_messages=revoke_messages, + **kwargs, + ).as_(self._bot) + + def set_description( + self, + description: Optional[str] = None, + **kwargs: Any, + ) -> SetChatDescription: + """ + Shortcut for method :class:`aiogram.methods.set_chat_description.SetChatDescription` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to change the description of a group, a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatdescription + + :param description: New chat description, 0-255 characters + :return: instance of method :class:`aiogram.methods.set_chat_description.SetChatDescription` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SetChatDescription + + return SetChatDescription( + chat_id=self.id, + description=description, + **kwargs, + ).as_(self._bot) + + def set_title( + self, + title: str, + **kwargs: Any, + ) -> SetChatTitle: + """ + Shortcut for method :class:`aiogram.methods.set_chat_title.SetChatTitle` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to change the title of a chat. Titles can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchattitle + + :param title: New chat title, 1-128 characters + :return: instance of method :class:`aiogram.methods.set_chat_title.SetChatTitle` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SetChatTitle + + return SetChatTitle( + chat_id=self.id, + title=title, + **kwargs, + ).as_(self._bot) + + def delete_photo( + self, + **kwargs: Any, + ) -> DeleteChatPhoto: + """ + Shortcut for method :class:`aiogram.methods.delete_chat_photo.DeleteChatPhoto` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to delete a chat photo. Photos can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletechatphoto + + :return: instance of method :class:`aiogram.methods.delete_chat_photo.DeleteChatPhoto` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import DeleteChatPhoto + + return DeleteChatPhoto( + chat_id=self.id, + **kwargs, + ).as_(self._bot) + + def set_photo( + self, + photo: InputFile, + **kwargs: Any, + ) -> SetChatPhoto: + """ + Shortcut for method :class:`aiogram.methods.set_chat_photo.SetChatPhoto` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to set a new profile photo for the chat. Photos can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setchatphoto + + :param photo: New chat photo, uploaded using multipart/form-data + :return: instance of method :class:`aiogram.methods.set_chat_photo.SetChatPhoto` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SetChatPhoto + + return SetChatPhoto( + chat_id=self.id, + photo=photo, + **kwargs, + ).as_(self._bot) + + def unpin_all_general_forum_topic_messages( + self, + **kwargs: Any, + ) -> UnpinAllGeneralForumTopicMessages: + """ + Shortcut for method :class:`aiogram.methods.unpin_all_general_forum_topic_messages.UnpinAllGeneralForumTopicMessages` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to clear the list of pinned messages in a General forum topic. The bot must be an administrator in the chat for this to work and must have the *can_pin_messages* administrator right in the supergroup. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unpinallgeneralforumtopicmessages + + :return: instance of method :class:`aiogram.methods.unpin_all_general_forum_topic_messages.UnpinAllGeneralForumTopicMessages` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import UnpinAllGeneralForumTopicMessages + + return UnpinAllGeneralForumTopicMessages( + chat_id=self.id, + **kwargs, + ).as_(self._bot) diff --git a/env/Lib/site-packages/aiogram/types/chat_administrator_rights.py b/env/Lib/site-packages/aiogram/types/chat_administrator_rights.py new file mode 100644 index 0000000..0b20578 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_administrator_rights.py @@ -0,0 +1,94 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + pass + + +class ChatAdministratorRights(TelegramObject): + """ + Represents the rights of an administrator in a chat. + + Source: https://core.telegram.org/bots/api#chatadministratorrights + """ + + is_anonymous: bool + """:code:`True`, if the user's presence in the chat is hidden""" + can_manage_chat: bool + """:code:`True`, if the administrator can access the chat event log, get boost list, see hidden supergroup and channel members, report spam messages and ignore slow mode. Implied by any other administrator privilege.""" + can_delete_messages: bool + """:code:`True`, if the administrator can delete messages of other users""" + can_manage_video_chats: bool + """:code:`True`, if the administrator can manage video chats""" + can_restrict_members: bool + """:code:`True`, if the administrator can restrict, ban or unban chat members, or access supergroup statistics""" + can_promote_members: bool + """:code:`True`, if the administrator can add new administrators with a subset of their own privileges or demote administrators that they have promoted, directly or indirectly (promoted by administrators that were appointed by the user)""" + can_change_info: bool + """:code:`True`, if the user is allowed to change the chat title, photo and other settings""" + can_invite_users: bool + """:code:`True`, if the user is allowed to invite new users to the chat""" + can_post_stories: bool + """:code:`True`, if the administrator can post stories to the chat""" + can_edit_stories: bool + """:code:`True`, if the administrator can edit stories posted by other users, post stories to the chat page, pin chat stories, and access the chat's story archive""" + can_delete_stories: bool + """:code:`True`, if the administrator can delete stories posted by other users""" + can_post_messages: Optional[bool] = None + """*Optional*. :code:`True`, if the administrator can post messages in the channel, or access channel statistics; for channels only""" + can_edit_messages: Optional[bool] = None + """*Optional*. :code:`True`, if the administrator can edit messages of other users and can pin messages; for channels only""" + can_pin_messages: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to pin messages; for groups and supergroups only""" + can_manage_topics: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + is_anonymous: bool, + can_manage_chat: bool, + can_delete_messages: bool, + can_manage_video_chats: bool, + can_restrict_members: bool, + can_promote_members: bool, + can_change_info: bool, + can_invite_users: bool, + can_post_stories: bool, + can_edit_stories: bool, + can_delete_stories: bool, + can_post_messages: Optional[bool] = None, + can_edit_messages: Optional[bool] = None, + can_pin_messages: Optional[bool] = None, + can_manage_topics: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + is_anonymous=is_anonymous, + can_manage_chat=can_manage_chat, + can_delete_messages=can_delete_messages, + can_manage_video_chats=can_manage_video_chats, + can_restrict_members=can_restrict_members, + can_promote_members=can_promote_members, + can_change_info=can_change_info, + can_invite_users=can_invite_users, + can_post_stories=can_post_stories, + can_edit_stories=can_edit_stories, + can_delete_stories=can_delete_stories, + can_post_messages=can_post_messages, + can_edit_messages=can_edit_messages, + can_pin_messages=can_pin_messages, + can_manage_topics=can_manage_topics, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/chat_background.py b/env/Lib/site-packages/aiogram/types/chat_background.py new file mode 100644 index 0000000..937b436 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_background.py @@ -0,0 +1,44 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +if TYPE_CHECKING: + from .background_type_chat_theme import BackgroundTypeChatTheme + from .background_type_fill import BackgroundTypeFill + from .background_type_pattern import BackgroundTypePattern + from .background_type_wallpaper import BackgroundTypeWallpaper +from .base import TelegramObject + + +class ChatBackground(TelegramObject): + """ + This object represents a chat background. + + Source: https://core.telegram.org/bots/api#chatbackground + """ + + type: Union[ + BackgroundTypeFill, BackgroundTypeWallpaper, BackgroundTypePattern, BackgroundTypeChatTheme + ] + """Type of the background""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Union[ + BackgroundTypeFill, + BackgroundTypeWallpaper, + BackgroundTypePattern, + BackgroundTypeChatTheme, + ], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/chat_boost.py b/env/Lib/site-packages/aiogram/types/chat_boost.py new file mode 100644 index 0000000..96e444f --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_boost.py @@ -0,0 +1,55 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramObject +from .custom import DateTime + +if TYPE_CHECKING: + from .chat_boost_source_gift_code import ChatBoostSourceGiftCode + from .chat_boost_source_giveaway import ChatBoostSourceGiveaway + from .chat_boost_source_premium import ChatBoostSourcePremium + + +class ChatBoost(TelegramObject): + """ + This object contains information about a chat boost. + + Source: https://core.telegram.org/bots/api#chatboost + """ + + boost_id: str + """Unique identifier of the boost""" + add_date: DateTime + """Point in time (Unix timestamp) when the chat was boosted""" + expiration_date: DateTime + """Point in time (Unix timestamp) when the boost will automatically expire, unless the booster's Telegram Premium subscription is prolonged""" + source: Union[ChatBoostSourcePremium, ChatBoostSourceGiftCode, ChatBoostSourceGiveaway] + """Source of the added boost""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + boost_id: str, + add_date: DateTime, + expiration_date: DateTime, + source: Union[ + ChatBoostSourcePremium, ChatBoostSourceGiftCode, ChatBoostSourceGiveaway + ], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + boost_id=boost_id, + add_date=add_date, + expiration_date=expiration_date, + source=source, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/chat_boost_added.py b/env/Lib/site-packages/aiogram/types/chat_boost_added.py new file mode 100644 index 0000000..4473eae --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_boost_added.py @@ -0,0 +1,25 @@ +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + + +class ChatBoostAdded(TelegramObject): + """ + This object represents a service message about a user boosting a chat. + + Source: https://core.telegram.org/bots/api#chatboostadded + """ + + boost_count: int + """Number of boosts added by the user""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__(__pydantic__self__, *, boost_count: int, **__pydantic_kwargs: Any) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(boost_count=boost_count, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/chat_boost_removed.py b/env/Lib/site-packages/aiogram/types/chat_boost_removed.py new file mode 100644 index 0000000..094b057 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_boost_removed.py @@ -0,0 +1,56 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramObject +from .custom import DateTime + +if TYPE_CHECKING: + from .chat import Chat + from .chat_boost_source_gift_code import ChatBoostSourceGiftCode + from .chat_boost_source_giveaway import ChatBoostSourceGiveaway + from .chat_boost_source_premium import ChatBoostSourcePremium + + +class ChatBoostRemoved(TelegramObject): + """ + This object represents a boost removed from a chat. + + Source: https://core.telegram.org/bots/api#chatboostremoved + """ + + chat: Chat + """Chat which was boosted""" + boost_id: str + """Unique identifier of the boost""" + remove_date: DateTime + """Point in time (Unix timestamp) when the boost was removed""" + source: Union[ChatBoostSourcePremium, ChatBoostSourceGiftCode, ChatBoostSourceGiveaway] + """Source of the removed boost""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat: Chat, + boost_id: str, + remove_date: DateTime, + source: Union[ + ChatBoostSourcePremium, ChatBoostSourceGiftCode, ChatBoostSourceGiveaway + ], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat=chat, + boost_id=boost_id, + remove_date=remove_date, + source=source, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/chat_boost_source.py b/env/Lib/site-packages/aiogram/types/chat_boost_source.py new file mode 100644 index 0000000..3d2c262 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_boost_source.py @@ -0,0 +1,13 @@ +from aiogram.types import TelegramObject + + +class ChatBoostSource(TelegramObject): + """ + This object describes the source of a chat boost. It can be one of + + - :class:`aiogram.types.chat_boost_source_premium.ChatBoostSourcePremium` + - :class:`aiogram.types.chat_boost_source_gift_code.ChatBoostSourceGiftCode` + - :class:`aiogram.types.chat_boost_source_giveaway.ChatBoostSourceGiveaway` + + Source: https://core.telegram.org/bots/api#chatboostsource + """ diff --git a/env/Lib/site-packages/aiogram/types/chat_boost_source_gift_code.py b/env/Lib/site-packages/aiogram/types/chat_boost_source_gift_code.py new file mode 100644 index 0000000..554e58f --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_boost_source_gift_code.py @@ -0,0 +1,39 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import ChatBoostSourceType +from .chat_boost_source import ChatBoostSource + +if TYPE_CHECKING: + from .user import User + + +class ChatBoostSourceGiftCode(ChatBoostSource): + """ + The boost was obtained by the creation of Telegram Premium gift codes to boost a chat. Each such code boosts the chat 4 times for the duration of the corresponding Telegram Premium subscription. + + Source: https://core.telegram.org/bots/api#chatboostsourcegiftcode + """ + + source: Literal[ChatBoostSourceType.GIFT_CODE] = ChatBoostSourceType.GIFT_CODE + """Source of the boost, always 'gift_code'""" + user: User + """User for which the gift code was created""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + source: Literal[ChatBoostSourceType.GIFT_CODE] = ChatBoostSourceType.GIFT_CODE, + user: User, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(source=source, user=user, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/chat_boost_source_giveaway.py b/env/Lib/site-packages/aiogram/types/chat_boost_source_giveaway.py new file mode 100644 index 0000000..dbb8150 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_boost_source_giveaway.py @@ -0,0 +1,51 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional + +from ..enums import ChatBoostSourceType +from .chat_boost_source import ChatBoostSource + +if TYPE_CHECKING: + from .user import User + + +class ChatBoostSourceGiveaway(ChatBoostSource): + """ + The boost was obtained by the creation of a Telegram Premium giveaway. This boosts the chat 4 times for the duration of the corresponding Telegram Premium subscription. + + Source: https://core.telegram.org/bots/api#chatboostsourcegiveaway + """ + + source: Literal[ChatBoostSourceType.GIVEAWAY] = ChatBoostSourceType.GIVEAWAY + """Source of the boost, always 'giveaway'""" + giveaway_message_id: int + """Identifier of a message in the chat with the giveaway; the message could have been deleted already. May be 0 if the message isn't sent yet.""" + user: Optional[User] = None + """*Optional*. User that won the prize in the giveaway if any""" + is_unclaimed: Optional[bool] = None + """*Optional*. True, if the giveaway was completed, but there was no user to win the prize""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + source: Literal[ChatBoostSourceType.GIVEAWAY] = ChatBoostSourceType.GIVEAWAY, + giveaway_message_id: int, + user: Optional[User] = None, + is_unclaimed: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + source=source, + giveaway_message_id=giveaway_message_id, + user=user, + is_unclaimed=is_unclaimed, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/chat_boost_source_premium.py b/env/Lib/site-packages/aiogram/types/chat_boost_source_premium.py new file mode 100644 index 0000000..97b47e6 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_boost_source_premium.py @@ -0,0 +1,39 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import ChatBoostSourceType +from .chat_boost_source import ChatBoostSource + +if TYPE_CHECKING: + from .user import User + + +class ChatBoostSourcePremium(ChatBoostSource): + """ + The boost was obtained by subscribing to Telegram Premium or by gifting a Telegram Premium subscription to another user. + + Source: https://core.telegram.org/bots/api#chatboostsourcepremium + """ + + source: Literal[ChatBoostSourceType.PREMIUM] = ChatBoostSourceType.PREMIUM + """Source of the boost, always 'premium'""" + user: User + """User that boosted the chat""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + source: Literal[ChatBoostSourceType.PREMIUM] = ChatBoostSourceType.PREMIUM, + user: User, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(source=source, user=user, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/chat_boost_updated.py b/env/Lib/site-packages/aiogram/types/chat_boost_updated.py new file mode 100644 index 0000000..0921c96 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_boost_updated.py @@ -0,0 +1,35 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + +if TYPE_CHECKING: + from .chat import Chat + from .chat_boost import ChatBoost + + +class ChatBoostUpdated(TelegramObject): + """ + This object represents a boost added to a chat or changed. + + Source: https://core.telegram.org/bots/api#chatboostupdated + """ + + chat: Chat + """Chat which was boosted""" + boost: ChatBoost + """Information about the chat boost""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, chat: Chat, boost: ChatBoost, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat=chat, boost=boost, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/chat_full_info.py b/env/Lib/site-packages/aiogram/types/chat_full_info.py new file mode 100644 index 0000000..c639939 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_full_info.py @@ -0,0 +1,225 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from .chat import Chat +from .custom import DateTime + +if TYPE_CHECKING: + from .birthdate import Birthdate + from .business_intro import BusinessIntro + from .business_location import BusinessLocation + from .business_opening_hours import BusinessOpeningHours + from .chat_location import ChatLocation + from .chat_permissions import ChatPermissions + from .chat_photo import ChatPhoto + from .message import Message + from .reaction_type_custom_emoji import ReactionTypeCustomEmoji + from .reaction_type_emoji import ReactionTypeEmoji + from .reaction_type_paid import ReactionTypePaid + + +class ChatFullInfo(Chat): + """ + This object contains full information about a chat. + + Source: https://core.telegram.org/bots/api#chatfullinfo + """ + + id: int + """Unique identifier for this chat. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this identifier.""" + type: str + """Type of the chat, can be either 'private', 'group', 'supergroup' or 'channel'""" + accent_color_id: int + """Identifier of the accent color for the chat name and backgrounds of the chat photo, reply header, and link preview. See `accent colors `_ for more details.""" + max_reaction_count: int + """The maximum number of reactions that can be set on a message in the chat""" + title: Optional[str] = None + """*Optional*. Title, for supergroups, channels and group chats""" + username: Optional[str] = None + """*Optional*. Username, for private chats, supergroups and channels if available""" + first_name: Optional[str] = None + """*Optional*. First name of the other party in a private chat""" + last_name: Optional[str] = None + """*Optional*. Last name of the other party in a private chat""" + is_forum: Optional[bool] = None + """*Optional*. :code:`True`, if the supergroup chat is a forum (has `topics `_ enabled)""" + photo: Optional[ChatPhoto] = None + """*Optional*. Chat photo""" + active_usernames: Optional[List[str]] = None + """*Optional*. If non-empty, the list of all `active chat usernames `_; for private chats, supergroups and channels""" + birthdate: Optional[Birthdate] = None + """*Optional*. For private chats, the date of birth of the user""" + business_intro: Optional[BusinessIntro] = None + """*Optional*. For private chats with business accounts, the intro of the business""" + business_location: Optional[BusinessLocation] = None + """*Optional*. For private chats with business accounts, the location of the business""" + business_opening_hours: Optional[BusinessOpeningHours] = None + """*Optional*. For private chats with business accounts, the opening hours of the business""" + personal_chat: Optional[Chat] = None + """*Optional*. For private chats, the personal channel of the user""" + available_reactions: Optional[ + List[Union[ReactionTypeEmoji, ReactionTypeCustomEmoji, ReactionTypePaid]] + ] = None + """*Optional*. List of available reactions allowed in the chat. If omitted, then all `emoji reactions `_ are allowed.""" + background_custom_emoji_id: Optional[str] = None + """*Optional*. Custom emoji identifier of the emoji chosen by the chat for the reply header and link preview background""" + profile_accent_color_id: Optional[int] = None + """*Optional*. Identifier of the accent color for the chat's profile background. See `profile accent colors `_ for more details.""" + profile_background_custom_emoji_id: Optional[str] = None + """*Optional*. Custom emoji identifier of the emoji chosen by the chat for its profile background""" + emoji_status_custom_emoji_id: Optional[str] = None + """*Optional*. Custom emoji identifier of the emoji status of the chat or the other party in a private chat""" + emoji_status_expiration_date: Optional[DateTime] = None + """*Optional*. Expiration date of the emoji status of the chat or the other party in a private chat, in Unix time, if any""" + bio: Optional[str] = None + """*Optional*. Bio of the other party in a private chat""" + has_private_forwards: Optional[bool] = None + """*Optional*. :code:`True`, if privacy settings of the other party in the private chat allows to use :code:`tg://user?id=` links only in chats with the user""" + has_restricted_voice_and_video_messages: Optional[bool] = None + """*Optional*. :code:`True`, if the privacy settings of the other party restrict sending voice and video note messages in the private chat""" + join_to_send_messages: Optional[bool] = None + """*Optional*. :code:`True`, if users need to join the supergroup before they can send messages""" + join_by_request: Optional[bool] = None + """*Optional*. :code:`True`, if all users directly joining the supergroup without using an invite link need to be approved by supergroup administrators""" + description: Optional[str] = None + """*Optional*. Description, for groups, supergroups and channel chats""" + invite_link: Optional[str] = None + """*Optional*. Primary invite link, for groups, supergroups and channel chats""" + pinned_message: Optional[Message] = None + """*Optional*. The most recent pinned message (by sending date)""" + permissions: Optional[ChatPermissions] = None + """*Optional*. Default chat member permissions, for groups and supergroups""" + can_send_paid_media: Optional[bool] = None + """*Optional*. :code:`True`, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats.""" + slow_mode_delay: Optional[int] = None + """*Optional*. For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user; in seconds""" + unrestrict_boost_count: Optional[int] = None + """*Optional*. For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions""" + message_auto_delete_time: Optional[int] = None + """*Optional*. The time after which all messages sent to the chat will be automatically deleted; in seconds""" + has_aggressive_anti_spam_enabled: Optional[bool] = None + """*Optional*. :code:`True`, if aggressive anti-spam checks are enabled in the supergroup. The field is only available to chat administrators.""" + has_hidden_members: Optional[bool] = None + """*Optional*. :code:`True`, if non-administrators can only get the list of bots and administrators in the chat""" + has_protected_content: Optional[bool] = None + """*Optional*. :code:`True`, if messages from the chat can't be forwarded to other chats""" + has_visible_history: Optional[bool] = None + """*Optional*. :code:`True`, if new chat members will have access to old messages; available only to chat administrators""" + sticker_set_name: Optional[str] = None + """*Optional*. For supergroups, name of the group sticker set""" + can_set_sticker_set: Optional[bool] = None + """*Optional*. :code:`True`, if the bot can change the group sticker set""" + custom_emoji_sticker_set_name: Optional[str] = None + """*Optional*. For supergroups, the name of the group's custom emoji sticker set. Custom emoji from this set can be used by all users and bots in the group.""" + linked_chat_id: Optional[int] = None + """*Optional*. Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. This identifier may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it is smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier.""" + location: Optional[ChatLocation] = None + """*Optional*. For supergroups, the location to which the supergroup is connected""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + id: int, + type: str, + accent_color_id: int, + max_reaction_count: int, + title: Optional[str] = None, + username: Optional[str] = None, + first_name: Optional[str] = None, + last_name: Optional[str] = None, + is_forum: Optional[bool] = None, + photo: Optional[ChatPhoto] = None, + active_usernames: Optional[List[str]] = None, + birthdate: Optional[Birthdate] = None, + business_intro: Optional[BusinessIntro] = None, + business_location: Optional[BusinessLocation] = None, + business_opening_hours: Optional[BusinessOpeningHours] = None, + personal_chat: Optional[Chat] = None, + available_reactions: Optional[ + List[Union[ReactionTypeEmoji, ReactionTypeCustomEmoji, ReactionTypePaid]] + ] = None, + background_custom_emoji_id: Optional[str] = None, + profile_accent_color_id: Optional[int] = None, + profile_background_custom_emoji_id: Optional[str] = None, + emoji_status_custom_emoji_id: Optional[str] = None, + emoji_status_expiration_date: Optional[DateTime] = None, + bio: Optional[str] = None, + has_private_forwards: Optional[bool] = None, + has_restricted_voice_and_video_messages: Optional[bool] = None, + join_to_send_messages: Optional[bool] = None, + join_by_request: Optional[bool] = None, + description: Optional[str] = None, + invite_link: Optional[str] = None, + pinned_message: Optional[Message] = None, + permissions: Optional[ChatPermissions] = None, + can_send_paid_media: Optional[bool] = None, + slow_mode_delay: Optional[int] = None, + unrestrict_boost_count: Optional[int] = None, + message_auto_delete_time: Optional[int] = None, + has_aggressive_anti_spam_enabled: Optional[bool] = None, + has_hidden_members: Optional[bool] = None, + has_protected_content: Optional[bool] = None, + has_visible_history: Optional[bool] = None, + sticker_set_name: Optional[str] = None, + can_set_sticker_set: Optional[bool] = None, + custom_emoji_sticker_set_name: Optional[str] = None, + linked_chat_id: Optional[int] = None, + location: Optional[ChatLocation] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + id=id, + type=type, + accent_color_id=accent_color_id, + max_reaction_count=max_reaction_count, + title=title, + username=username, + first_name=first_name, + last_name=last_name, + is_forum=is_forum, + photo=photo, + active_usernames=active_usernames, + birthdate=birthdate, + business_intro=business_intro, + business_location=business_location, + business_opening_hours=business_opening_hours, + personal_chat=personal_chat, + available_reactions=available_reactions, + background_custom_emoji_id=background_custom_emoji_id, + profile_accent_color_id=profile_accent_color_id, + profile_background_custom_emoji_id=profile_background_custom_emoji_id, + emoji_status_custom_emoji_id=emoji_status_custom_emoji_id, + emoji_status_expiration_date=emoji_status_expiration_date, + bio=bio, + has_private_forwards=has_private_forwards, + has_restricted_voice_and_video_messages=has_restricted_voice_and_video_messages, + join_to_send_messages=join_to_send_messages, + join_by_request=join_by_request, + description=description, + invite_link=invite_link, + pinned_message=pinned_message, + permissions=permissions, + can_send_paid_media=can_send_paid_media, + slow_mode_delay=slow_mode_delay, + unrestrict_boost_count=unrestrict_boost_count, + message_auto_delete_time=message_auto_delete_time, + has_aggressive_anti_spam_enabled=has_aggressive_anti_spam_enabled, + has_hidden_members=has_hidden_members, + has_protected_content=has_protected_content, + has_visible_history=has_visible_history, + sticker_set_name=sticker_set_name, + can_set_sticker_set=can_set_sticker_set, + custom_emoji_sticker_set_name=custom_emoji_sticker_set_name, + linked_chat_id=linked_chat_id, + location=location, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/chat_invite_link.py b/env/Lib/site-packages/aiogram/types/chat_invite_link.py new file mode 100644 index 0000000..7817c23 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_invite_link.py @@ -0,0 +1,71 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject +from .custom import DateTime + +if TYPE_CHECKING: + from .user import User + + +class ChatInviteLink(TelegramObject): + """ + Represents an invite link for a chat. + + Source: https://core.telegram.org/bots/api#chatinvitelink + """ + + invite_link: str + """The invite link. If the link was created by another chat administrator, then the second part of the link will be replaced with '…'.""" + creator: User + """Creator of the link""" + creates_join_request: bool + """:code:`True`, if users joining the chat via the link need to be approved by chat administrators""" + is_primary: bool + """:code:`True`, if the link is primary""" + is_revoked: bool + """:code:`True`, if the link is revoked""" + name: Optional[str] = None + """*Optional*. Invite link name""" + expire_date: Optional[DateTime] = None + """*Optional*. Point in time (Unix timestamp) when the link will expire or has been expired""" + member_limit: Optional[int] = None + """*Optional*. The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999""" + pending_join_request_count: Optional[int] = None + """*Optional*. Number of pending join requests created using this link""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + invite_link: str, + creator: User, + creates_join_request: bool, + is_primary: bool, + is_revoked: bool, + name: Optional[str] = None, + expire_date: Optional[DateTime] = None, + member_limit: Optional[int] = None, + pending_join_request_count: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + invite_link=invite_link, + creator=creator, + creates_join_request=creates_join_request, + is_primary=is_primary, + is_revoked=is_revoked, + name=name, + expire_date=expire_date, + member_limit=member_limit, + pending_join_request_count=pending_join_request_count, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/chat_join_request.py b/env/Lib/site-packages/aiogram/types/chat_join_request.py new file mode 100644 index 0000000..4a128f1 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_join_request.py @@ -0,0 +1,2702 @@ +from __future__ import annotations + +import datetime +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from .base import TelegramObject +from .custom import DateTime + +if TYPE_CHECKING: + from ..methods import ( + ApproveChatJoinRequest, + DeclineChatJoinRequest, + SendAnimation, + SendAudio, + SendContact, + SendDice, + SendDocument, + SendGame, + SendInvoice, + SendLocation, + SendMediaGroup, + SendMessage, + SendPhoto, + SendPoll, + SendSticker, + SendVenue, + SendVideo, + SendVideoNote, + SendVoice, + ) + from .chat import Chat + from .chat_invite_link import ChatInviteLink + from .force_reply import ForceReply + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_file import InputFile + from .input_media_audio import InputMediaAudio + from .input_media_document import InputMediaDocument + from .input_media_photo import InputMediaPhoto + from .input_media_video import InputMediaVideo + from .input_poll_option import InputPollOption + from .labeled_price import LabeledPrice + from .link_preview_options import LinkPreviewOptions + from .message_entity import MessageEntity + from .reply_keyboard_markup import ReplyKeyboardMarkup + from .reply_keyboard_remove import ReplyKeyboardRemove + from .reply_parameters import ReplyParameters + from .user import User + + +class ChatJoinRequest(TelegramObject): + """ + Represents a join request sent to a chat. + + Source: https://core.telegram.org/bots/api#chatjoinrequest + """ + + chat: Chat + """Chat to which the request was sent""" + from_user: User = Field(..., alias="from") + """User that sent the join request""" + user_chat_id: int + """Identifier of a private chat with the user who sent the join request. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a 64-bit integer or double-precision float type are safe for storing this identifier. The bot can use this identifier for 5 minutes to send messages until the join request is processed, assuming no other administrator contacted the user.""" + date: DateTime + """Date the request was sent in Unix time""" + bio: Optional[str] = None + """*Optional*. Bio of the user.""" + invite_link: Optional[ChatInviteLink] = None + """*Optional*. Chat invite link that was used by the user to send the join request""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat: Chat, + from_user: User, + user_chat_id: int, + date: DateTime, + bio: Optional[str] = None, + invite_link: Optional[ChatInviteLink] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat=chat, + from_user=from_user, + user_chat_id=user_chat_id, + date=date, + bio=bio, + invite_link=invite_link, + **__pydantic_kwargs, + ) + + def approve( + self, + **kwargs: Any, + ) -> ApproveChatJoinRequest: + """ + Shortcut for method :class:`aiogram.methods.approve_chat_join_request.ApproveChatJoinRequest` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`user_id` + + Use this method to approve a chat join request. The bot must be an administrator in the chat for this to work and must have the *can_invite_users* administrator right. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#approvechatjoinrequest + + :return: instance of method :class:`aiogram.methods.approve_chat_join_request.ApproveChatJoinRequest` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import ApproveChatJoinRequest + + return ApproveChatJoinRequest( + chat_id=self.chat.id, + user_id=self.from_user.id, + **kwargs, + ).as_(self._bot) + + def decline( + self, + **kwargs: Any, + ) -> DeclineChatJoinRequest: + """ + Shortcut for method :class:`aiogram.methods.decline_chat_join_request.DeclineChatJoinRequest` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`user_id` + + Use this method to decline a chat join request. The bot must be an administrator in the chat for this to work and must have the *can_invite_users* administrator right. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#declinechatjoinrequest + + :return: instance of method :class:`aiogram.methods.decline_chat_join_request.DeclineChatJoinRequest` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import DeclineChatJoinRequest + + return DeclineChatJoinRequest( + chat_id=self.chat.id, + user_id=self.from_user.id, + **kwargs, + ).as_(self._bot) + + def answer( + self, + text: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + entities: Optional[List[MessageEntity]] = None, + link_preview_options: Optional[Union[LinkPreviewOptions, Default]] = Default( + "link_preview" + ), + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + disable_web_page_preview: Optional[Union[bool, Default]] = Default( + "link_preview_is_disabled" + ), + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendMessage: + """ + Shortcut for method :class:`aiogram.methods.send_message.SendMessage` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send text messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendmessage + + :param text: Text of the message to be sent, 1-4096 characters after entities parsing + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param parse_mode: Mode for parsing entities in the message text. See `formatting options `_ for more details. + :param entities: A JSON-serialized list of special entities that appear in message text, which can be specified instead of *parse_mode* + :param link_preview_options: Link preview generation options for the message + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param disable_web_page_preview: Disables link previews for links in this message + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_message.SendMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendMessage + + return SendMessage( + chat_id=self.chat.id, + text=text, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + parse_mode=parse_mode, + entities=entities, + link_preview_options=link_preview_options, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + disable_web_page_preview=disable_web_page_preview, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_pm( + self, + text: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + entities: Optional[List[MessageEntity]] = None, + link_preview_options: Optional[Union[LinkPreviewOptions, Default]] = Default( + "link_preview" + ), + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + disable_web_page_preview: Optional[Union[bool, Default]] = Default( + "link_preview_is_disabled" + ), + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendMessage: + """ + Shortcut for method :class:`aiogram.methods.send_message.SendMessage` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send text messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendmessage + + :param text: Text of the message to be sent, 1-4096 characters after entities parsing + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param parse_mode: Mode for parsing entities in the message text. See `formatting options `_ for more details. + :param entities: A JSON-serialized list of special entities that appear in message text, which can be specified instead of *parse_mode* + :param link_preview_options: Link preview generation options for the message + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param disable_web_page_preview: Disables link previews for links in this message + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_message.SendMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendMessage + + return SendMessage( + chat_id=self.user_chat_id, + text=text, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + parse_mode=parse_mode, + entities=entities, + link_preview_options=link_preview_options, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + disable_web_page_preview=disable_web_page_preview, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_animation( + self, + animation: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + duration: Optional[int] = None, + width: Optional[int] = None, + height: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendAnimation: + """ + Shortcut for method :class:`aiogram.methods.send_animation.SendAnimation` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send animation files (GIF or H.264/MPEG-4 AVC video without sound). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send animation files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendanimation + + :param animation: Animation to send. Pass a file_id as String to send an animation that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an animation from the Internet, or upload a new animation using multipart/form-data. :ref:`More information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param duration: Duration of sent animation in seconds + :param width: Animation width + :param height: Animation height + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Animation caption (may also be used when resending animation by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the animation caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the animation needs to be covered with a spoiler animation + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_animation.SendAnimation` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendAnimation + + return SendAnimation( + chat_id=self.chat.id, + animation=animation, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + duration=duration, + width=width, + height=height, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_animation_pm( + self, + animation: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + duration: Optional[int] = None, + width: Optional[int] = None, + height: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendAnimation: + """ + Shortcut for method :class:`aiogram.methods.send_animation.SendAnimation` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send animation files (GIF or H.264/MPEG-4 AVC video without sound). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send animation files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendanimation + + :param animation: Animation to send. Pass a file_id as String to send an animation that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an animation from the Internet, or upload a new animation using multipart/form-data. :ref:`More information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param duration: Duration of sent animation in seconds + :param width: Animation width + :param height: Animation height + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Animation caption (may also be used when resending animation by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the animation caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the animation needs to be covered with a spoiler animation + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_animation.SendAnimation` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendAnimation + + return SendAnimation( + chat_id=self.user_chat_id, + animation=animation, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + duration=duration, + width=width, + height=height, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_audio( + self, + audio: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + performer: Optional[str] = None, + title: Optional[str] = None, + thumbnail: Optional[InputFile] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendAudio: + """ + Shortcut for method :class:`aiogram.methods.send_audio.SendAudio` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send audio files, if you want Telegram clients to display them in the music player. Your audio must be in the .MP3 or .M4A format. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future. + For sending voice messages, use the :class:`aiogram.methods.send_voice.SendVoice` method instead. + + Source: https://core.telegram.org/bots/api#sendaudio + + :param audio: Audio file to send. Pass a file_id as String to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param caption: Audio caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the audio caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param duration: Duration of the audio in seconds + :param performer: Performer + :param title: Track name + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_audio.SendAudio` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendAudio + + return SendAudio( + chat_id=self.chat.id, + audio=audio, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + duration=duration, + performer=performer, + title=title, + thumbnail=thumbnail, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_audio_pm( + self, + audio: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + performer: Optional[str] = None, + title: Optional[str] = None, + thumbnail: Optional[InputFile] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendAudio: + """ + Shortcut for method :class:`aiogram.methods.send_audio.SendAudio` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send audio files, if you want Telegram clients to display them in the music player. Your audio must be in the .MP3 or .M4A format. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future. + For sending voice messages, use the :class:`aiogram.methods.send_voice.SendVoice` method instead. + + Source: https://core.telegram.org/bots/api#sendaudio + + :param audio: Audio file to send. Pass a file_id as String to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param caption: Audio caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the audio caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param duration: Duration of the audio in seconds + :param performer: Performer + :param title: Track name + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_audio.SendAudio` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendAudio + + return SendAudio( + chat_id=self.user_chat_id, + audio=audio, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + duration=duration, + performer=performer, + title=title, + thumbnail=thumbnail, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_contact( + self, + phone_number: str, + first_name: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + last_name: Optional[str] = None, + vcard: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendContact: + """ + Shortcut for method :class:`aiogram.methods.send_contact.SendContact` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send phone contacts. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendcontact + + :param phone_number: Contact's phone number + :param first_name: Contact's first name + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param last_name: Contact's last name + :param vcard: Additional data about the contact in the form of a `vCard `_, 0-2048 bytes + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_contact.SendContact` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendContact + + return SendContact( + chat_id=self.chat.id, + phone_number=phone_number, + first_name=first_name, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + last_name=last_name, + vcard=vcard, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_contact_pm( + self, + phone_number: str, + first_name: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + last_name: Optional[str] = None, + vcard: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendContact: + """ + Shortcut for method :class:`aiogram.methods.send_contact.SendContact` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send phone contacts. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendcontact + + :param phone_number: Contact's phone number + :param first_name: Contact's first name + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param last_name: Contact's last name + :param vcard: Additional data about the contact in the form of a `vCard `_, 0-2048 bytes + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_contact.SendContact` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendContact + + return SendContact( + chat_id=self.user_chat_id, + phone_number=phone_number, + first_name=first_name, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + last_name=last_name, + vcard=vcard, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_document( + self, + document: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + disable_content_type_detection: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendDocument: + """ + Shortcut for method :class:`aiogram.methods.send_document.SendDocument` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send general files. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#senddocument + + :param document: File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), 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 information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Document caption (may also be used when resending documents by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the document caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param disable_content_type_detection: Disables automatic server-side content type detection for files uploaded using multipart/form-data + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_document.SendDocument` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendDocument + + return SendDocument( + chat_id=self.chat.id, + document=document, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + disable_content_type_detection=disable_content_type_detection, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_document_pm( + self, + document: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + disable_content_type_detection: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendDocument: + """ + Shortcut for method :class:`aiogram.methods.send_document.SendDocument` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send general files. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#senddocument + + :param document: File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), 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 information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Document caption (may also be used when resending documents by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the document caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param disable_content_type_detection: Disables automatic server-side content type detection for files uploaded using multipart/form-data + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_document.SendDocument` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendDocument + + return SendDocument( + chat_id=self.user_chat_id, + document=document, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + disable_content_type_detection=disable_content_type_detection, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_game( + self, + game_short_name: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendGame: + """ + Shortcut for method :class:`aiogram.methods.send_game.SendGame` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send a game. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendgame + + :param game_short_name: Short name of the game, serves as the unique identifier for the game. Set up your games via `@BotFather `_. + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game. + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_game.SendGame` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendGame + + return SendGame( + chat_id=self.chat.id, + game_short_name=game_short_name, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_game_pm( + self, + game_short_name: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendGame: + """ + Shortcut for method :class:`aiogram.methods.send_game.SendGame` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send a game. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendgame + + :param game_short_name: Short name of the game, serves as the unique identifier for the game. Set up your games via `@BotFather `_. + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game. + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_game.SendGame` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendGame + + return SendGame( + chat_id=self.user_chat_id, + game_short_name=game_short_name, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_invoice( + self, + title: str, + description: str, + payload: str, + currency: str, + prices: List[LabeledPrice], + message_thread_id: Optional[int] = None, + provider_token: Optional[str] = None, + max_tip_amount: Optional[int] = None, + suggested_tip_amounts: Optional[List[int]] = None, + start_parameter: Optional[str] = None, + provider_data: Optional[str] = None, + photo_url: Optional[str] = None, + photo_size: Optional[int] = None, + photo_width: Optional[int] = None, + photo_height: Optional[int] = None, + need_name: Optional[bool] = None, + need_phone_number: Optional[bool] = None, + need_email: Optional[bool] = None, + need_shipping_address: Optional[bool] = None, + send_phone_number_to_provider: Optional[bool] = None, + send_email_to_provider: Optional[bool] = None, + is_flexible: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendInvoice: + """ + Shortcut for method :class:`aiogram.methods.send_invoice.SendInvoice` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send invoices. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendinvoice + + :param title: Product name, 1-32 characters + :param description: Product description, 1-255 characters + :param payload: Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use for your internal processes. + :param currency: Three-letter ISO 4217 currency code, see `more on currencies `_. Pass 'XTR' for payments in `Telegram Stars `_. + :param prices: Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.). Must contain exactly one item for payments in `Telegram Stars `_. + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param provider_token: Payment provider token, obtained via `@BotFather `_. Pass an empty string for payments in `Telegram Stars `_. + :param max_tip_amount: The maximum accepted amount for tips in the *smallest units* of the currency (integer, **not** float/double). For example, for a maximum tip of :code:`US$ 1.45` pass :code:`max_tip_amount = 145`. See the *exp* parameter in `currencies.json `_, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0. Not supported for payments in `Telegram Stars `_. + :param suggested_tip_amounts: A JSON-serialized array of suggested amounts of tips in the *smallest units* of the currency (integer, **not** float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed *max_tip_amount*. + :param start_parameter: Unique deep-linking parameter. If left empty, **forwarded copies** of the sent message will have a *Pay* button, allowing multiple users to pay directly from the forwarded message, using the same invoice. If non-empty, forwarded copies of the sent message will have a *URL* button with a deep link to the bot (instead of a *Pay* button), with the value used as the start parameter + :param provider_data: JSON-serialized data about the invoice, which will be shared with the payment provider. A detailed description of required fields should be provided by the payment provider. + :param photo_url: URL of the product photo for the invoice. Can be a photo of the goods or a marketing image for a service. People like it better when they see what they are paying for. + :param photo_size: Photo size in bytes + :param photo_width: Photo width + :param photo_height: Photo height + :param need_name: Pass :code:`True` if you require the user's full name to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_phone_number: Pass :code:`True` if you require the user's phone number to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_email: Pass :code:`True` if you require the user's email address to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_shipping_address: Pass :code:`True` if you require the user's shipping address to complete the order. Ignored for payments in `Telegram Stars `_. + :param send_phone_number_to_provider: Pass :code:`True` if the user's phone number should be sent to the provider. Ignored for payments in `Telegram Stars `_. + :param send_email_to_provider: Pass :code:`True` if the user's email address should be sent to the provider. Ignored for payments in `Telegram Stars `_. + :param is_flexible: Pass :code:`True` if the final price depends on the shipping method. Ignored for payments in `Telegram Stars `_. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Pay :code:`total price`' button will be shown. If not empty, the first button must be a Pay button. + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_invoice.SendInvoice` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendInvoice + + return SendInvoice( + chat_id=self.chat.id, + title=title, + description=description, + payload=payload, + currency=currency, + prices=prices, + message_thread_id=message_thread_id, + provider_token=provider_token, + max_tip_amount=max_tip_amount, + suggested_tip_amounts=suggested_tip_amounts, + start_parameter=start_parameter, + provider_data=provider_data, + photo_url=photo_url, + photo_size=photo_size, + photo_width=photo_width, + photo_height=photo_height, + need_name=need_name, + need_phone_number=need_phone_number, + need_email=need_email, + need_shipping_address=need_shipping_address, + send_phone_number_to_provider=send_phone_number_to_provider, + send_email_to_provider=send_email_to_provider, + is_flexible=is_flexible, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_invoice_pm( + self, + title: str, + description: str, + payload: str, + currency: str, + prices: List[LabeledPrice], + message_thread_id: Optional[int] = None, + provider_token: Optional[str] = None, + max_tip_amount: Optional[int] = None, + suggested_tip_amounts: Optional[List[int]] = None, + start_parameter: Optional[str] = None, + provider_data: Optional[str] = None, + photo_url: Optional[str] = None, + photo_size: Optional[int] = None, + photo_width: Optional[int] = None, + photo_height: Optional[int] = None, + need_name: Optional[bool] = None, + need_phone_number: Optional[bool] = None, + need_email: Optional[bool] = None, + need_shipping_address: Optional[bool] = None, + send_phone_number_to_provider: Optional[bool] = None, + send_email_to_provider: Optional[bool] = None, + is_flexible: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendInvoice: + """ + Shortcut for method :class:`aiogram.methods.send_invoice.SendInvoice` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send invoices. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendinvoice + + :param title: Product name, 1-32 characters + :param description: Product description, 1-255 characters + :param payload: Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use for your internal processes. + :param currency: Three-letter ISO 4217 currency code, see `more on currencies `_. Pass 'XTR' for payments in `Telegram Stars `_. + :param prices: Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.). Must contain exactly one item for payments in `Telegram Stars `_. + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param provider_token: Payment provider token, obtained via `@BotFather `_. Pass an empty string for payments in `Telegram Stars `_. + :param max_tip_amount: The maximum accepted amount for tips in the *smallest units* of the currency (integer, **not** float/double). For example, for a maximum tip of :code:`US$ 1.45` pass :code:`max_tip_amount = 145`. See the *exp* parameter in `currencies.json `_, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0. Not supported for payments in `Telegram Stars `_. + :param suggested_tip_amounts: A JSON-serialized array of suggested amounts of tips in the *smallest units* of the currency (integer, **not** float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed *max_tip_amount*. + :param start_parameter: Unique deep-linking parameter. If left empty, **forwarded copies** of the sent message will have a *Pay* button, allowing multiple users to pay directly from the forwarded message, using the same invoice. If non-empty, forwarded copies of the sent message will have a *URL* button with a deep link to the bot (instead of a *Pay* button), with the value used as the start parameter + :param provider_data: JSON-serialized data about the invoice, which will be shared with the payment provider. A detailed description of required fields should be provided by the payment provider. + :param photo_url: URL of the product photo for the invoice. Can be a photo of the goods or a marketing image for a service. People like it better when they see what they are paying for. + :param photo_size: Photo size in bytes + :param photo_width: Photo width + :param photo_height: Photo height + :param need_name: Pass :code:`True` if you require the user's full name to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_phone_number: Pass :code:`True` if you require the user's phone number to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_email: Pass :code:`True` if you require the user's email address to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_shipping_address: Pass :code:`True` if you require the user's shipping address to complete the order. Ignored for payments in `Telegram Stars `_. + :param send_phone_number_to_provider: Pass :code:`True` if the user's phone number should be sent to the provider. Ignored for payments in `Telegram Stars `_. + :param send_email_to_provider: Pass :code:`True` if the user's email address should be sent to the provider. Ignored for payments in `Telegram Stars `_. + :param is_flexible: Pass :code:`True` if the final price depends on the shipping method. Ignored for payments in `Telegram Stars `_. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Pay :code:`total price`' button will be shown. If not empty, the first button must be a Pay button. + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_invoice.SendInvoice` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendInvoice + + return SendInvoice( + chat_id=self.user_chat_id, + title=title, + description=description, + payload=payload, + currency=currency, + prices=prices, + message_thread_id=message_thread_id, + provider_token=provider_token, + max_tip_amount=max_tip_amount, + suggested_tip_amounts=suggested_tip_amounts, + start_parameter=start_parameter, + provider_data=provider_data, + photo_url=photo_url, + photo_size=photo_size, + photo_width=photo_width, + photo_height=photo_height, + need_name=need_name, + need_phone_number=need_phone_number, + need_email=need_email, + need_shipping_address=need_shipping_address, + send_phone_number_to_provider=send_phone_number_to_provider, + send_email_to_provider=send_email_to_provider, + is_flexible=is_flexible, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_location( + self, + latitude: float, + longitude: float, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + horizontal_accuracy: Optional[float] = None, + live_period: Optional[int] = None, + heading: Optional[int] = None, + proximity_alert_radius: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendLocation: + """ + Shortcut for method :class:`aiogram.methods.send_location.SendLocation` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send point on the map. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendlocation + + :param latitude: Latitude of the location + :param longitude: Longitude of the location + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param horizontal_accuracy: The radius of uncertainty for the location, measured in meters; 0-1500 + :param live_period: Period in seconds during which the location will be updated (see `Live Locations `_, should be between 60 and 86400, or 0x7FFFFFFF for live locations that can be edited indefinitely. + :param heading: For live locations, a direction in which the user is moving, in degrees. Must be between 1 and 360 if specified. + :param proximity_alert_radius: For live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_location.SendLocation` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendLocation + + return SendLocation( + chat_id=self.chat.id, + latitude=latitude, + longitude=longitude, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + horizontal_accuracy=horizontal_accuracy, + live_period=live_period, + heading=heading, + proximity_alert_radius=proximity_alert_radius, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_location_pm( + self, + latitude: float, + longitude: float, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + horizontal_accuracy: Optional[float] = None, + live_period: Optional[int] = None, + heading: Optional[int] = None, + proximity_alert_radius: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendLocation: + """ + Shortcut for method :class:`aiogram.methods.send_location.SendLocation` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send point on the map. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendlocation + + :param latitude: Latitude of the location + :param longitude: Longitude of the location + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param horizontal_accuracy: The radius of uncertainty for the location, measured in meters; 0-1500 + :param live_period: Period in seconds during which the location will be updated (see `Live Locations `_, should be between 60 and 86400, or 0x7FFFFFFF for live locations that can be edited indefinitely. + :param heading: For live locations, a direction in which the user is moving, in degrees. Must be between 1 and 360 if specified. + :param proximity_alert_radius: For live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_location.SendLocation` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendLocation + + return SendLocation( + chat_id=self.user_chat_id, + latitude=latitude, + longitude=longitude, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + horizontal_accuracy=horizontal_accuracy, + live_period=live_period, + heading=heading, + proximity_alert_radius=proximity_alert_radius, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_media_group( + self, + media: List[Union[InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo]], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendMediaGroup: + """ + Shortcut for method :class:`aiogram.methods.send_media_group.SendMediaGroup` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send a group of photos, videos, documents or audios as an album. Documents and audio files can be only grouped in an album with messages of the same type. On success, an array of `Messages `_ that were sent is returned. + + Source: https://core.telegram.org/bots/api#sendmediagroup + + :param media: A JSON-serialized array describing messages to be sent, must include 2-10 items + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param disable_notification: Sends messages `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent messages from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the messages are a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_media_group.SendMediaGroup` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendMediaGroup + + return SendMediaGroup( + chat_id=self.chat.id, + media=media, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_media_group_pm( + self, + media: List[Union[InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo]], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendMediaGroup: + """ + Shortcut for method :class:`aiogram.methods.send_media_group.SendMediaGroup` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send a group of photos, videos, documents or audios as an album. Documents and audio files can be only grouped in an album with messages of the same type. On success, an array of `Messages `_ that were sent is returned. + + Source: https://core.telegram.org/bots/api#sendmediagroup + + :param media: A JSON-serialized array describing messages to be sent, must include 2-10 items + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param disable_notification: Sends messages `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent messages from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the messages are a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_media_group.SendMediaGroup` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendMediaGroup + + return SendMediaGroup( + chat_id=self.user_chat_id, + media=media, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_photo( + self, + photo: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendPhoto: + """ + Shortcut for method :class:`aiogram.methods.send_photo.SendPhoto` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send photos. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendphoto + + :param photo: Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data. The photo must be at most 10 MB in size. The photo's width and height must not exceed 10000 in total. Width and height ratio must be at most 20. :ref:`More information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param caption: Photo caption (may also be used when resending photos by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the photo caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the photo needs to be covered with a spoiler animation + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_photo.SendPhoto` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendPhoto + + return SendPhoto( + chat_id=self.chat.id, + photo=photo, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_photo_pm( + self, + photo: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendPhoto: + """ + Shortcut for method :class:`aiogram.methods.send_photo.SendPhoto` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send photos. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendphoto + + :param photo: Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data. The photo must be at most 10 MB in size. The photo's width and height must not exceed 10000 in total. Width and height ratio must be at most 20. :ref:`More information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param caption: Photo caption (may also be used when resending photos by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the photo caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the photo needs to be covered with a spoiler animation + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_photo.SendPhoto` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendPhoto + + return SendPhoto( + chat_id=self.user_chat_id, + photo=photo, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_poll( + self, + question: str, + options: List[Union[InputPollOption, str]], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + question_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + question_entities: Optional[List[MessageEntity]] = None, + is_anonymous: Optional[bool] = None, + type: Optional[str] = None, + allows_multiple_answers: Optional[bool] = None, + correct_option_id: Optional[int] = None, + explanation: Optional[str] = None, + explanation_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + explanation_entities: Optional[List[MessageEntity]] = None, + open_period: Optional[int] = None, + close_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + is_closed: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendPoll: + """ + Shortcut for method :class:`aiogram.methods.send_poll.SendPoll` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send a native poll. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendpoll + + :param question: Poll question, 1-300 characters + :param options: A JSON-serialized list of 2-10 answer options + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param question_parse_mode: Mode for parsing entities in the question. See `formatting options `_ for more details. Currently, only custom emoji entities are allowed + :param question_entities: A JSON-serialized list of special entities that appear in the poll question. It can be specified instead of *question_parse_mode* + :param is_anonymous: :code:`True`, if the poll needs to be anonymous, defaults to :code:`True` + :param type: Poll type, 'quiz' or 'regular', defaults to 'regular' + :param allows_multiple_answers: :code:`True`, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to :code:`False` + :param correct_option_id: 0-based identifier of the correct answer option, required for polls in quiz mode + :param explanation: Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing + :param explanation_parse_mode: Mode for parsing entities in the explanation. See `formatting options `_ for more details. + :param explanation_entities: A JSON-serialized list of special entities that appear in the poll explanation. It can be specified instead of *explanation_parse_mode* + :param open_period: Amount of time in seconds the poll will be active after creation, 5-600. Can't be used together with *close_date*. + :param close_date: Point in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future. Can't be used together with *open_period*. + :param is_closed: Pass :code:`True` if the poll needs to be immediately closed. This can be useful for poll preview. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_poll.SendPoll` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendPoll + + return SendPoll( + chat_id=self.chat.id, + question=question, + options=options, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + question_parse_mode=question_parse_mode, + question_entities=question_entities, + is_anonymous=is_anonymous, + type=type, + allows_multiple_answers=allows_multiple_answers, + correct_option_id=correct_option_id, + explanation=explanation, + explanation_parse_mode=explanation_parse_mode, + explanation_entities=explanation_entities, + open_period=open_period, + close_date=close_date, + is_closed=is_closed, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_poll_pm( + self, + question: str, + options: List[Union[InputPollOption, str]], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + question_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + question_entities: Optional[List[MessageEntity]] = None, + is_anonymous: Optional[bool] = None, + type: Optional[str] = None, + allows_multiple_answers: Optional[bool] = None, + correct_option_id: Optional[int] = None, + explanation: Optional[str] = None, + explanation_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + explanation_entities: Optional[List[MessageEntity]] = None, + open_period: Optional[int] = None, + close_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + is_closed: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendPoll: + """ + Shortcut for method :class:`aiogram.methods.send_poll.SendPoll` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send a native poll. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendpoll + + :param question: Poll question, 1-300 characters + :param options: A JSON-serialized list of 2-10 answer options + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param question_parse_mode: Mode for parsing entities in the question. See `formatting options `_ for more details. Currently, only custom emoji entities are allowed + :param question_entities: A JSON-serialized list of special entities that appear in the poll question. It can be specified instead of *question_parse_mode* + :param is_anonymous: :code:`True`, if the poll needs to be anonymous, defaults to :code:`True` + :param type: Poll type, 'quiz' or 'regular', defaults to 'regular' + :param allows_multiple_answers: :code:`True`, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to :code:`False` + :param correct_option_id: 0-based identifier of the correct answer option, required for polls in quiz mode + :param explanation: Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing + :param explanation_parse_mode: Mode for parsing entities in the explanation. See `formatting options `_ for more details. + :param explanation_entities: A JSON-serialized list of special entities that appear in the poll explanation. It can be specified instead of *explanation_parse_mode* + :param open_period: Amount of time in seconds the poll will be active after creation, 5-600. Can't be used together with *close_date*. + :param close_date: Point in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future. Can't be used together with *open_period*. + :param is_closed: Pass :code:`True` if the poll needs to be immediately closed. This can be useful for poll preview. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_poll.SendPoll` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendPoll + + return SendPoll( + chat_id=self.user_chat_id, + question=question, + options=options, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + question_parse_mode=question_parse_mode, + question_entities=question_entities, + is_anonymous=is_anonymous, + type=type, + allows_multiple_answers=allows_multiple_answers, + correct_option_id=correct_option_id, + explanation=explanation, + explanation_parse_mode=explanation_parse_mode, + explanation_entities=explanation_entities, + open_period=open_period, + close_date=close_date, + is_closed=is_closed, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_dice( + self, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + emoji: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendDice: + """ + Shortcut for method :class:`aiogram.methods.send_dice.SendDice` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send an animated emoji that will display a random value. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#senddice + + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param emoji: Emoji on which the dice throw animation is based. Currently, must be one of '🎲', '🎯', '🏀', '⚽', '🎳', or '🎰'. Dice can have values 1-6 for '🎲', '🎯' and '🎳', values 1-5 for '🏀' and '⚽', and values 1-64 for '🎰'. Defaults to '🎲' + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_dice.SendDice` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendDice + + return SendDice( + chat_id=self.chat.id, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + emoji=emoji, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_dice_pm( + self, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + emoji: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendDice: + """ + Shortcut for method :class:`aiogram.methods.send_dice.SendDice` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send an animated emoji that will display a random value. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#senddice + + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param emoji: Emoji on which the dice throw animation is based. Currently, must be one of '🎲', '🎯', '🏀', '⚽', '🎳', or '🎰'. Dice can have values 1-6 for '🎲', '🎯' and '🎳', values 1-5 for '🏀' and '⚽', and values 1-64 for '🎰'. Defaults to '🎲' + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_dice.SendDice` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendDice + + return SendDice( + chat_id=self.user_chat_id, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + emoji=emoji, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_sticker( + self, + sticker: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + emoji: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendSticker: + """ + Shortcut for method :class:`aiogram.methods.send_sticker.SendSticker` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send static .WEBP, `animated `_ .TGS, or `video `_ .WEBM stickers. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendsticker + + :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP, .TGS, or .WEBM sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video and animated stickers can't be sent via an HTTP URL. + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param emoji: Emoji associated with the sticker; only for just uploaded stickers + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_sticker.SendSticker` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendSticker + + return SendSticker( + chat_id=self.chat.id, + sticker=sticker, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + emoji=emoji, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_sticker_pm( + self, + sticker: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + emoji: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendSticker: + """ + Shortcut for method :class:`aiogram.methods.send_sticker.SendSticker` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send static .WEBP, `animated `_ .TGS, or `video `_ .WEBM stickers. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendsticker + + :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP, .TGS, or .WEBM sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video and animated stickers can't be sent via an HTTP URL. + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param emoji: Emoji associated with the sticker; only for just uploaded stickers + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_sticker.SendSticker` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendSticker + + return SendSticker( + chat_id=self.user_chat_id, + sticker=sticker, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + emoji=emoji, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_venue( + self, + latitude: float, + longitude: float, + title: str, + address: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + foursquare_id: Optional[str] = None, + foursquare_type: Optional[str] = None, + google_place_id: Optional[str] = None, + google_place_type: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendVenue: + """ + Shortcut for method :class:`aiogram.methods.send_venue.SendVenue` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send information about a venue. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvenue + + :param latitude: Latitude of the venue + :param longitude: Longitude of the venue + :param title: Name of the venue + :param address: Address of the venue + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param foursquare_id: Foursquare identifier of the venue + :param foursquare_type: Foursquare type of the venue, if known. (For example, 'arts_entertainment/default', 'arts_entertainment/aquarium' or 'food/icecream'.) + :param google_place_id: Google Places identifier of the venue + :param google_place_type: Google Places type of the venue. (See `supported types `_.) + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_venue.SendVenue` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVenue + + return SendVenue( + chat_id=self.chat.id, + latitude=latitude, + longitude=longitude, + title=title, + address=address, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + foursquare_id=foursquare_id, + foursquare_type=foursquare_type, + google_place_id=google_place_id, + google_place_type=google_place_type, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_venue_pm( + self, + latitude: float, + longitude: float, + title: str, + address: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + foursquare_id: Optional[str] = None, + foursquare_type: Optional[str] = None, + google_place_id: Optional[str] = None, + google_place_type: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendVenue: + """ + Shortcut for method :class:`aiogram.methods.send_venue.SendVenue` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send information about a venue. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvenue + + :param latitude: Latitude of the venue + :param longitude: Longitude of the venue + :param title: Name of the venue + :param address: Address of the venue + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param foursquare_id: Foursquare identifier of the venue + :param foursquare_type: Foursquare type of the venue, if known. (For example, 'arts_entertainment/default', 'arts_entertainment/aquarium' or 'food/icecream'.) + :param google_place_id: Google Places identifier of the venue + :param google_place_type: Google Places type of the venue. (See `supported types `_.) + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_venue.SendVenue` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVenue + + return SendVenue( + chat_id=self.user_chat_id, + latitude=latitude, + longitude=longitude, + title=title, + address=address, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + foursquare_id=foursquare_id, + foursquare_type=foursquare_type, + google_place_id=google_place_id, + google_place_type=google_place_type, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_video( + self, + video: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + duration: Optional[int] = None, + width: Optional[int] = None, + height: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + supports_streaming: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendVideo: + """ + Shortcut for method :class:`aiogram.methods.send_video.SendVideo` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send video files, Telegram clients support MPEG4 videos (other formats may be sent as :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvideo + + :param video: Video to send. Pass a file_id as String to send a video that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a video from the Internet, or upload a new video using multipart/form-data. :ref:`More information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param duration: Duration of sent video in seconds + :param width: Video width + :param height: Video height + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Video caption (may also be used when resending videos by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the video caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the video needs to be covered with a spoiler animation + :param supports_streaming: Pass :code:`True` if the uploaded video is suitable for streaming + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_video.SendVideo` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVideo + + return SendVideo( + chat_id=self.chat.id, + video=video, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + duration=duration, + width=width, + height=height, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + supports_streaming=supports_streaming, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_video_pm( + self, + video: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + duration: Optional[int] = None, + width: Optional[int] = None, + height: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + supports_streaming: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendVideo: + """ + Shortcut for method :class:`aiogram.methods.send_video.SendVideo` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send video files, Telegram clients support MPEG4 videos (other formats may be sent as :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvideo + + :param video: Video to send. Pass a file_id as String to send a video that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a video from the Internet, or upload a new video using multipart/form-data. :ref:`More information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param duration: Duration of sent video in seconds + :param width: Video width + :param height: Video height + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Video caption (may also be used when resending videos by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the video caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the video needs to be covered with a spoiler animation + :param supports_streaming: Pass :code:`True` if the uploaded video is suitable for streaming + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_video.SendVideo` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVideo + + return SendVideo( + chat_id=self.user_chat_id, + video=video, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + duration=duration, + width=width, + height=height, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + supports_streaming=supports_streaming, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_video_note( + self, + video_note: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + duration: Optional[int] = None, + length: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendVideoNote: + """ + Shortcut for method :class:`aiogram.methods.send_video_note.SendVideoNote` + will automatically fill method attributes: + + - :code:`chat_id` + + As of `v.4.0 `_, Telegram clients support rounded square MPEG4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvideonote + + :param video_note: Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data. :ref:`More information on Sending Files » `. Sending video notes by a URL is currently unsupported + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param duration: Duration of sent video in seconds + :param length: Video width and height, i.e. diameter of the video message + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_video_note.SendVideoNote` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVideoNote + + return SendVideoNote( + chat_id=self.chat.id, + video_note=video_note, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + duration=duration, + length=length, + thumbnail=thumbnail, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_video_note_pm( + self, + video_note: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + duration: Optional[int] = None, + length: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendVideoNote: + """ + Shortcut for method :class:`aiogram.methods.send_video_note.SendVideoNote` + will automatically fill method attributes: + + - :code:`chat_id` + + As of `v.4.0 `_, Telegram clients support rounded square MPEG4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvideonote + + :param video_note: Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data. :ref:`More information on Sending Files » `. Sending video notes by a URL is currently unsupported + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param duration: Duration of sent video in seconds + :param length: Video width and height, i.e. diameter of the video message + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_video_note.SendVideoNote` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVideoNote + + return SendVideoNote( + chat_id=self.user_chat_id, + video_note=video_note, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + duration=duration, + length=length, + thumbnail=thumbnail, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_voice( + self, + voice: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendVoice: + """ + Shortcut for method :class:`aiogram.methods.send_voice.SendVoice` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send audio files, if you want Telegram clients to display the file as a playable voice message. For this to work, your audio must be in an .OGG file encoded with OPUS, or in .MP3 format, or in .M4A format (other formats may be sent as :class:`aiogram.types.audio.Audio` or :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send voice messages of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvoice + + :param voice: Audio file to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), 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 information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param caption: Voice message caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the voice message caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param duration: Duration of the voice message in seconds + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_voice.SendVoice` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVoice + + return SendVoice( + chat_id=self.chat.id, + voice=voice, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + duration=duration, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_voice_pm( + self, + voice: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendVoice: + """ + Shortcut for method :class:`aiogram.methods.send_voice.SendVoice` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send audio files, if you want Telegram clients to display the file as a playable voice message. For this to work, your audio must be in an .OGG file encoded with OPUS, or in .MP3 format, or in .M4A format (other formats may be sent as :class:`aiogram.types.audio.Audio` or :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send voice messages of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvoice + + :param voice: Audio file to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), 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 information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param caption: Voice message caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the voice message caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param duration: Duration of the voice message in seconds + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_voice.SendVoice` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVoice + + return SendVoice( + chat_id=self.user_chat_id, + voice=voice, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + duration=duration, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) diff --git a/env/Lib/site-packages/aiogram/types/chat_location.py b/env/Lib/site-packages/aiogram/types/chat_location.py new file mode 100644 index 0000000..ad64a3c --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_location.py @@ -0,0 +1,34 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + +if TYPE_CHECKING: + from .location import Location + + +class ChatLocation(TelegramObject): + """ + Represents a location to which a chat is connected. + + Source: https://core.telegram.org/bots/api#chatlocation + """ + + location: Location + """The location to which the supergroup is connected. Can't be a live location.""" + address: str + """Location address; 1-64 characters, as defined by the chat owner""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, location: Location, address: str, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(location=location, address=address, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/chat_member.py b/env/Lib/site-packages/aiogram/types/chat_member.py new file mode 100644 index 0000000..018bebd --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_member.py @@ -0,0 +1,18 @@ +from __future__ import annotations + +from .base import TelegramObject + + +class ChatMember(TelegramObject): + """ + This object contains information about one member of a chat. Currently, the following 6 types of chat members are supported: + + - :class:`aiogram.types.chat_member_owner.ChatMemberOwner` + - :class:`aiogram.types.chat_member_administrator.ChatMemberAdministrator` + - :class:`aiogram.types.chat_member_member.ChatMemberMember` + - :class:`aiogram.types.chat_member_restricted.ChatMemberRestricted` + - :class:`aiogram.types.chat_member_left.ChatMemberLeft` + - :class:`aiogram.types.chat_member_banned.ChatMemberBanned` + + Source: https://core.telegram.org/bots/api#chatmember + """ diff --git a/env/Lib/site-packages/aiogram/types/chat_member_administrator.py b/env/Lib/site-packages/aiogram/types/chat_member_administrator.py new file mode 100644 index 0000000..10552f7 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_member_administrator.py @@ -0,0 +1,111 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional + +from ..enums import ChatMemberStatus +from .chat_member import ChatMember + +if TYPE_CHECKING: + from .user import User + + +class ChatMemberAdministrator(ChatMember): + """ + Represents a `chat member `_ that has some additional privileges. + + Source: https://core.telegram.org/bots/api#chatmemberadministrator + """ + + status: Literal[ChatMemberStatus.ADMINISTRATOR] = ChatMemberStatus.ADMINISTRATOR + """The member's status in the chat, always 'administrator'""" + user: User + """Information about the user""" + can_be_edited: bool + """:code:`True`, if the bot is allowed to edit administrator privileges of that user""" + is_anonymous: bool + """:code:`True`, if the user's presence in the chat is hidden""" + can_manage_chat: bool + """:code:`True`, if the administrator can access the chat event log, get boost list, see hidden supergroup and channel members, report spam messages and ignore slow mode. Implied by any other administrator privilege.""" + can_delete_messages: bool + """:code:`True`, if the administrator can delete messages of other users""" + can_manage_video_chats: bool + """:code:`True`, if the administrator can manage video chats""" + can_restrict_members: bool + """:code:`True`, if the administrator can restrict, ban or unban chat members, or access supergroup statistics""" + can_promote_members: bool + """:code:`True`, if the administrator can add new administrators with a subset of their own privileges or demote administrators that they have promoted, directly or indirectly (promoted by administrators that were appointed by the user)""" + can_change_info: bool + """:code:`True`, if the user is allowed to change the chat title, photo and other settings""" + can_invite_users: bool + """:code:`True`, if the user is allowed to invite new users to the chat""" + can_post_stories: bool + """:code:`True`, if the administrator can post stories to the chat""" + can_edit_stories: bool + """:code:`True`, if the administrator can edit stories posted by other users, post stories to the chat page, pin chat stories, and access the chat's story archive""" + can_delete_stories: bool + """:code:`True`, if the administrator can delete stories posted by other users""" + can_post_messages: Optional[bool] = None + """*Optional*. :code:`True`, if the administrator can post messages in the channel, or access channel statistics; for channels only""" + can_edit_messages: Optional[bool] = None + """*Optional*. :code:`True`, if the administrator can edit messages of other users and can pin messages; for channels only""" + can_pin_messages: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to pin messages; for groups and supergroups only""" + can_manage_topics: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only""" + custom_title: Optional[str] = None + """*Optional*. Custom title for this user""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + status: Literal[ChatMemberStatus.ADMINISTRATOR] = ChatMemberStatus.ADMINISTRATOR, + user: User, + can_be_edited: bool, + is_anonymous: bool, + can_manage_chat: bool, + can_delete_messages: bool, + can_manage_video_chats: bool, + can_restrict_members: bool, + can_promote_members: bool, + can_change_info: bool, + can_invite_users: bool, + can_post_stories: bool, + can_edit_stories: bool, + can_delete_stories: bool, + can_post_messages: Optional[bool] = None, + can_edit_messages: Optional[bool] = None, + can_pin_messages: Optional[bool] = None, + can_manage_topics: Optional[bool] = None, + custom_title: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + status=status, + user=user, + can_be_edited=can_be_edited, + is_anonymous=is_anonymous, + can_manage_chat=can_manage_chat, + can_delete_messages=can_delete_messages, + can_manage_video_chats=can_manage_video_chats, + can_restrict_members=can_restrict_members, + can_promote_members=can_promote_members, + can_change_info=can_change_info, + can_invite_users=can_invite_users, + can_post_stories=can_post_stories, + can_edit_stories=can_edit_stories, + can_delete_stories=can_delete_stories, + can_post_messages=can_post_messages, + can_edit_messages=can_edit_messages, + can_pin_messages=can_pin_messages, + can_manage_topics=can_manage_topics, + custom_title=custom_title, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/chat_member_banned.py b/env/Lib/site-packages/aiogram/types/chat_member_banned.py new file mode 100644 index 0000000..65776c5 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_member_banned.py @@ -0,0 +1,43 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import ChatMemberStatus +from .chat_member import ChatMember +from .custom import DateTime + +if TYPE_CHECKING: + from .user import User + + +class ChatMemberBanned(ChatMember): + """ + Represents a `chat member `_ that was banned in the chat and can't return to the chat or view chat messages. + + Source: https://core.telegram.org/bots/api#chatmemberbanned + """ + + status: Literal[ChatMemberStatus.KICKED] = ChatMemberStatus.KICKED + """The member's status in the chat, always 'kicked'""" + user: User + """Information about the user""" + until_date: DateTime + """Date when restrictions will be lifted for this user; Unix time. If 0, then the user is banned forever""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + status: Literal[ChatMemberStatus.KICKED] = ChatMemberStatus.KICKED, + user: User, + until_date: DateTime, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(status=status, user=user, until_date=until_date, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/chat_member_left.py b/env/Lib/site-packages/aiogram/types/chat_member_left.py new file mode 100644 index 0000000..3870d17 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_member_left.py @@ -0,0 +1,39 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import ChatMemberStatus +from .chat_member import ChatMember + +if TYPE_CHECKING: + from .user import User + + +class ChatMemberLeft(ChatMember): + """ + Represents a `chat member `_ that isn't currently a member of the chat, but may join it themselves. + + Source: https://core.telegram.org/bots/api#chatmemberleft + """ + + status: Literal[ChatMemberStatus.LEFT] = ChatMemberStatus.LEFT + """The member's status in the chat, always 'left'""" + user: User + """Information about the user""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + status: Literal[ChatMemberStatus.LEFT] = ChatMemberStatus.LEFT, + user: User, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(status=status, user=user, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/chat_member_member.py b/env/Lib/site-packages/aiogram/types/chat_member_member.py new file mode 100644 index 0000000..12ef33e --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_member_member.py @@ -0,0 +1,43 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional + +from ..enums import ChatMemberStatus +from .chat_member import ChatMember +from .custom import DateTime + +if TYPE_CHECKING: + from .user import User + + +class ChatMemberMember(ChatMember): + """ + Represents a `chat member `_ that has no additional privileges or restrictions. + + Source: https://core.telegram.org/bots/api#chatmembermember + """ + + status: Literal[ChatMemberStatus.MEMBER] = ChatMemberStatus.MEMBER + """The member's status in the chat, always 'member'""" + user: User + """Information about the user""" + until_date: Optional[DateTime] = None + """*Optional*. Date when the user's subscription will expire; Unix time""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + status: Literal[ChatMemberStatus.MEMBER] = ChatMemberStatus.MEMBER, + user: User, + until_date: Optional[DateTime] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(status=status, user=user, until_date=until_date, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/chat_member_owner.py b/env/Lib/site-packages/aiogram/types/chat_member_owner.py new file mode 100644 index 0000000..1429435 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_member_owner.py @@ -0,0 +1,51 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional + +from ..enums import ChatMemberStatus +from .chat_member import ChatMember + +if TYPE_CHECKING: + from .user import User + + +class ChatMemberOwner(ChatMember): + """ + Represents a `chat member `_ that owns the chat and has all administrator privileges. + + Source: https://core.telegram.org/bots/api#chatmemberowner + """ + + status: Literal[ChatMemberStatus.CREATOR] = ChatMemberStatus.CREATOR + """The member's status in the chat, always 'creator'""" + user: User + """Information about the user""" + is_anonymous: bool + """:code:`True`, if the user's presence in the chat is hidden""" + custom_title: Optional[str] = None + """*Optional*. Custom title for this user""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + status: Literal[ChatMemberStatus.CREATOR] = ChatMemberStatus.CREATOR, + user: User, + is_anonymous: bool, + custom_title: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + status=status, + user=user, + is_anonymous=is_anonymous, + custom_title=custom_title, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/chat_member_restricted.py b/env/Lib/site-packages/aiogram/types/chat_member_restricted.py new file mode 100644 index 0000000..edda75e --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_member_restricted.py @@ -0,0 +1,108 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import ChatMemberStatus +from .chat_member import ChatMember +from .custom import DateTime + +if TYPE_CHECKING: + from .user import User + + +class ChatMemberRestricted(ChatMember): + """ + Represents a `chat member `_ that is under certain restrictions in the chat. Supergroups only. + + Source: https://core.telegram.org/bots/api#chatmemberrestricted + """ + + status: Literal[ChatMemberStatus.RESTRICTED] = ChatMemberStatus.RESTRICTED + """The member's status in the chat, always 'restricted'""" + user: User + """Information about the user""" + is_member: bool + """:code:`True`, if the user is a member of the chat at the moment of the request""" + can_send_messages: bool + """:code:`True`, if the user is allowed to send text messages, contacts, giveaways, giveaway winners, invoices, locations and venues""" + can_send_audios: bool + """:code:`True`, if the user is allowed to send audios""" + can_send_documents: bool + """:code:`True`, if the user is allowed to send documents""" + can_send_photos: bool + """:code:`True`, if the user is allowed to send photos""" + can_send_videos: bool + """:code:`True`, if the user is allowed to send videos""" + can_send_video_notes: bool + """:code:`True`, if the user is allowed to send video notes""" + can_send_voice_notes: bool + """:code:`True`, if the user is allowed to send voice notes""" + can_send_polls: bool + """:code:`True`, if the user is allowed to send polls""" + can_send_other_messages: bool + """:code:`True`, if the user is allowed to send animations, games, stickers and use inline bots""" + can_add_web_page_previews: bool + """:code:`True`, if the user is allowed to add web page previews to their messages""" + can_change_info: bool + """:code:`True`, if the user is allowed to change the chat title, photo and other settings""" + can_invite_users: bool + """:code:`True`, if the user is allowed to invite new users to the chat""" + can_pin_messages: bool + """:code:`True`, if the user is allowed to pin messages""" + can_manage_topics: bool + """:code:`True`, if the user is allowed to create forum topics""" + until_date: DateTime + """Date when restrictions will be lifted for this user; Unix time. If 0, then the user is restricted forever""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + status: Literal[ChatMemberStatus.RESTRICTED] = ChatMemberStatus.RESTRICTED, + user: User, + is_member: bool, + can_send_messages: bool, + can_send_audios: bool, + can_send_documents: bool, + can_send_photos: bool, + can_send_videos: bool, + can_send_video_notes: bool, + can_send_voice_notes: bool, + can_send_polls: bool, + can_send_other_messages: bool, + can_add_web_page_previews: bool, + can_change_info: bool, + can_invite_users: bool, + can_pin_messages: bool, + can_manage_topics: bool, + until_date: DateTime, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + status=status, + user=user, + is_member=is_member, + can_send_messages=can_send_messages, + can_send_audios=can_send_audios, + can_send_documents=can_send_documents, + can_send_photos=can_send_photos, + can_send_videos=can_send_videos, + can_send_video_notes=can_send_video_notes, + can_send_voice_notes=can_send_voice_notes, + can_send_polls=can_send_polls, + can_send_other_messages=can_send_other_messages, + can_add_web_page_previews=can_add_web_page_previews, + can_change_info=can_change_info, + can_invite_users=can_invite_users, + can_pin_messages=can_pin_messages, + can_manage_topics=can_manage_topics, + until_date=until_date, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/chat_member_updated.py b/env/Lib/site-packages/aiogram/types/chat_member_updated.py new file mode 100644 index 0000000..48c3e9d --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_member_updated.py @@ -0,0 +1,1413 @@ +from __future__ import annotations + +import datetime +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from .base import TelegramObject +from .custom import DateTime + +if TYPE_CHECKING: + from ..methods import ( + SendAnimation, + SendAudio, + SendContact, + SendDice, + SendDocument, + SendGame, + SendInvoice, + SendLocation, + SendMediaGroup, + SendMessage, + SendPhoto, + SendPoll, + SendSticker, + SendVenue, + SendVideo, + SendVideoNote, + SendVoice, + ) + from .chat import Chat + from .chat_invite_link import ChatInviteLink + from .chat_member_administrator import ChatMemberAdministrator + from .chat_member_banned import ChatMemberBanned + from .chat_member_left import ChatMemberLeft + from .chat_member_member import ChatMemberMember + from .chat_member_owner import ChatMemberOwner + from .chat_member_restricted import ChatMemberRestricted + from .force_reply import ForceReply + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_file import InputFile + from .input_media_audio import InputMediaAudio + from .input_media_document import InputMediaDocument + from .input_media_photo import InputMediaPhoto + from .input_media_video import InputMediaVideo + from .input_poll_option import InputPollOption + from .labeled_price import LabeledPrice + from .link_preview_options import LinkPreviewOptions + from .message_entity import MessageEntity + from .reply_keyboard_markup import ReplyKeyboardMarkup + from .reply_keyboard_remove import ReplyKeyboardRemove + from .reply_parameters import ReplyParameters + from .user import User + + +class ChatMemberUpdated(TelegramObject): + """ + This object represents changes in the status of a chat member. + + Source: https://core.telegram.org/bots/api#chatmemberupdated + """ + + chat: Chat + """Chat the user belongs to""" + from_user: User = Field(..., alias="from") + """Performer of the action, which resulted in the change""" + date: DateTime + """Date the change was done in Unix time""" + old_chat_member: Union[ + ChatMemberOwner, + ChatMemberAdministrator, + ChatMemberMember, + ChatMemberRestricted, + ChatMemberLeft, + ChatMemberBanned, + ] + """Previous information about the chat member""" + new_chat_member: Union[ + ChatMemberOwner, + ChatMemberAdministrator, + ChatMemberMember, + ChatMemberRestricted, + ChatMemberLeft, + ChatMemberBanned, + ] + """New information about the chat member""" + invite_link: Optional[ChatInviteLink] = None + """*Optional*. Chat invite link, which was used by the user to join the chat; for joining by invite link events only.""" + via_join_request: Optional[bool] = None + """*Optional*. True, if the user joined the chat after sending a direct join request without using an invite link and being approved by an administrator""" + via_chat_folder_invite_link: Optional[bool] = None + """*Optional*. True, if the user joined the chat via a chat folder invite link""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat: Chat, + from_user: User, + date: DateTime, + old_chat_member: Union[ + ChatMemberOwner, + ChatMemberAdministrator, + ChatMemberMember, + ChatMemberRestricted, + ChatMemberLeft, + ChatMemberBanned, + ], + new_chat_member: Union[ + ChatMemberOwner, + ChatMemberAdministrator, + ChatMemberMember, + ChatMemberRestricted, + ChatMemberLeft, + ChatMemberBanned, + ], + invite_link: Optional[ChatInviteLink] = None, + via_join_request: Optional[bool] = None, + via_chat_folder_invite_link: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat=chat, + from_user=from_user, + date=date, + old_chat_member=old_chat_member, + new_chat_member=new_chat_member, + invite_link=invite_link, + via_join_request=via_join_request, + via_chat_folder_invite_link=via_chat_folder_invite_link, + **__pydantic_kwargs, + ) + + def answer( + self, + text: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + entities: Optional[List[MessageEntity]] = None, + link_preview_options: Optional[Union[LinkPreviewOptions, Default]] = Default( + "link_preview" + ), + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + disable_web_page_preview: Optional[Union[bool, Default]] = Default( + "link_preview_is_disabled" + ), + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendMessage: + """ + Shortcut for method :class:`aiogram.methods.send_message.SendMessage` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send text messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendmessage + + :param text: Text of the message to be sent, 1-4096 characters after entities parsing + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param parse_mode: Mode for parsing entities in the message text. See `formatting options `_ for more details. + :param entities: A JSON-serialized list of special entities that appear in message text, which can be specified instead of *parse_mode* + :param link_preview_options: Link preview generation options for the message + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param disable_web_page_preview: Disables link previews for links in this message + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_message.SendMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendMessage + + return SendMessage( + chat_id=self.chat.id, + text=text, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + parse_mode=parse_mode, + entities=entities, + link_preview_options=link_preview_options, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + disable_web_page_preview=disable_web_page_preview, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_animation( + self, + animation: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + duration: Optional[int] = None, + width: Optional[int] = None, + height: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendAnimation: + """ + Shortcut for method :class:`aiogram.methods.send_animation.SendAnimation` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send animation files (GIF or H.264/MPEG-4 AVC video without sound). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send animation files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendanimation + + :param animation: Animation to send. Pass a file_id as String to send an animation that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an animation from the Internet, or upload a new animation using multipart/form-data. :ref:`More information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param duration: Duration of sent animation in seconds + :param width: Animation width + :param height: Animation height + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Animation caption (may also be used when resending animation by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the animation caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the animation needs to be covered with a spoiler animation + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_animation.SendAnimation` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendAnimation + + return SendAnimation( + chat_id=self.chat.id, + animation=animation, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + duration=duration, + width=width, + height=height, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_audio( + self, + audio: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + performer: Optional[str] = None, + title: Optional[str] = None, + thumbnail: Optional[InputFile] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendAudio: + """ + Shortcut for method :class:`aiogram.methods.send_audio.SendAudio` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send audio files, if you want Telegram clients to display them in the music player. Your audio must be in the .MP3 or .M4A format. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future. + For sending voice messages, use the :class:`aiogram.methods.send_voice.SendVoice` method instead. + + Source: https://core.telegram.org/bots/api#sendaudio + + :param audio: Audio file to send. Pass a file_id as String to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param caption: Audio caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the audio caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param duration: Duration of the audio in seconds + :param performer: Performer + :param title: Track name + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_audio.SendAudio` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendAudio + + return SendAudio( + chat_id=self.chat.id, + audio=audio, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + duration=duration, + performer=performer, + title=title, + thumbnail=thumbnail, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_contact( + self, + phone_number: str, + first_name: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + last_name: Optional[str] = None, + vcard: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendContact: + """ + Shortcut for method :class:`aiogram.methods.send_contact.SendContact` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send phone contacts. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendcontact + + :param phone_number: Contact's phone number + :param first_name: Contact's first name + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param last_name: Contact's last name + :param vcard: Additional data about the contact in the form of a `vCard `_, 0-2048 bytes + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_contact.SendContact` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendContact + + return SendContact( + chat_id=self.chat.id, + phone_number=phone_number, + first_name=first_name, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + last_name=last_name, + vcard=vcard, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_document( + self, + document: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + disable_content_type_detection: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendDocument: + """ + Shortcut for method :class:`aiogram.methods.send_document.SendDocument` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send general files. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#senddocument + + :param document: File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), 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 information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Document caption (may also be used when resending documents by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the document caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param disable_content_type_detection: Disables automatic server-side content type detection for files uploaded using multipart/form-data + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_document.SendDocument` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendDocument + + return SendDocument( + chat_id=self.chat.id, + document=document, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + disable_content_type_detection=disable_content_type_detection, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_game( + self, + game_short_name: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendGame: + """ + Shortcut for method :class:`aiogram.methods.send_game.SendGame` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send a game. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendgame + + :param game_short_name: Short name of the game, serves as the unique identifier for the game. Set up your games via `@BotFather `_. + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game. + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_game.SendGame` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendGame + + return SendGame( + chat_id=self.chat.id, + game_short_name=game_short_name, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_invoice( + self, + title: str, + description: str, + payload: str, + currency: str, + prices: List[LabeledPrice], + message_thread_id: Optional[int] = None, + provider_token: Optional[str] = None, + max_tip_amount: Optional[int] = None, + suggested_tip_amounts: Optional[List[int]] = None, + start_parameter: Optional[str] = None, + provider_data: Optional[str] = None, + photo_url: Optional[str] = None, + photo_size: Optional[int] = None, + photo_width: Optional[int] = None, + photo_height: Optional[int] = None, + need_name: Optional[bool] = None, + need_phone_number: Optional[bool] = None, + need_email: Optional[bool] = None, + need_shipping_address: Optional[bool] = None, + send_phone_number_to_provider: Optional[bool] = None, + send_email_to_provider: Optional[bool] = None, + is_flexible: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendInvoice: + """ + Shortcut for method :class:`aiogram.methods.send_invoice.SendInvoice` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send invoices. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendinvoice + + :param title: Product name, 1-32 characters + :param description: Product description, 1-255 characters + :param payload: Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use for your internal processes. + :param currency: Three-letter ISO 4217 currency code, see `more on currencies `_. Pass 'XTR' for payments in `Telegram Stars `_. + :param prices: Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.). Must contain exactly one item for payments in `Telegram Stars `_. + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param provider_token: Payment provider token, obtained via `@BotFather `_. Pass an empty string for payments in `Telegram Stars `_. + :param max_tip_amount: The maximum accepted amount for tips in the *smallest units* of the currency (integer, **not** float/double). For example, for a maximum tip of :code:`US$ 1.45` pass :code:`max_tip_amount = 145`. See the *exp* parameter in `currencies.json `_, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0. Not supported for payments in `Telegram Stars `_. + :param suggested_tip_amounts: A JSON-serialized array of suggested amounts of tips in the *smallest units* of the currency (integer, **not** float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed *max_tip_amount*. + :param start_parameter: Unique deep-linking parameter. If left empty, **forwarded copies** of the sent message will have a *Pay* button, allowing multiple users to pay directly from the forwarded message, using the same invoice. If non-empty, forwarded copies of the sent message will have a *URL* button with a deep link to the bot (instead of a *Pay* button), with the value used as the start parameter + :param provider_data: JSON-serialized data about the invoice, which will be shared with the payment provider. A detailed description of required fields should be provided by the payment provider. + :param photo_url: URL of the product photo for the invoice. Can be a photo of the goods or a marketing image for a service. People like it better when they see what they are paying for. + :param photo_size: Photo size in bytes + :param photo_width: Photo width + :param photo_height: Photo height + :param need_name: Pass :code:`True` if you require the user's full name to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_phone_number: Pass :code:`True` if you require the user's phone number to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_email: Pass :code:`True` if you require the user's email address to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_shipping_address: Pass :code:`True` if you require the user's shipping address to complete the order. Ignored for payments in `Telegram Stars `_. + :param send_phone_number_to_provider: Pass :code:`True` if the user's phone number should be sent to the provider. Ignored for payments in `Telegram Stars `_. + :param send_email_to_provider: Pass :code:`True` if the user's email address should be sent to the provider. Ignored for payments in `Telegram Stars `_. + :param is_flexible: Pass :code:`True` if the final price depends on the shipping method. Ignored for payments in `Telegram Stars `_. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Pay :code:`total price`' button will be shown. If not empty, the first button must be a Pay button. + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_invoice.SendInvoice` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendInvoice + + return SendInvoice( + chat_id=self.chat.id, + title=title, + description=description, + payload=payload, + currency=currency, + prices=prices, + message_thread_id=message_thread_id, + provider_token=provider_token, + max_tip_amount=max_tip_amount, + suggested_tip_amounts=suggested_tip_amounts, + start_parameter=start_parameter, + provider_data=provider_data, + photo_url=photo_url, + photo_size=photo_size, + photo_width=photo_width, + photo_height=photo_height, + need_name=need_name, + need_phone_number=need_phone_number, + need_email=need_email, + need_shipping_address=need_shipping_address, + send_phone_number_to_provider=send_phone_number_to_provider, + send_email_to_provider=send_email_to_provider, + is_flexible=is_flexible, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_location( + self, + latitude: float, + longitude: float, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + horizontal_accuracy: Optional[float] = None, + live_period: Optional[int] = None, + heading: Optional[int] = None, + proximity_alert_radius: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendLocation: + """ + Shortcut for method :class:`aiogram.methods.send_location.SendLocation` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send point on the map. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendlocation + + :param latitude: Latitude of the location + :param longitude: Longitude of the location + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param horizontal_accuracy: The radius of uncertainty for the location, measured in meters; 0-1500 + :param live_period: Period in seconds during which the location will be updated (see `Live Locations `_, should be between 60 and 86400, or 0x7FFFFFFF for live locations that can be edited indefinitely. + :param heading: For live locations, a direction in which the user is moving, in degrees. Must be between 1 and 360 if specified. + :param proximity_alert_radius: For live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_location.SendLocation` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendLocation + + return SendLocation( + chat_id=self.chat.id, + latitude=latitude, + longitude=longitude, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + horizontal_accuracy=horizontal_accuracy, + live_period=live_period, + heading=heading, + proximity_alert_radius=proximity_alert_radius, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_media_group( + self, + media: List[Union[InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo]], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendMediaGroup: + """ + Shortcut for method :class:`aiogram.methods.send_media_group.SendMediaGroup` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send a group of photos, videos, documents or audios as an album. Documents and audio files can be only grouped in an album with messages of the same type. On success, an array of `Messages `_ that were sent is returned. + + Source: https://core.telegram.org/bots/api#sendmediagroup + + :param media: A JSON-serialized array describing messages to be sent, must include 2-10 items + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param disable_notification: Sends messages `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent messages from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the messages are a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_media_group.SendMediaGroup` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendMediaGroup + + return SendMediaGroup( + chat_id=self.chat.id, + media=media, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_photo( + self, + photo: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendPhoto: + """ + Shortcut for method :class:`aiogram.methods.send_photo.SendPhoto` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send photos. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendphoto + + :param photo: Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data. The photo must be at most 10 MB in size. The photo's width and height must not exceed 10000 in total. Width and height ratio must be at most 20. :ref:`More information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param caption: Photo caption (may also be used when resending photos by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the photo caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the photo needs to be covered with a spoiler animation + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_photo.SendPhoto` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendPhoto + + return SendPhoto( + chat_id=self.chat.id, + photo=photo, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_poll( + self, + question: str, + options: List[Union[InputPollOption, str]], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + question_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + question_entities: Optional[List[MessageEntity]] = None, + is_anonymous: Optional[bool] = None, + type: Optional[str] = None, + allows_multiple_answers: Optional[bool] = None, + correct_option_id: Optional[int] = None, + explanation: Optional[str] = None, + explanation_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + explanation_entities: Optional[List[MessageEntity]] = None, + open_period: Optional[int] = None, + close_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + is_closed: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendPoll: + """ + Shortcut for method :class:`aiogram.methods.send_poll.SendPoll` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send a native poll. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendpoll + + :param question: Poll question, 1-300 characters + :param options: A JSON-serialized list of 2-10 answer options + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param question_parse_mode: Mode for parsing entities in the question. See `formatting options `_ for more details. Currently, only custom emoji entities are allowed + :param question_entities: A JSON-serialized list of special entities that appear in the poll question. It can be specified instead of *question_parse_mode* + :param is_anonymous: :code:`True`, if the poll needs to be anonymous, defaults to :code:`True` + :param type: Poll type, 'quiz' or 'regular', defaults to 'regular' + :param allows_multiple_answers: :code:`True`, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to :code:`False` + :param correct_option_id: 0-based identifier of the correct answer option, required for polls in quiz mode + :param explanation: Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing + :param explanation_parse_mode: Mode for parsing entities in the explanation. See `formatting options `_ for more details. + :param explanation_entities: A JSON-serialized list of special entities that appear in the poll explanation. It can be specified instead of *explanation_parse_mode* + :param open_period: Amount of time in seconds the poll will be active after creation, 5-600. Can't be used together with *close_date*. + :param close_date: Point in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future. Can't be used together with *open_period*. + :param is_closed: Pass :code:`True` if the poll needs to be immediately closed. This can be useful for poll preview. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_poll.SendPoll` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendPoll + + return SendPoll( + chat_id=self.chat.id, + question=question, + options=options, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + question_parse_mode=question_parse_mode, + question_entities=question_entities, + is_anonymous=is_anonymous, + type=type, + allows_multiple_answers=allows_multiple_answers, + correct_option_id=correct_option_id, + explanation=explanation, + explanation_parse_mode=explanation_parse_mode, + explanation_entities=explanation_entities, + open_period=open_period, + close_date=close_date, + is_closed=is_closed, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_dice( + self, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + emoji: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendDice: + """ + Shortcut for method :class:`aiogram.methods.send_dice.SendDice` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send an animated emoji that will display a random value. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#senddice + + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param emoji: Emoji on which the dice throw animation is based. Currently, must be one of '🎲', '🎯', '🏀', '⚽', '🎳', or '🎰'. Dice can have values 1-6 for '🎲', '🎯' and '🎳', values 1-5 for '🏀' and '⚽', and values 1-64 for '🎰'. Defaults to '🎲' + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_dice.SendDice` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendDice + + return SendDice( + chat_id=self.chat.id, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + emoji=emoji, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_sticker( + self, + sticker: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + emoji: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendSticker: + """ + Shortcut for method :class:`aiogram.methods.send_sticker.SendSticker` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send static .WEBP, `animated `_ .TGS, or `video `_ .WEBM stickers. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendsticker + + :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP, .TGS, or .WEBM sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video and animated stickers can't be sent via an HTTP URL. + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param emoji: Emoji associated with the sticker; only for just uploaded stickers + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_sticker.SendSticker` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendSticker + + return SendSticker( + chat_id=self.chat.id, + sticker=sticker, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + emoji=emoji, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_venue( + self, + latitude: float, + longitude: float, + title: str, + address: str, + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + foursquare_id: Optional[str] = None, + foursquare_type: Optional[str] = None, + google_place_id: Optional[str] = None, + google_place_type: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendVenue: + """ + Shortcut for method :class:`aiogram.methods.send_venue.SendVenue` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send information about a venue. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvenue + + :param latitude: Latitude of the venue + :param longitude: Longitude of the venue + :param title: Name of the venue + :param address: Address of the venue + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param foursquare_id: Foursquare identifier of the venue + :param foursquare_type: Foursquare type of the venue, if known. (For example, 'arts_entertainment/default', 'arts_entertainment/aquarium' or 'food/icecream'.) + :param google_place_id: Google Places identifier of the venue + :param google_place_type: Google Places type of the venue. (See `supported types `_.) + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_venue.SendVenue` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVenue + + return SendVenue( + chat_id=self.chat.id, + latitude=latitude, + longitude=longitude, + title=title, + address=address, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + foursquare_id=foursquare_id, + foursquare_type=foursquare_type, + google_place_id=google_place_id, + google_place_type=google_place_type, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_video( + self, + video: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + duration: Optional[int] = None, + width: Optional[int] = None, + height: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + supports_streaming: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendVideo: + """ + Shortcut for method :class:`aiogram.methods.send_video.SendVideo` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send video files, Telegram clients support MPEG4 videos (other formats may be sent as :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvideo + + :param video: Video to send. Pass a file_id as String to send a video that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a video from the Internet, or upload a new video using multipart/form-data. :ref:`More information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param duration: Duration of sent video in seconds + :param width: Video width + :param height: Video height + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Video caption (may also be used when resending videos by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the video caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the video needs to be covered with a spoiler animation + :param supports_streaming: Pass :code:`True` if the uploaded video is suitable for streaming + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_video.SendVideo` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVideo + + return SendVideo( + chat_id=self.chat.id, + video=video, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + duration=duration, + width=width, + height=height, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + supports_streaming=supports_streaming, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_video_note( + self, + video_note: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + duration: Optional[int] = None, + length: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendVideoNote: + """ + Shortcut for method :class:`aiogram.methods.send_video_note.SendVideoNote` + will automatically fill method attributes: + + - :code:`chat_id` + + As of `v.4.0 `_, Telegram clients support rounded square MPEG4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvideonote + + :param video_note: Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data. :ref:`More information on Sending Files » `. Sending video notes by a URL is currently unsupported + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param duration: Duration of sent video in seconds + :param length: Video width and height, i.e. diameter of the video message + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_video_note.SendVideoNote` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVideoNote + + return SendVideoNote( + chat_id=self.chat.id, + video_note=video_note, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + duration=duration, + length=length, + thumbnail=thumbnail, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def answer_voice( + self, + voice: Union[InputFile, str], + business_connection_id: Optional[str] = None, + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendVoice: + """ + Shortcut for method :class:`aiogram.methods.send_voice.SendVoice` + will automatically fill method attributes: + + - :code:`chat_id` + + Use this method to send audio files, if you want Telegram clients to display the file as a playable voice message. For this to work, your audio must be in an .OGG file encoded with OPUS, or in .MP3 format, or in .M4A format (other formats may be sent as :class:`aiogram.types.audio.Audio` or :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send voice messages of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvoice + + :param voice: Audio file to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), 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 information on Sending Files » ` + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be sent + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param caption: Voice message caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the voice message caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param duration: Duration of the voice message in seconds + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_voice.SendVoice` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVoice + + return SendVoice( + chat_id=self.chat.id, + voice=voice, + business_connection_id=business_connection_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + duration=duration, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) diff --git a/env/Lib/site-packages/aiogram/types/chat_permissions.py b/env/Lib/site-packages/aiogram/types/chat_permissions.py new file mode 100644 index 0000000..6270cc3 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_permissions.py @@ -0,0 +1,87 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import MutableTelegramObject + + +class ChatPermissions(MutableTelegramObject): + """ + Describes actions that a non-administrator user is allowed to take in a chat. + + Source: https://core.telegram.org/bots/api#chatpermissions + """ + + can_send_messages: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to send text messages, contacts, giveaways, giveaway winners, invoices, locations and venues""" + can_send_audios: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to send audios""" + can_send_documents: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to send documents""" + can_send_photos: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to send photos""" + can_send_videos: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to send videos""" + can_send_video_notes: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to send video notes""" + can_send_voice_notes: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to send voice notes""" + can_send_polls: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to send polls""" + can_send_other_messages: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to send animations, games, stickers and use inline bots""" + can_add_web_page_previews: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to add web page previews to their messages""" + can_change_info: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups""" + can_invite_users: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to invite new users to the chat""" + can_pin_messages: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to pin messages. Ignored in public supergroups""" + can_manage_topics: Optional[bool] = None + """*Optional*. :code:`True`, if the user is allowed to create forum topics. If omitted defaults to the value of can_pin_messages""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + can_send_messages: Optional[bool] = None, + can_send_audios: Optional[bool] = None, + can_send_documents: Optional[bool] = None, + can_send_photos: Optional[bool] = None, + can_send_videos: Optional[bool] = None, + can_send_video_notes: Optional[bool] = None, + can_send_voice_notes: Optional[bool] = None, + can_send_polls: Optional[bool] = None, + can_send_other_messages: Optional[bool] = None, + can_add_web_page_previews: Optional[bool] = None, + can_change_info: Optional[bool] = None, + can_invite_users: Optional[bool] = None, + can_pin_messages: Optional[bool] = None, + can_manage_topics: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + can_send_messages=can_send_messages, + can_send_audios=can_send_audios, + can_send_documents=can_send_documents, + can_send_photos=can_send_photos, + can_send_videos=can_send_videos, + can_send_video_notes=can_send_video_notes, + can_send_voice_notes=can_send_voice_notes, + can_send_polls=can_send_polls, + can_send_other_messages=can_send_other_messages, + can_add_web_page_previews=can_add_web_page_previews, + can_change_info=can_change_info, + can_invite_users=can_invite_users, + can_pin_messages=can_pin_messages, + can_manage_topics=can_manage_topics, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/chat_photo.py b/env/Lib/site-packages/aiogram/types/chat_photo.py new file mode 100644 index 0000000..1a64aeb --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_photo.py @@ -0,0 +1,47 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + + +class ChatPhoto(TelegramObject): + """ + This object represents a chat photo. + + Source: https://core.telegram.org/bots/api#chatphoto + """ + + small_file_id: str + """File identifier of small (160x160) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed.""" + small_file_unique_id: str + """Unique file identifier of small (160x160) chat photo, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.""" + big_file_id: str + """File identifier of big (640x640) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed.""" + big_file_unique_id: str + """Unique file identifier of big (640x640) chat photo, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + small_file_id: str, + small_file_unique_id: str, + big_file_id: str, + big_file_unique_id: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + small_file_id=small_file_id, + small_file_unique_id=small_file_unique_id, + big_file_id=big_file_id, + big_file_unique_id=big_file_unique_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/chat_shared.py b/env/Lib/site-packages/aiogram/types/chat_shared.py new file mode 100644 index 0000000..92d6231 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chat_shared.py @@ -0,0 +1,54 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from aiogram.types import TelegramObject + +if TYPE_CHECKING: + from .photo_size import PhotoSize + + +class ChatShared(TelegramObject): + """ + This object contains information about a chat that was shared with the bot using a :class:`aiogram.types.keyboard_button_request_chat.KeyboardButtonRequestChat` button. + + Source: https://core.telegram.org/bots/api#chatshared + """ + + request_id: int + """Identifier of the request""" + chat_id: int + """Identifier of the shared chat. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a 64-bit integer or double-precision float type are safe for storing this identifier. The bot may not have access to the chat and could be unable to use this identifier, unless the chat is already known to the bot by some other means.""" + title: Optional[str] = None + """*Optional*. Title of the chat, if the title was requested by the bot.""" + username: Optional[str] = None + """*Optional*. Username of the chat, if the username was requested by the bot and available.""" + photo: Optional[List[PhotoSize]] = None + """*Optional*. Available sizes of the chat photo, if the photo was requested by the bot""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + request_id: int, + chat_id: int, + title: Optional[str] = None, + username: Optional[str] = None, + photo: Optional[List[PhotoSize]] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + request_id=request_id, + chat_id=chat_id, + title=title, + username=username, + photo=photo, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/chosen_inline_result.py b/env/Lib/site-packages/aiogram/types/chosen_inline_result.py new file mode 100644 index 0000000..510a0e1 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/chosen_inline_result.py @@ -0,0 +1,58 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from pydantic import Field + +from .base import TelegramObject + +if TYPE_CHECKING: + from .location import Location + from .user import User + + +class ChosenInlineResult(TelegramObject): + """ + Represents a `result `_ of an inline query that was chosen by the user and sent to their chat partner. + **Note:** It is necessary to enable `inline feedback `_ via `@BotFather `_ in order to receive these objects in updates. + + Source: https://core.telegram.org/bots/api#choseninlineresult + """ + + result_id: str + """The unique identifier for the result that was chosen""" + from_user: User = Field(..., alias="from") + """The user that chose the result""" + query: str + """The query that was used to obtain the result""" + location: Optional[Location] = None + """*Optional*. Sender location, only for bots that require user location""" + inline_message_id: Optional[str] = None + """*Optional*. Identifier of the sent inline message. Available only if there is an `inline keyboard `_ attached to the message. Will be also received in `callback queries `_ and can be used to `edit `_ the message.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + result_id: str, + from_user: User, + query: str, + location: Optional[Location] = None, + inline_message_id: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + result_id=result_id, + from_user=from_user, + query=query, + location=location, + inline_message_id=inline_message_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/contact.py b/env/Lib/site-packages/aiogram/types/contact.py new file mode 100644 index 0000000..1fb7f83 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/contact.py @@ -0,0 +1,51 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + + +class Contact(TelegramObject): + """ + This object represents a phone contact. + + Source: https://core.telegram.org/bots/api#contact + """ + + phone_number: str + """Contact's phone number""" + first_name: str + """Contact's first name""" + last_name: Optional[str] = None + """*Optional*. Contact's last name""" + user_id: Optional[int] = None + """*Optional*. Contact's user identifier in Telegram. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a 64-bit integer or double-precision float type are safe for storing this identifier.""" + vcard: Optional[str] = None + """*Optional*. Additional data about the contact in the form of a `vCard `_""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + phone_number: str, + first_name: str, + last_name: Optional[str] = None, + user_id: Optional[int] = None, + vcard: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + phone_number=phone_number, + first_name=first_name, + last_name=last_name, + user_id=user_id, + vcard=vcard, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/custom.py b/env/Lib/site-packages/aiogram/types/custom.py new file mode 100644 index 0000000..8617fa6 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/custom.py @@ -0,0 +1,30 @@ +import sys +from datetime import datetime, timezone + +from pydantic import PlainSerializer +from typing_extensions import Annotated + +if sys.platform == "win32": # pragma: no cover + + def _datetime_serializer(value: datetime) -> int: + tz = timezone.utc if value.tzinfo else None + + # https://github.com/aiogram/aiogram/issues/349 + # https://github.com/aiogram/aiogram/pull/880 + return round((value - datetime(1970, 1, 1, tzinfo=tz)).total_seconds()) + +else: # pragma: no cover + + def _datetime_serializer(value: datetime) -> int: + return round(value.timestamp()) + + +# Make datetime compatible with Telegram Bot API (unixtime) +DateTime = Annotated[ + datetime, + PlainSerializer( + func=_datetime_serializer, + return_type=int, + when_used="unless-none", + ), +] diff --git a/env/Lib/site-packages/aiogram/types/dice.py b/env/Lib/site-packages/aiogram/types/dice.py new file mode 100644 index 0000000..56b84f4 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/dice.py @@ -0,0 +1,40 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + + +class Dice(TelegramObject): + """ + This object represents an animated emoji that displays a random value. + + Source: https://core.telegram.org/bots/api#dice + """ + + emoji: str + """Emoji on which the dice throw animation is based""" + value: int + """Value of the dice, 1-6 for '🎲', '🎯' and '🎳' base emoji, 1-5 for '🏀' and '⚽' base emoji, 1-64 for '🎰' base emoji""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, emoji: str, value: int, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(emoji=emoji, value=value, **__pydantic_kwargs) + + +class DiceEmoji: + DICE = "🎲" + DART = "🎯" + BASKETBALL = "🏀" + FOOTBALL = "⚽" + SLOT_MACHINE = "🎰" + BOWLING = "🎳" diff --git a/env/Lib/site-packages/aiogram/types/document.py b/env/Lib/site-packages/aiogram/types/document.py new file mode 100644 index 0000000..18acff7 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/document.py @@ -0,0 +1,58 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .photo_size import PhotoSize + + +class Document(TelegramObject): + """ + This object represents a general file (as opposed to `photos `_, `voice messages `_ and `audio files `_). + + Source: https://core.telegram.org/bots/api#document + """ + + file_id: str + """Identifier for this file, which can be used to download or reuse the file""" + file_unique_id: str + """Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.""" + thumbnail: Optional[PhotoSize] = None + """*Optional*. Document thumbnail as defined by the sender""" + file_name: Optional[str] = None + """*Optional*. Original filename as defined by the sender""" + mime_type: Optional[str] = None + """*Optional*. MIME type of the file as defined by the sender""" + file_size: Optional[int] = None + """*Optional*. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + file_id: str, + file_unique_id: str, + thumbnail: Optional[PhotoSize] = None, + file_name: Optional[str] = None, + mime_type: Optional[str] = None, + file_size: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + file_id=file_id, + file_unique_id=file_unique_id, + thumbnail=thumbnail, + file_name=file_name, + mime_type=mime_type, + file_size=file_size, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/downloadable.py b/env/Lib/site-packages/aiogram/types/downloadable.py new file mode 100644 index 0000000..be80829 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/downloadable.py @@ -0,0 +1,5 @@ +from typing import Protocol + + +class Downloadable(Protocol): + file_id: str diff --git a/env/Lib/site-packages/aiogram/types/encrypted_credentials.py b/env/Lib/site-packages/aiogram/types/encrypted_credentials.py new file mode 100644 index 0000000..ca03e2a --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/encrypted_credentials.py @@ -0,0 +1,33 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + + +class EncryptedCredentials(TelegramObject): + """ + Describes data required for decrypting and authenticating :class:`aiogram.types.encrypted_passport_element.EncryptedPassportElement`. See the `Telegram Passport Documentation `_ for a complete description of the data decryption and authentication processes. + + Source: https://core.telegram.org/bots/api#encryptedcredentials + """ + + data: str + """Base64-encoded encrypted JSON-serialized data with unique user's payload, data hashes and secrets required for :class:`aiogram.types.encrypted_passport_element.EncryptedPassportElement` decryption and authentication""" + hash: str + """Base64-encoded data hash for data authentication""" + secret: str + """Base64-encoded secret, encrypted with the bot's public RSA key, required for data decryption""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, data: str, hash: str, secret: str, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(data=data, hash=hash, secret=secret, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/encrypted_passport_element.py b/env/Lib/site-packages/aiogram/types/encrypted_passport_element.py new file mode 100644 index 0000000..c1e8be1 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/encrypted_passport_element.py @@ -0,0 +1,74 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .passport_file import PassportFile + + +class EncryptedPassportElement(TelegramObject): + """ + Describes documents or other Telegram Passport elements shared with the bot by the user. + + Source: https://core.telegram.org/bots/api#encryptedpassportelement + """ + + type: str + """Element type. One of 'personal_details', 'passport', 'driver_license', 'identity_card', 'internal_passport', 'address', 'utility_bill', 'bank_statement', 'rental_agreement', 'passport_registration', 'temporary_registration', 'phone_number', 'email'.""" + hash: str + """Base64-encoded element hash for using in :class:`aiogram.types.passport_element_error_unspecified.PassportElementErrorUnspecified`""" + data: Optional[str] = None + """*Optional*. Base64-encoded encrypted Telegram Passport element data provided by the user; available only for 'personal_details', 'passport', 'driver_license', 'identity_card', 'internal_passport' and 'address' types. Can be decrypted and verified using the accompanying :class:`aiogram.types.encrypted_credentials.EncryptedCredentials`.""" + phone_number: Optional[str] = None + """*Optional*. User's verified phone number; available only for 'phone_number' type""" + email: Optional[str] = None + """*Optional*. User's verified email address; available only for 'email' type""" + files: Optional[List[PassportFile]] = None + """*Optional*. Array of encrypted files with documents provided by the user; available only for 'utility_bill', 'bank_statement', 'rental_agreement', 'passport_registration' and 'temporary_registration' types. Files can be decrypted and verified using the accompanying :class:`aiogram.types.encrypted_credentials.EncryptedCredentials`.""" + front_side: Optional[PassportFile] = None + """*Optional*. Encrypted file with the front side of the document, provided by the user; available only for 'passport', 'driver_license', 'identity_card' and 'internal_passport'. The file can be decrypted and verified using the accompanying :class:`aiogram.types.encrypted_credentials.EncryptedCredentials`.""" + reverse_side: Optional[PassportFile] = None + """*Optional*. Encrypted file with the reverse side of the document, provided by the user; available only for 'driver_license' and 'identity_card'. The file can be decrypted and verified using the accompanying :class:`aiogram.types.encrypted_credentials.EncryptedCredentials`.""" + selfie: Optional[PassportFile] = None + """*Optional*. Encrypted file with the selfie of the user holding a document, provided by the user; available if requested for 'passport', 'driver_license', 'identity_card' and 'internal_passport'. The file can be decrypted and verified using the accompanying :class:`aiogram.types.encrypted_credentials.EncryptedCredentials`.""" + translation: Optional[List[PassportFile]] = None + """*Optional*. Array of encrypted files with translated versions of documents provided by the user; available if requested for 'passport', 'driver_license', 'identity_card', 'internal_passport', 'utility_bill', 'bank_statement', 'rental_agreement', 'passport_registration' and 'temporary_registration' types. Files can be decrypted and verified using the accompanying :class:`aiogram.types.encrypted_credentials.EncryptedCredentials`.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: str, + hash: str, + data: Optional[str] = None, + phone_number: Optional[str] = None, + email: Optional[str] = None, + files: Optional[List[PassportFile]] = None, + front_side: Optional[PassportFile] = None, + reverse_side: Optional[PassportFile] = None, + selfie: Optional[PassportFile] = None, + translation: Optional[List[PassportFile]] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + hash=hash, + data=data, + phone_number=phone_number, + email=email, + files=files, + front_side=front_side, + reverse_side=reverse_side, + selfie=selfie, + translation=translation, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/error_event.py b/env/Lib/site-packages/aiogram/types/error_event.py new file mode 100644 index 0000000..e5eafc9 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/error_event.py @@ -0,0 +1,28 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from aiogram.types.base import TelegramObject + +if TYPE_CHECKING: + from .update import Update + + +class ErrorEvent(TelegramObject): + """ + Internal event, should be used to receive errors while processing Updates from Telegram + + Source: https://core.telegram.org/bots/api#error-event + """ + + update: Update + """Received update""" + exception: Exception + """Exception""" + + if TYPE_CHECKING: + + def __init__( + __pydantic_self__, *, update: Update, exception: Exception, **__pydantic_kwargs: Any + ) -> None: + super().__init__(update=update, exception=exception, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/external_reply_info.py b/env/Lib/site-packages/aiogram/types/external_reply_info.py new file mode 100644 index 0000000..0f13a85 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/external_reply_info.py @@ -0,0 +1,158 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from .base import TelegramObject + +if TYPE_CHECKING: + from .animation import Animation + from .audio import Audio + from .chat import Chat + from .contact import Contact + from .dice import Dice + from .document import Document + from .game import Game + from .giveaway import Giveaway + from .giveaway_winners import GiveawayWinners + from .invoice import Invoice + from .link_preview_options import LinkPreviewOptions + from .location import Location + from .message_origin_channel import MessageOriginChannel + from .message_origin_chat import MessageOriginChat + from .message_origin_hidden_user import MessageOriginHiddenUser + from .message_origin_user import MessageOriginUser + from .paid_media_info import PaidMediaInfo + from .photo_size import PhotoSize + from .poll import Poll + from .sticker import Sticker + from .story import Story + from .venue import Venue + from .video import Video + from .video_note import VideoNote + from .voice import Voice + + +class ExternalReplyInfo(TelegramObject): + """ + This object contains information about a message that is being replied to, which may come from another chat or forum topic. + + Source: https://core.telegram.org/bots/api#externalreplyinfo + """ + + origin: Union[ + MessageOriginUser, MessageOriginHiddenUser, MessageOriginChat, MessageOriginChannel + ] + """Origin of the message replied to by the given message""" + chat: Optional[Chat] = None + """*Optional*. Chat the original message belongs to. Available only if the chat is a supergroup or a channel.""" + message_id: Optional[int] = None + """*Optional*. Unique message identifier inside the original chat. Available only if the original chat is a supergroup or a channel.""" + link_preview_options: Optional[LinkPreviewOptions] = None + """*Optional*. Options used for link preview generation for the original message, if it is a text message""" + animation: Optional[Animation] = None + """*Optional*. Message is an animation, information about the animation""" + audio: Optional[Audio] = None + """*Optional*. Message is an audio file, information about the file""" + document: Optional[Document] = None + """*Optional*. Message is a general file, information about the file""" + paid_media: Optional[PaidMediaInfo] = None + """*Optional*. Message contains paid media; information about the paid media""" + photo: Optional[List[PhotoSize]] = None + """*Optional*. Message is a photo, available sizes of the photo""" + sticker: Optional[Sticker] = None + """*Optional*. Message is a sticker, information about the sticker""" + story: Optional[Story] = None + """*Optional*. Message is a forwarded story""" + video: Optional[Video] = None + """*Optional*. Message is a video, information about the video""" + video_note: Optional[VideoNote] = None + """*Optional*. Message is a `video note `_, information about the video message""" + voice: Optional[Voice] = None + """*Optional*. Message is a voice message, information about the file""" + has_media_spoiler: Optional[bool] = None + """*Optional*. :code:`True`, if the message media is covered by a spoiler animation""" + contact: Optional[Contact] = None + """*Optional*. Message is a shared contact, information about the contact""" + dice: Optional[Dice] = None + """*Optional*. Message is a dice with random value""" + game: Optional[Game] = None + """*Optional*. Message is a game, information about the game. `More about games » `_""" + giveaway: Optional[Giveaway] = None + """*Optional*. Message is a scheduled giveaway, information about the giveaway""" + giveaway_winners: Optional[GiveawayWinners] = None + """*Optional*. A giveaway with public winners was completed""" + invoice: Optional[Invoice] = None + """*Optional*. Message is an invoice for a `payment `_, information about the invoice. `More about payments » `_""" + location: Optional[Location] = None + """*Optional*. Message is a shared location, information about the location""" + poll: Optional[Poll] = None + """*Optional*. Message is a native poll, information about the poll""" + venue: Optional[Venue] = None + """*Optional*. Message is a venue, information about the venue""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + origin: Union[ + MessageOriginUser, MessageOriginHiddenUser, MessageOriginChat, MessageOriginChannel + ], + chat: Optional[Chat] = None, + message_id: Optional[int] = None, + link_preview_options: Optional[LinkPreviewOptions] = None, + animation: Optional[Animation] = None, + audio: Optional[Audio] = None, + document: Optional[Document] = None, + paid_media: Optional[PaidMediaInfo] = None, + photo: Optional[List[PhotoSize]] = None, + sticker: Optional[Sticker] = None, + story: Optional[Story] = None, + video: Optional[Video] = None, + video_note: Optional[VideoNote] = None, + voice: Optional[Voice] = None, + has_media_spoiler: Optional[bool] = None, + contact: Optional[Contact] = None, + dice: Optional[Dice] = None, + game: Optional[Game] = None, + giveaway: Optional[Giveaway] = None, + giveaway_winners: Optional[GiveawayWinners] = None, + invoice: Optional[Invoice] = None, + location: Optional[Location] = None, + poll: Optional[Poll] = None, + venue: Optional[Venue] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + origin=origin, + chat=chat, + message_id=message_id, + link_preview_options=link_preview_options, + animation=animation, + audio=audio, + document=document, + paid_media=paid_media, + photo=photo, + sticker=sticker, + story=story, + video=video, + video_note=video_note, + voice=voice, + has_media_spoiler=has_media_spoiler, + contact=contact, + dice=dice, + game=game, + giveaway=giveaway, + giveaway_winners=giveaway_winners, + invoice=invoice, + location=location, + poll=poll, + venue=venue, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/file.py b/env/Lib/site-packages/aiogram/types/file.py new file mode 100644 index 0000000..252c230 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/file.py @@ -0,0 +1,49 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + + +class File(TelegramObject): + """ + This object represents a file ready to be downloaded. The file can be downloaded via the link :code:`https://api.telegram.org/file/bot/`. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling :class:`aiogram.methods.get_file.GetFile`. + + The maximum file size to download is 20 MB + + Source: https://core.telegram.org/bots/api#file + """ + + file_id: str + """Identifier for this file, which can be used to download or reuse the file""" + file_unique_id: str + """Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.""" + file_size: Optional[int] = None + """*Optional*. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.""" + file_path: Optional[str] = None + """*Optional*. File path. Use :code:`https://api.telegram.org/file/bot/` to get the file.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + file_id: str, + file_unique_id: str, + file_size: Optional[int] = None, + file_path: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + file_id=file_id, + file_unique_id=file_unique_id, + file_size=file_size, + file_path=file_path, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/force_reply.py b/env/Lib/site-packages/aiogram/types/force_reply.py new file mode 100644 index 0000000..14b9c1c --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/force_reply.py @@ -0,0 +1,50 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional + +from .base import MutableTelegramObject + + +class ForceReply(MutableTelegramObject): + """ + Upon receiving a message with this object, Telegram clients will display a reply interface to the user (act as if the user has selected the bot's message and tapped 'Reply'). This can be extremely useful if you want to create user-friendly step-by-step interfaces without having to sacrifice `privacy mode `_. Not supported in channels and for messages sent on behalf of a Telegram Business account. + + **Example:** A `poll bot `_ for groups runs in privacy mode (only receives commands, replies to its messages and mentions). There could be two ways to create a new poll: + + - Explain the user how to send a command with parameters (e.g. /newpoll question answer1 answer2). May be appealing for hardcore users but lacks modern day polish. + - Guide the user through a step-by-step process. 'Please send me your question', 'Cool, now let's add the first answer option', 'Great. Keep adding answer options, then send /done when you're ready'. + + The last option is definitely more attractive. And if you use :class:`aiogram.types.force_reply.ForceReply` in your bot's questions, it will receive the user's answers even if it only receives replies, commands and mentions - without any extra work for the user. + + Source: https://core.telegram.org/bots/api#forcereply + """ + + force_reply: Literal[True] = True + """Shows reply interface to the user, as if they manually selected the bot's message and tapped 'Reply'""" + input_field_placeholder: Optional[str] = None + """*Optional*. The placeholder to be shown in the input field when the reply is active; 1-64 characters""" + selective: Optional[bool] = None + """*Optional*. Use this parameter if you want to force reply from specific users only. Targets: 1) users that are @mentioned in the *text* of the :class:`aiogram.types.message.Message` object; 2) if the bot's message is a reply to a message in the same chat and forum topic, sender of the original message.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + force_reply: Literal[True] = True, + input_field_placeholder: Optional[str] = None, + selective: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + force_reply=force_reply, + input_field_placeholder=input_field_placeholder, + selective=selective, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/forum_topic.py b/env/Lib/site-packages/aiogram/types/forum_topic.py new file mode 100644 index 0000000..a6464bc --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/forum_topic.py @@ -0,0 +1,47 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + + +class ForumTopic(TelegramObject): + """ + This object represents a forum topic. + + Source: https://core.telegram.org/bots/api#forumtopic + """ + + message_thread_id: int + """Unique identifier of the forum topic""" + name: str + """Name of the topic""" + icon_color: int + """Color of the topic icon in RGB format""" + icon_custom_emoji_id: Optional[str] = None + """*Optional*. Unique identifier of the custom emoji shown as the topic icon""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + message_thread_id: int, + name: str, + icon_color: int, + icon_custom_emoji_id: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + message_thread_id=message_thread_id, + name=name, + icon_color=icon_color, + icon_custom_emoji_id=icon_custom_emoji_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/forum_topic_closed.py b/env/Lib/site-packages/aiogram/types/forum_topic_closed.py new file mode 100644 index 0000000..390b331 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/forum_topic_closed.py @@ -0,0 +1,11 @@ +from __future__ import annotations + +from .base import TelegramObject + + +class ForumTopicClosed(TelegramObject): + """ + This object represents a service message about a forum topic closed in the chat. Currently holds no information. + + Source: https://core.telegram.org/bots/api#forumtopicclosed + """ diff --git a/env/Lib/site-packages/aiogram/types/forum_topic_created.py b/env/Lib/site-packages/aiogram/types/forum_topic_created.py new file mode 100644 index 0000000..513df95 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/forum_topic_created.py @@ -0,0 +1,43 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + + +class ForumTopicCreated(TelegramObject): + """ + This object represents a service message about a new forum topic created in the chat. + + Source: https://core.telegram.org/bots/api#forumtopiccreated + """ + + name: str + """Name of the topic""" + icon_color: int + """Color of the topic icon in RGB format""" + icon_custom_emoji_id: Optional[str] = None + """*Optional*. Unique identifier of the custom emoji shown as the topic icon""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + name: str, + icon_color: int, + icon_custom_emoji_id: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + name=name, + icon_color=icon_color, + icon_custom_emoji_id=icon_custom_emoji_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/forum_topic_edited.py b/env/Lib/site-packages/aiogram/types/forum_topic_edited.py new file mode 100644 index 0000000..b7b6196 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/forum_topic_edited.py @@ -0,0 +1,35 @@ +from typing import TYPE_CHECKING, Any, Optional + +from aiogram.types import TelegramObject + + +class ForumTopicEdited(TelegramObject): + """ + This object represents a service message about an edited forum topic. + + Source: https://core.telegram.org/bots/api#forumtopicedited + """ + + name: Optional[str] = None + """*Optional*. New name of the topic, if it was edited""" + icon_custom_emoji_id: Optional[str] = None + """*Optional*. New identifier of the custom emoji shown as the topic icon, if it was edited; an empty string if the icon was removed""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + name: Optional[str] = None, + icon_custom_emoji_id: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + name=name, icon_custom_emoji_id=icon_custom_emoji_id, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/forum_topic_reopened.py b/env/Lib/site-packages/aiogram/types/forum_topic_reopened.py new file mode 100644 index 0000000..e02fbaf --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/forum_topic_reopened.py @@ -0,0 +1,11 @@ +from __future__ import annotations + +from .base import TelegramObject + + +class ForumTopicReopened(TelegramObject): + """ + This object represents a service message about a forum topic reopened in the chat. Currently holds no information. + + Source: https://core.telegram.org/bots/api#forumtopicreopened + """ diff --git a/env/Lib/site-packages/aiogram/types/game.py b/env/Lib/site-packages/aiogram/types/game.py new file mode 100644 index 0000000..294f26b --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/game.py @@ -0,0 +1,60 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .animation import Animation + from .message_entity import MessageEntity + from .photo_size import PhotoSize + + +class Game(TelegramObject): + """ + This object represents a game. Use BotFather to create and edit games, their short names will act as unique identifiers. + + Source: https://core.telegram.org/bots/api#game + """ + + title: str + """Title of the game""" + description: str + """Description of the game""" + photo: List[PhotoSize] + """Photo that will be displayed in the game message in chats.""" + text: Optional[str] = None + """*Optional*. Brief description of the game or high scores included in the game message. Can be automatically edited to include current high scores for the game when the bot calls :class:`aiogram.methods.set_game_score.SetGameScore`, or manually edited using :class:`aiogram.methods.edit_message_text.EditMessageText`. 0-4096 characters.""" + text_entities: Optional[List[MessageEntity]] = None + """*Optional*. Special entities that appear in *text*, such as usernames, URLs, bot commands, etc.""" + animation: Optional[Animation] = None + """*Optional*. Animation that will be displayed in the game message in chats. Upload via `BotFather `_""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + title: str, + description: str, + photo: List[PhotoSize], + text: Optional[str] = None, + text_entities: Optional[List[MessageEntity]] = None, + animation: Optional[Animation] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + title=title, + description=description, + photo=photo, + text=text, + text_entities=text_entities, + animation=animation, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/game_high_score.py b/env/Lib/site-packages/aiogram/types/game_high_score.py new file mode 100644 index 0000000..5364be6 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/game_high_score.py @@ -0,0 +1,39 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + +if TYPE_CHECKING: + from .user import User + + +class GameHighScore(TelegramObject): + """ + This object represents one row of the high scores table for a game. + And that's about all we've got for now. + + If you've got any questions, please check out our `https://core.telegram.org/bots/faq `_ **Bot FAQ »** + + Source: https://core.telegram.org/bots/api#gamehighscore + """ + + position: int + """Position in high score table for the game""" + user: User + """User""" + score: int + """Score""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, position: int, user: User, score: int, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(position=position, user=user, score=score, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/general_forum_topic_hidden.py b/env/Lib/site-packages/aiogram/types/general_forum_topic_hidden.py new file mode 100644 index 0000000..136a275 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/general_forum_topic_hidden.py @@ -0,0 +1,9 @@ +from aiogram.types import TelegramObject + + +class GeneralForumTopicHidden(TelegramObject): + """ + This object represents a service message about General forum topic hidden in the chat. Currently holds no information. + + Source: https://core.telegram.org/bots/api#generalforumtopichidden + """ diff --git a/env/Lib/site-packages/aiogram/types/general_forum_topic_unhidden.py b/env/Lib/site-packages/aiogram/types/general_forum_topic_unhidden.py new file mode 100644 index 0000000..9637a02 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/general_forum_topic_unhidden.py @@ -0,0 +1,9 @@ +from aiogram.types import TelegramObject + + +class GeneralForumTopicUnhidden(TelegramObject): + """ + This object represents a service message about General forum topic unhidden in the chat. Currently holds no information. + + Source: https://core.telegram.org/bots/api#generalforumtopicunhidden + """ diff --git a/env/Lib/site-packages/aiogram/types/giveaway.py b/env/Lib/site-packages/aiogram/types/giveaway.py new file mode 100644 index 0000000..1fa4f50 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/giveaway.py @@ -0,0 +1,67 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .chat import Chat + from .custom import DateTime + + +class Giveaway(TelegramObject): + """ + This object represents a message about a scheduled giveaway. + + Source: https://core.telegram.org/bots/api#giveaway + """ + + chats: List[Chat] + """The list of chats which the user must join to participate in the giveaway""" + winners_selection_date: DateTime + """Point in time (Unix timestamp) when winners of the giveaway will be selected""" + winner_count: int + """The number of users which are supposed to be selected as winners of the giveaway""" + only_new_members: Optional[bool] = None + """*Optional*. :code:`True`, if only users who join the chats after the giveaway started should be eligible to win""" + has_public_winners: Optional[bool] = None + """*Optional*. :code:`True`, if the list of giveaway winners will be visible to everyone""" + prize_description: Optional[str] = None + """*Optional*. Description of additional giveaway prize""" + country_codes: Optional[List[str]] = None + """*Optional*. A list of two-letter `ISO 3166-1 alpha-2 `_ country codes indicating the countries from which eligible users for the giveaway must come. If empty, then all users can participate in the giveaway. Users with a phone number that was bought on Fragment can always participate in giveaways.""" + premium_subscription_month_count: Optional[int] = None + """*Optional*. The number of months the Telegram Premium subscription won from the giveaway will be active for""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chats: List[Chat], + winners_selection_date: DateTime, + winner_count: int, + only_new_members: Optional[bool] = None, + has_public_winners: Optional[bool] = None, + prize_description: Optional[str] = None, + country_codes: Optional[List[str]] = None, + premium_subscription_month_count: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chats=chats, + winners_selection_date=winners_selection_date, + winner_count=winner_count, + only_new_members=only_new_members, + has_public_winners=has_public_winners, + prize_description=prize_description, + country_codes=country_codes, + premium_subscription_month_count=premium_subscription_month_count, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/giveaway_completed.py b/env/Lib/site-packages/aiogram/types/giveaway_completed.py new file mode 100644 index 0000000..71d525a --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/giveaway_completed.py @@ -0,0 +1,46 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .message import Message + + +class GiveawayCompleted(TelegramObject): + """ + This object represents a service message about the completion of a giveaway without public winners. + + Source: https://core.telegram.org/bots/api#giveawaycompleted + """ + + winner_count: int + """Number of winners in the giveaway""" + unclaimed_prize_count: Optional[int] = None + """*Optional*. Number of undistributed prizes""" + giveaway_message: Optional[Message] = None + """*Optional*. Message with the giveaway that was completed, if it wasn't deleted""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + winner_count: int, + unclaimed_prize_count: Optional[int] = None, + giveaway_message: Optional[Message] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + winner_count=winner_count, + unclaimed_prize_count=unclaimed_prize_count, + giveaway_message=giveaway_message, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/giveaway_created.py b/env/Lib/site-packages/aiogram/types/giveaway_created.py new file mode 100644 index 0000000..cd66d75 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/giveaway_created.py @@ -0,0 +1,9 @@ +from .base import TelegramObject + + +class GiveawayCreated(TelegramObject): + """ + This object represents a service message about the creation of a scheduled giveaway. Currently holds no information. + + Source: https://core.telegram.org/bots/api#giveawaycreated + """ diff --git a/env/Lib/site-packages/aiogram/types/giveaway_winners.py b/env/Lib/site-packages/aiogram/types/giveaway_winners.py new file mode 100644 index 0000000..8a501f8 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/giveaway_winners.py @@ -0,0 +1,80 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .chat import Chat + from .custom import DateTime + from .user import User + + +class GiveawayWinners(TelegramObject): + """ + This object represents a message about the completion of a giveaway with public winners. + + Source: https://core.telegram.org/bots/api#giveawaywinners + """ + + chat: Chat + """The chat that created the giveaway""" + giveaway_message_id: int + """Identifier of the message with the giveaway in the chat""" + winners_selection_date: DateTime + """Point in time (Unix timestamp) when winners of the giveaway were selected""" + winner_count: int + """Total number of winners in the giveaway""" + winners: List[User] + """List of up to 100 winners of the giveaway""" + additional_chat_count: Optional[int] = None + """*Optional*. The number of other chats the user had to join in order to be eligible for the giveaway""" + premium_subscription_month_count: Optional[int] = None + """*Optional*. The number of months the Telegram Premium subscription won from the giveaway will be active for""" + unclaimed_prize_count: Optional[int] = None + """*Optional*. Number of undistributed prizes""" + only_new_members: Optional[bool] = None + """*Optional*. :code:`True`, if only users who had joined the chats after the giveaway started were eligible to win""" + was_refunded: Optional[bool] = None + """*Optional*. :code:`True`, if the giveaway was canceled because the payment for it was refunded""" + prize_description: Optional[str] = None + """*Optional*. Description of additional giveaway prize""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat: Chat, + giveaway_message_id: int, + winners_selection_date: DateTime, + winner_count: int, + winners: List[User], + additional_chat_count: Optional[int] = None, + premium_subscription_month_count: Optional[int] = None, + unclaimed_prize_count: Optional[int] = None, + only_new_members: Optional[bool] = None, + was_refunded: Optional[bool] = None, + prize_description: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat=chat, + giveaway_message_id=giveaway_message_id, + winners_selection_date=winners_selection_date, + winner_count=winner_count, + winners=winners, + additional_chat_count=additional_chat_count, + premium_subscription_month_count=premium_subscription_month_count, + unclaimed_prize_count=unclaimed_prize_count, + only_new_members=only_new_members, + was_refunded=was_refunded, + prize_description=prize_description, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inaccessible_message.py b/env/Lib/site-packages/aiogram/types/inaccessible_message.py new file mode 100644 index 0000000..6ed38fe --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inaccessible_message.py @@ -0,0 +1,41 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from .maybe_inaccessible_message import MaybeInaccessibleMessage + +if TYPE_CHECKING: + from .chat import Chat + + +class InaccessibleMessage(MaybeInaccessibleMessage): + """ + This object describes a message that was deleted or is otherwise inaccessible to the bot. + + Source: https://core.telegram.org/bots/api#inaccessiblemessage + """ + + chat: Chat + """Chat the message belonged to""" + message_id: int + """Unique message identifier inside the chat""" + date: Literal[0] = 0 + """Always 0. The field can be used to differentiate regular and inaccessible messages.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat: Chat, + message_id: int, + date: Literal[0] = 0, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat=chat, message_id=message_id, date=date, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/inline_keyboard_button.py b/env/Lib/site-packages/aiogram/types/inline_keyboard_button.py new file mode 100644 index 0000000..fa801f2 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_keyboard_button.py @@ -0,0 +1,77 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import MutableTelegramObject + +if TYPE_CHECKING: + from .callback_game import CallbackGame + from .login_url import LoginUrl + from .switch_inline_query_chosen_chat import SwitchInlineQueryChosenChat + from .web_app_info import WebAppInfo + + +class InlineKeyboardButton(MutableTelegramObject): + """ + This object represents one button of an inline keyboard. Exactly one of the optional fields must be used to specify type of the button. + + Source: https://core.telegram.org/bots/api#inlinekeyboardbutton + """ + + text: str + """Label text on the button""" + url: Optional[str] = None + """*Optional*. HTTP or tg:// URL to be opened when the button is pressed. Links :code:`tg://user?id=` can be used to mention a user by their identifier without using a username, if this is allowed by their privacy settings.""" + callback_data: Optional[str] = None + """*Optional*. Data to be sent in a `callback query `_ to the bot when the button is pressed, 1-64 bytes""" + web_app: Optional[WebAppInfo] = None + """*Optional*. Description of the `Web App `_ that will be launched when the user presses the button. The Web App will be able to send an arbitrary message on behalf of the user using the method :class:`aiogram.methods.answer_web_app_query.AnswerWebAppQuery`. Available only in private chats between a user and the bot. Not supported for messages sent on behalf of a Telegram Business account.""" + login_url: Optional[LoginUrl] = None + """*Optional*. An HTTPS URL used to automatically authorize the user. Can be used as a replacement for the `Telegram Login Widget `_.""" + switch_inline_query: Optional[str] = None + """*Optional*. If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot's username and the specified inline query in the input field. May be empty, in which case just the bot's username will be inserted. Not supported for messages sent on behalf of a Telegram Business account.""" + switch_inline_query_current_chat: Optional[str] = None + """*Optional*. If set, pressing the button will insert the bot's username and the specified inline query in the current chat's input field. May be empty, in which case only the bot's username will be inserted.""" + switch_inline_query_chosen_chat: Optional[SwitchInlineQueryChosenChat] = None + """*Optional*. If set, pressing the button will prompt the user to select one of their chats of the specified type, open that chat and insert the bot's username and the specified inline query in the input field. Not supported for messages sent on behalf of a Telegram Business account.""" + callback_game: Optional[CallbackGame] = None + """*Optional*. Description of the game that will be launched when the user presses the button.""" + pay: Optional[bool] = None + """*Optional*. Specify :code:`True`, to send a `Pay button `_. Substrings '⭐' and 'XTR' in the buttons's text will be replaced with a Telegram Star icon.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + text: str, + url: Optional[str] = None, + callback_data: Optional[str] = None, + web_app: Optional[WebAppInfo] = None, + login_url: Optional[LoginUrl] = None, + switch_inline_query: Optional[str] = None, + switch_inline_query_current_chat: Optional[str] = None, + switch_inline_query_chosen_chat: Optional[SwitchInlineQueryChosenChat] = None, + callback_game: Optional[CallbackGame] = None, + pay: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + text=text, + url=url, + callback_data=callback_data, + web_app=web_app, + login_url=login_url, + switch_inline_query=switch_inline_query, + switch_inline_query_current_chat=switch_inline_query_current_chat, + switch_inline_query_chosen_chat=switch_inline_query_chosen_chat, + callback_game=callback_game, + pay=pay, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_keyboard_markup.py b/env/Lib/site-packages/aiogram/types/inline_keyboard_markup.py new file mode 100644 index 0000000..e5b8967 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_keyboard_markup.py @@ -0,0 +1,35 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List + +from .base import MutableTelegramObject + +if TYPE_CHECKING: + from .inline_keyboard_button import InlineKeyboardButton + + +class InlineKeyboardMarkup(MutableTelegramObject): + """ + This object represents an `inline keyboard `_ that appears right next to the message it belongs to. + + Source: https://core.telegram.org/bots/api#inlinekeyboardmarkup + """ + + inline_keyboard: List[List[InlineKeyboardButton]] + """Array of button rows, each represented by an Array of :class:`aiogram.types.inline_keyboard_button.InlineKeyboardButton` objects""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + inline_keyboard: List[List[InlineKeyboardButton]], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(inline_keyboard=inline_keyboard, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/inline_query.py b/env/Lib/site-packages/aiogram/types/inline_query.py new file mode 100644 index 0000000..a0cad31 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query.py @@ -0,0 +1,155 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from .base import TelegramObject + +if TYPE_CHECKING: + from ..methods import AnswerInlineQuery + from .inline_query_result_article import InlineQueryResultArticle + from .inline_query_result_audio import InlineQueryResultAudio + from .inline_query_result_cached_audio import InlineQueryResultCachedAudio + from .inline_query_result_cached_document import InlineQueryResultCachedDocument + from .inline_query_result_cached_gif import InlineQueryResultCachedGif + from .inline_query_result_cached_mpeg4_gif import InlineQueryResultCachedMpeg4Gif + from .inline_query_result_cached_photo import InlineQueryResultCachedPhoto + from .inline_query_result_cached_sticker import InlineQueryResultCachedSticker + from .inline_query_result_cached_video import InlineQueryResultCachedVideo + from .inline_query_result_cached_voice import InlineQueryResultCachedVoice + from .inline_query_result_contact import InlineQueryResultContact + from .inline_query_result_document import InlineQueryResultDocument + from .inline_query_result_game import InlineQueryResultGame + from .inline_query_result_gif import InlineQueryResultGif + from .inline_query_result_location import InlineQueryResultLocation + from .inline_query_result_mpeg4_gif import InlineQueryResultMpeg4Gif + from .inline_query_result_photo import InlineQueryResultPhoto + from .inline_query_result_venue import InlineQueryResultVenue + from .inline_query_result_video import InlineQueryResultVideo + from .inline_query_result_voice import InlineQueryResultVoice + from .inline_query_results_button import InlineQueryResultsButton + from .location import Location + from .user import User + + +class InlineQuery(TelegramObject): + """ + This object represents an incoming inline query. When the user sends an empty query, your bot could return some default or trending results. + + Source: https://core.telegram.org/bots/api#inlinequery + """ + + id: str + """Unique identifier for this query""" + from_user: User = Field(..., alias="from") + """Sender""" + query: str + """Text of the query (up to 256 characters)""" + offset: str + """Offset of the results to be returned, can be controlled by the bot""" + chat_type: Optional[str] = None + """*Optional*. Type of the chat from which the inline query was sent. Can be either 'sender' for a private chat with the inline query sender, 'private', 'group', 'supergroup', or 'channel'. The chat type should be always known for requests sent from official clients and most third-party clients, unless the request was sent from a secret chat""" + location: Optional[Location] = None + """*Optional*. Sender location, only for bots that request user location""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + id: str, + from_user: User, + query: str, + offset: str, + chat_type: Optional[str] = None, + location: Optional[Location] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + id=id, + from_user=from_user, + query=query, + offset=offset, + chat_type=chat_type, + location=location, + **__pydantic_kwargs, + ) + + def answer( + self, + results: List[ + Union[ + InlineQueryResultCachedAudio, + InlineQueryResultCachedDocument, + InlineQueryResultCachedGif, + InlineQueryResultCachedMpeg4Gif, + InlineQueryResultCachedPhoto, + InlineQueryResultCachedSticker, + InlineQueryResultCachedVideo, + InlineQueryResultCachedVoice, + InlineQueryResultArticle, + InlineQueryResultAudio, + InlineQueryResultContact, + InlineQueryResultGame, + InlineQueryResultDocument, + InlineQueryResultGif, + InlineQueryResultLocation, + InlineQueryResultMpeg4Gif, + InlineQueryResultPhoto, + InlineQueryResultVenue, + InlineQueryResultVideo, + InlineQueryResultVoice, + ] + ], + cache_time: Optional[int] = None, + is_personal: Optional[bool] = None, + next_offset: Optional[str] = None, + button: Optional[InlineQueryResultsButton] = None, + switch_pm_parameter: Optional[str] = None, + switch_pm_text: Optional[str] = None, + **kwargs: Any, + ) -> AnswerInlineQuery: + """ + Shortcut for method :class:`aiogram.methods.answer_inline_query.AnswerInlineQuery` + will automatically fill method attributes: + + - :code:`inline_query_id` + + Use this method to send answers to an inline query. On success, :code:`True` is returned. + + No more than **50** results per query are allowed. + + Source: https://core.telegram.org/bots/api#answerinlinequery + + :param results: A JSON-serialized array of results for the inline query + :param cache_time: The maximum amount of time in seconds that the result of the inline query may be cached on the server. Defaults to 300. + :param is_personal: Pass :code:`True` if results may be cached on the server side only for the user that sent the query. By default, results may be returned to any user who sends the same query. + :param next_offset: Pass the offset that a client should send in the next query with the same text to receive more results. Pass an empty string if there are no more results or if you don't support pagination. Offset length can't exceed 64 bytes. + :param button: A JSON-serialized object describing a button to be shown above inline query results + :param switch_pm_parameter: `Deep-linking `_ parameter for the /start message sent to the bot when user presses the switch button. 1-64 characters, only :code:`A-Z`, :code:`a-z`, :code:`0-9`, :code:`_` and :code:`-` are allowed. + :param switch_pm_text: If passed, clients will display a button with specified text that switches the user to a private chat with the bot and sends the bot a start message with the parameter *switch_pm_parameter* + :return: instance of method :class:`aiogram.methods.answer_inline_query.AnswerInlineQuery` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import AnswerInlineQuery + + return AnswerInlineQuery( + inline_query_id=self.id, + results=results, + cache_time=cache_time, + is_personal=is_personal, + next_offset=next_offset, + button=button, + switch_pm_parameter=switch_pm_parameter, + switch_pm_text=switch_pm_text, + **kwargs, + ).as_(self._bot) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result.py b/env/Lib/site-packages/aiogram/types/inline_query_result.py new file mode 100644 index 0000000..b615aa2 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result.py @@ -0,0 +1,34 @@ +from __future__ import annotations + +from .base import MutableTelegramObject + + +class InlineQueryResult(MutableTelegramObject): + """ + This object represents one result of an inline query. Telegram clients currently support results of the following 20 types: + + - :class:`aiogram.types.inline_query_result_cached_audio.InlineQueryResultCachedAudio` + - :class:`aiogram.types.inline_query_result_cached_document.InlineQueryResultCachedDocument` + - :class:`aiogram.types.inline_query_result_cached_gif.InlineQueryResultCachedGif` + - :class:`aiogram.types.inline_query_result_cached_mpeg4_gif.InlineQueryResultCachedMpeg4Gif` + - :class:`aiogram.types.inline_query_result_cached_photo.InlineQueryResultCachedPhoto` + - :class:`aiogram.types.inline_query_result_cached_sticker.InlineQueryResultCachedSticker` + - :class:`aiogram.types.inline_query_result_cached_video.InlineQueryResultCachedVideo` + - :class:`aiogram.types.inline_query_result_cached_voice.InlineQueryResultCachedVoice` + - :class:`aiogram.types.inline_query_result_article.InlineQueryResultArticle` + - :class:`aiogram.types.inline_query_result_audio.InlineQueryResultAudio` + - :class:`aiogram.types.inline_query_result_contact.InlineQueryResultContact` + - :class:`aiogram.types.inline_query_result_game.InlineQueryResultGame` + - :class:`aiogram.types.inline_query_result_document.InlineQueryResultDocument` + - :class:`aiogram.types.inline_query_result_gif.InlineQueryResultGif` + - :class:`aiogram.types.inline_query_result_location.InlineQueryResultLocation` + - :class:`aiogram.types.inline_query_result_mpeg4_gif.InlineQueryResultMpeg4Gif` + - :class:`aiogram.types.inline_query_result_photo.InlineQueryResultPhoto` + - :class:`aiogram.types.inline_query_result_venue.InlineQueryResultVenue` + - :class:`aiogram.types.inline_query_result_video.InlineQueryResultVideo` + - :class:`aiogram.types.inline_query_result_voice.InlineQueryResultVoice` + + **Note:** All URLs passed in inline query results will be available to end users and therefore must be assumed to be **public**. + + Source: https://core.telegram.org/bots/api#inlinequeryresult + """ diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_article.py b/env/Lib/site-packages/aiogram/types/inline_query_result_article.py new file mode 100644 index 0000000..c998738 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_article.py @@ -0,0 +1,96 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional, Union + +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + + +class InlineQueryResultArticle(InlineQueryResult): + """ + Represents a link to an article or web page. + + Source: https://core.telegram.org/bots/api#inlinequeryresultarticle + """ + + type: Literal[InlineQueryResultType.ARTICLE] = InlineQueryResultType.ARTICLE + """Type of the result, must be *article*""" + id: str + """Unique identifier for this result, 1-64 Bytes""" + title: str + """Title of the result""" + input_message_content: Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + """Content of the message to be sent""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + url: Optional[str] = None + """*Optional*. URL of the result""" + hide_url: Optional[bool] = None + """*Optional*. Pass :code:`True` if you don't want the URL to be shown in the message""" + description: Optional[str] = None + """*Optional*. Short description of the result""" + thumbnail_url: Optional[str] = None + """*Optional*. Url of the thumbnail for the result""" + thumbnail_width: Optional[int] = None + """*Optional*. Thumbnail width""" + thumbnail_height: Optional[int] = None + """*Optional*. Thumbnail height""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.ARTICLE] = InlineQueryResultType.ARTICLE, + id: str, + title: str, + input_message_content: Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ], + reply_markup: Optional[InlineKeyboardMarkup] = None, + url: Optional[str] = None, + hide_url: Optional[bool] = None, + description: Optional[str] = None, + thumbnail_url: Optional[str] = None, + thumbnail_width: Optional[int] = None, + thumbnail_height: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + title=title, + input_message_content=input_message_content, + reply_markup=reply_markup, + url=url, + hide_url=hide_url, + description=description, + thumbnail_url=thumbnail_url, + thumbnail_width=thumbnail_width, + thumbnail_height=thumbnail_height, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_audio.py b/env/Lib/site-packages/aiogram/types/inline_query_result_audio.py new file mode 100644 index 0000000..56ef5f5 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_audio.py @@ -0,0 +1,102 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + from .message_entity import MessageEntity + + +class InlineQueryResultAudio(InlineQueryResult): + """ + Represents a link to an MP3 audio file. By default, this audio file will be sent by the user. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the audio. + + Source: https://core.telegram.org/bots/api#inlinequeryresultaudio + """ + + type: Literal[InlineQueryResultType.AUDIO] = InlineQueryResultType.AUDIO + """Type of the result, must be *audio*""" + id: str + """Unique identifier for this result, 1-64 bytes""" + audio_url: str + """A valid URL for the audio file""" + title: str + """Title""" + caption: Optional[str] = None + """*Optional*. Caption, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the audio caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + performer: Optional[str] = None + """*Optional*. Performer""" + audio_duration: Optional[int] = None + """*Optional*. Audio duration in seconds""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the audio""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.AUDIO] = InlineQueryResultType.AUDIO, + id: str, + audio_url: str, + title: str, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + performer: Optional[str] = None, + audio_duration: Optional[int] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + audio_url=audio_url, + title=title, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + performer=performer, + audio_duration=audio_duration, + reply_markup=reply_markup, + input_message_content=input_message_content, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_cached_audio.py b/env/Lib/site-packages/aiogram/types/inline_query_result_cached_audio.py new file mode 100644 index 0000000..27d923f --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_cached_audio.py @@ -0,0 +1,90 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + from .message_entity import MessageEntity + + +class InlineQueryResultCachedAudio(InlineQueryResult): + """ + Represents a link to an MP3 audio file stored on the Telegram servers. By default, this audio file will be sent by the user. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the audio. + + Source: https://core.telegram.org/bots/api#inlinequeryresultcachedaudio + """ + + type: Literal[InlineQueryResultType.AUDIO] = InlineQueryResultType.AUDIO + """Type of the result, must be *audio*""" + id: str + """Unique identifier for this result, 1-64 bytes""" + audio_file_id: str + """A valid file identifier for the audio file""" + caption: Optional[str] = None + """*Optional*. Caption, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the audio caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the audio""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.AUDIO] = InlineQueryResultType.AUDIO, + id: str, + audio_file_id: str, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + audio_file_id=audio_file_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + reply_markup=reply_markup, + input_message_content=input_message_content, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_cached_document.py b/env/Lib/site-packages/aiogram/types/inline_query_result_cached_document.py new file mode 100644 index 0000000..8e0355e --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_cached_document.py @@ -0,0 +1,98 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + from .message_entity import MessageEntity + + +class InlineQueryResultCachedDocument(InlineQueryResult): + """ + Represents a link to a file stored on the Telegram servers. By default, this file will be sent by the user with an optional caption. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the file. + + Source: https://core.telegram.org/bots/api#inlinequeryresultcacheddocument + """ + + type: Literal[InlineQueryResultType.DOCUMENT] = InlineQueryResultType.DOCUMENT + """Type of the result, must be *document*""" + id: str + """Unique identifier for this result, 1-64 bytes""" + title: str + """Title for the result""" + document_file_id: str + """A valid file identifier for the file""" + description: Optional[str] = None + """*Optional*. Short description of the result""" + caption: Optional[str] = None + """*Optional*. Caption of the document to be sent, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the document caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the file""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.DOCUMENT] = InlineQueryResultType.DOCUMENT, + id: str, + title: str, + document_file_id: str, + description: Optional[str] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + title=title, + document_file_id=document_file_id, + description=description, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + reply_markup=reply_markup, + input_message_content=input_message_content, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_cached_gif.py b/env/Lib/site-packages/aiogram/types/inline_query_result_cached_gif.py new file mode 100644 index 0000000..277454c --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_cached_gif.py @@ -0,0 +1,100 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + from .message_entity import MessageEntity + + +class InlineQueryResultCachedGif(InlineQueryResult): + """ + Represents a link to an animated GIF file stored on the Telegram servers. By default, this animated GIF file will be sent by the user with an optional caption. Alternatively, you can use *input_message_content* to send a message with specified content instead of the animation. + + Source: https://core.telegram.org/bots/api#inlinequeryresultcachedgif + """ + + type: Literal[InlineQueryResultType.GIF] = InlineQueryResultType.GIF + """Type of the result, must be *gif*""" + id: str + """Unique identifier for this result, 1-64 bytes""" + gif_file_id: str + """A valid file identifier for the GIF file""" + title: Optional[str] = None + """*Optional*. Title for the result""" + caption: Optional[str] = None + """*Optional*. Caption of the GIF file to be sent, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[Union[bool, Default]] = Default("show_caption_above_media") + """*Optional*. Pass :code:`True`, if the caption must be shown above the message media""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the GIF animation""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.GIF] = InlineQueryResultType.GIF, + id: str, + gif_file_id: str, + title: Optional[str] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + gif_file_id=gif_file_id, + title=title, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + reply_markup=reply_markup, + input_message_content=input_message_content, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_cached_mpeg4_gif.py b/env/Lib/site-packages/aiogram/types/inline_query_result_cached_mpeg4_gif.py new file mode 100644 index 0000000..ec04386 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_cached_mpeg4_gif.py @@ -0,0 +1,100 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + from .message_entity import MessageEntity + + +class InlineQueryResultCachedMpeg4Gif(InlineQueryResult): + """ + Represents a link to a video animation (H.264/MPEG-4 AVC video without sound) stored on the Telegram servers. By default, this animated MPEG-4 file will be sent by the user with an optional caption. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the animation. + + Source: https://core.telegram.org/bots/api#inlinequeryresultcachedmpeg4gif + """ + + type: Literal[InlineQueryResultType.MPEG4_GIF] = InlineQueryResultType.MPEG4_GIF + """Type of the result, must be *mpeg4_gif*""" + id: str + """Unique identifier for this result, 1-64 bytes""" + mpeg4_file_id: str + """A valid file identifier for the MPEG4 file""" + title: Optional[str] = None + """*Optional*. Title for the result""" + caption: Optional[str] = None + """*Optional*. Caption of the MPEG-4 file to be sent, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[Union[bool, Default]] = Default("show_caption_above_media") + """*Optional*. Pass :code:`True`, if the caption must be shown above the message media""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the video animation""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.MPEG4_GIF] = InlineQueryResultType.MPEG4_GIF, + id: str, + mpeg4_file_id: str, + title: Optional[str] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + mpeg4_file_id=mpeg4_file_id, + title=title, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + reply_markup=reply_markup, + input_message_content=input_message_content, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_cached_photo.py b/env/Lib/site-packages/aiogram/types/inline_query_result_cached_photo.py new file mode 100644 index 0000000..f40b203 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_cached_photo.py @@ -0,0 +1,104 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + from .message_entity import MessageEntity + + +class InlineQueryResultCachedPhoto(InlineQueryResult): + """ + Represents a link to a photo stored on the Telegram servers. By default, this photo will be sent by the user with an optional caption. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the photo. + + Source: https://core.telegram.org/bots/api#inlinequeryresultcachedphoto + """ + + type: Literal[InlineQueryResultType.PHOTO] = InlineQueryResultType.PHOTO + """Type of the result, must be *photo*""" + id: str + """Unique identifier for this result, 1-64 bytes""" + photo_file_id: str + """A valid file identifier of the photo""" + title: Optional[str] = None + """*Optional*. Title for the result""" + description: Optional[str] = None + """*Optional*. Short description of the result""" + caption: Optional[str] = None + """*Optional*. Caption of the photo to be sent, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the photo caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[Union[bool, Default]] = Default("show_caption_above_media") + """*Optional*. Pass :code:`True`, if the caption must be shown above the message media""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the photo""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.PHOTO] = InlineQueryResultType.PHOTO, + id: str, + photo_file_id: str, + title: Optional[str] = None, + description: Optional[str] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + photo_file_id=photo_file_id, + title=title, + description=description, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + reply_markup=reply_markup, + input_message_content=input_message_content, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_cached_sticker.py b/env/Lib/site-packages/aiogram/types/inline_query_result_cached_sticker.py new file mode 100644 index 0000000..4300023 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_cached_sticker.py @@ -0,0 +1,76 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional, Union + +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + + +class InlineQueryResultCachedSticker(InlineQueryResult): + """ + Represents a link to a sticker stored on the Telegram servers. By default, this sticker will be sent by the user. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the sticker. + + Source: https://core.telegram.org/bots/api#inlinequeryresultcachedsticker + """ + + type: Literal[InlineQueryResultType.STICKER] = InlineQueryResultType.STICKER + """Type of the result, must be *sticker*""" + id: str + """Unique identifier for this result, 1-64 bytes""" + sticker_file_id: str + """A valid file identifier of the sticker""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the sticker""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.STICKER] = InlineQueryResultType.STICKER, + id: str, + sticker_file_id: str, + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + sticker_file_id=sticker_file_id, + reply_markup=reply_markup, + input_message_content=input_message_content, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_cached_video.py b/env/Lib/site-packages/aiogram/types/inline_query_result_cached_video.py new file mode 100644 index 0000000..4095ab9 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_cached_video.py @@ -0,0 +1,104 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + from .message_entity import MessageEntity + + +class InlineQueryResultCachedVideo(InlineQueryResult): + """ + Represents a link to a video file stored on the Telegram servers. By default, this video file will be sent by the user with an optional caption. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the video. + + Source: https://core.telegram.org/bots/api#inlinequeryresultcachedvideo + """ + + type: Literal[InlineQueryResultType.VIDEO] = InlineQueryResultType.VIDEO + """Type of the result, must be *video*""" + id: str + """Unique identifier for this result, 1-64 bytes""" + video_file_id: str + """A valid file identifier for the video file""" + title: str + """Title for the result""" + description: Optional[str] = None + """*Optional*. Short description of the result""" + caption: Optional[str] = None + """*Optional*. Caption of the video to be sent, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the video caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[Union[bool, Default]] = Default("show_caption_above_media") + """*Optional*. Pass :code:`True`, if the caption must be shown above the message media""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the video""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.VIDEO] = InlineQueryResultType.VIDEO, + id: str, + video_file_id: str, + title: str, + description: Optional[str] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + video_file_id=video_file_id, + title=title, + description=description, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + reply_markup=reply_markup, + input_message_content=input_message_content, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_cached_voice.py b/env/Lib/site-packages/aiogram/types/inline_query_result_cached_voice.py new file mode 100644 index 0000000..4cff896 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_cached_voice.py @@ -0,0 +1,94 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + from .message_entity import MessageEntity + + +class InlineQueryResultCachedVoice(InlineQueryResult): + """ + Represents a link to a voice message stored on the Telegram servers. By default, this voice message will be sent by the user. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the voice message. + + Source: https://core.telegram.org/bots/api#inlinequeryresultcachedvoice + """ + + type: Literal[InlineQueryResultType.VOICE] = InlineQueryResultType.VOICE + """Type of the result, must be *voice*""" + id: str + """Unique identifier for this result, 1-64 bytes""" + voice_file_id: str + """A valid file identifier for the voice message""" + title: str + """Voice message title""" + caption: Optional[str] = None + """*Optional*. Caption, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the voice message caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the voice message""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.VOICE] = InlineQueryResultType.VOICE, + id: str, + voice_file_id: str, + title: str, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + voice_file_id=voice_file_id, + title=title, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + reply_markup=reply_markup, + input_message_content=input_message_content, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_contact.py b/env/Lib/site-packages/aiogram/types/inline_query_result_contact.py new file mode 100644 index 0000000..cc2900c --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_contact.py @@ -0,0 +1,100 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional, Union + +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + + +class InlineQueryResultContact(InlineQueryResult): + """ + Represents a contact with a phone number. By default, this contact will be sent by the user. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the contact. + + Source: https://core.telegram.org/bots/api#inlinequeryresultcontact + """ + + type: Literal[InlineQueryResultType.CONTACT] = InlineQueryResultType.CONTACT + """Type of the result, must be *contact*""" + id: str + """Unique identifier for this result, 1-64 Bytes""" + phone_number: str + """Contact's phone number""" + first_name: str + """Contact's first name""" + last_name: Optional[str] = None + """*Optional*. Contact's last name""" + vcard: Optional[str] = None + """*Optional*. Additional data about the contact in the form of a `vCard `_, 0-2048 bytes""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the contact""" + thumbnail_url: Optional[str] = None + """*Optional*. Url of the thumbnail for the result""" + thumbnail_width: Optional[int] = None + """*Optional*. Thumbnail width""" + thumbnail_height: Optional[int] = None + """*Optional*. Thumbnail height""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.CONTACT] = InlineQueryResultType.CONTACT, + id: str, + phone_number: str, + first_name: str, + last_name: Optional[str] = None, + vcard: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + thumbnail_url: Optional[str] = None, + thumbnail_width: Optional[int] = None, + thumbnail_height: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + phone_number=phone_number, + first_name=first_name, + last_name=last_name, + vcard=vcard, + reply_markup=reply_markup, + input_message_content=input_message_content, + thumbnail_url=thumbnail_url, + thumbnail_width=thumbnail_width, + thumbnail_height=thumbnail_height, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_document.py b/env/Lib/site-packages/aiogram/types/inline_query_result_document.py new file mode 100644 index 0000000..86ae993 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_document.py @@ -0,0 +1,114 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + from .message_entity import MessageEntity + + +class InlineQueryResultDocument(InlineQueryResult): + """ + Represents a link to a file. By default, this file will be sent by the user with an optional caption. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the file. Currently, only **.PDF** and **.ZIP** files can be sent using this method. + + Source: https://core.telegram.org/bots/api#inlinequeryresultdocument + """ + + type: Literal[InlineQueryResultType.DOCUMENT] = InlineQueryResultType.DOCUMENT + """Type of the result, must be *document*""" + id: str + """Unique identifier for this result, 1-64 bytes""" + title: str + """Title for the result""" + document_url: str + """A valid URL for the file""" + mime_type: str + """MIME type of the content of the file, either 'application/pdf' or 'application/zip'""" + caption: Optional[str] = None + """*Optional*. Caption of the document to be sent, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the document caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + description: Optional[str] = None + """*Optional*. Short description of the result""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. Inline keyboard attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the file""" + thumbnail_url: Optional[str] = None + """*Optional*. URL of the thumbnail (JPEG only) for the file""" + thumbnail_width: Optional[int] = None + """*Optional*. Thumbnail width""" + thumbnail_height: Optional[int] = None + """*Optional*. Thumbnail height""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.DOCUMENT] = InlineQueryResultType.DOCUMENT, + id: str, + title: str, + document_url: str, + mime_type: str, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + description: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + thumbnail_url: Optional[str] = None, + thumbnail_width: Optional[int] = None, + thumbnail_height: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + title=title, + document_url=document_url, + mime_type=mime_type, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + description=description, + reply_markup=reply_markup, + input_message_content=input_message_content, + thumbnail_url=thumbnail_url, + thumbnail_width=thumbnail_width, + thumbnail_height=thumbnail_height, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_game.py b/env/Lib/site-packages/aiogram/types/inline_query_result_game.py new file mode 100644 index 0000000..3c7dcde --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_game.py @@ -0,0 +1,51 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional + +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + + +class InlineQueryResultGame(InlineQueryResult): + """ + Represents a `Game `_. + + Source: https://core.telegram.org/bots/api#inlinequeryresultgame + """ + + type: Literal[InlineQueryResultType.GAME] = InlineQueryResultType.GAME + """Type of the result, must be *game*""" + id: str + """Unique identifier for this result, 1-64 bytes""" + game_short_name: str + """Short name of the game""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.GAME] = InlineQueryResultType.GAME, + id: str, + game_short_name: str, + reply_markup: Optional[InlineKeyboardMarkup] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + game_short_name=game_short_name, + reply_markup=reply_markup, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_gif.py b/env/Lib/site-packages/aiogram/types/inline_query_result_gif.py new file mode 100644 index 0000000..3ad0eef --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_gif.py @@ -0,0 +1,121 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InlineQueryResultType +from .base import UNSET_PARSE_MODE +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + from .message_entity import MessageEntity + + +class InlineQueryResultGif(InlineQueryResult): + """ + Represents a link to an animated GIF file. By default, this animated GIF file will be sent by the user with optional caption. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the animation. + + Source: https://core.telegram.org/bots/api#inlinequeryresultgif + """ + + type: Literal[InlineQueryResultType.GIF] = InlineQueryResultType.GIF + """Type of the result, must be *gif*""" + id: str + """Unique identifier for this result, 1-64 bytes""" + gif_url: str + """A valid URL for the GIF file. File size must not exceed 1MB""" + thumbnail_url: str + """URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result""" + gif_width: Optional[int] = None + """*Optional*. Width of the GIF""" + gif_height: Optional[int] = None + """*Optional*. Height of the GIF""" + gif_duration: Optional[int] = None + """*Optional*. Duration of the GIF in seconds""" + thumbnail_mime_type: Optional[str] = None + """*Optional*. MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'""" + title: Optional[str] = None + """*Optional*. Title for the result""" + caption: Optional[str] = None + """*Optional*. Caption of the GIF file to be sent, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[Union[bool, Default]] = Default("show_caption_above_media") + """*Optional*. Pass :code:`True`, if the caption must be shown above the message media""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the GIF animation""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.GIF] = InlineQueryResultType.GIF, + id: str, + gif_url: str, + thumbnail_url: str, + gif_width: Optional[int] = None, + gif_height: Optional[int] = None, + gif_duration: Optional[int] = None, + thumbnail_mime_type: Optional[str] = None, + title: Optional[str] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + gif_url=gif_url, + thumbnail_url=thumbnail_url, + gif_width=gif_width, + gif_height=gif_height, + gif_duration=gif_duration, + thumbnail_mime_type=thumbnail_mime_type, + title=title, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + reply_markup=reply_markup, + input_message_content=input_message_content, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_location.py b/env/Lib/site-packages/aiogram/types/inline_query_result_location.py new file mode 100644 index 0000000..50b3ed8 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_location.py @@ -0,0 +1,112 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional, Union + +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + + +class InlineQueryResultLocation(InlineQueryResult): + """ + Represents a location on a map. By default, the location will be sent by the user. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the location. + + Source: https://core.telegram.org/bots/api#inlinequeryresultlocation + """ + + type: Literal[InlineQueryResultType.LOCATION] = InlineQueryResultType.LOCATION + """Type of the result, must be *location*""" + id: str + """Unique identifier for this result, 1-64 Bytes""" + latitude: float + """Location latitude in degrees""" + longitude: float + """Location longitude in degrees""" + title: str + """Location title""" + horizontal_accuracy: Optional[float] = None + """*Optional*. The radius of uncertainty for the location, measured in meters; 0-1500""" + live_period: Optional[int] = None + """*Optional*. Period in seconds during which the location can be updated, should be between 60 and 86400, or 0x7FFFFFFF for live locations that can be edited indefinitely.""" + heading: Optional[int] = None + """*Optional*. For live locations, a direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.""" + proximity_alert_radius: Optional[int] = None + """*Optional*. For live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the location""" + thumbnail_url: Optional[str] = None + """*Optional*. Url of the thumbnail for the result""" + thumbnail_width: Optional[int] = None + """*Optional*. Thumbnail width""" + thumbnail_height: Optional[int] = None + """*Optional*. Thumbnail height""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.LOCATION] = InlineQueryResultType.LOCATION, + id: str, + latitude: float, + longitude: float, + title: str, + horizontal_accuracy: Optional[float] = None, + live_period: Optional[int] = None, + heading: Optional[int] = None, + proximity_alert_radius: Optional[int] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + thumbnail_url: Optional[str] = None, + thumbnail_width: Optional[int] = None, + thumbnail_height: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + latitude=latitude, + longitude=longitude, + title=title, + horizontal_accuracy=horizontal_accuracy, + live_period=live_period, + heading=heading, + proximity_alert_radius=proximity_alert_radius, + reply_markup=reply_markup, + input_message_content=input_message_content, + thumbnail_url=thumbnail_url, + thumbnail_width=thumbnail_width, + thumbnail_height=thumbnail_height, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_mpeg4_gif.py b/env/Lib/site-packages/aiogram/types/inline_query_result_mpeg4_gif.py new file mode 100644 index 0000000..6ca282e --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_mpeg4_gif.py @@ -0,0 +1,120 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + from .message_entity import MessageEntity + + +class InlineQueryResultMpeg4Gif(InlineQueryResult): + """ + Represents a link to a video animation (H.264/MPEG-4 AVC video without sound). By default, this animated MPEG-4 file will be sent by the user with optional caption. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the animation. + + Source: https://core.telegram.org/bots/api#inlinequeryresultmpeg4gif + """ + + type: Literal[InlineQueryResultType.MPEG4_GIF] = InlineQueryResultType.MPEG4_GIF + """Type of the result, must be *mpeg4_gif*""" + id: str + """Unique identifier for this result, 1-64 bytes""" + mpeg4_url: str + """A valid URL for the MPEG4 file. File size must not exceed 1MB""" + thumbnail_url: str + """URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result""" + mpeg4_width: Optional[int] = None + """*Optional*. Video width""" + mpeg4_height: Optional[int] = None + """*Optional*. Video height""" + mpeg4_duration: Optional[int] = None + """*Optional*. Video duration in seconds""" + thumbnail_mime_type: Optional[str] = None + """*Optional*. MIME type of the thumbnail, must be one of 'image/jpeg', 'image/gif', or 'video/mp4'. Defaults to 'image/jpeg'""" + title: Optional[str] = None + """*Optional*. Title for the result""" + caption: Optional[str] = None + """*Optional*. Caption of the MPEG-4 file to be sent, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[Union[bool, Default]] = Default("show_caption_above_media") + """*Optional*. Pass :code:`True`, if the caption must be shown above the message media""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the video animation""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.MPEG4_GIF] = InlineQueryResultType.MPEG4_GIF, + id: str, + mpeg4_url: str, + thumbnail_url: str, + mpeg4_width: Optional[int] = None, + mpeg4_height: Optional[int] = None, + mpeg4_duration: Optional[int] = None, + thumbnail_mime_type: Optional[str] = None, + title: Optional[str] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + mpeg4_url=mpeg4_url, + thumbnail_url=thumbnail_url, + mpeg4_width=mpeg4_width, + mpeg4_height=mpeg4_height, + mpeg4_duration=mpeg4_duration, + thumbnail_mime_type=thumbnail_mime_type, + title=title, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + reply_markup=reply_markup, + input_message_content=input_message_content, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_photo.py b/env/Lib/site-packages/aiogram/types/inline_query_result_photo.py new file mode 100644 index 0000000..02f6841 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_photo.py @@ -0,0 +1,116 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + from .message_entity import MessageEntity + + +class InlineQueryResultPhoto(InlineQueryResult): + """ + Represents a link to a photo. By default, this photo will be sent by the user with optional caption. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the photo. + + Source: https://core.telegram.org/bots/api#inlinequeryresultphoto + """ + + type: Literal[InlineQueryResultType.PHOTO] = InlineQueryResultType.PHOTO + """Type of the result, must be *photo*""" + id: str + """Unique identifier for this result, 1-64 bytes""" + photo_url: str + """A valid URL of the photo. Photo must be in **JPEG** format. Photo size must not exceed 5MB""" + thumbnail_url: str + """URL of the thumbnail for the photo""" + photo_width: Optional[int] = None + """*Optional*. Width of the photo""" + photo_height: Optional[int] = None + """*Optional*. Height of the photo""" + title: Optional[str] = None + """*Optional*. Title for the result""" + description: Optional[str] = None + """*Optional*. Short description of the result""" + caption: Optional[str] = None + """*Optional*. Caption of the photo to be sent, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the photo caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[Union[bool, Default]] = Default("show_caption_above_media") + """*Optional*. Pass :code:`True`, if the caption must be shown above the message media""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the photo""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.PHOTO] = InlineQueryResultType.PHOTO, + id: str, + photo_url: str, + thumbnail_url: str, + photo_width: Optional[int] = None, + photo_height: Optional[int] = None, + title: Optional[str] = None, + description: Optional[str] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + photo_url=photo_url, + thumbnail_url=thumbnail_url, + photo_width=photo_width, + photo_height=photo_height, + title=title, + description=description, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + reply_markup=reply_markup, + input_message_content=input_message_content, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_venue.py b/env/Lib/site-packages/aiogram/types/inline_query_result_venue.py new file mode 100644 index 0000000..b8775b6 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_venue.py @@ -0,0 +1,116 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional, Union + +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + + +class InlineQueryResultVenue(InlineQueryResult): + """ + Represents a venue. By default, the venue will be sent by the user. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the venue. + + Source: https://core.telegram.org/bots/api#inlinequeryresultvenue + """ + + type: Literal[InlineQueryResultType.VENUE] = InlineQueryResultType.VENUE + """Type of the result, must be *venue*""" + id: str + """Unique identifier for this result, 1-64 Bytes""" + latitude: float + """Latitude of the venue location in degrees""" + longitude: float + """Longitude of the venue location in degrees""" + title: str + """Title of the venue""" + address: str + """Address of the venue""" + foursquare_id: Optional[str] = None + """*Optional*. Foursquare identifier of the venue if known""" + foursquare_type: Optional[str] = None + """*Optional*. Foursquare type of the venue, if known. (For example, 'arts_entertainment/default', 'arts_entertainment/aquarium' or 'food/icecream'.)""" + google_place_id: Optional[str] = None + """*Optional*. Google Places identifier of the venue""" + google_place_type: Optional[str] = None + """*Optional*. Google Places type of the venue. (See `supported types `_.)""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the venue""" + thumbnail_url: Optional[str] = None + """*Optional*. Url of the thumbnail for the result""" + thumbnail_width: Optional[int] = None + """*Optional*. Thumbnail width""" + thumbnail_height: Optional[int] = None + """*Optional*. Thumbnail height""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.VENUE] = InlineQueryResultType.VENUE, + id: str, + latitude: float, + longitude: float, + title: str, + address: str, + foursquare_id: Optional[str] = None, + foursquare_type: Optional[str] = None, + google_place_id: Optional[str] = None, + google_place_type: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + thumbnail_url: Optional[str] = None, + thumbnail_width: Optional[int] = None, + thumbnail_height: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + latitude=latitude, + longitude=longitude, + title=title, + address=address, + foursquare_id=foursquare_id, + foursquare_type=foursquare_type, + google_place_id=google_place_id, + google_place_type=google_place_type, + reply_markup=reply_markup, + input_message_content=input_message_content, + thumbnail_url=thumbnail_url, + thumbnail_width=thumbnail_width, + thumbnail_height=thumbnail_height, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_video.py b/env/Lib/site-packages/aiogram/types/inline_query_result_video.py new file mode 100644 index 0000000..52332fd --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_video.py @@ -0,0 +1,126 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + from .message_entity import MessageEntity + + +class InlineQueryResultVideo(InlineQueryResult): + """ + Represents a link to a page containing an embedded video player or a video file. By default, this video file will be sent by the user with an optional caption. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the video. + + If an InlineQueryResultVideo message contains an embedded video (e.g., YouTube), you **must** replace its content using *input_message_content*. + + Source: https://core.telegram.org/bots/api#inlinequeryresultvideo + """ + + type: Literal[InlineQueryResultType.VIDEO] = InlineQueryResultType.VIDEO + """Type of the result, must be *video*""" + id: str + """Unique identifier for this result, 1-64 bytes""" + video_url: str + """A valid URL for the embedded video player or video file""" + mime_type: str + """MIME type of the content of the video URL, 'text/html' or 'video/mp4'""" + thumbnail_url: str + """URL of the thumbnail (JPEG only) for the video""" + title: str + """Title for the result""" + caption: Optional[str] = None + """*Optional*. Caption of the video to be sent, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the video caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[Union[bool, Default]] = Default("show_caption_above_media") + """*Optional*. Pass :code:`True`, if the caption must be shown above the message media""" + video_width: Optional[int] = None + """*Optional*. Video width""" + video_height: Optional[int] = None + """*Optional*. Video height""" + video_duration: Optional[int] = None + """*Optional*. Video duration in seconds""" + description: Optional[str] = None + """*Optional*. Short description of the result""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the video. This field is **required** if InlineQueryResultVideo is used to send an HTML-page as a result (e.g., a YouTube video).""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.VIDEO] = InlineQueryResultType.VIDEO, + id: str, + video_url: str, + mime_type: str, + thumbnail_url: str, + title: str, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + video_width: Optional[int] = None, + video_height: Optional[int] = None, + video_duration: Optional[int] = None, + description: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + video_url=video_url, + mime_type=mime_type, + thumbnail_url=thumbnail_url, + title=title, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + video_width=video_width, + video_height=video_height, + video_duration=video_duration, + description=description, + reply_markup=reply_markup, + input_message_content=input_message_content, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_result_voice.py b/env/Lib/site-packages/aiogram/types/inline_query_result_voice.py new file mode 100644 index 0000000..a781fc6 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_result_voice.py @@ -0,0 +1,98 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InlineQueryResultType +from .inline_query_result import InlineQueryResult + +if TYPE_CHECKING: + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_contact_message_content import InputContactMessageContent + from .input_invoice_message_content import InputInvoiceMessageContent + from .input_location_message_content import InputLocationMessageContent + from .input_text_message_content import InputTextMessageContent + from .input_venue_message_content import InputVenueMessageContent + from .message_entity import MessageEntity + + +class InlineQueryResultVoice(InlineQueryResult): + """ + Represents a link to a voice recording in an .OGG container encoded with OPUS. By default, this voice recording will be sent by the user. Alternatively, you can use *input_message_content* to send a message with the specified content instead of the the voice message. + + Source: https://core.telegram.org/bots/api#inlinequeryresultvoice + """ + + type: Literal[InlineQueryResultType.VOICE] = InlineQueryResultType.VOICE + """Type of the result, must be *voice*""" + id: str + """Unique identifier for this result, 1-64 bytes""" + voice_url: str + """A valid URL for the voice recording""" + title: str + """Recording title""" + caption: Optional[str] = None + """*Optional*. Caption, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the voice message caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + voice_duration: Optional[int] = None + """*Optional*. Recording duration in seconds""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. `Inline keyboard `_ attached to the message""" + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None + """*Optional*. Content of the message to be sent instead of the voice recording""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InlineQueryResultType.VOICE] = InlineQueryResultType.VOICE, + id: str, + voice_url: str, + title: str, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + voice_duration: Optional[int] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + input_message_content: Optional[ + Union[ + InputTextMessageContent, + InputLocationMessageContent, + InputVenueMessageContent, + InputContactMessageContent, + InputInvoiceMessageContent, + ] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + id=id, + voice_url=voice_url, + title=title, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + voice_duration=voice_duration, + reply_markup=reply_markup, + input_message_content=input_message_content, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/inline_query_results_button.py b/env/Lib/site-packages/aiogram/types/inline_query_results_button.py new file mode 100644 index 0000000..6943fb8 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/inline_query_results_button.py @@ -0,0 +1,43 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .web_app_info import WebAppInfo + + +class InlineQueryResultsButton(TelegramObject): + """ + This object represents a button to be shown above inline query results. You **must** use exactly one of the optional fields. + + Source: https://core.telegram.org/bots/api#inlinequeryresultsbutton + """ + + text: str + """Label text on the button""" + web_app: Optional[WebAppInfo] = None + """*Optional*. Description of the `Web App `_ that will be launched when the user presses the button. The Web App will be able to switch back to the inline mode using the method `switchInlineQuery `_ inside the Web App.""" + start_parameter: Optional[str] = None + """*Optional*. `Deep-linking `_ parameter for the /start message sent to the bot when a user presses the button. 1-64 characters, only :code:`A-Z`, :code:`a-z`, :code:`0-9`, :code:`_` and :code:`-` are allowed.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + text: str, + web_app: Optional[WebAppInfo] = None, + start_parameter: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + text=text, web_app=web_app, start_parameter=start_parameter, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/input_contact_message_content.py b/env/Lib/site-packages/aiogram/types/input_contact_message_content.py new file mode 100644 index 0000000..8bcb581 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_contact_message_content.py @@ -0,0 +1,47 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .input_message_content import InputMessageContent + + +class InputContactMessageContent(InputMessageContent): + """ + Represents the `content `_ of a contact message to be sent as the result of an inline query. + + Source: https://core.telegram.org/bots/api#inputcontactmessagecontent + """ + + phone_number: str + """Contact's phone number""" + first_name: str + """Contact's first name""" + last_name: Optional[str] = None + """*Optional*. Contact's last name""" + vcard: Optional[str] = None + """*Optional*. Additional data about the contact in the form of a `vCard `_, 0-2048 bytes""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + phone_number: str, + first_name: str, + last_name: Optional[str] = None, + vcard: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + phone_number=phone_number, + first_name=first_name, + last_name=last_name, + vcard=vcard, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/input_file.py b/env/Lib/site-packages/aiogram/types/input_file.py new file mode 100644 index 0000000..5b73059 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_file.py @@ -0,0 +1,149 @@ +from __future__ import annotations + +import io +import os +from abc import ABC, abstractmethod +from pathlib import Path +from typing import TYPE_CHECKING, Any, AsyncGenerator, Dict, Optional, Union + +import aiofiles + +if TYPE_CHECKING: + from aiogram.client.bot import Bot + +DEFAULT_CHUNK_SIZE = 64 * 1024 # 64 kb + + +class InputFile(ABC): + """ + This object represents the contents of a file to be uploaded. Must be posted using multipart/form-data in the usual way that files are uploaded via the browser. + + Source: https://core.telegram.org/bots/api#inputfile + """ + + def __init__(self, filename: Optional[str] = None, chunk_size: int = DEFAULT_CHUNK_SIZE): + """ + Base class for input files. Should not be used directly. + Look at :class:`BufferedInputFile`, :class:`FSInputFile` :class:`URLInputFile` + + :param filename: name of the given file + :param chunk_size: reader chunks size + """ + self.filename = filename + self.chunk_size = chunk_size + + @abstractmethod + async def read(self, bot: "Bot") -> AsyncGenerator[bytes, None]: # pragma: no cover + yield b"" + + +class BufferedInputFile(InputFile): + def __init__(self, file: bytes, filename: str, chunk_size: int = DEFAULT_CHUNK_SIZE): + """ + Represents object for uploading files from filesystem + + :param file: Bytes + :param filename: Filename to be propagated to telegram. + :param chunk_size: Uploading chunk size + """ + super().__init__(filename=filename, chunk_size=chunk_size) + + self.data = file + + @classmethod + def from_file( + cls, + path: Union[str, Path], + filename: Optional[str] = None, + chunk_size: int = DEFAULT_CHUNK_SIZE, + ) -> BufferedInputFile: + """ + Create buffer from file + + :param path: Path to file + :param filename: Filename to be propagated to telegram. + By default, will be parsed from path + :param chunk_size: Uploading chunk size + :return: instance of :obj:`BufferedInputFile` + """ + if filename is None: + filename = os.path.basename(path) + with open(path, "rb") as f: + data = f.read() + return cls(data, filename=filename, chunk_size=chunk_size) + + async def read(self, bot: "Bot") -> AsyncGenerator[bytes, None]: + buffer = io.BytesIO(self.data) + while chunk := buffer.read(self.chunk_size): + yield chunk + + +class FSInputFile(InputFile): + def __init__( + self, + path: Union[str, Path], + filename: Optional[str] = None, + chunk_size: int = DEFAULT_CHUNK_SIZE, + ): + """ + Represents object for uploading files from filesystem + + :param path: Path to file + :param filename: Filename to be propagated to telegram. + By default, will be parsed from path + :param chunk_size: Uploading chunk size + """ + if filename is None: + filename = os.path.basename(path) + super().__init__(filename=filename, chunk_size=chunk_size) + + self.path = path + + async def read(self, bot: "Bot") -> AsyncGenerator[bytes, None]: + async with aiofiles.open(self.path, "rb") as f: + while chunk := await f.read(self.chunk_size): + yield chunk + + +class URLInputFile(InputFile): + def __init__( + self, + url: str, + headers: Optional[Dict[str, Any]] = None, + filename: Optional[str] = None, + chunk_size: int = DEFAULT_CHUNK_SIZE, + timeout: int = 30, + bot: Optional["Bot"] = None, + ): + """ + Represents object for streaming files from internet + + :param url: URL in internet + :param headers: HTTP Headers + :param filename: Filename to be propagated to telegram. + :param chunk_size: Uploading chunk size + :param timeout: Timeout for downloading + :param bot: Bot instance to use HTTP session from. + If not specified, will be used current bot + """ + super().__init__(filename=filename, chunk_size=chunk_size) + if headers is None: + headers = {} + + self.url = url + self.headers = headers + self.timeout = timeout + self.bot = bot + + async def read(self, bot: "Bot") -> AsyncGenerator[bytes, None]: + bot = self.bot or bot + stream = bot.session.stream_content( + url=self.url, + headers=self.headers, + timeout=self.timeout, + chunk_size=self.chunk_size, + raise_for_status=True, + ) + + async for chunk in stream: + yield chunk diff --git a/env/Lib/site-packages/aiogram/types/input_invoice_message_content.py b/env/Lib/site-packages/aiogram/types/input_invoice_message_content.py new file mode 100644 index 0000000..0dbb6d2 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_invoice_message_content.py @@ -0,0 +1,114 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from .input_message_content import InputMessageContent + +if TYPE_CHECKING: + from .labeled_price import LabeledPrice + + +class InputInvoiceMessageContent(InputMessageContent): + """ + Represents the `content `_ of an invoice message to be sent as the result of an inline query. + + Source: https://core.telegram.org/bots/api#inputinvoicemessagecontent + """ + + title: str + """Product name, 1-32 characters""" + description: str + """Product description, 1-255 characters""" + payload: str + """Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use for your internal processes.""" + currency: str + """Three-letter ISO 4217 currency code, see `more on currencies `_. Pass 'XTR' for payments in `Telegram Stars `_.""" + prices: List[LabeledPrice] + """Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.). Must contain exactly one item for payments in `Telegram Stars `_.""" + provider_token: Optional[str] = None + """*Optional*. Payment provider token, obtained via `@BotFather `_. Pass an empty string for payments in `Telegram Stars `_.""" + max_tip_amount: Optional[int] = None + """*Optional*. The maximum accepted amount for tips in the *smallest units* of the currency (integer, **not** float/double). For example, for a maximum tip of :code:`US$ 1.45` pass :code:`max_tip_amount = 145`. See the *exp* parameter in `currencies.json `_, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0. Not supported for payments in `Telegram Stars `_.""" + suggested_tip_amounts: Optional[List[int]] = None + """*Optional*. A JSON-serialized array of suggested amounts of tip in the *smallest units* of the currency (integer, **not** float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed *max_tip_amount*.""" + provider_data: Optional[str] = None + """*Optional*. A JSON-serialized object for data about the invoice, which will be shared with the payment provider. A detailed description of the required fields should be provided by the payment provider.""" + photo_url: Optional[str] = None + """*Optional*. URL of the product photo for the invoice. Can be a photo of the goods or a marketing image for a service.""" + photo_size: Optional[int] = None + """*Optional*. Photo size in bytes""" + photo_width: Optional[int] = None + """*Optional*. Photo width""" + photo_height: Optional[int] = None + """*Optional*. Photo height""" + need_name: Optional[bool] = None + """*Optional*. Pass :code:`True` if you require the user's full name to complete the order. Ignored for payments in `Telegram Stars `_.""" + need_phone_number: Optional[bool] = None + """*Optional*. Pass :code:`True` if you require the user's phone number to complete the order. Ignored for payments in `Telegram Stars `_.""" + need_email: Optional[bool] = None + """*Optional*. Pass :code:`True` if you require the user's email address to complete the order. Ignored for payments in `Telegram Stars `_.""" + need_shipping_address: Optional[bool] = None + """*Optional*. Pass :code:`True` if you require the user's shipping address to complete the order. Ignored for payments in `Telegram Stars `_.""" + send_phone_number_to_provider: Optional[bool] = None + """*Optional*. Pass :code:`True` if the user's phone number should be sent to the provider. Ignored for payments in `Telegram Stars `_.""" + send_email_to_provider: Optional[bool] = None + """*Optional*. Pass :code:`True` if the user's email address should be sent to the provider. Ignored for payments in `Telegram Stars `_.""" + is_flexible: Optional[bool] = None + """*Optional*. Pass :code:`True` if the final price depends on the shipping method. Ignored for payments in `Telegram Stars `_.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + title: str, + description: str, + payload: str, + currency: str, + prices: List[LabeledPrice], + provider_token: Optional[str] = None, + max_tip_amount: Optional[int] = None, + suggested_tip_amounts: Optional[List[int]] = None, + provider_data: Optional[str] = None, + photo_url: Optional[str] = None, + photo_size: Optional[int] = None, + photo_width: Optional[int] = None, + photo_height: Optional[int] = None, + need_name: Optional[bool] = None, + need_phone_number: Optional[bool] = None, + need_email: Optional[bool] = None, + need_shipping_address: Optional[bool] = None, + send_phone_number_to_provider: Optional[bool] = None, + send_email_to_provider: Optional[bool] = None, + is_flexible: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + title=title, + description=description, + payload=payload, + currency=currency, + prices=prices, + provider_token=provider_token, + max_tip_amount=max_tip_amount, + suggested_tip_amounts=suggested_tip_amounts, + provider_data=provider_data, + photo_url=photo_url, + photo_size=photo_size, + photo_width=photo_width, + photo_height=photo_height, + need_name=need_name, + need_phone_number=need_phone_number, + need_email=need_email, + need_shipping_address=need_shipping_address, + send_phone_number_to_provider=send_phone_number_to_provider, + send_email_to_provider=send_email_to_provider, + is_flexible=is_flexible, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/input_location_message_content.py b/env/Lib/site-packages/aiogram/types/input_location_message_content.py new file mode 100644 index 0000000..83400c1 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_location_message_content.py @@ -0,0 +1,55 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .input_message_content import InputMessageContent + + +class InputLocationMessageContent(InputMessageContent): + """ + Represents the `content `_ of a location message to be sent as the result of an inline query. + + Source: https://core.telegram.org/bots/api#inputlocationmessagecontent + """ + + latitude: float + """Latitude of the location in degrees""" + longitude: float + """Longitude of the location in degrees""" + horizontal_accuracy: Optional[float] = None + """*Optional*. The radius of uncertainty for the location, measured in meters; 0-1500""" + live_period: Optional[int] = None + """*Optional*. Period in seconds during which the location can be updated, should be between 60 and 86400, or 0x7FFFFFFF for live locations that can be edited indefinitely.""" + heading: Optional[int] = None + """*Optional*. For live locations, a direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.""" + proximity_alert_radius: Optional[int] = None + """*Optional*. For live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + latitude: float, + longitude: float, + horizontal_accuracy: Optional[float] = None, + live_period: Optional[int] = None, + heading: Optional[int] = None, + proximity_alert_radius: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + latitude=latitude, + longitude=longitude, + horizontal_accuracy=horizontal_accuracy, + live_period=live_period, + heading=heading, + proximity_alert_radius=proximity_alert_radius, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/input_media.py b/env/Lib/site-packages/aiogram/types/input_media.py new file mode 100644 index 0000000..f7523c9 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_media.py @@ -0,0 +1,17 @@ +from __future__ import annotations + +from .base import MutableTelegramObject + + +class InputMedia(MutableTelegramObject): + """ + This object represents the content of a media message to be sent. It should be one of + + - :class:`aiogram.types.input_media_animation.InputMediaAnimation` + - :class:`aiogram.types.input_media_document.InputMediaDocument` + - :class:`aiogram.types.input_media_audio.InputMediaAudio` + - :class:`aiogram.types.input_media_photo.InputMediaPhoto` + - :class:`aiogram.types.input_media_video.InputMediaVideo` + + Source: https://core.telegram.org/bots/api#inputmedia + """ diff --git a/env/Lib/site-packages/aiogram/types/input_media_animation.py b/env/Lib/site-packages/aiogram/types/input_media_animation.py new file mode 100644 index 0000000..a0251f2 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_media_animation.py @@ -0,0 +1,83 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InputMediaType +from .input_media import InputMedia + +if TYPE_CHECKING: + from .input_file import InputFile + from .message_entity import MessageEntity + + +class InputMediaAnimation(InputMedia): + """ + Represents an animation file (GIF or H.264/MPEG-4 AVC video without sound) to be sent. + + Source: https://core.telegram.org/bots/api#inputmediaanimation + """ + + type: Literal[InputMediaType.ANIMATION] = InputMediaType.ANIMATION + """Type of the result, must be *animation*""" + media: Union[str, InputFile] + """File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass 'attach://' to upload a new one using multipart/form-data under name. :ref:`More information on Sending Files » `""" + thumbnail: Optional[InputFile] = None + """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" + caption: Optional[str] = None + """*Optional*. Caption of the animation to be sent, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the animation caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[Union[bool, Default]] = Default("show_caption_above_media") + """*Optional*. Pass :code:`True`, if the caption must be shown above the message media""" + width: Optional[int] = None + """*Optional*. Animation width""" + height: Optional[int] = None + """*Optional*. Animation height""" + duration: Optional[int] = None + """*Optional*. Animation duration in seconds""" + has_spoiler: Optional[bool] = None + """*Optional*. Pass :code:`True` if the animation needs to be covered with a spoiler animation""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InputMediaType.ANIMATION] = InputMediaType.ANIMATION, + media: Union[str, InputFile], + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + width: Optional[int] = None, + height: Optional[int] = None, + duration: Optional[int] = None, + has_spoiler: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + media=media, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + width=width, + height=height, + duration=duration, + has_spoiler=has_spoiler, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/input_media_audio.py b/env/Lib/site-packages/aiogram/types/input_media_audio.py new file mode 100644 index 0000000..c372201 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_media_audio.py @@ -0,0 +1,73 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InputMediaType +from .input_media import InputMedia + +if TYPE_CHECKING: + from .input_file import InputFile + from .message_entity import MessageEntity + + +class InputMediaAudio(InputMedia): + """ + Represents an audio file to be treated as music to be sent. + + Source: https://core.telegram.org/bots/api#inputmediaaudio + """ + + type: Literal[InputMediaType.AUDIO] = InputMediaType.AUDIO + """Type of the result, must be *audio*""" + media: Union[str, InputFile] + """File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass 'attach://' to upload a new one using multipart/form-data under name. :ref:`More information on Sending Files » `""" + thumbnail: Optional[InputFile] = None + """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" + caption: Optional[str] = None + """*Optional*. Caption of the audio to be sent, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the audio caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + duration: Optional[int] = None + """*Optional*. Duration of the audio in seconds""" + performer: Optional[str] = None + """*Optional*. Performer of the audio""" + title: Optional[str] = None + """*Optional*. Title of the audio""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InputMediaType.AUDIO] = InputMediaType.AUDIO, + media: Union[str, InputFile], + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + performer: Optional[str] = None, + title: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + media=media, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + duration=duration, + performer=performer, + title=title, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/input_media_document.py b/env/Lib/site-packages/aiogram/types/input_media_document.py new file mode 100644 index 0000000..7c24b92 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_media_document.py @@ -0,0 +1,65 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InputMediaType +from .input_media import InputMedia + +if TYPE_CHECKING: + from .input_file import InputFile + from .message_entity import MessageEntity + + +class InputMediaDocument(InputMedia): + """ + Represents a general file to be sent. + + Source: https://core.telegram.org/bots/api#inputmediadocument + """ + + type: Literal[InputMediaType.DOCUMENT] = InputMediaType.DOCUMENT + """Type of the result, must be *document*""" + media: Union[str, InputFile] + """File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass 'attach://' to upload a new one using multipart/form-data under name. :ref:`More information on Sending Files » `""" + thumbnail: Optional[InputFile] = None + """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" + caption: Optional[str] = None + """*Optional*. Caption of the document to be sent, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the document caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + disable_content_type_detection: Optional[bool] = None + """*Optional*. Disables automatic server-side content type detection for files uploaded using multipart/form-data. Always :code:`True`, if the document is sent as part of an album.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InputMediaType.DOCUMENT] = InputMediaType.DOCUMENT, + media: Union[str, InputFile], + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + disable_content_type_detection: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + media=media, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + disable_content_type_detection=disable_content_type_detection, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/input_media_photo.py b/env/Lib/site-packages/aiogram/types/input_media_photo.py new file mode 100644 index 0000000..19daa26 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_media_photo.py @@ -0,0 +1,67 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InputMediaType +from .input_media import InputMedia + +if TYPE_CHECKING: + from .input_file import InputFile + from .message_entity import MessageEntity + + +class InputMediaPhoto(InputMedia): + """ + Represents a photo to be sent. + + Source: https://core.telegram.org/bots/api#inputmediaphoto + """ + + type: Literal[InputMediaType.PHOTO] = InputMediaType.PHOTO + """Type of the result, must be *photo*""" + media: Union[str, InputFile] + """File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass 'attach://' to upload a new one using multipart/form-data under name. :ref:`More information on Sending Files » `""" + caption: Optional[str] = None + """*Optional*. Caption of the photo to be sent, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the photo caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[Union[bool, Default]] = Default("show_caption_above_media") + """*Optional*. Pass :code:`True`, if the caption must be shown above the message media""" + has_spoiler: Optional[bool] = None + """*Optional*. Pass :code:`True` if the photo needs to be covered with a spoiler animation""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InputMediaType.PHOTO] = InputMediaType.PHOTO, + media: Union[str, InputFile], + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + media=media, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/input_media_video.py b/env/Lib/site-packages/aiogram/types/input_media_video.py new file mode 100644 index 0000000..6f1e326 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_media_video.py @@ -0,0 +1,87 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..client.default import Default +from ..enums import InputMediaType +from .input_media import InputMedia + +if TYPE_CHECKING: + from .input_file import InputFile + from .message_entity import MessageEntity + + +class InputMediaVideo(InputMedia): + """ + Represents a video to be sent. + + Source: https://core.telegram.org/bots/api#inputmediavideo + """ + + type: Literal[InputMediaType.VIDEO] = InputMediaType.VIDEO + """Type of the result, must be *video*""" + media: Union[str, InputFile] + """File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass 'attach://' to upload a new one using multipart/form-data under name. :ref:`More information on Sending Files » `""" + thumbnail: Optional[InputFile] = None + """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" + caption: Optional[str] = None + """*Optional*. Caption of the video to be sent, 0-1024 characters after entities parsing""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the video caption. See `formatting options `_ for more details.""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in the caption, which can be specified instead of *parse_mode*""" + show_caption_above_media: Optional[Union[bool, Default]] = Default("show_caption_above_media") + """*Optional*. Pass :code:`True`, if the caption must be shown above the message media""" + width: Optional[int] = None + """*Optional*. Video width""" + height: Optional[int] = None + """*Optional*. Video height""" + duration: Optional[int] = None + """*Optional*. Video duration in seconds""" + supports_streaming: Optional[bool] = None + """*Optional*. Pass :code:`True` if the uploaded video is suitable for streaming""" + has_spoiler: Optional[bool] = None + """*Optional*. Pass :code:`True` if the video needs to be covered with a spoiler animation""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InputMediaType.VIDEO] = InputMediaType.VIDEO, + media: Union[str, InputFile], + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + width: Optional[int] = None, + height: Optional[int] = None, + duration: Optional[int] = None, + supports_streaming: Optional[bool] = None, + has_spoiler: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + media=media, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + width=width, + height=height, + duration=duration, + supports_streaming=supports_streaming, + has_spoiler=has_spoiler, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/input_message_content.py b/env/Lib/site-packages/aiogram/types/input_message_content.py new file mode 100644 index 0000000..858524a --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_message_content.py @@ -0,0 +1,17 @@ +from __future__ import annotations + +from .base import MutableTelegramObject + + +class InputMessageContent(MutableTelegramObject): + """ + This object represents the content of a message to be sent as a result of an inline query. Telegram clients currently support the following 5 types: + + - :class:`aiogram.types.input_text_message_content.InputTextMessageContent` + - :class:`aiogram.types.input_location_message_content.InputLocationMessageContent` + - :class:`aiogram.types.input_venue_message_content.InputVenueMessageContent` + - :class:`aiogram.types.input_contact_message_content.InputContactMessageContent` + - :class:`aiogram.types.input_invoice_message_content.InputInvoiceMessageContent` + + Source: https://core.telegram.org/bots/api#inputmessagecontent + """ diff --git a/env/Lib/site-packages/aiogram/types/input_paid_media.py b/env/Lib/site-packages/aiogram/types/input_paid_media.py new file mode 100644 index 0000000..9d3193d --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_paid_media.py @@ -0,0 +1,12 @@ +from .base import TelegramObject + + +class InputPaidMedia(TelegramObject): + """ + This object describes the paid media to be sent. Currently, it can be one of + + - :class:`aiogram.types.input_paid_media_photo.InputPaidMediaPhoto` + - :class:`aiogram.types.input_paid_media_video.InputPaidMediaVideo` + + Source: https://core.telegram.org/bots/api#inputpaidmedia + """ diff --git a/env/Lib/site-packages/aiogram/types/input_paid_media_photo.py b/env/Lib/site-packages/aiogram/types/input_paid_media_photo.py new file mode 100644 index 0000000..1756db5 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_paid_media_photo.py @@ -0,0 +1,37 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Union + +from ..enums import InputPaidMediaType +from .input_file import InputFile +from .input_paid_media import InputPaidMedia + + +class InputPaidMediaPhoto(InputPaidMedia): + """ + The paid media to send is a photo. + + Source: https://core.telegram.org/bots/api#inputpaidmediaphoto + """ + + type: Literal[InputPaidMediaType.PHOTO] = InputPaidMediaType.PHOTO + """Type of the media, must be *photo*""" + media: Union[str, InputFile] + """File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass 'attach://' to upload a new one using multipart/form-data under name. :ref:`More information on Sending Files » `""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InputPaidMediaType.PHOTO] = InputPaidMediaType.PHOTO, + media: Union[str, InputFile], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, media=media, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/input_paid_media_video.py b/env/Lib/site-packages/aiogram/types/input_paid_media_video.py new file mode 100644 index 0000000..4511afb --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_paid_media_video.py @@ -0,0 +1,61 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional, Union + +from ..enums import InputPaidMediaType +from .input_file import InputFile +from .input_paid_media import InputPaidMedia + + +class InputPaidMediaVideo(InputPaidMedia): + """ + The paid media to send is a video. + + Source: https://core.telegram.org/bots/api#inputpaidmediavideo + """ + + type: Literal[InputPaidMediaType.VIDEO] = InputPaidMediaType.VIDEO + """Type of the media, must be *video*""" + media: Union[str, InputFile] + """File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass 'attach://' to upload a new one using multipart/form-data under name. :ref:`More information on Sending Files » `""" + thumbnail: Optional[Union[InputFile, str]] = None + """*Optional*. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » `""" + width: Optional[int] = None + """*Optional*. Video width""" + height: Optional[int] = None + """*Optional*. Video height""" + duration: Optional[int] = None + """*Optional*. Video duration in seconds""" + supports_streaming: Optional[bool] = None + """*Optional*. Pass :code:`True` if the uploaded video is suitable for streaming""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[InputPaidMediaType.VIDEO] = InputPaidMediaType.VIDEO, + media: Union[str, InputFile], + thumbnail: Optional[Union[InputFile, str]] = None, + width: Optional[int] = None, + height: Optional[int] = None, + duration: Optional[int] = None, + supports_streaming: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + media=media, + thumbnail=thumbnail, + width=width, + height=height, + duration=duration, + supports_streaming=supports_streaming, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/input_poll_option.py b/env/Lib/site-packages/aiogram/types/input_poll_option.py new file mode 100644 index 0000000..7bca9f6 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_poll_option.py @@ -0,0 +1,47 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from ..client.default import Default +from .base import TelegramObject + +if TYPE_CHECKING: + from .message_entity import MessageEntity + + +class InputPollOption(TelegramObject): + """ + This object contains information about one answer option in a poll to be sent. + + Source: https://core.telegram.org/bots/api#inputpolloption + """ + + text: str + """Option text, 1-100 characters""" + text_parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the text. See `formatting options `_ for more details. Currently, only custom emoji entities are allowed""" + text_entities: Optional[List[MessageEntity]] = None + """*Optional*. A JSON-serialized list of special entities that appear in the poll option text. It can be specified instead of *text_parse_mode*""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + text: str, + text_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + text_entities: Optional[List[MessageEntity]] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + text=text, + text_parse_mode=text_parse_mode, + text_entities=text_entities, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/input_sticker.py b/env/Lib/site-packages/aiogram/types/input_sticker.py new file mode 100644 index 0000000..85f6686 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_sticker.py @@ -0,0 +1,55 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from .base import TelegramObject + +if TYPE_CHECKING: + from .input_file import InputFile + from .mask_position import MaskPosition + + +class InputSticker(TelegramObject): + """ + This object describes a sticker to be added to a sticker set. + + Source: https://core.telegram.org/bots/api#inputsticker + """ + + sticker: Union[InputFile, str] + """The added sticker. 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, upload a new one using multipart/form-data, or pass 'attach://' to upload a new one using multipart/form-data under name. Animated and video stickers can't be uploaded via HTTP URL. :ref:`More information on Sending Files » `""" + format: str + """Format of the added sticker, must be one of 'static' for a **.WEBP** or **.PNG** image, 'animated' for a **.TGS** animation, 'video' for a **WEBM** video""" + emoji_list: List[str] + """List of 1-20 emoji associated with the sticker""" + mask_position: Optional[MaskPosition] = None + """*Optional*. Position where the mask should be placed on faces. For 'mask' stickers only.""" + keywords: Optional[List[str]] = None + """*Optional*. List of 0-20 search keywords for the sticker with total length of up to 64 characters. For 'regular' and 'custom_emoji' stickers only.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + sticker: Union[InputFile, str], + format: str, + emoji_list: List[str], + mask_position: Optional[MaskPosition] = None, + keywords: Optional[List[str]] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + sticker=sticker, + format=format, + emoji_list=emoji_list, + mask_position=mask_position, + keywords=keywords, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/input_text_message_content.py b/env/Lib/site-packages/aiogram/types/input_text_message_content.py new file mode 100644 index 0000000..5048757 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_text_message_content.py @@ -0,0 +1,65 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from pydantic import Field + +from ..client.default import Default +from .input_message_content import InputMessageContent + +if TYPE_CHECKING: + from .link_preview_options import LinkPreviewOptions + from .message_entity import MessageEntity + + +class InputTextMessageContent(InputMessageContent): + """ + Represents the `content `_ of a text message to be sent as the result of an inline query. + + Source: https://core.telegram.org/bots/api#inputtextmessagecontent + """ + + message_text: str + """Text of the message to be sent, 1-4096 characters""" + parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the message text. See `formatting options `_ for more details.""" + entities: Optional[List[MessageEntity]] = None + """*Optional*. List of special entities that appear in message text, which can be specified instead of *parse_mode*""" + link_preview_options: Optional[LinkPreviewOptions] = None + """*Optional*. Link preview generation options for the message""" + disable_web_page_preview: Optional[Union[bool, Default]] = Field( + Default("disable_web_page_preview"), json_schema_extra={"deprecated": True} + ) + """*Optional*. Disables link previews for links in the sent message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + message_text: str, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + entities: Optional[List[MessageEntity]] = None, + link_preview_options: Optional[LinkPreviewOptions] = None, + disable_web_page_preview: Optional[Union[bool, Default]] = Default( + "disable_web_page_preview" + ), + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + message_text=message_text, + parse_mode=parse_mode, + entities=entities, + link_preview_options=link_preview_options, + disable_web_page_preview=disable_web_page_preview, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/input_venue_message_content.py b/env/Lib/site-packages/aiogram/types/input_venue_message_content.py new file mode 100644 index 0000000..48dd5c4 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/input_venue_message_content.py @@ -0,0 +1,63 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .input_message_content import InputMessageContent + + +class InputVenueMessageContent(InputMessageContent): + """ + Represents the `content `_ of a venue message to be sent as the result of an inline query. + + Source: https://core.telegram.org/bots/api#inputvenuemessagecontent + """ + + latitude: float + """Latitude of the venue in degrees""" + longitude: float + """Longitude of the venue in degrees""" + title: str + """Name of the venue""" + address: str + """Address of the venue""" + foursquare_id: Optional[str] = None + """*Optional*. Foursquare identifier of the venue, if known""" + foursquare_type: Optional[str] = None + """*Optional*. Foursquare type of the venue, if known. (For example, 'arts_entertainment/default', 'arts_entertainment/aquarium' or 'food/icecream'.)""" + google_place_id: Optional[str] = None + """*Optional*. Google Places identifier of the venue""" + google_place_type: Optional[str] = None + """*Optional*. Google Places type of the venue. (See `supported types `_.)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + latitude: float, + longitude: float, + title: str, + address: str, + foursquare_id: Optional[str] = None, + foursquare_type: Optional[str] = None, + google_place_id: Optional[str] = None, + google_place_type: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + latitude=latitude, + longitude=longitude, + title=title, + address=address, + foursquare_id=foursquare_id, + foursquare_type=foursquare_type, + google_place_id=google_place_id, + google_place_type=google_place_type, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/invoice.py b/env/Lib/site-packages/aiogram/types/invoice.py new file mode 100644 index 0000000..7c70f0b --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/invoice.py @@ -0,0 +1,51 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + + +class Invoice(TelegramObject): + """ + This object contains basic information about an invoice. + + Source: https://core.telegram.org/bots/api#invoice + """ + + title: str + """Product name""" + description: str + """Product description""" + start_parameter: str + """Unique bot deep-linking parameter that can be used to generate this invoice""" + currency: str + """Three-letter ISO 4217 `currency `_ code, or 'XTR' for payments in `Telegram Stars `_""" + total_amount: int + """Total price in the *smallest units* of the currency (integer, **not** float/double). For example, for a price of :code:`US$ 1.45` pass :code:`amount = 145`. See the *exp* parameter in `currencies.json `_, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + title: str, + description: str, + start_parameter: str, + currency: str, + total_amount: int, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + title=title, + description=description, + start_parameter=start_parameter, + currency=currency, + total_amount=total_amount, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/keyboard_button.py b/env/Lib/site-packages/aiogram/types/keyboard_button.py new file mode 100644 index 0000000..0cf7d58 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/keyboard_button.py @@ -0,0 +1,78 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from pydantic import Field + +from .base import MutableTelegramObject + +if TYPE_CHECKING: + from .keyboard_button_poll_type import KeyboardButtonPollType + from .keyboard_button_request_chat import KeyboardButtonRequestChat + from .keyboard_button_request_user import KeyboardButtonRequestUser + from .keyboard_button_request_users import KeyboardButtonRequestUsers + from .web_app_info import WebAppInfo + + +class KeyboardButton(MutableTelegramObject): + """ + This object represents one button of the reply keyboard. At most one of the optional fields must be used to specify type of the button. For simple text buttons, *String* can be used instead of this object to specify the button text. + **Note:** *request_users* and *request_chat* options will only work in Telegram versions released after 3 February, 2023. Older clients will display *unsupported message*. + + Source: https://core.telegram.org/bots/api#keyboardbutton + """ + + text: str + """Text of the button. If none of the optional fields are used, it will be sent as a message when the button is pressed""" + request_users: Optional[KeyboardButtonRequestUsers] = None + """*Optional.* If specified, pressing the button will open a list of suitable users. Identifiers of selected users will be sent to the bot in a 'users_shared' service message. Available in private chats only.""" + request_chat: Optional[KeyboardButtonRequestChat] = None + """*Optional.* If specified, pressing the button will open a list of suitable chats. Tapping on a chat will send its identifier to the bot in a 'chat_shared' service message. Available in private chats only.""" + request_contact: Optional[bool] = None + """*Optional*. If :code:`True`, the user's phone number will be sent as a contact when the button is pressed. Available in private chats only.""" + request_location: Optional[bool] = None + """*Optional*. If :code:`True`, the user's current location will be sent when the button is pressed. Available in private chats only.""" + request_poll: Optional[KeyboardButtonPollType] = None + """*Optional*. If specified, the user will be asked to create a poll and send it to the bot when the button is pressed. Available in private chats only.""" + web_app: Optional[WebAppInfo] = None + """*Optional*. If specified, the described `Web App `_ will be launched when the button is pressed. The Web App will be able to send a 'web_app_data' service message. Available in private chats only.""" + request_user: Optional[KeyboardButtonRequestUser] = Field( + None, json_schema_extra={"deprecated": True} + ) + """*Optional.* If specified, pressing the button will open a list of suitable users. Tapping on any user will send their identifier to the bot in a 'user_shared' service message. Available in private chats only. + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + text: str, + request_users: Optional[KeyboardButtonRequestUsers] = None, + request_chat: Optional[KeyboardButtonRequestChat] = None, + request_contact: Optional[bool] = None, + request_location: Optional[bool] = None, + request_poll: Optional[KeyboardButtonPollType] = None, + web_app: Optional[WebAppInfo] = None, + request_user: Optional[KeyboardButtonRequestUser] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + text=text, + request_users=request_users, + request_chat=request_chat, + request_contact=request_contact, + request_location=request_location, + request_poll=request_poll, + web_app=web_app, + request_user=request_user, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/keyboard_button_poll_type.py b/env/Lib/site-packages/aiogram/types/keyboard_button_poll_type.py new file mode 100644 index 0000000..07eadb7 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/keyboard_button_poll_type.py @@ -0,0 +1,29 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import MutableTelegramObject + + +class KeyboardButtonPollType(MutableTelegramObject): + """ + This object represents type of a poll, which is allowed to be created and sent when the corresponding button is pressed. + + Source: https://core.telegram.org/bots/api#keyboardbuttonpolltype + """ + + type: Optional[str] = None + """*Optional*. If *quiz* is passed, the user will be allowed to create only polls in the quiz mode. If *regular* is passed, only regular polls will be allowed. Otherwise, the user will be allowed to create a poll of any type.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, type: Optional[str] = None, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/keyboard_button_request_chat.py b/env/Lib/site-packages/aiogram/types/keyboard_button_request_chat.py new file mode 100644 index 0000000..018edcf --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/keyboard_button_request_chat.py @@ -0,0 +1,78 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from aiogram.types import TelegramObject + +if TYPE_CHECKING: + from .chat_administrator_rights import ChatAdministratorRights + + +class KeyboardButtonRequestChat(TelegramObject): + """ + This object defines the criteria used to request a suitable chat. Information about the selected chat will be shared with the bot when the corresponding button is pressed. The bot will be granted requested rights in the chat if appropriate. `More about requesting chats » `_. + + Source: https://core.telegram.org/bots/api#keyboardbuttonrequestchat + """ + + request_id: int + """Signed 32-bit identifier of the request, which will be received back in the :class:`aiogram.types.chat_shared.ChatShared` object. Must be unique within the message""" + chat_is_channel: bool + """Pass :code:`True` to request a channel chat, pass :code:`False` to request a group or a supergroup chat.""" + chat_is_forum: Optional[bool] = None + """*Optional*. Pass :code:`True` to request a forum supergroup, pass :code:`False` to request a non-forum chat. If not specified, no additional restrictions are applied.""" + chat_has_username: Optional[bool] = None + """*Optional*. Pass :code:`True` to request a supergroup or a channel with a username, pass :code:`False` to request a chat without a username. If not specified, no additional restrictions are applied.""" + chat_is_created: Optional[bool] = None + """*Optional*. Pass :code:`True` to request a chat owned by the user. Otherwise, no additional restrictions are applied.""" + user_administrator_rights: Optional[ChatAdministratorRights] = None + """*Optional*. A JSON-serialized object listing the required administrator rights of the user in the chat. The rights must be a superset of *bot_administrator_rights*. If not specified, no additional restrictions are applied.""" + bot_administrator_rights: Optional[ChatAdministratorRights] = None + """*Optional*. A JSON-serialized object listing the required administrator rights of the bot in the chat. The rights must be a subset of *user_administrator_rights*. If not specified, no additional restrictions are applied.""" + bot_is_member: Optional[bool] = None + """*Optional*. Pass :code:`True` to request a chat with the bot as a member. Otherwise, no additional restrictions are applied.""" + request_title: Optional[bool] = None + """*Optional*. Pass :code:`True` to request the chat's title""" + request_username: Optional[bool] = None + """*Optional*. Pass :code:`True` to request the chat's username""" + request_photo: Optional[bool] = None + """*Optional*. Pass :code:`True` to request the chat's photo""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + request_id: int, + chat_is_channel: bool, + chat_is_forum: Optional[bool] = None, + chat_has_username: Optional[bool] = None, + chat_is_created: Optional[bool] = None, + user_administrator_rights: Optional[ChatAdministratorRights] = None, + bot_administrator_rights: Optional[ChatAdministratorRights] = None, + bot_is_member: Optional[bool] = None, + request_title: Optional[bool] = None, + request_username: Optional[bool] = None, + request_photo: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + request_id=request_id, + chat_is_channel=chat_is_channel, + chat_is_forum=chat_is_forum, + chat_has_username=chat_has_username, + chat_is_created=chat_is_created, + user_administrator_rights=user_administrator_rights, + bot_administrator_rights=bot_administrator_rights, + bot_is_member=bot_is_member, + request_title=request_title, + request_username=request_username, + request_photo=request_photo, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/keyboard_button_request_user.py b/env/Lib/site-packages/aiogram/types/keyboard_button_request_user.py new file mode 100644 index 0000000..ab44ab2 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/keyboard_button_request_user.py @@ -0,0 +1,44 @@ +from typing import TYPE_CHECKING, Any, Optional + +from aiogram.types import TelegramObject + + +class KeyboardButtonRequestUser(TelegramObject): + """ + This object defines the criteria used to request a suitable user. The identifier of the selected user will be shared with the bot when the corresponding button is pressed. `More about requesting users » `_ + + .. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023 + + Source: https://core.telegram.org/bots/api#keyboardbuttonrequestuser + """ + + request_id: int + """Signed 32-bit identifier of the request, which will be received back in the :class:`aiogram.types.user_shared.UserShared` object. Must be unique within the message""" + user_is_bot: Optional[bool] = None + """*Optional*. Pass :code:`True` to request a bot, pass :code:`False` to request a regular user. If not specified, no additional restrictions are applied.""" + user_is_premium: Optional[bool] = None + """*Optional*. Pass :code:`True` to request a premium user, pass :code:`False` to request a non-premium user. If not specified, no additional restrictions are applied.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + request_id: int, + user_is_bot: Optional[bool] = None, + user_is_premium: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + request_id=request_id, + user_is_bot=user_is_bot, + user_is_premium=user_is_premium, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/keyboard_button_request_users.py b/env/Lib/site-packages/aiogram/types/keyboard_button_request_users.py new file mode 100644 index 0000000..631f04b --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/keyboard_button_request_users.py @@ -0,0 +1,57 @@ +from typing import TYPE_CHECKING, Any, Optional + +from aiogram.types import TelegramObject + + +class KeyboardButtonRequestUsers(TelegramObject): + """ + This object defines the criteria used to request suitable users. Information about the selected users will be shared with the bot when the corresponding button is pressed. `More about requesting users » `_ + + Source: https://core.telegram.org/bots/api#keyboardbuttonrequestusers + """ + + request_id: int + """Signed 32-bit identifier of the request that will be received back in the :class:`aiogram.types.users_shared.UsersShared` object. Must be unique within the message""" + user_is_bot: Optional[bool] = None + """*Optional*. Pass :code:`True` to request bots, pass :code:`False` to request regular users. If not specified, no additional restrictions are applied.""" + user_is_premium: Optional[bool] = None + """*Optional*. Pass :code:`True` to request premium users, pass :code:`False` to request non-premium users. If not specified, no additional restrictions are applied.""" + max_quantity: Optional[int] = None + """*Optional*. The maximum number of users to be selected; 1-10. Defaults to 1.""" + request_name: Optional[bool] = None + """*Optional*. Pass :code:`True` to request the users' first and last names""" + request_username: Optional[bool] = None + """*Optional*. Pass :code:`True` to request the users' usernames""" + request_photo: Optional[bool] = None + """*Optional*. Pass :code:`True` to request the users' photos""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + request_id: int, + user_is_bot: Optional[bool] = None, + user_is_premium: Optional[bool] = None, + max_quantity: Optional[int] = None, + request_name: Optional[bool] = None, + request_username: Optional[bool] = None, + request_photo: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + request_id=request_id, + user_is_bot=user_is_bot, + user_is_premium=user_is_premium, + max_quantity=max_quantity, + request_name=request_name, + request_username=request_username, + request_photo=request_photo, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/labeled_price.py b/env/Lib/site-packages/aiogram/types/labeled_price.py new file mode 100644 index 0000000..42d97af --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/labeled_price.py @@ -0,0 +1,31 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import MutableTelegramObject + + +class LabeledPrice(MutableTelegramObject): + """ + This object represents a portion of the price for goods or services. + + Source: https://core.telegram.org/bots/api#labeledprice + """ + + label: str + """Portion label""" + amount: int + """Price of the product in the *smallest units* of the `currency `_ (integer, **not** float/double). For example, for a price of :code:`US$ 1.45` pass :code:`amount = 145`. See the *exp* parameter in `currencies.json `_, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, label: str, amount: int, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(label=label, amount=amount, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/link_preview_options.py b/env/Lib/site-packages/aiogram/types/link_preview_options.py new file mode 100644 index 0000000..8964c5e --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/link_preview_options.py @@ -0,0 +1,56 @@ +from typing import TYPE_CHECKING, Any, Optional, Union + +from ..client.default import Default +from .base import TelegramObject + + +class LinkPreviewOptions(TelegramObject): + """ + Describes the options used for link preview generation. + + Source: https://core.telegram.org/bots/api#linkpreviewoptions + """ + + is_disabled: Optional[Union[bool, Default]] = Default("link_preview_is_disabled") + """*Optional*. :code:`True`, if the link preview is disabled""" + url: Optional[str] = None + """*Optional*. URL to use for the link preview. If empty, then the first URL found in the message text will be used""" + prefer_small_media: Optional[Union[bool, Default]] = Default("link_preview_prefer_small_media") + """*Optional*. :code:`True`, if the media in the link preview is supposed to be shrunk; ignored if the URL isn't explicitly specified or media size change isn't supported for the preview""" + prefer_large_media: Optional[Union[bool, Default]] = Default("link_preview_prefer_large_media") + """*Optional*. :code:`True`, if the media in the link preview is supposed to be enlarged; ignored if the URL isn't explicitly specified or media size change isn't supported for the preview""" + show_above_text: Optional[Union[bool, Default]] = Default("link_preview_show_above_text") + """*Optional*. :code:`True`, if the link preview must be shown above the message text; otherwise, the link preview will be shown below the message text""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + is_disabled: Optional[Union[bool, Default]] = Default("link_preview_is_disabled"), + url: Optional[str] = None, + prefer_small_media: Optional[Union[bool, Default]] = Default( + "link_preview_prefer_small_media" + ), + prefer_large_media: Optional[Union[bool, Default]] = Default( + "link_preview_prefer_large_media" + ), + show_above_text: Optional[Union[bool, Default]] = Default( + "link_preview_show_above_text" + ), + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + is_disabled=is_disabled, + url=url, + prefer_small_media=prefer_small_media, + prefer_large_media=prefer_large_media, + show_above_text=show_above_text, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/location.py b/env/Lib/site-packages/aiogram/types/location.py new file mode 100644 index 0000000..32673da --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/location.py @@ -0,0 +1,55 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + + +class Location(TelegramObject): + """ + This object represents a point on the map. + + Source: https://core.telegram.org/bots/api#location + """ + + latitude: float + """Latitude as defined by the sender""" + longitude: float + """Longitude as defined by the sender""" + horizontal_accuracy: Optional[float] = None + """*Optional*. The radius of uncertainty for the location, measured in meters; 0-1500""" + live_period: Optional[int] = None + """*Optional*. Time relative to the message sending date, during which the location can be updated; in seconds. For active live locations only.""" + heading: Optional[int] = None + """*Optional*. The direction in which user is moving, in degrees; 1-360. For active live locations only.""" + proximity_alert_radius: Optional[int] = None + """*Optional*. The maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + latitude: float, + longitude: float, + horizontal_accuracy: Optional[float] = None, + live_period: Optional[int] = None, + heading: Optional[int] = None, + proximity_alert_radius: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + latitude=latitude, + longitude=longitude, + horizontal_accuracy=horizontal_accuracy, + live_period=live_period, + heading=heading, + proximity_alert_radius=proximity_alert_radius, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/login_url.py b/env/Lib/site-packages/aiogram/types/login_url.py new file mode 100644 index 0000000..6f6c94a --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/login_url.py @@ -0,0 +1,50 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + + +class LoginUrl(TelegramObject): + """ + This object represents a parameter of the inline keyboard button used to automatically authorize a user. Serves as a great replacement for the `Telegram Login Widget `_ when the user is coming from Telegram. All the user needs to do is tap/click a button and confirm that they want to log in: + Telegram apps support these buttons as of `version 5.7 `_. + + Sample bot: `@discussbot `_ + + Source: https://core.telegram.org/bots/api#loginurl + """ + + url: str + """An HTTPS URL to be opened with user authorization data added to the query string when the button is pressed. If the user refuses to provide authorization data, the original URL without information about the user will be opened. The data added is the same as described in `Receiving authorization data `_.""" + forward_text: Optional[str] = None + """*Optional*. New text of the button in forwarded messages.""" + bot_username: Optional[str] = None + """*Optional*. Username of a bot, which will be used for user authorization. See `Setting up a bot `_ for more details. If not specified, the current bot's username will be assumed. The *url*'s domain must be the same as the domain linked with the bot. See `Linking your domain to the bot `_ for more details.""" + request_write_access: Optional[bool] = None + """*Optional*. Pass :code:`True` to request the permission for your bot to send messages to the user.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + url: str, + forward_text: Optional[str] = None, + bot_username: Optional[str] = None, + request_write_access: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + url=url, + forward_text=forward_text, + bot_username=bot_username, + request_write_access=request_write_access, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/mask_position.py b/env/Lib/site-packages/aiogram/types/mask_position.py new file mode 100644 index 0000000..d02852a --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/mask_position.py @@ -0,0 +1,43 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + + +class MaskPosition(TelegramObject): + """ + This object describes the position on faces where a mask should be placed by default. + + Source: https://core.telegram.org/bots/api#maskposition + """ + + point: str + """The part of the face relative to which the mask should be placed. One of 'forehead', 'eyes', 'mouth', or 'chin'.""" + x_shift: float + """Shift by X-axis measured in widths of the mask scaled to the face size, from left to right. For example, choosing -1.0 will place mask just to the left of the default mask position.""" + y_shift: float + """Shift by Y-axis measured in heights of the mask scaled to the face size, from top to bottom. For example, 1.0 will place the mask just below the default mask position.""" + scale: float + """Mask scaling coefficient. For example, 2.0 means double size.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + point: str, + x_shift: float, + y_shift: float, + scale: float, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + point=point, x_shift=x_shift, y_shift=y_shift, scale=scale, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/maybe_inaccessible_message.py b/env/Lib/site-packages/aiogram/types/maybe_inaccessible_message.py new file mode 100644 index 0000000..fe95ced --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/maybe_inaccessible_message.py @@ -0,0 +1,12 @@ +from aiogram.types import TelegramObject + + +class MaybeInaccessibleMessage(TelegramObject): + """ + This object describes a message that can be inaccessible to the bot. It can be one of + + - :class:`aiogram.types.message.Message` + - :class:`aiogram.types.inaccessible_message.InaccessibleMessage` + + Source: https://core.telegram.org/bots/api#maybeinaccessiblemessage + """ diff --git a/env/Lib/site-packages/aiogram/types/menu_button.py b/env/Lib/site-packages/aiogram/types/menu_button.py new file mode 100644 index 0000000..4c4fbf3 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/menu_button.py @@ -0,0 +1,47 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import MutableTelegramObject + +if TYPE_CHECKING: + from .web_app_info import WebAppInfo + + +class MenuButton(MutableTelegramObject): + """ + This object describes the bot's menu button in a private chat. It should be one of + + - :class:`aiogram.types.menu_button_commands.MenuButtonCommands` + - :class:`aiogram.types.menu_button_web_app.MenuButtonWebApp` + - :class:`aiogram.types.menu_button_default.MenuButtonDefault` + + If a menu button other than :class:`aiogram.types.menu_button_default.MenuButtonDefault` is set for a private chat, then it is applied in the chat. Otherwise the default menu button is applied. By default, the menu button opens the list of bot commands. + + Source: https://core.telegram.org/bots/api#menubutton + """ + + type: str + """Type of the button""" + text: Optional[str] = None + """*Optional*. Text on the button""" + web_app: Optional[WebAppInfo] = None + """*Optional*. Description of the Web App that will be launched when the user presses the button. The Web App will be able to send an arbitrary message on behalf of the user using the method :class:`aiogram.methods.answer_web_app_query.AnswerWebAppQuery`. Alternatively, a :code:`t.me` link to a Web App of the bot can be specified in the object instead of the Web App's URL, in which case the Web App will be opened as if the user pressed the link.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: str, + text: Optional[str] = None, + web_app: Optional[WebAppInfo] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, text=text, web_app=web_app, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/menu_button_commands.py b/env/Lib/site-packages/aiogram/types/menu_button_commands.py new file mode 100644 index 0000000..54ed20b --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/menu_button_commands.py @@ -0,0 +1,33 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import MenuButtonType +from .menu_button import MenuButton + + +class MenuButtonCommands(MenuButton): + """ + Represents a menu button, which opens the bot's list of commands. + + Source: https://core.telegram.org/bots/api#menubuttoncommands + """ + + type: Literal[MenuButtonType.COMMANDS] = MenuButtonType.COMMANDS + """Type of the button, must be *commands*""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[MenuButtonType.COMMANDS] = MenuButtonType.COMMANDS, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/menu_button_default.py b/env/Lib/site-packages/aiogram/types/menu_button_default.py new file mode 100644 index 0000000..12ce30e --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/menu_button_default.py @@ -0,0 +1,33 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import MenuButtonType +from .menu_button import MenuButton + + +class MenuButtonDefault(MenuButton): + """ + Describes that no specific value for the menu button was set. + + Source: https://core.telegram.org/bots/api#menubuttondefault + """ + + type: Literal[MenuButtonType.DEFAULT] = MenuButtonType.DEFAULT + """Type of the button, must be *default*""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[MenuButtonType.DEFAULT] = MenuButtonType.DEFAULT, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/menu_button_web_app.py b/env/Lib/site-packages/aiogram/types/menu_button_web_app.py new file mode 100644 index 0000000..0fc9e41 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/menu_button_web_app.py @@ -0,0 +1,42 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import MenuButtonType +from .menu_button import MenuButton + +if TYPE_CHECKING: + from .web_app_info import WebAppInfo + + +class MenuButtonWebApp(MenuButton): + """ + Represents a menu button, which launches a `Web App `_. + + Source: https://core.telegram.org/bots/api#menubuttonwebapp + """ + + type: Literal[MenuButtonType.WEB_APP] = MenuButtonType.WEB_APP + """Type of the button, must be *web_app*""" + text: str + """Text on the button""" + web_app: WebAppInfo + """Description of the Web App that will be launched when the user presses the button. The Web App will be able to send an arbitrary message on behalf of the user using the method :class:`aiogram.methods.answer_web_app_query.AnswerWebAppQuery`. Alternatively, a :code:`t.me` link to a Web App of the bot can be specified in the object instead of the Web App's URL, in which case the Web App will be opened as if the user pressed the link.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[MenuButtonType.WEB_APP] = MenuButtonType.WEB_APP, + text: str, + web_app: WebAppInfo, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, text=text, web_app=web_app, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/message.py b/env/Lib/site-packages/aiogram/types/message.py new file mode 100644 index 0000000..57defef --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/message.py @@ -0,0 +1,4229 @@ +from __future__ import annotations + +import datetime +from typing import TYPE_CHECKING, Any, Dict, List, Optional, Union + +from pydantic import Field + +from aiogram.utils.text_decorations import ( + TextDecoration, + html_decoration, + markdown_decoration, +) + +from ..client.default import Default +from ..enums import ContentType +from .custom import DateTime +from .maybe_inaccessible_message import MaybeInaccessibleMessage +from .reply_parameters import ReplyParameters + +if TYPE_CHECKING: + from ..methods import ( + CopyMessage, + DeleteMessage, + EditMessageCaption, + EditMessageLiveLocation, + EditMessageMedia, + EditMessageReplyMarkup, + EditMessageText, + ForwardMessage, + PinChatMessage, + SendAnimation, + SendAudio, + SendContact, + SendDice, + SendDocument, + SendGame, + SendInvoice, + SendLocation, + SendMediaGroup, + SendMessage, + SendPaidMedia, + SendPhoto, + SendPoll, + SendSticker, + SendVenue, + SendVideo, + SendVideoNote, + SendVoice, + SetMessageReaction, + StopMessageLiveLocation, + UnpinChatMessage, + ) + from .animation import Animation + from .audio import Audio + from .chat import Chat + from .chat_background import ChatBackground + from .chat_boost_added import ChatBoostAdded + from .chat_shared import ChatShared + from .contact import Contact + from .dice import Dice + from .document import Document + from .external_reply_info import ExternalReplyInfo + from .force_reply import ForceReply + from .forum_topic_closed import ForumTopicClosed + from .forum_topic_created import ForumTopicCreated + from .forum_topic_edited import ForumTopicEdited + from .forum_topic_reopened import ForumTopicReopened + from .game import Game + from .general_forum_topic_hidden import GeneralForumTopicHidden + from .general_forum_topic_unhidden import GeneralForumTopicUnhidden + from .giveaway import Giveaway + from .giveaway_completed import GiveawayCompleted + from .giveaway_created import GiveawayCreated + from .giveaway_winners import GiveawayWinners + from .inaccessible_message import InaccessibleMessage + from .inline_keyboard_markup import InlineKeyboardMarkup + from .input_file import InputFile + from .input_media_animation import InputMediaAnimation + from .input_media_audio import InputMediaAudio + from .input_media_document import InputMediaDocument + from .input_media_photo import InputMediaPhoto + from .input_media_video import InputMediaVideo + from .input_paid_media_photo import InputPaidMediaPhoto + from .input_paid_media_video import InputPaidMediaVideo + from .input_poll_option import InputPollOption + from .invoice import Invoice + from .labeled_price import LabeledPrice + from .link_preview_options import LinkPreviewOptions + from .location import Location + from .message_auto_delete_timer_changed import MessageAutoDeleteTimerChanged + from .message_entity import MessageEntity + from .message_origin_channel import MessageOriginChannel + from .message_origin_chat import MessageOriginChat + from .message_origin_hidden_user import MessageOriginHiddenUser + from .message_origin_user import MessageOriginUser + from .paid_media_info import PaidMediaInfo + from .passport_data import PassportData + from .photo_size import PhotoSize + from .poll import Poll + from .proximity_alert_triggered import ProximityAlertTriggered + from .reaction_type_custom_emoji import ReactionTypeCustomEmoji + from .reaction_type_emoji import ReactionTypeEmoji + from .reaction_type_paid import ReactionTypePaid + from .refunded_payment import RefundedPayment + from .reply_keyboard_markup import ReplyKeyboardMarkup + from .reply_keyboard_remove import ReplyKeyboardRemove + from .sticker import Sticker + from .story import Story + from .successful_payment import SuccessfulPayment + from .text_quote import TextQuote + from .user import User + from .user_shared import UserShared + from .users_shared import UsersShared + from .venue import Venue + from .video import Video + from .video_chat_ended import VideoChatEnded + from .video_chat_participants_invited import VideoChatParticipantsInvited + from .video_chat_scheduled import VideoChatScheduled + from .video_chat_started import VideoChatStarted + from .video_note import VideoNote + from .voice import Voice + from .web_app_data import WebAppData + from .write_access_allowed import WriteAccessAllowed + + +class Message(MaybeInaccessibleMessage): + """ + This object represents a message. + + Source: https://core.telegram.org/bots/api#message + """ + + message_id: int + """Unique message identifier inside this chat""" + date: DateTime + """Date the message was sent in Unix time. It is always a positive number, representing a valid date.""" + chat: Chat + """Chat the message belongs to""" + message_thread_id: Optional[int] = None + """*Optional*. Unique identifier of a message thread to which the message belongs; for supergroups only""" + from_user: Optional[User] = Field(None, alias="from") + """*Optional*. Sender of the message; may be empty for messages sent to channels. For backward compatibility, if the message was sent on behalf of a chat, the field contains a fake sender user in non-channel chats""" + sender_chat: Optional[Chat] = None + """*Optional*. Sender of the message when sent on behalf of a chat. For example, the supergroup itself for messages sent by its anonymous administrators or a linked channel for messages automatically forwarded to the channel's discussion group. For backward compatibility, if the message was sent on behalf of a chat, the field *from* contains a fake sender user in non-channel chats.""" + sender_boost_count: Optional[int] = None + """*Optional*. If the sender of the message boosted the chat, the number of boosts added by the user""" + sender_business_bot: Optional[User] = None + """*Optional*. The bot that actually sent the message on behalf of the business account. Available only for outgoing messages sent on behalf of the connected business account.""" + business_connection_id: Optional[str] = None + """*Optional*. Unique identifier of the business connection from which the message was received. If non-empty, the message belongs to a chat of the corresponding business account that is independent from any potential bot chat which might share the same identifier.""" + forward_origin: Optional[ + Union[MessageOriginUser, MessageOriginHiddenUser, MessageOriginChat, MessageOriginChannel] + ] = None + """*Optional*. Information about the original message for forwarded messages""" + is_topic_message: Optional[bool] = None + """*Optional*. :code:`True`, if the message is sent to a forum topic""" + is_automatic_forward: Optional[bool] = None + """*Optional*. :code:`True`, if the message is a channel post that was automatically forwarded to the connected discussion group""" + reply_to_message: Optional[Message] = None + """*Optional*. For replies in the same chat and message thread, the original message. Note that the Message object in this field will not contain further *reply_to_message* fields even if it itself is a reply.""" + external_reply: Optional[ExternalReplyInfo] = None + """*Optional*. Information about the message that is being replied to, which may come from another chat or forum topic""" + quote: Optional[TextQuote] = None + """*Optional*. For replies that quote part of the original message, the quoted part of the message""" + reply_to_story: Optional[Story] = None + """*Optional*. For replies to a story, the original story""" + via_bot: Optional[User] = None + """*Optional*. Bot through which the message was sent""" + edit_date: Optional[int] = None + """*Optional*. Date the message was last edited in Unix time""" + has_protected_content: Optional[bool] = None + """*Optional*. :code:`True`, if the message can't be forwarded""" + is_from_offline: Optional[bool] = None + """*Optional*. True, if the message was sent by an implicit action, for example, as an away or a greeting business message, or as a scheduled message""" + media_group_id: Optional[str] = None + """*Optional*. The unique identifier of a media message group this message belongs to""" + author_signature: Optional[str] = None + """*Optional*. Signature of the post author for messages in channels, or the custom title of an anonymous group administrator""" + text: Optional[str] = None + """*Optional*. For text messages, the actual UTF-8 text of the message""" + entities: Optional[List[MessageEntity]] = None + """*Optional*. For text messages, special entities like usernames, URLs, bot commands, etc. that appear in the text""" + link_preview_options: Optional[LinkPreviewOptions] = None + """*Optional*. Options used for link preview generation for the message, if it is a text message and link preview options were changed""" + effect_id: Optional[str] = None + """*Optional*. Unique identifier of the message effect added to the message""" + animation: Optional[Animation] = None + """*Optional*. Message is an animation, information about the animation. For backward compatibility, when this field is set, the *document* field will also be set""" + audio: Optional[Audio] = None + """*Optional*. Message is an audio file, information about the file""" + document: Optional[Document] = None + """*Optional*. Message is a general file, information about the file""" + paid_media: Optional[PaidMediaInfo] = None + """*Optional*. Message contains paid media; information about the paid media""" + photo: Optional[List[PhotoSize]] = None + """*Optional*. Message is a photo, available sizes of the photo""" + sticker: Optional[Sticker] = None + """*Optional*. Message is a sticker, information about the sticker""" + story: Optional[Story] = None + """*Optional*. Message is a forwarded story""" + video: Optional[Video] = None + """*Optional*. Message is a video, information about the video""" + video_note: Optional[VideoNote] = None + """*Optional*. Message is a `video note `_, information about the video message""" + voice: Optional[Voice] = None + """*Optional*. Message is a voice message, information about the file""" + caption: Optional[str] = None + """*Optional*. Caption for the animation, audio, document, paid media, photo, video or voice""" + caption_entities: Optional[List[MessageEntity]] = None + """*Optional*. For messages with a caption, special entities like usernames, URLs, bot commands, etc. that appear in the caption""" + show_caption_above_media: Optional[bool] = None + """*Optional*. True, if the caption must be shown above the message media""" + has_media_spoiler: Optional[bool] = None + """*Optional*. :code:`True`, if the message media is covered by a spoiler animation""" + contact: Optional[Contact] = None + """*Optional*. Message is a shared contact, information about the contact""" + dice: Optional[Dice] = None + """*Optional*. Message is a dice with random value""" + game: Optional[Game] = None + """*Optional*. Message is a game, information about the game. `More about games » `_""" + poll: Optional[Poll] = None + """*Optional*. Message is a native poll, information about the poll""" + venue: Optional[Venue] = None + """*Optional*. Message is a venue, information about the venue. For backward compatibility, when this field is set, the *location* field will also be set""" + location: Optional[Location] = None + """*Optional*. Message is a shared location, information about the location""" + new_chat_members: Optional[List[User]] = None + """*Optional*. New members that were added to the group or supergroup and information about them (the bot itself may be one of these members)""" + left_chat_member: Optional[User] = None + """*Optional*. A member was removed from the group, information about them (this member may be the bot itself)""" + new_chat_title: Optional[str] = None + """*Optional*. A chat title was changed to this value""" + new_chat_photo: Optional[List[PhotoSize]] = None + """*Optional*. A chat photo was change to this value""" + delete_chat_photo: Optional[bool] = None + """*Optional*. Service message: the chat photo was deleted""" + group_chat_created: Optional[bool] = None + """*Optional*. Service message: the group has been created""" + supergroup_chat_created: Optional[bool] = None + """*Optional*. Service message: the supergroup has been created. This field can't be received in a message coming through updates, because bot can't be a member of a supergroup when it is created. It can only be found in reply_to_message if someone replies to a very first message in a directly created supergroup.""" + channel_chat_created: Optional[bool] = None + """*Optional*. Service message: the channel has been created. This field can't be received in a message coming through updates, because bot can't be a member of a channel when it is created. It can only be found in reply_to_message if someone replies to a very first message in a channel.""" + message_auto_delete_timer_changed: Optional[MessageAutoDeleteTimerChanged] = None + """*Optional*. Service message: auto-delete timer settings changed in the chat""" + migrate_to_chat_id: Optional[int] = None + """*Optional*. The group has been migrated to a supergroup with the specified identifier. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this identifier.""" + migrate_from_chat_id: Optional[int] = None + """*Optional*. The supergroup has been migrated from a group with the specified identifier. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this identifier.""" + pinned_message: Optional[Union[Message, InaccessibleMessage]] = None + """*Optional*. Specified message was pinned. Note that the Message object in this field will not contain further *reply_to_message* fields even if it itself is a reply.""" + invoice: Optional[Invoice] = None + """*Optional*. Message is an invoice for a `payment `_, information about the invoice. `More about payments » `_""" + successful_payment: Optional[SuccessfulPayment] = None + """*Optional*. Message is a service message about a successful payment, information about the payment. `More about payments » `_""" + refunded_payment: Optional[RefundedPayment] = None + """*Optional*. Message is a service message about a refunded payment, information about the payment. `More about payments » `_""" + users_shared: Optional[UsersShared] = None + """*Optional*. Service message: users were shared with the bot""" + chat_shared: Optional[ChatShared] = None + """*Optional*. Service message: a chat was shared with the bot""" + connected_website: Optional[str] = None + """*Optional*. The domain name of the website on which the user has logged in. `More about Telegram Login » `_""" + write_access_allowed: Optional[WriteAccessAllowed] = None + """*Optional*. Service message: the user allowed the bot to write messages after adding it to the attachment or side menu, launching a Web App from a link, or accepting an explicit request from a Web App sent by the method `requestWriteAccess `_""" + passport_data: Optional[PassportData] = None + """*Optional*. Telegram Passport data""" + proximity_alert_triggered: Optional[ProximityAlertTriggered] = None + """*Optional*. Service message. A user in the chat triggered another user's proximity alert while sharing Live Location.""" + boost_added: Optional[ChatBoostAdded] = None + """*Optional*. Service message: user boosted the chat""" + chat_background_set: Optional[ChatBackground] = None + """*Optional*. Service message: chat background set""" + forum_topic_created: Optional[ForumTopicCreated] = None + """*Optional*. Service message: forum topic created""" + forum_topic_edited: Optional[ForumTopicEdited] = None + """*Optional*. Service message: forum topic edited""" + forum_topic_closed: Optional[ForumTopicClosed] = None + """*Optional*. Service message: forum topic closed""" + forum_topic_reopened: Optional[ForumTopicReopened] = None + """*Optional*. Service message: forum topic reopened""" + general_forum_topic_hidden: Optional[GeneralForumTopicHidden] = None + """*Optional*. Service message: the 'General' forum topic hidden""" + general_forum_topic_unhidden: Optional[GeneralForumTopicUnhidden] = None + """*Optional*. Service message: the 'General' forum topic unhidden""" + giveaway_created: Optional[GiveawayCreated] = None + """*Optional*. Service message: a scheduled giveaway was created""" + giveaway: Optional[Giveaway] = None + """*Optional*. The message is a scheduled giveaway message""" + giveaway_winners: Optional[GiveawayWinners] = None + """*Optional*. A giveaway with public winners was completed""" + giveaway_completed: Optional[GiveawayCompleted] = None + """*Optional*. Service message: a giveaway without public winners was completed""" + video_chat_scheduled: Optional[VideoChatScheduled] = None + """*Optional*. Service message: video chat scheduled""" + video_chat_started: Optional[VideoChatStarted] = None + """*Optional*. Service message: video chat started""" + video_chat_ended: Optional[VideoChatEnded] = None + """*Optional*. Service message: video chat ended""" + video_chat_participants_invited: Optional[VideoChatParticipantsInvited] = None + """*Optional*. Service message: new participants invited to a video chat""" + web_app_data: Optional[WebAppData] = None + """*Optional*. Service message: data sent by a Web App""" + reply_markup: Optional[InlineKeyboardMarkup] = None + """*Optional*. Inline keyboard attached to the message. :code:`login_url` buttons are represented as ordinary :code:`url` buttons.""" + forward_date: Optional[DateTime] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. For forwarded messages, date the original message was sent in Unix time + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + forward_from: Optional[User] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. For forwarded messages, sender of the original message + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + forward_from_chat: Optional[Chat] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. For messages forwarded from channels or from anonymous administrators, information about the original sender chat + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + forward_from_message_id: Optional[int] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. For messages forwarded from channels, identifier of the original message in the channel + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + forward_sender_name: Optional[str] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + forward_signature: Optional[str] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. For forwarded messages that were originally sent in channels or by an anonymous chat administrator, signature of the message sender if present + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + user_shared: Optional[UserShared] = Field(None, json_schema_extra={"deprecated": True}) + """*Optional*. Service message: a user was shared with the bot + +.. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + message_id: int, + date: DateTime, + chat: Chat, + message_thread_id: Optional[int] = None, + from_user: Optional[User] = None, + sender_chat: Optional[Chat] = None, + sender_boost_count: Optional[int] = None, + sender_business_bot: Optional[User] = None, + business_connection_id: Optional[str] = None, + forward_origin: Optional[ + Union[ + MessageOriginUser, + MessageOriginHiddenUser, + MessageOriginChat, + MessageOriginChannel, + ] + ] = None, + is_topic_message: Optional[bool] = None, + is_automatic_forward: Optional[bool] = None, + reply_to_message: Optional[Message] = None, + external_reply: Optional[ExternalReplyInfo] = None, + quote: Optional[TextQuote] = None, + reply_to_story: Optional[Story] = None, + via_bot: Optional[User] = None, + edit_date: Optional[int] = None, + has_protected_content: Optional[bool] = None, + is_from_offline: Optional[bool] = None, + media_group_id: Optional[str] = None, + author_signature: Optional[str] = None, + text: Optional[str] = None, + entities: Optional[List[MessageEntity]] = None, + link_preview_options: Optional[LinkPreviewOptions] = None, + effect_id: Optional[str] = None, + animation: Optional[Animation] = None, + audio: Optional[Audio] = None, + document: Optional[Document] = None, + paid_media: Optional[PaidMediaInfo] = None, + photo: Optional[List[PhotoSize]] = None, + sticker: Optional[Sticker] = None, + story: Optional[Story] = None, + video: Optional[Video] = None, + video_note: Optional[VideoNote] = None, + voice: Optional[Voice] = None, + caption: Optional[str] = None, + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[bool] = None, + has_media_spoiler: Optional[bool] = None, + contact: Optional[Contact] = None, + dice: Optional[Dice] = None, + game: Optional[Game] = None, + poll: Optional[Poll] = None, + venue: Optional[Venue] = None, + location: Optional[Location] = None, + new_chat_members: Optional[List[User]] = None, + left_chat_member: Optional[User] = None, + new_chat_title: Optional[str] = None, + new_chat_photo: Optional[List[PhotoSize]] = None, + delete_chat_photo: Optional[bool] = None, + group_chat_created: Optional[bool] = None, + supergroup_chat_created: Optional[bool] = None, + channel_chat_created: Optional[bool] = None, + message_auto_delete_timer_changed: Optional[MessageAutoDeleteTimerChanged] = None, + migrate_to_chat_id: Optional[int] = None, + migrate_from_chat_id: Optional[int] = None, + pinned_message: Optional[Union[Message, InaccessibleMessage]] = None, + invoice: Optional[Invoice] = None, + successful_payment: Optional[SuccessfulPayment] = None, + refunded_payment: Optional[RefundedPayment] = None, + users_shared: Optional[UsersShared] = None, + chat_shared: Optional[ChatShared] = None, + connected_website: Optional[str] = None, + write_access_allowed: Optional[WriteAccessAllowed] = None, + passport_data: Optional[PassportData] = None, + proximity_alert_triggered: Optional[ProximityAlertTriggered] = None, + boost_added: Optional[ChatBoostAdded] = None, + chat_background_set: Optional[ChatBackground] = None, + forum_topic_created: Optional[ForumTopicCreated] = None, + forum_topic_edited: Optional[ForumTopicEdited] = None, + forum_topic_closed: Optional[ForumTopicClosed] = None, + forum_topic_reopened: Optional[ForumTopicReopened] = None, + general_forum_topic_hidden: Optional[GeneralForumTopicHidden] = None, + general_forum_topic_unhidden: Optional[GeneralForumTopicUnhidden] = None, + giveaway_created: Optional[GiveawayCreated] = None, + giveaway: Optional[Giveaway] = None, + giveaway_winners: Optional[GiveawayWinners] = None, + giveaway_completed: Optional[GiveawayCompleted] = None, + video_chat_scheduled: Optional[VideoChatScheduled] = None, + video_chat_started: Optional[VideoChatStarted] = None, + video_chat_ended: Optional[VideoChatEnded] = None, + video_chat_participants_invited: Optional[VideoChatParticipantsInvited] = None, + web_app_data: Optional[WebAppData] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + forward_date: Optional[DateTime] = None, + forward_from: Optional[User] = None, + forward_from_chat: Optional[Chat] = None, + forward_from_message_id: Optional[int] = None, + forward_sender_name: Optional[str] = None, + forward_signature: Optional[str] = None, + user_shared: Optional[UserShared] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + message_id=message_id, + date=date, + chat=chat, + message_thread_id=message_thread_id, + from_user=from_user, + sender_chat=sender_chat, + sender_boost_count=sender_boost_count, + sender_business_bot=sender_business_bot, + business_connection_id=business_connection_id, + forward_origin=forward_origin, + is_topic_message=is_topic_message, + is_automatic_forward=is_automatic_forward, + reply_to_message=reply_to_message, + external_reply=external_reply, + quote=quote, + reply_to_story=reply_to_story, + via_bot=via_bot, + edit_date=edit_date, + has_protected_content=has_protected_content, + is_from_offline=is_from_offline, + media_group_id=media_group_id, + author_signature=author_signature, + text=text, + entities=entities, + link_preview_options=link_preview_options, + effect_id=effect_id, + animation=animation, + audio=audio, + document=document, + paid_media=paid_media, + photo=photo, + sticker=sticker, + story=story, + video=video, + video_note=video_note, + voice=voice, + caption=caption, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_media_spoiler=has_media_spoiler, + contact=contact, + dice=dice, + game=game, + poll=poll, + venue=venue, + location=location, + new_chat_members=new_chat_members, + left_chat_member=left_chat_member, + new_chat_title=new_chat_title, + new_chat_photo=new_chat_photo, + delete_chat_photo=delete_chat_photo, + group_chat_created=group_chat_created, + supergroup_chat_created=supergroup_chat_created, + channel_chat_created=channel_chat_created, + message_auto_delete_timer_changed=message_auto_delete_timer_changed, + migrate_to_chat_id=migrate_to_chat_id, + migrate_from_chat_id=migrate_from_chat_id, + pinned_message=pinned_message, + invoice=invoice, + successful_payment=successful_payment, + refunded_payment=refunded_payment, + users_shared=users_shared, + chat_shared=chat_shared, + connected_website=connected_website, + write_access_allowed=write_access_allowed, + passport_data=passport_data, + proximity_alert_triggered=proximity_alert_triggered, + boost_added=boost_added, + chat_background_set=chat_background_set, + forum_topic_created=forum_topic_created, + forum_topic_edited=forum_topic_edited, + forum_topic_closed=forum_topic_closed, + forum_topic_reopened=forum_topic_reopened, + general_forum_topic_hidden=general_forum_topic_hidden, + general_forum_topic_unhidden=general_forum_topic_unhidden, + giveaway_created=giveaway_created, + giveaway=giveaway, + giveaway_winners=giveaway_winners, + giveaway_completed=giveaway_completed, + video_chat_scheduled=video_chat_scheduled, + video_chat_started=video_chat_started, + video_chat_ended=video_chat_ended, + video_chat_participants_invited=video_chat_participants_invited, + web_app_data=web_app_data, + reply_markup=reply_markup, + forward_date=forward_date, + forward_from=forward_from, + forward_from_chat=forward_from_chat, + forward_from_message_id=forward_from_message_id, + forward_sender_name=forward_sender_name, + forward_signature=forward_signature, + user_shared=user_shared, + **__pydantic_kwargs, + ) + + @property + def content_type(self) -> str: + if self.text: + return ContentType.TEXT + if self.audio: + return ContentType.AUDIO + if self.animation: + return ContentType.ANIMATION + if self.document: + return ContentType.DOCUMENT + if self.game: + return ContentType.GAME + if self.photo: + return ContentType.PHOTO + if self.sticker: + return ContentType.STICKER + if self.video: + return ContentType.VIDEO + if self.video_note: + return ContentType.VIDEO_NOTE + if self.voice: + return ContentType.VOICE + if self.contact: + return ContentType.CONTACT + if self.venue: + return ContentType.VENUE + if self.location: + return ContentType.LOCATION + if self.new_chat_members: + return ContentType.NEW_CHAT_MEMBERS + if self.left_chat_member: + return ContentType.LEFT_CHAT_MEMBER + if self.invoice: + return ContentType.INVOICE + if self.successful_payment: + return ContentType.SUCCESSFUL_PAYMENT + if self.users_shared: + return ContentType.USERS_SHARED + if self.connected_website: + return ContentType.CONNECTED_WEBSITE + if self.migrate_from_chat_id: + return ContentType.MIGRATE_FROM_CHAT_ID + if self.migrate_to_chat_id: + return ContentType.MIGRATE_TO_CHAT_ID + if self.pinned_message: + return ContentType.PINNED_MESSAGE + if self.new_chat_title: + return ContentType.NEW_CHAT_TITLE + if self.new_chat_photo: + return ContentType.NEW_CHAT_PHOTO + if self.delete_chat_photo: + return ContentType.DELETE_CHAT_PHOTO + if self.group_chat_created: + return ContentType.GROUP_CHAT_CREATED + if self.supergroup_chat_created: + return ContentType.SUPERGROUP_CHAT_CREATED + if self.channel_chat_created: + return ContentType.CHANNEL_CHAT_CREATED + if self.paid_media: + return ContentType.PAID_MEDIA + if self.passport_data: + return ContentType.PASSPORT_DATA + if self.proximity_alert_triggered: + return ContentType.PROXIMITY_ALERT_TRIGGERED + if self.poll: + return ContentType.POLL + if self.dice: + return ContentType.DICE + if self.message_auto_delete_timer_changed: + return ContentType.MESSAGE_AUTO_DELETE_TIMER_CHANGED + if self.forum_topic_created: + return ContentType.FORUM_TOPIC_CREATED + if self.forum_topic_edited: + return ContentType.FORUM_TOPIC_EDITED + if self.forum_topic_closed: + return ContentType.FORUM_TOPIC_CLOSED + if self.forum_topic_reopened: + return ContentType.FORUM_TOPIC_REOPENED + if self.general_forum_topic_hidden: + return ContentType.GENERAL_FORUM_TOPIC_HIDDEN + if self.general_forum_topic_unhidden: + return ContentType.GENERAL_FORUM_TOPIC_UNHIDDEN + if self.giveaway_created: + return ContentType.GIVEAWAY_CREATED + if self.giveaway: + return ContentType.GIVEAWAY + if self.giveaway_completed: + return ContentType.GIVEAWAY_COMPLETED + if self.giveaway_winners: + return ContentType.GIVEAWAY_WINNERS + if self.video_chat_scheduled: + return ContentType.VIDEO_CHAT_SCHEDULED + if self.video_chat_started: + return ContentType.VIDEO_CHAT_STARTED + if self.video_chat_ended: + return ContentType.VIDEO_CHAT_ENDED + if self.video_chat_participants_invited: + return ContentType.VIDEO_CHAT_PARTICIPANTS_INVITED + if self.web_app_data: + return ContentType.WEB_APP_DATA + if self.user_shared: + return ContentType.USER_SHARED + if self.chat_shared: + return ContentType.CHAT_SHARED + if self.story: + return ContentType.STORY + if self.write_access_allowed: + return ContentType.WRITE_ACCESS_ALLOWED + if self.chat_background_set: + return ContentType.CHAT_BACKGROUND_SET + if self.boost_added: + return ContentType.BOOST_ADDED + if self.refunded_payment: + return ContentType.REFUNDED_PAYMENT + + return ContentType.UNKNOWN + + def _unparse_entities(self, text_decoration: TextDecoration) -> str: + text = self.text or self.caption or "" + entities = self.entities or self.caption_entities or [] + return text_decoration.unparse(text=text, entities=entities) + + @property + def html_text(self) -> str: + return self._unparse_entities(html_decoration) + + @property + def md_text(self) -> str: + return self._unparse_entities(markdown_decoration) + + def as_reply_parameters( + self, + allow_sending_without_reply: Optional[Union[bool, Default]] = Default( + "allow_sending_without_reply" + ), + quote: Optional[str] = None, + quote_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + quote_entities: Optional[List[MessageEntity]] = None, + quote_position: Optional[int] = None, + ) -> ReplyParameters: + return ReplyParameters( + message_id=self.message_id, + chat_id=self.chat.id, + allow_sending_without_reply=allow_sending_without_reply, + quote=quote, + quote_parse_mode=quote_parse_mode, + quote_entities=quote_entities, + quote_position=quote_position, + ) + + def reply_animation( + self, + animation: Union[InputFile, str], + duration: Optional[int] = None, + width: Optional[int] = None, + height: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + **kwargs: Any, + ) -> SendAnimation: + """ + Shortcut for method :class:`aiogram.methods.send_animation.SendAnimation` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send animation files (GIF or H.264/MPEG-4 AVC video without sound). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send animation files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendanimation + + :param animation: Animation to send. Pass a file_id as String to send an animation that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an animation from the Internet, or upload a new animation using multipart/form-data. :ref:`More information on Sending Files » ` + :param duration: Duration of sent animation in seconds + :param width: Animation width + :param height: Animation height + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Animation caption (may also be used when resending animation by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the animation caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the animation needs to be covered with a spoiler animation + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_animation.SendAnimation` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendAnimation + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendAnimation( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + animation=animation, + duration=duration, + width=width, + height=height, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + **kwargs, + ).as_(self._bot) + + def answer_animation( + self, + animation: Union[InputFile, str], + duration: Optional[int] = None, + width: Optional[int] = None, + height: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendAnimation: + """ + Shortcut for method :class:`aiogram.methods.send_animation.SendAnimation` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send animation files (GIF or H.264/MPEG-4 AVC video without sound). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send animation files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendanimation + + :param animation: Animation to send. Pass a file_id as String to send an animation that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an animation from the Internet, or upload a new animation using multipart/form-data. :ref:`More information on Sending Files » ` + :param duration: Duration of sent animation in seconds + :param width: Animation width + :param height: Animation height + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Animation caption (may also be used when resending animation by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the animation caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the animation needs to be covered with a spoiler animation + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_animation.SendAnimation` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendAnimation + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendAnimation( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + animation=animation, + duration=duration, + width=width, + height=height, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def reply_audio( + self, + audio: Union[InputFile, str], + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + performer: Optional[str] = None, + title: Optional[str] = None, + thumbnail: Optional[InputFile] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + **kwargs: Any, + ) -> SendAudio: + """ + Shortcut for method :class:`aiogram.methods.send_audio.SendAudio` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send audio files, if you want Telegram clients to display them in the music player. Your audio must be in the .MP3 or .M4A format. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future. + For sending voice messages, use the :class:`aiogram.methods.send_voice.SendVoice` method instead. + + Source: https://core.telegram.org/bots/api#sendaudio + + :param audio: Audio file to send. Pass a file_id as String to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` + :param caption: Audio caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the audio caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param duration: Duration of the audio in seconds + :param performer: Performer + :param title: Track name + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_audio.SendAudio` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendAudio + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendAudio( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + audio=audio, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + duration=duration, + performer=performer, + title=title, + thumbnail=thumbnail, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + **kwargs, + ).as_(self._bot) + + def answer_audio( + self, + audio: Union[InputFile, str], + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + performer: Optional[str] = None, + title: Optional[str] = None, + thumbnail: Optional[InputFile] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendAudio: + """ + Shortcut for method :class:`aiogram.methods.send_audio.SendAudio` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send audio files, if you want Telegram clients to display them in the music player. Your audio must be in the .MP3 or .M4A format. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future. + For sending voice messages, use the :class:`aiogram.methods.send_voice.SendVoice` method instead. + + Source: https://core.telegram.org/bots/api#sendaudio + + :param audio: Audio file to send. Pass a file_id as String to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. :ref:`More information on Sending Files » ` + :param caption: Audio caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the audio caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param duration: Duration of the audio in seconds + :param performer: Performer + :param title: Track name + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_audio.SendAudio` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendAudio + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendAudio( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + audio=audio, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + duration=duration, + performer=performer, + title=title, + thumbnail=thumbnail, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def reply_contact( + self, + phone_number: str, + first_name: str, + last_name: Optional[str] = None, + vcard: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + **kwargs: Any, + ) -> SendContact: + """ + Shortcut for method :class:`aiogram.methods.send_contact.SendContact` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send phone contacts. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendcontact + + :param phone_number: Contact's phone number + :param first_name: Contact's first name + :param last_name: Contact's last name + :param vcard: Additional data about the contact in the form of a `vCard `_, 0-2048 bytes + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_contact.SendContact` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendContact + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendContact( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + phone_number=phone_number, + first_name=first_name, + last_name=last_name, + vcard=vcard, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + **kwargs, + ).as_(self._bot) + + def answer_contact( + self, + phone_number: str, + first_name: str, + last_name: Optional[str] = None, + vcard: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendContact: + """ + Shortcut for method :class:`aiogram.methods.send_contact.SendContact` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send phone contacts. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendcontact + + :param phone_number: Contact's phone number + :param first_name: Contact's first name + :param last_name: Contact's last name + :param vcard: Additional data about the contact in the form of a `vCard `_, 0-2048 bytes + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_contact.SendContact` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendContact + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendContact( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + phone_number=phone_number, + first_name=first_name, + last_name=last_name, + vcard=vcard, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def reply_document( + self, + document: Union[InputFile, str], + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + disable_content_type_detection: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + **kwargs: Any, + ) -> SendDocument: + """ + Shortcut for method :class:`aiogram.methods.send_document.SendDocument` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send general files. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#senddocument + + :param document: File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), 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 information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Document caption (may also be used when resending documents by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the document caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param disable_content_type_detection: Disables automatic server-side content type detection for files uploaded using multipart/form-data + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_document.SendDocument` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendDocument + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendDocument( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + document=document, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + disable_content_type_detection=disable_content_type_detection, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + **kwargs, + ).as_(self._bot) + + def answer_document( + self, + document: Union[InputFile, str], + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + disable_content_type_detection: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendDocument: + """ + Shortcut for method :class:`aiogram.methods.send_document.SendDocument` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send general files. On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#senddocument + + :param document: File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), 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 information on Sending Files » ` + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Document caption (may also be used when resending documents by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the document caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param disable_content_type_detection: Disables automatic server-side content type detection for files uploaded using multipart/form-data + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_document.SendDocument` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendDocument + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendDocument( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + document=document, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + disable_content_type_detection=disable_content_type_detection, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def reply_game( + self, + game_short_name: str, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + allow_sending_without_reply: Optional[bool] = None, + **kwargs: Any, + ) -> SendGame: + """ + Shortcut for method :class:`aiogram.methods.send_game.SendGame` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send a game. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendgame + + :param game_short_name: Short name of the game, serves as the unique identifier for the game. Set up your games via `@BotFather `_. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game. + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_game.SendGame` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendGame + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendGame( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + game_short_name=game_short_name, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + **kwargs, + ).as_(self._bot) + + def answer_game( + self, + game_short_name: str, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendGame: + """ + Shortcut for method :class:`aiogram.methods.send_game.SendGame` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send a game. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendgame + + :param game_short_name: Short name of the game, serves as the unique identifier for the game. Set up your games via `@BotFather `_. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game. + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_game.SendGame` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendGame + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendGame( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + game_short_name=game_short_name, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def reply_invoice( + self, + title: str, + description: str, + payload: str, + currency: str, + prices: List[LabeledPrice], + provider_token: Optional[str] = None, + max_tip_amount: Optional[int] = None, + suggested_tip_amounts: Optional[List[int]] = None, + start_parameter: Optional[str] = None, + provider_data: Optional[str] = None, + photo_url: Optional[str] = None, + photo_size: Optional[int] = None, + photo_width: Optional[int] = None, + photo_height: Optional[int] = None, + need_name: Optional[bool] = None, + need_phone_number: Optional[bool] = None, + need_email: Optional[bool] = None, + need_shipping_address: Optional[bool] = None, + send_phone_number_to_provider: Optional[bool] = None, + send_email_to_provider: Optional[bool] = None, + is_flexible: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + allow_sending_without_reply: Optional[bool] = None, + **kwargs: Any, + ) -> SendInvoice: + """ + Shortcut for method :class:`aiogram.methods.send_invoice.SendInvoice` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send invoices. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendinvoice + + :param title: Product name, 1-32 characters + :param description: Product description, 1-255 characters + :param payload: Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use for your internal processes. + :param currency: Three-letter ISO 4217 currency code, see `more on currencies `_. Pass 'XTR' for payments in `Telegram Stars `_. + :param prices: Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.). Must contain exactly one item for payments in `Telegram Stars `_. + :param provider_token: Payment provider token, obtained via `@BotFather `_. Pass an empty string for payments in `Telegram Stars `_. + :param max_tip_amount: The maximum accepted amount for tips in the *smallest units* of the currency (integer, **not** float/double). For example, for a maximum tip of :code:`US$ 1.45` pass :code:`max_tip_amount = 145`. See the *exp* parameter in `currencies.json `_, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0. Not supported for payments in `Telegram Stars `_. + :param suggested_tip_amounts: A JSON-serialized array of suggested amounts of tips in the *smallest units* of the currency (integer, **not** float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed *max_tip_amount*. + :param start_parameter: Unique deep-linking parameter. If left empty, **forwarded copies** of the sent message will have a *Pay* button, allowing multiple users to pay directly from the forwarded message, using the same invoice. If non-empty, forwarded copies of the sent message will have a *URL* button with a deep link to the bot (instead of a *Pay* button), with the value used as the start parameter + :param provider_data: JSON-serialized data about the invoice, which will be shared with the payment provider. A detailed description of required fields should be provided by the payment provider. + :param photo_url: URL of the product photo for the invoice. Can be a photo of the goods or a marketing image for a service. People like it better when they see what they are paying for. + :param photo_size: Photo size in bytes + :param photo_width: Photo width + :param photo_height: Photo height + :param need_name: Pass :code:`True` if you require the user's full name to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_phone_number: Pass :code:`True` if you require the user's phone number to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_email: Pass :code:`True` if you require the user's email address to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_shipping_address: Pass :code:`True` if you require the user's shipping address to complete the order. Ignored for payments in `Telegram Stars `_. + :param send_phone_number_to_provider: Pass :code:`True` if the user's phone number should be sent to the provider. Ignored for payments in `Telegram Stars `_. + :param send_email_to_provider: Pass :code:`True` if the user's email address should be sent to the provider. Ignored for payments in `Telegram Stars `_. + :param is_flexible: Pass :code:`True` if the final price depends on the shipping method. Ignored for payments in `Telegram Stars `_. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Pay :code:`total price`' button will be shown. If not empty, the first button must be a Pay button. + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_invoice.SendInvoice` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendInvoice + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendInvoice( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + title=title, + description=description, + payload=payload, + currency=currency, + prices=prices, + provider_token=provider_token, + max_tip_amount=max_tip_amount, + suggested_tip_amounts=suggested_tip_amounts, + start_parameter=start_parameter, + provider_data=provider_data, + photo_url=photo_url, + photo_size=photo_size, + photo_width=photo_width, + photo_height=photo_height, + need_name=need_name, + need_phone_number=need_phone_number, + need_email=need_email, + need_shipping_address=need_shipping_address, + send_phone_number_to_provider=send_phone_number_to_provider, + send_email_to_provider=send_email_to_provider, + is_flexible=is_flexible, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + **kwargs, + ).as_(self._bot) + + def answer_invoice( + self, + title: str, + description: str, + payload: str, + currency: str, + prices: List[LabeledPrice], + provider_token: Optional[str] = None, + max_tip_amount: Optional[int] = None, + suggested_tip_amounts: Optional[List[int]] = None, + start_parameter: Optional[str] = None, + provider_data: Optional[str] = None, + photo_url: Optional[str] = None, + photo_size: Optional[int] = None, + photo_width: Optional[int] = None, + photo_height: Optional[int] = None, + need_name: Optional[bool] = None, + need_phone_number: Optional[bool] = None, + need_email: Optional[bool] = None, + need_shipping_address: Optional[bool] = None, + send_phone_number_to_provider: Optional[bool] = None, + send_email_to_provider: Optional[bool] = None, + is_flexible: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendInvoice: + """ + Shortcut for method :class:`aiogram.methods.send_invoice.SendInvoice` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send invoices. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendinvoice + + :param title: Product name, 1-32 characters + :param description: Product description, 1-255 characters + :param payload: Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use for your internal processes. + :param currency: Three-letter ISO 4217 currency code, see `more on currencies `_. Pass 'XTR' for payments in `Telegram Stars `_. + :param prices: Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.). Must contain exactly one item for payments in `Telegram Stars `_. + :param provider_token: Payment provider token, obtained via `@BotFather `_. Pass an empty string for payments in `Telegram Stars `_. + :param max_tip_amount: The maximum accepted amount for tips in the *smallest units* of the currency (integer, **not** float/double). For example, for a maximum tip of :code:`US$ 1.45` pass :code:`max_tip_amount = 145`. See the *exp* parameter in `currencies.json `_, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0. Not supported for payments in `Telegram Stars `_. + :param suggested_tip_amounts: A JSON-serialized array of suggested amounts of tips in the *smallest units* of the currency (integer, **not** float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed *max_tip_amount*. + :param start_parameter: Unique deep-linking parameter. If left empty, **forwarded copies** of the sent message will have a *Pay* button, allowing multiple users to pay directly from the forwarded message, using the same invoice. If non-empty, forwarded copies of the sent message will have a *URL* button with a deep link to the bot (instead of a *Pay* button), with the value used as the start parameter + :param provider_data: JSON-serialized data about the invoice, which will be shared with the payment provider. A detailed description of required fields should be provided by the payment provider. + :param photo_url: URL of the product photo for the invoice. Can be a photo of the goods or a marketing image for a service. People like it better when they see what they are paying for. + :param photo_size: Photo size in bytes + :param photo_width: Photo width + :param photo_height: Photo height + :param need_name: Pass :code:`True` if you require the user's full name to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_phone_number: Pass :code:`True` if you require the user's phone number to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_email: Pass :code:`True` if you require the user's email address to complete the order. Ignored for payments in `Telegram Stars `_. + :param need_shipping_address: Pass :code:`True` if you require the user's shipping address to complete the order. Ignored for payments in `Telegram Stars `_. + :param send_phone_number_to_provider: Pass :code:`True` if the user's phone number should be sent to the provider. Ignored for payments in `Telegram Stars `_. + :param send_email_to_provider: Pass :code:`True` if the user's email address should be sent to the provider. Ignored for payments in `Telegram Stars `_. + :param is_flexible: Pass :code:`True` if the final price depends on the shipping method. Ignored for payments in `Telegram Stars `_. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. If empty, one 'Pay :code:`total price`' button will be shown. If not empty, the first button must be a Pay button. + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_invoice.SendInvoice` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendInvoice + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendInvoice( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + title=title, + description=description, + payload=payload, + currency=currency, + prices=prices, + provider_token=provider_token, + max_tip_amount=max_tip_amount, + suggested_tip_amounts=suggested_tip_amounts, + start_parameter=start_parameter, + provider_data=provider_data, + photo_url=photo_url, + photo_size=photo_size, + photo_width=photo_width, + photo_height=photo_height, + need_name=need_name, + need_phone_number=need_phone_number, + need_email=need_email, + need_shipping_address=need_shipping_address, + send_phone_number_to_provider=send_phone_number_to_provider, + send_email_to_provider=send_email_to_provider, + is_flexible=is_flexible, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def reply_location( + self, + latitude: float, + longitude: float, + horizontal_accuracy: Optional[float] = None, + live_period: Optional[int] = None, + heading: Optional[int] = None, + proximity_alert_radius: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + **kwargs: Any, + ) -> SendLocation: + """ + Shortcut for method :class:`aiogram.methods.send_location.SendLocation` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send point on the map. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendlocation + + :param latitude: Latitude of the location + :param longitude: Longitude of the location + :param horizontal_accuracy: The radius of uncertainty for the location, measured in meters; 0-1500 + :param live_period: Period in seconds during which the location will be updated (see `Live Locations `_, should be between 60 and 86400, or 0x7FFFFFFF for live locations that can be edited indefinitely. + :param heading: For live locations, a direction in which the user is moving, in degrees. Must be between 1 and 360 if specified. + :param proximity_alert_radius: For live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_location.SendLocation` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendLocation + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendLocation( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + latitude=latitude, + longitude=longitude, + horizontal_accuracy=horizontal_accuracy, + live_period=live_period, + heading=heading, + proximity_alert_radius=proximity_alert_radius, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + **kwargs, + ).as_(self._bot) + + def answer_location( + self, + latitude: float, + longitude: float, + horizontal_accuracy: Optional[float] = None, + live_period: Optional[int] = None, + heading: Optional[int] = None, + proximity_alert_radius: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendLocation: + """ + Shortcut for method :class:`aiogram.methods.send_location.SendLocation` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send point on the map. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendlocation + + :param latitude: Latitude of the location + :param longitude: Longitude of the location + :param horizontal_accuracy: The radius of uncertainty for the location, measured in meters; 0-1500 + :param live_period: Period in seconds during which the location will be updated (see `Live Locations `_, should be between 60 and 86400, or 0x7FFFFFFF for live locations that can be edited indefinitely. + :param heading: For live locations, a direction in which the user is moving, in degrees. Must be between 1 and 360 if specified. + :param proximity_alert_radius: For live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_location.SendLocation` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendLocation + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendLocation( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + latitude=latitude, + longitude=longitude, + horizontal_accuracy=horizontal_accuracy, + live_period=live_period, + heading=heading, + proximity_alert_radius=proximity_alert_radius, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def reply_media_group( + self, + media: List[Union[InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo]], + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + allow_sending_without_reply: Optional[bool] = None, + **kwargs: Any, + ) -> SendMediaGroup: + """ + Shortcut for method :class:`aiogram.methods.send_media_group.SendMediaGroup` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send a group of photos, videos, documents or audios as an album. Documents and audio files can be only grouped in an album with messages of the same type. On success, an array of `Messages `_ that were sent is returned. + + Source: https://core.telegram.org/bots/api#sendmediagroup + + :param media: A JSON-serialized array describing messages to be sent, must include 2-10 items + :param disable_notification: Sends messages `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent messages from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_media_group.SendMediaGroup` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendMediaGroup + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendMediaGroup( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + media=media, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + allow_sending_without_reply=allow_sending_without_reply, + **kwargs, + ).as_(self._bot) + + def answer_media_group( + self, + media: List[Union[InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo]], + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendMediaGroup: + """ + Shortcut for method :class:`aiogram.methods.send_media_group.SendMediaGroup` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send a group of photos, videos, documents or audios as an album. Documents and audio files can be only grouped in an album with messages of the same type. On success, an array of `Messages `_ that were sent is returned. + + Source: https://core.telegram.org/bots/api#sendmediagroup + + :param media: A JSON-serialized array describing messages to be sent, must include 2-10 items + :param disable_notification: Sends messages `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent messages from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the messages are a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_media_group.SendMediaGroup` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendMediaGroup + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendMediaGroup( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + media=media, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def reply( + self, + text: str, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + entities: Optional[List[MessageEntity]] = None, + link_preview_options: Optional[Union[LinkPreviewOptions, Default]] = Default( + "link_preview" + ), + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + disable_web_page_preview: Optional[Union[bool, Default]] = Default( + "link_preview_is_disabled" + ), + **kwargs: Any, + ) -> SendMessage: + """ + Shortcut for method :class:`aiogram.methods.send_message.SendMessage` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send text messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendmessage + + :param text: Text of the message to be sent, 1-4096 characters after entities parsing + :param parse_mode: Mode for parsing entities in the message text. See `formatting options `_ for more details. + :param entities: A JSON-serialized list of special entities that appear in message text, which can be specified instead of *parse_mode* + :param link_preview_options: Link preview generation options for the message + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param disable_web_page_preview: Disables link previews for links in this message + :return: instance of method :class:`aiogram.methods.send_message.SendMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendMessage + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendMessage( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + text=text, + parse_mode=parse_mode, + entities=entities, + link_preview_options=link_preview_options, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + disable_web_page_preview=disable_web_page_preview, + **kwargs, + ).as_(self._bot) + + def answer( + self, + text: str, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + entities: Optional[List[MessageEntity]] = None, + link_preview_options: Optional[Union[LinkPreviewOptions, Default]] = Default( + "link_preview" + ), + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + disable_web_page_preview: Optional[Union[bool, Default]] = Default( + "link_preview_is_disabled" + ), + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendMessage: + """ + Shortcut for method :class:`aiogram.methods.send_message.SendMessage` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send text messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendmessage + + :param text: Text of the message to be sent, 1-4096 characters after entities parsing + :param parse_mode: Mode for parsing entities in the message text. See `formatting options `_ for more details. + :param entities: A JSON-serialized list of special entities that appear in message text, which can be specified instead of *parse_mode* + :param link_preview_options: Link preview generation options for the message + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param disable_web_page_preview: Disables link previews for links in this message + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_message.SendMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendMessage + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendMessage( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + text=text, + parse_mode=parse_mode, + entities=entities, + link_preview_options=link_preview_options, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + disable_web_page_preview=disable_web_page_preview, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def reply_photo( + self, + photo: Union[InputFile, str], + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + **kwargs: Any, + ) -> SendPhoto: + """ + Shortcut for method :class:`aiogram.methods.send_photo.SendPhoto` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send photos. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendphoto + + :param photo: Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data. The photo must be at most 10 MB in size. The photo's width and height must not exceed 10000 in total. Width and height ratio must be at most 20. :ref:`More information on Sending Files » ` + :param caption: Photo caption (may also be used when resending photos by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the photo caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the photo needs to be covered with a spoiler animation + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_photo.SendPhoto` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendPhoto + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendPhoto( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + photo=photo, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + **kwargs, + ).as_(self._bot) + + def answer_photo( + self, + photo: Union[InputFile, str], + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendPhoto: + """ + Shortcut for method :class:`aiogram.methods.send_photo.SendPhoto` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send photos. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendphoto + + :param photo: Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data. The photo must be at most 10 MB in size. The photo's width and height must not exceed 10000 in total. Width and height ratio must be at most 20. :ref:`More information on Sending Files » ` + :param caption: Photo caption (may also be used when resending photos by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the photo caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the photo needs to be covered with a spoiler animation + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_photo.SendPhoto` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendPhoto + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendPhoto( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + photo=photo, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def reply_poll( + self, + question: str, + options: List[Union[InputPollOption, str]], + question_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + question_entities: Optional[List[MessageEntity]] = None, + is_anonymous: Optional[bool] = None, + type: Optional[str] = None, + allows_multiple_answers: Optional[bool] = None, + correct_option_id: Optional[int] = None, + explanation: Optional[str] = None, + explanation_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + explanation_entities: Optional[List[MessageEntity]] = None, + open_period: Optional[int] = None, + close_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + is_closed: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + **kwargs: Any, + ) -> SendPoll: + """ + Shortcut for method :class:`aiogram.methods.send_poll.SendPoll` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send a native poll. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendpoll + + :param question: Poll question, 1-300 characters + :param options: A JSON-serialized list of 2-10 answer options + :param question_parse_mode: Mode for parsing entities in the question. See `formatting options `_ for more details. Currently, only custom emoji entities are allowed + :param question_entities: A JSON-serialized list of special entities that appear in the poll question. It can be specified instead of *question_parse_mode* + :param is_anonymous: :code:`True`, if the poll needs to be anonymous, defaults to :code:`True` + :param type: Poll type, 'quiz' or 'regular', defaults to 'regular' + :param allows_multiple_answers: :code:`True`, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to :code:`False` + :param correct_option_id: 0-based identifier of the correct answer option, required for polls in quiz mode + :param explanation: Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing + :param explanation_parse_mode: Mode for parsing entities in the explanation. See `formatting options `_ for more details. + :param explanation_entities: A JSON-serialized list of special entities that appear in the poll explanation. It can be specified instead of *explanation_parse_mode* + :param open_period: Amount of time in seconds the poll will be active after creation, 5-600. Can't be used together with *close_date*. + :param close_date: Point in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future. Can't be used together with *open_period*. + :param is_closed: Pass :code:`True` if the poll needs to be immediately closed. This can be useful for poll preview. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_poll.SendPoll` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendPoll + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendPoll( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + question=question, + options=options, + question_parse_mode=question_parse_mode, + question_entities=question_entities, + is_anonymous=is_anonymous, + type=type, + allows_multiple_answers=allows_multiple_answers, + correct_option_id=correct_option_id, + explanation=explanation, + explanation_parse_mode=explanation_parse_mode, + explanation_entities=explanation_entities, + open_period=open_period, + close_date=close_date, + is_closed=is_closed, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + **kwargs, + ).as_(self._bot) + + def answer_poll( + self, + question: str, + options: List[Union[InputPollOption, str]], + question_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + question_entities: Optional[List[MessageEntity]] = None, + is_anonymous: Optional[bool] = None, + type: Optional[str] = None, + allows_multiple_answers: Optional[bool] = None, + correct_option_id: Optional[int] = None, + explanation: Optional[str] = None, + explanation_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + explanation_entities: Optional[List[MessageEntity]] = None, + open_period: Optional[int] = None, + close_date: Optional[Union[datetime.datetime, datetime.timedelta, int]] = None, + is_closed: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendPoll: + """ + Shortcut for method :class:`aiogram.methods.send_poll.SendPoll` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send a native poll. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendpoll + + :param question: Poll question, 1-300 characters + :param options: A JSON-serialized list of 2-10 answer options + :param question_parse_mode: Mode for parsing entities in the question. See `formatting options `_ for more details. Currently, only custom emoji entities are allowed + :param question_entities: A JSON-serialized list of special entities that appear in the poll question. It can be specified instead of *question_parse_mode* + :param is_anonymous: :code:`True`, if the poll needs to be anonymous, defaults to :code:`True` + :param type: Poll type, 'quiz' or 'regular', defaults to 'regular' + :param allows_multiple_answers: :code:`True`, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to :code:`False` + :param correct_option_id: 0-based identifier of the correct answer option, required for polls in quiz mode + :param explanation: Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing + :param explanation_parse_mode: Mode for parsing entities in the explanation. See `formatting options `_ for more details. + :param explanation_entities: A JSON-serialized list of special entities that appear in the poll explanation. It can be specified instead of *explanation_parse_mode* + :param open_period: Amount of time in seconds the poll will be active after creation, 5-600. Can't be used together with *close_date*. + :param close_date: Point in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future. Can't be used together with *open_period*. + :param is_closed: Pass :code:`True` if the poll needs to be immediately closed. This can be useful for poll preview. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_poll.SendPoll` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendPoll + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendPoll( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + question=question, + options=options, + question_parse_mode=question_parse_mode, + question_entities=question_entities, + is_anonymous=is_anonymous, + type=type, + allows_multiple_answers=allows_multiple_answers, + correct_option_id=correct_option_id, + explanation=explanation, + explanation_parse_mode=explanation_parse_mode, + explanation_entities=explanation_entities, + open_period=open_period, + close_date=close_date, + is_closed=is_closed, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def reply_dice( + self, + emoji: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + **kwargs: Any, + ) -> SendDice: + """ + Shortcut for method :class:`aiogram.methods.send_dice.SendDice` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send an animated emoji that will display a random value. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#senddice + + :param emoji: Emoji on which the dice throw animation is based. Currently, must be one of '🎲', '🎯', '🏀', '⚽', '🎳', or '🎰'. Dice can have values 1-6 for '🎲', '🎯' and '🎳', values 1-5 for '🏀' and '⚽', and values 1-64 for '🎰'. Defaults to '🎲' + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_dice.SendDice` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendDice + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendDice( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + emoji=emoji, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + **kwargs, + ).as_(self._bot) + + def answer_dice( + self, + emoji: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendDice: + """ + Shortcut for method :class:`aiogram.methods.send_dice.SendDice` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send an animated emoji that will display a random value. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#senddice + + :param emoji: Emoji on which the dice throw animation is based. Currently, must be one of '🎲', '🎯', '🏀', '⚽', '🎳', or '🎰'. Dice can have values 1-6 for '🎲', '🎯' and '🎳', values 1-5 for '🏀' and '⚽', and values 1-64 for '🎰'. Defaults to '🎲' + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_dice.SendDice` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendDice + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendDice( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + emoji=emoji, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def reply_sticker( + self, + sticker: Union[InputFile, str], + emoji: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + **kwargs: Any, + ) -> SendSticker: + """ + Shortcut for method :class:`aiogram.methods.send_sticker.SendSticker` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send static .WEBP, `animated `_ .TGS, or `video `_ .WEBM stickers. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendsticker + + :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP, .TGS, or .WEBM sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video and animated stickers can't be sent via an HTTP URL. + :param emoji: Emoji associated with the sticker; only for just uploaded stickers + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_sticker.SendSticker` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendSticker + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendSticker( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + sticker=sticker, + emoji=emoji, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + **kwargs, + ).as_(self._bot) + + def answer_sticker( + self, + sticker: Union[InputFile, str], + emoji: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendSticker: + """ + Shortcut for method :class:`aiogram.methods.send_sticker.SendSticker` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send static .WEBP, `animated `_ .TGS, or `video `_ .WEBM stickers. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendsticker + + :param sticker: Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP, .TGS, or .WEBM sticker using multipart/form-data. :ref:`More information on Sending Files » `. Video and animated stickers can't be sent via an HTTP URL. + :param emoji: Emoji associated with the sticker; only for just uploaded stickers + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_sticker.SendSticker` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendSticker + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendSticker( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + sticker=sticker, + emoji=emoji, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def reply_venue( + self, + latitude: float, + longitude: float, + title: str, + address: str, + foursquare_id: Optional[str] = None, + foursquare_type: Optional[str] = None, + google_place_id: Optional[str] = None, + google_place_type: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + **kwargs: Any, + ) -> SendVenue: + """ + Shortcut for method :class:`aiogram.methods.send_venue.SendVenue` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send information about a venue. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvenue + + :param latitude: Latitude of the venue + :param longitude: Longitude of the venue + :param title: Name of the venue + :param address: Address of the venue + :param foursquare_id: Foursquare identifier of the venue + :param foursquare_type: Foursquare type of the venue, if known. (For example, 'arts_entertainment/default', 'arts_entertainment/aquarium' or 'food/icecream'.) + :param google_place_id: Google Places identifier of the venue + :param google_place_type: Google Places type of the venue. (See `supported types `_.) + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_venue.SendVenue` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVenue + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendVenue( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + latitude=latitude, + longitude=longitude, + title=title, + address=address, + foursquare_id=foursquare_id, + foursquare_type=foursquare_type, + google_place_id=google_place_id, + google_place_type=google_place_type, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + **kwargs, + ).as_(self._bot) + + def answer_venue( + self, + latitude: float, + longitude: float, + title: str, + address: str, + foursquare_id: Optional[str] = None, + foursquare_type: Optional[str] = None, + google_place_id: Optional[str] = None, + google_place_type: Optional[str] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendVenue: + """ + Shortcut for method :class:`aiogram.methods.send_venue.SendVenue` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send information about a venue. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvenue + + :param latitude: Latitude of the venue + :param longitude: Longitude of the venue + :param title: Name of the venue + :param address: Address of the venue + :param foursquare_id: Foursquare identifier of the venue + :param foursquare_type: Foursquare type of the venue, if known. (For example, 'arts_entertainment/default', 'arts_entertainment/aquarium' or 'food/icecream'.) + :param google_place_id: Google Places identifier of the venue + :param google_place_type: Google Places type of the venue. (See `supported types `_.) + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_venue.SendVenue` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVenue + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendVenue( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + latitude=latitude, + longitude=longitude, + title=title, + address=address, + foursquare_id=foursquare_id, + foursquare_type=foursquare_type, + google_place_id=google_place_id, + google_place_type=google_place_type, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def reply_video( + self, + video: Union[InputFile, str], + duration: Optional[int] = None, + width: Optional[int] = None, + height: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + supports_streaming: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + **kwargs: Any, + ) -> SendVideo: + """ + Shortcut for method :class:`aiogram.methods.send_video.SendVideo` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send video files, Telegram clients support MPEG4 videos (other formats may be sent as :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvideo + + :param video: Video to send. Pass a file_id as String to send a video that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a video from the Internet, or upload a new video using multipart/form-data. :ref:`More information on Sending Files » ` + :param duration: Duration of sent video in seconds + :param width: Video width + :param height: Video height + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Video caption (may also be used when resending videos by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the video caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the video needs to be covered with a spoiler animation + :param supports_streaming: Pass :code:`True` if the uploaded video is suitable for streaming + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_video.SendVideo` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVideo + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendVideo( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + video=video, + duration=duration, + width=width, + height=height, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + supports_streaming=supports_streaming, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + **kwargs, + ).as_(self._bot) + + def answer_video( + self, + video: Union[InputFile, str], + duration: Optional[int] = None, + width: Optional[int] = None, + height: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + has_spoiler: Optional[bool] = None, + supports_streaming: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendVideo: + """ + Shortcut for method :class:`aiogram.methods.send_video.SendVideo` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send video files, Telegram clients support MPEG4 videos (other formats may be sent as :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvideo + + :param video: Video to send. Pass a file_id as String to send a video that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a video from the Internet, or upload a new video using multipart/form-data. :ref:`More information on Sending Files » ` + :param duration: Duration of sent video in seconds + :param width: Video width + :param height: Video height + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param caption: Video caption (may also be used when resending videos by *file_id*), 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the video caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param has_spoiler: Pass :code:`True` if the video needs to be covered with a spoiler animation + :param supports_streaming: Pass :code:`True` if the uploaded video is suitable for streaming + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_video.SendVideo` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVideo + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendVideo( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + video=video, + duration=duration, + width=width, + height=height, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + has_spoiler=has_spoiler, + supports_streaming=supports_streaming, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def reply_video_note( + self, + video_note: Union[InputFile, str], + duration: Optional[int] = None, + length: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + **kwargs: Any, + ) -> SendVideoNote: + """ + Shortcut for method :class:`aiogram.methods.send_video_note.SendVideoNote` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + As of `v.4.0 `_, Telegram clients support rounded square MPEG4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvideonote + + :param video_note: Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data. :ref:`More information on Sending Files » `. Sending video notes by a URL is currently unsupported + :param duration: Duration of sent video in seconds + :param length: Video width and height, i.e. diameter of the video message + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_video_note.SendVideoNote` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVideoNote + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendVideoNote( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + video_note=video_note, + duration=duration, + length=length, + thumbnail=thumbnail, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + **kwargs, + ).as_(self._bot) + + def answer_video_note( + self, + video_note: Union[InputFile, str], + duration: Optional[int] = None, + length: Optional[int] = None, + thumbnail: Optional[InputFile] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendVideoNote: + """ + Shortcut for method :class:`aiogram.methods.send_video_note.SendVideoNote` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + As of `v.4.0 `_, Telegram clients support rounded square MPEG4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendvideonote + + :param video_note: Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data. :ref:`More information on Sending Files » `. Sending video notes by a URL is currently unsupported + :param duration: Duration of sent video in seconds + :param length: Video width and height, i.e. diameter of the video message + :param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://' if the thumbnail was uploaded using multipart/form-data under . :ref:`More information on Sending Files » ` + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_video_note.SendVideoNote` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVideoNote + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendVideoNote( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + video_note=video_note, + duration=duration, + length=length, + thumbnail=thumbnail, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def reply_voice( + self, + voice: Union[InputFile, str], + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + **kwargs: Any, + ) -> SendVoice: + """ + Shortcut for method :class:`aiogram.methods.send_voice.SendVoice` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send audio files, if you want Telegram clients to display the file as a playable voice message. For this to work, your audio must be in an .OGG file encoded with OPUS, or in .MP3 format, or in .M4A format (other formats may be sent as :class:`aiogram.types.audio.Audio` or :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send voice messages of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvoice + + :param voice: Audio file to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), 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 information on Sending Files » ` + :param caption: Voice message caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the voice message caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param duration: Duration of the voice message in seconds + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :return: instance of method :class:`aiogram.methods.send_voice.SendVoice` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVoice + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendVoice( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + voice=voice, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + duration=duration, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + **kwargs, + ).as_(self._bot) + + def answer_voice( + self, + voice: Union[InputFile, str], + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + message_effect_id: Optional[str] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> SendVoice: + """ + Shortcut for method :class:`aiogram.methods.send_voice.SendVoice` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send audio files, if you want Telegram clients to display the file as a playable voice message. For this to work, your audio must be in an .OGG file encoded with OPUS, or in .MP3 format, or in .M4A format (other formats may be sent as :class:`aiogram.types.audio.Audio` or :class:`aiogram.types.document.Document`). On success, the sent :class:`aiogram.types.message.Message` is returned. Bots can currently send voice messages of up to 50 MB in size, this limit may be changed in the future. + + Source: https://core.telegram.org/bots/api#sendvoice + + :param voice: Audio file to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), 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 information on Sending Files » ` + :param caption: Voice message caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the voice message caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param duration: Duration of the voice message in seconds + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.send_voice.SendVoice` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendVoice + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendVoice( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + voice=voice, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + duration=duration, + disable_notification=disable_notification, + protect_content=protect_content, + message_effect_id=message_effect_id, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def send_copy( # noqa: C901 + self: Message, + chat_id: Union[str, int], + disable_notification: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, None] = None, + allow_sending_without_reply: Optional[bool] = None, + message_thread_id: Optional[int] = None, + business_connection_id: Optional[str] = None, + parse_mode: Optional[str] = None, + message_effect_id: Optional[str] = None, + ) -> Union[ + ForwardMessage, + SendAnimation, + SendAudio, + SendContact, + SendDocument, + SendLocation, + SendMessage, + SendPhoto, + SendPoll, + SendDice, + SendSticker, + SendVenue, + SendVideo, + SendVideoNote, + SendVoice, + ]: + """ + Send copy of a message. + + Is similar to :meth:`aiogram.client.bot.Bot.copy_message` + but returning the sent message instead of :class:`aiogram.types.message_id.MessageId` + + .. note:: + + This method doesn't use the API method named `copyMessage` and + historically implemented before the similar method is added to API + + :param chat_id: + :param disable_notification: + :param reply_to_message_id: + :param reply_parameters: + :param reply_markup: + :param allow_sending_without_reply: + :param message_thread_id: + :param business_connection_id: + :param parse_mode: + :param message_effect_id: + :return: + """ + from ..methods import ( + ForwardMessage, + SendAnimation, + SendAudio, + SendContact, + SendDice, + SendDocument, + SendLocation, + SendMessage, + SendPhoto, + SendPoll, + SendSticker, + SendVenue, + SendVideo, + SendVideoNote, + SendVoice, + ) + + kwargs: Dict[str, Any] = { + "chat_id": chat_id, + "reply_markup": reply_markup or self.reply_markup, + "disable_notification": disable_notification, + "reply_to_message_id": reply_to_message_id, + "reply_parameters": reply_parameters, + "message_thread_id": message_thread_id, + "business_connection_id": business_connection_id, + "allow_sending_without_reply": allow_sending_without_reply, + # when sending a copy, we don't need any parse mode + # because all entities are already prepared + "parse_mode": parse_mode, + "message_effect_id": message_effect_id or self.effect_id, + } + + if self.text: + return SendMessage( + text=self.text, + entities=self.entities, + **kwargs, + ).as_(self._bot) + if self.audio: + return SendAudio( + audio=self.audio.file_id, + caption=self.caption, + title=self.audio.title, + performer=self.audio.performer, + duration=self.audio.duration, + caption_entities=self.caption_entities, + **kwargs, + ).as_(self._bot) + if self.animation: + return SendAnimation( + animation=self.animation.file_id, + caption=self.caption, + caption_entities=self.caption_entities, + **kwargs, + ).as_(self._bot) + if self.document: + return SendDocument( + document=self.document.file_id, + caption=self.caption, + caption_entities=self.caption_entities, + **kwargs, + ).as_(self._bot) + if self.photo: + return SendPhoto( + photo=self.photo[-1].file_id, + caption=self.caption, + caption_entities=self.caption_entities, + **kwargs, + ).as_(self._bot) + if self.sticker: + return SendSticker( + sticker=self.sticker.file_id, + **kwargs, + ).as_(self._bot) + if self.video: + return SendVideo( + video=self.video.file_id, + caption=self.caption, + caption_entities=self.caption_entities, + **kwargs, + ).as_(self._bot) + if self.video_note: + return SendVideoNote( + video_note=self.video_note.file_id, + **kwargs, + ).as_(self._bot) + if self.voice: + return SendVoice( + voice=self.voice.file_id, + **kwargs, + ).as_(self._bot) + if self.contact: + return SendContact( + phone_number=self.contact.phone_number, + first_name=self.contact.first_name, + last_name=self.contact.last_name, + vcard=self.contact.vcard, + **kwargs, + ).as_(self._bot) + if self.venue: + return SendVenue( + latitude=self.venue.location.latitude, + longitude=self.venue.location.longitude, + title=self.venue.title, + address=self.venue.address, + foursquare_id=self.venue.foursquare_id, + foursquare_type=self.venue.foursquare_type, + **kwargs, + ).as_(self._bot) + if self.location: + return SendLocation( + latitude=self.location.latitude, + longitude=self.location.longitude, + **kwargs, + ).as_(self._bot) + if self.poll: + from .input_poll_option import InputPollOption + + return SendPoll( + question=self.poll.question, + options=[ + InputPollOption( + text=option.text, + voter_count=option.voter_count, + text_entities=option.text_entities, + text_parse_mode=None, + ) + for option in self.poll.options + ], + **kwargs, + ).as_(self._bot) + if self.dice: # Dice value can't be controlled + return SendDice( + **kwargs, + ).as_(self._bot) + if self.story: + return ForwardMessage( + from_chat_id=self.chat.id, + message_id=self.message_id, + **kwargs, + ).as_(self._bot) + + raise TypeError("This type of message can't be copied.") + + def copy_to( + self, + chat_id: Union[int, str], + message_thread_id: Optional[int] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + allow_sending_without_reply: Optional[bool] = None, + reply_to_message_id: Optional[int] = None, + **kwargs: Any, + ) -> CopyMessage: + """ + Shortcut for method :class:`aiogram.methods.copy_message.CopyMessage` + will automatically fill method attributes: + + - :code:`from_chat_id` + - :code:`message_id` + + Use this method to copy messages of any kind. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz :class:`aiogram.methods.poll.Poll` can be copied only if the value of the field *correct_option_id* is known to the bot. The method is analogous to the method :class:`aiogram.methods.forward_message.ForwardMessage`, but the copied message doesn't have a link to the original message. Returns the :class:`aiogram.types.message_id.MessageId` of the sent message on success. + + Source: https://core.telegram.org/bots/api#copymessage + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param caption: New caption for media, 0-1024 characters after entities parsing. If not specified, the original caption is kept + :param parse_mode: Mode for parsing entities in the new caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the new caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media. Ignored if a new caption isn't specified. + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found + :param reply_to_message_id: If the message is a reply, ID of the original message + :return: instance of method :class:`aiogram.methods.copy_message.CopyMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import CopyMessage + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return CopyMessage( + from_chat_id=self.chat.id, + message_id=self.message_id, + chat_id=chat_id, + message_thread_id=message_thread_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + disable_notification=disable_notification, + protect_content=protect_content, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + allow_sending_without_reply=allow_sending_without_reply, + reply_to_message_id=reply_to_message_id, + **kwargs, + ).as_(self._bot) + + def edit_text( + self, + text: str, + business_connection_id: Optional[str] = None, + inline_message_id: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + entities: Optional[List[MessageEntity]] = None, + link_preview_options: Optional[LinkPreviewOptions] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + disable_web_page_preview: Optional[Union[bool, Default]] = Default( + "link_preview_is_disabled" + ), + **kwargs: Any, + ) -> EditMessageText: + """ + Shortcut for method :class:`aiogram.methods.edit_message_text.EditMessageText` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to edit text and `game `_ messages. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + + Source: https://core.telegram.org/bots/api#editmessagetext + + :param text: New text of the message, 1-4096 characters after entities parsing + :param business_connection_id: Unique identifier of the business connection on behalf of which the message to be edited was sent + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param parse_mode: Mode for parsing entities in the message text. See `formatting options `_ for more details. + :param entities: A JSON-serialized list of special entities that appear in message text, which can be specified instead of *parse_mode* + :param link_preview_options: Link preview generation options for the message + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. + :param disable_web_page_preview: Disables link previews for links in this message + :return: instance of method :class:`aiogram.methods.edit_message_text.EditMessageText` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import EditMessageText + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return EditMessageText( + chat_id=self.chat.id, + message_id=self.message_id, + text=text, + business_connection_id=business_connection_id, + inline_message_id=inline_message_id, + parse_mode=parse_mode, + entities=entities, + link_preview_options=link_preview_options, + reply_markup=reply_markup, + disable_web_page_preview=disable_web_page_preview, + **kwargs, + ).as_(self._bot) + + def forward( + self, + chat_id: Union[int, str], + message_thread_id: Optional[int] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[Union[bool, Default]] = Default("protect_content"), + **kwargs: Any, + ) -> ForwardMessage: + """ + Shortcut for method :class:`aiogram.methods.forward_message.ForwardMessage` + will automatically fill method attributes: + + - :code:`from_chat_id` + - :code:`message_id` + + Use this method to forward messages of any kind. Service messages and messages with protected content can't be forwarded. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#forwardmessage + + :param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`) + :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the forwarded message from forwarding and saving + :return: instance of method :class:`aiogram.methods.forward_message.ForwardMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import ForwardMessage + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return ForwardMessage( + from_chat_id=self.chat.id, + message_id=self.message_id, + chat_id=chat_id, + message_thread_id=message_thread_id, + disable_notification=disable_notification, + protect_content=protect_content, + **kwargs, + ).as_(self._bot) + + def edit_media( + self, + media: Union[ + InputMediaAnimation, + InputMediaDocument, + InputMediaAudio, + InputMediaPhoto, + InputMediaVideo, + ], + business_connection_id: Optional[str] = None, + inline_message_id: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + **kwargs: Any, + ) -> EditMessageMedia: + """ + Shortcut for method :class:`aiogram.methods.edit_message_media.EditMessageMedia` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to edit animation, audio, document, photo, or video messages. If a message is part of a message album, then it can be edited only to an audio for audio albums, only to a document for document albums and to a photo or a video otherwise. When an inline message is edited, a new file can't be uploaded; use a previously uploaded file via its file_id or specify a URL. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + + Source: https://core.telegram.org/bots/api#editmessagemedia + + :param media: A JSON-serialized object for a new media content of the message + :param business_connection_id: Unique identifier of the business connection on behalf of which the message to be edited was sent + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param reply_markup: A JSON-serialized object for a new `inline keyboard `_. + :return: instance of method :class:`aiogram.methods.edit_message_media.EditMessageMedia` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import EditMessageMedia + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return EditMessageMedia( + chat_id=self.chat.id, + message_id=self.message_id, + media=media, + business_connection_id=business_connection_id, + inline_message_id=inline_message_id, + reply_markup=reply_markup, + **kwargs, + ).as_(self._bot) + + def edit_reply_markup( + self, + business_connection_id: Optional[str] = None, + inline_message_id: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + **kwargs: Any, + ) -> EditMessageReplyMarkup: + """ + Shortcut for method :class:`aiogram.methods.edit_message_reply_markup.EditMessageReplyMarkup` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to edit only the reply markup of messages. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + + Source: https://core.telegram.org/bots/api#editmessagereplymarkup + + :param business_connection_id: Unique identifier of the business connection on behalf of which the message to be edited was sent + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. + :return: instance of method :class:`aiogram.methods.edit_message_reply_markup.EditMessageReplyMarkup` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import EditMessageReplyMarkup + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return EditMessageReplyMarkup( + chat_id=self.chat.id, + message_id=self.message_id, + business_connection_id=business_connection_id, + inline_message_id=inline_message_id, + reply_markup=reply_markup, + **kwargs, + ).as_(self._bot) + + def delete_reply_markup( + self, + business_connection_id: Optional[str] = None, + inline_message_id: Optional[str] = None, + **kwargs: Any, + ) -> EditMessageReplyMarkup: + """ + Shortcut for method :class:`aiogram.methods.edit_message_reply_markup.EditMessageReplyMarkup` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + - :code:`reply_markup` + + Use this method to edit only the reply markup of messages. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + + Source: https://core.telegram.org/bots/api#editmessagereplymarkup + + :param business_connection_id: Unique identifier of the business connection on behalf of which the message to be edited was sent + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :return: instance of method :class:`aiogram.methods.edit_message_reply_markup.EditMessageReplyMarkup` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import EditMessageReplyMarkup + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return EditMessageReplyMarkup( + chat_id=self.chat.id, + message_id=self.message_id, + reply_markup=None, + business_connection_id=business_connection_id, + inline_message_id=inline_message_id, + **kwargs, + ).as_(self._bot) + + def edit_live_location( + self, + latitude: float, + longitude: float, + business_connection_id: Optional[str] = None, + inline_message_id: Optional[str] = None, + live_period: Optional[int] = None, + horizontal_accuracy: Optional[float] = None, + heading: Optional[int] = None, + proximity_alert_radius: Optional[int] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + **kwargs: Any, + ) -> EditMessageLiveLocation: + """ + Shortcut for method :class:`aiogram.methods.edit_message_live_location.EditMessageLiveLocation` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to edit live location messages. A location can be edited until its *live_period* expires or editing is explicitly disabled by a call to :class:`aiogram.methods.stop_message_live_location.StopMessageLiveLocation`. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. + + Source: https://core.telegram.org/bots/api#editmessagelivelocation + + :param latitude: Latitude of new location + :param longitude: Longitude of new location + :param business_connection_id: Unique identifier of the business connection on behalf of which the message to be edited was sent + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param live_period: New period in seconds during which the location can be updated, starting from the message send date. If 0x7FFFFFFF is specified, then the location can be updated forever. Otherwise, the new value must not exceed the current *live_period* by more than a day, and the live location expiration date must remain within the next 90 days. If not specified, then *live_period* remains unchanged + :param horizontal_accuracy: The radius of uncertainty for the location, measured in meters; 0-1500 + :param heading: Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified. + :param proximity_alert_radius: The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified. + :param reply_markup: A JSON-serialized object for a new `inline keyboard `_. + :return: instance of method :class:`aiogram.methods.edit_message_live_location.EditMessageLiveLocation` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import EditMessageLiveLocation + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return EditMessageLiveLocation( + chat_id=self.chat.id, + message_id=self.message_id, + latitude=latitude, + longitude=longitude, + business_connection_id=business_connection_id, + inline_message_id=inline_message_id, + live_period=live_period, + horizontal_accuracy=horizontal_accuracy, + heading=heading, + proximity_alert_radius=proximity_alert_radius, + reply_markup=reply_markup, + **kwargs, + ).as_(self._bot) + + def stop_live_location( + self, + business_connection_id: Optional[str] = None, + inline_message_id: Optional[str] = None, + reply_markup: Optional[InlineKeyboardMarkup] = None, + **kwargs: Any, + ) -> StopMessageLiveLocation: + """ + Shortcut for method :class:`aiogram.methods.stop_message_live_location.StopMessageLiveLocation` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to stop updating a live location message before *live_period* expires. On success, if the message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. + + Source: https://core.telegram.org/bots/api#stopmessagelivelocation + + :param business_connection_id: Unique identifier of the business connection on behalf of which the message to be edited was sent + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param reply_markup: A JSON-serialized object for a new `inline keyboard `_. + :return: instance of method :class:`aiogram.methods.stop_message_live_location.StopMessageLiveLocation` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import StopMessageLiveLocation + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return StopMessageLiveLocation( + chat_id=self.chat.id, + message_id=self.message_id, + business_connection_id=business_connection_id, + inline_message_id=inline_message_id, + reply_markup=reply_markup, + **kwargs, + ).as_(self._bot) + + def edit_caption( + self, + business_connection_id: Optional[str] = None, + inline_message_id: Optional[str] = None, + caption: Optional[str] = None, + parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[Union[bool, Default]] = Default( + "show_caption_above_media" + ), + reply_markup: Optional[InlineKeyboardMarkup] = None, + **kwargs: Any, + ) -> EditMessageCaption: + """ + Shortcut for method :class:`aiogram.methods.edit_message_caption.EditMessageCaption` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to edit captions of messages. On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within **48 hours** from the time they were sent. + + Source: https://core.telegram.org/bots/api#editmessagecaption + + :param business_connection_id: Unique identifier of the business connection on behalf of which the message to be edited was sent + :param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message + :param caption: New caption of the message, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the message caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media. Supported only for animation, photo and video messages. + :param reply_markup: A JSON-serialized object for an `inline keyboard `_. + :return: instance of method :class:`aiogram.methods.edit_message_caption.EditMessageCaption` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import EditMessageCaption + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return EditMessageCaption( + chat_id=self.chat.id, + message_id=self.message_id, + business_connection_id=business_connection_id, + inline_message_id=inline_message_id, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + reply_markup=reply_markup, + **kwargs, + ).as_(self._bot) + + def delete( + self, + **kwargs: Any, + ) -> DeleteMessage: + """ + Shortcut for method :class:`aiogram.methods.delete_message.DeleteMessage` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to delete a message, including service messages, with the following limitations: + + - A message can only be deleted if it was sent less than 48 hours ago. + + - Service messages about a supergroup, channel, or forum topic creation can't be deleted. + + - A dice message in a private chat can only be deleted if it was sent more than 24 hours ago. + + - Bots can delete outgoing messages in private chats, groups, and supergroups. + + - Bots can delete incoming messages in private chats. + + - Bots granted *can_post_messages* permissions can delete outgoing messages in channels. + + - If the bot is an administrator of a group, it can delete any message there. + + - If the bot has *can_delete_messages* permission in a supergroup or a channel, it can delete any message there. + + Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletemessage + + :return: instance of method :class:`aiogram.methods.delete_message.DeleteMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import DeleteMessage + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return DeleteMessage( + chat_id=self.chat.id, + message_id=self.message_id, + **kwargs, + ).as_(self._bot) + + def pin( + self, + business_connection_id: Optional[str] = None, + disable_notification: Optional[bool] = None, + **kwargs: Any, + ) -> PinChatMessage: + """ + Shortcut for method :class:`aiogram.methods.pin_chat_message.PinChatMessage` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to add a message to the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' administrator right in a supergroup or 'can_edit_messages' administrator right in a channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#pinchatmessage + + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be pinned + :param disable_notification: Pass :code:`True` if it is not necessary to send a notification to all chat members about the new pinned message. Notifications are always disabled in channels and private chats. + :return: instance of method :class:`aiogram.methods.pin_chat_message.PinChatMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import PinChatMessage + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return PinChatMessage( + chat_id=self.chat.id, + message_id=self.message_id, + business_connection_id=business_connection_id, + disable_notification=disable_notification, + **kwargs, + ).as_(self._bot) + + def unpin( + self, + business_connection_id: Optional[str] = None, + **kwargs: Any, + ) -> UnpinChatMessage: + """ + Shortcut for method :class:`aiogram.methods.unpin_chat_message.UnpinChatMessage` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to remove a message from the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' administrator right in a supergroup or 'can_edit_messages' administrator right in a channel. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#unpinchatmessage + + :param business_connection_id: Unique identifier of the business connection on behalf of which the message will be unpinned + :return: instance of method :class:`aiogram.methods.unpin_chat_message.UnpinChatMessage` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import UnpinChatMessage + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return UnpinChatMessage( + chat_id=self.chat.id, + message_id=self.message_id, + business_connection_id=business_connection_id, + **kwargs, + ).as_(self._bot) + + def get_url( + self, force_private: bool = False, include_thread_id: bool = False + ) -> Optional[str]: + """ + Returns message URL. Cannot be used in private (one-to-one) chats. + If chat has a username, returns URL like https://t.me/username/message_id + Otherwise (or if {force_private} flag is set), returns https://t.me/c/shifted_chat_id/message_id + + :param force_private: if set, a private URL is returned even for a public chat + :param include_thread_id: if set, adds chat thread id to URL and returns like https://t.me/username/thread_id/message_id + :return: string with full message URL + """ + if self.chat.type in ("private", "group"): + return None + + chat_value = ( + f"c/{self.chat.shifted_id}" + if not self.chat.username or force_private + else self.chat.username + ) + + message_id_value = ( + f"{self.message_thread_id}/{self.message_id}" + if include_thread_id and self.message_thread_id and self.is_topic_message + else f"{self.message_id}" + ) + + return f"https://t.me/{chat_value}/{message_id_value}" + + def react( + self, + reaction: Optional[ + List[Union[ReactionTypeEmoji, ReactionTypeCustomEmoji, ReactionTypePaid]] + ] = None, + is_big: Optional[bool] = None, + **kwargs: Any, + ) -> SetMessageReaction: + """ + Shortcut for method :class:`aiogram.methods.set_message_reaction.SetMessageReaction` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_id` + + Use this method to change the chosen reactions on a message. Service messages can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. Bots can't use paid reactions. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setmessagereaction + + :param reaction: A JSON-serialized list of reaction types to set on the message. Currently, as non-premium users, bots can set up to one reaction per message. A custom emoji reaction can be used if it is either already present on the message or explicitly allowed by chat administrators. Paid reactions can't be used by bots. + :param is_big: Pass :code:`True` to set the reaction with a big animation + :return: instance of method :class:`aiogram.methods.set_message_reaction.SetMessageReaction` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SetMessageReaction + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SetMessageReaction( + chat_id=self.chat.id, + message_id=self.message_id, + reaction=reaction, + is_big=is_big, + **kwargs, + ).as_(self._bot) + + def answer_paid_media( + self, + star_count: int, + media: List[Union[InputPaidMediaPhoto, InputPaidMediaVideo]], + caption: Optional[str] = None, + parse_mode: Optional[str] = None, + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_parameters: Optional[ReplyParameters] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + **kwargs: Any, + ) -> SendPaidMedia: + """ + Shortcut for method :class:`aiogram.methods.send_paid_media.SendPaidMedia` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + + Use this method to send paid media. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendpaidmedia + + :param star_count: The number of Telegram Stars that must be paid to buy access to the media + :param media: A JSON-serialized array describing the media to be sent; up to 10 items + :param caption: Media caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the media caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param reply_parameters: Description of the message to reply to + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :return: instance of method :class:`aiogram.methods.send_paid_media.SendPaidMedia` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendPaidMedia + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendPaidMedia( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + star_count=star_count, + media=media, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + disable_notification=disable_notification, + protect_content=protect_content, + reply_parameters=reply_parameters, + reply_markup=reply_markup, + **kwargs, + ).as_(self._bot) + + def reply_paid_media( + self, + star_count: int, + media: List[Union[InputPaidMediaPhoto, InputPaidMediaVideo]], + caption: Optional[str] = None, + parse_mode: Optional[str] = None, + caption_entities: Optional[List[MessageEntity]] = None, + show_caption_above_media: Optional[bool] = None, + disable_notification: Optional[bool] = None, + protect_content: Optional[bool] = None, + reply_markup: Optional[ + Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply] + ] = None, + **kwargs: Any, + ) -> SendPaidMedia: + """ + Shortcut for method :class:`aiogram.methods.send_paid_media.SendPaidMedia` + will automatically fill method attributes: + + - :code:`chat_id` + - :code:`message_thread_id` + - :code:`business_connection_id` + - :code:`reply_parameters` + + Use this method to send paid media. On success, the sent :class:`aiogram.types.message.Message` is returned. + + Source: https://core.telegram.org/bots/api#sendpaidmedia + + :param star_count: The number of Telegram Stars that must be paid to buy access to the media + :param media: A JSON-serialized array describing the media to be sent; up to 10 items + :param caption: Media caption, 0-1024 characters after entities parsing + :param parse_mode: Mode for parsing entities in the media caption. See `formatting options `_ for more details. + :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of *parse_mode* + :param show_caption_above_media: Pass :code:`True`, if the caption must be shown above the message media + :param disable_notification: Sends the message `silently `_. Users will receive a notification with no sound. + :param protect_content: Protects the contents of the sent message from forwarding and saving + :param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard `_, `custom reply keyboard `_, instructions to remove a reply keyboard or to force a reply from the user + :return: instance of method :class:`aiogram.methods.send_paid_media.SendPaidMedia` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SendPaidMedia + + assert ( + self.chat is not None + ), "This method can be used only if chat is present in the message." + + return SendPaidMedia( + chat_id=self.chat.id, + message_thread_id=self.message_thread_id if self.is_topic_message else None, + business_connection_id=self.business_connection_id, + reply_parameters=self.as_reply_parameters(), + star_count=star_count, + media=media, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + show_caption_above_media=show_caption_above_media, + disable_notification=disable_notification, + protect_content=protect_content, + reply_markup=reply_markup, + **kwargs, + ).as_(self._bot) diff --git a/env/Lib/site-packages/aiogram/types/message_auto_delete_timer_changed.py b/env/Lib/site-packages/aiogram/types/message_auto_delete_timer_changed.py new file mode 100644 index 0000000..8414a24 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/message_auto_delete_timer_changed.py @@ -0,0 +1,31 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + + +class MessageAutoDeleteTimerChanged(TelegramObject): + """ + This object represents a service message about a change in auto-delete timer settings. + + Source: https://core.telegram.org/bots/api#messageautodeletetimerchanged + """ + + message_auto_delete_time: int + """New auto-delete time for messages in the chat; in seconds""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, message_auto_delete_time: int, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + message_auto_delete_time=message_auto_delete_time, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/message_entity.py b/env/Lib/site-packages/aiogram/types/message_entity.py new file mode 100644 index 0000000..ee774b0 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/message_entity.py @@ -0,0 +1,68 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from ..utils.text_decorations import add_surrogates, remove_surrogates +from .base import MutableTelegramObject + +if TYPE_CHECKING: + from .user import User + + +class MessageEntity(MutableTelegramObject): + """ + This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc. + + Source: https://core.telegram.org/bots/api#messageentity + """ + + type: str + """Type of the entity. Currently, can be 'mention' (:code:`@username`), 'hashtag' (:code:`#hashtag`), 'cashtag' (:code:`$USD`), 'bot_command' (:code:`/start@jobs_bot`), 'url' (:code:`https://telegram.org`), 'email' (:code:`do-not-reply@telegram.org`), 'phone_number' (:code:`+1-212-555-0123`), 'bold' (**bold text**), 'italic' (*italic text*), 'underline' (underlined text), 'strikethrough' (strikethrough text), 'spoiler' (spoiler message), 'blockquote' (block quotation), 'expandable_blockquote' (collapsed-by-default block quotation), 'code' (monowidth string), 'pre' (monowidth block), 'text_link' (for clickable text URLs), 'text_mention' (for users `without usernames `_), 'custom_emoji' (for inline custom emoji stickers)""" + offset: int + """Offset in `UTF-16 code units `_ to the start of the entity""" + length: int + """Length of the entity in `UTF-16 code units `_""" + url: Optional[str] = None + """*Optional*. For 'text_link' only, URL that will be opened after user taps on the text""" + user: Optional[User] = None + """*Optional*. For 'text_mention' only, the mentioned user""" + language: Optional[str] = None + """*Optional*. For 'pre' only, the programming language of the entity text""" + custom_emoji_id: Optional[str] = None + """*Optional*. For 'custom_emoji' only, unique identifier of the custom emoji. Use :class:`aiogram.methods.get_custom_emoji_stickers.GetCustomEmojiStickers` to get full information about the sticker""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: str, + offset: int, + length: int, + url: Optional[str] = None, + user: Optional[User] = None, + language: Optional[str] = None, + custom_emoji_id: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + offset=offset, + length=length, + url=url, + user=user, + language=language, + custom_emoji_id=custom_emoji_id, + **__pydantic_kwargs, + ) + + def extract_from(self, text: str) -> str: + return remove_surrogates( + add_surrogates(text)[self.offset * 2 : (self.offset + self.length) * 2] + ) diff --git a/env/Lib/site-packages/aiogram/types/message_id.py b/env/Lib/site-packages/aiogram/types/message_id.py new file mode 100644 index 0000000..d50888f --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/message_id.py @@ -0,0 +1,27 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + + +class MessageId(TelegramObject): + """ + This object represents a unique message identifier. + + Source: https://core.telegram.org/bots/api#messageid + """ + + message_id: int + """Unique message identifier""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__(__pydantic__self__, *, message_id: int, **__pydantic_kwargs: Any) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(message_id=message_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/message_origin.py b/env/Lib/site-packages/aiogram/types/message_origin.py new file mode 100644 index 0000000..01f9977 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/message_origin.py @@ -0,0 +1,14 @@ +from aiogram.types import TelegramObject + + +class MessageOrigin(TelegramObject): + """ + This object describes the origin of a message. It can be one of + + - :class:`aiogram.types.message_origin_user.MessageOriginUser` + - :class:`aiogram.types.message_origin_hidden_user.MessageOriginHiddenUser` + - :class:`aiogram.types.message_origin_chat.MessageOriginChat` + - :class:`aiogram.types.message_origin_channel.MessageOriginChannel` + + Source: https://core.telegram.org/bots/api#messageorigin + """ diff --git a/env/Lib/site-packages/aiogram/types/message_origin_channel.py b/env/Lib/site-packages/aiogram/types/message_origin_channel.py new file mode 100644 index 0000000..9decfaf --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/message_origin_channel.py @@ -0,0 +1,56 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional + +from ..enums import MessageOriginType +from .custom import DateTime +from .message_origin import MessageOrigin + +if TYPE_CHECKING: + from .chat import Chat + + +class MessageOriginChannel(MessageOrigin): + """ + The message was originally sent to a channel chat. + + Source: https://core.telegram.org/bots/api#messageoriginchannel + """ + + type: Literal[MessageOriginType.CHANNEL] = MessageOriginType.CHANNEL + """Type of the message origin, always 'channel'""" + date: DateTime + """Date the message was sent originally in Unix time""" + chat: Chat + """Channel chat to which the message was originally sent""" + message_id: int + """Unique message identifier inside the chat""" + author_signature: Optional[str] = None + """*Optional*. Signature of the original post author""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[MessageOriginType.CHANNEL] = MessageOriginType.CHANNEL, + date: DateTime, + chat: Chat, + message_id: int, + author_signature: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + date=date, + chat=chat, + message_id=message_id, + author_signature=author_signature, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/message_origin_chat.py b/env/Lib/site-packages/aiogram/types/message_origin_chat.py new file mode 100644 index 0000000..b1e5fb9 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/message_origin_chat.py @@ -0,0 +1,52 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional + +from ..enums import MessageOriginType +from .custom import DateTime +from .message_origin import MessageOrigin + +if TYPE_CHECKING: + from .chat import Chat + + +class MessageOriginChat(MessageOrigin): + """ + The message was originally sent on behalf of a chat to a group chat. + + Source: https://core.telegram.org/bots/api#messageoriginchat + """ + + type: Literal[MessageOriginType.CHAT] = MessageOriginType.CHAT + """Type of the message origin, always 'chat'""" + date: DateTime + """Date the message was sent originally in Unix time""" + sender_chat: Chat + """Chat that sent the message originally""" + author_signature: Optional[str] = None + """*Optional*. For messages originally sent by an anonymous chat administrator, original message author signature""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[MessageOriginType.CHAT] = MessageOriginType.CHAT, + date: DateTime, + sender_chat: Chat, + author_signature: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + date=date, + sender_chat=sender_chat, + author_signature=author_signature, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/message_origin_hidden_user.py b/env/Lib/site-packages/aiogram/types/message_origin_hidden_user.py new file mode 100644 index 0000000..cd702f1 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/message_origin_hidden_user.py @@ -0,0 +1,40 @@ +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import MessageOriginType +from .custom import DateTime +from .message_origin import MessageOrigin + + +class MessageOriginHiddenUser(MessageOrigin): + """ + The message was originally sent by an unknown user. + + Source: https://core.telegram.org/bots/api#messageoriginhiddenuser + """ + + type: Literal[MessageOriginType.HIDDEN_USER] = MessageOriginType.HIDDEN_USER + """Type of the message origin, always 'hidden_user'""" + date: DateTime + """Date the message was sent originally in Unix time""" + sender_user_name: str + """Name of the user that sent the message originally""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[MessageOriginType.HIDDEN_USER] = MessageOriginType.HIDDEN_USER, + date: DateTime, + sender_user_name: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, date=date, sender_user_name=sender_user_name, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/message_origin_user.py b/env/Lib/site-packages/aiogram/types/message_origin_user.py new file mode 100644 index 0000000..d77ac7a --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/message_origin_user.py @@ -0,0 +1,43 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import MessageOriginType +from .custom import DateTime +from .message_origin import MessageOrigin + +if TYPE_CHECKING: + from .user import User + + +class MessageOriginUser(MessageOrigin): + """ + The message was originally sent by a known user. + + Source: https://core.telegram.org/bots/api#messageoriginuser + """ + + type: Literal[MessageOriginType.USER] = MessageOriginType.USER + """Type of the message origin, always 'user'""" + date: DateTime + """Date the message was sent originally in Unix time""" + sender_user: User + """User that sent the message originally""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[MessageOriginType.USER] = MessageOriginType.USER, + date: DateTime, + sender_user: User, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, date=date, sender_user=sender_user, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/message_reaction_count_updated.py b/env/Lib/site-packages/aiogram/types/message_reaction_count_updated.py new file mode 100644 index 0000000..e9d0f8b --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/message_reaction_count_updated.py @@ -0,0 +1,52 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List + +from .base import TelegramObject + +if TYPE_CHECKING: + from .chat import Chat + from .custom import DateTime + from .reaction_count import ReactionCount + + +class MessageReactionCountUpdated(TelegramObject): + """ + This object represents reaction changes on a message with anonymous reactions. + + Source: https://core.telegram.org/bots/api#messagereactioncountupdated + """ + + chat: Chat + """The chat containing the message""" + message_id: int + """Unique message identifier inside the chat""" + date: DateTime + """Date of the change in Unix time""" + reactions: List[ReactionCount] + """List of reactions that are present on the message""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat: Chat, + message_id: int, + date: DateTime, + reactions: List[ReactionCount], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat=chat, + message_id=message_id, + date=date, + reactions=reactions, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/message_reaction_updated.py b/env/Lib/site-packages/aiogram/types/message_reaction_updated.py new file mode 100644 index 0000000..7831c77 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/message_reaction_updated.py @@ -0,0 +1,71 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from .base import TelegramObject + +if TYPE_CHECKING: + from .chat import Chat + from .custom import DateTime + from .reaction_type_custom_emoji import ReactionTypeCustomEmoji + from .reaction_type_emoji import ReactionTypeEmoji + from .reaction_type_paid import ReactionTypePaid + from .user import User + + +class MessageReactionUpdated(TelegramObject): + """ + This object represents a change of a reaction on a message performed by a user. + + Source: https://core.telegram.org/bots/api#messagereactionupdated + """ + + chat: Chat + """The chat containing the message the user reacted to""" + message_id: int + """Unique identifier of the message inside the chat""" + date: DateTime + """Date of the change in Unix time""" + old_reaction: List[Union[ReactionTypeEmoji, ReactionTypeCustomEmoji, ReactionTypePaid]] + """Previous list of reaction types that were set by the user""" + new_reaction: List[Union[ReactionTypeEmoji, ReactionTypeCustomEmoji, ReactionTypePaid]] + """New list of reaction types that have been set by the user""" + user: Optional[User] = None + """*Optional*. The user that changed the reaction, if the user isn't anonymous""" + actor_chat: Optional[Chat] = None + """*Optional*. The chat on behalf of which the reaction was changed, if the user is anonymous""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + chat: Chat, + message_id: int, + date: DateTime, + old_reaction: List[ + Union[ReactionTypeEmoji, ReactionTypeCustomEmoji, ReactionTypePaid] + ], + new_reaction: List[ + Union[ReactionTypeEmoji, ReactionTypeCustomEmoji, ReactionTypePaid] + ], + user: Optional[User] = None, + actor_chat: Optional[Chat] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + chat=chat, + message_id=message_id, + date=date, + old_reaction=old_reaction, + new_reaction=new_reaction, + user=user, + actor_chat=actor_chat, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/order_info.py b/env/Lib/site-packages/aiogram/types/order_info.py new file mode 100644 index 0000000..5d71f65 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/order_info.py @@ -0,0 +1,50 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .shipping_address import ShippingAddress + + +class OrderInfo(TelegramObject): + """ + This object represents information about an order. + + Source: https://core.telegram.org/bots/api#orderinfo + """ + + name: Optional[str] = None + """*Optional*. User name""" + phone_number: Optional[str] = None + """*Optional*. User's phone number""" + email: Optional[str] = None + """*Optional*. User email""" + shipping_address: Optional[ShippingAddress] = None + """*Optional*. User shipping address""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + name: Optional[str] = None, + phone_number: Optional[str] = None, + email: Optional[str] = None, + shipping_address: Optional[ShippingAddress] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + name=name, + phone_number=phone_number, + email=email, + shipping_address=shipping_address, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/paid_media.py b/env/Lib/site-packages/aiogram/types/paid_media.py new file mode 100644 index 0000000..d17c44d --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/paid_media.py @@ -0,0 +1,13 @@ +from .base import TelegramObject + + +class PaidMedia(TelegramObject): + """ + This object describes paid media. Currently, it can be one of + + - :class:`aiogram.types.paid_media_preview.PaidMediaPreview` + - :class:`aiogram.types.paid_media_photo.PaidMediaPhoto` + - :class:`aiogram.types.paid_media_video.PaidMediaVideo` + + Source: https://core.telegram.org/bots/api#paidmedia + """ diff --git a/env/Lib/site-packages/aiogram/types/paid_media_info.py b/env/Lib/site-packages/aiogram/types/paid_media_info.py new file mode 100644 index 0000000..db5bbf0 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/paid_media_info.py @@ -0,0 +1,40 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Union + +from .base import TelegramObject + +if TYPE_CHECKING: + from .paid_media_photo import PaidMediaPhoto + from .paid_media_preview import PaidMediaPreview + from .paid_media_video import PaidMediaVideo + + +class PaidMediaInfo(TelegramObject): + """ + Describes the paid media added to a message. + + Source: https://core.telegram.org/bots/api#paidmediainfo + """ + + star_count: int + """The number of Telegram Stars that must be paid to buy access to the media""" + paid_media: List[Union[PaidMediaPreview, PaidMediaPhoto, PaidMediaVideo]] + """Information about the paid media""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + star_count: int, + paid_media: List[Union[PaidMediaPreview, PaidMediaPhoto, PaidMediaVideo]], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(star_count=star_count, paid_media=paid_media, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/paid_media_photo.py b/env/Lib/site-packages/aiogram/types/paid_media_photo.py new file mode 100644 index 0000000..71c2e10 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/paid_media_photo.py @@ -0,0 +1,39 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal + +from ..enums import PaidMediaType +from .paid_media import PaidMedia + +if TYPE_CHECKING: + from .photo_size import PhotoSize + + +class PaidMediaPhoto(PaidMedia): + """ + The paid media is a photo. + + Source: https://core.telegram.org/bots/api#paidmediaphoto + """ + + type: Literal[PaidMediaType.PHOTO] = PaidMediaType.PHOTO + """Type of the paid media, always 'photo'""" + photo: List[PhotoSize] + """The photo""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[PaidMediaType.PHOTO] = PaidMediaType.PHOTO, + photo: List[PhotoSize], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, photo=photo, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/paid_media_preview.py b/env/Lib/site-packages/aiogram/types/paid_media_preview.py new file mode 100644 index 0000000..5054de2 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/paid_media_preview.py @@ -0,0 +1,44 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional + +from ..enums import PaidMediaType +from .paid_media import PaidMedia + + +class PaidMediaPreview(PaidMedia): + """ + The paid media isn't available before the payment. + + Source: https://core.telegram.org/bots/api#paidmediapreview + """ + + type: Literal[PaidMediaType.PREVIEW] = PaidMediaType.PREVIEW + """Type of the paid media, always 'preview'""" + width: Optional[int] = None + """*Optional*. Media width as defined by the sender""" + height: Optional[int] = None + """*Optional*. Media height as defined by the sender""" + duration: Optional[int] = None + """*Optional*. Duration of the media in seconds as defined by the sender""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[PaidMediaType.PREVIEW] = PaidMediaType.PREVIEW, + width: Optional[int] = None, + height: Optional[int] = None, + duration: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, width=width, height=height, duration=duration, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/paid_media_video.py b/env/Lib/site-packages/aiogram/types/paid_media_video.py new file mode 100644 index 0000000..28affbb --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/paid_media_video.py @@ -0,0 +1,39 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import PaidMediaType +from .paid_media import PaidMedia + +if TYPE_CHECKING: + from .video import Video + + +class PaidMediaVideo(PaidMedia): + """ + The paid media is a video. + + Source: https://core.telegram.org/bots/api#paidmediavideo + """ + + type: Literal[PaidMediaType.VIDEO] = PaidMediaType.VIDEO + """Type of the paid media, always 'video'""" + video: Video + """The video""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[PaidMediaType.VIDEO] = PaidMediaType.VIDEO, + video: Video, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, video=video, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/passport_data.py b/env/Lib/site-packages/aiogram/types/passport_data.py new file mode 100644 index 0000000..d93af1f --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/passport_data.py @@ -0,0 +1,39 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List + +from .base import TelegramObject + +if TYPE_CHECKING: + from .encrypted_credentials import EncryptedCredentials + from .encrypted_passport_element import EncryptedPassportElement + + +class PassportData(TelegramObject): + """ + Describes Telegram Passport data shared with the bot by the user. + + Source: https://core.telegram.org/bots/api#passportdata + """ + + data: List[EncryptedPassportElement] + """Array with information about documents and other Telegram Passport elements that was shared with the bot""" + credentials: EncryptedCredentials + """Encrypted credentials required to decrypt the data""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + data: List[EncryptedPassportElement], + credentials: EncryptedCredentials, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(data=data, credentials=credentials, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/passport_element_error.py b/env/Lib/site-packages/aiogram/types/passport_element_error.py new file mode 100644 index 0000000..36a1db8 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/passport_element_error.py @@ -0,0 +1,21 @@ +from __future__ import annotations + +from .base import MutableTelegramObject + + +class PassportElementError(MutableTelegramObject): + """ + This object represents an error in the Telegram Passport element which was submitted that should be resolved by the user. It should be one of: + + - :class:`aiogram.types.passport_element_error_data_field.PassportElementErrorDataField` + - :class:`aiogram.types.passport_element_error_front_side.PassportElementErrorFrontSide` + - :class:`aiogram.types.passport_element_error_reverse_side.PassportElementErrorReverseSide` + - :class:`aiogram.types.passport_element_error_selfie.PassportElementErrorSelfie` + - :class:`aiogram.types.passport_element_error_file.PassportElementErrorFile` + - :class:`aiogram.types.passport_element_error_files.PassportElementErrorFiles` + - :class:`aiogram.types.passport_element_error_translation_file.PassportElementErrorTranslationFile` + - :class:`aiogram.types.passport_element_error_translation_files.PassportElementErrorTranslationFiles` + - :class:`aiogram.types.passport_element_error_unspecified.PassportElementErrorUnspecified` + + Source: https://core.telegram.org/bots/api#passportelementerror + """ diff --git a/env/Lib/site-packages/aiogram/types/passport_element_error_data_field.py b/env/Lib/site-packages/aiogram/types/passport_element_error_data_field.py new file mode 100644 index 0000000..3bf2bb2 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/passport_element_error_data_field.py @@ -0,0 +1,52 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import PassportElementErrorType +from .passport_element_error import PassportElementError + + +class PassportElementErrorDataField(PassportElementError): + """ + Represents an issue in one of the data fields that was provided by the user. The error is considered resolved when the field's value changes. + + Source: https://core.telegram.org/bots/api#passportelementerrordatafield + """ + + source: Literal[PassportElementErrorType.DATA] = PassportElementErrorType.DATA + """Error source, must be *data*""" + type: str + """The section of the user's Telegram Passport which has the error, one of 'personal_details', 'passport', 'driver_license', 'identity_card', 'internal_passport', 'address'""" + field_name: str + """Name of the data field which has the error""" + data_hash: str + """Base64-encoded data hash""" + message: str + """Error message""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + source: Literal[PassportElementErrorType.DATA] = PassportElementErrorType.DATA, + type: str, + field_name: str, + data_hash: str, + message: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + source=source, + type=type, + field_name=field_name, + data_hash=data_hash, + message=message, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/passport_element_error_file.py b/env/Lib/site-packages/aiogram/types/passport_element_error_file.py new file mode 100644 index 0000000..8bc40b3 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/passport_element_error_file.py @@ -0,0 +1,44 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import PassportElementErrorType +from .passport_element_error import PassportElementError + + +class PassportElementErrorFile(PassportElementError): + """ + Represents an issue with a document scan. The error is considered resolved when the file with the document scan changes. + + Source: https://core.telegram.org/bots/api#passportelementerrorfile + """ + + source: Literal[PassportElementErrorType.FILE] = PassportElementErrorType.FILE + """Error source, must be *file*""" + type: str + """The section of the user's Telegram Passport which has the issue, one of 'utility_bill', 'bank_statement', 'rental_agreement', 'passport_registration', 'temporary_registration'""" + file_hash: str + """Base64-encoded file hash""" + message: str + """Error message""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + source: Literal[PassportElementErrorType.FILE] = PassportElementErrorType.FILE, + type: str, + file_hash: str, + message: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + source=source, type=type, file_hash=file_hash, message=message, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/passport_element_error_files.py b/env/Lib/site-packages/aiogram/types/passport_element_error_files.py new file mode 100644 index 0000000..3639da2 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/passport_element_error_files.py @@ -0,0 +1,48 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal + +from ..enums import PassportElementErrorType +from .passport_element_error import PassportElementError + + +class PassportElementErrorFiles(PassportElementError): + """ + Represents an issue with a list of scans. The error is considered resolved when the list of files containing the scans changes. + + Source: https://core.telegram.org/bots/api#passportelementerrorfiles + """ + + source: Literal[PassportElementErrorType.FILES] = PassportElementErrorType.FILES + """Error source, must be *files*""" + type: str + """The section of the user's Telegram Passport which has the issue, one of 'utility_bill', 'bank_statement', 'rental_agreement', 'passport_registration', 'temporary_registration'""" + file_hashes: List[str] + """List of base64-encoded file hashes""" + message: str + """Error message""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + source: Literal[PassportElementErrorType.FILES] = PassportElementErrorType.FILES, + type: str, + file_hashes: List[str], + message: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + source=source, + type=type, + file_hashes=file_hashes, + message=message, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/passport_element_error_front_side.py b/env/Lib/site-packages/aiogram/types/passport_element_error_front_side.py new file mode 100644 index 0000000..86315f2 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/passport_element_error_front_side.py @@ -0,0 +1,46 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import PassportElementErrorType +from .passport_element_error import PassportElementError + + +class PassportElementErrorFrontSide(PassportElementError): + """ + Represents an issue with the front side of a document. The error is considered resolved when the file with the front side of the document changes. + + Source: https://core.telegram.org/bots/api#passportelementerrorfrontside + """ + + source: Literal[PassportElementErrorType.FRONT_SIDE] = PassportElementErrorType.FRONT_SIDE + """Error source, must be *front_side*""" + type: str + """The section of the user's Telegram Passport which has the issue, one of 'passport', 'driver_license', 'identity_card', 'internal_passport'""" + file_hash: str + """Base64-encoded hash of the file with the front side of the document""" + message: str + """Error message""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + source: Literal[ + PassportElementErrorType.FRONT_SIDE + ] = PassportElementErrorType.FRONT_SIDE, + type: str, + file_hash: str, + message: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + source=source, type=type, file_hash=file_hash, message=message, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/passport_element_error_reverse_side.py b/env/Lib/site-packages/aiogram/types/passport_element_error_reverse_side.py new file mode 100644 index 0000000..ecb400f --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/passport_element_error_reverse_side.py @@ -0,0 +1,46 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import PassportElementErrorType +from .passport_element_error import PassportElementError + + +class PassportElementErrorReverseSide(PassportElementError): + """ + Represents an issue with the reverse side of a document. The error is considered resolved when the file with reverse side of the document changes. + + Source: https://core.telegram.org/bots/api#passportelementerrorreverseside + """ + + source: Literal[PassportElementErrorType.REVERSE_SIDE] = PassportElementErrorType.REVERSE_SIDE + """Error source, must be *reverse_side*""" + type: str + """The section of the user's Telegram Passport which has the issue, one of 'driver_license', 'identity_card'""" + file_hash: str + """Base64-encoded hash of the file with the reverse side of the document""" + message: str + """Error message""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + source: Literal[ + PassportElementErrorType.REVERSE_SIDE + ] = PassportElementErrorType.REVERSE_SIDE, + type: str, + file_hash: str, + message: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + source=source, type=type, file_hash=file_hash, message=message, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/passport_element_error_selfie.py b/env/Lib/site-packages/aiogram/types/passport_element_error_selfie.py new file mode 100644 index 0000000..bff6dd6 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/passport_element_error_selfie.py @@ -0,0 +1,44 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import PassportElementErrorType +from .passport_element_error import PassportElementError + + +class PassportElementErrorSelfie(PassportElementError): + """ + Represents an issue with the selfie with a document. The error is considered resolved when the file with the selfie changes. + + Source: https://core.telegram.org/bots/api#passportelementerrorselfie + """ + + source: Literal[PassportElementErrorType.SELFIE] = PassportElementErrorType.SELFIE + """Error source, must be *selfie*""" + type: str + """The section of the user's Telegram Passport which has the issue, one of 'passport', 'driver_license', 'identity_card', 'internal_passport'""" + file_hash: str + """Base64-encoded hash of the file with the selfie""" + message: str + """Error message""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + source: Literal[PassportElementErrorType.SELFIE] = PassportElementErrorType.SELFIE, + type: str, + file_hash: str, + message: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + source=source, type=type, file_hash=file_hash, message=message, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/passport_element_error_translation_file.py b/env/Lib/site-packages/aiogram/types/passport_element_error_translation_file.py new file mode 100644 index 0000000..29689ca --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/passport_element_error_translation_file.py @@ -0,0 +1,48 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import PassportElementErrorType +from .passport_element_error import PassportElementError + + +class PassportElementErrorTranslationFile(PassportElementError): + """ + Represents an issue with one of the files that constitute the translation of a document. The error is considered resolved when the file changes. + + Source: https://core.telegram.org/bots/api#passportelementerrortranslationfile + """ + + source: Literal[PassportElementErrorType.TRANSLATION_FILE] = ( + PassportElementErrorType.TRANSLATION_FILE + ) + """Error source, must be *translation_file*""" + type: str + """Type of element of the user's Telegram Passport which has the issue, one of 'passport', 'driver_license', 'identity_card', 'internal_passport', 'utility_bill', 'bank_statement', 'rental_agreement', 'passport_registration', 'temporary_registration'""" + file_hash: str + """Base64-encoded file hash""" + message: str + """Error message""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + source: Literal[ + PassportElementErrorType.TRANSLATION_FILE + ] = PassportElementErrorType.TRANSLATION_FILE, + type: str, + file_hash: str, + message: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + source=source, type=type, file_hash=file_hash, message=message, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/passport_element_error_translation_files.py b/env/Lib/site-packages/aiogram/types/passport_element_error_translation_files.py new file mode 100644 index 0000000..65e9940 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/passport_element_error_translation_files.py @@ -0,0 +1,52 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal + +from ..enums import PassportElementErrorType +from .passport_element_error import PassportElementError + + +class PassportElementErrorTranslationFiles(PassportElementError): + """ + Represents an issue with the translated version of a document. The error is considered resolved when a file with the document translation change. + + Source: https://core.telegram.org/bots/api#passportelementerrortranslationfiles + """ + + source: Literal[PassportElementErrorType.TRANSLATION_FILES] = ( + PassportElementErrorType.TRANSLATION_FILES + ) + """Error source, must be *translation_files*""" + type: str + """Type of element of the user's Telegram Passport which has the issue, one of 'passport', 'driver_license', 'identity_card', 'internal_passport', 'utility_bill', 'bank_statement', 'rental_agreement', 'passport_registration', 'temporary_registration'""" + file_hashes: List[str] + """List of base64-encoded file hashes""" + message: str + """Error message""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + source: Literal[ + PassportElementErrorType.TRANSLATION_FILES + ] = PassportElementErrorType.TRANSLATION_FILES, + type: str, + file_hashes: List[str], + message: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + source=source, + type=type, + file_hashes=file_hashes, + message=message, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/passport_element_error_unspecified.py b/env/Lib/site-packages/aiogram/types/passport_element_error_unspecified.py new file mode 100644 index 0000000..3575d35 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/passport_element_error_unspecified.py @@ -0,0 +1,50 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import PassportElementErrorType +from .passport_element_error import PassportElementError + + +class PassportElementErrorUnspecified(PassportElementError): + """ + Represents an issue in an unspecified place. The error is considered resolved when new data is added. + + Source: https://core.telegram.org/bots/api#passportelementerrorunspecified + """ + + source: Literal[PassportElementErrorType.UNSPECIFIED] = PassportElementErrorType.UNSPECIFIED + """Error source, must be *unspecified*""" + type: str + """Type of element of the user's Telegram Passport which has the issue""" + element_hash: str + """Base64-encoded element hash""" + message: str + """Error message""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + source: Literal[ + PassportElementErrorType.UNSPECIFIED + ] = PassportElementErrorType.UNSPECIFIED, + type: str, + element_hash: str, + message: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + source=source, + type=type, + element_hash=element_hash, + message=message, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/passport_file.py b/env/Lib/site-packages/aiogram/types/passport_file.py new file mode 100644 index 0000000..d95da61 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/passport_file.py @@ -0,0 +1,48 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject +from .custom import DateTime + + +class PassportFile(TelegramObject): + """ + This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB. + + Source: https://core.telegram.org/bots/api#passportfile + """ + + file_id: str + """Identifier for this file, which can be used to download or reuse the file""" + file_unique_id: str + """Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.""" + file_size: int + """File size in bytes""" + file_date: DateTime + """Unix time when the file was uploaded""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + file_id: str, + file_unique_id: str, + file_size: int, + file_date: DateTime, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + file_id=file_id, + file_unique_id=file_unique_id, + file_size=file_size, + file_date=file_date, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/photo_size.py b/env/Lib/site-packages/aiogram/types/photo_size.py new file mode 100644 index 0000000..9a2ccbe --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/photo_size.py @@ -0,0 +1,51 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + + +class PhotoSize(TelegramObject): + """ + This object represents one size of a photo or a `file `_ / :class:`aiogram.methods.sticker.Sticker` thumbnail. + + Source: https://core.telegram.org/bots/api#photosize + """ + + file_id: str + """Identifier for this file, which can be used to download or reuse the file""" + file_unique_id: str + """Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.""" + width: int + """Photo width""" + height: int + """Photo height""" + file_size: Optional[int] = None + """*Optional*. File size in bytes""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + file_id: str, + file_unique_id: str, + width: int, + height: int, + file_size: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + file_id=file_id, + file_unique_id=file_unique_id, + width=width, + height=height, + file_size=file_size, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/poll.py b/env/Lib/site-packages/aiogram/types/poll.py new file mode 100644 index 0000000..5805224 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/poll.py @@ -0,0 +1,92 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from .base import TelegramObject +from .custom import DateTime + +if TYPE_CHECKING: + from .message_entity import MessageEntity + from .poll_option import PollOption + + +class Poll(TelegramObject): + """ + This object contains information about a poll. + + Source: https://core.telegram.org/bots/api#poll + """ + + id: str + """Unique poll identifier""" + question: str + """Poll question, 1-300 characters""" + options: List[PollOption] + """List of poll options""" + total_voter_count: int + """Total number of users that voted in the poll""" + is_closed: bool + """:code:`True`, if the poll is closed""" + is_anonymous: bool + """:code:`True`, if the poll is anonymous""" + type: str + """Poll type, currently can be 'regular' or 'quiz'""" + allows_multiple_answers: bool + """:code:`True`, if the poll allows multiple answers""" + question_entities: Optional[List[MessageEntity]] = None + """*Optional*. Special entities that appear in the *question*. Currently, only custom emoji entities are allowed in poll questions""" + correct_option_id: Optional[int] = None + """*Optional*. 0-based identifier of the correct answer option. Available only for polls in the quiz mode, which are closed, or was sent (not forwarded) by the bot or to the private chat with the bot.""" + explanation: Optional[str] = None + """*Optional*. Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters""" + explanation_entities: Optional[List[MessageEntity]] = None + """*Optional*. Special entities like usernames, URLs, bot commands, etc. that appear in the *explanation*""" + open_period: Optional[int] = None + """*Optional*. Amount of time in seconds the poll will be active after creation""" + close_date: Optional[DateTime] = None + """*Optional*. Point in time (Unix timestamp) when the poll will be automatically closed""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + id: str, + question: str, + options: List[PollOption], + total_voter_count: int, + is_closed: bool, + is_anonymous: bool, + type: str, + allows_multiple_answers: bool, + question_entities: Optional[List[MessageEntity]] = None, + correct_option_id: Optional[int] = None, + explanation: Optional[str] = None, + explanation_entities: Optional[List[MessageEntity]] = None, + open_period: Optional[int] = None, + close_date: Optional[DateTime] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + id=id, + question=question, + options=options, + total_voter_count=total_voter_count, + is_closed=is_closed, + is_anonymous=is_anonymous, + type=type, + allows_multiple_answers=allows_multiple_answers, + question_entities=question_entities, + correct_option_id=correct_option_id, + explanation=explanation, + explanation_entities=explanation_entities, + open_period=open_period, + close_date=close_date, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/poll_answer.py b/env/Lib/site-packages/aiogram/types/poll_answer.py new file mode 100644 index 0000000..c12be34 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/poll_answer.py @@ -0,0 +1,51 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .chat import Chat + from .user import User + + +class PollAnswer(TelegramObject): + """ + This object represents an answer of a user in a non-anonymous poll. + + Source: https://core.telegram.org/bots/api#pollanswer + """ + + poll_id: str + """Unique poll identifier""" + option_ids: List[int] + """0-based identifiers of chosen answer options. May be empty if the vote was retracted.""" + voter_chat: Optional[Chat] = None + """*Optional*. The chat that changed the answer to the poll, if the voter is anonymous""" + user: Optional[User] = None + """*Optional*. The user that changed the answer to the poll, if the voter isn't anonymous""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + poll_id: str, + option_ids: List[int], + voter_chat: Optional[Chat] = None, + user: Optional[User] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + poll_id=poll_id, + option_ids=option_ids, + voter_chat=voter_chat, + user=user, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/poll_option.py b/env/Lib/site-packages/aiogram/types/poll_option.py new file mode 100644 index 0000000..f380934 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/poll_option.py @@ -0,0 +1,46 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .message_entity import MessageEntity + + +class PollOption(TelegramObject): + """ + This object contains information about one answer option in a poll. + + Source: https://core.telegram.org/bots/api#polloption + """ + + text: str + """Option text, 1-100 characters""" + voter_count: int + """Number of users that voted for this option""" + text_entities: Optional[List[MessageEntity]] = None + """*Optional*. Special entities that appear in the option *text*. Currently, only custom emoji entities are allowed in poll option texts""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + text: str, + voter_count: int, + text_entities: Optional[List[MessageEntity]] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + text=text, + voter_count=voter_count, + text_entities=text_entities, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/pre_checkout_query.py b/env/Lib/site-packages/aiogram/types/pre_checkout_query.py new file mode 100644 index 0000000..41bda8c --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/pre_checkout_query.py @@ -0,0 +1,98 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from pydantic import Field + +from .base import TelegramObject + +if TYPE_CHECKING: + from ..methods import AnswerPreCheckoutQuery + from .order_info import OrderInfo + from .user import User + + +class PreCheckoutQuery(TelegramObject): + """ + This object contains information about an incoming pre-checkout query. + + Source: https://core.telegram.org/bots/api#precheckoutquery + """ + + id: str + """Unique query identifier""" + from_user: User = Field(..., alias="from") + """User who sent the query""" + currency: str + """Three-letter ISO 4217 `currency `_ code, or 'XTR' for payments in `Telegram Stars `_""" + total_amount: int + """Total price in the *smallest units* of the currency (integer, **not** float/double). For example, for a price of :code:`US$ 1.45` pass :code:`amount = 145`. See the *exp* parameter in `currencies.json `_, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).""" + invoice_payload: str + """Bot-specified invoice payload""" + shipping_option_id: Optional[str] = None + """*Optional*. Identifier of the shipping option chosen by the user""" + order_info: Optional[OrderInfo] = None + """*Optional*. Order information provided by the user""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + id: str, + from_user: User, + currency: str, + total_amount: int, + invoice_payload: str, + shipping_option_id: Optional[str] = None, + order_info: Optional[OrderInfo] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + id=id, + from_user=from_user, + currency=currency, + total_amount=total_amount, + invoice_payload=invoice_payload, + shipping_option_id=shipping_option_id, + order_info=order_info, + **__pydantic_kwargs, + ) + + def answer( + self, + ok: bool, + error_message: Optional[str] = None, + **kwargs: Any, + ) -> AnswerPreCheckoutQuery: + """ + Shortcut for method :class:`aiogram.methods.answer_pre_checkout_query.AnswerPreCheckoutQuery` + will automatically fill method attributes: + + - :code:`pre_checkout_query_id` + + Once the user has confirmed their payment and shipping details, the Bot API sends the final confirmation in the form of an :class:`aiogram.types.update.Update` with the field *pre_checkout_query*. Use this method to respond to such pre-checkout queries. On success, :code:`True` is returned. **Note:** The Bot API must receive an answer within 10 seconds after the pre-checkout query was sent. + + Source: https://core.telegram.org/bots/api#answerprecheckoutquery + + :param ok: Specify :code:`True` if everything is alright (goods are available, etc.) and the bot is ready to proceed with the order. Use :code:`False` if there are any problems. + :param error_message: Required if *ok* is :code:`False`. Error message in human readable form that explains the reason for failure to proceed with the checkout (e.g. "Sorry, somebody just bought the last of our amazing black T-shirts while you were busy filling out your payment details. Please choose a different color or garment!"). Telegram will display this message to the user. + :return: instance of method :class:`aiogram.methods.answer_pre_checkout_query.AnswerPreCheckoutQuery` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import AnswerPreCheckoutQuery + + return AnswerPreCheckoutQuery( + pre_checkout_query_id=self.id, + ok=ok, + error_message=error_message, + **kwargs, + ).as_(self._bot) diff --git a/env/Lib/site-packages/aiogram/types/proximity_alert_triggered.py b/env/Lib/site-packages/aiogram/types/proximity_alert_triggered.py new file mode 100644 index 0000000..f5a30c6 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/proximity_alert_triggered.py @@ -0,0 +1,43 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + +if TYPE_CHECKING: + from .user import User + + +class ProximityAlertTriggered(TelegramObject): + """ + This object represents the content of a service message, sent whenever a user in the chat triggers a proximity alert set by another user. + + Source: https://core.telegram.org/bots/api#proximityalerttriggered + """ + + traveler: User + """User that triggered the alert""" + watcher: User + """User that set the alert""" + distance: int + """The distance between the users""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + traveler: User, + watcher: User, + distance: int, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + traveler=traveler, watcher=watcher, distance=distance, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/reaction_count.py b/env/Lib/site-packages/aiogram/types/reaction_count.py new file mode 100644 index 0000000..e4ee167 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/reaction_count.py @@ -0,0 +1,40 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Union + +from .base import TelegramObject + +if TYPE_CHECKING: + from .reaction_type_custom_emoji import ReactionTypeCustomEmoji + from .reaction_type_emoji import ReactionTypeEmoji + from .reaction_type_paid import ReactionTypePaid + + +class ReactionCount(TelegramObject): + """ + Represents a reaction added to a message along with the number of times it was added. + + Source: https://core.telegram.org/bots/api#reactioncount + """ + + type: Union[ReactionTypeEmoji, ReactionTypeCustomEmoji, ReactionTypePaid] + """Type of the reaction""" + total_count: int + """Number of times the reaction was added""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Union[ReactionTypeEmoji, ReactionTypeCustomEmoji, ReactionTypePaid], + total_count: int, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, total_count=total_count, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/reaction_type.py b/env/Lib/site-packages/aiogram/types/reaction_type.py new file mode 100644 index 0000000..335d35d --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/reaction_type.py @@ -0,0 +1,13 @@ +from .base import TelegramObject + + +class ReactionType(TelegramObject): + """ + This object describes the type of a reaction. Currently, it can be one of + + - :class:`aiogram.types.reaction_type_emoji.ReactionTypeEmoji` + - :class:`aiogram.types.reaction_type_custom_emoji.ReactionTypeCustomEmoji` + - :class:`aiogram.types.reaction_type_paid.ReactionTypePaid` + + Source: https://core.telegram.org/bots/api#reactiontype + """ diff --git a/env/Lib/site-packages/aiogram/types/reaction_type_custom_emoji.py b/env/Lib/site-packages/aiogram/types/reaction_type_custom_emoji.py new file mode 100644 index 0000000..c86ec5e --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/reaction_type_custom_emoji.py @@ -0,0 +1,34 @@ +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import ReactionTypeType +from .reaction_type import ReactionType + + +class ReactionTypeCustomEmoji(ReactionType): + """ + The reaction is based on a custom emoji. + + Source: https://core.telegram.org/bots/api#reactiontypecustomemoji + """ + + type: Literal[ReactionTypeType.CUSTOM_EMOJI] = ReactionTypeType.CUSTOM_EMOJI + """Type of the reaction, always 'custom_emoji'""" + custom_emoji_id: str + """Custom emoji identifier""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[ReactionTypeType.CUSTOM_EMOJI] = ReactionTypeType.CUSTOM_EMOJI, + custom_emoji_id: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, custom_emoji_id=custom_emoji_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/reaction_type_emoji.py b/env/Lib/site-packages/aiogram/types/reaction_type_emoji.py new file mode 100644 index 0000000..a209fe2 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/reaction_type_emoji.py @@ -0,0 +1,34 @@ +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import ReactionTypeType +from .reaction_type import ReactionType + + +class ReactionTypeEmoji(ReactionType): + """ + The reaction is based on an emoji. + + Source: https://core.telegram.org/bots/api#reactiontypeemoji + """ + + type: Literal[ReactionTypeType.EMOJI] = ReactionTypeType.EMOJI + """Type of the reaction, always 'emoji'""" + emoji: str + """Reaction emoji. Currently, it can be one of "👍", "👎", "❤", "🔥", "🥰", "👏", "😁", "🤔", "🤯", "😱", "🤬", "😢", "🎉", "🤩", "🤮", "💩", "🙏", "👌", "🕊", "🤡", "🥱", "🥴", "😍", "🐳", "❤‍🔥", "🌚", "🌭", "💯", "🤣", "⚡", "🍌", "🏆", "💔", "🤨", "😐", "🍓", "🍾", "💋", "🖕", "😈", "😴", "😭", "🤓", "👻", "👨‍💻", "👀", "🎃", "🙈", "😇", "😨", "🤝", "✍", "🤗", "🫡", "🎅", "🎄", "☃", "💅", "🤪", "🗿", "🆒", "💘", "🙉", "🦄", "😘", "💊", "🙊", "😎", "👾", "🤷‍♂", "🤷", "🤷‍♀", "😡" """ + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[ReactionTypeType.EMOJI] = ReactionTypeType.EMOJI, + emoji: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, emoji=emoji, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/reaction_type_paid.py b/env/Lib/site-packages/aiogram/types/reaction_type_paid.py new file mode 100644 index 0000000..8e95a83 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/reaction_type_paid.py @@ -0,0 +1,28 @@ +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import ReactionTypeType +from .reaction_type import ReactionType + + +class ReactionTypePaid(ReactionType): + """ + The reaction is paid. + + Source: https://core.telegram.org/bots/api#reactiontypepaid + """ + + type: Literal["paid"] = "paid" + """Type of the reaction, always 'paid'""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, type: Literal["paid"] = "paid", **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/refunded_payment.py b/env/Lib/site-packages/aiogram/types/refunded_payment.py new file mode 100644 index 0000000..8b889dc --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/refunded_payment.py @@ -0,0 +1,49 @@ +from typing import TYPE_CHECKING, Any, Literal, Optional + +from .base import TelegramObject + + +class RefundedPayment(TelegramObject): + """ + This object contains basic information about a refunded payment. + + Source: https://core.telegram.org/bots/api#refundedpayment + """ + + currency: Literal["XTR"] = "XTR" + """Three-letter ISO 4217 `currency `_ code, or 'XTR' for payments in `Telegram Stars `_. Currently, always 'XTR'""" + total_amount: int + """Total refunded price in the *smallest units* of the currency (integer, **not** float/double). For example, for a price of :code:`US$ 1.45`, :code:`total_amount = 145`. See the *exp* parameter in `currencies.json `_, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).""" + invoice_payload: str + """Bot-specified invoice payload""" + telegram_payment_charge_id: str + """Telegram payment identifier""" + provider_payment_charge_id: Optional[str] = None + """*Optional*. Provider payment identifier""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + currency: Literal["XTR"] = "XTR", + total_amount: int, + invoice_payload: str, + telegram_payment_charge_id: str, + provider_payment_charge_id: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + currency=currency, + total_amount=total_amount, + invoice_payload=invoice_payload, + telegram_payment_charge_id=telegram_payment_charge_id, + provider_payment_charge_id=provider_payment_charge_id, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/reply_keyboard_markup.py b/env/Lib/site-packages/aiogram/types/reply_keyboard_markup.py new file mode 100644 index 0000000..f3d6dab --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/reply_keyboard_markup.py @@ -0,0 +1,58 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from .base import MutableTelegramObject + +if TYPE_CHECKING: + from .keyboard_button import KeyboardButton + + +class ReplyKeyboardMarkup(MutableTelegramObject): + """ + This object represents a `custom keyboard `_ with reply options (see `Introduction to bots `_ for details and examples). Not supported in channels and for messages sent on behalf of a Telegram Business account. + + Source: https://core.telegram.org/bots/api#replykeyboardmarkup + """ + + keyboard: List[List[KeyboardButton]] + """Array of button rows, each represented by an Array of :class:`aiogram.types.keyboard_button.KeyboardButton` objects""" + is_persistent: Optional[bool] = None + """*Optional*. Requests clients to always show the keyboard when the regular keyboard is hidden. Defaults to *false*, in which case the custom keyboard can be hidden and opened with a keyboard icon.""" + resize_keyboard: Optional[bool] = None + """*Optional*. Requests clients to resize the keyboard vertically for optimal fit (e.g., make the keyboard smaller if there are just two rows of buttons). Defaults to *false*, in which case the custom keyboard is always of the same height as the app's standard keyboard.""" + one_time_keyboard: Optional[bool] = None + """*Optional*. Requests clients to hide the keyboard as soon as it's been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat - the user can press a special button in the input field to see the custom keyboard again. Defaults to *false*.""" + input_field_placeholder: Optional[str] = None + """*Optional*. The placeholder to be shown in the input field when the keyboard is active; 1-64 characters""" + selective: Optional[bool] = None + """*Optional*. Use this parameter if you want to show the keyboard to specific users only. Targets: 1) users that are @mentioned in the *text* of the :class:`aiogram.types.message.Message` object; 2) if the bot's message is a reply to a message in the same chat and forum topic, sender of the original message.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + keyboard: List[List[KeyboardButton]], + is_persistent: Optional[bool] = None, + resize_keyboard: Optional[bool] = None, + one_time_keyboard: Optional[bool] = None, + input_field_placeholder: Optional[str] = None, + selective: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + keyboard=keyboard, + is_persistent=is_persistent, + resize_keyboard=resize_keyboard, + one_time_keyboard=one_time_keyboard, + input_field_placeholder=input_field_placeholder, + selective=selective, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/reply_keyboard_remove.py b/env/Lib/site-packages/aiogram/types/reply_keyboard_remove.py new file mode 100644 index 0000000..9c135a1 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/reply_keyboard_remove.py @@ -0,0 +1,37 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional + +from .base import MutableTelegramObject + + +class ReplyKeyboardRemove(MutableTelegramObject): + """ + Upon receiving a message with this object, Telegram clients will remove the current custom keyboard and display the default letter-keyboard. By default, custom keyboards are displayed until a new keyboard is sent by a bot. An exception is made for one-time keyboards that are hidden immediately after the user presses a button (see :class:`aiogram.types.reply_keyboard_markup.ReplyKeyboardMarkup`). Not supported in channels and for messages sent on behalf of a Telegram Business account. + + Source: https://core.telegram.org/bots/api#replykeyboardremove + """ + + remove_keyboard: Literal[True] = True + """Requests clients to remove the custom keyboard (user will not be able to summon this keyboard; if you want to hide the keyboard from sight but keep it accessible, use *one_time_keyboard* in :class:`aiogram.types.reply_keyboard_markup.ReplyKeyboardMarkup`)""" + selective: Optional[bool] = None + """*Optional*. Use this parameter if you want to remove the keyboard for specific users only. Targets: 1) users that are @mentioned in the *text* of the :class:`aiogram.types.message.Message` object; 2) if the bot's message is a reply to a message in the same chat and forum topic, sender of the original message.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + remove_keyboard: Literal[True] = True, + selective: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + remove_keyboard=remove_keyboard, selective=selective, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/reply_parameters.py b/env/Lib/site-packages/aiogram/types/reply_parameters.py new file mode 100644 index 0000000..5b03fda --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/reply_parameters.py @@ -0,0 +1,67 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional, Union + +from ..client.default import Default +from .base import TelegramObject + +if TYPE_CHECKING: + from .message_entity import MessageEntity + + +class ReplyParameters(TelegramObject): + """ + Describes reply parameters for the message that is being sent. + + Source: https://core.telegram.org/bots/api#replyparameters + """ + + message_id: int + """Identifier of the message that will be replied to in the current chat, or in the chat *chat_id* if it is specified""" + chat_id: Optional[Union[int, str]] = None + """*Optional*. If the message to be replied to is from a different chat, unique identifier for the chat or username of the channel (in the format :code:`@channelusername`). Not supported for messages sent on behalf of a business account.""" + allow_sending_without_reply: Optional[Union[bool, Default]] = Default( + "allow_sending_without_reply" + ) + """*Optional*. Pass :code:`True` if the message should be sent even if the specified message to be replied to is not found. Always :code:`False` for replies in another chat or forum topic. Always :code:`True` for messages sent on behalf of a business account.""" + quote: Optional[str] = None + """*Optional*. Quoted part of the message to be replied to; 0-1024 characters after entities parsing. The quote must be an exact substring of the message to be replied to, including *bold*, *italic*, *underline*, *strikethrough*, *spoiler*, and *custom_emoji* entities. The message will fail to send if the quote isn't found in the original message.""" + quote_parse_mode: Optional[Union[str, Default]] = Default("parse_mode") + """*Optional*. Mode for parsing entities in the quote. See `formatting options `_ for more details.""" + quote_entities: Optional[List[MessageEntity]] = None + """*Optional*. A JSON-serialized list of special entities that appear in the quote. It can be specified instead of *quote_parse_mode*.""" + quote_position: Optional[int] = None + """*Optional*. Position of the quote in the original message in UTF-16 code units""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + message_id: int, + chat_id: Optional[Union[int, str]] = None, + allow_sending_without_reply: Optional[Union[bool, Default]] = Default( + "allow_sending_without_reply" + ), + quote: Optional[str] = None, + quote_parse_mode: Optional[Union[str, Default]] = Default("parse_mode"), + quote_entities: Optional[List[MessageEntity]] = None, + quote_position: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + message_id=message_id, + chat_id=chat_id, + allow_sending_without_reply=allow_sending_without_reply, + quote=quote, + quote_parse_mode=quote_parse_mode, + quote_entities=quote_entities, + quote_position=quote_position, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/response_parameters.py b/env/Lib/site-packages/aiogram/types/response_parameters.py new file mode 100644 index 0000000..19fc54f --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/response_parameters.py @@ -0,0 +1,37 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + + +class ResponseParameters(TelegramObject): + """ + Describes why a request was unsuccessful. + + Source: https://core.telegram.org/bots/api#responseparameters + """ + + migrate_to_chat_id: Optional[int] = None + """*Optional*. The group has been migrated to a supergroup with the specified identifier. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this identifier.""" + retry_after: Optional[int] = None + """*Optional*. In case of exceeding flood control, the number of seconds left to wait before the request can be repeated""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + migrate_to_chat_id: Optional[int] = None, + retry_after: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + migrate_to_chat_id=migrate_to_chat_id, retry_after=retry_after, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/revenue_withdrawal_state.py b/env/Lib/site-packages/aiogram/types/revenue_withdrawal_state.py new file mode 100644 index 0000000..740323e --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/revenue_withdrawal_state.py @@ -0,0 +1,15 @@ +from __future__ import annotations + +from .base import TelegramObject + + +class RevenueWithdrawalState(TelegramObject): + """ + This object describes the state of a revenue withdrawal operation. Currently, it can be one of + + - :class:`aiogram.types.revenue_withdrawal_state_pending.RevenueWithdrawalStatePending` + - :class:`aiogram.types.revenue_withdrawal_state_succeeded.RevenueWithdrawalStateSucceeded` + - :class:`aiogram.types.revenue_withdrawal_state_failed.RevenueWithdrawalStateFailed` + + Source: https://core.telegram.org/bots/api#revenuewithdrawalstate + """ diff --git a/env/Lib/site-packages/aiogram/types/revenue_withdrawal_state_failed.py b/env/Lib/site-packages/aiogram/types/revenue_withdrawal_state_failed.py new file mode 100644 index 0000000..501a9ff --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/revenue_withdrawal_state_failed.py @@ -0,0 +1,33 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import RevenueWithdrawalStateType +from .revenue_withdrawal_state import RevenueWithdrawalState + + +class RevenueWithdrawalStateFailed(RevenueWithdrawalState): + """ + The withdrawal failed and the transaction was refunded. + + Source: https://core.telegram.org/bots/api#revenuewithdrawalstatefailed + """ + + type: Literal[RevenueWithdrawalStateType.FAILED] = RevenueWithdrawalStateType.FAILED + """Type of the state, always 'failed'""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[RevenueWithdrawalStateType.FAILED] = RevenueWithdrawalStateType.FAILED, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/revenue_withdrawal_state_pending.py b/env/Lib/site-packages/aiogram/types/revenue_withdrawal_state_pending.py new file mode 100644 index 0000000..c4e481f --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/revenue_withdrawal_state_pending.py @@ -0,0 +1,33 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import RevenueWithdrawalStateType +from .revenue_withdrawal_state import RevenueWithdrawalState + + +class RevenueWithdrawalStatePending(RevenueWithdrawalState): + """ + The withdrawal is in progress. + + Source: https://core.telegram.org/bots/api#revenuewithdrawalstatepending + """ + + type: Literal[RevenueWithdrawalStateType.PENDING] = RevenueWithdrawalStateType.PENDING + """Type of the state, always 'pending'""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[RevenueWithdrawalStateType.PENDING] = RevenueWithdrawalStateType.PENDING, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/revenue_withdrawal_state_succeeded.py b/env/Lib/site-packages/aiogram/types/revenue_withdrawal_state_succeeded.py new file mode 100644 index 0000000..48d45f1 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/revenue_withdrawal_state_succeeded.py @@ -0,0 +1,42 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import RevenueWithdrawalStateType +from .custom import DateTime +from .revenue_withdrawal_state import RevenueWithdrawalState + + +class RevenueWithdrawalStateSucceeded(RevenueWithdrawalState): + """ + The withdrawal succeeded. + + Source: https://core.telegram.org/bots/api#revenuewithdrawalstatesucceeded + """ + + type: Literal[RevenueWithdrawalStateType.SUCCEEDED] = RevenueWithdrawalStateType.SUCCEEDED + """Type of the state, always 'succeeded'""" + date: DateTime + """Date the withdrawal was completed in Unix time""" + url: str + """An HTTPS URL that can be used to see transaction details""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[ + RevenueWithdrawalStateType.SUCCEEDED + ] = RevenueWithdrawalStateType.SUCCEEDED, + date: DateTime, + url: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, date=date, url=url, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/sent_web_app_message.py b/env/Lib/site-packages/aiogram/types/sent_web_app_message.py new file mode 100644 index 0000000..e8241a5 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/sent_web_app_message.py @@ -0,0 +1,32 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + + +class SentWebAppMessage(TelegramObject): + """ + Describes an inline message sent by a `Web App `_ on behalf of a user. + + Source: https://core.telegram.org/bots/api#sentwebappmessage + """ + + inline_message_id: Optional[str] = None + """*Optional*. Identifier of the sent inline message. Available only if there is an `inline keyboard `_ attached to the message.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + inline_message_id: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(inline_message_id=inline_message_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/shared_user.py b/env/Lib/site-packages/aiogram/types/shared_user.py new file mode 100644 index 0000000..e160b89 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/shared_user.py @@ -0,0 +1,54 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .photo_size import PhotoSize + + +class SharedUser(TelegramObject): + """ + This object contains information about a user that was shared with the bot using a :class:`aiogram.types.keyboard_button_request_users.KeyboardButtonRequestUsers` button. + + Source: https://core.telegram.org/bots/api#shareduser + """ + + user_id: int + """Identifier of the shared user. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so 64-bit integers or double-precision float types are safe for storing these identifiers. The bot may not have access to the user and could be unable to use this identifier, unless the user is already known to the bot by some other means.""" + first_name: Optional[str] = None + """*Optional*. First name of the user, if the name was requested by the bot""" + last_name: Optional[str] = None + """*Optional*. Last name of the user, if the name was requested by the bot""" + username: Optional[str] = None + """*Optional*. Username of the user, if the username was requested by the bot""" + photo: Optional[List[PhotoSize]] = None + """*Optional*. Available sizes of the chat photo, if the photo was requested by the bot""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + user_id: int, + first_name: Optional[str] = None, + last_name: Optional[str] = None, + username: Optional[str] = None, + photo: Optional[List[PhotoSize]] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + user_id=user_id, + first_name=first_name, + last_name=last_name, + username=username, + photo=photo, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/shipping_address.py b/env/Lib/site-packages/aiogram/types/shipping_address.py new file mode 100644 index 0000000..a8293cd --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/shipping_address.py @@ -0,0 +1,55 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + + +class ShippingAddress(TelegramObject): + """ + This object represents a shipping address. + + Source: https://core.telegram.org/bots/api#shippingaddress + """ + + country_code: str + """Two-letter `ISO 3166-1 alpha-2 `_ country code""" + state: str + """State, if applicable""" + city: str + """City""" + street_line1: str + """First line for the address""" + street_line2: str + """Second line for the address""" + post_code: str + """Address post code""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + country_code: str, + state: str, + city: str, + street_line1: str, + street_line2: str, + post_code: str, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + country_code=country_code, + state=state, + city=city, + street_line1=street_line1, + street_line2=street_line2, + post_code=post_code, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/shipping_option.py b/env/Lib/site-packages/aiogram/types/shipping_option.py new file mode 100644 index 0000000..b027451 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/shipping_option.py @@ -0,0 +1,41 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List + +from .base import TelegramObject + +if TYPE_CHECKING: + from .labeled_price import LabeledPrice + + +class ShippingOption(TelegramObject): + """ + This object represents one shipping option. + + Source: https://core.telegram.org/bots/api#shippingoption + """ + + id: str + """Shipping option identifier""" + title: str + """Option title""" + prices: List[LabeledPrice] + """List of price portions""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + id: str, + title: str, + prices: List[LabeledPrice], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(id=id, title=title, prices=prices, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/shipping_query.py b/env/Lib/site-packages/aiogram/types/shipping_query.py new file mode 100644 index 0000000..61b4ae4 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/shipping_query.py @@ -0,0 +1,90 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from pydantic import Field + +from .base import TelegramObject + +if TYPE_CHECKING: + from ..methods import AnswerShippingQuery + from ..types import ShippingOption + from .shipping_address import ShippingAddress + from .user import User + + +class ShippingQuery(TelegramObject): + """ + This object contains information about an incoming shipping query. + + Source: https://core.telegram.org/bots/api#shippingquery + """ + + id: str + """Unique query identifier""" + from_user: User = Field(..., alias="from") + """User who sent the query""" + invoice_payload: str + """Bot-specified invoice payload""" + shipping_address: ShippingAddress + """User specified shipping address""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + id: str, + from_user: User, + invoice_payload: str, + shipping_address: ShippingAddress, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + id=id, + from_user=from_user, + invoice_payload=invoice_payload, + shipping_address=shipping_address, + **__pydantic_kwargs, + ) + + def answer( + self, + ok: bool, + shipping_options: Optional[List[ShippingOption]] = None, + error_message: Optional[str] = None, + **kwargs: Any, + ) -> AnswerShippingQuery: + """ + Shortcut for method :class:`aiogram.methods.answer_shipping_query.AnswerShippingQuery` + will automatically fill method attributes: + + - :code:`shipping_query_id` + + If you sent an invoice requesting a shipping address and the parameter *is_flexible* was specified, the Bot API will send an :class:`aiogram.types.update.Update` with a *shipping_query* field to the bot. Use this method to reply to shipping queries. On success, :code:`True` is returned. + + Source: https://core.telegram.org/bots/api#answershippingquery + + :param ok: Pass :code:`True` if delivery to the specified address is possible and :code:`False` if there are any problems (for example, if delivery to the specified address is not possible) + :param shipping_options: Required if *ok* is :code:`True`. A JSON-serialized array of available shipping options. + :param error_message: Required if *ok* is :code:`False`. Error message in human readable form that explains why it is impossible to complete the order (e.g. "Sorry, delivery to your desired address is unavailable'). Telegram will display this message to the user. + :return: instance of method :class:`aiogram.methods.answer_shipping_query.AnswerShippingQuery` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import AnswerShippingQuery + + return AnswerShippingQuery( + shipping_query_id=self.id, + ok=ok, + shipping_options=shipping_options, + error_message=error_message, + **kwargs, + ).as_(self._bot) diff --git a/env/Lib/site-packages/aiogram/types/star_transaction.py b/env/Lib/site-packages/aiogram/types/star_transaction.py new file mode 100644 index 0000000..5d680af --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/star_transaction.py @@ -0,0 +1,86 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, Union + +from .base import TelegramObject +from .custom import DateTime + +if TYPE_CHECKING: + from .transaction_partner_fragment import TransactionPartnerFragment + from .transaction_partner_other import TransactionPartnerOther + from .transaction_partner_telegram_ads import TransactionPartnerTelegramAds + from .transaction_partner_user import TransactionPartnerUser + + +class StarTransaction(TelegramObject): + """ + Describes a Telegram Star transaction. + + Source: https://core.telegram.org/bots/api#startransaction + """ + + id: str + """Unique identifier of the transaction. Coincides with the identifer of the original transaction for refund transactions. Coincides with *SuccessfulPayment.telegram_payment_charge_id* for successful incoming payments from users.""" + amount: int + """Number of Telegram Stars transferred by the transaction""" + date: DateTime + """Date the transaction was created in Unix time""" + source: Optional[ + Union[ + TransactionPartnerUser, + TransactionPartnerFragment, + TransactionPartnerTelegramAds, + TransactionPartnerOther, + ] + ] = None + """*Optional*. Source of an incoming transaction (e.g., a user purchasing goods or services, Fragment refunding a failed withdrawal). Only for incoming transactions""" + receiver: Optional[ + Union[ + TransactionPartnerUser, + TransactionPartnerFragment, + TransactionPartnerTelegramAds, + TransactionPartnerOther, + ] + ] = None + """*Optional*. Receiver of an outgoing transaction (e.g., a user for a purchase refund, Fragment for a withdrawal). Only for outgoing transactions""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + id: str, + amount: int, + date: DateTime, + source: Optional[ + Union[ + TransactionPartnerUser, + TransactionPartnerFragment, + TransactionPartnerTelegramAds, + TransactionPartnerOther, + ] + ] = None, + receiver: Optional[ + Union[ + TransactionPartnerUser, + TransactionPartnerFragment, + TransactionPartnerTelegramAds, + TransactionPartnerOther, + ] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + id=id, + amount=amount, + date=date, + source=source, + receiver=receiver, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/star_transactions.py b/env/Lib/site-packages/aiogram/types/star_transactions.py new file mode 100644 index 0000000..d2ee5b0 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/star_transactions.py @@ -0,0 +1,32 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List + +from .base import TelegramObject + +if TYPE_CHECKING: + from .star_transaction import StarTransaction + + +class StarTransactions(TelegramObject): + """ + Contains a list of Telegram Star transactions. + + Source: https://core.telegram.org/bots/api#startransactions + """ + + transactions: List[StarTransaction] + """The list of transactions""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, transactions: List[StarTransaction], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(transactions=transactions, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/sticker.py b/env/Lib/site-packages/aiogram/types/sticker.py new file mode 100644 index 0000000..4c1b864 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/sticker.py @@ -0,0 +1,152 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from ..methods import DeleteStickerFromSet, SetStickerPositionInSet + from .file import File + from .mask_position import MaskPosition + from .photo_size import PhotoSize + + +class Sticker(TelegramObject): + """ + This object represents a sticker. + + Source: https://core.telegram.org/bots/api#sticker + """ + + file_id: str + """Identifier for this file, which can be used to download or reuse the file""" + file_unique_id: str + """Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.""" + type: str + """Type of the sticker, currently one of 'regular', 'mask', 'custom_emoji'. The type of the sticker is independent from its format, which is determined by the fields *is_animated* and *is_video*.""" + width: int + """Sticker width""" + height: int + """Sticker height""" + is_animated: bool + """:code:`True`, if the sticker is `animated `_""" + is_video: bool + """:code:`True`, if the sticker is a `video sticker `_""" + thumbnail: Optional[PhotoSize] = None + """*Optional*. Sticker thumbnail in the .WEBP or .JPG format""" + emoji: Optional[str] = None + """*Optional*. Emoji associated with the sticker""" + set_name: Optional[str] = None + """*Optional*. Name of the sticker set to which the sticker belongs""" + premium_animation: Optional[File] = None + """*Optional*. For premium regular stickers, premium animation for the sticker""" + mask_position: Optional[MaskPosition] = None + """*Optional*. For mask stickers, the position where the mask should be placed""" + custom_emoji_id: Optional[str] = None + """*Optional*. For custom emoji stickers, unique identifier of the custom emoji""" + needs_repainting: Optional[bool] = None + """*Optional*. :code:`True`, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places""" + file_size: Optional[int] = None + """*Optional*. File size in bytes""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + file_id: str, + file_unique_id: str, + type: str, + width: int, + height: int, + is_animated: bool, + is_video: bool, + thumbnail: Optional[PhotoSize] = None, + emoji: Optional[str] = None, + set_name: Optional[str] = None, + premium_animation: Optional[File] = None, + mask_position: Optional[MaskPosition] = None, + custom_emoji_id: Optional[str] = None, + needs_repainting: Optional[bool] = None, + file_size: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + file_id=file_id, + file_unique_id=file_unique_id, + type=type, + width=width, + height=height, + is_animated=is_animated, + is_video=is_video, + thumbnail=thumbnail, + emoji=emoji, + set_name=set_name, + premium_animation=premium_animation, + mask_position=mask_position, + custom_emoji_id=custom_emoji_id, + needs_repainting=needs_repainting, + file_size=file_size, + **__pydantic_kwargs, + ) + + def set_position_in_set( + self, + position: int, + **kwargs: Any, + ) -> SetStickerPositionInSet: + """ + Shortcut for method :class:`aiogram.methods.set_sticker_position_in_set.SetStickerPositionInSet` + will automatically fill method attributes: + + - :code:`sticker` + + Use this method to move a sticker in a set created by the bot to a specific position. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#setstickerpositioninset + + :param position: New sticker position in the set, zero-based + :return: instance of method :class:`aiogram.methods.set_sticker_position_in_set.SetStickerPositionInSet` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import SetStickerPositionInSet + + return SetStickerPositionInSet( + sticker=self.file_id, + position=position, + **kwargs, + ).as_(self._bot) + + def delete_from_set( + self, + **kwargs: Any, + ) -> DeleteStickerFromSet: + """ + Shortcut for method :class:`aiogram.methods.delete_sticker_from_set.DeleteStickerFromSet` + will automatically fill method attributes: + + - :code:`sticker` + + Use this method to delete a sticker from a set created by the bot. Returns :code:`True` on success. + + Source: https://core.telegram.org/bots/api#deletestickerfromset + + :return: instance of method :class:`aiogram.methods.delete_sticker_from_set.DeleteStickerFromSet` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import DeleteStickerFromSet + + return DeleteStickerFromSet( + sticker=self.file_id, + **kwargs, + ).as_(self._bot) diff --git a/env/Lib/site-packages/aiogram/types/sticker_set.py b/env/Lib/site-packages/aiogram/types/sticker_set.py new file mode 100644 index 0000000..29f9962 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/sticker_set.py @@ -0,0 +1,71 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from pydantic import Field + +from .base import TelegramObject + +if TYPE_CHECKING: + from .photo_size import PhotoSize + from .sticker import Sticker + + +class StickerSet(TelegramObject): + """ + This object represents a sticker set. + + Source: https://core.telegram.org/bots/api#stickerset + """ + + name: str + """Sticker set name""" + title: str + """Sticker set title""" + sticker_type: str + """Type of stickers in the set, currently one of 'regular', 'mask', 'custom_emoji'""" + stickers: List[Sticker] + """List of all set stickers""" + thumbnail: Optional[PhotoSize] = None + """*Optional*. Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format""" + is_animated: Optional[bool] = Field(None, json_schema_extra={"deprecated": True}) + """:code:`True`, if the sticker set contains `animated stickers `_ + +.. deprecated:: API:7.2 + https://core.telegram.org/bots/api-changelog#march-31-2024""" + is_video: Optional[bool] = Field(None, json_schema_extra={"deprecated": True}) + """:code:`True`, if the sticker set contains `video stickers `_ + +.. deprecated:: API:7.2 + https://core.telegram.org/bots/api-changelog#march-31-2024""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + name: str, + title: str, + sticker_type: str, + stickers: List[Sticker], + thumbnail: Optional[PhotoSize] = None, + is_animated: Optional[bool] = None, + is_video: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + name=name, + title=title, + sticker_type=sticker_type, + stickers=stickers, + thumbnail=thumbnail, + is_animated=is_animated, + is_video=is_video, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/story.py b/env/Lib/site-packages/aiogram/types/story.py new file mode 100644 index 0000000..69aaaec --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/story.py @@ -0,0 +1,32 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + +if TYPE_CHECKING: + from .chat import Chat + + +class Story(TelegramObject): + """ + This object represents a story. + + Source: https://core.telegram.org/bots/api#story + """ + + chat: Chat + """Chat that posted the story""" + id: int + """Unique identifier for the story in the chat""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__(__pydantic__self__, *, chat: Chat, id: int, **__pydantic_kwargs: Any) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(chat=chat, id=id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/successful_payment.py b/env/Lib/site-packages/aiogram/types/successful_payment.py new file mode 100644 index 0000000..30d4356 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/successful_payment.py @@ -0,0 +1,62 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .order_info import OrderInfo + + +class SuccessfulPayment(TelegramObject): + """ + This object contains basic information about a successful payment. + + Source: https://core.telegram.org/bots/api#successfulpayment + """ + + currency: str + """Three-letter ISO 4217 `currency `_ code, or 'XTR' for payments in `Telegram Stars `_""" + total_amount: int + """Total price in the *smallest units* of the currency (integer, **not** float/double). For example, for a price of :code:`US$ 1.45` pass :code:`amount = 145`. See the *exp* parameter in `currencies.json `_, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).""" + invoice_payload: str + """Bot-specified invoice payload""" + telegram_payment_charge_id: str + """Telegram payment identifier""" + provider_payment_charge_id: str + """Provider payment identifier""" + shipping_option_id: Optional[str] = None + """*Optional*. Identifier of the shipping option chosen by the user""" + order_info: Optional[OrderInfo] = None + """*Optional*. Order information provided by the user""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + currency: str, + total_amount: int, + invoice_payload: str, + telegram_payment_charge_id: str, + provider_payment_charge_id: str, + shipping_option_id: Optional[str] = None, + order_info: Optional[OrderInfo] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + currency=currency, + total_amount=total_amount, + invoice_payload=invoice_payload, + telegram_payment_charge_id=telegram_payment_charge_id, + provider_payment_charge_id=provider_payment_charge_id, + shipping_option_id=shipping_option_id, + order_info=order_info, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/switch_inline_query_chosen_chat.py b/env/Lib/site-packages/aiogram/types/switch_inline_query_chosen_chat.py new file mode 100644 index 0000000..9a25dca --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/switch_inline_query_chosen_chat.py @@ -0,0 +1,49 @@ +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + + +class SwitchInlineQueryChosenChat(TelegramObject): + """ + This object represents an inline button that switches the current user to inline mode in a chosen chat, with an optional default inline query. + + Source: https://core.telegram.org/bots/api#switchinlinequerychosenchat + """ + + query: Optional[str] = None + """*Optional*. The default inline query to be inserted in the input field. If left empty, only the bot's username will be inserted""" + allow_user_chats: Optional[bool] = None + """*Optional*. True, if private chats with users can be chosen""" + allow_bot_chats: Optional[bool] = None + """*Optional*. True, if private chats with bots can be chosen""" + allow_group_chats: Optional[bool] = None + """*Optional*. True, if group and supergroup chats can be chosen""" + allow_channel_chats: Optional[bool] = None + """*Optional*. True, if channel chats can be chosen""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + query: Optional[str] = None, + allow_user_chats: Optional[bool] = None, + allow_bot_chats: Optional[bool] = None, + allow_group_chats: Optional[bool] = None, + allow_channel_chats: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + query=query, + allow_user_chats=allow_user_chats, + allow_bot_chats=allow_bot_chats, + allow_group_chats=allow_group_chats, + allow_channel_chats=allow_channel_chats, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/text_quote.py b/env/Lib/site-packages/aiogram/types/text_quote.py new file mode 100644 index 0000000..a882ccf --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/text_quote.py @@ -0,0 +1,50 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .message_entity import MessageEntity + + +class TextQuote(TelegramObject): + """ + This object contains information about the quoted part of a message that is replied to by the given message. + + Source: https://core.telegram.org/bots/api#textquote + """ + + text: str + """Text of the quoted part of a message that is replied to by the given message""" + position: int + """Approximate quote position in the original message in UTF-16 code units as specified by the sender""" + entities: Optional[List[MessageEntity]] = None + """*Optional*. Special entities that appear in the quote. Currently, only *bold*, *italic*, *underline*, *strikethrough*, *spoiler*, and *custom_emoji* entities are kept in quotes.""" + is_manual: Optional[bool] = None + """*Optional*. True, if the quote was chosen manually by the message sender. Otherwise, the quote was added automatically by the server.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + text: str, + position: int, + entities: Optional[List[MessageEntity]] = None, + is_manual: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + text=text, + position=position, + entities=entities, + is_manual=is_manual, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/transaction_partner.py b/env/Lib/site-packages/aiogram/types/transaction_partner.py new file mode 100644 index 0000000..a26b0fc --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/transaction_partner.py @@ -0,0 +1,14 @@ +from .base import TelegramObject + + +class TransactionPartner(TelegramObject): + """ + This object describes the source of a transaction, or its recipient for outgoing transactions. Currently, it can be one of + + - :class:`aiogram.types.transaction_partner_user.TransactionPartnerUser` + - :class:`aiogram.types.transaction_partner_fragment.TransactionPartnerFragment` + - :class:`aiogram.types.transaction_partner_telegram_ads.TransactionPartnerTelegramAds` + - :class:`aiogram.types.transaction_partner_other.TransactionPartnerOther` + + Source: https://core.telegram.org/bots/api#transactionpartner + """ diff --git a/env/Lib/site-packages/aiogram/types/transaction_partner_fragment.py b/env/Lib/site-packages/aiogram/types/transaction_partner_fragment.py new file mode 100644 index 0000000..350109e --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/transaction_partner_fragment.py @@ -0,0 +1,53 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal, Optional, Union + +from ..enums import TransactionPartnerType +from .transaction_partner import TransactionPartner + +if TYPE_CHECKING: + from .revenue_withdrawal_state_failed import RevenueWithdrawalStateFailed + from .revenue_withdrawal_state_pending import RevenueWithdrawalStatePending + from .revenue_withdrawal_state_succeeded import RevenueWithdrawalStateSucceeded + + +class TransactionPartnerFragment(TransactionPartner): + """ + Describes a withdrawal transaction with Fragment. + + Source: https://core.telegram.org/bots/api#transactionpartnerfragment + """ + + type: Literal[TransactionPartnerType.FRAGMENT] = TransactionPartnerType.FRAGMENT + """Type of the transaction partner, always 'fragment'""" + withdrawal_state: Optional[ + Union[ + RevenueWithdrawalStatePending, + RevenueWithdrawalStateSucceeded, + RevenueWithdrawalStateFailed, + ] + ] = None + """*Optional*. State of the transaction if the transaction is outgoing""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[TransactionPartnerType.FRAGMENT] = TransactionPartnerType.FRAGMENT, + withdrawal_state: Optional[ + Union[ + RevenueWithdrawalStatePending, + RevenueWithdrawalStateSucceeded, + RevenueWithdrawalStateFailed, + ] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, withdrawal_state=withdrawal_state, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/transaction_partner_other.py b/env/Lib/site-packages/aiogram/types/transaction_partner_other.py new file mode 100644 index 0000000..699297e --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/transaction_partner_other.py @@ -0,0 +1,33 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import TransactionPartnerType +from .transaction_partner import TransactionPartner + + +class TransactionPartnerOther(TransactionPartner): + """ + Describes a transaction with an unknown source or recipient. + + Source: https://core.telegram.org/bots/api#transactionpartnerother + """ + + type: Literal[TransactionPartnerType.OTHER] = TransactionPartnerType.OTHER + """Type of the transaction partner, always 'other'""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[TransactionPartnerType.OTHER] = TransactionPartnerType.OTHER, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/transaction_partner_telegram_ads.py b/env/Lib/site-packages/aiogram/types/transaction_partner_telegram_ads.py new file mode 100644 index 0000000..5df8eb6 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/transaction_partner_telegram_ads.py @@ -0,0 +1,35 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Literal + +from ..enums import TransactionPartnerType +from .transaction_partner import TransactionPartner + + +class TransactionPartnerTelegramAds(TransactionPartner): + """ + Describes a withdrawal transaction to the Telegram Ads platform. + + Source: https://core.telegram.org/bots/api#transactionpartnertelegramads + """ + + type: Literal[TransactionPartnerType.TELEGRAM_ADS] = TransactionPartnerType.TELEGRAM_ADS + """Type of the transaction partner, always 'telegram_ads'""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[ + TransactionPartnerType.TELEGRAM_ADS + ] = TransactionPartnerType.TELEGRAM_ADS, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(type=type, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/transaction_partner_user.py b/env/Lib/site-packages/aiogram/types/transaction_partner_user.py new file mode 100644 index 0000000..260c9a1 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/transaction_partner_user.py @@ -0,0 +1,56 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union + +from ..enums import TransactionPartnerType +from .transaction_partner import TransactionPartner + +if TYPE_CHECKING: + from .paid_media_photo import PaidMediaPhoto + from .paid_media_preview import PaidMediaPreview + from .paid_media_video import PaidMediaVideo + from .user import User + + +class TransactionPartnerUser(TransactionPartner): + """ + Describes a transaction with a user. + + Source: https://core.telegram.org/bots/api#transactionpartneruser + """ + + type: Literal[TransactionPartnerType.USER] = TransactionPartnerType.USER + """Type of the transaction partner, always 'user'""" + user: User + """Information about the user""" + invoice_payload: Optional[str] = None + """*Optional*. Bot-specified invoice payload""" + paid_media: Optional[List[Union[PaidMediaPreview, PaidMediaPhoto, PaidMediaVideo]]] = None + """*Optional*. Information about the paid media bought by the user""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + type: Literal[TransactionPartnerType.USER] = TransactionPartnerType.USER, + user: User, + invoice_payload: Optional[str] = None, + paid_media: Optional[ + List[Union[PaidMediaPreview, PaidMediaPhoto, PaidMediaVideo]] + ] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + type=type, + user=user, + invoice_payload=invoice_payload, + paid_media=paid_media, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/update.py b/env/Lib/site-packages/aiogram/types/update.py new file mode 100644 index 0000000..0533996 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/update.py @@ -0,0 +1,211 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional, cast + +from ..utils.mypy_hacks import lru_cache +from .base import TelegramObject + +if TYPE_CHECKING: + from .business_connection import BusinessConnection + from .business_messages_deleted import BusinessMessagesDeleted + from .callback_query import CallbackQuery + from .chat_boost_removed import ChatBoostRemoved + from .chat_boost_updated import ChatBoostUpdated + from .chat_join_request import ChatJoinRequest + from .chat_member_updated import ChatMemberUpdated + from .chosen_inline_result import ChosenInlineResult + from .inline_query import InlineQuery + from .message import Message + from .message_reaction_count_updated import MessageReactionCountUpdated + from .message_reaction_updated import MessageReactionUpdated + from .poll import Poll + from .poll_answer import PollAnswer + from .pre_checkout_query import PreCheckoutQuery + from .shipping_query import ShippingQuery + + +class Update(TelegramObject): + """ + This `object `_ represents an incoming update. + + At most **one** of the optional parameters can be present in any given update. + + Source: https://core.telegram.org/bots/api#update + """ + + update_id: int + """The update's unique identifier. Update identifiers start from a certain positive number and increase sequentially. This identifier becomes especially handy if you're using `webhooks `_, since it allows you to ignore repeated updates or to restore the correct update sequence, should they get out of order. If there are no new updates for at least a week, then identifier of the next update will be chosen randomly instead of sequentially.""" + message: Optional[Message] = None + """*Optional*. New incoming message of any kind - text, photo, sticker, etc.""" + edited_message: Optional[Message] = None + """*Optional*. New version of a message that is known to the bot and was edited. This update may at times be triggered by changes to message fields that are either unavailable or not actively used by your bot.""" + channel_post: Optional[Message] = None + """*Optional*. New incoming channel post of any kind - text, photo, sticker, etc.""" + edited_channel_post: Optional[Message] = None + """*Optional*. New version of a channel post that is known to the bot and was edited. This update may at times be triggered by changes to message fields that are either unavailable or not actively used by your bot.""" + business_connection: Optional[BusinessConnection] = None + """*Optional*. The bot was connected to or disconnected from a business account, or a user edited an existing connection with the bot""" + business_message: Optional[Message] = None + """*Optional*. New message from a connected business account""" + edited_business_message: Optional[Message] = None + """*Optional*. New version of a message from a connected business account""" + deleted_business_messages: Optional[BusinessMessagesDeleted] = None + """*Optional*. Messages were deleted from a connected business account""" + message_reaction: Optional[MessageReactionUpdated] = None + """*Optional*. A reaction to a message was changed by a user. The bot must be an administrator in the chat and must explicitly specify :code:`"message_reaction"` in the list of *allowed_updates* to receive these updates. The update isn't received for reactions set by bots.""" + message_reaction_count: Optional[MessageReactionCountUpdated] = None + """*Optional*. Reactions to a message with anonymous reactions were changed. The bot must be an administrator in the chat and must explicitly specify :code:`"message_reaction_count"` in the list of *allowed_updates* to receive these updates. The updates are grouped and can be sent with delay up to a few minutes.""" + inline_query: Optional[InlineQuery] = None + """*Optional*. New incoming `inline `_ query""" + chosen_inline_result: Optional[ChosenInlineResult] = None + """*Optional*. The result of an `inline `_ query that was chosen by a user and sent to their chat partner. Please see our documentation on the `feedback collecting `_ for details on how to enable these updates for your bot.""" + callback_query: Optional[CallbackQuery] = None + """*Optional*. New incoming callback query""" + shipping_query: Optional[ShippingQuery] = None + """*Optional*. New incoming shipping query. Only for invoices with flexible price""" + pre_checkout_query: Optional[PreCheckoutQuery] = None + """*Optional*. New incoming pre-checkout query. Contains full information about checkout""" + poll: Optional[Poll] = None + """*Optional*. New poll state. Bots receive only updates about manually stopped polls and polls, which are sent by the bot""" + poll_answer: Optional[PollAnswer] = None + """*Optional*. A user changed their answer in a non-anonymous poll. Bots receive new votes only in polls that were sent by the bot itself.""" + my_chat_member: Optional[ChatMemberUpdated] = None + """*Optional*. The bot's chat member status was updated in a chat. For private chats, this update is received only when the bot is blocked or unblocked by the user.""" + chat_member: Optional[ChatMemberUpdated] = None + """*Optional*. A chat member's status was updated in a chat. The bot must be an administrator in the chat and must explicitly specify :code:`"chat_member"` in the list of *allowed_updates* to receive these updates.""" + chat_join_request: Optional[ChatJoinRequest] = None + """*Optional*. A request to join the chat has been sent. The bot must have the *can_invite_users* administrator right in the chat to receive these updates.""" + chat_boost: Optional[ChatBoostUpdated] = None + """*Optional*. A chat boost was added or changed. The bot must be an administrator in the chat to receive these updates.""" + removed_chat_boost: Optional[ChatBoostRemoved] = None + """*Optional*. A boost was removed from a chat. The bot must be an administrator in the chat to receive these updates.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + update_id: int, + message: Optional[Message] = None, + edited_message: Optional[Message] = None, + channel_post: Optional[Message] = None, + edited_channel_post: Optional[Message] = None, + business_connection: Optional[BusinessConnection] = None, + business_message: Optional[Message] = None, + edited_business_message: Optional[Message] = None, + deleted_business_messages: Optional[BusinessMessagesDeleted] = None, + message_reaction: Optional[MessageReactionUpdated] = None, + message_reaction_count: Optional[MessageReactionCountUpdated] = None, + inline_query: Optional[InlineQuery] = None, + chosen_inline_result: Optional[ChosenInlineResult] = None, + callback_query: Optional[CallbackQuery] = None, + shipping_query: Optional[ShippingQuery] = None, + pre_checkout_query: Optional[PreCheckoutQuery] = None, + poll: Optional[Poll] = None, + poll_answer: Optional[PollAnswer] = None, + my_chat_member: Optional[ChatMemberUpdated] = None, + chat_member: Optional[ChatMemberUpdated] = None, + chat_join_request: Optional[ChatJoinRequest] = None, + chat_boost: Optional[ChatBoostUpdated] = None, + removed_chat_boost: Optional[ChatBoostRemoved] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + update_id=update_id, + message=message, + edited_message=edited_message, + channel_post=channel_post, + edited_channel_post=edited_channel_post, + business_connection=business_connection, + business_message=business_message, + edited_business_message=edited_business_message, + deleted_business_messages=deleted_business_messages, + message_reaction=message_reaction, + message_reaction_count=message_reaction_count, + inline_query=inline_query, + chosen_inline_result=chosen_inline_result, + callback_query=callback_query, + shipping_query=shipping_query, + pre_checkout_query=pre_checkout_query, + poll=poll, + poll_answer=poll_answer, + my_chat_member=my_chat_member, + chat_member=chat_member, + chat_join_request=chat_join_request, + chat_boost=chat_boost, + removed_chat_boost=removed_chat_boost, + **__pydantic_kwargs, + ) + + def __hash__(self) -> int: + return hash((type(self), self.update_id)) + + @property + @lru_cache() + def event_type(self) -> str: + """ + Detect update type + If update type is unknown, raise UpdateTypeLookupError + + :return: + """ + if self.message: + return "message" + if self.edited_message: + return "edited_message" + if self.channel_post: + return "channel_post" + if self.edited_channel_post: + return "edited_channel_post" + if self.inline_query: + return "inline_query" + if self.chosen_inline_result: + return "chosen_inline_result" + if self.callback_query: + return "callback_query" + if self.shipping_query: + return "shipping_query" + if self.pre_checkout_query: + return "pre_checkout_query" + if self.poll: + return "poll" + if self.poll_answer: + return "poll_answer" + if self.my_chat_member: + return "my_chat_member" + if self.chat_member: + return "chat_member" + if self.chat_join_request: + return "chat_join_request" + if self.message_reaction: + return "message_reaction" + if self.message_reaction_count: + return "message_reaction_count" + if self.chat_boost: + return "chat_boost" + if self.removed_chat_boost: + return "removed_chat_boost" + if self.deleted_business_messages: + return "deleted_business_messages" + if self.business_connection: + return "business_connection" + if self.edited_business_message: + return "edited_business_message" + if self.business_message: + return "business_message" + + raise UpdateTypeLookupError("Update does not contain any known event type.") + + @property + def event(self) -> TelegramObject: + return cast(TelegramObject, getattr(self, self.event_type)) + + +class UpdateTypeLookupError(LookupError): + """Update does not contain any known event type.""" diff --git a/env/Lib/site-packages/aiogram/types/user.py b/env/Lib/site-packages/aiogram/types/user.py new file mode 100644 index 0000000..56782f2 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/user.py @@ -0,0 +1,140 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from ..utils import markdown +from ..utils.link import create_tg_link +from .base import TelegramObject + +if TYPE_CHECKING: + from ..methods import GetUserProfilePhotos + + +class User(TelegramObject): + """ + This object represents a Telegram user or bot. + + Source: https://core.telegram.org/bots/api#user + """ + + id: int + """Unique identifier for this user or bot. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a 64-bit integer or double-precision float type are safe for storing this identifier.""" + is_bot: bool + """:code:`True`, if this user is a bot""" + first_name: str + """User's or bot's first name""" + last_name: Optional[str] = None + """*Optional*. User's or bot's last name""" + username: Optional[str] = None + """*Optional*. User's or bot's username""" + language_code: Optional[str] = None + """*Optional*. `IETF language tag `_ of the user's language""" + is_premium: Optional[bool] = None + """*Optional*. :code:`True`, if this user is a Telegram Premium user""" + added_to_attachment_menu: Optional[bool] = None + """*Optional*. :code:`True`, if this user added the bot to the attachment menu""" + can_join_groups: Optional[bool] = None + """*Optional*. :code:`True`, if the bot can be invited to groups. Returned only in :class:`aiogram.methods.get_me.GetMe`.""" + can_read_all_group_messages: Optional[bool] = None + """*Optional*. :code:`True`, if `privacy mode `_ is disabled for the bot. Returned only in :class:`aiogram.methods.get_me.GetMe`.""" + supports_inline_queries: Optional[bool] = None + """*Optional*. :code:`True`, if the bot supports inline queries. Returned only in :class:`aiogram.methods.get_me.GetMe`.""" + can_connect_to_business: Optional[bool] = None + """*Optional*. :code:`True`, if the bot can be connected to a Telegram Business account to receive its messages. Returned only in :class:`aiogram.methods.get_me.GetMe`.""" + has_main_web_app: Optional[bool] = None + """*Optional*. :code:`True`, if the bot has a main Web App. Returned only in :class:`aiogram.methods.get_me.GetMe`.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + id: int, + is_bot: bool, + first_name: str, + last_name: Optional[str] = None, + username: Optional[str] = None, + language_code: Optional[str] = None, + is_premium: Optional[bool] = None, + added_to_attachment_menu: Optional[bool] = None, + can_join_groups: Optional[bool] = None, + can_read_all_group_messages: Optional[bool] = None, + supports_inline_queries: Optional[bool] = None, + can_connect_to_business: Optional[bool] = None, + has_main_web_app: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + id=id, + is_bot=is_bot, + first_name=first_name, + last_name=last_name, + username=username, + language_code=language_code, + is_premium=is_premium, + added_to_attachment_menu=added_to_attachment_menu, + can_join_groups=can_join_groups, + can_read_all_group_messages=can_read_all_group_messages, + supports_inline_queries=supports_inline_queries, + can_connect_to_business=can_connect_to_business, + has_main_web_app=has_main_web_app, + **__pydantic_kwargs, + ) + + @property + def full_name(self) -> str: + if self.last_name: + return f"{self.first_name} {self.last_name}" + return self.first_name + + @property + def url(self) -> str: + return create_tg_link("user", id=self.id) + + def mention_markdown(self, name: Optional[str] = None) -> str: + if name is None: + name = self.full_name + return markdown.link(name, self.url) + + def mention_html(self, name: Optional[str] = None) -> str: + if name is None: + name = self.full_name + return markdown.hlink(name, self.url) + + def get_profile_photos( + self, + offset: Optional[int] = None, + limit: Optional[int] = None, + **kwargs: Any, + ) -> GetUserProfilePhotos: + """ + Shortcut for method :class:`aiogram.methods.get_user_profile_photos.GetUserProfilePhotos` + will automatically fill method attributes: + + - :code:`user_id` + + Use this method to get a list of profile pictures for a user. Returns a :class:`aiogram.types.user_profile_photos.UserProfilePhotos` object. + + Source: https://core.telegram.org/bots/api#getuserprofilephotos + + :param offset: Sequential number of the first photo to be returned. By default, all photos are returned. + :param limit: Limits the number of photos to be retrieved. Values between 1-100 are accepted. Defaults to 100. + :return: instance of method :class:`aiogram.methods.get_user_profile_photos.GetUserProfilePhotos` + """ + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + + from aiogram.methods import GetUserProfilePhotos + + return GetUserProfilePhotos( + user_id=self.id, + offset=offset, + limit=limit, + **kwargs, + ).as_(self._bot) diff --git a/env/Lib/site-packages/aiogram/types/user_chat_boosts.py b/env/Lib/site-packages/aiogram/types/user_chat_boosts.py new file mode 100644 index 0000000..3da8d37 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/user_chat_boosts.py @@ -0,0 +1,32 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List + +from .base import TelegramObject + +if TYPE_CHECKING: + from .chat_boost import ChatBoost + + +class UserChatBoosts(TelegramObject): + """ + This object represents a list of boosts added to a chat by a user. + + Source: https://core.telegram.org/bots/api#userchatboosts + """ + + boosts: List[ChatBoost] + """The list of boosts added to the chat by the user""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, boosts: List[ChatBoost], **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(boosts=boosts, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/user_profile_photos.py b/env/Lib/site-packages/aiogram/types/user_profile_photos.py new file mode 100644 index 0000000..c1c5d28 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/user_profile_photos.py @@ -0,0 +1,38 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List + +from .base import TelegramObject + +if TYPE_CHECKING: + from .photo_size import PhotoSize + + +class UserProfilePhotos(TelegramObject): + """ + This object represent a user's profile pictures. + + Source: https://core.telegram.org/bots/api#userprofilephotos + """ + + total_count: int + """Total number of profile pictures the target user has""" + photos: List[List[PhotoSize]] + """Requested profile pictures (in up to 4 sizes each)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + total_count: int, + photos: List[List[PhotoSize]], + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(total_count=total_count, photos=photos, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/user_shared.py b/env/Lib/site-packages/aiogram/types/user_shared.py new file mode 100644 index 0000000..59d1ede --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/user_shared.py @@ -0,0 +1,32 @@ +from typing import TYPE_CHECKING, Any + +from aiogram.types import TelegramObject + + +class UserShared(TelegramObject): + """ + This object contains information about the user whose identifier was shared with the bot using a :class:`aiogram.types.keyboard_button_request_user.KeyboardButtonRequestUser` button. + + .. deprecated:: API:7.0 + https://core.telegram.org/bots/api-changelog#december-29-2023 + + Source: https://core.telegram.org/bots/api#usershared + """ + + request_id: int + """Identifier of the request""" + user_id: int + """Identifier of the shared user. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a 64-bit integer or double-precision float type are safe for storing this identifier. The bot may not have access to the user and could be unable to use this identifier, unless the user is already known to the bot by some other means.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, request_id: int, user_id: int, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(request_id=request_id, user_id=user_id, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/users_shared.py b/env/Lib/site-packages/aiogram/types/users_shared.py new file mode 100644 index 0000000..351fc0e --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/users_shared.py @@ -0,0 +1,48 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from pydantic import Field + +from .base import TelegramObject + +if TYPE_CHECKING: + from .shared_user import SharedUser + + +class UsersShared(TelegramObject): + """ + This object contains information about the users whose identifiers were shared with the bot using a :class:`aiogram.types.keyboard_button_request_users.KeyboardButtonRequestUsers` button. + + Source: https://core.telegram.org/bots/api#usersshared + """ + + request_id: int + """Identifier of the request""" + users: List[SharedUser] + """Information about users shared with the bot.""" + user_ids: Optional[List[int]] = Field(None, json_schema_extra={"deprecated": True}) + """Identifiers of the shared users. These numbers may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting them. But they have at most 52 significant bits, so 64-bit integers or double-precision float types are safe for storing these identifiers. The bot may not have access to the users and could be unable to use these identifiers, unless the users are already known to the bot by some other means. + +.. deprecated:: API:7.2 + https://core.telegram.org/bots/api-changelog#march-31-2024""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + request_id: int, + users: List[SharedUser], + user_ids: Optional[List[int]] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + request_id=request_id, users=users, user_ids=user_ids, **__pydantic_kwargs + ) diff --git a/env/Lib/site-packages/aiogram/types/venue.py b/env/Lib/site-packages/aiogram/types/venue.py new file mode 100644 index 0000000..e0a3f84 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/venue.py @@ -0,0 +1,62 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .location import Location + + +class Venue(TelegramObject): + """ + This object represents a venue. + + Source: https://core.telegram.org/bots/api#venue + """ + + location: Location + """Venue location. Can't be a live location""" + title: str + """Name of the venue""" + address: str + """Address of the venue""" + foursquare_id: Optional[str] = None + """*Optional*. Foursquare identifier of the venue""" + foursquare_type: Optional[str] = None + """*Optional*. Foursquare type of the venue. (For example, 'arts_entertainment/default', 'arts_entertainment/aquarium' or 'food/icecream'.)""" + google_place_id: Optional[str] = None + """*Optional*. Google Places identifier of the venue""" + google_place_type: Optional[str] = None + """*Optional*. Google Places type of the venue. (See `supported types `_.)""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + location: Location, + title: str, + address: str, + foursquare_id: Optional[str] = None, + foursquare_type: Optional[str] = None, + google_place_id: Optional[str] = None, + google_place_type: Optional[str] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + location=location, + title=title, + address=address, + foursquare_id=foursquare_id, + foursquare_type=foursquare_type, + google_place_id=google_place_id, + google_place_type=google_place_type, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/video.py b/env/Lib/site-packages/aiogram/types/video.py new file mode 100644 index 0000000..e8ecf1f --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/video.py @@ -0,0 +1,70 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .photo_size import PhotoSize + + +class Video(TelegramObject): + """ + This object represents a video file. + + Source: https://core.telegram.org/bots/api#video + """ + + file_id: str + """Identifier for this file, which can be used to download or reuse the file""" + file_unique_id: str + """Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.""" + width: int + """Video width as defined by the sender""" + height: int + """Video height as defined by the sender""" + duration: int + """Duration of the video in seconds as defined by the sender""" + thumbnail: Optional[PhotoSize] = None + """*Optional*. Video thumbnail""" + file_name: Optional[str] = None + """*Optional*. Original filename as defined by the sender""" + mime_type: Optional[str] = None + """*Optional*. MIME type of the file as defined by the sender""" + file_size: Optional[int] = None + """*Optional*. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + file_id: str, + file_unique_id: str, + width: int, + height: int, + duration: int, + thumbnail: Optional[PhotoSize] = None, + file_name: Optional[str] = None, + mime_type: Optional[str] = None, + file_size: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + file_id=file_id, + file_unique_id=file_unique_id, + width=width, + height=height, + duration=duration, + thumbnail=thumbnail, + file_name=file_name, + mime_type=mime_type, + file_size=file_size, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/video_chat_ended.py b/env/Lib/site-packages/aiogram/types/video_chat_ended.py new file mode 100644 index 0000000..289eb72 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/video_chat_ended.py @@ -0,0 +1,27 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + + +class VideoChatEnded(TelegramObject): + """ + This object represents a service message about a video chat ended in the chat. + + Source: https://core.telegram.org/bots/api#videochatended + """ + + duration: int + """Video chat duration in seconds""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__(__pydantic__self__, *, duration: int, **__pydantic_kwargs: Any) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(duration=duration, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/video_chat_participants_invited.py b/env/Lib/site-packages/aiogram/types/video_chat_participants_invited.py new file mode 100644 index 0000000..74e1a35 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/video_chat_participants_invited.py @@ -0,0 +1,30 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List + +from .base import TelegramObject + +if TYPE_CHECKING: + from .user import User + + +class VideoChatParticipantsInvited(TelegramObject): + """ + This object represents a service message about new members invited to a video chat. + + Source: https://core.telegram.org/bots/api#videochatparticipantsinvited + """ + + users: List[User] + """New members that were invited to the video chat""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__(__pydantic__self__, *, users: List[User], **__pydantic_kwargs: Any) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(users=users, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/video_chat_scheduled.py b/env/Lib/site-packages/aiogram/types/video_chat_scheduled.py new file mode 100644 index 0000000..c82e495 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/video_chat_scheduled.py @@ -0,0 +1,30 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject +from .custom import DateTime + + +class VideoChatScheduled(TelegramObject): + """ + This object represents a service message about a video chat scheduled in the chat. + + Source: https://core.telegram.org/bots/api#videochatscheduled + """ + + start_date: DateTime + """Point in time (Unix timestamp) when the video chat is supposed to be started by a chat administrator""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, start_date: DateTime, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(start_date=start_date, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/video_chat_started.py b/env/Lib/site-packages/aiogram/types/video_chat_started.py new file mode 100644 index 0000000..a6f9aed --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/video_chat_started.py @@ -0,0 +1,11 @@ +from __future__ import annotations + +from .base import TelegramObject + + +class VideoChatStarted(TelegramObject): + """ + This object represents a service message about a video chat started in the chat. Currently holds no information. + + Source: https://core.telegram.org/bots/api#videochatstarted + """ diff --git a/env/Lib/site-packages/aiogram/types/video_note.py b/env/Lib/site-packages/aiogram/types/video_note.py new file mode 100644 index 0000000..5be8502 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/video_note.py @@ -0,0 +1,58 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + +if TYPE_CHECKING: + from .photo_size import PhotoSize + + +class VideoNote(TelegramObject): + """ + This object represents a `video message `_ (available in Telegram apps as of `v.4.0 `_). + + Source: https://core.telegram.org/bots/api#videonote + """ + + file_id: str + """Identifier for this file, which can be used to download or reuse the file""" + file_unique_id: str + """Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.""" + length: int + """Video width and height (diameter of the video message) as defined by the sender""" + duration: int + """Duration of the video in seconds as defined by the sender""" + thumbnail: Optional[PhotoSize] = None + """*Optional*. Video thumbnail""" + file_size: Optional[int] = None + """*Optional*. File size in bytes""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + file_id: str, + file_unique_id: str, + length: int, + duration: int, + thumbnail: Optional[PhotoSize] = None, + file_size: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + file_id=file_id, + file_unique_id=file_unique_id, + length=length, + duration=duration, + thumbnail=thumbnail, + file_size=file_size, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/voice.py b/env/Lib/site-packages/aiogram/types/voice.py new file mode 100644 index 0000000..d5e0abc --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/voice.py @@ -0,0 +1,51 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Optional + +from .base import TelegramObject + + +class Voice(TelegramObject): + """ + This object represents a voice note. + + Source: https://core.telegram.org/bots/api#voice + """ + + file_id: str + """Identifier for this file, which can be used to download or reuse the file""" + file_unique_id: str + """Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.""" + duration: int + """Duration of the audio in seconds as defined by the sender""" + mime_type: Optional[str] = None + """*Optional*. MIME type of the file as defined by the sender""" + file_size: Optional[int] = None + """*Optional*. File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + file_id: str, + file_unique_id: str, + duration: int, + mime_type: Optional[str] = None, + file_size: Optional[int] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + file_id=file_id, + file_unique_id=file_unique_id, + duration=duration, + mime_type=mime_type, + file_size=file_size, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/web_app_data.py b/env/Lib/site-packages/aiogram/types/web_app_data.py new file mode 100644 index 0000000..8fac379 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/web_app_data.py @@ -0,0 +1,31 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + + +class WebAppData(TelegramObject): + """ + Describes data sent from a `Web App `_ to the bot. + + Source: https://core.telegram.org/bots/api#webappdata + """ + + data: str + """The data. Be aware that a bad client can send arbitrary data in this field.""" + button_text: str + """Text of the *web_app* keyboard button from which the Web App was opened. Be aware that a bad client can send arbitrary data in this field.""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, *, data: str, button_text: str, **__pydantic_kwargs: Any + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(data=data, button_text=button_text, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/web_app_info.py b/env/Lib/site-packages/aiogram/types/web_app_info.py new file mode 100644 index 0000000..fbf9846 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/web_app_info.py @@ -0,0 +1,27 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any + +from .base import TelegramObject + + +class WebAppInfo(TelegramObject): + """ + Describes a `Web App `_. + + Source: https://core.telegram.org/bots/api#webappinfo + """ + + url: str + """An HTTPS URL of a Web App to be opened with additional data as specified in `Initializing Web Apps `_""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__(__pydantic__self__, *, url: str, **__pydantic_kwargs: Any) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__(url=url, **__pydantic_kwargs) diff --git a/env/Lib/site-packages/aiogram/types/webhook_info.py b/env/Lib/site-packages/aiogram/types/webhook_info.py new file mode 100644 index 0000000..1753df4 --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/webhook_info.py @@ -0,0 +1,68 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, List, Optional + +from .base import TelegramObject +from .custom import DateTime + + +class WebhookInfo(TelegramObject): + """ + Describes the current status of a webhook. + + Source: https://core.telegram.org/bots/api#webhookinfo + """ + + url: str + """Webhook URL, may be empty if webhook is not set up""" + has_custom_certificate: bool + """:code:`True`, if a custom certificate was provided for webhook certificate checks""" + pending_update_count: int + """Number of updates awaiting delivery""" + ip_address: Optional[str] = None + """*Optional*. Currently used webhook IP address""" + last_error_date: Optional[DateTime] = None + """*Optional*. Unix time for the most recent error that happened when trying to deliver an update via webhook""" + last_error_message: Optional[str] = None + """*Optional*. Error message in human-readable format for the most recent error that happened when trying to deliver an update via webhook""" + last_synchronization_error_date: Optional[DateTime] = None + """*Optional*. Unix time of the most recent error that happened when trying to synchronize available updates with Telegram datacenters""" + max_connections: Optional[int] = None + """*Optional*. The maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery""" + allowed_updates: Optional[List[str]] = None + """*Optional*. A list of update types the bot is subscribed to. Defaults to all update types except *chat_member*""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + url: str, + has_custom_certificate: bool, + pending_update_count: int, + ip_address: Optional[str] = None, + last_error_date: Optional[DateTime] = None, + last_error_message: Optional[str] = None, + last_synchronization_error_date: Optional[DateTime] = None, + max_connections: Optional[int] = None, + allowed_updates: Optional[List[str]] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + url=url, + has_custom_certificate=has_custom_certificate, + pending_update_count=pending_update_count, + ip_address=ip_address, + last_error_date=last_error_date, + last_error_message=last_error_message, + last_synchronization_error_date=last_synchronization_error_date, + max_connections=max_connections, + allowed_updates=allowed_updates, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/types/write_access_allowed.py b/env/Lib/site-packages/aiogram/types/write_access_allowed.py new file mode 100644 index 0000000..6b8e50a --- /dev/null +++ b/env/Lib/site-packages/aiogram/types/write_access_allowed.py @@ -0,0 +1,41 @@ +from typing import TYPE_CHECKING, Any, Optional + +from aiogram.types import TelegramObject + + +class WriteAccessAllowed(TelegramObject): + """ + This object represents a service message about a user allowing a bot to write messages after adding it to the attachment menu, launching a Web App from a link, or accepting an explicit request from a Web App sent by the method `requestWriteAccess `_. + + Source: https://core.telegram.org/bots/api#writeaccessallowed + """ + + from_request: Optional[bool] = None + """*Optional*. True, if the access was granted after the user accepted an explicit request from a Web App sent by the method `requestWriteAccess `_""" + web_app_name: Optional[str] = None + """*Optional*. Name of the Web App, if the access was granted when the Web App was launched from a link""" + from_attachment_menu: Optional[bool] = None + """*Optional*. True, if the access was granted when the bot was added to the attachment or side menu""" + + if TYPE_CHECKING: + # DO NOT EDIT MANUALLY!!! + # This section was auto-generated via `butcher` + + def __init__( + __pydantic__self__, + *, + from_request: Optional[bool] = None, + web_app_name: Optional[str] = None, + from_attachment_menu: Optional[bool] = None, + **__pydantic_kwargs: Any, + ) -> None: + # DO NOT EDIT MANUALLY!!! + # This method was auto-generated via `butcher` + # Is needed only for type checking and IDE support without any additional plugins + + super().__init__( + from_request=from_request, + web_app_name=web_app_name, + from_attachment_menu=from_attachment_menu, + **__pydantic_kwargs, + ) diff --git a/env/Lib/site-packages/aiogram/utils/__init__.py b/env/Lib/site-packages/aiogram/utils/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/aiogram/utils/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/utils/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e5a6621b4d5a5d27cd30473c77d27c4277d1118a GIT binary patch literal 183 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/utils/__pycache__/chat_member.cpython-311.pyc b/env/Lib/site-packages/aiogram/utils/__pycache__/chat_member.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5af477a6991a1b546e2c91670edb38edd8e62a99 GIT binary patch literal 1338 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/utils/__pycache__/keyboard.cpython-311.pyc b/env/Lib/site-packages/aiogram/utils/__pycache__/keyboard.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4c85129841d8482952197f4ca85f0dcc3cc0c6f0 GIT binary patch literal 19088 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/utils/__pycache__/link.cpython-311.pyc b/env/Lib/site-packages/aiogram/utils/__pycache__/link.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5f949afe8675c3641b4d5e486084425c7b1d0dc1 GIT binary patch literal 3649 zcmbVOO>7&-6`m!R%i+I7{r}6B6pKSyX@@J zwggIL0UvCjDAb^Vg}OnBB1jdq2OWx{#~gd;VOg-~Vu1h#dg_gUZaVe7U5cVim4^;@ z-n^Oj&CGjm-n`)-B9S10@|PEX-~J~h1-UM-B{~??I%n%t;YB zupN}5PlR-^f$oH)QVftGsS8%?Zp;>>_!B-Ic6PWJ>w&RIfL#5PrldYtq5lJv+LiFw-rMS~O+PFcil&M= z7zh+uPFA-xNw)pK{zOyMy`cw&QPAH?r6g@jPl}3`Wnw-l$q!R|exM6W$;W$qN>)>6 zTxu=B*@0~)X7jRYWNa_2Ve}+;8_3~$8?7A z%R)eO9>^q=v(^u@#R&RzSNF1y1)K0Ghxoj0$@Pd5i+2#}o zo2DImJ|hd41(*`21EI$-K-)U=dK&3DP!Id(Tysb28q2 zS7Fo>r|FYG8VZ}CH;;KB?sp#8=1VU>lpBMM3$76ZcG9dz-di+7n5~^DO-riZ^}%!!;1P4?o0-Ef?h#UFVL|9 z)AE`#-v!6>q6+(D9x9ToWk3%@w*#W8sk?ctsN1227zJC99-0MX9YgT+$8e<2!L$33 z68CdR8l{NDErTFS_M;^aB%WvmdhJDeC2?_Xn)+YpSJD-r`3`IImy;WyeI3xgHnh+I zEwrKi9nk(ZH0^+j<5gUPeR2 zL@{D6Jx|2RDUn7_iLKc|-4L0PWm>Vot^u0iMQ2k;rjcO2W3M5(fn*j*0?8bbc_3%p zyzLXEyrL$&wjdS?vMRA|l;TBB#MlJ#lSux*4Q#==(r{}EGRrHv4*w~19bW`U)UCx$ z+5?TGf|p;FbNJ}Fd1VP^pf36|@L!qK$4RuSyb4c|=^wQwW}gaAOI12*#e2)|TmCq{ zPjeRS`4=7j2OU28c9kY-G-1+&ld_URgGR%dH2V#feKS)m5OhPO`0>(V){ws1H^mjj8S;q(6 z7Vg}?y|(fm>&H1>Na4<7$?ySmUP31*ZGKbJats6FOX4Wtgw7dV&TCRJC%?^Zfe3Gz zJ^*>R?&UbnB9rD-pGD@)tG<_A^W}&Yh?j+zJ(Ffv3ckv=+X5{|>H@jLt#WlDaIp(= zxbE;3IB*z08T{+ipT`{5{K%D~)$Gw{iFu0>GOUM|AU8$MKsdZsYJRBupl!t-&#CcmluC zYu4CxYiJxl;3uZ7{t=MYN9MV2)CmwP+FkcT`!Y6g5!#QW=hnB5F^#SAtNmp-u2)SY0!%<_D Q2!Z+-j-f(V5hrl|3w-TCCjbBd literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/utils/__pycache__/magic_filter.cpython-311.pyc b/env/Lib/site-packages/aiogram/utils/__pycache__/magic_filter.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d98f05bd97571472415a2593211f9788fe56b9f4 GIT binary patch literal 1836 zcmaJ>&2Jk;6rb5Idz}~ulFA7r;D!U3k5q_)Dnve7P)iXQiBv*bSz2wp<7mlxH_WV~ zHu51z94v%H4oHbWNI9jA0uraH5*Pje4z3g=Yfng=xVcJCJ@MYGv$flV@y_qPdGC2< z-q+mD=W_(c-Jkxf|ELi14=zrI-e-t51MO|VkF11uw zVVbMDT3v&?f`#BR$KT3}}ps^M>4aP@c_t@Yp zYVx2`gOH{Jd367H0$_)ZHR^0n#* zq3Z>!)wL%07;<|hjH)cysD9$DRD~C@H`kronzPD8)$zhr?ldkmBhMEX8W=IVE<-lA z4&k(IFYqGU-YlKr(%gv!x+L-dTckTN+19=@+weOE0g3eu$8WMYk9&EJZ_8yZ%`%v1 zFs0ic1A}gVU5qHO{n4V)K#=xuyuKu@KVc1fvo+V?lP*ctx1`~$EOy&Cl5AN&rbQ-FEQ#I~ z-86xLWoV!Fu=!<(fvkXEnkHxicrQa=GUUa82W-G4zyO7S0R#5bHxJof^0ad9$##&mDmz^4*$I+1SII7rw7ZVB8zkFZC3`@!!&TA& zlAW%Sy&&18>;s1PmsvjWi4fiWO51DDw#QY|*I|SXSIHY7*;^i0P!7Tv`;-+(W0{)S?ETF+&Ziki}htY@@*aaT?zvx;^*U)A`Mm+-cNI#+B=X?b1E z>!b^zzEZv$2RqW@E#elF8qU&CY{` z8cEJ*dQ8oK7`vL8i4`)sdVEe!&B`~`LQKwRH;J4J&g+?MAz0$!#N3^tH;K<9@MSUc z3J0NZkNa9|`_-9WocZv6hqU_j0zn z4SL#j>pfW&MwOpu){u5k#%7FchjLNS)sJ+t8;TfF3VQ+WasSxPZQHTfL&eUe0sx*u zC)o)yhlxl(Gf{zp)5Ke4bE^%%ResHSDN4be6*`Px+&wiElm3rCOnqW42NJFof$f?iz|@CillPv>`w!cVK#8NF#_oV*S~34Sl$1hDvg%@hxPrkUO6o{l^_P5ZCY_s0?YuN&PVvpYn^ zupx#`F-(PUeb5=H(3#QYY$mmpo?0T6d8yADpKQ!4IRrd1I0l7+!%MrK_q}8GjjXC` z5qc>>qjAJb38OD*_9dw}ZHUvRI8BA=`k-}u16sG%PZ?hu^I2?6+ngT;K7WXuIz098 zlXkQB{8RN=gbsx1wGiS!*yxRzy%8!-7~+H}PEcW@J}8~4P@2>7+VR^N1?HVCjH?cB z6;hg_Zsx0<=&J~WSis4%K4_}?plfK_TJK{FY~p?1G~=)fsJV*tyiwxlCExNtpP%K8 zy=f+^rDnHiu6Fp8XO3*@QoTqJLIi%!@OR|7zu)u^t-ih1Lx-nmB#JmZW%y&JKSss4 zA;wKHPK9`VIAQ!-+1*-KWXx^iib5Kx4*;z*NbO00@_c>pv!vN|_UYTtdg!_FwE_T~ zM%Q(->pB%fh8Qx%5EVl8L2OkJoXYlYmIygx~6NrP8#<8e*EK0>GL!2_jDJo3W2ea1Z zk?n_IW1N{)^)%7uZ~pft@K(oTHuGPM1_a?_oa3|CWvZ0_WVsFYsT!lJQ|VkoOq1mo$=-bt!c1>PE{1rl2F~0lK;*Js?Ab zsf?lkfqd5QVf%S<8d{jcf)v9k`2j$6HpJ?I-5#K%2cYb-_ICc+h!MDA2CmQ#TxPNF zm$RSLa8~Pq|0-VucQL>d+oqR!B4>~Wv`Uh!bdfiWgp#w+^blpZ2rbX})(-uv5u>gU%Ma5A=95uyJDvZ|07aXp9!E80kQac;@+P|4%bIkB9mEkuFk^Mj)LHI3_=?Ibj z|H}}0&7I&{$NUe;W&X)n+axrK=_>XIfZ5+8yN_|=flTfL_+#Z$4@*xHX8+}kqFPZ54VSch z_Ku$khUL68qe}AySX|!Fh$JhRtCpZOlY^YJq-&CF%_cduP=FRkKGQwa-EHodr8H4* zoIi56^~gYX=b5)oo;ueblm{L|_S}kbXn_3%H>W|lB>ReShy4fm6)<^uk6VYVZ(tD; zzJB`@{LK6@|Nf#+zcUA#612Ry9g_o9{}&Xjuz}eqf~=4o2$)m0GJcrPvvN>}vDArx zfrIVI*zSQXbJ==~Eg0BjW(8x6H0%o@_#z3aOfDc`Hk!qxmreaSO_|TC1LPvKp{a$> z1&&+y@I3!D*Fl}ve1r{9Lev@CP-(oP*01)l zTROOIKNe*+KnWL_)-u0Tuw;+ydTme8peKOMlWc$zF0v<2^2;7e_QVl}+$V!`9V$3ni)5W+RvYZqvkv*#IT9ObFYrF>JqulGM?^gY)-c zgTe+V;SwWH;g^{v3cq64YkLBTf#cX5V*`|MX_wWue9F46*!9|;Fu?JX>s$*DYwZ%C z;ZR;qvCE28tB9@A0q(?`INUUQa0xBXo#vMdmTYCbwvXM?fwV0$%Ydp*Yz^BMyHnM~ zkMWDlkTHJg6!stEEd$4x4zD0EbK(`Hkrp%zZidSWJhNnSRp|hCEQo{0*`Ot~6pZuB czy``zm;xoKqdyoHuv{QusmVSQS73qcpXA(@EC2ui literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/utils/__pycache__/media_group.cpython-311.pyc b/env/Lib/site-packages/aiogram/utils/__pycache__/media_group.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dae3bf1c9cfc3bab57e14f50664f11d008594947 GIT binary patch literal 17076 zcmeG^S!^6fc0Kpa84k(eO|?YH;?TS#*|JT`vT2dF=@lu#q_o~ytw*itCfU+l+udVX z42@_FAxj%V%w5PZfmHy0Y#cA_4M^C zk82<>85hrF+#v>k_(9$+cm%KDv*>2!cn`eu+saMjim> zD6~!5#)>ucZD}aSg*F0vJD<4W{|o^9!T^%VwA(Ogz3tVp=r9`CW_i?DBmv5lZF~dD z1mCthln#m`<=bzEba*@O6W$J(6L*~7z7{qZ9%fZiFt&YFIvdK3tJc+ke=~aY@ZH}- zkDl8;oeo`303CW8@G{ml$@lHVgE!uK`F_|}?YN(;eYF&TJ-Bo4;3~F0qE%~LmHXdI z10XZH4QQ9VyF&Uf{M3veTKIi1bB~i!SXx4f^?0fExOlvaX91^P3#TRDW5=Z#pCwS!1&1>oqr&Tt;!t10~ZISYx)Z?~Z59Rdy{i zpFyuL%${JCAlz>5M^F`J_2&&CUlt@bm*-@eT`EcJB}7FmF0%v^b{Wx=$HHcZ$ucK# z1^RZ9onrG~ap~%BauPo%3q!hj~-^;lCIM;V`(~}o|T#~L_I8{QjU$|0{ zIHe?IFO`%FLh;=Tr^QPbWH9JP%UtdXSWEH+PAo0M5{y?AF)xpkiL+#x#>&^!U^Xij zMJ1bE?U_SXw6o`!@eVC3`8Xuk8Lf{Q8eaF_jMO^^;44~ZC)T~SVE;G4=*Q8Iq8sNn ze!6*SJGj3V++Q_5_n;?}Gno(yhz&C0Jr$Bq8O3BehFNndww6v)R*ox%p$+|bmy=;X za47+()}J-zvbklP?G$3h(`Hx5c#?Bmx3m2RF8f$pU|jBe)*4_zlO8sYXMXh{AuC&` z0ApPefRAK_E9L}bGRq2H9jC3xvamU>cvxX`rJ}+C+Z9TZ0KCT)*&`FIv0uQB4~w!f zm=ptu)bM#OUlC>`sU)eMyik;Sv9^6~>h0{@%=GM3_Vu^UoI9Icn9a^pWRa;zFTMjFj;C(qQ9XR6UNz&$r3zYq4@ z3HEG0+rT{%3p4G`J(KX}Q{b3s=4YMngV@`G^3G?iVLe^U%`RM>-?`?~F6l6INP8?Y zsIG#HtOrI$E3p)<#8z4WDOY@foK?AB5RHt z2k4?dlv6y&C>=Y=1Jy4a#k*vz;TqMXP|?L1j5}6 z3F#=jOb5RQ4;+p{j|6eRE**oKCa}-JD+Bf}#)3VhhLn{`;Zl(k^Nncuu8O>}qWV_^ zad|}{6jYOPrCcsa3gD+m0#^W$O)!*DoJ!AO@;oNUMkdy{WP4*BYs8uiN7RK$R@>-= zRd5PAH(5-S83sAXH)Z!dX!29&VbJ7&jV3;djB|E%fEQ)%QeMcSAOk&`Mb6Fgf+FOQ zx1|?hG!tVK+jOuE>}b|!Y;i&+s`8<_Q2n3>?gYX&t1F3i0*0Z^1WTTs~f zfI;eZYAujVZo5vqZ0ffwBqzn)V8C5A4Kv;=!sx$s{kaRYht((@=6qtaVZvB-m zT?S6s%_7`kTvEw5$^J;VcC{qI5YjR^RH7EDWf0OK$IR&r23Z7?lY19-H1aEZWydJI zfXb3BQ5&#;b`p!+Y>hNYt@KHDzEl*<@gZnO{_+*pb)I z)1*Nd($H(T-$8-k{&VWKJvRIM&`17PNI-ZenAXlu!@mx19^ZOqJ26yC46Xa>k;EtS zwf3Pqk)dj2s2=TEpT0R?jUI&0=6U*UruA6zlVUA3d?z+sjSWBYwxf4qqt)1GJ=(uM zU5oZtqle+M<)`0f`UkX2UixYV68LN)v z4NI8Y1%8)j&AaAX^RETgg1qZ?a4m$J*lA4CEuHpO{swle$tZ;Hi!51nb_vwreX%`Z zr%4viTd}j*p)}#Iv-RMOW(NVMMD^#uI25wJ2N#n9V*?;_d_5@NBYDN)Q z`Q$|t4&Bc+je|*c*f>rf9%B~`n*r^9Bm{QH6;obBbDwwy%S8ZyXT>FROa#sx5NKP3 zV|vt`rk_hj5oK04GN3nIxKSBo1I~(`gKn*`@=B?a=N*F+hlG9e?9A&pB%sZ5z$<_l zIOOPY9G#e8ue^%RuPm;@fK%3Rhh>(SJERA-cpO91+1O$U`7I{^XvdCDSajFPWqR;- zVj14NPAa-9fD-^(q}T{MF?wX;=re3?1&$VSz)-SdW^M_pEYBUSYdgc}Gh0TtbEW3M z3@7x}`&k3&M*tKY9dHXFT&o2^U@uZaD#$hT;6i3ktSCxZ1{Tl33XduJCL1eB%j4j- z%i~;G9JIQP>fKIW%sTLb7StI88wzw49J1h?_&AAaJI=6Ewdv6YkqPJza?+m199LJw z+={`i4glds_E&jBP=Qi~I(1r^s6iYpj~#4>^Z9 zYg9YNX#|0IP|l8v=u|c7w5v)7egY~X`_1;7E{YUEE`>~kn z)mq^tX`v;Vwr;J>DBkr%L*Z{3NHk|cb*E`k!hEPViS9fLnFrUMpfy2%?x8hb1MAmZ zR%$I0!|4CMzBIAI4UM`JMD0WCOUIz5?u5grCq`f1j{-1P_{mTJ6r3Lv0GyCNhyt*k z@i=8Lu~;W_pm!%PE=m>QBA7sg`6;1`U^|fe0a*PU1|$eh8|JF0tblc>A0L4^B2x3s zK-@$?Eqj78K-3oDK z9HT!1w`MoTsllybXHDmgNG`)K!)DZf1w*;%np%cDF1_h0%KAkR$URAb>qYQ^!8y~t z#ZobU%^I3RmmmFOoOpzlOYF5$#X$$`b|3z>E_p4d@hS}M#K1A^gIE$yG#?>z-j5Ao zN*}|9aG}rKp>8Q=@I*#2MY_DcRQP(*NJ&=ONLyfX&sBLDH5t{rvG>~~n zz$m-maGs+(ooDc+JNwav9(=YAMp_3n0Vf%f6dGxrM)9tv1&uUFG-pDMH1qxiW<{up zk@gm3{wGEn7-w(hj*TDKK64DU+Yz+QR=clbXUBkhA3^K3TGL}^#O{f*)f~7{yN#H54{NJA#%*eO zHoYbJU$xcj!sy8`*G!21e_Ct~X3?)XbWBIshdlP*GYG^ft)^*P@MS7W2@i2{_UkMM zka|oBxrJxVm=bbtgCefcXW7k@cCz?X{wjA(X6?sNBgQ$Dx%zn11{Y8)_(X8iK>|g= zt>W^RDg|pa=W&w>HAH(gJ@?136{q!se-mPaHtpH1S!mO1Fu>}-?pFi`K0^@5BEJm{ z!O%Ht89D` zWPa&_pfuNq%w^*}Bf37qvf1YsaeL`Q7w@2n{DO;!|h{trd#`r(Aez3Wt<>Ff!a& zVsS~7AoP=le&{hRpkGCW1#T)!0y306T-vyGGOp|F9c@>B#1ft-@q#28a7U<88=!da zA|#)ANqb}o zk!Vn~jG;`RrmtTo_WF0>6Sx)-g-|}Z`t(kQCh_NEC-S8nmzPgM#%L@ecmD*&`cGhQ zCXfK;G?KefrnP^=w^7joOndj{)UPKuCbtg$cBFb>Qu8pasoy8qI|;TrG+9ls+ld!z zi5IJh7r*J~(L%-uWGuqoX+4^eL~e$JA_N}6CA~m`Z;kL;wB$*6?ZsCJPO6VUz1rCX z9q>9BSwhee_5?Hj{NJ_zLtl0DwQ8`Z9*Nf?Y&9}cfA)pivu{?T1J!*;wxdVu~T0lPK56wRle0p6ADwDJoEGO=>ZH5$7qRc zRt;w{KD7ez8Cf-&&HlW?<>?y2 zcxy=Fo}`yChmmCxx<0B$EGiQ2UJ{-uO<|q)QmK@ePGRK?Ca++Er|Z%*CMfKrbC?{( zgvA8Im?exqBS|-8saQi~J2IMyYYw%*NSw??&A zEG3!tzRgp&UeemI)XpTjHa$1rr+|RRo6D3f3i<)W9Zx>m527+;OM0Hmq+)a62$(0$_rRwLKKv z@wxe1E>!Zd3 z#jw<3EKnRv3FiW}VqMZ$gf=X-Gp*g5ZMR}t2bN$-=;C!^sf+19w6%D9UhBqEk3kIr zd>>MyAL|E@8v8J3B4knnYY*n#dk$)W(3 z8YzHvNhW>dtM)HjC=l(4Ne9-a5R*>KnShy?U~OO0_wwc`+^a8dO_Q(2WQ-XevliXl zcWo0s&?b<46K}V+mk(?GxT>?Ywx_fJ7K6rOhOiVi7BhmSsBqJiAjMlThx6EyMVEt;4cn*l1U81m2^rSf=!r#(o>;QziKRw*VqJ@|IpSD?I99qj zTCoHIfYQ1ROYO$y=)h9SK#+jeg$Qmb~hAAP74meiR!(;zSB-ZAf9! zLJCV3Qdnw43hP=7ekW6afKF+xSf51T+AxRH+L9GlyDz+e~U~d0FLm@wb_Lm3$n3)X_@=tuIH;>ifHok?Q{Rw|IkO*)@6R8Ji#Y`|8N`zp(lnC==jHsR^ zqIw_lggl17)e;e&Xg*bb$N?7qHEfj8`+(lBd9`R)eSka^fDZmOx)zn6B=Nw%@iESs zfn+Y1H4jl zZzO3XSvOTRl2OlDb3n!`-8{ zs{y!s)ebcTcUkRJcd9K*Qo^T(VcT6a43kX{)rY$G5`sAuW6tH zgPLC5>HtpEwaknuB885+kHt1W8hLN}(>$G>9?q-j+_mZ10!w|N*X(uc=AGS3xh;Io2PCo%)k^C!u z?8%NNH@_2CqWt%KKV4sO|H+1fSV6Ma6Y71P$SSQINZsHNg7<|Oj4xpgj0BRzjJE3m| z6a@qZ8_g=pe0yUT4s<)tL0vBr;P3A3`)zlBU6S`ue3L2NNM;I}DNf{bTFRjN0T34&EYe;;=(t2I7PA=zg>J{Fjm8b>EdYSguAZWJ*SEay z%Wx5XjMwdDh+=7$;rmUj(Y?5`WjQuCs+QS~8ymd~=R_=Sg3-HYms7~QL_fk!FVIf}F{tG`Q^B6~~nUdGXc=~cCv zWFcd0hU!7-GV^4oRz+9>p1F;8EhZhNx8m?>7_7AgZh?2l+?vkgJTpvF0P}OH{xHmR zsh++CnE6m+PcVbo2kN_KlfS+5)t&p3EB&jH!{x}~l6;u$3EmL}8j3a%7n$)>REvd0 zzlwVtSX`8On>F6I?X2yw{Wuj(*|i{Ug&sk`*uY-gZ_0|2OJ+4iG5v~?&8vkB_CbTc zDkL+t5qXa0=QL_q;f2O8|I{*Dscl3C+$U?698@(;+z0*F~m6m;Eo{fe*=qemO&y-IV}a8+fB53 z+(s2TzX4CJXR!;A4j_~9ERgIhk{J%NS1=)JlIBsnR9|y`Ysz+BM%S$d--vFP8hI_9 z$4AuN>K?UqN!s!*kJ_WQH?NS8fz!Qe=N7!LNN#ZnKP0vo#Y{5ak3I}p|3;GPgEeVE zsc^YTa97NJr3uA~0xLGadZf>vm9qq)x8av`okY@-^=+#ukWT&%=a)$=+ArhZ6Ugl3oB$FAaFt70T35VA(heTPoQu5Ku*@oTKHMC{OUazoIkjoU=kyhKS_MC`y~u|(q5ZUC`%is6yg!8hV;gaY&voo0 z24;?0+fS$u%WEpA1V*_p$R&~!Z<1TWC2|vzdOeMMsUK!gCIF1ZOyJD9ScWnK=kod4 z!rUm@3gmfP<)*i0gYI1aX3A$avjA^fB>(Y~zJqJQ&T_Et52wq)<4-2b?~K0?_&)zj z0)Tl{RrdHgDnlpALu1c}#-9z1uMV9r51lWL6~|t!MY^j*^mQ~qCDK_XLa3wC-Lvdn z_O3_Us}gD1x$Lb2K`hdB|G-MyYUDsUasU+U z3$L~Aszj&1(f_niicZ7z*O9-sKOO&mygc%mg#a^Z3xgT8g{y=Qg&_b&+hFqZNc>qO z{>_2a$gy(dSV=x+g+$3fJ-gJ3S&pd{bBOztv3<^L7B7DOsCyc3Nk^iZLq3zZLDYWz zoD^ciwuJh&4e%}+6pxN4oJF!O2OtSOm-j!D_pe-7m5-F=Bc=Mqb_r!PCd;P6pjG{p5`~a{lb^gq%1h5!m z71<#iI0=pgX}xjk>>oHSel8m?FDQKnu-;m%GMA2bbE-^h258%TL6%m6OjABBh7}_XCONzPQ$~{c6 zEf&23Wv-Uf@e>@yY-W1F7Eqnm@d%BMy_aHjWU+zA$W8f_brSo4{t_NRvqXOZpek@2 zS0Q~R_q9%1OZBTlJ}v#&Yh8$fJh;OZF;9vQ-m0gAgCo>d@B(o!8v}2Xw(jNr mQumS7)`4>Cz+$B8Imv-4wu1X7S5B9A9e;sCFSi+IBKa?{SjL?I literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/utils/__pycache__/mypy_hacks.cpython-311.pyc b/env/Lib/site-packages/aiogram/utils/__pycache__/mypy_hacks.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fc544c0873a50cc8e86def20114a5fac9f8b3e3f GIT binary patch literal 1076 zcmah{O=uHA6rS1LY?A(%N=4AqAc6+8g<7N>9F7lTbnNvGcuo^WMC9?|b{9zrP28 ze0lrb{)`d&sf>=K+nbgJn{C7p!!F7zt+}|O<+X~Q*D=x%*O|TpxA$QEmb}4wn8_0? z$xW8x8aGOq8@6_-6M$@!rPmVqB*TwUw)a?_&t|nKHBDWY7F-@B=fWy~LPdn8bOPNkT3*0PNaw1I7n>1%y2 zv{emiF;?F65D?p09w)A-%@=90%n9{8UsCD#9$`KYylavy`C^eQIkHSBsS3Z!g$(1X zvg`z;OpA*IwC}kg@i=Fk5!)9;Lb6Wu4HEc7HFG9?K&SvaP=TS^$0;Mju6aeFMpEpu z3`PRhAgtCsfGuqsrXkPxpLO?}cvIT}ruMpQt)f3?2EAi7g0y-``o0@P>2Cj7UG%~W zBB>w+5Ga;Oy?&azKW;q*Cah_nIbO+HtO+W8F<Km-jit~^ls|gd-Og1G{#gPev27-hlPN@Ght}D_VPew)o z_>PPCh~mp}Ri~+miqC2;pA;7%Ud=KH0h&6-_y`RgbiN~W_26&c52LsKaAW#qZY@{G lO*4%Ln+V`_5Ubq_vHE&_e`^2MH@ttlG5#n%`6tAs{Q}u(3H<;7 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/utils/__pycache__/payload.cpython-311.pyc b/env/Lib/site-packages/aiogram/utils/__pycache__/payload.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ef6de3c68d2ebf232f6b1e4792f4832094f5c485 GIT binary patch literal 4025 zcmb_f&2JmW6`$p|cTLHbWks=@XduNh8Ida_PV7Xeg4U8+6ipl>hGRexLM*vMYNI8W zm|03CLAxpt6h5j&0jo)a>g2j`&-p8QAPoW*76>39$RRfZMlL?(&CD(-Qc_|RU2xyb z?!5Qrz2Ezo<-d|i6~XoOm;Wu^(-8WWKLl68pFH~-CJ&H_R*|WgAzLYjRzv0RYFOdV zVLMWeu13qT)tG`#Av0-4N!*N)7>SZZNg;`1=;c5o>d(wLi5FvL;`8Y0sh-rS7nD*# zN`-wALQBNdK98(wV&6FI7co!6^Jz133#CVlFJcI(H;uaO7$&Y#QZ=YmDXHomg4c~r zf(_FoCT32V;F@dM47(048yf^~IdlVWS?)Tn`qIQ;7NNSTUWZ8mlS;uc2_}Cq%2k^z zs49j_*D-&a&D&04V_^YT>+ZT!k!yUtNS!h^ET=?`vMx5%1NBz9>QL8LoAclHCFOP| zUL4{`O&1+!I^AcS!IZF??JnTy)$+TW(}BGv5%yXx&Kre||GV8%{ZHBLo5Nw?mlWU* z4T`3GPtyWW&Uwfq?yIVqO)twr}&Q=AN2_SDWKQ3?Rc!?6jCAh~> zp!KTj&^~ZK7dvi>h~JWsG$Cj7C9AqlDE4Fb>y=wQqmSdh4H>52gp}jv`Z86+%-~uD zhQ1|SwqP5KfziUqg#opE*(61r%UKo6&E-;z*u@OqAoT^zT$(=0%_TUK4m^qP@oMreDB4wWCix_;6EG2G@R)oz2g8&Ue z0^UP>FO(KP$Yr=71*?)jMK(5kXYa;g$=R=r3 z?me?nmrMCq6FmgE$35A*sEPJ^ya5*PpxA@h(ldN{#1{{uG6^p~hMWBc2t-9ilQRJNOLLu< z=30^QgZRkyANNP6o{r8w8J%s9raGgkRw8wvjorW2IyckSUh8PDJ=Nx(Xmf2X+tISE zNS2O)s={IPdIjvl%Fm#$G?f>@?`{YpbVB)>p}|G~g&1y3t;j+YfF1>0f37Tgz(={Q zbOMMMhfi+XC=efBFDXhTfYsBW&Vq*ljOhqh!ASvbb`{7r`tD-p(Vh0iw>uZ#hFl(- zdO9}yWNfxQmgYfBAy#N+|&%sQGy|7Ixl$Rd` z15jEKeTeZ4!6GZ^dA`QUXK=H3fo!9Lh<2at7+=lomj0gkN9NJl_J!Bm6R)>N=h~6E z?caW*{bKjdKR^BA)AlRb&MVorrgt>G710G~Y2`*b>BVz7(<$U~UQ9MlX#%&&i@EhG ze92M(1yPPFJD7j((MnbVL_j%%%@EKOK$$RuNEO9>=2HFiPiqZ`& zDv>VYi!yIYT_SG83lSx?d%lZc*t;TzVKNd{ S=6BC^5e$342*Zg)AowHCJ^+XS literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/utils/__pycache__/serialization.cpython-311.pyc b/env/Lib/site-packages/aiogram/utils/__pycache__/serialization.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7c35e9a8de9f7064d66db5cb594ce44d7e0c8080 GIT binary patch literal 3892 zcmd^B-EZ606~7cIk`nb{J9dn$Sj35voz_5qCF>vzIhhgVjQnKWv z>mRTy>hSR1bI<)czu&o^=JQzs<&VGp%f??p`zL<%N+wYb{{zYnF^Iugq{@{!4)v6k zs`6#NDwKt4x}0Wpyd_qpvcz=3lB=0=hUsZ5TUE*m(?u&+&6o2`m#jjyST2Ho!pP7x zRZjKBCPtQKHUvYtpDvG3E=8^qBX^$|`Mne&`|yv;9=!H@AEZ2*AsJ$f8%4@L=Wm3L zfzQzm*%$?%C%)2>2g@_}q%`qw9HqpC8AJE=iluvAi4XZjyAcY@X2lQXYc=0= zY~4beCEcTMI|juMe#!CSHNH$Y^t$E4*LByaQP(%A2la)U)S|atz4|uw?>GkbUa@O+ z|B7kR)lf3xUZLnxzwX);@a}U+AYW3TKj=xnD*_p zt-7oGj;pOZ{u;IKuKn0tU-L|#&ertGmVTRhYr5&+dN0;})ABBQ)HQX>{7}c;o2xa# zymp)V+6GJkeYj&V3eLd00HQ?#snGhxqp_DeV>8{cnFrD%rLg_(L#eIIca-_AGT#>F z55bUBQ1nV~;fI%?W`|Hx<_uC!y#oPV=BYr_M(Q%OP?1Vh-bftF{gI zv^QO9^v>dnRDvpFThBO-q4`R=#W ze#f6Nt5CpMhiPWFTFQj7rr|_1EzD|K)iLT8>N!pOd0n@X7D>|#r=n>t27Fl5G~Kox zp9PEuwP~#7VKi3(?K9$@fR{UpVxlK7iab2Y*1#_k;5^5)uCReRvllWQUmK z9^Xv4Q-ert62H%Agbbt7%{IwqzqQF594_NnZyX~j$9hjT$u4f&bHzv*{DClR4IF`6 zn3N`Wkluqi?<3GzxhKHv(@kNsKi;m?Ya4twNmFP7bPmKl7<<1z{ylMM-l9Kp)N6Pq z?nG1E?d6{%BhZ@s@SHf}DZ661!dsMB|J>LQPi2e3p7!UR(fw`dGx&vWKUG$OIFt{&X zUs2-#X1oAxtQsf)QdY8zI0GfzGO)^{ZHzY}HV?(vUntht7G8mbA^^Z?D8H|}NJXBD z$B$VQd43Y~P|=VuJ#Eu-Y)CmLp^i0_lrU?0rtSHsS;7MFz!B^;7b7vu;s_S= z!ZJrFdDQcO1;aeBGVBf27-<0yVbT`sHQ*!4c%me^Q#c+b8&^eV68*rZw&8_xKO3=G z%84t(!!eOHp)kS;Um7@m%}+AB7VnGuDp*g$-}@Vg7Ku)i;%Mt?Af1T_m%jM>g@=_t zyxBRo)IGPvDuUBf-P3aqq;0t)pZb?Hx_$1~jgEA-E1kvW%RyoEWBVg}cjohV9@w42 z8{NVi5BO&y8TtC|t#)y?Q=IJlewLeeARQxvVYo)w5ZwmtK^<)eYl2J*Mm2W96NV>P*E>VVsW_I^}9}5@$2NpEn(PCb3 zUxPkZ;qR3|w8*p5B=-%B(UHkOeLa$docM%*c*=xKBqhoSX@$jGiCZnDR&SOjLItlC z>{d=a7iSTQa36tVXLkm6MQ|}`g>tQ70Ee2Dm@lN{GRiKt;mPD{u40*RftyRHm0f+q zVy`jgH7{nNe6JR-KOVb*Fydj95(?{%W5pYW%XH76=wDC1kT1tKo;Tg^Lj#7t_ZyHA z&v9Hp&bEi2fV|xP^5-!*(;j{vlgak*6Oh;2!%sk7X%9aEIoBS3B9Z659T5OuoQ`oyL_jc?@E-7pO|e7Nz+WcH MpoZoz671~$3s)8VsQ>@~ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/utils/__pycache__/text_decorations.cpython-311.pyc b/env/Lib/site-packages/aiogram/utils/__pycache__/text_decorations.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a59933e886dede8247c97ed6f3ec1ad39684e211 GIT binary patch literal 15536 zcmeG@ZERcDb?=dn-;_v+67^--)Q25YjwL6t-Pn=k=*yBVi*h8&acMa;rAN!MDN?zl z9Gj(EwRKn7Fc2+EYZZ+LZ3t3%b^!rv2V*F<3}~^e`+D@)g?nAFphbrU7%+KCfkFd{ zopT>ay${N>8yEYtr>Ar8JNN6Hd(S=hoO>_7Q&M7O;Q6y}|J}J4Jq+`6{K!8BDZ;M( z1|qi@p5fUDGtCBA7UQ~zE})~KKA?wCAK|7A0mHO0V5I3>#58RVn5QiP%d|CMowfyR z)AoRUx+G9S(+!c*X-B}pGGQ|@LV07vIb9YggEUj1oUh>R*SLU-ujET0tk5xi3}1SU z;T>VadwPbs3;)s+sHAC5NGl6hs?yvvtsK%^nzSk%6L!A`mE6r&#RRGWSEa($@VXJk z>;43Dd0EjGibi9JP+}?;jr+VhQQz6sEtZDH;|UU)NKA(l=VQFrD3Ctl^@i~)ka>bFbSA^#7{Ncg z_AEqhF)3zAmbek++4rE--9pI`=8n#nw9F>X?S5|m?g(;k3`ZwoeE1GaDxq8)vwGHt zdk&7h8Y36Sx?}uQbaL$CEbZXncq}m%j$Rr&J~ciTpGt&x&x9r}LVw1`LQ}Cx5}IzC zO-x1NZODU+?|AFX72<-LDX50XS_ObPCTnxN`O=M-7QT?SHDzo~0@t(#c;@M_N@}4h zcACFVgD;`@EgF0&#n)@_4vOEZ!8-xJi}z^oWi)?-247C`jT*d*H-SEQmN=pR zQ800mk`nl!vPs++s{$~Q8y1K%(C@jaaGax4fxSS{2okzNl(|rdE3k!{6j-Q9dKB24 z(pJ@LESlF;6l>07&zmkWM3(~fm)eY8;+c)Fl!DXuU^MO)MkJ-Xr&3hP^hfj(PGb68q_vR) z(4VNt=tH)EVnnIYJSm+#-#wkOy=WzrLqXF#T1p>58!9^bv=9xGhKUC&oc5} zOX-1{x_oXWEmt|91vQlBN$Ge)io1Zij6UCHZtLzDm8Bm+9V$Hf;p3udu-E55I^+}WC;Eqcy+PmTU{~+3 zXzK4A>GyZ`iKgyc#Lzp~dGxr*bqyWw5sgRvoyU)Mi(L0mPp@bh_4V`)A3y5r6-!3^ z!$${t{r$s3qka9NY2?Jv(c@5`wd?p$_rNQoL;hZ|viH;pXuq@TcyDk6O;C|hJujLj z!(a-66{J5g+)H*K;r1C44(2;W)Wer(_xGOi2lM2YcZ)su1c2=*S@-cM?GWop|V*xCeJ z+p3YNsD1nJs$N&tvcP@lYoSmstPeeX+xvmx#5%Q*W4XWz$_HMdT^b!w?+;Z(ZP zo2m4!nz)kERV(cSTHT8eY%dD77qj*jLHYi|Rkg@1o_ptF+SQVAwaoWqT~)UZymeq{ zuh80epZ~!m1n@2#NW1zou71JZzd_@^2ey5JZC|0pclqzXaNqa?Yr3^N)7p(iG;HPR za8-TiYJT8qUf%noiXTmUus<^pN_UQDI>!Z9bJ{hLaZL#JiB&V>tavkdBe~d|c5KTy zwh88K)TZ=_W-1O-;rM!e-aR>u-pXl(^Ks@(ant6TASmD^vP%$ZA5du^L)s@%Fjzpn zsTSCjj+7?~MhdDwUU!YTr&p@WC_Bk0F&ZVwC2tlK-DngPU_9)Zmb@%U5dzN|4M|m@ zhlJjc6lh+_%JnA{JLu^oBy`0SJLi%25>{9!q1K|J(s{ss0mp+~Lz@Ntqz&T`d?D6% z2i$|$xpVO_dWRf%G}AHf11aL$>BheU-kwlpH>PbITA?cZ8SR

      aG7KZP- zeon`;H}olPrZgcFd9`p~|g`WVP2k5&;|W-7tId(DCxRt2Hp#vOg;~WDI;%K zlJUQh1|kz#;WzPM}t#v2{LrI zAVM83f)bqvo^kz!|9UMG1}740O8$bBSPU!Zw@n+*AZI zkfWG5ir^#wuSKQ0Hfk3QQ&B#AnVL|dA)W}4glLb?ju&)b97PAT+*$a~={j0x((}J{ z!Z;L+e+_v0^)H!UGNATK!IGHo$X2@Nk7UcLgtF$_FDxd$b>N)?^TuD)?^wE=uHTcX z-?Pe;T1qLnJ~-dIus`dlym@u;^|ZsYwEuy_D>%GaXLS*zyY|+Fw=Vpo;rW%l_l@tn ze^@WPGMw%l7G50AyfBh(@MjwQY4>QxJt{bJZx)QA!KKc0#rFB$Y-QcsXO><`SMFGL z->bi0mi8V@S00={@{77{A35DZ)uFvnOny)zddsxPeOTT4pt^NAu`>3-cHz`(LUn7pI+&>rrk!Uq z&aH-A`KAGV`NcmXI(8k9TGo9r5Ho8ZRx2t$S-dWX4_Tl5O$6pJ3MDd|!P0y;f& zP0{8eR~2^J%p~I-sUxxr!0+(H0afP*3i$BtjY; zxlo`Js1%Ar*rwXUl6#47D;l5p3`1p^1?5FR;KIpj6_bUO#i!O<2^dFH7vaQ%#AYYY zC%33tRHVN1)LJ#gXJS(k*ke!|mO1>=(`t#XD9H*HSJcyfSJ4Lb!GB9}X@Q!Q;&KEq z8gY@k{L6~QKa03n$H6nWNI6Q@sQBDSy7$!Ds|;VB2}SwPcqAO$s6W}PYPx8y6$KSu zBVD13?Ym1m@TjgK6YjD~2=q|M00P`Ir8uw7=kr>nJm@G8n&QeG_6bn_lw?Z@rgVE4*I2aVI!Qga^pM`!5 ziuPde_1REFN|7v`Q&=1=9fAfoU6x1;W3MBKBS1|^P&JXu2++DFDFoDxLLnqyM(|Yx z7ZBh&A{l+?r_%Ee4@BZ-P*`(?zg68HgJ+dd0-h}~fLm4s>|h$UXFbiUwk?KUc9q!# zwll_xRUK<6S!MFzp&oG8UX!rK|4;uv?VrM^NJ4`0F#-RDC%2@rYi|Kcc0$R*>7*{e z@%jKbcmZ(C0w&%VFvAT13%`Zl0I>4)^ag+p!csWRv_t5CumnOUgr)pez8pdae7hiY zLI`J?fiei;3=?h=)bns=2{#G0@o*LysDSSp2rD6kGsu9OuLEz#L-1%xWXDBzN@Qn6 zHlDO5CU@so8Z*S{HnlV*sPTusi!`xthAXr`&N*s6qBnv&VkzCX;l4zQ1*pGmfc7{z z-);|i&Xe%DLyhaY#*QS{-WKYR<{A26$|V7HOwy%1@NY%4@-Hwep2@%|wWD=$ui$8f zcWIv#A~d&Z?LV|bDSfRFq4ddioHi(x??WN>Hk^Cj;e6|C`#RgPu4`|D4I?vdvIk-N zU1K&h$42Ewh~*`PntNd`fVDTn^r^ltP5&L2Z|QhS`-D&XU40RdM;m z6+2n2qP$?>3rIGq3{(n77WQUb+XcrFc$YyKFkGp~Jl8En5t@(uPM9cD9IzE<1g(zb z78N53zu}+c%=nNQ*zxeeyWA^67H0$PrlecVhUBLFvz&o0 zWS~iKbiun6mcr#krVW$`qVP3$X&K<44w=H1?p0Gl5m4hDf@1{UWl-K2z7LZeLwwC6+7T%*_T)<_o#b~|v2^1^ zxwurJ`JJp$F|pw`{Ts57pXU82SfJ?p;avvWF{Iw49 zO`wW=1Hl~x8WH;{V3W-%rZy^&xrIN2oCW@1h$w$JAS=KWhWGuMLnovt!rUgBR#eRmW~=K2t}7N&8vcd zKT7c`xLJOvEMEf^ciQ0-(BXv#6$L!(8V>h{FEYx&-Cz9$jwS+7-%14!MF%$m_3fBe z&6~k@F!43K1wu1~RtPN++90$-h_{z*d~MEWsmb{)H94Q925w-Y&r(Bu7bjnr^I2+g zK1)r`XQ={>xP>^N$zzZS!Yitb!T?2v))HKD^=Rt z$kbu^1XwAUR80%}1P82!O^ZEJh|t`mRZ}=*@XxN{>?xScEH#;RK9OzN#4^P#k7O}Y z&<*(yNTet3xCGQK?3+*FpJ1+g()N?OV96!~P)DMsNMA_K#D4+_1zUaF!l(e3F{C$l zB}1{f_vl_&XU}dz1a9{f?FDof{tFVxpCZ8RoyTae;HYqC&z`leb5;m8X_z_&?jqcS zbMPx@t-yK{ItM5SG6DE4odZ3Pv(8${ePoGlTWw2q zSX(i~*S!02`z$Z1NqulrQK2^dmLfzI?E3$fcUi*%n2!y)*WB==l&rH~++@(GN$x2^ zhr%rX4R-I7h)uo=)^(}WCM{Ddy0%!$k|oW;iW$ePC7iJJ3%&DS#6Q7YuVudAM;?Ui zx0p=~X4!RX*rP$?8K&6AFH0nUoEsY(d(NvDO*8qQX^`*?*wEM=(Md?q!3{q>oDh@m zVxMRXo<6`PtBY_&?P?Br!ppH}SC`$qw8&?+9(dm*oB&;LGVM5-ahw#)Cn)HtA zs9MA|NwTh&Af|o5HGpf}^y;nZ?iAvHPu$gMNS4w|o7C>cTbpDj)C9f*T`V@Sv5Uxg z5URW3UFH^R7ya;GD}Bo$?N^{{6v~L!_)KIfK?%}I?3W=&vi^|-S#em~ARi8^>&+`S zu1HO-7(U$d@`F7ur}uPa_H+R*UEQ4l=;+Qkx&?FhBL)|B_3wUgc|GbkD)FCjh{=zk zB1x0|EyUylOa1{6$(M@sU{Ob>$mo_r|B`>i25?m-e~AFMb+m)^Rlp{9K5kR+%R45% z7m7T|xV_J(9mfRoF-l8u_o_neUi}c-5KR-Y=@~q#Ma?KWf2O0 zJ4E6G!0MdrFS~2s^7Ho&3j6)(U89*@qXJheZ~*a5bED{7HKQXW2jFCEL7W@_4vx2! zV3U0Es%XuSuNBM60pJ=DCkLCSkFKHU%&%KWVCYSjWN{YH_$Q@{p!{ zDo?+_wX*0?7l#Y4J)|k0%G1Z$oh%Acak#kkAx-&Io_>;LTn!7Y>GH-*dE=ZT>)t82 Scc$Gf8F!1oxTKd#;Qs*lwmG!` literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/utils/__pycache__/token.cpython-311.pyc b/env/Lib/site-packages/aiogram/utils/__pycache__/token.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3de6fdd495c3d85c3d3772940698dd0ad4058d56 GIT binary patch literal 2187 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 bool: + """ + Generate hexadecimal representation + of the HMAC-SHA-256 signature of the data-check-string + with the SHA256 hash of the bot's token used as a secret key + + :param token: + :param hash: + :param kwargs: all params received on auth + :return: + """ + secret = hashlib.sha256(token.encode("utf-8")) + check_string = "\n".join(f"{k}={kwargs[k]}" for k in sorted(kwargs)) + hmac_string = hmac.new( + secret.digest(), check_string.encode("utf-8"), digestmod=hashlib.sha256 + ).hexdigest() + return hmac_string == hash + + +def check_integrity(token: str, data: Dict[str, Any]) -> bool: + """ + Verify the authentication and the integrity + of the data received on user's auth + + :param token: Bot's token + :param data: all data that came on auth + :return: + """ + return check_signature(token, **data) diff --git a/env/Lib/site-packages/aiogram/utils/backoff.py b/env/Lib/site-packages/aiogram/utils/backoff.py new file mode 100644 index 0000000..ebe08e9 --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/backoff.py @@ -0,0 +1,83 @@ +import asyncio +import time +from dataclasses import dataclass +from random import normalvariate + + +@dataclass(frozen=True) +class BackoffConfig: + min_delay: float + max_delay: float + factor: float + jitter: float + + def __post_init__(self) -> None: + if self.max_delay <= self.min_delay: + raise ValueError("`max_delay` should be greater than `min_delay`") + if self.factor <= 1: + raise ValueError("`factor` should be greater than 1") + + +class Backoff: + def __init__(self, config: BackoffConfig) -> None: + self.config = config + self._next_delay = config.min_delay + self._current_delay = 0.0 + self._counter = 0 + + def __iter__(self) -> "Backoff": + return self + + @property + def min_delay(self) -> float: + return self.config.min_delay + + @property + def max_delay(self) -> float: + return self.config.max_delay + + @property + def factor(self) -> float: + return self.config.factor + + @property + def jitter(self) -> float: + return self.config.jitter + + @property + def next_delay(self) -> float: + return self._next_delay + + @property + def current_delay(self) -> float: + return self._current_delay + + @property + def counter(self) -> int: + return self._counter + + def sleep(self) -> None: + time.sleep(next(self)) + + async def asleep(self) -> None: + await asyncio.sleep(next(self)) + + def _calculate_next(self, value: float) -> float: + return normalvariate(min(value * self.factor, self.max_delay), self.jitter) + + def __next__(self) -> float: + self._current_delay = self._next_delay + self._next_delay = self._calculate_next(self._next_delay) + self._counter += 1 + return self._current_delay + + def reset(self) -> None: + self._current_delay = 0.0 + self._counter = 0 + self._next_delay = self.min_delay + + def __str__(self) -> str: + return ( + f"Backoff(tryings={self._counter}, current_delay={self._current_delay}, " + f"next_delay={self._next_delay})" + ) diff --git a/env/Lib/site-packages/aiogram/utils/callback_answer.py b/env/Lib/site-packages/aiogram/utils/callback_answer.py new file mode 100644 index 0000000..1515a7e --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/callback_answer.py @@ -0,0 +1,211 @@ +from typing import Any, Awaitable, Callable, Dict, Optional, Union + +from aiogram import BaseMiddleware, loggers +from aiogram.dispatcher.flags import get_flag +from aiogram.exceptions import CallbackAnswerException +from aiogram.methods import AnswerCallbackQuery +from aiogram.types import CallbackQuery, TelegramObject + + +class CallbackAnswer: + def __init__( + self, + answered: bool, + disabled: bool = False, + text: Optional[str] = None, + show_alert: Optional[bool] = None, + url: Optional[str] = None, + cache_time: Optional[int] = None, + ) -> None: + """ + Callback answer configuration + + :param answered: this request is already answered by middleware + :param disabled: answer will not be performed + :param text: answer with text + :param show_alert: show alert + :param url: game url + :param cache_time: cache answer for some time + """ + self._answered = answered + self._disabled = disabled + self._text = text + self._show_alert = show_alert + self._url = url + self._cache_time = cache_time + + def disable(self) -> None: + """ + Deactivate answering for this handler + """ + self.disabled = True + + @property + def disabled(self) -> bool: + """Indicates that automatic answer is disabled in this handler""" + return self._disabled + + @disabled.setter + def disabled(self, value: bool) -> None: + if self._answered: + raise CallbackAnswerException("Can't change disabled state after answer") + self._disabled = value + + @property + def answered(self) -> bool: + """ + Indicates that request is already answered by middleware + """ + return self._answered + + @property + def text(self) -> Optional[str]: + """ + Response text + :return: + """ + return self._text + + @text.setter + def text(self, value: Optional[str]) -> None: + if self._answered: + raise CallbackAnswerException("Can't change text after answer") + self._text = value + + @property + def show_alert(self) -> Optional[bool]: + """ + Whether to display an alert + """ + return self._show_alert + + @show_alert.setter + def show_alert(self, value: Optional[bool]) -> None: + if self._answered: + raise CallbackAnswerException("Can't change show_alert after answer") + self._show_alert = value + + @property + def url(self) -> Optional[str]: + """ + Game url + """ + return self._url + + @url.setter + def url(self, value: Optional[str]) -> None: + if self._answered: + raise CallbackAnswerException("Can't change url after answer") + self._url = value + + @property + def cache_time(self) -> Optional[int]: + """ + Response cache time + """ + return self._cache_time + + @cache_time.setter + def cache_time(self, value: Optional[int]) -> None: + if self._answered: + raise CallbackAnswerException("Can't change cache_time after answer") + self._cache_time = value + + def __str__(self) -> str: + args = ", ".join( + f"{k}={v!r}" + for k, v in { + "answered": self.answered, + "disabled": self.disabled, + "text": self.text, + "show_alert": self.show_alert, + "url": self.url, + "cache_time": self.cache_time, + }.items() + if v is not None + ) + return f"{type(self).__name__}({args})" + + +class CallbackAnswerMiddleware(BaseMiddleware): + def __init__( + self, + pre: bool = False, + text: Optional[str] = None, + show_alert: Optional[bool] = None, + url: Optional[str] = None, + cache_time: Optional[int] = None, + ) -> None: + """ + Inner middleware for callback query handlers, can be useful in bots with a lot of callback + handlers to automatically take answer to all requests + + :param pre: send answer before execute handler + :param text: answer with text + :param show_alert: show alert + :param url: game url + :param cache_time: cache answer for some time + """ + self.pre = pre + self.text = text + self.show_alert = show_alert + self.url = url + self.cache_time = cache_time + + async def __call__( + self, + handler: Callable[[TelegramObject, Dict[str, Any]], Awaitable[Any]], + event: TelegramObject, + data: Dict[str, Any], + ) -> Any: + if not isinstance(event, CallbackQuery): + return await handler(event, data) + + callback_answer = data["callback_answer"] = self.construct_callback_answer( + properties=get_flag(data, "callback_answer") + ) + + if not callback_answer.disabled and callback_answer.answered: + await self.answer(event, callback_answer) + try: + return await handler(event, data) + finally: + if not callback_answer.disabled and not callback_answer.answered: + await self.answer(event, callback_answer) + + def construct_callback_answer( + self, properties: Optional[Union[Dict[str, Any], bool]] + ) -> CallbackAnswer: + pre, disabled, text, show_alert, url, cache_time = ( + self.pre, + False, + self.text, + self.show_alert, + self.url, + self.cache_time, + ) + if isinstance(properties, dict): + pre = properties.get("pre", pre) + disabled = properties.get("disabled", disabled) + text = properties.get("text", text) + show_alert = properties.get("show_alert", show_alert) + url = properties.get("url", url) + cache_time = properties.get("cache_time", cache_time) + + return CallbackAnswer( + answered=pre, + disabled=disabled, + text=text, + show_alert=show_alert, + url=url, + cache_time=cache_time, + ) + + def answer(self, event: CallbackQuery, callback_answer: CallbackAnswer) -> AnswerCallbackQuery: + loggers.middlewares.info("Answer to callback query id=%s", event.id) + return event.answer( + text=callback_answer.text, + show_alert=callback_answer.show_alert, + url=callback_answer.url, + cache_time=callback_answer.cache_time, + ) diff --git a/env/Lib/site-packages/aiogram/utils/chat_action.py b/env/Lib/site-packages/aiogram/utils/chat_action.py new file mode 100644 index 0000000..a2f3b46 --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/chat_action.py @@ -0,0 +1,379 @@ +import asyncio +import logging +import time +from asyncio import Event, Lock +from contextlib import suppress +from types import TracebackType +from typing import Any, Awaitable, Callable, Dict, Optional, Type, Union + +from aiogram import BaseMiddleware, Bot +from aiogram.dispatcher.flags import get_flag +from aiogram.types import Message, TelegramObject + +logger = logging.getLogger(__name__) +DEFAULT_INTERVAL = 5.0 +DEFAULT_INITIAL_SLEEP = 0.0 + + +class ChatActionSender: + """ + This utility helps to automatically send chat action until long actions is done + to take acknowledge bot users the bot is doing something and not crashed. + + Provides simply to use context manager. + + Technically sender start background task with infinity loop which works + until action will be finished and sends the + `chat action `_ + every 5 seconds. + """ + + def __init__( + self, + *, + bot: Bot, + chat_id: Union[str, int], + message_thread_id: Optional[int] = None, + action: str = "typing", + interval: float = DEFAULT_INTERVAL, + initial_sleep: float = DEFAULT_INITIAL_SLEEP, + ) -> None: + """ + :param bot: instance of the bot + :param chat_id: target chat id + :param message_thread_id: unique identifier for the target message thread; supergroups only + :param action: chat action type + :param interval: interval between iterations + :param initial_sleep: sleep before first sending of the action + """ + self.chat_id = chat_id + self.message_thread_id = message_thread_id + self.action = action + self.interval = interval + self.initial_sleep = initial_sleep + self.bot = bot + + self._lock = Lock() + self._close_event = Event() + self._closed_event = Event() + self._task: Optional[asyncio.Task[Any]] = None + + @property + def running(self) -> bool: + return bool(self._task) + + async def _wait(self, interval: float) -> None: + with suppress(asyncio.TimeoutError): + await asyncio.wait_for(self._close_event.wait(), interval) + + async def _worker(self) -> None: + logger.debug( + "Started chat action %r sender in chat_id=%s via bot id=%d", + self.action, + self.chat_id, + self.bot.id, + ) + try: + counter = 0 + await self._wait(self.initial_sleep) + while not self._close_event.is_set(): + start = time.monotonic() + logger.debug( + "Sent chat action %r to chat_id=%s via bot %d (already sent actions %d)", + self.action, + self.chat_id, + self.bot.id, + counter, + ) + await self.bot.send_chat_action( + chat_id=self.chat_id, + action=self.action, + message_thread_id=self.message_thread_id, + ) + counter += 1 + + interval = self.interval - (time.monotonic() - start) + await self._wait(interval) + finally: + logger.debug( + "Finished chat action %r sender in chat_id=%s via bot id=%d", + self.action, + self.chat_id, + self.bot.id, + ) + self._closed_event.set() + + async def _run(self) -> None: + async with self._lock: + self._close_event.clear() + self._closed_event.clear() + if self.running: + raise RuntimeError("Already running") + self._task = asyncio.create_task(self._worker()) + + async def _stop(self) -> None: + async with self._lock: + if not self.running: + return + if not self._close_event.is_set(): # pragma: no branches + self._close_event.set() + await self._closed_event.wait() + self._task = None + + async def __aenter__(self) -> "ChatActionSender": + await self._run() + return self + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc_value: Optional[BaseException], + traceback: Optional[TracebackType], + ) -> Any: + await self._stop() + + @classmethod + def typing( + cls, + chat_id: Union[int, str], + bot: Bot, + message_thread_id: Optional[int] = None, + interval: float = DEFAULT_INTERVAL, + initial_sleep: float = DEFAULT_INITIAL_SLEEP, + ) -> "ChatActionSender": + """Create instance of the sender with `typing` action""" + return cls( + bot=bot, + chat_id=chat_id, + message_thread_id=message_thread_id, + action="typing", + interval=interval, + initial_sleep=initial_sleep, + ) + + @classmethod + def upload_photo( + cls, + chat_id: Union[int, str], + bot: Bot, + message_thread_id: Optional[int] = None, + interval: float = DEFAULT_INTERVAL, + initial_sleep: float = DEFAULT_INITIAL_SLEEP, + ) -> "ChatActionSender": + """Create instance of the sender with `upload_photo` action""" + return cls( + bot=bot, + chat_id=chat_id, + message_thread_id=message_thread_id, + action="upload_photo", + interval=interval, + initial_sleep=initial_sleep, + ) + + @classmethod + def record_video( + cls, + chat_id: Union[int, str], + bot: Bot, + message_thread_id: Optional[int] = None, + interval: float = DEFAULT_INTERVAL, + initial_sleep: float = DEFAULT_INITIAL_SLEEP, + ) -> "ChatActionSender": + """Create instance of the sender with `record_video` action""" + return cls( + bot=bot, + chat_id=chat_id, + message_thread_id=message_thread_id, + action="record_video", + interval=interval, + initial_sleep=initial_sleep, + ) + + @classmethod + def upload_video( + cls, + chat_id: Union[int, str], + bot: Bot, + message_thread_id: Optional[int] = None, + interval: float = DEFAULT_INTERVAL, + initial_sleep: float = DEFAULT_INITIAL_SLEEP, + ) -> "ChatActionSender": + """Create instance of the sender with `upload_video` action""" + return cls( + bot=bot, + chat_id=chat_id, + message_thread_id=message_thread_id, + action="upload_video", + interval=interval, + initial_sleep=initial_sleep, + ) + + @classmethod + def record_voice( + cls, + chat_id: Union[int, str], + bot: Bot, + message_thread_id: Optional[int] = None, + interval: float = DEFAULT_INTERVAL, + initial_sleep: float = DEFAULT_INITIAL_SLEEP, + ) -> "ChatActionSender": + """Create instance of the sender with `record_voice` action""" + return cls( + bot=bot, + chat_id=chat_id, + message_thread_id=message_thread_id, + action="record_voice", + interval=interval, + initial_sleep=initial_sleep, + ) + + @classmethod + def upload_voice( + cls, + chat_id: Union[int, str], + bot: Bot, + message_thread_id: Optional[int] = None, + interval: float = DEFAULT_INTERVAL, + initial_sleep: float = DEFAULT_INITIAL_SLEEP, + ) -> "ChatActionSender": + """Create instance of the sender with `upload_voice` action""" + return cls( + bot=bot, + chat_id=chat_id, + message_thread_id=message_thread_id, + action="upload_voice", + interval=interval, + initial_sleep=initial_sleep, + ) + + @classmethod + def upload_document( + cls, + chat_id: Union[int, str], + bot: Bot, + message_thread_id: Optional[int] = None, + interval: float = DEFAULT_INTERVAL, + initial_sleep: float = DEFAULT_INITIAL_SLEEP, + ) -> "ChatActionSender": + """Create instance of the sender with `upload_document` action""" + return cls( + bot=bot, + chat_id=chat_id, + message_thread_id=message_thread_id, + action="upload_document", + interval=interval, + initial_sleep=initial_sleep, + ) + + @classmethod + def choose_sticker( + cls, + chat_id: Union[int, str], + bot: Bot, + message_thread_id: Optional[int] = None, + interval: float = DEFAULT_INTERVAL, + initial_sleep: float = DEFAULT_INITIAL_SLEEP, + ) -> "ChatActionSender": + """Create instance of the sender with `choose_sticker` action""" + return cls( + bot=bot, + chat_id=chat_id, + message_thread_id=message_thread_id, + action="choose_sticker", + interval=interval, + initial_sleep=initial_sleep, + ) + + @classmethod + def find_location( + cls, + chat_id: Union[int, str], + bot: Bot, + message_thread_id: Optional[int] = None, + interval: float = DEFAULT_INTERVAL, + initial_sleep: float = DEFAULT_INITIAL_SLEEP, + ) -> "ChatActionSender": + """Create instance of the sender with `find_location` action""" + return cls( + bot=bot, + chat_id=chat_id, + message_thread_id=message_thread_id, + action="find_location", + interval=interval, + initial_sleep=initial_sleep, + ) + + @classmethod + def record_video_note( + cls, + chat_id: Union[int, str], + bot: Bot, + message_thread_id: Optional[int] = None, + interval: float = DEFAULT_INTERVAL, + initial_sleep: float = DEFAULT_INITIAL_SLEEP, + ) -> "ChatActionSender": + """Create instance of the sender with `record_video_note` action""" + return cls( + bot=bot, + chat_id=chat_id, + message_thread_id=message_thread_id, + action="record_video_note", + interval=interval, + initial_sleep=initial_sleep, + ) + + @classmethod + def upload_video_note( + cls, + chat_id: Union[int, str], + bot: Bot, + message_thread_id: Optional[int] = None, + interval: float = DEFAULT_INTERVAL, + initial_sleep: float = DEFAULT_INITIAL_SLEEP, + ) -> "ChatActionSender": + """Create instance of the sender with `upload_video_note` action""" + return cls( + bot=bot, + chat_id=chat_id, + message_thread_id=message_thread_id, + action="upload_video_note", + interval=interval, + initial_sleep=initial_sleep, + ) + + +class ChatActionMiddleware(BaseMiddleware): + """ + Helps to automatically use chat action sender for all message handlers + """ + + async def __call__( + self, + handler: Callable[[TelegramObject, Dict[str, Any]], Awaitable[Any]], + event: TelegramObject, + data: Dict[str, Any], + ) -> Any: + if not isinstance(event, Message): + return await handler(event, data) + bot = data["bot"] + + chat_action = get_flag(data, "chat_action") or "typing" + kwargs = {} + if isinstance(chat_action, dict): + if initial_sleep := chat_action.get("initial_sleep"): + kwargs["initial_sleep"] = initial_sleep + if interval := chat_action.get("interval"): + kwargs["interval"] = interval + if action := chat_action.get("action"): + kwargs["action"] = action + elif isinstance(chat_action, bool): + kwargs["action"] = "typing" + else: + kwargs["action"] = chat_action + kwargs["message_thread_id"] = ( + event.message_thread_id + if isinstance(event, Message) and event.is_topic_message + else None + ) + async with ChatActionSender(bot=bot, chat_id=event.chat.id, **kwargs): + return await handler(event, data) diff --git a/env/Lib/site-packages/aiogram/utils/chat_member.py b/env/Lib/site-packages/aiogram/utils/chat_member.py new file mode 100644 index 0000000..7ac666c --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/chat_member.py @@ -0,0 +1,37 @@ +from typing import Tuple, Type, Union + +from pydantic import Field, TypeAdapter +from typing_extensions import Annotated + +from aiogram.types import ( + ChatMember, + ChatMemberAdministrator, + ChatMemberBanned, + ChatMemberLeft, + ChatMemberMember, + ChatMemberOwner, + ChatMemberRestricted, +) + +ChatMemberUnion = Union[ + ChatMemberOwner, + ChatMemberAdministrator, + ChatMemberMember, + ChatMemberRestricted, + ChatMemberLeft, + ChatMemberBanned, +] + +ChatMemberCollection = Tuple[Type[ChatMember], ...] + +ChatMemberAdapter: TypeAdapter[ChatMemberUnion] = TypeAdapter( + Annotated[ + ChatMemberUnion, + Field(discriminator="status"), + ] +) + +ADMINS: ChatMemberCollection = (ChatMemberOwner, ChatMemberAdministrator) +USERS: ChatMemberCollection = (ChatMemberMember, ChatMemberRestricted) +MEMBERS: ChatMemberCollection = ADMINS + USERS +NOT_MEMBERS: ChatMemberCollection = (ChatMemberLeft, ChatMemberBanned) diff --git a/env/Lib/site-packages/aiogram/utils/deep_linking.py b/env/Lib/site-packages/aiogram/utils/deep_linking.py new file mode 100644 index 0000000..19cc64c --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/deep_linking.py @@ -0,0 +1,112 @@ +from __future__ import annotations + +__all__ = [ + "create_start_link", + "create_startgroup_link", + "create_deep_link", + "create_telegram_link", + "encode_payload", + "decode_payload", +] + +import re +from typing import TYPE_CHECKING, Callable, Literal, Optional, cast + +from aiogram.utils.link import create_telegram_link +from aiogram.utils.payload import decode_payload, encode_payload + +if TYPE_CHECKING: + from aiogram import Bot + +BAD_PATTERN = re.compile(r"[^A-z0-9-]") + + +async def create_start_link( + bot: Bot, + payload: str, + encode: bool = False, + encoder: Optional[Callable[[bytes], bytes]] = None, +) -> str: + """ + Create 'start' deep link with your payload. + + If you need to encode payload or pass special characters - + set encode as True + + :param bot: bot instance + :param payload: args passed with /start + :param encode: encode payload with base64url or custom encoder + :param encoder: custom encoder callable + :return: link + """ + username = (await bot.me()).username + return create_deep_link( + username=cast(str, username), + link_type="start", + payload=payload, + encode=encode, + encoder=encoder, + ) + + +async def create_startgroup_link( + bot: Bot, + payload: str, + encode: bool = False, + encoder: Optional[Callable[[bytes], bytes]] = None, +) -> str: + """ + Create 'startgroup' deep link with your payload. + + If you need to encode payload or pass special characters - + set encode as True + + :param bot: bot instance + :param payload: args passed with /start + :param encode: encode payload with base64url or custom encoder + :param encoder: custom encoder callable + :return: link + """ + username = (await bot.me()).username + return create_deep_link( + username=cast(str, username), + link_type="startgroup", + payload=payload, + encode=encode, + encoder=encoder, + ) + + +def create_deep_link( + username: str, + link_type: Literal["start", "startgroup"], + payload: str, + encode: bool = False, + encoder: Optional[Callable[[bytes], bytes]] = None, +) -> str: + """ + Create deep link. + + :param username: + :param link_type: `start` or `startgroup` + :param payload: any string-convertible data + :param encode: encode payload with base64url or custom encoder + :param encoder: custom encoder callable + :return: deeplink + """ + if not isinstance(payload, str): + payload = str(payload) + + if encode or encoder: + payload = encode_payload(payload, encoder=encoder) + + if re.search(BAD_PATTERN, payload): + raise ValueError( + "Wrong payload! Only A-Z, a-z, 0-9, _ and - are allowed. " + "Pass `encode=True` or encode payload manually." + ) + + if len(payload) > 64: + raise ValueError("Payload must be up to 64 characters long.") + + return create_telegram_link(username, **{cast(str, link_type): payload}) diff --git a/env/Lib/site-packages/aiogram/utils/formatting.py b/env/Lib/site-packages/aiogram/utils/formatting.py new file mode 100644 index 0000000..929afc0 --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/formatting.py @@ -0,0 +1,632 @@ +import textwrap +from typing import ( + Any, + ClassVar, + Dict, + Generator, + Iterable, + Iterator, + List, + Optional, + Tuple, + Type, +) + +from typing_extensions import Self + +from aiogram.enums import MessageEntityType +from aiogram.types import MessageEntity, User +from aiogram.utils.text_decorations import ( + add_surrogates, + html_decoration, + markdown_decoration, + remove_surrogates, +) + +NodeType = Any + + +def sizeof(value: str) -> int: + return len(value.encode("utf-16-le")) // 2 + + +class Text(Iterable[NodeType]): + """ + Simple text element + """ + + type: ClassVar[Optional[str]] = None + + __slots__ = ("_body", "_params") + + def __init__( + self, + *body: NodeType, + **params: Any, + ) -> None: + self._body: Tuple[NodeType, ...] = body + self._params: Dict[str, Any] = params + + @classmethod + def from_entities(cls, text: str, entities: List[MessageEntity]) -> "Text": + return cls( + *_unparse_entities( + text=add_surrogates(text), + entities=sorted(entities, key=lambda item: item.offset) if entities else [], + ) + ) + + def render( + self, + *, + _offset: int = 0, + _sort: bool = True, + _collect_entities: bool = True, + ) -> Tuple[str, List[MessageEntity]]: + """ + Render elements tree as text with entities list + + :return: + """ + + text = "" + entities = [] + offset = _offset + + for node in self._body: + if not isinstance(node, Text): + node = str(node) + text += node + offset += sizeof(node) + else: + node_text, node_entities = node.render( + _offset=offset, + _sort=False, + _collect_entities=_collect_entities, + ) + text += node_text + offset += sizeof(node_text) + if _collect_entities: + entities.extend(node_entities) + + if _collect_entities and self.type: + entities.append(self._render_entity(offset=_offset, length=offset - _offset)) + + if _collect_entities and _sort: + entities.sort(key=lambda entity: entity.offset) + + return text, entities + + def _render_entity(self, *, offset: int, length: int) -> MessageEntity: + assert self.type is not None, "Node without type can't be rendered as entity" + return MessageEntity(type=self.type, offset=offset, length=length, **self._params) + + def as_kwargs( + self, + *, + text_key: str = "text", + entities_key: str = "entities", + replace_parse_mode: bool = True, + parse_mode_key: str = "parse_mode", + ) -> Dict[str, Any]: + """ + Render elements tree as keyword arguments for usage in the API call, for example: + + .. code-block:: python + + entities = Text(...) + await message.answer(**entities.as_kwargs()) + + :param text_key: + :param entities_key: + :param replace_parse_mode: + :param parse_mode_key: + :return: + """ + text_value, entities_value = self.render() + result: Dict[str, Any] = { + text_key: text_value, + entities_key: entities_value, + } + if replace_parse_mode: + result[parse_mode_key] = None + return result + + def as_html(self) -> str: + """ + Render elements tree as HTML markup + """ + text, entities = self.render() + return html_decoration.unparse(text, entities) + + def as_markdown(self) -> str: + """ + Render elements tree as MarkdownV2 markup + """ + text, entities = self.render() + return markdown_decoration.unparse(text, entities) + + def replace(self: Self, *args: Any, **kwargs: Any) -> Self: + return type(self)(*args, **{**self._params, **kwargs}) + + def as_pretty_string(self, indent: bool = False) -> str: + sep = ",\n" if indent else ", " + body = sep.join( + item.as_pretty_string(indent=indent) if isinstance(item, Text) else repr(item) + for item in self._body + ) + params = sep.join(f"{k}={v!r}" for k, v in self._params.items() if v is not None) + + args = [] + if body: + args.append(body) + if params: + args.append(params) + + args_str = sep.join(args) + if indent: + args_str = textwrap.indent("\n" + args_str + "\n", " ") + return f"{type(self).__name__}({args_str})" + + def __add__(self, other: NodeType) -> "Text": + if isinstance(other, Text) and other.type == self.type and self._params == other._params: + return type(self)(*self, *other, **self._params) + if type(self) is Text and isinstance(other, str): + return type(self)(*self, other, **self._params) + return Text(self, other) + + def __iter__(self) -> Iterator[NodeType]: + yield from self._body + + def __len__(self) -> int: + text, _ = self.render(_collect_entities=False) + return sizeof(text) + + def __getitem__(self, item: slice) -> "Text": + if not isinstance(item, slice): + raise TypeError("Can only be sliced") + if (item.start is None or item.start == 0) and item.stop is None: + return self.replace(*self._body) + start = 0 if item.start is None else item.start + stop = len(self) if item.stop is None else item.stop + if start == stop: + return self.replace() + + nodes = [] + position = 0 + + for node in self._body: + node_size = len(node) + current_position = position + position += node_size + if position < start: + continue + if current_position > stop: + break + a = max((0, start - current_position)) + b = min((node_size, stop - current_position)) + new_node = node[a:b] + if not new_node: + continue + nodes.append(new_node) + + return self.replace(*nodes) + + +class HashTag(Text): + """ + Hashtag element. + + .. warning:: + + The value should always start with '#' symbol + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.HASHTAG` + """ + + type = MessageEntityType.HASHTAG + + def __init__(self, *body: NodeType, **params: Any) -> None: + if len(body) != 1: + raise ValueError("Hashtag can contain only one element") + if not isinstance(body[0], str): + raise ValueError("Hashtag can contain only string") + if not body[0].startswith("#"): + body = ("#" + body[0],) + super().__init__(*body, **params) + + +class CashTag(Text): + """ + Cashtag element. + + .. warning:: + + The value should always start with '$' symbol + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.CASHTAG` + """ + + type = MessageEntityType.CASHTAG + + def __init__(self, *body: NodeType, **params: Any) -> None: + if len(body) != 1: + raise ValueError("Cashtag can contain only one element") + if not isinstance(body[0], str): + raise ValueError("Cashtag can contain only string") + if not body[0].startswith("$"): + body = ("$" + body[0],) + super().__init__(*body, **params) + + +class BotCommand(Text): + """ + Bot command element. + + .. warning:: + + The value should always start with '/' symbol + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.BOT_COMMAND` + """ + + type = MessageEntityType.BOT_COMMAND + + +class Url(Text): + """ + Url element. + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.URL` + """ + + type = MessageEntityType.URL + + +class Email(Text): + """ + Email element. + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.EMAIL` + """ + + type = MessageEntityType.EMAIL + + +class PhoneNumber(Text): + """ + Phone number element. + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.PHONE_NUMBER` + """ + + type = MessageEntityType.PHONE_NUMBER + + +class Bold(Text): + """ + Bold element. + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.BOLD` + """ + + type = MessageEntityType.BOLD + + +class Italic(Text): + """ + Italic element. + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.ITALIC` + """ + + type = MessageEntityType.ITALIC + + +class Underline(Text): + """ + Underline element. + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.UNDERLINE` + """ + + type = MessageEntityType.UNDERLINE + + +class Strikethrough(Text): + """ + Strikethrough element. + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.STRIKETHROUGH` + """ + + type = MessageEntityType.STRIKETHROUGH + + +class Spoiler(Text): + """ + Spoiler element. + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.SPOILER` + """ + + type = MessageEntityType.SPOILER + + +class Code(Text): + """ + Code element. + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.CODE` + """ + + type = MessageEntityType.CODE + + +class Pre(Text): + """ + Pre element. + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.PRE` + """ + + type = MessageEntityType.PRE + + def __init__(self, *body: NodeType, language: Optional[str] = None, **params: Any) -> None: + super().__init__(*body, language=language, **params) + + +class TextLink(Text): + """ + Text link element. + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.TEXT_LINK` + """ + + type = MessageEntityType.TEXT_LINK + + def __init__(self, *body: NodeType, url: str, **params: Any) -> None: + super().__init__(*body, url=url, **params) + + +class TextMention(Text): + """ + Text mention element. + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.TEXT_MENTION` + """ + + type = MessageEntityType.TEXT_MENTION + + def __init__(self, *body: NodeType, user: User, **params: Any) -> None: + super().__init__(*body, user=user, **params) + + +class CustomEmoji(Text): + """ + Custom emoji element. + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.CUSTOM_EMOJI` + """ + + type = MessageEntityType.CUSTOM_EMOJI + + def __init__(self, *body: NodeType, custom_emoji_id: str, **params: Any) -> None: + super().__init__(*body, custom_emoji_id=custom_emoji_id, **params) + + +class BlockQuote(Text): + """ + Block quote element. + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.BLOCKQUOTE` + """ + + type = MessageEntityType.BLOCKQUOTE + + +class ExpandableBlockQuote(Text): + """ + Expandable block quote element. + + Will be wrapped into :obj:`aiogram.types.message_entity.MessageEntity` + with type :obj:`aiogram.enums.message_entity_type.MessageEntityType.EXPANDABLE_BLOCKQUOTE` + """ + + type = MessageEntityType.EXPANDABLE_BLOCKQUOTE + + +NODE_TYPES: Dict[Optional[str], Type[Text]] = { + Text.type: Text, + HashTag.type: HashTag, + CashTag.type: CashTag, + BotCommand.type: BotCommand, + Url.type: Url, + Email.type: Email, + PhoneNumber.type: PhoneNumber, + Bold.type: Bold, + Italic.type: Italic, + Underline.type: Underline, + Strikethrough.type: Strikethrough, + Spoiler.type: Spoiler, + Code.type: Code, + Pre.type: Pre, + TextLink.type: TextLink, + TextMention.type: TextMention, + CustomEmoji.type: CustomEmoji, + BlockQuote.type: BlockQuote, + ExpandableBlockQuote.type: ExpandableBlockQuote, +} + + +def _apply_entity(entity: MessageEntity, *nodes: NodeType) -> NodeType: + """ + Apply single entity to text + + :param entity: + :param text: + :return: + """ + node_type = NODE_TYPES.get(entity.type, Text) + return node_type( + *nodes, **entity.model_dump(exclude={"type", "offset", "length"}, warnings=False) + ) + + +def _unparse_entities( + text: bytes, + entities: List[MessageEntity], + offset: Optional[int] = None, + length: Optional[int] = None, +) -> Generator[NodeType, None, None]: + if offset is None: + offset = 0 + length = length or len(text) + + for index, entity in enumerate(entities): + if entity.offset * 2 < offset: + continue + if entity.offset * 2 > offset: + yield remove_surrogates(text[offset : entity.offset * 2]) + start = entity.offset * 2 + offset = entity.offset * 2 + entity.length * 2 + + sub_entities = list(filter(lambda e: e.offset * 2 < (offset or 0), entities[index + 1 :])) + yield _apply_entity( + entity, + *_unparse_entities(text, sub_entities, offset=start, length=offset), + ) + + if offset < length: + yield remove_surrogates(text[offset:length]) + + +def as_line(*items: NodeType, end: str = "\n", sep: str = "") -> Text: + """ + Wrap multiple nodes into line with :code:`\\\\n` at the end of line. + + :param items: Text or Any + :param end: ending of the line, by default is :code:`\\\\n` + :param sep: separator between items, by default is empty string + :return: Text + """ + if sep: + nodes = [] + for item in items[:-1]: + nodes.extend([item, sep]) + nodes.append(items[-1]) + nodes.append(end) + else: + nodes = [*items, end] + return Text(*nodes) + + +def as_list(*items: NodeType, sep: str = "\n") -> Text: + """ + Wrap each element to separated lines + + :param items: + :param sep: + :return: + """ + nodes = [] + for item in items[:-1]: + nodes.extend([item, sep]) + nodes.append(items[-1]) + return Text(*nodes) + + +def as_marked_list(*items: NodeType, marker: str = "- ") -> Text: + """ + Wrap elements as marked list + + :param items: + :param marker: line marker, by default is '- ' + :return: Text + """ + return as_list(*(Text(marker, item) for item in items)) + + +def as_numbered_list(*items: NodeType, start: int = 1, fmt: str = "{}. ") -> Text: + """ + Wrap elements as numbered list + + :param items: + :param start: initial number, by default 1 + :param fmt: number format, by default '{}. ' + :return: Text + """ + return as_list(*(Text(fmt.format(index), item) for index, item in enumerate(items, start))) + + +def as_section(title: NodeType, *body: NodeType) -> Text: + """ + Wrap elements as simple section, section has title and body + + :param title: + :param body: + :return: Text + """ + return Text(title, "\n", *body) + + +def as_marked_section( + title: NodeType, + *body: NodeType, + marker: str = "- ", +) -> Text: + """ + Wrap elements as section with marked list + + :param title: + :param body: + :param marker: + :return: + """ + return as_section(title, as_marked_list(*body, marker=marker)) + + +def as_numbered_section( + title: NodeType, + *body: NodeType, + start: int = 1, + fmt: str = "{}. ", +) -> Text: + """ + Wrap elements as section with numbered list + + :param title: + :param body: + :param start: + :param fmt: + :return: + """ + return as_section(title, as_numbered_list(*body, start=start, fmt=fmt)) + + +def as_key_value(key: NodeType, value: NodeType) -> Text: + """ + Wrap elements pair as key-value line. (:code:`{key}: {value}`) + + :param key: + :param value: + :return: Text + """ + return Text(Bold(key, ":"), " ", value) diff --git a/env/Lib/site-packages/aiogram/utils/i18n/__init__.py b/env/Lib/site-packages/aiogram/utils/i18n/__init__.py new file mode 100644 index 0000000..e48a4c7 --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/i18n/__init__.py @@ -0,0 +1,21 @@ +from .context import get_i18n, gettext, lazy_gettext, lazy_ngettext, ngettext +from .core import I18n +from .middleware import ( + ConstI18nMiddleware, + FSMI18nMiddleware, + I18nMiddleware, + SimpleI18nMiddleware, +) + +__all__ = ( + "I18n", + "I18nMiddleware", + "SimpleI18nMiddleware", + "ConstI18nMiddleware", + "FSMI18nMiddleware", + "gettext", + "lazy_gettext", + "ngettext", + "lazy_ngettext", + "get_i18n", +) diff --git a/env/Lib/site-packages/aiogram/utils/i18n/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/utils/i18n/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2c2b941027786f5c1f18db4c4f7e95db40bd3671 GIT binary patch literal 665 zcmbV}Jxc>I7{`-)>0R&If-m?TZqVW;A})%cSRFbD;UJv7SVEIa$)#$Y9Q_6kegN?c zh#$hiQL;L@72G*&YnGNSld>j~Y3v!S{ z1~^2JJILWKa=C{*?js-CJ%`nJfPzZ9EaY`m=Mjo{jAGtE4HNfJGxxh7slA(8-)&xQsh$U2FtF-c;=dwD`qyFsRU|o-<(T4y|g2WQd!fXdCtg1CW&6y>vn#H zTEF~qm+~PaKch(`L(`g!EgBYe3;RUUv+ykfi<*UNaFn!k&=ZAizY5G{R!KHpdp#jZ zRa{5>yV1Gw-&g7Y38u%po9T&=gLFsawCJaUk<65k_*AHr6zAz7Jxxoh z$m%fb4YEEd(~OF~%y@gGC@b64yiFTpT2O`Y+HgD#x46hhjBLwgQ{VnYd1EkfA%w4> e^YXX#3RYfzu8HGAX9E6*RvbImft_;EH1i1sLb9Cz literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/utils/i18n/__pycache__/context.cpython-311.pyc b/env/Lib/site-packages/aiogram/utils/i18n/__pycache__/context.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a5d7d57b98c12def1c78f8d7600c96441d08d352 GIT binary patch literal 1287 zcmZuw&1(}u6rb7MB%5xM7Aq}&R01lPiYd|@N)f?+2x19R3qlBlZFU;hB)egDQkxPX zh!;Vn7iqyu5veWpEZ+PFJZzzduuu>@c`NkRlke@OZ6ck_{N9`2eC%)Dd-)oV_Yr8{ zKmA&|DG~AqCnqi3agLV2StkZDXoXa1j#Bicid26c$+u8!B*W7Z(C93S5+_xjq)nX-3~ulG6U-M^n_3A6N}A%A>mz7TD;VzS?-g z?UjZX=1kPNRqUwqjSPt6XdYml2)8=fuT(8aI zNqmwCXC2g#JkHKc=AYTToS(K0(<AW7Zz=iXV!9l&RonpreJq!da&Qsg8lH;ZMUuzi{s;^w4bUP7TK~RwWplyRM)$PQeQmTg(~fAZ z=0W0;dwF~>k=ajVTs70y`dg2W-~{m$otGRhTz-kRC)gOSei%m?fOR7EgnJ9PT^K<- z3x1QBq)ETf4-~>lvnk0}=tV#<#&AdCcqJbIaG(%LGRb2|TsVOQu3Q6Xk+wGSe&X%q zyUBfRWJ9=GdUF{7yOQR(uSYJHahKfg+7S4qPAfsCKhyb+OoJMdc_LTNdNF3{ixpNV z>c!{mA*jb71mXt4>z3@rDp0G1&cpZ+EaM}b+W?q|iyxo4+7#-Z3OcGs_s8rhEM+YiGE9ay_@ zNWlCL2};M-#t#XY&Fj9|4vg=2flBE#-H?%)rkhS+w;O>y2UQXqY^m*mtF1Wx{0II6 DCx|rI literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/utils/i18n/__pycache__/core.cpython-311.pyc b/env/Lib/site-packages/aiogram/utils/i18n/__pycache__/core.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..63f7bada35938bceaea4100f4c5834a0b5586819 GIT binary patch literal 6572 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/utils/i18n/__pycache__/lazy_proxy.cpython-311.pyc b/env/Lib/site-packages/aiogram/utils/i18n/__pycache__/lazy_proxy.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..249c914409da3a4154b301ecd3ee50c2a113ce0a GIT binary patch literal 1058 zcmZ`%y=xRv5TCanm&=(u%>@)Je@ZC0Tt#hB=v#Z>tjvvLg>vC3jltl5!96GP9 zg-&>UZOx#8ptch|5}=e5tD_ z(~rr4s?C%R0ig?8vD8B^7`i;iw>@rIX~D9*fF-Wfr!4DLV!H#6kV6wCgl{0^@I+C9 zyj=$J!qFna*7)lx`efv%xF-;buSly|vv@V-2&ekQZ(KgZS%MF0Q* literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/utils/i18n/__pycache__/middleware.cpython-311.pyc b/env/Lib/site-packages/aiogram/utils/i18n/__pycache__/middleware.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d50288524362053f480d70ed167cc3b3580ee819 GIT binary patch literal 10034 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 I18n: + i18n = I18n.get_current(no_error=True) + if i18n is None: + raise LookupError("I18n context is not set") + return i18n + + +def gettext(*args: Any, **kwargs: Any) -> str: + return get_i18n().gettext(*args, **kwargs) + + +def lazy_gettext(*args: Any, **kwargs: Any) -> LazyProxy: + return LazyProxy(gettext, *args, **kwargs, enable_cache=False) + + +ngettext = gettext +lazy_ngettext = lazy_gettext diff --git a/env/Lib/site-packages/aiogram/utils/i18n/core.py b/env/Lib/site-packages/aiogram/utils/i18n/core.py new file mode 100644 index 0000000..db7c797 --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/i18n/core.py @@ -0,0 +1,123 @@ +import gettext +import os +from contextlib import contextmanager +from contextvars import ContextVar +from pathlib import Path +from typing import Dict, Generator, Optional, Tuple, Union + +from aiogram.utils.i18n.lazy_proxy import LazyProxy +from aiogram.utils.mixins import ContextInstanceMixin + + +class I18n(ContextInstanceMixin["I18n"]): + def __init__( + self, + *, + path: Union[str, Path], + default_locale: str = "en", + domain: str = "messages", + ) -> None: + self.path = path + self.default_locale = default_locale + self.domain = domain + self.ctx_locale = ContextVar("aiogram_ctx_locale", default=default_locale) + self.locales = self.find_locales() + + @property + def current_locale(self) -> str: + return self.ctx_locale.get() + + @current_locale.setter + def current_locale(self, value: str) -> None: + self.ctx_locale.set(value) + + @contextmanager + def use_locale(self, locale: str) -> Generator[None, None, None]: + """ + Create context with specified locale + """ + ctx_token = self.ctx_locale.set(locale) + try: + yield + finally: + self.ctx_locale.reset(ctx_token) + + @contextmanager + def context(self) -> Generator["I18n", None, None]: + """ + Use I18n context + """ + token = self.set_current(self) + try: + yield self + finally: + self.reset_current(token) + + def find_locales(self) -> Dict[str, gettext.GNUTranslations]: + """ + Load all compiled locales from path + + :return: dict with locales + """ + translations: Dict[str, gettext.GNUTranslations] = {} + + for name in os.listdir(self.path): + if not os.path.isdir(os.path.join(self.path, name)): + continue + mo_path = os.path.join(self.path, name, "LC_MESSAGES", self.domain + ".mo") + + if os.path.exists(mo_path): + with open(mo_path, "rb") as fp: + translations[name] = gettext.GNUTranslations(fp) + elif os.path.exists(mo_path[:-2] + "po"): # pragma: no cover + raise RuntimeError(f"Found locale '{name}' but this language is not compiled!") + + return translations + + def reload(self) -> None: + """ + Hot reload locales + """ + self.locales = self.find_locales() + + @property + def available_locales(self) -> Tuple[str, ...]: + """ + list of loaded locales + + :return: + """ + return tuple(self.locales.keys()) + + def gettext( + self, singular: str, plural: Optional[str] = None, n: int = 1, locale: Optional[str] = None + ) -> str: + """ + Get text + + :param singular: + :param plural: + :param n: + :param locale: + :return: + """ + if locale is None: + locale = self.current_locale + + if locale not in self.locales: + if n == 1: + return singular + return plural if plural else singular + + translator = self.locales[locale] + + if plural is None: + return translator.gettext(singular) + return translator.ngettext(singular, plural, n) + + def lazy_gettext( + self, singular: str, plural: Optional[str] = None, n: int = 1, locale: Optional[str] = None + ) -> LazyProxy: + return LazyProxy( + self.gettext, singular=singular, plural=plural, n=n, locale=locale, enable_cache=False + ) diff --git a/env/Lib/site-packages/aiogram/utils/i18n/lazy_proxy.py b/env/Lib/site-packages/aiogram/utils/i18n/lazy_proxy.py new file mode 100644 index 0000000..6852540 --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/i18n/lazy_proxy.py @@ -0,0 +1,13 @@ +from typing import Any + +try: + from babel.support import LazyProxy +except ImportError: # pragma: no cover + + class LazyProxy: # type: ignore + def __init__(self, func: Any, *args: Any, **kwargs: Any) -> None: + raise RuntimeError( + "LazyProxy can be used only when Babel installed\n" + "Just install Babel (`pip install Babel`) " + "or aiogram with i18n support (`pip install aiogram[i18n]`)" + ) diff --git a/env/Lib/site-packages/aiogram/utils/i18n/middleware.py b/env/Lib/site-packages/aiogram/utils/i18n/middleware.py new file mode 100644 index 0000000..68be22b --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/i18n/middleware.py @@ -0,0 +1,187 @@ +from abc import ABC, abstractmethod +from typing import Any, Awaitable, Callable, Dict, Optional, Set + +try: + from babel import Locale, UnknownLocaleError +except ImportError: # pragma: no cover + Locale = None # type: ignore + + class UnknownLocaleError(Exception): # type: ignore + pass + + +from aiogram import BaseMiddleware, Router +from aiogram.fsm.context import FSMContext +from aiogram.types import TelegramObject, User +from aiogram.utils.i18n.core import I18n + + +class I18nMiddleware(BaseMiddleware, ABC): + """ + Abstract I18n middleware. + """ + + def __init__( + self, + i18n: I18n, + i18n_key: Optional[str] = "i18n", + middleware_key: str = "i18n_middleware", + ) -> None: + """ + Create an instance of middleware + + :param i18n: instance of I18n + :param i18n_key: context key for I18n instance + :param middleware_key: context key for this middleware + """ + self.i18n = i18n + self.i18n_key = i18n_key + self.middleware_key = middleware_key + + def setup( + self: BaseMiddleware, router: Router, exclude: Optional[Set[str]] = None + ) -> BaseMiddleware: + """ + Register middleware for all events in the Router + + :param router: + :param exclude: + :return: + """ + if exclude is None: + exclude = set() + exclude_events = {"update", *exclude} + for event_name, observer in router.observers.items(): + if event_name in exclude_events: + continue + observer.outer_middleware(self) + return self + + async def __call__( + self, + handler: Callable[[TelegramObject, Dict[str, Any]], Awaitable[Any]], + event: TelegramObject, + data: Dict[str, Any], + ) -> Any: + current_locale = await self.get_locale(event=event, data=data) or self.i18n.default_locale + + if self.i18n_key: + data[self.i18n_key] = self.i18n + if self.middleware_key: + data[self.middleware_key] = self + + with self.i18n.context(), self.i18n.use_locale(current_locale): + return await handler(event, data) + + @abstractmethod + async def get_locale(self, event: TelegramObject, data: Dict[str, Any]) -> str: + """ + Detect current user locale based on event and context. + + **This method must be defined in child classes** + + :param event: + :param data: + :return: + """ + pass + + +class SimpleI18nMiddleware(I18nMiddleware): + """ + Simple I18n middleware. + + Chooses language code from the User object received in event + """ + + def __init__( + self, + i18n: I18n, + i18n_key: Optional[str] = "i18n", + middleware_key: str = "i18n_middleware", + ) -> None: + super().__init__(i18n=i18n, i18n_key=i18n_key, middleware_key=middleware_key) + + if Locale is None: # pragma: no cover + raise RuntimeError( + f"{type(self).__name__} can be used only when Babel installed\n" + "Just install Babel (`pip install Babel`) " + "or aiogram with i18n support (`pip install aiogram[i18n]`)" + ) + + async def get_locale(self, event: TelegramObject, data: Dict[str, Any]) -> str: + if Locale is None: # pragma: no cover + raise RuntimeError( + f"{type(self).__name__} can be used only when Babel installed\n" + "Just install Babel (`pip install Babel`) " + "or aiogram with i18n support (`pip install aiogram[i18n]`)" + ) + + event_from_user: Optional[User] = data.get("event_from_user", None) + if event_from_user is None or event_from_user.language_code is None: + return self.i18n.default_locale + try: + locale = Locale.parse(event_from_user.language_code, sep="-") + except UnknownLocaleError: + return self.i18n.default_locale + + if locale.language not in self.i18n.available_locales: + return self.i18n.default_locale + return locale.language + + +class ConstI18nMiddleware(I18nMiddleware): + """ + Const middleware chooses statically defined locale + """ + + def __init__( + self, + locale: str, + i18n: I18n, + i18n_key: Optional[str] = "i18n", + middleware_key: str = "i18n_middleware", + ) -> None: + super().__init__(i18n=i18n, i18n_key=i18n_key, middleware_key=middleware_key) + self.locale = locale + + async def get_locale(self, event: TelegramObject, data: Dict[str, Any]) -> str: + return self.locale + + +class FSMI18nMiddleware(SimpleI18nMiddleware): + """ + This middleware stores locale in the FSM storage + """ + + def __init__( + self, + i18n: I18n, + key: str = "locale", + i18n_key: Optional[str] = "i18n", + middleware_key: str = "i18n_middleware", + ) -> None: + super().__init__(i18n=i18n, i18n_key=i18n_key, middleware_key=middleware_key) + self.key = key + + async def get_locale(self, event: TelegramObject, data: Dict[str, Any]) -> str: + fsm_context: Optional[FSMContext] = data.get("state") + locale = None + if fsm_context: + fsm_data = await fsm_context.get_data() + locale = fsm_data.get(self.key, None) + if not locale: + locale = await super().get_locale(event=event, data=data) + if fsm_context: + await fsm_context.update_data(data={self.key: locale}) + return locale + + async def set_locale(self, state: FSMContext, locale: str) -> None: + """ + Write new locale to the storage + + :param state: instance of FSMContext + :param locale: new locale + """ + await state.update_data(data={self.key: locale}) + self.i18n.current_locale = locale diff --git a/env/Lib/site-packages/aiogram/utils/keyboard.py b/env/Lib/site-packages/aiogram/utils/keyboard.py new file mode 100644 index 0000000..921c28c --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/keyboard.py @@ -0,0 +1,421 @@ +from __future__ import annotations + +from abc import ABC +from copy import deepcopy +from itertools import chain +from itertools import cycle as repeat_all +from typing import ( + TYPE_CHECKING, + Any, + Generator, + Generic, + Iterable, + List, + Optional, + Type, + TypeVar, + Union, + cast, +) + +from aiogram.filters.callback_data import CallbackData +from aiogram.types import ( + CallbackGame, + InlineKeyboardButton, + InlineKeyboardMarkup, + KeyboardButton, + KeyboardButtonPollType, + KeyboardButtonRequestChat, + KeyboardButtonRequestUsers, + LoginUrl, + ReplyKeyboardMarkup, + SwitchInlineQueryChosenChat, + WebAppInfo, +) + +ButtonType = TypeVar("ButtonType", InlineKeyboardButton, KeyboardButton) +T = TypeVar("T") + + +class KeyboardBuilder(Generic[ButtonType], ABC): + """ + Generic keyboard builder that helps to adjust your markup with defined shape of lines. + + Works both of InlineKeyboardMarkup and ReplyKeyboardMarkup. + """ + + max_width: int = 0 + min_width: int = 0 + max_buttons: int = 0 + + def __init__( + self, button_type: Type[ButtonType], markup: Optional[List[List[ButtonType]]] = None + ) -> None: + if not issubclass(button_type, (InlineKeyboardButton, KeyboardButton)): + raise ValueError(f"Button type {button_type} are not allowed here") + self._button_type: Type[ButtonType] = button_type + if markup: + self._validate_markup(markup) + else: + markup = [] + self._markup: List[List[ButtonType]] = markup + + @property + def buttons(self) -> Generator[ButtonType, None, None]: + """ + Get flatten set of all buttons + + :return: + """ + yield from chain.from_iterable(self.export()) + + def _validate_button(self, button: ButtonType) -> bool: + """ + Check that button item has correct type + + :param button: + :return: + """ + allowed = self._button_type + if not isinstance(button, allowed): + raise ValueError( + f"{button!r} should be type {allowed.__name__!r} not {type(button).__name__!r}" + ) + return True + + def _validate_buttons(self, *buttons: ButtonType) -> bool: + """ + Check that all passed button has correct type + + :param buttons: + :return: + """ + return all(map(self._validate_button, buttons)) + + def _validate_row(self, row: List[ButtonType]) -> bool: + """ + Check that row of buttons are correct + Row can be only list of allowed button types and has length 0 <= n <= 8 + + :param row: + :return: + """ + if not isinstance(row, list): + raise ValueError( + f"Row {row!r} should be type 'List[{self._button_type.__name__}]' " + f"not type {type(row).__name__}" + ) + if len(row) > self.max_width: + raise ValueError(f"Row {row!r} is too long (max width: {self.max_width})") + self._validate_buttons(*row) + return True + + def _validate_markup(self, markup: List[List[ButtonType]]) -> bool: + """ + Check that passed markup has correct data structure + Markup is list of lists of buttons + + :param markup: + :return: + """ + count = 0 + if not isinstance(markup, list): + raise ValueError( + f"Markup should be type 'List[List[{self._button_type.__name__}]]' " + f"not type {type(markup).__name__!r}" + ) + for row in markup: + self._validate_row(row) + count += len(row) + if count > self.max_buttons: + raise ValueError(f"Too much buttons detected Max allowed count - {self.max_buttons}") + return True + + def _validate_size(self, size: Any) -> int: + """ + Validate that passed size is legit + + :param size: + :return: + """ + if not isinstance(size, int): + raise ValueError("Only int sizes are allowed") + if size not in range(self.min_width, self.max_width + 1): + raise ValueError( + f"Row size {size} is not allowed, range: [{self.min_width}, {self.max_width}]" + ) + return size + + def export(self) -> List[List[ButtonType]]: + """ + Export configured markup as list of lists of buttons + + .. code-block:: python + + >>> builder = KeyboardBuilder(button_type=InlineKeyboardButton) + >>> ... # Add buttons to builder + >>> markup = InlineKeyboardMarkup(inline_keyboard=builder.export()) + + :return: + """ + return deepcopy(self._markup) + + def add(self, *buttons: ButtonType) -> "KeyboardBuilder[ButtonType]": + """ + Add one or many buttons to markup. + + :param buttons: + :return: + """ + self._validate_buttons(*buttons) + markup = self.export() + + # Try to add new buttons to the end of last row if it possible + if markup and len(markup[-1]) < self.max_width: + last_row = markup[-1] + pos = self.max_width - len(last_row) + head, buttons = buttons[:pos], buttons[pos:] + last_row.extend(head) + + # Separate buttons to exclusive rows with max possible row width + while buttons: + row, buttons = buttons[: self.max_width], buttons[self.max_width :] + markup.append(list(row)) + + self._markup = markup + return self + + def row( + self, *buttons: ButtonType, width: Optional[int] = None + ) -> "KeyboardBuilder[ButtonType]": + """ + Add row to markup + + When too much buttons is passed it will be separated to many rows + + :param buttons: + :param width: + :return: + """ + if width is None: + width = self.max_width + + self._validate_size(width) + self._validate_buttons(*buttons) + self._markup.extend( + list(buttons[pos : pos + width]) for pos in range(0, len(buttons), width) + ) + return self + + def adjust(self, *sizes: int, repeat: bool = False) -> "KeyboardBuilder[ButtonType]": + """ + Adjust previously added buttons to specific row sizes. + + By default, when the sum of passed sizes is lower than buttons count the last + one size will be used for tail of the markup. + If repeat=True is passed - all sizes will be cycled when available more buttons + count than all sizes + + :param sizes: + :param repeat: + :return: + """ + if not sizes: + sizes = (self.max_width,) + + validated_sizes = map(self._validate_size, sizes) + sizes_iter = repeat_all(validated_sizes) if repeat else repeat_last(validated_sizes) + size = next(sizes_iter) + + markup = [] + row: List[ButtonType] = [] + for button in self.buttons: + if len(row) >= size: + markup.append(row) + size = next(sizes_iter) + row = [] + row.append(button) + if row: + markup.append(row) + self._markup = markup + return self + + def _button(self, **kwargs: Any) -> "KeyboardBuilder[ButtonType]": + """ + Add button to markup + + :param kwargs: + :return: + """ + if isinstance(callback_data := kwargs.get("callback_data", None), CallbackData): + kwargs["callback_data"] = callback_data.pack() + button = self._button_type(**kwargs) + return self.add(button) + + def as_markup(self, **kwargs: Any) -> Union[InlineKeyboardMarkup, ReplyKeyboardMarkup]: + if self._button_type is KeyboardButton: + keyboard = cast(List[List[KeyboardButton]], self.export()) # type: ignore + return ReplyKeyboardMarkup(keyboard=keyboard, **kwargs) + inline_keyboard = cast(List[List[InlineKeyboardButton]], self.export()) # type: ignore + return InlineKeyboardMarkup(inline_keyboard=inline_keyboard) + + def attach(self, builder: "KeyboardBuilder[ButtonType]") -> "KeyboardBuilder[ButtonType]": + if not isinstance(builder, KeyboardBuilder): + raise ValueError(f"Only KeyboardBuilder can be attached, not {type(builder).__name__}") + if builder._button_type is not self._button_type: + raise ValueError( + f"Only builders with same button type can be attached, " + f"not {self._button_type.__name__} and {builder._button_type.__name__}" + ) + self._markup.extend(builder.export()) + return self + + +def repeat_last(items: Iterable[T]) -> Generator[T, None, None]: + items_iter = iter(items) + try: + value = next(items_iter) + except StopIteration: # pragma: no cover + # Possible case but not in place where this function is used + return + yield value + finished = False + while True: + if not finished: + try: + value = next(items_iter) + except StopIteration: + finished = True + yield value + + +class InlineKeyboardBuilder(KeyboardBuilder[InlineKeyboardButton]): + """ + Inline keyboard builder inherits all methods from generic builder + """ + + max_width: int = 8 + min_width: int = 1 + max_buttons: int = 100 + + def button( + self, + *, + text: str, + url: Optional[str] = None, + callback_data: Optional[Union[str, CallbackData]] = None, + web_app: Optional[WebAppInfo] = None, + login_url: Optional[LoginUrl] = None, + switch_inline_query: Optional[str] = None, + switch_inline_query_current_chat: Optional[str] = None, + switch_inline_query_chosen_chat: Optional[SwitchInlineQueryChosenChat] = None, + callback_game: Optional[CallbackGame] = None, + pay: Optional[bool] = None, + **kwargs: Any, + ) -> "InlineKeyboardBuilder": + return cast( + InlineKeyboardBuilder, + self._button( + text=text, + url=url, + callback_data=callback_data, + web_app=web_app, + login_url=login_url, + switch_inline_query=switch_inline_query, + switch_inline_query_current_chat=switch_inline_query_current_chat, + switch_inline_query_chosen_chat=switch_inline_query_chosen_chat, + callback_game=callback_game, + pay=pay, + **kwargs, + ), + ) + + if TYPE_CHECKING: + + def as_markup(self, **kwargs: Any) -> InlineKeyboardMarkup: + """Construct an InlineKeyboardMarkup""" + ... + + def __init__(self, markup: Optional[List[List[InlineKeyboardButton]]] = None) -> None: + super().__init__(button_type=InlineKeyboardButton, markup=markup) + + def copy(self: "InlineKeyboardBuilder") -> "InlineKeyboardBuilder": + """ + Make full copy of current builder with markup + + :return: + """ + return InlineKeyboardBuilder(markup=self.export()) + + @classmethod + def from_markup( + cls: Type["InlineKeyboardBuilder"], markup: InlineKeyboardMarkup + ) -> "InlineKeyboardBuilder": + """ + Create builder from existing markup + + :param markup: + :return: + """ + return cls(markup=markup.inline_keyboard) + + +class ReplyKeyboardBuilder(KeyboardBuilder[KeyboardButton]): + """ + Reply keyboard builder inherits all methods from generic builder + """ + + max_width: int = 10 + min_width: int = 1 + max_buttons: int = 300 + + def button( + self, + *, + text: str, + request_users: Optional[KeyboardButtonRequestUsers] = None, + request_chat: Optional[KeyboardButtonRequestChat] = None, + request_contact: Optional[bool] = None, + request_location: Optional[bool] = None, + request_poll: Optional[KeyboardButtonPollType] = None, + web_app: Optional[WebAppInfo] = None, + **kwargs: Any, + ) -> "ReplyKeyboardBuilder": + return cast( + ReplyKeyboardBuilder, + self._button( + text=text, + request_users=request_users, + request_chat=request_chat, + request_contact=request_contact, + request_location=request_location, + request_poll=request_poll, + web_app=web_app, + **kwargs, + ), + ) + + if TYPE_CHECKING: + + def as_markup(self, **kwargs: Any) -> ReplyKeyboardMarkup: ... + + def __init__(self, markup: Optional[List[List[KeyboardButton]]] = None) -> None: + super().__init__(button_type=KeyboardButton, markup=markup) + + def copy(self: "ReplyKeyboardBuilder") -> "ReplyKeyboardBuilder": + """ + Make full copy of current builder with markup + + :return: + """ + return ReplyKeyboardBuilder(markup=self.export()) + + @classmethod + def from_markup(cls, markup: ReplyKeyboardMarkup) -> "ReplyKeyboardBuilder": + """ + Create builder from existing markup + + :param markup: + :return: + """ + return cls(markup=markup.keyboard) diff --git a/env/Lib/site-packages/aiogram/utils/link.py b/env/Lib/site-packages/aiogram/utils/link.py new file mode 100644 index 0000000..051247f --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/link.py @@ -0,0 +1,74 @@ +from typing import Any, Optional +from urllib.parse import urlencode, urljoin + +BASE_DOCS_URL = "https://docs.aiogram.dev/" +BRANCH = "dev-3.x" + +BASE_PAGE_URL = f"{BASE_DOCS_URL}/en/{BRANCH}/" + + +def _format_url(url: str, *path: str, fragment_: Optional[str] = None, **query: Any) -> str: + url = urljoin(url, "/".join(path), allow_fragments=True) + if query: + url += "?" + urlencode(query) + if fragment_: + url += "#" + fragment_ + return url + + +def docs_url(*path: str, fragment_: Optional[str] = None, **query: Any) -> str: + return _format_url(BASE_PAGE_URL, *path, fragment_=fragment_, **query) + + +def create_tg_link(link: str, **kwargs: Any) -> str: + return _format_url(f"tg://{link}", **kwargs) + + +def create_telegram_link(*path: str, **kwargs: Any) -> str: + return _format_url("https://t.me", *path, **kwargs) + + +def create_channel_bot_link( + username: str, + parameter: Optional[str] = None, + change_info: bool = False, + post_messages: bool = False, + edit_messages: bool = False, + delete_messages: bool = False, + restrict_members: bool = False, + invite_users: bool = False, + pin_messages: bool = False, + promote_members: bool = False, + manage_video_chats: bool = False, + anonymous: bool = False, + manage_chat: bool = False, +) -> str: + params = {} + if parameter is not None: + params["startgroup"] = parameter + permissions = [] + if change_info: + permissions.append("change_info") + if post_messages: + permissions.append("post_messages") + if edit_messages: + permissions.append("edit_messages") + if delete_messages: + permissions.append("delete_messages") + if restrict_members: + permissions.append("restrict_members") + if invite_users: + permissions.append("invite_users") + if pin_messages: + permissions.append("pin_messages") + if promote_members: + permissions.append("promote_members") + if manage_video_chats: + permissions.append("manage_video_chats") + if anonymous: + permissions.append("anonymous") + if manage_chat: + permissions.append("manage_chat") + if permissions: + params["admin"] = "+".join(permissions) + return create_telegram_link(username, **params) diff --git a/env/Lib/site-packages/aiogram/utils/magic_filter.py b/env/Lib/site-packages/aiogram/utils/magic_filter.py new file mode 100644 index 0000000..94c9207 --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/magic_filter.py @@ -0,0 +1,22 @@ +from typing import Any, Iterable + +from magic_filter import MagicFilter as _MagicFilter +from magic_filter import MagicT as _MagicT +from magic_filter.operations import BaseOperation + + +class AsFilterResultOperation(BaseOperation): + __slots__ = ("name",) + + def __init__(self, name: str) -> None: + self.name = name + + def resolve(self, value: Any, initial_value: Any) -> Any: + if value is None or (isinstance(value, Iterable) and not value): + return None + return {self.name: value} + + +class MagicFilter(_MagicFilter): + def as_(self: _MagicT, name: str) -> _MagicT: + return self._extend(AsFilterResultOperation(name=name)) diff --git a/env/Lib/site-packages/aiogram/utils/markdown.py b/env/Lib/site-packages/aiogram/utils/markdown.py new file mode 100644 index 0000000..52c6e1d --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/markdown.py @@ -0,0 +1,209 @@ +from typing import Any + +from .text_decorations import html_decoration, markdown_decoration + + +def _join(*content: Any, sep: str = " ") -> str: + return sep.join(map(str, content)) + + +def text(*content: Any, sep: str = " ") -> str: + """ + Join all elements with a separator + + :param content: + :param sep: + :return: + """ + return _join(*content, sep=sep) + + +def bold(*content: Any, sep: str = " ") -> str: + """ + Make bold text (Markdown) + + :param content: + :param sep: + :return: + """ + return markdown_decoration.bold(value=markdown_decoration.quote(_join(*content, sep=sep))) + + +def hbold(*content: Any, sep: str = " ") -> str: + """ + Make bold text (HTML) + + :param content: + :param sep: + :return: + """ + return html_decoration.bold(value=html_decoration.quote(_join(*content, sep=sep))) + + +def italic(*content: Any, sep: str = " ") -> str: + """ + Make italic text (Markdown) + + :param content: + :param sep: + :return: + """ + return markdown_decoration.italic(value=markdown_decoration.quote(_join(*content, sep=sep))) + + +def hitalic(*content: Any, sep: str = " ") -> str: + """ + Make italic text (HTML) + + :param content: + :param sep: + :return: + """ + return html_decoration.italic(value=html_decoration.quote(_join(*content, sep=sep))) + + +def code(*content: Any, sep: str = " ") -> str: + """ + Make mono-width text (Markdown) + + :param content: + :param sep: + :return: + """ + return markdown_decoration.code(value=markdown_decoration.quote(_join(*content, sep=sep))) + + +def hcode(*content: Any, sep: str = " ") -> str: + """ + Make mono-width text (HTML) + + :param content: + :param sep: + :return: + """ + return html_decoration.code(value=html_decoration.quote(_join(*content, sep=sep))) + + +def pre(*content: Any, sep: str = "\n") -> str: + """ + Make mono-width text block (Markdown) + + :param content: + :param sep: + :return: + """ + return markdown_decoration.pre(value=markdown_decoration.quote(_join(*content, sep=sep))) + + +def hpre(*content: Any, sep: str = "\n") -> str: + """ + Make mono-width text block (HTML) + + :param content: + :param sep: + :return: + """ + return html_decoration.pre(value=html_decoration.quote(_join(*content, sep=sep))) + + +def underline(*content: Any, sep: str = " ") -> str: + """ + Make underlined text (Markdown) + + :param content: + :param sep: + :return: + """ + return markdown_decoration.underline(value=markdown_decoration.quote(_join(*content, sep=sep))) + + +def hunderline(*content: Any, sep: str = " ") -> str: + """ + Make underlined text (HTML) + + :param content: + :param sep: + :return: + """ + return html_decoration.underline(value=html_decoration.quote(_join(*content, sep=sep))) + + +def strikethrough(*content: Any, sep: str = " ") -> str: + """ + Make strikethrough text (Markdown) + + :param content: + :param sep: + :return: + """ + return markdown_decoration.strikethrough( + value=markdown_decoration.quote(_join(*content, sep=sep)) + ) + + +def hstrikethrough(*content: Any, sep: str = " ") -> str: + """ + Make strikethrough text (HTML) + + :param content: + :param sep: + :return: + """ + return html_decoration.strikethrough(value=html_decoration.quote(_join(*content, sep=sep))) + + +def link(title: str, url: str) -> str: + """ + Format URL (Markdown) + + :param title: + :param url: + :return: + """ + return markdown_decoration.link(value=markdown_decoration.quote(title), link=url) + + +def hlink(title: str, url: str) -> str: + """ + Format URL (HTML) + + :param title: + :param url: + :return: + """ + return html_decoration.link(value=html_decoration.quote(title), link=url) + + +def blockquote(*content: Any, sep: str = "\n") -> str: + """ + Make blockquote (Markdown) + + :param content: + :param sep: + :return: + """ + return markdown_decoration.blockquote( + value=markdown_decoration.quote(_join(*content, sep=sep)) + ) + + +def hblockquote(*content: Any, sep: str = "\n") -> str: + """ + Make blockquote (HTML) + + :param content: + :param sep: + :return: + """ + return html_decoration.blockquote(value=html_decoration.quote(_join(*content, sep=sep))) + + +def hide_link(url: str) -> str: + """ + Hide URL (HTML only) + Can be used for adding an image to a text message + + :param url: + :return: + """ + return f'​' diff --git a/env/Lib/site-packages/aiogram/utils/media_group.py b/env/Lib/site-packages/aiogram/utils/media_group.py new file mode 100644 index 0000000..ff98525 --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/media_group.py @@ -0,0 +1,368 @@ +from typing import Any, Dict, List, Literal, Optional, Union, overload + +from aiogram.enums import InputMediaType +from aiogram.types import ( + UNSET_PARSE_MODE, + InputFile, + InputMedia, + InputMediaAudio, + InputMediaDocument, + InputMediaPhoto, + InputMediaVideo, + MessageEntity, +) + +MediaType = Union[ + InputMediaAudio, + InputMediaPhoto, + InputMediaVideo, + InputMediaDocument, +] + +MAX_MEDIA_GROUP_SIZE = 10 + + +class MediaGroupBuilder: + # Animated media is not supported yet in Bot API to send as a media group + + def __init__( + self, + media: Optional[List[MediaType]] = None, + caption: Optional[str] = None, + caption_entities: Optional[List[MessageEntity]] = None, + ) -> None: + """ + Helper class for building media groups. + + :param media: A list of media elements to add to the media group. (optional) + :param caption: Caption for the media group. (optional) + :param caption_entities: List of special entities in the caption, + like usernames, URLs, etc. (optional) + """ + self._media: List[MediaType] = [] + self.caption = caption + self.caption_entities = caption_entities + + self._extend(media or []) + + def _add(self, media: MediaType) -> None: + if not isinstance(media, InputMedia): + raise ValueError("Media must be instance of InputMedia") + + if len(self._media) >= MAX_MEDIA_GROUP_SIZE: + raise ValueError("Media group can't contain more than 10 elements") + + self._media.append(media) + + def _extend(self, media: List[MediaType]) -> None: + for m in media: + self._add(m) + + @overload + def add( + self, + *, + type: Literal[InputMediaType.AUDIO], + media: Union[str, InputFile], + caption: Optional[str] = None, + parse_mode: Optional[str] = UNSET_PARSE_MODE, + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + performer: Optional[str] = None, + title: Optional[str] = None, + **kwargs: Any, + ) -> None: + pass + + @overload + def add( + self, + *, + type: Literal[InputMediaType.PHOTO], + media: Union[str, InputFile], + caption: Optional[str] = None, + parse_mode: Optional[str] = UNSET_PARSE_MODE, + caption_entities: Optional[List[MessageEntity]] = None, + has_spoiler: Optional[bool] = None, + **kwargs: Any, + ) -> None: + pass + + @overload + def add( + self, + *, + type: Literal[InputMediaType.VIDEO], + media: Union[str, InputFile], + thumbnail: Optional[Union[InputFile, str]] = None, + caption: Optional[str] = None, + parse_mode: Optional[str] = UNSET_PARSE_MODE, + caption_entities: Optional[List[MessageEntity]] = None, + width: Optional[int] = None, + height: Optional[int] = None, + duration: Optional[int] = None, + supports_streaming: Optional[bool] = None, + has_spoiler: Optional[bool] = None, + **kwargs: Any, + ) -> None: + pass + + @overload + def add( + self, + *, + type: Literal[InputMediaType.DOCUMENT], + media: Union[str, InputFile], + thumbnail: Optional[Union[InputFile, str]] = None, + caption: Optional[str] = None, + parse_mode: Optional[str] = UNSET_PARSE_MODE, + caption_entities: Optional[List[MessageEntity]] = None, + disable_content_type_detection: Optional[bool] = None, + **kwargs: Any, + ) -> None: + pass + + def add(self, **kwargs: Any) -> None: + """ + Add a media object to the media group. + + :param kwargs: Keyword arguments for the media object. + The available keyword arguments depend on the media type. + :return: None + """ + type_ = kwargs.pop("type", None) + if type_ == InputMediaType.AUDIO: + self.add_audio(**kwargs) + elif type_ == InputMediaType.PHOTO: + self.add_photo(**kwargs) + elif type_ == InputMediaType.VIDEO: + self.add_video(**kwargs) + elif type_ == InputMediaType.DOCUMENT: + self.add_document(**kwargs) + else: + raise ValueError(f"Unknown media type: {type_!r}") + + def add_audio( + self, + media: Union[str, InputFile], + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[str] = UNSET_PARSE_MODE, + caption_entities: Optional[List[MessageEntity]] = None, + duration: Optional[int] = None, + performer: Optional[str] = None, + title: Optional[str] = None, + **kwargs: Any, + ) -> None: + """ + Add an audio file to the media group. + + :param media: File to send. Pass a file_id to send a file that exists on the + Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from + the Internet, or pass 'attach://' to upload a new one using + multipart/form-data under name. + :ref:`More information on Sending Files » ` + :param thumbnail: *Optional*. Thumbnail of the file sent; can be ignored if + thumbnail generation for the file is supported server-side. The thumbnail should + be in JPEG format and less than 200 kB in size. A thumbnail's width and height + should not exceed 320. + :param caption: *Optional*. Caption of the audio to be sent, 0-1024 characters + after entities parsing + :param parse_mode: *Optional*. Mode for parsing entities in the audio caption. + See `formatting options `_ + for more details. + :param caption_entities: *Optional*. List of special entities that appear in the caption, + which can be specified instead of *parse_mode* + :param duration: *Optional*. Duration of the audio in seconds + :param performer: *Optional*. Performer of the audio + :param title: *Optional*. Title of the audio + :return: None + """ + self._add( + InputMediaAudio( + media=media, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + duration=duration, + performer=performer, + title=title, + **kwargs, + ) + ) + + def add_photo( + self, + media: Union[str, InputFile], + caption: Optional[str] = None, + parse_mode: Optional[str] = UNSET_PARSE_MODE, + caption_entities: Optional[List[MessageEntity]] = None, + has_spoiler: Optional[bool] = None, + **kwargs: Any, + ) -> None: + """ + Add a photo to the media group. + + :param media: File to send. Pass a file_id to send a file that exists on the + Telegram servers (recommended), pass an HTTP URL for Telegram to get a file + from the Internet, or pass 'attach://' to upload a new + one using multipart/form-data under name. + :ref:`More information on Sending Files » ` + :param caption: *Optional*. Caption of the photo to be sent, 0-1024 characters + after entities parsing + :param parse_mode: *Optional*. Mode for parsing entities in the photo caption. + See `formatting options `_ + for more details. + :param caption_entities: *Optional*. List of special entities that appear in the caption, + which can be specified instead of *parse_mode* + :param has_spoiler: *Optional*. Pass :code:`True` if the photo needs to be covered + with a spoiler animation + :return: None + """ + self._add( + InputMediaPhoto( + media=media, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + has_spoiler=has_spoiler, + **kwargs, + ) + ) + + def add_video( + self, + media: Union[str, InputFile], + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[str] = UNSET_PARSE_MODE, + caption_entities: Optional[List[MessageEntity]] = None, + width: Optional[int] = None, + height: Optional[int] = None, + duration: Optional[int] = None, + supports_streaming: Optional[bool] = None, + has_spoiler: Optional[bool] = None, + **kwargs: Any, + ) -> None: + """ + Add a video to the media group. + + :param media: File to send. Pass a file_id to send a file that exists on the + Telegram servers (recommended), pass an HTTP URL for Telegram to get a file + from the Internet, or pass 'attach://' to upload a new one + using multipart/form-data under name. + :ref:`More information on Sending Files » ` + :param thumbnail: *Optional*. Thumbnail of the file sent; can be ignored if thumbnail + generation for the file is supported server-side. The thumbnail should be in JPEG + format and less than 200 kB in size. A thumbnail's width and height should + not exceed 320. Ignored if the file is not uploaded using multipart/form-data. + Thumbnails can't be reused and can be only uploaded as a new file, so you + can pass 'attach://' if the thumbnail was uploaded using + multipart/form-data under . + :ref:`More information on Sending Files » ` + :param caption: *Optional*. Caption of the video to be sent, + 0-1024 characters after entities parsing + :param parse_mode: *Optional*. Mode for parsing entities in the video caption. + See `formatting options `_ + for more details. + :param caption_entities: *Optional*. List of special entities that appear in the caption, + which can be specified instead of *parse_mode* + :param width: *Optional*. Video width + :param height: *Optional*. Video height + :param duration: *Optional*. Video duration in seconds + :param supports_streaming: *Optional*. Pass :code:`True` if the uploaded video is + suitable for streaming + :param has_spoiler: *Optional*. Pass :code:`True` if the video needs to be covered + with a spoiler animation + :return: None + """ + self._add( + InputMediaVideo( + media=media, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + width=width, + height=height, + duration=duration, + supports_streaming=supports_streaming, + has_spoiler=has_spoiler, + **kwargs, + ) + ) + + def add_document( + self, + media: Union[str, InputFile], + thumbnail: Optional[InputFile] = None, + caption: Optional[str] = None, + parse_mode: Optional[str] = UNSET_PARSE_MODE, + caption_entities: Optional[List[MessageEntity]] = None, + disable_content_type_detection: Optional[bool] = None, + **kwargs: Any, + ) -> None: + """ + Add a document to the media group. + + :param media: File to send. Pass a file_id to send a file that exists on the + Telegram servers (recommended), pass an HTTP URL for Telegram to get a file + from the Internet, or pass 'attach://' to upload a new one using + multipart/form-data under name. + :ref:`More information on Sending Files » ` + :param thumbnail: *Optional*. Thumbnail of the file sent; can be ignored + if thumbnail generation for the file is supported server-side. + The thumbnail should be in JPEG format and less than 200 kB in size. + A thumbnail's width and height should not exceed 320. + Ignored if the file is not uploaded using multipart/form-data. + Thumbnails can't be reused and can be only uploaded as a new file, + so you can pass 'attach://' if the thumbnail was uploaded + using multipart/form-data under . + :ref:`More information on Sending Files » ` + :param caption: *Optional*. Caption of the document to be sent, + 0-1024 characters after entities parsing + :param parse_mode: *Optional*. Mode for parsing entities in the document caption. + See `formatting options `_ + for more details. + :param caption_entities: *Optional*. List of special entities that appear + in the caption, which can be specified instead of *parse_mode* + :param disable_content_type_detection: *Optional*. Disables automatic server-side + content type detection for files uploaded using multipart/form-data. + Always :code:`True`, if the document is sent as part of an album. + :return: None + + """ + self._add( + InputMediaDocument( + media=media, + thumbnail=thumbnail, + caption=caption, + parse_mode=parse_mode, + caption_entities=caption_entities, + disable_content_type_detection=disable_content_type_detection, + **kwargs, + ) + ) + + def build(self) -> List[MediaType]: + """ + Builds a list of media objects for a media group. + + Adds the caption to the first media object if it is present. + + :return: List of media objects. + """ + update_first_media: Dict[str, Any] = {"caption": self.caption} + if self.caption_entities is not None: + update_first_media["caption_entities"] = self.caption_entities + update_first_media["parse_mode"] = None + + return [ + ( + media.model_copy(update=update_first_media) + if index == 0 and self.caption is not None + else media + ) + for index, media in enumerate(self._media) + ] diff --git a/env/Lib/site-packages/aiogram/utils/mixins.py b/env/Lib/site-packages/aiogram/utils/mixins.py new file mode 100644 index 0000000..86b3ed8 --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/mixins.py @@ -0,0 +1,95 @@ +from __future__ import annotations + +import contextvars +from typing import TYPE_CHECKING, Any, Dict, Generic, Optional, TypeVar, cast, overload + +if TYPE_CHECKING: + from typing_extensions import Literal + +__all__ = ("ContextInstanceMixin", "DataMixin") + + +class DataMixin: + @property + def data(self) -> Dict[str, Any]: + data: Optional[Dict[str, Any]] = getattr(self, "_data", None) + if data is None: + data = {} + setattr(self, "_data", data) + return data + + def __getitem__(self, key: str) -> Any: + return self.data[key] + + def __setitem__(self, key: str, value: Any) -> None: + self.data[key] = value + + def __delitem__(self, key: str) -> None: + del self.data[key] + + def __contains__(self, key: str) -> bool: + return key in self.data + + def get(self, key: str, default: Optional[Any] = None) -> Optional[Any]: + return self.data.get(key, default) + + +ContextInstance = TypeVar("ContextInstance") + + +class ContextInstanceMixin(Generic[ContextInstance]): + __context_instance: contextvars.ContextVar[ContextInstance] + + def __init_subclass__(cls, **kwargs: Any) -> None: + super().__init_subclass__() + cls.__context_instance = contextvars.ContextVar(f"instance_{cls.__name__}") + + @overload # noqa: F811 + @classmethod + def get_current(cls) -> Optional[ContextInstance]: # pragma: no cover # noqa: F811 + ... + + @overload # noqa: F811 + @classmethod + def get_current( # noqa: F811 + cls, no_error: Literal[True] + ) -> Optional[ContextInstance]: # pragma: no cover # noqa: F811 + ... + + @overload # noqa: F811 + @classmethod + def get_current( # noqa: F811 + cls, no_error: Literal[False] + ) -> ContextInstance: # pragma: no cover # noqa: F811 + ... + + @classmethod # noqa: F811 + def get_current( # noqa: F811 + cls, no_error: bool = True + ) -> Optional[ContextInstance]: # pragma: no cover # noqa: F811 + # on mypy 0.770 I catch that contextvars.ContextVar always contextvars.ContextVar[Any] + cls.__context_instance = cast( + contextvars.ContextVar[ContextInstance], cls.__context_instance + ) + + try: + current: Optional[ContextInstance] = cls.__context_instance.get() + except LookupError: + if no_error: + current = None + else: + raise + + return current + + @classmethod + def set_current(cls, value: ContextInstance) -> contextvars.Token[ContextInstance]: + if not isinstance(value, cls): + raise TypeError( + f"Value should be instance of {cls.__name__!r} not {type(value).__name__!r}" + ) + return cls.__context_instance.set(value) + + @classmethod + def reset_current(cls, token: contextvars.Token[ContextInstance]) -> None: + cls.__context_instance.reset(token) diff --git a/env/Lib/site-packages/aiogram/utils/mypy_hacks.py b/env/Lib/site-packages/aiogram/utils/mypy_hacks.py new file mode 100644 index 0000000..ea47a9d --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/mypy_hacks.py @@ -0,0 +1,16 @@ +import functools +from typing import Callable, TypeVar + +T = TypeVar("T") + + +def lru_cache(maxsize: int = 128, typed: bool = False) -> Callable[[T], T]: + """ + fix: lru_cache annotation doesn't work with a property + this hack is only needed for the property, so type annotations are as they are + """ + + def wrapper(func: T) -> T: + return functools.lru_cache(maxsize, typed)(func) # type: ignore + + return wrapper diff --git a/env/Lib/site-packages/aiogram/utils/payload.py b/env/Lib/site-packages/aiogram/utils/payload.py new file mode 100644 index 0000000..dbdba65 --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/payload.py @@ -0,0 +1,109 @@ +""" +Payload preparing + +We have added some utils to make work with payload easier. + +Basic encode example: + + .. code-block:: python + + from aiogram.utils.payload import encode_payload + + encoded = encode_payload("foo") + + # result: "Zm9v" + +Basic decode it back example: + + .. code-block:: python + + from aiogram.utils.payload import decode_payload + + encoded = "Zm9v" + decoded = decode_payload(encoded) + # result: "foo" + +Encoding and decoding with your own methods: + + 1. Create your own cryptor + + .. code-block:: python + + from Cryptodome.Cipher import AES + from Cryptodome.Util.Padding import pad, unpad + + class Cryptor: + def __init__(self, key: str): + self.key = key.encode("utf-8") + self.mode = AES.MODE_ECB # never use ECB in strong systems obviously + self.size = 32 + + @property + def cipher(self): + return AES.new(self.key, self.mode) + + def encrypt(self, data: bytes) -> bytes: + return self.cipher.encrypt(pad(data, self.size)) + + def decrypt(self, data: bytes) -> bytes: + decrypted_data = self.cipher.decrypt(data) + return unpad(decrypted_data, self.size) + + 2. Pass cryptor callable methods to aiogram payload tools + + .. code-block:: python + + cryptor = Cryptor("abcdefghijklmnop") + encoded = encode_payload("foo", encoder=cryptor.encrypt) + decoded = decode_payload(encoded_payload, decoder=cryptor.decrypt) + + # result: decoded == "foo" + +""" + +from base64 import urlsafe_b64decode, urlsafe_b64encode +from typing import Callable, Optional + + +def encode_payload( + payload: str, + encoder: Optional[Callable[[bytes], bytes]] = None, +) -> str: + """Encode payload with encoder. + + Result also will be encoded with URL-safe base64url. + """ + if not isinstance(payload, str): + payload = str(payload) + + payload_bytes = payload.encode("utf-8") + if encoder is not None: + payload_bytes = encoder(payload_bytes) + + return _encode_b64(payload_bytes) + + +def decode_payload( + payload: str, + decoder: Optional[Callable[[bytes], bytes]] = None, +) -> str: + """Decode URL-safe base64url payload with decoder.""" + original_payload = _decode_b64(payload) + + if decoder is None: + return original_payload.decode() + + return decoder(original_payload).decode() + + +def _encode_b64(payload: bytes) -> str: + """Encode with URL-safe base64url.""" + bytes_payload: bytes = urlsafe_b64encode(payload) + str_payload = bytes_payload.decode() + return str_payload.replace("=", "") + + +def _decode_b64(payload: str) -> bytes: + """Decode with URL-safe base64url.""" + payload += "=" * (4 - len(payload) % 4) + return urlsafe_b64decode(payload.encode()) diff --git a/env/Lib/site-packages/aiogram/utils/serialization.py b/env/Lib/site-packages/aiogram/utils/serialization.py new file mode 100644 index 0000000..cc6ef8a --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/serialization.py @@ -0,0 +1,89 @@ +from dataclasses import dataclass +from typing import Any, Dict, Optional + +from pydantic import BaseModel + +from aiogram import Bot +from aiogram.client.default import DefaultBotProperties +from aiogram.methods import TelegramMethod +from aiogram.types import InputFile + + +def _get_fake_bot(default: Optional[DefaultBotProperties] = None) -> Bot: + if default is None: + default = DefaultBotProperties() + return Bot(token="42:Fake", default=default) + + +@dataclass +class DeserializedTelegramObject: + """ + Represents a dumped Telegram object. + + :param data: The dumped data of the Telegram object. + :type data: Any + :param files: The dictionary containing the file names as keys + and the corresponding `InputFile` objects as values. + :type files: Dict[str, InputFile] + """ + + data: Any + files: Dict[str, InputFile] + + +def deserialize_telegram_object( + obj: Any, + default: Optional[DefaultBotProperties] = None, + include_api_method_name: bool = True, +) -> DeserializedTelegramObject: + """ + Deserialize Telegram Object to JSON compatible Python object. + + :param obj: The object to be deserialized. + :param default: Default bot properties + should be passed only if you want to use custom defaults. + :param include_api_method_name: Whether to include the API method name in the result. + :return: The deserialized Telegram object. + """ + extends = {} + if include_api_method_name and isinstance(obj, TelegramMethod): + extends["method"] = obj.__api_method__ + + if isinstance(obj, BaseModel): + obj = obj.model_dump(mode="python", warnings=False) + + # Fake bot is needed to exclude global defaults from the object. + fake_bot = _get_fake_bot(default=default) + + files: Dict[str, InputFile] = {} + prepared = fake_bot.session.prepare_value( + obj, + bot=fake_bot, + files=files, + _dumps_json=False, + ) + + if isinstance(prepared, dict): + prepared.update(extends) + return DeserializedTelegramObject(data=prepared, files=files) + + +def deserialize_telegram_object_to_python( + obj: Any, + default: Optional[DefaultBotProperties] = None, + include_api_method_name: bool = True, +) -> Any: + """ + Deserialize telegram object to JSON compatible Python object excluding files. + + :param obj: The telegram object to be deserialized. + :param default: Default bot properties + should be passed only if you want to use custom defaults. + :param include_api_method_name: Whether to include the API method name in the result. + :return: The deserialized telegram object. + """ + return deserialize_telegram_object( + obj, + default=default, + include_api_method_name=include_api_method_name, + ).data diff --git a/env/Lib/site-packages/aiogram/utils/text_decorations.py b/env/Lib/site-packages/aiogram/utils/text_decorations.py new file mode 100644 index 0000000..440fffa --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/text_decorations.py @@ -0,0 +1,274 @@ +from __future__ import annotations + +import html +import re +from abc import ABC, abstractmethod +from typing import TYPE_CHECKING, Generator, List, Optional, Pattern, cast + +from aiogram.enums import MessageEntityType + +if TYPE_CHECKING: + from aiogram.types import MessageEntity + +__all__ = ( + "HtmlDecoration", + "MarkdownDecoration", + "TextDecoration", + "html_decoration", + "markdown_decoration", + "add_surrogates", + "remove_surrogates", +) + + +def add_surrogates(text: str) -> bytes: + return text.encode("utf-16-le") + + +def remove_surrogates(text: bytes) -> str: + return text.decode("utf-16-le") + + +class TextDecoration(ABC): + def apply_entity(self, entity: MessageEntity, text: str) -> str: + """ + Apply single entity to text + + :param entity: + :param text: + :return: + """ + if entity.type in { + MessageEntityType.BOT_COMMAND, + MessageEntityType.URL, + MessageEntityType.MENTION, + MessageEntityType.PHONE_NUMBER, + MessageEntityType.HASHTAG, + MessageEntityType.CASHTAG, + MessageEntityType.EMAIL, + }: + # These entities should not be changed + return text + if entity.type in { + MessageEntityType.BOLD, + MessageEntityType.ITALIC, + MessageEntityType.CODE, + MessageEntityType.UNDERLINE, + MessageEntityType.STRIKETHROUGH, + MessageEntityType.SPOILER, + MessageEntityType.BLOCKQUOTE, + MessageEntityType.EXPANDABLE_BLOCKQUOTE, + }: + return cast(str, getattr(self, entity.type)(value=text)) + if entity.type == MessageEntityType.PRE: + return ( + self.pre_language(value=text, language=entity.language) + if entity.language + else self.pre(value=text) + ) + if entity.type == MessageEntityType.TEXT_MENTION: + from aiogram.types import User + + user = cast(User, entity.user) + return self.link(value=text, link=f"tg://user?id={user.id}") + if entity.type == MessageEntityType.TEXT_LINK: + return self.link(value=text, link=cast(str, entity.url)) + if entity.type == MessageEntityType.CUSTOM_EMOJI: + return self.custom_emoji(value=text, custom_emoji_id=cast(str, entity.custom_emoji_id)) + + # This case is not possible because of `if` above, but if any new entity is added to + # API it will be here too + return self.quote(text) + + def unparse(self, text: str, entities: Optional[List[MessageEntity]] = None) -> str: + """ + Unparse message entities + + :param text: raw text + :param entities: Array of MessageEntities + :return: + """ + return "".join( + self._unparse_entities( + add_surrogates(text), + sorted(entities, key=lambda item: item.offset) if entities else [], + ) + ) + + def _unparse_entities( + self, + text: bytes, + entities: List[MessageEntity], + offset: Optional[int] = None, + length: Optional[int] = None, + ) -> Generator[str, None, None]: + if offset is None: + offset = 0 + length = length or len(text) + + for index, entity in enumerate(entities): + if entity.offset * 2 < offset: + continue + if entity.offset * 2 > offset: + yield self.quote(remove_surrogates(text[offset : entity.offset * 2])) + start = entity.offset * 2 + offset = entity.offset * 2 + entity.length * 2 + + sub_entities = list( + filter(lambda e: e.offset * 2 < (offset or 0), entities[index + 1 :]) + ) + yield self.apply_entity( + entity, + "".join(self._unparse_entities(text, sub_entities, offset=start, length=offset)), + ) + + if offset < length: + yield self.quote(remove_surrogates(text[offset:length])) + + @abstractmethod + def link(self, value: str, link: str) -> str: + pass + + @abstractmethod + def bold(self, value: str) -> str: + pass + + @abstractmethod + def italic(self, value: str) -> str: + pass + + @abstractmethod + def code(self, value: str) -> str: + pass + + @abstractmethod + def pre(self, value: str) -> str: + pass + + @abstractmethod + def pre_language(self, value: str, language: str) -> str: + pass + + @abstractmethod + def underline(self, value: str) -> str: + pass + + @abstractmethod + def strikethrough(self, value: str) -> str: + pass + + @abstractmethod + def spoiler(self, value: str) -> str: + pass + + @abstractmethod + def quote(self, value: str) -> str: + pass + + @abstractmethod + def custom_emoji(self, value: str, custom_emoji_id: str) -> str: + pass + + @abstractmethod + def blockquote(self, value: str) -> str: + pass + + @abstractmethod + def expandable_blockquote(self, value: str) -> str: + pass + + +class HtmlDecoration(TextDecoration): + BOLD_TAG = "b" + ITALIC_TAG = "i" + UNDERLINE_TAG = "u" + STRIKETHROUGH_TAG = "s" + SPOILER_TAG = "tg-spoiler" + EMOJI_TAG = "tg-emoji" + BLOCKQUOTE_TAG = "blockquote" + + def link(self, value: str, link: str) -> str: + return f'{value}' + + def bold(self, value: str) -> str: + return f"<{self.BOLD_TAG}>{value}" + + def italic(self, value: str) -> str: + return f"<{self.ITALIC_TAG}>{value}" + + def code(self, value: str) -> str: + return f"{value}" + + def pre(self, value: str) -> str: + return f"
      {value}
      " + + def pre_language(self, value: str, language: str) -> str: + return f'
      {value}
      ' + + def underline(self, value: str) -> str: + return f"<{self.UNDERLINE_TAG}>{value}" + + def strikethrough(self, value: str) -> str: + return f"<{self.STRIKETHROUGH_TAG}>{value}" + + def spoiler(self, value: str) -> str: + return f"<{self.SPOILER_TAG}>{value}" + + def quote(self, value: str) -> str: + return html.escape(value, quote=False) + + def custom_emoji(self, value: str, custom_emoji_id: str) -> str: + return f'<{self.EMOJI_TAG} emoji-id="{custom_emoji_id}">{value}' + + def blockquote(self, value: str) -> str: + return f"<{self.BLOCKQUOTE_TAG}>{value}" + + def expandable_blockquote(self, value: str) -> str: + return f"<{self.BLOCKQUOTE_TAG} expandable>{value}" + + +class MarkdownDecoration(TextDecoration): + MARKDOWN_QUOTE_PATTERN: Pattern[str] = re.compile(r"([_*\[\]()~`>#+\-=|{}.!\\])") + + def link(self, value: str, link: str) -> str: + return f"[{value}]({link})" + + def bold(self, value: str) -> str: + return f"*{value}*" + + def italic(self, value: str) -> str: + return f"_\r{value}_\r" + + def code(self, value: str) -> str: + return f"`{value}`" + + def pre(self, value: str) -> str: + return f"```\n{value}\n```" + + def pre_language(self, value: str, language: str) -> str: + return f"```{language}\n{value}\n```" + + def underline(self, value: str) -> str: + return f"__\r{value}__\r" + + def strikethrough(self, value: str) -> str: + return f"~{value}~" + + def spoiler(self, value: str) -> str: + return f"||{value}||" + + def quote(self, value: str) -> str: + return re.sub(pattern=self.MARKDOWN_QUOTE_PATTERN, repl=r"\\\1", string=value) + + def custom_emoji(self, value: str, custom_emoji_id: str) -> str: + return f'!{self.link(value=value, link=f"tg://emoji?id={custom_emoji_id}")}' + + def blockquote(self, value: str) -> str: + return "\n".join(f">{line}" for line in value.splitlines()) + + def expandable_blockquote(self, value: str) -> str: + return "\n".join(f">{line}" for line in value.splitlines()) + "||" + + +html_decoration = HtmlDecoration() +markdown_decoration = MarkdownDecoration() diff --git a/env/Lib/site-packages/aiogram/utils/token.py b/env/Lib/site-packages/aiogram/utils/token.py new file mode 100644 index 0000000..c073846 --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/token.py @@ -0,0 +1,42 @@ +from functools import lru_cache + + +class TokenValidationError(Exception): + pass + + +@lru_cache() +def validate_token(token: str) -> bool: + """ + Validate Telegram token + + :param token: + :return: + """ + if not isinstance(token, str): + raise TokenValidationError( + f"Token is invalid! It must be 'str' type instead of {type(token)} type." + ) + + if any(x.isspace() for x in token): + message = "Token is invalid! It can't contains spaces." + raise TokenValidationError(message) + + left, sep, right = token.partition(":") + if (not sep) or (not left.isdigit()) or (not right): + raise TokenValidationError("Token is invalid!") + + return True + + +@lru_cache() +def extract_bot_id(token: str) -> int: + """ + Extract bot ID from Telegram token + + :param token: + :return: + """ + validate_token(token) + raw_bot_id, *_ = token.split(":") + return int(raw_bot_id) diff --git a/env/Lib/site-packages/aiogram/utils/warnings.py b/env/Lib/site-packages/aiogram/utils/warnings.py new file mode 100644 index 0000000..3099fc3 --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/warnings.py @@ -0,0 +1,6 @@ +class AiogramWarning(Warning): + pass + + +class Recommendation(AiogramWarning): + pass diff --git a/env/Lib/site-packages/aiogram/utils/web_app.py b/env/Lib/site-packages/aiogram/utils/web_app.py new file mode 100644 index 0000000..192776f --- /dev/null +++ b/env/Lib/site-packages/aiogram/utils/web_app.py @@ -0,0 +1,183 @@ +import hashlib +import hmac +import json +from datetime import datetime +from operator import itemgetter +from typing import Any, Callable, Optional +from urllib.parse import parse_qsl + +from aiogram.types import TelegramObject + + +class WebAppChat(TelegramObject): + """ + This object represents a chat. + + Source: https://core.telegram.org/bots/webapps#webappchat + """ + + id: int + """Unique identifier for this chat. This number may have more than 32 significant bits + and some programming languages may have difficulty/silent defects in interpreting it. + But it has at most 52 significant bits, so a signed 64-bit integer or double-precision + float type are safe for storing this identifier.""" + type: str + """Type of chat, can be either “group”, “supergroup” or “channel”""" + title: str + """Title of the chat""" + username: Optional[str] = None + """Username of the chat""" + photo_url: Optional[str] = None + """URL of the chat’s photo. The photo can be in .jpeg or .svg formats. + Only returned for Web Apps launched from the attachment menu.""" + + +class WebAppUser(TelegramObject): + """ + This object contains the data of the Web App user. + + Source: https://core.telegram.org/bots/webapps#webappuser + """ + + id: int + """A unique identifier for the user or bot. This number may have more than 32 significant bits + and some programming languages may have difficulty/silent defects in interpreting it. + It has at most 52 significant bits, so a 64-bit integer or a double-precision float type + is safe for storing this identifier.""" + is_bot: Optional[bool] = None + """True, if this user is a bot. Returns in the receiver field only.""" + first_name: str + """First name of the user or bot.""" + last_name: Optional[str] = None + """Last name of the user or bot.""" + username: Optional[str] = None + """Username of the user or bot.""" + language_code: Optional[str] = None + """IETF language tag of the user's language. Returns in user field only.""" + is_premium: Optional[bool] = None + """True, if this user is a Telegram Premium user.""" + added_to_attachment_menu: Optional[bool] = None + """True, if this user added the bot to the attachment menu.""" + allows_write_to_pm: Optional[bool] = None + """True, if this user allowed the bot to message them.""" + photo_url: Optional[str] = None + """URL of the user’s profile photo. The photo can be in .jpeg or .svg formats. + Only returned for Web Apps launched from the attachment menu.""" + + +class WebAppInitData(TelegramObject): + """ + This object contains data that is transferred to the Web App when it is opened. + It is empty if the Web App was launched from a keyboard button. + + Source: https://core.telegram.org/bots/webapps#webappinitdata + """ + + query_id: Optional[str] = None + """A unique identifier for the Web App session, required for sending messages + via the answerWebAppQuery method.""" + user: Optional[WebAppUser] = None + """An object containing data about the current user.""" + receiver: Optional[WebAppUser] = None + """An object containing data about the chat partner of the current user in the chat where + the bot was launched via the attachment menu. + Returned only for Web Apps launched via the attachment menu.""" + chat: Optional[WebAppChat] = None + """An object containing data about the chat where the bot was launched via the attachment menu. + Returned for supergroups, channels, and group chats – only for Web Apps launched via the + attachment menu.""" + chat_type: Optional[str] = None + """Type of the chat from which the Web App was opened. + Can be either “sender” for a private chat with the user opening the link, + “private”, “group”, “supergroup”, or “channel”. + Returned only for Web Apps launched from direct links.""" + chat_instance: Optional[str] = None + """Global identifier, uniquely corresponding to the chat from which the Web App was opened. + Returned only for Web Apps launched from a direct link.""" + start_param: Optional[str] = None + """The value of the startattach parameter, passed via link. + Only returned for Web Apps when launched from the attachment menu via link. + The value of the start_param parameter will also be passed in the GET-parameter + tgWebAppStartParam, so the Web App can load the correct interface right away.""" + can_send_after: Optional[int] = None + """Time in seconds, after which a message can be sent via the answerWebAppQuery method.""" + auth_date: datetime + """Unix time when the form was opened.""" + hash: str + """A hash of all passed parameters, which the bot server can use to check their validity.""" + + +def check_webapp_signature(token: str, init_data: str) -> bool: + """ + Check incoming WebApp init data signature + + Source: https://core.telegram.org/bots/webapps#validating-data-received-via-the-web-app + + :param token: bot Token + :param init_data: data from frontend to be validated + :return: + """ + try: + parsed_data = dict(parse_qsl(init_data, strict_parsing=True)) + except ValueError: # pragma: no cover + # Init data is not a valid query string + return False + if "hash" not in parsed_data: + # Hash is not present in init data + return False + hash_ = parsed_data.pop("hash") + + data_check_string = "\n".join( + f"{k}={v}" for k, v in sorted(parsed_data.items(), key=itemgetter(0)) + ) + secret_key = hmac.new(key=b"WebAppData", msg=token.encode(), digestmod=hashlib.sha256) + calculated_hash = hmac.new( + key=secret_key.digest(), msg=data_check_string.encode(), digestmod=hashlib.sha256 + ).hexdigest() + return calculated_hash == hash_ + + +def parse_webapp_init_data( + init_data: str, + *, + loads: Callable[..., Any] = json.loads, +) -> WebAppInitData: + """ + Parse WebApp init data and return it as WebAppInitData object + + This method doesn't make any security check, so you shall not trust to this data, + use :code:`safe_parse_webapp_init_data` instead. + + :param init_data: data from frontend to be parsed + :param loads: + :return: + """ + result = {} + for key, value in parse_qsl(init_data): + if (value.startswith("[") and value.endswith("]")) or ( + value.startswith("{") and value.endswith("}") + ): + value = loads(value) + result[key] = value + return WebAppInitData(**result) + + +def safe_parse_webapp_init_data( + token: str, + init_data: str, + *, + loads: Callable[..., Any] = json.loads, +) -> WebAppInitData: + """ + Validate raw WebApp init data and return it as WebAppInitData object + + Raise :obj:`ValueError` when data is invalid + + :param token: bot token + :param init_data: data from frontend to be parsed and validated + :param loads: + :return: + """ + if check_webapp_signature(token, init_data): + return parse_webapp_init_data(init_data, loads=loads) + raise ValueError("Invalid init data signature") diff --git a/env/Lib/site-packages/aiogram/webhook/__init__.py b/env/Lib/site-packages/aiogram/webhook/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/aiogram/webhook/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiogram/webhook/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dccb9cef95cbe09071583172d9e618d2de87d24a GIT binary patch literal 185 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiogram/webhook/aiohttp_server.py b/env/Lib/site-packages/aiogram/webhook/aiohttp_server.py new file mode 100644 index 0000000..7caa0e1 --- /dev/null +++ b/env/Lib/site-packages/aiogram/webhook/aiohttp_server.py @@ -0,0 +1,295 @@ +import asyncio +import secrets +from abc import ABC, abstractmethod +from asyncio import Transport +from typing import Any, Awaitable, Callable, Dict, Optional, Set, Tuple, cast + +from aiohttp import MultipartWriter, web +from aiohttp.abc import Application +from aiohttp.typedefs import Handler +from aiohttp.web_middlewares import middleware + +from aiogram import Bot, Dispatcher, loggers +from aiogram.methods import TelegramMethod +from aiogram.methods.base import TelegramType +from aiogram.types import InputFile +from aiogram.webhook.security import IPFilter + + +def setup_application(app: Application, dispatcher: Dispatcher, /, **kwargs: Any) -> None: + """ + This function helps to configure a startup-shutdown process + + :param app: aiohttp application + :param dispatcher: aiogram dispatcher + :param kwargs: additional data + :return: + """ + workflow_data = { + "app": app, + "dispatcher": dispatcher, + **dispatcher.workflow_data, + **kwargs, + } + + async def on_startup(*a: Any, **kw: Any) -> None: # pragma: no cover + await dispatcher.emit_startup(**workflow_data) + + async def on_shutdown(*a: Any, **kw: Any) -> None: # pragma: no cover + await dispatcher.emit_shutdown(**workflow_data) + + app.on_startup.append(on_startup) + app.on_shutdown.append(on_shutdown) + + +def check_ip(ip_filter: IPFilter, request: web.Request) -> Tuple[str, bool]: + # Try to resolve client IP over reverse proxy + if forwarded_for := request.headers.get("X-Forwarded-For", ""): + # Get the left-most ip when there is multiple ips + # (request got through multiple proxy/load balancers) + # https://github.com/aiogram/aiogram/issues/672 + forwarded_for, *_ = forwarded_for.split(",", maxsplit=1) + return forwarded_for, forwarded_for in ip_filter + + # When reverse proxy is not configured IP address can be resolved from incoming connection + if peer_name := cast(Transport, request.transport).get_extra_info("peername"): + host, _ = peer_name + return host, host in ip_filter + + # Potentially impossible case + return "", False # pragma: no cover + + +def ip_filter_middleware( + ip_filter: IPFilter, +) -> Callable[[web.Request, Handler], Awaitable[Any]]: + """ + + :param ip_filter: + :return: + """ + + @middleware + async def _ip_filter_middleware(request: web.Request, handler: Handler) -> Any: + ip_address, accept = check_ip(ip_filter=ip_filter, request=request) + if not accept: + loggers.webhook.warning("Blocking request from an unauthorized IP: %s", ip_address) + raise web.HTTPUnauthorized() + return await handler(request) + + return _ip_filter_middleware + + +class BaseRequestHandler(ABC): + def __init__( + self, + dispatcher: Dispatcher, + handle_in_background: bool = False, + **data: Any, + ) -> None: + """ + Base handler that helps to handle incoming request from aiohttp + and propagate it to the Dispatcher + + :param dispatcher: instance of :class:`aiogram.dispatcher.dispatcher.Dispatcher` + :param handle_in_background: immediately responds to the Telegram instead of + a waiting end of a handler process + """ + self.dispatcher = dispatcher + self.handle_in_background = handle_in_background + self.data = data + self._background_feed_update_tasks: Set[asyncio.Task[Any]] = set() + + def register(self, app: Application, /, path: str, **kwargs: Any) -> None: + """ + Register route and shutdown callback + + :param app: instance of aiohttp Application + :param path: route path + :param kwargs: + """ + app.on_shutdown.append(self._handle_close) + app.router.add_route("POST", path, self.handle, **kwargs) + + async def _handle_close(self, app: Application) -> None: + await self.close() + + @abstractmethod + async def close(self) -> None: + pass + + @abstractmethod + async def resolve_bot(self, request: web.Request) -> Bot: + """ + This method should be implemented in subclasses of this class. + + Resolve Bot instance from request. + + :param request: + :return: Bot instance + """ + pass + + @abstractmethod + def verify_secret(self, telegram_secret_token: str, bot: Bot) -> bool: + pass + + async def _background_feed_update(self, bot: Bot, update: Dict[str, Any]) -> None: + result = await self.dispatcher.feed_raw_update(bot=bot, update=update, **self.data) + if isinstance(result, TelegramMethod): + await self.dispatcher.silent_call_request(bot=bot, result=result) + + async def _handle_request_background(self, bot: Bot, request: web.Request) -> web.Response: + feed_update_task = asyncio.create_task( + self._background_feed_update( + bot=bot, update=await request.json(loads=bot.session.json_loads) + ) + ) + self._background_feed_update_tasks.add(feed_update_task) + feed_update_task.add_done_callback(self._background_feed_update_tasks.discard) + return web.json_response({}, dumps=bot.session.json_dumps) + + def _build_response_writer( + self, bot: Bot, result: Optional[TelegramMethod[TelegramType]] + ) -> MultipartWriter: + writer = MultipartWriter( + "form-data", + boundary=f"webhookBoundary{secrets.token_urlsafe(16)}", + ) + if not result: + return writer + + payload = writer.append(result.__api_method__) + payload.set_content_disposition("form-data", name="method") + + files: Dict[str, InputFile] = {} + for key, value in result.model_dump(warnings=False).items(): + value = bot.session.prepare_value(value, bot=bot, files=files) + if not value: + continue + payload = writer.append(value) + payload.set_content_disposition("form-data", name=key) + + for key, value in files.items(): + payload = writer.append(value.read(bot)) + payload.set_content_disposition( + "form-data", + name=key, + filename=value.filename or key, + ) + + return writer + + async def _handle_request(self, bot: Bot, request: web.Request) -> web.Response: + result: Optional[TelegramMethod[Any]] = await self.dispatcher.feed_webhook_update( + bot, + await request.json(loads=bot.session.json_loads), + **self.data, + ) + return web.Response(body=self._build_response_writer(bot=bot, result=result)) + + async def handle(self, request: web.Request) -> web.Response: + bot = await self.resolve_bot(request) + if not self.verify_secret(request.headers.get("X-Telegram-Bot-Api-Secret-Token", ""), bot): + return web.Response(body="Unauthorized", status=401) + if self.handle_in_background: + return await self._handle_request_background(bot=bot, request=request) + return await self._handle_request(bot=bot, request=request) + + __call__ = handle + + +class SimpleRequestHandler(BaseRequestHandler): + def __init__( + self, + dispatcher: Dispatcher, + bot: Bot, + handle_in_background: bool = True, + secret_token: Optional[str] = None, + **data: Any, + ) -> None: + """ + Handler for single Bot instance + + :param dispatcher: instance of :class:`aiogram.dispatcher.dispatcher.Dispatcher` + :param handle_in_background: immediately responds to the Telegram instead of + a waiting end of handler process + :param bot: instance of :class:`aiogram.client.bot.Bot` + """ + super().__init__(dispatcher=dispatcher, handle_in_background=handle_in_background, **data) + self.bot = bot + self.secret_token = secret_token + + def verify_secret(self, telegram_secret_token: str, bot: Bot) -> bool: + if self.secret_token: + return secrets.compare_digest(telegram_secret_token, self.secret_token) + return True + + async def close(self) -> None: + """ + Close bot session + """ + await self.bot.session.close() + + async def resolve_bot(self, request: web.Request) -> Bot: + return self.bot + + +class TokenBasedRequestHandler(BaseRequestHandler): + def __init__( + self, + dispatcher: Dispatcher, + handle_in_background: bool = True, + bot_settings: Optional[Dict[str, Any]] = None, + **data: Any, + ) -> None: + """ + Handler that supports multiple bots the context will be resolved + from path variable 'bot_token' + + .. note:: + + This handler is not recommended in due to token is available in URL + and can be logged by reverse proxy server or other middleware. + + :param dispatcher: instance of :class:`aiogram.dispatcher.dispatcher.Dispatcher` + :param handle_in_background: immediately responds to the Telegram instead of + a waiting end of handler process + :param bot_settings: kwargs that will be passed to new Bot instance + """ + super().__init__(dispatcher=dispatcher, handle_in_background=handle_in_background, **data) + if bot_settings is None: + bot_settings = {} + self.bot_settings = bot_settings + self.bots: Dict[str, Bot] = {} + + def verify_secret(self, telegram_secret_token: str, bot: Bot) -> bool: + return True + + async def close(self) -> None: + for bot in self.bots.values(): + await bot.session.close() + + def register(self, app: Application, /, path: str, **kwargs: Any) -> None: + """ + Validate path, register route and shutdown callback + + :param app: instance of aiohttp Application + :param path: route path + :param kwargs: + """ + if "{bot_token}" not in path: + raise ValueError("Path should contains '{bot_token}' substring") + super().register(app, path=path, **kwargs) + + async def resolve_bot(self, request: web.Request) -> Bot: + """ + Get bot token from a path and create or get from cache Bot instance + + :param request: + :return: + """ + token = request.match_info["bot_token"] + if token not in self.bots: + self.bots[token] = Bot(token=token, **self.bot_settings) + return self.bots[token] diff --git a/env/Lib/site-packages/aiogram/webhook/security.py b/env/Lib/site-packages/aiogram/webhook/security.py new file mode 100644 index 0000000..91d3820 --- /dev/null +++ b/env/Lib/site-packages/aiogram/webhook/security.py @@ -0,0 +1,41 @@ +from ipaddress import IPv4Address, IPv4Network +from typing import Optional, Sequence, Set, Union + +DEFAULT_TELEGRAM_NETWORKS = [ + IPv4Network("149.154.160.0/20"), + IPv4Network("91.108.4.0/22"), +] + + +class IPFilter: + def __init__(self, ips: Optional[Sequence[Union[str, IPv4Network, IPv4Address]]] = None): + self._allowed_ips: Set[IPv4Address] = set() + + if ips: + self.allow(*ips) + + def allow(self, *ips: Union[str, IPv4Network, IPv4Address]) -> None: + for ip in ips: + self.allow_ip(ip) + + def allow_ip(self, ip: Union[str, IPv4Network, IPv4Address]) -> None: + if isinstance(ip, str): + ip = IPv4Network(ip) if "/" in ip else IPv4Address(ip) + if isinstance(ip, IPv4Address): + self._allowed_ips.add(ip) + elif isinstance(ip, IPv4Network): + self._allowed_ips.update(ip.hosts()) + else: + raise ValueError(f"Invalid type of ipaddress: {type(ip)} ('{ip}')") + + @classmethod + def default(cls) -> "IPFilter": + return cls(DEFAULT_TELEGRAM_NETWORKS) + + def check(self, ip: Union[str, IPv4Address]) -> bool: + if not isinstance(ip, IPv4Address): + ip = IPv4Address(ip) + return ip in self._allowed_ips + + def __contains__(self, item: Union[str, IPv4Address]) -> bool: + return self.check(item) diff --git a/env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/INSTALLER b/env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/LICENSE b/env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/LICENSE new file mode 100644 index 0000000..f26bcf4 --- /dev/null +++ b/env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/LICENSE @@ -0,0 +1,279 @@ +A. HISTORY OF THE SOFTWARE +========================== + +Python was created in the early 1990s by Guido van Rossum at Stichting +Mathematisch Centrum (CWI, see https://www.cwi.nl) in the Netherlands +as a successor of a language called ABC. Guido remains Python's +principal author, although it includes many contributions from others. + +In 1995, Guido continued his work on Python at the Corporation for +National Research Initiatives (CNRI, see https://www.cnri.reston.va.us) +in Reston, Virginia where he released several versions of the +software. + +In May 2000, Guido and the Python core development team moved to +BeOpen.com to form the BeOpen PythonLabs team. In October of the same +year, the PythonLabs team moved to Digital Creations, which became +Zope Corporation. In 2001, the Python Software Foundation (PSF, see +https://www.python.org/psf/) was formed, a non-profit organization +created specifically to own Python-related Intellectual Property. +Zope Corporation was a sponsoring member of the PSF. + +All Python releases are Open Source (see https://opensource.org for +the Open Source Definition). Historically, most, but not all, Python +releases have also been GPL-compatible; the table below summarizes +the various releases. + + Release Derived Year Owner GPL- + from compatible? (1) + + 0.9.0 thru 1.2 1991-1995 CWI yes + 1.3 thru 1.5.2 1.2 1995-1999 CNRI yes + 1.6 1.5.2 2000 CNRI no + 2.0 1.6 2000 BeOpen.com no + 1.6.1 1.6 2001 CNRI yes (2) + 2.1 2.0+1.6.1 2001 PSF no + 2.0.1 2.0+1.6.1 2001 PSF yes + 2.1.1 2.1+2.0.1 2001 PSF yes + 2.1.2 2.1.1 2002 PSF yes + 2.1.3 2.1.2 2002 PSF yes + 2.2 and above 2.1.1 2001-now PSF yes + +Footnotes: + +(1) GPL-compatible doesn't mean that we're distributing Python under + the GPL. All Python licenses, unlike the GPL, let you distribute + a modified version without making your changes open source. The + GPL-compatible licenses make it possible to combine Python with + other software that is released under the GPL; the others don't. + +(2) According to Richard Stallman, 1.6.1 is not GPL-compatible, + because its license has a choice of law clause. According to + CNRI, however, Stallman's lawyer has told CNRI's lawyer that 1.6.1 + is "not incompatible" with the GPL. + +Thanks to the many outside volunteers who have worked under Guido's +direction to make these releases possible. + + +B. TERMS AND CONDITIONS FOR ACCESSING OR OTHERWISE USING PYTHON +=============================================================== + +Python software and documentation are licensed under the +Python Software Foundation License Version 2. + +Starting with Python 3.8.6, examples, recipes, and other code in +the documentation are dual licensed under the PSF License Version 2 +and the Zero-Clause BSD license. + +Some software incorporated into Python is under different licenses. +The licenses are listed with code falling under that license. + + +PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2 +-------------------------------------------- + +1. This LICENSE AGREEMENT is between the Python Software Foundation +("PSF"), and the Individual or Organization ("Licensee") accessing and +otherwise using this software ("Python") in source or binary form and +its associated documentation. + +2. Subject to the terms and conditions of this License Agreement, PSF hereby +grants Licensee a nonexclusive, royalty-free, world-wide license to reproduce, +analyze, test, perform and/or display publicly, prepare derivative works, +distribute, and otherwise use Python alone or in any derivative version, +provided, however, that PSF's License Agreement and PSF's notice of copyright, +i.e., "Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, +2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023 Python Software Foundation; +All Rights Reserved" are retained in Python alone or in any derivative version +prepared by Licensee. + +3. In the event Licensee prepares a derivative work that is based on +or incorporates Python or any part thereof, and wants to make +the derivative work available to others as provided herein, then +Licensee hereby agrees to include in any such work a brief summary of +the changes made to Python. + +4. PSF is making Python available to Licensee on an "AS IS" +basis. PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR +IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND +DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS +FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT +INFRINGE ANY THIRD PARTY RIGHTS. + +5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON +FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS +A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON, +OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. + +6. This License Agreement will automatically terminate upon a material +breach of its terms and conditions. + +7. Nothing in this License Agreement shall be deemed to create any +relationship of agency, partnership, or joint venture between PSF and +Licensee. This License Agreement does not grant permission to use PSF +trademarks or trade name in a trademark sense to endorse or promote +products or services of Licensee, or any third party. + +8. By copying, installing or otherwise using Python, Licensee +agrees to be bound by the terms and conditions of this License +Agreement. + + +BEOPEN.COM LICENSE AGREEMENT FOR PYTHON 2.0 +------------------------------------------- + +BEOPEN PYTHON OPEN SOURCE LICENSE AGREEMENT VERSION 1 + +1. This LICENSE AGREEMENT is between BeOpen.com ("BeOpen"), having an +office at 160 Saratoga Avenue, Santa Clara, CA 95051, and the +Individual or Organization ("Licensee") accessing and otherwise using +this software in source or binary form and its associated +documentation ("the Software"). + +2. Subject to the terms and conditions of this BeOpen Python License +Agreement, BeOpen hereby grants Licensee a non-exclusive, +royalty-free, world-wide license to reproduce, analyze, test, perform +and/or display publicly, prepare derivative works, distribute, and +otherwise use the Software alone or in any derivative version, +provided, however, that the BeOpen Python License is retained in the +Software, alone or in any derivative version prepared by Licensee. + +3. BeOpen is making the Software available to Licensee on an "AS IS" +basis. BEOPEN MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR +IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, BEOPEN MAKES NO AND +DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS +FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE WILL NOT +INFRINGE ANY THIRD PARTY RIGHTS. + +4. BEOPEN SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF THE +SOFTWARE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS +AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THE SOFTWARE, OR ANY +DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. + +5. This License Agreement will automatically terminate upon a material +breach of its terms and conditions. + +6. This License Agreement shall be governed by and interpreted in all +respects by the law of the State of California, excluding conflict of +law provisions. Nothing in this License Agreement shall be deemed to +create any relationship of agency, partnership, or joint venture +between BeOpen and Licensee. This License Agreement does not grant +permission to use BeOpen trademarks or trade names in a trademark +sense to endorse or promote products or services of Licensee, or any +third party. As an exception, the "BeOpen Python" logos available at +http://www.pythonlabs.com/logos.html may be used according to the +permissions granted on that web page. + +7. By copying, installing or otherwise using the software, Licensee +agrees to be bound by the terms and conditions of this License +Agreement. + + +CNRI LICENSE AGREEMENT FOR PYTHON 1.6.1 +--------------------------------------- + +1. This LICENSE AGREEMENT is between the Corporation for National +Research Initiatives, having an office at 1895 Preston White Drive, +Reston, VA 20191 ("CNRI"), and the Individual or Organization +("Licensee") accessing and otherwise using Python 1.6.1 software in +source or binary form and its associated documentation. + +2. Subject to the terms and conditions of this License Agreement, CNRI +hereby grants Licensee a nonexclusive, royalty-free, world-wide +license to reproduce, analyze, test, perform and/or display publicly, +prepare derivative works, distribute, and otherwise use Python 1.6.1 +alone or in any derivative version, provided, however, that CNRI's +License Agreement and CNRI's notice of copyright, i.e., "Copyright (c) +1995-2001 Corporation for National Research Initiatives; All Rights +Reserved" are retained in Python 1.6.1 alone or in any derivative +version prepared by Licensee. Alternately, in lieu of CNRI's License +Agreement, Licensee may substitute the following text (omitting the +quotes): "Python 1.6.1 is made available subject to the terms and +conditions in CNRI's License Agreement. This Agreement together with +Python 1.6.1 may be located on the internet using the following +unique, persistent identifier (known as a handle): 1895.22/1013. This +Agreement may also be obtained from a proxy server on the internet +using the following URL: http://hdl.handle.net/1895.22/1013". + +3. In the event Licensee prepares a derivative work that is based on +or incorporates Python 1.6.1 or any part thereof, and wants to make +the derivative work available to others as provided herein, then +Licensee hereby agrees to include in any such work a brief summary of +the changes made to Python 1.6.1. + +4. CNRI is making Python 1.6.1 available to Licensee on an "AS IS" +basis. CNRI MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR +IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, CNRI MAKES NO AND +DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS +FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 1.6.1 WILL NOT +INFRINGE ANY THIRD PARTY RIGHTS. + +5. CNRI SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON +1.6.1 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS +A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 1.6.1, +OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. + +6. This License Agreement will automatically terminate upon a material +breach of its terms and conditions. + +7. This License Agreement shall be governed by the federal +intellectual property law of the United States, including without +limitation the federal copyright law, and, to the extent such +U.S. federal law does not apply, by the law of the Commonwealth of +Virginia, excluding Virginia's conflict of law provisions. +Notwithstanding the foregoing, with regard to derivative works based +on Python 1.6.1 that incorporate non-separable material that was +previously distributed under the GNU General Public License (GPL), the +law of the Commonwealth of Virginia shall govern this License +Agreement only as to issues arising under or with respect to +Paragraphs 4, 5, and 7 of this License Agreement. Nothing in this +License Agreement shall be deemed to create any relationship of +agency, partnership, or joint venture between CNRI and Licensee. This +License Agreement does not grant permission to use CNRI trademarks or +trade name in a trademark sense to endorse or promote products or +services of Licensee, or any third party. + +8. By clicking on the "ACCEPT" button where indicated, or by copying, +installing or otherwise using Python 1.6.1, Licensee agrees to be +bound by the terms and conditions of this License Agreement. + + ACCEPT + + +CWI LICENSE AGREEMENT FOR PYTHON 0.9.0 THROUGH 1.2 +-------------------------------------------------- + +Copyright (c) 1991 - 1995, Stichting Mathematisch Centrum Amsterdam, +The Netherlands. All rights reserved. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation, and that the name of Stichting Mathematisch +Centrum or CWI not be used in advertising or publicity pertaining to +distribution of the software without specific, written prior +permission. + +STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO +THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND +FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE +FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN +ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT +OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + +ZERO-CLAUSE BSD LICENSE FOR CODE IN THE PYTHON DOCUMENTATION +---------------------------------------------------------------------- + +Permission to use, copy, modify, and/or distribute this software for any +purpose with or without fee is hereby granted. + +THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH +REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY +AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, +INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM +LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR +OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR +PERFORMANCE OF THIS SOFTWARE. diff --git a/env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/METADATA b/env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/METADATA new file mode 100644 index 0000000..f4ba195 --- /dev/null +++ b/env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/METADATA @@ -0,0 +1,122 @@ +Metadata-Version: 2.1 +Name: aiohappyeyeballs +Version: 2.4.0 +Summary: Happy Eyeballs for asyncio +Home-page: https://github.com/aio-libs/aiohappyeyeballs +License: Python-2.0.1 +Author: J. Nick Koston +Author-email: nick@koston.org +Requires-Python: >=3.8 +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: Python Software Foundation License +Classifier: License :: Other/Proprietary License +Classifier: Natural Language :: English +Classifier: Operating System :: OS Independent +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3.13 +Classifier: Topic :: Software Development :: Libraries +Project-URL: Bug Tracker, https://github.com/aio-libs/aiohappyeyeballs/issues +Project-URL: Changelog, https://github.com/aio-libs/aiohappyeyeballs/blob/main/CHANGELOG.md +Project-URL: Documentation, https://aiohappyeyeballs.readthedocs.io +Project-URL: Repository, https://github.com/aio-libs/aiohappyeyeballs +Description-Content-Type: text/markdown + +# aiohappyeyeballs + +

      + + CI Status + + + Documentation Status + + + Test coverage percentage + +

      +

      + + Poetry + + + black + + + pre-commit + +

      +

      + + PyPI Version + + Supported Python versions + License +

      + +--- + +**Documentation**: https://aiohappyeyeballs.readthedocs.io + +**Source Code**: https://github.com/aio-libs/aiohappyeyeballs + +--- + +[Happy Eyeballs](https://en.wikipedia.org/wiki/Happy_Eyeballs) +([RFC 8305](https://www.rfc-editor.org/rfc/rfc8305.html)) + +## Use case + +This library exists to allow connecting with +[Happy Eyeballs](https://en.wikipedia.org/wiki/Happy_Eyeballs) +([RFC 8305](https://www.rfc-editor.org/rfc/rfc8305.html)) +when you +already have a list of addrinfo and not a DNS name. + +The stdlib version of `loop.create_connection()` +will only work when you pass in an unresolved name which +is not a good fit when using DNS caching or resolving +names via another method such as `zeroconf`. + +## Installation + +Install this via pip (or your favourite package manager): + +`pip install aiohappyeyeballs` + +## Example usage + +```python + +addr_infos = await loop.getaddrinfo("example.org", 80) + +socket = await start_connection(addr_infos) +socket = await start_connection(addr_infos, local_addr_infos=local_addr_infos, happy_eyeballs_delay=0.2) + +transport, protocol = await loop.create_connection( + MyProtocol, sock=socket, ...) + +# Remove the first address for each family from addr_info +pop_addr_infos_interleave(addr_info, 1) + +# Remove all matching address from addr_info +remove_addr_infos(addr_info, "dead::beef::") + +# Convert a local_addr to local_addr_infos +local_addr_infos = addr_to_addr_infos(("127.0.0.1",0)) +``` + +## Credits + +This package contains code from cpython and is licensed under the same terms as cpython itself. + +This package was created with +[Copier](https://copier.readthedocs.io/) and the +[browniebroke/pypackage-template](https://github.com/browniebroke/pypackage-template) +project template. + diff --git a/env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/RECORD b/env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/RECORD new file mode 100644 index 0000000..f5db522 --- /dev/null +++ b/env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/RECORD @@ -0,0 +1,14 @@ +aiohappyeyeballs-2.4.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +aiohappyeyeballs-2.4.0.dist-info/LICENSE,sha256=Oy-B_iHRgcSZxZolbI4ZaEVdZonSaaqFNzv7avQdo78,13936 +aiohappyeyeballs-2.4.0.dist-info/METADATA,sha256=kBvy0zd3Thv-cT_rqGcgRCxvVqzXGRh8ghTC3zZfiLY,5901 +aiohappyeyeballs-2.4.0.dist-info/RECORD,, +aiohappyeyeballs-2.4.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88 +aiohappyeyeballs/__init__.py,sha256=OF-GJ4MGsl3QqO_2efe6UL11FAxRmzTDyDiwE6hgGc0,317 +aiohappyeyeballs/__pycache__/__init__.cpython-311.pyc,, +aiohappyeyeballs/__pycache__/impl.cpython-311.pyc,, +aiohappyeyeballs/__pycache__/types.cpython-311.pyc,, +aiohappyeyeballs/__pycache__/utils.cpython-311.pyc,, +aiohappyeyeballs/impl.py,sha256=dcYq05g3lGkkoxxd1KFnyXj4FKUaLfeplnJ93dLnoQQ,7289 +aiohappyeyeballs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +aiohappyeyeballs/types.py,sha256=iYPiBTl5J7YEjnIqEOVUTRPzz2DwqSHBRhvbAlM0zv0,234 +aiohappyeyeballs/utils.py,sha256=W_Oaf1iP8wYRHo6B95eYx-ZxbjpxyWwYgTdkhWqGF5c,3026 diff --git a/env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/WHEEL b/env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/WHEEL new file mode 100644 index 0000000..d73ccaa --- /dev/null +++ b/env/Lib/site-packages/aiohappyeyeballs-2.4.0.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: poetry-core 1.9.0 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/env/Lib/site-packages/aiohappyeyeballs/__init__.py b/env/Lib/site-packages/aiohappyeyeballs/__init__.py new file mode 100644 index 0000000..9c98be9 --- /dev/null +++ b/env/Lib/site-packages/aiohappyeyeballs/__init__.py @@ -0,0 +1,13 @@ +__version__ = "2.4.0" + +from .impl import start_connection +from .types import AddrInfoType +from .utils import addr_to_addr_infos, pop_addr_infos_interleave, remove_addr_infos + +__all__ = ( + "start_connection", + "AddrInfoType", + "remove_addr_infos", + "pop_addr_infos_interleave", + "addr_to_addr_infos", +) diff --git a/env/Lib/site-packages/aiohappyeyeballs/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiohappyeyeballs/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1d121b15ce38112148abf5e7fe8d8de875308b67 GIT binary patch literal 517 zcmZ`#ze@u#6wdvwR;3CKPJ-JFRuLyrL39z+r9$C22x%{BXzp?(>A^Ymzi{vm5dQ%G z3x|#+li=i5=+?=1r-BY9k1yZ%Uf%aeo|cyv5v-TT*P9~?q4!GsEc=_x4uCwM1Vt#Z z5}RA89obgJ9qy!V1$Jn?m&3S#@cpB!by32S&&A6&tzM3l=6JSg@$M_k| zK%)8O*+JYDauA=2gk`t!U?_2^-~19D4MOqjSMd0x_z_P|Q* zV0a4C7`O9s-Z)G}GUW7Fw!ppmG1Uc_I+kTkR@O(&H?%eW8xyoS{u>k28UG(s*KgXR KpxSZ;ygva=$Ccm! literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohappyeyeballs/__pycache__/impl.cpython-311.pyc b/env/Lib/site-packages/aiohappyeyeballs/__pycache__/impl.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0f55603d33c04d3ca89132c015632b273877104c GIT binary patch literal 8927 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ätAhi+8)Dmj8LQw`~04;=_wD z4n@m9{c_YAb$j2ay!CM2y3ynuI#L;X_`tg9cJ-9y%FXJ$-8o`0&m)H(4p^MUZDY1& z);Y&4&J9O@dC!Rr{jt}P-hVv(q{kMn+o2mabK?cLi@ad-OT1tvZzx(;NiHd=z5D~E zy()5H@Cap4i8d*yB)UY+<0?TD=qD2;#$?*6h&5T0UZONs_Cb!bmtijcZ)U$qEdmdc zC}#Sqq_>}#OnaSCWQ9-ZPg|;2rdPrUrFzo)o1Iv2iIIXj4?rC zR-7QtnLBEsCEe4SniGu$Suwh zqJIe}-0KKpwWpf=&7n;}asC~$(1FyR0_LI4gl z0f&?LC~XZ6ls=gUrB7F3(!pl>+5u!lk#po)L#K)EjWd1 zivU@05m+u{QgBIICh$_fU+qfOG_iw^_mO$UC@6}S2Uz=#R7ahi|3I5u;dj$kTsbV} zRRb=7#k>q)*n)5pqhX-XPGf>|(F@+g_OEH0sx|P5+y^@6k}^qSxC)SySHjxi2A43s zU@mE-7V2vI@hVcsH6q+y;yf&I9bTP1 zBdy^K^;l3)bS;4UKHbnfADjy0jzrD`e9_wjGcvfan<8ZIHM}3cN5lsLTrc^{IaMxZ zl`Gm65Me~qp92N3rYIK;+h}+jb=i%_Md4NQbJ2PG+dbQ8z;1tP++pe_=XV-Yd zby#xwveO|t?D1NFFwp_}9vY*rQ8izTg3}2IzSYe-T_*^~J@?+@=r>`~-(~|fwxLB- z>*O3qU2ub)WwxBEyj@;+*jbHL_4VibmFNj%#A7S>s; RSmO{Etocb7y^50U|1Vxa^n3sS literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohappyeyeballs/impl.py b/env/Lib/site-packages/aiohappyeyeballs/impl.py new file mode 100644 index 0000000..64aff8c --- /dev/null +++ b/env/Lib/site-packages/aiohappyeyeballs/impl.py @@ -0,0 +1,205 @@ +"""Base implementation.""" + +import asyncio +import collections +import functools +import itertools +import socket +import sys +from asyncio import staggered +from typing import List, Optional, Sequence + +from .types import AddrInfoType + +if sys.version_info < (3, 8, 2): # noqa: UP036 + # asyncio.staggered is broken in Python 3.8.0 and 3.8.1 + # so it must be patched: + # https://github.com/aio-libs/aiohttp/issues/8556 + # https://bugs.python.org/issue39129 + # https://github.com/python/cpython/pull/17693 + import asyncio.futures + + asyncio.futures.TimeoutError = asyncio.TimeoutError # type: ignore[attr-defined] + + +async def start_connection( + addr_infos: Sequence[AddrInfoType], + *, + local_addr_infos: Optional[Sequence[AddrInfoType]] = None, + happy_eyeballs_delay: Optional[float] = None, + interleave: Optional[int] = None, + loop: Optional[asyncio.AbstractEventLoop] = None, +) -> socket.socket: + """ + Connect to a TCP server. + + Create a socket connection to a specified destination. The + destination is specified as a list of AddrInfoType tuples as + returned from getaddrinfo(). + + The arguments are, in order: + + * ``family``: the address family, e.g. ``socket.AF_INET`` or + ``socket.AF_INET6``. + * ``type``: the socket type, e.g. ``socket.SOCK_STREAM`` or + ``socket.SOCK_DGRAM``. + * ``proto``: the protocol, e.g. ``socket.IPPROTO_TCP`` or + ``socket.IPPROTO_UDP``. + * ``canonname``: the canonical name of the address, e.g. + ``"www.python.org"``. + * ``sockaddr``: the socket address + + This method is a coroutine which will try to establish the connection + in the background. When successful, the coroutine returns a + socket. + + The expected use case is to use this method in conjunction with + loop.create_connection() to establish a connection to a server:: + + socket = await start_connection(addr_infos) + transport, protocol = await loop.create_connection( + MyProtocol, sock=socket, ...) + """ + if not (current_loop := loop): + current_loop = asyncio.get_running_loop() + + single_addr_info = len(addr_infos) == 1 + + if happy_eyeballs_delay is not None and interleave is None: + # If using happy eyeballs, default to interleave addresses by family + interleave = 1 + + if interleave and not single_addr_info: + addr_infos = _interleave_addrinfos(addr_infos, interleave) + + sock: Optional[socket.socket] = None + exceptions: List[List[OSError]] = [] + if happy_eyeballs_delay is None or single_addr_info: + # not using happy eyeballs + for addrinfo in addr_infos: + try: + sock = await _connect_sock( + current_loop, exceptions, addrinfo, local_addr_infos + ) + break + except OSError: + continue + else: # using happy eyeballs + sock, _, _ = await staggered.staggered_race( + ( + functools.partial( + _connect_sock, current_loop, exceptions, addrinfo, local_addr_infos + ) + for addrinfo in addr_infos + ), + happy_eyeballs_delay, + loop=current_loop, + ) + + if sock is None: + all_exceptions = [exc for sub in exceptions for exc in sub] + try: + first_exception = all_exceptions[0] + if len(all_exceptions) == 1: + raise first_exception + else: + # If they all have the same str(), raise one. + model = str(first_exception) + if all(str(exc) == model for exc in all_exceptions): + raise first_exception + # Raise a combined exception so the user can see all + # the various error messages. + msg = "Multiple exceptions: {}".format( + ", ".join(str(exc) for exc in all_exceptions) + ) + # If the errno is the same for all exceptions, raise + # an OSError with that errno. + first_errno = first_exception.errno + if all( + isinstance(exc, OSError) and exc.errno == first_errno + for exc in all_exceptions + ): + raise OSError(first_errno, msg) + raise OSError(msg) + finally: + all_exceptions = None # type: ignore[assignment] + exceptions = None # type: ignore[assignment] + + return sock + + +async def _connect_sock( + loop: asyncio.AbstractEventLoop, + exceptions: List[List[OSError]], + addr_info: AddrInfoType, + local_addr_infos: Optional[Sequence[AddrInfoType]] = None, +) -> socket.socket: + """Create, bind and connect one socket.""" + my_exceptions: list[OSError] = [] + exceptions.append(my_exceptions) + family, type_, proto, _, address = addr_info + sock = None + try: + sock = socket.socket(family=family, type=type_, proto=proto) + sock.setblocking(False) + if local_addr_infos is not None: + for lfamily, _, _, _, laddr in local_addr_infos: + # skip local addresses of different family + if lfamily != family: + continue + try: + sock.bind(laddr) + break + except OSError as exc: + msg = ( + f"error while attempting to bind on " + f"address {laddr!r}: " + f"{exc.strerror.lower()}" + ) + exc = OSError(exc.errno, msg) + my_exceptions.append(exc) + else: # all bind attempts failed + if my_exceptions: + raise my_exceptions.pop() + else: + raise OSError(f"no matching local address with {family=} found") + await loop.sock_connect(sock, address) + return sock + except OSError as exc: + my_exceptions.append(exc) + if sock is not None: + sock.close() + raise + except: + if sock is not None: + sock.close() + raise + finally: + exceptions = my_exceptions = None # type: ignore[assignment] + + +def _interleave_addrinfos( + addrinfos: Sequence[AddrInfoType], first_address_family_count: int = 1 +) -> List[AddrInfoType]: + """Interleave list of addrinfo tuples by family.""" + # Group addresses by family + addrinfos_by_family: collections.OrderedDict[int, List[AddrInfoType]] = ( + collections.OrderedDict() + ) + for addr in addrinfos: + family = addr[0] + if family not in addrinfos_by_family: + addrinfos_by_family[family] = [] + addrinfos_by_family[family].append(addr) + addrinfos_lists = list(addrinfos_by_family.values()) + + reordered: List[AddrInfoType] = [] + if first_address_family_count > 1: + reordered.extend(addrinfos_lists[0][: first_address_family_count - 1]) + del addrinfos_lists[0][: first_address_family_count - 1] + reordered.extend( + a + for a in itertools.chain.from_iterable(itertools.zip_longest(*addrinfos_lists)) + if a is not None + ) + return reordered diff --git a/env/Lib/site-packages/aiohappyeyeballs/py.typed b/env/Lib/site-packages/aiohappyeyeballs/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/aiohappyeyeballs/types.py b/env/Lib/site-packages/aiohappyeyeballs/types.py new file mode 100644 index 0000000..01d79a2 --- /dev/null +++ b/env/Lib/site-packages/aiohappyeyeballs/types.py @@ -0,0 +1,12 @@ +"""Types for aiohappyeyeballs.""" + +import socket +from typing import Tuple, Union + +AddrInfoType = Tuple[ + Union[int, socket.AddressFamily], + Union[int, socket.SocketKind], + int, + str, + Tuple, # type: ignore[type-arg] +] diff --git a/env/Lib/site-packages/aiohappyeyeballs/utils.py b/env/Lib/site-packages/aiohappyeyeballs/utils.py new file mode 100644 index 0000000..b5745ae --- /dev/null +++ b/env/Lib/site-packages/aiohappyeyeballs/utils.py @@ -0,0 +1,97 @@ +"""Utility functions for aiohappyeyeballs.""" + +import ipaddress +import socket +from typing import Dict, List, Optional, Tuple, Union + +from .types import AddrInfoType + + +def addr_to_addr_infos( + addr: Optional[ + Union[Tuple[str, int, int, int], Tuple[str, int, int], Tuple[str, int]] + ] +) -> Optional[List[AddrInfoType]]: + """Convert an address tuple to a list of addr_info tuples.""" + if addr is None: + return None + host = addr[0] + port = addr[1] + is_ipv6 = ":" in host + if is_ipv6: + flowinfo = 0 + scopeid = 0 + addr_len = len(addr) + if addr_len >= 4: + scopeid = addr[3] # type: ignore[misc] + if addr_len >= 3: + flowinfo = addr[2] # type: ignore[misc] + addr = (host, port, flowinfo, scopeid) + family = socket.AF_INET6 + else: + addr = (host, port) + family = socket.AF_INET + return [(family, socket.SOCK_STREAM, socket.IPPROTO_TCP, "", addr)] + + +def pop_addr_infos_interleave( + addr_infos: List[AddrInfoType], interleave: Optional[int] = None +) -> None: + """ + Pop addr_info from the list of addr_infos by family up to interleave times. + + The interleave parameter is used to know how many addr_infos for + each family should be popped of the top of the list. + """ + seen: Dict[int, int] = {} + if interleave is None: + interleave = 1 + to_remove: List[AddrInfoType] = [] + for addr_info in addr_infos: + family = addr_info[0] + if family not in seen: + seen[family] = 0 + if seen[family] < interleave: + to_remove.append(addr_info) + seen[family] += 1 + for addr_info in to_remove: + addr_infos.remove(addr_info) + + +def _addr_tuple_to_ip_address( + addr: Union[Tuple[str, int], Tuple[str, int, int, int]] +) -> Union[ + Tuple[ipaddress.IPv4Address, int], Tuple[ipaddress.IPv6Address, int, int, int] +]: + """Convert an address tuple to an IPv4Address.""" + return (ipaddress.ip_address(addr[0]), *addr[1:]) + + +def remove_addr_infos( + addr_infos: List[AddrInfoType], + addr: Union[Tuple[str, int], Tuple[str, int, int, int]], +) -> None: + """ + Remove an address from the list of addr_infos. + + The addr value is typically the return value of + sock.getpeername(). + """ + bad_addrs_infos: List[AddrInfoType] = [] + for addr_info in addr_infos: + if addr_info[-1] == addr: + bad_addrs_infos.append(addr_info) + if bad_addrs_infos: + for bad_addr_info in bad_addrs_infos: + addr_infos.remove(bad_addr_info) + return + # Slow path in case addr is formatted differently + match_addr = _addr_tuple_to_ip_address(addr) + for addr_info in addr_infos: + if match_addr == _addr_tuple_to_ip_address(addr_info[-1]): + bad_addrs_infos.append(addr_info) + if bad_addrs_infos: + for bad_addr_info in bad_addrs_infos: + addr_infos.remove(bad_addr_info) + return + raise ValueError(f"Address {addr} not found in addr_infos") diff --git a/env/Lib/site-packages/aiohttp-3.10.5.dist-info/INSTALLER b/env/Lib/site-packages/aiohttp-3.10.5.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/Lib/site-packages/aiohttp-3.10.5.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/Lib/site-packages/aiohttp-3.10.5.dist-info/LICENSE.txt b/env/Lib/site-packages/aiohttp-3.10.5.dist-info/LICENSE.txt new file mode 100644 index 0000000..e497a32 --- /dev/null +++ b/env/Lib/site-packages/aiohttp-3.10.5.dist-info/LICENSE.txt @@ -0,0 +1,13 @@ + Copyright aio-libs contributors. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/env/Lib/site-packages/aiohttp-3.10.5.dist-info/METADATA b/env/Lib/site-packages/aiohttp-3.10.5.dist-info/METADATA new file mode 100644 index 0000000..01beba7 --- /dev/null +++ b/env/Lib/site-packages/aiohttp-3.10.5.dist-info/METADATA @@ -0,0 +1,246 @@ +Metadata-Version: 2.1 +Name: aiohttp +Version: 3.10.5 +Summary: Async http client/server framework (asyncio) +Home-page: https://github.com/aio-libs/aiohttp +Maintainer: aiohttp team +Maintainer-email: team@aiohttp.org +License: Apache 2 +Project-URL: Chat: Matrix, https://matrix.to/#/#aio-libs:matrix.org +Project-URL: Chat: Matrix Space, https://matrix.to/#/#aio-libs-space:matrix.org +Project-URL: CI: GitHub Actions, https://github.com/aio-libs/aiohttp/actions?query=workflow%3ACI +Project-URL: Coverage: codecov, https://codecov.io/github/aio-libs/aiohttp +Project-URL: Docs: Changelog, https://docs.aiohttp.org/en/stable/changes.html +Project-URL: Docs: RTD, https://docs.aiohttp.org +Project-URL: GitHub: issues, https://github.com/aio-libs/aiohttp/issues +Project-URL: GitHub: repo, https://github.com/aio-libs/aiohttp +Classifier: Development Status :: 5 - Production/Stable +Classifier: Framework :: AsyncIO +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: Apache Software License +Classifier: Operating System :: POSIX +Classifier: Operating System :: MacOS :: MacOS X +Classifier: Operating System :: Microsoft :: Windows +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Topic :: Internet :: WWW/HTTP +Requires-Python: >=3.8 +Description-Content-Type: text/x-rst +License-File: LICENSE.txt +Requires-Dist: aiohappyeyeballs >=2.3.0 +Requires-Dist: aiosignal >=1.1.2 +Requires-Dist: attrs >=17.3.0 +Requires-Dist: frozenlist >=1.1.1 +Requires-Dist: multidict <7.0,>=4.5 +Requires-Dist: yarl <2.0,>=1.0 +Requires-Dist: async-timeout <5.0,>=4.0 ; python_version < "3.11" +Provides-Extra: speedups +Requires-Dist: brotlicffi ; (platform_python_implementation != "CPython") and extra == 'speedups' +Requires-Dist: Brotli ; (platform_python_implementation == "CPython") and extra == 'speedups' +Requires-Dist: aiodns >=3.2.0 ; (sys_platform == "linux" or sys_platform == "darwin") and extra == 'speedups' + +================================== +Async http client/server framework +================================== + +.. image:: https://raw.githubusercontent.com/aio-libs/aiohttp/master/docs/aiohttp-plain.svg + :height: 64px + :width: 64px + :alt: aiohttp logo + +| + +.. image:: https://github.com/aio-libs/aiohttp/workflows/CI/badge.svg + :target: https://github.com/aio-libs/aiohttp/actions?query=workflow%3ACI + :alt: GitHub Actions status for master branch + +.. image:: https://codecov.io/gh/aio-libs/aiohttp/branch/master/graph/badge.svg + :target: https://codecov.io/gh/aio-libs/aiohttp + :alt: codecov.io status for master branch + +.. image:: https://badge.fury.io/py/aiohttp.svg + :target: https://pypi.org/project/aiohttp + :alt: Latest PyPI package version + +.. image:: https://readthedocs.org/projects/aiohttp/badge/?version=latest + :target: https://docs.aiohttp.org/ + :alt: Latest Read The Docs + +.. image:: https://img.shields.io/matrix/aio-libs:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat + :target: https://matrix.to/#/%23aio-libs:matrix.org + :alt: Matrix Room — #aio-libs:matrix.org + +.. image:: https://img.shields.io/matrix/aio-libs-space:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs-space%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat + :target: https://matrix.to/#/%23aio-libs-space:matrix.org + :alt: Matrix Space — #aio-libs-space:matrix.org + + +Key Features +============ + +- Supports both client and server side of HTTP protocol. +- Supports both client and server Web-Sockets out-of-the-box and avoids + Callback Hell. +- Provides Web-server with middleware and pluggable routing. + + +Getting started +=============== + +Client +------ + +To get something from the web: + +.. code-block:: python + + import aiohttp + import asyncio + + async def main(): + + async with aiohttp.ClientSession() as session: + async with session.get('http://python.org') as response: + + print("Status:", response.status) + print("Content-type:", response.headers['content-type']) + + html = await response.text() + print("Body:", html[:15], "...") + + asyncio.run(main()) + +This prints: + +.. code-block:: + + Status: 200 + Content-type: text/html; charset=utf-8 + Body: ... + +Coming from `requests `_ ? Read `why we need so many lines `_. + +Server +------ + +An example using a simple server: + +.. code-block:: python + + # examples/server_simple.py + from aiohttp import web + + async def handle(request): + name = request.match_info.get('name', "Anonymous") + text = "Hello, " + name + return web.Response(text=text) + + async def wshandle(request): + ws = web.WebSocketResponse() + await ws.prepare(request) + + async for msg in ws: + if msg.type == web.WSMsgType.text: + await ws.send_str("Hello, {}".format(msg.data)) + elif msg.type == web.WSMsgType.binary: + await ws.send_bytes(msg.data) + elif msg.type == web.WSMsgType.close: + break + + return ws + + + app = web.Application() + app.add_routes([web.get('/', handle), + web.get('/echo', wshandle), + web.get('/{name}', handle)]) + + if __name__ == '__main__': + web.run_app(app) + + +Documentation +============= + +https://aiohttp.readthedocs.io/ + + +Demos +===== + +https://github.com/aio-libs/aiohttp-demos + + +External links +============== + +* `Third party libraries + `_ +* `Built with aiohttp + `_ +* `Powered by aiohttp + `_ + +Feel free to make a Pull Request for adding your link to these pages! + + +Communication channels +====================== + +*aio-libs Discussions*: https://github.com/aio-libs/aiohttp/discussions + +*Matrix*: `#aio-libs:matrix.org `_ + +We support `Stack Overflow +`_. +Please add *aiohttp* tag to your question there. + +Requirements +============ + +- async-timeout_ +- attrs_ +- multidict_ +- yarl_ +- frozenlist_ + +Optionally you may install the aiodns_ library (highly recommended for sake of speed). + +.. _aiodns: https://pypi.python.org/pypi/aiodns +.. _attrs: https://github.com/python-attrs/attrs +.. _multidict: https://pypi.python.org/pypi/multidict +.. _frozenlist: https://pypi.org/project/frozenlist/ +.. _yarl: https://pypi.python.org/pypi/yarl +.. _async-timeout: https://pypi.python.org/pypi/async_timeout + +License +======= + +``aiohttp`` is offered under the Apache 2 license. + + +Keepsafe +======== + +The aiohttp community would like to thank Keepsafe +(https://www.getkeepsafe.com) for its support in the early days of +the project. + + +Source code +=========== + +The latest developer version is available in a GitHub repository: +https://github.com/aio-libs/aiohttp + +Benchmarks +========== + +If you are interested in efficiency, the AsyncIO community maintains a +list of benchmarks on the official wiki: +https://github.com/python/asyncio/wiki/Benchmarks diff --git a/env/Lib/site-packages/aiohttp-3.10.5.dist-info/RECORD b/env/Lib/site-packages/aiohttp-3.10.5.dist-info/RECORD new file mode 100644 index 0000000..43a54be --- /dev/null +++ b/env/Lib/site-packages/aiohttp-3.10.5.dist-info/RECORD @@ -0,0 +1,119 @@ +aiohttp-3.10.5.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +aiohttp-3.10.5.dist-info/LICENSE.txt,sha256=wUk-nxDVnR-6n53ygAjhVX4zz5-6yM4SY6ozk5goA94,601 +aiohttp-3.10.5.dist-info/METADATA,sha256=IrmDXPIC5CEFgnNv8nQdliPEHM1cUUw-R_wuSwjA2tA,7784 +aiohttp-3.10.5.dist-info/RECORD,, +aiohttp-3.10.5.dist-info/WHEEL,sha256=dCuJ4f0faaLdEJehgDqauYbxfYcPtrcUnDoQw-il14k,101 +aiohttp-3.10.5.dist-info/top_level.txt,sha256=iv-JIaacmTl-hSho3QmphcKnbRRYx1st47yjz_178Ro,8 +aiohttp/.hash/_cparser.pxd.hash,sha256=dVGMrCmyJM_owqoRLPezK095md0X5R319koTuhUN6DQ,64 +aiohttp/.hash/_find_header.pxd.hash,sha256=W5qRPWDc55gArGZkriI5tztmQHkrdwR6NdQfRQfTxIg,64 +aiohttp/.hash/_helpers.pyi.hash,sha256=bAsxbXsjcZ5gbj1c561GYcRtQ5REXxrCihR-HN0XKPk,64 +aiohttp/.hash/_helpers.pyx.hash,sha256=-DfrN0XUqBhyb8bp2fJQVb1Lo9S1S-psob-7MJBM18c,64 +aiohttp/.hash/_http_parser.pyx.hash,sha256=zqi4Dj2ahyHj_TgwxkJ_9GPy9Vo_oNekL0_JshY-6ZY,64 +aiohttp/.hash/_http_writer.pyx.hash,sha256=z39c0hUcdud-ZCon2d9bWpxrFMVdW1dvjtCgxW4RDnI,64 +aiohttp/.hash/_websocket.pyx.hash,sha256=90x5ulhWiFtw2wAri2_82Zas5i3iEkJ-flYJK9Xx-SY,64 +aiohttp/.hash/hdrs.py.hash,sha256=QBHPUkJcp8iPZv3ENUbevgpJzljxoP2qwkBeX3nQ82o,64 +aiohttp/__init__.py,sha256=68WmyslV950A4d5X2ZDFT85PU4W-Zeuo0A8qGTosrV4,7781 +aiohttp/__pycache__/__init__.cpython-311.pyc,, +aiohttp/__pycache__/abc.cpython-311.pyc,, +aiohttp/__pycache__/base_protocol.cpython-311.pyc,, +aiohttp/__pycache__/client.cpython-311.pyc,, +aiohttp/__pycache__/client_exceptions.cpython-311.pyc,, +aiohttp/__pycache__/client_proto.cpython-311.pyc,, +aiohttp/__pycache__/client_reqrep.cpython-311.pyc,, +aiohttp/__pycache__/client_ws.cpython-311.pyc,, +aiohttp/__pycache__/compression_utils.cpython-311.pyc,, +aiohttp/__pycache__/connector.cpython-311.pyc,, +aiohttp/__pycache__/cookiejar.cpython-311.pyc,, +aiohttp/__pycache__/formdata.cpython-311.pyc,, +aiohttp/__pycache__/hdrs.cpython-311.pyc,, +aiohttp/__pycache__/helpers.cpython-311.pyc,, +aiohttp/__pycache__/http.cpython-311.pyc,, +aiohttp/__pycache__/http_exceptions.cpython-311.pyc,, +aiohttp/__pycache__/http_parser.cpython-311.pyc,, +aiohttp/__pycache__/http_websocket.cpython-311.pyc,, +aiohttp/__pycache__/http_writer.cpython-311.pyc,, +aiohttp/__pycache__/locks.cpython-311.pyc,, +aiohttp/__pycache__/log.cpython-311.pyc,, +aiohttp/__pycache__/multipart.cpython-311.pyc,, +aiohttp/__pycache__/payload.cpython-311.pyc,, +aiohttp/__pycache__/payload_streamer.cpython-311.pyc,, +aiohttp/__pycache__/pytest_plugin.cpython-311.pyc,, +aiohttp/__pycache__/resolver.cpython-311.pyc,, +aiohttp/__pycache__/streams.cpython-311.pyc,, +aiohttp/__pycache__/tcp_helpers.cpython-311.pyc,, +aiohttp/__pycache__/test_utils.cpython-311.pyc,, +aiohttp/__pycache__/tracing.cpython-311.pyc,, +aiohttp/__pycache__/typedefs.cpython-311.pyc,, +aiohttp/__pycache__/web.cpython-311.pyc,, +aiohttp/__pycache__/web_app.cpython-311.pyc,, +aiohttp/__pycache__/web_exceptions.cpython-311.pyc,, +aiohttp/__pycache__/web_fileresponse.cpython-311.pyc,, +aiohttp/__pycache__/web_log.cpython-311.pyc,, +aiohttp/__pycache__/web_middlewares.cpython-311.pyc,, +aiohttp/__pycache__/web_protocol.cpython-311.pyc,, +aiohttp/__pycache__/web_request.cpython-311.pyc,, +aiohttp/__pycache__/web_response.cpython-311.pyc,, +aiohttp/__pycache__/web_routedef.cpython-311.pyc,, +aiohttp/__pycache__/web_runner.cpython-311.pyc,, +aiohttp/__pycache__/web_server.cpython-311.pyc,, +aiohttp/__pycache__/web_urldispatcher.cpython-311.pyc,, +aiohttp/__pycache__/web_ws.cpython-311.pyc,, +aiohttp/__pycache__/worker.cpython-311.pyc,, +aiohttp/_cparser.pxd,sha256=W6-cu0SyHhOEPeb475NvxagQ1Jz9pWqyZJvwEqTLNs0,4476 +aiohttp/_find_header.pxd,sha256=BFUSmxhemBtblqxzjzH3x03FfxaWlTyuAIOz8YZ5_nM,70 +aiohttp/_headers.pxi,sha256=1MhCe6Un_KI1tpO85HnDfzVO94BhcirLanAOys5FIHA,2090 +aiohttp/_helpers.cp311-win_amd64.pyd,sha256=WzS2tywYKnRAfaTW6ESVnrOWmdAxPM1rjLzK7s7aqPM,54784 +aiohttp/_helpers.pyi,sha256=2Hd5IC0Zf4YTEJ412suyyhsh1kVyVDv5g4stgyo2Ksc,208 +aiohttp/_helpers.pyx,sha256=tgl7fZh0QMT6cjf4jSJ8iaO6DdQD3GON2-SH4N5_ETg,1084 +aiohttp/_http_parser.cp311-win_amd64.pyd,sha256=MTnxWQoyV1L51bC9YitigbltpukH0lwPD8SsY4iSJSw,266240 +aiohttp/_http_parser.pyx,sha256=gukaWoH-X5k2e5qaZnxzDpzwROijbXde2s73xtLStF4,29236 +aiohttp/_http_writer.cp311-win_amd64.pyd,sha256=hrgbtvHh3yolDTcdP49HdUKIp-fxRmojcFLScl5d9T4,49152 +aiohttp/_http_writer.pyx,sha256=8CBLytO2rx1kdpWe9HYSznhLXdeZWyE-3xI7jaGasag,4738 +aiohttp/_websocket.cp311-win_amd64.pyd,sha256=_qMBjD30-S2Ygcz0rKjzzZi4RFnWU5w46UnA2SJmO_o,36864 +aiohttp/_websocket.pyx,sha256=o9J7yi9c2-jTBjE3dUkXxhDWKvRWJz5GZfyLsgJQa38,1617 +aiohttp/abc.py,sha256=ZZW_iR6jajNyfW3vktthecqV4FyaKvCv_0W9xIT1W5I,6331 +aiohttp/base_protocol.py,sha256=N4IzuMQLGHG7AJji9um-2gqQxKGo41P3aCZwrvegumc,2971 +aiohttp/client.py,sha256=HjV18OwmQlahPwW9w3qY7ypUR-kskCEHQcMX-S9uftU,54180 +aiohttp/client_exceptions.py,sha256=Rat0bV5BjGlmp-3gU3GtW9GGrdhYMnNLLWT-j0HtHbo,11125 +aiohttp/client_proto.py,sha256=7tAgGcEJwd7VEWHyTyrhQ_DQkwj9T34rGC1G_9PJCRk,10445 +aiohttp/client_reqrep.py,sha256=tChBwbMyZUiyd9CSckMBP52hHAtPrFPCnYCRc9jTviI,42168 +aiohttp/client_ws.py,sha256=oxUScZbcggPQmeRqSBo-XJWv3_O7mAq9dVIDxtBktZo,14327 +aiohttp/compression_utils.py,sha256=majGJXsz7hoxjhdOK9HTvcPwOYpCbtN0VxYRg4inwKo,5214 +aiohttp/connector.py,sha256=cObqWwS65TO-l-hO-o4muyf-gzXu2F97f4bLvhiJLYY,59558 +aiohttp/cookiejar.py,sha256=O9fDAlTLsdaxWYY_5i-9Sbnwxzf2nRweqXGAGdP7VN8,14985 +aiohttp/formdata.py,sha256=XRu5kZi8MqEMoct2KGBrVetaHVthIRI__0o3UQfctzc,6703 +aiohttp/hdrs.py,sha256=_JN4MBE-UoBXGWGoSCKhIviTRc2IXS4fyk5nnuox0Ak,4721 +aiohttp/helpers.py,sha256=xc_sYCUrdW_YyA5QaD_E9gd-XHPJS5yuIC7SIJgUsOM,31282 +aiohttp/http.py,sha256=DGKcwDbgIMpasv7s2jeKCRuixyj7W-RIrihRFjj0xcY,1914 +aiohttp/http_exceptions.py,sha256=Mvk7SkZ4a7enFQ_koyXx2Dy3E5uoW8M8tndV4bC6Qs8,2820 +aiohttp/http_parser.py,sha256=TtyBKUpf2SRY6hFTSL-Pk6xvt_oiGtO_v_GPI5VwzOI,36820 +aiohttp/http_websocket.py,sha256=0FSqqFqnMvI1g7X4z-sotEomwrD6x-119-yfogoQhVI,26668 +aiohttp/http_writer.py,sha256=p8H39HhtilQEE90njvtJHc94Am95zjHNoS8T1JcNXJc,6131 +aiohttp/locks.py,sha256=vp1Z4zx0SvooSffw88dkZ-7qpk2CqRf5vWh2dpKagTA,1177 +aiohttp/log.py,sha256=zYUTvXsMQ9Sz1yNN8kXwd5Qxu49a1FzjZ_wQqriEc8M,333 +aiohttp/multipart.py,sha256=IIwqrT_tUBFfS3GJJKC-xL97A-03fSGgN-dnJydnW7s,37559 +aiohttp/payload.py,sha256=9wzXARKXbec81DHYfiCr354mcHTY3isfqVqmusRSXXM,14029 +aiohttp/payload_streamer.py,sha256=rBb3jAFcwAK1QOgbhya2y4zGjhT11oQrepdcffA1_jM,2162 +aiohttp/py.typed,sha256=3VVwXUAWVEVX7sDwyYDnW5ZdBC9_Z9AJAFfLCleUW0k,8 +aiohttp/pytest_plugin.py,sha256=XvkgjZNMUTEGaYglCgeOIDnN-ePIanED1nrX9GSwEdg,12328 +aiohttp/resolver.py,sha256=ZAmhwsoNfweKy8C9M-VOEUpZKyAZM5CjAKAgUDTKWlY,6585 +aiohttp/streams.py,sha256=v9GkCFn9mynR1yGB1Xl6mwxEJXsOC4T-DzoL4IC0XOU,21812 +aiohttp/tcp_helpers.py,sha256=K-hhGh3jd6qCEnHJo8LvFyfJwBjh99UKI7A0aSRVhj4,998 +aiohttp/test_utils.py,sha256=isd4eSUqdS0uPxIZ1IhOliE4nttE8PKNLZQL5S7s44A,22614 +aiohttp/tracing.py,sha256=c3C8lnLZ0G1Jj3Iv1GgV-Op8PwcM4m6d931w502hSgI,15607 +aiohttp/typedefs.py,sha256=psCpiYoYBCl22EqlqihhPhjEQlPiAx6Von8RpKgY674,1691 +aiohttp/web.py,sha256=4JPfYt8EUmw-tSKmASCQjXSJlY-ImhGCh_i0ajD6VEk,18641 +aiohttp/web_app.py,sha256=EVqAwfU9ma8ZU4xiT7gmA3fmH0gzlPRsGy03lHPp6uE,18921 +aiohttp/web_exceptions.py,sha256=itNRhCMDJFhnMWftr5SyTsoqh-i0n9rzTj0sjcAEUjo,10812 +aiohttp/web_fileresponse.py,sha256=0mQthdMhD_1pM7gfQ14WN0qfiE3gaSjOPZskAyPfq0M,14052 +aiohttp/web_log.py,sha256=w81HIudhfSxfodo2Fjkok7jWT56XXIrVMJN6ihYnLo0,8014 +aiohttp/web_middlewares.py,sha256=rYWtxDZ2AM3C2FvNuNyffpfmMfcHrxkSZMaTcsG1T_Q,4148 +aiohttp/web_protocol.py,sha256=vDlBoA58FRUlBkIu1IT_Jh8hnE1_dMQ_VfeY_Y-LEKc,24597 +aiohttp/web_request.py,sha256=1_BVNJUm5Q6xzX0Hmkl1gr45hDa3oSb4E4SuS1MYdT4,30458 +aiohttp/web_response.py,sha256=hIrfUaB5EhsXgnt1LP-HhozhcxXgDAs5CDwAVTQjuG8,28728 +aiohttp/web_routedef.py,sha256=nRRvg7i5VtJJlyqxvGBzpEO2qIMgPEWueTB3bhX3l9U,6330 +aiohttp/web_runner.py,sha256=Z6odFUNBAE4lqcIB9zl1YtDLyZ6QKTRouB3YjmA7WCc,12084 +aiohttp/web_server.py,sha256=aHycxJrS1nytAj1IjIpKeDCQWsAgrDxm1_hRUmumqpI,2846 +aiohttp/web_urldispatcher.py,sha256=VAoqh9F2QPlUywBJIpWcjtQER0WL-CgtsbcshfY3IFk,45073 +aiohttp/web_ws.py,sha256=AcAFbWqUE2S7gi9o7os-myrfVecigSVySaYQ-oUdczU,22254 +aiohttp/worker.py,sha256=vDMxlk-Mo3rzN4yubw2-c8T6yg7PRY8Mv0NLuRm8lWw,8212 diff --git a/env/Lib/site-packages/aiohttp-3.10.5.dist-info/WHEEL b/env/Lib/site-packages/aiohttp-3.10.5.dist-info/WHEEL new file mode 100644 index 0000000..7ba121b --- /dev/null +++ b/env/Lib/site-packages/aiohttp-3.10.5.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (72.2.0) +Root-Is-Purelib: false +Tag: cp311-cp311-win_amd64 + diff --git a/env/Lib/site-packages/aiohttp-3.10.5.dist-info/top_level.txt b/env/Lib/site-packages/aiohttp-3.10.5.dist-info/top_level.txt new file mode 100644 index 0000000..ee4ba4f --- /dev/null +++ b/env/Lib/site-packages/aiohttp-3.10.5.dist-info/top_level.txt @@ -0,0 +1 @@ +aiohttp diff --git a/env/Lib/site-packages/aiohttp/.hash/_cparser.pxd.hash b/env/Lib/site-packages/aiohttp/.hash/_cparser.pxd.hash new file mode 100644 index 0000000..1dc9b9a --- /dev/null +++ b/env/Lib/site-packages/aiohttp/.hash/_cparser.pxd.hash @@ -0,0 +1 @@ +5baf9cbb44b21e13843de6f8ef936fc5a810d49cfda56ab2649bf012a4cb36cd \ No newline at end of file diff --git a/env/Lib/site-packages/aiohttp/.hash/_find_header.pxd.hash b/env/Lib/site-packages/aiohttp/.hash/_find_header.pxd.hash new file mode 100644 index 0000000..ab9d476 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/.hash/_find_header.pxd.hash @@ -0,0 +1 @@ +0455129b185e981b5b96ac738f31f7c74dc57f1696953cae0083b3f18679fe73 \ No newline at end of file diff --git a/env/Lib/site-packages/aiohttp/.hash/_helpers.pyi.hash b/env/Lib/site-packages/aiohttp/.hash/_helpers.pyi.hash new file mode 100644 index 0000000..c304d37 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/.hash/_helpers.pyi.hash @@ -0,0 +1 @@ +d87779202d197f8613109e35dacbb2ca1b21d64572543bf9838b2d832a362ac7 \ No newline at end of file diff --git a/env/Lib/site-packages/aiohttp/.hash/_helpers.pyx.hash b/env/Lib/site-packages/aiohttp/.hash/_helpers.pyx.hash new file mode 100644 index 0000000..8164dbb --- /dev/null +++ b/env/Lib/site-packages/aiohttp/.hash/_helpers.pyx.hash @@ -0,0 +1 @@ +b6097b7d987440c4fa7237f88d227c89a3ba0dd403dc638ddbe487e0de7f1138 \ No newline at end of file diff --git a/env/Lib/site-packages/aiohttp/.hash/_http_parser.pyx.hash b/env/Lib/site-packages/aiohttp/.hash/_http_parser.pyx.hash new file mode 100644 index 0000000..b332ee3 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/.hash/_http_parser.pyx.hash @@ -0,0 +1 @@ +82e91a5a81fe5f99367b9a9a667c730e9cf044e8a36d775edacef7c6d2d2b45e \ No newline at end of file diff --git a/env/Lib/site-packages/aiohttp/.hash/_http_writer.pyx.hash b/env/Lib/site-packages/aiohttp/.hash/_http_writer.pyx.hash new file mode 100644 index 0000000..10d8347 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/.hash/_http_writer.pyx.hash @@ -0,0 +1 @@ +f0204bcad3b6af1d6476959ef47612ce784b5dd7995b213edf123b8da19ab1a8 \ No newline at end of file diff --git a/env/Lib/site-packages/aiohttp/.hash/_websocket.pyx.hash b/env/Lib/site-packages/aiohttp/.hash/_websocket.pyx.hash new file mode 100644 index 0000000..511f26f --- /dev/null +++ b/env/Lib/site-packages/aiohttp/.hash/_websocket.pyx.hash @@ -0,0 +1 @@ +a3d27bca2f5cdbe8d3063137754917c610d62af456273e4665fc8bb202506b7f \ No newline at end of file diff --git a/env/Lib/site-packages/aiohttp/.hash/hdrs.py.hash b/env/Lib/site-packages/aiohttp/.hash/hdrs.py.hash new file mode 100644 index 0000000..b032e6e --- /dev/null +++ b/env/Lib/site-packages/aiohttp/.hash/hdrs.py.hash @@ -0,0 +1 @@ +fc937830113e5280571961a84822a122f89345cd885d2e1fca4e679eea31d009 \ No newline at end of file diff --git a/env/Lib/site-packages/aiohttp/__init__.py b/env/Lib/site-packages/aiohttp/__init__.py new file mode 100644 index 0000000..bd65f92 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/__init__.py @@ -0,0 +1,254 @@ +__version__ = "3.10.5" + +from typing import TYPE_CHECKING, Tuple + +from . import hdrs as hdrs +from .client import ( + BaseConnector, + ClientConnectionError, + ClientConnectorCertificateError, + ClientConnectorError, + ClientConnectorSSLError, + ClientError, + ClientHttpProxyError, + ClientOSError, + ClientPayloadError, + ClientProxyConnectionError, + ClientRequest, + ClientResponse, + ClientResponseError, + ClientSession, + ClientSSLError, + ClientTimeout, + ClientWebSocketResponse, + ConnectionTimeoutError, + ContentTypeError, + Fingerprint, + InvalidURL, + InvalidUrlClientError, + InvalidUrlRedirectClientError, + NamedPipeConnector, + NonHttpUrlClientError, + NonHttpUrlRedirectClientError, + RedirectClientError, + RequestInfo, + ServerConnectionError, + ServerDisconnectedError, + ServerFingerprintMismatch, + ServerTimeoutError, + SocketTimeoutError, + TCPConnector, + TooManyRedirects, + UnixConnector, + WSServerHandshakeError, + request, +) +from .cookiejar import CookieJar as CookieJar, DummyCookieJar as DummyCookieJar +from .formdata import FormData as FormData +from .helpers import BasicAuth, ChainMapProxy, ETag +from .http import ( + HttpVersion as HttpVersion, + HttpVersion10 as HttpVersion10, + HttpVersion11 as HttpVersion11, + WebSocketError as WebSocketError, + WSCloseCode as WSCloseCode, + WSMessage as WSMessage, + WSMsgType as WSMsgType, +) +from .multipart import ( + BadContentDispositionHeader as BadContentDispositionHeader, + BadContentDispositionParam as BadContentDispositionParam, + BodyPartReader as BodyPartReader, + MultipartReader as MultipartReader, + MultipartWriter as MultipartWriter, + content_disposition_filename as content_disposition_filename, + parse_content_disposition as parse_content_disposition, +) +from .payload import ( + PAYLOAD_REGISTRY as PAYLOAD_REGISTRY, + AsyncIterablePayload as AsyncIterablePayload, + BufferedReaderPayload as BufferedReaderPayload, + BytesIOPayload as BytesIOPayload, + BytesPayload as BytesPayload, + IOBasePayload as IOBasePayload, + JsonPayload as JsonPayload, + Payload as Payload, + StringIOPayload as StringIOPayload, + StringPayload as StringPayload, + TextIOPayload as TextIOPayload, + get_payload as get_payload, + payload_type as payload_type, +) +from .payload_streamer import streamer as streamer +from .resolver import ( + AsyncResolver as AsyncResolver, + DefaultResolver as DefaultResolver, + ThreadedResolver as ThreadedResolver, +) +from .streams import ( + EMPTY_PAYLOAD as EMPTY_PAYLOAD, + DataQueue as DataQueue, + EofStream as EofStream, + FlowControlDataQueue as FlowControlDataQueue, + StreamReader as StreamReader, +) +from .tracing import ( + TraceConfig as TraceConfig, + TraceConnectionCreateEndParams as TraceConnectionCreateEndParams, + TraceConnectionCreateStartParams as TraceConnectionCreateStartParams, + TraceConnectionQueuedEndParams as TraceConnectionQueuedEndParams, + TraceConnectionQueuedStartParams as TraceConnectionQueuedStartParams, + TraceConnectionReuseconnParams as TraceConnectionReuseconnParams, + TraceDnsCacheHitParams as TraceDnsCacheHitParams, + TraceDnsCacheMissParams as TraceDnsCacheMissParams, + TraceDnsResolveHostEndParams as TraceDnsResolveHostEndParams, + TraceDnsResolveHostStartParams as TraceDnsResolveHostStartParams, + TraceRequestChunkSentParams as TraceRequestChunkSentParams, + TraceRequestEndParams as TraceRequestEndParams, + TraceRequestExceptionParams as TraceRequestExceptionParams, + TraceRequestRedirectParams as TraceRequestRedirectParams, + TraceRequestStartParams as TraceRequestStartParams, + TraceResponseChunkReceivedParams as TraceResponseChunkReceivedParams, +) + +if TYPE_CHECKING: + # At runtime these are lazy-loaded at the bottom of the file. + from .worker import ( + GunicornUVLoopWebWorker as GunicornUVLoopWebWorker, + GunicornWebWorker as GunicornWebWorker, + ) + +__all__: Tuple[str, ...] = ( + "hdrs", + # client + "BaseConnector", + "ClientConnectionError", + "ClientConnectorCertificateError", + "ClientConnectorError", + "ClientConnectorSSLError", + "ClientError", + "ClientHttpProxyError", + "ClientOSError", + "ClientPayloadError", + "ClientProxyConnectionError", + "ClientResponse", + "ClientRequest", + "ClientResponseError", + "ClientSSLError", + "ClientSession", + "ClientTimeout", + "ClientWebSocketResponse", + "ConnectionTimeoutError", + "ContentTypeError", + "Fingerprint", + "InvalidURL", + "InvalidUrlClientError", + "InvalidUrlRedirectClientError", + "NonHttpUrlClientError", + "NonHttpUrlRedirectClientError", + "RedirectClientError", + "RequestInfo", + "ServerConnectionError", + "ServerDisconnectedError", + "ServerFingerprintMismatch", + "ServerTimeoutError", + "SocketTimeoutError", + "TCPConnector", + "TooManyRedirects", + "UnixConnector", + "NamedPipeConnector", + "WSServerHandshakeError", + "request", + # cookiejar + "CookieJar", + "DummyCookieJar", + # formdata + "FormData", + # helpers + "BasicAuth", + "ChainMapProxy", + "ETag", + # http + "HttpVersion", + "HttpVersion10", + "HttpVersion11", + "WSMsgType", + "WSCloseCode", + "WSMessage", + "WebSocketError", + # multipart + "BadContentDispositionHeader", + "BadContentDispositionParam", + "BodyPartReader", + "MultipartReader", + "MultipartWriter", + "content_disposition_filename", + "parse_content_disposition", + # payload + "AsyncIterablePayload", + "BufferedReaderPayload", + "BytesIOPayload", + "BytesPayload", + "IOBasePayload", + "JsonPayload", + "PAYLOAD_REGISTRY", + "Payload", + "StringIOPayload", + "StringPayload", + "TextIOPayload", + "get_payload", + "payload_type", + # payload_streamer + "streamer", + # resolver + "AsyncResolver", + "DefaultResolver", + "ThreadedResolver", + # streams + "DataQueue", + "EMPTY_PAYLOAD", + "EofStream", + "FlowControlDataQueue", + "StreamReader", + # tracing + "TraceConfig", + "TraceConnectionCreateEndParams", + "TraceConnectionCreateStartParams", + "TraceConnectionQueuedEndParams", + "TraceConnectionQueuedStartParams", + "TraceConnectionReuseconnParams", + "TraceDnsCacheHitParams", + "TraceDnsCacheMissParams", + "TraceDnsResolveHostEndParams", + "TraceDnsResolveHostStartParams", + "TraceRequestChunkSentParams", + "TraceRequestEndParams", + "TraceRequestExceptionParams", + "TraceRequestRedirectParams", + "TraceRequestStartParams", + "TraceResponseChunkReceivedParams", + # workers (imported lazily with __getattr__) + "GunicornUVLoopWebWorker", + "GunicornWebWorker", +) + + +def __dir__() -> Tuple[str, ...]: + return __all__ + ("__author__", "__doc__") + + +def __getattr__(name: str) -> object: + global GunicornUVLoopWebWorker, GunicornWebWorker + + # Importing gunicorn takes a long time (>100ms), so only import if actually needed. + if name in ("GunicornUVLoopWebWorker", "GunicornWebWorker"): + try: + from .worker import GunicornUVLoopWebWorker as guv, GunicornWebWorker as gw + except ImportError: + return None + + GunicornUVLoopWebWorker = guv # type: ignore[misc] + GunicornWebWorker = gw # type: ignore[misc] + return guv if name == "GunicornUVLoopWebWorker" else gw + + raise AttributeError(f"module {__name__} has no attribute {name}") diff --git a/env/Lib/site-packages/aiohttp/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dff850209de9cc49e3251dce0757a5eb0e2ac17c GIT binary patch literal 5958 zcmeH~&2JmW6~K2%N~A5FO%yXL?oeE7-!3z| zlqJ^zjG`!fXi*&kBtY6@TLe89$RE)IQ}iGV5FkL&Lx3JwAMOXEZsX~Z_ zAk4z5qKEZ}8G$-h=auWsdWfy%=+EN0XWW%!yp@k6YK;Gu_1VdJp<3O zXW=9}38&a8c#b^>r`c&Z!_L6-?0HDCB%Ebu;RW^ryvSbk?5j6lf?+lc=h!)~9yQOy z1$MzJ$IO@EBD)Be*d@5kE_<>D^A)(luE14x6<%ep!ZmgcUSqGpb#@(IXRmvG8qGK0 z2D<@ovNvIbjld`yg%nG{7#o9eHtzL_n-eg}CSi(A!8DtOo9rgsVz*$1&A=?1g*i3{ z^K2d#*aF;Uw_%YjLYk$$u}x+Mme`V4PMCLKnJvRx>@8SfE1s;`Wbih78&=sWyu;ps zyX-DxS=MW7G2aD^X|TrDAjfi`GaWeNkY{;VXX{X41u&Qa_t-tyU>jgE6Mz9&%mSO) zP-I0_;UN*jb#67^1EC3UGzWFJF_(vVNpH`G`l=D5@J+qrI@a{gZ?@$_de_e)?7rTO zqdNIkKBD(veOvEME6KhG^%sXPoFBgYCFx3rWFoV&FrH0Kji+u+&rQm@OsQz{FI8$( zWu%}BCwW>XMm2}0Y|G*~*A}uXWg6Ua1A$>%<3gbL!~wA_Qe3!3-pFY#_d9eR>flRz z4oTDL8NVU!Hyju{<+{ZMVQ+2w(uCh-KJ8cA{py0YZQ7dd%lZQu4LWRbFnp1}SK^K< zoBghf+$q|Y!)3?8`hicTx#Qr>t7Gcdudlup z@N^`NvMQy6Sg+0D_%y4pkOz~i?`uv7{ z6P`63(A-=>w);&7eAVvz^nk1>lUfMAhauUTvF%yS+OAsa$i$LmY}Gn+FQ2uv>n667@gvp&V}qhvT;EZ8p!5RTi?ba#;4b}WwvCxM)4@Y zvM^lKHh@b<-^uE=4`uU)$t?^o*@r_No;{*ZG9g*SVW5`bkAL1%<3jKF0`fT)}b90wW;d%>(ziZDQEVmNA~! z(2;wB)=UBW>NF$2OR`QT#%C8YE7`y&vVnr>c8Qm8X~*q6+J(wx=Y(nBrA zu*gde$DqI!!Kia&w`aqc<)pM+flnFLFZUdfV-9eF0Rz>Bz=2b?!WF_*!YhPpgx3gkFA}d4 z-XPo{yh#`(qzGe#al!;)k}yJ;B1{u*5^fP@2(yGa!aQMtaGQ`OED|z=CBhxTGT|-4 z3V{*cCae1Wo3GWg#!Wtn*&Ws?ji?3BDqEl;)TrCJY&NNid)Va@n(eM~YjbtRSX;$2hQCzQavOLWIjfps7x0Wbm(3cM;bybL#cfZy zfnN~8D73xV>|o(T6#KRZ|~^v=C|uZ;+o9 z5qhXvC`&6Y?V8}xBQ9;9;Q3h5>mDi}E5C{S4lVn`o^?M}ll60A9eas70xi&kDA;<* zl@IdRc$p+s3uUl<{dO+QRh@`R0*oXTKiHX2~PCE@9!I zdKq3XZOYL4eTRH9G&CgMBWXOF#S@A?giihmN-Fs0e1LeQRANf3soZj-9HqAs3ODrb zHZ7OG<$dybOMgXC8+vQl?daLLv~#HvM(L9$Pb&4w$o97;$(kF_YjYCInPwR$`} zmwZ4|z!Q`1MHJR}v|_jknxu#zq~hf`S)cQMc>D*su8mZA39o}nodhr8eb-#)<*VR$a|Wor9BzT<3&=(v)@aAGFsqf5gl?U6XGv2++BzBp_c$_`H<41Y=G(w z?mMJL84WHqeinRsqI_zOl&#h4QT1BnWlb3q!Hwro{*+O_pX29HFPk1rq%!K_t%kzk zznxJ_6a;%|)k}ObjONG|%#4<0+Q9Bc$M-tn6POqg($;)4ZMQ5V#*GXKqY zS2gMNhxH|E+`~Wa+0iT8Xq(lsdJ(5((GUSCoH^#-ch9dK7)!_1M`-J>L4oiHcHGY2w6x_~ksNymLEU jJI+U`ovjbB2UZUw)~rsdJ2?ueN%f<=|NrUqa_v6>uBeX+ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/abc.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/abc.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a632066d1f326055062e13301b880f3c5aab2fa4 GIT binary patch literal 12464 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 AH~;_u literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/base_protocol.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/base_protocol.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5cd2d7d5638e61e6bbb33087ad92ed4f81fd39a6 GIT binary patch literal 4622 zcmd5=U2Gf25#Bo<$)osp5=9HLMT;_JOH3mvanmHWVgvqd-MVVw7=l15Cotf1i;_(3j<fzu z@GF5rfFnvk5h}t;un=VZU?sE?E`&M4lkXBGbcZNmm0S~Dp$`LuJb^#E6e0@uKFNz; z;NwD`x5OXSjIvfORxF`Z)QvAV7|(N7TvrWQ{jj7mE(}DCQcbREidre&D%rAZDmV{2 z523S8R8rs+Qs5P?5KwqkxaNKo+xD`c1n&rikQ!D3s<_OWR;=r)V#Q^J7Ry!nX0dFj)RN?qR;{WfR29tB4J#>AwWyS< zAGj+b1}#?gnnn#vV6s9~HR`mwP~yD}5x|HL1Y_qskag1F8btQk3O*qKtSAJYytRzy z!N_>7=D|STCy)7sv-u!JWtmFwprh1m_N#NJk1k%;==H@@ z8h***^*SvY8kLtcV^OW%SUg`|TGZkDXKKaL_2LJrzE~`4R}G^!w*=agYmWM6Yqu;> zmdn+$A$EBV*9S+Q&{bg_gLtJwA!;*t55f!f>Jq zza5xPN}fL8!PDL_Jb?DdHJrkV!qw5R`PD-gnA)=!X8{dm727#=RPKZducW-Z8G?RH#%+nDV-F?r8 zfaBjY<-bop;TW>Ovx|e}Mc5vL5v{p*b8%*%@=aPc0J7D+z76_#iP#2gdIH(G*O{3tfY^1VyW=)&P1hs_ONM@t9}$S|R%+JEm^~ zoxmw8s;A6-K4touIe3$P6$ofEnY!CB#eGnl4abb14W?Uzxn`&x9W)&4Nqy`1Okp!GdW^}K(tc~FN6?cu%Kl#mIIT7LKwP2s=`h3Vc-h6 zxr+^Z5RJjAe5mV*EXRT!_h}_g7zQmb)eZFwr5d$T3z~6mrB+c_)T*H>_F(Kny=s(K z>?ySGOwfbyid|2F^Ntzd>o{`iOhXf^8?g^a$jJaKbH2KNy9PrT=kcq0r;ozj3z$DK?mMj_;FOXFtt%}wcWOFG<^QqRLeJnu-}Je%@XV7juFg*l!@Y)Cf^8f0+aNkGQcNYS;jWQfP$73=!1tI4 zMqevl0>5ae@^T%n6)MG`W`*>tWwoNv33%|OHtzl9s#>Y3v@bY1cN?2`376gm@?ZGb z$<1v9_~`b~A#>{8&7mW$p(AGO$k!T5dh~wbX?kWWJ+qmfYo+JFkS172+`pYj->p8l zw3(P}B_>Vrm6d^?=P72@3;AKZP*jVMo5|LIEU#!vy@LIiEdR7#tT>#AEbA4`&}G@y z#^8x19d2PI0{=wx|=IsuF z-sf+zrk_Y8l<4q$@U;iPho(!O2Y_|wCydz<`QR9`dWk3oA@%T+;Si4bi4+P#tn(8o z5FC3n(#jw25a|6C-VIGZ85jyCHr{>o!&dHShd}>xgEjqRIubnCA+I2|&QMeN0mqJw zTQ#`OFl9SI&bCh7c8cu35AFz_GD~zX@3z`c!&n!Juf+FklQ~Y$0Ruy{{wpAmuW?+P tB-YrkO(x9U>N9e{^w&0-H2t*`y3BF#g}c*x@3d06=ZyK~E2gl`{tx171bF}e literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/client.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/client.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6b935bc83aa3292d909d6c5842c5115682d1e6f4 GIT binary patch literal 57552 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 HW%>VaE)xq5 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/client_exceptions.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/client_exceptions.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d002e3e7c0d5f1968249e2cc4b9d4ddd2df374d3 GIT binary patch literal 19021 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 PUHWPD0rxNE1MdF?xv-cR literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/client_proto.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/client_proto.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9dab2d0448056aa99377e5595e3971c89a215b2c GIT binary patch literal 12792 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ΠPYiAta9iQnE!U|u*gUiVH!h!}MYb{P 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/connector.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/connector.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e2c9708980d852a4821b815feeb8573f2f43d378 GIT binary patch literal 71790 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/formdata.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/formdata.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..45ba008deb418fed2f9ef655158c098b0ab51ed3 GIT binary patch literal 8432 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/hdrs.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/hdrs.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e8eae792d8b43c00545a7913a1017cc27d00dcc1 GIT binary patch literal 9599 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 U`U#W1;)VpCE+(2BHj$`~Uy| literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/helpers.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/helpers.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..39d2e8ba42438d856b586f6c07642beed60be34a GIT binary patch literal 50446 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/http.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/http.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..856e51bd3f66d66770b5b9df57eff479044fd408 GIT binary patch literal 2101 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 W)Xi}b6torA43sm1a<-C~k^dK7|C&Gm literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/http_parser.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/http_parser.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9a745ec8b7cc72047ae37703155adadba52e924e GIT binary patch literal 37969 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/http_writer.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/http_writer.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..564bfb6d40d9cf005f323f483ea8d7b94aaa87bf GIT binary patch literal 9445 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 OgMV=E-xdU4m;V5Da6yg$ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/log.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/log.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9b138a2b64a7f74b8aa0a01ff80258152f2ba321 GIT binary patch literal 693 zcmZ3^%ge<81Y2jHN%Li7V0aATzyLFp@%bE(F`XfWA%!uAA&P;CA(bHus1^cJn3e(A ztKs}8CNz0wGB~=12`OLhM)S|q^9E6JE)S|M~qAG5fit^N?DnTSpaei`k zYKbPtE%u!J^z_WU^jny>zzeYq#^nOq1!HrT z7ekpV89swN^~>JHDkeO?C_BbEKLu!QOm=BeVo82cd{TZ%Oln?Pj8A4#OmSvOs%}AI za&}^RYHy0<0}Hj4ZJt72ni`qP`@Iid_l$RqLBF&A@c@)Y^r$WI>N8;%FU>~$g6vW hSGR%d29Ioq`xPG93vz}Rd5o^`7&UN$U=a_{9RNCAyTJee literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/multipart.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/multipart.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9fc70c17f6737c69d66de9f85e7befa0f2c5ba6d GIT binary patch literal 52959 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 UFM3k#;--QkC2UJe9J(X?4qwc+r~m)} literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/payload.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/payload.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..874123727d8a23b4e53999f157c8f4c895e2fa62 GIT binary patch literal 24222 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 YwZLc3{OlVU4#mcE+;~PinTYa#0QS!|vj6}9 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/payload_streamer.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/payload_streamer.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..46b5a9c4de47621a1d3333817467700ad1d9873f GIT binary patch literal 4691 zcmcIo%WoUU8J}J5lFJoE$u?!lZmg{BBobYPPHe|^O} zN6{QQ%lXawo0;!9(qDUfbpq*cfBt)cX@vX(8?6*?R<`02A@_+x^2CuGxhUl&UdnkH z%2+X0Qu0bk&8ww&K3+=X6D2LLNyJecwU{jFd7ane#hy|spDOj{d!e1kr)BaXakM+c zNj{Vbc??;kd>=XnfSBtAO@vwLakVGKqfi}VnR$E^m*@8hfc zcUhf=)qQl|e_g%bk*7$u-zvdD^`Bb{#j@oXZmCkFCF%uM;Fdk3P-cc*X60(&dek>8 z-*BwJGAgWm({(7z>G~z;HGICzuq~gC84Kkq)I6hF;S~9T0xOq{f?K5H39f;<~Pc@m2m*UOdJ>`5FL8SA)4>nQCKMR2iW!#1lfj?7hOsflAFS-0C5_ZTk2tys(xTtwoNO6aYOLx1{Z?MaDdHLQL%LW zC2H_wRt;m9yoE4%33+SH6lthkwu(hwQ?9sn5USTehv-W*jI0!9F3o_pSavYQb>=$P zi>w?bnz|dNDng0PV4*@`f!0zkJ2DxlfK%XUi$QUpPy)tJ(C}%@k*VUu4mBqbQjptq zN1-Z>J91Z_N)uG0@vgqO6Dw#=;*OF}IvUj-Y%5L@+C5GT3{DUGOmQ&t7PBf9%0dNA zEH@b{z#~75&)*Uyqd}ECRsFG<}VVTqWLFItkJg%o&N zia{%)?~p0-NJ7D=$U#3$MyAjDU_R?d*awhRLdB=W!nST7Nuk<(d-clr^z|~EpT1mn zTyJ)IzRIki%*>f`FipLi(^uV@X&>zR?TTg3TeH-kZaRdMEg80Cm#Zv^OQqtz?VGuib_c15|H+{g^^;^1pg^sKdlR{?%TBw({lmdK~j5@|`Am7pE5`!CYR#KjpAm9M1FrP~l*ejWP-xgYzD z0^tEz%QCP&8{5XSM=~3Pe)c^8A1N3H8-fBaZG$=NerYk1!!=g`{t4eQ*+>trICtGz zyq+Fk&3ttT3h`TWp3FBJ+IW4BA3F?$vMJmbov3Msx@nfmP8GbW8KzA0S5>PhMi}yl zDF_J!)F+0)HH?AS7#a;rA`AmOBAhb66iZ_-!g0v{7XZuA*N`>!$cyyBdw%UFtImUu z>Vw~3PmeWJ=xxMFU*_KB+JSpNzFTf2uty{N2JTJOj^F#_%XA}&Jv!0TjUKF#ZpcXL zh5DQCHwcu^9A4}R;;eW=8*-GQm%}7O1ri8O-%@FOzqq0L9Tvj{GFn9r`7*1UlO`eALIRGP(HPM9a<$7h*fD zFlt)?b;gV;1St`aXQ@ZI_4{&!-UV1D-)Q}JdpA;-zex>m3=TCCN>bk> z0Iv`l9CR{p2yJ}@J|WD=YuS;>0x?u!Ji%5Dpqs6o#tm$fyII*XWLYRP(g368HXQBb zqrkuq3Z+LY=(?A%-V4y}9|VAV^$pj82McR&JdHo^JGb6xOvkmRw+9IL^>5VRC)MVJiOZp z#Vhd=EZKSopyi?We=-02`Py60(?{3SN9)?2KOuc}yY#tNMO)Y|>9?^D;RDG2Ie-pH zE0TJwe(WsD>DaR~yx0?j%#c!-%%WG*1dRN4ht%Nh6oU+ZAQiL~QjnbZofJqgK~>(T zaCaA9A)iV41V}X*_6nZ0o^Gn(aAZKch&D3VkKqJ=lrSoHK7YFZG-^j@h}}~67({Qm z8M9*;sXL>y9IAd5o@Cq?WmRF;@4<%cw@;Xaz+AL^-!y$Z6PUTNEX)lpa`9l-%_1-M zA&mKF0sakvS{wR<`n$y4#JVkKZY4E{dT|2dU20;AQ&PG*H5n{nd!v9&{*-6-A zhpIEwxy1wBSL53MQ=E?OMQE(HU1QNAJ6;4xC+ux<(5Cpl$x7@z^!n(XCj=wU;39+{ z;lL6AaIN(BM`6sGvH622Of;Xj4F5^NdT=!m{ze z9H&M8{9Ek@;z9O9HUR_3F#nf;jhG}!4f&u1jvL_}BK0n(@Y^7L%lz9Q=j;F5?*)0Y z-u>GkC+fTXUg(3%iAFpnLD<*{o7nfNJus|G=Nn`vY+~Q5_P}8xr`U1WqO?upr1xRjEgBRpy2}o##Q+4@76O_A1y+!6 zVfdf+_nq0Do!up6r?|ImW_LfHIj=d7?|k3y`_38uc`)eXaQ*xT|88XWevbREbW^uP`X!uVYLccMdwoU4yQ1_n>>+Gw2!j4tmFZ zgT8V9pnp6t7#I%@26?lN&|nBwEInA2-l6c9b{4bCp{n#aU-JKbWN;iTXR`W88^83rmZ>{RzBW3B;^=~Vye_K`ky=CQFtLi^cmR?9W25c3$J6LC#B zuW0FWih4y+jo|a~Dch}&!u?|jC7Cu@xR5O{mP$2s&IR9jFQd8uiiIkciE>1fAWikqXAIKm#IfWzX1Ife7jvw-}pa_bnILmlc z#L9Oo9>r^qEsebFRJ^iF@hSdN+=xeZUvmux*!X&kU|%A2F`b?;yLRRlZv-_q07I9j z;_9eo)DM;A7#f<0tMPG_Dl}Y$JT4X8R+GaHMAAh=N6ew{m6xAOTzFYa zq?PW8`0(ZUsG_|bH@mQJ;wl^XiLuGiM6ze%s^J+L8U~vT4NW(cb)u&jAEPIGLFTx8 zfZN`&EIhys7YkC+WPDs18ZvxCL*prVa*V=(p`mY2#>dPQmAa<}h=hoEh){10K})MD z$yt?prACO509D(Fv=iA*q_IeLBcNRcnX^85A9vtz-s^I9qMySxheW$nEwIx0&Hn&#}Mj z-l#c~&SLITxl+iSNqXQgt-<0&j7co{;D;bLxfyO5f2%JNHnJd#A3EO?q2%#1FMjh9 zF4--6WbbcL!pENBuP#ASA{IFFMX0;Gu&BF7;u<8b2Fb1rrPWF0tiHJU()@vadmNH;5+dK8IA@YDVw z$Q+jweRsvWRk1GTY08CLa*_I6@Ugs?bJpMIoKDwgMDmOTIH%v1wILU2$^}n+Y1W;^ zTDvyPYSqseu#ESJ?-=i85O~Y+mhhHH9C!(L=5^hXru4#fskrL71;=|Bf)6Y{Rt1^A zE+m`NMbM5CmnLHJMH%6|F~l9_(!0mog@jQaov6mmXHz`IBc1x2k-55)Zn?tH;okVXHX^ z(7=#9eDEv=?QIP7TTTo$FY_gFJnLBSr~<_u$FR&eO4EQL3EL+^7RrbJO@79)Y)y{+ zv2w*kT^ASJ>az}R!8OAr@cbY1f5=~V&WrQFFS3Y%6i}0G%1d?4R6LXC7Q|(1ic9%8 zZo#>1O_V+UJ=}a?MU?m8+@`gax3#iV%z1{5wIMR`@M@oSH934yO(j#4kV58sYtr~6 zW?xn&l%y=BAfqlSQYYo_EM_4|f!QbcCt-d~A!ZgJ(KVu`#-&8Mr));4@3r_nxB~LF z<0dS_g-wL_0>5l66>9(xc=(94b7|Z7!p;tBj}&BE zVIYSXitaf!mI8Xy9`Bh_feaM26k(No9rbA^K|Tk7a|kufxfbbe%YoIF1GoEsar&R0 z{@K}oem2`OptlTU>IObvYmDVNzNWcEa&=9M1B(NB0kNNd{<%il{r7k6;okQh5q`lR z5n?VQP-qlkKF#nx_4=^Fq_hzpRnmpDEAg>O#Rxz&TP;)jP?dTD1jdUyB2N9JNTMI_XVLg z^ce?|=Y(Jg*=m~ZMmkp`ohz{?sU!_S@P*kT^TohbDn6%)1rG?mS(b^E;E>G+BzT1i>*$~6!#VA zlRVehI`{0gvvc@7M7{5I}LU)Fy@_n*j!CWn_P400p1K&SzwwMxSKpVDz5>f4OA!(LO|+EX`AAeof|9iv=?nC zTr(9D{;)LJb(uj7)gil+JXsbStNF@0%blC$4E81ucd9_2_fYo-tbS@5dI<#A&OHME z!<55xsgm;J3n?+*^ndO*eLK>4JPB`uDotHX3|}nR7t#n6I`CUMF|K?ot|pGJ6y^u;i3viUpx|H4OYLTFFlVgm~b$Q$|zjRU=eB@`ekuF&<9?b2xhTt8p}% z0S?I&5MTI?jbSzjxI8|+cL-31W^Jf2zC{;a31pOVze6=W2?BY-i6LK!tVe2c;mD2Y zcV1l$cV)s|c_$a_y&E{P8aVRNBbmUFY~Z*aIKIx(kj#Y6bkiHN#rcp5O!LOD`Ljmo%MF>-tIgXaE5L-=RCoACw=mc;)tx* zx8|L=xld#C8IgGhDK!8Fr#G|~ZOuix?nZi7BfV>NjZ2R2J^jZ|zk6U={j8#E*&E*AOs8?F@W? zGh9K0I?k1e-f|p1i}hsYv)f!Vu$Hh+D#a9PiV4&I=o@iOOT+G%9KC4z5DH7YAP``O zYGjDUVSte5S(C{3jP*~7MVd^GVJ*QjQAh+#peoZ0xsr%8TZJ;2vPm7C949x$)I}u; zgQU~S4GkMlj9yG5KWl_(l)?}ty?Z9+P)S~>bsz{oL19WLW58y3kgZNI+n~7i)HL$G zPx%S1nH-o8ah^b)b36C0hobYo;^%K%T%;`tg#+|&r=@{XZJj-?|GKRtc7bAPu;ESTCM8>dT-Cx z9n$L#Wy6Q{@ZpT-FibM%5tgq+sxccu3^t4Z9U|*3%;SR1skCeX9ptjEO6)ny+ri8w zi$_qCHD~3sqW%@qEC94joK$sH`a>qRe1$S_yOwjqtRo#RRb4JU4g#X2$?06UW*m?k z&hqkrbHY3~!jtO?&$j^CC4z|Ts)BdojIiu4rrQ6)Kf+xi`$jNpWtf{Qq%GEu~2))`epCpU&ddy(=sf0LYA+$#|RLkl(s+KkQ3_D7BzHRlSO z6TIP}XOkNsCa4PPz;1^+YWOCuQamlA!g8Bq%MDmX#;&G`Rd!iRkMgn|EgMR)^8H)X zsvQ7MQ`4_a!zl4BrlX@U@Pmqxsei7UqU4+VLqGWVC^SE zS)D_I0dG#40R|?su`gDzi4#d+u=7;3kH{M!F{k<_g-H<@L57GSx6IKVpg0e?!Dwih z<@_2%PC@2Gt2?ePpu`>gv|nO%qo?csdfmVEu7B66e^;jSaMpiB_aB)XSR)&H$MR9V z{ZQ6@Sa%;LonDt~+5x-xZqvTirhU0U3(!R~fC>n9Pnr*`2OIUEbT`yq{_}pJ7rs_7MZmenq@Jk3Gyl&nB6LQn$>`-Dh3=%+_6d*Q>*<^2$mI*&&In~hUD=de&qCT~e&mn8ixw!G4`rB}F0vOU2=0$VbV z)1yj1Iq1EXsk+Lw zPx%vmz`rAw$GpkkxCo6TmMWeRW<(mJ8)={++ApuVWWJ&uHr-ds{IGUZl>e>!@nOXY zDQGiuL((vhd5kbcaaASmHC*QA9|ZZ>*mS6{BWT7w@ddy43;u~|hxEjB=$pyQNdn;v zf_F~Wb?%koSK=OFGW}d|E1Sm~Oo>TY&S)4g_cEWN zy~O8$+P{&)ah9v<4N44G#2QWwhh1<&2D=g(ZDt~Ze9MOK1#(-PCgc>A6fY}RHN(#i zctE_vHE+0>Yg;2@bX-ZtNdXy7>WOBASucjnF-eeb+zP7GRGo*M*9ldTHG)Va){BC@ zz985EL+Q{CHg=%_H1*Gr?LXqDJpIVW>(fge*>Ia4 zZbK%2c=7LLplSTOa$)$oUBTwH25IpU{IiSc#q>Mpmt%k4^P`^Zj$VC7Z+6=OecOS| zwgbSj^#|cUZzPG|NP4*@O8)ca+?Lo%hrVUsymzriGjOf)2i5%^EA98F1>Vj zTlea=?(DXG`nG-9ru}-;{-4VqJ@(g+|LXDV*S@ZQ?d#b?&*_J7Hh^VS|eUs$uk#y-R9?KwMqu6FSNfajC5#F90i~W7GAmN|FenD|@m{v2H z&JQS&P+h?i1_s$O|MJ4CH(s4PxhDE`ar^SFtQgb9SVoMkdFz)R&3L7(SAxF=J`!i$ z@>4l~J*+3}?F4GRd-nR-rGac}$ z$}<9IjBJ2gAOCox-9PeFNk`W_qu{# z%lQUyz`VfM;HM8Po&tYaY8wiBQzH+2%a?JYW$;zH1i*=WffMP-E>~&#kP6wv_(6)f zwdyk2tMyxnBpfyx&Mh)cQz6OKe}X=#jM+j-Wy;2g>bppR$A!j(Z7kY7F6wtEmdO9Y zPx~2&$x-)$b$akXHh54E9^8PX?s@AMNA!lStaq>O-AiJn?zZzGjDu52V4NZ$fds}W z-j)(J3NglcSXRb3f7RUAA>8Q@`*yqUbn&1@ZBaMcj#Qcl$E*oQZ)xgC_&j(VWb@4s z`!2Zb_)sX{P@n@)usp>x(+38W3AoFlw`80E(iCZfMpzsE1vB(F#E`dmI>>}mi(?QW zW48pAu&N=Fm)D3ED}{+wa0L`~=m9mGq@_f^;o-~0Z9R?a!6>yRim(BwNnP(C$ zg|t^1O#tGNj=~9uf{(YzZ8#r>jiTL1*emVXW1hr~G575mbq{)0aTKzASf(icX6+yiNx3SkGcU33^EDaTwD9W-2K2F5^!+q}^%>{&cE;TTO# zZz&(ck~d{EwVl}V0-pMLVF$#;MYk^X!>L@;m96R0Yr5uLxzP6c5k0g$6FP+NavEgi zig}aq9IF22JmK$#u7?({WIe6Wx*1PvE?hq!tX_^JB>o7$2NNJ~^X7~!aO(ce4*ZmJ z+r|#h@;ntY#NF;8{X{>eiLli!OyJzQb9gMJDe&w63N2w0$aGA>k5xFeGi`}IbEHdy zSj^Fdp?pBTq{2|08oW=@ z`?o9CO?8W>S=ax2;jaEA8l!#;Vw31h6i#w*8$nfO1;1 zg$wZ8<`Yko6;QbB{&jl^dtEjd@3QBS-D#U&dBitQd!G(Kb~}tmEMUC1Ak%HFD7Jv( zzM@R`PygvgGM!+&`7)g)&?{v3Fnfz|Bj8?KF@+qa7OfQQ6`4wGRGION+JsIS?&2$Z zU&mePg}Z8dfF|f4#lA~Y)`1MnUCp2fyaIf{L=%r{g1w2F4M&+rqp5yO|AIiyW-$ATMn3wt$T zR!rMAy=O!#)ohD1IZ)9%8#7ltFH%-h={d!k+S0ad2`nVrCP$^OY8p=|w;=HXhI8ZX zr1J5pK>4nXH@q-ffOaNv4z^qtqU{@uDCK-=Yg^ygc0f!en( zzx#Nmz8BlWy|g{ti|t_~0q!@pE{-nAnTAJ~&x4rXl^4vv^H1mM8|P2XpTu53CUAhh z+YV#{2lT*!#UuCp^?1-5S$~)A@4{&&@3VYvYb>*M-^%mzr`PJ+mfe~90en|vklW+t z&HPD9ab@a{;R~Qrf9&=P<_$e&E!eo^ez!Fn+^+|*hasTKLPf_j^~b5A^`Mp3{f*-*P4YR`B!`2G%Aungn? zmi#C1M-|MmY}QKdC_S~4?POExhx z&333c6dWSuz_{=C!3Ba;tpwe(xc#XgC95Y|Re_XwXRLljZ4PZrK zW0mJ~TxgDca$HTO__alb=h!Fj@bQj3_kW8taeQblNS}4CJyZV8i(YEV-z{kn_-Ib7 znLBNMKF_(a@yzo!k_*<%oum&9W0baFTwLAOrQcgRz4F-YSM;v_%+`Lrb|Aw=@-8=z zchsxN;xqRt_Ont_oj^IO3FSmAHo%MNfhdpd35)DG#JA=-i>N&3@LX%nI~@EWxWIV4 zf5tf?#R#93NN+GX_O0Y87vJ{L zk&jROTKM>B{cF#$`x3F$&}P-(;G33ST)u$+1Tm^_>!D%6n|(!Mm7s{?@YVCX=}o`h zJcrQj*FO&GhtIHZiCE>3BfsBj>lSLu7Ap~9s~NSZ^jrEibOE7{j${VT>tFjOyD1T? zAhP857Hahn1AthG6j2G=mo~@4n literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/resolver.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/resolver.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..de270f3b04bd18b7988422f37273516f2bcc9abe GIT binary patch literal 7924 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/streams.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/streams.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..de98f47382ec5e4891c634d034552421ee03d1e3 GIT binary patch literal 31812 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 C4{xXd literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/tcp_helpers.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/tcp_helpers.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..036d3995e9eb56a943a0bf1f3bae694269696176 GIT binary patch literal 1996 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/tracing.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/tracing.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6f045a303ccfc554faaa04a1b19ceba15164f34c GIT binary patch literal 24319 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 x<-h{&VcvZNWx*j=l!@Ct7TieQL}XoQup5m6#W zREZifC1yy9WW<#?$82~#VI-BLky27dT1gujC1YfjtS=MvQ--X_9Kz^v*Kv5I8>pTW zsu%O*3Qpo&-!Tg*eK^%Y_v3U2eHv#v=rfRqsGl_klmTN<8HCtjEus$@=ah5CdF4EZ zDp8zdUKQ}9fVFZ4$MG<}fG@7|ZE-K*FcuzhIJX{Z<9-C(9B_pW?g)5@;#{XLaI)`k z`fxvvU9xNrubhzD8i?&nBsP9|u;EnmYK};>CN$q>=&>HtM z%Q5?Z(`(CT0(8gmgcfV}sZ8Rq7KaLnTB4=f5$SRW-9}pS8PZZX_7jiLukZ^V`nzGo5(>#sOS9Ym2O{G^60o2Hg+f>mP)TUE1S z;mMtJ%jf}kd$3B;em_|sDmmi2mHq;782n`c#*GMIZd~!w*jBSU}ui-lJ zZw>Is&HsY(JQZNO>x7*==?7pjwV|P*x6{+tR=+XH=4!#z;2>5vYecn8Qd~3bRa|+x zI#*s>waPZ0sH&w+^%1sK)v~!^+tthVb`@)Q-I}a!(`d0+g3~P)cjQ+3lgG>(EFh~& z9UWfE@0VT!3LO(>W);=I#Uho8MZ?r;I>Qsi;**-HA4wv2f?X34jK~lJXBjxhz#s#; zWAGUu)-3?_leZZPiKAZcP?Klt*j0Z$jGc1iVK;W6DFU~NJ^+Fc%==Epv?do-dt8QE5rtI>w_gm9-AlYNB9SB z@*Kx`C|>tp55?;K+YCuusEPhBkVD)G=b-!l@T}L`TBw|}r0kw@HQ-W5ihF+m)E!-q4WdZL*^DH+td_r<+4 zu6*f$cjPfQIbN5%c%~sYN{!t2pVy;@y-<(+nS){H@)y5PIHL>hg+*s@(e3@36)!jB z39;Sb-CASW=^s0I=yYFm(^HN#U>W6tO`cWBCyr(EfJJ<<&G9Na|jgGTNz#(mQgB~T*Uke!|pCp+TC^Ytiu{k!UK D+90bY literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/web.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/web.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..16e700ae67d475122b5c8efd8ecee09a2f3e7abc GIT binary patch literal 18019 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 z zwl%D-&)8bCHn<*PEeF^#-hCNKn4jJG@M?Ox`V zIY@~fG>);DQ~}Ep8@;|G-7pI8FL>jd;g4ncW9h<+^2bjmPT!?WD6ypVA; zW*v=7Lw7mn^3aO-Ho4hxEA;b@zY3+f;S4vN<%WUKIL|kZzjA!_*`?zdt~<+hrwcE= zZvEwU?=Z)F#5snynLqM04fmTr>bD@h!*`Hpe#Lhl+-&~UCKeE`^}=+M84mpg-Kx`} zDgO*dmvbqhHe>6=i*)-}N^eUc-D}OX^gvvdNHT*2XD8ey> zF@)m?CjfLGRvWHVaOX~qnW@#IQNdXICy~jEOeM2rrDPPTyD$h8D>VV#WsQlX?!-XZ zumN9VFKI+9Ci*;PsM2~e&w(bw(D1(>TT0zQb7Wka6HGIXkU+rmBEyDKMoK|II{Jm*FrTQiWldDlz%%n3MkrpnIUTU|1D~ ztzpyPIs&@hIMy_pIlPH{j?v?X!-tNaJT^EX{{}rQ(_m;0b_=8QKXi0%G65}y7yi1x zVCsAjkMTy~6px;g8D~$pV&YVS3Q{;s*Xo}z^k#&vtDo|Fj74~#+yN(4@G{CWjC7bs zSyp2_OZ2adurJX+jd3s0KaFuL(LasxF3~@YS)Zuuy-5Ki0t?svj({47)qc43xhbvo2lvf@+5u z_=kb#kni(=XIV5%$b;suSvrb;xM0;9dOusg#AlhhRX*Lb`xnD$ zW+cOmWSJ2l?s;2Qr?TGmB^PYuHgDG&TeUq0w4-BMYrEFAUhD4FdNym-0d3oUttFIg z*{=2M)SB9~j&3kN(AI6pbsjdcU~^PL&F)!#X?5iKg>3WIw0CRPzAa~_p;pFOz4Fv* z^=d5LurXWRlXdjwY&3+&kZo7`a(3!;FizhJzuJGZKHIqU!{M}VXV$SR=cHjSLrCCS z%T3RR7yoiG+kG(Ia4=haDC;=!=w~z>QswQ2Zll?ds%SOzFd7Z1Qk$Wx)MV%~ zS`4WT*!Om1t9!GKKBLOIu?a&MR;)aO8a55Ep=EVt=*oPK0djSMe%1mkQk-jf;kLOU zZEnyw9!@u^uhg%sTWMcuztWuH0$DDQF1$H2!!-h*g8Ro`ZMPoW&HQS&?U2R%YmNo{ EKU1und;kCd literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/web_app.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/web_app.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..55acadb61688cc82214107dc977608dae56b44bb GIT binary patch literal 28750 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/web_exceptions.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/web_exceptions.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..182ce67b5fa02dc982591469007fc0bfeff580ec GIT binary patch literal 18171 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 ZEoJ~+bS-g0T3nj9T?9*ViSnQ$0twMc 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 MH2r=L1Tvrh2P$dn@c;k- literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/web_middlewares.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/web_middlewares.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9243f1772893754390d9aed0c66a1c6b198cd13e GIT binary patch literal 6072 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 a@>)>E^Sql2t`8Iu6q~QJ;+Ywf>wf^_*akrW literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/web_protocol.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/web_protocol.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..275ab378ab57f0c554fc5391b4dc5b1c38135519 GIT binary patch literal 32515 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 K-N&CH{{IKeBbW&Q literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/web_request.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/web_request.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dbb23d0401c8a167bdc5fb954099c22bc200a3af GIT binary patch literal 41203 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/web_response.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/web_response.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..04c0c07806dd50e2eb2eeaab6184f4df4be039f0 GIT binary patch literal 38936 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 A;Q#;t literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/web_routedef.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/web_routedef.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f7ce75331d3349995e62a8ed1816ef4bceecadcb GIT binary patch literal 12847 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 lQvW}?$A6D>TfWMb3tiMTBJ=t;gz>vY>hn=EBR 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
    1. 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/web_ws.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/web_ws.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8dfd6465902255f5fe45025cba9db6239ff6dd51 GIT binary patch literal 31482 zcmdUY3ve7qdfx2&fx+%#v3ME8 z@zEcdIPMMZJST91Dawr~Pt%Br`OPC{_Oy&x*wZ>(!$`wa<4EIFXe2b%G}1KHJkmVX zGSb4{aYb9F+D6)#+Z}D6+Ay+Vs$-;s`AeeVsf{BWr#eSEnV*ktntEd7iK(uUF6J+d zZl2mQvW2-l(XCV4Mz)!_h;4Ga+Gv9J3Tro!zMfjEds=Ca?vZZ6H?l)08`&9gMt0Sx zFL06Fg1-koGZ!hH+@l5y<@9$i@O=x%{Sg1kW#*1>Ld7ebQ2Bi`!tt+M-^b&Js)rld z%hFXLU3FxeF^7?Tg6SL=uK9pc4~6Y%OW*YMwC(W3^jI|QJQk0LV;7>4wDa`U_{0o_ z*@kDYBEUL67K?{X>5~3qr)Hz^iGhjn_y@oX4q?{If*8Xy(03sg7stlq=i*{yZ0c!o z0@;Nv>B{l3==f}OEFKw+PfSH-X5*vRE=Q)*rLjnSH1fiDgq4+clUIzykbSr$UH0_3 z(f*UC&kYWYo*F!NuJ6cT+Mf+NHgrS_vm@-p;InDZ(~%43X2!2X;)9|%Bc{EY|7>JT zi0A{9dZkOAKGz?eiADNngh<-;^tn@!SZwT);*4DyzJ4{5c3+F3e(}*us4Sm#UmX); z5qzu*{^-o5OZY-_+BG zACypcSkQ86Q>Y1atwXJGU96_$gs176;iG2<&mBE|a$vOo^w1C*e0a34zaK3=jI8*v z+4#)pSUfIHT!^LZ7sZ)5G=(h|or%ZB@w#@Y82S-m@*7-)BkC|>KF>ug5vyRL(1tDCPyE{tA_bzQxlc8((X zOmuW~u1eR`XxA<^VkgRqxd3i(DR24BYm1(b;K6uv(#z9hQ<2fpw0m@PYDSoilA9kL z{mSfEG#g{3?9<-S(Xr|2nfMru#MtPlXh#-l3x=3T`M<-7yYLWq5TG_=U@IK4;{Z2w ze-EAfjiWb?zI-(0sk{}tIVD+ZaVM>{8LP=wwbYv7@K_fp#ZU=`E-yy_T_61zz3@xA zP8Up=3e189q}&Q<1GEc{J5Ip~RB!6q=@FSJkuqvSu1lu05U)0t6qE!gty=pZLQq){D=jx02Cd3C> zd~?Jpv_xuHxlW-K;kDWK>X5Dt{`yD*O1EPmw7+7_Bj$}P&K7a$ayJVb3ettL>2$4z z{5lHKHECsq3*wrEQ^H2nwlmU#`m|iM3!7fCjkLmTisY zcAftK{N2d27tbB2wKETAeUY8$&x5G(F5rD1>R6b zC17e9r83yXd{%=`<&!a&A*Ef5BcDU_S>dA^vy0_I^Fz+Z_;B*FTxcq17fZ<-e5I;y z-h@0on$HZMSMyQnG&8bmo=Pv%d^Y&}s!t%FO3cBN!xvEF=4~&#=WT+04)sBJg&NLM zRjR&u2jZ$UpA$Y}FxbUXYLr93)EssUeGow$_!xT(liO_Uut<%aMZBEjU^oa?WA-Ze zB}|$V(-UzvY38tr$9z1hdee^4YmDK91KcNZS&mVLl>%NT2ce~VbbMxd8jKsbtP&*} zAz%P)2%EWzl-I^4;*?U2B|l!vv8hg#iB0=ZkZ~xuM{{Gr#oTN#xJPrN!JBhuxnNzu z_yx@R;OQ>q!qR0*07eaC_C}G$g*s=)QR%3DAfcjE;Ang-b|vf+vW}1#9u}rZ#p_((2US z1Ms?24U|D?YG1Dsx_uW*RNcrzLoC~RwUnABgnCq8V>7){m+Co4&tR$~AeDqtEt{5O z|Fm~;K;}cKg98-PkjlPSA663X?x8Xk@yEC!jRxU+A-H8}&>z7;jA#PS!plgFKxMc| zjpn=@()$t`?a}9w|2`X8S`K($qfsw6>wTXiH!TMmr}QswLk+^#boJ=?*z|ZLT7Zh; zC=#UYN~|crBa$erFxw1qfWO&ywJ|W)QUs0i6A_7sVe$bRn{x82&bAe2Thh5fc5aZI z8&V}+xujky38#3U%r~s^Z7Y0RlHVZn8zg>1s;P}SvjM4Y_DUt~NObe`D&M@qHz)a4 znQxW&)>K3D;=s+*i}=gfIJ{QU{wY2C4C-MNF<2WTRJn@JEk%1weTB7eu8qy&7-GcB z1oB!?B+59qas4)91Vcw3rjb5IA_AI@8mdVud4e@m^C}-+;loM3Q|3D*zBAPpriN;k z*iG%wg`|b;Kr1BT2l*8LeZC;%= z38n?iXOmPiyA~|-mK)~d+}BL=mV{jm)jy48Em-5)T!^^~^IuLpoHrYFA`7;8ngg}j z8ELh-`9?F!)8=M##&0@td(B{~|vjDEd56BWescqeToCQKv-K>QK`Hu@Y;uS6lFW9o=SriI+p0a==6fV73m zs8m%i#(dLOHt$)cXRf8Kq?L(L<0`aY8NW2kk!B`0e4C4)VqTgUGKu|j0EU7z3Y$~B zfAMgUq3rSBoLICx+_C%q=wkoPQ!>9*;?NUkGr=b4FK-@PJ_6VP)TtEN~?HM|Q5y~NW7F|sVjjXEg z(K8QS&GUrr+5ou1l8PJVO$luX=-<|-g@tCe&VIjrDJT-u#UM$AW#{p3t>*E@xxw z#aftPl4HB=361H_y+e%pq{e<5OM=>3A=X;F;XQk?)L~neY?;MYr2c@qc{pqq<9Mb^ zB2bZuqhRC3c({gpEn{=Obbax-f8@7iZFrvDo$L@rjwVbr{@k+R8ZXl5z0N^a6By#AvImGK&d26n>dLOq?Yk5+F(@J`VsnR!twHQIzG674De6ZLX;Z zT{KeUMI?(&gJys%)`K%89u)dPjld-a?w*udd+7G|80cK8#B(bkm$j{ww1G}NY-%HN zmhuH;Uu!~;+xLEGF*kcY<^UL31K}(!Up)Nq(}?RYKwR62c*>oT*R57}tW}||&R@bIf!v@J2y4DD1eEyVxJDe%Jw&V-uk$(_;B`z1JPWV9q1lOa+Ek!V zZA|w9xEiqn+>*XTEjjoSerDhb`0PK_t0Ce?^Kg(+w#D_82a_0L#I*?$6Ab0d zE@Lki^ioz@BI2q@Og2X6(k`rqO+!u=K#$C@j_3ekP4FW$4k=tetP{lxURePitB#&k9wr-CrF|{sYvv1?|Jvxd!rA=-|J4c z9F<#+Ci!DBe@s&EjD<2#Ue-fog1eC4r_W~yuPkIT0*oN#dR$}|%usV$=7e*RI3vxZ zbBv7BGF~V?6H>ah%k9o`5TSmiTM3O#Uk_DYzP#pu|jF74&v zAuwZvG~xt-eBHro2%M`g(uFw$`&}f7wE*1UGH$L~QNU5xG^{uqlFpFq3`y#(%%lzo zl(bN7AQdz`zmETpd>FjnHl5&1c?9ESl8%r-xz;Bg^Csf}dk%fFU|z7qH3E>&uP3O- z3aC7@|bag(3eE-sMCU- zn9i~5(U~zpRaQe`D@GIsT0DXB(+>DyV-NuixC$+`5|y@r51yFL3iRR<5{jECwLPoz z_87AjBZ$mN@>vz`9R$wR6yid*#6O^S?gBjeEAFq9@hg`!N+q4C@+!HU6l)J_8^724 zX7BQ@WbJmjc6-uUz39BvzSh|KoojcleebJpes%d;vT>K(xJ#obY zL<^Rx5*^Ejlg{n3bGzi+p7PYKdYV@}%}GzI>>+J&;Z6BC>lq@>`E=GOU%))n5o;T%vr~U8nomx$dUt;tX`A!a$MBl?2 zTQF~ao)e!F9IrszQ9OmVj>Q#M2?|bQ=>vKC5288)+!wuy!ZD{$LAlm>+k(Z!P1oJ@ z#dF2zbRvR_DKRx2OaWzjoZi#)DEYldItamy{wX)$VadGxyWCsm!d84NT+tM;##UKy zxVU+T*cNZn5Sv>^Z{sk&Y4izvcI+7ITsrUguDMv9r#G~4@%CJqlbSB4l@lvWoZ-vY z$wlD4X1>O~V0o6iW-`=S)8E9O(3PO+XXYJ=qB<8Ny@+qiy*me|@p}`&Tx`x|%pvcM z+FZJv%lO8EGrlJmXTW=HRuxQ!aBbuXHbZ#5n$Ns*!eXq+f=lo$xCQS*33vcahbKPu zSa{T^=9`x%AMaCRp!MPf-@P&;jb@xf$%1>nL~M%p>(Z78zIpdOzi|vLl+KsVy9{5X zl}y~=yhZfRTk=w9)PtpPA--hZeGxN$xO@mUf{_a`W|Wxb<_-?cgtWOgbpFhdvwZ`D zA(&3?4ZXPFCMGb{eE#Ys5lh$2p_%FEb>bCss`lnCESOv4Fh@)~W|d@f^~jQ}_6GZh zkDVS0WrNi`4U3d^d;n=aKO$k^4J@|Lb6;#(FzL-D9#4f~?1R_LH(SBo96+XEL-*r> zC3{#4UWHYoxob<>#uhg8Ld7TUp6CQvN9ZUH%x%#c z4#1(l@mDAzwi^JvDrc$pV>-8z){r@!F}|r;@&A+1H%07?Lr*;Sf3A$gK=v`A2$`ks4Joz`!{|%rL`=yWnwG;z zERsNprr$?oq;gennkPCFnLz@QZ9zNZF`Xu`5YIGtlo}!nDR-_%*#>8oeqUj3b z8&3_MJqHv^ml=b}^41cCNvQn-3{-b^r(G9zb_>kNHSN3ro8s8`!~~>FW|B*B5oYs> z4;qVIj!s;FY3Ajzt!cXwEc#jfg$bBl#?y8sACX2_I$$i9EL6`7ix()W+88zX%<$k4 z)%Bc6^irhBH0)6XT*f#528A-_xfEiIw(=Ge-=W+b*&a+=u0*b<-DBfqojm$H4558k z;)1{)i_l6K>kW6VlUNU?-58x%K_hcbxTndIT0l^Yrd?IoQ=ZDw8tg(;{Ftlzw4tzq z3}Tl+kAe1ft~_{q^P(eFQn|F@d!27~zAfC1-anKK?vjJMR)hOjg8P%fUOCvi8XQ~+ z4km*~dku`q^7M~S6{?cFldizq<_iEp)eH+@^WX(3YW?Ry~UG{I!xNPN~ z4>^F331m21sVC#%_==??-#hWzWE0VsG`839NWYqVt7zKrGg zt++F0b?iQ@Z+&}MZaXN~_pR0+S*btrz9m_IQm#Llu_4KaL<&A8uy_h0Y;Z${bC>!V zxMfR~S1%3RIW3iU;!ZWT-a48J)Z7}xYIk7MFWg*NQ1&&Y0z;_)VD;_OA3CgMs3rjF z1>iw*ztQ=6=Ual@u=_!C(!XE!@2A%HOTmp&3ElW?sr|@!KxNwz^K4QstFUNR%Eiz18y8MY*ACIhJhLE;npX2D{~8 z_XG1vaIX~HyH?pMZ5(_s4nTM1;bi4ux$>~&I}H6@?Y>7p_g39}i4+^Bn36+I6c9$^8XvQDmOTjR@bo?I&bUhvJ}ck1rcy=za_ zbS3%CGQWA1-?_r?O!B*BemC`>oBGfFmu}yy?ceOU*?~56l_QtB4L|nQ`f!4h>EZ6T&@_Qcgbtyi;?n>ak&kc-s zxnrdL`m{CpG(!4~1uNu& zb(RL8f;7l$%zQ}W&x*^Uh06)ZU8h4)>zS`jA&mvTgT9hokefAWG^bo8i9ykz#EGxS zUi!3Ht%Otq^GbZ*5Am;D3l8u|j*Cn~HY6THAQ%TW|NUEXyOs4rB6!M%5XD4LB&waZ z&t8QB6RHtRapPHSD4PV76~$jc8j%?Bu(KGw&y^ywl;1TZ7#+DiAsZ99K!^KWc^Z$on1ae3SEq!SeSR`t^E#0ZStK{1!7jnc--LRtcEwq{bR=gNM=Cd?el%-@7O0g2ZE|4qqATUCmb|UXy;c@V z@#QjKzjXcnZZ-t`ZVUlGjZwdQ(VlT~zUrk)vYBu;GPZ}!dLn)HxYix;Q0FpqKA@m8 zmil!_Om?IQSFZKY^ZSVYp_&MaKQQ?ka^_TRagA99Gi}P*_COV51)AWE+)k(U5HO($ zA6jv67*J5RI)Hk()pT%c!t=d6#a_YS(xH5D!v-Nwfuby}W3haK!}nwF2`wYPV`4aW z7;60?c$HQ0YvejlfaE0wbBQTecoMb=itRBHMUqd&aRQ9dabJliob^d(qwFM9 z!a81V!CJA%S*z+?J|b`0|6un0ZmH@_vg(Xnb%x$fIlZvkTy?grI9t~ETFk>Ims{nH zJ@3VT`jW&ymE@n2`KK_kxCm)opuGf~oXe-Zl^9GqH_Fb9l6o^tHjrcbV1~axg(GkM z&l}h9kZiq;{roi(6cOtX+;xexdBLn-BNRwU3F zD`2g>DbcnZNS1fW7q3Ih)OV4AK`4bu}PurR{TRhY-0qhCQU?x{=S(7+@GO0*4Vp6wA_iFeEUB zqn>1!GHbC=Yw?w9S|BoxVkmt~a|=hXS~rv3JsZ-NYC~kRL~=QVL*3Hfv5TSUnGnRw z*+>Ys_cP-Y;BSP`wTbxU(3ihV-}B`!hbCgM^q8F%HX$hcaZ0GND>5SFRs*3+AR@sS zoU{kp0@}YSjxmcVb<+5cl;AH35G%lv=1&?QAYv}3tfNy7h563%rKESK?A<9jcm6GL=NYPe9vX|U zQpIZv2eY;ge>I0ZWO?;f$=SflXCUpEQZ@k_<`=@7ujBtCvH~ky*1Yi?hQfCEXq2(8UQ6Te7nq{--EFyaAvt=Km+S^?ElJIagWO zG-QcD_WH3CctctFBgqWZzL8P;ok{;L*}qHTcfla-W^~olxZ-I{IFg{|_{z_@7Z5eVf5<5Jni{e?hRJwLU~Z(bhuh7mTgN>>U1HS}ScO`wRo&A}Nd^ z-(SG-`H@e*WpBCQ9+PM7<-eH*-Y~0dLX1s|4i_J!A z+)IQEUquF=I&{{&HA}5;Taw;Z*-P84T_;Ry{#vQ7=Xc`o4g9OQ-=0g>9ZUL;%l_jM ze_TJ#tjp&gJR^A;lb*w}=dk2l_g01*4Kel7Q0IRk{#OK~ZImho6*nGZ zqBsWi@Kj`KM!f#~MC6+I-;hLnMBu*@_yoX+O_1!cIfLa=~4t z>)s5puwG#kW~Z*kL=$SKQ7E`M62BOQdI}B|%@S}IUS_aZ`P2k7!DOUGMQ8%H&ZLkX z#OnV+kF1oV4O>>JJUPe38gw!?GhK`y&?0YAV-pXfG&a<|FjJj+b!usFX)w|HofCIX z-0xVNN_zImo_&&Y-CG%b)Ew$XBat-=u_S7<!Ag}QZx*RGoY#ExXSNXXRmSMnu5?zH6u_|ej&G2Ys<|6GTii>ZeAdwMO893)6uf+Glfc;yOuTFk5 zdNT@x!NNOLLs|;YBK{OSwcw;0I%0*`AMsZSI8iWjX_68(qedJrpwSDvCy%MiGt6f5 zoyOUqD=o~L?J>H?#F5G&hXx4}ObV_-(E{CSQf=3mdQC%>oO%uG(?Qs$6`g&*k1~F! zm1E3p`UNN~JX)mAfYuPIDeo?tq0(rgS`@c}DQ-q<9ZV3%qsIO$hIURJgu>e3{1 zT5vU0zGfXtO)UrP`62yY!4=<_3(9XZ)Jc2a*oTOzRNoUT(Q=yQi5f~zBNoshR_B0^ z@vXTulbY=ja@6|ASdVV*>oAGdVWU0q7g@ zcg-BX1}oyXc4#KJnmK;P%DbvlP~&V`^|!A0TNA@D^kqf?62HChPF2*%6=7`YEw7Qv z+mt)y4PZ_$ZA(?wy%Bvq`r7pEY01}Gct3iy=Btu@?e99UjZ5;v%-`(7dbw)$|l!w&tyd$&X71QVmVY&M@p6D)LHs)va#z56a|683*2`r<=^tni^Ok1gUbHw4tr&vy#}dA*r!*s4{loFo05Es%(qB96@RNc zV|BTz*Q#3Os!hwo_r92{+9y}-qXypi7$8;GOcop8Id$ihR2j~@Z&{#T*Jtw~<@)hs zX8jnY7fV9TUZjLaFk+~by=}SvXRiMf_bb|unJoX>WP{tF zm?RFAc+QWG17L4DZ5D(}x!9H|kcO;ponc1dJFpb0sUwN>=@o1^@lM@=f;Zs&65SvM>BsP_{DJ=j-*U?dEdEu&Mytl|McI1vO4DvH_xi zx)yATyot?Wjd{n#U}FpJBHJMi=wnBwU&sGPm9UriOo1^^yJZv@ak7b7JsjdH&KlF% zN?4e9s0oFlacv>bsG8-f34-Fzc^u`I+ZicX=b(KXH|q>}be0i%(Jp&LKQQ#up(kcqkd$3{#tVq1dC51yy%zB)9 z>C@lK+nn;4wIrh-cHvw-&bSytwG=o~RX}CIp4enUvsLy&og-N#i6-8m1w(4Q{%L6Y zCN;)5rkM&yH!9Us`Iz|+^JSVc#yY9tm7zad)cQcw9bE4_=dF{iYP!O&%h{OW@Dy&c zO-;!}=b~RO*ze_S;xc~y^e>~t;`P<=AN38bS6@TFXk#M3=F`utTgnFY8&FCZ-=vK( zu^D9&k5q82-$ur7yJfj~aNTk>wG_&A8Ok-|z2|6?YuKg8@xybS{WH_!v!X}~cXZ$i zZDq-xm57CF*fWsQ8R6KvAc$^Mc&<_7fOL8RO37F%q3bYo|HMP$K{|kNC)?G|6w`_@ zKY~zY&pXo_oFgx_hDg(v!jv+x-h)gOsU4@ybK*6MeVPCfTXsT&$W#fWeqpMFwE6T2 zg@Lov3xqYw=6SnvJh@1UKSj&@ZE}@RDpGXQo-#!dp=bqYUo=w(h+jZ#+Ci`5DD$-S z450WNz40MMSkIguI-+j%JxIZE0(}Jhln2|VPy7gsx^O9WUD%V&&Y~=~!8aR4=e5Uf zV1mi1;EU-A3hnz+!6ulZCt!fTchQ?MA8=KX?Zg5Jb7xI!mCaJinPlaYa^;hf?@4AQ zmEr8A8*w_#EicT$w(^4_&zyR_kGGI&f59+Lvc)~Y%rUq`B} z;&wfg5!b51k}sUGHkR&(ec3JR?b3|dQ?@Tv)t=#;6}w@$-?~+9+5Mm~*>X&7Ifi#? z=&XUy0;!Ho_xRP0Ju4l1k{$cxj(t*d{=L)>(O91kMB|zsh{pP`$0+J^B~e7_pH(Ji-ZzdxL;-YZw{m8$nb9=CCA8$UZC(xOo+_Mw{p{n5|MgV+v^JWJUI z1_h*i6>H^n(9M)$6;cIjEnRmH+_K8PP^vQc#^mdhuSIW1C0}#ly;c=^yGCx>dcXTY zAX#-lt~wz3vNx;)DMu(uRFGn90+m;NO)I{pw>#x#+D#z)dL>`)V|~?U7n^aRIKlv) z^OfIx;jKM)dL{2h+*+}Tmb)EEU#INrlzg2Jt7>o0Lq}D%Z5g|9m;>4@Y|Y>J=Emh6 zOB<8Ht#WXy6ew~(N|gm}SHJbFT;C;?(XEy6cIVx$q;IS2+bXd;oAAz;q_R%j_pLwj z;6Wce@%luT5BE>n-Thk}KiOg-_jVJxyLZ9;)6Q0;|9x-!AXF$jEacwX*Lb|e^0QhO!PY*< z(XE#EJ5BJszqOR$fxh7J2Fo8-Q_vqa*Z^UXeGp}9OM#$>xuw7iJgQ`ufV=R@U%b}O zpCr}gq+`Q2Qc}{eYt|$_VKB5=?>IbNPRNyLJ-dvOjFD@Agr><0u!yH=FMF+@11U3x z=DN-*Q-=`Bn!jN~>fRTd#07Px#*bqtzlhN_jO}%>jA)=~=n=A4WRnCjt%vleOAGZ99sNOG?my~ zfC|`+SjpsgLQUUeNPwTY;bLDwR-YFg~*Nc;C0 zh(Sg$ct3acn}M=eU^s(wZ;dI~*cBV`7I@+odSuOFs3J<0sKN8hVtBO$nPp57wW~h< zAT{s-t%1ReR0dZo+EyysmM=*aZOMwAa>Y&wM!d$Gj%y7p&fXgS=8HF9gw2LBW~fQj ziwGiX8j{_VrqS<2FEoB3GS!R~Kav}mK+(kvOUMeA&cIXG6wwlYiX5SF?Z$)AA%oJ{ z#@;Hnl*S?s)Ay24rXbXsCn(kSCOrpb&q2v~&^Yvw3M5eWWnheQ0VfIoj-a3pkNW^F_#q}PtzB&>*Xr_ULk!9xDTYt z?KFbM5E#d-y39kv82)FGfpQGk8FG=*QT!(WhB1I&MPTQR6%!P*QD>>?2Js@>5XMZb zN(&cSvR2~Q*ah3xJDZj*Nq&>eZ<5rTH0rI`GsM~qy}1P$;y_CA8&s`dBEUiv1TpDT zv0owy9};&{qCEu21R`BJilYWD#V?PJUyk4aSKCEU-#GhKByk@lB3x9=eJvBPT%*2M zTH_MAn50j$h4>1A7Xi|x^t)O)BY|J0h}Q@-6Chj`?+~EjD6SA7>L7lX0Bx*Oc3%B^ zxY&JN8_%R0@(FtQb zoG71aX(LBnXQraf22n}_cFtdwagf)^1)CFXcN#M;^0~P{b*6+|JXc$?q|Ly&mGV=K;RXMo=TvbphrIK@dGF23oD=*JAWOCSAGMo|kEjFyB8-csr zMkfXqz>Oi>rVM8U1177DPN+2i-fSC01_jXRM8?YtP+;Ks9xNs3Sp){`Hi*1N;B(s= z5?{cP2DS!i2h<&St`DlunQZP<70x~($3vF~<_(GM*mNUE-fgmLd&WlL8Lj|Mn!UDA zqBFzcalh?><-w@5`=q?>6br})&0bq4D}*10nYBpm`%32B`Z`6HmDR-@Sz1!uROyd!HOu!LQ6*z=kB0_CR->6bV);6 z(x#Hc>kR=#n*L>?O8c84e(^ojva3XaV@%v#>`# z2%2n-*a&_~uEoc~oe%65TbOV#oPY@g9`~_9Kn>El+*V2kK*{i+WNMJk#oKI0fK&vj zcJ#d8@u2%hU5fkt0p(c)dTh4C?9Icb#CeK8Y`TB>LHtM4id#A}tT>9m0N2`)aX4%} z7|adLcSbTL#J2#@-%!))#SMsGkyoPzYzquhVY#) z;Yf@p&u1)qY#2u>NP!$sNNVRk<#~LFJsCEtiE_y^&tvp9C2Fbln(iYXJn{i=v4xhe zP&b4g2<(v$+!k90h3SENko}+@!NfDmk-MWAj@<9LlxGn*WafJN(fUrJQ7TwIdjI^r z)6D-~EElYE1-L#F(Hg6bA%y~#FW;ZNH^TzougHs2ydG{t=iSNohj9{%jeWiXQq?Ui zB(<;qy}{q^W$uSAK4UYaqAY4Nyvf!F?FAuopJ^GmNY5hBZlWGC0=v~#o~WUGFmQ~3 zx7(gr0u{$&8Tf|BV*tiGC`?0-qQd`Onz!B~@Dl=iXvUj|D{aT_9~hh{6S9@!7}tP_ zEj!DT+9GYGpS(=Frs$VW1^m(}JA_F5XOyUf;w@tr#u9n+?Z=dp>>0;JS{VE$ zDt*Zc(7NL8n4lEFPpQVlI(m!N4%1HB zzl3d|F_F#f#3rOYkbrVOQ56$Il)8yxN+>3KTr1;h@I$67L@^;0TPWoM0a_TrPiEnO z0k8tf(#cM0wjRpH6jN9o#t$5zf}E*V;)41+#dS-??iAN06}wa19;w)!;#wu+o#HwqDoLqRL#MLbANR;2%D{*1mNiGcfZ+6}Yyi$2<7^eaV zl4*O=v|ToB$1wt?DoiT{00&W-s&EjMsS5M2xm!!>`;yZH!cZJ8;XEjc`FNdphPwY7 Du87}) literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/__pycache__/worker.cpython-311.pyc b/env/Lib/site-packages/aiohttp/__pycache__/worker.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5e058c9e86dfc1094374762a12354129e211b825 GIT binary patch literal 12202 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/_cparser.pxd b/env/Lib/site-packages/aiohttp/_cparser.pxd new file mode 100644 index 0000000..c2cd5a9 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/_cparser.pxd @@ -0,0 +1,158 @@ +from libc.stdint cimport int32_t, uint8_t, uint16_t, uint64_t + + +cdef extern from "../vendor/llhttp/build/llhttp.h": + + struct llhttp__internal_s: + int32_t _index + void* _span_pos0 + void* _span_cb0 + int32_t error + const char* reason + const char* error_pos + void* data + void* _current + uint64_t content_length + uint8_t type + uint8_t method + uint8_t http_major + uint8_t http_minor + uint8_t header_state + uint8_t lenient_flags + uint8_t upgrade + uint8_t finish + uint16_t flags + uint16_t status_code + void* settings + + ctypedef llhttp__internal_s llhttp__internal_t + ctypedef llhttp__internal_t llhttp_t + + ctypedef int (*llhttp_data_cb)(llhttp_t*, const char *at, size_t length) except -1 + ctypedef int (*llhttp_cb)(llhttp_t*) except -1 + + struct llhttp_settings_s: + llhttp_cb on_message_begin + llhttp_data_cb on_url + llhttp_data_cb on_status + llhttp_data_cb on_header_field + llhttp_data_cb on_header_value + llhttp_cb on_headers_complete + llhttp_data_cb on_body + llhttp_cb on_message_complete + llhttp_cb on_chunk_header + llhttp_cb on_chunk_complete + + llhttp_cb on_url_complete + llhttp_cb on_status_complete + llhttp_cb on_header_field_complete + llhttp_cb on_header_value_complete + + ctypedef llhttp_settings_s llhttp_settings_t + + enum llhttp_errno: + HPE_OK, + HPE_INTERNAL, + HPE_STRICT, + HPE_LF_EXPECTED, + HPE_UNEXPECTED_CONTENT_LENGTH, + HPE_CLOSED_CONNECTION, + HPE_INVALID_METHOD, + HPE_INVALID_URL, + HPE_INVALID_CONSTANT, + HPE_INVALID_VERSION, + HPE_INVALID_HEADER_TOKEN, + HPE_INVALID_CONTENT_LENGTH, + HPE_INVALID_CHUNK_SIZE, + HPE_INVALID_STATUS, + HPE_INVALID_EOF_STATE, + HPE_INVALID_TRANSFER_ENCODING, + HPE_CB_MESSAGE_BEGIN, + HPE_CB_HEADERS_COMPLETE, + HPE_CB_MESSAGE_COMPLETE, + HPE_CB_CHUNK_HEADER, + HPE_CB_CHUNK_COMPLETE, + HPE_PAUSED, + HPE_PAUSED_UPGRADE, + HPE_USER + + ctypedef llhttp_errno llhttp_errno_t + + enum llhttp_flags: + F_CHUNKED, + F_CONTENT_LENGTH + + enum llhttp_type: + HTTP_REQUEST, + HTTP_RESPONSE, + HTTP_BOTH + + enum llhttp_method: + HTTP_DELETE, + HTTP_GET, + HTTP_HEAD, + HTTP_POST, + HTTP_PUT, + HTTP_CONNECT, + HTTP_OPTIONS, + HTTP_TRACE, + HTTP_COPY, + HTTP_LOCK, + HTTP_MKCOL, + HTTP_MOVE, + HTTP_PROPFIND, + HTTP_PROPPATCH, + HTTP_SEARCH, + HTTP_UNLOCK, + HTTP_BIND, + HTTP_REBIND, + HTTP_UNBIND, + HTTP_ACL, + HTTP_REPORT, + HTTP_MKACTIVITY, + HTTP_CHECKOUT, + HTTP_MERGE, + HTTP_MSEARCH, + HTTP_NOTIFY, + HTTP_SUBSCRIBE, + HTTP_UNSUBSCRIBE, + HTTP_PATCH, + HTTP_PURGE, + HTTP_MKCALENDAR, + HTTP_LINK, + HTTP_UNLINK, + HTTP_SOURCE, + HTTP_PRI, + HTTP_DESCRIBE, + HTTP_ANNOUNCE, + HTTP_SETUP, + HTTP_PLAY, + HTTP_PAUSE, + HTTP_TEARDOWN, + HTTP_GET_PARAMETER, + HTTP_SET_PARAMETER, + HTTP_REDIRECT, + HTTP_RECORD, + HTTP_FLUSH + + ctypedef llhttp_method llhttp_method_t; + + void llhttp_settings_init(llhttp_settings_t* settings) + void llhttp_init(llhttp_t* parser, llhttp_type type, + const llhttp_settings_t* settings) + + llhttp_errno_t llhttp_execute(llhttp_t* parser, const char* data, size_t len) + + int llhttp_should_keep_alive(const llhttp_t* parser) + + void llhttp_resume_after_upgrade(llhttp_t* parser) + + llhttp_errno_t llhttp_get_errno(const llhttp_t* parser) + const char* llhttp_get_error_reason(const llhttp_t* parser) + const char* llhttp_get_error_pos(const llhttp_t* parser) + + const char* llhttp_method_name(llhttp_method_t method) + + void llhttp_set_lenient_headers(llhttp_t* parser, int enabled) + void llhttp_set_lenient_optional_cr_before_lf(llhttp_t* parser, int enabled) + void llhttp_set_lenient_spaces_after_chunk_size(llhttp_t* parser, int enabled) diff --git a/env/Lib/site-packages/aiohttp/_find_header.pxd b/env/Lib/site-packages/aiohttp/_find_header.pxd new file mode 100644 index 0000000..37a6c37 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/_find_header.pxd @@ -0,0 +1,2 @@ +cdef extern from "_find_header.h": + int find_header(char *, int) diff --git a/env/Lib/site-packages/aiohttp/_headers.pxi b/env/Lib/site-packages/aiohttp/_headers.pxi new file mode 100644 index 0000000..3744721 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/_headers.pxi @@ -0,0 +1,83 @@ +# The file is autogenerated from aiohttp/hdrs.py +# Run ./tools/gen.py to update it after the origin changing. + +from . import hdrs +cdef tuple headers = ( + hdrs.ACCEPT, + hdrs.ACCEPT_CHARSET, + hdrs.ACCEPT_ENCODING, + hdrs.ACCEPT_LANGUAGE, + hdrs.ACCEPT_RANGES, + hdrs.ACCESS_CONTROL_ALLOW_CREDENTIALS, + hdrs.ACCESS_CONTROL_ALLOW_HEADERS, + hdrs.ACCESS_CONTROL_ALLOW_METHODS, + hdrs.ACCESS_CONTROL_ALLOW_ORIGIN, + hdrs.ACCESS_CONTROL_EXPOSE_HEADERS, + hdrs.ACCESS_CONTROL_MAX_AGE, + hdrs.ACCESS_CONTROL_REQUEST_HEADERS, + hdrs.ACCESS_CONTROL_REQUEST_METHOD, + hdrs.AGE, + hdrs.ALLOW, + hdrs.AUTHORIZATION, + hdrs.CACHE_CONTROL, + hdrs.CONNECTION, + hdrs.CONTENT_DISPOSITION, + hdrs.CONTENT_ENCODING, + hdrs.CONTENT_LANGUAGE, + hdrs.CONTENT_LENGTH, + hdrs.CONTENT_LOCATION, + hdrs.CONTENT_MD5, + hdrs.CONTENT_RANGE, + hdrs.CONTENT_TRANSFER_ENCODING, + hdrs.CONTENT_TYPE, + hdrs.COOKIE, + hdrs.DATE, + hdrs.DESTINATION, + hdrs.DIGEST, + hdrs.ETAG, + hdrs.EXPECT, + hdrs.EXPIRES, + hdrs.FORWARDED, + hdrs.FROM, + hdrs.HOST, + hdrs.IF_MATCH, + hdrs.IF_MODIFIED_SINCE, + hdrs.IF_NONE_MATCH, + hdrs.IF_RANGE, + hdrs.IF_UNMODIFIED_SINCE, + hdrs.KEEP_ALIVE, + hdrs.LAST_EVENT_ID, + hdrs.LAST_MODIFIED, + hdrs.LINK, + hdrs.LOCATION, + hdrs.MAX_FORWARDS, + hdrs.ORIGIN, + hdrs.PRAGMA, + hdrs.PROXY_AUTHENTICATE, + hdrs.PROXY_AUTHORIZATION, + hdrs.RANGE, + hdrs.REFERER, + hdrs.RETRY_AFTER, + hdrs.SEC_WEBSOCKET_ACCEPT, + hdrs.SEC_WEBSOCKET_EXTENSIONS, + hdrs.SEC_WEBSOCKET_KEY, + hdrs.SEC_WEBSOCKET_KEY1, + hdrs.SEC_WEBSOCKET_PROTOCOL, + hdrs.SEC_WEBSOCKET_VERSION, + hdrs.SERVER, + hdrs.SET_COOKIE, + hdrs.TE, + hdrs.TRAILER, + hdrs.TRANSFER_ENCODING, + hdrs.URI, + hdrs.UPGRADE, + hdrs.USER_AGENT, + hdrs.VARY, + hdrs.VIA, + hdrs.WWW_AUTHENTICATE, + hdrs.WANT_DIGEST, + hdrs.WARNING, + hdrs.X_FORWARDED_FOR, + hdrs.X_FORWARDED_HOST, + hdrs.X_FORWARDED_PROTO, +) diff --git a/env/Lib/site-packages/aiohttp/_helpers.cp311-win_amd64.pyd b/env/Lib/site-packages/aiohttp/_helpers.cp311-win_amd64.pyd new file mode 100644 index 0000000000000000000000000000000000000000..ed52ac27c44095dfcd6df9ca11ca6d2f26a3400f GIT binary patch literal 54784 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 F{|%a|m|Xw> literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/_helpers.pyi b/env/Lib/site-packages/aiohttp/_helpers.pyi new file mode 100644 index 0000000..1e35893 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/_helpers.pyi @@ -0,0 +1,6 @@ +from typing import Any + +class reify: + def __init__(self, wrapped: Any) -> None: ... + def __get__(self, inst: Any, owner: Any) -> Any: ... + def __set__(self, inst: Any, value: Any) -> None: ... diff --git a/env/Lib/site-packages/aiohttp/_helpers.pyx b/env/Lib/site-packages/aiohttp/_helpers.pyx new file mode 100644 index 0000000..665f367 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/_helpers.pyx @@ -0,0 +1,35 @@ +cdef class reify: + """Use as a class method decorator. It operates almost exactly like + the Python `@property` decorator, but it puts the result of the + method it decorates into the instance dict after the first call, + effectively replacing the function it decorates with an instance + variable. It is, in Python parlance, a data descriptor. + + """ + + cdef object wrapped + cdef object name + + def __init__(self, wrapped): + self.wrapped = wrapped + self.name = wrapped.__name__ + + @property + def __doc__(self): + return self.wrapped.__doc__ + + def __get__(self, inst, owner): + try: + try: + return inst._cache[self.name] + except KeyError: + val = self.wrapped(inst) + inst._cache[self.name] = val + return val + except AttributeError: + if inst is None: + return self + raise + + def __set__(self, inst, value): + raise AttributeError("reified property is read-only") diff --git a/env/Lib/site-packages/aiohttp/_http_parser.cp311-win_amd64.pyd b/env/Lib/site-packages/aiohttp/_http_parser.cp311-win_amd64.pyd new file mode 100644 index 0000000000000000000000000000000000000000..a3143e2cdc164df17e2113db3364ec7170e890d5 GIT binary patch literal 266240 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≠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 T;9e?0Axc1${@?HKn*;wJKq58n literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/_http_parser.pyx b/env/Lib/site-packages/aiohttp/_http_parser.pyx new file mode 100644 index 0000000..dd317ed --- /dev/null +++ b/env/Lib/site-packages/aiohttp/_http_parser.pyx @@ -0,0 +1,841 @@ +#cython: language_level=3 +# +# Based on https://github.com/MagicStack/httptools +# + +from cpython cimport ( + Py_buffer, + PyBUF_SIMPLE, + PyBuffer_Release, + PyBytes_AsString, + PyBytes_AsStringAndSize, + PyObject_GetBuffer, +) +from cpython.mem cimport PyMem_Free, PyMem_Malloc +from libc.limits cimport ULLONG_MAX +from libc.string cimport memcpy + +from multidict import CIMultiDict as _CIMultiDict, CIMultiDictProxy as _CIMultiDictProxy +from yarl import URL as _URL + +from aiohttp import hdrs +from aiohttp.helpers import DEBUG, set_exception + +from .http_exceptions import ( + BadHttpMessage, + BadStatusLine, + ContentLengthError, + InvalidHeader, + InvalidURLError, + LineTooLong, + PayloadEncodingError, + TransferEncodingError, +) +from .http_parser import DeflateBuffer as _DeflateBuffer +from .http_writer import ( + HttpVersion as _HttpVersion, + HttpVersion10 as _HttpVersion10, + HttpVersion11 as _HttpVersion11, +) +from .streams import EMPTY_PAYLOAD as _EMPTY_PAYLOAD, StreamReader as _StreamReader + +cimport cython + +from aiohttp cimport _cparser as cparser + +include "_headers.pxi" + +from aiohttp cimport _find_header + +ALLOWED_UPGRADES = frozenset({"websocket"}) +DEF DEFAULT_FREELIST_SIZE = 250 + +cdef extern from "Python.h": + int PyByteArray_Resize(object, Py_ssize_t) except -1 + Py_ssize_t PyByteArray_Size(object) except -1 + char* PyByteArray_AsString(object) + +__all__ = ('HttpRequestParser', 'HttpResponseParser', + 'RawRequestMessage', 'RawResponseMessage') + +cdef object URL = _URL +cdef object URL_build = URL.build +cdef object CIMultiDict = _CIMultiDict +cdef object CIMultiDictProxy = _CIMultiDictProxy +cdef object HttpVersion = _HttpVersion +cdef object HttpVersion10 = _HttpVersion10 +cdef object HttpVersion11 = _HttpVersion11 +cdef object SEC_WEBSOCKET_KEY1 = hdrs.SEC_WEBSOCKET_KEY1 +cdef object CONTENT_ENCODING = hdrs.CONTENT_ENCODING +cdef object EMPTY_PAYLOAD = _EMPTY_PAYLOAD +cdef object StreamReader = _StreamReader +cdef object DeflateBuffer = _DeflateBuffer + + +cdef inline object extend(object buf, const char* at, size_t length): + cdef Py_ssize_t s + cdef char* ptr + s = PyByteArray_Size(buf) + PyByteArray_Resize(buf, s + length) + ptr = PyByteArray_AsString(buf) + memcpy(ptr + s, at, length) + + +DEF METHODS_COUNT = 46; + +cdef list _http_method = [] + +for i in range(METHODS_COUNT): + _http_method.append( + cparser.llhttp_method_name( i).decode('ascii')) + + +cdef inline str http_method_str(int i): + if i < METHODS_COUNT: + return _http_method[i] + else: + return "" + +cdef inline object find_header(bytes raw_header): + cdef Py_ssize_t size + cdef char *buf + cdef int idx + PyBytes_AsStringAndSize(raw_header, &buf, &size) + idx = _find_header.find_header(buf, size) + if idx == -1: + return raw_header.decode('utf-8', 'surrogateescape') + return headers[idx] + + +@cython.freelist(DEFAULT_FREELIST_SIZE) +cdef class RawRequestMessage: + cdef readonly str method + cdef readonly str path + cdef readonly object version # HttpVersion + cdef readonly object headers # CIMultiDict + cdef readonly object raw_headers # tuple + cdef readonly object should_close + cdef readonly object compression + cdef readonly object upgrade + cdef readonly object chunked + cdef readonly object url # yarl.URL + + def __init__(self, method, path, version, headers, raw_headers, + should_close, compression, upgrade, chunked, url): + self.method = method + self.path = path + self.version = version + self.headers = headers + self.raw_headers = raw_headers + self.should_close = should_close + self.compression = compression + self.upgrade = upgrade + self.chunked = chunked + self.url = url + + def __repr__(self): + info = [] + info.append(("method", self.method)) + info.append(("path", self.path)) + info.append(("version", self.version)) + info.append(("headers", self.headers)) + info.append(("raw_headers", self.raw_headers)) + info.append(("should_close", self.should_close)) + info.append(("compression", self.compression)) + info.append(("upgrade", self.upgrade)) + info.append(("chunked", self.chunked)) + info.append(("url", self.url)) + sinfo = ', '.join(name + '=' + repr(val) for name, val in info) + return '' + + def _replace(self, **dct): + cdef RawRequestMessage ret + ret = _new_request_message(self.method, + self.path, + self.version, + self.headers, + self.raw_headers, + self.should_close, + self.compression, + self.upgrade, + self.chunked, + self.url) + if "method" in dct: + ret.method = dct["method"] + if "path" in dct: + ret.path = dct["path"] + if "version" in dct: + ret.version = dct["version"] + if "headers" in dct: + ret.headers = dct["headers"] + if "raw_headers" in dct: + ret.raw_headers = dct["raw_headers"] + if "should_close" in dct: + ret.should_close = dct["should_close"] + if "compression" in dct: + ret.compression = dct["compression"] + if "upgrade" in dct: + ret.upgrade = dct["upgrade"] + if "chunked" in dct: + ret.chunked = dct["chunked"] + if "url" in dct: + ret.url = dct["url"] + return ret + +cdef _new_request_message(str method, + str path, + object version, + object headers, + object raw_headers, + bint should_close, + object compression, + bint upgrade, + bint chunked, + object url): + cdef RawRequestMessage ret + ret = RawRequestMessage.__new__(RawRequestMessage) + ret.method = method + ret.path = path + ret.version = version + ret.headers = headers + ret.raw_headers = raw_headers + ret.should_close = should_close + ret.compression = compression + ret.upgrade = upgrade + ret.chunked = chunked + ret.url = url + return ret + + +@cython.freelist(DEFAULT_FREELIST_SIZE) +cdef class RawResponseMessage: + cdef readonly object version # HttpVersion + cdef readonly int code + cdef readonly str reason + cdef readonly object headers # CIMultiDict + cdef readonly object raw_headers # tuple + cdef readonly object should_close + cdef readonly object compression + cdef readonly object upgrade + cdef readonly object chunked + + def __init__(self, version, code, reason, headers, raw_headers, + should_close, compression, upgrade, chunked): + self.version = version + self.code = code + self.reason = reason + self.headers = headers + self.raw_headers = raw_headers + self.should_close = should_close + self.compression = compression + self.upgrade = upgrade + self.chunked = chunked + + def __repr__(self): + info = [] + info.append(("version", self.version)) + info.append(("code", self.code)) + info.append(("reason", self.reason)) + info.append(("headers", self.headers)) + info.append(("raw_headers", self.raw_headers)) + info.append(("should_close", self.should_close)) + info.append(("compression", self.compression)) + info.append(("upgrade", self.upgrade)) + info.append(("chunked", self.chunked)) + sinfo = ', '.join(name + '=' + repr(val) for name, val in info) + return '' + + +cdef _new_response_message(object version, + int code, + str reason, + object headers, + object raw_headers, + bint should_close, + object compression, + bint upgrade, + bint chunked): + cdef RawResponseMessage ret + ret = RawResponseMessage.__new__(RawResponseMessage) + ret.version = version + ret.code = code + ret.reason = reason + ret.headers = headers + ret.raw_headers = raw_headers + ret.should_close = should_close + ret.compression = compression + ret.upgrade = upgrade + ret.chunked = chunked + return ret + + +@cython.internal +cdef class HttpParser: + + cdef: + cparser.llhttp_t* _cparser + cparser.llhttp_settings_t* _csettings + + bytearray _raw_name + bytearray _raw_value + bint _has_value + + object _protocol + object _loop + object _timer + + size_t _max_line_size + size_t _max_field_size + size_t _max_headers + bint _response_with_body + bint _read_until_eof + + bint _started + object _url + bytearray _buf + str _path + str _reason + object _headers + list _raw_headers + bint _upgraded + list _messages + object _payload + bint _payload_error + object _payload_exception + object _last_error + bint _auto_decompress + int _limit + + str _content_encoding + + Py_buffer py_buf + + def __cinit__(self): + self._cparser = \ + PyMem_Malloc(sizeof(cparser.llhttp_t)) + if self._cparser is NULL: + raise MemoryError() + + self._csettings = \ + PyMem_Malloc(sizeof(cparser.llhttp_settings_t)) + if self._csettings is NULL: + raise MemoryError() + + def __dealloc__(self): + PyMem_Free(self._cparser) + PyMem_Free(self._csettings) + + cdef _init( + self, cparser.llhttp_type mode, + object protocol, object loop, int limit, + object timer=None, + size_t max_line_size=8190, size_t max_headers=32768, + size_t max_field_size=8190, payload_exception=None, + bint response_with_body=True, bint read_until_eof=False, + bint auto_decompress=True, + ): + cparser.llhttp_settings_init(self._csettings) + cparser.llhttp_init(self._cparser, mode, self._csettings) + self._cparser.data = self + self._cparser.content_length = 0 + + self._protocol = protocol + self._loop = loop + self._timer = timer + + self._buf = bytearray() + self._payload = None + self._payload_error = 0 + self._payload_exception = payload_exception + self._messages = [] + + self._raw_name = bytearray() + self._raw_value = bytearray() + self._has_value = False + + self._max_line_size = max_line_size + self._max_headers = max_headers + self._max_field_size = max_field_size + self._response_with_body = response_with_body + self._read_until_eof = read_until_eof + self._upgraded = False + self._auto_decompress = auto_decompress + self._content_encoding = None + + self._csettings.on_url = cb_on_url + self._csettings.on_status = cb_on_status + self._csettings.on_header_field = cb_on_header_field + self._csettings.on_header_value = cb_on_header_value + self._csettings.on_headers_complete = cb_on_headers_complete + self._csettings.on_body = cb_on_body + self._csettings.on_message_begin = cb_on_message_begin + self._csettings.on_message_complete = cb_on_message_complete + self._csettings.on_chunk_header = cb_on_chunk_header + self._csettings.on_chunk_complete = cb_on_chunk_complete + + self._last_error = None + self._limit = limit + + cdef _process_header(self): + if self._raw_name: + raw_name = bytes(self._raw_name) + raw_value = bytes(self._raw_value) + + name = find_header(raw_name) + value = raw_value.decode('utf-8', 'surrogateescape') + + self._headers.add(name, value) + + if name is CONTENT_ENCODING: + self._content_encoding = value + + PyByteArray_Resize(self._raw_name, 0) + PyByteArray_Resize(self._raw_value, 0) + self._has_value = False + self._raw_headers.append((raw_name, raw_value)) + + cdef _on_header_field(self, char* at, size_t length): + cdef Py_ssize_t size + cdef char *buf + if self._has_value: + self._process_header() + + size = PyByteArray_Size(self._raw_name) + PyByteArray_Resize(self._raw_name, size + length) + buf = PyByteArray_AsString(self._raw_name) + memcpy(buf + size, at, length) + + cdef _on_header_value(self, char* at, size_t length): + cdef Py_ssize_t size + cdef char *buf + + size = PyByteArray_Size(self._raw_value) + PyByteArray_Resize(self._raw_value, size + length) + buf = PyByteArray_AsString(self._raw_value) + memcpy(buf + size, at, length) + self._has_value = True + + cdef _on_headers_complete(self): + self._process_header() + + should_close = not cparser.llhttp_should_keep_alive(self._cparser) + upgrade = self._cparser.upgrade + chunked = self._cparser.flags & cparser.F_CHUNKED + + raw_headers = tuple(self._raw_headers) + headers = CIMultiDictProxy(self._headers) + + if self._cparser.type == cparser.HTTP_REQUEST: + allowed = upgrade and headers.get("upgrade", "").lower() in ALLOWED_UPGRADES + if allowed or self._cparser.method == cparser.HTTP_CONNECT: + self._upgraded = True + else: + if upgrade and self._cparser.status_code == 101: + self._upgraded = True + + # do not support old websocket spec + if SEC_WEBSOCKET_KEY1 in headers: + raise InvalidHeader(SEC_WEBSOCKET_KEY1) + + encoding = None + enc = self._content_encoding + if enc is not None: + self._content_encoding = None + enc = enc.lower() + if enc in ('gzip', 'deflate', 'br'): + encoding = enc + + if self._cparser.type == cparser.HTTP_REQUEST: + method = http_method_str(self._cparser.method) + msg = _new_request_message( + method, self._path, + self.http_version(), headers, raw_headers, + should_close, encoding, upgrade, chunked, self._url) + else: + msg = _new_response_message( + self.http_version(), self._cparser.status_code, self._reason, + headers, raw_headers, should_close, encoding, + upgrade, chunked) + + if ( + ULLONG_MAX > self._cparser.content_length > 0 or chunked or + self._cparser.method == cparser.HTTP_CONNECT or + (self._cparser.status_code >= 199 and + self._cparser.content_length == 0 and + self._read_until_eof) + ): + payload = StreamReader( + self._protocol, timer=self._timer, loop=self._loop, + limit=self._limit) + else: + payload = EMPTY_PAYLOAD + + self._payload = payload + if encoding is not None and self._auto_decompress: + self._payload = DeflateBuffer(payload, encoding) + + if not self._response_with_body: + payload = EMPTY_PAYLOAD + + self._messages.append((msg, payload)) + + cdef _on_message_complete(self): + self._payload.feed_eof() + self._payload = None + + cdef _on_chunk_header(self): + self._payload.begin_http_chunk_receiving() + + cdef _on_chunk_complete(self): + self._payload.end_http_chunk_receiving() + + cdef object _on_status_complete(self): + pass + + cdef inline http_version(self): + cdef cparser.llhttp_t* parser = self._cparser + + if parser.http_major == 1: + if parser.http_minor == 0: + return HttpVersion10 + elif parser.http_minor == 1: + return HttpVersion11 + + return HttpVersion(parser.http_major, parser.http_minor) + + ### Public API ### + + def feed_eof(self): + cdef bytes desc + + if self._payload is not None: + if self._cparser.flags & cparser.F_CHUNKED: + raise TransferEncodingError( + "Not enough data for satisfy transfer length header.") + elif self._cparser.flags & cparser.F_CONTENT_LENGTH: + raise ContentLengthError( + "Not enough data for satisfy content length header.") + elif cparser.llhttp_get_errno(self._cparser) != cparser.HPE_OK: + desc = cparser.llhttp_get_error_reason(self._cparser) + raise PayloadEncodingError(desc.decode('latin-1')) + else: + self._payload.feed_eof() + elif self._started: + self._on_headers_complete() + if self._messages: + return self._messages[-1][0] + + def feed_data(self, data): + cdef: + size_t data_len + size_t nb + cdef cparser.llhttp_errno_t errno + + PyObject_GetBuffer(data, &self.py_buf, PyBUF_SIMPLE) + data_len = self.py_buf.len + + errno = cparser.llhttp_execute( + self._cparser, + self.py_buf.buf, + data_len) + + if errno is cparser.HPE_PAUSED_UPGRADE: + cparser.llhttp_resume_after_upgrade(self._cparser) + + nb = cparser.llhttp_get_error_pos(self._cparser) - self.py_buf.buf + + PyBuffer_Release(&self.py_buf) + + if errno not in (cparser.HPE_OK, cparser.HPE_PAUSED_UPGRADE): + if self._payload_error == 0: + if self._last_error is not None: + ex = self._last_error + self._last_error = None + else: + after = cparser.llhttp_get_error_pos(self._cparser) + before = data[:after - self.py_buf.buf] + after_b = after.split(b"\r\n", 1)[0] + before = before.rsplit(b"\r\n", 1)[-1] + data = before + after_b + pointer = " " * (len(repr(before))-1) + "^" + ex = parser_error_from_errno(self._cparser, data, pointer) + self._payload = None + raise ex + + if self._messages: + messages = self._messages + self._messages = [] + else: + messages = () + + if self._upgraded: + return messages, True, data[nb:] + else: + return messages, False, b"" + + def set_upgraded(self, val): + self._upgraded = val + + +cdef class HttpRequestParser(HttpParser): + + def __init__( + self, protocol, loop, int limit, timer=None, + size_t max_line_size=8190, size_t max_headers=32768, + size_t max_field_size=8190, payload_exception=None, + bint response_with_body=True, bint read_until_eof=False, + bint auto_decompress=True, + ): + self._init(cparser.HTTP_REQUEST, protocol, loop, limit, timer, + max_line_size, max_headers, max_field_size, + payload_exception, response_with_body, read_until_eof, + auto_decompress) + + cdef object _on_status_complete(self): + cdef int idx1, idx2 + if not self._buf: + return + self._path = self._buf.decode('utf-8', 'surrogateescape') + try: + idx3 = len(self._path) + if self._cparser.method == cparser.HTTP_CONNECT: + # authority-form, + # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.3 + self._url = URL.build(authority=self._path, encoded=True) + elif idx3 > 1 and self._path[0] == '/': + # origin-form, + # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.1 + idx1 = self._path.find("?") + if idx1 == -1: + query = "" + idx2 = self._path.find("#") + if idx2 == -1: + path = self._path + fragment = "" + else: + path = self._path[0: idx2] + fragment = self._path[idx2+1:] + + else: + path = self._path[0:idx1] + idx1 += 1 + idx2 = self._path.find("#", idx1+1) + if idx2 == -1: + query = self._path[idx1:] + fragment = "" + else: + query = self._path[idx1: idx2] + fragment = self._path[idx2+1:] + + self._url = URL.build( + path=path, + query_string=query, + fragment=fragment, + encoded=True, + ) + else: + # absolute-form for proxy maybe, + # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.2 + self._url = URL(self._path, encoded=True) + finally: + PyByteArray_Resize(self._buf, 0) + + +cdef class HttpResponseParser(HttpParser): + + def __init__( + self, protocol, loop, int limit, timer=None, + size_t max_line_size=8190, size_t max_headers=32768, + size_t max_field_size=8190, payload_exception=None, + bint response_with_body=True, bint read_until_eof=False, + bint auto_decompress=True + ): + self._init(cparser.HTTP_RESPONSE, protocol, loop, limit, timer, + max_line_size, max_headers, max_field_size, + payload_exception, response_with_body, read_until_eof, + auto_decompress) + # Use strict parsing on dev mode, so users are warned about broken servers. + if not DEBUG: + cparser.llhttp_set_lenient_headers(self._cparser, 1) + cparser.llhttp_set_lenient_optional_cr_before_lf(self._cparser, 1) + cparser.llhttp_set_lenient_spaces_after_chunk_size(self._cparser, 1) + + cdef object _on_status_complete(self): + if self._buf: + self._reason = self._buf.decode('utf-8', 'surrogateescape') + PyByteArray_Resize(self._buf, 0) + else: + self._reason = self._reason or '' + +cdef int cb_on_message_begin(cparser.llhttp_t* parser) except -1: + cdef HttpParser pyparser = parser.data + + pyparser._started = True + pyparser._headers = CIMultiDict() + pyparser._raw_headers = [] + PyByteArray_Resize(pyparser._buf, 0) + pyparser._path = None + pyparser._reason = None + return 0 + + +cdef int cb_on_url(cparser.llhttp_t* parser, + const char *at, size_t length) except -1: + cdef HttpParser pyparser = parser.data + try: + if length > pyparser._max_line_size: + raise LineTooLong( + 'Status line is too long', pyparser._max_line_size, length) + extend(pyparser._buf, at, length) + except BaseException as ex: + pyparser._last_error = ex + return -1 + else: + return 0 + + +cdef int cb_on_status(cparser.llhttp_t* parser, + const char *at, size_t length) except -1: + cdef HttpParser pyparser = parser.data + cdef str reason + try: + if length > pyparser._max_line_size: + raise LineTooLong( + 'Status line is too long', pyparser._max_line_size, length) + extend(pyparser._buf, at, length) + except BaseException as ex: + pyparser._last_error = ex + return -1 + else: + return 0 + + +cdef int cb_on_header_field(cparser.llhttp_t* parser, + const char *at, size_t length) except -1: + cdef HttpParser pyparser = parser.data + cdef Py_ssize_t size + try: + pyparser._on_status_complete() + size = len(pyparser._raw_name) + length + if size > pyparser._max_field_size: + raise LineTooLong( + 'Header name is too long', pyparser._max_field_size, size) + pyparser._on_header_field(at, length) + except BaseException as ex: + pyparser._last_error = ex + return -1 + else: + return 0 + + +cdef int cb_on_header_value(cparser.llhttp_t* parser, + const char *at, size_t length) except -1: + cdef HttpParser pyparser = parser.data + cdef Py_ssize_t size + try: + size = len(pyparser._raw_value) + length + if size > pyparser._max_field_size: + raise LineTooLong( + 'Header value is too long', pyparser._max_field_size, size) + pyparser._on_header_value(at, length) + except BaseException as ex: + pyparser._last_error = ex + return -1 + else: + return 0 + + +cdef int cb_on_headers_complete(cparser.llhttp_t* parser) except -1: + cdef HttpParser pyparser = parser.data + try: + pyparser._on_status_complete() + pyparser._on_headers_complete() + except BaseException as exc: + pyparser._last_error = exc + return -1 + else: + if pyparser._upgraded or pyparser._cparser.method == cparser.HTTP_CONNECT: + return 2 + else: + return 0 + + +cdef int cb_on_body(cparser.llhttp_t* parser, + const char *at, size_t length) except -1: + cdef HttpParser pyparser = parser.data + cdef bytes body = at[:length] + try: + pyparser._payload.feed_data(body, length) + except BaseException as underlying_exc: + reraised_exc = underlying_exc + if pyparser._payload_exception is not None: + reraised_exc = pyparser._payload_exception(str(underlying_exc)) + + set_exception(pyparser._payload, reraised_exc, underlying_exc) + + pyparser._payload_error = 1 + return -1 + else: + return 0 + + +cdef int cb_on_message_complete(cparser.llhttp_t* parser) except -1: + cdef HttpParser pyparser = parser.data + try: + pyparser._started = False + pyparser._on_message_complete() + except BaseException as exc: + pyparser._last_error = exc + return -1 + else: + return 0 + + +cdef int cb_on_chunk_header(cparser.llhttp_t* parser) except -1: + cdef HttpParser pyparser = parser.data + try: + pyparser._on_chunk_header() + except BaseException as exc: + pyparser._last_error = exc + return -1 + else: + return 0 + + +cdef int cb_on_chunk_complete(cparser.llhttp_t* parser) except -1: + cdef HttpParser pyparser = parser.data + try: + pyparser._on_chunk_complete() + except BaseException as exc: + pyparser._last_error = exc + return -1 + else: + return 0 + + +cdef parser_error_from_errno(cparser.llhttp_t* parser, data, pointer): + cdef cparser.llhttp_errno_t errno = cparser.llhttp_get_errno(parser) + cdef bytes desc = cparser.llhttp_get_error_reason(parser) + + err_msg = "{}:\n\n {!r}\n {}".format(desc.decode("latin-1"), data, pointer) + + if errno in {cparser.HPE_CB_MESSAGE_BEGIN, + cparser.HPE_CB_HEADERS_COMPLETE, + cparser.HPE_CB_MESSAGE_COMPLETE, + cparser.HPE_CB_CHUNK_HEADER, + cparser.HPE_CB_CHUNK_COMPLETE, + cparser.HPE_INVALID_CONSTANT, + cparser.HPE_INVALID_HEADER_TOKEN, + cparser.HPE_INVALID_CONTENT_LENGTH, + cparser.HPE_INVALID_CHUNK_SIZE, + cparser.HPE_INVALID_EOF_STATE, + cparser.HPE_INVALID_TRANSFER_ENCODING}: + return BadHttpMessage(err_msg) + elif errno in {cparser.HPE_INVALID_STATUS, + cparser.HPE_INVALID_METHOD, + cparser.HPE_INVALID_VERSION}: + return BadStatusLine(error=err_msg) + elif errno == cparser.HPE_INVALID_URL: + return InvalidURLError(err_msg) + + return BadHttpMessage(err_msg) diff --git a/env/Lib/site-packages/aiohttp/_http_writer.cp311-win_amd64.pyd b/env/Lib/site-packages/aiohttp/_http_writer.cp311-win_amd64.pyd new file mode 100644 index 0000000000000000000000000000000000000000..b38d534813dc4c01daa8337560261a6a8e595f06 GIT binary patch literal 49152 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/_http_writer.pyx b/env/Lib/site-packages/aiohttp/_http_writer.pyx new file mode 100644 index 0000000..eff8521 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/_http_writer.pyx @@ -0,0 +1,163 @@ +from cpython.bytes cimport PyBytes_FromStringAndSize +from cpython.exc cimport PyErr_NoMemory +from cpython.mem cimport PyMem_Free, PyMem_Malloc, PyMem_Realloc +from cpython.object cimport PyObject_Str +from libc.stdint cimport uint8_t, uint64_t +from libc.string cimport memcpy + +from multidict import istr + +DEF BUF_SIZE = 16 * 1024 # 16KiB +cdef char BUFFER[BUF_SIZE] + +cdef object _istr = istr + + +# ----------------- writer --------------------------- + +cdef struct Writer: + char *buf + Py_ssize_t size + Py_ssize_t pos + + +cdef inline void _init_writer(Writer* writer): + writer.buf = &BUFFER[0] + writer.size = BUF_SIZE + writer.pos = 0 + + +cdef inline void _release_writer(Writer* writer): + if writer.buf != BUFFER: + PyMem_Free(writer.buf) + + +cdef inline int _write_byte(Writer* writer, uint8_t ch): + cdef char * buf + cdef Py_ssize_t size + + if writer.pos == writer.size: + # reallocate + size = writer.size + BUF_SIZE + if writer.buf == BUFFER: + buf = PyMem_Malloc(size) + if buf == NULL: + PyErr_NoMemory() + return -1 + memcpy(buf, writer.buf, writer.size) + else: + buf = PyMem_Realloc(writer.buf, size) + if buf == NULL: + PyErr_NoMemory() + return -1 + writer.buf = buf + writer.size = size + writer.buf[writer.pos] = ch + writer.pos += 1 + return 0 + + +cdef inline int _write_utf8(Writer* writer, Py_UCS4 symbol): + cdef uint64_t utf = symbol + + if utf < 0x80: + return _write_byte(writer, utf) + elif utf < 0x800: + if _write_byte(writer, (0xc0 | (utf >> 6))) < 0: + return -1 + return _write_byte(writer, (0x80 | (utf & 0x3f))) + elif 0xD800 <= utf <= 0xDFFF: + # surogate pair, ignored + return 0 + elif utf < 0x10000: + if _write_byte(writer, (0xe0 | (utf >> 12))) < 0: + return -1 + if _write_byte(writer, (0x80 | ((utf >> 6) & 0x3f))) < 0: + return -1 + return _write_byte(writer, (0x80 | (utf & 0x3f))) + elif utf > 0x10FFFF: + # symbol is too large + return 0 + else: + if _write_byte(writer, (0xf0 | (utf >> 18))) < 0: + return -1 + if _write_byte(writer, + (0x80 | ((utf >> 12) & 0x3f))) < 0: + return -1 + if _write_byte(writer, + (0x80 | ((utf >> 6) & 0x3f))) < 0: + return -1 + return _write_byte(writer, (0x80 | (utf & 0x3f))) + + +cdef inline int _write_str(Writer* writer, str s): + cdef Py_UCS4 ch + for ch in s: + if _write_utf8(writer, ch) < 0: + return -1 + + +# --------------- _serialize_headers ---------------------- + +cdef str to_str(object s): + typ = type(s) + if typ is str: + return s + elif typ is _istr: + return PyObject_Str(s) + elif not isinstance(s, str): + raise TypeError("Cannot serialize non-str key {!r}".format(s)) + else: + return str(s) + + +cdef void _safe_header(str string) except *: + if "\r" in string or "\n" in string: + raise ValueError( + "Newline or carriage return character detected in HTTP status message or " + "header. This is a potential security issue." + ) + + +def _serialize_headers(str status_line, headers): + cdef Writer writer + cdef object key + cdef object val + cdef bytes ret + + _init_writer(&writer) + + for key, val in headers.items(): + _safe_header(to_str(key)) + _safe_header(to_str(val)) + + try: + if _write_str(&writer, status_line) < 0: + raise + if _write_byte(&writer, b'\r') < 0: + raise + if _write_byte(&writer, b'\n') < 0: + raise + + for key, val in headers.items(): + if _write_str(&writer, to_str(key)) < 0: + raise + if _write_byte(&writer, b':') < 0: + raise + if _write_byte(&writer, b' ') < 0: + raise + if _write_str(&writer, to_str(val)) < 0: + raise + if _write_byte(&writer, b'\r') < 0: + raise + if _write_byte(&writer, b'\n') < 0: + raise + + if _write_byte(&writer, b'\r') < 0: + raise + if _write_byte(&writer, b'\n') < 0: + raise + + return PyBytes_FromStringAndSize(writer.buf, writer.pos) + finally: + _release_writer(&writer) diff --git a/env/Lib/site-packages/aiohttp/_websocket.cp311-win_amd64.pyd b/env/Lib/site-packages/aiohttp/_websocket.cp311-win_amd64.pyd new file mode 100644 index 0000000000000000000000000000000000000000..011cfd9353ce34df8a94c52f356749a171ca4aa0 GIT binary patch literal 36864 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
        E19{o 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 J`g~yx{4Zj2V5I;6 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiohttp/_websocket.pyx b/env/Lib/site-packages/aiohttp/_websocket.pyx new file mode 100644 index 0000000..94318d2 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/_websocket.pyx @@ -0,0 +1,56 @@ +from cpython cimport PyBytes_AsString + + +#from cpython cimport PyByteArray_AsString # cython still not exports that +cdef extern from "Python.h": + char* PyByteArray_AsString(bytearray ba) except NULL + +from libc.stdint cimport uint32_t, uint64_t, uintmax_t + + +def _websocket_mask_cython(object mask, object data): + """Note, this function mutates its `data` argument + """ + cdef: + Py_ssize_t data_len, i + # bit operations on signed integers are implementation-specific + unsigned char * in_buf + const unsigned char * mask_buf + uint32_t uint32_msk + uint64_t uint64_msk + + assert len(mask) == 4 + + if not isinstance(mask, bytes): + mask = bytes(mask) + + if isinstance(data, bytearray): + data = data + else: + data = bytearray(data) + + data_len = len(data) + in_buf = PyByteArray_AsString(data) + mask_buf = PyBytes_AsString(mask) + uint32_msk = (mask_buf)[0] + + # TODO: align in_data ptr to achieve even faster speeds + # does it need in python ?! malloc() always aligns to sizeof(long) bytes + + if sizeof(size_t) >= 8: + uint64_msk = uint32_msk + uint64_msk = (uint64_msk << 32) | uint32_msk + + while data_len >= 8: + (in_buf)[0] ^= uint64_msk + in_buf += 8 + data_len -= 8 + + + while data_len >= 4: + (in_buf)[0] ^= uint32_msk + in_buf += 4 + data_len -= 4 + + for i in range(0, data_len): + in_buf[i] ^= mask_buf[i] diff --git a/env/Lib/site-packages/aiohttp/abc.py b/env/Lib/site-packages/aiohttp/abc.py new file mode 100644 index 0000000..3fb0240 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/abc.py @@ -0,0 +1,234 @@ +import asyncio +import logging +import socket +from abc import ABC, abstractmethod +from collections.abc import Sized +from http.cookies import BaseCookie, Morsel +from typing import ( + TYPE_CHECKING, + Any, + Awaitable, + Callable, + Dict, + Generator, + Iterable, + List, + Optional, + Tuple, + TypedDict, +) + +from multidict import CIMultiDict +from yarl import URL + +from .typedefs import LooseCookies + +if TYPE_CHECKING: + from .web_app import Application + from .web_exceptions import HTTPException + from .web_request import BaseRequest, Request + from .web_response import StreamResponse +else: + BaseRequest = Request = Application = StreamResponse = None + HTTPException = None + + +class AbstractRouter(ABC): + def __init__(self) -> None: + self._frozen = False + + def post_init(self, app: Application) -> None: + """Post init stage. + + Not an abstract method for sake of backward compatibility, + but if the router wants to be aware of the application + it can override this. + """ + + @property + def frozen(self) -> bool: + return self._frozen + + def freeze(self) -> None: + """Freeze router.""" + self._frozen = True + + @abstractmethod + async def resolve(self, request: Request) -> "AbstractMatchInfo": + """Return MATCH_INFO for given request""" + + +class AbstractMatchInfo(ABC): + @property # pragma: no branch + @abstractmethod + def handler(self) -> Callable[[Request], Awaitable[StreamResponse]]: + """Execute matched request handler""" + + @property + @abstractmethod + def expect_handler( + self, + ) -> Callable[[Request], Awaitable[Optional[StreamResponse]]]: + """Expect handler for 100-continue processing""" + + @property # pragma: no branch + @abstractmethod + def http_exception(self) -> Optional[HTTPException]: + """HTTPException instance raised on router's resolving, or None""" + + @abstractmethod # pragma: no branch + def get_info(self) -> Dict[str, Any]: + """Return a dict with additional info useful for introspection""" + + @property # pragma: no branch + @abstractmethod + def apps(self) -> Tuple[Application, ...]: + """Stack of nested applications. + + Top level application is left-most element. + + """ + + @abstractmethod + def add_app(self, app: Application) -> None: + """Add application to the nested apps stack.""" + + @abstractmethod + def freeze(self) -> None: + """Freeze the match info. + + The method is called after route resolution. + + After the call .add_app() is forbidden. + + """ + + +class AbstractView(ABC): + """Abstract class based view.""" + + def __init__(self, request: Request) -> None: + self._request = request + + @property + def request(self) -> Request: + """Request instance.""" + return self._request + + @abstractmethod + def __await__(self) -> Generator[Any, None, StreamResponse]: + """Execute the view handler.""" + + +class ResolveResult(TypedDict): + """Resolve result. + + This is the result returned from an AbstractResolver's + resolve method. + + :param hostname: The hostname that was provided. + :param host: The IP address that was resolved. + :param port: The port that was resolved. + :param family: The address family that was resolved. + :param proto: The protocol that was resolved. + :param flags: The flags that were resolved. + """ + + hostname: str + host: str + port: int + family: int + proto: int + flags: int + + +class AbstractResolver(ABC): + """Abstract DNS resolver.""" + + @abstractmethod + async def resolve( + self, host: str, port: int = 0, family: socket.AddressFamily = socket.AF_INET + ) -> List[ResolveResult]: + """Return IP address for given hostname""" + + @abstractmethod + async def close(self) -> None: + """Release resolver""" + + +if TYPE_CHECKING: + IterableBase = Iterable[Morsel[str]] +else: + IterableBase = Iterable + + +ClearCookiePredicate = Callable[["Morsel[str]"], bool] + + +class AbstractCookieJar(Sized, IterableBase): + """Abstract Cookie Jar.""" + + def __init__(self, *, loop: Optional[asyncio.AbstractEventLoop] = None) -> None: + self._loop = loop or asyncio.get_running_loop() + + @abstractmethod + def clear(self, predicate: Optional[ClearCookiePredicate] = None) -> None: + """Clear all cookies if no predicate is passed.""" + + @abstractmethod + def clear_domain(self, domain: str) -> None: + """Clear all cookies for domain and all subdomains.""" + + @abstractmethod + def update_cookies(self, cookies: LooseCookies, response_url: URL = URL()) -> None: + """Update cookies.""" + + @abstractmethod + def filter_cookies(self, request_url: URL) -> "BaseCookie[str]": + """Return the jar's cookies filtered by their attributes.""" + + +class AbstractStreamWriter(ABC): + """Abstract stream writer.""" + + buffer_size = 0 + output_size = 0 + length: Optional[int] = 0 + + @abstractmethod + async def write(self, chunk: bytes) -> None: + """Write chunk into stream.""" + + @abstractmethod + async def write_eof(self, chunk: bytes = b"") -> None: + """Write last chunk.""" + + @abstractmethod + async def drain(self) -> None: + """Flush the write buffer.""" + + @abstractmethod + def enable_compression(self, encoding: str = "deflate") -> None: + """Enable HTTP body compression""" + + @abstractmethod + def enable_chunking(self) -> None: + """Enable HTTP chunked mode""" + + @abstractmethod + async def write_headers( + self, status_line: str, headers: "CIMultiDict[str]" + ) -> None: + """Write HTTP headers""" + + +class AbstractAccessLogger(ABC): + """Abstract writer to access log.""" + + def __init__(self, logger: logging.Logger, log_format: str) -> None: + self.logger = logger + self.log_format = log_format + + @abstractmethod + def log(self, request: BaseRequest, response: StreamResponse, time: float) -> None: + """Emit log to logger.""" diff --git a/env/Lib/site-packages/aiohttp/base_protocol.py b/env/Lib/site-packages/aiohttp/base_protocol.py new file mode 100644 index 0000000..dc1f24f --- /dev/null +++ b/env/Lib/site-packages/aiohttp/base_protocol.py @@ -0,0 +1,95 @@ +import asyncio +from typing import Optional, cast + +from .helpers import set_exception +from .tcp_helpers import tcp_nodelay + + +class BaseProtocol(asyncio.Protocol): + __slots__ = ( + "_loop", + "_paused", + "_drain_waiter", + "_connection_lost", + "_reading_paused", + "transport", + ) + + def __init__(self, loop: asyncio.AbstractEventLoop) -> None: + self._loop: asyncio.AbstractEventLoop = loop + self._paused = False + self._drain_waiter: Optional[asyncio.Future[None]] = None + self._reading_paused = False + + self.transport: Optional[asyncio.Transport] = None + + @property + def connected(self) -> bool: + """Return True if the connection is open.""" + return self.transport is not None + + def pause_writing(self) -> None: + assert not self._paused + self._paused = True + + def resume_writing(self) -> None: + assert self._paused + self._paused = False + + waiter = self._drain_waiter + if waiter is not None: + self._drain_waiter = None + if not waiter.done(): + waiter.set_result(None) + + def pause_reading(self) -> None: + if not self._reading_paused and self.transport is not None: + try: + self.transport.pause_reading() + except (AttributeError, NotImplementedError, RuntimeError): + pass + self._reading_paused = True + + def resume_reading(self) -> None: + if self._reading_paused and self.transport is not None: + try: + self.transport.resume_reading() + except (AttributeError, NotImplementedError, RuntimeError): + pass + self._reading_paused = False + + def connection_made(self, transport: asyncio.BaseTransport) -> None: + tr = cast(asyncio.Transport, transport) + tcp_nodelay(tr, True) + self.transport = tr + + def connection_lost(self, exc: Optional[BaseException]) -> None: + # Wake up the writer if currently paused. + self.transport = None + if not self._paused: + return + waiter = self._drain_waiter + if waiter is None: + return + self._drain_waiter = None + if waiter.done(): + return + if exc is None: + waiter.set_result(None) + else: + set_exception( + waiter, + ConnectionError("Connection lost"), + exc, + ) + + async def _drain_helper(self) -> None: + if not self.connected: + raise ConnectionResetError("Connection lost") + if not self._paused: + return + waiter = self._drain_waiter + if waiter is None: + waiter = self._loop.create_future() + self._drain_waiter = waiter + await asyncio.shield(waiter) diff --git a/env/Lib/site-packages/aiohttp/client.py b/env/Lib/site-packages/aiohttp/client.py new file mode 100644 index 0000000..3d1045f --- /dev/null +++ b/env/Lib/site-packages/aiohttp/client.py @@ -0,0 +1,1522 @@ +"""HTTP Client for asyncio.""" + +import asyncio +import base64 +import hashlib +import json +import os +import sys +import traceback +import warnings +from contextlib import suppress +from types import TracebackType +from typing import ( + TYPE_CHECKING, + Any, + Awaitable, + Callable, + Coroutine, + Final, + FrozenSet, + Generator, + Generic, + Iterable, + List, + Mapping, + Optional, + Set, + Tuple, + Type, + TypedDict, + TypeVar, + Union, +) + +import attr +from multidict import CIMultiDict, MultiDict, MultiDictProxy, istr +from yarl import URL + +from . import hdrs, http, payload +from .abc import AbstractCookieJar +from .client_exceptions import ( + ClientConnectionError, + ClientConnectorCertificateError, + ClientConnectorError, + ClientConnectorSSLError, + ClientError, + ClientHttpProxyError, + ClientOSError, + ClientPayloadError, + ClientProxyConnectionError, + ClientResponseError, + ClientSSLError, + ConnectionTimeoutError, + ContentTypeError, + InvalidURL, + InvalidUrlClientError, + InvalidUrlRedirectClientError, + NonHttpUrlClientError, + NonHttpUrlRedirectClientError, + RedirectClientError, + ServerConnectionError, + ServerDisconnectedError, + ServerFingerprintMismatch, + ServerTimeoutError, + SocketTimeoutError, + TooManyRedirects, + WSServerHandshakeError, +) +from .client_reqrep import ( + ClientRequest as ClientRequest, + ClientResponse as ClientResponse, + Fingerprint as Fingerprint, + RequestInfo as RequestInfo, + _merge_ssl_params, +) +from .client_ws import ClientWebSocketResponse as ClientWebSocketResponse +from .connector import ( + HTTP_AND_EMPTY_SCHEMA_SET, + BaseConnector as BaseConnector, + NamedPipeConnector as NamedPipeConnector, + TCPConnector as TCPConnector, + UnixConnector as UnixConnector, +) +from .cookiejar import CookieJar +from .helpers import ( + _SENTINEL, + DEBUG, + BasicAuth, + TimeoutHandle, + ceil_timeout, + get_env_proxy_for_url, + method_must_be_empty_body, + sentinel, + strip_auth_from_url, +) +from .http import WS_KEY, HttpVersion, WebSocketReader, WebSocketWriter +from .http_websocket import WSHandshakeError, WSMessage, ws_ext_gen, ws_ext_parse +from .streams import FlowControlDataQueue +from .tracing import Trace, TraceConfig +from .typedefs import JSONEncoder, LooseCookies, LooseHeaders, StrOrURL + +__all__ = ( + # client_exceptions + "ClientConnectionError", + "ClientConnectorCertificateError", + "ClientConnectorError", + "ClientConnectorSSLError", + "ClientError", + "ClientHttpProxyError", + "ClientOSError", + "ClientPayloadError", + "ClientProxyConnectionError", + "ClientResponseError", + "ClientSSLError", + "ConnectionTimeoutError", + "ContentTypeError", + "InvalidURL", + "InvalidUrlClientError", + "RedirectClientError", + "NonHttpUrlClientError", + "InvalidUrlRedirectClientError", + "NonHttpUrlRedirectClientError", + "ServerConnectionError", + "ServerDisconnectedError", + "ServerFingerprintMismatch", + "ServerTimeoutError", + "SocketTimeoutError", + "TooManyRedirects", + "WSServerHandshakeError", + # client_reqrep + "ClientRequest", + "ClientResponse", + "Fingerprint", + "RequestInfo", + # connector + "BaseConnector", + "TCPConnector", + "UnixConnector", + "NamedPipeConnector", + # client_ws + "ClientWebSocketResponse", + # client + "ClientSession", + "ClientTimeout", + "request", +) + + +if TYPE_CHECKING: + from ssl import SSLContext +else: + SSLContext = None + +if sys.version_info >= (3, 11) and TYPE_CHECKING: + from typing import Unpack + + +class _RequestOptions(TypedDict, total=False): + params: Union[Mapping[str, Union[str, int]], str, None] + data: Any + json: Any + cookies: Union[LooseCookies, None] + headers: Union[LooseHeaders, None] + skip_auto_headers: Union[Iterable[str], None] + auth: Union[BasicAuth, None] + allow_redirects: bool + max_redirects: int + compress: Union[str, None] + chunked: Union[bool, None] + expect100: bool + raise_for_status: Union[None, bool, Callable[[ClientResponse], Awaitable[None]]] + read_until_eof: bool + proxy: Union[StrOrURL, None] + proxy_auth: Union[BasicAuth, None] + timeout: "Union[ClientTimeout, _SENTINEL, None]" + ssl: Union[SSLContext, bool, Fingerprint] + server_hostname: Union[str, None] + proxy_headers: Union[LooseHeaders, None] + trace_request_ctx: Union[Mapping[str, str], None] + read_bufsize: Union[int, None] + auto_decompress: Union[bool, None] + max_line_size: Union[int, None] + max_field_size: Union[int, None] + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class ClientTimeout: + total: Optional[float] = None + connect: Optional[float] = None + sock_read: Optional[float] = None + sock_connect: Optional[float] = None + ceil_threshold: float = 5 + + # pool_queue_timeout: Optional[float] = None + # dns_resolution_timeout: Optional[float] = None + # socket_connect_timeout: Optional[float] = None + # connection_acquiring_timeout: Optional[float] = None + # new_connection_timeout: Optional[float] = None + # http_header_timeout: Optional[float] = None + # response_body_timeout: Optional[float] = None + + # to create a timeout specific for a single request, either + # - create a completely new one to overwrite the default + # - or use http://www.attrs.org/en/stable/api.html#attr.evolve + # to overwrite the defaults + + +# 5 Minute default read timeout +DEFAULT_TIMEOUT: Final[ClientTimeout] = ClientTimeout(total=5 * 60) + +# https://www.rfc-editor.org/rfc/rfc9110#section-9.2.2 +IDEMPOTENT_METHODS = frozenset({"GET", "HEAD", "OPTIONS", "TRACE", "PUT", "DELETE"}) + +_RetType = TypeVar("_RetType") +_CharsetResolver = Callable[[ClientResponse, bytes], str] + + +class ClientSession: + """First-class interface for making HTTP requests.""" + + ATTRS = frozenset( + [ + "_base_url", + "_source_traceback", + "_connector", + "requote_redirect_url", + "_loop", + "_cookie_jar", + "_connector_owner", + "_default_auth", + "_version", + "_json_serialize", + "_requote_redirect_url", + "_timeout", + "_raise_for_status", + "_auto_decompress", + "_trust_env", + "_default_headers", + "_skip_auto_headers", + "_request_class", + "_response_class", + "_ws_response_class", + "_trace_configs", + "_read_bufsize", + "_max_line_size", + "_max_field_size", + "_resolve_charset", + ] + ) + + _source_traceback: Optional[traceback.StackSummary] = None + _connector: Optional[BaseConnector] = None + + def __init__( + self, + base_url: Optional[StrOrURL] = None, + *, + connector: Optional[BaseConnector] = None, + loop: Optional[asyncio.AbstractEventLoop] = None, + cookies: Optional[LooseCookies] = None, + headers: Optional[LooseHeaders] = None, + skip_auto_headers: Optional[Iterable[str]] = None, + auth: Optional[BasicAuth] = None, + json_serialize: JSONEncoder = json.dumps, + request_class: Type[ClientRequest] = ClientRequest, + response_class: Type[ClientResponse] = ClientResponse, + ws_response_class: Type[ClientWebSocketResponse] = ClientWebSocketResponse, + version: HttpVersion = http.HttpVersion11, + cookie_jar: Optional[AbstractCookieJar] = None, + connector_owner: bool = True, + raise_for_status: Union[ + bool, Callable[[ClientResponse], Awaitable[None]] + ] = False, + read_timeout: Union[float, _SENTINEL] = sentinel, + conn_timeout: Optional[float] = None, + timeout: Union[object, ClientTimeout] = sentinel, + auto_decompress: bool = True, + trust_env: bool = False, + requote_redirect_url: bool = True, + trace_configs: Optional[List[TraceConfig]] = None, + read_bufsize: int = 2**16, + max_line_size: int = 8190, + max_field_size: int = 8190, + fallback_charset_resolver: _CharsetResolver = lambda r, b: "utf-8", + ) -> None: + # We initialise _connector to None immediately, as it's referenced in __del__() + # and could cause issues if an exception occurs during initialisation. + self._connector: Optional[BaseConnector] = None + + if loop is None: + if connector is not None: + loop = connector._loop + + loop = loop or asyncio.get_running_loop() + + if base_url is None or isinstance(base_url, URL): + self._base_url: Optional[URL] = base_url + else: + self._base_url = URL(base_url) + assert ( + self._base_url.origin() == self._base_url + ), "Only absolute URLs without path part are supported" + + if timeout is sentinel or timeout is None: + self._timeout = DEFAULT_TIMEOUT + if read_timeout is not sentinel: + warnings.warn( + "read_timeout is deprecated, " "use timeout argument instead", + DeprecationWarning, + stacklevel=2, + ) + self._timeout = attr.evolve(self._timeout, total=read_timeout) + if conn_timeout is not None: + self._timeout = attr.evolve(self._timeout, connect=conn_timeout) + warnings.warn( + "conn_timeout is deprecated, " "use timeout argument instead", + DeprecationWarning, + stacklevel=2, + ) + else: + if not isinstance(timeout, ClientTimeout): + raise ValueError( + f"timeout parameter cannot be of {type(timeout)} type, " + "please use 'timeout=ClientTimeout(...)'", + ) + self._timeout = timeout + if read_timeout is not sentinel: + raise ValueError( + "read_timeout and timeout parameters " + "conflict, please setup " + "timeout.read" + ) + if conn_timeout is not None: + raise ValueError( + "conn_timeout and timeout parameters " + "conflict, please setup " + "timeout.connect" + ) + + if connector is None: + connector = TCPConnector(loop=loop) + + if connector._loop is not loop: + raise RuntimeError("Session and connector has to use same event loop") + + self._loop = loop + + if loop.get_debug(): + self._source_traceback = traceback.extract_stack(sys._getframe(1)) + + if cookie_jar is None: + cookie_jar = CookieJar(loop=loop) + self._cookie_jar = cookie_jar + + if cookies is not None: + self._cookie_jar.update_cookies(cookies) + + self._connector = connector + self._connector_owner = connector_owner + self._default_auth = auth + self._version = version + self._json_serialize = json_serialize + self._raise_for_status = raise_for_status + self._auto_decompress = auto_decompress + self._trust_env = trust_env + self._requote_redirect_url = requote_redirect_url + self._read_bufsize = read_bufsize + self._max_line_size = max_line_size + self._max_field_size = max_field_size + + # Convert to list of tuples + if headers: + real_headers: CIMultiDict[str] = CIMultiDict(headers) + else: + real_headers = CIMultiDict() + self._default_headers: CIMultiDict[str] = real_headers + if skip_auto_headers is not None: + self._skip_auto_headers = frozenset(istr(i) for i in skip_auto_headers) + else: + self._skip_auto_headers = frozenset() + + self._request_class = request_class + self._response_class = response_class + self._ws_response_class = ws_response_class + + self._trace_configs = trace_configs or [] + for trace_config in self._trace_configs: + trace_config.freeze() + + self._resolve_charset = fallback_charset_resolver + + def __init_subclass__(cls: Type["ClientSession"]) -> None: + warnings.warn( + "Inheritance class {} from ClientSession " + "is discouraged".format(cls.__name__), + DeprecationWarning, + stacklevel=2, + ) + + if DEBUG: + + def __setattr__(self, name: str, val: Any) -> None: + if name not in self.ATTRS: + warnings.warn( + "Setting custom ClientSession.{} attribute " + "is discouraged".format(name), + DeprecationWarning, + stacklevel=2, + ) + super().__setattr__(name, val) + + def __del__(self, _warnings: Any = warnings) -> None: + if not self.closed: + kwargs = {"source": self} + _warnings.warn( + f"Unclosed client session {self!r}", ResourceWarning, **kwargs + ) + context = {"client_session": self, "message": "Unclosed client session"} + if self._source_traceback is not None: + context["source_traceback"] = self._source_traceback + self._loop.call_exception_handler(context) + + if sys.version_info >= (3, 11) and TYPE_CHECKING: + + def request( + self, + method: str, + url: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> "_RequestContextManager": ... + + else: + + def request( + self, method: str, url: StrOrURL, **kwargs: Any + ) -> "_RequestContextManager": + """Perform HTTP request.""" + return _RequestContextManager(self._request(method, url, **kwargs)) + + def _build_url(self, str_or_url: StrOrURL) -> URL: + url = URL(str_or_url) + if self._base_url is None: + return url + else: + assert not url.is_absolute() and url.path.startswith("/") + return self._base_url.join(url) + + async def _request( + self, + method: str, + str_or_url: StrOrURL, + *, + params: Optional[Mapping[str, str]] = None, + data: Any = None, + json: Any = None, + cookies: Optional[LooseCookies] = None, + headers: Optional[LooseHeaders] = None, + skip_auto_headers: Optional[Iterable[str]] = None, + auth: Optional[BasicAuth] = None, + allow_redirects: bool = True, + max_redirects: int = 10, + compress: Optional[str] = None, + chunked: Optional[bool] = None, + expect100: bool = False, + raise_for_status: Union[ + None, bool, Callable[[ClientResponse], Awaitable[None]] + ] = None, + read_until_eof: bool = True, + proxy: Optional[StrOrURL] = None, + proxy_auth: Optional[BasicAuth] = None, + timeout: Union[ClientTimeout, _SENTINEL] = sentinel, + verify_ssl: Optional[bool] = None, + fingerprint: Optional[bytes] = None, + ssl_context: Optional[SSLContext] = None, + ssl: Union[SSLContext, bool, Fingerprint] = True, + server_hostname: Optional[str] = None, + proxy_headers: Optional[LooseHeaders] = None, + trace_request_ctx: Optional[Mapping[str, str]] = None, + read_bufsize: Optional[int] = None, + auto_decompress: Optional[bool] = None, + max_line_size: Optional[int] = None, + max_field_size: Optional[int] = None, + ) -> ClientResponse: + + # NOTE: timeout clamps existing connect and read timeouts. We cannot + # set the default to None because we need to detect if the user wants + # to use the existing timeouts by setting timeout to None. + + if self.closed: + raise RuntimeError("Session is closed") + + ssl = _merge_ssl_params(ssl, verify_ssl, ssl_context, fingerprint) + + if data is not None and json is not None: + raise ValueError( + "data and json parameters can not be used at the same time" + ) + elif json is not None: + data = payload.JsonPayload(json, dumps=self._json_serialize) + + if not isinstance(chunked, bool) and chunked is not None: + warnings.warn("Chunk size is deprecated #1615", DeprecationWarning) + + redirects = 0 + history = [] + version = self._version + params = params or {} + + # Merge with default headers and transform to CIMultiDict + headers = self._prepare_headers(headers) + proxy_headers = self._prepare_headers(proxy_headers) + + try: + url = self._build_url(str_or_url) + except ValueError as e: + raise InvalidUrlClientError(str_or_url) from e + + assert self._connector is not None + if url.scheme not in self._connector.allowed_protocol_schema_set: + raise NonHttpUrlClientError(url) + + skip_headers = set(self._skip_auto_headers) + if skip_auto_headers is not None: + for i in skip_auto_headers: + skip_headers.add(istr(i)) + + if proxy is not None: + try: + proxy = URL(proxy) + except ValueError as e: + raise InvalidURL(proxy) from e + + if timeout is sentinel: + real_timeout: ClientTimeout = self._timeout + else: + if not isinstance(timeout, ClientTimeout): + real_timeout = ClientTimeout(total=timeout) + else: + real_timeout = timeout + # timeout is cumulative for all request operations + # (request, redirects, responses, data consuming) + tm = TimeoutHandle( + self._loop, real_timeout.total, ceil_threshold=real_timeout.ceil_threshold + ) + handle = tm.start() + + if read_bufsize is None: + read_bufsize = self._read_bufsize + + if auto_decompress is None: + auto_decompress = self._auto_decompress + + if max_line_size is None: + max_line_size = self._max_line_size + + if max_field_size is None: + max_field_size = self._max_field_size + + traces = [ + Trace( + self, + trace_config, + trace_config.trace_config_ctx(trace_request_ctx=trace_request_ctx), + ) + for trace_config in self._trace_configs + ] + + for trace in traces: + await trace.send_request_start(method, url.update_query(params), headers) + + timer = tm.timer() + try: + with timer: + # https://www.rfc-editor.org/rfc/rfc9112.html#name-retrying-requests + retry_persistent_connection = method in IDEMPOTENT_METHODS + while True: + url, auth_from_url = strip_auth_from_url(url) + if not url.raw_host: + # NOTE: Bail early, otherwise, causes `InvalidURL` through + # NOTE: `self._request_class()` below. + err_exc_cls = ( + InvalidUrlRedirectClientError + if redirects + else InvalidUrlClientError + ) + raise err_exc_cls(url) + if auth and auth_from_url: + raise ValueError( + "Cannot combine AUTH argument with " + "credentials encoded in URL" + ) + + if auth is None: + auth = auth_from_url + if auth is None: + auth = self._default_auth + # It would be confusing if we support explicit + # Authorization header with auth argument + if ( + headers is not None + and auth is not None + and hdrs.AUTHORIZATION in headers + ): + raise ValueError( + "Cannot combine AUTHORIZATION header " + "with AUTH argument or credentials " + "encoded in URL" + ) + + all_cookies = self._cookie_jar.filter_cookies(url) + + if cookies is not None: + tmp_cookie_jar = CookieJar() + tmp_cookie_jar.update_cookies(cookies) + req_cookies = tmp_cookie_jar.filter_cookies(url) + if req_cookies: + all_cookies.load(req_cookies) + + if proxy is not None: + proxy = URL(proxy) + elif self._trust_env: + with suppress(LookupError): + proxy, proxy_auth = get_env_proxy_for_url(url) + + req = self._request_class( + method, + url, + params=params, + headers=headers, + skip_auto_headers=skip_headers, + data=data, + cookies=all_cookies, + auth=auth, + version=version, + compress=compress, + chunked=chunked, + expect100=expect100, + loop=self._loop, + response_class=self._response_class, + proxy=proxy, + proxy_auth=proxy_auth, + timer=timer, + session=self, + ssl=ssl if ssl is not None else True, + server_hostname=server_hostname, + proxy_headers=proxy_headers, + traces=traces, + trust_env=self.trust_env, + ) + + # connection timeout + try: + async with ceil_timeout( + real_timeout.connect, + ceil_threshold=real_timeout.ceil_threshold, + ): + conn = await self._connector.connect( + req, traces=traces, timeout=real_timeout + ) + except asyncio.TimeoutError as exc: + raise ConnectionTimeoutError( + f"Connection timeout to host {url}" + ) from exc + + assert conn.transport is not None + + assert conn.protocol is not None + conn.protocol.set_response_params( + timer=timer, + skip_payload=method_must_be_empty_body(method), + read_until_eof=read_until_eof, + auto_decompress=auto_decompress, + read_timeout=real_timeout.sock_read, + read_bufsize=read_bufsize, + timeout_ceil_threshold=self._connector._timeout_ceil_threshold, + max_line_size=max_line_size, + max_field_size=max_field_size, + ) + + try: + try: + resp = await req.send(conn) + try: + await resp.start(conn) + except BaseException: + resp.close() + raise + except BaseException: + conn.close() + raise + except (ClientOSError, ServerDisconnectedError): + if retry_persistent_connection: + retry_persistent_connection = False + continue + raise + except ClientError: + raise + except OSError as exc: + if exc.errno is None and isinstance(exc, asyncio.TimeoutError): + raise + raise ClientOSError(*exc.args) from exc + + self._cookie_jar.update_cookies(resp.cookies, resp.url) + + # redirects + if resp.status in (301, 302, 303, 307, 308) and allow_redirects: + + for trace in traces: + await trace.send_request_redirect( + method, url.update_query(params), headers, resp + ) + + redirects += 1 + history.append(resp) + if max_redirects and redirects >= max_redirects: + resp.close() + raise TooManyRedirects( + history[0].request_info, tuple(history) + ) + + # For 301 and 302, mimic IE, now changed in RFC + # https://github.com/kennethreitz/requests/pull/269 + if (resp.status == 303 and resp.method != hdrs.METH_HEAD) or ( + resp.status in (301, 302) and resp.method == hdrs.METH_POST + ): + method = hdrs.METH_GET + data = None + if headers.get(hdrs.CONTENT_LENGTH): + headers.pop(hdrs.CONTENT_LENGTH) + + r_url = resp.headers.get(hdrs.LOCATION) or resp.headers.get( + hdrs.URI + ) + if r_url is None: + # see github.com/aio-libs/aiohttp/issues/2022 + break + else: + # reading from correct redirection + # response is forbidden + resp.release() + + try: + parsed_redirect_url = URL( + r_url, encoded=not self._requote_redirect_url + ) + except ValueError as e: + raise InvalidUrlRedirectClientError( + r_url, + "Server attempted redirecting to a location that does not look like a URL", + ) from e + + scheme = parsed_redirect_url.scheme + if scheme not in HTTP_AND_EMPTY_SCHEMA_SET: + resp.close() + raise NonHttpUrlRedirectClientError(r_url) + elif not scheme: + parsed_redirect_url = url.join(parsed_redirect_url) + + try: + redirect_origin = parsed_redirect_url.origin() + except ValueError as origin_val_err: + raise InvalidUrlRedirectClientError( + parsed_redirect_url, + "Invalid redirect URL origin", + ) from origin_val_err + + if url.origin() != redirect_origin: + auth = None + headers.pop(hdrs.AUTHORIZATION, None) + + url = parsed_redirect_url + params = {} + resp.release() + continue + + break + + # check response status + if raise_for_status is None: + raise_for_status = self._raise_for_status + + if raise_for_status is None: + pass + elif callable(raise_for_status): + await raise_for_status(resp) + elif raise_for_status: + resp.raise_for_status() + + # register connection + if handle is not None: + if resp.connection is not None: + resp.connection.add_callback(handle.cancel) + else: + handle.cancel() + + resp._history = tuple(history) + + for trace in traces: + await trace.send_request_end( + method, url.update_query(params), headers, resp + ) + return resp + + except BaseException as e: + # cleanup timer + tm.close() + if handle: + handle.cancel() + handle = None + + for trace in traces: + await trace.send_request_exception( + method, url.update_query(params), headers, e + ) + raise + + def ws_connect( + self, + url: StrOrURL, + *, + method: str = hdrs.METH_GET, + protocols: Iterable[str] = (), + timeout: float = 10.0, + receive_timeout: Optional[float] = None, + autoclose: bool = True, + autoping: bool = True, + heartbeat: Optional[float] = None, + auth: Optional[BasicAuth] = None, + origin: Optional[str] = None, + params: Optional[Mapping[str, str]] = None, + headers: Optional[LooseHeaders] = None, + proxy: Optional[StrOrURL] = None, + proxy_auth: Optional[BasicAuth] = None, + ssl: Union[SSLContext, bool, Fingerprint] = True, + verify_ssl: Optional[bool] = None, + fingerprint: Optional[bytes] = None, + ssl_context: Optional[SSLContext] = None, + proxy_headers: Optional[LooseHeaders] = None, + compress: int = 0, + max_msg_size: int = 4 * 1024 * 1024, + ) -> "_WSRequestContextManager": + """Initiate websocket connection.""" + return _WSRequestContextManager( + self._ws_connect( + url, + method=method, + protocols=protocols, + timeout=timeout, + receive_timeout=receive_timeout, + autoclose=autoclose, + autoping=autoping, + heartbeat=heartbeat, + auth=auth, + origin=origin, + params=params, + headers=headers, + proxy=proxy, + proxy_auth=proxy_auth, + ssl=ssl, + verify_ssl=verify_ssl, + fingerprint=fingerprint, + ssl_context=ssl_context, + proxy_headers=proxy_headers, + compress=compress, + max_msg_size=max_msg_size, + ) + ) + + async def _ws_connect( + self, + url: StrOrURL, + *, + method: str = hdrs.METH_GET, + protocols: Iterable[str] = (), + timeout: float = 10.0, + receive_timeout: Optional[float] = None, + autoclose: bool = True, + autoping: bool = True, + heartbeat: Optional[float] = None, + auth: Optional[BasicAuth] = None, + origin: Optional[str] = None, + params: Optional[Mapping[str, str]] = None, + headers: Optional[LooseHeaders] = None, + proxy: Optional[StrOrURL] = None, + proxy_auth: Optional[BasicAuth] = None, + ssl: Union[SSLContext, bool, Fingerprint] = True, + verify_ssl: Optional[bool] = None, + fingerprint: Optional[bytes] = None, + ssl_context: Optional[SSLContext] = None, + proxy_headers: Optional[LooseHeaders] = None, + compress: int = 0, + max_msg_size: int = 4 * 1024 * 1024, + ) -> ClientWebSocketResponse: + + if headers is None: + real_headers: CIMultiDict[str] = CIMultiDict() + else: + real_headers = CIMultiDict(headers) + + default_headers = { + hdrs.UPGRADE: "websocket", + hdrs.CONNECTION: "Upgrade", + hdrs.SEC_WEBSOCKET_VERSION: "13", + } + + for key, value in default_headers.items(): + real_headers.setdefault(key, value) + + sec_key = base64.b64encode(os.urandom(16)) + real_headers[hdrs.SEC_WEBSOCKET_KEY] = sec_key.decode() + + if protocols: + real_headers[hdrs.SEC_WEBSOCKET_PROTOCOL] = ",".join(protocols) + if origin is not None: + real_headers[hdrs.ORIGIN] = origin + if compress: + extstr = ws_ext_gen(compress=compress) + real_headers[hdrs.SEC_WEBSOCKET_EXTENSIONS] = extstr + + # For the sake of backward compatibility, if user passes in None, convert it to True + if ssl is None: + warnings.warn( + "ssl=None is deprecated, please use ssl=True", + DeprecationWarning, + stacklevel=2, + ) + ssl = True + ssl = _merge_ssl_params(ssl, verify_ssl, ssl_context, fingerprint) + + # send request + resp = await self.request( + method, + url, + params=params, + headers=real_headers, + read_until_eof=False, + auth=auth, + proxy=proxy, + proxy_auth=proxy_auth, + ssl=ssl, + proxy_headers=proxy_headers, + ) + + try: + # check handshake + if resp.status != 101: + raise WSServerHandshakeError( + resp.request_info, + resp.history, + message="Invalid response status", + status=resp.status, + headers=resp.headers, + ) + + if resp.headers.get(hdrs.UPGRADE, "").lower() != "websocket": + raise WSServerHandshakeError( + resp.request_info, + resp.history, + message="Invalid upgrade header", + status=resp.status, + headers=resp.headers, + ) + + if resp.headers.get(hdrs.CONNECTION, "").lower() != "upgrade": + raise WSServerHandshakeError( + resp.request_info, + resp.history, + message="Invalid connection header", + status=resp.status, + headers=resp.headers, + ) + + # key calculation + r_key = resp.headers.get(hdrs.SEC_WEBSOCKET_ACCEPT, "") + match = base64.b64encode(hashlib.sha1(sec_key + WS_KEY).digest()).decode() + if r_key != match: + raise WSServerHandshakeError( + resp.request_info, + resp.history, + message="Invalid challenge response", + status=resp.status, + headers=resp.headers, + ) + + # websocket protocol + protocol = None + if protocols and hdrs.SEC_WEBSOCKET_PROTOCOL in resp.headers: + resp_protocols = [ + proto.strip() + for proto in resp.headers[hdrs.SEC_WEBSOCKET_PROTOCOL].split(",") + ] + + for proto in resp_protocols: + if proto in protocols: + protocol = proto + break + + # websocket compress + notakeover = False + if compress: + compress_hdrs = resp.headers.get(hdrs.SEC_WEBSOCKET_EXTENSIONS) + if compress_hdrs: + try: + compress, notakeover = ws_ext_parse(compress_hdrs) + except WSHandshakeError as exc: + raise WSServerHandshakeError( + resp.request_info, + resp.history, + message=exc.args[0], + status=resp.status, + headers=resp.headers, + ) from exc + else: + compress = 0 + notakeover = False + + conn = resp.connection + assert conn is not None + conn_proto = conn.protocol + assert conn_proto is not None + + # For WS connection the read_timeout must be either receive_timeout or greater + # None == no timeout, i.e. infinite timeout, so None is the max timeout possible + if receive_timeout is None: + # Reset regardless + conn_proto.read_timeout = receive_timeout + elif conn_proto.read_timeout is not None: + # If read_timeout was set check which wins + conn_proto.read_timeout = max(receive_timeout, conn_proto.read_timeout) + + transport = conn.transport + assert transport is not None + reader: FlowControlDataQueue[WSMessage] = FlowControlDataQueue( + conn_proto, 2**16, loop=self._loop + ) + conn_proto.set_parser(WebSocketReader(reader, max_msg_size), reader) + writer = WebSocketWriter( + conn_proto, + transport, + use_mask=True, + compress=compress, + notakeover=notakeover, + ) + except BaseException: + resp.close() + raise + else: + return self._ws_response_class( + reader, + writer, + protocol, + resp, + timeout, + autoclose, + autoping, + self._loop, + receive_timeout=receive_timeout, + heartbeat=heartbeat, + compress=compress, + client_notakeover=notakeover, + ) + + def _prepare_headers(self, headers: Optional[LooseHeaders]) -> "CIMultiDict[str]": + """Add default headers and transform it to CIMultiDict""" + # Convert headers to MultiDict + result = CIMultiDict(self._default_headers) + if headers: + if not isinstance(headers, (MultiDictProxy, MultiDict)): + headers = CIMultiDict(headers) + added_names: Set[str] = set() + for key, value in headers.items(): + if key in added_names: + result.add(key, value) + else: + result[key] = value + added_names.add(key) + return result + + if sys.version_info >= (3, 11) and TYPE_CHECKING: + + def get( + self, + url: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> "_RequestContextManager": ... + + def options( + self, + url: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> "_RequestContextManager": ... + + def head( + self, + url: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> "_RequestContextManager": ... + + def post( + self, + url: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> "_RequestContextManager": ... + + def put( + self, + url: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> "_RequestContextManager": ... + + def patch( + self, + url: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> "_RequestContextManager": ... + + def delete( + self, + url: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> "_RequestContextManager": ... + + else: + + def get( + self, url: StrOrURL, *, allow_redirects: bool = True, **kwargs: Any + ) -> "_RequestContextManager": + """Perform HTTP GET request.""" + return _RequestContextManager( + self._request( + hdrs.METH_GET, url, allow_redirects=allow_redirects, **kwargs + ) + ) + + def options( + self, url: StrOrURL, *, allow_redirects: bool = True, **kwargs: Any + ) -> "_RequestContextManager": + """Perform HTTP OPTIONS request.""" + return _RequestContextManager( + self._request( + hdrs.METH_OPTIONS, url, allow_redirects=allow_redirects, **kwargs + ) + ) + + def head( + self, url: StrOrURL, *, allow_redirects: bool = False, **kwargs: Any + ) -> "_RequestContextManager": + """Perform HTTP HEAD request.""" + return _RequestContextManager( + self._request( + hdrs.METH_HEAD, url, allow_redirects=allow_redirects, **kwargs + ) + ) + + def post( + self, url: StrOrURL, *, data: Any = None, **kwargs: Any + ) -> "_RequestContextManager": + """Perform HTTP POST request.""" + return _RequestContextManager( + self._request(hdrs.METH_POST, url, data=data, **kwargs) + ) + + def put( + self, url: StrOrURL, *, data: Any = None, **kwargs: Any + ) -> "_RequestContextManager": + """Perform HTTP PUT request.""" + return _RequestContextManager( + self._request(hdrs.METH_PUT, url, data=data, **kwargs) + ) + + def patch( + self, url: StrOrURL, *, data: Any = None, **kwargs: Any + ) -> "_RequestContextManager": + """Perform HTTP PATCH request.""" + return _RequestContextManager( + self._request(hdrs.METH_PATCH, url, data=data, **kwargs) + ) + + def delete(self, url: StrOrURL, **kwargs: Any) -> "_RequestContextManager": + """Perform HTTP DELETE request.""" + return _RequestContextManager( + self._request(hdrs.METH_DELETE, url, **kwargs) + ) + + async def close(self) -> None: + """Close underlying connector. + + Release all acquired resources. + """ + if not self.closed: + if self._connector is not None and self._connector_owner: + await self._connector.close() + self._connector = None + + @property + def closed(self) -> bool: + """Is client session closed. + + A readonly property. + """ + return self._connector is None or self._connector.closed + + @property + def connector(self) -> Optional[BaseConnector]: + """Connector instance used for the session.""" + return self._connector + + @property + def cookie_jar(self) -> AbstractCookieJar: + """The session cookies.""" + return self._cookie_jar + + @property + def version(self) -> Tuple[int, int]: + """The session HTTP protocol version.""" + return self._version + + @property + def requote_redirect_url(self) -> bool: + """Do URL requoting on redirection handling.""" + return self._requote_redirect_url + + @requote_redirect_url.setter + def requote_redirect_url(self, val: bool) -> None: + """Do URL requoting on redirection handling.""" + warnings.warn( + "session.requote_redirect_url modification " "is deprecated #2778", + DeprecationWarning, + stacklevel=2, + ) + self._requote_redirect_url = val + + @property + def loop(self) -> asyncio.AbstractEventLoop: + """Session's loop.""" + warnings.warn( + "client.loop property is deprecated", DeprecationWarning, stacklevel=2 + ) + return self._loop + + @property + def timeout(self) -> ClientTimeout: + """Timeout for the session.""" + return self._timeout + + @property + def headers(self) -> "CIMultiDict[str]": + """The default headers of the client session.""" + return self._default_headers + + @property + def skip_auto_headers(self) -> FrozenSet[istr]: + """Headers for which autogeneration should be skipped""" + return self._skip_auto_headers + + @property + def auth(self) -> Optional[BasicAuth]: + """An object that represents HTTP Basic Authorization""" + return self._default_auth + + @property + def json_serialize(self) -> JSONEncoder: + """Json serializer callable""" + return self._json_serialize + + @property + def connector_owner(self) -> bool: + """Should connector be closed on session closing""" + return self._connector_owner + + @property + def raise_for_status( + self, + ) -> Union[bool, Callable[[ClientResponse], Awaitable[None]]]: + """Should `ClientResponse.raise_for_status()` be called for each response.""" + return self._raise_for_status + + @property + def auto_decompress(self) -> bool: + """Should the body response be automatically decompressed.""" + return self._auto_decompress + + @property + def trust_env(self) -> bool: + """ + Should proxies information from environment or netrc be trusted. + + Information is from HTTP_PROXY / HTTPS_PROXY environment variables + or ~/.netrc file if present. + """ + return self._trust_env + + @property + def trace_configs(self) -> List[TraceConfig]: + """A list of TraceConfig instances used for client tracing""" + return self._trace_configs + + def detach(self) -> None: + """Detach connector from session without closing the former. + + Session is switched to closed state anyway. + """ + self._connector = None + + def __enter__(self) -> None: + raise TypeError("Use async with instead") + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + # __exit__ should exist in pair with __enter__ but never executed + pass # pragma: no cover + + async def __aenter__(self) -> "ClientSession": + return self + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + await self.close() + + +class _BaseRequestContextManager(Coroutine[Any, Any, _RetType], Generic[_RetType]): + + __slots__ = ("_coro", "_resp") + + def __init__(self, coro: Coroutine["asyncio.Future[Any]", None, _RetType]) -> None: + self._coro = coro + + def send(self, arg: None) -> "asyncio.Future[Any]": + return self._coro.send(arg) + + def throw(self, *args: Any, **kwargs: Any) -> "asyncio.Future[Any]": + return self._coro.throw(*args, **kwargs) + + def close(self) -> None: + return self._coro.close() + + def __await__(self) -> Generator[Any, None, _RetType]: + ret = self._coro.__await__() + return ret + + def __iter__(self) -> Generator[Any, None, _RetType]: + return self.__await__() + + async def __aenter__(self) -> _RetType: + self._resp = await self._coro + return self._resp + + +class _RequestContextManager(_BaseRequestContextManager[ClientResponse]): + __slots__ = () + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc: Optional[BaseException], + tb: Optional[TracebackType], + ) -> None: + # We're basing behavior on the exception as it can be caused by + # user code unrelated to the status of the connection. If you + # would like to close a connection you must do that + # explicitly. Otherwise connection error handling should kick in + # and close/recycle the connection as required. + self._resp.release() + await self._resp.wait_for_close() + + +class _WSRequestContextManager(_BaseRequestContextManager[ClientWebSocketResponse]): + __slots__ = () + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc: Optional[BaseException], + tb: Optional[TracebackType], + ) -> None: + await self._resp.close() + + +class _SessionRequestContextManager: + + __slots__ = ("_coro", "_resp", "_session") + + def __init__( + self, + coro: Coroutine["asyncio.Future[Any]", None, ClientResponse], + session: ClientSession, + ) -> None: + self._coro = coro + self._resp: Optional[ClientResponse] = None + self._session = session + + async def __aenter__(self) -> ClientResponse: + try: + self._resp = await self._coro + except BaseException: + await self._session.close() + raise + else: + return self._resp + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc: Optional[BaseException], + tb: Optional[TracebackType], + ) -> None: + assert self._resp is not None + self._resp.close() + await self._session.close() + + +def request( + method: str, + url: StrOrURL, + *, + params: Optional[Mapping[str, str]] = None, + data: Any = None, + json: Any = None, + headers: Optional[LooseHeaders] = None, + skip_auto_headers: Optional[Iterable[str]] = None, + auth: Optional[BasicAuth] = None, + allow_redirects: bool = True, + max_redirects: int = 10, + compress: Optional[str] = None, + chunked: Optional[bool] = None, + expect100: bool = False, + raise_for_status: Optional[bool] = None, + read_until_eof: bool = True, + proxy: Optional[StrOrURL] = None, + proxy_auth: Optional[BasicAuth] = None, + timeout: Union[ClientTimeout, object] = sentinel, + cookies: Optional[LooseCookies] = None, + version: HttpVersion = http.HttpVersion11, + connector: Optional[BaseConnector] = None, + read_bufsize: Optional[int] = None, + loop: Optional[asyncio.AbstractEventLoop] = None, + max_line_size: int = 8190, + max_field_size: int = 8190, +) -> _SessionRequestContextManager: + """Constructs and sends a request. + + Returns response object. + method - HTTP method + url - request url + params - (optional) Dictionary or bytes to be sent in the query + string of the new request + data - (optional) Dictionary, bytes, or file-like object to + send in the body of the request + json - (optional) Any json compatible python object + headers - (optional) Dictionary of HTTP Headers to send with + the request + cookies - (optional) Dict object to send with the request + auth - (optional) BasicAuth named tuple represent HTTP Basic Auth + auth - aiohttp.helpers.BasicAuth + allow_redirects - (optional) If set to False, do not follow + redirects + version - Request HTTP version. + compress - Set to True if request has to be compressed + with deflate encoding. + chunked - Set to chunk size for chunked transfer encoding. + expect100 - Expect 100-continue response from server. + connector - BaseConnector sub-class instance to support + connection pooling. + read_until_eof - Read response until eof if response + does not have Content-Length header. + loop - Optional event loop. + timeout - Optional ClientTimeout settings structure, 5min + total timeout by default. + Usage:: + >>> import aiohttp + >>> resp = await aiohttp.request('GET', 'http://python.org/') + >>> resp + + >>> data = await resp.read() + """ + connector_owner = False + if connector is None: + connector_owner = True + connector = TCPConnector(loop=loop, force_close=True) + + session = ClientSession( + loop=loop, + cookies=cookies, + version=version, + timeout=timeout, + connector=connector, + connector_owner=connector_owner, + ) + + return _SessionRequestContextManager( + session._request( + method, + url, + params=params, + data=data, + json=json, + headers=headers, + skip_auto_headers=skip_auto_headers, + auth=auth, + allow_redirects=allow_redirects, + max_redirects=max_redirects, + compress=compress, + chunked=chunked, + expect100=expect100, + raise_for_status=raise_for_status, + read_until_eof=read_until_eof, + proxy=proxy, + proxy_auth=proxy_auth, + read_bufsize=read_bufsize, + max_line_size=max_line_size, + max_field_size=max_field_size, + ), + session, + ) diff --git a/env/Lib/site-packages/aiohttp/client_exceptions.py b/env/Lib/site-packages/aiohttp/client_exceptions.py new file mode 100644 index 0000000..ff29b3d --- /dev/null +++ b/env/Lib/site-packages/aiohttp/client_exceptions.py @@ -0,0 +1,396 @@ +"""HTTP related errors.""" + +import asyncio +import warnings +from typing import TYPE_CHECKING, Optional, Tuple, Union + +from .http_parser import RawResponseMessage +from .typedefs import LooseHeaders, StrOrURL + +try: + import ssl + + SSLContext = ssl.SSLContext +except ImportError: # pragma: no cover + ssl = SSLContext = None # type: ignore[assignment] + + +if TYPE_CHECKING: + from .client_reqrep import ClientResponse, ConnectionKey, Fingerprint, RequestInfo +else: + RequestInfo = ClientResponse = ConnectionKey = None + +__all__ = ( + "ClientError", + "ClientConnectionError", + "ClientOSError", + "ClientConnectorError", + "ClientProxyConnectionError", + "ClientSSLError", + "ClientConnectorSSLError", + "ClientConnectorCertificateError", + "ConnectionTimeoutError", + "SocketTimeoutError", + "ServerConnectionError", + "ServerTimeoutError", + "ServerDisconnectedError", + "ServerFingerprintMismatch", + "ClientResponseError", + "ClientHttpProxyError", + "WSServerHandshakeError", + "ContentTypeError", + "ClientPayloadError", + "InvalidURL", + "InvalidUrlClientError", + "RedirectClientError", + "NonHttpUrlClientError", + "InvalidUrlRedirectClientError", + "NonHttpUrlRedirectClientError", +) + + +class ClientError(Exception): + """Base class for client connection errors.""" + + +class ClientResponseError(ClientError): + """Base class for exceptions that occur after getting a response. + + request_info: An instance of RequestInfo. + history: A sequence of responses, if redirects occurred. + status: HTTP status code. + message: Error message. + headers: Response headers. + """ + + def __init__( + self, + request_info: RequestInfo, + history: Tuple[ClientResponse, ...], + *, + code: Optional[int] = None, + status: Optional[int] = None, + message: str = "", + headers: Optional[LooseHeaders] = None, + ) -> None: + self.request_info = request_info + if code is not None: + if status is not None: + raise ValueError( + "Both code and status arguments are provided; " + "code is deprecated, use status instead" + ) + warnings.warn( + "code argument is deprecated, use status instead", + DeprecationWarning, + stacklevel=2, + ) + if status is not None: + self.status = status + elif code is not None: + self.status = code + else: + self.status = 0 + self.message = message + self.headers = headers + self.history = history + self.args = (request_info, history) + + def __str__(self) -> str: + return "{}, message={!r}, url={!r}".format( + self.status, + self.message, + str(self.request_info.real_url), + ) + + def __repr__(self) -> str: + args = f"{self.request_info!r}, {self.history!r}" + if self.status != 0: + args += f", status={self.status!r}" + if self.message != "": + args += f", message={self.message!r}" + if self.headers is not None: + args += f", headers={self.headers!r}" + return f"{type(self).__name__}({args})" + + @property + def code(self) -> int: + warnings.warn( + "code property is deprecated, use status instead", + DeprecationWarning, + stacklevel=2, + ) + return self.status + + @code.setter + def code(self, value: int) -> None: + warnings.warn( + "code property is deprecated, use status instead", + DeprecationWarning, + stacklevel=2, + ) + self.status = value + + +class ContentTypeError(ClientResponseError): + """ContentType found is not valid.""" + + +class WSServerHandshakeError(ClientResponseError): + """websocket server handshake error.""" + + +class ClientHttpProxyError(ClientResponseError): + """HTTP proxy error. + + Raised in :class:`aiohttp.connector.TCPConnector` if + proxy responds with status other than ``200 OK`` + on ``CONNECT`` request. + """ + + +class TooManyRedirects(ClientResponseError): + """Client was redirected too many times.""" + + +class ClientConnectionError(ClientError): + """Base class for client socket errors.""" + + +class ClientOSError(ClientConnectionError, OSError): + """OSError error.""" + + +class ClientConnectorError(ClientOSError): + """Client connector error. + + Raised in :class:`aiohttp.connector.TCPConnector` if + a connection can not be established. + """ + + def __init__(self, connection_key: ConnectionKey, os_error: OSError) -> None: + self._conn_key = connection_key + self._os_error = os_error + super().__init__(os_error.errno, os_error.strerror) + self.args = (connection_key, os_error) + + @property + def os_error(self) -> OSError: + return self._os_error + + @property + def host(self) -> str: + return self._conn_key.host + + @property + def port(self) -> Optional[int]: + return self._conn_key.port + + @property + def ssl(self) -> Union[SSLContext, bool, "Fingerprint"]: + return self._conn_key.ssl + + def __str__(self) -> str: + return "Cannot connect to host {0.host}:{0.port} ssl:{1} [{2}]".format( + self, "default" if self.ssl is True else self.ssl, self.strerror + ) + + # OSError.__reduce__ does too much black magick + __reduce__ = BaseException.__reduce__ + + +class ClientProxyConnectionError(ClientConnectorError): + """Proxy connection error. + + Raised in :class:`aiohttp.connector.TCPConnector` if + connection to proxy can not be established. + """ + + +class UnixClientConnectorError(ClientConnectorError): + """Unix connector error. + + Raised in :py:class:`aiohttp.connector.UnixConnector` + if connection to unix socket can not be established. + """ + + def __init__( + self, path: str, connection_key: ConnectionKey, os_error: OSError + ) -> None: + self._path = path + super().__init__(connection_key, os_error) + + @property + def path(self) -> str: + return self._path + + def __str__(self) -> str: + return "Cannot connect to unix socket {0.path} ssl:{1} [{2}]".format( + self, "default" if self.ssl is True else self.ssl, self.strerror + ) + + +class ServerConnectionError(ClientConnectionError): + """Server connection errors.""" + + +class ServerDisconnectedError(ServerConnectionError): + """Server disconnected.""" + + def __init__(self, message: Union[RawResponseMessage, str, None] = None) -> None: + if message is None: + message = "Server disconnected" + + self.args = (message,) + self.message = message + + +class ServerTimeoutError(ServerConnectionError, asyncio.TimeoutError): + """Server timeout error.""" + + +class ConnectionTimeoutError(ServerTimeoutError): + """Connection timeout error.""" + + +class SocketTimeoutError(ServerTimeoutError): + """Socket timeout error.""" + + +class ServerFingerprintMismatch(ServerConnectionError): + """SSL certificate does not match expected fingerprint.""" + + def __init__(self, expected: bytes, got: bytes, host: str, port: int) -> None: + self.expected = expected + self.got = got + self.host = host + self.port = port + self.args = (expected, got, host, port) + + def __repr__(self) -> str: + return "<{} expected={!r} got={!r} host={!r} port={!r}>".format( + self.__class__.__name__, self.expected, self.got, self.host, self.port + ) + + +class ClientPayloadError(ClientError): + """Response payload error.""" + + +class InvalidURL(ClientError, ValueError): + """Invalid URL. + + URL used for fetching is malformed, e.g. it doesn't contains host + part. + """ + + # Derive from ValueError for backward compatibility + + def __init__(self, url: StrOrURL, description: Union[str, None] = None) -> None: + # The type of url is not yarl.URL because the exception can be raised + # on URL(url) call + self._url = url + self._description = description + + if description: + super().__init__(url, description) + else: + super().__init__(url) + + @property + def url(self) -> StrOrURL: + return self._url + + @property + def description(self) -> "str | None": + return self._description + + def __repr__(self) -> str: + return f"<{self.__class__.__name__} {self}>" + + def __str__(self) -> str: + if self._description: + return f"{self._url} - {self._description}" + return str(self._url) + + +class InvalidUrlClientError(InvalidURL): + """Invalid URL client error.""" + + +class RedirectClientError(ClientError): + """Client redirect error.""" + + +class NonHttpUrlClientError(ClientError): + """Non http URL client error.""" + + +class InvalidUrlRedirectClientError(InvalidUrlClientError, RedirectClientError): + """Invalid URL redirect client error.""" + + +class NonHttpUrlRedirectClientError(NonHttpUrlClientError, RedirectClientError): + """Non http URL redirect client error.""" + + +class ClientSSLError(ClientConnectorError): + """Base error for ssl.*Errors.""" + + +if ssl is not None: + cert_errors = (ssl.CertificateError,) + cert_errors_bases = ( + ClientSSLError, + ssl.CertificateError, + ) + + ssl_errors = (ssl.SSLError,) + ssl_error_bases = (ClientSSLError, ssl.SSLError) +else: # pragma: no cover + cert_errors = tuple() + cert_errors_bases = ( + ClientSSLError, + ValueError, + ) + + ssl_errors = tuple() + ssl_error_bases = (ClientSSLError,) + + +class ClientConnectorSSLError(*ssl_error_bases): # type: ignore[misc] + """Response ssl error.""" + + +class ClientConnectorCertificateError(*cert_errors_bases): # type: ignore[misc] + """Response certificate error.""" + + def __init__( + self, connection_key: ConnectionKey, certificate_error: Exception + ) -> None: + self._conn_key = connection_key + self._certificate_error = certificate_error + self.args = (connection_key, certificate_error) + + @property + def certificate_error(self) -> Exception: + return self._certificate_error + + @property + def host(self) -> str: + return self._conn_key.host + + @property + def port(self) -> Optional[int]: + return self._conn_key.port + + @property + def ssl(self) -> bool: + return self._conn_key.is_ssl + + def __str__(self) -> str: + return ( + "Cannot connect to host {0.host}:{0.port} ssl:{0.ssl} " + "[{0.certificate_error.__class__.__name__}: " + "{0.certificate_error.args}]".format(self) + ) diff --git a/env/Lib/site-packages/aiohttp/client_proto.py b/env/Lib/site-packages/aiohttp/client_proto.py new file mode 100644 index 0000000..f8c8324 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/client_proto.py @@ -0,0 +1,304 @@ +import asyncio +from contextlib import suppress +from typing import Any, Optional, Tuple + +from .base_protocol import BaseProtocol +from .client_exceptions import ( + ClientOSError, + ClientPayloadError, + ServerDisconnectedError, + SocketTimeoutError, +) +from .helpers import ( + _EXC_SENTINEL, + BaseTimerContext, + set_exception, + status_code_must_be_empty_body, +) +from .http import HttpResponseParser, RawResponseMessage +from .http_exceptions import HttpProcessingError +from .streams import EMPTY_PAYLOAD, DataQueue, StreamReader + + +class ResponseHandler(BaseProtocol, DataQueue[Tuple[RawResponseMessage, StreamReader]]): + """Helper class to adapt between Protocol and StreamReader.""" + + def __init__(self, loop: asyncio.AbstractEventLoop) -> None: + BaseProtocol.__init__(self, loop=loop) + DataQueue.__init__(self, loop) + + self._should_close = False + + self._payload: Optional[StreamReader] = None + self._skip_payload = False + self._payload_parser = None + + self._timer = None + + self._tail = b"" + self._upgraded = False + self._parser: Optional[HttpResponseParser] = None + + self._read_timeout: Optional[float] = None + self._read_timeout_handle: Optional[asyncio.TimerHandle] = None + + self._timeout_ceil_threshold: Optional[float] = 5 + + @property + def upgraded(self) -> bool: + return self._upgraded + + @property + def should_close(self) -> bool: + if self._payload is not None and not self._payload.is_eof() or self._upgraded: + return True + + return ( + self._should_close + or self._upgraded + or self.exception() is not None + or self._payload_parser is not None + or len(self) > 0 + or bool(self._tail) + ) + + def force_close(self) -> None: + self._should_close = True + + def close(self) -> None: + transport = self.transport + if transport is not None: + transport.close() + self.transport = None + self._payload = None + self._drop_timeout() + + def is_connected(self) -> bool: + return self.transport is not None and not self.transport.is_closing() + + def connection_lost(self, exc: Optional[BaseException]) -> None: + self._drop_timeout() + + original_connection_error = exc + reraised_exc = original_connection_error + + connection_closed_cleanly = original_connection_error is None + + if self._payload_parser is not None: + with suppress(Exception): # FIXME: log this somehow? + self._payload_parser.feed_eof() + + uncompleted = None + if self._parser is not None: + try: + uncompleted = self._parser.feed_eof() + except Exception as underlying_exc: + if self._payload is not None: + client_payload_exc_msg = ( + f"Response payload is not completed: {underlying_exc !r}" + ) + if not connection_closed_cleanly: + client_payload_exc_msg = ( + f"{client_payload_exc_msg !s}. " + f"{original_connection_error !r}" + ) + set_exception( + self._payload, + ClientPayloadError(client_payload_exc_msg), + underlying_exc, + ) + + if not self.is_eof(): + if isinstance(original_connection_error, OSError): + reraised_exc = ClientOSError(*original_connection_error.args) + if connection_closed_cleanly: + reraised_exc = ServerDisconnectedError(uncompleted) + # assigns self._should_close to True as side effect, + # we do it anyway below + underlying_non_eof_exc = ( + _EXC_SENTINEL + if connection_closed_cleanly + else original_connection_error + ) + assert underlying_non_eof_exc is not None + assert reraised_exc is not None + self.set_exception(reraised_exc, underlying_non_eof_exc) + + self._should_close = True + self._parser = None + self._payload = None + self._payload_parser = None + self._reading_paused = False + + super().connection_lost(reraised_exc) + + def eof_received(self) -> None: + # should call parser.feed_eof() most likely + self._drop_timeout() + + def pause_reading(self) -> None: + super().pause_reading() + self._drop_timeout() + + def resume_reading(self) -> None: + super().resume_reading() + self._reschedule_timeout() + + def set_exception( + self, + exc: BaseException, + exc_cause: BaseException = _EXC_SENTINEL, + ) -> None: + self._should_close = True + self._drop_timeout() + super().set_exception(exc, exc_cause) + + def set_parser(self, parser: Any, payload: Any) -> None: + # TODO: actual types are: + # parser: WebSocketReader + # payload: FlowControlDataQueue + # but they are not generi enough + # Need an ABC for both types + self._payload = payload + self._payload_parser = parser + + self._drop_timeout() + + if self._tail: + data, self._tail = self._tail, b"" + self.data_received(data) + + def set_response_params( + self, + *, + timer: Optional[BaseTimerContext] = None, + skip_payload: bool = False, + read_until_eof: bool = False, + auto_decompress: bool = True, + read_timeout: Optional[float] = None, + read_bufsize: int = 2**16, + timeout_ceil_threshold: float = 5, + max_line_size: int = 8190, + max_field_size: int = 8190, + ) -> None: + self._skip_payload = skip_payload + + self._read_timeout = read_timeout + + self._timeout_ceil_threshold = timeout_ceil_threshold + + self._parser = HttpResponseParser( + self, + self._loop, + read_bufsize, + timer=timer, + payload_exception=ClientPayloadError, + response_with_body=not skip_payload, + read_until_eof=read_until_eof, + auto_decompress=auto_decompress, + max_line_size=max_line_size, + max_field_size=max_field_size, + ) + + if self._tail: + data, self._tail = self._tail, b"" + self.data_received(data) + + def _drop_timeout(self) -> None: + if self._read_timeout_handle is not None: + self._read_timeout_handle.cancel() + self._read_timeout_handle = None + + def _reschedule_timeout(self) -> None: + timeout = self._read_timeout + if self._read_timeout_handle is not None: + self._read_timeout_handle.cancel() + + if timeout: + self._read_timeout_handle = self._loop.call_later( + timeout, self._on_read_timeout + ) + else: + self._read_timeout_handle = None + + def start_timeout(self) -> None: + self._reschedule_timeout() + + @property + def read_timeout(self) -> Optional[float]: + return self._read_timeout + + @read_timeout.setter + def read_timeout(self, read_timeout: Optional[float]) -> None: + self._read_timeout = read_timeout + + def _on_read_timeout(self) -> None: + exc = SocketTimeoutError("Timeout on reading data from socket") + self.set_exception(exc) + if self._payload is not None: + set_exception(self._payload, exc) + + def data_received(self, data: bytes) -> None: + self._reschedule_timeout() + + if not data: + return + + # custom payload parser + if self._payload_parser is not None: + eof, tail = self._payload_parser.feed_data(data) + if eof: + self._payload = None + self._payload_parser = None + + if tail: + self.data_received(tail) + return + else: + if self._upgraded or self._parser is None: + # i.e. websocket connection, websocket parser is not set yet + self._tail += data + else: + # parse http messages + try: + messages, upgraded, tail = self._parser.feed_data(data) + except BaseException as underlying_exc: + if self.transport is not None: + # connection.release() could be called BEFORE + # data_received(), the transport is already + # closed in this case + self.transport.close() + # should_close is True after the call + self.set_exception(HttpProcessingError(), underlying_exc) + return + + self._upgraded = upgraded + + payload: Optional[StreamReader] = None + for message, payload in messages: + if message.should_close: + self._should_close = True + + self._payload = payload + + if self._skip_payload or status_code_must_be_empty_body( + message.code + ): + self.feed_data((message, EMPTY_PAYLOAD), 0) + else: + self.feed_data((message, payload), 0) + if payload is not None: + # new message(s) was processed + # register timeout handler unsubscribing + # either on end-of-stream or immediately for + # EMPTY_PAYLOAD + if payload is not EMPTY_PAYLOAD: + payload.on_eof(self._drop_timeout) + else: + self._drop_timeout() + + if tail: + if upgraded: + self.data_received(tail) + else: + self._tail = tail diff --git a/env/Lib/site-packages/aiohttp/client_reqrep.py b/env/Lib/site-packages/aiohttp/client_reqrep.py new file mode 100644 index 0000000..bea76d8 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/client_reqrep.py @@ -0,0 +1,1231 @@ +import asyncio +import codecs +import contextlib +import functools +import io +import re +import sys +import traceback +import warnings +from hashlib import md5, sha1, sha256 +from http.cookies import CookieError, Morsel, SimpleCookie +from types import MappingProxyType, TracebackType +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Dict, + Iterable, + List, + Mapping, + Optional, + Tuple, + Type, + Union, + cast, +) + +import attr +from multidict import CIMultiDict, CIMultiDictProxy, MultiDict, MultiDictProxy +from yarl import URL + +from . import hdrs, helpers, http, multipart, payload +from .abc import AbstractStreamWriter +from .client_exceptions import ( + ClientConnectionError, + ClientOSError, + ClientResponseError, + ContentTypeError, + InvalidURL, + ServerFingerprintMismatch, +) +from .compression_utils import HAS_BROTLI +from .formdata import FormData +from .helpers import ( + BaseTimerContext, + BasicAuth, + HeadersMixin, + TimerNoop, + basicauth_from_netrc, + netrc_from_env, + noop, + reify, + set_exception, + set_result, +) +from .http import ( + SERVER_SOFTWARE, + HttpVersion, + HttpVersion10, + HttpVersion11, + StreamWriter, +) +from .log import client_logger +from .streams import StreamReader +from .typedefs import ( + DEFAULT_JSON_DECODER, + JSONDecoder, + LooseCookies, + LooseHeaders, + RawHeaders, +) + +try: + import ssl + from ssl import SSLContext +except ImportError: # pragma: no cover + ssl = None # type: ignore[assignment] + SSLContext = object # type: ignore[misc,assignment] + + +__all__ = ("ClientRequest", "ClientResponse", "RequestInfo", "Fingerprint") + + +if TYPE_CHECKING: + from .client import ClientSession + from .connector import Connection + from .tracing import Trace + + +_CONTAINS_CONTROL_CHAR_RE = re.compile(r"[^-!#$%&'*+.^_`|~0-9a-zA-Z]") +json_re = re.compile(r"^application/(?:[\w.+-]+?\+)?json") + + +def _gen_default_accept_encoding() -> str: + return "gzip, deflate, br" if HAS_BROTLI else "gzip, deflate" + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class ContentDisposition: + type: Optional[str] + parameters: "MappingProxyType[str, str]" + filename: Optional[str] + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class RequestInfo: + url: URL + method: str + headers: "CIMultiDictProxy[str]" + real_url: URL = attr.ib() + + @real_url.default + def real_url_default(self) -> URL: + return self.url + + +class Fingerprint: + HASHFUNC_BY_DIGESTLEN = { + 16: md5, + 20: sha1, + 32: sha256, + } + + def __init__(self, fingerprint: bytes) -> None: + digestlen = len(fingerprint) + hashfunc = self.HASHFUNC_BY_DIGESTLEN.get(digestlen) + if not hashfunc: + raise ValueError("fingerprint has invalid length") + elif hashfunc is md5 or hashfunc is sha1: + raise ValueError( + "md5 and sha1 are insecure and " "not supported. Use sha256." + ) + self._hashfunc = hashfunc + self._fingerprint = fingerprint + + @property + def fingerprint(self) -> bytes: + return self._fingerprint + + def check(self, transport: asyncio.Transport) -> None: + if not transport.get_extra_info("sslcontext"): + return + sslobj = transport.get_extra_info("ssl_object") + cert = sslobj.getpeercert(binary_form=True) + got = self._hashfunc(cert).digest() + if got != self._fingerprint: + host, port, *_ = transport.get_extra_info("peername") + raise ServerFingerprintMismatch(self._fingerprint, got, host, port) + + +if ssl is not None: + SSL_ALLOWED_TYPES = (ssl.SSLContext, bool, Fingerprint, type(None)) +else: # pragma: no cover + SSL_ALLOWED_TYPES = (bool, type(None)) + + +def _merge_ssl_params( + ssl: Union["SSLContext", bool, Fingerprint], + verify_ssl: Optional[bool], + ssl_context: Optional["SSLContext"], + fingerprint: Optional[bytes], +) -> Union["SSLContext", bool, Fingerprint]: + if ssl is None: + ssl = True # Double check for backwards compatibility + if verify_ssl is not None and not verify_ssl: + warnings.warn( + "verify_ssl is deprecated, use ssl=False instead", + DeprecationWarning, + stacklevel=3, + ) + if ssl is not True: + raise ValueError( + "verify_ssl, ssl_context, fingerprint and ssl " + "parameters are mutually exclusive" + ) + else: + ssl = False + if ssl_context is not None: + warnings.warn( + "ssl_context is deprecated, use ssl=context instead", + DeprecationWarning, + stacklevel=3, + ) + if ssl is not True: + raise ValueError( + "verify_ssl, ssl_context, fingerprint and ssl " + "parameters are mutually exclusive" + ) + else: + ssl = ssl_context + if fingerprint is not None: + warnings.warn( + "fingerprint is deprecated, " "use ssl=Fingerprint(fingerprint) instead", + DeprecationWarning, + stacklevel=3, + ) + if ssl is not True: + raise ValueError( + "verify_ssl, ssl_context, fingerprint and ssl " + "parameters are mutually exclusive" + ) + else: + ssl = Fingerprint(fingerprint) + if not isinstance(ssl, SSL_ALLOWED_TYPES): + raise TypeError( + "ssl should be SSLContext, bool, Fingerprint or None, " + "got {!r} instead.".format(ssl) + ) + return ssl + + +@attr.s(auto_attribs=True, slots=True, frozen=True) +class ConnectionKey: + # the key should contain an information about used proxy / TLS + # to prevent reusing wrong connections from a pool + host: str + port: Optional[int] + is_ssl: bool + ssl: Union[SSLContext, bool, Fingerprint] + proxy: Optional[URL] + proxy_auth: Optional[BasicAuth] + proxy_headers_hash: Optional[int] # hash(CIMultiDict) + + +def _is_expected_content_type( + response_content_type: str, expected_content_type: str +) -> bool: + if expected_content_type == "application/json": + return json_re.match(response_content_type) is not None + return expected_content_type in response_content_type + + +class ClientRequest: + GET_METHODS = { + hdrs.METH_GET, + hdrs.METH_HEAD, + hdrs.METH_OPTIONS, + hdrs.METH_TRACE, + } + POST_METHODS = {hdrs.METH_PATCH, hdrs.METH_POST, hdrs.METH_PUT} + ALL_METHODS = GET_METHODS.union(POST_METHODS).union({hdrs.METH_DELETE}) + + DEFAULT_HEADERS = { + hdrs.ACCEPT: "*/*", + hdrs.ACCEPT_ENCODING: _gen_default_accept_encoding(), + } + + # Type of body depends on PAYLOAD_REGISTRY, which is dynamic. + body: Any = b"" + auth = None + response = None + + __writer = None # async task for streaming data + _continue = None # waiter future for '100 Continue' response + + # N.B. + # Adding __del__ method with self._writer closing doesn't make sense + # because _writer is instance method, thus it keeps a reference to self. + # Until writer has finished finalizer will not be called. + + def __init__( + self, + method: str, + url: URL, + *, + params: Optional[Mapping[str, str]] = None, + headers: Optional[LooseHeaders] = None, + skip_auto_headers: Iterable[str] = frozenset(), + data: Any = None, + cookies: Optional[LooseCookies] = None, + auth: Optional[BasicAuth] = None, + version: http.HttpVersion = http.HttpVersion11, + compress: Optional[str] = None, + chunked: Optional[bool] = None, + expect100: bool = False, + loop: Optional[asyncio.AbstractEventLoop] = None, + response_class: Optional[Type["ClientResponse"]] = None, + proxy: Optional[URL] = None, + proxy_auth: Optional[BasicAuth] = None, + timer: Optional[BaseTimerContext] = None, + session: Optional["ClientSession"] = None, + ssl: Union[SSLContext, bool, Fingerprint] = True, + proxy_headers: Optional[LooseHeaders] = None, + traces: Optional[List["Trace"]] = None, + trust_env: bool = False, + server_hostname: Optional[str] = None, + ): + if loop is None: + loop = asyncio.get_event_loop() + + match = _CONTAINS_CONTROL_CHAR_RE.search(method) + if match: + raise ValueError( + f"Method cannot contain non-token characters {method!r} " + "(found at least {match.group()!r})" + ) + + assert isinstance(url, URL), url + assert isinstance(proxy, (URL, type(None))), proxy + # FIXME: session is None in tests only, need to fix tests + # assert session is not None + self._session = cast("ClientSession", session) + if params: + q = MultiDict(url.query) + url2 = url.with_query(params) + q.extend(url2.query) + url = url.with_query(q) + self.original_url = url + self.url = url.with_fragment(None) + self.method = method.upper() + self.chunked = chunked + self.compress = compress + self.loop = loop + self.length = None + if response_class is None: + real_response_class = ClientResponse + else: + real_response_class = response_class + self.response_class: Type[ClientResponse] = real_response_class + self._timer = timer if timer is not None else TimerNoop() + self._ssl = ssl if ssl is not None else True + self.server_hostname = server_hostname + + if loop.get_debug(): + self._source_traceback = traceback.extract_stack(sys._getframe(1)) + + self.update_version(version) + self.update_host(url) + self.update_headers(headers) + self.update_auto_headers(skip_auto_headers) + self.update_cookies(cookies) + self.update_content_encoding(data) + self.update_auth(auth, trust_env) + self.update_proxy(proxy, proxy_auth, proxy_headers) + + self.update_body_from_data(data) + if data is not None or self.method not in self.GET_METHODS: + self.update_transfer_encoding() + self.update_expect_continue(expect100) + if traces is None: + traces = [] + self._traces = traces + + def __reset_writer(self, _: object = None) -> None: + self.__writer = None + + @property + def _writer(self) -> Optional["asyncio.Task[None]"]: + return self.__writer + + @_writer.setter + def _writer(self, writer: Optional["asyncio.Task[None]"]) -> None: + if self.__writer is not None: + self.__writer.remove_done_callback(self.__reset_writer) + self.__writer = writer + if writer is None: + return + if writer.done(): + # The writer is already done, so we can reset it immediately. + self.__reset_writer() + else: + writer.add_done_callback(self.__reset_writer) + + def is_ssl(self) -> bool: + return self.url.scheme in ("https", "wss") + + @property + def ssl(self) -> Union["SSLContext", bool, Fingerprint]: + return self._ssl + + @property + def connection_key(self) -> ConnectionKey: + proxy_headers = self.proxy_headers + if proxy_headers: + h: Optional[int] = hash(tuple((k, v) for k, v in proxy_headers.items())) + else: + h = None + return ConnectionKey( + self.host, + self.port, + self.is_ssl(), + self.ssl, + self.proxy, + self.proxy_auth, + h, + ) + + @property + def host(self) -> str: + ret = self.url.raw_host + assert ret is not None + return ret + + @property + def port(self) -> Optional[int]: + return self.url.port + + @property + def request_info(self) -> RequestInfo: + headers: CIMultiDictProxy[str] = CIMultiDictProxy(self.headers) + return RequestInfo(self.url, self.method, headers, self.original_url) + + def update_host(self, url: URL) -> None: + """Update destination host, port and connection type (ssl).""" + # get host/port + if not url.raw_host: + raise InvalidURL(url) + + # basic auth info + username, password = url.user, url.password + if username: + self.auth = helpers.BasicAuth(username, password or "") + + def update_version(self, version: Union[http.HttpVersion, str]) -> None: + """Convert request version to two elements tuple. + + parser HTTP version '1.1' => (1, 1) + """ + if isinstance(version, str): + v = [part.strip() for part in version.split(".", 1)] + try: + version = http.HttpVersion(int(v[0]), int(v[1])) + except ValueError: + raise ValueError( + f"Can not parse http version number: {version}" + ) from None + self.version = version + + def update_headers(self, headers: Optional[LooseHeaders]) -> None: + """Update request headers.""" + self.headers: CIMultiDict[str] = CIMultiDict() + + # add host + netloc = cast(str, self.url.raw_host) + if helpers.is_ipv6_address(netloc): + netloc = f"[{netloc}]" + # See https://github.com/aio-libs/aiohttp/issues/3636. + netloc = netloc.rstrip(".") + if self.url.port is not None and not self.url.is_default_port(): + netloc += ":" + str(self.url.port) + self.headers[hdrs.HOST] = netloc + + if headers: + if isinstance(headers, (dict, MultiDictProxy, MultiDict)): + headers = headers.items() + + for key, value in headers: # type: ignore[misc] + # A special case for Host header + if key.lower() == "host": + self.headers[key] = value + else: + self.headers.add(key, value) + + def update_auto_headers(self, skip_auto_headers: Iterable[str]) -> None: + self.skip_auto_headers = CIMultiDict( + (hdr, None) for hdr in sorted(skip_auto_headers) + ) + used_headers = self.headers.copy() + used_headers.extend(self.skip_auto_headers) # type: ignore[arg-type] + + for hdr, val in self.DEFAULT_HEADERS.items(): + if hdr not in used_headers: + self.headers.add(hdr, val) + + if hdrs.USER_AGENT not in used_headers: + self.headers[hdrs.USER_AGENT] = SERVER_SOFTWARE + + def update_cookies(self, cookies: Optional[LooseCookies]) -> None: + """Update request cookies header.""" + if not cookies: + return + + c = SimpleCookie() + if hdrs.COOKIE in self.headers: + c.load(self.headers.get(hdrs.COOKIE, "")) + del self.headers[hdrs.COOKIE] + + if isinstance(cookies, Mapping): + iter_cookies = cookies.items() + else: + iter_cookies = cookies # type: ignore[assignment] + for name, value in iter_cookies: + if isinstance(value, Morsel): + # Preserve coded_value + mrsl_val = value.get(value.key, Morsel()) + mrsl_val.set(value.key, value.value, value.coded_value) + c[name] = mrsl_val + else: + c[name] = value # type: ignore[assignment] + + self.headers[hdrs.COOKIE] = c.output(header="", sep=";").strip() + + def update_content_encoding(self, data: Any) -> None: + """Set request content encoding.""" + if data is None: + return + + enc = self.headers.get(hdrs.CONTENT_ENCODING, "").lower() + if enc: + if self.compress: + raise ValueError( + "compress can not be set " "if Content-Encoding header is set" + ) + elif self.compress: + if not isinstance(self.compress, str): + self.compress = "deflate" + self.headers[hdrs.CONTENT_ENCODING] = self.compress + self.chunked = True # enable chunked, no need to deal with length + + def update_transfer_encoding(self) -> None: + """Analyze transfer-encoding header.""" + te = self.headers.get(hdrs.TRANSFER_ENCODING, "").lower() + + if "chunked" in te: + if self.chunked: + raise ValueError( + "chunked can not be set " + 'if "Transfer-Encoding: chunked" header is set' + ) + + elif self.chunked: + if hdrs.CONTENT_LENGTH in self.headers: + raise ValueError( + "chunked can not be set " "if Content-Length header is set" + ) + + self.headers[hdrs.TRANSFER_ENCODING] = "chunked" + else: + if hdrs.CONTENT_LENGTH not in self.headers: + self.headers[hdrs.CONTENT_LENGTH] = str(len(self.body)) + + def update_auth(self, auth: Optional[BasicAuth], trust_env: bool = False) -> None: + """Set basic auth.""" + if auth is None: + auth = self.auth + if auth is None and trust_env and self.url.host is not None: + netrc_obj = netrc_from_env() + with contextlib.suppress(LookupError): + auth = basicauth_from_netrc(netrc_obj, self.url.host) + if auth is None: + return + + if not isinstance(auth, helpers.BasicAuth): + raise TypeError("BasicAuth() tuple is required instead") + + self.headers[hdrs.AUTHORIZATION] = auth.encode() + + def update_body_from_data(self, body: Any) -> None: + if body is None: + return + + # FormData + if isinstance(body, FormData): + body = body() + + try: + body = payload.PAYLOAD_REGISTRY.get(body, disposition=None) + except payload.LookupError: + body = FormData(body)() + + self.body = body + + # enable chunked encoding if needed + if not self.chunked: + if hdrs.CONTENT_LENGTH not in self.headers: + size = body.size + if size is None: + self.chunked = True + else: + if hdrs.CONTENT_LENGTH not in self.headers: + self.headers[hdrs.CONTENT_LENGTH] = str(size) + + # copy payload headers + assert body.headers + for key, value in body.headers.items(): + if key in self.headers: + continue + if key in self.skip_auto_headers: + continue + self.headers[key] = value + + def update_expect_continue(self, expect: bool = False) -> None: + if expect: + self.headers[hdrs.EXPECT] = "100-continue" + elif self.headers.get(hdrs.EXPECT, "").lower() == "100-continue": + expect = True + + if expect: + self._continue = self.loop.create_future() + + def update_proxy( + self, + proxy: Optional[URL], + proxy_auth: Optional[BasicAuth], + proxy_headers: Optional[LooseHeaders], + ) -> None: + if proxy_auth and not isinstance(proxy_auth, helpers.BasicAuth): + raise ValueError("proxy_auth must be None or BasicAuth() tuple") + self.proxy = proxy + self.proxy_auth = proxy_auth + if proxy_headers is not None and not isinstance( + proxy_headers, (MultiDict, MultiDictProxy) + ): + proxy_headers = CIMultiDict(proxy_headers) + self.proxy_headers = proxy_headers + + def keep_alive(self) -> bool: + if self.version < HttpVersion10: + # keep alive not supported at all + return False + if self.version == HttpVersion10: + if self.headers.get(hdrs.CONNECTION) == "keep-alive": + return True + else: # no headers means we close for Http 1.0 + return False + elif self.headers.get(hdrs.CONNECTION) == "close": + return False + + return True + + async def write_bytes( + self, writer: AbstractStreamWriter, conn: "Connection" + ) -> None: + """Support coroutines that yields bytes objects.""" + # 100 response + if self._continue is not None: + try: + await writer.drain() + await self._continue + except asyncio.CancelledError: + return + + protocol = conn.protocol + assert protocol is not None + try: + if isinstance(self.body, payload.Payload): + await self.body.write(writer) + else: + if isinstance(self.body, (bytes, bytearray)): + self.body = (self.body,) + + for chunk in self.body: + await writer.write(chunk) + except OSError as underlying_exc: + reraised_exc = underlying_exc + + exc_is_not_timeout = underlying_exc.errno is not None or not isinstance( + underlying_exc, asyncio.TimeoutError + ) + if exc_is_not_timeout: + reraised_exc = ClientOSError( + underlying_exc.errno, + f"Can not write request body for {self.url !s}", + ) + + set_exception(protocol, reraised_exc, underlying_exc) + except asyncio.CancelledError: + await writer.write_eof() + except Exception as underlying_exc: + set_exception( + protocol, + ClientConnectionError( + f"Failed to send bytes into the underlying connection {conn !s}", + ), + underlying_exc, + ) + else: + await writer.write_eof() + protocol.start_timeout() + + async def send(self, conn: "Connection") -> "ClientResponse": + # Specify request target: + # - CONNECT request must send authority form URI + # - not CONNECT proxy must send absolute form URI + # - most common is origin form URI + if self.method == hdrs.METH_CONNECT: + connect_host = self.url.raw_host + assert connect_host is not None + if helpers.is_ipv6_address(connect_host): + connect_host = f"[{connect_host}]" + path = f"{connect_host}:{self.url.port}" + elif self.proxy and not self.is_ssl(): + path = str(self.url) + else: + path = self.url.raw_path + if self.url.raw_query_string: + path += "?" + self.url.raw_query_string + + protocol = conn.protocol + assert protocol is not None + writer = StreamWriter( + protocol, + self.loop, + on_chunk_sent=functools.partial( + self._on_chunk_request_sent, self.method, self.url + ), + on_headers_sent=functools.partial( + self._on_headers_request_sent, self.method, self.url + ), + ) + + if self.compress: + writer.enable_compression(self.compress) + + if self.chunked is not None: + writer.enable_chunking() + + # set default content-type + if ( + self.method in self.POST_METHODS + and hdrs.CONTENT_TYPE not in self.skip_auto_headers + and hdrs.CONTENT_TYPE not in self.headers + ): + self.headers[hdrs.CONTENT_TYPE] = "application/octet-stream" + + # set the connection header + connection = self.headers.get(hdrs.CONNECTION) + if not connection: + if self.keep_alive(): + if self.version == HttpVersion10: + connection = "keep-alive" + else: + if self.version == HttpVersion11: + connection = "close" + + if connection is not None: + self.headers[hdrs.CONNECTION] = connection + + # status + headers + status_line = "{0} {1} HTTP/{v.major}.{v.minor}".format( + self.method, path, v=self.version + ) + await writer.write_headers(status_line, self.headers) + coro = self.write_bytes(writer, conn) + + if sys.version_info >= (3, 12): + # Optimization for Python 3.12, try to write + # bytes immediately to avoid having to schedule + # the task on the event loop. + task = asyncio.Task(coro, loop=self.loop, eager_start=True) + else: + task = self.loop.create_task(coro) + + self._writer = task + response_class = self.response_class + assert response_class is not None + self.response = response_class( + self.method, + self.original_url, + writer=self._writer, + continue100=self._continue, + timer=self._timer, + request_info=self.request_info, + traces=self._traces, + loop=self.loop, + session=self._session, + ) + return self.response + + async def close(self) -> None: + if self._writer is not None: + with contextlib.suppress(asyncio.CancelledError): + await self._writer + + def terminate(self) -> None: + if self._writer is not None: + if not self.loop.is_closed(): + self._writer.cancel() + self._writer.remove_done_callback(self.__reset_writer) + self._writer = None + + async def _on_chunk_request_sent(self, method: str, url: URL, chunk: bytes) -> None: + for trace in self._traces: + await trace.send_request_chunk_sent(method, url, chunk) + + async def _on_headers_request_sent( + self, method: str, url: URL, headers: "CIMultiDict[str]" + ) -> None: + for trace in self._traces: + await trace.send_request_headers(method, url, headers) + + +class ClientResponse(HeadersMixin): + + # Some of these attributes are None when created, + # but will be set by the start() method. + # As the end user will likely never see the None values, we cheat the types below. + # from the Status-Line of the response + version: Optional[HttpVersion] = None # HTTP-Version + status: int = None # type: ignore[assignment] # Status-Code + reason: Optional[str] = None # Reason-Phrase + + content: StreamReader = None # type: ignore[assignment] # Payload stream + _headers: CIMultiDictProxy[str] = None # type: ignore[assignment] + _raw_headers: RawHeaders = None # type: ignore[assignment] + + _connection = None # current connection + _source_traceback: Optional[traceback.StackSummary] = None + # set up by ClientRequest after ClientResponse object creation + # post-init stage allows to not change ctor signature + _closed = True # to allow __del__ for non-initialized properly response + _released = False + __writer = None + + def __init__( + self, + method: str, + url: URL, + *, + writer: "asyncio.Task[None]", + continue100: Optional["asyncio.Future[bool]"], + timer: BaseTimerContext, + request_info: RequestInfo, + traces: List["Trace"], + loop: asyncio.AbstractEventLoop, + session: "ClientSession", + ) -> None: + assert isinstance(url, URL) + + self.method = method + self.cookies = SimpleCookie() + + self._real_url = url + self._url = url.with_fragment(None) + self._body: Any = None + self._writer: Optional[asyncio.Task[None]] = writer + self._continue = continue100 # None by default + self._closed = True + self._history: Tuple[ClientResponse, ...] = () + self._request_info = request_info + self._timer = timer if timer is not None else TimerNoop() + self._cache: Dict[str, Any] = {} + self._traces = traces + self._loop = loop + # store a reference to session #1985 + self._session: Optional[ClientSession] = session + # Save reference to _resolve_charset, so that get_encoding() will still + # work after the response has finished reading the body. + if session is None: + # TODO: Fix session=None in tests (see ClientRequest.__init__). + self._resolve_charset: Callable[["ClientResponse", bytes], str] = ( + lambda *_: "utf-8" + ) + else: + self._resolve_charset = session._resolve_charset + if loop.get_debug(): + self._source_traceback = traceback.extract_stack(sys._getframe(1)) + + def __reset_writer(self, _: object = None) -> None: + self.__writer = None + + @property + def _writer(self) -> Optional["asyncio.Task[None]"]: + return self.__writer + + @_writer.setter + def _writer(self, writer: Optional["asyncio.Task[None]"]) -> None: + if self.__writer is not None: + self.__writer.remove_done_callback(self.__reset_writer) + self.__writer = writer + if writer is None: + return + if writer.done(): + # The writer is already done, so we can reset it immediately. + self.__reset_writer() + else: + writer.add_done_callback(self.__reset_writer) + + @reify + def url(self) -> URL: + return self._url + + @reify + def url_obj(self) -> URL: + warnings.warn("Deprecated, use .url #1654", DeprecationWarning, stacklevel=2) + return self._url + + @reify + def real_url(self) -> URL: + return self._real_url + + @reify + def host(self) -> str: + assert self._url.host is not None + return self._url.host + + @reify + def headers(self) -> "CIMultiDictProxy[str]": + return self._headers + + @reify + def raw_headers(self) -> RawHeaders: + return self._raw_headers + + @reify + def request_info(self) -> RequestInfo: + return self._request_info + + @reify + def content_disposition(self) -> Optional[ContentDisposition]: + raw = self._headers.get(hdrs.CONTENT_DISPOSITION) + if raw is None: + return None + disposition_type, params_dct = multipart.parse_content_disposition(raw) + params = MappingProxyType(params_dct) + filename = multipart.content_disposition_filename(params) + return ContentDisposition(disposition_type, params, filename) + + def __del__(self, _warnings: Any = warnings) -> None: + if self._closed: + return + + if self._connection is not None: + self._connection.release() + self._cleanup_writer() + + if self._loop.get_debug(): + kwargs = {"source": self} + _warnings.warn(f"Unclosed response {self!r}", ResourceWarning, **kwargs) + context = {"client_response": self, "message": "Unclosed response"} + if self._source_traceback: + context["source_traceback"] = self._source_traceback + self._loop.call_exception_handler(context) + + def __repr__(self) -> str: + out = io.StringIO() + ascii_encodable_url = str(self.url) + if self.reason: + ascii_encodable_reason = self.reason.encode( + "ascii", "backslashreplace" + ).decode("ascii") + else: + ascii_encodable_reason = "None" + print( + "".format( + ascii_encodable_url, self.status, ascii_encodable_reason + ), + file=out, + ) + print(self.headers, file=out) + return out.getvalue() + + @property + def connection(self) -> Optional["Connection"]: + return self._connection + + @reify + def history(self) -> Tuple["ClientResponse", ...]: + """A sequence of of responses, if redirects occurred.""" + return self._history + + @reify + def links(self) -> "MultiDictProxy[MultiDictProxy[Union[str, URL]]]": + links_str = ", ".join(self.headers.getall("link", [])) + + if not links_str: + return MultiDictProxy(MultiDict()) + + links: MultiDict[MultiDictProxy[Union[str, URL]]] = MultiDict() + + for val in re.split(r",(?=\s*<)", links_str): + match = re.match(r"\s*<(.*)>(.*)", val) + if match is None: # pragma: no cover + # the check exists to suppress mypy error + continue + url, params_str = match.groups() + params = params_str.split(";")[1:] + + link: MultiDict[Union[str, URL]] = MultiDict() + + for param in params: + match = re.match(r"^\s*(\S*)\s*=\s*(['\"]?)(.*?)(\2)\s*$", param, re.M) + if match is None: # pragma: no cover + # the check exists to suppress mypy error + continue + key, _, value, _ = match.groups() + + link.add(key, value) + + key = link.get("rel", url) + + link.add("url", self.url.join(URL(url))) + + links.add(str(key), MultiDictProxy(link)) + + return MultiDictProxy(links) + + async def start(self, connection: "Connection") -> "ClientResponse": + """Start response processing.""" + self._closed = False + self._protocol = connection.protocol + self._connection = connection + + with self._timer: + while True: + # read response + try: + protocol = self._protocol + message, payload = await protocol.read() # type: ignore[union-attr] + except http.HttpProcessingError as exc: + raise ClientResponseError( + self.request_info, + self.history, + status=exc.code, + message=exc.message, + headers=exc.headers, + ) from exc + + if message.code < 100 or message.code > 199 or message.code == 101: + break + + if self._continue is not None: + set_result(self._continue, True) + self._continue = None + + # payload eof handler + payload.on_eof(self._response_eof) + + # response status + self.version = message.version + self.status = message.code + self.reason = message.reason + + # headers + self._headers = message.headers # type is CIMultiDictProxy + self._raw_headers = message.raw_headers # type is Tuple[bytes, bytes] + + # payload + self.content = payload + + # cookies + for hdr in self.headers.getall(hdrs.SET_COOKIE, ()): + try: + self.cookies.load(hdr) + except CookieError as exc: + client_logger.warning("Can not load response cookies: %s", exc) + return self + + def _response_eof(self) -> None: + if self._closed: + return + + # protocol could be None because connection could be detached + protocol = self._connection and self._connection.protocol + if protocol is not None and protocol.upgraded: + return + + self._closed = True + self._cleanup_writer() + self._release_connection() + + @property + def closed(self) -> bool: + return self._closed + + def close(self) -> None: + if not self._released: + self._notify_content() + + self._closed = True + if self._loop is None or self._loop.is_closed(): + return + + self._cleanup_writer() + if self._connection is not None: + self._connection.close() + self._connection = None + + def release(self) -> Any: + if not self._released: + self._notify_content() + + self._closed = True + + self._cleanup_writer() + self._release_connection() + return noop() + + @property + def ok(self) -> bool: + """Returns ``True`` if ``status`` is less than ``400``, ``False`` if not. + + This is **not** a check for ``200 OK`` but a check that the response + status is under 400. + """ + return 400 > self.status + + def raise_for_status(self) -> None: + if not self.ok: + # reason should always be not None for a started response + assert self.reason is not None + self.release() + raise ClientResponseError( + self.request_info, + self.history, + status=self.status, + message=self.reason, + headers=self.headers, + ) + + def _release_connection(self) -> None: + if self._connection is not None: + if self._writer is None: + self._connection.release() + self._connection = None + else: + self._writer.add_done_callback(lambda f: self._release_connection()) + + async def _wait_released(self) -> None: + if self._writer is not None: + await self._writer + self._release_connection() + + def _cleanup_writer(self) -> None: + if self._writer is not None: + self._writer.cancel() + self._session = None + + def _notify_content(self) -> None: + content = self.content + if content and content.exception() is None: + set_exception(content, ClientConnectionError("Connection closed")) + self._released = True + + async def wait_for_close(self) -> None: + if self._writer is not None: + await self._writer + self.release() + + async def read(self) -> bytes: + """Read response payload.""" + if self._body is None: + try: + self._body = await self.content.read() + for trace in self._traces: + await trace.send_response_chunk_received( + self.method, self.url, self._body + ) + except BaseException: + self.close() + raise + elif self._released: # Response explicitly released + raise ClientConnectionError("Connection closed") + + protocol = self._connection and self._connection.protocol + if protocol is None or not protocol.upgraded: + await self._wait_released() # Underlying connection released + return self._body # type: ignore[no-any-return] + + def get_encoding(self) -> str: + ctype = self.headers.get(hdrs.CONTENT_TYPE, "").lower() + mimetype = helpers.parse_mimetype(ctype) + + encoding = mimetype.parameters.get("charset") + if encoding: + with contextlib.suppress(LookupError): + return codecs.lookup(encoding).name + + if mimetype.type == "application" and ( + mimetype.subtype == "json" or mimetype.subtype == "rdap" + ): + # RFC 7159 states that the default encoding is UTF-8. + # RFC 7483 defines application/rdap+json + return "utf-8" + + if self._body is None: + raise RuntimeError( + "Cannot compute fallback encoding of a not yet read body" + ) + + return self._resolve_charset(self, self._body) + + async def text(self, encoding: Optional[str] = None, errors: str = "strict") -> str: + """Read response payload and decode.""" + if self._body is None: + await self.read() + + if encoding is None: + encoding = self.get_encoding() + + return self._body.decode( # type: ignore[no-any-return,union-attr] + encoding, errors=errors + ) + + async def json( + self, + *, + encoding: Optional[str] = None, + loads: JSONDecoder = DEFAULT_JSON_DECODER, + content_type: Optional[str] = "application/json", + ) -> Any: + """Read and decodes JSON response.""" + if self._body is None: + await self.read() + + if content_type: + ctype = self.headers.get(hdrs.CONTENT_TYPE, "").lower() + if not _is_expected_content_type(ctype, content_type): + raise ContentTypeError( + self.request_info, + self.history, + status=self.status, + message=( + "Attempt to decode JSON with " "unexpected mimetype: %s" % ctype + ), + headers=self.headers, + ) + + stripped = self._body.strip() # type: ignore[union-attr] + if not stripped: + return None + + if encoding is None: + encoding = self.get_encoding() + + return loads(stripped.decode(encoding)) + + async def __aenter__(self) -> "ClientResponse": + return self + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + # similar to _RequestContextManager, we do not need to check + # for exceptions, response object can close connection + # if state is broken + self.release() + await self.wait_for_close() diff --git a/env/Lib/site-packages/aiohttp/client_ws.py b/env/Lib/site-packages/aiohttp/client_ws.py new file mode 100644 index 0000000..7b3a5bf --- /dev/null +++ b/env/Lib/site-packages/aiohttp/client_ws.py @@ -0,0 +1,386 @@ +"""WebSocket client for asyncio.""" + +import asyncio +import sys +from typing import Any, Optional, cast + +from .client_exceptions import ClientError, ServerTimeoutError +from .client_reqrep import ClientResponse +from .helpers import calculate_timeout_when, set_result +from .http import ( + WS_CLOSED_MESSAGE, + WS_CLOSING_MESSAGE, + WebSocketError, + WSCloseCode, + WSMessage, + WSMsgType, +) +from .http_websocket import WebSocketWriter # WSMessage +from .streams import EofStream, FlowControlDataQueue +from .typedefs import ( + DEFAULT_JSON_DECODER, + DEFAULT_JSON_ENCODER, + JSONDecoder, + JSONEncoder, +) + +if sys.version_info >= (3, 11): + import asyncio as async_timeout +else: + import async_timeout + + +class ClientWebSocketResponse: + def __init__( + self, + reader: "FlowControlDataQueue[WSMessage]", + writer: WebSocketWriter, + protocol: Optional[str], + response: ClientResponse, + timeout: float, + autoclose: bool, + autoping: bool, + loop: asyncio.AbstractEventLoop, + *, + receive_timeout: Optional[float] = None, + heartbeat: Optional[float] = None, + compress: int = 0, + client_notakeover: bool = False, + ) -> None: + self._response = response + self._conn = response.connection + + self._writer = writer + self._reader = reader + self._protocol = protocol + self._closed = False + self._closing = False + self._close_code: Optional[int] = None + self._timeout = timeout + self._receive_timeout = receive_timeout + self._autoclose = autoclose + self._autoping = autoping + self._heartbeat = heartbeat + self._heartbeat_cb: Optional[asyncio.TimerHandle] = None + self._heartbeat_when: float = 0.0 + if heartbeat is not None: + self._pong_heartbeat = heartbeat / 2.0 + self._pong_response_cb: Optional[asyncio.TimerHandle] = None + self._loop = loop + self._waiting: bool = False + self._close_wait: Optional[asyncio.Future[None]] = None + self._exception: Optional[BaseException] = None + self._compress = compress + self._client_notakeover = client_notakeover + self._ping_task: Optional[asyncio.Task[None]] = None + + self._reset_heartbeat() + + def _cancel_heartbeat(self) -> None: + self._cancel_pong_response_cb() + if self._heartbeat_cb is not None: + self._heartbeat_cb.cancel() + self._heartbeat_cb = None + if self._ping_task is not None: + self._ping_task.cancel() + self._ping_task = None + + def _cancel_pong_response_cb(self) -> None: + if self._pong_response_cb is not None: + self._pong_response_cb.cancel() + self._pong_response_cb = None + + def _reset_heartbeat(self) -> None: + if self._heartbeat is None: + return + self._cancel_pong_response_cb() + loop = self._loop + assert loop is not None + conn = self._conn + timeout_ceil_threshold = ( + conn._connector._timeout_ceil_threshold if conn is not None else 5 + ) + now = loop.time() + when = calculate_timeout_when(now, self._heartbeat, timeout_ceil_threshold) + self._heartbeat_when = when + if self._heartbeat_cb is None: + # We do not cancel the previous heartbeat_cb here because + # it generates a significant amount of TimerHandle churn + # which causes asyncio to rebuild the heap frequently. + # Instead _send_heartbeat() will reschedule the next + # heartbeat if it fires too early. + self._heartbeat_cb = loop.call_at(when, self._send_heartbeat) + + def _send_heartbeat(self) -> None: + self._heartbeat_cb = None + loop = self._loop + now = loop.time() + if now < self._heartbeat_when: + # Heartbeat fired too early, reschedule + self._heartbeat_cb = loop.call_at( + self._heartbeat_when, self._send_heartbeat + ) + return + + conn = self._conn + timeout_ceil_threshold = ( + conn._connector._timeout_ceil_threshold if conn is not None else 5 + ) + when = calculate_timeout_when(now, self._pong_heartbeat, timeout_ceil_threshold) + self._cancel_pong_response_cb() + self._pong_response_cb = loop.call_at(when, self._pong_not_received) + + if sys.version_info >= (3, 12): + # Optimization for Python 3.12, try to send the ping + # immediately to avoid having to schedule + # the task on the event loop. + ping_task = asyncio.Task(self._writer.ping(), loop=loop, eager_start=True) + else: + ping_task = loop.create_task(self._writer.ping()) + + if not ping_task.done(): + self._ping_task = ping_task + ping_task.add_done_callback(self._ping_task_done) + else: + self._ping_task_done(ping_task) + + def _ping_task_done(self, task: "asyncio.Task[None]") -> None: + """Callback for when the ping task completes.""" + if not task.cancelled() and (exc := task.exception()): + self._handle_ping_pong_exception(exc) + self._ping_task = None + + def _pong_not_received(self) -> None: + self._handle_ping_pong_exception(ServerTimeoutError()) + + def _handle_ping_pong_exception(self, exc: BaseException) -> None: + """Handle exceptions raised during ping/pong processing.""" + if self._closed: + return + self._set_closed() + self._close_code = WSCloseCode.ABNORMAL_CLOSURE + self._exception = exc + self._response.close() + if self._waiting and not self._closing: + self._reader.feed_data(WSMessage(WSMsgType.ERROR, exc, None)) + + def _set_closed(self) -> None: + """Set the connection to closed. + + Cancel any heartbeat timers and set the closed flag. + """ + self._closed = True + self._cancel_heartbeat() + + def _set_closing(self) -> None: + """Set the connection to closing. + + Cancel any heartbeat timers and set the closing flag. + """ + self._closing = True + self._cancel_heartbeat() + + @property + def closed(self) -> bool: + return self._closed + + @property + def close_code(self) -> Optional[int]: + return self._close_code + + @property + def protocol(self) -> Optional[str]: + return self._protocol + + @property + def compress(self) -> int: + return self._compress + + @property + def client_notakeover(self) -> bool: + return self._client_notakeover + + def get_extra_info(self, name: str, default: Any = None) -> Any: + """extra info from connection transport""" + conn = self._response.connection + if conn is None: + return default + transport = conn.transport + if transport is None: + return default + return transport.get_extra_info(name, default) + + def exception(self) -> Optional[BaseException]: + return self._exception + + async def ping(self, message: bytes = b"") -> None: + await self._writer.ping(message) + + async def pong(self, message: bytes = b"") -> None: + await self._writer.pong(message) + + async def send_str(self, data: str, compress: Optional[int] = None) -> None: + if not isinstance(data, str): + raise TypeError("data argument must be str (%r)" % type(data)) + await self._writer.send(data, binary=False, compress=compress) + + async def send_bytes(self, data: bytes, compress: Optional[int] = None) -> None: + if not isinstance(data, (bytes, bytearray, memoryview)): + raise TypeError("data argument must be byte-ish (%r)" % type(data)) + await self._writer.send(data, binary=True, compress=compress) + + async def send_json( + self, + data: Any, + compress: Optional[int] = None, + *, + dumps: JSONEncoder = DEFAULT_JSON_ENCODER, + ) -> None: + await self.send_str(dumps(data), compress=compress) + + async def close(self, *, code: int = WSCloseCode.OK, message: bytes = b"") -> bool: + # we need to break `receive()` cycle first, + # `close()` may be called from different task + if self._waiting and not self._closing: + assert self._loop is not None + self._close_wait = self._loop.create_future() + self._set_closing() + self._reader.feed_data(WS_CLOSING_MESSAGE, 0) + await self._close_wait + + if not self._closed: + self._set_closed() + try: + await self._writer.close(code, message) + except asyncio.CancelledError: + self._close_code = WSCloseCode.ABNORMAL_CLOSURE + self._response.close() + raise + except Exception as exc: + self._close_code = WSCloseCode.ABNORMAL_CLOSURE + self._exception = exc + self._response.close() + return True + + if self._close_code: + self._response.close() + return True + + while True: + try: + async with async_timeout.timeout(self._timeout): + msg = await self._reader.read() + except asyncio.CancelledError: + self._close_code = WSCloseCode.ABNORMAL_CLOSURE + self._response.close() + raise + except Exception as exc: + self._close_code = WSCloseCode.ABNORMAL_CLOSURE + self._exception = exc + self._response.close() + return True + + if msg.type is WSMsgType.CLOSE: + self._close_code = msg.data + self._response.close() + return True + else: + return False + + async def receive(self, timeout: Optional[float] = None) -> WSMessage: + receive_timeout = timeout or self._receive_timeout + + while True: + if self._waiting: + raise RuntimeError("Concurrent call to receive() is not allowed") + + if self._closed: + return WS_CLOSED_MESSAGE + elif self._closing: + await self.close() + return WS_CLOSED_MESSAGE + + try: + self._waiting = True + try: + if receive_timeout: + # Entering the context manager and creating + # Timeout() object can take almost 50% of the + # run time in this loop so we avoid it if + # there is no read timeout. + async with async_timeout.timeout(receive_timeout): + msg = await self._reader.read() + else: + msg = await self._reader.read() + self._reset_heartbeat() + finally: + self._waiting = False + if self._close_wait: + set_result(self._close_wait, None) + except (asyncio.CancelledError, asyncio.TimeoutError): + self._close_code = WSCloseCode.ABNORMAL_CLOSURE + raise + except EofStream: + self._close_code = WSCloseCode.OK + await self.close() + return WSMessage(WSMsgType.CLOSED, None, None) + except ClientError: + # Likely ServerDisconnectedError when connection is lost + self._set_closed() + self._close_code = WSCloseCode.ABNORMAL_CLOSURE + return WS_CLOSED_MESSAGE + except WebSocketError as exc: + self._close_code = exc.code + await self.close(code=exc.code) + return WSMessage(WSMsgType.ERROR, exc, None) + except Exception as exc: + self._exception = exc + self._set_closing() + self._close_code = WSCloseCode.ABNORMAL_CLOSURE + await self.close() + return WSMessage(WSMsgType.ERROR, exc, None) + + if msg.type is WSMsgType.CLOSE: + self._set_closing() + self._close_code = msg.data + if not self._closed and self._autoclose: + await self.close() + elif msg.type is WSMsgType.CLOSING: + self._set_closing() + elif msg.type is WSMsgType.PING and self._autoping: + await self.pong(msg.data) + continue + elif msg.type is WSMsgType.PONG and self._autoping: + continue + + return msg + + async def receive_str(self, *, timeout: Optional[float] = None) -> str: + msg = await self.receive(timeout) + if msg.type is not WSMsgType.TEXT: + raise TypeError(f"Received message {msg.type}:{msg.data!r} is not str") + return cast(str, msg.data) + + async def receive_bytes(self, *, timeout: Optional[float] = None) -> bytes: + msg = await self.receive(timeout) + if msg.type is not WSMsgType.BINARY: + raise TypeError(f"Received message {msg.type}:{msg.data!r} is not bytes") + return cast(bytes, msg.data) + + async def receive_json( + self, + *, + loads: JSONDecoder = DEFAULT_JSON_DECODER, + timeout: Optional[float] = None, + ) -> Any: + data = await self.receive_str(timeout=timeout) + return loads(data) + + def __aiter__(self) -> "ClientWebSocketResponse": + return self + + async def __anext__(self) -> WSMessage: + msg = await self.receive() + if msg.type in (WSMsgType.CLOSE, WSMsgType.CLOSING, WSMsgType.CLOSED): + raise StopAsyncIteration + return msg diff --git a/env/Lib/site-packages/aiohttp/compression_utils.py b/env/Lib/site-packages/aiohttp/compression_utils.py new file mode 100644 index 0000000..ab4a2f1 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/compression_utils.py @@ -0,0 +1,159 @@ +import asyncio +import zlib +from concurrent.futures import Executor +from typing import Optional, cast + +try: + try: + import brotlicffi as brotli + except ImportError: + import brotli + + HAS_BROTLI = True +except ImportError: # pragma: no cover + HAS_BROTLI = False + +MAX_SYNC_CHUNK_SIZE = 1024 + + +def encoding_to_mode( + encoding: Optional[str] = None, + suppress_deflate_header: bool = False, +) -> int: + if encoding == "gzip": + return 16 + zlib.MAX_WBITS + + return -zlib.MAX_WBITS if suppress_deflate_header else zlib.MAX_WBITS + + +class ZlibBaseHandler: + def __init__( + self, + mode: int, + executor: Optional[Executor] = None, + max_sync_chunk_size: Optional[int] = MAX_SYNC_CHUNK_SIZE, + ): + self._mode = mode + self._executor = executor + self._max_sync_chunk_size = max_sync_chunk_size + + +class ZLibCompressor(ZlibBaseHandler): + def __init__( + self, + encoding: Optional[str] = None, + suppress_deflate_header: bool = False, + level: Optional[int] = None, + wbits: Optional[int] = None, + strategy: int = zlib.Z_DEFAULT_STRATEGY, + executor: Optional[Executor] = None, + max_sync_chunk_size: Optional[int] = MAX_SYNC_CHUNK_SIZE, + ): + super().__init__( + mode=( + encoding_to_mode(encoding, suppress_deflate_header) + if wbits is None + else wbits + ), + executor=executor, + max_sync_chunk_size=max_sync_chunk_size, + ) + if level is None: + self._compressor = zlib.compressobj(wbits=self._mode, strategy=strategy) + else: + self._compressor = zlib.compressobj( + wbits=self._mode, strategy=strategy, level=level + ) + self._compress_lock = asyncio.Lock() + + def compress_sync(self, data: bytes) -> bytes: + return self._compressor.compress(data) + + async def compress(self, data: bytes) -> bytes: + async with self._compress_lock: + # To ensure the stream is consistent in the event + # there are multiple writers, we need to lock + # the compressor so that only one writer can + # compress at a time. + if ( + self._max_sync_chunk_size is not None + and len(data) > self._max_sync_chunk_size + ): + return await asyncio.get_event_loop().run_in_executor( + self._executor, self.compress_sync, data + ) + return self.compress_sync(data) + + def flush(self, mode: int = zlib.Z_FINISH) -> bytes: + return self._compressor.flush(mode) + + +class ZLibDecompressor(ZlibBaseHandler): + def __init__( + self, + encoding: Optional[str] = None, + suppress_deflate_header: bool = False, + executor: Optional[Executor] = None, + max_sync_chunk_size: Optional[int] = MAX_SYNC_CHUNK_SIZE, + ): + super().__init__( + mode=encoding_to_mode(encoding, suppress_deflate_header), + executor=executor, + max_sync_chunk_size=max_sync_chunk_size, + ) + self._decompressor = zlib.decompressobj(wbits=self._mode) + + def decompress_sync(self, data: bytes, max_length: int = 0) -> bytes: + return self._decompressor.decompress(data, max_length) + + async def decompress(self, data: bytes, max_length: int = 0) -> bytes: + if ( + self._max_sync_chunk_size is not None + and len(data) > self._max_sync_chunk_size + ): + return await asyncio.get_event_loop().run_in_executor( + self._executor, self.decompress_sync, data, max_length + ) + return self.decompress_sync(data, max_length) + + def flush(self, length: int = 0) -> bytes: + return ( + self._decompressor.flush(length) + if length > 0 + else self._decompressor.flush() + ) + + @property + def eof(self) -> bool: + return self._decompressor.eof + + @property + def unconsumed_tail(self) -> bytes: + return self._decompressor.unconsumed_tail + + @property + def unused_data(self) -> bytes: + return self._decompressor.unused_data + + +class BrotliDecompressor: + # Supports both 'brotlipy' and 'Brotli' packages + # since they share an import name. The top branches + # are for 'brotlipy' and bottom branches for 'Brotli' + def __init__(self) -> None: + if not HAS_BROTLI: + raise RuntimeError( + "The brotli decompression is not available. " + "Please install `Brotli` module" + ) + self._obj = brotli.Decompressor() + + def decompress_sync(self, data: bytes) -> bytes: + if hasattr(self._obj, "decompress"): + return cast(bytes, self._obj.decompress(data)) + return cast(bytes, self._obj.process(data)) + + def flush(self) -> bytes: + if hasattr(self._obj, "flush"): + return cast(bytes, self._obj.flush()) + return b"" diff --git a/env/Lib/site-packages/aiohttp/connector.py b/env/Lib/site-packages/aiohttp/connector.py new file mode 100644 index 0000000..04115c3 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/connector.py @@ -0,0 +1,1608 @@ +import asyncio +import functools +import random +import socket +import sys +import traceback +import warnings +from collections import defaultdict, deque +from contextlib import suppress +from http import HTTPStatus +from http.cookies import SimpleCookie +from itertools import cycle, islice +from time import monotonic +from types import TracebackType +from typing import ( + TYPE_CHECKING, + Any, + Awaitable, + Callable, + DefaultDict, + Dict, + Iterator, + List, + Literal, + Optional, + Sequence, + Set, + Tuple, + Type, + Union, + cast, +) + +import aiohappyeyeballs +import attr + +from . import hdrs, helpers +from .abc import AbstractResolver, ResolveResult +from .client_exceptions import ( + ClientConnectionError, + ClientConnectorCertificateError, + ClientConnectorError, + ClientConnectorSSLError, + ClientHttpProxyError, + ClientProxyConnectionError, + ServerFingerprintMismatch, + UnixClientConnectorError, + cert_errors, + ssl_errors, +) +from .client_proto import ResponseHandler +from .client_reqrep import ClientRequest, Fingerprint, _merge_ssl_params +from .helpers import ( + ceil_timeout, + is_ip_address, + noop, + sentinel, + set_exception, + set_result, +) +from .locks import EventResultOrError +from .resolver import DefaultResolver + +try: + import ssl + + SSLContext = ssl.SSLContext +except ImportError: # pragma: no cover + ssl = None # type: ignore[assignment] + SSLContext = object # type: ignore[misc,assignment] + + +EMPTY_SCHEMA_SET = frozenset({""}) +HTTP_SCHEMA_SET = frozenset({"http", "https"}) +WS_SCHEMA_SET = frozenset({"ws", "wss"}) + +HTTP_AND_EMPTY_SCHEMA_SET = HTTP_SCHEMA_SET | EMPTY_SCHEMA_SET +HIGH_LEVEL_SCHEMA_SET = HTTP_AND_EMPTY_SCHEMA_SET | WS_SCHEMA_SET + + +__all__ = ("BaseConnector", "TCPConnector", "UnixConnector", "NamedPipeConnector") + + +if TYPE_CHECKING: + from .client import ClientTimeout + from .client_reqrep import ConnectionKey + from .tracing import Trace + + +class _DeprecationWaiter: + __slots__ = ("_awaitable", "_awaited") + + def __init__(self, awaitable: Awaitable[Any]) -> None: + self._awaitable = awaitable + self._awaited = False + + def __await__(self) -> Any: + self._awaited = True + return self._awaitable.__await__() + + def __del__(self) -> None: + if not self._awaited: + warnings.warn( + "Connector.close() is a coroutine, " + "please use await connector.close()", + DeprecationWarning, + ) + + +class Connection: + + _source_traceback = None + _transport = None + + def __init__( + self, + connector: "BaseConnector", + key: "ConnectionKey", + protocol: ResponseHandler, + loop: asyncio.AbstractEventLoop, + ) -> None: + self._key = key + self._connector = connector + self._loop = loop + self._protocol: Optional[ResponseHandler] = protocol + self._callbacks: List[Callable[[], None]] = [] + + if loop.get_debug(): + self._source_traceback = traceback.extract_stack(sys._getframe(1)) + + def __repr__(self) -> str: + return f"Connection<{self._key}>" + + def __del__(self, _warnings: Any = warnings) -> None: + if self._protocol is not None: + kwargs = {"source": self} + _warnings.warn(f"Unclosed connection {self!r}", ResourceWarning, **kwargs) + if self._loop.is_closed(): + return + + self._connector._release(self._key, self._protocol, should_close=True) + + context = {"client_connection": self, "message": "Unclosed connection"} + if self._source_traceback is not None: + context["source_traceback"] = self._source_traceback + self._loop.call_exception_handler(context) + + def __bool__(self) -> Literal[True]: + """Force subclasses to not be falsy, to make checks simpler.""" + return True + + @property + def loop(self) -> asyncio.AbstractEventLoop: + warnings.warn( + "connector.loop property is deprecated", DeprecationWarning, stacklevel=2 + ) + return self._loop + + @property + def transport(self) -> Optional[asyncio.Transport]: + if self._protocol is None: + return None + return self._protocol.transport + + @property + def protocol(self) -> Optional[ResponseHandler]: + return self._protocol + + def add_callback(self, callback: Callable[[], None]) -> None: + if callback is not None: + self._callbacks.append(callback) + + def _notify_release(self) -> None: + callbacks, self._callbacks = self._callbacks[:], [] + + for cb in callbacks: + with suppress(Exception): + cb() + + def close(self) -> None: + self._notify_release() + + if self._protocol is not None: + self._connector._release(self._key, self._protocol, should_close=True) + self._protocol = None + + def release(self) -> None: + self._notify_release() + + if self._protocol is not None: + self._connector._release( + self._key, self._protocol, should_close=self._protocol.should_close + ) + self._protocol = None + + @property + def closed(self) -> bool: + return self._protocol is None or not self._protocol.is_connected() + + +class _TransportPlaceholder: + """placeholder for BaseConnector.connect function""" + + def close(self) -> None: + pass + + +class BaseConnector: + """Base connector class. + + keepalive_timeout - (optional) Keep-alive timeout. + force_close - Set to True to force close and do reconnect + after each request (and between redirects). + limit - The total number of simultaneous connections. + limit_per_host - Number of simultaneous connections to one host. + enable_cleanup_closed - Enables clean-up closed ssl transports. + Disabled by default. + timeout_ceil_threshold - Trigger ceiling of timeout values when + it's above timeout_ceil_threshold. + loop - Optional event loop. + """ + + _closed = True # prevent AttributeError in __del__ if ctor was failed + _source_traceback = None + + # abort transport after 2 seconds (cleanup broken connections) + _cleanup_closed_period = 2.0 + + allowed_protocol_schema_set = HIGH_LEVEL_SCHEMA_SET + + def __init__( + self, + *, + keepalive_timeout: Union[object, None, float] = sentinel, + force_close: bool = False, + limit: int = 100, + limit_per_host: int = 0, + enable_cleanup_closed: bool = False, + loop: Optional[asyncio.AbstractEventLoop] = None, + timeout_ceil_threshold: float = 5, + ) -> None: + + if force_close: + if keepalive_timeout is not None and keepalive_timeout is not sentinel: + raise ValueError( + "keepalive_timeout cannot " "be set if force_close is True" + ) + else: + if keepalive_timeout is sentinel: + keepalive_timeout = 15.0 + + loop = loop or asyncio.get_running_loop() + self._timeout_ceil_threshold = timeout_ceil_threshold + + self._closed = False + if loop.get_debug(): + self._source_traceback = traceback.extract_stack(sys._getframe(1)) + + self._conns: Dict[ConnectionKey, List[Tuple[ResponseHandler, float]]] = {} + self._limit = limit + self._limit_per_host = limit_per_host + self._acquired: Set[ResponseHandler] = set() + self._acquired_per_host: DefaultDict[ConnectionKey, Set[ResponseHandler]] = ( + defaultdict(set) + ) + self._keepalive_timeout = cast(float, keepalive_timeout) + self._force_close = force_close + + # {host_key: FIFO list of waiters} + self._waiters = defaultdict(deque) # type: ignore[var-annotated] + + self._loop = loop + self._factory = functools.partial(ResponseHandler, loop=loop) + + self.cookies = SimpleCookie() + + # start keep-alive connection cleanup task + self._cleanup_handle: Optional[asyncio.TimerHandle] = None + + # start cleanup closed transports task + self._cleanup_closed_handle: Optional[asyncio.TimerHandle] = None + self._cleanup_closed_disabled = not enable_cleanup_closed + self._cleanup_closed_transports: List[Optional[asyncio.Transport]] = [] + self._cleanup_closed() + + def __del__(self, _warnings: Any = warnings) -> None: + if self._closed: + return + if not self._conns: + return + + conns = [repr(c) for c in self._conns.values()] + + self._close() + + kwargs = {"source": self} + _warnings.warn(f"Unclosed connector {self!r}", ResourceWarning, **kwargs) + context = { + "connector": self, + "connections": conns, + "message": "Unclosed connector", + } + if self._source_traceback is not None: + context["source_traceback"] = self._source_traceback + self._loop.call_exception_handler(context) + + def __enter__(self) -> "BaseConnector": + warnings.warn( + '"with Connector():" is deprecated, ' + 'use "async with Connector():" instead', + DeprecationWarning, + ) + return self + + def __exit__(self, *exc: Any) -> None: + self._close() + + async def __aenter__(self) -> "BaseConnector": + return self + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]] = None, + exc_value: Optional[BaseException] = None, + exc_traceback: Optional[TracebackType] = None, + ) -> None: + await self.close() + + @property + def force_close(self) -> bool: + """Ultimately close connection on releasing if True.""" + return self._force_close + + @property + def limit(self) -> int: + """The total number for simultaneous connections. + + If limit is 0 the connector has no limit. + The default limit size is 100. + """ + return self._limit + + @property + def limit_per_host(self) -> int: + """The limit for simultaneous connections to the same endpoint. + + Endpoints are the same if they are have equal + (host, port, is_ssl) triple. + """ + return self._limit_per_host + + def _cleanup(self) -> None: + """Cleanup unused transports.""" + if self._cleanup_handle: + self._cleanup_handle.cancel() + # _cleanup_handle should be unset, otherwise _release() will not + # recreate it ever! + self._cleanup_handle = None + + now = self._loop.time() + timeout = self._keepalive_timeout + + if self._conns: + connections = {} + deadline = now - timeout + for key, conns in self._conns.items(): + alive = [] + for proto, use_time in conns: + if proto.is_connected(): + if use_time - deadline < 0: + transport = proto.transport + proto.close() + if key.is_ssl and not self._cleanup_closed_disabled: + self._cleanup_closed_transports.append(transport) + else: + alive.append((proto, use_time)) + else: + transport = proto.transport + proto.close() + if key.is_ssl and not self._cleanup_closed_disabled: + self._cleanup_closed_transports.append(transport) + + if alive: + connections[key] = alive + + self._conns = connections + + if self._conns: + self._cleanup_handle = helpers.weakref_handle( + self, + "_cleanup", + timeout, + self._loop, + timeout_ceil_threshold=self._timeout_ceil_threshold, + ) + + def _drop_acquired_per_host( + self, key: "ConnectionKey", val: ResponseHandler + ) -> None: + acquired_per_host = self._acquired_per_host + if key not in acquired_per_host: + return + conns = acquired_per_host[key] + conns.remove(val) + if not conns: + del self._acquired_per_host[key] + + def _cleanup_closed(self) -> None: + """Double confirmation for transport close. + + Some broken ssl servers may leave socket open without proper close. + """ + if self._cleanup_closed_handle: + self._cleanup_closed_handle.cancel() + + for transport in self._cleanup_closed_transports: + if transport is not None: + transport.abort() + + self._cleanup_closed_transports = [] + + if not self._cleanup_closed_disabled: + self._cleanup_closed_handle = helpers.weakref_handle( + self, + "_cleanup_closed", + self._cleanup_closed_period, + self._loop, + timeout_ceil_threshold=self._timeout_ceil_threshold, + ) + + def close(self) -> Awaitable[None]: + """Close all opened transports.""" + self._close() + return _DeprecationWaiter(noop()) + + def _close(self) -> None: + if self._closed: + return + + self._closed = True + + try: + if self._loop.is_closed(): + return + + # cancel cleanup task + if self._cleanup_handle: + self._cleanup_handle.cancel() + + # cancel cleanup close task + if self._cleanup_closed_handle: + self._cleanup_closed_handle.cancel() + + for data in self._conns.values(): + for proto, t0 in data: + proto.close() + + for proto in self._acquired: + proto.close() + + for transport in self._cleanup_closed_transports: + if transport is not None: + transport.abort() + + finally: + self._conns.clear() + self._acquired.clear() + self._waiters.clear() + self._cleanup_handle = None + self._cleanup_closed_transports.clear() + self._cleanup_closed_handle = None + + @property + def closed(self) -> bool: + """Is connector closed. + + A readonly property. + """ + return self._closed + + def _available_connections(self, key: "ConnectionKey") -> int: + """ + Return number of available connections. + + The limit, limit_per_host and the connection key are taken into account. + + If it returns less than 1 means that there are no connections + available. + """ + if self._limit: + # total calc available connections + available = self._limit - len(self._acquired) + + # check limit per host + if ( + self._limit_per_host + and available > 0 + and key in self._acquired_per_host + ): + acquired = self._acquired_per_host.get(key) + assert acquired is not None + available = self._limit_per_host - len(acquired) + + elif self._limit_per_host and key in self._acquired_per_host: + # check limit per host + acquired = self._acquired_per_host.get(key) + assert acquired is not None + available = self._limit_per_host - len(acquired) + else: + available = 1 + + return available + + async def connect( + self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout" + ) -> Connection: + """Get from pool or create new connection.""" + key = req.connection_key + available = self._available_connections(key) + + # Wait if there are no available connections or if there are/were + # waiters (i.e. don't steal connection from a waiter about to wake up) + if available <= 0 or key in self._waiters: + fut = self._loop.create_future() + + # This connection will now count towards the limit. + self._waiters[key].append(fut) + + if traces: + for trace in traces: + await trace.send_connection_queued_start() + + try: + await fut + except BaseException as e: + if key in self._waiters: + # remove a waiter even if it was cancelled, normally it's + # removed when it's notified + try: + self._waiters[key].remove(fut) + except ValueError: # fut may no longer be in list + pass + + raise e + finally: + if key in self._waiters and not self._waiters[key]: + del self._waiters[key] + + if traces: + for trace in traces: + await trace.send_connection_queued_end() + + proto = self._get(key) + if proto is None: + placeholder = cast(ResponseHandler, _TransportPlaceholder()) + self._acquired.add(placeholder) + self._acquired_per_host[key].add(placeholder) + + if traces: + for trace in traces: + await trace.send_connection_create_start() + + try: + proto = await self._create_connection(req, traces, timeout) + if self._closed: + proto.close() + raise ClientConnectionError("Connector is closed.") + except BaseException: + if not self._closed: + self._acquired.remove(placeholder) + self._drop_acquired_per_host(key, placeholder) + self._release_waiter() + raise + else: + if not self._closed: + self._acquired.remove(placeholder) + self._drop_acquired_per_host(key, placeholder) + + if traces: + for trace in traces: + await trace.send_connection_create_end() + else: + if traces: + # Acquire the connection to prevent race conditions with limits + placeholder = cast(ResponseHandler, _TransportPlaceholder()) + self._acquired.add(placeholder) + self._acquired_per_host[key].add(placeholder) + for trace in traces: + await trace.send_connection_reuseconn() + self._acquired.remove(placeholder) + self._drop_acquired_per_host(key, placeholder) + + self._acquired.add(proto) + self._acquired_per_host[key].add(proto) + return Connection(self, key, proto, self._loop) + + def _get(self, key: "ConnectionKey") -> Optional[ResponseHandler]: + try: + conns = self._conns[key] + except KeyError: + return None + + t1 = self._loop.time() + while conns: + proto, t0 = conns.pop() + if proto.is_connected(): + if t1 - t0 > self._keepalive_timeout: + transport = proto.transport + proto.close() + # only for SSL transports + if key.is_ssl and not self._cleanup_closed_disabled: + self._cleanup_closed_transports.append(transport) + else: + if not conns: + # The very last connection was reclaimed: drop the key + del self._conns[key] + return proto + else: + transport = proto.transport + proto.close() + if key.is_ssl and not self._cleanup_closed_disabled: + self._cleanup_closed_transports.append(transport) + + # No more connections: drop the key + del self._conns[key] + return None + + def _release_waiter(self) -> None: + """ + Iterates over all waiters until one to be released is found. + + The one to be released is not finished and + belongs to a host that has available connections. + """ + if not self._waiters: + return + + # Having the dict keys ordered this avoids to iterate + # at the same order at each call. + queues = list(self._waiters.keys()) + random.shuffle(queues) + + for key in queues: + if self._available_connections(key) < 1: + continue + + waiters = self._waiters[key] + while waiters: + waiter = waiters.popleft() + if not waiter.done(): + waiter.set_result(None) + return + + def _release_acquired(self, key: "ConnectionKey", proto: ResponseHandler) -> None: + if self._closed: + # acquired connection is already released on connector closing + return + + try: + self._acquired.remove(proto) + self._drop_acquired_per_host(key, proto) + except KeyError: # pragma: no cover + # this may be result of undetermenistic order of objects + # finalization due garbage collection. + pass + else: + self._release_waiter() + + def _release( + self, + key: "ConnectionKey", + protocol: ResponseHandler, + *, + should_close: bool = False, + ) -> None: + if self._closed: + # acquired connection is already released on connector closing + return + + self._release_acquired(key, protocol) + + if self._force_close: + should_close = True + + if should_close or protocol.should_close: + transport = protocol.transport + protocol.close() + + if key.is_ssl and not self._cleanup_closed_disabled: + self._cleanup_closed_transports.append(transport) + else: + conns = self._conns.get(key) + if conns is None: + conns = self._conns[key] = [] + conns.append((protocol, self._loop.time())) + + if self._cleanup_handle is None: + self._cleanup_handle = helpers.weakref_handle( + self, + "_cleanup", + self._keepalive_timeout, + self._loop, + timeout_ceil_threshold=self._timeout_ceil_threshold, + ) + + async def _create_connection( + self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout" + ) -> ResponseHandler: + raise NotImplementedError() + + +class _DNSCacheTable: + def __init__(self, ttl: Optional[float] = None) -> None: + self._addrs_rr: Dict[Tuple[str, int], Tuple[Iterator[ResolveResult], int]] = {} + self._timestamps: Dict[Tuple[str, int], float] = {} + self._ttl = ttl + + def __contains__(self, host: object) -> bool: + return host in self._addrs_rr + + def add(self, key: Tuple[str, int], addrs: List[ResolveResult]) -> None: + self._addrs_rr[key] = (cycle(addrs), len(addrs)) + + if self._ttl is not None: + self._timestamps[key] = monotonic() + + def remove(self, key: Tuple[str, int]) -> None: + self._addrs_rr.pop(key, None) + + if self._ttl is not None: + self._timestamps.pop(key, None) + + def clear(self) -> None: + self._addrs_rr.clear() + self._timestamps.clear() + + def next_addrs(self, key: Tuple[str, int]) -> List[ResolveResult]: + loop, length = self._addrs_rr[key] + addrs = list(islice(loop, length)) + # Consume one more element to shift internal state of `cycle` + next(loop) + return addrs + + def expired(self, key: Tuple[str, int]) -> bool: + if self._ttl is None: + return False + + return self._timestamps[key] + self._ttl < monotonic() + + +class TCPConnector(BaseConnector): + """TCP connector. + + verify_ssl - Set to True to check ssl certifications. + fingerprint - Pass the binary sha256 + digest of the expected certificate in DER format to verify + that the certificate the server presents matches. See also + https://en.wikipedia.org/wiki/HTTP_Public_Key_Pinning + resolver - Enable DNS lookups and use this + resolver + use_dns_cache - Use memory cache for DNS lookups. + ttl_dns_cache - Max seconds having cached a DNS entry, None forever. + family - socket address family + local_addr - local tuple of (host, port) to bind socket to + + keepalive_timeout - (optional) Keep-alive timeout. + force_close - Set to True to force close and do reconnect + after each request (and between redirects). + limit - The total number of simultaneous connections. + limit_per_host - Number of simultaneous connections to one host. + enable_cleanup_closed - Enables clean-up closed ssl transports. + Disabled by default. + happy_eyeballs_delay - This is the “Connection Attempt Delay” + as defined in RFC 8305. To disable + the happy eyeballs algorithm, set to None. + interleave - “First Address Family Count” as defined in RFC 8305 + loop - Optional event loop. + """ + + allowed_protocol_schema_set = HIGH_LEVEL_SCHEMA_SET | frozenset({"tcp"}) + _made_ssl_context: Dict[bool, "asyncio.Future[SSLContext]"] = {} + + def __init__( + self, + *, + verify_ssl: bool = True, + fingerprint: Optional[bytes] = None, + use_dns_cache: bool = True, + ttl_dns_cache: Optional[int] = 10, + family: socket.AddressFamily = socket.AddressFamily.AF_UNSPEC, + ssl_context: Optional[SSLContext] = None, + ssl: Union[bool, Fingerprint, SSLContext] = True, + local_addr: Optional[Tuple[str, int]] = None, + resolver: Optional[AbstractResolver] = None, + keepalive_timeout: Union[None, float, object] = sentinel, + force_close: bool = False, + limit: int = 100, + limit_per_host: int = 0, + enable_cleanup_closed: bool = False, + loop: Optional[asyncio.AbstractEventLoop] = None, + timeout_ceil_threshold: float = 5, + happy_eyeballs_delay: Optional[float] = 0.25, + interleave: Optional[int] = None, + ): + super().__init__( + keepalive_timeout=keepalive_timeout, + force_close=force_close, + limit=limit, + limit_per_host=limit_per_host, + enable_cleanup_closed=enable_cleanup_closed, + loop=loop, + timeout_ceil_threshold=timeout_ceil_threshold, + ) + + self._ssl = _merge_ssl_params(ssl, verify_ssl, ssl_context, fingerprint) + if resolver is None: + resolver = DefaultResolver(loop=self._loop) + self._resolver = resolver + + self._use_dns_cache = use_dns_cache + self._cached_hosts = _DNSCacheTable(ttl=ttl_dns_cache) + self._throttle_dns_events: Dict[Tuple[str, int], EventResultOrError] = {} + self._family = family + self._local_addr_infos = aiohappyeyeballs.addr_to_addr_infos(local_addr) + self._happy_eyeballs_delay = happy_eyeballs_delay + self._interleave = interleave + + def close(self) -> Awaitable[None]: + """Close all ongoing DNS calls.""" + for ev in self._throttle_dns_events.values(): + ev.cancel() + + return super().close() + + @property + def family(self) -> int: + """Socket family like AF_INET.""" + return self._family + + @property + def use_dns_cache(self) -> bool: + """True if local DNS caching is enabled.""" + return self._use_dns_cache + + def clear_dns_cache( + self, host: Optional[str] = None, port: Optional[int] = None + ) -> None: + """Remove specified host/port or clear all dns local cache.""" + if host is not None and port is not None: + self._cached_hosts.remove((host, port)) + elif host is not None or port is not None: + raise ValueError("either both host and port " "or none of them are allowed") + else: + self._cached_hosts.clear() + + async def _resolve_host( + self, host: str, port: int, traces: Optional[Sequence["Trace"]] = None + ) -> List[ResolveResult]: + """Resolve host and return list of addresses.""" + if is_ip_address(host): + return [ + { + "hostname": host, + "host": host, + "port": port, + "family": self._family, + "proto": 0, + "flags": 0, + } + ] + + if not self._use_dns_cache: + + if traces: + for trace in traces: + await trace.send_dns_resolvehost_start(host) + + res = await self._resolver.resolve(host, port, family=self._family) + + if traces: + for trace in traces: + await trace.send_dns_resolvehost_end(host) + + return res + + key = (host, port) + if key in self._cached_hosts and not self._cached_hosts.expired(key): + # get result early, before any await (#4014) + result = self._cached_hosts.next_addrs(key) + + if traces: + for trace in traces: + await trace.send_dns_cache_hit(host) + return result + + # + # If multiple connectors are resolving the same host, we wait + # for the first one to resolve and then use the result for all of them. + # We use a throttle event to ensure that we only resolve the host once + # and then use the result for all the waiters. + # + # In this case we need to create a task to ensure that we can shield + # the task from cancellation as cancelling this lookup should not cancel + # the underlying lookup or else the cancel event will get broadcast to + # all the waiters across all connections. + # + resolved_host_task = asyncio.create_task( + self._resolve_host_with_throttle(key, host, port, traces) + ) + try: + return await asyncio.shield(resolved_host_task) + except asyncio.CancelledError: + + def drop_exception(fut: "asyncio.Future[List[ResolveResult]]") -> None: + with suppress(Exception, asyncio.CancelledError): + fut.result() + + resolved_host_task.add_done_callback(drop_exception) + raise + + async def _resolve_host_with_throttle( + self, + key: Tuple[str, int], + host: str, + port: int, + traces: Optional[Sequence["Trace"]], + ) -> List[ResolveResult]: + """Resolve host with a dns events throttle.""" + if key in self._throttle_dns_events: + # get event early, before any await (#4014) + event = self._throttle_dns_events[key] + if traces: + for trace in traces: + await trace.send_dns_cache_hit(host) + await event.wait() + else: + # update dict early, before any await (#4014) + self._throttle_dns_events[key] = EventResultOrError(self._loop) + if traces: + for trace in traces: + await trace.send_dns_cache_miss(host) + try: + + if traces: + for trace in traces: + await trace.send_dns_resolvehost_start(host) + + addrs = await self._resolver.resolve(host, port, family=self._family) + if traces: + for trace in traces: + await trace.send_dns_resolvehost_end(host) + + self._cached_hosts.add(key, addrs) + self._throttle_dns_events[key].set() + except BaseException as e: + # any DNS exception, independently of the implementation + # is set for the waiters to raise the same exception. + self._throttle_dns_events[key].set(exc=e) + raise + finally: + self._throttle_dns_events.pop(key) + + return self._cached_hosts.next_addrs(key) + + async def _create_connection( + self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout" + ) -> ResponseHandler: + """Create connection. + + Has same keyword arguments as BaseEventLoop.create_connection. + """ + if req.proxy: + _, proto = await self._create_proxy_connection(req, traces, timeout) + else: + _, proto = await self._create_direct_connection(req, traces, timeout) + + return proto + + @staticmethod + def _make_ssl_context(verified: bool) -> SSLContext: + """Create SSL context. + + This method is not async-friendly and should be called from a thread + because it will load certificates from disk and do other blocking I/O. + """ + if verified: + return ssl.create_default_context() + sslcontext = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT) + sslcontext.options |= ssl.OP_NO_SSLv2 + sslcontext.options |= ssl.OP_NO_SSLv3 + sslcontext.check_hostname = False + sslcontext.verify_mode = ssl.CERT_NONE + sslcontext.options |= ssl.OP_NO_COMPRESSION + sslcontext.set_default_verify_paths() + return sslcontext + + async def _get_ssl_context(self, req: ClientRequest) -> Optional[SSLContext]: + """Logic to get the correct SSL context + + 0. if req.ssl is false, return None + + 1. if ssl_context is specified in req, use it + 2. if _ssl_context is specified in self, use it + 3. otherwise: + 1. if verify_ssl is not specified in req, use self.ssl_context + (will generate a default context according to self.verify_ssl) + 2. if verify_ssl is True in req, generate a default SSL context + 3. if verify_ssl is False in req, generate a SSL context that + won't verify + """ + if not req.is_ssl(): + return None + + if ssl is None: # pragma: no cover + raise RuntimeError("SSL is not supported.") + sslcontext = req.ssl + if isinstance(sslcontext, ssl.SSLContext): + return sslcontext + if sslcontext is not True: + # not verified or fingerprinted + return await self._make_or_get_ssl_context(False) + sslcontext = self._ssl + if isinstance(sslcontext, ssl.SSLContext): + return sslcontext + if sslcontext is not True: + # not verified or fingerprinted + return await self._make_or_get_ssl_context(False) + return await self._make_or_get_ssl_context(True) + + async def _make_or_get_ssl_context(self, verified: bool) -> SSLContext: + """Create or get cached SSL context.""" + try: + return await self._made_ssl_context[verified] + except KeyError: + loop = self._loop + future = loop.create_future() + self._made_ssl_context[verified] = future + try: + result = await loop.run_in_executor( + None, self._make_ssl_context, verified + ) + # BaseException is used since we might get CancelledError + except BaseException as ex: + del self._made_ssl_context[verified] + set_exception(future, ex) + raise + else: + set_result(future, result) + return result + + def _get_fingerprint(self, req: ClientRequest) -> Optional["Fingerprint"]: + ret = req.ssl + if isinstance(ret, Fingerprint): + return ret + ret = self._ssl + if isinstance(ret, Fingerprint): + return ret + return None + + async def _wrap_create_connection( + self, + *args: Any, + addr_infos: List[aiohappyeyeballs.AddrInfoType], + req: ClientRequest, + timeout: "ClientTimeout", + client_error: Type[Exception] = ClientConnectorError, + **kwargs: Any, + ) -> Tuple[asyncio.Transport, ResponseHandler]: + try: + async with ceil_timeout( + timeout.sock_connect, ceil_threshold=timeout.ceil_threshold + ): + sock = await aiohappyeyeballs.start_connection( + addr_infos=addr_infos, + local_addr_infos=self._local_addr_infos, + happy_eyeballs_delay=self._happy_eyeballs_delay, + interleave=self._interleave, + loop=self._loop, + ) + return await self._loop.create_connection(*args, **kwargs, sock=sock) + except cert_errors as exc: + raise ClientConnectorCertificateError(req.connection_key, exc) from exc + except ssl_errors as exc: + raise ClientConnectorSSLError(req.connection_key, exc) from exc + except OSError as exc: + if exc.errno is None and isinstance(exc, asyncio.TimeoutError): + raise + raise client_error(req.connection_key, exc) from exc + + async def _wrap_existing_connection( + self, + *args: Any, + req: ClientRequest, + timeout: "ClientTimeout", + client_error: Type[Exception] = ClientConnectorError, + **kwargs: Any, + ) -> Tuple[asyncio.Transport, ResponseHandler]: + try: + async with ceil_timeout( + timeout.sock_connect, ceil_threshold=timeout.ceil_threshold + ): + return await self._loop.create_connection(*args, **kwargs) + except cert_errors as exc: + raise ClientConnectorCertificateError(req.connection_key, exc) from exc + except ssl_errors as exc: + raise ClientConnectorSSLError(req.connection_key, exc) from exc + except OSError as exc: + if exc.errno is None and isinstance(exc, asyncio.TimeoutError): + raise + raise client_error(req.connection_key, exc) from exc + + def _fail_on_no_start_tls(self, req: "ClientRequest") -> None: + """Raise a :py:exc:`RuntimeError` on missing ``start_tls()``. + + It is necessary for TLS-in-TLS so that it is possible to + send HTTPS queries through HTTPS proxies. + + This doesn't affect regular HTTP requests, though. + """ + if not req.is_ssl(): + return + + proxy_url = req.proxy + assert proxy_url is not None + if proxy_url.scheme != "https": + return + + self._check_loop_for_start_tls() + + def _check_loop_for_start_tls(self) -> None: + try: + self._loop.start_tls + except AttributeError as attr_exc: + raise RuntimeError( + "An HTTPS request is being sent through an HTTPS proxy. " + "This needs support for TLS in TLS but it is not implemented " + "in your runtime for the stdlib asyncio.\n\n" + "Please upgrade to Python 3.11 or higher. For more details, " + "please see:\n" + "* https://bugs.python.org/issue37179\n" + "* https://github.com/python/cpython/pull/28073\n" + "* https://docs.aiohttp.org/en/stable/" + "client_advanced.html#proxy-support\n" + "* https://github.com/aio-libs/aiohttp/discussions/6044\n", + ) from attr_exc + + def _loop_supports_start_tls(self) -> bool: + try: + self._check_loop_for_start_tls() + except RuntimeError: + return False + else: + return True + + def _warn_about_tls_in_tls( + self, + underlying_transport: asyncio.Transport, + req: ClientRequest, + ) -> None: + """Issue a warning if the requested URL has HTTPS scheme.""" + if req.request_info.url.scheme != "https": + return + + asyncio_supports_tls_in_tls = getattr( + underlying_transport, + "_start_tls_compatible", + False, + ) + + if asyncio_supports_tls_in_tls: + return + + warnings.warn( + "An HTTPS request is being sent through an HTTPS proxy. " + "This support for TLS in TLS is known to be disabled " + "in the stdlib asyncio (Python <3.11). This is why you'll probably see " + "an error in the log below.\n\n" + "It is possible to enable it via monkeypatching. " + "For more details, see:\n" + "* https://bugs.python.org/issue37179\n" + "* https://github.com/python/cpython/pull/28073\n\n" + "You can temporarily patch this as follows:\n" + "* https://docs.aiohttp.org/en/stable/client_advanced.html#proxy-support\n" + "* https://github.com/aio-libs/aiohttp/discussions/6044\n", + RuntimeWarning, + source=self, + # Why `4`? At least 3 of the calls in the stack originate + # from the methods in this class. + stacklevel=3, + ) + + async def _start_tls_connection( + self, + underlying_transport: asyncio.Transport, + req: ClientRequest, + timeout: "ClientTimeout", + client_error: Type[Exception] = ClientConnectorError, + ) -> Tuple[asyncio.BaseTransport, ResponseHandler]: + """Wrap the raw TCP transport with TLS.""" + tls_proto = self._factory() # Create a brand new proto for TLS + + # Safety of the `cast()` call here is based on the fact that + # internally `_get_ssl_context()` only returns `None` when + # `req.is_ssl()` evaluates to `False` which is never gonna happen + # in this code path. Of course, it's rather fragile + # maintainability-wise but this is to be solved separately. + sslcontext = cast(ssl.SSLContext, await self._get_ssl_context(req)) + + try: + async with ceil_timeout( + timeout.sock_connect, ceil_threshold=timeout.ceil_threshold + ): + try: + tls_transport = await self._loop.start_tls( + underlying_transport, + tls_proto, + sslcontext, + server_hostname=req.server_hostname or req.host, + ssl_handshake_timeout=timeout.total, + ) + except BaseException: + # We need to close the underlying transport since + # `start_tls()` probably failed before it had a + # chance to do this: + underlying_transport.close() + raise + except cert_errors as exc: + raise ClientConnectorCertificateError(req.connection_key, exc) from exc + except ssl_errors as exc: + raise ClientConnectorSSLError(req.connection_key, exc) from exc + except OSError as exc: + if exc.errno is None and isinstance(exc, asyncio.TimeoutError): + raise + raise client_error(req.connection_key, exc) from exc + except TypeError as type_err: + # Example cause looks like this: + # TypeError: transport is not supported by start_tls() + + raise ClientConnectionError( + "Cannot initialize a TLS-in-TLS connection to host " + f"{req.host!s}:{req.port:d} through an underlying connection " + f"to an HTTPS proxy {req.proxy!s} ssl:{req.ssl or 'default'} " + f"[{type_err!s}]" + ) from type_err + else: + if tls_transport is None: + msg = "Failed to start TLS (possibly caused by closing transport)" + raise client_error(req.connection_key, OSError(msg)) + tls_proto.connection_made( + tls_transport + ) # Kick the state machine of the new TLS protocol + + return tls_transport, tls_proto + + def _convert_hosts_to_addr_infos( + self, hosts: List[ResolveResult] + ) -> List[aiohappyeyeballs.AddrInfoType]: + """Converts the list of hosts to a list of addr_infos. + + The list of hosts is the result of a DNS lookup. The list of + addr_infos is the result of a call to `socket.getaddrinfo()`. + """ + addr_infos: List[aiohappyeyeballs.AddrInfoType] = [] + for hinfo in hosts: + host = hinfo["host"] + is_ipv6 = ":" in host + family = socket.AF_INET6 if is_ipv6 else socket.AF_INET + if self._family and self._family != family: + continue + addr = (host, hinfo["port"], 0, 0) if is_ipv6 else (host, hinfo["port"]) + addr_infos.append( + (family, socket.SOCK_STREAM, socket.IPPROTO_TCP, "", addr) + ) + return addr_infos + + async def _create_direct_connection( + self, + req: ClientRequest, + traces: List["Trace"], + timeout: "ClientTimeout", + *, + client_error: Type[Exception] = ClientConnectorError, + ) -> Tuple[asyncio.Transport, ResponseHandler]: + sslcontext = await self._get_ssl_context(req) + fingerprint = self._get_fingerprint(req) + + host = req.url.raw_host + assert host is not None + # Replace multiple trailing dots with a single one. + # A trailing dot is only present for fully-qualified domain names. + # See https://github.com/aio-libs/aiohttp/pull/7364. + if host.endswith(".."): + host = host.rstrip(".") + "." + port = req.port + assert port is not None + try: + # Cancelling this lookup should not cancel the underlying lookup + # or else the cancel event will get broadcast to all the waiters + # across all connections. + hosts = await self._resolve_host(host, port, traces=traces) + except OSError as exc: + if exc.errno is None and isinstance(exc, asyncio.TimeoutError): + raise + # in case of proxy it is not ClientProxyConnectionError + # it is problem of resolving proxy ip itself + raise ClientConnectorError(req.connection_key, exc) from exc + + last_exc: Optional[Exception] = None + addr_infos = self._convert_hosts_to_addr_infos(hosts) + while addr_infos: + # Strip trailing dots, certificates contain FQDN without dots. + # See https://github.com/aio-libs/aiohttp/issues/3636 + server_hostname = ( + (req.server_hostname or host).rstrip(".") if sslcontext else None + ) + + try: + transp, proto = await self._wrap_create_connection( + self._factory, + timeout=timeout, + ssl=sslcontext, + addr_infos=addr_infos, + server_hostname=server_hostname, + req=req, + client_error=client_error, + ) + except ClientConnectorError as exc: + last_exc = exc + aiohappyeyeballs.pop_addr_infos_interleave(addr_infos, self._interleave) + continue + + if req.is_ssl() and fingerprint: + try: + fingerprint.check(transp) + except ServerFingerprintMismatch as exc: + transp.close() + if not self._cleanup_closed_disabled: + self._cleanup_closed_transports.append(transp) + last_exc = exc + # Remove the bad peer from the list of addr_infos + sock: socket.socket = transp.get_extra_info("socket") + bad_peer = sock.getpeername() + aiohappyeyeballs.remove_addr_infos(addr_infos, bad_peer) + continue + + return transp, proto + else: + assert last_exc is not None + raise last_exc + + async def _create_proxy_connection( + self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout" + ) -> Tuple[asyncio.BaseTransport, ResponseHandler]: + self._fail_on_no_start_tls(req) + runtime_has_start_tls = self._loop_supports_start_tls() + + headers: Dict[str, str] = {} + if req.proxy_headers is not None: + headers = req.proxy_headers # type: ignore[assignment] + headers[hdrs.HOST] = req.headers[hdrs.HOST] + + url = req.proxy + assert url is not None + proxy_req = ClientRequest( + hdrs.METH_GET, + url, + headers=headers, + auth=req.proxy_auth, + loop=self._loop, + ssl=req.ssl, + ) + + # create connection to proxy server + transport, proto = await self._create_direct_connection( + proxy_req, [], timeout, client_error=ClientProxyConnectionError + ) + + # Many HTTP proxies has buggy keepalive support. Let's not + # reuse connection but close it after processing every + # response. + proto.force_close() + + auth = proxy_req.headers.pop(hdrs.AUTHORIZATION, None) + if auth is not None: + if not req.is_ssl(): + req.headers[hdrs.PROXY_AUTHORIZATION] = auth + else: + proxy_req.headers[hdrs.PROXY_AUTHORIZATION] = auth + + if req.is_ssl(): + if runtime_has_start_tls: + self._warn_about_tls_in_tls(transport, req) + + # For HTTPS requests over HTTP proxy + # we must notify proxy to tunnel connection + # so we send CONNECT command: + # CONNECT www.python.org:443 HTTP/1.1 + # Host: www.python.org + # + # next we must do TLS handshake and so on + # to do this we must wrap raw socket into secure one + # asyncio handles this perfectly + proxy_req.method = hdrs.METH_CONNECT + proxy_req.url = req.url + key = attr.evolve( + req.connection_key, proxy=None, proxy_auth=None, proxy_headers_hash=None + ) + conn = Connection(self, key, proto, self._loop) + proxy_resp = await proxy_req.send(conn) + try: + protocol = conn._protocol + assert protocol is not None + + # read_until_eof=True will ensure the connection isn't closed + # once the response is received and processed allowing + # START_TLS to work on the connection below. + protocol.set_response_params( + read_until_eof=runtime_has_start_tls, + timeout_ceil_threshold=self._timeout_ceil_threshold, + ) + resp = await proxy_resp.start(conn) + except BaseException: + proxy_resp.close() + conn.close() + raise + else: + conn._protocol = None + conn._transport = None + try: + if resp.status != 200: + message = resp.reason + if message is None: + message = HTTPStatus(resp.status).phrase + raise ClientHttpProxyError( + proxy_resp.request_info, + resp.history, + status=resp.status, + message=message, + headers=resp.headers, + ) + if not runtime_has_start_tls: + rawsock = transport.get_extra_info("socket", default=None) + if rawsock is None: + raise RuntimeError( + "Transport does not expose socket instance" + ) + # Duplicate the socket, so now we can close proxy transport + rawsock = rawsock.dup() + except BaseException: + # It shouldn't be closed in `finally` because it's fed to + # `loop.start_tls()` and the docs say not to touch it after + # passing there. + transport.close() + raise + finally: + if not runtime_has_start_tls: + transport.close() + + if not runtime_has_start_tls: + # HTTP proxy with support for upgrade to HTTPS + sslcontext = self._get_ssl_context(req) + return await self._wrap_existing_connection( + self._factory, + timeout=timeout, + ssl=sslcontext, + sock=rawsock, + server_hostname=req.host, + req=req, + ) + + return await self._start_tls_connection( + # Access the old transport for the last time before it's + # closed and forgotten forever: + transport, + req=req, + timeout=timeout, + ) + finally: + proxy_resp.close() + + return transport, proto + + +class UnixConnector(BaseConnector): + """Unix socket connector. + + path - Unix socket path. + keepalive_timeout - (optional) Keep-alive timeout. + force_close - Set to True to force close and do reconnect + after each request (and between redirects). + limit - The total number of simultaneous connections. + limit_per_host - Number of simultaneous connections to one host. + loop - Optional event loop. + """ + + allowed_protocol_schema_set = HIGH_LEVEL_SCHEMA_SET | frozenset({"unix"}) + + def __init__( + self, + path: str, + force_close: bool = False, + keepalive_timeout: Union[object, float, None] = sentinel, + limit: int = 100, + limit_per_host: int = 0, + loop: Optional[asyncio.AbstractEventLoop] = None, + ) -> None: + super().__init__( + force_close=force_close, + keepalive_timeout=keepalive_timeout, + limit=limit, + limit_per_host=limit_per_host, + loop=loop, + ) + self._path = path + + @property + def path(self) -> str: + """Path to unix socket.""" + return self._path + + async def _create_connection( + self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout" + ) -> ResponseHandler: + try: + async with ceil_timeout( + timeout.sock_connect, ceil_threshold=timeout.ceil_threshold + ): + _, proto = await self._loop.create_unix_connection( + self._factory, self._path + ) + except OSError as exc: + if exc.errno is None and isinstance(exc, asyncio.TimeoutError): + raise + raise UnixClientConnectorError(self.path, req.connection_key, exc) from exc + + return proto + + +class NamedPipeConnector(BaseConnector): + """Named pipe connector. + + Only supported by the proactor event loop. + See also: https://docs.python.org/3/library/asyncio-eventloop.html + + path - Windows named pipe path. + keepalive_timeout - (optional) Keep-alive timeout. + force_close - Set to True to force close and do reconnect + after each request (and between redirects). + limit - The total number of simultaneous connections. + limit_per_host - Number of simultaneous connections to one host. + loop - Optional event loop. + """ + + allowed_protocol_schema_set = HIGH_LEVEL_SCHEMA_SET | frozenset({"npipe"}) + + def __init__( + self, + path: str, + force_close: bool = False, + keepalive_timeout: Union[object, float, None] = sentinel, + limit: int = 100, + limit_per_host: int = 0, + loop: Optional[asyncio.AbstractEventLoop] = None, + ) -> None: + super().__init__( + force_close=force_close, + keepalive_timeout=keepalive_timeout, + limit=limit, + limit_per_host=limit_per_host, + loop=loop, + ) + if not isinstance( + self._loop, asyncio.ProactorEventLoop # type: ignore[attr-defined] + ): + raise RuntimeError( + "Named Pipes only available in proactor " "loop under windows" + ) + self._path = path + + @property + def path(self) -> str: + """Path to the named pipe.""" + return self._path + + async def _create_connection( + self, req: ClientRequest, traces: List["Trace"], timeout: "ClientTimeout" + ) -> ResponseHandler: + try: + async with ceil_timeout( + timeout.sock_connect, ceil_threshold=timeout.ceil_threshold + ): + _, proto = await self._loop.create_pipe_connection( # type: ignore[attr-defined] + self._factory, self._path + ) + # the drain is required so that the connection_made is called + # and transport is set otherwise it is not set before the + # `assert conn.transport is not None` + # in client.py's _request method + await asyncio.sleep(0) + # other option is to manually set transport like + # `proto.transport = trans` + except OSError as exc: + if exc.errno is None and isinstance(exc, asyncio.TimeoutError): + raise + raise ClientConnectorError(req.connection_key, exc) from exc + + return cast(ResponseHandler, proto) diff --git a/env/Lib/site-packages/aiohttp/cookiejar.py b/env/Lib/site-packages/aiohttp/cookiejar.py new file mode 100644 index 0000000..e9997ce --- /dev/null +++ b/env/Lib/site-packages/aiohttp/cookiejar.py @@ -0,0 +1,425 @@ +import asyncio +import calendar +import contextlib +import datetime +import itertools +import os # noqa +import pathlib +import pickle +import re +import time +from collections import defaultdict +from http.cookies import BaseCookie, Morsel, SimpleCookie +from math import ceil +from typing import ( + DefaultDict, + Dict, + Iterable, + Iterator, + List, + Mapping, + Optional, + Set, + Tuple, + Union, + cast, +) + +from yarl import URL + +from .abc import AbstractCookieJar, ClearCookiePredicate +from .helpers import is_ip_address +from .typedefs import LooseCookies, PathLike, StrOrURL + +__all__ = ("CookieJar", "DummyCookieJar") + + +CookieItem = Union[str, "Morsel[str]"] + +# We cache these string methods here as their use is in performance critical code. +_FORMAT_PATH = "{}/{}".format +_FORMAT_DOMAIN_REVERSED = "{1}.{0}".format + + +class CookieJar(AbstractCookieJar): + """Implements cookie storage adhering to RFC 6265.""" + + DATE_TOKENS_RE = re.compile( + r"[\x09\x20-\x2F\x3B-\x40\x5B-\x60\x7B-\x7E]*" + r"(?P[\x00-\x08\x0A-\x1F\d:a-zA-Z\x7F-\xFF]+)" + ) + + DATE_HMS_TIME_RE = re.compile(r"(\d{1,2}):(\d{1,2}):(\d{1,2})") + + DATE_DAY_OF_MONTH_RE = re.compile(r"(\d{1,2})") + + DATE_MONTH_RE = re.compile( + "(jan)|(feb)|(mar)|(apr)|(may)|(jun)|(jul)|" "(aug)|(sep)|(oct)|(nov)|(dec)", + re.I, + ) + + DATE_YEAR_RE = re.compile(r"(\d{2,4})") + + # calendar.timegm() fails for timestamps after datetime.datetime.max + # Minus one as a loss of precision occurs when timestamp() is called. + MAX_TIME = ( + int(datetime.datetime.max.replace(tzinfo=datetime.timezone.utc).timestamp()) - 1 + ) + try: + calendar.timegm(time.gmtime(MAX_TIME)) + except (OSError, ValueError): + # Hit the maximum representable time on Windows + # https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/localtime-localtime32-localtime64 + # Throws ValueError on PyPy 3.8 and 3.9, OSError elsewhere + MAX_TIME = calendar.timegm((3000, 12, 31, 23, 59, 59, -1, -1, -1)) + except OverflowError: + # #4515: datetime.max may not be representable on 32-bit platforms + MAX_TIME = 2**31 - 1 + # Avoid minuses in the future, 3x faster + SUB_MAX_TIME = MAX_TIME - 1 + + def __init__( + self, + *, + unsafe: bool = False, + quote_cookie: bool = True, + treat_as_secure_origin: Union[StrOrURL, List[StrOrURL], None] = None, + loop: Optional[asyncio.AbstractEventLoop] = None, + ) -> None: + super().__init__(loop=loop) + self._cookies: DefaultDict[Tuple[str, str], SimpleCookie] = defaultdict( + SimpleCookie + ) + self._host_only_cookies: Set[Tuple[str, str]] = set() + self._unsafe = unsafe + self._quote_cookie = quote_cookie + if treat_as_secure_origin is None: + treat_as_secure_origin = [] + elif isinstance(treat_as_secure_origin, URL): + treat_as_secure_origin = [treat_as_secure_origin.origin()] + elif isinstance(treat_as_secure_origin, str): + treat_as_secure_origin = [URL(treat_as_secure_origin).origin()] + else: + treat_as_secure_origin = [ + URL(url).origin() if isinstance(url, str) else url.origin() + for url in treat_as_secure_origin + ] + self._treat_as_secure_origin = treat_as_secure_origin + self._next_expiration: float = ceil(time.time()) + self._expirations: Dict[Tuple[str, str, str], float] = {} + + def save(self, file_path: PathLike) -> None: + file_path = pathlib.Path(file_path) + with file_path.open(mode="wb") as f: + pickle.dump(self._cookies, f, pickle.HIGHEST_PROTOCOL) + + def load(self, file_path: PathLike) -> None: + file_path = pathlib.Path(file_path) + with file_path.open(mode="rb") as f: + self._cookies = pickle.load(f) + + def clear(self, predicate: Optional[ClearCookiePredicate] = None) -> None: + if predicate is None: + self._next_expiration = ceil(time.time()) + self._cookies.clear() + self._host_only_cookies.clear() + self._expirations.clear() + return + + to_del = [] + now = time.time() + for (domain, path), cookie in self._cookies.items(): + for name, morsel in cookie.items(): + key = (domain, path, name) + if ( + key in self._expirations and self._expirations[key] <= now + ) or predicate(morsel): + to_del.append(key) + + for domain, path, name in to_del: + self._host_only_cookies.discard((domain, name)) + key = (domain, path, name) + if key in self._expirations: + del self._expirations[(domain, path, name)] + self._cookies[(domain, path)].pop(name, None) + + self._next_expiration = ( + min(*self._expirations.values(), self.SUB_MAX_TIME) + 1 + if self._expirations + else self.MAX_TIME + ) + + def clear_domain(self, domain: str) -> None: + self.clear(lambda x: self._is_domain_match(domain, x["domain"])) + + def __iter__(self) -> "Iterator[Morsel[str]]": + self._do_expiration() + for val in self._cookies.values(): + yield from val.values() + + def __len__(self) -> int: + """Return number of cookies. + + This function does not iterate self to avoid unnecessary expiration + checks. + """ + return sum(len(cookie.values()) for cookie in self._cookies.values()) + + def _do_expiration(self) -> None: + self.clear(lambda x: False) + + def _expire_cookie(self, when: float, domain: str, path: str, name: str) -> None: + self._next_expiration = min(self._next_expiration, when) + self._expirations[(domain, path, name)] = when + + def update_cookies(self, cookies: LooseCookies, response_url: URL = URL()) -> None: + """Update cookies.""" + hostname = response_url.raw_host + + if not self._unsafe and is_ip_address(hostname): + # Don't accept cookies from IPs + return + + if isinstance(cookies, Mapping): + cookies = cookies.items() + + for name, cookie in cookies: + if not isinstance(cookie, Morsel): + tmp = SimpleCookie() + tmp[name] = cookie # type: ignore[assignment] + cookie = tmp[name] + + domain = cookie["domain"] + + # ignore domains with trailing dots + if domain.endswith("."): + domain = "" + del cookie["domain"] + + if not domain and hostname is not None: + # Set the cookie's domain to the response hostname + # and set its host-only-flag + self._host_only_cookies.add((hostname, name)) + domain = cookie["domain"] = hostname + + if domain.startswith("."): + # Remove leading dot + domain = domain[1:] + cookie["domain"] = domain + + if hostname and not self._is_domain_match(domain, hostname): + # Setting cookies for different domains is not allowed + continue + + path = cookie["path"] + if not path or not path.startswith("/"): + # Set the cookie's path to the response path + path = response_url.path + if not path.startswith("/"): + path = "/" + else: + # Cut everything from the last slash to the end + path = "/" + path[1 : path.rfind("/")] + cookie["path"] = path + path = path.rstrip("/") + + max_age = cookie["max-age"] + if max_age: + try: + delta_seconds = int(max_age) + max_age_expiration = min(time.time() + delta_seconds, self.MAX_TIME) + self._expire_cookie(max_age_expiration, domain, path, name) + except ValueError: + cookie["max-age"] = "" + + else: + expires = cookie["expires"] + if expires: + expire_time = self._parse_date(expires) + if expire_time: + self._expire_cookie(expire_time, domain, path, name) + else: + cookie["expires"] = "" + + self._cookies[(domain, path)][name] = cookie + + self._do_expiration() + + def filter_cookies(self, request_url: URL = URL()) -> "BaseCookie[str]": + """Returns this jar's cookies filtered by their attributes.""" + filtered: Union[SimpleCookie, "BaseCookie[str]"] = ( + SimpleCookie() if self._quote_cookie else BaseCookie() + ) + if not self._cookies: + # Skip do_expiration() if there are no cookies. + return filtered + self._do_expiration() + if not self._cookies: + # Skip rest of function if no non-expired cookies. + return filtered + request_url = URL(request_url) + hostname = request_url.raw_host or "" + + is_not_secure = request_url.scheme not in ("https", "wss") + if is_not_secure and self._treat_as_secure_origin: + request_origin = URL() + with contextlib.suppress(ValueError): + request_origin = request_url.origin() + is_not_secure = request_origin not in self._treat_as_secure_origin + + # Send shared cookie + for c in self._cookies[("", "")].values(): + filtered[c.key] = c.value + + if is_ip_address(hostname): + if not self._unsafe: + return filtered + domains: Iterable[str] = (hostname,) + else: + # Get all the subdomains that might match a cookie (e.g. "foo.bar.com", "bar.com", "com") + domains = itertools.accumulate( + reversed(hostname.split(".")), _FORMAT_DOMAIN_REVERSED + ) + + # Get all the path prefixes that might match a cookie (e.g. "", "/foo", "/foo/bar") + paths = itertools.accumulate(request_url.path.split("/"), _FORMAT_PATH) + # Create every combination of (domain, path) pairs. + pairs = itertools.product(domains, paths) + + # Point 2: https://www.rfc-editor.org/rfc/rfc6265.html#section-5.4 + cookies = itertools.chain.from_iterable( + self._cookies[p].values() for p in pairs + ) + path_len = len(request_url.path) + for cookie in cookies: + name = cookie.key + domain = cookie["domain"] + + if (domain, name) in self._host_only_cookies: + if domain != hostname: + continue + + # Skip edge case when the cookie has a trailing slash but request doesn't. + if len(cookie["path"]) > path_len: + continue + + if is_not_secure and cookie["secure"]: + continue + + # It's critical we use the Morsel so the coded_value + # (based on cookie version) is preserved + mrsl_val = cast("Morsel[str]", cookie.get(cookie.key, Morsel())) + mrsl_val.set(cookie.key, cookie.value, cookie.coded_value) + filtered[name] = mrsl_val + + return filtered + + @staticmethod + def _is_domain_match(domain: str, hostname: str) -> bool: + """Implements domain matching adhering to RFC 6265.""" + if hostname == domain: + return True + + if not hostname.endswith(domain): + return False + + non_matching = hostname[: -len(domain)] + + if not non_matching.endswith("."): + return False + + return not is_ip_address(hostname) + + @classmethod + def _parse_date(cls, date_str: str) -> Optional[int]: + """Implements date string parsing adhering to RFC 6265.""" + if not date_str: + return None + + found_time = False + found_day = False + found_month = False + found_year = False + + hour = minute = second = 0 + day = 0 + month = 0 + year = 0 + + for token_match in cls.DATE_TOKENS_RE.finditer(date_str): + + token = token_match.group("token") + + if not found_time: + time_match = cls.DATE_HMS_TIME_RE.match(token) + if time_match: + found_time = True + hour, minute, second = (int(s) for s in time_match.groups()) + continue + + if not found_day: + day_match = cls.DATE_DAY_OF_MONTH_RE.match(token) + if day_match: + found_day = True + day = int(day_match.group()) + continue + + if not found_month: + month_match = cls.DATE_MONTH_RE.match(token) + if month_match: + found_month = True + assert month_match.lastindex is not None + month = month_match.lastindex + continue + + if not found_year: + year_match = cls.DATE_YEAR_RE.match(token) + if year_match: + found_year = True + year = int(year_match.group()) + + if 70 <= year <= 99: + year += 1900 + elif 0 <= year <= 69: + year += 2000 + + if False in (found_day, found_month, found_year, found_time): + return None + + if not 1 <= day <= 31: + return None + + if year < 1601 or hour > 23 or minute > 59 or second > 59: + return None + + return calendar.timegm((year, month, day, hour, minute, second, -1, -1, -1)) + + +class DummyCookieJar(AbstractCookieJar): + """Implements a dummy cookie storage. + + It can be used with the ClientSession when no cookie processing is needed. + + """ + + def __init__(self, *, loop: Optional[asyncio.AbstractEventLoop] = None) -> None: + super().__init__(loop=loop) + + def __iter__(self) -> "Iterator[Morsel[str]]": + while False: + yield None + + def __len__(self) -> int: + return 0 + + def clear(self, predicate: Optional[ClearCookiePredicate] = None) -> None: + pass + + def clear_domain(self, domain: str) -> None: + pass + + def update_cookies(self, cookies: LooseCookies, response_url: URL = URL()) -> None: + pass + + def filter_cookies(self, request_url: URL) -> "BaseCookie[str]": + return SimpleCookie() diff --git a/env/Lib/site-packages/aiohttp/formdata.py b/env/Lib/site-packages/aiohttp/formdata.py new file mode 100644 index 0000000..2b75b3d --- /dev/null +++ b/env/Lib/site-packages/aiohttp/formdata.py @@ -0,0 +1,182 @@ +import io +import warnings +from typing import Any, Iterable, List, Optional +from urllib.parse import urlencode + +from multidict import MultiDict, MultiDictProxy + +from . import hdrs, multipart, payload +from .helpers import guess_filename +from .payload import Payload + +__all__ = ("FormData",) + + +class FormData: + """Helper class for form body generation. + + Supports multipart/form-data and application/x-www-form-urlencoded. + """ + + def __init__( + self, + fields: Iterable[Any] = (), + quote_fields: bool = True, + charset: Optional[str] = None, + ) -> None: + self._writer = multipart.MultipartWriter("form-data") + self._fields: List[Any] = [] + self._is_multipart = False + self._is_processed = False + self._quote_fields = quote_fields + self._charset = charset + + if isinstance(fields, dict): + fields = list(fields.items()) + elif not isinstance(fields, (list, tuple)): + fields = (fields,) + self.add_fields(*fields) + + @property + def is_multipart(self) -> bool: + return self._is_multipart + + def add_field( + self, + name: str, + value: Any, + *, + content_type: Optional[str] = None, + filename: Optional[str] = None, + content_transfer_encoding: Optional[str] = None, + ) -> None: + + if isinstance(value, io.IOBase): + self._is_multipart = True + elif isinstance(value, (bytes, bytearray, memoryview)): + msg = ( + "In v4, passing bytes will no longer create a file field. " + "Please explicitly use the filename parameter or pass a BytesIO object." + ) + if filename is None and content_transfer_encoding is None: + warnings.warn(msg, DeprecationWarning) + filename = name + + type_options: MultiDict[str] = MultiDict({"name": name}) + if filename is not None and not isinstance(filename, str): + raise TypeError( + "filename must be an instance of str. " "Got: %s" % filename + ) + if filename is None and isinstance(value, io.IOBase): + filename = guess_filename(value, name) + if filename is not None: + type_options["filename"] = filename + self._is_multipart = True + + headers = {} + if content_type is not None: + if not isinstance(content_type, str): + raise TypeError( + "content_type must be an instance of str. " "Got: %s" % content_type + ) + headers[hdrs.CONTENT_TYPE] = content_type + self._is_multipart = True + if content_transfer_encoding is not None: + if not isinstance(content_transfer_encoding, str): + raise TypeError( + "content_transfer_encoding must be an instance" + " of str. Got: %s" % content_transfer_encoding + ) + msg = ( + "content_transfer_encoding is deprecated. " + "To maintain compatibility with v4 please pass a BytesPayload." + ) + warnings.warn(msg, DeprecationWarning) + self._is_multipart = True + + self._fields.append((type_options, headers, value)) + + def add_fields(self, *fields: Any) -> None: + to_add = list(fields) + + while to_add: + rec = to_add.pop(0) + + if isinstance(rec, io.IOBase): + k = guess_filename(rec, "unknown") + self.add_field(k, rec) # type: ignore[arg-type] + + elif isinstance(rec, (MultiDictProxy, MultiDict)): + to_add.extend(rec.items()) + + elif isinstance(rec, (list, tuple)) and len(rec) == 2: + k, fp = rec + self.add_field(k, fp) # type: ignore[arg-type] + + else: + raise TypeError( + "Only io.IOBase, multidict and (name, file) " + "pairs allowed, use .add_field() for passing " + "more complex parameters, got {!r}".format(rec) + ) + + def _gen_form_urlencoded(self) -> payload.BytesPayload: + # form data (x-www-form-urlencoded) + data = [] + for type_options, _, value in self._fields: + data.append((type_options["name"], value)) + + charset = self._charset if self._charset is not None else "utf-8" + + if charset == "utf-8": + content_type = "application/x-www-form-urlencoded" + else: + content_type = "application/x-www-form-urlencoded; " "charset=%s" % charset + + return payload.BytesPayload( + urlencode(data, doseq=True, encoding=charset).encode(), + content_type=content_type, + ) + + def _gen_form_data(self) -> multipart.MultipartWriter: + """Encode a list of fields using the multipart/form-data MIME format""" + if self._is_processed: + raise RuntimeError("Form data has been processed already") + for dispparams, headers, value in self._fields: + try: + if hdrs.CONTENT_TYPE in headers: + part = payload.get_payload( + value, + content_type=headers[hdrs.CONTENT_TYPE], + headers=headers, + encoding=self._charset, + ) + else: + part = payload.get_payload( + value, headers=headers, encoding=self._charset + ) + except Exception as exc: + raise TypeError( + "Can not serialize value type: %r\n " + "headers: %r\n value: %r" % (type(value), headers, value) + ) from exc + + if dispparams: + part.set_content_disposition( + "form-data", quote_fields=self._quote_fields, **dispparams + ) + # FIXME cgi.FieldStorage doesn't likes body parts with + # Content-Length which were sent via chunked transfer encoding + assert part.headers is not None + part.headers.popall(hdrs.CONTENT_LENGTH, None) + + self._writer.append_payload(part) + + self._is_processed = True + return self._writer + + def __call__(self) -> Payload: + if self._is_multipart: + return self._gen_form_data() + else: + return self._gen_form_urlencoded() diff --git a/env/Lib/site-packages/aiohttp/hdrs.py b/env/Lib/site-packages/aiohttp/hdrs.py new file mode 100644 index 0000000..2f1f5e0 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/hdrs.py @@ -0,0 +1,108 @@ +"""HTTP Headers constants.""" + +# After changing the file content call ./tools/gen.py +# to regenerate the headers parser +from typing import Final, Set + +from multidict import istr + +METH_ANY: Final[str] = "*" +METH_CONNECT: Final[str] = "CONNECT" +METH_HEAD: Final[str] = "HEAD" +METH_GET: Final[str] = "GET" +METH_DELETE: Final[str] = "DELETE" +METH_OPTIONS: Final[str] = "OPTIONS" +METH_PATCH: Final[str] = "PATCH" +METH_POST: Final[str] = "POST" +METH_PUT: Final[str] = "PUT" +METH_TRACE: Final[str] = "TRACE" + +METH_ALL: Final[Set[str]] = { + METH_CONNECT, + METH_HEAD, + METH_GET, + METH_DELETE, + METH_OPTIONS, + METH_PATCH, + METH_POST, + METH_PUT, + METH_TRACE, +} + +ACCEPT: Final[istr] = istr("Accept") +ACCEPT_CHARSET: Final[istr] = istr("Accept-Charset") +ACCEPT_ENCODING: Final[istr] = istr("Accept-Encoding") +ACCEPT_LANGUAGE: Final[istr] = istr("Accept-Language") +ACCEPT_RANGES: Final[istr] = istr("Accept-Ranges") +ACCESS_CONTROL_MAX_AGE: Final[istr] = istr("Access-Control-Max-Age") +ACCESS_CONTROL_ALLOW_CREDENTIALS: Final[istr] = istr("Access-Control-Allow-Credentials") +ACCESS_CONTROL_ALLOW_HEADERS: Final[istr] = istr("Access-Control-Allow-Headers") +ACCESS_CONTROL_ALLOW_METHODS: Final[istr] = istr("Access-Control-Allow-Methods") +ACCESS_CONTROL_ALLOW_ORIGIN: Final[istr] = istr("Access-Control-Allow-Origin") +ACCESS_CONTROL_EXPOSE_HEADERS: Final[istr] = istr("Access-Control-Expose-Headers") +ACCESS_CONTROL_REQUEST_HEADERS: Final[istr] = istr("Access-Control-Request-Headers") +ACCESS_CONTROL_REQUEST_METHOD: Final[istr] = istr("Access-Control-Request-Method") +AGE: Final[istr] = istr("Age") +ALLOW: Final[istr] = istr("Allow") +AUTHORIZATION: Final[istr] = istr("Authorization") +CACHE_CONTROL: Final[istr] = istr("Cache-Control") +CONNECTION: Final[istr] = istr("Connection") +CONTENT_DISPOSITION: Final[istr] = istr("Content-Disposition") +CONTENT_ENCODING: Final[istr] = istr("Content-Encoding") +CONTENT_LANGUAGE: Final[istr] = istr("Content-Language") +CONTENT_LENGTH: Final[istr] = istr("Content-Length") +CONTENT_LOCATION: Final[istr] = istr("Content-Location") +CONTENT_MD5: Final[istr] = istr("Content-MD5") +CONTENT_RANGE: Final[istr] = istr("Content-Range") +CONTENT_TRANSFER_ENCODING: Final[istr] = istr("Content-Transfer-Encoding") +CONTENT_TYPE: Final[istr] = istr("Content-Type") +COOKIE: Final[istr] = istr("Cookie") +DATE: Final[istr] = istr("Date") +DESTINATION: Final[istr] = istr("Destination") +DIGEST: Final[istr] = istr("Digest") +ETAG: Final[istr] = istr("Etag") +EXPECT: Final[istr] = istr("Expect") +EXPIRES: Final[istr] = istr("Expires") +FORWARDED: Final[istr] = istr("Forwarded") +FROM: Final[istr] = istr("From") +HOST: Final[istr] = istr("Host") +IF_MATCH: Final[istr] = istr("If-Match") +IF_MODIFIED_SINCE: Final[istr] = istr("If-Modified-Since") +IF_NONE_MATCH: Final[istr] = istr("If-None-Match") +IF_RANGE: Final[istr] = istr("If-Range") +IF_UNMODIFIED_SINCE: Final[istr] = istr("If-Unmodified-Since") +KEEP_ALIVE: Final[istr] = istr("Keep-Alive") +LAST_EVENT_ID: Final[istr] = istr("Last-Event-ID") +LAST_MODIFIED: Final[istr] = istr("Last-Modified") +LINK: Final[istr] = istr("Link") +LOCATION: Final[istr] = istr("Location") +MAX_FORWARDS: Final[istr] = istr("Max-Forwards") +ORIGIN: Final[istr] = istr("Origin") +PRAGMA: Final[istr] = istr("Pragma") +PROXY_AUTHENTICATE: Final[istr] = istr("Proxy-Authenticate") +PROXY_AUTHORIZATION: Final[istr] = istr("Proxy-Authorization") +RANGE: Final[istr] = istr("Range") +REFERER: Final[istr] = istr("Referer") +RETRY_AFTER: Final[istr] = istr("Retry-After") +SEC_WEBSOCKET_ACCEPT: Final[istr] = istr("Sec-WebSocket-Accept") +SEC_WEBSOCKET_VERSION: Final[istr] = istr("Sec-WebSocket-Version") +SEC_WEBSOCKET_PROTOCOL: Final[istr] = istr("Sec-WebSocket-Protocol") +SEC_WEBSOCKET_EXTENSIONS: Final[istr] = istr("Sec-WebSocket-Extensions") +SEC_WEBSOCKET_KEY: Final[istr] = istr("Sec-WebSocket-Key") +SEC_WEBSOCKET_KEY1: Final[istr] = istr("Sec-WebSocket-Key1") +SERVER: Final[istr] = istr("Server") +SET_COOKIE: Final[istr] = istr("Set-Cookie") +TE: Final[istr] = istr("TE") +TRAILER: Final[istr] = istr("Trailer") +TRANSFER_ENCODING: Final[istr] = istr("Transfer-Encoding") +UPGRADE: Final[istr] = istr("Upgrade") +URI: Final[istr] = istr("URI") +USER_AGENT: Final[istr] = istr("User-Agent") +VARY: Final[istr] = istr("Vary") +VIA: Final[istr] = istr("Via") +WANT_DIGEST: Final[istr] = istr("Want-Digest") +WARNING: Final[istr] = istr("Warning") +WWW_AUTHENTICATE: Final[istr] = istr("WWW-Authenticate") +X_FORWARDED_FOR: Final[istr] = istr("X-Forwarded-For") +X_FORWARDED_HOST: Final[istr] = istr("X-Forwarded-Host") +X_FORWARDED_PROTO: Final[istr] = istr("X-Forwarded-Proto") diff --git a/env/Lib/site-packages/aiohttp/helpers.py b/env/Lib/site-packages/aiohttp/helpers.py new file mode 100644 index 0000000..ccfa9d5 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/helpers.py @@ -0,0 +1,1001 @@ +"""Various helper functions""" + +import asyncio +import base64 +import binascii +import contextlib +import datetime +import enum +import functools +import inspect +import netrc +import os +import platform +import re +import sys +import time +import weakref +from collections import namedtuple +from contextlib import suppress +from email.parser import HeaderParser +from email.utils import parsedate +from math import ceil +from pathlib import Path +from types import TracebackType +from typing import ( + Any, + Callable, + ContextManager, + Dict, + Generator, + Generic, + Iterable, + Iterator, + List, + Mapping, + Optional, + Pattern, + Protocol, + Tuple, + Type, + TypeVar, + Union, + get_args, + overload, +) +from urllib.parse import quote +from urllib.request import getproxies, proxy_bypass + +import attr +from multidict import MultiDict, MultiDictProxy, MultiMapping +from yarl import URL + +from . import hdrs +from .log import client_logger + +if sys.version_info >= (3, 11): + import asyncio as async_timeout +else: + import async_timeout + +__all__ = ("BasicAuth", "ChainMapProxy", "ETag") + +IS_MACOS = platform.system() == "Darwin" +IS_WINDOWS = platform.system() == "Windows" + +PY_310 = sys.version_info >= (3, 10) +PY_311 = sys.version_info >= (3, 11) + + +_T = TypeVar("_T") +_S = TypeVar("_S") + +_SENTINEL = enum.Enum("_SENTINEL", "sentinel") +sentinel = _SENTINEL.sentinel + +NO_EXTENSIONS = bool(os.environ.get("AIOHTTP_NO_EXTENSIONS")) + +DEBUG = sys.flags.dev_mode or ( + not sys.flags.ignore_environment and bool(os.environ.get("PYTHONASYNCIODEBUG")) +) + + +CHAR = {chr(i) for i in range(0, 128)} +CTL = {chr(i) for i in range(0, 32)} | { + chr(127), +} +SEPARATORS = { + "(", + ")", + "<", + ">", + "@", + ",", + ";", + ":", + "\\", + '"', + "/", + "[", + "]", + "?", + "=", + "{", + "}", + " ", + chr(9), +} +TOKEN = CHAR ^ CTL ^ SEPARATORS + + +class noop: + def __await__(self) -> Generator[None, None, None]: + yield + + +class BasicAuth(namedtuple("BasicAuth", ["login", "password", "encoding"])): + """Http basic authentication helper.""" + + def __new__( + cls, login: str, password: str = "", encoding: str = "latin1" + ) -> "BasicAuth": + if login is None: + raise ValueError("None is not allowed as login value") + + if password is None: + raise ValueError("None is not allowed as password value") + + if ":" in login: + raise ValueError('A ":" is not allowed in login (RFC 1945#section-11.1)') + + return super().__new__(cls, login, password, encoding) + + @classmethod + def decode(cls, auth_header: str, encoding: str = "latin1") -> "BasicAuth": + """Create a BasicAuth object from an Authorization HTTP header.""" + try: + auth_type, encoded_credentials = auth_header.split(" ", 1) + except ValueError: + raise ValueError("Could not parse authorization header.") + + if auth_type.lower() != "basic": + raise ValueError("Unknown authorization method %s" % auth_type) + + try: + decoded = base64.b64decode( + encoded_credentials.encode("ascii"), validate=True + ).decode(encoding) + except binascii.Error: + raise ValueError("Invalid base64 encoding.") + + try: + # RFC 2617 HTTP Authentication + # https://www.ietf.org/rfc/rfc2617.txt + # the colon must be present, but the username and password may be + # otherwise blank. + username, password = decoded.split(":", 1) + except ValueError: + raise ValueError("Invalid credentials.") + + return cls(username, password, encoding=encoding) + + @classmethod + def from_url(cls, url: URL, *, encoding: str = "latin1") -> Optional["BasicAuth"]: + """Create BasicAuth from url.""" + if not isinstance(url, URL): + raise TypeError("url should be yarl.URL instance") + if url.user is None: + return None + return cls(url.user, url.password or "", encoding=encoding) + + def encode(self) -> str: + """Encode credentials.""" + creds = (f"{self.login}:{self.password}").encode(self.encoding) + return "Basic %s" % base64.b64encode(creds).decode(self.encoding) + + +def strip_auth_from_url(url: URL) -> Tuple[URL, Optional[BasicAuth]]: + auth = BasicAuth.from_url(url) + if auth is None: + return url, None + else: + return url.with_user(None), auth + + +def netrc_from_env() -> Optional[netrc.netrc]: + """Load netrc from file. + + Attempt to load it from the path specified by the env-var + NETRC or in the default location in the user's home directory. + + Returns None if it couldn't be found or fails to parse. + """ + netrc_env = os.environ.get("NETRC") + + if netrc_env is not None: + netrc_path = Path(netrc_env) + else: + try: + home_dir = Path.home() + except RuntimeError as e: # pragma: no cover + # if pathlib can't resolve home, it may raise a RuntimeError + client_logger.debug( + "Could not resolve home directory when " + "trying to look for .netrc file: %s", + e, + ) + return None + + netrc_path = home_dir / ("_netrc" if IS_WINDOWS else ".netrc") + + try: + return netrc.netrc(str(netrc_path)) + except netrc.NetrcParseError as e: + client_logger.warning("Could not parse .netrc file: %s", e) + except OSError as e: + netrc_exists = False + with contextlib.suppress(OSError): + netrc_exists = netrc_path.is_file() + # we couldn't read the file (doesn't exist, permissions, etc.) + if netrc_env or netrc_exists: + # only warn if the environment wanted us to load it, + # or it appears like the default file does actually exist + client_logger.warning("Could not read .netrc file: %s", e) + + return None + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class ProxyInfo: + proxy: URL + proxy_auth: Optional[BasicAuth] + + +def basicauth_from_netrc(netrc_obj: Optional[netrc.netrc], host: str) -> BasicAuth: + """ + Return :py:class:`~aiohttp.BasicAuth` credentials for ``host`` from ``netrc_obj``. + + :raises LookupError: if ``netrc_obj`` is :py:data:`None` or if no + entry is found for the ``host``. + """ + if netrc_obj is None: + raise LookupError("No .netrc file found") + auth_from_netrc = netrc_obj.authenticators(host) + + if auth_from_netrc is None: + raise LookupError(f"No entry for {host!s} found in the `.netrc` file.") + login, account, password = auth_from_netrc + + # TODO(PY311): username = login or account + # Up to python 3.10, account could be None if not specified, + # and login will be empty string if not specified. From 3.11, + # login and account will be empty string if not specified. + username = login if (login or account is None) else account + + # TODO(PY311): Remove this, as password will be empty string + # if not specified + if password is None: + password = "" + + return BasicAuth(username, password) + + +def proxies_from_env() -> Dict[str, ProxyInfo]: + proxy_urls = { + k: URL(v) + for k, v in getproxies().items() + if k in ("http", "https", "ws", "wss") + } + netrc_obj = netrc_from_env() + stripped = {k: strip_auth_from_url(v) for k, v in proxy_urls.items()} + ret = {} + for proto, val in stripped.items(): + proxy, auth = val + if proxy.scheme in ("https", "wss"): + client_logger.warning( + "%s proxies %s are not supported, ignoring", proxy.scheme.upper(), proxy + ) + continue + if netrc_obj and auth is None: + if proxy.host is not None: + try: + auth = basicauth_from_netrc(netrc_obj, proxy.host) + except LookupError: + auth = None + ret[proto] = ProxyInfo(proxy, auth) + return ret + + +def get_env_proxy_for_url(url: URL) -> Tuple[URL, Optional[BasicAuth]]: + """Get a permitted proxy for the given URL from the env.""" + if url.host is not None and proxy_bypass(url.host): + raise LookupError(f"Proxying is disallowed for `{url.host!r}`") + + proxies_in_env = proxies_from_env() + try: + proxy_info = proxies_in_env[url.scheme] + except KeyError: + raise LookupError(f"No proxies found for `{url!s}` in the env") + else: + return proxy_info.proxy, proxy_info.proxy_auth + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class MimeType: + type: str + subtype: str + suffix: str + parameters: "MultiDictProxy[str]" + + +@functools.lru_cache(maxsize=56) +def parse_mimetype(mimetype: str) -> MimeType: + """Parses a MIME type into its components. + + mimetype is a MIME type string. + + Returns a MimeType object. + + Example: + + >>> parse_mimetype('text/html; charset=utf-8') + MimeType(type='text', subtype='html', suffix='', + parameters={'charset': 'utf-8'}) + + """ + if not mimetype: + return MimeType( + type="", subtype="", suffix="", parameters=MultiDictProxy(MultiDict()) + ) + + parts = mimetype.split(";") + params: MultiDict[str] = MultiDict() + for item in parts[1:]: + if not item: + continue + key, _, value = item.partition("=") + params.add(key.lower().strip(), value.strip(' "')) + + fulltype = parts[0].strip().lower() + if fulltype == "*": + fulltype = "*/*" + + mtype, _, stype = fulltype.partition("/") + stype, _, suffix = stype.partition("+") + + return MimeType( + type=mtype, subtype=stype, suffix=suffix, parameters=MultiDictProxy(params) + ) + + +def guess_filename(obj: Any, default: Optional[str] = None) -> Optional[str]: + name = getattr(obj, "name", None) + if name and isinstance(name, str) and name[0] != "<" and name[-1] != ">": + return Path(name).name + return default + + +not_qtext_re = re.compile(r"[^\041\043-\133\135-\176]") +QCONTENT = {chr(i) for i in range(0x20, 0x7F)} | {"\t"} + + +def quoted_string(content: str) -> str: + """Return 7-bit content as quoted-string. + + Format content into a quoted-string as defined in RFC5322 for + Internet Message Format. Notice that this is not the 8-bit HTTP + format, but the 7-bit email format. Content must be in usascii or + a ValueError is raised. + """ + if not (QCONTENT > set(content)): + raise ValueError(f"bad content for quoted-string {content!r}") + return not_qtext_re.sub(lambda x: "\\" + x.group(0), content) + + +def content_disposition_header( + disptype: str, quote_fields: bool = True, _charset: str = "utf-8", **params: str +) -> str: + """Sets ``Content-Disposition`` header for MIME. + + This is the MIME payload Content-Disposition header from RFC 2183 + and RFC 7579 section 4.2, not the HTTP Content-Disposition from + RFC 6266. + + disptype is a disposition type: inline, attachment, form-data. + Should be valid extension token (see RFC 2183) + + quote_fields performs value quoting to 7-bit MIME headers + according to RFC 7578. Set to quote_fields to False if recipient + can take 8-bit file names and field values. + + _charset specifies the charset to use when quote_fields is True. + + params is a dict with disposition params. + """ + if not disptype or not (TOKEN > set(disptype)): + raise ValueError("bad content disposition type {!r}" "".format(disptype)) + + value = disptype + if params: + lparams = [] + for key, val in params.items(): + if not key or not (TOKEN > set(key)): + raise ValueError( + "bad content disposition parameter" " {!r}={!r}".format(key, val) + ) + if quote_fields: + if key.lower() == "filename": + qval = quote(val, "", encoding=_charset) + lparams.append((key, '"%s"' % qval)) + else: + try: + qval = quoted_string(val) + except ValueError: + qval = "".join( + (_charset, "''", quote(val, "", encoding=_charset)) + ) + lparams.append((key + "*", qval)) + else: + lparams.append((key, '"%s"' % qval)) + else: + qval = val.replace("\\", "\\\\").replace('"', '\\"') + lparams.append((key, '"%s"' % qval)) + sparams = "; ".join("=".join(pair) for pair in lparams) + value = "; ".join((value, sparams)) + return value + + +class _TSelf(Protocol, Generic[_T]): + _cache: Dict[str, _T] + + +class reify(Generic[_T]): + """Use as a class method decorator. + + It operates almost exactly like + the Python `@property` decorator, but it puts the result of the + method it decorates into the instance dict after the first call, + effectively replacing the function it decorates with an instance + variable. It is, in Python parlance, a data descriptor. + """ + + def __init__(self, wrapped: Callable[..., _T]) -> None: + self.wrapped = wrapped + self.__doc__ = wrapped.__doc__ + self.name = wrapped.__name__ + + def __get__(self, inst: _TSelf[_T], owner: Optional[Type[Any]] = None) -> _T: + try: + try: + return inst._cache[self.name] + except KeyError: + val = self.wrapped(inst) + inst._cache[self.name] = val + return val + except AttributeError: + if inst is None: + return self + raise + + def __set__(self, inst: _TSelf[_T], value: _T) -> None: + raise AttributeError("reified property is read-only") + + +reify_py = reify + +try: + from ._helpers import reify as reify_c + + if not NO_EXTENSIONS: + reify = reify_c # type: ignore[misc,assignment] +except ImportError: + pass + +_ipv4_pattern = ( + r"^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}" + r"(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$" +) +_ipv6_pattern = ( + r"^(?:(?:(?:[A-F0-9]{1,4}:){6}|(?=(?:[A-F0-9]{0,4}:){0,6}" + r"(?:[0-9]{1,3}\.){3}[0-9]{1,3}$)(([0-9A-F]{1,4}:){0,5}|:)" + r"((:[0-9A-F]{1,4}){1,5}:|:)|::(?:[A-F0-9]{1,4}:){5})" + r"(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])\.){3}" + r"(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])|(?:[A-F0-9]{1,4}:){7}" + r"[A-F0-9]{1,4}|(?=(?:[A-F0-9]{0,4}:){0,7}[A-F0-9]{0,4}$)" + r"(([0-9A-F]{1,4}:){1,7}|:)((:[0-9A-F]{1,4}){1,7}|:)|(?:[A-F0-9]{1,4}:){7}" + r":|:(:[A-F0-9]{1,4}){7})$" +) +_ipv4_regex = re.compile(_ipv4_pattern) +_ipv6_regex = re.compile(_ipv6_pattern, flags=re.IGNORECASE) +_ipv4_regexb = re.compile(_ipv4_pattern.encode("ascii")) +_ipv6_regexb = re.compile(_ipv6_pattern.encode("ascii"), flags=re.IGNORECASE) + + +def _is_ip_address( + regex: Pattern[str], regexb: Pattern[bytes], host: Optional[Union[str, bytes]] +) -> bool: + if host is None: + return False + if isinstance(host, str): + return bool(regex.match(host)) + elif isinstance(host, (bytes, bytearray, memoryview)): + return bool(regexb.match(host)) + else: + raise TypeError(f"{host} [{type(host)}] is not a str or bytes") + + +is_ipv4_address = functools.partial(_is_ip_address, _ipv4_regex, _ipv4_regexb) +is_ipv6_address = functools.partial(_is_ip_address, _ipv6_regex, _ipv6_regexb) + + +def is_ip_address(host: Optional[Union[str, bytes, bytearray, memoryview]]) -> bool: + return is_ipv4_address(host) or is_ipv6_address(host) + + +_cached_current_datetime: Optional[int] = None +_cached_formatted_datetime = "" + + +def rfc822_formatted_time() -> str: + global _cached_current_datetime + global _cached_formatted_datetime + + now = int(time.time()) + if now != _cached_current_datetime: + # Weekday and month names for HTTP date/time formatting; + # always English! + # Tuples are constants stored in codeobject! + _weekdayname = ("Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun") + _monthname = ( + "", # Dummy so we can use 1-based month numbers + "Jan", + "Feb", + "Mar", + "Apr", + "May", + "Jun", + "Jul", + "Aug", + "Sep", + "Oct", + "Nov", + "Dec", + ) + + year, month, day, hh, mm, ss, wd, *tail = time.gmtime(now) + _cached_formatted_datetime = "%s, %02d %3s %4d %02d:%02d:%02d GMT" % ( + _weekdayname[wd], + day, + _monthname[month], + year, + hh, + mm, + ss, + ) + _cached_current_datetime = now + return _cached_formatted_datetime + + +def _weakref_handle(info: "Tuple[weakref.ref[object], str]") -> None: + ref, name = info + ob = ref() + if ob is not None: + with suppress(Exception): + getattr(ob, name)() + + +def weakref_handle( + ob: object, + name: str, + timeout: float, + loop: asyncio.AbstractEventLoop, + timeout_ceil_threshold: float = 5, +) -> Optional[asyncio.TimerHandle]: + if timeout is not None and timeout > 0: + when = loop.time() + timeout + if timeout >= timeout_ceil_threshold: + when = ceil(when) + + return loop.call_at(when, _weakref_handle, (weakref.ref(ob), name)) + return None + + +def call_later( + cb: Callable[[], Any], + timeout: float, + loop: asyncio.AbstractEventLoop, + timeout_ceil_threshold: float = 5, +) -> Optional[asyncio.TimerHandle]: + if timeout is None or timeout <= 0: + return None + now = loop.time() + when = calculate_timeout_when(now, timeout, timeout_ceil_threshold) + return loop.call_at(when, cb) + + +def calculate_timeout_when( + loop_time: float, + timeout: float, + timeout_ceiling_threshold: float, +) -> float: + """Calculate when to execute a timeout.""" + when = loop_time + timeout + if timeout > timeout_ceiling_threshold: + return ceil(when) + return when + + +class TimeoutHandle: + """Timeout handle""" + + def __init__( + self, + loop: asyncio.AbstractEventLoop, + timeout: Optional[float], + ceil_threshold: float = 5, + ) -> None: + self._timeout = timeout + self._loop = loop + self._ceil_threshold = ceil_threshold + self._callbacks: List[ + Tuple[Callable[..., None], Tuple[Any, ...], Dict[str, Any]] + ] = [] + + def register( + self, callback: Callable[..., None], *args: Any, **kwargs: Any + ) -> None: + self._callbacks.append((callback, args, kwargs)) + + def close(self) -> None: + self._callbacks.clear() + + def start(self) -> Optional[asyncio.TimerHandle]: + timeout = self._timeout + if timeout is not None and timeout > 0: + when = self._loop.time() + timeout + if timeout >= self._ceil_threshold: + when = ceil(when) + return self._loop.call_at(when, self.__call__) + else: + return None + + def timer(self) -> "BaseTimerContext": + if self._timeout is not None and self._timeout > 0: + timer = TimerContext(self._loop) + self.register(timer.timeout) + return timer + else: + return TimerNoop() + + def __call__(self) -> None: + for cb, args, kwargs in self._callbacks: + with suppress(Exception): + cb(*args, **kwargs) + + self._callbacks.clear() + + +class BaseTimerContext(ContextManager["BaseTimerContext"]): + def assert_timeout(self) -> None: + """Raise TimeoutError if timeout has been exceeded.""" + + +class TimerNoop(BaseTimerContext): + def __enter__(self) -> BaseTimerContext: + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + return + + +class TimerContext(BaseTimerContext): + """Low resolution timeout context manager""" + + def __init__(self, loop: asyncio.AbstractEventLoop) -> None: + self._loop = loop + self._tasks: List[asyncio.Task[Any]] = [] + self._cancelled = False + + def assert_timeout(self) -> None: + """Raise TimeoutError if timer has already been cancelled.""" + if self._cancelled: + raise asyncio.TimeoutError from None + + def __enter__(self) -> BaseTimerContext: + task = asyncio.current_task(loop=self._loop) + + if task is None: + raise RuntimeError( + "Timeout context manager should be used " "inside a task" + ) + + if self._cancelled: + raise asyncio.TimeoutError from None + + self._tasks.append(task) + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> Optional[bool]: + if self._tasks: + self._tasks.pop() + + if exc_type is asyncio.CancelledError and self._cancelled: + raise asyncio.TimeoutError from None + return None + + def timeout(self) -> None: + if not self._cancelled: + for task in set(self._tasks): + task.cancel() + + self._cancelled = True + + +def ceil_timeout( + delay: Optional[float], ceil_threshold: float = 5 +) -> async_timeout.Timeout: + if delay is None or delay <= 0: + return async_timeout.timeout(None) + + loop = asyncio.get_running_loop() + now = loop.time() + when = now + delay + if delay > ceil_threshold: + when = ceil(when) + return async_timeout.timeout_at(when) + + +class HeadersMixin: + ATTRS = frozenset(["_content_type", "_content_dict", "_stored_content_type"]) + + _headers: MultiMapping[str] + + _content_type: Optional[str] = None + _content_dict: Optional[Dict[str, str]] = None + _stored_content_type: Union[str, None, _SENTINEL] = sentinel + + def _parse_content_type(self, raw: Optional[str]) -> None: + self._stored_content_type = raw + if raw is None: + # default value according to RFC 2616 + self._content_type = "application/octet-stream" + self._content_dict = {} + else: + msg = HeaderParser().parsestr("Content-Type: " + raw) + self._content_type = msg.get_content_type() + params = msg.get_params(()) + self._content_dict = dict(params[1:]) # First element is content type again + + @property + def content_type(self) -> str: + """The value of content part for Content-Type HTTP header.""" + raw = self._headers.get(hdrs.CONTENT_TYPE) + if self._stored_content_type != raw: + self._parse_content_type(raw) + return self._content_type # type: ignore[return-value] + + @property + def charset(self) -> Optional[str]: + """The value of charset part for Content-Type HTTP header.""" + raw = self._headers.get(hdrs.CONTENT_TYPE) + if self._stored_content_type != raw: + self._parse_content_type(raw) + return self._content_dict.get("charset") # type: ignore[union-attr] + + @property + def content_length(self) -> Optional[int]: + """The value of Content-Length HTTP header.""" + content_length = self._headers.get(hdrs.CONTENT_LENGTH) + + if content_length is not None: + return int(content_length) + else: + return None + + +def set_result(fut: "asyncio.Future[_T]", result: _T) -> None: + if not fut.done(): + fut.set_result(result) + + +_EXC_SENTINEL = BaseException() + + +class ErrorableProtocol(Protocol): + def set_exception( + self, + exc: BaseException, + exc_cause: BaseException = ..., + ) -> None: ... # pragma: no cover + + +def set_exception( + fut: "asyncio.Future[_T] | ErrorableProtocol", + exc: BaseException, + exc_cause: BaseException = _EXC_SENTINEL, +) -> None: + """Set future exception. + + If the future is marked as complete, this function is a no-op. + + :param exc_cause: An exception that is a direct cause of ``exc``. + Only set if provided. + """ + if asyncio.isfuture(fut) and fut.done(): + return + + exc_is_sentinel = exc_cause is _EXC_SENTINEL + exc_causes_itself = exc is exc_cause + if not exc_is_sentinel and not exc_causes_itself: + exc.__cause__ = exc_cause + + fut.set_exception(exc) + + +@functools.total_ordering +class AppKey(Generic[_T]): + """Keys for static typing support in Application.""" + + __slots__ = ("_name", "_t", "__orig_class__") + + # This may be set by Python when instantiating with a generic type. We need to + # support this, in order to support types that are not concrete classes, + # like Iterable, which can't be passed as the second parameter to __init__. + __orig_class__: Type[object] + + def __init__(self, name: str, t: Optional[Type[_T]] = None): + # Prefix with module name to help deduplicate key names. + frame = inspect.currentframe() + while frame: + if frame.f_code.co_name == "": + module: str = frame.f_globals["__name__"] + break + frame = frame.f_back + + self._name = module + "." + name + self._t = t + + def __lt__(self, other: object) -> bool: + if isinstance(other, AppKey): + return self._name < other._name + return True # Order AppKey above other types. + + def __repr__(self) -> str: + t = self._t + if t is None: + with suppress(AttributeError): + # Set to type arg. + t = get_args(self.__orig_class__)[0] + + if t is None: + t_repr = "<>" + elif isinstance(t, type): + if t.__module__ == "builtins": + t_repr = t.__qualname__ + else: + t_repr = f"{t.__module__}.{t.__qualname__}" + else: + t_repr = repr(t) + return f"" + + +class ChainMapProxy(Mapping[Union[str, AppKey[Any]], Any]): + __slots__ = ("_maps",) + + def __init__(self, maps: Iterable[Mapping[Union[str, AppKey[Any]], Any]]) -> None: + self._maps = tuple(maps) + + def __init_subclass__(cls) -> None: + raise TypeError( + "Inheritance class {} from ChainMapProxy " + "is forbidden".format(cls.__name__) + ) + + @overload # type: ignore[override] + def __getitem__(self, key: AppKey[_T]) -> _T: ... + + @overload + def __getitem__(self, key: str) -> Any: ... + + def __getitem__(self, key: Union[str, AppKey[_T]]) -> Any: + for mapping in self._maps: + try: + return mapping[key] + except KeyError: + pass + raise KeyError(key) + + @overload # type: ignore[override] + def get(self, key: AppKey[_T], default: _S) -> Union[_T, _S]: ... + + @overload + def get(self, key: AppKey[_T], default: None = ...) -> Optional[_T]: ... + + @overload + def get(self, key: str, default: Any = ...) -> Any: ... + + def get(self, key: Union[str, AppKey[_T]], default: Any = None) -> Any: + try: + return self[key] + except KeyError: + return default + + def __len__(self) -> int: + # reuses stored hash values if possible + return len(set().union(*self._maps)) + + def __iter__(self) -> Iterator[Union[str, AppKey[Any]]]: + d: Dict[Union[str, AppKey[Any]], Any] = {} + for mapping in reversed(self._maps): + # reuses stored hash values if possible + d.update(mapping) + return iter(d) + + def __contains__(self, key: object) -> bool: + return any(key in m for m in self._maps) + + def __bool__(self) -> bool: + return any(self._maps) + + def __repr__(self) -> str: + content = ", ".join(map(repr, self._maps)) + return f"ChainMapProxy({content})" + + +# https://tools.ietf.org/html/rfc7232#section-2.3 +_ETAGC = r"[!\x23-\x7E\x80-\xff]+" +_ETAGC_RE = re.compile(_ETAGC) +_QUOTED_ETAG = rf'(W/)?"({_ETAGC})"' +QUOTED_ETAG_RE = re.compile(_QUOTED_ETAG) +LIST_QUOTED_ETAG_RE = re.compile(rf"({_QUOTED_ETAG})(?:\s*,\s*|$)|(.)") + +ETAG_ANY = "*" + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class ETag: + value: str + is_weak: bool = False + + +def validate_etag_value(value: str) -> None: + if value != ETAG_ANY and not _ETAGC_RE.fullmatch(value): + raise ValueError( + f"Value {value!r} is not a valid etag. Maybe it contains '\"'?" + ) + + +def parse_http_date(date_str: Optional[str]) -> Optional[datetime.datetime]: + """Process a date string, return a datetime object""" + if date_str is not None: + timetuple = parsedate(date_str) + if timetuple is not None: + with suppress(ValueError): + return datetime.datetime(*timetuple[:6], tzinfo=datetime.timezone.utc) + return None + + +def must_be_empty_body(method: str, code: int) -> bool: + """Check if a request must return an empty body.""" + return ( + status_code_must_be_empty_body(code) + or method_must_be_empty_body(method) + or (200 <= code < 300 and method.upper() == hdrs.METH_CONNECT) + ) + + +def method_must_be_empty_body(method: str) -> bool: + """Check if a method must return an empty body.""" + # https://datatracker.ietf.org/doc/html/rfc9112#section-6.3-2.1 + # https://datatracker.ietf.org/doc/html/rfc9112#section-6.3-2.2 + return method.upper() == hdrs.METH_HEAD + + +def status_code_must_be_empty_body(code: int) -> bool: + """Check if a status code must return an empty body.""" + # https://datatracker.ietf.org/doc/html/rfc9112#section-6.3-2.1 + return code in {204, 304} or 100 <= code < 200 + + +def should_remove_content_length(method: str, code: int) -> bool: + """Check if a Content-Length header should be removed. + + This should always be a subset of must_be_empty_body + """ + # https://www.rfc-editor.org/rfc/rfc9110.html#section-8.6-8 + # https://www.rfc-editor.org/rfc/rfc9110.html#section-15.4.5-4 + return ( + code in {204, 304} + or 100 <= code < 200 + or (200 <= code < 300 and method.upper() == hdrs.METH_CONNECT) + ) diff --git a/env/Lib/site-packages/aiohttp/http.py b/env/Lib/site-packages/aiohttp/http.py new file mode 100644 index 0000000..a1feae2 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/http.py @@ -0,0 +1,72 @@ +import sys +from http import HTTPStatus +from typing import Mapping, Tuple + +from . import __version__ +from .http_exceptions import HttpProcessingError as HttpProcessingError +from .http_parser import ( + HeadersParser as HeadersParser, + HttpParser as HttpParser, + HttpRequestParser as HttpRequestParser, + HttpResponseParser as HttpResponseParser, + RawRequestMessage as RawRequestMessage, + RawResponseMessage as RawResponseMessage, +) +from .http_websocket import ( + WS_CLOSED_MESSAGE as WS_CLOSED_MESSAGE, + WS_CLOSING_MESSAGE as WS_CLOSING_MESSAGE, + WS_KEY as WS_KEY, + WebSocketError as WebSocketError, + WebSocketReader as WebSocketReader, + WebSocketWriter as WebSocketWriter, + WSCloseCode as WSCloseCode, + WSMessage as WSMessage, + WSMsgType as WSMsgType, + ws_ext_gen as ws_ext_gen, + ws_ext_parse as ws_ext_parse, +) +from .http_writer import ( + HttpVersion as HttpVersion, + HttpVersion10 as HttpVersion10, + HttpVersion11 as HttpVersion11, + StreamWriter as StreamWriter, +) + +__all__ = ( + "HttpProcessingError", + "RESPONSES", + "SERVER_SOFTWARE", + # .http_writer + "StreamWriter", + "HttpVersion", + "HttpVersion10", + "HttpVersion11", + # .http_parser + "HeadersParser", + "HttpParser", + "HttpRequestParser", + "HttpResponseParser", + "RawRequestMessage", + "RawResponseMessage", + # .http_websocket + "WS_CLOSED_MESSAGE", + "WS_CLOSING_MESSAGE", + "WS_KEY", + "WebSocketReader", + "WebSocketWriter", + "ws_ext_gen", + "ws_ext_parse", + "WSMessage", + "WebSocketError", + "WSMsgType", + "WSCloseCode", +) + + +SERVER_SOFTWARE: str = "Python/{0[0]}.{0[1]} aiohttp/{1}".format( + sys.version_info, __version__ +) + +RESPONSES: Mapping[int, Tuple[str, str]] = { + v: (v.phrase, v.description) for v in HTTPStatus.__members__.values() +} diff --git a/env/Lib/site-packages/aiohttp/http_exceptions.py b/env/Lib/site-packages/aiohttp/http_exceptions.py new file mode 100644 index 0000000..c43ee0d --- /dev/null +++ b/env/Lib/site-packages/aiohttp/http_exceptions.py @@ -0,0 +1,105 @@ +"""Low-level http related exceptions.""" + +from textwrap import indent +from typing import Optional, Union + +from .typedefs import _CIMultiDict + +__all__ = ("HttpProcessingError",) + + +class HttpProcessingError(Exception): + """HTTP error. + + Shortcut for raising HTTP errors with custom code, message and headers. + + code: HTTP Error code. + message: (optional) Error message. + headers: (optional) Headers to be sent in response, a list of pairs + """ + + code = 0 + message = "" + headers = None + + def __init__( + self, + *, + code: Optional[int] = None, + message: str = "", + headers: Optional[_CIMultiDict] = None, + ) -> None: + if code is not None: + self.code = code + self.headers = headers + self.message = message + + def __str__(self) -> str: + msg = indent(self.message, " ") + return f"{self.code}, message:\n{msg}" + + def __repr__(self) -> str: + return f"<{self.__class__.__name__}: {self.code}, message={self.message!r}>" + + +class BadHttpMessage(HttpProcessingError): + + code = 400 + message = "Bad Request" + + def __init__(self, message: str, *, headers: Optional[_CIMultiDict] = None) -> None: + super().__init__(message=message, headers=headers) + self.args = (message,) + + +class HttpBadRequest(BadHttpMessage): + + code = 400 + message = "Bad Request" + + +class PayloadEncodingError(BadHttpMessage): + """Base class for payload errors""" + + +class ContentEncodingError(PayloadEncodingError): + """Content encoding error.""" + + +class TransferEncodingError(PayloadEncodingError): + """transfer encoding error.""" + + +class ContentLengthError(PayloadEncodingError): + """Not enough data for satisfy content length header.""" + + +class LineTooLong(BadHttpMessage): + def __init__( + self, line: str, limit: str = "Unknown", actual_size: str = "Unknown" + ) -> None: + super().__init__( + f"Got more than {limit} bytes ({actual_size}) when reading {line}." + ) + self.args = (line, limit, actual_size) + + +class InvalidHeader(BadHttpMessage): + def __init__(self, hdr: Union[bytes, str]) -> None: + hdr_s = hdr.decode(errors="backslashreplace") if isinstance(hdr, bytes) else hdr + super().__init__(f"Invalid HTTP header: {hdr!r}") + self.hdr = hdr_s + self.args = (hdr,) + + +class BadStatusLine(BadHttpMessage): + def __init__(self, line: str = "", error: Optional[str] = None) -> None: + if not isinstance(line, str): + line = repr(line) + super().__init__(error or f"Bad status line {line!r}") + self.args = (line,) + self.line = line + + +class InvalidURLError(BadHttpMessage): + pass diff --git a/env/Lib/site-packages/aiohttp/http_parser.py b/env/Lib/site-packages/aiohttp/http_parser.py new file mode 100644 index 0000000..b992955 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/http_parser.py @@ -0,0 +1,1023 @@ +import abc +import asyncio +import re +import string +from contextlib import suppress +from enum import IntEnum +from typing import ( + Any, + ClassVar, + Final, + Generic, + List, + Literal, + NamedTuple, + Optional, + Pattern, + Set, + Tuple, + Type, + TypeVar, + Union, +) + +from multidict import CIMultiDict, CIMultiDictProxy, istr +from yarl import URL + +from . import hdrs +from .base_protocol import BaseProtocol +from .compression_utils import HAS_BROTLI, BrotliDecompressor, ZLibDecompressor +from .helpers import ( + _EXC_SENTINEL, + DEBUG, + NO_EXTENSIONS, + BaseTimerContext, + method_must_be_empty_body, + set_exception, + status_code_must_be_empty_body, +) +from .http_exceptions import ( + BadHttpMessage, + BadStatusLine, + ContentEncodingError, + ContentLengthError, + InvalidHeader, + InvalidURLError, + LineTooLong, + TransferEncodingError, +) +from .http_writer import HttpVersion, HttpVersion10 +from .streams import EMPTY_PAYLOAD, StreamReader +from .typedefs import RawHeaders + +__all__ = ( + "HeadersParser", + "HttpParser", + "HttpRequestParser", + "HttpResponseParser", + "RawRequestMessage", + "RawResponseMessage", +) + +_SEP = Literal[b"\r\n", b"\n"] + +ASCIISET: Final[Set[str]] = set(string.printable) + +# See https://www.rfc-editor.org/rfc/rfc9110.html#name-overview +# and https://www.rfc-editor.org/rfc/rfc9110.html#name-tokens +# +# method = token +# tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." / +# "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA +# token = 1*tchar +_TCHAR_SPECIALS: Final[str] = re.escape("!#$%&'*+-.^_`|~") +TOKENRE: Final[Pattern[str]] = re.compile(f"[0-9A-Za-z{_TCHAR_SPECIALS}]+") +VERSRE: Final[Pattern[str]] = re.compile(r"HTTP/(\d)\.(\d)", re.ASCII) +DIGITS: Final[Pattern[str]] = re.compile(r"\d+", re.ASCII) +HEXDIGITS: Final[Pattern[bytes]] = re.compile(rb"[0-9a-fA-F]+") + + +class RawRequestMessage(NamedTuple): + method: str + path: str + version: HttpVersion + headers: "CIMultiDictProxy[str]" + raw_headers: RawHeaders + should_close: bool + compression: Optional[str] + upgrade: bool + chunked: bool + url: URL + + +class RawResponseMessage(NamedTuple): + version: HttpVersion + code: int + reason: str + headers: CIMultiDictProxy[str] + raw_headers: RawHeaders + should_close: bool + compression: Optional[str] + upgrade: bool + chunked: bool + + +_MsgT = TypeVar("_MsgT", RawRequestMessage, RawResponseMessage) + + +class ParseState(IntEnum): + + PARSE_NONE = 0 + PARSE_LENGTH = 1 + PARSE_CHUNKED = 2 + PARSE_UNTIL_EOF = 3 + + +class ChunkState(IntEnum): + PARSE_CHUNKED_SIZE = 0 + PARSE_CHUNKED_CHUNK = 1 + PARSE_CHUNKED_CHUNK_EOF = 2 + PARSE_MAYBE_TRAILERS = 3 + PARSE_TRAILERS = 4 + + +class HeadersParser: + def __init__( + self, + max_line_size: int = 8190, + max_headers: int = 32768, + max_field_size: int = 8190, + lax: bool = False, + ) -> None: + self.max_line_size = max_line_size + self.max_headers = max_headers + self.max_field_size = max_field_size + self._lax = lax + + def parse_headers( + self, lines: List[bytes] + ) -> Tuple["CIMultiDictProxy[str]", RawHeaders]: + headers: CIMultiDict[str] = CIMultiDict() + # note: "raw" does not mean inclusion of OWS before/after the field value + raw_headers = [] + + lines_idx = 1 + line = lines[1] + line_count = len(lines) + + while line: + # Parse initial header name : value pair. + try: + bname, bvalue = line.split(b":", 1) + except ValueError: + raise InvalidHeader(line) from None + + if len(bname) == 0: + raise InvalidHeader(bname) + + # https://www.rfc-editor.org/rfc/rfc9112.html#section-5.1-2 + if {bname[0], bname[-1]} & {32, 9}: # {" ", "\t"} + raise InvalidHeader(line) + + bvalue = bvalue.lstrip(b" \t") + if len(bname) > self.max_field_size: + raise LineTooLong( + "request header name {}".format( + bname.decode("utf8", "backslashreplace") + ), + str(self.max_field_size), + str(len(bname)), + ) + name = bname.decode("utf-8", "surrogateescape") + if not TOKENRE.fullmatch(name): + raise InvalidHeader(bname) + + header_length = len(bvalue) + + # next line + lines_idx += 1 + line = lines[lines_idx] + + # consume continuation lines + continuation = self._lax and line and line[0] in (32, 9) # (' ', '\t') + + # Deprecated: https://www.rfc-editor.org/rfc/rfc9112.html#name-obsolete-line-folding + if continuation: + bvalue_lst = [bvalue] + while continuation: + header_length += len(line) + if header_length > self.max_field_size: + raise LineTooLong( + "request header field {}".format( + bname.decode("utf8", "backslashreplace") + ), + str(self.max_field_size), + str(header_length), + ) + bvalue_lst.append(line) + + # next line + lines_idx += 1 + if lines_idx < line_count: + line = lines[lines_idx] + if line: + continuation = line[0] in (32, 9) # (' ', '\t') + else: + line = b"" + break + bvalue = b"".join(bvalue_lst) + else: + if header_length > self.max_field_size: + raise LineTooLong( + "request header field {}".format( + bname.decode("utf8", "backslashreplace") + ), + str(self.max_field_size), + str(header_length), + ) + + bvalue = bvalue.strip(b" \t") + value = bvalue.decode("utf-8", "surrogateescape") + + # https://www.rfc-editor.org/rfc/rfc9110.html#section-5.5-5 + if "\n" in value or "\r" in value or "\x00" in value: + raise InvalidHeader(bvalue) + + headers.add(name, value) + raw_headers.append((bname, bvalue)) + + return (CIMultiDictProxy(headers), tuple(raw_headers)) + + +def _is_supported_upgrade(headers: CIMultiDictProxy[str]) -> bool: + """Check if the upgrade header is supported.""" + return headers.get(hdrs.UPGRADE, "").lower() in {"tcp", "websocket"} + + +class HttpParser(abc.ABC, Generic[_MsgT]): + lax: ClassVar[bool] = False + + def __init__( + self, + protocol: Optional[BaseProtocol] = None, + loop: Optional[asyncio.AbstractEventLoop] = None, + limit: int = 2**16, + max_line_size: int = 8190, + max_headers: int = 32768, + max_field_size: int = 8190, + timer: Optional[BaseTimerContext] = None, + code: Optional[int] = None, + method: Optional[str] = None, + payload_exception: Optional[Type[BaseException]] = None, + response_with_body: bool = True, + read_until_eof: bool = False, + auto_decompress: bool = True, + ) -> None: + self.protocol = protocol + self.loop = loop + self.max_line_size = max_line_size + self.max_headers = max_headers + self.max_field_size = max_field_size + self.timer = timer + self.code = code + self.method = method + self.payload_exception = payload_exception + self.response_with_body = response_with_body + self.read_until_eof = read_until_eof + + self._lines: List[bytes] = [] + self._tail = b"" + self._upgraded = False + self._payload = None + self._payload_parser: Optional[HttpPayloadParser] = None + self._auto_decompress = auto_decompress + self._limit = limit + self._headers_parser = HeadersParser( + max_line_size, max_headers, max_field_size, self.lax + ) + + @abc.abstractmethod + def parse_message(self, lines: List[bytes]) -> _MsgT: + pass + + def feed_eof(self) -> Optional[_MsgT]: + if self._payload_parser is not None: + self._payload_parser.feed_eof() + self._payload_parser = None + else: + # try to extract partial message + if self._tail: + self._lines.append(self._tail) + + if self._lines: + if self._lines[-1] != "\r\n": + self._lines.append(b"") + with suppress(Exception): + return self.parse_message(self._lines) + return None + + def feed_data( + self, + data: bytes, + SEP: _SEP = b"\r\n", + EMPTY: bytes = b"", + CONTENT_LENGTH: istr = hdrs.CONTENT_LENGTH, + METH_CONNECT: str = hdrs.METH_CONNECT, + SEC_WEBSOCKET_KEY1: istr = hdrs.SEC_WEBSOCKET_KEY1, + ) -> Tuple[List[Tuple[_MsgT, StreamReader]], bool, bytes]: + + messages = [] + + if self._tail: + data, self._tail = self._tail + data, b"" + + data_len = len(data) + start_pos = 0 + loop = self.loop + + while start_pos < data_len: + + # read HTTP message (request/response line + headers), \r\n\r\n + # and split by lines + if self._payload_parser is None and not self._upgraded: + pos = data.find(SEP, start_pos) + # consume \r\n + if pos == start_pos and not self._lines: + start_pos = pos + len(SEP) + continue + + if pos >= start_pos: + # line found + line = data[start_pos:pos] + if SEP == b"\n": # For lax response parsing + line = line.rstrip(b"\r") + self._lines.append(line) + start_pos = pos + len(SEP) + + # \r\n\r\n found + if self._lines[-1] == EMPTY: + try: + msg: _MsgT = self.parse_message(self._lines) + finally: + self._lines.clear() + + def get_content_length() -> Optional[int]: + # payload length + length_hdr = msg.headers.get(CONTENT_LENGTH) + if length_hdr is None: + return None + + # Shouldn't allow +/- or other number formats. + # https://www.rfc-editor.org/rfc/rfc9110#section-8.6-2 + # msg.headers is already stripped of leading/trailing wsp + if not DIGITS.fullmatch(length_hdr): + raise InvalidHeader(CONTENT_LENGTH) + + return int(length_hdr) + + length = get_content_length() + # do not support old websocket spec + if SEC_WEBSOCKET_KEY1 in msg.headers: + raise InvalidHeader(SEC_WEBSOCKET_KEY1) + + self._upgraded = msg.upgrade and _is_supported_upgrade( + msg.headers + ) + + method = getattr(msg, "method", self.method) + # code is only present on responses + code = getattr(msg, "code", 0) + + assert self.protocol is not None + # calculate payload + empty_body = status_code_must_be_empty_body(code) or bool( + method and method_must_be_empty_body(method) + ) + if not empty_body and ( + ((length is not None and length > 0) or msg.chunked) + and not self._upgraded + ): + payload = StreamReader( + self.protocol, + timer=self.timer, + loop=loop, + limit=self._limit, + ) + payload_parser = HttpPayloadParser( + payload, + length=length, + chunked=msg.chunked, + method=method, + compression=msg.compression, + code=self.code, + response_with_body=self.response_with_body, + auto_decompress=self._auto_decompress, + lax=self.lax, + ) + if not payload_parser.done: + self._payload_parser = payload_parser + elif method == METH_CONNECT: + assert isinstance(msg, RawRequestMessage) + payload = StreamReader( + self.protocol, + timer=self.timer, + loop=loop, + limit=self._limit, + ) + self._upgraded = True + self._payload_parser = HttpPayloadParser( + payload, + method=msg.method, + compression=msg.compression, + auto_decompress=self._auto_decompress, + lax=self.lax, + ) + elif not empty_body and length is None and self.read_until_eof: + payload = StreamReader( + self.protocol, + timer=self.timer, + loop=loop, + limit=self._limit, + ) + payload_parser = HttpPayloadParser( + payload, + length=length, + chunked=msg.chunked, + method=method, + compression=msg.compression, + code=self.code, + response_with_body=self.response_with_body, + auto_decompress=self._auto_decompress, + lax=self.lax, + ) + if not payload_parser.done: + self._payload_parser = payload_parser + else: + payload = EMPTY_PAYLOAD + + messages.append((msg, payload)) + else: + self._tail = data[start_pos:] + data = EMPTY + break + + # no parser, just store + elif self._payload_parser is None and self._upgraded: + assert not self._lines + break + + # feed payload + elif data and start_pos < data_len: + assert not self._lines + assert self._payload_parser is not None + try: + eof, data = self._payload_parser.feed_data(data[start_pos:], SEP) + except BaseException as underlying_exc: + reraised_exc = underlying_exc + if self.payload_exception is not None: + reraised_exc = self.payload_exception(str(underlying_exc)) + + set_exception( + self._payload_parser.payload, + reraised_exc, + underlying_exc, + ) + + eof = True + data = b"" + + if eof: + start_pos = 0 + data_len = len(data) + self._payload_parser = None + continue + else: + break + + if data and start_pos < data_len: + data = data[start_pos:] + else: + data = EMPTY + + return messages, self._upgraded, data + + def parse_headers( + self, lines: List[bytes] + ) -> Tuple[ + "CIMultiDictProxy[str]", RawHeaders, Optional[bool], Optional[str], bool, bool + ]: + """Parses RFC 5322 headers from a stream. + + Line continuations are supported. Returns list of header name + and value pairs. Header name is in upper case. + """ + headers, raw_headers = self._headers_parser.parse_headers(lines) + close_conn = None + encoding = None + upgrade = False + chunked = False + + # https://www.rfc-editor.org/rfc/rfc9110.html#section-5.5-6 + # https://www.rfc-editor.org/rfc/rfc9110.html#name-collected-abnf + singletons = ( + hdrs.CONTENT_LENGTH, + hdrs.CONTENT_LOCATION, + hdrs.CONTENT_RANGE, + hdrs.CONTENT_TYPE, + hdrs.ETAG, + hdrs.HOST, + hdrs.MAX_FORWARDS, + hdrs.SERVER, + hdrs.TRANSFER_ENCODING, + hdrs.USER_AGENT, + ) + bad_hdr = next((h for h in singletons if len(headers.getall(h, ())) > 1), None) + if bad_hdr is not None: + raise BadHttpMessage(f"Duplicate '{bad_hdr}' header found.") + + # keep-alive + conn = headers.get(hdrs.CONNECTION) + if conn: + v = conn.lower() + if v == "close": + close_conn = True + elif v == "keep-alive": + close_conn = False + # https://www.rfc-editor.org/rfc/rfc9110.html#name-101-switching-protocols + elif v == "upgrade" and headers.get(hdrs.UPGRADE): + upgrade = True + + # encoding + enc = headers.get(hdrs.CONTENT_ENCODING) + if enc: + enc = enc.lower() + if enc in ("gzip", "deflate", "br"): + encoding = enc + + # chunking + te = headers.get(hdrs.TRANSFER_ENCODING) + if te is not None: + if "chunked" == te.lower(): + chunked = True + else: + raise BadHttpMessage("Request has invalid `Transfer-Encoding`") + + if hdrs.CONTENT_LENGTH in headers: + raise BadHttpMessage( + "Transfer-Encoding can't be present with Content-Length", + ) + + return (headers, raw_headers, close_conn, encoding, upgrade, chunked) + + def set_upgraded(self, val: bool) -> None: + """Set connection upgraded (to websocket) mode. + + :param bool val: new state. + """ + self._upgraded = val + + +class HttpRequestParser(HttpParser[RawRequestMessage]): + """Read request status line. + + Exception .http_exceptions.BadStatusLine + could be raised in case of any errors in status line. + Returns RawRequestMessage. + """ + + def parse_message(self, lines: List[bytes]) -> RawRequestMessage: + # request line + line = lines[0].decode("utf-8", "surrogateescape") + try: + method, path, version = line.split(" ", maxsplit=2) + except ValueError: + raise BadStatusLine(line) from None + + if len(path) > self.max_line_size: + raise LineTooLong( + "Status line is too long", str(self.max_line_size), str(len(path)) + ) + + # method + if not TOKENRE.fullmatch(method): + raise BadStatusLine(method) + + # version + match = VERSRE.fullmatch(version) + if match is None: + raise BadStatusLine(line) + version_o = HttpVersion(int(match.group(1)), int(match.group(2))) + + if method == "CONNECT": + # authority-form, + # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.3 + url = URL.build(authority=path, encoded=True) + elif path.startswith("/"): + # origin-form, + # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.1 + path_part, _hash_separator, url_fragment = path.partition("#") + path_part, _question_mark_separator, qs_part = path_part.partition("?") + + # NOTE: `yarl.URL.build()` is used to mimic what the Cython-based + # NOTE: parser does, otherwise it results into the same + # NOTE: HTTP Request-Line input producing different + # NOTE: `yarl.URL()` objects + url = URL.build( + path=path_part, + query_string=qs_part, + fragment=url_fragment, + encoded=True, + ) + elif path == "*" and method == "OPTIONS": + # asterisk-form, + url = URL(path, encoded=True) + else: + # absolute-form for proxy maybe, + # https://datatracker.ietf.org/doc/html/rfc7230#section-5.3.2 + url = URL(path, encoded=True) + if url.scheme == "": + # not absolute-form + raise InvalidURLError( + path.encode(errors="surrogateescape").decode("latin1") + ) + + # read headers + ( + headers, + raw_headers, + close, + compression, + upgrade, + chunked, + ) = self.parse_headers(lines) + + if close is None: # then the headers weren't set in the request + if version_o <= HttpVersion10: # HTTP 1.0 must asks to not close + close = True + else: # HTTP 1.1 must ask to close. + close = False + + return RawRequestMessage( + method, + path, + version_o, + headers, + raw_headers, + close, + compression, + upgrade, + chunked, + url, + ) + + +class HttpResponseParser(HttpParser[RawResponseMessage]): + """Read response status line and headers. + + BadStatusLine could be raised in case of any errors in status line. + Returns RawResponseMessage. + """ + + # Lax mode should only be enabled on response parser. + lax = not DEBUG + + def feed_data( + self, + data: bytes, + SEP: Optional[_SEP] = None, + *args: Any, + **kwargs: Any, + ) -> Tuple[List[Tuple[RawResponseMessage, StreamReader]], bool, bytes]: + if SEP is None: + SEP = b"\r\n" if DEBUG else b"\n" + return super().feed_data(data, SEP, *args, **kwargs) + + def parse_message(self, lines: List[bytes]) -> RawResponseMessage: + line = lines[0].decode("utf-8", "surrogateescape") + try: + version, status = line.split(maxsplit=1) + except ValueError: + raise BadStatusLine(line) from None + + try: + status, reason = status.split(maxsplit=1) + except ValueError: + status = status.strip() + reason = "" + + if len(reason) > self.max_line_size: + raise LineTooLong( + "Status line is too long", str(self.max_line_size), str(len(reason)) + ) + + # version + match = VERSRE.fullmatch(version) + if match is None: + raise BadStatusLine(line) + version_o = HttpVersion(int(match.group(1)), int(match.group(2))) + + # The status code is a three-digit ASCII number, no padding + if len(status) != 3 or not DIGITS.fullmatch(status): + raise BadStatusLine(line) + status_i = int(status) + + # read headers + ( + headers, + raw_headers, + close, + compression, + upgrade, + chunked, + ) = self.parse_headers(lines) + + if close is None: + if version_o <= HttpVersion10: + close = True + # https://www.rfc-editor.org/rfc/rfc9112.html#name-message-body-length + elif 100 <= status_i < 200 or status_i in {204, 304}: + close = False + elif hdrs.CONTENT_LENGTH in headers or hdrs.TRANSFER_ENCODING in headers: + close = False + else: + # https://www.rfc-editor.org/rfc/rfc9112.html#section-6.3-2.8 + close = True + + return RawResponseMessage( + version_o, + status_i, + reason.strip(), + headers, + raw_headers, + close, + compression, + upgrade, + chunked, + ) + + +class HttpPayloadParser: + def __init__( + self, + payload: StreamReader, + length: Optional[int] = None, + chunked: bool = False, + compression: Optional[str] = None, + code: Optional[int] = None, + method: Optional[str] = None, + response_with_body: bool = True, + auto_decompress: bool = True, + lax: bool = False, + ) -> None: + self._length = 0 + self._type = ParseState.PARSE_UNTIL_EOF + self._chunk = ChunkState.PARSE_CHUNKED_SIZE + self._chunk_size = 0 + self._chunk_tail = b"" + self._auto_decompress = auto_decompress + self._lax = lax + self.done = False + + # payload decompression wrapper + if response_with_body and compression and self._auto_decompress: + real_payload: Union[StreamReader, DeflateBuffer] = DeflateBuffer( + payload, compression + ) + else: + real_payload = payload + + # payload parser + if not response_with_body: + # don't parse payload if it's not expected to be received + self._type = ParseState.PARSE_NONE + real_payload.feed_eof() + self.done = True + elif chunked: + self._type = ParseState.PARSE_CHUNKED + elif length is not None: + self._type = ParseState.PARSE_LENGTH + self._length = length + if self._length == 0: + real_payload.feed_eof() + self.done = True + + self.payload = real_payload + + def feed_eof(self) -> None: + if self._type == ParseState.PARSE_UNTIL_EOF: + self.payload.feed_eof() + elif self._type == ParseState.PARSE_LENGTH: + raise ContentLengthError( + "Not enough data for satisfy content length header." + ) + elif self._type == ParseState.PARSE_CHUNKED: + raise TransferEncodingError( + "Not enough data for satisfy transfer length header." + ) + + def feed_data( + self, chunk: bytes, SEP: _SEP = b"\r\n", CHUNK_EXT: bytes = b";" + ) -> Tuple[bool, bytes]: + # Read specified amount of bytes + if self._type == ParseState.PARSE_LENGTH: + required = self._length + chunk_len = len(chunk) + + if required >= chunk_len: + self._length = required - chunk_len + self.payload.feed_data(chunk, chunk_len) + if self._length == 0: + self.payload.feed_eof() + return True, b"" + else: + self._length = 0 + self.payload.feed_data(chunk[:required], required) + self.payload.feed_eof() + return True, chunk[required:] + + # Chunked transfer encoding parser + elif self._type == ParseState.PARSE_CHUNKED: + if self._chunk_tail: + chunk = self._chunk_tail + chunk + self._chunk_tail = b"" + + while chunk: + + # read next chunk size + if self._chunk == ChunkState.PARSE_CHUNKED_SIZE: + pos = chunk.find(SEP) + if pos >= 0: + i = chunk.find(CHUNK_EXT, 0, pos) + if i >= 0: + size_b = chunk[:i] # strip chunk-extensions + else: + size_b = chunk[:pos] + + if self._lax: # Allow whitespace in lax mode. + size_b = size_b.strip() + + if not re.fullmatch(HEXDIGITS, size_b): + exc = TransferEncodingError( + chunk[:pos].decode("ascii", "surrogateescape") + ) + set_exception(self.payload, exc) + raise exc + size = int(bytes(size_b), 16) + + chunk = chunk[pos + len(SEP) :] + if size == 0: # eof marker + self._chunk = ChunkState.PARSE_MAYBE_TRAILERS + if self._lax and chunk.startswith(b"\r"): + chunk = chunk[1:] + else: + self._chunk = ChunkState.PARSE_CHUNKED_CHUNK + self._chunk_size = size + self.payload.begin_http_chunk_receiving() + else: + self._chunk_tail = chunk + return False, b"" + + # read chunk and feed buffer + if self._chunk == ChunkState.PARSE_CHUNKED_CHUNK: + required = self._chunk_size + chunk_len = len(chunk) + + if required > chunk_len: + self._chunk_size = required - chunk_len + self.payload.feed_data(chunk, chunk_len) + return False, b"" + else: + self._chunk_size = 0 + self.payload.feed_data(chunk[:required], required) + chunk = chunk[required:] + self._chunk = ChunkState.PARSE_CHUNKED_CHUNK_EOF + self.payload.end_http_chunk_receiving() + + # toss the CRLF at the end of the chunk + if self._chunk == ChunkState.PARSE_CHUNKED_CHUNK_EOF: + if self._lax and chunk.startswith(b"\r"): + chunk = chunk[1:] + if chunk[: len(SEP)] == SEP: + chunk = chunk[len(SEP) :] + self._chunk = ChunkState.PARSE_CHUNKED_SIZE + else: + self._chunk_tail = chunk + return False, b"" + + # if stream does not contain trailer, after 0\r\n + # we should get another \r\n otherwise + # trailers needs to be skipped until \r\n\r\n + if self._chunk == ChunkState.PARSE_MAYBE_TRAILERS: + head = chunk[: len(SEP)] + if head == SEP: + # end of stream + self.payload.feed_eof() + return True, chunk[len(SEP) :] + # Both CR and LF, or only LF may not be received yet. It is + # expected that CRLF or LF will be shown at the very first + # byte next time, otherwise trailers should come. The last + # CRLF which marks the end of response might not be + # contained in the same TCP segment which delivered the + # size indicator. + if not head: + return False, b"" + if head == SEP[:1]: + self._chunk_tail = head + return False, b"" + self._chunk = ChunkState.PARSE_TRAILERS + + # read and discard trailer up to the CRLF terminator + if self._chunk == ChunkState.PARSE_TRAILERS: + pos = chunk.find(SEP) + if pos >= 0: + chunk = chunk[pos + len(SEP) :] + self._chunk = ChunkState.PARSE_MAYBE_TRAILERS + else: + self._chunk_tail = chunk + return False, b"" + + # Read all bytes until eof + elif self._type == ParseState.PARSE_UNTIL_EOF: + self.payload.feed_data(chunk, len(chunk)) + + return False, b"" + + +class DeflateBuffer: + """DeflateStream decompress stream and feed data into specified stream.""" + + decompressor: Any + + def __init__(self, out: StreamReader, encoding: Optional[str]) -> None: + self.out = out + self.size = 0 + self.encoding = encoding + self._started_decoding = False + + self.decompressor: Union[BrotliDecompressor, ZLibDecompressor] + if encoding == "br": + if not HAS_BROTLI: # pragma: no cover + raise ContentEncodingError( + "Can not decode content-encoding: brotli (br). " + "Please install `Brotli`" + ) + self.decompressor = BrotliDecompressor() + else: + self.decompressor = ZLibDecompressor(encoding=encoding) + + def set_exception( + self, + exc: BaseException, + exc_cause: BaseException = _EXC_SENTINEL, + ) -> None: + set_exception(self.out, exc, exc_cause) + + def feed_data(self, chunk: bytes, size: int) -> None: + if not size: + return + + self.size += size + + # RFC1950 + # bits 0..3 = CM = 0b1000 = 8 = "deflate" + # bits 4..7 = CINFO = 1..7 = windows size. + if ( + not self._started_decoding + and self.encoding == "deflate" + and chunk[0] & 0xF != 8 + ): + # Change the decoder to decompress incorrectly compressed data + # Actually we should issue a warning about non-RFC-compliant data. + self.decompressor = ZLibDecompressor( + encoding=self.encoding, suppress_deflate_header=True + ) + + try: + chunk = self.decompressor.decompress_sync(chunk) + except Exception: + raise ContentEncodingError( + "Can not decode content-encoding: %s" % self.encoding + ) + + self._started_decoding = True + + if chunk: + self.out.feed_data(chunk, len(chunk)) + + def feed_eof(self) -> None: + chunk = self.decompressor.flush() + + if chunk or self.size > 0: + self.out.feed_data(chunk, len(chunk)) + if self.encoding == "deflate" and not self.decompressor.eof: + raise ContentEncodingError("deflate") + + self.out.feed_eof() + + def begin_http_chunk_receiving(self) -> None: + self.out.begin_http_chunk_receiving() + + def end_http_chunk_receiving(self) -> None: + self.out.end_http_chunk_receiving() + + +HttpRequestParserPy = HttpRequestParser +HttpResponseParserPy = HttpResponseParser +RawRequestMessagePy = RawRequestMessage +RawResponseMessagePy = RawResponseMessage + +try: + if not NO_EXTENSIONS: + from ._http_parser import ( # type: ignore[import-not-found,no-redef] + HttpRequestParser, + HttpResponseParser, + RawRequestMessage, + RawResponseMessage, + ) + + HttpRequestParserC = HttpRequestParser + HttpResponseParserC = HttpResponseParser + RawRequestMessageC = RawRequestMessage + RawResponseMessageC = RawResponseMessage +except ImportError: # pragma: no cover + pass diff --git a/env/Lib/site-packages/aiohttp/http_websocket.py b/env/Lib/site-packages/aiohttp/http_websocket.py new file mode 100644 index 0000000..db0cb42 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/http_websocket.py @@ -0,0 +1,737 @@ +"""WebSocket protocol versions 13 and 8.""" + +import asyncio +import functools +import json +import random +import re +import sys +import zlib +from enum import IntEnum +from functools import partial +from struct import Struct +from typing import ( + Any, + Callable, + Final, + List, + NamedTuple, + Optional, + Pattern, + Set, + Tuple, + Union, + cast, +) + +from .base_protocol import BaseProtocol +from .compression_utils import ZLibCompressor, ZLibDecompressor +from .helpers import NO_EXTENSIONS, set_exception +from .streams import DataQueue + +__all__ = ( + "WS_CLOSED_MESSAGE", + "WS_CLOSING_MESSAGE", + "WS_KEY", + "WebSocketReader", + "WebSocketWriter", + "WSMessage", + "WebSocketError", + "WSMsgType", + "WSCloseCode", +) + + +class WSCloseCode(IntEnum): + OK = 1000 + GOING_AWAY = 1001 + PROTOCOL_ERROR = 1002 + UNSUPPORTED_DATA = 1003 + ABNORMAL_CLOSURE = 1006 + INVALID_TEXT = 1007 + POLICY_VIOLATION = 1008 + MESSAGE_TOO_BIG = 1009 + MANDATORY_EXTENSION = 1010 + INTERNAL_ERROR = 1011 + SERVICE_RESTART = 1012 + TRY_AGAIN_LATER = 1013 + BAD_GATEWAY = 1014 + + +ALLOWED_CLOSE_CODES: Final[Set[int]] = {int(i) for i in WSCloseCode} + +# For websockets, keeping latency low is extremely important as implementations +# generally expect to be able to send and receive messages quickly. We use a +# larger chunk size than the default to reduce the number of executor calls +# since the executor is a significant source of latency and overhead when +# the chunks are small. A size of 5KiB was chosen because it is also the +# same value python-zlib-ng choose to use as the threshold to release the GIL. + +WEBSOCKET_MAX_SYNC_CHUNK_SIZE = 5 * 1024 + + +class WSMsgType(IntEnum): + # websocket spec types + CONTINUATION = 0x0 + TEXT = 0x1 + BINARY = 0x2 + PING = 0x9 + PONG = 0xA + CLOSE = 0x8 + + # aiohttp specific types + CLOSING = 0x100 + CLOSED = 0x101 + ERROR = 0x102 + + text = TEXT + binary = BINARY + ping = PING + pong = PONG + close = CLOSE + closing = CLOSING + closed = CLOSED + error = ERROR + + +MESSAGE_TYPES_WITH_CONTENT: Final = frozenset( + { + WSMsgType.BINARY, + WSMsgType.TEXT, + WSMsgType.CONTINUATION, + } +) + +WS_KEY: Final[bytes] = b"258EAFA5-E914-47DA-95CA-C5AB0DC85B11" + + +UNPACK_LEN2 = Struct("!H").unpack_from +UNPACK_LEN3 = Struct("!Q").unpack_from +UNPACK_CLOSE_CODE = Struct("!H").unpack +PACK_LEN1 = Struct("!BB").pack +PACK_LEN2 = Struct("!BBH").pack +PACK_LEN3 = Struct("!BBQ").pack +PACK_CLOSE_CODE = Struct("!H").pack +PACK_RANDBITS = Struct("!L").pack +MSG_SIZE: Final[int] = 2**14 +DEFAULT_LIMIT: Final[int] = 2**16 + + +class WSMessage(NamedTuple): + type: WSMsgType + # To type correctly, this would need some kind of tagged union for each type. + data: Any + extra: Optional[str] + + def json(self, *, loads: Callable[[Any], Any] = json.loads) -> Any: + """Return parsed JSON data. + + .. versionadded:: 0.22 + """ + return loads(self.data) + + +WS_CLOSED_MESSAGE = WSMessage(WSMsgType.CLOSED, None, None) +WS_CLOSING_MESSAGE = WSMessage(WSMsgType.CLOSING, None, None) + + +class WebSocketError(Exception): + """WebSocket protocol parser error.""" + + def __init__(self, code: int, message: str) -> None: + self.code = code + super().__init__(code, message) + + def __str__(self) -> str: + return cast(str, self.args[1]) + + +class WSHandshakeError(Exception): + """WebSocket protocol handshake error.""" + + +native_byteorder: Final[str] = sys.byteorder + + +# Used by _websocket_mask_python +@functools.lru_cache +def _xor_table() -> List[bytes]: + return [bytes(a ^ b for a in range(256)) for b in range(256)] + + +def _websocket_mask_python(mask: bytes, data: bytearray) -> None: + """Websocket masking function. + + `mask` is a `bytes` object of length 4; `data` is a `bytearray` + object of any length. The contents of `data` are masked with `mask`, + as specified in section 5.3 of RFC 6455. + + Note that this function mutates the `data` argument. + + This pure-python implementation may be replaced by an optimized + version when available. + + """ + assert isinstance(data, bytearray), data + assert len(mask) == 4, mask + + if data: + _XOR_TABLE = _xor_table() + a, b, c, d = (_XOR_TABLE[n] for n in mask) + data[::4] = data[::4].translate(a) + data[1::4] = data[1::4].translate(b) + data[2::4] = data[2::4].translate(c) + data[3::4] = data[3::4].translate(d) + + +if NO_EXTENSIONS: # pragma: no cover + _websocket_mask = _websocket_mask_python +else: + try: + from ._websocket import _websocket_mask_cython # type: ignore[import-not-found] + + _websocket_mask = _websocket_mask_cython + except ImportError: # pragma: no cover + _websocket_mask = _websocket_mask_python + +_WS_DEFLATE_TRAILING: Final[bytes] = bytes([0x00, 0x00, 0xFF, 0xFF]) + + +_WS_EXT_RE: Final[Pattern[str]] = re.compile( + r"^(?:;\s*(?:" + r"(server_no_context_takeover)|" + r"(client_no_context_takeover)|" + r"(server_max_window_bits(?:=(\d+))?)|" + r"(client_max_window_bits(?:=(\d+))?)))*$" +) + +_WS_EXT_RE_SPLIT: Final[Pattern[str]] = re.compile(r"permessage-deflate([^,]+)?") + + +def ws_ext_parse(extstr: Optional[str], isserver: bool = False) -> Tuple[int, bool]: + if not extstr: + return 0, False + + compress = 0 + notakeover = False + for ext in _WS_EXT_RE_SPLIT.finditer(extstr): + defext = ext.group(1) + # Return compress = 15 when get `permessage-deflate` + if not defext: + compress = 15 + break + match = _WS_EXT_RE.match(defext) + if match: + compress = 15 + if isserver: + # Server never fail to detect compress handshake. + # Server does not need to send max wbit to client + if match.group(4): + compress = int(match.group(4)) + # Group3 must match if group4 matches + # Compress wbit 8 does not support in zlib + # If compress level not support, + # CONTINUE to next extension + if compress > 15 or compress < 9: + compress = 0 + continue + if match.group(1): + notakeover = True + # Ignore regex group 5 & 6 for client_max_window_bits + break + else: + if match.group(6): + compress = int(match.group(6)) + # Group5 must match if group6 matches + # Compress wbit 8 does not support in zlib + # If compress level not support, + # FAIL the parse progress + if compress > 15 or compress < 9: + raise WSHandshakeError("Invalid window size") + if match.group(2): + notakeover = True + # Ignore regex group 5 & 6 for client_max_window_bits + break + # Return Fail if client side and not match + elif not isserver: + raise WSHandshakeError("Extension for deflate not supported" + ext.group(1)) + + return compress, notakeover + + +def ws_ext_gen( + compress: int = 15, isserver: bool = False, server_notakeover: bool = False +) -> str: + # client_notakeover=False not used for server + # compress wbit 8 does not support in zlib + if compress < 9 or compress > 15: + raise ValueError( + "Compress wbits must between 9 and 15, " "zlib does not support wbits=8" + ) + enabledext = ["permessage-deflate"] + if not isserver: + enabledext.append("client_max_window_bits") + + if compress < 15: + enabledext.append("server_max_window_bits=" + str(compress)) + if server_notakeover: + enabledext.append("server_no_context_takeover") + # if client_notakeover: + # enabledext.append('client_no_context_takeover') + return "; ".join(enabledext) + + +class WSParserState(IntEnum): + READ_HEADER = 1 + READ_PAYLOAD_LENGTH = 2 + READ_PAYLOAD_MASK = 3 + READ_PAYLOAD = 4 + + +class WebSocketReader: + def __init__( + self, queue: DataQueue[WSMessage], max_msg_size: int, compress: bool = True + ) -> None: + self.queue = queue + self._max_msg_size = max_msg_size + + self._exc: Optional[BaseException] = None + self._partial = bytearray() + self._state = WSParserState.READ_HEADER + + self._opcode: Optional[int] = None + self._frame_fin = False + self._frame_opcode: Optional[int] = None + self._frame_payload = bytearray() + + self._tail: bytes = b"" + self._has_mask = False + self._frame_mask: Optional[bytes] = None + self._payload_length = 0 + self._payload_length_flag = 0 + self._compressed: Optional[bool] = None + self._decompressobj: Optional[ZLibDecompressor] = None + self._compress = compress + + def feed_eof(self) -> None: + self.queue.feed_eof() + + def feed_data(self, data: bytes) -> Tuple[bool, bytes]: + if self._exc: + return True, data + + try: + self._feed_data(data) + except Exception as exc: + self._exc = exc + set_exception(self.queue, exc) + return True, b"" + + return False, b"" + + def _feed_data(self, data: bytes) -> None: + for fin, opcode, payload, compressed in self.parse_frame(data): + if opcode in MESSAGE_TYPES_WITH_CONTENT: + # load text/binary + is_continuation = opcode == WSMsgType.CONTINUATION + if not fin: + # got partial frame payload + if not is_continuation: + self._opcode = opcode + self._partial += payload + if self._max_msg_size and len(self._partial) >= self._max_msg_size: + raise WebSocketError( + WSCloseCode.MESSAGE_TOO_BIG, + "Message size {} exceeds limit {}".format( + len(self._partial), self._max_msg_size + ), + ) + continue + + has_partial = bool(self._partial) + if is_continuation: + if self._opcode is None: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "Continuation frame for non started message", + ) + opcode = self._opcode + self._opcode = None + # previous frame was non finished + # we should get continuation opcode + elif has_partial: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "The opcode in non-fin frame is expected " + "to be zero, got {!r}".format(opcode), + ) + + if has_partial: + assembled_payload = self._partial + payload + self._partial.clear() + else: + assembled_payload = payload + + if self._max_msg_size and len(assembled_payload) >= self._max_msg_size: + raise WebSocketError( + WSCloseCode.MESSAGE_TOO_BIG, + "Message size {} exceeds limit {}".format( + len(assembled_payload), self._max_msg_size + ), + ) + + # Decompress process must to be done after all packets + # received. + if compressed: + if not self._decompressobj: + self._decompressobj = ZLibDecompressor( + suppress_deflate_header=True + ) + payload_merged = self._decompressobj.decompress_sync( + assembled_payload + _WS_DEFLATE_TRAILING, self._max_msg_size + ) + if self._decompressobj.unconsumed_tail: + left = len(self._decompressobj.unconsumed_tail) + raise WebSocketError( + WSCloseCode.MESSAGE_TOO_BIG, + "Decompressed message size {} exceeds limit {}".format( + self._max_msg_size + left, self._max_msg_size + ), + ) + else: + payload_merged = bytes(assembled_payload) + + if opcode == WSMsgType.TEXT: + try: + text = payload_merged.decode("utf-8") + except UnicodeDecodeError as exc: + raise WebSocketError( + WSCloseCode.INVALID_TEXT, "Invalid UTF-8 text message" + ) from exc + + self.queue.feed_data(WSMessage(WSMsgType.TEXT, text, ""), len(text)) + continue + + self.queue.feed_data( + WSMessage(WSMsgType.BINARY, payload_merged, ""), len(payload_merged) + ) + elif opcode == WSMsgType.CLOSE: + if len(payload) >= 2: + close_code = UNPACK_CLOSE_CODE(payload[:2])[0] + if close_code < 3000 and close_code not in ALLOWED_CLOSE_CODES: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + f"Invalid close code: {close_code}", + ) + try: + close_message = payload[2:].decode("utf-8") + except UnicodeDecodeError as exc: + raise WebSocketError( + WSCloseCode.INVALID_TEXT, "Invalid UTF-8 text message" + ) from exc + msg = WSMessage(WSMsgType.CLOSE, close_code, close_message) + elif payload: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + f"Invalid close frame: {fin} {opcode} {payload!r}", + ) + else: + msg = WSMessage(WSMsgType.CLOSE, 0, "") + + self.queue.feed_data(msg, 0) + + elif opcode == WSMsgType.PING: + self.queue.feed_data( + WSMessage(WSMsgType.PING, payload, ""), len(payload) + ) + + elif opcode == WSMsgType.PONG: + self.queue.feed_data( + WSMessage(WSMsgType.PONG, payload, ""), len(payload) + ) + + else: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, f"Unexpected opcode={opcode!r}" + ) + + def parse_frame( + self, buf: bytes + ) -> List[Tuple[bool, Optional[int], bytearray, Optional[bool]]]: + """Return the next frame from the socket.""" + frames: List[Tuple[bool, Optional[int], bytearray, Optional[bool]]] = [] + if self._tail: + buf, self._tail = self._tail + buf, b"" + + start_pos: int = 0 + buf_length = len(buf) + + while True: + # read header + if self._state is WSParserState.READ_HEADER: + if buf_length - start_pos < 2: + break + data = buf[start_pos : start_pos + 2] + start_pos += 2 + first_byte, second_byte = data + + fin = (first_byte >> 7) & 1 + rsv1 = (first_byte >> 6) & 1 + rsv2 = (first_byte >> 5) & 1 + rsv3 = (first_byte >> 4) & 1 + opcode = first_byte & 0xF + + # frame-fin = %x0 ; more frames of this message follow + # / %x1 ; final frame of this message + # frame-rsv1 = %x0 ; + # 1 bit, MUST be 0 unless negotiated otherwise + # frame-rsv2 = %x0 ; + # 1 bit, MUST be 0 unless negotiated otherwise + # frame-rsv3 = %x0 ; + # 1 bit, MUST be 0 unless negotiated otherwise + # + # Remove rsv1 from this test for deflate development + if rsv2 or rsv3 or (rsv1 and not self._compress): + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "Received frame with non-zero reserved bits", + ) + + if opcode > 0x7 and fin == 0: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "Received fragmented control frame", + ) + + has_mask = (second_byte >> 7) & 1 + length = second_byte & 0x7F + + # Control frames MUST have a payload + # length of 125 bytes or less + if opcode > 0x7 and length > 125: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "Control frame payload cannot be " "larger than 125 bytes", + ) + + # Set compress status if last package is FIN + # OR set compress status if this is first fragment + # Raise error if not first fragment with rsv1 = 0x1 + if self._frame_fin or self._compressed is None: + self._compressed = True if rsv1 else False + elif rsv1: + raise WebSocketError( + WSCloseCode.PROTOCOL_ERROR, + "Received frame with non-zero reserved bits", + ) + + self._frame_fin = bool(fin) + self._frame_opcode = opcode + self._has_mask = bool(has_mask) + self._payload_length_flag = length + self._state = WSParserState.READ_PAYLOAD_LENGTH + + # read payload length + if self._state is WSParserState.READ_PAYLOAD_LENGTH: + length_flag = self._payload_length_flag + if length_flag == 126: + if buf_length - start_pos < 2: + break + data = buf[start_pos : start_pos + 2] + start_pos += 2 + self._payload_length = UNPACK_LEN2(data)[0] + elif length_flag > 126: + if buf_length - start_pos < 8: + break + data = buf[start_pos : start_pos + 8] + start_pos += 8 + self._payload_length = UNPACK_LEN3(data)[0] + else: + self._payload_length = length_flag + + self._state = ( + WSParserState.READ_PAYLOAD_MASK + if self._has_mask + else WSParserState.READ_PAYLOAD + ) + + # read payload mask + if self._state is WSParserState.READ_PAYLOAD_MASK: + if buf_length - start_pos < 4: + break + self._frame_mask = buf[start_pos : start_pos + 4] + start_pos += 4 + self._state = WSParserState.READ_PAYLOAD + + if self._state is WSParserState.READ_PAYLOAD: + length = self._payload_length + payload = self._frame_payload + + chunk_len = buf_length - start_pos + if length >= chunk_len: + self._payload_length = length - chunk_len + payload += buf[start_pos:] + start_pos = buf_length + else: + self._payload_length = 0 + payload += buf[start_pos : start_pos + length] + start_pos = start_pos + length + + if self._payload_length != 0: + break + + if self._has_mask: + assert self._frame_mask is not None + _websocket_mask(self._frame_mask, payload) + + frames.append( + (self._frame_fin, self._frame_opcode, payload, self._compressed) + ) + self._frame_payload = bytearray() + self._state = WSParserState.READ_HEADER + + self._tail = buf[start_pos:] + + return frames + + +class WebSocketWriter: + def __init__( + self, + protocol: BaseProtocol, + transport: asyncio.Transport, + *, + use_mask: bool = False, + limit: int = DEFAULT_LIMIT, + random: random.Random = random.Random(), + compress: int = 0, + notakeover: bool = False, + ) -> None: + self.protocol = protocol + self.transport = transport + self.use_mask = use_mask + self.get_random_bits = partial(random.getrandbits, 32) + self.compress = compress + self.notakeover = notakeover + self._closing = False + self._limit = limit + self._output_size = 0 + self._compressobj: Any = None # actually compressobj + + async def _send_frame( + self, message: bytes, opcode: int, compress: Optional[int] = None + ) -> None: + """Send a frame over the websocket with message as its payload.""" + if self._closing and not (opcode & WSMsgType.CLOSE): + raise ConnectionResetError("Cannot write to closing transport") + + rsv = 0 + + # Only compress larger packets (disabled) + # Does small packet needs to be compressed? + # if self.compress and opcode < 8 and len(message) > 124: + if (compress or self.compress) and opcode < 8: + if compress: + # Do not set self._compress if compressing is for this frame + compressobj = self._make_compress_obj(compress) + else: # self.compress + if not self._compressobj: + self._compressobj = self._make_compress_obj(self.compress) + compressobj = self._compressobj + + message = await compressobj.compress(message) + # Its critical that we do not return control to the event + # loop until we have finished sending all the compressed + # data. Otherwise we could end up mixing compressed frames + # if there are multiple coroutines compressing data. + message += compressobj.flush( + zlib.Z_FULL_FLUSH if self.notakeover else zlib.Z_SYNC_FLUSH + ) + if message.endswith(_WS_DEFLATE_TRAILING): + message = message[:-4] + rsv = rsv | 0x40 + + msg_length = len(message) + + use_mask = self.use_mask + if use_mask: + mask_bit = 0x80 + else: + mask_bit = 0 + + if msg_length < 126: + header = PACK_LEN1(0x80 | rsv | opcode, msg_length | mask_bit) + elif msg_length < (1 << 16): + header = PACK_LEN2(0x80 | rsv | opcode, 126 | mask_bit, msg_length) + else: + header = PACK_LEN3(0x80 | rsv | opcode, 127 | mask_bit, msg_length) + if use_mask: + mask = PACK_RANDBITS(self.get_random_bits()) + message = bytearray(message) + _websocket_mask(mask, message) + self._write(header + mask + message) + self._output_size += len(header) + len(mask) + msg_length + else: + if msg_length > MSG_SIZE: + self._write(header) + self._write(message) + else: + self._write(header + message) + + self._output_size += len(header) + msg_length + + # It is safe to return control to the event loop when using compression + # after this point as we have already sent or buffered all the data. + + if self._output_size > self._limit: + self._output_size = 0 + await self.protocol._drain_helper() + + def _make_compress_obj(self, compress: int) -> ZLibCompressor: + return ZLibCompressor( + level=zlib.Z_BEST_SPEED, + wbits=-compress, + max_sync_chunk_size=WEBSOCKET_MAX_SYNC_CHUNK_SIZE, + ) + + def _write(self, data: bytes) -> None: + if self.transport is None or self.transport.is_closing(): + raise ConnectionResetError("Cannot write to closing transport") + self.transport.write(data) + + async def pong(self, message: Union[bytes, str] = b"") -> None: + """Send pong message.""" + if isinstance(message, str): + message = message.encode("utf-8") + await self._send_frame(message, WSMsgType.PONG) + + async def ping(self, message: Union[bytes, str] = b"") -> None: + """Send ping message.""" + if isinstance(message, str): + message = message.encode("utf-8") + await self._send_frame(message, WSMsgType.PING) + + async def send( + self, + message: Union[str, bytes], + binary: bool = False, + compress: Optional[int] = None, + ) -> None: + """Send a frame over the websocket with message as its payload.""" + if isinstance(message, str): + message = message.encode("utf-8") + if binary: + await self._send_frame(message, WSMsgType.BINARY, compress) + else: + await self._send_frame(message, WSMsgType.TEXT, compress) + + async def close(self, code: int = 1000, message: Union[bytes, str] = b"") -> None: + """Close the websocket, sending the specified code and message.""" + if isinstance(message, str): + message = message.encode("utf-8") + try: + await self._send_frame( + PACK_CLOSE_CODE(code) + message, opcode=WSMsgType.CLOSE + ) + finally: + self._closing = True diff --git a/env/Lib/site-packages/aiohttp/http_writer.py b/env/Lib/site-packages/aiohttp/http_writer.py new file mode 100644 index 0000000..d6b02e6 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/http_writer.py @@ -0,0 +1,198 @@ +"""Http related parsers and protocol.""" + +import asyncio +import zlib +from typing import Any, Awaitable, Callable, NamedTuple, Optional, Union # noqa + +from multidict import CIMultiDict + +from .abc import AbstractStreamWriter +from .base_protocol import BaseProtocol +from .compression_utils import ZLibCompressor +from .helpers import NO_EXTENSIONS + +__all__ = ("StreamWriter", "HttpVersion", "HttpVersion10", "HttpVersion11") + + +class HttpVersion(NamedTuple): + major: int + minor: int + + +HttpVersion10 = HttpVersion(1, 0) +HttpVersion11 = HttpVersion(1, 1) + + +_T_OnChunkSent = Optional[Callable[[bytes], Awaitable[None]]] +_T_OnHeadersSent = Optional[Callable[["CIMultiDict[str]"], Awaitable[None]]] + + +class StreamWriter(AbstractStreamWriter): + def __init__( + self, + protocol: BaseProtocol, + loop: asyncio.AbstractEventLoop, + on_chunk_sent: _T_OnChunkSent = None, + on_headers_sent: _T_OnHeadersSent = None, + ) -> None: + self._protocol = protocol + + self.loop = loop + self.length = None + self.chunked = False + self.buffer_size = 0 + self.output_size = 0 + + self._eof = False + self._compress: Optional[ZLibCompressor] = None + self._drain_waiter = None + + self._on_chunk_sent: _T_OnChunkSent = on_chunk_sent + self._on_headers_sent: _T_OnHeadersSent = on_headers_sent + + @property + def transport(self) -> Optional[asyncio.Transport]: + return self._protocol.transport + + @property + def protocol(self) -> BaseProtocol: + return self._protocol + + def enable_chunking(self) -> None: + self.chunked = True + + def enable_compression( + self, encoding: str = "deflate", strategy: int = zlib.Z_DEFAULT_STRATEGY + ) -> None: + self._compress = ZLibCompressor(encoding=encoding, strategy=strategy) + + def _write(self, chunk: bytes) -> None: + size = len(chunk) + self.buffer_size += size + self.output_size += size + transport = self.transport + if not self._protocol.connected or transport is None or transport.is_closing(): + raise ConnectionResetError("Cannot write to closing transport") + transport.write(chunk) + + async def write( + self, chunk: bytes, *, drain: bool = True, LIMIT: int = 0x10000 + ) -> None: + """Writes chunk of data to a stream. + + write_eof() indicates end of stream. + writer can't be used after write_eof() method being called. + write() return drain future. + """ + if self._on_chunk_sent is not None: + await self._on_chunk_sent(chunk) + + if isinstance(chunk, memoryview): + if chunk.nbytes != len(chunk): + # just reshape it + chunk = chunk.cast("c") + + if self._compress is not None: + chunk = await self._compress.compress(chunk) + if not chunk: + return + + if self.length is not None: + chunk_len = len(chunk) + if self.length >= chunk_len: + self.length = self.length - chunk_len + else: + chunk = chunk[: self.length] + self.length = 0 + if not chunk: + return + + if chunk: + if self.chunked: + chunk_len_pre = ("%x\r\n" % len(chunk)).encode("ascii") + chunk = chunk_len_pre + chunk + b"\r\n" + + self._write(chunk) + + if self.buffer_size > LIMIT and drain: + self.buffer_size = 0 + await self.drain() + + async def write_headers( + self, status_line: str, headers: "CIMultiDict[str]" + ) -> None: + """Write request/response status and headers.""" + if self._on_headers_sent is not None: + await self._on_headers_sent(headers) + + # status + headers + buf = _serialize_headers(status_line, headers) + self._write(buf) + + async def write_eof(self, chunk: bytes = b"") -> None: + if self._eof: + return + + if chunk and self._on_chunk_sent is not None: + await self._on_chunk_sent(chunk) + + if self._compress: + if chunk: + chunk = await self._compress.compress(chunk) + + chunk += self._compress.flush() + if chunk and self.chunked: + chunk_len = ("%x\r\n" % len(chunk)).encode("ascii") + chunk = chunk_len + chunk + b"\r\n0\r\n\r\n" + else: + if self.chunked: + if chunk: + chunk_len = ("%x\r\n" % len(chunk)).encode("ascii") + chunk = chunk_len + chunk + b"\r\n0\r\n\r\n" + else: + chunk = b"0\r\n\r\n" + + if chunk: + self._write(chunk) + + await self.drain() + + self._eof = True + + async def drain(self) -> None: + """Flush the write buffer. + + The intended use is to write + + await w.write(data) + await w.drain() + """ + if self._protocol.transport is not None: + await self._protocol._drain_helper() + + +def _safe_header(string: str) -> str: + if "\r" in string or "\n" in string: + raise ValueError( + "Newline or carriage return detected in headers. " + "Potential header injection attack." + ) + return string + + +def _py_serialize_headers(status_line: str, headers: "CIMultiDict[str]") -> bytes: + headers_gen = (_safe_header(k) + ": " + _safe_header(v) for k, v in headers.items()) + line = status_line + "\r\n" + "\r\n".join(headers_gen) + "\r\n\r\n" + return line.encode("utf-8") + + +_serialize_headers = _py_serialize_headers + +try: + import aiohttp._http_writer as _http_writer # type: ignore[import-not-found] + + _c_serialize_headers = _http_writer._serialize_headers + if not NO_EXTENSIONS: + _serialize_headers = _c_serialize_headers +except ImportError: + pass diff --git a/env/Lib/site-packages/aiohttp/locks.py b/env/Lib/site-packages/aiohttp/locks.py new file mode 100644 index 0000000..de2dc83 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/locks.py @@ -0,0 +1,41 @@ +import asyncio +import collections +from typing import Any, Deque, Optional + + +class EventResultOrError: + """Event asyncio lock helper class. + + Wraps the Event asyncio lock allowing either to awake the + locked Tasks without any error or raising an exception. + + thanks to @vorpalsmith for the simple design. + """ + + def __init__(self, loop: asyncio.AbstractEventLoop) -> None: + self._loop = loop + self._exc: Optional[BaseException] = None + self._event = asyncio.Event() + self._waiters: Deque[asyncio.Future[Any]] = collections.deque() + + def set(self, exc: Optional[BaseException] = None) -> None: + self._exc = exc + self._event.set() + + async def wait(self) -> Any: + waiter = self._loop.create_task(self._event.wait()) + self._waiters.append(waiter) + try: + val = await waiter + finally: + self._waiters.remove(waiter) + + if self._exc is not None: + raise self._exc + + return val + + def cancel(self) -> None: + """Cancel all waiters""" + for waiter in self._waiters: + waiter.cancel() diff --git a/env/Lib/site-packages/aiohttp/log.py b/env/Lib/site-packages/aiohttp/log.py new file mode 100644 index 0000000..3cecea2 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/log.py @@ -0,0 +1,8 @@ +import logging + +access_logger = logging.getLogger("aiohttp.access") +client_logger = logging.getLogger("aiohttp.client") +internal_logger = logging.getLogger("aiohttp.internal") +server_logger = logging.getLogger("aiohttp.server") +web_logger = logging.getLogger("aiohttp.web") +ws_logger = logging.getLogger("aiohttp.websocket") diff --git a/env/Lib/site-packages/aiohttp/multipart.py b/env/Lib/site-packages/aiohttp/multipart.py new file mode 100644 index 0000000..e3680a7 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/multipart.py @@ -0,0 +1,1056 @@ +import base64 +import binascii +import json +import re +import sys +import uuid +import warnings +import zlib +from collections import deque +from types import TracebackType +from typing import ( + TYPE_CHECKING, + Any, + Deque, + Dict, + Iterator, + List, + Mapping, + Optional, + Sequence, + Tuple, + Type, + Union, + cast, +) +from urllib.parse import parse_qsl, unquote, urlencode + +from multidict import CIMultiDict, CIMultiDictProxy + +from .compression_utils import ZLibCompressor, ZLibDecompressor +from .hdrs import ( + CONTENT_DISPOSITION, + CONTENT_ENCODING, + CONTENT_LENGTH, + CONTENT_TRANSFER_ENCODING, + CONTENT_TYPE, +) +from .helpers import CHAR, TOKEN, parse_mimetype, reify +from .http import HeadersParser +from .payload import ( + JsonPayload, + LookupError, + Order, + Payload, + StringPayload, + get_payload, + payload_type, +) +from .streams import StreamReader + +if sys.version_info >= (3, 11): + from typing import Self +else: + from typing import TypeVar + + Self = TypeVar("Self", bound="BodyPartReader") + +__all__ = ( + "MultipartReader", + "MultipartWriter", + "BodyPartReader", + "BadContentDispositionHeader", + "BadContentDispositionParam", + "parse_content_disposition", + "content_disposition_filename", +) + + +if TYPE_CHECKING: + from .client_reqrep import ClientResponse + + +class BadContentDispositionHeader(RuntimeWarning): + pass + + +class BadContentDispositionParam(RuntimeWarning): + pass + + +def parse_content_disposition( + header: Optional[str], +) -> Tuple[Optional[str], Dict[str, str]]: + def is_token(string: str) -> bool: + return bool(string) and TOKEN >= set(string) + + def is_quoted(string: str) -> bool: + return string[0] == string[-1] == '"' + + def is_rfc5987(string: str) -> bool: + return is_token(string) and string.count("'") == 2 + + def is_extended_param(string: str) -> bool: + return string.endswith("*") + + def is_continuous_param(string: str) -> bool: + pos = string.find("*") + 1 + if not pos: + return False + substring = string[pos:-1] if string.endswith("*") else string[pos:] + return substring.isdigit() + + def unescape(text: str, *, chars: str = "".join(map(re.escape, CHAR))) -> str: + return re.sub(f"\\\\([{chars}])", "\\1", text) + + if not header: + return None, {} + + disptype, *parts = header.split(";") + if not is_token(disptype): + warnings.warn(BadContentDispositionHeader(header)) + return None, {} + + params: Dict[str, str] = {} + while parts: + item = parts.pop(0) + + if "=" not in item: + warnings.warn(BadContentDispositionHeader(header)) + return None, {} + + key, value = item.split("=", 1) + key = key.lower().strip() + value = value.lstrip() + + if key in params: + warnings.warn(BadContentDispositionHeader(header)) + return None, {} + + if not is_token(key): + warnings.warn(BadContentDispositionParam(item)) + continue + + elif is_continuous_param(key): + if is_quoted(value): + value = unescape(value[1:-1]) + elif not is_token(value): + warnings.warn(BadContentDispositionParam(item)) + continue + + elif is_extended_param(key): + if is_rfc5987(value): + encoding, _, value = value.split("'", 2) + encoding = encoding or "utf-8" + else: + warnings.warn(BadContentDispositionParam(item)) + continue + + try: + value = unquote(value, encoding, "strict") + except UnicodeDecodeError: # pragma: nocover + warnings.warn(BadContentDispositionParam(item)) + continue + + else: + failed = True + if is_quoted(value): + failed = False + value = unescape(value[1:-1].lstrip("\\/")) + elif is_token(value): + failed = False + elif parts: + # maybe just ; in filename, in any case this is just + # one case fix, for proper fix we need to redesign parser + _value = f"{value};{parts[0]}" + if is_quoted(_value): + parts.pop(0) + value = unescape(_value[1:-1].lstrip("\\/")) + failed = False + + if failed: + warnings.warn(BadContentDispositionHeader(header)) + return None, {} + + params[key] = value + + return disptype.lower(), params + + +def content_disposition_filename( + params: Mapping[str, str], name: str = "filename" +) -> Optional[str]: + name_suf = "%s*" % name + if not params: + return None + elif name_suf in params: + return params[name_suf] + elif name in params: + return params[name] + else: + parts = [] + fnparams = sorted( + (key, value) for key, value in params.items() if key.startswith(name_suf) + ) + for num, (key, value) in enumerate(fnparams): + _, tail = key.split("*", 1) + if tail.endswith("*"): + tail = tail[:-1] + if tail == str(num): + parts.append(value) + else: + break + if not parts: + return None + value = "".join(parts) + if "'" in value: + encoding, _, value = value.split("'", 2) + encoding = encoding or "utf-8" + return unquote(value, encoding, "strict") + return value + + +class MultipartResponseWrapper: + """Wrapper around the MultipartReader. + + It takes care about + underlying connection and close it when it needs in. + """ + + def __init__( + self, + resp: "ClientResponse", + stream: "MultipartReader", + ) -> None: + self.resp = resp + self.stream = stream + + def __aiter__(self) -> "MultipartResponseWrapper": + return self + + async def __anext__( + self, + ) -> Union["MultipartReader", "BodyPartReader"]: + part = await self.next() + if part is None: + raise StopAsyncIteration + return part + + def at_eof(self) -> bool: + """Returns True when all response data had been read.""" + return self.resp.content.at_eof() + + async def next( + self, + ) -> Optional[Union["MultipartReader", "BodyPartReader"]]: + """Emits next multipart reader object.""" + item = await self.stream.next() + if self.stream.at_eof(): + await self.release() + return item + + async def release(self) -> None: + """Release the connection gracefully. + + All remaining content is read to the void. + """ + await self.resp.release() + + +class BodyPartReader: + """Multipart reader for single body part.""" + + chunk_size = 8192 + + def __init__( + self, + boundary: bytes, + headers: "CIMultiDictProxy[str]", + content: StreamReader, + *, + subtype: str = "mixed", + default_charset: Optional[str] = None, + ) -> None: + self.headers = headers + self._boundary = boundary + self._boundary_len = len(boundary) + 2 # Boundary + \r\n + self._content = content + self._default_charset = default_charset + self._at_eof = False + self._is_form_data = subtype == "form-data" + # https://datatracker.ietf.org/doc/html/rfc7578#section-4.8 + length = None if self._is_form_data else self.headers.get(CONTENT_LENGTH, None) + self._length = int(length) if length is not None else None + self._read_bytes = 0 + self._unread: Deque[bytes] = deque() + self._prev_chunk: Optional[bytes] = None + self._content_eof = 0 + self._cache: Dict[str, Any] = {} + + def __aiter__(self: Self) -> Self: + return self + + async def __anext__(self) -> bytes: + part = await self.next() + if part is None: + raise StopAsyncIteration + return part + + async def next(self) -> Optional[bytes]: + item = await self.read() + if not item: + return None + return item + + async def read(self, *, decode: bool = False) -> bytes: + """Reads body part data. + + decode: Decodes data following by encoding + method from Content-Encoding header. If it missed + data remains untouched + """ + if self._at_eof: + return b"" + data = bytearray() + while not self._at_eof: + data.extend(await self.read_chunk(self.chunk_size)) + if decode: + return self.decode(data) + return data + + async def read_chunk(self, size: int = chunk_size) -> bytes: + """Reads body part content chunk of the specified size. + + size: chunk size + """ + if self._at_eof: + return b"" + if self._length: + chunk = await self._read_chunk_from_length(size) + else: + chunk = await self._read_chunk_from_stream(size) + + # For the case of base64 data, we must read a fragment of size with a + # remainder of 0 by dividing by 4 for string without symbols \n or \r + encoding = self.headers.get(CONTENT_TRANSFER_ENCODING) + if encoding and encoding.lower() == "base64": + stripped_chunk = b"".join(chunk.split()) + remainder = len(stripped_chunk) % 4 + + while remainder != 0 and not self.at_eof(): + over_chunk_size = 4 - remainder + over_chunk = b"" + + if self._prev_chunk: + over_chunk = self._prev_chunk[:over_chunk_size] + self._prev_chunk = self._prev_chunk[len(over_chunk) :] + + if len(over_chunk) != over_chunk_size: + over_chunk += await self._content.read(4 - len(over_chunk)) + + if not over_chunk: + self._at_eof = True + + stripped_chunk += b"".join(over_chunk.split()) + chunk += over_chunk + remainder = len(stripped_chunk) % 4 + + self._read_bytes += len(chunk) + if self._read_bytes == self._length: + self._at_eof = True + if self._at_eof: + clrf = await self._content.readline() + assert ( + b"\r\n" == clrf + ), "reader did not read all the data or it is malformed" + return chunk + + async def _read_chunk_from_length(self, size: int) -> bytes: + # Reads body part content chunk of the specified size. + # The body part must has Content-Length header with proper value. + assert self._length is not None, "Content-Length required for chunked read" + chunk_size = min(size, self._length - self._read_bytes) + chunk = await self._content.read(chunk_size) + if self._content.at_eof(): + self._at_eof = True + return chunk + + async def _read_chunk_from_stream(self, size: int) -> bytes: + # Reads content chunk of body part with unknown length. + # The Content-Length header for body part is not necessary. + assert ( + size >= self._boundary_len + ), "Chunk size must be greater or equal than boundary length + 2" + first_chunk = self._prev_chunk is None + if first_chunk: + self._prev_chunk = await self._content.read(size) + + chunk = b"" + # content.read() may return less than size, so we need to loop to ensure + # we have enough data to detect the boundary. + while len(chunk) < self._boundary_len: + chunk += await self._content.read(size) + self._content_eof += int(self._content.at_eof()) + assert self._content_eof < 3, "Reading after EOF" + if self._content_eof: + break + if len(chunk) > size: + self._content.unread_data(chunk[size:]) + chunk = chunk[:size] + + assert self._prev_chunk is not None + window = self._prev_chunk + chunk + sub = b"\r\n" + self._boundary + if first_chunk: + idx = window.find(sub) + else: + idx = window.find(sub, max(0, len(self._prev_chunk) - len(sub))) + if idx >= 0: + # pushing boundary back to content + with warnings.catch_warnings(): + warnings.filterwarnings("ignore", category=DeprecationWarning) + self._content.unread_data(window[idx:]) + if size > idx: + self._prev_chunk = self._prev_chunk[:idx] + chunk = window[len(self._prev_chunk) : idx] + if not chunk: + self._at_eof = True + result = self._prev_chunk + self._prev_chunk = chunk + return result + + async def readline(self) -> bytes: + """Reads body part by line by line.""" + if self._at_eof: + return b"" + + if self._unread: + line = self._unread.popleft() + else: + line = await self._content.readline() + + if line.startswith(self._boundary): + # the very last boundary may not come with \r\n, + # so set single rules for everyone + sline = line.rstrip(b"\r\n") + boundary = self._boundary + last_boundary = self._boundary + b"--" + # ensure that we read exactly the boundary, not something alike + if sline == boundary or sline == last_boundary: + self._at_eof = True + self._unread.append(line) + return b"" + else: + next_line = await self._content.readline() + if next_line.startswith(self._boundary): + line = line[:-2] # strip CRLF but only once + self._unread.append(next_line) + + return line + + async def release(self) -> None: + """Like read(), but reads all the data to the void.""" + if self._at_eof: + return + while not self._at_eof: + await self.read_chunk(self.chunk_size) + + async def text(self, *, encoding: Optional[str] = None) -> str: + """Like read(), but assumes that body part contains text data.""" + data = await self.read(decode=True) + # see https://www.w3.org/TR/html5/forms.html#multipart/form-data-encoding-algorithm + # and https://dvcs.w3.org/hg/xhr/raw-file/tip/Overview.html#dom-xmlhttprequest-send + encoding = encoding or self.get_charset(default="utf-8") + return data.decode(encoding) + + async def json(self, *, encoding: Optional[str] = None) -> Optional[Dict[str, Any]]: + """Like read(), but assumes that body parts contains JSON data.""" + data = await self.read(decode=True) + if not data: + return None + encoding = encoding or self.get_charset(default="utf-8") + return cast(Dict[str, Any], json.loads(data.decode(encoding))) + + async def form(self, *, encoding: Optional[str] = None) -> List[Tuple[str, str]]: + """Like read(), but assumes that body parts contain form urlencoded data.""" + data = await self.read(decode=True) + if not data: + return [] + if encoding is not None: + real_encoding = encoding + else: + real_encoding = self.get_charset(default="utf-8") + try: + decoded_data = data.rstrip().decode(real_encoding) + except UnicodeDecodeError: + raise ValueError("data cannot be decoded with %s encoding" % real_encoding) + + return parse_qsl( + decoded_data, + keep_blank_values=True, + encoding=real_encoding, + ) + + def at_eof(self) -> bool: + """Returns True if the boundary was reached or False otherwise.""" + return self._at_eof + + def decode(self, data: bytes) -> bytes: + """Decodes data. + + Decoding is done according the specified Content-Encoding + or Content-Transfer-Encoding headers value. + """ + if CONTENT_TRANSFER_ENCODING in self.headers: + data = self._decode_content_transfer(data) + # https://datatracker.ietf.org/doc/html/rfc7578#section-4.8 + if not self._is_form_data and CONTENT_ENCODING in self.headers: + return self._decode_content(data) + return data + + def _decode_content(self, data: bytes) -> bytes: + encoding = self.headers.get(CONTENT_ENCODING, "").lower() + if encoding == "identity": + return data + if encoding in {"deflate", "gzip"}: + return ZLibDecompressor( + encoding=encoding, + suppress_deflate_header=True, + ).decompress_sync(data) + + raise RuntimeError(f"unknown content encoding: {encoding}") + + def _decode_content_transfer(self, data: bytes) -> bytes: + encoding = self.headers.get(CONTENT_TRANSFER_ENCODING, "").lower() + + if encoding == "base64": + return base64.b64decode(data) + elif encoding == "quoted-printable": + return binascii.a2b_qp(data) + elif encoding in ("binary", "8bit", "7bit"): + return data + else: + raise RuntimeError( + "unknown content transfer encoding: {}" "".format(encoding) + ) + + def get_charset(self, default: str) -> str: + """Returns charset parameter from Content-Type header or default.""" + ctype = self.headers.get(CONTENT_TYPE, "") + mimetype = parse_mimetype(ctype) + return mimetype.parameters.get("charset", self._default_charset or default) + + @reify + def name(self) -> Optional[str]: + """Returns name specified in Content-Disposition header. + + If the header is missing or malformed, returns None. + """ + _, params = parse_content_disposition(self.headers.get(CONTENT_DISPOSITION)) + return content_disposition_filename(params, "name") + + @reify + def filename(self) -> Optional[str]: + """Returns filename specified in Content-Disposition header. + + Returns None if the header is missing or malformed. + """ + _, params = parse_content_disposition(self.headers.get(CONTENT_DISPOSITION)) + return content_disposition_filename(params, "filename") + + +@payload_type(BodyPartReader, order=Order.try_first) +class BodyPartReaderPayload(Payload): + def __init__(self, value: BodyPartReader, *args: Any, **kwargs: Any) -> None: + super().__init__(value, *args, **kwargs) + + params: Dict[str, str] = {} + if value.name is not None: + params["name"] = value.name + if value.filename is not None: + params["filename"] = value.filename + + if params: + self.set_content_disposition("attachment", True, **params) + + async def write(self, writer: Any) -> None: + field = self._value + chunk = await field.read_chunk(size=2**16) + while chunk: + await writer.write(field.decode(chunk)) + chunk = await field.read_chunk(size=2**16) + + +class MultipartReader: + """Multipart body reader.""" + + #: Response wrapper, used when multipart readers constructs from response. + response_wrapper_cls = MultipartResponseWrapper + #: Multipart reader class, used to handle multipart/* body parts. + #: None points to type(self) + multipart_reader_cls: Optional[Type["MultipartReader"]] = None + #: Body part reader class for non multipart/* content types. + part_reader_cls = BodyPartReader + + def __init__(self, headers: Mapping[str, str], content: StreamReader) -> None: + self._mimetype = parse_mimetype(headers[CONTENT_TYPE]) + assert self._mimetype.type == "multipart", "multipart/* content type expected" + if "boundary" not in self._mimetype.parameters: + raise ValueError( + "boundary missed for Content-Type: %s" % headers[CONTENT_TYPE] + ) + + self.headers = headers + self._boundary = ("--" + self._get_boundary()).encode() + self._content = content + self._default_charset: Optional[str] = None + self._last_part: Optional[Union["MultipartReader", BodyPartReader]] = None + self._at_eof = False + self._at_bof = True + self._unread: List[bytes] = [] + + def __aiter__(self: Self) -> Self: + return self + + async def __anext__( + self, + ) -> Optional[Union["MultipartReader", BodyPartReader]]: + part = await self.next() + if part is None: + raise StopAsyncIteration + return part + + @classmethod + def from_response( + cls, + response: "ClientResponse", + ) -> MultipartResponseWrapper: + """Constructs reader instance from HTTP response. + + :param response: :class:`~aiohttp.client.ClientResponse` instance + """ + obj = cls.response_wrapper_cls( + response, cls(response.headers, response.content) + ) + return obj + + def at_eof(self) -> bool: + """Returns True if the final boundary was reached, false otherwise.""" + return self._at_eof + + async def next( + self, + ) -> Optional[Union["MultipartReader", BodyPartReader]]: + """Emits the next multipart body part.""" + # So, if we're at BOF, we need to skip till the boundary. + if self._at_eof: + return None + await self._maybe_release_last_part() + if self._at_bof: + await self._read_until_first_boundary() + self._at_bof = False + else: + await self._read_boundary() + if self._at_eof: # we just read the last boundary, nothing to do there + return None + + part = await self.fetch_next_part() + # https://datatracker.ietf.org/doc/html/rfc7578#section-4.6 + if ( + self._last_part is None + and self._mimetype.subtype == "form-data" + and isinstance(part, BodyPartReader) + ): + _, params = parse_content_disposition(part.headers.get(CONTENT_DISPOSITION)) + if params.get("name") == "_charset_": + # Longest encoding in https://encoding.spec.whatwg.org/encodings.json + # is 19 characters, so 32 should be more than enough for any valid encoding. + charset = await part.read_chunk(32) + if len(charset) > 31: + raise RuntimeError("Invalid default charset") + self._default_charset = charset.strip().decode() + part = await self.fetch_next_part() + self._last_part = part + return self._last_part + + async def release(self) -> None: + """Reads all the body parts to the void till the final boundary.""" + while not self._at_eof: + item = await self.next() + if item is None: + break + await item.release() + + async def fetch_next_part( + self, + ) -> Union["MultipartReader", BodyPartReader]: + """Returns the next body part reader.""" + headers = await self._read_headers() + return self._get_part_reader(headers) + + def _get_part_reader( + self, + headers: "CIMultiDictProxy[str]", + ) -> Union["MultipartReader", BodyPartReader]: + """Dispatches the response by the `Content-Type` header. + + Returns a suitable reader instance. + + :param dict headers: Response headers + """ + ctype = headers.get(CONTENT_TYPE, "") + mimetype = parse_mimetype(ctype) + + if mimetype.type == "multipart": + if self.multipart_reader_cls is None: + return type(self)(headers, self._content) + return self.multipart_reader_cls(headers, self._content) + else: + return self.part_reader_cls( + self._boundary, + headers, + self._content, + subtype=self._mimetype.subtype, + default_charset=self._default_charset, + ) + + def _get_boundary(self) -> str: + boundary = self._mimetype.parameters["boundary"] + if len(boundary) > 70: + raise ValueError("boundary %r is too long (70 chars max)" % boundary) + + return boundary + + async def _readline(self) -> bytes: + if self._unread: + return self._unread.pop() + return await self._content.readline() + + async def _read_until_first_boundary(self) -> None: + while True: + chunk = await self._readline() + if chunk == b"": + raise ValueError( + "Could not find starting boundary %r" % (self._boundary) + ) + chunk = chunk.rstrip() + if chunk == self._boundary: + return + elif chunk == self._boundary + b"--": + self._at_eof = True + return + + async def _read_boundary(self) -> None: + chunk = (await self._readline()).rstrip() + if chunk == self._boundary: + pass + elif chunk == self._boundary + b"--": + self._at_eof = True + epilogue = await self._readline() + next_line = await self._readline() + + # the epilogue is expected and then either the end of input or the + # parent multipart boundary, if the parent boundary is found then + # it should be marked as unread and handed to the parent for + # processing + if next_line[:2] == b"--": + self._unread.append(next_line) + # otherwise the request is likely missing an epilogue and both + # lines should be passed to the parent for processing + # (this handles the old behavior gracefully) + else: + self._unread.extend([next_line, epilogue]) + else: + raise ValueError(f"Invalid boundary {chunk!r}, expected {self._boundary!r}") + + async def _read_headers(self) -> "CIMultiDictProxy[str]": + lines = [b""] + while True: + chunk = await self._content.readline() + chunk = chunk.strip() + lines.append(chunk) + if not chunk: + break + parser = HeadersParser() + headers, raw_headers = parser.parse_headers(lines) + return headers + + async def _maybe_release_last_part(self) -> None: + """Ensures that the last read body part is read completely.""" + if self._last_part is not None: + if not self._last_part.at_eof(): + await self._last_part.release() + self._unread.extend(self._last_part._unread) + self._last_part = None + + +_Part = Tuple[Payload, str, str] + + +class MultipartWriter(Payload): + """Multipart body writer.""" + + def __init__(self, subtype: str = "mixed", boundary: Optional[str] = None) -> None: + boundary = boundary if boundary is not None else uuid.uuid4().hex + # The underlying Payload API demands a str (utf-8), not bytes, + # so we need to ensure we don't lose anything during conversion. + # As a result, require the boundary to be ASCII only. + # In both situations. + + try: + self._boundary = boundary.encode("ascii") + except UnicodeEncodeError: + raise ValueError("boundary should contain ASCII only chars") from None + ctype = f"multipart/{subtype}; boundary={self._boundary_value}" + + super().__init__(None, content_type=ctype) + + self._parts: List[_Part] = [] + self._is_form_data = subtype == "form-data" + + def __enter__(self) -> "MultipartWriter": + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> None: + pass + + def __iter__(self) -> Iterator[_Part]: + return iter(self._parts) + + def __len__(self) -> int: + return len(self._parts) + + def __bool__(self) -> bool: + return True + + _valid_tchar_regex = re.compile(rb"\A[!#$%&'*+\-.^_`|~\w]+\Z") + _invalid_qdtext_char_regex = re.compile(rb"[\x00-\x08\x0A-\x1F\x7F]") + + @property + def _boundary_value(self) -> str: + """Wrap boundary parameter value in quotes, if necessary. + + Reads self.boundary and returns a unicode string. + """ + # Refer to RFCs 7231, 7230, 5234. + # + # parameter = token "=" ( token / quoted-string ) + # token = 1*tchar + # quoted-string = DQUOTE *( qdtext / quoted-pair ) DQUOTE + # qdtext = HTAB / SP / %x21 / %x23-5B / %x5D-7E / obs-text + # obs-text = %x80-FF + # quoted-pair = "\" ( HTAB / SP / VCHAR / obs-text ) + # tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" + # / "+" / "-" / "." / "^" / "_" / "`" / "|" / "~" + # / DIGIT / ALPHA + # ; any VCHAR, except delimiters + # VCHAR = %x21-7E + value = self._boundary + if re.match(self._valid_tchar_regex, value): + return value.decode("ascii") # cannot fail + + if re.search(self._invalid_qdtext_char_regex, value): + raise ValueError("boundary value contains invalid characters") + + # escape %x5C and %x22 + quoted_value_content = value.replace(b"\\", b"\\\\") + quoted_value_content = quoted_value_content.replace(b'"', b'\\"') + + return '"' + quoted_value_content.decode("ascii") + '"' + + @property + def boundary(self) -> str: + return self._boundary.decode("ascii") + + def append(self, obj: Any, headers: Optional[Mapping[str, str]] = None) -> Payload: + if headers is None: + headers = CIMultiDict() + + if isinstance(obj, Payload): + obj.headers.update(headers) + return self.append_payload(obj) + else: + try: + payload = get_payload(obj, headers=headers) + except LookupError: + raise TypeError("Cannot create payload from %r" % obj) + else: + return self.append_payload(payload) + + def append_payload(self, payload: Payload) -> Payload: + """Adds a new body part to multipart writer.""" + encoding: Optional[str] = None + te_encoding: Optional[str] = None + if self._is_form_data: + # https://datatracker.ietf.org/doc/html/rfc7578#section-4.7 + # https://datatracker.ietf.org/doc/html/rfc7578#section-4.8 + assert ( + not {CONTENT_ENCODING, CONTENT_LENGTH, CONTENT_TRANSFER_ENCODING} + & payload.headers.keys() + ) + # Set default Content-Disposition in case user doesn't create one + if CONTENT_DISPOSITION not in payload.headers: + name = f"section-{len(self._parts)}" + payload.set_content_disposition("form-data", name=name) + else: + # compression + encoding = payload.headers.get(CONTENT_ENCODING, "").lower() + if encoding and encoding not in ("deflate", "gzip", "identity"): + raise RuntimeError(f"unknown content encoding: {encoding}") + if encoding == "identity": + encoding = None + + # te encoding + te_encoding = payload.headers.get(CONTENT_TRANSFER_ENCODING, "").lower() + if te_encoding not in ("", "base64", "quoted-printable", "binary"): + raise RuntimeError(f"unknown content transfer encoding: {te_encoding}") + if te_encoding == "binary": + te_encoding = None + + # size + size = payload.size + if size is not None and not (encoding or te_encoding): + payload.headers[CONTENT_LENGTH] = str(size) + + self._parts.append((payload, encoding, te_encoding)) # type: ignore[arg-type] + return payload + + def append_json( + self, obj: Any, headers: Optional[Mapping[str, str]] = None + ) -> Payload: + """Helper to append JSON part.""" + if headers is None: + headers = CIMultiDict() + + return self.append_payload(JsonPayload(obj, headers=headers)) + + def append_form( + self, + obj: Union[Sequence[Tuple[str, str]], Mapping[str, str]], + headers: Optional[Mapping[str, str]] = None, + ) -> Payload: + """Helper to append form urlencoded part.""" + assert isinstance(obj, (Sequence, Mapping)) + + if headers is None: + headers = CIMultiDict() + + if isinstance(obj, Mapping): + obj = list(obj.items()) + data = urlencode(obj, doseq=True) + + return self.append_payload( + StringPayload( + data, headers=headers, content_type="application/x-www-form-urlencoded" + ) + ) + + @property + def size(self) -> Optional[int]: + """Size of the payload.""" + total = 0 + for part, encoding, te_encoding in self._parts: + if encoding or te_encoding or part.size is None: + return None + + total += int( + 2 + + len(self._boundary) + + 2 + + part.size # b'--'+self._boundary+b'\r\n' + + len(part._binary_headers) + + 2 # b'\r\n' + ) + + total += 2 + len(self._boundary) + 4 # b'--'+self._boundary+b'--\r\n' + return total + + async def write(self, writer: Any, close_boundary: bool = True) -> None: + """Write body.""" + for part, encoding, te_encoding in self._parts: + if self._is_form_data: + # https://datatracker.ietf.org/doc/html/rfc7578#section-4.2 + assert CONTENT_DISPOSITION in part.headers + assert "name=" in part.headers[CONTENT_DISPOSITION] + + await writer.write(b"--" + self._boundary + b"\r\n") + await writer.write(part._binary_headers) + + if encoding or te_encoding: + w = MultipartPayloadWriter(writer) + if encoding: + w.enable_compression(encoding) + if te_encoding: + w.enable_encoding(te_encoding) + await part.write(w) # type: ignore[arg-type] + await w.write_eof() + else: + await part.write(writer) + + await writer.write(b"\r\n") + + if close_boundary: + await writer.write(b"--" + self._boundary + b"--\r\n") + + +class MultipartPayloadWriter: + def __init__(self, writer: Any) -> None: + self._writer = writer + self._encoding: Optional[str] = None + self._compress: Optional[ZLibCompressor] = None + self._encoding_buffer: Optional[bytearray] = None + + def enable_encoding(self, encoding: str) -> None: + if encoding == "base64": + self._encoding = encoding + self._encoding_buffer = bytearray() + elif encoding == "quoted-printable": + self._encoding = "quoted-printable" + + def enable_compression( + self, encoding: str = "deflate", strategy: int = zlib.Z_DEFAULT_STRATEGY + ) -> None: + self._compress = ZLibCompressor( + encoding=encoding, + suppress_deflate_header=True, + strategy=strategy, + ) + + async def write_eof(self) -> None: + if self._compress is not None: + chunk = self._compress.flush() + if chunk: + self._compress = None + await self.write(chunk) + + if self._encoding == "base64": + if self._encoding_buffer: + await self._writer.write(base64.b64encode(self._encoding_buffer)) + + async def write(self, chunk: bytes) -> None: + if self._compress is not None: + if chunk: + chunk = await self._compress.compress(chunk) + if not chunk: + return + + if self._encoding == "base64": + buf = self._encoding_buffer + assert buf is not None + buf.extend(chunk) + + if buf: + div, mod = divmod(len(buf), 3) + enc_chunk, self._encoding_buffer = (buf[: div * 3], buf[div * 3 :]) + if enc_chunk: + b64chunk = base64.b64encode(enc_chunk) + await self._writer.write(b64chunk) + elif self._encoding == "quoted-printable": + await self._writer.write(binascii.b2a_qp(chunk)) + else: + await self._writer.write(chunk) diff --git a/env/Lib/site-packages/aiohttp/payload.py b/env/Lib/site-packages/aiohttp/payload.py new file mode 100644 index 0000000..5271393 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/payload.py @@ -0,0 +1,464 @@ +import asyncio +import enum +import io +import json +import mimetypes +import os +import warnings +from abc import ABC, abstractmethod +from itertools import chain +from typing import ( + IO, + TYPE_CHECKING, + Any, + Dict, + Final, + Iterable, + Optional, + TextIO, + Tuple, + Type, + Union, +) + +from multidict import CIMultiDict + +from . import hdrs +from .abc import AbstractStreamWriter +from .helpers import ( + _SENTINEL, + content_disposition_header, + guess_filename, + parse_mimetype, + sentinel, +) +from .streams import StreamReader +from .typedefs import JSONEncoder, _CIMultiDict + +__all__ = ( + "PAYLOAD_REGISTRY", + "get_payload", + "payload_type", + "Payload", + "BytesPayload", + "StringPayload", + "IOBasePayload", + "BytesIOPayload", + "BufferedReaderPayload", + "TextIOPayload", + "StringIOPayload", + "JsonPayload", + "AsyncIterablePayload", +) + +TOO_LARGE_BYTES_BODY: Final[int] = 2**20 # 1 MB + +if TYPE_CHECKING: + from typing import List + + +class LookupError(Exception): + pass + + +class Order(str, enum.Enum): + normal = "normal" + try_first = "try_first" + try_last = "try_last" + + +def get_payload(data: Any, *args: Any, **kwargs: Any) -> "Payload": + return PAYLOAD_REGISTRY.get(data, *args, **kwargs) + + +def register_payload( + factory: Type["Payload"], type: Any, *, order: Order = Order.normal +) -> None: + PAYLOAD_REGISTRY.register(factory, type, order=order) + + +class payload_type: + def __init__(self, type: Any, *, order: Order = Order.normal) -> None: + self.type = type + self.order = order + + def __call__(self, factory: Type["Payload"]) -> Type["Payload"]: + register_payload(factory, self.type, order=self.order) + return factory + + +PayloadType = Type["Payload"] +_PayloadRegistryItem = Tuple[PayloadType, Any] + + +class PayloadRegistry: + """Payload registry. + + note: we need zope.interface for more efficient adapter search + """ + + def __init__(self) -> None: + self._first: List[_PayloadRegistryItem] = [] + self._normal: List[_PayloadRegistryItem] = [] + self._last: List[_PayloadRegistryItem] = [] + + def get( + self, + data: Any, + *args: Any, + _CHAIN: "Type[chain[_PayloadRegistryItem]]" = chain, + **kwargs: Any, + ) -> "Payload": + if isinstance(data, Payload): + return data + for factory, type in _CHAIN(self._first, self._normal, self._last): + if isinstance(data, type): + return factory(data, *args, **kwargs) + + raise LookupError() + + def register( + self, factory: PayloadType, type: Any, *, order: Order = Order.normal + ) -> None: + if order is Order.try_first: + self._first.append((factory, type)) + elif order is Order.normal: + self._normal.append((factory, type)) + elif order is Order.try_last: + self._last.append((factory, type)) + else: + raise ValueError(f"Unsupported order {order!r}") + + +class Payload(ABC): + + _default_content_type: str = "application/octet-stream" + _size: Optional[int] = None + + def __init__( + self, + value: Any, + headers: Optional[ + Union[_CIMultiDict, Dict[str, str], Iterable[Tuple[str, str]]] + ] = None, + content_type: Union[str, None, _SENTINEL] = sentinel, + filename: Optional[str] = None, + encoding: Optional[str] = None, + **kwargs: Any, + ) -> None: + self._encoding = encoding + self._filename = filename + self._headers: _CIMultiDict = CIMultiDict() + self._value = value + if content_type is not sentinel and content_type is not None: + self._headers[hdrs.CONTENT_TYPE] = content_type + elif self._filename is not None: + content_type = mimetypes.guess_type(self._filename)[0] + if content_type is None: + content_type = self._default_content_type + self._headers[hdrs.CONTENT_TYPE] = content_type + else: + self._headers[hdrs.CONTENT_TYPE] = self._default_content_type + self._headers.update(headers or {}) + + @property + def size(self) -> Optional[int]: + """Size of the payload.""" + return self._size + + @property + def filename(self) -> Optional[str]: + """Filename of the payload.""" + return self._filename + + @property + def headers(self) -> _CIMultiDict: + """Custom item headers""" + return self._headers + + @property + def _binary_headers(self) -> bytes: + return ( + "".join([k + ": " + v + "\r\n" for k, v in self.headers.items()]).encode( + "utf-8" + ) + + b"\r\n" + ) + + @property + def encoding(self) -> Optional[str]: + """Payload encoding""" + return self._encoding + + @property + def content_type(self) -> str: + """Content type""" + return self._headers[hdrs.CONTENT_TYPE] + + def set_content_disposition( + self, + disptype: str, + quote_fields: bool = True, + _charset: str = "utf-8", + **params: Any, + ) -> None: + """Sets ``Content-Disposition`` header.""" + self._headers[hdrs.CONTENT_DISPOSITION] = content_disposition_header( + disptype, quote_fields=quote_fields, _charset=_charset, **params + ) + + @abstractmethod + async def write(self, writer: AbstractStreamWriter) -> None: + """Write payload. + + writer is an AbstractStreamWriter instance: + """ + + +class BytesPayload(Payload): + def __init__( + self, value: Union[bytes, bytearray, memoryview], *args: Any, **kwargs: Any + ) -> None: + if not isinstance(value, (bytes, bytearray, memoryview)): + raise TypeError(f"value argument must be byte-ish, not {type(value)!r}") + + if "content_type" not in kwargs: + kwargs["content_type"] = "application/octet-stream" + + super().__init__(value, *args, **kwargs) + + if isinstance(value, memoryview): + self._size = value.nbytes + else: + self._size = len(value) + + if self._size > TOO_LARGE_BYTES_BODY: + kwargs = {"source": self} + warnings.warn( + "Sending a large body directly with raw bytes might" + " lock the event loop. You should probably pass an " + "io.BytesIO object instead", + ResourceWarning, + **kwargs, + ) + + async def write(self, writer: AbstractStreamWriter) -> None: + await writer.write(self._value) + + +class StringPayload(BytesPayload): + def __init__( + self, + value: str, + *args: Any, + encoding: Optional[str] = None, + content_type: Optional[str] = None, + **kwargs: Any, + ) -> None: + + if encoding is None: + if content_type is None: + real_encoding = "utf-8" + content_type = "text/plain; charset=utf-8" + else: + mimetype = parse_mimetype(content_type) + real_encoding = mimetype.parameters.get("charset", "utf-8") + else: + if content_type is None: + content_type = "text/plain; charset=%s" % encoding + real_encoding = encoding + + super().__init__( + value.encode(real_encoding), + encoding=real_encoding, + content_type=content_type, + *args, + **kwargs, + ) + + +class StringIOPayload(StringPayload): + def __init__(self, value: IO[str], *args: Any, **kwargs: Any) -> None: + super().__init__(value.read(), *args, **kwargs) + + +class IOBasePayload(Payload): + _value: IO[Any] + + def __init__( + self, value: IO[Any], disposition: str = "attachment", *args: Any, **kwargs: Any + ) -> None: + if "filename" not in kwargs: + kwargs["filename"] = guess_filename(value) + + super().__init__(value, *args, **kwargs) + + if self._filename is not None and disposition is not None: + if hdrs.CONTENT_DISPOSITION not in self.headers: + self.set_content_disposition(disposition, filename=self._filename) + + async def write(self, writer: AbstractStreamWriter) -> None: + loop = asyncio.get_event_loop() + try: + chunk = await loop.run_in_executor(None, self._value.read, 2**16) + while chunk: + await writer.write(chunk) + chunk = await loop.run_in_executor(None, self._value.read, 2**16) + finally: + await loop.run_in_executor(None, self._value.close) + + +class TextIOPayload(IOBasePayload): + _value: TextIO + + def __init__( + self, + value: TextIO, + *args: Any, + encoding: Optional[str] = None, + content_type: Optional[str] = None, + **kwargs: Any, + ) -> None: + + if encoding is None: + if content_type is None: + encoding = "utf-8" + content_type = "text/plain; charset=utf-8" + else: + mimetype = parse_mimetype(content_type) + encoding = mimetype.parameters.get("charset", "utf-8") + else: + if content_type is None: + content_type = "text/plain; charset=%s" % encoding + + super().__init__( + value, + content_type=content_type, + encoding=encoding, + *args, + **kwargs, + ) + + @property + def size(self) -> Optional[int]: + try: + return os.fstat(self._value.fileno()).st_size - self._value.tell() + except OSError: + return None + + async def write(self, writer: AbstractStreamWriter) -> None: + loop = asyncio.get_event_loop() + try: + chunk = await loop.run_in_executor(None, self._value.read, 2**16) + while chunk: + data = ( + chunk.encode(encoding=self._encoding) + if self._encoding + else chunk.encode() + ) + await writer.write(data) + chunk = await loop.run_in_executor(None, self._value.read, 2**16) + finally: + await loop.run_in_executor(None, self._value.close) + + +class BytesIOPayload(IOBasePayload): + @property + def size(self) -> int: + position = self._value.tell() + end = self._value.seek(0, os.SEEK_END) + self._value.seek(position) + return end - position + + +class BufferedReaderPayload(IOBasePayload): + @property + def size(self) -> Optional[int]: + try: + return os.fstat(self._value.fileno()).st_size - self._value.tell() + except OSError: + # data.fileno() is not supported, e.g. + # io.BufferedReader(io.BytesIO(b'data')) + return None + + +class JsonPayload(BytesPayload): + def __init__( + self, + value: Any, + encoding: str = "utf-8", + content_type: str = "application/json", + dumps: JSONEncoder = json.dumps, + *args: Any, + **kwargs: Any, + ) -> None: + + super().__init__( + dumps(value).encode(encoding), + content_type=content_type, + encoding=encoding, + *args, + **kwargs, + ) + + +if TYPE_CHECKING: + from typing import AsyncIterable, AsyncIterator + + _AsyncIterator = AsyncIterator[bytes] + _AsyncIterable = AsyncIterable[bytes] +else: + from collections.abc import AsyncIterable, AsyncIterator + + _AsyncIterator = AsyncIterator + _AsyncIterable = AsyncIterable + + +class AsyncIterablePayload(Payload): + + _iter: Optional[_AsyncIterator] = None + + def __init__(self, value: _AsyncIterable, *args: Any, **kwargs: Any) -> None: + if not isinstance(value, AsyncIterable): + raise TypeError( + "value argument must support " + "collections.abc.AsyncIterable interface, " + "got {!r}".format(type(value)) + ) + + if "content_type" not in kwargs: + kwargs["content_type"] = "application/octet-stream" + + super().__init__(value, *args, **kwargs) + + self._iter = value.__aiter__() + + async def write(self, writer: AbstractStreamWriter) -> None: + if self._iter: + try: + # iter is not None check prevents rare cases + # when the case iterable is used twice + while True: + chunk = await self._iter.__anext__() + await writer.write(chunk) + except StopAsyncIteration: + self._iter = None + + +class StreamReaderPayload(AsyncIterablePayload): + def __init__(self, value: StreamReader, *args: Any, **kwargs: Any) -> None: + super().__init__(value.iter_any(), *args, **kwargs) + + +PAYLOAD_REGISTRY = PayloadRegistry() +PAYLOAD_REGISTRY.register(BytesPayload, (bytes, bytearray, memoryview)) +PAYLOAD_REGISTRY.register(StringPayload, str) +PAYLOAD_REGISTRY.register(StringIOPayload, io.StringIO) +PAYLOAD_REGISTRY.register(TextIOPayload, io.TextIOBase) +PAYLOAD_REGISTRY.register(BytesIOPayload, io.BytesIO) +PAYLOAD_REGISTRY.register(BufferedReaderPayload, (io.BufferedReader, io.BufferedRandom)) +PAYLOAD_REGISTRY.register(IOBasePayload, io.IOBase) +PAYLOAD_REGISTRY.register(StreamReaderPayload, StreamReader) +# try_last for giving a chance to more specialized async interables like +# multidict.BodyPartReaderPayload override the default +PAYLOAD_REGISTRY.register(AsyncIterablePayload, AsyncIterable, order=Order.try_last) diff --git a/env/Lib/site-packages/aiohttp/payload_streamer.py b/env/Lib/site-packages/aiohttp/payload_streamer.py new file mode 100644 index 0000000..364f763 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/payload_streamer.py @@ -0,0 +1,75 @@ +""" +Payload implementation for coroutines as data provider. + +As a simple case, you can upload data from file:: + + @aiohttp.streamer + async def file_sender(writer, file_name=None): + with open(file_name, 'rb') as f: + chunk = f.read(2**16) + while chunk: + await writer.write(chunk) + + chunk = f.read(2**16) + +Then you can use `file_sender` like this: + + async with session.post('http://httpbin.org/post', + data=file_sender(file_name='huge_file')) as resp: + print(await resp.text()) + +..note:: Coroutine must accept `writer` as first argument + +""" + +import types +import warnings +from typing import Any, Awaitable, Callable, Dict, Tuple + +from .abc import AbstractStreamWriter +from .payload import Payload, payload_type + +__all__ = ("streamer",) + + +class _stream_wrapper: + def __init__( + self, + coro: Callable[..., Awaitable[None]], + args: Tuple[Any, ...], + kwargs: Dict[str, Any], + ) -> None: + self.coro = types.coroutine(coro) + self.args = args + self.kwargs = kwargs + + async def __call__(self, writer: AbstractStreamWriter) -> None: + await self.coro(writer, *self.args, **self.kwargs) + + +class streamer: + def __init__(self, coro: Callable[..., Awaitable[None]]) -> None: + warnings.warn( + "@streamer is deprecated, use async generators instead", + DeprecationWarning, + stacklevel=2, + ) + self.coro = coro + + def __call__(self, *args: Any, **kwargs: Any) -> _stream_wrapper: + return _stream_wrapper(self.coro, args, kwargs) + + +@payload_type(_stream_wrapper) +class StreamWrapperPayload(Payload): + async def write(self, writer: AbstractStreamWriter) -> None: + await self._value(writer) + + +@payload_type(streamer) +class StreamPayload(StreamWrapperPayload): + def __init__(self, value: Any, *args: Any, **kwargs: Any) -> None: + super().__init__(value(), *args, **kwargs) + + async def write(self, writer: AbstractStreamWriter) -> None: + await self._value(writer) diff --git a/env/Lib/site-packages/aiohttp/py.typed b/env/Lib/site-packages/aiohttp/py.typed new file mode 100644 index 0000000..f5642f7 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/py.typed @@ -0,0 +1 @@ +Marker diff --git a/env/Lib/site-packages/aiohttp/pytest_plugin.py b/env/Lib/site-packages/aiohttp/pytest_plugin.py new file mode 100644 index 0000000..c862b40 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/pytest_plugin.py @@ -0,0 +1,407 @@ +import asyncio +import contextlib +import inspect +import warnings +from typing import ( + Any, + Awaitable, + Callable, + Dict, + Iterator, + Optional, + Protocol, + Type, + Union, +) + +import pytest + +from aiohttp.web import Application + +from .test_utils import ( + BaseTestServer, + RawTestServer, + TestClient, + TestServer, + loop_context, + setup_test_loop, + teardown_test_loop, + unused_port as _unused_port, +) + +try: + import uvloop +except ImportError: # pragma: no cover + uvloop = None # type: ignore[assignment] + +AiohttpRawServer = Callable[[Application], Awaitable[RawTestServer]] + + +class AiohttpClient(Protocol): + def __call__( + self, + __param: Union[Application, BaseTestServer], + *, + server_kwargs: Optional[Dict[str, Any]] = None, + **kwargs: Any + ) -> Awaitable[TestClient]: ... + + +class AiohttpServer(Protocol): + def __call__( + self, app: Application, *, port: Optional[int] = None, **kwargs: Any + ) -> Awaitable[TestServer]: ... + + +def pytest_addoption(parser): # type: ignore[no-untyped-def] + parser.addoption( + "--aiohttp-fast", + action="store_true", + default=False, + help="run tests faster by disabling extra checks", + ) + parser.addoption( + "--aiohttp-loop", + action="store", + default="pyloop", + help="run tests with specific loop: pyloop, uvloop or all", + ) + parser.addoption( + "--aiohttp-enable-loop-debug", + action="store_true", + default=False, + help="enable event loop debug mode", + ) + + +def pytest_fixture_setup(fixturedef): # type: ignore[no-untyped-def] + """Set up pytest fixture. + + Allow fixtures to be coroutines. Run coroutine fixtures in an event loop. + """ + func = fixturedef.func + + if inspect.isasyncgenfunction(func): + # async generator fixture + is_async_gen = True + elif asyncio.iscoroutinefunction(func): + # regular async fixture + is_async_gen = False + else: + # not an async fixture, nothing to do + return + + strip_request = False + if "request" not in fixturedef.argnames: + fixturedef.argnames += ("request",) + strip_request = True + + def wrapper(*args, **kwargs): # type: ignore[no-untyped-def] + request = kwargs["request"] + if strip_request: + del kwargs["request"] + + # if neither the fixture nor the test use the 'loop' fixture, + # 'getfixturevalue' will fail because the test is not parameterized + # (this can be removed someday if 'loop' is no longer parameterized) + if "loop" not in request.fixturenames: + raise Exception( + "Asynchronous fixtures must depend on the 'loop' fixture or " + "be used in tests depending from it." + ) + + _loop = request.getfixturevalue("loop") + + if is_async_gen: + # for async generators, we need to advance the generator once, + # then advance it again in a finalizer + gen = func(*args, **kwargs) + + def finalizer(): # type: ignore[no-untyped-def] + try: + return _loop.run_until_complete(gen.__anext__()) + except StopAsyncIteration: + pass + + request.addfinalizer(finalizer) + return _loop.run_until_complete(gen.__anext__()) + else: + return _loop.run_until_complete(func(*args, **kwargs)) + + fixturedef.func = wrapper + + +@pytest.fixture +def fast(request): # type: ignore[no-untyped-def] + """--fast config option""" + return request.config.getoption("--aiohttp-fast") + + +@pytest.fixture +def loop_debug(request): # type: ignore[no-untyped-def] + """--enable-loop-debug config option""" + return request.config.getoption("--aiohttp-enable-loop-debug") + + +@contextlib.contextmanager +def _runtime_warning_context(): # type: ignore[no-untyped-def] + """Context manager which checks for RuntimeWarnings. + + This exists specifically to + avoid "coroutine 'X' was never awaited" warnings being missed. + + If RuntimeWarnings occur in the context a RuntimeError is raised. + """ + with warnings.catch_warnings(record=True) as _warnings: + yield + rw = [ + "{w.filename}:{w.lineno}:{w.message}".format(w=w) + for w in _warnings + if w.category == RuntimeWarning + ] + if rw: + raise RuntimeError( + "{} Runtime Warning{},\n{}".format( + len(rw), "" if len(rw) == 1 else "s", "\n".join(rw) + ) + ) + + +@contextlib.contextmanager +def _passthrough_loop_context(loop, fast=False): # type: ignore[no-untyped-def] + """Passthrough loop context. + + Sets up and tears down a loop unless one is passed in via the loop + argument when it's passed straight through. + """ + if loop: + # loop already exists, pass it straight through + yield loop + else: + # this shadows loop_context's standard behavior + loop = setup_test_loop() + yield loop + teardown_test_loop(loop, fast=fast) + + +def pytest_pycollect_makeitem(collector, name, obj): # type: ignore[no-untyped-def] + """Fix pytest collecting for coroutines.""" + if collector.funcnamefilter(name) and asyncio.iscoroutinefunction(obj): + return list(collector._genfunctions(name, obj)) + + +def pytest_pyfunc_call(pyfuncitem): # type: ignore[no-untyped-def] + """Run coroutines in an event loop instead of a normal function call.""" + fast = pyfuncitem.config.getoption("--aiohttp-fast") + if asyncio.iscoroutinefunction(pyfuncitem.function): + existing_loop = pyfuncitem.funcargs.get( + "proactor_loop" + ) or pyfuncitem.funcargs.get("loop", None) + with _runtime_warning_context(): + with _passthrough_loop_context(existing_loop, fast=fast) as _loop: + testargs = { + arg: pyfuncitem.funcargs[arg] + for arg in pyfuncitem._fixtureinfo.argnames + } + _loop.run_until_complete(pyfuncitem.obj(**testargs)) + + return True + + +def pytest_generate_tests(metafunc): # type: ignore[no-untyped-def] + if "loop_factory" not in metafunc.fixturenames: + return + + loops = metafunc.config.option.aiohttp_loop + avail_factories: Dict[str, Type[asyncio.AbstractEventLoopPolicy]] + avail_factories = {"pyloop": asyncio.DefaultEventLoopPolicy} + + if uvloop is not None: # pragma: no cover + avail_factories["uvloop"] = uvloop.EventLoopPolicy + + if loops == "all": + loops = "pyloop,uvloop?" + + factories = {} # type: ignore[var-annotated] + for name in loops.split(","): + required = not name.endswith("?") + name = name.strip(" ?") + if name not in avail_factories: # pragma: no cover + if required: + raise ValueError( + "Unknown loop '%s', available loops: %s" + % (name, list(factories.keys())) + ) + else: + continue + factories[name] = avail_factories[name] + metafunc.parametrize( + "loop_factory", list(factories.values()), ids=list(factories.keys()) + ) + + +@pytest.fixture +def loop(loop_factory, fast, loop_debug): # type: ignore[no-untyped-def] + """Return an instance of the event loop.""" + policy = loop_factory() + asyncio.set_event_loop_policy(policy) + with loop_context(fast=fast) as _loop: + if loop_debug: + _loop.set_debug(True) # pragma: no cover + asyncio.set_event_loop(_loop) + yield _loop + + +@pytest.fixture +def proactor_loop(): # type: ignore[no-untyped-def] + policy = asyncio.WindowsProactorEventLoopPolicy() # type: ignore[attr-defined] + asyncio.set_event_loop_policy(policy) + + with loop_context(policy.new_event_loop) as _loop: + asyncio.set_event_loop(_loop) + yield _loop + + +@pytest.fixture +def unused_port(aiohttp_unused_port: Callable[[], int]) -> Callable[[], int]: + warnings.warn( + "Deprecated, use aiohttp_unused_port fixture instead", + DeprecationWarning, + stacklevel=2, + ) + return aiohttp_unused_port + + +@pytest.fixture +def aiohttp_unused_port() -> Callable[[], int]: + """Return a port that is unused on the current host.""" + return _unused_port + + +@pytest.fixture +def aiohttp_server(loop: asyncio.AbstractEventLoop) -> Iterator[AiohttpServer]: + """Factory to create a TestServer instance, given an app. + + aiohttp_server(app, **kwargs) + """ + servers = [] + + async def go( + app: Application, *, port: Optional[int] = None, **kwargs: Any + ) -> TestServer: + server = TestServer(app, port=port) + await server.start_server(loop=loop, **kwargs) + servers.append(server) + return server + + yield go + + async def finalize() -> None: + while servers: + await servers.pop().close() + + loop.run_until_complete(finalize()) + + +@pytest.fixture +def test_server(aiohttp_server): # type: ignore[no-untyped-def] # pragma: no cover + warnings.warn( + "Deprecated, use aiohttp_server fixture instead", + DeprecationWarning, + stacklevel=2, + ) + return aiohttp_server + + +@pytest.fixture +def aiohttp_raw_server(loop: asyncio.AbstractEventLoop) -> Iterator[AiohttpRawServer]: + """Factory to create a RawTestServer instance, given a web handler. + + aiohttp_raw_server(handler, **kwargs) + """ + servers = [] + + async def go(handler, *, port=None, **kwargs): # type: ignore[no-untyped-def] + server = RawTestServer(handler, port=port) + await server.start_server(loop=loop, **kwargs) + servers.append(server) + return server + + yield go + + async def finalize() -> None: + while servers: + await servers.pop().close() + + loop.run_until_complete(finalize()) + + +@pytest.fixture +def raw_test_server( # type: ignore[no-untyped-def] # pragma: no cover + aiohttp_raw_server, +): + warnings.warn( + "Deprecated, use aiohttp_raw_server fixture instead", + DeprecationWarning, + stacklevel=2, + ) + return aiohttp_raw_server + + +@pytest.fixture +def aiohttp_client( + loop: asyncio.AbstractEventLoop, +) -> Iterator[AiohttpClient]: + """Factory to create a TestClient instance. + + aiohttp_client(app, **kwargs) + aiohttp_client(server, **kwargs) + aiohttp_client(raw_server, **kwargs) + """ + clients = [] + + async def go( + __param: Union[Application, BaseTestServer], + *args: Any, + server_kwargs: Optional[Dict[str, Any]] = None, + **kwargs: Any + ) -> TestClient: + + if isinstance(__param, Callable) and not isinstance( # type: ignore[arg-type] + __param, (Application, BaseTestServer) + ): + __param = __param(loop, *args, **kwargs) + kwargs = {} + else: + assert not args, "args should be empty" + + if isinstance(__param, Application): + server_kwargs = server_kwargs or {} + server = TestServer(__param, loop=loop, **server_kwargs) + client = TestClient(server, loop=loop, **kwargs) + elif isinstance(__param, BaseTestServer): + client = TestClient(__param, loop=loop, **kwargs) + else: + raise ValueError("Unknown argument type: %r" % type(__param)) + + await client.start_server() + clients.append(client) + return client + + yield go + + async def finalize() -> None: + while clients: + await clients.pop().close() + + loop.run_until_complete(finalize()) + + +@pytest.fixture +def test_client(aiohttp_client): # type: ignore[no-untyped-def] # pragma: no cover + warnings.warn( + "Deprecated, use aiohttp_client fixture instead", + DeprecationWarning, + stacklevel=2, + ) + return aiohttp_client diff --git a/env/Lib/site-packages/aiohttp/resolver.py b/env/Lib/site-packages/aiohttp/resolver.py new file mode 100644 index 0000000..10e3626 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/resolver.py @@ -0,0 +1,188 @@ +import asyncio +import socket +import sys +from typing import Any, Dict, List, Optional, Tuple, Type, Union + +from .abc import AbstractResolver, ResolveResult + +__all__ = ("ThreadedResolver", "AsyncResolver", "DefaultResolver") + + +try: + import aiodns + + aiodns_default = hasattr(aiodns.DNSResolver, "getaddrinfo") +except ImportError: # pragma: no cover + aiodns = None # type: ignore[assignment] + aiodns_default = False + + +_NUMERIC_SOCKET_FLAGS = socket.AI_NUMERICHOST | socket.AI_NUMERICSERV +_SUPPORTS_SCOPE_ID = sys.version_info >= (3, 9, 0) + + +class ThreadedResolver(AbstractResolver): + """Threaded resolver. + + Uses an Executor for synchronous getaddrinfo() calls. + concurrent.futures.ThreadPoolExecutor is used by default. + """ + + def __init__(self, loop: Optional[asyncio.AbstractEventLoop] = None) -> None: + self._loop = loop or asyncio.get_running_loop() + + async def resolve( + self, host: str, port: int = 0, family: socket.AddressFamily = socket.AF_INET + ) -> List[ResolveResult]: + infos = await self._loop.getaddrinfo( + host, + port, + type=socket.SOCK_STREAM, + family=family, + flags=socket.AI_ADDRCONFIG, + ) + + hosts: List[ResolveResult] = [] + for family, _, proto, _, address in infos: + if family == socket.AF_INET6: + if len(address) < 3: + # IPv6 is not supported by Python build, + # or IPv6 is not enabled in the host + continue + if address[3] and _SUPPORTS_SCOPE_ID: + # This is essential for link-local IPv6 addresses. + # LL IPv6 is a VERY rare case. Strictly speaking, we should use + # getnameinfo() unconditionally, but performance makes sense. + resolved_host, _port = await self._loop.getnameinfo( + address, _NUMERIC_SOCKET_FLAGS + ) + port = int(_port) + else: + resolved_host, port = address[:2] + else: # IPv4 + assert family == socket.AF_INET + resolved_host, port = address # type: ignore[misc] + hosts.append( + ResolveResult( + hostname=host, + host=resolved_host, + port=port, + family=family, + proto=proto, + flags=_NUMERIC_SOCKET_FLAGS, + ) + ) + + return hosts + + async def close(self) -> None: + pass + + +class AsyncResolver(AbstractResolver): + """Use the `aiodns` package to make asynchronous DNS lookups""" + + def __init__( + self, + loop: Optional[asyncio.AbstractEventLoop] = None, + *args: Any, + **kwargs: Any + ) -> None: + if aiodns is None: + raise RuntimeError("Resolver requires aiodns library") + + self._resolver = aiodns.DNSResolver(*args, **kwargs) + + if not hasattr(self._resolver, "gethostbyname"): + # aiodns 1.1 is not available, fallback to DNSResolver.query + self.resolve = self._resolve_with_query # type: ignore + + async def resolve( + self, host: str, port: int = 0, family: socket.AddressFamily = socket.AF_INET + ) -> List[ResolveResult]: + try: + resp = await self._resolver.getaddrinfo( + host, + port=port, + type=socket.SOCK_STREAM, + family=family, + flags=socket.AI_ADDRCONFIG, + ) + except aiodns.error.DNSError as exc: + msg = exc.args[1] if len(exc.args) >= 1 else "DNS lookup failed" + raise OSError(msg) from exc + hosts: List[ResolveResult] = [] + for node in resp.nodes: + address: Union[Tuple[bytes, int], Tuple[bytes, int, int, int]] = node.addr + family = node.family + if family == socket.AF_INET6: + if len(address) > 3 and address[3] and _SUPPORTS_SCOPE_ID: + # This is essential for link-local IPv6 addresses. + # LL IPv6 is a VERY rare case. Strictly speaking, we should use + # getnameinfo() unconditionally, but performance makes sense. + result = await self._resolver.getnameinfo( + (address[0].decode("ascii"), *address[1:]), + _NUMERIC_SOCKET_FLAGS, + ) + resolved_host = result.node + else: + resolved_host = address[0].decode("ascii") + port = address[1] + else: # IPv4 + assert family == socket.AF_INET + resolved_host = address[0].decode("ascii") + port = address[1] + hosts.append( + ResolveResult( + hostname=host, + host=resolved_host, + port=port, + family=family, + proto=0, + flags=_NUMERIC_SOCKET_FLAGS, + ) + ) + + if not hosts: + raise OSError("DNS lookup failed") + + return hosts + + async def _resolve_with_query( + self, host: str, port: int = 0, family: int = socket.AF_INET + ) -> List[Dict[str, Any]]: + if family == socket.AF_INET6: + qtype = "AAAA" + else: + qtype = "A" + + try: + resp = await self._resolver.query(host, qtype) + except aiodns.error.DNSError as exc: + msg = exc.args[1] if len(exc.args) >= 1 else "DNS lookup failed" + raise OSError(msg) from exc + + hosts = [] + for rr in resp: + hosts.append( + { + "hostname": host, + "host": rr.host, + "port": port, + "family": family, + "proto": 0, + "flags": socket.AI_NUMERICHOST, + } + ) + + if not hosts: + raise OSError("DNS lookup failed") + + return hosts + + async def close(self) -> None: + self._resolver.cancel() + + +_DefaultType = Type[Union[AsyncResolver, ThreadedResolver]] +DefaultResolver: _DefaultType = AsyncResolver if aiodns_default else ThreadedResolver diff --git a/env/Lib/site-packages/aiohttp/streams.py b/env/Lib/site-packages/aiohttp/streams.py new file mode 100644 index 0000000..b9b9c3f --- /dev/null +++ b/env/Lib/site-packages/aiohttp/streams.py @@ -0,0 +1,684 @@ +import asyncio +import collections +import warnings +from typing import ( + Awaitable, + Callable, + Deque, + Final, + Generic, + List, + Optional, + Tuple, + TypeVar, +) + +from .base_protocol import BaseProtocol +from .helpers import ( + _EXC_SENTINEL, + BaseTimerContext, + TimerNoop, + set_exception, + set_result, +) +from .log import internal_logger + +__all__ = ( + "EMPTY_PAYLOAD", + "EofStream", + "StreamReader", + "DataQueue", + "FlowControlDataQueue", +) + +_T = TypeVar("_T") + + +class EofStream(Exception): + """eof stream indication.""" + + +class AsyncStreamIterator(Generic[_T]): + def __init__(self, read_func: Callable[[], Awaitable[_T]]) -> None: + self.read_func = read_func + + def __aiter__(self) -> "AsyncStreamIterator[_T]": + return self + + async def __anext__(self) -> _T: + try: + rv = await self.read_func() + except EofStream: + raise StopAsyncIteration + if rv == b"": + raise StopAsyncIteration + return rv + + +class ChunkTupleAsyncStreamIterator: + def __init__(self, stream: "StreamReader") -> None: + self._stream = stream + + def __aiter__(self) -> "ChunkTupleAsyncStreamIterator": + return self + + async def __anext__(self) -> Tuple[bytes, bool]: + rv = await self._stream.readchunk() + if rv == (b"", False): + raise StopAsyncIteration + return rv + + +class AsyncStreamReaderMixin: + def __aiter__(self) -> AsyncStreamIterator[bytes]: + return AsyncStreamIterator(self.readline) # type: ignore[attr-defined] + + def iter_chunked(self, n: int) -> AsyncStreamIterator[bytes]: + """Returns an asynchronous iterator that yields chunks of size n.""" + return AsyncStreamIterator(lambda: self.read(n)) # type: ignore[attr-defined] + + def iter_any(self) -> AsyncStreamIterator[bytes]: + """Yield all available data as soon as it is received.""" + return AsyncStreamIterator(self.readany) # type: ignore[attr-defined] + + def iter_chunks(self) -> ChunkTupleAsyncStreamIterator: + """Yield chunks of data as they are received by the server. + + The yielded objects are tuples + of (bytes, bool) as returned by the StreamReader.readchunk method. + """ + return ChunkTupleAsyncStreamIterator(self) # type: ignore[arg-type] + + +class StreamReader(AsyncStreamReaderMixin): + """An enhancement of asyncio.StreamReader. + + Supports asynchronous iteration by line, chunk or as available:: + + async for line in reader: + ... + async for chunk in reader.iter_chunked(1024): + ... + async for slice in reader.iter_any(): + ... + + """ + + total_bytes = 0 + + def __init__( + self, + protocol: BaseProtocol, + limit: int, + *, + timer: Optional[BaseTimerContext] = None, + loop: Optional[asyncio.AbstractEventLoop] = None, + ) -> None: + self._protocol = protocol + self._low_water = limit + self._high_water = limit * 2 + if loop is None: + loop = asyncio.get_event_loop() + self._loop = loop + self._size = 0 + self._cursor = 0 + self._http_chunk_splits: Optional[List[int]] = None + self._buffer: Deque[bytes] = collections.deque() + self._buffer_offset = 0 + self._eof = False + self._waiter: Optional[asyncio.Future[None]] = None + self._eof_waiter: Optional[asyncio.Future[None]] = None + self._exception: Optional[BaseException] = None + self._timer = TimerNoop() if timer is None else timer + self._eof_callbacks: List[Callable[[], None]] = [] + + def __repr__(self) -> str: + info = [self.__class__.__name__] + if self._size: + info.append("%d bytes" % self._size) + if self._eof: + info.append("eof") + if self._low_water != 2**16: # default limit + info.append("low=%d high=%d" % (self._low_water, self._high_water)) + if self._waiter: + info.append("w=%r" % self._waiter) + if self._exception: + info.append("e=%r" % self._exception) + return "<%s>" % " ".join(info) + + def get_read_buffer_limits(self) -> Tuple[int, int]: + return (self._low_water, self._high_water) + + def exception(self) -> Optional[BaseException]: + return self._exception + + def set_exception( + self, + exc: BaseException, + exc_cause: BaseException = _EXC_SENTINEL, + ) -> None: + self._exception = exc + self._eof_callbacks.clear() + + waiter = self._waiter + if waiter is not None: + self._waiter = None + set_exception(waiter, exc, exc_cause) + + waiter = self._eof_waiter + if waiter is not None: + self._eof_waiter = None + set_exception(waiter, exc, exc_cause) + + def on_eof(self, callback: Callable[[], None]) -> None: + if self._eof: + try: + callback() + except Exception: + internal_logger.exception("Exception in eof callback") + else: + self._eof_callbacks.append(callback) + + def feed_eof(self) -> None: + self._eof = True + + waiter = self._waiter + if waiter is not None: + self._waiter = None + set_result(waiter, None) + + waiter = self._eof_waiter + if waiter is not None: + self._eof_waiter = None + set_result(waiter, None) + + for cb in self._eof_callbacks: + try: + cb() + except Exception: + internal_logger.exception("Exception in eof callback") + + self._eof_callbacks.clear() + + def is_eof(self) -> bool: + """Return True if 'feed_eof' was called.""" + return self._eof + + def at_eof(self) -> bool: + """Return True if the buffer is empty and 'feed_eof' was called.""" + return self._eof and not self._buffer + + async def wait_eof(self) -> None: + if self._eof: + return + + assert self._eof_waiter is None + self._eof_waiter = self._loop.create_future() + try: + await self._eof_waiter + finally: + self._eof_waiter = None + + def unread_data(self, data: bytes) -> None: + """rollback reading some data from stream, inserting it to buffer head.""" + warnings.warn( + "unread_data() is deprecated " + "and will be removed in future releases (#3260)", + DeprecationWarning, + stacklevel=2, + ) + if not data: + return + + if self._buffer_offset: + self._buffer[0] = self._buffer[0][self._buffer_offset :] + self._buffer_offset = 0 + self._size += len(data) + self._cursor -= len(data) + self._buffer.appendleft(data) + self._eof_counter = 0 + + # TODO: size is ignored, remove the param later + def feed_data(self, data: bytes, size: int = 0) -> None: + assert not self._eof, "feed_data after feed_eof" + + if not data: + return + + self._size += len(data) + self._buffer.append(data) + self.total_bytes += len(data) + + waiter = self._waiter + if waiter is not None: + self._waiter = None + set_result(waiter, None) + + if self._size > self._high_water and not self._protocol._reading_paused: + self._protocol.pause_reading() + + def begin_http_chunk_receiving(self) -> None: + if self._http_chunk_splits is None: + if self.total_bytes: + raise RuntimeError( + "Called begin_http_chunk_receiving when" "some data was already fed" + ) + self._http_chunk_splits = [] + + def end_http_chunk_receiving(self) -> None: + if self._http_chunk_splits is None: + raise RuntimeError( + "Called end_chunk_receiving without calling " + "begin_chunk_receiving first" + ) + + # self._http_chunk_splits contains logical byte offsets from start of + # the body transfer. Each offset is the offset of the end of a chunk. + # "Logical" means bytes, accessible for a user. + # If no chunks containing logical data were received, current position + # is difinitely zero. + pos = self._http_chunk_splits[-1] if self._http_chunk_splits else 0 + + if self.total_bytes == pos: + # We should not add empty chunks here. So we check for that. + # Note, when chunked + gzip is used, we can receive a chunk + # of compressed data, but that data may not be enough for gzip FSM + # to yield any uncompressed data. That's why current position may + # not change after receiving a chunk. + return + + self._http_chunk_splits.append(self.total_bytes) + + # wake up readchunk when end of http chunk received + waiter = self._waiter + if waiter is not None: + self._waiter = None + set_result(waiter, None) + + async def _wait(self, func_name: str) -> None: + # StreamReader uses a future to link the protocol feed_data() method + # to a read coroutine. Running two read coroutines at the same time + # would have an unexpected behaviour. It would not possible to know + # which coroutine would get the next data. + if self._waiter is not None: + raise RuntimeError( + "%s() called while another coroutine is " + "already waiting for incoming data" % func_name + ) + + waiter = self._waiter = self._loop.create_future() + try: + with self._timer: + await waiter + finally: + self._waiter = None + + async def readline(self) -> bytes: + return await self.readuntil() + + async def readuntil(self, separator: bytes = b"\n") -> bytes: + seplen = len(separator) + if seplen == 0: + raise ValueError("Separator should be at least one-byte string") + + if self._exception is not None: + raise self._exception + + chunk = b"" + chunk_size = 0 + not_enough = True + + while not_enough: + while self._buffer and not_enough: + offset = self._buffer_offset + ichar = self._buffer[0].find(separator, offset) + 1 + # Read from current offset to found separator or to the end. + data = self._read_nowait_chunk( + ichar - offset + seplen - 1 if ichar else -1 + ) + chunk += data + chunk_size += len(data) + if ichar: + not_enough = False + + if chunk_size > self._high_water: + raise ValueError("Chunk too big") + + if self._eof: + break + + if not_enough: + await self._wait("readuntil") + + return chunk + + async def read(self, n: int = -1) -> bytes: + if self._exception is not None: + raise self._exception + + # migration problem; with DataQueue you have to catch + # EofStream exception, so common way is to run payload.read() inside + # infinite loop. what can cause real infinite loop with StreamReader + # lets keep this code one major release. + if __debug__: + if self._eof and not self._buffer: + self._eof_counter = getattr(self, "_eof_counter", 0) + 1 + if self._eof_counter > 5: + internal_logger.warning( + "Multiple access to StreamReader in eof state, " + "might be infinite loop.", + stack_info=True, + ) + + if not n: + return b"" + + if n < 0: + # This used to just loop creating a new waiter hoping to + # collect everything in self._buffer, but that would + # deadlock if the subprocess sends more than self.limit + # bytes. So just call self.readany() until EOF. + blocks = [] + while True: + block = await self.readany() + if not block: + break + blocks.append(block) + return b"".join(blocks) + + # TODO: should be `if` instead of `while` + # because waiter maybe triggered on chunk end, + # without feeding any data + while not self._buffer and not self._eof: + await self._wait("read") + + return self._read_nowait(n) + + async def readany(self) -> bytes: + if self._exception is not None: + raise self._exception + + # TODO: should be `if` instead of `while` + # because waiter maybe triggered on chunk end, + # without feeding any data + while not self._buffer and not self._eof: + await self._wait("readany") + + return self._read_nowait(-1) + + async def readchunk(self) -> Tuple[bytes, bool]: + """Returns a tuple of (data, end_of_http_chunk). + + When chunked transfer + encoding is used, end_of_http_chunk is a boolean indicating if the end + of the data corresponds to the end of a HTTP chunk , otherwise it is + always False. + """ + while True: + if self._exception is not None: + raise self._exception + + while self._http_chunk_splits: + pos = self._http_chunk_splits.pop(0) + if pos == self._cursor: + return (b"", True) + if pos > self._cursor: + return (self._read_nowait(pos - self._cursor), True) + internal_logger.warning( + "Skipping HTTP chunk end due to data " + "consumption beyond chunk boundary" + ) + + if self._buffer: + return (self._read_nowait_chunk(-1), False) + # return (self._read_nowait(-1), False) + + if self._eof: + # Special case for signifying EOF. + # (b'', True) is not a final return value actually. + return (b"", False) + + await self._wait("readchunk") + + async def readexactly(self, n: int) -> bytes: + if self._exception is not None: + raise self._exception + + blocks: List[bytes] = [] + while n > 0: + block = await self.read(n) + if not block: + partial = b"".join(blocks) + raise asyncio.IncompleteReadError(partial, len(partial) + n) + blocks.append(block) + n -= len(block) + + return b"".join(blocks) + + def read_nowait(self, n: int = -1) -> bytes: + # default was changed to be consistent with .read(-1) + # + # I believe the most users don't know about the method and + # they are not affected. + if self._exception is not None: + raise self._exception + + if self._waiter and not self._waiter.done(): + raise RuntimeError( + "Called while some coroutine is waiting for incoming data." + ) + + return self._read_nowait(n) + + def _read_nowait_chunk(self, n: int) -> bytes: + first_buffer = self._buffer[0] + offset = self._buffer_offset + if n != -1 and len(first_buffer) - offset > n: + data = first_buffer[offset : offset + n] + self._buffer_offset += n + + elif offset: + self._buffer.popleft() + data = first_buffer[offset:] + self._buffer_offset = 0 + + else: + data = self._buffer.popleft() + + self._size -= len(data) + self._cursor += len(data) + + chunk_splits = self._http_chunk_splits + # Prevent memory leak: drop useless chunk splits + while chunk_splits and chunk_splits[0] < self._cursor: + chunk_splits.pop(0) + + if self._size < self._low_water and self._protocol._reading_paused: + self._protocol.resume_reading() + return data + + def _read_nowait(self, n: int) -> bytes: + """Read not more than n bytes, or whole buffer if n == -1""" + self._timer.assert_timeout() + + chunks = [] + while self._buffer: + chunk = self._read_nowait_chunk(n) + chunks.append(chunk) + if n != -1: + n -= len(chunk) + if n == 0: + break + + return b"".join(chunks) if chunks else b"" + + +class EmptyStreamReader(StreamReader): # lgtm [py/missing-call-to-init] + def __init__(self) -> None: + self._read_eof_chunk = False + + def __repr__(self) -> str: + return "<%s>" % self.__class__.__name__ + + def exception(self) -> Optional[BaseException]: + return None + + def set_exception( + self, + exc: BaseException, + exc_cause: BaseException = _EXC_SENTINEL, + ) -> None: + pass + + def on_eof(self, callback: Callable[[], None]) -> None: + try: + callback() + except Exception: + internal_logger.exception("Exception in eof callback") + + def feed_eof(self) -> None: + pass + + def is_eof(self) -> bool: + return True + + def at_eof(self) -> bool: + return True + + async def wait_eof(self) -> None: + return + + def feed_data(self, data: bytes, n: int = 0) -> None: + pass + + async def readline(self) -> bytes: + return b"" + + async def read(self, n: int = -1) -> bytes: + return b"" + + # TODO add async def readuntil + + async def readany(self) -> bytes: + return b"" + + async def readchunk(self) -> Tuple[bytes, bool]: + if not self._read_eof_chunk: + self._read_eof_chunk = True + return (b"", False) + + return (b"", True) + + async def readexactly(self, n: int) -> bytes: + raise asyncio.IncompleteReadError(b"", n) + + def read_nowait(self, n: int = -1) -> bytes: + return b"" + + +EMPTY_PAYLOAD: Final[StreamReader] = EmptyStreamReader() + + +class DataQueue(Generic[_T]): + """DataQueue is a general-purpose blocking queue with one reader.""" + + def __init__(self, loop: asyncio.AbstractEventLoop) -> None: + self._loop = loop + self._eof = False + self._waiter: Optional[asyncio.Future[None]] = None + self._exception: Optional[BaseException] = None + self._size = 0 + self._buffer: Deque[Tuple[_T, int]] = collections.deque() + + def __len__(self) -> int: + return len(self._buffer) + + def is_eof(self) -> bool: + return self._eof + + def at_eof(self) -> bool: + return self._eof and not self._buffer + + def exception(self) -> Optional[BaseException]: + return self._exception + + def set_exception( + self, + exc: BaseException, + exc_cause: BaseException = _EXC_SENTINEL, + ) -> None: + self._eof = True + self._exception = exc + + waiter = self._waiter + if waiter is not None: + self._waiter = None + set_exception(waiter, exc, exc_cause) + + def feed_data(self, data: _T, size: int = 0) -> None: + self._size += size + self._buffer.append((data, size)) + + waiter = self._waiter + if waiter is not None: + self._waiter = None + set_result(waiter, None) + + def feed_eof(self) -> None: + self._eof = True + + waiter = self._waiter + if waiter is not None: + self._waiter = None + set_result(waiter, None) + + async def read(self) -> _T: + if not self._buffer and not self._eof: + assert not self._waiter + self._waiter = self._loop.create_future() + try: + await self._waiter + except (asyncio.CancelledError, asyncio.TimeoutError): + self._waiter = None + raise + + if self._buffer: + data, size = self._buffer.popleft() + self._size -= size + return data + else: + if self._exception is not None: + raise self._exception + else: + raise EofStream + + def __aiter__(self) -> AsyncStreamIterator[_T]: + return AsyncStreamIterator(self.read) + + +class FlowControlDataQueue(DataQueue[_T]): + """FlowControlDataQueue resumes and pauses an underlying stream. + + It is a destination for parsed data. + """ + + def __init__( + self, protocol: BaseProtocol, limit: int, *, loop: asyncio.AbstractEventLoop + ) -> None: + super().__init__(loop=loop) + + self._protocol = protocol + self._limit = limit * 2 + + def feed_data(self, data: _T, size: int = 0) -> None: + super().feed_data(data, size) + + if self._size > self._limit and not self._protocol._reading_paused: + self._protocol.pause_reading() + + async def read(self) -> _T: + try: + return await super().read() + finally: + if self._size < self._limit and self._protocol._reading_paused: + self._protocol.resume_reading() diff --git a/env/Lib/site-packages/aiohttp/tcp_helpers.py b/env/Lib/site-packages/aiohttp/tcp_helpers.py new file mode 100644 index 0000000..88b2442 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/tcp_helpers.py @@ -0,0 +1,37 @@ +"""Helper methods to tune a TCP connection""" + +import asyncio +import socket +from contextlib import suppress +from typing import Optional # noqa + +__all__ = ("tcp_keepalive", "tcp_nodelay") + + +if hasattr(socket, "SO_KEEPALIVE"): + + def tcp_keepalive(transport: asyncio.Transport) -> None: + sock = transport.get_extra_info("socket") + if sock is not None: + sock.setsockopt(socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1) + +else: + + def tcp_keepalive(transport: asyncio.Transport) -> None: # pragma: no cover + pass + + +def tcp_nodelay(transport: asyncio.Transport, value: bool) -> None: + sock = transport.get_extra_info("socket") + + if sock is None: + return + + if sock.family not in (socket.AF_INET, socket.AF_INET6): + return + + value = bool(value) + + # socket may be closed already, on windows OSError get raised + with suppress(OSError): + sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, value) diff --git a/env/Lib/site-packages/aiohttp/test_utils.py b/env/Lib/site-packages/aiohttp/test_utils.py new file mode 100644 index 0000000..97c1469 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/test_utils.py @@ -0,0 +1,731 @@ +"""Utilities shared by tests.""" + +import asyncio +import contextlib +import gc +import inspect +import ipaddress +import os +import socket +import sys +import warnings +from abc import ABC, abstractmethod +from types import TracebackType +from typing import TYPE_CHECKING, Any, Callable, Iterator, List, Optional, Type, cast +from unittest import IsolatedAsyncioTestCase, mock + +from aiosignal import Signal +from multidict import CIMultiDict, CIMultiDictProxy +from yarl import URL + +import aiohttp +from aiohttp.client import ( + _RequestContextManager, + _RequestOptions, + _WSRequestContextManager, +) + +from . import ClientSession, hdrs +from .abc import AbstractCookieJar +from .client_reqrep import ClientResponse +from .client_ws import ClientWebSocketResponse +from .helpers import sentinel +from .http import HttpVersion, RawRequestMessage +from .typedefs import StrOrURL +from .web import ( + Application, + AppRunner, + BaseRunner, + Request, + Server, + ServerRunner, + SockSite, + UrlMappingMatchInfo, +) +from .web_protocol import _RequestHandler + +if TYPE_CHECKING: + from ssl import SSLContext +else: + SSLContext = None + +if sys.version_info >= (3, 11) and TYPE_CHECKING: + from typing import Unpack + +REUSE_ADDRESS = os.name == "posix" and sys.platform != "cygwin" + + +def get_unused_port_socket( + host: str, family: socket.AddressFamily = socket.AF_INET +) -> socket.socket: + return get_port_socket(host, 0, family) + + +def get_port_socket( + host: str, port: int, family: socket.AddressFamily +) -> socket.socket: + s = socket.socket(family, socket.SOCK_STREAM) + if REUSE_ADDRESS: + # Windows has different semantics for SO_REUSEADDR, + # so don't set it. Ref: + # https://docs.microsoft.com/en-us/windows/win32/winsock/using-so-reuseaddr-and-so-exclusiveaddruse + s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) + s.bind((host, port)) + return s + + +def unused_port() -> int: + """Return a port that is unused on the current host.""" + with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s: + s.bind(("127.0.0.1", 0)) + return cast(int, s.getsockname()[1]) + + +class BaseTestServer(ABC): + __test__ = False + + def __init__( + self, + *, + scheme: str = "", + loop: Optional[asyncio.AbstractEventLoop] = None, + host: str = "127.0.0.1", + port: Optional[int] = None, + skip_url_asserts: bool = False, + socket_factory: Callable[ + [str, int, socket.AddressFamily], socket.socket + ] = get_port_socket, + **kwargs: Any, + ) -> None: + self._loop = loop + self.runner: Optional[BaseRunner] = None + self._root: Optional[URL] = None + self.host = host + self.port = port + self._closed = False + self.scheme = scheme + self.skip_url_asserts = skip_url_asserts + self.socket_factory = socket_factory + + async def start_server( + self, loop: Optional[asyncio.AbstractEventLoop] = None, **kwargs: Any + ) -> None: + if self.runner: + return + self._loop = loop + self._ssl = kwargs.pop("ssl", None) + self.runner = await self._make_runner(handler_cancellation=True, **kwargs) + await self.runner.setup() + if not self.port: + self.port = 0 + try: + version = ipaddress.ip_address(self.host).version + except ValueError: + version = 4 + family = socket.AF_INET6 if version == 6 else socket.AF_INET + _sock = self.socket_factory(self.host, self.port, family) + self.host, self.port = _sock.getsockname()[:2] + site = SockSite(self.runner, sock=_sock, ssl_context=self._ssl) + await site.start() + server = site._server + assert server is not None + sockets = server.sockets # type: ignore[attr-defined] + assert sockets is not None + self.port = sockets[0].getsockname()[1] + if not self.scheme: + self.scheme = "https" if self._ssl else "http" + self._root = URL(f"{self.scheme}://{self.host}:{self.port}") + + @abstractmethod # pragma: no cover + async def _make_runner(self, **kwargs: Any) -> BaseRunner: + pass + + def make_url(self, path: StrOrURL) -> URL: + assert self._root is not None + url = URL(path) + if not self.skip_url_asserts: + assert not url.is_absolute() + return self._root.join(url) + else: + return URL(str(self._root) + str(path)) + + @property + def started(self) -> bool: + return self.runner is not None + + @property + def closed(self) -> bool: + return self._closed + + @property + def handler(self) -> Server: + # for backward compatibility + # web.Server instance + runner = self.runner + assert runner is not None + assert runner.server is not None + return runner.server + + async def close(self) -> None: + """Close all fixtures created by the test client. + + After that point, the TestClient is no longer usable. + + This is an idempotent function: running close multiple times + will not have any additional effects. + + close is also run when the object is garbage collected, and on + exit when used as a context manager. + + """ + if self.started and not self.closed: + assert self.runner is not None + await self.runner.cleanup() + self._root = None + self.port = None + self._closed = True + + def __enter__(self) -> None: + raise TypeError("Use async with instead") + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_value: Optional[BaseException], + traceback: Optional[TracebackType], + ) -> None: + # __exit__ should exist in pair with __enter__ but never executed + pass # pragma: no cover + + async def __aenter__(self) -> "BaseTestServer": + await self.start_server(loop=self._loop) + return self + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc_value: Optional[BaseException], + traceback: Optional[TracebackType], + ) -> None: + await self.close() + + +class TestServer(BaseTestServer): + def __init__( + self, + app: Application, + *, + scheme: str = "", + host: str = "127.0.0.1", + port: Optional[int] = None, + **kwargs: Any, + ): + self.app = app + super().__init__(scheme=scheme, host=host, port=port, **kwargs) + + async def _make_runner(self, **kwargs: Any) -> BaseRunner: + return AppRunner(self.app, **kwargs) + + +class RawTestServer(BaseTestServer): + def __init__( + self, + handler: _RequestHandler, + *, + scheme: str = "", + host: str = "127.0.0.1", + port: Optional[int] = None, + **kwargs: Any, + ) -> None: + self._handler = handler + super().__init__(scheme=scheme, host=host, port=port, **kwargs) + + async def _make_runner(self, debug: bool = True, **kwargs: Any) -> ServerRunner: + srv = Server(self._handler, loop=self._loop, debug=debug, **kwargs) + return ServerRunner(srv, debug=debug, **kwargs) + + +class TestClient: + """ + A test client implementation. + + To write functional tests for aiohttp based servers. + + """ + + __test__ = False + + def __init__( + self, + server: BaseTestServer, + *, + cookie_jar: Optional[AbstractCookieJar] = None, + loop: Optional[asyncio.AbstractEventLoop] = None, + **kwargs: Any, + ) -> None: + if not isinstance(server, BaseTestServer): + raise TypeError( + "server must be TestServer " "instance, found type: %r" % type(server) + ) + self._server = server + self._loop = loop + if cookie_jar is None: + cookie_jar = aiohttp.CookieJar(unsafe=True, loop=loop) + self._session = ClientSession(loop=loop, cookie_jar=cookie_jar, **kwargs) + self._closed = False + self._responses: List[ClientResponse] = [] + self._websockets: List[ClientWebSocketResponse] = [] + + async def start_server(self) -> None: + await self._server.start_server(loop=self._loop) + + @property + def host(self) -> str: + return self._server.host + + @property + def port(self) -> Optional[int]: + return self._server.port + + @property + def server(self) -> BaseTestServer: + return self._server + + @property + def app(self) -> Optional[Application]: + return cast(Optional[Application], getattr(self._server, "app", None)) + + @property + def session(self) -> ClientSession: + """An internal aiohttp.ClientSession. + + Unlike the methods on the TestClient, client session requests + do not automatically include the host in the url queried, and + will require an absolute path to the resource. + + """ + return self._session + + def make_url(self, path: StrOrURL) -> URL: + return self._server.make_url(path) + + async def _request( + self, method: str, path: StrOrURL, **kwargs: Any + ) -> ClientResponse: + resp = await self._session.request(method, self.make_url(path), **kwargs) + # save it to close later + self._responses.append(resp) + return resp + + if sys.version_info >= (3, 11) and TYPE_CHECKING: + + def request( + self, method: str, path: StrOrURL, **kwargs: Unpack[_RequestOptions] + ) -> _RequestContextManager: ... + + def get( + self, + path: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> _RequestContextManager: ... + + def options( + self, + path: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> _RequestContextManager: ... + + def head( + self, + path: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> _RequestContextManager: ... + + def post( + self, + path: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> _RequestContextManager: ... + + def put( + self, + path: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> _RequestContextManager: ... + + def patch( + self, + path: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> _RequestContextManager: ... + + def delete( + self, + path: StrOrURL, + **kwargs: Unpack[_RequestOptions], + ) -> _RequestContextManager: ... + + else: + + def request( + self, method: str, path: StrOrURL, **kwargs: Any + ) -> _RequestContextManager: + """Routes a request to tested http server. + + The interface is identical to aiohttp.ClientSession.request, + except the loop kwarg is overridden by the instance used by the + test server. + + """ + return _RequestContextManager(self._request(method, path, **kwargs)) + + def get(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager: + """Perform an HTTP GET request.""" + return _RequestContextManager(self._request(hdrs.METH_GET, path, **kwargs)) + + def post(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager: + """Perform an HTTP POST request.""" + return _RequestContextManager(self._request(hdrs.METH_POST, path, **kwargs)) + + def options(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager: + """Perform an HTTP OPTIONS request.""" + return _RequestContextManager( + self._request(hdrs.METH_OPTIONS, path, **kwargs) + ) + + def head(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager: + """Perform an HTTP HEAD request.""" + return _RequestContextManager(self._request(hdrs.METH_HEAD, path, **kwargs)) + + def put(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager: + """Perform an HTTP PUT request.""" + return _RequestContextManager(self._request(hdrs.METH_PUT, path, **kwargs)) + + def patch(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager: + """Perform an HTTP PATCH request.""" + return _RequestContextManager( + self._request(hdrs.METH_PATCH, path, **kwargs) + ) + + def delete(self, path: StrOrURL, **kwargs: Any) -> _RequestContextManager: + """Perform an HTTP PATCH request.""" + return _RequestContextManager( + self._request(hdrs.METH_DELETE, path, **kwargs) + ) + + def ws_connect(self, path: StrOrURL, **kwargs: Any) -> _WSRequestContextManager: + """Initiate websocket connection. + + The api corresponds to aiohttp.ClientSession.ws_connect. + + """ + return _WSRequestContextManager(self._ws_connect(path, **kwargs)) + + async def _ws_connect( + self, path: StrOrURL, **kwargs: Any + ) -> ClientWebSocketResponse: + ws = await self._session.ws_connect(self.make_url(path), **kwargs) + self._websockets.append(ws) + return ws + + async def close(self) -> None: + """Close all fixtures created by the test client. + + After that point, the TestClient is no longer usable. + + This is an idempotent function: running close multiple times + will not have any additional effects. + + close is also run on exit when used as a(n) (asynchronous) + context manager. + + """ + if not self._closed: + for resp in self._responses: + resp.close() + for ws in self._websockets: + await ws.close() + await self._session.close() + await self._server.close() + self._closed = True + + def __enter__(self) -> None: + raise TypeError("Use async with instead") + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc: Optional[BaseException], + tb: Optional[TracebackType], + ) -> None: + # __exit__ should exist in pair with __enter__ but never executed + pass # pragma: no cover + + async def __aenter__(self) -> "TestClient": + await self.start_server() + return self + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc: Optional[BaseException], + tb: Optional[TracebackType], + ) -> None: + await self.close() + + +class AioHTTPTestCase(IsolatedAsyncioTestCase): + """A base class to allow for unittest web applications using aiohttp. + + Provides the following: + + * self.client (aiohttp.test_utils.TestClient): an aiohttp test client. + * self.loop (asyncio.BaseEventLoop): the event loop in which the + application and server are running. + * self.app (aiohttp.web.Application): the application returned by + self.get_application() + + Note that the TestClient's methods are asynchronous: you have to + execute function on the test client using asynchronous methods. + """ + + async def get_application(self) -> Application: + """Get application. + + This method should be overridden + to return the aiohttp.web.Application + object to test. + """ + return self.get_app() + + def get_app(self) -> Application: + """Obsolete method used to constructing web application. + + Use .get_application() coroutine instead. + """ + raise RuntimeError("Did you forget to define get_application()?") + + async def asyncSetUp(self) -> None: + self.loop = asyncio.get_running_loop() + return await self.setUpAsync() + + async def setUpAsync(self) -> None: + self.app = await self.get_application() + self.server = await self.get_server(self.app) + self.client = await self.get_client(self.server) + + await self.client.start_server() + + async def asyncTearDown(self) -> None: + return await self.tearDownAsync() + + async def tearDownAsync(self) -> None: + await self.client.close() + + async def get_server(self, app: Application) -> TestServer: + """Return a TestServer instance.""" + return TestServer(app, loop=self.loop) + + async def get_client(self, server: TestServer) -> TestClient: + """Return a TestClient instance.""" + return TestClient(server, loop=self.loop) + + +def unittest_run_loop(func: Any, *args: Any, **kwargs: Any) -> Any: + """ + A decorator dedicated to use with asynchronous AioHTTPTestCase test methods. + + In 3.8+, this does nothing. + """ + warnings.warn( + "Decorator `@unittest_run_loop` is no longer needed in aiohttp 3.8+", + DeprecationWarning, + stacklevel=2, + ) + return func + + +_LOOP_FACTORY = Callable[[], asyncio.AbstractEventLoop] + + +@contextlib.contextmanager +def loop_context( + loop_factory: _LOOP_FACTORY = asyncio.new_event_loop, fast: bool = False +) -> Iterator[asyncio.AbstractEventLoop]: + """A contextmanager that creates an event_loop, for test purposes. + + Handles the creation and cleanup of a test loop. + """ + loop = setup_test_loop(loop_factory) + yield loop + teardown_test_loop(loop, fast=fast) + + +def setup_test_loop( + loop_factory: _LOOP_FACTORY = asyncio.new_event_loop, +) -> asyncio.AbstractEventLoop: + """Create and return an asyncio.BaseEventLoop instance. + + The caller should also call teardown_test_loop, + once they are done with the loop. + """ + loop = loop_factory() + asyncio.set_event_loop(loop) + return loop + + +def teardown_test_loop(loop: asyncio.AbstractEventLoop, fast: bool = False) -> None: + """Teardown and cleanup an event_loop created by setup_test_loop.""" + closed = loop.is_closed() + if not closed: + loop.call_soon(loop.stop) + loop.run_forever() + loop.close() + + if not fast: + gc.collect() + + asyncio.set_event_loop(None) + + +def _create_app_mock() -> mock.MagicMock: + def get_dict(app: Any, key: str) -> Any: + return app.__app_dict[key] + + def set_dict(app: Any, key: str, value: Any) -> None: + app.__app_dict[key] = value + + app = mock.MagicMock(spec=Application) + app.__app_dict = {} + app.__getitem__ = get_dict + app.__setitem__ = set_dict + + app._debug = False + app.on_response_prepare = Signal(app) + app.on_response_prepare.freeze() + return app + + +def _create_transport(sslcontext: Optional[SSLContext] = None) -> mock.Mock: + transport = mock.Mock() + + def get_extra_info(key: str) -> Optional[SSLContext]: + if key == "sslcontext": + return sslcontext + else: + return None + + transport.get_extra_info.side_effect = get_extra_info + return transport + + +def make_mocked_request( + method: str, + path: str, + headers: Any = None, + *, + match_info: Any = sentinel, + version: HttpVersion = HttpVersion(1, 1), + closing: bool = False, + app: Any = None, + writer: Any = sentinel, + protocol: Any = sentinel, + transport: Any = sentinel, + payload: Any = sentinel, + sslcontext: Optional[SSLContext] = None, + client_max_size: int = 1024**2, + loop: Any = ..., +) -> Request: + """Creates mocked web.Request testing purposes. + + Useful in unit tests, when spinning full web server is overkill or + specific conditions and errors are hard to trigger. + """ + task = mock.Mock() + if loop is ...: + # no loop passed, try to get the current one if + # its is running as we need a real loop to create + # executor jobs to be able to do testing + # with a real executor + try: + loop = asyncio.get_running_loop() + except RuntimeError: + loop = mock.Mock() + loop.create_future.return_value = () + + if version < HttpVersion(1, 1): + closing = True + + if headers: + headers = CIMultiDictProxy(CIMultiDict(headers)) + raw_hdrs = tuple( + (k.encode("utf-8"), v.encode("utf-8")) for k, v in headers.items() + ) + else: + headers = CIMultiDictProxy(CIMultiDict()) + raw_hdrs = () + + chunked = "chunked" in headers.get(hdrs.TRANSFER_ENCODING, "").lower() + + message = RawRequestMessage( + method, + path, + version, + headers, + raw_hdrs, + closing, + None, + False, + chunked, + URL(path), + ) + if app is None: + app = _create_app_mock() + + if transport is sentinel: + transport = _create_transport(sslcontext) + + if protocol is sentinel: + protocol = mock.Mock() + protocol.transport = transport + + if writer is sentinel: + writer = mock.Mock() + writer.write_headers = make_mocked_coro(None) + writer.write = make_mocked_coro(None) + writer.write_eof = make_mocked_coro(None) + writer.drain = make_mocked_coro(None) + writer.transport = transport + + protocol.transport = transport + protocol.writer = writer + + if payload is sentinel: + payload = mock.Mock() + + req = Request( + message, payload, protocol, writer, task, loop, client_max_size=client_max_size + ) + + match_info = UrlMappingMatchInfo( + {} if match_info is sentinel else match_info, mock.Mock() + ) + match_info.add_app(app) + req._match_info = match_info + + return req + + +def make_mocked_coro( + return_value: Any = sentinel, raise_exception: Any = sentinel +) -> Any: + """Creates a coroutine mock.""" + + async def mock_coro(*args: Any, **kwargs: Any) -> Any: + if raise_exception is not sentinel: + raise raise_exception + if not inspect.isawaitable(return_value): + return return_value + await return_value + + return mock.Mock(wraps=mock_coro) diff --git a/env/Lib/site-packages/aiohttp/tracing.py b/env/Lib/site-packages/aiohttp/tracing.py new file mode 100644 index 0000000..012ed7b --- /dev/null +++ b/env/Lib/site-packages/aiohttp/tracing.py @@ -0,0 +1,470 @@ +from types import SimpleNamespace +from typing import TYPE_CHECKING, Awaitable, Mapping, Optional, Protocol, Type, TypeVar + +import attr +from aiosignal import Signal +from multidict import CIMultiDict +from yarl import URL + +from .client_reqrep import ClientResponse + +if TYPE_CHECKING: + from .client import ClientSession + + _ParamT_contra = TypeVar("_ParamT_contra", contravariant=True) + + class _SignalCallback(Protocol[_ParamT_contra]): + def __call__( + self, + __client_session: ClientSession, + __trace_config_ctx: SimpleNamespace, + __params: _ParamT_contra, + ) -> Awaitable[None]: ... + + +__all__ = ( + "TraceConfig", + "TraceRequestStartParams", + "TraceRequestEndParams", + "TraceRequestExceptionParams", + "TraceConnectionQueuedStartParams", + "TraceConnectionQueuedEndParams", + "TraceConnectionCreateStartParams", + "TraceConnectionCreateEndParams", + "TraceConnectionReuseconnParams", + "TraceDnsResolveHostStartParams", + "TraceDnsResolveHostEndParams", + "TraceDnsCacheHitParams", + "TraceDnsCacheMissParams", + "TraceRequestRedirectParams", + "TraceRequestChunkSentParams", + "TraceResponseChunkReceivedParams", + "TraceRequestHeadersSentParams", +) + + +class TraceConfig: + """First-class used to trace requests launched via ClientSession objects.""" + + def __init__( + self, trace_config_ctx_factory: Type[SimpleNamespace] = SimpleNamespace + ) -> None: + self._on_request_start: Signal[_SignalCallback[TraceRequestStartParams]] = ( + Signal(self) + ) + self._on_request_chunk_sent: Signal[ + _SignalCallback[TraceRequestChunkSentParams] + ] = Signal(self) + self._on_response_chunk_received: Signal[ + _SignalCallback[TraceResponseChunkReceivedParams] + ] = Signal(self) + self._on_request_end: Signal[_SignalCallback[TraceRequestEndParams]] = Signal( + self + ) + self._on_request_exception: Signal[ + _SignalCallback[TraceRequestExceptionParams] + ] = Signal(self) + self._on_request_redirect: Signal[ + _SignalCallback[TraceRequestRedirectParams] + ] = Signal(self) + self._on_connection_queued_start: Signal[ + _SignalCallback[TraceConnectionQueuedStartParams] + ] = Signal(self) + self._on_connection_queued_end: Signal[ + _SignalCallback[TraceConnectionQueuedEndParams] + ] = Signal(self) + self._on_connection_create_start: Signal[ + _SignalCallback[TraceConnectionCreateStartParams] + ] = Signal(self) + self._on_connection_create_end: Signal[ + _SignalCallback[TraceConnectionCreateEndParams] + ] = Signal(self) + self._on_connection_reuseconn: Signal[ + _SignalCallback[TraceConnectionReuseconnParams] + ] = Signal(self) + self._on_dns_resolvehost_start: Signal[ + _SignalCallback[TraceDnsResolveHostStartParams] + ] = Signal(self) + self._on_dns_resolvehost_end: Signal[ + _SignalCallback[TraceDnsResolveHostEndParams] + ] = Signal(self) + self._on_dns_cache_hit: Signal[_SignalCallback[TraceDnsCacheHitParams]] = ( + Signal(self) + ) + self._on_dns_cache_miss: Signal[_SignalCallback[TraceDnsCacheMissParams]] = ( + Signal(self) + ) + self._on_request_headers_sent: Signal[ + _SignalCallback[TraceRequestHeadersSentParams] + ] = Signal(self) + + self._trace_config_ctx_factory = trace_config_ctx_factory + + def trace_config_ctx( + self, trace_request_ctx: Optional[Mapping[str, str]] = None + ) -> SimpleNamespace: + """Return a new trace_config_ctx instance""" + return self._trace_config_ctx_factory(trace_request_ctx=trace_request_ctx) + + def freeze(self) -> None: + self._on_request_start.freeze() + self._on_request_chunk_sent.freeze() + self._on_response_chunk_received.freeze() + self._on_request_end.freeze() + self._on_request_exception.freeze() + self._on_request_redirect.freeze() + self._on_connection_queued_start.freeze() + self._on_connection_queued_end.freeze() + self._on_connection_create_start.freeze() + self._on_connection_create_end.freeze() + self._on_connection_reuseconn.freeze() + self._on_dns_resolvehost_start.freeze() + self._on_dns_resolvehost_end.freeze() + self._on_dns_cache_hit.freeze() + self._on_dns_cache_miss.freeze() + self._on_request_headers_sent.freeze() + + @property + def on_request_start(self) -> "Signal[_SignalCallback[TraceRequestStartParams]]": + return self._on_request_start + + @property + def on_request_chunk_sent( + self, + ) -> "Signal[_SignalCallback[TraceRequestChunkSentParams]]": + return self._on_request_chunk_sent + + @property + def on_response_chunk_received( + self, + ) -> "Signal[_SignalCallback[TraceResponseChunkReceivedParams]]": + return self._on_response_chunk_received + + @property + def on_request_end(self) -> "Signal[_SignalCallback[TraceRequestEndParams]]": + return self._on_request_end + + @property + def on_request_exception( + self, + ) -> "Signal[_SignalCallback[TraceRequestExceptionParams]]": + return self._on_request_exception + + @property + def on_request_redirect( + self, + ) -> "Signal[_SignalCallback[TraceRequestRedirectParams]]": + return self._on_request_redirect + + @property + def on_connection_queued_start( + self, + ) -> "Signal[_SignalCallback[TraceConnectionQueuedStartParams]]": + return self._on_connection_queued_start + + @property + def on_connection_queued_end( + self, + ) -> "Signal[_SignalCallback[TraceConnectionQueuedEndParams]]": + return self._on_connection_queued_end + + @property + def on_connection_create_start( + self, + ) -> "Signal[_SignalCallback[TraceConnectionCreateStartParams]]": + return self._on_connection_create_start + + @property + def on_connection_create_end( + self, + ) -> "Signal[_SignalCallback[TraceConnectionCreateEndParams]]": + return self._on_connection_create_end + + @property + def on_connection_reuseconn( + self, + ) -> "Signal[_SignalCallback[TraceConnectionReuseconnParams]]": + return self._on_connection_reuseconn + + @property + def on_dns_resolvehost_start( + self, + ) -> "Signal[_SignalCallback[TraceDnsResolveHostStartParams]]": + return self._on_dns_resolvehost_start + + @property + def on_dns_resolvehost_end( + self, + ) -> "Signal[_SignalCallback[TraceDnsResolveHostEndParams]]": + return self._on_dns_resolvehost_end + + @property + def on_dns_cache_hit(self) -> "Signal[_SignalCallback[TraceDnsCacheHitParams]]": + return self._on_dns_cache_hit + + @property + def on_dns_cache_miss(self) -> "Signal[_SignalCallback[TraceDnsCacheMissParams]]": + return self._on_dns_cache_miss + + @property + def on_request_headers_sent( + self, + ) -> "Signal[_SignalCallback[TraceRequestHeadersSentParams]]": + return self._on_request_headers_sent + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceRequestStartParams: + """Parameters sent by the `on_request_start` signal""" + + method: str + url: URL + headers: "CIMultiDict[str]" + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceRequestChunkSentParams: + """Parameters sent by the `on_request_chunk_sent` signal""" + + method: str + url: URL + chunk: bytes + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceResponseChunkReceivedParams: + """Parameters sent by the `on_response_chunk_received` signal""" + + method: str + url: URL + chunk: bytes + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceRequestEndParams: + """Parameters sent by the `on_request_end` signal""" + + method: str + url: URL + headers: "CIMultiDict[str]" + response: ClientResponse + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceRequestExceptionParams: + """Parameters sent by the `on_request_exception` signal""" + + method: str + url: URL + headers: "CIMultiDict[str]" + exception: BaseException + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceRequestRedirectParams: + """Parameters sent by the `on_request_redirect` signal""" + + method: str + url: URL + headers: "CIMultiDict[str]" + response: ClientResponse + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceConnectionQueuedStartParams: + """Parameters sent by the `on_connection_queued_start` signal""" + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceConnectionQueuedEndParams: + """Parameters sent by the `on_connection_queued_end` signal""" + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceConnectionCreateStartParams: + """Parameters sent by the `on_connection_create_start` signal""" + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceConnectionCreateEndParams: + """Parameters sent by the `on_connection_create_end` signal""" + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceConnectionReuseconnParams: + """Parameters sent by the `on_connection_reuseconn` signal""" + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceDnsResolveHostStartParams: + """Parameters sent by the `on_dns_resolvehost_start` signal""" + + host: str + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceDnsResolveHostEndParams: + """Parameters sent by the `on_dns_resolvehost_end` signal""" + + host: str + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceDnsCacheHitParams: + """Parameters sent by the `on_dns_cache_hit` signal""" + + host: str + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceDnsCacheMissParams: + """Parameters sent by the `on_dns_cache_miss` signal""" + + host: str + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class TraceRequestHeadersSentParams: + """Parameters sent by the `on_request_headers_sent` signal""" + + method: str + url: URL + headers: "CIMultiDict[str]" + + +class Trace: + """Internal dependency holder class. + + Used to keep together the main dependencies used + at the moment of send a signal. + """ + + def __init__( + self, + session: "ClientSession", + trace_config: TraceConfig, + trace_config_ctx: SimpleNamespace, + ) -> None: + self._trace_config = trace_config + self._trace_config_ctx = trace_config_ctx + self._session = session + + async def send_request_start( + self, method: str, url: URL, headers: "CIMultiDict[str]" + ) -> None: + return await self._trace_config.on_request_start.send( + self._session, + self._trace_config_ctx, + TraceRequestStartParams(method, url, headers), + ) + + async def send_request_chunk_sent( + self, method: str, url: URL, chunk: bytes + ) -> None: + return await self._trace_config.on_request_chunk_sent.send( + self._session, + self._trace_config_ctx, + TraceRequestChunkSentParams(method, url, chunk), + ) + + async def send_response_chunk_received( + self, method: str, url: URL, chunk: bytes + ) -> None: + return await self._trace_config.on_response_chunk_received.send( + self._session, + self._trace_config_ctx, + TraceResponseChunkReceivedParams(method, url, chunk), + ) + + async def send_request_end( + self, + method: str, + url: URL, + headers: "CIMultiDict[str]", + response: ClientResponse, + ) -> None: + return await self._trace_config.on_request_end.send( + self._session, + self._trace_config_ctx, + TraceRequestEndParams(method, url, headers, response), + ) + + async def send_request_exception( + self, + method: str, + url: URL, + headers: "CIMultiDict[str]", + exception: BaseException, + ) -> None: + return await self._trace_config.on_request_exception.send( + self._session, + self._trace_config_ctx, + TraceRequestExceptionParams(method, url, headers, exception), + ) + + async def send_request_redirect( + self, + method: str, + url: URL, + headers: "CIMultiDict[str]", + response: ClientResponse, + ) -> None: + return await self._trace_config._on_request_redirect.send( + self._session, + self._trace_config_ctx, + TraceRequestRedirectParams(method, url, headers, response), + ) + + async def send_connection_queued_start(self) -> None: + return await self._trace_config.on_connection_queued_start.send( + self._session, self._trace_config_ctx, TraceConnectionQueuedStartParams() + ) + + async def send_connection_queued_end(self) -> None: + return await self._trace_config.on_connection_queued_end.send( + self._session, self._trace_config_ctx, TraceConnectionQueuedEndParams() + ) + + async def send_connection_create_start(self) -> None: + return await self._trace_config.on_connection_create_start.send( + self._session, self._trace_config_ctx, TraceConnectionCreateStartParams() + ) + + async def send_connection_create_end(self) -> None: + return await self._trace_config.on_connection_create_end.send( + self._session, self._trace_config_ctx, TraceConnectionCreateEndParams() + ) + + async def send_connection_reuseconn(self) -> None: + return await self._trace_config.on_connection_reuseconn.send( + self._session, self._trace_config_ctx, TraceConnectionReuseconnParams() + ) + + async def send_dns_resolvehost_start(self, host: str) -> None: + return await self._trace_config.on_dns_resolvehost_start.send( + self._session, self._trace_config_ctx, TraceDnsResolveHostStartParams(host) + ) + + async def send_dns_resolvehost_end(self, host: str) -> None: + return await self._trace_config.on_dns_resolvehost_end.send( + self._session, self._trace_config_ctx, TraceDnsResolveHostEndParams(host) + ) + + async def send_dns_cache_hit(self, host: str) -> None: + return await self._trace_config.on_dns_cache_hit.send( + self._session, self._trace_config_ctx, TraceDnsCacheHitParams(host) + ) + + async def send_dns_cache_miss(self, host: str) -> None: + return await self._trace_config.on_dns_cache_miss.send( + self._session, self._trace_config_ctx, TraceDnsCacheMissParams(host) + ) + + async def send_request_headers( + self, method: str, url: URL, headers: "CIMultiDict[str]" + ) -> None: + return await self._trace_config._on_request_headers_sent.send( + self._session, + self._trace_config_ctx, + TraceRequestHeadersSentParams(method, url, headers), + ) diff --git a/env/Lib/site-packages/aiohttp/typedefs.py b/env/Lib/site-packages/aiohttp/typedefs.py new file mode 100644 index 0000000..9fb21c1 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/typedefs.py @@ -0,0 +1,67 @@ +import json +import os +from typing import ( + TYPE_CHECKING, + Any, + Awaitable, + Callable, + Iterable, + Mapping, + Protocol, + Tuple, + Union, +) + +from multidict import CIMultiDict, CIMultiDictProxy, MultiDict, MultiDictProxy, istr +from yarl import URL + +DEFAULT_JSON_ENCODER = json.dumps +DEFAULT_JSON_DECODER = json.loads + +if TYPE_CHECKING: + _CIMultiDict = CIMultiDict[str] + _CIMultiDictProxy = CIMultiDictProxy[str] + _MultiDict = MultiDict[str] + _MultiDictProxy = MultiDictProxy[str] + from http.cookies import BaseCookie, Morsel + + from .web import Request, StreamResponse +else: + _CIMultiDict = CIMultiDict + _CIMultiDictProxy = CIMultiDictProxy + _MultiDict = MultiDict + _MultiDictProxy = MultiDictProxy + +Byteish = Union[bytes, bytearray, memoryview] +JSONEncoder = Callable[[Any], str] +JSONDecoder = Callable[[str], Any] +LooseHeaders = Union[ + Mapping[str, str], + Mapping[istr, str], + _CIMultiDict, + _CIMultiDictProxy, + Iterable[Tuple[Union[str, istr], str]], +] +RawHeaders = Tuple[Tuple[bytes, bytes], ...] +StrOrURL = Union[str, URL] + +LooseCookiesMappings = Mapping[str, Union[str, "BaseCookie[str]", "Morsel[Any]"]] +LooseCookiesIterables = Iterable[ + Tuple[str, Union[str, "BaseCookie[str]", "Morsel[Any]"]] +] +LooseCookies = Union[ + LooseCookiesMappings, + LooseCookiesIterables, + "BaseCookie[str]", +] + +Handler = Callable[["Request"], Awaitable["StreamResponse"]] + + +class Middleware(Protocol): + def __call__( + self, request: "Request", handler: Handler + ) -> Awaitable["StreamResponse"]: ... + + +PathLike = Union[str, "os.PathLike[str]"] diff --git a/env/Lib/site-packages/aiohttp/web.py b/env/Lib/site-packages/aiohttp/web.py new file mode 100644 index 0000000..8708f1f --- /dev/null +++ b/env/Lib/site-packages/aiohttp/web.py @@ -0,0 +1,590 @@ +import asyncio +import logging +import os +import socket +import sys +import warnings +from argparse import ArgumentParser +from collections.abc import Iterable +from importlib import import_module +from typing import ( + Any, + Awaitable, + Callable, + Iterable as TypingIterable, + List, + Optional, + Set, + Type, + Union, + cast, +) + +from .abc import AbstractAccessLogger +from .helpers import AppKey as AppKey +from .log import access_logger +from .typedefs import PathLike +from .web_app import Application as Application, CleanupError as CleanupError +from .web_exceptions import ( + HTTPAccepted as HTTPAccepted, + HTTPBadGateway as HTTPBadGateway, + HTTPBadRequest as HTTPBadRequest, + HTTPClientError as HTTPClientError, + HTTPConflict as HTTPConflict, + HTTPCreated as HTTPCreated, + HTTPError as HTTPError, + HTTPException as HTTPException, + HTTPExpectationFailed as HTTPExpectationFailed, + HTTPFailedDependency as HTTPFailedDependency, + HTTPForbidden as HTTPForbidden, + HTTPFound as HTTPFound, + HTTPGatewayTimeout as HTTPGatewayTimeout, + HTTPGone as HTTPGone, + HTTPInsufficientStorage as HTTPInsufficientStorage, + HTTPInternalServerError as HTTPInternalServerError, + HTTPLengthRequired as HTTPLengthRequired, + HTTPMethodNotAllowed as HTTPMethodNotAllowed, + HTTPMisdirectedRequest as HTTPMisdirectedRequest, + HTTPMove as HTTPMove, + HTTPMovedPermanently as HTTPMovedPermanently, + HTTPMultipleChoices as HTTPMultipleChoices, + HTTPNetworkAuthenticationRequired as HTTPNetworkAuthenticationRequired, + HTTPNoContent as HTTPNoContent, + HTTPNonAuthoritativeInformation as HTTPNonAuthoritativeInformation, + HTTPNotAcceptable as HTTPNotAcceptable, + HTTPNotExtended as HTTPNotExtended, + HTTPNotFound as HTTPNotFound, + HTTPNotImplemented as HTTPNotImplemented, + HTTPNotModified as HTTPNotModified, + HTTPOk as HTTPOk, + HTTPPartialContent as HTTPPartialContent, + HTTPPaymentRequired as HTTPPaymentRequired, + HTTPPermanentRedirect as HTTPPermanentRedirect, + HTTPPreconditionFailed as HTTPPreconditionFailed, + HTTPPreconditionRequired as HTTPPreconditionRequired, + HTTPProxyAuthenticationRequired as HTTPProxyAuthenticationRequired, + HTTPRedirection as HTTPRedirection, + HTTPRequestEntityTooLarge as HTTPRequestEntityTooLarge, + HTTPRequestHeaderFieldsTooLarge as HTTPRequestHeaderFieldsTooLarge, + HTTPRequestRangeNotSatisfiable as HTTPRequestRangeNotSatisfiable, + HTTPRequestTimeout as HTTPRequestTimeout, + HTTPRequestURITooLong as HTTPRequestURITooLong, + HTTPResetContent as HTTPResetContent, + HTTPSeeOther as HTTPSeeOther, + HTTPServerError as HTTPServerError, + HTTPServiceUnavailable as HTTPServiceUnavailable, + HTTPSuccessful as HTTPSuccessful, + HTTPTemporaryRedirect as HTTPTemporaryRedirect, + HTTPTooManyRequests as HTTPTooManyRequests, + HTTPUnauthorized as HTTPUnauthorized, + HTTPUnavailableForLegalReasons as HTTPUnavailableForLegalReasons, + HTTPUnprocessableEntity as HTTPUnprocessableEntity, + HTTPUnsupportedMediaType as HTTPUnsupportedMediaType, + HTTPUpgradeRequired as HTTPUpgradeRequired, + HTTPUseProxy as HTTPUseProxy, + HTTPVariantAlsoNegotiates as HTTPVariantAlsoNegotiates, + HTTPVersionNotSupported as HTTPVersionNotSupported, + NotAppKeyWarning as NotAppKeyWarning, +) +from .web_fileresponse import FileResponse as FileResponse +from .web_log import AccessLogger +from .web_middlewares import ( + middleware as middleware, + normalize_path_middleware as normalize_path_middleware, +) +from .web_protocol import ( + PayloadAccessError as PayloadAccessError, + RequestHandler as RequestHandler, + RequestPayloadError as RequestPayloadError, +) +from .web_request import ( + BaseRequest as BaseRequest, + FileField as FileField, + Request as Request, +) +from .web_response import ( + ContentCoding as ContentCoding, + Response as Response, + StreamResponse as StreamResponse, + json_response as json_response, +) +from .web_routedef import ( + AbstractRouteDef as AbstractRouteDef, + RouteDef as RouteDef, + RouteTableDef as RouteTableDef, + StaticDef as StaticDef, + delete as delete, + get as get, + head as head, + options as options, + patch as patch, + post as post, + put as put, + route as route, + static as static, + view as view, +) +from .web_runner import ( + AppRunner as AppRunner, + BaseRunner as BaseRunner, + BaseSite as BaseSite, + GracefulExit as GracefulExit, + NamedPipeSite as NamedPipeSite, + ServerRunner as ServerRunner, + SockSite as SockSite, + TCPSite as TCPSite, + UnixSite as UnixSite, +) +from .web_server import Server as Server +from .web_urldispatcher import ( + AbstractResource as AbstractResource, + AbstractRoute as AbstractRoute, + DynamicResource as DynamicResource, + PlainResource as PlainResource, + PrefixedSubAppResource as PrefixedSubAppResource, + Resource as Resource, + ResourceRoute as ResourceRoute, + StaticResource as StaticResource, + UrlDispatcher as UrlDispatcher, + UrlMappingMatchInfo as UrlMappingMatchInfo, + View as View, +) +from .web_ws import ( + WebSocketReady as WebSocketReady, + WebSocketResponse as WebSocketResponse, + WSMsgType as WSMsgType, +) + +__all__ = ( + # web_app + "AppKey", + "Application", + "CleanupError", + # web_exceptions + "NotAppKeyWarning", + "HTTPAccepted", + "HTTPBadGateway", + "HTTPBadRequest", + "HTTPClientError", + "HTTPConflict", + "HTTPCreated", + "HTTPError", + "HTTPException", + "HTTPExpectationFailed", + "HTTPFailedDependency", + "HTTPForbidden", + "HTTPFound", + "HTTPGatewayTimeout", + "HTTPGone", + "HTTPInsufficientStorage", + "HTTPInternalServerError", + "HTTPLengthRequired", + "HTTPMethodNotAllowed", + "HTTPMisdirectedRequest", + "HTTPMove", + "HTTPMovedPermanently", + "HTTPMultipleChoices", + "HTTPNetworkAuthenticationRequired", + "HTTPNoContent", + "HTTPNonAuthoritativeInformation", + "HTTPNotAcceptable", + "HTTPNotExtended", + "HTTPNotFound", + "HTTPNotImplemented", + "HTTPNotModified", + "HTTPOk", + "HTTPPartialContent", + "HTTPPaymentRequired", + "HTTPPermanentRedirect", + "HTTPPreconditionFailed", + "HTTPPreconditionRequired", + "HTTPProxyAuthenticationRequired", + "HTTPRedirection", + "HTTPRequestEntityTooLarge", + "HTTPRequestHeaderFieldsTooLarge", + "HTTPRequestRangeNotSatisfiable", + "HTTPRequestTimeout", + "HTTPRequestURITooLong", + "HTTPResetContent", + "HTTPSeeOther", + "HTTPServerError", + "HTTPServiceUnavailable", + "HTTPSuccessful", + "HTTPTemporaryRedirect", + "HTTPTooManyRequests", + "HTTPUnauthorized", + "HTTPUnavailableForLegalReasons", + "HTTPUnprocessableEntity", + "HTTPUnsupportedMediaType", + "HTTPUpgradeRequired", + "HTTPUseProxy", + "HTTPVariantAlsoNegotiates", + "HTTPVersionNotSupported", + # web_fileresponse + "FileResponse", + # web_middlewares + "middleware", + "normalize_path_middleware", + # web_protocol + "PayloadAccessError", + "RequestHandler", + "RequestPayloadError", + # web_request + "BaseRequest", + "FileField", + "Request", + # web_response + "ContentCoding", + "Response", + "StreamResponse", + "json_response", + # web_routedef + "AbstractRouteDef", + "RouteDef", + "RouteTableDef", + "StaticDef", + "delete", + "get", + "head", + "options", + "patch", + "post", + "put", + "route", + "static", + "view", + # web_runner + "AppRunner", + "BaseRunner", + "BaseSite", + "GracefulExit", + "ServerRunner", + "SockSite", + "TCPSite", + "UnixSite", + "NamedPipeSite", + # web_server + "Server", + # web_urldispatcher + "AbstractResource", + "AbstractRoute", + "DynamicResource", + "PlainResource", + "PrefixedSubAppResource", + "Resource", + "ResourceRoute", + "StaticResource", + "UrlDispatcher", + "UrlMappingMatchInfo", + "View", + # web_ws + "WebSocketReady", + "WebSocketResponse", + "WSMsgType", + # web + "run_app", +) + + +try: + from ssl import SSLContext +except ImportError: # pragma: no cover + SSLContext = Any # type: ignore[misc,assignment] + +# Only display warning when using -Wdefault, -We, -X dev or similar. +warnings.filterwarnings("ignore", category=NotAppKeyWarning, append=True) + +HostSequence = TypingIterable[str] + + +async def _run_app( + app: Union[Application, Awaitable[Application]], + *, + host: Optional[Union[str, HostSequence]] = None, + port: Optional[int] = None, + path: Union[PathLike, TypingIterable[PathLike], None] = None, + sock: Optional[Union[socket.socket, TypingIterable[socket.socket]]] = None, + shutdown_timeout: float = 60.0, + keepalive_timeout: float = 75.0, + ssl_context: Optional[SSLContext] = None, + print: Optional[Callable[..., None]] = print, + backlog: int = 128, + access_log_class: Type[AbstractAccessLogger] = AccessLogger, + access_log_format: str = AccessLogger.LOG_FORMAT, + access_log: Optional[logging.Logger] = access_logger, + handle_signals: bool = True, + reuse_address: Optional[bool] = None, + reuse_port: Optional[bool] = None, + handler_cancellation: bool = False, +) -> None: + # An internal function to actually do all dirty job for application running + if asyncio.iscoroutine(app): + app = await app + + app = cast(Application, app) + + runner = AppRunner( + app, + handle_signals=handle_signals, + access_log_class=access_log_class, + access_log_format=access_log_format, + access_log=access_log, + keepalive_timeout=keepalive_timeout, + shutdown_timeout=shutdown_timeout, + handler_cancellation=handler_cancellation, + ) + + await runner.setup() + + sites: List[BaseSite] = [] + + try: + if host is not None: + if isinstance(host, (str, bytes, bytearray, memoryview)): + sites.append( + TCPSite( + runner, + host, + port, + ssl_context=ssl_context, + backlog=backlog, + reuse_address=reuse_address, + reuse_port=reuse_port, + ) + ) + else: + for h in host: + sites.append( + TCPSite( + runner, + h, + port, + ssl_context=ssl_context, + backlog=backlog, + reuse_address=reuse_address, + reuse_port=reuse_port, + ) + ) + elif path is None and sock is None or port is not None: + sites.append( + TCPSite( + runner, + port=port, + ssl_context=ssl_context, + backlog=backlog, + reuse_address=reuse_address, + reuse_port=reuse_port, + ) + ) + + if path is not None: + if isinstance(path, (str, os.PathLike)): + sites.append( + UnixSite( + runner, + path, + ssl_context=ssl_context, + backlog=backlog, + ) + ) + else: + for p in path: + sites.append( + UnixSite( + runner, + p, + ssl_context=ssl_context, + backlog=backlog, + ) + ) + + if sock is not None: + if not isinstance(sock, Iterable): + sites.append( + SockSite( + runner, + sock, + ssl_context=ssl_context, + backlog=backlog, + ) + ) + else: + for s in sock: + sites.append( + SockSite( + runner, + s, + ssl_context=ssl_context, + backlog=backlog, + ) + ) + for site in sites: + await site.start() + + if print: # pragma: no branch + names = sorted(str(s.name) for s in runner.sites) + print( + "======== Running on {} ========\n" + "(Press CTRL+C to quit)".format(", ".join(names)) + ) + + # sleep forever by 1 hour intervals, + while True: + await asyncio.sleep(3600) + finally: + await runner.cleanup() + + +def _cancel_tasks( + to_cancel: Set["asyncio.Task[Any]"], loop: asyncio.AbstractEventLoop +) -> None: + if not to_cancel: + return + + for task in to_cancel: + task.cancel() + + loop.run_until_complete(asyncio.gather(*to_cancel, return_exceptions=True)) + + for task in to_cancel: + if task.cancelled(): + continue + if task.exception() is not None: + loop.call_exception_handler( + { + "message": "unhandled exception during asyncio.run() shutdown", + "exception": task.exception(), + "task": task, + } + ) + + +def run_app( + app: Union[Application, Awaitable[Application]], + *, + host: Optional[Union[str, HostSequence]] = None, + port: Optional[int] = None, + path: Union[PathLike, TypingIterable[PathLike], None] = None, + sock: Optional[Union[socket.socket, TypingIterable[socket.socket]]] = None, + shutdown_timeout: float = 60.0, + keepalive_timeout: float = 75.0, + ssl_context: Optional[SSLContext] = None, + print: Optional[Callable[..., None]] = print, + backlog: int = 128, + access_log_class: Type[AbstractAccessLogger] = AccessLogger, + access_log_format: str = AccessLogger.LOG_FORMAT, + access_log: Optional[logging.Logger] = access_logger, + handle_signals: bool = True, + reuse_address: Optional[bool] = None, + reuse_port: Optional[bool] = None, + handler_cancellation: bool = False, + loop: Optional[asyncio.AbstractEventLoop] = None, +) -> None: + """Run an app locally""" + if loop is None: + loop = asyncio.new_event_loop() + + # Configure if and only if in debugging mode and using the default logger + if loop.get_debug() and access_log and access_log.name == "aiohttp.access": + if access_log.level == logging.NOTSET: + access_log.setLevel(logging.DEBUG) + if not access_log.hasHandlers(): + access_log.addHandler(logging.StreamHandler()) + + main_task = loop.create_task( + _run_app( + app, + host=host, + port=port, + path=path, + sock=sock, + shutdown_timeout=shutdown_timeout, + keepalive_timeout=keepalive_timeout, + ssl_context=ssl_context, + print=print, + backlog=backlog, + access_log_class=access_log_class, + access_log_format=access_log_format, + access_log=access_log, + handle_signals=handle_signals, + reuse_address=reuse_address, + reuse_port=reuse_port, + handler_cancellation=handler_cancellation, + ) + ) + + try: + asyncio.set_event_loop(loop) + loop.run_until_complete(main_task) + except (GracefulExit, KeyboardInterrupt): # pragma: no cover + pass + finally: + _cancel_tasks({main_task}, loop) + _cancel_tasks(asyncio.all_tasks(loop), loop) + loop.run_until_complete(loop.shutdown_asyncgens()) + loop.close() + + +def main(argv: List[str]) -> None: + arg_parser = ArgumentParser( + description="aiohttp.web Application server", prog="aiohttp.web" + ) + arg_parser.add_argument( + "entry_func", + help=( + "Callable returning the `aiohttp.web.Application` instance to " + "run. Should be specified in the 'module:function' syntax." + ), + metavar="entry-func", + ) + arg_parser.add_argument( + "-H", + "--hostname", + help="TCP/IP hostname to serve on (default: %(default)r)", + default="localhost", + ) + arg_parser.add_argument( + "-P", + "--port", + help="TCP/IP port to serve on (default: %(default)r)", + type=int, + default="8080", + ) + arg_parser.add_argument( + "-U", + "--path", + help="Unix file system path to serve on. Specifying a path will cause " + "hostname and port arguments to be ignored.", + ) + args, extra_argv = arg_parser.parse_known_args(argv) + + # Import logic + mod_str, _, func_str = args.entry_func.partition(":") + if not func_str or not mod_str: + arg_parser.error("'entry-func' not in 'module:function' syntax") + if mod_str.startswith("."): + arg_parser.error("relative module names not supported") + try: + module = import_module(mod_str) + except ImportError as ex: + arg_parser.error(f"unable to import {mod_str}: {ex}") + try: + func = getattr(module, func_str) + except AttributeError: + arg_parser.error(f"module {mod_str!r} has no attribute {func_str!r}") + + # Compatibility logic + if args.path is not None and not hasattr(socket, "AF_UNIX"): + arg_parser.error( + "file system paths not supported by your operating" " environment" + ) + + logging.basicConfig(level=logging.DEBUG) + + app = func(extra_argv) + run_app(app, host=args.hostname, port=args.port, path=args.path) + arg_parser.exit(message="Stopped\n") + + +if __name__ == "__main__": # pragma: no branch + main(sys.argv[1:]) # pragma: no cover diff --git a/env/Lib/site-packages/aiohttp/web_app.py b/env/Lib/site-packages/aiohttp/web_app.py new file mode 100644 index 0000000..3b4b648 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/web_app.py @@ -0,0 +1,590 @@ +import asyncio +import logging +import warnings +from functools import partial, update_wrapper +from typing import ( + TYPE_CHECKING, + Any, + AsyncIterator, + Awaitable, + Callable, + Dict, + Iterable, + Iterator, + List, + Mapping, + MutableMapping, + Optional, + Sequence, + Tuple, + Type, + TypeVar, + Union, + cast, + overload, +) + +from aiosignal import Signal +from frozenlist import FrozenList + +from . import hdrs +from .abc import ( + AbstractAccessLogger, + AbstractMatchInfo, + AbstractRouter, + AbstractStreamWriter, +) +from .helpers import DEBUG, AppKey +from .http_parser import RawRequestMessage +from .log import web_logger +from .streams import StreamReader +from .typedefs import Middleware +from .web_exceptions import NotAppKeyWarning +from .web_log import AccessLogger +from .web_middlewares import _fix_request_current_app +from .web_protocol import RequestHandler +from .web_request import Request +from .web_response import StreamResponse +from .web_routedef import AbstractRouteDef +from .web_server import Server +from .web_urldispatcher import ( + AbstractResource, + AbstractRoute, + Domain, + MaskDomain, + MatchedSubAppResource, + PrefixedSubAppResource, + UrlDispatcher, +) + +__all__ = ("Application", "CleanupError") + + +if TYPE_CHECKING: + _AppSignal = Signal[Callable[["Application"], Awaitable[None]]] + _RespPrepareSignal = Signal[Callable[[Request, StreamResponse], Awaitable[None]]] + _Middlewares = FrozenList[Middleware] + _MiddlewaresHandlers = Optional[Sequence[Tuple[Middleware, bool]]] + _Subapps = List["Application"] +else: + # No type checker mode, skip types + _AppSignal = Signal + _RespPrepareSignal = Signal + _Middlewares = FrozenList + _MiddlewaresHandlers = Optional[Sequence] + _Subapps = List + +_T = TypeVar("_T") +_U = TypeVar("_U") +_Resource = TypeVar("_Resource", bound=AbstractResource) + + +class Application(MutableMapping[Union[str, AppKey[Any]], Any]): + ATTRS = frozenset( + [ + "logger", + "_debug", + "_router", + "_loop", + "_handler_args", + "_middlewares", + "_middlewares_handlers", + "_run_middlewares", + "_state", + "_frozen", + "_pre_frozen", + "_subapps", + "_on_response_prepare", + "_on_startup", + "_on_shutdown", + "_on_cleanup", + "_client_max_size", + "_cleanup_ctx", + ] + ) + + def __init__( + self, + *, + logger: logging.Logger = web_logger, + router: Optional[UrlDispatcher] = None, + middlewares: Iterable[Middleware] = (), + handler_args: Optional[Mapping[str, Any]] = None, + client_max_size: int = 1024**2, + loop: Optional[asyncio.AbstractEventLoop] = None, + debug: Any = ..., # mypy doesn't support ellipsis + ) -> None: + if router is None: + router = UrlDispatcher() + else: + warnings.warn( + "router argument is deprecated", DeprecationWarning, stacklevel=2 + ) + assert isinstance(router, AbstractRouter), router + + if loop is not None: + warnings.warn( + "loop argument is deprecated", DeprecationWarning, stacklevel=2 + ) + + if debug is not ...: + warnings.warn( + "debug argument is deprecated", DeprecationWarning, stacklevel=2 + ) + self._debug = debug + self._router: UrlDispatcher = router + self._loop = loop + self._handler_args = handler_args + self.logger = logger + + self._middlewares: _Middlewares = FrozenList(middlewares) + + # initialized on freezing + self._middlewares_handlers: _MiddlewaresHandlers = None + # initialized on freezing + self._run_middlewares: Optional[bool] = None + + self._state: Dict[Union[AppKey[Any], str], object] = {} + self._frozen = False + self._pre_frozen = False + self._subapps: _Subapps = [] + + self._on_response_prepare: _RespPrepareSignal = Signal(self) + self._on_startup: _AppSignal = Signal(self) + self._on_shutdown: _AppSignal = Signal(self) + self._on_cleanup: _AppSignal = Signal(self) + self._cleanup_ctx = CleanupContext() + self._on_startup.append(self._cleanup_ctx._on_startup) + self._on_cleanup.append(self._cleanup_ctx._on_cleanup) + self._client_max_size = client_max_size + + def __init_subclass__(cls: Type["Application"]) -> None: + warnings.warn( + "Inheritance class {} from web.Application " + "is discouraged".format(cls.__name__), + DeprecationWarning, + stacklevel=3, + ) + + if DEBUG: # pragma: no cover + + def __setattr__(self, name: str, val: Any) -> None: + if name not in self.ATTRS: + warnings.warn( + "Setting custom web.Application.{} attribute " + "is discouraged".format(name), + DeprecationWarning, + stacklevel=2, + ) + super().__setattr__(name, val) + + # MutableMapping API + + def __eq__(self, other: object) -> bool: + return self is other + + @overload # type: ignore[override] + def __getitem__(self, key: AppKey[_T]) -> _T: ... + + @overload + def __getitem__(self, key: str) -> Any: ... + + def __getitem__(self, key: Union[str, AppKey[_T]]) -> Any: + return self._state[key] + + def _check_frozen(self) -> None: + if self._frozen: + warnings.warn( + "Changing state of started or joined " "application is deprecated", + DeprecationWarning, + stacklevel=3, + ) + + @overload # type: ignore[override] + def __setitem__(self, key: AppKey[_T], value: _T) -> None: ... + + @overload + def __setitem__(self, key: str, value: Any) -> None: ... + + def __setitem__(self, key: Union[str, AppKey[_T]], value: Any) -> None: + self._check_frozen() + if not isinstance(key, AppKey): + warnings.warn( + "It is recommended to use web.AppKey instances for keys.\n" + + "https://docs.aiohttp.org/en/stable/web_advanced.html" + + "#application-s-config", + category=NotAppKeyWarning, + stacklevel=2, + ) + self._state[key] = value + + def __delitem__(self, key: Union[str, AppKey[_T]]) -> None: + self._check_frozen() + del self._state[key] + + def __len__(self) -> int: + return len(self._state) + + def __iter__(self) -> Iterator[Union[str, AppKey[Any]]]: + return iter(self._state) + + @overload # type: ignore[override] + def get(self, key: AppKey[_T], default: None = ...) -> Optional[_T]: ... + + @overload + def get(self, key: AppKey[_T], default: _U) -> Union[_T, _U]: ... + + @overload + def get(self, key: str, default: Any = ...) -> Any: ... + + def get(self, key: Union[str, AppKey[_T]], default: Any = None) -> Any: + return self._state.get(key, default) + + ######## + @property + def loop(self) -> asyncio.AbstractEventLoop: + # Technically the loop can be None + # but we mask it by explicit type cast + # to provide more convenient type annotation + warnings.warn("loop property is deprecated", DeprecationWarning, stacklevel=2) + return cast(asyncio.AbstractEventLoop, self._loop) + + def _set_loop(self, loop: Optional[asyncio.AbstractEventLoop]) -> None: + if loop is None: + loop = asyncio.get_event_loop() + if self._loop is not None and self._loop is not loop: + raise RuntimeError( + "web.Application instance initialized with different loop" + ) + + self._loop = loop + + # set loop debug + if self._debug is ...: + self._debug = loop.get_debug() + + # set loop to sub applications + for subapp in self._subapps: + subapp._set_loop(loop) + + @property + def pre_frozen(self) -> bool: + return self._pre_frozen + + def pre_freeze(self) -> None: + if self._pre_frozen: + return + + self._pre_frozen = True + self._middlewares.freeze() + self._router.freeze() + self._on_response_prepare.freeze() + self._cleanup_ctx.freeze() + self._on_startup.freeze() + self._on_shutdown.freeze() + self._on_cleanup.freeze() + self._middlewares_handlers = tuple(self._prepare_middleware()) + + # If current app and any subapp do not have middlewares avoid run all + # of the code footprint that it implies, which have a middleware + # hardcoded per app that sets up the current_app attribute. If no + # middlewares are configured the handler will receive the proper + # current_app without needing all of this code. + self._run_middlewares = True if self.middlewares else False + + for subapp in self._subapps: + subapp.pre_freeze() + self._run_middlewares = self._run_middlewares or subapp._run_middlewares + + @property + def frozen(self) -> bool: + return self._frozen + + def freeze(self) -> None: + if self._frozen: + return + + self.pre_freeze() + self._frozen = True + for subapp in self._subapps: + subapp.freeze() + + @property + def debug(self) -> bool: + warnings.warn("debug property is deprecated", DeprecationWarning, stacklevel=2) + return self._debug # type: ignore[no-any-return] + + def _reg_subapp_signals(self, subapp: "Application") -> None: + def reg_handler(signame: str) -> None: + subsig = getattr(subapp, signame) + + async def handler(app: "Application") -> None: + await subsig.send(subapp) + + appsig = getattr(self, signame) + appsig.append(handler) + + reg_handler("on_startup") + reg_handler("on_shutdown") + reg_handler("on_cleanup") + + def add_subapp(self, prefix: str, subapp: "Application") -> PrefixedSubAppResource: + if not isinstance(prefix, str): + raise TypeError("Prefix must be str") + prefix = prefix.rstrip("/") + if not prefix: + raise ValueError("Prefix cannot be empty") + factory = partial(PrefixedSubAppResource, prefix, subapp) + return self._add_subapp(factory, subapp) + + def _add_subapp( + self, resource_factory: Callable[[], _Resource], subapp: "Application" + ) -> _Resource: + if self.frozen: + raise RuntimeError("Cannot add sub application to frozen application") + if subapp.frozen: + raise RuntimeError("Cannot add frozen application") + resource = resource_factory() + self.router.register_resource(resource) + self._reg_subapp_signals(subapp) + self._subapps.append(subapp) + subapp.pre_freeze() + if self._loop is not None: + subapp._set_loop(self._loop) + return resource + + def add_domain(self, domain: str, subapp: "Application") -> MatchedSubAppResource: + if not isinstance(domain, str): + raise TypeError("Domain must be str") + elif "*" in domain: + rule: Domain = MaskDomain(domain) + else: + rule = Domain(domain) + factory = partial(MatchedSubAppResource, rule, subapp) + return self._add_subapp(factory, subapp) + + def add_routes(self, routes: Iterable[AbstractRouteDef]) -> List[AbstractRoute]: + return self.router.add_routes(routes) + + @property + def on_response_prepare(self) -> _RespPrepareSignal: + return self._on_response_prepare + + @property + def on_startup(self) -> _AppSignal: + return self._on_startup + + @property + def on_shutdown(self) -> _AppSignal: + return self._on_shutdown + + @property + def on_cleanup(self) -> _AppSignal: + return self._on_cleanup + + @property + def cleanup_ctx(self) -> "CleanupContext": + return self._cleanup_ctx + + @property + def router(self) -> UrlDispatcher: + return self._router + + @property + def middlewares(self) -> _Middlewares: + return self._middlewares + + def _make_handler( + self, + *, + loop: Optional[asyncio.AbstractEventLoop] = None, + access_log_class: Type[AbstractAccessLogger] = AccessLogger, + **kwargs: Any, + ) -> Server: + + if not issubclass(access_log_class, AbstractAccessLogger): + raise TypeError( + "access_log_class must be subclass of " + "aiohttp.abc.AbstractAccessLogger, got {}".format(access_log_class) + ) + + self._set_loop(loop) + self.freeze() + + kwargs["debug"] = self._debug + kwargs["access_log_class"] = access_log_class + if self._handler_args: + for k, v in self._handler_args.items(): + kwargs[k] = v + + return Server( + self._handle, # type: ignore[arg-type] + request_factory=self._make_request, + loop=self._loop, + **kwargs, + ) + + def make_handler( + self, + *, + loop: Optional[asyncio.AbstractEventLoop] = None, + access_log_class: Type[AbstractAccessLogger] = AccessLogger, + **kwargs: Any, + ) -> Server: + + warnings.warn( + "Application.make_handler(...) is deprecated, " "use AppRunner API instead", + DeprecationWarning, + stacklevel=2, + ) + + return self._make_handler( + loop=loop, access_log_class=access_log_class, **kwargs + ) + + async def startup(self) -> None: + """Causes on_startup signal + + Should be called in the event loop along with the request handler. + """ + await self.on_startup.send(self) + + async def shutdown(self) -> None: + """Causes on_shutdown signal + + Should be called before cleanup() + """ + await self.on_shutdown.send(self) + + async def cleanup(self) -> None: + """Causes on_cleanup signal + + Should be called after shutdown() + """ + if self.on_cleanup.frozen: + await self.on_cleanup.send(self) + else: + # If an exception occurs in startup, ensure cleanup contexts are completed. + await self._cleanup_ctx._on_cleanup(self) + + def _make_request( + self, + message: RawRequestMessage, + payload: StreamReader, + protocol: RequestHandler, + writer: AbstractStreamWriter, + task: "asyncio.Task[None]", + _cls: Type[Request] = Request, + ) -> Request: + return _cls( + message, + payload, + protocol, + writer, + task, + self._loop, + client_max_size=self._client_max_size, + ) + + def _prepare_middleware(self) -> Iterator[Tuple[Middleware, bool]]: + for m in reversed(self._middlewares): + if getattr(m, "__middleware_version__", None) == 1: + yield m, True + else: + warnings.warn( + 'old-style middleware "{!r}" deprecated, ' "see #2252".format(m), + DeprecationWarning, + stacklevel=2, + ) + yield m, False + + yield _fix_request_current_app(self), True + + async def _handle(self, request: Request) -> StreamResponse: + loop = asyncio.get_event_loop() + debug = loop.get_debug() + match_info = await self._router.resolve(request) + if debug: # pragma: no cover + if not isinstance(match_info, AbstractMatchInfo): + raise TypeError( + "match_info should be AbstractMatchInfo " + "instance, not {!r}".format(match_info) + ) + match_info.add_app(self) + + match_info.freeze() + + resp = None + request._match_info = match_info + expect = request.headers.get(hdrs.EXPECT) + if expect: + resp = await match_info.expect_handler(request) + await request.writer.drain() + + if resp is None: + handler = match_info.handler + + if self._run_middlewares: + for app in match_info.apps[::-1]: + for m, new_style in app._middlewares_handlers: # type: ignore[union-attr] + if new_style: + handler = update_wrapper( + partial(m, handler=handler), handler # type: ignore[misc] + ) + else: + handler = await m(app, handler) # type: ignore[arg-type,assignment] + + resp = await handler(request) + + return resp + + def __call__(self) -> "Application": + """gunicorn compatibility""" + return self + + def __repr__(self) -> str: + return f"" + + def __bool__(self) -> bool: + return True + + +class CleanupError(RuntimeError): + @property + def exceptions(self) -> List[BaseException]: + return cast(List[BaseException], self.args[1]) + + +if TYPE_CHECKING: + _CleanupContextBase = FrozenList[Callable[[Application], AsyncIterator[None]]] +else: + _CleanupContextBase = FrozenList + + +class CleanupContext(_CleanupContextBase): + def __init__(self) -> None: + super().__init__() + self._exits: List[AsyncIterator[None]] = [] + + async def _on_startup(self, app: Application) -> None: + for cb in self: + it = cb(app).__aiter__() + await it.__anext__() + self._exits.append(it) + + async def _on_cleanup(self, app: Application) -> None: + errors = [] + for it in reversed(self._exits): + try: + await it.__anext__() + except StopAsyncIteration: + pass + except Exception as exc: + errors.append(exc) + else: + errors.append(RuntimeError(f"{it!r} has more than one 'yield'")) + if errors: + if len(errors) == 1: + raise errors[0] + else: + raise CleanupError("Multiple errors on cleanup stage", errors) diff --git a/env/Lib/site-packages/aiohttp/web_exceptions.py b/env/Lib/site-packages/aiohttp/web_exceptions.py new file mode 100644 index 0000000..ee2c1e7 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/web_exceptions.py @@ -0,0 +1,452 @@ +import warnings +from typing import Any, Dict, Iterable, List, Optional, Set # noqa + +from yarl import URL + +from .typedefs import LooseHeaders, StrOrURL +from .web_response import Response + +__all__ = ( + "HTTPException", + "HTTPError", + "HTTPRedirection", + "HTTPSuccessful", + "HTTPOk", + "HTTPCreated", + "HTTPAccepted", + "HTTPNonAuthoritativeInformation", + "HTTPNoContent", + "HTTPResetContent", + "HTTPPartialContent", + "HTTPMove", + "HTTPMultipleChoices", + "HTTPMovedPermanently", + "HTTPFound", + "HTTPSeeOther", + "HTTPNotModified", + "HTTPUseProxy", + "HTTPTemporaryRedirect", + "HTTPPermanentRedirect", + "HTTPClientError", + "HTTPBadRequest", + "HTTPUnauthorized", + "HTTPPaymentRequired", + "HTTPForbidden", + "HTTPNotFound", + "HTTPMethodNotAllowed", + "HTTPNotAcceptable", + "HTTPProxyAuthenticationRequired", + "HTTPRequestTimeout", + "HTTPConflict", + "HTTPGone", + "HTTPLengthRequired", + "HTTPPreconditionFailed", + "HTTPRequestEntityTooLarge", + "HTTPRequestURITooLong", + "HTTPUnsupportedMediaType", + "HTTPRequestRangeNotSatisfiable", + "HTTPExpectationFailed", + "HTTPMisdirectedRequest", + "HTTPUnprocessableEntity", + "HTTPFailedDependency", + "HTTPUpgradeRequired", + "HTTPPreconditionRequired", + "HTTPTooManyRequests", + "HTTPRequestHeaderFieldsTooLarge", + "HTTPUnavailableForLegalReasons", + "HTTPServerError", + "HTTPInternalServerError", + "HTTPNotImplemented", + "HTTPBadGateway", + "HTTPServiceUnavailable", + "HTTPGatewayTimeout", + "HTTPVersionNotSupported", + "HTTPVariantAlsoNegotiates", + "HTTPInsufficientStorage", + "HTTPNotExtended", + "HTTPNetworkAuthenticationRequired", +) + + +class NotAppKeyWarning(UserWarning): + """Warning when not using AppKey in Application.""" + + +############################################################ +# HTTP Exceptions +############################################################ + + +class HTTPException(Response, Exception): + + # You should set in subclasses: + # status = 200 + + status_code = -1 + empty_body = False + + __http_exception__ = True + + def __init__( + self, + *, + headers: Optional[LooseHeaders] = None, + reason: Optional[str] = None, + body: Any = None, + text: Optional[str] = None, + content_type: Optional[str] = None, + ) -> None: + if body is not None: + warnings.warn( + "body argument is deprecated for http web exceptions", + DeprecationWarning, + ) + Response.__init__( + self, + status=self.status_code, + headers=headers, + reason=reason, + body=body, + text=text, + content_type=content_type, + ) + Exception.__init__(self, self.reason) + if self.body is None and not self.empty_body: + self.text = f"{self.status}: {self.reason}" + + def __bool__(self) -> bool: + return True + + +class HTTPError(HTTPException): + """Base class for exceptions with status codes in the 400s and 500s.""" + + +class HTTPRedirection(HTTPException): + """Base class for exceptions with status codes in the 300s.""" + + +class HTTPSuccessful(HTTPException): + """Base class for exceptions with status codes in the 200s.""" + + +class HTTPOk(HTTPSuccessful): + status_code = 200 + + +class HTTPCreated(HTTPSuccessful): + status_code = 201 + + +class HTTPAccepted(HTTPSuccessful): + status_code = 202 + + +class HTTPNonAuthoritativeInformation(HTTPSuccessful): + status_code = 203 + + +class HTTPNoContent(HTTPSuccessful): + status_code = 204 + empty_body = True + + +class HTTPResetContent(HTTPSuccessful): + status_code = 205 + empty_body = True + + +class HTTPPartialContent(HTTPSuccessful): + status_code = 206 + + +############################################################ +# 3xx redirection +############################################################ + + +class HTTPMove(HTTPRedirection): + def __init__( + self, + location: StrOrURL, + *, + headers: Optional[LooseHeaders] = None, + reason: Optional[str] = None, + body: Any = None, + text: Optional[str] = None, + content_type: Optional[str] = None, + ) -> None: + if not location: + raise ValueError("HTTP redirects need a location to redirect to.") + super().__init__( + headers=headers, + reason=reason, + body=body, + text=text, + content_type=content_type, + ) + self.headers["Location"] = str(URL(location)) + self.location = location + + +class HTTPMultipleChoices(HTTPMove): + status_code = 300 + + +class HTTPMovedPermanently(HTTPMove): + status_code = 301 + + +class HTTPFound(HTTPMove): + status_code = 302 + + +# This one is safe after a POST (the redirected location will be +# retrieved with GET): +class HTTPSeeOther(HTTPMove): + status_code = 303 + + +class HTTPNotModified(HTTPRedirection): + # FIXME: this should include a date or etag header + status_code = 304 + empty_body = True + + +class HTTPUseProxy(HTTPMove): + # Not a move, but looks a little like one + status_code = 305 + + +class HTTPTemporaryRedirect(HTTPMove): + status_code = 307 + + +class HTTPPermanentRedirect(HTTPMove): + status_code = 308 + + +############################################################ +# 4xx client error +############################################################ + + +class HTTPClientError(HTTPError): + pass + + +class HTTPBadRequest(HTTPClientError): + status_code = 400 + + +class HTTPUnauthorized(HTTPClientError): + status_code = 401 + + +class HTTPPaymentRequired(HTTPClientError): + status_code = 402 + + +class HTTPForbidden(HTTPClientError): + status_code = 403 + + +class HTTPNotFound(HTTPClientError): + status_code = 404 + + +class HTTPMethodNotAllowed(HTTPClientError): + status_code = 405 + + def __init__( + self, + method: str, + allowed_methods: Iterable[str], + *, + headers: Optional[LooseHeaders] = None, + reason: Optional[str] = None, + body: Any = None, + text: Optional[str] = None, + content_type: Optional[str] = None, + ) -> None: + allow = ",".join(sorted(allowed_methods)) + super().__init__( + headers=headers, + reason=reason, + body=body, + text=text, + content_type=content_type, + ) + self.headers["Allow"] = allow + self.allowed_methods: Set[str] = set(allowed_methods) + self.method = method.upper() + + +class HTTPNotAcceptable(HTTPClientError): + status_code = 406 + + +class HTTPProxyAuthenticationRequired(HTTPClientError): + status_code = 407 + + +class HTTPRequestTimeout(HTTPClientError): + status_code = 408 + + +class HTTPConflict(HTTPClientError): + status_code = 409 + + +class HTTPGone(HTTPClientError): + status_code = 410 + + +class HTTPLengthRequired(HTTPClientError): + status_code = 411 + + +class HTTPPreconditionFailed(HTTPClientError): + status_code = 412 + + +class HTTPRequestEntityTooLarge(HTTPClientError): + status_code = 413 + + def __init__(self, max_size: float, actual_size: float, **kwargs: Any) -> None: + kwargs.setdefault( + "text", + "Maximum request body size {} exceeded, " + "actual body size {}".format(max_size, actual_size), + ) + super().__init__(**kwargs) + + +class HTTPRequestURITooLong(HTTPClientError): + status_code = 414 + + +class HTTPUnsupportedMediaType(HTTPClientError): + status_code = 415 + + +class HTTPRequestRangeNotSatisfiable(HTTPClientError): + status_code = 416 + + +class HTTPExpectationFailed(HTTPClientError): + status_code = 417 + + +class HTTPMisdirectedRequest(HTTPClientError): + status_code = 421 + + +class HTTPUnprocessableEntity(HTTPClientError): + status_code = 422 + + +class HTTPFailedDependency(HTTPClientError): + status_code = 424 + + +class HTTPUpgradeRequired(HTTPClientError): + status_code = 426 + + +class HTTPPreconditionRequired(HTTPClientError): + status_code = 428 + + +class HTTPTooManyRequests(HTTPClientError): + status_code = 429 + + +class HTTPRequestHeaderFieldsTooLarge(HTTPClientError): + status_code = 431 + + +class HTTPUnavailableForLegalReasons(HTTPClientError): + status_code = 451 + + def __init__( + self, + link: Optional[StrOrURL], + *, + headers: Optional[LooseHeaders] = None, + reason: Optional[str] = None, + body: Any = None, + text: Optional[str] = None, + content_type: Optional[str] = None, + ) -> None: + super().__init__( + headers=headers, + reason=reason, + body=body, + text=text, + content_type=content_type, + ) + self._link = None + if link: + self._link = URL(link) + self.headers["Link"] = f'<{str(self._link)}>; rel="blocked-by"' + + @property + def link(self) -> Optional[URL]: + return self._link + + +############################################################ +# 5xx Server Error +############################################################ +# Response status codes beginning with the digit "5" indicate cases in +# which the server is aware that it has erred or is incapable of +# performing the request. Except when responding to a HEAD request, the +# server SHOULD include an entity containing an explanation of the error +# situation, and whether it is a temporary or permanent condition. User +# agents SHOULD display any included entity to the user. These response +# codes are applicable to any request method. + + +class HTTPServerError(HTTPError): + pass + + +class HTTPInternalServerError(HTTPServerError): + status_code = 500 + + +class HTTPNotImplemented(HTTPServerError): + status_code = 501 + + +class HTTPBadGateway(HTTPServerError): + status_code = 502 + + +class HTTPServiceUnavailable(HTTPServerError): + status_code = 503 + + +class HTTPGatewayTimeout(HTTPServerError): + status_code = 504 + + +class HTTPVersionNotSupported(HTTPServerError): + status_code = 505 + + +class HTTPVariantAlsoNegotiates(HTTPServerError): + status_code = 506 + + +class HTTPInsufficientStorage(HTTPServerError): + status_code = 507 + + +class HTTPNotExtended(HTTPServerError): + status_code = 510 + + +class HTTPNetworkAuthenticationRequired(HTTPServerError): + status_code = 511 diff --git a/env/Lib/site-packages/aiohttp/web_fileresponse.py b/env/Lib/site-packages/aiohttp/web_fileresponse.py new file mode 100644 index 0000000..0c23e37 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/web_fileresponse.py @@ -0,0 +1,357 @@ +import asyncio +import os +import pathlib +import sys +from contextlib import suppress +from mimetypes import MimeTypes +from stat import S_ISREG +from types import MappingProxyType +from typing import ( # noqa + IO, + TYPE_CHECKING, + Any, + Awaitable, + Callable, + Final, + Iterator, + List, + Optional, + Tuple, + Union, + cast, +) + +from . import hdrs +from .abc import AbstractStreamWriter +from .helpers import ETAG_ANY, ETag, must_be_empty_body +from .typedefs import LooseHeaders, PathLike +from .web_exceptions import ( + HTTPForbidden, + HTTPNotFound, + HTTPNotModified, + HTTPPartialContent, + HTTPPreconditionFailed, + HTTPRequestRangeNotSatisfiable, +) +from .web_response import StreamResponse + +__all__ = ("FileResponse",) + +if TYPE_CHECKING: + from .web_request import BaseRequest + + +_T_OnChunkSent = Optional[Callable[[bytes], Awaitable[None]]] + + +NOSENDFILE: Final[bool] = bool(os.environ.get("AIOHTTP_NOSENDFILE")) + +CONTENT_TYPES: Final[MimeTypes] = MimeTypes() + +if sys.version_info < (3, 9): + CONTENT_TYPES.encodings_map[".br"] = "br" + +# File extension to IANA encodings map that will be checked in the order defined. +ENCODING_EXTENSIONS = MappingProxyType( + {ext: CONTENT_TYPES.encodings_map[ext] for ext in (".br", ".gz")} +) + +FALLBACK_CONTENT_TYPE = "application/octet-stream" + +# Provide additional MIME type/extension pairs to be recognized. +# https://en.wikipedia.org/wiki/List_of_archive_formats#Compression_only +ADDITIONAL_CONTENT_TYPES = MappingProxyType( + { + "application/gzip": ".gz", + "application/x-brotli": ".br", + "application/x-bzip2": ".bz2", + "application/x-compress": ".Z", + "application/x-xz": ".xz", + } +) + +# Add custom pairs and clear the encodings map so guess_type ignores them. +CONTENT_TYPES.encodings_map.clear() +for content_type, extension in ADDITIONAL_CONTENT_TYPES.items(): + CONTENT_TYPES.add_type(content_type, extension) # type: ignore[attr-defined] + + +class FileResponse(StreamResponse): + """A response object can be used to send files.""" + + def __init__( + self, + path: PathLike, + chunk_size: int = 256 * 1024, + status: int = 200, + reason: Optional[str] = None, + headers: Optional[LooseHeaders] = None, + ) -> None: + super().__init__(status=status, reason=reason, headers=headers) + + self._path = pathlib.Path(path) + self._chunk_size = chunk_size + + async def _sendfile_fallback( + self, writer: AbstractStreamWriter, fobj: IO[Any], offset: int, count: int + ) -> AbstractStreamWriter: + # To keep memory usage low,fobj is transferred in chunks + # controlled by the constructor's chunk_size argument. + + chunk_size = self._chunk_size + loop = asyncio.get_event_loop() + + await loop.run_in_executor(None, fobj.seek, offset) + + chunk = await loop.run_in_executor(None, fobj.read, chunk_size) + while chunk: + await writer.write(chunk) + count = count - chunk_size + if count <= 0: + break + chunk = await loop.run_in_executor(None, fobj.read, min(chunk_size, count)) + + await writer.drain() + return writer + + async def _sendfile( + self, request: "BaseRequest", fobj: IO[Any], offset: int, count: int + ) -> AbstractStreamWriter: + writer = await super().prepare(request) + assert writer is not None + + if NOSENDFILE or self.compression: + return await self._sendfile_fallback(writer, fobj, offset, count) + + loop = request._loop + transport = request.transport + assert transport is not None + + try: + await loop.sendfile(transport, fobj, offset, count) + except NotImplementedError: + return await self._sendfile_fallback(writer, fobj, offset, count) + + await super().write_eof() + return writer + + @staticmethod + def _strong_etag_match(etag_value: str, etags: Tuple[ETag, ...]) -> bool: + if len(etags) == 1 and etags[0].value == ETAG_ANY: + return True + return any(etag.value == etag_value for etag in etags if not etag.is_weak) + + async def _not_modified( + self, request: "BaseRequest", etag_value: str, last_modified: float + ) -> Optional[AbstractStreamWriter]: + self.set_status(HTTPNotModified.status_code) + self._length_check = False + self.etag = etag_value # type: ignore[assignment] + self.last_modified = last_modified # type: ignore[assignment] + # Delete any Content-Length headers provided by user. HTTP 304 + # should always have empty response body + return await super().prepare(request) + + async def _precondition_failed( + self, request: "BaseRequest" + ) -> Optional[AbstractStreamWriter]: + self.set_status(HTTPPreconditionFailed.status_code) + self.content_length = 0 + return await super().prepare(request) + + def _get_file_path_stat_encoding( + self, accept_encoding: str + ) -> Tuple[pathlib.Path, os.stat_result, Optional[str]]: + """Return the file path, stat result, and encoding. + + If an uncompressed file is returned, the encoding is set to + :py:data:`None`. + + This method should be called from a thread executor + since it calls os.stat which may block. + """ + file_path = self._path + for file_extension, file_encoding in ENCODING_EXTENSIONS.items(): + if file_encoding not in accept_encoding: + continue + + compressed_path = file_path.with_suffix(file_path.suffix + file_extension) + with suppress(OSError): + # Do not follow symlinks and ignore any non-regular files. + st = compressed_path.lstat() + if S_ISREG(st.st_mode): + return compressed_path, st, file_encoding + + # Fallback to the uncompressed file + return file_path, file_path.stat(), None + + async def prepare(self, request: "BaseRequest") -> Optional[AbstractStreamWriter]: + loop = asyncio.get_running_loop() + # Encoding comparisons should be case-insensitive + # https://www.rfc-editor.org/rfc/rfc9110#section-8.4.1 + accept_encoding = request.headers.get(hdrs.ACCEPT_ENCODING, "").lower() + try: + file_path, st, file_encoding = await loop.run_in_executor( + None, self._get_file_path_stat_encoding, accept_encoding + ) + except OSError: + # Most likely to be FileNotFoundError or OSError for circular + # symlinks in python >= 3.13, so respond with 404. + self.set_status(HTTPNotFound.status_code) + return await super().prepare(request) + + # Forbid special files like sockets, pipes, devices, etc. + if not S_ISREG(st.st_mode): + self.set_status(HTTPForbidden.status_code) + return await super().prepare(request) + + etag_value = f"{st.st_mtime_ns:x}-{st.st_size:x}" + last_modified = st.st_mtime + + # https://tools.ietf.org/html/rfc7232#section-6 + ifmatch = request.if_match + if ifmatch is not None and not self._strong_etag_match(etag_value, ifmatch): + return await self._precondition_failed(request) + + unmodsince = request.if_unmodified_since + if ( + unmodsince is not None + and ifmatch is None + and st.st_mtime > unmodsince.timestamp() + ): + return await self._precondition_failed(request) + + ifnonematch = request.if_none_match + if ifnonematch is not None and self._strong_etag_match(etag_value, ifnonematch): + return await self._not_modified(request, etag_value, last_modified) + + modsince = request.if_modified_since + if ( + modsince is not None + and ifnonematch is None + and st.st_mtime <= modsince.timestamp() + ): + return await self._not_modified(request, etag_value, last_modified) + + status = self._status + file_size = st.st_size + count = file_size + + start = None + + ifrange = request.if_range + if ifrange is None or st.st_mtime <= ifrange.timestamp(): + # If-Range header check: + # condition = cached date >= last modification date + # return 206 if True else 200. + # if False: + # Range header would not be processed, return 200 + # if True but Range header missing + # return 200 + try: + rng = request.http_range + start = rng.start + end = rng.stop + except ValueError: + # https://tools.ietf.org/html/rfc7233: + # A server generating a 416 (Range Not Satisfiable) response to + # a byte-range request SHOULD send a Content-Range header field + # with an unsatisfied-range value. + # The complete-length in a 416 response indicates the current + # length of the selected representation. + # + # Will do the same below. Many servers ignore this and do not + # send a Content-Range header with HTTP 416 + self.headers[hdrs.CONTENT_RANGE] = f"bytes */{file_size}" + self.set_status(HTTPRequestRangeNotSatisfiable.status_code) + return await super().prepare(request) + + # If a range request has been made, convert start, end slice + # notation into file pointer offset and count + if start is not None or end is not None: + if start < 0 and end is None: # return tail of file + start += file_size + if start < 0: + # if Range:bytes=-1000 in request header but file size + # is only 200, there would be trouble without this + start = 0 + count = file_size - start + else: + # rfc7233:If the last-byte-pos value is + # absent, or if the value is greater than or equal to + # the current length of the representation data, + # the byte range is interpreted as the remainder + # of the representation (i.e., the server replaces the + # value of last-byte-pos with a value that is one less than + # the current length of the selected representation). + count = ( + min(end if end is not None else file_size, file_size) - start + ) + + if start >= file_size: + # HTTP 416 should be returned in this case. + # + # According to https://tools.ietf.org/html/rfc7233: + # If a valid byte-range-set includes at least one + # byte-range-spec with a first-byte-pos that is less than + # the current length of the representation, or at least one + # suffix-byte-range-spec with a non-zero suffix-length, + # then the byte-range-set is satisfiable. Otherwise, the + # byte-range-set is unsatisfiable. + self.headers[hdrs.CONTENT_RANGE] = f"bytes */{file_size}" + self.set_status(HTTPRequestRangeNotSatisfiable.status_code) + return await super().prepare(request) + + status = HTTPPartialContent.status_code + # Even though you are sending the whole file, you should still + # return a HTTP 206 for a Range request. + self.set_status(status) + + # If the Content-Type header is not already set, guess it based on the + # extension of the request path. The encoding returned by guess_type + # can be ignored since the map was cleared above. + if hdrs.CONTENT_TYPE not in self.headers: + self.content_type = ( + CONTENT_TYPES.guess_type(self._path)[0] or FALLBACK_CONTENT_TYPE + ) + + if file_encoding: + self.headers[hdrs.CONTENT_ENCODING] = file_encoding + self.headers[hdrs.VARY] = hdrs.ACCEPT_ENCODING + # Disable compression if we are already sending + # a compressed file since we don't want to double + # compress. + self._compression = False + + self.etag = etag_value # type: ignore[assignment] + self.last_modified = st.st_mtime # type: ignore[assignment] + self.content_length = count + + self.headers[hdrs.ACCEPT_RANGES] = "bytes" + + real_start = cast(int, start) + + if status == HTTPPartialContent.status_code: + self.headers[hdrs.CONTENT_RANGE] = "bytes {}-{}/{}".format( + real_start, real_start + count - 1, file_size + ) + + # If we are sending 0 bytes calling sendfile() will throw a ValueError + if count == 0 or must_be_empty_body(request.method, self.status): + return await super().prepare(request) + + try: + fobj = await loop.run_in_executor(None, file_path.open, "rb") + except PermissionError: + self.set_status(HTTPForbidden.status_code) + return await super().prepare(request) + + if start: # be aware that start could be None or int=0 here. + offset = start + else: + offset = 0 + + try: + return await self._sendfile(request, fobj, offset, count) + finally: + await asyncio.shield(loop.run_in_executor(None, fobj.close)) diff --git a/env/Lib/site-packages/aiohttp/web_log.py b/env/Lib/site-packages/aiohttp/web_log.py new file mode 100644 index 0000000..633e9e3 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/web_log.py @@ -0,0 +1,213 @@ +import datetime +import functools +import logging +import os +import re +import time as time_mod +from collections import namedtuple +from typing import Any, Callable, Dict, Iterable, List, Tuple # noqa + +from .abc import AbstractAccessLogger +from .web_request import BaseRequest +from .web_response import StreamResponse + +KeyMethod = namedtuple("KeyMethod", "key method") + + +class AccessLogger(AbstractAccessLogger): + """Helper object to log access. + + Usage: + log = logging.getLogger("spam") + log_format = "%a %{User-Agent}i" + access_logger = AccessLogger(log, log_format) + access_logger.log(request, response, time) + + Format: + %% The percent sign + %a Remote IP-address (IP-address of proxy if using reverse proxy) + %t Time when the request was started to process + %P The process ID of the child that serviced the request + %r First line of request + %s Response status code + %b Size of response in bytes, including HTTP headers + %T Time taken to serve the request, in seconds + %Tf Time taken to serve the request, in seconds with floating fraction + in .06f format + %D Time taken to serve the request, in microseconds + %{FOO}i request.headers['FOO'] + %{FOO}o response.headers['FOO'] + %{FOO}e os.environ['FOO'] + + """ + + LOG_FORMAT_MAP = { + "a": "remote_address", + "t": "request_start_time", + "P": "process_id", + "r": "first_request_line", + "s": "response_status", + "b": "response_size", + "T": "request_time", + "Tf": "request_time_frac", + "D": "request_time_micro", + "i": "request_header", + "o": "response_header", + } + + LOG_FORMAT = '%a %t "%r" %s %b "%{Referer}i" "%{User-Agent}i"' + FORMAT_RE = re.compile(r"%(\{([A-Za-z0-9\-_]+)\}([ioe])|[atPrsbOD]|Tf?)") + CLEANUP_RE = re.compile(r"(%[^s])") + _FORMAT_CACHE: Dict[str, Tuple[str, List[KeyMethod]]] = {} + + def __init__(self, logger: logging.Logger, log_format: str = LOG_FORMAT) -> None: + """Initialise the logger. + + logger is a logger object to be used for logging. + log_format is a string with apache compatible log format description. + + """ + super().__init__(logger, log_format=log_format) + + _compiled_format = AccessLogger._FORMAT_CACHE.get(log_format) + if not _compiled_format: + _compiled_format = self.compile_format(log_format) + AccessLogger._FORMAT_CACHE[log_format] = _compiled_format + + self._log_format, self._methods = _compiled_format + + def compile_format(self, log_format: str) -> Tuple[str, List[KeyMethod]]: + """Translate log_format into form usable by modulo formatting + + All known atoms will be replaced with %s + Also methods for formatting of those atoms will be added to + _methods in appropriate order + + For example we have log_format = "%a %t" + This format will be translated to "%s %s" + Also contents of _methods will be + [self._format_a, self._format_t] + These method will be called and results will be passed + to translated string format. + + Each _format_* method receive 'args' which is list of arguments + given to self.log + + Exceptions are _format_e, _format_i and _format_o methods which + also receive key name (by functools.partial) + + """ + # list of (key, method) tuples, we don't use an OrderedDict as users + # can repeat the same key more than once + methods = list() + + for atom in self.FORMAT_RE.findall(log_format): + if atom[1] == "": + format_key1 = self.LOG_FORMAT_MAP[atom[0]] + m = getattr(AccessLogger, "_format_%s" % atom[0]) + key_method = KeyMethod(format_key1, m) + else: + format_key2 = (self.LOG_FORMAT_MAP[atom[2]], atom[1]) + m = getattr(AccessLogger, "_format_%s" % atom[2]) + key_method = KeyMethod(format_key2, functools.partial(m, atom[1])) + + methods.append(key_method) + + log_format = self.FORMAT_RE.sub(r"%s", log_format) + log_format = self.CLEANUP_RE.sub(r"%\1", log_format) + return log_format, methods + + @staticmethod + def _format_i( + key: str, request: BaseRequest, response: StreamResponse, time: float + ) -> str: + if request is None: + return "(no headers)" + + # suboptimal, make istr(key) once + return request.headers.get(key, "-") + + @staticmethod + def _format_o( + key: str, request: BaseRequest, response: StreamResponse, time: float + ) -> str: + # suboptimal, make istr(key) once + return response.headers.get(key, "-") + + @staticmethod + def _format_a(request: BaseRequest, response: StreamResponse, time: float) -> str: + if request is None: + return "-" + ip = request.remote + return ip if ip is not None else "-" + + @staticmethod + def _format_t(request: BaseRequest, response: StreamResponse, time: float) -> str: + tz = datetime.timezone(datetime.timedelta(seconds=-time_mod.timezone)) + now = datetime.datetime.now(tz) + start_time = now - datetime.timedelta(seconds=time) + return start_time.strftime("[%d/%b/%Y:%H:%M:%S %z]") + + @staticmethod + def _format_P(request: BaseRequest, response: StreamResponse, time: float) -> str: + return "<%s>" % os.getpid() + + @staticmethod + def _format_r(request: BaseRequest, response: StreamResponse, time: float) -> str: + if request is None: + return "-" + return "{} {} HTTP/{}.{}".format( + request.method, + request.path_qs, + request.version.major, + request.version.minor, + ) + + @staticmethod + def _format_s(request: BaseRequest, response: StreamResponse, time: float) -> int: + return response.status + + @staticmethod + def _format_b(request: BaseRequest, response: StreamResponse, time: float) -> int: + return response.body_length + + @staticmethod + def _format_T(request: BaseRequest, response: StreamResponse, time: float) -> str: + return str(round(time)) + + @staticmethod + def _format_Tf(request: BaseRequest, response: StreamResponse, time: float) -> str: + return "%06f" % time + + @staticmethod + def _format_D(request: BaseRequest, response: StreamResponse, time: float) -> str: + return str(round(time * 1000000)) + + def _format_line( + self, request: BaseRequest, response: StreamResponse, time: float + ) -> Iterable[Tuple[str, Callable[[BaseRequest, StreamResponse, float], str]]]: + return [(key, method(request, response, time)) for key, method in self._methods] + + def log(self, request: BaseRequest, response: StreamResponse, time: float) -> None: + if not self.logger.isEnabledFor(logging.INFO): + # Avoid formatting the log line if it will not be emitted. + return + try: + fmt_info = self._format_line(request, response, time) + + values = list() + extra = dict() + for key, value in fmt_info: + values.append(value) + + if key.__class__ is str: + extra[key] = value + else: + k1, k2 = key # type: ignore[misc] + dct = extra.get(k1, {}) # type: ignore[var-annotated,has-type] + dct[k2] = value # type: ignore[index,has-type] + extra[k1] = dct # type: ignore[has-type,assignment] + + self.logger.info(self._log_format % tuple(values), extra=extra) + except Exception: + self.logger.exception("Error in logging") diff --git a/env/Lib/site-packages/aiohttp/web_middlewares.py b/env/Lib/site-packages/aiohttp/web_middlewares.py new file mode 100644 index 0000000..5da1533 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/web_middlewares.py @@ -0,0 +1,116 @@ +import re +from typing import TYPE_CHECKING, Tuple, Type, TypeVar + +from .typedefs import Handler, Middleware +from .web_exceptions import HTTPMove, HTTPPermanentRedirect +from .web_request import Request +from .web_response import StreamResponse +from .web_urldispatcher import SystemRoute + +__all__ = ( + "middleware", + "normalize_path_middleware", +) + +if TYPE_CHECKING: + from .web_app import Application + +_Func = TypeVar("_Func") + + +async def _check_request_resolves(request: Request, path: str) -> Tuple[bool, Request]: + alt_request = request.clone(rel_url=path) + + match_info = await request.app.router.resolve(alt_request) + alt_request._match_info = match_info + + if match_info.http_exception is None: + return True, alt_request + + return False, request + + +def middleware(f: _Func) -> _Func: + f.__middleware_version__ = 1 # type: ignore[attr-defined] + return f + + +def normalize_path_middleware( + *, + append_slash: bool = True, + remove_slash: bool = False, + merge_slashes: bool = True, + redirect_class: Type[HTTPMove] = HTTPPermanentRedirect, +) -> Middleware: + """Factory for producing a middleware that normalizes the path of a request. + + Normalizing means: + - Add or remove a trailing slash to the path. + - Double slashes are replaced by one. + + The middleware returns as soon as it finds a path that resolves + correctly. The order if both merge and append/remove are enabled is + 1) merge slashes + 2) append/remove slash + 3) both merge slashes and append/remove slash. + If the path resolves with at least one of those conditions, it will + redirect to the new path. + + Only one of `append_slash` and `remove_slash` can be enabled. If both + are `True` the factory will raise an assertion error + + If `append_slash` is `True` the middleware will append a slash when + needed. If a resource is defined with trailing slash and the request + comes without it, it will append it automatically. + + If `remove_slash` is `True`, `append_slash` must be `False`. When enabled + the middleware will remove trailing slashes and redirect if the resource + is defined + + If merge_slashes is True, merge multiple consecutive slashes in the + path into one. + """ + correct_configuration = not (append_slash and remove_slash) + assert correct_configuration, "Cannot both remove and append slash" + + @middleware + async def impl(request: Request, handler: Handler) -> StreamResponse: + if isinstance(request.match_info.route, SystemRoute): + paths_to_check = [] + if "?" in request.raw_path: + path, query = request.raw_path.split("?", 1) + query = "?" + query + else: + query = "" + path = request.raw_path + + if merge_slashes: + paths_to_check.append(re.sub("//+", "/", path)) + if append_slash and not request.path.endswith("/"): + paths_to_check.append(path + "/") + if remove_slash and request.path.endswith("/"): + paths_to_check.append(path[:-1]) + if merge_slashes and append_slash: + paths_to_check.append(re.sub("//+", "/", path + "/")) + if merge_slashes and remove_slash: + merged_slashes = re.sub("//+", "/", path) + paths_to_check.append(merged_slashes[:-1]) + + for path in paths_to_check: + path = re.sub("^//+", "/", path) # SECURITY: GHSA-v6wp-4m6f-gcjg + resolves, request = await _check_request_resolves(request, path) + if resolves: + raise redirect_class(request.raw_path + query) + + return await handler(request) + + return impl + + +def _fix_request_current_app(app: "Application") -> Middleware: + @middleware + async def impl(request: Request, handler: Handler) -> StreamResponse: + with request.match_info.set_current_app(app): + return await handler(request) + + return impl diff --git a/env/Lib/site-packages/aiohttp/web_protocol.py b/env/Lib/site-packages/aiohttp/web_protocol.py new file mode 100644 index 0000000..39e1c8b --- /dev/null +++ b/env/Lib/site-packages/aiohttp/web_protocol.py @@ -0,0 +1,714 @@ +import asyncio +import asyncio.streams +import sys +import traceback +import warnings +from collections import deque +from contextlib import suppress +from html import escape as html_escape +from http import HTTPStatus +from logging import Logger +from typing import ( + TYPE_CHECKING, + Any, + Awaitable, + Callable, + Deque, + Optional, + Sequence, + Tuple, + Type, + Union, + cast, +) + +import attr +import yarl + +from .abc import AbstractAccessLogger, AbstractStreamWriter +from .base_protocol import BaseProtocol +from .helpers import ceil_timeout, set_exception +from .http import ( + HttpProcessingError, + HttpRequestParser, + HttpVersion10, + RawRequestMessage, + StreamWriter, +) +from .log import access_logger, server_logger +from .streams import EMPTY_PAYLOAD, StreamReader +from .tcp_helpers import tcp_keepalive +from .web_exceptions import HTTPException +from .web_log import AccessLogger +from .web_request import BaseRequest +from .web_response import Response, StreamResponse + +__all__ = ("RequestHandler", "RequestPayloadError", "PayloadAccessError") + +if TYPE_CHECKING: + from .web_server import Server + + +_RequestFactory = Callable[ + [ + RawRequestMessage, + StreamReader, + "RequestHandler", + AbstractStreamWriter, + "asyncio.Task[None]", + ], + BaseRequest, +] + +_RequestHandler = Callable[[BaseRequest], Awaitable[StreamResponse]] + +ERROR = RawRequestMessage( + "UNKNOWN", + "/", + HttpVersion10, + {}, # type: ignore[arg-type] + {}, # type: ignore[arg-type] + True, + None, + False, + False, + yarl.URL("/"), +) + + +class RequestPayloadError(Exception): + """Payload parsing error.""" + + +class PayloadAccessError(Exception): + """Payload was accessed after response was sent.""" + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class _ErrInfo: + status: int + exc: BaseException + message: str + + +_MsgType = Tuple[Union[RawRequestMessage, _ErrInfo], StreamReader] + + +class RequestHandler(BaseProtocol): + """HTTP protocol implementation. + + RequestHandler handles incoming HTTP request. It reads request line, + request headers and request payload and calls handle_request() method. + By default it always returns with 404 response. + + RequestHandler handles errors in incoming request, like bad + status line, bad headers or incomplete payload. If any error occurs, + connection gets closed. + + keepalive_timeout -- number of seconds before closing + keep-alive connection + + tcp_keepalive -- TCP keep-alive is on, default is on + + debug -- enable debug mode + + logger -- custom logger object + + access_log_class -- custom class for access_logger + + access_log -- custom logging object + + access_log_format -- access log format string + + loop -- Optional event loop + + max_line_size -- Optional maximum header line size + + max_field_size -- Optional maximum header field size + + max_headers -- Optional maximum header size + + timeout_ceil_threshold -- Optional value to specify + threshold to ceil() timeout + values + + """ + + __slots__ = ( + "_request_count", + "_keepalive", + "_manager", + "_request_handler", + "_request_factory", + "_tcp_keepalive", + "_next_keepalive_close_time", + "_keepalive_handle", + "_keepalive_timeout", + "_lingering_time", + "_messages", + "_message_tail", + "_handler_waiter", + "_waiter", + "_task_handler", + "_upgrade", + "_payload_parser", + "_request_parser", + "_reading_paused", + "logger", + "debug", + "access_log", + "access_logger", + "_close", + "_force_close", + "_current_request", + "_timeout_ceil_threshold", + ) + + def __init__( + self, + manager: "Server", + *, + loop: asyncio.AbstractEventLoop, + keepalive_timeout: float = 75.0, # NGINX default is 75 secs + tcp_keepalive: bool = True, + logger: Logger = server_logger, + access_log_class: Type[AbstractAccessLogger] = AccessLogger, + access_log: Logger = access_logger, + access_log_format: str = AccessLogger.LOG_FORMAT, + debug: bool = False, + max_line_size: int = 8190, + max_headers: int = 32768, + max_field_size: int = 8190, + lingering_time: float = 10.0, + read_bufsize: int = 2**16, + auto_decompress: bool = True, + timeout_ceil_threshold: float = 5, + ): + super().__init__(loop) + + self._request_count = 0 + self._keepalive = False + self._current_request: Optional[BaseRequest] = None + self._manager: Optional[Server] = manager + self._request_handler: Optional[_RequestHandler] = manager.request_handler + self._request_factory: Optional[_RequestFactory] = manager.request_factory + + self._tcp_keepalive = tcp_keepalive + # placeholder to be replaced on keepalive timeout setup + self._next_keepalive_close_time = 0.0 + self._keepalive_handle: Optional[asyncio.Handle] = None + self._keepalive_timeout = keepalive_timeout + self._lingering_time = float(lingering_time) + + self._messages: Deque[_MsgType] = deque() + self._message_tail = b"" + + self._waiter: Optional[asyncio.Future[None]] = None + self._handler_waiter: Optional[asyncio.Future[None]] = None + self._task_handler: Optional[asyncio.Task[None]] = None + + self._upgrade = False + self._payload_parser: Any = None + self._request_parser: Optional[HttpRequestParser] = HttpRequestParser( + self, + loop, + read_bufsize, + max_line_size=max_line_size, + max_field_size=max_field_size, + max_headers=max_headers, + payload_exception=RequestPayloadError, + auto_decompress=auto_decompress, + ) + + self._timeout_ceil_threshold: float = 5 + try: + self._timeout_ceil_threshold = float(timeout_ceil_threshold) + except (TypeError, ValueError): + pass + + self.logger = logger + self.debug = debug + self.access_log = access_log + if access_log: + self.access_logger: Optional[AbstractAccessLogger] = access_log_class( + access_log, access_log_format + ) + else: + self.access_logger = None + + self._close = False + self._force_close = False + + def __repr__(self) -> str: + return "<{} {}>".format( + self.__class__.__name__, + "connected" if self.transport is not None else "disconnected", + ) + + @property + def keepalive_timeout(self) -> float: + return self._keepalive_timeout + + async def shutdown(self, timeout: Optional[float] = 15.0) -> None: + """Do worker process exit preparations. + + We need to clean up everything and stop accepting requests. + It is especially important for keep-alive connections. + """ + self._force_close = True + + if self._keepalive_handle is not None: + self._keepalive_handle.cancel() + + if self._waiter: + self._waiter.cancel() + + # Wait for graceful handler completion + if self._handler_waiter is not None: + with suppress(asyncio.CancelledError, asyncio.TimeoutError): + async with ceil_timeout(timeout): + await self._handler_waiter + # Then cancel handler and wait + with suppress(asyncio.CancelledError, asyncio.TimeoutError): + async with ceil_timeout(timeout): + if self._current_request is not None: + self._current_request._cancel(asyncio.CancelledError()) + + if self._task_handler is not None and not self._task_handler.done(): + await self._task_handler + + # force-close non-idle handler + if self._task_handler is not None: + self._task_handler.cancel() + + if self.transport is not None: + self.transport.close() + self.transport = None + + def connection_made(self, transport: asyncio.BaseTransport) -> None: + super().connection_made(transport) + + real_transport = cast(asyncio.Transport, transport) + if self._tcp_keepalive: + tcp_keepalive(real_transport) + + assert self._manager is not None + self._manager.connection_made(self, real_transport) + + loop = self._loop + if sys.version_info >= (3, 12): + task = asyncio.Task(self.start(), loop=loop, eager_start=True) + else: + task = loop.create_task(self.start()) + self._task_handler = task + + def connection_lost(self, exc: Optional[BaseException]) -> None: + if self._manager is None: + return + self._manager.connection_lost(self, exc) + + super().connection_lost(exc) + + # Grab value before setting _manager to None. + handler_cancellation = self._manager.handler_cancellation + + self._manager = None + self._force_close = True + self._request_factory = None + self._request_handler = None + self._request_parser = None + + if self._keepalive_handle is not None: + self._keepalive_handle.cancel() + + if self._current_request is not None: + if exc is None: + exc = ConnectionResetError("Connection lost") + self._current_request._cancel(exc) + + if self._waiter is not None: + self._waiter.cancel() + + if handler_cancellation and self._task_handler is not None: + self._task_handler.cancel() + + self._task_handler = None + + if self._payload_parser is not None: + self._payload_parser.feed_eof() + self._payload_parser = None + + def set_parser(self, parser: Any) -> None: + # Actual type is WebReader + assert self._payload_parser is None + + self._payload_parser = parser + + if self._message_tail: + self._payload_parser.feed_data(self._message_tail) + self._message_tail = b"" + + def eof_received(self) -> None: + pass + + def data_received(self, data: bytes) -> None: + if self._force_close or self._close: + return + # parse http messages + messages: Sequence[_MsgType] + if self._payload_parser is None and not self._upgrade: + assert self._request_parser is not None + try: + messages, upgraded, tail = self._request_parser.feed_data(data) + except HttpProcessingError as exc: + messages = [ + (_ErrInfo(status=400, exc=exc, message=exc.message), EMPTY_PAYLOAD) + ] + upgraded = False + tail = b"" + + for msg, payload in messages or (): + self._request_count += 1 + self._messages.append((msg, payload)) + + waiter = self._waiter + if messages and waiter is not None and not waiter.done(): + # don't set result twice + waiter.set_result(None) + + self._upgrade = upgraded + if upgraded and tail: + self._message_tail = tail + + # no parser, just store + elif self._payload_parser is None and self._upgrade and data: + self._message_tail += data + + # feed payload + elif data: + eof, tail = self._payload_parser.feed_data(data) + if eof: + self.close() + + def keep_alive(self, val: bool) -> None: + """Set keep-alive connection mode. + + :param bool val: new state. + """ + self._keepalive = val + if self._keepalive_handle: + self._keepalive_handle.cancel() + self._keepalive_handle = None + + def close(self) -> None: + """Close connection. + + Stop accepting new pipelining messages and close + connection when handlers done processing messages. + """ + self._close = True + if self._waiter: + self._waiter.cancel() + + def force_close(self) -> None: + """Forcefully close connection.""" + self._force_close = True + if self._waiter: + self._waiter.cancel() + if self.transport is not None: + self.transport.close() + self.transport = None + + def log_access( + self, request: BaseRequest, response: StreamResponse, time: float + ) -> None: + if self.access_logger is not None: + self.access_logger.log(request, response, self._loop.time() - time) + + def log_debug(self, *args: Any, **kw: Any) -> None: + if self.debug: + self.logger.debug(*args, **kw) + + def log_exception(self, *args: Any, **kw: Any) -> None: + self.logger.exception(*args, **kw) + + def _process_keepalive(self) -> None: + self._keepalive_handle = None + if self._force_close or not self._keepalive: + return + + loop = self._loop + now = loop.time() + close_time = self._next_keepalive_close_time + if now <= close_time: + # Keep alive close check fired too early, reschedule + self._keepalive_handle = loop.call_at(close_time, self._process_keepalive) + return + + # handler in idle state + if self._waiter: + self.force_close() + + async def _handle_request( + self, + request: BaseRequest, + start_time: float, + request_handler: Callable[[BaseRequest], Awaitable[StreamResponse]], + ) -> Tuple[StreamResponse, bool]: + self._handler_waiter = self._loop.create_future() + try: + try: + self._current_request = request + resp = await request_handler(request) + finally: + self._current_request = None + except HTTPException as exc: + resp = exc + reset = await self.finish_response(request, resp, start_time) + except asyncio.CancelledError: + raise + except asyncio.TimeoutError as exc: + self.log_debug("Request handler timed out.", exc_info=exc) + resp = self.handle_error(request, 504) + reset = await self.finish_response(request, resp, start_time) + except Exception as exc: + resp = self.handle_error(request, 500, exc) + reset = await self.finish_response(request, resp, start_time) + else: + # Deprecation warning (See #2415) + if getattr(resp, "__http_exception__", False): + warnings.warn( + "returning HTTPException object is deprecated " + "(#2415) and will be removed, " + "please raise the exception instead", + DeprecationWarning, + ) + + reset = await self.finish_response(request, resp, start_time) + finally: + self._handler_waiter.set_result(None) + + return resp, reset + + async def start(self) -> None: + """Process incoming request. + + It reads request line, request headers and request payload, then + calls handle_request() method. Subclass has to override + handle_request(). start() handles various exceptions in request + or response handling. Connection is being closed always unless + keep_alive(True) specified. + """ + loop = self._loop + handler = asyncio.current_task(loop) + assert handler is not None + manager = self._manager + assert manager is not None + keepalive_timeout = self._keepalive_timeout + resp = None + assert self._request_factory is not None + assert self._request_handler is not None + + while not self._force_close: + if not self._messages: + try: + # wait for next request + self._waiter = loop.create_future() + await self._waiter + except asyncio.CancelledError: + break + finally: + self._waiter = None + + message, payload = self._messages.popleft() + + start = loop.time() + + manager.requests_count += 1 + writer = StreamWriter(self, loop) + if isinstance(message, _ErrInfo): + # make request_factory work + request_handler = self._make_error_handler(message) + message = ERROR + else: + request_handler = self._request_handler + + request = self._request_factory(message, payload, self, writer, handler) + try: + # a new task is used for copy context vars (#3406) + coro = self._handle_request(request, start, request_handler) + if sys.version_info >= (3, 12): + task = asyncio.Task(coro, loop=loop, eager_start=True) + else: + task = loop.create_task(coro) + try: + resp, reset = await task + except (asyncio.CancelledError, ConnectionError): + self.log_debug("Ignored premature client disconnection") + break + + # Drop the processed task from asyncio.Task.all_tasks() early + del task + if reset: + self.log_debug("Ignored premature client disconnection 2") + break + + # notify server about keep-alive + self._keepalive = bool(resp.keep_alive) + + # check payload + if not payload.is_eof(): + lingering_time = self._lingering_time + if not self._force_close and lingering_time: + self.log_debug( + "Start lingering close timer for %s sec.", lingering_time + ) + + now = loop.time() + end_t = now + lingering_time + + with suppress(asyncio.TimeoutError, asyncio.CancelledError): + while not payload.is_eof() and now < end_t: + async with ceil_timeout(end_t - now): + # read and ignore + await payload.readany() + now = loop.time() + + # if payload still uncompleted + if not payload.is_eof() and not self._force_close: + self.log_debug("Uncompleted request.") + self.close() + + set_exception(payload, PayloadAccessError()) + + except asyncio.CancelledError: + self.log_debug("Ignored premature client disconnection ") + break + except RuntimeError as exc: + if self.debug: + self.log_exception("Unhandled runtime exception", exc_info=exc) + self.force_close() + except Exception as exc: + self.log_exception("Unhandled exception", exc_info=exc) + self.force_close() + finally: + if self.transport is None and resp is not None: + self.log_debug("Ignored premature client disconnection.") + elif not self._force_close: + if self._keepalive and not self._close: + # start keep-alive timer + if keepalive_timeout is not None: + now = loop.time() + close_time = now + keepalive_timeout + self._next_keepalive_close_time = close_time + if self._keepalive_handle is None: + self._keepalive_handle = loop.call_at( + close_time, self._process_keepalive + ) + else: + break + + # remove handler, close transport if no handlers left + if not self._force_close: + self._task_handler = None + if self.transport is not None: + self.transport.close() + + async def finish_response( + self, request: BaseRequest, resp: StreamResponse, start_time: float + ) -> bool: + """Prepare the response and write_eof, then log access. + + This has to + be called within the context of any exception so the access logger + can get exception information. Returns True if the client disconnects + prematurely. + """ + request._finish() + if self._request_parser is not None: + self._request_parser.set_upgraded(False) + self._upgrade = False + if self._message_tail: + self._request_parser.feed_data(self._message_tail) + self._message_tail = b"" + try: + prepare_meth = resp.prepare + except AttributeError: + if resp is None: + raise RuntimeError("Missing return " "statement on request handler") + else: + raise RuntimeError( + "Web-handler should return " + "a response instance, " + "got {!r}".format(resp) + ) + try: + await prepare_meth(request) + await resp.write_eof() + except ConnectionError: + self.log_access(request, resp, start_time) + return True + else: + self.log_access(request, resp, start_time) + return False + + def handle_error( + self, + request: BaseRequest, + status: int = 500, + exc: Optional[BaseException] = None, + message: Optional[str] = None, + ) -> StreamResponse: + """Handle errors. + + Returns HTTP response with specific status code. Logs additional + information. It always closes current connection. + """ + self.log_exception("Error handling request", exc_info=exc) + + # some data already got sent, connection is broken + if request.writer.output_size > 0: + raise ConnectionError( + "Response is sent already, cannot send another response " + "with the error message" + ) + + ct = "text/plain" + if status == HTTPStatus.INTERNAL_SERVER_ERROR: + title = "{0.value} {0.phrase}".format(HTTPStatus.INTERNAL_SERVER_ERROR) + msg = HTTPStatus.INTERNAL_SERVER_ERROR.description + tb = None + if self.debug: + with suppress(Exception): + tb = traceback.format_exc() + + if "text/html" in request.headers.get("Accept", ""): + if tb: + tb = html_escape(tb) + msg = f"

        Traceback:

        \n
        {tb}
        " + message = ( + "" + "{title}" + "\n

        {title}

        " + "\n{msg}\n\n" + ).format(title=title, msg=msg) + ct = "text/html" + else: + if tb: + msg = tb + message = title + "\n\n" + msg + + resp = Response(status=status, text=message, content_type=ct) + resp.force_close() + + return resp + + def _make_error_handler( + self, err_info: _ErrInfo + ) -> Callable[[BaseRequest], Awaitable[StreamResponse]]: + async def handler(request: BaseRequest) -> StreamResponse: + return self.handle_error( + request, err_info.status, err_info.exc, err_info.message + ) + + return handler diff --git a/env/Lib/site-packages/aiohttp/web_request.py b/env/Lib/site-packages/aiohttp/web_request.py new file mode 100644 index 0000000..a485f0d --- /dev/null +++ b/env/Lib/site-packages/aiohttp/web_request.py @@ -0,0 +1,914 @@ +import asyncio +import datetime +import io +import re +import socket +import string +import tempfile +import types +import warnings +from http.cookies import SimpleCookie +from types import MappingProxyType +from typing import ( + TYPE_CHECKING, + Any, + Dict, + Final, + Iterator, + Mapping, + MutableMapping, + Optional, + Pattern, + Tuple, + Union, + cast, +) +from urllib.parse import parse_qsl + +import attr +from multidict import ( + CIMultiDict, + CIMultiDictProxy, + MultiDict, + MultiDictProxy, + MultiMapping, +) +from yarl import URL + +from . import hdrs +from .abc import AbstractStreamWriter +from .helpers import ( + _SENTINEL, + DEBUG, + ETAG_ANY, + LIST_QUOTED_ETAG_RE, + ChainMapProxy, + ETag, + HeadersMixin, + parse_http_date, + reify, + sentinel, + set_exception, +) +from .http_parser import RawRequestMessage +from .http_writer import HttpVersion +from .multipart import BodyPartReader, MultipartReader +from .streams import EmptyStreamReader, StreamReader +from .typedefs import ( + DEFAULT_JSON_DECODER, + JSONDecoder, + LooseHeaders, + RawHeaders, + StrOrURL, +) +from .web_exceptions import HTTPRequestEntityTooLarge +from .web_response import StreamResponse + +__all__ = ("BaseRequest", "FileField", "Request") + + +if TYPE_CHECKING: + from .web_app import Application + from .web_protocol import RequestHandler + from .web_urldispatcher import UrlMappingMatchInfo + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class FileField: + name: str + filename: str + file: io.BufferedReader + content_type: str + headers: "CIMultiDictProxy[str]" + + +_TCHAR: Final[str] = string.digits + string.ascii_letters + r"!#$%&'*+.^_`|~-" +# '-' at the end to prevent interpretation as range in a char class + +_TOKEN: Final[str] = rf"[{_TCHAR}]+" + +_QDTEXT: Final[str] = r"[{}]".format( + r"".join(chr(c) for c in (0x09, 0x20, 0x21) + tuple(range(0x23, 0x7F))) +) +# qdtext includes 0x5C to escape 0x5D ('\]') +# qdtext excludes obs-text (because obsoleted, and encoding not specified) + +_QUOTED_PAIR: Final[str] = r"\\[\t !-~]" + +_QUOTED_STRING: Final[str] = r'"(?:{quoted_pair}|{qdtext})*"'.format( + qdtext=_QDTEXT, quoted_pair=_QUOTED_PAIR +) + +_FORWARDED_PAIR: Final[str] = ( + r"({token})=({token}|{quoted_string})(:\d{{1,4}})?".format( + token=_TOKEN, quoted_string=_QUOTED_STRING + ) +) + +_QUOTED_PAIR_REPLACE_RE: Final[Pattern[str]] = re.compile(r"\\([\t !-~])") +# same pattern as _QUOTED_PAIR but contains a capture group + +_FORWARDED_PAIR_RE: Final[Pattern[str]] = re.compile(_FORWARDED_PAIR) + +############################################################ +# HTTP Request +############################################################ + + +class BaseRequest(MutableMapping[str, Any], HeadersMixin): + + POST_METHODS = { + hdrs.METH_PATCH, + hdrs.METH_POST, + hdrs.METH_PUT, + hdrs.METH_TRACE, + hdrs.METH_DELETE, + } + + ATTRS = HeadersMixin.ATTRS | frozenset( + [ + "_message", + "_protocol", + "_payload_writer", + "_payload", + "_headers", + "_method", + "_version", + "_rel_url", + "_post", + "_read_bytes", + "_state", + "_cache", + "_task", + "_client_max_size", + "_loop", + "_transport_sslcontext", + "_transport_peername", + ] + ) + + def __init__( + self, + message: RawRequestMessage, + payload: StreamReader, + protocol: "RequestHandler", + payload_writer: AbstractStreamWriter, + task: "asyncio.Task[None]", + loop: asyncio.AbstractEventLoop, + *, + client_max_size: int = 1024**2, + state: Optional[Dict[str, Any]] = None, + scheme: Optional[str] = None, + host: Optional[str] = None, + remote: Optional[str] = None, + ) -> None: + if state is None: + state = {} + self._message = message + self._protocol = protocol + self._payload_writer = payload_writer + + self._payload = payload + self._headers = message.headers + self._method = message.method + self._version = message.version + self._cache: Dict[str, Any] = {} + url = message.url + if url.is_absolute(): + # absolute URL is given, + # override auto-calculating url, host, and scheme + # all other properties should be good + self._cache["url"] = url + self._cache["host"] = url.host + self._cache["scheme"] = url.scheme + self._rel_url = url.relative() + else: + self._rel_url = message.url + self._post: Optional[MultiDictProxy[Union[str, bytes, FileField]]] = None + self._read_bytes: Optional[bytes] = None + + self._state = state + self._task = task + self._client_max_size = client_max_size + self._loop = loop + + transport = self._protocol.transport + assert transport is not None + self._transport_sslcontext = transport.get_extra_info("sslcontext") + self._transport_peername = transport.get_extra_info("peername") + + if scheme is not None: + self._cache["scheme"] = scheme + if host is not None: + self._cache["host"] = host + if remote is not None: + self._cache["remote"] = remote + + def clone( + self, + *, + method: Union[str, _SENTINEL] = sentinel, + rel_url: Union[StrOrURL, _SENTINEL] = sentinel, + headers: Union[LooseHeaders, _SENTINEL] = sentinel, + scheme: Union[str, _SENTINEL] = sentinel, + host: Union[str, _SENTINEL] = sentinel, + remote: Union[str, _SENTINEL] = sentinel, + client_max_size: Union[int, _SENTINEL] = sentinel, + ) -> "BaseRequest": + """Clone itself with replacement some attributes. + + Creates and returns a new instance of Request object. If no parameters + are given, an exact copy is returned. If a parameter is not passed, it + will reuse the one from the current request object. + """ + if self._read_bytes: + raise RuntimeError("Cannot clone request " "after reading its content") + + dct: Dict[str, Any] = {} + if method is not sentinel: + dct["method"] = method + if rel_url is not sentinel: + new_url: URL = URL(rel_url) + dct["url"] = new_url + dct["path"] = str(new_url) + if headers is not sentinel: + # a copy semantic + dct["headers"] = CIMultiDictProxy(CIMultiDict(headers)) + dct["raw_headers"] = tuple( + (k.encode("utf-8"), v.encode("utf-8")) + for k, v in dct["headers"].items() + ) + + message = self._message._replace(**dct) + + kwargs = {} + if scheme is not sentinel: + kwargs["scheme"] = scheme + if host is not sentinel: + kwargs["host"] = host + if remote is not sentinel: + kwargs["remote"] = remote + if client_max_size is sentinel: + client_max_size = self._client_max_size + + return self.__class__( + message, + self._payload, + self._protocol, + self._payload_writer, + self._task, + self._loop, + client_max_size=client_max_size, + state=self._state.copy(), + **kwargs, + ) + + @property + def task(self) -> "asyncio.Task[None]": + return self._task + + @property + def protocol(self) -> "RequestHandler": + return self._protocol + + @property + def transport(self) -> Optional[asyncio.Transport]: + if self._protocol is None: + return None + return self._protocol.transport + + @property + def writer(self) -> AbstractStreamWriter: + return self._payload_writer + + @property + def client_max_size(self) -> int: + return self._client_max_size + + @reify + def message(self) -> RawRequestMessage: + warnings.warn("Request.message is deprecated", DeprecationWarning, stacklevel=3) + return self._message + + @reify + def rel_url(self) -> URL: + return self._rel_url + + @reify + def loop(self) -> asyncio.AbstractEventLoop: + warnings.warn( + "request.loop property is deprecated", DeprecationWarning, stacklevel=2 + ) + return self._loop + + # MutableMapping API + + def __getitem__(self, key: str) -> Any: + return self._state[key] + + def __setitem__(self, key: str, value: Any) -> None: + self._state[key] = value + + def __delitem__(self, key: str) -> None: + del self._state[key] + + def __len__(self) -> int: + return len(self._state) + + def __iter__(self) -> Iterator[str]: + return iter(self._state) + + ######## + + @reify + def secure(self) -> bool: + """A bool indicating if the request is handled with SSL.""" + return self.scheme == "https" + + @reify + def forwarded(self) -> Tuple[Mapping[str, str], ...]: + """A tuple containing all parsed Forwarded header(s). + + Makes an effort to parse Forwarded headers as specified by RFC 7239: + + - It adds one (immutable) dictionary per Forwarded 'field-value', ie + per proxy. The element corresponds to the data in the Forwarded + field-value added by the first proxy encountered by the client. Each + subsequent item corresponds to those added by later proxies. + - It checks that every value has valid syntax in general as specified + in section 4: either a 'token' or a 'quoted-string'. + - It un-escapes found escape sequences. + - It does NOT validate 'by' and 'for' contents as specified in section + 6. + - It does NOT validate 'host' contents (Host ABNF). + - It does NOT validate 'proto' contents for valid URI scheme names. + + Returns a tuple containing one or more immutable dicts + """ + elems = [] + for field_value in self._message.headers.getall(hdrs.FORWARDED, ()): + length = len(field_value) + pos = 0 + need_separator = False + elem: Dict[str, str] = {} + elems.append(types.MappingProxyType(elem)) + while 0 <= pos < length: + match = _FORWARDED_PAIR_RE.match(field_value, pos) + if match is not None: # got a valid forwarded-pair + if need_separator: + # bad syntax here, skip to next comma + pos = field_value.find(",", pos) + else: + name, value, port = match.groups() + if value[0] == '"': + # quoted string: remove quotes and unescape + value = _QUOTED_PAIR_REPLACE_RE.sub(r"\1", value[1:-1]) + if port: + value += port + elem[name.lower()] = value + pos += len(match.group(0)) + need_separator = True + elif field_value[pos] == ",": # next forwarded-element + need_separator = False + elem = {} + elems.append(types.MappingProxyType(elem)) + pos += 1 + elif field_value[pos] == ";": # next forwarded-pair + need_separator = False + pos += 1 + elif field_value[pos] in " \t": + # Allow whitespace even between forwarded-pairs, though + # RFC 7239 doesn't. This simplifies code and is in line + # with Postel's law. + pos += 1 + else: + # bad syntax here, skip to next comma + pos = field_value.find(",", pos) + return tuple(elems) + + @reify + def scheme(self) -> str: + """A string representing the scheme of the request. + + Hostname is resolved in this order: + + - overridden value by .clone(scheme=new_scheme) call. + - type of connection to peer: HTTPS if socket is SSL, HTTP otherwise. + + 'http' or 'https'. + """ + if self._transport_sslcontext: + return "https" + else: + return "http" + + @reify + def method(self) -> str: + """Read only property for getting HTTP method. + + The value is upper-cased str like 'GET', 'POST', 'PUT' etc. + """ + return self._method + + @reify + def version(self) -> HttpVersion: + """Read only property for getting HTTP version of request. + + Returns aiohttp.protocol.HttpVersion instance. + """ + return self._version + + @reify + def host(self) -> str: + """Hostname of the request. + + Hostname is resolved in this order: + + - overridden value by .clone(host=new_host) call. + - HOST HTTP header + - socket.getfqdn() value + """ + host = self._message.headers.get(hdrs.HOST) + if host is not None: + return host + return socket.getfqdn() + + @reify + def remote(self) -> Optional[str]: + """Remote IP of client initiated HTTP request. + + The IP is resolved in this order: + + - overridden value by .clone(remote=new_remote) call. + - peername of opened socket + """ + if self._transport_peername is None: + return None + if isinstance(self._transport_peername, (list, tuple)): + return str(self._transport_peername[0]) + return str(self._transport_peername) + + @reify + def url(self) -> URL: + url = URL.build(scheme=self.scheme, host=self.host) + return url.join(self._rel_url) + + @reify + def path(self) -> str: + """The URL including *PATH INFO* without the host or scheme. + + E.g., ``/app/blog`` + """ + return self._rel_url.path + + @reify + def path_qs(self) -> str: + """The URL including PATH_INFO and the query string. + + E.g, /app/blog?id=10 + """ + return str(self._rel_url) + + @reify + def raw_path(self) -> str: + """The URL including raw *PATH INFO* without the host or scheme. + + Warning, the path is unquoted and may contains non valid URL characters + + E.g., ``/my%2Fpath%7Cwith%21some%25strange%24characters`` + """ + return self._message.path + + @reify + def query(self) -> "MultiMapping[str]": + """A multidict with all the variables in the query string.""" + return MultiDictProxy(self._rel_url.query) + + @reify + def query_string(self) -> str: + """The query string in the URL. + + E.g., id=10 + """ + return self._rel_url.query_string + + @reify + def headers(self) -> "MultiMapping[str]": + """A case-insensitive multidict proxy with all headers.""" + return self._headers + + @reify + def raw_headers(self) -> RawHeaders: + """A sequence of pairs for all headers.""" + return self._message.raw_headers + + @reify + def if_modified_since(self) -> Optional[datetime.datetime]: + """The value of If-Modified-Since HTTP header, or None. + + This header is represented as a `datetime` object. + """ + return parse_http_date(self.headers.get(hdrs.IF_MODIFIED_SINCE)) + + @reify + def if_unmodified_since(self) -> Optional[datetime.datetime]: + """The value of If-Unmodified-Since HTTP header, or None. + + This header is represented as a `datetime` object. + """ + return parse_http_date(self.headers.get(hdrs.IF_UNMODIFIED_SINCE)) + + @staticmethod + def _etag_values(etag_header: str) -> Iterator[ETag]: + """Extract `ETag` objects from raw header.""" + if etag_header == ETAG_ANY: + yield ETag( + is_weak=False, + value=ETAG_ANY, + ) + else: + for match in LIST_QUOTED_ETAG_RE.finditer(etag_header): + is_weak, value, garbage = match.group(2, 3, 4) + # Any symbol captured by 4th group means + # that the following sequence is invalid. + if garbage: + break + + yield ETag( + is_weak=bool(is_weak), + value=value, + ) + + @classmethod + def _if_match_or_none_impl( + cls, header_value: Optional[str] + ) -> Optional[Tuple[ETag, ...]]: + if not header_value: + return None + + return tuple(cls._etag_values(header_value)) + + @reify + def if_match(self) -> Optional[Tuple[ETag, ...]]: + """The value of If-Match HTTP header, or None. + + This header is represented as a `tuple` of `ETag` objects. + """ + return self._if_match_or_none_impl(self.headers.get(hdrs.IF_MATCH)) + + @reify + def if_none_match(self) -> Optional[Tuple[ETag, ...]]: + """The value of If-None-Match HTTP header, or None. + + This header is represented as a `tuple` of `ETag` objects. + """ + return self._if_match_or_none_impl(self.headers.get(hdrs.IF_NONE_MATCH)) + + @reify + def if_range(self) -> Optional[datetime.datetime]: + """The value of If-Range HTTP header, or None. + + This header is represented as a `datetime` object. + """ + return parse_http_date(self.headers.get(hdrs.IF_RANGE)) + + @reify + def keep_alive(self) -> bool: + """Is keepalive enabled by client?""" + return not self._message.should_close + + @reify + def cookies(self) -> Mapping[str, str]: + """Return request cookies. + + A read-only dictionary-like object. + """ + raw = self.headers.get(hdrs.COOKIE, "") + parsed = SimpleCookie(raw) + return MappingProxyType({key: val.value for key, val in parsed.items()}) + + @reify + def http_range(self) -> slice: + """The content of Range HTTP header. + + Return a slice instance. + + """ + rng = self._headers.get(hdrs.RANGE) + start, end = None, None + if rng is not None: + try: + pattern = r"^bytes=(\d*)-(\d*)$" + start, end = re.findall(pattern, rng)[0] + except IndexError: # pattern was not found in header + raise ValueError("range not in acceptable format") + + end = int(end) if end else None + start = int(start) if start else None + + if start is None and end is not None: + # end with no start is to return tail of content + start = -end + end = None + + if start is not None and end is not None: + # end is inclusive in range header, exclusive for slice + end += 1 + + if start >= end: + raise ValueError("start cannot be after end") + + if start is end is None: # No valid range supplied + raise ValueError("No start or end of range specified") + + return slice(start, end, 1) + + @reify + def content(self) -> StreamReader: + """Return raw payload stream.""" + return self._payload + + @property + def has_body(self) -> bool: + """Return True if request's HTTP BODY can be read, False otherwise.""" + warnings.warn( + "Deprecated, use .can_read_body #2005", DeprecationWarning, stacklevel=2 + ) + return not self._payload.at_eof() + + @property + def can_read_body(self) -> bool: + """Return True if request's HTTP BODY can be read, False otherwise.""" + return not self._payload.at_eof() + + @reify + def body_exists(self) -> bool: + """Return True if request has HTTP BODY, False otherwise.""" + return type(self._payload) is not EmptyStreamReader + + async def release(self) -> None: + """Release request. + + Eat unread part of HTTP BODY if present. + """ + while not self._payload.at_eof(): + await self._payload.readany() + + async def read(self) -> bytes: + """Read request body if present. + + Returns bytes object with full request content. + """ + if self._read_bytes is None: + body = bytearray() + while True: + chunk = await self._payload.readany() + body.extend(chunk) + if self._client_max_size: + body_size = len(body) + if body_size >= self._client_max_size: + raise HTTPRequestEntityTooLarge( + max_size=self._client_max_size, actual_size=body_size + ) + if not chunk: + break + self._read_bytes = bytes(body) + return self._read_bytes + + async def text(self) -> str: + """Return BODY as text using encoding from .charset.""" + bytes_body = await self.read() + encoding = self.charset or "utf-8" + return bytes_body.decode(encoding) + + async def json(self, *, loads: JSONDecoder = DEFAULT_JSON_DECODER) -> Any: + """Return BODY as JSON.""" + body = await self.text() + return loads(body) + + async def multipart(self) -> MultipartReader: + """Return async iterator to process BODY as multipart.""" + return MultipartReader(self._headers, self._payload) + + async def post(self) -> "MultiDictProxy[Union[str, bytes, FileField]]": + """Return POST parameters.""" + if self._post is not None: + return self._post + if self._method not in self.POST_METHODS: + self._post = MultiDictProxy(MultiDict()) + return self._post + + content_type = self.content_type + if content_type not in ( + "", + "application/x-www-form-urlencoded", + "multipart/form-data", + ): + self._post = MultiDictProxy(MultiDict()) + return self._post + + out: MultiDict[Union[str, bytes, FileField]] = MultiDict() + + if content_type == "multipart/form-data": + multipart = await self.multipart() + max_size = self._client_max_size + + field = await multipart.next() + while field is not None: + size = 0 + field_ct = field.headers.get(hdrs.CONTENT_TYPE) + + if isinstance(field, BodyPartReader): + assert field.name is not None + + # Note that according to RFC 7578, the Content-Type header + # is optional, even for files, so we can't assume it's + # present. + # https://tools.ietf.org/html/rfc7578#section-4.4 + if field.filename: + # store file in temp file + tmp = await self._loop.run_in_executor( + None, tempfile.TemporaryFile + ) + chunk = await field.read_chunk(size=2**16) + while chunk: + chunk = field.decode(chunk) + await self._loop.run_in_executor(None, tmp.write, chunk) + size += len(chunk) + if 0 < max_size < size: + await self._loop.run_in_executor(None, tmp.close) + raise HTTPRequestEntityTooLarge( + max_size=max_size, actual_size=size + ) + chunk = await field.read_chunk(size=2**16) + await self._loop.run_in_executor(None, tmp.seek, 0) + + if field_ct is None: + field_ct = "application/octet-stream" + + ff = FileField( + field.name, + field.filename, + cast(io.BufferedReader, tmp), + field_ct, + field.headers, + ) + out.add(field.name, ff) + else: + # deal with ordinary data + value = await field.read(decode=True) + if field_ct is None or field_ct.startswith("text/"): + charset = field.get_charset(default="utf-8") + out.add(field.name, value.decode(charset)) + else: + out.add(field.name, value) + size += len(value) + if 0 < max_size < size: + raise HTTPRequestEntityTooLarge( + max_size=max_size, actual_size=size + ) + else: + raise ValueError( + "To decode nested multipart you need " "to use custom reader", + ) + + field = await multipart.next() + else: + data = await self.read() + if data: + charset = self.charset or "utf-8" + out.extend( + parse_qsl( + data.rstrip().decode(charset), + keep_blank_values=True, + encoding=charset, + ) + ) + + self._post = MultiDictProxy(out) + return self._post + + def get_extra_info(self, name: str, default: Any = None) -> Any: + """Extra info from protocol transport""" + protocol = self._protocol + if protocol is None: + return default + + transport = protocol.transport + if transport is None: + return default + + return transport.get_extra_info(name, default) + + def __repr__(self) -> str: + ascii_encodable_path = self.path.encode("ascii", "backslashreplace").decode( + "ascii" + ) + return "<{} {} {} >".format( + self.__class__.__name__, self._method, ascii_encodable_path + ) + + def __eq__(self, other: object) -> bool: + return id(self) == id(other) + + def __bool__(self) -> bool: + return True + + async def _prepare_hook(self, response: StreamResponse) -> None: + return + + def _cancel(self, exc: BaseException) -> None: + set_exception(self._payload, exc) + + def _finish(self) -> None: + if self._post is None or self.content_type != "multipart/form-data": + return + + # NOTE: Release file descriptors for the + # NOTE: `tempfile.Temporaryfile`-created `_io.BufferedRandom` + # NOTE: instances of files sent within multipart request body + # NOTE: via HTTP POST request. + for file_name, file_field_object in self._post.items(): + if isinstance(file_field_object, FileField): + file_field_object.file.close() + + +class Request(BaseRequest): + + ATTRS = BaseRequest.ATTRS | frozenset(["_match_info"]) + + def __init__(self, *args: Any, **kwargs: Any) -> None: + super().__init__(*args, **kwargs) + + # matchdict, route_name, handler + # or information about traversal lookup + + # initialized after route resolving + self._match_info: Optional[UrlMappingMatchInfo] = None + + if DEBUG: + + def __setattr__(self, name: str, val: Any) -> None: + if name not in self.ATTRS: + warnings.warn( + "Setting custom {}.{} attribute " + "is discouraged".format(self.__class__.__name__, name), + DeprecationWarning, + stacklevel=2, + ) + super().__setattr__(name, val) + + def clone( + self, + *, + method: Union[str, _SENTINEL] = sentinel, + rel_url: Union[StrOrURL, _SENTINEL] = sentinel, + headers: Union[LooseHeaders, _SENTINEL] = sentinel, + scheme: Union[str, _SENTINEL] = sentinel, + host: Union[str, _SENTINEL] = sentinel, + remote: Union[str, _SENTINEL] = sentinel, + client_max_size: Union[int, _SENTINEL] = sentinel, + ) -> "Request": + ret = super().clone( + method=method, + rel_url=rel_url, + headers=headers, + scheme=scheme, + host=host, + remote=remote, + client_max_size=client_max_size, + ) + new_ret = cast(Request, ret) + new_ret._match_info = self._match_info + return new_ret + + @reify + def match_info(self) -> "UrlMappingMatchInfo": + """Result of route resolving.""" + match_info = self._match_info + assert match_info is not None + return match_info + + @property + def app(self) -> "Application": + """Application instance.""" + match_info = self._match_info + assert match_info is not None + return match_info.current_app + + @property + def config_dict(self) -> ChainMapProxy: + match_info = self._match_info + assert match_info is not None + lst = match_info.apps + app = self.app + idx = lst.index(app) + sublist = list(reversed(lst[: idx + 1])) + return ChainMapProxy(sublist) + + async def _prepare_hook(self, response: StreamResponse) -> None: + match_info = self._match_info + if match_info is None: + return + for app in match_info._apps: + await app.on_response_prepare.send(self, response) diff --git a/env/Lib/site-packages/aiohttp/web_response.py b/env/Lib/site-packages/aiohttp/web_response.py new file mode 100644 index 0000000..78d3fe3 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/web_response.py @@ -0,0 +1,820 @@ +import asyncio +import collections.abc +import datetime +import enum +import json +import math +import time +import warnings +from concurrent.futures import Executor +from http import HTTPStatus +from http.cookies import SimpleCookie +from typing import ( + TYPE_CHECKING, + Any, + Dict, + Iterator, + MutableMapping, + Optional, + Union, + cast, +) + +from multidict import CIMultiDict, istr + +from . import hdrs, payload +from .abc import AbstractStreamWriter +from .compression_utils import ZLibCompressor +from .helpers import ( + ETAG_ANY, + QUOTED_ETAG_RE, + ETag, + HeadersMixin, + must_be_empty_body, + parse_http_date, + rfc822_formatted_time, + sentinel, + should_remove_content_length, + validate_etag_value, +) +from .http import SERVER_SOFTWARE, HttpVersion10, HttpVersion11 +from .payload import Payload +from .typedefs import JSONEncoder, LooseHeaders + +__all__ = ("ContentCoding", "StreamResponse", "Response", "json_response") + + +if TYPE_CHECKING: + from .web_request import BaseRequest + + BaseClass = MutableMapping[str, Any] +else: + BaseClass = collections.abc.MutableMapping + + +# TODO(py311): Convert to StrEnum for wider use +class ContentCoding(enum.Enum): + # The content codings that we have support for. + # + # Additional registered codings are listed at: + # https://www.iana.org/assignments/http-parameters/http-parameters.xhtml#content-coding + deflate = "deflate" + gzip = "gzip" + identity = "identity" + + +############################################################ +# HTTP Response classes +############################################################ + + +class StreamResponse(BaseClass, HeadersMixin): + + _length_check = True + + def __init__( + self, + *, + status: int = 200, + reason: Optional[str] = None, + headers: Optional[LooseHeaders] = None, + ) -> None: + self._body = None + self._keep_alive: Optional[bool] = None + self._chunked = False + self._compression = False + self._compression_force: Optional[ContentCoding] = None + self._cookies = SimpleCookie() + + self._req: Optional[BaseRequest] = None + self._payload_writer: Optional[AbstractStreamWriter] = None + self._eof_sent = False + self._must_be_empty_body: Optional[bool] = None + self._body_length = 0 + self._state: Dict[str, Any] = {} + + if headers is not None: + self._headers: CIMultiDict[str] = CIMultiDict(headers) + else: + self._headers = CIMultiDict() + + self.set_status(status, reason) + + @property + def prepared(self) -> bool: + return self._payload_writer is not None + + @property + def task(self) -> "Optional[asyncio.Task[None]]": + if self._req: + return self._req.task + else: + return None + + @property + def status(self) -> int: + return self._status + + @property + def chunked(self) -> bool: + return self._chunked + + @property + def compression(self) -> bool: + return self._compression + + @property + def reason(self) -> str: + return self._reason + + def set_status( + self, + status: int, + reason: Optional[str] = None, + ) -> None: + assert not self.prepared, ( + "Cannot change the response status code after " "the headers have been sent" + ) + self._status = int(status) + if reason is None: + try: + reason = HTTPStatus(self._status).phrase + except ValueError: + reason = "" + self._reason = reason + + @property + def keep_alive(self) -> Optional[bool]: + return self._keep_alive + + def force_close(self) -> None: + self._keep_alive = False + + @property + def body_length(self) -> int: + return self._body_length + + @property + def output_length(self) -> int: + warnings.warn("output_length is deprecated", DeprecationWarning) + assert self._payload_writer + return self._payload_writer.buffer_size + + def enable_chunked_encoding(self, chunk_size: Optional[int] = None) -> None: + """Enables automatic chunked transfer encoding.""" + self._chunked = True + + if hdrs.CONTENT_LENGTH in self._headers: + raise RuntimeError( + "You can't enable chunked encoding when " "a content length is set" + ) + if chunk_size is not None: + warnings.warn("Chunk size is deprecated #1615", DeprecationWarning) + + def enable_compression( + self, force: Optional[Union[bool, ContentCoding]] = None + ) -> None: + """Enables response compression encoding.""" + # Backwards compatibility for when force was a bool <0.17. + if isinstance(force, bool): + force = ContentCoding.deflate if force else ContentCoding.identity + warnings.warn( + "Using boolean for force is deprecated #3318", DeprecationWarning + ) + elif force is not None: + assert isinstance(force, ContentCoding), ( + "force should one of " "None, bool or " "ContentEncoding" + ) + + self._compression = True + self._compression_force = force + + @property + def headers(self) -> "CIMultiDict[str]": + return self._headers + + @property + def cookies(self) -> SimpleCookie: + return self._cookies + + def set_cookie( + self, + name: str, + value: str, + *, + expires: Optional[str] = None, + domain: Optional[str] = None, + max_age: Optional[Union[int, str]] = None, + path: str = "/", + secure: Optional[bool] = None, + httponly: Optional[bool] = None, + version: Optional[str] = None, + samesite: Optional[str] = None, + ) -> None: + """Set or update response cookie. + + Sets new cookie or updates existent with new value. + Also updates only those params which are not None. + """ + old = self._cookies.get(name) + if old is not None and old.coded_value == "": + # deleted cookie + self._cookies.pop(name, None) + + self._cookies[name] = value + c = self._cookies[name] + + if expires is not None: + c["expires"] = expires + elif c.get("expires") == "Thu, 01 Jan 1970 00:00:00 GMT": + del c["expires"] + + if domain is not None: + c["domain"] = domain + + if max_age is not None: + c["max-age"] = str(max_age) + elif "max-age" in c: + del c["max-age"] + + c["path"] = path + + if secure is not None: + c["secure"] = secure + if httponly is not None: + c["httponly"] = httponly + if version is not None: + c["version"] = version + if samesite is not None: + c["samesite"] = samesite + + def del_cookie( + self, name: str, *, domain: Optional[str] = None, path: str = "/" + ) -> None: + """Delete cookie. + + Creates new empty expired cookie. + """ + # TODO: do we need domain/path here? + self._cookies.pop(name, None) + self.set_cookie( + name, + "", + max_age=0, + expires="Thu, 01 Jan 1970 00:00:00 GMT", + domain=domain, + path=path, + ) + + @property + def content_length(self) -> Optional[int]: + # Just a placeholder for adding setter + return super().content_length + + @content_length.setter + def content_length(self, value: Optional[int]) -> None: + if value is not None: + value = int(value) + if self._chunked: + raise RuntimeError( + "You can't set content length when " "chunked encoding is enable" + ) + self._headers[hdrs.CONTENT_LENGTH] = str(value) + else: + self._headers.pop(hdrs.CONTENT_LENGTH, None) + + @property + def content_type(self) -> str: + # Just a placeholder for adding setter + return super().content_type + + @content_type.setter + def content_type(self, value: str) -> None: + self.content_type # read header values if needed + self._content_type = str(value) + self._generate_content_type_header() + + @property + def charset(self) -> Optional[str]: + # Just a placeholder for adding setter + return super().charset + + @charset.setter + def charset(self, value: Optional[str]) -> None: + ctype = self.content_type # read header values if needed + if ctype == "application/octet-stream": + raise RuntimeError( + "Setting charset for application/octet-stream " + "doesn't make sense, setup content_type first" + ) + assert self._content_dict is not None + if value is None: + self._content_dict.pop("charset", None) + else: + self._content_dict["charset"] = str(value).lower() + self._generate_content_type_header() + + @property + def last_modified(self) -> Optional[datetime.datetime]: + """The value of Last-Modified HTTP header, or None. + + This header is represented as a `datetime` object. + """ + return parse_http_date(self._headers.get(hdrs.LAST_MODIFIED)) + + @last_modified.setter + def last_modified( + self, value: Optional[Union[int, float, datetime.datetime, str]] + ) -> None: + if value is None: + self._headers.pop(hdrs.LAST_MODIFIED, None) + elif isinstance(value, (int, float)): + self._headers[hdrs.LAST_MODIFIED] = time.strftime( + "%a, %d %b %Y %H:%M:%S GMT", time.gmtime(math.ceil(value)) + ) + elif isinstance(value, datetime.datetime): + self._headers[hdrs.LAST_MODIFIED] = time.strftime( + "%a, %d %b %Y %H:%M:%S GMT", value.utctimetuple() + ) + elif isinstance(value, str): + self._headers[hdrs.LAST_MODIFIED] = value + + @property + def etag(self) -> Optional[ETag]: + quoted_value = self._headers.get(hdrs.ETAG) + if not quoted_value: + return None + elif quoted_value == ETAG_ANY: + return ETag(value=ETAG_ANY) + match = QUOTED_ETAG_RE.fullmatch(quoted_value) + if not match: + return None + is_weak, value = match.group(1, 2) + return ETag( + is_weak=bool(is_weak), + value=value, + ) + + @etag.setter + def etag(self, value: Optional[Union[ETag, str]]) -> None: + if value is None: + self._headers.pop(hdrs.ETAG, None) + elif (isinstance(value, str) and value == ETAG_ANY) or ( + isinstance(value, ETag) and value.value == ETAG_ANY + ): + self._headers[hdrs.ETAG] = ETAG_ANY + elif isinstance(value, str): + validate_etag_value(value) + self._headers[hdrs.ETAG] = f'"{value}"' + elif isinstance(value, ETag) and isinstance(value.value, str): + validate_etag_value(value.value) + hdr_value = f'W/"{value.value}"' if value.is_weak else f'"{value.value}"' + self._headers[hdrs.ETAG] = hdr_value + else: + raise ValueError( + f"Unsupported etag type: {type(value)}. " + f"etag must be str, ETag or None" + ) + + def _generate_content_type_header( + self, CONTENT_TYPE: istr = hdrs.CONTENT_TYPE + ) -> None: + assert self._content_dict is not None + assert self._content_type is not None + params = "; ".join(f"{k}={v}" for k, v in self._content_dict.items()) + if params: + ctype = self._content_type + "; " + params + else: + ctype = self._content_type + self._headers[CONTENT_TYPE] = ctype + + async def _do_start_compression(self, coding: ContentCoding) -> None: + if coding != ContentCoding.identity: + assert self._payload_writer is not None + self._headers[hdrs.CONTENT_ENCODING] = coding.value + self._payload_writer.enable_compression(coding.value) + # Compressed payload may have different content length, + # remove the header + self._headers.popall(hdrs.CONTENT_LENGTH, None) + + async def _start_compression(self, request: "BaseRequest") -> None: + if self._compression_force: + await self._do_start_compression(self._compression_force) + else: + # Encoding comparisons should be case-insensitive + # https://www.rfc-editor.org/rfc/rfc9110#section-8.4.1 + accept_encoding = request.headers.get(hdrs.ACCEPT_ENCODING, "").lower() + for coding in ContentCoding: + if coding.value in accept_encoding: + await self._do_start_compression(coding) + return + + async def prepare(self, request: "BaseRequest") -> Optional[AbstractStreamWriter]: + if self._eof_sent: + return None + if self._payload_writer is not None: + return self._payload_writer + self._must_be_empty_body = must_be_empty_body(request.method, self.status) + return await self._start(request) + + async def _start(self, request: "BaseRequest") -> AbstractStreamWriter: + self._req = request + writer = self._payload_writer = request._payload_writer + + await self._prepare_headers() + await request._prepare_hook(self) + await self._write_headers() + + return writer + + async def _prepare_headers(self) -> None: + request = self._req + assert request is not None + writer = self._payload_writer + assert writer is not None + keep_alive = self._keep_alive + if keep_alive is None: + keep_alive = request.keep_alive + self._keep_alive = keep_alive + + version = request.version + + headers = self._headers + for cookie in self._cookies.values(): + value = cookie.output(header="")[1:] + headers.add(hdrs.SET_COOKIE, value) + + if self._compression: + await self._start_compression(request) + + if self._chunked: + if version != HttpVersion11: + raise RuntimeError( + "Using chunked encoding is forbidden " + "for HTTP/{0.major}.{0.minor}".format(request.version) + ) + if not self._must_be_empty_body: + writer.enable_chunking() + headers[hdrs.TRANSFER_ENCODING] = "chunked" + if hdrs.CONTENT_LENGTH in headers: + del headers[hdrs.CONTENT_LENGTH] + elif self._length_check: + writer.length = self.content_length + if writer.length is None: + if version >= HttpVersion11: + if not self._must_be_empty_body: + writer.enable_chunking() + headers[hdrs.TRANSFER_ENCODING] = "chunked" + elif not self._must_be_empty_body: + keep_alive = False + + # HTTP 1.1: https://tools.ietf.org/html/rfc7230#section-3.3.2 + # HTTP 1.0: https://tools.ietf.org/html/rfc1945#section-10.4 + if self._must_be_empty_body: + if hdrs.CONTENT_LENGTH in headers and should_remove_content_length( + request.method, self.status + ): + del headers[hdrs.CONTENT_LENGTH] + # https://datatracker.ietf.org/doc/html/rfc9112#section-6.1-10 + # https://datatracker.ietf.org/doc/html/rfc9112#section-6.1-13 + if hdrs.TRANSFER_ENCODING in headers: + del headers[hdrs.TRANSFER_ENCODING] + else: + headers.setdefault(hdrs.CONTENT_TYPE, "application/octet-stream") + headers.setdefault(hdrs.DATE, rfc822_formatted_time()) + headers.setdefault(hdrs.SERVER, SERVER_SOFTWARE) + + # connection header + if hdrs.CONNECTION not in headers: + if keep_alive: + if version == HttpVersion10: + headers[hdrs.CONNECTION] = "keep-alive" + else: + if version == HttpVersion11: + headers[hdrs.CONNECTION] = "close" + + async def _write_headers(self) -> None: + request = self._req + assert request is not None + writer = self._payload_writer + assert writer is not None + # status line + version = request.version + status_line = "HTTP/{}.{} {} {}".format( + version[0], version[1], self._status, self._reason + ) + await writer.write_headers(status_line, self._headers) + + async def write(self, data: bytes) -> None: + assert isinstance( + data, (bytes, bytearray, memoryview) + ), "data argument must be byte-ish (%r)" % type(data) + + if self._eof_sent: + raise RuntimeError("Cannot call write() after write_eof()") + if self._payload_writer is None: + raise RuntimeError("Cannot call write() before prepare()") + + await self._payload_writer.write(data) + + async def drain(self) -> None: + assert not self._eof_sent, "EOF has already been sent" + assert self._payload_writer is not None, "Response has not been started" + warnings.warn( + "drain method is deprecated, use await resp.write()", + DeprecationWarning, + stacklevel=2, + ) + await self._payload_writer.drain() + + async def write_eof(self, data: bytes = b"") -> None: + assert isinstance( + data, (bytes, bytearray, memoryview) + ), "data argument must be byte-ish (%r)" % type(data) + + if self._eof_sent: + return + + assert self._payload_writer is not None, "Response has not been started" + + await self._payload_writer.write_eof(data) + self._eof_sent = True + self._req = None + self._body_length = self._payload_writer.output_size + self._payload_writer = None + + def __repr__(self) -> str: + if self._eof_sent: + info = "eof" + elif self.prepared: + assert self._req is not None + info = f"{self._req.method} {self._req.path} " + else: + info = "not prepared" + return f"<{self.__class__.__name__} {self.reason} {info}>" + + def __getitem__(self, key: str) -> Any: + return self._state[key] + + def __setitem__(self, key: str, value: Any) -> None: + self._state[key] = value + + def __delitem__(self, key: str) -> None: + del self._state[key] + + def __len__(self) -> int: + return len(self._state) + + def __iter__(self) -> Iterator[str]: + return iter(self._state) + + def __hash__(self) -> int: + return hash(id(self)) + + def __eq__(self, other: object) -> bool: + return self is other + + +class Response(StreamResponse): + def __init__( + self, + *, + body: Any = None, + status: int = 200, + reason: Optional[str] = None, + text: Optional[str] = None, + headers: Optional[LooseHeaders] = None, + content_type: Optional[str] = None, + charset: Optional[str] = None, + zlib_executor_size: Optional[int] = None, + zlib_executor: Optional[Executor] = None, + ) -> None: + if body is not None and text is not None: + raise ValueError("body and text are not allowed together") + + if headers is None: + real_headers: CIMultiDict[str] = CIMultiDict() + elif not isinstance(headers, CIMultiDict): + real_headers = CIMultiDict(headers) + else: + real_headers = headers # = cast('CIMultiDict[str]', headers) + + if content_type is not None and "charset" in content_type: + raise ValueError("charset must not be in content_type " "argument") + + if text is not None: + if hdrs.CONTENT_TYPE in real_headers: + if content_type or charset: + raise ValueError( + "passing both Content-Type header and " + "content_type or charset params " + "is forbidden" + ) + else: + # fast path for filling headers + if not isinstance(text, str): + raise TypeError("text argument must be str (%r)" % type(text)) + if content_type is None: + content_type = "text/plain" + if charset is None: + charset = "utf-8" + real_headers[hdrs.CONTENT_TYPE] = content_type + "; charset=" + charset + body = text.encode(charset) + text = None + else: + if hdrs.CONTENT_TYPE in real_headers: + if content_type is not None or charset is not None: + raise ValueError( + "passing both Content-Type header and " + "content_type or charset params " + "is forbidden" + ) + else: + if content_type is not None: + if charset is not None: + content_type += "; charset=" + charset + real_headers[hdrs.CONTENT_TYPE] = content_type + + super().__init__(status=status, reason=reason, headers=real_headers) + + if text is not None: + self.text = text + else: + self.body = body + + self._compressed_body: Optional[bytes] = None + self._zlib_executor_size = zlib_executor_size + self._zlib_executor = zlib_executor + + @property + def body(self) -> Optional[Union[bytes, Payload]]: + return self._body + + @body.setter + def body(self, body: bytes) -> None: + if body is None: + self._body: Optional[bytes] = None + self._body_payload: bool = False + elif isinstance(body, (bytes, bytearray)): + self._body = body + self._body_payload = False + else: + try: + self._body = body = payload.PAYLOAD_REGISTRY.get(body) + except payload.LookupError: + raise ValueError("Unsupported body type %r" % type(body)) + + self._body_payload = True + + headers = self._headers + + # set content-type + if hdrs.CONTENT_TYPE not in headers: + headers[hdrs.CONTENT_TYPE] = body.content_type + + # copy payload headers + if body.headers: + for key, value in body.headers.items(): + if key not in headers: + headers[key] = value + + self._compressed_body = None + + @property + def text(self) -> Optional[str]: + if self._body is None: + return None + return self._body.decode(self.charset or "utf-8") + + @text.setter + def text(self, text: str) -> None: + assert text is None or isinstance( + text, str + ), "text argument must be str (%r)" % type(text) + + if self.content_type == "application/octet-stream": + self.content_type = "text/plain" + if self.charset is None: + self.charset = "utf-8" + + self._body = text.encode(self.charset) + self._body_payload = False + self._compressed_body = None + + @property + def content_length(self) -> Optional[int]: + if self._chunked: + return None + + if hdrs.CONTENT_LENGTH in self._headers: + return super().content_length + + if self._compressed_body is not None: + # Return length of the compressed body + return len(self._compressed_body) + elif self._body_payload: + # A payload without content length, or a compressed payload + return None + elif self._body is not None: + return len(self._body) + else: + return 0 + + @content_length.setter + def content_length(self, value: Optional[int]) -> None: + raise RuntimeError("Content length is set automatically") + + async def write_eof(self, data: bytes = b"") -> None: + if self._eof_sent: + return + if self._compressed_body is None: + body: Optional[Union[bytes, Payload]] = self._body + else: + body = self._compressed_body + assert not data, f"data arg is not supported, got {data!r}" + assert self._req is not None + assert self._payload_writer is not None + if body is not None: + if self._must_be_empty_body: + await super().write_eof() + elif self._body_payload: + payload = cast(Payload, body) + await payload.write(self._payload_writer) + await super().write_eof() + else: + await super().write_eof(cast(bytes, body)) + else: + await super().write_eof() + + async def _start(self, request: "BaseRequest") -> AbstractStreamWriter: + if should_remove_content_length(request.method, self.status): + if hdrs.CONTENT_LENGTH in self._headers: + del self._headers[hdrs.CONTENT_LENGTH] + elif not self._chunked and hdrs.CONTENT_LENGTH not in self._headers: + if self._body_payload: + size = cast(Payload, self._body).size + if size is not None: + self._headers[hdrs.CONTENT_LENGTH] = str(size) + else: + body_len = len(self._body) if self._body else "0" + # https://www.rfc-editor.org/rfc/rfc9110.html#section-8.6-7 + if body_len != "0" or ( + self.status != 304 and request.method.upper() != hdrs.METH_HEAD + ): + self._headers[hdrs.CONTENT_LENGTH] = str(body_len) + + return await super()._start(request) + + async def _do_start_compression(self, coding: ContentCoding) -> None: + if self._body_payload or self._chunked: + return await super()._do_start_compression(coding) + + if coding != ContentCoding.identity: + # Instead of using _payload_writer.enable_compression, + # compress the whole body + compressor = ZLibCompressor( + encoding=str(coding.value), + max_sync_chunk_size=self._zlib_executor_size, + executor=self._zlib_executor, + ) + assert self._body is not None + if self._zlib_executor_size is None and len(self._body) > 1024 * 1024: + warnings.warn( + "Synchronous compression of large response bodies " + f"({len(self._body)} bytes) might block the async event loop. " + "Consider providing a custom value to zlib_executor_size/" + "zlib_executor response properties or disabling compression on it." + ) + self._compressed_body = ( + await compressor.compress(self._body) + compressor.flush() + ) + assert self._compressed_body is not None + + self._headers[hdrs.CONTENT_ENCODING] = coding.value + self._headers[hdrs.CONTENT_LENGTH] = str(len(self._compressed_body)) + + +def json_response( + data: Any = sentinel, + *, + text: Optional[str] = None, + body: Optional[bytes] = None, + status: int = 200, + reason: Optional[str] = None, + headers: Optional[LooseHeaders] = None, + content_type: str = "application/json", + dumps: JSONEncoder = json.dumps, +) -> Response: + if data is not sentinel: + if text or body: + raise ValueError("only one of data, text, or body should be specified") + else: + text = dumps(data) + return Response( + text=text, + body=body, + status=status, + reason=reason, + headers=headers, + content_type=content_type, + ) diff --git a/env/Lib/site-packages/aiohttp/web_routedef.py b/env/Lib/site-packages/aiohttp/web_routedef.py new file mode 100644 index 0000000..9380214 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/web_routedef.py @@ -0,0 +1,214 @@ +import abc +import os # noqa +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Dict, + Iterator, + List, + Optional, + Sequence, + Type, + Union, + overload, +) + +import attr + +from . import hdrs +from .abc import AbstractView +from .typedefs import Handler, PathLike + +if TYPE_CHECKING: + from .web_request import Request + from .web_response import StreamResponse + from .web_urldispatcher import AbstractRoute, UrlDispatcher +else: + Request = StreamResponse = UrlDispatcher = AbstractRoute = None + + +__all__ = ( + "AbstractRouteDef", + "RouteDef", + "StaticDef", + "RouteTableDef", + "head", + "options", + "get", + "post", + "patch", + "put", + "delete", + "route", + "view", + "static", +) + + +class AbstractRouteDef(abc.ABC): + @abc.abstractmethod + def register(self, router: UrlDispatcher) -> List[AbstractRoute]: + pass # pragma: no cover + + +_HandlerType = Union[Type[AbstractView], Handler] + + +@attr.s(auto_attribs=True, frozen=True, repr=False, slots=True) +class RouteDef(AbstractRouteDef): + method: str + path: str + handler: _HandlerType + kwargs: Dict[str, Any] + + def __repr__(self) -> str: + info = [] + for name, value in sorted(self.kwargs.items()): + info.append(f", {name}={value!r}") + return " {handler.__name__!r}" "{info}>".format( + method=self.method, path=self.path, handler=self.handler, info="".join(info) + ) + + def register(self, router: UrlDispatcher) -> List[AbstractRoute]: + if self.method in hdrs.METH_ALL: + reg = getattr(router, "add_" + self.method.lower()) + return [reg(self.path, self.handler, **self.kwargs)] + else: + return [ + router.add_route(self.method, self.path, self.handler, **self.kwargs) + ] + + +@attr.s(auto_attribs=True, frozen=True, repr=False, slots=True) +class StaticDef(AbstractRouteDef): + prefix: str + path: PathLike + kwargs: Dict[str, Any] + + def __repr__(self) -> str: + info = [] + for name, value in sorted(self.kwargs.items()): + info.append(f", {name}={value!r}") + return " {path}" "{info}>".format( + prefix=self.prefix, path=self.path, info="".join(info) + ) + + def register(self, router: UrlDispatcher) -> List[AbstractRoute]: + resource = router.add_static(self.prefix, self.path, **self.kwargs) + routes = resource.get_info().get("routes", {}) + return list(routes.values()) + + +def route(method: str, path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef: + return RouteDef(method, path, handler, kwargs) + + +def head(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef: + return route(hdrs.METH_HEAD, path, handler, **kwargs) + + +def options(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef: + return route(hdrs.METH_OPTIONS, path, handler, **kwargs) + + +def get( + path: str, + handler: _HandlerType, + *, + name: Optional[str] = None, + allow_head: bool = True, + **kwargs: Any, +) -> RouteDef: + return route( + hdrs.METH_GET, path, handler, name=name, allow_head=allow_head, **kwargs + ) + + +def post(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef: + return route(hdrs.METH_POST, path, handler, **kwargs) + + +def put(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef: + return route(hdrs.METH_PUT, path, handler, **kwargs) + + +def patch(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef: + return route(hdrs.METH_PATCH, path, handler, **kwargs) + + +def delete(path: str, handler: _HandlerType, **kwargs: Any) -> RouteDef: + return route(hdrs.METH_DELETE, path, handler, **kwargs) + + +def view(path: str, handler: Type[AbstractView], **kwargs: Any) -> RouteDef: + return route(hdrs.METH_ANY, path, handler, **kwargs) + + +def static(prefix: str, path: PathLike, **kwargs: Any) -> StaticDef: + return StaticDef(prefix, path, kwargs) + + +_Deco = Callable[[_HandlerType], _HandlerType] + + +class RouteTableDef(Sequence[AbstractRouteDef]): + """Route definition table""" + + def __init__(self) -> None: + self._items: List[AbstractRouteDef] = [] + + def __repr__(self) -> str: + return f"" + + @overload + def __getitem__(self, index: int) -> AbstractRouteDef: ... + + @overload + def __getitem__(self, index: slice) -> List[AbstractRouteDef]: ... + + def __getitem__(self, index): # type: ignore[no-untyped-def] + return self._items[index] + + def __iter__(self) -> Iterator[AbstractRouteDef]: + return iter(self._items) + + def __len__(self) -> int: + return len(self._items) + + def __contains__(self, item: object) -> bool: + return item in self._items + + def route(self, method: str, path: str, **kwargs: Any) -> _Deco: + def inner(handler: _HandlerType) -> _HandlerType: + self._items.append(RouteDef(method, path, handler, kwargs)) + return handler + + return inner + + def head(self, path: str, **kwargs: Any) -> _Deco: + return self.route(hdrs.METH_HEAD, path, **kwargs) + + def get(self, path: str, **kwargs: Any) -> _Deco: + return self.route(hdrs.METH_GET, path, **kwargs) + + def post(self, path: str, **kwargs: Any) -> _Deco: + return self.route(hdrs.METH_POST, path, **kwargs) + + def put(self, path: str, **kwargs: Any) -> _Deco: + return self.route(hdrs.METH_PUT, path, **kwargs) + + def patch(self, path: str, **kwargs: Any) -> _Deco: + return self.route(hdrs.METH_PATCH, path, **kwargs) + + def delete(self, path: str, **kwargs: Any) -> _Deco: + return self.route(hdrs.METH_DELETE, path, **kwargs) + + def options(self, path: str, **kwargs: Any) -> _Deco: + return self.route(hdrs.METH_OPTIONS, path, **kwargs) + + def view(self, path: str, **kwargs: Any) -> _Deco: + return self.route(hdrs.METH_ANY, path, **kwargs) + + def static(self, prefix: str, path: PathLike, **kwargs: Any) -> None: + self._items.append(StaticDef(prefix, path, kwargs)) diff --git a/env/Lib/site-packages/aiohttp/web_runner.py b/env/Lib/site-packages/aiohttp/web_runner.py new file mode 100644 index 0000000..2fe229c --- /dev/null +++ b/env/Lib/site-packages/aiohttp/web_runner.py @@ -0,0 +1,397 @@ +import asyncio +import signal +import socket +import warnings +from abc import ABC, abstractmethod +from typing import Any, List, Optional, Set + +from yarl import URL + +from .typedefs import PathLike +from .web_app import Application +from .web_server import Server + +try: + from ssl import SSLContext +except ImportError: + SSLContext = object # type: ignore[misc,assignment] + + +__all__ = ( + "BaseSite", + "TCPSite", + "UnixSite", + "NamedPipeSite", + "SockSite", + "BaseRunner", + "AppRunner", + "ServerRunner", + "GracefulExit", +) + + +class GracefulExit(SystemExit): + code = 1 + + +def _raise_graceful_exit() -> None: + raise GracefulExit() + + +class BaseSite(ABC): + __slots__ = ("_runner", "_ssl_context", "_backlog", "_server") + + def __init__( + self, + runner: "BaseRunner", + *, + shutdown_timeout: float = 60.0, + ssl_context: Optional[SSLContext] = None, + backlog: int = 128, + ) -> None: + if runner.server is None: + raise RuntimeError("Call runner.setup() before making a site") + if shutdown_timeout != 60.0: + msg = "shutdown_timeout should be set on BaseRunner" + warnings.warn(msg, DeprecationWarning, stacklevel=2) + runner._shutdown_timeout = shutdown_timeout + self._runner = runner + self._ssl_context = ssl_context + self._backlog = backlog + self._server: Optional[asyncio.AbstractServer] = None + + @property + @abstractmethod + def name(self) -> str: + pass # pragma: no cover + + @abstractmethod + async def start(self) -> None: + self._runner._reg_site(self) + + async def stop(self) -> None: + self._runner._check_site(self) + if self._server is not None: # Maybe not started yet + self._server.close() + + self._runner._unreg_site(self) + + +class TCPSite(BaseSite): + __slots__ = ("_host", "_port", "_reuse_address", "_reuse_port") + + def __init__( + self, + runner: "BaseRunner", + host: Optional[str] = None, + port: Optional[int] = None, + *, + shutdown_timeout: float = 60.0, + ssl_context: Optional[SSLContext] = None, + backlog: int = 128, + reuse_address: Optional[bool] = None, + reuse_port: Optional[bool] = None, + ) -> None: + super().__init__( + runner, + shutdown_timeout=shutdown_timeout, + ssl_context=ssl_context, + backlog=backlog, + ) + self._host = host + if port is None: + port = 8443 if self._ssl_context else 8080 + self._port = port + self._reuse_address = reuse_address + self._reuse_port = reuse_port + + @property + def name(self) -> str: + scheme = "https" if self._ssl_context else "http" + host = "0.0.0.0" if self._host is None else self._host + return str(URL.build(scheme=scheme, host=host, port=self._port)) + + async def start(self) -> None: + await super().start() + loop = asyncio.get_event_loop() + server = self._runner.server + assert server is not None + self._server = await loop.create_server( + server, + self._host, + self._port, + ssl=self._ssl_context, + backlog=self._backlog, + reuse_address=self._reuse_address, + reuse_port=self._reuse_port, + ) + + +class UnixSite(BaseSite): + __slots__ = ("_path",) + + def __init__( + self, + runner: "BaseRunner", + path: PathLike, + *, + shutdown_timeout: float = 60.0, + ssl_context: Optional[SSLContext] = None, + backlog: int = 128, + ) -> None: + super().__init__( + runner, + shutdown_timeout=shutdown_timeout, + ssl_context=ssl_context, + backlog=backlog, + ) + self._path = path + + @property + def name(self) -> str: + scheme = "https" if self._ssl_context else "http" + return f"{scheme}://unix:{self._path}:" + + async def start(self) -> None: + await super().start() + loop = asyncio.get_event_loop() + server = self._runner.server + assert server is not None + self._server = await loop.create_unix_server( + server, + self._path, + ssl=self._ssl_context, + backlog=self._backlog, + ) + + +class NamedPipeSite(BaseSite): + __slots__ = ("_path",) + + def __init__( + self, runner: "BaseRunner", path: str, *, shutdown_timeout: float = 60.0 + ) -> None: + loop = asyncio.get_event_loop() + if not isinstance( + loop, asyncio.ProactorEventLoop # type: ignore[attr-defined] + ): + raise RuntimeError( + "Named Pipes only available in proactor" "loop under windows" + ) + super().__init__(runner, shutdown_timeout=shutdown_timeout) + self._path = path + + @property + def name(self) -> str: + return self._path + + async def start(self) -> None: + await super().start() + loop = asyncio.get_event_loop() + server = self._runner.server + assert server is not None + _server = await loop.start_serving_pipe( # type: ignore[attr-defined] + server, self._path + ) + self._server = _server[0] + + +class SockSite(BaseSite): + __slots__ = ("_sock", "_name") + + def __init__( + self, + runner: "BaseRunner", + sock: socket.socket, + *, + shutdown_timeout: float = 60.0, + ssl_context: Optional[SSLContext] = None, + backlog: int = 128, + ) -> None: + super().__init__( + runner, + shutdown_timeout=shutdown_timeout, + ssl_context=ssl_context, + backlog=backlog, + ) + self._sock = sock + scheme = "https" if self._ssl_context else "http" + if hasattr(socket, "AF_UNIX") and sock.family == socket.AF_UNIX: + name = f"{scheme}://unix:{sock.getsockname()}:" + else: + host, port = sock.getsockname()[:2] + name = str(URL.build(scheme=scheme, host=host, port=port)) + self._name = name + + @property + def name(self) -> str: + return self._name + + async def start(self) -> None: + await super().start() + loop = asyncio.get_event_loop() + server = self._runner.server + assert server is not None + self._server = await loop.create_server( + server, sock=self._sock, ssl=self._ssl_context, backlog=self._backlog + ) + + +class BaseRunner(ABC): + __slots__ = ("_handle_signals", "_kwargs", "_server", "_sites", "_shutdown_timeout") + + def __init__( + self, + *, + handle_signals: bool = False, + shutdown_timeout: float = 60.0, + **kwargs: Any, + ) -> None: + self._handle_signals = handle_signals + self._kwargs = kwargs + self._server: Optional[Server] = None + self._sites: List[BaseSite] = [] + self._shutdown_timeout = shutdown_timeout + + @property + def server(self) -> Optional[Server]: + return self._server + + @property + def addresses(self) -> List[Any]: + ret: List[Any] = [] + for site in self._sites: + server = site._server + if server is not None: + sockets = server.sockets # type: ignore[attr-defined] + if sockets is not None: + for sock in sockets: + ret.append(sock.getsockname()) + return ret + + @property + def sites(self) -> Set[BaseSite]: + return set(self._sites) + + async def setup(self) -> None: + loop = asyncio.get_event_loop() + + if self._handle_signals: + try: + loop.add_signal_handler(signal.SIGINT, _raise_graceful_exit) + loop.add_signal_handler(signal.SIGTERM, _raise_graceful_exit) + except NotImplementedError: # pragma: no cover + # add_signal_handler is not implemented on Windows + pass + + self._server = await self._make_server() + + @abstractmethod + async def shutdown(self) -> None: + """Call any shutdown hooks to help server close gracefully.""" + + async def cleanup(self) -> None: + # The loop over sites is intentional, an exception on gather() + # leaves self._sites in unpredictable state. + # The loop guaranties that a site is either deleted on success or + # still present on failure + for site in list(self._sites): + await site.stop() + + if self._server: # If setup succeeded + # Yield to event loop to ensure incoming requests prior to stopping the sites + # have all started to be handled before we proceed to close idle connections. + await asyncio.sleep(0) + self._server.pre_shutdown() + await self.shutdown() + await self._server.shutdown(self._shutdown_timeout) + await self._cleanup_server() + + self._server = None + if self._handle_signals: + loop = asyncio.get_running_loop() + try: + loop.remove_signal_handler(signal.SIGINT) + loop.remove_signal_handler(signal.SIGTERM) + except NotImplementedError: # pragma: no cover + # remove_signal_handler is not implemented on Windows + pass + + @abstractmethod + async def _make_server(self) -> Server: + pass # pragma: no cover + + @abstractmethod + async def _cleanup_server(self) -> None: + pass # pragma: no cover + + def _reg_site(self, site: BaseSite) -> None: + if site in self._sites: + raise RuntimeError(f"Site {site} is already registered in runner {self}") + self._sites.append(site) + + def _check_site(self, site: BaseSite) -> None: + if site not in self._sites: + raise RuntimeError(f"Site {site} is not registered in runner {self}") + + def _unreg_site(self, site: BaseSite) -> None: + if site not in self._sites: + raise RuntimeError(f"Site {site} is not registered in runner {self}") + self._sites.remove(site) + + +class ServerRunner(BaseRunner): + """Low-level web server runner""" + + __slots__ = ("_web_server",) + + def __init__( + self, web_server: Server, *, handle_signals: bool = False, **kwargs: Any + ) -> None: + super().__init__(handle_signals=handle_signals, **kwargs) + self._web_server = web_server + + async def shutdown(self) -> None: + pass + + async def _make_server(self) -> Server: + return self._web_server + + async def _cleanup_server(self) -> None: + pass + + +class AppRunner(BaseRunner): + """Web Application runner""" + + __slots__ = ("_app",) + + def __init__( + self, app: Application, *, handle_signals: bool = False, **kwargs: Any + ) -> None: + super().__init__(handle_signals=handle_signals, **kwargs) + if not isinstance(app, Application): + raise TypeError( + "The first argument should be web.Application " + "instance, got {!r}".format(app) + ) + self._app = app + + @property + def app(self) -> Application: + return self._app + + async def shutdown(self) -> None: + await self._app.shutdown() + + async def _make_server(self) -> Server: + loop = asyncio.get_event_loop() + self._app._set_loop(loop) + self._app.on_startup.freeze() + await self._app.startup() + self._app.freeze() + + return self._app._make_handler(loop=loop, **self._kwargs) + + async def _cleanup_server(self) -> None: + await self._app.cleanup() diff --git a/env/Lib/site-packages/aiohttp/web_server.py b/env/Lib/site-packages/aiohttp/web_server.py new file mode 100644 index 0000000..ffc198d --- /dev/null +++ b/env/Lib/site-packages/aiohttp/web_server.py @@ -0,0 +1,82 @@ +"""Low level HTTP server.""" + +import asyncio +from typing import Any, Awaitable, Callable, Dict, List, Optional # noqa + +from .abc import AbstractStreamWriter +from .http_parser import RawRequestMessage +from .streams import StreamReader +from .web_protocol import RequestHandler, _RequestFactory, _RequestHandler +from .web_request import BaseRequest + +__all__ = ("Server",) + + +class Server: + def __init__( + self, + handler: _RequestHandler, + *, + request_factory: Optional[_RequestFactory] = None, + handler_cancellation: bool = False, + loop: Optional[asyncio.AbstractEventLoop] = None, + **kwargs: Any + ) -> None: + self._loop = loop or asyncio.get_running_loop() + self._connections: Dict[RequestHandler, asyncio.Transport] = {} + self._kwargs = kwargs + self.requests_count = 0 + self.request_handler = handler + self.request_factory = request_factory or self._make_request + self.handler_cancellation = handler_cancellation + + @property + def connections(self) -> List[RequestHandler]: + return list(self._connections.keys()) + + def connection_made( + self, handler: RequestHandler, transport: asyncio.Transport + ) -> None: + self._connections[handler] = transport + + def connection_lost( + self, handler: RequestHandler, exc: Optional[BaseException] = None + ) -> None: + if handler in self._connections: + if handler._task_handler: + handler._task_handler.add_done_callback( + lambda f: self._connections.pop(handler, None) + ) + else: + del self._connections[handler] + + def _make_request( + self, + message: RawRequestMessage, + payload: StreamReader, + protocol: RequestHandler, + writer: AbstractStreamWriter, + task: "asyncio.Task[None]", + ) -> BaseRequest: + return BaseRequest(message, payload, protocol, writer, task, self._loop) + + def pre_shutdown(self) -> None: + for conn in self._connections: + conn.close() + + async def shutdown(self, timeout: Optional[float] = None) -> None: + coros = (conn.shutdown(timeout) for conn in self._connections) + await asyncio.gather(*coros) + self._connections.clear() + + def __call__(self) -> RequestHandler: + try: + return RequestHandler(self, loop=self._loop, **self._kwargs) + except TypeError: + # Failsafe creation: remove all custom handler_args + kwargs = { + k: v + for k, v in self._kwargs.items() + if k in ["debug", "access_log_class"] + } + return RequestHandler(self, loop=self._loop, **kwargs) diff --git a/env/Lib/site-packages/aiohttp/web_urldispatcher.py b/env/Lib/site-packages/aiohttp/web_urldispatcher.py new file mode 100644 index 0000000..558fb7d --- /dev/null +++ b/env/Lib/site-packages/aiohttp/web_urldispatcher.py @@ -0,0 +1,1302 @@ +import abc +import asyncio +import base64 +import functools +import hashlib +import html +import inspect +import keyword +import os +import re +import sys +import warnings +from contextlib import contextmanager +from functools import wraps +from pathlib import Path +from types import MappingProxyType +from typing import ( + TYPE_CHECKING, + Any, + Awaitable, + Callable, + Container, + Dict, + Final, + Generator, + Iterable, + Iterator, + List, + Mapping, + NoReturn, + Optional, + Pattern, + Set, + Sized, + Tuple, + Type, + TypedDict, + Union, + cast, +) + +from yarl import URL, __version__ as yarl_version # type: ignore[attr-defined] + +from . import hdrs +from .abc import AbstractMatchInfo, AbstractRouter, AbstractView +from .helpers import DEBUG +from .http import HttpVersion11 +from .typedefs import Handler, PathLike +from .web_exceptions import ( + HTTPException, + HTTPExpectationFailed, + HTTPForbidden, + HTTPMethodNotAllowed, + HTTPNotFound, +) +from .web_fileresponse import FileResponse +from .web_request import Request +from .web_response import Response, StreamResponse +from .web_routedef import AbstractRouteDef + +__all__ = ( + "UrlDispatcher", + "UrlMappingMatchInfo", + "AbstractResource", + "Resource", + "PlainResource", + "DynamicResource", + "AbstractRoute", + "ResourceRoute", + "StaticResource", + "View", +) + + +if TYPE_CHECKING: + from .web_app import Application + + BaseDict = Dict[str, str] +else: + BaseDict = dict + +CIRCULAR_SYMLINK_ERROR = ( + (OSError,) + if sys.version_info < (3, 10) and sys.platform.startswith("win32") + else (RuntimeError,) if sys.version_info < (3, 13) else () +) + +YARL_VERSION: Final[Tuple[int, ...]] = tuple(map(int, yarl_version.split(".")[:2])) + +HTTP_METHOD_RE: Final[Pattern[str]] = re.compile( + r"^[0-9A-Za-z!#\$%&'\*\+\-\.\^_`\|~]+$" +) +ROUTE_RE: Final[Pattern[str]] = re.compile( + r"(\{[_a-zA-Z][^{}]*(?:\{[^{}]*\}[^{}]*)*\})" +) +PATH_SEP: Final[str] = re.escape("/") + + +_ExpectHandler = Callable[[Request], Awaitable[Optional[StreamResponse]]] +_Resolve = Tuple[Optional["UrlMappingMatchInfo"], Set[str]] + +html_escape = functools.partial(html.escape, quote=True) + + +class _InfoDict(TypedDict, total=False): + path: str + + formatter: str + pattern: Pattern[str] + + directory: Path + prefix: str + routes: Mapping[str, "AbstractRoute"] + + app: "Application" + + domain: str + + rule: "AbstractRuleMatching" + + http_exception: HTTPException + + +class AbstractResource(Sized, Iterable["AbstractRoute"]): + def __init__(self, *, name: Optional[str] = None) -> None: + self._name = name + + @property + def name(self) -> Optional[str]: + return self._name + + @property + @abc.abstractmethod + def canonical(self) -> str: + """Exposes the resource's canonical path. + + For example '/foo/bar/{name}' + + """ + + @abc.abstractmethod # pragma: no branch + def url_for(self, **kwargs: str) -> URL: + """Construct url for resource with additional params.""" + + @abc.abstractmethod # pragma: no branch + async def resolve(self, request: Request) -> _Resolve: + """Resolve resource. + + Return (UrlMappingMatchInfo, allowed_methods) pair. + """ + + @abc.abstractmethod + def add_prefix(self, prefix: str) -> None: + """Add a prefix to processed URLs. + + Required for subapplications support. + """ + + @abc.abstractmethod + def get_info(self) -> _InfoDict: + """Return a dict with additional info useful for introspection""" + + def freeze(self) -> None: + pass + + @abc.abstractmethod + def raw_match(self, path: str) -> bool: + """Perform a raw match against path""" + + +class AbstractRoute(abc.ABC): + def __init__( + self, + method: str, + handler: Union[Handler, Type[AbstractView]], + *, + expect_handler: Optional[_ExpectHandler] = None, + resource: Optional[AbstractResource] = None, + ) -> None: + + if expect_handler is None: + expect_handler = _default_expect_handler + + assert asyncio.iscoroutinefunction( + expect_handler + ), f"Coroutine is expected, got {expect_handler!r}" + + method = method.upper() + if not HTTP_METHOD_RE.match(method): + raise ValueError(f"{method} is not allowed HTTP method") + + assert callable(handler), handler + if asyncio.iscoroutinefunction(handler): + pass + elif inspect.isgeneratorfunction(handler): + warnings.warn( + "Bare generators are deprecated, " "use @coroutine wrapper", + DeprecationWarning, + ) + elif isinstance(handler, type) and issubclass(handler, AbstractView): + pass + else: + warnings.warn( + "Bare functions are deprecated, " "use async ones", DeprecationWarning + ) + + @wraps(handler) + async def handler_wrapper(request: Request) -> StreamResponse: + result = old_handler(request) # type: ignore[call-arg] + if asyncio.iscoroutine(result): + result = await result + assert isinstance(result, StreamResponse) + return result + + old_handler = handler + handler = handler_wrapper + + self._method = method + self._handler = handler + self._expect_handler = expect_handler + self._resource = resource + + @property + def method(self) -> str: + return self._method + + @property + def handler(self) -> Handler: + return self._handler + + @property + @abc.abstractmethod + def name(self) -> Optional[str]: + """Optional route's name, always equals to resource's name.""" + + @property + def resource(self) -> Optional[AbstractResource]: + return self._resource + + @abc.abstractmethod + def get_info(self) -> _InfoDict: + """Return a dict with additional info useful for introspection""" + + @abc.abstractmethod # pragma: no branch + def url_for(self, *args: str, **kwargs: str) -> URL: + """Construct url for route with additional params.""" + + async def handle_expect_header(self, request: Request) -> Optional[StreamResponse]: + return await self._expect_handler(request) + + +class UrlMappingMatchInfo(BaseDict, AbstractMatchInfo): + def __init__(self, match_dict: Dict[str, str], route: AbstractRoute): + super().__init__(match_dict) + self._route = route + self._apps: List[Application] = [] + self._current_app: Optional[Application] = None + self._frozen = False + + @property + def handler(self) -> Handler: + return self._route.handler + + @property + def route(self) -> AbstractRoute: + return self._route + + @property + def expect_handler(self) -> _ExpectHandler: + return self._route.handle_expect_header + + @property + def http_exception(self) -> Optional[HTTPException]: + return None + + def get_info(self) -> _InfoDict: # type: ignore[override] + return self._route.get_info() + + @property + def apps(self) -> Tuple["Application", ...]: + return tuple(self._apps) + + def add_app(self, app: "Application") -> None: + if self._frozen: + raise RuntimeError("Cannot change apps stack after .freeze() call") + if self._current_app is None: + self._current_app = app + self._apps.insert(0, app) + + @property + def current_app(self) -> "Application": + app = self._current_app + assert app is not None + return app + + @contextmanager + def set_current_app(self, app: "Application") -> Generator[None, None, None]: + if DEBUG: # pragma: no cover + if app not in self._apps: + raise RuntimeError( + "Expected one of the following apps {!r}, got {!r}".format( + self._apps, app + ) + ) + prev = self._current_app + self._current_app = app + try: + yield + finally: + self._current_app = prev + + def freeze(self) -> None: + self._frozen = True + + def __repr__(self) -> str: + return f"" + + +class MatchInfoError(UrlMappingMatchInfo): + def __init__(self, http_exception: HTTPException) -> None: + self._exception = http_exception + super().__init__({}, SystemRoute(self._exception)) + + @property + def http_exception(self) -> HTTPException: + return self._exception + + def __repr__(self) -> str: + return "".format( + self._exception.status, self._exception.reason + ) + + +async def _default_expect_handler(request: Request) -> None: + """Default handler for Expect header. + + Just send "100 Continue" to client. + raise HTTPExpectationFailed if value of header is not "100-continue" + """ + expect = request.headers.get(hdrs.EXPECT, "") + if request.version == HttpVersion11: + if expect.lower() == "100-continue": + await request.writer.write(b"HTTP/1.1 100 Continue\r\n\r\n") + else: + raise HTTPExpectationFailed(text="Unknown Expect: %s" % expect) + + +class Resource(AbstractResource): + def __init__(self, *, name: Optional[str] = None) -> None: + super().__init__(name=name) + self._routes: List[ResourceRoute] = [] + + def add_route( + self, + method: str, + handler: Union[Type[AbstractView], Handler], + *, + expect_handler: Optional[_ExpectHandler] = None, + ) -> "ResourceRoute": + + for route_obj in self._routes: + if route_obj.method == method or route_obj.method == hdrs.METH_ANY: + raise RuntimeError( + "Added route will never be executed, " + "method {route.method} is already " + "registered".format(route=route_obj) + ) + + route_obj = ResourceRoute(method, handler, self, expect_handler=expect_handler) + self.register_route(route_obj) + return route_obj + + def register_route(self, route: "ResourceRoute") -> None: + assert isinstance( + route, ResourceRoute + ), f"Instance of Route class is required, got {route!r}" + self._routes.append(route) + + async def resolve(self, request: Request) -> _Resolve: + allowed_methods: Set[str] = set() + + match_dict = self._match(request.rel_url.raw_path) + if match_dict is None: + return None, allowed_methods + + for route_obj in self._routes: + route_method = route_obj.method + allowed_methods.add(route_method) + + if route_method == request.method or route_method == hdrs.METH_ANY: + return (UrlMappingMatchInfo(match_dict, route_obj), allowed_methods) + else: + return None, allowed_methods + + @abc.abstractmethod + def _match(self, path: str) -> Optional[Dict[str, str]]: + pass # pragma: no cover + + def __len__(self) -> int: + return len(self._routes) + + def __iter__(self) -> Iterator["ResourceRoute"]: + return iter(self._routes) + + # TODO: implement all abstract methods + + +class PlainResource(Resource): + def __init__(self, path: str, *, name: Optional[str] = None) -> None: + super().__init__(name=name) + assert not path or path.startswith("/") + self._path = path + + @property + def canonical(self) -> str: + return self._path + + def freeze(self) -> None: + if not self._path: + self._path = "/" + + def add_prefix(self, prefix: str) -> None: + assert prefix.startswith("/") + assert not prefix.endswith("/") + assert len(prefix) > 1 + self._path = prefix + self._path + + def _match(self, path: str) -> Optional[Dict[str, str]]: + # string comparison is about 10 times faster than regexp matching + if self._path == path: + return {} + else: + return None + + def raw_match(self, path: str) -> bool: + return self._path == path + + def get_info(self) -> _InfoDict: + return {"path": self._path} + + def url_for(self) -> URL: # type: ignore[override] + return URL.build(path=self._path, encoded=True) + + def __repr__(self) -> str: + name = "'" + self.name + "' " if self.name is not None else "" + return f"" + + +class DynamicResource(Resource): + + DYN = re.compile(r"\{(?P[_a-zA-Z][_a-zA-Z0-9]*)\}") + DYN_WITH_RE = re.compile(r"\{(?P[_a-zA-Z][_a-zA-Z0-9]*):(?P.+)\}") + GOOD = r"[^{}/]+" + + def __init__(self, path: str, *, name: Optional[str] = None) -> None: + super().__init__(name=name) + pattern = "" + formatter = "" + for part in ROUTE_RE.split(path): + match = self.DYN.fullmatch(part) + if match: + pattern += "(?P<{}>{})".format(match.group("var"), self.GOOD) + formatter += "{" + match.group("var") + "}" + continue + + match = self.DYN_WITH_RE.fullmatch(part) + if match: + pattern += "(?P<{var}>{re})".format(**match.groupdict()) + formatter += "{" + match.group("var") + "}" + continue + + if "{" in part or "}" in part: + raise ValueError(f"Invalid path '{path}'['{part}']") + + part = _requote_path(part) + formatter += part + pattern += re.escape(part) + + try: + compiled = re.compile(pattern) + except re.error as exc: + raise ValueError(f"Bad pattern '{pattern}': {exc}") from None + assert compiled.pattern.startswith(PATH_SEP) + assert formatter.startswith("/") + self._pattern = compiled + self._formatter = formatter + + @property + def canonical(self) -> str: + return self._formatter + + def add_prefix(self, prefix: str) -> None: + assert prefix.startswith("/") + assert not prefix.endswith("/") + assert len(prefix) > 1 + self._pattern = re.compile(re.escape(prefix) + self._pattern.pattern) + self._formatter = prefix + self._formatter + + def _match(self, path: str) -> Optional[Dict[str, str]]: + match = self._pattern.fullmatch(path) + if match is None: + return None + else: + return { + key: _unquote_path(value) for key, value in match.groupdict().items() + } + + def raw_match(self, path: str) -> bool: + return self._formatter == path + + def get_info(self) -> _InfoDict: + return {"formatter": self._formatter, "pattern": self._pattern} + + def url_for(self, **parts: str) -> URL: + url = self._formatter.format_map({k: _quote_path(v) for k, v in parts.items()}) + return URL.build(path=url, encoded=True) + + def __repr__(self) -> str: + name = "'" + self.name + "' " if self.name is not None else "" + return "".format( + name=name, formatter=self._formatter + ) + + +class PrefixResource(AbstractResource): + def __init__(self, prefix: str, *, name: Optional[str] = None) -> None: + assert not prefix or prefix.startswith("/"), prefix + assert prefix in ("", "/") or not prefix.endswith("/"), prefix + super().__init__(name=name) + self._prefix = _requote_path(prefix) + self._prefix2 = self._prefix + "/" + + @property + def canonical(self) -> str: + return self._prefix + + def add_prefix(self, prefix: str) -> None: + assert prefix.startswith("/") + assert not prefix.endswith("/") + assert len(prefix) > 1 + self._prefix = prefix + self._prefix + self._prefix2 = self._prefix + "/" + + def raw_match(self, prefix: str) -> bool: + return False + + # TODO: impl missing abstract methods + + +class StaticResource(PrefixResource): + VERSION_KEY = "v" + + def __init__( + self, + prefix: str, + directory: PathLike, + *, + name: Optional[str] = None, + expect_handler: Optional[_ExpectHandler] = None, + chunk_size: int = 256 * 1024, + show_index: bool = False, + follow_symlinks: bool = False, + append_version: bool = False, + ) -> None: + super().__init__(prefix, name=name) + try: + directory = Path(directory).expanduser().resolve(strict=True) + except FileNotFoundError as error: + raise ValueError(f"'{directory}' does not exist") from error + if not directory.is_dir(): + raise ValueError(f"'{directory}' is not a directory") + self._directory = directory + self._show_index = show_index + self._chunk_size = chunk_size + self._follow_symlinks = follow_symlinks + self._expect_handler = expect_handler + self._append_version = append_version + + self._routes = { + "GET": ResourceRoute( + "GET", self._handle, self, expect_handler=expect_handler + ), + "HEAD": ResourceRoute( + "HEAD", self._handle, self, expect_handler=expect_handler + ), + } + + def url_for( # type: ignore[override] + self, + *, + filename: PathLike, + append_version: Optional[bool] = None, + ) -> URL: + if append_version is None: + append_version = self._append_version + filename = str(filename).lstrip("/") + + url = URL.build(path=self._prefix, encoded=True) + # filename is not encoded + if YARL_VERSION < (1, 6): + url = url / filename.replace("%", "%25") + else: + url = url / filename + + if append_version: + unresolved_path = self._directory.joinpath(filename) + try: + if self._follow_symlinks: + normalized_path = Path(os.path.normpath(unresolved_path)) + normalized_path.relative_to(self._directory) + filepath = normalized_path.resolve() + else: + filepath = unresolved_path.resolve() + filepath.relative_to(self._directory) + except (ValueError, FileNotFoundError): + # ValueError for case when path point to symlink + # with follow_symlinks is False + return url # relatively safe + if filepath.is_file(): + # TODO cache file content + # with file watcher for cache invalidation + with filepath.open("rb") as f: + file_bytes = f.read() + h = self._get_file_hash(file_bytes) + url = url.with_query({self.VERSION_KEY: h}) + return url + return url + + @staticmethod + def _get_file_hash(byte_array: bytes) -> str: + m = hashlib.sha256() # todo sha256 can be configurable param + m.update(byte_array) + b64 = base64.urlsafe_b64encode(m.digest()) + return b64.decode("ascii") + + def get_info(self) -> _InfoDict: + return { + "directory": self._directory, + "prefix": self._prefix, + "routes": self._routes, + } + + def set_options_route(self, handler: Handler) -> None: + if "OPTIONS" in self._routes: + raise RuntimeError("OPTIONS route was set already") + self._routes["OPTIONS"] = ResourceRoute( + "OPTIONS", handler, self, expect_handler=self._expect_handler + ) + + async def resolve(self, request: Request) -> _Resolve: + path = request.rel_url.raw_path + method = request.method + allowed_methods = set(self._routes) + if not path.startswith(self._prefix2) and path != self._prefix: + return None, set() + + if method not in allowed_methods: + return None, allowed_methods + + match_dict = {"filename": _unquote_path(path[len(self._prefix) + 1 :])} + return (UrlMappingMatchInfo(match_dict, self._routes[method]), allowed_methods) + + def __len__(self) -> int: + return len(self._routes) + + def __iter__(self) -> Iterator[AbstractRoute]: + return iter(self._routes.values()) + + async def _handle(self, request: Request) -> StreamResponse: + rel_url = request.match_info["filename"] + filename = Path(rel_url) + if filename.anchor: + # rel_url is an absolute name like + # /static/\\machine_name\c$ or /static/D:\path + # where the static dir is totally different + raise HTTPForbidden() + + unresolved_path = self._directory.joinpath(filename) + loop = asyncio.get_running_loop() + return await loop.run_in_executor( + None, self._resolve_path_to_response, unresolved_path + ) + + def _resolve_path_to_response(self, unresolved_path: Path) -> StreamResponse: + """Take the unresolved path and query the file system to form a response.""" + # Check for access outside the root directory. For follow symlinks, URI + # cannot traverse out, but symlinks can. Otherwise, no access outside + # root is permitted. + try: + if self._follow_symlinks: + normalized_path = Path(os.path.normpath(unresolved_path)) + normalized_path.relative_to(self._directory) + file_path = normalized_path.resolve() + else: + file_path = unresolved_path.resolve() + file_path.relative_to(self._directory) + except (ValueError, *CIRCULAR_SYMLINK_ERROR) as error: + # ValueError is raised for the relative check. Circular symlinks + # raise here on resolving for python < 3.13. + raise HTTPNotFound() from error + + # if path is a directory, return the contents if permitted. Note the + # directory check will raise if a segment is not readable. + try: + if file_path.is_dir(): + if self._show_index: + return Response( + text=self._directory_as_html(file_path), + content_type="text/html", + ) + else: + raise HTTPForbidden() + except PermissionError as error: + raise HTTPForbidden() from error + + # Return the file response, which handles all other checks. + return FileResponse(file_path, chunk_size=self._chunk_size) + + def _directory_as_html(self, dir_path: Path) -> str: + """returns directory's index as html.""" + assert dir_path.is_dir() + + relative_path_to_dir = dir_path.relative_to(self._directory).as_posix() + index_of = f"Index of /{html_escape(relative_path_to_dir)}" + h1 = f"

        {index_of}

        " + + index_list = [] + dir_index = dir_path.iterdir() + for _file in sorted(dir_index): + # show file url as relative to static path + rel_path = _file.relative_to(self._directory).as_posix() + quoted_file_url = _quote_path(f"{self._prefix}/{rel_path}") + + # if file is a directory, add '/' to the end of the name + if _file.is_dir(): + file_name = f"{_file.name}/" + else: + file_name = _file.name + + index_list.append( + f'
      1. {html_escape(file_name)}
        2. ' + ) + ul = "
          \n{}\n
        ".format("\n".join(index_list)) + body = f"\n{h1}\n{ul}\n" + + head_str = f"\n{index_of}\n" + html = f"\n{head_str}\n{body}\n" + + return html + + def __repr__(self) -> str: + name = "'" + self.name + "'" if self.name is not None else "" + return " {directory!r}>".format( + name=name, path=self._prefix, directory=self._directory + ) + + +class PrefixedSubAppResource(PrefixResource): + def __init__(self, prefix: str, app: "Application") -> None: + super().__init__(prefix) + self._app = app + self._add_prefix_to_resources(prefix) + + def add_prefix(self, prefix: str) -> None: + super().add_prefix(prefix) + self._add_prefix_to_resources(prefix) + + def _add_prefix_to_resources(self, prefix: str) -> None: + router = self._app.router + for resource in router.resources(): + # Since the canonical path of a resource is about + # to change, we need to unindex it and then reindex + router.unindex_resource(resource) + resource.add_prefix(prefix) + router.index_resource(resource) + + def url_for(self, *args: str, **kwargs: str) -> URL: + raise RuntimeError(".url_for() is not supported " "by sub-application root") + + def get_info(self) -> _InfoDict: + return {"app": self._app, "prefix": self._prefix} + + async def resolve(self, request: Request) -> _Resolve: + match_info = await self._app.router.resolve(request) + match_info.add_app(self._app) + if isinstance(match_info.http_exception, HTTPMethodNotAllowed): + methods = match_info.http_exception.allowed_methods + else: + methods = set() + return match_info, methods + + def __len__(self) -> int: + return len(self._app.router.routes()) + + def __iter__(self) -> Iterator[AbstractRoute]: + return iter(self._app.router.routes()) + + def __repr__(self) -> str: + return " {app!r}>".format( + prefix=self._prefix, app=self._app + ) + + +class AbstractRuleMatching(abc.ABC): + @abc.abstractmethod # pragma: no branch + async def match(self, request: Request) -> bool: + """Return bool if the request satisfies the criteria""" + + @abc.abstractmethod # pragma: no branch + def get_info(self) -> _InfoDict: + """Return a dict with additional info useful for introspection""" + + @property + @abc.abstractmethod # pragma: no branch + def canonical(self) -> str: + """Return a str""" + + +class Domain(AbstractRuleMatching): + re_part = re.compile(r"(?!-)[a-z\d-]{1,63}(? None: + super().__init__() + self._domain = self.validation(domain) + + @property + def canonical(self) -> str: + return self._domain + + def validation(self, domain: str) -> str: + if not isinstance(domain, str): + raise TypeError("Domain must be str") + domain = domain.rstrip(".").lower() + if not domain: + raise ValueError("Domain cannot be empty") + elif "://" in domain: + raise ValueError("Scheme not supported") + url = URL("http://" + domain) + assert url.raw_host is not None + if not all(self.re_part.fullmatch(x) for x in url.raw_host.split(".")): + raise ValueError("Domain not valid") + if url.port == 80: + return url.raw_host + return f"{url.raw_host}:{url.port}" + + async def match(self, request: Request) -> bool: + host = request.headers.get(hdrs.HOST) + if not host: + return False + return self.match_domain(host) + + def match_domain(self, host: str) -> bool: + return host.lower() == self._domain + + def get_info(self) -> _InfoDict: + return {"domain": self._domain} + + +class MaskDomain(Domain): + re_part = re.compile(r"(?!-)[a-z\d\*-]{1,63}(? None: + super().__init__(domain) + mask = self._domain.replace(".", r"\.").replace("*", ".*") + self._mask = re.compile(mask) + + @property + def canonical(self) -> str: + return self._mask.pattern + + def match_domain(self, host: str) -> bool: + return self._mask.fullmatch(host) is not None + + +class MatchedSubAppResource(PrefixedSubAppResource): + def __init__(self, rule: AbstractRuleMatching, app: "Application") -> None: + AbstractResource.__init__(self) + self._prefix = "" + self._app = app + self._rule = rule + + @property + def canonical(self) -> str: + return self._rule.canonical + + def get_info(self) -> _InfoDict: + return {"app": self._app, "rule": self._rule} + + async def resolve(self, request: Request) -> _Resolve: + if not await self._rule.match(request): + return None, set() + match_info = await self._app.router.resolve(request) + match_info.add_app(self._app) + if isinstance(match_info.http_exception, HTTPMethodNotAllowed): + methods = match_info.http_exception.allowed_methods + else: + methods = set() + return match_info, methods + + def __repr__(self) -> str: + return " {app!r}>" "".format(app=self._app) + + +class ResourceRoute(AbstractRoute): + """A route with resource""" + + def __init__( + self, + method: str, + handler: Union[Handler, Type[AbstractView]], + resource: AbstractResource, + *, + expect_handler: Optional[_ExpectHandler] = None, + ) -> None: + super().__init__( + method, handler, expect_handler=expect_handler, resource=resource + ) + + def __repr__(self) -> str: + return " {handler!r}".format( + method=self.method, resource=self._resource, handler=self.handler + ) + + @property + def name(self) -> Optional[str]: + if self._resource is None: + return None + return self._resource.name + + def url_for(self, *args: str, **kwargs: str) -> URL: + """Construct url for route with additional params.""" + assert self._resource is not None + return self._resource.url_for(*args, **kwargs) + + def get_info(self) -> _InfoDict: + assert self._resource is not None + return self._resource.get_info() + + +class SystemRoute(AbstractRoute): + def __init__(self, http_exception: HTTPException) -> None: + super().__init__(hdrs.METH_ANY, self._handle) + self._http_exception = http_exception + + def url_for(self, *args: str, **kwargs: str) -> URL: + raise RuntimeError(".url_for() is not allowed for SystemRoute") + + @property + def name(self) -> Optional[str]: + return None + + def get_info(self) -> _InfoDict: + return {"http_exception": self._http_exception} + + async def _handle(self, request: Request) -> StreamResponse: + raise self._http_exception + + @property + def status(self) -> int: + return self._http_exception.status + + @property + def reason(self) -> str: + return self._http_exception.reason + + def __repr__(self) -> str: + return "".format(self=self) + + +class View(AbstractView): + async def _iter(self) -> StreamResponse: + if self.request.method not in hdrs.METH_ALL: + self._raise_allowed_methods() + method: Optional[Callable[[], Awaitable[StreamResponse]]] + method = getattr(self, self.request.method.lower(), None) + if method is None: + self._raise_allowed_methods() + ret = await method() + assert isinstance(ret, StreamResponse) + return ret + + def __await__(self) -> Generator[Any, None, StreamResponse]: + return self._iter().__await__() + + def _raise_allowed_methods(self) -> NoReturn: + allowed_methods = {m for m in hdrs.METH_ALL if hasattr(self, m.lower())} + raise HTTPMethodNotAllowed(self.request.method, allowed_methods) + + +class ResourcesView(Sized, Iterable[AbstractResource], Container[AbstractResource]): + def __init__(self, resources: List[AbstractResource]) -> None: + self._resources = resources + + def __len__(self) -> int: + return len(self._resources) + + def __iter__(self) -> Iterator[AbstractResource]: + yield from self._resources + + def __contains__(self, resource: object) -> bool: + return resource in self._resources + + +class RoutesView(Sized, Iterable[AbstractRoute], Container[AbstractRoute]): + def __init__(self, resources: List[AbstractResource]): + self._routes: List[AbstractRoute] = [] + for resource in resources: + for route in resource: + self._routes.append(route) + + def __len__(self) -> int: + return len(self._routes) + + def __iter__(self) -> Iterator[AbstractRoute]: + yield from self._routes + + def __contains__(self, route: object) -> bool: + return route in self._routes + + +class UrlDispatcher(AbstractRouter, Mapping[str, AbstractResource]): + + NAME_SPLIT_RE = re.compile(r"[.:-]") + + def __init__(self) -> None: + super().__init__() + self._resources: List[AbstractResource] = [] + self._named_resources: Dict[str, AbstractResource] = {} + self._resource_index: dict[str, list[AbstractResource]] = {} + self._matched_sub_app_resources: List[MatchedSubAppResource] = [] + + async def resolve(self, request: Request) -> UrlMappingMatchInfo: + resource_index = self._resource_index + allowed_methods: Set[str] = set() + + # Walk the url parts looking for candidates. We walk the url backwards + # to ensure the most explicit match is found first. If there are multiple + # candidates for a given url part because there are multiple resources + # registered for the same canonical path, we resolve them in a linear + # fashion to ensure registration order is respected. + url_part = request.rel_url.raw_path + while url_part: + for candidate in resource_index.get(url_part, ()): + match_dict, allowed = await candidate.resolve(request) + if match_dict is not None: + return match_dict + else: + allowed_methods |= allowed + if url_part == "/": + break + url_part = url_part.rpartition("/")[0] or "/" + + # + # We didn't find any candidates, so we'll try the matched sub-app + # resources which we have to walk in a linear fashion because they + # have regex/wildcard match rules and we cannot index them. + # + # For most cases we do not expect there to be many of these since + # currently they are only added by `add_domain` + # + for resource in self._matched_sub_app_resources: + match_dict, allowed = await resource.resolve(request) + if match_dict is not None: + return match_dict + else: + allowed_methods |= allowed + + if allowed_methods: + return MatchInfoError(HTTPMethodNotAllowed(request.method, allowed_methods)) + + return MatchInfoError(HTTPNotFound()) + + def __iter__(self) -> Iterator[str]: + return iter(self._named_resources) + + def __len__(self) -> int: + return len(self._named_resources) + + def __contains__(self, resource: object) -> bool: + return resource in self._named_resources + + def __getitem__(self, name: str) -> AbstractResource: + return self._named_resources[name] + + def resources(self) -> ResourcesView: + return ResourcesView(self._resources) + + def routes(self) -> RoutesView: + return RoutesView(self._resources) + + def named_resources(self) -> Mapping[str, AbstractResource]: + return MappingProxyType(self._named_resources) + + def register_resource(self, resource: AbstractResource) -> None: + assert isinstance( + resource, AbstractResource + ), f"Instance of AbstractResource class is required, got {resource!r}" + if self.frozen: + raise RuntimeError("Cannot register a resource into frozen router.") + + name = resource.name + + if name is not None: + parts = self.NAME_SPLIT_RE.split(name) + for part in parts: + if keyword.iskeyword(part): + raise ValueError( + f"Incorrect route name {name!r}, " + "python keywords cannot be used " + "for route name" + ) + if not part.isidentifier(): + raise ValueError( + "Incorrect route name {!r}, " + "the name should be a sequence of " + "python identifiers separated " + "by dash, dot or column".format(name) + ) + if name in self._named_resources: + raise ValueError( + "Duplicate {!r}, " + "already handled by {!r}".format(name, self._named_resources[name]) + ) + self._named_resources[name] = resource + self._resources.append(resource) + + if isinstance(resource, MatchedSubAppResource): + # We cannot index match sub-app resources because they have match rules + self._matched_sub_app_resources.append(resource) + else: + self.index_resource(resource) + + def _get_resource_index_key(self, resource: AbstractResource) -> str: + """Return a key to index the resource in the resource index.""" + if "{" in (index_key := resource.canonical): + # strip at the first { to allow for variables, and than + # rpartition at / to allow for variable parts in the path + # For example if the canonical path is `/core/locations{tail:.*}` + # the index key will be `/core` since index is based on the + # url parts split by `/` + index_key = index_key.partition("{")[0].rpartition("/")[0] + return index_key.rstrip("/") or "/" + + def index_resource(self, resource: AbstractResource) -> None: + """Add a resource to the resource index.""" + resource_key = self._get_resource_index_key(resource) + # There may be multiple resources for a canonical path + # so we keep them in a list to ensure that registration + # order is respected. + self._resource_index.setdefault(resource_key, []).append(resource) + + def unindex_resource(self, resource: AbstractResource) -> None: + """Remove a resource from the resource index.""" + resource_key = self._get_resource_index_key(resource) + self._resource_index[resource_key].remove(resource) + + def add_resource(self, path: str, *, name: Optional[str] = None) -> Resource: + if path and not path.startswith("/"): + raise ValueError("path should be started with / or be empty") + # Reuse last added resource if path and name are the same + if self._resources: + resource = self._resources[-1] + if resource.name == name and resource.raw_match(path): + return cast(Resource, resource) + if not ("{" in path or "}" in path or ROUTE_RE.search(path)): + resource = PlainResource(_requote_path(path), name=name) + self.register_resource(resource) + return resource + resource = DynamicResource(path, name=name) + self.register_resource(resource) + return resource + + def add_route( + self, + method: str, + path: str, + handler: Union[Handler, Type[AbstractView]], + *, + name: Optional[str] = None, + expect_handler: Optional[_ExpectHandler] = None, + ) -> AbstractRoute: + resource = self.add_resource(path, name=name) + return resource.add_route(method, handler, expect_handler=expect_handler) + + def add_static( + self, + prefix: str, + path: PathLike, + *, + name: Optional[str] = None, + expect_handler: Optional[_ExpectHandler] = None, + chunk_size: int = 256 * 1024, + show_index: bool = False, + follow_symlinks: bool = False, + append_version: bool = False, + ) -> AbstractResource: + """Add static files view. + + prefix - url prefix + path - folder with files + + """ + assert prefix.startswith("/") + if prefix.endswith("/"): + prefix = prefix[:-1] + resource = StaticResource( + prefix, + path, + name=name, + expect_handler=expect_handler, + chunk_size=chunk_size, + show_index=show_index, + follow_symlinks=follow_symlinks, + append_version=append_version, + ) + self.register_resource(resource) + return resource + + def add_head(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute: + """Shortcut for add_route with method HEAD.""" + return self.add_route(hdrs.METH_HEAD, path, handler, **kwargs) + + def add_options(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute: + """Shortcut for add_route with method OPTIONS.""" + return self.add_route(hdrs.METH_OPTIONS, path, handler, **kwargs) + + def add_get( + self, + path: str, + handler: Handler, + *, + name: Optional[str] = None, + allow_head: bool = True, + **kwargs: Any, + ) -> AbstractRoute: + """Shortcut for add_route with method GET. + + If allow_head is true, another + route is added allowing head requests to the same endpoint. + """ + resource = self.add_resource(path, name=name) + if allow_head: + resource.add_route(hdrs.METH_HEAD, handler, **kwargs) + return resource.add_route(hdrs.METH_GET, handler, **kwargs) + + def add_post(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute: + """Shortcut for add_route with method POST.""" + return self.add_route(hdrs.METH_POST, path, handler, **kwargs) + + def add_put(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute: + """Shortcut for add_route with method PUT.""" + return self.add_route(hdrs.METH_PUT, path, handler, **kwargs) + + def add_patch(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute: + """Shortcut for add_route with method PATCH.""" + return self.add_route(hdrs.METH_PATCH, path, handler, **kwargs) + + def add_delete(self, path: str, handler: Handler, **kwargs: Any) -> AbstractRoute: + """Shortcut for add_route with method DELETE.""" + return self.add_route(hdrs.METH_DELETE, path, handler, **kwargs) + + def add_view( + self, path: str, handler: Type[AbstractView], **kwargs: Any + ) -> AbstractRoute: + """Shortcut for add_route with ANY methods for a class-based view.""" + return self.add_route(hdrs.METH_ANY, path, handler, **kwargs) + + def freeze(self) -> None: + super().freeze() + for resource in self._resources: + resource.freeze() + + def add_routes(self, routes: Iterable[AbstractRouteDef]) -> List[AbstractRoute]: + """Append routes to route table. + + Parameter should be a sequence of RouteDef objects. + + Returns a list of registered AbstractRoute instances. + """ + registered_routes = [] + for route_def in routes: + registered_routes.extend(route_def.register(self)) + return registered_routes + + +def _quote_path(value: str) -> str: + if YARL_VERSION < (1, 6): + value = value.replace("%", "%25") + return URL.build(path=value, encoded=False).raw_path + + +def _unquote_path(value: str) -> str: + return URL.build(path=value, encoded=True).path + + +def _requote_path(value: str) -> str: + # Quote non-ascii characters and other characters which must be quoted, + # but preserve existing %-sequences. + result = _quote_path(value) + if "%" in value: + result = result.replace("%25", "%") + return result diff --git a/env/Lib/site-packages/aiohttp/web_ws.py b/env/Lib/site-packages/aiohttp/web_ws.py new file mode 100644 index 0000000..3822230 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/web_ws.py @@ -0,0 +1,600 @@ +import asyncio +import base64 +import binascii +import hashlib +import json +import sys +from typing import Any, Final, Iterable, Optional, Tuple, cast + +import attr +from multidict import CIMultiDict + +from . import hdrs +from .abc import AbstractStreamWriter +from .helpers import calculate_timeout_when, set_exception, set_result +from .http import ( + WS_CLOSED_MESSAGE, + WS_CLOSING_MESSAGE, + WS_KEY, + WebSocketError, + WebSocketReader, + WebSocketWriter, + WSCloseCode, + WSMessage, + WSMsgType as WSMsgType, + ws_ext_gen, + ws_ext_parse, +) +from .log import ws_logger +from .streams import EofStream, FlowControlDataQueue +from .typedefs import JSONDecoder, JSONEncoder +from .web_exceptions import HTTPBadRequest, HTTPException +from .web_request import BaseRequest +from .web_response import StreamResponse + +if sys.version_info >= (3, 11): + import asyncio as async_timeout +else: + import async_timeout + +__all__ = ( + "WebSocketResponse", + "WebSocketReady", + "WSMsgType", +) + +THRESHOLD_CONNLOST_ACCESS: Final[int] = 5 + + +@attr.s(auto_attribs=True, frozen=True, slots=True) +class WebSocketReady: + ok: bool + protocol: Optional[str] + + def __bool__(self) -> bool: + return self.ok + + +class WebSocketResponse(StreamResponse): + + _length_check = False + + def __init__( + self, + *, + timeout: float = 10.0, + receive_timeout: Optional[float] = None, + autoclose: bool = True, + autoping: bool = True, + heartbeat: Optional[float] = None, + protocols: Iterable[str] = (), + compress: bool = True, + max_msg_size: int = 4 * 1024 * 1024, + ) -> None: + super().__init__(status=101) + self._protocols = protocols + self._ws_protocol: Optional[str] = None + self._writer: Optional[WebSocketWriter] = None + self._reader: Optional[FlowControlDataQueue[WSMessage]] = None + self._closed = False + self._closing = False + self._conn_lost = 0 + self._close_code: Optional[int] = None + self._loop: Optional[asyncio.AbstractEventLoop] = None + self._waiting: bool = False + self._close_wait: Optional[asyncio.Future[None]] = None + self._exception: Optional[BaseException] = None + self._timeout = timeout + self._receive_timeout = receive_timeout + self._autoclose = autoclose + self._autoping = autoping + self._heartbeat = heartbeat + self._heartbeat_when = 0.0 + self._heartbeat_cb: Optional[asyncio.TimerHandle] = None + if heartbeat is not None: + self._pong_heartbeat = heartbeat / 2.0 + self._pong_response_cb: Optional[asyncio.TimerHandle] = None + self._compress = compress + self._max_msg_size = max_msg_size + self._ping_task: Optional[asyncio.Task[None]] = None + + def _cancel_heartbeat(self) -> None: + self._cancel_pong_response_cb() + if self._heartbeat_cb is not None: + self._heartbeat_cb.cancel() + self._heartbeat_cb = None + if self._ping_task is not None: + self._ping_task.cancel() + self._ping_task = None + + def _cancel_pong_response_cb(self) -> None: + if self._pong_response_cb is not None: + self._pong_response_cb.cancel() + self._pong_response_cb = None + + def _reset_heartbeat(self) -> None: + if self._heartbeat is None: + return + self._cancel_pong_response_cb() + req = self._req + timeout_ceil_threshold = ( + req._protocol._timeout_ceil_threshold if req is not None else 5 + ) + loop = self._loop + assert loop is not None + now = loop.time() + when = calculate_timeout_when(now, self._heartbeat, timeout_ceil_threshold) + self._heartbeat_when = when + if self._heartbeat_cb is None: + # We do not cancel the previous heartbeat_cb here because + # it generates a significant amount of TimerHandle churn + # which causes asyncio to rebuild the heap frequently. + # Instead _send_heartbeat() will reschedule the next + # heartbeat if it fires too early. + self._heartbeat_cb = loop.call_at(when, self._send_heartbeat) + + def _send_heartbeat(self) -> None: + self._heartbeat_cb = None + loop = self._loop + assert loop is not None and self._writer is not None + now = loop.time() + if now < self._heartbeat_when: + # Heartbeat fired too early, reschedule + self._heartbeat_cb = loop.call_at( + self._heartbeat_when, self._send_heartbeat + ) + return + + req = self._req + timeout_ceil_threshold = ( + req._protocol._timeout_ceil_threshold if req is not None else 5 + ) + when = calculate_timeout_when(now, self._pong_heartbeat, timeout_ceil_threshold) + self._cancel_pong_response_cb() + self._pong_response_cb = loop.call_at(when, self._pong_not_received) + + if sys.version_info >= (3, 12): + # Optimization for Python 3.12, try to send the ping + # immediately to avoid having to schedule + # the task on the event loop. + ping_task = asyncio.Task(self._writer.ping(), loop=loop, eager_start=True) + else: + ping_task = loop.create_task(self._writer.ping()) + + if not ping_task.done(): + self._ping_task = ping_task + ping_task.add_done_callback(self._ping_task_done) + else: + self._ping_task_done(ping_task) + + def _ping_task_done(self, task: "asyncio.Task[None]") -> None: + """Callback for when the ping task completes.""" + if not task.cancelled() and (exc := task.exception()): + self._handle_ping_pong_exception(exc) + self._ping_task = None + + def _pong_not_received(self) -> None: + if self._req is not None and self._req.transport is not None: + self._handle_ping_pong_exception(asyncio.TimeoutError()) + + def _handle_ping_pong_exception(self, exc: BaseException) -> None: + """Handle exceptions raised during ping/pong processing.""" + if self._closed: + return + self._set_closed() + self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE) + self._exception = exc + if self._waiting and not self._closing and self._reader is not None: + self._reader.feed_data(WSMessage(WSMsgType.ERROR, exc, None)) + + def _set_closed(self) -> None: + """Set the connection to closed. + + Cancel any heartbeat timers and set the closed flag. + """ + self._closed = True + self._cancel_heartbeat() + + async def prepare(self, request: BaseRequest) -> AbstractStreamWriter: + # make pre-check to don't hide it by do_handshake() exceptions + if self._payload_writer is not None: + return self._payload_writer + + protocol, writer = self._pre_start(request) + payload_writer = await super().prepare(request) + assert payload_writer is not None + self._post_start(request, protocol, writer) + await payload_writer.drain() + return payload_writer + + def _handshake( + self, request: BaseRequest + ) -> Tuple["CIMultiDict[str]", str, bool, bool]: + headers = request.headers + if "websocket" != headers.get(hdrs.UPGRADE, "").lower().strip(): + raise HTTPBadRequest( + text=( + "No WebSocket UPGRADE hdr: {}\n Can " + '"Upgrade" only to "WebSocket".' + ).format(headers.get(hdrs.UPGRADE)) + ) + + if "upgrade" not in headers.get(hdrs.CONNECTION, "").lower(): + raise HTTPBadRequest( + text="No CONNECTION upgrade hdr: {}".format( + headers.get(hdrs.CONNECTION) + ) + ) + + # find common sub-protocol between client and server + protocol = None + if hdrs.SEC_WEBSOCKET_PROTOCOL in headers: + req_protocols = [ + str(proto.strip()) + for proto in headers[hdrs.SEC_WEBSOCKET_PROTOCOL].split(",") + ] + + for proto in req_protocols: + if proto in self._protocols: + protocol = proto + break + else: + # No overlap found: Return no protocol as per spec + ws_logger.warning( + "Client protocols %r don’t overlap server-known ones %r", + req_protocols, + self._protocols, + ) + + # check supported version + version = headers.get(hdrs.SEC_WEBSOCKET_VERSION, "") + if version not in ("13", "8", "7"): + raise HTTPBadRequest(text=f"Unsupported version: {version}") + + # check client handshake for validity + key = headers.get(hdrs.SEC_WEBSOCKET_KEY) + try: + if not key or len(base64.b64decode(key)) != 16: + raise HTTPBadRequest(text=f"Handshake error: {key!r}") + except binascii.Error: + raise HTTPBadRequest(text=f"Handshake error: {key!r}") from None + + accept_val = base64.b64encode( + hashlib.sha1(key.encode() + WS_KEY).digest() + ).decode() + response_headers = CIMultiDict( + { + hdrs.UPGRADE: "websocket", + hdrs.CONNECTION: "upgrade", + hdrs.SEC_WEBSOCKET_ACCEPT: accept_val, + } + ) + + notakeover = False + compress = 0 + if self._compress: + extensions = headers.get(hdrs.SEC_WEBSOCKET_EXTENSIONS) + # Server side always get return with no exception. + # If something happened, just drop compress extension + compress, notakeover = ws_ext_parse(extensions, isserver=True) + if compress: + enabledext = ws_ext_gen( + compress=compress, isserver=True, server_notakeover=notakeover + ) + response_headers[hdrs.SEC_WEBSOCKET_EXTENSIONS] = enabledext + + if protocol: + response_headers[hdrs.SEC_WEBSOCKET_PROTOCOL] = protocol + return ( + response_headers, + protocol, + compress, + notakeover, + ) # type: ignore[return-value] + + def _pre_start(self, request: BaseRequest) -> Tuple[str, WebSocketWriter]: + self._loop = request._loop + + headers, protocol, compress, notakeover = self._handshake(request) + + self.set_status(101) + self.headers.update(headers) + self.force_close() + self._compress = compress + transport = request._protocol.transport + assert transport is not None + writer = WebSocketWriter( + request._protocol, transport, compress=compress, notakeover=notakeover + ) + + return protocol, writer + + def _post_start( + self, request: BaseRequest, protocol: str, writer: WebSocketWriter + ) -> None: + self._ws_protocol = protocol + self._writer = writer + + self._reset_heartbeat() + + loop = self._loop + assert loop is not None + self._reader = FlowControlDataQueue(request._protocol, 2**16, loop=loop) + request.protocol.set_parser( + WebSocketReader(self._reader, self._max_msg_size, compress=self._compress) + ) + # disable HTTP keepalive for WebSocket + request.protocol.keep_alive(False) + + def can_prepare(self, request: BaseRequest) -> WebSocketReady: + if self._writer is not None: + raise RuntimeError("Already started") + try: + _, protocol, _, _ = self._handshake(request) + except HTTPException: + return WebSocketReady(False, None) + else: + return WebSocketReady(True, protocol) + + @property + def closed(self) -> bool: + return self._closed + + @property + def close_code(self) -> Optional[int]: + return self._close_code + + @property + def ws_protocol(self) -> Optional[str]: + return self._ws_protocol + + @property + def compress(self) -> bool: + return self._compress + + def get_extra_info(self, name: str, default: Any = None) -> Any: + """Get optional transport information. + + If no value associated with ``name`` is found, ``default`` is returned. + """ + writer = self._writer + if writer is None: + return default + transport = writer.transport + if transport is None: + return default + return transport.get_extra_info(name, default) + + def exception(self) -> Optional[BaseException]: + return self._exception + + async def ping(self, message: bytes = b"") -> None: + if self._writer is None: + raise RuntimeError("Call .prepare() first") + await self._writer.ping(message) + + async def pong(self, message: bytes = b"") -> None: + # unsolicited pong + if self._writer is None: + raise RuntimeError("Call .prepare() first") + await self._writer.pong(message) + + async def send_str(self, data: str, compress: Optional[bool] = None) -> None: + if self._writer is None: + raise RuntimeError("Call .prepare() first") + if not isinstance(data, str): + raise TypeError("data argument must be str (%r)" % type(data)) + await self._writer.send(data, binary=False, compress=compress) + + async def send_bytes(self, data: bytes, compress: Optional[bool] = None) -> None: + if self._writer is None: + raise RuntimeError("Call .prepare() first") + if not isinstance(data, (bytes, bytearray, memoryview)): + raise TypeError("data argument must be byte-ish (%r)" % type(data)) + await self._writer.send(data, binary=True, compress=compress) + + async def send_json( + self, + data: Any, + compress: Optional[bool] = None, + *, + dumps: JSONEncoder = json.dumps, + ) -> None: + await self.send_str(dumps(data), compress=compress) + + async def write_eof(self) -> None: # type: ignore[override] + if self._eof_sent: + return + if self._payload_writer is None: + raise RuntimeError("Response has not been started") + + await self.close() + self._eof_sent = True + + async def close( + self, *, code: int = WSCloseCode.OK, message: bytes = b"", drain: bool = True + ) -> bool: + """Close websocket connection.""" + if self._writer is None: + raise RuntimeError("Call .prepare() first") + + if self._closed: + return False + self._set_closed() + + try: + await self._writer.close(code, message) + writer = self._payload_writer + assert writer is not None + if drain: + await writer.drain() + except (asyncio.CancelledError, asyncio.TimeoutError): + self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE) + raise + except Exception as exc: + self._exception = exc + self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE) + return True + + reader = self._reader + assert reader is not None + # we need to break `receive()` cycle before we can call + # `reader.read()` as `close()` may be called from different task + if self._waiting: + assert self._loop is not None + assert self._close_wait is None + self._close_wait = self._loop.create_future() + reader.feed_data(WS_CLOSING_MESSAGE) + await self._close_wait + + if self._closing: + self._close_transport() + return True + + try: + async with async_timeout.timeout(self._timeout): + msg = await reader.read() + except asyncio.CancelledError: + self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE) + raise + except Exception as exc: + self._exception = exc + self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE) + return True + + if msg.type is WSMsgType.CLOSE: + self._set_code_close_transport(msg.data) + return True + + self._set_code_close_transport(WSCloseCode.ABNORMAL_CLOSURE) + self._exception = asyncio.TimeoutError() + return True + + def _set_closing(self, code: WSCloseCode) -> None: + """Set the close code and mark the connection as closing.""" + self._closing = True + self._close_code = code + self._cancel_heartbeat() + + def _set_code_close_transport(self, code: WSCloseCode) -> None: + """Set the close code and close the transport.""" + self._close_code = code + self._close_transport() + + def _close_transport(self) -> None: + """Close the transport.""" + if self._req is not None and self._req.transport is not None: + self._req.transport.close() + + async def receive(self, timeout: Optional[float] = None) -> WSMessage: + if self._reader is None: + raise RuntimeError("Call .prepare() first") + + loop = self._loop + assert loop is not None + receive_timeout = timeout or self._receive_timeout + while True: + if self._waiting: + raise RuntimeError("Concurrent call to receive() is not allowed") + + if self._closed: + self._conn_lost += 1 + if self._conn_lost >= THRESHOLD_CONNLOST_ACCESS: + raise RuntimeError("WebSocket connection is closed.") + return WS_CLOSED_MESSAGE + elif self._closing: + return WS_CLOSING_MESSAGE + + try: + self._waiting = True + try: + if receive_timeout: + # Entering the context manager and creating + # Timeout() object can take almost 50% of the + # run time in this loop so we avoid it if + # there is no read timeout. + async with async_timeout.timeout(receive_timeout): + msg = await self._reader.read() + else: + msg = await self._reader.read() + self._reset_heartbeat() + finally: + self._waiting = False + if self._close_wait: + set_result(self._close_wait, None) + except asyncio.TimeoutError: + raise + except EofStream: + self._close_code = WSCloseCode.OK + await self.close() + return WSMessage(WSMsgType.CLOSED, None, None) + except WebSocketError as exc: + self._close_code = exc.code + await self.close(code=exc.code) + return WSMessage(WSMsgType.ERROR, exc, None) + except Exception as exc: + self._exception = exc + self._set_closing(WSCloseCode.ABNORMAL_CLOSURE) + await self.close() + return WSMessage(WSMsgType.ERROR, exc, None) + + if msg.type is WSMsgType.CLOSE: + self._set_closing(msg.data) + # Could be closed while awaiting reader. + if not self._closed and self._autoclose: + # The client is likely going to close the + # connection out from under us so we do not + # want to drain any pending writes as it will + # likely result writing to a broken pipe. + await self.close(drain=False) + elif msg.type is WSMsgType.CLOSING: + self._set_closing(WSCloseCode.OK) + elif msg.type is WSMsgType.PING and self._autoping: + await self.pong(msg.data) + continue + elif msg.type is WSMsgType.PONG and self._autoping: + continue + + return msg + + async def receive_str(self, *, timeout: Optional[float] = None) -> str: + msg = await self.receive(timeout) + if msg.type is not WSMsgType.TEXT: + raise TypeError( + "Received message {}:{!r} is not WSMsgType.TEXT".format( + msg.type, msg.data + ) + ) + return cast(str, msg.data) + + async def receive_bytes(self, *, timeout: Optional[float] = None) -> bytes: + msg = await self.receive(timeout) + if msg.type is not WSMsgType.BINARY: + raise TypeError(f"Received message {msg.type}:{msg.data!r} is not bytes") + return cast(bytes, msg.data) + + async def receive_json( + self, *, loads: JSONDecoder = json.loads, timeout: Optional[float] = None + ) -> Any: + data = await self.receive_str(timeout=timeout) + return loads(data) + + async def write(self, data: bytes) -> None: + raise RuntimeError("Cannot call .write() for websocket") + + def __aiter__(self) -> "WebSocketResponse": + return self + + async def __anext__(self) -> WSMessage: + msg = await self.receive() + if msg.type in (WSMsgType.CLOSE, WSMsgType.CLOSING, WSMsgType.CLOSED): + raise StopAsyncIteration + return msg + + def _cancel(self, exc: BaseException) -> None: + # web_protocol calls this from connection_lost + # or when the server is shutting down. + self._closing = True + self._cancel_heartbeat() + if self._reader is not None: + set_exception(self._reader, exc) diff --git a/env/Lib/site-packages/aiohttp/worker.py b/env/Lib/site-packages/aiohttp/worker.py new file mode 100644 index 0000000..9b30769 --- /dev/null +++ b/env/Lib/site-packages/aiohttp/worker.py @@ -0,0 +1,247 @@ +"""Async gunicorn worker for aiohttp.web""" + +import asyncio +import os +import re +import signal +import sys +from types import FrameType +from typing import Any, Awaitable, Callable, Optional, Union # noqa + +from gunicorn.config import AccessLogFormat as GunicornAccessLogFormat +from gunicorn.workers import base + +from aiohttp import web + +from .helpers import set_result +from .web_app import Application +from .web_log import AccessLogger + +try: + import ssl + + SSLContext = ssl.SSLContext +except ImportError: # pragma: no cover + ssl = None # type: ignore[assignment] + SSLContext = object # type: ignore[misc,assignment] + + +__all__ = ("GunicornWebWorker", "GunicornUVLoopWebWorker") + + +class GunicornWebWorker(base.Worker): # type: ignore[misc,no-any-unimported] + + DEFAULT_AIOHTTP_LOG_FORMAT = AccessLogger.LOG_FORMAT + DEFAULT_GUNICORN_LOG_FORMAT = GunicornAccessLogFormat.default + + def __init__(self, *args: Any, **kw: Any) -> None: # pragma: no cover + super().__init__(*args, **kw) + + self._task: Optional[asyncio.Task[None]] = None + self.exit_code = 0 + self._notify_waiter: Optional[asyncio.Future[bool]] = None + + def init_process(self) -> None: + # create new event_loop after fork + asyncio.get_event_loop().close() + + self.loop = asyncio.new_event_loop() + asyncio.set_event_loop(self.loop) + + super().init_process() + + def run(self) -> None: + self._task = self.loop.create_task(self._run()) + + try: # ignore all finalization problems + self.loop.run_until_complete(self._task) + except Exception: + self.log.exception("Exception in gunicorn worker") + self.loop.run_until_complete(self.loop.shutdown_asyncgens()) + self.loop.close() + + sys.exit(self.exit_code) + + async def _run(self) -> None: + runner = None + if isinstance(self.wsgi, Application): + app = self.wsgi + elif asyncio.iscoroutinefunction(self.wsgi): + wsgi = await self.wsgi() + if isinstance(wsgi, web.AppRunner): + runner = wsgi + app = runner.app + else: + app = wsgi + else: + raise RuntimeError( + "wsgi app should be either Application or " + "async function returning Application, got {}".format(self.wsgi) + ) + + if runner is None: + access_log = self.log.access_log if self.cfg.accesslog else None + runner = web.AppRunner( + app, + logger=self.log, + keepalive_timeout=self.cfg.keepalive, + access_log=access_log, + access_log_format=self._get_valid_log_format( + self.cfg.access_log_format + ), + shutdown_timeout=self.cfg.graceful_timeout / 100 * 95, + ) + await runner.setup() + + ctx = self._create_ssl_context(self.cfg) if self.cfg.is_ssl else None + + runner = runner + assert runner is not None + server = runner.server + assert server is not None + for sock in self.sockets: + site = web.SockSite( + runner, + sock, + ssl_context=ctx, + ) + await site.start() + + # If our parent changed then we shut down. + pid = os.getpid() + try: + while self.alive: # type: ignore[has-type] + self.notify() + + cnt = server.requests_count + if self.max_requests and cnt > self.max_requests: + self.alive = False + self.log.info("Max requests, shutting down: %s", self) + + elif pid == os.getpid() and self.ppid != os.getppid(): + self.alive = False + self.log.info("Parent changed, shutting down: %s", self) + else: + await self._wait_next_notify() + except BaseException: + pass + + await runner.cleanup() + + def _wait_next_notify(self) -> "asyncio.Future[bool]": + self._notify_waiter_done() + + loop = self.loop + assert loop is not None + self._notify_waiter = waiter = loop.create_future() + self.loop.call_later(1.0, self._notify_waiter_done, waiter) + + return waiter + + def _notify_waiter_done( + self, waiter: Optional["asyncio.Future[bool]"] = None + ) -> None: + if waiter is None: + waiter = self._notify_waiter + if waiter is not None: + set_result(waiter, True) + + if waiter is self._notify_waiter: + self._notify_waiter = None + + def init_signals(self) -> None: + # Set up signals through the event loop API. + + self.loop.add_signal_handler( + signal.SIGQUIT, self.handle_quit, signal.SIGQUIT, None + ) + + self.loop.add_signal_handler( + signal.SIGTERM, self.handle_exit, signal.SIGTERM, None + ) + + self.loop.add_signal_handler( + signal.SIGINT, self.handle_quit, signal.SIGINT, None + ) + + self.loop.add_signal_handler( + signal.SIGWINCH, self.handle_winch, signal.SIGWINCH, None + ) + + self.loop.add_signal_handler( + signal.SIGUSR1, self.handle_usr1, signal.SIGUSR1, None + ) + + self.loop.add_signal_handler( + signal.SIGABRT, self.handle_abort, signal.SIGABRT, None + ) + + # Don't let SIGTERM and SIGUSR1 disturb active requests + # by interrupting system calls + signal.siginterrupt(signal.SIGTERM, False) + signal.siginterrupt(signal.SIGUSR1, False) + # Reset signals so Gunicorn doesn't swallow subprocess return codes + # See: https://github.com/aio-libs/aiohttp/issues/6130 + + def handle_quit(self, sig: int, frame: Optional[FrameType]) -> None: + self.alive = False + + # worker_int callback + self.cfg.worker_int(self) + + # wakeup closing process + self._notify_waiter_done() + + def handle_abort(self, sig: int, frame: Optional[FrameType]) -> None: + self.alive = False + self.exit_code = 1 + self.cfg.worker_abort(self) + sys.exit(1) + + @staticmethod + def _create_ssl_context(cfg: Any) -> "SSLContext": + """Creates SSLContext instance for usage in asyncio.create_server. + + See ssl.SSLSocket.__init__ for more details. + """ + if ssl is None: # pragma: no cover + raise RuntimeError("SSL is not supported.") + + ctx = ssl.SSLContext(cfg.ssl_version) + ctx.load_cert_chain(cfg.certfile, cfg.keyfile) + ctx.verify_mode = cfg.cert_reqs + if cfg.ca_certs: + ctx.load_verify_locations(cfg.ca_certs) + if cfg.ciphers: + ctx.set_ciphers(cfg.ciphers) + return ctx + + def _get_valid_log_format(self, source_format: str) -> str: + if source_format == self.DEFAULT_GUNICORN_LOG_FORMAT: + return self.DEFAULT_AIOHTTP_LOG_FORMAT + elif re.search(r"%\([^\)]+\)", source_format): + raise ValueError( + "Gunicorn's style options in form of `%(name)s` are not " + "supported for the log formatting. Please use aiohttp's " + "format specification to configure access log formatting: " + "http://docs.aiohttp.org/en/stable/logging.html" + "#format-specification" + ) + else: + return source_format + + +class GunicornUVLoopWebWorker(GunicornWebWorker): + def init_process(self) -> None: + import uvloop + + # Close any existing event loop before setting a + # new policy. + asyncio.get_event_loop().close() + + # Setup uvloop policy, so that every + # asyncio.get_event_loop() will create an instance + # of uvloop event loop. + asyncio.set_event_loop_policy(uvloop.EventLoopPolicy()) + + super().init_process() diff --git a/env/Lib/site-packages/aiosignal-1.3.1.dist-info/INSTALLER b/env/Lib/site-packages/aiosignal-1.3.1.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/Lib/site-packages/aiosignal-1.3.1.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/Lib/site-packages/aiosignal-1.3.1.dist-info/LICENSE b/env/Lib/site-packages/aiosignal-1.3.1.dist-info/LICENSE new file mode 100644 index 0000000..7082a2d --- /dev/null +++ b/env/Lib/site-packages/aiosignal-1.3.1.dist-info/LICENSE @@ -0,0 +1,201 @@ +Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright 2013-2019 Nikolay Kim and Andrew Svetlov + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/env/Lib/site-packages/aiosignal-1.3.1.dist-info/METADATA b/env/Lib/site-packages/aiosignal-1.3.1.dist-info/METADATA new file mode 100644 index 0000000..fc96452 --- /dev/null +++ b/env/Lib/site-packages/aiosignal-1.3.1.dist-info/METADATA @@ -0,0 +1,128 @@ +Metadata-Version: 2.1 +Name: aiosignal +Version: 1.3.1 +Summary: aiosignal: a list of registered asynchronous callbacks +Home-page: https://github.com/aio-libs/aiosignal +Maintainer: aiohttp team +Maintainer-email: team@aiohttp.org +License: Apache 2.0 +Project-URL: Chat: Gitter, https://gitter.im/aio-libs/Lobby +Project-URL: CI: GitHub Actions, https://github.com/aio-libs/aiosignal/actions +Project-URL: Coverage: codecov, https://codecov.io/github/aio-libs/aiosignal +Project-URL: Docs: RTD, https://docs.aiosignal.org +Project-URL: GitHub: issues, https://github.com/aio-libs/aiosignal/issues +Project-URL: GitHub: repo, https://github.com/aio-libs/aiosignal +Classifier: License :: OSI Approved :: Apache Software License +Classifier: Intended Audience :: Developers +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Programming Language :: Python :: 3.7 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Development Status :: 5 - Production/Stable +Classifier: Operating System :: POSIX +Classifier: Operating System :: MacOS :: MacOS X +Classifier: Operating System :: Microsoft :: Windows +Classifier: Framework :: AsyncIO +Requires-Python: >=3.7 +Description-Content-Type: text/x-rst +License-File: LICENSE +Requires-Dist: frozenlist (>=1.1.0) + +========= +aiosignal +========= + +.. image:: https://github.com/aio-libs/aiosignal/workflows/CI/badge.svg + :target: https://github.com/aio-libs/aiosignal/actions?query=workflow%3ACI + :alt: GitHub status for master branch + +.. image:: https://codecov.io/gh/aio-libs/aiosignal/branch/master/graph/badge.svg + :target: https://codecov.io/gh/aio-libs/aiosignal + :alt: codecov.io status for master branch + +.. image:: https://badge.fury.io/py/aiosignal.svg + :target: https://pypi.org/project/aiosignal + :alt: Latest PyPI package version + +.. image:: https://readthedocs.org/projects/aiosignal/badge/?version=latest + :target: https://aiosignal.readthedocs.io/ + :alt: Latest Read The Docs + +.. image:: https://img.shields.io/discourse/topics?server=https%3A%2F%2Faio-libs.discourse.group%2F + :target: https://aio-libs.discourse.group/ + :alt: Discourse group for io-libs + +.. image:: https://badges.gitter.im/Join%20Chat.svg + :target: https://gitter.im/aio-libs/Lobby + :alt: Chat on Gitter + +Introduction +============ + +A project to manage callbacks in `asyncio` projects. + +``Signal`` is a list of registered asynchronous callbacks. + +The signal's life-cycle has two stages: after creation its content +could be filled by using standard list operations: ``sig.append()`` +etc. + +After you call ``sig.freeze()`` the signal is *frozen*: adding, removing +and dropping callbacks is forbidden. + +The only available operation is calling the previously registered +callbacks by using ``await sig.send(data)``. + +For concrete usage examples see the `Signals + +section of the `Web Server Advanced +` chapter of the `aiohttp +documentation`_. + + +Installation +------------ + +:: + + $ pip install aiosignal + +The library requires Python 3.6 or newer. + + +Documentation +============= + +https://aiosignal.readthedocs.io/ + +Communication channels +====================== + +*gitter chat* https://gitter.im/aio-libs/Lobby + +Requirements +============ + +- Python >= 3.6 +- frozenlist >= 1.0.0 + +License +======= + +``aiosignal`` is offered under the Apache 2 license. + +Source code +=========== + +The project is hosted on GitHub_ + +Please file an issue in the `bug tracker +`_ if you have found a bug +or have some suggestions to improve the library. + +.. _GitHub: https://github.com/aio-libs/aiosignal +.. _aiohttp documentation: https://docs.aiohttp.org/ diff --git a/env/Lib/site-packages/aiosignal-1.3.1.dist-info/RECORD b/env/Lib/site-packages/aiosignal-1.3.1.dist-info/RECORD new file mode 100644 index 0000000..59be23b --- /dev/null +++ b/env/Lib/site-packages/aiosignal-1.3.1.dist-info/RECORD @@ -0,0 +1,10 @@ +aiosignal-1.3.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +aiosignal-1.3.1.dist-info/LICENSE,sha256=b9UkPpLdf5jsacesN3co50kFcJ_1J6W_mNbQJjwE9bY,11332 +aiosignal-1.3.1.dist-info/METADATA,sha256=c0HRnlYzfXKztZPTFDlPfygizTherhG5WdwXlvco0Ug,4008 +aiosignal-1.3.1.dist-info/RECORD,, +aiosignal-1.3.1.dist-info/WHEEL,sha256=ZL1lC_LiPDNRgDnOl2taCMc83aPEUZgHHv2h-LDgdiM,92 +aiosignal-1.3.1.dist-info/top_level.txt,sha256=z45aNOKGDdrI1roqZY3BGXQ22kJFPHBmVdwtLYLtXC0,10 +aiosignal/__init__.py,sha256=zQNfFYRSd84bswvpFv8ZWjEr5DeYwV3LXbMSyo2222s,867 +aiosignal/__init__.pyi,sha256=xeCddYSS8fZAkz8S4HuKSR2IDe3N7RW_LKcXDPPA1Xk,311 +aiosignal/__pycache__/__init__.cpython-311.pyc,, +aiosignal/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 diff --git a/env/Lib/site-packages/aiosignal-1.3.1.dist-info/WHEEL b/env/Lib/site-packages/aiosignal-1.3.1.dist-info/WHEEL new file mode 100644 index 0000000..5e1f087 --- /dev/null +++ b/env/Lib/site-packages/aiosignal-1.3.1.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.38.2) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/env/Lib/site-packages/aiosignal-1.3.1.dist-info/top_level.txt b/env/Lib/site-packages/aiosignal-1.3.1.dist-info/top_level.txt new file mode 100644 index 0000000..ac6df3a --- /dev/null +++ b/env/Lib/site-packages/aiosignal-1.3.1.dist-info/top_level.txt @@ -0,0 +1 @@ +aiosignal diff --git a/env/Lib/site-packages/aiosignal/__init__.py b/env/Lib/site-packages/aiosignal/__init__.py new file mode 100644 index 0000000..3d288e6 --- /dev/null +++ b/env/Lib/site-packages/aiosignal/__init__.py @@ -0,0 +1,36 @@ +from frozenlist import FrozenList + +__version__ = "1.3.1" + +__all__ = ("Signal",) + + +class Signal(FrozenList): + """Coroutine-based signal implementation. + + To connect a callback to a signal, use any list method. + + Signals are fired using the send() coroutine, which takes named + arguments. + """ + + __slots__ = ("_owner",) + + def __init__(self, owner): + super().__init__() + self._owner = owner + + def __repr__(self): + return "".format( + self._owner, self.frozen, list(self) + ) + + async def send(self, *args, **kwargs): + """ + Sends data to all registered receivers. + """ + if not self.frozen: + raise RuntimeError("Cannot send non-frozen signal.") + + for receiver in self: + await receiver(*args, **kwargs) # type: ignore diff --git a/env/Lib/site-packages/aiosignal/__init__.pyi b/env/Lib/site-packages/aiosignal/__init__.pyi new file mode 100644 index 0000000..d4e3416 --- /dev/null +++ b/env/Lib/site-packages/aiosignal/__init__.pyi @@ -0,0 +1,12 @@ +from typing import Any, Generic, TypeVar + +from frozenlist import FrozenList + +__all__ = ("Signal",) + +_T = TypeVar("_T") + +class Signal(FrozenList[_T], Generic[_T]): + def __init__(self, owner: Any) -> None: ... + def __repr__(self) -> str: ... + async def send(self, *args: Any, **kwargs: Any) -> None: ... diff --git a/env/Lib/site-packages/aiosignal/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/aiosignal/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b332142b4a8755b7346ab51e521b0534939a7fc0 GIT binary patch literal 1847 zcmaJ>-)kI29G}@Acbm(l`C+Ru4RtDg=+We)Rs=(>k;JI9!^ZV{gzcSrRP${H375h=yP1Mz+;9RVA%L$D&%23@&YzKZwuxU zpD79$S=pffrHAGq48e4Z-|MY^t5bJ(N1WEd-@PZiQ~%1qXk*aTfFHf_hRSnU zdvj1Cg1B~MtAg`=!dVpvV6u`pbC`F7@w6`F{KlCnI|#x^)fNfDU_7BMt<>UdLF0q4 z$vFQ(J&3#-dx!Io7Ys#bY(S-nIJ2~({#JK=d1uJg6Q&{01GmweCZOz$!nj}nf5X#4 zZ3_*Y+*oZR-19bmG<0V7rMK=4O+FZ!+|5t!506Uyn1c29_J&5jKYx3Acj&^_41j#| z$G>g8W2Mff&?8S=-Vv0>IZA7xTlb}$r}VSB?WZGIO5M-_HPoZ$j7tBoWKpuy4B`)xxrA;e?A(oION zF61l|Sol9sfhy0l1vAbiCn?jP%T$YdDV2v07d6BOfx^uU(aE#=4JD?sFrHeM6K<~X vbI_G>iH`t)PmK4_+1;b>{)tnq-u>LER<@lP#jwF=VZHQNYM&f4q}=`oV`s)_ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/aiosignal/py.typed b/env/Lib/site-packages/aiosignal/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/annotated_types-0.7.0.dist-info/INSTALLER b/env/Lib/site-packages/annotated_types-0.7.0.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/Lib/site-packages/annotated_types-0.7.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/Lib/site-packages/annotated_types-0.7.0.dist-info/METADATA b/env/Lib/site-packages/annotated_types-0.7.0.dist-info/METADATA new file mode 100644 index 0000000..3ac05cf --- /dev/null +++ b/env/Lib/site-packages/annotated_types-0.7.0.dist-info/METADATA @@ -0,0 +1,295 @@ +Metadata-Version: 2.3 +Name: annotated-types +Version: 0.7.0 +Summary: Reusable constraint types to use with typing.Annotated +Project-URL: Homepage, https://github.com/annotated-types/annotated-types +Project-URL: Source, https://github.com/annotated-types/annotated-types +Project-URL: Changelog, https://github.com/annotated-types/annotated-types/releases +Author-email: Adrian Garcia Badaracco <1755071+adriangb@users.noreply.github.com>, Samuel Colvin , Zac Hatfield-Dodds +License-File: LICENSE +Classifier: Development Status :: 4 - Beta +Classifier: Environment :: Console +Classifier: Environment :: MacOS X +Classifier: Intended Audience :: Developers +Classifier: Intended Audience :: Information Technology +Classifier: License :: OSI Approved :: MIT License +Classifier: Operating System :: POSIX :: Linux +Classifier: Operating System :: Unix +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Classifier: Typing :: Typed +Requires-Python: >=3.8 +Requires-Dist: typing-extensions>=4.0.0; python_version < '3.9' +Description-Content-Type: text/markdown + +# annotated-types + +[![CI](https://github.com/annotated-types/annotated-types/workflows/CI/badge.svg?event=push)](https://github.com/annotated-types/annotated-types/actions?query=event%3Apush+branch%3Amain+workflow%3ACI) +[![pypi](https://img.shields.io/pypi/v/annotated-types.svg)](https://pypi.python.org/pypi/annotated-types) +[![versions](https://img.shields.io/pypi/pyversions/annotated-types.svg)](https://github.com/annotated-types/annotated-types) +[![license](https://img.shields.io/github/license/annotated-types/annotated-types.svg)](https://github.com/annotated-types/annotated-types/blob/main/LICENSE) + +[PEP-593](https://peps.python.org/pep-0593/) added `typing.Annotated` as a way of +adding context-specific metadata to existing types, and specifies that +`Annotated[T, x]` _should_ be treated as `T` by any tool or library without special +logic for `x`. + +This package provides metadata objects which can be used to represent common +constraints such as upper and lower bounds on scalar values and collection sizes, +a `Predicate` marker for runtime checks, and +descriptions of how we intend these metadata to be interpreted. In some cases, +we also note alternative representations which do not require this package. + +## Install + +```bash +pip install annotated-types +``` + +## Examples + +```python +from typing import Annotated +from annotated_types import Gt, Len, Predicate + +class MyClass: + age: Annotated[int, Gt(18)] # Valid: 19, 20, ... + # Invalid: 17, 18, "19", 19.0, ... + factors: list[Annotated[int, Predicate(is_prime)]] # Valid: 2, 3, 5, 7, 11, ... + # Invalid: 4, 8, -2, 5.0, "prime", ... + + my_list: Annotated[list[int], Len(0, 10)] # Valid: [], [10, 20, 30, 40, 50] + # Invalid: (1, 2), ["abc"], [0] * 20 +``` + +## Documentation + +_While `annotated-types` avoids runtime checks for performance, users should not +construct invalid combinations such as `MultipleOf("non-numeric")` or `Annotated[int, Len(3)]`. +Downstream implementors may choose to raise an error, emit a warning, silently ignore +a metadata item, etc., if the metadata objects described below are used with an +incompatible type - or for any other reason!_ + +### Gt, Ge, Lt, Le + +Express inclusive and/or exclusive bounds on orderable values - which may be numbers, +dates, times, strings, sets, etc. Note that the boundary value need not be of the +same type that was annotated, so long as they can be compared: `Annotated[int, Gt(1.5)]` +is fine, for example, and implies that the value is an integer x such that `x > 1.5`. + +We suggest that implementors may also interpret `functools.partial(operator.le, 1.5)` +as being equivalent to `Gt(1.5)`, for users who wish to avoid a runtime dependency on +the `annotated-types` package. + +To be explicit, these types have the following meanings: + +* `Gt(x)` - value must be "Greater Than" `x` - equivalent to exclusive minimum +* `Ge(x)` - value must be "Greater than or Equal" to `x` - equivalent to inclusive minimum +* `Lt(x)` - value must be "Less Than" `x` - equivalent to exclusive maximum +* `Le(x)` - value must be "Less than or Equal" to `x` - equivalent to inclusive maximum + +### Interval + +`Interval(gt, ge, lt, le)` allows you to specify an upper and lower bound with a single +metadata object. `None` attributes should be ignored, and non-`None` attributes +treated as per the single bounds above. + +### MultipleOf + +`MultipleOf(multiple_of=x)` might be interpreted in two ways: + +1. Python semantics, implying `value % multiple_of == 0`, or +2. [JSONschema semantics](https://json-schema.org/draft/2020-12/json-schema-validation.html#rfc.section.6.2.1), + where `int(value / multiple_of) == value / multiple_of`. + +We encourage users to be aware of these two common interpretations and their +distinct behaviours, especially since very large or non-integer numbers make +it easy to cause silent data corruption due to floating-point imprecision. + +We encourage libraries to carefully document which interpretation they implement. + +### MinLen, MaxLen, Len + +`Len()` implies that `min_length <= len(value) <= max_length` - lower and upper bounds are inclusive. + +As well as `Len()` which can optionally include upper and lower bounds, we also +provide `MinLen(x)` and `MaxLen(y)` which are equivalent to `Len(min_length=x)` +and `Len(max_length=y)` respectively. + +`Len`, `MinLen`, and `MaxLen` may be used with any type which supports `len(value)`. + +Examples of usage: + +* `Annotated[list, MaxLen(10)]` (or `Annotated[list, Len(max_length=10))`) - list must have a length of 10 or less +* `Annotated[str, MaxLen(10)]` - string must have a length of 10 or less +* `Annotated[list, MinLen(3))` (or `Annotated[list, Len(min_length=3))`) - list must have a length of 3 or more +* `Annotated[list, Len(4, 6)]` - list must have a length of 4, 5, or 6 +* `Annotated[list, Len(8, 8)]` - list must have a length of exactly 8 + +#### Changed in v0.4.0 + +* `min_inclusive` has been renamed to `min_length`, no change in meaning +* `max_exclusive` has been renamed to `max_length`, upper bound is now **inclusive** instead of **exclusive** +* The recommendation that slices are interpreted as `Len` has been removed due to ambiguity and different semantic + meaning of the upper bound in slices vs. `Len` + +See [issue #23](https://github.com/annotated-types/annotated-types/issues/23) for discussion. + +### Timezone + +`Timezone` can be used with a `datetime` or a `time` to express which timezones +are allowed. `Annotated[datetime, Timezone(None)]` must be a naive datetime. +`Timezone[...]` ([literal ellipsis](https://docs.python.org/3/library/constants.html#Ellipsis)) +expresses that any timezone-aware datetime is allowed. You may also pass a specific +timezone string or [`tzinfo`](https://docs.python.org/3/library/datetime.html#tzinfo-objects) +object such as `Timezone(timezone.utc)` or `Timezone("Africa/Abidjan")` to express that you only +allow a specific timezone, though we note that this is often a symptom of fragile design. + +#### Changed in v0.x.x + +* `Timezone` accepts [`tzinfo`](https://docs.python.org/3/library/datetime.html#tzinfo-objects) objects instead of + `timezone`, extending compatibility to [`zoneinfo`](https://docs.python.org/3/library/zoneinfo.html) and third party libraries. + +### Unit + +`Unit(unit: str)` expresses that the annotated numeric value is the magnitude of +a quantity with the specified unit. For example, `Annotated[float, Unit("m/s")]` +would be a float representing a velocity in meters per second. + +Please note that `annotated_types` itself makes no attempt to parse or validate +the unit string in any way. That is left entirely to downstream libraries, +such as [`pint`](https://pint.readthedocs.io) or +[`astropy.units`](https://docs.astropy.org/en/stable/units/). + +An example of how a library might use this metadata: + +```python +from annotated_types import Unit +from typing import Annotated, TypeVar, Callable, Any, get_origin, get_args + +# given a type annotated with a unit: +Meters = Annotated[float, Unit("m")] + + +# you can cast the annotation to a specific unit type with any +# callable that accepts a string and returns the desired type +T = TypeVar("T") +def cast_unit(tp: Any, unit_cls: Callable[[str], T]) -> T | None: + if get_origin(tp) is Annotated: + for arg in get_args(tp): + if isinstance(arg, Unit): + return unit_cls(arg.unit) + return None + + +# using `pint` +import pint +pint_unit = cast_unit(Meters, pint.Unit) + + +# using `astropy.units` +import astropy.units as u +astropy_unit = cast_unit(Meters, u.Unit) +``` + +### Predicate + +`Predicate(func: Callable)` expresses that `func(value)` is truthy for valid values. +Users should prefer the statically inspectable metadata above, but if you need +the full power and flexibility of arbitrary runtime predicates... here it is. + +For some common constraints, we provide generic types: + +* `IsLower = Annotated[T, Predicate(str.islower)]` +* `IsUpper = Annotated[T, Predicate(str.isupper)]` +* `IsDigit = Annotated[T, Predicate(str.isdigit)]` +* `IsFinite = Annotated[T, Predicate(math.isfinite)]` +* `IsNotFinite = Annotated[T, Predicate(Not(math.isfinite))]` +* `IsNan = Annotated[T, Predicate(math.isnan)]` +* `IsNotNan = Annotated[T, Predicate(Not(math.isnan))]` +* `IsInfinite = Annotated[T, Predicate(math.isinf)]` +* `IsNotInfinite = Annotated[T, Predicate(Not(math.isinf))]` + +so that you can write e.g. `x: IsFinite[float] = 2.0` instead of the longer +(but exactly equivalent) `x: Annotated[float, Predicate(math.isfinite)] = 2.0`. + +Some libraries might have special logic to handle known or understandable predicates, +for example by checking for `str.isdigit` and using its presence to both call custom +logic to enforce digit-only strings, and customise some generated external schema. +Users are therefore encouraged to avoid indirection like `lambda s: s.lower()`, in +favor of introspectable methods such as `str.lower` or `re.compile("pattern").search`. + +To enable basic negation of commonly used predicates like `math.isnan` without introducing introspection that makes it impossible for implementers to introspect the predicate we provide a `Not` wrapper that simply negates the predicate in an introspectable manner. Several of the predicates listed above are created in this manner. + +We do not specify what behaviour should be expected for predicates that raise +an exception. For example `Annotated[int, Predicate(str.isdigit)]` might silently +skip invalid constraints, or statically raise an error; or it might try calling it +and then propagate or discard the resulting +`TypeError: descriptor 'isdigit' for 'str' objects doesn't apply to a 'int' object` +exception. We encourage libraries to document the behaviour they choose. + +### Doc + +`doc()` can be used to add documentation information in `Annotated`, for function and method parameters, variables, class attributes, return types, and any place where `Annotated` can be used. + +It expects a value that can be statically analyzed, as the main use case is for static analysis, editors, documentation generators, and similar tools. + +It returns a `DocInfo` class with a single attribute `documentation` containing the value passed to `doc()`. + +This is the early adopter's alternative form of the [`typing-doc` proposal](https://github.com/tiangolo/fastapi/blob/typing-doc/typing_doc.md). + +### Integrating downstream types with `GroupedMetadata` + +Implementers may choose to provide a convenience wrapper that groups multiple pieces of metadata. +This can help reduce verbosity and cognitive overhead for users. +For example, an implementer like Pydantic might provide a `Field` or `Meta` type that accepts keyword arguments and transforms these into low-level metadata: + +```python +from dataclasses import dataclass +from typing import Iterator +from annotated_types import GroupedMetadata, Ge + +@dataclass +class Field(GroupedMetadata): + ge: int | None = None + description: str | None = None + + def __iter__(self) -> Iterator[object]: + # Iterating over a GroupedMetadata object should yield annotated-types + # constraint metadata objects which describe it as fully as possible, + # and may include other unknown objects too. + if self.ge is not None: + yield Ge(self.ge) + if self.description is not None: + yield Description(self.description) +``` + +Libraries consuming annotated-types constraints should check for `GroupedMetadata` and unpack it by iterating over the object and treating the results as if they had been "unpacked" in the `Annotated` type. The same logic should be applied to the [PEP 646 `Unpack` type](https://peps.python.org/pep-0646/), so that `Annotated[T, Field(...)]`, `Annotated[T, Unpack[Field(...)]]` and `Annotated[T, *Field(...)]` are all treated consistently. + +Libraries consuming annotated-types should also ignore any metadata they do not recongize that came from unpacking a `GroupedMetadata`, just like they ignore unrecognized metadata in `Annotated` itself. + +Our own `annotated_types.Interval` class is a `GroupedMetadata` which unpacks itself into `Gt`, `Lt`, etc., so this is not an abstract concern. Similarly, `annotated_types.Len` is a `GroupedMetadata` which unpacks itself into `MinLen` (optionally) and `MaxLen`. + +### Consuming metadata + +We intend to not be prescriptive as to _how_ the metadata and constraints are used, but as an example of how one might parse constraints from types annotations see our [implementation in `test_main.py`](https://github.com/annotated-types/annotated-types/blob/f59cf6d1b5255a0fe359b93896759a180bec30ae/tests/test_main.py#L94-L103). + +It is up to the implementer to determine how this metadata is used. +You could use the metadata for runtime type checking, for generating schemas or to generate example data, amongst other use cases. + +## Design & History + +This package was designed at the PyCon 2022 sprints by the maintainers of Pydantic +and Hypothesis, with the goal of making it as easy as possible for end-users to +provide more informative annotations for use by runtime libraries. + +It is deliberately minimal, and following PEP-593 allows considerable downstream +discretion in what (if anything!) they choose to support. Nonetheless, we expect +that staying simple and covering _only_ the most common use-cases will give users +and maintainers the best experience we can. If you'd like more constraints for your +types - follow our lead, by defining them and documenting them downstream! diff --git a/env/Lib/site-packages/annotated_types-0.7.0.dist-info/RECORD b/env/Lib/site-packages/annotated_types-0.7.0.dist-info/RECORD new file mode 100644 index 0000000..568bd52 --- /dev/null +++ b/env/Lib/site-packages/annotated_types-0.7.0.dist-info/RECORD @@ -0,0 +1,10 @@ +annotated_types-0.7.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +annotated_types-0.7.0.dist-info/METADATA,sha256=7ltqxksJJ0wCYFGBNIQCWTlWQGeAH0hRFdnK3CB895E,15046 +annotated_types-0.7.0.dist-info/RECORD,, +annotated_types-0.7.0.dist-info/WHEEL,sha256=zEMcRr9Kr03x1ozGwg5v9NQBKn3kndp6LSoSlVg-jhU,87 +annotated_types-0.7.0.dist-info/licenses/LICENSE,sha256=_hBJiEsaDZNCkB6I4H8ykl0ksxIdmXK2poBfuYJLCV0,1083 +annotated_types/__init__.py,sha256=RynLsRKUEGI0KimXydlD1fZEfEzWwDo0Uon3zOKhG1Q,13819 +annotated_types/__pycache__/__init__.cpython-311.pyc,, +annotated_types/__pycache__/test_cases.cpython-311.pyc,, +annotated_types/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +annotated_types/test_cases.py,sha256=zHFX6EpcMbGJ8FzBYDbO56bPwx_DYIVSKbZM-4B3_lg,6421 diff --git a/env/Lib/site-packages/annotated_types-0.7.0.dist-info/WHEEL b/env/Lib/site-packages/annotated_types-0.7.0.dist-info/WHEEL new file mode 100644 index 0000000..516596c --- /dev/null +++ b/env/Lib/site-packages/annotated_types-0.7.0.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: hatchling 1.24.2 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/env/Lib/site-packages/annotated_types-0.7.0.dist-info/licenses/LICENSE b/env/Lib/site-packages/annotated_types-0.7.0.dist-info/licenses/LICENSE new file mode 100644 index 0000000..d99323a --- /dev/null +++ b/env/Lib/site-packages/annotated_types-0.7.0.dist-info/licenses/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2022 the contributors + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/env/Lib/site-packages/annotated_types/__init__.py b/env/Lib/site-packages/annotated_types/__init__.py new file mode 100644 index 0000000..74e0dee --- /dev/null +++ b/env/Lib/site-packages/annotated_types/__init__.py @@ -0,0 +1,432 @@ +import math +import sys +import types +from dataclasses import dataclass +from datetime import tzinfo +from typing import TYPE_CHECKING, Any, Callable, Iterator, Optional, SupportsFloat, SupportsIndex, TypeVar, Union + +if sys.version_info < (3, 8): + from typing_extensions import Protocol, runtime_checkable +else: + from typing import Protocol, runtime_checkable + +if sys.version_info < (3, 9): + from typing_extensions import Annotated, Literal +else: + from typing import Annotated, Literal + +if sys.version_info < (3, 10): + EllipsisType = type(Ellipsis) + KW_ONLY = {} + SLOTS = {} +else: + from types import EllipsisType + + KW_ONLY = {"kw_only": True} + SLOTS = {"slots": True} + + +__all__ = ( + 'BaseMetadata', + 'GroupedMetadata', + 'Gt', + 'Ge', + 'Lt', + 'Le', + 'Interval', + 'MultipleOf', + 'MinLen', + 'MaxLen', + 'Len', + 'Timezone', + 'Predicate', + 'LowerCase', + 'UpperCase', + 'IsDigits', + 'IsFinite', + 'IsNotFinite', + 'IsNan', + 'IsNotNan', + 'IsInfinite', + 'IsNotInfinite', + 'doc', + 'DocInfo', + '__version__', +) + +__version__ = '0.7.0' + + +T = TypeVar('T') + + +# arguments that start with __ are considered +# positional only +# see https://peps.python.org/pep-0484/#positional-only-arguments + + +class SupportsGt(Protocol): + def __gt__(self: T, __other: T) -> bool: + ... + + +class SupportsGe(Protocol): + def __ge__(self: T, __other: T) -> bool: + ... + + +class SupportsLt(Protocol): + def __lt__(self: T, __other: T) -> bool: + ... + + +class SupportsLe(Protocol): + def __le__(self: T, __other: T) -> bool: + ... + + +class SupportsMod(Protocol): + def __mod__(self: T, __other: T) -> T: + ... + + +class SupportsDiv(Protocol): + def __div__(self: T, __other: T) -> T: + ... + + +class BaseMetadata: + """Base class for all metadata. + + This exists mainly so that implementers + can do `isinstance(..., BaseMetadata)` while traversing field annotations. + """ + + __slots__ = () + + +@dataclass(frozen=True, **SLOTS) +class Gt(BaseMetadata): + """Gt(gt=x) implies that the value must be greater than x. + + It can be used with any type that supports the ``>`` operator, + including numbers, dates and times, strings, sets, and so on. + """ + + gt: SupportsGt + + +@dataclass(frozen=True, **SLOTS) +class Ge(BaseMetadata): + """Ge(ge=x) implies that the value must be greater than or equal to x. + + It can be used with any type that supports the ``>=`` operator, + including numbers, dates and times, strings, sets, and so on. + """ + + ge: SupportsGe + + +@dataclass(frozen=True, **SLOTS) +class Lt(BaseMetadata): + """Lt(lt=x) implies that the value must be less than x. + + It can be used with any type that supports the ``<`` operator, + including numbers, dates and times, strings, sets, and so on. + """ + + lt: SupportsLt + + +@dataclass(frozen=True, **SLOTS) +class Le(BaseMetadata): + """Le(le=x) implies that the value must be less than or equal to x. + + It can be used with any type that supports the ``<=`` operator, + including numbers, dates and times, strings, sets, and so on. + """ + + le: SupportsLe + + +@runtime_checkable +class GroupedMetadata(Protocol): + """A grouping of multiple objects, like typing.Unpack. + + `GroupedMetadata` on its own is not metadata and has no meaning. + All of the constraints and metadata should be fully expressable + in terms of the `BaseMetadata`'s returned by `GroupedMetadata.__iter__()`. + + Concrete implementations should override `GroupedMetadata.__iter__()` + to add their own metadata. + For example: + + >>> @dataclass + >>> class Field(GroupedMetadata): + >>> gt: float | None = None + >>> description: str | None = None + ... + >>> def __iter__(self) -> Iterable[object]: + >>> if self.gt is not None: + >>> yield Gt(self.gt) + >>> if self.description is not None: + >>> yield Description(self.gt) + + Also see the implementation of `Interval` below for an example. + + Parsers should recognize this and unpack it so that it can be used + both with and without unpacking: + + - `Annotated[int, Field(...)]` (parser must unpack Field) + - `Annotated[int, *Field(...)]` (PEP-646) + """ # noqa: trailing-whitespace + + @property + def __is_annotated_types_grouped_metadata__(self) -> Literal[True]: + return True + + def __iter__(self) -> Iterator[object]: + ... + + if not TYPE_CHECKING: + __slots__ = () # allow subclasses to use slots + + def __init_subclass__(cls, *args: Any, **kwargs: Any) -> None: + # Basic ABC like functionality without the complexity of an ABC + super().__init_subclass__(*args, **kwargs) + if cls.__iter__ is GroupedMetadata.__iter__: + raise TypeError("Can't subclass GroupedMetadata without implementing __iter__") + + def __iter__(self) -> Iterator[object]: # noqa: F811 + raise NotImplementedError # more helpful than "None has no attribute..." type errors + + +@dataclass(frozen=True, **KW_ONLY, **SLOTS) +class Interval(GroupedMetadata): + """Interval can express inclusive or exclusive bounds with a single object. + + It accepts keyword arguments ``gt``, ``ge``, ``lt``, and/or ``le``, which + are interpreted the same way as the single-bound constraints. + """ + + gt: Union[SupportsGt, None] = None + ge: Union[SupportsGe, None] = None + lt: Union[SupportsLt, None] = None + le: Union[SupportsLe, None] = None + + def __iter__(self) -> Iterator[BaseMetadata]: + """Unpack an Interval into zero or more single-bounds.""" + if self.gt is not None: + yield Gt(self.gt) + if self.ge is not None: + yield Ge(self.ge) + if self.lt is not None: + yield Lt(self.lt) + if self.le is not None: + yield Le(self.le) + + +@dataclass(frozen=True, **SLOTS) +class MultipleOf(BaseMetadata): + """MultipleOf(multiple_of=x) might be interpreted in two ways: + + 1. Python semantics, implying ``value % multiple_of == 0``, or + 2. JSONschema semantics, where ``int(value / multiple_of) == value / multiple_of`` + + We encourage users to be aware of these two common interpretations, + and libraries to carefully document which they implement. + """ + + multiple_of: Union[SupportsDiv, SupportsMod] + + +@dataclass(frozen=True, **SLOTS) +class MinLen(BaseMetadata): + """ + MinLen() implies minimum inclusive length, + e.g. ``len(value) >= min_length``. + """ + + min_length: Annotated[int, Ge(0)] + + +@dataclass(frozen=True, **SLOTS) +class MaxLen(BaseMetadata): + """ + MaxLen() implies maximum inclusive length, + e.g. ``len(value) <= max_length``. + """ + + max_length: Annotated[int, Ge(0)] + + +@dataclass(frozen=True, **SLOTS) +class Len(GroupedMetadata): + """ + Len() implies that ``min_length <= len(value) <= max_length``. + + Upper bound may be omitted or ``None`` to indicate no upper length bound. + """ + + min_length: Annotated[int, Ge(0)] = 0 + max_length: Optional[Annotated[int, Ge(0)]] = None + + def __iter__(self) -> Iterator[BaseMetadata]: + """Unpack a Len into zone or more single-bounds.""" + if self.min_length > 0: + yield MinLen(self.min_length) + if self.max_length is not None: + yield MaxLen(self.max_length) + + +@dataclass(frozen=True, **SLOTS) +class Timezone(BaseMetadata): + """Timezone(tz=...) requires a datetime to be aware (or ``tz=None``, naive). + + ``Annotated[datetime, Timezone(None)]`` must be a naive datetime. + ``Timezone[...]`` (the ellipsis literal) expresses that the datetime must be + tz-aware but any timezone is allowed. + + You may also pass a specific timezone string or tzinfo object such as + ``Timezone(timezone.utc)`` or ``Timezone("Africa/Abidjan")`` to express that + you only allow a specific timezone, though we note that this is often + a symptom of poor design. + """ + + tz: Union[str, tzinfo, EllipsisType, None] + + +@dataclass(frozen=True, **SLOTS) +class Unit(BaseMetadata): + """Indicates that the value is a physical quantity with the specified unit. + + It is intended for usage with numeric types, where the value represents the + magnitude of the quantity. For example, ``distance: Annotated[float, Unit('m')]`` + or ``speed: Annotated[float, Unit('m/s')]``. + + Interpretation of the unit string is left to the discretion of the consumer. + It is suggested to follow conventions established by python libraries that work + with physical quantities, such as + + - ``pint`` : + - ``astropy.units``: + + For indicating a quantity with a certain dimensionality but without a specific unit + it is recommended to use square brackets, e.g. `Annotated[float, Unit('[time]')]`. + Note, however, ``annotated_types`` itself makes no use of the unit string. + """ + + unit: str + + +@dataclass(frozen=True, **SLOTS) +class Predicate(BaseMetadata): + """``Predicate(func: Callable)`` implies `func(value)` is truthy for valid values. + + Users should prefer statically inspectable metadata, but if you need the full + power and flexibility of arbitrary runtime predicates... here it is. + + We provide a few predefined predicates for common string constraints: + ``IsLower = Predicate(str.islower)``, ``IsUpper = Predicate(str.isupper)``, and + ``IsDigits = Predicate(str.isdigit)``. Users are encouraged to use methods which + can be given special handling, and avoid indirection like ``lambda s: s.lower()``. + + Some libraries might have special logic to handle certain predicates, e.g. by + checking for `str.isdigit` and using its presence to both call custom logic to + enforce digit-only strings, and customise some generated external schema. + + We do not specify what behaviour should be expected for predicates that raise + an exception. For example `Annotated[int, Predicate(str.isdigit)]` might silently + skip invalid constraints, or statically raise an error; or it might try calling it + and then propagate or discard the resulting exception. + """ + + func: Callable[[Any], bool] + + def __repr__(self) -> str: + if getattr(self.func, "__name__", "") == "": + return f"{self.__class__.__name__}({self.func!r})" + if isinstance(self.func, (types.MethodType, types.BuiltinMethodType)) and ( + namespace := getattr(self.func.__self__, "__name__", None) + ): + return f"{self.__class__.__name__}({namespace}.{self.func.__name__})" + if isinstance(self.func, type(str.isascii)): # method descriptor + return f"{self.__class__.__name__}({self.func.__qualname__})" + return f"{self.__class__.__name__}({self.func.__name__})" + + +@dataclass +class Not: + func: Callable[[Any], bool] + + def __call__(self, __v: Any) -> bool: + return not self.func(__v) + + +_StrType = TypeVar("_StrType", bound=str) + +LowerCase = Annotated[_StrType, Predicate(str.islower)] +""" +Return True if the string is a lowercase string, False otherwise. + +A string is lowercase if all cased characters in the string are lowercase and there is at least one cased character in the string. +""" # noqa: E501 +UpperCase = Annotated[_StrType, Predicate(str.isupper)] +""" +Return True if the string is an uppercase string, False otherwise. + +A string is uppercase if all cased characters in the string are uppercase and there is at least one cased character in the string. +""" # noqa: E501 +IsDigit = Annotated[_StrType, Predicate(str.isdigit)] +IsDigits = IsDigit # type: ignore # plural for backwards compatibility, see #63 +""" +Return True if the string is a digit string, False otherwise. + +A string is a digit string if all characters in the string are digits and there is at least one character in the string. +""" # noqa: E501 +IsAscii = Annotated[_StrType, Predicate(str.isascii)] +""" +Return True if all characters in the string are ASCII, False otherwise. + +ASCII characters have code points in the range U+0000-U+007F. Empty string is ASCII too. +""" + +_NumericType = TypeVar('_NumericType', bound=Union[SupportsFloat, SupportsIndex]) +IsFinite = Annotated[_NumericType, Predicate(math.isfinite)] +"""Return True if x is neither an infinity nor a NaN, and False otherwise.""" +IsNotFinite = Annotated[_NumericType, Predicate(Not(math.isfinite))] +"""Return True if x is one of infinity or NaN, and False otherwise""" +IsNan = Annotated[_NumericType, Predicate(math.isnan)] +"""Return True if x is a NaN (not a number), and False otherwise.""" +IsNotNan = Annotated[_NumericType, Predicate(Not(math.isnan))] +"""Return True if x is anything but NaN (not a number), and False otherwise.""" +IsInfinite = Annotated[_NumericType, Predicate(math.isinf)] +"""Return True if x is a positive or negative infinity, and False otherwise.""" +IsNotInfinite = Annotated[_NumericType, Predicate(Not(math.isinf))] +"""Return True if x is neither a positive or negative infinity, and False otherwise.""" + +try: + from typing_extensions import DocInfo, doc # type: ignore [attr-defined] +except ImportError: + + @dataclass(frozen=True, **SLOTS) + class DocInfo: # type: ignore [no-redef] + """ " + The return value of doc(), mainly to be used by tools that want to extract the + Annotated documentation at runtime. + """ + + documentation: str + """The documentation string passed to doc().""" + + def doc( + documentation: str, + ) -> DocInfo: + """ + Add documentation to a type annotation inside of Annotated. + + For example: + + >>> def hi(name: Annotated[int, doc("The name of the user")]) -> None: ... + """ + return DocInfo(documentation) diff --git a/env/Lib/site-packages/annotated_types/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/annotated_types/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..06c406d6dd1c6dc9671344f3afee480046e99217 GIT binary patch literal 20552 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/annotated_types/__pycache__/test_cases.cpython-311.pyc b/env/Lib/site-packages/annotated_types/__pycache__/test_cases.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..416125f2d692573c73ce6225d3fd0f42a5d53d22 GIT binary patch literal 15443 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/annotated_types/py.typed b/env/Lib/site-packages/annotated_types/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/annotated_types/test_cases.py b/env/Lib/site-packages/annotated_types/test_cases.py new file mode 100644 index 0000000..d9164d6 --- /dev/null +++ b/env/Lib/site-packages/annotated_types/test_cases.py @@ -0,0 +1,151 @@ +import math +import sys +from datetime import date, datetime, timedelta, timezone +from decimal import Decimal +from typing import Any, Dict, Iterable, Iterator, List, NamedTuple, Set, Tuple + +if sys.version_info < (3, 9): + from typing_extensions import Annotated +else: + from typing import Annotated + +import annotated_types as at + + +class Case(NamedTuple): + """ + A test case for `annotated_types`. + """ + + annotation: Any + valid_cases: Iterable[Any] + invalid_cases: Iterable[Any] + + +def cases() -> Iterable[Case]: + # Gt, Ge, Lt, Le + yield Case(Annotated[int, at.Gt(4)], (5, 6, 1000), (4, 0, -1)) + yield Case(Annotated[float, at.Gt(0.5)], (0.6, 0.7, 0.8, 0.9), (0.5, 0.0, -0.1)) + yield Case( + Annotated[datetime, at.Gt(datetime(2000, 1, 1))], + [datetime(2000, 1, 2), datetime(2000, 1, 3)], + [datetime(2000, 1, 1), datetime(1999, 12, 31)], + ) + yield Case( + Annotated[datetime, at.Gt(date(2000, 1, 1))], + [date(2000, 1, 2), date(2000, 1, 3)], + [date(2000, 1, 1), date(1999, 12, 31)], + ) + yield Case( + Annotated[datetime, at.Gt(Decimal('1.123'))], + [Decimal('1.1231'), Decimal('123')], + [Decimal('1.123'), Decimal('0')], + ) + + yield Case(Annotated[int, at.Ge(4)], (4, 5, 6, 1000, 4), (0, -1)) + yield Case(Annotated[float, at.Ge(0.5)], (0.5, 0.6, 0.7, 0.8, 0.9), (0.4, 0.0, -0.1)) + yield Case( + Annotated[datetime, at.Ge(datetime(2000, 1, 1))], + [datetime(2000, 1, 2), datetime(2000, 1, 3)], + [datetime(1998, 1, 1), datetime(1999, 12, 31)], + ) + + yield Case(Annotated[int, at.Lt(4)], (0, -1), (4, 5, 6, 1000, 4)) + yield Case(Annotated[float, at.Lt(0.5)], (0.4, 0.0, -0.1), (0.5, 0.6, 0.7, 0.8, 0.9)) + yield Case( + Annotated[datetime, at.Lt(datetime(2000, 1, 1))], + [datetime(1999, 12, 31), datetime(1999, 12, 31)], + [datetime(2000, 1, 2), datetime(2000, 1, 3)], + ) + + yield Case(Annotated[int, at.Le(4)], (4, 0, -1), (5, 6, 1000)) + yield Case(Annotated[float, at.Le(0.5)], (0.5, 0.0, -0.1), (0.6, 0.7, 0.8, 0.9)) + yield Case( + Annotated[datetime, at.Le(datetime(2000, 1, 1))], + [datetime(2000, 1, 1), datetime(1999, 12, 31)], + [datetime(2000, 1, 2), datetime(2000, 1, 3)], + ) + + # Interval + yield Case(Annotated[int, at.Interval(gt=4)], (5, 6, 1000), (4, 0, -1)) + yield Case(Annotated[int, at.Interval(gt=4, lt=10)], (5, 6), (4, 10, 1000, 0, -1)) + yield Case(Annotated[float, at.Interval(ge=0.5, le=1)], (0.5, 0.9, 1), (0.49, 1.1)) + yield Case( + Annotated[datetime, at.Interval(gt=datetime(2000, 1, 1), le=datetime(2000, 1, 3))], + [datetime(2000, 1, 2), datetime(2000, 1, 3)], + [datetime(2000, 1, 1), datetime(2000, 1, 4)], + ) + + yield Case(Annotated[int, at.MultipleOf(multiple_of=3)], (0, 3, 9), (1, 2, 4)) + yield Case(Annotated[float, at.MultipleOf(multiple_of=0.5)], (0, 0.5, 1, 1.5), (0.4, 1.1)) + + # lengths + + yield Case(Annotated[str, at.MinLen(3)], ('123', '1234', 'x' * 10), ('', '1', '12')) + yield Case(Annotated[str, at.Len(3)], ('123', '1234', 'x' * 10), ('', '1', '12')) + yield Case(Annotated[List[int], at.MinLen(3)], ([1, 2, 3], [1, 2, 3, 4], [1] * 10), ([], [1], [1, 2])) + yield Case(Annotated[List[int], at.Len(3)], ([1, 2, 3], [1, 2, 3, 4], [1] * 10), ([], [1], [1, 2])) + + yield Case(Annotated[str, at.MaxLen(4)], ('', '1234'), ('12345', 'x' * 10)) + yield Case(Annotated[str, at.Len(0, 4)], ('', '1234'), ('12345', 'x' * 10)) + yield Case(Annotated[List[str], at.MaxLen(4)], ([], ['a', 'bcdef'], ['a', 'b', 'c']), (['a'] * 5, ['b'] * 10)) + yield Case(Annotated[List[str], at.Len(0, 4)], ([], ['a', 'bcdef'], ['a', 'b', 'c']), (['a'] * 5, ['b'] * 10)) + + yield Case(Annotated[str, at.Len(3, 5)], ('123', '12345'), ('', '1', '12', '123456', 'x' * 10)) + yield Case(Annotated[str, at.Len(3, 3)], ('123',), ('12', '1234')) + + yield Case(Annotated[Dict[int, int], at.Len(2, 3)], [{1: 1, 2: 2}], [{}, {1: 1}, {1: 1, 2: 2, 3: 3, 4: 4}]) + yield Case(Annotated[Set[int], at.Len(2, 3)], ({1, 2}, {1, 2, 3}), (set(), {1}, {1, 2, 3, 4})) + yield Case(Annotated[Tuple[int, ...], at.Len(2, 3)], ((1, 2), (1, 2, 3)), ((), (1,), (1, 2, 3, 4))) + + # Timezone + + yield Case( + Annotated[datetime, at.Timezone(None)], [datetime(2000, 1, 1)], [datetime(2000, 1, 1, tzinfo=timezone.utc)] + ) + yield Case( + Annotated[datetime, at.Timezone(...)], [datetime(2000, 1, 1, tzinfo=timezone.utc)], [datetime(2000, 1, 1)] + ) + yield Case( + Annotated[datetime, at.Timezone(timezone.utc)], + [datetime(2000, 1, 1, tzinfo=timezone.utc)], + [datetime(2000, 1, 1), datetime(2000, 1, 1, tzinfo=timezone(timedelta(hours=6)))], + ) + yield Case( + Annotated[datetime, at.Timezone('Europe/London')], + [datetime(2000, 1, 1, tzinfo=timezone(timedelta(0), name='Europe/London'))], + [datetime(2000, 1, 1), datetime(2000, 1, 1, tzinfo=timezone(timedelta(hours=6)))], + ) + + # Quantity + + yield Case(Annotated[float, at.Unit(unit='m')], (5, 4.2), ('5m', '4.2m')) + + # predicate types + + yield Case(at.LowerCase[str], ['abc', 'foobar'], ['', 'A', 'Boom']) + yield Case(at.UpperCase[str], ['ABC', 'DEFO'], ['', 'a', 'abc', 'AbC']) + yield Case(at.IsDigit[str], ['123'], ['', 'ab', 'a1b2']) + yield Case(at.IsAscii[str], ['123', 'foo bar'], ['£100', '😊', 'whatever 👀']) + + yield Case(Annotated[int, at.Predicate(lambda x: x % 2 == 0)], [0, 2, 4], [1, 3, 5]) + + yield Case(at.IsFinite[float], [1.23], [math.nan, math.inf, -math.inf]) + yield Case(at.IsNotFinite[float], [math.nan, math.inf], [1.23]) + yield Case(at.IsNan[float], [math.nan], [1.23, math.inf]) + yield Case(at.IsNotNan[float], [1.23, math.inf], [math.nan]) + yield Case(at.IsInfinite[float], [math.inf], [math.nan, 1.23]) + yield Case(at.IsNotInfinite[float], [math.nan, 1.23], [math.inf]) + + # check stacked predicates + yield Case(at.IsInfinite[Annotated[float, at.Predicate(lambda x: x > 0)]], [math.inf], [-math.inf, 1.23, math.nan]) + + # doc + yield Case(Annotated[int, at.doc("A number")], [1, 2], []) + + # custom GroupedMetadata + class MyCustomGroupedMetadata(at.GroupedMetadata): + def __iter__(self) -> Iterator[at.Predicate]: + yield at.Predicate(lambda x: float(x).is_integer()) + + yield Case(Annotated[float, MyCustomGroupedMetadata()], [0, 2.0], [0.01, 1.5]) diff --git a/env/Lib/site-packages/async_timeout-4.0.3.dist-info/INSTALLER b/env/Lib/site-packages/async_timeout-4.0.3.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/Lib/site-packages/async_timeout-4.0.3.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/Lib/site-packages/async_timeout-4.0.3.dist-info/LICENSE b/env/Lib/site-packages/async_timeout-4.0.3.dist-info/LICENSE new file mode 100644 index 0000000..033c86b --- /dev/null +++ b/env/Lib/site-packages/async_timeout-4.0.3.dist-info/LICENSE @@ -0,0 +1,13 @@ +Copyright 2016-2020 aio-libs collaboration. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. diff --git a/env/Lib/site-packages/async_timeout-4.0.3.dist-info/METADATA b/env/Lib/site-packages/async_timeout-4.0.3.dist-info/METADATA new file mode 100644 index 0000000..d8dd6d1 --- /dev/null +++ b/env/Lib/site-packages/async_timeout-4.0.3.dist-info/METADATA @@ -0,0 +1,131 @@ +Metadata-Version: 2.1 +Name: async-timeout +Version: 4.0.3 +Summary: Timeout context manager for asyncio programs +Home-page: https://github.com/aio-libs/async-timeout +Author: Andrew Svetlov +Author-email: andrew.svetlov@gmail.com +License: Apache 2 +Project-URL: Chat: Gitter, https://gitter.im/aio-libs/Lobby +Project-URL: CI: GitHub Actions, https://github.com/aio-libs/async-timeout/actions +Project-URL: Coverage: codecov, https://codecov.io/github/aio-libs/async-timeout +Project-URL: GitHub: issues, https://github.com/aio-libs/async-timeout/issues +Project-URL: GitHub: repo, https://github.com/aio-libs/async-timeout +Classifier: Development Status :: 5 - Production/Stable +Classifier: Topic :: Software Development :: Libraries +Classifier: Framework :: AsyncIO +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: Apache Software License +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Programming Language :: Python :: 3.7 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Requires-Python: >=3.7 +Description-Content-Type: text/x-rst +License-File: LICENSE +Requires-Dist: typing-extensions >=3.6.5 ; python_version < "3.8" + +async-timeout +============= +.. image:: https://travis-ci.com/aio-libs/async-timeout.svg?branch=master + :target: https://travis-ci.com/aio-libs/async-timeout +.. image:: https://codecov.io/gh/aio-libs/async-timeout/branch/master/graph/badge.svg + :target: https://codecov.io/gh/aio-libs/async-timeout +.. image:: https://img.shields.io/pypi/v/async-timeout.svg + :target: https://pypi.python.org/pypi/async-timeout +.. image:: https://badges.gitter.im/Join%20Chat.svg + :target: https://gitter.im/aio-libs/Lobby + :alt: Chat on Gitter + +asyncio-compatible timeout context manager. + + +Usage example +------------- + + +The context manager is useful in cases when you want to apply timeout +logic around block of code or in cases when ``asyncio.wait_for()`` is +not suitable. Also it's much faster than ``asyncio.wait_for()`` +because ``timeout`` doesn't create a new task. + +The ``timeout(delay, *, loop=None)`` call returns a context manager +that cancels a block on *timeout* expiring:: + + from async_timeout import timeout + async with timeout(1.5): + await inner() + +1. If ``inner()`` is executed faster than in ``1.5`` seconds nothing + happens. +2. Otherwise ``inner()`` is cancelled internally by sending + ``asyncio.CancelledError`` into but ``asyncio.TimeoutError`` is + raised outside of context manager scope. + +*timeout* parameter could be ``None`` for skipping timeout functionality. + + +Alternatively, ``timeout_at(when)`` can be used for scheduling +at the absolute time:: + + loop = asyncio.get_event_loop() + now = loop.time() + + async with timeout_at(now + 1.5): + await inner() + + +Please note: it is not POSIX time but a time with +undefined starting base, e.g. the time of the system power on. + + +Context manager has ``.expired`` property for check if timeout happens +exactly in context manager:: + + async with timeout(1.5) as cm: + await inner() + print(cm.expired) + +The property is ``True`` if ``inner()`` execution is cancelled by +timeout context manager. + +If ``inner()`` call explicitly raises ``TimeoutError`` ``cm.expired`` +is ``False``. + +The scheduled deadline time is available as ``.deadline`` property:: + + async with timeout(1.5) as cm: + cm.deadline + +Not finished yet timeout can be rescheduled by ``shift_by()`` +or ``shift_to()`` methods:: + + async with timeout(1.5) as cm: + cm.shift(1) # add another second on waiting + cm.update(loop.time() + 5) # reschedule to now+5 seconds + +Rescheduling is forbidden if the timeout is expired or after exit from ``async with`` +code block. + + +Installation +------------ + +:: + + $ pip install async-timeout + +The library is Python 3 only! + + + +Authors and License +------------------- + +The module is written by Andrew Svetlov. + +It's *Apache 2* licensed and freely available. diff --git a/env/Lib/site-packages/async_timeout-4.0.3.dist-info/RECORD b/env/Lib/site-packages/async_timeout-4.0.3.dist-info/RECORD new file mode 100644 index 0000000..46abe88 --- /dev/null +++ b/env/Lib/site-packages/async_timeout-4.0.3.dist-info/RECORD @@ -0,0 +1,10 @@ +async_timeout-4.0.3.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +async_timeout-4.0.3.dist-info/LICENSE,sha256=4Y17uPUT4sRrtYXJS1hb0wcg3TzLId2weG9y0WZY-Sw,568 +async_timeout-4.0.3.dist-info/METADATA,sha256=WQVcnDIXQ2ntebcm-vYjhNLg_VMeTWw13_ReT-U36J4,4209 +async_timeout-4.0.3.dist-info/RECORD,, +async_timeout-4.0.3.dist-info/WHEEL,sha256=5sUXSg9e4bi7lTLOHcm6QEYwO5TIF1TNbTSVFVjcJcc,92 +async_timeout-4.0.3.dist-info/top_level.txt,sha256=9oM4e7Twq8iD_7_Q3Mz0E6GPIB6vJvRFo-UBwUQtBDU,14 +async_timeout-4.0.3.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1 +async_timeout/__init__.py,sha256=A0VOqDGQ3cCPFp0NZJKIbx_VRP1Y2xPtQOZebVIUB88,7242 +async_timeout/__pycache__/__init__.cpython-311.pyc,, +async_timeout/py.typed,sha256=tyozzRT1fziXETDxokmuyt6jhOmtjUbnVNJdZcG7ik0,12 diff --git a/env/Lib/site-packages/async_timeout-4.0.3.dist-info/WHEEL b/env/Lib/site-packages/async_timeout-4.0.3.dist-info/WHEEL new file mode 100644 index 0000000..2c08da0 --- /dev/null +++ b/env/Lib/site-packages/async_timeout-4.0.3.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.41.1) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/env/Lib/site-packages/async_timeout-4.0.3.dist-info/top_level.txt b/env/Lib/site-packages/async_timeout-4.0.3.dist-info/top_level.txt new file mode 100644 index 0000000..ad29955 --- /dev/null +++ b/env/Lib/site-packages/async_timeout-4.0.3.dist-info/top_level.txt @@ -0,0 +1 @@ +async_timeout diff --git a/env/Lib/site-packages/async_timeout-4.0.3.dist-info/zip-safe b/env/Lib/site-packages/async_timeout-4.0.3.dist-info/zip-safe new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/env/Lib/site-packages/async_timeout-4.0.3.dist-info/zip-safe @@ -0,0 +1 @@ + diff --git a/env/Lib/site-packages/async_timeout/__init__.py b/env/Lib/site-packages/async_timeout/__init__.py new file mode 100644 index 0000000..1ffb069 --- /dev/null +++ b/env/Lib/site-packages/async_timeout/__init__.py @@ -0,0 +1,239 @@ +import asyncio +import enum +import sys +import warnings +from types import TracebackType +from typing import Optional, Type + + +if sys.version_info >= (3, 8): + from typing import final +else: + from typing_extensions import final + + +if sys.version_info >= (3, 11): + + def _uncancel_task(task: "asyncio.Task[object]") -> None: + task.uncancel() + +else: + + def _uncancel_task(task: "asyncio.Task[object]") -> None: + pass + + +__version__ = "4.0.3" + + +__all__ = ("timeout", "timeout_at", "Timeout") + + +def timeout(delay: Optional[float]) -> "Timeout": + """timeout context manager. + + Useful in cases when you want to apply timeout logic around block + of code or in cases when asyncio.wait_for is not suitable. For example: + + >>> async with timeout(0.001): + ... async with aiohttp.get('https://github.com') as r: + ... await r.text() + + + delay - value in seconds or None to disable timeout logic + """ + loop = asyncio.get_running_loop() + if delay is not None: + deadline = loop.time() + delay # type: Optional[float] + else: + deadline = None + return Timeout(deadline, loop) + + +def timeout_at(deadline: Optional[float]) -> "Timeout": + """Schedule the timeout at absolute time. + + deadline argument points on the time in the same clock system + as loop.time(). + + Please note: it is not POSIX time but a time with + undefined starting base, e.g. the time of the system power on. + + >>> async with timeout_at(loop.time() + 10): + ... async with aiohttp.get('https://github.com') as r: + ... await r.text() + + + """ + loop = asyncio.get_running_loop() + return Timeout(deadline, loop) + + +class _State(enum.Enum): + INIT = "INIT" + ENTER = "ENTER" + TIMEOUT = "TIMEOUT" + EXIT = "EXIT" + + +@final +class Timeout: + # Internal class, please don't instantiate it directly + # Use timeout() and timeout_at() public factories instead. + # + # Implementation note: `async with timeout()` is preferred + # over `with timeout()`. + # While technically the Timeout class implementation + # doesn't need to be async at all, + # the `async with` statement explicitly points that + # the context manager should be used from async function context. + # + # This design allows to avoid many silly misusages. + # + # TimeoutError is raised immediately when scheduled + # if the deadline is passed. + # The purpose is to time out as soon as possible + # without waiting for the next await expression. + + __slots__ = ("_deadline", "_loop", "_state", "_timeout_handler", "_task") + + def __init__( + self, deadline: Optional[float], loop: asyncio.AbstractEventLoop + ) -> None: + self._loop = loop + self._state = _State.INIT + + self._task: Optional["asyncio.Task[object]"] = None + self._timeout_handler = None # type: Optional[asyncio.Handle] + if deadline is None: + self._deadline = None # type: Optional[float] + else: + self.update(deadline) + + def __enter__(self) -> "Timeout": + warnings.warn( + "with timeout() is deprecated, use async with timeout() instead", + DeprecationWarning, + stacklevel=2, + ) + self._do_enter() + return self + + def __exit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> Optional[bool]: + self._do_exit(exc_type) + return None + + async def __aenter__(self) -> "Timeout": + self._do_enter() + return self + + async def __aexit__( + self, + exc_type: Optional[Type[BaseException]], + exc_val: Optional[BaseException], + exc_tb: Optional[TracebackType], + ) -> Optional[bool]: + self._do_exit(exc_type) + return None + + @property + def expired(self) -> bool: + """Is timeout expired during execution?""" + return self._state == _State.TIMEOUT + + @property + def deadline(self) -> Optional[float]: + return self._deadline + + def reject(self) -> None: + """Reject scheduled timeout if any.""" + # cancel is maybe better name but + # task.cancel() raises CancelledError in asyncio world. + if self._state not in (_State.INIT, _State.ENTER): + raise RuntimeError(f"invalid state {self._state.value}") + self._reject() + + def _reject(self) -> None: + self._task = None + if self._timeout_handler is not None: + self._timeout_handler.cancel() + self._timeout_handler = None + + def shift(self, delay: float) -> None: + """Advance timeout on delay seconds. + + The delay can be negative. + + Raise RuntimeError if shift is called when deadline is not scheduled + """ + deadline = self._deadline + if deadline is None: + raise RuntimeError("cannot shift timeout if deadline is not scheduled") + self.update(deadline + delay) + + def update(self, deadline: float) -> None: + """Set deadline to absolute value. + + deadline argument points on the time in the same clock system + as loop.time(). + + If new deadline is in the past the timeout is raised immediately. + + Please note: it is not POSIX time but a time with + undefined starting base, e.g. the time of the system power on. + """ + if self._state == _State.EXIT: + raise RuntimeError("cannot reschedule after exit from context manager") + if self._state == _State.TIMEOUT: + raise RuntimeError("cannot reschedule expired timeout") + if self._timeout_handler is not None: + self._timeout_handler.cancel() + self._deadline = deadline + if self._state != _State.INIT: + self._reschedule() + + def _reschedule(self) -> None: + assert self._state == _State.ENTER + deadline = self._deadline + if deadline is None: + return + + now = self._loop.time() + if self._timeout_handler is not None: + self._timeout_handler.cancel() + + self._task = asyncio.current_task() + if deadline <= now: + self._timeout_handler = self._loop.call_soon(self._on_timeout) + else: + self._timeout_handler = self._loop.call_at(deadline, self._on_timeout) + + def _do_enter(self) -> None: + if self._state != _State.INIT: + raise RuntimeError(f"invalid state {self._state.value}") + self._state = _State.ENTER + self._reschedule() + + def _do_exit(self, exc_type: Optional[Type[BaseException]]) -> None: + if exc_type is asyncio.CancelledError and self._state == _State.TIMEOUT: + assert self._task is not None + _uncancel_task(self._task) + self._timeout_handler = None + self._task = None + raise asyncio.TimeoutError + # timeout has not expired + self._state = _State.EXIT + self._reject() + return None + + def _on_timeout(self) -> None: + assert self._task is not None + self._task.cancel() + self._state = _State.TIMEOUT + # drop the reference early + self._timeout_handler = None diff --git a/env/Lib/site-packages/async_timeout/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/async_timeout/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2548378570cfe9c3b77faabcc8eb8a9fb7cded21 GIT binary patch literal 10188 zcmcgyTWlNId7dGM#O^G7a znW1DUa=}dvL@|V}8+c(A@d7FkY;0@-EYdB|$2_z^ANoKE1WXLzLO>B9+b1rZzU))K z{|sk1Bgw9t1|5?BoH^$|_wT=)fB38B<|v2jt6%)v)TMnK_aF4&T%mg6=~15J?sF=q z@;Pq8zVj12dk#zl*gZHA#66G`W)#iz~8rLFPORv)fr#7iAQ-azG zo>sMO*Rll4+5+4=oZ5byQ#&+%I^k6RJjiih;AdYG?OK%ab%L+u^8m{5v#-x_`@(tP zCOTApj7xTZO*x}U-fAA#m5es2WM;+}=d@(N60gje*+O2)S%RJOHFfi~2mFg9iZSzThhi+|Guc9F98W(gOipVV^DnHhu9-zWpTX|97mbXXe3}Be&ntRLEskf!jE2&ed?<9j(q&`wBT2G`E(~6AS!?!}JmQxn>9#ruSL_h``NC}Di zoaxz$X*ca(>|6XY_i@iMzwUwvRo%@<=qT+e1?MK2Wdsyvx1WM)_^g()%}_FG4}op3d_taAaz%}%WN27E)u0KE z7V;V`jG8rQ2G00owlr*Xqe;Pv)MswBVnAuVn9oB@(z!xm4l)cBG3+FRI_W4&VELk| zDQYg8*9?LX#%3dyfT|Ob@iWeYl(_%e!%6Lx*x`-XKqWR%8m>m9a-^r)-hKbgpTGIH zXYQR@@7!n~ToG5qt@iE}@kuOk_l>pjjo6_|>`+-a#IUX(KvTP;_g$2{D0)rDETGOZ zw+jk+Uyd%97q5g4jTi;yP)Y9ZoTK-5eiRpA6yPr;5(R6yYKqrMym1d(mU+2G+Y|Ct5YT4G##Jj=|fC-`!qE{3wb<} zpcbBX6}T#>p{cMMh7TgDy=nyaCRId@s1|F~X{6L9lzB?jD4r!xxq#>9#`BcO{G&M9 zme6*~pSkU3wAre)spxYmpvG?tezP@^U}e7fgRf-=U%R@8`Dh)ux1r5WHK73*SQ`Oe znK03%2HfWkJa>by6Zan6yKwJ)?!4@Fy1};x{5`nuWq{jjOF+nKN;{gz3fZbUoQBW? ziLH*~lD?tj)tsh-f%z(=Lz&R%5>lg?AgFUunto4z4g%jRu*{{MGR_RRNp9LrgTrk> zg*r_O4i|fJRqZlgYGOIzM)??dcP^rwe7Zv^1CL)gLde;+%?QfLkOOT5igtDrmHhr6Pf}y}G5=aobT!IXNo$jLRS;t`_FH_N)l2 z(I;K|?#&<(+j{*BJy+%a6`>;Tug2QTvAxy(2UmtyM_2IKl3G7`@6LN`;)ZmvA{{I{ zUnYe<3q}jXmV63{XIU_nH{E6Ba7g)e(C^^$w29NtQ*` z=5#HCMN^NHqt}Y7gqI7zxt+5}B8#l^9!pOVn;=(k9L`R)kV;nXE9&n#_2X znQaT(np5cX*(Z_bVD%ABBW%7mv*sg#O;`UO8q?1bIR|1;hk&E)IT0Q;@M8WRJl1oF zn@k|^DAD9_!nk{5Lp)Fs50u3NG(B@Cyl9{P8o#Hs)bBx#o;{DK47XW{kpG~f#~0{;R7VM={H zJqW93{gn7gKiVVyUoLYH6`zu7q9vZj-M)5Ln=?#-LKgX@{)>j|k!v^SvN{|$wWyQZ zrrp#sMLKSugZsnO+#xh-I|kc#15jplms*^ysAt?omHNRHimbI`^~ax0J;-mi950K< zcLIh~E}ID*L;W+UA5oJ$Q?c9Oz*KAlwvJu;lzOLQc!}F;X-k&{|i&wMuj;K#pt``4GteQ%ay^nH@( zD<8PLV_X|Uf%$#?Aq#& z4|$(nBuGHk9j&=7P&CAihyeMnZMVX9WM})T=Fj0pI@VH& z$>rGbs?-Xz{8$>=l!i8>qZR3BSvp$nA6gl9t#vKLNhiR{R)QURGfZaD9$hYE?d9;o z>{ehoP--z^4CuDnbzxKR*_T!g9f-2j|s!ify@A!}-!a`PYy8_2U~^ zlyRIj?J_KyJc(nZc3m;E^O}d}s*;7J_X1D`dW{>|DR$V*D7hT85sR=m0__|^UEH%X zCv`Zw^b&evu@cq*ff|uBYVnzsvAg82>7ztm0zn3uDz@NErT9V%R)~#lso6n4d;AqD z)Hk{o=Q?`som~-amyBWl>PBL$k{ByXV+8Zqo!H%X*NPh*{Tt#yMI0zQUmNn?U7;Oh zkUtG*`gNgC0l9T-t**Ct<6P=CSC$k_LnZmzAxyDr*LHTnP(z`8+>2IS_4ZN5wj&z$}uDP%7#w;q|9Qw#(UJ<%Q%=_DbloSmK3)GVCi+@fcse_DKo z2JwH4(NGg~xe}*qjy%fB6r5|g4u}^`>4n+tQPib_bs_asaomo&#EvGT9!oWdZMEfd zfKu#?HAX2WxQCIlV$irw{|Npw0VY4n7ndRFZkR3meD)8-bPoh(tIIZ9gAa~v#s{eZFSzJqYz52NP?e-T{ojV`<-}v~NS| zt4Mui=UWSM(jW$~(+0XqpW=frt`LmCC60+b6Cli%LkOKO;k^@`fTvxtUv~wVc$~{G zRxmEybl53lV(&ifewOyv=Q)$!D%7vWJ1svK6a)Ee?1GvI%wWFQ@j>5cV|KZpf`j4; z?D88iwCRp?$IP3ZI^H`eC{JrpvyJyw+gr0wDsc~P`_Yt*Q5G-QPmc}o(n-paGDTg- z5yp;;kegvOkN&gVpOYM$z@`%O1qQLk^ z5I7_7gUJWaZMGaOJ6}Y?8)mC2C05?viYHd5KPlWPY{U;#;s;iO&&T-hJNH#OlN+7K zDxJq{U#I=9ap&C1Ik+{yy!5#Ljm`cy{;8w#=EaTvOO^gh9#3b>W_WG0|Fth~{;s2P z{s$ZVS1bKjJuJ@=h2LUMFC+@K_1NdPjo4t+x37jE?B<^PETts>B=AH(K>Z!<8^Sl%UWU@%k)U4 zx707!b?@DEB>Ztd-^g57;wQXsEUr6&?Q}E6@eAMz+V5t zb7e;=k4j($jGZPDXozV8OR5X2%{xf>beeF?7@Z${X6!9wG>*AWbm!lRtpGw>-~Q=B zr5k4l`hMB})vsxzCu!dy4;?$zfYt+Yp*;wy&(-&U~r^C=Kxae-H$-x zr6-BrN`mr#?}QzF$F%1}d`Q%u(lNp>nD(xEMQ)wxbujv_?JMjJK2Ezf40|Ow)%<(j z*paY(c4O|sAu!va3l_;>s(4!vL;n$YJnFNdfBzE&_23_=&!uw9fc?ditVSP;y_;h1 zhPbyP?k$UZNuu&3QCs!+EP@VB+yVPa_Q`pLMCsAwKK%&g4G~F#P$1IC6-*J5=$zL`Z_H=C|;=ZRBP~V}F&QNDDsCd5LAsy*_0=Yy77kkTh#tDJn7CAXTIYawLSI6v7F33b#sKS|(m zD*^1TH&^ziDv6V|5HW-~v_C~|GRYx^s$M`}&<80DggyZx(uwHQ5ZZ!ti5 zej1hugSS!{z+#X_dxNRp#Cm2F_{3_av{xYx`AjW-nrn96=V#oHk%1iZ&S-tnZf?* z0^cj`FsBg=OOsQU)>Rq+`*#7o-^F`X^lrZhV(|CBCjD0YuKkMjtgeHbG@bD&Xf4R| ze3grr*r&?HO6*hRq9yjJaxEqHsd5L({%@5#Sl;am=nIibu>J1*W^jKwxW6jwEARMj z2}jEQuUl + Yury Selivanov diff --git a/env/Lib/site-packages/asyncpg-0.29.0.dist-info/INSTALLER b/env/Lib/site-packages/asyncpg-0.29.0.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/Lib/site-packages/asyncpg-0.29.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/Lib/site-packages/asyncpg-0.29.0.dist-info/LICENSE b/env/Lib/site-packages/asyncpg-0.29.0.dist-info/LICENSE new file mode 100644 index 0000000..d931386 --- /dev/null +++ b/env/Lib/site-packages/asyncpg-0.29.0.dist-info/LICENSE @@ -0,0 +1,204 @@ +Copyright (C) 2016-present the asyncpg authors and contributors. + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright (C) 2016-present the asyncpg authors and contributors + + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/env/Lib/site-packages/asyncpg-0.29.0.dist-info/METADATA b/env/Lib/site-packages/asyncpg-0.29.0.dist-info/METADATA new file mode 100644 index 0000000..08124ba --- /dev/null +++ b/env/Lib/site-packages/asyncpg-0.29.0.dist-info/METADATA @@ -0,0 +1,127 @@ +Metadata-Version: 2.1 +Name: asyncpg +Version: 0.29.0 +Summary: An asyncio PostgreSQL driver +Author-email: MagicStack Inc +License: Apache License, Version 2.0 +Project-URL: github, https://github.com/MagicStack/asyncpg +Keywords: database,postgres +Classifier: Development Status :: 5 - Production/Stable +Classifier: Framework :: AsyncIO +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: Apache Software License +Classifier: Operating System :: POSIX +Classifier: Operating System :: MacOS :: MacOS X +Classifier: Operating System :: Microsoft :: Windows +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Topic :: Database :: Front-Ends +Requires-Python: >=3.8.0 +Description-Content-Type: text/x-rst +License-File: LICENSE +License-File: AUTHORS +Requires-Dist: async-timeout >=4.0.3 ; python_version < "3.12.0" +Provides-Extra: docs +Requires-Dist: Sphinx ~=5.3.0 ; extra == 'docs' +Requires-Dist: sphinxcontrib-asyncio ~=0.3.0 ; extra == 'docs' +Requires-Dist: sphinx-rtd-theme >=1.2.2 ; extra == 'docs' +Provides-Extra: test +Requires-Dist: flake8 ~=6.1 ; extra == 'test' +Requires-Dist: uvloop >=0.15.3 ; (platform_system != "Windows" and python_version < "3.12.0") and extra == 'test' + +asyncpg -- A fast PostgreSQL Database Client Library for Python/asyncio +======================================================================= + +.. image:: https://github.com/MagicStack/asyncpg/workflows/Tests/badge.svg + :target: https://github.com/MagicStack/asyncpg/actions?query=workflow%3ATests+branch%3Amaster + :alt: GitHub Actions status +.. image:: https://img.shields.io/pypi/v/asyncpg.svg + :target: https://pypi.python.org/pypi/asyncpg + +**asyncpg** is a database interface library designed specifically for +PostgreSQL and Python/asyncio. asyncpg is an efficient, clean implementation +of PostgreSQL server binary protocol for use with Python's ``asyncio`` +framework. You can read more about asyncpg in an introductory +`blog post `_. + +asyncpg requires Python 3.8 or later and is supported for PostgreSQL +versions 9.5 to 16. Older PostgreSQL versions or other databases implementing +the PostgreSQL protocol *may* work, but are not being actively tested. + + +Documentation +------------- + +The project documentation can be found +`here `_. + + +Performance +----------- + +In our testing asyncpg is, on average, **5x** faster than psycopg3. + +.. image:: https://raw.githubusercontent.com/MagicStack/asyncpg/master/performance.png?fddca40ab0 + :target: https://gistpreview.github.io/?0ed296e93523831ea0918d42dd1258c2 + +The above results are a geometric mean of benchmarks obtained with PostgreSQL +`client driver benchmarking toolbench `_ +in June 2023 (click on the chart to see full details). + + +Features +-------- + +asyncpg implements PostgreSQL server protocol natively and exposes its +features directly, as opposed to hiding them behind a generic facade +like DB-API. + +This enables asyncpg to have easy-to-use support for: + +* **prepared statements** +* **scrollable cursors** +* **partial iteration** on query results +* automatic encoding and decoding of composite types, arrays, + and any combination of those +* straightforward support for custom data types + + +Installation +------------ + +asyncpg is available on PyPI and has no dependencies. +Use pip to install:: + + $ pip install asyncpg + + +Basic Usage +----------- + +.. code-block:: python + + import asyncio + import asyncpg + + async def run(): + conn = await asyncpg.connect(user='user', password='password', + database='database', host='127.0.0.1') + values = await conn.fetch( + 'SELECT * FROM mytable WHERE id = $1', + 10, + ) + await conn.close() + + loop = asyncio.get_event_loop() + loop.run_until_complete(run()) + + +License +------- + +asyncpg is developed and distributed under the Apache 2.0 license. diff --git a/env/Lib/site-packages/asyncpg-0.29.0.dist-info/RECORD b/env/Lib/site-packages/asyncpg-0.29.0.dist-info/RECORD new file mode 100644 index 0000000..15f385b --- /dev/null +++ b/env/Lib/site-packages/asyncpg-0.29.0.dist-info/RECORD @@ -0,0 +1,111 @@ +asyncpg-0.29.0.dist-info/AUTHORS,sha256=eFUq_BnBQPCWi3PJTDNl8YCbrcNLfMIiN-b3x_1wTYk,136 +asyncpg-0.29.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +asyncpg-0.29.0.dist-info/LICENSE,sha256=CqxXCYIpatnpe8MnCEeeQM97YNV4fIrBh9hsFYPpLsA,11670 +asyncpg-0.29.0.dist-info/METADATA,sha256=_Vd2Lex_ABc_Zv1bjpfFzgdGrYecGl4sgSJdq1IriR4,4483 +asyncpg-0.29.0.dist-info/RECORD,, +asyncpg-0.29.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +asyncpg-0.29.0.dist-info/WHEEL,sha256=badvNS-y9fEq0X-qzdZYvql_JFjI7Xfw-wR8FsjoK0I,102 +asyncpg-0.29.0.dist-info/top_level.txt,sha256=DdhVhpzCq49mykkHNag6i9zuJx05_tx4CMZymM1F8dU,8 +asyncpg/__init__.py,sha256=EbywzGkj2v63N1p2vEs-K2GAuRvZnCesEDNrnl3u8sQ,582 +asyncpg/__pycache__/__init__.cpython-311.pyc,, +asyncpg/__pycache__/_asyncio_compat.cpython-311.pyc,, +asyncpg/__pycache__/_version.cpython-311.pyc,, +asyncpg/__pycache__/cluster.cpython-311.pyc,, +asyncpg/__pycache__/compat.cpython-311.pyc,, +asyncpg/__pycache__/connect_utils.cpython-311.pyc,, +asyncpg/__pycache__/connection.cpython-311.pyc,, +asyncpg/__pycache__/connresource.cpython-311.pyc,, +asyncpg/__pycache__/cursor.cpython-311.pyc,, +asyncpg/__pycache__/introspection.cpython-311.pyc,, +asyncpg/__pycache__/pool.cpython-311.pyc,, +asyncpg/__pycache__/prepared_stmt.cpython-311.pyc,, +asyncpg/__pycache__/serverversion.cpython-311.pyc,, +asyncpg/__pycache__/transaction.cpython-311.pyc,, +asyncpg/__pycache__/types.cpython-311.pyc,, +asyncpg/__pycache__/utils.cpython-311.pyc,, +asyncpg/_asyncio_compat.py,sha256=IDBWCPfxBOpSvvDE5SllI8qQLNHJxzxieTEi4ZsF6R0,2386 +asyncpg/_testbase/__init__.py,sha256=eFHWCy5DN4YtyJfsXivMyOmR1zMhTkJO-xlFfpf7kCQ,16593 +asyncpg/_testbase/__pycache__/__init__.cpython-311.pyc,, +asyncpg/_testbase/__pycache__/fuzzer.cpython-311.pyc,, +asyncpg/_testbase/fuzzer.py,sha256=nYsnhLXQEquuJtWjWx3feHoj5_Ctu9bH6VCQ2ZsphFc,10110 +asyncpg/_version.py,sha256=nqG2dBwjFrQZN2ThbMdhIgstJhmaMPUZTbgyOoTJRlA,589 +asyncpg/cluster.py,sha256=X8xil2DhPlYy8EE4mscsKjOHuFsVs1Hwpu71rhx-CUo,23971 +asyncpg/compat.py,sha256=Daw2GdDZT2lFXqrswcZxTLaWmPnhyeFkssL8YJJycSo,1830 +asyncpg/connect_utils.py,sha256=rdlSo1Ty2-HUYdcUib1jmRWlkmgs1faGnCTgk_EGpGM,36060 +asyncpg/connection.py,sha256=sYzIUIC7ski--9BiwUM6TrAPa4sQHTol78nc3wdHNPM,97882 +asyncpg/connresource.py,sha256=T0vpfsZuS96AkltQfpynAgPLLheVDy_hSj0ejcZkbAQ,1428 +asyncpg/cursor.py,sha256=noklB-NjAeYAhhI705QJuKuXoI7ZZ0hyMUKqMdDxTxw,9483 +asyncpg/exceptions/__init__.py,sha256=WQTAOBUrkIzIW12s78q-v-v06Uv8wRMgrmq_y69klSo,30024 +asyncpg/exceptions/__pycache__/__init__.cpython-311.pyc,, +asyncpg/exceptions/__pycache__/_base.cpython-311.pyc,, +asyncpg/exceptions/_base.py,sha256=CJy579cVjuf7JbIUY01MouaElHqg_obGC_cuT8nPtkQ,9559 +asyncpg/introspection.py,sha256=YiXPqQppb7713EKonWpw5nVdWE0Xa6IaG12HUpoBqQo,9249 +asyncpg/pgproto/__init__.pxd,sha256=d36iPoZbiEOs4JLdV2lApUgy664JJZVdAvZTznHs2Qc,218 +asyncpg/pgproto/__init__.py,sha256=d36iPoZbiEOs4JLdV2lApUgy664JJZVdAvZTznHs2Qc,218 +asyncpg/pgproto/__pycache__/__init__.cpython-311.pyc,, +asyncpg/pgproto/__pycache__/types.cpython-311.pyc,, +asyncpg/pgproto/buffer.pxd,sha256=meKBG5f1l2B5B71laYNnJxj7W2jO-S6lGzH0K6zIzXo,4518 +asyncpg/pgproto/buffer.pyx,sha256=0GRpd2zqAR3WcHOl8f2LtIGJrap_bFDiHvYZN6nWYGE,26127 +asyncpg/pgproto/codecs/__init__.pxd,sha256=MTQ7hYkJ2jdxsjGKquk6mNvfdepjFAhujOIcWA3vnkc,6170 +asyncpg/pgproto/codecs/bits.pyx,sha256=IBXVWM2NdWF--d54yvBfSdvFhxV_TQxB97d20dTFxRY,1522 +asyncpg/pgproto/codecs/bytea.pyx,sha256=4AVKSfhi25DR4N9XCm13O1ahWohGnd2wNwr-lW9jfsg,1031 +asyncpg/pgproto/codecs/context.pyx,sha256=gpE_ncSaAOi-sIC7ltC3K7E5yLokK_GP4Ekq9v4q2YM,649 +asyncpg/pgproto/codecs/datetime.pyx,sha256=aWVNKozk_YcsVAClaV6rc1eiuy3khx5lnwKnbZ-Bq3w,13254 +asyncpg/pgproto/codecs/float.pyx,sha256=XNUeYQKGBpyM6ySDD0L3W2Jg0cqvV5fh5Xf8y4r5ido,1065 +asyncpg/pgproto/codecs/geometry.pyx,sha256=A2raDcmGNftGi-EdsrB7CsZgk5BA3sp1RATh9bl0nwk,4829 +asyncpg/pgproto/codecs/hstore.pyx,sha256=Dx_IkFLLr9fN8cX8lThv-kXtC82itVzwZmwc-RgRKfw,2091 +asyncpg/pgproto/codecs/int.pyx,sha256=0lI3Elu--UmsZh5yzhkbAEQb3z0hnCAYb8M1llfI4gU,4670 +asyncpg/pgproto/codecs/json.pyx,sha256=q8OAGbUET_Mg8YEQXN08oOVp5ZgrPrIwl_5Up0rJMks,1511 +asyncpg/pgproto/codecs/jsonpath.pyx,sha256=z8OWN8Ls0S3-WoliBTGcE3OiLQFAAaIQ3fmFvH0Ut6I,862 +asyncpg/pgproto/codecs/misc.pyx,sha256=0v8FW97oI20zgvvricyatNsGHtNt86qy-RwDpZmWl4Q,500 +asyncpg/pgproto/codecs/network.pyx,sha256=144a6aVIDaVVk1hc0B0nSOUbt4c1pLkVDgrpGOI66fw,4056 +asyncpg/pgproto/codecs/numeric.pyx,sha256=MHDUUiUkZ6GS38snxQsPlkKGP2RcwyarWlhC72QAiwk,10729 +asyncpg/pgproto/codecs/pg_snapshot.pyx,sha256=xFPvsDqm2vmAu7LzWo3YpINZnK4qId9Bjw_EWZGx4go,1877 +asyncpg/pgproto/codecs/text.pyx,sha256=X28sw55ugCDuV81bE9A33rGNNNToUOI1mPnVViZbIcM,1564 +asyncpg/pgproto/codecs/tid.pyx,sha256=IJV_dQb0RZTIv16oXZLsZBG--9hP3yeIP2KyNzRw9Dg,1600 +asyncpg/pgproto/codecs/uuid.pyx,sha256=Qy-ctKASB6dEwxDeSjaKCtL7hBTWSPkjLh2SbesJDmI,882 +asyncpg/pgproto/consts.pxi,sha256=4znDppgjfgK1Jt-vrC-9ybK-wLhS2ZXHUu2iSanuAOI,387 +asyncpg/pgproto/cpythonx.pxd,sha256=Q0R3NqDfX3hMKYCv2EHRSAzBH2oQGQMCbJGivsPGHeQ,759 +asyncpg/pgproto/debug.pxd,sha256=8I8LhCtxx0ItNinKMUmC3TrwVpkuvYDDhP4OVse12ns,273 +asyncpg/pgproto/frb.pxd,sha256=qMMzdrR-_u9jZ42Jn5YBU1fKkczNtTbFGNLobi3lX7Y,1260 +asyncpg/pgproto/frb.pyx,sha256=7ARAMMP0nMQpkLCpKfAIl57vswVYNkRRQ3vEZ_f9xBA,421 +asyncpg/pgproto/hton.pxd,sha256=rt7WLZasAJplt3o1MYsIQlfTZGbecpgdLoQxOcJD-_Q,977 +asyncpg/pgproto/pgproto.cp311-win_amd64.pyd,sha256=o_mUBs4ryMsWy2f2SEYnKM76fCbXD5xrYohv8vMwyjY,239104 +asyncpg/pgproto/pgproto.pxd,sha256=vfSBam43bOQKliL0fGdt8608D_pBXXb-idnSuT6orUY,449 +asyncpg/pgproto/pgproto.pyx,sha256=bjCy8iIZj7IFj0BRegv87xpoYQkzrFvPFEyowko8nlg,1298 +asyncpg/pgproto/tohex.pxd,sha256=KhhZRaf-jl0jzOk_-XSBrd0asszmVFZ1CHaeCVE-unU,371 +asyncpg/pgproto/types.py,sha256=puk8hs92bhWBYxrdwWl_8p5y-e12bB4zoI8SlFoSkG4,13437 +asyncpg/pgproto/uuid.pyx,sha256=JtX2FXlWknQ1GbRIg0m8D7XVeISWK6dRFlCpe58QnIo,10296 +asyncpg/pool.py,sha256=wb_cIXYcbql1WyRrKf9wQppDACKypRHunntJ58Mp_i0,39298 +asyncpg/prepared_stmt.py,sha256=MkwHPt_uvNiLxpC3TJ7irGBaTcqRc7NdM3Mgme4JZv8,9251 +asyncpg/protocol/__init__.py,sha256=adVXDmUi0IYdAfRnqYXGP4o0Uyjv2DJfr8FrXRlT5eY,313 +asyncpg/protocol/__pycache__/__init__.cpython-311.pyc,, +asyncpg/protocol/codecs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +asyncpg/protocol/codecs/__pycache__/__init__.cpython-311.pyc,, +asyncpg/protocol/codecs/array.pyx,sha256=OIkcbecdoh84ZPfT26nElg_yZp3EsCH8vkwuVMhycBg,30361 +asyncpg/protocol/codecs/base.pxd,sha256=FfPKRR1cKpJmTlm6kmjjcto8Zsdf2qb8r-0KbNNH_zs,6411 +asyncpg/protocol/codecs/base.pyx,sha256=qC6xr2IrW1IF5rBN0BwCV4gTtbbIIWpgWBXOeL0Rdpg,34370 +asyncpg/protocol/codecs/pgproto.pyx,sha256=vKWJ76Ht6bERXi-8gZAjiKOkZ29wJFpDcVt6or9SQO8,17659 +asyncpg/protocol/codecs/range.pyx,sha256=q7AprJMdRbF5R0hNLXQz42y1CSYiL2z51DHmPCX95Eo,6566 +asyncpg/protocol/codecs/record.pyx,sha256=RzE8ypCFSPiH4pJdEX6178UEd5TStpG3lwd0SEILhfI,2433 +asyncpg/protocol/codecs/textutils.pyx,sha256=O3QiS3R1_IDLT5U29cq3Nb_fLUoP-evX4ff93dW8Wrk,2110 +asyncpg/protocol/consts.pxi,sha256=wyf2ctwkBArBS20kiKZ9MuwEdHIORbjaWUmLAGT5grg,393 +asyncpg/protocol/coreproto.pxd,sha256=okdrg49H-NRRKMStnOkYWIHN3zGs48CvkWuOW9cEdbA,6344 +asyncpg/protocol/coreproto.pyx,sha256=HeyAdUbdED8j49rGTy-yT5v_if2FHKy_aRWGkMWXIRE,39168 +asyncpg/protocol/cpythonx.pxd,sha256=N0sNOn2zYq9LdVpCbk5l-UQEXZKJxlgTBEvuJRIia4E,632 +asyncpg/protocol/encodings.pyx,sha256=lq0YrGqKOS3S4bnfecDP4ReJwmpJFkoJDCWxdGa-QaM,1707 +asyncpg/protocol/pgtypes.pxi,sha256=WMJQUjwky0BRGoz1Uv-s55Sn9cn3fp_z-2s7ySErxCc,7190 +asyncpg/protocol/prepared_stmt.pxd,sha256=c1-Vj-6INV0c9EOjHn1H03dEah1lJ4zJWXa-G0WkGs8,1154 +asyncpg/protocol/prepared_stmt.pyx,sha256=glCnWmSowDGXqiM573IyHnw9X_LBAnMCp6ydPWkgqIw,13447 +asyncpg/protocol/protocol.cp311-win_amd64.pyd,sha256=MOse7WMZr15ZUe7jwNwQzbqKgNv9bblbz105XKi3KLc,639488 +asyncpg/protocol/protocol.pxd,sha256=ZCIKkZTttNMDbxjsu-M7Rw5P4hDV81fytK3i4AGvx10,2028 +asyncpg/protocol/protocol.pyx,sha256=4TDT0Ohedy4MHMpqCYSX4bGwJDKdvbX_j6D-hK3hnl8,35888 +asyncpg/protocol/record/__init__.pxd,sha256=CGH59K2pPrr6UG1ozslFIhC4NCzvxIOMzrVmkD-z21E,514 +asyncpg/protocol/scram.pxd,sha256=WHz6b-CFCPI3rePwxK096bZQR0mvI1iYprQ-ZuhrWdk,1330 +asyncpg/protocol/scram.pyx,sha256=PFqtLizBPPKKspPkI28djXT61mNmwbMSTCdPjweY3S8,14935 +asyncpg/protocol/settings.pxd,sha256=BPoU8ejCK8f6r0HoKnxNGRfN9zg6v2F46ZoxRpTUskw,1096 +asyncpg/protocol/settings.pyx,sha256=wZGBjkRir__BPFCwT-itJUmi2u6CgzShF3WKJog9Ovs,3901 +asyncpg/serverversion.py,sha256=WpWvDakphms881RaToOyHKAVS6wxaJMQfzetXJJsLnM,1850 +asyncpg/transaction.py,sha256=pXOb_B9gESb7M6jEumeSZvaQEoSF11_R9fNF820EtdQ,8743 +asyncpg/types.py,sha256=eVh6rdPWpcMWauLRMRUEuWniEVAMAbaniDucwcBwQkk,4830 +asyncpg/utils.py,sha256=38wIII-s9AOC-2cPFz6rX0hnEHNtSMSNdih-Mti2cyc,1412 diff --git a/env/Lib/site-packages/asyncpg-0.29.0.dist-info/REQUESTED b/env/Lib/site-packages/asyncpg-0.29.0.dist-info/REQUESTED new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/asyncpg-0.29.0.dist-info/WHEEL b/env/Lib/site-packages/asyncpg-0.29.0.dist-info/WHEEL new file mode 100644 index 0000000..6d16045 --- /dev/null +++ b/env/Lib/site-packages/asyncpg-0.29.0.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.41.2) +Root-Is-Purelib: false +Tag: cp311-cp311-win_amd64 + diff --git a/env/Lib/site-packages/asyncpg-0.29.0.dist-info/top_level.txt b/env/Lib/site-packages/asyncpg-0.29.0.dist-info/top_level.txt new file mode 100644 index 0000000..5789edd --- /dev/null +++ b/env/Lib/site-packages/asyncpg-0.29.0.dist-info/top_level.txt @@ -0,0 +1 @@ +asyncpg diff --git a/env/Lib/site-packages/asyncpg/__init__.py b/env/Lib/site-packages/asyncpg/__init__.py new file mode 100644 index 0000000..e8cd11e --- /dev/null +++ b/env/Lib/site-packages/asyncpg/__init__.py @@ -0,0 +1,19 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +from .connection import connect, Connection # NOQA +from .exceptions import * # NOQA +from .pool import create_pool, Pool # NOQA +from .protocol import Record # NOQA +from .types import * # NOQA + + +from ._version import __version__ # NOQA + + +__all__ = ('connect', 'create_pool', 'Pool', 'Record', 'Connection') +__all__ += exceptions.__all__ # NOQA diff --git a/env/Lib/site-packages/asyncpg/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/asyncpg/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..66524bb787e6b84b1d6891d84272ab53e968e15c GIT binary patch literal 599 zcmZutJ!{-R5S`Vxr8@}Wnt-oJQYmqg-k3CYQUzmTLqG@?Sy~_Rt+ZmbHn~(TUAaw> z9}w~b@-I@zkV0(h%H4rGSD8KEkpz48@n+}E*RtP-!w}GZe*1Ow-U7HX!OAdR*v%2T zuTVfiI8-Ddm6ce;#1^*?jJLT{xrtkOiMP-l?pHw)ENj*lH7*aUD2Y(>k^vhq`*^UN z4_}4=$)ND}Ar7tysE~ThrqR9))MY&{|Vzd#0YiAD`Gu}s*3t8YT zqV$x>78@vyU1{S$=^6431%@1?-FT?O( z(yp2{tkuD4qg*qpPie+Er9a>XL%7}9*-SqPIZd}kQPz`mdLlC=Bs~-=W%X(Lp*&36 zQn6P}mQS+@YtyWq)p;{{Lupx;iqhB3>^9h{L~+8|TRFm^=AYUNq`6H9nLh%u(ZS36 z=;2AXLJ!ZohtR`%_dj|Vbt}w0AkR8@`Y%w6-jOrE2mgHYcQn3)@tJRqe2h=}1Nhma A6951J literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/asyncpg/__pycache__/_asyncio_compat.cpython-311.pyc b/env/Lib/site-packages/asyncpg/__pycache__/_asyncio_compat.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7286cb9175f02008507e2346530044a05674859e GIT binary patch literal 3065 zcmb7G?Q0xG7@vK~-QIg%`j%>%Z7-p@Qd3HcmNZpNYC$Ub&_qi^;N09!l1(j`r$4drnrukf|T&d1QWk5r^`IvRJs+&Jg({5X&KS;3p4@^em; z1mUlsi}Nkx0S*}fheIx>ieI7epxOddQUgFkDmRK!!RKt|NQ!^Xq&<%SNpW`2(&n+5 zvofABY)}B|3e=qk970zS2gVh+FTO2spdNYfdGCge1z@`--sLvG2Q!;nM9T+627x79@B$J zY>Bs`9*IxiW|abLotRb+s>5Gx>ej#ypFZMr(R? zte*D8v2I1D5F*DW_}4tuF^}f5;54(2g}PC>Yk4g&ioBrcISh7C3oEMYt~H}rUO$T+ zi=nS%YzEX%<%|q-#4)A5ZvBp@BZO_1lw=1Lx@crH(~e<-!WyTioTau!)ikgja2LgH zO}o~mA);yKwjCe#9CJcyM;ildM`~Lkow07F1X}>1gq;anz&A6LohaBKFRxx6n7D3| zxrt#@g?%d7(BX`e|Y@I!dhV~ey|)*t`C>uedT!Hs<0i2 z-@S1A!mWWj169O@tlt`8nNf_GFxern~cw}|4{(!7q)Ba+j z{@$m&eW=`P2y^2dpxCx+!Gul+m0Bmbe19pM(Lh90cjLGAnv5%gMGbSKyn0bxDAPz*5_; zQV^P9yOul}G}Naw+si>pXoPg&(YjP0U2pBy!C*W2KgN3rC&hm<=pJAPdQQRlJOzN^ zfxHi%4#MROOVb$;dT>wsM^YieT(euJv6Ut{!+`Uf)=e{O$1(&fmX9ML2Zl^jr*<%_ z5KB{ZJCP<>#|p&`lwe}FDXN-gfCDh2>yvQW?SKn7_5p(D%>~^2Hzg95F>TS&7+_X{ z6h1Ra*(w6G$fOM#gk4Y^av2(wh24b%IC9aBawJ)b^p+#N%a<#$w#``gMy$IOJ6?_* zU%s*xYA=V5{`}6vE2Yr6a_HRhP(=)Gik%x`=h}&q*i{z0iegt)47BuCq{!Xy?eMMW zo#<+`8bFDItI()F+frmxk~buIy}cy$l%<}c_r6#a_WA>7in9B{0B`QWWnE=00P%4v<~0hrFoap!!WM#bomq1S1w#|89<{>O>uD5BkZPE zE_yG+FxeTi12a)7?Cdad2->zl7pWaxz=T3VOKZjySjB|r7iGsd=ci=mrN?BK7A2PC7sV&#m&ByzmBsjE zCdCwImZa(yBqnDkrl%IiBob`D$-Fif literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/asyncpg/__pycache__/cluster.cpython-311.pyc b/env/Lib/site-packages/asyncpg/__pycache__/cluster.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..430582158ebf064f8ff3f7823980555d75429a8d GIT binary patch literal 35040 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/asyncpg/__pycache__/compat.cpython-311.pyc b/env/Lib/site-packages/asyncpg/__pycache__/compat.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ed111d88621fcccbb70e7c4060680c52ea71d502 GIT binary patch literal 2245 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

        rx2O=@$0v`db5%o3~^H+a1# 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/asyncpg/__pycache__/connection.cpython-311.pyc b/env/Lib/site-packages/asyncpg/__pycache__/connection.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..107605dede7905df699ef36a5004205770436ff9 GIT binary patch literal 109731 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

        DmVeb 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 gDtA9zhB-i26k87Ve6de?rs#H*8N8ZU6uP literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/asyncpg/__pycache__/connresource.cpython-311.pyc b/env/Lib/site-packages/asyncpg/__pycache__/connresource.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ccccb4c433a533462567a079adc38b80846318fb GIT binary patch literal 2243 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/asyncpg/__pycache__/introspection.cpython-311.pyc b/env/Lib/site-packages/asyncpg/__pycache__/introspection.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d1f763e40193e6cb88ecdca07e2cd0eba56fe0d1 GIT binary patch literal 8174 zcmeGhU2oe|)Nb4^P14bBY}y7Iw^~sfXv11~s_3MyNi}boGbJfgLs8_!Zm^ozk?l@& zfK(7apic~mmpy?dc;z4P$U{Lzn({P>KM<)8NPFU(YdiLhoq`4%2*pyIdwo9cx##Pi zV}Cm_k>KF^;p?Bar)N0sH=KA^%pDwm34;fm!c{nhf5>~_;J?a!Kk^MgzUx6NBTB3i z8;BnZ;R}jT8C6CrW6D_NlyXXqZ;vSPFNDgtJ06E|!W}1IoK%t}E}fG1VFLuNxdh(v zD&_LIwQ_HYkL--0DL5E#t(FKN%ri8)mC>!XF1OTZBB0SNmc-83dnZs3BmsUAL_jxS z86?`#^giL{)>cb7a`#3~g1rGTrC%Yl$}B0vLuMl={@h)$e1jBoYa7Lq_+E}6eoeMi zYYz8K6t!)Cn8u}iH3oMbq0%7OUP2j=AC-fGfLBPRL7J<hvpdh=Jp~@g{l0}pfuYW>8 ztoJ#5oqNwIh+T_R!ij1Gd0j11bw)D4El62Zc+g*_SIE_V^t2ns=tR`?zRQwAF`Fxr z>zj_VkZi8BM)Klqu}l`zA@k(&5Gc|H7%sTgoRm!m=lx?)wCB#OzG$?mO|{ie;m&~& zp{Poh5T8~lwW2n)Fu6-efh?sd>kSo1O}%05)~K5^ivy*D;zC*KL7AdHC{vu^%Cc$7 zdsVs7nA7BpY}+6USf^(W=b^saN;A4fVFv~;1THW#wc4(&5={;fBC#k*VDFm+QNlQ{ zH)YEr^+-&_hA?%-GeOZ9)^&8uuuOx!xwjE=ja;Q3D;3Hh9qw7P6w_$8RV7jY^zM2F z7N%x$GfLPg$uoN;DhqhShWgH)=V@m=w3e4`^&@*|Y;-aAdLhO}-CI3h3&jxzglx-A zqml8>K*$Gnj{rsOiyt4I@@~s@6)G7THw+n)LJ{O9b+5Fs5T6aEd~Utm3s36!PO^(; zNpoOR)gdq!7BRR&i~2bhPli81S)utB(j&;pa5_Oonl9a>2`&u@gQ3KYI~C)KhlI(O zW;+JaSt6Z~HwBK1sIWAB+o;;6syh5Z!g;J2og&bw>ilEIKR4(oa1gNBodi<=olrA+ zMO*^R?=07s$ZZW(G*93kWxzkIMR7puOB{sHJb2hU&kzGAj%YYzCF|)1AdHai+?CTg z>lsh}7`+Cy^(mG(wnjOz`5AaPo+#^kb2E#}%P@QY12?tyRcHUzo!how($OsrQi84d zhq$L2>PW)!HyvWcc*I~< zz=pvL@$o$IL>3-WIsty*7@cIrQdyMT{_hP(jUL|evZ-PidxshLng^=VV4z0vG#P>I zfdbgfHX=wEIHgPUtj?G=;nh)82&eSN(l+sk@5DV!c|JL8cZcn+chnEtT|BEJE?+@@ zBJD@Rn8NV4hV5=35wiO7OR;|KIddTNaw1EJPoJ&bT`R2SA?@YDHJOu2gN-n|CW_SB zZQ5EGkv97vER&5{>gU-&fvXK0WyXVENbdw{hbnQ{D1+wz|8GTTcR_0>bhKWL<$2w( zQU2E(WzQ7M`vRJgnY4X!L*Ad@>73@*p6ziRr=dtE?mr1MgS4r4vOasTg^n=_#sY!L z3}9@L{lfhuXZq`JTL!*d@w+=J2YNQVEt#QjOYoJ9_gxB}EhX-M_9Ax}6wT?!XBHFb z*fD%jZ@U!Ca65JkepTGyji!gF7+Z(|DJ zt({#{whgmdGwdx@zqggwYFn0Os|)a6Ye#OV)|PDT>GgKwElsyg!)mK_TQl@bd#`g^ zv#M5IZptS8*kn$?0vBKv>vb6Hb5G)v2j`FC7k+(p;V{0?<@oXG$ElYODn}`D7$@D) z*yz|XAacX{bz`DLj`*kws>G-9cUy+C+f=Wam*E+@kM$$mx-p*T zyOTHhNntX@ZZ!G%`aynw{bynNNSN*xc#c2cE%OC_Lf9YgDkHP!eKZl# zE*}Y(DcV^;OHgK)#$OWllif?)x!FT*syim|V-JNc2Y>yy(>yiiGeUTO;f literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/asyncpg/__pycache__/pool.cpython-311.pyc b/env/Lib/site-packages/asyncpg/__pycache__/pool.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..46ee53cec05cf1adc5a66f88b2ede86e0fe4607d GIT binary patch literal 47537 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 hw(Z8zpJYQ1cgLn|$L?I~##G0_^)3Me%Sy3 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/asyncpg/__pycache__/prepared_stmt.cpython-311.pyc b/env/Lib/site-packages/asyncpg/__pycache__/prepared_stmt.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..24ec027b0bd6825a6e3871a54c1632b7305eab38 GIT binary patch literal 12355 zcmd5?TWl0rdOp=Rm)&i*Z-B2*U_-l&F<>sk^p4pvU}o82%q%#wGZvffa#z_jw7Wg0 zs=4%-#M(uniL8WO%`BEOQk*=HK|~Qs6lq@akUZpRAKF$&Zk03&(kfCmPfeI8Xr)N` z|5JB&+n7lrrCk2|RGmwm^Z(y}Ie*n(G&VL6IR5reel^qAPsp$F!aV#&;pN9rctj*3 zacMF|B#-1xb90_44~JzRl)Y14R`x^LH|67qhrCCmz&#?>$)4-xIOMUHkf-pkA5#H| zyF#M;Z}4*BHyqF?r-hQ)OoqxzHb;{(TnCals$?mY8sytad0tIrGfGk)L8m_B;^iwC z;yz4NCR3b5raTfi<&`{Bz5z3%W4QIyyiKO+YqSbf zwQ8u*s;;V4(AA2+M>aewp;b#&s}@(QR+vK@%%Q!iU8}2|KH83|R&6y}?UdVL6}zfdu|w*( zN2Yd4oj`XM z!G(y(5wbIaD8L=oP*BX4!%?pmh_g%h{WK@jJ6b5778RA<%qd9|Wyp4fF#f;%637?a zBcdXBjl<336-SNPf{+F7G2DM@)p2COyFlU|v&Di3uJ8%$Sn#empKjjXfF)2s0=+C{ zlgJhFgqw&4G{2IYm#N0bVZoVj`R zVru%Tl2YYE^J4ObI4dhxMdeN=IX`>Ylmqa1P92`VLlM;Zt|~bWn=@~RdgUCDSBvBu zzVSibQr$Y=vBq~ScdhdMCBDDN_m_8e7ko=W^M`Nz?ErIJ{-evRx1e5=g^V~SBfivYDWw*~ z8XAyacnl8`>rC3ZjGCXo(_=wdY>R~d{d^qM4j<&$V6@0QlcLLS;Sy_!^ zT`gvrb=}wrIl4$HA=2Ew^jRsqr^xT2yWn2!^)^F|d%bLxzjCZnm2a#1DrJFTLzv0Z zZLE3xwm3JRmSZuS4af?Vyf7+=x5Shx*ti=upfM1+GJbLV?4;0tG!{!`)JW9g5%vZs z%2Z{84CAudga)F*=%}#I-Ep7QFUm3KQ^p<#PwTA#^4--4v?}|Mt0A4Mt&FQhzN?z0 zsLBjNA6Bt+vCavoD=v7|HWzM_!bI|K4w0a4<`h#X@@+YpQ)LObIX5R}q+y%k-&F=@ zFOQE+jti4xXD*Hlb9Yp6S{M)o5Jz;QJeU}nHqXdv^4h@G;?gHRr_356b3Vr*Fb^|N zT0oMMSxK%ETqDZH8Y;i1w(zV5!zjRmx&YfrsJRsEDF*w?ZM#Zs{l!p!IowtX3+v&? zS~#*Aj+VmFA|KsCzQ?QNyImQIUjzCKF^YmDD@mGS;SEX>r^|ep0G!PF_nCyA2}jTGiUdQc1`Kr^68cACF*FGqkuXmI z9s>*sC?0ze1JS4rNYvpz;m4_T8Vn|Mh*?^y*9gJ@&U_%7l14|44KWit8i9t#BSXTC zR7M(&C`mCbQn*x-*W@{IG%`OMPl~FT&dx@nLsjDm_IM}E@o@gz8_$NbX`#b$_wuUH z+2pRz3$@{CGw2<}XNQi@-ORwOhX>cfgR9}8Qh2Dy5B=YO@$bN5Z3advr}gLwq6M0o z2J4~-1IcVUHQ2;)A$RX4kEGQ6u z$in%{mp%{xB5+f7^^8O|*fJBr%(2)De^dNgD;;n>t`BDl2hMCXVoWho1Fz5q=Q=uR z>cP>sP26JND%{q53VReIwX~#`n!L%h8E3aO_mPw4+(D!NSEjz1M%n_at&w*9W*TX? z_`so&!<%a4MAW145VkPKr`4&cIXRnCtvCw<0*t$H|M~J75cjUZjw>NJz_#pwvb_r+ z*R5Ru>=roOBiMHwn{0T(Q)`!t!GbvLbTotdhFX{rlMtof88qTIdFzlh#tf7o(pe=Y z{0R3)SkB=t3p|pEFQXM0XdI1kA|^~?Y@C~$mMQutn!N>%3~rh8fSm!`FAQ3vn4`IV zZ|P1#A5<8Su z`rRV8y`PX<+?&r*wX#5jT<6U>F8JNq1+W2r@lS0VfZC_;5-=k&pB7nK1n*i=r_-sw ziRK%)i3t~GKrJU}PEI7i13QNnm?lq~Q-F;MY*IGWee6ne8K$#rdMP!PR0OtfM%`!i z`X2nIn9j-0iCfVztdHrcoeY9J1?%c&!>|Cx3O4U-r0OX_4d{MOOsB#4VZbial$cKC zVF^FHa%n;Ub3dQ6Hpf?fbg_DfL}L8o4=;{gm`Eh-{h4X!^1Vi-FmV3T_!$@#a*hUHujf$PcBcEdJmO)Pd>{Pd(VBX0x`~A=Zfz0q3`+5jz>3sapUK6pU)MW z`)Z!A9!|fu$*Wh-J4cq=OP$eD=g6}Y#m;xXJ`Th<+ukj@&%(KX3AZifm-|=4d-Mbi zOE3KWuFf+-@(;nDGZ8POEYK;qtTDP8W{uB5LAS;WWChCA#{y)+A>#=4)lR;Hwey%3 z5^T5^Y=l<~gTTi1^uY$51r-J5!9*D#Kb=w-%1!@xnRznPA-bHYZaWl}>bW8_bif^# zr5sy@78@JA&ZRTWeXV2PYyqhZXiO%Fdu&rDDaK+GPdH78SAjhqpN1`H+(@`QF?={m zN>`&(P;$F)&Chf(zpHAjVOD|OML7w?P@8tLvul0Fz}k+1uiC%*^jTzeN366XRt#@E z3qD9&6oSluvl&Ay8qharZsg!V)-O*Cyb{b3!GgB zWckDxJa`+(vc!jGeI`W#XAmzsZTg!yBMd`zCd7mZ2vun+3DA(_+u(vANefN|oeKl6 znLN`cpk^)kn>cX%8hYRgL65*T*le=R=+j!O6@!`s)cOT~n#n?@b6!rSW>T^=1pdd4 zfN>%Ec-a|i9<_!^B#f+J+z5-o51Dbi=}r@gvsV5;k=SxLQ(=J3pgJ^%I|`??ObBmk(1203bq-&pzDDP^VXY0F zgGhUWo_V)p!C#|X|G%s?LdUWMknjipv(fLEDBK({bQHym8wZ4j9>wTk5tx@v;Q@93 zi2dFJ@?8va6+8+}x`k%W+}z}w@c0=#(%@WqV`Z~tHy3@=W=@1Yi&)<8ioI*7Z_L8nGL?eADdV4L@8$UK7qP$4A5 zxY`_zy^*knvxW0NwvR@dQJBbPWK1tWTn-8HYgtKRs*eXAJD>A_leh=o#{j;k2tam# zU_28V5Us@-Ld4;H%^eofM}3$}%BorLU%GK)Avyv_hweUT1+eNU+qUBB`61vI-9rMZeZaLk5!pX&Pa<5*wbnn30 zjsq1B*LVc9t2TMz_3S+QEdf#?p5`q{{ZZXio4N?kV`&biiyB;*rn*)d$sFtVe1EZHEec#ZzD3 zTJGGt+_5sS+Ig_ld9c`4b%qYU`X=023XfDsT|Mk8O;U!PW$V86){|?kCs$ifm0C{~ zLp9Dy18HnodVf9Cw-)MK4ec+5_7_9@VHaBo!$^Qo1wW>E*u0ng*;xJ9px5=W2r`u6 z2{EMG_WRz~T6YiFckhg^rhT^%a1|JO*LT-{H?ZJ;K;jkx7ktdXxNH|@hnVd;1BEYq zTi7n|2HOSk{R7`)SjJOa3OmrTOwe&CPl62#Ic=D3zWhw!%yL1NAvKp$b;H1H0%BGG z1EyOr`UAMkkJOUCbKGkC_3zM6IRM14Un6V1Bewm@eI-464{g{e+OSc>hQVvQ3(!OV z-lfiAtbPaY;_N8y+Oz;>!g7kn#g#g^1`C$3fZOEW_tkoT;BHZY5tJMdK#F0^%0mCT zaCA*Lil%H7P1)uI?AhMaV9)lR27A`MIe8E+_zE)*#Y%wm_Ob6=>`h_PY2lFnsERMs zK-`~u*rKNq)v_&4yCre8?bOCkn%p+=r|>}@!({&ZNil;v8Sq7E$GcGY{^zs11JM|B z)$>)~X9?ir4b$S+%}qeRq=-qa=|TqHBETCB!%77pw3!oCkT$watscVz_PvaPd@v(G z$jo1plQ-fJ8Dwg?BS-arLO10+kVR4shL^rq3ie_q>pb^OYfq{5AV{(0*gqe8`>#)a z9bG+ku5|3&3%{rBJO@$(3Sw&n>c#eYuWGM@@?bJip@5&1Z5CQ=}MR0;rFR| zK~|hnx9(PtfU?p3ftUU+w4+Txw02|t`1&FayUUc6Qty}^{wLUM2N1)k8@il;JNW}O zbXn)LYpDOi-Y0;7{+9WW@gY~|D&JS)`-*&@^?_Ia8sES2$tr)i#2+r2r_MslzvE7|% zIX;_YAG=k(l&k}9C#U1_S~*ptii1Tkeld0}1=snmH6Ffu>nZU)MZO1ESmHa@`N$d{ z`O5c~!Bzfvi9cR6PsXok4}JxR?~UVetsx$t%SyR4mcbc+3W;r_1}BqE!fp88Pf2H0 z_}-6wnny8`(duS%5M#@d=7pUi?SWf#H=^%lNVkR=rU_7R#V>Jy?hK_nEAVH zVmHOx?dGUK|KPGxA@E}pyD8r8GMhH}4^;>dyBhBZX7x_224Yv^og;d6d4IILtGnWD z^TUfglaz%6CE@snn|60>HfVG|2+?!|SMDNqTfBXlGa5%>A`Slb4a9DYbsgrwL(ilN zY4-2gKS}eV*vM zEpvCLtLSMu591*6mHR*{UXJ4`&4ddr2J!DX=_VO`+H^To Q>Uiq~tNeD8CTyYq4Jh{34*&oF literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/asyncpg/__pycache__/serverversion.cpython-311.pyc b/env/Lib/site-packages/asyncpg/__pycache__/serverversion.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cd7014b92af80b3764951095d8d669c6529a394e GIT binary patch literal 2030 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 On?9rbFJ971cjLcVPeNz_ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/asyncpg/__pycache__/utils.cpython-311.pyc b/env/Lib/site-packages/asyncpg/__pycache__/utils.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..31682ceefde8cbf60c377abbe2f045e0ce666f05 GIT binary patch literal 2570 zcmc&#-A@!(6u)<7c6XMY1t}=t2OYL3u2w7`0ZRe3Lai;qw3;@tYsj#7SO@pZnb}&F zUAu|2rG!+Q*g&j_Thl5On)1@5kNpGsz>-baPGVxx7kyhpn;0Hy&mEYBRqSi;?wot> z+;h%7_nhB3bI;M3K2wb5S>GW8AInVVSzG)1IiM7 z26=6dsCd60(`kL!VP@f3IST|V;55w7j|56@)+z`PhOl?Ri#f{^bQk323bJr2*B|FR zqe;&y_QV;FXO=PSLlHG3>4rmze4A-hO+}%{^&trYBR=l&xvXxSF%B=0&b~1*Fjb5T%CEWWy?M zh%*fhDr6c#TmGN`&5u4O!0YY1z|U95lpzxn3{ro9Jr)C?AR=m zv?sVUR}k665L=oC`njRIH(r4yhqWs9rAW$Ny!T&4fzjlrS6E^nLwdPo8KDG69P@m! zUJojcTGGKlW`=3T%t4%6`%g;JX4A0btU2K*_Hy1;ybj<5a|geVz5+mOBXFfV_;DJZ~Jbn5!ZW~QDjwYWgz6v;Vi4$(hyqh_*%ABsE=9^|<>?Z(r|;v*M^f64a7$=2a2)IJ$^Cef9f& z9RdZd4#<-fN;`jgWk&ir@MB;> znjM}Wo;^H&_}Al^16^6MJB7?}dEJI13ZE89m5tJXtPcPug=FZKn!$yEGk7^nw9ATq z!LUowC@jpJo1Y2jxc&=rNHUyq7~l#Y9uOarb^ir5a@pX9BTCp{z%Z-D2E9%i_Hfv+ znQ%5ZfVgHbQOzhZkJLw^vZn3;#|>MQ9<1&JUVWKfhn6s4${fem8ar=AKy8Liig;}V zvh?I3dPp(EqivPf5)+B(-b|S%Tjp7GKKoC-nJceIy_0j7ExT)%+_f3En01SJ(>w-oP?Cb!}31?d5 z0bi2mtrECjU6($vaD1`4EmPf=t!~S+umf7c5zrEjqm^k$SWWvOT`KdLNGrNW~3&WuZi3R0uwG||3U1@zlz%PvR h+Yl~EIq5HN$G8P7TZG5Bl`hu_zZ27gx2C2m{{m`JEU^Fp literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/asyncpg/_asyncio_compat.py b/env/Lib/site-packages/asyncpg/_asyncio_compat.py new file mode 100644 index 0000000..ad7dfd8 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/_asyncio_compat.py @@ -0,0 +1,87 @@ +# Backports from Python/Lib/asyncio for older Pythons +# +# Copyright (c) 2001-2023 Python Software Foundation; All Rights Reserved +# +# SPDX-License-Identifier: PSF-2.0 + + +import asyncio +import functools +import sys + +if sys.version_info < (3, 11): + from async_timeout import timeout as timeout_ctx +else: + from asyncio import timeout as timeout_ctx + + +async def wait_for(fut, timeout): + """Wait for the single Future or coroutine to complete, with timeout. + + Coroutine will be wrapped in Task. + + Returns result of the Future or coroutine. When a timeout occurs, + it cancels the task and raises TimeoutError. To avoid the task + cancellation, wrap it in shield(). + + If the wait is cancelled, the task is also cancelled. + + If the task supresses the cancellation and returns a value instead, + that value is returned. + + This function is a coroutine. + """ + # The special case for timeout <= 0 is for the following case: + # + # async def test_waitfor(): + # func_started = False + # + # async def func(): + # nonlocal func_started + # func_started = True + # + # try: + # await asyncio.wait_for(func(), 0) + # except asyncio.TimeoutError: + # assert not func_started + # else: + # assert False + # + # asyncio.run(test_waitfor()) + + if timeout is not None and timeout <= 0: + fut = asyncio.ensure_future(fut) + + if fut.done(): + return fut.result() + + await _cancel_and_wait(fut) + try: + return fut.result() + except asyncio.CancelledError as exc: + raise TimeoutError from exc + + async with timeout_ctx(timeout): + return await fut + + +async def _cancel_and_wait(fut): + """Cancel the *fut* future or task and wait until it completes.""" + + loop = asyncio.get_running_loop() + waiter = loop.create_future() + cb = functools.partial(_release_waiter, waiter) + fut.add_done_callback(cb) + + try: + fut.cancel() + # We cannot wait on *fut* directly to make + # sure _cancel_and_wait itself is reliably cancellable. + await waiter + finally: + fut.remove_done_callback(cb) + + +def _release_waiter(waiter, *args): + if not waiter.done(): + waiter.set_result(None) diff --git a/env/Lib/site-packages/asyncpg/_testbase/__init__.py b/env/Lib/site-packages/asyncpg/_testbase/__init__.py new file mode 100644 index 0000000..7aca834 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/_testbase/__init__.py @@ -0,0 +1,527 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import asyncio +import atexit +import contextlib +import functools +import inspect +import logging +import os +import re +import textwrap +import time +import traceback +import unittest + + +import asyncpg +from asyncpg import cluster as pg_cluster +from asyncpg import connection as pg_connection +from asyncpg import pool as pg_pool + +from . import fuzzer + + +@contextlib.contextmanager +def silence_asyncio_long_exec_warning(): + def flt(log_record): + msg = log_record.getMessage() + return not msg.startswith('Executing ') + + logger = logging.getLogger('asyncio') + logger.addFilter(flt) + try: + yield + finally: + logger.removeFilter(flt) + + +def with_timeout(timeout): + def wrap(func): + func.__timeout__ = timeout + return func + + return wrap + + +class TestCaseMeta(type(unittest.TestCase)): + TEST_TIMEOUT = None + + @staticmethod + def _iter_methods(bases, ns): + for base in bases: + for methname in dir(base): + if not methname.startswith('test_'): + continue + + meth = getattr(base, methname) + if not inspect.iscoroutinefunction(meth): + continue + + yield methname, meth + + for methname, meth in ns.items(): + if not methname.startswith('test_'): + continue + + if not inspect.iscoroutinefunction(meth): + continue + + yield methname, meth + + def __new__(mcls, name, bases, ns): + for methname, meth in mcls._iter_methods(bases, ns): + @functools.wraps(meth) + def wrapper(self, *args, __meth__=meth, **kwargs): + coro = __meth__(self, *args, **kwargs) + timeout = getattr(__meth__, '__timeout__', mcls.TEST_TIMEOUT) + if timeout: + coro = asyncio.wait_for(coro, timeout) + try: + self.loop.run_until_complete(coro) + except asyncio.TimeoutError: + raise self.failureException( + 'test timed out after {} seconds'.format( + timeout)) from None + else: + self.loop.run_until_complete(coro) + ns[methname] = wrapper + + return super().__new__(mcls, name, bases, ns) + + +class TestCase(unittest.TestCase, metaclass=TestCaseMeta): + + @classmethod + def setUpClass(cls): + if os.environ.get('USE_UVLOOP'): + import uvloop + asyncio.set_event_loop_policy(uvloop.EventLoopPolicy()) + + loop = asyncio.new_event_loop() + asyncio.set_event_loop(None) + cls.loop = loop + + @classmethod + def tearDownClass(cls): + cls.loop.close() + asyncio.set_event_loop(None) + + def setUp(self): + self.loop.set_exception_handler(self.loop_exception_handler) + self.__unhandled_exceptions = [] + + def tearDown(self): + if self.__unhandled_exceptions: + formatted = [] + + for i, context in enumerate(self.__unhandled_exceptions): + formatted.append(self._format_loop_exception(context, i + 1)) + + self.fail( + 'unexpected exceptions in asynchronous code:\n' + + '\n'.join(formatted)) + + @contextlib.contextmanager + def assertRunUnder(self, delta): + st = time.monotonic() + try: + yield + finally: + elapsed = time.monotonic() - st + if elapsed > delta: + raise AssertionError( + 'running block took {:0.3f}s which is longer ' + 'than the expected maximum of {:0.3f}s'.format( + elapsed, delta)) + + @contextlib.contextmanager + def assertLoopErrorHandlerCalled(self, msg_re: str): + contexts = [] + + def handler(loop, ctx): + contexts.append(ctx) + + old_handler = self.loop.get_exception_handler() + self.loop.set_exception_handler(handler) + try: + yield + + for ctx in contexts: + msg = ctx.get('message') + if msg and re.search(msg_re, msg): + return + + raise AssertionError( + 'no message matching {!r} was logged with ' + 'loop.call_exception_handler()'.format(msg_re)) + + finally: + self.loop.set_exception_handler(old_handler) + + def loop_exception_handler(self, loop, context): + self.__unhandled_exceptions.append(context) + loop.default_exception_handler(context) + + def _format_loop_exception(self, context, n): + message = context.get('message', 'Unhandled exception in event loop') + exception = context.get('exception') + if exception is not None: + exc_info = (type(exception), exception, exception.__traceback__) + else: + exc_info = None + + lines = [] + for key in sorted(context): + if key in {'message', 'exception'}: + continue + value = context[key] + if key == 'source_traceback': + tb = ''.join(traceback.format_list(value)) + value = 'Object created at (most recent call last):\n' + value += tb.rstrip() + else: + try: + value = repr(value) + except Exception as ex: + value = ('Exception in __repr__ {!r}; ' + 'value type: {!r}'.format(ex, type(value))) + lines.append('[{}]: {}\n\n'.format(key, value)) + + if exc_info is not None: + lines.append('[exception]:\n') + formatted_exc = textwrap.indent( + ''.join(traceback.format_exception(*exc_info)), ' ') + lines.append(formatted_exc) + + details = textwrap.indent(''.join(lines), ' ') + return '{:02d}. {}:\n{}\n'.format(n, message, details) + + +_default_cluster = None + + +def _init_cluster(ClusterCls, cluster_kwargs, initdb_options=None): + cluster = ClusterCls(**cluster_kwargs) + cluster.init(**(initdb_options or {})) + cluster.trust_local_connections() + atexit.register(_shutdown_cluster, cluster) + return cluster + + +def _start_cluster(ClusterCls, cluster_kwargs, server_settings, + initdb_options=None): + cluster = _init_cluster(ClusterCls, cluster_kwargs, initdb_options) + cluster.start(port='dynamic', server_settings=server_settings) + return cluster + + +def _get_initdb_options(initdb_options=None): + if not initdb_options: + initdb_options = {} + else: + initdb_options = dict(initdb_options) + + # Make the default superuser name stable. + if 'username' not in initdb_options: + initdb_options['username'] = 'postgres' + + return initdb_options + + +def _init_default_cluster(initdb_options=None): + global _default_cluster + + if _default_cluster is None: + pg_host = os.environ.get('PGHOST') + if pg_host: + # Using existing cluster, assuming it is initialized and running + _default_cluster = pg_cluster.RunningCluster() + else: + _default_cluster = _init_cluster( + pg_cluster.TempCluster, cluster_kwargs={}, + initdb_options=_get_initdb_options(initdb_options)) + + return _default_cluster + + +def _shutdown_cluster(cluster): + if cluster.get_status() == 'running': + cluster.stop() + if cluster.get_status() != 'not-initialized': + cluster.destroy() + + +def create_pool(dsn=None, *, + min_size=10, + max_size=10, + max_queries=50000, + max_inactive_connection_lifetime=60.0, + setup=None, + init=None, + loop=None, + pool_class=pg_pool.Pool, + connection_class=pg_connection.Connection, + record_class=asyncpg.Record, + **connect_kwargs): + return pool_class( + dsn, + min_size=min_size, max_size=max_size, + max_queries=max_queries, loop=loop, setup=setup, init=init, + max_inactive_connection_lifetime=max_inactive_connection_lifetime, + connection_class=connection_class, + record_class=record_class, + **connect_kwargs) + + +class ClusterTestCase(TestCase): + @classmethod + def get_server_settings(cls): + settings = { + 'log_connections': 'on' + } + + if cls.cluster.get_pg_version() >= (11, 0): + # JITting messes up timing tests, and + # is not essential for testing. + settings['jit'] = 'off' + + return settings + + @classmethod + def new_cluster(cls, ClusterCls, *, cluster_kwargs={}, initdb_options={}): + cluster = _init_cluster(ClusterCls, cluster_kwargs, + _get_initdb_options(initdb_options)) + cls._clusters.append(cluster) + return cluster + + @classmethod + def start_cluster(cls, cluster, *, server_settings={}): + cluster.start(port='dynamic', server_settings=server_settings) + + @classmethod + def setup_cluster(cls): + cls.cluster = _init_default_cluster() + + if cls.cluster.get_status() != 'running': + cls.cluster.start( + port='dynamic', server_settings=cls.get_server_settings()) + + @classmethod + def setUpClass(cls): + super().setUpClass() + cls._clusters = [] + cls.setup_cluster() + + @classmethod + def tearDownClass(cls): + super().tearDownClass() + for cluster in cls._clusters: + if cluster is not _default_cluster: + cluster.stop() + cluster.destroy() + cls._clusters = [] + + @classmethod + def get_connection_spec(cls, kwargs={}): + conn_spec = cls.cluster.get_connection_spec() + if kwargs.get('dsn'): + conn_spec.pop('host') + conn_spec.update(kwargs) + if not os.environ.get('PGHOST') and not kwargs.get('dsn'): + if 'database' not in conn_spec: + conn_spec['database'] = 'postgres' + if 'user' not in conn_spec: + conn_spec['user'] = 'postgres' + return conn_spec + + @classmethod + def connect(cls, **kwargs): + conn_spec = cls.get_connection_spec(kwargs) + return pg_connection.connect(**conn_spec, loop=cls.loop) + + def setUp(self): + super().setUp() + self._pools = [] + + def tearDown(self): + super().tearDown() + for pool in self._pools: + pool.terminate() + self._pools = [] + + def create_pool(self, pool_class=pg_pool.Pool, + connection_class=pg_connection.Connection, **kwargs): + conn_spec = self.get_connection_spec(kwargs) + pool = create_pool(loop=self.loop, pool_class=pool_class, + connection_class=connection_class, **conn_spec) + self._pools.append(pool) + return pool + + +class ProxiedClusterTestCase(ClusterTestCase): + @classmethod + def get_server_settings(cls): + settings = dict(super().get_server_settings()) + settings['listen_addresses'] = '127.0.0.1' + return settings + + @classmethod + def get_proxy_settings(cls): + return {'fuzzing-mode': None} + + @classmethod + def setUpClass(cls): + super().setUpClass() + conn_spec = cls.cluster.get_connection_spec() + host = conn_spec.get('host') + if not host: + host = '127.0.0.1' + elif host.startswith('/'): + host = '127.0.0.1' + cls.proxy = fuzzer.TCPFuzzingProxy( + backend_host=host, + backend_port=conn_spec['port'], + ) + cls.proxy.start() + + @classmethod + def tearDownClass(cls): + cls.proxy.stop() + super().tearDownClass() + + @classmethod + def get_connection_spec(cls, kwargs): + conn_spec = super().get_connection_spec(kwargs) + conn_spec['host'] = cls.proxy.listening_addr + conn_spec['port'] = cls.proxy.listening_port + return conn_spec + + def tearDown(self): + self.proxy.reset() + super().tearDown() + + +def with_connection_options(**options): + if not options: + raise ValueError('no connection options were specified') + + def wrap(func): + func.__connect_options__ = options + return func + + return wrap + + +class ConnectedTestCase(ClusterTestCase): + + def setUp(self): + super().setUp() + + # Extract options set up with `with_connection_options`. + test_func = getattr(self, self._testMethodName).__func__ + opts = getattr(test_func, '__connect_options__', {}) + self.con = self.loop.run_until_complete(self.connect(**opts)) + self.server_version = self.con.get_server_version() + + def tearDown(self): + try: + self.loop.run_until_complete(self.con.close()) + self.con = None + finally: + super().tearDown() + + +class HotStandbyTestCase(ClusterTestCase): + + @classmethod + def setup_cluster(cls): + cls.master_cluster = cls.new_cluster(pg_cluster.TempCluster) + cls.start_cluster( + cls.master_cluster, + server_settings={ + 'max_wal_senders': 10, + 'wal_level': 'hot_standby' + } + ) + + con = None + + try: + con = cls.loop.run_until_complete( + cls.master_cluster.connect( + database='postgres', user='postgres', loop=cls.loop)) + + cls.loop.run_until_complete( + con.execute(''' + CREATE ROLE replication WITH LOGIN REPLICATION + ''')) + + cls.master_cluster.trust_local_replication_by('replication') + + conn_spec = cls.master_cluster.get_connection_spec() + + cls.standby_cluster = cls.new_cluster( + pg_cluster.HotStandbyCluster, + cluster_kwargs={ + 'master': conn_spec, + 'replication_user': 'replication' + } + ) + cls.start_cluster( + cls.standby_cluster, + server_settings={ + 'hot_standby': True + } + ) + + finally: + if con is not None: + cls.loop.run_until_complete(con.close()) + + @classmethod + def get_cluster_connection_spec(cls, cluster, kwargs={}): + conn_spec = cluster.get_connection_spec() + if kwargs.get('dsn'): + conn_spec.pop('host') + conn_spec.update(kwargs) + if not os.environ.get('PGHOST') and not kwargs.get('dsn'): + if 'database' not in conn_spec: + conn_spec['database'] = 'postgres' + if 'user' not in conn_spec: + conn_spec['user'] = 'postgres' + return conn_spec + + @classmethod + def get_connection_spec(cls, kwargs={}): + primary_spec = cls.get_cluster_connection_spec( + cls.master_cluster, kwargs + ) + standby_spec = cls.get_cluster_connection_spec( + cls.standby_cluster, kwargs + ) + return { + 'host': [primary_spec['host'], standby_spec['host']], + 'port': [primary_spec['port'], standby_spec['port']], + 'database': primary_spec['database'], + 'user': primary_spec['user'], + **kwargs + } + + @classmethod + def connect_primary(cls, **kwargs): + conn_spec = cls.get_cluster_connection_spec(cls.master_cluster, kwargs) + return pg_connection.connect(**conn_spec, loop=cls.loop) + + @classmethod + def connect_standby(cls, **kwargs): + conn_spec = cls.get_cluster_connection_spec( + cls.standby_cluster, + kwargs + ) + return pg_connection.connect(**conn_spec, loop=cls.loop) diff --git a/env/Lib/site-packages/asyncpg/_testbase/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/asyncpg/_testbase/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b2eeecb01c205ec935e35a3129dac83f8200fce1 GIT binary patch literal 27866 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 MN&Wa4nb;Ef|J&st%m4rY literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/asyncpg/_testbase/__pycache__/fuzzer.cpython-311.pyc b/env/Lib/site-packages/asyncpg/_testbase/__pycache__/fuzzer.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4a567465fad4adcb5288e604fcf1e4f07817831b GIT binary patch literal 19879 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 +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import asyncio +import socket +import threading +import typing + +from asyncpg import cluster + + +class StopServer(Exception): + pass + + +class TCPFuzzingProxy: + def __init__(self, *, listening_addr: str='127.0.0.1', + listening_port: typing.Optional[int]=None, + backend_host: str, backend_port: int, + settings: typing.Optional[dict]=None) -> None: + self.listening_addr = listening_addr + self.listening_port = listening_port + self.backend_host = backend_host + self.backend_port = backend_port + self.settings = settings or {} + self.loop = None + self.connectivity = None + self.connectivity_loss = None + self.stop_event = None + self.connections = {} + self.sock = None + self.listen_task = None + + async def _wait(self, work): + work_task = asyncio.ensure_future(work) + stop_event_task = asyncio.ensure_future(self.stop_event.wait()) + + try: + await asyncio.wait( + [work_task, stop_event_task], + return_when=asyncio.FIRST_COMPLETED) + + if self.stop_event.is_set(): + raise StopServer() + else: + return work_task.result() + finally: + if not work_task.done(): + work_task.cancel() + if not stop_event_task.done(): + stop_event_task.cancel() + + def start(self): + started = threading.Event() + self.thread = threading.Thread( + target=self._start_thread, args=(started,)) + self.thread.start() + if not started.wait(timeout=2): + raise RuntimeError('fuzzer proxy failed to start') + + def stop(self): + self.loop.call_soon_threadsafe(self._stop) + self.thread.join() + + def _stop(self): + self.stop_event.set() + + def _start_thread(self, started_event): + self.loop = asyncio.new_event_loop() + asyncio.set_event_loop(self.loop) + + self.connectivity = asyncio.Event() + self.connectivity.set() + self.connectivity_loss = asyncio.Event() + self.stop_event = asyncio.Event() + + if self.listening_port is None: + self.listening_port = cluster.find_available_port() + + self.sock = socket.socket() + self.sock.bind((self.listening_addr, self.listening_port)) + self.sock.listen(50) + self.sock.setblocking(False) + + try: + self.loop.run_until_complete(self._main(started_event)) + finally: + self.loop.close() + + async def _main(self, started_event): + self.listen_task = asyncio.ensure_future(self.listen()) + # Notify the main thread that we are ready to go. + started_event.set() + try: + await self.listen_task + finally: + for c in list(self.connections): + c.close() + await asyncio.sleep(0.01) + if hasattr(self.loop, 'remove_reader'): + self.loop.remove_reader(self.sock.fileno()) + self.sock.close() + + async def listen(self): + while True: + try: + client_sock, _ = await self._wait( + self.loop.sock_accept(self.sock)) + + backend_sock = socket.socket() + backend_sock.setblocking(False) + + await self._wait(self.loop.sock_connect( + backend_sock, (self.backend_host, self.backend_port))) + except StopServer: + break + + conn = Connection(client_sock, backend_sock, self) + conn_task = self.loop.create_task(conn.handle()) + self.connections[conn] = conn_task + + def trigger_connectivity_loss(self): + self.loop.call_soon_threadsafe(self._trigger_connectivity_loss) + + def _trigger_connectivity_loss(self): + self.connectivity.clear() + self.connectivity_loss.set() + + def restore_connectivity(self): + self.loop.call_soon_threadsafe(self._restore_connectivity) + + def _restore_connectivity(self): + self.connectivity.set() + self.connectivity_loss.clear() + + def reset(self): + self.restore_connectivity() + + def _close_connection(self, connection): + conn_task = self.connections.pop(connection, None) + if conn_task is not None: + conn_task.cancel() + + def close_all_connections(self): + for conn in list(self.connections): + self.loop.call_soon_threadsafe(self._close_connection, conn) + + +class Connection: + def __init__(self, client_sock, backend_sock, proxy): + self.client_sock = client_sock + self.backend_sock = backend_sock + self.proxy = proxy + self.loop = proxy.loop + self.connectivity = proxy.connectivity + self.connectivity_loss = proxy.connectivity_loss + self.proxy_to_backend_task = None + self.proxy_from_backend_task = None + self.is_closed = False + + def close(self): + if self.is_closed: + return + + self.is_closed = True + + if self.proxy_to_backend_task is not None: + self.proxy_to_backend_task.cancel() + self.proxy_to_backend_task = None + + if self.proxy_from_backend_task is not None: + self.proxy_from_backend_task.cancel() + self.proxy_from_backend_task = None + + self.proxy._close_connection(self) + + async def handle(self): + self.proxy_to_backend_task = asyncio.ensure_future( + self.proxy_to_backend()) + + self.proxy_from_backend_task = asyncio.ensure_future( + self.proxy_from_backend()) + + try: + await asyncio.wait( + [self.proxy_to_backend_task, self.proxy_from_backend_task], + return_when=asyncio.FIRST_COMPLETED) + + finally: + if self.proxy_to_backend_task is not None: + self.proxy_to_backend_task.cancel() + + if self.proxy_from_backend_task is not None: + self.proxy_from_backend_task.cancel() + + # Asyncio fails to properly remove the readers and writers + # when the task doing recv() or send() is cancelled, so + # we must remove the readers and writers manually before + # closing the sockets. + self.loop.remove_reader(self.client_sock.fileno()) + self.loop.remove_writer(self.client_sock.fileno()) + self.loop.remove_reader(self.backend_sock.fileno()) + self.loop.remove_writer(self.backend_sock.fileno()) + + self.client_sock.close() + self.backend_sock.close() + + async def _read(self, sock, n): + read_task = asyncio.ensure_future( + self.loop.sock_recv(sock, n)) + conn_event_task = asyncio.ensure_future( + self.connectivity_loss.wait()) + + try: + await asyncio.wait( + [read_task, conn_event_task], + return_when=asyncio.FIRST_COMPLETED) + + if self.connectivity_loss.is_set(): + return None + else: + return read_task.result() + finally: + if not self.loop.is_closed(): + if not read_task.done(): + read_task.cancel() + if not conn_event_task.done(): + conn_event_task.cancel() + + async def _write(self, sock, data): + write_task = asyncio.ensure_future( + self.loop.sock_sendall(sock, data)) + conn_event_task = asyncio.ensure_future( + self.connectivity_loss.wait()) + + try: + await asyncio.wait( + [write_task, conn_event_task], + return_when=asyncio.FIRST_COMPLETED) + + if self.connectivity_loss.is_set(): + return None + else: + return write_task.result() + finally: + if not self.loop.is_closed(): + if not write_task.done(): + write_task.cancel() + if not conn_event_task.done(): + conn_event_task.cancel() + + async def proxy_to_backend(self): + buf = None + + try: + while True: + await self.connectivity.wait() + if buf is not None: + data = buf + buf = None + else: + data = await self._read(self.client_sock, 4096) + if data == b'': + break + if self.connectivity_loss.is_set(): + if data: + buf = data + continue + await self._write(self.backend_sock, data) + + except ConnectionError: + pass + + finally: + if not self.loop.is_closed(): + self.loop.call_soon(self.close) + + async def proxy_from_backend(self): + buf = None + + try: + while True: + await self.connectivity.wait() + if buf is not None: + data = buf + buf = None + else: + data = await self._read(self.backend_sock, 4096) + if data == b'': + break + if self.connectivity_loss.is_set(): + if data: + buf = data + continue + await self._write(self.client_sock, data) + + except ConnectionError: + pass + + finally: + if not self.loop.is_closed(): + self.loop.call_soon(self.close) diff --git a/env/Lib/site-packages/asyncpg/_version.py b/env/Lib/site-packages/asyncpg/_version.py new file mode 100644 index 0000000..64da11d --- /dev/null +++ b/env/Lib/site-packages/asyncpg/_version.py @@ -0,0 +1,13 @@ +# This file MUST NOT contain anything but the __version__ assignment. +# +# When making a release, change the value of __version__ +# to an appropriate value, and open a pull request against +# the correct branch (master if making a new feature release). +# The commit message MUST contain a properly formatted release +# log, and the commit must be signed. +# +# The release automation will: build and test the packages for the +# supported platforms, publish the packages on PyPI, merge the PR +# to the target branch, create a Git tag pointing to the commit. + +__version__ = '0.29.0' diff --git a/env/Lib/site-packages/asyncpg/cluster.py b/env/Lib/site-packages/asyncpg/cluster.py new file mode 100644 index 0000000..4467cc2 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/cluster.py @@ -0,0 +1,688 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import asyncio +import os +import os.path +import platform +import re +import shutil +import socket +import subprocess +import sys +import tempfile +import textwrap +import time + +import asyncpg +from asyncpg import serverversion + + +_system = platform.uname().system + +if _system == 'Windows': + def platform_exe(name): + if name.endswith('.exe'): + return name + return name + '.exe' +else: + def platform_exe(name): + return name + + +def find_available_port(): + sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM) + try: + sock.bind(('127.0.0.1', 0)) + return sock.getsockname()[1] + except Exception: + return None + finally: + sock.close() + + +class ClusterError(Exception): + pass + + +class Cluster: + def __init__(self, data_dir, *, pg_config_path=None): + self._data_dir = data_dir + self._pg_config_path = pg_config_path + self._pg_bin_dir = ( + os.environ.get('PGINSTALLATION') + or os.environ.get('PGBIN') + ) + self._pg_ctl = None + self._daemon_pid = None + self._daemon_process = None + self._connection_addr = None + self._connection_spec_override = None + + def get_pg_version(self): + return self._pg_version + + def is_managed(self): + return True + + def get_data_dir(self): + return self._data_dir + + def get_status(self): + if self._pg_ctl is None: + self._init_env() + + process = subprocess.run( + [self._pg_ctl, 'status', '-D', self._data_dir], + stdout=subprocess.PIPE, stderr=subprocess.PIPE) + stdout, stderr = process.stdout, process.stderr + + if (process.returncode == 4 or not os.path.exists(self._data_dir) or + not os.listdir(self._data_dir)): + return 'not-initialized' + elif process.returncode == 3: + return 'stopped' + elif process.returncode == 0: + r = re.match(r'.*PID\s?:\s+(\d+).*', stdout.decode()) + if not r: + raise ClusterError( + 'could not parse pg_ctl status output: {}'.format( + stdout.decode())) + self._daemon_pid = int(r.group(1)) + return self._test_connection(timeout=0) + else: + raise ClusterError( + 'pg_ctl status exited with status {:d}: {}'.format( + process.returncode, stderr)) + + async def connect(self, loop=None, **kwargs): + conn_info = self.get_connection_spec() + conn_info.update(kwargs) + return await asyncpg.connect(loop=loop, **conn_info) + + def init(self, **settings): + """Initialize cluster.""" + if self.get_status() != 'not-initialized': + raise ClusterError( + 'cluster in {!r} has already been initialized'.format( + self._data_dir)) + + settings = dict(settings) + if 'encoding' not in settings: + settings['encoding'] = 'UTF-8' + + if settings: + settings_args = ['--{}={}'.format(k, v) + for k, v in settings.items()] + extra_args = ['-o'] + [' '.join(settings_args)] + else: + extra_args = [] + + process = subprocess.run( + [self._pg_ctl, 'init', '-D', self._data_dir] + extra_args, + stdout=subprocess.PIPE, stderr=subprocess.STDOUT) + + output = process.stdout + + if process.returncode != 0: + raise ClusterError( + 'pg_ctl init exited with status {:d}:\n{}'.format( + process.returncode, output.decode())) + + return output.decode() + + def start(self, wait=60, *, server_settings={}, **opts): + """Start the cluster.""" + status = self.get_status() + if status == 'running': + return + elif status == 'not-initialized': + raise ClusterError( + 'cluster in {!r} has not been initialized'.format( + self._data_dir)) + + port = opts.pop('port', None) + if port == 'dynamic': + port = find_available_port() + + extra_args = ['--{}={}'.format(k, v) for k, v in opts.items()] + extra_args.append('--port={}'.format(port)) + + sockdir = server_settings.get('unix_socket_directories') + if sockdir is None: + sockdir = server_settings.get('unix_socket_directory') + if sockdir is None and _system != 'Windows': + sockdir = tempfile.gettempdir() + + ssl_key = server_settings.get('ssl_key_file') + if ssl_key: + # Make sure server certificate key file has correct permissions. + keyfile = os.path.join(self._data_dir, 'srvkey.pem') + shutil.copy(ssl_key, keyfile) + os.chmod(keyfile, 0o600) + server_settings = server_settings.copy() + server_settings['ssl_key_file'] = keyfile + + if sockdir is not None: + if self._pg_version < (9, 3): + sockdir_opt = 'unix_socket_directory' + else: + sockdir_opt = 'unix_socket_directories' + + server_settings[sockdir_opt] = sockdir + + for k, v in server_settings.items(): + extra_args.extend(['-c', '{}={}'.format(k, v)]) + + if _system == 'Windows': + # On Windows we have to use pg_ctl as direct execution + # of postgres daemon under an Administrative account + # is not permitted and there is no easy way to drop + # privileges. + if os.getenv('ASYNCPG_DEBUG_SERVER'): + stdout = sys.stdout + print( + 'asyncpg.cluster: Running', + ' '.join([ + self._pg_ctl, 'start', '-D', self._data_dir, + '-o', ' '.join(extra_args) + ]), + file=sys.stderr, + ) + else: + stdout = subprocess.DEVNULL + + process = subprocess.run( + [self._pg_ctl, 'start', '-D', self._data_dir, + '-o', ' '.join(extra_args)], + stdout=stdout, stderr=subprocess.STDOUT) + + if process.returncode != 0: + if process.stderr: + stderr = ':\n{}'.format(process.stderr.decode()) + else: + stderr = '' + raise ClusterError( + 'pg_ctl start exited with status {:d}{}'.format( + process.returncode, stderr)) + else: + if os.getenv('ASYNCPG_DEBUG_SERVER'): + stdout = sys.stdout + else: + stdout = subprocess.DEVNULL + + self._daemon_process = \ + subprocess.Popen( + [self._postgres, '-D', self._data_dir, *extra_args], + stdout=stdout, stderr=subprocess.STDOUT) + + self._daemon_pid = self._daemon_process.pid + + self._test_connection(timeout=wait) + + def reload(self): + """Reload server configuration.""" + status = self.get_status() + if status != 'running': + raise ClusterError('cannot reload: cluster is not running') + + process = subprocess.run( + [self._pg_ctl, 'reload', '-D', self._data_dir], + stdout=subprocess.PIPE, stderr=subprocess.PIPE) + + stderr = process.stderr + + if process.returncode != 0: + raise ClusterError( + 'pg_ctl stop exited with status {:d}: {}'.format( + process.returncode, stderr.decode())) + + def stop(self, wait=60): + process = subprocess.run( + [self._pg_ctl, 'stop', '-D', self._data_dir, '-t', str(wait), + '-m', 'fast'], + stdout=subprocess.PIPE, stderr=subprocess.PIPE) + + stderr = process.stderr + + if process.returncode != 0: + raise ClusterError( + 'pg_ctl stop exited with status {:d}: {}'.format( + process.returncode, stderr.decode())) + + if (self._daemon_process is not None and + self._daemon_process.returncode is None): + self._daemon_process.kill() + + def destroy(self): + status = self.get_status() + if status == 'stopped' or status == 'not-initialized': + shutil.rmtree(self._data_dir) + else: + raise ClusterError('cannot destroy {} cluster'.format(status)) + + def _get_connection_spec(self): + if self._connection_addr is None: + self._connection_addr = self._connection_addr_from_pidfile() + + if self._connection_addr is not None: + if self._connection_spec_override: + args = self._connection_addr.copy() + args.update(self._connection_spec_override) + return args + else: + return self._connection_addr + + def get_connection_spec(self): + status = self.get_status() + if status != 'running': + raise ClusterError('cluster is not running') + + return self._get_connection_spec() + + def override_connection_spec(self, **kwargs): + self._connection_spec_override = kwargs + + def reset_wal(self, *, oid=None, xid=None): + status = self.get_status() + if status == 'not-initialized': + raise ClusterError( + 'cannot modify WAL status: cluster is not initialized') + + if status == 'running': + raise ClusterError( + 'cannot modify WAL status: cluster is running') + + opts = [] + if oid is not None: + opts.extend(['-o', str(oid)]) + if xid is not None: + opts.extend(['-x', str(xid)]) + if not opts: + return + + opts.append(self._data_dir) + + try: + reset_wal = self._find_pg_binary('pg_resetwal') + except ClusterError: + reset_wal = self._find_pg_binary('pg_resetxlog') + + process = subprocess.run( + [reset_wal] + opts, + stdout=subprocess.PIPE, stderr=subprocess.PIPE) + + stderr = process.stderr + + if process.returncode != 0: + raise ClusterError( + 'pg_resetwal exited with status {:d}: {}'.format( + process.returncode, stderr.decode())) + + def reset_hba(self): + """Remove all records from pg_hba.conf.""" + status = self.get_status() + if status == 'not-initialized': + raise ClusterError( + 'cannot modify HBA records: cluster is not initialized') + + pg_hba = os.path.join(self._data_dir, 'pg_hba.conf') + + try: + with open(pg_hba, 'w'): + pass + except IOError as e: + raise ClusterError( + 'cannot modify HBA records: {}'.format(e)) from e + + def add_hba_entry(self, *, type='host', database, user, address=None, + auth_method, auth_options=None): + """Add a record to pg_hba.conf.""" + status = self.get_status() + if status == 'not-initialized': + raise ClusterError( + 'cannot modify HBA records: cluster is not initialized') + + if type not in {'local', 'host', 'hostssl', 'hostnossl'}: + raise ValueError('invalid HBA record type: {!r}'.format(type)) + + pg_hba = os.path.join(self._data_dir, 'pg_hba.conf') + + record = '{} {} {}'.format(type, database, user) + + if type != 'local': + if address is None: + raise ValueError( + '{!r} entry requires a valid address'.format(type)) + else: + record += ' {}'.format(address) + + record += ' {}'.format(auth_method) + + if auth_options is not None: + record += ' ' + ' '.join( + '{}={}'.format(k, v) for k, v in auth_options) + + try: + with open(pg_hba, 'a') as f: + print(record, file=f) + except IOError as e: + raise ClusterError( + 'cannot modify HBA records: {}'.format(e)) from e + + def trust_local_connections(self): + self.reset_hba() + + if _system != 'Windows': + self.add_hba_entry(type='local', database='all', + user='all', auth_method='trust') + self.add_hba_entry(type='host', address='127.0.0.1/32', + database='all', user='all', + auth_method='trust') + self.add_hba_entry(type='host', address='::1/128', + database='all', user='all', + auth_method='trust') + status = self.get_status() + if status == 'running': + self.reload() + + def trust_local_replication_by(self, user): + if _system != 'Windows': + self.add_hba_entry(type='local', database='replication', + user=user, auth_method='trust') + self.add_hba_entry(type='host', address='127.0.0.1/32', + database='replication', user=user, + auth_method='trust') + self.add_hba_entry(type='host', address='::1/128', + database='replication', user=user, + auth_method='trust') + status = self.get_status() + if status == 'running': + self.reload() + + def _init_env(self): + if not self._pg_bin_dir: + pg_config = self._find_pg_config(self._pg_config_path) + pg_config_data = self._run_pg_config(pg_config) + + self._pg_bin_dir = pg_config_data.get('bindir') + if not self._pg_bin_dir: + raise ClusterError( + 'pg_config output did not provide the BINDIR value') + + self._pg_ctl = self._find_pg_binary('pg_ctl') + self._postgres = self._find_pg_binary('postgres') + self._pg_version = self._get_pg_version() + + def _connection_addr_from_pidfile(self): + pidfile = os.path.join(self._data_dir, 'postmaster.pid') + + try: + with open(pidfile, 'rt') as f: + piddata = f.read() + except FileNotFoundError: + return None + + lines = piddata.splitlines() + + if len(lines) < 6: + # A complete postgres pidfile is at least 6 lines + return None + + pmpid = int(lines[0]) + if self._daemon_pid and pmpid != self._daemon_pid: + # This might be an old pidfile left from previous postgres + # daemon run. + return None + + portnum = lines[3] + sockdir = lines[4] + hostaddr = lines[5] + + if sockdir: + if sockdir[0] != '/': + # Relative sockdir + sockdir = os.path.normpath( + os.path.join(self._data_dir, sockdir)) + host_str = sockdir + else: + host_str = hostaddr + + if host_str == '*': + host_str = 'localhost' + elif host_str == '0.0.0.0': + host_str = '127.0.0.1' + elif host_str == '::': + host_str = '::1' + + return { + 'host': host_str, + 'port': portnum + } + + def _test_connection(self, timeout=60): + self._connection_addr = None + + loop = asyncio.new_event_loop() + + try: + for i in range(timeout): + if self._connection_addr is None: + conn_spec = self._get_connection_spec() + if conn_spec is None: + time.sleep(1) + continue + + try: + con = loop.run_until_complete( + asyncpg.connect(database='postgres', + user='postgres', + timeout=5, loop=loop, + **self._connection_addr)) + except (OSError, asyncio.TimeoutError, + asyncpg.CannotConnectNowError, + asyncpg.PostgresConnectionError): + time.sleep(1) + continue + except asyncpg.PostgresError: + # Any other error other than ServerNotReadyError or + # ConnectionError is interpreted to indicate the server is + # up. + break + else: + loop.run_until_complete(con.close()) + break + finally: + loop.close() + + return 'running' + + def _run_pg_config(self, pg_config_path): + process = subprocess.run( + pg_config_path, stdout=subprocess.PIPE, stderr=subprocess.PIPE) + stdout, stderr = process.stdout, process.stderr + + if process.returncode != 0: + raise ClusterError('pg_config exited with status {:d}: {}'.format( + process.returncode, stderr)) + else: + config = {} + + for line in stdout.splitlines(): + k, eq, v = line.decode('utf-8').partition('=') + if eq: + config[k.strip().lower()] = v.strip() + + return config + + def _find_pg_config(self, pg_config_path): + if pg_config_path is None: + pg_install = ( + os.environ.get('PGINSTALLATION') + or os.environ.get('PGBIN') + ) + if pg_install: + pg_config_path = platform_exe( + os.path.join(pg_install, 'pg_config')) + else: + pathenv = os.environ.get('PATH').split(os.pathsep) + for path in pathenv: + pg_config_path = platform_exe( + os.path.join(path, 'pg_config')) + if os.path.exists(pg_config_path): + break + else: + pg_config_path = None + + if not pg_config_path: + raise ClusterError('could not find pg_config executable') + + if not os.path.isfile(pg_config_path): + raise ClusterError('{!r} is not an executable'.format( + pg_config_path)) + + return pg_config_path + + def _find_pg_binary(self, binary): + bpath = platform_exe(os.path.join(self._pg_bin_dir, binary)) + + if not os.path.isfile(bpath): + raise ClusterError( + 'could not find {} executable: '.format(binary) + + '{!r} does not exist or is not a file'.format(bpath)) + + return bpath + + def _get_pg_version(self): + process = subprocess.run( + [self._postgres, '--version'], + stdout=subprocess.PIPE, stderr=subprocess.PIPE) + stdout, stderr = process.stdout, process.stderr + + if process.returncode != 0: + raise ClusterError( + 'postgres --version exited with status {:d}: {}'.format( + process.returncode, stderr)) + + version_string = stdout.decode('utf-8').strip(' \n') + prefix = 'postgres (PostgreSQL) ' + if not version_string.startswith(prefix): + raise ClusterError( + 'could not determine server version from {!r}'.format( + version_string)) + version_string = version_string[len(prefix):] + + return serverversion.split_server_version_string(version_string) + + +class TempCluster(Cluster): + def __init__(self, *, + data_dir_suffix=None, data_dir_prefix=None, + data_dir_parent=None, pg_config_path=None): + self._data_dir = tempfile.mkdtemp(suffix=data_dir_suffix, + prefix=data_dir_prefix, + dir=data_dir_parent) + super().__init__(self._data_dir, pg_config_path=pg_config_path) + + +class HotStandbyCluster(TempCluster): + def __init__(self, *, + master, replication_user, + data_dir_suffix=None, data_dir_prefix=None, + data_dir_parent=None, pg_config_path=None): + self._master = master + self._repl_user = replication_user + super().__init__( + data_dir_suffix=data_dir_suffix, + data_dir_prefix=data_dir_prefix, + data_dir_parent=data_dir_parent, + pg_config_path=pg_config_path) + + def _init_env(self): + super()._init_env() + self._pg_basebackup = self._find_pg_binary('pg_basebackup') + + def init(self, **settings): + """Initialize cluster.""" + if self.get_status() != 'not-initialized': + raise ClusterError( + 'cluster in {!r} has already been initialized'.format( + self._data_dir)) + + process = subprocess.run( + [self._pg_basebackup, '-h', self._master['host'], + '-p', self._master['port'], '-D', self._data_dir, + '-U', self._repl_user], + stdout=subprocess.PIPE, stderr=subprocess.STDOUT) + + output = process.stdout + + if process.returncode != 0: + raise ClusterError( + 'pg_basebackup init exited with status {:d}:\n{}'.format( + process.returncode, output.decode())) + + if self._pg_version < (12, 0): + with open(os.path.join(self._data_dir, 'recovery.conf'), 'w') as f: + f.write(textwrap.dedent("""\ + standby_mode = 'on' + primary_conninfo = 'host={host} port={port} user={user}' + """.format( + host=self._master['host'], + port=self._master['port'], + user=self._repl_user))) + else: + f = open(os.path.join(self._data_dir, 'standby.signal'), 'w') + f.close() + + return output.decode() + + def start(self, wait=60, *, server_settings={}, **opts): + if self._pg_version >= (12, 0): + server_settings = server_settings.copy() + server_settings['primary_conninfo'] = ( + '"host={host} port={port} user={user}"'.format( + host=self._master['host'], + port=self._master['port'], + user=self._repl_user, + ) + ) + + super().start(wait=wait, server_settings=server_settings, **opts) + + +class RunningCluster(Cluster): + def __init__(self, **kwargs): + self.conn_spec = kwargs + + def is_managed(self): + return False + + def get_connection_spec(self): + return dict(self.conn_spec) + + def get_status(self): + return 'running' + + def init(self, **settings): + pass + + def start(self, wait=60, **settings): + pass + + def stop(self, wait=60): + pass + + def destroy(self): + pass + + def reset_hba(self): + raise ClusterError('cannot modify HBA records of unmanaged cluster') + + def add_hba_entry(self, *, type='host', database, user, address=None, + auth_method, auth_options=None): + raise ClusterError('cannot modify HBA records of unmanaged cluster') diff --git a/env/Lib/site-packages/asyncpg/compat.py b/env/Lib/site-packages/asyncpg/compat.py new file mode 100644 index 0000000..3eec9eb --- /dev/null +++ b/env/Lib/site-packages/asyncpg/compat.py @@ -0,0 +1,61 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import pathlib +import platform +import typing +import sys + + +SYSTEM = platform.uname().system + + +if SYSTEM == 'Windows': + import ctypes.wintypes + + CSIDL_APPDATA = 0x001a + + def get_pg_home_directory() -> typing.Optional[pathlib.Path]: + # We cannot simply use expanduser() as that returns the user's + # home directory, whereas Postgres stores its config in + # %AppData% on Windows. + buf = ctypes.create_unicode_buffer(ctypes.wintypes.MAX_PATH) + r = ctypes.windll.shell32.SHGetFolderPathW(0, CSIDL_APPDATA, 0, 0, buf) + if r: + return None + else: + return pathlib.Path(buf.value) / 'postgresql' + +else: + def get_pg_home_directory() -> typing.Optional[pathlib.Path]: + try: + return pathlib.Path.home() + except (RuntimeError, KeyError): + return None + + +async def wait_closed(stream): + # Not all asyncio versions have StreamWriter.wait_closed(). + if hasattr(stream, 'wait_closed'): + try: + await stream.wait_closed() + except ConnectionResetError: + # On Windows wait_closed() sometimes propagates + # ConnectionResetError which is totally unnecessary. + pass + + +if sys.version_info < (3, 12): + from ._asyncio_compat import wait_for as wait_for # noqa: F401 +else: + from asyncio import wait_for as wait_for # noqa: F401 + + +if sys.version_info < (3, 11): + from ._asyncio_compat import timeout_ctx as timeout # noqa: F401 +else: + from asyncio import timeout as timeout # noqa: F401 diff --git a/env/Lib/site-packages/asyncpg/connect_utils.py b/env/Lib/site-packages/asyncpg/connect_utils.py new file mode 100644 index 0000000..414231f --- /dev/null +++ b/env/Lib/site-packages/asyncpg/connect_utils.py @@ -0,0 +1,1081 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import asyncio +import collections +import enum +import functools +import getpass +import os +import pathlib +import platform +import random +import re +import socket +import ssl as ssl_module +import stat +import struct +import sys +import typing +import urllib.parse +import warnings +import inspect + +from . import compat +from . import exceptions +from . import protocol + + +class SSLMode(enum.IntEnum): + disable = 0 + allow = 1 + prefer = 2 + require = 3 + verify_ca = 4 + verify_full = 5 + + @classmethod + def parse(cls, sslmode): + if isinstance(sslmode, cls): + return sslmode + return getattr(cls, sslmode.replace('-', '_')) + + +_ConnectionParameters = collections.namedtuple( + 'ConnectionParameters', + [ + 'user', + 'password', + 'database', + 'ssl', + 'sslmode', + 'direct_tls', + 'server_settings', + 'target_session_attrs', + ]) + + +_ClientConfiguration = collections.namedtuple( + 'ConnectionConfiguration', + [ + 'command_timeout', + 'statement_cache_size', + 'max_cached_statement_lifetime', + 'max_cacheable_statement_size', + ]) + + +_system = platform.uname().system + + +if _system == 'Windows': + PGPASSFILE = 'pgpass.conf' +else: + PGPASSFILE = '.pgpass' + + +def _read_password_file(passfile: pathlib.Path) \ + -> typing.List[typing.Tuple[str, ...]]: + + passtab = [] + + try: + if not passfile.exists(): + return [] + + if not passfile.is_file(): + warnings.warn( + 'password file {!r} is not a plain file'.format(passfile)) + + return [] + + if _system != 'Windows': + if passfile.stat().st_mode & (stat.S_IRWXG | stat.S_IRWXO): + warnings.warn( + 'password file {!r} has group or world access; ' + 'permissions should be u=rw (0600) or less'.format( + passfile)) + + return [] + + with passfile.open('rt') as f: + for line in f: + line = line.strip() + if not line or line.startswith('#'): + # Skip empty lines and comments. + continue + # Backslash escapes both itself and the colon, + # which is a record separator. + line = line.replace(R'\\', '\n') + passtab.append(tuple( + p.replace('\n', R'\\') + for p in re.split(r'(? typing.Optional[pathlib.Path]: + try: + homedir = pathlib.Path.home() + except (RuntimeError, KeyError): + return None + + return (homedir / '.postgresql' / filename).resolve() + + +def _parse_connect_dsn_and_args(*, dsn, host, port, user, + password, passfile, database, ssl, + direct_tls, server_settings, + target_session_attrs): + # `auth_hosts` is the version of host information for the purposes + # of reading the pgpass file. + auth_hosts = None + sslcert = sslkey = sslrootcert = sslcrl = sslpassword = None + ssl_min_protocol_version = ssl_max_protocol_version = None + + if dsn: + parsed = urllib.parse.urlparse(dsn) + + if parsed.scheme not in {'postgresql', 'postgres'}: + raise exceptions.ClientConfigurationError( + 'invalid DSN: scheme is expected to be either ' + '"postgresql" or "postgres", got {!r}'.format(parsed.scheme)) + + if parsed.netloc: + if '@' in parsed.netloc: + dsn_auth, _, dsn_hostspec = parsed.netloc.partition('@') + else: + dsn_hostspec = parsed.netloc + dsn_auth = '' + else: + dsn_auth = dsn_hostspec = '' + + if dsn_auth: + dsn_user, _, dsn_password = dsn_auth.partition(':') + else: + dsn_user = dsn_password = '' + + if not host and dsn_hostspec: + host, port = _parse_hostlist(dsn_hostspec, port, unquote=True) + + if parsed.path and database is None: + dsn_database = parsed.path + if dsn_database.startswith('/'): + dsn_database = dsn_database[1:] + database = urllib.parse.unquote(dsn_database) + + if user is None and dsn_user: + user = urllib.parse.unquote(dsn_user) + + if password is None and dsn_password: + password = urllib.parse.unquote(dsn_password) + + if parsed.query: + query = urllib.parse.parse_qs(parsed.query, strict_parsing=True) + for key, val in query.items(): + if isinstance(val, list): + query[key] = val[-1] + + if 'port' in query: + val = query.pop('port') + if not port and val: + port = [int(p) for p in val.split(',')] + + if 'host' in query: + val = query.pop('host') + if not host and val: + host, port = _parse_hostlist(val, port) + + if 'dbname' in query: + val = query.pop('dbname') + if database is None: + database = val + + if 'database' in query: + val = query.pop('database') + if database is None: + database = val + + if 'user' in query: + val = query.pop('user') + if user is None: + user = val + + if 'password' in query: + val = query.pop('password') + if password is None: + password = val + + if 'passfile' in query: + val = query.pop('passfile') + if passfile is None: + passfile = val + + if 'sslmode' in query: + val = query.pop('sslmode') + if ssl is None: + ssl = val + + if 'sslcert' in query: + sslcert = query.pop('sslcert') + + if 'sslkey' in query: + sslkey = query.pop('sslkey') + + if 'sslrootcert' in query: + sslrootcert = query.pop('sslrootcert') + + if 'sslcrl' in query: + sslcrl = query.pop('sslcrl') + + if 'sslpassword' in query: + sslpassword = query.pop('sslpassword') + + if 'ssl_min_protocol_version' in query: + ssl_min_protocol_version = query.pop( + 'ssl_min_protocol_version' + ) + + if 'ssl_max_protocol_version' in query: + ssl_max_protocol_version = query.pop( + 'ssl_max_protocol_version' + ) + + if 'target_session_attrs' in query: + dsn_target_session_attrs = query.pop( + 'target_session_attrs' + ) + if target_session_attrs is None: + target_session_attrs = dsn_target_session_attrs + + if query: + if server_settings is None: + server_settings = query + else: + server_settings = {**query, **server_settings} + + if not host: + hostspec = os.environ.get('PGHOST') + if hostspec: + host, port = _parse_hostlist(hostspec, port) + + if not host: + auth_hosts = ['localhost'] + + if _system == 'Windows': + host = ['localhost'] + else: + host = ['/run/postgresql', '/var/run/postgresql', + '/tmp', '/private/tmp', 'localhost'] + + if not isinstance(host, (list, tuple)): + host = [host] + + if auth_hosts is None: + auth_hosts = host + + if not port: + portspec = os.environ.get('PGPORT') + if portspec: + if ',' in portspec: + port = [int(p) for p in portspec.split(',')] + else: + port = int(portspec) + else: + port = 5432 + + elif isinstance(port, (list, tuple)): + port = [int(p) for p in port] + + else: + port = int(port) + + port = _validate_port_spec(host, port) + + if user is None: + user = os.getenv('PGUSER') + if not user: + user = getpass.getuser() + + if password is None: + password = os.getenv('PGPASSWORD') + + if database is None: + database = os.getenv('PGDATABASE') + + if database is None: + database = user + + if user is None: + raise exceptions.ClientConfigurationError( + 'could not determine user name to connect with') + + if database is None: + raise exceptions.ClientConfigurationError( + 'could not determine database name to connect to') + + if password is None: + if passfile is None: + passfile = os.getenv('PGPASSFILE') + + if passfile is None: + homedir = compat.get_pg_home_directory() + if homedir: + passfile = homedir / PGPASSFILE + else: + passfile = None + else: + passfile = pathlib.Path(passfile) + + if passfile is not None: + password = _read_password_from_pgpass( + hosts=auth_hosts, ports=port, + database=database, user=user, + passfile=passfile) + + addrs = [] + have_tcp_addrs = False + for h, p in zip(host, port): + if h.startswith('/'): + # UNIX socket name + if '.s.PGSQL.' not in h: + h = os.path.join(h, '.s.PGSQL.{}'.format(p)) + addrs.append(h) + else: + # TCP host/port + addrs.append((h, p)) + have_tcp_addrs = True + + if not addrs: + raise exceptions.InternalClientError( + 'could not determine the database address to connect to') + + if ssl is None: + ssl = os.getenv('PGSSLMODE') + + if ssl is None and have_tcp_addrs: + ssl = 'prefer' + + if isinstance(ssl, (str, SSLMode)): + try: + sslmode = SSLMode.parse(ssl) + except AttributeError: + modes = ', '.join(m.name.replace('_', '-') for m in SSLMode) + raise exceptions.ClientConfigurationError( + '`sslmode` parameter must be one of: {}'.format(modes)) + + # docs at https://www.postgresql.org/docs/10/static/libpq-connect.html + if sslmode < SSLMode.allow: + ssl = False + else: + ssl = ssl_module.SSLContext(ssl_module.PROTOCOL_TLS_CLIENT) + ssl.check_hostname = sslmode >= SSLMode.verify_full + if sslmode < SSLMode.require: + ssl.verify_mode = ssl_module.CERT_NONE + else: + if sslrootcert is None: + sslrootcert = os.getenv('PGSSLROOTCERT') + if sslrootcert: + ssl.load_verify_locations(cafile=sslrootcert) + ssl.verify_mode = ssl_module.CERT_REQUIRED + else: + try: + sslrootcert = _dot_postgresql_path('root.crt') + if sslrootcert is not None: + ssl.load_verify_locations(cafile=sslrootcert) + else: + raise exceptions.ClientConfigurationError( + 'cannot determine location of user ' + 'PostgreSQL configuration directory' + ) + except ( + exceptions.ClientConfigurationError, + FileNotFoundError, + NotADirectoryError, + ): + if sslmode > SSLMode.require: + if sslrootcert is None: + sslrootcert = '~/.postgresql/root.crt' + detail = ( + 'Could not determine location of user ' + 'home directory (HOME is either unset, ' + 'inaccessible, or does not point to a ' + 'valid directory)' + ) + else: + detail = None + raise exceptions.ClientConfigurationError( + f'root certificate file "{sslrootcert}" does ' + f'not exist or cannot be accessed', + hint='Provide the certificate file directly ' + f'or make sure "{sslrootcert}" ' + 'exists and is readable.', + detail=detail, + ) + elif sslmode == SSLMode.require: + ssl.verify_mode = ssl_module.CERT_NONE + else: + assert False, 'unreachable' + else: + ssl.verify_mode = ssl_module.CERT_REQUIRED + + if sslcrl is None: + sslcrl = os.getenv('PGSSLCRL') + if sslcrl: + ssl.load_verify_locations(cafile=sslcrl) + ssl.verify_flags |= ssl_module.VERIFY_CRL_CHECK_CHAIN + else: + sslcrl = _dot_postgresql_path('root.crl') + if sslcrl is not None: + try: + ssl.load_verify_locations(cafile=sslcrl) + except ( + FileNotFoundError, + NotADirectoryError, + ): + pass + else: + ssl.verify_flags |= \ + ssl_module.VERIFY_CRL_CHECK_CHAIN + + if sslkey is None: + sslkey = os.getenv('PGSSLKEY') + if not sslkey: + sslkey = _dot_postgresql_path('postgresql.key') + if sslkey is not None and not sslkey.exists(): + sslkey = None + if not sslpassword: + sslpassword = '' + if sslcert is None: + sslcert = os.getenv('PGSSLCERT') + if sslcert: + ssl.load_cert_chain( + sslcert, keyfile=sslkey, password=lambda: sslpassword + ) + else: + sslcert = _dot_postgresql_path('postgresql.crt') + if sslcert is not None: + try: + ssl.load_cert_chain( + sslcert, + keyfile=sslkey, + password=lambda: sslpassword + ) + except (FileNotFoundError, NotADirectoryError): + pass + + # OpenSSL 1.1.1 keylog file, copied from create_default_context() + if hasattr(ssl, 'keylog_filename'): + keylogfile = os.environ.get('SSLKEYLOGFILE') + if keylogfile and not sys.flags.ignore_environment: + ssl.keylog_filename = keylogfile + + if ssl_min_protocol_version is None: + ssl_min_protocol_version = os.getenv('PGSSLMINPROTOCOLVERSION') + if ssl_min_protocol_version: + ssl.minimum_version = _parse_tls_version( + ssl_min_protocol_version + ) + else: + ssl.minimum_version = _parse_tls_version('TLSv1.2') + + if ssl_max_protocol_version is None: + ssl_max_protocol_version = os.getenv('PGSSLMAXPROTOCOLVERSION') + if ssl_max_protocol_version: + ssl.maximum_version = _parse_tls_version( + ssl_max_protocol_version + ) + + elif ssl is True: + ssl = ssl_module.create_default_context() + sslmode = SSLMode.verify_full + else: + sslmode = SSLMode.disable + + if server_settings is not None and ( + not isinstance(server_settings, dict) or + not all(isinstance(k, str) for k in server_settings) or + not all(isinstance(v, str) for v in server_settings.values())): + raise exceptions.ClientConfigurationError( + 'server_settings is expected to be None or ' + 'a Dict[str, str]') + + if target_session_attrs is None: + target_session_attrs = os.getenv( + "PGTARGETSESSIONATTRS", SessionAttribute.any + ) + try: + target_session_attrs = SessionAttribute(target_session_attrs) + except ValueError: + raise exceptions.ClientConfigurationError( + "target_session_attrs is expected to be one of " + "{!r}" + ", got {!r}".format( + SessionAttribute.__members__.values, target_session_attrs + ) + ) from None + + params = _ConnectionParameters( + user=user, password=password, database=database, ssl=ssl, + sslmode=sslmode, direct_tls=direct_tls, + server_settings=server_settings, + target_session_attrs=target_session_attrs) + + return addrs, params + + +def _parse_connect_arguments(*, dsn, host, port, user, password, passfile, + database, command_timeout, + statement_cache_size, + max_cached_statement_lifetime, + max_cacheable_statement_size, + ssl, direct_tls, server_settings, + target_session_attrs): + local_vars = locals() + for var_name in {'max_cacheable_statement_size', + 'max_cached_statement_lifetime', + 'statement_cache_size'}: + var_val = local_vars[var_name] + if var_val is None or isinstance(var_val, bool) or var_val < 0: + raise ValueError( + '{} is expected to be greater ' + 'or equal to 0, got {!r}'.format(var_name, var_val)) + + if command_timeout is not None: + try: + if isinstance(command_timeout, bool): + raise ValueError + command_timeout = float(command_timeout) + if command_timeout <= 0: + raise ValueError + except ValueError: + raise ValueError( + 'invalid command_timeout value: ' + 'expected greater than 0 float (got {!r})'.format( + command_timeout)) from None + + addrs, params = _parse_connect_dsn_and_args( + dsn=dsn, host=host, port=port, user=user, + password=password, passfile=passfile, ssl=ssl, + direct_tls=direct_tls, database=database, + server_settings=server_settings, + target_session_attrs=target_session_attrs) + + config = _ClientConfiguration( + command_timeout=command_timeout, + statement_cache_size=statement_cache_size, + max_cached_statement_lifetime=max_cached_statement_lifetime, + max_cacheable_statement_size=max_cacheable_statement_size,) + + return addrs, params, config + + +class TLSUpgradeProto(asyncio.Protocol): + def __init__(self, loop, host, port, ssl_context, ssl_is_advisory): + self.on_data = _create_future(loop) + self.host = host + self.port = port + self.ssl_context = ssl_context + self.ssl_is_advisory = ssl_is_advisory + + def data_received(self, data): + if data == b'S': + self.on_data.set_result(True) + elif (self.ssl_is_advisory and + self.ssl_context.verify_mode == ssl_module.CERT_NONE and + data == b'N'): + # ssl_is_advisory will imply that ssl.verify_mode == CERT_NONE, + # since the only way to get ssl_is_advisory is from + # sslmode=prefer. But be extra sure to disallow insecure + # connections when the ssl context asks for real security. + self.on_data.set_result(False) + else: + self.on_data.set_exception( + ConnectionError( + 'PostgreSQL server at "{host}:{port}" ' + 'rejected SSL upgrade'.format( + host=self.host, port=self.port))) + + def connection_lost(self, exc): + if not self.on_data.done(): + if exc is None: + exc = ConnectionError('unexpected connection_lost() call') + self.on_data.set_exception(exc) + + +async def _create_ssl_connection(protocol_factory, host, port, *, + loop, ssl_context, ssl_is_advisory=False): + + tr, pr = await loop.create_connection( + lambda: TLSUpgradeProto(loop, host, port, + ssl_context, ssl_is_advisory), + host, port) + + tr.write(struct.pack('!ll', 8, 80877103)) # SSLRequest message. + + try: + do_ssl_upgrade = await pr.on_data + except (Exception, asyncio.CancelledError): + tr.close() + raise + + if hasattr(loop, 'start_tls'): + if do_ssl_upgrade: + try: + new_tr = await loop.start_tls( + tr, pr, ssl_context, server_hostname=host) + except (Exception, asyncio.CancelledError): + tr.close() + raise + else: + new_tr = tr + + pg_proto = protocol_factory() + pg_proto.is_ssl = do_ssl_upgrade + pg_proto.connection_made(new_tr) + new_tr.set_protocol(pg_proto) + + return new_tr, pg_proto + else: + conn_factory = functools.partial( + loop.create_connection, protocol_factory) + + if do_ssl_upgrade: + conn_factory = functools.partial( + conn_factory, ssl=ssl_context, server_hostname=host) + + sock = _get_socket(tr) + sock = sock.dup() + _set_nodelay(sock) + tr.close() + + try: + new_tr, pg_proto = await conn_factory(sock=sock) + pg_proto.is_ssl = do_ssl_upgrade + return new_tr, pg_proto + except (Exception, asyncio.CancelledError): + sock.close() + raise + + +async def _connect_addr( + *, + addr, + loop, + params, + config, + connection_class, + record_class +): + assert loop is not None + + params_input = params + if callable(params.password): + password = params.password() + if inspect.isawaitable(password): + password = await password + + params = params._replace(password=password) + args = (addr, loop, config, connection_class, record_class, params_input) + + # prepare the params (which attempt has ssl) for the 2 attempts + if params.sslmode == SSLMode.allow: + params_retry = params + params = params._replace(ssl=None) + elif params.sslmode == SSLMode.prefer: + params_retry = params._replace(ssl=None) + else: + # skip retry if we don't have to + return await __connect_addr(params, False, *args) + + # first attempt + try: + return await __connect_addr(params, True, *args) + except _RetryConnectSignal: + pass + + # second attempt + return await __connect_addr(params_retry, False, *args) + + +class _RetryConnectSignal(Exception): + pass + + +async def __connect_addr( + params, + retry, + addr, + loop, + config, + connection_class, + record_class, + params_input, +): + connected = _create_future(loop) + + proto_factory = lambda: protocol.Protocol( + addr, connected, params, record_class, loop) + + if isinstance(addr, str): + # UNIX socket + connector = loop.create_unix_connection(proto_factory, addr) + + elif params.ssl and params.direct_tls: + # if ssl and direct_tls are given, skip STARTTLS and perform direct + # SSL connection + connector = loop.create_connection( + proto_factory, *addr, ssl=params.ssl + ) + + elif params.ssl: + connector = _create_ssl_connection( + proto_factory, *addr, loop=loop, ssl_context=params.ssl, + ssl_is_advisory=params.sslmode == SSLMode.prefer) + else: + connector = loop.create_connection(proto_factory, *addr) + + tr, pr = await connector + + try: + await connected + except ( + exceptions.InvalidAuthorizationSpecificationError, + exceptions.ConnectionDoesNotExistError, # seen on Windows + ): + tr.close() + + # retry=True here is a redundant check because we don't want to + # accidentally raise the internal _RetryConnectSignal to the user + if retry and ( + params.sslmode == SSLMode.allow and not pr.is_ssl or + params.sslmode == SSLMode.prefer and pr.is_ssl + ): + # Trigger retry when: + # 1. First attempt with sslmode=allow, ssl=None failed + # 2. First attempt with sslmode=prefer, ssl=ctx failed while the + # server claimed to support SSL (returning "S" for SSLRequest) + # (likely because pg_hba.conf rejected the connection) + raise _RetryConnectSignal() + + else: + # but will NOT retry if: + # 1. First attempt with sslmode=prefer failed but the server + # doesn't support SSL (returning 'N' for SSLRequest), because + # we already tried to connect without SSL thru ssl_is_advisory + # 2. Second attempt with sslmode=prefer, ssl=None failed + # 3. Second attempt with sslmode=allow, ssl=ctx failed + # 4. Any other sslmode + raise + + except (Exception, asyncio.CancelledError): + tr.close() + raise + + con = connection_class(pr, tr, loop, addr, config, params_input) + pr.set_connection(con) + return con + + +class SessionAttribute(str, enum.Enum): + any = 'any' + primary = 'primary' + standby = 'standby' + prefer_standby = 'prefer-standby' + read_write = "read-write" + read_only = "read-only" + + +def _accept_in_hot_standby(should_be_in_hot_standby: bool): + """ + If the server didn't report "in_hot_standby" at startup, we must determine + the state by checking "SELECT pg_catalog.pg_is_in_recovery()". + If the server allows a connection and states it is in recovery it must + be a replica/standby server. + """ + async def can_be_used(connection): + settings = connection.get_settings() + hot_standby_status = getattr(settings, 'in_hot_standby', None) + if hot_standby_status is not None: + is_in_hot_standby = hot_standby_status == 'on' + else: + is_in_hot_standby = await connection.fetchval( + "SELECT pg_catalog.pg_is_in_recovery()" + ) + return is_in_hot_standby == should_be_in_hot_standby + + return can_be_used + + +def _accept_read_only(should_be_read_only: bool): + """ + Verify the server has not set default_transaction_read_only=True + """ + async def can_be_used(connection): + settings = connection.get_settings() + is_readonly = getattr(settings, 'default_transaction_read_only', 'off') + + if is_readonly == "on": + return should_be_read_only + + return await _accept_in_hot_standby(should_be_read_only)(connection) + return can_be_used + + +async def _accept_any(_): + return True + + +target_attrs_check = { + SessionAttribute.any: _accept_any, + SessionAttribute.primary: _accept_in_hot_standby(False), + SessionAttribute.standby: _accept_in_hot_standby(True), + SessionAttribute.prefer_standby: _accept_in_hot_standby(True), + SessionAttribute.read_write: _accept_read_only(False), + SessionAttribute.read_only: _accept_read_only(True), +} + + +async def _can_use_connection(connection, attr: SessionAttribute): + can_use = target_attrs_check[attr] + return await can_use(connection) + + +async def _connect(*, loop, connection_class, record_class, **kwargs): + if loop is None: + loop = asyncio.get_event_loop() + + addrs, params, config = _parse_connect_arguments(**kwargs) + target_attr = params.target_session_attrs + + candidates = [] + chosen_connection = None + last_error = None + for addr in addrs: + try: + conn = await _connect_addr( + addr=addr, + loop=loop, + params=params, + config=config, + connection_class=connection_class, + record_class=record_class, + ) + candidates.append(conn) + if await _can_use_connection(conn, target_attr): + chosen_connection = conn + break + except OSError as ex: + last_error = ex + else: + if target_attr == SessionAttribute.prefer_standby and candidates: + chosen_connection = random.choice(candidates) + + await asyncio.gather( + *(c.close() for c in candidates if c is not chosen_connection), + return_exceptions=True + ) + + if chosen_connection: + return chosen_connection + + raise last_error or exceptions.TargetServerAttributeNotMatched( + 'None of the hosts match the target attribute requirement ' + '{!r}'.format(target_attr) + ) + + +async def _cancel(*, loop, addr, params: _ConnectionParameters, + backend_pid, backend_secret): + + class CancelProto(asyncio.Protocol): + + def __init__(self): + self.on_disconnect = _create_future(loop) + self.is_ssl = False + + def connection_lost(self, exc): + if not self.on_disconnect.done(): + self.on_disconnect.set_result(True) + + if isinstance(addr, str): + tr, pr = await loop.create_unix_connection(CancelProto, addr) + else: + if params.ssl and params.sslmode != SSLMode.allow: + tr, pr = await _create_ssl_connection( + CancelProto, + *addr, + loop=loop, + ssl_context=params.ssl, + ssl_is_advisory=params.sslmode == SSLMode.prefer) + else: + tr, pr = await loop.create_connection( + CancelProto, *addr) + _set_nodelay(_get_socket(tr)) + + # Pack a CancelRequest message + msg = struct.pack('!llll', 16, 80877102, backend_pid, backend_secret) + + try: + tr.write(msg) + await pr.on_disconnect + finally: + tr.close() + + +def _get_socket(transport): + sock = transport.get_extra_info('socket') + if sock is None: + # Shouldn't happen with any asyncio-complaint event loop. + raise ConnectionError( + 'could not get the socket for transport {!r}'.format(transport)) + return sock + + +def _set_nodelay(sock): + if not hasattr(socket, 'AF_UNIX') or sock.family != socket.AF_UNIX: + sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1) + + +def _create_future(loop): + try: + create_future = loop.create_future + except AttributeError: + return asyncio.Future(loop=loop) + else: + return create_future() diff --git a/env/Lib/site-packages/asyncpg/connection.py b/env/Lib/site-packages/asyncpg/connection.py new file mode 100644 index 0000000..0367e36 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/connection.py @@ -0,0 +1,2655 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import asyncio +import asyncpg +import collections +import collections.abc +import contextlib +import functools +import itertools +import inspect +import os +import sys +import time +import traceback +import typing +import warnings +import weakref + +from . import compat +from . import connect_utils +from . import cursor +from . import exceptions +from . import introspection +from . import prepared_stmt +from . import protocol +from . import serverversion +from . import transaction +from . import utils + + +class ConnectionMeta(type): + + def __instancecheck__(cls, instance): + mro = type(instance).__mro__ + return Connection in mro or _ConnectionProxy in mro + + +class Connection(metaclass=ConnectionMeta): + """A representation of a database session. + + Connections are created by calling :func:`~asyncpg.connection.connect`. + """ + + __slots__ = ('_protocol', '_transport', '_loop', + '_top_xact', '_aborted', + '_pool_release_ctr', '_stmt_cache', '_stmts_to_close', + '_stmt_cache_enabled', + '_listeners', '_server_version', '_server_caps', + '_intro_query', '_reset_query', '_proxy', + '_stmt_exclusive_section', '_config', '_params', '_addr', + '_log_listeners', '_termination_listeners', '_cancellations', + '_source_traceback', '_query_loggers', '__weakref__') + + def __init__(self, protocol, transport, loop, + addr, + config: connect_utils._ClientConfiguration, + params: connect_utils._ConnectionParameters): + self._protocol = protocol + self._transport = transport + self._loop = loop + self._top_xact = None + self._aborted = False + # Incremented every time the connection is released back to a pool. + # Used to catch invalid references to connection-related resources + # post-release (e.g. explicit prepared statements). + self._pool_release_ctr = 0 + + self._addr = addr + self._config = config + self._params = params + + self._stmt_cache = _StatementCache( + loop=loop, + max_size=config.statement_cache_size, + on_remove=functools.partial( + _weak_maybe_gc_stmt, weakref.ref(self)), + max_lifetime=config.max_cached_statement_lifetime) + + self._stmts_to_close = set() + self._stmt_cache_enabled = config.statement_cache_size > 0 + + self._listeners = {} + self._log_listeners = set() + self._cancellations = set() + self._termination_listeners = set() + self._query_loggers = set() + + settings = self._protocol.get_settings() + ver_string = settings.server_version + self._server_version = \ + serverversion.split_server_version_string(ver_string) + + self._server_caps = _detect_server_capabilities( + self._server_version, settings) + + if self._server_version < (14, 0): + self._intro_query = introspection.INTRO_LOOKUP_TYPES_13 + else: + self._intro_query = introspection.INTRO_LOOKUP_TYPES + + self._reset_query = None + self._proxy = None + + # Used to serialize operations that might involve anonymous + # statements. Specifically, we want to make the following + # operation atomic: + # ("prepare an anonymous statement", "use the statement") + # + # Used for `con.fetchval()`, `con.fetch()`, `con.fetchrow()`, + # `con.execute()`, and `con.executemany()`. + self._stmt_exclusive_section = _Atomic() + + if loop.get_debug(): + self._source_traceback = _extract_stack() + else: + self._source_traceback = None + + def __del__(self): + if not self.is_closed() and self._protocol is not None: + if self._source_traceback: + msg = "unclosed connection {!r}; created at:\n {}".format( + self, self._source_traceback) + else: + msg = ( + "unclosed connection {!r}; run in asyncio debug " + "mode to show the traceback of connection " + "origin".format(self) + ) + + warnings.warn(msg, ResourceWarning) + if not self._loop.is_closed(): + self.terminate() + + async def add_listener(self, channel, callback): + """Add a listener for Postgres notifications. + + :param str channel: Channel to listen on. + + :param callable callback: + A callable or a coroutine function receiving the following + arguments: + **connection**: a Connection the callback is registered with; + **pid**: PID of the Postgres server that sent the notification; + **channel**: name of the channel the notification was sent to; + **payload**: the payload. + + .. versionchanged:: 0.24.0 + The ``callback`` argument may be a coroutine function. + """ + self._check_open() + if channel not in self._listeners: + await self.fetch('LISTEN {}'.format(utils._quote_ident(channel))) + self._listeners[channel] = set() + self._listeners[channel].add(_Callback.from_callable(callback)) + + async def remove_listener(self, channel, callback): + """Remove a listening callback on the specified channel.""" + if self.is_closed(): + return + if channel not in self._listeners: + return + cb = _Callback.from_callable(callback) + if cb not in self._listeners[channel]: + return + self._listeners[channel].remove(cb) + if not self._listeners[channel]: + del self._listeners[channel] + await self.fetch('UNLISTEN {}'.format(utils._quote_ident(channel))) + + def add_log_listener(self, callback): + """Add a listener for Postgres log messages. + + It will be called when asyncronous NoticeResponse is received + from the connection. Possible message types are: WARNING, NOTICE, + DEBUG, INFO, or LOG. + + :param callable callback: + A callable or a coroutine function receiving the following + arguments: + **connection**: a Connection the callback is registered with; + **message**: the `exceptions.PostgresLogMessage` message. + + .. versionadded:: 0.12.0 + + .. versionchanged:: 0.24.0 + The ``callback`` argument may be a coroutine function. + """ + if self.is_closed(): + raise exceptions.InterfaceError('connection is closed') + self._log_listeners.add(_Callback.from_callable(callback)) + + def remove_log_listener(self, callback): + """Remove a listening callback for log messages. + + .. versionadded:: 0.12.0 + """ + self._log_listeners.discard(_Callback.from_callable(callback)) + + def add_termination_listener(self, callback): + """Add a listener that will be called when the connection is closed. + + :param callable callback: + A callable or a coroutine function receiving one argument: + **connection**: a Connection the callback is registered with. + + .. versionadded:: 0.21.0 + + .. versionchanged:: 0.24.0 + The ``callback`` argument may be a coroutine function. + """ + self._termination_listeners.add(_Callback.from_callable(callback)) + + def remove_termination_listener(self, callback): + """Remove a listening callback for connection termination. + + :param callable callback: + The callable or coroutine function that was passed to + :meth:`Connection.add_termination_listener`. + + .. versionadded:: 0.21.0 + """ + self._termination_listeners.discard(_Callback.from_callable(callback)) + + def add_query_logger(self, callback): + """Add a logger that will be called when queries are executed. + + :param callable callback: + A callable or a coroutine function receiving one argument: + **record**: a LoggedQuery containing `query`, `args`, `timeout`, + `elapsed`, `exception`, `conn_addr`, and + `conn_params`. + + .. versionadded:: 0.29.0 + """ + self._query_loggers.add(_Callback.from_callable(callback)) + + def remove_query_logger(self, callback): + """Remove a query logger callback. + + :param callable callback: + The callable or coroutine function that was passed to + :meth:`Connection.add_query_logger`. + + .. versionadded:: 0.29.0 + """ + self._query_loggers.discard(_Callback.from_callable(callback)) + + def get_server_pid(self): + """Return the PID of the Postgres server the connection is bound to.""" + return self._protocol.get_server_pid() + + def get_server_version(self): + """Return the version of the connected PostgreSQL server. + + The returned value is a named tuple similar to that in + ``sys.version_info``: + + .. code-block:: pycon + + >>> con.get_server_version() + ServerVersion(major=9, minor=6, micro=1, + releaselevel='final', serial=0) + + .. versionadded:: 0.8.0 + """ + return self._server_version + + def get_settings(self): + """Return connection settings. + + :return: :class:`~asyncpg.ConnectionSettings`. + """ + return self._protocol.get_settings() + + def transaction(self, *, isolation=None, readonly=False, + deferrable=False): + """Create a :class:`~transaction.Transaction` object. + + Refer to `PostgreSQL documentation`_ on the meaning of transaction + parameters. + + :param isolation: Transaction isolation mode, can be one of: + `'serializable'`, `'repeatable_read'`, + `'read_uncommitted'`, `'read_committed'`. If not + specified, the behavior is up to the server and + session, which is usually ``read_committed``. + + :param readonly: Specifies whether or not this transaction is + read-only. + + :param deferrable: Specifies whether or not this transaction is + deferrable. + + .. _`PostgreSQL documentation`: + https://www.postgresql.org/docs/ + current/static/sql-set-transaction.html + """ + self._check_open() + return transaction.Transaction(self, isolation, readonly, deferrable) + + def is_in_transaction(self): + """Return True if Connection is currently inside a transaction. + + :return bool: True if inside transaction, False otherwise. + + .. versionadded:: 0.16.0 + """ + return self._protocol.is_in_transaction() + + async def execute(self, query: str, *args, timeout: float=None) -> str: + """Execute an SQL command (or commands). + + This method can execute many SQL commands at once, when no arguments + are provided. + + Example: + + .. code-block:: pycon + + >>> await con.execute(''' + ... CREATE TABLE mytab (a int); + ... INSERT INTO mytab (a) VALUES (100), (200), (300); + ... ''') + INSERT 0 3 + + >>> await con.execute(''' + ... INSERT INTO mytab (a) VALUES ($1), ($2) + ... ''', 10, 20) + INSERT 0 2 + + :param args: Query arguments. + :param float timeout: Optional timeout value in seconds. + :return str: Status of the last SQL command. + + .. versionchanged:: 0.5.4 + Made it possible to pass query arguments. + """ + self._check_open() + + if not args: + if self._query_loggers: + with self._time_and_log(query, args, timeout): + result = await self._protocol.query(query, timeout) + else: + result = await self._protocol.query(query, timeout) + return result + + _, status, _ = await self._execute( + query, + args, + 0, + timeout, + return_status=True, + ) + return status.decode() + + async def executemany(self, command: str, args, *, timeout: float=None): + """Execute an SQL *command* for each sequence of arguments in *args*. + + Example: + + .. code-block:: pycon + + >>> await con.executemany(''' + ... INSERT INTO mytab (a) VALUES ($1, $2, $3); + ... ''', [(1, 2, 3), (4, 5, 6)]) + + :param command: Command to execute. + :param args: An iterable containing sequences of arguments. + :param float timeout: Optional timeout value in seconds. + :return None: This method discards the results of the operations. + + .. versionadded:: 0.7.0 + + .. versionchanged:: 0.11.0 + `timeout` became a keyword-only parameter. + + .. versionchanged:: 0.22.0 + ``executemany()`` is now an atomic operation, which means that + either all executions succeed, or none at all. This is in contrast + to prior versions, where the effect of already-processed iterations + would remain in place when an error has occurred, unless + ``executemany()`` was called in a transaction. + """ + self._check_open() + return await self._executemany(command, args, timeout) + + async def _get_statement( + self, + query, + timeout, + *, + named=False, + use_cache=True, + ignore_custom_codec=False, + record_class=None + ): + if record_class is None: + record_class = self._protocol.get_record_class() + else: + _check_record_class(record_class) + + if use_cache: + statement = self._stmt_cache.get( + (query, record_class, ignore_custom_codec) + ) + if statement is not None: + return statement + + # Only use the cache when: + # * `statement_cache_size` is greater than 0; + # * query size is less than `max_cacheable_statement_size`. + use_cache = ( + self._stmt_cache_enabled + and ( + not self._config.max_cacheable_statement_size + or len(query) <= self._config.max_cacheable_statement_size + ) + ) + + if isinstance(named, str): + stmt_name = named + elif use_cache or named: + stmt_name = self._get_unique_id('stmt') + else: + stmt_name = '' + + statement = await self._protocol.prepare( + stmt_name, + query, + timeout, + record_class=record_class, + ignore_custom_codec=ignore_custom_codec, + ) + need_reprepare = False + types_with_missing_codecs = statement._init_types() + tries = 0 + while types_with_missing_codecs: + settings = self._protocol.get_settings() + + # Introspect newly seen types and populate the + # codec cache. + types, intro_stmt = await self._introspect_types( + types_with_missing_codecs, timeout) + + settings.register_data_types(types) + + # The introspection query has used an anonymous statement, + # which has blown away the anonymous statement we've prepared + # for the query, so we need to re-prepare it. + need_reprepare = not intro_stmt.name and not statement.name + types_with_missing_codecs = statement._init_types() + tries += 1 + if tries > 5: + # In the vast majority of cases there will be only + # one iteration. In rare cases, there might be a race + # with reload_schema_state(), which would cause a + # second try. More than five is clearly a bug. + raise exceptions.InternalClientError( + 'could not resolve query result and/or argument types ' + 'in {} attempts'.format(tries) + ) + + # Now that types have been resolved, populate the codec pipeline + # for the statement. + statement._init_codecs() + + if ( + need_reprepare + or (not statement.name and not self._stmt_cache_enabled) + ): + # Mark this anonymous prepared statement as "unprepared", + # causing it to get re-Parsed in next bind_execute. + # We always do this when stmt_cache_size is set to 0 assuming + # people are running PgBouncer which is mishandling implicit + # transactions. + statement.mark_unprepared() + + if use_cache: + self._stmt_cache.put( + (query, record_class, ignore_custom_codec), statement) + + # If we've just created a new statement object, check if there + # are any statements for GC. + if self._stmts_to_close: + await self._cleanup_stmts() + + return statement + + async def _introspect_types(self, typeoids, timeout): + if self._server_caps.jit: + try: + cfgrow, _ = await self.__execute( + """ + SELECT + current_setting('jit') AS cur, + set_config('jit', 'off', false) AS new + """, + (), + 0, + timeout, + ignore_custom_codec=True, + ) + jit_state = cfgrow[0]['cur'] + except exceptions.UndefinedObjectError: + jit_state = 'off' + else: + jit_state = 'off' + + result = await self.__execute( + self._intro_query, + (list(typeoids),), + 0, + timeout, + ignore_custom_codec=True, + ) + + if jit_state != 'off': + await self.__execute( + """ + SELECT + set_config('jit', $1, false) + """, + (jit_state,), + 0, + timeout, + ignore_custom_codec=True, + ) + + return result + + async def _introspect_type(self, typename, schema): + if ( + schema == 'pg_catalog' + and typename.lower() in protocol.BUILTIN_TYPE_NAME_MAP + ): + typeoid = protocol.BUILTIN_TYPE_NAME_MAP[typename.lower()] + rows = await self._execute( + introspection.TYPE_BY_OID, + [typeoid], + limit=0, + timeout=None, + ignore_custom_codec=True, + ) + else: + rows = await self._execute( + introspection.TYPE_BY_NAME, + [typename, schema], + limit=1, + timeout=None, + ignore_custom_codec=True, + ) + + if not rows: + raise ValueError( + 'unknown type: {}.{}'.format(schema, typename)) + + return rows[0] + + def cursor( + self, + query, + *args, + prefetch=None, + timeout=None, + record_class=None + ): + """Return a *cursor factory* for the specified query. + + :param args: + Query arguments. + :param int prefetch: + The number of rows the *cursor iterator* + will prefetch (defaults to ``50``.) + :param float timeout: + Optional timeout in seconds. + :param type record_class: + If specified, the class to use for records returned by this cursor. + Must be a subclass of :class:`~asyncpg.Record`. If not specified, + a per-connection *record_class* is used. + + :return: + A :class:`~cursor.CursorFactory` object. + + .. versionchanged:: 0.22.0 + Added the *record_class* parameter. + """ + self._check_open() + return cursor.CursorFactory( + self, + query, + None, + args, + prefetch, + timeout, + record_class, + ) + + async def prepare( + self, + query, + *, + name=None, + timeout=None, + record_class=None, + ): + """Create a *prepared statement* for the specified query. + + :param str query: + Text of the query to create a prepared statement for. + :param str name: + Optional name of the returned prepared statement. If not + specified, the name is auto-generated. + :param float timeout: + Optional timeout value in seconds. + :param type record_class: + If specified, the class to use for records returned by the + prepared statement. Must be a subclass of + :class:`~asyncpg.Record`. If not specified, a per-connection + *record_class* is used. + + :return: + A :class:`~prepared_stmt.PreparedStatement` instance. + + .. versionchanged:: 0.22.0 + Added the *record_class* parameter. + + .. versionchanged:: 0.25.0 + Added the *name* parameter. + """ + return await self._prepare( + query, + name=name, + timeout=timeout, + use_cache=False, + record_class=record_class, + ) + + async def _prepare( + self, + query, + *, + name=None, + timeout=None, + use_cache: bool=False, + record_class=None + ): + self._check_open() + stmt = await self._get_statement( + query, + timeout, + named=True if name is None else name, + use_cache=use_cache, + record_class=record_class, + ) + return prepared_stmt.PreparedStatement(self, query, stmt) + + async def fetch( + self, + query, + *args, + timeout=None, + record_class=None + ) -> list: + """Run a query and return the results as a list of :class:`Record`. + + :param str query: + Query text. + :param args: + Query arguments. + :param float timeout: + Optional timeout value in seconds. + :param type record_class: + If specified, the class to use for records returned by this method. + Must be a subclass of :class:`~asyncpg.Record`. If not specified, + a per-connection *record_class* is used. + + :return list: + A list of :class:`~asyncpg.Record` instances. If specified, the + actual type of list elements would be *record_class*. + + .. versionchanged:: 0.22.0 + Added the *record_class* parameter. + """ + self._check_open() + return await self._execute( + query, + args, + 0, + timeout, + record_class=record_class, + ) + + async def fetchval(self, query, *args, column=0, timeout=None): + """Run a query and return a value in the first row. + + :param str query: Query text. + :param args: Query arguments. + :param int column: Numeric index within the record of the value to + return (defaults to 0). + :param float timeout: Optional timeout value in seconds. + If not specified, defaults to the value of + ``command_timeout`` argument to the ``Connection`` + instance constructor. + + :return: The value of the specified column of the first record, or + None if no records were returned by the query. + """ + self._check_open() + data = await self._execute(query, args, 1, timeout) + if not data: + return None + return data[0][column] + + async def fetchrow( + self, + query, + *args, + timeout=None, + record_class=None + ): + """Run a query and return the first row. + + :param str query: + Query text + :param args: + Query arguments + :param float timeout: + Optional timeout value in seconds. + :param type record_class: + If specified, the class to use for the value returned by this + method. Must be a subclass of :class:`~asyncpg.Record`. + If not specified, a per-connection *record_class* is used. + + :return: + The first row as a :class:`~asyncpg.Record` instance, or None if + no records were returned by the query. If specified, + *record_class* is used as the type for the result value. + + .. versionchanged:: 0.22.0 + Added the *record_class* parameter. + """ + self._check_open() + data = await self._execute( + query, + args, + 1, + timeout, + record_class=record_class, + ) + if not data: + return None + return data[0] + + async def copy_from_table(self, table_name, *, output, + columns=None, schema_name=None, timeout=None, + format=None, oids=None, delimiter=None, + null=None, header=None, quote=None, + escape=None, force_quote=None, encoding=None): + """Copy table contents to a file or file-like object. + + :param str table_name: + The name of the table to copy data from. + + :param output: + A :term:`path-like object `, + or a :term:`file-like object `, or + a :term:`coroutine function ` + that takes a ``bytes`` instance as a sole argument. + + :param list columns: + An optional list of column names to copy. + + :param str schema_name: + An optional schema name to qualify the table. + + :param float timeout: + Optional timeout value in seconds. + + The remaining keyword arguments are ``COPY`` statement options, + see `COPY statement documentation`_ for details. + + :return: The status string of the COPY command. + + Example: + + .. code-block:: pycon + + >>> import asyncpg + >>> import asyncio + >>> async def run(): + ... con = await asyncpg.connect(user='postgres') + ... result = await con.copy_from_table( + ... 'mytable', columns=('foo', 'bar'), + ... output='file.csv', format='csv') + ... print(result) + ... + >>> asyncio.get_event_loop().run_until_complete(run()) + 'COPY 100' + + .. _`COPY statement documentation`: + https://www.postgresql.org/docs/current/static/sql-copy.html + + .. versionadded:: 0.11.0 + """ + tabname = utils._quote_ident(table_name) + if schema_name: + tabname = utils._quote_ident(schema_name) + '.' + tabname + + if columns: + cols = '({})'.format( + ', '.join(utils._quote_ident(c) for c in columns)) + else: + cols = '' + + opts = self._format_copy_opts( + format=format, oids=oids, delimiter=delimiter, + null=null, header=header, quote=quote, escape=escape, + force_quote=force_quote, encoding=encoding + ) + + copy_stmt = 'COPY {tab}{cols} TO STDOUT {opts}'.format( + tab=tabname, cols=cols, opts=opts) + + return await self._copy_out(copy_stmt, output, timeout) + + async def copy_from_query(self, query, *args, output, + timeout=None, format=None, oids=None, + delimiter=None, null=None, header=None, + quote=None, escape=None, force_quote=None, + encoding=None): + """Copy the results of a query to a file or file-like object. + + :param str query: + The query to copy the results of. + + :param args: + Query arguments. + + :param output: + A :term:`path-like object `, + or a :term:`file-like object `, or + a :term:`coroutine function ` + that takes a ``bytes`` instance as a sole argument. + + :param float timeout: + Optional timeout value in seconds. + + The remaining keyword arguments are ``COPY`` statement options, + see `COPY statement documentation`_ for details. + + :return: The status string of the COPY command. + + Example: + + .. code-block:: pycon + + >>> import asyncpg + >>> import asyncio + >>> async def run(): + ... con = await asyncpg.connect(user='postgres') + ... result = await con.copy_from_query( + ... 'SELECT foo, bar FROM mytable WHERE foo > $1', 10, + ... output='file.csv', format='csv') + ... print(result) + ... + >>> asyncio.get_event_loop().run_until_complete(run()) + 'COPY 10' + + .. _`COPY statement documentation`: + https://www.postgresql.org/docs/current/static/sql-copy.html + + .. versionadded:: 0.11.0 + """ + opts = self._format_copy_opts( + format=format, oids=oids, delimiter=delimiter, + null=null, header=header, quote=quote, escape=escape, + force_quote=force_quote, encoding=encoding + ) + + if args: + query = await utils._mogrify(self, query, args) + + copy_stmt = 'COPY ({query}) TO STDOUT {opts}'.format( + query=query, opts=opts) + + return await self._copy_out(copy_stmt, output, timeout) + + async def copy_to_table(self, table_name, *, source, + columns=None, schema_name=None, timeout=None, + format=None, oids=None, freeze=None, + delimiter=None, null=None, header=None, + quote=None, escape=None, force_quote=None, + force_not_null=None, force_null=None, + encoding=None, where=None): + """Copy data to the specified table. + + :param str table_name: + The name of the table to copy data to. + + :param source: + A :term:`path-like object `, + or a :term:`file-like object `, or + an :term:`asynchronous iterable ` + that returns ``bytes``, or an object supporting the + :ref:`buffer protocol `. + + :param list columns: + An optional list of column names to copy. + + :param str schema_name: + An optional schema name to qualify the table. + + :param str where: + An optional SQL expression used to filter rows when copying. + + .. note:: + + Usage of this parameter requires support for the + ``COPY FROM ... WHERE`` syntax, introduced in + PostgreSQL version 12. + + :param float timeout: + Optional timeout value in seconds. + + The remaining keyword arguments are ``COPY`` statement options, + see `COPY statement documentation`_ for details. + + :return: The status string of the COPY command. + + Example: + + .. code-block:: pycon + + >>> import asyncpg + >>> import asyncio + >>> async def run(): + ... con = await asyncpg.connect(user='postgres') + ... result = await con.copy_to_table( + ... 'mytable', source='datafile.tbl') + ... print(result) + ... + >>> asyncio.get_event_loop().run_until_complete(run()) + 'COPY 140000' + + .. _`COPY statement documentation`: + https://www.postgresql.org/docs/current/static/sql-copy.html + + .. versionadded:: 0.11.0 + + .. versionadded:: 0.29.0 + Added the *where* parameter. + """ + tabname = utils._quote_ident(table_name) + if schema_name: + tabname = utils._quote_ident(schema_name) + '.' + tabname + + if columns: + cols = '({})'.format( + ', '.join(utils._quote_ident(c) for c in columns)) + else: + cols = '' + + cond = self._format_copy_where(where) + opts = self._format_copy_opts( + format=format, oids=oids, freeze=freeze, delimiter=delimiter, + null=null, header=header, quote=quote, escape=escape, + force_not_null=force_not_null, force_null=force_null, + encoding=encoding + ) + + copy_stmt = 'COPY {tab}{cols} FROM STDIN {opts} {cond}'.format( + tab=tabname, cols=cols, opts=opts, cond=cond) + + return await self._copy_in(copy_stmt, source, timeout) + + async def copy_records_to_table(self, table_name, *, records, + columns=None, schema_name=None, + timeout=None, where=None): + """Copy a list of records to the specified table using binary COPY. + + :param str table_name: + The name of the table to copy data to. + + :param records: + An iterable returning row tuples to copy into the table. + :term:`Asynchronous iterables ` + are also supported. + + :param list columns: + An optional list of column names to copy. + + :param str schema_name: + An optional schema name to qualify the table. + + :param str where: + An optional SQL expression used to filter rows when copying. + + .. note:: + + Usage of this parameter requires support for the + ``COPY FROM ... WHERE`` syntax, introduced in + PostgreSQL version 12. + + + :param float timeout: + Optional timeout value in seconds. + + :return: The status string of the COPY command. + + Example: + + .. code-block:: pycon + + >>> import asyncpg + >>> import asyncio + >>> async def run(): + ... con = await asyncpg.connect(user='postgres') + ... result = await con.copy_records_to_table( + ... 'mytable', records=[ + ... (1, 'foo', 'bar'), + ... (2, 'ham', 'spam')]) + ... print(result) + ... + >>> asyncio.get_event_loop().run_until_complete(run()) + 'COPY 2' + + Asynchronous record iterables are also supported: + + .. code-block:: pycon + + >>> import asyncpg + >>> import asyncio + >>> async def run(): + ... con = await asyncpg.connect(user='postgres') + ... async def record_gen(size): + ... for i in range(size): + ... yield (i,) + ... result = await con.copy_records_to_table( + ... 'mytable', records=record_gen(100)) + ... print(result) + ... + >>> asyncio.get_event_loop().run_until_complete(run()) + 'COPY 100' + + .. versionadded:: 0.11.0 + + .. versionchanged:: 0.24.0 + The ``records`` argument may be an asynchronous iterable. + + .. versionadded:: 0.29.0 + Added the *where* parameter. + """ + tabname = utils._quote_ident(table_name) + if schema_name: + tabname = utils._quote_ident(schema_name) + '.' + tabname + + if columns: + col_list = ', '.join(utils._quote_ident(c) for c in columns) + cols = '({})'.format(col_list) + else: + col_list = '*' + cols = '' + + intro_query = 'SELECT {cols} FROM {tab} LIMIT 1'.format( + tab=tabname, cols=col_list) + + intro_ps = await self._prepare(intro_query, use_cache=True) + + cond = self._format_copy_where(where) + opts = '(FORMAT binary)' + + copy_stmt = 'COPY {tab}{cols} FROM STDIN {opts} {cond}'.format( + tab=tabname, cols=cols, opts=opts, cond=cond) + + return await self._protocol.copy_in( + copy_stmt, None, None, records, intro_ps._state, timeout) + + def _format_copy_where(self, where): + if where and not self._server_caps.sql_copy_from_where: + raise exceptions.UnsupportedServerFeatureError( + 'the `where` parameter requires PostgreSQL 12 or later') + + if where: + where_clause = 'WHERE ' + where + else: + where_clause = '' + + return where_clause + + def _format_copy_opts(self, *, format=None, oids=None, freeze=None, + delimiter=None, null=None, header=None, quote=None, + escape=None, force_quote=None, force_not_null=None, + force_null=None, encoding=None): + kwargs = dict(locals()) + kwargs.pop('self') + opts = [] + + if force_quote is not None and isinstance(force_quote, bool): + kwargs.pop('force_quote') + if force_quote: + opts.append('FORCE_QUOTE *') + + for k, v in kwargs.items(): + if v is not None: + if k in ('force_not_null', 'force_null', 'force_quote'): + v = '(' + ', '.join(utils._quote_ident(c) for c in v) + ')' + elif k in ('oids', 'freeze', 'header'): + v = str(v) + else: + v = utils._quote_literal(v) + + opts.append('{} {}'.format(k.upper(), v)) + + if opts: + return '(' + ', '.join(opts) + ')' + else: + return '' + + async def _copy_out(self, copy_stmt, output, timeout): + try: + path = os.fspath(output) + except TypeError: + # output is not a path-like object + path = None + + writer = None + opened_by_us = False + run_in_executor = self._loop.run_in_executor + + if path is not None: + # a path + f = await run_in_executor(None, open, path, 'wb') + opened_by_us = True + elif hasattr(output, 'write'): + # file-like + f = output + elif callable(output): + # assuming calling output returns an awaitable. + writer = output + else: + raise TypeError( + 'output is expected to be a file-like object, ' + 'a path-like object or a coroutine function, ' + 'not {}'.format(type(output).__name__) + ) + + if writer is None: + async def _writer(data): + await run_in_executor(None, f.write, data) + writer = _writer + + try: + return await self._protocol.copy_out(copy_stmt, writer, timeout) + finally: + if opened_by_us: + f.close() + + async def _copy_in(self, copy_stmt, source, timeout): + try: + path = os.fspath(source) + except TypeError: + # source is not a path-like object + path = None + + f = None + reader = None + data = None + opened_by_us = False + run_in_executor = self._loop.run_in_executor + + if path is not None: + # a path + f = await run_in_executor(None, open, path, 'rb') + opened_by_us = True + elif hasattr(source, 'read'): + # file-like + f = source + elif isinstance(source, collections.abc.AsyncIterable): + # assuming calling output returns an awaitable. + # copy_in() is designed to handle very large amounts of data, and + # the source async iterable is allowed to return an arbitrary + # amount of data on every iteration. + reader = source + else: + # assuming source is an instance supporting the buffer protocol. + data = source + + if f is not None: + # Copying from a file-like object. + class _Reader: + def __aiter__(self): + return self + + async def __anext__(self): + data = await run_in_executor(None, f.read, 524288) + if len(data) == 0: + raise StopAsyncIteration + else: + return data + + reader = _Reader() + + try: + return await self._protocol.copy_in( + copy_stmt, reader, data, None, None, timeout) + finally: + if opened_by_us: + await run_in_executor(None, f.close) + + async def set_type_codec(self, typename, *, + schema='public', encoder, decoder, + format='text'): + """Set an encoder/decoder pair for the specified data type. + + :param typename: + Name of the data type the codec is for. + + :param schema: + Schema name of the data type the codec is for + (defaults to ``'public'``) + + :param format: + The type of the argument received by the *decoder* callback, + and the type of the *encoder* callback return value. + + If *format* is ``'text'`` (the default), the exchange datum is a + ``str`` instance containing valid text representation of the + data type. + + If *format* is ``'binary'``, the exchange datum is a ``bytes`` + instance containing valid _binary_ representation of the + data type. + + If *format* is ``'tuple'``, the exchange datum is a type-specific + ``tuple`` of values. The table below lists supported data + types and their format for this mode. + + +-----------------+---------------------------------------------+ + | Type | Tuple layout | + +=================+=============================================+ + | ``interval`` | (``months``, ``days``, ``microseconds``) | + +-----------------+---------------------------------------------+ + | ``date`` | (``date ordinal relative to Jan 1 2000``,) | + | | ``-2^31`` for negative infinity timestamp | + | | ``2^31-1`` for positive infinity timestamp. | + +-----------------+---------------------------------------------+ + | ``timestamp`` | (``microseconds relative to Jan 1 2000``,) | + | | ``-2^63`` for negative infinity timestamp | + | | ``2^63-1`` for positive infinity timestamp. | + +-----------------+---------------------------------------------+ + | ``timestamp | (``microseconds relative to Jan 1 2000 | + | with time zone``| UTC``,) | + | | ``-2^63`` for negative infinity timestamp | + | | ``2^63-1`` for positive infinity timestamp. | + +-----------------+---------------------------------------------+ + | ``time`` | (``microseconds``,) | + +-----------------+---------------------------------------------+ + | ``time with | (``microseconds``, | + | time zone`` | ``time zone offset in seconds``) | + +-----------------+---------------------------------------------+ + | any composite | Composite value elements | + | type | | + +-----------------+---------------------------------------------+ + + :param encoder: + Callable accepting a Python object as a single argument and + returning a value encoded according to *format*. + + :param decoder: + Callable accepting a single argument encoded according to *format* + and returning a decoded Python object. + + Example: + + .. code-block:: pycon + + >>> import asyncpg + >>> import asyncio + >>> import datetime + >>> from dateutil.relativedelta import relativedelta + >>> async def run(): + ... con = await asyncpg.connect(user='postgres') + ... def encoder(delta): + ... ndelta = delta.normalized() + ... return (ndelta.years * 12 + ndelta.months, + ... ndelta.days, + ... ((ndelta.hours * 3600 + + ... ndelta.minutes * 60 + + ... ndelta.seconds) * 1000000 + + ... ndelta.microseconds)) + ... def decoder(tup): + ... return relativedelta(months=tup[0], days=tup[1], + ... microseconds=tup[2]) + ... await con.set_type_codec( + ... 'interval', schema='pg_catalog', encoder=encoder, + ... decoder=decoder, format='tuple') + ... result = await con.fetchval( + ... "SELECT '2 years 3 mons 1 day'::interval") + ... print(result) + ... print(datetime.datetime(2002, 1, 1) + result) + ... + >>> asyncio.get_event_loop().run_until_complete(run()) + relativedelta(years=+2, months=+3, days=+1) + 2004-04-02 00:00:00 + + .. versionadded:: 0.12.0 + Added the ``format`` keyword argument and support for 'tuple' + format. + + .. versionchanged:: 0.12.0 + The ``binary`` keyword argument is deprecated in favor of + ``format``. + + .. versionchanged:: 0.13.0 + The ``binary`` keyword argument was removed in favor of + ``format``. + + .. versionchanged:: 0.29.0 + Custom codecs for composite types are now supported with + ``format='tuple'``. + + .. note:: + + It is recommended to use the ``'binary'`` or ``'tuple'`` *format* + whenever possible and if the underlying type supports it. Asyncpg + currently does not support text I/O for composite and range types, + and some other functionality, such as + :meth:`Connection.copy_to_table`, does not support types with text + codecs. + """ + self._check_open() + settings = self._protocol.get_settings() + typeinfo = await self._introspect_type(typename, schema) + full_typeinfos = [] + if introspection.is_scalar_type(typeinfo): + kind = 'scalar' + elif introspection.is_composite_type(typeinfo): + if format != 'tuple': + raise exceptions.UnsupportedClientFeatureError( + 'only tuple-format codecs can be used on composite types', + hint="Use `set_type_codec(..., format='tuple')` and " + "pass/interpret data as a Python tuple. See an " + "example at https://magicstack.github.io/asyncpg/" + "current/usage.html#example-decoding-complex-types", + ) + kind = 'composite' + full_typeinfos, _ = await self._introspect_types( + (typeinfo['oid'],), 10) + else: + raise exceptions.InterfaceError( + f'cannot use custom codec on type {schema}.{typename}: ' + f'it is neither a scalar type nor a composite type' + ) + if introspection.is_domain_type(typeinfo): + raise exceptions.UnsupportedClientFeatureError( + 'custom codecs on domain types are not supported', + hint='Set the codec on the base type.', + detail=( + 'PostgreSQL does not distinguish domains from ' + 'their base types in query results at the protocol level.' + ) + ) + + oid = typeinfo['oid'] + settings.add_python_codec( + oid, typename, schema, full_typeinfos, kind, + encoder, decoder, format) + + # Statement cache is no longer valid due to codec changes. + self._drop_local_statement_cache() + + async def reset_type_codec(self, typename, *, schema='public'): + """Reset *typename* codec to the default implementation. + + :param typename: + Name of the data type the codec is for. + + :param schema: + Schema name of the data type the codec is for + (defaults to ``'public'``) + + .. versionadded:: 0.12.0 + """ + + typeinfo = await self._introspect_type(typename, schema) + self._protocol.get_settings().remove_python_codec( + typeinfo['oid'], typename, schema) + + # Statement cache is no longer valid due to codec changes. + self._drop_local_statement_cache() + + async def set_builtin_type_codec(self, typename, *, + schema='public', codec_name, + format=None): + """Set a builtin codec for the specified scalar data type. + + This method has two uses. The first is to register a builtin + codec for an extension type without a stable OID, such as 'hstore'. + The second use is to declare that an extension type or a + user-defined type is wire-compatible with a certain builtin + data type and should be exchanged as such. + + :param typename: + Name of the data type the codec is for. + + :param schema: + Schema name of the data type the codec is for + (defaults to ``'public'``). + + :param codec_name: + The name of the builtin codec to use for the type. + This should be either the name of a known core type + (such as ``"int"``), or the name of a supported extension + type. Currently, the only supported extension type is + ``"pg_contrib.hstore"``. + + :param format: + If *format* is ``None`` (the default), all formats supported + by the target codec are declared to be supported for *typename*. + If *format* is ``'text'`` or ``'binary'``, then only the + specified format is declared to be supported for *typename*. + + .. versionchanged:: 0.18.0 + The *codec_name* argument can be the name of any known + core data type. Added the *format* keyword argument. + """ + self._check_open() + typeinfo = await self._introspect_type(typename, schema) + if not introspection.is_scalar_type(typeinfo): + raise exceptions.InterfaceError( + 'cannot alias non-scalar type {}.{}'.format( + schema, typename)) + + oid = typeinfo['oid'] + + self._protocol.get_settings().set_builtin_type_codec( + oid, typename, schema, 'scalar', codec_name, format) + + # Statement cache is no longer valid due to codec changes. + self._drop_local_statement_cache() + + def is_closed(self): + """Return ``True`` if the connection is closed, ``False`` otherwise. + + :return bool: ``True`` if the connection is closed, ``False`` + otherwise. + """ + return self._aborted or not self._protocol.is_connected() + + async def close(self, *, timeout=None): + """Close the connection gracefully. + + :param float timeout: + Optional timeout value in seconds. + + .. versionchanged:: 0.14.0 + Added the *timeout* parameter. + """ + try: + if not self.is_closed(): + await self._protocol.close(timeout) + except (Exception, asyncio.CancelledError): + # If we fail to close gracefully, abort the connection. + self._abort() + raise + finally: + self._cleanup() + + def terminate(self): + """Terminate the connection without waiting for pending data.""" + if not self.is_closed(): + self._abort() + self._cleanup() + + async def reset(self, *, timeout=None): + self._check_open() + self._listeners.clear() + self._log_listeners.clear() + reset_query = self._get_reset_query() + + if self._protocol.is_in_transaction() or self._top_xact is not None: + if self._top_xact is None or not self._top_xact._managed: + # Managed transactions are guaranteed to __aexit__ + # correctly. + self._loop.call_exception_handler({ + 'message': 'Resetting connection with an ' + 'active transaction {!r}'.format(self) + }) + + self._top_xact = None + reset_query = 'ROLLBACK;\n' + reset_query + + if reset_query: + await self.execute(reset_query, timeout=timeout) + + def _abort(self): + # Put the connection into the aborted state. + self._aborted = True + self._protocol.abort() + self._protocol = None + + def _cleanup(self): + self._call_termination_listeners() + # Free the resources associated with this connection. + # This must be called when a connection is terminated. + + if self._proxy is not None: + # Connection is a member of a pool, so let the pool + # know that this connection is dead. + self._proxy._holder._release_on_close() + + self._mark_stmts_as_closed() + self._listeners.clear() + self._log_listeners.clear() + self._query_loggers.clear() + self._clean_tasks() + + def _clean_tasks(self): + # Wrap-up any remaining tasks associated with this connection. + if self._cancellations: + for fut in self._cancellations: + if not fut.done(): + fut.cancel() + self._cancellations.clear() + + def _check_open(self): + if self.is_closed(): + raise exceptions.InterfaceError('connection is closed') + + def _get_unique_id(self, prefix): + global _uid + _uid += 1 + return '__asyncpg_{}_{:x}__'.format(prefix, _uid) + + def _mark_stmts_as_closed(self): + for stmt in self._stmt_cache.iter_statements(): + stmt.mark_closed() + + for stmt in self._stmts_to_close: + stmt.mark_closed() + + self._stmt_cache.clear() + self._stmts_to_close.clear() + + def _maybe_gc_stmt(self, stmt): + if ( + stmt.refs == 0 + and stmt.name + and not self._stmt_cache.has( + (stmt.query, stmt.record_class, stmt.ignore_custom_codec) + ) + ): + # If low-level `stmt` isn't referenced from any high-level + # `PreparedStatement` object and is not in the `_stmt_cache`: + # + # * mark it as closed, which will make it non-usable + # for any `PreparedStatement` or for methods like + # `Connection.fetch()`. + # + # * schedule it to be formally closed on the server. + stmt.mark_closed() + self._stmts_to_close.add(stmt) + + async def _cleanup_stmts(self): + # Called whenever we create a new prepared statement in + # `Connection._get_statement()` and `_stmts_to_close` is + # not empty. + to_close = self._stmts_to_close + self._stmts_to_close = set() + for stmt in to_close: + # It is imperative that statements are cleaned properly, + # so we ignore the timeout. + await self._protocol.close_statement(stmt, protocol.NO_TIMEOUT) + + async def _cancel(self, waiter): + try: + # Open new connection to the server + await connect_utils._cancel( + loop=self._loop, addr=self._addr, params=self._params, + backend_pid=self._protocol.backend_pid, + backend_secret=self._protocol.backend_secret) + except ConnectionResetError as ex: + # On some systems Postgres will reset the connection + # after processing the cancellation command. + if not waiter.done(): + waiter.set_exception(ex) + except asyncio.CancelledError: + # There are two scenarios in which the cancellation + # itself will be cancelled: 1) the connection is being closed, + # 2) the event loop is being shut down. + # In either case we do not care about the propagation of + # the CancelledError, and don't want the loop to warn about + # an unretrieved exception. + pass + except (Exception, asyncio.CancelledError) as ex: + if not waiter.done(): + waiter.set_exception(ex) + finally: + self._cancellations.discard( + asyncio.current_task(self._loop)) + if not waiter.done(): + waiter.set_result(None) + + def _cancel_current_command(self, waiter): + self._cancellations.add(self._loop.create_task(self._cancel(waiter))) + + def _process_log_message(self, fields, last_query): + if not self._log_listeners: + return + + message = exceptions.PostgresLogMessage.new(fields, query=last_query) + + con_ref = self._unwrap() + for cb in self._log_listeners: + if cb.is_async: + self._loop.create_task(cb.cb(con_ref, message)) + else: + self._loop.call_soon(cb.cb, con_ref, message) + + def _call_termination_listeners(self): + if not self._termination_listeners: + return + + con_ref = self._unwrap() + for cb in self._termination_listeners: + if cb.is_async: + self._loop.create_task(cb.cb(con_ref)) + else: + self._loop.call_soon(cb.cb, con_ref) + + self._termination_listeners.clear() + + def _process_notification(self, pid, channel, payload): + if channel not in self._listeners: + return + + con_ref = self._unwrap() + for cb in self._listeners[channel]: + if cb.is_async: + self._loop.create_task(cb.cb(con_ref, pid, channel, payload)) + else: + self._loop.call_soon(cb.cb, con_ref, pid, channel, payload) + + def _unwrap(self): + if self._proxy is None: + con_ref = self + else: + # `_proxy` is not None when the connection is a member + # of a connection pool. Which means that the user is working + # with a `PoolConnectionProxy` instance, and expects to see it + # (and not the actual Connection) in their event callbacks. + con_ref = self._proxy + return con_ref + + def _get_reset_query(self): + if self._reset_query is not None: + return self._reset_query + + caps = self._server_caps + + _reset_query = [] + if caps.advisory_locks: + _reset_query.append('SELECT pg_advisory_unlock_all();') + if caps.sql_close_all: + _reset_query.append('CLOSE ALL;') + if caps.notifications and caps.plpgsql: + _reset_query.append('UNLISTEN *;') + if caps.sql_reset: + _reset_query.append('RESET ALL;') + + _reset_query = '\n'.join(_reset_query) + self._reset_query = _reset_query + + return _reset_query + + def _set_proxy(self, proxy): + if self._proxy is not None and proxy is not None: + # Should not happen unless there is a bug in `Pool`. + raise exceptions.InterfaceError( + 'internal asyncpg error: connection is already proxied') + + self._proxy = proxy + + def _check_listeners(self, listeners, listener_type): + if listeners: + count = len(listeners) + + w = exceptions.InterfaceWarning( + '{conn!r} is being released to the pool but has {c} active ' + '{type} listener{s}'.format( + conn=self, c=count, type=listener_type, + s='s' if count > 1 else '')) + + warnings.warn(w) + + def _on_release(self, stacklevel=1): + # Invalidate external references to the connection. + self._pool_release_ctr += 1 + # Called when the connection is about to be released to the pool. + # Let's check that the user has not left any listeners on it. + self._check_listeners( + list(itertools.chain.from_iterable(self._listeners.values())), + 'notification') + self._check_listeners( + self._log_listeners, 'log') + + def _drop_local_statement_cache(self): + self._stmt_cache.clear() + + def _drop_global_statement_cache(self): + if self._proxy is not None: + # This connection is a member of a pool, so we delegate + # the cache drop to the pool. + pool = self._proxy._holder._pool + pool._drop_statement_cache() + else: + self._drop_local_statement_cache() + + def _drop_local_type_cache(self): + self._protocol.get_settings().clear_type_cache() + + def _drop_global_type_cache(self): + if self._proxy is not None: + # This connection is a member of a pool, so we delegate + # the cache drop to the pool. + pool = self._proxy._holder._pool + pool._drop_type_cache() + else: + self._drop_local_type_cache() + + async def reload_schema_state(self): + """Indicate that the database schema information must be reloaded. + + For performance reasons, asyncpg caches certain aspects of the + database schema, such as the layout of composite types. Consequently, + when the database schema changes, and asyncpg is not able to + gracefully recover from an error caused by outdated schema + assumptions, an :exc:`~asyncpg.exceptions.OutdatedSchemaCacheError` + is raised. To prevent the exception, this method may be used to inform + asyncpg that the database schema has changed. + + Example: + + .. code-block:: pycon + + >>> import asyncpg + >>> import asyncio + >>> async def change_type(con): + ... result = await con.fetch('SELECT id, info FROM tbl') + ... # Change composite's attribute type "int"=>"text" + ... await con.execute('ALTER TYPE custom DROP ATTRIBUTE y') + ... await con.execute('ALTER TYPE custom ADD ATTRIBUTE y text') + ... await con.reload_schema_state() + ... for id_, info in result: + ... new = (info['x'], str(info['y'])) + ... await con.execute( + ... 'UPDATE tbl SET info=$2 WHERE id=$1', id_, new) + ... + >>> async def run(): + ... # Initial schema: + ... # CREATE TYPE custom AS (x int, y int); + ... # CREATE TABLE tbl(id int, info custom); + ... con = await asyncpg.connect(user='postgres') + ... async with con.transaction(): + ... # Prevent concurrent changes in the table + ... await con.execute('LOCK TABLE tbl') + ... await change_type(con) + ... + >>> asyncio.get_event_loop().run_until_complete(run()) + + .. versionadded:: 0.14.0 + """ + self._drop_global_type_cache() + self._drop_global_statement_cache() + + async def _execute( + self, + query, + args, + limit, + timeout, + *, + return_status=False, + ignore_custom_codec=False, + record_class=None + ): + with self._stmt_exclusive_section: + result, _ = await self.__execute( + query, + args, + limit, + timeout, + return_status=return_status, + record_class=record_class, + ignore_custom_codec=ignore_custom_codec, + ) + return result + + @contextlib.contextmanager + def query_logger(self, callback): + """Context manager that adds `callback` to the list of query loggers, + and removes it upon exit. + + :param callable callback: + A callable or a coroutine function receiving one argument: + **record**: a LoggedQuery containing `query`, `args`, `timeout`, + `elapsed`, `exception`, `conn_addr`, and + `conn_params`. + + Example: + + .. code-block:: pycon + + >>> class QuerySaver: + def __init__(self): + self.queries = [] + def __call__(self, record): + self.queries.append(record.query) + >>> with con.query_logger(QuerySaver()): + >>> await con.execute("SELECT 1") + >>> print(log.queries) + ['SELECT 1'] + + .. versionadded:: 0.29.0 + """ + self.add_query_logger(callback) + yield + self.remove_query_logger(callback) + + @contextlib.contextmanager + def _time_and_log(self, query, args, timeout): + start = time.monotonic() + exception = None + try: + yield + except BaseException as ex: + exception = ex + raise + finally: + elapsed = time.monotonic() - start + record = LoggedQuery( + query=query, + args=args, + timeout=timeout, + elapsed=elapsed, + exception=exception, + conn_addr=self._addr, + conn_params=self._params, + ) + for cb in self._query_loggers: + if cb.is_async: + self._loop.create_task(cb.cb(record)) + else: + self._loop.call_soon(cb.cb, record) + + async def __execute( + self, + query, + args, + limit, + timeout, + *, + return_status=False, + ignore_custom_codec=False, + record_class=None + ): + executor = lambda stmt, timeout: self._protocol.bind_execute( + state=stmt, + args=args, + portal_name='', + limit=limit, + return_extra=return_status, + timeout=timeout, + ) + timeout = self._protocol._get_timeout(timeout) + if self._query_loggers: + with self._time_and_log(query, args, timeout): + result, stmt = await self._do_execute( + query, + executor, + timeout, + record_class=record_class, + ignore_custom_codec=ignore_custom_codec, + ) + else: + result, stmt = await self._do_execute( + query, + executor, + timeout, + record_class=record_class, + ignore_custom_codec=ignore_custom_codec, + ) + return result, stmt + + async def _executemany(self, query, args, timeout): + executor = lambda stmt, timeout: self._protocol.bind_execute_many( + state=stmt, + args=args, + portal_name='', + timeout=timeout, + ) + timeout = self._protocol._get_timeout(timeout) + with self._stmt_exclusive_section: + with self._time_and_log(query, args, timeout): + result, _ = await self._do_execute(query, executor, timeout) + return result + + async def _do_execute( + self, + query, + executor, + timeout, + retry=True, + *, + ignore_custom_codec=False, + record_class=None + ): + if timeout is None: + stmt = await self._get_statement( + query, + None, + record_class=record_class, + ignore_custom_codec=ignore_custom_codec, + ) + else: + before = time.monotonic() + stmt = await self._get_statement( + query, + timeout, + record_class=record_class, + ignore_custom_codec=ignore_custom_codec, + ) + after = time.monotonic() + timeout -= after - before + before = after + + try: + if timeout is None: + result = await executor(stmt, None) + else: + try: + result = await executor(stmt, timeout) + finally: + after = time.monotonic() + timeout -= after - before + + except exceptions.OutdatedSchemaCacheError: + # This exception is raised when we detect a difference between + # cached type's info and incoming tuple from the DB (when a type is + # changed by the ALTER TYPE). + # It is not possible to recover (the statement is already done at + # the server's side), the only way is to drop our caches and + # reraise the exception to the caller. + await self.reload_schema_state() + raise + except exceptions.InvalidCachedStatementError: + # PostgreSQL will raise an exception when it detects + # that the result type of the query has changed from + # when the statement was prepared. This may happen, + # for example, after an ALTER TABLE or SET search_path. + # + # When this happens, and there is no transaction running, + # we can simply re-prepare the statement and try once + # again. We deliberately retry only once as this is + # supposed to be a rare occurrence. + # + # If the transaction _is_ running, this error will put it + # into an error state, and we have no choice but to + # re-raise the exception. + # + # In either case we clear the statement cache for this + # connection and all other connections of the pool this + # connection belongs to (if any). + # + # See https://github.com/MagicStack/asyncpg/issues/72 + # and https://github.com/MagicStack/asyncpg/issues/76 + # for discussion. + # + self._drop_global_statement_cache() + if self._protocol.is_in_transaction() or not retry: + raise + else: + return await self._do_execute( + query, executor, timeout, retry=False) + + return result, stmt + + +async def connect(dsn=None, *, + host=None, port=None, + user=None, password=None, passfile=None, + database=None, + loop=None, + timeout=60, + statement_cache_size=100, + max_cached_statement_lifetime=300, + max_cacheable_statement_size=1024 * 15, + command_timeout=None, + ssl=None, + direct_tls=False, + connection_class=Connection, + record_class=protocol.Record, + server_settings=None, + target_session_attrs=None): + r"""A coroutine to establish a connection to a PostgreSQL server. + + The connection parameters may be specified either as a connection + URI in *dsn*, or as specific keyword arguments, or both. + If both *dsn* and keyword arguments are specified, the latter + override the corresponding values parsed from the connection URI. + The default values for the majority of arguments can be specified + using `environment variables `_. + + Returns a new :class:`~asyncpg.connection.Connection` object. + + :param dsn: + Connection arguments specified using as a single string in the + `libpq connection URI format`_: + ``postgres://user:password@host:port/database?option=value``. + The following options are recognized by asyncpg: ``host``, + ``port``, ``user``, ``database`` (or ``dbname``), ``password``, + ``passfile``, ``sslmode``, ``sslcert``, ``sslkey``, ``sslrootcert``, + and ``sslcrl``. Unlike libpq, asyncpg will treat unrecognized + options as `server settings`_ to be used for the connection. + + .. note:: + + The URI must be *valid*, which means that all components must + be properly quoted with :py:func:`urllib.parse.quote`, and + any literal IPv6 addresses must be enclosed in square brackets. + For example: + + .. code-block:: text + + postgres://dbuser@[fe80::1ff:fe23:4567:890a%25eth0]/dbname + + :param host: + Database host address as one of the following: + + - an IP address or a domain name; + - an absolute path to the directory containing the database + server Unix-domain socket (not supported on Windows); + - a sequence of any of the above, in which case the addresses + will be tried in order, and the first successful connection + will be returned. + + If not specified, asyncpg will try the following, in order: + + - host address(es) parsed from the *dsn* argument, + - the value of the ``PGHOST`` environment variable, + - on Unix, common directories used for PostgreSQL Unix-domain + sockets: ``"/run/postgresql"``, ``"/var/run/postgresl"``, + ``"/var/pgsql_socket"``, ``"/private/tmp"``, and ``"/tmp"``, + - ``"localhost"``. + + :param port: + Port number to connect to at the server host + (or Unix-domain socket file extension). If multiple host + addresses were specified, this parameter may specify a + sequence of port numbers of the same length as the host sequence, + or it may specify a single port number to be used for all host + addresses. + + If not specified, the value parsed from the *dsn* argument is used, + or the value of the ``PGPORT`` environment variable, or ``5432`` if + neither is specified. + + :param user: + The name of the database role used for authentication. + + If not specified, the value parsed from the *dsn* argument is used, + or the value of the ``PGUSER`` environment variable, or the + operating system name of the user running the application. + + :param database: + The name of the database to connect to. + + If not specified, the value parsed from the *dsn* argument is used, + or the value of the ``PGDATABASE`` environment variable, or the + computed value of the *user* argument. + + :param password: + Password to be used for authentication, if the server requires + one. If not specified, the value parsed from the *dsn* argument + is used, or the value of the ``PGPASSWORD`` environment variable. + Note that the use of the environment variable is discouraged as + other users and applications may be able to read it without needing + specific privileges. It is recommended to use *passfile* instead. + + Password may be either a string, or a callable that returns a string. + If a callable is provided, it will be called each time a new connection + is established. + + :param passfile: + The name of the file used to store passwords + (defaults to ``~/.pgpass``, or ``%APPDATA%\postgresql\pgpass.conf`` + on Windows). + + :param loop: + An asyncio event loop instance. If ``None``, the default + event loop will be used. + + :param float timeout: + Connection timeout in seconds. + + :param int statement_cache_size: + The size of prepared statement LRU cache. Pass ``0`` to + disable the cache. + + :param int max_cached_statement_lifetime: + The maximum time in seconds a prepared statement will stay + in the cache. Pass ``0`` to allow statements be cached + indefinitely. + + :param int max_cacheable_statement_size: + The maximum size of a statement that can be cached (15KiB by + default). Pass ``0`` to allow all statements to be cached + regardless of their size. + + :param float command_timeout: + The default timeout for operations on this connection + (the default is ``None``: no timeout). + + :param ssl: + Pass ``True`` or an `ssl.SSLContext `_ instance to + require an SSL connection. If ``True``, a default SSL context + returned by `ssl.create_default_context() `_ + will be used. The value can also be one of the following strings: + + - ``'disable'`` - SSL is disabled (equivalent to ``False``) + - ``'prefer'`` - try SSL first, fallback to non-SSL connection + if SSL connection fails + - ``'allow'`` - try without SSL first, then retry with SSL if the first + attempt fails. + - ``'require'`` - only try an SSL connection. Certificate + verification errors are ignored + - ``'verify-ca'`` - only try an SSL connection, and verify + that the server certificate is issued by a trusted certificate + authority (CA) + - ``'verify-full'`` - only try an SSL connection, verify + that the server certificate is issued by a trusted CA and + that the requested server host name matches that in the + certificate. + + The default is ``'prefer'``: try an SSL connection and fallback to + non-SSL connection if that fails. + + .. note:: + + *ssl* is ignored for Unix domain socket communication. + + Example of programmatic SSL context configuration that is equivalent + to ``sslmode=verify-full&sslcert=..&sslkey=..&sslrootcert=..``: + + .. code-block:: pycon + + >>> import asyncpg + >>> import asyncio + >>> import ssl + >>> async def main(): + ... # Load CA bundle for server certificate verification, + ... # equivalent to sslrootcert= in DSN. + ... sslctx = ssl.create_default_context( + ... ssl.Purpose.SERVER_AUTH, + ... cafile="path/to/ca_bundle.pem") + ... # If True, equivalent to sslmode=verify-full, if False: + ... # sslmode=verify-ca. + ... sslctx.check_hostname = True + ... # Load client certificate and private key for client + ... # authentication, equivalent to sslcert= and sslkey= in + ... # DSN. + ... sslctx.load_cert_chain( + ... "path/to/client.cert", + ... keyfile="path/to/client.key", + ... ) + ... con = await asyncpg.connect(user='postgres', ssl=sslctx) + ... await con.close() + >>> asyncio.run(main()) + + Example of programmatic SSL context configuration that is equivalent + to ``sslmode=require`` (no server certificate or host verification): + + .. code-block:: pycon + + >>> import asyncpg + >>> import asyncio + >>> import ssl + >>> async def main(): + ... sslctx = ssl.create_default_context( + ... ssl.Purpose.SERVER_AUTH) + ... sslctx.check_hostname = False + ... sslctx.verify_mode = ssl.CERT_NONE + ... con = await asyncpg.connect(user='postgres', ssl=sslctx) + ... await con.close() + >>> asyncio.run(main()) + + :param bool direct_tls: + Pass ``True`` to skip PostgreSQL STARTTLS mode and perform a direct + SSL connection. Must be used alongside ``ssl`` param. + + :param dict server_settings: + An optional dict of server runtime parameters. Refer to + PostgreSQL documentation for + a `list of supported options `_. + + :param type connection_class: + Class of the returned connection object. Must be a subclass of + :class:`~asyncpg.connection.Connection`. + + :param type record_class: + If specified, the class to use for records returned by queries on + this connection object. Must be a subclass of + :class:`~asyncpg.Record`. + + :param SessionAttribute target_session_attrs: + If specified, check that the host has the correct attribute. + Can be one of: + + - ``"any"`` - the first successfully connected host + - ``"primary"`` - the host must NOT be in hot standby mode + - ``"standby"`` - the host must be in hot standby mode + - ``"read-write"`` - the host must allow writes + - ``"read-only"`` - the host most NOT allow writes + - ``"prefer-standby"`` - first try to find a standby host, but if + none of the listed hosts is a standby server, + return any of them. + + If not specified, the value parsed from the *dsn* argument is used, + or the value of the ``PGTARGETSESSIONATTRS`` environment variable, + or ``"any"`` if neither is specified. + + :return: A :class:`~asyncpg.connection.Connection` instance. + + Example: + + .. code-block:: pycon + + >>> import asyncpg + >>> import asyncio + >>> async def run(): + ... con = await asyncpg.connect(user='postgres') + ... types = await con.fetch('SELECT * FROM pg_type') + ... print(types) + ... + >>> asyncio.get_event_loop().run_until_complete(run()) + [= 0 + self._max_size = new_size + self._maybe_cleanup() + + def get_max_lifetime(self): + return self._max_lifetime + + def set_max_lifetime(self, new_lifetime): + assert new_lifetime >= 0 + self._max_lifetime = new_lifetime + for entry in self._entries.values(): + # For every entry cancel the existing callback + # and setup a new one if necessary. + self._set_entry_timeout(entry) + + def get(self, query, *, promote=True): + if not self._max_size: + # The cache is disabled. + return + + entry = self._entries.get(query) # type: _StatementCacheEntry + if entry is None: + return + + if entry._statement.closed: + # Happens in unittests when we call `stmt._state.mark_closed()` + # manually or when a prepared statement closes itself on type + # cache error. + self._entries.pop(query) + self._clear_entry_callback(entry) + return + + if promote: + # `promote` is `False` when `get()` is called by `has()`. + self._entries.move_to_end(query, last=True) + + return entry._statement + + def has(self, query): + return self.get(query, promote=False) is not None + + def put(self, query, statement): + if not self._max_size: + # The cache is disabled. + return + + self._entries[query] = self._new_entry(query, statement) + + # Check if the cache is bigger than max_size and trim it + # if necessary. + self._maybe_cleanup() + + def iter_statements(self): + return (e._statement for e in self._entries.values()) + + def clear(self): + # Store entries for later. + entries = tuple(self._entries.values()) + + # Clear the entries dict. + self._entries.clear() + + # Make sure that we cancel all scheduled callbacks + # and call on_remove callback for each entry. + for entry in entries: + self._clear_entry_callback(entry) + self._on_remove(entry._statement) + + def _set_entry_timeout(self, entry): + # Clear the existing timeout. + self._clear_entry_callback(entry) + + # Set the new timeout if it's not 0. + if self._max_lifetime: + entry._cleanup_cb = self._loop.call_later( + self._max_lifetime, self._on_entry_expired, entry) + + def _new_entry(self, query, statement): + entry = _StatementCacheEntry(self, query, statement) + self._set_entry_timeout(entry) + return entry + + def _on_entry_expired(self, entry): + # `call_later` callback, called when an entry stayed longer + # than `self._max_lifetime`. + if self._entries.get(entry._query) is entry: + self._entries.pop(entry._query) + self._on_remove(entry._statement) + + def _clear_entry_callback(self, entry): + if entry._cleanup_cb is not None: + entry._cleanup_cb.cancel() + + def _maybe_cleanup(self): + # Delete cache entries until the size of the cache is `max_size`. + while len(self._entries) > self._max_size: + old_query, old_entry = self._entries.popitem(last=False) + self._clear_entry_callback(old_entry) + + # Let the connection know that the statement was removed + # from the cache. + self._on_remove(old_entry._statement) + + +class _Callback(typing.NamedTuple): + + cb: typing.Callable[..., None] + is_async: bool + + @classmethod + def from_callable(cls, cb: typing.Callable[..., None]) -> '_Callback': + if inspect.iscoroutinefunction(cb): + is_async = True + elif callable(cb): + is_async = False + else: + raise exceptions.InterfaceError( + 'expected a callable or an `async def` function,' + 'got {!r}'.format(cb) + ) + + return cls(cb, is_async) + + +class _Atomic: + __slots__ = ('_acquired',) + + def __init__(self): + self._acquired = 0 + + def __enter__(self): + if self._acquired: + raise exceptions.InterfaceError( + 'cannot perform operation: another operation is in progress') + self._acquired = 1 + + def __exit__(self, t, e, tb): + self._acquired = 0 + + +class _ConnectionProxy: + # Base class to enable `isinstance(Connection)` check. + __slots__ = () + + +LoggedQuery = collections.namedtuple( + 'LoggedQuery', + ['query', 'args', 'timeout', 'elapsed', 'exception', 'conn_addr', + 'conn_params']) +LoggedQuery.__doc__ = 'Log record of an executed query.' + + +ServerCapabilities = collections.namedtuple( + 'ServerCapabilities', + ['advisory_locks', 'notifications', 'plpgsql', 'sql_reset', + 'sql_close_all', 'sql_copy_from_where', 'jit']) +ServerCapabilities.__doc__ = 'PostgreSQL server capabilities.' + + +def _detect_server_capabilities(server_version, connection_settings): + if hasattr(connection_settings, 'padb_revision'): + # Amazon Redshift detected. + advisory_locks = False + notifications = False + plpgsql = False + sql_reset = True + sql_close_all = False + jit = False + sql_copy_from_where = False + elif hasattr(connection_settings, 'crdb_version'): + # CockroachDB detected. + advisory_locks = False + notifications = False + plpgsql = False + sql_reset = False + sql_close_all = False + jit = False + sql_copy_from_where = False + elif hasattr(connection_settings, 'crate_version'): + # CrateDB detected. + advisory_locks = False + notifications = False + plpgsql = False + sql_reset = False + sql_close_all = False + jit = False + sql_copy_from_where = False + else: + # Standard PostgreSQL server assumed. + advisory_locks = True + notifications = True + plpgsql = True + sql_reset = True + sql_close_all = True + jit = server_version >= (11, 0) + sql_copy_from_where = server_version.major >= 12 + + return ServerCapabilities( + advisory_locks=advisory_locks, + notifications=notifications, + plpgsql=plpgsql, + sql_reset=sql_reset, + sql_close_all=sql_close_all, + sql_copy_from_where=sql_copy_from_where, + jit=jit, + ) + + +def _extract_stack(limit=10): + """Replacement for traceback.extract_stack() that only does the + necessary work for asyncio debug mode. + """ + frame = sys._getframe().f_back + try: + stack = traceback.StackSummary.extract( + traceback.walk_stack(frame), lookup_lines=False) + finally: + del frame + + apg_path = asyncpg.__path__[0] + i = 0 + while i < len(stack) and stack[i][0].startswith(apg_path): + i += 1 + stack = stack[i:i + limit] + + stack.reverse() + return ''.join(traceback.format_list(stack)) + + +def _check_record_class(record_class): + if record_class is protocol.Record: + pass + elif ( + isinstance(record_class, type) + and issubclass(record_class, protocol.Record) + ): + if ( + record_class.__new__ is not object.__new__ + or record_class.__init__ is not object.__init__ + ): + raise exceptions.InterfaceError( + 'record_class must not redefine __new__ or __init__' + ) + else: + raise exceptions.InterfaceError( + 'record_class is expected to be a subclass of ' + 'asyncpg.Record, got {!r}'.format(record_class) + ) + + +def _weak_maybe_gc_stmt(weak_ref, stmt): + self = weak_ref() + if self is not None: + self._maybe_gc_stmt(stmt) + + +_uid = 0 diff --git a/env/Lib/site-packages/asyncpg/connresource.py b/env/Lib/site-packages/asyncpg/connresource.py new file mode 100644 index 0000000..3b0c1d3 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/connresource.py @@ -0,0 +1,44 @@ + +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import functools + +from . import exceptions + + +def guarded(meth): + """A decorator to add a sanity check to ConnectionResource methods.""" + + @functools.wraps(meth) + def _check(self, *args, **kwargs): + self._check_conn_validity(meth.__name__) + return meth(self, *args, **kwargs) + + return _check + + +class ConnectionResource: + __slots__ = ('_connection', '_con_release_ctr') + + def __init__(self, connection): + self._connection = connection + self._con_release_ctr = connection._pool_release_ctr + + def _check_conn_validity(self, meth_name): + con_release_ctr = self._connection._pool_release_ctr + if con_release_ctr != self._con_release_ctr: + raise exceptions.InterfaceError( + 'cannot call {}.{}(): ' + 'the underlying connection has been released back ' + 'to the pool'.format(self.__class__.__name__, meth_name)) + + if self._connection.is_closed(): + raise exceptions.InterfaceError( + 'cannot call {}.{}(): ' + 'the underlying connection is closed'.format( + self.__class__.__name__, meth_name)) diff --git a/env/Lib/site-packages/asyncpg/cursor.py b/env/Lib/site-packages/asyncpg/cursor.py new file mode 100644 index 0000000..b4abeed --- /dev/null +++ b/env/Lib/site-packages/asyncpg/cursor.py @@ -0,0 +1,323 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import collections + +from . import connresource +from . import exceptions + + +class CursorFactory(connresource.ConnectionResource): + """A cursor interface for the results of a query. + + A cursor interface can be used to initiate efficient traversal of the + results of a large query. + """ + + __slots__ = ( + '_state', + '_args', + '_prefetch', + '_query', + '_timeout', + '_record_class', + ) + + def __init__( + self, + connection, + query, + state, + args, + prefetch, + timeout, + record_class + ): + super().__init__(connection) + self._args = args + self._prefetch = prefetch + self._query = query + self._timeout = timeout + self._state = state + self._record_class = record_class + if state is not None: + state.attach() + + @connresource.guarded + def __aiter__(self): + prefetch = 50 if self._prefetch is None else self._prefetch + return CursorIterator( + self._connection, + self._query, + self._state, + self._args, + self._record_class, + prefetch, + self._timeout, + ) + + @connresource.guarded + def __await__(self): + if self._prefetch is not None: + raise exceptions.InterfaceError( + 'prefetch argument can only be specified for iterable cursor') + cursor = Cursor( + self._connection, + self._query, + self._state, + self._args, + self._record_class, + ) + return cursor._init(self._timeout).__await__() + + def __del__(self): + if self._state is not None: + self._state.detach() + self._connection._maybe_gc_stmt(self._state) + + +class BaseCursor(connresource.ConnectionResource): + + __slots__ = ( + '_state', + '_args', + '_portal_name', + '_exhausted', + '_query', + '_record_class', + ) + + def __init__(self, connection, query, state, args, record_class): + super().__init__(connection) + self._args = args + self._state = state + if state is not None: + state.attach() + self._portal_name = None + self._exhausted = False + self._query = query + self._record_class = record_class + + def _check_ready(self): + if self._state is None: + raise exceptions.InterfaceError( + 'cursor: no associated prepared statement') + + if self._state.closed: + raise exceptions.InterfaceError( + 'cursor: the prepared statement is closed') + + if not self._connection._top_xact: + raise exceptions.NoActiveSQLTransactionError( + 'cursor cannot be created outside of a transaction') + + async def _bind_exec(self, n, timeout): + self._check_ready() + + if self._portal_name: + raise exceptions.InterfaceError( + 'cursor already has an open portal') + + con = self._connection + protocol = con._protocol + + self._portal_name = con._get_unique_id('portal') + buffer, _, self._exhausted = await protocol.bind_execute( + self._state, self._args, self._portal_name, n, True, timeout) + return buffer + + async def _bind(self, timeout): + self._check_ready() + + if self._portal_name: + raise exceptions.InterfaceError( + 'cursor already has an open portal') + + con = self._connection + protocol = con._protocol + + self._portal_name = con._get_unique_id('portal') + buffer = await protocol.bind(self._state, self._args, + self._portal_name, + timeout) + return buffer + + async def _exec(self, n, timeout): + self._check_ready() + + if not self._portal_name: + raise exceptions.InterfaceError( + 'cursor does not have an open portal') + + protocol = self._connection._protocol + buffer, _, self._exhausted = await protocol.execute( + self._state, self._portal_name, n, True, timeout) + return buffer + + async def _close_portal(self, timeout): + self._check_ready() + + if not self._portal_name: + raise exceptions.InterfaceError( + 'cursor does not have an open portal') + + protocol = self._connection._protocol + await protocol.close_portal(self._portal_name, timeout) + self._portal_name = None + + def __repr__(self): + attrs = [] + if self._exhausted: + attrs.append('exhausted') + attrs.append('') # to separate from id + + if self.__class__.__module__.startswith('asyncpg.'): + mod = 'asyncpg' + else: + mod = self.__class__.__module__ + + return '<{}.{} "{!s:.30}" {}{:#x}>'.format( + mod, self.__class__.__name__, + self._state.query, + ' '.join(attrs), id(self)) + + def __del__(self): + if self._state is not None: + self._state.detach() + self._connection._maybe_gc_stmt(self._state) + + +class CursorIterator(BaseCursor): + + __slots__ = ('_buffer', '_prefetch', '_timeout') + + def __init__( + self, + connection, + query, + state, + args, + record_class, + prefetch, + timeout + ): + super().__init__(connection, query, state, args, record_class) + + if prefetch <= 0: + raise exceptions.InterfaceError( + 'prefetch argument must be greater than zero') + + self._buffer = collections.deque() + self._prefetch = prefetch + self._timeout = timeout + + @connresource.guarded + def __aiter__(self): + return self + + @connresource.guarded + async def __anext__(self): + if self._state is None: + self._state = await self._connection._get_statement( + self._query, + self._timeout, + named=True, + record_class=self._record_class, + ) + self._state.attach() + + if not self._portal_name and not self._exhausted: + buffer = await self._bind_exec(self._prefetch, self._timeout) + self._buffer.extend(buffer) + + if not self._buffer and not self._exhausted: + buffer = await self._exec(self._prefetch, self._timeout) + self._buffer.extend(buffer) + + if self._portal_name and self._exhausted: + await self._close_portal(self._timeout) + + if self._buffer: + return self._buffer.popleft() + + raise StopAsyncIteration + + +class Cursor(BaseCursor): + """An open *portal* into the results of a query.""" + + __slots__ = () + + async def _init(self, timeout): + if self._state is None: + self._state = await self._connection._get_statement( + self._query, + timeout, + named=True, + record_class=self._record_class, + ) + self._state.attach() + self._check_ready() + await self._bind(timeout) + return self + + @connresource.guarded + async def fetch(self, n, *, timeout=None): + r"""Return the next *n* rows as a list of :class:`Record` objects. + + :param float timeout: Optional timeout value in seconds. + + :return: A list of :class:`Record` instances. + """ + self._check_ready() + if n <= 0: + raise exceptions.InterfaceError('n must be greater than zero') + if self._exhausted: + return [] + recs = await self._exec(n, timeout) + if len(recs) < n: + self._exhausted = True + return recs + + @connresource.guarded + async def fetchrow(self, *, timeout=None): + r"""Return the next row. + + :param float timeout: Optional timeout value in seconds. + + :return: A :class:`Record` instance. + """ + self._check_ready() + if self._exhausted: + return None + recs = await self._exec(1, timeout) + if len(recs) < 1: + self._exhausted = True + return None + return recs[0] + + @connresource.guarded + async def forward(self, n, *, timeout=None) -> int: + r"""Skip over the next *n* rows. + + :param float timeout: Optional timeout value in seconds. + + :return: A number of rows actually skipped over (<= *n*). + """ + self._check_ready() + if n <= 0: + raise exceptions.InterfaceError('n must be greater than zero') + + protocol = self._connection._protocol + status = await protocol.query('MOVE FORWARD {:d} {}'.format( + n, self._portal_name), timeout) + + advanced = int(status.split()[1]) + if advanced < n: + self._exhausted = True + + return advanced diff --git a/env/Lib/site-packages/asyncpg/exceptions/__init__.py b/env/Lib/site-packages/asyncpg/exceptions/__init__.py new file mode 100644 index 0000000..8c97d5a --- /dev/null +++ b/env/Lib/site-packages/asyncpg/exceptions/__init__.py @@ -0,0 +1,1198 @@ +# GENERATED FROM postgresql/src/backend/utils/errcodes.txt +# DO NOT MODIFY, use tools/generate_exceptions.py to update + +from ._base import * # NOQA +from . import _base + + +class PostgresWarning(_base.PostgresLogMessage, Warning): + sqlstate = '01000' + + +class DynamicResultSetsReturned(PostgresWarning): + sqlstate = '0100C' + + +class ImplicitZeroBitPadding(PostgresWarning): + sqlstate = '01008' + + +class NullValueEliminatedInSetFunction(PostgresWarning): + sqlstate = '01003' + + +class PrivilegeNotGranted(PostgresWarning): + sqlstate = '01007' + + +class PrivilegeNotRevoked(PostgresWarning): + sqlstate = '01006' + + +class StringDataRightTruncation(PostgresWarning): + sqlstate = '01004' + + +class DeprecatedFeature(PostgresWarning): + sqlstate = '01P01' + + +class NoData(PostgresWarning): + sqlstate = '02000' + + +class NoAdditionalDynamicResultSetsReturned(NoData): + sqlstate = '02001' + + +class SQLStatementNotYetCompleteError(_base.PostgresError): + sqlstate = '03000' + + +class PostgresConnectionError(_base.PostgresError): + sqlstate = '08000' + + +class ConnectionDoesNotExistError(PostgresConnectionError): + sqlstate = '08003' + + +class ConnectionFailureError(PostgresConnectionError): + sqlstate = '08006' + + +class ClientCannotConnectError(PostgresConnectionError): + sqlstate = '08001' + + +class ConnectionRejectionError(PostgresConnectionError): + sqlstate = '08004' + + +class TransactionResolutionUnknownError(PostgresConnectionError): + sqlstate = '08007' + + +class ProtocolViolationError(PostgresConnectionError): + sqlstate = '08P01' + + +class TriggeredActionError(_base.PostgresError): + sqlstate = '09000' + + +class FeatureNotSupportedError(_base.PostgresError): + sqlstate = '0A000' + + +class InvalidCachedStatementError(FeatureNotSupportedError): + pass + + +class InvalidTransactionInitiationError(_base.PostgresError): + sqlstate = '0B000' + + +class LocatorError(_base.PostgresError): + sqlstate = '0F000' + + +class InvalidLocatorSpecificationError(LocatorError): + sqlstate = '0F001' + + +class InvalidGrantorError(_base.PostgresError): + sqlstate = '0L000' + + +class InvalidGrantOperationError(InvalidGrantorError): + sqlstate = '0LP01' + + +class InvalidRoleSpecificationError(_base.PostgresError): + sqlstate = '0P000' + + +class DiagnosticsError(_base.PostgresError): + sqlstate = '0Z000' + + +class StackedDiagnosticsAccessedWithoutActiveHandlerError(DiagnosticsError): + sqlstate = '0Z002' + + +class CaseNotFoundError(_base.PostgresError): + sqlstate = '20000' + + +class CardinalityViolationError(_base.PostgresError): + sqlstate = '21000' + + +class DataError(_base.PostgresError): + sqlstate = '22000' + + +class ArraySubscriptError(DataError): + sqlstate = '2202E' + + +class CharacterNotInRepertoireError(DataError): + sqlstate = '22021' + + +class DatetimeFieldOverflowError(DataError): + sqlstate = '22008' + + +class DivisionByZeroError(DataError): + sqlstate = '22012' + + +class ErrorInAssignmentError(DataError): + sqlstate = '22005' + + +class EscapeCharacterConflictError(DataError): + sqlstate = '2200B' + + +class IndicatorOverflowError(DataError): + sqlstate = '22022' + + +class IntervalFieldOverflowError(DataError): + sqlstate = '22015' + + +class InvalidArgumentForLogarithmError(DataError): + sqlstate = '2201E' + + +class InvalidArgumentForNtileFunctionError(DataError): + sqlstate = '22014' + + +class InvalidArgumentForNthValueFunctionError(DataError): + sqlstate = '22016' + + +class InvalidArgumentForPowerFunctionError(DataError): + sqlstate = '2201F' + + +class InvalidArgumentForWidthBucketFunctionError(DataError): + sqlstate = '2201G' + + +class InvalidCharacterValueForCastError(DataError): + sqlstate = '22018' + + +class InvalidDatetimeFormatError(DataError): + sqlstate = '22007' + + +class InvalidEscapeCharacterError(DataError): + sqlstate = '22019' + + +class InvalidEscapeOctetError(DataError): + sqlstate = '2200D' + + +class InvalidEscapeSequenceError(DataError): + sqlstate = '22025' + + +class NonstandardUseOfEscapeCharacterError(DataError): + sqlstate = '22P06' + + +class InvalidIndicatorParameterValueError(DataError): + sqlstate = '22010' + + +class InvalidParameterValueError(DataError): + sqlstate = '22023' + + +class InvalidPrecedingOrFollowingSizeError(DataError): + sqlstate = '22013' + + +class InvalidRegularExpressionError(DataError): + sqlstate = '2201B' + + +class InvalidRowCountInLimitClauseError(DataError): + sqlstate = '2201W' + + +class InvalidRowCountInResultOffsetClauseError(DataError): + sqlstate = '2201X' + + +class InvalidTablesampleArgumentError(DataError): + sqlstate = '2202H' + + +class InvalidTablesampleRepeatError(DataError): + sqlstate = '2202G' + + +class InvalidTimeZoneDisplacementValueError(DataError): + sqlstate = '22009' + + +class InvalidUseOfEscapeCharacterError(DataError): + sqlstate = '2200C' + + +class MostSpecificTypeMismatchError(DataError): + sqlstate = '2200G' + + +class NullValueNotAllowedError(DataError): + sqlstate = '22004' + + +class NullValueNoIndicatorParameterError(DataError): + sqlstate = '22002' + + +class NumericValueOutOfRangeError(DataError): + sqlstate = '22003' + + +class SequenceGeneratorLimitExceededError(DataError): + sqlstate = '2200H' + + +class StringDataLengthMismatchError(DataError): + sqlstate = '22026' + + +class StringDataRightTruncationError(DataError): + sqlstate = '22001' + + +class SubstringError(DataError): + sqlstate = '22011' + + +class TrimError(DataError): + sqlstate = '22027' + + +class UnterminatedCStringError(DataError): + sqlstate = '22024' + + +class ZeroLengthCharacterStringError(DataError): + sqlstate = '2200F' + + +class PostgresFloatingPointError(DataError): + sqlstate = '22P01' + + +class InvalidTextRepresentationError(DataError): + sqlstate = '22P02' + + +class InvalidBinaryRepresentationError(DataError): + sqlstate = '22P03' + + +class BadCopyFileFormatError(DataError): + sqlstate = '22P04' + + +class UntranslatableCharacterError(DataError): + sqlstate = '22P05' + + +class NotAnXmlDocumentError(DataError): + sqlstate = '2200L' + + +class InvalidXmlDocumentError(DataError): + sqlstate = '2200M' + + +class InvalidXmlContentError(DataError): + sqlstate = '2200N' + + +class InvalidXmlCommentError(DataError): + sqlstate = '2200S' + + +class InvalidXmlProcessingInstructionError(DataError): + sqlstate = '2200T' + + +class DuplicateJsonObjectKeyValueError(DataError): + sqlstate = '22030' + + +class InvalidArgumentForSQLJsonDatetimeFunctionError(DataError): + sqlstate = '22031' + + +class InvalidJsonTextError(DataError): + sqlstate = '22032' + + +class InvalidSQLJsonSubscriptError(DataError): + sqlstate = '22033' + + +class MoreThanOneSQLJsonItemError(DataError): + sqlstate = '22034' + + +class NoSQLJsonItemError(DataError): + sqlstate = '22035' + + +class NonNumericSQLJsonItemError(DataError): + sqlstate = '22036' + + +class NonUniqueKeysInAJsonObjectError(DataError): + sqlstate = '22037' + + +class SingletonSQLJsonItemRequiredError(DataError): + sqlstate = '22038' + + +class SQLJsonArrayNotFoundError(DataError): + sqlstate = '22039' + + +class SQLJsonMemberNotFoundError(DataError): + sqlstate = '2203A' + + +class SQLJsonNumberNotFoundError(DataError): + sqlstate = '2203B' + + +class SQLJsonObjectNotFoundError(DataError): + sqlstate = '2203C' + + +class TooManyJsonArrayElementsError(DataError): + sqlstate = '2203D' + + +class TooManyJsonObjectMembersError(DataError): + sqlstate = '2203E' + + +class SQLJsonScalarRequiredError(DataError): + sqlstate = '2203F' + + +class SQLJsonItemCannotBeCastToTargetTypeError(DataError): + sqlstate = '2203G' + + +class IntegrityConstraintViolationError(_base.PostgresError): + sqlstate = '23000' + + +class RestrictViolationError(IntegrityConstraintViolationError): + sqlstate = '23001' + + +class NotNullViolationError(IntegrityConstraintViolationError): + sqlstate = '23502' + + +class ForeignKeyViolationError(IntegrityConstraintViolationError): + sqlstate = '23503' + + +class UniqueViolationError(IntegrityConstraintViolationError): + sqlstate = '23505' + + +class CheckViolationError(IntegrityConstraintViolationError): + sqlstate = '23514' + + +class ExclusionViolationError(IntegrityConstraintViolationError): + sqlstate = '23P01' + + +class InvalidCursorStateError(_base.PostgresError): + sqlstate = '24000' + + +class InvalidTransactionStateError(_base.PostgresError): + sqlstate = '25000' + + +class ActiveSQLTransactionError(InvalidTransactionStateError): + sqlstate = '25001' + + +class BranchTransactionAlreadyActiveError(InvalidTransactionStateError): + sqlstate = '25002' + + +class HeldCursorRequiresSameIsolationLevelError(InvalidTransactionStateError): + sqlstate = '25008' + + +class InappropriateAccessModeForBranchTransactionError( + InvalidTransactionStateError): + sqlstate = '25003' + + +class InappropriateIsolationLevelForBranchTransactionError( + InvalidTransactionStateError): + sqlstate = '25004' + + +class NoActiveSQLTransactionForBranchTransactionError( + InvalidTransactionStateError): + sqlstate = '25005' + + +class ReadOnlySQLTransactionError(InvalidTransactionStateError): + sqlstate = '25006' + + +class SchemaAndDataStatementMixingNotSupportedError( + InvalidTransactionStateError): + sqlstate = '25007' + + +class NoActiveSQLTransactionError(InvalidTransactionStateError): + sqlstate = '25P01' + + +class InFailedSQLTransactionError(InvalidTransactionStateError): + sqlstate = '25P02' + + +class IdleInTransactionSessionTimeoutError(InvalidTransactionStateError): + sqlstate = '25P03' + + +class InvalidSQLStatementNameError(_base.PostgresError): + sqlstate = '26000' + + +class TriggeredDataChangeViolationError(_base.PostgresError): + sqlstate = '27000' + + +class InvalidAuthorizationSpecificationError(_base.PostgresError): + sqlstate = '28000' + + +class InvalidPasswordError(InvalidAuthorizationSpecificationError): + sqlstate = '28P01' + + +class DependentPrivilegeDescriptorsStillExistError(_base.PostgresError): + sqlstate = '2B000' + + +class DependentObjectsStillExistError( + DependentPrivilegeDescriptorsStillExistError): + sqlstate = '2BP01' + + +class InvalidTransactionTerminationError(_base.PostgresError): + sqlstate = '2D000' + + +class SQLRoutineError(_base.PostgresError): + sqlstate = '2F000' + + +class FunctionExecutedNoReturnStatementError(SQLRoutineError): + sqlstate = '2F005' + + +class ModifyingSQLDataNotPermittedError(SQLRoutineError): + sqlstate = '2F002' + + +class ProhibitedSQLStatementAttemptedError(SQLRoutineError): + sqlstate = '2F003' + + +class ReadingSQLDataNotPermittedError(SQLRoutineError): + sqlstate = '2F004' + + +class InvalidCursorNameError(_base.PostgresError): + sqlstate = '34000' + + +class ExternalRoutineError(_base.PostgresError): + sqlstate = '38000' + + +class ContainingSQLNotPermittedError(ExternalRoutineError): + sqlstate = '38001' + + +class ModifyingExternalRoutineSQLDataNotPermittedError(ExternalRoutineError): + sqlstate = '38002' + + +class ProhibitedExternalRoutineSQLStatementAttemptedError( + ExternalRoutineError): + sqlstate = '38003' + + +class ReadingExternalRoutineSQLDataNotPermittedError(ExternalRoutineError): + sqlstate = '38004' + + +class ExternalRoutineInvocationError(_base.PostgresError): + sqlstate = '39000' + + +class InvalidSqlstateReturnedError(ExternalRoutineInvocationError): + sqlstate = '39001' + + +class NullValueInExternalRoutineNotAllowedError( + ExternalRoutineInvocationError): + sqlstate = '39004' + + +class TriggerProtocolViolatedError(ExternalRoutineInvocationError): + sqlstate = '39P01' + + +class SrfProtocolViolatedError(ExternalRoutineInvocationError): + sqlstate = '39P02' + + +class EventTriggerProtocolViolatedError(ExternalRoutineInvocationError): + sqlstate = '39P03' + + +class SavepointError(_base.PostgresError): + sqlstate = '3B000' + + +class InvalidSavepointSpecificationError(SavepointError): + sqlstate = '3B001' + + +class InvalidCatalogNameError(_base.PostgresError): + sqlstate = '3D000' + + +class InvalidSchemaNameError(_base.PostgresError): + sqlstate = '3F000' + + +class TransactionRollbackError(_base.PostgresError): + sqlstate = '40000' + + +class TransactionIntegrityConstraintViolationError(TransactionRollbackError): + sqlstate = '40002' + + +class SerializationError(TransactionRollbackError): + sqlstate = '40001' + + +class StatementCompletionUnknownError(TransactionRollbackError): + sqlstate = '40003' + + +class DeadlockDetectedError(TransactionRollbackError): + sqlstate = '40P01' + + +class SyntaxOrAccessError(_base.PostgresError): + sqlstate = '42000' + + +class PostgresSyntaxError(SyntaxOrAccessError): + sqlstate = '42601' + + +class InsufficientPrivilegeError(SyntaxOrAccessError): + sqlstate = '42501' + + +class CannotCoerceError(SyntaxOrAccessError): + sqlstate = '42846' + + +class GroupingError(SyntaxOrAccessError): + sqlstate = '42803' + + +class WindowingError(SyntaxOrAccessError): + sqlstate = '42P20' + + +class InvalidRecursionError(SyntaxOrAccessError): + sqlstate = '42P19' + + +class InvalidForeignKeyError(SyntaxOrAccessError): + sqlstate = '42830' + + +class InvalidNameError(SyntaxOrAccessError): + sqlstate = '42602' + + +class NameTooLongError(SyntaxOrAccessError): + sqlstate = '42622' + + +class ReservedNameError(SyntaxOrAccessError): + sqlstate = '42939' + + +class DatatypeMismatchError(SyntaxOrAccessError): + sqlstate = '42804' + + +class IndeterminateDatatypeError(SyntaxOrAccessError): + sqlstate = '42P18' + + +class CollationMismatchError(SyntaxOrAccessError): + sqlstate = '42P21' + + +class IndeterminateCollationError(SyntaxOrAccessError): + sqlstate = '42P22' + + +class WrongObjectTypeError(SyntaxOrAccessError): + sqlstate = '42809' + + +class GeneratedAlwaysError(SyntaxOrAccessError): + sqlstate = '428C9' + + +class UndefinedColumnError(SyntaxOrAccessError): + sqlstate = '42703' + + +class UndefinedFunctionError(SyntaxOrAccessError): + sqlstate = '42883' + + +class UndefinedTableError(SyntaxOrAccessError): + sqlstate = '42P01' + + +class UndefinedParameterError(SyntaxOrAccessError): + sqlstate = '42P02' + + +class UndefinedObjectError(SyntaxOrAccessError): + sqlstate = '42704' + + +class DuplicateColumnError(SyntaxOrAccessError): + sqlstate = '42701' + + +class DuplicateCursorError(SyntaxOrAccessError): + sqlstate = '42P03' + + +class DuplicateDatabaseError(SyntaxOrAccessError): + sqlstate = '42P04' + + +class DuplicateFunctionError(SyntaxOrAccessError): + sqlstate = '42723' + + +class DuplicatePreparedStatementError(SyntaxOrAccessError): + sqlstate = '42P05' + + +class DuplicateSchemaError(SyntaxOrAccessError): + sqlstate = '42P06' + + +class DuplicateTableError(SyntaxOrAccessError): + sqlstate = '42P07' + + +class DuplicateAliasError(SyntaxOrAccessError): + sqlstate = '42712' + + +class DuplicateObjectError(SyntaxOrAccessError): + sqlstate = '42710' + + +class AmbiguousColumnError(SyntaxOrAccessError): + sqlstate = '42702' + + +class AmbiguousFunctionError(SyntaxOrAccessError): + sqlstate = '42725' + + +class AmbiguousParameterError(SyntaxOrAccessError): + sqlstate = '42P08' + + +class AmbiguousAliasError(SyntaxOrAccessError): + sqlstate = '42P09' + + +class InvalidColumnReferenceError(SyntaxOrAccessError): + sqlstate = '42P10' + + +class InvalidColumnDefinitionError(SyntaxOrAccessError): + sqlstate = '42611' + + +class InvalidCursorDefinitionError(SyntaxOrAccessError): + sqlstate = '42P11' + + +class InvalidDatabaseDefinitionError(SyntaxOrAccessError): + sqlstate = '42P12' + + +class InvalidFunctionDefinitionError(SyntaxOrAccessError): + sqlstate = '42P13' + + +class InvalidPreparedStatementDefinitionError(SyntaxOrAccessError): + sqlstate = '42P14' + + +class InvalidSchemaDefinitionError(SyntaxOrAccessError): + sqlstate = '42P15' + + +class InvalidTableDefinitionError(SyntaxOrAccessError): + sqlstate = '42P16' + + +class InvalidObjectDefinitionError(SyntaxOrAccessError): + sqlstate = '42P17' + + +class WithCheckOptionViolationError(_base.PostgresError): + sqlstate = '44000' + + +class InsufficientResourcesError(_base.PostgresError): + sqlstate = '53000' + + +class DiskFullError(InsufficientResourcesError): + sqlstate = '53100' + + +class OutOfMemoryError(InsufficientResourcesError): + sqlstate = '53200' + + +class TooManyConnectionsError(InsufficientResourcesError): + sqlstate = '53300' + + +class ConfigurationLimitExceededError(InsufficientResourcesError): + sqlstate = '53400' + + +class ProgramLimitExceededError(_base.PostgresError): + sqlstate = '54000' + + +class StatementTooComplexError(ProgramLimitExceededError): + sqlstate = '54001' + + +class TooManyColumnsError(ProgramLimitExceededError): + sqlstate = '54011' + + +class TooManyArgumentsError(ProgramLimitExceededError): + sqlstate = '54023' + + +class ObjectNotInPrerequisiteStateError(_base.PostgresError): + sqlstate = '55000' + + +class ObjectInUseError(ObjectNotInPrerequisiteStateError): + sqlstate = '55006' + + +class CantChangeRuntimeParamError(ObjectNotInPrerequisiteStateError): + sqlstate = '55P02' + + +class LockNotAvailableError(ObjectNotInPrerequisiteStateError): + sqlstate = '55P03' + + +class UnsafeNewEnumValueUsageError(ObjectNotInPrerequisiteStateError): + sqlstate = '55P04' + + +class OperatorInterventionError(_base.PostgresError): + sqlstate = '57000' + + +class QueryCanceledError(OperatorInterventionError): + sqlstate = '57014' + + +class AdminShutdownError(OperatorInterventionError): + sqlstate = '57P01' + + +class CrashShutdownError(OperatorInterventionError): + sqlstate = '57P02' + + +class CannotConnectNowError(OperatorInterventionError): + sqlstate = '57P03' + + +class DatabaseDroppedError(OperatorInterventionError): + sqlstate = '57P04' + + +class IdleSessionTimeoutError(OperatorInterventionError): + sqlstate = '57P05' + + +class PostgresSystemError(_base.PostgresError): + sqlstate = '58000' + + +class PostgresIOError(PostgresSystemError): + sqlstate = '58030' + + +class UndefinedFileError(PostgresSystemError): + sqlstate = '58P01' + + +class DuplicateFileError(PostgresSystemError): + sqlstate = '58P02' + + +class SnapshotTooOldError(_base.PostgresError): + sqlstate = '72000' + + +class ConfigFileError(_base.PostgresError): + sqlstate = 'F0000' + + +class LockFileExistsError(ConfigFileError): + sqlstate = 'F0001' + + +class FDWError(_base.PostgresError): + sqlstate = 'HV000' + + +class FDWColumnNameNotFoundError(FDWError): + sqlstate = 'HV005' + + +class FDWDynamicParameterValueNeededError(FDWError): + sqlstate = 'HV002' + + +class FDWFunctionSequenceError(FDWError): + sqlstate = 'HV010' + + +class FDWInconsistentDescriptorInformationError(FDWError): + sqlstate = 'HV021' + + +class FDWInvalidAttributeValueError(FDWError): + sqlstate = 'HV024' + + +class FDWInvalidColumnNameError(FDWError): + sqlstate = 'HV007' + + +class FDWInvalidColumnNumberError(FDWError): + sqlstate = 'HV008' + + +class FDWInvalidDataTypeError(FDWError): + sqlstate = 'HV004' + + +class FDWInvalidDataTypeDescriptorsError(FDWError): + sqlstate = 'HV006' + + +class FDWInvalidDescriptorFieldIdentifierError(FDWError): + sqlstate = 'HV091' + + +class FDWInvalidHandleError(FDWError): + sqlstate = 'HV00B' + + +class FDWInvalidOptionIndexError(FDWError): + sqlstate = 'HV00C' + + +class FDWInvalidOptionNameError(FDWError): + sqlstate = 'HV00D' + + +class FDWInvalidStringLengthOrBufferLengthError(FDWError): + sqlstate = 'HV090' + + +class FDWInvalidStringFormatError(FDWError): + sqlstate = 'HV00A' + + +class FDWInvalidUseOfNullPointerError(FDWError): + sqlstate = 'HV009' + + +class FDWTooManyHandlesError(FDWError): + sqlstate = 'HV014' + + +class FDWOutOfMemoryError(FDWError): + sqlstate = 'HV001' + + +class FDWNoSchemasError(FDWError): + sqlstate = 'HV00P' + + +class FDWOptionNameNotFoundError(FDWError): + sqlstate = 'HV00J' + + +class FDWReplyHandleError(FDWError): + sqlstate = 'HV00K' + + +class FDWSchemaNotFoundError(FDWError): + sqlstate = 'HV00Q' + + +class FDWTableNotFoundError(FDWError): + sqlstate = 'HV00R' + + +class FDWUnableToCreateExecutionError(FDWError): + sqlstate = 'HV00L' + + +class FDWUnableToCreateReplyError(FDWError): + sqlstate = 'HV00M' + + +class FDWUnableToEstablishConnectionError(FDWError): + sqlstate = 'HV00N' + + +class PLPGSQLError(_base.PostgresError): + sqlstate = 'P0000' + + +class RaiseError(PLPGSQLError): + sqlstate = 'P0001' + + +class NoDataFoundError(PLPGSQLError): + sqlstate = 'P0002' + + +class TooManyRowsError(PLPGSQLError): + sqlstate = 'P0003' + + +class AssertError(PLPGSQLError): + sqlstate = 'P0004' + + +class InternalServerError(_base.PostgresError): + sqlstate = 'XX000' + + +class DataCorruptedError(InternalServerError): + sqlstate = 'XX001' + + +class IndexCorruptedError(InternalServerError): + sqlstate = 'XX002' + + +__all__ = ( + 'ActiveSQLTransactionError', 'AdminShutdownError', + 'AmbiguousAliasError', 'AmbiguousColumnError', + 'AmbiguousFunctionError', 'AmbiguousParameterError', + 'ArraySubscriptError', 'AssertError', 'BadCopyFileFormatError', + 'BranchTransactionAlreadyActiveError', 'CannotCoerceError', + 'CannotConnectNowError', 'CantChangeRuntimeParamError', + 'CardinalityViolationError', 'CaseNotFoundError', + 'CharacterNotInRepertoireError', 'CheckViolationError', + 'ClientCannotConnectError', 'CollationMismatchError', + 'ConfigFileError', 'ConfigurationLimitExceededError', + 'ConnectionDoesNotExistError', 'ConnectionFailureError', + 'ConnectionRejectionError', 'ContainingSQLNotPermittedError', + 'CrashShutdownError', 'DataCorruptedError', 'DataError', + 'DatabaseDroppedError', 'DatatypeMismatchError', + 'DatetimeFieldOverflowError', 'DeadlockDetectedError', + 'DependentObjectsStillExistError', + 'DependentPrivilegeDescriptorsStillExistError', 'DeprecatedFeature', + 'DiagnosticsError', 'DiskFullError', 'DivisionByZeroError', + 'DuplicateAliasError', 'DuplicateColumnError', 'DuplicateCursorError', + 'DuplicateDatabaseError', 'DuplicateFileError', + 'DuplicateFunctionError', 'DuplicateJsonObjectKeyValueError', + 'DuplicateObjectError', 'DuplicatePreparedStatementError', + 'DuplicateSchemaError', 'DuplicateTableError', + 'DynamicResultSetsReturned', 'ErrorInAssignmentError', + 'EscapeCharacterConflictError', 'EventTriggerProtocolViolatedError', + 'ExclusionViolationError', 'ExternalRoutineError', + 'ExternalRoutineInvocationError', 'FDWColumnNameNotFoundError', + 'FDWDynamicParameterValueNeededError', 'FDWError', + 'FDWFunctionSequenceError', + 'FDWInconsistentDescriptorInformationError', + 'FDWInvalidAttributeValueError', 'FDWInvalidColumnNameError', + 'FDWInvalidColumnNumberError', 'FDWInvalidDataTypeDescriptorsError', + 'FDWInvalidDataTypeError', 'FDWInvalidDescriptorFieldIdentifierError', + 'FDWInvalidHandleError', 'FDWInvalidOptionIndexError', + 'FDWInvalidOptionNameError', 'FDWInvalidStringFormatError', + 'FDWInvalidStringLengthOrBufferLengthError', + 'FDWInvalidUseOfNullPointerError', 'FDWNoSchemasError', + 'FDWOptionNameNotFoundError', 'FDWOutOfMemoryError', + 'FDWReplyHandleError', 'FDWSchemaNotFoundError', + 'FDWTableNotFoundError', 'FDWTooManyHandlesError', + 'FDWUnableToCreateExecutionError', 'FDWUnableToCreateReplyError', + 'FDWUnableToEstablishConnectionError', 'FeatureNotSupportedError', + 'ForeignKeyViolationError', 'FunctionExecutedNoReturnStatementError', + 'GeneratedAlwaysError', 'GroupingError', + 'HeldCursorRequiresSameIsolationLevelError', + 'IdleInTransactionSessionTimeoutError', 'IdleSessionTimeoutError', + 'ImplicitZeroBitPadding', 'InFailedSQLTransactionError', + 'InappropriateAccessModeForBranchTransactionError', + 'InappropriateIsolationLevelForBranchTransactionError', + 'IndeterminateCollationError', 'IndeterminateDatatypeError', + 'IndexCorruptedError', 'IndicatorOverflowError', + 'InsufficientPrivilegeError', 'InsufficientResourcesError', + 'IntegrityConstraintViolationError', 'InternalServerError', + 'IntervalFieldOverflowError', 'InvalidArgumentForLogarithmError', + 'InvalidArgumentForNthValueFunctionError', + 'InvalidArgumentForNtileFunctionError', + 'InvalidArgumentForPowerFunctionError', + 'InvalidArgumentForSQLJsonDatetimeFunctionError', + 'InvalidArgumentForWidthBucketFunctionError', + 'InvalidAuthorizationSpecificationError', + 'InvalidBinaryRepresentationError', 'InvalidCachedStatementError', + 'InvalidCatalogNameError', 'InvalidCharacterValueForCastError', + 'InvalidColumnDefinitionError', 'InvalidColumnReferenceError', + 'InvalidCursorDefinitionError', 'InvalidCursorNameError', + 'InvalidCursorStateError', 'InvalidDatabaseDefinitionError', + 'InvalidDatetimeFormatError', 'InvalidEscapeCharacterError', + 'InvalidEscapeOctetError', 'InvalidEscapeSequenceError', + 'InvalidForeignKeyError', 'InvalidFunctionDefinitionError', + 'InvalidGrantOperationError', 'InvalidGrantorError', + 'InvalidIndicatorParameterValueError', 'InvalidJsonTextError', + 'InvalidLocatorSpecificationError', 'InvalidNameError', + 'InvalidObjectDefinitionError', 'InvalidParameterValueError', + 'InvalidPasswordError', 'InvalidPrecedingOrFollowingSizeError', + 'InvalidPreparedStatementDefinitionError', 'InvalidRecursionError', + 'InvalidRegularExpressionError', 'InvalidRoleSpecificationError', + 'InvalidRowCountInLimitClauseError', + 'InvalidRowCountInResultOffsetClauseError', + 'InvalidSQLJsonSubscriptError', 'InvalidSQLStatementNameError', + 'InvalidSavepointSpecificationError', 'InvalidSchemaDefinitionError', + 'InvalidSchemaNameError', 'InvalidSqlstateReturnedError', + 'InvalidTableDefinitionError', 'InvalidTablesampleArgumentError', + 'InvalidTablesampleRepeatError', 'InvalidTextRepresentationError', + 'InvalidTimeZoneDisplacementValueError', + 'InvalidTransactionInitiationError', 'InvalidTransactionStateError', + 'InvalidTransactionTerminationError', + 'InvalidUseOfEscapeCharacterError', 'InvalidXmlCommentError', + 'InvalidXmlContentError', 'InvalidXmlDocumentError', + 'InvalidXmlProcessingInstructionError', 'LocatorError', + 'LockFileExistsError', 'LockNotAvailableError', + 'ModifyingExternalRoutineSQLDataNotPermittedError', + 'ModifyingSQLDataNotPermittedError', 'MoreThanOneSQLJsonItemError', + 'MostSpecificTypeMismatchError', 'NameTooLongError', + 'NoActiveSQLTransactionError', + 'NoActiveSQLTransactionForBranchTransactionError', + 'NoAdditionalDynamicResultSetsReturned', 'NoData', 'NoDataFoundError', + 'NoSQLJsonItemError', 'NonNumericSQLJsonItemError', + 'NonUniqueKeysInAJsonObjectError', + 'NonstandardUseOfEscapeCharacterError', 'NotAnXmlDocumentError', + 'NotNullViolationError', 'NullValueEliminatedInSetFunction', + 'NullValueInExternalRoutineNotAllowedError', + 'NullValueNoIndicatorParameterError', 'NullValueNotAllowedError', + 'NumericValueOutOfRangeError', 'ObjectInUseError', + 'ObjectNotInPrerequisiteStateError', 'OperatorInterventionError', + 'OutOfMemoryError', 'PLPGSQLError', 'PostgresConnectionError', + 'PostgresFloatingPointError', 'PostgresIOError', + 'PostgresSyntaxError', 'PostgresSystemError', 'PostgresWarning', + 'PrivilegeNotGranted', 'PrivilegeNotRevoked', + 'ProgramLimitExceededError', + 'ProhibitedExternalRoutineSQLStatementAttemptedError', + 'ProhibitedSQLStatementAttemptedError', 'ProtocolViolationError', + 'QueryCanceledError', 'RaiseError', 'ReadOnlySQLTransactionError', + 'ReadingExternalRoutineSQLDataNotPermittedError', + 'ReadingSQLDataNotPermittedError', 'ReservedNameError', + 'RestrictViolationError', 'SQLJsonArrayNotFoundError', + 'SQLJsonItemCannotBeCastToTargetTypeError', + 'SQLJsonMemberNotFoundError', 'SQLJsonNumberNotFoundError', + 'SQLJsonObjectNotFoundError', 'SQLJsonScalarRequiredError', + 'SQLRoutineError', 'SQLStatementNotYetCompleteError', + 'SavepointError', 'SchemaAndDataStatementMixingNotSupportedError', + 'SequenceGeneratorLimitExceededError', 'SerializationError', + 'SingletonSQLJsonItemRequiredError', 'SnapshotTooOldError', + 'SrfProtocolViolatedError', + 'StackedDiagnosticsAccessedWithoutActiveHandlerError', + 'StatementCompletionUnknownError', 'StatementTooComplexError', + 'StringDataLengthMismatchError', 'StringDataRightTruncation', + 'StringDataRightTruncationError', 'SubstringError', + 'SyntaxOrAccessError', 'TooManyArgumentsError', 'TooManyColumnsError', + 'TooManyConnectionsError', 'TooManyJsonArrayElementsError', + 'TooManyJsonObjectMembersError', 'TooManyRowsError', + 'TransactionIntegrityConstraintViolationError', + 'TransactionResolutionUnknownError', 'TransactionRollbackError', + 'TriggerProtocolViolatedError', 'TriggeredActionError', + 'TriggeredDataChangeViolationError', 'TrimError', + 'UndefinedColumnError', 'UndefinedFileError', + 'UndefinedFunctionError', 'UndefinedObjectError', + 'UndefinedParameterError', 'UndefinedTableError', + 'UniqueViolationError', 'UnsafeNewEnumValueUsageError', + 'UnterminatedCStringError', 'UntranslatableCharacterError', + 'WindowingError', 'WithCheckOptionViolationError', + 'WrongObjectTypeError', 'ZeroLengthCharacterStringError' +) + +__all__ += _base.__all__ diff --git a/env/Lib/site-packages/asyncpg/exceptions/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/asyncpg/exceptions/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dfcb38874b79fbf15143b2b754c32f4dd01c8379 GIT binary patch literal 56536 zcmcg#31A&n)lRy%w6ru`(ly;_DU_^TScEod+CZCxB&DTP<7+Za9({Q)%zLkG5Tpnq z2tq-S$QlHpY*NJqMMV(=MIlHOEFegc#f{YsT>kT&xifF>+_{grC_n1)<$QR{NesHO#FEJld}p6t}19RXfI3@wBY{-B?`L=HWw5Y z3@TVt&_4LQg7zU+!D)lsf6*Fz%aDSCJLrGTKbwbe+)#=eW(~PzFk$pRfemGBIAJ3c zY#3uB2^*zg!x=k>u+a)Og0V4#9jss@85>L3I0YNU*dc_CSFnQ^Duth@uY56IIMniz(`Gt2l7aQy4pf zuqAn}FqNZ@q^Qz7QPVi8jH1e|X#t+;j8za;ndb^KII4=GmRd6cSD4AzGQyVUxk3p? zt)Qr*@HuoeY7g0T&RovdI>7~4qLCIvf^u~P`!tYD>#ol4ji1uJ9hqlA4-!O9tHCG6u0 zR>4?|u&oMK$ygglk3mQb)2jCB!~RIsBM zOA*$sU`I1{I$^eg9m80fu#AEo%UG7M9SZgl#OTms~tcS2O6zq7$K0(--3bvB5 zvk3d7f~{igY{GUcST$qk5cVkrt6}V1!p>8$)r@_bu=5qHma)$ec7cMeVeCS}KC57B z8M}zEixsSnvCk29iGrQL*rkN+QLqykyNs~Q6>J@2pC{}J1zXS9m4tmk!Ri^iim+Y< zYhdh)gk7y*jf`DG*tH6F5@Xj9cD;f%F?IuCeG1mh*o}mJNx@neyNR%y6>I}zUncAp z1v{CsTM65%U>g~`jj-DlY!hR55O$}6ox<2%gndQ9HZyiNVfz&9RK~ta*w++n3uE^X z_H_mOC}ZCs?3)VqF~+_{*u4tY%GkFF`;LNroU!`|`>uk;82cV!-&e4$jNMPz4-~A8 zu^$rlfP%F%_9Ma`R4|LNhY0(zf^B2$VZt6!unxw4LfB99w7i`h^(aOC%<2rZym7{U zPS|4#MjdtPwLeZ+zk+RN>uPJJO zo~Uk)dWNE&wYmfMd^%%wDevl)Ayuoo08&Dd`Vdr`qMj2$5CB?Zee_B+B}R=TT=N!VL?Qua)adYhu& z$rE)JNBxDO{+cK1lN|Loiu$|t$-q-Oo3Vco_HLdl?B=NVDC(cq?!Xn!VeDUo{X5SU zKE+Z0Ij>+(VS7QIxN{LlF@+pC$T~N`cAmfoGd@JYKP~W~j1N=r^94Sf@evCC8G(;v zd{iE#7l_D%IC6BJ$O}c}7>+#Hx-f80pB4C6#>Xl6MFKyB@$m|NvA~NMpP=BM6Zk~N zC*@IkiHMxck;T>}0i~A;dmD)5go{xJprn!sBb|G0wRBk&mGTNV84 z0&ioyUBSO0aEtM63jR%jcQD?m;NKE>obl5X{9b`?XFQ?c-xhcm<4Fboj=)olcPsdP z0zaK`Tfx68@HFEY1^=GFvyAUh@b3$JC*!*m{C_^$+hE8}|={3(Io#`x`dls+vY@8HNgt)~M@e=YF482^fb z?-%&pjPFzMX9WIL#=oZE&kFn=#=oxM&k6h+jDJ(XeM@JAW{nS#G2@SijOn1cUa;Eyxjui$?W_!Er( zLc#wi@Fy7`Q1Cwq{FjXXO2Pju@TVAmTESlz_^%n?ui$S8{29idRq!_j{v6}KQSi3} z{ygI^DEQj~|1IM$D)>7BKfw4)3jP;?|BmsO75uLPe}(Z^75r}ke~t0qEBN09{s+eY zsNnw)_@5a6vx2`X@YflCL&4t@_?wKsrQrV*_}h%Xqu~D%_+J?RtAhVq;D2NM?+X4O zf&YW?cZ2wz!p#LD;ysS|r@pLFY@vw#7svj4PoY&Pmp6(TBx3$UF@xG^lp-W%Fvkqy z@ryz2gF<75h?v2AogtwyLq*I`jv1C$`!EqZoMT7O^@b_hhl`kz95X63W(3{UL3E!Z z2_0$C{hc<_ogY7AOac8($e{Mo%>@g`(BgvE3JF|PxWDi)GDBOp#?n@s8;<`6jDOx9 zPv$Bb^Vv)zKbt9KHV;6%#tzD`1Yy!VWx3-?1jU@y!B7J%yorz_v+X~(W(Yp;bM{U`dvbS%kPPNnJ zwrtPZu}sQt-I~g5v64Hstc!2ml8$GrBf4X4+hZM8dP^+blWgnmIMUkHW_4%csbu=d z*4B73o@s4e(%oZY$pxDc^yBR!GP}M1JUw>O?zQ-jjYR|;WqA8jYI^8S;%!YUtZzHYI(5Loyb>keqBrn zLkP?S{KyG`%TP#BqaEK7PgosReJZoYjwMNm!@Vq=dm1QVSVWE+uK$L+$=Z?H?s6{; z=bi~}nCbYDg*hHS#=&qi2$!({@7Xt5rzx30QwQ;l!_>$E;4&02yM=1}bc}N!wZ*AK z7NvAUa(gnhGwDkTO| z^b=a_ct?k2TkR{QqPRj^6jy^2rcow`%aFWS)c;flo3q{BDVv%E_wH9}1#p_fw8#SB z3KxKE>hFzGPjt}!X?4jRu|&MRI@Z={wR<%q^VcsLY@;7+V`;8^5KN#)b|QQ*o9KUO zbkcm?#33Vg*EnSZ5#gG&J>=O!moJCbQSUS^<&9O^)LBoAHp~|M$dyvK43&&tm!eiW zWxJ20R!hoR0p{Z}DO`r6v&8KS?&fZ*Exs-8^iX_4G<8%n_+i>*A#fQADH1}sZ6+#YHn>)43{DElZMpVJ?^?>lSNfQ zCKdO(i%_Ad2~P((%*C<_xC~WHr8KuP@h+=2ZYA0qc3AedL~5t+A!vpTxD>+dktM)o zD50o^Ue?o82d?VDxJ8b;OjF!;f)eHmnHw%c?n%s6mt2`n$2*dEd&<$5R)yz*Gr$Vd zE7QYeNI!jbx-Hgic{zdl>)U7m$1h@4xQMgB4Rft50xm-llj@S~XoOR?`uNK=k6<@g zVfyf691J>Q>@uXM_K?Z|b=NdGuuSt9&IKRL&G?a%0GFWzw_mc-?#Ln!)TZopsg9UU zjX_r~Ka^?eg!91dh4@%nxJD_Sqxl;V&;nH;k9>-)B)?FF;bgLiZ5?ydfT@`0?dG{1ujD^ z?z7QJDAx>B-VSD%r)3Fn8A@>L(?%Mww=hrCVArM+)cd2K&G9pQ8Kq1k<}PS}c~%w! zm!TN%mDK9UCSvyLT{MkAeKPOGn6hh`rYpoP3(O0$3b+haxK(IVYG*aQfKj)69Zh6q zsuQtn+Mga9!^`eH5CHR%tOPDYB@0Df%_(uF6&to~OVi+fP|&7uLEnT9m{(;%a2X0J z5rSG`TN73~hRFrDmy#iyIf0T8=WvIi=C_Wu{b@Dea<(jsZ8#b6XWEF53 zs+jMl2E93LP9?3Hc)B|gYvcKsKxI;@X=v_;2$*+dHE`%YuM6K%>?uV;D`CU zECen?Av4y~aE?2o)Y8*!t&gXvblnvQT z!?vbavcp%Gm1^qt$DjdbgscHBLk)A?uE!cHiQ!IqyF#tHnigqT?b4&sR3A@33(RO) z3tWa;X5^;G*ICJqOsASd%QZa_ZuDWs$tvJ7R53HBA}~?!%N&})pQnhGY?yhn47dzsOm*kyYZED&c1U(K zrsBRKFYVmJ%a8!GP?i9fp@f-k%W3V(P{U2VJQ{HEPl1$|H|oaOUxN&o!(|z88Om^* z%vChvZTDz}XevkU#=w-yLf|qKGHF$;y*kz1Q;T69`8~N&*HpbuG&W47Ob?eK{d6iB zm@cR3X>{zo%;}YmM%^&zTMz-WTowVBp@@lSr<0qy5;dtd9)R=MOH0><_bC4Yc9>&i zcDM}L-PiPR{`KMf+*g7*Ugn3(ke|k1cVM!b_-Xt%BacDXhtt1DG&W3)Ob^$8L*Eq` z0&fnd|2ODi*2?s78PdCNp>+4OS^~3hR4vufpn;wBFIqsyttDJcAvD0Olf}SgC}vho z77Hk8O5}ueD%r3V%U4dcdICNA3eE5U_tszeYul1~@pA|XO%?J6|Y^%!u& zY>`F4Whi3W`jl<8bjFemNlOT+qh)u#gwS**oK7PVeq7c7zoCZl^{H@b&3IlB7-8CF zYPbxkr_y+yc%ulHpy@kL0y9jfECDV<2_+<9Lo!Z-nN%{s4u-@w0%JbRM@&%HxGQ8@Z17?_AvIMw3pajaD;Sw~Xhx5Sg?%Zi~@~a!AS4yl<6(8RlYH0$hd?7W%3N zXGQKR3$t-8sg{`CVP!Bx=BuS&@ggMC!!jhFgMHOa2b*pRd-r# z+e5g^G<~O9P{Qn$x#2S8o=l^Ti7Y0TRDSL7M;&Nk?v(lAGUXSY*y^mEranFPY`7Ib zrFNAczu3U+llkE?1LXi zuA`j`JTA7*+F>PpiZmTce!+tIfvgBFLq(-^$yj%{o$9t}WxD08ja{E=$M}?zZa!g} zYU@ycqy@* z)!#>#rUu>$B`}ZSM@|=9hPtLTQC@FICVFIDzGta3dz$S3x#A>oHnr#+z2i z`w~P`>`#XVn3rTRa2bkm8!bu?FQ3#?73qpts%^9~;D&is76F%`2-;RAc2gn0(m**) zqbhxfWm+XWApqu&vJ$uql`L=v2eY(U!H%E7t%N)4E={HAH(j0q6)Zo z#?tAXDcc+SSgtKAXMq#u9hn?1L-NCE!?BfYr;5Yd^Ic;(tNBxQx|tTwCj47K%k`V9 zc0&uy-(^v78Hy_LL^*H2VLG&lb1vv%{)r#C$_y?;9dkrR@s;8hF%9ZlSyiLWv*$wr z44tOouhZZ%lromeZWGlT@uXL3^;^y^1TPGon&Ib#%aC`0w>o&2)t03_i1jJwR0gji zaVrs$qiJ|Ah8&oYvK+V!<;TsvxoZh&viK)=Pob`epW{OM?mm&Rx)w^h!0&T&POG<^l8ovhQFf(LwxD3f> zV)Bv3gPg|@k}n}c^JaEEWWdapWx!=9qtq)QfyB@k7zoo8m>VGsX1**8E<<4zxdNjq z)0Q7-)07_`NP$@dZMljbE<*0z$}$Tz-1_6k+&wWE*VG`Dr@p8 zMJUod9UcLKIZDnna2YC^E;_W7uYHFUcym`3E3{pddx*@2IZjR%xC})UH{09t2+$Pk zZ$bb}wJZQGLjki_@1V}(`zM8_5Pus=VAjY=;4)NlaC2;j)$Lo5RiW>!@~9Kci83u* zhO}-c(PIyLlYkUW8M&V*ZI}jG3S5R#+?6=h)GGFt9%iFV50@c*v9F&_Tk{iJX_vaFqtN}(tU7rF0$@&+1;Aw};BcRS2opsR zr756~LKIA^EDA0|QRACw{W7hOa$a+N>7mJwJURx`CR4ME2CTe)D1`sfA81$NHS6Lu zC2G0kb7YVNnwsGWy1ot5A?tw4FbO8sQ1>{IYTI5zo0VuAnfr=eS*op~2fz-qU1o>N zkiDq6hdPG48f<4E*nI-}4f;F^2a}Sy;WFiR7pyuOJnp5s+Gsy<*f43C8!kg`+M<=t zZlm)_aGsJky5LEu(n)v@5@2@965ukFK&L@C$2eKGw{fqse0im2be4zxU_K!;!)3@k zW{sW7cGJ6ncfZSZ8T|lV-G(_^W`)a;_27;1WIJy_^Jp8(HTB-hpoKYCriIIpcA^+3 zX`&$l+qdbgvb?cOvv}q;u)};tW{1m=-EDPpbHd)uFV`(KRhBQ)H7%pS33HE34woVMB#+!15q3_-qB8|SE6lfKdbkYfi#&SXxSGpxx?aRMrX+Kp%niRG_hgUT+imXS*Yx0vKnruf%nz3# zKP@&A&)v!O9{Dm|r8fzjFh7#X;W8!nmh>x`PV)l6`y6FeQxsDh7N(~DmSPMBw8a<~l1i#+mRt)p2< zu^5yv&&%9!ePHgDiFhp6(k#;*>&4^EFb8CAxD2^-i5{$R$~12iW#EK)MJ9*Klze5^ z)_6xYl}#%(j;5}y1SiZNWOBF+$tQW_A*D`}+n0eA=5?7KE<^gs9(`C-qglDeL)kEI z%lvQ|@)vpha;9t4^{tKtCCuMsZnzA&-6Mybr`}|3qmy@Y=k4HKQj_95z(jmUPWxGV#%4=BSejiE9$-OqK90dtTn11>`u?pbb1TNtWG(>Z8>9+NruX0ogSE<+7&LOAVIs0d9{ zy$K>o`7_g|>iJp zhS$T1+d&MoSSE(cka)7#Ek-Lp#Mc^f$xZ1U&ffukm?LF=xD5GAh52j)DtSpwIhVPyn+`Rsffwf@1IGgdT}A*|f{e3M4@D zrrHewFh|P*;4&0YZ{Pcrn3HTrVH2?T&JC^PYq1L<} zTn1{G4w)J*!@Hj7PVjOAT<@K{jvLqH`YXT=vt4F~%aDD7_i{vgy}Er5Tzm4+RUn5+ z$>eYul267Clh92ixOq+Q|7!5Vq-B1%4Ec+4OAFGu6FjPDVWg(RaUHl}cFNpv8FG7H zN~~*e3mHwXYk2#>3-bw?7cN8I@!m*0j+^qRwT0{^P{W)pQ^RFS?F~f+s5OP`7Er^S zD^tT|NL|!S+ZofHDcW|QYDl=%+A{qDmfOG$^BI{NE<^6IP8ZjA&sa*PdD3@+7v>_F z7cN8IA~dJWiVvW6#T zXT%FL`qYW=A3p*Kn%d+WkN|U)ECDV<33Ew;_za*o^2yzZdjA=h(4xuj_d*NIHL@1C z47C)K7I(bKJ$f_uJanUw_dx*64YB~Z3hXI$?tH9(7}KJF@DM+xU#TT*roz zL^tvOeJFytNmc}xp`sbAh>uyL9WHi!D{TexpXvn_nhxF%p#tVsSp{5%DyHOA_GXJ_rRccgPChGE^{4QNYLL_%vw7=pTj#n7d^Sa2aZtoYR2*hi?r8iihSY{1p5! z_sINk8S>9j`Ewc6ttlZz^Wyb$NP+p5ECnt@DGPm4yj_d@9h5q3X{3*%d7qymK`S&> zcRvKd+$Rfy%TUn7oFM1xSH7H~IY8-2u*2Lhv%_V`j(S|IMso%tv0TR;2f-839H8_o zNPzi~ECDV<3BDrgNbs!@g96RrNxy~yn1^Kra2YCaDo?JeoD*W5V`CfaRkRq@vYo$j zk7b3XFYzoC!8|G}g3C~muhMW7(MrYK_dJj)n&Z8mhX$C(Weso{YADHN4L;=@yJ`6F zT7Lo2P4c}69WYPII^Z(YF^P1D;VP$q_$mzDTk`Kf5A&2v50@c*5z(uo#drjoy5UuD z!#pE%!)3^Q2yxTNgM4a(@2*Q5!^dZNE*s`~nHeraX4DJ0(iqaeJ0V=cpNYzbIUq}b z%TNLmo=yo)^eENhiQ(LDf*a-)nHw%cZsa+!B}MJpo)k|14(MV2Ak)KTNRKvwr^rGQ zzA2oYC(~hGm)YSmWJkf@ki>vsORAcV=%MqHcqg~igVdc8{4Vj?FmKB`;4;*KN>J9p z*&$aEmugN5{ueaB{7u#Xm!Sr{WVjkur)f=BBA)KdP2TvlXpRjofCQNLWG!&DiE%Ri zzxN+B8{N3BaSiRs6{L;yo~LPv27?RcKlqWG)Q79hjC52}EbfhsgHluL4FeO*;2{zv zT!xh6obSr}-zY(>d5aqfVwmAFFdC=0cJMu8p7x?&*a#h2(e)BIZ-}#kG~AhOYnJgif3Kz3ZP42j)B2e ze;yR)q~Y(g@<6f88yGSO;XP?M#)OYqvFE{u&-d~)I)Bj9UIH0YV5Y;A!0<@m9Q@)N zEW@w)FbiQ8!;HsO@cm8xBqs02<@5UZXawFx&ci%BzQSWpJkY^o3;b%&Z`b^K%P)5P zqRDSm{9?ne7Tmk%&Mfz;xjSidABTGx+|S}RpIcsT0J-1CO%S&MT=}kr$m5X)I6Z_H z*7M#edlUY|*+@LRZBIlT&TZn8)A%?tyAZd^n=v>W>_!N0Hp5B>K9-Y91b-BhKS*g` zj1YYKk-vJ#hk*0P2KnS4o4;akB2eB#dnJBhxficR<7HTUu7$l0GO+f^?nMZ`gvVc~ zvv0&NY&qgpO8jwZ{zx`|BaKh}=I?d$ej#3}!e1`qlYjWLVZ4}#cTw52&LPlxAhdB&J0?RY5%H;;BHLike~Jmk+?8Lxx1VF0GV%!I-E z0vo49@aZe|D)=tqIMfa}ijB{2;4@Kp;}V~l%11rhl|bjf%!gSBQwD>xb?hT>Dc)P& zi9h+fJG`HEI{xHgao&2r6>-?e%Bv4-{xZ&N`1s>A{HYk;1d8c+UL?Q^M)-7LKHQgE zD&8M#ABTSpdzJY>0edz6+=)N=^Dm=t0iJ~zgI|+iieSdUR3q-w`1Jz*HU1(6Zwtig zBi=E?-%Y7sh|}h6sxb@p7wjMJ&il|OUf0u^W;DyYfB43jje}2|l;+xm3m`wkT*A)= z3s+m536LH3k8v-@ZI+XQ{2+7n;|lz1TuJiHuEL*upIjMm0bCCsXUJy!IvM5^7%mcA zNp8iTTrYDCy&ZpYbHCck0vwT;{_{HD_jg*U%}l z_@bXvMsvjzA8&KY-u?LX01THJ&gz`$AA^r`5oeKH?%;>}0?-36oaylu7pG3*@0;+` zmP1kxQB26aa_8v$JMF!vFnpJWjfUiH}%{=VQ-$(UJXG}91g=} znTs(OUM|L5pabnaH}!!Ap8Eyd@>k+g%V4-eb1Z%x55p~2Eq-xRg+;PX`+}9BPHTas zk-S)umkT=Gj&}GuU`~VKy0sg>(lA_s_2Ac;FlWPXYr(b71^AO|-b?W7GMFo1u7bH5 zhU;&x&bb!jz6{r+JlDsq4^M>gR20tv@jMJqeelc!2Kk+y35L3z?nys>VSLrsGr_o? z(>-|+zqs$goswK1CD1(y^h^e$@!%IHZru2Vf_wPf)kf!*JD&T8x3z@ zaPk`ks@Y==Oj@#U_?v*<$>Af^NdC9`#zu|oZH*e)cXrgs-Xs6_kp_1Z`Q9&xeD8Z} zqux=UHLzes)ZkugU}jm=;Ql$0uiHPPGV)bRmVOwa3y+I@)#zG#s|KbmiF)1M>_AC* zNbpD$kf7Q zO4P{c?7gQ%y=GtJ`orLwk?*LlC#uf9k#+8k|L?E4FY+Dj9T}CqFY-0}BIml^$oC$d z-5}*7>-;d-qnEho&uDMt{Mi>hDd>VJ$gAZxMok}JBqGzMdWKnewxwiy67!e^vLM7V)U}PFLHYJMo!P@ z?YluMGbQTNG{~RvsMm~Md-p{yn+7^RjC+rq=cCu&(eEgF8)x*E(?8=QQJ-l4^kXB3 zmK+~BblNeIL#IZ5dF!7U`6brqMZT|UU~cr6?pe`q?XbwB6#b>^lmr`uktfwWJ!0OQ zgUS6)4jZLL@xS?BhHA#L`sb**%Rqp^RsRQ}i`OXWs=2CBE-)&Ndp8UmVNi5dMpeA8 zYM?^RVcJJgsbm{XO6;9Duqa9?+;AWaYaQ|F2-)hw^h^#i`syYEB`j#xHb)i~pG*{iTVPN9IsA;fwX4J_1?NdOm zS#Hz}vpU0}fh+e{s98*t5dBm11LMJ~E>If?-BqXS$3g>F%|FH(2=31_92*SHGaMTX z%`*-f44rT&dm>ae{n0a6|8)IKPEbJf3amfRuyOFJ2B8LtWpG;tPs<<$=2S&~T6tzX zf{FFvgc{tIK`F>H@Adz4TLy_`kOBswd8P^fixe<;1O}l7iDeLKkXQ!U#o)FKiea8N zw&2q;2sP;M7=$iSyGFY9&_L^ll34j?90MuaH*vtAI-a1PDh^z?e{%G`#?0tF)CKyN zuz-O4vzUS4{*vetrt0TLgIAp%xk<|ZG8(+@D)mOc_sHyhkyFXw z8AVRdzR2m>yD4hQ_eN&#jePIXONRk_^gCJ`_1>eWXJ6!0@|Snk@rJip&G{1xMETbq zdHq@b;LD~n&du-pM4tH}MEWZI{Op06Jb&;L{>J2eLj7+J9Qx*n^@9!?bk6WMKQ^SG YaKr^wpF8%6g5q-a9;5Hf8)>2u>b%7 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/asyncpg/exceptions/__pycache__/_base.cpython-311.pyc b/env/Lib/site-packages/asyncpg/exceptions/__pycache__/_base.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7d82a213194de0118edd4c39fa33ea7446df3d66 GIT binary patch literal 15384 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 oVpXgHf}0 +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import asyncpg +import sys +import textwrap + + +__all__ = ('PostgresError', 'FatalPostgresError', 'UnknownPostgresError', + 'InterfaceError', 'InterfaceWarning', 'PostgresLogMessage', + 'ClientConfigurationError', + 'InternalClientError', 'OutdatedSchemaCacheError', 'ProtocolError', + 'UnsupportedClientFeatureError', 'TargetServerAttributeNotMatched', + 'UnsupportedServerFeatureError') + + +def _is_asyncpg_class(cls): + modname = cls.__module__ + return modname == 'asyncpg' or modname.startswith('asyncpg.') + + +class PostgresMessageMeta(type): + + _message_map = {} + _field_map = { + 'S': 'severity', + 'V': 'severity_en', + 'C': 'sqlstate', + 'M': 'message', + 'D': 'detail', + 'H': 'hint', + 'P': 'position', + 'p': 'internal_position', + 'q': 'internal_query', + 'W': 'context', + 's': 'schema_name', + 't': 'table_name', + 'c': 'column_name', + 'd': 'data_type_name', + 'n': 'constraint_name', + 'F': 'server_source_filename', + 'L': 'server_source_line', + 'R': 'server_source_function' + } + + def __new__(mcls, name, bases, dct): + cls = super().__new__(mcls, name, bases, dct) + if cls.__module__ == mcls.__module__ and name == 'PostgresMessage': + for f in mcls._field_map.values(): + setattr(cls, f, None) + + if _is_asyncpg_class(cls): + mod = sys.modules[cls.__module__] + if hasattr(mod, name): + raise RuntimeError('exception class redefinition: {}'.format( + name)) + + code = dct.get('sqlstate') + if code is not None: + existing = mcls._message_map.get(code) + if existing is not None: + raise TypeError('{} has duplicate SQLSTATE code, which is' + 'already defined by {}'.format( + name, existing.__name__)) + mcls._message_map[code] = cls + + return cls + + @classmethod + def get_message_class_for_sqlstate(mcls, code): + return mcls._message_map.get(code, UnknownPostgresError) + + +class PostgresMessage(metaclass=PostgresMessageMeta): + + @classmethod + def _get_error_class(cls, fields): + sqlstate = fields.get('C') + return type(cls).get_message_class_for_sqlstate(sqlstate) + + @classmethod + def _get_error_dict(cls, fields, query): + dct = { + 'query': query + } + + field_map = type(cls)._field_map + for k, v in fields.items(): + field = field_map.get(k) + if field: + dct[field] = v + + return dct + + @classmethod + def _make_constructor(cls, fields, query=None): + dct = cls._get_error_dict(fields, query) + + exccls = cls._get_error_class(fields) + message = dct.get('message', '') + + # PostgreSQL will raise an exception when it detects + # that the result type of the query has changed from + # when the statement was prepared. + # + # The original error is somewhat cryptic and unspecific, + # so we raise a custom subclass that is easier to handle + # and identify. + # + # Note that we specifically do not rely on the error + # message, as it is localizable. + is_icse = ( + exccls.__name__ == 'FeatureNotSupportedError' and + _is_asyncpg_class(exccls) and + dct.get('server_source_function') == 'RevalidateCachedQuery' + ) + + if is_icse: + exceptions = sys.modules[exccls.__module__] + exccls = exceptions.InvalidCachedStatementError + message = ('cached statement plan is invalid due to a database ' + 'schema or configuration change') + + is_prepared_stmt_error = ( + exccls.__name__ in ('DuplicatePreparedStatementError', + 'InvalidSQLStatementNameError') and + _is_asyncpg_class(exccls) + ) + + if is_prepared_stmt_error: + hint = dct.get('hint', '') + hint += textwrap.dedent("""\ + + NOTE: pgbouncer with pool_mode set to "transaction" or + "statement" does not support prepared statements properly. + You have two options: + + * if you are using pgbouncer for connection pooling to a + single server, switch to the connection pool functionality + provided by asyncpg, it is a much better option for this + purpose; + + * if you have no option of avoiding the use of pgbouncer, + then you can set statement_cache_size to 0 when creating + the asyncpg connection object. + """) + + dct['hint'] = hint + + return exccls, message, dct + + def as_dict(self): + dct = {} + for f in type(self)._field_map.values(): + val = getattr(self, f) + if val is not None: + dct[f] = val + return dct + + +class PostgresError(PostgresMessage, Exception): + """Base class for all Postgres errors.""" + + def __str__(self): + msg = self.args[0] + if self.detail: + msg += '\nDETAIL: {}'.format(self.detail) + if self.hint: + msg += '\nHINT: {}'.format(self.hint) + + return msg + + @classmethod + def new(cls, fields, query=None): + exccls, message, dct = cls._make_constructor(fields, query) + ex = exccls(message) + ex.__dict__.update(dct) + return ex + + +class FatalPostgresError(PostgresError): + """A fatal error that should result in server disconnection.""" + + +class UnknownPostgresError(FatalPostgresError): + """An error with an unknown SQLSTATE code.""" + + +class InterfaceMessage: + def __init__(self, *, detail=None, hint=None): + self.detail = detail + self.hint = hint + + def __str__(self): + msg = self.args[0] + if self.detail: + msg += '\nDETAIL: {}'.format(self.detail) + if self.hint: + msg += '\nHINT: {}'.format(self.hint) + + return msg + + +class InterfaceError(InterfaceMessage, Exception): + """An error caused by improper use of asyncpg API.""" + + def __init__(self, msg, *, detail=None, hint=None): + InterfaceMessage.__init__(self, detail=detail, hint=hint) + Exception.__init__(self, msg) + + def with_msg(self, msg): + return type(self)( + msg, + detail=self.detail, + hint=self.hint, + ).with_traceback( + self.__traceback__ + ) + + +class ClientConfigurationError(InterfaceError, ValueError): + """An error caused by improper client configuration.""" + + +class DataError(InterfaceError, ValueError): + """An error caused by invalid query input.""" + + +class UnsupportedClientFeatureError(InterfaceError): + """Requested feature is unsupported by asyncpg.""" + + +class UnsupportedServerFeatureError(InterfaceError): + """Requested feature is unsupported by PostgreSQL server.""" + + +class InterfaceWarning(InterfaceMessage, UserWarning): + """A warning caused by an improper use of asyncpg API.""" + + def __init__(self, msg, *, detail=None, hint=None): + InterfaceMessage.__init__(self, detail=detail, hint=hint) + UserWarning.__init__(self, msg) + + +class InternalClientError(Exception): + """All unexpected errors not classified otherwise.""" + + +class ProtocolError(InternalClientError): + """Unexpected condition in the handling of PostgreSQL protocol input.""" + + +class TargetServerAttributeNotMatched(InternalClientError): + """Could not find a host that satisfies the target attribute requirement""" + + +class OutdatedSchemaCacheError(InternalClientError): + """A value decoding error caused by a schema change before row fetching.""" + + def __init__(self, msg, *, schema=None, data_type=None, position=None): + super().__init__(msg) + self.schema_name = schema + self.data_type_name = data_type + self.position = position + + +class PostgresLogMessage(PostgresMessage): + """A base class for non-error server messages.""" + + def __str__(self): + return '{}: {}'.format(type(self).__name__, self.message) + + def __setattr__(self, name, val): + raise TypeError('instances of {} are immutable'.format( + type(self).__name__)) + + @classmethod + def new(cls, fields, query=None): + exccls, message_text, dct = cls._make_constructor(fields, query) + + if exccls is UnknownPostgresError: + exccls = PostgresLogMessage + + if exccls is PostgresLogMessage: + severity = dct.get('severity_en') or dct.get('severity') + if severity and severity.upper() == 'WARNING': + exccls = asyncpg.PostgresWarning + + if issubclass(exccls, (BaseException, Warning)): + msg = exccls(message_text) + else: + msg = exccls() + + msg.__dict__.update(dct) + return msg diff --git a/env/Lib/site-packages/asyncpg/introspection.py b/env/Lib/site-packages/asyncpg/introspection.py new file mode 100644 index 0000000..6c2caf0 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/introspection.py @@ -0,0 +1,292 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +_TYPEINFO_13 = '''\ + ( + SELECT + t.oid AS oid, + ns.nspname AS ns, + t.typname AS name, + t.typtype AS kind, + (CASE WHEN t.typtype = 'd' THEN + (WITH RECURSIVE typebases(oid, depth) AS ( + SELECT + t2.typbasetype AS oid, + 0 AS depth + FROM + pg_type t2 + WHERE + t2.oid = t.oid + + UNION ALL + + SELECT + t2.typbasetype AS oid, + tb.depth + 1 AS depth + FROM + pg_type t2, + typebases tb + WHERE + tb.oid = t2.oid + AND t2.typbasetype != 0 + ) SELECT oid FROM typebases ORDER BY depth DESC LIMIT 1) + + ELSE NULL + END) AS basetype, + t.typelem AS elemtype, + elem_t.typdelim AS elemdelim, + range_t.rngsubtype AS range_subtype, + (CASE WHEN t.typtype = 'c' THEN + (SELECT + array_agg(ia.atttypid ORDER BY ia.attnum) + FROM + pg_attribute ia + INNER JOIN pg_class c + ON (ia.attrelid = c.oid) + WHERE + ia.attnum > 0 AND NOT ia.attisdropped + AND c.reltype = t.oid) + + ELSE NULL + END) AS attrtypoids, + (CASE WHEN t.typtype = 'c' THEN + (SELECT + array_agg(ia.attname::text ORDER BY ia.attnum) + FROM + pg_attribute ia + INNER JOIN pg_class c + ON (ia.attrelid = c.oid) + WHERE + ia.attnum > 0 AND NOT ia.attisdropped + AND c.reltype = t.oid) + + ELSE NULL + END) AS attrnames + FROM + pg_catalog.pg_type AS t + INNER JOIN pg_catalog.pg_namespace ns ON ( + ns.oid = t.typnamespace) + LEFT JOIN pg_type elem_t ON ( + t.typlen = -1 AND + t.typelem != 0 AND + t.typelem = elem_t.oid + ) + LEFT JOIN pg_range range_t ON ( + t.oid = range_t.rngtypid + ) + ) +''' + + +INTRO_LOOKUP_TYPES_13 = '''\ +WITH RECURSIVE typeinfo_tree( + oid, ns, name, kind, basetype, elemtype, elemdelim, + range_subtype, attrtypoids, attrnames, depth) +AS ( + SELECT + ti.oid, ti.ns, ti.name, ti.kind, ti.basetype, + ti.elemtype, ti.elemdelim, ti.range_subtype, + ti.attrtypoids, ti.attrnames, 0 + FROM + {typeinfo} AS ti + WHERE + ti.oid = any($1::oid[]) + + UNION ALL + + SELECT + ti.oid, ti.ns, ti.name, ti.kind, ti.basetype, + ti.elemtype, ti.elemdelim, ti.range_subtype, + ti.attrtypoids, ti.attrnames, tt.depth + 1 + FROM + {typeinfo} ti, + typeinfo_tree tt + WHERE + (tt.elemtype IS NOT NULL AND ti.oid = tt.elemtype) + OR (tt.attrtypoids IS NOT NULL AND ti.oid = any(tt.attrtypoids)) + OR (tt.range_subtype IS NOT NULL AND ti.oid = tt.range_subtype) + OR (tt.basetype IS NOT NULL AND ti.oid = tt.basetype) +) + +SELECT DISTINCT + *, + basetype::regtype::text AS basetype_name, + elemtype::regtype::text AS elemtype_name, + range_subtype::regtype::text AS range_subtype_name +FROM + typeinfo_tree +ORDER BY + depth DESC +'''.format(typeinfo=_TYPEINFO_13) + + +_TYPEINFO = '''\ + ( + SELECT + t.oid AS oid, + ns.nspname AS ns, + t.typname AS name, + t.typtype AS kind, + (CASE WHEN t.typtype = 'd' THEN + (WITH RECURSIVE typebases(oid, depth) AS ( + SELECT + t2.typbasetype AS oid, + 0 AS depth + FROM + pg_type t2 + WHERE + t2.oid = t.oid + + UNION ALL + + SELECT + t2.typbasetype AS oid, + tb.depth + 1 AS depth + FROM + pg_type t2, + typebases tb + WHERE + tb.oid = t2.oid + AND t2.typbasetype != 0 + ) SELECT oid FROM typebases ORDER BY depth DESC LIMIT 1) + + ELSE NULL + END) AS basetype, + t.typelem AS elemtype, + elem_t.typdelim AS elemdelim, + COALESCE( + range_t.rngsubtype, + multirange_t.rngsubtype) AS range_subtype, + (CASE WHEN t.typtype = 'c' THEN + (SELECT + array_agg(ia.atttypid ORDER BY ia.attnum) + FROM + pg_attribute ia + INNER JOIN pg_class c + ON (ia.attrelid = c.oid) + WHERE + ia.attnum > 0 AND NOT ia.attisdropped + AND c.reltype = t.oid) + + ELSE NULL + END) AS attrtypoids, + (CASE WHEN t.typtype = 'c' THEN + (SELECT + array_agg(ia.attname::text ORDER BY ia.attnum) + FROM + pg_attribute ia + INNER JOIN pg_class c + ON (ia.attrelid = c.oid) + WHERE + ia.attnum > 0 AND NOT ia.attisdropped + AND c.reltype = t.oid) + + ELSE NULL + END) AS attrnames + FROM + pg_catalog.pg_type AS t + INNER JOIN pg_catalog.pg_namespace ns ON ( + ns.oid = t.typnamespace) + LEFT JOIN pg_type elem_t ON ( + t.typlen = -1 AND + t.typelem != 0 AND + t.typelem = elem_t.oid + ) + LEFT JOIN pg_range range_t ON ( + t.oid = range_t.rngtypid + ) + LEFT JOIN pg_range multirange_t ON ( + t.oid = multirange_t.rngmultitypid + ) + ) +''' + + +INTRO_LOOKUP_TYPES = '''\ +WITH RECURSIVE typeinfo_tree( + oid, ns, name, kind, basetype, elemtype, elemdelim, + range_subtype, attrtypoids, attrnames, depth) +AS ( + SELECT + ti.oid, ti.ns, ti.name, ti.kind, ti.basetype, + ti.elemtype, ti.elemdelim, ti.range_subtype, + ti.attrtypoids, ti.attrnames, 0 + FROM + {typeinfo} AS ti + WHERE + ti.oid = any($1::oid[]) + + UNION ALL + + SELECT + ti.oid, ti.ns, ti.name, ti.kind, ti.basetype, + ti.elemtype, ti.elemdelim, ti.range_subtype, + ti.attrtypoids, ti.attrnames, tt.depth + 1 + FROM + {typeinfo} ti, + typeinfo_tree tt + WHERE + (tt.elemtype IS NOT NULL AND ti.oid = tt.elemtype) + OR (tt.attrtypoids IS NOT NULL AND ti.oid = any(tt.attrtypoids)) + OR (tt.range_subtype IS NOT NULL AND ti.oid = tt.range_subtype) + OR (tt.basetype IS NOT NULL AND ti.oid = tt.basetype) +) + +SELECT DISTINCT + *, + basetype::regtype::text AS basetype_name, + elemtype::regtype::text AS elemtype_name, + range_subtype::regtype::text AS range_subtype_name +FROM + typeinfo_tree +ORDER BY + depth DESC +'''.format(typeinfo=_TYPEINFO) + + +TYPE_BY_NAME = '''\ +SELECT + t.oid, + t.typelem AS elemtype, + t.typtype AS kind +FROM + pg_catalog.pg_type AS t + INNER JOIN pg_catalog.pg_namespace ns ON (ns.oid = t.typnamespace) +WHERE + t.typname = $1 AND ns.nspname = $2 +''' + + +TYPE_BY_OID = '''\ +SELECT + t.oid, + t.typelem AS elemtype, + t.typtype AS kind +FROM + pg_catalog.pg_type AS t +WHERE + t.oid = $1 +''' + + +# 'b' for a base type, 'd' for a domain, 'e' for enum. +SCALAR_TYPE_KINDS = (b'b', b'd', b'e') + + +def is_scalar_type(typeinfo) -> bool: + return ( + typeinfo['kind'] in SCALAR_TYPE_KINDS and + not typeinfo['elemtype'] + ) + + +def is_domain_type(typeinfo) -> bool: + return typeinfo['kind'] == b'd' + + +def is_composite_type(typeinfo) -> bool: + return typeinfo['kind'] == b'c' diff --git a/env/Lib/site-packages/asyncpg/pgproto/__init__.pxd b/env/Lib/site-packages/asyncpg/pgproto/__init__.pxd new file mode 100644 index 0000000..1df403c --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/__init__.pxd @@ -0,0 +1,5 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 diff --git a/env/Lib/site-packages/asyncpg/pgproto/__init__.py b/env/Lib/site-packages/asyncpg/pgproto/__init__.py new file mode 100644 index 0000000..1df403c --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/__init__.py @@ -0,0 +1,5 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 diff --git a/env/Lib/site-packages/asyncpg/pgproto/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/asyncpg/pgproto/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d06c9c2d44b1ed1f13edaeb776fca317d6dc07f5 GIT binary patch literal 185 zcmZ3^%ge<81Y2jHNxKE4AA>kBzzAi0W&<*&Go&yCGiWmUtz;--0`fnDB!Bt1SjB|r z7iGsd=ci=mrN?BK7A2PC7sV&#m&ByzmBsjECdCwImZa(yBqnDkrl%IiBolIY~;;_lhPbtkwwJTx;8V<6)m>)=dU}j`w{J;PsikN|7 E03;wWIRF3v literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/asyncpg/pgproto/__pycache__/types.cpython-311.pyc b/env/Lib/site-packages/asyncpg/pgproto/__pycache__/types.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4ce98ee7d4544408768fa14f527384aee78fc5e5 GIT binary patch literal 21953 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 TV|qv4+x3VNJXs+X +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef class WriteBuffer: + cdef: + # Preallocated small buffer + bint _smallbuf_inuse + char _smallbuf[_BUFFER_INITIAL_SIZE] + + char *_buf + + # Allocated size + ssize_t _size + + # Length of data in the buffer + ssize_t _length + + # Number of memoryviews attached to the buffer + int _view_count + + # True is start_message was used + bint _message_mode + + cdef inline len(self): + return self._length + + cdef inline write_len_prefixed_utf8(self, str s): + return self.write_len_prefixed_bytes(s.encode('utf-8')) + + cdef inline _check_readonly(self) + cdef inline _ensure_alloced(self, ssize_t extra_length) + cdef _reallocate(self, ssize_t new_size) + cdef inline reset(self) + cdef inline start_message(self, char type) + cdef inline end_message(self) + cdef write_buffer(self, WriteBuffer buf) + cdef write_byte(self, char b) + cdef write_bytes(self, bytes data) + cdef write_len_prefixed_buffer(self, WriteBuffer buf) + cdef write_len_prefixed_bytes(self, bytes data) + cdef write_bytestring(self, bytes string) + cdef write_str(self, str string, str encoding) + cdef write_frbuf(self, FRBuffer *buf) + cdef write_cstr(self, const char *data, ssize_t len) + cdef write_int16(self, int16_t i) + cdef write_int32(self, int32_t i) + cdef write_int64(self, int64_t i) + cdef write_float(self, float f) + cdef write_double(self, double d) + + @staticmethod + cdef WriteBuffer new_message(char type) + + @staticmethod + cdef WriteBuffer new() + + +ctypedef const char * (*try_consume_message_method)(object, ssize_t*) +ctypedef int32_t (*take_message_type_method)(object, char) except -1 +ctypedef int32_t (*take_message_method)(object) except -1 +ctypedef char (*get_message_type_method)(object) + + +cdef class ReadBuffer: + cdef: + # A deque of buffers (bytes objects) + object _bufs + object _bufs_append + object _bufs_popleft + + # A pointer to the first buffer in `_bufs` + bytes _buf0 + + # A pointer to the previous first buffer + # (used to prolong the life of _buf0 when using + # methods like _try_read_bytes) + bytes _buf0_prev + + # Number of buffers in `_bufs` + int32_t _bufs_len + + # A read position in the first buffer in `_bufs` + ssize_t _pos0 + + # Length of the first buffer in `_bufs` + ssize_t _len0 + + # A total number of buffered bytes in ReadBuffer + ssize_t _length + + char _current_message_type + int32_t _current_message_len + ssize_t _current_message_len_unread + bint _current_message_ready + + cdef inline len(self): + return self._length + + cdef inline char get_message_type(self): + return self._current_message_type + + cdef inline int32_t get_message_length(self): + return self._current_message_len + + cdef feed_data(self, data) + cdef inline _ensure_first_buf(self) + cdef _switch_to_next_buf(self) + cdef inline char read_byte(self) except? -1 + cdef inline const char* _try_read_bytes(self, ssize_t nbytes) + cdef inline _read_into(self, char *buf, ssize_t nbytes) + cdef inline _read_and_discard(self, ssize_t nbytes) + cdef bytes read_bytes(self, ssize_t nbytes) + cdef bytes read_len_prefixed_bytes(self) + cdef str read_len_prefixed_utf8(self) + cdef read_uuid(self) + cdef inline int64_t read_int64(self) except? -1 + cdef inline int32_t read_int32(self) except? -1 + cdef inline int16_t read_int16(self) except? -1 + cdef inline read_null_str(self) + cdef int32_t take_message(self) except -1 + cdef inline int32_t take_message_type(self, char mtype) except -1 + cdef int32_t put_message(self) except -1 + cdef inline const char* try_consume_message(self, ssize_t* len) + cdef bytes consume_message(self) + cdef discard_message(self) + cdef redirect_messages(self, WriteBuffer buf, char mtype, int stop_at=?) + cdef bytearray consume_messages(self, char mtype) + cdef finish_message(self) + cdef inline _finish_message(self) + + @staticmethod + cdef ReadBuffer new_message_parser(object data) diff --git a/env/Lib/site-packages/asyncpg/pgproto/buffer.pyx b/env/Lib/site-packages/asyncpg/pgproto/buffer.pyx new file mode 100644 index 0000000..e05d4c7 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/buffer.pyx @@ -0,0 +1,817 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +from libc.string cimport memcpy + +import collections + +class BufferError(Exception): + pass + +@cython.no_gc_clear +@cython.final +@cython.freelist(_BUFFER_FREELIST_SIZE) +cdef class WriteBuffer: + + def __cinit__(self): + self._smallbuf_inuse = True + self._buf = self._smallbuf + self._size = _BUFFER_INITIAL_SIZE + self._length = 0 + self._message_mode = 0 + + def __dealloc__(self): + if self._buf is not NULL and not self._smallbuf_inuse: + cpython.PyMem_Free(self._buf) + self._buf = NULL + self._size = 0 + + if self._view_count: + raise BufferError( + 'Deallocating buffer with attached memoryviews') + + def __getbuffer__(self, Py_buffer *buffer, int flags): + self._view_count += 1 + + cpython.PyBuffer_FillInfo( + buffer, self, self._buf, self._length, + 1, # read-only + flags) + + def __releasebuffer__(self, Py_buffer *buffer): + self._view_count -= 1 + + cdef inline _check_readonly(self): + if self._view_count: + raise BufferError('the buffer is in read-only mode') + + cdef inline _ensure_alloced(self, ssize_t extra_length): + cdef ssize_t new_size = extra_length + self._length + + if new_size > self._size: + self._reallocate(new_size) + + cdef _reallocate(self, ssize_t new_size): + cdef char *new_buf + + if new_size < _BUFFER_MAX_GROW: + new_size = _BUFFER_MAX_GROW + else: + # Add a little extra + new_size += _BUFFER_INITIAL_SIZE + + if self._smallbuf_inuse: + new_buf = cpython.PyMem_Malloc( + sizeof(char) * new_size) + if new_buf is NULL: + self._buf = NULL + self._size = 0 + self._length = 0 + raise MemoryError + memcpy(new_buf, self._buf, self._size) + self._size = new_size + self._buf = new_buf + self._smallbuf_inuse = False + else: + new_buf = cpython.PyMem_Realloc( + self._buf, new_size) + if new_buf is NULL: + cpython.PyMem_Free(self._buf) + self._buf = NULL + self._size = 0 + self._length = 0 + raise MemoryError + self._buf = new_buf + self._size = new_size + + cdef inline start_message(self, char type): + if self._length != 0: + raise BufferError( + 'cannot start_message for a non-empty buffer') + self._ensure_alloced(5) + self._message_mode = 1 + self._buf[0] = type + self._length = 5 + + cdef inline end_message(self): + # "length-1" to exclude the message type byte + cdef ssize_t mlen = self._length - 1 + + self._check_readonly() + if not self._message_mode: + raise BufferError( + 'end_message can only be called with start_message') + if self._length < 5: + raise BufferError('end_message: buffer is too small') + if mlen > _MAXINT32: + raise BufferError('end_message: message is too large') + + hton.pack_int32(&self._buf[1], mlen) + return self + + cdef inline reset(self): + self._length = 0 + self._message_mode = 0 + + cdef write_buffer(self, WriteBuffer buf): + self._check_readonly() + + if not buf._length: + return + + self._ensure_alloced(buf._length) + memcpy(self._buf + self._length, + buf._buf, + buf._length) + self._length += buf._length + + cdef write_byte(self, char b): + self._check_readonly() + + self._ensure_alloced(1) + self._buf[self._length] = b + self._length += 1 + + cdef write_bytes(self, bytes data): + cdef char* buf + cdef ssize_t len + + cpython.PyBytes_AsStringAndSize(data, &buf, &len) + self.write_cstr(buf, len) + + cdef write_bytestring(self, bytes string): + cdef char* buf + cdef ssize_t len + + cpython.PyBytes_AsStringAndSize(string, &buf, &len) + # PyBytes_AsStringAndSize returns a null-terminated buffer, + # but the null byte is not counted in len. hence the + 1 + self.write_cstr(buf, len + 1) + + cdef write_str(self, str string, str encoding): + self.write_bytestring(string.encode(encoding)) + + cdef write_len_prefixed_buffer(self, WriteBuffer buf): + # Write a length-prefixed (not NULL-terminated) bytes sequence. + self.write_int32(buf.len()) + self.write_buffer(buf) + + cdef write_len_prefixed_bytes(self, bytes data): + # Write a length-prefixed (not NULL-terminated) bytes sequence. + cdef: + char *buf + ssize_t size + + cpython.PyBytes_AsStringAndSize(data, &buf, &size) + if size > _MAXINT32: + raise BufferError('string is too large') + # `size` does not account for the NULL at the end. + self.write_int32(size) + self.write_cstr(buf, size) + + cdef write_frbuf(self, FRBuffer *buf): + cdef: + ssize_t buf_len = buf.len + if buf_len > 0: + self.write_cstr(frb_read_all(buf), buf_len) + + cdef write_cstr(self, const char *data, ssize_t len): + self._check_readonly() + self._ensure_alloced(len) + + memcpy(self._buf + self._length, data, len) + self._length += len + + cdef write_int16(self, int16_t i): + self._check_readonly() + self._ensure_alloced(2) + + hton.pack_int16(&self._buf[self._length], i) + self._length += 2 + + cdef write_int32(self, int32_t i): + self._check_readonly() + self._ensure_alloced(4) + + hton.pack_int32(&self._buf[self._length], i) + self._length += 4 + + cdef write_int64(self, int64_t i): + self._check_readonly() + self._ensure_alloced(8) + + hton.pack_int64(&self._buf[self._length], i) + self._length += 8 + + cdef write_float(self, float f): + self._check_readonly() + self._ensure_alloced(4) + + hton.pack_float(&self._buf[self._length], f) + self._length += 4 + + cdef write_double(self, double d): + self._check_readonly() + self._ensure_alloced(8) + + hton.pack_double(&self._buf[self._length], d) + self._length += 8 + + @staticmethod + cdef WriteBuffer new_message(char type): + cdef WriteBuffer buf + buf = WriteBuffer.__new__(WriteBuffer) + buf.start_message(type) + return buf + + @staticmethod + cdef WriteBuffer new(): + cdef WriteBuffer buf + buf = WriteBuffer.__new__(WriteBuffer) + return buf + + +@cython.no_gc_clear +@cython.final +@cython.freelist(_BUFFER_FREELIST_SIZE) +cdef class ReadBuffer: + + def __cinit__(self): + self._bufs = collections.deque() + self._bufs_append = self._bufs.append + self._bufs_popleft = self._bufs.popleft + self._bufs_len = 0 + self._buf0 = None + self._buf0_prev = None + self._pos0 = 0 + self._len0 = 0 + self._length = 0 + + self._current_message_type = 0 + self._current_message_len = 0 + self._current_message_len_unread = 0 + self._current_message_ready = 0 + + cdef feed_data(self, data): + cdef: + ssize_t dlen + bytes data_bytes + + if not cpython.PyBytes_CheckExact(data): + if cpythonx.PyByteArray_CheckExact(data): + # ProactorEventLoop in Python 3.10+ seems to be sending + # bytearray objects instead of bytes. Handle this here + # to avoid duplicating this check in every data_received(). + data = bytes(data) + else: + raise BufferError( + 'feed_data: a bytes or bytearray object expected') + + # Uncomment the below code to test code paths that + # read single int/str/bytes sequences are split over + # multiple received buffers. + # + # ll = 107 + # if len(data) > ll: + # self.feed_data(data[:ll]) + # self.feed_data(data[ll:]) + # return + + data_bytes = data + + dlen = cpython.Py_SIZE(data_bytes) + if dlen == 0: + # EOF? + return + + self._bufs_append(data_bytes) + self._length += dlen + + if self._bufs_len == 0: + # First buffer + self._len0 = dlen + self._buf0 = data_bytes + + self._bufs_len += 1 + + cdef inline _ensure_first_buf(self): + if PG_DEBUG: + if self._len0 == 0: + raise BufferError('empty first buffer') + if self._length == 0: + raise BufferError('empty buffer') + + if self._pos0 == self._len0: + self._switch_to_next_buf() + + cdef _switch_to_next_buf(self): + # The first buffer is fully read, discard it + self._bufs_popleft() + self._bufs_len -= 1 + + # Shouldn't fail, since we've checked that `_length >= 1` + # in _ensure_first_buf() + self._buf0_prev = self._buf0 + self._buf0 = self._bufs[0] + + self._pos0 = 0 + self._len0 = len(self._buf0) + + if PG_DEBUG: + if self._len0 < 1: + raise BufferError( + 'debug: second buffer of ReadBuffer is empty') + + cdef inline const char* _try_read_bytes(self, ssize_t nbytes): + # Try to read *nbytes* from the first buffer. + # + # Returns pointer to data if there is at least *nbytes* + # in the buffer, NULL otherwise. + # + # Important: caller must call _ensure_first_buf() prior + # to calling try_read_bytes, and must not overread + + cdef: + const char *result + + if PG_DEBUG: + if nbytes > self._length: + return NULL + + if self._current_message_ready: + if self._current_message_len_unread < nbytes: + return NULL + + if self._pos0 + nbytes <= self._len0: + result = cpython.PyBytes_AS_STRING(self._buf0) + result += self._pos0 + self._pos0 += nbytes + self._length -= nbytes + if self._current_message_ready: + self._current_message_len_unread -= nbytes + return result + else: + return NULL + + cdef inline _read_into(self, char *buf, ssize_t nbytes): + cdef: + ssize_t nread + char *buf0 + + while True: + buf0 = cpython.PyBytes_AS_STRING(self._buf0) + + if self._pos0 + nbytes > self._len0: + nread = self._len0 - self._pos0 + memcpy(buf, buf0 + self._pos0, nread) + self._pos0 = self._len0 + self._length -= nread + nbytes -= nread + buf += nread + self._ensure_first_buf() + + else: + memcpy(buf, buf0 + self._pos0, nbytes) + self._pos0 += nbytes + self._length -= nbytes + break + + cdef inline _read_and_discard(self, ssize_t nbytes): + cdef: + ssize_t nread + + self._ensure_first_buf() + while True: + if self._pos0 + nbytes > self._len0: + nread = self._len0 - self._pos0 + self._pos0 = self._len0 + self._length -= nread + nbytes -= nread + self._ensure_first_buf() + + else: + self._pos0 += nbytes + self._length -= nbytes + break + + cdef bytes read_bytes(self, ssize_t nbytes): + cdef: + bytes result + ssize_t nread + const char *cbuf + char *buf + + self._ensure_first_buf() + cbuf = self._try_read_bytes(nbytes) + if cbuf != NULL: + return cpython.PyBytes_FromStringAndSize(cbuf, nbytes) + + if nbytes > self._length: + raise BufferError( + 'not enough data to read {} bytes'.format(nbytes)) + + if self._current_message_ready: + self._current_message_len_unread -= nbytes + if self._current_message_len_unread < 0: + raise BufferError('buffer overread') + + result = cpython.PyBytes_FromStringAndSize(NULL, nbytes) + buf = cpython.PyBytes_AS_STRING(result) + self._read_into(buf, nbytes) + return result + + cdef bytes read_len_prefixed_bytes(self): + cdef int32_t size = self.read_int32() + if size < 0: + raise BufferError( + 'negative length for a len-prefixed bytes value') + if size == 0: + return b'' + return self.read_bytes(size) + + cdef str read_len_prefixed_utf8(self): + cdef: + int32_t size + const char *cbuf + + size = self.read_int32() + if size < 0: + raise BufferError( + 'negative length for a len-prefixed bytes value') + + if size == 0: + return '' + + self._ensure_first_buf() + cbuf = self._try_read_bytes(size) + if cbuf != NULL: + return cpython.PyUnicode_DecodeUTF8(cbuf, size, NULL) + else: + return self.read_bytes(size).decode('utf-8') + + cdef read_uuid(self): + cdef: + bytes mem + const char *cbuf + + self._ensure_first_buf() + cbuf = self._try_read_bytes(16) + if cbuf != NULL: + return pg_uuid_from_buf(cbuf) + else: + return pg_UUID(self.read_bytes(16)) + + cdef inline char read_byte(self) except? -1: + cdef const char *first_byte + + if PG_DEBUG: + if not self._buf0: + raise BufferError( + 'debug: first buffer of ReadBuffer is empty') + + self._ensure_first_buf() + first_byte = self._try_read_bytes(1) + if first_byte is NULL: + raise BufferError('not enough data to read one byte') + + return first_byte[0] + + cdef inline int64_t read_int64(self) except? -1: + cdef: + bytes mem + const char *cbuf + + self._ensure_first_buf() + cbuf = self._try_read_bytes(8) + if cbuf != NULL: + return hton.unpack_int64(cbuf) + else: + mem = self.read_bytes(8) + return hton.unpack_int64(cpython.PyBytes_AS_STRING(mem)) + + cdef inline int32_t read_int32(self) except? -1: + cdef: + bytes mem + const char *cbuf + + self._ensure_first_buf() + cbuf = self._try_read_bytes(4) + if cbuf != NULL: + return hton.unpack_int32(cbuf) + else: + mem = self.read_bytes(4) + return hton.unpack_int32(cpython.PyBytes_AS_STRING(mem)) + + cdef inline int16_t read_int16(self) except? -1: + cdef: + bytes mem + const char *cbuf + + self._ensure_first_buf() + cbuf = self._try_read_bytes(2) + if cbuf != NULL: + return hton.unpack_int16(cbuf) + else: + mem = self.read_bytes(2) + return hton.unpack_int16(cpython.PyBytes_AS_STRING(mem)) + + cdef inline read_null_str(self): + if not self._current_message_ready: + raise BufferError( + 'read_null_str only works when the message guaranteed ' + 'to be in the buffer') + + cdef: + ssize_t pos + ssize_t nread + bytes result + const char *buf + const char *buf_start + + self._ensure_first_buf() + + buf_start = cpython.PyBytes_AS_STRING(self._buf0) + buf = buf_start + self._pos0 + while buf - buf_start < self._len0: + if buf[0] == 0: + pos = buf - buf_start + nread = pos - self._pos0 + buf = self._try_read_bytes(nread + 1) + if buf != NULL: + return cpython.PyBytes_FromStringAndSize(buf, nread) + else: + break + else: + buf += 1 + + result = b'' + while True: + pos = self._buf0.find(b'\x00', self._pos0) + if pos >= 0: + result += self._buf0[self._pos0 : pos] + nread = pos - self._pos0 + 1 + self._pos0 = pos + 1 + self._length -= nread + + self._current_message_len_unread -= nread + if self._current_message_len_unread < 0: + raise BufferError( + 'read_null_str: buffer overread') + + return result + + else: + result += self._buf0[self._pos0:] + nread = self._len0 - self._pos0 + self._pos0 = self._len0 + self._length -= nread + + self._current_message_len_unread -= nread + if self._current_message_len_unread < 0: + raise BufferError( + 'read_null_str: buffer overread') + + self._ensure_first_buf() + + cdef int32_t take_message(self) except -1: + cdef: + const char *cbuf + + if self._current_message_ready: + return 1 + + if self._current_message_type == 0: + if self._length < 1: + return 0 + self._ensure_first_buf() + cbuf = self._try_read_bytes(1) + if cbuf == NULL: + raise BufferError( + 'failed to read one byte on a non-empty buffer') + self._current_message_type = cbuf[0] + + if self._current_message_len == 0: + if self._length < 4: + return 0 + + self._ensure_first_buf() + cbuf = self._try_read_bytes(4) + if cbuf != NULL: + self._current_message_len = hton.unpack_int32(cbuf) + else: + self._current_message_len = self.read_int32() + + self._current_message_len_unread = self._current_message_len - 4 + + if self._length < self._current_message_len_unread: + return 0 + + self._current_message_ready = 1 + return 1 + + cdef inline int32_t take_message_type(self, char mtype) except -1: + cdef const char *buf0 + + if self._current_message_ready: + return self._current_message_type == mtype + elif self._length >= 1: + self._ensure_first_buf() + buf0 = cpython.PyBytes_AS_STRING(self._buf0) + + return buf0[self._pos0] == mtype and self.take_message() + else: + return 0 + + cdef int32_t put_message(self) except -1: + if not self._current_message_ready: + raise BufferError( + 'cannot put message: no message taken') + self._current_message_ready = False + return 0 + + cdef inline const char* try_consume_message(self, ssize_t* len): + cdef: + ssize_t buf_len + const char *buf + + if not self._current_message_ready: + return NULL + + self._ensure_first_buf() + buf_len = self._current_message_len_unread + buf = self._try_read_bytes(buf_len) + if buf != NULL: + len[0] = buf_len + self._finish_message() + return buf + + cdef discard_message(self): + if not self._current_message_ready: + raise BufferError('no message to discard') + if self._current_message_len_unread > 0: + self._read_and_discard(self._current_message_len_unread) + self._current_message_len_unread = 0 + self._finish_message() + + cdef bytes consume_message(self): + if not self._current_message_ready: + raise BufferError('no message to consume') + if self._current_message_len_unread > 0: + mem = self.read_bytes(self._current_message_len_unread) + else: + mem = b'' + self._finish_message() + return mem + + cdef redirect_messages(self, WriteBuffer buf, char mtype, + int stop_at=0): + if not self._current_message_ready: + raise BufferError( + 'consume_full_messages called on a buffer without a ' + 'complete first message') + if mtype != self._current_message_type: + raise BufferError( + 'consume_full_messages called with a wrong mtype') + if self._current_message_len_unread != self._current_message_len - 4: + raise BufferError( + 'consume_full_messages called on a partially read message') + + cdef: + const char* cbuf + ssize_t cbuf_len + int32_t msg_len + ssize_t new_pos0 + ssize_t pos_delta + int32_t done + + while True: + buf.write_byte(mtype) + buf.write_int32(self._current_message_len) + + cbuf = self.try_consume_message(&cbuf_len) + if cbuf != NULL: + buf.write_cstr(cbuf, cbuf_len) + else: + buf.write_bytes(self.consume_message()) + + if self._length > 0: + self._ensure_first_buf() + else: + return + + if stop_at and buf._length >= stop_at: + return + + # Fast path: exhaust buf0 as efficiently as possible. + if self._pos0 + 5 <= self._len0: + cbuf = cpython.PyBytes_AS_STRING(self._buf0) + new_pos0 = self._pos0 + cbuf_len = self._len0 + + done = 0 + # Scan the first buffer and find the position of the + # end of the last "mtype" message. + while new_pos0 + 5 <= cbuf_len: + if (cbuf + new_pos0)[0] != mtype: + done = 1 + break + if (stop_at and + (buf._length + new_pos0 - self._pos0) > stop_at): + done = 1 + break + msg_len = hton.unpack_int32(cbuf + new_pos0 + 1) + 1 + if new_pos0 + msg_len > cbuf_len: + break + new_pos0 += msg_len + + if new_pos0 != self._pos0: + assert self._pos0 < new_pos0 <= self._len0 + + pos_delta = new_pos0 - self._pos0 + buf.write_cstr( + cbuf + self._pos0, + pos_delta) + + self._pos0 = new_pos0 + self._length -= pos_delta + + assert self._length >= 0 + + if done: + # The next message is of a different type. + return + + # Back to slow path. + if not self.take_message_type(mtype): + return + + cdef bytearray consume_messages(self, char mtype): + """Consume consecutive messages of the same type.""" + cdef: + char *buf + ssize_t nbytes + ssize_t total_bytes = 0 + bytearray result + + if not self.take_message_type(mtype): + return None + + # consume_messages is a volume-oriented method, so + # we assume that the remainder of the buffer will contain + # messages of the requested type. + result = cpythonx.PyByteArray_FromStringAndSize(NULL, self._length) + buf = cpythonx.PyByteArray_AsString(result) + + while self.take_message_type(mtype): + self._ensure_first_buf() + nbytes = self._current_message_len_unread + self._read_into(buf, nbytes) + buf += nbytes + total_bytes += nbytes + self._finish_message() + + # Clamp the result to an actual size read. + cpythonx.PyByteArray_Resize(result, total_bytes) + + return result + + cdef finish_message(self): + if self._current_message_type == 0 or not self._current_message_ready: + # The message has already been finished (e.g by consume_message()), + # or has been put back by put_message(). + return + + if self._current_message_len_unread: + if PG_DEBUG: + mtype = chr(self._current_message_type) + + discarded = self.consume_message() + + if PG_DEBUG: + print('!!! discarding message {!r} unread data: {!r}'.format( + mtype, + discarded)) + + self._finish_message() + + cdef inline _finish_message(self): + self._current_message_type = 0 + self._current_message_len = 0 + self._current_message_ready = 0 + self._current_message_len_unread = 0 + + @staticmethod + cdef ReadBuffer new_message_parser(object data): + cdef ReadBuffer buf + + buf = ReadBuffer.__new__(ReadBuffer) + buf.feed_data(data) + + buf._current_message_ready = 1 + buf._current_message_len_unread = buf._len0 + + return buf diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/__init__.pxd b/env/Lib/site-packages/asyncpg/pgproto/codecs/__init__.pxd new file mode 100644 index 0000000..2dbcbd3 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/__init__.pxd @@ -0,0 +1,157 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef class CodecContext: + + cpdef get_text_codec(self) + cdef is_encoding_utf8(self) + cpdef get_json_decoder(self) + cdef is_decoding_json(self) + cpdef get_json_encoder(self) + cdef is_encoding_json(self) + + +ctypedef object (*encode_func)(CodecContext settings, + WriteBuffer buf, + object obj) + +ctypedef object (*decode_func)(CodecContext settings, + FRBuffer *buf) + + +# Datetime +cdef date_encode(CodecContext settings, WriteBuffer buf, obj) +cdef date_decode(CodecContext settings, FRBuffer * buf) +cdef date_encode_tuple(CodecContext settings, WriteBuffer buf, obj) +cdef date_decode_tuple(CodecContext settings, FRBuffer * buf) +cdef timestamp_encode(CodecContext settings, WriteBuffer buf, obj) +cdef timestamp_decode(CodecContext settings, FRBuffer * buf) +cdef timestamp_encode_tuple(CodecContext settings, WriteBuffer buf, obj) +cdef timestamp_decode_tuple(CodecContext settings, FRBuffer * buf) +cdef timestamptz_encode(CodecContext settings, WriteBuffer buf, obj) +cdef timestamptz_decode(CodecContext settings, FRBuffer * buf) +cdef time_encode(CodecContext settings, WriteBuffer buf, obj) +cdef time_decode(CodecContext settings, FRBuffer * buf) +cdef time_encode_tuple(CodecContext settings, WriteBuffer buf, obj) +cdef time_decode_tuple(CodecContext settings, FRBuffer * buf) +cdef timetz_encode(CodecContext settings, WriteBuffer buf, obj) +cdef timetz_decode(CodecContext settings, FRBuffer * buf) +cdef timetz_encode_tuple(CodecContext settings, WriteBuffer buf, obj) +cdef timetz_decode_tuple(CodecContext settings, FRBuffer * buf) +cdef interval_encode(CodecContext settings, WriteBuffer buf, obj) +cdef interval_decode(CodecContext settings, FRBuffer * buf) +cdef interval_encode_tuple(CodecContext settings, WriteBuffer buf, tuple obj) +cdef interval_decode_tuple(CodecContext settings, FRBuffer * buf) + + +# Bits +cdef bits_encode(CodecContext settings, WriteBuffer wbuf, obj) +cdef bits_decode(CodecContext settings, FRBuffer * buf) + + +# Bools +cdef bool_encode(CodecContext settings, WriteBuffer buf, obj) +cdef bool_decode(CodecContext settings, FRBuffer * buf) + + +# Geometry +cdef box_encode(CodecContext settings, WriteBuffer wbuf, obj) +cdef box_decode(CodecContext settings, FRBuffer * buf) +cdef line_encode(CodecContext settings, WriteBuffer wbuf, obj) +cdef line_decode(CodecContext settings, FRBuffer * buf) +cdef lseg_encode(CodecContext settings, WriteBuffer wbuf, obj) +cdef lseg_decode(CodecContext settings, FRBuffer * buf) +cdef point_encode(CodecContext settings, WriteBuffer wbuf, obj) +cdef point_decode(CodecContext settings, FRBuffer * buf) +cdef path_encode(CodecContext settings, WriteBuffer wbuf, obj) +cdef path_decode(CodecContext settings, FRBuffer * buf) +cdef poly_encode(CodecContext settings, WriteBuffer wbuf, obj) +cdef poly_decode(CodecContext settings, FRBuffer * buf) +cdef circle_encode(CodecContext settings, WriteBuffer wbuf, obj) +cdef circle_decode(CodecContext settings, FRBuffer * buf) + + +# Hstore +cdef hstore_encode(CodecContext settings, WriteBuffer buf, obj) +cdef hstore_decode(CodecContext settings, FRBuffer * buf) + + +# Ints +cdef int2_encode(CodecContext settings, WriteBuffer buf, obj) +cdef int2_decode(CodecContext settings, FRBuffer * buf) +cdef int4_encode(CodecContext settings, WriteBuffer buf, obj) +cdef int4_decode(CodecContext settings, FRBuffer * buf) +cdef uint4_encode(CodecContext settings, WriteBuffer buf, obj) +cdef uint4_decode(CodecContext settings, FRBuffer * buf) +cdef int8_encode(CodecContext settings, WriteBuffer buf, obj) +cdef int8_decode(CodecContext settings, FRBuffer * buf) +cdef uint8_encode(CodecContext settings, WriteBuffer buf, obj) +cdef uint8_decode(CodecContext settings, FRBuffer * buf) + + +# Floats +cdef float4_encode(CodecContext settings, WriteBuffer buf, obj) +cdef float4_decode(CodecContext settings, FRBuffer * buf) +cdef float8_encode(CodecContext settings, WriteBuffer buf, obj) +cdef float8_decode(CodecContext settings, FRBuffer * buf) + + +# JSON +cdef jsonb_encode(CodecContext settings, WriteBuffer buf, obj) +cdef jsonb_decode(CodecContext settings, FRBuffer * buf) + + +# JSON path +cdef jsonpath_encode(CodecContext settings, WriteBuffer buf, obj) +cdef jsonpath_decode(CodecContext settings, FRBuffer * buf) + + +# Text +cdef as_pg_string_and_size( + CodecContext settings, obj, char **cstr, ssize_t *size) +cdef text_encode(CodecContext settings, WriteBuffer buf, obj) +cdef text_decode(CodecContext settings, FRBuffer * buf) + +# Bytea +cdef bytea_encode(CodecContext settings, WriteBuffer wbuf, obj) +cdef bytea_decode(CodecContext settings, FRBuffer * buf) + + +# UUID +cdef uuid_encode(CodecContext settings, WriteBuffer wbuf, obj) +cdef uuid_decode(CodecContext settings, FRBuffer * buf) + + +# Numeric +cdef numeric_encode_text(CodecContext settings, WriteBuffer buf, obj) +cdef numeric_decode_text(CodecContext settings, FRBuffer * buf) +cdef numeric_encode_binary(CodecContext settings, WriteBuffer buf, obj) +cdef numeric_decode_binary(CodecContext settings, FRBuffer * buf) +cdef numeric_decode_binary_ex(CodecContext settings, FRBuffer * buf, + bint trail_fract_zero) + + +# Void +cdef void_encode(CodecContext settings, WriteBuffer buf, obj) +cdef void_decode(CodecContext settings, FRBuffer * buf) + + +# tid +cdef tid_encode(CodecContext settings, WriteBuffer buf, obj) +cdef tid_decode(CodecContext settings, FRBuffer * buf) + + +# Network +cdef cidr_encode(CodecContext settings, WriteBuffer buf, obj) +cdef cidr_decode(CodecContext settings, FRBuffer * buf) +cdef inet_encode(CodecContext settings, WriteBuffer buf, obj) +cdef inet_decode(CodecContext settings, FRBuffer * buf) + + +# pg_snapshot +cdef pg_snapshot_encode(CodecContext settings, WriteBuffer buf, obj) +cdef pg_snapshot_decode(CodecContext settings, FRBuffer * buf) diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/bits.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/bits.pyx new file mode 100644 index 0000000..14f7bb0 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/bits.pyx @@ -0,0 +1,47 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef bits_encode(CodecContext settings, WriteBuffer wbuf, obj): + cdef: + Py_buffer pybuf + bint pybuf_used = False + char *buf + ssize_t len + ssize_t bitlen + + if cpython.PyBytes_CheckExact(obj): + buf = cpython.PyBytes_AS_STRING(obj) + len = cpython.Py_SIZE(obj) + bitlen = len * 8 + elif isinstance(obj, pgproto_types.BitString): + cpython.PyBytes_AsStringAndSize(obj.bytes, &buf, &len) + bitlen = obj.__len__() + else: + cpython.PyObject_GetBuffer(obj, &pybuf, cpython.PyBUF_SIMPLE) + pybuf_used = True + buf = pybuf.buf + len = pybuf.len + bitlen = len * 8 + + try: + if bitlen > _MAXINT32: + raise ValueError('bit value too long') + wbuf.write_int32(4 + len) + wbuf.write_int32(bitlen) + wbuf.write_cstr(buf, len) + finally: + if pybuf_used: + cpython.PyBuffer_Release(&pybuf) + + +cdef bits_decode(CodecContext settings, FRBuffer *buf): + cdef: + int32_t bitlen = hton.unpack_int32(frb_read(buf, 4)) + ssize_t buf_len = buf.len + + bytes_ = cpython.PyBytes_FromStringAndSize(frb_read_all(buf), buf_len) + return pgproto_types.BitString.frombytes(bytes_, bitlen) diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/bytea.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/bytea.pyx new file mode 100644 index 0000000..1581825 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/bytea.pyx @@ -0,0 +1,34 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef bytea_encode(CodecContext settings, WriteBuffer wbuf, obj): + cdef: + Py_buffer pybuf + bint pybuf_used = False + char *buf + ssize_t len + + if cpython.PyBytes_CheckExact(obj): + buf = cpython.PyBytes_AS_STRING(obj) + len = cpython.Py_SIZE(obj) + else: + cpython.PyObject_GetBuffer(obj, &pybuf, cpython.PyBUF_SIMPLE) + pybuf_used = True + buf = pybuf.buf + len = pybuf.len + + try: + wbuf.write_int32(len) + wbuf.write_cstr(buf, len) + finally: + if pybuf_used: + cpython.PyBuffer_Release(&pybuf) + + +cdef bytea_decode(CodecContext settings, FRBuffer *buf): + cdef ssize_t buf_len = buf.len + return cpython.PyBytes_FromStringAndSize(frb_read_all(buf), buf_len) diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/context.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/context.pyx new file mode 100644 index 0000000..c4d4416 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/context.pyx @@ -0,0 +1,26 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef class CodecContext: + + cpdef get_text_codec(self): + raise NotImplementedError + + cdef is_encoding_utf8(self): + raise NotImplementedError + + cpdef get_json_decoder(self): + raise NotImplementedError + + cdef is_decoding_json(self): + return False + + cpdef get_json_encoder(self): + raise NotImplementedError + + cdef is_encoding_json(self): + return False diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/datetime.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/datetime.pyx new file mode 100644 index 0000000..bed0b9e --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/datetime.pyx @@ -0,0 +1,423 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cimport cpython.datetime +import datetime + +cpython.datetime.import_datetime() + +utc = datetime.timezone.utc +date_from_ordinal = datetime.date.fromordinal +timedelta = datetime.timedelta + +pg_epoch_datetime = datetime.datetime(2000, 1, 1) +cdef int32_t pg_epoch_datetime_ts = \ + cpython.PyLong_AsLong(int(pg_epoch_datetime.timestamp())) + +pg_epoch_datetime_utc = datetime.datetime(2000, 1, 1, tzinfo=utc) +cdef int32_t pg_epoch_datetime_utc_ts = \ + cpython.PyLong_AsLong(int(pg_epoch_datetime_utc.timestamp())) + +pg_epoch_date = datetime.date(2000, 1, 1) +cdef int32_t pg_date_offset_ord = \ + cpython.PyLong_AsLong(pg_epoch_date.toordinal()) + +# Binary representations of infinity for datetimes. +cdef int64_t pg_time64_infinity = 0x7fffffffffffffff +cdef int64_t pg_time64_negative_infinity = 0x8000000000000000 +cdef int32_t pg_date_infinity = 0x7fffffff +cdef int32_t pg_date_negative_infinity = 0x80000000 + +infinity_datetime = datetime.datetime( + datetime.MAXYEAR, 12, 31, 23, 59, 59, 999999) + +cdef int32_t infinity_datetime_ord = cpython.PyLong_AsLong( + infinity_datetime.toordinal()) + +cdef int64_t infinity_datetime_ts = 252455615999999999 + +negative_infinity_datetime = datetime.datetime( + datetime.MINYEAR, 1, 1, 0, 0, 0, 0) + +cdef int32_t negative_infinity_datetime_ord = cpython.PyLong_AsLong( + negative_infinity_datetime.toordinal()) + +cdef int64_t negative_infinity_datetime_ts = -63082281600000000 + +infinity_date = datetime.date(datetime.MAXYEAR, 12, 31) + +cdef int32_t infinity_date_ord = cpython.PyLong_AsLong( + infinity_date.toordinal()) + +negative_infinity_date = datetime.date(datetime.MINYEAR, 1, 1) + +cdef int32_t negative_infinity_date_ord = cpython.PyLong_AsLong( + negative_infinity_date.toordinal()) + + +cdef inline _local_timezone(): + d = datetime.datetime.now(datetime.timezone.utc).astimezone() + return datetime.timezone(d.utcoffset()) + + +cdef inline _encode_time(WriteBuffer buf, int64_t seconds, + int32_t microseconds): + # XXX: add support for double timestamps + # int64 timestamps, + cdef int64_t ts = seconds * 1000000 + microseconds + + if ts == infinity_datetime_ts: + buf.write_int64(pg_time64_infinity) + elif ts == negative_infinity_datetime_ts: + buf.write_int64(pg_time64_negative_infinity) + else: + buf.write_int64(ts) + + +cdef inline int32_t _decode_time(FRBuffer *buf, int64_t *seconds, + int32_t *microseconds): + cdef int64_t ts = hton.unpack_int64(frb_read(buf, 8)) + + if ts == pg_time64_infinity: + return 1 + elif ts == pg_time64_negative_infinity: + return -1 + else: + seconds[0] = ts // 1000000 + microseconds[0] = (ts % 1000000) + return 0 + + +cdef date_encode(CodecContext settings, WriteBuffer buf, obj): + cdef: + int32_t ordinal = cpython.PyLong_AsLong(obj.toordinal()) + int32_t pg_ordinal + + if ordinal == infinity_date_ord: + pg_ordinal = pg_date_infinity + elif ordinal == negative_infinity_date_ord: + pg_ordinal = pg_date_negative_infinity + else: + pg_ordinal = ordinal - pg_date_offset_ord + + buf.write_int32(4) + buf.write_int32(pg_ordinal) + + +cdef date_encode_tuple(CodecContext settings, WriteBuffer buf, obj): + cdef: + int32_t pg_ordinal + + if len(obj) != 1: + raise ValueError( + 'date tuple encoder: expecting 1 element ' + 'in tuple, got {}'.format(len(obj))) + + pg_ordinal = obj[0] + buf.write_int32(4) + buf.write_int32(pg_ordinal) + + +cdef date_decode(CodecContext settings, FRBuffer *buf): + cdef int32_t pg_ordinal = hton.unpack_int32(frb_read(buf, 4)) + + if pg_ordinal == pg_date_infinity: + return infinity_date + elif pg_ordinal == pg_date_negative_infinity: + return negative_infinity_date + else: + return date_from_ordinal(pg_ordinal + pg_date_offset_ord) + + +cdef date_decode_tuple(CodecContext settings, FRBuffer *buf): + cdef int32_t pg_ordinal = hton.unpack_int32(frb_read(buf, 4)) + + return (pg_ordinal,) + + +cdef timestamp_encode(CodecContext settings, WriteBuffer buf, obj): + if not cpython.datetime.PyDateTime_Check(obj): + if cpython.datetime.PyDate_Check(obj): + obj = datetime.datetime(obj.year, obj.month, obj.day) + else: + raise TypeError( + 'expected a datetime.date or datetime.datetime instance, ' + 'got {!r}'.format(type(obj).__name__) + ) + + delta = obj - pg_epoch_datetime + cdef: + int64_t seconds = cpython.PyLong_AsLongLong(delta.days) * 86400 + \ + cpython.PyLong_AsLong(delta.seconds) + int32_t microseconds = cpython.PyLong_AsLong( + delta.microseconds) + + buf.write_int32(8) + _encode_time(buf, seconds, microseconds) + + +cdef timestamp_encode_tuple(CodecContext settings, WriteBuffer buf, obj): + cdef: + int64_t microseconds + + if len(obj) != 1: + raise ValueError( + 'timestamp tuple encoder: expecting 1 element ' + 'in tuple, got {}'.format(len(obj))) + + microseconds = obj[0] + + buf.write_int32(8) + buf.write_int64(microseconds) + + +cdef timestamp_decode(CodecContext settings, FRBuffer *buf): + cdef: + int64_t seconds = 0 + int32_t microseconds = 0 + int32_t inf = _decode_time(buf, &seconds, µseconds) + + if inf > 0: + # positive infinity + return infinity_datetime + elif inf < 0: + # negative infinity + return negative_infinity_datetime + else: + return pg_epoch_datetime.__add__( + timedelta(0, seconds, microseconds)) + + +cdef timestamp_decode_tuple(CodecContext settings, FRBuffer *buf): + cdef: + int64_t ts = hton.unpack_int64(frb_read(buf, 8)) + + return (ts,) + + +cdef timestamptz_encode(CodecContext settings, WriteBuffer buf, obj): + if not cpython.datetime.PyDateTime_Check(obj): + if cpython.datetime.PyDate_Check(obj): + obj = datetime.datetime(obj.year, obj.month, obj.day, + tzinfo=_local_timezone()) + else: + raise TypeError( + 'expected a datetime.date or datetime.datetime instance, ' + 'got {!r}'.format(type(obj).__name__) + ) + + buf.write_int32(8) + + if obj == infinity_datetime: + buf.write_int64(pg_time64_infinity) + return + elif obj == negative_infinity_datetime: + buf.write_int64(pg_time64_negative_infinity) + return + + utc_dt = obj.astimezone(utc) + + delta = utc_dt - pg_epoch_datetime_utc + cdef: + int64_t seconds = cpython.PyLong_AsLongLong(delta.days) * 86400 + \ + cpython.PyLong_AsLong(delta.seconds) + int32_t microseconds = cpython.PyLong_AsLong( + delta.microseconds) + + _encode_time(buf, seconds, microseconds) + + +cdef timestamptz_decode(CodecContext settings, FRBuffer *buf): + cdef: + int64_t seconds = 0 + int32_t microseconds = 0 + int32_t inf = _decode_time(buf, &seconds, µseconds) + + if inf > 0: + # positive infinity + return infinity_datetime + elif inf < 0: + # negative infinity + return negative_infinity_datetime + else: + return pg_epoch_datetime_utc.__add__( + timedelta(0, seconds, microseconds)) + + +cdef time_encode(CodecContext settings, WriteBuffer buf, obj): + cdef: + int64_t seconds = cpython.PyLong_AsLong(obj.hour) * 3600 + \ + cpython.PyLong_AsLong(obj.minute) * 60 + \ + cpython.PyLong_AsLong(obj.second) + int32_t microseconds = cpython.PyLong_AsLong(obj.microsecond) + + buf.write_int32(8) + _encode_time(buf, seconds, microseconds) + + +cdef time_encode_tuple(CodecContext settings, WriteBuffer buf, obj): + cdef: + int64_t microseconds + + if len(obj) != 1: + raise ValueError( + 'time tuple encoder: expecting 1 element ' + 'in tuple, got {}'.format(len(obj))) + + microseconds = obj[0] + + buf.write_int32(8) + buf.write_int64(microseconds) + + +cdef time_decode(CodecContext settings, FRBuffer *buf): + cdef: + int64_t seconds = 0 + int32_t microseconds = 0 + + _decode_time(buf, &seconds, µseconds) + + cdef: + int64_t minutes = (seconds / 60) + int64_t sec = seconds % 60 + int64_t hours = (minutes / 60) + int64_t min = minutes % 60 + + return datetime.time(hours, min, sec, microseconds) + + +cdef time_decode_tuple(CodecContext settings, FRBuffer *buf): + cdef: + int64_t ts = hton.unpack_int64(frb_read(buf, 8)) + + return (ts,) + + +cdef timetz_encode(CodecContext settings, WriteBuffer buf, obj): + offset = obj.tzinfo.utcoffset(None) + + cdef: + int32_t offset_sec = \ + cpython.PyLong_AsLong(offset.days) * 24 * 60 * 60 + \ + cpython.PyLong_AsLong(offset.seconds) + + int64_t seconds = cpython.PyLong_AsLong(obj.hour) * 3600 + \ + cpython.PyLong_AsLong(obj.minute) * 60 + \ + cpython.PyLong_AsLong(obj.second) + + int32_t microseconds = cpython.PyLong_AsLong(obj.microsecond) + + buf.write_int32(12) + _encode_time(buf, seconds, microseconds) + # In Python utcoffset() is the difference between the local time + # and the UTC, whereas in PostgreSQL it's the opposite, + # so we need to flip the sign. + buf.write_int32(-offset_sec) + + +cdef timetz_encode_tuple(CodecContext settings, WriteBuffer buf, obj): + cdef: + int64_t microseconds + int32_t offset_sec + + if len(obj) != 2: + raise ValueError( + 'time tuple encoder: expecting 2 elements2 ' + 'in tuple, got {}'.format(len(obj))) + + microseconds = obj[0] + offset_sec = obj[1] + + buf.write_int32(12) + buf.write_int64(microseconds) + buf.write_int32(offset_sec) + + +cdef timetz_decode(CodecContext settings, FRBuffer *buf): + time = time_decode(settings, buf) + cdef int32_t offset = (hton.unpack_int32(frb_read(buf, 4)) / 60) + # See the comment in the `timetz_encode` method. + return time.replace(tzinfo=datetime.timezone(timedelta(minutes=-offset))) + + +cdef timetz_decode_tuple(CodecContext settings, FRBuffer *buf): + cdef: + int64_t microseconds = hton.unpack_int64(frb_read(buf, 8)) + int32_t offset_sec = hton.unpack_int32(frb_read(buf, 4)) + + return (microseconds, offset_sec) + + +cdef interval_encode(CodecContext settings, WriteBuffer buf, obj): + cdef: + int32_t days = cpython.PyLong_AsLong(obj.days) + int64_t seconds = cpython.PyLong_AsLongLong(obj.seconds) + int32_t microseconds = cpython.PyLong_AsLong(obj.microseconds) + + buf.write_int32(16) + _encode_time(buf, seconds, microseconds) + buf.write_int32(days) + buf.write_int32(0) # Months + + +cdef interval_encode_tuple(CodecContext settings, WriteBuffer buf, + tuple obj): + cdef: + int32_t months + int32_t days + int64_t microseconds + + if len(obj) != 3: + raise ValueError( + 'interval tuple encoder: expecting 3 elements ' + 'in tuple, got {}'.format(len(obj))) + + months = obj[0] + days = obj[1] + microseconds = obj[2] + + buf.write_int32(16) + buf.write_int64(microseconds) + buf.write_int32(days) + buf.write_int32(months) + + +cdef interval_decode(CodecContext settings, FRBuffer *buf): + cdef: + int32_t days + int32_t months + int32_t years + int64_t seconds = 0 + int32_t microseconds = 0 + + _decode_time(buf, &seconds, µseconds) + + days = hton.unpack_int32(frb_read(buf, 4)) + months = hton.unpack_int32(frb_read(buf, 4)) + + if months < 0: + years = -(-months // 12) + months = -(-months % 12) + else: + years = (months // 12) + months = (months % 12) + + return datetime.timedelta(days=days + months * 30 + years * 365, + seconds=seconds, microseconds=microseconds) + + +cdef interval_decode_tuple(CodecContext settings, FRBuffer *buf): + cdef: + int32_t days + int32_t months + int64_t microseconds + + microseconds = hton.unpack_int64(frb_read(buf, 8)) + days = hton.unpack_int32(frb_read(buf, 4)) + months = hton.unpack_int32(frb_read(buf, 4)) + + return (months, days, microseconds) diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/float.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/float.pyx new file mode 100644 index 0000000..94eda03 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/float.pyx @@ -0,0 +1,34 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +from libc cimport math + + +cdef float4_encode(CodecContext settings, WriteBuffer buf, obj): + cdef double dval = cpython.PyFloat_AsDouble(obj) + cdef float fval = dval + if math.isinf(fval) and not math.isinf(dval): + raise ValueError('value out of float32 range') + + buf.write_int32(4) + buf.write_float(fval) + + +cdef float4_decode(CodecContext settings, FRBuffer *buf): + cdef float f = hton.unpack_float(frb_read(buf, 4)) + return cpython.PyFloat_FromDouble(f) + + +cdef float8_encode(CodecContext settings, WriteBuffer buf, obj): + cdef double dval = cpython.PyFloat_AsDouble(obj) + buf.write_int32(8) + buf.write_double(dval) + + +cdef float8_decode(CodecContext settings, FRBuffer *buf): + cdef double f = hton.unpack_double(frb_read(buf, 8)) + return cpython.PyFloat_FromDouble(f) diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/geometry.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/geometry.pyx new file mode 100644 index 0000000..44aac64 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/geometry.pyx @@ -0,0 +1,164 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef inline _encode_points(WriteBuffer wbuf, object points): + cdef object point + + for point in points: + wbuf.write_double(point[0]) + wbuf.write_double(point[1]) + + +cdef inline _decode_points(FRBuffer *buf): + cdef: + int32_t npts = hton.unpack_int32(frb_read(buf, 4)) + pts = cpython.PyTuple_New(npts) + int32_t i + object point + double x + double y + + for i in range(npts): + x = hton.unpack_double(frb_read(buf, 8)) + y = hton.unpack_double(frb_read(buf, 8)) + point = pgproto_types.Point(x, y) + cpython.Py_INCREF(point) + cpython.PyTuple_SET_ITEM(pts, i, point) + + return pts + + +cdef box_encode(CodecContext settings, WriteBuffer wbuf, obj): + wbuf.write_int32(32) + _encode_points(wbuf, (obj[0], obj[1])) + + +cdef box_decode(CodecContext settings, FRBuffer *buf): + cdef: + double high_x = hton.unpack_double(frb_read(buf, 8)) + double high_y = hton.unpack_double(frb_read(buf, 8)) + double low_x = hton.unpack_double(frb_read(buf, 8)) + double low_y = hton.unpack_double(frb_read(buf, 8)) + + return pgproto_types.Box( + pgproto_types.Point(high_x, high_y), + pgproto_types.Point(low_x, low_y)) + + +cdef line_encode(CodecContext settings, WriteBuffer wbuf, obj): + wbuf.write_int32(24) + wbuf.write_double(obj[0]) + wbuf.write_double(obj[1]) + wbuf.write_double(obj[2]) + + +cdef line_decode(CodecContext settings, FRBuffer *buf): + cdef: + double A = hton.unpack_double(frb_read(buf, 8)) + double B = hton.unpack_double(frb_read(buf, 8)) + double C = hton.unpack_double(frb_read(buf, 8)) + + return pgproto_types.Line(A, B, C) + + +cdef lseg_encode(CodecContext settings, WriteBuffer wbuf, obj): + wbuf.write_int32(32) + _encode_points(wbuf, (obj[0], obj[1])) + + +cdef lseg_decode(CodecContext settings, FRBuffer *buf): + cdef: + double p1_x = hton.unpack_double(frb_read(buf, 8)) + double p1_y = hton.unpack_double(frb_read(buf, 8)) + double p2_x = hton.unpack_double(frb_read(buf, 8)) + double p2_y = hton.unpack_double(frb_read(buf, 8)) + + return pgproto_types.LineSegment((p1_x, p1_y), (p2_x, p2_y)) + + +cdef point_encode(CodecContext settings, WriteBuffer wbuf, obj): + wbuf.write_int32(16) + wbuf.write_double(obj[0]) + wbuf.write_double(obj[1]) + + +cdef point_decode(CodecContext settings, FRBuffer *buf): + cdef: + double x = hton.unpack_double(frb_read(buf, 8)) + double y = hton.unpack_double(frb_read(buf, 8)) + + return pgproto_types.Point(x, y) + + +cdef path_encode(CodecContext settings, WriteBuffer wbuf, obj): + cdef: + int8_t is_closed = 0 + ssize_t npts + ssize_t encoded_len + int32_t i + + if cpython.PyTuple_Check(obj): + is_closed = 1 + elif cpython.PyList_Check(obj): + is_closed = 0 + elif isinstance(obj, pgproto_types.Path): + is_closed = obj.is_closed + + npts = len(obj) + encoded_len = 1 + 4 + 16 * npts + if encoded_len > _MAXINT32: + raise ValueError('path value too long') + + wbuf.write_int32(encoded_len) + wbuf.write_byte(is_closed) + wbuf.write_int32(npts) + + _encode_points(wbuf, obj) + + +cdef path_decode(CodecContext settings, FRBuffer *buf): + cdef: + int8_t is_closed = (frb_read(buf, 1)[0]) + + return pgproto_types.Path(*_decode_points(buf), is_closed=is_closed == 1) + + +cdef poly_encode(CodecContext settings, WriteBuffer wbuf, obj): + cdef: + bint is_closed + ssize_t npts + ssize_t encoded_len + int32_t i + + npts = len(obj) + encoded_len = 4 + 16 * npts + if encoded_len > _MAXINT32: + raise ValueError('polygon value too long') + + wbuf.write_int32(encoded_len) + wbuf.write_int32(npts) + _encode_points(wbuf, obj) + + +cdef poly_decode(CodecContext settings, FRBuffer *buf): + return pgproto_types.Polygon(*_decode_points(buf)) + + +cdef circle_encode(CodecContext settings, WriteBuffer wbuf, obj): + wbuf.write_int32(24) + wbuf.write_double(obj[0][0]) + wbuf.write_double(obj[0][1]) + wbuf.write_double(obj[1]) + + +cdef circle_decode(CodecContext settings, FRBuffer *buf): + cdef: + double center_x = hton.unpack_double(frb_read(buf, 8)) + double center_y = hton.unpack_double(frb_read(buf, 8)) + double radius = hton.unpack_double(frb_read(buf, 8)) + + return pgproto_types.Circle((center_x, center_y), radius) diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/hstore.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/hstore.pyx new file mode 100644 index 0000000..09051c7 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/hstore.pyx @@ -0,0 +1,73 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef hstore_encode(CodecContext settings, WriteBuffer buf, obj): + cdef: + char *str + ssize_t size + ssize_t count + object items + WriteBuffer item_buf = WriteBuffer.new() + + count = len(obj) + if count > _MAXINT32: + raise ValueError('hstore value is too large') + item_buf.write_int32(count) + + if hasattr(obj, 'items'): + items = obj.items() + else: + items = obj + + for k, v in items: + if k is None: + raise ValueError('null value not allowed in hstore key') + as_pg_string_and_size(settings, k, &str, &size) + item_buf.write_int32(size) + item_buf.write_cstr(str, size) + if v is None: + item_buf.write_int32(-1) + else: + as_pg_string_and_size(settings, v, &str, &size) + item_buf.write_int32(size) + item_buf.write_cstr(str, size) + + buf.write_int32(item_buf.len()) + buf.write_buffer(item_buf) + + +cdef hstore_decode(CodecContext settings, FRBuffer *buf): + cdef: + dict result + uint32_t elem_count + int32_t elem_len + uint32_t i + str k + str v + + result = {} + + elem_count = hton.unpack_int32(frb_read(buf, 4)) + if elem_count == 0: + return result + + for i in range(elem_count): + elem_len = hton.unpack_int32(frb_read(buf, 4)) + if elem_len < 0: + raise ValueError('null value not allowed in hstore key') + + k = decode_pg_string(settings, frb_read(buf, elem_len), elem_len) + + elem_len = hton.unpack_int32(frb_read(buf, 4)) + if elem_len < 0: + v = None + else: + v = decode_pg_string(settings, frb_read(buf, elem_len), elem_len) + + result[k] = v + + return result diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/int.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/int.pyx new file mode 100644 index 0000000..9997244 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/int.pyx @@ -0,0 +1,144 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef bool_encode(CodecContext settings, WriteBuffer buf, obj): + if not cpython.PyBool_Check(obj): + raise TypeError('a boolean is required (got type {})'.format( + type(obj).__name__)) + + buf.write_int32(1) + buf.write_byte(b'\x01' if obj is True else b'\x00') + + +cdef bool_decode(CodecContext settings, FRBuffer *buf): + return frb_read(buf, 1)[0] is b'\x01' + + +cdef int2_encode(CodecContext settings, WriteBuffer buf, obj): + cdef int overflow = 0 + cdef long val + + try: + if type(obj) is not int and hasattr(type(obj), '__int__'): + # Silence a Python warning about implicit __int__ + # conversion. + obj = int(obj) + val = cpython.PyLong_AsLong(obj) + except OverflowError: + overflow = 1 + + if overflow or val < INT16_MIN or val > INT16_MAX: + raise OverflowError('value out of int16 range') + + buf.write_int32(2) + buf.write_int16(val) + + +cdef int2_decode(CodecContext settings, FRBuffer *buf): + return cpython.PyLong_FromLong(hton.unpack_int16(frb_read(buf, 2))) + + +cdef int4_encode(CodecContext settings, WriteBuffer buf, obj): + cdef int overflow = 0 + cdef long val = 0 + + try: + if type(obj) is not int and hasattr(type(obj), '__int__'): + # Silence a Python warning about implicit __int__ + # conversion. + obj = int(obj) + val = cpython.PyLong_AsLong(obj) + except OverflowError: + overflow = 1 + + # "long" and "long long" have the same size for x86_64, need an extra check + if overflow or (sizeof(val) > 4 and (val < INT32_MIN or val > INT32_MAX)): + raise OverflowError('value out of int32 range') + + buf.write_int32(4) + buf.write_int32(val) + + +cdef int4_decode(CodecContext settings, FRBuffer *buf): + return cpython.PyLong_FromLong(hton.unpack_int32(frb_read(buf, 4))) + + +cdef uint4_encode(CodecContext settings, WriteBuffer buf, obj): + cdef int overflow = 0 + cdef unsigned long val = 0 + + try: + if type(obj) is not int and hasattr(type(obj), '__int__'): + # Silence a Python warning about implicit __int__ + # conversion. + obj = int(obj) + val = cpython.PyLong_AsUnsignedLong(obj) + except OverflowError: + overflow = 1 + + # "long" and "long long" have the same size for x86_64, need an extra check + if overflow or (sizeof(val) > 4 and val > UINT32_MAX): + raise OverflowError('value out of uint32 range') + + buf.write_int32(4) + buf.write_int32(val) + + +cdef uint4_decode(CodecContext settings, FRBuffer *buf): + return cpython.PyLong_FromUnsignedLong( + hton.unpack_int32(frb_read(buf, 4))) + + +cdef int8_encode(CodecContext settings, WriteBuffer buf, obj): + cdef int overflow = 0 + cdef long long val + + try: + if type(obj) is not int and hasattr(type(obj), '__int__'): + # Silence a Python warning about implicit __int__ + # conversion. + obj = int(obj) + val = cpython.PyLong_AsLongLong(obj) + except OverflowError: + overflow = 1 + + # Just in case for systems with "long long" bigger than 8 bytes + if overflow or (sizeof(val) > 8 and (val < INT64_MIN or val > INT64_MAX)): + raise OverflowError('value out of int64 range') + + buf.write_int32(8) + buf.write_int64(val) + + +cdef int8_decode(CodecContext settings, FRBuffer *buf): + return cpython.PyLong_FromLongLong(hton.unpack_int64(frb_read(buf, 8))) + + +cdef uint8_encode(CodecContext settings, WriteBuffer buf, obj): + cdef int overflow = 0 + cdef unsigned long long val = 0 + + try: + if type(obj) is not int and hasattr(type(obj), '__int__'): + # Silence a Python warning about implicit __int__ + # conversion. + obj = int(obj) + val = cpython.PyLong_AsUnsignedLongLong(obj) + except OverflowError: + overflow = 1 + + # Just in case for systems with "long long" bigger than 8 bytes + if overflow or (sizeof(val) > 8 and val > UINT64_MAX): + raise OverflowError('value out of uint64 range') + + buf.write_int32(8) + buf.write_int64(val) + + +cdef uint8_decode(CodecContext settings, FRBuffer *buf): + return cpython.PyLong_FromUnsignedLongLong( + hton.unpack_int64(frb_read(buf, 8))) \ No newline at end of file diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/json.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/json.pyx new file mode 100644 index 0000000..97e6916 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/json.pyx @@ -0,0 +1,57 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef jsonb_encode(CodecContext settings, WriteBuffer buf, obj): + cdef: + char *str + ssize_t size + + if settings.is_encoding_json(): + obj = settings.get_json_encoder().encode(obj) + + as_pg_string_and_size(settings, obj, &str, &size) + + if size > 0x7fffffff - 1: + raise ValueError('string too long') + + buf.write_int32(size + 1) + buf.write_byte(1) # JSONB format version + buf.write_cstr(str, size) + + +cdef jsonb_decode(CodecContext settings, FRBuffer *buf): + cdef uint8_t format = (frb_read(buf, 1)[0]) + + if format != 1: + raise ValueError('unexpected JSONB format: {}'.format(format)) + + rv = text_decode(settings, buf) + + if settings.is_decoding_json(): + rv = settings.get_json_decoder().decode(rv) + + return rv + + +cdef json_encode(CodecContext settings, WriteBuffer buf, obj): + cdef: + char *str + ssize_t size + + if settings.is_encoding_json(): + obj = settings.get_json_encoder().encode(obj) + + text_encode(settings, buf, obj) + + +cdef json_decode(CodecContext settings, FRBuffer *buf): + rv = text_decode(settings, buf) + + if settings.is_decoding_json(): + rv = settings.get_json_decoder().decode(rv) + + return rv diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/jsonpath.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/jsonpath.pyx new file mode 100644 index 0000000..610b30d --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/jsonpath.pyx @@ -0,0 +1,29 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef jsonpath_encode(CodecContext settings, WriteBuffer buf, obj): + cdef: + char *str + ssize_t size + + as_pg_string_and_size(settings, obj, &str, &size) + + if size > 0x7fffffff - 1: + raise ValueError('string too long') + + buf.write_int32(size + 1) + buf.write_byte(1) # jsonpath format version + buf.write_cstr(str, size) + + +cdef jsonpath_decode(CodecContext settings, FRBuffer *buf): + cdef uint8_t format = (frb_read(buf, 1)[0]) + + if format != 1: + raise ValueError('unexpected jsonpath format: {}'.format(format)) + + return text_decode(settings, buf) diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/misc.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/misc.pyx new file mode 100644 index 0000000..99b19c9 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/misc.pyx @@ -0,0 +1,16 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef void_encode(CodecContext settings, WriteBuffer buf, obj): + # Void is zero bytes + buf.write_int32(0) + + +cdef void_decode(CodecContext settings, FRBuffer *buf): + # Do nothing; void will be passed as NULL so this function + # will never be called. + pass diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/network.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/network.pyx new file mode 100644 index 0000000..730c947 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/network.pyx @@ -0,0 +1,139 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import ipaddress + + +# defined in postgresql/src/include/inet.h +# +DEF PGSQL_AF_INET = 2 # AF_INET +DEF PGSQL_AF_INET6 = 3 # AF_INET + 1 + + +_ipaddr = ipaddress.ip_address +_ipiface = ipaddress.ip_interface +_ipnet = ipaddress.ip_network + + +cdef inline uint8_t _ip_max_prefix_len(int32_t family): + # Maximum number of bits in the network prefix of the specified + # IP protocol version. + if family == PGSQL_AF_INET: + return 32 + else: + return 128 + + +cdef inline int32_t _ip_addr_len(int32_t family): + # Length of address in bytes for the specified IP protocol version. + if family == PGSQL_AF_INET: + return 4 + else: + return 16 + + +cdef inline int8_t _ver_to_family(int32_t version): + if version == 4: + return PGSQL_AF_INET + else: + return PGSQL_AF_INET6 + + +cdef inline _net_encode(WriteBuffer buf, int8_t family, uint32_t bits, + int8_t is_cidr, bytes addr): + + cdef: + char *addrbytes + ssize_t addrlen + + cpython.PyBytes_AsStringAndSize(addr, &addrbytes, &addrlen) + + buf.write_int32(4 + addrlen) + buf.write_byte(family) + buf.write_byte(bits) + buf.write_byte(is_cidr) + buf.write_byte(addrlen) + buf.write_cstr(addrbytes, addrlen) + + +cdef net_decode(CodecContext settings, FRBuffer *buf, bint as_cidr): + cdef: + int32_t family = frb_read(buf, 1)[0] + uint8_t bits = frb_read(buf, 1)[0] + int prefix_len + int32_t is_cidr = frb_read(buf, 1)[0] + int32_t addrlen = frb_read(buf, 1)[0] + bytes addr + uint8_t max_prefix_len = _ip_max_prefix_len(family) + + if is_cidr != as_cidr: + raise ValueError('unexpected CIDR flag set in non-cidr value') + + if family != PGSQL_AF_INET and family != PGSQL_AF_INET6: + raise ValueError('invalid address family in "{}" value'.format( + 'cidr' if is_cidr else 'inet' + )) + + max_prefix_len = _ip_max_prefix_len(family) + + if bits > max_prefix_len: + raise ValueError('invalid network prefix length in "{}" value'.format( + 'cidr' if is_cidr else 'inet' + )) + + if addrlen != _ip_addr_len(family): + raise ValueError('invalid address length in "{}" value'.format( + 'cidr' if is_cidr else 'inet' + )) + + addr = cpython.PyBytes_FromStringAndSize(frb_read(buf, addrlen), addrlen) + + if as_cidr or bits != max_prefix_len: + prefix_len = cpython.PyLong_FromLong(bits) + + if as_cidr: + return _ipnet((addr, prefix_len)) + else: + return _ipiface((addr, prefix_len)) + else: + return _ipaddr(addr) + + +cdef cidr_encode(CodecContext settings, WriteBuffer buf, obj): + cdef: + object ipnet + int8_t family + + ipnet = _ipnet(obj) + family = _ver_to_family(ipnet.version) + _net_encode(buf, family, ipnet.prefixlen, 1, ipnet.network_address.packed) + + +cdef cidr_decode(CodecContext settings, FRBuffer *buf): + return net_decode(settings, buf, True) + + +cdef inet_encode(CodecContext settings, WriteBuffer buf, obj): + cdef: + object ipaddr + int8_t family + + try: + ipaddr = _ipaddr(obj) + except ValueError: + # PostgreSQL accepts *both* CIDR and host values + # for the host datatype. + ipaddr = _ipiface(obj) + family = _ver_to_family(ipaddr.version) + _net_encode(buf, family, ipaddr.network.prefixlen, 1, ipaddr.packed) + else: + family = _ver_to_family(ipaddr.version) + _net_encode(buf, family, _ip_max_prefix_len(family), 0, ipaddr.packed) + + +cdef inet_decode(CodecContext settings, FRBuffer *buf): + return net_decode(settings, buf, False) diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/numeric.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/numeric.pyx new file mode 100644 index 0000000..b75d096 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/numeric.pyx @@ -0,0 +1,356 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +from libc.math cimport abs, log10 +from libc.stdio cimport snprintf + +import decimal + +# defined in postgresql/src/backend/utils/adt/numeric.c +DEF DEC_DIGITS = 4 +DEF MAX_DSCALE = 0x3FFF +DEF NUMERIC_POS = 0x0000 +DEF NUMERIC_NEG = 0x4000 +DEF NUMERIC_NAN = 0xC000 +DEF NUMERIC_PINF = 0xD000 +DEF NUMERIC_NINF = 0xF000 + +_Dec = decimal.Decimal + + +cdef numeric_encode_text(CodecContext settings, WriteBuffer buf, obj): + text_encode(settings, buf, str(obj)) + + +cdef numeric_decode_text(CodecContext settings, FRBuffer *buf): + return _Dec(text_decode(settings, buf)) + + +cdef numeric_encode_binary(CodecContext settings, WriteBuffer buf, obj): + cdef: + object dec + object dt + int64_t exponent + int64_t i + int64_t j + tuple pydigits + int64_t num_pydigits + int16_t pgdigit + int64_t num_pgdigits + int16_t dscale + int64_t dweight + int64_t weight + uint16_t sign + int64_t padding_size = 0 + + if isinstance(obj, _Dec): + dec = obj + else: + dec = _Dec(obj) + + dt = dec.as_tuple() + + if dt.exponent == 'n' or dt.exponent == 'N': + # NaN + sign = NUMERIC_NAN + num_pgdigits = 0 + weight = 0 + dscale = 0 + elif dt.exponent == 'F': + # Infinity + if dt.sign: + sign = NUMERIC_NINF + else: + sign = NUMERIC_PINF + num_pgdigits = 0 + weight = 0 + dscale = 0 + else: + exponent = dt.exponent + if exponent < 0 and -exponent > MAX_DSCALE: + raise ValueError( + 'cannot encode Decimal value into numeric: ' + 'exponent is too small') + + if dt.sign: + sign = NUMERIC_NEG + else: + sign = NUMERIC_POS + + pydigits = dt.digits + num_pydigits = len(pydigits) + + dweight = num_pydigits + exponent - 1 + if dweight >= 0: + weight = (dweight + DEC_DIGITS) // DEC_DIGITS - 1 + else: + weight = -((-dweight - 1) // DEC_DIGITS + 1) + + if weight > 2 ** 16 - 1: + raise ValueError( + 'cannot encode Decimal value into numeric: ' + 'exponent is too large') + + padding_size = \ + (weight + 1) * DEC_DIGITS - (dweight + 1) + num_pgdigits = \ + (num_pydigits + padding_size + DEC_DIGITS - 1) // DEC_DIGITS + + if num_pgdigits > 2 ** 16 - 1: + raise ValueError( + 'cannot encode Decimal value into numeric: ' + 'number of digits is too large') + + # Pad decimal digits to provide room for correct Postgres + # digit alignment in the digit computation loop. + pydigits = (0,) * DEC_DIGITS + pydigits + (0,) * DEC_DIGITS + + if exponent < 0: + if -exponent > MAX_DSCALE: + raise ValueError( + 'cannot encode Decimal value into numeric: ' + 'exponent is too small') + dscale = -exponent + else: + dscale = 0 + + buf.write_int32(2 + 2 + 2 + 2 + 2 * num_pgdigits) + buf.write_int16(num_pgdigits) + buf.write_int16(weight) + buf.write_int16(sign) + buf.write_int16(dscale) + + j = DEC_DIGITS - padding_size + + for i in range(num_pgdigits): + pgdigit = (pydigits[j] * 1000 + pydigits[j + 1] * 100 + + pydigits[j + 2] * 10 + pydigits[j + 3]) + j += DEC_DIGITS + buf.write_int16(pgdigit) + + +# The decoding strategy here is to form a string representation of +# the numeric var, as it is faster than passing an iterable of digits. +# For this reason the below code is pure overhead and is ~25% slower +# than the simple text decoder above. That said, we need the binary +# decoder to support binary COPY with numeric values. +cdef numeric_decode_binary_ex( + CodecContext settings, + FRBuffer *buf, + bint trail_fract_zero, +): + cdef: + uint16_t num_pgdigits = hton.unpack_int16(frb_read(buf, 2)) + int16_t weight = hton.unpack_int16(frb_read(buf, 2)) + uint16_t sign = hton.unpack_int16(frb_read(buf, 2)) + uint16_t dscale = hton.unpack_int16(frb_read(buf, 2)) + int16_t pgdigit0 + ssize_t i + int16_t pgdigit + object pydigits + ssize_t num_pydigits + ssize_t actual_num_pydigits + ssize_t buf_size + int64_t exponent + int64_t abs_exponent + ssize_t exponent_chars + ssize_t front_padding = 0 + ssize_t num_fract_digits + ssize_t trailing_fract_zeros_adj + char smallbuf[_NUMERIC_DECODER_SMALLBUF_SIZE] + char *charbuf + char *bufptr + bint buf_allocated = False + + if sign == NUMERIC_NAN: + # Not-a-number + return _Dec('NaN') + elif sign == NUMERIC_PINF: + # +Infinity + return _Dec('Infinity') + elif sign == NUMERIC_NINF: + # -Infinity + return _Dec('-Infinity') + + if num_pgdigits == 0: + # Zero + return _Dec('0e-' + str(dscale)) + + pgdigit0 = hton.unpack_int16(frb_read(buf, 2)) + if weight >= 0: + if pgdigit0 < 10: + front_padding = 3 + elif pgdigit0 < 100: + front_padding = 2 + elif pgdigit0 < 1000: + front_padding = 1 + + # The number of fractional decimal digits actually encoded in + # base-DEC_DEIGITS digits sent by Postgres. + num_fract_digits = (num_pgdigits - weight - 1) * DEC_DIGITS + + # The trailing zero adjustment necessary to obtain exactly + # dscale number of fractional digits in output. May be negative, + # which indicates that trailing zeros in the last input digit + # should be discarded. + trailing_fract_zeros_adj = dscale - num_fract_digits + + # Maximum possible number of decimal digits in base 10. + # The actual number might be up to 3 digits smaller due to + # leading zeros in first input digit. + num_pydigits = num_pgdigits * DEC_DIGITS + if trailing_fract_zeros_adj > 0: + num_pydigits += trailing_fract_zeros_adj + + # Exponent. + exponent = (weight + 1) * DEC_DIGITS - front_padding + abs_exponent = abs(exponent) + if abs_exponent != 0: + # Number of characters required to render absolute exponent value + # in decimal. + exponent_chars = log10(abs_exponent) + 1 + else: + exponent_chars = 0 + + # Output buffer size. + buf_size = ( + 1 + # sign + 1 + # leading zero + 1 + # decimal dot + num_pydigits + # digits + 1 + # possible trailing zero padding + 2 + # exponent indicator (E-,E+) + exponent_chars + # exponent + 1 # null terminator char + ) + + if buf_size > _NUMERIC_DECODER_SMALLBUF_SIZE: + charbuf = cpython.PyMem_Malloc(buf_size) + buf_allocated = True + else: + charbuf = smallbuf + + try: + bufptr = charbuf + + if sign == NUMERIC_NEG: + bufptr[0] = b'-' + bufptr += 1 + + bufptr[0] = b'0' + bufptr[1] = b'.' + bufptr += 2 + + if weight >= 0: + bufptr = _unpack_digit_stripping_lzeros(bufptr, pgdigit0) + else: + bufptr = _unpack_digit(bufptr, pgdigit0) + + for i in range(1, num_pgdigits): + pgdigit = hton.unpack_int16(frb_read(buf, 2)) + bufptr = _unpack_digit(bufptr, pgdigit) + + if dscale: + if trailing_fract_zeros_adj > 0: + for i in range(trailing_fract_zeros_adj): + bufptr[i] = b'0' + + # If display scale is _less_ than the number of rendered digits, + # trailing_fract_zeros_adj will be negative and this will strip + # the excess trailing zeros. + bufptr += trailing_fract_zeros_adj + + if trail_fract_zero: + # Check if the number of rendered digits matches the exponent, + # and if so, add another trailing zero, so the result always + # appears with a decimal point. + actual_num_pydigits = bufptr - charbuf - 2 + if sign == NUMERIC_NEG: + actual_num_pydigits -= 1 + + if actual_num_pydigits == abs_exponent: + bufptr[0] = b'0' + bufptr += 1 + + if exponent != 0: + bufptr[0] = b'E' + if exponent < 0: + bufptr[1] = b'-' + else: + bufptr[1] = b'+' + bufptr += 2 + snprintf(bufptr, exponent_chars + 1, '%d', + abs_exponent) + bufptr += exponent_chars + + bufptr[0] = 0 + + pydigits = cpythonx.PyUnicode_FromString(charbuf) + + return _Dec(pydigits) + + finally: + if buf_allocated: + cpython.PyMem_Free(charbuf) + + +cdef numeric_decode_binary(CodecContext settings, FRBuffer *buf): + return numeric_decode_binary_ex(settings, buf, False) + + +cdef inline char *_unpack_digit_stripping_lzeros(char *buf, int64_t pgdigit): + cdef: + int64_t d + bint significant + + d = pgdigit // 1000 + significant = (d > 0) + if significant: + pgdigit -= d * 1000 + buf[0] = (d + b'0') + buf += 1 + + d = pgdigit // 100 + significant |= (d > 0) + if significant: + pgdigit -= d * 100 + buf[0] = (d + b'0') + buf += 1 + + d = pgdigit // 10 + significant |= (d > 0) + if significant: + pgdigit -= d * 10 + buf[0] = (d + b'0') + buf += 1 + + buf[0] = (pgdigit + b'0') + buf += 1 + + return buf + + +cdef inline char *_unpack_digit(char *buf, int64_t pgdigit): + cdef: + int64_t d + + d = pgdigit // 1000 + pgdigit -= d * 1000 + buf[0] = (d + b'0') + + d = pgdigit // 100 + pgdigit -= d * 100 + buf[1] = (d + b'0') + + d = pgdigit // 10 + pgdigit -= d * 10 + buf[2] = (d + b'0') + + buf[3] = (pgdigit + b'0') + buf += 4 + + return buf diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/pg_snapshot.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/pg_snapshot.pyx new file mode 100644 index 0000000..d96107c --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/pg_snapshot.pyx @@ -0,0 +1,63 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef pg_snapshot_encode(CodecContext settings, WriteBuffer buf, obj): + cdef: + ssize_t nxip + uint64_t xmin + uint64_t xmax + int i + WriteBuffer xip_buf = WriteBuffer.new() + + if not (cpython.PyTuple_Check(obj) or cpython.PyList_Check(obj)): + raise TypeError( + 'list or tuple expected (got type {})'.format(type(obj))) + + if len(obj) != 3: + raise ValueError( + 'invalid number of elements in txid_snapshot tuple, expecting 4') + + nxip = len(obj[2]) + if nxip > _MAXINT32: + raise ValueError('txid_snapshot value is too long') + + xmin = obj[0] + xmax = obj[1] + + for i in range(nxip): + xip_buf.write_int64( + cpython.PyLong_AsUnsignedLongLong(obj[2][i])) + + buf.write_int32(20 + xip_buf.len()) + + buf.write_int32(nxip) + buf.write_int64(xmin) + buf.write_int64(xmax) + buf.write_buffer(xip_buf) + + +cdef pg_snapshot_decode(CodecContext settings, FRBuffer *buf): + cdef: + int32_t nxip + uint64_t xmin + uint64_t xmax + tuple xip_tup + int32_t i + object xip + + nxip = hton.unpack_int32(frb_read(buf, 4)) + xmin = hton.unpack_int64(frb_read(buf, 8)) + xmax = hton.unpack_int64(frb_read(buf, 8)) + + xip_tup = cpython.PyTuple_New(nxip) + for i in range(nxip): + xip = cpython.PyLong_FromUnsignedLongLong( + hton.unpack_int64(frb_read(buf, 8))) + cpython.Py_INCREF(xip) + cpython.PyTuple_SET_ITEM(xip_tup, i, xip) + + return (xmin, xmax, xip_tup) diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/text.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/text.pyx new file mode 100644 index 0000000..79f375d --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/text.pyx @@ -0,0 +1,48 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef inline as_pg_string_and_size( + CodecContext settings, obj, char **cstr, ssize_t *size): + + if not cpython.PyUnicode_Check(obj): + raise TypeError('expected str, got {}'.format(type(obj).__name__)) + + if settings.is_encoding_utf8(): + cstr[0] = cpythonx.PyUnicode_AsUTF8AndSize(obj, size) + else: + encoded = settings.get_text_codec().encode(obj)[0] + cpython.PyBytes_AsStringAndSize(encoded, cstr, size) + + if size[0] > 0x7fffffff: + raise ValueError('string too long') + + +cdef text_encode(CodecContext settings, WriteBuffer buf, obj): + cdef: + char *str + ssize_t size + + as_pg_string_and_size(settings, obj, &str, &size) + + buf.write_int32(size) + buf.write_cstr(str, size) + + +cdef inline decode_pg_string(CodecContext settings, const char* data, + ssize_t len): + + if settings.is_encoding_utf8(): + # decode UTF-8 in strict mode + return cpython.PyUnicode_DecodeUTF8(data, len, NULL) + else: + bytes = cpython.PyBytes_FromStringAndSize(data, len) + return settings.get_text_codec().decode(bytes)[0] + + +cdef text_decode(CodecContext settings, FRBuffer *buf): + cdef ssize_t buf_len = buf.len + return decode_pg_string(settings, frb_read_all(buf), buf_len) diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/tid.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/tid.pyx new file mode 100644 index 0000000..b39bddc --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/tid.pyx @@ -0,0 +1,51 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef tid_encode(CodecContext settings, WriteBuffer buf, obj): + cdef int overflow = 0 + cdef unsigned long block, offset + + if not (cpython.PyTuple_Check(obj) or cpython.PyList_Check(obj)): + raise TypeError( + 'list or tuple expected (got type {})'.format(type(obj))) + + if len(obj) != 2: + raise ValueError( + 'invalid number of elements in tid tuple, expecting 2') + + try: + block = cpython.PyLong_AsUnsignedLong(obj[0]) + except OverflowError: + overflow = 1 + + # "long" and "long long" have the same size for x86_64, need an extra check + if overflow or (sizeof(block) > 4 and block > UINT32_MAX): + raise OverflowError('tuple id block value out of uint32 range') + + try: + offset = cpython.PyLong_AsUnsignedLong(obj[1]) + overflow = 0 + except OverflowError: + overflow = 1 + + if overflow or offset > 65535: + raise OverflowError('tuple id offset value out of uint16 range') + + buf.write_int32(6) + buf.write_int32(block) + buf.write_int16(offset) + + +cdef tid_decode(CodecContext settings, FRBuffer *buf): + cdef: + uint32_t block + uint16_t offset + + block = hton.unpack_int32(frb_read(buf, 4)) + offset = hton.unpack_int16(frb_read(buf, 2)) + + return (block, offset) diff --git a/env/Lib/site-packages/asyncpg/pgproto/codecs/uuid.pyx b/env/Lib/site-packages/asyncpg/pgproto/codecs/uuid.pyx new file mode 100644 index 0000000..0bc4567 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/codecs/uuid.pyx @@ -0,0 +1,27 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef uuid_encode(CodecContext settings, WriteBuffer wbuf, obj): + cdef: + char buf[16] + + if type(obj) is pg_UUID: + wbuf.write_int32(16) + wbuf.write_cstr((obj)._data, 16) + elif cpython.PyUnicode_Check(obj): + pg_uuid_bytes_from_str(obj, buf) + wbuf.write_int32(16) + wbuf.write_cstr(buf, 16) + else: + bytea_encode(settings, wbuf, obj.bytes) + + +cdef uuid_decode(CodecContext settings, FRBuffer *buf): + if buf.len != 16: + raise TypeError( + f'cannot decode UUID, expected 16 bytes, got {buf.len}') + return pg_uuid_from_buf(frb_read_all(buf)) diff --git a/env/Lib/site-packages/asyncpg/pgproto/consts.pxi b/env/Lib/site-packages/asyncpg/pgproto/consts.pxi new file mode 100644 index 0000000..dbce085 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/consts.pxi @@ -0,0 +1,12 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +DEF _BUFFER_INITIAL_SIZE = 1024 +DEF _BUFFER_MAX_GROW = 65536 +DEF _BUFFER_FREELIST_SIZE = 256 +DEF _MAXINT32 = 2**31 - 1 +DEF _NUMERIC_DECODER_SMALLBUF_SIZE = 256 diff --git a/env/Lib/site-packages/asyncpg/pgproto/cpythonx.pxd b/env/Lib/site-packages/asyncpg/pgproto/cpythonx.pxd new file mode 100644 index 0000000..7b4f4f3 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/cpythonx.pxd @@ -0,0 +1,23 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +from cpython cimport Py_buffer + +cdef extern from "Python.h": + int PyUnicode_1BYTE_KIND + + int PyByteArray_CheckExact(object) + int PyByteArray_Resize(object, ssize_t) except -1 + object PyByteArray_FromStringAndSize(const char *, ssize_t) + char* PyByteArray_AsString(object) + + object PyUnicode_FromString(const char *u) + const char* PyUnicode_AsUTF8AndSize( + object unicode, ssize_t *size) except NULL + + object PyUnicode_FromKindAndData( + int kind, const void *buffer, Py_ssize_t size) diff --git a/env/Lib/site-packages/asyncpg/pgproto/debug.pxd b/env/Lib/site-packages/asyncpg/pgproto/debug.pxd new file mode 100644 index 0000000..5e59ec1 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/debug.pxd @@ -0,0 +1,10 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef extern from "debug.h": + + cdef int PG_DEBUG diff --git a/env/Lib/site-packages/asyncpg/pgproto/frb.pxd b/env/Lib/site-packages/asyncpg/pgproto/frb.pxd new file mode 100644 index 0000000..9ff8d10 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/frb.pxd @@ -0,0 +1,48 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef: + + struct FRBuffer: + const char* buf + ssize_t len + + inline ssize_t frb_get_len(FRBuffer *frb): + return frb.len + + inline void frb_set_len(FRBuffer *frb, ssize_t new_len): + frb.len = new_len + + inline void frb_init(FRBuffer *frb, const char *buf, ssize_t len): + frb.buf = buf + frb.len = len + + inline const char* frb_read(FRBuffer *frb, ssize_t n) except NULL: + cdef const char *result + + frb_check(frb, n) + + result = frb.buf + frb.buf += n + frb.len -= n + + return result + + inline const char* frb_read_all(FRBuffer *frb): + cdef const char *result + result = frb.buf + frb.buf += frb.len + frb.len = 0 + return result + + inline FRBuffer *frb_slice_from(FRBuffer *frb, + FRBuffer* source, ssize_t len): + frb.buf = frb_read(source, len) + frb.len = len + return frb + + object frb_check(FRBuffer *frb, ssize_t n) diff --git a/env/Lib/site-packages/asyncpg/pgproto/frb.pyx b/env/Lib/site-packages/asyncpg/pgproto/frb.pyx new file mode 100644 index 0000000..f11f6b9 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/frb.pyx @@ -0,0 +1,12 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef object frb_check(FRBuffer *frb, ssize_t n): + if n > frb.len: + raise AssertionError( + f'insufficient data in buffer: requested {n} ' + f'remaining {frb.len}') diff --git a/env/Lib/site-packages/asyncpg/pgproto/hton.pxd b/env/Lib/site-packages/asyncpg/pgproto/hton.pxd new file mode 100644 index 0000000..9b73abc --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/hton.pxd @@ -0,0 +1,24 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +from libc.stdint cimport int16_t, int32_t, uint16_t, uint32_t, int64_t, uint64_t + + +cdef extern from "./hton.h": + cdef void pack_int16(char *buf, int16_t x); + cdef void pack_int32(char *buf, int32_t x); + cdef void pack_int64(char *buf, int64_t x); + cdef void pack_float(char *buf, float f); + cdef void pack_double(char *buf, double f); + cdef int16_t unpack_int16(const char *buf); + cdef uint16_t unpack_uint16(const char *buf); + cdef int32_t unpack_int32(const char *buf); + cdef uint32_t unpack_uint32(const char *buf); + cdef int64_t unpack_int64(const char *buf); + cdef uint64_t unpack_uint64(const char *buf); + cdef float unpack_float(const char *buf); + cdef double unpack_double(const char *buf); diff --git a/env/Lib/site-packages/asyncpg/pgproto/pgproto.cp311-win_amd64.pyd b/env/Lib/site-packages/asyncpg/pgproto/pgproto.cp311-win_amd64.pyd new file mode 100644 index 0000000000000000000000000000000000000000..d0150ec891f9c9e04dba4174ae0c861c83aaafbb GIT binary patch literal 239104 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

        rI6 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 +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cimport cython +cimport cpython + +from libc.stdint cimport int16_t, int32_t, uint16_t, uint32_t, int64_t, uint64_t + + +include "./consts.pxi" +include "./frb.pxd" +include "./buffer.pxd" + + +include "./codecs/__init__.pxd" diff --git a/env/Lib/site-packages/asyncpg/pgproto/pgproto.pyx b/env/Lib/site-packages/asyncpg/pgproto/pgproto.pyx new file mode 100644 index 0000000..b880b7e --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/pgproto.pyx @@ -0,0 +1,49 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cimport cython +cimport cpython + +from . cimport cpythonx + +from libc.stdint cimport int8_t, uint8_t, int16_t, uint16_t, \ + int32_t, uint32_t, int64_t, uint64_t, \ + INT16_MIN, INT16_MAX, INT32_MIN, INT32_MAX, \ + UINT32_MAX, INT64_MIN, INT64_MAX, UINT64_MAX + + +from . cimport hton +from . cimport tohex + +from .debug cimport PG_DEBUG +from . import types as pgproto_types + + +include "./consts.pxi" +include "./frb.pyx" +include "./buffer.pyx" +include "./uuid.pyx" + +include "./codecs/context.pyx" + +include "./codecs/bytea.pyx" +include "./codecs/text.pyx" + +include "./codecs/datetime.pyx" +include "./codecs/float.pyx" +include "./codecs/int.pyx" +include "./codecs/json.pyx" +include "./codecs/jsonpath.pyx" +include "./codecs/uuid.pyx" +include "./codecs/numeric.pyx" +include "./codecs/bits.pyx" +include "./codecs/geometry.pyx" +include "./codecs/hstore.pyx" +include "./codecs/misc.pyx" +include "./codecs/network.pyx" +include "./codecs/tid.pyx" +include "./codecs/pg_snapshot.pyx" diff --git a/env/Lib/site-packages/asyncpg/pgproto/tohex.pxd b/env/Lib/site-packages/asyncpg/pgproto/tohex.pxd new file mode 100644 index 0000000..12fda84 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/tohex.pxd @@ -0,0 +1,10 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef extern from "./tohex.h": + cdef void uuid_to_str(const char *source, char *dest) + cdef void uuid_to_hex(const char *source, char *dest) diff --git a/env/Lib/site-packages/asyncpg/pgproto/types.py b/env/Lib/site-packages/asyncpg/pgproto/types.py new file mode 100644 index 0000000..9ed0e9b --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/types.py @@ -0,0 +1,423 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import builtins +import sys +import typing + +if sys.version_info >= (3, 8): + from typing import Literal, SupportsIndex +else: + from typing_extensions import Literal, SupportsIndex + + +__all__ = ( + 'BitString', 'Point', 'Path', 'Polygon', + 'Box', 'Line', 'LineSegment', 'Circle', +) + +_BitString = typing.TypeVar('_BitString', bound='BitString') +_BitOrderType = Literal['big', 'little'] + + +class BitString: + """Immutable representation of PostgreSQL `bit` and `varbit` types.""" + + __slots__ = '_bytes', '_bitlength' + + def __init__(self, + bitstring: typing.Optional[builtins.bytes] = None) -> None: + if not bitstring: + self._bytes = bytes() + self._bitlength = 0 + else: + bytelen = len(bitstring) // 8 + 1 + bytes_ = bytearray(bytelen) + byte = 0 + byte_pos = 0 + bit_pos = 0 + + for i, bit in enumerate(bitstring): + if bit == ' ': # type: ignore + continue + bit = int(bit) + if bit != 0 and bit != 1: + raise ValueError( + 'invalid bit value at position {}'.format(i)) + + byte |= bit << (8 - bit_pos - 1) + bit_pos += 1 + if bit_pos == 8: + bytes_[byte_pos] = byte + byte = 0 + byte_pos += 1 + bit_pos = 0 + + if bit_pos != 0: + bytes_[byte_pos] = byte + + bitlen = byte_pos * 8 + bit_pos + bytelen = byte_pos + (1 if bit_pos else 0) + + self._bytes = bytes(bytes_[:bytelen]) + self._bitlength = bitlen + + @classmethod + def frombytes(cls: typing.Type[_BitString], + bytes_: typing.Optional[builtins.bytes] = None, + bitlength: typing.Optional[int] = None) -> _BitString: + if bitlength is None: + if bytes_ is None: + bytes_ = bytes() + bitlength = 0 + else: + bitlength = len(bytes_) * 8 + else: + if bytes_ is None: + bytes_ = bytes(bitlength // 8 + 1) + bitlength = bitlength + else: + bytes_len = len(bytes_) * 8 + + if bytes_len == 0 and bitlength != 0: + raise ValueError('invalid bit length specified') + + if bytes_len != 0 and bitlength == 0: + raise ValueError('invalid bit length specified') + + if bitlength < bytes_len - 8: + raise ValueError('invalid bit length specified') + + if bitlength > bytes_len: + raise ValueError('invalid bit length specified') + + result = cls() + result._bytes = bytes_ + result._bitlength = bitlength + + return result + + @property + def bytes(self) -> builtins.bytes: + return self._bytes + + def as_string(self) -> str: + s = '' + + for i in range(self._bitlength): + s += str(self._getitem(i)) + if i % 4 == 3: + s += ' ' + + return s.strip() + + def to_int(self, bitorder: _BitOrderType = 'big', + *, signed: bool = False) -> int: + """Interpret the BitString as a Python int. + Acts similarly to int.from_bytes. + + :param bitorder: + Determines the bit order used to interpret the BitString. By + default, this function uses Postgres conventions for casting bits + to ints. If bitorder is 'big', the most significant bit is at the + start of the string (this is the same as the default). If bitorder + is 'little', the most significant bit is at the end of the string. + + :param bool signed: + Determines whether two's complement is used to interpret the + BitString. If signed is False, the returned value is always + non-negative. + + :return int: An integer representing the BitString. Information about + the BitString's exact length is lost. + + .. versionadded:: 0.18.0 + """ + x = int.from_bytes(self._bytes, byteorder='big') + x >>= -self._bitlength % 8 + if bitorder == 'big': + pass + elif bitorder == 'little': + x = int(bin(x)[:1:-1].ljust(self._bitlength, '0'), 2) + else: + raise ValueError("bitorder must be either 'big' or 'little'") + + if signed and self._bitlength > 0 and x & (1 << (self._bitlength - 1)): + x -= 1 << self._bitlength + return x + + @classmethod + def from_int(cls: typing.Type[_BitString], x: int, length: int, + bitorder: _BitOrderType = 'big', *, signed: bool = False) \ + -> _BitString: + """Represent the Python int x as a BitString. + Acts similarly to int.to_bytes. + + :param int x: + An integer to represent. Negative integers are represented in two's + complement form, unless the argument signed is False, in which case + negative integers raise an OverflowError. + + :param int length: + The length of the resulting BitString. An OverflowError is raised + if the integer is not representable in this many bits. + + :param bitorder: + Determines the bit order used in the BitString representation. By + default, this function uses Postgres conventions for casting ints + to bits. If bitorder is 'big', the most significant bit is at the + start of the string (this is the same as the default). If bitorder + is 'little', the most significant bit is at the end of the string. + + :param bool signed: + Determines whether two's complement is used in the BitString + representation. If signed is False and a negative integer is given, + an OverflowError is raised. + + :return BitString: A BitString representing the input integer, in the + form specified by the other input args. + + .. versionadded:: 0.18.0 + """ + # Exception types are by analogy to int.to_bytes + if length < 0: + raise ValueError("length argument must be non-negative") + elif length < x.bit_length(): + raise OverflowError("int too big to convert") + + if x < 0: + if not signed: + raise OverflowError("can't convert negative int to unsigned") + x &= (1 << length) - 1 + + if bitorder == 'big': + pass + elif bitorder == 'little': + x = int(bin(x)[:1:-1].ljust(length, '0'), 2) + else: + raise ValueError("bitorder must be either 'big' or 'little'") + + x <<= (-length % 8) + bytes_ = x.to_bytes((length + 7) // 8, byteorder='big') + return cls.frombytes(bytes_, length) + + def __repr__(self) -> str: + return ''.format(self.as_string()) + + __str__: typing.Callable[['BitString'], str] = __repr__ + + def __eq__(self, other: object) -> bool: + if not isinstance(other, BitString): + return NotImplemented + + return (self._bytes == other._bytes and + self._bitlength == other._bitlength) + + def __hash__(self) -> int: + return hash((self._bytes, self._bitlength)) + + def _getitem(self, i: int) -> int: + byte = self._bytes[i // 8] + shift = 8 - i % 8 - 1 + return (byte >> shift) & 0x1 + + def __getitem__(self, i: int) -> int: + if isinstance(i, slice): + raise NotImplementedError('BitString does not support slices') + + if i >= self._bitlength: + raise IndexError('index out of range') + + return self._getitem(i) + + def __len__(self) -> int: + return self._bitlength + + +class Point(typing.Tuple[float, float]): + """Immutable representation of PostgreSQL `point` type.""" + + __slots__ = () + + def __new__(cls, + x: typing.Union[typing.SupportsFloat, + SupportsIndex, + typing.Text, + builtins.bytes, + builtins.bytearray], + y: typing.Union[typing.SupportsFloat, + SupportsIndex, + typing.Text, + builtins.bytes, + builtins.bytearray]) -> 'Point': + return super().__new__(cls, + typing.cast(typing.Any, (float(x), float(y)))) + + def __repr__(self) -> str: + return '{}.{}({})'.format( + type(self).__module__, + type(self).__name__, + tuple.__repr__(self) + ) + + @property + def x(self) -> float: + return self[0] + + @property + def y(self) -> float: + return self[1] + + +class Box(typing.Tuple[Point, Point]): + """Immutable representation of PostgreSQL `box` type.""" + + __slots__ = () + + def __new__(cls, high: typing.Sequence[float], + low: typing.Sequence[float]) -> 'Box': + return super().__new__(cls, + typing.cast(typing.Any, (Point(*high), + Point(*low)))) + + def __repr__(self) -> str: + return '{}.{}({})'.format( + type(self).__module__, + type(self).__name__, + tuple.__repr__(self) + ) + + @property + def high(self) -> Point: + return self[0] + + @property + def low(self) -> Point: + return self[1] + + +class Line(typing.Tuple[float, float, float]): + """Immutable representation of PostgreSQL `line` type.""" + + __slots__ = () + + def __new__(cls, A: float, B: float, C: float) -> 'Line': + return super().__new__(cls, typing.cast(typing.Any, (A, B, C))) + + @property + def A(self) -> float: + return self[0] + + @property + def B(self) -> float: + return self[1] + + @property + def C(self) -> float: + return self[2] + + +class LineSegment(typing.Tuple[Point, Point]): + """Immutable representation of PostgreSQL `lseg` type.""" + + __slots__ = () + + def __new__(cls, p1: typing.Sequence[float], + p2: typing.Sequence[float]) -> 'LineSegment': + return super().__new__(cls, + typing.cast(typing.Any, (Point(*p1), + Point(*p2)))) + + def __repr__(self) -> str: + return '{}.{}({})'.format( + type(self).__module__, + type(self).__name__, + tuple.__repr__(self) + ) + + @property + def p1(self) -> Point: + return self[0] + + @property + def p2(self) -> Point: + return self[1] + + +class Path: + """Immutable representation of PostgreSQL `path` type.""" + + __slots__ = '_is_closed', 'points' + + points: typing.Tuple[Point, ...] + + def __init__(self, *points: typing.Sequence[float], + is_closed: bool = False) -> None: + self.points = tuple(Point(*p) for p in points) + self._is_closed = is_closed + + @property + def is_closed(self) -> bool: + return self._is_closed + + def __eq__(self, other: object) -> bool: + if not isinstance(other, Path): + return NotImplemented + + return (self.points == other.points and + self._is_closed == other._is_closed) + + def __hash__(self) -> int: + return hash((self.points, self.is_closed)) + + def __iter__(self) -> typing.Iterator[Point]: + return iter(self.points) + + def __len__(self) -> int: + return len(self.points) + + @typing.overload + def __getitem__(self, i: int) -> Point: + ... + + @typing.overload + def __getitem__(self, i: slice) -> typing.Tuple[Point, ...]: + ... + + def __getitem__(self, i: typing.Union[int, slice]) \ + -> typing.Union[Point, typing.Tuple[Point, ...]]: + return self.points[i] + + def __contains__(self, point: object) -> bool: + return point in self.points + + +class Polygon(Path): + """Immutable representation of PostgreSQL `polygon` type.""" + + __slots__ = () + + def __init__(self, *points: typing.Sequence[float]) -> None: + # polygon is always closed + super().__init__(*points, is_closed=True) + + +class Circle(typing.Tuple[Point, float]): + """Immutable representation of PostgreSQL `circle` type.""" + + __slots__ = () + + def __new__(cls, center: Point, radius: float) -> 'Circle': + return super().__new__(cls, typing.cast(typing.Any, (center, radius))) + + @property + def center(self) -> Point: + return self[0] + + @property + def radius(self) -> float: + return self[1] diff --git a/env/Lib/site-packages/asyncpg/pgproto/uuid.pyx b/env/Lib/site-packages/asyncpg/pgproto/uuid.pyx new file mode 100644 index 0000000..52900ff --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pgproto/uuid.pyx @@ -0,0 +1,353 @@ +import functools +import uuid + +cimport cython +cimport cpython + +from libc.stdint cimport uint8_t, int8_t +from libc.string cimport memcpy, memcmp + + +cdef extern from "Python.h": + int PyUnicode_1BYTE_KIND + const char* PyUnicode_AsUTF8AndSize( + object unicode, Py_ssize_t *size) except NULL + object PyUnicode_FromKindAndData( + int kind, const void *buffer, Py_ssize_t size) + + +cdef extern from "./tohex.h": + cdef void uuid_to_str(const char *source, char *dest) + cdef void uuid_to_hex(const char *source, char *dest) + + +# A more efficient UUID type implementation +# (6-7x faster than the starndard uuid.UUID): +# +# -= Benchmark results (less is better): =- +# +# std_UUID(bytes): 1.2368 +# c_UUID(bytes): * 0.1645 (7.52x) +# object(): 0.1483 +# +# std_UUID(str): 1.8038 +# c_UUID(str): * 0.2313 (7.80x) +# +# str(std_UUID()): 1.4625 +# str(c_UUID()): * 0.2681 (5.46x) +# str(object()): 0.5975 +# +# std_UUID().bytes: 0.3508 +# c_UUID().bytes: * 0.1068 (3.28x) +# +# std_UUID().int: 0.0871 +# c_UUID().int: * 0.0856 +# +# std_UUID().hex: 0.4871 +# c_UUID().hex: * 0.1405 +# +# hash(std_UUID()): 0.3635 +# hash(c_UUID()): * 0.1564 (2.32x) +# +# dct[std_UUID()]: 0.3319 +# dct[c_UUID()]: * 0.1570 (2.11x) +# +# std_UUID() ==: 0.3478 +# c_UUID() ==: * 0.0915 (3.80x) + + +cdef char _hextable[256] +_hextable[:] = [ + -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1, + -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1, + -1,-1, 0,1,2,3,4,5,6,7,8,9,-1,-1,-1,-1,-1,-1,-1,10,11,12,13,14,15,-1, + -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1, + -1,-1,10,11,12,13,14,15,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1, + -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1, + -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1, + -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1, + -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1, + -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1, + -1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1 +] + + +cdef std_UUID = uuid.UUID + + +cdef pg_uuid_bytes_from_str(str u, char *out): + cdef: + const char *orig_buf + Py_ssize_t size + unsigned char ch + uint8_t acc, part, acc_set + int i, j + + orig_buf = PyUnicode_AsUTF8AndSize(u, &size) + if size > 36 or size < 32: + raise ValueError( + f'invalid UUID {u!r}: ' + f'length must be between 32..36 characters, got {size}') + + acc_set = 0 + j = 0 + for i in range(size): + ch = orig_buf[i] + if ch == b'-': + continue + + part = _hextable[ch] + if part == -1: + if ch >= 0x20 and ch <= 0x7e: + raise ValueError( + f'invalid UUID {u!r}: unexpected character {chr(ch)!r}') + else: + raise ValueError('invalid UUID {u!r}: unexpected character') + + if acc_set: + acc |= part + out[j] = acc + acc_set = 0 + j += 1 + else: + acc = (part << 4) + acc_set = 1 + + if j > 16 or (j == 16 and acc_set): + raise ValueError( + f'invalid UUID {u!r}: decodes to more than 16 bytes') + + if j != 16: + raise ValueError( + f'invalid UUID {u!r}: decodes to less than 16 bytes') + + +cdef class __UUIDReplaceMe: + pass + + +cdef pg_uuid_from_buf(const char *buf): + cdef: + UUID u = UUID.__new__(UUID) + memcpy(u._data, buf, 16) + return u + + +@cython.final +@cython.no_gc_clear +cdef class UUID(__UUIDReplaceMe): + + cdef: + char _data[16] + object _int + object _hash + object __weakref__ + + def __cinit__(self): + self._int = None + self._hash = None + + def __init__(self, inp): + cdef: + char *buf + Py_ssize_t size + + if cpython.PyBytes_Check(inp): + cpython.PyBytes_AsStringAndSize(inp, &buf, &size) + if size != 16: + raise ValueError(f'16 bytes were expected, got {size}') + memcpy(self._data, buf, 16) + + elif cpython.PyUnicode_Check(inp): + pg_uuid_bytes_from_str(inp, self._data) + else: + raise TypeError(f'a bytes or str object expected, got {inp!r}') + + @property + def bytes(self): + return cpython.PyBytes_FromStringAndSize(self._data, 16) + + @property + def int(self): + if self._int is None: + # The cache is important because `self.int` can be + # used multiple times by __hash__ etc. + self._int = int.from_bytes(self.bytes, 'big') + return self._int + + @property + def is_safe(self): + return uuid.SafeUUID.unknown + + def __str__(self): + cdef char out[36] + uuid_to_str(self._data, out) + return PyUnicode_FromKindAndData(PyUnicode_1BYTE_KIND, out, 36) + + @property + def hex(self): + cdef char out[32] + uuid_to_hex(self._data, out) + return PyUnicode_FromKindAndData(PyUnicode_1BYTE_KIND, out, 32) + + def __repr__(self): + return f"UUID('{self}')" + + def __reduce__(self): + return (type(self), (self.bytes,)) + + def __eq__(self, other): + if type(other) is UUID: + return memcmp(self._data, (other)._data, 16) == 0 + if isinstance(other, std_UUID): + return self.int == other.int + return NotImplemented + + def __ne__(self, other): + if type(other) is UUID: + return memcmp(self._data, (other)._data, 16) != 0 + if isinstance(other, std_UUID): + return self.int != other.int + return NotImplemented + + def __lt__(self, other): + if type(other) is UUID: + return memcmp(self._data, (other)._data, 16) < 0 + if isinstance(other, std_UUID): + return self.int < other.int + return NotImplemented + + def __gt__(self, other): + if type(other) is UUID: + return memcmp(self._data, (other)._data, 16) > 0 + if isinstance(other, std_UUID): + return self.int > other.int + return NotImplemented + + def __le__(self, other): + if type(other) is UUID: + return memcmp(self._data, (other)._data, 16) <= 0 + if isinstance(other, std_UUID): + return self.int <= other.int + return NotImplemented + + def __ge__(self, other): + if type(other) is UUID: + return memcmp(self._data, (other)._data, 16) >= 0 + if isinstance(other, std_UUID): + return self.int >= other.int + return NotImplemented + + def __hash__(self): + # In EdgeDB every schema object has a uuid and there are + # huge hash-maps of them. We want UUID.__hash__ to be + # as fast as possible. + if self._hash is not None: + return self._hash + + self._hash = hash(self.int) + return self._hash + + def __int__(self): + return self.int + + @property + def bytes_le(self): + bytes = self.bytes + return (bytes[4-1::-1] + bytes[6-1:4-1:-1] + bytes[8-1:6-1:-1] + + bytes[8:]) + + @property + def fields(self): + return (self.time_low, self.time_mid, self.time_hi_version, + self.clock_seq_hi_variant, self.clock_seq_low, self.node) + + @property + def time_low(self): + return self.int >> 96 + + @property + def time_mid(self): + return (self.int >> 80) & 0xffff + + @property + def time_hi_version(self): + return (self.int >> 64) & 0xffff + + @property + def clock_seq_hi_variant(self): + return (self.int >> 56) & 0xff + + @property + def clock_seq_low(self): + return (self.int >> 48) & 0xff + + @property + def time(self): + return (((self.time_hi_version & 0x0fff) << 48) | + (self.time_mid << 32) | self.time_low) + + @property + def clock_seq(self): + return (((self.clock_seq_hi_variant & 0x3f) << 8) | + self.clock_seq_low) + + @property + def node(self): + return self.int & 0xffffffffffff + + @property + def urn(self): + return 'urn:uuid:' + str(self) + + @property + def variant(self): + if not self.int & (0x8000 << 48): + return uuid.RESERVED_NCS + elif not self.int & (0x4000 << 48): + return uuid.RFC_4122 + elif not self.int & (0x2000 << 48): + return uuid.RESERVED_MICROSOFT + else: + return uuid.RESERVED_FUTURE + + @property + def version(self): + # The version bits are only meaningful for RFC 4122 UUIDs. + if self.variant == uuid.RFC_4122: + return int((self.int >> 76) & 0xf) + + +# +# In order for `isinstance(pgproto.UUID, uuid.UUID)` to work, +# patch __bases__ and __mro__ by injecting `uuid.UUID`. +# +# We apply brute-force here because the following pattern stopped +# working with Python 3.8: +# +# cdef class OurUUID: +# ... +# +# class UUID(OurUUID, uuid.UUID): +# ... +# +# With Python 3.8 it now produces +# +# "TypeError: multiple bases have instance lay-out conflict" +# +# error. Maybe it's possible to fix this some other way, but +# the best solution possible would be to just contribute our +# faster UUID to the standard library and not have this problem +# at all. For now this hack is pretty safe and should be +# compatible with future Pythons for long enough. +# +assert UUID.__bases__[0] is __UUIDReplaceMe +assert UUID.__mro__[1] is __UUIDReplaceMe +cpython.Py_INCREF(std_UUID) +cpython.PyTuple_SET_ITEM(UUID.__bases__, 0, std_UUID) +cpython.Py_INCREF(std_UUID) +cpython.PyTuple_SET_ITEM(UUID.__mro__, 1, std_UUID) +# + + +cdef pg_UUID = UUID diff --git a/env/Lib/site-packages/asyncpg/pool.py b/env/Lib/site-packages/asyncpg/pool.py new file mode 100644 index 0000000..06e698d --- /dev/null +++ b/env/Lib/site-packages/asyncpg/pool.py @@ -0,0 +1,1130 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import asyncio +import functools +import inspect +import logging +import time +import warnings + +from . import compat +from . import connection +from . import exceptions +from . import protocol + + +logger = logging.getLogger(__name__) + + +class PoolConnectionProxyMeta(type): + + def __new__(mcls, name, bases, dct, *, wrap=False): + if wrap: + for attrname in dir(connection.Connection): + if attrname.startswith('_') or attrname in dct: + continue + + meth = getattr(connection.Connection, attrname) + if not inspect.isfunction(meth): + continue + + wrapper = mcls._wrap_connection_method(attrname) + wrapper = functools.update_wrapper(wrapper, meth) + dct[attrname] = wrapper + + if '__doc__' not in dct: + dct['__doc__'] = connection.Connection.__doc__ + + return super().__new__(mcls, name, bases, dct) + + @staticmethod + def _wrap_connection_method(meth_name): + def call_con_method(self, *args, **kwargs): + # This method will be owned by PoolConnectionProxy class. + if self._con is None: + raise exceptions.InterfaceError( + 'cannot call Connection.{}(): ' + 'connection has been released back to the pool'.format( + meth_name)) + + meth = getattr(self._con.__class__, meth_name) + return meth(self._con, *args, **kwargs) + + return call_con_method + + +class PoolConnectionProxy(connection._ConnectionProxy, + metaclass=PoolConnectionProxyMeta, + wrap=True): + + __slots__ = ('_con', '_holder') + + def __init__(self, holder: 'PoolConnectionHolder', + con: connection.Connection): + self._con = con + self._holder = holder + con._set_proxy(self) + + def __getattr__(self, attr): + # Proxy all unresolved attributes to the wrapped Connection object. + return getattr(self._con, attr) + + def _detach(self) -> connection.Connection: + if self._con is None: + return + + con, self._con = self._con, None + con._set_proxy(None) + return con + + def __repr__(self): + if self._con is None: + return '<{classname} [released] {id:#x}>'.format( + classname=self.__class__.__name__, id=id(self)) + else: + return '<{classname} {con!r} {id:#x}>'.format( + classname=self.__class__.__name__, con=self._con, id=id(self)) + + +class PoolConnectionHolder: + + __slots__ = ('_con', '_pool', '_loop', '_proxy', + '_max_queries', '_setup', + '_max_inactive_time', '_in_use', + '_inactive_callback', '_timeout', + '_generation') + + def __init__(self, pool, *, max_queries, setup, max_inactive_time): + + self._pool = pool + self._con = None + self._proxy = None + + self._max_queries = max_queries + self._max_inactive_time = max_inactive_time + self._setup = setup + self._inactive_callback = None + self._in_use = None # type: asyncio.Future + self._timeout = None + self._generation = None + + def is_connected(self): + return self._con is not None and not self._con.is_closed() + + def is_idle(self): + return not self._in_use + + async def connect(self): + if self._con is not None: + raise exceptions.InternalClientError( + 'PoolConnectionHolder.connect() called while another ' + 'connection already exists') + + self._con = await self._pool._get_new_connection() + self._generation = self._pool._generation + self._maybe_cancel_inactive_callback() + self._setup_inactive_callback() + + async def acquire(self) -> PoolConnectionProxy: + if self._con is None or self._con.is_closed(): + self._con = None + await self.connect() + + elif self._generation != self._pool._generation: + # Connections have been expired, re-connect the holder. + self._pool._loop.create_task( + self._con.close(timeout=self._timeout)) + self._con = None + await self.connect() + + self._maybe_cancel_inactive_callback() + + self._proxy = proxy = PoolConnectionProxy(self, self._con) + + if self._setup is not None: + try: + await self._setup(proxy) + except (Exception, asyncio.CancelledError) as ex: + # If a user-defined `setup` function fails, we don't + # know if the connection is safe for re-use, hence + # we close it. A new connection will be created + # when `acquire` is called again. + try: + # Use `close()` to close the connection gracefully. + # An exception in `setup` isn't necessarily caused + # by an IO or a protocol error. close() will + # do the necessary cleanup via _release_on_close(). + await self._con.close() + finally: + raise ex + + self._in_use = self._pool._loop.create_future() + + return proxy + + async def release(self, timeout): + if self._in_use is None: + raise exceptions.InternalClientError( + 'PoolConnectionHolder.release() called on ' + 'a free connection holder') + + if self._con.is_closed(): + # When closing, pool connections perform the necessary + # cleanup, so we don't have to do anything else here. + return + + self._timeout = None + + if self._con._protocol.queries_count >= self._max_queries: + # The connection has reached its maximum utilization limit, + # so close it. Connection.close() will call _release(). + await self._con.close(timeout=timeout) + return + + if self._generation != self._pool._generation: + # The connection has expired because it belongs to + # an older generation (Pool.expire_connections() has + # been called.) + await self._con.close(timeout=timeout) + return + + try: + budget = timeout + + if self._con._protocol._is_cancelling(): + # If the connection is in cancellation state, + # wait for the cancellation + started = time.monotonic() + await compat.wait_for( + self._con._protocol._wait_for_cancellation(), + budget) + if budget is not None: + budget -= time.monotonic() - started + + await self._con.reset(timeout=budget) + except (Exception, asyncio.CancelledError) as ex: + # If the `reset` call failed, terminate the connection. + # A new one will be created when `acquire` is called + # again. + try: + # An exception in `reset` is most likely caused by + # an IO error, so terminate the connection. + self._con.terminate() + finally: + raise ex + + # Free this connection holder and invalidate the + # connection proxy. + self._release() + + # Rearm the connection inactivity timer. + self._setup_inactive_callback() + + async def wait_until_released(self): + if self._in_use is None: + return + else: + await self._in_use + + async def close(self): + if self._con is not None: + # Connection.close() will call _release_on_close() to + # finish holder cleanup. + await self._con.close() + + def terminate(self): + if self._con is not None: + # Connection.terminate() will call _release_on_close() to + # finish holder cleanup. + self._con.terminate() + + def _setup_inactive_callback(self): + if self._inactive_callback is not None: + raise exceptions.InternalClientError( + 'pool connection inactivity timer already exists') + + if self._max_inactive_time: + self._inactive_callback = self._pool._loop.call_later( + self._max_inactive_time, self._deactivate_inactive_connection) + + def _maybe_cancel_inactive_callback(self): + if self._inactive_callback is not None: + self._inactive_callback.cancel() + self._inactive_callback = None + + def _deactivate_inactive_connection(self): + if self._in_use is not None: + raise exceptions.InternalClientError( + 'attempting to deactivate an acquired connection') + + if self._con is not None: + # The connection is idle and not in use, so it's fine to + # use terminate() instead of close(). + self._con.terminate() + # Must call clear_connection, because _deactivate_connection + # is called when the connection is *not* checked out, and + # so terminate() above will not call the below. + self._release_on_close() + + def _release_on_close(self): + self._maybe_cancel_inactive_callback() + self._release() + self._con = None + + def _release(self): + """Release this connection holder.""" + if self._in_use is None: + # The holder is not checked out. + return + + if not self._in_use.done(): + self._in_use.set_result(None) + self._in_use = None + + # Deinitialize the connection proxy. All subsequent + # operations on it will fail. + if self._proxy is not None: + self._proxy._detach() + self._proxy = None + + # Put ourselves back to the pool queue. + self._pool._queue.put_nowait(self) + + +class Pool: + """A connection pool. + + Connection pool can be used to manage a set of connections to the database. + Connections are first acquired from the pool, then used, and then released + back to the pool. Once a connection is released, it's reset to close all + open cursors and other resources *except* prepared statements. + + Pools are created by calling :func:`~asyncpg.pool.create_pool`. + """ + + __slots__ = ( + '_queue', '_loop', '_minsize', '_maxsize', + '_init', '_connect_args', '_connect_kwargs', + '_holders', '_initialized', '_initializing', '_closing', + '_closed', '_connection_class', '_record_class', '_generation', + '_setup', '_max_queries', '_max_inactive_connection_lifetime' + ) + + def __init__(self, *connect_args, + min_size, + max_size, + max_queries, + max_inactive_connection_lifetime, + setup, + init, + loop, + connection_class, + record_class, + **connect_kwargs): + + if len(connect_args) > 1: + warnings.warn( + "Passing multiple positional arguments to asyncpg.Pool " + "constructor is deprecated and will be removed in " + "asyncpg 0.17.0. The non-deprecated form is " + "asyncpg.Pool(, **kwargs)", + DeprecationWarning, stacklevel=2) + + if loop is None: + loop = asyncio.get_event_loop() + self._loop = loop + + if max_size <= 0: + raise ValueError('max_size is expected to be greater than zero') + + if min_size < 0: + raise ValueError( + 'min_size is expected to be greater or equal to zero') + + if min_size > max_size: + raise ValueError('min_size is greater than max_size') + + if max_queries <= 0: + raise ValueError('max_queries is expected to be greater than zero') + + if max_inactive_connection_lifetime < 0: + raise ValueError( + 'max_inactive_connection_lifetime is expected to be greater ' + 'or equal to zero') + + if not issubclass(connection_class, connection.Connection): + raise TypeError( + 'connection_class is expected to be a subclass of ' + 'asyncpg.Connection, got {!r}'.format(connection_class)) + + if not issubclass(record_class, protocol.Record): + raise TypeError( + 'record_class is expected to be a subclass of ' + 'asyncpg.Record, got {!r}'.format(record_class)) + + self._minsize = min_size + self._maxsize = max_size + + self._holders = [] + self._initialized = False + self._initializing = False + self._queue = None + + self._connection_class = connection_class + self._record_class = record_class + + self._closing = False + self._closed = False + self._generation = 0 + self._init = init + self._connect_args = connect_args + self._connect_kwargs = connect_kwargs + + self._setup = setup + self._max_queries = max_queries + self._max_inactive_connection_lifetime = \ + max_inactive_connection_lifetime + + async def _async__init__(self): + if self._initialized: + return + if self._initializing: + raise exceptions.InterfaceError( + 'pool is being initialized in another task') + if self._closed: + raise exceptions.InterfaceError('pool is closed') + self._initializing = True + try: + await self._initialize() + return self + finally: + self._initializing = False + self._initialized = True + + async def _initialize(self): + self._queue = asyncio.LifoQueue(maxsize=self._maxsize) + for _ in range(self._maxsize): + ch = PoolConnectionHolder( + self, + max_queries=self._max_queries, + max_inactive_time=self._max_inactive_connection_lifetime, + setup=self._setup) + + self._holders.append(ch) + self._queue.put_nowait(ch) + + if self._minsize: + # Since we use a LIFO queue, the first items in the queue will be + # the last ones in `self._holders`. We want to pre-connect the + # first few connections in the queue, therefore we want to walk + # `self._holders` in reverse. + + # Connect the first connection holder in the queue so that + # any connection issues are visible early. + first_ch = self._holders[-1] # type: PoolConnectionHolder + await first_ch.connect() + + if self._minsize > 1: + connect_tasks = [] + for i, ch in enumerate(reversed(self._holders[:-1])): + # `minsize - 1` because we already have first_ch + if i >= self._minsize - 1: + break + connect_tasks.append(ch.connect()) + + await asyncio.gather(*connect_tasks) + + def is_closing(self): + """Return ``True`` if the pool is closing or is closed. + + .. versionadded:: 0.28.0 + """ + return self._closed or self._closing + + def get_size(self): + """Return the current number of connections in this pool. + + .. versionadded:: 0.25.0 + """ + return sum(h.is_connected() for h in self._holders) + + def get_min_size(self): + """Return the minimum number of connections in this pool. + + .. versionadded:: 0.25.0 + """ + return self._minsize + + def get_max_size(self): + """Return the maximum allowed number of connections in this pool. + + .. versionadded:: 0.25.0 + """ + return self._maxsize + + def get_idle_size(self): + """Return the current number of idle connections in this pool. + + .. versionadded:: 0.25.0 + """ + return sum(h.is_connected() and h.is_idle() for h in self._holders) + + def set_connect_args(self, dsn=None, **connect_kwargs): + r"""Set the new connection arguments for this pool. + + The new connection arguments will be used for all subsequent + new connection attempts. Existing connections will remain until + they expire. Use :meth:`Pool.expire_connections() + ` to expedite the connection + expiry. + + :param str dsn: + Connection arguments specified using as a single string in + the following format: + ``postgres://user:pass@host:port/database?option=value``. + + :param \*\*connect_kwargs: + Keyword arguments for the :func:`~asyncpg.connection.connect` + function. + + .. versionadded:: 0.16.0 + """ + + self._connect_args = [dsn] + self._connect_kwargs = connect_kwargs + + async def _get_new_connection(self): + con = await connection.connect( + *self._connect_args, + loop=self._loop, + connection_class=self._connection_class, + record_class=self._record_class, + **self._connect_kwargs, + ) + + if self._init is not None: + try: + await self._init(con) + except (Exception, asyncio.CancelledError) as ex: + # If a user-defined `init` function fails, we don't + # know if the connection is safe for re-use, hence + # we close it. A new connection will be created + # when `acquire` is called again. + try: + # Use `close()` to close the connection gracefully. + # An exception in `init` isn't necessarily caused + # by an IO or a protocol error. close() will + # do the necessary cleanup via _release_on_close(). + await con.close() + finally: + raise ex + + return con + + async def execute(self, query: str, *args, timeout: float=None) -> str: + """Execute an SQL command (or commands). + + Pool performs this operation using one of its connections. Other than + that, it behaves identically to + :meth:`Connection.execute() `. + + .. versionadded:: 0.10.0 + """ + async with self.acquire() as con: + return await con.execute(query, *args, timeout=timeout) + + async def executemany(self, command: str, args, *, timeout: float=None): + """Execute an SQL *command* for each sequence of arguments in *args*. + + Pool performs this operation using one of its connections. Other than + that, it behaves identically to + :meth:`Connection.executemany() + `. + + .. versionadded:: 0.10.0 + """ + async with self.acquire() as con: + return await con.executemany(command, args, timeout=timeout) + + async def fetch( + self, + query, + *args, + timeout=None, + record_class=None + ) -> list: + """Run a query and return the results as a list of :class:`Record`. + + Pool performs this operation using one of its connections. Other than + that, it behaves identically to + :meth:`Connection.fetch() `. + + .. versionadded:: 0.10.0 + """ + async with self.acquire() as con: + return await con.fetch( + query, + *args, + timeout=timeout, + record_class=record_class + ) + + async def fetchval(self, query, *args, column=0, timeout=None): + """Run a query and return a value in the first row. + + Pool performs this operation using one of its connections. Other than + that, it behaves identically to + :meth:`Connection.fetchval() + `. + + .. versionadded:: 0.10.0 + """ + async with self.acquire() as con: + return await con.fetchval( + query, *args, column=column, timeout=timeout) + + async def fetchrow(self, query, *args, timeout=None, record_class=None): + """Run a query and return the first row. + + Pool performs this operation using one of its connections. Other than + that, it behaves identically to + :meth:`Connection.fetchrow() `. + + .. versionadded:: 0.10.0 + """ + async with self.acquire() as con: + return await con.fetchrow( + query, + *args, + timeout=timeout, + record_class=record_class + ) + + async def copy_from_table( + self, + table_name, + *, + output, + columns=None, + schema_name=None, + timeout=None, + format=None, + oids=None, + delimiter=None, + null=None, + header=None, + quote=None, + escape=None, + force_quote=None, + encoding=None + ): + """Copy table contents to a file or file-like object. + + Pool performs this operation using one of its connections. Other than + that, it behaves identically to + :meth:`Connection.copy_from_table() + `. + + .. versionadded:: 0.24.0 + """ + async with self.acquire() as con: + return await con.copy_from_table( + table_name, + output=output, + columns=columns, + schema_name=schema_name, + timeout=timeout, + format=format, + oids=oids, + delimiter=delimiter, + null=null, + header=header, + quote=quote, + escape=escape, + force_quote=force_quote, + encoding=encoding + ) + + async def copy_from_query( + self, + query, + *args, + output, + timeout=None, + format=None, + oids=None, + delimiter=None, + null=None, + header=None, + quote=None, + escape=None, + force_quote=None, + encoding=None + ): + """Copy the results of a query to a file or file-like object. + + Pool performs this operation using one of its connections. Other than + that, it behaves identically to + :meth:`Connection.copy_from_query() + `. + + .. versionadded:: 0.24.0 + """ + async with self.acquire() as con: + return await con.copy_from_query( + query, + *args, + output=output, + timeout=timeout, + format=format, + oids=oids, + delimiter=delimiter, + null=null, + header=header, + quote=quote, + escape=escape, + force_quote=force_quote, + encoding=encoding + ) + + async def copy_to_table( + self, + table_name, + *, + source, + columns=None, + schema_name=None, + timeout=None, + format=None, + oids=None, + freeze=None, + delimiter=None, + null=None, + header=None, + quote=None, + escape=None, + force_quote=None, + force_not_null=None, + force_null=None, + encoding=None, + where=None + ): + """Copy data to the specified table. + + Pool performs this operation using one of its connections. Other than + that, it behaves identically to + :meth:`Connection.copy_to_table() + `. + + .. versionadded:: 0.24.0 + """ + async with self.acquire() as con: + return await con.copy_to_table( + table_name, + source=source, + columns=columns, + schema_name=schema_name, + timeout=timeout, + format=format, + oids=oids, + freeze=freeze, + delimiter=delimiter, + null=null, + header=header, + quote=quote, + escape=escape, + force_quote=force_quote, + force_not_null=force_not_null, + force_null=force_null, + encoding=encoding, + where=where + ) + + async def copy_records_to_table( + self, + table_name, + *, + records, + columns=None, + schema_name=None, + timeout=None, + where=None + ): + """Copy a list of records to the specified table using binary COPY. + + Pool performs this operation using one of its connections. Other than + that, it behaves identically to + :meth:`Connection.copy_records_to_table() + `. + + .. versionadded:: 0.24.0 + """ + async with self.acquire() as con: + return await con.copy_records_to_table( + table_name, + records=records, + columns=columns, + schema_name=schema_name, + timeout=timeout, + where=where + ) + + def acquire(self, *, timeout=None): + """Acquire a database connection from the pool. + + :param float timeout: A timeout for acquiring a Connection. + :return: An instance of :class:`~asyncpg.connection.Connection`. + + Can be used in an ``await`` expression or with an ``async with`` block. + + .. code-block:: python + + async with pool.acquire() as con: + await con.execute(...) + + Or: + + .. code-block:: python + + con = await pool.acquire() + try: + await con.execute(...) + finally: + await pool.release(con) + """ + return PoolAcquireContext(self, timeout) + + async def _acquire(self, timeout): + async def _acquire_impl(): + ch = await self._queue.get() # type: PoolConnectionHolder + try: + proxy = await ch.acquire() # type: PoolConnectionProxy + except (Exception, asyncio.CancelledError): + self._queue.put_nowait(ch) + raise + else: + # Record the timeout, as we will apply it by default + # in release(). + ch._timeout = timeout + return proxy + + if self._closing: + raise exceptions.InterfaceError('pool is closing') + self._check_init() + + if timeout is None: + return await _acquire_impl() + else: + return await compat.wait_for( + _acquire_impl(), timeout=timeout) + + async def release(self, connection, *, timeout=None): + """Release a database connection back to the pool. + + :param Connection connection: + A :class:`~asyncpg.connection.Connection` object to release. + :param float timeout: + A timeout for releasing the connection. If not specified, defaults + to the timeout provided in the corresponding call to the + :meth:`Pool.acquire() ` method. + + .. versionchanged:: 0.14.0 + Added the *timeout* parameter. + """ + if (type(connection) is not PoolConnectionProxy or + connection._holder._pool is not self): + raise exceptions.InterfaceError( + 'Pool.release() received invalid connection: ' + '{connection!r} is not a member of this pool'.format( + connection=connection)) + + if connection._con is None: + # Already released, do nothing. + return + + self._check_init() + + # Let the connection do its internal housekeeping when its released. + connection._con._on_release() + + ch = connection._holder + if timeout is None: + timeout = ch._timeout + + # Use asyncio.shield() to guarantee that task cancellation + # does not prevent the connection from being returned to the + # pool properly. + return await asyncio.shield(ch.release(timeout)) + + async def close(self): + """Attempt to gracefully close all connections in the pool. + + Wait until all pool connections are released, close them and + shut down the pool. If any error (including cancellation) occurs + in ``close()`` the pool will terminate by calling + :meth:`Pool.terminate() `. + + It is advisable to use :func:`python:asyncio.wait_for` to set + a timeout. + + .. versionchanged:: 0.16.0 + ``close()`` now waits until all pool connections are released + before closing them and the pool. Errors raised in ``close()`` + will cause immediate pool termination. + """ + if self._closed: + return + self._check_init() + + self._closing = True + + warning_callback = None + try: + warning_callback = self._loop.call_later( + 60, self._warn_on_long_close) + + release_coros = [ + ch.wait_until_released() for ch in self._holders] + await asyncio.gather(*release_coros) + + close_coros = [ + ch.close() for ch in self._holders] + await asyncio.gather(*close_coros) + + except (Exception, asyncio.CancelledError): + self.terminate() + raise + + finally: + if warning_callback is not None: + warning_callback.cancel() + self._closed = True + self._closing = False + + def _warn_on_long_close(self): + logger.warning('Pool.close() is taking over 60 seconds to complete. ' + 'Check if you have any unreleased connections left. ' + 'Use asyncio.wait_for() to set a timeout for ' + 'Pool.close().') + + def terminate(self): + """Terminate all connections in the pool.""" + if self._closed: + return + self._check_init() + for ch in self._holders: + ch.terminate() + self._closed = True + + async def expire_connections(self): + """Expire all currently open connections. + + Cause all currently open connections to get replaced on the + next :meth:`~asyncpg.pool.Pool.acquire()` call. + + .. versionadded:: 0.16.0 + """ + self._generation += 1 + + def _check_init(self): + if not self._initialized: + if self._initializing: + raise exceptions.InterfaceError( + 'pool is being initialized, but not yet ready: ' + 'likely there is a race between creating a pool and ' + 'using it') + raise exceptions.InterfaceError('pool is not initialized') + if self._closed: + raise exceptions.InterfaceError('pool is closed') + + def _drop_statement_cache(self): + # Drop statement cache for all connections in the pool. + for ch in self._holders: + if ch._con is not None: + ch._con._drop_local_statement_cache() + + def _drop_type_cache(self): + # Drop type codec cache for all connections in the pool. + for ch in self._holders: + if ch._con is not None: + ch._con._drop_local_type_cache() + + def __await__(self): + return self._async__init__().__await__() + + async def __aenter__(self): + await self._async__init__() + return self + + async def __aexit__(self, *exc): + await self.close() + + +class PoolAcquireContext: + + __slots__ = ('timeout', 'connection', 'done', 'pool') + + def __init__(self, pool, timeout): + self.pool = pool + self.timeout = timeout + self.connection = None + self.done = False + + async def __aenter__(self): + if self.connection is not None or self.done: + raise exceptions.InterfaceError('a connection is already acquired') + self.connection = await self.pool._acquire(self.timeout) + return self.connection + + async def __aexit__(self, *exc): + self.done = True + con = self.connection + self.connection = None + await self.pool.release(con) + + def __await__(self): + self.done = True + return self.pool._acquire(self.timeout).__await__() + + +def create_pool(dsn=None, *, + min_size=10, + max_size=10, + max_queries=50000, + max_inactive_connection_lifetime=300.0, + setup=None, + init=None, + loop=None, + connection_class=connection.Connection, + record_class=protocol.Record, + **connect_kwargs): + r"""Create a connection pool. + + Can be used either with an ``async with`` block: + + .. code-block:: python + + async with asyncpg.create_pool(user='postgres', + command_timeout=60) as pool: + await pool.fetch('SELECT 1') + + Or to perform multiple operations on a single connection: + + .. code-block:: python + + async with asyncpg.create_pool(user='postgres', + command_timeout=60) as pool: + async with pool.acquire() as con: + await con.execute(''' + CREATE TABLE names ( + id serial PRIMARY KEY, + name VARCHAR (255) NOT NULL) + ''') + await con.fetch('SELECT 1') + + Or directly with ``await`` (not recommended): + + .. code-block:: python + + pool = await asyncpg.create_pool(user='postgres', command_timeout=60) + con = await pool.acquire() + try: + await con.fetch('SELECT 1') + finally: + await pool.release(con) + + .. warning:: + Prepared statements and cursors returned by + :meth:`Connection.prepare() ` + and :meth:`Connection.cursor() ` + become invalid once the connection is released. Likewise, all + notification and log listeners are removed, and ``asyncpg`` will + issue a warning if there are any listener callbacks registered on a + connection that is being released to the pool. + + :param str dsn: + Connection arguments specified using as a single string in + the following format: + ``postgres://user:pass@host:port/database?option=value``. + + :param \*\*connect_kwargs: + Keyword arguments for the :func:`~asyncpg.connection.connect` + function. + + :param Connection connection_class: + The class to use for connections. Must be a subclass of + :class:`~asyncpg.connection.Connection`. + + :param type record_class: + If specified, the class to use for records returned by queries on + the connections in this pool. Must be a subclass of + :class:`~asyncpg.Record`. + + :param int min_size: + Number of connection the pool will be initialized with. + + :param int max_size: + Max number of connections in the pool. + + :param int max_queries: + Number of queries after a connection is closed and replaced + with a new connection. + + :param float max_inactive_connection_lifetime: + Number of seconds after which inactive connections in the + pool will be closed. Pass ``0`` to disable this mechanism. + + :param coroutine setup: + A coroutine to prepare a connection right before it is returned + from :meth:`Pool.acquire() `. An example use + case would be to automatically set up notifications listeners for + all connections of a pool. + + :param coroutine init: + A coroutine to initialize a connection when it is created. + An example use case would be to setup type codecs with + :meth:`Connection.set_builtin_type_codec() <\ + asyncpg.connection.Connection.set_builtin_type_codec>` + or :meth:`Connection.set_type_codec() <\ + asyncpg.connection.Connection.set_type_codec>`. + + :param loop: + An asyncio event loop instance. If ``None``, the default + event loop will be used. + + :return: An instance of :class:`~asyncpg.pool.Pool`. + + .. versionchanged:: 0.10.0 + An :exc:`~asyncpg.exceptions.InterfaceError` will be raised on any + attempted operation on a released connection. + + .. versionchanged:: 0.13.0 + An :exc:`~asyncpg.exceptions.InterfaceError` will be raised on any + attempted operation on a prepared statement or a cursor created + on a connection that has been released to the pool. + + .. versionchanged:: 0.13.0 + An :exc:`~asyncpg.exceptions.InterfaceWarning` will be produced + if there are any active listeners (added via + :meth:`Connection.add_listener() + ` + or :meth:`Connection.add_log_listener() + `) present on the + connection at the moment of its release to the pool. + + .. versionchanged:: 0.22.0 + Added the *record_class* parameter. + """ + return Pool( + dsn, + connection_class=connection_class, + record_class=record_class, + min_size=min_size, max_size=max_size, + max_queries=max_queries, loop=loop, setup=setup, init=init, + max_inactive_connection_lifetime=max_inactive_connection_lifetime, + **connect_kwargs) diff --git a/env/Lib/site-packages/asyncpg/prepared_stmt.py b/env/Lib/site-packages/asyncpg/prepared_stmt.py new file mode 100644 index 0000000..8e241d6 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/prepared_stmt.py @@ -0,0 +1,259 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import json + +from . import connresource +from . import cursor +from . import exceptions + + +class PreparedStatement(connresource.ConnectionResource): + """A representation of a prepared statement.""" + + __slots__ = ('_state', '_query', '_last_status') + + def __init__(self, connection, query, state): + super().__init__(connection) + self._state = state + self._query = query + state.attach() + self._last_status = None + + @connresource.guarded + def get_name(self) -> str: + """Return the name of this prepared statement. + + .. versionadded:: 0.25.0 + """ + return self._state.name + + @connresource.guarded + def get_query(self) -> str: + """Return the text of the query for this prepared statement. + + Example:: + + stmt = await connection.prepare('SELECT $1::int') + assert stmt.get_query() == "SELECT $1::int" + """ + return self._query + + @connresource.guarded + def get_statusmsg(self) -> str: + """Return the status of the executed command. + + Example:: + + stmt = await connection.prepare('CREATE TABLE mytab (a int)') + await stmt.fetch() + assert stmt.get_statusmsg() == "CREATE TABLE" + """ + if self._last_status is None: + return self._last_status + return self._last_status.decode() + + @connresource.guarded + def get_parameters(self): + """Return a description of statement parameters types. + + :return: A tuple of :class:`asyncpg.types.Type`. + + Example:: + + stmt = await connection.prepare('SELECT ($1::int, $2::text)') + print(stmt.get_parameters()) + + # Will print: + # (Type(oid=23, name='int4', kind='scalar', schema='pg_catalog'), + # Type(oid=25, name='text', kind='scalar', schema='pg_catalog')) + """ + return self._state._get_parameters() + + @connresource.guarded + def get_attributes(self): + """Return a description of relation attributes (columns). + + :return: A tuple of :class:`asyncpg.types.Attribute`. + + Example:: + + st = await self.con.prepare(''' + SELECT typname, typnamespace FROM pg_type + ''') + print(st.get_attributes()) + + # Will print: + # (Attribute( + # name='typname', + # type=Type(oid=19, name='name', kind='scalar', + # schema='pg_catalog')), + # Attribute( + # name='typnamespace', + # type=Type(oid=26, name='oid', kind='scalar', + # schema='pg_catalog'))) + """ + return self._state._get_attributes() + + @connresource.guarded + def cursor(self, *args, prefetch=None, + timeout=None) -> cursor.CursorFactory: + """Return a *cursor factory* for the prepared statement. + + :param args: Query arguments. + :param int prefetch: The number of rows the *cursor iterator* + will prefetch (defaults to ``50``.) + :param float timeout: Optional timeout in seconds. + + :return: A :class:`~cursor.CursorFactory` object. + """ + return cursor.CursorFactory( + self._connection, + self._query, + self._state, + args, + prefetch, + timeout, + self._state.record_class, + ) + + @connresource.guarded + async def explain(self, *args, analyze=False): + """Return the execution plan of the statement. + + :param args: Query arguments. + :param analyze: If ``True``, the statement will be executed and + the run time statitics added to the return value. + + :return: An object representing the execution plan. This value + is actually a deserialized JSON output of the SQL + ``EXPLAIN`` command. + """ + query = 'EXPLAIN (FORMAT JSON, VERBOSE' + if analyze: + query += ', ANALYZE) ' + else: + query += ') ' + query += self._state.query + + if analyze: + # From PostgreSQL docs: + # Important: Keep in mind that the statement is actually + # executed when the ANALYZE option is used. Although EXPLAIN + # will discard any output that a SELECT would return, other + # side effects of the statement will happen as usual. If you + # wish to use EXPLAIN ANALYZE on an INSERT, UPDATE, DELETE, + # CREATE TABLE AS, or EXECUTE statement without letting the + # command affect your data, use this approach: + # BEGIN; + # EXPLAIN ANALYZE ...; + # ROLLBACK; + tr = self._connection.transaction() + await tr.start() + try: + data = await self._connection.fetchval(query, *args) + finally: + await tr.rollback() + else: + data = await self._connection.fetchval(query, *args) + + return json.loads(data) + + @connresource.guarded + async def fetch(self, *args, timeout=None): + r"""Execute the statement and return a list of :class:`Record` objects. + + :param str query: Query text + :param args: Query arguments + :param float timeout: Optional timeout value in seconds. + + :return: A list of :class:`Record` instances. + """ + data = await self.__bind_execute(args, 0, timeout) + return data + + @connresource.guarded + async def fetchval(self, *args, column=0, timeout=None): + """Execute the statement and return a value in the first row. + + :param args: Query arguments. + :param int column: Numeric index within the record of the value to + return (defaults to 0). + :param float timeout: Optional timeout value in seconds. + If not specified, defaults to the value of + ``command_timeout`` argument to the ``Connection`` + instance constructor. + + :return: The value of the specified column of the first record. + """ + data = await self.__bind_execute(args, 1, timeout) + if not data: + return None + return data[0][column] + + @connresource.guarded + async def fetchrow(self, *args, timeout=None): + """Execute the statement and return the first row. + + :param str query: Query text + :param args: Query arguments + :param float timeout: Optional timeout value in seconds. + + :return: The first row as a :class:`Record` instance. + """ + data = await self.__bind_execute(args, 1, timeout) + if not data: + return None + return data[0] + + @connresource.guarded + async def executemany(self, args, *, timeout: float=None): + """Execute the statement for each sequence of arguments in *args*. + + :param args: An iterable containing sequences of arguments. + :param float timeout: Optional timeout value in seconds. + :return None: This method discards the results of the operations. + + .. versionadded:: 0.22.0 + """ + return await self.__do_execute( + lambda protocol: protocol.bind_execute_many( + self._state, args, '', timeout)) + + async def __do_execute(self, executor): + protocol = self._connection._protocol + try: + return await executor(protocol) + except exceptions.OutdatedSchemaCacheError: + await self._connection.reload_schema_state() + # We can not find all manually created prepared statements, so just + # drop known cached ones in the `self._connection`. + # Other manually created prepared statements will fail and + # invalidate themselves (unfortunately, clearing caches again). + self._state.mark_closed() + raise + + async def __bind_execute(self, args, limit, timeout): + data, status, _ = await self.__do_execute( + lambda protocol: protocol.bind_execute( + self._state, args, '', limit, True, timeout)) + self._last_status = status + return data + + def _check_open(self, meth_name): + if self._state.closed: + raise exceptions.InterfaceError( + 'cannot call PreparedStmt.{}(): ' + 'the prepared statement is closed'.format(meth_name)) + + def _check_conn_validity(self, meth_name): + self._check_open(meth_name) + super()._check_conn_validity(meth_name) + + def __del__(self): + self._state.detach() + self._connection._maybe_gc_stmt(self._state) diff --git a/env/Lib/site-packages/asyncpg/protocol/__init__.py b/env/Lib/site-packages/asyncpg/protocol/__init__.py new file mode 100644 index 0000000..8b3e06a --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/__init__.py @@ -0,0 +1,9 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + +# flake8: NOQA + +from .protocol import Protocol, Record, NO_TIMEOUT, BUILTIN_TYPE_NAME_MAP diff --git a/env/Lib/site-packages/asyncpg/protocol/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/asyncpg/protocol/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..25174af0d9f3f271fac7e075930807b148f9e96d GIT binary patch literal 332 zcmZ3^%ge<81Y2jHNwZ{RV0aATzyK4J@mUVYn9h*GkiwY5kjogwn9CH!l*=5&oXZl$ z!pM-q6wIK>{1T{}L6hYcM?g`2Nq%yE&Mmf})a3l4lv`YW{_!E6zOMeEA-6=GLOp## zJpJNBA_H9G{TzK=<9!_i{4`l_aTGxH6)^)1Dq;ZJ}s>XD6no7RMwOSLP)br0c^> z*N>0S%*!l^kJl@x{Ka9Do1apelWJGQ4Ky9(fnp;d@qw9i6!|(@k#k5F{ycFF+Q0|F~ylBsk#M;$=QkNsl_pg#g%!<1?l<) zMfoN9$@w|@$@wX%$;JBd@tJv!Xl65R literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/asyncpg/protocol/codecs/array.pyx b/env/Lib/site-packages/asyncpg/protocol/codecs/array.pyx new file mode 100644 index 0000000..f8f9b8d --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/codecs/array.pyx @@ -0,0 +1,875 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +from collections.abc import (Iterable as IterableABC, + Mapping as MappingABC, + Sized as SizedABC) + +from asyncpg import exceptions + + +DEF ARRAY_MAXDIM = 6 # defined in postgresql/src/includes/c.h + +# "NULL" +cdef Py_UCS4 *APG_NULL = [0x004E, 0x0055, 0x004C, 0x004C, 0x0000] + + +ctypedef object (*encode_func_ex)(ConnectionSettings settings, + WriteBuffer buf, + object obj, + const void *arg) + + +ctypedef object (*decode_func_ex)(ConnectionSettings settings, + FRBuffer *buf, + const void *arg) + + +cdef inline bint _is_trivial_container(object obj): + return cpython.PyUnicode_Check(obj) or cpython.PyBytes_Check(obj) or \ + cpythonx.PyByteArray_Check(obj) or cpythonx.PyMemoryView_Check(obj) + + +cdef inline _is_array_iterable(object obj): + return ( + isinstance(obj, IterableABC) and + isinstance(obj, SizedABC) and + not _is_trivial_container(obj) and + not isinstance(obj, MappingABC) + ) + + +cdef inline _is_sub_array_iterable(object obj): + # Sub-arrays have a specialized check, because we treat + # nested tuples as records. + return _is_array_iterable(obj) and not cpython.PyTuple_Check(obj) + + +cdef _get_array_shape(object obj, int32_t *dims, int32_t *ndims): + cdef: + ssize_t mylen = len(obj) + ssize_t elemlen = -2 + object it + + if mylen > _MAXINT32: + raise ValueError('too many elements in array value') + + if ndims[0] > ARRAY_MAXDIM: + raise ValueError( + 'number of array dimensions ({}) exceed the maximum expected ({})'. + format(ndims[0], ARRAY_MAXDIM)) + + dims[ndims[0] - 1] = mylen + + for elem in obj: + if _is_sub_array_iterable(elem): + if elemlen == -2: + elemlen = len(elem) + if elemlen > _MAXINT32: + raise ValueError('too many elements in array value') + ndims[0] += 1 + _get_array_shape(elem, dims, ndims) + else: + if len(elem) != elemlen: + raise ValueError('non-homogeneous array') + else: + if elemlen >= 0: + raise ValueError('non-homogeneous array') + else: + elemlen = -1 + + +cdef _write_array_data(ConnectionSettings settings, object obj, int32_t ndims, + int32_t dim, WriteBuffer elem_data, + encode_func_ex encoder, const void *encoder_arg): + if dim < ndims - 1: + for item in obj: + _write_array_data(settings, item, ndims, dim + 1, elem_data, + encoder, encoder_arg) + else: + for item in obj: + if item is None: + elem_data.write_int32(-1) + else: + try: + encoder(settings, elem_data, item, encoder_arg) + except TypeError as e: + raise ValueError( + 'invalid array element: {}'.format(e.args[0])) from None + + +cdef inline array_encode(ConnectionSettings settings, WriteBuffer buf, + object obj, uint32_t elem_oid, + encode_func_ex encoder, const void *encoder_arg): + cdef: + WriteBuffer elem_data + int32_t dims[ARRAY_MAXDIM] + int32_t ndims = 1 + int32_t i + + if not _is_array_iterable(obj): + raise TypeError( + 'a sized iterable container expected (got type {!r})'.format( + type(obj).__name__)) + + _get_array_shape(obj, dims, &ndims) + + elem_data = WriteBuffer.new() + + if ndims > 1: + _write_array_data(settings, obj, ndims, 0, elem_data, + encoder, encoder_arg) + else: + for i, item in enumerate(obj): + if item is None: + elem_data.write_int32(-1) + else: + try: + encoder(settings, elem_data, item, encoder_arg) + except TypeError as e: + raise ValueError( + 'invalid array element at index {}: {}'.format( + i, e.args[0])) from None + + buf.write_int32(12 + 8 * ndims + elem_data.len()) + # Number of dimensions + buf.write_int32(ndims) + # flags + buf.write_int32(0) + # element type + buf.write_int32(elem_oid) + # upper / lower bounds + for i in range(ndims): + buf.write_int32(dims[i]) + buf.write_int32(1) + # element data + buf.write_buffer(elem_data) + + +cdef _write_textarray_data(ConnectionSettings settings, object obj, + int32_t ndims, int32_t dim, WriteBuffer array_data, + encode_func_ex encoder, const void *encoder_arg, + Py_UCS4 typdelim): + cdef: + ssize_t i = 0 + int8_t delim = typdelim + WriteBuffer elem_data + Py_buffer pybuf + const char *elem_str + char ch + ssize_t elem_len + ssize_t quoted_elem_len + bint need_quoting + + array_data.write_byte(b'{') + + if dim < ndims - 1: + for item in obj: + if i > 0: + array_data.write_byte(delim) + array_data.write_byte(b' ') + _write_textarray_data(settings, item, ndims, dim + 1, array_data, + encoder, encoder_arg, typdelim) + i += 1 + else: + for item in obj: + elem_data = WriteBuffer.new() + + if i > 0: + array_data.write_byte(delim) + array_data.write_byte(b' ') + + if item is None: + array_data.write_bytes(b'NULL') + i += 1 + continue + else: + try: + encoder(settings, elem_data, item, encoder_arg) + except TypeError as e: + raise ValueError( + 'invalid array element: {}'.format( + e.args[0])) from None + + # element string length (first four bytes are the encoded length.) + elem_len = elem_data.len() - 4 + + if elem_len == 0: + # Empty string + array_data.write_bytes(b'""') + else: + cpython.PyObject_GetBuffer( + elem_data, &pybuf, cpython.PyBUF_SIMPLE) + + elem_str = (pybuf.buf) + 4 + + try: + if not apg_strcasecmp_char(elem_str, b'NULL'): + array_data.write_byte(b'"') + array_data.write_cstr(elem_str, 4) + array_data.write_byte(b'"') + else: + quoted_elem_len = elem_len + need_quoting = False + + for i in range(elem_len): + ch = elem_str[i] + if ch == b'"' or ch == b'\\': + # Quotes and backslashes need escaping. + quoted_elem_len += 1 + need_quoting = True + elif (ch == b'{' or ch == b'}' or ch == delim or + apg_ascii_isspace(ch)): + need_quoting = True + + if need_quoting: + array_data.write_byte(b'"') + + if quoted_elem_len == elem_len: + array_data.write_cstr(elem_str, elem_len) + else: + # Escaping required. + for i in range(elem_len): + ch = elem_str[i] + if ch == b'"' or ch == b'\\': + array_data.write_byte(b'\\') + array_data.write_byte(ch) + + array_data.write_byte(b'"') + else: + array_data.write_cstr(elem_str, elem_len) + finally: + cpython.PyBuffer_Release(&pybuf) + + i += 1 + + array_data.write_byte(b'}') + + +cdef inline textarray_encode(ConnectionSettings settings, WriteBuffer buf, + object obj, encode_func_ex encoder, + const void *encoder_arg, Py_UCS4 typdelim): + cdef: + WriteBuffer array_data + int32_t dims[ARRAY_MAXDIM] + int32_t ndims = 1 + int32_t i + + if not _is_array_iterable(obj): + raise TypeError( + 'a sized iterable container expected (got type {!r})'.format( + type(obj).__name__)) + + _get_array_shape(obj, dims, &ndims) + + array_data = WriteBuffer.new() + _write_textarray_data(settings, obj, ndims, 0, array_data, + encoder, encoder_arg, typdelim) + buf.write_int32(array_data.len()) + buf.write_buffer(array_data) + + +cdef inline array_decode(ConnectionSettings settings, FRBuffer *buf, + decode_func_ex decoder, const void *decoder_arg): + cdef: + int32_t ndims = hton.unpack_int32(frb_read(buf, 4)) + int32_t flags = hton.unpack_int32(frb_read(buf, 4)) + uint32_t elem_oid = hton.unpack_int32(frb_read(buf, 4)) + list result + int i + int32_t elem_len + int32_t elem_count = 1 + FRBuffer elem_buf + int32_t dims[ARRAY_MAXDIM] + Codec elem_codec + + if ndims == 0: + return [] + + if ndims > ARRAY_MAXDIM: + raise exceptions.ProtocolError( + 'number of array dimensions ({}) exceed the maximum expected ({})'. + format(ndims, ARRAY_MAXDIM)) + elif ndims < 0: + raise exceptions.ProtocolError( + 'unexpected array dimensions value: {}'.format(ndims)) + + for i in range(ndims): + dims[i] = hton.unpack_int32(frb_read(buf, 4)) + if dims[i] < 0: + raise exceptions.ProtocolError( + 'unexpected array dimension size: {}'.format(dims[i])) + # Ignore the lower bound information + frb_read(buf, 4) + + if ndims == 1: + # Fast path for flat arrays + elem_count = dims[0] + result = cpython.PyList_New(elem_count) + + for i in range(elem_count): + elem_len = hton.unpack_int32(frb_read(buf, 4)) + if elem_len == -1: + elem = None + else: + frb_slice_from(&elem_buf, buf, elem_len) + elem = decoder(settings, &elem_buf, decoder_arg) + + cpython.Py_INCREF(elem) + cpython.PyList_SET_ITEM(result, i, elem) + + else: + result = _nested_array_decode(settings, buf, + decoder, decoder_arg, ndims, dims, + &elem_buf) + + return result + + +cdef _nested_array_decode(ConnectionSettings settings, + FRBuffer *buf, + decode_func_ex decoder, + const void *decoder_arg, + int32_t ndims, int32_t *dims, + FRBuffer *elem_buf): + + cdef: + int32_t elem_len + int64_t i, j + int64_t array_len = 1 + object elem, stride + # An array of pointers to lists for each current array level. + void *strides[ARRAY_MAXDIM] + # An array of current positions at each array level. + int32_t indexes[ARRAY_MAXDIM] + + for i in range(ndims): + array_len *= dims[i] + indexes[i] = 0 + strides[i] = NULL + + if array_len == 0: + # A multidimensional array with a zero-sized dimension? + return [] + + elif array_len < 0: + # Array length overflow + raise exceptions.ProtocolError('array length overflow') + + for i in range(array_len): + # Decode the element. + elem_len = hton.unpack_int32(frb_read(buf, 4)) + if elem_len == -1: + elem = None + else: + elem = decoder(settings, + frb_slice_from(elem_buf, buf, elem_len), + decoder_arg) + + # Take an explicit reference for PyList_SET_ITEM in the below + # loop expects this. + cpython.Py_INCREF(elem) + + # Iterate over array dimentions and put the element in + # the correctly nested sublist. + for j in reversed(range(ndims)): + if indexes[j] == 0: + # Allocate the list for this array level. + stride = cpython.PyList_New(dims[j]) + + strides[j] = stride + # Take an explicit reference for PyList_SET_ITEM below + # expects this. + cpython.Py_INCREF(stride) + + stride = strides[j] + cpython.PyList_SET_ITEM(stride, indexes[j], elem) + indexes[j] += 1 + + if indexes[j] == dims[j] and j != 0: + # This array level is full, continue the + # ascent in the dimensions so that this level + # sublist will be appened to the parent list. + elem = stride + # Reset the index, this will cause the + # new list to be allocated on the next + # iteration on this array axis. + indexes[j] = 0 + else: + break + + stride = strides[0] + # Since each element in strides has a refcount of 1, + # returning strides[0] will increment it to 2, so + # balance that. + cpython.Py_DECREF(stride) + return stride + + +cdef textarray_decode(ConnectionSettings settings, FRBuffer *buf, + decode_func_ex decoder, const void *decoder_arg, + Py_UCS4 typdelim): + cdef: + Py_UCS4 *array_text + str s + + # Make a copy of array data since we will be mutating it for + # the purposes of element decoding. + s = pgproto.text_decode(settings, buf) + array_text = cpythonx.PyUnicode_AsUCS4Copy(s) + + try: + return _textarray_decode( + settings, array_text, decoder, decoder_arg, typdelim) + except ValueError as e: + raise exceptions.ProtocolError( + 'malformed array literal {!r}: {}'.format(s, e.args[0])) + finally: + cpython.PyMem_Free(array_text) + + +cdef _textarray_decode(ConnectionSettings settings, + Py_UCS4 *array_text, + decode_func_ex decoder, + const void *decoder_arg, + Py_UCS4 typdelim): + + cdef: + bytearray array_bytes + list result + list new_stride + Py_UCS4 *ptr + int32_t ndims = 0 + int32_t ubound = 0 + int32_t lbound = 0 + int32_t dims[ARRAY_MAXDIM] + int32_t inferred_dims[ARRAY_MAXDIM] + int32_t inferred_ndims = 0 + void *strides[ARRAY_MAXDIM] + int32_t indexes[ARRAY_MAXDIM] + int32_t nest_level = 0 + int32_t item_level = 0 + bint end_of_array = False + + bint end_of_item = False + bint has_quoting = False + bint strip_spaces = False + bint in_quotes = False + Py_UCS4 *item_start + Py_UCS4 *item_ptr + Py_UCS4 *item_end + + int i + object item + str item_text + FRBuffer item_buf + char *pg_item_str + ssize_t pg_item_len + + ptr = array_text + + while True: + while apg_ascii_isspace(ptr[0]): + ptr += 1 + + if ptr[0] != '[': + # Finished parsing dimensions spec. + break + + ptr += 1 # '[' + + if ndims > ARRAY_MAXDIM: + raise ValueError( + 'number of array dimensions ({}) exceed the ' + 'maximum expected ({})'.format(ndims, ARRAY_MAXDIM)) + + ptr = apg_parse_int32(ptr, &ubound) + if ptr == NULL: + raise ValueError('missing array dimension value') + + if ptr[0] == ':': + ptr += 1 + lbound = ubound + + # [lower:upper] spec. We disregard the lbound for decoding. + ptr = apg_parse_int32(ptr, &ubound) + if ptr == NULL: + raise ValueError('missing array dimension value') + else: + lbound = 1 + + if ptr[0] != ']': + raise ValueError('missing \']\' after array dimensions') + + ptr += 1 # ']' + + dims[ndims] = ubound - lbound + 1 + ndims += 1 + + if ndims != 0: + # If dimensions were given, the '=' token is expected. + if ptr[0] != '=': + raise ValueError('missing \'=\' after array dimensions') + + ptr += 1 # '=' + + # Skip any whitespace after the '=', whitespace + # before was consumed in the above loop. + while apg_ascii_isspace(ptr[0]): + ptr += 1 + + # Infer the dimensions from the brace structure in the + # array literal body, and check that it matches the explicit + # spec. This also validates that the array literal is sane. + _infer_array_dims(ptr, typdelim, inferred_dims, &inferred_ndims) + + if inferred_ndims != ndims: + raise ValueError( + 'specified array dimensions do not match array content') + + for i in range(ndims): + if inferred_dims[i] != dims[i]: + raise ValueError( + 'specified array dimensions do not match array content') + else: + # Infer the dimensions from the brace structure in the array literal + # body. This also validates that the array literal is sane. + _infer_array_dims(ptr, typdelim, dims, &ndims) + + while not end_of_array: + # We iterate over the literal character by character + # and modify the string in-place removing the array-specific + # quoting and determining the boundaries of each element. + end_of_item = has_quoting = in_quotes = False + strip_spaces = True + + # Pointers to array element start, end, and the current pointer + # tracking the position where characters are written when + # escaping is folded. + item_start = item_end = item_ptr = ptr + item_level = 0 + + while not end_of_item: + if ptr[0] == '"': + in_quotes = not in_quotes + if in_quotes: + strip_spaces = False + else: + item_end = item_ptr + has_quoting = True + + elif ptr[0] == '\\': + # Quoted character, collapse the backslash. + ptr += 1 + has_quoting = True + item_ptr[0] = ptr[0] + item_ptr += 1 + strip_spaces = False + item_end = item_ptr + + elif in_quotes: + # Consume the string until we see the closing quote. + item_ptr[0] = ptr[0] + item_ptr += 1 + + elif ptr[0] == '{': + # Nesting level increase. + nest_level += 1 + + indexes[nest_level - 1] = 0 + new_stride = cpython.PyList_New(dims[nest_level - 1]) + strides[nest_level - 1] = \ + (new_stride) + + if nest_level > 1: + cpython.Py_INCREF(new_stride) + cpython.PyList_SET_ITEM( + strides[nest_level - 2], + indexes[nest_level - 2], + new_stride) + else: + result = new_stride + + elif ptr[0] == '}': + if item_level == 0: + # Make sure we keep track of which nesting + # level the item belongs to, as the loop + # will continue to consume closing braces + # until the delimiter or the end of input. + item_level = nest_level + + nest_level -= 1 + + if nest_level == 0: + end_of_array = end_of_item = True + + elif ptr[0] == typdelim: + # Array element delimiter, + end_of_item = True + if item_level == 0: + item_level = nest_level + + elif apg_ascii_isspace(ptr[0]): + if not strip_spaces: + item_ptr[0] = ptr[0] + item_ptr += 1 + # Ignore the leading literal whitespace. + + else: + item_ptr[0] = ptr[0] + item_ptr += 1 + strip_spaces = False + item_end = item_ptr + + ptr += 1 + + # end while not end_of_item + + if item_end == item_start: + # Empty array + continue + + item_end[0] = '\0' + + if not has_quoting and apg_strcasecmp(item_start, APG_NULL) == 0: + # NULL element. + item = None + else: + # XXX: find a way to avoid the redundant encode/decode + # cycle here. + item_text = cpythonx.PyUnicode_FromKindAndData( + cpythonx.PyUnicode_4BYTE_KIND, + item_start, + item_end - item_start) + + # Prepare the element buffer and call the text decoder + # for the element type. + pgproto.as_pg_string_and_size( + settings, item_text, &pg_item_str, &pg_item_len) + frb_init(&item_buf, pg_item_str, pg_item_len) + item = decoder(settings, &item_buf, decoder_arg) + + # Place the decoded element in the array. + cpython.Py_INCREF(item) + cpython.PyList_SET_ITEM( + strides[item_level - 1], + indexes[item_level - 1], + item) + + if nest_level > 0: + indexes[nest_level - 1] += 1 + + return result + + +cdef enum _ArrayParseState: + APS_START = 1 + APS_STRIDE_STARTED = 2 + APS_STRIDE_DONE = 3 + APS_STRIDE_DELIMITED = 4 + APS_ELEM_STARTED = 5 + APS_ELEM_DELIMITED = 6 + + +cdef _UnexpectedCharacter(const Py_UCS4 *array_text, const Py_UCS4 *ptr): + return ValueError('unexpected character {!r} at position {}'.format( + cpython.PyUnicode_FromOrdinal(ptr[0]), ptr - array_text + 1)) + + +cdef _infer_array_dims(const Py_UCS4 *array_text, + Py_UCS4 typdelim, + int32_t *dims, + int32_t *ndims): + cdef: + const Py_UCS4 *ptr = array_text + int i + int nest_level = 0 + bint end_of_array = False + bint end_of_item = False + bint in_quotes = False + bint array_is_empty = True + int stride_len[ARRAY_MAXDIM] + int prev_stride_len[ARRAY_MAXDIM] + _ArrayParseState parse_state = APS_START + + for i in range(ARRAY_MAXDIM): + dims[i] = prev_stride_len[i] = 0 + stride_len[i] = 1 + + while not end_of_array: + end_of_item = False + + while not end_of_item: + if ptr[0] == '\0': + raise ValueError('unexpected end of string') + + elif ptr[0] == '"': + if (parse_state not in (APS_STRIDE_STARTED, + APS_ELEM_DELIMITED) and + not (parse_state == APS_ELEM_STARTED and in_quotes)): + raise _UnexpectedCharacter(array_text, ptr) + + in_quotes = not in_quotes + if in_quotes: + parse_state = APS_ELEM_STARTED + array_is_empty = False + + elif ptr[0] == '\\': + if parse_state not in (APS_STRIDE_STARTED, + APS_ELEM_STARTED, + APS_ELEM_DELIMITED): + raise _UnexpectedCharacter(array_text, ptr) + + parse_state = APS_ELEM_STARTED + array_is_empty = False + + if ptr[1] != '\0': + ptr += 1 + else: + raise ValueError('unexpected end of string') + + elif in_quotes: + # Ignore everything inside the quotes. + pass + + elif ptr[0] == '{': + if parse_state not in (APS_START, + APS_STRIDE_STARTED, + APS_STRIDE_DELIMITED): + raise _UnexpectedCharacter(array_text, ptr) + + parse_state = APS_STRIDE_STARTED + if nest_level >= ARRAY_MAXDIM: + raise ValueError( + 'number of array dimensions ({}) exceed the ' + 'maximum expected ({})'.format( + nest_level, ARRAY_MAXDIM)) + + dims[nest_level] = 0 + nest_level += 1 + if ndims[0] < nest_level: + ndims[0] = nest_level + + elif ptr[0] == '}': + if (parse_state not in (APS_ELEM_STARTED, APS_STRIDE_DONE) and + not (nest_level == 1 and + parse_state == APS_STRIDE_STARTED)): + raise _UnexpectedCharacter(array_text, ptr) + + parse_state = APS_STRIDE_DONE + + if nest_level == 0: + raise _UnexpectedCharacter(array_text, ptr) + + nest_level -= 1 + + if (prev_stride_len[nest_level] != 0 and + stride_len[nest_level] != prev_stride_len[nest_level]): + raise ValueError( + 'inconsistent sub-array dimensions' + ' at position {}'.format( + ptr - array_text + 1)) + + prev_stride_len[nest_level] = stride_len[nest_level] + stride_len[nest_level] = 1 + if nest_level == 0: + end_of_array = end_of_item = True + else: + dims[nest_level - 1] += 1 + + elif ptr[0] == typdelim: + if parse_state not in (APS_ELEM_STARTED, APS_STRIDE_DONE): + raise _UnexpectedCharacter(array_text, ptr) + + if parse_state == APS_STRIDE_DONE: + parse_state = APS_STRIDE_DELIMITED + else: + parse_state = APS_ELEM_DELIMITED + end_of_item = True + stride_len[nest_level - 1] += 1 + + elif not apg_ascii_isspace(ptr[0]): + if parse_state not in (APS_STRIDE_STARTED, + APS_ELEM_STARTED, + APS_ELEM_DELIMITED): + raise _UnexpectedCharacter(array_text, ptr) + + parse_state = APS_ELEM_STARTED + array_is_empty = False + + if not end_of_item: + ptr += 1 + + if not array_is_empty: + dims[ndims[0] - 1] += 1 + + ptr += 1 + + # only whitespace is allowed after the closing brace + while ptr[0] != '\0': + if not apg_ascii_isspace(ptr[0]): + raise _UnexpectedCharacter(array_text, ptr) + + ptr += 1 + + if array_is_empty: + ndims[0] = 0 + + +cdef uint4_encode_ex(ConnectionSettings settings, WriteBuffer buf, object obj, + const void *arg): + return pgproto.uint4_encode(settings, buf, obj) + + +cdef uint4_decode_ex(ConnectionSettings settings, FRBuffer *buf, + const void *arg): + return pgproto.uint4_decode(settings, buf) + + +cdef arrayoid_encode(ConnectionSettings settings, WriteBuffer buf, items): + array_encode(settings, buf, items, OIDOID, + &uint4_encode_ex, NULL) + + +cdef arrayoid_decode(ConnectionSettings settings, FRBuffer *buf): + return array_decode(settings, buf, &uint4_decode_ex, NULL) + + +cdef text_encode_ex(ConnectionSettings settings, WriteBuffer buf, object obj, + const void *arg): + return pgproto.text_encode(settings, buf, obj) + + +cdef text_decode_ex(ConnectionSettings settings, FRBuffer *buf, + const void *arg): + return pgproto.text_decode(settings, buf) + + +cdef arraytext_encode(ConnectionSettings settings, WriteBuffer buf, items): + array_encode(settings, buf, items, TEXTOID, + &text_encode_ex, NULL) + + +cdef arraytext_decode(ConnectionSettings settings, FRBuffer *buf): + return array_decode(settings, buf, &text_decode_ex, NULL) + + +cdef init_array_codecs(): + # oid[] and text[] are registered as core codecs + # to make type introspection query work + # + register_core_codec(_OIDOID, + &arrayoid_encode, + &arrayoid_decode, + PG_FORMAT_BINARY) + + register_core_codec(_TEXTOID, + &arraytext_encode, + &arraytext_decode, + PG_FORMAT_BINARY) + +init_array_codecs() diff --git a/env/Lib/site-packages/asyncpg/protocol/codecs/base.pxd b/env/Lib/site-packages/asyncpg/protocol/codecs/base.pxd new file mode 100644 index 0000000..1cfed83 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/codecs/base.pxd @@ -0,0 +1,187 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +ctypedef object (*encode_func)(ConnectionSettings settings, + WriteBuffer buf, + object obj) + +ctypedef object (*decode_func)(ConnectionSettings settings, + FRBuffer *buf) + +ctypedef object (*codec_encode_func)(Codec codec, + ConnectionSettings settings, + WriteBuffer buf, + object obj) + +ctypedef object (*codec_decode_func)(Codec codec, + ConnectionSettings settings, + FRBuffer *buf) + + +cdef enum CodecType: + CODEC_UNDEFINED = 0 + CODEC_C = 1 + CODEC_PY = 2 + CODEC_ARRAY = 3 + CODEC_COMPOSITE = 4 + CODEC_RANGE = 5 + CODEC_MULTIRANGE = 6 + + +cdef enum ServerDataFormat: + PG_FORMAT_ANY = -1 + PG_FORMAT_TEXT = 0 + PG_FORMAT_BINARY = 1 + + +cdef enum ClientExchangeFormat: + PG_XFORMAT_OBJECT = 1 + PG_XFORMAT_TUPLE = 2 + + +cdef class Codec: + cdef: + uint32_t oid + + str name + str schema + str kind + + CodecType type + ServerDataFormat format + ClientExchangeFormat xformat + + encode_func c_encoder + decode_func c_decoder + Codec base_codec + + object py_encoder + object py_decoder + + # arrays + Codec element_codec + Py_UCS4 element_delimiter + + # composite types + tuple element_type_oids + object element_names + object record_desc + list element_codecs + + # Pointers to actual encoder/decoder functions for this codec + codec_encode_func encoder + codec_decode_func decoder + + cdef init(self, str name, str schema, str kind, + CodecType type, ServerDataFormat format, + ClientExchangeFormat xformat, + encode_func c_encoder, decode_func c_decoder, + Codec base_codec, + object py_encoder, object py_decoder, + Codec element_codec, tuple element_type_oids, + object element_names, list element_codecs, + Py_UCS4 element_delimiter) + + cdef encode_scalar(self, ConnectionSettings settings, WriteBuffer buf, + object obj) + + cdef encode_array(self, ConnectionSettings settings, WriteBuffer buf, + object obj) + + cdef encode_array_text(self, ConnectionSettings settings, WriteBuffer buf, + object obj) + + cdef encode_range(self, ConnectionSettings settings, WriteBuffer buf, + object obj) + + cdef encode_multirange(self, ConnectionSettings settings, WriteBuffer buf, + object obj) + + cdef encode_composite(self, ConnectionSettings settings, WriteBuffer buf, + object obj) + + cdef encode_in_python(self, ConnectionSettings settings, WriteBuffer buf, + object obj) + + cdef decode_scalar(self, ConnectionSettings settings, FRBuffer *buf) + + cdef decode_array(self, ConnectionSettings settings, FRBuffer *buf) + + cdef decode_array_text(self, ConnectionSettings settings, FRBuffer *buf) + + cdef decode_range(self, ConnectionSettings settings, FRBuffer *buf) + + cdef decode_multirange(self, ConnectionSettings settings, FRBuffer *buf) + + cdef decode_composite(self, ConnectionSettings settings, FRBuffer *buf) + + cdef decode_in_python(self, ConnectionSettings settings, FRBuffer *buf) + + cdef inline encode(self, + ConnectionSettings settings, + WriteBuffer buf, + object obj) + + cdef inline decode(self, ConnectionSettings settings, FRBuffer *buf) + + cdef has_encoder(self) + cdef has_decoder(self) + cdef is_binary(self) + + cdef inline Codec copy(self) + + @staticmethod + cdef Codec new_array_codec(uint32_t oid, + str name, + str schema, + Codec element_codec, + Py_UCS4 element_delimiter) + + @staticmethod + cdef Codec new_range_codec(uint32_t oid, + str name, + str schema, + Codec element_codec) + + @staticmethod + cdef Codec new_multirange_codec(uint32_t oid, + str name, + str schema, + Codec element_codec) + + @staticmethod + cdef Codec new_composite_codec(uint32_t oid, + str name, + str schema, + ServerDataFormat format, + list element_codecs, + tuple element_type_oids, + object element_names) + + @staticmethod + cdef Codec new_python_codec(uint32_t oid, + str name, + str schema, + str kind, + object encoder, + object decoder, + encode_func c_encoder, + decode_func c_decoder, + Codec base_codec, + ServerDataFormat format, + ClientExchangeFormat xformat) + + +cdef class DataCodecConfig: + cdef: + dict _derived_type_codecs + dict _custom_type_codecs + + cdef inline Codec get_codec(self, uint32_t oid, ServerDataFormat format, + bint ignore_custom_codec=*) + cdef inline Codec get_custom_codec(self, uint32_t oid, + ServerDataFormat format) diff --git a/env/Lib/site-packages/asyncpg/protocol/codecs/base.pyx b/env/Lib/site-packages/asyncpg/protocol/codecs/base.pyx new file mode 100644 index 0000000..c269e37 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/codecs/base.pyx @@ -0,0 +1,895 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +from collections.abc import Mapping as MappingABC + +import asyncpg +from asyncpg import exceptions + + +cdef void* binary_codec_map[(MAXSUPPORTEDOID + 1) * 2] +cdef void* text_codec_map[(MAXSUPPORTEDOID + 1) * 2] +cdef dict EXTRA_CODECS = {} + + +@cython.final +cdef class Codec: + + def __cinit__(self, uint32_t oid): + self.oid = oid + self.type = CODEC_UNDEFINED + + cdef init( + self, + str name, + str schema, + str kind, + CodecType type, + ServerDataFormat format, + ClientExchangeFormat xformat, + encode_func c_encoder, + decode_func c_decoder, + Codec base_codec, + object py_encoder, + object py_decoder, + Codec element_codec, + tuple element_type_oids, + object element_names, + list element_codecs, + Py_UCS4 element_delimiter, + ): + + self.name = name + self.schema = schema + self.kind = kind + self.type = type + self.format = format + self.xformat = xformat + self.c_encoder = c_encoder + self.c_decoder = c_decoder + self.base_codec = base_codec + self.py_encoder = py_encoder + self.py_decoder = py_decoder + self.element_codec = element_codec + self.element_type_oids = element_type_oids + self.element_codecs = element_codecs + self.element_delimiter = element_delimiter + self.element_names = element_names + + if base_codec is not None: + if c_encoder != NULL or c_decoder != NULL: + raise exceptions.InternalClientError( + 'base_codec is mutually exclusive with c_encoder/c_decoder' + ) + + if element_names is not None: + self.record_desc = record.ApgRecordDesc_New( + element_names, tuple(element_names)) + else: + self.record_desc = None + + if type == CODEC_C: + self.encoder = &self.encode_scalar + self.decoder = &self.decode_scalar + elif type == CODEC_ARRAY: + if format == PG_FORMAT_BINARY: + self.encoder = &self.encode_array + self.decoder = &self.decode_array + else: + self.encoder = &self.encode_array_text + self.decoder = &self.decode_array_text + elif type == CODEC_RANGE: + if format != PG_FORMAT_BINARY: + raise exceptions.UnsupportedClientFeatureError( + 'cannot decode type "{}"."{}": text encoding of ' + 'range types is not supported'.format(schema, name)) + self.encoder = &self.encode_range + self.decoder = &self.decode_range + elif type == CODEC_MULTIRANGE: + if format != PG_FORMAT_BINARY: + raise exceptions.UnsupportedClientFeatureError( + 'cannot decode type "{}"."{}": text encoding of ' + 'range types is not supported'.format(schema, name)) + self.encoder = &self.encode_multirange + self.decoder = &self.decode_multirange + elif type == CODEC_COMPOSITE: + if format != PG_FORMAT_BINARY: + raise exceptions.UnsupportedClientFeatureError( + 'cannot decode type "{}"."{}": text encoding of ' + 'composite types is not supported'.format(schema, name)) + self.encoder = &self.encode_composite + self.decoder = &self.decode_composite + elif type == CODEC_PY: + self.encoder = &self.encode_in_python + self.decoder = &self.decode_in_python + else: + raise exceptions.InternalClientError( + 'unexpected codec type: {}'.format(type)) + + cdef Codec copy(self): + cdef Codec codec + + codec = Codec(self.oid) + codec.init(self.name, self.schema, self.kind, + self.type, self.format, self.xformat, + self.c_encoder, self.c_decoder, self.base_codec, + self.py_encoder, self.py_decoder, + self.element_codec, + self.element_type_oids, self.element_names, + self.element_codecs, self.element_delimiter) + + return codec + + cdef encode_scalar(self, ConnectionSettings settings, WriteBuffer buf, + object obj): + self.c_encoder(settings, buf, obj) + + cdef encode_array(self, ConnectionSettings settings, WriteBuffer buf, + object obj): + array_encode(settings, buf, obj, self.element_codec.oid, + codec_encode_func_ex, + (self.element_codec)) + + cdef encode_array_text(self, ConnectionSettings settings, WriteBuffer buf, + object obj): + return textarray_encode(settings, buf, obj, + codec_encode_func_ex, + (self.element_codec), + self.element_delimiter) + + cdef encode_range(self, ConnectionSettings settings, WriteBuffer buf, + object obj): + range_encode(settings, buf, obj, self.element_codec.oid, + codec_encode_func_ex, + (self.element_codec)) + + cdef encode_multirange(self, ConnectionSettings settings, WriteBuffer buf, + object obj): + multirange_encode(settings, buf, obj, self.element_codec.oid, + codec_encode_func_ex, + (self.element_codec)) + + cdef encode_composite(self, ConnectionSettings settings, WriteBuffer buf, + object obj): + cdef: + WriteBuffer elem_data + int i + list elem_codecs = self.element_codecs + ssize_t count + ssize_t composite_size + tuple rec + + if isinstance(obj, MappingABC): + # Input is dict-like, form a tuple + composite_size = len(self.element_type_oids) + rec = cpython.PyTuple_New(composite_size) + + for i in range(composite_size): + cpython.Py_INCREF(None) + cpython.PyTuple_SET_ITEM(rec, i, None) + + for field in obj: + try: + i = self.element_names[field] + except KeyError: + raise ValueError( + '{!r} is not a valid element of composite ' + 'type {}'.format(field, self.name)) from None + + item = obj[field] + cpython.Py_INCREF(item) + cpython.PyTuple_SET_ITEM(rec, i, item) + + obj = rec + + count = len(obj) + if count > _MAXINT32: + raise ValueError('too many elements in composite type record') + + elem_data = WriteBuffer.new() + i = 0 + for item in obj: + elem_data.write_int32(self.element_type_oids[i]) + if item is None: + elem_data.write_int32(-1) + else: + (elem_codecs[i]).encode(settings, elem_data, item) + i += 1 + + record_encode_frame(settings, buf, elem_data, count) + + cdef encode_in_python(self, ConnectionSettings settings, WriteBuffer buf, + object obj): + data = self.py_encoder(obj) + if self.xformat == PG_XFORMAT_OBJECT: + if self.format == PG_FORMAT_BINARY: + pgproto.bytea_encode(settings, buf, data) + elif self.format == PG_FORMAT_TEXT: + pgproto.text_encode(settings, buf, data) + else: + raise exceptions.InternalClientError( + 'unexpected data format: {}'.format(self.format)) + elif self.xformat == PG_XFORMAT_TUPLE: + if self.base_codec is not None: + self.base_codec.encode(settings, buf, data) + else: + self.c_encoder(settings, buf, data) + else: + raise exceptions.InternalClientError( + 'unexpected exchange format: {}'.format(self.xformat)) + + cdef encode(self, ConnectionSettings settings, WriteBuffer buf, + object obj): + return self.encoder(self, settings, buf, obj) + + cdef decode_scalar(self, ConnectionSettings settings, FRBuffer *buf): + return self.c_decoder(settings, buf) + + cdef decode_array(self, ConnectionSettings settings, FRBuffer *buf): + return array_decode(settings, buf, codec_decode_func_ex, + (self.element_codec)) + + cdef decode_array_text(self, ConnectionSettings settings, + FRBuffer *buf): + return textarray_decode(settings, buf, codec_decode_func_ex, + (self.element_codec), + self.element_delimiter) + + cdef decode_range(self, ConnectionSettings settings, FRBuffer *buf): + return range_decode(settings, buf, codec_decode_func_ex, + (self.element_codec)) + + cdef decode_multirange(self, ConnectionSettings settings, FRBuffer *buf): + return multirange_decode(settings, buf, codec_decode_func_ex, + (self.element_codec)) + + cdef decode_composite(self, ConnectionSettings settings, + FRBuffer *buf): + cdef: + object result + ssize_t elem_count + ssize_t i + int32_t elem_len + uint32_t elem_typ + uint32_t received_elem_typ + Codec elem_codec + FRBuffer elem_buf + + elem_count = hton.unpack_int32(frb_read(buf, 4)) + if elem_count != len(self.element_type_oids): + raise exceptions.OutdatedSchemaCacheError( + 'unexpected number of attributes of composite type: ' + '{}, expected {}' + .format( + elem_count, + len(self.element_type_oids), + ), + schema=self.schema, + data_type=self.name, + ) + result = record.ApgRecord_New(asyncpg.Record, self.record_desc, elem_count) + for i in range(elem_count): + elem_typ = self.element_type_oids[i] + received_elem_typ = hton.unpack_int32(frb_read(buf, 4)) + + if received_elem_typ != elem_typ: + raise exceptions.OutdatedSchemaCacheError( + 'unexpected data type of composite type attribute {}: ' + '{!r}, expected {!r}' + .format( + i, + BUILTIN_TYPE_OID_MAP.get( + received_elem_typ, received_elem_typ), + BUILTIN_TYPE_OID_MAP.get( + elem_typ, elem_typ) + ), + schema=self.schema, + data_type=self.name, + position=i, + ) + + elem_len = hton.unpack_int32(frb_read(buf, 4)) + if elem_len == -1: + elem = None + else: + elem_codec = self.element_codecs[i] + elem = elem_codec.decode( + settings, frb_slice_from(&elem_buf, buf, elem_len)) + + cpython.Py_INCREF(elem) + record.ApgRecord_SET_ITEM(result, i, elem) + + return result + + cdef decode_in_python(self, ConnectionSettings settings, + FRBuffer *buf): + if self.xformat == PG_XFORMAT_OBJECT: + if self.format == PG_FORMAT_BINARY: + data = pgproto.bytea_decode(settings, buf) + elif self.format == PG_FORMAT_TEXT: + data = pgproto.text_decode(settings, buf) + else: + raise exceptions.InternalClientError( + 'unexpected data format: {}'.format(self.format)) + elif self.xformat == PG_XFORMAT_TUPLE: + if self.base_codec is not None: + data = self.base_codec.decode(settings, buf) + else: + data = self.c_decoder(settings, buf) + else: + raise exceptions.InternalClientError( + 'unexpected exchange format: {}'.format(self.xformat)) + + return self.py_decoder(data) + + cdef inline decode(self, ConnectionSettings settings, FRBuffer *buf): + return self.decoder(self, settings, buf) + + cdef inline has_encoder(self): + cdef Codec elem_codec + + if self.c_encoder is not NULL or self.py_encoder is not None: + return True + + elif ( + self.type == CODEC_ARRAY + or self.type == CODEC_RANGE + or self.type == CODEC_MULTIRANGE + ): + return self.element_codec.has_encoder() + + elif self.type == CODEC_COMPOSITE: + for elem_codec in self.element_codecs: + if not elem_codec.has_encoder(): + return False + return True + + else: + return False + + cdef has_decoder(self): + cdef Codec elem_codec + + if self.c_decoder is not NULL or self.py_decoder is not None: + return True + + elif ( + self.type == CODEC_ARRAY + or self.type == CODEC_RANGE + or self.type == CODEC_MULTIRANGE + ): + return self.element_codec.has_decoder() + + elif self.type == CODEC_COMPOSITE: + for elem_codec in self.element_codecs: + if not elem_codec.has_decoder(): + return False + return True + + else: + return False + + cdef is_binary(self): + return self.format == PG_FORMAT_BINARY + + def __repr__(self): + return ''.format( + self.oid, + 'NA' if self.element_codec is None else self.element_codec.oid, + has_core_codec(self.oid)) + + @staticmethod + cdef Codec new_array_codec(uint32_t oid, + str name, + str schema, + Codec element_codec, + Py_UCS4 element_delimiter): + cdef Codec codec + codec = Codec(oid) + codec.init(name, schema, 'array', CODEC_ARRAY, element_codec.format, + PG_XFORMAT_OBJECT, NULL, NULL, None, None, None, + element_codec, None, None, None, element_delimiter) + return codec + + @staticmethod + cdef Codec new_range_codec(uint32_t oid, + str name, + str schema, + Codec element_codec): + cdef Codec codec + codec = Codec(oid) + codec.init(name, schema, 'range', CODEC_RANGE, element_codec.format, + PG_XFORMAT_OBJECT, NULL, NULL, None, None, None, + element_codec, None, None, None, 0) + return codec + + @staticmethod + cdef Codec new_multirange_codec(uint32_t oid, + str name, + str schema, + Codec element_codec): + cdef Codec codec + codec = Codec(oid) + codec.init(name, schema, 'multirange', CODEC_MULTIRANGE, + element_codec.format, PG_XFORMAT_OBJECT, NULL, NULL, None, + None, None, element_codec, None, None, None, 0) + return codec + + @staticmethod + cdef Codec new_composite_codec(uint32_t oid, + str name, + str schema, + ServerDataFormat format, + list element_codecs, + tuple element_type_oids, + object element_names): + cdef Codec codec + codec = Codec(oid) + codec.init(name, schema, 'composite', CODEC_COMPOSITE, + format, PG_XFORMAT_OBJECT, NULL, NULL, None, None, None, + None, element_type_oids, element_names, element_codecs, 0) + return codec + + @staticmethod + cdef Codec new_python_codec(uint32_t oid, + str name, + str schema, + str kind, + object encoder, + object decoder, + encode_func c_encoder, + decode_func c_decoder, + Codec base_codec, + ServerDataFormat format, + ClientExchangeFormat xformat): + cdef Codec codec + codec = Codec(oid) + codec.init(name, schema, kind, CODEC_PY, format, xformat, + c_encoder, c_decoder, base_codec, encoder, decoder, + None, None, None, None, 0) + return codec + + +# Encode callback for arrays +cdef codec_encode_func_ex(ConnectionSettings settings, WriteBuffer buf, + object obj, const void *arg): + return (arg).encode(settings, buf, obj) + + +# Decode callback for arrays +cdef codec_decode_func_ex(ConnectionSettings settings, FRBuffer *buf, + const void *arg): + return (arg).decode(settings, buf) + + +cdef uint32_t pylong_as_oid(val) except? 0xFFFFFFFFl: + cdef: + int64_t oid = 0 + bint overflow = False + + try: + oid = cpython.PyLong_AsLongLong(val) + except OverflowError: + overflow = True + + if overflow or (oid < 0 or oid > UINT32_MAX): + raise OverflowError('OID value too large: {!r}'.format(val)) + + return val + + +cdef class DataCodecConfig: + def __init__(self, cache_key): + # Codec instance cache for derived types: + # composites, arrays, ranges, domains and their combinations. + self._derived_type_codecs = {} + # Codec instances set up by the user for the connection. + self._custom_type_codecs = {} + + def add_types(self, types): + cdef: + Codec elem_codec + list comp_elem_codecs + ServerDataFormat format + ServerDataFormat elem_format + bint has_text_elements + Py_UCS4 elem_delim + + for ti in types: + oid = ti['oid'] + + if self.get_codec(oid, PG_FORMAT_ANY) is not None: + continue + + name = ti['name'] + schema = ti['ns'] + array_element_oid = ti['elemtype'] + range_subtype_oid = ti['range_subtype'] + if ti['attrtypoids']: + comp_type_attrs = tuple(ti['attrtypoids']) + else: + comp_type_attrs = None + base_type = ti['basetype'] + + if array_element_oid: + # Array type (note, there is no separate 'kind' for arrays) + + # Canonicalize type name to "elemtype[]" + if name.startswith('_'): + name = name[1:] + name = '{}[]'.format(name) + + elem_codec = self.get_codec(array_element_oid, PG_FORMAT_ANY) + if elem_codec is None: + elem_codec = self.declare_fallback_codec( + array_element_oid, ti['elemtype_name'], schema) + + elem_delim = ti['elemdelim'][0] + + self._derived_type_codecs[oid, elem_codec.format] = \ + Codec.new_array_codec( + oid, name, schema, elem_codec, elem_delim) + + elif ti['kind'] == b'c': + # Composite type + + if not comp_type_attrs: + raise exceptions.InternalClientError( + f'type record missing field types for composite {oid}') + + comp_elem_codecs = [] + has_text_elements = False + + for typoid in comp_type_attrs: + elem_codec = self.get_codec(typoid, PG_FORMAT_ANY) + if elem_codec is None: + raise exceptions.InternalClientError( + f'no codec for composite attribute type {typoid}') + if elem_codec.format is PG_FORMAT_TEXT: + has_text_elements = True + comp_elem_codecs.append(elem_codec) + + element_names = collections.OrderedDict() + for i, attrname in enumerate(ti['attrnames']): + element_names[attrname] = i + + # If at least one element is text-encoded, we must + # encode the whole composite as text. + if has_text_elements: + elem_format = PG_FORMAT_TEXT + else: + elem_format = PG_FORMAT_BINARY + + self._derived_type_codecs[oid, elem_format] = \ + Codec.new_composite_codec( + oid, name, schema, elem_format, comp_elem_codecs, + comp_type_attrs, element_names) + + elif ti['kind'] == b'd': + # Domain type + + if not base_type: + raise exceptions.InternalClientError( + f'type record missing base type for domain {oid}') + + elem_codec = self.get_codec(base_type, PG_FORMAT_ANY) + if elem_codec is None: + elem_codec = self.declare_fallback_codec( + base_type, ti['basetype_name'], schema) + + self._derived_type_codecs[oid, elem_codec.format] = elem_codec + + elif ti['kind'] == b'r': + # Range type + + if not range_subtype_oid: + raise exceptions.InternalClientError( + f'type record missing base type for range {oid}') + + elem_codec = self.get_codec(range_subtype_oid, PG_FORMAT_ANY) + if elem_codec is None: + elem_codec = self.declare_fallback_codec( + range_subtype_oid, ti['range_subtype_name'], schema) + + self._derived_type_codecs[oid, elem_codec.format] = \ + Codec.new_range_codec(oid, name, schema, elem_codec) + + elif ti['kind'] == b'm': + # Multirange type + + if not range_subtype_oid: + raise exceptions.InternalClientError( + f'type record missing base type for multirange {oid}') + + elem_codec = self.get_codec(range_subtype_oid, PG_FORMAT_ANY) + if elem_codec is None: + elem_codec = self.declare_fallback_codec( + range_subtype_oid, ti['range_subtype_name'], schema) + + self._derived_type_codecs[oid, elem_codec.format] = \ + Codec.new_multirange_codec(oid, name, schema, elem_codec) + + elif ti['kind'] == b'e': + # Enum types are essentially text + self._set_builtin_type_codec(oid, name, schema, 'scalar', + TEXTOID, PG_FORMAT_ANY) + else: + self.declare_fallback_codec(oid, name, schema) + + def add_python_codec(self, typeoid, typename, typeschema, typekind, + typeinfos, encoder, decoder, format, xformat): + cdef: + Codec core_codec = None + encode_func c_encoder = NULL + decode_func c_decoder = NULL + Codec base_codec = None + uint32_t oid = pylong_as_oid(typeoid) + bint codec_set = False + + # Clear all previous overrides (this also clears type cache). + self.remove_python_codec(typeoid, typename, typeschema) + + if typeinfos: + self.add_types(typeinfos) + + if format == PG_FORMAT_ANY: + formats = (PG_FORMAT_TEXT, PG_FORMAT_BINARY) + else: + formats = (format,) + + for fmt in formats: + if xformat == PG_XFORMAT_TUPLE: + if typekind == "scalar": + core_codec = get_core_codec(oid, fmt, xformat) + if core_codec is None: + continue + c_encoder = core_codec.c_encoder + c_decoder = core_codec.c_decoder + elif typekind == "composite": + base_codec = self.get_codec(oid, fmt) + if base_codec is None: + continue + + self._custom_type_codecs[typeoid, fmt] = \ + Codec.new_python_codec(oid, typename, typeschema, typekind, + encoder, decoder, c_encoder, c_decoder, + base_codec, fmt, xformat) + codec_set = True + + if not codec_set: + raise exceptions.InterfaceError( + "{} type does not support the 'tuple' exchange format".format( + typename)) + + def remove_python_codec(self, typeoid, typename, typeschema): + for fmt in (PG_FORMAT_BINARY, PG_FORMAT_TEXT): + self._custom_type_codecs.pop((typeoid, fmt), None) + self.clear_type_cache() + + def _set_builtin_type_codec(self, typeoid, typename, typeschema, typekind, + alias_to, format=PG_FORMAT_ANY): + cdef: + Codec codec + Codec target_codec + uint32_t oid = pylong_as_oid(typeoid) + uint32_t alias_oid = 0 + bint codec_set = False + + if format == PG_FORMAT_ANY: + formats = (PG_FORMAT_BINARY, PG_FORMAT_TEXT) + else: + formats = (format,) + + if isinstance(alias_to, int): + alias_oid = pylong_as_oid(alias_to) + else: + alias_oid = BUILTIN_TYPE_NAME_MAP.get(alias_to, 0) + + for format in formats: + if alias_oid != 0: + target_codec = self.get_codec(alias_oid, format) + else: + target_codec = get_extra_codec(alias_to, format) + + if target_codec is None: + continue + + codec = target_codec.copy() + codec.oid = typeoid + codec.name = typename + codec.schema = typeschema + codec.kind = typekind + + self._custom_type_codecs[typeoid, format] = codec + codec_set = True + + if not codec_set: + if format == PG_FORMAT_BINARY: + codec_str = 'binary' + elif format == PG_FORMAT_TEXT: + codec_str = 'text' + else: + codec_str = 'text or binary' + + raise exceptions.InterfaceError( + f'cannot alias {typename} to {alias_to}: ' + f'there is no {codec_str} codec for {alias_to}') + + def set_builtin_type_codec(self, typeoid, typename, typeschema, typekind, + alias_to, format=PG_FORMAT_ANY): + self._set_builtin_type_codec(typeoid, typename, typeschema, typekind, + alias_to, format) + self.clear_type_cache() + + def clear_type_cache(self): + self._derived_type_codecs.clear() + + def declare_fallback_codec(self, uint32_t oid, str name, str schema): + cdef Codec codec + + if oid <= MAXBUILTINOID: + # This is a BKI type, for which asyncpg has no + # defined codec. This should only happen for newly + # added builtin types, for which this version of + # asyncpg is lacking support. + # + raise exceptions.UnsupportedClientFeatureError( + f'unhandled standard data type {name!r} (OID {oid})') + else: + # This is a non-BKI type, and as such, has no + # stable OID, so no possibility of a builtin codec. + # In this case, fallback to text format. Applications + # can avoid this by specifying a codec for this type + # using Connection.set_type_codec(). + # + self._set_builtin_type_codec(oid, name, schema, 'scalar', + TEXTOID, PG_FORMAT_TEXT) + + codec = self.get_codec(oid, PG_FORMAT_TEXT) + + return codec + + cdef inline Codec get_codec(self, uint32_t oid, ServerDataFormat format, + bint ignore_custom_codec=False): + cdef Codec codec + + if format == PG_FORMAT_ANY: + codec = self.get_codec( + oid, PG_FORMAT_BINARY, ignore_custom_codec) + if codec is None: + codec = self.get_codec( + oid, PG_FORMAT_TEXT, ignore_custom_codec) + return codec + else: + if not ignore_custom_codec: + codec = self.get_custom_codec(oid, PG_FORMAT_ANY) + if codec is not None: + if codec.format != format: + # The codec for this OID has been overridden by + # set_{builtin}_type_codec with a different format. + # We must respect that and not return a core codec. + return None + else: + return codec + + codec = get_core_codec(oid, format) + if codec is not None: + return codec + else: + try: + return self._derived_type_codecs[oid, format] + except KeyError: + return None + + cdef inline Codec get_custom_codec( + self, + uint32_t oid, + ServerDataFormat format + ): + cdef Codec codec + + if format == PG_FORMAT_ANY: + codec = self.get_custom_codec(oid, PG_FORMAT_BINARY) + if codec is None: + codec = self.get_custom_codec(oid, PG_FORMAT_TEXT) + else: + codec = self._custom_type_codecs.get((oid, format)) + + return codec + + +cdef inline Codec get_core_codec( + uint32_t oid, ServerDataFormat format, + ClientExchangeFormat xformat=PG_XFORMAT_OBJECT): + cdef: + void *ptr = NULL + + if oid > MAXSUPPORTEDOID: + return None + if format == PG_FORMAT_BINARY: + ptr = binary_codec_map[oid * xformat] + elif format == PG_FORMAT_TEXT: + ptr = text_codec_map[oid * xformat] + + if ptr is NULL: + return None + else: + return ptr + + +cdef inline Codec get_any_core_codec( + uint32_t oid, ServerDataFormat format, + ClientExchangeFormat xformat=PG_XFORMAT_OBJECT): + """A version of get_core_codec that accepts PG_FORMAT_ANY.""" + cdef: + Codec codec + + if format == PG_FORMAT_ANY: + codec = get_core_codec(oid, PG_FORMAT_BINARY, xformat) + if codec is None: + codec = get_core_codec(oid, PG_FORMAT_TEXT, xformat) + else: + codec = get_core_codec(oid, format, xformat) + + return codec + + +cdef inline int has_core_codec(uint32_t oid): + return binary_codec_map[oid] != NULL or text_codec_map[oid] != NULL + + +cdef register_core_codec(uint32_t oid, + encode_func encode, + decode_func decode, + ServerDataFormat format, + ClientExchangeFormat xformat=PG_XFORMAT_OBJECT): + + if oid > MAXSUPPORTEDOID: + raise exceptions.InternalClientError( + 'cannot register core codec for OID {}: it is greater ' + 'than MAXSUPPORTEDOID ({})'.format(oid, MAXSUPPORTEDOID)) + + cdef: + Codec codec + str name + str kind + + name = BUILTIN_TYPE_OID_MAP[oid] + kind = 'array' if oid in ARRAY_TYPES else 'scalar' + + codec = Codec(oid) + codec.init(name, 'pg_catalog', kind, CODEC_C, format, xformat, + encode, decode, None, None, None, None, None, None, None, 0) + cpython.Py_INCREF(codec) # immortalize + + if format == PG_FORMAT_BINARY: + binary_codec_map[oid * xformat] = codec + elif format == PG_FORMAT_TEXT: + text_codec_map[oid * xformat] = codec + else: + raise exceptions.InternalClientError( + 'invalid data format: {}'.format(format)) + + +cdef register_extra_codec(str name, + encode_func encode, + decode_func decode, + ServerDataFormat format): + cdef: + Codec codec + str kind + + kind = 'scalar' + + codec = Codec(INVALIDOID) + codec.init(name, None, kind, CODEC_C, format, PG_XFORMAT_OBJECT, + encode, decode, None, None, None, None, None, None, None, 0) + EXTRA_CODECS[name, format] = codec + + +cdef inline Codec get_extra_codec(str name, ServerDataFormat format): + return EXTRA_CODECS.get((name, format)) diff --git a/env/Lib/site-packages/asyncpg/protocol/codecs/pgproto.pyx b/env/Lib/site-packages/asyncpg/protocol/codecs/pgproto.pyx new file mode 100644 index 0000000..51d650d --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/codecs/pgproto.pyx @@ -0,0 +1,484 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef init_bits_codecs(): + register_core_codec(BITOID, + pgproto.bits_encode, + pgproto.bits_decode, + PG_FORMAT_BINARY) + + register_core_codec(VARBITOID, + pgproto.bits_encode, + pgproto.bits_decode, + PG_FORMAT_BINARY) + + +cdef init_bytea_codecs(): + register_core_codec(BYTEAOID, + pgproto.bytea_encode, + pgproto.bytea_decode, + PG_FORMAT_BINARY) + + register_core_codec(CHAROID, + pgproto.bytea_encode, + pgproto.bytea_decode, + PG_FORMAT_BINARY) + + +cdef init_datetime_codecs(): + register_core_codec(DATEOID, + pgproto.date_encode, + pgproto.date_decode, + PG_FORMAT_BINARY) + + register_core_codec(DATEOID, + pgproto.date_encode_tuple, + pgproto.date_decode_tuple, + PG_FORMAT_BINARY, + PG_XFORMAT_TUPLE) + + register_core_codec(TIMEOID, + pgproto.time_encode, + pgproto.time_decode, + PG_FORMAT_BINARY) + + register_core_codec(TIMEOID, + pgproto.time_encode_tuple, + pgproto.time_decode_tuple, + PG_FORMAT_BINARY, + PG_XFORMAT_TUPLE) + + register_core_codec(TIMETZOID, + pgproto.timetz_encode, + pgproto.timetz_decode, + PG_FORMAT_BINARY) + + register_core_codec(TIMETZOID, + pgproto.timetz_encode_tuple, + pgproto.timetz_decode_tuple, + PG_FORMAT_BINARY, + PG_XFORMAT_TUPLE) + + register_core_codec(TIMESTAMPOID, + pgproto.timestamp_encode, + pgproto.timestamp_decode, + PG_FORMAT_BINARY) + + register_core_codec(TIMESTAMPOID, + pgproto.timestamp_encode_tuple, + pgproto.timestamp_decode_tuple, + PG_FORMAT_BINARY, + PG_XFORMAT_TUPLE) + + register_core_codec(TIMESTAMPTZOID, + pgproto.timestamptz_encode, + pgproto.timestamptz_decode, + PG_FORMAT_BINARY) + + register_core_codec(TIMESTAMPTZOID, + pgproto.timestamp_encode_tuple, + pgproto.timestamp_decode_tuple, + PG_FORMAT_BINARY, + PG_XFORMAT_TUPLE) + + register_core_codec(INTERVALOID, + pgproto.interval_encode, + pgproto.interval_decode, + PG_FORMAT_BINARY) + + register_core_codec(INTERVALOID, + pgproto.interval_encode_tuple, + pgproto.interval_decode_tuple, + PG_FORMAT_BINARY, + PG_XFORMAT_TUPLE) + + # For obsolete abstime/reltime/tinterval, we do not bother to + # interpret the value, and simply return and pass it as text. + # + register_core_codec(ABSTIMEOID, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_TEXT) + + register_core_codec(RELTIMEOID, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_TEXT) + + register_core_codec(TINTERVALOID, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_TEXT) + + +cdef init_float_codecs(): + register_core_codec(FLOAT4OID, + pgproto.float4_encode, + pgproto.float4_decode, + PG_FORMAT_BINARY) + + register_core_codec(FLOAT8OID, + pgproto.float8_encode, + pgproto.float8_decode, + PG_FORMAT_BINARY) + + +cdef init_geometry_codecs(): + register_core_codec(BOXOID, + pgproto.box_encode, + pgproto.box_decode, + PG_FORMAT_BINARY) + + register_core_codec(LINEOID, + pgproto.line_encode, + pgproto.line_decode, + PG_FORMAT_BINARY) + + register_core_codec(LSEGOID, + pgproto.lseg_encode, + pgproto.lseg_decode, + PG_FORMAT_BINARY) + + register_core_codec(POINTOID, + pgproto.point_encode, + pgproto.point_decode, + PG_FORMAT_BINARY) + + register_core_codec(PATHOID, + pgproto.path_encode, + pgproto.path_decode, + PG_FORMAT_BINARY) + + register_core_codec(POLYGONOID, + pgproto.poly_encode, + pgproto.poly_decode, + PG_FORMAT_BINARY) + + register_core_codec(CIRCLEOID, + pgproto.circle_encode, + pgproto.circle_decode, + PG_FORMAT_BINARY) + + +cdef init_hstore_codecs(): + register_extra_codec('pg_contrib.hstore', + pgproto.hstore_encode, + pgproto.hstore_decode, + PG_FORMAT_BINARY) + + +cdef init_json_codecs(): + register_core_codec(JSONOID, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_BINARY) + register_core_codec(JSONBOID, + pgproto.jsonb_encode, + pgproto.jsonb_decode, + PG_FORMAT_BINARY) + register_core_codec(JSONPATHOID, + pgproto.jsonpath_encode, + pgproto.jsonpath_decode, + PG_FORMAT_BINARY) + + +cdef init_int_codecs(): + + register_core_codec(BOOLOID, + pgproto.bool_encode, + pgproto.bool_decode, + PG_FORMAT_BINARY) + + register_core_codec(INT2OID, + pgproto.int2_encode, + pgproto.int2_decode, + PG_FORMAT_BINARY) + + register_core_codec(INT4OID, + pgproto.int4_encode, + pgproto.int4_decode, + PG_FORMAT_BINARY) + + register_core_codec(INT8OID, + pgproto.int8_encode, + pgproto.int8_decode, + PG_FORMAT_BINARY) + + +cdef init_pseudo_codecs(): + # Void type is returned by SELECT void_returning_function() + register_core_codec(VOIDOID, + pgproto.void_encode, + pgproto.void_decode, + PG_FORMAT_BINARY) + + # Unknown type, always decoded as text + register_core_codec(UNKNOWNOID, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_TEXT) + + # OID and friends + oid_types = [ + OIDOID, XIDOID, CIDOID + ] + + for oid_type in oid_types: + register_core_codec(oid_type, + pgproto.uint4_encode, + pgproto.uint4_decode, + PG_FORMAT_BINARY) + + # 64-bit OID types + oid8_types = [ + XID8OID, + ] + + for oid_type in oid8_types: + register_core_codec(oid_type, + pgproto.uint8_encode, + pgproto.uint8_decode, + PG_FORMAT_BINARY) + + # reg* types -- these are really system catalog OIDs, but + # allow the catalog object name as an input. We could just + # decode these as OIDs, but handling them as text seems more + # useful. + # + reg_types = [ + REGPROCOID, REGPROCEDUREOID, REGOPEROID, REGOPERATOROID, + REGCLASSOID, REGTYPEOID, REGCONFIGOID, REGDICTIONARYOID, + REGNAMESPACEOID, REGROLEOID, REFCURSOROID, REGCOLLATIONOID, + ] + + for reg_type in reg_types: + register_core_codec(reg_type, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_TEXT) + + # cstring type is used by Postgres' I/O functions + register_core_codec(CSTRINGOID, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_BINARY) + + # various system pseudotypes with no I/O + no_io_types = [ + ANYOID, TRIGGEROID, EVENT_TRIGGEROID, LANGUAGE_HANDLEROID, + FDW_HANDLEROID, TSM_HANDLEROID, INTERNALOID, OPAQUEOID, + ANYELEMENTOID, ANYNONARRAYOID, ANYCOMPATIBLEOID, + ANYCOMPATIBLEARRAYOID, ANYCOMPATIBLENONARRAYOID, + ANYCOMPATIBLERANGEOID, ANYCOMPATIBLEMULTIRANGEOID, + ANYRANGEOID, ANYMULTIRANGEOID, ANYARRAYOID, + PG_DDL_COMMANDOID, INDEX_AM_HANDLEROID, TABLE_AM_HANDLEROID, + ] + + register_core_codec(ANYENUMOID, + NULL, + pgproto.text_decode, + PG_FORMAT_TEXT) + + for no_io_type in no_io_types: + register_core_codec(no_io_type, + NULL, + NULL, + PG_FORMAT_BINARY) + + # ACL specification string + register_core_codec(ACLITEMOID, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_TEXT) + + # Postgres' serialized expression tree type + register_core_codec(PG_NODE_TREEOID, + NULL, + pgproto.text_decode, + PG_FORMAT_TEXT) + + # pg_lsn type -- a pointer to a location in the XLOG. + register_core_codec(PG_LSNOID, + pgproto.int8_encode, + pgproto.int8_decode, + PG_FORMAT_BINARY) + + register_core_codec(SMGROID, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_TEXT) + + # pg_dependencies and pg_ndistinct are special types + # used in pg_statistic_ext columns. + register_core_codec(PG_DEPENDENCIESOID, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_TEXT) + + register_core_codec(PG_NDISTINCTOID, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_TEXT) + + # pg_mcv_list is a special type used in pg_statistic_ext_data + # system catalog + register_core_codec(PG_MCV_LISTOID, + pgproto.bytea_encode, + pgproto.bytea_decode, + PG_FORMAT_BINARY) + + # These two are internal to BRIN index support and are unlikely + # to be sent, but since I/O functions for these exist, add decoders + # nonetheless. + register_core_codec(PG_BRIN_BLOOM_SUMMARYOID, + NULL, + pgproto.bytea_decode, + PG_FORMAT_BINARY) + + register_core_codec(PG_BRIN_MINMAX_MULTI_SUMMARYOID, + NULL, + pgproto.bytea_decode, + PG_FORMAT_BINARY) + + +cdef init_text_codecs(): + textoids = [ + NAMEOID, + BPCHAROID, + VARCHAROID, + TEXTOID, + XMLOID + ] + + for oid in textoids: + register_core_codec(oid, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_BINARY) + + register_core_codec(oid, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_TEXT) + + +cdef init_tid_codecs(): + register_core_codec(TIDOID, + pgproto.tid_encode, + pgproto.tid_decode, + PG_FORMAT_BINARY) + + +cdef init_txid_codecs(): + register_core_codec(TXID_SNAPSHOTOID, + pgproto.pg_snapshot_encode, + pgproto.pg_snapshot_decode, + PG_FORMAT_BINARY) + + register_core_codec(PG_SNAPSHOTOID, + pgproto.pg_snapshot_encode, + pgproto.pg_snapshot_decode, + PG_FORMAT_BINARY) + + +cdef init_tsearch_codecs(): + ts_oids = [ + TSQUERYOID, + TSVECTOROID, + ] + + for oid in ts_oids: + register_core_codec(oid, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_TEXT) + + register_core_codec(GTSVECTOROID, + NULL, + pgproto.text_decode, + PG_FORMAT_TEXT) + + +cdef init_uuid_codecs(): + register_core_codec(UUIDOID, + pgproto.uuid_encode, + pgproto.uuid_decode, + PG_FORMAT_BINARY) + + +cdef init_numeric_codecs(): + register_core_codec(NUMERICOID, + pgproto.numeric_encode_text, + pgproto.numeric_decode_text, + PG_FORMAT_TEXT) + + register_core_codec(NUMERICOID, + pgproto.numeric_encode_binary, + pgproto.numeric_decode_binary, + PG_FORMAT_BINARY) + + +cdef init_network_codecs(): + register_core_codec(CIDROID, + pgproto.cidr_encode, + pgproto.cidr_decode, + PG_FORMAT_BINARY) + + register_core_codec(INETOID, + pgproto.inet_encode, + pgproto.inet_decode, + PG_FORMAT_BINARY) + + register_core_codec(MACADDROID, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_TEXT) + + register_core_codec(MACADDR8OID, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_TEXT) + + +cdef init_monetary_codecs(): + moneyoids = [ + MONEYOID, + ] + + for oid in moneyoids: + register_core_codec(oid, + pgproto.text_encode, + pgproto.text_decode, + PG_FORMAT_TEXT) + + +cdef init_all_pgproto_codecs(): + # Builtin types, in lexicographical order. + init_bits_codecs() + init_bytea_codecs() + init_datetime_codecs() + init_float_codecs() + init_geometry_codecs() + init_int_codecs() + init_json_codecs() + init_monetary_codecs() + init_network_codecs() + init_numeric_codecs() + init_text_codecs() + init_tid_codecs() + init_tsearch_codecs() + init_txid_codecs() + init_uuid_codecs() + + # Various pseudotypes and system types + init_pseudo_codecs() + + # contrib + init_hstore_codecs() + + +init_all_pgproto_codecs() diff --git a/env/Lib/site-packages/asyncpg/protocol/codecs/range.pyx b/env/Lib/site-packages/asyncpg/protocol/codecs/range.pyx new file mode 100644 index 0000000..1038c18 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/codecs/range.pyx @@ -0,0 +1,207 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +from asyncpg import types as apg_types + +from collections.abc import Sequence as SequenceABC + +# defined in postgresql/src/include/utils/rangetypes.h +DEF RANGE_EMPTY = 0x01 # range is empty +DEF RANGE_LB_INC = 0x02 # lower bound is inclusive +DEF RANGE_UB_INC = 0x04 # upper bound is inclusive +DEF RANGE_LB_INF = 0x08 # lower bound is -infinity +DEF RANGE_UB_INF = 0x10 # upper bound is +infinity + + +cdef enum _RangeArgumentType: + _RANGE_ARGUMENT_INVALID = 0 + _RANGE_ARGUMENT_TUPLE = 1 + _RANGE_ARGUMENT_RANGE = 2 + + +cdef inline bint _range_has_lbound(uint8_t flags): + return not (flags & (RANGE_EMPTY | RANGE_LB_INF)) + + +cdef inline bint _range_has_ubound(uint8_t flags): + return not (flags & (RANGE_EMPTY | RANGE_UB_INF)) + + +cdef inline _RangeArgumentType _range_type(object obj): + if cpython.PyTuple_Check(obj) or cpython.PyList_Check(obj): + return _RANGE_ARGUMENT_TUPLE + elif isinstance(obj, apg_types.Range): + return _RANGE_ARGUMENT_RANGE + else: + return _RANGE_ARGUMENT_INVALID + + +cdef range_encode(ConnectionSettings settings, WriteBuffer buf, + object obj, uint32_t elem_oid, + encode_func_ex encoder, const void *encoder_arg): + cdef: + ssize_t obj_len + uint8_t flags = 0 + object lower = None + object upper = None + WriteBuffer bounds_data = WriteBuffer.new() + _RangeArgumentType arg_type = _range_type(obj) + + if arg_type == _RANGE_ARGUMENT_INVALID: + raise TypeError( + 'list, tuple or Range object expected (got type {})'.format( + type(obj))) + + elif arg_type == _RANGE_ARGUMENT_TUPLE: + obj_len = len(obj) + if obj_len == 2: + lower = obj[0] + upper = obj[1] + + if lower is None: + flags |= RANGE_LB_INF + + if upper is None: + flags |= RANGE_UB_INF + + flags |= RANGE_LB_INC | RANGE_UB_INC + + elif obj_len == 1: + lower = obj[0] + flags |= RANGE_LB_INC | RANGE_UB_INF + + elif obj_len == 0: + flags |= RANGE_EMPTY + + else: + raise ValueError( + 'expected 0, 1 or 2 elements in range (got {})'.format( + obj_len)) + + else: + if obj.isempty: + flags |= RANGE_EMPTY + else: + lower = obj.lower + upper = obj.upper + + if obj.lower_inc: + flags |= RANGE_LB_INC + elif lower is None: + flags |= RANGE_LB_INF + + if obj.upper_inc: + flags |= RANGE_UB_INC + elif upper is None: + flags |= RANGE_UB_INF + + if _range_has_lbound(flags): + encoder(settings, bounds_data, lower, encoder_arg) + + if _range_has_ubound(flags): + encoder(settings, bounds_data, upper, encoder_arg) + + buf.write_int32(1 + bounds_data.len()) + buf.write_byte(flags) + buf.write_buffer(bounds_data) + + +cdef range_decode(ConnectionSettings settings, FRBuffer *buf, + decode_func_ex decoder, const void *decoder_arg): + cdef: + uint8_t flags = frb_read(buf, 1)[0] + int32_t bound_len + object lower = None + object upper = None + FRBuffer bound_buf + + if _range_has_lbound(flags): + bound_len = hton.unpack_int32(frb_read(buf, 4)) + if bound_len == -1: + lower = None + else: + frb_slice_from(&bound_buf, buf, bound_len) + lower = decoder(settings, &bound_buf, decoder_arg) + + if _range_has_ubound(flags): + bound_len = hton.unpack_int32(frb_read(buf, 4)) + if bound_len == -1: + upper = None + else: + frb_slice_from(&bound_buf, buf, bound_len) + upper = decoder(settings, &bound_buf, decoder_arg) + + return apg_types.Range(lower=lower, upper=upper, + lower_inc=(flags & RANGE_LB_INC) != 0, + upper_inc=(flags & RANGE_UB_INC) != 0, + empty=(flags & RANGE_EMPTY) != 0) + + +cdef multirange_encode(ConnectionSettings settings, WriteBuffer buf, + object obj, uint32_t elem_oid, + encode_func_ex encoder, const void *encoder_arg): + cdef: + WriteBuffer elem_data + ssize_t elem_data_len + ssize_t elem_count + + if not isinstance(obj, SequenceABC): + raise TypeError( + 'expected a sequence (got type {!r})'.format(type(obj).__name__) + ) + + elem_data = WriteBuffer.new() + + for elem in obj: + range_encode(settings, elem_data, elem, elem_oid, encoder, encoder_arg) + + elem_count = len(obj) + if elem_count > INT32_MAX: + raise OverflowError(f'too many elements in multirange value') + + elem_data_len = elem_data.len() + if elem_data_len > INT32_MAX - 4: + raise OverflowError( + f'size of encoded multirange datum exceeds the maximum allowed' + f' {INT32_MAX - 4} bytes') + + # Datum length + buf.write_int32(4 + elem_data_len) + # Number of elements in multirange + buf.write_int32(elem_count) + buf.write_buffer(elem_data) + + +cdef multirange_decode(ConnectionSettings settings, FRBuffer *buf, + decode_func_ex decoder, const void *decoder_arg): + cdef: + int32_t nelems = hton.unpack_int32(frb_read(buf, 4)) + FRBuffer elem_buf + int32_t elem_len + int i + list result + + if nelems == 0: + return [] + + if nelems < 0: + raise exceptions.ProtocolError( + 'unexpected multirange size value: {}'.format(nelems)) + + result = cpython.PyList_New(nelems) + for i in range(nelems): + elem_len = hton.unpack_int32(frb_read(buf, 4)) + if elem_len == -1: + raise exceptions.ProtocolError( + 'unexpected NULL element in multirange value') + else: + frb_slice_from(&elem_buf, buf, elem_len) + elem = range_decode(settings, &elem_buf, decoder, decoder_arg) + cpython.Py_INCREF(elem) + cpython.PyList_SET_ITEM(result, i, elem) + + return result diff --git a/env/Lib/site-packages/asyncpg/protocol/codecs/record.pyx b/env/Lib/site-packages/asyncpg/protocol/codecs/record.pyx new file mode 100644 index 0000000..6446f2d --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/codecs/record.pyx @@ -0,0 +1,71 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +from asyncpg import exceptions + + +cdef inline record_encode_frame(ConnectionSettings settings, WriteBuffer buf, + WriteBuffer elem_data, int32_t elem_count): + buf.write_int32(4 + elem_data.len()) + # attribute count + buf.write_int32(elem_count) + # encoded attribute data + buf.write_buffer(elem_data) + + +cdef anonymous_record_decode(ConnectionSettings settings, FRBuffer *buf): + cdef: + tuple result + ssize_t elem_count + ssize_t i + int32_t elem_len + uint32_t elem_typ + Codec elem_codec + FRBuffer elem_buf + + elem_count = hton.unpack_int32(frb_read(buf, 4)) + result = cpython.PyTuple_New(elem_count) + + for i in range(elem_count): + elem_typ = hton.unpack_int32(frb_read(buf, 4)) + elem_len = hton.unpack_int32(frb_read(buf, 4)) + + if elem_len == -1: + elem = None + else: + elem_codec = settings.get_data_codec(elem_typ) + if elem_codec is None or not elem_codec.has_decoder(): + raise exceptions.InternalClientError( + 'no decoder for composite type element in ' + 'position {} of type OID {}'.format(i, elem_typ)) + elem = elem_codec.decode(settings, + frb_slice_from(&elem_buf, buf, elem_len)) + + cpython.Py_INCREF(elem) + cpython.PyTuple_SET_ITEM(result, i, elem) + + return result + + +cdef anonymous_record_encode(ConnectionSettings settings, WriteBuffer buf, obj): + raise exceptions.UnsupportedClientFeatureError( + 'input of anonymous composite types is not supported', + hint=( + 'Consider declaring an explicit composite type and ' + 'using it to cast the argument.' + ), + detail='PostgreSQL does not implement anonymous composite type input.' + ) + + +cdef init_record_codecs(): + register_core_codec(RECORDOID, + anonymous_record_encode, + anonymous_record_decode, + PG_FORMAT_BINARY) + +init_record_codecs() diff --git a/env/Lib/site-packages/asyncpg/protocol/codecs/textutils.pyx b/env/Lib/site-packages/asyncpg/protocol/codecs/textutils.pyx new file mode 100644 index 0000000..dfaf29e --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/codecs/textutils.pyx @@ -0,0 +1,99 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef inline uint32_t _apg_tolower(uint32_t c): + if c >= 'A' and c <= 'Z': + return c + 'a' - 'A' + else: + return c + + +cdef int apg_strcasecmp(const Py_UCS4 *s1, const Py_UCS4 *s2): + cdef: + uint32_t c1 + uint32_t c2 + int i = 0 + + while True: + c1 = s1[i] + c2 = s2[i] + + if c1 != c2: + c1 = _apg_tolower(c1) + c2 = _apg_tolower(c2) + if c1 != c2: + return c1 - c2 + + if c1 == 0 or c2 == 0: + break + + i += 1 + + return 0 + + +cdef int apg_strcasecmp_char(const char *s1, const char *s2): + cdef: + uint8_t c1 + uint8_t c2 + int i = 0 + + while True: + c1 = s1[i] + c2 = s2[i] + + if c1 != c2: + c1 = _apg_tolower(c1) + c2 = _apg_tolower(c2) + if c1 != c2: + return c1 - c2 + + if c1 == 0 or c2 == 0: + break + + i += 1 + + return 0 + + +cdef inline bint apg_ascii_isspace(Py_UCS4 ch): + return ( + ch == ' ' or + ch == '\n' or + ch == '\r' or + ch == '\t' or + ch == '\v' or + ch == '\f' + ) + + +cdef Py_UCS4 *apg_parse_int32(Py_UCS4 *buf, int32_t *num): + cdef: + Py_UCS4 *p + int32_t n = 0 + int32_t neg = 0 + + if buf[0] == '-': + neg = 1 + buf += 1 + elif buf[0] == '+': + buf += 1 + + p = buf + while p[0] >= '0' and p[0] <= '9': + n = 10 * n - (p[0] - '0') + p += 1 + + if p == buf: + return NULL + + if not neg: + n = -n + + num[0] = n + + return p diff --git a/env/Lib/site-packages/asyncpg/protocol/consts.pxi b/env/Lib/site-packages/asyncpg/protocol/consts.pxi new file mode 100644 index 0000000..e1f8726 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/consts.pxi @@ -0,0 +1,12 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +DEF _MAXINT32 = 2**31 - 1 +DEF _COPY_BUFFER_SIZE = 524288 +DEF _COPY_SIGNATURE = b"PGCOPY\n\377\r\n\0" +DEF _EXECUTE_MANY_BUF_NUM = 4 +DEF _EXECUTE_MANY_BUF_SIZE = 32768 diff --git a/env/Lib/site-packages/asyncpg/protocol/coreproto.pxd b/env/Lib/site-packages/asyncpg/protocol/coreproto.pxd new file mode 100644 index 0000000..7ce4f57 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/coreproto.pxd @@ -0,0 +1,195 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +include "scram.pxd" + + +cdef enum ConnectionStatus: + CONNECTION_OK = 1 + CONNECTION_BAD = 2 + CONNECTION_STARTED = 3 # Waiting for connection to be made. + + +cdef enum ProtocolState: + PROTOCOL_IDLE = 0 + + PROTOCOL_FAILED = 1 + PROTOCOL_ERROR_CONSUME = 2 + PROTOCOL_CANCELLED = 3 + PROTOCOL_TERMINATING = 4 + + PROTOCOL_AUTH = 10 + PROTOCOL_PREPARE = 11 + PROTOCOL_BIND_EXECUTE = 12 + PROTOCOL_BIND_EXECUTE_MANY = 13 + PROTOCOL_CLOSE_STMT_PORTAL = 14 + PROTOCOL_SIMPLE_QUERY = 15 + PROTOCOL_EXECUTE = 16 + PROTOCOL_BIND = 17 + PROTOCOL_COPY_OUT = 18 + PROTOCOL_COPY_OUT_DATA = 19 + PROTOCOL_COPY_OUT_DONE = 20 + PROTOCOL_COPY_IN = 21 + PROTOCOL_COPY_IN_DATA = 22 + + +cdef enum AuthenticationMessage: + AUTH_SUCCESSFUL = 0 + AUTH_REQUIRED_KERBEROS = 2 + AUTH_REQUIRED_PASSWORD = 3 + AUTH_REQUIRED_PASSWORDMD5 = 5 + AUTH_REQUIRED_SCMCRED = 6 + AUTH_REQUIRED_GSS = 7 + AUTH_REQUIRED_GSS_CONTINUE = 8 + AUTH_REQUIRED_SSPI = 9 + AUTH_REQUIRED_SASL = 10 + AUTH_SASL_CONTINUE = 11 + AUTH_SASL_FINAL = 12 + + +AUTH_METHOD_NAME = { + AUTH_REQUIRED_KERBEROS: 'kerberosv5', + AUTH_REQUIRED_PASSWORD: 'password', + AUTH_REQUIRED_PASSWORDMD5: 'md5', + AUTH_REQUIRED_GSS: 'gss', + AUTH_REQUIRED_SASL: 'scram-sha-256', + AUTH_REQUIRED_SSPI: 'sspi', +} + + +cdef enum ResultType: + RESULT_OK = 1 + RESULT_FAILED = 2 + + +cdef enum TransactionStatus: + PQTRANS_IDLE = 0 # connection idle + PQTRANS_ACTIVE = 1 # command in progress + PQTRANS_INTRANS = 2 # idle, within transaction block + PQTRANS_INERROR = 3 # idle, within failed transaction + PQTRANS_UNKNOWN = 4 # cannot determine status + + +ctypedef object (*decode_row_method)(object, const char*, ssize_t) + + +cdef class CoreProtocol: + cdef: + ReadBuffer buffer + bint _skip_discard + bint _discard_data + + # executemany support data + object _execute_iter + str _execute_portal_name + str _execute_stmt_name + + ConnectionStatus con_status + ProtocolState state + TransactionStatus xact_status + + str encoding + + object transport + + # Instance of _ConnectionParameters + object con_params + # Instance of SCRAMAuthentication + SCRAMAuthentication scram + + readonly int32_t backend_pid + readonly int32_t backend_secret + + ## Result + ResultType result_type + object result + bytes result_param_desc + bytes result_row_desc + bytes result_status_msg + + # True - completed, False - suspended + bint result_execute_completed + + cpdef is_in_transaction(self) + cdef _process__auth(self, char mtype) + cdef _process__prepare(self, char mtype) + cdef _process__bind_execute(self, char mtype) + cdef _process__bind_execute_many(self, char mtype) + cdef _process__close_stmt_portal(self, char mtype) + cdef _process__simple_query(self, char mtype) + cdef _process__bind(self, char mtype) + cdef _process__copy_out(self, char mtype) + cdef _process__copy_out_data(self, char mtype) + cdef _process__copy_in(self, char mtype) + cdef _process__copy_in_data(self, char mtype) + + cdef _parse_msg_authentication(self) + cdef _parse_msg_parameter_status(self) + cdef _parse_msg_notification(self) + cdef _parse_msg_backend_key_data(self) + cdef _parse_msg_ready_for_query(self) + cdef _parse_data_msgs(self) + cdef _parse_copy_data_msgs(self) + cdef _parse_msg_error_response(self, is_error) + cdef _parse_msg_command_complete(self) + + cdef _write_copy_data_msg(self, object data) + cdef _write_copy_done_msg(self) + cdef _write_copy_fail_msg(self, str cause) + + cdef _auth_password_message_cleartext(self) + cdef _auth_password_message_md5(self, bytes salt) + cdef _auth_password_message_sasl_initial(self, list sasl_auth_methods) + cdef _auth_password_message_sasl_continue(self, bytes server_response) + + cdef _write(self, buf) + cdef _writelines(self, list buffers) + + cdef _read_server_messages(self) + + cdef _push_result(self) + cdef _reset_result(self) + cdef _set_state(self, ProtocolState new_state) + + cdef _ensure_connected(self) + + cdef WriteBuffer _build_parse_message(self, str stmt_name, str query) + cdef WriteBuffer _build_bind_message(self, str portal_name, + str stmt_name, + WriteBuffer bind_data) + cdef WriteBuffer _build_empty_bind_data(self) + cdef WriteBuffer _build_execute_message(self, str portal_name, + int32_t limit) + + + cdef _connect(self) + cdef _prepare_and_describe(self, str stmt_name, str query) + cdef _send_parse_message(self, str stmt_name, str query) + cdef _send_bind_message(self, str portal_name, str stmt_name, + WriteBuffer bind_data, int32_t limit) + cdef _bind_execute(self, str portal_name, str stmt_name, + WriteBuffer bind_data, int32_t limit) + cdef bint _bind_execute_many(self, str portal_name, str stmt_name, + object bind_data) + cdef bint _bind_execute_many_more(self, bint first=*) + cdef _bind_execute_many_fail(self, object error, bint first=*) + cdef _bind(self, str portal_name, str stmt_name, + WriteBuffer bind_data) + cdef _execute(self, str portal_name, int32_t limit) + cdef _close(self, str name, bint is_portal) + cdef _simple_query(self, str query) + cdef _copy_out(self, str copy_stmt) + cdef _copy_in(self, str copy_stmt) + cdef _terminate(self) + + cdef _decode_row(self, const char* buf, ssize_t buf_len) + + cdef _on_result(self) + cdef _on_notification(self, pid, channel, payload) + cdef _on_notice(self, parsed) + cdef _set_server_parameter(self, name, val) + cdef _on_connection_lost(self, exc) diff --git a/env/Lib/site-packages/asyncpg/protocol/coreproto.pyx b/env/Lib/site-packages/asyncpg/protocol/coreproto.pyx new file mode 100644 index 0000000..64afe93 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/coreproto.pyx @@ -0,0 +1,1153 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import hashlib + + +include "scram.pyx" + + +cdef class CoreProtocol: + + def __init__(self, con_params): + # type of `con_params` is `_ConnectionParameters` + self.buffer = ReadBuffer() + self.user = con_params.user + self.password = con_params.password + self.auth_msg = None + self.con_params = con_params + self.con_status = CONNECTION_BAD + self.state = PROTOCOL_IDLE + self.xact_status = PQTRANS_IDLE + self.encoding = 'utf-8' + # type of `scram` is `SCRAMAuthentcation` + self.scram = None + + self._reset_result() + + cpdef is_in_transaction(self): + # PQTRANS_INTRANS = idle, within transaction block + # PQTRANS_INERROR = idle, within failed transaction + return self.xact_status in (PQTRANS_INTRANS, PQTRANS_INERROR) + + cdef _read_server_messages(self): + cdef: + char mtype + ProtocolState state + pgproto.take_message_method take_message = \ + self.buffer.take_message + pgproto.get_message_type_method get_message_type= \ + self.buffer.get_message_type + + while take_message(self.buffer) == 1: + mtype = get_message_type(self.buffer) + state = self.state + + try: + if mtype == b'S': + # ParameterStatus + self._parse_msg_parameter_status() + + elif mtype == b'A': + # NotificationResponse + self._parse_msg_notification() + + elif mtype == b'N': + # 'N' - NoticeResponse + self._on_notice(self._parse_msg_error_response(False)) + + elif state == PROTOCOL_AUTH: + self._process__auth(mtype) + + elif state == PROTOCOL_PREPARE: + self._process__prepare(mtype) + + elif state == PROTOCOL_BIND_EXECUTE: + self._process__bind_execute(mtype) + + elif state == PROTOCOL_BIND_EXECUTE_MANY: + self._process__bind_execute_many(mtype) + + elif state == PROTOCOL_EXECUTE: + self._process__bind_execute(mtype) + + elif state == PROTOCOL_BIND: + self._process__bind(mtype) + + elif state == PROTOCOL_CLOSE_STMT_PORTAL: + self._process__close_stmt_portal(mtype) + + elif state == PROTOCOL_SIMPLE_QUERY: + self._process__simple_query(mtype) + + elif state == PROTOCOL_COPY_OUT: + self._process__copy_out(mtype) + + elif (state == PROTOCOL_COPY_OUT_DATA or + state == PROTOCOL_COPY_OUT_DONE): + self._process__copy_out_data(mtype) + + elif state == PROTOCOL_COPY_IN: + self._process__copy_in(mtype) + + elif state == PROTOCOL_COPY_IN_DATA: + self._process__copy_in_data(mtype) + + elif state == PROTOCOL_CANCELLED: + # discard all messages until the sync message + if mtype == b'E': + self._parse_msg_error_response(True) + elif mtype == b'Z': + self._parse_msg_ready_for_query() + self._push_result() + else: + self.buffer.discard_message() + + elif state == PROTOCOL_ERROR_CONSUME: + # Error in protocol (on asyncpg side); + # discard all messages until sync message + + if mtype == b'Z': + # Sync point, self to push the result + if self.result_type != RESULT_FAILED: + self.result_type = RESULT_FAILED + self.result = apg_exc.InternalClientError( + 'unknown error in protocol implementation') + + self._parse_msg_ready_for_query() + self._push_result() + + else: + self.buffer.discard_message() + + elif state == PROTOCOL_TERMINATING: + # The connection is being terminated. + # discard all messages until connection + # termination. + self.buffer.discard_message() + + else: + raise apg_exc.InternalClientError( + f'cannot process message {chr(mtype)!r}: ' + f'protocol is in an unexpected state {state!r}.') + + except Exception as ex: + self.result_type = RESULT_FAILED + self.result = ex + + if mtype == b'Z': + self._push_result() + else: + self.state = PROTOCOL_ERROR_CONSUME + + finally: + self.buffer.finish_message() + + cdef _process__auth(self, char mtype): + if mtype == b'R': + # Authentication... + try: + self._parse_msg_authentication() + except Exception as ex: + # Exception in authentication parsing code + # is usually either malformed authentication data + # or missing support for cryptographic primitives + # in the hashlib module. + self.result_type = RESULT_FAILED + self.result = apg_exc.InternalClientError( + f"unexpected error while performing authentication: {ex}") + self.result.__cause__ = ex + self.con_status = CONNECTION_BAD + self._push_result() + else: + if self.result_type != RESULT_OK: + self.con_status = CONNECTION_BAD + self._push_result() + + elif self.auth_msg is not None: + # Server wants us to send auth data, so do that. + self._write(self.auth_msg) + self.auth_msg = None + + elif mtype == b'K': + # BackendKeyData + self._parse_msg_backend_key_data() + + elif mtype == b'E': + # ErrorResponse + self.con_status = CONNECTION_BAD + self._parse_msg_error_response(True) + self._push_result() + + elif mtype == b'Z': + # ReadyForQuery + self._parse_msg_ready_for_query() + self.con_status = CONNECTION_OK + self._push_result() + + cdef _process__prepare(self, char mtype): + if mtype == b't': + # Parameters description + self.result_param_desc = self.buffer.consume_message() + + elif mtype == b'1': + # ParseComplete + self.buffer.discard_message() + + elif mtype == b'T': + # Row description + self.result_row_desc = self.buffer.consume_message() + self._push_result() + + elif mtype == b'E': + # ErrorResponse + self._parse_msg_error_response(True) + # we don't send a sync during the parse/describe sequence + # but send a FLUSH instead. If an error happens we need to + # send a SYNC explicitly in order to mark the end of the transaction. + # this effectively clears the error and we then wait until we get a + # ready for new query message + self._write(SYNC_MESSAGE) + self.state = PROTOCOL_ERROR_CONSUME + + elif mtype == b'n': + # NoData + self.buffer.discard_message() + self._push_result() + + cdef _process__bind_execute(self, char mtype): + if mtype == b'D': + # DataRow + self._parse_data_msgs() + + elif mtype == b's': + # PortalSuspended + self.buffer.discard_message() + + elif mtype == b'C': + # CommandComplete + self.result_execute_completed = True + self._parse_msg_command_complete() + + elif mtype == b'E': + # ErrorResponse + self._parse_msg_error_response(True) + + elif mtype == b'1': + # ParseComplete, in case `_bind_execute()` is reparsing + self.buffer.discard_message() + + elif mtype == b'2': + # BindComplete + self.buffer.discard_message() + + elif mtype == b'Z': + # ReadyForQuery + self._parse_msg_ready_for_query() + self._push_result() + + elif mtype == b'I': + # EmptyQueryResponse + self.buffer.discard_message() + + cdef _process__bind_execute_many(self, char mtype): + cdef WriteBuffer buf + + if mtype == b'D': + # DataRow + self._parse_data_msgs() + + elif mtype == b's': + # PortalSuspended + self.buffer.discard_message() + + elif mtype == b'C': + # CommandComplete + self._parse_msg_command_complete() + + elif mtype == b'E': + # ErrorResponse + self._parse_msg_error_response(True) + + elif mtype == b'1': + # ParseComplete, in case `_bind_execute_many()` is reparsing + self.buffer.discard_message() + + elif mtype == b'2': + # BindComplete + self.buffer.discard_message() + + elif mtype == b'Z': + # ReadyForQuery + self._parse_msg_ready_for_query() + self._push_result() + + elif mtype == b'I': + # EmptyQueryResponse + self.buffer.discard_message() + + elif mtype == b'1': + # ParseComplete + self.buffer.discard_message() + + cdef _process__bind(self, char mtype): + if mtype == b'E': + # ErrorResponse + self._parse_msg_error_response(True) + + elif mtype == b'2': + # BindComplete + self.buffer.discard_message() + + elif mtype == b'Z': + # ReadyForQuery + self._parse_msg_ready_for_query() + self._push_result() + + cdef _process__close_stmt_portal(self, char mtype): + if mtype == b'E': + # ErrorResponse + self._parse_msg_error_response(True) + + elif mtype == b'3': + # CloseComplete + self.buffer.discard_message() + + elif mtype == b'Z': + # ReadyForQuery + self._parse_msg_ready_for_query() + self._push_result() + + cdef _process__simple_query(self, char mtype): + if mtype in {b'D', b'I', b'T'}: + # 'D' - DataRow + # 'I' - EmptyQueryResponse + # 'T' - RowDescription + self.buffer.discard_message() + + elif mtype == b'E': + # ErrorResponse + self._parse_msg_error_response(True) + + elif mtype == b'Z': + # ReadyForQuery + self._parse_msg_ready_for_query() + self._push_result() + + elif mtype == b'C': + # CommandComplete + self._parse_msg_command_complete() + + else: + # We don't really care about COPY IN etc + self.buffer.discard_message() + + cdef _process__copy_out(self, char mtype): + if mtype == b'E': + self._parse_msg_error_response(True) + + elif mtype == b'H': + # CopyOutResponse + self._set_state(PROTOCOL_COPY_OUT_DATA) + self.buffer.discard_message() + + elif mtype == b'Z': + # ReadyForQuery + self._parse_msg_ready_for_query() + self._push_result() + + cdef _process__copy_out_data(self, char mtype): + if mtype == b'E': + self._parse_msg_error_response(True) + + elif mtype == b'd': + # CopyData + self._parse_copy_data_msgs() + + elif mtype == b'c': + # CopyDone + self.buffer.discard_message() + self._set_state(PROTOCOL_COPY_OUT_DONE) + + elif mtype == b'C': + # CommandComplete + self._parse_msg_command_complete() + + elif mtype == b'Z': + # ReadyForQuery + self._parse_msg_ready_for_query() + self._push_result() + + cdef _process__copy_in(self, char mtype): + if mtype == b'E': + self._parse_msg_error_response(True) + + elif mtype == b'G': + # CopyInResponse + self._set_state(PROTOCOL_COPY_IN_DATA) + self.buffer.discard_message() + + elif mtype == b'Z': + # ReadyForQuery + self._parse_msg_ready_for_query() + self._push_result() + + cdef _process__copy_in_data(self, char mtype): + if mtype == b'E': + self._parse_msg_error_response(True) + + elif mtype == b'C': + # CommandComplete + self._parse_msg_command_complete() + + elif mtype == b'Z': + # ReadyForQuery + self._parse_msg_ready_for_query() + self._push_result() + + cdef _parse_msg_command_complete(self): + cdef: + const char* cbuf + ssize_t cbuf_len + + cbuf = self.buffer.try_consume_message(&cbuf_len) + if cbuf != NULL and cbuf_len > 0: + msg = cpython.PyBytes_FromStringAndSize(cbuf, cbuf_len - 1) + else: + msg = self.buffer.read_null_str() + self.result_status_msg = msg + + cdef _parse_copy_data_msgs(self): + cdef: + ReadBuffer buf = self.buffer + + self.result = buf.consume_messages(b'd') + + # By this point we have consumed all CopyData messages + # in the inbound buffer. If there are no messages left + # in the buffer, we need to push the accumulated data + # out to the caller in anticipation of the new CopyData + # batch. If there _are_ non-CopyData messages left, + # we must not push the result here and let the + # _process__copy_out_data subprotocol do the job. + if not buf.take_message(): + self._on_result() + self.result = None + else: + # If there is a message in the buffer, put it back to + # be processed by the next protocol iteration. + buf.put_message() + + cdef _write_copy_data_msg(self, object data): + cdef: + WriteBuffer buf + object mview + Py_buffer *pybuf + + mview = cpythonx.PyMemoryView_GetContiguous( + data, cpython.PyBUF_READ, b'C') + + try: + pybuf = cpythonx.PyMemoryView_GET_BUFFER(mview) + + buf = WriteBuffer.new_message(b'd') + buf.write_cstr(pybuf.buf, pybuf.len) + buf.end_message() + finally: + mview.release() + + self._write(buf) + + cdef _write_copy_done_msg(self): + cdef: + WriteBuffer buf + + buf = WriteBuffer.new_message(b'c') + buf.end_message() + self._write(buf) + + cdef _write_copy_fail_msg(self, str cause): + cdef: + WriteBuffer buf + + buf = WriteBuffer.new_message(b'f') + buf.write_str(cause or '', self.encoding) + buf.end_message() + self._write(buf) + + cdef _parse_data_msgs(self): + cdef: + ReadBuffer buf = self.buffer + list rows + + decode_row_method decoder = self._decode_row + pgproto.try_consume_message_method try_consume_message = \ + buf.try_consume_message + pgproto.take_message_type_method take_message_type = \ + buf.take_message_type + + const char* cbuf + ssize_t cbuf_len + object row + bytes mem + + if PG_DEBUG: + if buf.get_message_type() != b'D': + raise apg_exc.InternalClientError( + '_parse_data_msgs: first message is not "D"') + + if self._discard_data: + while take_message_type(buf, b'D'): + buf.discard_message() + return + + if PG_DEBUG: + if type(self.result) is not list: + raise apg_exc.InternalClientError( + '_parse_data_msgs: result is not a list, but {!r}'. + format(self.result)) + + rows = self.result + while take_message_type(buf, b'D'): + cbuf = try_consume_message(buf, &cbuf_len) + if cbuf != NULL: + row = decoder(self, cbuf, cbuf_len) + else: + mem = buf.consume_message() + row = decoder( + self, + cpython.PyBytes_AS_STRING(mem), + cpython.PyBytes_GET_SIZE(mem)) + + cpython.PyList_Append(rows, row) + + cdef _parse_msg_backend_key_data(self): + self.backend_pid = self.buffer.read_int32() + self.backend_secret = self.buffer.read_int32() + + cdef _parse_msg_parameter_status(self): + name = self.buffer.read_null_str() + name = name.decode(self.encoding) + + val = self.buffer.read_null_str() + val = val.decode(self.encoding) + + self._set_server_parameter(name, val) + + cdef _parse_msg_notification(self): + pid = self.buffer.read_int32() + channel = self.buffer.read_null_str().decode(self.encoding) + payload = self.buffer.read_null_str().decode(self.encoding) + self._on_notification(pid, channel, payload) + + cdef _parse_msg_authentication(self): + cdef: + int32_t status + bytes md5_salt + list sasl_auth_methods + list unsupported_sasl_auth_methods + + status = self.buffer.read_int32() + + if status == AUTH_SUCCESSFUL: + # AuthenticationOk + self.result_type = RESULT_OK + + elif status == AUTH_REQUIRED_PASSWORD: + # AuthenticationCleartextPassword + self.result_type = RESULT_OK + self.auth_msg = self._auth_password_message_cleartext() + + elif status == AUTH_REQUIRED_PASSWORDMD5: + # AuthenticationMD5Password + # Note: MD5 salt is passed as a four-byte sequence + md5_salt = self.buffer.read_bytes(4) + self.auth_msg = self._auth_password_message_md5(md5_salt) + + elif status == AUTH_REQUIRED_SASL: + # AuthenticationSASL + # This requires making additional requests to the server in order + # to follow the SCRAM protocol defined in RFC 5802. + # get the SASL authentication methods that the server is providing + sasl_auth_methods = [] + unsupported_sasl_auth_methods = [] + # determine if the advertised authentication methods are supported, + # and if so, add them to the list + auth_method = self.buffer.read_null_str() + while auth_method: + if auth_method in SCRAMAuthentication.AUTHENTICATION_METHODS: + sasl_auth_methods.append(auth_method) + else: + unsupported_sasl_auth_methods.append(auth_method) + auth_method = self.buffer.read_null_str() + + # if none of the advertised authentication methods are supported, + # raise an error + # otherwise, initialize the SASL authentication exchange + if not sasl_auth_methods: + unsupported_sasl_auth_methods = [m.decode("ascii") + for m in unsupported_sasl_auth_methods] + self.result_type = RESULT_FAILED + self.result = apg_exc.InterfaceError( + 'unsupported SASL Authentication methods requested by the ' + 'server: {!r}'.format( + ", ".join(unsupported_sasl_auth_methods))) + else: + self.auth_msg = self._auth_password_message_sasl_initial( + sasl_auth_methods) + + elif status == AUTH_SASL_CONTINUE: + # AUTH_SASL_CONTINUE + # this requeires sending the second part of the SASL exchange, where + # the client parses information back from the server and determines + # if this is valid. + # The client builds a challenge response to the server + server_response = self.buffer.consume_message() + self.auth_msg = self._auth_password_message_sasl_continue( + server_response) + + elif status == AUTH_SASL_FINAL: + # AUTH_SASL_FINAL + server_response = self.buffer.consume_message() + if not self.scram.verify_server_final_message(server_response): + self.result_type = RESULT_FAILED + self.result = apg_exc.InterfaceError( + 'could not verify server signature for ' + 'SCRAM authentciation: scram-sha-256', + ) + + elif status in (AUTH_REQUIRED_KERBEROS, AUTH_REQUIRED_SCMCRED, + AUTH_REQUIRED_GSS, AUTH_REQUIRED_GSS_CONTINUE, + AUTH_REQUIRED_SSPI): + self.result_type = RESULT_FAILED + self.result = apg_exc.InterfaceError( + 'unsupported authentication method requested by the ' + 'server: {!r}'.format(AUTH_METHOD_NAME[status])) + + else: + self.result_type = RESULT_FAILED + self.result = apg_exc.InterfaceError( + 'unsupported authentication method requested by the ' + 'server: {}'.format(status)) + + if status not in [AUTH_SASL_CONTINUE, AUTH_SASL_FINAL]: + self.buffer.discard_message() + + cdef _auth_password_message_cleartext(self): + cdef: + WriteBuffer msg + + msg = WriteBuffer.new_message(b'p') + msg.write_bytestring(self.password.encode(self.encoding)) + msg.end_message() + + return msg + + cdef _auth_password_message_md5(self, bytes salt): + cdef: + WriteBuffer msg + + msg = WriteBuffer.new_message(b'p') + + # 'md5' + md5(md5(password + username) + salt)) + userpass = (self.password or '') + (self.user or '') + md5_1 = hashlib.md5(userpass.encode(self.encoding)).hexdigest() + md5_2 = hashlib.md5(md5_1.encode('ascii') + salt).hexdigest() + + msg.write_bytestring(b'md5' + md5_2.encode('ascii')) + msg.end_message() + + return msg + + cdef _auth_password_message_sasl_initial(self, list sasl_auth_methods): + cdef: + WriteBuffer msg + + # use the first supported advertized mechanism + self.scram = SCRAMAuthentication(sasl_auth_methods[0]) + # this involves a call and response with the server + msg = WriteBuffer.new_message(b'p') + msg.write_bytes(self.scram.create_client_first_message(self.user or '')) + msg.end_message() + + return msg + + cdef _auth_password_message_sasl_continue(self, bytes server_response): + cdef: + WriteBuffer msg + + # determine if there is a valid server response + self.scram.parse_server_first_message(server_response) + # this involves a call and response with the server + msg = WriteBuffer.new_message(b'p') + client_final_message = self.scram.create_client_final_message( + self.password or '') + msg.write_bytes(client_final_message) + msg.end_message() + + return msg + + cdef _parse_msg_ready_for_query(self): + cdef char status = self.buffer.read_byte() + + if status == b'I': + self.xact_status = PQTRANS_IDLE + elif status == b'T': + self.xact_status = PQTRANS_INTRANS + elif status == b'E': + self.xact_status = PQTRANS_INERROR + else: + self.xact_status = PQTRANS_UNKNOWN + + cdef _parse_msg_error_response(self, is_error): + cdef: + char code + bytes message + dict parsed = {} + + while True: + code = self.buffer.read_byte() + if code == 0: + break + + message = self.buffer.read_null_str() + + parsed[chr(code)] = message.decode() + + if is_error: + self.result_type = RESULT_FAILED + self.result = parsed + else: + return parsed + + cdef _push_result(self): + try: + self._on_result() + finally: + self._set_state(PROTOCOL_IDLE) + self._reset_result() + + cdef _reset_result(self): + self.result_type = RESULT_OK + self.result = None + self.result_param_desc = None + self.result_row_desc = None + self.result_status_msg = None + self.result_execute_completed = False + self._discard_data = False + + # executemany support data + self._execute_iter = None + self._execute_portal_name = None + self._execute_stmt_name = None + + cdef _set_state(self, ProtocolState new_state): + if new_state == PROTOCOL_IDLE: + if self.state == PROTOCOL_FAILED: + raise apg_exc.InternalClientError( + 'cannot switch to "idle" state; ' + 'protocol is in the "failed" state') + elif self.state == PROTOCOL_IDLE: + pass + else: + self.state = new_state + + elif new_state == PROTOCOL_FAILED: + self.state = PROTOCOL_FAILED + + elif new_state == PROTOCOL_CANCELLED: + self.state = PROTOCOL_CANCELLED + + elif new_state == PROTOCOL_TERMINATING: + self.state = PROTOCOL_TERMINATING + + else: + if self.state == PROTOCOL_IDLE: + self.state = new_state + + elif (self.state == PROTOCOL_COPY_OUT and + new_state == PROTOCOL_COPY_OUT_DATA): + self.state = new_state + + elif (self.state == PROTOCOL_COPY_OUT_DATA and + new_state == PROTOCOL_COPY_OUT_DONE): + self.state = new_state + + elif (self.state == PROTOCOL_COPY_IN and + new_state == PROTOCOL_COPY_IN_DATA): + self.state = new_state + + elif self.state == PROTOCOL_FAILED: + raise apg_exc.InternalClientError( + 'cannot switch to state {}; ' + 'protocol is in the "failed" state'.format(new_state)) + else: + raise apg_exc.InternalClientError( + 'cannot switch to state {}; ' + 'another operation ({}) is in progress'.format( + new_state, self.state)) + + cdef _ensure_connected(self): + if self.con_status != CONNECTION_OK: + raise apg_exc.InternalClientError('not connected') + + cdef WriteBuffer _build_parse_message(self, str stmt_name, str query): + cdef WriteBuffer buf + + buf = WriteBuffer.new_message(b'P') + buf.write_str(stmt_name, self.encoding) + buf.write_str(query, self.encoding) + buf.write_int16(0) + + buf.end_message() + return buf + + cdef WriteBuffer _build_bind_message(self, str portal_name, + str stmt_name, + WriteBuffer bind_data): + cdef WriteBuffer buf + + buf = WriteBuffer.new_message(b'B') + buf.write_str(portal_name, self.encoding) + buf.write_str(stmt_name, self.encoding) + + # Arguments + buf.write_buffer(bind_data) + + buf.end_message() + return buf + + cdef WriteBuffer _build_empty_bind_data(self): + cdef WriteBuffer buf + buf = WriteBuffer.new() + buf.write_int16(0) # The number of parameter format codes + buf.write_int16(0) # The number of parameter values + buf.write_int16(0) # The number of result-column format codes + return buf + + cdef WriteBuffer _build_execute_message(self, str portal_name, + int32_t limit): + cdef WriteBuffer buf + + buf = WriteBuffer.new_message(b'E') + buf.write_str(portal_name, self.encoding) # name of the portal + buf.write_int32(limit) # number of rows to return; 0 - all + + buf.end_message() + return buf + + # API for subclasses + + cdef _connect(self): + cdef: + WriteBuffer buf + WriteBuffer outbuf + + if self.con_status != CONNECTION_BAD: + raise apg_exc.InternalClientError('already connected') + + self._set_state(PROTOCOL_AUTH) + self.con_status = CONNECTION_STARTED + + # Assemble a startup message + buf = WriteBuffer() + + # protocol version + buf.write_int16(3) + buf.write_int16(0) + + buf.write_bytestring(b'client_encoding') + buf.write_bytestring("'{}'".format(self.encoding).encode('ascii')) + + buf.write_str('user', self.encoding) + buf.write_str(self.con_params.user, self.encoding) + + buf.write_str('database', self.encoding) + buf.write_str(self.con_params.database, self.encoding) + + if self.con_params.server_settings is not None: + for k, v in self.con_params.server_settings.items(): + buf.write_str(k, self.encoding) + buf.write_str(v, self.encoding) + + buf.write_bytestring(b'') + + # Send the buffer + outbuf = WriteBuffer() + outbuf.write_int32(buf.len() + 4) + outbuf.write_buffer(buf) + self._write(outbuf) + + cdef _send_parse_message(self, str stmt_name, str query): + cdef: + WriteBuffer msg + + self._ensure_connected() + msg = self._build_parse_message(stmt_name, query) + self._write(msg) + + cdef _prepare_and_describe(self, str stmt_name, str query): + cdef: + WriteBuffer packet + WriteBuffer buf + + self._ensure_connected() + self._set_state(PROTOCOL_PREPARE) + + packet = self._build_parse_message(stmt_name, query) + + buf = WriteBuffer.new_message(b'D') + buf.write_byte(b'S') + buf.write_str(stmt_name, self.encoding) + buf.end_message() + packet.write_buffer(buf) + + packet.write_bytes(FLUSH_MESSAGE) + + self._write(packet) + + cdef _send_bind_message(self, str portal_name, str stmt_name, + WriteBuffer bind_data, int32_t limit): + + cdef: + WriteBuffer packet + WriteBuffer buf + + buf = self._build_bind_message(portal_name, stmt_name, bind_data) + packet = buf + + buf = self._build_execute_message(portal_name, limit) + packet.write_buffer(buf) + + packet.write_bytes(SYNC_MESSAGE) + + self._write(packet) + + cdef _bind_execute(self, str portal_name, str stmt_name, + WriteBuffer bind_data, int32_t limit): + + cdef WriteBuffer buf + + self._ensure_connected() + self._set_state(PROTOCOL_BIND_EXECUTE) + + self.result = [] + + self._send_bind_message(portal_name, stmt_name, bind_data, limit) + + cdef bint _bind_execute_many(self, str portal_name, str stmt_name, + object bind_data): + self._ensure_connected() + self._set_state(PROTOCOL_BIND_EXECUTE_MANY) + + self.result = None + self._discard_data = True + self._execute_iter = bind_data + self._execute_portal_name = portal_name + self._execute_stmt_name = stmt_name + return self._bind_execute_many_more(True) + + cdef bint _bind_execute_many_more(self, bint first=False): + cdef: + WriteBuffer packet + WriteBuffer buf + list buffers = [] + + # as we keep sending, the server may return an error early + if self.result_type == RESULT_FAILED: + self._write(SYNC_MESSAGE) + return False + + # collect up to four 32KB buffers to send + # https://github.com/MagicStack/asyncpg/pull/289#issuecomment-391215051 + while len(buffers) < _EXECUTE_MANY_BUF_NUM: + packet = WriteBuffer.new() + + # fill one 32KB buffer + while packet.len() < _EXECUTE_MANY_BUF_SIZE: + try: + # grab one item from the input + buf = next(self._execute_iter) + + # reached the end of the input + except StopIteration: + if first: + # if we never send anything, simply set the result + self._push_result() + else: + # otherwise, append SYNC and send the buffers + packet.write_bytes(SYNC_MESSAGE) + buffers.append(memoryview(packet)) + self._writelines(buffers) + return False + + # error in input, give up the buffers and cleanup + except Exception as ex: + self._bind_execute_many_fail(ex, first) + return False + + # all good, write to the buffer + first = False + packet.write_buffer( + self._build_bind_message( + self._execute_portal_name, + self._execute_stmt_name, + buf, + ) + ) + packet.write_buffer( + self._build_execute_message(self._execute_portal_name, 0, + ) + ) + + # collected one buffer + buffers.append(memoryview(packet)) + + # write to the wire, and signal the caller for more to send + self._writelines(buffers) + return True + + cdef _bind_execute_many_fail(self, object error, bint first=False): + cdef WriteBuffer buf + + self.result_type = RESULT_FAILED + self.result = error + if first: + self._push_result() + elif self.is_in_transaction(): + # we're in an explicit transaction, just SYNC + self._write(SYNC_MESSAGE) + else: + # In an implicit transaction, if `ignore_till_sync` is set, + # `ROLLBACK` will be ignored and `Sync` will restore the state; + # or the transaction will be rolled back with a warning saying + # that there was no transaction, but rollback is done anyway, + # so we could safely ignore this warning. + # GOTCHA: cannot use simple query message here, because it is + # ignored if `ignore_till_sync` is set. + buf = self._build_parse_message('', 'ROLLBACK') + buf.write_buffer(self._build_bind_message( + '', '', self._build_empty_bind_data())) + buf.write_buffer(self._build_execute_message('', 0)) + buf.write_bytes(SYNC_MESSAGE) + self._write(buf) + + cdef _execute(self, str portal_name, int32_t limit): + cdef WriteBuffer buf + + self._ensure_connected() + self._set_state(PROTOCOL_EXECUTE) + + self.result = [] + + buf = self._build_execute_message(portal_name, limit) + + buf.write_bytes(SYNC_MESSAGE) + + self._write(buf) + + cdef _bind(self, str portal_name, str stmt_name, + WriteBuffer bind_data): + + cdef WriteBuffer buf + + self._ensure_connected() + self._set_state(PROTOCOL_BIND) + + buf = self._build_bind_message(portal_name, stmt_name, bind_data) + + buf.write_bytes(SYNC_MESSAGE) + + self._write(buf) + + cdef _close(self, str name, bint is_portal): + cdef WriteBuffer buf + + self._ensure_connected() + self._set_state(PROTOCOL_CLOSE_STMT_PORTAL) + + buf = WriteBuffer.new_message(b'C') + + if is_portal: + buf.write_byte(b'P') + else: + buf.write_byte(b'S') + + buf.write_str(name, self.encoding) + buf.end_message() + + buf.write_bytes(SYNC_MESSAGE) + + self._write(buf) + + cdef _simple_query(self, str query): + cdef WriteBuffer buf + self._ensure_connected() + self._set_state(PROTOCOL_SIMPLE_QUERY) + buf = WriteBuffer.new_message(b'Q') + buf.write_str(query, self.encoding) + buf.end_message() + self._write(buf) + + cdef _copy_out(self, str copy_stmt): + cdef WriteBuffer buf + + self._ensure_connected() + self._set_state(PROTOCOL_COPY_OUT) + + # Send the COPY .. TO STDOUT using the SimpleQuery protocol. + buf = WriteBuffer.new_message(b'Q') + buf.write_str(copy_stmt, self.encoding) + buf.end_message() + self._write(buf) + + cdef _copy_in(self, str copy_stmt): + cdef WriteBuffer buf + + self._ensure_connected() + self._set_state(PROTOCOL_COPY_IN) + + buf = WriteBuffer.new_message(b'Q') + buf.write_str(copy_stmt, self.encoding) + buf.end_message() + self._write(buf) + + cdef _terminate(self): + cdef WriteBuffer buf + self._ensure_connected() + self._set_state(PROTOCOL_TERMINATING) + buf = WriteBuffer.new_message(b'X') + buf.end_message() + self._write(buf) + + cdef _write(self, buf): + raise NotImplementedError + + cdef _writelines(self, list buffers): + raise NotImplementedError + + cdef _decode_row(self, const char* buf, ssize_t buf_len): + pass + + cdef _set_server_parameter(self, name, val): + pass + + cdef _on_result(self): + pass + + cdef _on_notice(self, parsed): + pass + + cdef _on_notification(self, pid, channel, payload): + pass + + cdef _on_connection_lost(self, exc): + pass + + +cdef bytes SYNC_MESSAGE = bytes(WriteBuffer.new_message(b'S').end_message()) +cdef bytes FLUSH_MESSAGE = bytes(WriteBuffer.new_message(b'H').end_message()) diff --git a/env/Lib/site-packages/asyncpg/protocol/cpythonx.pxd b/env/Lib/site-packages/asyncpg/protocol/cpythonx.pxd new file mode 100644 index 0000000..1c72988 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/cpythonx.pxd @@ -0,0 +1,19 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef extern from "Python.h": + int PyByteArray_Check(object) + + int PyMemoryView_Check(object) + Py_buffer *PyMemoryView_GET_BUFFER(object) + object PyMemoryView_GetContiguous(object, int buffertype, char order) + + Py_UCS4* PyUnicode_AsUCS4Copy(object) except NULL + object PyUnicode_FromKindAndData( + int kind, const void *buffer, Py_ssize_t size) + + int PyUnicode_4BYTE_KIND diff --git a/env/Lib/site-packages/asyncpg/protocol/encodings.pyx b/env/Lib/site-packages/asyncpg/protocol/encodings.pyx new file mode 100644 index 0000000..dcd692b --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/encodings.pyx @@ -0,0 +1,63 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +'''Map PostgreSQL encoding names to Python encoding names + +https://www.postgresql.org/docs/current/static/multibyte.html#CHARSET-TABLE +''' + +cdef dict ENCODINGS_MAP = { + 'abc': 'cp1258', + 'alt': 'cp866', + 'euc_cn': 'euccn', + 'euc_jp': 'eucjp', + 'euc_kr': 'euckr', + 'koi8r': 'koi8_r', + 'koi8u': 'koi8_u', + 'shift_jis_2004': 'euc_jis_2004', + 'sjis': 'shift_jis', + 'sql_ascii': 'ascii', + 'vscii': 'cp1258', + 'tcvn': 'cp1258', + 'tcvn5712': 'cp1258', + 'unicode': 'utf_8', + 'win': 'cp1521', + 'win1250': 'cp1250', + 'win1251': 'cp1251', + 'win1252': 'cp1252', + 'win1253': 'cp1253', + 'win1254': 'cp1254', + 'win1255': 'cp1255', + 'win1256': 'cp1256', + 'win1257': 'cp1257', + 'win1258': 'cp1258', + 'win866': 'cp866', + 'win874': 'cp874', + 'win932': 'cp932', + 'win936': 'cp936', + 'win949': 'cp949', + 'win950': 'cp950', + 'windows1250': 'cp1250', + 'windows1251': 'cp1251', + 'windows1252': 'cp1252', + 'windows1253': 'cp1253', + 'windows1254': 'cp1254', + 'windows1255': 'cp1255', + 'windows1256': 'cp1256', + 'windows1257': 'cp1257', + 'windows1258': 'cp1258', + 'windows866': 'cp866', + 'windows874': 'cp874', + 'windows932': 'cp932', + 'windows936': 'cp936', + 'windows949': 'cp949', + 'windows950': 'cp950', +} + + +cdef get_python_encoding(pg_encoding): + return ENCODINGS_MAP.get(pg_encoding.lower(), pg_encoding.lower()) diff --git a/env/Lib/site-packages/asyncpg/protocol/pgtypes.pxi b/env/Lib/site-packages/asyncpg/protocol/pgtypes.pxi new file mode 100644 index 0000000..e9bb782 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/pgtypes.pxi @@ -0,0 +1,266 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +# GENERATED FROM pg_catalog.pg_type +# DO NOT MODIFY, use tools/generate_type_map.py to update + +DEF INVALIDOID = 0 +DEF MAXBUILTINOID = 9999 +DEF MAXSUPPORTEDOID = 5080 + +DEF BOOLOID = 16 +DEF BYTEAOID = 17 +DEF CHAROID = 18 +DEF NAMEOID = 19 +DEF INT8OID = 20 +DEF INT2OID = 21 +DEF INT4OID = 23 +DEF REGPROCOID = 24 +DEF TEXTOID = 25 +DEF OIDOID = 26 +DEF TIDOID = 27 +DEF XIDOID = 28 +DEF CIDOID = 29 +DEF PG_DDL_COMMANDOID = 32 +DEF JSONOID = 114 +DEF XMLOID = 142 +DEF PG_NODE_TREEOID = 194 +DEF SMGROID = 210 +DEF TABLE_AM_HANDLEROID = 269 +DEF INDEX_AM_HANDLEROID = 325 +DEF POINTOID = 600 +DEF LSEGOID = 601 +DEF PATHOID = 602 +DEF BOXOID = 603 +DEF POLYGONOID = 604 +DEF LINEOID = 628 +DEF CIDROID = 650 +DEF FLOAT4OID = 700 +DEF FLOAT8OID = 701 +DEF ABSTIMEOID = 702 +DEF RELTIMEOID = 703 +DEF TINTERVALOID = 704 +DEF UNKNOWNOID = 705 +DEF CIRCLEOID = 718 +DEF MACADDR8OID = 774 +DEF MONEYOID = 790 +DEF MACADDROID = 829 +DEF INETOID = 869 +DEF _TEXTOID = 1009 +DEF _OIDOID = 1028 +DEF ACLITEMOID = 1033 +DEF BPCHAROID = 1042 +DEF VARCHAROID = 1043 +DEF DATEOID = 1082 +DEF TIMEOID = 1083 +DEF TIMESTAMPOID = 1114 +DEF TIMESTAMPTZOID = 1184 +DEF INTERVALOID = 1186 +DEF TIMETZOID = 1266 +DEF BITOID = 1560 +DEF VARBITOID = 1562 +DEF NUMERICOID = 1700 +DEF REFCURSOROID = 1790 +DEF REGPROCEDUREOID = 2202 +DEF REGOPEROID = 2203 +DEF REGOPERATOROID = 2204 +DEF REGCLASSOID = 2205 +DEF REGTYPEOID = 2206 +DEF RECORDOID = 2249 +DEF CSTRINGOID = 2275 +DEF ANYOID = 2276 +DEF ANYARRAYOID = 2277 +DEF VOIDOID = 2278 +DEF TRIGGEROID = 2279 +DEF LANGUAGE_HANDLEROID = 2280 +DEF INTERNALOID = 2281 +DEF OPAQUEOID = 2282 +DEF ANYELEMENTOID = 2283 +DEF ANYNONARRAYOID = 2776 +DEF UUIDOID = 2950 +DEF TXID_SNAPSHOTOID = 2970 +DEF FDW_HANDLEROID = 3115 +DEF PG_LSNOID = 3220 +DEF TSM_HANDLEROID = 3310 +DEF PG_NDISTINCTOID = 3361 +DEF PG_DEPENDENCIESOID = 3402 +DEF ANYENUMOID = 3500 +DEF TSVECTOROID = 3614 +DEF TSQUERYOID = 3615 +DEF GTSVECTOROID = 3642 +DEF REGCONFIGOID = 3734 +DEF REGDICTIONARYOID = 3769 +DEF JSONBOID = 3802 +DEF ANYRANGEOID = 3831 +DEF EVENT_TRIGGEROID = 3838 +DEF JSONPATHOID = 4072 +DEF REGNAMESPACEOID = 4089 +DEF REGROLEOID = 4096 +DEF REGCOLLATIONOID = 4191 +DEF ANYMULTIRANGEOID = 4537 +DEF ANYCOMPATIBLEMULTIRANGEOID = 4538 +DEF PG_BRIN_BLOOM_SUMMARYOID = 4600 +DEF PG_BRIN_MINMAX_MULTI_SUMMARYOID = 4601 +DEF PG_MCV_LISTOID = 5017 +DEF PG_SNAPSHOTOID = 5038 +DEF XID8OID = 5069 +DEF ANYCOMPATIBLEOID = 5077 +DEF ANYCOMPATIBLEARRAYOID = 5078 +DEF ANYCOMPATIBLENONARRAYOID = 5079 +DEF ANYCOMPATIBLERANGEOID = 5080 + +cdef ARRAY_TYPES = (_TEXTOID, _OIDOID,) + +BUILTIN_TYPE_OID_MAP = { + ABSTIMEOID: 'abstime', + ACLITEMOID: 'aclitem', + ANYARRAYOID: 'anyarray', + ANYCOMPATIBLEARRAYOID: 'anycompatiblearray', + ANYCOMPATIBLEMULTIRANGEOID: 'anycompatiblemultirange', + ANYCOMPATIBLENONARRAYOID: 'anycompatiblenonarray', + ANYCOMPATIBLEOID: 'anycompatible', + ANYCOMPATIBLERANGEOID: 'anycompatiblerange', + ANYELEMENTOID: 'anyelement', + ANYENUMOID: 'anyenum', + ANYMULTIRANGEOID: 'anymultirange', + ANYNONARRAYOID: 'anynonarray', + ANYOID: 'any', + ANYRANGEOID: 'anyrange', + BITOID: 'bit', + BOOLOID: 'bool', + BOXOID: 'box', + BPCHAROID: 'bpchar', + BYTEAOID: 'bytea', + CHAROID: 'char', + CIDOID: 'cid', + CIDROID: 'cidr', + CIRCLEOID: 'circle', + CSTRINGOID: 'cstring', + DATEOID: 'date', + EVENT_TRIGGEROID: 'event_trigger', + FDW_HANDLEROID: 'fdw_handler', + FLOAT4OID: 'float4', + FLOAT8OID: 'float8', + GTSVECTOROID: 'gtsvector', + INDEX_AM_HANDLEROID: 'index_am_handler', + INETOID: 'inet', + INT2OID: 'int2', + INT4OID: 'int4', + INT8OID: 'int8', + INTERNALOID: 'internal', + INTERVALOID: 'interval', + JSONBOID: 'jsonb', + JSONOID: 'json', + JSONPATHOID: 'jsonpath', + LANGUAGE_HANDLEROID: 'language_handler', + LINEOID: 'line', + LSEGOID: 'lseg', + MACADDR8OID: 'macaddr8', + MACADDROID: 'macaddr', + MONEYOID: 'money', + NAMEOID: 'name', + NUMERICOID: 'numeric', + OIDOID: 'oid', + OPAQUEOID: 'opaque', + PATHOID: 'path', + PG_BRIN_BLOOM_SUMMARYOID: 'pg_brin_bloom_summary', + PG_BRIN_MINMAX_MULTI_SUMMARYOID: 'pg_brin_minmax_multi_summary', + PG_DDL_COMMANDOID: 'pg_ddl_command', + PG_DEPENDENCIESOID: 'pg_dependencies', + PG_LSNOID: 'pg_lsn', + PG_MCV_LISTOID: 'pg_mcv_list', + PG_NDISTINCTOID: 'pg_ndistinct', + PG_NODE_TREEOID: 'pg_node_tree', + PG_SNAPSHOTOID: 'pg_snapshot', + POINTOID: 'point', + POLYGONOID: 'polygon', + RECORDOID: 'record', + REFCURSOROID: 'refcursor', + REGCLASSOID: 'regclass', + REGCOLLATIONOID: 'regcollation', + REGCONFIGOID: 'regconfig', + REGDICTIONARYOID: 'regdictionary', + REGNAMESPACEOID: 'regnamespace', + REGOPERATOROID: 'regoperator', + REGOPEROID: 'regoper', + REGPROCEDUREOID: 'regprocedure', + REGPROCOID: 'regproc', + REGROLEOID: 'regrole', + REGTYPEOID: 'regtype', + RELTIMEOID: 'reltime', + SMGROID: 'smgr', + TABLE_AM_HANDLEROID: 'table_am_handler', + TEXTOID: 'text', + TIDOID: 'tid', + TIMEOID: 'time', + TIMESTAMPOID: 'timestamp', + TIMESTAMPTZOID: 'timestamptz', + TIMETZOID: 'timetz', + TINTERVALOID: 'tinterval', + TRIGGEROID: 'trigger', + TSM_HANDLEROID: 'tsm_handler', + TSQUERYOID: 'tsquery', + TSVECTOROID: 'tsvector', + TXID_SNAPSHOTOID: 'txid_snapshot', + UNKNOWNOID: 'unknown', + UUIDOID: 'uuid', + VARBITOID: 'varbit', + VARCHAROID: 'varchar', + VOIDOID: 'void', + XID8OID: 'xid8', + XIDOID: 'xid', + XMLOID: 'xml', + _OIDOID: 'oid[]', + _TEXTOID: 'text[]' +} + +BUILTIN_TYPE_NAME_MAP = {v: k for k, v in BUILTIN_TYPE_OID_MAP.items()} + +BUILTIN_TYPE_NAME_MAP['smallint'] = \ + BUILTIN_TYPE_NAME_MAP['int2'] + +BUILTIN_TYPE_NAME_MAP['int'] = \ + BUILTIN_TYPE_NAME_MAP['int4'] + +BUILTIN_TYPE_NAME_MAP['integer'] = \ + BUILTIN_TYPE_NAME_MAP['int4'] + +BUILTIN_TYPE_NAME_MAP['bigint'] = \ + BUILTIN_TYPE_NAME_MAP['int8'] + +BUILTIN_TYPE_NAME_MAP['decimal'] = \ + BUILTIN_TYPE_NAME_MAP['numeric'] + +BUILTIN_TYPE_NAME_MAP['real'] = \ + BUILTIN_TYPE_NAME_MAP['float4'] + +BUILTIN_TYPE_NAME_MAP['double precision'] = \ + BUILTIN_TYPE_NAME_MAP['float8'] + +BUILTIN_TYPE_NAME_MAP['timestamp with timezone'] = \ + BUILTIN_TYPE_NAME_MAP['timestamptz'] + +BUILTIN_TYPE_NAME_MAP['timestamp without timezone'] = \ + BUILTIN_TYPE_NAME_MAP['timestamp'] + +BUILTIN_TYPE_NAME_MAP['time with timezone'] = \ + BUILTIN_TYPE_NAME_MAP['timetz'] + +BUILTIN_TYPE_NAME_MAP['time without timezone'] = \ + BUILTIN_TYPE_NAME_MAP['time'] + +BUILTIN_TYPE_NAME_MAP['char'] = \ + BUILTIN_TYPE_NAME_MAP['bpchar'] + +BUILTIN_TYPE_NAME_MAP['character'] = \ + BUILTIN_TYPE_NAME_MAP['bpchar'] + +BUILTIN_TYPE_NAME_MAP['character varying'] = \ + BUILTIN_TYPE_NAME_MAP['varchar'] + +BUILTIN_TYPE_NAME_MAP['bit varying'] = \ + BUILTIN_TYPE_NAME_MAP['varbit'] diff --git a/env/Lib/site-packages/asyncpg/protocol/prepared_stmt.pxd b/env/Lib/site-packages/asyncpg/protocol/prepared_stmt.pxd new file mode 100644 index 0000000..369db73 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/prepared_stmt.pxd @@ -0,0 +1,39 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef class PreparedStatementState: + cdef: + readonly str name + readonly str query + readonly bint closed + readonly bint prepared + readonly int refs + readonly type record_class + readonly bint ignore_custom_codec + + + list row_desc + list parameters_desc + + ConnectionSettings settings + + int16_t args_num + bint have_text_args + tuple args_codecs + + int16_t cols_num + object cols_desc + bint have_text_cols + tuple rows_codecs + + cdef _encode_bind_msg(self, args, int seqno = ?) + cpdef _init_codecs(self) + cdef _ensure_rows_decoder(self) + cdef _ensure_args_encoder(self) + cdef _set_row_desc(self, object desc) + cdef _set_args_desc(self, object desc) + cdef _decode_row(self, const char* cbuf, ssize_t buf_len) diff --git a/env/Lib/site-packages/asyncpg/protocol/prepared_stmt.pyx b/env/Lib/site-packages/asyncpg/protocol/prepared_stmt.pyx new file mode 100644 index 0000000..7335825 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/prepared_stmt.pyx @@ -0,0 +1,395 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +from asyncpg import exceptions + + +@cython.final +cdef class PreparedStatementState: + + def __cinit__( + self, + str name, + str query, + BaseProtocol protocol, + type record_class, + bint ignore_custom_codec + ): + self.name = name + self.query = query + self.settings = protocol.settings + self.row_desc = self.parameters_desc = None + self.args_codecs = self.rows_codecs = None + self.args_num = self.cols_num = 0 + self.cols_desc = None + self.closed = False + self.prepared = True + self.refs = 0 + self.record_class = record_class + self.ignore_custom_codec = ignore_custom_codec + + def _get_parameters(self): + cdef Codec codec + + result = [] + for oid in self.parameters_desc: + codec = self.settings.get_data_codec(oid) + if codec is None: + raise exceptions.InternalClientError( + 'missing codec information for OID {}'.format(oid)) + result.append(apg_types.Type( + oid, codec.name, codec.kind, codec.schema)) + + return tuple(result) + + def _get_attributes(self): + cdef Codec codec + + if not self.row_desc: + return () + + result = [] + for d in self.row_desc: + name = d[0] + oid = d[3] + + codec = self.settings.get_data_codec(oid) + if codec is None: + raise exceptions.InternalClientError( + 'missing codec information for OID {}'.format(oid)) + + name = name.decode(self.settings._encoding) + + result.append( + apg_types.Attribute(name, + apg_types.Type(oid, codec.name, codec.kind, codec.schema))) + + return tuple(result) + + def _init_types(self): + cdef: + Codec codec + set missing = set() + + if self.parameters_desc: + for p_oid in self.parameters_desc: + codec = self.settings.get_data_codec(p_oid) + if codec is None or not codec.has_encoder(): + missing.add(p_oid) + + if self.row_desc: + for rdesc in self.row_desc: + codec = self.settings.get_data_codec((rdesc[3])) + if codec is None or not codec.has_decoder(): + missing.add(rdesc[3]) + + return missing + + cpdef _init_codecs(self): + self._ensure_args_encoder() + self._ensure_rows_decoder() + + def attach(self): + self.refs += 1 + + def detach(self): + self.refs -= 1 + + def mark_closed(self): + self.closed = True + + def mark_unprepared(self): + if self.name: + raise exceptions.InternalClientError( + "named prepared statements cannot be marked unprepared") + self.prepared = False + + cdef _encode_bind_msg(self, args, int seqno = -1): + cdef: + int idx + WriteBuffer writer + Codec codec + + if not cpython.PySequence_Check(args): + if seqno >= 0: + raise exceptions.DataError( + f'invalid input in executemany() argument sequence ' + f'element #{seqno}: expected a sequence, got ' + f'{type(args).__name__}' + ) + else: + # Non executemany() callers do not pass user input directly, + # so bad input is a bug. + raise exceptions.InternalClientError( + f'Bind: expected a sequence, got {type(args).__name__}') + + if len(args) > 32767: + raise exceptions.InterfaceError( + 'the number of query arguments cannot exceed 32767') + + writer = WriteBuffer.new() + + num_args_passed = len(args) + if self.args_num != num_args_passed: + hint = 'Check the query against the passed list of arguments.' + + if self.args_num == 0: + # If the server was expecting zero arguments, it is likely + # that the user tried to parametrize a statement that does + # not support parameters. + hint += (r' Note that parameters are supported only in' + r' SELECT, INSERT, UPDATE, DELETE, and VALUES' + r' statements, and will *not* work in statements ' + r' like CREATE VIEW or DECLARE CURSOR.') + + raise exceptions.InterfaceError( + 'the server expects {x} argument{s} for this query, ' + '{y} {w} passed'.format( + x=self.args_num, s='s' if self.args_num != 1 else '', + y=num_args_passed, + w='was' if num_args_passed == 1 else 'were'), + hint=hint) + + if self.have_text_args: + writer.write_int16(self.args_num) + for idx in range(self.args_num): + codec = (self.args_codecs[idx]) + writer.write_int16(codec.format) + else: + # All arguments are in binary format + writer.write_int32(0x00010001) + + writer.write_int16(self.args_num) + + for idx in range(self.args_num): + arg = args[idx] + if arg is None: + writer.write_int32(-1) + else: + codec = (self.args_codecs[idx]) + try: + codec.encode(self.settings, writer, arg) + except (AssertionError, exceptions.InternalClientError): + # These are internal errors and should raise as-is. + raise + except exceptions.InterfaceError as e: + # This is already a descriptive error, but annotate + # with argument name for clarity. + pos = f'${idx + 1}' + if seqno >= 0: + pos = ( + f'{pos} in element #{seqno} of' + f' executemany() sequence' + ) + raise e.with_msg( + f'query argument {pos}: {e.args[0]}' + ) from None + except Exception as e: + # Everything else is assumed to be an encoding error + # due to invalid input. + pos = f'${idx + 1}' + if seqno >= 0: + pos = ( + f'{pos} in element #{seqno} of' + f' executemany() sequence' + ) + value_repr = repr(arg) + if len(value_repr) > 40: + value_repr = value_repr[:40] + '...' + + raise exceptions.DataError( + f'invalid input for query argument' + f' {pos}: {value_repr} ({e})' + ) from e + + if self.have_text_cols: + writer.write_int16(self.cols_num) + for idx in range(self.cols_num): + codec = (self.rows_codecs[idx]) + writer.write_int16(codec.format) + else: + # All columns are in binary format + writer.write_int32(0x00010001) + + return writer + + cdef _ensure_rows_decoder(self): + cdef: + list cols_names + object cols_mapping + tuple row + uint32_t oid + Codec codec + list codecs + + if self.cols_desc is not None: + return + + if self.cols_num == 0: + self.cols_desc = record.ApgRecordDesc_New({}, ()) + return + + cols_mapping = collections.OrderedDict() + cols_names = [] + codecs = [] + for i from 0 <= i < self.cols_num: + row = self.row_desc[i] + col_name = row[0].decode(self.settings._encoding) + cols_mapping[col_name] = i + cols_names.append(col_name) + oid = row[3] + codec = self.settings.get_data_codec( + oid, ignore_custom_codec=self.ignore_custom_codec) + if codec is None or not codec.has_decoder(): + raise exceptions.InternalClientError( + 'no decoder for OID {}'.format(oid)) + if not codec.is_binary(): + self.have_text_cols = True + + codecs.append(codec) + + self.cols_desc = record.ApgRecordDesc_New( + cols_mapping, tuple(cols_names)) + + self.rows_codecs = tuple(codecs) + + cdef _ensure_args_encoder(self): + cdef: + uint32_t p_oid + Codec codec + list codecs = [] + + if self.args_num == 0 or self.args_codecs is not None: + return + + for i from 0 <= i < self.args_num: + p_oid = self.parameters_desc[i] + codec = self.settings.get_data_codec( + p_oid, ignore_custom_codec=self.ignore_custom_codec) + if codec is None or not codec.has_encoder(): + raise exceptions.InternalClientError( + 'no encoder for OID {}'.format(p_oid)) + if codec.type not in {}: + self.have_text_args = True + + codecs.append(codec) + + self.args_codecs = tuple(codecs) + + cdef _set_row_desc(self, object desc): + self.row_desc = _decode_row_desc(desc) + self.cols_num = (len(self.row_desc)) + + cdef _set_args_desc(self, object desc): + self.parameters_desc = _decode_parameters_desc(desc) + self.args_num = (len(self.parameters_desc)) + + cdef _decode_row(self, const char* cbuf, ssize_t buf_len): + cdef: + Codec codec + int16_t fnum + int32_t flen + object dec_row + tuple rows_codecs = self.rows_codecs + ConnectionSettings settings = self.settings + int32_t i + FRBuffer rbuf + ssize_t bl + + frb_init(&rbuf, cbuf, buf_len) + + fnum = hton.unpack_int16(frb_read(&rbuf, 2)) + + if fnum != self.cols_num: + raise exceptions.ProtocolError( + 'the number of columns in the result row ({}) is ' + 'different from what was described ({})'.format( + fnum, self.cols_num)) + + dec_row = record.ApgRecord_New(self.record_class, self.cols_desc, fnum) + for i in range(fnum): + flen = hton.unpack_int32(frb_read(&rbuf, 4)) + + if flen == -1: + val = None + else: + # Clamp buffer size to that of the reported field length + # to make sure that codecs can rely on read_all() working + # properly. + bl = frb_get_len(&rbuf) + if flen > bl: + frb_check(&rbuf, flen) + frb_set_len(&rbuf, flen) + codec = cpython.PyTuple_GET_ITEM(rows_codecs, i) + val = codec.decode(settings, &rbuf) + if frb_get_len(&rbuf) != 0: + raise BufferError( + 'unexpected trailing {} bytes in buffer'.format( + frb_get_len(&rbuf))) + frb_set_len(&rbuf, bl - flen) + + cpython.Py_INCREF(val) + record.ApgRecord_SET_ITEM(dec_row, i, val) + + if frb_get_len(&rbuf) != 0: + raise BufferError('unexpected trailing {} bytes in buffer'.format( + frb_get_len(&rbuf))) + + return dec_row + + +cdef _decode_parameters_desc(object desc): + cdef: + ReadBuffer reader + int16_t nparams + uint32_t p_oid + list result = [] + + reader = ReadBuffer.new_message_parser(desc) + nparams = reader.read_int16() + + for i from 0 <= i < nparams: + p_oid = reader.read_int32() + result.append(p_oid) + + return result + + +cdef _decode_row_desc(object desc): + cdef: + ReadBuffer reader + + int16_t nfields + + bytes f_name + uint32_t f_table_oid + int16_t f_column_num + uint32_t f_dt_oid + int16_t f_dt_size + int32_t f_dt_mod + int16_t f_format + + list result + + reader = ReadBuffer.new_message_parser(desc) + nfields = reader.read_int16() + result = [] + + for i from 0 <= i < nfields: + f_name = reader.read_null_str() + f_table_oid = reader.read_int32() + f_column_num = reader.read_int16() + f_dt_oid = reader.read_int32() + f_dt_size = reader.read_int16() + f_dt_mod = reader.read_int32() + f_format = reader.read_int16() + + result.append( + (f_name, f_table_oid, f_column_num, f_dt_oid, + f_dt_size, f_dt_mod, f_format)) + + return result diff --git a/env/Lib/site-packages/asyncpg/protocol/protocol.cp311-win_amd64.pyd b/env/Lib/site-packages/asyncpg/protocol/protocol.cp311-win_amd64.pyd new file mode 100644 index 0000000000000000000000000000000000000000..49393c44d34a2f7f31a837c72679bbefd1658495 GIT binary patch literal 639488 zcmd>nX?zsL^Y?-*3CFTQS&3p`#fT9^gE0bzNEQ;5S5KXKbAk7o3Eo>nQ@uA#^=1zl=ACl$bra5axmqS0s6RW{^WB9DM}2Gl zJ+5#1_Cb6X|C(3L=Wbm+i+>$c{gkASt$s|NS5-fRXJCJxJQps^`}Ua!Mt%EA!sSx# zm4s2%4a@aDoYQz|q;;s%e|E9WTZ? z9NWn$hvUF2cu$bmIbef&Z|ZO~mn7@y*w$Jx7wJtM`2bag%*XNHDrMSx@s50y*@owJ z#JQxkqmIvMtsSk;;fwL#+pQg0Z5@uci{l+40vog++8s7+@k#v5+ zgy{u%@AZPwPPSb&Jyyu;aO9tV>vdNbT9g^34Dw zj~w8Y<77UMgX@RX|1baZYrgo^A6x&WRr-5h9`9aMX(aliP3+kp`wP!)5{mOj&z|va zoC7)j;*ABaSmH#LXrcR9yWD$tRaQaslG$MIYHd~W8GV|CnwP-RI9AX3?u?RXG{G_F zulSE>d)(P8SA(7edxgPp_9uz91mq_M!_BstNkQ$aKzMXQPPl(!IG7wiV&s*+;l2^R zk-jVah5J(dn)At=){fjr|LOj4QSuVh8i))lLGll!E$})hkI9cAIVWv@T4he!5Bz>v zzN0y5hw=aZwB1q9H}AwbqMi+ConNc-7gxHA7C?-(VDhx6=eZA%ic++klJyouF{oAg zBc9pISYT_^bN<_L4wNchgsilUQO{JP3~Q1yGh$^%n`QobOO?qt%3OjnK}{F%U<^Fl z1mA3c_du4mAbAcjM?KA@Otq9rjFm|-%RFk7ISQR6Sv%in6{>+XNK>t7VS-OGz^jlI z8GKUI^Ag|%_wpF{tP4kTi^|9G5QP4{Lx1KO4bX8Z@@Ec zd(>0*o)QOX4<%)Z0kF*gc!B`Tn1_UHVBRGF+lYjPqMlT;Roexif{9>BTd8tG)Kd+X z1+@cA&t!LPc!O}1h=T4xZM|RH7SO7qp0*;U0(Ppuuv?Q*3%|BG>e&Q>{n|Hahilu~ zQr|~v+HQa01p)?9eO|y~;#}bN7p6!a2$*N&8Dd*6?sEtaZs`rnEbkh1=~4MEW=JhkXfYm8)R{r-B@t zvBRrBJSI8bAD*0?;13rhC(;Ue{n`!je(fM=^=p4cJ(t567~R|1uMI`k-Sni;jUlH$ zdQz=7sIB#DpR?1p)t>6tT#2uoz&LmtQML&O)oa?VmAEc}}1v8P%<4(BWchjSr&P9NxO9`zi-u&>$`I@zyvUnOPVX4z+?tTTZ~d-snI zW&5=miT>hfL55$uEddSnN8=!x{%CU+^ZDWyD7U4NMqDI~pa~4M@|CY7qUS}D zoL3M*?}7250ew!GY4x!KN6`LmQ)6ourm$@wcq?vyaWMy2}015k8kaHON@6cf)jVVi5z zVX!egE`_QL6}aky7LL$Oa0QO^Z7qCsOZ7=Vmp z)+92GO8Vo4RPYJln!7kf&|suk0&;6k=a<#T3#5_GTt27-LCAh0g{wcbK`FsWe(k8J z0$oJt@F>6rHRp{_lX;&)^7TEU3*Dd!dMF9hMm_0(sRbdPY=PRUkMWR9jA{Er=YhT) z&{s~E-B(@!B4IP!MRV9U96Ih4Yw#NyR(rEeoWGTp4)&Ve|A~CNF1fU|BLK4+p6b;P zw==j0Essn)#aCVgtZYe|9D{hc1{S*pucxP{r;I_gTZ zDRB-sv(cy@Vh^KCafLo)(LCF=0NyFbgcRE8tQ;6F2(~`}>48cNrES&%DLL9+e}?Nz z%)BV=c^EW;RG3f~NY{Ck<%lPOnnkqQVP58o+89?b?z zM2|))L`sh?m;R+5-Tqrlk0ui$oHRmcvh*mOI!8UCn@m2;OfV{i9wkYdsYky(*Qg$y zB2XuaqK(I*@+Ko%Rs+&JGA9+!KJYwqj~)i<2-=oYHQTEuYX7_ zfFb9Yahllj)@*v4fc6=Q?s>9Fbf^ae(tAO?BXS!^`2(bgicAo4E@6H{ED=o5Axc4QP<$}M z^#;f-7~#)IY6r*y7z@{J5L7rC|IpE+jgNSa(3himd>Jt1r;8jm2OhL&@cA6bx`F;D zkt~*?73q)2S8i;CI7~XiV-tm7kK>6J4*hSi4ub6}?;r@<0b%VG;hfZ59^awjzXuV@@FMb&43A)Vazg!} zhBv4!O+I~bV^uNI_$bXy2*zUd+e$-a;p3~tdBSo;yaoX?M z+V{2NQ1IkOrJ%k^6-X#c1&D9OR2G?oA_Z}2hY5QjU=QD?V4pT&(*$-AVTS|OU9<)j zlym&cj!c9jFa)CGS+ekiaX#rH6I(ao z*VnhA3xNWNLi#k!BhLktidGN@vQwCyD@NS8^qDxubj13e6NL56h4t;|*9Jo3wgxD1 zb?nV^Pot;u7J#$0T3;j=*63Ctjk9Wlv_V9B80{m9xL|l%BKYjrvXdv}q*eMjsoOzR z;p{E2L)ppGj1MnArW+s7$)e=>>@)=leJM(wV|{~NMai5{8TncKe$4vzL&>%b4TfiK z$pii9Y(1?dIk?Lr^Cpt%~k*pw=HgatJ-ca){&o92?uGE#=sr{>iVT=`eld=C$yVM=1m9E?#DMFiYZ% zN)Nk>o|m)%7}KgCnZG>T=&;sPsDv$nj~vPC>07aa+6vnPAuKy59zODVh=Gj9GeK_6 zNBpwpTa(B~&DBC0;Q8(T6H5QqCu5RJ`OXLGNM0}BiVf7K8>9;7_n;+hcYxkQw}3I> z>>PmnB3?o-o01P%GEC-vK#Pt?1~r8|3;vk?I86M%5`PQg$LzJaKRhWB8lpKJ54M1= zRBD^)9s{T5{Dnp(oL!X|h&D^k4PRH~MXh>e9LcUGdr0;xT@14SBHDK$thV6I7!U+C zv4wap6XrTw@$ujJM2P^ke4^)CqhLLss1D7H`9x>6AoF)YHSDpb9RT6%x=&e8(C1sx z8cG7ve>ofe1>z6(S@5d>%|+VfLh~RAOFhCGvTO=ejD(!Djo=nzMw|6n9DS@=(nMqf z{ry01RM-|3lH2tHR(++a!v$vv!;&Ow*Ns)3Y?LYkM}cP`@Z@SAW4t&D??_OFvAs$TVN7s zX0G83BjWjyN#KOl%-_sBmMP&CX zWH}1iL=zd8m4R%q4Ov%(Y|wGYMiJRJM3$+L)jcN7Jk3PL)mb2GVng;d$Igi7*hvkW z*_z0HAhH821s$z<7%wyi1;gl00Z|D{X|4xQ4J7VCqJog50^gg=i8!C(gK~qBKE}nU z=k14qy9wrLHH(09qPtTz8QITEn?T!OvlXW8Fl|W|@@ZR4TVvRs95;rrphiRXaZt`Ol5&NdZ^?eGe}XxC+hub_u0e?vWO}xCC?Ly(Ue>NckBD+#2kf;2=(xcHnU<(r z={$_65*fm5&~aHf`%ictIgY{M$$xt3f&|0Y{hFd@MVkYUc;*v)<+lP4X5nXn{ULuD(t;AnI|M(|SJIE2he=`2QS9M*q4)(XZVmLas6kfE1SH zF-%ujGwQ=w7DS~H&p*@P$;)829nyh`Z_Cn3itisHzS3AUtmYJHzv~y)5OKPrcyL@Z zhN3@@sa621GmUeii02O`(cp7{kqJsu@TGJ)am&0+b3Ln&tui3ZLGo1_vY$93hpnGC))}pfx%n!NB_1W7pqT~ z$c3-;M_`8`+zh8&KNSdTPr_Uvz>sASF=|-Cs|!f`Vzm*Xa817548}}Y)-Wr!`i{GEaq+0thLsJPkE=LX8d0%yg7cA*EBn6kkaW2!i!EGF*)hu|QGb z8t>@UHsg^+GOS5?524EWa|EfJebp})bEF53hT!Uxjy}GLQBgf3Xyggu@jj5U`FOJkR?ORk;u3vA!lT2l(TeCJ9HiAgbN&M z9ieP6X!0$8jvdntu1`TTt+uus0ADLofY+LULj|ycfK37DE}Dksa2_f#qxVldYkqtI zdrxNPi1+0AmS36#9OZD@Xn{M>^s2!Dlhe%BiJY8{@-6oh=$N>*&im08uDNjfd5#&9 zH-kbFhO`BRo&a#R_O~xG1Ow<;)U9S13<{y{8;EuzC~q*3shH4KHItSpv>6lPhYV(B z=!f&_6!bVVQkgg(oH4$81;Uf7vM8v7>L`q6oCh_}Va;cvLAKfUFJz4+QG4Vw7UtO| zjB|!H5wMz9g&D5PzKDf+dLmFKOQDZ+K`bX0=IK5UpEWO#D$O;BSz1y7x>Hv38r9mv z_r^K_i*v4LsKgP^oH{a3g?W~Ph*}t;q;3k43iI4Y*{Ap7e1BIg%=0WoA>6&G(8PEJ zJOajfZh@`iFj8D1Ui@ag^^DW;) zwPDx{lCvEPw`QORa`g}hHUd4?aDNwBsku5y8$9tC#7Ua?*WMP1huJ%RPM*%jqw0xiCz%PTaliVP_-55SquDzTvF;!HSxEl zki-K&ks)R|2{B8knDgkohM}HXq==kiWh6H|v&xHF_0JC(9F<5@$e=9SDR? z_HG6F^bRdoD__{_Jd=!)Lt*r(+2rQ#DA;a`%lpbR%!LfJ~CPY zJ;TJloDWLD5GN>a80c9kpoa@C7m^2w@qYtpwOKY5T8spHpl8uh(iBsvS;z+Z7f(T; zM^%`H3Xk9a1TaR8?SYSE9|`^V;JLfu66{ zsz6WbrRa1c(39m4=Rj8_uv3jECuh6xWMF5T_!!}w4St!#g(_>C`L$4`c$TU2s0_Q{ z@HpM`bdbovPEZi5z|OKeZQkIW;1dv5D)n&}-9yb5r|~h0tm%OcQ(zm!vE0sf3(Oe> zHkb<(%r=4fI|id;UvUgiD+NPC>n=*BW(uAk>@a)h3rW=iBWtMw6K^MbwSu7o>n{42 zfrkN^OF=(;y4x^4vYgo5O4!Hg-!Wff&d#3=l6v2I9B|?xAl;WPg(!&83sXh_i)>3{?=>!QU-pTg12Z{K6!9 zhB0LS6a(1~B70LIdr~1=Za}6&Y=~^B4cQ!p?Ahaxy+vfZiHy5ELD^u1>}C_05s{!=F|6m?PY z4ya5_g-n%VyrUZFS$IO__{aDLHhMC?u>oDv3yn1@)&Q!igF52HtG799Ml()DeV7{@ zY9n)l7crOdl?+5leb8mf%H$rP5C7C8wrR22lR9_J96;FJ_=yXzy~N=dg}=-37r>tn zf4%Y71Aq78?;ZT@z~2%4C1oHVe|8s^{%f}8{A51Iq3yZYt=Z0}H7TyV%ax<~nqiiC zSF;@L@^}U|IK@jfg*_W_kBjuFh_XPjWR1KlngXA9TrZd z{Q5@BuP3YdH6G}-sHf}QWO1Ee6I}NB_3+x+@L4XKNvnkJWpq0PSz%XZDc9Crv=%+$ zk8b5IkNf&brJiueRv?=N;K8+JDZdGss2~Ua%LaKmA;qy&z(Y;oT2ujn?hH4JbWozq z*>=^{bjh%NLci{S%(fFsp9c4RC8JTM<{GI*7=XssJWo;!e`(?_V#H9r-7Rm&niNbA zXoC}=dPnzziozqbNE)-YD257p;m~eMLkyoSgR|HMnm1Ao+6_HZ|S?J zAUiT}9JKg?R-(mOaIbZ3042T_u~_FeEDT6bDJDU6vS`}19q6%a%G6zQ406vrBw#C?`Yn#;ori6$c6_G|AEo1e(?}Is6tN$caGm^yznlNgT_G7HZb<% zkIj#!U+r7oxf4XO8w3U%c^Yi?_x8ny5ahT6j&-!4uOAz};p*Bp>%IdZ>{Gl|lmkmp zoAsU$Zmt5-v)1ZDSfImZse1t?TNMKU)ZgDnC$vs{?`SBY;%YS8w>*_~^ZbX+RlEY_ zU|!(iXJmc@f%HKF(l+Ab3p4{VfWT))=KfiR6!;(ptugP5daeR&wpN!@9KFLtpGNdU z1$}J4{_ns7_ZwjD;^9!hU<5u`WW+9iB)2;1*#RUNHhN)qX$tlf-h*mFouFnvLh7I< z1L#(83)U87_?BM*{I#cJlbN0)6993BiWv#^Egz0Nc&hKm$2%&nMGBDY+SZa2m+)9@ zOaO<&Q*cCJ5y+wE!x)+JXn)3pC0kqX1J*tLIaI;TPJxqz5}Qf= zf~nqLGgx4QA&aei%U=TtHBSkvoF0;e6Gd2e2xW;xUJ%r7;mT(g=LeYXQ7W7B+a{Uq zQK|ydfomj-)J$+GQB$>}ArbVRv~So$$p#Ygz~m{&i#w>elr z=QK3aw|obgbiHEI?&g?+FlKI>+C2(JHw=0eBJH?&&Qt-cA8@~lfHJ4iA!UXHeC-o! zb*8PyE@WA2W_1=m1KL`K(9vO3^1?NF>b%Cd(PLM0fK4#YGkETw%HB8#afx6IJVC!) zb0_e_N~9V+!`*4WV8yTeG%xxmtokQJzA}i2I@Qqx7>fQ0!b7ZO+t)Yl253+lkfN3= z^j0(kuoaNg(CMPMR|B9H3*jRHg8l!xA;X753?>$^=5tVUL%wzswA`O|1b(ZpJkM$LvNPU!t6UQ^<;LaCtCcO-2{(u-rKs$m> z4m@jM?3{TI>vzHMZC(lg4Z=P^wf%cBm-WK8AwGxhAB6P}m0XNubLW=!zMK>c;z?_l ztu2=bUbufRV=q^@e-^`fOOWXg_s0_DjMVJ#j6SFhjv02K;q;+__I%cc@^1_1ZF#EJ zd^6iE#LUPiNC`oNs7Yq_f$5}m#w2D}#o){K$J-mfOf@z z*e(<3UI3vr)l3SPNe*DQ;WLcWm83|M0H%R+w8AM#n#*-NNX$6sF5;34%uL7wQS7aF z<9@i3BgUy5*EH9AYhq!^C2d-(uw>6x_ON7T3O>!i>y$pN;<)*(>or z?mmmB%0xUh-&2uQSn_PpC%exUDMTtP`6t^zSKXN;RLKdAmY~WX&V0TlX^L|9SsbI1 zyJh{ zE3qUU_56!mww#LlrDrs*s+-y{6G_4FdrYd$Ej>VYGvZp7PTU6tclr}iv}}OzY$%CI zXGcacPSnG5k)U?&zYP_J3yCfp_GAu=MFvC*>kuhBrzMelu6P%7`Ny;ccTd7(%YV`) zY=w$A-@vhURD4fYR8ZXlg$hwa#M!)?B)^4ZznlJ+rvQg&kg=ce?wnOM?-{`EqPF5H zyE0bB^ezvgEz1FYDfO}Cfb>*+ntIoVTA(FOfGD3>@Alq`Rw;?5-YrC5gOppUExmgK z?H0W|Lm^UnH(Qu;0NwpUWo$WMRSW7}`fIC6leO#fTIwkEu6I*34Fm40-%xZZ3hp9q zY(gX*ddFR#8xRw0WIEv!D#bb=hMxZ2(Ky8Duk=+MWUtM}e8wgT#q1}|HStE(G`!%C4kxRP-XL6A)3e8OOcgjosGlq0?b`F&l(+=}rCt zKNXTpBB=!LjPGCBNlBt_&ga~~9dUI?K~gd5p=!B{I-SHGbh*l7+VUXcHKHw7J2@hl z=btjKz^AD#Z8(5wNj-1)ciQsN%@mo~D0K}*4dom$S8ID zikPoa$g)oPSVlQeUbdg7KwwdE9{(v+ETzKYw) z!-wm4#5fQNF7?ePnI8QbJ{nb%wNnWwYC_$c_!o6A-&b)rkz&^vGM!(bMoU|!nCoMP zws3vSt}WjK+R~O6fZy7(oZj5T|19x8AE%aVto1QVX+BeWvc|47YrIsN(l295Lz3S+ zVvzhgQ4R%4`~Kq*poZ#b)17|8K<7z(a0DM{j^H>O*7yjX08r5#8NHvNa>#^3&W2(1 zK7d9Vx>Kch`09Aw*-9>p?u--NDJQ9qOP9qa&aVN+t~<|*ipFLD3xtvBYwN&Wg=Dpf z#P|;J`&%N7IDf)LE6|-zXCozJiM1nKwvn1 zZnPD+W{osQXws=W0Yi7Pc9GR;q)C@FbEFvuL*K|qv-2iW85?P)|4GrA;Hx-F)_I)Z zj^%T70KI6*Mc0c8y)gcSDs;CXHAkB3eHHP^z}8H7?R*M+v2^D@jWjO-+R~jHfY=&o zfcP9Dehm%%-$$C_oiU}ss0CaX64!X(vX3<9p#BCUO*`pW=MFaVzZ+@31E@99Or|>2 z8);S{KQ_|rmoD5@Z=`vabwOLaWsD#BDzZT;6n)bnCc~Lu2-eoTMvvZd%cr1>U3(^o zlE$=WFtUMS9#9xa18n~QU^2e{rU*RGPK!8GWB_uV*%`iN8+`BLdBce7*clFP+)}$XuumeMS3bA2>qkI{A2(bfQrfkQoJ2Xz`86p}C)~S=AD8+32c*dwnVu9I z1?_rBG-hk6RKK!sUbF6mHbZqz1df>gq_JviaySG9)RW=dcy(YK@;jZ zLR}yvIGwDL{vWLWtVHqw)_*MhKbeix+U9R312mU=BgFbI{(|z%aFc2Me*;mJXPk!I zq9=V$reTTQa^JQipGpOZJ{9Dg1af?lv7q`L((?=j$u>GIl_okT@WIguF{`PdZ+}4+ zhAGg8`6Wl(KS`!B)4v6yXrS49xmu@Gm6axu)%4XgE+!@+|k{yByoSiRf-kE#FJf*#9F@% z--k%B)E4(~&>OO}`cY*2D%OFX+UCBBhwv<$3Vwl$D-N<#s-TtqF{zOa8#{GJcZo|i zb~0z-@?3}GSvZ|r@timud%f}OdO4LCOC!VV2X^M}D?uGNBApfmo5N~D9-j=kWNX-` zzC3w}yzb>IEdj#A+1j62@0tjfsh}Pt&y@%wv0_wE8pm=e{L}fv3k%0QK)mys}F|-`SZn3@= zJt?4FhBfR3#+k+@xmv%xpmEh!APUx9mLEhe+Y!L*M7v^=KfFlVf{-n;>qlqU=B*C@@frD=>f2_n*s_A9fdS z1+_I_kYt;&=?MfjHl^?rcUZ7RbbcS{6`6zXxlMiZS*$+^4$Lr z&?PlaQ9QjJ-0;m3biWnE}Z17vu z9J+=?I^VpSM1hy}_WH6))YmJZt<2T71+~Dmp!OwIAqDuKzYKkWcP}n^3uxN|+U6YC z9K8=hl_n*-_6a55!tX8JEtC|KlG98|df6$tNl}s>GH=%{W@Y%1u-BP@U<_x$ofPXrz3a58l>3$WFY zKu)+mS6iAq2PFbp>tuh#ho~HmHf5ZBU@TVUIS3D7A4fb{GATu?dZOKBv}nHaZ;dKy z5UdKo!$|NK{!Ic@?)OISX6A;0ym%w67Z?ci30wzjl>BWA)6h0}QZc zIGchk1^IY6g8YIj;m$r2SieqPiG=z!DU~zN=*NVzw}gzOb3g{7SwNhHFzuXb))~&J zAgNsqm`;Epd-unqbTA@Q2MiH9K=;)HdjGurT4A z*%Tpn)blKRor1Rk@U{cM0hDoWfM5@EGdFV{(n)}f;kD_a4 z>&@Wq;&fQ>u|*E58F+gW9aw^cT^`vmWJ3YRz-fL9Sn~l$l`a;1kXST~~oa;heXO z`$t@59|+oFpsfYJoM(^bE`~!s?Q3vkuiWBrVSsl)g+n-Aez@T5*i8=2i2|5p_*RR| zUKF;%FyD=ms{T}+1^rc3Ek#u|y?Nmn(8Y7vN@{{Q%PRkf>$T1BgEydyaM+J}iwCBV z;q0wmp4<6jE!=-OkH3q$Vq$%ZSnow!Y_p&T&{o+EMRTrPrMuXC&2{rW8t+f_m(~k1 zlN&hXxtxs1viWvFl)&)rL}Nf-+IA58E9vM{rM6lbh|eY%h7Vu)Mqns=kCbRRvqcs0 z@~8}5m@?lFA?f`CQ9}JRs2}ts>WPAJ>g=TD!FyYYU4eAjZ&o13{t63%%>x(Jh2oClhPOc@LoQB}e@^Kd{i8ah`h zFIyq9&?yD1d;s-RybVis3E6ulO;IL#ZuVW*gP<>eX+@TRo!;734t?|*&da1zFo&C& z>@BMhbZJD_4@Ir{>Sq1e#{jnG(R=fZ_8Vn-vP>IRr#XlH*2)oGNcWWeZJ=H$r~?Gs z%kU8_9=t^{=V@R`c6iF{f{`$rU4XbC7fd!yI_|l>l6BEIn#fiQvTKO!35iA74f=Wl zcEIUhW}l917;;!~*m7`hz0HEdo`?k(1z;f%WSQ}2If>11J_7cKPElsOVzAZ+W;~8o z+>3Wuad~g2j5zn`)d7#Yh#T-5TDlL=3Uo3IHjLZ+Ipj`;D}N+5;}zA?7F-*ejmbS$ zt@MYsv0oIXN-+}~^uDk%$`gPY|B`}5GcNNVD~ND~Q~|~^{=pqQ@O-tbgs2?SHZhJP zM$4`5C}o^GM^MU+1~ckHxP_^ILa8~L)+_rmskX{~2kKF%b`rWP&Y!WtUGyb8rUW&h z0iWxaY_%Hlwxo@?8T+&(g0msIaET;Q{tB+K8G!}BN=XA|F6?7KzY{4Ono^@Vvjd1! zXgTXqBf5`c1mw2n5)1=nYkr;e^uLx{}iG z0i(ay!9ZWOL5gf-ky^YO-|P9k8{bfz_7G3_P19xch2In%4g;!+ttHs|ET$-Vl;2CO z?}zxkNTJzAu17pQOf)4#ql!HMuv%R9eTYWEup~#w5^nfAS#OSoMx^$QdWMtxHWzR> zx-eVIh1&xO0B>&Be_pI+02xZVH=}M}`On0Ey{~*Wo@G=d$%K&`zQ@EjRQ$PSz*n1N z>+at{WKiq=`Y=9bacF*qCk}h5lVf9FlC6z~pSo4Ki9mbw8`7Thl7Pbjlp>=3e1j*C z4kS9Z6`n!t2IykcMu^mg8Izeo|HvjYc>;`^6&fJPQt59sOixkiynm%$r3osX_o>uN zuah=22zN1jcL~CMuFp74Q3z&_MYDL-UxQ*RQ4DS8wJP<{y~6Ycx5hn;w1#fqT!E|a zF-;M;262=;B*MlaD!?h26&1iX#@Gawo>PL{_hyd)%GD0Od`#JLVZUU8g}u_+5udhS z#`015u;?qV0KMF^IK;e@VL;HlP8qiK8(3Iz7~4cWRRCp#W~b`P_ld0v2qHBjJez%o(H!^r301P*SIIeJIK79^WUcqL zpnlV!_marzW_{>#T28gzr*4oj*ZU3+Xmmwl?-14|V>zx{N}sLCKX*s#bS{k>*!_=0%^|Q*eZ%MmK<(MG?pBU+rhcyV80&x7+~dc zWh^;V>GLZo$Fk%gf{Z1HuK_^1;23V!!I>kJcvD~jJeYT-M##XmU$TqNLu%SJH!uXEo_c{2+*|9u0Fh_IY zPzA7pkgKhiIhi@~Qr>z14g=#Tk`i%k!j#oMFh0=^waAcOv774n2|5+)odInp2Z$>f zM|2neg2aliL^KW(=yef|KE)f|MR(&>)H4q+khgwM#?-T?-byVPzR3wtOg)pH!KbO7 z{Q(1woeYVWZf{gVe+hzgCHP!0e3U(m@wrrlNe&#m4+c;@)6Y_fu%jCL?(Siypq%D> z{fSt>=GncdF`RU|&}3cZdn3&s+gd2ILh*yPq4#cl4uj zmXH+?MK8?I_RmlT>zp9LZiY@l{g|~DHdt|BdB3&_Yi$8-8@yv*^zxx5ruhofnZ)!0 z45F{(C)A^FblWhoJXb1=HIj()rVH6eIPkhj&q}w}3Hm5pPU6}lxN3-t_c7L^%36Pr z^^b_N1Mp!Pf}B*#9{L@ZS!jR!R2usYCcmYpbt8$t5N#I|ZNudUx$l>l(Pp$3ZPrU? zSm+*6=++b6FhTb_(d}##qta}zRla4|DnC+{U&itgDgP(SKWZzF3wXjq6Z~O+{0QH0 zMEg0z=Z>>*9)eBNbieimb~aZBcv5cCt^mEsY1@2};mOT{;prQ2g_JCo=BQ_0j`l|| zyfj${4yJqg4<-Y+c#8iZ5tu^ z9SoYgRYnanb}}Q3+Y=>T4!2&y7S%2sqi9-X%UGy5#5P-xfOCCo! z()j4u6;z7BF#?b7G6puv|0LUVvP}jHiRa!7a?y~=fo!$sNUsx)hM#8>P)5TJ=epIQQ2gPh{tQn96*Gq7+Ql;;WRlg3H;uS2eIS+#h1lxVuSE6S! z#9x54w60sqY;#C2~rJNFhpw-&iWo&#VWOlIFJVa}GB zSpSr$=VTN|#NRDt$|n)L2XSlty$Uo8uPy4S1w|IvEd*-`F!<$uZmHU;Z+epr7nT}y z-bo;J%q4a%XEIx(+Aa+pgKwLL^K-*rU&qOE%p!GPhEH>W^`WoCBE6sb?<~@#zL?l>fpsrCF5=nn zre%?u^@Bwkf$8*33X!r%pMz}jMsxmiU(6!;Kvgi@{X!7I{U%soRrfZ1L@PmueWmo; zX5I0Ia27!BqBoEh&~jjscyAN!XCn^#qgkv@3@68nULS)g{JqKYhsmlRaKOgS(=X7d zTy01^7>Zw{I1A!Xa0$kYyMd&j2U__piH|t%8%8ksMT+a`!E*RG6-5>1$B6kzYfH>z zHjHTLYYRo@cCdB&Pizm`7S%bB^C;~9;H23C=Z`{QPFx9d! z{j=S`^a5vKR^TvbVyZXnyNehMASMpXeQCz&dqAGPx)e1tHq?DP-@>n}3{GIbCIq(l zxQjo<8_rvSF*O^cm^liBxuF3(djw_OMf=fqi)WW$ny3!FxQlpCDQ4q01FWDuo$GFd-pNKNPIE-;mL*ym~9DGf->r+SPt6JWofQK|kvSC#YQ{hbLuAO_eYDh|D#J zsL&u!wNB^GF?qGG>YhuCa#bju_UO7m_<}&;`gm5IAH*v5GRtTUA#i-=;C^aMq6icM> zYOA6jr`z6^@5Ra0cryBAKXRTdWz~t=hKJbO8Lt_R;RUp{v9L*ZFFs8(++>$8)u9<) z1pk@?+#N4*@{d|!hUZ9{d41lV-i?~!1dwTrh}htp`OZ4<&X0K)!a~_A*gibCygFpuj zAb5GGz%_Axtdj<9#aIbVbv}U?c2YZ-7fiD?d{V_yYB(81nQL}PPo0(V?|RAwD#bZ9 zj?axj!FMu|7V$jzlGR;R0IRuA@Mdnm#MWa^fg`f2EdH&td|s^Ep06T3>3`rs-RLaq zqysQ6@&sdf{SFz-UtSy%^^B*Wph@k;c`HjIC;m1#k=b1J@oeS})a<)S$LO(Isr@ZdBMsD&%fp@U2B4%wHAeyq2q9SpVQ60(Q|Du5eavIC~|I zRaWMP3s!pdlBG}>)3Y~N)XTtIMbAtY$gHt%DBEs@)_nZbT$_qHaTE7j)pn>7Mo4L5&w6IV zl+urA1xzVTE$c)v$uaxin5FK2j#8>>1Y$^OJ+Ns2i+UDbtlE|plO+KfXy6(oxJa_q z1zW%lPAa>bY*8ZNB@I^?^Gw}hXX z^J+Y-7G}vNrXB%9AG4^BXK@#kv=9z)olOc+xyD56F_;RYF>)zAavq&(Fx8=??e%qa0>Wm1b-ZozGXk?SIsAsXcH4Rwbb_SW+b>OAE9*vE^dFvy zdBw$VfE+cT|As=~iQyU&~7$Kk>9ik#>t38vCT`d!*RrT%Y07?ux9zw>1&3(wD>eu`%TZf@_)I ztl*sR55iUUHj(7%UvbAt4t9nSY_bxYqml4$B!vMuJ$9RyESfwyM*8}+kJ@OpZ^|> zew;N-ewm^d=e2n_c`B0^ZIk@oM7CCoJq%)>v_O_tD{hx;HIaP-{P{6im{iNuu2=4g zIdA{E+wibmo0aqCrm@k|k8Og7y;S@w*Q?CZl0H3`Zq|v0#Sy7&sHhG@ugBO?5zn5d zsO@S*>;P6s==ENONR5R1FI465JBC7)>>H?_3j)LGcYp})D>HwG>=T#~biBK`zgX|h zdg5Ys5GqB-Um$7bzJc;C^+rnbm$cuyfVJ%c5?Oy6S_W&Hjh^*Y+>9Ap%|!Yx)*|~s zX_Kq-*=)FH##wwc>RRUsS}|5!);m%Pv^j$IPNE$J7f`kjY!ej}CK2uv3vMRidWc8q z?8j;wu0=M!i(m*qtz86PEHT$2&0Pc+AV0Q?;Hsy{EiCrMmhKW*6BheOOtwXgMq-u< zFC>r#>lyX@AZ>KMz{h{NncyA3TAK+nK%E#2^q6seaUlR=n+eKPXY%}FEckabYm;p< zs+XQ5Wyk0VT7&8!z?g=In-=;%&w65QJWq&7pYTzvtCtW-4UnMKgRSH#Ox`YDrtBnm zuRCHF1F`lLU1&xdicgYKu0)iAy*L*WKKoRE)E~_q6w zKi5-b)4kAw6YnK>?mV=@+DkBq!VvNBcc36rV!bAT1+tf5r>Fof$mL#wOV}y0mmpuL z5|s^Ih^oR#gM}t*FF{ADH&yl;QO_!U!ebOdXdw0y43;!=FF`BlS0kaxf4Z@@n9e-4 z4E@+gSht@+gQLV@3B#qJ80^}cEGoO9(+O4f1wk8A*#ShGDQN46b_`x+`#_QyaPe2D zB^@oezX*2`;Na2SPgXWm*~YgIEC#5xeV_|;lEW2PVr(CniTv31ftMav+_E%cENe2h z4?OT;jOZ2=-j`^vZP9@qgvI_JHub;UK5z`M*7kwWxe7~6gB01`{1x9YdRg|Zoi ztAxh%hk)Kd-I1+t4tJtC7&LrHsfRo7lK-~BP_Ku&#{_jc_V~Z8+g}UVsr_PNnR&n)rSS<#q zdFs4M@A9N-nqdw>)l`RbOt;?c;+)_gc{j7ctMZSa%)^pb|sMM9i; zX0o@i<|KE~_h4gTO;haN<_ot|enQ3;)-^-q4sU*~ltJ!5#u5IMiK`tY8u3m}@#)e1 za}Jgd*7bmzK`c_c+v|I70j^CzzsTUdFMbz(zPfkvGB`e zp=Y!HB?3nbVZSPphkL2NujlsPh9+{8-R}|>rO$$}IzSOtKY+gSX@_ws0&YEChlIVr z4R)xDkN@goTzT87%DDJ=65zE1#fPU)w{`d_zz^rDk3Zw)1owhmMt3bUa~KFA*YhY8 z63v^1w;C=G7;P^_+iUv(WHKQIQ&70UY*Ui)Z<0;dA$G z@2C>S&cV4v0GYl{s2nGYy;G1TcQ7|&CKb-f_E9eLD3@4`WwS1eIguBMb;Y)E)-1Tn^}>ul58Mif-1s!m;`{^12!ooj_i*L|bk0+EcMZ$?IjPNL|!z%4-Sw`Z#&L7G+K- zuLGoV=T0Rgu<2XyrsP$%{Zq7ERN4eZ z6ZJ$WsN`D%d8KVFyrWMOp7wD*69au1Z?(9|*SY8{v-G`ugA#dRcRPX-kg*35kkXOZ z@Z~GH1BB}1K}!Q0-tfNiEV+wggfi-wPMvourK$!Nc2fd>vVgyeh5s>0Z*+=v=uD_A z0&w~8l*E?H_>4_L3*Nx5BF-eYmOll8Y7XF4%Y~czWM`0y@ZfYK+ywV6b3B1(3Ghn< z<_aCo)=a~S<{DHWy!bm2gwddNKZv*5Zdk#NdIkfT5fmk!_QZ3S;Q5evn&K5sftHg9 z)oYp$qtpBSRc}|pQFo_p^!Hw{>VT(}!~O8eTBi{PTL(7V@U4Fx_+|^f)x`I%7*J;~ z)QT-Fy-Nml}y>IzpU;-c9 zq?^pA8X!;;+tB?XxXC!=bd;$Vg?b7Z$9WO+C9(c`WdSjOQechEuhZ;??d1E6XmfMw_(SolF2M<5$NHkx((Y)Pbc5dkFn#&DL;lzL_D1cYym9b z5oq`iwDGVuu`#)U0@21T8J zc4X_m7V+ml)A-LMS@7mt9{+(~gb15Y8_4wFb+*dLpv zHrHA;HP&+$n4&HHaVeIB4d}b2KR8X1tDG1~tOm}S2Z+Fu$&aNTXK@m_!Ty+Wit3N$ z$#bNtE#&ibqc{FjN6chLU}svxjzBQRq2I97?1+b@J@>1Qxc6nVBX(i3YIMYw?;Gog zP9#=3;%{3=v_PuW5!l)OZ#%;9cmCJ@XblD#^Z0}nON9O^TYsdh2!sB?z4iLz&6m(0 z3VPe|{V^0c8}>&ZsmFP!gV`U?xBfrq4@Bx5`WMfc{qd}{=WEp;f4yk-$8>~LjQ+^v zt&hhk#{FkB)*p8u_5Ywh4(HhI)l4wR7#R{)ye0IXaS`;RT7=g1fSu@R^+!jv z&4BI*Xl1Y7mm;uNmB48nVu;z@*QFl2!Rpsmb;$e4bEKf9Ah2r(m;{BH#v6iUCl5Y2 z#ZEpQ^x{3A|JV%J@y06~mQ1V{!f6iuqG!!cdRrRV4P?W5jd;QAq*e%L8J+Z4bz`0M zGiyH1dVPjetCRkd_2TbK|8L{TSEt$fXO)nCBm3u&@XY1xtj3e#dG-3|uBGT71wA>| zKO3b8`o{~JYs&a#jVG*7+AXdlIY6j194}bJ+P2=mQtw+-8JZKwIOe|pcJQ6sy1#*CMn7b%+xims>;S4CK+;CWW7 zx&G*=4EM)#V|oqf?u5R?W|l*MwqoF$aSw!kpH%3S#yI4nn%*=Pp_IFO$lmG=%FE~MPD>`l!*A_IKUiouy9S5b>u#F;=ca) z=Dkv8N`?Ef@RR5X2;pK(#_e>F-@mX@olDJGB)zeg0c*_D>fmS3my~|kcq99ia4W=> zCzEHpYH`I6-0y(;LW$6s5X)8KXjiG<^Lv5q!5A`)g3-_Xefy_@5j)Wr!iE6@uXK}N z+?$43`o1~%wH-|Fy!vl*MDs$WbJ+=l{e?%H6ing<9Q;P!#dD<7+!W7<(+@nXBo*b) zV@|~R$XzNa1;I8yr%dPv2;li3wR8dS!M6Rpn2@dxD2#)7$k$VM89c3>9`$S%S(O3B zRr(5w_)2O3REz08cIX*1`-yCNcswEzi!Jc8OG^a2R{Gv`x2oqoM85PYTnjBmtF|4` zcuh2&6dEtr_r@gWGj=+OQB=f*Ri}=RneB%08|(Mx8eFQ%!JC_s^YE0b@NhE|mI@Ht z31V~k67~SThvM!#o{ZvUcp1(M(1;wo!6)+PXg?AFv(w4EX7qKnyBW_pQuKAXTY>3} z%JccQ@#OfyZywC!vr?Xuld}rOql%9c5WXDA11abgL}c)vCm(5kOq59~2XO36?;d;- zdo2zl!B>&g6Gr0vzBCfH8+MdTh0gL-bYlM8OR+Yfk2^~CnUd=a~#_B+F7_~ct0 ze}5EhV-%KvD?#&*;38RHm(0+~e+9{$E{htfiu-LFJ-$ir1OdUss- z8#^qKD8>fCqmd|F0$zit1@ewvFL_LMJ zI&PIZjEiP*hw?)7YrUGDMir3D_NpfErPyKer5hY;@+HlNucjAiUXVP8c+3cwUCsw9 zeCt7>;`9C%CcfQpoQdyyX`JFgA@OB6-$oVaM4z_By=XPQUq*3U;VH`znPsia<%rE( zKEt%>T!3r4(5>^kv%J;s+fWYUDvlI5b7B--$tO~a`}wuo6Tnr`>tnoG*ceMs7pk4Rp^>tmtx8`qLwQzQ zg-?P3i+T=&RQcVm4+Ltfo;02A8vMIMvWMYP)@pUmdU8A?JrB)MawXD)Tdb_(mQd~lSA&}#nMFc@XjURnr)*}63>csH2Mk0CqC5=hD26s&K0L416WL9 zoe!FzvWdc6oDDY3`POEJsr{un8K!7_?sNbf=KM_nL_LY0A6$(asplgB#I=TdLA2-v5BIUD%kO1H$u@Z>~=-q3XJ zkLPWt&@3GB&;BY=7J6`k<0~)KLnWr@wYLfv1m!fKw9iN$B~PF}*!OCzr4}yV5}n;-N|pXD1_la#2ce6720_R(wK*v4b*_~LU_XE|Y#%z!Vc@e_%CLPUJXf6U zszf7gJLZV`^Kk#o{yD}ftl0hmAO!<)`r^=^b6$p#!+!~oQao@z409~bTJFIYTx=X| zSy}jyL< zfD2l>myO5FVqj|R6?pUG&5y-8LN80K?F*>(glgfBj8E0Zr(%8(84o4&*J3#kFCA)e z38(96Cn%11X5T}?vHJfazRM_vJO(EvvZHU1SPvx#=iz#@$M#Wqr-Uw08x5Fur(M!KuKR_SY2_E z;5*8FmT)uyyIA=H8A)F@#VAy?9u_dz`zDC<3cRIljCx)bx>PNXh<#j;yac?VD^wXCdU8Ivj$a~WS#hRud5~0b9}m6;Bex|^wC=wSXw7pY|H81g zKpk7fHYu9oBI66bMrRMpi> zW7eZFi{D%|r=kg)bI4uv67XgBzNwFztN<|?02e3Qon4m=$CfS4)qDv!o8|R?QWwmq z>SOso2Fe$--=Ij5Ag3#(kDpz z;}8YqMBDbCb`U!`6ymo1ffRv=CuJ&iL2cW=4lI#v`>!cPYTN$B(jf;h0F41*#@V%v zSID;g%Y-It+y3d4UUpIw8U1ko`($Hez=(f9x@7?5fU~6Af2%jNn*Ls0lriUOA}M;M zzKPBSd7z>VJFYjbvkeX4CGO$?_6hty+TH^^s-lYf(21QB?%#+ND!n81W_qc?i!knqR4)~-=yMcLc1C2aut1HObpk4rZXI;5E&`I!0#dwu>btf zk^9$VF!$L}=_1@Wch+fVEhrXrsto34A_LCR2ParmxQ%KD3X{gLv2pGG%vS zgG*OZ=STgIAjJ}Zwgf1Fjrn_s5Ta-ah1Wp&1&aMQlAHgGaQ~Pb)o%O&p90eBZtlUM*%*=z=bj=GmXSD0t`l1mN%DgTn>?C zB;pKBm5P|jhUhk{S@}c^(pG|Bo|nYm7?KW_2FODs+3hNO{1HQU8}Hq zY`lyh@!o=HNK`W;xGM6i`-SZzsJCI-0rWjkxu=?^Q9o81N1@k!;_kKzD zyny=o@(Y;8{3`nUeBEN*pZ3}tcO=Ld(6RtP+?xO>1MWU1L8 znHm_Upi|VqSdEI4kQwm?j*tK5Q%T)5b=T%JkWq0yDz{3j(eXBn=AbL#+#rLw8K=VA zCU7bFj4bdaR;urn5@lG6&fiYkHmoOeQfiG_=1P3Q0K`(QYW!Gbs z>gAy*V5yf)s2=Jd1+77W3w|ZB^a!Vxc`L>ObY%LoBQT&y<>U;I&V5Fex)r6+iBLMC zMp|VW_hVv4?(V%M9vVWl1hjN31-XDku!sUdEklHY6B?qR3(xU&@r^lqsi4 zz(27l-|*jCjh1#8B+!8bvd9Bh)f-(@p@a2w$ z2SN#YZk0=d9w$>$f}Vts#7NM9hl#gp!&TzE{5J_&4HO_jlTQi*hy)oi6685tsRUhu z0v6wH6&dyXjU-!i7^!~-Md86k{hLqVi%1W7h$9+sD^|BM`ryA8xe&KvKQW71^oq0j z70{!C*pITAzGa5K+5R%_qo)R>;<xDdctuS3c^sZ099}heOUVBBFwZL#p~n1qDQ? z1Y%5NVB!y2u6}4?es?#Ur)atyO>pb;Da29)3t<6(iTX#97|BV^fdPmrVS&0b^4Va{ z$yT!Tkf;!mrL!@Sf$LaSj|H_XVPtB)xWd)`cS^`JZgI+ko~# zrb-OxXe4t9s8szGE{qB){ z)gvORjbQR9s{2b^-L;YI&F%`r7mpFu1rHK$)rN2WRa7qqG7#18es@GQJ4RIRFe??+ z$56l$)w@tVh}sja0kI+|U`uQ*^X?Iftix?_)y7T*usnC8lrnZAj;*pRW2eQD#x7PK zhoOW^9mTCG5@>tQ>QD<7l4r`9l?Uu2FYS^ue9hP_Rrcg4ah1qEcAu8(irGz_P z&0*3B{SH~zGWk8LPfmLAH%BJNO00f^S?f_HlT}6QR3eja2}z?||p>y*f&UtaC`yh*r%OLY8^1g^KaKjU-} z4tw3<=a*5`;%NGXsME4AGXUImj3&G^A-ElN7CktztT9uE>6Zk)jMFa|taz^62dXe6 z;%R~>MyWBR@yzRj0ELQAcVN6a70T4?GSH!T71Zt4qsM?3L^ZNisOC@IA4{sC*t%$O zMhiugJXJzGS1~k$k@!r&wA9QhsF_&d#-d6g#C8x>wM03u z+>44m-4)ZdoeiAd5N*q?%d!&Wbh4)}Hp^PxN5qcW`OpX-Vzpr2dH1sQ+~;oPWpZ z?pU1Wh>B7;)r!Sw&ryxjSjhvN4&s40{Ufzcb7~(VwO{(bYu``8BP6LQ($rOZh|dm1 z?zU<_EfS5|hw0kSO6|`%weJNp7FLxo#g|AWkv2F>0iGmM+ zk2u1n{aIL7z?|0sYhRurjC%5Z6W<@lJI(_jIw0|gbGtpLyFDuGB8|ipgtvn0CQ>l8GdsI0Ut!OH1g15U;M~ zz)Qi~rgJW1;R~dSZ*-tKuPmK3Q{AZ`F@_jx|Z*EJMWkA zy%*o>$oHyz@9eyv1usUfbKZ|@cDJQH{_g-fi<;ZylOS>-I*(q@oGPd%|*dD*L1EGbI!$y`h%j^fGY^D8?|mvQ2{57@1iR$K;ry{oO7Lc80a7iA?1UuneAY z|F-=|I4N;l9b|?$55lilpF@&L;7Ho0y5xPL`$&b*na6IvUOh z>P6(BepNs|CXki@qM80tyi?Q~At~zL0ghrn{)=UuE8S?@k!>u&ATFdoK;Cui$VI4F zEbC{I2N@DX=^oIt0p1%`)pPy8Mokbj&`BXDDOo3tagy5Vqp}+`qVo1q`Fx$U)k&JC zlS-VVH+0ehBmu=l)CNJ%6Q=;QIgeE+cyo2mX)MgUs{+L{bh(xP#UG(tQ1KZFKA_?k51``91>~JNXB~n}kfb!7bh3dI-hQ2}0UwLR zDGk^RL0f7M&JE&n=mvO=l!=ggcT5%ySmmdG(|}LzxAn&W;MYpwcU~_?0|tR&Bu{C; z#Xq_VjxU14A{i%u$PDT1k>Fz=|4 zMuoZI1}e9rr8dbn=kl^RJgg-pfr)$s{+?dPVZVnog;-P6|=KZ8=va=Pk z%E^T?-}yx!6cp7bC;CA3)x~#iW5AGNgL%VkZ2qa(AY24(g)ZX8hImcBYuMHa=Y#%^ zLR*1sj>^N0$bXt&^=EDN@{oDRL2p@g!F7bu9xw`do?D=}ZnDxli3E#%&0wxfqZ?h* z+2FY>qcb8Gkc+MRAQ$OU;z5*%{24FV4!p&U+8Of5P`$ z1nf0@f5Z8HIp3eEX!sL%`CK?XsON*-jSD-vimcOAr&;ez~pO{a)No-Thuswy%ZBcllVB zY*&GB*|MD~wB4o^>ZLx?Zk?Hw>5}c(ENALbwtv`7vNA3K*;W~LXc)VY!7baDp-FDp zz6&gpbAv70Th?pY&LBvaUvf`jKyce{>3_h5?7j^eR+RBE71Ai)j;CUJBq?ZGS( zS4u$S^>RFMbWVT-+R=&Hbp69>zZdOyUAKZvfM=iyuCBjM+_(G3Q9{iUS0t=>3i*v;&k%_ND{W8Y~s{ zUuZS1u#Z&by9x69$$28IuS+r7eUuRjxHE;2sj#;c>dr#ro%fsh{-E>ThVQpK?;gHq z@V&p3AA)zv{S8P0x(nEOVb2Y)c6w0Rj)sr=V&9L@7pl-uU8t%mG)@(&>J&OlBh5k! zoI-c$Lf_(^g2H}M`Qt=psq;RX?;ktwqxe1-@4&19DuMdSwjlrg1JF@mMlxFtiz)Q( z=KFnoSABR?_hByusclPJk-Y~cC5o(wv2(4+utw$+yhgSwC*``aqR8&t_HT;p$6ajj zDe?w~X-}bRf$Rerjw1UH@Qq+|2(mTxDOhTlHu@)3)bPx{iin9K^HO_;Qmz!VqS?)4 z!A@61voO8mAGW1ZHP(@wM;C=W&O;3Y#b4=`50D!p)|n%_YBZxcpH|3{ge+JeiFRmz zB3@_62aHG~0&pa0FdE}lVQ-+DbJ{_LVOJfR|H^jKY6tFn{2uvSDr`{Ut%BET!dzLK z#PIJU=_>drUsgz?{%Q#|ANALenuX9WYhbGgYz%=B!Fr%k)L$h1k(rnZ`!F8QGR2XZ zp`Da2n0iz*j+onaJ1I{gtJXwnkhamR3(c=|mo-Sc3z_sFZG$-@XqS*d8fdQvX*Uv< zGe}b%vYoiDjiW(eWL(CS=Od$|xG+Zh)2w+bE45?i$3R91sqT6BZc%5_xbRygH~t#Tusa<@6< zo-Tlr>&ot!b>?MVq&79)iOpi-pqQwC&30xGpD13#_<&rr7GK>CQ9Rn?)+RmC z>!M9E4Gwl5{8~Fi9RM#@n+z7jz9i5b0EL#A1?pAQCc`SEQJee#szm)?I<$VdPyt&^ zU@dG6l`Axo5VR}Q63^$TlQFhBIpK==v={K=*jO>2rPRPNF`xR#WUG^uG?Gk8=$MZz zL4ZapCovs$qUgPv$WFka3NCfB0vRi)ldrn5Qd^zOLk_AF1!Emy@G9fNfkMr>c&F}2 zL=w(hrUnNq{!7T`1L;2TcsQA|k0rFn(}T?GgnXK#VhQ;ylRQui+@DEQhDp_vA#kkv z15D)?4ws}2NQ%7bynn^_5Z_10_m}xT-uXU5gSekb4@;JYHzP|w=e;K1Z*kra=_2iz zq!5{^lX&t};q3zDc}*6tlk}WU`U@EfyGgFMv@Sm6B)zGVzGKo&lB-zznaiD|BAxUJ zlP;88rx2qiHRd=;Cv?(uCe@T&2N9`;9%jbTOsyfQ-#e-7)xs*0`hld%WYsNB>ibS= z8>U8O8fT7^dJ$94Na|Q8l@;mfuKrHyQDnn?yJQJyj|52C=iA5+Yq$cn_#QPc&*iYV zheJN-P05aLQSCd5z%_+iz!`FK%0O<5iapour>%r(?FWcG+HHk=Q};6R*tQn1v#3An z|3H7>cIcQ7GxY~-{)+uDR(}{*@xx&GpmrQq{MK22n?hf&0>CTvx9OF9tE0couH@TM z5QFXgw32UI^tbtyeEU*=TT;ol*YvlNO1@3PH|{H+x{BNCUB@ikxiV0EqutxGVI7;- zpBu<%hu+Zc5WE9xz#=Vlf;|RHl(g6bAL5b5$q4s7VP`h8#c7GD6-oFrKG2R~+mmy& z#0Dg)lT@=2^260-0i1Dn+bb}WMc4tYj|!6??iNpQpU)D0C~+r_(i6%Wo^40bl6JUq zHy!6I-W`vF2Qx!CwS4_c?)ObjFZK2R2ESQY%5t3Vhl0jme8>9o2$nARa-SDXe5SVV z=`fzK(|c0AXtcAD`&N^ac&)xXx+l{ZjZ;T*uneIyj($nUEOuv{4xD}xzp3~=hTjhO z1?0|c@VgtoE%3VozX|xoH7t)~S;G^h z)2wH_t- z%CkfA3}^k4XT(NVo@Z5_-IC`;J5MJ!O2bti99#l?mfCshVz6VQeT&L-O!6GC^Gt?^ zVCQM3^57r>z~L;h!l%m$SDv$*r1?CQ*O$wvy2|sFyY1hrJhCQ{*=Q}94Qp1Or8R-8 z`!vm)eV|8HDO}6U)^MkAKxl&5EJc)Eh*#AY6w&6C5Q5>&AcA4f@SDJD)&YAsFSAfDFB>63fac$x`Db}p#rukS!0G)64(;HYs_XTU|;Ag4zQK$0c;L|?PR~;o;3w*ngt9J zL0}_Xz`816!_EOVhQQt;uo()NUje(p0tWw#z%FqC`wLzpntAa#z^)>&_X(_%0=9+{ z6ZS-I)Xn56dH}YW@4A@_6foZJCdaAR9q_}q0Jea@enTlVbAkdk*8+xt0fFVZfDKi^ zrk(@rIRaZmVDBnmtrf6aEnpaK5mj1nAz;TMjTm6{R z+ZkcYz!Gw|dFXkbfTf2dofAY!LD5lRxfGbC&@2U)itki-mIBlYF&!r@?Z`B!W!K|4 zDBRM9h3rHr6&nFg@}UDBjw!qis7i$`bR`}V%n3rttVY3h-b#Hrr+?X@<@G0UI8i1p)js!!)_Q<{MqsnllG`0t9!l^V^ zRJ#T%YD?2rsG?`sju<1^|1Vo?3*)-Ql@% zDw2Lr;Cl=5g{)ZnqlLNRdN#0(4P;G)y{!h0W=*Y7liTAMNNU5a!SGn`m+B@d_R+)1 ze8noZ4y*%Pm8#FCIT%mc4JGJ_q}>#u-I+)#p!;$UqTO5q!6OOL7vsNSUsSp(WMpYf zXZQ&42?BgZ13V^?S@56gFQ@V*Q}iE}_+PnC(*a&nB&+jI%l}Ut1!}iGWz*Psyo@T4@aHm8hi(?^v z+7l3S3Gp`#aV8g~JWB*;i+FmqByzQphGMAnpKEWofi~+t_!Oe6`pcKg`%Nj61AwH( zdYfPmS6Lk3%gvKuksZ$M3_#d~wH4^O4`D%)xl;BY;At6(yG~$1cqbFt)d?&KtkIF4 z-;tHeq)U}j`0fjFW6eKq5btvO7x2-1xi#hEM7C<98G4qWa9$8K5IonsRC=o*G~0mw zHHR_7si;5B$`FqXh;9v=db$kjIL2O&(e{PY{;rzS%D3<|Ed7$ITy8t}G*6N*udmYH z(P=zUo@xNodQIcdKJpn}>lZ#vez_?XOxqt`j4TJxM*$%g5YndraIA=R*FK@9XUz%{ zRa&9>351^q{^G_A8QvzB`En1-nO5E563ETm-QhN-V0fFV@S1ZpR zY`Nj7B@Or&+}i;6^7D}M$K|@IR=;q&FAwd5b9Ni3ffWZhhvFNaL$S%1w;LaLwjJ#i zZ@iZ;naQVod0gnm?+@n(uty#1!}C%?H7FA+ zH#8<#q(+{=c)2Im(OVvvjzK_z;DvFGH=f$imIjGDUf?+9CZ_6_1arpwS%sO^S@a6LIdQ1Ny(UQIQ2nEn+&-GnZG}gDkmQ#S`IRS?fB}DxmbO8H$ z5VE?|{g))OBTMh&HBgK!0Q)a&776{0?bX7-9aE`wDUn9f2i>6tCA9-nXQB9P^1>lV5Vt&P3P-Vd~MCw8>Ec4E!qI5ya3ih&!2oHb_T<~`$;Mz zsX3v(z;bI@u8t~q8eE5RPdeo$Tjg4-a>u$^<<_yBx?Rq@T$StQlYLqqCc5hO{E%k>Jg?^kyP&>N<`Sd3~rr_U(*%f!FJ|yX5I?@quRBb zuUDdM;Vf3Lov)4T*KK@_Q}ta;5P8gWIa6l>1aR}%sh2U8QDCGV!#u3Ydnr@5AQk*i zr30TB7TjM?#8G0D7vD-w%I+KWKM3NvUA_l_I~)P`_Kl|!b!G7f` ztk848ATLV_ULqq1*50IIm6JJtw{kKyx#ubr@lqESO z<1!+RaeXUiX6R;YV3JcZ7AQb!S}0z);1uw>LGYDnp?1I*Gt3VSB&JbbZdt4R@~Hn0 zb{I9{D3C3wIo=4!^eVX?`-x{LICYGs{({0 zk$xbI=1=;ZQ#>4i%>DGgI=$lom>LE?zRW4nOZOA{tAyT)(8mxu?u#O!xLT#3wOS=B zcC`u=+9=oBwC9kYHbyC6S)kUiH9*Kb&8ZxWRFe2h83|M`K z?{ZHcReKbD#lez8-!JeP(Nc>slMdX1u{&DI;UfvIN0QP(OrL`EqT7JEZQ+n8-lFX_ zQuU%2WKhb%oGWH;K(Nq!1Y7oR!NMgdN}J4KdRW4}~;TEkmC( zrj7IE5PyzGG@Fr~o+u4KX3+R8(>VRRZ*p2CP^TmF z&JPvTkz@85md0+dAmY+IK_Io!ERH$@O=YV4o(tF|I#W*)JHv|Fb^$~f z%C;Ejuv%0m$1tZti6&KN*ftySqY=%i|Hs!U_#y!LJ;u&tgCfes_Rb*WuxG)Qpecj5 zP(6U@<$YDep26GA8~}vsc}oyP`;1^^uw-~UDPTh_V8D;Sf-YdW3RwC% zze=@Nv5Ovs>oTX|-48ASF6k@|ycprD$}eHhZ&zqktq3115X@n9 z!dnG+i0~D6W=`)sLHu?O01{`>(ins0 z%+O;AnTF>>0gwe}ca1<)QgRcEIKh>#*+@tIe<`nLtNCX1LAb?zDeGK($-u!X2(m&F z558NeDX%5Cu_7Vv{8W(aP3eQ?ok22QO^=pc$VwPwO4EmN@*w-l&pf@7S(Pd4eK|4Z z$)F|;Cumz6AIs}<1Ut4Fv!PRublSR>$l?_DC(1{- zQWrDTbs6nDc+WIa1}&z7uT?%iP;@@vm0ukws?A?)iuH!@4WhG;&T!a&r+BRJ!S^9K zP*e-KfYR%oK#Di25dr6J>Y!i{J5zl<(z39z0P{P5CwJy;GrxMANIaB?ZoQWSrimOv z;od7Agr3SHJcm;Gx~D^r5MLaiGHq3mqGcbC?&$kI0bFVaosat_rXHR`(qKHg1#&F2 znJ{%pC99X#aw9zLV{snlz)$o`j_E10q>jiwB;I^wp;_AgT7e=@N}wW%pndG<)2Ysu`A=QDSn#VU`fV${CezB(Ic35O6p z!~YG0%Wgt0@~iP}c0B5bwoo&Q?T{BtmxGWD^D0x4wFV6M_*v>}nx;(&GRO_xj5-S5 z?F_Y`? zoz7`lxH&Fh8yPkU`#(Jg*s{+6>^TB!rhrk-fY~Gq7;O!VR1X)hCl#=J&H?r)fxSdv z+XPu}yaLwN0)~MgfmL+@OH#ltI0slFfz2T>y1tko1JB-vUVCDV3L8y3>ha}1%X+4r z#a+Bp_{2Giu>W&hO9rRKBW5%o>8vx1MBnSn(PJwaMwzzUBU!?pSRiFX zOxPYZT~>y*cR&6H>OW-B&7zb#ViEysyVe-GAIcqi!lf~rLMc7wJ zwxHu&{2s_xbcCIJ_4(+((&e0FNJIVvIZY1h_t6o0Hpy4~A#>O6g4}20t>CVlC=Bi7 zk(onk2N~6Uf>}|Ozb^B4t1uaKD|06|-2)yA7}0>SF<_LY`ev2#e3wsj%(v+;3#^#$ zMtvXh0OU7LmSYc7^vzRF2@UkX15i)%81-cY% z^X0uIv!UzEGmWG)$KbhPq`7t)ZvLoJr|X4}07ChxoX%;7t9FY&C!rn!p|Xr)k#9Md z;#&N)84Uw=FW?6xgvXkJ)7<2y)=c9bIrRfxjoj3#&aW$@YpDa*FQJf{Z#^3f-&!r| z?}OTveL{arwKLd18K{#D)rZ;P6w`E0vEt^MQ#gJLQ-+=wzaq`n0X7Z*IgwyKCJh%x z(|}$fpz4CWJz3%>?%;MD(y6Bht0MdNMyYHUs3$7b=(?a-QvZv?No1h*IqGcuG5 zhC)&Q*FrosNY@K?W&dP4x;DEXW{qw_hU_ft*ZPp{6!iSXi%H%ELS7JWcVsZ2R=9kH zBgvd=RL+G?&g+>oic^U&B*K}Iec;Fem51gAXjNVBuzF+PaPX%B2tcgSiyl=32!dx?F}YhQ$8Q+FYi*x zxW+v2n5rVrs^XYLb-iCBSFodZH6jC;SVJ0vM+wZNYZ{I;t;#-NUhN6qz~aJYjA^DZNQmudzIp(4*)v3X?qlr!`?3WOqkpJ zOVVN7MxMJpFx^cC75PXp+neiLX#eS4H~Z z{5sIvt!r*aAQ`cE3w_Q^j-sRCkB8OAo~1z@SXS-%}mGOnUidKY@!uKgR7E?TWY$$e*X2Pxb(nL7yo$2QCL zizV+Gop)`l#QuPc+D-Uiw7AhkR7$MXC1#_9yKNt!2r$L$jpxLx7N&>s#2eE*bN*u` zJ&z}@B@3e4J;!ZF^tJZbD@sT7v)_57E_Vu0{WX0XuaS+SVZ1d{=!m9VJBQ{1i?%CW zy!F{zHa+^FiaXGoVBBQfxg_^IfUCy74d$B+KnGtFK)B@t(T@z>i-zZsW40q&16Tz^ zO`8f%ySPyl6B|7CY#kyGhfv%#Ll@v#7M-L1c!~-dP@inMfgN%}k*pj+@(?(t1G!9 z(u1;GVV#?W%#n`x4+L)kau!b}g-LMFg`_S*qX>9&0aG({YYwI_YnFFGlV?ed8!B!A zyN}7PO{QLC-3gjOKS}{u+FY60!5X=oIz@GXW#nUW9A?!nJa#skTso!>pS^g7%Yn%{ z+LcYjDbytay_owt*$2@~@8f(5b#EcZRwsL=p+#_Q;hSU{UzZ~?>i-oa#IVSX&Sgkm z!Q=`k-XJK(1I0|E1R*(~b^%d4pR5f}ZPHPN8lOkw**JxpO0X3T0i-T%GOJ@Phv%cW zh#2Yi7N0_0I&fmkOtVX_H# z)mH~YBYLJ88w-PrDsz&g_34!6Wu*Z^`qrLadu=4#5Zjc_mu6p;e3o50i=0yG29( z{00E^cg>`3L4q}t%DUIqXWjO4%SHICp!Fl2FF^2n=<8?}g5OuD0p4)f4^+Fhg=N0t z5I?1lzs;<7FA;?g%5xaUWg=oT1!T)K-jNAp-Y7W}?{qWOjMm4A^Wl~6IHePpYF=@t;(Z@C^8o+vG6?TVyYXN!kw@3>=8KEQhQ3CsqQ?vD$l>g%U^xg z1+x$G|4Y2w1Aj@>9k?nptm5TQP+u`#KCd=CCZCFzZwB{U@$yn45%!q8i^~-+U&42c zxHyUXF`bsMf4$D)#LIWRhS=>F1onv72k3hNHpc=6mBtA12p6y+3fPo$fIUlKg#@PK z<<}@+JuG0=6|hTO!0Ibt?al!fAh6{GrsL&%I4K+URJDNBP{20xwj$lkua(z)kV!Gq z0)M;;V5I~$ou&Ri#LJ%~tcvmSK}b~b^4_e`iI?ANA>)phHy6bHJ^76Tg9nIA1jry> zet9Ai!`{X4^8-t^fY|1PL;in@mydh`$o^}*yyS|iRldaEC-{30e{bOLW&Ayhza#i- zcxBZp9q>00e^c=HKK|VC^3>k_0#rp@tdXD`#$O=D_sz!XWVoT4amQaXjhR%lS-5)* zyD_%#tn`Op0b=k`dr~D}&^mxo|Dg~(PShqvn_+g6`;7y|b#6fy%2?g-jKUU#c1N(M zQKExa2aOT1X-BvjL!yH!e&UV}jzxihga-rR9;mfFYgKdd@fvmC4*CeR3k=MXE;$j_+(99cWYYQCP_Z1RcmU6zJ52ulc`G3O^8ZPJ9+UL^XWww!e zPDr`T!FUEf7KL36lA&J6Tw zNsQfb`#I9ob?Q?P9+Da89cI!%kr{+;Y=F}zMSYD zOyWaD!|9fAQm!oXh>~r4yYtjY;-YIZ)cJClyVd>tp zH=;0$>%sx# z>&TnZNYA$CMFs|wIg-n=aprh;Y;*Z0yM7jezNjP67`?L;rFrf6scggxa1Chk^6c*T z&XI+8BANp950C^jmHPp(9Cr?&2$Wun>VgGH_czhv56YT?NWcHz1ybKV6kx5or ziLibvlG!l1!Vu|0Icq#@48hEmP%C6_lzYmU5)eneX^hE_c=yKoX@}dii^AAo!(*1Q z*Z3Zb45$9(YmU7bPwU0u^MA5~D_;1B5?r|#hL03f!Ih-Gc(ra4{GgT0@@)wr2iFi) z8eHi!leo&La6Fp+4;TSW|LGr+d8IV^B2oy1Y#LI4)GXg&kb>n5Pkq5kX8Fc4{1Qsq z1X1GNISDdgl5Z1f&LHn);125UMrS;#QY?n$`5+RR5F?ZHLZwFLljm3)MH@$1?x%HG z+6fF3S;xYT4nB#-kzmr4m~7c6{A(~Ge#_J9=Z#)2~cf%^uGIP9Ji)>0c)koC8H zpt1x2;_x+y?Gu;>Ct0*1*I;@POm{)vvk@fXimvP%FtH_eDonD%a$)5S=jmX%?nDYE z8gWGenxHTd5OD%xqxtiX7|X9@)MTT%1J6bou4IS@ON|SLCMAH*TP6YfP+1tdceNTMfk4IRb6lX^fwt5XGPc(u(R-)9wA~6 z7AH<{@Nzthha{hMkn}q9Uf2Ye^N@wl;I*e3gDn+5Pa%{{Pz=eBILRqYP7*?5V%G3a z3|A^3;TZt01cdC~ngEWVRAA|g1n>u_#wCL{hb_v|Sxc$qWP6F(xSpR8=-uRJ)uGI` zrxBnX6=-iVo2))FJhuT@yIn%|mOd20Tp0X;G_;JB z4ns|&QB&b@q4put1dVnd2-5)NE3S5o8WOML885v)wnw zZ^2O3rZnSM{H!r{;{TE~V{aNpXRy(=108Ems*!FyT0v3j?jwBvMh2AXst$wP0qkrMow_*S=n9MIUQ`5076yGX>WKMevgGT;iSH$XQRG_tFw&7 zt7VsIW5e^;PWh7TeBoYGuu9IATKmHQ!1^==j`ak`x`N}c#IZ4O#3ZxSTXE#{77)j5 z^c}z}yRK|XJ{#f6vCMFKNif_OYc8{}!*>GN+;}1tqSXdDVGbMTTm_H9Aa8~JhsA=z zhk6VjOVfLD3vHmNZ3gQ80bNeb`xc9-kz{>4M?2==Rxn&l7WLmE`fCqGB`#2ugm2{+ z>bdT9PgA9cDZDaJ)E=ME&MO<#s6m#|___D?JiC%j25#Kv8Fu zwktML-l$)z3Y1hR2kV3@9L3Z{!0yLt;61!P35%HR8e0fKyi?KTtT^<98TF?j4enkq z_@9vMg9w8Mq#j&XYR=383Bp*T8}4hOQ}&pbqD2hoy#)G!8jXR)lJkYja>@clgMlL! zb?(8UP80OO)ImwmKzADK&Q<924CALXBc~_LDKwBBdw(9yKc^WJB{3HNVbUeU^Jd_g zZmcGf<(bex7_{%o8CISHq^du~Ue7`prIxk4p$*C*X^-`upx#aEJzn6tvAqD;miuE{ zP)%BJ290oO-)&M`sTz;zeHUt2j=dNBm)bwj2V?RMGE!wUo1@bmG@Oq(MVAX)YIgAVx*X#!1RRMw0ce#8P7n{f*#`LPr7RPMgQ%E6!js?eUnrM8KoOHk|gu5r8)X`~N zfixTc>$D|Ck&Bcrh6#(J;deG~|4N*8}6RdwZ#(QT)u^!?9l)xGs z!A%Na4~hMNZ&XO5f&uS^`ViHCo$U}97`qt_{1?G7818^)YVW>^9dW%poGq~1PzD)> z2_p&@!ut^}#CS2>y&97S;5^?aNxC(pSH18EPhjbA;2k-MZqG2f0$0RHdENtGf}sG^ zVAsa#6{Foig2X{Q4+4g{w1%R3JscwuSUQnV^a7G@QUwG9%d>(QVvp3zUpq^>m_rnb zg9pk&6H&Dam~uuhh#rsnPf1Qu*(&F3=KPE1($O}Tqf=2rMlYB;Y!>yOkCgI@GK~HS zh<7D#&Z&{n@z%z^mr6JrqvXLmX`?+-o(6|mM#`g`U^r}#lvD1(t2I)d%uhyAha9pE z#s!s*lv_?ENd;Sul(&-S!v4iaDOIawqc! z_fyTl@urB%4y#cuBI}V>1Q#KFeUN@>9g^M`SX!q$ zR2hzM0^PyDq${5_-QQp&LD8MT{>;!w4BjskNWxGV0>Tdv0Qn$5x&)vZd!&L6sV8Z> zvfGGh!{`f6&0hdlekq+Al1dJ|DZ(mobWfaudp_W*0YP)jQ=}PR2aNB`f$1bIbXB`u z6-N~x0AK~x#{E~rXgr5f$-y(I5KkW?O%~ndXsfNHT)bMcv!)Scr|GYvw*Fgy@3D!b zf$%G3rwKU+`Dz)RCCUEbIeH1eW=-pj(>N z1`Nk0_+*;VJ8vA7hX2(^_*1FQ9s{s?P!M0pLns5wE+Rb4=3qbpujd+42TPgQby~w% z8JjR;J7fe2?nkyP5k=}M15o? z{&U4Q4`a)ydzH`rqeRf2yjzdYsJJF7)_gXEgn9-*^t+eugK7b2N6+NO+K^ok4}v?w zSPQR~Feby;!Ty{XPi90AxKe&RIF8lY!uTAyFYF(6kX)(^*~jCxAzP#XDMKdxf^yjR zu-X>J2*p2?^rVkCInnmJsq`p}h`OUP#FzFv!U#cyUD^)H&_5pXJHLq3;lOzjkH^^T zw?Ju^xXlAjnR1Mh_W@=Iqp9rAA~*E!yVE(ye&N=8s$C6qrr|LSZDSdf`QUU_~ z2S7#^@Xb*d#A8}iZm9JnK8XII&y#c!pTKcsr*g!8Js((~Ja5V;b&!XsiJF3_CKN+9 zfn_ff(G-Q~wNs?i&4mX@Pc45c+iYe#QkD4F!K9u7%~Kn#!azcwQk@Vf=3>{~N&nFoh~}pSkKp7QCd=Wbqs*e(8WYr#2WlwBU*r zq#^NR5iN7WKWAmQ8ee#qH0oVqJ4__WHllA6O*kz_Pwv&ifJUlG8MtqV zvKamr4^?WjE)*;&%)UJO=7qzBhUJPkKjO@&)8_+aPH?Fhnu>9rRDP@A;ax5HD?h-z}JWmk6!=4-O;AD%DT7WRt|U89o$+0FRJX zogin-0rP-Od8``F(H5;B%ubVC=;S@cylS@Cd9I05g|Kt2oG`C(LuP)i4)TG((9 z`3YU*3a+g~ZV3Gh{_yCdjG!?R_#MekwU0g`&%1BCnJv@-18$>QZ6*k!dT=Uj9%w%n z8EEss*Bi{YH9x`V1dY`?(%x5UT@5~lpRVFZEssIy!~)QGzza8#el zqLc&oqlrx1{p9{PRoMI%P`LP^5)292x!BDkAWG&d~>wn7Nj|raih7GPJ_cM zi||=qLf~apXhG(c~qy;*~35 z*$&zE*+<)iN0p#FiMeKKD_Id6_Hus1DTbAjs-(naw$oK(KJ(oUEM%Xe$@pYTIWTo? z)c>ngyjV@Y1A#KqNN+0SCTdgO)y6)EQS7YAVk!KwELE>4r?c^mk(;TjP5}faNe0S! zE&b%YV&y^Ne5u-u^cvoaALr>2B|N|d`fkC)G&aNHjiVSwC%{iwx{MoQhnn#8_8_>_ zv^r>pV_m?J&F(=~*%i_lPv)IJqI+~ivHuzL%{akjK3bXY>G5( zE7uo{L->ckqhOHui--|S2LHp_H*TxLe?i8RQW-MpU@hy!FU7lxWh%^%PAU_@px}@BIi&i=OnUZwhsB1Jwk}0tu8^fj!w2I$fmaZVlmOTKLebxRwsoLAlLxV@xLH{#nS;p&)vT%1m@XS?_zwaLxjz4KHnlfK+&BWkQ~kWUoSilNAJ(p0CI3d+bhrTtY2ofw&6CGfl)7F)s24`H;Vzd& z+Qb_D1;8IbE&(?O!{Sc(FM^*LkPgz&;7ou^cyuMXB@G6siut+?`DKBedSzrgRh7de zy%pq}ife0VKruQtu1bEgg`zpY2J)5ya&_eSSRnNjkXO(~3%%qqaTa zDM*!}H^hd#T0y=k!jk}9ko^jBKQvtR1<>0}>fK?ZcaaTbvjWmN(mNK&riZ1Czq+V* zUo8uuhEy4PB}Xml{iGmwjhsgByU-h>Aa8V2?}ZXjZ=Q|b1RF?10m+Iijs?2fSYGc*j6phpY5q~U@ z7Zi}6U7~RaffFqn3Q}e0J!wO(ryviC6hdTN)a#%iKMzip0h+%S0v!3=d@7=ArfLXv z3ocX;?k}I{Dt>x|w62$3d<_|c`%qQ!s&?^2ReS^#qa&CFs(1stc!@Dt~jhH zb49_ms`x0Z*ZcEN=sBEElZUB-^V?GOG5FW!PInaUE&zsIyJ$F7BHGK(N?CEf&C*vt ze+9!yeYJwpcBh54=&P=}>iB}Ws5-D@8t4{zJGNW?26$+!>^N87_J_lp&n=sZ099-- z?+cje1aoIBn8gZ=r^uzAW}|!aZ@0nZmn%ZV7kn;Y!UWSW7R?eq~qF zaFPcer=a3A<766kne&zX%wKwrX~v;61D9b;1Vl|RntZ?T%3i5a zg2VC4a7-8=mb1iW#S6_W+F1%=JcWU0>0oMCDTEy=i%y9L!C#6=Ap`7!Npeb&0WxCX zkOBJtDJ-GkkO2-TX45HTfa;4x9qAM@z=i*~OOXNE$J9;+c;X9psR2mY3OnTBGZZOR zPq^U>L(1gS?vznT*>=jEG7c%z6pJc+rcVJyk@(*IF5uHegaAJ#r$kT;Z`uMEV$*3U zP`nmYA8-Q~5p26HynutMFBqCW4>|Hb_R9Es5A3S>pPwyba-nqH4gJt{7sL)O`rnNJ zLbN8ABpJstI!=n8gbCwY!0$LyRP+1Miu(C-l%alp@fsJOPomlZpXX@SBvJ@AwA+G= z7b!%t?{ab3Pj{i>|gZMQ`T zn!f_%G>7U6dp6+g}5({=Gl z%lb+2wI~jT$&Zk;^(7}^Z%dhyQ}NAANCZNC6j*G)W2Py13}CJiseELTNG{&_YtBkk zz?3*I)|oz5z8|I{x|Mfyk!-_Y=1zHf5Pwvaj1W!%Bt{68t;GsW49%y3BU?#La&v?3X#c+SQ@j0TsMXzZMkX@Cq}!5QZlAW?b{Cl zAO!XXCJy6@QykoH9Oa6!)HLIuMEb%#JX|k^-B+UoqQuV_-Mh*}KyDCws5q`a*z5=% zp#(oXiusc<#~;fRsw$qR)+yiah!E}N z(D%kVF5pZs|M^ik*_V5aUG4O1(LfS+y?KorYGVuPdzCeqsT(Nngx^B0KA4K&IQcHo2S_QcUvr9U} z+37NJJ5FMJ04<30!hheU_6x)^819fu18abz5J;r)YaBF()e{uO-H$KM6U3?y z0Bik1QW@S`KS2=O_&JEExSO@w91-Jgk96qUKNde}5)Tr${llBoct+-D-2CzT9qh@C z<~>(}KTc`>=mGsC{4q=QWb6B^o_q&=is6wk$DUon9NCY%dhs2Cql5pH%Qt)uiQqC5 z+EUvv@K*kf^`M95Di}Gp7tfUD-h$>r*R9{r66+BvsV?L#<%PR@E*0`-_bX2e6t_S| znAGC7s=!s$C`Kv@xnJ&vzkLOWK-LG5|Qna?+98ZB9a;kcm>c%1d!l#f4ra z$c!l}GE!i0g^2S1U4P@yMbRji2tv}|oPyhd8QbC#p~KC$quV*NfNq}&=k1(sw>tTM zc5r>ccBA4 z(;q*v#GQ#RT1@{paqkf@HgN;RLqQ34^n>^XjTY?#jlQ-zy0&!mwNe4O3U2If>CW2<) zyyNnz<`T+978LXAGND|~)dd#|gw%Qn?3~&Q(uBRgVot(r2pZJ}Br92xv`9v?k41jt2E)gSs?9gFcrAZD51UILe|O z=$OHl7~b^0t_Hbs^VB74?blt%YTkQL)frzU9f-BE*L9^w^lTp8z^&`;Oo0ID^*V^8ta!_^BY>-`lO89HAggMB7{MK{LYM zuQ07*cDoo2Un59vB9h0r2Fhvpi)^vs&Ftf9xGVQ^$*p>F7_yod>!4tK!B&B}nK0+X z!tA8bUNgki@Z_ORm;20gjdgs%(+HOZmK3AoB5Px%_%u*LMj70EOZ_<4}E9RB~{Q_NV+@~OP4tcO17J|iu+@f@jc9*Vy$@^jJKe> zfLTPsxMRru6^t_Qv>j8~MFuy07L0)!M(cup0^=)1nedN7nfEX?WPSkURuB=&aBvvu z!Pua~pudqMSeJ&Kj<%|C}J1Zy38!-aSO z{Nns)Y`OZ+RtwA_Sn$A-4+*9;mWKTmm^O!9;&~@v=HJISfe83O8_aJ4W+A~$i3Jm{ zz&r@vRyJ-o_%lDnhS6BV@D}_dFgU+f-pSRRji3#h)4~Su1_9Kx0qoeK+S0lpPDsMw zE!Z>e2kC^(?1aQd=!B?z-9{8;6Qn~h?lVOvT-npr39j68Brc*lp|e7!90I3W^J_mK z^NwwLx@ly*1s_Rk-e7CoTvb&8cDCRd#kHKuH0)Sw`$O%$ZBT)X0d}`VD2EycVb}%krCan7x&HD z;_%Sx7({73ago_$v+f8`|C#Rv*?SPGE_fb}d|=6Fz%=Lh@tz=cl(CM~*gEzTVXS-T z;lkUMyS@wWd}KA7{9)nUN?`6J%)|K4#Xd8U5qOV3;KKWGZ*-7bJNnQOcrawLE_ z_bI%3z*-deM1gYbYL01uk;5gfg6oNb;e9I8rcCpK{!+(Y)B!+E6rglcxdTeOCUzBq zhCuM72?R7!&+3wQvFimF4|7b_SRd1c6EeNOyb8`%3q_mbQTAkALTx|`+07Jq57}usbB6+%w)X5g`%Cv>|wb_&00@A5ctW)pjHZyT2I|tI-(3Sj(r3x zIlbih*%ZB|&&(xG&c>knRAn4m^rF(j$ny5Dup*0Bnb#sLXsZ93M6SHI5{MVlFlT_1=5a<<}F`3 zB&jB8iXxIx-AmhJ*;% zsyVkJl0*5)OkRl{3iL_UEH?M^&D|mA2MR?p* zMb+;F0<-X9teN&})og^}y}e(t`(RX--gEN`dCy_X>3EII14v}=vtRmP+rRcfG-&t1 zqbM_LEfLk88O_M$Gu$B4r6V+>(0DGyfZIo{KD&UaCIIwb#2PPS!SV8a$yel zb4lRhN1^;0oWmH+X$TVixuqr;rhU;|GRy{!R!Uc&Wf*TNyv69`Ne_SqP6Dh6fQB#XuR?yr^3MdV zI+?MCWK1pkS>waUc+m7sB0K zXq2)J52I)yr4U<^qyB3JDOoCxh0;m0H=AKDS8@m77}RBdih(2i(iT_n~smdf}vFZgzsA-h>no zb9os>d8>IE9j8eKC^r{1A(SU%0AS0*>nLJ%AYhm;;V2~6RN5qgm{hz89e6W4@G`;} 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�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

        +nH}@kA*zA&pui36loBHjeLn-OGl2g>J>BuKG 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

        W(T>YLOn;Rd>S40=Y3k);P$1L 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

        |ULHpj5QEyF%zcV)}ix`fn#7mS)@cQkxsp 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 Kn4%YdufJ3GRQOu6{Y2 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/asyncpg/protocol/protocol.pxd b/env/Lib/site-packages/asyncpg/protocol/protocol.pxd new file mode 100644 index 0000000..a9ac8d5 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/protocol.pxd @@ -0,0 +1,78 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +from libc.stdint cimport int16_t, int32_t, uint16_t, \ + uint32_t, int64_t, uint64_t + +from asyncpg.pgproto.debug cimport PG_DEBUG + +from asyncpg.pgproto.pgproto cimport ( + WriteBuffer, + ReadBuffer, + FRBuffer, +) + +from asyncpg.pgproto cimport pgproto + +include "consts.pxi" +include "pgtypes.pxi" + +include "codecs/base.pxd" +include "settings.pxd" +include "coreproto.pxd" +include "prepared_stmt.pxd" + + +cdef class BaseProtocol(CoreProtocol): + + cdef: + object loop + object address + ConnectionSettings settings + object cancel_sent_waiter + object cancel_waiter + object waiter + bint return_extra + object create_future + object timeout_handle + object conref + type record_class + bint is_reading + + str last_query + + bint writing_paused + bint closing + + readonly uint64_t queries_count + + bint _is_ssl + + PreparedStatementState statement + + cdef get_connection(self) + + cdef _get_timeout_impl(self, timeout) + cdef _check_state(self) + cdef _new_waiter(self, timeout) + cdef _coreproto_error(self) + + cdef _on_result__connect(self, object waiter) + cdef _on_result__prepare(self, object waiter) + cdef _on_result__bind_and_exec(self, object waiter) + cdef _on_result__close_stmt_or_portal(self, object waiter) + cdef _on_result__simple_query(self, object waiter) + cdef _on_result__bind(self, object waiter) + cdef _on_result__copy_out(self, object waiter) + cdef _on_result__copy_in(self, object waiter) + + cdef _handle_waiter_on_connection_lost(self, cause) + + cdef _dispatch_result(self) + + cdef inline resume_reading(self) + cdef inline pause_reading(self) diff --git a/env/Lib/site-packages/asyncpg/protocol/protocol.pyx b/env/Lib/site-packages/asyncpg/protocol/protocol.pyx new file mode 100644 index 0000000..b43b0e9 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/protocol.pyx @@ -0,0 +1,1064 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +# cython: language_level=3 + +cimport cython +cimport cpython + +import asyncio +import builtins +import codecs +import collections.abc +import socket +import time +import weakref + +from asyncpg.pgproto.pgproto cimport ( + WriteBuffer, + ReadBuffer, + + FRBuffer, + frb_init, + frb_read, + frb_read_all, + frb_slice_from, + frb_check, + frb_set_len, + frb_get_len, +) + +from asyncpg.pgproto cimport pgproto +from asyncpg.protocol cimport cpythonx +from asyncpg.protocol cimport record + +from libc.stdint cimport int8_t, uint8_t, int16_t, uint16_t, \ + int32_t, uint32_t, int64_t, uint64_t, \ + INT32_MAX, UINT32_MAX + +from asyncpg.exceptions import _base as apg_exc_base +from asyncpg import compat +from asyncpg import types as apg_types +from asyncpg import exceptions as apg_exc + +from asyncpg.pgproto cimport hton + + +include "consts.pxi" +include "pgtypes.pxi" + +include "encodings.pyx" +include "settings.pyx" + +include "codecs/base.pyx" +include "codecs/textutils.pyx" + +# register codecs provided by pgproto +include "codecs/pgproto.pyx" + +# nonscalar +include "codecs/array.pyx" +include "codecs/range.pyx" +include "codecs/record.pyx" + +include "coreproto.pyx" +include "prepared_stmt.pyx" + + +NO_TIMEOUT = object() + + +cdef class BaseProtocol(CoreProtocol): + def __init__(self, addr, connected_fut, con_params, record_class: type, loop): + # type of `con_params` is `_ConnectionParameters` + CoreProtocol.__init__(self, con_params) + + self.loop = loop + self.transport = None + self.waiter = connected_fut + self.cancel_waiter = None + self.cancel_sent_waiter = None + + self.address = addr + self.settings = ConnectionSettings((self.address, con_params.database)) + self.record_class = record_class + + self.statement = None + self.return_extra = False + + self.last_query = None + + self.closing = False + self.is_reading = True + self.writing_allowed = asyncio.Event() + self.writing_allowed.set() + + self.timeout_handle = None + + self.queries_count = 0 + + self._is_ssl = False + + try: + self.create_future = loop.create_future + except AttributeError: + self.create_future = self._create_future_fallback + + def set_connection(self, connection): + self.conref = weakref.ref(connection) + + cdef get_connection(self): + if self.conref is not None: + return self.conref() + else: + return None + + def get_server_pid(self): + return self.backend_pid + + def get_settings(self): + return self.settings + + def get_record_class(self): + return self.record_class + + cdef inline resume_reading(self): + if not self.is_reading: + self.is_reading = True + self.transport.resume_reading() + + cdef inline pause_reading(self): + if self.is_reading: + self.is_reading = False + self.transport.pause_reading() + + @cython.iterable_coroutine + async def prepare(self, stmt_name, query, timeout, + *, + PreparedStatementState state=None, + ignore_custom_codec=False, + record_class): + if self.cancel_waiter is not None: + await self.cancel_waiter + if self.cancel_sent_waiter is not None: + await self.cancel_sent_waiter + self.cancel_sent_waiter = None + + self._check_state() + timeout = self._get_timeout_impl(timeout) + + waiter = self._new_waiter(timeout) + try: + self._prepare_and_describe(stmt_name, query) # network op + self.last_query = query + if state is None: + state = PreparedStatementState( + stmt_name, query, self, record_class, ignore_custom_codec) + self.statement = state + except Exception as ex: + waiter.set_exception(ex) + self._coreproto_error() + finally: + return await waiter + + @cython.iterable_coroutine + async def bind_execute( + self, + state: PreparedStatementState, + args, + portal_name: str, + limit: int, + return_extra: bool, + timeout, + ): + if self.cancel_waiter is not None: + await self.cancel_waiter + if self.cancel_sent_waiter is not None: + await self.cancel_sent_waiter + self.cancel_sent_waiter = None + + self._check_state() + timeout = self._get_timeout_impl(timeout) + args_buf = state._encode_bind_msg(args) + + waiter = self._new_waiter(timeout) + try: + if not state.prepared: + self._send_parse_message(state.name, state.query) + + self._bind_execute( + portal_name, + state.name, + args_buf, + limit) # network op + + self.last_query = state.query + self.statement = state + self.return_extra = return_extra + self.queries_count += 1 + except Exception as ex: + waiter.set_exception(ex) + self._coreproto_error() + finally: + return await waiter + + @cython.iterable_coroutine + async def bind_execute_many( + self, + state: PreparedStatementState, + args, + portal_name: str, + timeout, + ): + if self.cancel_waiter is not None: + await self.cancel_waiter + if self.cancel_sent_waiter is not None: + await self.cancel_sent_waiter + self.cancel_sent_waiter = None + + self._check_state() + timeout = self._get_timeout_impl(timeout) + timer = Timer(timeout) + + # Make sure the argument sequence is encoded lazily with + # this generator expression to keep the memory pressure under + # control. + data_gen = (state._encode_bind_msg(b, i) for i, b in enumerate(args)) + arg_bufs = iter(data_gen) + + waiter = self._new_waiter(timeout) + try: + if not state.prepared: + self._send_parse_message(state.name, state.query) + + more = self._bind_execute_many( + portal_name, + state.name, + arg_bufs) # network op + + self.last_query = state.query + self.statement = state + self.return_extra = False + self.queries_count += 1 + + while more: + with timer: + await compat.wait_for( + self.writing_allowed.wait(), + timeout=timer.get_remaining_budget()) + # On Windows the above event somehow won't allow context + # switch, so forcing one with sleep(0) here + await asyncio.sleep(0) + if not timer.has_budget_greater_than(0): + raise asyncio.TimeoutError + more = self._bind_execute_many_more() # network op + + except asyncio.TimeoutError as e: + self._bind_execute_many_fail(e) # network op + + except Exception as ex: + waiter.set_exception(ex) + self._coreproto_error() + finally: + return await waiter + + @cython.iterable_coroutine + async def bind(self, PreparedStatementState state, args, + str portal_name, timeout): + + if self.cancel_waiter is not None: + await self.cancel_waiter + if self.cancel_sent_waiter is not None: + await self.cancel_sent_waiter + self.cancel_sent_waiter = None + + self._check_state() + timeout = self._get_timeout_impl(timeout) + args_buf = state._encode_bind_msg(args) + + waiter = self._new_waiter(timeout) + try: + self._bind( + portal_name, + state.name, + args_buf) # network op + + self.last_query = state.query + self.statement = state + except Exception as ex: + waiter.set_exception(ex) + self._coreproto_error() + finally: + return await waiter + + @cython.iterable_coroutine + async def execute(self, PreparedStatementState state, + str portal_name, int limit, return_extra, + timeout): + + if self.cancel_waiter is not None: + await self.cancel_waiter + if self.cancel_sent_waiter is not None: + await self.cancel_sent_waiter + self.cancel_sent_waiter = None + + self._check_state() + timeout = self._get_timeout_impl(timeout) + + waiter = self._new_waiter(timeout) + try: + self._execute( + portal_name, + limit) # network op + + self.last_query = state.query + self.statement = state + self.return_extra = return_extra + self.queries_count += 1 + except Exception as ex: + waiter.set_exception(ex) + self._coreproto_error() + finally: + return await waiter + + @cython.iterable_coroutine + async def close_portal(self, str portal_name, timeout): + + if self.cancel_waiter is not None: + await self.cancel_waiter + if self.cancel_sent_waiter is not None: + await self.cancel_sent_waiter + self.cancel_sent_waiter = None + + self._check_state() + timeout = self._get_timeout_impl(timeout) + + waiter = self._new_waiter(timeout) + try: + self._close( + portal_name, + True) # network op + except Exception as ex: + waiter.set_exception(ex) + self._coreproto_error() + finally: + return await waiter + + @cython.iterable_coroutine + async def query(self, query, timeout): + if self.cancel_waiter is not None: + await self.cancel_waiter + if self.cancel_sent_waiter is not None: + await self.cancel_sent_waiter + self.cancel_sent_waiter = None + + self._check_state() + # query() needs to call _get_timeout instead of _get_timeout_impl + # for consistent validation, as it is called differently from + # prepare/bind/execute methods. + timeout = self._get_timeout(timeout) + + waiter = self._new_waiter(timeout) + try: + self._simple_query(query) # network op + self.last_query = query + self.queries_count += 1 + except Exception as ex: + waiter.set_exception(ex) + self._coreproto_error() + finally: + return await waiter + + @cython.iterable_coroutine + async def copy_out(self, copy_stmt, sink, timeout): + if self.cancel_waiter is not None: + await self.cancel_waiter + if self.cancel_sent_waiter is not None: + await self.cancel_sent_waiter + self.cancel_sent_waiter = None + + self._check_state() + + timeout = self._get_timeout_impl(timeout) + timer = Timer(timeout) + + # The copy operation is guarded by a single timeout + # on the top level. + waiter = self._new_waiter(timer.get_remaining_budget()) + + self._copy_out(copy_stmt) + + try: + while True: + self.resume_reading() + + with timer: + buffer, done, status_msg = await waiter + + # buffer will be empty if CopyDone was received apart from + # the last CopyData message. + if buffer: + try: + with timer: + await compat.wait_for( + sink(buffer), + timeout=timer.get_remaining_budget()) + except (Exception, asyncio.CancelledError) as ex: + # Abort the COPY operation on any error in + # output sink. + self._request_cancel() + # Make asyncio shut up about unretrieved + # QueryCanceledError + waiter.add_done_callback(lambda f: f.exception()) + raise + + # done will be True upon receipt of CopyDone. + if done: + break + + waiter = self._new_waiter(timer.get_remaining_budget()) + + finally: + self.resume_reading() + + return status_msg + + @cython.iterable_coroutine + async def copy_in(self, copy_stmt, reader, data, + records, PreparedStatementState record_stmt, timeout): + cdef: + WriteBuffer wbuf + ssize_t num_cols + Codec codec + + if self.cancel_waiter is not None: + await self.cancel_waiter + if self.cancel_sent_waiter is not None: + await self.cancel_sent_waiter + self.cancel_sent_waiter = None + + self._check_state() + + timeout = self._get_timeout_impl(timeout) + timer = Timer(timeout) + + waiter = self._new_waiter(timer.get_remaining_budget()) + + # Initiate COPY IN. + self._copy_in(copy_stmt) + + try: + if record_stmt is not None: + # copy_in_records in binary mode + wbuf = WriteBuffer.new() + # Signature + wbuf.write_bytes(_COPY_SIGNATURE) + # Flags field + wbuf.write_int32(0) + # No header extension + wbuf.write_int32(0) + + record_stmt._ensure_rows_decoder() + codecs = record_stmt.rows_codecs + num_cols = len(codecs) + settings = self.settings + + for codec in codecs: + if (not codec.has_encoder() or + codec.format != PG_FORMAT_BINARY): + raise apg_exc.InternalClientError( + 'no binary format encoder for ' + 'type {} (OID {})'.format(codec.name, codec.oid)) + + if isinstance(records, collections.abc.AsyncIterable): + async for row in records: + # Tuple header + wbuf.write_int16(num_cols) + # Tuple data + for i in range(num_cols): + item = row[i] + if item is None: + wbuf.write_int32(-1) + else: + codec = cpython.PyTuple_GET_ITEM( + codecs, i) + codec.encode(settings, wbuf, item) + + if wbuf.len() >= _COPY_BUFFER_SIZE: + with timer: + await self.writing_allowed.wait() + self._write_copy_data_msg(wbuf) + wbuf = WriteBuffer.new() + else: + for row in records: + # Tuple header + wbuf.write_int16(num_cols) + # Tuple data + for i in range(num_cols): + item = row[i] + if item is None: + wbuf.write_int32(-1) + else: + codec = cpython.PyTuple_GET_ITEM( + codecs, i) + codec.encode(settings, wbuf, item) + + if wbuf.len() >= _COPY_BUFFER_SIZE: + with timer: + await self.writing_allowed.wait() + self._write_copy_data_msg(wbuf) + wbuf = WriteBuffer.new() + + # End of binary copy. + wbuf.write_int16(-1) + self._write_copy_data_msg(wbuf) + + elif reader is not None: + try: + aiter = reader.__aiter__ + except AttributeError: + raise TypeError('reader is not an asynchronous iterable') + else: + iterator = aiter() + + try: + while True: + # We rely on protocol flow control to moderate the + # rate of data messages. + with timer: + await self.writing_allowed.wait() + with timer: + chunk = await compat.wait_for( + iterator.__anext__(), + timeout=timer.get_remaining_budget()) + self._write_copy_data_msg(chunk) + except builtins.StopAsyncIteration: + pass + else: + # Buffer passed in directly. + await self.writing_allowed.wait() + self._write_copy_data_msg(data) + + except asyncio.TimeoutError: + self._write_copy_fail_msg('TimeoutError') + self._on_timeout(self.waiter) + try: + await waiter + except TimeoutError: + raise + else: + raise apg_exc.InternalClientError('TimoutError was not raised') + + except (Exception, asyncio.CancelledError) as e: + self._write_copy_fail_msg(str(e)) + self._request_cancel() + # Make asyncio shut up about unretrieved QueryCanceledError + waiter.add_done_callback(lambda f: f.exception()) + raise + + self._write_copy_done_msg() + + status_msg = await waiter + + return status_msg + + @cython.iterable_coroutine + async def close_statement(self, PreparedStatementState state, timeout): + if self.cancel_waiter is not None: + await self.cancel_waiter + if self.cancel_sent_waiter is not None: + await self.cancel_sent_waiter + self.cancel_sent_waiter = None + + self._check_state() + + if state.refs != 0: + raise apg_exc.InternalClientError( + 'cannot close prepared statement; refs == {} != 0'.format( + state.refs)) + + timeout = self._get_timeout_impl(timeout) + waiter = self._new_waiter(timeout) + try: + self._close(state.name, False) # network op + state.closed = True + except Exception as ex: + waiter.set_exception(ex) + self._coreproto_error() + finally: + return await waiter + + def is_closed(self): + return self.closing + + def is_connected(self): + return not self.closing and self.con_status == CONNECTION_OK + + def abort(self): + if self.closing: + return + self.closing = True + self._handle_waiter_on_connection_lost(None) + self._terminate() + self.transport.abort() + self.transport = None + + @cython.iterable_coroutine + async def close(self, timeout): + if self.closing: + return + + self.closing = True + + if self.cancel_sent_waiter is not None: + await self.cancel_sent_waiter + self.cancel_sent_waiter = None + + if self.cancel_waiter is not None: + await self.cancel_waiter + + if self.waiter is not None: + # If there is a query running, cancel it + self._request_cancel() + await self.cancel_sent_waiter + self.cancel_sent_waiter = None + if self.cancel_waiter is not None: + await self.cancel_waiter + + assert self.waiter is None + + timeout = self._get_timeout_impl(timeout) + + # Ask the server to terminate the connection and wait for it + # to drop. + self.waiter = self._new_waiter(timeout) + self._terminate() + try: + await self.waiter + except ConnectionResetError: + # There appears to be a difference in behaviour of asyncio + # in Windows, where, instead of calling protocol.connection_lost() + # a ConnectionResetError will be thrown into the task. + pass + finally: + self.waiter = None + self.transport.abort() + + def _request_cancel(self): + self.cancel_waiter = self.create_future() + self.cancel_sent_waiter = self.create_future() + + con = self.get_connection() + if con is not None: + # if 'con' is None it means that the connection object has been + # garbage collected and that the transport will soon be aborted. + con._cancel_current_command(self.cancel_sent_waiter) + else: + self.loop.call_exception_handler({ + 'message': 'asyncpg.Protocol has no reference to its ' + 'Connection object and yet a cancellation ' + 'was requested. Please report this at ' + 'github.com/magicstack/asyncpg.' + }) + self.abort() + + if self.state == PROTOCOL_PREPARE: + # we need to send a SYNC to server if we cancel during the PREPARE phase + # because the PREPARE sequence does not send a SYNC itself. + # we cannot send this extra SYNC if we are not in PREPARE phase, + # because then we would issue two SYNCs and we would get two ReadyForQuery + # replies, which our current state machine implementation cannot handle + self._write(SYNC_MESSAGE) + self._set_state(PROTOCOL_CANCELLED) + + def _on_timeout(self, fut): + if self.waiter is not fut or fut.done() or \ + self.cancel_waiter is not None or \ + self.timeout_handle is None: + return + self._request_cancel() + self.waiter.set_exception(asyncio.TimeoutError()) + + def _on_waiter_completed(self, fut): + if self.timeout_handle: + self.timeout_handle.cancel() + self.timeout_handle = None + if fut is not self.waiter or self.cancel_waiter is not None: + return + if fut.cancelled(): + self._request_cancel() + + def _create_future_fallback(self): + return asyncio.Future(loop=self.loop) + + cdef _handle_waiter_on_connection_lost(self, cause): + if self.waiter is not None and not self.waiter.done(): + exc = apg_exc.ConnectionDoesNotExistError( + 'connection was closed in the middle of ' + 'operation') + if cause is not None: + exc.__cause__ = cause + self.waiter.set_exception(exc) + self.waiter = None + + cdef _set_server_parameter(self, name, val): + self.settings.add_setting(name, val) + + def _get_timeout(self, timeout): + if timeout is not None: + try: + if type(timeout) is bool: + raise ValueError + timeout = float(timeout) + except ValueError: + raise ValueError( + 'invalid timeout value: expected non-negative float ' + '(got {!r})'.format(timeout)) from None + + return self._get_timeout_impl(timeout) + + cdef inline _get_timeout_impl(self, timeout): + if timeout is None: + timeout = self.get_connection()._config.command_timeout + elif timeout is NO_TIMEOUT: + timeout = None + else: + timeout = float(timeout) + + if timeout is not None and timeout <= 0: + raise asyncio.TimeoutError() + return timeout + + cdef _check_state(self): + if self.cancel_waiter is not None: + raise apg_exc.InterfaceError( + 'cannot perform operation: another operation is cancelling') + if self.closing: + raise apg_exc.InterfaceError( + 'cannot perform operation: connection is closed') + if self.waiter is not None or self.timeout_handle is not None: + raise apg_exc.InterfaceError( + 'cannot perform operation: another operation is in progress') + + def _is_cancelling(self): + return ( + self.cancel_waiter is not None or + self.cancel_sent_waiter is not None + ) + + @cython.iterable_coroutine + async def _wait_for_cancellation(self): + if self.cancel_sent_waiter is not None: + await self.cancel_sent_waiter + self.cancel_sent_waiter = None + if self.cancel_waiter is not None: + await self.cancel_waiter + + cdef _coreproto_error(self): + try: + if self.waiter is not None: + if not self.waiter.done(): + raise apg_exc.InternalClientError( + 'waiter is not done while handling critical ' + 'protocol error') + self.waiter = None + finally: + self.abort() + + cdef _new_waiter(self, timeout): + if self.waiter is not None: + raise apg_exc.InterfaceError( + 'cannot perform operation: another operation is in progress') + self.waiter = self.create_future() + if timeout is not None: + self.timeout_handle = self.loop.call_later( + timeout, self._on_timeout, self.waiter) + self.waiter.add_done_callback(self._on_waiter_completed) + return self.waiter + + cdef _on_result__connect(self, object waiter): + waiter.set_result(True) + + cdef _on_result__prepare(self, object waiter): + if PG_DEBUG: + if self.statement is None: + raise apg_exc.InternalClientError( + '_on_result__prepare: statement is None') + + if self.result_param_desc is not None: + self.statement._set_args_desc(self.result_param_desc) + if self.result_row_desc is not None: + self.statement._set_row_desc(self.result_row_desc) + waiter.set_result(self.statement) + + cdef _on_result__bind_and_exec(self, object waiter): + if self.return_extra: + waiter.set_result(( + self.result, + self.result_status_msg, + self.result_execute_completed)) + else: + waiter.set_result(self.result) + + cdef _on_result__bind(self, object waiter): + waiter.set_result(self.result) + + cdef _on_result__close_stmt_or_portal(self, object waiter): + waiter.set_result(self.result) + + cdef _on_result__simple_query(self, object waiter): + waiter.set_result(self.result_status_msg.decode(self.encoding)) + + cdef _on_result__copy_out(self, object waiter): + cdef bint copy_done = self.state == PROTOCOL_COPY_OUT_DONE + if copy_done: + status_msg = self.result_status_msg.decode(self.encoding) + else: + status_msg = None + + # We need to put some backpressure on Postgres + # here in case the sink is slow to process the output. + self.pause_reading() + + waiter.set_result((self.result, copy_done, status_msg)) + + cdef _on_result__copy_in(self, object waiter): + status_msg = self.result_status_msg.decode(self.encoding) + waiter.set_result(status_msg) + + cdef _decode_row(self, const char* buf, ssize_t buf_len): + if PG_DEBUG: + if self.statement is None: + raise apg_exc.InternalClientError( + '_decode_row: statement is None') + + return self.statement._decode_row(buf, buf_len) + + cdef _dispatch_result(self): + waiter = self.waiter + self.waiter = None + + if PG_DEBUG: + if waiter is None: + raise apg_exc.InternalClientError('_on_result: waiter is None') + + if waiter.cancelled(): + return + + if waiter.done(): + raise apg_exc.InternalClientError('_on_result: waiter is done') + + if self.result_type == RESULT_FAILED: + if isinstance(self.result, dict): + exc = apg_exc_base.PostgresError.new( + self.result, query=self.last_query) + else: + exc = self.result + waiter.set_exception(exc) + return + + try: + if self.state == PROTOCOL_AUTH: + self._on_result__connect(waiter) + + elif self.state == PROTOCOL_PREPARE: + self._on_result__prepare(waiter) + + elif self.state == PROTOCOL_BIND_EXECUTE: + self._on_result__bind_and_exec(waiter) + + elif self.state == PROTOCOL_BIND_EXECUTE_MANY: + self._on_result__bind_and_exec(waiter) + + elif self.state == PROTOCOL_EXECUTE: + self._on_result__bind_and_exec(waiter) + + elif self.state == PROTOCOL_BIND: + self._on_result__bind(waiter) + + elif self.state == PROTOCOL_CLOSE_STMT_PORTAL: + self._on_result__close_stmt_or_portal(waiter) + + elif self.state == PROTOCOL_SIMPLE_QUERY: + self._on_result__simple_query(waiter) + + elif (self.state == PROTOCOL_COPY_OUT_DATA or + self.state == PROTOCOL_COPY_OUT_DONE): + self._on_result__copy_out(waiter) + + elif self.state == PROTOCOL_COPY_IN_DATA: + self._on_result__copy_in(waiter) + + elif self.state == PROTOCOL_TERMINATING: + # We are waiting for the connection to drop, so + # ignore any stray results at this point. + pass + + else: + raise apg_exc.InternalClientError( + 'got result for unknown protocol state {}'. + format(self.state)) + + except Exception as exc: + waiter.set_exception(exc) + + cdef _on_result(self): + if self.timeout_handle is not None: + self.timeout_handle.cancel() + self.timeout_handle = None + + if self.cancel_waiter is not None: + # We have received the result of a cancelled command. + if not self.cancel_waiter.done(): + # The cancellation future might have been cancelled + # by the cancellation of the entire task running the query. + self.cancel_waiter.set_result(None) + self.cancel_waiter = None + if self.waiter is not None and self.waiter.done(): + self.waiter = None + if self.waiter is None: + return + + try: + self._dispatch_result() + finally: + self.statement = None + self.last_query = None + self.return_extra = False + + cdef _on_notice(self, parsed): + con = self.get_connection() + if con is not None: + con._process_log_message(parsed, self.last_query) + + cdef _on_notification(self, pid, channel, payload): + con = self.get_connection() + if con is not None: + con._process_notification(pid, channel, payload) + + cdef _on_connection_lost(self, exc): + if self.closing: + # The connection was lost because + # Protocol.close() was called + if self.waiter is not None and not self.waiter.done(): + if exc is None: + self.waiter.set_result(None) + else: + self.waiter.set_exception(exc) + self.waiter = None + else: + # The connection was lost because it was + # terminated or due to another error; + # Throw an error in any awaiting waiter. + self.closing = True + # Cleanup the connection resources, including, possibly, + # releasing the pool holder. + con = self.get_connection() + if con is not None: + con._cleanup() + self._handle_waiter_on_connection_lost(exc) + + cdef _write(self, buf): + self.transport.write(memoryview(buf)) + + cdef _writelines(self, list buffers): + self.transport.writelines(buffers) + + # asyncio callbacks: + + def data_received(self, data): + self.buffer.feed_data(data) + self._read_server_messages() + + def connection_made(self, transport): + self.transport = transport + + sock = transport.get_extra_info('socket') + if (sock is not None and + (not hasattr(socket, 'AF_UNIX') + or sock.family != socket.AF_UNIX)): + sock.setsockopt(socket.IPPROTO_TCP, + socket.TCP_NODELAY, 1) + + try: + self._connect() + except Exception as ex: + transport.abort() + self.con_status = CONNECTION_BAD + self._set_state(PROTOCOL_FAILED) + self._on_error(ex) + + def connection_lost(self, exc): + self.con_status = CONNECTION_BAD + self._set_state(PROTOCOL_FAILED) + self._on_connection_lost(exc) + + def pause_writing(self): + self.writing_allowed.clear() + + def resume_writing(self): + self.writing_allowed.set() + + @property + def is_ssl(self): + return self._is_ssl + + @is_ssl.setter + def is_ssl(self, value): + self._is_ssl = value + + +class Timer: + def __init__(self, budget): + self._budget = budget + self._started = 0 + + def __enter__(self): + if self._budget is not None: + self._started = time.monotonic() + + def __exit__(self, et, e, tb): + if self._budget is not None: + self._budget -= time.monotonic() - self._started + + def get_remaining_budget(self): + return self._budget + + def has_budget_greater_than(self, amount): + if self._budget is None: + # Unlimited budget. + return True + else: + return self._budget > amount + + +class Protocol(BaseProtocol, asyncio.Protocol): + pass + + +def _create_record(object mapping, tuple elems): + # Exposed only for testing purposes. + + cdef: + object rec + int32_t i + + if mapping is None: + desc = record.ApgRecordDesc_New({}, ()) + else: + desc = record.ApgRecordDesc_New( + mapping, tuple(mapping) if mapping else ()) + + rec = record.ApgRecord_New(Record, desc, len(elems)) + for i in range(len(elems)): + elem = elems[i] + cpython.Py_INCREF(elem) + record.ApgRecord_SET_ITEM(rec, i, elem) + return rec + + +Record = record.ApgRecord_InitTypes() diff --git a/env/Lib/site-packages/asyncpg/protocol/record/__init__.pxd b/env/Lib/site-packages/asyncpg/protocol/record/__init__.pxd new file mode 100644 index 0000000..43ac5e3 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/record/__init__.pxd @@ -0,0 +1,19 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cimport cpython + + +cdef extern from "record/recordobj.h": + + cpython.PyTypeObject *ApgRecord_InitTypes() except NULL + + int ApgRecord_CheckExact(object) + object ApgRecord_New(type, object, int) + void ApgRecord_SET_ITEM(object, int, object) + + object ApgRecordDesc_New(object, object) diff --git a/env/Lib/site-packages/asyncpg/protocol/scram.pxd b/env/Lib/site-packages/asyncpg/protocol/scram.pxd new file mode 100644 index 0000000..5421429 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/scram.pxd @@ -0,0 +1,31 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef class SCRAMAuthentication: + cdef: + readonly bytes authentication_method + readonly bytes authorization_message + readonly bytes client_channel_binding + readonly bytes client_first_message_bare + readonly bytes client_nonce + readonly bytes client_proof + readonly bytes password_salt + readonly int password_iterations + readonly bytes server_first_message + # server_key is an instance of hmac.HAMC + readonly object server_key + readonly bytes server_nonce + + cdef create_client_first_message(self, str username) + cdef create_client_final_message(self, str password) + cdef parse_server_first_message(self, bytes server_response) + cdef verify_server_final_message(self, bytes server_final_message) + cdef _bytes_xor(self, bytes a, bytes b) + cdef _generate_client_nonce(self, int num_bytes) + cdef _generate_client_proof(self, str password) + cdef _generate_salted_password(self, str password, bytes salt, int iterations) + cdef _normalize_password(self, str original_password) diff --git a/env/Lib/site-packages/asyncpg/protocol/scram.pyx b/env/Lib/site-packages/asyncpg/protocol/scram.pyx new file mode 100644 index 0000000..9b485ae --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/scram.pyx @@ -0,0 +1,341 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import base64 +import hashlib +import hmac +import re +import secrets +import stringprep +import unicodedata + + +@cython.final +cdef class SCRAMAuthentication: + """Contains the protocol for generating and a SCRAM hashed password. + + Since PostgreSQL 10, the option to hash passwords using the SCRAM-SHA-256 + method was added. This module follows the defined protocol, which can be + referenced from here: + + https://www.postgresql.org/docs/current/sasl-authentication.html#SASL-SCRAM-SHA-256 + + libpq references the following RFCs that it uses for implementation: + + * RFC 5802 + * RFC 5803 + * RFC 7677 + + The protocol works as such: + + - A client connets to the server. The server requests the client to begin + SASL authentication using SCRAM and presents a client with the methods it + supports. At present, those are SCRAM-SHA-256, and, on servers that are + built with OpenSSL and + are PG11+, SCRAM-SHA-256-PLUS (which supports channel binding, more on that + below) + + - The client sends a "first message" to the server, where it chooses which + method to authenticate with, and sends, along with the method, an indication + of channel binding (we disable for now), a nonce, and the username. + (Technically, PostgreSQL ignores the username as it already has it from the + initical connection, but we add it for completeness) + + - The server responds with a "first message" in which it extends the nonce, + as well as a password salt and the number of iterations to hash the password + with. The client validates that the new nonce contains the first part of the + client's original nonce + + - The client generates a salted password, but does not sent this up to the + server. Instead, the client follows the SCRAM algorithm (RFC5802) to + generate a proof. This proof is sent aspart of a client "final message" to + the server for it to validate. + + - The server validates the proof. If it is valid, the server sends a + verification code for the client to verify that the server came to the same + proof the client did. PostgreSQL immediately sends an AuthenticationOK + response right after a valid negotiation. If the password the client + provided was invalid, then authentication fails. + + (The beauty of this is that the salted password is never transmitted over + the wire!) + + PostgreSQL 11 added support for the channel binding (i.e. + SCRAM-SHA-256-PLUS) but to do some ongoing discussion, there is a conscious + decision by several driver authors to not support it as of yet. As such, the + channel binding parameter is hard-coded to "n" for now, but can be updated + to support other channel binding methos in the future + """ + AUTHENTICATION_METHODS = [b"SCRAM-SHA-256"] + DEFAULT_CLIENT_NONCE_BYTES = 24 + DIGEST = hashlib.sha256 + REQUIREMENTS_CLIENT_FINAL_MESSAGE = ['client_channel_binding', + 'server_nonce'] + REQUIREMENTS_CLIENT_PROOF = ['password_iterations', 'password_salt', + 'server_first_message', 'server_nonce'] + SASLPREP_PROHIBITED = ( + stringprep.in_table_a1, # PostgreSQL treats this as prohibited + stringprep.in_table_c12, + stringprep.in_table_c21_c22, + stringprep.in_table_c3, + stringprep.in_table_c4, + stringprep.in_table_c5, + stringprep.in_table_c6, + stringprep.in_table_c7, + stringprep.in_table_c8, + stringprep.in_table_c9, + ) + + def __cinit__(self, bytes authentication_method): + self.authentication_method = authentication_method + self.authorization_message = None + # channel binding is turned off for the time being + self.client_channel_binding = b"n,," + self.client_first_message_bare = None + self.client_nonce = None + self.client_proof = None + self.password_salt = None + # self.password_iterations = None + self.server_first_message = None + self.server_key = None + self.server_nonce = None + + cdef create_client_first_message(self, str username): + """Create the initial client message for SCRAM authentication""" + cdef: + bytes msg + bytes client_first_message + + self.client_nonce = \ + self._generate_client_nonce(self.DEFAULT_CLIENT_NONCE_BYTES) + # set the client first message bare here, as it's used in a later step + self.client_first_message_bare = b"n=" + username.encode("utf-8") + \ + b",r=" + self.client_nonce + # put together the full message here + msg = bytes() + msg += self.authentication_method + b"\0" + client_first_message = self.client_channel_binding + \ + self.client_first_message_bare + msg += (len(client_first_message)).to_bytes(4, byteorder='big') + \ + client_first_message + return msg + + cdef create_client_final_message(self, str password): + """Create the final client message as part of SCRAM authentication""" + cdef: + bytes msg + + if any([getattr(self, val) is None for val in + self.REQUIREMENTS_CLIENT_FINAL_MESSAGE]): + raise Exception( + "you need values from server to generate a client proof") + + # normalize the password using the SASLprep algorithm in RFC 4013 + password = self._normalize_password(password) + + # generate the client proof + self.client_proof = self._generate_client_proof(password=password) + msg = bytes() + msg += b"c=" + base64.b64encode(self.client_channel_binding) + \ + b",r=" + self.server_nonce + \ + b",p=" + base64.b64encode(self.client_proof) + return msg + + cdef parse_server_first_message(self, bytes server_response): + """Parse the response from the first message from the server""" + self.server_first_message = server_response + try: + self.server_nonce = re.search(b'r=([^,]+),', + self.server_first_message).group(1) + except IndexError: + raise Exception("could not get nonce") + if not self.server_nonce.startswith(self.client_nonce): + raise Exception("invalid nonce") + try: + self.password_salt = re.search(b',s=([^,]+),', + self.server_first_message).group(1) + except IndexError: + raise Exception("could not get salt") + try: + self.password_iterations = int(re.search(b',i=(\d+),?', + self.server_first_message).group(1)) + except (IndexError, TypeError, ValueError): + raise Exception("could not get iterations") + + cdef verify_server_final_message(self, bytes server_final_message): + """Verify the final message from the server""" + cdef: + bytes server_signature + + try: + server_signature = re.search(b'v=([^,]+)', + server_final_message).group(1) + except IndexError: + raise Exception("could not get server signature") + + verify_server_signature = hmac.new(self.server_key.digest(), + self.authorization_message, self.DIGEST) + # validate the server signature against the verifier + return server_signature == base64.b64encode( + verify_server_signature.digest()) + + cdef _bytes_xor(self, bytes a, bytes b): + """XOR two bytestrings together""" + return bytes(a_i ^ b_i for a_i, b_i in zip(a, b)) + + cdef _generate_client_nonce(self, int num_bytes): + cdef: + bytes token + + token = secrets.token_bytes(num_bytes) + + return base64.b64encode(token) + + cdef _generate_client_proof(self, str password): + """need to ensure a server response exists, i.e. """ + cdef: + bytes salted_password + + if any([getattr(self, val) is None for val in + self.REQUIREMENTS_CLIENT_PROOF]): + raise Exception( + "you need values from server to generate a client proof") + # generate a salt password + salted_password = self._generate_salted_password(password, + self.password_salt, self.password_iterations) + # client key is derived from the salted password + client_key = hmac.new(salted_password, b"Client Key", self.DIGEST) + # this allows us to compute the stored key that is residing on the server + stored_key = self.DIGEST(client_key.digest()) + # as well as compute the server key + self.server_key = hmac.new(salted_password, b"Server Key", self.DIGEST) + # build the authorization message that will be used in the + # client signature + # the "c=" portion is for the channel binding, but this is not + # presently implemented + self.authorization_message = self.client_first_message_bare + b"," + \ + self.server_first_message + b",c=" + \ + base64.b64encode(self.client_channel_binding) + \ + b",r=" + self.server_nonce + # sign! + client_signature = hmac.new(stored_key.digest(), + self.authorization_message, self.DIGEST) + # and the proof + return self._bytes_xor(client_key.digest(), client_signature.digest()) + + cdef _generate_salted_password(self, str password, bytes salt, int iterations): + """This follows the "Hi" algorithm specified in RFC5802""" + cdef: + bytes p + bytes s + bytes u + + # convert the password to a binary string - UTF8 is safe for SASL + # (though there are SASLPrep rules) + p = password.encode("utf8") + # the salt needs to be base64 decoded -- full binary must be used + s = base64.b64decode(salt) + # the initial signature is the salt with a terminator of a 32-bit string + # ending in 1 + ui = hmac.new(p, s + b'\x00\x00\x00\x01', self.DIGEST) + # grab the initial digest + u = ui.digest() + # for X number of iterations, recompute the HMAC signature against the + # password and the latest iteration of the hash, and XOR it with the + # previous version + for x in range(iterations - 1): + ui = hmac.new(p, ui.digest(), hashlib.sha256) + # this is a fancy way of XORing two byte strings together + u = self._bytes_xor(u, ui.digest()) + return u + + cdef _normalize_password(self, str original_password): + """Normalize the password using the SASLprep from RFC4013""" + cdef: + str normalized_password + + # Note: Per the PostgreSQL documentation, PostgreSWL does not require + # UTF-8 to be used for the password, but will perform SASLprep on the + # password regardless. + # If the password is not valid UTF-8, PostgreSQL will then **not** use + # SASLprep processing. + # If the password fails SASLprep, the password should still be sent + # See: https://www.postgresql.org/docs/current/sasl-authentication.html + # and + # https://git.postgresql.org/gitweb/?p=postgresql.git;a=blob;f=src/common/saslprep.c + # using the `pg_saslprep` function + normalized_password = original_password + # if the original password is an ASCII string or fails to encode as a + # UTF-8 string, then no further action is needed + try: + original_password.encode("ascii") + except UnicodeEncodeError: + pass + else: + return original_password + + # Step 1 of SASLPrep: Map. Per the algorithm, we map non-ascii space + # characters to ASCII spaces (\x20 or \u0020, but we will use ' ') and + # commonly mapped to nothing characters are removed + # Table C.1.2 -- non-ASCII spaces + # Table B.1 -- "Commonly mapped to nothing" + normalized_password = u"".join( + ' ' if stringprep.in_table_c12(c) else c + for c in tuple(normalized_password) if not stringprep.in_table_b1(c) + ) + + # If at this point the password is empty, PostgreSQL uses the original + # password + if not normalized_password: + return original_password + + # Step 2 of SASLPrep: Normalize. Normalize the password using the + # Unicode normalization algorithm to NFKC form + normalized_password = unicodedata.normalize('NFKC', normalized_password) + + # If the password is not empty, PostgreSQL uses the original password + if not normalized_password: + return original_password + + normalized_password_tuple = tuple(normalized_password) + + # Step 3 of SASLPrep: Prohobited characters. If PostgreSQL detects any + # of the prohibited characters in SASLPrep, it will use the original + # password + # We also include "unassigned code points" in the prohibited character + # category as PostgreSQL does the same + for c in normalized_password_tuple: + if any( + in_prohibited_table(c) + for in_prohibited_table in self.SASLPREP_PROHIBITED + ): + return original_password + + # Step 4 of SASLPrep: Bi-directional characters. PostgreSQL follows the + # rules for bi-directional characters laid on in RFC3454 Sec. 6 which + # are: + # 1. Characters in RFC 3454 Sec 5.8 are prohibited (C.8) + # 2. If a string contains a RandALCat character, it cannot containy any + # LCat character + # 3. If the string contains any RandALCat character, an RandALCat + # character must be the first and last character of the string + # RandALCat characters are found in table D.1, whereas LCat are in D.2 + if any(stringprep.in_table_d1(c) for c in normalized_password_tuple): + # if the first character or the last character are not in D.1, + # return the original password + if not (stringprep.in_table_d1(normalized_password_tuple[0]) and + stringprep.in_table_d1(normalized_password_tuple[-1])): + return original_password + + # if any characters are in D.2, use the original password + if any( + stringprep.in_table_d2(c) for c in normalized_password_tuple + ): + return original_password + + # return the normalized password + return normalized_password diff --git a/env/Lib/site-packages/asyncpg/protocol/settings.pxd b/env/Lib/site-packages/asyncpg/protocol/settings.pxd new file mode 100644 index 0000000..0a1a5f6 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/settings.pxd @@ -0,0 +1,30 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +cdef class ConnectionSettings(pgproto.CodecContext): + cdef: + str _encoding + object _codec + dict _settings + bint _is_utf8 + DataCodecConfig _data_codecs + + cdef add_setting(self, str name, str val) + cdef is_encoding_utf8(self) + cpdef get_text_codec(self) + cpdef inline register_data_types(self, types) + cpdef inline add_python_codec( + self, typeoid, typename, typeschema, typeinfos, typekind, encoder, + decoder, format) + cpdef inline remove_python_codec( + self, typeoid, typename, typeschema) + cpdef inline clear_type_cache(self) + cpdef inline set_builtin_type_codec( + self, typeoid, typename, typeschema, typekind, alias_to, format) + cpdef inline Codec get_data_codec( + self, uint32_t oid, ServerDataFormat format=*, + bint ignore_custom_codec=*) diff --git a/env/Lib/site-packages/asyncpg/protocol/settings.pyx b/env/Lib/site-packages/asyncpg/protocol/settings.pyx new file mode 100644 index 0000000..8e6591b --- /dev/null +++ b/env/Lib/site-packages/asyncpg/protocol/settings.pyx @@ -0,0 +1,106 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +from asyncpg import exceptions + + +@cython.final +cdef class ConnectionSettings(pgproto.CodecContext): + + def __cinit__(self, conn_key): + self._encoding = 'utf-8' + self._is_utf8 = True + self._settings = {} + self._codec = codecs.lookup('utf-8') + self._data_codecs = DataCodecConfig(conn_key) + + cdef add_setting(self, str name, str val): + self._settings[name] = val + if name == 'client_encoding': + py_enc = get_python_encoding(val) + self._codec = codecs.lookup(py_enc) + self._encoding = self._codec.name + self._is_utf8 = self._encoding == 'utf-8' + + cdef is_encoding_utf8(self): + return self._is_utf8 + + cpdef get_text_codec(self): + return self._codec + + cpdef inline register_data_types(self, types): + self._data_codecs.add_types(types) + + cpdef inline add_python_codec(self, typeoid, typename, typeschema, + typeinfos, typekind, encoder, decoder, + format): + cdef: + ServerDataFormat _format + ClientExchangeFormat xformat + + if format == 'binary': + _format = PG_FORMAT_BINARY + xformat = PG_XFORMAT_OBJECT + elif format == 'text': + _format = PG_FORMAT_TEXT + xformat = PG_XFORMAT_OBJECT + elif format == 'tuple': + _format = PG_FORMAT_ANY + xformat = PG_XFORMAT_TUPLE + else: + raise exceptions.InterfaceError( + 'invalid `format` argument, expected {}, got {!r}'.format( + "'text', 'binary' or 'tuple'", format + )) + + self._data_codecs.add_python_codec(typeoid, typename, typeschema, + typekind, typeinfos, + encoder, decoder, + _format, xformat) + + cpdef inline remove_python_codec(self, typeoid, typename, typeschema): + self._data_codecs.remove_python_codec(typeoid, typename, typeschema) + + cpdef inline clear_type_cache(self): + self._data_codecs.clear_type_cache() + + cpdef inline set_builtin_type_codec(self, typeoid, typename, typeschema, + typekind, alias_to, format): + cdef: + ServerDataFormat _format + + if format is None: + _format = PG_FORMAT_ANY + elif format == 'binary': + _format = PG_FORMAT_BINARY + elif format == 'text': + _format = PG_FORMAT_TEXT + else: + raise exceptions.InterfaceError( + 'invalid `format` argument, expected {}, got {!r}'.format( + "'text' or 'binary'", format + )) + + self._data_codecs.set_builtin_type_codec(typeoid, typename, typeschema, + typekind, alias_to, _format) + + cpdef inline Codec get_data_codec(self, uint32_t oid, + ServerDataFormat format=PG_FORMAT_ANY, + bint ignore_custom_codec=False): + return self._data_codecs.get_codec(oid, format, ignore_custom_codec) + + def __getattr__(self, name): + if not name.startswith('_'): + try: + return self._settings[name] + except KeyError: + raise AttributeError(name) from None + + return object.__getattribute__(self, name) + + def __repr__(self): + return ''.format(self._settings) diff --git a/env/Lib/site-packages/asyncpg/serverversion.py b/env/Lib/site-packages/asyncpg/serverversion.py new file mode 100644 index 0000000..31568a2 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/serverversion.py @@ -0,0 +1,60 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import re + +from .types import ServerVersion + +version_regex = re.compile( + r"(Postgre[^\s]*)?\s*" + r"(?P[0-9]+)\.?" + r"((?P[0-9]+)\.?)?" + r"(?P[0-9]+)?" + r"(?P[a-z]+)?" + r"(?P[0-9]+)?" +) + + +def split_server_version_string(version_string): + version_match = version_regex.search(version_string) + + if version_match is None: + raise ValueError( + "Unable to parse Postgres " + f'version from "{version_string}"' + ) + + version = version_match.groupdict() + for ver_key, ver_value in version.items(): + # Cast all possible versions parts to int + try: + version[ver_key] = int(ver_value) + except (TypeError, ValueError): + pass + + if version.get("major") < 10: + return ServerVersion( + version.get("major"), + version.get("minor") or 0, + version.get("micro") or 0, + version.get("releaselevel") or "final", + version.get("serial") or 0, + ) + + # Since PostgreSQL 10 the versioning scheme has changed. + # 10.x really means 10.0.x. While parsing 10.1 + # as (10, 1) may seem less confusing, in practice most + # version checks are written as version[:2], and we + # want to keep that behaviour consistent, i.e not fail + # a major version check due to a bugfix release. + return ServerVersion( + version.get("major"), + 0, + version.get("minor") or 0, + version.get("releaselevel") or "final", + version.get("serial") or 0, + ) diff --git a/env/Lib/site-packages/asyncpg/transaction.py b/env/Lib/site-packages/asyncpg/transaction.py new file mode 100644 index 0000000..562811e --- /dev/null +++ b/env/Lib/site-packages/asyncpg/transaction.py @@ -0,0 +1,246 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import enum + +from . import connresource +from . import exceptions as apg_errors + + +class TransactionState(enum.Enum): + NEW = 0 + STARTED = 1 + COMMITTED = 2 + ROLLEDBACK = 3 + FAILED = 4 + + +ISOLATION_LEVELS = { + 'read_committed', + 'read_uncommitted', + 'serializable', + 'repeatable_read', +} +ISOLATION_LEVELS_BY_VALUE = { + 'read committed': 'read_committed', + 'read uncommitted': 'read_uncommitted', + 'serializable': 'serializable', + 'repeatable read': 'repeatable_read', +} + + +class Transaction(connresource.ConnectionResource): + """Represents a transaction or savepoint block. + + Transactions are created by calling the + :meth:`Connection.transaction() ` + function. + """ + + __slots__ = ('_connection', '_isolation', '_readonly', '_deferrable', + '_state', '_nested', '_id', '_managed') + + def __init__(self, connection, isolation, readonly, deferrable): + super().__init__(connection) + + if isolation and isolation not in ISOLATION_LEVELS: + raise ValueError( + 'isolation is expected to be either of {}, ' + 'got {!r}'.format(ISOLATION_LEVELS, isolation)) + + self._isolation = isolation + self._readonly = readonly + self._deferrable = deferrable + self._state = TransactionState.NEW + self._nested = False + self._id = None + self._managed = False + + async def __aenter__(self): + if self._managed: + raise apg_errors.InterfaceError( + 'cannot enter context: already in an `async with` block') + self._managed = True + await self.start() + + async def __aexit__(self, extype, ex, tb): + try: + self._check_conn_validity('__aexit__') + except apg_errors.InterfaceError: + if extype is GeneratorExit: + # When a PoolAcquireContext is being exited, and there + # is an open transaction in an async generator that has + # not been iterated fully, there is a possibility that + # Pool.release() would race with this __aexit__(), since + # both would be in concurrent tasks. In such case we + # yield to Pool.release() to do the ROLLBACK for us. + # See https://github.com/MagicStack/asyncpg/issues/232 + # for an example. + return + else: + raise + + try: + if extype is not None: + await self.__rollback() + else: + await self.__commit() + finally: + self._managed = False + + @connresource.guarded + async def start(self): + """Enter the transaction or savepoint block.""" + self.__check_state_base('start') + if self._state is TransactionState.STARTED: + raise apg_errors.InterfaceError( + 'cannot start; the transaction is already started') + + con = self._connection + + if con._top_xact is None: + if con._protocol.is_in_transaction(): + raise apg_errors.InterfaceError( + 'cannot use Connection.transaction() in ' + 'a manually started transaction') + con._top_xact = self + else: + # Nested transaction block + if self._isolation: + top_xact_isolation = con._top_xact._isolation + if top_xact_isolation is None: + top_xact_isolation = ISOLATION_LEVELS_BY_VALUE[ + await self._connection.fetchval( + 'SHOW transaction_isolation;')] + if self._isolation != top_xact_isolation: + raise apg_errors.InterfaceError( + 'nested transaction has a different isolation level: ' + 'current {!r} != outer {!r}'.format( + self._isolation, top_xact_isolation)) + self._nested = True + + if self._nested: + self._id = con._get_unique_id('savepoint') + query = 'SAVEPOINT {};'.format(self._id) + else: + query = 'BEGIN' + if self._isolation == 'read_committed': + query += ' ISOLATION LEVEL READ COMMITTED' + elif self._isolation == 'read_uncommitted': + query += ' ISOLATION LEVEL READ UNCOMMITTED' + elif self._isolation == 'repeatable_read': + query += ' ISOLATION LEVEL REPEATABLE READ' + elif self._isolation == 'serializable': + query += ' ISOLATION LEVEL SERIALIZABLE' + if self._readonly: + query += ' READ ONLY' + if self._deferrable: + query += ' DEFERRABLE' + query += ';' + + try: + await self._connection.execute(query) + except BaseException: + self._state = TransactionState.FAILED + raise + else: + self._state = TransactionState.STARTED + + def __check_state_base(self, opname): + if self._state is TransactionState.COMMITTED: + raise apg_errors.InterfaceError( + 'cannot {}; the transaction is already committed'.format( + opname)) + if self._state is TransactionState.ROLLEDBACK: + raise apg_errors.InterfaceError( + 'cannot {}; the transaction is already rolled back'.format( + opname)) + if self._state is TransactionState.FAILED: + raise apg_errors.InterfaceError( + 'cannot {}; the transaction is in error state'.format( + opname)) + + def __check_state(self, opname): + if self._state is not TransactionState.STARTED: + if self._state is TransactionState.NEW: + raise apg_errors.InterfaceError( + 'cannot {}; the transaction is not yet started'.format( + opname)) + self.__check_state_base(opname) + + async def __commit(self): + self.__check_state('commit') + + if self._connection._top_xact is self: + self._connection._top_xact = None + + if self._nested: + query = 'RELEASE SAVEPOINT {};'.format(self._id) + else: + query = 'COMMIT;' + + try: + await self._connection.execute(query) + except BaseException: + self._state = TransactionState.FAILED + raise + else: + self._state = TransactionState.COMMITTED + + async def __rollback(self): + self.__check_state('rollback') + + if self._connection._top_xact is self: + self._connection._top_xact = None + + if self._nested: + query = 'ROLLBACK TO {};'.format(self._id) + else: + query = 'ROLLBACK;' + + try: + await self._connection.execute(query) + except BaseException: + self._state = TransactionState.FAILED + raise + else: + self._state = TransactionState.ROLLEDBACK + + @connresource.guarded + async def commit(self): + """Exit the transaction or savepoint block and commit changes.""" + if self._managed: + raise apg_errors.InterfaceError( + 'cannot manually commit from within an `async with` block') + await self.__commit() + + @connresource.guarded + async def rollback(self): + """Exit the transaction or savepoint block and rollback changes.""" + if self._managed: + raise apg_errors.InterfaceError( + 'cannot manually rollback from within an `async with` block') + await self.__rollback() + + def __repr__(self): + attrs = [] + attrs.append('state:{}'.format(self._state.name.lower())) + + if self._isolation is not None: + attrs.append(self._isolation) + if self._readonly: + attrs.append('readonly') + if self._deferrable: + attrs.append('deferrable') + + if self.__class__.__module__.startswith('asyncpg.'): + mod = 'asyncpg' + else: + mod = self.__class__.__module__ + + return '<{}.{} {} {:#x}>'.format( + mod, self.__class__.__name__, ' '.join(attrs), id(self)) diff --git a/env/Lib/site-packages/asyncpg/types.py b/env/Lib/site-packages/asyncpg/types.py new file mode 100644 index 0000000..bd5813f --- /dev/null +++ b/env/Lib/site-packages/asyncpg/types.py @@ -0,0 +1,177 @@ +# Copyright (C) 2016-present the asyncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import collections + +from asyncpg.pgproto.types import ( + BitString, Point, Path, Polygon, + Box, Line, LineSegment, Circle, +) + + +__all__ = ( + 'Type', 'Attribute', 'Range', 'BitString', 'Point', 'Path', 'Polygon', + 'Box', 'Line', 'LineSegment', 'Circle', 'ServerVersion', +) + + +Type = collections.namedtuple('Type', ['oid', 'name', 'kind', 'schema']) +Type.__doc__ = 'Database data type.' +Type.oid.__doc__ = 'OID of the type.' +Type.name.__doc__ = 'Type name. For example "int2".' +Type.kind.__doc__ = \ + 'Type kind. Can be "scalar", "array", "composite" or "range".' +Type.schema.__doc__ = 'Name of the database schema that defines the type.' + + +Attribute = collections.namedtuple('Attribute', ['name', 'type']) +Attribute.__doc__ = 'Database relation attribute.' +Attribute.name.__doc__ = 'Attribute name.' +Attribute.type.__doc__ = 'Attribute data type :class:`asyncpg.types.Type`.' + + +ServerVersion = collections.namedtuple( + 'ServerVersion', ['major', 'minor', 'micro', 'releaselevel', 'serial']) +ServerVersion.__doc__ = 'PostgreSQL server version tuple.' + + +class Range: + """Immutable representation of PostgreSQL `range` type.""" + + __slots__ = '_lower', '_upper', '_lower_inc', '_upper_inc', '_empty' + + def __init__(self, lower=None, upper=None, *, + lower_inc=True, upper_inc=False, + empty=False): + self._empty = empty + if empty: + self._lower = self._upper = None + self._lower_inc = self._upper_inc = False + else: + self._lower = lower + self._upper = upper + self._lower_inc = lower is not None and lower_inc + self._upper_inc = upper is not None and upper_inc + + @property + def lower(self): + return self._lower + + @property + def lower_inc(self): + return self._lower_inc + + @property + def lower_inf(self): + return self._lower is None and not self._empty + + @property + def upper(self): + return self._upper + + @property + def upper_inc(self): + return self._upper_inc + + @property + def upper_inf(self): + return self._upper is None and not self._empty + + @property + def isempty(self): + return self._empty + + def _issubset_lower(self, other): + if other._lower is None: + return True + if self._lower is None: + return False + + return self._lower > other._lower or ( + self._lower == other._lower + and (other._lower_inc or not self._lower_inc) + ) + + def _issubset_upper(self, other): + if other._upper is None: + return True + if self._upper is None: + return False + + return self._upper < other._upper or ( + self._upper == other._upper + and (other._upper_inc or not self._upper_inc) + ) + + def issubset(self, other): + if self._empty: + return True + if other._empty: + return False + + return self._issubset_lower(other) and self._issubset_upper(other) + + def issuperset(self, other): + return other.issubset(self) + + def __bool__(self): + return not self._empty + + def __eq__(self, other): + if not isinstance(other, Range): + return NotImplemented + + return ( + self._lower, + self._upper, + self._lower_inc, + self._upper_inc, + self._empty + ) == ( + other._lower, + other._upper, + other._lower_inc, + other._upper_inc, + other._empty + ) + + def __hash__(self): + return hash(( + self._lower, + self._upper, + self._lower_inc, + self._upper_inc, + self._empty + )) + + def __repr__(self): + if self._empty: + desc = 'empty' + else: + if self._lower is None or not self._lower_inc: + lb = '(' + else: + lb = '[' + + if self._lower is not None: + lb += repr(self._lower) + + if self._upper is not None: + ub = repr(self._upper) + else: + ub = '' + + if self._upper is None or not self._upper_inc: + ub += ')' + else: + ub += ']' + + desc = '{}, {}'.format(lb, ub) + + return ''.format(desc) + + __str__ = __repr__ diff --git a/env/Lib/site-packages/asyncpg/utils.py b/env/Lib/site-packages/asyncpg/utils.py new file mode 100644 index 0000000..3940e04 --- /dev/null +++ b/env/Lib/site-packages/asyncpg/utils.py @@ -0,0 +1,45 @@ +# Copyright (C) 2016-present the ayncpg authors and contributors +# +# +# This module is part of asyncpg and is released under +# the Apache 2.0 License: http://www.apache.org/licenses/LICENSE-2.0 + + +import re + + +def _quote_ident(ident): + return '"{}"'.format(ident.replace('"', '""')) + + +def _quote_literal(string): + return "'{}'".format(string.replace("'", "''")) + + +async def _mogrify(conn, query, args): + """Safely inline arguments to query text.""" + # Introspect the target query for argument types and + # build a list of safely-quoted fully-qualified type names. + ps = await conn.prepare(query) + paramtypes = [] + for t in ps.get_parameters(): + if t.name.endswith('[]'): + pname = '_' + t.name[:-2] + else: + pname = t.name + + paramtypes.append('{}.{}'.format( + _quote_ident(t.schema), _quote_ident(pname))) + del ps + + # Use Postgres to convert arguments to text representation + # by casting each value to text. + cols = ['quote_literal(${}::{}::text)'.format(i, t) + for i, t in enumerate(paramtypes, start=1)] + + textified = await conn.fetchrow( + 'SELECT {cols}'.format(cols=', '.join(cols)), *args) + + # Finally, replace $n references with text values. + return re.sub( + r'\$(\d+)\b', lambda m: textified[int(m.group(1)) - 1], query) diff --git a/env/Lib/site-packages/attr/__init__.py b/env/Lib/site-packages/attr/__init__.py new file mode 100644 index 0000000..51b1c25 --- /dev/null +++ b/env/Lib/site-packages/attr/__init__.py @@ -0,0 +1,103 @@ +# SPDX-License-Identifier: MIT + +""" +Classes Without Boilerplate +""" + +from functools import partial +from typing import Callable + +from . import converters, exceptions, filters, setters, validators +from ._cmp import cmp_using +from ._compat import Protocol +from ._config import get_run_validators, set_run_validators +from ._funcs import asdict, assoc, astuple, evolve, has, resolve_types +from ._make import ( + NOTHING, + Attribute, + Converter, + Factory, + attrib, + attrs, + fields, + fields_dict, + make_class, + validate, +) +from ._next_gen import define, field, frozen, mutable +from ._version_info import VersionInfo + + +s = attributes = attrs +ib = attr = attrib +dataclass = partial(attrs, auto_attribs=True) # happy Easter ;) + + +class AttrsInstance(Protocol): + pass + + +__all__ = [ + "Attribute", + "AttrsInstance", + "Converter", + "Factory", + "NOTHING", + "asdict", + "assoc", + "astuple", + "attr", + "attrib", + "attributes", + "attrs", + "cmp_using", + "converters", + "define", + "evolve", + "exceptions", + "field", + "fields", + "fields_dict", + "filters", + "frozen", + "get_run_validators", + "has", + "ib", + "make_class", + "mutable", + "resolve_types", + "s", + "set_run_validators", + "setters", + "validate", + "validators", +] + + +def _make_getattr(mod_name: str) -> Callable: + """ + Create a metadata proxy for packaging information that uses *mod_name* in + its warnings and errors. + """ + + def __getattr__(name: str) -> str: + if name not in ("__version__", "__version_info__"): + msg = f"module {mod_name} has no attribute {name}" + raise AttributeError(msg) + + try: + from importlib.metadata import metadata + except ImportError: + from importlib_metadata import metadata + + meta = metadata("attrs") + + if name == "__version_info__": + return VersionInfo._from_version_string(meta["version"]) + + return meta["version"] + + return __getattr__ + + +__getattr__ = _make_getattr(__name__) diff --git a/env/Lib/site-packages/attr/__init__.pyi b/env/Lib/site-packages/attr/__init__.pyi new file mode 100644 index 0000000..6ae0a83 --- /dev/null +++ b/env/Lib/site-packages/attr/__init__.pyi @@ -0,0 +1,388 @@ +import enum +import sys + +from typing import ( + Any, + Callable, + Generic, + 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 +else: + from typing_extensions import TypeGuard + +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 + +# 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. +if sys.version_info >= (3, 8): + from typing import Literal + @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: ... + +else: + @overload + def Factory(factory: Callable[[], _T]) -> _T: ... + @overload + def Factory( + factory: Union[Callable[[Any], _T], Callable[[], _T]], + takes_self: bool = ..., + ) -> _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: _ConverterType | Converter[Any, _T] | 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=) -> 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 = ..., + 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 | Converter[Any, _T] | None = ..., + factory: Callable[[], _T] | None = ..., + kw_only: bool = ..., + 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 | Converter[Any, _T] | None = ..., + factory: Callable[[], _T] | None = ..., + kw_only: bool = ..., + 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 | Converter[Any, _T] | None = ..., + factory: Callable[[], _T] | None = ..., + kw_only: bool = ..., + 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) ;) diff --git a/env/Lib/site-packages/attr/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/attr/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c5344a1dc0bcc55c9e29402b4ce4e78695ec50e5 GIT binary patch literal 3168 zcmcgu-)kJl9iQFX`+d^Mcd{hQwzQUfc20@pBvw+B27@gnmO`tv*feAiY*)8)@>V;$ z*V#Q;7BW4Gp(^yjFU1Cv5(;r!(uY0-8tA{!hf~qRG1Oq_Q{Jwq4vfc3tF=Ro=$=j2UN9ojsboAc~2WTE+q8{H0?k$F9EJti8S9kJXuC|%WLx?zjR zwLR!&=4{WiS3LF&Dyt@Ct`_*~OhinCGRHP*tP#0^AIfyy_0(iKWKq1jZhNj{M}Y`I zQMSe#Rx@<{Rn+MX}C{L@hihx?4=lcPTT8;@k7E0)gTFUM*|1yvJWp2F8X0) z`!%*yO~{O8`8H>kC3BX=1E=X>zhGHEZQ5SE@&~eqy1%_P|K9Q^fmmCf3mkC7@>)}% zd#sfpT4w(G^7q`8<|U&qL_ z=EdthiRw8q)a#33?2RCtM8J(=0O16HH1Iv*6n1m5O~6Z`7)60RLJDCVp@fh|FcD58 zoIwC0A>tfDA3_;G>h6j-i=zpIL7dV;frb@XgfRrg~M=@C&3RErMRJIQsLWy0J~_KvVY%_p~kanz7l)nNa2ggDf*`le5T%#IVhV2sZAT z^+1@h#lb123lSo?jag+zx9!MmV!BTC&Nl@DN}C&n<{ex3uqQNa-!YjGkZLn(Q5xuZ z@iv_BrHi0t_Wlm=YwaP~f~%}+V%X7tX*?!QVv9T`pBeYG=(+1}X~)^*=UO)AUf|?= zz{&p5B#F>N2jx6iS214FGh&HPiErE?8;MWJ9Ze@&x|2Gt@gBU_Nv|p96QdEj{Gj~g zQ14d4$zX)U<@o-adbR8H&Mr50QOs?lP|W1-)rZwc1l+tEwoElp?+<|?e^T$lKFXgr&QT3RoaD0 z*GOb%JB7>bm+Jo0;%Jv>+1Vp_r5x<+CO~X|f4`d|10&lTkJ39ubGK-28_(b{<;vgk zm3F@Jv^=(3zWk^8uTOpT@lJVuw>;l2%s(rZA1warXYI^bSb+2YCRHI{3|vY4S-X+| zw~0o9q&3zK9#ueI&NDKDw68xyZ$8CozSfz9AUT-)7#AbM&hCAq3b;x(yuc{sLVf%lnT|KYqUGo2j5u&}@Chz>`+94O($17xNX}C>> zT3YL)PNCE$rIy~h)hU#>Z#?+m_eQ%gy;GRpEljtv-IS(ffdXEF2Mhni*?%1^WhU}q rgC4Zf-H)_kZTQh#mq7FRf@)rbSyDW+%^xl7^jCKKE3G{KROI{{p$SCs literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/attr/__pycache__/_cmp.cpython-311.pyc b/env/Lib/site-packages/attr/__pycache__/_cmp.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ce3b8a109a523163188498baa56df7c32d9b130c GIT binary patch literal 5377 zcmcgwO>7&-6`ox#$t5X?q$Jys=_q5_ZY4&nkj1g>2dXb(N)(t8g*PzHkt3kWb!6i99?+ya45eQ%b( zR@_UGj+Sp{=l9L~`Q97-Zg4P6p#1sMzhx3JLjH~)?Gk8J9;Kl2F)@fCndE}^mM%z! zZ1_w$@4MiWh@lvMBVYs#)d=18Ur<7%_s@tM1FO;nzcIKUSh6ES=% zK|@(lE98Uk8G#km@wfX4F@hCx2WH&w%vy^W>IoR&^l;I?2aE{eh>G;VGnJqbE)Np2 z66{+wQjxZ;Iw0oAPn|PZk+;nm5_5b{ofED2w#|u&Im%P##4F0SIm0-|33cVN+>ucw z;0$!zGg6M!A{ogTSyk^SAUF7VWhGSc^XDp|<&NCe)plR++ZpbD-2pw`@8}XN(N_tk z<@e-^Vh9fyqpjLhL6%72`HE`CjU6jtXGeF9O1OWOUrNrdZtrr3_e!XL9Pk?g%iXCz zh9iV2lo`%+hf$rTP2IMsv!pvTtrzGbqeW<72F(>5i>7qP;dU~UW2TXM-lnM(yOc^D zg15yD#-S=!(+dVPrSrv9it0RD%Cmw4i&`{YvK=d*D>EvVplM6ekcObO~XbEuV}VoMyBXU>vk*ff`+z_!VB+YyUd1%~5Nsb84R zA!t8Dv+&Nc6=X}Wh}=_P5l+di%Q=G?Ek0i5S^KzH1f|0+(Sy#_BJ7o%(M=N_l~(8+ ztUuWugabRhB@`JPm|fP*5=xd`D(PmAGCGbTnV9!C@;T<=k zbJzsVAqFJrEX(MC0s=KAy76(MwbXgWXsU}IDVhPB%3I*b26ObB*>aR0AbxAPLe7EOpw<$qfG;<$xpY*$&djH@=XO{u@M-(Q+18;qttE7=H-Crm4?oAxQFc%ARUUUnSFH&t?X@sGLR=RQ~NS%0vqlij-l2a@*1on z6G!8?o9joDwB1mFUD1TKxdG3BIr8ZS^kR_}3^%5wmst8@*Q4C$pK*xLiIxBLe-v%_|-$c2o`3q} z!N9)=km_sAFj2>vMDo9~sSY;O#Fy&C19jqyeJ^jQM;q$Vx_Y!3AZn-{8LtN?;CUeE zdfa<^Z9q4p<4vN3CSdT$J5p_CYk1GC^B*0)akxIPcPlp5h#kDUVaUU&@ODVkzdL`#9(J6tAQ{M7uS%4;d2-W~7QEX;r#D|9^ zR9GB`dl)J2>H1(74ca`HV1yk70ye0Uor#)qEnI^?A&z@+eG+TfD2vvb6Hw(yitw|a z0RmIQia!DJZj%8rFj_t9iL_S^C{7{Ld8m8{;8~L(dzV(#71@w0b)QBDepA1cGjqC*n zdKlkvee}9WvfZGj8CF`;V3>k~INlTaNn{$0 zil$l?x(}O?ypLUHfgr+$RsYT=`4%!tcJ04)^m-ous;5`aK2&GE7~Q`<-x!^$t25ry z^bvn#bq-u)V7U6`cEd(-BM*;$0^~zs+P(i4s7W=Fk{f!vgTN+iIu3VAoSBFXTN zgEimU6PNwB$j6dIuEh;NJ7I_X2QU-TGCBF8C-vj-EzGZFX;shC9*0h3S%JM*UZZGFZ>wZ8$;6#ppofDWV)_QZ`U^Z zxX?C+age063~#S=wF_9#ZtT%{3FC)UJ}30r@(9fSF=?Md{Y{CB@RZOo)FFSy`)P0P zeu$oigbv#A=6EG%LoyGZPA6r73Ya;235>?k82jSEL1^GeZetIEsepY5%s*;G==$tu zZ#4EFt4EI2m1CZOgL7EsIflT=FrR`K-w(v~3nUTg8=uBj6om*2!t;c{#ZJO<#9~4n zkfi1RzdjA7aJ@MRn`cI>upZ}{; zA9)iW5`*dLz-BPgeRl5Nj3%1VlqAKQWE(y0i%6qQ(jj|BrQs&&kfb8LDnU@|(ji6q LAvQco#PR+EGSW;G literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/attr/__pycache__/_compat.cpython-311.pyc b/env/Lib/site-packages/attr/__pycache__/_compat.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..419943e7732c8cb1dfa304024ea4d0b689058b7a GIT binary patch literal 3918 zcmcImO>Eo96&{lMp?)b@ie!78nA;@lC{5hNF}%rcQ8Y*vSr=QwUGKKA>Xx8I%BD<_ z+Tl2{4F?s96!5_)d~lHf#R5L1TjbJ13-q2#4?V~RffWcWV4hXO9#gR!T+;g5bA z$F~kgPxEHpJPzOc-h1w2(hIxx^y$94Sa)bX4~KnKI+@ zY?*ccxiSa;tRAX|%i(&Y9AT&&r$_62nP(7-RHhaS6u*SQtAIgDXa)2mRF11`4bI>- zg;B!4VTS@1DUp>hWy;BOrJ}x6>Rc(_mr9>274xNpbEV?GROVc%gfEpnS1RdC4fIJx zR$MFK3o&Zbl%A{S%XtPFxywksa0THogVaJfKaY&~6ST(7qbJliDX_gOrw-sG@Qhw8 z7u8~IFfeI($l#RpGgKa8(Icb?&ybRN37&Z6dc(E#F!+tDy%X%{_gi^H$-?f73NwdF z14mS7ro=kYAIpt~W-K}UochJ8YE;w`s1~fC zypm4yeU0%lxTS;aCjv9xHC1=V=G@QJp#U};3X z*^nzM@{(#T$b{hUNfoo+kjZ#s-N{IxwD+C32%4|L&$=c$!%|bEsP!rqb>3F zpCXP20ANZ|klVI>4KqJ)7)l?a$A z>g1*S9n*ZYMzCCg@7VaIYZ;#x$$CTWw;(p_qAXTqU6&Vi^@fO5vWg9`gg9dws`z9X zfb>|!B3V|k>gv)g(SRk-p;m|!gF_lJe3*)9bUE># z%KEDM5ymEVVxNIc+#w((WT|@9;RAD6^hlzJ3v?5pNHa7*(ZqV+<=!>>#9LSttx6{i~^O2YP~_$y9r_j)2}Y^9uh*jW)Uaekg;4>iHa>J@|a@7 za^l@Af@vH(vDrY#3A;KWIlfC5BJOUh4=j0_6Wl{d?y5v1Z=-Z3aLy9_02Et`K)m#k z-(I5-8Eof@JCpy+Uf5A~m+eC7>%y&r!ma(ngk6}}&)%`KceWz!M3#zP+o`_z$*yJ> zuK#7so_JtSOt%WOw{t@;-rc=t=f+yeu|pxZMKCQARcV`0y-ud+EsY`gu+*g*|^}y$wC-*mvGsCj-#LT4G$+c{RWb zZ-KhO-|af<%3Gb)BlQTBSv2CoPjQsWZbQt5V&jLI{4Q^2y0*_uw=&a*x#I3!J9o2{ zyxFzTb}`Gb{BAh=)9WorJ?3=`U zA$`r+0HVk02N3Dx9E4U8jshq;GaV>AoTgC?g$BATE_rtuv7*bCC0@J#bBo|#l!8*_ zhJPTkC|jy~E6~XJOo^kma(98P=yjHw*TmYAX289GaagzpPz3u4K0^`UYm%rY{2~1? z_*o-Bn&>bZd$#$zr>*D}=xrgp{j|l8v=hSCq-%%LB@b(SLzf9$P3lk_*DWVTma!_+ z%Y`Gr6-kGJL@zJn@?r(kNWmc>P6RLqBHl4CG}g(oX-HbVp{q2Zx%VBo$IZ{qJ4qQr#)by%@Qmbi%p`Mb=4TwSnO-Wf0Ksnj241 zlhBmp;`m$s`(8Z!0DlT|)LYiSfI?+tnBxdygl3vPZ6q|^r;XxG_i3X{E9i&lX6vlp zMq;bKgG&Cr=9(S7x*r|0qhnu99Yk+8L+y0dPG5R~_m~&hPJd^wdXT=+OuS`Q7_f!W zJ$5g<$J)Z>y(b64cr)4lKh45{Ls6T{?NkrAkrp>XV|%#GkGJ0Fr|m=mDnod<6hKJ#z0ouZ1D>T~M4>e3HJ(K(2U` z{F~1Gr@OGspv>sj`u4B(1<@A7X7V@^VltrU4Pp&|+h22$2XXW|9(|DKUgsE~{{=V) Bvqt~` literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/attr/__pycache__/_config.cpython-311.pyc b/env/Lib/site-packages/attr/__pycache__/_config.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f996182dbf54fa8466eeed7c8feb0b2330335dde GIT binary patch literal 1163 zcmd5*&1(}u6rbHq+nA;wR%o%+^29?8)U|#dim3Q;5JkaOg|e`j>`c<7o1HK-X-TON z#DjtdZxzIAMSAtm@DRa+EC>bvfj|+YC*N$FwAh0leIdVj`#ygA=DoKc1_p8j<f%>^)_B5|wqr2(v2o0%10_nDc@x*erwSu%04%d{TpX~5t{*Og0YTo>In z$pfl6o1KLV=iQ6$4BSQXFp5&z5>oN1SmtaRN_7pP1{x`GFd(HeRi$B|1;l&>ibblm zRK+61w8~YD2Hb_mio>qm-LKa*-DaVprHHdLg<_X4jFsk;xv63G*c9Gr3aWLb0jnwr z5xEZvnIsn~6G-ELCmCZ+j?6b|{En1DCPROWv0x_-(j-n*Rg{?lz|M`^v))r7m%Lko zg>l7Os!KC+za+HB<7MxDSn^b;`B}Wf60LCMnVX&S0}+?Qid$<)LzF@m6*Ys8}GXSkkofBawMLWWNE^kQByHQRZ{sZS+Jd zGoFT-h3NBr8b!XJrti)s%^NhyU9O$%)v93ih+mVY!=~NpIzrpAEUVp1^3XbUxs|)p b?Asa{Z4R}2^VWEqbYU`UO|;2jNMG<988b9@ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/attr/__pycache__/_funcs.cpython-311.pyc b/env/Lib/site-packages/attr/__pycache__/_funcs.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..57205c404bda4c3c05252f22afba0c4bff480a36 GIT binary patch literal 16976 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�zQcl z=Y2IE+k6^avDWxV>jxRD-#sZW42V!aB{KsWaPBnRX-w6=W=z%IvFHq*0$S6fq^p#V zbt{4^wOiGf6zFq-Zwpv4?o9jAm1%d{pKeG)DwD1P-Ka=om(_G2-3aPrOk2~Av>|Q3 zR4rD(ma;x2fH%Y@Rv1hX)|Zopx5$5hmW83{Aa{}r5B}Isn)WN=XpVVlB6yJ4oP(nr znUrpf6}MxEDl(@?Y*%QO4mt0OK?$qdMS3bhu|`=Zj$Irj6sP{9Y>cUNdAYY7!^#~D zh7$Uh`dXqN+!#2m(cpHTPNJXt+yh4!55}W6Awb3W*)z&Nk{Bf>aeSO*sW(o0*Y^f5 zLmF^1a;p#Do}9XTB_w}t5Po~H;85u{J$mj6JX`ZT#j)uUipazQ z(FCPP+j8IJuH*3y%GA@h@SS*YC%9TQbxMZ1D|F8>8kujQzKMLX%I=3FsVnI6N_Ehl zqmwt;p4-G9M`YQsE-|82jA}%J6O+io1jct%+NG)S;OHoo1r;$lmApQcT$g$*p-bud zBq;4T{N8BtzKikK$Pz0bh*K2#1vwmp#hbDvd4E5c?I~hY4wkCxndl|79|$*Vj#A?h zeWR8KMNJaXrEtlwV;`J0Cuy?)d2>`ey`|=H45s7QZX7v?VUi)y$Rac73YDeG9pby5 z_XWY|+#u|M187D5*-OL1C`~vxas+#O@vUCmh8PL+09mlkNj8cFq)E`iGEt0*2M-1Z z_V(}S-x2I(Hk`dIUmHdmphz4!za-W!mQ+&uiYOQ0j0pQMu_hkHa(C)Na4B8#<2fqt zy;{l&*677A^BnK%M`n~7>?OOS-XOU*LW*ilpibC4jc@f%Lr!Eo!FPF=>lZC@laD~9 zkEoThub-8KjX`_}O_Uc&lcD|E4ACqQOI;N&<`U9Z|i>XvN zwHN6CM@Re68Mz)%36n06!o-o#Gtvp7tD>g)t{1_Gn#ysx#{m_ei%8VFLGyUmk?9X9 zkI;*V=Ayb3=W|i)Pkc#9B?=GyLALX6Kl>i0!XV)C$4O64A15*y1Q&#a&~?>BO9?8e z;i)D;cDGb*nl?B<6{o!PYgUIiNfZIO;e&#bS}9Xe+_tOn^k~8AA=rxvO>gj-=)@#C962T=PLFK>xO2zOfo(hX zZrd@iY0l*&NNS=HzLZtH(kplF&}2(ykiR0Teup--9A!15B&?Xw6KQ4k&tLU|h6-<< z5k^VYZ4FnRbP2z94rs~A=qSw#j+_MfiUONs@v9hELFQDdNskH9%Q8@&UT_ndE4%T3 zloWVN6DO_=mSx{m8)|@)&yp=#d1=*{JGFhOcPgHUT#7OiQ#P#87LwyJ&~h4KWlG;e z;e*$s*AI^F-9IqO`U&D-CIi+-CUvD8f_&}V&Cy2Yfy%R@sVEkarGa!#W2!=_a%#;x zt3r>!I?x1*NKt8qg^0YL@&TW-R4T!{7z3*~3M5A(qSy1)-Tj<30=2#r0qcd11KNcF zjdMNVL&21g%T90zF_ao5S8|61=!`lt`XEar*)(z#m42lk+X${3LDf3f7n4@0@u7!4 zj2iD%m!!*EOz;^l_@Qwa^(z@DLqLUa5gyUjSTq7fUx|)Q(GbVU0gX=lLwF{yz4`JM z<3l@Qm)euqxJ!{6s0>uS4qtduLlR~z!t~dM@iE3JhT{ng3CiqSpBB|N@zb zy;3iJ&`(t04$n@4jLCrB`aq|k)lJxDjB~b0k8aWi@rB;riB^$FRVf1m<>V4mweo<~ zQ<){lw+!0d)l$M-!(1Kwax`k)fa0!a&L*1Y>OQc%3o%S-C$%~2oPQ2`tj#&+0x8p+ z`(3z`dmsP&fZ#>7WTthhb2Uh%LO->HJ73Gj4$bCj^)+P>=CBtoL_Gn#p|O}zzE*BY z2bX60uel;g_Wq??z1O=j)Dj?L{?K`BgQRY%e7wZJDc*I?LMD zqi@>;;lIE1PAOFWeZ&JTT7T%{K~&-$8s;WQ+qu2gB`F$(t7&CKxC!~4Izta?Opy8^ zp?8A(Nwm&RBCViw1tHwc(2X}JY?gkH!rv$G0|NI5&?1zR(hj^aJ${<3qhg{wQ=@Uc z#GBH@ev)L7G#*}I4=_jQV^=f-o*>E$x-E+sqpw^akB!BWkUbz768Xtj@>;Zhtd}MY z^z_MJ=cB}9sb3^TTfcM%iG>2i8e&$IeYnW~4R=djbi@+MkSP71R6Qi&WGXqPpJt*+ zjpn;dw>?OanGT$3!+!_g;yQ4mDqJPrOW$we5>q>NTHsT2sS&q}9?Fx(WiV4e6s^oR zHa13J%D}&+lxUy%qK(aR!RGT-LVt$`MH4h9d}{`_e5jr>u!r7I*C!MmCGL*z?oh#| zo?&ShC191gEs4}{(zoc*n%1D?F+Zqso;lO@D+d4!i6`s-`$>dwSDYwRrY?s z_7BzA0b<1kHzHN=7*g;y7Q8#)I%ds@?Rr0ia>4B?h;W^bcaKTxb=}aF= zAENz9eSng=E&-f!~U^eR0>4Bj??f_wIrPvab^<1?tnsSDl_rGV5%_ zZ_&JTA{!jQZ&}RlJ-OUKm*z zSvq|`knKBypIkDk=bWnrZgjBc1%6+iHmdNUtK)&ILv5Ikov7ChTGD2xJSZ)x{lY4x z(f+{Io^y5PU7cBM)ktQC$aJCRoBE=_OvqioX0q73R#9LJ&bU+Ey_m@M9nJ-ghwehxH7avIT$ryB!vh8rwfb{9iYf;mEymq z2dcdSBT;+{8AgPdbtv02=C2WtHcVG%jMCrGoBuO`|B=A|1i(qnDCS)FmyckO2S9z4 zg|jL8I)U$lc~4xxi?EJbe?VpQiV=HPXRQs`^)l_Dzg3&}JMKH~6<15aJBHpuJs$v# zU01(m$JUBi;z)aP0?-~S4tQ^>>RURt>|cKN{_&iDFz+9H?ab`4bPe9HRb{O$1y4iT z{IS)S>3u8t&a(>>Ics0u+DAr7|6g}+0v*?xor%?o+7}cGI|vr`g(SE`B)CW*L2wZX zZD^{cmIQ(l)GLq@s|y;aN1iTnXbb9=qH>y?scuVc$Wl+!b~{5m@|Yg?lFjK^As8?cF`OW1 z7FIO=d*lIx8N5o94pCn$iHCcn2Y=K$Ao~Vn$ABmql}6iWp5~Gr z#sNoQv9bcI!Kwx4cJs=Q!owA9TFe^gc-nc*g?gw`-G`{ILndSGC#O$?$T>6B4j$?B zEHea%ltP7&w@gyBI6g&{peuojm2$FrCr_=#>#@(RG1eOuYM;*_>#$8BB2{?pYoiM` zmE>R-cq~(PuLH9UjwLy)QqPt9s8CrvEDBE&Gj?qHm(=r^#~g3yyP{n7cmAK z%(h|FB$({1pU_~}EyGr`0g(Q!xCP5;GXK@Dd@q7Cy$jL(?>FlndSb$92Q;E=g76-~ zdn?4>Q$tSEI;lt}>ppniq>(s`w>4`pTLgiB0rJ5Rg$m5ZGh>;t#g{(3u=wiDwjXwW z+<9~D&9!MOLHdIq2=xU)RhhLs_G9Kp&d4tcVQPI`N#)A%T2NDU?J z&}vEU)neQuyzAsSgks-?$ZKavXovTD2o(um6+MX1PS#^EilO++2awj2;svA>QbX3N zN%Veh?K62}BQ6eBzSd91QL%4VfeYu(;!^nrJv$5ap-V1;#HG08Aq*`>&8ZT-JB$Gb z6pG?xw^eL1X$U3(wj##H`;KdNaNrEjz+TC|lfL6#VdUb=DLY~Jl9Z~hIV<(?D|_#g z5;Xiwxlv1F?&B0@=RRq;xmGHEI}X>wect3>@U%%?V880?Oo%T@Q-LR*6SJ^Yz(Slj z)DWR#>LJ!IbqZXH8>|%eOhFR>H^G%RGIp zSJ9|~cOHIS)IF;?Pw?Bxjlw3A?iR7ceP8)4!W=GC$Y+?ugBDM%SmrH->oRq3hO&LR zFqXe{a^r^VK>)Gm!W&?9Nq!qlR4-nSz)Z^RIRIM=g0Qs;g|ECqarh2c^UZ5AFI~ML zH?I-d@ow*ebK&_nL-}ya?QqAfa7P|1{Z)Gw-2m8cSU;)~M}WEL9+2MTGZg^H zO#_Ijw@SR69hKLO-gxYzqxcbfu5&aO-mirB%e*hSqoR13(d^M*e`Ikc*8&yBU5a~` ztnG~dl5R+;x&4zK5^|8@#Za>8>~WIIAy_L!hlI;iT(~yY^SK>LebOINzjE?>pW9=* zVoCUTrY^1~1$GIaNoT1C5swT?y1dL{ii#Id>=tQd?3vTWVK+)2_qZgl`7ypKisHaJPOGp2fz+Hd@F;rv6s9Rx!YhP`3^bhC>0t?h3 z{tgFXX#`&k{%W2|#C%fIz;gvW1x2dR5|Jt#1?VVHHNOu$0blL>-n(_{uiLL5&DHHx z>UPdQat995CvxE~CEPWCaLFH>-?tQMpNHeuhWUet`ZPb5_kk(la<=B(;e`=WDRrma zSaL1w%efo*NRB?0b3X-JzG&B?Cl}oa_K&+R(*a&YI=B>VSs0o>yzFRj?uNJ0p8{;L zxY3US&cVFiE%wUo2Y<9~H=x*aEeCV%LyG&5>^_vIK$UO>oabO~`S4zPklob+-hATY zjeq>4VQHwY4+D+DzbXP%O@7<8*zxT^&Oe~|!RnxWNlj|tM-6=<;v*ocZt}NXFsysAe_{cu!z6)%Dc;$BE2<9)FN;ZAQ-4);tz#L4JS`g=Tgn|f;- zKFJE*(N?HyZoOW6bE{l)P`K!y-~0MuFw*7^i4tnrqhGu(Ru_I8(E1H-Lm|h){AWw9 z=6tK`FX4_s)gBZJD-%INv>_8D!Y2*fPT)fMR_ZH&2o3WRSaKQ9q2X-vi)HZ(`s5{+ z##3Y|I6VuWhLCO+6>!1Zp^Ank*+ET*8PjV~piKHggpX*3gdW@Z(@YTJtBwuTWi&|yk`0hIrDQw<;uURy`%-f8|u zbLLCA>JFv418iGg_1n+Mz7FhnYTCewU8-p;YTs+|Dd-Evh5I*gE)n=EN}P0XDRB=e z#Ot8W;*ZP=XZNO7qgF@DSw9)T;!-q!s%#O7IG{*f+puIT6~)?4VHx=y80I5>6|~i* z|0ZS68s5;}Lya7L~H%bfl)2OOzH$W-iRSf?^sR&`8-<^qn%t!y=l9G2t(Qs z7{asVYs8Om70!FuBgfQB#i6%TkM;3?&i5-SN^5_3G194-P_$Nhf`-FBvj? zm85!t`XUquTLdP&nC4OI^``-{?s*1fB{555P$gKqN$>}?^3FDq` z&^-eGf$Ckt0WcFpCOxR=j1wT|?^gWX^ZNv`G@h#)QtF20AAw8$0G93=08JIP1VZ!s z@-F|frP|q>cL(0^U-pBba(5{_+2^Yv^6^ugXaJq$_5==AAi2SR?&vHM-L>!dzv0hE zk7izxqern5gFqbJI3RvMe(X=_hS*mkzw0O&dDZ^K$38rYAM7_?`sji<%7qUoA|^p7 zoN;E3U-gIpEBV!(*~hP5lv@VGj&;ECH$9(e#d}hhGeOj}B+4w;cIVtZin~X4_h>}T z`CMR?5?D1qdKW~EJKMdu{>IjvZ&>jS%Z}l4qK0q)m;G1cZC$y=v?L;_XGCYQc z1NezBFEdXAGw|=Hx^k-5y}}3#tonBTJESK}7YU2&!~S=1k{qm9#XJp=trDvh8meCN z>C{Oz|1c8Jn0QVK!T|8s;U)}^1VpOM5Lfn6DC-61r9)Q^r4MDnN!K3ZXG=ikR^l2F zt)$mU%uMP~bh9EC%*-vu9gs|7J84tvsZFmZkc!{LP2moPj2~6!SAsiY$0}MS8|MY8 z{CVoEo9c|#(7GQi+iJ)i0P@?mzg?fH$xL27nXB$ns=Kl;z57*}1k>6R{8$O#`htXr zk_09Ee-Rc>;h5JT$3%t;L32|gPf|ud(D9Z0ufv2L;iOc$LAr;UeqXFHr2jy*{(l3Q z`w3|pC7UbOwXjxLgF60%gv_X7%(d`p`5+>o%*ejA*z+}Q3%j$OxtboOre|?raR8p7 z`yW*LAG}qANC*$!4UtmAFRK<&lJZ)V{u7n^|0Q6>_%ausG^|!GJggwLeDT8XUfg}7 zE4St$Wz9pkY95mP5B+irPdK@(3*EQy-@0Gn$sT1F3NP7EX}_!nq`B^=E5p_MmH`bo zN@ai#c~J&2*|-c8XeC8E9waVgMX>Z95(xDgbs+*xNHX!8xUIU`5AkO`I$jbF$#j(~T@XPA#(HI*#y6YZYNErXB4f)?4VG%8!<9ze!z?N%|1IV!f=fZeyNGat>bO5KHV5Z|cnZQY zb2UPI&O=+&Ysx8{4jMx%;2OIVGzxlgjky^d`&I_VMiICqH~Njv?`Ot=a6lk z{M%S2$+mvqXCwiQ)B`K2yJoe5<97xw8;cYLj`d-8(ykJSo5%}8pM4bKZoAMMJB}BH zvgse;$T&EJKU7ubO}aQjb9>d2KaltNuMB2tWnU}yWv9jK zyHb~FyV{){$qZx$-tJuJT%7#y`n{7BzW8v0w zXT?f_B*MlDQN!_6qa&~kngcC2paQG~Cx?pykqI)KG^pRh4-?A;tHi7ib9^Nc^R!ja zJtcLa2Y;ES%GiK}fImnUQv`qB+M9`IhqEu;eC)sP{FhJNd@AiozkDf}vEIb-&8N7S z5{(7n7LItR(*J^DCquB5BN|p^{In;1?Q3IWkBlEUIJUnpY1{SHq`gg=OIC4ddLcWV zlitV6$&Ft%Gk+j2EBdt?kP^_^p6zYlJ%H3U_I+jD#%Je}O#|ickN|aJVlG)DSWv8L zESON>K2^nF?0Io0IYbLSc;lR!j9=t@&=PxB3^6)k#Wg#?FToINcIuVcfs)6P4KWxm zotQc|8yiL`*?$H*{2WTQRZjJ*({ZkgzO{4W!(Zex$W7^oUHC8z{f3eq^d0cfv~0|Pw}N@6plQC0`!S-n?Fw$H>~JK6KOm0GI@e6tw*5|9*sDA`FV zmV6u4N9Iz+bcAO&l3t?o5*rMTaF~NetEJLDM4g+(`z&8P073<@d=`>XjUQ0poTA&z=m_;1g`noArBQt ztLSJ|mF#F-_G+UtzjhcayMRe>3Kidm)${w(eK|+;PV3tFeX_SH=V-oD->P2BH?_!) z`g|Q?DSDi64+sGNJdX6_LiJKB6ts_|_bbnHyS2PH&d$-(o53Q@Q6kc=i9MF`A5gqkWAv!{K2Q_A{Ui|I+QT`N8L8Zefsk}9z=TKx)TTV__M zzE{Q}LltkZ(+Sn#i9kg(3z3XfMD!pfWt>e*!aWoGvrJ7vU6<6NkSyn7>Xk_n*d{7F zb^-E=^^#st-%xBX$yvz90bHI)XUS#FteT<6C#MmayXeSd9509oja^BwKuVR)sHR`) zi-i1`Sv4T$LueBx1|Xmro}q~`!Cw>!abD?h+77}t*OVx%ia8n8qFBooSFj;pqSAU< zHb#>?IpbmUo#-Qb-(w;x^l8TX$GrU2icT5^*}H{kLI}FG=3v(|m0Ci}KN^I-EXHP~ zls9c=bMj%V|5T?VEY)M}>gf}j^BnR1*ypW}qD@H9&iX;R4VhNUJoGq_59;p&N zP-;eZ{|!PSS8*Hs#{moQ=H6UQuTs-He|X6Sn}p`~4lO2rZzR{bUFqD8(|mA%95U8t z?3ZS)%plCyU4PBOUb(Sf~-7I-=#a0iWl>WX_`uIbWB8Ge=kX z`1c?WJpR9n1B`z_Z7a&Bm>~fdr4URQN4y~#hk3Mu&9sJFi_j%+Bnx~k#U43C!lMW~;7G9RN0=?KZ!lJHrl-$J z>i9hjKVamU1n(9nW{h`J(RN zwo7*PV9&dQ>8iVdnuU?K#&UrUB|tG1$agkC+M4$Vt~`t%pFh0|$LZm8d|~+Qml3t% zv3HN=>enjuYjgf}ihrH#Ux$G1+KZwCA;bEH&LcX|9vl!0Iji3?9+XPIs6(8EI|ieo z{{_;K|v7Qa2yp>1Uc`I0)h)A3A!}Ec4E?^pK0rLoh!*AC) z#8{aNg0UNdavaQJFzU|CRi~Owk$GBZb8)z zZaAIr9xW6`T(Cg$q=G4b%7?TZGl)=Sjv&cA#+te4TrFfDJ}r$|V%4eJ3;LP|v4z*C zqLuw-RDQ#lW>Hb^1!9fxW^PxgEv}ThS9=3BAC6aDEwisl1*OnztoYOmG%@j(ipE{k zVzXW91^g6iBUO`%q@rf#_FP@6HdQyF*LkWAL(@H$>>QQOCdo2{)=3zHCpbhAxtJ*W z@fsKxT<2dUBt;G*Fc_&a3mzgScpjDtIPZ%J18AxN;nsmYBW%PieqOM*j??LG0>ld| z)T)jS$tf*)?Mj@Grq9hv?R3wcxR@xoM9`0fbcm9r@h>eA_-g_r<^mR;n4EzY9b0xl zsjjbHFbinfF1TTG!YLQ3wIg;<0ry9Vf=73+C_=)rDK=YNGh%7R7s(z4jw5u}lF~n< zixJomkZHH^29XMd=*-kq9JkoeMl*aU1YwT~S5{MTQCO)P_(Mzue@mr!g1|TdLcUzt ziFzE-!lc3`SZ=>U)j_~bnC;JS0B%RC#Z#Y&%kFk4;Ada`!zVv_R_;NlN{h1|D+@Pi zdN^C<2%<0JHy_+m;zGW;OKx7jSSLFg^0oD_GYCguaS(vgf6&>>0P_nhR4$MWYAxgg zeeb<2Hw|FV`=d+ly4&tmx7@2TlR0-xamQqLEZ?#!?OAAh3wmgcOAs;a#L6chs?9{x zuclwk*X<-r{#dr=&9iTvmBU?29Z>d*Vb2Fv(-(TP!|xvcL)S+ExpN=(Jm3DT#8~2P z8_W^vFf~FGj+thSc{g}vk-WQ>FM?y%lyB*l-Gd0xjD7LYy~Y4B9078U*7?!&zJ(pj zEpP(<`m5J!t~SfAPVA}%-P=#R^_6VRyRAy?2Bmg;&OM~Khh+EAlEd@$!(Tgm?aAxg zF zx3u)kk0_1?7>Un|Nbb@_>JeW9D0tXN3)F^G2vYYm^vNLgN$8l9w)zR`L)u2v9nV-% z9I(x`1>!TX>HzK6oWKE&e_rjwcMe_06C`R^%l>(@WKs~1U*Np zy6)#*t;_fJNdGf+P*yu7GzktK7iAN5{mlU88QZPBC_R9CPg0jAz8^F2{F^f#*|!OM z7XHxbmv+Y{rd^~5@L0jK_v{QD7-Ec_(5FXSr|FH0Psq|xe0vt>a~g$vI0E?X(vAM9Mvd-LGO7jxZDDcw(r>jWLo zh>9nbzRI0#8}1OlSgJNEG*a!BvL~OQ&PZJnajOu$%E28{I8px647(^cb~*HVa>iHe z`0U4bEmRw)phYd6fv-)>VsPC~a*u)7Bk0f4%i!{fI)!gpvfZGLtJR69?Qs_1N&hSQ zD+D#v|Fq7^T8rhK6{-mQ8EH43eV*!Yi>O0H{~&)d&JA}$^%+lg>tbgvv|b4z>iha7 zU+=zz<{_Tu%v8{;>(=R!x65JV?OmV8I4X^vvgHr{UAeXDKvjf)@m<=V!TwsCP?b{rL* zo(&3_Odty3^H7noLJa3;P2+(OF=HPI2Vb{gL_m8QBy}f^1N?^KHY1U2WX_!g+dUpk z+n`D9dEGw;EeSsM;}~uYNN<{-uo=Y+M$Hkr+ZRrr;`SJUPh}2XBM`jmK@<3#ylZL> zF%mKI)CH#O47g?@#DmI4BSx(7q{XShR$x6`Y0&D5U4s+88fW#Z;#?)^SYD#3iQFrc zqYCB+kwO9~Tbld$rIOVE5D8VLx=~+-qykrpq9#-q#82AXMm_s|``G7xP=1M7rcl4q zlXUhx3-L0DS6UB>abAW&sa3U3rmC-c3G<5DN_HE z)2hraXnIRh;6a zZB&Q)h)3G^hR`2>9S5wiYDd|55zra&sSv^+3C0b3|v-oEDwh}IpM({XLCs!{` zFFbC+WHV3vJWEMj(L|n5|50nYu~>s8BRaYDi&cEdYZ+>XI6i`Q0Cg3HhMqkTd2iL? z#T)B#Z3mRL1AO65{XjmtDsvG^u6;1tXds*E2GwTTZHYc_rItB`{d(W+O^@8#^oacE zQ}S2hxlL2brYUhp_MhUmf=`~NVy8oQQLxe{V_Qo%h%Mt{mPHpw#hZyWdFA1V3h}^#VdiZ&+|MC-tP-rEab8cZsEF? zT@KRNcED2<2$bNjzWk#Gqk|!4&3+yttF5mTdD_yS5IqccgUka0mMR3uQSXGd0F>6E zP*~XUHO;|(ArwD5rLNqB!7MHRqzzPA>*;x)>Ue-eVV~Er@Jz7Oscqp?0r1%qMs^V` z@EQN_2D<^+-!4Hsd&)Xv1&hZIUA@|rKZ{4oH&{*L(;whpY;fLc9JWAyDVG`jG0P(` z7n}j}AyWXqGq zl~iqMZt=+~GVa|*P^f;-q1`ZRJCtduKrKQ^a` zJQ-UqqU8g*YoV_#*k@W%69@0}P1FRmTkB8{J~&zWrPRTKZRUTxPmWLv#vI+h{7CD2 z#yXho*6P3l*0c0psxk2!sRoqJua?m)dXkIg@+Ri$+e`{3{weHOL8 z?>=Ru{@3tJtL>Kiu**f!isu5#vg6lE>wU}Q{Ev_(D;z7 zu@#LY(SR2&tyCNFu! zU;Ks4HL?5TqhhO;<-$1oMzA99MGe+!BkZ+cs(IdTypoEh8hGAuTzM1qP>oXPl!xRs zo*AC}ZYm`6bxYO6YbceKavzVD7)id?+mXhnM__{CNT5^3gU0Cw~M7`m;wp6wBWr$?Mph`Q4Dn*)|E2dC_alkpXv-`~ON^iuw zUbn=%QO@d8g{#tYbIr}Qr`l3&TAuhDI8U{!M|R1Va!8(dPpVDSLCPQRrM?mGo9l@8 zr+m0tp9%x6Ve#-vHB#bo66Ifuch+5Vp|3@mmomIV7YxZh&~ zU3!Dn3dtjonjyi$Og5^^e%7|q*PZYR(wFSin9pDil*kDY8*EmXOz@(9j9myxW2nzj z2~m=TG$rZNrLN#YyqOfVN!p;>W!18p60V5t z`<^(dBk3z?j1LT|~H?(>aD^?Z=2tzBm zeh>D=$8K!=XpoK@db8GdtMEfR-!npHA|+St0WWqRTiXy99Zo?>G_LuS5q3j%1ZOu@ z2r<)`r`m!8)jf`fsslp_l|V=Wu5r9z3|l|9?h*#GHnyfJ_z)%y0&!tfLhJ*TBP4x9 zCGY!5CD)zie2a=s?E!Whe6m2^tOGb@kHNAmx>`7H%QlPOWxM_aJ&?uLWV5(ZzQs!j*|@cc^;Ofln9w?tzD#3^ii;TA1t(itp(DJ93kCa&2=QsGiJz_y z{1d7OQhZSRK*yNeF?ORPyZ1K_e&^ugiEod+J9d4e(zz8^OLox#8qC8+4@lO_*-bhb z7bYEK>y>n=!AlDc3WUu5dit7#t_3mggey)~M>~!T3DpZ?sz`+Dr3dL~9|6|W7{O7& zI}2a4V4h(F3uZ0xo_T;^^dB5MI6g5tym$PO$Df*bba=cFCbTsnkfhMcdYFB~NMn?V1fJ;Y6xL3}yOWO42ge8yt4?}^z@r3+ZOj2Zii|nw zF}m?L^bsEn*Q80|+_T8$EI3%%!>`5yq@JEAR14G$wG&l+Z>msDoIOMhLHu+T~NwJnF9O#CvHMxq=)K>!1sxt8}jfl?X?W-ko|k) zK(BCBbJIqO>QG~-a(Y$oLga^OGZYm{T=owgwnEopVJI^Pp7{`25)DD6VsQT91^6T# zgc+05OKK7e%{j*^#j#3utXlE~=10IRo)&tgIg9OLrRDvTg6K$u$fp4Fl4QrRjaPm6A#2)&FQp&6^dJHkEL-{mkvpARZ&ZI&cf*tG9F`FqrKUx$>CHzQ-#PpZ z)Wt@*VPn3fE8ntC-Y|Uq5P;ZoEyMYie%wLjH#R{_q_OFq-BnxnsRaOj1^^_kmpWpd3AjYOZY(Uuw^ISN_mFmxI0naL-;vUjaZr z00>&PZU4bV<$(jpyWGAx7v6$BU)>~Ecjv>ZSFCk%bX~roE#I&MS{e;I#GY^H#x-Q0 zk^?~Y$s;WQvJVik)V3!o4!@OX27{zHj(4xENEyF*zJt3N^@~&eBTAZd-ir##0y;lr4aJ zb_Zn(05c+h|EDQ7$7Jzb-*)4<+^WOMs>8YP5hZ*?4j;k6QlR0UWrt_X$_46?Beefa z1#z6c8g|}Dx8&SK7vVe z&fFa8NYvZnXYGW>nkuU%trH4lH=f>|-p#s!a94-%-~B+ox9`KM1z(18iCrLz#qG+P zQ6P<_-i=D{UiI#OTyiy_?VRiG^bElMHPZ)$Id$fdYlm{~9g2I0?B0>DhV`)117ltQ z`0cCjC;xf5`pxMB)bWPj9nCfLrw{7=_;A)OH=;iuzTPN)Z*KhIpg01|`Hv|6BQONc z_pkYI4eCGhJm!@AnzeK|o%3Th>|Juf>6F#ES0jId@Dbw9~UzB8> z!_bUGgd%$YL$UqPkJdjVw;vMwLTDkh)P96L5Fe4-Y3EC=5B;e70lD=dv8NwVzhdxI zh;B+Mn|3E^HuAecxg9$j=Fn=WPs(}pFxqiv*&uo!vdKR`UY{@>37RSCg^8JIqb@2M>+}gd$+P&f$ zoF=Co`B>*~dcNZ!pNlGKUuEfh#0m=bW(z>BV@&B7gT$7?eF323lhgC6Hu&8FpdeWA zm|mA%B{vRcqM7LRJvsMa8fu%ha^pbGJ&+D8xloxl=Yuet{r3XT_5+ zv_{OL8pJ0f6X+_{1e#q-n3f>4(!{^@leIV?EuJiX%Qxt@fpjfOZL!d@CI1yu>cmA* zSLuigAr^Bnri4i~N7!2llUcSa(s>V9bc0UDoijL)rZ0feuuj;3#$Q0JKT>mxU6`JX zorXgP7}2gnkc`%arA5H~@JXUU#0h$8AqL5G<C zbk&qA9*DbMw|*Dz7hM!RjR2&$>w)%^kH;r}2eMSIp#H~E zf$KO>IP}y&ZzoW*tWK^nm}s%U28L?Wzz9|i5jHd=Y~w(KKXvweEb;u=^QYr#fOS$n znw$Y=inI4kTUKD>VJ zG@L_H?>Kq(G>n1KZ`4Aq!&j)k;hElJX!>KYsHW_4A4KP&cMMfS>kxW{ds68;EA{)* zWWb@LNa@@zFtnbz2x~48xiSXt8j^%wNm`&V1r=;BePHMr5kus8JcB3?s;5iJmL9{I zvv&OK+0#^>Csl1XR4H}*+2>(lrYFT=w2n`~Ktg|6&6sMeL`ri;VPnvI6q7aU<27GiM45G>{NG))ttrHal0Gz;NP8$_geef;!u zaaMk?sNG%qq#-K(2KHoNjLHt|%EK3&D;lg&@`gu)v*$5EqQcc0gcBew5CEbmop@2; z5#qmy!F2HqCQnht74o-H6hw?}plA&4etm40=2b8LCXrJ{iT$FIMloEt)0~H?Do`3} zO2;r_iH#(BxaJCjxaf%4uHk=?wZ3X5Q3St^`Fh}ws^KAb&=Cn>ByuEc2v18)Sz+hQ zii6CTTcB%fiA7AnvC$JX_|Z1v5Hit2OwtnlTxTi>Tg5;s3>X6010L-M_!rwVIGSTs zw7IZRrFjLlv=VOZTn&WCHDsY;R^+l;_&U6XRlM$i7Ax}k0sh6NKJP4#d&cQhK^?Br z^R85|;&pebB<{4Dz6Zj*O6hpv?5@&v9~Ad0U571W#p?m63AP#iE)+$*CY$S$paf<@ zbf(IvWLNP!!IZb+b*K|oydF-uD_)1SYQ^i3RHXDe`9JQfL9FfLXtAHJGYj2UdW~4i zg2`;|%rMY?h;A(r_-lZIlUUA)Lih+U7DoG{(%DxojuRI;06MnNII-`@qvKCa9N9NM zJTg2!Jn;m)wjJI#{>T`N8k;GRO1UJf55pMaEL0k3L-bt9(A39WA#faMDy~Td6QsLE zgjDG!c(`PKnT!nU z7yuU7Xe7LQlbLwV-J!TUWOoNv zX}B_-tk&PI0f3$w3u8Q~p*wgO%QD#l2c~uNKcdpRLk;(~B#o z;ImVA(a-68k(A57RrVJ2h_PghwqW&Fz5Z>d67GI)cJaWsUw!x0TzF6k56a=eyR`%N zd@f>d1As9J5dL{;;B@v-&b?l7lig2w=@4)TyI2aT%O5nk1qe>XxUD!aV_fs%=4)1| zACE}O1pYSwlPR5uU0-YLA|UW+3W3vO@ca`&yaDfQ!M0qmLkUvbioEC;9QSqA<=?^y zo37aB-Ir`H;7n|D_L&Cb`DRbMR1sm$2~15f0Im3r zo;MtmoRc>MK_TB*j;jdw@~-vQtiUH#W65nasxdoj2Eja0)8N<1Gcs}}TH!c?V8F2y z77)DNJAu)oZ@O^>ja@RXV3#HJBu)U(y#xsyr3Y{<-N2FBn8GANIJ4YPY)o2qKtvC^21tzMvIYq>sh|`2y!%0F zXAHeP!5%B#x`{RZ9T?lFq+ zAC(HiIFL)zi0|PcF5Vt060Nb>c|*ag3E9Z$AdC!HUjffvrYAU6D!F)-75WdLGCk>9?1tnSDusuv3%sPIgJ}wAKJOQg;{mF5TSb0_gQJt7RGktne z!h@i~nRrbMOkFs8`T|zF$Iq)vY|ZX0MphS0y1$H<_2k$A%U78#GIvaGY;8eEbK^n8 zuTI3yOimNK`BJqd?z(S?^A2g$G#1_glV1)|E%-o>F?9njs_`m6gFMlzi_|7yh#r=qL> zaLY}{4+FU!W6F-PWk|lnOZ;XD;3j?FChe!J??i^BCLA$K^_W0&K3q)JRnGJCltEgv z0l~qoD#gYq|JYJP%T*wD+_*<~KP7-83W5QEH#9_~S2hwPWXm1vC=OO;bsL)t{!sK3 zN+&^c^I2h|3A;?2^pEfYHQd+mE1jp(Qx)I_Q`#4BY*M}PmsJG@q}qHhQC0LJvq1Hr zS_5wcF9+XFWVT%0y|^`3zfq|#%4{IE!7c`qo@2a;6hxWxT;^FoZCe4omabVb`9neX z@H0qt&W^BlF!NG7KD_PW<&ny- z9O0FgZHz|;Cfy}GE4-&%p!$EA04;)~S8xP!g|Qp!!qBXJ9vU&{CgGYux=0TmrQx{{I2_XXif>vq&9S-L8zhzsm)4gmVFm8=hSIr+>-f4-{duf8 z0ze&fy68zAL>$h|&{WWXKj1_Il><>kDwt_bsKy0GA~QHp6%jX?!zF=wMt{*Zkny0Z z@sEKNw~L`eXU2h1>W=b5$9F+7eSm+lLA7x+<}v5k_^9aUKG9d1@slZFzUJZ2XV*ubKrqHSDoAA;{^aO#gQx`vl10W$wsLEylEx<`XZnijs zXwW<1dTK>0@*?2CvMhUK2uJ=3Ppc&v(0?T$&s-ojs zSzpdn^A6;JYo0KoTJs^ZMr_<7>i7Erj+7XN!^Jo7@CptW^&)rDqf^Zlf_in3nPohu%4SnTzYje(9aoxpZxw9WG0g&i#~q>j){<7 zQDB&WYy%88(Pe?ZrO|3eyn zDZH$O8d(*>>_VW^QeFGw4ojd8fz0pJty_%e>NYENo9{HN&NsE<8m4uE*c(>SY**im z)im8|TAgoRO@8g6S_1GXfn~d%E+=jV0!ex*w*F2kSg}U*rsbJ~W{|h21K{6sf+jO< zqejHP^^;BvIxN$*>-c@eh`X$09&^H0jP7lGvWVkM?(yMsV?ysFpc#!ZmJq|q=)E0h zM5ptX^5Kk_RpQK#Gte07Spa8f3iT|AGo4O^KSj%gK6%2oqGiIbKk3GqZuSmeiwtDZJ8GJbaovOc3ko28&=~dkZ*V?923}40-TJXJ~-LcHODWb!Kem>Jwvh36ElrH;> zZ>5MWYfWBZj84@!qTy#CcG7H!$D#B>t~J=D93gvE>>b1ELlwIl_)Nk8On>G4j4Bm2 zJW|fu+4um-ZuKmHir`*%5GBx7of!;i6NV$2F}$`r zwx>s~Jd%FoZfkpX%exO=AIY_DS6a8zMbPkRpCBKgV`W0$o138wPU? zgG$374a+6H@%#KMFD{uE#7mD~qpbZ`$QpZF6|STivo+F<* zoR757^jz1Zvbn44=pfoi%Tr9%5ro@;_I5MoY|PUhqyvC?8p5;(DIE&{;&mUlT56*6 z4=+19oKW7>!6B>P3EfW}w1nxj9Ej3W!B5~{-_$W>{iGk4%1Lz)*$!42bb@>a2@dFr zyMUNH+zlrGPmPFv0y-E>7puB;x+;{~=g=`pO{%E)qm2#bl+d72`Q5Bu1I;KJKU!L# zZJ9T%YE@~bqp?Y-3%*R)?!4Buhhd>qj7*}vPccnEDC@dos@<11Hx28V6_}NcxMEX? z5Jf7c&@dx4EksT^LAp|OdIl;iL?~a>hZ7|Q4I*~=PtFuoT`mm9b5k>q>G*F+aFAp!Q0(y2u0R!3wKgsHdtbULxzLspC^(O`tzw$|R7&WTl*{ z&9o9)h?z3aDFXjLj6TCiV)TSgf#DMMDV$qBY3Dv=o(!2nL$47V(>m1kq;KIZkk3qv z=;@lJ11!Q1t16hfZRZg$hHw-~%v;RUcRG{~iHSr19G-IEpEEatgI|mUfZ4L9#f{F~ zr$v#0xgRwzZ^{|^>hh$vST7{%lvd!(_Y~{mzI^#FQ5DgotMcXL=m_@3@wcDMjAysx zYI`B96W5GTV2m`{r818_TIuVL(Wj_EKT|pE#uTrQ|KK^C=b|GDU}!`MjmYj1(MHs1 zv`uHGKZh%3sUGMoy){dzC$N%5z;y&kG*0?(y9Wp8W-lRNB-ayDUAip#oz6^`HX(gX zdfX9-qb`<*e}|kTsPE877n2Bc*A10WeGq&DF*?O9@ zrA>FswlGb01hB&F2M^U@b9OIqO%qUVbe38nD%myux&BXSEIZUwhs5v=f}M5cKpNW}+4obQqj32l!va`SQex^W}{PF=a^B1i~N+-Vrt4i~SwD}N| z57=2MAprgur74(YIJ(F;<7ZEtC-V%QEoPq5i(l^5G{K>YUOI!TPigZe(;Y@Kfd=t^ z8Pjg8S0#joV#h|I^9^nGB9Sh#C{&>DOB#qrkP=e{AT@fi+!$gdfFXktK%Zb0qOQ4B zs1|4|*6E7W!HU@|Cm1$u(U**nnK9>p))57tp)}GYUGW=j-=W^ZzPS;f9HW!oklq70 zfq&lUmqrJpktA>(&D~IOGOV*xHk{#(*iv?!X>VJMs-UHOLzX@z*@Eke)7Z zH0lT>A~@5(l<*bx2#V~cnVrTrq)KlQu(@M&*G?jD^U^ll*widhJl8V4SG^9vsom`422O3wX5z* zN}stWgjXUf`@UvvD0Pu?3>i)~8QPxulfmT-k<$94H#>dZ^%ZrquxYY8=3J)>3?H_;(jt+(se+^So%craHtsMHP0HT$sNXcWH$ z{rh0|f8{}X^`td3tE^rx4lBG0ANEu9D*eh&9#ao+?4Q!pfU}?SZ$2#7JWMarFYW$^ zmm+nyBR#hwJ&T@PWRnuvB!|9&{rXel_ha>!&fH%S3rC&QMTv=k5u*|Z=22-JK{(b& zWZZg{OuB8!SM=_r_exTTCv-InEn&gE1lzILDanMd*iT~X)-kFB19+C~JcYq1Au7_T zKTkgX5E)}8cKR$E+ZVgf`}Wc~@%NFtBDYD!VLlWzS!ZZ@gBI!!smVLECU0uJ3W;~? z)%B2hE6r;(ANZ;xd{Jw9`SB9b7F=sF9K2&8yNMTYB(}H>rVCcGj}ZEoefH!Uy`~PM zEJfZc+cdLcWwCGw=8ANro5;NMkMU8Hw1jy_rXm%&M}I~|YR9|i#cWRmL5S>b#h!7B zUmbFZ#z1wNXDkuapvrKShEs7y6Zd^TfuZyS<(vklh$2I+P?5j1jUHh@8UGe%d>)yn zzhzs5_)7$OT`WwAST+vc1PRdS++Gn3TB;(;Hm4JVP6MQW7kT{|aWxonJ_BA<8Ep5E zBAyQF98ORW<)D1z{Ac1#N#CYw`3`}V8BG5MH75NAJ;Smo>iuPrN}y|C{p1JerC$$} zutH6$fMz{e3G?2Zb7shBY6A|NL-cHdrl2<^O8_Ylx5DKqbaP7=i8IxRL0M(eu&pxd z)FK|IGpjF?i{FE5Q&=3Cb2;Z)@mXitv+fn2ttxxgGi|wyU_YdE32$;;%mUIAthg`3_&6d4$USnv4 z%HbD`F*D7zwABLlti*Ioc-Ptem?NXSORoR}zpT9yHfB zX_KcMaX+^lfq)<;UzAnfz4@U7j|EWAK1`;zjsBVf&sF(iFKj5i(5S#)RlUOqTt$X6P3- zB&tJRjU8(eZ}QTj7ixk==OP-bmL#K`s`@HT$3&VXdWD)uiXHrx$Qp-r6%tAtUL&Bl zz|Xl|Q+F5x!k{0US5 zPp3uRu&Vx8%o2(rg4Ub92A&ICoWKtZm9iiDk$Mc%f<4LV@zhRCx&7qSVm=^pFy11X;Ahc z=~O8^v_aLk1wm*KsZ)W8->!eAQa3GU3JX1=SU*=@KUa3~p`v?=joa8&1e68TR;2o8 z0l`#Us0660wF&Y(0@{>XhPqLu#5Qdf9wdr&EIw>n&+FW!wHUUlv1&ExR~u(e^O%Q$ zY6MI&qVAw0a|A!-3f0?zO_Hr=AQ?fhThz0GKdIZA1~9WHXx^W<$TjQ5o*hQ)@e6Oh z^42T*B_<7$z1*vdiUnuj0tTXfb$E(_O6p$&k{h2MlRSW|1Y;^KP?4EayOK+;OJy#( zgo%fhg9-Q9q&U(qIH=PzXY-aDwmew1 zhy$?;8j!nHop3D7#zmu)8&+`|#!`w?+0|hoxpF?<3FaOe@%cnj6oq(P2obp$)mR5Ee@nYv=T}wxJgl! z`nPnL5?X_gOY1lXz@ZYmZxik$)F!=5PyG=dVAFaU$NKgVvo6Uuur`FGKgEOp-iwDH z!vT8Fk9S+#k%g{n(VVMQaUnuol@qGZ4QY4UeaBO?u7%6pZqg`Q ztOdx`tXFE*)1ynlZ4}J8K4ZT$b7e+$w=9L~-$-3f$t@eMBM9jOO6Y<41Nm^nJN|F@ z|2081I>SfDl{MGI?j*#tL-AaB&m@6T>s{qneU#auZKsd%-J#4=PeFyJ*nhrAc`bmfKUVZw!EFaQxlb*)m}M!Ylu;EL2ANDrsu z(0}R5`C|&lFh>}3(tZ(-FiISQPntH$Ks$jB0-XeS=9MXXlmWqQDXMt>4|I*dUdjPY z9`pJiDY<|vLBMUPXH;KI#lQ8F4{<%ceGytuKc5%)rV87=_fjZUmupmi`wkDdoXJUtsjsBUO` zfa=wBMvAGZw53_Gqj)>k`|1g}Q=DRQH!(1I{KUXPsHPAn`zs}ioS?cnAKJ7rEFGVQ z?*e!On>l~xIMi7{+!qs8zgwggHD6-}Eq8SLzeJ^r`Iq|;_b{4&;n%=hOiY@g4n{Ib zGn<-J<0S%*Qonm12cQBPEdC&7hFY+soP=!wpcyQth`S+p?tSmsTxhcr+6)90Sd~7g z_}gTE+ft-?p&6c#NgJ5rcwjZvBm9I%c5`2{9|LcyaYiAkvC#9 zcgo7l1T*11XGbJZFJd?w@*@~DNV%$*GTiC-wXdKJT8s>vlw;Pwd?*`qju)U1E;gj1 z9}`2NB)=d;%D0mILZ<@xg(IF~{l#57@!BjA!0HCeUHDvu6(ef)1HE=JNWGK4QXHg3 z-n)<#l?_t;0eGS%Cw@QMAT6dsUN1@NOx%A>VW=NVnc03Z$ko9#ZuS|J5G!3QOr~c} z!sn=QF|Q$l;x`b%23~WKx=^HM!${12YSJ{Qi_iXou|hH76|sVFz{vQeOaRJ@jnimB zR!DFF>92>*DVj^$Qg)*mN=ZK>=LYsl!MJC<;*Pnm%~`H&NI~yLEWvC7Hxa`f$m%=z zrkJBiqoH6u0Ww|Fj!EdQ2E^*D5Ii@14hvH4ezJwmi%V1U-Iob}9YT3PYQuBa2d4Pg-w&0*HEd2myWoi-!C>;W)sO0|<2PpY+%t7}46##HB zf;?0^hwl0#SH?1%g)6!yku#;}T|x_A9TZ9d|<96m9Q$ z7q|RgV=lHsiS1yT3Z^7)?Mjaz@nCzlGZ*Ml0zJ0_58MhokPB>A0^3>pfu0=7Kd@aS zye;S7a@QAKc<#F6W~c1ipY!ckeEVg`ekOSO;Q3;V>ZBi_&pO`MAe=pnjgF3w(gybr zQ*Mu0WC_-HfT*Mr&%5mc3ku+3MQ%;uwCrx%AQr6v*C z<}khbC)7pwKF7G>qcJ^Aj&{S>9?`EosvqeoiU>IT+y?#bdi{u2mLlKWH6O<*glot3 z((u)<;k55KTyssFJWuA?U{Da+mU=0J0|Z{9WV-0uZaNJSc!U7i1oE0(x-#q25&GSv4Iv%a1zZh5-D~R zs)T=I;eKO@E|XfM^ec2UM!8}~Ca=)7b#%((fapW1hCl?M;MfO(N~)t*NN2iW#~dT| z(kWBnU#6qy2_y-8mB7~tTp{pJ2xJM|CUBR)-xIh;;1dGOf_R9I{#*KHijJ5g@yB%f zS9JOh=;-eWe3QU82wWrJrkoQyNUEcwW&*7QItkDmS}D3a$7koDKEet6@6$JS;$f&B zP6`9D5nRIANg>=M_5&{{n7S)jZhY?E2`=jS(^I>pyLb-CSQ6XOc38?-typ1NJ7i0{ zabL1{=lL&hsg|`pZ}H9ZpWz@ZThu*o3C{ChUb})@=3_lg|2+TYErEIdTe7T{%{x{; z)?V4tv(mn7b6KJA{)+=)C#CnZfruqsr-a(({rM;|4F4?7I-6|aC^&sMUuxNu*{8H@ zy1psbGN`l+%9cjdd7vgedg;KG1M{Axy7q-rZ=KFQ0MpX_%9fE_-9DvmpKPgFuBx`e zs;?ZRXRlnmN7p|s-t4vbY7}qNybG#mR>!h8VC{vzTN%jM@6pvyi?`Y>fhhT*@gQP@ zpCEQv2LR$CJev5c^DbZB8zg%`Z*Y0_^HwW(hGp=my~-K`m&*hqO;*f8W-!!XZC|$N zV8{~cl7pRj2kOlQ8w7Z(5#XNF8?t?B0hsqKHwCR5VBesDc83)P9y$oNSUZ+2I@sN4 zg^`F3w!L7r?gwpP`gz*^02M&!poumKMe~7(+A?q_RKpgW zco)W+fN*HG@oBpilW`eDq>zG~TKM>p|1t)$AJfv}4zMF-Ilt91l5XZjhlIjzuK z(m^B}rTD@%1!86t- zYd7^S6%2)}15mxtK&M_RE?@Yt)f!&57~pd@hZQ=ZW)O5)pGEe|VAO2|o7N2Kyw)f2 zY#D4?OZ906&sm2ZRKhZN!0ooSP|8M7H)^L!tqkw+^-qm=AFt9K3AI?No0M?J@+w@p zM_!9QB`|MW#yGD-936*mem~;7r9BIMSvXGXRym#Q{3p{64?wx#pb{K}hdDA00w8v4 z74WfdH=OJ&90$mGcPZXoh_4dB7XT0jCSaTQEJq%*Sz+B<8Q$aTpBnEz@32%iEVweB zj3>J;*RVlp*pLfvRKgqQ1ItyNG{VclJ-YU3@y3`{w^?dJYD&0mxfxgPkpa`E1W@vr z#TQNYE$m;|pE;O0m_2p$1b;vEALt(vr2 z!4Ihn@A36djdu?eZKsfr9hEYnS3kv+gUe+JX5~45KWOOd?XqKQ&aqW-Y`yU~F0G+!sWD5NM0{{{b+5i9m literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/attr/__pycache__/_next_gen.cpython-311.pyc b/env/Lib/site-packages/attr/__pycache__/_next_gen.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..46af57f8adb48a77760457e13c87260c6da056d6 GIT binary patch literal 25139 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/attr/__pycache__/_version_info.cpython-311.pyc b/env/Lib/site-packages/attr/__pycache__/_version_info.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a31cf90b1468bc7bb2a947887fda166a271e3361 GIT binary patch literal 3603 zcmd5;-D@1z6~A|8XS83^uD&9xvfGJe*_IvIZBcbqXpZu7!h1!G-<_dC0>m2r32yhLQ)rtx+C~pL*`h?piC! zrG-B9YW6p0&OLMPxo3XoT>Yi7F^ph5eeliXl^{a@6c5$WP!V=+fp8xYM6ijnIEgVL z5|K?QD<@@74w!+gl2o#4QpJd32~m|O@TU^>%Z7&mgdW4s9}>ERNN@>}&_fCI@bkw* zxIL~up!%m|0|}3#MC7@cPhhvnu^q$IZAK`|ST~+yU)^AEC!aHELUL8Zaad-;Rm7c- zUQYyEiO#r+_lm1<({{M4PBMF*TIt%VAjp-6oj-zbA5oOV1SKVclQQfoK$S10hp^mZ zv7|SW>KpV8Z_o!leQ2MbFpUs-Y46UXB(Q{%jYI)#A}U~vG(awbZsgaL@r-Rg!G!nTb(W|9m4oyC>)>|a z01vYn?ZUxv4A#X_TM}N_=W*09`Rkx+7XEVkCNESs)c1yXYV*~IeHUH`{r%P48-!4D z?wmGowtvu@0?r1Uxg1T`=nmY0a`Wi6a|k}(eN@0}9-;OE!S#e&ken(>!L+c4jzpUF z)?n=gX>IpvHMc~r_lJ>$3dpGzyXTVxI&1dz)_d%f|Iki-lU+d~((Ads%|Z};e#lFq zAoni}#;MlJdo{x%8lz60S(>5gyLj4PGk%5ppNmAfipN(blEFk9dM+er2!T0jFjvWD zEZe)Kne9dyHL1Y?W~m7_3eTAt$CaT-pr_<=)FQ5&v7ChL%4w6k7_M0^mVxkIjb1#L z`p{<6sSj)deJM4aXNF@leZqE9)S69Q%}k_t#-XQjMta(~L3v7)*=fB}vU&zexj#4O zw&~EBvNbh_R%YFp*LH97AdBM=2EPfgh{|Eq*!1b8l}p7BZeP7~bs29*nwDp758W9m zUR!y8`TebE7?{$9By=FYZpOZf) zK2QAZov&v8-u%@0>)EGgzaIGd+Bff(WhowhfdIZ2P)1THyaQ{aI*u!#5ZT#LeU77# zg^4!`__drzELO+ry`0C6@KhNE?5I^4q55NlH#nlMD&rO=*ojo1pj!6$O-nbWX|I(t z6)MM*c*w#S)qAOn4b@i!k^kKazuU#`0-ltB(Si9VHIj~4JkNmAwlhUpua@CJ=UQhr zv{}Q5L^*H>B%n)8Jg!nfNAdIKwj*cMK~{UB!#tZ5^|nD_J;+ zv($1Z8DY$3OjJ3X%mD~z5)NXqVJ<3B)7X!MpGKW}$H{e9^uUJFyu%QARj)e7mKm6zzEyZ~p!G zYWv;fy<{nV46biITpRH3zRoxOF7{T@xxH{_VKwz9zV_Z9=0BTXO>M?{AB~h^1Et^q zdmEytl#S=$6h9;AQcPJf^2nkBS)mAGL9h@1~v-6m64V{LgVNY zbW{EaeS!;8LH0ZTI9kVJ>oV&FJ9YxVZL0qa>j8FB%q7H}l;?0HP0=hDt_7+5ub}EW zozeCAmb&zNx=}FX;{cF%Ne&&|>gf7MN8;O##G{^#jx(DbXKr6!{#h|l47}Wq9Tf@R z1>3D}m!g%cEW^~xmoLjIinkQ6ugsT%ojXzRd+SgadeD4Yeu7WS{|8xxh!A9&^}&su z5^x$|f4)p-f4+onOj!Rf^A#5Py0|h|3Lavj2*wg|H>m3tl&`M4VO`JKByS2is_Qd( z!>r6S=sK~}P_LqEvMvE_0@?+<1>nkX#IOz_MZDV1QfJC0OcMqkp9Y2W9>6;CNbiw_ zH43eOF#PxvfW_KhS#42*WhCGvinc5d6?rMrwGrvsjC3tt+yc$$s$7a5-iRLFj2>Pb zIY86eSsYsBrPl6^*6z*L?!~Lmlz3SRD{$BVypWOFy!0Diaj01tETbA6SCt=>Q4Qij zrL&CogTEEAfid`pIy9NL(vEGLoQV>4Rb42!-{llNYfMu=gW_K$fA8moB$|Mik5|F- z{udZ#KLMRMP53$h5FX=l5aFH@I=1_IhPq1i*A~)B2VGDrQhW=mi|xxj#r)dEui8p@ pXaf&z;-RwibBtko2jdG*|GkHhG3m$fhPcOZynF zr4rj?iFvC~uuP*&O173S86;zjuCf~`>P0OTaR*f`uapcYqvtcGWooW$71?UVpc3$OCCAFF zS(cGwJG6@k7501C0`ezNyN2>u#rNfV*y)luBYcgJ!Q?%Qk_X`BHO1knV$n_0?rC@ zSd@TUUGl^yTZ&QAz-##)=`;a1wwbf3s;17)lId&d>GWkjc*x&Iz??6WKpx@8sDi43 zik6Uoc5tP~%a+hHy!Z^I1XqOZ+;||F&F(6x{y6`O+0{Q-baQpyQbDWL%@S4Mnt+=- ztD3pB`Wt<1)z%&DQc=lmD(jlP%4|8+;gc?w-Ql)9GeQ6MxprUrreWn2!+tZ}?&-`r z4?@_df&8b6ntcPc8_kiE4`-T#Kd+T{M|M7Z@L^pZdkMpc4gzswRC7wyOvNa3b@#-& z=4A3ZwVg~+p-LeGmeJgpXCGI-k4(lLWD7lBd`&7!kF!mN8CMaY!o`j& zP{(HXC(Eo#huC<$O@0Oy`!gUQcWYdXj<Ww;$%1a4Dm(OL2?9RH-L>0lK)IT^N8U>CNXf2JNordlr( zz`%_V2gOu7rX>p14)fq<^dt!>08)i*c9fkwi6DSE8==MBhPt&(OIo%a{Ei44*V9-0 zu(7y(;kPB*;X)GcKuFeiJ}@^WS>Kr1^!C;NaVCK%4rX)+JDl|Pbhit!LuEsOyRnEI$g$l&79sHzovAb&F++_(-NI_YyC;6H@6TCETm zsz;Vi9NNCpGt>!MJp-LJ3hZo;0b#LgaJcqS^W^Bm#KFkulyP|2Yql zyYoC&=Q^{H6V}<+hYr99B|y5xr%CAee+1PTBNp0v1+6V|=^&gke0Jl3|I-+2Cv<=s z4`bX!2Pxb{$H!9<`Z`Rdud(@J!CvP=+6=<8aG|`YDYF@jT!WwecOWck&LDa4(L`N3 z1>f%auGJj4UK95RPVS03<^!`XpE-~Q94v9_J)&< z;bcwvw>0!{;>&A$(%FV|wuOeGr<;AljlQuK65`3`@a@|C{_vUIr9V%7K2`63y%mYX z&$rO4$ni-0G#foc`ceP+dgKVx2Eq1oQ1UVAPX8;&2?E)nz;>d7o^*}EV!wpl{T`%x zD&9g=V6P#li@Y9LLTa>vz7W0?;K|VyOnXD^CpZ;T8sL8%T;{!p6G^fcji#7MVndQ{ zuG{1SOH{QFltR(aE_&HBq=GuN%z|b*5Cy5u5??#T!WGpNgY)y*v=dtHBsM8P#?1m2 z%i1||&3bryiDbQYmM><_qyxy7gg`XK8&K;El{GsUDThWZGt`{!ZcPIV&f^GS79b_n zvR%@69bJ3o*^FS;^ppTm)r96hOf?znk5Tx`0xrLfUgjzw^&;6 z$~VH5>GT^u*r()WH^NSkvV7VV;lx~Ab_L6H@ib+r-EvA^aHCu+7w28Uv|MbuB1r7w z%ar-w!uI$)&y?FQ7;k%?m4K7X61eXyWp_nz6*mg6J9uDCKu5}hU3vlP9%lJ>pZ#9} z<%Es=5l9vNa2?6R56?cb_oUMe32qmTjy4B|KGQ$dcQzkv*2DuTQ6IQbm)O@F9H}`? z)^V#Yv9CFJqEimA<#KWbXsRvW_$SDud`dulLQLS7iLs_N{t(;XT zDvtMTh-M0q_HfMOKXt>fbu-WLIR8>6vvPnTQh TItK6xlP!E6kG9ZZ!q4TujToH4 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/attr/__pycache__/exceptions.cpython-311.pyc b/env/Lib/site-packages/attr/__pycache__/exceptions.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..af4812ea86abdcfe832f5a249d85c56405d46908 GIT binary patch literal 4145 zcmbVO&2Jk;6rZ)d&c^v{l7@bUZL1QTs_sXiEukQyltLvGKGGK9x~$jUak6B+>(1;Z zO_WMGR3b=4>H*Y9TyiR{df>u^|A9k_Dp9S3gv5ypa+DlUPrNs~wqrXfP1pAG%zJNU z=l7fU-pr339SH)@&p-TH_@#xAzpztzH9EiP;=U{jiGEyC6cwggog#LYzblO z09z+*YZ%uqY+YdMZnAX<+b*#6G}$_Ztru*4w5wsxZe#ZZN%sGZaFdeXrrWmT>aOY7 z9J^%4wGQ1=1 zw_Rk;Jhk6v%whBYBvg1t)q>ESFpEXc)pHhAO`E&Aou{h9RNZx%ne$w#PU$mL%~5Kj zjuuNUHB{FDjhLqB7-qqwMk*n?mt3`I;#;`tPT?>ZZNhX;LCt1uy+{q$D_N9hvubWm z^|)zI3P%nmmEu6PNIBOhgV}Z4P`Q`OBNynJ9jz=&K*@%0O{LTs$~aJ`8wNE-M%2?M zQ>RiV#ggWG^SV9gs+_ttRP%imey@oIUE?mhe%+7hY?6;BTYN>+aJ8D|Co~N(dKR|Z zHSLC{TcM>z(+npM>S&QqGDra8cWK(DZPc`fWF7bI+1Q1V%;yf9&Wr(F_GD(-W4h}w zE$6ryYR_aoGIJSjy7YKS&rbt*o8L$s_F1y&o@hN2UNfYFUDT(J+93md0R#0>IDfsK0^GVv>bxumo8otz^&-3m$o;58@hUd@PzXLywL?(* z5e~0n8h6}_j%ORe_BsJJTOC4Jd`K;Lb{<1g%{!iDU}6R8$=( zf8idMpauaB(}v;)Xe(Y7K3*Q&KE#CLL_IiE?GRl51zONO%N?~C)s49c>IU%cgb`{4 z<{Bt0inCKt+reVmm1+zH-NG#ew7jwEtBk@RF<-5G8#M2TincuqXKP8lWk4T5@F>p0 zuPKLR%;7o_ggXw{AxC?!*kO&PMm6XInr?(N1v@`$x>IU4t9!1aVep$d{?29QQ8>FW zD0B#XqzT;|56%|Vohwmbt#XV%kBi~whP%jV6z{=rQ@EpQhiG?wG6&1EFFVf1R+!QY z0wtW(vxs8znGWe%7ur;JJw_puA)Oh$;hC`afYYY4kk-M(Vy^J;-5&6{|HFLv^SdGI$8^iWdrq*| zH^aRSHZeel@vp1-(61p&FdB4qMz_3>5y%bLYB5b^$o34pRb?O_4KN590||X;eFhre zOZSKy9>ZvLL$uglAorp7sH$11w$NI67Nmtpy`MxtN3`lY7b4KZw~EIg6Xc;Zo|Ju= zdnL;J*2@sXf*`yCK}B#ijkSZXFAL;AWsFm+AapE=hE`1z`J!nY=Y^}~A`_=F-cjfG zHWHtzO#20x`I{jAT_k@f9p9SEeUFuaC(6L@%HVIx;DhLcE02}oC(7`uGW@i+e<^lH zdAfTa{3Vv)BjO{!i7ccspmGQr^+Ya^ud1H+q4lWRn;`5cxF;ii6mEb5RZ?O&14kcK zAo1a*2Ubm+-?If8VfhkAAZozU)pPfa@6LU5>&~rJ<$zdcvSrI#3=+grApDMy!#uSt zO@kF2!})Lp?*&{QL01%?q5%c4R{4}8)ymizmG_s)79t_Z2g~GnBFH#=$9QrVUV953 zWOM_+7EbgY( zP`gnx4agFnGfiUo*cxg#YNqaHCoypO?HBc28G2FA<&h@OI4-eSEN9kGyHPXsY_ral b_7|QLJR9chlpvOx#of6z)NX8H62bK!dxp%s literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/attr/__pycache__/filters.cpython-311.pyc b/env/Lib/site-packages/attr/__pycache__/filters.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e26682d328c90f0a539696b64dbdd06c018ffd5d GIT binary patch literal 3177 zcmds3&uaGp#AvG&oyNXq2I*ApviHke*!uWk&PCRE!naw)#U|QLbh@TEhx4M zsM;E!W~VMAeQa$$Tk`95-*a!_CL^_`i))U{31ztEQ@m($PMKjc+p+i}Ha&Yd#G4J5 zEE?HAB$!c`g3LVlI!jGXEHN@@Dd;G0_rC^si1>)jmhPYyDx=3>c>;IT9)rh|#A}DY z{F?rd^sC-qQ=km$S~-iMeMWebdJLO5Ob+`syjY|D8u1w6i%dLQuE`hy7bt}&PM9z= z!tfn=Ymm)Zxcg;*Pmlz;x6svhZcC#XwIn|HaNzYA`cIPQ@AtK&&(T9kLiZ2a=rY=p zF6wfSb(rHZZh968RDP>Lw&XxIP6dkPGA3d%elb^`sa)~tN~Pr6j<;M{X;PE>w7TT; z3h`DepE^qw=5X?1!?ae+Wx^^VlaJyLZ!~Vb$eddy9=X||#kIp#)^HtOy>ZRt#yQuw zOqUgn#6AI2veN*+!(SV1=V#&CJoepzA4)$>cJyLbFT%isW07GL`w)cQY{{tDe7a15 zEGSSIr!)h-xJ)z$eL4>CsvP%-pwS#5rDB}p-j060tDlDfk)tq-UUWBv{&zW2L9~CD zWB#u>mbdfeILG}Rz0}o9Fd%XihS4j`QSd)u3OuM{yD-6G9M(D5HL{K9B#a9wV-&m%Hh5 zZ%oaldPvn$QT<_(q=^cN?a-eCSeMt8b#11;C-Mny%~LV7MSkQZTZi_dH!@Ght8Yj23Y}J#Yyf7nC)vNk2Km=V8LEOiVXSq$A7`SA5cuA}vdWVTUvkvb983#k6Rq+C1 zsT;ns1j{s+TrwOHlgwk_dpI5?WJPl{gb3PV_MIoh2ca+~d5Je94$*l59)+kv1#Hsg zW}SFEUXo$pRXBJY-?Ofn-ZHUgX7HJ_#%bdep0_O0;G!&`XAIwP_%*0AaqTe2f&3=Y z37=N<_rl#j1@M&u;wxQ;UexX?tEiD{q3g*pb615CrG@Uwt01+ZZh)|6s?|{MtJOdi z#oW?@Oj5`|TQ%J#2{bXn=q`A5pb0O=g!W_HZnvYopN>CKb#4FPV_)lC_N6yZxy_eS&i3JSE)+bU7hs18>b)`Mk(>W-=A9ifZ%DS7gxF-D zJdGw#SRAt6`bQ3)fz9=L9Lx<^NcTZ3Jpk}GR>kE9Rt-Kx!m5F3Uc`xCVXwogJ+RRS z)S?)I2gG_G`mZ8ZJTn!17ScnH3J^a7F6yaZtXj2w3*5P54{OYq2$yzs}HOu6pwa(8qLnkoA-Xd z_w>uqP#i(~?dRXK>ncKjh#%c1bq42aFgQdu+CVn8r5xUqHY6;@a!%e;HWU~uFVIHB zjsU8*3K+GcfSQD8>;!h7cF#l`aa&tQ$yo7Le8t<_^W5AsQsC4k+n%?}N!DY;b4^Zt z%lDZP{|m#;Bo3lx#&fgI)@vM$tun7j-DP<1Y!-a_8Dk#H^bEj2Ts#W>d=%h&xOx?3 zv5jA7Wn98wTqn#x<5U2BW- zw6O6}=OiQlEEs&stbCr@X5Puu;(G#(rJR?sa{P{Q@tue~UjX>0f*M2PRjE0Ct%Y#R z2%);#NK71zA8E(8f1N%{r0R)O^=|cUQ%_W5=dcMe4InA8VKE*7;DXa9gz4}VD8eoi zCI-Z-82~WT8df8tE%Xi;L4%VuWr8JOVIL*pP!a0$>i~zy7h>zQe$_t5NnCsoa{7qT zed_uk71Cw^BuIRZY*MlZVa+iRv^6w{ikRoc74z10f0036OT$BW@jP8?2QCIsMcCm4X_% z_}#mxf#L~O3ThllrTXa*6aS&BzX*oMG0F=$|5CaZ9zem4t#nN$l_1u$A4JSOYnL*S za6#PR-Ex+Uyv1fFT*QT-1*IKMqn)GJ2QdE$bp8ZDWIu}OZTg~G3q>PFQ=6&vKY!{| zM>mfipXsx8eO44A(zr5quyFABhov8vYJ)eL`bhPggQ=tY$JsMIRo7EBEp>tFwd4T& z51F=?frLeEfyU{#8JhQ@{BtI58djw+XG6_}w+vKobBAX9AhPz*eE2A=ZJ~C;M1P|# zLER|i=pB}X0|eFlIY3Ls7`IdjD=j2ILwLM~u3mf^=)+q7(^7Rj*+M;-QSnVEiCq}g c@m2A*12YLR>VW|ftg0`yS6U?^KH(kz1$p%OPyhe` literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/attr/__pycache__/validators.cpython-311.pyc b/env/Lib/site-packages/attr/__pycache__/validators.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..310703568eefdac8705424669e781debf9cd862e GIT binary patch literal 28449 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 Lh$)r>mIMC>tvsHg literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/attr/_cmp.py b/env/Lib/site-packages/attr/_cmp.py new file mode 100644 index 0000000..f367bb3 --- /dev/null +++ b/env/Lib/site-packages/attr/_cmp.py @@ -0,0 +1,160 @@ +# SPDX-License-Identifier: MIT + + +import functools +import types + +from ._make import _make_ne + + +_operation_names = {"eq": "==", "lt": "<", "le": "<=", "gt": ">", "ge": ">="} + + +def cmp_using( + eq=None, + lt=None, + le=None, + gt=None, + ge=None, + require_same_type=True, + class_name="Comparable", +): + """ + Create a class that can be passed into `attrs.field`'s ``eq``, ``order``, + and ``cmp`` arguments to customize field comparison. + + The resulting class will have a full set of ordering methods if at least + one of ``{lt, le, gt, ge}`` and ``eq`` are provided. + + Args: + eq (typing.Callable | None): + Callable used to evaluate equality of two objects. + + lt (typing.Callable | None): + Callable used to evaluate whether one object is less than another + object. + + le (typing.Callable | None): + Callable used to evaluate whether one object is less than or equal + to another object. + + gt (typing.Callable | None): + Callable used to evaluate whether one object is greater than + another object. + + ge (typing.Callable | None): + Callable used to evaluate whether one object is greater than or + equal to another object. + + require_same_type (bool): + When `True`, equality and ordering methods will return + `NotImplemented` if objects are not of the same type. + + class_name (str | None): Name of class. Defaults to "Comparable". + + See `comparison` for more details. + + .. versionadded:: 21.1.0 + """ + + body = { + "__slots__": ["value"], + "__init__": _make_init(), + "_requirements": [], + "_is_comparable_to": _is_comparable_to, + } + + # Add operations. + num_order_functions = 0 + has_eq_function = False + + if eq is not None: + has_eq_function = True + body["__eq__"] = _make_operator("eq", eq) + body["__ne__"] = _make_ne() + + if lt is not None: + num_order_functions += 1 + body["__lt__"] = _make_operator("lt", lt) + + if le is not None: + num_order_functions += 1 + body["__le__"] = _make_operator("le", le) + + if gt is not None: + num_order_functions += 1 + body["__gt__"] = _make_operator("gt", gt) + + if ge is not None: + num_order_functions += 1 + body["__ge__"] = _make_operator("ge", ge) + + type_ = types.new_class( + class_name, (object,), {}, lambda ns: ns.update(body) + ) + + # Add same type requirement. + if require_same_type: + type_._requirements.append(_check_same_type) + + # Add total ordering if at least one operation was defined. + if 0 < num_order_functions < 4: + if not has_eq_function: + # functools.total_ordering requires __eq__ to be defined, + # so raise early error here to keep a nice stack. + msg = "eq must be define is order to complete ordering from lt, le, gt, ge." + raise ValueError(msg) + type_ = functools.total_ordering(type_) + + return type_ + + +def _make_init(): + """ + Create __init__ method. + """ + + def __init__(self, value): + """ + Initialize object with *value*. + """ + self.value = value + + return __init__ + + +def _make_operator(name, func): + """ + Create operator method. + """ + + def method(self, other): + if not self._is_comparable_to(other): + return NotImplemented + + result = func(self.value, other.value) + if result is NotImplemented: + return NotImplemented + + return result + + method.__name__ = f"__{name}__" + method.__doc__ = ( + f"Return a {_operation_names[name]} b. Computed by attrs." + ) + + return method + + +def _is_comparable_to(self, other): + """ + Check whether `other` is comparable to `self`. + """ + return all(func(self, other) for func in self._requirements) + + +def _check_same_type(self, other): + """ + Return True if *self* and *other* are of the same type, False otherwise. + """ + return other.value.__class__ is self.value.__class__ diff --git a/env/Lib/site-packages/attr/_cmp.pyi b/env/Lib/site-packages/attr/_cmp.pyi new file mode 100644 index 0000000..cc7893b --- /dev/null +++ b/env/Lib/site-packages/attr/_cmp.pyi @@ -0,0 +1,13 @@ +from typing import Any, Callable + +_CompareWithType = Callable[[Any, Any], bool] + +def cmp_using( + eq: _CompareWithType | None = ..., + lt: _CompareWithType | None = ..., + le: _CompareWithType | None = ..., + gt: _CompareWithType | None = ..., + ge: _CompareWithType | None = ..., + require_same_type: bool = ..., + class_name: str = ..., +) -> type: ... diff --git a/env/Lib/site-packages/attr/_compat.py b/env/Lib/site-packages/attr/_compat.py new file mode 100644 index 0000000..104eeb0 --- /dev/null +++ b/env/Lib/site-packages/attr/_compat.py @@ -0,0 +1,103 @@ +# SPDX-License-Identifier: MIT + +import inspect +import platform +import sys +import threading + +from collections.abc import Mapping, Sequence # noqa: F401 +from typing import _GenericAlias + + +PYPY = platform.python_implementation() == "PyPy" +PY_3_8_PLUS = sys.version_info[:2] >= (3, 8) +PY_3_9_PLUS = sys.version_info[:2] >= (3, 9) +PY_3_10_PLUS = sys.version_info[:2] >= (3, 10) +PY_3_11_PLUS = sys.version_info[:2] >= (3, 11) +PY_3_12_PLUS = sys.version_info[:2] >= (3, 12) +PY_3_13_PLUS = sys.version_info[:2] >= (3, 13) +PY_3_14_PLUS = sys.version_info[:2] >= (3, 14) + + +if sys.version_info < (3, 8): + try: + from typing_extensions import Protocol + except ImportError: # pragma: no cover + Protocol = object +else: + from typing import Protocol # noqa: F401 + +if PY_3_14_PLUS: # pragma: no cover + import annotationlib + + _get_annotations = annotationlib.get_annotations + +else: + + def _get_annotations(cls): + """ + Get annotations for *cls*. + """ + return cls.__dict__.get("__annotations__", {}) + + +class _AnnotationExtractor: + """ + Extract type annotations from a callable, returning None whenever there + is none. + """ + + __slots__ = ["sig"] + + def __init__(self, callable): + try: + self.sig = inspect.signature(callable) + except (ValueError, TypeError): # inspect failed + self.sig = None + + def get_first_param_type(self): + """ + Return the type annotation of the first argument if it's not empty. + """ + if not self.sig: + return None + + params = list(self.sig.parameters.values()) + if params and params[0].annotation is not inspect.Parameter.empty: + return params[0].annotation + + return None + + def get_return_type(self): + """ + Return the return type if it's not empty. + """ + if ( + self.sig + and self.sig.return_annotation is not inspect.Signature.empty + ): + return self.sig.return_annotation + + return None + + +# Thread-local global to track attrs instances which are already being repr'd. +# This is needed because there is no other (thread-safe) way to pass info +# about the instances that are already being repr'd through the call stack +# in order to ensure we don't perform infinite recursion. +# +# For instance, if an instance contains a dict which contains that instance, +# we need to know that we're already repr'ing the outside instance from within +# the dict's repr() call. +# +# This lives here rather than in _make.py so that the functions in _make.py +# don't have a direct reference to the thread-local in their globals dict. +# If they have such a reference, it breaks cloudpickle. +repr_context = threading.local() + + +def get_generic_base(cl): + """If this is a generic class (A[str]), return the generic base for it.""" + if cl.__class__ is _GenericAlias: + return cl.__origin__ + return None diff --git a/env/Lib/site-packages/attr/_config.py b/env/Lib/site-packages/attr/_config.py new file mode 100644 index 0000000..9c245b1 --- /dev/null +++ b/env/Lib/site-packages/attr/_config.py @@ -0,0 +1,31 @@ +# SPDX-License-Identifier: MIT + +__all__ = ["set_run_validators", "get_run_validators"] + +_run_validators = True + + +def set_run_validators(run): + """ + Set whether or not validators are run. By default, they are run. + + .. deprecated:: 21.3.0 It will not be removed, but it also will not be + moved to new ``attrs`` namespace. Use `attrs.validators.set_disabled()` + instead. + """ + if not isinstance(run, bool): + msg = "'run' must be bool." + raise TypeError(msg) + global _run_validators + _run_validators = run + + +def get_run_validators(): + """ + Return whether or not validators are run. + + .. deprecated:: 21.3.0 It will not be removed, but it also will not be + moved to new ``attrs`` namespace. Use `attrs.validators.get_disabled()` + instead. + """ + return _run_validators diff --git a/env/Lib/site-packages/attr/_funcs.py b/env/Lib/site-packages/attr/_funcs.py new file mode 100644 index 0000000..355cef4 --- /dev/null +++ b/env/Lib/site-packages/attr/_funcs.py @@ -0,0 +1,522 @@ +# SPDX-License-Identifier: MIT + + +import copy + +from ._compat import PY_3_9_PLUS, get_generic_base +from ._make import _OBJ_SETATTR, NOTHING, fields +from .exceptions import AttrsAttributeNotFoundError + + +def asdict( + inst, + recurse=True, + filter=None, + dict_factory=dict, + retain_collection_types=False, + value_serializer=None, +): + """ + Return the *attrs* attribute values of *inst* as a dict. + + Optionally recurse into other *attrs*-decorated classes. + + Args: + inst: Instance of an *attrs*-decorated class. + + recurse (bool): Recurse into classes that are also *attrs*-decorated. + + filter (~typing.Callable): + A callable whose return code determines whether an attribute or + element is included (`True`) or dropped (`False`). Is called with + the `attrs.Attribute` as the first argument and the value as the + second argument. + + dict_factory (~typing.Callable): + A callable to produce dictionaries from. For example, to produce + ordered dictionaries instead of normal Python dictionaries, pass in + ``collections.OrderedDict``. + + retain_collection_types (bool): + Do not convert to `list` when encountering an attribute whose type + is `tuple` or `set`. Only meaningful if *recurse* is `True`. + + value_serializer (typing.Callable | None): + A hook that is called for every attribute or dict key/value. It + receives the current instance, field and value and must return the + (updated) value. The hook is run *after* the optional *filter* has + been applied. + + Returns: + Return type of *dict_factory*. + + Raises: + attrs.exceptions.NotAnAttrsClassError: + If *cls* is not an *attrs* class. + + .. versionadded:: 16.0.0 *dict_factory* + .. versionadded:: 16.1.0 *retain_collection_types* + .. versionadded:: 20.3.0 *value_serializer* + .. versionadded:: 21.3.0 + If a dict has a collection for a key, it is serialized as a tuple. + """ + attrs = fields(inst.__class__) + rv = dict_factory() + for a in attrs: + v = getattr(inst, a.name) + if filter is not None and not filter(a, v): + continue + + if value_serializer is not None: + v = value_serializer(inst, a, v) + + if recurse is True: + if has(v.__class__): + rv[a.name] = asdict( + v, + recurse=True, + filter=filter, + dict_factory=dict_factory, + retain_collection_types=retain_collection_types, + value_serializer=value_serializer, + ) + elif isinstance(v, (tuple, list, set, frozenset)): + cf = v.__class__ if retain_collection_types is True else list + items = [ + _asdict_anything( + i, + is_key=False, + filter=filter, + dict_factory=dict_factory, + retain_collection_types=retain_collection_types, + value_serializer=value_serializer, + ) + for i in v + ] + try: + rv[a.name] = cf(items) + except TypeError: + if not issubclass(cf, tuple): + raise + # Workaround for TypeError: cf.__new__() missing 1 required + # positional argument (which appears, for a namedturle) + rv[a.name] = cf(*items) + elif isinstance(v, dict): + df = dict_factory + rv[a.name] = df( + ( + _asdict_anything( + kk, + is_key=True, + filter=filter, + dict_factory=df, + retain_collection_types=retain_collection_types, + value_serializer=value_serializer, + ), + _asdict_anything( + vv, + is_key=False, + filter=filter, + dict_factory=df, + retain_collection_types=retain_collection_types, + value_serializer=value_serializer, + ), + ) + for kk, vv in v.items() + ) + else: + rv[a.name] = v + else: + rv[a.name] = v + return rv + + +def _asdict_anything( + val, + is_key, + filter, + dict_factory, + retain_collection_types, + value_serializer, +): + """ + ``asdict`` only works on attrs instances, this works on anything. + """ + if getattr(val.__class__, "__attrs_attrs__", None) is not None: + # Attrs class. + rv = asdict( + val, + recurse=True, + filter=filter, + dict_factory=dict_factory, + retain_collection_types=retain_collection_types, + value_serializer=value_serializer, + ) + elif isinstance(val, (tuple, list, set, frozenset)): + if retain_collection_types is True: + cf = val.__class__ + elif is_key: + cf = tuple + else: + cf = list + + rv = cf( + [ + _asdict_anything( + i, + is_key=False, + filter=filter, + dict_factory=dict_factory, + retain_collection_types=retain_collection_types, + value_serializer=value_serializer, + ) + for i in val + ] + ) + elif isinstance(val, dict): + df = dict_factory + rv = df( + ( + _asdict_anything( + kk, + is_key=True, + filter=filter, + dict_factory=df, + retain_collection_types=retain_collection_types, + value_serializer=value_serializer, + ), + _asdict_anything( + vv, + is_key=False, + filter=filter, + dict_factory=df, + retain_collection_types=retain_collection_types, + value_serializer=value_serializer, + ), + ) + for kk, vv in val.items() + ) + else: + rv = val + if value_serializer is not None: + rv = value_serializer(None, None, rv) + + return rv + + +def astuple( + inst, + recurse=True, + filter=None, + tuple_factory=tuple, + retain_collection_types=False, +): + """ + Return the *attrs* attribute values of *inst* as a tuple. + + Optionally recurse into other *attrs*-decorated classes. + + Args: + inst: Instance of an *attrs*-decorated class. + + recurse (bool): + Recurse into classes that are also *attrs*-decorated. + + filter (~typing.Callable): + A callable whose return code determines whether an attribute or + element is included (`True`) or dropped (`False`). Is called with + the `attrs.Attribute` as the first argument and the value as the + second argument. + + tuple_factory (~typing.Callable): + A callable to produce tuples from. For example, to produce lists + instead of tuples. + + retain_collection_types (bool): + Do not convert to `list` or `dict` when encountering an attribute + which type is `tuple`, `dict` or `set`. Only meaningful if + *recurse* is `True`. + + Returns: + Return type of *tuple_factory* + + Raises: + attrs.exceptions.NotAnAttrsClassError: + If *cls* is not an *attrs* class. + + .. versionadded:: 16.2.0 + """ + attrs = fields(inst.__class__) + rv = [] + retain = retain_collection_types # Very long. :/ + for a in attrs: + v = getattr(inst, a.name) + if filter is not None and not filter(a, v): + continue + if recurse is True: + if has(v.__class__): + rv.append( + astuple( + v, + recurse=True, + filter=filter, + tuple_factory=tuple_factory, + retain_collection_types=retain, + ) + ) + elif isinstance(v, (tuple, list, set, frozenset)): + cf = v.__class__ if retain is True else list + items = [ + ( + astuple( + j, + recurse=True, + filter=filter, + tuple_factory=tuple_factory, + retain_collection_types=retain, + ) + if has(j.__class__) + else j + ) + for j in v + ] + try: + rv.append(cf(items)) + except TypeError: + if not issubclass(cf, tuple): + raise + # Workaround for TypeError: cf.__new__() missing 1 required + # positional argument (which appears, for a namedturle) + rv.append(cf(*items)) + elif isinstance(v, dict): + df = v.__class__ if retain is True else dict + rv.append( + df( + ( + ( + astuple( + kk, + tuple_factory=tuple_factory, + retain_collection_types=retain, + ) + if has(kk.__class__) + else kk + ), + ( + astuple( + vv, + tuple_factory=tuple_factory, + retain_collection_types=retain, + ) + if has(vv.__class__) + else vv + ), + ) + for kk, vv in v.items() + ) + ) + else: + rv.append(v) + else: + rv.append(v) + + return rv if tuple_factory is list else tuple_factory(rv) + + +def has(cls): + """ + Check whether *cls* is a class with *attrs* attributes. + + Args: + cls (type): Class to introspect. + + Raises: + TypeError: If *cls* is not a class. + + Returns: + bool: + """ + attrs = getattr(cls, "__attrs_attrs__", None) + if attrs is not None: + return True + + # No attrs, maybe it's a specialized generic (A[str])? + generic_base = get_generic_base(cls) + if generic_base is not None: + generic_attrs = getattr(generic_base, "__attrs_attrs__", None) + if generic_attrs is not None: + # Stick it on here for speed next time. + cls.__attrs_attrs__ = generic_attrs + return generic_attrs is not None + return False + + +def assoc(inst, **changes): + """ + Copy *inst* and apply *changes*. + + This is different from `evolve` that applies the changes to the arguments + that create the new instance. + + `evolve`'s behavior is preferable, but there are `edge cases`_ where it + doesn't work. Therefore `assoc` is deprecated, but will not be removed. + + .. _`edge cases`: https://github.com/python-attrs/attrs/issues/251 + + Args: + inst: Instance of a class with *attrs* attributes. + + changes: Keyword changes in the new copy. + + Returns: + A copy of inst with *changes* incorporated. + + Raises: + attrs.exceptions.AttrsAttributeNotFoundError: + If *attr_name* couldn't be found on *cls*. + + attrs.exceptions.NotAnAttrsClassError: + If *cls* is not an *attrs* class. + + .. deprecated:: 17.1.0 + Use `attrs.evolve` instead if you can. This function will not be + removed du to the slightly different approach compared to + `attrs.evolve`, though. + """ + new = copy.copy(inst) + attrs = fields(inst.__class__) + for k, v in changes.items(): + a = getattr(attrs, k, NOTHING) + if a is NOTHING: + msg = f"{k} is not an attrs attribute on {new.__class__}." + raise AttrsAttributeNotFoundError(msg) + _OBJ_SETATTR(new, k, v) + return new + + +def evolve(*args, **changes): + """ + Create a new instance, based on the first positional argument with + *changes* applied. + + Args: + + inst: + Instance of a class with *attrs* attributes. *inst* must be passed + as a positional argument. + + changes: + Keyword changes in the new copy. + + Returns: + A copy of inst with *changes* incorporated. + + Raises: + TypeError: + If *attr_name* couldn't be found in the class ``__init__``. + + attrs.exceptions.NotAnAttrsClassError: + If *cls* is not an *attrs* class. + + .. versionadded:: 17.1.0 + .. deprecated:: 23.1.0 + It is now deprecated to pass the instance using the keyword argument + *inst*. It will raise a warning until at least April 2024, after which + it will become an error. Always pass the instance as a positional + argument. + .. versionchanged:: 24.1.0 + *inst* can't be passed as a keyword argument anymore. + """ + try: + (inst,) = args + except ValueError: + msg = ( + f"evolve() takes 1 positional argument, but {len(args)} were given" + ) + raise TypeError(msg) from None + + cls = inst.__class__ + attrs = fields(cls) + for a in attrs: + if not a.init: + continue + attr_name = a.name # To deal with private attributes. + init_name = a.alias + if init_name not in changes: + changes[init_name] = getattr(inst, attr_name) + + return cls(**changes) + + +def resolve_types( + cls, globalns=None, localns=None, attribs=None, include_extras=True +): + """ + Resolve any strings and forward annotations in type annotations. + + This is only required if you need concrete types in :class:`Attribute`'s + *type* field. In other words, you don't need to resolve your types if you + only use them for static type checking. + + With no arguments, names will be looked up in the module in which the class + was created. If this is not what you want, for example, if the name only + exists inside a method, you may pass *globalns* or *localns* to specify + other dictionaries in which to look up these names. See the docs of + `typing.get_type_hints` for more details. + + Args: + cls (type): Class to resolve. + + globalns (dict | None): Dictionary containing global variables. + + localns (dict | None): Dictionary containing local variables. + + attribs (list | None): + List of attribs for the given class. This is necessary when calling + from inside a ``field_transformer`` since *cls* is not an *attrs* + class yet. + + include_extras (bool): + Resolve more accurately, if possible. Pass ``include_extras`` to + ``typing.get_hints``, if supported by the typing module. On + supported Python versions (3.9+), this resolves the types more + accurately. + + Raises: + TypeError: If *cls* is not a class. + + attrs.exceptions.NotAnAttrsClassError: + If *cls* is not an *attrs* class and you didn't pass any attribs. + + NameError: If types cannot be resolved because of missing variables. + + Returns: + *cls* so you can use this function also as a class decorator. Please + note that you have to apply it **after** `attrs.define`. That means the + decorator has to come in the line **before** `attrs.define`. + + .. versionadded:: 20.1.0 + .. versionadded:: 21.1.0 *attribs* + .. versionadded:: 23.1.0 *include_extras* + """ + # Since calling get_type_hints is expensive we cache whether we've + # done it already. + if getattr(cls, "__attrs_types_resolved__", None) != cls: + import typing + + kwargs = {"globalns": globalns, "localns": localns} + + if PY_3_9_PLUS: + kwargs["include_extras"] = include_extras + + hints = typing.get_type_hints(cls, **kwargs) + for field in fields(cls) if attribs is None else attribs: + if field.name in hints: + # Since fields have been frozen we must work around it. + _OBJ_SETATTR(field, "type", hints[field.name]) + # We store the class we resolved so that subclasses know they haven't + # been resolved. + cls.__attrs_types_resolved__ = cls + + # Return the class so you can use it as a decorator too. + return cls diff --git a/env/Lib/site-packages/attr/_make.py b/env/Lib/site-packages/attr/_make.py new file mode 100644 index 0000000..bf00c5f --- /dev/null +++ b/env/Lib/site-packages/attr/_make.py @@ -0,0 +1,2960 @@ +# SPDX-License-Identifier: MIT + +from __future__ import annotations + +import abc +import contextlib +import copy +import enum +import functools +import inspect +import itertools +import linecache +import sys +import types +import typing + +from operator import itemgetter + +# We need to import _compat itself in addition to the _compat members to avoid +# having the thread-local in the globals here. +from . import _compat, _config, setters +from ._compat import ( + PY_3_8_PLUS, + PY_3_10_PLUS, + PY_3_11_PLUS, + _AnnotationExtractor, + _get_annotations, + get_generic_base, +) +from .exceptions import ( + DefaultAlreadySetError, + FrozenInstanceError, + NotAnAttrsClassError, + UnannotatedAttributeError, +) + + +# This is used at least twice, so cache it here. +_OBJ_SETATTR = object.__setattr__ +_INIT_FACTORY_PAT = "__attr_factory_%s" +_CLASSVAR_PREFIXES = ( + "typing.ClassVar", + "t.ClassVar", + "ClassVar", + "typing_extensions.ClassVar", +) +# we don't use a double-underscore prefix because that triggers +# name mangling when trying to create a slot for the field +# (when slots=True) +_HASH_CACHE_FIELD = "_attrs_cached_hash" + +_EMPTY_METADATA_SINGLETON = types.MappingProxyType({}) + +# Unique object for unequivocal getattr() defaults. +_SENTINEL = object() + +_DEFAULT_ON_SETATTR = setters.pipe(setters.convert, setters.validate) + + +class _Nothing(enum.Enum): + """ + Sentinel to indicate the lack of a value when `None` is ambiguous. + + If extending attrs, you can use ``typing.Literal[NOTHING]`` to show + that a value may be ``NOTHING``. + + .. versionchanged:: 21.1.0 ``bool(NOTHING)`` is now False. + .. versionchanged:: 22.2.0 ``NOTHING`` is now an ``enum.Enum`` variant. + """ + + NOTHING = enum.auto() + + def __repr__(self): + return "NOTHING" + + def __bool__(self): + return False + + +NOTHING = _Nothing.NOTHING +""" +Sentinel to indicate the lack of a value when `None` is ambiguous. +""" + + +class _CacheHashWrapper(int): + """ + An integer subclass that pickles / copies as None + + This is used for non-slots classes with ``cache_hash=True``, to avoid + serializing a potentially (even likely) invalid hash value. Since `None` + is the default value for uncalculated hashes, whenever this is copied, + the copy's value for the hash should automatically reset. + + See GH #613 for more details. + """ + + def __reduce__(self, _none_constructor=type(None), _args=()): # noqa: B008 + return _none_constructor, _args + + +def attrib( + default=NOTHING, + validator=None, + repr=True, + cmp=None, + hash=None, + init=True, + metadata=None, + type=None, + converter=None, + factory=None, + kw_only=False, + eq=None, + order=None, + on_setattr=None, + alias=None, +): + """ + Create a new field / attribute on a class. + + Identical to `attrs.field`, except it's not keyword-only. + + Consider using `attrs.field` in new code (``attr.ib`` will *never* go away, + though). + + .. warning:: + + Does **nothing** unless the class is also decorated with + `attr.s` (or similar)! + + + .. versionadded:: 15.2.0 *convert* + .. versionadded:: 16.3.0 *metadata* + .. versionchanged:: 17.1.0 *validator* can be a ``list`` now. + .. versionchanged:: 17.1.0 + *hash* is `None` and therefore mirrors *eq* by default. + .. versionadded:: 17.3.0 *type* + .. deprecated:: 17.4.0 *convert* + .. versionadded:: 17.4.0 + *converter* as a replacement for the deprecated *convert* to achieve + consistency with other noun-based arguments. + .. versionadded:: 18.1.0 + ``factory=f`` is syntactic sugar for ``default=attr.Factory(f)``. + .. versionadded:: 18.2.0 *kw_only* + .. versionchanged:: 19.2.0 *convert* keyword argument removed. + .. versionchanged:: 19.2.0 *repr* also accepts a custom callable. + .. deprecated:: 19.2.0 *cmp* Removal on or after 2021-06-01. + .. versionadded:: 19.2.0 *eq* and *order* + .. versionadded:: 20.1.0 *on_setattr* + .. versionchanged:: 20.3.0 *kw_only* backported to Python 2 + .. versionchanged:: 21.1.0 + *eq*, *order*, and *cmp* also accept a custom callable + .. versionchanged:: 21.1.0 *cmp* undeprecated + .. versionadded:: 22.2.0 *alias* + """ + eq, eq_key, order, order_key = _determine_attrib_eq_order( + cmp, eq, order, True + ) + + if hash is not None and hash is not True and hash is not False: + msg = "Invalid value for hash. Must be True, False, or None." + raise TypeError(msg) + + if factory is not None: + if default is not NOTHING: + msg = ( + "The `default` and `factory` arguments are mutually exclusive." + ) + raise ValueError(msg) + if not callable(factory): + msg = "The `factory` argument must be a callable." + raise ValueError(msg) + default = Factory(factory) + + if metadata is None: + metadata = {} + + # Apply syntactic sugar by auto-wrapping. + if isinstance(on_setattr, (list, tuple)): + on_setattr = setters.pipe(*on_setattr) + + if validator and isinstance(validator, (list, tuple)): + validator = and_(*validator) + + if converter and isinstance(converter, (list, tuple)): + converter = pipe(*converter) + + return _CountingAttr( + default=default, + validator=validator, + repr=repr, + cmp=None, + hash=hash, + init=init, + converter=converter, + metadata=metadata, + type=type, + kw_only=kw_only, + eq=eq, + eq_key=eq_key, + order=order, + order_key=order_key, + on_setattr=on_setattr, + alias=alias, + ) + + +def _compile_and_eval(script, globs, locs=None, filename=""): + """ + Evaluate the script with the given global (globs) and local (locs) + variables. + """ + bytecode = compile(script, filename, "exec") + eval(bytecode, globs, locs) + + +def _make_method(name, script, filename, globs, locals=None): + """ + Create the method with the script given and return the method object. + """ + locs = {} if locals is None else locals + + # In order of debuggers like PDB being able to step through the code, + # we add a fake linecache entry. + count = 1 + base_filename = filename + while True: + linecache_tuple = ( + len(script), + None, + script.splitlines(True), + filename, + ) + old_val = linecache.cache.setdefault(filename, linecache_tuple) + if old_val == linecache_tuple: + break + + filename = f"{base_filename[:-1]}-{count}>" + count += 1 + + _compile_and_eval(script, globs, locs, filename) + + return locs[name] + + +def _make_attr_tuple_class(cls_name, attr_names): + """ + Create a tuple subclass to hold `Attribute`s for an `attrs` class. + + The subclass is a bare tuple with properties for names. + + class MyClassAttributes(tuple): + __slots__ = () + x = property(itemgetter(0)) + """ + attr_class_name = f"{cls_name}Attributes" + attr_class_template = [ + f"class {attr_class_name}(tuple):", + " __slots__ = ()", + ] + if attr_names: + for i, attr_name in enumerate(attr_names): + attr_class_template.append( + f" {attr_name} = _attrs_property(_attrs_itemgetter({i}))" + ) + else: + attr_class_template.append(" pass") + globs = {"_attrs_itemgetter": itemgetter, "_attrs_property": property} + _compile_and_eval("\n".join(attr_class_template), globs) + return globs[attr_class_name] + + +# Tuple class for extracted attributes from a class definition. +# `base_attrs` is a subset of `attrs`. +_Attributes = _make_attr_tuple_class( + "_Attributes", + [ + # all attributes to build dunder methods for + "attrs", + # attributes that have been inherited + "base_attrs", + # map inherited attributes to their originating classes + "base_attrs_map", + ], +) + + +def _is_class_var(annot): + """ + Check whether *annot* is a typing.ClassVar. + + The string comparison hack is used to avoid evaluating all string + annotations which would put attrs-based classes at a performance + disadvantage compared to plain old classes. + """ + annot = str(annot) + + # Annotation can be quoted. + if annot.startswith(("'", '"')) and annot.endswith(("'", '"')): + annot = annot[1:-1] + + return annot.startswith(_CLASSVAR_PREFIXES) + + +def _has_own_attribute(cls, attrib_name): + """ + Check whether *cls* defines *attrib_name* (and doesn't just inherit it). + """ + return attrib_name in cls.__dict__ + + +def _collect_base_attrs(cls, taken_attr_names): + """ + Collect attr.ibs from base classes of *cls*, except *taken_attr_names*. + """ + base_attrs = [] + base_attr_map = {} # A dictionary of base attrs to their classes. + + # Traverse the MRO and collect attributes. + for base_cls in reversed(cls.__mro__[1:-1]): + for a in getattr(base_cls, "__attrs_attrs__", []): + if a.inherited or a.name in taken_attr_names: + continue + + a = a.evolve(inherited=True) # noqa: PLW2901 + base_attrs.append(a) + base_attr_map[a.name] = base_cls + + # For each name, only keep the freshest definition i.e. the furthest at the + # back. base_attr_map is fine because it gets overwritten with every new + # instance. + filtered = [] + seen = set() + for a in reversed(base_attrs): + if a.name in seen: + continue + filtered.insert(0, a) + seen.add(a.name) + + return filtered, base_attr_map + + +def _collect_base_attrs_broken(cls, taken_attr_names): + """ + Collect attr.ibs from base classes of *cls*, except *taken_attr_names*. + + N.B. *taken_attr_names* will be mutated. + + Adhere to the old incorrect behavior. + + Notably it collects from the front and considers inherited attributes which + leads to the buggy behavior reported in #428. + """ + base_attrs = [] + base_attr_map = {} # A dictionary of base attrs to their classes. + + # Traverse the MRO and collect attributes. + for base_cls in cls.__mro__[1:-1]: + for a in getattr(base_cls, "__attrs_attrs__", []): + if a.name in taken_attr_names: + continue + + a = a.evolve(inherited=True) # noqa: PLW2901 + taken_attr_names.add(a.name) + base_attrs.append(a) + base_attr_map[a.name] = base_cls + + return base_attrs, base_attr_map + + +def _transform_attrs( + cls, these, auto_attribs, kw_only, collect_by_mro, field_transformer +): + """ + Transform all `_CountingAttr`s on a class into `Attribute`s. + + If *these* is passed, use that and don't look for them on the class. + + If *collect_by_mro* is True, collect them in the correct MRO order, + otherwise use the old -- incorrect -- order. See #428. + + Return an `_Attributes`. + """ + cd = cls.__dict__ + anns = _get_annotations(cls) + + if these is not None: + ca_list = list(these.items()) + elif auto_attribs is True: + ca_names = { + name + for name, attr in cd.items() + if isinstance(attr, _CountingAttr) + } + ca_list = [] + annot_names = set() + for attr_name, type in anns.items(): + if _is_class_var(type): + continue + annot_names.add(attr_name) + a = cd.get(attr_name, NOTHING) + + if not isinstance(a, _CountingAttr): + a = attrib() if a is NOTHING else attrib(default=a) + ca_list.append((attr_name, a)) + + unannotated = ca_names - annot_names + if len(unannotated) > 0: + raise UnannotatedAttributeError( + "The following `attr.ib`s lack a type annotation: " + + ", ".join( + sorted(unannotated, key=lambda n: cd.get(n).counter) + ) + + "." + ) + else: + ca_list = sorted( + ( + (name, attr) + for name, attr in cd.items() + if isinstance(attr, _CountingAttr) + ), + key=lambda e: e[1].counter, + ) + + own_attrs = [ + Attribute.from_counting_attr( + name=attr_name, ca=ca, type=anns.get(attr_name) + ) + for attr_name, ca in ca_list + ] + + if collect_by_mro: + base_attrs, base_attr_map = _collect_base_attrs( + cls, {a.name for a in own_attrs} + ) + else: + base_attrs, base_attr_map = _collect_base_attrs_broken( + cls, {a.name for a in own_attrs} + ) + + if kw_only: + own_attrs = [a.evolve(kw_only=True) for a in own_attrs] + base_attrs = [a.evolve(kw_only=True) for a in base_attrs] + + attrs = base_attrs + own_attrs + + # Mandatory vs non-mandatory attr order only matters when they are part of + # the __init__ signature and when they aren't kw_only (which are moved to + # the end and can be mandatory or non-mandatory in any order, as they will + # be specified as keyword args anyway). Check the order of those attrs: + had_default = False + for a in (a for a in attrs if a.init is not False and a.kw_only is False): + if had_default is True and a.default is NOTHING: + msg = f"No mandatory attributes allowed after an attribute with a default value or factory. Attribute in question: {a!r}" + raise ValueError(msg) + + if had_default is False and a.default is not NOTHING: + had_default = True + + if field_transformer is not None: + attrs = field_transformer(cls, attrs) + + # Resolve default field alias after executing field_transformer. + # This allows field_transformer to differentiate between explicit vs + # default aliases and supply their own defaults. + attrs = [ + a.evolve(alias=_default_init_alias_for(a.name)) if not a.alias else a + for a in attrs + ] + + # Create AttrsClass *after* applying the field_transformer since it may + # add or remove attributes! + attr_names = [a.name for a in attrs] + AttrsClass = _make_attr_tuple_class(cls.__name__, attr_names) + + return _Attributes((AttrsClass(attrs), base_attrs, base_attr_map)) + + +def _make_cached_property_getattr(cached_properties, original_getattr, cls): + lines = [ + # Wrapped to get `__class__` into closure cell for super() + # (It will be replaced with the newly constructed class after construction). + "def wrapper(_cls):", + " __class__ = _cls", + " def __getattr__(self, item, cached_properties=cached_properties, original_getattr=original_getattr, _cached_setattr_get=_cached_setattr_get):", + " func = cached_properties.get(item)", + " if func is not None:", + " result = func(self)", + " _setter = _cached_setattr_get(self)", + " _setter(item, result)", + " return result", + ] + if original_getattr is not None: + lines.append( + " return original_getattr(self, item)", + ) + else: + lines.extend( + [ + " try:", + " return super().__getattribute__(item)", + " except AttributeError:", + " if not hasattr(super(), '__getattr__'):", + " raise", + " return super().__getattr__(item)", + " original_error = f\"'{self.__class__.__name__}' object has no attribute '{item}'\"", + " raise AttributeError(original_error)", + ] + ) + + lines.extend( + [ + " return __getattr__", + "__getattr__ = wrapper(_cls)", + ] + ) + + unique_filename = _generate_unique_filename(cls, "getattr") + + glob = { + "cached_properties": cached_properties, + "_cached_setattr_get": _OBJ_SETATTR.__get__, + "original_getattr": original_getattr, + } + + return _make_method( + "__getattr__", + "\n".join(lines), + unique_filename, + glob, + locals={ + "_cls": cls, + }, + ) + + +def _frozen_setattrs(self, name, value): + """ + Attached to frozen classes as __setattr__. + """ + if isinstance(self, BaseException) and name in ( + "__cause__", + "__context__", + "__traceback__", + ): + BaseException.__setattr__(self, name, value) + return + + raise FrozenInstanceError() + + +def _frozen_delattrs(self, name): + """ + Attached to frozen classes as __delattr__. + """ + raise FrozenInstanceError() + + +class _ClassBuilder: + """ + Iteratively build *one* class. + """ + + __slots__ = ( + "_attr_names", + "_attrs", + "_base_attr_map", + "_base_names", + "_cache_hash", + "_cls", + "_cls_dict", + "_delete_attribs", + "_frozen", + "_has_pre_init", + "_pre_init_has_args", + "_has_post_init", + "_is_exc", + "_on_setattr", + "_slots", + "_weakref_slot", + "_wrote_own_setattr", + "_has_custom_setattr", + ) + + def __init__( + self, + cls, + these, + slots, + frozen, + weakref_slot, + getstate_setstate, + auto_attribs, + kw_only, + cache_hash, + is_exc, + collect_by_mro, + on_setattr, + has_custom_setattr, + field_transformer, + ): + attrs, base_attrs, base_map = _transform_attrs( + cls, + these, + auto_attribs, + kw_only, + collect_by_mro, + field_transformer, + ) + + self._cls = cls + self._cls_dict = dict(cls.__dict__) if slots else {} + self._attrs = attrs + self._base_names = {a.name for a in base_attrs} + self._base_attr_map = base_map + self._attr_names = tuple(a.name for a in attrs) + self._slots = slots + self._frozen = frozen + self._weakref_slot = weakref_slot + self._cache_hash = cache_hash + self._has_pre_init = bool(getattr(cls, "__attrs_pre_init__", False)) + self._pre_init_has_args = False + if self._has_pre_init: + # Check if the pre init method has more arguments than just `self` + # We want to pass arguments if pre init expects arguments + pre_init_func = cls.__attrs_pre_init__ + pre_init_signature = inspect.signature(pre_init_func) + self._pre_init_has_args = len(pre_init_signature.parameters) > 1 + self._has_post_init = bool(getattr(cls, "__attrs_post_init__", False)) + self._delete_attribs = not bool(these) + self._is_exc = is_exc + self._on_setattr = on_setattr + + self._has_custom_setattr = has_custom_setattr + self._wrote_own_setattr = False + + self._cls_dict["__attrs_attrs__"] = self._attrs + + if frozen: + self._cls_dict["__setattr__"] = _frozen_setattrs + self._cls_dict["__delattr__"] = _frozen_delattrs + + self._wrote_own_setattr = True + elif on_setattr in ( + _DEFAULT_ON_SETATTR, + setters.validate, + setters.convert, + ): + has_validator = has_converter = False + for a in attrs: + if a.validator is not None: + has_validator = True + if a.converter is not None: + has_converter = True + + if has_validator and has_converter: + break + if ( + ( + on_setattr == _DEFAULT_ON_SETATTR + and not (has_validator or has_converter) + ) + or (on_setattr == setters.validate and not has_validator) + or (on_setattr == setters.convert and not has_converter) + ): + # If class-level on_setattr is set to convert + validate, but + # there's no field to convert or validate, pretend like there's + # no on_setattr. + self._on_setattr = None + + if getstate_setstate: + ( + self._cls_dict["__getstate__"], + self._cls_dict["__setstate__"], + ) = self._make_getstate_setstate() + + def __repr__(self): + return f"<_ClassBuilder(cls={self._cls.__name__})>" + + def build_class(self): + """ + Finalize class based on the accumulated configuration. + + Builder cannot be used after calling this method. + """ + if self._slots is True: + cls = self._create_slots_class() + else: + cls = self._patch_original_class() + if PY_3_10_PLUS: + cls = abc.update_abstractmethods(cls) + + # The method gets only called if it's not inherited from a base class. + # _has_own_attribute does NOT work properly for classmethods. + if ( + getattr(cls, "__attrs_init_subclass__", None) + and "__attrs_init_subclass__" not in cls.__dict__ + ): + cls.__attrs_init_subclass__() + + return cls + + def _patch_original_class(self): + """ + Apply accumulated methods and return the class. + """ + cls = self._cls + base_names = self._base_names + + # Clean class of attribute definitions (`attr.ib()`s). + if self._delete_attribs: + for name in self._attr_names: + if ( + name not in base_names + and getattr(cls, name, _SENTINEL) is not _SENTINEL + ): + # An AttributeError can happen if a base class defines a + # class variable and we want to set an attribute with the + # same name by using only a type annotation. + with contextlib.suppress(AttributeError): + delattr(cls, name) + + # Attach our dunder methods. + for name, value in self._cls_dict.items(): + setattr(cls, name, value) + + # If we've inherited an attrs __setattr__ and don't write our own, + # reset it to object's. + if not self._wrote_own_setattr and getattr( + cls, "__attrs_own_setattr__", False + ): + cls.__attrs_own_setattr__ = False + + if not self._has_custom_setattr: + cls.__setattr__ = _OBJ_SETATTR + + return cls + + def _create_slots_class(self): + """ + Build and return a new class with a `__slots__` attribute. + """ + cd = { + k: v + for k, v in self._cls_dict.items() + if k not in (*tuple(self._attr_names), "__dict__", "__weakref__") + } + + # If our class doesn't have its own implementation of __setattr__ + # (either from the user or by us), check the bases, if one of them has + # an attrs-made __setattr__, that needs to be reset. We don't walk the + # MRO because we only care about our immediate base classes. + # XXX: This can be confused by subclassing a slotted attrs class with + # XXX: a non-attrs class and subclass the resulting class with an attrs + # XXX: class. See `test_slotted_confused` for details. For now that's + # XXX: OK with us. + if not self._wrote_own_setattr: + cd["__attrs_own_setattr__"] = False + + if not self._has_custom_setattr: + for base_cls in self._cls.__bases__: + if base_cls.__dict__.get("__attrs_own_setattr__", False): + cd["__setattr__"] = _OBJ_SETATTR + break + + # Traverse the MRO to collect existing slots + # and check for an existing __weakref__. + existing_slots = {} + weakref_inherited = False + for base_cls in self._cls.__mro__[1:-1]: + if base_cls.__dict__.get("__weakref__", None) is not None: + weakref_inherited = True + existing_slots.update( + { + name: getattr(base_cls, name) + for name in getattr(base_cls, "__slots__", []) + } + ) + + base_names = set(self._base_names) + + names = self._attr_names + if ( + self._weakref_slot + and "__weakref__" not in getattr(self._cls, "__slots__", ()) + and "__weakref__" not in names + and not weakref_inherited + ): + names += ("__weakref__",) + + if PY_3_8_PLUS: + cached_properties = { + name: cached_property.func + for name, cached_property in cd.items() + if isinstance(cached_property, functools.cached_property) + } + else: + # `functools.cached_property` was introduced in 3.8. + # So can't be used before this. + cached_properties = {} + + # Collect methods with a `__class__` reference that are shadowed in the new class. + # To know to update them. + additional_closure_functions_to_update = [] + if cached_properties: + class_annotations = _get_annotations(self._cls) + for name, func in cached_properties.items(): + # Add cached properties to names for slotting. + names += (name,) + # Clear out function from class to avoid clashing. + del cd[name] + additional_closure_functions_to_update.append(func) + annotation = inspect.signature(func).return_annotation + if annotation is not inspect.Parameter.empty: + class_annotations[name] = annotation + + original_getattr = cd.get("__getattr__") + if original_getattr is not None: + additional_closure_functions_to_update.append(original_getattr) + + cd["__getattr__"] = _make_cached_property_getattr( + cached_properties, original_getattr, self._cls + ) + + # We only add the names of attributes that aren't inherited. + # Setting __slots__ to inherited attributes wastes memory. + slot_names = [name for name in names if name not in base_names] + + # There are slots for attributes from current class + # that are defined in parent classes. + # As their descriptors may be overridden by a child class, + # we collect them here and update the class dict + reused_slots = { + slot: slot_descriptor + for slot, slot_descriptor in existing_slots.items() + if slot in slot_names + } + slot_names = [name for name in slot_names if name not in reused_slots] + cd.update(reused_slots) + if self._cache_hash: + slot_names.append(_HASH_CACHE_FIELD) + + cd["__slots__"] = tuple(slot_names) + + cd["__qualname__"] = self._cls.__qualname__ + + # Create new class based on old class and our methods. + cls = type(self._cls)(self._cls.__name__, self._cls.__bases__, cd) + + # The following is a fix for + # . + # If a method mentions `__class__` or uses the no-arg super(), the + # compiler will bake a reference to the class in the method itself + # as `method.__closure__`. Since we replace the class with a + # clone, we rewrite these references so it keeps working. + for item in itertools.chain( + cls.__dict__.values(), additional_closure_functions_to_update + ): + if isinstance(item, (classmethod, staticmethod)): + # Class- and staticmethods hide their functions inside. + # These might need to be rewritten as well. + closure_cells = getattr(item.__func__, "__closure__", None) + elif isinstance(item, property): + # Workaround for property `super()` shortcut (PY3-only). + # There is no universal way for other descriptors. + closure_cells = getattr(item.fget, "__closure__", None) + else: + closure_cells = getattr(item, "__closure__", None) + + if not closure_cells: # Catch None or the empty list. + continue + for cell in closure_cells: + try: + match = cell.cell_contents is self._cls + except ValueError: # noqa: PERF203 + # ValueError: Cell is empty + pass + else: + if match: + cell.cell_contents = cls + return cls + + def add_repr(self, ns): + self._cls_dict["__repr__"] = self._add_method_dunders( + _make_repr(self._attrs, ns, self._cls) + ) + return self + + def add_str(self): + repr = self._cls_dict.get("__repr__") + if repr is None: + msg = "__str__ can only be generated if a __repr__ exists." + raise ValueError(msg) + + def __str__(self): + return self.__repr__() + + self._cls_dict["__str__"] = self._add_method_dunders(__str__) + return self + + def _make_getstate_setstate(self): + """ + Create custom __setstate__ and __getstate__ methods. + """ + # __weakref__ is not writable. + state_attr_names = tuple( + an for an in self._attr_names if an != "__weakref__" + ) + + def slots_getstate(self): + """ + Automatically created by attrs. + """ + return {name: getattr(self, name) for name in state_attr_names} + + hash_caching_enabled = self._cache_hash + + def slots_setstate(self, state): + """ + Automatically created by attrs. + """ + __bound_setattr = _OBJ_SETATTR.__get__(self) + if isinstance(state, tuple): + # Backward compatibility with attrs instances pickled with + # attrs versions before v22.2.0 which stored tuples. + for name, value in zip(state_attr_names, state): + __bound_setattr(name, value) + else: + for name in state_attr_names: + if name in state: + __bound_setattr(name, state[name]) + + # The hash code cache is not included when the object is + # serialized, but it still needs to be initialized to None to + # indicate that the first call to __hash__ should be a cache + # miss. + if hash_caching_enabled: + __bound_setattr(_HASH_CACHE_FIELD, None) + + return slots_getstate, slots_setstate + + def make_unhashable(self): + self._cls_dict["__hash__"] = None + return self + + def add_hash(self): + self._cls_dict["__hash__"] = self._add_method_dunders( + _make_hash( + self._cls, + self._attrs, + frozen=self._frozen, + cache_hash=self._cache_hash, + ) + ) + + return self + + def add_init(self): + self._cls_dict["__init__"] = self._add_method_dunders( + _make_init( + self._cls, + self._attrs, + self._has_pre_init, + self._pre_init_has_args, + self._has_post_init, + self._frozen, + self._slots, + self._cache_hash, + self._base_attr_map, + self._is_exc, + self._on_setattr, + attrs_init=False, + ) + ) + + return self + + def add_match_args(self): + self._cls_dict["__match_args__"] = tuple( + field.name + for field in self._attrs + if field.init and not field.kw_only + ) + + def add_attrs_init(self): + self._cls_dict["__attrs_init__"] = self._add_method_dunders( + _make_init( + self._cls, + self._attrs, + self._has_pre_init, + self._pre_init_has_args, + self._has_post_init, + self._frozen, + self._slots, + self._cache_hash, + self._base_attr_map, + self._is_exc, + self._on_setattr, + attrs_init=True, + ) + ) + + return self + + def add_eq(self): + cd = self._cls_dict + + cd["__eq__"] = self._add_method_dunders( + _make_eq(self._cls, self._attrs) + ) + cd["__ne__"] = self._add_method_dunders(_make_ne()) + + return self + + def add_order(self): + cd = self._cls_dict + + cd["__lt__"], cd["__le__"], cd["__gt__"], cd["__ge__"] = ( + self._add_method_dunders(meth) + for meth in _make_order(self._cls, self._attrs) + ) + + return self + + def add_setattr(self): + if self._frozen: + return self + + sa_attrs = {} + for a in self._attrs: + on_setattr = a.on_setattr or self._on_setattr + if on_setattr and on_setattr is not setters.NO_OP: + sa_attrs[a.name] = a, on_setattr + + if not sa_attrs: + return self + + if self._has_custom_setattr: + # We need to write a __setattr__ but there already is one! + msg = "Can't combine custom __setattr__ with on_setattr hooks." + raise ValueError(msg) + + # docstring comes from _add_method_dunders + def __setattr__(self, name, val): + try: + a, hook = sa_attrs[name] + except KeyError: + nval = val + else: + nval = hook(self, a, val) + + _OBJ_SETATTR(self, name, nval) + + self._cls_dict["__attrs_own_setattr__"] = True + self._cls_dict["__setattr__"] = self._add_method_dunders(__setattr__) + self._wrote_own_setattr = True + + return self + + def _add_method_dunders(self, method): + """ + Add __module__ and __qualname__ to a *method* if possible. + """ + with contextlib.suppress(AttributeError): + method.__module__ = self._cls.__module__ + + with contextlib.suppress(AttributeError): + method.__qualname__ = f"{self._cls.__qualname__}.{method.__name__}" + + with contextlib.suppress(AttributeError): + method.__doc__ = ( + "Method generated by attrs for class " + f"{self._cls.__qualname__}." + ) + + return method + + +def _determine_attrs_eq_order(cmp, eq, order, default_eq): + """ + Validate the combination of *cmp*, *eq*, and *order*. Derive the effective + values of eq and order. If *eq* is None, set it to *default_eq*. + """ + if cmp is not None and any((eq is not None, order is not None)): + msg = "Don't mix `cmp` with `eq' and `order`." + raise ValueError(msg) + + # cmp takes precedence due to bw-compatibility. + if cmp is not None: + return cmp, cmp + + # If left None, equality is set to the specified default and ordering + # mirrors equality. + if eq is None: + eq = default_eq + + if order is None: + order = eq + + if eq is False and order is True: + msg = "`order` can only be True if `eq` is True too." + raise ValueError(msg) + + return eq, order + + +def _determine_attrib_eq_order(cmp, eq, order, default_eq): + """ + Validate the combination of *cmp*, *eq*, and *order*. Derive the effective + values of eq and order. If *eq* is None, set it to *default_eq*. + """ + if cmp is not None and any((eq is not None, order is not None)): + msg = "Don't mix `cmp` with `eq' and `order`." + raise ValueError(msg) + + def decide_callable_or_boolean(value): + """ + Decide whether a key function is used. + """ + if callable(value): + value, key = True, value + else: + key = None + return value, key + + # cmp takes precedence due to bw-compatibility. + if cmp is not None: + cmp, cmp_key = decide_callable_or_boolean(cmp) + return cmp, cmp_key, cmp, cmp_key + + # If left None, equality is set to the specified default and ordering + # mirrors equality. + if eq is None: + eq, eq_key = default_eq, None + else: + eq, eq_key = decide_callable_or_boolean(eq) + + if order is None: + order, order_key = eq, eq_key + else: + order, order_key = decide_callable_or_boolean(order) + + if eq is False and order is True: + msg = "`order` can only be True if `eq` is True too." + raise ValueError(msg) + + return eq, eq_key, order, order_key + + +def _determine_whether_to_implement( + cls, flag, auto_detect, dunders, default=True +): + """ + Check whether we should implement a set of methods for *cls*. + + *flag* is the argument passed into @attr.s like 'init', *auto_detect* the + same as passed into @attr.s and *dunders* is a tuple of attribute names + whose presence signal that the user has implemented it themselves. + + Return *default* if no reason for either for or against is found. + """ + if flag is True or flag is False: + return flag + + if flag is None and auto_detect is False: + return default + + # Logically, flag is None and auto_detect is True here. + for dunder in dunders: + if _has_own_attribute(cls, dunder): + return False + + return default + + +def attrs( + maybe_cls=None, + these=None, + repr_ns=None, + repr=None, + cmp=None, + hash=None, + init=None, + slots=False, + frozen=False, + weakref_slot=True, + str=False, + auto_attribs=False, + kw_only=False, + cache_hash=False, + auto_exc=False, + eq=None, + order=None, + auto_detect=False, + collect_by_mro=False, + getstate_setstate=None, + on_setattr=None, + field_transformer=None, + match_args=True, + unsafe_hash=None, +): + r""" + A class decorator that adds :term:`dunder methods` according to the + specified attributes using `attr.ib` or the *these* argument. + + Consider using `attrs.define` / `attrs.frozen` in new code (``attr.s`` will + *never* go away, though). + + Args: + repr_ns (str): + When using nested classes, there was no way in Python 2 to + automatically detect that. This argument allows to set a custom + name for a more meaningful ``repr`` output. This argument is + pointless in Python 3 and is therefore deprecated. + + .. caution:: + Refer to `attrs.define` for the rest of the parameters, but note that they + can have different defaults. + + Notably, leaving *on_setattr* as `None` will **not** add any hooks. + + .. versionadded:: 16.0.0 *slots* + .. versionadded:: 16.1.0 *frozen* + .. versionadded:: 16.3.0 *str* + .. versionadded:: 16.3.0 Support for ``__attrs_post_init__``. + .. versionchanged:: 17.1.0 + *hash* supports `None` as value which is also the default now. + .. versionadded:: 17.3.0 *auto_attribs* + .. versionchanged:: 18.1.0 + If *these* is passed, no attributes are deleted from the class body. + .. versionchanged:: 18.1.0 If *these* is ordered, the order is retained. + .. versionadded:: 18.2.0 *weakref_slot* + .. deprecated:: 18.2.0 + ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` now raise a + `DeprecationWarning` if the classes compared are subclasses of + each other. ``__eq`` and ``__ne__`` never tried to compared subclasses + to each other. + .. versionchanged:: 19.2.0 + ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` now do not consider + subclasses comparable anymore. + .. versionadded:: 18.2.0 *kw_only* + .. versionadded:: 18.2.0 *cache_hash* + .. versionadded:: 19.1.0 *auto_exc* + .. deprecated:: 19.2.0 *cmp* Removal on or after 2021-06-01. + .. versionadded:: 19.2.0 *eq* and *order* + .. versionadded:: 20.1.0 *auto_detect* + .. versionadded:: 20.1.0 *collect_by_mro* + .. versionadded:: 20.1.0 *getstate_setstate* + .. versionadded:: 20.1.0 *on_setattr* + .. versionadded:: 20.3.0 *field_transformer* + .. versionchanged:: 21.1.0 + ``init=False`` injects ``__attrs_init__`` + .. versionchanged:: 21.1.0 Support for ``__attrs_pre_init__`` + .. versionchanged:: 21.1.0 *cmp* undeprecated + .. versionadded:: 21.3.0 *match_args* + .. versionadded:: 22.2.0 + *unsafe_hash* as an alias for *hash* (for :pep:`681` compliance). + .. deprecated:: 24.1.0 *repr_ns* + .. versionchanged:: 24.1.0 + Instances are not compared as tuples of attributes anymore, but using a + big ``and`` condition. This is faster and has more correct behavior for + uncomparable values like `math.nan`. + .. versionadded:: 24.1.0 + If a class has an *inherited* classmethod called + ``__attrs_init_subclass__``, it is executed after the class is created. + .. deprecated:: 24.1.0 *hash* is deprecated in favor of *unsafe_hash*. + """ + if repr_ns is not None: + import warnings + + warnings.warn( + DeprecationWarning( + "The `repr_ns` argument is deprecated and will be removed in or after August 2025." + ), + stacklevel=2, + ) + + eq_, order_ = _determine_attrs_eq_order(cmp, eq, order, None) + + # unsafe_hash takes precedence due to PEP 681. + if unsafe_hash is not None: + hash = unsafe_hash + + if isinstance(on_setattr, (list, tuple)): + on_setattr = setters.pipe(*on_setattr) + + def wrap(cls): + is_frozen = frozen or _has_frozen_base_class(cls) + is_exc = auto_exc is True and issubclass(cls, BaseException) + has_own_setattr = auto_detect and _has_own_attribute( + cls, "__setattr__" + ) + + if has_own_setattr and is_frozen: + msg = "Can't freeze a class with a custom __setattr__." + raise ValueError(msg) + + builder = _ClassBuilder( + cls, + these, + slots, + is_frozen, + weakref_slot, + _determine_whether_to_implement( + cls, + getstate_setstate, + auto_detect, + ("__getstate__", "__setstate__"), + default=slots, + ), + auto_attribs, + kw_only, + cache_hash, + is_exc, + collect_by_mro, + on_setattr, + has_own_setattr, + field_transformer, + ) + if _determine_whether_to_implement( + cls, repr, auto_detect, ("__repr__",) + ): + builder.add_repr(repr_ns) + if str is True: + builder.add_str() + + eq = _determine_whether_to_implement( + cls, eq_, auto_detect, ("__eq__", "__ne__") + ) + if not is_exc and eq is True: + builder.add_eq() + if not is_exc and _determine_whether_to_implement( + cls, order_, auto_detect, ("__lt__", "__le__", "__gt__", "__ge__") + ): + builder.add_order() + + builder.add_setattr() + + nonlocal hash + if ( + hash is None + and auto_detect is True + and _has_own_attribute(cls, "__hash__") + ): + hash = False + + if hash is not True and hash is not False and hash is not None: + # Can't use `hash in` because 1 == True for example. + msg = "Invalid value for hash. Must be True, False, or None." + raise TypeError(msg) + + if hash is False or (hash is None and eq is False) or is_exc: + # Don't do anything. Should fall back to __object__'s __hash__ + # which is by id. + if cache_hash: + msg = "Invalid value for cache_hash. To use hash caching, hashing must be either explicitly or implicitly enabled." + raise TypeError(msg) + elif hash is True or ( + hash is None and eq is True and is_frozen is True + ): + # Build a __hash__ if told so, or if it's safe. + builder.add_hash() + else: + # Raise TypeError on attempts to hash. + if cache_hash: + msg = "Invalid value for cache_hash. To use hash caching, hashing must be either explicitly or implicitly enabled." + raise TypeError(msg) + builder.make_unhashable() + + if _determine_whether_to_implement( + cls, init, auto_detect, ("__init__",) + ): + builder.add_init() + else: + builder.add_attrs_init() + if cache_hash: + msg = "Invalid value for cache_hash. To use hash caching, init must be True." + raise TypeError(msg) + + if ( + PY_3_10_PLUS + and match_args + and not _has_own_attribute(cls, "__match_args__") + ): + builder.add_match_args() + + return builder.build_class() + + # maybe_cls's type depends on the usage of the decorator. It's a class + # if it's used as `@attrs` but `None` if used as `@attrs()`. + if maybe_cls is None: + return wrap + + return wrap(maybe_cls) + + +_attrs = attrs +""" +Internal alias so we can use it in functions that take an argument called +*attrs*. +""" + + +def _has_frozen_base_class(cls): + """ + Check whether *cls* has a frozen ancestor by looking at its + __setattr__. + """ + return cls.__setattr__ is _frozen_setattrs + + +def _generate_unique_filename(cls, func_name): + """ + Create a "filename" suitable for a function being generated. + """ + return ( + f"" + ) + + +def _make_hash(cls, attrs, frozen, cache_hash): + attrs = tuple( + a for a in attrs if a.hash is True or (a.hash is None and a.eq is True) + ) + + tab = " " + + unique_filename = _generate_unique_filename(cls, "hash") + type_hash = hash(unique_filename) + # If eq is custom generated, we need to include the functions in globs + globs = {} + + hash_def = "def __hash__(self" + hash_func = "hash((" + closing_braces = "))" + if not cache_hash: + hash_def += "):" + else: + hash_def += ", *" + + hash_def += ", _cache_wrapper=__import__('attr._make')._make._CacheHashWrapper):" + hash_func = "_cache_wrapper(" + hash_func + closing_braces += ")" + + method_lines = [hash_def] + + def append_hash_computation_lines(prefix, indent): + """ + Generate the code for actually computing the hash code. + Below this will either be returned directly or used to compute + a value which is then cached, depending on the value of cache_hash + """ + + method_lines.extend( + [ + indent + prefix + hash_func, + indent + f" {type_hash},", + ] + ) + + for a in attrs: + if a.eq_key: + cmp_name = f"_{a.name}_key" + globs[cmp_name] = a.eq_key + method_lines.append( + indent + f" {cmp_name}(self.{a.name})," + ) + else: + method_lines.append(indent + f" self.{a.name},") + + method_lines.append(indent + " " + closing_braces) + + if cache_hash: + method_lines.append(tab + f"if self.{_HASH_CACHE_FIELD} is None:") + if frozen: + append_hash_computation_lines( + f"object.__setattr__(self, '{_HASH_CACHE_FIELD}', ", tab * 2 + ) + method_lines.append(tab * 2 + ")") # close __setattr__ + else: + append_hash_computation_lines( + f"self.{_HASH_CACHE_FIELD} = ", tab * 2 + ) + method_lines.append(tab + f"return self.{_HASH_CACHE_FIELD}") + else: + append_hash_computation_lines("return ", tab) + + script = "\n".join(method_lines) + return _make_method("__hash__", script, unique_filename, globs) + + +def _add_hash(cls, attrs): + """ + Add a hash method to *cls*. + """ + cls.__hash__ = _make_hash(cls, attrs, frozen=False, cache_hash=False) + return cls + + +def _make_ne(): + """ + Create __ne__ method. + """ + + def __ne__(self, other): + """ + Check equality and either forward a NotImplemented or + return the result negated. + """ + result = self.__eq__(other) + if result is NotImplemented: + return NotImplemented + + return not result + + return __ne__ + + +def _make_eq(cls, attrs): + """ + Create __eq__ method for *cls* with *attrs*. + """ + attrs = [a for a in attrs if a.eq] + + unique_filename = _generate_unique_filename(cls, "eq") + lines = [ + "def __eq__(self, other):", + " if other.__class__ is not self.__class__:", + " return NotImplemented", + ] + + # We can't just do a big self.x = other.x and... clause due to + # irregularities like nan == nan is false but (nan,) == (nan,) is true. + globs = {} + if attrs: + lines.append(" return (") + for a in attrs: + if a.eq_key: + cmp_name = f"_{a.name}_key" + # Add the key function to the global namespace + # of the evaluated function. + globs[cmp_name] = a.eq_key + lines.append( + f" {cmp_name}(self.{a.name}) == {cmp_name}(other.{a.name})" + ) + else: + lines.append(f" self.{a.name} == other.{a.name}") + if a is not attrs[-1]: + lines[-1] = f"{lines[-1]} and" + lines.append(" )") + else: + lines.append(" return True") + + script = "\n".join(lines) + + return _make_method("__eq__", script, unique_filename, globs) + + +def _make_order(cls, attrs): + """ + Create ordering methods for *cls* with *attrs*. + """ + attrs = [a for a in attrs if a.order] + + def attrs_to_tuple(obj): + """ + Save us some typing. + """ + return tuple( + key(value) if key else value + for value, key in ( + (getattr(obj, a.name), a.order_key) for a in attrs + ) + ) + + def __lt__(self, other): + """ + Automatically created by attrs. + """ + if other.__class__ is self.__class__: + return attrs_to_tuple(self) < attrs_to_tuple(other) + + return NotImplemented + + def __le__(self, other): + """ + Automatically created by attrs. + """ + if other.__class__ is self.__class__: + return attrs_to_tuple(self) <= attrs_to_tuple(other) + + return NotImplemented + + def __gt__(self, other): + """ + Automatically created by attrs. + """ + if other.__class__ is self.__class__: + return attrs_to_tuple(self) > attrs_to_tuple(other) + + return NotImplemented + + def __ge__(self, other): + """ + Automatically created by attrs. + """ + if other.__class__ is self.__class__: + return attrs_to_tuple(self) >= attrs_to_tuple(other) + + return NotImplemented + + return __lt__, __le__, __gt__, __ge__ + + +def _add_eq(cls, attrs=None): + """ + Add equality methods to *cls* with *attrs*. + """ + if attrs is None: + attrs = cls.__attrs_attrs__ + + cls.__eq__ = _make_eq(cls, attrs) + cls.__ne__ = _make_ne() + + return cls + + +def _make_repr(attrs, ns, cls): + unique_filename = _generate_unique_filename(cls, "repr") + # Figure out which attributes to include, and which function to use to + # format them. The a.repr value can be either bool or a custom + # callable. + attr_names_with_reprs = tuple( + (a.name, (repr if a.repr is True else a.repr), a.init) + for a in attrs + if a.repr is not False + ) + globs = { + name + "_repr": r for name, r, _ in attr_names_with_reprs if r != repr + } + globs["_compat"] = _compat + globs["AttributeError"] = AttributeError + globs["NOTHING"] = NOTHING + attribute_fragments = [] + for name, r, i in attr_names_with_reprs: + accessor = ( + "self." + name if i else 'getattr(self, "' + name + '", NOTHING)' + ) + fragment = ( + "%s={%s!r}" % (name, accessor) + if r == repr + else "%s={%s_repr(%s)}" % (name, name, accessor) + ) + attribute_fragments.append(fragment) + repr_fragment = ", ".join(attribute_fragments) + + if ns is None: + cls_name_fragment = '{self.__class__.__qualname__.rsplit(">.", 1)[-1]}' + else: + cls_name_fragment = ns + ".{self.__class__.__name__}" + + lines = [ + "def __repr__(self):", + " try:", + " already_repring = _compat.repr_context.already_repring", + " except AttributeError:", + " already_repring = {id(self),}", + " _compat.repr_context.already_repring = already_repring", + " else:", + " if id(self) in already_repring:", + " return '...'", + " else:", + " already_repring.add(id(self))", + " try:", + f" return f'{cls_name_fragment}({repr_fragment})'", + " finally:", + " already_repring.remove(id(self))", + ] + + return _make_method( + "__repr__", "\n".join(lines), unique_filename, globs=globs + ) + + +def _add_repr(cls, ns=None, attrs=None): + """ + Add a repr method to *cls*. + """ + if attrs is None: + attrs = cls.__attrs_attrs__ + + cls.__repr__ = _make_repr(attrs, ns, cls) + return cls + + +def fields(cls): + """ + Return the tuple of *attrs* attributes for a class. + + The tuple also allows accessing the fields by their names (see below for + examples). + + Args: + cls (type): Class to introspect. + + Raises: + TypeError: If *cls* is not a class. + + attrs.exceptions.NotAnAttrsClassError: + If *cls* is not an *attrs* class. + + Returns: + tuple (with name accessors) of `attrs.Attribute` + + .. versionchanged:: 16.2.0 Returned tuple allows accessing the fields + by name. + .. versionchanged:: 23.1.0 Add support for generic classes. + """ + generic_base = get_generic_base(cls) + + if generic_base is None and not isinstance(cls, type): + msg = "Passed object must be a class." + raise TypeError(msg) + + attrs = getattr(cls, "__attrs_attrs__", None) + + if attrs is None: + if generic_base is not None: + attrs = getattr(generic_base, "__attrs_attrs__", None) + if attrs is not None: + # Even though this is global state, stick it on here to speed + # it up. We rely on `cls` being cached for this to be + # efficient. + cls.__attrs_attrs__ = attrs + return attrs + msg = f"{cls!r} is not an attrs-decorated class." + raise NotAnAttrsClassError(msg) + + return attrs + + +def fields_dict(cls): + """ + Return an ordered dictionary of *attrs* attributes for a class, whose keys + are the attribute names. + + Args: + cls (type): Class to introspect. + + Raises: + TypeError: If *cls* is not a class. + + attrs.exceptions.NotAnAttrsClassError: + If *cls* is not an *attrs* class. + + Returns: + dict[str, attrs.Attribute]: Dict of attribute name to definition + + .. versionadded:: 18.1.0 + """ + if not isinstance(cls, type): + msg = "Passed object must be a class." + raise TypeError(msg) + attrs = getattr(cls, "__attrs_attrs__", None) + if attrs is None: + msg = f"{cls!r} is not an attrs-decorated class." + raise NotAnAttrsClassError(msg) + return {a.name: a for a in attrs} + + +def validate(inst): + """ + Validate all attributes on *inst* that have a validator. + + Leaves all exceptions through. + + Args: + inst: Instance of a class with *attrs* attributes. + """ + if _config._run_validators is False: + return + + for a in fields(inst.__class__): + v = a.validator + if v is not None: + v(inst, a, getattr(inst, a.name)) + + +def _is_slot_attr(a_name, base_attr_map): + """ + Check if the attribute name comes from a slot class. + """ + cls = base_attr_map.get(a_name) + return cls and "__slots__" in cls.__dict__ + + +def _make_init( + cls, + attrs, + pre_init, + pre_init_has_args, + post_init, + frozen, + slots, + cache_hash, + base_attr_map, + is_exc, + cls_on_setattr, + attrs_init, +): + has_cls_on_setattr = ( + cls_on_setattr is not None and cls_on_setattr is not setters.NO_OP + ) + + if frozen and has_cls_on_setattr: + msg = "Frozen classes can't use on_setattr." + raise ValueError(msg) + + needs_cached_setattr = cache_hash or frozen + filtered_attrs = [] + attr_dict = {} + for a in attrs: + if not a.init and a.default is NOTHING: + continue + + filtered_attrs.append(a) + attr_dict[a.name] = a + + if a.on_setattr is not None: + if frozen is True: + msg = "Frozen classes can't use on_setattr." + raise ValueError(msg) + + needs_cached_setattr = True + elif has_cls_on_setattr and a.on_setattr is not setters.NO_OP: + needs_cached_setattr = True + + unique_filename = _generate_unique_filename(cls, "init") + + script, globs, annotations = _attrs_to_init_script( + filtered_attrs, + frozen, + slots, + pre_init, + pre_init_has_args, + post_init, + cache_hash, + base_attr_map, + is_exc, + needs_cached_setattr, + has_cls_on_setattr, + "__attrs_init__" if attrs_init else "__init__", + ) + if cls.__module__ in sys.modules: + # This makes typing.get_type_hints(CLS.__init__) resolve string types. + globs.update(sys.modules[cls.__module__].__dict__) + + globs.update({"NOTHING": NOTHING, "attr_dict": attr_dict}) + + if needs_cached_setattr: + # Save the lookup overhead in __init__ if we need to circumvent + # setattr hooks. + globs["_cached_setattr_get"] = _OBJ_SETATTR.__get__ + + init = _make_method( + "__attrs_init__" if attrs_init else "__init__", + script, + unique_filename, + globs, + ) + init.__annotations__ = annotations + + return init + + +def _setattr(attr_name: str, value_var: str, has_on_setattr: bool) -> str: + """ + Use the cached object.setattr to set *attr_name* to *value_var*. + """ + return f"_setattr('{attr_name}', {value_var})" + + +def _setattr_with_converter( + attr_name: str, value_var: str, has_on_setattr: bool, converter: Converter +) -> str: + """ + Use the cached object.setattr to set *attr_name* to *value_var*, but run + its converter first. + """ + return f"_setattr('{attr_name}', {converter._fmt_converter_call(attr_name, value_var)})" + + +def _assign(attr_name: str, value: str, has_on_setattr: bool) -> str: + """ + Unless *attr_name* has an on_setattr hook, use normal assignment. Otherwise + relegate to _setattr. + """ + if has_on_setattr: + return _setattr(attr_name, value, True) + + return f"self.{attr_name} = {value}" + + +def _assign_with_converter( + attr_name: str, value_var: str, has_on_setattr: bool, converter: Converter +) -> str: + """ + Unless *attr_name* has an on_setattr hook, use normal assignment after + conversion. Otherwise relegate to _setattr_with_converter. + """ + if has_on_setattr: + return _setattr_with_converter(attr_name, value_var, True, converter) + + return f"self.{attr_name} = {converter._fmt_converter_call(attr_name, value_var)}" + + +def _determine_setters( + frozen: bool, slots: bool, base_attr_map: dict[str, type] +): + """ + Determine the correct setter functions based on whether a class is frozen + and/or slotted. + """ + if frozen is True: + if slots is True: + return (), _setattr, _setattr_with_converter + + # Dict frozen classes assign directly to __dict__. + # But only if the attribute doesn't come from an ancestor slot + # class. + # Note _inst_dict will be used again below if cache_hash is True + + def fmt_setter( + attr_name: str, value_var: str, has_on_setattr: bool + ) -> str: + if _is_slot_attr(attr_name, base_attr_map): + return _setattr(attr_name, value_var, has_on_setattr) + + return f"_inst_dict['{attr_name}'] = {value_var}" + + def fmt_setter_with_converter( + attr_name: str, + value_var: str, + has_on_setattr: bool, + converter: Converter, + ) -> str: + if has_on_setattr or _is_slot_attr(attr_name, base_attr_map): + return _setattr_with_converter( + attr_name, value_var, has_on_setattr, converter + ) + + return f"_inst_dict['{attr_name}'] = {converter._fmt_converter_call(attr_name, value_var)}" + + return ( + ("_inst_dict = self.__dict__",), + fmt_setter, + fmt_setter_with_converter, + ) + + # Not frozen -- we can just assign directly. + return (), _assign, _assign_with_converter + + +def _attrs_to_init_script( + attrs: list[Attribute], + is_frozen: bool, + is_slotted: bool, + call_pre_init: bool, + pre_init_has_args: bool, + call_post_init: bool, + does_cache_hash: bool, + base_attr_map: dict[str, type], + is_exc: bool, + needs_cached_setattr: bool, + has_cls_on_setattr: bool, + method_name: str, +) -> tuple[str, dict, dict]: + """ + Return a script of an initializer for *attrs*, a dict of globals, and + annotations for the initializer. + + The globals are required by the generated script. + """ + lines = ["self.__attrs_pre_init__()"] if call_pre_init else [] + + if needs_cached_setattr: + lines.append( + # Circumvent the __setattr__ descriptor to save one lookup per + # assignment. Note _setattr will be used again below if + # does_cache_hash is True. + "_setattr = _cached_setattr_get(self)" + ) + + extra_lines, fmt_setter, fmt_setter_with_converter = _determine_setters( + is_frozen, is_slotted, base_attr_map + ) + lines.extend(extra_lines) + + args = [] + kw_only_args = [] + attrs_to_validate = [] + + # This is a dictionary of names to validator and converter callables. + # Injecting this into __init__ globals lets us avoid lookups. + names_for_globals = {} + annotations = {"return": None} + + for a in attrs: + if a.validator: + attrs_to_validate.append(a) + + attr_name = a.name + has_on_setattr = a.on_setattr is not None or ( + a.on_setattr is not setters.NO_OP and has_cls_on_setattr + ) + # a.alias is set to maybe-mangled attr_name in _ClassBuilder if not + # explicitly provided + arg_name = a.alias + + has_factory = isinstance(a.default, Factory) + maybe_self = "self" if has_factory and a.default.takes_self else "" + + if a.converter and not isinstance(a.converter, Converter): + converter = Converter(a.converter) + else: + converter = a.converter + + if a.init is False: + if has_factory: + init_factory_name = _INIT_FACTORY_PAT % (a.name,) + if converter is not None: + lines.append( + fmt_setter_with_converter( + attr_name, + init_factory_name + f"({maybe_self})", + has_on_setattr, + converter, + ) + ) + names_for_globals[converter._get_global_name(a.name)] = ( + converter.converter + ) + else: + lines.append( + fmt_setter( + attr_name, + init_factory_name + f"({maybe_self})", + has_on_setattr, + ) + ) + names_for_globals[init_factory_name] = a.default.factory + elif converter is not None: + lines.append( + fmt_setter_with_converter( + attr_name, + f"attr_dict['{attr_name}'].default", + has_on_setattr, + converter, + ) + ) + names_for_globals[converter._get_global_name(a.name)] = ( + converter.converter + ) + else: + lines.append( + fmt_setter( + attr_name, + f"attr_dict['{attr_name}'].default", + has_on_setattr, + ) + ) + elif a.default is not NOTHING and not has_factory: + arg = f"{arg_name}=attr_dict['{attr_name}'].default" + if a.kw_only: + kw_only_args.append(arg) + else: + args.append(arg) + + if converter is not None: + lines.append( + fmt_setter_with_converter( + attr_name, arg_name, has_on_setattr, converter + ) + ) + names_for_globals[converter._get_global_name(a.name)] = ( + converter.converter + ) + else: + lines.append(fmt_setter(attr_name, arg_name, has_on_setattr)) + + elif has_factory: + arg = f"{arg_name}=NOTHING" + if a.kw_only: + kw_only_args.append(arg) + else: + args.append(arg) + lines.append(f"if {arg_name} is not NOTHING:") + + init_factory_name = _INIT_FACTORY_PAT % (a.name,) + if converter is not None: + lines.append( + " " + + fmt_setter_with_converter( + attr_name, arg_name, has_on_setattr, converter + ) + ) + lines.append("else:") + lines.append( + " " + + fmt_setter_with_converter( + attr_name, + init_factory_name + "(" + maybe_self + ")", + has_on_setattr, + converter, + ) + ) + names_for_globals[converter._get_global_name(a.name)] = ( + converter.converter + ) + else: + lines.append( + " " + fmt_setter(attr_name, arg_name, has_on_setattr) + ) + lines.append("else:") + lines.append( + " " + + fmt_setter( + attr_name, + init_factory_name + "(" + maybe_self + ")", + has_on_setattr, + ) + ) + names_for_globals[init_factory_name] = a.default.factory + else: + if a.kw_only: + kw_only_args.append(arg_name) + else: + args.append(arg_name) + + if converter is not None: + lines.append( + fmt_setter_with_converter( + attr_name, arg_name, has_on_setattr, converter + ) + ) + names_for_globals[converter._get_global_name(a.name)] = ( + converter.converter + ) + else: + lines.append(fmt_setter(attr_name, arg_name, has_on_setattr)) + + if a.init is True: + if a.type is not None and converter is None: + annotations[arg_name] = a.type + elif converter is not None and converter._first_param_type: + # Use the type from the converter if present. + annotations[arg_name] = converter._first_param_type + + if attrs_to_validate: # we can skip this if there are no validators. + names_for_globals["_config"] = _config + lines.append("if _config._run_validators is True:") + for a in attrs_to_validate: + val_name = "__attr_validator_" + a.name + attr_name = "__attr_" + a.name + lines.append(f" {val_name}(self, {attr_name}, self.{a.name})") + names_for_globals[val_name] = a.validator + names_for_globals[attr_name] = a + + if call_post_init: + lines.append("self.__attrs_post_init__()") + + # Because this is set only after __attrs_post_init__ is called, a crash + # will result if post-init tries to access the hash code. This seemed + # preferable to setting this beforehand, in which case alteration to field + # values during post-init combined with post-init accessing the hash code + # would result in silent bugs. + if does_cache_hash: + if is_frozen: + if is_slotted: + init_hash_cache = f"_setattr('{_HASH_CACHE_FIELD}', None)" + else: + init_hash_cache = f"_inst_dict['{_HASH_CACHE_FIELD}'] = None" + else: + init_hash_cache = f"self.{_HASH_CACHE_FIELD} = None" + lines.append(init_hash_cache) + + # For exceptions we rely on BaseException.__init__ for proper + # initialization. + if is_exc: + vals = ",".join(f"self.{a.name}" for a in attrs if a.init) + + lines.append(f"BaseException.__init__(self, {vals})") + + args = ", ".join(args) + pre_init_args = args + if kw_only_args: + # leading comma & kw_only args + args += f"{', ' if args else ''}*, {', '.join(kw_only_args)}" + pre_init_kw_only_args = ", ".join( + [ + f"{kw_arg_name}={kw_arg_name}" + # We need to remove the defaults from the kw_only_args. + for kw_arg_name in (kwa.split("=")[0] for kwa in kw_only_args) + ] + ) + pre_init_args += ", " if pre_init_args else "" + pre_init_args += pre_init_kw_only_args + + if call_pre_init and pre_init_has_args: + # If pre init method has arguments, pass same arguments as `__init__`. + lines[0] = f"self.__attrs_pre_init__({pre_init_args})" + + # Python 3.7 doesn't allow backslashes in f strings. + NL = "\n " + return ( + f"""def {method_name}(self, {args}): + {NL.join(lines) if lines else 'pass'} +""", + names_for_globals, + annotations, + ) + + +def _default_init_alias_for(name: str) -> str: + """ + The default __init__ parameter name for a field. + + This performs private-name adjustment via leading-unscore stripping, + and is the default value of Attribute.alias if not provided. + """ + + return name.lstrip("_") + + +class Attribute: + """ + *Read-only* representation of an attribute. + + .. warning:: + + You should never instantiate this class yourself. + + The class has *all* arguments of `attr.ib` (except for ``factory`` which is + only syntactic sugar for ``default=Factory(...)`` plus the following: + + - ``name`` (`str`): The name of the attribute. + - ``alias`` (`str`): The __init__ parameter name of the attribute, after + any explicit overrides and default private-attribute-name handling. + - ``inherited`` (`bool`): Whether or not that attribute has been inherited + from a base class. + - ``eq_key`` and ``order_key`` (`typing.Callable` or `None`): The + callables that are used for comparing and ordering objects by this + attribute, respectively. These are set by passing a callable to + `attr.ib`'s ``eq``, ``order``, or ``cmp`` arguments. See also + :ref:`comparison customization `. + + Instances of this class are frequently used for introspection purposes + like: + + - `fields` returns a tuple of them. + - Validators get them passed as the first argument. + - The :ref:`field transformer ` hook receives a list of + them. + - The ``alias`` property exposes the __init__ parameter name of the field, + with any overrides and default private-attribute handling applied. + + + .. versionadded:: 20.1.0 *inherited* + .. versionadded:: 20.1.0 *on_setattr* + .. versionchanged:: 20.2.0 *inherited* is not taken into account for + equality checks and hashing anymore. + .. versionadded:: 21.1.0 *eq_key* and *order_key* + .. versionadded:: 22.2.0 *alias* + + For the full version history of the fields, see `attr.ib`. + """ + + __slots__ = ( + "name", + "default", + "validator", + "repr", + "eq", + "eq_key", + "order", + "order_key", + "hash", + "init", + "metadata", + "type", + "converter", + "kw_only", + "inherited", + "on_setattr", + "alias", + ) + + def __init__( + self, + name, + default, + validator, + repr, + cmp, # XXX: unused, remove along with other cmp code. + hash, + init, + inherited, + metadata=None, + type=None, + converter=None, + kw_only=False, + eq=None, + eq_key=None, + order=None, + order_key=None, + on_setattr=None, + alias=None, + ): + eq, eq_key, order, order_key = _determine_attrib_eq_order( + cmp, eq_key or eq, order_key or order, True + ) + + # Cache this descriptor here to speed things up later. + bound_setattr = _OBJ_SETATTR.__get__(self) + + # Despite the big red warning, people *do* instantiate `Attribute` + # themselves. + bound_setattr("name", name) + bound_setattr("default", default) + bound_setattr("validator", validator) + bound_setattr("repr", repr) + bound_setattr("eq", eq) + bound_setattr("eq_key", eq_key) + bound_setattr("order", order) + bound_setattr("order_key", order_key) + bound_setattr("hash", hash) + bound_setattr("init", init) + bound_setattr("converter", converter) + bound_setattr( + "metadata", + ( + types.MappingProxyType(dict(metadata)) # Shallow copy + if metadata + else _EMPTY_METADATA_SINGLETON + ), + ) + bound_setattr("type", type) + bound_setattr("kw_only", kw_only) + bound_setattr("inherited", inherited) + bound_setattr("on_setattr", on_setattr) + bound_setattr("alias", alias) + + def __setattr__(self, name, value): + raise FrozenInstanceError() + + @classmethod + def from_counting_attr(cls, name, ca, type=None): + # type holds the annotated value. deal with conflicts: + if type is None: + type = ca.type + elif ca.type is not None: + msg = "Type annotation and type argument cannot both be present" + raise ValueError(msg) + inst_dict = { + k: getattr(ca, k) + for k in Attribute.__slots__ + if k + not in ( + "name", + "validator", + "default", + "type", + "inherited", + ) # exclude methods and deprecated alias + } + return cls( + name=name, + validator=ca._validator, + default=ca._default, + type=type, + cmp=None, + inherited=False, + **inst_dict, + ) + + # Don't use attrs.evolve since fields(Attribute) doesn't work + def evolve(self, **changes): + """ + Copy *self* and apply *changes*. + + This works similarly to `attrs.evolve` but that function does not work + with {class}`Attribute`. + + It is mainly meant to be used for `transform-fields`. + + .. versionadded:: 20.3.0 + """ + new = copy.copy(self) + + new._setattrs(changes.items()) + + return new + + # Don't use _add_pickle since fields(Attribute) doesn't work + def __getstate__(self): + """ + Play nice with pickle. + """ + return tuple( + getattr(self, name) if name != "metadata" else dict(self.metadata) + for name in self.__slots__ + ) + + def __setstate__(self, state): + """ + Play nice with pickle. + """ + self._setattrs(zip(self.__slots__, state)) + + def _setattrs(self, name_values_pairs): + bound_setattr = _OBJ_SETATTR.__get__(self) + for name, value in name_values_pairs: + if name != "metadata": + bound_setattr(name, value) + else: + bound_setattr( + name, + ( + types.MappingProxyType(dict(value)) + if value + else _EMPTY_METADATA_SINGLETON + ), + ) + + +_a = [ + Attribute( + name=name, + default=NOTHING, + validator=None, + repr=True, + cmp=None, + eq=True, + order=False, + hash=(name != "metadata"), + init=True, + inherited=False, + alias=_default_init_alias_for(name), + ) + for name in Attribute.__slots__ +] + +Attribute = _add_hash( + _add_eq( + _add_repr(Attribute, attrs=_a), + attrs=[a for a in _a if a.name != "inherited"], + ), + attrs=[a for a in _a if a.hash and a.name != "inherited"], +) + + +class _CountingAttr: + """ + Intermediate representation of attributes that uses a counter to preserve + the order in which the attributes have been defined. + + *Internal* data structure of the attrs library. Running into is most + likely the result of a bug like a forgotten `@attr.s` decorator. + """ + + __slots__ = ( + "counter", + "_default", + "repr", + "eq", + "eq_key", + "order", + "order_key", + "hash", + "init", + "metadata", + "_validator", + "converter", + "type", + "kw_only", + "on_setattr", + "alias", + ) + __attrs_attrs__ = ( + *tuple( + Attribute( + name=name, + alias=_default_init_alias_for(name), + default=NOTHING, + validator=None, + repr=True, + cmp=None, + hash=True, + init=True, + kw_only=False, + eq=True, + eq_key=None, + order=False, + order_key=None, + inherited=False, + on_setattr=None, + ) + for name in ( + "counter", + "_default", + "repr", + "eq", + "order", + "hash", + "init", + "on_setattr", + "alias", + ) + ), + Attribute( + name="metadata", + alias="metadata", + default=None, + validator=None, + repr=True, + cmp=None, + hash=False, + init=True, + kw_only=False, + eq=True, + eq_key=None, + order=False, + order_key=None, + inherited=False, + on_setattr=None, + ), + ) + cls_counter = 0 + + def __init__( + self, + default, + validator, + repr, + cmp, + hash, + init, + converter, + metadata, + type, + kw_only, + eq, + eq_key, + order, + order_key, + on_setattr, + alias, + ): + _CountingAttr.cls_counter += 1 + self.counter = _CountingAttr.cls_counter + self._default = default + self._validator = validator + self.converter = converter + self.repr = repr + self.eq = eq + self.eq_key = eq_key + self.order = order + self.order_key = order_key + self.hash = hash + self.init = init + self.metadata = metadata + self.type = type + self.kw_only = kw_only + self.on_setattr = on_setattr + self.alias = alias + + def validator(self, meth): + """ + Decorator that adds *meth* to the list of validators. + + Returns *meth* unchanged. + + .. versionadded:: 17.1.0 + """ + if self._validator is None: + self._validator = meth + else: + self._validator = and_(self._validator, meth) + return meth + + def default(self, meth): + """ + Decorator that allows to set the default for an attribute. + + Returns *meth* unchanged. + + Raises: + DefaultAlreadySetError: If default has been set before. + + .. versionadded:: 17.1.0 + """ + if self._default is not NOTHING: + raise DefaultAlreadySetError() + + self._default = Factory(meth, takes_self=True) + + return meth + + +_CountingAttr = _add_eq(_add_repr(_CountingAttr)) + + +class Factory: + """ + Stores a factory callable. + + If passed as the default value to `attrs.field`, the factory is used to + generate a new value. + + Args: + factory (typing.Callable): + A callable that takes either none or exactly one mandatory + positional argument depending on *takes_self*. + + takes_self (bool): + Pass the partially initialized instance that is being initialized + as a positional argument. + + .. versionadded:: 17.1.0 *takes_self* + """ + + __slots__ = ("factory", "takes_self") + + def __init__(self, factory, takes_self=False): + self.factory = factory + self.takes_self = takes_self + + def __getstate__(self): + """ + Play nice with pickle. + """ + return tuple(getattr(self, name) for name in self.__slots__) + + def __setstate__(self, state): + """ + Play nice with pickle. + """ + for name, value in zip(self.__slots__, state): + setattr(self, name, value) + + +_f = [ + Attribute( + name=name, + default=NOTHING, + validator=None, + repr=True, + cmp=None, + eq=True, + order=False, + hash=True, + init=True, + inherited=False, + ) + for name in Factory.__slots__ +] + +Factory = _add_hash(_add_eq(_add_repr(Factory, attrs=_f), attrs=_f), attrs=_f) + + +class Converter: + """ + Stores a converter callable. + + Allows for the wrapped converter to take additional arguments. The + arguments are passed in the order they are documented. + + Args: + converter (Callable): A callable that converts the passed value. + + takes_self (bool): + Pass the partially initialized instance that is being initialized + as a positional argument. (default: `False`) + + takes_field (bool): + Pass the field definition (an :class:`Attribute`) into the + converter as a positional argument. (default: `False`) + + .. versionadded:: 24.1.0 + """ + + __slots__ = ( + "converter", + "takes_self", + "takes_field", + "_first_param_type", + "_global_name", + "__call__", + ) + + def __init__(self, converter, *, takes_self=False, takes_field=False): + self.converter = converter + self.takes_self = takes_self + self.takes_field = takes_field + + ex = _AnnotationExtractor(converter) + self._first_param_type = ex.get_first_param_type() + + if not (self.takes_self or self.takes_field): + self.__call__ = lambda value, _, __: self.converter(value) + elif self.takes_self and not self.takes_field: + self.__call__ = lambda value, instance, __: self.converter( + value, instance + ) + elif not self.takes_self and self.takes_field: + self.__call__ = lambda value, __, field: self.converter( + value, field + ) + else: + self.__call__ = lambda value, instance, field: self.converter( + value, instance, field + ) + + rt = ex.get_return_type() + if rt is not None: + self.__call__.__annotations__["return"] = rt + + @staticmethod + def _get_global_name(attr_name: str) -> str: + """ + Return the name that a converter for an attribute name *attr_name* + would have. + """ + return f"__attr_converter_{attr_name}" + + def _fmt_converter_call(self, attr_name: str, value_var: str) -> str: + """ + Return a string that calls the converter for an attribute name + *attr_name* and the value in variable named *value_var* according to + `self.takes_self` and `self.takes_field`. + """ + if not (self.takes_self or self.takes_field): + return f"{self._get_global_name(attr_name)}({value_var})" + + if self.takes_self and self.takes_field: + return f"{self._get_global_name(attr_name)}({value_var}, self, attr_dict['{attr_name}'])" + + if self.takes_self: + return f"{self._get_global_name(attr_name)}({value_var}, self)" + + return f"{self._get_global_name(attr_name)}({value_var}, attr_dict['{attr_name}'])" + + def __getstate__(self): + """ + Return a dict containing only converter and takes_self -- the rest gets + computed when loading. + """ + return { + "converter": self.converter, + "takes_self": self.takes_self, + "takes_field": self.takes_field, + } + + def __setstate__(self, state): + """ + Load instance from state. + """ + self.__init__(**state) + + +_f = [ + Attribute( + name=name, + default=NOTHING, + validator=None, + repr=True, + cmp=None, + eq=True, + order=False, + hash=True, + init=True, + inherited=False, + ) + for name in ("converter", "takes_self", "takes_field") +] + +Converter = _add_hash( + _add_eq(_add_repr(Converter, attrs=_f), attrs=_f), attrs=_f +) + + +def make_class( + name, attrs, bases=(object,), class_body=None, **attributes_arguments +): + r""" + A quick way to create a new class called *name* with *attrs*. + + Args: + name (str): The name for the new class. + + attrs( list | dict): + A list of names or a dictionary of mappings of names to `attr.ib`\ + s / `attrs.field`\ s. + + The order is deduced from the order of the names or attributes + inside *attrs*. Otherwise the order of the definition of the + attributes is used. + + bases (tuple[type, ...]): Classes that the new class will subclass. + + class_body (dict): + An optional dictionary of class attributes for the new class. + + attributes_arguments: Passed unmodified to `attr.s`. + + Returns: + type: A new class with *attrs*. + + .. versionadded:: 17.1.0 *bases* + .. versionchanged:: 18.1.0 If *attrs* is ordered, the order is retained. + .. versionchanged:: 23.2.0 *class_body* + """ + if isinstance(attrs, dict): + cls_dict = attrs + elif isinstance(attrs, (list, tuple)): + cls_dict = {a: attrib() for a in attrs} + else: + msg = "attrs argument must be a dict or a list." + raise TypeError(msg) + + pre_init = cls_dict.pop("__attrs_pre_init__", None) + post_init = cls_dict.pop("__attrs_post_init__", None) + user_init = cls_dict.pop("__init__", None) + + body = {} + if class_body is not None: + body.update(class_body) + if pre_init is not None: + body["__attrs_pre_init__"] = pre_init + if post_init is not None: + body["__attrs_post_init__"] = post_init + if user_init is not None: + body["__init__"] = user_init + + type_ = types.new_class(name, bases, {}, lambda ns: ns.update(body)) + + # For pickling to work, the __module__ variable needs to be set to the + # frame where the class is created. Bypass this step in environments where + # sys._getframe is not defined (Jython for example) or sys._getframe is not + # defined for arguments greater than 0 (IronPython). + with contextlib.suppress(AttributeError, ValueError): + type_.__module__ = sys._getframe(1).f_globals.get( + "__name__", "__main__" + ) + + # We do it here for proper warnings with meaningful stacklevel. + cmp = attributes_arguments.pop("cmp", None) + ( + attributes_arguments["eq"], + attributes_arguments["order"], + ) = _determine_attrs_eq_order( + cmp, + attributes_arguments.get("eq"), + attributes_arguments.get("order"), + True, + ) + + cls = _attrs(these=cls_dict, **attributes_arguments)(type_) + # Only add type annotations now or "_attrs()" will complain: + cls.__annotations__ = { + k: v.type for k, v in cls_dict.items() if v.type is not None + } + return cls + + +# These are required by within this module so we define them here and merely +# import into .validators / .converters. + + +@attrs(slots=True, unsafe_hash=True) +class _AndValidator: + """ + Compose many validators to a single one. + """ + + _validators = attrib() + + def __call__(self, inst, attr, value): + for v in self._validators: + v(inst, attr, value) + + +def and_(*validators): + """ + A validator that composes multiple validators into one. + + When called on a value, it runs all wrapped validators. + + Args: + validators (~collections.abc.Iterable[typing.Callable]): + Arbitrary number of validators. + + .. versionadded:: 17.1.0 + """ + vals = [] + for validator in validators: + vals.extend( + validator._validators + if isinstance(validator, _AndValidator) + else [validator] + ) + + return _AndValidator(tuple(vals)) + + +def pipe(*converters): + """ + A converter that composes multiple converters into one. + + When called on a value, it runs all wrapped converters, returning the + *last* value. + + Type annotations will be inferred from the wrapped converters', if they + have any. + + converters (~collections.abc.Iterable[typing.Callable]): + Arbitrary number of converters. + + .. versionadded:: 20.1.0 + """ + + def pipe_converter(val, inst, field): + for c in converters: + val = c(val, inst, field) if isinstance(c, Converter) else c(val) + + return val + + if not converters: + # If the converter list is empty, pipe_converter is the identity. + A = typing.TypeVar("A") + pipe_converter.__annotations__.update({"val": A, "return": A}) + else: + # Get parameter type from first converter. + t = _AnnotationExtractor(converters[0]).get_first_param_type() + if t: + pipe_converter.__annotations__["val"] = t + + last = converters[-1] + if not PY_3_11_PLUS and isinstance(last, Converter): + last = last.__call__ + + # Get return type from last converter. + rt = _AnnotationExtractor(last).get_return_type() + if rt: + pipe_converter.__annotations__["return"] = rt + + return Converter(pipe_converter, takes_self=True, takes_field=True) diff --git a/env/Lib/site-packages/attr/_next_gen.py b/env/Lib/site-packages/attr/_next_gen.py new file mode 100644 index 0000000..dbb65cc --- /dev/null +++ b/env/Lib/site-packages/attr/_next_gen.py @@ -0,0 +1,631 @@ +# SPDX-License-Identifier: MIT + +""" +These are keyword-only APIs that call `attr.s` and `attr.ib` with different +default values. +""" + + +from functools import partial + +from . import setters +from ._funcs import asdict as _asdict +from ._funcs import astuple as _astuple +from ._make import ( + _DEFAULT_ON_SETATTR, + NOTHING, + _frozen_setattrs, + attrib, + attrs, +) +from .exceptions import UnannotatedAttributeError + + +def define( + maybe_cls=None, + *, + these=None, + repr=None, + unsafe_hash=None, + hash=None, + init=None, + slots=True, + frozen=False, + weakref_slot=True, + str=False, + auto_attribs=None, + kw_only=False, + cache_hash=False, + auto_exc=True, + eq=None, + order=False, + auto_detect=True, + getstate_setstate=None, + on_setattr=None, + field_transformer=None, + match_args=True, +): + r""" + A class decorator that adds :term:`dunder methods` according to + :term:`fields ` specified using :doc:`type annotations `, + `field()` calls, or the *these* argument. + + Since *attrs* patches or replaces an existing class, you cannot use + `object.__init_subclass__` with *attrs* classes, because it runs too early. + As a replacement, you can define ``__attrs_init_subclass__`` on your class. + It will be called by *attrs* classes that subclass it after they're + created. See also :ref:`init-subclass`. + + Args: + slots (bool): + Create a :term:`slotted class ` that's more + memory-efficient. Slotted classes are generally superior to the + default dict classes, but have some gotchas you should know about, + so we encourage you to read the :term:`glossary entry `. + + auto_detect (bool): + Instead of setting the *init*, *repr*, *eq*, and *hash* arguments + explicitly, assume they are set to True **unless any** of the + involved methods for one of the arguments is implemented in the + *current* class (meaning, it is *not* inherited from some base + class). + + So, for example by implementing ``__eq__`` on a class yourself, + *attrs* will deduce ``eq=False`` and will create *neither* + ``__eq__`` *nor* ``__ne__`` (but Python classes come with a + sensible ``__ne__`` by default, so it *should* be enough to only + implement ``__eq__`` in most cases). + + Passing True or False` to *init*, *repr*, *eq*, *cmp*, or *hash* + overrides whatever *auto_detect* would determine. + + auto_exc (bool): + If the class subclasses `BaseException` (which implicitly includes + any subclass of any exception), the following happens to behave + like a well-behaved Python exception class: + + - the values for *eq*, *order*, and *hash* are ignored and the + instances compare and hash by the instance's ids [#]_ , + - all attributes that are either passed into ``__init__`` or have a + default value are additionally available as a tuple in the + ``args`` attribute, + - the value of *str* is ignored leaving ``__str__`` to base + classes. + + .. [#] + Note that *attrs* will *not* remove existing implementations of + ``__hash__`` or the equality methods. It just won't add own + ones. + + on_setattr (~typing.Callable | list[~typing.Callable] | None | ~typing.Literal[attrs.setters.NO_OP]): + A callable that is run whenever the user attempts to set an + attribute (either by assignment like ``i.x = 42`` or by using + `setattr` like ``setattr(i, "x", 42)``). It receives the same + arguments as validators: the instance, the attribute that is being + modified, and the new value. + + If no exception is raised, the attribute is set to the return value + of the callable. + + If a list of callables is passed, they're automatically wrapped in + an `attrs.setters.pipe`. + + If left None, the default behavior is to run converters and + validators whenever an attribute is set. + + init (bool): + Create a ``__init__`` method that initializes the *attrs* + attributes. Leading underscores are stripped for the argument name, + unless an alias is set on the attribute. + + .. seealso:: + `init` shows advanced ways to customize the generated + ``__init__`` method, including executing code before and after. + + repr(bool): + Create a ``__repr__`` method with a human readable representation + of *attrs* attributes. + + str (bool): + Create a ``__str__`` method that is identical to ``__repr__``. This + is usually not necessary except for `Exception`\ s. + + eq (bool | None): + If True or None (default), add ``__eq__`` and ``__ne__`` methods + that check two instances for equality. + + .. seealso:: + `comparison` describes how to customize the comparison behavior + going as far comparing NumPy arrays. + + order (bool | None): + If True, add ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` + methods that behave like *eq* above and allow instances to be + ordered. + + They compare the instances as if they were tuples of their *attrs* + attributes if and only if the types of both classes are + *identical*. + + If `None` mirror value of *eq*. + + .. seealso:: `comparison` + + cmp (bool | None): + Setting *cmp* is equivalent to setting *eq* and *order* to the same + value. Must not be mixed with *eq* or *order*. + + unsafe_hash (bool | None): + If None (default), the ``__hash__`` method is generated according + how *eq* and *frozen* are set. + + 1. If *both* are True, *attrs* will generate a ``__hash__`` for + you. + 2. If *eq* is True and *frozen* is False, ``__hash__`` will be set + to None, marking it unhashable (which it is). + 3. If *eq* is False, ``__hash__`` will be left untouched meaning + the ``__hash__`` method of the base class will be used. If the + base class is `object`, this means it will fall back to id-based + hashing. + + Although not recommended, you can decide for yourself and force + *attrs* to create one (for example, if the class is immutable even + though you didn't freeze it programmatically) by passing True or + not. Both of these cases are rather special and should be used + carefully. + + .. seealso:: + + - Our documentation on `hashing`, + - Python's documentation on `object.__hash__`, + - and the `GitHub issue that led to the default \ behavior + `_ for more + details. + + hash (bool | None): + Deprecated alias for *unsafe_hash*. *unsafe_hash* takes precedence. + + cache_hash (bool): + Ensure that the object's hash code is computed only once and stored + on the object. If this is set to True, hashing must be either + explicitly or implicitly enabled for this class. If the hash code + is cached, avoid any reassignments of fields involved in hash code + computation or mutations of the objects those fields point to after + object creation. If such changes occur, the behavior of the + object's hash code is undefined. + + frozen (bool): + Make instances immutable after initialization. If someone attempts + to modify a frozen instance, `attrs.exceptions.FrozenInstanceError` + is raised. + + .. note:: + + 1. This is achieved by installing a custom ``__setattr__`` + method on your class, so you can't implement your own. + + 2. True immutability is impossible in Python. + + 3. This *does* have a minor a runtime performance `impact + ` when initializing new instances. In other + words: ``__init__`` is slightly slower with ``frozen=True``. + + 4. If a class is frozen, you cannot modify ``self`` in + ``__attrs_post_init__`` or a self-written ``__init__``. You + can circumvent that limitation by using + ``object.__setattr__(self, "attribute_name", value)``. + + 5. Subclasses of a frozen class are frozen too. + + kw_only (bool): + Make all attributes keyword-only in the generated ``__init__`` (if + *init* is False, this parameter is ignored). + + weakref_slot (bool): + Make instances weak-referenceable. This has no effect unless + *slots* is True. + + field_transformer (~typing.Callable | None): + A function that is called with the original class object and all + fields right before *attrs* finalizes the class. You can use this, + for example, to automatically add converters or validators to + fields based on their types. + + .. seealso:: `transform-fields` + + match_args (bool): + If True (default), set ``__match_args__`` on the class to support + :pep:`634` (*Structural Pattern Matching*). It is a tuple of all + non-keyword-only ``__init__`` parameter names on Python 3.10 and + later. Ignored on older Python versions. + + collect_by_mro (bool): + If True, *attrs* collects attributes from base classes correctly + according to the `method resolution order + `_. If False, *attrs* + will mimic the (wrong) behavior of `dataclasses` and :pep:`681`. + + See also `issue #428 + `_. + + getstate_setstate (bool | None): + .. note:: + + This is usually only interesting for slotted classes and you + should probably just set *auto_detect* to True. + + If True, ``__getstate__`` and ``__setstate__`` are generated and + attached to the class. This is necessary for slotted classes to be + pickleable. If left None, it's True by default for slotted classes + and False for dict classes. + + If *auto_detect* is True, and *getstate_setstate* is left None, and + **either** ``__getstate__`` or ``__setstate__`` is detected + directly on the class (meaning: not inherited), it is set to False + (this is usually what you want). + + auto_attribs (bool | None): + If True, look at type annotations to determine which attributes to + use, like `dataclasses`. If False, it will only look for explicit + :func:`field` class attributes, like classic *attrs*. + + If left None, it will guess: + + 1. If any attributes are annotated and no unannotated + `attrs.field`\ s are found, it assumes *auto_attribs=True*. + 2. Otherwise it assumes *auto_attribs=False* and tries to collect + `attrs.field`\ s. + + If *attrs* decides to look at type annotations, **all** fields + **must** be annotated. If *attrs* encounters a field that is set to + a :func:`field` / `attr.ib` but lacks a type annotation, an + `attrs.exceptions.UnannotatedAttributeError` is raised. Use + ``field_name: typing.Any = field(...)`` if you don't want to set a + type. + + .. warning:: + + For features that use the attribute name to create decorators + (for example, :ref:`validators `), you still *must* + assign :func:`field` / `attr.ib` to them. Otherwise Python will + either not find the name or try to use the default value to + call, for example, ``validator`` on it. + + Attributes annotated as `typing.ClassVar`, and attributes that are + neither annotated nor set to an `field()` are **ignored**. + + these (dict[str, object]): + A dictionary of name to the (private) return value of `field()` + mappings. This is useful to avoid the definition of your attributes + within the class body because you can't (for example, if you want + to add ``__repr__`` methods to Django models) or don't want to. + + If *these* is not `None`, *attrs* will *not* search the class body + for attributes and will *not* remove any attributes from it. + + The order is deduced from the order of the attributes inside + *these*. + + Arguably, this is a rather obscure feature. + + .. versionadded:: 20.1.0 + .. versionchanged:: 21.3.0 Converters are also run ``on_setattr``. + .. versionadded:: 22.2.0 + *unsafe_hash* as an alias for *hash* (for :pep:`681` compliance). + .. versionchanged:: 24.1.0 + Instances are not compared as tuples of attributes anymore, but using a + big ``and`` condition. This is faster and has more correct behavior for + uncomparable values like `math.nan`. + .. versionadded:: 24.1.0 + If a class has an *inherited* classmethod called + ``__attrs_init_subclass__``, it is executed after the class is created. + .. deprecated:: 24.1.0 *hash* is deprecated in favor of *unsafe_hash*. + + .. note:: + + The main differences to the classic `attr.s` are: + + - Automatically detect whether or not *auto_attribs* should be `True` + (c.f. *auto_attribs* parameter). + - Converters and validators run when attributes are set by default -- + if *frozen* is `False`. + - *slots=True* + + Usually, this has only upsides and few visible effects in everyday + programming. But it *can* lead to some surprising behaviors, so + please make sure to read :term:`slotted classes`. + + - *auto_exc=True* + - *auto_detect=True* + - *order=False* + - Some options that were only relevant on Python 2 or were kept around + for backwards-compatibility have been removed. + + """ + + def do_it(cls, auto_attribs): + return attrs( + maybe_cls=cls, + these=these, + repr=repr, + hash=hash, + unsafe_hash=unsafe_hash, + init=init, + slots=slots, + frozen=frozen, + weakref_slot=weakref_slot, + str=str, + auto_attribs=auto_attribs, + kw_only=kw_only, + cache_hash=cache_hash, + auto_exc=auto_exc, + eq=eq, + order=order, + auto_detect=auto_detect, + collect_by_mro=True, + getstate_setstate=getstate_setstate, + on_setattr=on_setattr, + field_transformer=field_transformer, + match_args=match_args, + ) + + def wrap(cls): + """ + Making this a wrapper ensures this code runs during class creation. + + We also ensure that frozen-ness of classes is inherited. + """ + nonlocal frozen, on_setattr + + had_on_setattr = on_setattr not in (None, setters.NO_OP) + + # By default, mutable classes convert & validate on setattr. + if frozen is False and on_setattr is None: + on_setattr = _DEFAULT_ON_SETATTR + + # However, if we subclass a frozen class, we inherit the immutability + # and disable on_setattr. + for base_cls in cls.__bases__: + if base_cls.__setattr__ is _frozen_setattrs: + if had_on_setattr: + msg = "Frozen classes can't use on_setattr (frozen-ness was inherited)." + raise ValueError(msg) + + on_setattr = setters.NO_OP + break + + if auto_attribs is not None: + return do_it(cls, auto_attribs) + + try: + return do_it(cls, True) + except UnannotatedAttributeError: + return do_it(cls, False) + + # maybe_cls's type depends on the usage of the decorator. It's a class + # if it's used as `@attrs` but `None` if used as `@attrs()`. + if maybe_cls is None: + return wrap + + return wrap(maybe_cls) + + +mutable = define +frozen = partial(define, frozen=True, on_setattr=None) + + +def field( + *, + default=NOTHING, + validator=None, + repr=True, + hash=None, + init=True, + metadata=None, + type=None, + converter=None, + factory=None, + kw_only=False, + eq=None, + order=None, + on_setattr=None, + alias=None, +): + """ + Create a new :term:`field` / :term:`attribute` on a class. + + .. warning:: + + Does **nothing** unless the class is also decorated with + `attrs.define` (or similar)! + + Args: + default: + A value that is used if an *attrs*-generated ``__init__`` is used + and no value is passed while instantiating or the attribute is + excluded using ``init=False``. + + If the value is an instance of `attrs.Factory`, its callable will + be used to construct a new value (useful for mutable data types + like lists or dicts). + + If a default is not set (or set manually to `attrs.NOTHING`), a + value *must* be supplied when instantiating; otherwise a + `TypeError` will be raised. + + .. seealso:: `defaults` + + factory (~typing.Callable): + Syntactic sugar for ``default=attr.Factory(factory)``. + + validator (~typing.Callable | list[~typing.Callable]): + Callable that is called by *attrs*-generated ``__init__`` methods + after the instance has been initialized. They receive the + initialized instance, the :func:`~attrs.Attribute`, and the passed + value. + + The return value is *not* inspected so the validator has to throw + an exception itself. + + If a `list` is passed, its items are treated as validators and must + all pass. + + Validators can be globally disabled and re-enabled using + `attrs.validators.get_disabled` / `attrs.validators.set_disabled`. + + The validator can also be set using decorator notation as shown + below. + + .. seealso:: :ref:`validators` + + repr (bool | ~typing.Callable): + Include this attribute in the generated ``__repr__`` method. If + True, include the attribute; if False, omit it. By default, the + built-in ``repr()`` function is used. To override how the attribute + value is formatted, pass a ``callable`` that takes a single value + and returns a string. Note that the resulting string is used as-is, + which means it will be used directly *instead* of calling + ``repr()`` (the default). + + eq (bool | ~typing.Callable): + If True (default), include this attribute in the generated + ``__eq__`` and ``__ne__`` methods that check two instances for + equality. To override how the attribute value is compared, pass a + callable that takes a single value and returns the value to be + compared. + + .. seealso:: `comparison` + + order (bool | ~typing.Callable): + If True (default), include this attributes in the generated + ``__lt__``, ``__le__``, ``__gt__`` and ``__ge__`` methods. To + override how the attribute value is ordered, pass a callable that + takes a single value and returns the value to be ordered. + + .. seealso:: `comparison` + + cmp(bool | ~typing.Callable): + Setting *cmp* is equivalent to setting *eq* and *order* to the same + value. Must not be mixed with *eq* or *order*. + + .. seealso:: `comparison` + + hash (bool | None): + Include this attribute in the generated ``__hash__`` method. If + None (default), mirror *eq*'s value. This is the correct behavior + according the Python spec. Setting this value to anything else + than None is *discouraged*. + + .. seealso:: `hashing` + + init (bool): + Include this attribute in the generated ``__init__`` method. + + It is possible to set this to False and set a default value. In + that case this attributed is unconditionally initialized with the + specified default value or factory. + + .. seealso:: `init` + + converter (typing.Callable | Converter): + A callable that is called by *attrs*-generated ``__init__`` methods + to convert attribute's value to the desired format. + + If a vanilla callable is passed, it is given the passed-in value as + the only positional argument. It is possible to receive additional + arguments by wrapping the callable in a `Converter`. + + Either way, the returned value will be used as the new value of the + attribute. The value is converted before being passed to the + validator, if any. + + .. seealso:: :ref:`converters` + + metadata (dict | None): + An arbitrary mapping, to be used by third-party code. + + .. seealso:: `extending-metadata`. + + type (type): + The type of the attribute. Nowadays, the preferred method to + specify the type is using a variable annotation (see :pep:`526`). + This argument is provided for backwards-compatibility and for usage + with `make_class`. Regardless of the approach used, the type will + be stored on ``Attribute.type``. + + Please note that *attrs* doesn't do anything with this metadata by + itself. You can use it as part of your own code or for `static type + checking `. + + kw_only (bool): + Make this attribute keyword-only in the generated ``__init__`` (if + ``init`` is False, this parameter is ignored). + + on_setattr (~typing.Callable | list[~typing.Callable] | None | ~typing.Literal[attrs.setters.NO_OP]): + Allows to overwrite the *on_setattr* setting from `attr.s`. If left + None, the *on_setattr* value from `attr.s` is used. Set to + `attrs.setters.NO_OP` to run **no** `setattr` hooks for this + attribute -- regardless of the setting in `define()`. + + alias (str | None): + Override this attribute's parameter name in the generated + ``__init__`` method. If left None, default to ``name`` stripped + of leading underscores. See `private-attributes`. + + .. versionadded:: 20.1.0 + .. versionchanged:: 21.1.0 + *eq*, *order*, and *cmp* also accept a custom callable + .. versionadded:: 22.2.0 *alias* + .. versionadded:: 23.1.0 + The *type* parameter has been re-added; mostly for `attrs.make_class`. + Please note that type checkers ignore this metadata. + + .. seealso:: + + `attr.ib` + """ + return attrib( + default=default, + validator=validator, + repr=repr, + hash=hash, + init=init, + metadata=metadata, + type=type, + converter=converter, + factory=factory, + kw_only=kw_only, + eq=eq, + order=order, + on_setattr=on_setattr, + alias=alias, + ) + + +def asdict(inst, *, recurse=True, filter=None, value_serializer=None): + """ + Same as `attr.asdict`, except that collections types are always retained + and dict is always used as *dict_factory*. + + .. versionadded:: 21.3.0 + """ + return _asdict( + inst=inst, + recurse=recurse, + filter=filter, + value_serializer=value_serializer, + retain_collection_types=True, + ) + + +def astuple(inst, *, recurse=True, filter=None): + """ + Same as `attr.astuple`, except that collections types are always retained + and `tuple` is always used as the *tuple_factory*. + + .. versionadded:: 21.3.0 + """ + return _astuple( + inst=inst, recurse=recurse, filter=filter, retain_collection_types=True + ) diff --git a/env/Lib/site-packages/attr/_typing_compat.pyi b/env/Lib/site-packages/attr/_typing_compat.pyi new file mode 100644 index 0000000..ca7b71e --- /dev/null +++ b/env/Lib/site-packages/attr/_typing_compat.pyi @@ -0,0 +1,15 @@ +from typing import Any, ClassVar, Protocol + +# MYPY is a special constant in mypy which works the same way as `TYPE_CHECKING`. +MYPY = False + +if MYPY: + # A protocol to be able to statically accept an attrs class. + class AttrsInstance_(Protocol): + __attrs_attrs__: ClassVar[Any] + +else: + # For type checkers without plug-in support use an empty protocol that + # will (hopefully) be combined into a union. + class AttrsInstance_(Protocol): + pass diff --git a/env/Lib/site-packages/attr/_version_info.py b/env/Lib/site-packages/attr/_version_info.py new file mode 100644 index 0000000..51a1312 --- /dev/null +++ b/env/Lib/site-packages/attr/_version_info.py @@ -0,0 +1,86 @@ +# SPDX-License-Identifier: MIT + + +from functools import total_ordering + +from ._funcs import astuple +from ._make import attrib, attrs + + +@total_ordering +@attrs(eq=False, order=False, slots=True, frozen=True) +class VersionInfo: + """ + A version object that can be compared to tuple of length 1--4: + + >>> attr.VersionInfo(19, 1, 0, "final") <= (19, 2) + True + >>> attr.VersionInfo(19, 1, 0, "final") < (19, 1, 1) + True + >>> vi = attr.VersionInfo(19, 2, 0, "final") + >>> vi < (19, 1, 1) + False + >>> vi < (19,) + False + >>> vi == (19, 2,) + True + >>> vi == (19, 2, 1) + False + + .. versionadded:: 19.2 + """ + + year = attrib(type=int) + minor = attrib(type=int) + micro = attrib(type=int) + releaselevel = attrib(type=str) + + @classmethod + def _from_version_string(cls, s): + """ + Parse *s* and return a _VersionInfo. + """ + v = s.split(".") + if len(v) == 3: + v.append("final") + + return cls( + year=int(v[0]), minor=int(v[1]), micro=int(v[2]), releaselevel=v[3] + ) + + def _ensure_tuple(self, other): + """ + Ensure *other* is a tuple of a valid length. + + Returns a possibly transformed *other* and ourselves as a tuple of + the same length as *other*. + """ + + if self.__class__ is other.__class__: + other = astuple(other) + + if not isinstance(other, tuple): + raise NotImplementedError + + if not (1 <= len(other) <= 4): + raise NotImplementedError + + return astuple(self)[: len(other)], other + + def __eq__(self, other): + try: + us, them = self._ensure_tuple(other) + except NotImplementedError: + return NotImplemented + + return us == them + + def __lt__(self, other): + try: + us, them = self._ensure_tuple(other) + except NotImplementedError: + return NotImplemented + + # Since alphabetically "dev0" < "final" < "post1" < "post2", we don't + # have to do anything special with releaselevel for now. + return us < them diff --git a/env/Lib/site-packages/attr/_version_info.pyi b/env/Lib/site-packages/attr/_version_info.pyi new file mode 100644 index 0000000..45ced08 --- /dev/null +++ b/env/Lib/site-packages/attr/_version_info.pyi @@ -0,0 +1,9 @@ +class VersionInfo: + @property + def year(self) -> int: ... + @property + def minor(self) -> int: ... + @property + def micro(self) -> int: ... + @property + def releaselevel(self) -> str: ... diff --git a/env/Lib/site-packages/attr/converters.py b/env/Lib/site-packages/attr/converters.py new file mode 100644 index 0000000..9238311 --- /dev/null +++ b/env/Lib/site-packages/attr/converters.py @@ -0,0 +1,151 @@ +# SPDX-License-Identifier: MIT + +""" +Commonly useful converters. +""" + + +import typing + +from ._compat import _AnnotationExtractor +from ._make import NOTHING, Factory, pipe + + +__all__ = [ + "default_if_none", + "optional", + "pipe", + "to_bool", +] + + +def optional(converter): + """ + A converter that allows an attribute to be optional. An optional attribute + is one which can be set to `None`. + + Type annotations will be inferred from the wrapped converter's, if it has + any. + + Args: + converter (typing.Callable): + the converter that is used for non-`None` values. + + .. versionadded:: 17.1.0 + """ + + def optional_converter(val): + if val is None: + return None + return converter(val) + + xtr = _AnnotationExtractor(converter) + + t = xtr.get_first_param_type() + if t: + optional_converter.__annotations__["val"] = typing.Optional[t] + + rt = xtr.get_return_type() + if rt: + optional_converter.__annotations__["return"] = typing.Optional[rt] + + return optional_converter + + +def default_if_none(default=NOTHING, factory=None): + """ + A converter that allows to replace `None` values by *default* or the result + of *factory*. + + Args: + default: + Value to be used if `None` is passed. Passing an instance of + `attrs.Factory` is supported, however the ``takes_self`` option is + *not*. + + factory (typing.Callable): + A callable that takes no parameters whose result is used if `None` + is passed. + + Raises: + TypeError: If **neither** *default* or *factory* is passed. + + TypeError: If **both** *default* and *factory* are passed. + + ValueError: + If an instance of `attrs.Factory` is passed with + ``takes_self=True``. + + .. versionadded:: 18.2.0 + """ + if default is NOTHING and factory is None: + msg = "Must pass either `default` or `factory`." + raise TypeError(msg) + + if default is not NOTHING and factory is not None: + msg = "Must pass either `default` or `factory` but not both." + raise TypeError(msg) + + if factory is not None: + default = Factory(factory) + + if isinstance(default, Factory): + if default.takes_self: + msg = "`takes_self` is not supported by default_if_none." + raise ValueError(msg) + + def default_if_none_converter(val): + if val is not None: + return val + + return default.factory() + + else: + + def default_if_none_converter(val): + if val is not None: + return val + + return default + + return default_if_none_converter + + +def to_bool(val): + """ + Convert "boolean" strings (for example, from environment variables) to real + booleans. + + Values mapping to `True`: + + - ``True`` + - ``"true"`` / ``"t"`` + - ``"yes"`` / ``"y"`` + - ``"on"`` + - ``"1"`` + - ``1`` + + Values mapping to `False`: + + - ``False`` + - ``"false"`` / ``"f"`` + - ``"no"`` / ``"n"`` + - ``"off"`` + - ``"0"`` + - ``0`` + + Raises: + ValueError: For any other value. + + .. versionadded:: 21.3.0 + """ + if isinstance(val, str): + val = val.lower() + + if val in (True, "true", "t", "yes", "y", "on", "1", 1): + return True + if val in (False, "false", "f", "no", "n", "off", "0", 0): + return False + + msg = f"Cannot convert value to bool: {val!r}" + raise ValueError(msg) diff --git a/env/Lib/site-packages/attr/converters.pyi b/env/Lib/site-packages/attr/converters.pyi new file mode 100644 index 0000000..9ef478f --- /dev/null +++ b/env/Lib/site-packages/attr/converters.pyi @@ -0,0 +1,13 @@ +from typing import Callable, TypeVar, overload + +from attrs import _ConverterType + +_T = TypeVar("_T") + +def pipe(*validators: _ConverterType) -> _ConverterType: ... +def optional(converter: _ConverterType) -> _ConverterType: ... +@overload +def default_if_none(default: _T) -> _ConverterType: ... +@overload +def default_if_none(*, factory: Callable[[], _T]) -> _ConverterType: ... +def to_bool(val: str) -> bool: ... diff --git a/env/Lib/site-packages/attr/exceptions.py b/env/Lib/site-packages/attr/exceptions.py new file mode 100644 index 0000000..3b7abb8 --- /dev/null +++ b/env/Lib/site-packages/attr/exceptions.py @@ -0,0 +1,95 @@ +# SPDX-License-Identifier: MIT + +from __future__ import annotations + +from typing import ClassVar + + +class FrozenError(AttributeError): + """ + A frozen/immutable instance or attribute have been attempted to be + modified. + + It mirrors the behavior of ``namedtuples`` by using the same error message + and subclassing `AttributeError`. + + .. versionadded:: 20.1.0 + """ + + msg = "can't set attribute" + args: ClassVar[tuple[str]] = [msg] + + +class FrozenInstanceError(FrozenError): + """ + A frozen instance has been attempted to be modified. + + .. versionadded:: 16.1.0 + """ + + +class FrozenAttributeError(FrozenError): + """ + A frozen attribute has been attempted to be modified. + + .. versionadded:: 20.1.0 + """ + + +class AttrsAttributeNotFoundError(ValueError): + """ + An *attrs* function couldn't find an attribute that the user asked for. + + .. versionadded:: 16.2.0 + """ + + +class NotAnAttrsClassError(ValueError): + """ + A non-*attrs* class has been passed into an *attrs* function. + + .. versionadded:: 16.2.0 + """ + + +class DefaultAlreadySetError(RuntimeError): + """ + A default has been set when defining the field and is attempted to be reset + using the decorator. + + .. versionadded:: 17.1.0 + """ + + +class UnannotatedAttributeError(RuntimeError): + """ + A class with ``auto_attribs=True`` has a field without a type annotation. + + .. versionadded:: 17.3.0 + """ + + +class PythonTooOldError(RuntimeError): + """ + It was attempted to use an *attrs* feature that requires a newer Python + version. + + .. versionadded:: 18.2.0 + """ + + +class NotCallableError(TypeError): + """ + A field requiring a callable has been set with a value that is not + callable. + + .. versionadded:: 19.2.0 + """ + + def __init__(self, msg, value): + super(TypeError, self).__init__(msg, value) + self.msg = msg + self.value = value + + def __str__(self): + return str(self.msg) diff --git a/env/Lib/site-packages/attr/exceptions.pyi b/env/Lib/site-packages/attr/exceptions.pyi new file mode 100644 index 0000000..f268011 --- /dev/null +++ b/env/Lib/site-packages/attr/exceptions.pyi @@ -0,0 +1,17 @@ +from typing import Any + +class FrozenError(AttributeError): + msg: str = ... + +class FrozenInstanceError(FrozenError): ... +class FrozenAttributeError(FrozenError): ... +class AttrsAttributeNotFoundError(ValueError): ... +class NotAnAttrsClassError(ValueError): ... +class DefaultAlreadySetError(RuntimeError): ... +class UnannotatedAttributeError(RuntimeError): ... +class PythonTooOldError(RuntimeError): ... + +class NotCallableError(TypeError): + msg: str = ... + value: Any = ... + def __init__(self, msg: str, value: Any) -> None: ... diff --git a/env/Lib/site-packages/attr/filters.py b/env/Lib/site-packages/attr/filters.py new file mode 100644 index 0000000..689b170 --- /dev/null +++ b/env/Lib/site-packages/attr/filters.py @@ -0,0 +1,72 @@ +# SPDX-License-Identifier: MIT + +""" +Commonly useful filters for `attrs.asdict` and `attrs.astuple`. +""" + +from ._make import Attribute + + +def _split_what(what): + """ + Returns a tuple of `frozenset`s of classes and attributes. + """ + return ( + frozenset(cls for cls in what if isinstance(cls, type)), + frozenset(cls for cls in what if isinstance(cls, str)), + frozenset(cls for cls in what if isinstance(cls, Attribute)), + ) + + +def include(*what): + """ + Create a filter that only allows *what*. + + Args: + what (list[type, str, attrs.Attribute]): + What to include. Can be a type, a name, or an attribute. + + Returns: + Callable: + A callable that can be passed to `attrs.asdict`'s and + `attrs.astuple`'s *filter* argument. + + .. versionchanged:: 23.1.0 Accept strings with field names. + """ + cls, names, attrs = _split_what(what) + + def include_(attribute, value): + return ( + value.__class__ in cls + or attribute.name in names + or attribute in attrs + ) + + return include_ + + +def exclude(*what): + """ + Create a filter that does **not** allow *what*. + + Args: + what (list[type, str, attrs.Attribute]): + What to exclude. Can be a type, a name, or an attribute. + + Returns: + Callable: + A callable that can be passed to `attrs.asdict`'s and + `attrs.astuple`'s *filter* argument. + + .. versionchanged:: 23.3.0 Accept field name string as input argument + """ + cls, names, attrs = _split_what(what) + + def exclude_(attribute, value): + return not ( + value.__class__ in cls + or attribute.name in names + or attribute in attrs + ) + + return exclude_ diff --git a/env/Lib/site-packages/attr/filters.pyi b/env/Lib/site-packages/attr/filters.pyi new file mode 100644 index 0000000..974abdc --- /dev/null +++ b/env/Lib/site-packages/attr/filters.pyi @@ -0,0 +1,6 @@ +from typing import Any + +from . import Attribute, _FilterType + +def include(*what: type | str | Attribute[Any]) -> _FilterType[Any]: ... +def exclude(*what: type | str | Attribute[Any]) -> _FilterType[Any]: ... diff --git a/env/Lib/site-packages/attr/py.typed b/env/Lib/site-packages/attr/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/attr/setters.py b/env/Lib/site-packages/attr/setters.py new file mode 100644 index 0000000..a9ce016 --- /dev/null +++ b/env/Lib/site-packages/attr/setters.py @@ -0,0 +1,79 @@ +# SPDX-License-Identifier: MIT + +""" +Commonly used hooks for on_setattr. +""" + +from . import _config +from .exceptions import FrozenAttributeError + + +def pipe(*setters): + """ + Run all *setters* and return the return value of the last one. + + .. versionadded:: 20.1.0 + """ + + def wrapped_pipe(instance, attrib, new_value): + rv = new_value + + for setter in setters: + rv = setter(instance, attrib, rv) + + return rv + + return wrapped_pipe + + +def frozen(_, __, ___): + """ + Prevent an attribute to be modified. + + .. versionadded:: 20.1.0 + """ + raise FrozenAttributeError() + + +def validate(instance, attrib, new_value): + """ + Run *attrib*'s validator on *new_value* if it has one. + + .. versionadded:: 20.1.0 + """ + if _config._run_validators is False: + return new_value + + v = attrib.validator + if not v: + return new_value + + v(instance, attrib, new_value) + + return new_value + + +def convert(instance, attrib, new_value): + """ + Run *attrib*'s converter -- if it has one -- on *new_value* and return the + result. + + .. versionadded:: 20.1.0 + """ + c = attrib.converter + if c: + # This can be removed once we drop 3.8 and use attrs.Converter instead. + from ._make import Converter + + if not isinstance(c, Converter): + return c(new_value) + + return c(new_value, instance, attrib) + + return new_value + + +# Sentinel for disabling class-wide *on_setattr* hooks for certain attributes. +# Sphinx's autodata stopped working, so the docstring is inlined in the API +# docs. +NO_OP = object() diff --git a/env/Lib/site-packages/attr/setters.pyi b/env/Lib/site-packages/attr/setters.pyi new file mode 100644 index 0000000..73abf36 --- /dev/null +++ b/env/Lib/site-packages/attr/setters.pyi @@ -0,0 +1,20 @@ +from typing import Any, NewType, NoReturn, TypeVar + +from . import Attribute +from attrs import _OnSetAttrType + +_T = TypeVar("_T") + +def frozen( + instance: Any, attribute: Attribute[Any], new_value: Any +) -> NoReturn: ... +def pipe(*setters: _OnSetAttrType) -> _OnSetAttrType: ... +def validate(instance: Any, attribute: Attribute[_T], new_value: _T) -> _T: ... + +# convert is allowed to return Any, because they can be chained using pipe. +def convert( + instance: Any, attribute: Attribute[Any], new_value: Any +) -> Any: ... + +_NoOpType = NewType("_NoOpType", object) +NO_OP: _NoOpType diff --git a/env/Lib/site-packages/attr/validators.py b/env/Lib/site-packages/attr/validators.py new file mode 100644 index 0000000..8a56717 --- /dev/null +++ b/env/Lib/site-packages/attr/validators.py @@ -0,0 +1,711 @@ +# SPDX-License-Identifier: MIT + +""" +Commonly useful validators. +""" + + +import operator +import re + +from contextlib import contextmanager +from re import Pattern + +from ._config import get_run_validators, set_run_validators +from ._make import _AndValidator, and_, attrib, attrs +from .converters import default_if_none +from .exceptions import NotCallableError + + +__all__ = [ + "and_", + "deep_iterable", + "deep_mapping", + "disabled", + "ge", + "get_disabled", + "gt", + "in_", + "instance_of", + "is_callable", + "le", + "lt", + "matches_re", + "max_len", + "min_len", + "not_", + "optional", + "or_", + "set_disabled", +] + + +def set_disabled(disabled): + """ + Globally disable or enable running validators. + + By default, they are run. + + Args: + disabled (bool): If `True`, disable running all validators. + + .. warning:: + + This function is not thread-safe! + + .. versionadded:: 21.3.0 + """ + set_run_validators(not disabled) + + +def get_disabled(): + """ + Return a bool indicating whether validators are currently disabled or not. + + Returns: + bool:`True` if validators are currently disabled. + + .. versionadded:: 21.3.0 + """ + return not get_run_validators() + + +@contextmanager +def disabled(): + """ + Context manager that disables running validators within its context. + + .. warning:: + + This context manager is not thread-safe! + + .. versionadded:: 21.3.0 + """ + set_run_validators(False) + try: + yield + finally: + set_run_validators(True) + + +@attrs(repr=False, slots=True, unsafe_hash=True) +class _InstanceOfValidator: + type = attrib() + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if not isinstance(value, self.type): + msg = f"'{attr.name}' must be {self.type!r} (got {value!r} that is a {value.__class__!r})." + raise TypeError( + msg, + attr, + self.type, + value, + ) + + def __repr__(self): + return f"" + + +def instance_of(type): + """ + A validator that raises a `TypeError` if the initializer is called with a + wrong type for this particular attribute (checks are performed using + `isinstance` therefore it's also valid to pass a tuple of types). + + Args: + type (type | tuple[type]): The type to check for. + + Raises: + TypeError: + With a human readable error message, the attribute (of type + `attrs.Attribute`), the expected type, and the value it got. + """ + return _InstanceOfValidator(type) + + +@attrs(repr=False, frozen=True, slots=True) +class _MatchesReValidator: + pattern = attrib() + match_func = attrib() + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if not self.match_func(value): + msg = f"'{attr.name}' must match regex {self.pattern.pattern!r} ({value!r} doesn't)" + raise ValueError( + msg, + attr, + self.pattern, + value, + ) + + def __repr__(self): + return f"" + + +def matches_re(regex, flags=0, func=None): + r""" + A validator that raises `ValueError` if the initializer is called with a + string that doesn't match *regex*. + + Args: + regex (str, re.Pattern): + A regex string or precompiled pattern to match against + + flags (int): + Flags that will be passed to the underlying re function (default 0) + + func (typing.Callable): + Which underlying `re` function to call. Valid options are + `re.fullmatch`, `re.search`, and `re.match`; the default `None` + means `re.fullmatch`. For performance reasons, the pattern is + always precompiled using `re.compile`. + + .. versionadded:: 19.2.0 + .. versionchanged:: 21.3.0 *regex* can be a pre-compiled pattern. + """ + valid_funcs = (re.fullmatch, None, re.search, re.match) + if func not in valid_funcs: + msg = "'func' must be one of {}.".format( + ", ".join( + sorted(e and e.__name__ or "None" for e in set(valid_funcs)) + ) + ) + raise ValueError(msg) + + if isinstance(regex, Pattern): + if flags: + msg = "'flags' can only be used with a string pattern; pass flags to re.compile() instead" + raise TypeError(msg) + pattern = regex + else: + pattern = re.compile(regex, flags) + + if func is re.match: + match_func = pattern.match + elif func is re.search: + match_func = pattern.search + else: + match_func = pattern.fullmatch + + return _MatchesReValidator(pattern, match_func) + + +@attrs(repr=False, slots=True, unsafe_hash=True) +class _OptionalValidator: + validator = attrib() + + def __call__(self, inst, attr, value): + if value is None: + return + + self.validator(inst, attr, value) + + def __repr__(self): + return f"" + + +def optional(validator): + """ + A validator that makes an attribute optional. An optional attribute is one + which can be set to `None` in addition to satisfying the requirements of + the sub-validator. + + Args: + validator + (typing.Callable | tuple[typing.Callable] | list[typing.Callable]): + A validator (or validators) that is used for non-`None` values. + + .. versionadded:: 15.1.0 + .. versionchanged:: 17.1.0 *validator* can be a list of validators. + .. versionchanged:: 23.1.0 *validator* can also be a tuple of validators. + """ + if isinstance(validator, (list, tuple)): + return _OptionalValidator(_AndValidator(validator)) + + return _OptionalValidator(validator) + + +@attrs(repr=False, slots=True, unsafe_hash=True) +class _InValidator: + options = attrib() + _original_options = attrib(hash=False) + + def __call__(self, inst, attr, value): + try: + in_options = value in self.options + except TypeError: # e.g. `1 in "abc"` + in_options = False + + if not in_options: + msg = f"'{attr.name}' must be in {self._original_options!r} (got {value!r})" + raise ValueError( + msg, + attr, + self._original_options, + value, + ) + + def __repr__(self): + return f"" + + +def in_(options): + """ + A validator that raises a `ValueError` if the initializer is called with a + value that does not belong in the *options* provided. + + The check is performed using ``value in options``, so *options* has to + support that operation. + + To keep the validator hashable, dicts, lists, and sets are transparently + transformed into a `tuple`. + + Args: + options: Allowed options. + + Raises: + ValueError: + With a human readable error message, the attribute (of type + `attrs.Attribute`), the expected options, and the value it got. + + .. versionadded:: 17.1.0 + .. versionchanged:: 22.1.0 + The ValueError was incomplete until now and only contained the human + readable error message. Now it contains all the information that has + been promised since 17.1.0. + .. versionchanged:: 24.1.0 + *options* that are a list, dict, or a set are now transformed into a + tuple to keep the validator hashable. + """ + repr_options = options + if isinstance(options, (list, dict, set)): + options = tuple(options) + + return _InValidator(options, repr_options) + + +@attrs(repr=False, slots=False, unsafe_hash=True) +class _IsCallableValidator: + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if not callable(value): + message = ( + "'{name}' must be callable " + "(got {value!r} that is a {actual!r})." + ) + raise NotCallableError( + msg=message.format( + name=attr.name, value=value, actual=value.__class__ + ), + value=value, + ) + + def __repr__(self): + return "" + + +def is_callable(): + """ + A validator that raises a `attrs.exceptions.NotCallableError` if the + initializer is called with a value for this particular attribute that is + not callable. + + .. versionadded:: 19.1.0 + + Raises: + attrs.exceptions.NotCallableError: + With a human readable error message containing the attribute + (`attrs.Attribute`) name, and the value it got. + """ + return _IsCallableValidator() + + +@attrs(repr=False, slots=True, unsafe_hash=True) +class _DeepIterable: + member_validator = attrib(validator=is_callable()) + iterable_validator = attrib( + default=None, validator=optional(is_callable()) + ) + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if self.iterable_validator is not None: + self.iterable_validator(inst, attr, value) + + for member in value: + self.member_validator(inst, attr, member) + + def __repr__(self): + iterable_identifier = ( + "" + if self.iterable_validator is None + else f" {self.iterable_validator!r}" + ) + return ( + f"" + ) + + +def deep_iterable(member_validator, iterable_validator=None): + """ + A validator that performs deep validation of an iterable. + + Args: + member_validator: Validator to apply to iterable members. + + iterable_validator: + Validator to apply to iterable itself (optional). + + Raises + TypeError: if any sub-validators fail + + .. versionadded:: 19.1.0 + """ + if isinstance(member_validator, (list, tuple)): + member_validator = and_(*member_validator) + return _DeepIterable(member_validator, iterable_validator) + + +@attrs(repr=False, slots=True, unsafe_hash=True) +class _DeepMapping: + key_validator = attrib(validator=is_callable()) + value_validator = attrib(validator=is_callable()) + mapping_validator = attrib(default=None, validator=optional(is_callable())) + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if self.mapping_validator is not None: + self.mapping_validator(inst, attr, value) + + for key in value: + self.key_validator(inst, attr, key) + self.value_validator(inst, attr, value[key]) + + def __repr__(self): + return f"" + + +def deep_mapping(key_validator, value_validator, mapping_validator=None): + """ + A validator that performs deep validation of a dictionary. + + Args: + key_validator: Validator to apply to dictionary keys. + + value_validator: Validator to apply to dictionary values. + + mapping_validator: + Validator to apply to top-level mapping attribute (optional). + + .. versionadded:: 19.1.0 + + Raises: + TypeError: if any sub-validators fail + """ + return _DeepMapping(key_validator, value_validator, mapping_validator) + + +@attrs(repr=False, frozen=True, slots=True) +class _NumberValidator: + bound = attrib() + compare_op = attrib() + compare_func = attrib() + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if not self.compare_func(value, self.bound): + msg = f"'{attr.name}' must be {self.compare_op} {self.bound}: {value}" + raise ValueError(msg) + + def __repr__(self): + return f"" + + +def lt(val): + """ + A validator that raises `ValueError` if the initializer is called with a + number larger or equal to *val*. + + The validator uses `operator.lt` to compare the values. + + Args: + val: Exclusive upper bound for values. + + .. versionadded:: 21.3.0 + """ + return _NumberValidator(val, "<", operator.lt) + + +def le(val): + """ + A validator that raises `ValueError` if the initializer is called with a + number greater than *val*. + + The validator uses `operator.le` to compare the values. + + Args: + val: Inclusive upper bound for values. + + .. versionadded:: 21.3.0 + """ + return _NumberValidator(val, "<=", operator.le) + + +def ge(val): + """ + A validator that raises `ValueError` if the initializer is called with a + number smaller than *val*. + + The validator uses `operator.ge` to compare the values. + + Args: + val: Inclusive lower bound for values + + .. versionadded:: 21.3.0 + """ + return _NumberValidator(val, ">=", operator.ge) + + +def gt(val): + """ + A validator that raises `ValueError` if the initializer is called with a + number smaller or equal to *val*. + + The validator uses `operator.ge` to compare the values. + + Args: + val: Exclusive lower bound for values + + .. versionadded:: 21.3.0 + """ + return _NumberValidator(val, ">", operator.gt) + + +@attrs(repr=False, frozen=True, slots=True) +class _MaxLengthValidator: + max_length = attrib() + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if len(value) > self.max_length: + msg = f"Length of '{attr.name}' must be <= {self.max_length}: {len(value)}" + raise ValueError(msg) + + def __repr__(self): + return f"" + + +def max_len(length): + """ + A validator that raises `ValueError` if the initializer is called + with a string or iterable that is longer than *length*. + + Args: + length (int): Maximum length of the string or iterable + + .. versionadded:: 21.3.0 + """ + return _MaxLengthValidator(length) + + +@attrs(repr=False, frozen=True, slots=True) +class _MinLengthValidator: + min_length = attrib() + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if len(value) < self.min_length: + msg = f"Length of '{attr.name}' must be >= {self.min_length}: {len(value)}" + raise ValueError(msg) + + def __repr__(self): + return f"" + + +def min_len(length): + """ + A validator that raises `ValueError` if the initializer is called + with a string or iterable that is shorter than *length*. + + Args: + length (int): Minimum length of the string or iterable + + .. versionadded:: 22.1.0 + """ + return _MinLengthValidator(length) + + +@attrs(repr=False, slots=True, unsafe_hash=True) +class _SubclassOfValidator: + type = attrib() + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if not issubclass(value, self.type): + msg = f"'{attr.name}' must be a subclass of {self.type!r} (got {value!r})." + raise TypeError( + msg, + attr, + self.type, + value, + ) + + def __repr__(self): + return f"" + + +def _subclass_of(type): + """ + A validator that raises a `TypeError` if the initializer is called with a + wrong type for this particular attribute (checks are performed using + `issubclass` therefore it's also valid to pass a tuple of types). + + Args: + type (type | tuple[type, ...]): The type(s) to check for. + + Raises: + TypeError: + With a human readable error message, the attribute (of type + `attrs.Attribute`), the expected type, and the value it got. + """ + return _SubclassOfValidator(type) + + +@attrs(repr=False, slots=True, unsafe_hash=True) +class _NotValidator: + validator = attrib() + msg = attrib( + converter=default_if_none( + "not_ validator child '{validator!r}' " + "did not raise a captured error" + ) + ) + exc_types = attrib( + validator=deep_iterable( + member_validator=_subclass_of(Exception), + iterable_validator=instance_of(tuple), + ), + ) + + def __call__(self, inst, attr, value): + try: + self.validator(inst, attr, value) + except self.exc_types: + pass # suppress error to invert validity + else: + raise ValueError( + self.msg.format( + validator=self.validator, + exc_types=self.exc_types, + ), + attr, + self.validator, + value, + self.exc_types, + ) + + def __repr__(self): + return f"" + + +def not_(validator, *, msg=None, exc_types=(ValueError, TypeError)): + """ + A validator that wraps and logically 'inverts' the validator passed to it. + It will raise a `ValueError` if the provided validator *doesn't* raise a + `ValueError` or `TypeError` (by default), and will suppress the exception + if the provided validator *does*. + + Intended to be used with existing validators to compose logic without + needing to create inverted variants, for example, ``not_(in_(...))``. + + Args: + validator: A validator to be logically inverted. + + msg (str): + Message to raise if validator fails. Formatted with keys + ``exc_types`` and ``validator``. + + exc_types (tuple[type, ...]): + Exception type(s) to capture. Other types raised by child + validators will not be intercepted and pass through. + + Raises: + ValueError: + With a human readable error message, the attribute (of type + `attrs.Attribute`), the validator that failed to raise an + exception, the value it got, and the expected exception types. + + .. versionadded:: 22.2.0 + """ + try: + exc_types = tuple(exc_types) + except TypeError: + exc_types = (exc_types,) + return _NotValidator(validator, msg, exc_types) + + +@attrs(repr=False, slots=True, unsafe_hash=True) +class _OrValidator: + validators = attrib() + + def __call__(self, inst, attr, value): + for v in self.validators: + try: + v(inst, attr, value) + except Exception: # noqa: BLE001, PERF203, S112 + continue + else: + return + + msg = f"None of {self.validators!r} satisfied for value {value!r}" + raise ValueError(msg) + + def __repr__(self): + return f"" + + +def or_(*validators): + """ + A validator that composes multiple validators into one. + + When called on a value, it runs all wrapped validators until one of them is + satisfied. + + Args: + validators (~collections.abc.Iterable[typing.Callable]): + Arbitrary number of validators. + + Raises: + ValueError: + If no validator is satisfied. Raised with a human-readable error + message listing all the wrapped validators and the value that + failed all of them. + + .. versionadded:: 24.1.0 + """ + vals = [] + for v in validators: + vals.extend(v.validators if isinstance(v, _OrValidator) else [v]) + + return _OrValidator(tuple(vals)) diff --git a/env/Lib/site-packages/attr/validators.pyi b/env/Lib/site-packages/attr/validators.pyi new file mode 100644 index 0000000..a314110 --- /dev/null +++ b/env/Lib/site-packages/attr/validators.pyi @@ -0,0 +1,83 @@ +from typing import ( + Any, + AnyStr, + Callable, + Container, + ContextManager, + Iterable, + Mapping, + Match, + Pattern, + TypeVar, + overload, +) + +from attrs import _ValidatorType +from attrs import _ValidatorArgType + +_T = TypeVar("_T") +_T1 = TypeVar("_T1") +_T2 = TypeVar("_T2") +_T3 = TypeVar("_T3") +_I = TypeVar("_I", bound=Iterable) +_K = TypeVar("_K") +_V = TypeVar("_V") +_M = TypeVar("_M", bound=Mapping) + +def set_disabled(run: bool) -> None: ... +def get_disabled() -> bool: ... +def disabled() -> ContextManager[None]: ... + +# To be more precise on instance_of use some overloads. +# If there are more than 3 items in the tuple then we fall back to Any +@overload +def instance_of(type: type[_T]) -> _ValidatorType[_T]: ... +@overload +def instance_of(type: tuple[type[_T]]) -> _ValidatorType[_T]: ... +@overload +def instance_of( + type: tuple[type[_T1], type[_T2]] +) -> _ValidatorType[_T1 | _T2]: ... +@overload +def instance_of( + type: tuple[type[_T1], type[_T2], type[_T3]] +) -> _ValidatorType[_T1 | _T2 | _T3]: ... +@overload +def instance_of(type: tuple[type, ...]) -> _ValidatorType[Any]: ... +def optional( + validator: ( + _ValidatorType[_T] + | list[_ValidatorType[_T]] + | tuple[_ValidatorType[_T]] + ), +) -> _ValidatorType[_T | None]: ... +def in_(options: Container[_T]) -> _ValidatorType[_T]: ... +def and_(*validators: _ValidatorType[_T]) -> _ValidatorType[_T]: ... +def matches_re( + regex: Pattern[AnyStr] | AnyStr, + flags: int = ..., + func: Callable[[AnyStr, AnyStr, int], Match[AnyStr] | None] | None = ..., +) -> _ValidatorType[AnyStr]: ... +def deep_iterable( + member_validator: _ValidatorArgType[_T], + iterable_validator: _ValidatorType[_I] | None = ..., +) -> _ValidatorType[_I]: ... +def deep_mapping( + key_validator: _ValidatorType[_K], + value_validator: _ValidatorType[_V], + mapping_validator: _ValidatorType[_M] | None = ..., +) -> _ValidatorType[_M]: ... +def is_callable() -> _ValidatorType[_T]: ... +def lt(val: _T) -> _ValidatorType[_T]: ... +def le(val: _T) -> _ValidatorType[_T]: ... +def ge(val: _T) -> _ValidatorType[_T]: ... +def gt(val: _T) -> _ValidatorType[_T]: ... +def max_len(length: int) -> _ValidatorType[_T]: ... +def min_len(length: int) -> _ValidatorType[_T]: ... +def not_( + validator: _ValidatorType[_T], + *, + msg: str | None = None, + exc_types: type[Exception] | Iterable[type[Exception]] = ..., +) -> _ValidatorType[_T]: ... +def or_(*validators: _ValidatorType[_T]) -> _ValidatorType[_T]: ... diff --git a/env/Lib/site-packages/attrs-24.2.0.dist-info/INSTALLER b/env/Lib/site-packages/attrs-24.2.0.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/Lib/site-packages/attrs-24.2.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/Lib/site-packages/attrs-24.2.0.dist-info/METADATA b/env/Lib/site-packages/attrs-24.2.0.dist-info/METADATA new file mode 100644 index 0000000..a85b378 --- /dev/null +++ b/env/Lib/site-packages/attrs-24.2.0.dist-info/METADATA @@ -0,0 +1,242 @@ +Metadata-Version: 2.3 +Name: attrs +Version: 24.2.0 +Summary: Classes Without Boilerplate +Project-URL: Documentation, https://www.attrs.org/ +Project-URL: Changelog, https://www.attrs.org/en/stable/changelog.html +Project-URL: GitHub, https://github.com/python-attrs/attrs +Project-URL: Funding, https://github.com/sponsors/hynek +Project-URL: Tidelift, https://tidelift.com/subscription/pkg/pypi-attrs?utm_source=pypi-attrs&utm_medium=pypi +Author-email: Hynek Schlawack +License-Expression: MIT +License-File: LICENSE +Keywords: attribute,boilerplate,class +Classifier: Development Status :: 5 - Production/Stable +Classifier: License :: OSI Approved :: MIT License +Classifier: Programming Language :: Python :: 3.7 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3.13 +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy +Classifier: Typing :: Typed +Requires-Python: >=3.7 +Requires-Dist: importlib-metadata; python_version < '3.8' +Provides-Extra: benchmark +Requires-Dist: cloudpickle; (platform_python_implementation == 'CPython') and extra == 'benchmark' +Requires-Dist: hypothesis; extra == 'benchmark' +Requires-Dist: mypy>=1.11.1; (platform_python_implementation == 'CPython' and python_version >= '3.9') and extra == 'benchmark' +Requires-Dist: pympler; extra == 'benchmark' +Requires-Dist: pytest-codspeed; extra == 'benchmark' +Requires-Dist: pytest-mypy-plugins; (platform_python_implementation == 'CPython' and python_version >= '3.9' and python_version < '3.13') and extra == 'benchmark' +Requires-Dist: pytest-xdist[psutil]; extra == 'benchmark' +Requires-Dist: pytest>=4.3.0; extra == 'benchmark' +Provides-Extra: cov +Requires-Dist: cloudpickle; (platform_python_implementation == 'CPython') and extra == 'cov' +Requires-Dist: coverage[toml]>=5.3; extra == 'cov' +Requires-Dist: hypothesis; extra == 'cov' +Requires-Dist: mypy>=1.11.1; (platform_python_implementation == 'CPython' and python_version >= '3.9') and extra == 'cov' +Requires-Dist: pympler; extra == 'cov' +Requires-Dist: pytest-mypy-plugins; (platform_python_implementation == 'CPython' and python_version >= '3.9' and python_version < '3.13') and extra == 'cov' +Requires-Dist: pytest-xdist[psutil]; extra == 'cov' +Requires-Dist: pytest>=4.3.0; extra == 'cov' +Provides-Extra: dev +Requires-Dist: cloudpickle; (platform_python_implementation == 'CPython') and extra == 'dev' +Requires-Dist: hypothesis; extra == 'dev' +Requires-Dist: mypy>=1.11.1; (platform_python_implementation == 'CPython' and python_version >= '3.9') and extra == 'dev' +Requires-Dist: pre-commit; extra == 'dev' +Requires-Dist: pympler; extra == 'dev' +Requires-Dist: pytest-mypy-plugins; (platform_python_implementation == 'CPython' and python_version >= '3.9' and python_version < '3.13') and extra == 'dev' +Requires-Dist: pytest-xdist[psutil]; extra == 'dev' +Requires-Dist: pytest>=4.3.0; extra == 'dev' +Provides-Extra: docs +Requires-Dist: cogapp; extra == 'docs' +Requires-Dist: furo; extra == 'docs' +Requires-Dist: myst-parser; extra == 'docs' +Requires-Dist: sphinx; extra == 'docs' +Requires-Dist: sphinx-notfound-page; extra == 'docs' +Requires-Dist: sphinxcontrib-towncrier; extra == 'docs' +Requires-Dist: towncrier<24.7; extra == 'docs' +Provides-Extra: tests +Requires-Dist: cloudpickle; (platform_python_implementation == 'CPython') and extra == 'tests' +Requires-Dist: hypothesis; extra == 'tests' +Requires-Dist: mypy>=1.11.1; (platform_python_implementation == 'CPython' and python_version >= '3.9') and extra == 'tests' +Requires-Dist: pympler; extra == 'tests' +Requires-Dist: pytest-mypy-plugins; (platform_python_implementation == 'CPython' and python_version >= '3.9' and python_version < '3.13') and extra == 'tests' +Requires-Dist: pytest-xdist[psutil]; extra == 'tests' +Requires-Dist: pytest>=4.3.0; extra == 'tests' +Provides-Extra: tests-mypy +Requires-Dist: mypy>=1.11.1; (platform_python_implementation == 'CPython' and python_version >= '3.9') and extra == 'tests-mypy' +Requires-Dist: pytest-mypy-plugins; (platform_python_implementation == 'CPython' and python_version >= '3.9' and python_version < '3.13') and extra == 'tests-mypy' +Description-Content-Type: text/markdown + +

        + + attrs + +

        + + +*attrs* is the Python package that will bring back the **joy** of **writing classes** by relieving you from the drudgery of implementing object protocols (aka [dunder methods](https://www.attrs.org/en/latest/glossary.html#term-dunder-methods)). +[Trusted by NASA](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/personalizing-your-profile#list-of-qualifying-repositories-for-mars-2020-helicopter-contributor-achievement) for Mars missions since 2020! + +Its main goal is to help you to write **concise** and **correct** software without slowing down your code. + + +## Sponsors + +*attrs* would not be possible without our [amazing sponsors](https://github.com/sponsors/hynek). +Especially those generously supporting us at the *The Organization* tier and higher: + + + +

        + + + + + + + + +

        + + + +

        + Please consider joining them to help make attrs’s maintenance more sustainable! +

        + + + +## Example + +*attrs* gives you a class decorator and a way to declaratively define the attributes on that class: + + + +```pycon +>>> from attrs import asdict, define, make_class, Factory + +>>> @define +... class SomeClass: +... a_number: int = 42 +... list_of_numbers: list[int] = Factory(list) +... +... def hard_math(self, another_number): +... return self.a_number + sum(self.list_of_numbers) * another_number + + +>>> sc = SomeClass(1, [1, 2, 3]) +>>> sc +SomeClass(a_number=1, list_of_numbers=[1, 2, 3]) + +>>> sc.hard_math(3) +19 +>>> sc == SomeClass(1, [1, 2, 3]) +True +>>> sc != SomeClass(2, [3, 2, 1]) +True + +>>> asdict(sc) +{'a_number': 1, 'list_of_numbers': [1, 2, 3]} + +>>> SomeClass() +SomeClass(a_number=42, list_of_numbers=[]) + +>>> C = make_class("C", ["a", "b"]) +>>> C("foo", "bar") +C(a='foo', b='bar') +``` + +After *declaring* your attributes, *attrs* gives you: + +- a concise and explicit overview of the class's attributes, +- a nice human-readable `__repr__`, +- equality-checking methods, +- an initializer, +- and much more, + +*without* writing dull boilerplate code again and again and *without* runtime performance penalties. + +--- + +This example uses *attrs*'s modern APIs that have been introduced in version 20.1.0, and the *attrs* package import name that has been added in version 21.3.0. +The classic APIs (`@attr.s`, `attr.ib`, plus their serious-business aliases) and the `attr` package import name will remain **indefinitely**. + +Check out [*On The Core API Names*](https://www.attrs.org/en/latest/names.html) for an in-depth explanation! + + +### Hate Type Annotations!? + +No problem! +Types are entirely **optional** with *attrs*. +Simply assign `attrs.field()` to the attributes instead of annotating them with types: + +```python +from attrs import define, field + +@define +class SomeClass: + a_number = field(default=42) + list_of_numbers = field(factory=list) +``` + + +## Data Classes + +On the tin, *attrs* might remind you of `dataclasses` (and indeed, `dataclasses` [are a descendant](https://hynek.me/articles/import-attrs/) of *attrs*). +In practice it does a lot more and is more flexible. +For instance, it allows you to define [special handling of NumPy arrays for equality checks](https://www.attrs.org/en/stable/comparison.html#customization), allows more ways to [plug into the initialization process](https://www.attrs.org/en/stable/init.html#hooking-yourself-into-initialization), has a replacement for `__init_subclass__`, and allows for stepping through the generated methods using a debugger. + +For more details, please refer to our [comparison page](https://www.attrs.org/en/stable/why.html#data-classes), but generally speaking, we are more likely to commit crimes against nature to make things work that one would expect to work, but that are quite complicated in practice. + + +## Project Information + +- [**Changelog**](https://www.attrs.org/en/stable/changelog.html) +- [**Documentation**](https://www.attrs.org/) +- [**PyPI**](https://pypi.org/project/attrs/) +- [**Source Code**](https://github.com/python-attrs/attrs) +- [**Contributing**](https://github.com/python-attrs/attrs/blob/main/.github/CONTRIBUTING.md) +- [**Third-party Extensions**](https://github.com/python-attrs/attrs/wiki/Extensions-to-attrs) +- **Get Help**: use the `python-attrs` tag on [Stack Overflow](https://stackoverflow.com/questions/tagged/python-attrs) + + +### *attrs* for Enterprise + +Available as part of the Tidelift Subscription. + +The maintainers of *attrs* and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications. +Save time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use. +[Learn more](https://tidelift.com/?utm_source=lifter&utm_medium=referral&utm_campaign=hynek). + +## Release Information + +### Deprecations + +- Given the amount of warnings raised in the broader ecosystem, we've decided to only soft-deprecate the *hash* argument to `@define` / `@attr.s`. + Please don't use it in new code, but we don't intend to remove it anymore. + [#1330](https://github.com/python-attrs/attrs/issues/1330) + + +### Changes + +- `attrs.converters.pipe()` (and its syntactic sugar of passing a list for `attrs.field()`'s / `attr.ib()`'s *converter* argument) works again when passing `attrs.setters.convert` to *on_setattr* (which is default for `attrs.define`). + [#1328](https://github.com/python-attrs/attrs/issues/1328) +- Restored support for PEP [649](https://peps.python.org/pep-0649/) / [749](https://peps.python.org/pep-0749/)-implementing Pythons -- currently 3.14-dev. + [#1329](https://github.com/python-attrs/attrs/issues/1329) + + + +--- + +[Full changelog →](https://www.attrs.org/en/stable/changelog.html) diff --git a/env/Lib/site-packages/attrs-24.2.0.dist-info/RECORD b/env/Lib/site-packages/attrs-24.2.0.dist-info/RECORD new file mode 100644 index 0000000..f4876cb --- /dev/null +++ b/env/Lib/site-packages/attrs-24.2.0.dist-info/RECORD @@ -0,0 +1,55 @@ +attr/__init__.py,sha256=l8Ewh5KZE7CCY0i1iDfSCnFiUTIkBVoqsXjX9EZnIVA,2087 +attr/__init__.pyi,sha256=aTVHBPX6krCGvbQvOl_UKqEzmi2HFsaIVm2WKmAiqVs,11434 +attr/__pycache__/__init__.cpython-311.pyc,, +attr/__pycache__/_cmp.cpython-311.pyc,, +attr/__pycache__/_compat.cpython-311.pyc,, +attr/__pycache__/_config.cpython-311.pyc,, +attr/__pycache__/_funcs.cpython-311.pyc,, +attr/__pycache__/_make.cpython-311.pyc,, +attr/__pycache__/_next_gen.cpython-311.pyc,, +attr/__pycache__/_version_info.cpython-311.pyc,, +attr/__pycache__/converters.cpython-311.pyc,, +attr/__pycache__/exceptions.cpython-311.pyc,, +attr/__pycache__/filters.cpython-311.pyc,, +attr/__pycache__/setters.cpython-311.pyc,, +attr/__pycache__/validators.cpython-311.pyc,, +attr/_cmp.py,sha256=3umHiBtgsEYtvNP_8XrQwTCdFoZIX4DEur76N-2a3X8,4123 +attr/_cmp.pyi,sha256=U-_RU_UZOyPUEQzXE6RMYQQcjkZRY25wTH99sN0s7MM,368 +attr/_compat.py,sha256=n2Uk3c-ywv0PkFfGlvqR7SzDXp4NOhWmNV_ZK6YfWoM,2958 +attr/_config.py,sha256=z81Vt-GeT_2taxs1XZfmHx9TWlSxjPb6eZH1LTGsS54,843 +attr/_funcs.py,sha256=SGDmNlED1TM3tgO9Ap2mfRfVI24XEAcrNQs7o2eBXHQ,17386 +attr/_make.py,sha256=BjENJz5eJoojJVbCoupWjXLLEZJ7VID89lisLbQUlmQ,91479 +attr/_next_gen.py,sha256=dhGb96VFg4kXBkS9Zdz1A2uxVJ99q_RT1hw3kLA9-uI,24630 +attr/_typing_compat.pyi,sha256=XDP54TUn-ZKhD62TOQebmzrwFyomhUCoGRpclb6alRA,469 +attr/_version_info.py,sha256=exSqb3b5E-fMSsgZAlEw9XcLpEgobPORCZpcaEglAM4,2121 +attr/_version_info.pyi,sha256=x_M3L3WuB7r_ULXAWjx959udKQ4HLB8l-hsc1FDGNvk,209 +attr/converters.py,sha256=vNa58pZi9V6uxBzl4t1QrHbQfkT4iRFAodyXe7lcgg0,3506 +attr/converters.pyi,sha256=mpDoVFO3Cpx8xYSSV0iZFl7IAHuoNBglxKfxHvLj_sY,410 +attr/exceptions.py,sha256=HRFq4iybmv7-DcZwyjl6M1euM2YeJVK_hFxuaBGAngI,1977 +attr/exceptions.pyi,sha256=zZq8bCUnKAy9mDtBEw42ZhPhAUIHoTKedDQInJD883M,539 +attr/filters.py,sha256=ZBiKWLp3R0LfCZsq7X11pn9WX8NslS2wXM4jsnLOGc8,1795 +attr/filters.pyi,sha256=3J5BG-dTxltBk1_-RuNRUHrv2qu1v8v4aDNAQ7_mifA,208 +attr/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +attr/setters.py,sha256=faMQeiBo_nbXYnPaQ1pq8PXeA7Zr-uNsVsPMiKCmxhc,1619 +attr/setters.pyi,sha256=NnVkaFU1BB4JB8E4JuXyrzTUgvtMpj8p3wBdJY7uix4,584 +attr/validators.py,sha256=985eTP6RHyon61YEauMJgyNy1rEOhJWiSXMJgRxPtrQ,20045 +attr/validators.pyi,sha256=LjKf7AoXZfvGSfT3LRs61Qfln94konYyMUPoJJjOxK4,2502 +attrs-24.2.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +attrs-24.2.0.dist-info/METADATA,sha256=3Jgk4lr9Y1SAqAcwOLPN_mpW0wc6VOGm-yHt1LsPIHw,11524 +attrs-24.2.0.dist-info/RECORD,, +attrs-24.2.0.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87 +attrs-24.2.0.dist-info/licenses/LICENSE,sha256=iCEVyV38KvHutnFPjsbVy8q_Znyv-HKfQkINpj9xTp8,1109 +attrs/__init__.py,sha256=5FHo-EMFOX-g4ialSK4fwOjuoHzLISJDZCwoOl02Ty8,1071 +attrs/__init__.pyi,sha256=o3l92VsD9kHz8sldEtb_tllBTs3TeL-vIBMTxo2Zc_4,7703 +attrs/__pycache__/__init__.cpython-311.pyc,, +attrs/__pycache__/converters.cpython-311.pyc,, +attrs/__pycache__/exceptions.cpython-311.pyc,, +attrs/__pycache__/filters.cpython-311.pyc,, +attrs/__pycache__/setters.cpython-311.pyc,, +attrs/__pycache__/validators.cpython-311.pyc,, +attrs/converters.py,sha256=8kQljrVwfSTRu8INwEk8SI0eGrzmWftsT7rM0EqyohM,76 +attrs/exceptions.py,sha256=ACCCmg19-vDFaDPY9vFl199SPXCQMN_bENs4DALjzms,76 +attrs/filters.py,sha256=VOUMZug9uEU6dUuA0dF1jInUK0PL3fLgP0VBS5d-CDE,73 +attrs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +attrs/setters.py,sha256=eL1YidYQV3T2h9_SYIZSZR1FAcHGb1TuCTy0E0Lv2SU,73 +attrs/validators.py,sha256=xcy6wD5TtTkdCG1f4XWbocPSO0faBjk5IfVJfP6SUj0,76 diff --git a/env/Lib/site-packages/attrs-24.2.0.dist-info/WHEEL b/env/Lib/site-packages/attrs-24.2.0.dist-info/WHEEL new file mode 100644 index 0000000..cdd68a4 --- /dev/null +++ b/env/Lib/site-packages/attrs-24.2.0.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: hatchling 1.25.0 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/env/Lib/site-packages/attrs-24.2.0.dist-info/licenses/LICENSE b/env/Lib/site-packages/attrs-24.2.0.dist-info/licenses/LICENSE new file mode 100644 index 0000000..2bd6453 --- /dev/null +++ b/env/Lib/site-packages/attrs-24.2.0.dist-info/licenses/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2015 Hynek Schlawack and the attrs contributors + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/env/Lib/site-packages/attrs/__init__.py b/env/Lib/site-packages/attrs/__init__.py new file mode 100644 index 0000000..963b197 --- /dev/null +++ b/env/Lib/site-packages/attrs/__init__.py @@ -0,0 +1,67 @@ +# SPDX-License-Identifier: MIT + +from attr import ( + NOTHING, + Attribute, + AttrsInstance, + Converter, + Factory, + _make_getattr, + assoc, + cmp_using, + define, + evolve, + field, + fields, + fields_dict, + frozen, + has, + make_class, + mutable, + resolve_types, + validate, +) +from attr._next_gen import asdict, astuple + +from . import converters, exceptions, filters, setters, validators + + +__all__ = [ + "__author__", + "__copyright__", + "__description__", + "__doc__", + "__email__", + "__license__", + "__title__", + "__url__", + "__version__", + "__version_info__", + "asdict", + "assoc", + "astuple", + "Attribute", + "AttrsInstance", + "cmp_using", + "Converter", + "converters", + "define", + "evolve", + "exceptions", + "Factory", + "field", + "fields_dict", + "fields", + "filters", + "frozen", + "has", + "make_class", + "mutable", + "NOTHING", + "resolve_types", + "setters", + "validate", + "validators", +] + +__getattr__ = _make_getattr(__name__) diff --git a/env/Lib/site-packages/attrs/__init__.pyi b/env/Lib/site-packages/attrs/__init__.pyi new file mode 100644 index 0000000..b2670de --- /dev/null +++ b/env/Lib/site-packages/attrs/__init__.pyi @@ -0,0 +1,252 @@ +import sys + +from typing import ( + Any, + Callable, + Mapping, + Sequence, + overload, + TypeVar, +) + +# Because we need to type our own stuff, we have to make everything from +# attr explicitly public too. +from attr import __author__ as __author__ +from attr import __copyright__ as __copyright__ +from attr import __description__ as __description__ +from attr import __email__ as __email__ +from attr import __license__ as __license__ +from attr import __title__ as __title__ +from attr import __url__ as __url__ +from attr import __version__ as __version__ +from attr import __version_info__ as __version_info__ +from attr import assoc as assoc +from attr import Attribute as Attribute +from attr import AttrsInstance as AttrsInstance +from attr import cmp_using as cmp_using +from attr import converters as converters +from attr import Converter as Converter +from attr import evolve as evolve +from attr import exceptions as exceptions +from attr import Factory as Factory +from attr import fields as fields +from attr import fields_dict as fields_dict +from attr import filters as filters +from attr import has as has +from attr import make_class as make_class +from attr import NOTHING as NOTHING +from attr import resolve_types as resolve_types +from attr import setters as setters +from attr import validate as validate +from attr import validators as validators +from attr import attrib, asdict as asdict, astuple as astuple + +if sys.version_info >= (3, 11): + from typing import dataclass_transform +else: + from typing_extensions import dataclass_transform + +_T = TypeVar("_T") +_C = TypeVar("_C", bound=type) + +_EqOrderType = bool | Callable[[Any], Any] +_ValidatorType = Callable[[Any, "Attribute[_T]", _T], Any] +_ConverterType = Callable[[Any], Any] +_ReprType = Callable[[Any], str] +_ReprArgType = bool | _ReprType +_OnSetAttrType = Callable[[Any, "Attribute[Any]", Any], Any] +_OnSetAttrArgType = _OnSetAttrType | list[_OnSetAttrType] | setters._NoOpType +_FieldTransformer = Callable[ + [type, list["Attribute[Any]"]], list["Attribute[Any]"] +] +# FIXME: in reality, if multiple validators are passed they must be in a list +# or tuple, but those are invariant and so would prevent subtypes of +# _ValidatorType from working when passed in a list or tuple. +_ValidatorArgType = _ValidatorType[_T] | Sequence[_ValidatorType[_T]] + +@overload +def field( + *, + default: None = ..., + validator: None = ..., + repr: _ReprArgType = ..., + hash: bool | None = ..., + init: bool = ..., + metadata: Mapping[Any, Any] | None = ..., + converter: None = ..., + factory: None = ..., + kw_only: bool = ..., + eq: bool | None = ..., + order: bool | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + alias: str | None = ..., + type: type | None = ..., +) -> Any: ... + +# This form catches an explicit None or no default and infers the type from the +# other arguments. +@overload +def field( + *, + default: None = ..., + validator: _ValidatorArgType[_T] | None = ..., + repr: _ReprArgType = ..., + hash: bool | None = ..., + init: bool = ..., + metadata: Mapping[Any, Any] | None = ..., + converter: _ConverterType | Converter[Any, _T] | None = ..., + factory: Callable[[], _T] | None = ..., + kw_only: bool = ..., + eq: _EqOrderType | None = ..., + order: _EqOrderType | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + alias: str | None = ..., + type: type | None = ..., +) -> _T: ... + +# This form catches an explicit default argument. +@overload +def field( + *, + default: _T, + validator: _ValidatorArgType[_T] | None = ..., + repr: _ReprArgType = ..., + hash: bool | None = ..., + init: bool = ..., + metadata: Mapping[Any, Any] | None = ..., + converter: _ConverterType | Converter[Any, _T] | None = ..., + factory: Callable[[], _T] | None = ..., + kw_only: bool = ..., + eq: _EqOrderType | None = ..., + order: _EqOrderType | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + alias: str | None = ..., + type: type | None = ..., +) -> _T: ... + +# This form covers type=non-Type: e.g. forward references (str), Any +@overload +def field( + *, + default: _T | None = ..., + validator: _ValidatorArgType[_T] | None = ..., + repr: _ReprArgType = ..., + hash: bool | None = ..., + init: bool = ..., + metadata: Mapping[Any, Any] | None = ..., + converter: _ConverterType | Converter[Any, _T] | None = ..., + factory: Callable[[], _T] | None = ..., + kw_only: bool = ..., + eq: _EqOrderType | None = ..., + order: _EqOrderType | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + alias: str | None = ..., + type: type | None = ..., +) -> Any: ... +@overload +@dataclass_transform(field_specifiers=(attrib, field)) +def define( + maybe_cls: _C, + *, + these: dict[str, Any] | None = ..., + repr: bool = ..., + unsafe_hash: bool | 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: bool | None = ..., + order: bool | None = ..., + auto_detect: bool = ..., + getstate_setstate: bool | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + field_transformer: _FieldTransformer | None = ..., + match_args: bool = ..., +) -> _C: ... +@overload +@dataclass_transform(field_specifiers=(attrib, field)) +def define( + maybe_cls: None = ..., + *, + these: dict[str, Any] | None = ..., + repr: bool = ..., + unsafe_hash: bool | 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: bool | None = ..., + order: bool | None = ..., + auto_detect: bool = ..., + getstate_setstate: bool | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + field_transformer: _FieldTransformer | None = ..., + match_args: bool = ..., +) -> Callable[[_C], _C]: ... + +mutable = define + +@overload +@dataclass_transform(frozen_default=True, field_specifiers=(attrib, field)) +def frozen( + maybe_cls: _C, + *, + these: dict[str, Any] | None = ..., + repr: bool = ..., + unsafe_hash: bool | 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: bool | None = ..., + order: bool | None = ..., + auto_detect: bool = ..., + getstate_setstate: bool | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + field_transformer: _FieldTransformer | None = ..., + match_args: bool = ..., +) -> _C: ... +@overload +@dataclass_transform(frozen_default=True, field_specifiers=(attrib, field)) +def frozen( + maybe_cls: None = ..., + *, + these: dict[str, Any] | None = ..., + repr: bool = ..., + unsafe_hash: bool | 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: bool | None = ..., + order: bool | None = ..., + auto_detect: bool = ..., + getstate_setstate: bool | None = ..., + on_setattr: _OnSetAttrArgType | None = ..., + field_transformer: _FieldTransformer | None = ..., + match_args: bool = ..., +) -> Callable[[_C], _C]: ... diff --git a/env/Lib/site-packages/attrs/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/attrs/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..86a70ece23e3675eaf22a628ef56580f7c46fa8b GIT binary patch literal 1356 zcmds#JBt)S5XXD=F|&``-Fxdje1ICP;vJ?Uf~WWZIRgcuS!nuZdiR=}npwJgmpdav zzk!08h$5zb3QwEN)E-Fv%teEo)VM(>TB@+~s$z05k9 z#md)j=Gj;or;Lwo%h=`S$hQQ@10@E^NsRSXX>A_+dJID`vN{|1Fj0M-DIcnFo{p8T z_O(hA9~Lj`o71;QbnNibKDZ)i>f})tFNq#%kzvo?*_uPO%j_#I z=SB$ZQpEZ2$mqeoL$@PDqHJt*kqR#&yvSoT>Ov@xIz_W7M5<$zSv9?P+NES-?8wXl zaGDmy;O)E+$BxeWxe#U*<(oR;1OZo#nJR(S&xC|ELX$8@SSLh;7NJ9E6E+C*gayJP zVTnNdYL*F`gcZUm#BTSjuh0jbM*OZ_lr2isD7KJS==rUps9lsT1pKXRQIU%IHWk?t znL2d1L)o-x>etV@D|#yQ7Ya!nO;DyZ!I}`61R5$1d$xi?ykkEwiv8TVb+z|6HwV3& zd4ikRI~W;>J1h2b*HhWJcVF-Itaj@1P{s#xplpxC*li(nrtvdx4Uc}-u0fuRQgz*2 z!IZR7b_Y2r2SG3imxI!T{ZF{af=i#+#Xp~~Z0FOzJ(KW!6Q^>Fr_tnoz&e}H;Kkj~ R?F(Pp7oIlhXSQ*czW}^jZWaIl literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/attrs/__pycache__/converters.cpython-311.pyc b/env/Lib/site-packages/attrs/__pycache__/converters.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e157c924f40deb3b2db132a7d0b8a2e39fb3370f GIT binary patch literal 219 zcmZ3^%ge<81Y2gGN%H~Hk3k$5V1hC}^8p#t8B!Qh7;_jx7*d#m88n$+f+RH=Z!v25 z0ZIPEl9D35IFOt literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/attrs/__pycache__/filters.cpython-311.pyc b/env/Lib/site-packages/attrs/__pycache__/filters.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..57e1aa49ba5898616575081f7c9dee8f3ce0bed1 GIT binary patch literal 213 zcmZ3^%ge<81Y2gGN%I8Kk3k$5V1hC}^8p#t8B!Qh7;_jx7*d#m88n$+f+RH=Z!v25 z0ZE?3l9D35w9K56)S}{*44*-gzZ_kxV#4!_vSXa{Q!?|?W3o$&5=-)n;*;`AVp8+U zVtg`_Vu~|MQgsUwld}`kQ;TCjrWET#jnONp{Ka9Do1apelWJGQ0W^^jh>InG#0O?Z UM#c|p42;qj7^IL<5gSkz05z#OUH||9 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/attrs/__pycache__/setters.cpython-311.pyc b/env/Lib/site-packages/attrs/__pycache__/setters.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f6caa89c862b39cc7c4816234e1700f77bdb87ee GIT binary patch literal 213 zcmZ3^%ge<81Y2gGN%I8Kk3k$5V1hC}^8p#t8B!Qh7;_jx7*d#m88n$+f+RH=Z!v25 z0ZE?3l9D35;?$Co)S}{*44*-gzZ_kxV#4!_vSXa{Q!?|?W3o$&5=-)n;*;`AVp8+U zVtg`_Vu~|MQgsUwld}`kQ;TCjrWET#jnONp{Ka9Do1apelWJGQ0W^^jh>InG#0O?Z UM#c|p42;qj7^IL<5gSkz07A$)fB*mh literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/attrs/__pycache__/validators.cpython-311.pyc b/env/Lib/site-packages/attrs/__pycache__/validators.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cab92468b9120da7ada21118408ffc4146a5a217 GIT binary patch literal 219 zcmZ3^%ge<81Y2gGN%H~Hk3k$5V1hC}^8p#t8B!Qh7;_jx7*d#m88n$+f+RH=Z!v25 z0ZIPEl9D35vc#Osl*E$!qT-bdpF#4!TwJVT!t;x=W1RC-GV{`7vP+9V^6^ReB{8Xa zWidXPNioHlC8@dviOJcC>8ZsrAcKna5hm#sRQ}?y$<0qG%}KQ@;s6@T2*kybK;i>4 VBO~JnHU>ty3k +Maintainer-email: team@aiohttp.org +License: Apache 2 +Project-URL: Chat: Matrix, https://matrix.to/#/#aio-libs:matrix.org +Project-URL: Chat: Matrix Space, https://matrix.to/#/#aio-libs-space:matrix.org +Project-URL: CI: Github Actions, https://github.com/aio-libs/frozenlist/actions +Project-URL: Code of Conduct, https://github.com/aio-libs/.github/blob/master/CODE_OF_CONDUCT.md +Project-URL: Coverage: codecov, https://codecov.io/github/aio-libs/frozenlist +Project-URL: Docs: Changelog, https://github.com/aio-libs/frozenlist/blob/master/CHANGES.rst#changelog +Project-URL: Docs: RTD, https://frozenlist.aio-libs.org +Project-URL: GitHub: issues, https://github.com/aio-libs/frozenlist/issues +Project-URL: GitHub: repo, https://github.com/aio-libs/frozenlist +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: Apache Software License +Classifier: Operating System :: POSIX +Classifier: Operating System :: MacOS :: MacOS X +Classifier: Operating System :: Microsoft :: Windows +Classifier: Programming Language :: Cython +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy +Requires-Python: >=3.8 +Description-Content-Type: text/x-rst +License-File: LICENSE + +frozenlist +========== + +.. image:: https://github.com/aio-libs/frozenlist/workflows/CI/badge.svg + :target: https://github.com/aio-libs/frozenlist/actions + :alt: GitHub status for master branch + +.. image:: https://codecov.io/gh/aio-libs/frozenlist/branch/master/graph/badge.svg + :target: https://codecov.io/gh/aio-libs/frozenlist + :alt: codecov.io status for master branch + +.. image:: https://img.shields.io/pypi/v/frozenlist.svg?logo=Python&logoColor=white + :target: https://pypi.org/project/frozenlist + :alt: frozenlist @ PyPI + +.. image:: https://readthedocs.org/projects/frozenlist/badge/?version=latest + :target: https://frozenlist.aio-libs.org + :alt: Read The Docs build status badge + +.. image:: https://img.shields.io/matrix/aio-libs:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat + :target: https://matrix.to/#/%23aio-libs:matrix.org + :alt: Matrix Room — #aio-libs:matrix.org + +.. image:: https://img.shields.io/matrix/aio-libs-space:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs-space%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat + :target: https://matrix.to/#/%23aio-libs-space:matrix.org + :alt: Matrix Space — #aio-libs-space:matrix.org + +Introduction +------------ + +``frozenlist.FrozenList`` is a list-like structure which implements +``collections.abc.MutableSequence``. The list is *mutable* until ``FrozenList.freeze`` +is called, after which list modifications raise ``RuntimeError``: + + +>>> from frozenlist import FrozenList +>>> fl = FrozenList([17, 42]) +>>> fl.append('spam') +>>> fl.append('Vikings') +>>> fl + +>>> fl.freeze() +>>> fl + +>>> fl.frozen +True +>>> fl.append("Monty") +Traceback (most recent call last): + File "", line 1, in + File "frozenlist/_frozenlist.pyx", line 97, in frozenlist._frozenlist.FrozenList.append + self._check_frozen() + File "frozenlist/_frozenlist.pyx", line 19, in frozenlist._frozenlist.FrozenList._check_frozen + raise RuntimeError("Cannot modify frozen list.") +RuntimeError: Cannot modify frozen list. + + +FrozenList is also hashable, but only when frozen. Otherwise it also throws a RuntimeError: + + +>>> fl = FrozenList([17, 42, 'spam']) +>>> hash(fl) +Traceback (most recent call last): + File "", line 1, in + File "frozenlist/_frozenlist.pyx", line 111, in frozenlist._frozenlist.FrozenList.__hash__ + raise RuntimeError("Cannot hash unfrozen list.") +RuntimeError: Cannot hash unfrozen list. +>>> fl.freeze() +>>> hash(fl) +3713081631934410656 +>>> dictionary = {fl: 'Vikings'} # frozen fl can be a dict key +>>> dictionary +{: 'Vikings'} + + +Installation +------------ + +:: + + $ pip install frozenlist + +The library requires Python 3.8 or newer. + + +Documentation +------------- + +https://frozenlist.aio-libs.org + +Communication channels +---------------------- + +We have a *Matrix Space* `#aio-libs-space:matrix.org +`_ which is +also accessible via Gitter. + +Requirements +------------ + +- Python >= 3.8 + +License +------- + +``frozenlist`` is offered under the Apache 2 license. + +Source code +----------- + +The project is hosted on GitHub_ + +Please file an issue in the `bug tracker +`_ if you have found a bug +or have some suggestions to improve the library. + +.. _GitHub: https://github.com/aio-libs/frozenlist + +========= +Changelog +========= + +.. + You should *NOT* be adding new change log entries to this file, this + file is managed by towncrier. You *may* edit previous change logs to + fix problems like typo corrections or such. + To add a new change log entry, please see + https://pip.pypa.io/en/latest/development/contributing/#news-entries + we named the news folder "changes". + + WARNING: Don't drop the next directive! + +.. towncrier release notes start + +1.4.1 (2023-12-15) +================== + +Packaging updates and notes for downstreams +------------------------------------------- + +- Declared Python 3.12 and PyPy 3.8-3.10 supported officially + in the distribution package metadata. + + + *Related issues and pull requests on GitHub:* + `#553 `__. + +- Replaced the packaging is replaced from an old-fashioned ``setup.py`` to an + in-tree `PEP 517 `__ build backend -- by `@webknjaz `__. + + Whenever the end-users or downstream packagers need to build ``frozenlist`` + from source (a Git checkout or an sdist), they may pass a ``config_settings`` + flag ``pure-python``. If this flag is not set, a C-extension will be built + and included into the distribution. + + Here is how this can be done with ``pip``: + + .. code-block:: console + + $ python3 -m pip install . --config-settings=pure-python= + + This will also work with ``-e | --editable``. + + The same can be achieved via ``pypa/build``: + + .. code-block:: console + + $ python3 -m build --config-setting=pure-python= + + Adding ``-w | --wheel`` can force ``pypa/build`` produce a wheel from source + directly, as opposed to building an ``sdist`` and then building from it. + + + *Related issues and pull requests on GitHub:* + `#560 `__. + + +Contributor-facing changes +-------------------------- + +- It is now possible to request line tracing in Cython builds using the + ``with-cython-tracing`` `PEP 517 `__ config setting + -- `@webknjaz `__. + + This can be used in CI and development environment to measure coverage + on Cython modules, but is not normally useful to the end-users or + downstream packagers. + + Here's a usage example: + + .. code-block:: console + + $ python3 -Im pip install . --config-settings=with-cython-tracing=true + + For editable installs, this setting is on by default. Otherwise, it's + off unless requested explicitly. + + The following produces C-files required for the Cython coverage + plugin to map the measurements back to the PYX-files: + + .. code-block:: console + + $ python -Im pip install -e . + + Alternatively, the ``FROZENLIST_CYTHON_TRACING=1`` environment variable + can be set to do the same as the `PEP 517 `__ config setting. + + + *Related issues and pull requests on GitHub:* + `#560 `__. + +- Coverage collection has been implemented for the Cython modules + -- by `@webknjaz `__. + + It will also be reported to Codecov from any non-release CI jobs. + + + *Related issues and pull requests on GitHub:* + `#561 `__. + +- A step-by-step ``Release Guide`` guide has + been added, describing how to release *frozenlist* -- by `@webknjaz `__. + + This is primarily targeting the maintainers. + + + *Related issues and pull requests on GitHub:* + `#563 `__. + +- Detailed ``Contributing Guidelines`` on + authoring the changelog fragments have been published in the + documentation -- by `@webknjaz `__. + + + *Related issues and pull requests on GitHub:* + `#564 `__. + + +---- + + +1.4.0 (2023-07-12) +================== + +The published source distribution package became buildable +under Python 3.12. + + +---- + + +Bugfixes +-------- + +- Removed an unused ``typing.Tuple`` import + `#411 `_ + + +Deprecations and Removals +------------------------- + +- Dropped Python 3.7 support. + `#413 `_ + + +Misc +---- + +- `#410 `_, `#433 `_ + + +---- + + +1.3.3 (2022-11-08) +================== + +- Fixed CI runs when creating a new release, where new towncrier versions + fail when the current version section is already present. + + +---- + + +1.3.2 (2022-11-08) +================== + +Misc +---- + +- Updated the CI runs to better check for test results and to avoid deprecated syntax. `#327 `_ + + +---- + + +1.3.1 (2022-08-02) +================== + +The published source distribution package became buildable +under Python 3.11. + + +---- + + +1.3.0 (2022-01-18) +================== + +Bugfixes +-------- + +- Do not install C sources with binary distributions. + `#250 `_ + + +Deprecations and Removals +------------------------- + +- Dropped Python 3.6 support + `#274 `_ + + +---- + + +1.2.0 (2021-10-16) +================== + +Features +-------- + +- ``FrozenList`` now supports being used as a generic type as per PEP 585, e.g. ``frozen_int_list: FrozenList[int]`` (requires Python 3.9 or newer). + `#172 `_ +- Added support for Python 3.10. + `#227 `_ +- Started shipping platform-specific wheels with the ``musl`` tag targeting typical Alpine Linux runtimes. + `#227 `_ +- Started shipping platform-specific arm64 wheels for Apple Silicon. + `#227 `_ + + +---- + + +1.1.1 (2020-11-14) +================== + +Bugfixes +-------- + +- Provide x86 Windows wheels. + `#169 `_ + + +---- + + +1.1.0 (2020-10-13) +================== + +Features +-------- + +- Add support for hashing of a frozen list. + `#136 `_ + +- Support Python 3.8 and 3.9. + +- Provide wheels for ``aarch64``, ``i686``, ``ppc64le``, ``s390x`` architectures on + Linux as well as ``x86_64``. + + +---- + + +1.0.0 (2019-11-09) +================== + +Deprecations and Removals +------------------------- + +- Dropped support for Python 3.5; only 3.6, 3.7 and 3.8 are supported going forward. + `#24 `_ diff --git a/env/Lib/site-packages/frozenlist-1.4.1.dist-info/RECORD b/env/Lib/site-packages/frozenlist-1.4.1.dist-info/RECORD new file mode 100644 index 0000000..6a206e6 --- /dev/null +++ b/env/Lib/site-packages/frozenlist-1.4.1.dist-info/RECORD @@ -0,0 +1,12 @@ +frozenlist-1.4.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +frozenlist-1.4.1.dist-info/LICENSE,sha256=b9UkPpLdf5jsacesN3co50kFcJ_1J6W_mNbQJjwE9bY,11332 +frozenlist-1.4.1.dist-info/METADATA,sha256=WdGawzRX-kmYknJIJ9gpGgcerMabLYAsSKg62FF8258,12556 +frozenlist-1.4.1.dist-info/RECORD,, +frozenlist-1.4.1.dist-info/WHEEL,sha256=badvNS-y9fEq0X-qzdZYvql_JFjI7Xfw-wR8FsjoK0I,102 +frozenlist-1.4.1.dist-info/top_level.txt,sha256=jivtxsPXA3nK3WBWW2LW5Mtu_GHt8UZA13NeCs2cKuA,11 +frozenlist/__init__.py,sha256=hrSQhfujMaz1BWlHfwuVFrPD02-pCK7jG4e9FaCZCmM,2316 +frozenlist/__init__.pyi,sha256=vMEoES1xGegPtVXoCi9XydEeHsyuIq-KdeXwP5PdsaA,1470 +frozenlist/__pycache__/__init__.cpython-311.pyc,, +frozenlist/_frozenlist.cp311-win_amd64.pyd,sha256=D3U4RBwWaCSGGO4V0RQUzmhkLCy90WNrkD7O-s-IZS0,86016 +frozenlist/_frozenlist.pyx,sha256=9V4Z1En6TZwgFD26d-sjxyhUzUm338H1Qiz4-i5ukv0,2983 +frozenlist/py.typed,sha256=sow9soTwP9T_gEAQSVh7Gb8855h04Nwmhs2We-JRgZM,7 diff --git a/env/Lib/site-packages/frozenlist-1.4.1.dist-info/WHEEL b/env/Lib/site-packages/frozenlist-1.4.1.dist-info/WHEEL new file mode 100644 index 0000000..6d16045 --- /dev/null +++ b/env/Lib/site-packages/frozenlist-1.4.1.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.41.2) +Root-Is-Purelib: false +Tag: cp311-cp311-win_amd64 + diff --git a/env/Lib/site-packages/frozenlist-1.4.1.dist-info/top_level.txt b/env/Lib/site-packages/frozenlist-1.4.1.dist-info/top_level.txt new file mode 100644 index 0000000..52f13fc --- /dev/null +++ b/env/Lib/site-packages/frozenlist-1.4.1.dist-info/top_level.txt @@ -0,0 +1 @@ +frozenlist diff --git a/env/Lib/site-packages/frozenlist/__init__.py b/env/Lib/site-packages/frozenlist/__init__.py new file mode 100644 index 0000000..c0f7136 --- /dev/null +++ b/env/Lib/site-packages/frozenlist/__init__.py @@ -0,0 +1,95 @@ +import os +import sys +import types +from collections.abc import MutableSequence +from functools import total_ordering +from typing import Type + +__version__ = "1.4.1" + +__all__ = ("FrozenList", "PyFrozenList") # type: Tuple[str, ...] + + +NO_EXTENSIONS = bool(os.environ.get("FROZENLIST_NO_EXTENSIONS")) # type: bool + + +@total_ordering +class FrozenList(MutableSequence): + __slots__ = ("_frozen", "_items") + + if sys.version_info >= (3, 9): + __class_getitem__ = classmethod(types.GenericAlias) + else: + + @classmethod + def __class_getitem__(cls: Type["FrozenList"]) -> Type["FrozenList"]: + return cls + + def __init__(self, items=None): + self._frozen = False + if items is not None: + items = list(items) + else: + items = [] + self._items = items + + @property + def frozen(self): + return self._frozen + + def freeze(self): + self._frozen = True + + def __getitem__(self, index): + return self._items[index] + + def __setitem__(self, index, value): + if self._frozen: + raise RuntimeError("Cannot modify frozen list.") + self._items[index] = value + + def __delitem__(self, index): + if self._frozen: + raise RuntimeError("Cannot modify frozen list.") + del self._items[index] + + def __len__(self): + return self._items.__len__() + + def __iter__(self): + return self._items.__iter__() + + def __reversed__(self): + return self._items.__reversed__() + + def __eq__(self, other): + return list(self) == other + + def __le__(self, other): + return list(self) <= other + + def insert(self, pos, item): + if self._frozen: + raise RuntimeError("Cannot modify frozen list.") + self._items.insert(pos, item) + + def __repr__(self): + return f"" + + def __hash__(self): + if self._frozen: + return hash(tuple(self)) + else: + raise RuntimeError("Cannot hash unfrozen list.") + + +PyFrozenList = FrozenList + + +if not NO_EXTENSIONS: + try: + from ._frozenlist import FrozenList as CFrozenList # type: ignore + except ImportError: # pragma: no cover + pass + else: + FrozenList = CFrozenList # type: ignore diff --git a/env/Lib/site-packages/frozenlist/__init__.pyi b/env/Lib/site-packages/frozenlist/__init__.pyi new file mode 100644 index 0000000..ae803ef --- /dev/null +++ b/env/Lib/site-packages/frozenlist/__init__.pyi @@ -0,0 +1,47 @@ +from typing import ( + Generic, + Iterable, + Iterator, + List, + MutableSequence, + Optional, + TypeVar, + Union, + overload, +) + +_T = TypeVar("_T") +_Arg = Union[List[_T], Iterable[_T]] + +class FrozenList(MutableSequence[_T], Generic[_T]): + def __init__(self, items: Optional[_Arg[_T]] = None) -> None: ... + @property + def frozen(self) -> bool: ... + def freeze(self) -> None: ... + @overload + def __getitem__(self, i: int) -> _T: ... + @overload + def __getitem__(self, s: slice) -> FrozenList[_T]: ... + @overload + def __setitem__(self, i: int, o: _T) -> None: ... + @overload + def __setitem__(self, s: slice, o: Iterable[_T]) -> None: ... + @overload + def __delitem__(self, i: int) -> None: ... + @overload + def __delitem__(self, i: slice) -> None: ... + def __len__(self) -> int: ... + def __iter__(self) -> Iterator[_T]: ... + def __reversed__(self) -> Iterator[_T]: ... + def __eq__(self, other: object) -> bool: ... + def __le__(self, other: FrozenList[_T]) -> bool: ... + def __ne__(self, other: object) -> bool: ... + def __lt__(self, other: FrozenList[_T]) -> bool: ... + def __ge__(self, other: FrozenList[_T]) -> bool: ... + def __gt__(self, other: FrozenList[_T]) -> bool: ... + def insert(self, pos: int, item: _T) -> None: ... + def __repr__(self) -> str: ... + def __hash__(self) -> int: ... + +# types for C accelerators are the same +CFrozenList = PyFrozenList = FrozenList diff --git a/env/Lib/site-packages/frozenlist/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/frozenlist/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5b01b9653613184a470b2c6e1c93c493581ca81e GIT binary patch literal 4773 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 A(f|Me literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/frozenlist/_frozenlist.cp311-win_amd64.pyd b/env/Lib/site-packages/frozenlist/_frozenlist.cp311-win_amd64.pyd new file mode 100644 index 0000000000000000000000000000000000000000..932a629483223fe4bc374491b47347cbbc22ca2b GIT binary patch literal 86016 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/frozenlist/_frozenlist.pyx b/env/Lib/site-packages/frozenlist/_frozenlist.pyx new file mode 100644 index 0000000..9ee846c --- /dev/null +++ b/env/Lib/site-packages/frozenlist/_frozenlist.pyx @@ -0,0 +1,123 @@ +import sys +import types +from collections.abc import MutableSequence + + +cdef class FrozenList: + + if sys.version_info >= (3, 9): + __class_getitem__ = classmethod(types.GenericAlias) + else: + @classmethod + def __class_getitem__(cls): + return cls + + cdef readonly bint frozen + cdef list _items + + def __init__(self, items=None): + self.frozen = False + if items is not None: + items = list(items) + else: + items = [] + self._items = items + + cdef object _check_frozen(self): + if self.frozen: + raise RuntimeError("Cannot modify frozen list.") + + cdef inline object _fast_len(self): + return len(self._items) + + def freeze(self): + self.frozen = True + + def __getitem__(self, index): + return self._items[index] + + def __setitem__(self, index, value): + self._check_frozen() + self._items[index] = value + + def __delitem__(self, index): + self._check_frozen() + del self._items[index] + + def __len__(self): + return self._fast_len() + + def __iter__(self): + return self._items.__iter__() + + def __reversed__(self): + return self._items.__reversed__() + + def __richcmp__(self, other, op): + if op == 0: # < + return list(self) < other + if op == 1: # <= + return list(self) <= other + if op == 2: # == + return list(self) == other + if op == 3: # != + return list(self) != other + if op == 4: # > + return list(self) > other + if op == 5: # => + return list(self) >= other + + def insert(self, pos, item): + self._check_frozen() + self._items.insert(pos, item) + + def __contains__(self, item): + return item in self._items + + def __iadd__(self, items): + self._check_frozen() + self._items += list(items) + return self + + def index(self, item): + return self._items.index(item) + + def remove(self, item): + self._check_frozen() + self._items.remove(item) + + def clear(self): + self._check_frozen() + self._items.clear() + + def extend(self, items): + self._check_frozen() + self._items += list(items) + + def reverse(self): + self._check_frozen() + self._items.reverse() + + def pop(self, index=-1): + self._check_frozen() + return self._items.pop(index) + + def append(self, item): + self._check_frozen() + return self._items.append(item) + + def count(self, item): + return self._items.count(item) + + def __repr__(self): + return ''.format(self.frozen, + self._items) + + def __hash__(self): + if self.frozen: + return hash(tuple(self._items)) + else: + raise RuntimeError("Cannot hash unfrozen list.") + + +MutableSequence.register(FrozenList) diff --git a/env/Lib/site-packages/frozenlist/py.typed b/env/Lib/site-packages/frozenlist/py.typed new file mode 100644 index 0000000..f5642f7 --- /dev/null +++ b/env/Lib/site-packages/frozenlist/py.typed @@ -0,0 +1 @@ +Marker diff --git a/env/Lib/site-packages/logging-0.4.9.6.dist-info/INSTALLER b/env/Lib/site-packages/logging-0.4.9.6.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/Lib/site-packages/logging-0.4.9.6.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/Lib/site-packages/logging-0.4.9.6.dist-info/LICENSE b/env/Lib/site-packages/logging-0.4.9.6.dist-info/LICENSE new file mode 100644 index 0000000..f640612 --- /dev/null +++ b/env/Lib/site-packages/logging-0.4.9.6.dist-info/LICENSE @@ -0,0 +1,16 @@ +Copyright (C) 2001-2005 by Vinay Sajip. All Rights Reserved. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation, and that the name of Vinay Sajip +not be used in advertising or publicity pertaining to distribution +of the software without specific, written prior permission. + +VINAY SAJIP DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING +ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL +VINAY SAJIP BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR +ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN +AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR +IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. \ No newline at end of file diff --git a/env/Lib/site-packages/logging-0.4.9.6.dist-info/METADATA b/env/Lib/site-packages/logging-0.4.9.6.dist-info/METADATA new file mode 100644 index 0000000..d60350b --- /dev/null +++ b/env/Lib/site-packages/logging-0.4.9.6.dist-info/METADATA @@ -0,0 +1,13 @@ +Metadata-Version: 2.1 +Name: logging +Version: 0.4.9.6 +Summary: A logging module for Python +Home-page: http://www.red-dove.com/python_logging.html +Author: Vinay Sajip +Author-email: vinay_sajip@red-dove.com +Maintainer: Vinay Sajip +Maintainer-email: vinay_sajip@red-dove.com +License: Copyright (C) 2001-2005 by Vinay Sajip. All Rights Reserved. See LICENSE for license. +License-File: LICENSE + +This module is intended to provide a standard error logging mechanism in Python as per PEP 282. diff --git a/env/Lib/site-packages/logging-0.4.9.6.dist-info/RECORD b/env/Lib/site-packages/logging-0.4.9.6.dist-info/RECORD new file mode 100644 index 0000000..fa93eb2 --- /dev/null +++ b/env/Lib/site-packages/logging-0.4.9.6.dist-info/RECORD @@ -0,0 +1,10 @@ +logging-0.4.9.6.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +logging-0.4.9.6.dist-info/LICENSE,sha256=jDH3McOJRccqR8zpa7TxggOa7J_Eqxsb8ccQrsWrPWI,976 +logging-0.4.9.6.dist-info/METADATA,sha256=XamZiq6Q-8gKsgcMAIyCtoLieQgYAP-TuxnFiIEcm-o,498 +logging-0.4.9.6.dist-info/RECORD,, +logging-0.4.9.6.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +logging-0.4.9.6.dist-info/WHEEL,sha256=Mdi9PDNwEZptOjTlUcAth7XJDFtKrHYaQMPulZeBCiQ,91 +logging-0.4.9.6.dist-info/top_level.txt,sha256=FIW2azcr5UzjdGze4ZuTamcDal2-CqKXgyxDBgqvAUY,8 +logging/__init__.py,sha256=6erb1Z4E8EwYvCk1NbK42hpMnYWQJEkWzofunY15Eso,46591 +logging/config.py,sha256=VtIiA8ojwWlLbOfydvKg8O6b8mzwnS6eJCu_W1h44Zs,12586 +logging/handlers.py,sha256=9_soecQk7mcyh6DO3tvaUF2XhSbeeIPXaWrdxFma6U0,37073 diff --git a/env/Lib/site-packages/logging-0.4.9.6.dist-info/REQUESTED b/env/Lib/site-packages/logging-0.4.9.6.dist-info/REQUESTED new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/logging-0.4.9.6.dist-info/WHEEL b/env/Lib/site-packages/logging-0.4.9.6.dist-info/WHEEL new file mode 100644 index 0000000..50e1e84 --- /dev/null +++ b/env/Lib/site-packages/logging-0.4.9.6.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (73.0.1) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/env/Lib/site-packages/logging-0.4.9.6.dist-info/top_level.txt b/env/Lib/site-packages/logging-0.4.9.6.dist-info/top_level.txt new file mode 100644 index 0000000..a694f50 --- /dev/null +++ b/env/Lib/site-packages/logging-0.4.9.6.dist-info/top_level.txt @@ -0,0 +1 @@ +logging diff --git a/env/Lib/site-packages/logging/__init__.py b/env/Lib/site-packages/logging/__init__.py new file mode 100644 index 0000000..0c23e82 --- /dev/null +++ b/env/Lib/site-packages/logging/__init__.py @@ -0,0 +1,1327 @@ +# Copyright 2001-2005 by Vinay Sajip. All Rights Reserved. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose and without fee is hereby granted, +# provided that the above copyright notice appear in all copies and that +# both that copyright notice and this permission notice appear in +# supporting documentation, and that the name of Vinay Sajip +# not be used in advertising or publicity pertaining to distribution +# of the software without specific, written prior permission. +# VINAY SAJIP DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING +# ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL +# VINAY SAJIP BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR +# ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER +# IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT +# OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + +""" +Logging package for Python. Based on PEP 282 and comments thereto in +comp.lang.python, and influenced by Apache's log4j system. + +Should work under Python versions >= 1.5.2, except that source line +information is not available unless 'sys._getframe()' is. + +Copyright (C) 2001-2004 Vinay Sajip. All Rights Reserved. + +To use, simply 'import logging' and log away! +""" + +import sys, os, types, time, string, cStringIO + +try: + import codecs +except ImportError: + codecs = None + +try: + import thread + import threading +except ImportError: + thread = None + +__author__ = "Vinay Sajip " +__status__ = "beta" +__version__ = "0.4.9.6" +__date__ = "02 March 2005" + +#--------------------------------------------------------------------------- +# Miscellaneous module data +#--------------------------------------------------------------------------- + +# +# _srcfile is used when walking the stack to check when we've got the first +# caller stack frame. +# +if string.lower(__file__[-4:]) in ['.pyc', '.pyo']: + _srcfile = __file__[:-4] + '.py' +else: + _srcfile = __file__ +_srcfile = os.path.normcase(_srcfile) + +# next bit filched from 1.5.2's inspect.py +def currentframe(): + """Return the frame object for the caller's stack frame.""" + try: + raise 'catch me' + except: + return sys.exc_traceback.tb_frame.f_back + +if hasattr(sys, '_getframe'): currentframe = sys._getframe +# done filching + +# _srcfile is only used in conjunction with sys._getframe(). +# To provide compatibility with older versions of Python, set _srcfile +# to None if _getframe() is not available; this value will prevent +# findCaller() from being called. +#if not hasattr(sys, "_getframe"): +# _srcfile = None + +# +#_startTime is used as the base when calculating the relative time of events +# +_startTime = time.time() + +# +#raiseExceptions is used to see if exceptions during handling should be +#propagated +# +raiseExceptions = 1 + +#--------------------------------------------------------------------------- +# Level related stuff +#--------------------------------------------------------------------------- +# +# Default levels and level names, these can be replaced with any positive set +# of values having corresponding names. There is a pseudo-level, NOTSET, which +# is only really there as a lower limit for user-defined levels. Handlers and +# loggers are initialized with NOTSET so that they will log all messages, even +# at user-defined levels. +# + +CRITICAL = 50 +FATAL = CRITICAL +ERROR = 40 +WARNING = 30 +WARN = WARNING +INFO = 20 +DEBUG = 10 +NOTSET = 0 + +_levelNames = { + CRITICAL : 'CRITICAL', + ERROR : 'ERROR', + WARNING : 'WARNING', + INFO : 'INFO', + DEBUG : 'DEBUG', + NOTSET : 'NOTSET', + 'CRITICAL' : CRITICAL, + 'ERROR' : ERROR, + 'WARN' : WARNING, + 'WARNING' : WARNING, + 'INFO' : INFO, + 'DEBUG' : DEBUG, + 'NOTSET' : NOTSET, +} + +def getLevelName(level): + """ + Return the textual representation of logging level 'level'. + + If the level is one of the predefined levels (CRITICAL, ERROR, WARNING, + INFO, DEBUG) then you get the corresponding string. If you have + associated levels with names using addLevelName then the name you have + associated with 'level' is returned. + + If a numeric value corresponding to one of the defined levels is passed + in, the corresponding string representation is returned. + + Otherwise, the string "Level %s" % level is returned. + """ + return _levelNames.get(level, ("Level %s" % level)) + +def addLevelName(level, levelName): + """ + Associate 'levelName' with 'level'. + + This is used when converting levels to text during message formatting. + """ + _acquireLock() + try: #unlikely to cause an exception, but you never know... + _levelNames[level] = levelName + _levelNames[levelName] = level + finally: + _releaseLock() + +#--------------------------------------------------------------------------- +# Thread-related stuff +#--------------------------------------------------------------------------- + +# +#_lock is used to serialize access to shared data structures in this module. +#This needs to be an RLock because fileConfig() creates Handlers and so +#might arbitrary user threads. Since Handler.__init__() updates the shared +#dictionary _handlers, it needs to acquire the lock. But if configuring, +#the lock would already have been acquired - so we need an RLock. +#The same argument applies to Loggers and Manager.loggerDict. +# +_lock = None + +def _acquireLock(): + """ + Acquire the module-level lock for serializing access to shared data. + + This should be released with _releaseLock(). + """ + global _lock + if (not _lock) and thread: + _lock = threading.RLock() + if _lock: + _lock.acquire() + +def _releaseLock(): + """ + Release the module-level lock acquired by calling _acquireLock(). + """ + if _lock: + _lock.release() + +#--------------------------------------------------------------------------- +# The logging record +#--------------------------------------------------------------------------- + +class LogRecord: + """ + A LogRecord instance represents an event being logged. + + LogRecord instances are created every time something is logged. They + contain all the information pertinent to the event being logged. The + main information passed in is in msg and args, which are combined + using str(msg) % args to create the message field of the record. The + record also includes information such as when the record was created, + the source line where the logging call was made, and any exception + information to be logged. + """ + def __init__(self, name, level, pathname, lineno, msg, args, exc_info): + """ + Initialize a logging record with interesting information. + """ + ct = time.time() + self.name = name + self.msg = msg + # + # The following statement allows passing of a dictionary as a sole + # argument, so that you can do something like + # logging.debug("a %(a)d b %(b)s", {'a':1, 'b':2}) + # Suggested by Stefan Behnel. + # Note that without the test for args[0], we get a problem because + # during formatting, we test to see if the arg is present using + # 'if self.args:'. If the event being logged is e.g. 'Value is %d' + # and if the passed arg fails 'if self.args:' then no formatting + # is done. For example, logger.warn('Value is %d', 0) would log + # 'Value is %d' instead of 'Value is 0'. + # For the use case of passing a dictionary, this should not be a + # problem. + if args and (len(args) == 1) and args[0] and (type(args[0]) == types.DictType): + args = args[0] + self.args = args + self.levelname = getLevelName(level) + self.levelno = level + self.pathname = pathname + try: + self.filename = os.path.basename(pathname) + self.module = os.path.splitext(self.filename)[0] + except: + self.filename = pathname + self.module = "Unknown module" + self.exc_info = exc_info + self.exc_text = None # used to cache the traceback text + self.lineno = lineno + self.created = ct + self.msecs = (ct - long(ct)) * 1000 + self.relativeCreated = (self.created - _startTime) * 1000 + if thread: + self.thread = thread.get_ident() + else: + self.thread = None + if hasattr(os, 'getpid'): + self.process = os.getpid() + else: + self.process = None + + def __str__(self): + return ''%(self.name, self.levelno, + self.pathname, self.lineno, self.msg) + + def getMessage(self): + """ + Return the message for this LogRecord. + + Return the message for this LogRecord after merging any user-supplied + arguments with the message. + """ + if not hasattr(types, "UnicodeType"): #if no unicode support... + msg = str(self.msg) + else: + try: + msg = str(self.msg) + except UnicodeError: + msg = self.msg #Defer encoding till later + if self.args: + msg = msg % self.args + return msg + +def makeLogRecord(dict): + """ + Make a LogRecord whose attributes are defined by the specified dictionary, + This function is useful for converting a logging event received over + a socket connection (which is sent as a dictionary) into a LogRecord + instance. + """ + rv = LogRecord(None, None, "", 0, "", (), None) + rv.__dict__.update(dict) + return rv + +#--------------------------------------------------------------------------- +# Formatter classes and functions +#--------------------------------------------------------------------------- + +class Formatter: + """ + Formatter instances are used to convert a LogRecord to text. + + Formatters need to know how a LogRecord is constructed. They are + responsible for converting a LogRecord to (usually) a string which can + be interpreted by either a human or an external system. The base Formatter + allows a formatting string to be specified. If none is supplied, the + default value of "%s(message)\\n" is used. + + The Formatter can be initialized with a format string which makes use of + knowledge of the LogRecord attributes - e.g. the default value mentioned + above makes use of the fact that the user's message and arguments are pre- + formatted into a LogRecord's message attribute. Currently, the useful + attributes in a LogRecord are described by: + + %(name)s Name of the logger (logging channel) + %(levelno)s Numeric logging level for the message (DEBUG, INFO, + WARNING, ERROR, CRITICAL) + %(levelname)s Text logging level for the message ("DEBUG", "INFO", + "WARNING", "ERROR", "CRITICAL") + %(pathname)s Full pathname of the source file where the logging + call was issued (if available) + %(filename)s Filename portion of pathname + %(module)s Module (name portion of filename) + %(lineno)d Source line number where the logging call was issued + (if available) + %(created)f Time when the LogRecord was created (time.time() + return value) + %(asctime)s Textual time when the LogRecord was created + %(msecs)d Millisecond portion of the creation time + %(relativeCreated)d Time in milliseconds when the LogRecord was created, + relative to the time the logging module was loaded + (typically at application startup time) + %(thread)d Thread ID (if available) + %(process)d Process ID (if available) + %(message)s The result of record.getMessage(), computed just as + the record is emitted + """ + + converter = time.localtime + + def __init__(self, fmt=None, datefmt=None): + """ + Initialize the formatter with specified format strings. + + Initialize the formatter either with the specified format string, or a + default as described above. Allow for specialized date formatting with + the optional datefmt argument (if omitted, you get the ISO8601 format). + """ + if fmt: + self._fmt = fmt + else: + self._fmt = "%(message)s" + self.datefmt = datefmt + + def formatTime(self, record, datefmt=None): + """ + Return the creation time of the specified LogRecord as formatted text. + + This method should be called from format() by a formatter which + wants to make use of a formatted time. This method can be overridden + in formatters to provide for any specific requirement, but the + basic behaviour is as follows: if datefmt (a string) is specified, + it is used with time.strftime() to format the creation time of the + record. Otherwise, the ISO8601 format is used. The resulting + string is returned. This function uses a user-configurable function + to convert the creation time to a tuple. By default, time.localtime() + is used; to change this for a particular formatter instance, set the + 'converter' attribute to a function with the same signature as + time.localtime() or time.gmtime(). To change it for all formatters, + for example if you want all logging times to be shown in GMT, + set the 'converter' attribute in the Formatter class. + """ + ct = self.converter(record.created) + if datefmt: + s = time.strftime(datefmt, ct) + else: + t = time.strftime("%Y-%m-%d %H:%M:%S", ct) + s = "%s,%03d" % (t, record.msecs) + return s + + def formatException(self, ei): + """ + Format and return the specified exception information as a string. + + This default implementation just uses + traceback.print_exception() + """ + import traceback + sio = cStringIO.StringIO() + traceback.print_exception(ei[0], ei[1], ei[2], None, sio) + s = sio.getvalue() + sio.close() + if s[-1] == "\n": + s = s[:-1] + return s + + def format(self, record): + """ + Format the specified record as text. + + The record's attribute dictionary is used as the operand to a + string formatting operation which yields the returned string. + Before formatting the dictionary, a couple of preparatory steps + are carried out. The message attribute of the record is computed + using LogRecord.getMessage(). If the formatting string contains + "%(asctime)", formatTime() is called to format the event time. + If there is exception information, it is formatted using + formatException() and appended to the message. + """ + record.message = record.getMessage() + if string.find(self._fmt,"%(asctime)") >= 0: + record.asctime = self.formatTime(record, self.datefmt) + s = self._fmt % record.__dict__ + if record.exc_info: + # Cache the traceback text to avoid converting it multiple times + # (it's constant anyway) + if not record.exc_text: + record.exc_text = self.formatException(record.exc_info) + if record.exc_text: + if s[-1] != "\n": + s = s + "\n" + s = s + record.exc_text + return s + +# +# The default formatter to use when no other is specified +# +_defaultFormatter = Formatter() + +class BufferingFormatter: + """ + A formatter suitable for formatting a number of records. + """ + def __init__(self, linefmt=None): + """ + Optionally specify a formatter which will be used to format each + individual record. + """ + if linefmt: + self.linefmt = linefmt + else: + self.linefmt = _defaultFormatter + + def formatHeader(self, records): + """ + Return the header string for the specified records. + """ + return "" + + def formatFooter(self, records): + """ + Return the footer string for the specified records. + """ + return "" + + def format(self, records): + """ + Format the specified records and return the result as a string. + """ + rv = "" + if len(records) > 0: + rv = rv + self.formatHeader(records) + for record in records: + rv = rv + self.linefmt.format(record) + rv = rv + self.formatFooter(records) + return rv + +#--------------------------------------------------------------------------- +# Filter classes and functions +#--------------------------------------------------------------------------- + +class Filter: + """ + Filter instances are used to perform arbitrary filtering of LogRecords. + + Loggers and Handlers can optionally use Filter instances to filter + records as desired. The base filter class only allows events which are + below a certain point in the logger hierarchy. For example, a filter + initialized with "A.B" will allow events logged by loggers "A.B", + "A.B.C", "A.B.C.D", "A.B.D" etc. but not "A.BB", "B.A.B" etc. If + initialized with the empty string, all events are passed. + """ + def __init__(self, name=''): + """ + Initialize a filter. + + Initialize with the name of the logger which, together with its + children, will have its events allowed through the filter. If no + name is specified, allow every event. + """ + self.name = name + self.nlen = len(name) + + def filter(self, record): + """ + Determine if the specified record is to be logged. + + Is the specified record to be logged? Returns 0 for no, nonzero for + yes. If deemed appropriate, the record may be modified in-place. + """ + if self.nlen == 0: + return 1 + elif self.name == record.name: + return 1 + elif string.find(record.name, self.name, 0, self.nlen) != 0: + return 0 + return (record.name[self.nlen] == ".") + +class Filterer: + """ + A base class for loggers and handlers which allows them to share + common code. + """ + def __init__(self): + """ + Initialize the list of filters to be an empty list. + """ + self.filters = [] + + def addFilter(self, filter): + """ + Add the specified filter to this handler. + """ + if not (filter in self.filters): + self.filters.append(filter) + + def removeFilter(self, filter): + """ + Remove the specified filter from this handler. + """ + if filter in self.filters: + self.filters.remove(filter) + + def filter(self, record): + """ + Determine if a record is loggable by consulting all the filters. + + The default is to allow the record to be logged; any filter can veto + this and the record is then dropped. Returns a zero value if a record + is to be dropped, else non-zero. + """ + rv = 1 + for f in self.filters: + if not f.filter(record): + rv = 0 + break + return rv + +#--------------------------------------------------------------------------- +# Handler classes and functions +#--------------------------------------------------------------------------- + +_handlers = {} #repository of handlers (for flushing when shutdown called) + +class Handler(Filterer): + """ + Handler instances dispatch logging events to specific destinations. + + The base handler class. Acts as a placeholder which defines the Handler + interface. Handlers can optionally use Formatter instances to format + records as desired. By default, no formatter is specified; in this case, + the 'raw' message as determined by record.message is logged. + """ + def __init__(self, level=NOTSET): + """ + Initializes the instance - basically setting the formatter to None + and the filter list to empty. + """ + Filterer.__init__(self) + self.level = level + self.formatter = None + #get the module data lock, as we're updating a shared structure. + _acquireLock() + try: #unlikely to raise an exception, but you never know... + _handlers[self] = 1 + finally: + _releaseLock() + self.createLock() + + def createLock(self): + """ + Acquire a thread lock for serializing access to the underlying I/O. + """ + if thread: + self.lock = thread.allocate_lock() + else: + self.lock = None + + def acquire(self): + """ + Acquire the I/O thread lock. + """ + if self.lock: + self.lock.acquire() + + def release(self): + """ + Release the I/O thread lock. + """ + if self.lock: + self.lock.release() + + def setLevel(self, level): + """ + Set the logging level of this handler. + """ + self.level = level + + def format(self, record): + """ + Format the specified record. + + If a formatter is set, use it. Otherwise, use the default formatter + for the module. + """ + if self.formatter: + fmt = self.formatter + else: + fmt = _defaultFormatter + return fmt.format(record) + + def emit(self, record): + """ + Do whatever it takes to actually log the specified logging record. + + This version is intended to be implemented by subclasses and so + raises a NotImplementedError. + """ + raise NotImplementedError, 'emit must be implemented '\ + 'by Handler subclasses' + + def handle(self, record): + """ + Conditionally emit the specified logging record. + + Emission depends on filters which may have been added to the handler. + Wrap the actual emission of the record with acquisition/release of + the I/O thread lock. Returns whether the filter passed the record for + emission. + """ + rv = self.filter(record) + if rv: + self.acquire() + try: + self.emit(record) + finally: + self.release() + return rv + + def setFormatter(self, fmt): + """ + Set the formatter for this handler. + """ + self.formatter = fmt + + def flush(self): + """ + Ensure all logging output has been flushed. + + This version does nothing and is intended to be implemented by + subclasses. + """ + pass + + def close(self): + """ + Tidy up any resources used by the handler. + + This version does removes the handler from an internal list + of handlers which is closed when shutdown() is called. Subclasses + should ensure that this gets called from overridden close() + methods. + """ + #get the module data lock, as we're updating a shared structure. + _acquireLock() + try: #unlikely to raise an exception, but you never know... + del _handlers[self] + finally: + _releaseLock() + + def handleError(self, record): + """ + Handle errors which occur during an emit() call. + + This method should be called from handlers when an exception is + encountered during an emit() call. If raiseExceptions is false, + exceptions get silently ignored. This is what is mostly wanted + for a logging system - most users will not care about errors in + the logging system, they are more interested in application errors. + You could, however, replace this with a custom handler if you wish. + The record which was being processed is passed in to this method. + """ + if raiseExceptions: + import traceback + ei = sys.exc_info() + traceback.print_exception(ei[0], ei[1], ei[2], None, sys.stderr) + del ei + +class StreamHandler(Handler): + """ + A handler class which writes logging records, appropriately formatted, + to a stream. Note that this class does not close the stream, as + sys.stdout or sys.stderr may be used. + """ + def __init__(self, strm=None): + """ + Initialize the handler. + + If strm is not specified, sys.stderr is used. + """ + Handler.__init__(self) + if not strm: + strm = sys.stderr + self.stream = strm + self.formatter = None + + def flush(self): + """ + Flushes the stream. + """ + self.stream.flush() + + def emit(self, record): + """ + Emit a record. + + If a formatter is specified, it is used to format the record. + The record is then written to the stream with a trailing newline + [N.B. this may be removed depending on feedback]. If exception + information is present, it is formatted using + traceback.print_exception and appended to the stream. + """ + try: + msg = self.format(record) + fs = "%s\n" + if not hasattr(types, "UnicodeType"): #if no unicode support... + self.stream.write(fs % msg) + else: + try: + self.stream.write(fs % msg) + except UnicodeError: + self.stream.write(fs % msg.encode("UTF-8")) + self.flush() + except: + self.handleError(record) + +class FileHandler(StreamHandler): + """ + A handler class which writes formatted logging records to disk files. + """ + def __init__(self, filename, mode='a', encoding=None): + """ + Open the specified file and use it as the stream for logging. + """ + if codecs is None: + encoding = None + if encoding is None: + stream = open(filename, mode) + else: + stream = codecs.open(filename, mode, encoding) + StreamHandler.__init__(self, stream) + #keep the absolute path, otherwise derived classes which use this + #may come a cropper when the current directory changes + self.baseFilename = os.path.abspath(filename) + self.mode = mode + + def close(self): + """ + Closes the stream. + """ + self.flush() + self.stream.close() + StreamHandler.close(self) + +#--------------------------------------------------------------------------- +# Manager classes and functions +#--------------------------------------------------------------------------- + +class PlaceHolder: + """ + PlaceHolder instances are used in the Manager logger hierarchy to take + the place of nodes for which no loggers have been defined. This class is + intended for internal use only and not as part of the public API. + """ + def __init__(self, alogger): + """ + Initialize with the specified logger being a child of this placeholder. + """ + self.loggers = [alogger] + + def append(self, alogger): + """ + Add the specified logger as a child of this placeholder. + """ + if alogger not in self.loggers: + self.loggers.append(alogger) + +# +# Determine which class to use when instantiating loggers. +# +_loggerClass = None + +def setLoggerClass(klass): + """ + Set the class to be used when instantiating a logger. The class should + define __init__() such that only a name argument is required, and the + __init__() should call Logger.__init__() + """ + if klass != Logger: + if not issubclass(klass, Logger): + raise TypeError, "logger not derived from logging.Logger: " + \ + klass.__name__ + global _loggerClass + _loggerClass = klass + +def getLoggerClass(): + """ + Return the class to be used when instantiating a logger. + """ + + return _loggerClass + +class Manager: + """ + There is [under normal circumstances] just one Manager instance, which + holds the hierarchy of loggers. + """ + def __init__(self, rootnode): + """ + Initialize the manager with the root node of the logger hierarchy. + """ + self.root = rootnode + self.disable = 0 + self.emittedNoHandlerWarning = 0 + self.loggerDict = {} + + def getLogger(self, name): + """ + Get a logger with the specified name (channel name), creating it + if it doesn't yet exist. This name is a dot-separated hierarchical + name, such as "a", "a.b", "a.b.c" or similar. + + If a PlaceHolder existed for the specified name [i.e. the logger + didn't exist but a child of it did], replace it with the created + logger and fix up the parent/child references which pointed to the + placeholder to now point to the logger. + """ + rv = None + _acquireLock() + try: + if self.loggerDict.has_key(name): + rv = self.loggerDict[name] + if isinstance(rv, PlaceHolder): + ph = rv + rv = _loggerClass(name) + rv.manager = self + self.loggerDict[name] = rv + self._fixupChildren(ph, rv) + self._fixupParents(rv) + else: + rv = _loggerClass(name) + rv.manager = self + self.loggerDict[name] = rv + self._fixupParents(rv) + finally: + _releaseLock() + return rv + + def _fixupParents(self, alogger): + """ + Ensure that there are either loggers or placeholders all the way + from the specified logger to the root of the logger hierarchy. + """ + name = alogger.name + i = string.rfind(name, ".") + rv = None + while (i > 0) and not rv: + substr = name[:i] + if not self.loggerDict.has_key(substr): + self.loggerDict[substr] = PlaceHolder(alogger) + else: + obj = self.loggerDict[substr] + if isinstance(obj, Logger): + rv = obj + else: + assert isinstance(obj, PlaceHolder) + obj.append(alogger) + i = string.rfind(name, ".", 0, i - 1) + if not rv: + rv = self.root + alogger.parent = rv + + def _fixupChildren(self, ph, alogger): + """ + Ensure that children of the placeholder ph are connected to the + specified logger. + """ + for c in ph.loggers: + if string.find(c.parent.name, alogger.name) <> 0: + alogger.parent = c.parent + c.parent = alogger + +#--------------------------------------------------------------------------- +# Logger classes and functions +#--------------------------------------------------------------------------- + +class Logger(Filterer): + """ + Instances of the Logger class represent a single logging channel. A + "logging channel" indicates an area of an application. Exactly how an + "area" is defined is up to the application developer. Since an + application can have any number of areas, logging channels are identified + by a unique string. Application areas can be nested (e.g. an area + of "input processing" might include sub-areas "read CSV files", "read + XLS files" and "read Gnumeric files"). To cater for this natural nesting, + channel names are organized into a namespace hierarchy where levels are + separated by periods, much like the Java or Python package namespace. So + in the instance given above, channel names might be "input" for the upper + level, and "input.csv", "input.xls" and "input.gnu" for the sub-levels. + There is no arbitrary limit to the depth of nesting. + """ + def __init__(self, name, level=NOTSET): + """ + Initialize the logger with a name and an optional level. + """ + Filterer.__init__(self) + self.name = name + self.level = level + self.parent = None + self.propagate = 1 + self.handlers = [] + self.disabled = 0 + + def setLevel(self, level): + """ + Set the logging level of this logger. + """ + self.level = level + + def debug(self, msg, *args, **kwargs): + """ + Log 'msg % args' with severity 'DEBUG'. + + To pass exception information, use the keyword argument exc_info with + a true value, e.g. + + logger.debug("Houston, we have a %s", "thorny problem", exc_info=1) + """ + if self.manager.disable >= DEBUG: + return + if DEBUG >= self.getEffectiveLevel(): + apply(self._log, (DEBUG, msg, args), kwargs) + + def info(self, msg, *args, **kwargs): + """ + Log 'msg % args' with severity 'INFO'. + + To pass exception information, use the keyword argument exc_info with + a true value, e.g. + + logger.info("Houston, we have a %s", "interesting problem", exc_info=1) + """ + if self.manager.disable >= INFO: + return + if INFO >= self.getEffectiveLevel(): + apply(self._log, (INFO, msg, args), kwargs) + + def warning(self, msg, *args, **kwargs): + """ + Log 'msg % args' with severity 'WARNING'. + + To pass exception information, use the keyword argument exc_info with + a true value, e.g. + + logger.warning("Houston, we have a %s", "bit of a problem", exc_info=1) + """ + if self.manager.disable >= WARNING: + return + if self.isEnabledFor(WARNING): + apply(self._log, (WARNING, msg, args), kwargs) + + warn = warning + + def error(self, msg, *args, **kwargs): + """ + Log 'msg % args' with severity 'ERROR'. + + To pass exception information, use the keyword argument exc_info with + a true value, e.g. + + logger.error("Houston, we have a %s", "major problem", exc_info=1) + """ + if self.manager.disable >= ERROR: + return + if self.isEnabledFor(ERROR): + apply(self._log, (ERROR, msg, args), kwargs) + + def exception(self, msg, *args): + """ + Convenience method for logging an ERROR with exception information. + """ + apply(self.error, (msg,) + args, {'exc_info': 1}) + + def critical(self, msg, *args, **kwargs): + """ + Log 'msg % args' with severity 'CRITICAL'. + + To pass exception information, use the keyword argument exc_info with + a true value, e.g. + + logger.critical("Houston, we have a %s", "major disaster", exc_info=1) + """ + if self.manager.disable >= CRITICAL: + return + if CRITICAL >= self.getEffectiveLevel(): + apply(self._log, (CRITICAL, msg, args), kwargs) + + fatal = critical + + def log(self, level, msg, *args, **kwargs): + """ + Log 'msg % args' with the integer severity 'level'. + + To pass exception information, use the keyword argument exc_info with + a true value, e.g. + + logger.log(level, "We have a %s", "mysterious problem", exc_info=1) + """ + if type(level) != types.IntType: + if raiseExceptions: + raise TypeError, "level must be an integer" + else: + return + if self.manager.disable >= level: + return + if self.isEnabledFor(level): + apply(self._log, (level, msg, args), kwargs) + + def findCaller(self): + """ + Find the stack frame of the caller so that we can note the source + file name, line number and function name. + """ + f = currentframe().f_back + while 1: + co = f.f_code + filename = os.path.normcase(co.co_filename) + if filename == _srcfile: + f = f.f_back + continue + return filename, f.f_lineno, co.co_name + + def makeRecord(self, name, level, fn, lno, msg, args, exc_info): + """ + A factory method which can be overridden in subclasses to create + specialized LogRecords. + """ + return LogRecord(name, level, fn, lno, msg, args, exc_info) + + def _log(self, level, msg, args, exc_info=None): + """ + Low-level logging routine which creates a LogRecord and then calls + all the handlers of this logger to handle the record. + """ + if _srcfile: + fn, lno, func = self.findCaller() + else: + fn, lno, func = "(unknown file)", 0, "(unknown function)" + if exc_info: + if type(exc_info) != types.TupleType: + exc_info = sys.exc_info() + record = self.makeRecord(self.name, level, fn, lno, msg, args, exc_info) + self.handle(record) + + def handle(self, record): + """ + Call the handlers for the specified record. + + This method is used for unpickled records received from a socket, as + well as those created locally. Logger-level filtering is applied. + """ + if (not self.disabled) and self.filter(record): + self.callHandlers(record) + + def addHandler(self, hdlr): + """ + Add the specified handler to this logger. + """ + if not (hdlr in self.handlers): + self.handlers.append(hdlr) + + def removeHandler(self, hdlr): + """ + Remove the specified handler from this logger. + """ + if hdlr in self.handlers: + #hdlr.close() + self.handlers.remove(hdlr) + + def callHandlers(self, record): + """ + Pass a record to all relevant handlers. + + Loop through all handlers for this logger and its parents in the + logger hierarchy. If no handler was found, output a one-off error + message to sys.stderr. Stop searching up the hierarchy whenever a + logger with the "propagate" attribute set to zero is found - that + will be the last logger whose handlers are called. + """ + c = self + found = 0 + while c: + for hdlr in c.handlers: + found = found + 1 + if record.levelno >= hdlr.level: + hdlr.handle(record) + if not c.propagate: + c = None #break out + else: + c = c.parent + if (found == 0) and not self.manager.emittedNoHandlerWarning: + sys.stderr.write("No handlers could be found for logger" + " \"%s\"\n" % self.name) + self.manager.emittedNoHandlerWarning = 1 + + def getEffectiveLevel(self): + """ + Get the effective level for this logger. + + Loop through this logger and its parents in the logger hierarchy, + looking for a non-zero logging level. Return the first one found. + """ + logger = self + while logger: + if logger.level: + return logger.level + logger = logger.parent + return NOTSET + + def isEnabledFor(self, level): + """ + Is this logger enabled for level 'level'? + """ + if self.manager.disable >= level: + return 0 + return level >= self.getEffectiveLevel() + +class RootLogger(Logger): + """ + A root logger is not that different to any other logger, except that + it must have a logging level and there is only one instance of it in + the hierarchy. + """ + def __init__(self, level): + """ + Initialize the logger with the name "root". + """ + Logger.__init__(self, "root", level) + +_loggerClass = Logger + +root = RootLogger(WARNING) +Logger.root = root +Logger.manager = Manager(Logger.root) + +#--------------------------------------------------------------------------- +# Configuration classes and functions +#--------------------------------------------------------------------------- + +BASIC_FORMAT = "%(levelname)s:%(name)s:%(message)s" + +def basicConfig(**kwargs): + """ + Do basic configuration for the logging system. + + This function does nothing if the root logger already has handlers + configured. It is a convenience method intended for use by simple scripts + to do one-shot configuration of the logging package. + + The default behaviour is to create a StreamHandler which writes to + sys.stderr, set a formatter using the BASIC_FORMAT format string, and + add the handler to the root logger. + + A number of optional keyword arguments may be specified, which can alter + the default behaviour. + + filename Specifies that a FileHandler be created, using the specified + filename, rather than a StreamHandler. + filemode Specifies the mode to open the file, if filename is specified + (if filemode is unspecified, it defaults to 'a'). + format Use the specified format string for the handler. + datefmt Use the specified date/time format. + level Set the root logger level to the specified level. + stream Use the specified stream to initialize the StreamHandler. Note + that this argument is incompatible with 'filename' - if both + are present, 'stream' is ignored. + + Note that you could specify a stream created using open(filename, mode) + rather than passing the filename and mode in. However, it should be + remembered that StreamHandler does not close its stream (since it may be + using sys.stdout or sys.stderr), whereas FileHandler closes its stream + when the handler is closed. + """ + if len(root.handlers) == 0: + filename = kwargs.get("filename") + if filename: + mode = kwargs.get("filemode", 'a') + hdlr = FileHandler(filename, mode) + else: + stream = kwargs.get("stream") + hdlr = StreamHandler(stream) + fs = kwargs.get("format", BASIC_FORMAT) + dfs = kwargs.get("datefmt", None) + fmt = Formatter(fs, dfs) + hdlr.setFormatter(fmt) + root.addHandler(hdlr) + level = kwargs.get("level") + if level: + root.setLevel(level) + +#--------------------------------------------------------------------------- +# Utility functions at module level. +# Basically delegate everything to the root logger. +#--------------------------------------------------------------------------- + +def getLogger(name=None): + """ + Return a logger with the specified name, creating it if necessary. + + If no name is specified, return the root logger. + """ + if name: + return Logger.manager.getLogger(name) + else: + return root + +#def getRootLogger(): +# """ +# Return the root logger. +# +# Note that getLogger('') now does the same thing, so this function is +# deprecated and may disappear in the future. +# """ +# return root + +def critical(msg, *args, **kwargs): + """ + Log a message with severity 'CRITICAL' on the root logger. + """ + if len(root.handlers) == 0: + basicConfig() + apply(root.critical, (msg,)+args, kwargs) + +fatal = critical + +def error(msg, *args, **kwargs): + """ + Log a message with severity 'ERROR' on the root logger. + """ + if len(root.handlers) == 0: + basicConfig() + apply(root.error, (msg,)+args, kwargs) + +def exception(msg, *args): + """ + Log a message with severity 'ERROR' on the root logger, + with exception information. + """ + apply(error, (msg,)+args, {'exc_info': 1}) + +def warning(msg, *args, **kwargs): + """ + Log a message with severity 'WARNING' on the root logger. + """ + if len(root.handlers) == 0: + basicConfig() + apply(root.warning, (msg,)+args, kwargs) + +warn = warning + +def info(msg, *args, **kwargs): + """ + Log a message with severity 'INFO' on the root logger. + """ + if len(root.handlers) == 0: + basicConfig() + apply(root.info, (msg,)+args, kwargs) + +def debug(msg, *args, **kwargs): + """ + Log a message with severity 'DEBUG' on the root logger. + """ + if len(root.handlers) == 0: + basicConfig() + apply(root.debug, (msg,)+args, kwargs) + +def log(level, msg, *args, **kwargs): + """ + Log 'msg % args' with the integer severity 'level' on the root logger. + """ + if len(root.handlers) == 0: + basicConfig() + apply(root.log, (level, msg)+args, kwargs) + +def disable(level): + """ + Disable all logging calls less severe than 'level'. + """ + root.manager.disable = level + +def shutdown(): + """ + Perform any cleanup actions in the logging system (e.g. flushing + buffers). + + Should be called at application exit. + """ + for h in _handlers.keys(): + #errors might occur, for example, if files are locked + #we just ignore them + try: + h.flush() + h.close() + except: + pass + +#Let's try and shutdown automatically on application exit... +try: + import atexit + atexit.register(shutdown) +except ImportError: # for Python versions < 2.0 + def exithook(status, old_exit=sys.exit): + try: + shutdown() + finally: + old_exit(status) + + sys.exit = exithook diff --git a/env/Lib/site-packages/logging/handlers.py b/env/Lib/site-packages/logging/handlers.py new file mode 100644 index 0000000..0801699 --- /dev/null +++ b/env/Lib/site-packages/logging/handlers.py @@ -0,0 +1,975 @@ +# Copyright 2001-2005 by Vinay Sajip. All Rights Reserved. +# +# Permission to use, copy, modify, and distribute this software and its +# documentation for any purpose and without fee is hereby granted, +# provided that the above copyright notice appear in all copies and that +# both that copyright notice and this permission notice appear in +# supporting documentation, and that the name of Vinay Sajip +# not be used in advertising or publicity pertaining to distribution +# of the software without specific, written prior permission. +# VINAY SAJIP DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING +# ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL +# VINAY SAJIP BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR +# ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER +# IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT +# OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + +""" +Additional handlers for the logging package for Python. The core package is +based on PEP 282 and comments thereto in comp.lang.python, and influenced by +Apache's log4j system. + +Should work under Python versions >= 1.5.2, except that source line +information is not available unless 'sys._getframe()' is. + +Copyright (C) 2001-2004 Vinay Sajip. All Rights Reserved. + +To use, simply 'import logging' and log away! +""" + +import sys, logging, socket, types, os, string, cPickle, struct, time, glob + +try: + import codecs +except ImportError: + codecs = None + +# +# Some constants... +# + +DEFAULT_TCP_LOGGING_PORT = 9020 +DEFAULT_UDP_LOGGING_PORT = 9021 +DEFAULT_HTTP_LOGGING_PORT = 9022 +DEFAULT_SOAP_LOGGING_PORT = 9023 +SYSLOG_UDP_PORT = 514 + +class BaseRotatingHandler(logging.FileHandler): + """ + Base class for handlers that rotate log files at a certain point. + Not meant to be instantiated directly. Instead, use RotatingFileHandler + or TimedRotatingFileHandler. + """ + def __init__(self, filename, mode, encoding=None): + """ + Use the specified filename for streamed logging + """ + if codecs is None: + encoding = None + logging.FileHandler.__init__(self, filename, mode, encoding) + self.mode = mode + self.encoding = encoding + + def emit(self, record): + """ + Emit a record. + + Output the record to the file, catering for rollover as described + in doRollover(). + """ + try: + if self.shouldRollover(record): + self.doRollover() + logging.FileHandler.emit(self, record) + except: + self.handleError(record) + +class RotatingFileHandler(BaseRotatingHandler): + """ + Handler for logging to a set of files, which switches from one file + to the next when the current file reaches a certain size. + """ + def __init__(self, filename, mode='a', maxBytes=0, backupCount=0, encoding=None): + """ + Open the specified file and use it as the stream for logging. + + By default, the file grows indefinitely. You can specify particular + values of maxBytes and backupCount to allow the file to rollover at + a predetermined size. + + Rollover occurs whenever the current log file is nearly maxBytes in + length. If backupCount is >= 1, the system will successively create + new files with the same pathname as the base file, but with extensions + ".1", ".2" etc. appended to it. For example, with a backupCount of 5 + and a base file name of "app.log", you would get "app.log", + "app.log.1", "app.log.2", ... through to "app.log.5". The file being + written to is always "app.log" - when it gets filled up, it is closed + and renamed to "app.log.1", and if files "app.log.1", "app.log.2" etc. + exist, then they are renamed to "app.log.2", "app.log.3" etc. + respectively. + + If maxBytes is zero, rollover never occurs. + """ + if maxBytes > 0: + mode = 'a' # doesn't make sense otherwise! + BaseRotatingHandler.__init__(self, filename, mode, encoding) + self.maxBytes = maxBytes + self.backupCount = backupCount + + def doRollover(self): + """ + Do a rollover, as described in __init__(). + """ + + self.stream.close() + if self.backupCount > 0: + for i in range(self.backupCount - 1, 0, -1): + sfn = "%s.%d" % (self.baseFilename, i) + dfn = "%s.%d" % (self.baseFilename, i + 1) + if os.path.exists(sfn): + #print "%s -> %s" % (sfn, dfn) + if os.path.exists(dfn): + os.remove(dfn) + os.rename(sfn, dfn) + dfn = self.baseFilename + ".1" + if os.path.exists(dfn): + os.remove(dfn) + os.rename(self.baseFilename, dfn) + #print "%s -> %s" % (self.baseFilename, dfn) + if self.encoding: + self.stream = codecs.open(self.baseFilename, 'w', self.encoding) + else: + self.stream = open(self.baseFilename, 'w') + + def shouldRollover(self, record): + """ + Determine if rollover should occur. + + Basically, see if the supplied record would cause the file to exceed + the size limit we have. + """ + if self.maxBytes > 0: # are we rolling over? + msg = "%s\n" % self.format(record) + self.stream.seek(0, 2) #due to non-posix-compliant Windows feature + if self.stream.tell() + len(msg) >= self.maxBytes: + return 1 + return 0 + +class TimedRotatingFileHandler(BaseRotatingHandler): + """ + Handler for logging to a file, rotating the log file at certain timed + intervals. + + If backupCount is > 0, when rollover is done, no more than backupCount + files are kept - the oldest ones are deleted. + """ + def __init__(self, filename, when='h', interval=1, backupCount=0, encoding=None): + BaseRotatingHandler.__init__(self, filename, 'a', encoding) + self.when = string.upper(when) + self.backupCount = backupCount + # Calculate the real rollover interval, which is just the number of + # seconds between rollovers. Also set the filename suffix used when + # a rollover occurs. Current 'when' events supported: + # S - Seconds + # M - Minutes + # H - Hours + # D - Days + # midnight - roll over at midnight + # W{0-6} - roll over on a certain day; 0 - Monday + # + # Case of the 'when' specifier is not important; lower or upper case + # will work. + currentTime = int(time.time()) + if self.when == 'S': + self.interval = 1 # one second + self.suffix = "%Y-%m-%d_%H-%M-%S" + elif self.when == 'M': + self.interval = 60 # one minute + self.suffix = "%Y-%m-%d_%H-%M" + elif self.when == 'H': + self.interval = 60 * 60 # one hour + self.suffix = "%Y-%m-%d_%H" + elif self.when == 'D' or self.when == 'MIDNIGHT': + self.interval = 60 * 60 * 24 # one day + self.suffix = "%Y-%m-%d" + elif self.when.startswith('W'): + self.interval = 60 * 60 * 24 * 7 # one week + if len(self.when) != 2: + raise ValueError("You must specify a day for weekly rollover from 0 to 6 (0 is Monday): %s" % self.when) + if self.when[1] < '0' or self.when[1] > '6': + raise ValueError("Invalid day specified for weekly rollover: %s" % self.when) + self.dayOfWeek = int(self.when[1]) + self.suffix = "%Y-%m-%d" + else: + raise ValueError("Invalid rollover interval specified: %s" % self.when) + + self.interval = self.interval * interval # multiply by units requested + self.rolloverAt = currentTime + self.interval + + # If we are rolling over at midnight or weekly, then the interval is already known. + # What we need to figure out is WHEN the next interval is. In other words, + # if you are rolling over at midnight, then your base interval is 1 day, + # but you want to start that one day clock at midnight, not now. So, we + # have to fudge the rolloverAt value in order to trigger the first rollover + # at the right time. After that, the regular interval will take care of + # the rest. Note that this code doesn't care about leap seconds. :) + if self.when == 'MIDNIGHT' or self.when.startswith('W'): + # This could be done with less code, but I wanted it to be clear + t = time.localtime(currentTime) + currentHour = t[3] + currentMinute = t[4] + currentSecond = t[5] + # r is the number of seconds left between now and midnight + r = (24 - currentHour) * 60 * 60 # number of hours in seconds + r = r + (59 - currentMinute) * 60 # plus the number of minutes (in secs) + r = r + (59 - currentSecond) # plus the number of seconds + self.rolloverAt = currentTime + r + # If we are rolling over on a certain day, add in the number of days until + # the next rollover, but offset by 1 since we just calculated the time + # until the next day starts. There are three cases: + # Case 1) The day to rollover is today; in this case, do nothing + # Case 2) The day to rollover is further in the interval (i.e., today is + # day 2 (Wednesday) and rollover is on day 6 (Sunday). Days to + # next rollover is simply 6 - 2 - 1, or 3. + # Case 3) The day to rollover is behind us in the interval (i.e., today + # is day 5 (Saturday) and rollover is on day 3 (Thursday). + # Days to rollover is 6 - 5 + 3, or 4. In this case, it's the + # number of days left in the current week (1) plus the number + # of days in the next week until the rollover day (3). + if when.startswith('W'): + day = t[6] # 0 is Monday + if day > self.dayOfWeek: + daysToWait = (day - self.dayOfWeek) - 1 + self.rolloverAt = self.rolloverAt + (daysToWait * (60 * 60 * 24)) + if day < self.dayOfWeek: + daysToWait = (6 - self.dayOfWeek) + day + self.rolloverAt = self.rolloverAt + (daysToWait * (60 * 60 * 24)) + + #print "Will rollover at %d, %d seconds from now" % (self.rolloverAt, self.rolloverAt - currentTime) + + def shouldRollover(self, record): + """ + Determine if rollover should occur + + record is not used, as we are just comparing times, but it is needed so + the method siguratures are the same + """ + t = int(time.time()) + if t >= self.rolloverAt: + return 1 + #print "No need to rollover: %d, %d" % (t, self.rolloverAt) + return 0 + + def doRollover(self): + """ + do a rollover; in this case, a date/time stamp is appended to the filename + when the rollover happens. However, you want the file to be named for the + start of the interval, not the current time. If there is a backup count, + then we have to get a list of matching filenames, sort them and remove + the one with the oldest suffix. + """ + self.stream.close() + # get the time that this sequence started at and make it a TimeTuple + t = self.rolloverAt - self.interval + timeTuple = time.localtime(t) + dfn = self.baseFilename + "." + time.strftime(self.suffix, timeTuple) + if os.path.exists(dfn): + os.remove(dfn) + os.rename(self.baseFilename, dfn) + if self.backupCount > 0: + # find the oldest log file and delete it + s = glob.glob(self.baseFilename + ".20*") + if len(s) > self.backupCount: + s.sort() + os.remove(s[0]) + #print "%s -> %s" % (self.baseFilename, dfn) + if self.encoding: + self.stream = codecs.open(self.baseFilename, 'w', self.encoding) + else: + self.stream = open(self.baseFilename, 'w') + self.rolloverAt = int(time.time()) + self.interval + +class SocketHandler(logging.Handler): + """ + A handler class which writes logging records, in pickle format, to + a streaming socket. The socket is kept open across logging calls. + If the peer resets it, an attempt is made to reconnect on the next call. + The pickle which is sent is that of the LogRecord's attribute dictionary + (__dict__), so that the receiver does not need to have the logging module + installed in order to process the logging event. + + To unpickle the record at the receiving end into a LogRecord, use the + makeLogRecord function. + """ + + def __init__(self, host, port): + """ + Initializes the handler with a specific host address and port. + + The attribute 'closeOnError' is set to 1 - which means that if + a socket error occurs, the socket is silently closed and then + reopened on the next logging call. + """ + logging.Handler.__init__(self) + self.host = host + self.port = port + self.sock = None + self.closeOnError = 0 + self.retryTime = None + # + # Exponential backoff parameters. + # + self.retryStart = 1.0 + self.retryMax = 30.0 + self.retryFactor = 2.0 + + def makeSocket(self): + """ + A factory method which allows subclasses to define the precise + type of socket they want. + """ + s = socket.socket(socket.AF_INET, socket.SOCK_STREAM) + s.connect((self.host, self.port)) + return s + + def createSocket(self): + """ + Try to create a socket, using an exponential backoff with + a max retry time. Thanks to Robert Olson for the original patch + (SF #815911) which has been slightly refactored. + """ + now = time.time() + # Either retryTime is None, in which case this + # is the first time back after a disconnect, or + # we've waited long enough. + if self.retryTime is None: + attempt = 1 + else: + attempt = (now >= self.retryTime) + if attempt: + try: + self.sock = self.makeSocket() + self.retryTime = None # next time, no delay before trying + except: + #Creation failed, so set the retry time and return. + if self.retryTime is None: + self.retryPeriod = self.retryStart + else: + self.retryPeriod = self.retryPeriod * self.retryFactor + if self.retryPeriod > self.retryMax: + self.retryPeriod = self.retryMax + self.retryTime = now + self.retryPeriod + + def send(self, s): + """ + Send a pickled string to the socket. + + This function allows for partial sends which can happen when the + network is busy. + """ + if self.sock is None: + self.createSocket() + #self.sock can be None either because we haven't reached the retry + #time yet, or because we have reached the retry time and retried, + #but are still unable to connect. + if self.sock: + try: + if hasattr(self.sock, "sendall"): + self.sock.sendall(s) + else: + sentsofar = 0 + left = len(s) + while left > 0: + sent = self.sock.send(s[sentsofar:]) + sentsofar = sentsofar + sent + left = left - sent + except socket.error: + self.sock.close() + self.sock = None # so we can call createSocket next time + + def makePickle(self, record): + """ + Pickles the record in binary format with a length prefix, and + returns it ready for transmission across the socket. + """ + ei = record.exc_info + if ei: + dummy = self.format(record) # just to get traceback text into record.exc_text + record.exc_info = None # to avoid Unpickleable error + s = cPickle.dumps(record.__dict__, 1) + if ei: + record.exc_info = ei # for next handler + slen = struct.pack(">L", len(s)) + return slen + s + + def handleError(self, record): + """ + Handle an error during logging. + + An error has occurred during logging. Most likely cause - + connection lost. Close the socket so that we can retry on the + next event. + """ + if self.closeOnError and self.sock: + self.sock.close() + self.sock = None #try to reconnect next time + else: + logging.Handler.handleError(self, record) + + def emit(self, record): + """ + Emit a record. + + Pickles the record and writes it to the socket in binary format. + If there is an error with the socket, silently drop the packet. + If there was a problem with the socket, re-establishes the + socket. + """ + try: + s = self.makePickle(record) + self.send(s) + except: + self.handleError(record) + + def close(self): + """ + Closes the socket. + """ + if self.sock: + self.sock.close() + self.sock = None + logging.Handler.close(self) + +class DatagramHandler(SocketHandler): + """ + A handler class which writes logging records, in pickle format, to + a datagram socket. The pickle which is sent is that of the LogRecord's + attribute dictionary (__dict__), so that the receiver does not need to + have the logging module installed in order to process the logging event. + + To unpickle the record at the receiving end into a LogRecord, use the + makeLogRecord function. + + """ + def __init__(self, host, port): + """ + Initializes the handler with a specific host address and port. + """ + SocketHandler.__init__(self, host, port) + self.closeOnError = 0 + + def makeSocket(self): + """ + The factory method of SocketHandler is here overridden to create + a UDP socket (SOCK_DGRAM). + """ + s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) + return s + + def send(self, s): + """ + Send a pickled string to a socket. + + This function no longer allows for partial sends which can happen + when the network is busy - UDP does not guarantee delivery and + can deliver packets out of sequence. + """ + if self.sock is None: + self.createSocket() + self.sock.sendto(s, (self.host, self.port)) + +class SysLogHandler(logging.Handler): + """ + A handler class which sends formatted logging records to a syslog + server. Based on Sam Rushing's syslog module: + http://www.nightmare.com/squirl/python-ext/misc/syslog.py + Contributed by Nicolas Untz (after which minor refactoring changes + have been made). + """ + + # from : + # ====================================================================== + # priorities/facilities are encoded into a single 32-bit quantity, where + # the bottom 3 bits are the priority (0-7) and the top 28 bits are the + # facility (0-big number). Both the priorities and the facilities map + # roughly one-to-one to strings in the syslogd(8) source code. This + # mapping is included in this file. + # + # priorities (these are ordered) + + LOG_EMERG = 0 # system is unusable + LOG_ALERT = 1 # action must be taken immediately + LOG_CRIT = 2 # critical conditions + LOG_ERR = 3 # error conditions + LOG_WARNING = 4 # warning conditions + LOG_NOTICE = 5 # normal but significant condition + LOG_INFO = 6 # informational + LOG_DEBUG = 7 # debug-level messages + + # facility codes + LOG_KERN = 0 # kernel messages + LOG_USER = 1 # random user-level messages + LOG_MAIL = 2 # mail system + LOG_DAEMON = 3 # system daemons + LOG_AUTH = 4 # security/authorization messages + LOG_SYSLOG = 5 # messages generated internally by syslogd + LOG_LPR = 6 # line printer subsystem + LOG_NEWS = 7 # network news subsystem + LOG_UUCP = 8 # UUCP subsystem + LOG_CRON = 9 # clock daemon + LOG_AUTHPRIV = 10 # security/authorization messages (private) + + # other codes through 15 reserved for system use + LOG_LOCAL0 = 16 # reserved for local use + LOG_LOCAL1 = 17 # reserved for local use + LOG_LOCAL2 = 18 # reserved for local use + LOG_LOCAL3 = 19 # reserved for local use + LOG_LOCAL4 = 20 # reserved for local use + LOG_LOCAL5 = 21 # reserved for local use + LOG_LOCAL6 = 22 # reserved for local use + LOG_LOCAL7 = 23 # reserved for local use + + priority_names = { + "alert": LOG_ALERT, + "crit": LOG_CRIT, + "critical": LOG_CRIT, + "debug": LOG_DEBUG, + "emerg": LOG_EMERG, + "err": LOG_ERR, + "error": LOG_ERR, # DEPRECATED + "info": LOG_INFO, + "notice": LOG_NOTICE, + "panic": LOG_EMERG, # DEPRECATED + "warn": LOG_WARNING, # DEPRECATED + "warning": LOG_WARNING, + } + + facility_names = { + "auth": LOG_AUTH, + "authpriv": LOG_AUTHPRIV, + "cron": LOG_CRON, + "daemon": LOG_DAEMON, + "kern": LOG_KERN, + "lpr": LOG_LPR, + "mail": LOG_MAIL, + "news": LOG_NEWS, + "security": LOG_AUTH, # DEPRECATED + "syslog": LOG_SYSLOG, + "user": LOG_USER, + "uucp": LOG_UUCP, + "local0": LOG_LOCAL0, + "local1": LOG_LOCAL1, + "local2": LOG_LOCAL2, + "local3": LOG_LOCAL3, + "local4": LOG_LOCAL4, + "local5": LOG_LOCAL5, + "local6": LOG_LOCAL6, + "local7": LOG_LOCAL7, + } + + def __init__(self, address=('localhost', SYSLOG_UDP_PORT), facility=LOG_USER): + """ + Initialize a handler. + + If address is specified as a string, UNIX socket is used. + If facility is not specified, LOG_USER is used. + """ + logging.Handler.__init__(self) + + self.address = address + self.facility = facility + if type(address) == types.StringType: + self._connect_unixsocket(address) + self.unixsocket = 1 + else: + self.socket = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) + self.unixsocket = 0 + + self.formatter = None + + def _connect_unixsocket(self, address): + self.socket = socket.socket(socket.AF_UNIX, socket.SOCK_DGRAM) + # syslog may require either DGRAM or STREAM sockets + try: + self.socket.connect(address) + except socket.error: + self.socket.close() + self.socket = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM) + self.socket.connect(address) + + # curious: when talking to the unix-domain '/dev/log' socket, a + # zero-terminator seems to be required. this string is placed + # into a class variable so that it can be overridden if + # necessary. + log_format_string = '<%d>%s\000' + + def encodePriority (self, facility, priority): + """ + Encode the facility and priority. You can pass in strings or + integers - if strings are passed, the facility_names and + priority_names mapping dictionaries are used to convert them to + integers. + """ + if type(facility) == types.StringType: + facility = self.facility_names[facility] + if type(priority) == types.StringType: + priority = self.priority_names[priority] + return (facility << 3) | priority + + def close (self): + """ + Closes the socket. + """ + if self.unixsocket: + self.socket.close() + logging.Handler.close(self) + + def emit(self, record): + """ + Emit a record. + + The record is formatted, and then sent to the syslog server. If + exception information is present, it is NOT sent to the server. + """ + msg = self.format(record) + """ + We need to convert record level to lowercase, maybe this will + change in the future. + """ + msg = self.log_format_string % ( + self.encodePriority(self.facility, + string.lower(record.levelname)), + msg) + try: + if self.unixsocket: + try: + self.socket.send(msg) + except socket.error: + self._connect_unixsocket(self.address) + self.socket.send(msg) + else: + self.socket.sendto(msg, self.address) + except: + self.handleError(record) + +class SMTPHandler(logging.Handler): + """ + A handler class which sends an SMTP email for each logging event. + """ + def __init__(self, mailhost, fromaddr, toaddrs, subject): + """ + Initialize the handler. + + Initialize the instance with the from and to addresses and subject + line of the email. To specify a non-standard SMTP port, use the + (host, port) tuple format for the mailhost argument. + """ + logging.Handler.__init__(self) + if type(mailhost) == types.TupleType: + host, port = mailhost + self.mailhost = host + self.mailport = port + else: + self.mailhost = mailhost + self.mailport = None + self.fromaddr = fromaddr + if type(toaddrs) == types.StringType: + toaddrs = [toaddrs] + self.toaddrs = toaddrs + self.subject = subject + + def getSubject(self, record): + """ + Determine the subject for the email. + + If you want to specify a subject line which is record-dependent, + override this method. + """ + return self.subject + + weekdayname = ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'] + + monthname = [None, + 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', + 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'] + + def date_time(self): + """ + Return the current date and time formatted for a MIME header. + Needed for Python 1.5.2 (no email package available) + """ + year, month, day, hh, mm, ss, wd, y, z = time.gmtime(time.time()) + s = "%s, %02d %3s %4d %02d:%02d:%02d GMT" % ( + self.weekdayname[wd], + day, self.monthname[month], year, + hh, mm, ss) + return s + + def emit(self, record): + """ + Emit a record. + + Format the record and send it to the specified addressees. + """ + try: + import smtplib + try: + from email.Utils import formatdate + except: + formatdate = self.date_time + port = self.mailport + if not port: + port = smtplib.SMTP_PORT + smtp = smtplib.SMTP(self.mailhost, port) + msg = self.format(record) + msg = "From: %s\r\nTo: %s\r\nSubject: %s\r\nDate: %s\r\n\r\n%s" % ( + self.fromaddr, + string.join(self.toaddrs, ","), + self.getSubject(record), + formatdate(), msg) + smtp.sendmail(self.fromaddr, self.toaddrs, msg) + smtp.quit() + except: + self.handleError(record) + +class NTEventLogHandler(logging.Handler): + """ + A handler class which sends events to the NT Event Log. Adds a + registry entry for the specified application name. If no dllname is + provided, win32service.pyd (which contains some basic message + placeholders) is used. Note that use of these placeholders will make + your event logs big, as the entire message source is held in the log. + If you want slimmer logs, you have to pass in the name of your own DLL + which contains the message definitions you want to use in the event log. + """ + def __init__(self, appname, dllname=None, logtype="Application"): + logging.Handler.__init__(self) + try: + import win32evtlogutil, win32evtlog + self.appname = appname + self._welu = win32evtlogutil + if not dllname: + dllname = os.path.split(self._welu.__file__) + dllname = os.path.split(dllname[0]) + dllname = os.path.join(dllname[0], r'win32service.pyd') + self.dllname = dllname + self.logtype = logtype + self._welu.AddSourceToRegistry(appname, dllname, logtype) + self.deftype = win32evtlog.EVENTLOG_ERROR_TYPE + self.typemap = { + logging.DEBUG : win32evtlog.EVENTLOG_INFORMATION_TYPE, + logging.INFO : win32evtlog.EVENTLOG_INFORMATION_TYPE, + logging.WARNING : win32evtlog.EVENTLOG_WARNING_TYPE, + logging.ERROR : win32evtlog.EVENTLOG_ERROR_TYPE, + logging.CRITICAL: win32evtlog.EVENTLOG_ERROR_TYPE, + } + except ImportError: + print "The Python Win32 extensions for NT (service, event "\ + "logging) appear not to be available." + self._welu = None + + def getMessageID(self, record): + """ + Return the message ID for the event record. If you are using your + own messages, you could do this by having the msg passed to the + logger being an ID rather than a formatting string. Then, in here, + you could use a dictionary lookup to get the message ID. This + version returns 1, which is the base message ID in win32service.pyd. + """ + return 1 + + def getEventCategory(self, record): + """ + Return the event category for the record. + + Override this if you want to specify your own categories. This version + returns 0. + """ + return 0 + + def getEventType(self, record): + """ + Return the event type for the record. + + Override this if you want to specify your own types. This version does + a mapping using the handler's typemap attribute, which is set up in + __init__() to a dictionary which contains mappings for DEBUG, INFO, + WARNING, ERROR and CRITICAL. If you are using your own levels you will + either need to override this method or place a suitable dictionary in + the handler's typemap attribute. + """ + return self.typemap.get(record.levelno, self.deftype) + + def emit(self, record): + """ + Emit a record. + + Determine the message ID, event category and event type. Then + log the message in the NT event log. + """ + if self._welu: + try: + id = self.getMessageID(record) + cat = self.getEventCategory(record) + type = self.getEventType(record) + msg = self.format(record) + self._welu.ReportEvent(self.appname, id, cat, type, [msg]) + except: + self.handleError(record) + + def close(self): + """ + Clean up this handler. + + You can remove the application name from the registry as a + source of event log entries. However, if you do this, you will + not be able to see the events as you intended in the Event Log + Viewer - it needs to be able to access the registry to get the + DLL name. + """ + #self._welu.RemoveSourceFromRegistry(self.appname, self.logtype) + logging.Handler.close(self) + +class HTTPHandler(logging.Handler): + """ + A class which sends records to a Web server, using either GET or + POST semantics. + """ + def __init__(self, host, url, method="GET"): + """ + Initialize the instance with the host, the request URL, and the method + ("GET" or "POST") + """ + logging.Handler.__init__(self) + method = string.upper(method) + if method not in ["GET", "POST"]: + raise ValueError, "method must be GET or POST" + self.host = host + self.url = url + self.method = method + + def mapLogRecord(self, record): + """ + Default implementation of mapping the log record into a dict + that is sent as the CGI data. Overwrite in your class. + Contributed by Franz Glasner. + """ + return record.__dict__ + + def emit(self, record): + """ + Emit a record. + + Send the record to the Web server as an URL-encoded dictionary + """ + try: + import httplib, urllib + h = httplib.HTTP(self.host) + url = self.url + data = urllib.urlencode(self.mapLogRecord(record)) + if self.method == "GET": + if (string.find(url, '?') >= 0): + sep = '&' + else: + sep = '?' + url = url + "%c%s" % (sep, data) + h.putrequest(self.method, url) + if self.method == "POST": + h.putheader("Content-length", str(len(data))) + h.endheaders() + if self.method == "POST": + h.send(data) + h.getreply() #can't do anything with the result + except: + self.handleError(record) + +class BufferingHandler(logging.Handler): + """ + A handler class which buffers logging records in memory. Whenever each + record is added to the buffer, a check is made to see if the buffer should + be flushed. If it should, then flush() is expected to do what's needed. + """ + def __init__(self, capacity): + """ + Initialize the handler with the buffer size. + """ + logging.Handler.__init__(self) + self.capacity = capacity + self.buffer = [] + + def shouldFlush(self, record): + """ + Should the handler flush its buffer? + + Returns true if the buffer is up to capacity. This method can be + overridden to implement custom flushing strategies. + """ + return (len(self.buffer) >= self.capacity) + + def emit(self, record): + """ + Emit a record. + + Append the record. If shouldFlush() tells us to, call flush() to process + the buffer. + """ + self.buffer.append(record) + if self.shouldFlush(record): + self.flush() + + def flush(self): + """ + Override to implement custom flushing behaviour. + + This version just zaps the buffer to empty. + """ + self.buffer = [] + + def close(self): + """ + Close the handler. + + This version just flushes and chains to the parent class' close(). + """ + self.flush() + logging.Handler.close(self) + +class MemoryHandler(BufferingHandler): + """ + A handler class which buffers logging records in memory, periodically + flushing them to a target handler. Flushing occurs whenever the buffer + is full, or when an event of a certain severity or greater is seen. + """ + def __init__(self, capacity, flushLevel=logging.ERROR, target=None): + """ + Initialize the handler with the buffer size, the level at which + flushing should occur and an optional target. + + Note that without a target being set either here or via setTarget(), + a MemoryHandler is no use to anyone! + """ + BufferingHandler.__init__(self, capacity) + self.flushLevel = flushLevel + self.target = target + + def shouldFlush(self, record): + """ + Check for buffer full or a record at the flushLevel or higher. + """ + return (len(self.buffer) >= self.capacity) or \ + (record.levelno >= self.flushLevel) + + def setTarget(self, target): + """ + Set the target handler for this handler. + """ + self.target = target + + def flush(self): + """ + For a MemoryHandler, flushing means just sending the buffered + records to the target, if there is one. Override if you want + different behaviour. + """ + if self.target: + for record in self.buffer: + self.target.handle(record) + self.buffer = [] + + def close(self): + """ + Flush, set the target to None and lose the buffer. + """ + self.flush() + self.target = None + BufferingHandler.close(self) diff --git a/env/Lib/site-packages/magic_filter-1.0.12.dist-info/INSTALLER b/env/Lib/site-packages/magic_filter-1.0.12.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/Lib/site-packages/magic_filter-1.0.12.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/Lib/site-packages/magic_filter-1.0.12.dist-info/METADATA b/env/Lib/site-packages/magic_filter-1.0.12.dist-info/METADATA new file mode 100644 index 0000000..235f015 --- /dev/null +++ b/env/Lib/site-packages/magic_filter-1.0.12.dist-info/METADATA @@ -0,0 +1,37 @@ +Metadata-Version: 2.1 +Name: magic-filter +Version: 1.0.12 +Project-URL: Documentation, https://docs.aiogram.dev/en/dev-3.x/dispatcher/filters/magic_filters.html +Project-URL: Issues, https://github.com/aiogram/magic-filter/issues +Project-URL: Source, https://github.com/aiogram/magic-filter +Author-email: Alex Root Junior +License-Expression: MIT +License-File: LICENSE +Keywords: filter,magic,validation +Classifier: Development Status :: 3 - Alpha +Classifier: License :: OSI Approved :: MIT License +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3.7 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Topic :: Utilities +Classifier: Typing :: Typed +Requires-Python: >=3.7 +Provides-Extra: dev +Requires-Dist: black~=22.8.0; extra == 'dev' +Requires-Dist: flake8~=5.0.4; extra == 'dev' +Requires-Dist: isort~=5.11.5; extra == 'dev' +Requires-Dist: mypy~=1.4.1; extra == 'dev' +Requires-Dist: pre-commit~=2.20.0; extra == 'dev' +Requires-Dist: pytest-cov~=3.0.0; extra == 'dev' +Requires-Dist: pytest-html~=3.1.1; extra == 'dev' +Requires-Dist: pytest~=7.1.3; extra == 'dev' +Requires-Dist: types-setuptools~=65.3.0; extra == 'dev' +Description-Content-Type: text/markdown + +# magic-filter + +This package provides magic filter based on dynamic attribute getter diff --git a/env/Lib/site-packages/magic_filter-1.0.12.dist-info/RECORD b/env/Lib/site-packages/magic_filter-1.0.12.dist-info/RECORD new file mode 100644 index 0000000..41b2227 --- /dev/null +++ b/env/Lib/site-packages/magic_filter-1.0.12.dist-info/RECORD @@ -0,0 +1,40 @@ +magic_filter-1.0.12.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +magic_filter-1.0.12.dist-info/METADATA,sha256=lOYu2dS6vE2Ha5UrWEJVNmxokmWbtQHy7w3_v8NxZhk,1536 +magic_filter-1.0.12.dist-info/RECORD,, +magic_filter-1.0.12.dist-info/WHEEL,sha256=9QBuHhg6FNW7lppboF2vKVbCGTVzsFykgRQjjlajrhA,87 +magic_filter-1.0.12.dist-info/licenses/LICENSE,sha256=mnnw-u5pV8-s5DrMgusp5kyWuD8q_DxyBEyrGWhHhTo,1065 +magic_filter/__init__.py,sha256=9JzbtEEmmXCAvOsjWbTJJk5TeelJd6loA3HI6US7mZ0,278 +magic_filter/__pycache__/__init__.cpython-311.pyc,, +magic_filter/__pycache__/attrdict.cpython-311.pyc,, +magic_filter/__pycache__/exceptions.cpython-311.pyc,, +magic_filter/__pycache__/helper.cpython-311.pyc,, +magic_filter/__pycache__/magic.cpython-311.pyc,, +magic_filter/__pycache__/util.cpython-311.pyc,, +magic_filter/attrdict.py,sha256=TkQarjPn3cnzcXLAds5vw4T8CZtxe5gFebeMIpOkQxw,368 +magic_filter/exceptions.py,sha256=Dn5fIzyQv1Q-IkWaip5CIOAwB8Ye8TM1Xl-5eDEtbFA,361 +magic_filter/helper.py,sha256=EyoKzspmOKi740M3_N4SW-Fw8Ha3JWSqiFYdebySLoY,291 +magic_filter/magic.py,sha256=HzUY-y9-RA4J0-KDUkJMoegIY5OuwXIM90aRq2T-ffE,11550 +magic_filter/operations/__init__.py,sha256=4uGrtmRabLd6jdZrX9xNW8DTjmY4KyWUtKuZgnxOL4U,827 +magic_filter/operations/__pycache__/__init__.cpython-311.pyc,, +magic_filter/operations/__pycache__/base.cpython-311.pyc,, +magic_filter/operations/__pycache__/call.cpython-311.pyc,, +magic_filter/operations/__pycache__/cast.cpython-311.pyc,, +magic_filter/operations/__pycache__/combination.cpython-311.pyc,, +magic_filter/operations/__pycache__/comparator.cpython-311.pyc,, +magic_filter/operations/__pycache__/extract.cpython-311.pyc,, +magic_filter/operations/__pycache__/function.cpython-311.pyc,, +magic_filter/operations/__pycache__/getattr.cpython-311.pyc,, +magic_filter/operations/__pycache__/getitem.cpython-311.pyc,, +magic_filter/operations/__pycache__/selector.cpython-311.pyc,, +magic_filter/operations/base.py,sha256=4mOwMvBIcUrBw3ALcW5G6Xk1kYR4pM2-f8-Lr2KpFrQ,231 +magic_filter/operations/call.py,sha256=3VcEdjyTO_eNf3Z2aQcMVPZ3Z6JVMl1eeETe_bc4GHQ,527 +magic_filter/operations/cast.py,sha256=0J8-WJ233SxAfaFHl7ZyN4xamlJlU7jFWhLaXEQ_5F4,446 +magic_filter/operations/combination.py,sha256=y1ID3OaUNcArj_lYFm5cIo5knOSDxY8OMI1uBnR6Muk,1005 +magic_filter/operations/comparator.py,sha256=6w3EkrbRKR060p9Az7tvp652jJuR3c-66YT68bJuVtM,522 +magic_filter/operations/extract.py,sha256=7Z25YICzvteKMygwt7VHnLeluX2Tx3E8ZKgVUAVZ3kM,613 +magic_filter/operations/function.py,sha256=kzIh8SoeIbxN1nqiXJtHhzS8QjBlIcxfNGtKWmYK8is,940 +magic_filter/operations/getattr.py,sha256=6GvzUYm8ZQNcDL3h8m82oiUArBzdcXi1976QcbjFUi0,466 +magic_filter/operations/getitem.py,sha256=IrHfbDUm6igfvp-tuqB6oAnwJZAbj4_5sXFWaZhKxd4,736 +magic_filter/operations/selector.py,sha256=jhXmLg4vrfObetdDLm9laEJz-vsdw8p5_4aZAddzZfw,504 +magic_filter/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +magic_filter/util.py,sha256=iz_b9qrLIgrxjSL60xKhJHA69-Suoz5M9yDOSnFc9zk,660 diff --git a/env/Lib/site-packages/magic_filter-1.0.12.dist-info/WHEEL b/env/Lib/site-packages/magic_filter-1.0.12.dist-info/WHEEL new file mode 100644 index 0000000..ba1a8af --- /dev/null +++ b/env/Lib/site-packages/magic_filter-1.0.12.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: hatchling 1.18.0 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/env/Lib/site-packages/magic_filter-1.0.12.dist-info/licenses/LICENSE b/env/Lib/site-packages/magic_filter-1.0.12.dist-info/licenses/LICENSE new file mode 100644 index 0000000..7b60093 --- /dev/null +++ b/env/Lib/site-packages/magic_filter-1.0.12.dist-info/licenses/LICENSE @@ -0,0 +1,18 @@ +Copyright (c) 2020-2022 Alex Root Junior + +Permission is hereby granted, free of charge, to any person obtaining a copy of this +software and associated documentation files (the "Software"), to deal in the Software +without restriction, including without limitation the rights to use, copy, modify, +merge, publish, distribute, sublicense, and/or sell copies of the Software, +and to permit persons to whom the Software is furnished to do so, subject to the +following conditions: + +The above copyright notice and this permission notice shall be included in all copies +or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, +INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR +PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS +BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE +OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/env/Lib/site-packages/magic_filter/__init__.py b/env/Lib/site-packages/magic_filter/__init__.py new file mode 100644 index 0000000..f6c0211 --- /dev/null +++ b/env/Lib/site-packages/magic_filter/__init__.py @@ -0,0 +1,17 @@ +from . import operations +from .attrdict import AttrDict +from .magic import MagicFilter, MagicT, RegexpMode + +__all__ = ( + "__version__", + "operations", + "MagicFilter", + "MagicT", + "RegexpMode", + "F", + "AttrDict", +) + +__version__ = "1.0.12" + +F = MagicFilter() diff --git a/env/Lib/site-packages/magic_filter/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/magic_filter/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d647262d2efb050cf43841866c8037996bd2f6d2 GIT binary patch literal 516 zcmZ`#Jxc>Y5S_hmbA%v>TG?M=G$};{F$6?op@MK6EN6BTmfYozy;Icc1pkADy&|^$ z42zUuE5XVxU}xprp@o98!`nB@%zMl})ay0Cc)oiXEE0gXviJ$@n|vG~xdjG{L=Y37 zkdkYW7VExVaXm6((>G(ww_@A3@y+lZX8Lm)aPuCgpMEsKuQBTgJo_Epz$2=bq+Eu% zNX8jf&UT*5j_Bu}uH0TY6#cGy5Hf}3$?u%P%H(%Wp*{IOXNKcyg*{t<#!}(F8jWJ_x_8qn KNO@!fjlKZ%{)e{! literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/magic_filter/__pycache__/attrdict.cpython-311.pyc b/env/Lib/site-packages/magic_filter/__pycache__/attrdict.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..07bcb15c24261badbdc1c9d8fbeed72312a01673 GIT binary patch literal 1153 zcmb7D&1(}u6rY*>$hIbk9|wg7_F|z2t2aSJtQJL-UK(0hwhWt{NxIEu6K6K9DLF(a zm_sYQNDE%2R(k2dKf^->4`EM&CvTB>ke+|P{(X8Puf6p z_J;84buR4MIxq$vdt){5SAlcEZ65L}k7C>RBD=_K&-b~MoY|hV1ur*3PuL#p7!(^Z zm+6j)?uoKY%*w`K7CdfV=4NYSjd# ze&|U_snkJ-617hs&);^JYog*lsIed_yOoCU;+mkvTI}*@-F+GqT^YpudfoFYUYSd` z>XieZmVz+m;)W`aI&Ze#6e{b@3!_Vz9YM;1S*k1j*+yM!ddJvV-Pb=^`Om6PAL=L8 ztz#3|pm(oKb@c6A2U;Iu;2EiuBCpCJxk*Z^HP#4~oTcLJA}V&wOICFc(p)9JX7PXEQk z<rn0iTy+^jy&IvvfKYH!T<_5!NTEHo?hI1DE2cnIX~-t9o`x~*qH8Dr t?q7^-d%071v9h(&Cf&12&&=R_5BoPE(u#oGG*+PFGwGxRDHJ zD9!>dpYdrbt^nLB~mWB-NRuIk*U@hhi;n)Ql*?!HBP}&OQsf`70-R_`LU1- zA6(Ily)dZk>WRfz;4}ndNrACO$Xh;+#~6Fta{QFpB^~s9_;mih{W_F&doJW&uwvI+ z(uqUKmc!T2FUBJT2(H@EG13I`FTjvJA(R2!(Yh14x z+}Jd#2G=3IW-`&&eHA|P{Y0;ewInA++>$}X)s(9gaE!rsrU16dI$b9$WdJz=ceGNb zauQ}xHzN{$O-&-)I5Q(L46K?LcrjxiuM8>Ab{VvbFsu!-cWHXd_+)Ltr&3Wir3ya> ztQOQU>^r^xLPSNs=@}*m6HoaUPHtmI{ GZtOpn2rp&; literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/magic_filter/__pycache__/helper.cpython-311.pyc b/env/Lib/site-packages/magic_filter/__pycache__/helper.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cf4543161c07bfb15594cc3030ae6c989de7c25c GIT binary patch literal 640 zcmZutL2DC16n?Y2*_LjiEw$c+fMB`@^)99$Efqw2$w8%fMgRJH9(vh=oakl~f(oZwwv)q1^4D-?;iu;&X zL?X0^;&9%&5_MlDO>42=B!|MLm<2?n#kgg(URexuiLMsNAhS+s?(EO3vNC8u2Jg-E zKgifAebpJo9OTg6lV+GKde5S^Xzq$wqx7A;+%;|3Dtft0Z}JtPM51(*G%;V2sM2_V zzAcSeX=9t6)**$K8&E|PZ8>B~r`GCW9ifXN_uDh>iAG~Vq+%}&%t z75uGu|0Tvfl=phWd~G2WidL8)a^$i?8b(&ti4NhLvpK$ces~)vIC^pJ`4^r)1yeK>u>6#TjyTw!mEv)+Kd*!o^R)_9`?wlH1>=AA3bh)m)R+RLPwPecGEYVQKPt3-0ZSB{egFUf literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/magic_filter/__pycache__/magic.cpython-311.pyc b/env/Lib/site-packages/magic_filter/__pycache__/magic.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b0c11b353839dc369001761994372dc7a636a76b GIT binary patch literal 23382 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 PhVOFxPwtS)JJWvw=W)Ei literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/magic_filter/__pycache__/util.cpython-311.pyc b/env/Lib/site-packages/magic_filter/__pycache__/util.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..807cb40b1dddf4035acc2be32a5d78a38a3deacc GIT binary patch literal 1582 zcmbtT&1(};5TCcZ+2*5ZYLg&UDJ}NWLn~NN6e*Opo-~&T(h>|wc3YMvyJ2?I8VM3a zWDgz!78WpvgMZ6kT3bwZKPZMY+PR zl086nMrY3Y@XrsBUA@8{B>TXjoyTMpGeo-JIbE1^AuW=IslmUT=al5h^JdixEm)?L zGfW*lmh)KNQ&D#+Xcj01$3vl=OtU*fVjDtGV>Q@-G~5U07z8j0s4!TjH3!86Q7bT6~&$ZQ*)m!O{$KEwf(1oMT}&Z#fy= z+{nBz@)_H3^yzZ0u%27f?Mx}RW)!lkM$ysnLB%nOGv%rmFwCq~#vyXb8FwF&s6$7R z1Ic!5xH0c;xY6G4NTLHQkUSCXSi-Him5xl>Ua!|3q+=gs6+VR%@)wqnZ;%SQ@b#&{ z5IIKPWXMAtULK>g_d=%SWPSQ0^dF(woh5NXzscNp`@zxc`QtF1yM{9r@Mh(^igTpk zw~oz|o}{3hImWoSA%*`=Ta2geG>zL7oxekj_ocx|D;k+sVH;{-u^N$Ru~e&1QPiBN z@w?q6@HkDIm!%Hv$e{bUajTx{((l|j4?7!(mWO8QG?ZA z;yqHProx`;RLk@>kkdzngs0>!t0=l1Mdo=4kS9P879LT= None: + super(AttrDict, self).__init__(*args, **kwargs) + self.__dict__ = self # type: ignore diff --git a/env/Lib/site-packages/magic_filter/exceptions.py b/env/Lib/site-packages/magic_filter/exceptions.py new file mode 100644 index 0000000..59e81ab --- /dev/null +++ b/env/Lib/site-packages/magic_filter/exceptions.py @@ -0,0 +1,23 @@ +class MagicFilterException(Exception): + pass + + +class SwitchMode(MagicFilterException): + pass + + +class SwitchModeToAll(SwitchMode): + def __init__(self, key: slice) -> None: + self.key = key + + +class SwitchModeToAny(SwitchMode): + pass + + +class RejectOperations(MagicFilterException): + pass + + +class ParamsConflict(MagicFilterException): + pass diff --git a/env/Lib/site-packages/magic_filter/helper.py b/env/Lib/site-packages/magic_filter/helper.py new file mode 100644 index 0000000..2685325 --- /dev/null +++ b/env/Lib/site-packages/magic_filter/helper.py @@ -0,0 +1,10 @@ +from typing import Any + + +def resolve_if_needed(value: Any, initial_value: Any) -> Any: + # To avoid circular imports here is used local import + from magic_filter import MagicFilter + + if not isinstance(value, MagicFilter): + return value + return value.resolve(initial_value) diff --git a/env/Lib/site-packages/magic_filter/magic.py b/env/Lib/site-packages/magic_filter/magic.py new file mode 100644 index 0000000..77266e7 --- /dev/null +++ b/env/Lib/site-packages/magic_filter/magic.py @@ -0,0 +1,290 @@ +import operator +import re +from functools import wraps +from typing import Any, Callable, Container, Optional, Pattern, Tuple, Type, TypeVar, Union +from warnings import warn + +from magic_filter.exceptions import ( + ParamsConflict, + RejectOperations, + SwitchModeToAll, + SwitchModeToAny, +) +from magic_filter.operations import ( + BaseOperation, + CallOperation, + CastOperation, + CombinationOperation, + ComparatorOperation, + ExtractOperation, + FunctionOperation, + GetAttributeOperation, + GetItemOperation, + ImportantCombinationOperation, + ImportantFunctionOperation, + RCombinationOperation, + SelectorOperation, +) +from magic_filter.util import and_op, contains_op, in_op, not_contains_op, not_in_op, or_op + +MagicT = TypeVar("MagicT", bound="MagicFilter") + + +class RegexpMode: + SEARCH = "search" + MATCH = "match" + FINDALL = "findall" + FINDITER = "finditer" + FULLMATCH = "fullmatch" + + +class MagicFilter: + __slots__ = ("_operations",) + + def __init__(self, operations: Tuple[BaseOperation, ...] = ()) -> None: + self._operations = operations + + # An instance of MagicFilter cannot be used as an iterable object because objects + # with a __getitem__ method can be endlessly iterated, which is not the desired behavior. + __iter__ = None + + @classmethod + def ilter(cls, magic: "MagicFilter") -> Callable[[Any], Any]: + @wraps(magic.resolve) + def wrapper(value: Any) -> Any: + return magic.resolve(value) + + return wrapper + + @classmethod + def _new(cls: Type[MagicT], operations: Tuple[BaseOperation, ...]) -> MagicT: + return cls(operations=operations) + + def _extend(self: MagicT, operation: BaseOperation) -> MagicT: + return self._new(self._operations + (operation,)) + + def _replace_last(self: MagicT, operation: BaseOperation) -> MagicT: + return self._new(self._operations[:-1] + (operation,)) + + def _exclude_last(self: MagicT) -> MagicT: + return self._new(self._operations[:-1]) + + def _resolve(self, value: Any, operations: Optional[Tuple[BaseOperation, ...]] = None) -> Any: + initial_value = value + if operations is None: + operations = self._operations + rejected = False + for index, operation in enumerate(operations): + if rejected and not operation.important: + continue + try: + value = operation.resolve(value=value, initial_value=initial_value) + except SwitchModeToAll: + return all(self._resolve(value=item, operations=operations[index + 1 :]) for item in value) + except SwitchModeToAny: + return any(self._resolve(value=item, operations=operations[index + 1 :]) for item in value) + except RejectOperations: + rejected = True + value = None + continue + rejected = False + return value + + def __bool__(self) -> bool: + return True + + def resolve(self: MagicT, value: Any) -> Any: + return self._resolve(value=value) + + def __getattr__(self: MagicT, item: Any) -> MagicT: + if item.startswith("_"): + raise AttributeError(f"{type(self).__name__!r} object has no attribute {item!r}") + return self._extend(GetAttributeOperation(name=item)) + + attr_ = __getattr__ + + def __getitem__(self: MagicT, item: Any) -> MagicT: + if isinstance(item, MagicFilter): + return self._extend(SelectorOperation(inner=item)) + return self._extend(GetItemOperation(key=item)) + + def __len__(self) -> int: + raise TypeError(f"Length can't be taken using len() function. Use {type(self).__name__}.len() instead.") + + def __eq__(self: MagicT, other: Any) -> MagicT: # type: ignore + return self._extend(ComparatorOperation(right=other, comparator=operator.eq)) + + def __ne__(self: MagicT, other: Any) -> MagicT: # type: ignore + return self._extend(ComparatorOperation(right=other, comparator=operator.ne)) + + def __lt__(self: MagicT, other: Any) -> MagicT: + return self._extend(ComparatorOperation(right=other, comparator=operator.lt)) + + def __gt__(self: MagicT, other: Any) -> MagicT: + return self._extend(ComparatorOperation(right=other, comparator=operator.gt)) + + def __le__(self: MagicT, other: Any) -> MagicT: + return self._extend(ComparatorOperation(right=other, comparator=operator.le)) + + def __ge__(self: MagicT, other: Any) -> MagicT: + return self._extend(ComparatorOperation(right=other, comparator=operator.ge)) + + def __invert__(self: MagicT) -> MagicT: + if ( + self._operations + and isinstance(self._operations[-1], ImportantFunctionOperation) + and self._operations[-1].function == operator.not_ + ): + return self._exclude_last() + return self._extend(ImportantFunctionOperation(function=operator.not_)) + + def __call__(self: MagicT, *args: Any, **kwargs: Any) -> MagicT: + return self._extend(CallOperation(args=args, kwargs=kwargs)) + + def __and__(self: MagicT, other: Any) -> MagicT: + if isinstance(other, MagicFilter): + return self._extend(CombinationOperation(right=other, combinator=and_op)) + return self._extend(CombinationOperation(right=other, combinator=operator.and_)) + + def __rand__(self: MagicT, other: Any) -> MagicT: + return self._extend(RCombinationOperation(left=other, combinator=operator.and_)) + + def __or__(self: MagicT, other: Any) -> MagicT: + if isinstance(other, MagicFilter): + return self._extend(ImportantCombinationOperation(right=other, combinator=or_op)) + return self._extend(ImportantCombinationOperation(right=other, combinator=operator.or_)) + + def __ror__(self: MagicT, other: Any) -> MagicT: + return self._extend(RCombinationOperation(left=other, combinator=operator.or_)) + + def __xor__(self: MagicT, other: Any) -> MagicT: + return self._extend(CombinationOperation(right=other, combinator=operator.xor)) + + def __rxor__(self: MagicT, other: Any) -> MagicT: + return self._extend(RCombinationOperation(left=other, combinator=operator.xor)) + + def __rshift__(self: MagicT, other: Any) -> MagicT: + return self._extend(CombinationOperation(right=other, combinator=operator.rshift)) + + def __rrshift__(self: MagicT, other: Any) -> MagicT: + return self._extend(RCombinationOperation(left=other, combinator=operator.rshift)) + + def __lshift__(self: MagicT, other: Any) -> MagicT: + return self._extend(CombinationOperation(right=other, combinator=operator.lshift)) + + def __rlshift__(self: MagicT, other: Any) -> MagicT: + return self._extend(RCombinationOperation(left=other, combinator=operator.lshift)) + + def __add__(self: MagicT, other: Any) -> MagicT: + return self._extend(CombinationOperation(right=other, combinator=operator.add)) + + def __radd__(self: MagicT, other: Any) -> MagicT: + return self._extend(RCombinationOperation(left=other, combinator=operator.add)) + + def __sub__(self: MagicT, other: Any) -> MagicT: + return self._extend(CombinationOperation(right=other, combinator=operator.sub)) + + def __rsub__(self: MagicT, other: Any) -> MagicT: + return self._extend(RCombinationOperation(left=other, combinator=operator.sub)) + + def __mul__(self: MagicT, other: Any) -> MagicT: + return self._extend(CombinationOperation(right=other, combinator=operator.mul)) + + def __rmul__(self: MagicT, other: Any) -> MagicT: + return self._extend(RCombinationOperation(left=other, combinator=operator.mul)) + + def __truediv__(self: MagicT, other: Any) -> MagicT: + return self._extend(CombinationOperation(right=other, combinator=operator.truediv)) + + def __rtruediv__(self: MagicT, other: Any) -> MagicT: + return self._extend(RCombinationOperation(left=other, combinator=operator.truediv)) + + def __floordiv__(self: MagicT, other: Any) -> MagicT: + return self._extend(CombinationOperation(right=other, combinator=operator.floordiv)) + + def __rfloordiv__(self: MagicT, other: Any) -> MagicT: + return self._extend(RCombinationOperation(left=other, combinator=operator.floordiv)) + + def __mod__(self: MagicT, other: Any) -> MagicT: + return self._extend(CombinationOperation(right=other, combinator=operator.mod)) + + def __rmod__(self: MagicT, other: Any) -> MagicT: + return self._extend(RCombinationOperation(left=other, combinator=operator.mod)) + + def __matmul__(self: MagicT, other: Any) -> MagicT: + return self._extend(CombinationOperation(right=other, combinator=operator.matmul)) + + def __rmatmul__(self: MagicT, other: Any) -> MagicT: + return self._extend(RCombinationOperation(left=other, combinator=operator.matmul)) + + def __pow__(self: MagicT, other: Any) -> MagicT: + return self._extend(CombinationOperation(right=other, combinator=operator.pow)) + + def __rpow__(self: MagicT, other: Any) -> MagicT: + return self._extend(RCombinationOperation(left=other, combinator=operator.pow)) + + def __pos__(self: MagicT) -> MagicT: + return self._extend(FunctionOperation(function=operator.pos)) + + def __neg__(self: MagicT) -> MagicT: + return self._extend(FunctionOperation(function=operator.neg)) + + def is_(self: MagicT, value: Any) -> MagicT: + return self._extend(CombinationOperation(right=value, combinator=operator.is_)) + + def is_not(self: MagicT, value: Any) -> MagicT: + return self._extend(CombinationOperation(right=value, combinator=operator.is_not)) + + def in_(self: MagicT, iterable: Union[Container[Any], MagicT]) -> MagicT: + return self._extend(FunctionOperation(in_op, iterable)) + + def not_in(self: MagicT, iterable: Union[Container[Any], MagicT]) -> MagicT: + return self._extend(FunctionOperation(not_in_op, iterable)) + + def contains(self: MagicT, value: Any) -> MagicT: + return self._extend(FunctionOperation(contains_op, value)) + + def not_contains(self: MagicT, value: Any) -> MagicT: + return self._extend(FunctionOperation(not_contains_op, value)) + + def len(self: MagicT) -> MagicT: + return self._extend(FunctionOperation(len)) + + def regexp( + self: MagicT, + pattern: Union[str, Pattern[str]], + *, + mode: Optional[str] = None, + search: Optional[bool] = None, + flags: Union[int, re.RegexFlag] = 0, + ) -> MagicT: + + if search is not None: + warn( + "Param 'search' is deprecated, use 'mode' instead.", + DeprecationWarning, + ) + + if mode is not None: + msg = "Can't pass both 'search' and 'mode' params." + raise ParamsConflict(msg) + + mode = RegexpMode.SEARCH if search else RegexpMode.MATCH + + if mode is None: + mode = RegexpMode.MATCH + + if isinstance(pattern, str): + pattern = re.compile(pattern, flags=flags) + + regexp_func = getattr(pattern, mode) + return self._extend(FunctionOperation(regexp_func)) + + def func(self: MagicT, func: Callable[[Any], Any], *args: Any, **kwargs: Any) -> MagicT: + return self._extend(FunctionOperation(func, *args, **kwargs)) + + def cast(self: MagicT, func: Callable[[Any], Any]) -> MagicT: + return self._extend(CastOperation(func)) + + def extract(self: MagicT, magic: "MagicT") -> MagicT: + return self._extend(ExtractOperation(magic)) diff --git a/env/Lib/site-packages/magic_filter/operations/__init__.py b/env/Lib/site-packages/magic_filter/operations/__init__.py new file mode 100644 index 0000000..8eacacc --- /dev/null +++ b/env/Lib/site-packages/magic_filter/operations/__init__.py @@ -0,0 +1,26 @@ +from .base import BaseOperation +from .call import CallOperation +from .cast import CastOperation +from .combination import CombinationOperation, ImportantCombinationOperation, RCombinationOperation +from .comparator import ComparatorOperation +from .extract import ExtractOperation +from .function import FunctionOperation, ImportantFunctionOperation +from .getattr import GetAttributeOperation +from .getitem import GetItemOperation +from .selector import SelectorOperation + +__all__ = ( + "BaseOperation", + "CallOperation", + "CastOperation", + "CombinationOperation", + "ComparatorOperation", + "FunctionOperation", + "GetAttributeOperation", + "GetItemOperation", + "ImportantCombinationOperation", + "ImportantFunctionOperation", + "RCombinationOperation", + "SelectorOperation", + "ExtractOperation", +) diff --git a/env/Lib/site-packages/magic_filter/operations/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/magic_filter/operations/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5e623ccb15a1f5c7cbf20b619be72df028e36188 GIT binary patch literal 1048 zcma)4O^ee&7@jm~lQvC1cH33NkCQA_bnhyH)(;j$!4-rd5Ylv7LT8dPnTp>01ztV) z1H`*O!$VFI=IY7Y!ru1eJJW8~Xa$p(hi9J2Jnu*5v*)!CJYPS3o82`L`k@wQPi;d^ zJ^=ZMrf6zV#0+d0iq~k3nb_3aq!z2=y5<&bFdN&$oB9aa2H>gwvW)r`)NQ?BSU%*!;HLG5*~^; zO_VSWDg8sp#JOO~!8m1;IMD}6U0yk4%an^S5nH#1FSp5%Zx{4s2rNc!N#E=tTcj;`$vS5s8WW<;h!RI zDX1%GC}=8h6?h6d3Ty>!1&)HQ0(CQ>B6chws&`E}@n5HW;g8d4oXq{jO8=N(k_w+BZ~SNR#LvL()-sG1;hbbX3+HhZ%wj4CKSfB@LbVbR1eif3aiIn zxpQT<4ay;6h~X4vIK-J1TG-fDYG+R9U}T|3h}rvyIUFC^2pz+zR_HQ!2Q|H)#%x;J zzTax=YqVP^Nn@39^;)nd26sM*=P9MA&5c7d>yoC!JiJfq$&~lL%oz_Lm?H-m3GH89dR8bd7=`U zlFIZXS0kCne|mv;VmQX0c>rc6@M_%oh?=%`3ZC}l68NQ=X<@E48jXu*5AH=Tgd9X| z!IHcm4MxB~NYWK5;`umwl60dYQT*Hg5|dt%DlRw0CF5eV3k_@xC%Pti zA<{8_b8Dfcjk()5)y@3&(3!t-;LJcpo#vAE3CU^33DL`hWP*)SqpuLMJECb7ktSI? zT_IAvN(jw!p~`s`gh&Ts()<ldJYAT0dFbQ_sc06#Wlx+vmpn>xxjx`!|6_ B*n$86 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/magic_filter/operations/__pycache__/call.cpython-311.pyc b/env/Lib/site-packages/magic_filter/operations/__pycache__/call.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fd935c06af1b52280ce78f58eafef38977199f8a GIT binary patch literal 1451 zcmZ`(&2JM&6o0c{_Bt_1L-;6ag_Usefdq*jfFh(85V&d$;-i&TmPQ-TIND^r>&~oG z5-brR4nabQ15zSUq#P(M;*tZ09Qz0KU?dLKN=QhYax)4iPQ2NT4KDC@_RagfH}m}7 zZ^rv~KA!`WXAl0Xjc5R`73hh%V{DhvSOo@*_)sSfscVi_*BzYz)0plXb<;7?Hkj#K z^^B7tpuss{)-7Neo_VYTJjFK^C(E*zp=fU@Skz_T1bca1=`rSSFys#R!_7ErWOX=#X5e~B=_-yvl&j0h<*B=>7c+9az~Sqg>1yNhQ| zRDKJ^eC2e=ykNF6-$bTDL1)6K!h?m%&)!T$dJ#X|aI5p~ESHtKJL^?x&GREJro%q7 z(^YI}s<9YnDfI#`qI7BRK#x;Bzq%}P9Mv*(#`munckIsIZ*Uq~!Dk!&5St6G-{f&# zCGuRKrqB{RYKmZh5p`M#BRA1lg{a>@AUlr{J?(qs!RR9{qu$NLeJ%0;@8v^naQz^< zNwkFTxqc20S}D?}(h z97$0ZqZkv48LI}w{w>4%Y|R487BB1tH2VqHc;j45~k)e}h4CM}5} z?A0`gdB3{q4Xj{FX|_z$1J|;^kz%3YEek9V=GK-*4Vb^J{(-`5Tcsw8+ZR*)P>~6(pax zl=hP_Zkj_RMvl@|->8W>pi9Q$9)qKg5OhI-$0T@`WFD86vX!&RlvB4B$MGP!wChOv zp6$8PRSuGMB*z$6=FyguHW5urYrc8GWS^yWz1|$XLlL;Y-#EF7uVjYeI4tq+FC5b=4NfHjU|Y+*oc#w zYHrs)4L52gOw>xt54QYGWoiw7GYmvMj1r|U#gmd<3Xu237FJh?uo)&o+&VLr%Ehsr z+HXpzc407o?!Ntf;XXb`Xn@q&_M^5+OLRl%MeiS~q z5vUeTjHYp@*m@Q>O^whCs8Xg3@m)gEr^%4h%EZyOy0tJ}n`1Lo#n3?Q!qDP{l|lJz z_sWk~_P%;jUOp%<_h*)$Jw0`92&}O3LOq>3-&=h$ci~{}!o$`6%-hdUh8#n1H$>>} z{8{K0FY}*gSNX5bWnRfslbU`*36U0sXvDG|5uOp^yS5)4dkR9BC{BzJnv&2|bv;Ll zhI$`#nJ}fLsim39Auutj-N`eUUEKY6XftPV@0*_KsfX3x^@G<}k-xL}SZ3SH%C()9 zz3LEfdtA=8-$z@9Pf{Z;L}MMZbCa7b9Oe;Y;+_`OxKk!;RcdeGpRM!g8Hh`u6N$W4D^rzPV-t14Wp<86wx>wZ?pZ!DDe@}2_wEhE1 Cz(7L) literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/magic_filter/operations/__pycache__/combination.cpython-311.pyc b/env/Lib/site-packages/magic_filter/operations/__pycache__/combination.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ee38fdea3a5846f2172c8031ca6983921d52c767 GIT binary patch literal 2450 zcmcIlL1-IC6rI^!tyZ#C#kE}$*RDmAxabhOheASW3$0TUheid3_haPgwp$8chFiQ`Go_r`MD5sqA|EwfivfNAQ?CzhL z|7ZWsfAinpUlNHpf%fF5KT7|og#3+@Zi{pV?eAc)Lo8xZhm>iKmX(}BiKSSoqn5Rt z24l^NIFYiR(ApsW@$ChJnoc^-FxUIl}f$3bN$2o9apU97hTJ)tmfCN z0FNtJ!S(aJvYG$FF62Gi=T|n&;<~xYy?ohRwTrA|J3bc+ZWm5(p&JEYJHG)3!e1c+^NI63uD`yqZfbqTuUL%7bgDc^pg-Gmn4I?E5`|?F zm#<&|xR9TrKiz87KY?bAe2sX@R#SeXk6`w=r|F-;IVzbn6>q`nv?@4 z<4F{_qKmG06DC2llaX7~LxJd6(S!FM2*4pZ{^R}c@9$Qh&t0u+zsDQPtTA`@VD4@c zWYTOV&4ytL#B48yI9JRvXDo;_R(7qbgX2-gzNwl{#}Z@Ab6nqJOkn&%0}*Hi*LB1= z&M~9+i1aA8EU+3#fxvnXKy3G}mZFa7+e@vu61luvY!T>w{kA?{FV^EvuQ#sUY%VNG zlYgs0cKDc?r42gwTurv@`ika+?Hp0f7o6TV^Jg zheZcW$|7&5)ccgS^D0Eg)yML(Xi6oLL%@GfR<{XUlNExUCHQ@^t^+ z2K-J=lpB4GJMgoRRTF9t{ECHvfyh!LNhRY-p{~caSH?$SN&7@x0RuAK`x8V6wizQ7ff_D% PZ=>@pMd!m-$>?7L2ZtO& literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/magic_filter/operations/__pycache__/comparator.cpython-311.pyc b/env/Lib/site-packages/magic_filter/operations/__pycache__/comparator.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f54ab9444d6c4c7aebaf8ff37db6a45bdf84a578 GIT binary patch literal 1362 zcmZ`&O=uHA6rS0?Y_|=u#v)e5C|b#(?NJdCv<0n51Pc{HV7kdn(zTmxoZS>#0_~xP zB7(;jym+dXdhp;O2M-=Sc!*FT>`Cy{TO^)(^3CL@t)_2xzxTT{?|nP_E*iBE$fq~o z@|J?oFX41W?-;FzU~D3aD0Wd1r*Tn9D;QCQs;*kp(i+$r)m^=4qz#M|bRSV;9nlCg zwpE07;b}`cLd{u}9M~6bQVG?&rRC6^vR&8Cx@;fzM@bwGbLM;Q5+hEYlo+Fo?&EeQ zde8RR<1*uR;CQ8+SfwjQ$7rR%*hCDaF-2*G;VMbm#*L_R&oj0Ic z4SI_}oe2-rL2LkGCe@)|D~wNh#j*|Cdc3#&juPtJDJ%q`mFs2s5G>830HMKIP~oLi zt~WkJ#fZXhT>;ocRa`{`thQ7Y@WiN6D1xnViVuR9R71^YZvJq2U#yZyBo5}LZ)Ki( zd@(cSQKwYMELLQjB4W( z69T7%EvAqaU2gd>M8ZhtIIf)U$3rJ6D*fvKKtnA4diCY%R^`Xojhgn^sy`w1vH9;~ z^Lv0XdoO0!O`FG|HaQ?zF4;v!NN5pK^k~Hu_7EY@E4JIo3=rbGUf>hL#rRwU2(_%| zx%{;7&jRcqxuWcti$7X|;MHFTSnFL)MIAQQW}23wU)#zx5vcbsYVlgGW__8i-+Zt) zIU|E#sZ{@hiS;brnr$MXKgQd-*3oV6By2Y*dP^nE&c{T}x>P@YH;qA@#ZA;7 Ox5j_V%%2nTvcbP93Ps)k literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/magic_filter/operations/__pycache__/extract.cpython-311.pyc b/env/Lib/site-packages/magic_filter/operations/__pycache__/extract.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b1c109ea84b1b069621be196ea2fbe0f713e34f9 GIT binary patch literal 1450 zcmZ`(&2Jk;6o0c{wv%qwt=oKDAgY^#Tj8jP6GBLkgc1P;;R?jc)oA0HL`(L=%&sF^ zIVci6_>e=z#gVw=LQs?o2M+uZ91;|X)k>8j^~B9698gcZSvzjhl(#c)-p9;)^L{h4 zKbz(lApQE|@2gw^cqWxI(ucz7=P2}m0V5vx#3sICE52&0MA{Tj^L1M%z=<$WS3See z**O9V+ykaP2Bvd;PX#!@J|H{Kj5<_ue@V5Xrsn;xK3k#-A1*C?v|PKFs_z94)BJMG zg|p)E3Q5iPorr(hLOpiF01e}xIBRb61J}bj&0)}NFow!$6@?yfun7ZOVZ>J17&9Jg zw#IT?XL;-z*H;ZzK%2pI+|GDfT>3T^PBR{*+9zp&4{V_j;}}!qkfny;aa#nnCPFqM zDa#U1uOsV0hjf6BoDAx)PijJ-)?*viuJ}q$lPG9vEIgN zLqS)ehTBXVQ@M$2igJ8L{@_!0xUnt?DMo}m-X4>w$GA&8W^fg4l$Xy)b8 zs%Ne%m_IU+Z9y_~v#V`Sbn!by1El(fvkVVVLB;IJ$dWoYN=}^ z*Jt{m6mDg#yO>y|?eG4y=KiqecG;12=h(V~3(Q+dak6LrVD7M^V)?jOJ}j31O{^PT zQ(VIg745}M74mdzm7Kf@f#Y*Z(=kf@khMK2U!nAyw&M*w1xh0?j3Y|LRa_<{wpm&G zkOdypS&&xAWRJc;wl(^a;%i&WeU0d4+~x&l6jH-!eang#3krX7MzbItONsXhfqr$gq6l7;G6ZM50A!X_qp@q!jZn2K3SFSO zZ6|bX*Wjyzm{^`miax=t5bl{(blD!NZjgbB4;qf^e*^hUm?HrQ$`ZKuy60;e8u+FrT z(b*s)yhM2SjA){_8l@yIzzvt&Tb9I61dYsySHwv=NiK^YkVzUBhgDYr)?pU+L94$C zf&p^F9^dPc# zerR#mO5}JYa@?6*PdTn@L5o+!yEf3yfx`gnwltucp)*3M6|-<%Y{mSgaAP~iVwLFl9Il~H^ohq_7IWKT4cne^DZUFLY_-mza_18yaJ zrV>6=6G8g0qr2vT-d1&pmvoL%7g{-au9Cd)M^gPgsjehhCCNav63J8|nVN6i!qAr0 ze}W|3^X-Z9*8Md?1HEhH&&Z4OM^_^IDv^DQN6YPpR-x2HP=Ve+=${UH1_NX{5FR`% zF86c{9u$`kdVr7n@yC=`a!i)3pe*MK+JugLyDWb^q38`sK$Z=?U>dT_F$g$@KHrAq zWh5~q7?HL?c{_4QFu{#0KxW;qCP-oL?CDy&=-D+NUEI59EFP%r>8lYK-yO2M`_8C5 za^4_KzFCp?(RCB%|DMgSHlab(A?7e2h<}lwej_X7fiHzPUngRZYp_m zQ)HYShR8Yq3way~Mza;jHq|#;q!)FN?1pAwnyy)-+R-(88b9Zns5KmKv%Kb15ndn1 z)M#`o$S$j_Xg~ONXj|Tom=2E(M>AW}C_M8Vf1{55?IUA2bRF}|-|zT$fcJp_@f$w@ zfk>gWN@C^b)rTZrZmm_azua1@WOuo>*1TO5;&U^(6?%fRPuD~VO1mMFH<9w5SDxVX K)91)+O#cFw?^px? literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/magic_filter/operations/__pycache__/getattr.cpython-311.pyc b/env/Lib/site-packages/magic_filter/operations/__pycache__/getattr.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0374068e7bc7fd913a0bd3f788e4d640c974d451 GIT binary patch literal 1373 zcmZuw&1)M+6o0d`ACh7vj%BxTAgyWQgTPKOr9PBWNYaoNS{JH7=^|KGnvvOfrB!A} zb{w2y(j0Q=U4~p-C~k}|E%eYoq6ekqAQlXTo_ter4<)C(w~{tE@!OgA-n=(6`+Fbr zOR-o0q~D+Z+4zeA{6mW|*(2rn4k}#`AXo@Z<}yaQ5gJYIa@4snL$hhQ7V4I;L%Zp? z4g&*jgK!>$$Vo@CJrm#n=aAf-$XB3TIHF~lCH(r0o2h7R9vMT^sqUz*3qwjw9gW=bH?vtKN)6&|0mobujQqd9_GaWoy0qWl*ce zftHJHzrN zjm~C8yrop66m>`0RFfzaRY=VsOPGx5|8q#{JQ*A%<0xF04=$aav61^M?u|c3whaS= z=NAu47k56|z4CMUd1>KAX`wf<@c-etO9No}#nVw^-=Tq}9rskh5(H5iu$1Nyh z0`_S7UFa5;`A?He{5NZvmvdA?>O0R%3ZB=DL??8zCug_67?{kO-KijGYj*ceD&AzaX)V$Y6u*{I z@yAf4`e|$kfd0LLFO2)Ox}ttbY`xjWW>2vu1$n% z_sK9FpQ?FuP=~}nAj5<*)`wE>4)P1TA&MW_j_YScC>ODp3UlMVah&aMGR zra>qN4w1?s5=bo)hn6*c4O&b6qe*Q&J^UR%KIB6|jj! zGD2op4PzuA8X+>j_C$pC;c1c@70?|-lqZOUX!w#ZM&umIhF|clS-}&>t*RHEaVaaz z8#F6=$uHWt%kdJqW!)`4xMveOXOA1kC4*Icfq5+Kbxaf-8XTN0HnVAR zrKOzR0$~eLq+)_pfnZf60+o1KC5gySBvmE~=pk;SQb{3Uuqi}>q$6JP4s{_{GkD2! z?1_uC$~qvbr!eYPm^E7joCD%AN9L>>*cPhc8qxwMK@b+tvN%`(49THJ$&cmmWBvWF za#J7Xzp~k4e$pnowUA$|04g@q=504mt)={3eLnB#E*&Wsii?E>>g3JBf?m{0x&e@m z*#U}U3)F>u=4ct<)->JHT}^v*?Q%V%=Pq85!`T`-PNg@br{N8_&cJ{?d8uGjsMo=R z=mkUb)nd?o*un?PFZyk0%@%TbgIZL>?ge=EK;92@cDsfi1{%Q?#5`ALNKK->@1 zb%3(H+YJW}wCKlR-EORHySR4`^4Sk^TE`K;E$vv>f@3-KE^>KyTI6<~O9;8iwpX0#;4c|e@d&bK&RB%5H08)#wM>1HarCnixb#57(2!zIo^NUx}f5Vh9|&9M2qSUow`5X8vHaVoRj{X^#2C-wNi z%adeg=e?iwdg4X{;mAmvopcTC-aPCYJn9JVUS!F8O>tj#neEcb3tLf&%k?v%e=W=cdJ+0Hc(EWf7w<@e^| z%U7{x0{q?CxTm<)GJN{YEG4jcy%)dnQMyv3W&cmc3?e${=7zO4WMeTw?(uivMgsSUb0wS9e8 eI_w-g>Kt5)HIxK~p1;X9SO4MGf3I-)S^o#}*P{*q literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/magic_filter/operations/__pycache__/selector.cpython-311.pyc b/env/Lib/site-packages/magic_filter/operations/__pycache__/selector.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..289be25acebe42cffaaf1f6704816d4d1d48adc6 GIT binary patch literal 1333 zcmZuw&1(};5PxsK@@4vA{c1~P3l$7vir`5^(E3%>DyAqdfyXxcTDINn#BWNw{|FDM6buVO!IQU0J%}e~Ueef_&c6N4yqTSOGqdyFXR~Pn^zrTI z+253q@3`3~y)EonAgmFGIMgF$YSFS{DHQjLrJF$A*U&_(A?=hd} zrRZUW3p;WHKLlO&h8^;b1{9eG_MBU~?RpUxrFMA9jP_lXkRM zkiMgH9g@?X1lMN`CkZ;kNkL+nxWB+XI6DxXvo>k0yS~qb$Us1m04OQ#GmxQ-1@4^y zSR*xBBMhV#Iix@~>6E~pL%mway;&J2L^sp?Gkx<)@o69yiW7n3`g6sFD%2bZHWNfe z?k^VayEDbmjrhfiU0Sf`cvviB-E3ACJ|1*>G!CI<;`z!_oMg=P-H5T}p{{!J`?f4( z5F)IQ#>t^o?R9z;o;^^ISYNcgDvz@m#kD=w+8TmKRpFO9{}Vn%S(g6<1Sp@(18>ng zn6GZC(GAdVb!Wqno|JFgWVlyhv-9x3jol7Oz-O}Uo#_LG9&AJJ2SSE8EX=n8f*-lS-t#*z>CGwJj;eLNACy#sr=#Gz3g= zlgOB@j8mvZz<~*|r7NAM(Koa*+0>{$45=LgL)Ayu3rzy-!+>O;T1?7ELF-67XeyVE zjcBO?!zZwLGO_sd!70o07bRYiH&J%|KkL646nOXIV+VcZeUTN3VT_LLlcoMiUTt;i znlM3!;}E_9XsVRb202$hYVDHC^~0+{F4YgOU9}JTLvs!7eEslh8Yw#3B;Bx{{fXLN JN0?;7e*r=cLeKyJ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/magic_filter/operations/base.py b/env/Lib/site-packages/magic_filter/operations/base.py new file mode 100644 index 0000000..2745990 --- /dev/null +++ b/env/Lib/site-packages/magic_filter/operations/base.py @@ -0,0 +1,10 @@ +from abc import ABC, abstractmethod +from typing import Any + + +class BaseOperation(ABC): + important: bool = False + + @abstractmethod + def resolve(self, value: Any, initial_value: Any) -> Any: # pragma: no cover + pass diff --git a/env/Lib/site-packages/magic_filter/operations/call.py b/env/Lib/site-packages/magic_filter/operations/call.py new file mode 100644 index 0000000..67c8d7a --- /dev/null +++ b/env/Lib/site-packages/magic_filter/operations/call.py @@ -0,0 +1,17 @@ +from typing import Any, Dict, Tuple + +from ..exceptions import RejectOperations +from .base import BaseOperation + + +class CallOperation(BaseOperation): + __slots__ = ("args", "kwargs") + + def __init__(self, args: Tuple[Any, ...], kwargs: Dict[str, Any]): + self.args = args + self.kwargs = kwargs + + def resolve(self, value: Any, initial_value: Any) -> Any: + if not callable(value): + raise RejectOperations(TypeError(f"{value} is not callable")) + return value(*self.args, **self.kwargs) diff --git a/env/Lib/site-packages/magic_filter/operations/cast.py b/env/Lib/site-packages/magic_filter/operations/cast.py new file mode 100644 index 0000000..73bc5bd --- /dev/null +++ b/env/Lib/site-packages/magic_filter/operations/cast.py @@ -0,0 +1,17 @@ +from typing import Any, Callable + +from ..exceptions import RejectOperations +from .base import BaseOperation + + +class CastOperation(BaseOperation): + __slots__ = ("func",) + + def __init__(self, func: Callable[[Any], Any]) -> None: + self.func = func + + def resolve(self, value: Any, initial_value: Any) -> Any: + try: + return self.func(value) + except Exception as e: + raise RejectOperations(e) from e diff --git a/env/Lib/site-packages/magic_filter/operations/combination.py b/env/Lib/site-packages/magic_filter/operations/combination.py new file mode 100644 index 0000000..f2ecff3 --- /dev/null +++ b/env/Lib/site-packages/magic_filter/operations/combination.py @@ -0,0 +1,36 @@ +from typing import Any, Callable + +from ..helper import resolve_if_needed +from .base import BaseOperation + + +class CombinationOperation(BaseOperation): + __slots__ = ( + "right", + "combinator", + ) + + def __init__(self, right: Any, combinator: Callable[[Any, Any], bool]) -> None: + self.right = right + self.combinator = combinator + + def resolve(self, value: Any, initial_value: Any) -> Any: + return self.combinator(value, resolve_if_needed(self.right, initial_value=initial_value)) + + +class ImportantCombinationOperation(CombinationOperation): + important = True + + +class RCombinationOperation(BaseOperation): + __slots__ = ( + "left", + "combinator", + ) + + def __init__(self, left: Any, combinator: Callable[[Any, Any], bool]) -> None: + self.left = left + self.combinator = combinator + + def resolve(self, value: Any, initial_value: Any) -> Any: + return self.combinator(resolve_if_needed(self.left, initial_value), value) diff --git a/env/Lib/site-packages/magic_filter/operations/comparator.py b/env/Lib/site-packages/magic_filter/operations/comparator.py new file mode 100644 index 0000000..615da5a --- /dev/null +++ b/env/Lib/site-packages/magic_filter/operations/comparator.py @@ -0,0 +1,18 @@ +from typing import Any, Callable + +from ..helper import resolve_if_needed +from .base import BaseOperation + + +class ComparatorOperation(BaseOperation): + __slots__ = ( + "right", + "comparator", + ) + + def __init__(self, right: Any, comparator: Callable[[Any, Any], bool]) -> None: + self.right = right + self.comparator = comparator + + def resolve(self, value: Any, initial_value: Any) -> Any: + return self.comparator(value, resolve_if_needed(self.right, initial_value=initial_value)) diff --git a/env/Lib/site-packages/magic_filter/operations/extract.py b/env/Lib/site-packages/magic_filter/operations/extract.py new file mode 100644 index 0000000..6fd1842 --- /dev/null +++ b/env/Lib/site-packages/magic_filter/operations/extract.py @@ -0,0 +1,23 @@ +from typing import TYPE_CHECKING, Any, Iterable + +from magic_filter.operations import BaseOperation + +if TYPE_CHECKING: + from magic_filter.magic import MagicFilter + + +class ExtractOperation(BaseOperation): + __slots__ = ("extractor",) + + def __init__(self, extractor: "MagicFilter") -> None: + self.extractor = extractor + + def resolve(self, value: Any, initial_value: Any) -> Any: + if not isinstance(value, Iterable): + return None + + result = [] + for item in value: + if self.extractor.resolve(item): + result.append(item) + return result diff --git a/env/Lib/site-packages/magic_filter/operations/function.py b/env/Lib/site-packages/magic_filter/operations/function.py new file mode 100644 index 0000000..409e94f --- /dev/null +++ b/env/Lib/site-packages/magic_filter/operations/function.py @@ -0,0 +1,32 @@ +from typing import Any, Callable + +from ..exceptions import RejectOperations +from ..helper import resolve_if_needed +from .base import BaseOperation + + +class FunctionOperation(BaseOperation): + __slots__ = ( + "function", + "args", + "kwargs", + ) + + def __init__(self, function: Callable[..., Any], *args: Any, **kwargs: Any) -> None: + self.function = function + self.args = args + self.kwargs = kwargs + + def resolve(self, value: Any, initial_value: Any) -> Any: + try: + return self.function( + *(resolve_if_needed(arg, initial_value) for arg in self.args), + value, + **{key: resolve_if_needed(value, initial_value) for key, value in self.kwargs.items()}, + ) + except (TypeError, ValueError) as e: + raise RejectOperations(e) from e + + +class ImportantFunctionOperation(FunctionOperation): + important = True diff --git a/env/Lib/site-packages/magic_filter/operations/getattr.py b/env/Lib/site-packages/magic_filter/operations/getattr.py new file mode 100644 index 0000000..6e4b1d4 --- /dev/null +++ b/env/Lib/site-packages/magic_filter/operations/getattr.py @@ -0,0 +1,18 @@ +from abc import ABC +from typing import Any + +from ..exceptions import RejectOperations +from .base import BaseOperation + + +class GetAttributeOperation(BaseOperation, ABC): + __slots__ = ("name",) + + def __init__(self, name: str) -> None: + self.name = name + + def resolve(self, value: Any, initial_value: Any) -> Any: + try: + return getattr(value, self.name) + except AttributeError as e: + raise RejectOperations(e) from e diff --git a/env/Lib/site-packages/magic_filter/operations/getitem.py b/env/Lib/site-packages/magic_filter/operations/getitem.py new file mode 100644 index 0000000..5ba725d --- /dev/null +++ b/env/Lib/site-packages/magic_filter/operations/getitem.py @@ -0,0 +1,25 @@ +from typing import Any, Iterable + +from magic_filter.exceptions import RejectOperations, SwitchModeToAll, SwitchModeToAny + +from .base import BaseOperation + +EMPTY_SLICE = slice(None, None, None) + + +class GetItemOperation(BaseOperation): + __slots__ = ("key",) + + def __init__(self, key: Any) -> None: + self.key = key + + def resolve(self, value: Any, initial_value: Any) -> Any: + if isinstance(value, Iterable): + if self.key is ...: + raise SwitchModeToAny() + if self.key == EMPTY_SLICE: + raise SwitchModeToAll(self.key) + try: + return value[self.key] + except (KeyError, IndexError, TypeError) as e: + raise RejectOperations(e) from e diff --git a/env/Lib/site-packages/magic_filter/operations/selector.py b/env/Lib/site-packages/magic_filter/operations/selector.py new file mode 100644 index 0000000..8073bde --- /dev/null +++ b/env/Lib/site-packages/magic_filter/operations/selector.py @@ -0,0 +1,19 @@ +from typing import TYPE_CHECKING, Any + +from magic_filter.exceptions import RejectOperations +from magic_filter.operations import BaseOperation + +if TYPE_CHECKING: + from magic_filter import MagicFilter + + +class SelectorOperation(BaseOperation): + __slots__ = ("inner",) + + def __init__(self, inner: "MagicFilter"): + self.inner = inner + + def resolve(self, value: Any, initial_value: Any) -> Any: + if self.inner.resolve(value): + return value + raise RejectOperations() diff --git a/env/Lib/site-packages/magic_filter/py.typed b/env/Lib/site-packages/magic_filter/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/magic_filter/util.py b/env/Lib/site-packages/magic_filter/util.py new file mode 100644 index 0000000..37293b0 --- /dev/null +++ b/env/Lib/site-packages/magic_filter/util.py @@ -0,0 +1,37 @@ +from typing import Any, Container + + +def in_op(a: Container[Any], b: Any) -> bool: + try: + return b in a + except TypeError: + return False + + +def not_in_op(a: Container[Any], b: Any) -> bool: + try: + return b not in a + except TypeError: + return False + + +def contains_op(a: Any, b: Container[Any]) -> bool: + try: + return a in b + except TypeError: + return False + + +def not_contains_op(a: Any, b: Container[Any]) -> bool: + try: + return a not in b + except TypeError: + return False + + +def and_op(a: Any, b: Any) -> Any: + return a and b + + +def or_op(a: Any, b: Any) -> Any: + return a or b diff --git a/env/Lib/site-packages/multidict-6.0.5.dist-info/INSTALLER b/env/Lib/site-packages/multidict-6.0.5.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/Lib/site-packages/multidict-6.0.5.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/Lib/site-packages/multidict-6.0.5.dist-info/LICENSE b/env/Lib/site-packages/multidict-6.0.5.dist-info/LICENSE new file mode 100644 index 0000000..8727172 --- /dev/null +++ b/env/Lib/site-packages/multidict-6.0.5.dist-info/LICENSE @@ -0,0 +1,13 @@ + Copyright 2016 Andrew Svetlov and aio-libs contributors + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/env/Lib/site-packages/multidict-6.0.5.dist-info/METADATA b/env/Lib/site-packages/multidict-6.0.5.dist-info/METADATA new file mode 100644 index 0000000..9d9b4a7 --- /dev/null +++ b/env/Lib/site-packages/multidict-6.0.5.dist-info/METADATA @@ -0,0 +1,132 @@ +Metadata-Version: 2.1 +Name: multidict +Version: 6.0.5 +Summary: multidict implementation +Home-page: https://github.com/aio-libs/multidict +Author: Andrew Svetlov +Author-email: andrew.svetlov@gmail.com +License: Apache 2 +Project-URL: Chat: Gitter, https://gitter.im/aio-libs/Lobby +Project-URL: CI: GitHub, https://github.com/aio-libs/multidict/actions +Project-URL: Coverage: codecov, https://codecov.io/github/aio-libs/multidict +Project-URL: Docs: RTD, https://multidict.aio-libs.org +Project-URL: GitHub: issues, https://github.com/aio-libs/multidict/issues +Project-URL: GitHub: repo, https://github.com/aio-libs/multidict +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: Apache Software License +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.7 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Requires-Python: >=3.7 +Description-Content-Type: text/x-rst +License-File: LICENSE + +========= +multidict +========= + +.. image:: https://github.com/aio-libs/multidict/workflows/CI/badge.svg + :target: https://github.com/aio-libs/multidict/actions?query=workflow%3ACI + :alt: GitHub status for master branch + +.. image:: https://codecov.io/gh/aio-libs/multidict/branch/master/graph/badge.svg + :target: https://codecov.io/gh/aio-libs/multidict + :alt: Coverage metrics + +.. image:: https://img.shields.io/pypi/v/multidict.svg + :target: https://pypi.org/project/multidict + :alt: PyPI + +.. image:: https://readthedocs.org/projects/multidict/badge/?version=latest + :target: http://multidict.aio-libs.org/en/latest/?badge=latest + :alt: Documentation + +.. image:: https://img.shields.io/pypi/pyversions/multidict.svg + :target: https://pypi.org/project/multidict + :alt: Python versions + +.. image:: https://badges.gitter.im/Join%20Chat.svg + :target: https://gitter.im/aio-libs/Lobby + :alt: Chat on Gitter + +Multidict is dict-like collection of *key-value pairs* where key +might occur more than once in the container. + +Introduction +------------ + +*HTTP Headers* and *URL query string* require specific data structure: +*multidict*. It behaves mostly like a regular ``dict`` but it may have +several *values* for the same *key* and *preserves insertion ordering*. + +The *key* is ``str`` (or ``istr`` for case-insensitive dictionaries). + +``multidict`` has four multidict classes: +``MultiDict``, ``MultiDictProxy``, ``CIMultiDict`` +and ``CIMultiDictProxy``. + +Immutable proxies (``MultiDictProxy`` and +``CIMultiDictProxy``) provide a dynamic view for the +proxied multidict, the view reflects underlying collection changes. They +implement the ``collections.abc.Mapping`` interface. + +Regular mutable (``MultiDict`` and ``CIMultiDict``) classes +implement ``collections.abc.MutableMapping`` and allows them to change +their own content. + + +*Case insensitive* (``CIMultiDict`` and +``CIMultiDictProxy``) assume the *keys* are case +insensitive, e.g.:: + + >>> dct = CIMultiDict(key='val') + >>> 'Key' in dct + True + >>> dct['Key'] + 'val' + +*Keys* should be ``str`` or ``istr`` instances. + +The library has optional C Extensions for speed. + + +License +------- + +Apache 2 + +Library Installation +-------------------- + +.. code-block:: bash + + $ pip install multidict + +The library is Python 3 only! + +PyPI contains binary wheels for Linux, Windows and MacOS. If you want to install +``multidict`` on another operating system (or *Alpine Linux* inside a Docker) the +tarball will be used to compile the library from source. It requires a C compiler and +Python headers to be installed. + +To skip the compilation, please use the `MULTIDICT_NO_EXTENSIONS` environment variable, +e.g.: + +.. code-block:: bash + + $ MULTIDICT_NO_EXTENSIONS=1 pip install multidict + +Please note, the pure Python (uncompiled) version is about 20-50 times slower depending on +the usage scenario!!! + + + +Changelog +--------- +See `RTD page `_. diff --git a/env/Lib/site-packages/multidict-6.0.5.dist-info/RECORD b/env/Lib/site-packages/multidict-6.0.5.dist-info/RECORD new file mode 100644 index 0000000..f65dc95 --- /dev/null +++ b/env/Lib/site-packages/multidict-6.0.5.dist-info/RECORD @@ -0,0 +1,19 @@ +multidict-6.0.5.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +multidict-6.0.5.dist-info/LICENSE,sha256=k9Ealo4vDzY3PECBH_bSDhc_WMPKtYhM1mF7v9eVSSo,611 +multidict-6.0.5.dist-info/METADATA,sha256=h3huVEq0b4Cpmc-wiUEVMOyBh-BCjaO-0i9gTBlqaK0,4346 +multidict-6.0.5.dist-info/RECORD,, +multidict-6.0.5.dist-info/WHEEL,sha256=ircjsfhzblqgSzO8ow7-0pXK-RVqDqNRGQ8F650AUNM,102 +multidict-6.0.5.dist-info/top_level.txt,sha256=-euDElkk5_qkmfIJ7WiqCab02ZlSFZWynejKg59qZQQ,10 +multidict/__init__.py,sha256=psbRrP64CD22Wjoc_OoqG9QlkRGcaZfOFCoPmoUiMig,928 +multidict/__init__.pyi,sha256=SbgC2ew1NvNXWlRKs9o0KhW4moozgMqgQ0OA4Re5JQQ,4840 +multidict/__pycache__/__init__.cpython-311.pyc,, +multidict/__pycache__/_abc.cpython-311.pyc,, +multidict/__pycache__/_compat.cpython-311.pyc,, +multidict/__pycache__/_multidict_base.cpython-311.pyc,, +multidict/__pycache__/_multidict_py.cpython-311.pyc,, +multidict/_abc.py,sha256=Zvnrn4SBkrv4QTD7-ZzqNcoxw0f8KStLMPzGvBuGT2w,1190 +multidict/_compat.py,sha256=tjUGdP9ooiH6c2KJrvUbPRwcvjWerKlKU6InIviwh7w,316 +multidict/_multidict.cp311-win_amd64.pyd,sha256=MlVd79sERxTbquwoGCD6egwiZUXUBWG5BSlNLgvboQI,46592 +multidict/_multidict_base.py,sha256=XugkE78fXBmtzDdg2Yi9TrEhDexmL-6qJbFIG0viLMg,3791 +multidict/_multidict_py.py,sha256=57h4sYrRIu7EjMX4YpHVIZVrV9-q1KCW3F6rao10D3U,15050 +multidict/py.typed,sha256=e9bmbH3UFxsabQrnNFPG9qxIXztwbcM6IKDYnvZwprY,15 diff --git a/env/Lib/site-packages/multidict-6.0.5.dist-info/WHEEL b/env/Lib/site-packages/multidict-6.0.5.dist-info/WHEEL new file mode 100644 index 0000000..d60b004 --- /dev/null +++ b/env/Lib/site-packages/multidict-6.0.5.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.42.0) +Root-Is-Purelib: false +Tag: cp311-cp311-win_amd64 + diff --git a/env/Lib/site-packages/multidict-6.0.5.dist-info/top_level.txt b/env/Lib/site-packages/multidict-6.0.5.dist-info/top_level.txt new file mode 100644 index 0000000..afcecdf --- /dev/null +++ b/env/Lib/site-packages/multidict-6.0.5.dist-info/top_level.txt @@ -0,0 +1 @@ +multidict diff --git a/env/Lib/site-packages/multidict/__init__.py b/env/Lib/site-packages/multidict/__init__.py new file mode 100644 index 0000000..23142ee --- /dev/null +++ b/env/Lib/site-packages/multidict/__init__.py @@ -0,0 +1,48 @@ +"""Multidict implementation. + +HTTP Headers and URL query string require specific data structure: +multidict. It behaves mostly like a dict but it can have +several values for the same key. +""" + +from ._abc import MultiMapping, MutableMultiMapping +from ._compat import USE_EXTENSIONS + +__all__ = ( + "MultiMapping", + "MutableMultiMapping", + "MultiDictProxy", + "CIMultiDictProxy", + "MultiDict", + "CIMultiDict", + "upstr", + "istr", + "getversion", +) + +__version__ = "6.0.5" + + +try: + if not USE_EXTENSIONS: + raise ImportError + from ._multidict import ( + CIMultiDict, + CIMultiDictProxy, + MultiDict, + MultiDictProxy, + getversion, + istr, + ) +except ImportError: # pragma: no cover + from ._multidict_py import ( + CIMultiDict, + CIMultiDictProxy, + MultiDict, + MultiDictProxy, + getversion, + istr, + ) + + +upstr = istr diff --git a/env/Lib/site-packages/multidict/__init__.pyi b/env/Lib/site-packages/multidict/__init__.pyi new file mode 100644 index 0000000..0940340 --- /dev/null +++ b/env/Lib/site-packages/multidict/__init__.pyi @@ -0,0 +1,152 @@ +import abc +from typing import ( + Generic, + Iterable, + Iterator, + Mapping, + MutableMapping, + TypeVar, + overload, +) + +class istr(str): ... + +upstr = istr + +_S = str | istr + +_T = TypeVar("_T") + +_T_co = TypeVar("_T_co", covariant=True) + +_D = TypeVar("_D") + +class MultiMapping(Mapping[_S, _T_co]): + @overload + @abc.abstractmethod + def getall(self, key: _S) -> list[_T_co]: ... + @overload + @abc.abstractmethod + def getall(self, key: _S, default: _D) -> list[_T_co] | _D: ... + @overload + @abc.abstractmethod + def getone(self, key: _S) -> _T_co: ... + @overload + @abc.abstractmethod + def getone(self, key: _S, default: _D) -> _T_co | _D: ... + +_Arg = ( + Mapping[str, _T] + | Mapping[istr, _T] + | dict[str, _T] + | dict[istr, _T] + | MultiMapping[_T] + | Iterable[tuple[str, _T]] + | Iterable[tuple[istr, _T]] +) + +class MutableMultiMapping(MultiMapping[_T], MutableMapping[_S, _T], Generic[_T]): + @abc.abstractmethod + def add(self, key: _S, value: _T) -> None: ... + @abc.abstractmethod + def extend(self, arg: _Arg[_T] = ..., **kwargs: _T) -> None: ... + @overload + @abc.abstractmethod + def popone(self, key: _S) -> _T: ... + @overload + @abc.abstractmethod + def popone(self, key: _S, default: _D) -> _T | _D: ... + @overload + @abc.abstractmethod + def popall(self, key: _S) -> list[_T]: ... + @overload + @abc.abstractmethod + def popall(self, key: _S, default: _D) -> list[_T] | _D: ... + +class MultiDict(MutableMultiMapping[_T], Generic[_T]): + def __init__(self, arg: _Arg[_T] = ..., **kwargs: _T) -> None: ... + def copy(self) -> MultiDict[_T]: ... + def __getitem__(self, k: _S) -> _T: ... + def __setitem__(self, k: _S, v: _T) -> None: ... + def __delitem__(self, v: _S) -> None: ... + def __iter__(self) -> Iterator[_S]: ... + def __len__(self) -> int: ... + @overload + def getall(self, key: _S) -> list[_T]: ... + @overload + def getall(self, key: _S, default: _D) -> list[_T] | _D: ... + @overload + def getone(self, key: _S) -> _T: ... + @overload + def getone(self, key: _S, default: _D) -> _T | _D: ... + def add(self, key: _S, value: _T) -> None: ... + def extend(self, arg: _Arg[_T] = ..., **kwargs: _T) -> None: ... + @overload + def popone(self, key: _S) -> _T: ... + @overload + def popone(self, key: _S, default: _D) -> _T | _D: ... + @overload + def popall(self, key: _S) -> list[_T]: ... + @overload + def popall(self, key: _S, default: _D) -> list[_T] | _D: ... + +class CIMultiDict(MutableMultiMapping[_T], Generic[_T]): + def __init__(self, arg: _Arg[_T] = ..., **kwargs: _T) -> None: ... + def copy(self) -> CIMultiDict[_T]: ... + def __getitem__(self, k: _S) -> _T: ... + def __setitem__(self, k: _S, v: _T) -> None: ... + def __delitem__(self, v: _S) -> None: ... + def __iter__(self) -> Iterator[_S]: ... + def __len__(self) -> int: ... + @overload + def getall(self, key: _S) -> list[_T]: ... + @overload + def getall(self, key: _S, default: _D) -> list[_T] | _D: ... + @overload + def getone(self, key: _S) -> _T: ... + @overload + def getone(self, key: _S, default: _D) -> _T | _D: ... + def add(self, key: _S, value: _T) -> None: ... + def extend(self, arg: _Arg[_T] = ..., **kwargs: _T) -> None: ... + @overload + def popone(self, key: _S) -> _T: ... + @overload + def popone(self, key: _S, default: _D) -> _T | _D: ... + @overload + def popall(self, key: _S) -> list[_T]: ... + @overload + def popall(self, key: _S, default: _D) -> list[_T] | _D: ... + +class MultiDictProxy(MultiMapping[_T], Generic[_T]): + def __init__(self, arg: MultiMapping[_T] | MutableMultiMapping[_T]) -> None: ... + def copy(self) -> MultiDict[_T]: ... + def __getitem__(self, k: _S) -> _T: ... + def __iter__(self) -> Iterator[_S]: ... + def __len__(self) -> int: ... + @overload + def getall(self, key: _S) -> list[_T]: ... + @overload + def getall(self, key: _S, default: _D) -> list[_T] | _D: ... + @overload + def getone(self, key: _S) -> _T: ... + @overload + def getone(self, key: _S, default: _D) -> _T | _D: ... + +class CIMultiDictProxy(MultiMapping[_T], Generic[_T]): + def __init__(self, arg: MultiMapping[_T] | MutableMultiMapping[_T]) -> None: ... + def __getitem__(self, k: _S) -> _T: ... + def __iter__(self) -> Iterator[_S]: ... + def __len__(self) -> int: ... + @overload + def getall(self, key: _S) -> list[_T]: ... + @overload + def getall(self, key: _S, default: _D) -> list[_T] | _D: ... + @overload + def getone(self, key: _S) -> _T: ... + @overload + def getone(self, key: _S, default: _D) -> _T | _D: ... + def copy(self) -> CIMultiDict[_T]: ... + +def getversion( + md: MultiDict[_T] | CIMultiDict[_T] | MultiDictProxy[_T] | CIMultiDictProxy[_T], +) -> int: ... diff --git a/env/Lib/site-packages/multidict/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/multidict/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e711fdaba66ff57d3b04d668f94a57b37995ce39 GIT binary patch literal 1141 zcmcIizi-n(6u$G1#If_E5U5&MPAW@;2uKBn3L&93sFB)Ikyd~e$-3Cr){4(|&*!x1 zRPi?;7+Ba4Vr5`uXXsdYWn#0`CF;aoXiEXX1n1MI_wIdu-@EtjZKYxYu|B;1yzxc_ z;EQxlmv&+ty%5GL-~k(W&{G0P6Jl!sq0MQeL7|)@I7J?Er zZIfEIMay=XR_qF`+ErS!YY>E2X8hhG4Ig_4dZ=yCwJ+g%dBtbMvcrZkP-zNy8v3M^P1#slz5J`@i zkO5&hKm#14;*X7pA-*MqFeRu@hE4M;6isa?S$TYcWgN$%psc=}a@-5Z`NIaxs_UJW z(|WqrTIsYOt#leCCT0bg98gvra~DJhR#~(=%qHgBznqlL{LDHR%=9!CSIsnEqPa=9 zC^-?W+tcqhZ#C~U3alhmiV_S71qo#dmVlMU#jNN!UgSDXra8Fho~x?pxDkypXS!fY z8V&+MvmEC{L^^F6M~t@^i-f*IPka4$*{t$|>BK`O-|stcBoG`wT$t-ViCDioA9Wr$B9T-^vShSU9w%a{%=#ht=r= zV>(xgdLak@7Do95FzPulph$fN|3m3}<*LvajYjz-C{^}#`6V^cyqA}*gZGyosOl#L G3j7B4JUamZ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/multidict/__pycache__/_abc.cpython-311.pyc b/env/Lib/site-packages/multidict/__pycache__/_abc.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5f2de2af9624576dd66bd864a02d781eb1b90c66 GIT binary patch literal 2745 zcmb_e&1)M+6rb5|$+Fy5X=M6AWv3~qNfnp04TMri+!9J+AL2ql2$t3E*p;=?stZ{Eku@6Gy` z>FGFu=eM8#Slv?y`3DDQkJjyUoQR~=cDG3Ij|1F+AG<7zaAlFoI29THGzy3cyAzeTp_9<18$tz023 zipi)!qsII&agS9QFWGn8lI6FgQ1O|&8p>tX@Nr2d^YZSOw+oLvUM?(p4#ZR_*SQsV z+$?%QfmJsO4@$*?UkcbqHOnqrYs@cH>TXbSN_KF=w2F4F)_{b}H5PzU#WXk5ec9#u z1WEAczX{MJf2U>-Q&*ok&lmqpEgYs64iXC;%xz!;FiEiic=|hJi>wfiG;0w)4NW(G z{u=c8>i`oSr%+o5Xp*B;`tg1K2K1M+T4lVJHd!W8?_v$A19O?7i(cF{Tdn^zLVW>2nAATw9^BkK1Gn z#A$361;Y?ILh}P$#NENC^AKPH7ZuTL;Vb znL{+wJ03g$;HNMh!H+aLC>k2~S>r3tJ>HTzo$s1L7d-nG4O7cr@O7o;vI?sP%n_{2_Onvmu-rNu!1g?{lmnB*5^xdFdXb;gFOlV3$8u{A>d zCJsMExP>rOoLQVh!1DEX0mc>QJQnACe_hVE`|9$4#ILfnG1P24$`S8KJ_QiY*q-Y$ zJAf~ipM%SZ<2}n26zO;FF5tac`)v;txZ$-rj5drD?eR3!THm3VMeF0MWgWK*0ZvhKSAN?xyGd#Trdi| P*Pka(aQ<|RP}Io3zk)6} literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/multidict/__pycache__/_compat.cpython-311.pyc b/env/Lib/site-packages/multidict/__pycache__/_compat.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d8cd8b5b35755cb28e8b71fc394ff2ac85af7435 GIT binary patch literal 708 zcmZus&ubGw6rR~1+09Q=F%}h!XiLdKiy$7Prj#~9pr*m3XqKhRCOeJW>}Hn9#3r{r zdMqOJ;H4+66g>F{n7fBWatM10cF4eW z1mL$1W+whE&VI1s5E#IK7Eq=cDv$$+Ltu}ejUNfK>T))?&y4qk-KkwgipW^tUf`n3 zijx@t24CZRph!rJ0L&pN0u&j^WIhNC!4R#W9a2J&=_-H+0EHI-2{05;M6XEvUxuQ92q>)0^sRkhY6I>kgQW2&ZVy% z8zw~$9lcW1tEiz~=w8+;*miXK$Z4O;D>gQo7D|%@WA*>o_{PGBhY$`x(4F`ITyrNr zjNdpA4qkm!4tGB6bQhlY66t;--HWgGkrmip4t@zY<@V^hAum>kIWy8k=lLHOnfKr#6*3~t?hADcSUCML(@@ksJ{e6q%M UCb=UA*5aTOm)7p^o!gMbKVWRT)&Kwi literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/multidict/__pycache__/_multidict_base.cpython-311.pyc b/env/Lib/site-packages/multidict/__pycache__/_multidict_base.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0186758cb6e497d275cc0d492627e4922569a7ad GIT binary patch literal 6742 zcmeHL-%lIK9pANg?X}miCWeFb;Ih61a=uHr<_<0~1#)d@sw8(*J)*k`QCY^jAqM{- zvukpItwU`eOb#g~N`y~MBwm_^%S%-Cuc#{3MwZT62`N&actb+!L!SEmj_t)i!V#)8 zk*bV#Kc1QWdgeRx{W}JB z0V9D>MAML7e)jpuz{FQ^GBa@@u7qP#6Eg`C)Z-*D8P_M&*xbZt;mHXttgEMIgQ1z= zl&Vcc6A?YEghTp=0kayI3~Flc?7Yz)2u_9qKp)lUM3tEdh=}3f)s6xzFB0@t1u@|?H8d2^Mg#4ajC zrJy{pz1sn}#w0BYJ3~!}{GwXZlB`}aC?I|a^~Yvgv+FoYxr{M7@?S3XdRg<0t<~8X z`ky$TWRmO*)#Nec$5Q6!vsca!T@|q?R^WpfVSeXGS(DZzJI4|$*cbG!I2Dfa$iKEd zqf%(tGh3M-JKal4;{tyGyJ>%IoYLJabBg9z;zxLG(xuu~mM&{bm#LR7`ca=_l;9?A zqgGzLx=rh7HQTtTZCs6yGn`>99Mkk*ETj?}bQ#T~as5(sHljw=n64^@HKN9Vjzh~e z__%&uC59zFYj7%%XgHJ%rR0`c14xA~Ra5l<35TwSqO-&cG;VmczXB&qOwsO0|K|5M zmu_xJN3-33_T;7Rg4Dgku#R`PJl>qkyCogT^exY?%s==zoA_?v{=lZxos-T!I`O3Y z`_nn$Y|$a6Z`^86x9>ZE*qqjv{VV=^TDE_6;qJnw=*@}VqNgL%Uu^BzVJwa=3h9xe z!N$UsCV={VSo&WCg{mYwDPfj}bsP9St_d_}1oH;atItEYG`enNQofgK~l5Q`#UuupZL@cN})cs;8 zuMO^pa=ECO<&tD{)V^}5b=9O($ADNaI>y3ssdv=1t~phcb^vGp%?x$!zHSD#&b{wD zgSP(~4wwO*;R5W`7(>&74IB9hte&9Zk+%`3)mp*e3=Yy4vSA@z*!>QGhEl5-r@O{D zgE57igs&gNySoYisg2l{Q6Ky^FZL9~9&tSh19u0OzghVv%^^wm15e)GRj`9;vAlQ7?YTFSZCkx^_e$O^7u<51FO5Hz7rh11 zyB|?elrr7RgE{Vv-c_f@uSxG9DJtt7ISx8PdH`yaN~%$+I3e!?#d#!s4}m6{Z(Ij# z1>~P##CvC*)T?qGaDMo45!U(zEip+>0k>D+eIvu<0nYgqxqmn#9Y%&XwB zh~b-ta10Z0f-2>bmZT-g%rW$&z|xa~1@mTN0s~e2Zx)+HIc22|j%v7Z~2sl(04(hXDwNqY%8i z9{?;dPn(WFw!&k|!XHhuMbVYv(*CrcrgE8n$kkkJPem!+*LbAG^Bi5_CREm#DJI3z z^HA>u_@k5sPDSiGd}%BSyIz%;?0tv5vDPLgwHD1XD<3MB^=fZt{<&U{Qk-JlXBK7} zxu#_rgFG!su6Aa~?zzzg=c1RS24uu%mQ(UG+hXdy#guP@H*CS#Sv95@wrg<`4MJvs zyK6WCaDNiiv_QZR0)bdCss;i+o(c)ld`&ml8S)X#XK<5oWnRNH59C$JAEYXY5p|Z3 zpTl=N{%TVIkk>n1OBagnR*dYu6qdO(n?6$%#M{nW&dlHso}Nul&-#r=-n{2j!E-7v zoGu8E(BlJP|F-{@KQp#GyfVBrQWQP6&)+(q?Ylo*c>AL#BYDwZ5dAsM-xyJFx2T*C z)@1Tipe1Jjs#TLALwAPOTk@Xc1<&!kaH1fb$kFF;s#0yr|ECfnzl6ci0H~OX`^cJbM_6^ZI64VfSQBLpzn&7oA zz4f6dOnM}sIVDX>Xo#n=gP=nt=n|*~(iKzhOjVHHC_NJfqj4n>QHRN|fetlDa{=yH zS(Ys_mvb-n?ATZqPn;DHSXRbn8KC(tHp?K$ECewVF0u|5?u<<6Fl)5$fF{qncNi1g WJUf8RGC=dkzt#~~H_cJ#Zv6+{3yX^Y literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/multidict/__pycache__/_multidict_py.cpython-311.pyc b/env/Lib/site-packages/multidict/__pycache__/_multidict_py.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8c2a91959cbe045019f2ec5774ac2e99e4771bd6 GIT binary patch literal 29031 zcmd^o3vgTKmEOI0g8&JT;F}T!iXuf&B5ms7NV1+5t(Rr4^{|~Vau^7JBuaegUQiDh z^m5Z=0%_P9Qt1`!l{c_fwyBLX;ihS-Y||v$$2IXIVkjK4g#58IeH1QN?9x;zv1}(U@gsmgiQQM$x)IMnEITIIg ze1J!NQ+X~o=!|e@*?TD}Y&&PAU%?UK&${S}!k}x+9JYTIzb0-!7j}G=3p*q356pND z{^T%N8L1qs3RfVP2X8TjU19Dt{{d?IP5j9r=w;>IC|_wz8LVb0RY>s^rJ%uhrxz*J zk(!9@0}GyrKRFEgSZWPYeGy+#jcQq1Ez;^x(q2@uj-}QkwINbhRI;9>H6pF4s5T8O zr5PzLMJbIeWd%}JMj9iQvrS4Ji{9JJ^0gx0DweNhiF_+qK0orcv3x6+$k!U?k8y$3 zA5-!`fX`clf)Kon3v=*f=wlwS0aM=n;^atl_{HGF#PHbZyzj-yXz=7nL?0P2eN1Ed zu@fLfrIbL|l=6sB@CFy>j&XPRfjb<%Av7Y2lc=SYM?81q|!zWLO!_i33L@;zNcse4U7^ND8heOe)hSbZUiOancm-FuZk+Fy{ z9NIH7925l)UQk69umenUIZsWZ;t?*n5CJ79Ren^Dm>XP#qe(Gn3iE^JuxZc|Hlvd) zdCRaE6=HRJgJQ%#JSIlQP^aMw5kF#kj}HW_dB@PuSa38lG?cFx8X6rBPma*FduZtV zWN@UAVjmg`kB1QL8X6iF@r?>YLxLOc6{-nPWd)xCYH%SEGEA$V2bNVC%c=)8_0uoV zM=nJL3>{BM&N}`iE^cs9rG>bQb5V6tahwqmMNgDXVPr!H^B>+(x3|02g*pX2XWHDnrhXRG!|ReLgyJvmq9%ofSDB4b&>`Yz8OG2nvI zH;)eBfyKB00tIXUv_@=a38h##>rk%3mUFCs1Z&ueT+XoV7|0^}$Bt$lM6)oRY(qfh zQBi0`A;Xx_o7tFc$HfiqG)8Jjc`&Zi>Nu#8xG)lABH+h3frxLwB&@+t-aR}P5|qBY z!{;qxWaN~-H-WXoW5dy*p;#5GVy|-Fh2mlx0On17W5P1y$~oNk98C+3rmUkyaAPV);>C3U)7&rIwFy4wa3WU@T*pzC!Ns*Nad}L&?OkAG0T)w4e@jPQo%a2%`GtMggjMHWpW*YS&3Z#3^HJ z&D+LLo{fZ}L~+F7SY-SZNQ+s#Eash4sf+8uu};GU7_vO_YnWVk-HX z?)la%_|~M4XMNq0ulrlaK6>r$rXM_;?b$E&?9cl4XWaW)uM7k#gj$pl>Ie`G%{x(@ zk@2Vq+7_Tl8VR9~QmSZnM@A!K(O?v_J8vPv$ZAte1>30%fe!qMrvRqaPtMypeQ?oY zvaVR1}nl&Ko^sD++i24 zE5nd$AOTeZdcu%o1|jW4AhQ^Ue$W@Tf|z&(;`Mhmvir~vEJJB8U{ zJ{P&HpC2Ga(c$PwB<5yBxL3a0ipL0E0>qF)O0#jz5k|7N+{VS%EyU2%xGD|tBF=FY z(+J(df7JoJR_WMTwFUh}bZp8THw&gX_-@=Ry5gp&O?$^Aj}+4}E=tlyA%snFK88HT z?)nNJFvoh1Mxv9#m_O(r0kidwpYjJsM*J6oBa;!)KN^gN&OqewN6$q3=$&4})FuK$ zob?gWmbZABB)?X50$ni0Pnl3j{)*)sYs9zRaq~6Pj0fG$csT)ZI#ch{d44$0pA(4W zCd;Qes)vPh5iBTO?w^=ZX+s$6J%bYf@BFAoN$FDlx*ePlco91(ZoLdmfUWyLiB zzntbWReR;{wO5lzQhcg!{>a^~@4PnuTH^dX;QVWB5I?PcA#&M2HXik#8lM~sZ}WEu zcdP=I37kNZq0A`kL!&|ATtvt_keRXKfR#~IfiNO(4@XV~A$H}>LPQjHBT8+=Zka9H zH=e!zY)Z`f+9h9m!jV&Ik2a(&w<{!nAFi@hd!?$q33JX> zMN_pQ=c`W~g5*XwEy;`TpUyP&;G6R`CkF0U)n^*I=Z<9?p3YYFNmYFrN8d7dn?^+* zA8RqdOJM73UWNpgDeIIiZi$;^BoHidTL_D&W86&jW8f_KU|F0s#V+oTV5o)#;44Ga zQar7wAnc)VG&n2*la(>^51&$y**`35W9|=*g>mOEj3T8$9J>I74EL(f5}rf<2zvqU z*tMY-_EGF^0y_y1{xN(ONdjV(C@|bSp}_cJoGD$Y<~np>>kY8#7iprK_pCN*?{ zjyszexUxU7CviU6mh*U%2d+*frg9C9Ne6uv&761T16R$vYcsAkd_MyPRPurf5ZR)? zM>G*19|a0z^bRk)fO5hX00RYu6pu!dKnMA$xg%bES+ndNF3HyH(Ya0Nd0)h9rkgXPg=y^mpuNA!!MI0eYI44B#EoI0p(bvk+ms!Y0jHRB4ZjA zFR3%uo5+AFS1QQKZcpN^k4RjDoad=YZkpXD`PO7T9g?Rb#~>vu?iLE-XRk(jU8i`9{H2$W2G1=-|A6^pIM@cvkZ+!iVm!M#Y! zWQg*f##HUi=B#Ip)E3v!D@=r1x-m96vmy@2ccc2|G^aM* z+?MrpN}kS)qf;I(J$hBUJ=t)MP|stL6td0Tx(+-z)1Klj>-6X*v` z@L*SVh#(G#Aa?mlqAhNVI|@%VLmhzU&a4cRxU8>X+143rX2@S8&g*N9C4f#4SL$D^ zm_Y3VRQoCCR7IRmt2$#XKbHN@D6Jg}!PxpKSG*$bDr#3ZwJTsA*mpeO7Mf8`AhwXV zE2_$>f$=CQUD#?f5@xF=9jSbkGMi(=6T+9M>`MfQo#0_inP43Ul@dT;Pm$1jCYm=5 z_vKCJHsnng@Hcd{mV zG*$EVNJ>a=NDDb%U8?5#mgE-P9)0Ih>Qb)7pW2+-43W#<1;IVJ>AtHf5uJ&Fp=Did zlB@0gV{>)y4c;DHa6OfAJ(cq{CO79G+#R}p=-T1g!;75RiN!d;m3|WEa@F-Wnyxpc z`rbXAt?rbnI}^{5eD~bdi;0V@qRB~;?iwC=e2Hi&DWHL6q~HuLmJ^JONQ?=)lmzc# z)5kmo89r`~n+g)VGG)94)H=QoqKt8&6tL-Jo872Ru~batLPi34_@Mv}jYHi5ohOi> zM&ZL++}BV*+z$XLv1Ey)6OT#P;apKhJZ?!wlTleX_S7aOOBtU^NpIsVumJIC{FVl2 zFdkFUSiE2_>UL;A(t1j+z6!%Z!^ncB;DWjUxiwo4X0>JDQ`36CLFS`IY{Vba%)Y?! z3=dvg$;b+p<6$n%9$O6Je6g_n3U`C&xf$8`VTx6(eSK=}Hvj8w!W7v+Y^TNr=mjwD zJMbuNf*VBGPo3LO!_IJNLf9E=Q$|#XOh7o)E!mYUe-{rDp8@z!_+ZiAco^S5h|ZtC z+m>2!uW9{4)B3q1^L(~xgVeM^PSry;o-xPv*QdH(p9<`RUcqv9e0WSITa$P!soO#$ zL6OvLwAxVAp_Y^5VWY+eBCK3XD0>Sctb9L1ReT;mUa4HZdReZ)-RO^Ee;E6I{0DK| zXB!VofS$vW=WxQ3^EBP__!m6>bnWd{scp+$2#~uZ&#sJP7pt+XhORAA4a&2rA8!&4 z5Mb*n(h|!A_&8nBf4G!rX9XJj|>-`D&#P)CF0wLXos) zj0v!198ds_RX&R*-s%J8Re+6a?*_rOZYTz|EWt$yM$pPznZ=<1Y*uSvku!oS-UHg%t$YRJTN7DPvNMs@4q(r}at+rg4uos83*T zQms0_jVFmm0c5$O{e9=Rc4k&V41ZSgJPYl)v+90L3uZ%g%gQq|Fn<7jDj5FRq@?#G3( zJ08!zXKXkb(_@Y5$}}`SahcZE!%;HvVUZ?G<25n~EpD!bGRI)chaFv=vb_{}3uOwr z47Q;DM)Nz(Z?Cwy!njTw0HPA7(M&!<1Kl!X&)4WGL4f38nZz)=HbZ3se;8c@u)!mDgup&p4X@50Dq(>v%8d2nmN}=?I(UaEU3JFN~0U z4~0}h0#(m9w!O3M?d>8upURD_;vpdtzqJo*7r%E?0!t0od?jv-;QqOo9-l0$I{fdo~-?7=Q(4|X$qu+9gL z*@V5!CS1*I!Zpk$>aJZY7MR$A`OF$?9PX~rZBwL2AjimfGy#A zz!l*Jz?ESy#FHk*6k<;i(U+C4{)@xWGfW{XPEJgW3uGh|{Nc%ok>OA<%FLpo(Jo2? z4{4JgktA+pV@A}6aHP;*T30H)h*Dah<=GOeLYz}Pc?*e5dE2>*^lMny$-+~OO8-^4>4&JYxDf!9rmp$gtFy0?*z>^Q ze$#!`ojjg;CcWwQPN{v{-F|8NK-TdalH)fr%2&p!9uzh#Xf23fxl3aUM4$U^wHG@0*nY32@5PwtXAJ8io3`kqs(Wxi)_pG?2~%-WqtcH?tP^+ z%ZewkKA?pkDR!tY+E|Yw@0#V8>P058UN;t=b4P-8M%FWJSY5T?W0LUETd2( zSu`ro3cR|mW<20upsda%L;rjghYF5X>U<+ND!q=}s9}K%1!R>d2WSqtGz~#XC|*&~HmJUS1X(+24u-?AN_Cifar>{4K_u-s5WYko>2S|f zNRFm^4*!C~pYEFL|MtP(KR6${Gw{*C-RCoH&t)BZCCA>3V=tTqXDaSFRxLPIWgTsj zqb;L+OQ`@=i4E2vTo|dq6mJ41|IL<1iu}TseP6<(3yLwJ64wSXlY|UCD$+{m-%zGD z0C=uc)y#~+BL(imVsg`sZP&M5+dd0PW=ZodVIO0WyK%7`_QhfP(c?i0qhltH*qP@U zWAle51pzKZI-LUJ-lO9}q~O!ktGR|8KLalhSw#j%TsV`QjQA(TNSLiwpq!zpIyn&r zlh<58@-~@;4xp=MQFq}j0>2GlWRrxMF&&|jOZ^$;>i}Sud}pP~8@J3ImwI+(9lIsR z?u_!4@j#FG4isg0K+5^AqvMPUAR~Pb^XCX}z{B*MB5Ybh&M+_cEF*O^zK0Y(NnUss zZmDL?Ep^JOS27vX^p?eF1=Udw#fmDy6E}&K@v^exlx^&<3>HCa*kY`uP#d>Cj_nNw z4wJAqO4j~Dh+B;q8J}#tOOqy|BwXRrLy8gL9S|LIsCG-c7?Iq>aZ)IT~7BGKoc7^j^L z@XQ$TLq47)UtK>e5B}5G?JyRQov(?SeoTT$Y@_;wf=Cd?(t>0HlC_A$7`!2(SXV?u zgBVP-(ucoCBLJ$K<nSE4GO)DzI)Lg#=J><;QaA8!yziV8b zGN)dK(XPJv#uu-DG40FNbx3s`>F9@-Z(W}Ez4ylLH|8fZwL2EgN)c9=(aeBHAoi@& zppdM^R(7(wSQ88EXM$od3K@(BO!yrFM7o9d2xtv=$g;u>icJyN43M`K>??nVV(0

        t4bnAG{3Yu`Wktv535s=~)p z`3nD2+agE5xyF{8PN}ggX-!&x;cHH9giD#POY*_jkgx8{HLv_e;GMwR>u#<~?#=ng z_po~N{pMDf&;vIEh^lQMWA?kz^u7-d-#Yx>!0mzTs*TdBjoI2wQthTp?WSB~bJChy z0ol}6{R*^{1e5*uTUt}mx3}KhI>*1WGqv-6>sn~jS9bioW8JM+=K9||ar*>Xx2hRh z^i|Cm(x&D`2Upj8Fnxfq}9*dwfxBWht40b`SJOmtj%sY zByBnL)Bennqd(i9X*-^+eOan~Im5mW+%<`P$<0?@oOv<9J}hFie$ z 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/multidict/_abc.py b/env/Lib/site-packages/multidict/_abc.py new file mode 100644 index 0000000..0603cdd --- /dev/null +++ b/env/Lib/site-packages/multidict/_abc.py @@ -0,0 +1,48 @@ +import abc +import sys +import types +from collections.abc import Mapping, MutableMapping + + +class _TypingMeta(abc.ABCMeta): + # A fake metaclass to satisfy typing deps in runtime + # basically MultiMapping[str] and other generic-like type instantiations + # are emulated. + # Note: real type hints are provided by __init__.pyi stub file + if sys.version_info >= (3, 9): + + def __getitem__(self, key): + return types.GenericAlias(self, key) + + else: + + def __getitem__(self, key): + return self + + +class MultiMapping(Mapping, metaclass=_TypingMeta): + @abc.abstractmethod + def getall(self, key, default=None): + raise KeyError + + @abc.abstractmethod + def getone(self, key, default=None): + raise KeyError + + +class MutableMultiMapping(MultiMapping, MutableMapping): + @abc.abstractmethod + def add(self, key, value): + raise NotImplementedError + + @abc.abstractmethod + def extend(self, *args, **kwargs): + raise NotImplementedError + + @abc.abstractmethod + def popone(self, key, default=None): + raise KeyError + + @abc.abstractmethod + def popall(self, key, default=None): + raise KeyError diff --git a/env/Lib/site-packages/multidict/_compat.py b/env/Lib/site-packages/multidict/_compat.py new file mode 100644 index 0000000..d1ff392 --- /dev/null +++ b/env/Lib/site-packages/multidict/_compat.py @@ -0,0 +1,14 @@ +import os +import platform + +NO_EXTENSIONS = bool(os.environ.get("MULTIDICT_NO_EXTENSIONS")) + +PYPY = platform.python_implementation() == "PyPy" + +USE_EXTENSIONS = not NO_EXTENSIONS and not PYPY + +if USE_EXTENSIONS: + try: + from . import _multidict # noqa + except ImportError: + USE_EXTENSIONS = False diff --git a/env/Lib/site-packages/multidict/_multidict.cp311-win_amd64.pyd b/env/Lib/site-packages/multidict/_multidict.cp311-win_amd64.pyd new file mode 100644 index 0000000000000000000000000000000000000000..e8c9ac6756f1fb57382c514eecea6442b4eb2e72 GIT binary patch literal 46592 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/multidict/_multidict_base.py b/env/Lib/site-packages/multidict/_multidict_base.py new file mode 100644 index 0000000..3944665 --- /dev/null +++ b/env/Lib/site-packages/multidict/_multidict_base.py @@ -0,0 +1,144 @@ +from collections.abc import ItemsView, Iterable, KeysView, Set, ValuesView + + +def _abc_itemsview_register(view_cls): + ItemsView.register(view_cls) + + +def _abc_keysview_register(view_cls): + KeysView.register(view_cls) + + +def _abc_valuesview_register(view_cls): + ValuesView.register(view_cls) + + +def _viewbaseset_richcmp(view, other, op): + if op == 0: # < + if not isinstance(other, Set): + return NotImplemented + return len(view) < len(other) and view <= other + elif op == 1: # <= + if not isinstance(other, Set): + return NotImplemented + if len(view) > len(other): + return False + for elem in view: + if elem not in other: + return False + return True + elif op == 2: # == + if not isinstance(other, Set): + return NotImplemented + return len(view) == len(other) and view <= other + elif op == 3: # != + return not view == other + elif op == 4: # > + if not isinstance(other, Set): + return NotImplemented + return len(view) > len(other) and view >= other + elif op == 5: # >= + if not isinstance(other, Set): + return NotImplemented + if len(view) < len(other): + return False + for elem in other: + if elem not in view: + return False + return True + + +def _viewbaseset_and(view, other): + if not isinstance(other, Iterable): + return NotImplemented + if isinstance(view, Set): + view = set(iter(view)) + if isinstance(other, Set): + other = set(iter(other)) + if not isinstance(other, Set): + other = set(iter(other)) + return view & other + + +def _viewbaseset_or(view, other): + if not isinstance(other, Iterable): + return NotImplemented + if isinstance(view, Set): + view = set(iter(view)) + if isinstance(other, Set): + other = set(iter(other)) + if not isinstance(other, Set): + other = set(iter(other)) + return view | other + + +def _viewbaseset_sub(view, other): + if not isinstance(other, Iterable): + return NotImplemented + if isinstance(view, Set): + view = set(iter(view)) + if isinstance(other, Set): + other = set(iter(other)) + if not isinstance(other, Set): + other = set(iter(other)) + return view - other + + +def _viewbaseset_xor(view, other): + if not isinstance(other, Iterable): + return NotImplemented + if isinstance(view, Set): + view = set(iter(view)) + if isinstance(other, Set): + other = set(iter(other)) + if not isinstance(other, Set): + other = set(iter(other)) + return view ^ other + + +def _itemsview_isdisjoint(view, other): + "Return True if two sets have a null intersection." + for v in other: + if v in view: + return False + return True + + +def _itemsview_repr(view): + lst = [] + for k, v in view: + lst.append("{!r}: {!r}".format(k, v)) + body = ", ".join(lst) + return "{}({})".format(view.__class__.__name__, body) + + +def _keysview_isdisjoint(view, other): + "Return True if two sets have a null intersection." + for k in other: + if k in view: + return False + return True + + +def _keysview_repr(view): + lst = [] + for k in view: + lst.append("{!r}".format(k)) + body = ", ".join(lst) + return "{}({})".format(view.__class__.__name__, body) + + +def _valuesview_repr(view): + lst = [] + for v in view: + lst.append("{!r}".format(v)) + body = ", ".join(lst) + return "{}({})".format(view.__class__.__name__, body) + + +def _mdrepr(md): + lst = [] + for k, v in md.items(): + lst.append("'{}': {!r}".format(k, v)) + body = ", ".join(lst) + return "<{}({})>".format(md.__class__.__name__, body) diff --git a/env/Lib/site-packages/multidict/_multidict_py.py b/env/Lib/site-packages/multidict/_multidict_py.py new file mode 100644 index 0000000..79c45aa --- /dev/null +++ b/env/Lib/site-packages/multidict/_multidict_py.py @@ -0,0 +1,527 @@ +import sys +import types +from array import array +from collections import abc + +from ._abc import MultiMapping, MutableMultiMapping + +_marker = object() + +if sys.version_info >= (3, 9): + GenericAlias = types.GenericAlias +else: + + def GenericAlias(cls): + return cls + + +class istr(str): + + """Case insensitive str.""" + + __is_istr__ = True + + +upstr = istr # for relaxing backward compatibility problems + + +def getversion(md): + if not isinstance(md, _Base): + raise TypeError("Parameter should be multidict or proxy") + return md._impl._version + + +_version = array("Q", [0]) + + +class _Impl: + __slots__ = ("_items", "_version") + + def __init__(self): + self._items = [] + self.incr_version() + + def incr_version(self): + global _version + v = _version + v[0] += 1 + self._version = v[0] + + if sys.implementation.name != "pypy": + + def __sizeof__(self): + return object.__sizeof__(self) + sys.getsizeof(self._items) + + +class _Base: + def _title(self, key): + return key + + def getall(self, key, default=_marker): + """Return a list of all values matching the key.""" + identity = self._title(key) + res = [v for i, k, v in self._impl._items if i == identity] + if res: + return res + if not res and default is not _marker: + return default + raise KeyError("Key not found: %r" % key) + + def getone(self, key, default=_marker): + """Get first value matching the key. + + Raises KeyError if the key is not found and no default is provided. + """ + identity = self._title(key) + for i, k, v in self._impl._items: + if i == identity: + return v + if default is not _marker: + return default + raise KeyError("Key not found: %r" % key) + + # Mapping interface # + + def __getitem__(self, key): + return self.getone(key) + + def get(self, key, default=None): + """Get first value matching the key. + + If the key is not found, returns the default (or None if no default is provided) + """ + return self.getone(key, default) + + def __iter__(self): + return iter(self.keys()) + + def __len__(self): + return len(self._impl._items) + + def keys(self): + """Return a new view of the dictionary's keys.""" + return _KeysView(self._impl) + + def items(self): + """Return a new view of the dictionary's items *(key, value) pairs).""" + return _ItemsView(self._impl) + + def values(self): + """Return a new view of the dictionary's values.""" + return _ValuesView(self._impl) + + def __eq__(self, other): + if not isinstance(other, abc.Mapping): + return NotImplemented + if isinstance(other, _Base): + lft = self._impl._items + rht = other._impl._items + if len(lft) != len(rht): + return False + for (i1, k2, v1), (i2, k2, v2) in zip(lft, rht): + if i1 != i2 or v1 != v2: + return False + return True + if len(self._impl._items) != len(other): + return False + for k, v in self.items(): + nv = other.get(k, _marker) + if v != nv: + return False + return True + + def __contains__(self, key): + identity = self._title(key) + for i, k, v in self._impl._items: + if i == identity: + return True + return False + + def __repr__(self): + body = ", ".join("'{}': {!r}".format(k, v) for k, v in self.items()) + return "<{}({})>".format(self.__class__.__name__, body) + + __class_getitem__ = classmethod(GenericAlias) + + +class MultiDictProxy(_Base, MultiMapping): + """Read-only proxy for MultiDict instance.""" + + def __init__(self, arg): + if not isinstance(arg, (MultiDict, MultiDictProxy)): + raise TypeError( + "ctor requires MultiDict or MultiDictProxy instance" + ", not {}".format(type(arg)) + ) + + self._impl = arg._impl + + def __reduce__(self): + raise TypeError("can't pickle {} objects".format(self.__class__.__name__)) + + def copy(self): + """Return a copy of itself.""" + return MultiDict(self.items()) + + +class CIMultiDictProxy(MultiDictProxy): + """Read-only proxy for CIMultiDict instance.""" + + def __init__(self, arg): + if not isinstance(arg, (CIMultiDict, CIMultiDictProxy)): + raise TypeError( + "ctor requires CIMultiDict or CIMultiDictProxy instance" + ", not {}".format(type(arg)) + ) + + self._impl = arg._impl + + def _title(self, key): + return key.title() + + def copy(self): + """Return a copy of itself.""" + return CIMultiDict(self.items()) + + +class MultiDict(_Base, MutableMultiMapping): + """Dictionary with the support for duplicate keys.""" + + def __init__(self, *args, **kwargs): + self._impl = _Impl() + + self._extend(args, kwargs, self.__class__.__name__, self._extend_items) + + if sys.implementation.name != "pypy": + + def __sizeof__(self): + return object.__sizeof__(self) + sys.getsizeof(self._impl) + + def __reduce__(self): + return (self.__class__, (list(self.items()),)) + + def _title(self, key): + return key + + def _key(self, key): + if isinstance(key, str): + return key + else: + raise TypeError( + "MultiDict keys should be either str " "or subclasses of str" + ) + + def add(self, key, value): + identity = self._title(key) + self._impl._items.append((identity, self._key(key), value)) + self._impl.incr_version() + + def copy(self): + """Return a copy of itself.""" + cls = self.__class__ + return cls(self.items()) + + __copy__ = copy + + def extend(self, *args, **kwargs): + """Extend current MultiDict with more values. + + This method must be used instead of update. + """ + self._extend(args, kwargs, "extend", self._extend_items) + + def _extend(self, args, kwargs, name, method): + if len(args) > 1: + raise TypeError( + "{} takes at most 1 positional argument" + " ({} given)".format(name, len(args)) + ) + if args: + arg = args[0] + if isinstance(args[0], (MultiDict, MultiDictProxy)) and not kwargs: + items = arg._impl._items + else: + if hasattr(arg, "items"): + arg = arg.items() + if kwargs: + arg = list(arg) + arg.extend(list(kwargs.items())) + items = [] + for item in arg: + if not len(item) == 2: + raise TypeError( + "{} takes either dict or list of (key, value) " + "tuples".format(name) + ) + items.append((self._title(item[0]), self._key(item[0]), item[1])) + + method(items) + else: + method( + [ + (self._title(key), self._key(key), value) + for key, value in kwargs.items() + ] + ) + + def _extend_items(self, items): + for identity, key, value in items: + self.add(key, value) + + def clear(self): + """Remove all items from MultiDict.""" + self._impl._items.clear() + self._impl.incr_version() + + # Mapping interface # + + def __setitem__(self, key, value): + self._replace(key, value) + + def __delitem__(self, key): + identity = self._title(key) + items = self._impl._items + found = False + for i in range(len(items) - 1, -1, -1): + if items[i][0] == identity: + del items[i] + found = True + if not found: + raise KeyError(key) + else: + self._impl.incr_version() + + def setdefault(self, key, default=None): + """Return value for key, set value to default if key is not present.""" + identity = self._title(key) + for i, k, v in self._impl._items: + if i == identity: + return v + self.add(key, default) + return default + + def popone(self, key, default=_marker): + """Remove specified key and return the corresponding value. + + If key is not found, d is returned if given, otherwise + KeyError is raised. + + """ + identity = self._title(key) + for i in range(len(self._impl._items)): + if self._impl._items[i][0] == identity: + value = self._impl._items[i][2] + del self._impl._items[i] + self._impl.incr_version() + return value + if default is _marker: + raise KeyError(key) + else: + return default + + pop = popone # type: ignore + + def popall(self, key, default=_marker): + """Remove all occurrences of key and return the list of corresponding + values. + + If key is not found, default is returned if given, otherwise + KeyError is raised. + + """ + found = False + identity = self._title(key) + ret = [] + for i in range(len(self._impl._items) - 1, -1, -1): + item = self._impl._items[i] + if item[0] == identity: + ret.append(item[2]) + del self._impl._items[i] + self._impl.incr_version() + found = True + if not found: + if default is _marker: + raise KeyError(key) + else: + return default + else: + ret.reverse() + return ret + + def popitem(self): + """Remove and return an arbitrary (key, value) pair.""" + if self._impl._items: + i = self._impl._items.pop(0) + self._impl.incr_version() + return i[1], i[2] + else: + raise KeyError("empty multidict") + + def update(self, *args, **kwargs): + """Update the dictionary from *other*, overwriting existing keys.""" + self._extend(args, kwargs, "update", self._update_items) + + def _update_items(self, items): + if not items: + return + used_keys = {} + for identity, key, value in items: + start = used_keys.get(identity, 0) + for i in range(start, len(self._impl._items)): + item = self._impl._items[i] + if item[0] == identity: + used_keys[identity] = i + 1 + self._impl._items[i] = (identity, key, value) + break + else: + self._impl._items.append((identity, key, value)) + used_keys[identity] = len(self._impl._items) + + # drop tails + i = 0 + while i < len(self._impl._items): + item = self._impl._items[i] + identity = item[0] + pos = used_keys.get(identity) + if pos is None: + i += 1 + continue + if i >= pos: + del self._impl._items[i] + else: + i += 1 + + self._impl.incr_version() + + def _replace(self, key, value): + key = self._key(key) + identity = self._title(key) + items = self._impl._items + + for i in range(len(items)): + item = items[i] + if item[0] == identity: + items[i] = (identity, key, value) + # i points to last found item + rgt = i + self._impl.incr_version() + break + else: + self._impl._items.append((identity, key, value)) + self._impl.incr_version() + return + + # remove all tail items + i = rgt + 1 + while i < len(items): + item = items[i] + if item[0] == identity: + del items[i] + else: + i += 1 + + +class CIMultiDict(MultiDict): + """Dictionary with the support for duplicate case-insensitive keys.""" + + def _title(self, key): + return key.title() + + +class _Iter: + __slots__ = ("_size", "_iter") + + def __init__(self, size, iterator): + self._size = size + self._iter = iterator + + def __iter__(self): + return self + + def __next__(self): + return next(self._iter) + + def __length_hint__(self): + return self._size + + +class _ViewBase: + def __init__(self, impl): + self._impl = impl + + def __len__(self): + return len(self._impl._items) + + +class _ItemsView(_ViewBase, abc.ItemsView): + def __contains__(self, item): + assert isinstance(item, tuple) or isinstance(item, list) + assert len(item) == 2 + for i, k, v in self._impl._items: + if item[0] == k and item[1] == v: + return True + return False + + def __iter__(self): + return _Iter(len(self), self._iter(self._impl._version)) + + def _iter(self, version): + for i, k, v in self._impl._items: + if version != self._impl._version: + raise RuntimeError("Dictionary changed during iteration") + yield k, v + + def __repr__(self): + lst = [] + for item in self._impl._items: + lst.append("{!r}: {!r}".format(item[1], item[2])) + body = ", ".join(lst) + return "{}({})".format(self.__class__.__name__, body) + + +class _ValuesView(_ViewBase, abc.ValuesView): + def __contains__(self, value): + for item in self._impl._items: + if item[2] == value: + return True + return False + + def __iter__(self): + return _Iter(len(self), self._iter(self._impl._version)) + + def _iter(self, version): + for item in self._impl._items: + if version != self._impl._version: + raise RuntimeError("Dictionary changed during iteration") + yield item[2] + + def __repr__(self): + lst = [] + for item in self._impl._items: + lst.append("{!r}".format(item[2])) + body = ", ".join(lst) + return "{}({})".format(self.__class__.__name__, body) + + +class _KeysView(_ViewBase, abc.KeysView): + def __contains__(self, key): + for item in self._impl._items: + if item[1] == key: + return True + return False + + def __iter__(self): + return _Iter(len(self), self._iter(self._impl._version)) + + def _iter(self, version): + for item in self._impl._items: + if version != self._impl._version: + raise RuntimeError("Dictionary changed during iteration") + yield item[1] + + def __repr__(self): + lst = [] + for item in self._impl._items: + lst.append("{!r}".format(item[1])) + body = ", ".join(lst) + return "{}({})".format(self.__class__.__name__, body) diff --git a/env/Lib/site-packages/multidict/py.typed b/env/Lib/site-packages/multidict/py.typed new file mode 100644 index 0000000..dfe8cc0 --- /dev/null +++ b/env/Lib/site-packages/multidict/py.typed @@ -0,0 +1 @@ +PEP-561 marker. \ No newline at end of file diff --git a/env/Lib/site-packages/psycopg2-2.9.9.dist-info/INSTALLER b/env/Lib/site-packages/psycopg2-2.9.9.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/Lib/site-packages/psycopg2-2.9.9.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/Lib/site-packages/psycopg2-2.9.9.dist-info/LICENSE b/env/Lib/site-packages/psycopg2-2.9.9.dist-info/LICENSE new file mode 100644 index 0000000..9029e70 --- /dev/null +++ b/env/Lib/site-packages/psycopg2-2.9.9.dist-info/LICENSE @@ -0,0 +1,49 @@ +psycopg2 and the LGPL +--------------------- + +psycopg2 is free software: you can redistribute it and/or modify it +under the terms of the GNU Lesser General Public License as published +by the Free Software Foundation, either version 3 of the License, or +(at your option) any later version. + +psycopg2 is distributed in the hope that it will be useful, but WITHOUT +ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public +License for more details. + +In addition, as a special exception, the copyright holders give +permission to link this program with the OpenSSL library (or with +modified versions of OpenSSL that use the same license as OpenSSL), +and distribute linked combinations including the two. + +You must obey the GNU Lesser General Public License in all respects for +all of the code used other than OpenSSL. If you modify file(s) with this +exception, you may extend this exception to your version of the file(s), +but you are not obligated to do so. If you do not wish to do so, delete +this exception statement from your version. If you delete this exception +statement from all source files in the program, then also delete it here. + +You should have received a copy of the GNU Lesser General Public License +along with psycopg2 (see the doc/ directory.) +If not, see . + + +Alternative licenses +-------------------- + +The following BSD-like license applies (at your option) to the files following +the pattern ``psycopg/adapter*.{h,c}`` and ``psycopg/microprotocol*.{h,c}``: + + Permission is granted to anyone to use this software for any purpose, + including commercial applications, and to alter it and redistribute it + freely, subject to the following restrictions: + + 1. The origin of this software must not be misrepresented; you must not + claim that you wrote the original software. If you use this + software in a product, an acknowledgment in the product documentation + would be appreciated but is not required. + + 2. Altered source versions must be plainly marked as such, and must not + be misrepresented as being the original software. + + 3. This notice may not be removed or altered from any source distribution. diff --git a/env/Lib/site-packages/psycopg2-2.9.9.dist-info/METADATA b/env/Lib/site-packages/psycopg2-2.9.9.dist-info/METADATA new file mode 100644 index 0000000..87dc149 --- /dev/null +++ b/env/Lib/site-packages/psycopg2-2.9.9.dist-info/METADATA @@ -0,0 +1,110 @@ +Metadata-Version: 2.1 +Name: psycopg2 +Version: 2.9.9 +Summary: psycopg2 - Python-PostgreSQL Database Adapter +Home-page: https://psycopg.org/ +Author: Federico Di Gregorio +Author-email: fog@initd.org +Maintainer: Daniele Varrazzo +Maintainer-email: daniele.varrazzo@gmail.com +License: LGPL with exceptions +Project-URL: Homepage, https://psycopg.org/ +Project-URL: Documentation, https://www.psycopg.org/docs/ +Project-URL: Code, https://github.com/psycopg/psycopg2 +Project-URL: Issue Tracker, https://github.com/psycopg/psycopg2/issues +Project-URL: Download, https://pypi.org/project/psycopg2/ +Platform: any +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL) +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.7 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: C +Classifier: Programming Language :: SQL +Classifier: Topic :: Database +Classifier: Topic :: Database :: Front-Ends +Classifier: Topic :: Software Development +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Classifier: Operating System :: Microsoft :: Windows +Classifier: Operating System :: Unix +Requires-Python: >=3.7 +License-File: LICENSE + +Psycopg is the most popular PostgreSQL database adapter for the Python +programming language. Its main features are the complete implementation of +the Python DB API 2.0 specification and the thread safety (several threads can +share the same connection). It was designed for heavily multi-threaded +applications that create and destroy lots of cursors and make a large number +of concurrent "INSERT"s or "UPDATE"s. + +Psycopg 2 is mostly implemented in C as a libpq wrapper, resulting in being +both efficient and secure. It features client-side and server-side cursors, +asynchronous communication and notifications, "COPY TO/COPY FROM" support. +Many Python types are supported out-of-the-box and adapted to matching +PostgreSQL data types; adaptation can be extended and customized thanks to a +flexible objects adaptation system. + +Psycopg 2 is both Unicode and Python 3 friendly. + + +Documentation +------------- + +Documentation is included in the ``doc`` directory and is `available online`__. + +.. __: https://www.psycopg.org/docs/ + +For any other resource (source code repository, bug tracker, mailing list) +please check the `project homepage`__. + +.. __: https://psycopg.org/ + + +Installation +------------ + +Building Psycopg requires a few prerequisites (a C compiler, some development +packages): please check the install_ and the faq_ documents in the ``doc`` dir +or online for the details. + +If prerequisites are met, you can install psycopg like any other Python +package, using ``pip`` to download it from PyPI_:: + + $ pip install psycopg2 + +or using ``setup.py`` if you have downloaded the source package locally:: + + $ python setup.py build + $ sudo python setup.py install + +You can also obtain a stand-alone package, not requiring a compiler or +external libraries, by installing the `psycopg2-binary`_ package from PyPI:: + + $ pip install psycopg2-binary + +The binary package is a practical choice for development and testing but in +production it is advised to use the package built from sources. + +.. _PyPI: https://pypi.org/project/psycopg2/ +.. _psycopg2-binary: https://pypi.org/project/psycopg2-binary/ +.. _install: https://www.psycopg.org/docs/install.html#install-from-source +.. _faq: https://www.psycopg.org/docs/faq.html#faq-compile + +:Linux/OSX: |gh-actions| +:Windows: |appveyor| + +.. |gh-actions| image:: https://github.com/psycopg/psycopg2/actions/workflows/tests.yml/badge.svg + :target: https://github.com/psycopg/psycopg2/actions/workflows/tests.yml + :alt: Linux and OSX build status + +.. |appveyor| image:: https://ci.appveyor.com/api/projects/status/github/psycopg/psycopg2?branch=master&svg=true + :target: https://ci.appveyor.com/project/psycopg/psycopg2/branch/master + :alt: Windows build status diff --git a/env/Lib/site-packages/psycopg2-2.9.9.dist-info/RECORD b/env/Lib/site-packages/psycopg2-2.9.9.dist-info/RECORD new file mode 100644 index 0000000..ef64013 --- /dev/null +++ b/env/Lib/site-packages/psycopg2-2.9.9.dist-info/RECORD @@ -0,0 +1,30 @@ +psycopg2-2.9.9.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +psycopg2-2.9.9.dist-info/LICENSE,sha256=lhS4XfyacsWyyjMUTB1-HtOxwpdFnZ-yimpXYsLo1xs,2238 +psycopg2-2.9.9.dist-info/METADATA,sha256=m-vTX7sYOv5wXKcTJhY3qIaz5SiHmyig-w7neDM_VL8,4548 +psycopg2-2.9.9.dist-info/RECORD,, +psycopg2-2.9.9.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +psycopg2-2.9.9.dist-info/WHEEL,sha256=badvNS-y9fEq0X-qzdZYvql_JFjI7Xfw-wR8FsjoK0I,102 +psycopg2-2.9.9.dist-info/top_level.txt,sha256=7dHGpLqQ3w-vGmGEVn-7uK90qU9fyrGdWWi7S-gTcnM,9 +psycopg2/__init__.py,sha256=9mo5Qd0uWHiEBx2CdogGos2kNqtlNNGzbtYlGC0hWS8,4768 +psycopg2/__pycache__/__init__.cpython-311.pyc,, +psycopg2/__pycache__/_ipaddress.cpython-311.pyc,, +psycopg2/__pycache__/_json.cpython-311.pyc,, +psycopg2/__pycache__/_range.cpython-311.pyc,, +psycopg2/__pycache__/errorcodes.cpython-311.pyc,, +psycopg2/__pycache__/errors.cpython-311.pyc,, +psycopg2/__pycache__/extensions.cpython-311.pyc,, +psycopg2/__pycache__/extras.cpython-311.pyc,, +psycopg2/__pycache__/pool.cpython-311.pyc,, +psycopg2/__pycache__/sql.cpython-311.pyc,, +psycopg2/__pycache__/tz.cpython-311.pyc,, +psycopg2/_ipaddress.py,sha256=jkuyhLgqUGRBcLNWDM8QJysV6q1Npc_RYH4_kE7JZPU,2922 +psycopg2/_json.py,sha256=XPn4PnzbTg1Dcqz7n1JMv5dKhB5VFV6834GEtxSawt0,7153 +psycopg2/_psycopg.cp311-win_amd64.pyd,sha256=fqbVB1hiveZXE5spFuUUyrHgsAfwhZNzqhLkREdGb7o,2416128 +psycopg2/_range.py,sha256=sXeenGraJEEw2I3mc8RlmNivy2jMg7zWoanDes2Ywp8,18494 +psycopg2/errorcodes.py,sha256=jb1SkuGq5zJT7F99GFAUi3VQH8GbsB7zRHiLsAWAU0Q,14362 +psycopg2/errors.py,sha256=aAS4dJyTg1bsDzJDCRQAMB_s7zv-Q4yB6Yvih26I-0M,1425 +psycopg2/extensions.py,sha256=CG0kG5vL8Ot503UGlDXXJJFdFWLg4HE2_c1-lLOLc8M,6797 +psycopg2/extras.py,sha256=oBfrdvtWn8ITxc3x-h2h6IwHUsWdVqCdf4Gphb0JqY8,44215 +psycopg2/pool.py,sha256=UGEt8IdP3xNc2PGYNlG4sQvg8nhf4aeCnz39hTR0H8I,6316 +psycopg2/sql.py,sha256=OcFEAmpe2aMfrx0MEk4Lx00XvXXJCmvllaOVbJY-yoE,14779 +psycopg2/tz.py,sha256=r95kK7eGSpOYr_luCyYsznHMzjl52sLjsnSPXkXLzRI,4870 diff --git a/env/Lib/site-packages/psycopg2-2.9.9.dist-info/REQUESTED b/env/Lib/site-packages/psycopg2-2.9.9.dist-info/REQUESTED new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/psycopg2-2.9.9.dist-info/WHEEL b/env/Lib/site-packages/psycopg2-2.9.9.dist-info/WHEEL new file mode 100644 index 0000000..6d16045 --- /dev/null +++ b/env/Lib/site-packages/psycopg2-2.9.9.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.41.2) +Root-Is-Purelib: false +Tag: cp311-cp311-win_amd64 + diff --git a/env/Lib/site-packages/psycopg2-2.9.9.dist-info/top_level.txt b/env/Lib/site-packages/psycopg2-2.9.9.dist-info/top_level.txt new file mode 100644 index 0000000..658130b --- /dev/null +++ b/env/Lib/site-packages/psycopg2-2.9.9.dist-info/top_level.txt @@ -0,0 +1 @@ +psycopg2 diff --git a/env/Lib/site-packages/psycopg2/__init__.py b/env/Lib/site-packages/psycopg2/__init__.py new file mode 100644 index 0000000..59a8938 --- /dev/null +++ b/env/Lib/site-packages/psycopg2/__init__.py @@ -0,0 +1,126 @@ +"""A Python driver for PostgreSQL + +psycopg is a PostgreSQL_ database adapter for the Python_ programming +language. This is version 2, a complete rewrite of the original code to +provide new-style classes for connection and cursor objects and other sweet +candies. Like the original, psycopg 2 was written with the aim of being very +small and fast, and stable as a rock. + +Homepage: https://psycopg.org/ + +.. _PostgreSQL: https://www.postgresql.org/ +.. _Python: https://www.python.org/ + +:Groups: + * `Connections creation`: connect + * `Value objects constructors`: Binary, Date, DateFromTicks, Time, + TimeFromTicks, Timestamp, TimestampFromTicks +""" +# psycopg/__init__.py - initialization of the psycopg module +# +# Copyright (C) 2003-2019 Federico Di Gregorio +# Copyright (C) 2020-2021 The Psycopg Team +# +# psycopg2 is free software: you can redistribute it and/or modify it +# under the terms of the GNU Lesser General Public License as published +# by the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# In addition, as a special exception, the copyright holders give +# permission to link this program with the OpenSSL library (or with +# modified versions of OpenSSL that use the same license as OpenSSL), +# and distribute linked combinations including the two. +# +# You must obey the GNU Lesser General Public License in all respects for +# all of the code used other than OpenSSL. +# +# psycopg2 is distributed in the hope that it will be useful, but WITHOUT +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public +# License for more details. + +# Import modules needed by _psycopg to allow tools like py2exe to do +# their work without bothering about the module dependencies. + +# Note: the first internal import should be _psycopg, otherwise the real cause +# of a failed loading of the C module may get hidden, see +# https://archives.postgresql.org/psycopg/2011-02/msg00044.php + +# Import the DBAPI-2.0 stuff into top-level module. + +from psycopg2._psycopg import ( # noqa + BINARY, NUMBER, STRING, DATETIME, ROWID, + + Binary, Date, Time, Timestamp, + DateFromTicks, TimeFromTicks, TimestampFromTicks, + + Error, Warning, DataError, DatabaseError, ProgrammingError, IntegrityError, + InterfaceError, InternalError, NotSupportedError, OperationalError, + + _connect, apilevel, threadsafety, paramstyle, + __version__, __libpq_version__, +) + + +# Register default adapters. + +from psycopg2 import extensions as _ext +_ext.register_adapter(tuple, _ext.SQL_IN) +_ext.register_adapter(type(None), _ext.NoneAdapter) + +# Register the Decimal adapter here instead of in the C layer. +# This way a new class is registered for each sub-interpreter. +# See ticket #52 +from decimal import Decimal # noqa +from psycopg2._psycopg import Decimal as Adapter # noqa +_ext.register_adapter(Decimal, Adapter) +del Decimal, Adapter + + +def connect(dsn=None, connection_factory=None, cursor_factory=None, **kwargs): + """ + Create a new database connection. + + The connection parameters can be specified as a string: + + conn = psycopg2.connect("dbname=test user=postgres password=secret") + + or using a set of keyword arguments: + + conn = psycopg2.connect(database="test", user="postgres", password="secret") + + Or as a mix of both. The basic connection parameters are: + + - *dbname*: the database name + - *database*: the database name (only as keyword argument) + - *user*: user name used to authenticate + - *password*: password used to authenticate + - *host*: database host address (defaults to UNIX socket if not provided) + - *port*: connection port number (defaults to 5432 if not provided) + + Using the *connection_factory* parameter a different class or connections + factory can be specified. It should be a callable object taking a dsn + argument. + + Using the *cursor_factory* parameter, a new default cursor factory will be + used by cursor(). + + Using *async*=True an asynchronous connection will be created. *async_* is + a valid alias (for Python versions where ``async`` is a keyword). + + Any other keyword parameter will be passed to the underlying client + library: the list of supported parameters depends on the library version. + + """ + kwasync = {} + if 'async' in kwargs: + kwasync['async'] = kwargs.pop('async') + if 'async_' in kwargs: + kwasync['async_'] = kwargs.pop('async_') + + dsn = _ext.make_dsn(dsn, **kwargs) + conn = _connect(dsn, connection_factory=connection_factory, **kwasync) + if cursor_factory is not None: + conn.cursor_factory = cursor_factory + + return conn diff --git a/env/Lib/site-packages/psycopg2/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/psycopg2/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a5cab97a7d892ab2b0c3b799abf19cd270b8adec GIT binary patch literal 4085 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/psycopg2/__pycache__/_json.cpython-311.pyc b/env/Lib/site-packages/psycopg2/__pycache__/_json.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5f4fda62909cc1a6aebc859d2e9f4f2b208c10ae GIT binary patch literal 7970 zcmb7JTWlNGnV#XD6h-Rhi|jZ#avdj>wRDmuX)VicffR`fs{$ny+#4^bSt$Nvbq0sj}+H z$|H{eYo~d`}2Y6Kt4DfM4x{;qz0zLYH&KDhNe3_(wL-%Ka|wS z1CJy<#LsTi(XbSj)LymoLwUMW?Neho#&C?|7*}_w-8gosJJlW>yH(Gml-RZWKjZmg zPRnZrQ!%r8f$8(iyri*nljl=RQI(?8J$G5lm_{Trbt!AGysnmV8q=<44bxzz&Xj9< zR%HsyWO=5PQ#i}!i#j)1k?V7qeV7%OjEr7fcq6G@H@RXkRV!)*)rerlqOs)O(h3Hc z7-ELb##u%wykfEp*A!C|OsU$uQp%Y&bLLV}%P5Aaaf4+G5zK2pj4QErwy?mswg3(_ zp1y2gp?R+7!85I&jC@TpOC>y3czp8xiT6vosaa8RP$x}}hZ9~aRL~aFw2l>{Glg?y z$-eG%XQtaV#SJmnuyHjvJWFz#WvXH-j9x4m5%*>XXx&*-2%FPb$2TRxH-2Z^abr-%c{5@R7?4yF(@XRFBLL`v?Lp!X9c~WF#yULIV7GlOr@YITxG+> zrC}OxGnN#yyqcKB6Jjc2q`_h;<8_3MBgvbtpPmJ|Cza*0l*XCeR0&rQq20=!Vu$G% zD7r4Y^I(+QuS%2Br*bOcw}QebG}ZE_GkT$5`AB4zU$ABc(&7l{_zW#K&w&GpcY_!- zD>U|(6Q_n}ex~y)GbeQwAe*^T;)<#B^qg+aXoYJt6WO^LBWr4ZS5z`rlm*S0arApw zfH+xPvO?)}wvaW`>E%w+OVYU{a2fkSDpGydi&fv9XnjXN4w3rKy|tZ*kIjEx##KiZ ze@`(=$~ds33s+<>;DSVEQg5S`B5UQ|-iw3fhyG06pg9=hebm*F zCi%?kJP$s*8hpAv$1ud$0|Hh%x_&cW>)40?dhf34yPIAq`XVm)PTX!|kyfPN(;*PB zD6QeRy_Mw$(C$N5!*Fx*@}DL(o>g+$WsMC2_=9j6wi_W16|;dNXoyY0`#FvV$OO(a zN-oD{2T0LP25uWp#Ul!3C7?4n*0#-v} zS0c=eGYnmh30b=1e~dnZL<(s}yY8O5eQwqKsJtFMun|2_mA~rjzdvv*eJ5S@)H~vL zhHD)I^=PayYI!}nexyqXF9t4_E9n2k;5?d6Uo9!Q#vQDv>X~$!@4)=Lp9r~op+Uhde+8GHO7_HLI=sUnNt_rfAQks- z(-ZQCHYFlGUjN{x)J`HE|L#r6C8407ZAvcbk^Or%C6@&J{uehTm&82&qx9@nVsl1J zo#9=enE;5>f;bUM{v%GHWN)R{Y*ArZD*M|NHv>1Z;$88X^i-pjy=7n7Q}(Zs3)$A% z0rHvW0f6-oKf8(f0xLn2IBB$Upe#p4Kq?}AZeJhv7reQnZFKOtqXXsOJSDCfpf3wn?dFYraIO5(SF3#0oj4@Xo_Mr8ZE21uAaDS_W$CSvkbYnaa4>aP8??8W!<+x+&~;s7$xDF zJ5w&3N2(zrjtD?@MmWSug`8#>Y;Yl`&ms0LAzB*D&`f&A*?}ou(q@spAvG8IpgY~{ zKnm#`vNOAcAg&lO;e^6gaX3>C)9BfOGfK|DlTKE>?OpUj4ryk=U23pZoP$G5hp_l! z)@Z&lO_68LGObJJbVY>N z*dlmxx+!NB^EOJS%q88>n(w1zGCHS(kVH(&H=qQxQ9;CBH8hPWbI2DGt*-(R+b?o{ z{FGCK)4WyW{_SE_BQWY zO(Mxsx)9NlsFXBLDJvN?Mne~aV*No^H+GfPYIjM-E+}LhEydz{Twj1&$^&wzIoG*s zwKgLL=?J1M72E;~rLtdO+wu{Q37-{9BjpfPNt$fk+MTxZR=cak6XFbJFoSEF{in4_BeX( zNn2v9T=tkPv9q;W{Y-v`S+nl z{w5K^G=Gc8+aSo~37A%hker5_usU5#)8(h$EswS(`_>M3!Nx0!g*kzyf}e3voP66O zMf=xszx#PT*8B19&wmLtM@N9>=m^jp9ibF)WIF`Oq6m^t-vRmmKv0#Dv>|DH=q8RL zo%;K~4TN)cka{Kx-~3J#j?$K2i~L)~AwqAP8*g9<0m6|Vvn%W807`@rnxzS%2CGal z1(pSf1)_mFfxkAZ*upq#L~;Yp_^)A1O!n7tX8Fm}%_Ra`Fw=yaaGnn4g!eolKo=v> zoe-XsuDRHaA?3T?bf+V!bgO9R_(=@<2mB1$f~iPtQ0xD^@Wl@ZY!fn}Z9*ovO~{0| z3E3_)et@SkZgP(ca$Ev+w{h}o&pqjurxG=B?zCnhf7?^_%%f8LFog2Lb$AlCf#zi@ zF&;4b7xy2Ak(;il2q@(NQ;XfU|E2A=X!Qs-+E(AJ$NQ?K)%R~*zjM7B7y7aM z0uu?Js03}_MUv)Z+KFHbu!LKq(9Fk(kY2giexyjo*erl#$7TLH-6Haj_!)T+F!4AT zt*m_2)%Q`P>fiKvsjA&hzKuxHzSYUqvHMeN$JRSu-{^R~a;k2}*}na2<7>wrO+8A| zAEIpE*hb%2HCzop?%NHrCDyh?Pl@0sAa?>D3Lj(WLyVM{S3Kh5i})C`;+3H>fNG1z zL^bLIw0xIc5Cb&6%Pt%*yG~H`T@k(9qxw;&qJ~8UOw!rb)L=QdjOWS#=(cLszebLE zTYG?>=5EqT2sN?iiU2>~3x2}R14dujw-#}(T955Bpl%KsyD^qF0=BiX46_M+>}kjE zujFzFu0EXNB;JHwlUDL#dxhR0MpB<4A z1p!i#=vlthPbMao-<~`@ar)#GGn2>@hSCAMpWaEJE9a9PRjLI&mUsn`!e>uHM4eL)c#+Oo!E$- zsD(~oROPJjOo>41Oe&QUehFKHXYk=JCA#74JWXU)BIem{Oo*S{wH?i9JMS-{5xb&4&S!85mx7IKP{cu5 z-t_ooANJrtMi2`t9rX8DdaL$b|8?nf?b-jEAt@TKgz81R6%^N?JrIB~!`s;|$2jsn*Qaee>5gD0bJJ}PFDSU6Ed%9?Xc5-l!+_@<| Ig9vf`A8#8OZvX%Q literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/psycopg2/__pycache__/_range.cpython-311.pyc b/env/Lib/site-packages/psycopg2/__pycache__/_range.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..73b0d73ee8fd1c7864eb70e5715398a586dfe011 GIT binary patch literal 22672 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/psycopg2/__pycache__/errorcodes.cpython-311.pyc b/env/Lib/site-packages/psycopg2/__pycache__/errorcodes.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c5acf7b2b8902c2343cf39c82ef845ae9d52991a GIT binary patch literal 14493 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 By{!NM literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/psycopg2/__pycache__/errors.cpython-311.pyc b/env/Lib/site-packages/psycopg2/__pycache__/errors.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ac7aa3f9de9dfb7a4d5bb49dc340ef73af242f7b GIT binary patch literal 566 zcmZWmJx|;~5S{gzFB1fmq(F0BuE<3}R0v%|QgMosP((tOjPdR{=8V_utWgdTiGn{s zMgBpQ-;#!cBD$6;ou%ujGV9|cq>Of+W@cyKywUz#SqXqGt$q(~<^UdCGBfcMOx8HK z1qp{B#WfrX=^a3)bRbpH`W8_StQMNJ#W|mNWOH^qyT};Jvg8|vz%;fRn+W29dEo|(kRhoy48)I zBICPeZ|pm=CLy;N;^W@Co$!k`!*EZ_tVqLQWn!yMbgXTtiu16a9fy=z^}39cVVo)o zXXJ0D^Sb3|JfAmfn?=XTPHl!Or~{bWy7S*YKYx~A{@A`>#ycM;+yoz3)j||WokUUd u{uh`fuA2ph$Hm=KEvsDh%nMH4ztAg&x+R3DJt6!W9Q5WzyN3UvVfqKDWtRZ} literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/psycopg2/__pycache__/extensions.cpython-311.pyc b/env/Lib/site-packages/psycopg2/__pycache__/extensions.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..651a59087cb604a56d805ae7f763f45adefa2345 GIT binary patch literal 9200 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 N7dPNyh<}37@L$%g<8J@} literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/psycopg2/__pycache__/pool.cpython-311.pyc b/env/Lib/site-packages/psycopg2/__pycache__/pool.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..90f3c2bc579ea9558a21f2103ce01c256064fdbc GIT binary patch literal 8283 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/psycopg2/__pycache__/tz.cpython-311.pyc b/env/Lib/site-packages/psycopg2/__pycache__/tz.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a9c6e5b7e49d871e27b76ca3b70073cdcc59f98a GIT binary patch literal 6425 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/psycopg2/_ipaddress.py b/env/Lib/site-packages/psycopg2/_ipaddress.py new file mode 100644 index 0000000..d38566c --- /dev/null +++ b/env/Lib/site-packages/psycopg2/_ipaddress.py @@ -0,0 +1,90 @@ +"""Implementation of the ipaddres-based network types adaptation +""" + +# psycopg/_ipaddress.py - Ipaddres-based network types adaptation +# +# Copyright (C) 2016-2019 Daniele Varrazzo +# Copyright (C) 2020-2021 The Psycopg Team +# +# psycopg2 is free software: you can redistribute it and/or modify it +# under the terms of the GNU Lesser General Public License as published +# by the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# In addition, as a special exception, the copyright holders give +# permission to link this program with the OpenSSL library (or with +# modified versions of OpenSSL that use the same license as OpenSSL), +# and distribute linked combinations including the two. +# +# You must obey the GNU Lesser General Public License in all respects for +# all of the code used other than OpenSSL. +# +# psycopg2 is distributed in the hope that it will be useful, but WITHOUT +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public +# License for more details. + +from psycopg2.extensions import ( + new_type, new_array_type, register_type, register_adapter, QuotedString) + +# The module is imported on register_ipaddress +ipaddress = None + +# The typecasters are created only once +_casters = None + + +def register_ipaddress(conn_or_curs=None): + """ + Register conversion support between `ipaddress` objects and `network types`__. + + :param conn_or_curs: the scope where to register the type casters. + If `!None` register them globally. + + After the function is called, PostgreSQL :sql:`inet` values will be + converted into `~ipaddress.IPv4Interface` or `~ipaddress.IPv6Interface` + objects, :sql:`cidr` values into into `~ipaddress.IPv4Network` or + `~ipaddress.IPv6Network`. + + .. __: https://www.postgresql.org/docs/current/static/datatype-net-types.html + """ + global ipaddress + import ipaddress + + global _casters + if _casters is None: + _casters = _make_casters() + + for c in _casters: + register_type(c, conn_or_curs) + + for t in [ipaddress.IPv4Interface, ipaddress.IPv6Interface, + ipaddress.IPv4Network, ipaddress.IPv6Network]: + register_adapter(t, adapt_ipaddress) + + +def _make_casters(): + inet = new_type((869,), 'INET', cast_interface) + ainet = new_array_type((1041,), 'INET[]', inet) + + cidr = new_type((650,), 'CIDR', cast_network) + acidr = new_array_type((651,), 'CIDR[]', cidr) + + return [inet, ainet, cidr, acidr] + + +def cast_interface(s, cur=None): + if s is None: + return None + # Py2 version force the use of unicode. meh. + return ipaddress.ip_interface(str(s)) + + +def cast_network(s, cur=None): + if s is None: + return None + return ipaddress.ip_network(str(s)) + + +def adapt_ipaddress(obj): + return QuotedString(str(obj)) diff --git a/env/Lib/site-packages/psycopg2/_json.py b/env/Lib/site-packages/psycopg2/_json.py new file mode 100644 index 0000000..9502422 --- /dev/null +++ b/env/Lib/site-packages/psycopg2/_json.py @@ -0,0 +1,199 @@ +"""Implementation of the JSON adaptation objects + +This module exists to avoid a circular import problem: pyscopg2.extras depends +on psycopg2.extension, so I can't create the default JSON typecasters in +extensions importing register_json from extras. +""" + +# psycopg/_json.py - Implementation of the JSON adaptation objects +# +# Copyright (C) 2012-2019 Daniele Varrazzo +# Copyright (C) 2020-2021 The Psycopg Team +# +# psycopg2 is free software: you can redistribute it and/or modify it +# under the terms of the GNU Lesser General Public License as published +# by the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# In addition, as a special exception, the copyright holders give +# permission to link this program with the OpenSSL library (or with +# modified versions of OpenSSL that use the same license as OpenSSL), +# and distribute linked combinations including the two. +# +# You must obey the GNU Lesser General Public License in all respects for +# all of the code used other than OpenSSL. +# +# psycopg2 is distributed in the hope that it will be useful, but WITHOUT +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public +# License for more details. + +import json + +from psycopg2._psycopg import ISQLQuote, QuotedString +from psycopg2._psycopg import new_type, new_array_type, register_type + + +# oids from PostgreSQL 9.2 +JSON_OID = 114 +JSONARRAY_OID = 199 + +# oids from PostgreSQL 9.4 +JSONB_OID = 3802 +JSONBARRAY_OID = 3807 + + +class Json: + """ + An `~psycopg2.extensions.ISQLQuote` wrapper to adapt a Python object to + :sql:`json` data type. + + `!Json` can be used to wrap any object supported by the provided *dumps* + function. If none is provided, the standard :py:func:`json.dumps()` is + used. + + """ + def __init__(self, adapted, dumps=None): + self.adapted = adapted + self._conn = None + self._dumps = dumps or json.dumps + + def __conform__(self, proto): + if proto is ISQLQuote: + return self + + def dumps(self, obj): + """Serialize *obj* in JSON format. + + The default is to call `!json.dumps()` or the *dumps* function + provided in the constructor. You can override this method to create a + customized JSON wrapper. + """ + return self._dumps(obj) + + def prepare(self, conn): + self._conn = conn + + def getquoted(self): + s = self.dumps(self.adapted) + qs = QuotedString(s) + if self._conn is not None: + qs.prepare(self._conn) + return qs.getquoted() + + def __str__(self): + # getquoted is binary + return self.getquoted().decode('ascii', 'replace') + + +def register_json(conn_or_curs=None, globally=False, loads=None, + oid=None, array_oid=None, name='json'): + """Create and register typecasters converting :sql:`json` type to Python objects. + + :param conn_or_curs: a connection or cursor used to find the :sql:`json` + and :sql:`json[]` oids; the typecasters are registered in a scope + limited to this object, unless *globally* is set to `!True`. It can be + `!None` if the oids are provided + :param globally: if `!False` register the typecasters only on + *conn_or_curs*, otherwise register them globally + :param loads: the function used to parse the data into a Python object. If + `!None` use `!json.loads()`, where `!json` is the module chosen + according to the Python version (see above) + :param oid: the OID of the :sql:`json` type if known; If not, it will be + queried on *conn_or_curs* + :param array_oid: the OID of the :sql:`json[]` array type if known; + if not, it will be queried on *conn_or_curs* + :param name: the name of the data type to look for in *conn_or_curs* + + The connection or cursor passed to the function will be used to query the + database and look for the OID of the :sql:`json` type (or an alternative + type if *name* if provided). No query is performed if *oid* and *array_oid* + are provided. Raise `~psycopg2.ProgrammingError` if the type is not found. + + """ + if oid is None: + oid, array_oid = _get_json_oids(conn_or_curs, name) + + JSON, JSONARRAY = _create_json_typecasters( + oid, array_oid, loads=loads, name=name.upper()) + + register_type(JSON, not globally and conn_or_curs or None) + + if JSONARRAY is not None: + register_type(JSONARRAY, not globally and conn_or_curs or None) + + return JSON, JSONARRAY + + +def register_default_json(conn_or_curs=None, globally=False, loads=None): + """ + Create and register :sql:`json` typecasters for PostgreSQL 9.2 and following. + + Since PostgreSQL 9.2 :sql:`json` is a builtin type, hence its oid is known + and fixed. This function allows specifying a customized *loads* function + for the default :sql:`json` type without querying the database. + All the parameters have the same meaning of `register_json()`. + """ + return register_json(conn_or_curs=conn_or_curs, globally=globally, + loads=loads, oid=JSON_OID, array_oid=JSONARRAY_OID) + + +def register_default_jsonb(conn_or_curs=None, globally=False, loads=None): + """ + Create and register :sql:`jsonb` typecasters for PostgreSQL 9.4 and following. + + As in `register_default_json()`, the function allows to register a + customized *loads* function for the :sql:`jsonb` type at its known oid for + PostgreSQL 9.4 and following versions. All the parameters have the same + meaning of `register_json()`. + """ + return register_json(conn_or_curs=conn_or_curs, globally=globally, + loads=loads, oid=JSONB_OID, array_oid=JSONBARRAY_OID, name='jsonb') + + +def _create_json_typecasters(oid, array_oid, loads=None, name='JSON'): + """Create typecasters for json data type.""" + if loads is None: + loads = json.loads + + def typecast_json(s, cur): + if s is None: + return None + return loads(s) + + JSON = new_type((oid, ), name, typecast_json) + if array_oid is not None: + JSONARRAY = new_array_type((array_oid, ), f"{name}ARRAY", JSON) + else: + JSONARRAY = None + + return JSON, JSONARRAY + + +def _get_json_oids(conn_or_curs, name='json'): + # lazy imports + from psycopg2.extensions import STATUS_IN_TRANSACTION + from psycopg2.extras import _solve_conn_curs + + conn, curs = _solve_conn_curs(conn_or_curs) + + # Store the transaction status of the connection to revert it after use + conn_status = conn.status + + # column typarray not available before PG 8.3 + typarray = conn.info.server_version >= 80300 and "typarray" or "NULL" + + # get the oid for the hstore + curs.execute( + "SELECT t.oid, %s FROM pg_type t WHERE t.typname = %%s;" + % typarray, (name,)) + r = curs.fetchone() + + # revert the status of the connection as before the command + if conn_status != STATUS_IN_TRANSACTION and not conn.autocommit: + conn.rollback() + + if not r: + raise conn.ProgrammingError(f"{name} data type not found") + + return r diff --git a/env/Lib/site-packages/psycopg2/_psycopg.cp311-win_amd64.pyd b/env/Lib/site-packages/psycopg2/_psycopg.cp311-win_amd64.pyd new file mode 100644 index 0000000000000000000000000000000000000000..c21a35a083d34a503b018ec1e55bd9e9c0ab977c GIT binary patch literal 2416128 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%0A|6_YG>J4mCb$yEyh|SO4t^(~HyE8? zGj3q!0Ne50?-=LsAQsqeW72q!p?PDiSI^Ysjm&*R&0*0H!y`n;8TLBa0v@eb>)HX0 z+#HKku8nyp5q+tLXYsaJoLgNqeXrHeh_3@wzhOD-a^+_3p8wVjY6WYq#dSd6`E433 zJ+iVlKx{7sI+%q9gcG zrCS?Y$Ea1|f$LMLrAaQEWrp-8A;P%OO%Epeu1_?Rg2Te^@K=pI6FQeaW|o}mEdFOI zxhobljucY<(8Vz7fCGLrz}|ODgfAx7KZ-=mK#IWwJgc-eVusZD3H}*lv&p}Y7z{(C zOsz6e%0?)ey_UbJ=us*g54}=?bP%f@paxU489kD2OgUIhe7rM690h_3->s6S{_RIm zv(6N+%*eNj-3sSc>{h1dpY6RTFO(07=HA|O0lirV`ceF4b>h&kg+uSVN}b=d__?>I zQX{-m56(X+(f{D`h3Ba_I{`FV>_I=B7R{OcytM&wKOnENxLMg{uo7_`Y`n&pXUDv~ z4e0Q;<8=3BxB*^2T%53Xm3LacO*-b_0P3J;9NSJWSf+WC;sAzInGZXT@H!qm0%!zw z(^%uE6qe(icxt}tV4KX=FJ_P?v!YOKjsgMpk$A$oERA;3<<0BatncDi{j+a2fA3N(<66D% z1qMYQSYjv-{quBz7(VxP$<7NQ2Xci7iCphB_XQa1WU|mpDW}POoVd#i&2ZITdqdSi ztNFt|Bq*|%D{_X4#6t%^M-eYH+Mvph#lyR3SCnWnibYaeCTd^>(FV#3uGneq zi~YumMdn@tr1H>v*mch% zp_u4{_I_0ItKY0I4$7%Lzry>k_g?zEd${*}X?@utqVV~&fVDY)xHr#|Qqdkkn_T(B zFO=6iR}A-VD4k-(0jT~|$5Nc~=2WGY>)njSA9Wl);8815cRyhK3-J7Wz~J{K!$pMq zm>@>>yVPjg(|W7Gh|Z?Mm%er&#d@YcC-Mm|y;>|;vb)e04?V;OZPe+Q;afqSh@Prq znxc6WX&qv1%hzLoetBzJ`|#JA-_x3Z*~S{W(lu1Oz_PZzs-7QlSr-IZw}Y9J7$}ex z#BH*4(z!P~X=C--Cnmt;<~p)9<6L7Z<6m<*l`(rJ~zTHf+S{&M;b|lD2RhLC5KZGp=ZO-fHL6-OkzzGp~^G#<>RiThKdG%P2b3P^#J)ihPj@~&-l zD*8SJoJ$x^Ac8j${YV!TDd6;J6!c3CHx7RjD1)W_7758<-!@3oyY51oK6~|n81Z%4)*OC8E3c#zpk# zL6RAfCbQNh!hgC)X9+>K{j%zq`bZq(4&ov9x^#QBbqloG+PN-8ADPw4W&Sk!rO#UKe2p;9Re{}=-#<1{z41ClD(|2 zgKf!s0_c+X28Txq%tZ7vi%QC5-`l`;n;E$>1#U~Tl)RIYaDf#K=(F=BakZeFJR--D2>KZr6hmhH- zZWMgkdCwRkFu>g)?)(B+`&NYX78KL}*t>*3aFDZbi!{+Pj&mN?QBYz8DwG~Jz8eZNNZZ4JJiYV#CPwn_>uPnbjD{wq+JDIU2Pr*LXeJX09 z?&ZDZPuOe&RoKUHPqmSV_M^>A@N;XoO{F9KS|>8s|kWZvHm%Y4euInJrr)XM`L6*@L3W)fORu zq+wHTUh^*3sH#7hamr94R!KtZa8;4v;gLff9u7WEtmN`{-hJ$VBVyjmt#4_iOGG$?hgP@0G(Q{Se}uu~o&VgA1N9 zpPnB%Jry~9D|%YBn;u_^yR+Ug|06Y8SCQ!6F<-qzmRE`yNiS8FMzit?z6zU+Yij|eQW|CWrKzohaN$e8g z=aESO&?Epj@W1gGrv6v-fLx-5NUzOeQnad?W-&-y+C6@jJZ=p+tL(uh94bGTdg94y`6o9 z1=6g=7J1xYKj+j+=g8&Ir=oj`vq~)RAVLp0W zerjPlhK}MSXqk;)nL56>tDPz_R{zTha*Ie)% zudbNPV)#-SC#W1AE$W+J?D&C3zY5V8V{ZN#i=+OGij_8Oq8Itf+7AtWEQwliEYX&p zQVXtO-@ag?&;$x?PS@0rhUaZyIf%sBeAaa&#FVZ^`S-nLc;&<-bW2qln^TCkm5APA z5-R++K0@cWz-ELaPxuV(!j%_bjtnprqkO9@=Ee#$5D|5kBQE1>N#gGu$yVm{%-ee8 zAVF8!siG65XN8Y{T&z8|<-AzrN+RUlL2rTW0##tGDSV-Bhr!0YR+}1yEnD6dY2WN5b;OT&~pRNbf#Z|e=aqC34Sg1g5NwGUCia5!9U}%cJRM9 z>=)o4d+4vgzt1nhzn_D@kHKF@dxrfq{0;YLhW|ube9kuEHEy8~_+u;(pCh89B)*G( ztOnfvJ?6ccYQcNV@6a;&6fF;m8h)59Oo9>u!W30|RlTTQ2#=O{$i zfRZ30h*j~eVyo9PcWUcPiy+GUzrS_POcKD}`+uH?&nL_|d+)RN+H0@9_F8MNy>=Zx zYzO>YAC~pzUt{NRL^!>qB)>lF?#XVVcydo^qAHv|%}-fvDT97ix_cOe@g*Ch80ayqpCLv?FVThP(=-lIrA6VOK%7em_l6%S$gVJa4p{3;x3peaZl-G9UDl+ANDC^3! zZY}%3%H$u9 zPcv203G{Juc;V_O&8Ak(rlP++s9vA@QvuIwP?k!vZH#rXuR@GP98o{Ovvo8p(~s~x z-0fLYp%N`52yU>P80v0uU(B9CO2dm0C-P>Nurv89R-AHWX~~~(mFVT~bNr3ty@czm zgMX#vrGpC3{OY1>{VVbBJ8xo=u9<<+yIKs6F`nN_!$3 z?b`WU{Eui9rlRvfXU0!%JTE?>@rw9~jq!MmF@(@H7CyRaIgAQ_E`0({?USf`#OLXA zZU_&(LN8Wvj%Sw@3k+=D&es=0dA=y8YT)1=mx}TL4lvQAn&J4FvpBLs5H|D`!>Y7w z?TeEng!#q5$5+VJ7{dhNb~vP?JTGYsm24=NdG=U?7Q6i*9@sf;Sl{G)`*B2C;5~wM z8oqNr4D7Gi>o~u5y1FJC9M<|wsAq{p3$%>qK0`Y8B1Dx08a10yE$Z~3+Ly2ljYSG> zqpA{!g5Kjbdc-xVSx68_q@AE>@c6^!WpswC|Iq65MH@EaN%@eJ90W2>Id0W&1V|=y z7$5K{aaApOm-X#vdp0aUF$F{fYp_4Q#HX`0SJ(Sws72heEo{4$xu_-}( zg}}=m4|~Z45CDT(QKnvLB5VDI0PuuvufNzIR8fH@P?OWK27c3ieQB%Hp;J-OOe3L1 z)(?VK_C}xHO?*8YK+m^^Bt{TNjLyc~zh!M3tKn70q-8Lh`tyC2$5;#nNSj+i$Kyib#ZOX`AOGx zClW_%7&rfB=H>G}xs#IlQoZIf^9Z+zx)XUHk>O?GYGIUc2yG+V+djE>T4ESK`RR$W@cXaQM{NMV z1L)1}mI!yemxL+bdiQC5=F{5+)XU>#{9PPz-=fp!Mcg;|navm5 z`GUu}Ue!H{UaJ^04}4RgJ(sy8?|$U%Wb?28aPC}sxi4hKFY(8-&c^d3#&ZNFHUZ#| zX|2ZeAkcB%zZz6`bN@j_Qj6xF(x85aK~)e-sbG=JO{E%G2AJDP?zJ|e$-RTxMupqk zPGNu#(yu?lFCz@$>r!<$0eNW~cKH`x+bju6~>icJBm0oa61_K^ZLTXqNGOet(!r3^w@7+{!U$vn;1Q;qjB!P+3E zxj^%Is*mt|vAYYMK%cwM>q43N7SXJQH1$)wR<-J|>x77;7O(Y(d-ItY9}!^FS)QQ? z6xy(K2p&A)T`3mP2-}c2}EWzYfoJtp>?jPFq*09S-eT@fK0nYvn5WI<0*W!kz z9db-bV6m<3a-UO}{b?vM03FVs%MP4&hn&>2eClrl*|PiWsj68Ew12@X9!+l5gNGUV zUV~!tq1rmocQ;?DtCy*N5MjlCkZP;T>38zv-#4?{DC~LfdmKRv5W*lNAJQ6Kb#F+4 z5*`z3&J(W@U`-6`Y@#Go3O9Aajg;gGnry_IG|0UDLJ}RTmiO6Pa+KyOdPHkc77qe! z2l`xJ{9e}lcY|e;aAy@Ss~LDFTmWH5e3-RT!cyp3HWa-DDRIs?b|-shQTAs0Nk>?y zhUZAx=iBT=49)cT;nBik#SE%xZxC|`YlqT_Y*ml<`38Ql{uJW}h5N&Z0^SGc!2ntt z04nfw{bwfh^lbpRE@=QlqV_HTf8{5I`T+F5$*$OAfQ|J5`z4?I`zqZ3!ZVAD;1qBG z37-R?!X_-Ca5RX&Qd0eG?Yt$b*@dy~6+@U^NLulSQM%s2cY|@+i_Q2i;+13EitmXvThw5t(z5*+6S-_`Dd74C0_xC-G50TttpBoYT5` zd?e!T(#(zOsMrc>6kk%!Vw=o4gbw~-Oc*=7S1}%h3!LdS3MD^kSUNbI-;jI@y}9B+ zunmu`XuCA(-q}tzaS7t*Du^1FZ_uiDH{ZjFR*me(iOAlE6$M*sHx<|r()!u8MUrUF zDTX=P#57ui=B}bL$YC-hQrNF*7VBod3VPP`ST(M&O`(6WyI~8$*AqJtu)0wo3Cv)_?GoaGns7QG{k z0j#91trTn1E$yTEjmh-oZzgB!C=$+`^FcT>{I<;Sv%(EqoLi=o79s9oa_?ZL<4|5Q zQ&*Pl%vSNFFgzXQ`o?`M{5yWJyZx$%;6CaSQ_>)lA!}#Zt4``A9!wM2Li$aAH3J*9 zmO8g}>&yOC@O^V8KE9MnrdlOhO$+{CR+(Jg`&Y&(T?qw)oZI3&H9Nn0lR9Dx0B>=a-&O4e{B1U%#E3&ZlKJRY!1!(TIfC%EFfW1gYhT6O^ja39pr9Ae^r=fse<0li!W zW6iOf1wJ2kpKV#d(7gX*ROUevg&%CF(W|=QdNN`0ObNu!jdCD}JsW%f1s-JaWgc#G znTJknWAqEXUjh@euIgg5T70~$8+`nHI6X$YZz=1_hu;4r)3j2^d)$^{f8(C@VRk>U zW&Mitt}iWVzoE2b9>3@Do8xaRe^2uMb^gA~b4h9CpyI!>$^-o?KR{wdA#HHsf!`th zCcNhR7(ar9Mf!b_8xL?!pT!mH?mOJ+9m|ZaWWK(k5Qqyg_Ra?l~sWNuLMqw>U!QNlT3KbkCZ-U@*yKAjI;dLmICn)hVe zDO=n1drc^|)W6;3_U7(_r`@r0U1|Kz+&6f1^XqbHZg_~5Jrzq2X~~q2jWzUMccd(V z7bk`|E5oIne(4;f~tp z3=YR;&H;%dkaD%QOC4rG8GuV0MahpvUcKzE{=BQ$J2x=)rpCXm?y_^SNVMv{Hp}&- zf<~o+Qfs#kpb~Z_kL_tHB?-KY>Qi`FXbf9wKd)sxr;|;ivJPMn zR-{32-|PKI48v9#{FDjJC-7Ndb!(3JE8@y7?~-o>s!^$P^N*=f>gL?qjrmaA#zR7* zlX}>e4gA;;497F4`>kjd6pJPE)lTYqD`duPdUkd?{^6on9$C)Le9z5BFc1+C&`DiR zIV=;28g87yFM_wT-S~$KWBDy2nmP+5lC7q+vhi>R>|$~r?#TUPQ%e%fn8C{vpK(?W zo_zLwuO?1$R-Rcp`Fx%x^E7C33s1-JRAx`y8n~HNxprHO_{3K^s?y8Kejm%1kH?YB zZ8m9d_N?^f^JBDzK-m=^HA_R!sgbAhXb@iZNR_Wg0CG~TJet4O6JTtX&RG*>1doID zK#fD{`lhS6u&H;}y0+1=$ZuCQnFQq8c1K9+sjHR3B z_YY_II>nRuatZuU&++;glkbLbmor(=u}E=Ifmw5}D0zr@n3esqv6 zYSUne`A|7UavdxSlWrD;S6xPCKJ+&_76eoACr=b=h#iK3j}i2$SVuWLfDL#P zdoaQFa*2JzE|J=V$w1YZ#l$k_ver()5?(~7$+ztH_Spxv7qA!z@`nSEx8WA8bkwNb z5LF3r6>J6Q?(Y+rJgBlsuB1));n1ss+B+VuL42`eNl8~6I}{X&i;W;vzTBD6s((uT zg}&}SPQguoKa28IYyo`kS)Ch;m2LK}8A?-z?LfkHqhng!)Cn$G_0Qwa!CCeW-YI9`IdqQrnFY^H^l)BeVKe_#Jj&ICq$(+2HhnTz9;!7@o9s>M5<$V%}0&2ZG>dvOuUDoSUjsbu^-)*%Y zP4?7a7)^erB(Vko`C7W>a|mm%NT3>c^GE1&0;%EdBeM+=@1JcWCvx%@?oG~zj;2Pv`nkhl><;6^C7En5@F0%na~A4@XuG)G-s|P1oHdMoMh${Hah6ZK!Hd# z!p64*fFY+`S=4JBGD;P?5e z;c>AsQbcj4eEQa>sQbBU?fmIh_<<3W zaNdArz9ota{2^$Kl=n!<4Yh;xv8cO8GSpQZtgdXy%z(f+;#al1T}$q{(CZN4CD@h+ zL}aPos6Mgo0ZSh5RnwJ|36+1XpM(23LF)nkZncjC-cndD_vxSQe>Z_vX$|1e!r)8^ z!r=Id1Fc*Eh}`>3ec-jS*2o_T2}jA4<-s}bxw{S z2dNBra4SmnB+owIov()b9wENB;%vG%!%6c@@`lr222S=V^LWbM2(N)){!9uCSxqkD zteb#nwW#3+TLI>vD}}xlXN~TAHlcK3A9}Y&Ge<xGK*MG zRWe-FLzFd>JVNCwZ!e3dfDYXHbFd9;jE_X+Fmmh-=bvT| zBlpE<{Z}R+Vz443&&;a!cIccfm)D|=RHTGLO~cb~&=Z8xpydF?)if6b<_m>AW43SW zS^}7Dl#<+CiM;v|Gb0mv+rsueta407MEt~j@pj=D7y&%sv(+|SrswGHm44BC`uxr1 z7#3g5@;+A&*9Z;ZyX*R~v7Ro(60QVGX&5j;bYXKERFc@~bvKC_*(~8C$T@Sp*@|aQ zZ_De($R1U(75IR*`$L2FMc$Bixi8uP4%Q5Rk$0=^@(XoXmtKXIYc+EVQf85T^pi&< zjF>l56-A4yG^{<`??BeL>kfhrsZMx5$yPbAzo)ol6`H?YMKYm(qxs@Fs2?e?6gL%js>#G>dg#FGu!^>u0~ zai_vGK@u!+7i-ZJ!P~g^mH$vJ^v#yHctsa~V&4z?^-n@Z;7Nus&jpf9H zC@K+ql_wwF3+Q`_HDEoZCT4rF#{*P(BO(nI;}!VJ*VM8>>jkb-+U|c#7}m5LsOs2s z=x;D<9E-tBrn0YVbn8$5=Rb}vN$767*B40=S*m`dD_$j4UA!?c%!Qt^{u!RGY;i08 zK)yu=ruT5Cg+cH6qF^jL!jg8W5*CvFBi0~DMV;&>u)0jVB)iigbweO&#Io*vGb2oY`F>Ds-`$uHR+$WA< z<48|_sNsdWU=JE2NcR?Xgk4s)hG()t5W1`t)S&YX%ZI`grjd!76|nZ1bH#ylCSWc# zQ;n}O%v1#?hRii=(n_zA`X=Z^!&Sgn_UY}%^gcMh)Wpc|2?J1V!Qc4>*{vsFzdVR0 z*qp5i-k0bdv9hLLtnjj@`-Kbl<42zoToj-?0!Gz#rDv8GeVy+-x8N{sBVh9FY?E)R zcC3`ypi50*Z%0C9I7}d>lJ7+{dD+RCT{V(!tm$WeYYKiU#}y`^y0R7|?yqw5SHJ zP#Y+%g^Z%&yx7m61O68^1!BL{&)8paZuT?8_)P~dD$a%2!}kJV*Y z>BvDpoeNE$R<~V`W9zyyjo(?(XvSNrdvhI}C~dn0B}!=(S8*vNkNEZm)CV5>OCMk1T|42(9H5TgwV zn!rCzN|G%utE!c_-AG7MOVn-l;ot`n%E|xyG5h>EE4fPq^rh9p1aaGnAIE3%p${-W zqP+q2)bQ$emmi}wHeXo74zmj0?#Gx`2uLJ3u|f(gGnkEA+H%$8Gbdl#G5iz#kR7uo z;1Q}fr*KM_=MQoLpR(=`DI%P?;f-adzKBobCx8Y63stXxrO96lK6@zp>5hGjKm8_( z*Ibm{A-#8>qXT{NjIH+pWi$Cd0BKv|EcY*=A5{s#ZySQ;tPsV*DIMe}>$#bF31QpNp$RD*y%iMiXIm_kTgttrx({EOOA()F#g@TSUyJHbeD;NJ+T1 z_=C+_OY8IHI@aEcK3b#oY66h2{2&cUK=6?b$p!I~VXJoHvc4i`Kw;ef>=-sg@`DQ0 zYcY{CRe!t=AnC+xkC^GjHSi6PK%bu5+#DG~J*AGacM-ZvNkb3gwl%NXeRGr=$b_E@bX0NcBNUnoS&m7kIt>QCOI zXf+*y9pgC$(!2jU)SgV$P8-ySEug{&K{$y&K%$Y(>wYhk-T*B;>!(vk@ zNaYlXI?cVN8l|glAtjhs69sgiIB=L=>rcK)@TC4?t6|lpyiog%%XG|RGqraZQ1h&I ze~?zIWJ87E;iLilZaCGz?+hRof$3yqJ5(qWnrDefU&mVo;v-J#3*;4UDGD|F{otI5 zmC$fIDLEcd^D=7o_esr~gZxK=KOdY_9$E>Ti-YK53XOg66`=}>f7*)qjXh?wZ>z=S z0LN!i#;eD_)VBmUDUCzec)YCVi>T(2LN#BvYK#Dps1PcuD)sdqd7fa@U#Ow@R15P_ za{ny%F$(;_m4L!sIBRVb-`3i^u&~hljQaZD7WaL7=b|{7sTXNa_sM*y!xA-vFB?B! zY4qnSmgWcJU{>2qzl5}agfTA#BpkKGA|I`{S0rEvoH6)>UQs2IM4=9xdo{nMmcem| zVc@<~j8!m38gZRaCRmrbdNx>>Z&U$=M!_nazOInpXFI>h zDyX>FiqWx|HOMVz>&>L2eFTOR{nDSbpFO@1bhKZX?+O!HJ|Wh-z6IC(K{&h$mMHi% z`$L(k?em#s^mHzr!_HQlmx{M(sEE@i;48E>nWQu z8V$32Ih|}JgR9(@)I~K9B0Ws zfMW90?cHxgvE2Yucu@2km|rlg_X^~|uCIZeP{?q}c$A9Ch2}R`P)tID_<IaA&;N#EUGd9kqb{H+4q*r7Pf&S@G1kTx{PGm*icgKnB$yuO^^-$( zR{{fPWgGtL-11MBDe1zm*6z$rseLI|j(u@wza?d}%I@PNyIN_`7Tg20YOPsl)4D$s zxScZl?qV&ox(0?F{gR~(T%A5=_1n2eMRJmh^uYZn^wbx;mzqmTQXC%)KZu~f_WLI9 zd$SbCP12JeiVi0cs(T7 zbZIO(Ntbb_AVztkPcAL#Nk)0pzvLSE+?1fjW^T zSS?3TOzVoEzf;B5Ssj)cKQ@^yj}J>`OXC&E-KB|RDf^kA?3Yzmr?BPITRfSSM+93F87sXjB!cH;tK)?Z>H@Hj~uBpLQN5uP2a$;Q5T}JDWdmIRmBVJ zGc~?Fc$uI{RO9`6h9Q|1a+9}xnt6(%8c{wIDpiwzoKPxW3c}}$JQhmqS_I+;Mn4J0 zbD$AoO4!|vSD~F@d%@c?-NtvK9B$@ETw>gAFdvVoWX?_AaLAp(=I}2kF9b)hW7ecr zqrPz;mRF3q@;{EZYwZQYtnoeqjP5_)<7+=|ye~8!yvf@}!0YS|uy)|_o)Z*%K*j8^ zy-y4W8t-$0vNx%0Mgu`_|NYYk8t-4j^1KTums=Q&_u0Y7GRPWh+vE4gR=yFzP`9g6 z8)`;(g0znsQcAqdP(SFkVScA+z%U=Cmfm7E{L5ixT4pQH>QnLlC;Y?HoYY~4^3{bY zwyfKx*h8QGIF!F>Om~wv4`{Nl0QZ4Wz9T4Br(!E97R~NJeBOfUL`=<_s za`8d$_2WSKQQevc}!Fh#Cw4+?H4Ce(4U4IXHF+!&zWsn8*ddjv+p4Z1+oE)vEP7jz8Elwte%^Z11OIOCf8g^H{42y?wJ+i?_d$Bq?kKJ6sn??VPXGY!=>1wk}i19pituU08Mhjt%q7+I*k?NZ1{|R;9Htc=Lj? zKUZ1y)EYi&do@Q45Wlk8joukS0oN+q00858w056$u3v|_C=)lJ?-evyj- zxM#3rg?y;wBTS6xGb{bCN)yAEt+`850dh^7qMUf|;~Yw4#|d(#;dSmzu5zQ>NKpel z;#eoc^SC$=mzPQj8zYFH`~h|MoLQ;rxYlK>u$4Zu8k$T$qL_m2UucX z4$2N!*=5#Q=KrKV+U#3m!|LbjM>GE~4(9)~{~MNjVbg$V|42Et-%RcQa@rTrtN0c1 z(~_$tVU#959d(z9iHiJ>OV*Vxu3_GrHkdf1eRY>;B2l$r*$Ndl0$5+$)z22FO3j{x z0AM?9mB7Gas?Btn0Z@_VdV5$1BQ8<#Q8bC=lDI(w@ttuZu%*Xcu|mX67RUa)r!CRx z*anrV&{ypJrdQa>BBgd4MF~OS{VXW4pPynmer+t+-=TS?-?el5puru`w# z@~7z*G_n3%jxaCia&P(Ce8TBP%bv);mR!@Op2mj;U*(W`zEwhTGrh>zi6z??=iWfv zgS?fAI~ftsGofP!`9$`?QObHmXe4s;%lXkbJ&NH*#as~Rxra<1Xt9R(oz(AnaQ|Mv zR*S*XncTFsBI@31I(c2&h?-cYd<07?pEYTZfu*^rdUXXw^VLByoS8>d;@7crbP0lb za>Im%U#hCM)j>XS0?6W}i&PCg3pEasH|sSYS}`Cm@jBDEIv={hQlE;ZmttpK%386s zCYoL=<0(IaEp6cDL!Y&RkMs(k={4$aQ|B5HjrDOGC9RJec_{V~9{Il99{c&v{U7xA z`G0n86LdOhXQ%Am5t^?CyH@5d$n{JR1EpwAvY-Z0GlzBWYOAnG>_J|7>Q{DY=R$c<8gQgSun9k3Lz- zDq?IUG1}MqO5+C^FO`;g5e(J;Ez~pM`-$zVT_Gqw)Vs{MTW=tSNpo;@jmk}Azmhaap2609d3(Fx=OuA^Fnnte?h8mE`Me))=2dhTC)go++qMg#13 zhXayin*4}rk=}YrBndt=2frp!c!_toV?Ah8UvKlDrxXb31SOuu-Ymk};Q=W>K%IVX z`+&jwrXZi)^)_hhnPGJor}GSx&(>@OVl#pGT?p1Xx_E-R_%0gz0SqL4sIsR4^cza9 zZlzA&&hhUbQpqc0`bM`vh({E#DN*fWmHKVJQj%z+UI=p>oqS9kPW#WR{9f8D>I0&G z`+=t?W9}s;3Han4>LFB$vukvW)LYk2;X>eO`djxXH$7XMk$mIV8OWmr|J~REG^KX~ z@*n3DcG4@C$xrv~WI}%w{O>ba{f%H716VO8I8lZ7)+gu(CzN%q6yTJVluSxW_D*^g z4LwWFRQGNeWnKM)YZ-Ju*;Nr;&>Jn=;@vbvS@ENsl}Yi1o!bxZdVf0yZ1!nID7(!2 z^Kcb*I>cv;vDyc6A8PHX|9p`B%cjK3>Wy)L zA}+>(i{3rpBF7BuhYLdk0Lq!;jEAo98UrZ5M-@s&W7;^>2dS`Je9wwpf5N`CJhZ^u zYrScmr=DDE#aibu%)xRNKPp*Q!tI@=6FuV>ovNZU{GtIuTgQ+J*|n9a9?vH0~pRA3$Hi+mZ0v8eW{uUNvuTg71xzPltq0 zDK-Tt1H$D%R_JiSc?NK16=lPVFxxv`TDsJ|*@*P!0+Fs?0w;RPd$wA*X}!#~4D>`J z(wB@*H+j#OD>oi;R^A-Y>Bje8$XuT%I?RHXC=7K*hFJy2S_A@9u)kSpDY)M~<^9yp zt*}8UFdZbTx(<4UIPBcr1=$-d^&1O4f~-V2mszaOo&?7B$yC1YKk&bv&*i&8%L$_g z&~V@6@Q%QehU)*t{pYgr=3n{@d;J0C@*`#HZsIJeXrp_-S6ig88ETAK94SqpVP6e$+^9!=`@o$;!(&4`{_sHDqj_p zcRDVmJ*%=<;sEsD6z-u;ZMe%!Y#x`?65La?pIz%l?6-ZLDro#;FwGtDzDXF&jZY!@ zd&eMk{C&A6$&{&0-tS;KJ{o6Bm0<4#n-Y}XRJ2eJ815%m`EvHgcp0&Qi&*I^ zliWT0TKwrM?xHj6qYD&GcH+D0S9$jVO56NVeClQQ&>>bz*2PT4b$1?FbO9PTf0{V2 zRa_3|0zuLn4C7loOD^>j-aZ3v+11l`%hszIGpfCUG1LynkN#l(j+gguo_-y%-v2sAxE#sevE?B1<^3HP0 z!3fI&SC5nvKsJo`ZYDHU^pNacQ%_|ic2$}!3Fa3vgU7qdLzH9FP(EXLrE6a+L zx|9cJe0Pj%AzB(Xwc%Eb3+NZT(O4K|i*-_uX!vl8ad$Z@OPWsF$qwF3=couK zhSbh@P2(|%6YFM_CJyez>2*C&<&GtCZdSSmWpjs+U(vL(G*<=q-VH=4v~teM8P3-CADHuJPMM)wIiP5tZua6g^P zp2yi%dU-g-+{be-27_tx12lU&^l_Bv0}o4|J|+e9G0lyXRPIk8qok9IKu#O`uL$IS zSO4(+>wo0Ep#B%f{NLAKy?_043iaRc|Db+uE8ceky(caw{2ccGpnj;9&!C3RUu%G>CXC0PH*O^Z_=_2keuCSFI(cN-ZH)hc2!O zuNr2coTuo{SH30)bySZ!Dt4B>8rSabfJXP_k3MgFM<2}cQ9#F!qFF(J-^E`H8)p-1 zgGMi{h3^~;i)pNJQb@e8!!qvV{9810_M(=|nL_1MKJ|VZ5_T$Pep^1T5`ZMCnxHCR z=B+O_^pv#k%-J+_nKk63w9Qz|{%tY4ImrHQ|Ll8;*~eRUye+(Huwf&VDP|qyXI)gx zx}li$_MhztNmF>0jK~0gWijhnKkKMs)_KLOM=i_gI9$SK=F(3SUoCU#Nx5>N2Yf`` zJ&LZCMZ1w<7mmxlwf-lmKPs`vbzdixj+5#l4PwbY!|wpf2-dS;y}TTL7;PB2B!Vu~ zdUT{AT)qSg2VspDY>P=5-iQRV6=|Wjk2TVvy?=v#SU)xIj~QK@mk}3}ez34MNQO}U zpuYTma1`e2LfW56`!m%3cxxZ;=6%|C%du(YO;(!T-;MfL-) z;TZGZKoRVD7~Or7_vo=^NZiLg=i4=67R)Vwf)}M>o8SHG%N^ZUA423N?~4blFY+<< z5dh`kIoVVA#)nw%v$Mw+-@%uYl7&?F+SD-V_pqLei#7D(MXG7VR!<$VceQKd{D6Z2;||G}T@0@O8PP{T*=(_IJ<|`t9#nF_@df{?3~(BmLsJ*fXKw z5!I*t9r^0{b+P|LJ}+Hl`CJF?b_`oA$V;~0lT=PVbWguxEF0|iDE#=>EtO4&tJv?k ziv6CeYNF`}Ony#3VEa7}s7>xAw1VPn{WvUv0%D{WhPQAYtZ;rx5#<-WyL!7-Fvcp7 zW1LQ0+j%T)Z5fNK^-uinlyG?g`Ws?Gi>a-<7+G8ET@*8>&kw@DttT`Y3HkKrKp7U&J4WdXfT@pH6;! zIHN9S8qI5dAV#lP@so|ECHwweOIqQtkXIZ$9-4yN3};8AI4k0!lj_F2W$p}Y(vCCs zy~~93`$=~@gsW&~)?^Hf+9z#_PI@}MT!}`1oagC`3}dB?={D3QYm(9r9hGkG+@gx~L(aWy%9-L?xU zJ2~M-qVBj6a%P;_cbX|u*EkCMS)Sw7U9wT0O#M1_2_Ixx+8UkoOi|xCsB`#X(ac4q zsf`H?#WN~f(&dA59OGQ>lW_S6wbD}GIKoMZJ|p#QBdQbSk@QVh6DU=8(nlH=mpivC zX1N6?gW?wfX{3Hh$F^n=0K7)tg?f|0DIb9k=v6{7a**oegMjE2}BN2Icw(JtmG7+Yl+MDYalf>nB7Stj@MyaTvjFOtE#tZ@WLe+xnrZVJR>zRb4p5 zx`5b)o_{5VliI6xGZj@kM3k_4-Bp*ozP!Y_O~i@=1} zf!g+r7c~GUs>BSt+!2Eq0a6zb(I?vdW_h%%u{ZfqK7O?v$FA&n>!!*cne<9>pU*Ux z3aSNG&0`fs5=tBm-;-hP{3`a&>4yJP711beFWW;@3jd>fPW^uubC4nd~ znvno*VEyM+;d!6=B}uI*=DuSyOY)z_{}5UI7Ih92Hy!K;)MN>y-hDm1wqO(Qv(>T- z*1~E{5SmUivOex6wR*D-1y)w8RwmaP?>K2_Ks;Lz&((O$2kZkFRXJ{*?L}-Yz#o37 zG`p(b`vLkx_`E)UWc8;U=x6N@{m22(FI)2unDdHxrF6iYmfdHaAAr?ObcWkStZO{h zcwevfL2nZ1U|gP6I9U}X-~y!n?>_ML<7YaNZ+Ct;DTx+^O`?2Hdt*I&LtO6SbleT$ z`M0^;&QmlqWAAE;mPDWSq8zEphyHDwXvwqLF^QarqEkjQ|Ax(Pdou)nA*VjhLdtt6 z&)ZUmD5*Cs8A_1lF4+LF_7lf7zm9Sfx!Xl9`FTnWZMuF&SbtQfgo%Blf2L{wR#0S{?bRQr;Cbjk@><<#}Zs3KsreJHdds{k(Ps)9s zO3J5D^~H(dk$J^Tpy!kWcW7uabePnLOz<~_j zm@iRhWyRR*k4A*)^$C5QTT#I~TuX#ryRpw5`wS=*;)wQ5#eg0P`(4h;lb>qUr@Nb+ zl^En-+_~LGxCPriCbmQ?G+lTHTURyanDNPRhw@wI5czC zj`rP`E}pFVhjwzHwyU!`H%CphVC_u|y`rb&;)}7_586<2F`4|IJ6Rcn{daEH;h`%# zxV?KyXS9^pu54NRpNF)+HpEf}@o8E6x+zw(ylRuV(nMz;KpV7E)Ga1@;83 zBesdRKh(q~2uLu4H#*X;M;0+OD&WF8G#- zAPpZZJ~6t$k|sT$wloyZv|X30NWEprF23;*VQod1<>h^H?UiVnmB@4X&=pS^83%i3 zrE9cA7Zgnpa}>wkqiKrzs%N?sRP$B@UU@i|=_4}It}huCvsag}k`QmzZzLWm)U(Xg zBV|%SMsbF$jvnjdE^sh$jn!mz3N!tiRO=?|9dI~{{!1_RiBiGdxXJe3#nNxUY{(a) zR_r4`?Kh@@Jrlxk)8^mz61OSP5&8F_dfLVy5c=MNCEo9q+mlqT{_RgA`_|>@*YBv7y{~t1qq{*0(n6cpU!F2D_BS_$=ZzNv=WW@U`bIq6H*d(Vh>5Uey!? zr`dFoKL9qHZhB6$Y56?@%9==9n+m>gdh(CtxrRyTLwH8g5768n!+q3P#6kZDyU%-0 z^(^cOv(htbE+DqsYy+lZ*xnjH;74kFjZ%{Jw6NPr?P1x*Dnu}{w;$DXnUx`OgY9HK z_~p?hc8}zS)cB*wkyGxM}@1kLwxBsY-#KeM5!5>vhfB;lhN>~|6; z=EFk^@tK^J!#amoM>FRJ`l%UCVrg`6duqu%q6rmtM;w6Lj2y^q!bB6dDamM@|Lo`z z3#pmhRekN4=z^z{U2jLrzSTut$?od370XQzCVcf1##Q3+!i3Mvu8a2Hx)xzTBB; z?a$=rEE0hY$*HEh#{1Ls7Joj}KI#4aAU;_3m?lhN?c7h^c$XV)3cS|cy~1R?MhKV_ zu|~k&fA1<%?@2J-rp`r`W==@~hGe;eI$I6{A7)S??80(k!3fr#`qpuOz3e}?^(=S> z=#Nb;Zn_C>QTtL%+C97E??l{}6rk-~$s;j#Us0!Kxg%R9b>aW(tUS>Eb=55Qg;~f; z#EyI_ci1e1nTlEIQMn8m0EpR}KsJ&DeM9E8 zvqNL%HgJEl!ILhXmA+L^jQOB8?NUAE^^UczF8q`>dp|u44KIDO)F)!P4GpJ%s7K=J zSKM{Y(Iwe$N9hwGOU2lG&x%wCfi%EKUM<@!mzNHyQ?3U}Vz zLN%Qg7pan2ekFgwnMBRUtP-a~J6vLLNQavh!*jkVY@*RtnrudL_BzMFMRt`X#$83? zWo41^^RL=|SsCj*a7u~FzDpg+U4s%Qqer$TcMWShfdH3K`ObX#ZIvK?vGA#~89E{p&8@zMfl-(?6U|r*og@>+d1~>+4JY z|9pL(zSb$;F9cs7<$qmmszmBB8>t->66r6LQn(1xZ^FUgKpJ@QYCtIx?W^RJ}6Zewzn^R5rUGHoJda5nC|z)Q+9kk7&vK zR%5YND`D$M?*bfMJEIJ516@cSwSZrhl)uo({Qs^AK29MnxMeJ+3Zzo8BncMA_c~ zYdQiC4-&2lSnbcV`pakEGe1@Z@q8&BHPcbLa9j)VD7~y#GfLsodZuF|5PIzh-s*K? zJku*J$z8rxrEJUOZhQRK0ugIRwsl0G{e%6TFHm0*#DKpaz+URClx4!rqD|wuCG~RW zcG#rYzx%{Lc8WSSDH;<5s0y1ie!oZ1nAw=$j)yUf=xe0Dbcb^TFYk zZS>89@K@;e*(fU;M0>bG)#_Z+zu~Jr3os+bhS6QC{7N4WK*uXGbpwcb4WZ_u&on*O6p)j?B%L z{u&GP*HY=P-GeriqQ7?Yf9@n-f3V^1>$*Ituj7a49p$y#lvh<7 zD6dY(m5}R(Qd3)PG(}gU>?VI(Fxk%}8|iErU&EeG-}PG)YTx22t>)Cm)yIH}@b6%H zm=@lSIL)uMxF5J5al?mQ$HN|R@j8i1>_lHptp4{R$;7BwCLEUd}xxOrJ}`r#+S^&p)1T&oL5m*SH+fQ}-vG?-?;b65{fAZ}C$<dhxoGy-yF4!BB?F1o|bF(99wCvSvTGcN2Tg=UO z>|A=2O^DXw{?HJx5}yfCCCa&IXj-bPb%?pAaqm_EGtYa?A^F}pW&-0*gZK%3@;le~ z^YQH@X>nL+ zl;ETu2wr}wDp@UB8a0HgbyUyu6x|zXod%X+)Yhe6-2(JeN zXRP6|>#8=C)qp@2aVmX7?0UYP1`{3^ZYV2>O?owool*0P*!dPjsA&$tam?kC*u1PE z@32AVz4@5dPTx#A)7Ym1+=CmbKK*PGrqQeCx)Xf%vi(APD(-w8<3IuHFxl| z^m9P~A`o@};^cqR!{1|L$gFYXcLP>YlgsA&UCj8O;><#7n>(t4wcr~T(I2d7tjXD)Y>)4U-#^j7z(>Tf+ecQ6+kCo0pANIuC`B=eQ=mikA8 z`8b-^Ca;OWpXz7F2@H))39`(AbaU{ShZA3DFyN}>@qZCyWS`VEu)yz8U2?As;2-

        #0~E&aVmHr<}~Bwi`_E;DEp66_N{@VB!K-RWJhiA!TBy6$F65Q@Hzf5 zL9szXy!e^{_>%{@pCD^4^sD?&AnZU=Jya)Z~`ko;YCjEj3 zh|ci2SFDkPg9Cq$0^KU1D2E-Pc+T(Ft3XxHe&_r+-zy<-|IG+^nyK)CzHmYKd}C_J ztgH1w%=Kn1Kx@#JodRooii4^17v~W@fS=jkxL~djQd}t#(iZPK zLDC^4HFLTAIWm*9Q;DRJX$TkQz7po+4{b=C&cD(rm29l#f|-6HI9?9&pCq5fG`3#| zjx|An2ULJT+w-gs&7JoC%tO<>F9a!RKZRL;(iaKf{q8ou;I%dBN;iD|?TvGoJse^)5z9Tk*v)Wm^+-y7gb-V24Vgq8ma(m{4f z?OQb9+^TsKb^SYkV_eZ&P^u<9EfSe8naX_!e>PUv3u5kI{hlMRon+%l99Whv(&nC# z8xxp73i1nJwKvvbzf|*L#HdIMt@Tzyl#C!Xy5M>5W)PFBwtP}DXYKJKewjM+ODHGQ zL1nn%ttDSBK&Y6@^9wL$B_BhM^Q8zeL<|2U0xnLC@BId8uRv}7iS}4pM_^gMM4(!7 zVDh3;{?p=9Bx55ZgDCGkY=hVOQ*d-oKXiKExAerVYWYt-)L#=VN4(hqmKO;;qwYU# z@oC~xKLt`5vJg_~+3F|Huw>4E1s|RoeAw(&1S!WAKYZ#+KD;&fa0JN(1Y?9A642TE zwz_iuG5GpT-V6Nb7(q10`*~3G$)M=CpeR=p0CUUuh2b8yu^|n{m&gFWSqU!jA2<-R zsul)*zTNLi8{Z=+D`{v&z_7C4B(dMxp~pV`GT0>3f`L-F)zi`}Pvf0x-6eq8Te<-` zbPwK;d@>%cBr`3Vh3waas znQSB0I#V4f@hRXlr29S_+%pbs2{=&VJ>;|Vnt)FqO!da6gLO7=q-34#Bh9@J^Z7v1 zq$)V45vF~pZWccc;;+zzxzRVKw#A{>ecdMRK;rE$_V^2`4$(ig)}J9~avkwWT@q|B zT3=jKYYL=ML&?X2lH>Z7Ea3O}fx(-Or}*!K;%~j!SFupG`Ss$;iojv*4I}`}&?CQp zbe|s(@pt=F*Bae6DtidBgFJZTb|nvp_Mr>+SGbX*-o{+QMnm~g(R5kCkg@?23(;1N+QmI~ zkASrFblcYYtffT@cVINZcDvd+cq(7P9(YyRF6lSP^%G(Z|7iP3taJ&Lpu?IEN^p*C zexOef!cg~dWtvfTw?lC(sEt3csaCcpmTBDU^Lws$$cLVP5D3`D#t^*ydhYw=SkYr7 z;dXK_>Ss@gzu{-StvWzG`yU1W0}-nGt~=D7KBl3!?ef#%Q=hr18a=Nf(+J1^ zLp$~6hW>%%n>Y{8jtbFF7d(%7kyzs!6CC1ug7~(-LgpMyylQ@BucOsw^zZbX>Pa{S zb2y;;wX$fb3o9&f57IScF8;y`xDsP(?}McZXT7hOTk)Tdii=U%z7lTV{Q8E8F1G)l zn2v<5#y(y@Q0upjfLkN0@L-};UzvBC`D`m$D1ELNKk<2Z$2&R z@^^l*5-H%oatXa;Ek=&v*Qdgt?a1eSAQ29IqFwL5tAGAbT(M&A&eD=5I)9+Q{v68W zW8HYnwSrjIxGfpOI$9H#i^`|W-R+%b0g~g0x7>E^Glrsrjx7ba#@zZ#O<-}gq9I zVZky%mE2Y3EI(84nNVynQ!Vwixd#tos;$fK5bG?-hRO7<~Yh&Gwd;6!8D#hj!>EbPP@sxZNfBVZSm`_rN&ni%)cui~)BSegHM z?MW(eFmQ+QG_`M->k~-R_>JP8&YxlWvGkVo1D1XVK6LF&c-3%C#!T})cvsJIW<0JFM#sduci>$}cI`IrM<0%2fp9M9az^r@GqSmzzZIM# zG-)Qn;*LAP(lMq!uA{C<-KX%l;2|HH4KRJ@2IoREk@SRo=+pPh&GqeQ1C~oC)jU!~ zkE3X$euC3+3a>IB&UIE+rZ&c>7W5ZqC0o0Tp+amL%8p~0hqV_9CSJ`Ajnwh|PL$ek z=FI%*d-EkFUp=kGJrgI9&>^;^x5;}Bp;A69FK9eZu6x7A^R++eE%b@X!Kh6TdBML?o3orC8=?X8@f%&Hd<`n0<6KSwT(HZ^E ztcr-#Ztq)E5Tq8xmk3bd(^xmT6!|5&>*{Nd4zIq7%33lVY82q!0uHg55FN;#CM|>E zna!nS8qH|tc7yG{BW<&k>E9;vEBC9GGUzf6bI$4XPuy~J3Bxu)zB9N`@PCAZ6!N>T z-L^V^uts6=y@Gm6U$ZNNW`DSqX4ji4Le*KZB&u3O9l!`6ieNVYlp}mlh7~|b+)x1H zC+`0U#@jy;7-!-w6Z#E4YCxo}A0`++V=$b}Ets@Apv4D{Q0JYFQLHwFR-IG@Z_ETu zMrI5+!R^W2V)4ae6Y^bYo2Ja2#NQEM9$i6y@}bv$3a-;he^$YOyV;g&cK;cvw`!JN zqHCB}1k=u)QJyYGdq!7qFCe5V{@}wQQ2%56 z?~1xNactrd!Ps`66zbXNdvWiJpfI^+45^UTQ4FM6MC+}bA13_|sw?2{Eo$0bNNMKm zZO76B1hR~kKoHK9b8ge;6J=dab*f&fuv0y{+o`^|yV|L~th>gkzPfvgQyuSaa;n?9 zXGfgsNH=>5)h*qN`2XA8?P_aeIbXEY!vb3LS)_giTtVNq)Ze2tDu~oSs5EM6sqa$S zY^7~g+I*$$P}(A;z3q%lS+xPaoRQzIGq^@xTt^F+)lvD?b<`WLqsq3rt_YRXZRP)# zx*hy~UftV1)|^}RLKd)9@lz=M-e+xkf9^G#-h<%UxpNBSH$MG8lHXT;WaP)(4eezs zG9bS@H$#41$QaG3*W)LH%{xFyPx5UDOqdRqGFV-**W!LeAWeN5&NS^!?mEa>UMsGu$Zsob@zZHKL_|ukB6M+D z1{!@t^zKxjS?P>SE~HaV_1R;bk#4I!o;iWkPCvDd)I0ptD5>}PsdGuywHVZ}kknp3 zwUyNEJihBx-`q(*-X+W9U8_}9KD1mDJ^g?Haeiy9UV%G_({UR`<+O)R9vNR#3Y&>$ zzI8PTEwEEDu1xqy@B6KwKr{Y!3Pw7Ap$vBf`{?1!Y&_NH{Fv-?a=SXoVPV!$iseHo zl8K#S^S<8j=iG7^HT#PuOK(z3u#@>4(#M9Rmh{r>6JQj;4o!S-HEZwypcV}P>I+^) z095KKCRn7-fO1lo^CF%Pg!#}1Fj>jZG?Q(yjN6qVYIy%#R+2MHb!nC>z{TYv=Gh1y zA|#0G)=(G>Oxpv$hEnkxs^eZ&p2Djna|Vk6dnIWO^~pUk6Z&mnY=0gxr_iYnasLXM z@ji9sXiPkblk=g=`_*&)gH)n;QGO-E*uoW%-|Sb(Z>a=;{S$RakF6TmGYV_|`S)<2 zJQcdVT*-6~%QI*8GNE_nwnsf@^{Zzg^=M69CiIf`$tz7BOAS(o+#74exEJO_d4rCT zp_gWN^aY9?_fR9!#C#{Uiahjm%9%8AztzWXv@cB@XHvwcp*mlR;DfKJgfB_>g%SkH zGUVgYS9t|9Qhuiq*T@(7il)H$_4!Z(Pp4018at`oOi}JRQ9`XHc$P3$38O9Hc}u7y zL4Gd8Z<^RQ5Ldr1N|_MvWOiTrd-0nduyk24WaBsXm7GRNpCe8l&3eK_NUa1IR+)tgO>-{K0_b!AqSfQ~e8dKfPxWK*Btk}g zohgtwUu9x{@P*_uT$P;EI0Q%8=4dqRo&BhvHH1WGZDf47aZcg}H`&RzOvs0kfKxoG zl0PoAk{xU9bN?M5Gs2?*iDvUdmSN{_+v^rFyLkr;F;pkj>A#4bIvqFarPFc%{i+W> z%7=ejn*DcNl^V}>QX%SVY(^j)A~xL$Aqg22oJPTHBc)s)C_2zYN74qZC(%`4oQ}Hd ztR*WGUeow#XZia=)T5;})KP-|;QVBrll%*5GMrOG)NJP76>I#j^Ux^gSvZM)-uP(y z?sF4kGt+jR-U}#SJrxj!_){SJYZ__a{nbQuA=g=c4t3^6weN0Dj8Ni)1Qjj+B_Fmd zFaVS5K6I0}(EsqHF7^Ys0noXnfp7T2>Co=0zrGyt7atIP>5l{67yc;t_AF;*>Y$Wn zSHAnS$cQ|5WF~hHPGo~c1Q-wB4Vpsl84c`)-r@^bZ=|I3(bhc=PXw2|o6ooJhI%gW%ZiAd)LH#&IlW&k9aH>TL}b)b z6V!63)$&y*^-DA^26_XF6YGHuwFbS#`)WWf6OcbN)D%K?Yf1ihxyHsD@*iNo*T=t) ze3)Fv`l0G5_V{jpj2_W@CiJuSZGo?4>z4)oF*bN3^;eH?aXNnVPGQ=kD5_*TCHpKX z*+t~5zTNl1L?PX;iBx%i;U`M>jR;@oOM(G&(x92XfJ#X#9Dq^B>aVIx4CDVMCv__C zHiFXcC;qxHh)(KAG8o9d^OyKwX*|Os9;YJ@WJW-qKAgRl4>O?`c77zGOf4}nk;{fZ zc_de;yj|!G)0f_yzH^hQUk^|^`yXT?yGY4JcFE%*>fC%k#d!HhlEL!bG}L#3Z^_7> zCiAJ$80;!;?>Jjk|qzgmqJEoo5Hx~+xrb#V>L-ieIjZU(U1 zyYt;?SC~rMaOs=Fe`iE|J_!aP$_T7DP)x=LLD40Yid+OsYk zzfTuLYx@3D;G*1{@9hKpVFG^ZTWWcWSMLM=byb!LU1xP}@}|QDK8EJ*Sm}da{agQc z`|tYE-05q3ZQfi*o7peX1meTuI2w#L<}aLCaq7+EUN~W zQ>;W$4*hbJ=@CeiNP%0tGmtEODe!ge=TXTms(3df(kGDEfM?$^vI)f3q4#*}*H*8$4cWzSYfP8lR*l-qP;Wl;_`ap@EtXyvK=v*( zGdqvcGH+x;?*)~-q-41u^=HTZ)|>3LJG=M94-W(izgLWIiQlWk`H;%4@hi*jA;({a z>uptz6KgTl9c2E=GE@8?*yIr}i}J-E9}-)TU?fAEU&o~G)2C>izg1cj6*YBRzq7Yf zD(zZDu4^Zjkgjn*v6EcwZKe5PPU@?ad6;ttzVZJQc1g1f)G|X<|C%)-U);3;Xw%8+ z-~a5XD$5xgE>^)xapkX!cXb?1s?mP-Se_!BSds}sWSbWIC!@N83vC}N5WnyK!{Ep`NK45ABc-J-cS9 zwGun>apG8B(j!5(_azeETdzp2Sx7pjnj1;aht3mp80R9=RHE2DeWk*C{c;h1Jjyv0 zN+jzhaG7Z)B)K09WPidu;r?WD`b~*SZ{9^x3%V%yCBL9o^?OF)21*y&O$-Srm(u~_ zV8mZyF92TKc^;*TveOR%ju(@iI=}Y+P;Xn7uChw>zZQjjnS|(;kvi~Khn+xKFZ?i{~I6> z1Y87GQBi_K4T6e*8VHwN2)farsHmu@yp0#UqwXqJ)Wjr0d|1It)wWuFYundW>%9nK zHGpyvxrkLkt+!Tvw(AA&pw<03=`0s>As=a^Y%*LlLU$A^zQK&mgnh*Ka-`e2s>s_`_D=agoQ-@F%%3O}d zbACyO(EF7CfV2jLqi1*O5W1AV4%B;U*AAf@x^-whSP&ScoPE;&3O@m7_~NpLMYHG~ z*CuGW9J0G`Wpef^oOa;oR%r&5Gpe z4L4o~RMJ}y&8d0uy@0ViHPtL}eF7uhcYEkHc|()4gBIjA zy-(dW2#&b)D$Lh?RwtneI=DJ}if7Cwl1O5Js#7TUROHoP^(mlVq2*~N za0WE2@vk=o5ln{XD;PCuFVXV>Ofj_r+Rdn0A$N+X{I%k;jur-^fgZFO+#@)@zu6zV ztG-?1A2yy}3U5zBIwmC+Q|e#8Ol4>%6x^pBw;gt=hCJ#ghN&iPY7#N=xmA9LAvVy& z%^nBl%(>(3oGEj^`Czlq-pSbZQW{oDZg6o8KB@+hn&?{;;0l5`6c}s+`kYlx@j_24!BSyws_T2^RBKH0WU_zOAp(Aj@G(~F4F&O+V!l=wR`$mf z93MGWqiOcvn`n6C)fHy`{m9I}9ZAY`jC((5Bqu{b$pIpEh>gmsn>!n3+I7Tr_9}JO z_0f=*>t+GgS|81;6|ZvVM0ADCNsabxEmUHo9d4YSOO=Ca)NdZDMM7N*Hx5x&!+@oN_K3()dXtT4}g{Ssi{6BOQZZachKaAHNF+!^$%S`AfZ%766 zG~9@|Ll5N5))dIggWu`RfFyTk1|Nb;)IpC>O=_=iuvoGY;}n~Z%VjmV0^LbFA&{$| zMUsQ7h5O?jonH-ezz#3(l{DXyd@(Z&4>tBi8WiVjptyIV?ogY;&7vomlUVcQ@jGpv zI&@}VqC-)^SQhL9*c8fTGA53NIE zPnxe2oa>)Ea4&*qs&7v0;m%7K{k-Y{MZ5X5OldS6_(%lx2L3K)kx%sU$Mh1W1J96B z1`)Du!w1@wPip8Y{7rAOq4u?ZKUsqtAD$h#WG2IX?F5lP)cfX~R(vBB&oJ__h-E;t zm^a9$YAC_VhH|(hbwzoleLeec!cbILi+fx?7&!H9ewA_+_~9c9O$A&CVhOM~SE?3!)&zl7l4%1`zIPCLgHH_3=HEH* zbh52HO!DFnpDK0EFC4Q{P&T}vylvUY{d3q(iD71w`_w?%smM)FX!O_k51oQgEN7ns zDZ*h)Y0Sb;hPAjb=+m9WYyf#$N-z?boP8A^r&rLUa~j4KB@SwMR`?7h_O0?P%p|La zcZVVG-eX1i_RZP)<`#-ksE!{K#%TBZ8_aI9Yc|r6R?I4rcoP6GqI~9T&xj$sN@10} zIU)vo9wKWOFFpA!V^eZa!F(rPSgafk3+HH@8vFJ($Oc12a$u~H%!|66n}jZaEdXJg;^OTX>l zy|6UhzvD|fHTq76RQH}8R#zRcG*;I#bmH71;_)_Zyl$OWyyZAWJD!`tNp?Hh zWi%Hxk2J`NsSw=fMCh{|i_zi`O&(w4)koPWf#9zm6YVq)<;{nyXE9c}+g#m#YfG@?3b%`)1YdPn1qn!F!07|owNpwLp>gqMF zru{8}WwrZ`r*7B0gqIOsc9!EmaIiV89Bh6o2b_a(^IYrcdo7Mh_i;u{z;eBHanIuN`lsR>A)esl2hQgl6WEs)^^pW6 z8~@!~$G>&pjTyRy82gF&Z!+j2Q8*?f;s_(p2!jWarS97yHuw$&_JaJWtz5OW7DB(| zia^D3j+5tG1h>JQjjNg<=L}y5jnZ9mH+B>#P?_}?Sif?{Rz`Ce>jA)L7i9AAMkWk}o)F($uk;p-^`e;WtLWc$ZPSqX(m%JBh z2CvH5GfmzuX?x#Ew@IGHHTe>h!WTVTp;F}q_aQx5|2Y%9;65bf_srdw)Wxe;ypw`# zyYC7Qq2g&UKJZ#^+>Y_x85XID5lVF8<{M#r81ivzyE%MOKXH`ZIs_5dZ_?1NTx!Bj z}!{0${`(e&sX6ZHmz);6%L;0xyp@1R7G|E*Q_Bl!Wot$%U#4^?qCyM14T zL-q^xA3XwOh(ntmEzLy?yO$IKROQ6t-}4#}UARds6LJbS&gVhmL*x!TK>~W>sFMO= zVxZp18K{esA3aut7WC!Ga$xaC{|&VsD%h2r-NhTIZ9JuZ@%nG;sPsxU){)P}Ep7jH zXPKUY&HEd(VUJ=lUc5ZZwQOwC_k6?O7vq|@Jd?ZW&K+sfqTGEMi*o&Q>S2LYn4=!k zujszDA_jaasA|4h{}-T2^cCb!vwZ#EE?@Kl>6wCzX|^+`9`sz(Tt8XUv9&RtR9{ej zsz@~`uV>0@=iaWoSG;*D!-D;fhWR=ku6iNf+~YYC+m>|ANTP7}6Zn^I&_c3`EwO+5 zaP|vqUfz(|1OF&h#qXyFlZ?)x{id@3;)42aZmsW#w)Oo_P~Sa2u|7#BC@FJ6_QMM$ zcl!g55LEMR1~(92l_N5{&ekf)UPg%`n8r5}J>ty|%kI`mik6pBH?6aPI56B>QcB52o_3`y8(dgF z%Y(99EjVWbDOs-gY<^gIZs=_5%{s3ozJ1h48$Y4Crzs^6v^A%_mx%d`-5kZR|MOqk zt^*fui1;-m4}aAimcpiZjsK?0MUBP%0QXors5O;F>p^?H8;_B+5uCmcXh`k%wWx$b zvsaw>b7_vpM3qvDM86pYBolpTY!UY^hWsnn_Qu-@zEV{-)OJ?vUWTuZrH%um&*K-! z^t@wOg{I$bF%ba=Nud3CrqXyFEncKS6Sio z*#ipppas(_7tga{%pUs;U@~q_j&%Vua{91E034cATud&$0SR`MW3~*SWO8RAt;hR3 z`|)?R513Q@4lks=#1AulC)e@?WV)xDd2;7d1O1d!bAW#W3j`9y9+1YPQ~h(G0FC%t z!S5gLmP6DEyS3Fa4*fS#p%e*pRuQHR!yNZi*YVW6WFG(fzk2`#2G-O~52`kEn{HmB zeTt?B^JasbJe!x8 zUOZx=^on?Zyg^bRdAP_Vaj&|snkE{0580_~oTi{5eeH0!nSj1Snny&vDXIMCn$F%g zgpL22AQa(7nbb%=q-x~jk_D4piE&cK3{3PN&Vh=Xn8H<_<)GWF@+>QkD|tu1;nSi- zcm7L8iFY@Ab*6au#?(AQ=~)k7K62QMwvV^6d>Uh@jsU4ctt5GCXO(nBnddPuK&qf5>r}QJMoKpIxz!! z%h_`g9CyD9GD}64{aW*pi@zpr@ONdT#U)g&q=XL^o0On-+erz=KizzB;!x^liKtkI zWgWO_gz8~oZAnI2k=07cj-#&eZ{J@8mK=0+Okjfo*dKT^E% z#6Z*gp0glUw{-~O5y`|pC+aGjHg6RLk{@IaQ>-1B@gQPMa&UVe=jK!Q?GWOUdH*gI+csdAA50b}pwMOUfZZ@&+g&9vVq%4XQ_(`D27C3vWY zs+PHSV}dR=yK`95#=h56eY>1pA(yEz^4v`{*4Yqae?f=z;m9TW)LmI!<8kZ&gGB?y zh{=SthOUN34@q=uz2@t)x^Y9im9g+`&ktTvQ@f=)bqrdez0{~hL`wALDi%9AxXNF- zqIW2^qSHZSd5;Lb)Rjd?HD5TA71H24s$q6TPi!mW05O(*j&OY(P`S^*nU`P&!9l&@ z1~=EQhcIJ?8x^*q%AH?x;7^2=-Sj`e3+(8B4E$UFH}HwTI(o=l*3RuZG4=8tb)v(M zbfTo76S`;f=iye!Twf+uz8jt=2Yn)#4IPpw<~=b5v#ukAs%Bdph=&Jp49cx%Mjlbf z<2cBpTIA7!YEa}6^qQGE{Wih5#-I6Xd>Q(+HcNo2nD?n6WH}h%UYUuhOPGg`3-{F> zzmDsy69n0#s-hxMQq_D=`UZ+|st(%Vw(hEmafy*t&0~e2gA@A`ylkM{=`Lev`KVXj zbw#6+-JydHdiBgj@B=tt^C?uk90}9c2YF^o7`r}{Q$3U5p zjU+DV6SBjJ+^o)8x&$^O!mXUK4!Jl17bZljo1HnjEYb0DXc5RYQaM z@J~ldnKFt^3zEEl0Gq^sUoz%U zLutXlKf-J-ry1>7Dr{zSVEP$n+(t5oz*aPrAVw5bH81JTZ}cy)l7Nr*mgL-yms>b$ zvBJSC;jTCgM!i8g+m z*u%AsHR4)i8v($C$Z|9}vnR*d!i{$TBX7#ibX7{zKhzoGi42n0%zD4~QnQQiv`F$@ zT8?AYoXSi^{&)ky#S~8u^+`CVKIw)lc&FsYsaU_v`L5W-3sAHal<46~ERx`zIl`4W zhBB@8-1eo5lOHdV*CBz8@SmWlpt^=$Ls+90h58|8-Ku_hFAQXv|7W6)B3qYMhgs%a!cNK6hznd>?Y zjy2mno^+8uWcsfGy?wT`KKr@*>=tUz+#7&_GPRLLp@sk+9Q;eNXet#yFq1ilVou*$ zkk9E6<(H6u1a0nt{VWG+DsmUK3*u=soi3rpYOP&g!x5O;GmVxvcQNpP1+09YH4BeL zGQ^MLFZx{f%ismbr-kw6+tOP}^5gXLu1q040)F=_F&uQb<)ifPas{Hf;db3qei!o9 z^#Bn8Igp?4-ba~pLF8cT(0ad!4LbaA3Q6Tb(kFklq*$9FSYlRH4Z+PRhF}UZP+Ac^ z3=f|$4#@@(9q~a%S8?xTN zwVR0@KO^apAgRtJ9ZS-o&93>2T+(QgZV5`A>XHW4c%Is1s5i*|nTlM+bjZO7r3@2r zZy`GaTwejF;TOjt1Z^Qy;l|lYOhxtz8rZf|9KfyJAC`nTSc!s(poP|(pt@Q`k>$SaeIO5)9FqVG2lL*CY0SU%T8hC(M zaEzJ^^tt(I^eg%nKdEy?3i*wjAez6OnZG}CQ>?1Z{LfE-OlCZ|`4tni6_lrM6b{$; zvk~;tQutMSFQWfEpVa1t7TU8Z{xuvDz@B6-0J7Mgf&BFL@U)q4%P*I z8n#22?*Oc&M1g-rA$$>Q>SOl}HHOktksjPgiwwfB ztC0y6N_VD28@_o0sE4rl>J-S??{^c0R?$({>?;gKD~a#K5wsE^L2Mk95E`W~a3bV~ zn|3EXH90K*0jx6?A;G_HoX$IQe{Asn_PeH38sS9R3jewjfhO|Hvw@%%8B3uQYOBgd z$A@o-4}U56C_emUe>c1Zop@Ok^S%n-^k;e!d$yea7qp4TkfnYqnUuP&+=4M+jdVX$&w&HtGwX`(Yr;HC1B4HE%pH<n8ltx)XZZ0N&%%6z3d##f(g{tlIXUgLF&393q?R=N!0y#&b<- zOi7(2k$ra`hZjz6zJj14*pOuHE(=Ay&?YXS>u^rTp|-EP!3lKQW@2DAa^cS?Oe1U= z!A@t9lCDmc?EX*ipSd>f^=3KB*AKdb^OPKr9b^;kBlbIgVNa8d^bacAxvt`nWLJ`J zXLK|7$Gr?KvJqdMyvwRv**bpQ#n*u~C^o95Q#QE^K3&)|8MYHIrMCjan}EGzIa?KE z+EUF<7O`{W`1@bg-Z8+rIx&?lpGrGU-V-?xTF3TwOs^oo`f9CGYZd+{ezQ_()2~80A_z>ZXR-TM^9_#Af}mxqTP5} zIQ=#u35S0?$=eE{Uod8Gae{3%-oI+RcR4XTGcm2k+l>D}&EVIM_WJaedhn>>t6LF_ zJd2fH0$;Va2e!pzXKqI*$>27<#!oVN;S77Qg$<%+)rRdKJgv$ag7s>Wx9lhMzn5;V zxL|2T-0L({qqjPAVxN)n2gVQ#8>~Pa%nk~7m z@0I5dHr@+WL%Z?*Eopd6l{$*J&Dy{*^b3(jjwOT`+v@C!qf(u|qOH&|UiVVbMH6SD zv*Cra@$3fS2jpAbP4S0>?<025-Z0XljZlsx5F_Gs{#zJDw0kvY`CyELXm1_cSHTc} zdb$nSd+IlP{27iw2C+5B5lHay3JSLAFCRZDi{% zmiBb~$MyH5_TSUqc%{jk{|=CqLs7V~PH%>!0qsAc(H^eRj@nbej3$d2O%*emp65dr z6*O=1EVQR=TfCKxY&Oy|jh3C`zM>%3pQ~4PhCuI(T!BkGw$FdV1H~r4;x}=K;vw{u z9+_A=JXLRUp4Kr|{AejsK(&_pIA6Cwb7=TB60dETgp+thymD!55qjBBRrttd+8`ce z!P;1swmzh#7|V@}+%VHKmlL!NzDEnYM0={{cr$gjDUt8qi&bde`<|c`)5TSUfxah$ zawn6^jMd37J2ZAiY#L6>I6{Ck;_b?Q$67l>@s)B;ntdUu8Z$a1qu}K{L<4pOe!4;Q z_|~M62ZbAT#M6yV!)a|u$kY>;kOs@x9Tpj0$TxqNwxwL3qz-)>OOf!mkY)8;MiCUS z4_==B0csB~>{#P{2mh{KFnUY^+Yd&!tI?c|vvN|Bcfk&Y5$N5_{#+};Gbv*C=WyQ) z_3h^B!>BTW%RZJ<(66f;6K*<^rd2+>oE8eoe+U84eqnhEuq<=oMs3_6IXT#$7%Z0q z%j5Pf5Whvjn~6*Q5C5}C zF>mZbWCQM2*s2ni7SaW2ltDsXfv?~Q-`ibQEwOv zH@(NiCsYOZ;F66hZaQn{i&R1|b%@JDO`&Z{^=cjPH>KF(R@G zX?Gz23;KRQpB|&7AQf4Jbgi_K)*k7~aWUxMx2-TU)ZyTm;EPx5T7d{y>g8>}Fc8ip z&AN1w!IJ4{hkBTBIwUf~8PR1<&z&m>W@+o}#(zuxRju-IU>TMZ3oMI1G_s-MiWxc9 z?Eiq#L;t$5Is!HLYEY8uF+(N-jHpCpNJD<|!8V~eG0O30^h`g29>%nhKNy_Jp=2*U z1%L-^zqi(3j`!js2d%Y&L+DQx#uL;Z78`9)!iCY z*PH6nzX29B@tV`w<)imagky7MH~%k|7gH*RpXrv0Z5ZA4%HoFf(9Eu>*t4UH^?Z0{ zr&R17o+mb>PYyqGLQ!hGmEwm|O`{Ax;#SE>G~@qg59Lj)DUUjVy#0psowiDQ$`<2? zqoaww*h68>FCKLrVMUz{pMvk(HeRGvu z*>i7wZ}q5>OLCQr7u$p7vlP4@|EsVXS`cciHXENkJsYIeL0Y3vOI}1_4tUm8!qeh> zTUU8{&}=CAg{2Ntjg_y58(-l|w`Rq|&vYC;?#j;9;rpJyjI#pZn~qh2+bVLZh$}OA zy%zG)7{W2wj-gjgOO-)OTI?J?seq_g&tF!s*kwSOBZ-b7|7aMb;p31zjEP+fnqGOC zmT6#2{ww%wGT`}r+-E~v0D@?E;cHeSMg8-X6(mgdPvb59wV6~z8dV%I5U{shEjZOB zFQ5j|sQ-7#sz#MB>q#fE_BcUHgd<+~$;{lLdoEa9?#S)V>zPD<66r$1_6rIBR`(ND zv>neb2e%#1dl0XUD6}_F`N?g|zkN{K@|WbwkEguJ>YqT@U~gQwagGq51tQ@}Bs#8j zgu@F5=V%L4CKt-~xQLqVJSuL@GRo%H=fVvy27;Nn4KHipDnG0C154twpww-8wjHNw zdSzb>hT%qq%+Q%6QFgfTSWUasfuC;NiwnY7ZhtsW&2AD=j!BNtKDFsznh$d;ZScR# zyiYh(7Jl|jI9xYfLO0!J^Z7b7*Htt*dcQkK!>o-O{zVMWt00WAPtIFd!K@Bzxa2yLhco-8^;oP zV2KvQRPn?M_z6$+St3_l#G}_(_K3|QmP*qFjVsu%{0OT^=uB_kyR_bI%^I(7j4v5pPkA-zc~M^e$%$Lj;3FM)I>F{+4siBWu>=w+XN zdTj9N2RuNA5MzR?eST-HrwKSDsplvSr=vUTR67tdiI` z^wk8OgJq;BJ(icipMN^aV%)t-t}o5Idszybk=Nt(OJ_iZ=QNBgN@Bd%c`SL_MzuDv z8_As}$zH3$u7t&rGp? zN@~2CRejly>-+<|u`bNJLFaSY@Y|w9O-!@&h)KlH@meMg-jJVv!TrTO+nz_+%YxSj zAWdTbl!{y}fG!5042Qohj17suQQ|2i#yxbNbV<&B+io_Ur;wx_SQ~lH={vP|D`mHN z6B{r(e&`(Ah<#2(dB<03YR?!kvFVLjGdaaRiTKvut|EhsLV(P5}tV&Wm?2@VI0= zf+W!U3dsuyFy&X6!f>O66!o{%^^ct)Cily{|_8aVBiw+M~Vi3+5M^@)@Mc z>2j#P9cr%53}+Y4TeA!FEZ3_Emv9d>FiS6g9d10TYWA|gAUg7a`*{uDg!lnK-{-vL z+*dEu2ukN0L<&bx7qv}cYW=}doX?+E)1_2;RZhjdYUfAlM(=`b>3_agn|eyQ|BtV9 z-x6*`2Egnaf_Acz6RpCd%d?TAU1RD7{y+9YT#`dwKAjruo&alrdjg!@+!Iaoa8E=Y z>FAy+vXN~^3y`Cu=zrW(JR5o6Jx$I=-f&M-xd+5OP1mv;b%RK^_LOg7c3IG=y{uD; zL2{ofJp+4+dzzVz%y&<-vXLfx^6EfvHZse-AV%_XfqPkCFK4(H*~#&PaWCSn#Fuq1 z_uI?i?!|;cK-$}ku7^l~_g?jH>}PmZCjECMTkIv|URK%57e`sK4fgVZd)Z_!o88O3 z_VS{8dBt>y)3eqqk>{6NwSeK?q!y}40SIH>}8;Px!+!PbuZEk;{WAdWNgev{#{MC0}rx$ zC2prY@g4s*J;SKbD%lJ@gM;ZCC|l^CO{_%#4}7$pzSbQA!~mD*>3_!g8yAmSUUwJP zE!hh14kc@Y({FD7D0}(S9TkxjNmk~HL^mDEWjF5Jx6$-BH|-trR^|06x8>rO#zsv+ zr7s(IXN-S(AAzr#1i7O7CY`ROv>+FRp)|0}I? z#s1nt*Y|jHL!A7@p{N=y?zT>u?+6h+^>xEkGFLWCC4mQ?bU;i`9FEw;FML|(Br24| zzm*Mj`ZOx&RtZo&u57q7NTfbTd+OKX5dB=)@CbROd_$fi#RcTWQ;*9JoitIT%tE*P zoZr+ETjdb%8uZ$*M78O<%!VcUmOU9y`a%JiuqzR+c1e_aLRgqse^5;>(YhE)5_As# z76Nt;CysLtL+qIx^0b_`&?7CUf4b3@Q;iwE^Tb!s-Mj8m+4_$hG{x6mRhk<~gBk(s z5kc>LuGNPXiPh>)5)-|5xyqUAouhLHS9#z2H|ZnDBH8u>D*6?jDmubcpN>DD?Kc!8~fGM(MdL?cnvP(L0vJvVn}D8PH~;G z_i8rsH>)x^xV3YQ3?qbAabain-_fGvS9P;1icU{ekZv5j4#$ zUFzI<%7aQkMon2c{2{`!l&^YYBx<{@`-uUkws?;Jnnz&tbOz`V?M zeLzyoGWpjJjRPM9xIw+u6YyN#@+E#+M4_ zl`Et83i2!sg`56|{tBjhG?=L#8!k~VzXebsDNM>Umg18lrC{;1yw;eH^j~=jIE}-h z-*G!&J}WX{4*K7KS<5CI);6Gm!2%vr%Sd!jQooq`_vZzXI7L=Q3y@VslM9U~Y9TaY zDWMVBLHr}Q|2B7C&V+on>%P=oh~yDO~9E$7iJbT5v*)R$$Q|Y>^JP3S&tfs6%>1GxF8HWF1Jd+PEW2$F;TZz8a-_ zt@eS;FgaJ#1g)+2ull=vi}OaC<4(VA`;BdmZX!*GXbe7-wWhzy!I}4eaOVe6#~Mn8 ze~o^=c^K=Al!c1-vxQo!Qb(}lp~2@oU^7d{-^SsWV|Ob>6O)KjNRbB4?2nIo_}+&X zcEutz)Ybvrr?fv4!`*}s~-d-$CnPW?x9qF1lD{IXKVCUkcZOR8k;N#1ApbHq`)^C13x zK5ST8G{VC1WL^>{Thd69Ch?@bRB!gRQB^5uyxb+fw>OPAOo0CP7L2u`AW(gNStRkHBP2CANf&C4%* z(>%S3l5%;W4uT^JJIs!V`+P zbPiEjy1<(7#N~D0j!KSXmW-LGhGki;WrMFV8i!mWB?ohDKXMGt|(D z{IAuE4+^+8&Jg=|@Rap+E9_&Vv8cez~{??I*7Z+D;^_UEz5@>;8e(?upRpsiQU| zPioigdooqzM1OLBucE!H)LxHVUoC>K-S2G_a`hNTAyXtEh-5A!K}SZ=yNIr@?!l{3 z>!X)AiyLd35Ndl%UGQAKn#fq8rxZLZdj z8NR{`ccOUmm5Fmp5nj`kG~Fto1p2XD{D8Rk%R3<_i)ZylqL2J%*wdcY7yU;iz~Kb; zN!+_93Pa#_+U6(kRoUhz?GxbZ9hBb_{yNGP|CIO$Voa3MSItkx`9C`M$r_h7nV*$& z-r;}kwwj;(l6jhq+`-3`(Jq(IL$0W5Ij8waZHme3$s0e4lfuvU_Stl`$s|XS^*%GqE%YY zHQZkf`?|s>%4Hh{OP^fBCgZd=T%Ow6CiCb&{$H96nMt^@gL7G%`Lw(nl{GlaP!3Gqu*In z+7D)V>@wYNa_4z1J|s4=i5S(#t{VPEb@OSsFHd-f-xjbnEq2~gePfy z)y)$YL4@TLxj!2jak#Oc+m=hTs=-M?^54|}h~-U3)!X%VFWH_v`uiNDKp(m}!4Kk= zs$1ewD$ll|&F8j_cJ$(l?cdXD@OYD?8w^O_ z^MV0sw1fS1iv=+m+Y&qZWys2DS@wvoCwi9mWAj~Q6+EKhKqsVClK9cMV{=fD0DvcD zBlq&+ZSXcV{HrukQU9+m_d`uGuHj$(6Qdfw?VZ>!7h0Zh1W3HK_%68E^1sCUj!Ef1 zdIrV_b`g=S=emS@Nf1xpGD7dJadVt=txLo&RZke=6R)zJqdL}>z@sOeM29QbE79To zXO!mliKV0j9kyuSo9VM|<4N1qU+6}LQeb#CTCrHX5K|}~6>qmg$AjiRj^14G)%p-b zvleamEeRlEs}OOVLqxdoCbB?AxUoqOAmng|kQEJT0iDBbcEuW~iQg^M=xFI5z(lZZ z(%QLxGk2oyMf$6_wgul6WIsZ7Zl@Z#@1ebdb@r4n;AzF>{M%tXHa8eE_de0;eA{s0 zmW_++jC5D(x#3p7;C9=UhFjrqyX%XYPuz%H|B)wARf;sJpU;>Bv9TEID{VN#d7hVg9 z;3f9?8m{@60(l`9$|~-CD~@?M zJS7$BOGl}$KeqW%ReNCDzgRTX@LfqVjWXfeiv*h=?b+PA%&_Kmt8+EHDp$UV}QKuLEunw_2F`Rn{8#BpGUE`epJ|IF{htn4m^l6>Nx z>MoXm-eYrV$UlS|7^wR(p0|TD)#F&|HviF}f4iGD@H;!tu+Bd*Xr*oc(rORH^bg=F zc5op{uk$D93xpu{k^j&j_jpS`;fXKAS&rIPBL&GvwXSQ+8mw!(wW=v{$V^{4TRjEA z^4ZFzwqL+B{v7LAEVQe))2J5_nKQ;bv@fjjZjIk&B#~d}f(Mw!RhtSzvk|K8yteOo zQmI|$W}|J>ISR)vVZkCnq1bxY=|T3^T!>a@twouGt13rIJD59NOT6;=D+Vlv-@>J< zjp`ZMNSK|t|G9?GyInQbXfD7UpQOZ!s)MtnWBU!u-xb=d8{MDEBwwhxR!rIB@Rk(> z)D48=_MPRuVNCM1Qj`PXrj2uZ9KKU&DEy1!L-@&|&dDd((vMd$BE2PJ+Lq+^XC~Io zDIPyX;oII5$2m*5L?(0$kWXGP! zOFp7q{tNAW^l5sx-SaYv?U&3eG-?;Av*1b!NnFjU;imTL#D4zmH;6PnCHTLZ8D@*J zM5Ur!@5WWQB1QgDU@MQJ(4Ky$eHn(8#Bk5&nFg113O+@vm;w)|DUvQAyKlz8nX?`8i_SCF8ECCS0DH^RDIHRSI*wkXu_edq9; zw}3C^-S%Mgst$y7`CIlqEAxS%PTgdB^;9G@ot6fkjc~Ktdh@nL*QVfA$7Ca!!Enp1 z4O>eSL&qGkKfNB*R!&>O0eZLaer9`@b$-_qsj1Ogh)l9w$2$M3DJ;g9GnM`s6#AzU zPC}UZ4*Ao4pLSVn&HWYR!ZXHo0Z)~i5(hyUtV=+W8Au%)f;#S19lh8|iGKxY^Yo>Q z!u+hj)im93fOs48v30?pc!^uKz?D1Pg}2>lc&vv8%<2$&h`;gtt+=v7=yQIL;_qGl zb}(IEWbaZQkfJ~H+Awq-zDEyxB*N1=2c|~CL zPd;3up3P5d%MM;@U~?wnd|_ z*5GewGx(`s@Ly(x{QYY4ga20H;D0iR!Qb-ZgZ~U?;@#kViTxywZ%p?SS_gkJRt}|Y zJw6!x4}(GWalzlG{2s~QTm0q5UgKF{ zU$Xg9{OM_c>V~wA6s?b+$D2E_ag2M59nZmq@E>H^HmRztRMs3Mh7pn`7VlF8*${jg zKQ-&f8h^!cs>M`&NE0JChMhR9VOunDh(GOfUb(!-0BS>}QFgvKB(Q3$C z=6CBTXGug7tWwU|j3y83XHDYS6}de4-~{(UOwtScHp7~9&Pf#-Yr6pMKX!%sRiXG` z>pR7?C4Nu#&z2C}%7SHuu4-%W)&+rOh4=QB6^GFrf5gDeRGQ3k|JzdoWXdrv2z%|N z!KfU&X|ige6@^Vv`F_qp5><%v^z zJf-EmhArIv{5G{L?!pg2U>O?p*<~6TFQq{vLgtD7)7;18e8j!2F{iPTetSP_ca?w9 zvl`Q^6g4E@^c_{j6deJ7fu#)LMihf<<)&Uv26H)7RasS5#;u-+#sA`d%?`;Uvz_DK zEKcWU&3iu*Oqu78RYh-Qa4B5xmqR)HYHl3JV@)mMwbb!4@2vHIwSb9mG?jHpUfQ;@ zEvLC@F)OHyFV_2SyqB-+9Uj|N_V=4%nVZZupmnl$b;IZ~EG^Z|-ODn>kG&XVvc@zu z(Hm23VE(T{Jysf?S1e^-D)OMMo$LMEo&hl!p)LuK>EE|ppO{_iw29t|r+QcwtNaTN z5-H9C4~h%AKJU}-cOXNQ{_O$!HByYzfU~Qu_3t}|Zci7a(!m@`vwkUUa@`GERE?~% zq9Vdm&SSdkmYFkRIy)yuFGOs7H;;(dcnlB$-56G@5FmADh1Cxxx;adA6((Zdip(#u zQ}2u3kjI;Hyg|Qhqho77lb27u;)mCkG7Ubf(Zz;bV9=82je~cLi0^qJQPEIMN>vau z&w61Jr^&Ea>pi$(z=^K}4^RJ?_20Cr=bNZ0(=y@f30|9b_R>#jKakJ8*H>KsK0KtzKl(xz>ZTTx%M+dFHhe&;Nx4oyFnA4B-Zs;Ur6 zBZ5x>r5@Bn!R01J+HHxCx??Y%%~us{Xf2qdM>c0c@x%Q7)_4s)iv(q)gM-^22GHrFfR=@l5R=r)0(rGx zd8~xqWMBU=R!TZN*g5`m;;ZyFqXY|Hq;_ZQs7ELGg9_U0>)QMpvxRnt&%|l-Rca}0 zbGEEs#2k`EkS84po=>3#eb;rZ z7>CF>+-Nh{yH#_FA;2{Rcd35CNyI?ku{2sSdM8ci)itJF%FnOeT8En=MKq{oK&|XH2BWR}^cW zL$4bA*-LUn^WK3*gQwxMTJUARR-zf8kIVQty0A!}zH}bbtl88pMmv5d@aru{?*u8| z#(q@<^)iXxt(!E>ncrjiTB&~}l`2*={L|LV*KEQzyaO8YR7i*!=U}$|*%-G0&?&7s zLL9*`8n4x-smKZj8(EKgzQ9TD0B!#CY~|9#DNl`3NtVlT7qc+J$h3rL4@+t-pNL zKU7osO`2D65N`)KQPVF^+r(-D1z#Z!kb?yEUuPgd-zBRheF=}a1 ztUnjJ#^3+4us?TDIm4uS{WV7wh0+#F#nFMBIS+r&8;Pq`D{mP$!NKJ*jmz=AdUfVFggMujv+7<2LL*r zQ`SPBC%m%Bc*23)H>bX&dW@hAknj~&d7JdG33xAzbB%vq3>uMlRQSoNvcndKw&3S6 zaOvVu9luP8-5rzgbO>y3YVk*^JZey(NHfEDMa%?R|DtCcW=`=RA7q#rLKuU#d4HL7aI9Q#H8P-bFWbY@7+?xt*~)_wVS*U}ij+O@Ro%QlSZ zWmlD2nycC>zX><~&YFf!7gA9g-85U$tU_N|l`PN4e9kt2o)MoHtubu)UVQ;`-J`Bz zXp+bWRuDO=L&)zy33Lck+a!KG#S$m@Pn28t4+JRiwjYPg#34W;@N6Aty}R^t1o?d5 z1_F|}W~MqEGKIVLt|VD? zh1}!xXG`e^UT_2Goxj^U0AQDO?Bgcgg&WZ-hkAryzQFndh=Zh0c!Ia);xhXXzO$zp9#3YRrjS$nvwql2u$E^8nV zRwxO%^dSGRXVtiExlTk|Q~Cg_W~M(yA{6oGK1S}!;$oilPX&HYfyI4z!O;0j{6C&* z;kham`@&zsvMCjkMH1rzQ}%kgKTt}cHU1gP)y{m)BIj4;&pSUXp{>ee8@z`5E@${Z zeI)`ckM>-X-XQU4-lk>@iU^W~w*d9yy6 zVFr-*3i=Lz+8Gqs;=hl1#Cuh)8i=I5AO(BK(n))e`(nel9TEeo?6B`8oYl}88XlwW zt@n@ofO9S_=>f*Bt#ZF?I{oCnpfeh__DM2icSss%1}-=pkK=;#&~4=7L!5kUi1vF) zk!h=L>9MZ4dq=zGHsL=_bB_tk@3YAfIpGIgA(xB#yU!N3TOikCIn*Ke&J8}i$9;H} zBlYSaw>rqJce$sLyGTqdeVm^73#E_be};1$S_D_~f$m$)_MP-Oal}8-Y~K=avO^h& z`hR56c+`I<50WbnNF39UNhGQpGQ$#84Vm3>gvpG-5$3xNi9-cqC)fB}v{s*?=bSHU z$aG2U-jFFu^r_F(lb+~a|DEC$g`18sN4h!MJVB3(tLP=Sq@{{~t*2C^{21#t;`u6W zJhE+_yF|@DqtapUcAU=PZI|cBWLKyF7XYWa=CXSKm4U|IjzMkXIy}PFDXy}+DoGXJ z^07L+Dcsn?mKS2qMxwnOx+`4mu+#N^_v@VZ>aQuZh-tuhv|42zKGCU**{;AFPs0iS zf}wKp%sFo}19JKmH0wmX?6G(P1b*k^X0z_Ls7R|5`VT4iIH1tuf0X<4TyBSUxdX7? z`qOf`9oywzu5ZU$?qb&?}o!@4qEwX?LF zdQ-%t%}mrBsB2PbWYlor%@Nv#>=Al1kzdZC4tRn_}AO8=-fL>b_ z*ywcWZqHoq-$I(b=giY2wgWZ?Z`*i6^nDwi0dnEr>_6Spjms~AH(sxSz3vKa3!k&& z#%uhV3ON6D1-;wRh2kn%T*J zfJY|}v<}+^4BO?UHgxTK9ME6k{cmmh`ywm{c0X4XR@mQ8L4T(mPJao%xMK>f%8#Z7 z`Nw)p)ggQ#3Ajd_I&bpO{P12=l$O8#Zb76$C zo8cDlCHOdXT!4?pvbm&y633Zjc@aL$k zuUmEVEM|z~THaE+I8?ZcFWp)yS$=YORd_Y+i(G1kW6S1I-VLTgfxp==`KVgJpSEP> zlq_|uuI-Fbs6(osQ9||n&JGYf%Mgr&OtN=;U%$^jdE9md&0=~(2#^ykN$yLn{@Dj9 zo9IvSc3SF}hF6DId8-iumcCmW@3s^-QVK;?D0jYPo?%HNFz8q}0>YykfgiooC5f(8L$CTq7=ElC%|o6yy80$>YU1Klp}4 z!2G-CJ9ixMec4)Q={myt8FcQCL$>eSFG$;A=i2w@P0Tg_SN!+OgZNPYJc#!hv;l~n zcL3t&g98x%^ZHbP{~-o%c<%Fs_%975L1pnHM@W7W{-2o${vSOAEa%AeKMX>C@zo&A z+HMd^)k9hg`7iFB@8ME9t9f)N^Jr#CQcgGiUe+nGrX9|sg7sOYKRqBoK@QCA=`dKY zg8eE>RUj|PpIlt&l|npVdKOoDL}IMrVIfccABVz~{;YDr`Yi?6bFPd(PnnvzZKSO{ zaf)1R87q*wOw^+OACAuDPZ8b zpFUvV4)E|Qad7xJJX|&An7G4cqkS*dJwr@fqK?jCyM>>Z>0;R4@#Q=Ym4ItZK99Gv z`{nU=s-e*Ewuk>$WYz$0Z2|W0GilcKAvdGwNPDKX-Td$Tf1m$7^I$);XCCbPtOvRI zFR4%yF>Yuy?**m@RRF@g}7E+o+_h!2! z!GC%qzB?!ct~!M{mBn&s;JopAudmh#Lp!f?>MOE{&nl{Y&)7F?} zfho8PwysIubK2!~K9IIjM`rCzyS^lCJnAM9aSuLc8~Pu1L^CPHgoF^+Ga5EUt29CR zn?{1kVEj%Gl>)`&Ayq6crG9qz{BV7_haT5dt_U~XA^c21+?GzJ>5XfztdgblHoL-B zk;fkG)F)KAJluG)rcGoxZ+RsAfPPCwenVnB<&beI60_4V1V}KnfQjQ?$YJ7GjDi6s z{yjLDkD33PwX3Vwzn@ysF?P=s`+r3&en#!8l?qxR{jjF5XAR3n{?xJ6jDv9oBhHr9 zxduMLFcviMYZ`Dhpt5(PteK>tH;p2{n*5>~2{$!ImbHJ|zxhT6o? zU-vdbY8_wr&(!1y^4}v$9YHqDWCUW~CgR+iQwv6XV^gU|&A|};%b>%c!cZOJ+#DN6 zh9gIZYyHt1ddtrS0;J1Nc4*(_?^orz{5Xa)1uTJ*?mqw?FH?_RGSIqQlJ4W3h5!8a zq*X+^xZVy${5)+zN|QsO&X7{8@b&0!d20GYU!x{gM{HG8=ocf;qg&$K9w3{?n9v{u zXR1IE1F%5|uYXQx%f+ftL`Oix6k*hFa#mkh_@c35;hcGlygCLJzIqT_vft*{FLfZl zepLZzuzn#}@e(Xv>lwDmg~HXByXJvUTR+6P!c7w(H9wBPT%{mc6J;|ylq7MI4veCC zt_?!TQ{}w_D+xE!Z)K`)sT0v|(Bm76&=+rFCg1dqAY%yRN2!@D8L}Q5Gh1pc$^T7f zl)bH-;erWK#YD*^`Q>4{^)bN4e;%W%=Cj-mo2o+ecWU8Qvs13WTl{VIxK5%>H-8#p zGn`sG>*IJd-ppig8u!C?9eXqsbZkDH9A@{V2pFfNQ@KBateAy)gfpf;3C4adsn{v} zID)a`2(1*JV+y0W4b<7ydV!9BfIr+HjI6*>!VntESMJ|L)nKyePnNeb{X2eJ=cb;b zC!&jq;xvrnI@vW9BeMK+(bJa`g;3Dyn01A}XqedbKdYL5FY2fn`Fru&M2{MeOxqmr z!Qv4b5K&Dwvfu}itZBdZVcd@Es&1|IV?b%&q$Zf`tw0KVSpy3$|9W}HoxNV`Py6=| zXcWz7rWfC2Bi#TdmO3Jv-pa&om{s0^`vsK##rM5gxYqfe;#%w9wO_zr)2nRJ z;}k2UbTo6iLcb5y{W_%+y?^@yMHQ(r)AU{H(7XAmNgenHeniP{L&479i1nFipoXqT zPKlYi*CpVC=wD14TNd=@K;vyuz5p;)jZlipVd9x-DNEdzUrRO>Y4sb z<3Zf&AnP+^2-jAh^s6qbBB=1yd{*D|60(pB`0#o@Y>iJ^cs@$Elc+zJ_sc~c-#Msh zo~x<2`SQ|Cf;xWSG_ycX z5Z$QtVp!*E0(iLohj^)74WN&jFCWT);fm^y?E~wo+!~&DDASwKzSu0Phd#`YhV5<_!k=FF;*wVje(VZujKCNr7W5__%DYmC>P_Bu(g!+7muugB- z(`$IbTbJ2s6VOdOV+3vYPkdrguvxpXN0n)KJ)A+F{ZB z)CmfR%hlfIYR`9vTx57VK44pZ=YxyYT~&qPE=ye@$e_#=ARW;Wb}U6wD`_!DvoyOF>wcP#2|lNdM9 zpF)2OI}Fyab=Vbq>&x9G`KKbI0uT<^$9(gDYcr6T&hf!76vX%By6?H2P$(Z?L?8?- zv1|O-wTDP?Y_6{I5{cb&=@C(UyY$*SWRXrTPIj*2d*9O8zlMPNWnqsDN^HcC}on4p%nDzQdK>0>| z*~rALxut{~D047ye?;BrgXQum=$Ljj9>I=`J6#-~1r3O+q^369; zB96zIasYn}iA#|E)^e9;`Z&kOl_&-#wpMTTnale{LdrU4cer;hl(VQbebM*+zVn{trQuHuPg2J`TR z9`@m(mv|n|Aw3S!Lr)$i>p@Y6FX2J;2i-2Aehbzu`yu@d&-ptK>TBrnpsxsh8%WbU z-Wj9gCZ4mCdopEooTogfr)6*8d_u+0?*wTND(zmEwkb%vQ)%-^TMUjdYH!`ppQ9I< z{e#yuuX5^N@4tTW>ipL!smT`OV8J9%nBd_z0q3fFha9;SLtY7z>2rlJ4j6*d9)smZBgQjsTu6@0WB z(B|}V0La{y`@F^@=+>nD?Q??F(FyISHM{)tt+K@9+`yIT+VDfiaMNip^J;f{#R38m zvi@{q{o#q3``Ao%;}5gM#@8w+PdC~T<7dB~T`@-!p$POpE{x{;xj#+={$)ex=k27s zv3;46@VLgwto-TgRJ`F?kyVHb-|`g8_4%jafkA+Sf3S98yyMwvm${h1mAW#0%9njW4O&qm(+9B_%#9l&_&p3wHG zVxe*POESU-W66FZ$WAD`vZj{y9Lk4ZDU?%_kbXOLL8^OJpg5pK92ePm)IDwez`x+% z|3+>aX~+`w<;X1#Yw$B{#&r%)LEp~}#KA5!W;?9{o!(^ag0%xaXTg#`cL*K$ko$Wx zcrN_abNj!El)sF>V}jq4`PJWa{?04-JCQJGukfDcZzj*v_|xx|@V4(s>(28){=Rsm zLujW*-Cv>nV(WoUYfcskdBuIulLvk^3LY|?^G;aaE$?+=g%U6MMcf{AEKOs{$+@dP zvh}z>Gd>X`p6gnX!#_&5s6iD!^n zkia#sOdv?faKi`{xvOlt-s_(etlO(b^YUWPg8ozuY||f1;<*kD&su+$tZCby2QqE? z^CsN`#@`!zu>Sn1Z$W?lBBFGMwetNb3i?w|LG|Ypwa~Ud3x~V@NR!aEKN^poIzQX+ z(R6^764K@qQ^DVYB*w)(TKtlGMJw#cx2?`y?BxC$pR4&o>6ans_{b&V1qrDo_6Rb6 zrp$%Pl&=Vt`Yk&d3u(GZiKzpNFnTS}ts7IB5SJN4MdT%xU${{xD@5;B)jB^l-f*;c zh50Xs8*j8)1=v{}<4BDeM>*Wdh@T&PFwK3y9gvENks5P@(wiT!B{2uhFb7TJ&m{_T zug_4eu@;EmzmlD~136_VU{Z4r5dP=+NheW&UBh%uI6i(=A45_X@5Wd?uU6&rP-@Vu z@uw>F;T$H*$hpbNulJvbsbd6mNJS=Aka zuUuVU6K>o`qw6)Omn?a}lf{#*K?4K*ha1CW*KpQA@4;GVeAC%1NU5V!i0v{o=9#SH zovW%+>yHR^V@8w5l`fod9XOr_#GLhgyXLoA)vkEx|dpHyA zPQFY{?!*G+zaCJ9rxLZdS(Z8Pfp!1m;PZ>E4I*9#Eu0a&|JBxVJhb#~MD|9hkYFQL zD&D{>)?k@lCO2G1g8pt{ z_Wy3fh3F)MfjT-ZjJ6r~$v`Xt1bb8sP6MRGbK;4}<9>ZlGok`z zMytbBsK~vZR2W;VCS_2lPz^)%RIdL@0cai{sByulwgBcV0jT`x{_kHFV%B?GvXSXx zjbA6q>VN3fv1=&7sc0>Nj}fLoc>0`A91?IqMGN=1kdUlc+>+tvH zuiT)b<#!)ut_k;Sw0>||A`AOjAoz3%^PB?9-N-SG*8Fn^=Ds*uq&34UqT~TJUaX`_ z_VqQ7&Gf4-(Ig;`oSt#7y2O7E%a6gAA#^A28+pe;lb{xX&=qGMh*q@VL=HlYnYyd2 zg?D@+*kWE#(atl^kzf!nDOf#U?N^$kI$OFhXM)Y4RKl2=fq>U?jfJ*`(cv2xhwz&- zsS*c&tO~5BA4q`;w^#?7cHveiF!c?=0Q`;YGBOck4$yol$y=4Ygk(W(?E(2|2ZGgL zi6lIgttXlvOcI9MEb&Aq(KxU}@q+{B<|$K?>Rv~rA_?4l7exZ zlD2UaQ5h5antGa$vU}{Qpc5&J=Mcy7p7|y!rB_Ca`r-N}!7!ANhaL1#ZV>rnUoxIc zy!IBpSKI?p)9;L-81ZH!ANp$aaW$I0O}HeG;g!*f!xNW5-&>WCJ7c2rZPAJmI(!ve zAD894)`&3g4J{pr;mWbvcKt&j2QhPh24$c|Rr zY4EUHMPG5VRsOHg9I!mams|ac8>n`2hG>%)HE;-7y5y$zS9fat5&>aUk zYhT9dcv!sh+bc=EX#x4!$dI6!{_*A;l+yegedp9|L+zNenmKd1XX&l_*!tz6QtG!V zcT<(0t-7-&kgSS*JyXIgb`V;?s{wz`kZ>XtVM#SI}|N9DPXO7AanxnFV=FH`P z+>N`^-DZ1fw(NN27p?fJj8}dxd|74O1MJF(Ew?dY5L-J z`1)M<3ab30t5W#N?P$gx48C?}Z|@l6Z}Vu$KhSGIPvrQ@>(!arovkR#AdL2UL52l@ z9V?+=vsN-kC_xQ|Un3Rn23NrB+8ckzN2t{NN7-{ReEZhaHdvBp*Hgsijt*rlA=g=> z3n_<#0k!uWfU!r4(p!79`WLjeS5x~dK~6-q8t+B{%DqVOS{uD;q9#vBAp;n&AHl4S}}M0?3UffVP1t2b+GG zB;{OV7+<*zu{K+9-w;L<|5E_}X49VfyfA)FiQy~e)fuIE-&WTyP*1q%ZSb=Ao$<=8 zS8NAib;kwjA`6Fq*duc>IA=k z(n) zH3zQqH!}Q!PFR-UKHuQpuMOPKNzQm18(Mo>sIHyssP*M|!_rRS_5QzH2>#dNwO#=k zH;*oAFe)Yvi;;>Wkv3mbkEW#>Px$2r-s^Ou`YOT2UoQcTOodjxL<1alQ>bO-kH{YsH>%Y~~Fnh4KY+n@5 zb=P#wuIdqbhgsG#Sj(foi|tLWDh%)DCPRKPqZ82+f>333T?Bt|pWdZ82~J0e&6j60 zP;Ub2>_qPy4#}k=ha>Cwz1Rww&rejcQ0>i)fJD!2&LY|`;_F!DhHEODHeQRA+AP|x z8oX>$ZA-l4OaA6ztPu_RWKe^?7}Q`>!n2pE<|WF>>{8RbSjj{}t7=}XBzY{4$FTeXU?2CbLPyM zGiP=Rr{lqi`NPSw$vvM1x?^rdDmT!U@No0k~vOUL#f9_$d{6wYOUG-|!YmLF1*?z2vwF08H#2ckPeaa;>lW z3TmwStXqWmP-0dmay2zzv5*T?I&dc^ z_?_L5xfc5&&xXwYrg@qY13xCgdXpF@H5!2udQPomf^;eg=V9~9|ae<;1}4=O#My(fQDiu{%hR*Ev+CuBO< zzw}lYXh5w;;H zIA4&gq_Nt-9>jfs>PsVk;WItW?XmCmH zT%aWwG&ndj8yF+T8L??u4WM(`TXkBfFBM<-EXdFsd?96EVigWbdXuR5t#`j6sZ#1?CGovwe zxEYN%>W5AoBB=pOt4Xq1cumS-=4Z!bnK^gb&30ohy>B1*ztj86!=U$VP}$OZ=K*P& zGr#=*MBenP|6h?;LQb+veU}a_C*X93yuahQ7kN`8>_^_YH5u|APwN;1C+G+AY6AMt zE<;A`Fb>I5TP6pcJo^)UXZ4amJl;56Hp?bMh z@TnT!@C9MtnXlPeDWFP5cq()rhk;TK)X>0iz!@PUPl@%<`{w;m+!93q9rd3_}j*U%~QEYH2!G?rw6Y z50H*`tAIxuw#e_q_e!*(&Ha^76G2!QCY$wHqTa;jzFgizoCK2i(zUwaTa;rz0YxqF z%$foz8TM_A5JTWs#xF7!FidWj4?y=W8SxehG7|b6Y0a3V-GyaZ_1$aU>~f)}Kz6Y4 zp!$u!vklN|<{YPRTv16z(#>HgN1auIJ7JgeUdVaan+j0mw=(W(Dj!y8_So2@{eatS ztkQiH?|J0W336n7ja?f?BpW?%TD)S$jz?FjX&j= z`56OjKArSRwF{&9qt9r?9llex-1Wc@VXt}-wq3uZOPX5j`NSS>Q^+Vs7A9s(ShUn2 zG{1jMs-&-|kTP$IT!3Z?yjT*snQJz!bks#z0Cr!lzja*$jAp z6M;DN=^tRuG(asM-Y)^~Z=Qne^y0TQnCniY2vvlWHyFo#DMU4r5xj@>E5*p@UAR-F zTcvUF25fB)D5H5qx6-e8r6e7=5Hq}yDudI3FwaJ+#BOd*&mV!)n6wz;1dp|1V?Nv0 z-6y95CFJW7Hgl|I^+k0?*t9BpDzMfoHHlJdGzXx8E;mH_HC9)nRNZ&261e6(2)|n2 zHT+I|-TXnkzjW^=`O8T&Hd5VLCr!5ou)|bTT5^tpO#awlt2KM7vQ+80bS9ZJ8vqLS zNpnUeg7f8(+6}%3{>6l|Xn@mMzMgHGj54iyPBv3`YFb8_hRy(yRID*PL+$CnS=h_v zkG^0M_f7Nc%`b9mPX~@8A=BkVt3{I@cv_~vpFhO(_ZIyi%g(|SU`|Xx28_IPq6lLY zQT@`n#Q{(y{0gtul_BW7(cQcItUbl-FPMJBB+LzR5jGagNiMU;)*!ko*x~s+m|*oY zd9ZiNnZOdioX0z^NLv<-#t1Q2*{dq;K5Ck)WLnCqH!l3ZNyPY2y?NoR)XC^~@xnDI zkg^+?{0;0xv3t?_rccghLs;nHttP)FoOp=i`a6Enm;6nyP{uL!B_9zyq>(L;txCHe z_ANOP<0gJCudqdgv=w?-c9V<=lQ|iBzK9KBo7__>!JbK8Y(D#T>x<r3P@VAB!Q;q)uCwAw>K&hKE6w4bv#r$4_V9cb&!ab3;50?=rl z-T&Gz%O%AHdgpa9gr)H+XQ@hf@W~h!a|y z1=)im~5Y1Ecv*s zNXaItS4a1%4~5l(|KhXzz#k6$Q$6?x0=^Gq@#h)3fvZHzxm4kc2TL0E#|R!nPAmdC z@ZSBSJa+Ke<>snzax(hm*GG)a^kb33YYbQb&`d3hhXIb>J38peA~kZnG=#C>WWm!pT1Q_*Xu7F%tVN;!m^ znv@^*QGVSuCxqD-V`b`XjsEIg={vx`Xf^KIptnv7n3{3t|_c2qdp7>ORpU^W_|FR1$oAo#A5| zR@nIm%g4#xz+MXBg`zCvKL3~gRfaG zh0Sv5H^33T7`q6u1?Md;#<|D%6fw4IBtt4Ee4r6uVFI-;Hu5?h_>QR`2a+U}&tP<2 z%xn}a=E%}DRdSb{8!q1#_7M=`1vmXev(>xoHnBj%dbT>RT6{XXE!Oh$7_^xzdnDRK7ZZx`6wJe z)aM6zecn|A&xP}6&U1`XdGPdF)$@3wP7lCB8dYxpjlyn@kr1+6qYqR>T0 zNkroCen&kGyX5jeJL(ZiUgyzg_cc?)<$LOwn|$1Y$&ULg?(3I}K=Y>?;&fg;G@L)J zNLv%y5HT$1QOo$p0jM{%(lK1FX6240(d(*H!p=a(()o%OWyexK+opN<^oR<^(&XY^ zRb{E%eoasg5KuYYUHFuxa{Dzyy!8hL`RaC!uYr;3-O!q+SJHt$E66pp9&S0h_@tJc zMrb8-vRF**vey-6y(v~$GSVk0v;W8CIiB!J>qa$kF)gJR?x?T zxW8D~5C2a%>cA2k(C$vV83wxaH;ZW|ELPGd8FU%+j@|+OpU~|s|BLC->|AmZCm~_f zJMP}6Q>`@5$S&bGlFJ~1o=gtT*2U5cY8aXJcRh~KGd(v_S6mLugu~aZOT@7GEU^xQ zOeCyXWVG&J-Y*C^8GMM?I-JKg#7dOq5YJi0;}^w)Ry^#)y1^zR66fn-_4jRUe6m7X zMT{At4(kzzGI^*`p~D1yY}OS=5(LzH;2&h*m;ERBLw#E#4vW5B;?=oE(_!JC4%|nq zY43m+E1|$s*K)NNYnz{6YFvko3p-Padi;H~qc8uT7OjXH7xtt7QZ@PUPkkM!*?oKr z`YEU&ZOnHq@!uPj$2!CZll{_xxTy&0TeT*Rn6xTTiI%nBS|?o|hgIh}_i%i^DI(>i zca}`g+F#fk=5tuisNd&=*NiGD%hTdU z?Vqhvo#9$5=xcPkvy#J9N5W}3`^s@SX4$$DT@^|zPycY-S84Y$_CQ(dG{3`QJml1s z1Uazezu~u9nlIT?5l4p{<6lub^4Q?S!~IKVY2of)(-QXI)8aF3I!ml>>kwN#=h@wzE~e; z^U+BtwvpWVrl`wB|yL1Bkx!dqUymL zpg}B}sy7zcTi@x0+!&Dinb9{p+#kPZkz4+6==27yZcnHv|L0cH#s^SuAz5Q>aHy&* zj=1Y^uiLvf9ZEi^zUsQ0Owp5-yUSuw0R}nkn$@dH zf74{%3DfIuJ}sx3&P+9JM)K=RN8O&F1uHHUp@d_mky_8 zKvnnjQEWU%toy}|?rFNe>DvYm&h5zp4ZHQC3D&Sn@?p^+e)#rk6Oi70H5CoK}of?_IbJ2TL;^vf>9h zvt}UPpLf8vJb#DhaJ9*!>t8pyAHS()cDQ>!-pdg`?S1w`^`uWKz^~3<+YU?AlH!gu zF_Jsnl27)g9Y<0y(OMYvJ!{F@o$Bcxf0Ls0=oCEnnDZ2En8!J>x|QmE4IVeO-BNEo zFQKaV%2@ws^7@vpr+MX)>-zy6s($1leioe&apb5SZhfmD9r(+d%>2Qj<>U`rx_+qw z$%HA8GzB8gr=r#jORX|Xt#PKh__v(eGDLlYancC;j7Ni6?=;kwVccMnSTFVGu2+Q| zv^C4>;z;$bg%1-(qD3`|Q1kZem3lO~N5XfVq4Ae0JRZ-}aI)6qdO$tz)V4s+&i*9p zPRoq<^DY#{sGo1-bz3o53+x68ShDs2&LyykXqOoaM*%O^*9-y)jj=`40F2syT3FWu ztLtuvGbvSYSkkn&>keKGIh65z4(Ui{Edy~ow(0D=?jNs)<_1!Sm*IQa3=C8Zst?{m zLibs#&BO+vd%S$2fCYq@%jP=<+@9}ear@Id7PmJ)$`vP0ZAretj}eLop~qE@nY)6% z_0`YEk3@7;0zEd<=zATW>j!6{-6Z0$zP(b<1(8qK}n zTe|D-uW$Fs>*L}_@K&F^r{C$5w}RjAz1t^m8GqmA+nfAtc(YI5n1A%idx*4G_&%H8 zdAu*Vueiud?mwWocwlkypiHj(!I`JxA?C@St07ta*DQN$ zxC(-6!qAYKw!}szR%zB^Z?1ib9?aJFrjpw9RIPI%3$} z6yQRRb0K5TB!ryAY(2B+dXY>JBX+H5be;+VdKA2Gt%E>2>^(tyTr$7AUufAQQh;;BLme&6Yg-!-+~QIZ9_%#mad>y=^iB{>D_G~XL5Y>zR59OIjHVr3l90VVjc3= zUn|Ncm)<4(Im4|kWAQL!zE-F#$U5CSw`U0T2Mg&Xj1jrqV)rju@n_F7aMh?;IZfDA z>%6H04QAgVWRCZkLtoWY?VbXPT?sX?YWe+CA3rSY{KDV?Z3}BEPm1@W$-9Y1EO?>5xm#5CD5%NFrvW>9Wrm4wfJA`aqMZj}D z>^_RC&Etoq&Iv02S-rvD>4EKr%B$#}l&P+s_*yPn$dWnychzbMH zv1xWr@~lvv4DNe2^@8&=FV8Q?6HI(b z;0*rFj~|m*T-GmMy81j1^19xozU!5`kW%!Tzqy7%pE~DC_1x{fvqrqECkly}2QJn- z&*@&C!OGL%<*DzT=R_}07psfa-}Ukw+dIz@UY=)^=SN}H0 zy*g@N6t(?Dy`PnNcipFX_s+i!;QH`*VVJ(3!Jv5CgrDee|3%+wP%{do*lqQaCu%9A z4p#nvIVK-?ns4?-6?ZJ3Ek_*AIPj(?HnwE1tJfT*O%AQCFU(q;dXM*-b2Pk}&h~Hw zLC4%0!PzQjOP-gA^*4W;p23|?AIuR(&?A7S`yKD|BtC1FnWy9mEwSs}``$HCvgS|N zj{0_1Zu}8s5yvCUV)5=y3;#_3OOjRQT{CDoq7f+WIiiMhn_cNC;YB)@nPYx>UG>(5 zt3%Gxoy=IlYWM1L=Q;ml&$M=7WDIl?N(?v2GPZq7V5D0AW9x&hZn4{rQm(=v!*L`w z{;^K`AR>!pN*ygy`$L!uY(TyZEU%!c_txQ6T>V$oc-83Umc<97I+mLL>7@8+Jh_)p zgT;IrO*az{Qvvj^hyJrK)}dLo;`q!*GfCxsw+S|HZV%b{J9FbR+bX)+2zt}AY}^|g z*0xaUlCLuHU98iyYNPvKuo|X&+jExEqv$GiMvniMQOB9T!_G_YOhmY z-|&FC*P1L+Q@^y%x#b(H*ZXf!3>W_zDoS((Vo|fn; z_BZ_#Fv03)Z9E$6`OAz}dP3^jFPnEQzQ96B8V$DV?@V~%)Qm4Z{qUj=OPDo4kaI$F zA5elMT(s&u>)vHG&WXb3WXtWz{{{fz#P%AcKQ+ZhdbsmpR)Z{HSe%T4Bj!9|r>1(= zD=W#Lw$WuR5u;Es+s^fFX@M4!ey6Q1ez=&Hu;VG=8%$_EvQVo}5lU zB_ye4zO6<_JB;W+f12aT55;!mdYJwG6MuR~)jTJDt0DNC-higg5@VBcxq36-zw|j$ z8du#+C0K%5_*ZOP5lqcP$!c?d|Fl+b@e?O(p#xH9=DUYljS*Sa;XZ0ubN)mfiB(j= z4))-ge+{g0bcX$t$rIn<^$lU+5TD;_Mo)2I1 zE<E6*{DJ3p1|L?l-;U zi+d+e@{+?OGu__=TorPjqnLYy_pzLh6LvL!u;_boMqWl992|;r<`ZYeZt`0NV&?`c zU3W2Yh8w2tmMh~CiN#;S#GA+ks8XUU_sy|)$kiA@60wL|* zW#KKmPw?pF9UfA@^4{;-Y$5zq?^!b&X8Tk7eUS&#KBT3YI!YjBVMUiX-na&>mW!dd<`EM|jCcAE`>!Kq14 zO+5VC$=U_D`gHt_mWlR>mdp-7YY4TaG+5no{c(|o7A)qC;O>>$e63zmwB{R6N z-o$U$L>vNaV)rQjQsV+Fvj^g{21eWrZb3l=swhL=|jxBbflr6RQ+*O;)&8m zx)Fk^Pa@89v3~ASG7?O9vuUZndA;Vmr!=~{?&Tlm5G;S#&p)!@{>0}{YJR`2r3MV~ zKd?b{$L-|5kWAf|DZ3Ycr1{5WS8Eb2h52Su#{W}`Wab3zeK$U?g)%SA7Fv)~DDk-* z%yRRkhWBh35T+rp>u+X?>z<(sX7;z*#V9HOW~C7a2i7j`E2DpNabPHQy@@#*m=Ek` z5Z{WR5zOagTHyBx6o>8!I&z6LNd^9*JXd;o{zM)D<5RXx?!QUI1BkxV9EvuMh7~i` zhzjj=nVZ99GphK!Pu?*8PUG*7{Iw7OWeUH8>A<|cef#F~Xa4J>e|>%X7VuNpTV9N` zUfE_gpWL`oinwJo!}IXZXTPLoK(Q1Ih?0u zlNgMV+2Qi%?f#{IMgFqT(Ej06L;(o#JPgkE_DD1Pn>{bbK<&KeXUPs;T0A(z4KrMX70A|2UIbB-+p#<>;QT?b4fwcQ|Po=NN6kL+Xo! zyM2ju{k`qRo3i_z>2=!6jMQtp^LwiBJF2i&6_#C;Q=wCMD6f-}roKVcSO34%SFid8 zeO-MO`_vb1SQlP(#k|;MSN!Peyfc%7DpJ#M-I!UCQ;E^IGy3`d?W<6IY_FQ_)ZXn2 zHmd!-sTre+@e`oAswfS_K{0^7DLSqcE87jX`il|(inl?1r@Vv9F zu6%Qy?`2y*_kf##k{_$?p)XthTjT12a6QGO=jJ>!tl~E7J7z*KMFfT_Gz!(pAVTc=ba&6OQd0Q zxcrp}v|_0w{#X1>Q}~l^>{^-Pmj4?UawN&_e}~uw5BYGsGd=0~59aKTr)K8|eOt|5 zy4@c4HCrK8Ij>t5~+TD;d9~SqniH-;4xU+o}aU@%jrmMyQu%< zA+!HQ0VqGq*sJ7`(?=dM4PEkUOSB#q_TlXQ zV<5_OO|1*VsW86RxD3T1bt}*5?1h_u- z2sBiW%3!jlDAHaduVGrY^ezoy>ggLz){NBo@};+v!jJi&=6!mXNI(NJgQ}-_x!mdT zr{qly^R#?wmb4n<-9H}J;D{fg@mk`pctL}~+v(Y0J}Ib_K2@_(lkHAf!)h*G=j{P? zc)lF&V_RWGlY20^MelmE8Y8P+Z+dl0aJd^-n_-!I{?xyM4~=_jWB=8-ClVXixaaJZ zVn4$X{@S(4L?g{N5Lt}2n>SIacM2?+P3fV5v2WzwUy*p9PG8ajz>v8CP;?%ImqM(c zVfk)$l2(bG87}d$sq$Mw&Zi98Nb5ftw4H3YyJNL@lqaw^Xm^5#8MKild#&3-#Mc&S{ZMWTQUBCkno@>P zz7HD-xGg;K@j)EKaoVEJJN`Rcl2b3&0ju>&HCLM;fc4K$C_vx(6CvSapikE&`CfyX#^3grS`!qiD$rLGbeO@~5Wwv&T z;B@PDdsux$VgFN2rH%YT9FLVa9;5_)5OiMk<9~`^;jFOcx!*F2?->lJ0(>WD6rEXh z@`?T?`HC=%N{p7MWXFODCPPCw?Z!K0^}--DFQt0HG2G--4SFBxeJs<<7!2C;@?*Z_ zwU>v}&qNY!$h!CO64Tnm+kdosgW{h;_$NLf*DiNq>3qYTJ&Oesc=5kJbs4wSX1ydQ zkxutnY4 ztsE}4G3TwNbQR#-rf2MQ_XMT)-7Q}~K6kg=T2V6aLbAo%vyg^PPD`z`M>cvwKM_ot z4$?g3U-qtsjI&XP!0sX;9eDhAG=hw?t)%9j6y-oEobSc@F?-MG%WE4a79(xbYr_qn z%RvXK;P3w5wseJe7X+P+)Jxw%T-_g-nmQHUqtVp#CaJ0koygTF9bq=(UQntEZB(J- zDI|wLt}N-4$KYJI;a>-7|G;PyM8%_gY0!V`TJFi8hb%Z#q@z>B9_F=Fhz96dSUG>}klp?i}P+ZsikJ!Lz4WY^}@mU=lE8;Yfs9su|`cZx@Tm2El zwqrx@xqn9hIJcNEeA>&UmgW|#5KVX8oy%F7gRu`24%kTVDGeE;LsTNUyI;E99HjBR z6mDn_rrXrINc!nWqP;-gvRs0amflzEw4revndawgEe6LGI3Y3x`Oh2RIAIUzG3e*v9&Ddlj4TGB63P!;y zo5Br0DspeYP_3vxoaP9ete9+QG$R>#3Xti16|VkK(bcsf=U&qT!PG_hELPZR;Fz;J zY3D)Y9@5+b|M;il+|62q`?DWTr+sd?fuf6wu6kZ`<7`7yk%l@`6Afw3Y#4r2*!P0_ zXSOMHC%vkF^q;o+Uz4Ui!cA_PCqw%z)yfB*5b}L21rap%!hg$4l<{R{Onj6d-?{uE zy|-mSJYhhf&OCCvHZGp!UMU{TK)IU-dCANbe)AN8qmd4fZFRoqj$y~Pjy&=qX!W`D z5y@L};_I#L2{mR!NH$QGCs4Bbz^XD}qywd@ol_)?TkdOCedvm^IJ0OR3E<2epOHss zGKil3tm5NEsbD_2%hsg>yKo^jIrooeb-?_`XCUvNe;@mPj{TNp$mvgCjkgjG8;|l^ zhf?5t?sUb5Rh9XhHX7VpP>bi|Ui|@bB%B(%>8kPU=Knj$|4-(zmw)L^iM>VsgpNaS zB}g%GH=KbJws6u*EhlDepLAd{O$l?JDq3|o`XASiaDH2dBvMmRJ-0}PRhXcd$eS`Y zkkGz$tbbL1R*E6#nRMU+$~PmV|BW@#(EnczvDSM~0nnk+CNr#I$%`#_Vk@4j*-|&}_|pGTjM7flUsL|c1^4`({D z%}o2a0C5Ic%0^A)@&2ZRd5EOK90*>hn8z>QDol*7b`m(=hL)_b1WQ>|aM=`Nhg`xm zEHvx2XwU4gvpC zsx%eY@}8}1G?j5R#V>VMV#uk+0l&cj5JlwgUsI{_ne&P1b-a(`e8Fzt!kWf2j)_+{ zF3vxmJL*M?&E~7W3U8L^~Y;u-~KL`R3TOxJMaI2i4GiHYA~RphOBy7EcS45aLMlya=aIDz~Ez9&dm|)!8ot#~peZ{RHV|rvn!;{xiqG zZz*jgBiHHOeZF1br2B}hrCIP38w>xtB3c3H(2>^Y01Su z6&R;l!E%ksPs>hfv2Ejgk@1b3!%3nAPkWq;(&=!FX{*<`J?^Pv#XTmpdSSw7mKG;pnft@!AsIh;{!_#4<{jlEs-P-_1r%3*wsC{y23EA5xm!SAE%^qiGm67m&Y=Y>* zpy+hRk1=$KjUe?H60p;neBusR0prTFk=%n}szZ}*bbSqzCzttP^81QEZTN}?1T+bRFADZA!(whTAO(!Xo5JrM2dAdocd-uxU7z& z(UD~TU~*8YGeU9YzroVG7PJ-AKaT1ap@k{Nns+Xt!?TZL?HR(%Cq0mJt;#&l%REP! zFM(i!rj>c(J??kBQxBi#o1AOBoTn&fH95nM&Q?Nl!ZoJ@?dt91(njGfOLsj*8^3W$ zG}WwKXfaz^{HW!ZxFguH0fSr)sTvcnH0R=(J& z)WHctBPt^ZCZN@-Xa2PUU|)$q)p;BvO9du*A714{u&tJ`IL_3fc7+bhYilg#C%@}u zvXisLXspk<4++GhN&^`{)(YHatIU_5LMdmb^o|BXmdr`f?&MUB8GFVl z1V;!A=0Xc;1;}JM!FjI0IO0{fQ+G(1$A|HL zB!vXA!o7iYe0K@wAIxPE0~??GhX}NMLA=lMAK4tQYNe0$q9!l4FiHg!Pb;!Ks1s(#T!o^C*{x+ zGUas>hEn)``4n}f0)uY@Fx>jp-*oj)Uou!uF&*9J<0Z-tD+2O~PRTGESRO$+FRMOc zKk1Q@Jx^vmprf0KDqkF@-iXNe#&eLb=nX@@e$0hhB$ydvKXpIne5w;EP6vLAzq*xr zzqC)xOiBAxpAIaxPbd&^`!t7mfA(oE@el0NeD41-PfjDPOb5<1FWG41)x7qgZ|vdt zYZIFGoQ#v8ISwfydH<81kgP@Nl8oHOA~aR^P&gUi?E0kBBA;pQPR^CNqh42Y{mtha zKIUj{>YVjtT<@O$ZS?@9?5&#p+{-B0J%w`rew%XD>*RNO{d%kbcrh~t{NiUBSrHE- z6=**R0^nAt%2XhThNIzj;v;rXr*5}8&bR3x^a>UMTnA7Yajve>bpYBam){wijt-S! zHXq4Y<@N%$c?Ty+`NTgoTpV?3*Sp(aJBVPAoo+cp1+k?HxlYr)oH`iZ^UoyP$KX-wd(|ChLnfYdX-ugTekPDZ<&v-ec7EGZ+Y6RZ^Cnx|L|z zK1O6MUThO-H z3jx!~^U40FKOa`3N3ts3i2C6OR~`#NV{}D;1-Bp2~BT;5HI6 zEN|mknFU9Sn&cF&U7cNU++|V-G4QbyDKU${_uOg1-?Hw|2^-vFhe^Heds0i+eK5K+ z6=(e!b3@M5Qs=x9geRf=%pD#CYZ9!~#briS(_)#PlLq0gW?p2VEIXU>DrjP|n$jIA zT;h&8#AcX~lVOfBAkb=TmQzOCEX8DrHcTy*Mm0xM=vc57@b^ti&a3wpk(l4T^`5=P({nQ{R)%A8 zGWb_S`b1K}K1~~9N7?;;hLl`T_8c1<=3i077Tt%DBo>4qk+*?JAlckkFf#h92|{85 zv1P&#T!}R9!rq+@ys#AhOxDgZ1NU0-L+Yo}_Lg5Iewpo-8}TBOguh8={=&{V;Y^eQ zrvv*p`q}`aiJ6T=;~&#c@71mTpNtbcyt;Baz0+OC!c&qS#|5AvvFj}g^GzN9hO!wH zuC^%LZ^o`g;UDS;r^8gMFaYlML6WySjRJRDlWEIb1L#3=Djq-c`*?#Nn&KvHfFf;9 z8OW-$cAlrw+z#2h5;^r=X6vm`y{HXW2Uns5G8)g8&1F4t!x9?P+DER9q0h!oWNE+f zSS>4NH{ul|ZSY=Tij$uGpLE);X6MjDB^jO}$C>2lmK^?=z|`G3pLD;`RIrIqMtbNR zGv{Z^82+l!HoXx)(p?chlUHO{BFwoT6I}w?gI~V8g*JM&Bnh5Jkc?LFoB`cK&J+gy z^fKpMlwI^3D;DlVv_Kw_#hpxkq?Eidq7BN7{X@GWja2LI0=C4&D+Y&ibHqgNuHHoF zDBoYnmz59AhBTe-!`?@E-G!ZV_m>Zy?u{nPd^!L$=zu`PD;u{TQ2)-IZMs+?N{oEy zbiZl8eItW5ea8G^6PWKScYiHhz+{&1Dv!uyuj zo2eRyJbU&*yFT*bop9tfVZN2`reK7EMm>7P{qYe}!iJ!j+y+B!=7an0QR?T~r5=vX z^!%p^sSwG1WbpZqFq2gJH?VN82sXZ(A1iIz9xn+tepwsq%fHj(!vO}M4n{H3#k~Vq z-J?P{KoZAiQTpSrN1dMOg(b@mxL5&rs{Jc`+Uv~KiP2{ zD+=Gn^qUrRBVgRg6z;+_FWdpWP-!P9?Yr5u`AR!PX{&=Fig)`6don3P~a=DN2v7g z4eWxh7g-&W_5-EeD2R_ib=Gu5<-W8PTQf(GAKPl&=D9%Cy__5hyY)Ltg`Br>&~(4yNr6_qTvlEt;ZPw{Io)&qxx@pCEIFM{4~m@R)en-HRc~ zK)REUbO>b<23V&%i(aJ4ma8zC6szfv4aZB}f>Q@I6F@?i+mMxsqq) z-OOuOAt0=H7^^H#*z!1J2L|)5FHT3-cGi%dT)JZ{@!M7KS(}z&Rl`J-8Ybkf$@Kdl z$po*Gz7A+GpL+pid-(Lpm&qL_i5w5}OperSpC^ARNKb|L;;tap?ZY=N3ZgqVsypAK z#1AM@%LZRRGS=$2awXLToxiKmM@~vj{44q)I)#PnzIiCssPDVGWUlk{ZPOix*(?l6 zZ*aJO%Vd7Ni>L}hZvYMG`t(bk!4|=Nyo!hp8I9mg1zvl}5bP-$uTNcnkbTcc^C4oX zZ8-dmJg6S3`uwK%0Rw7(W){t{~X~k2BSR&edM3y-<5?9CTB~-2}v!mT-rFwvlQOjyMOe(po4TsGd&} z_omiXKNCC1W?e?sT8yN(lN+nh2r0<_g8^CVXruHkd3pzBjaBVi*wt7&-?X>Xmv_(+ zzPuy(JB_~w__z)dC#Nud&rn^V|y+CGwW^RADq3c_D;pGwR_TX zHrlmBnlSqVTnD(#-<%}LYQQD#4==SEaEUZvY(F7w%Y-3yMgzY5c{)%UFzTpO;1J)e zw(NNY%llXH{*3pO{bDrWsTA}y;Q6D~KaNpL8Dtgo@&>-TJH{|BGzWiX*u!M-cZQsH zw~a4e33j>T=aFYSdECE{&e$v9J-s=bg(2wPV!yz#fp>a;`LX??y@ZZlU%CfS6{$B1 z^4X@wUkXQ$;Woxq!41Y;OPqDqN*Qder5&4X2{zj@Y_|KZk66DH_xNjgi?H|1?rPxY zrv8uJcMpN64L<6wBPHs4Ml1I%Boa6>Rl66nD(6c1k_zs{)rZj77!rIf?nBBk%(po; z$t17!KNc<9D{aF67`uU+lEZ9!-qB`A6M0$A9UX2M$Ru?%1{=*&$+3k@NuT>I zvKhxG?g85;qyMqb$#*;X087@BEW|o3-77-QXBqiQ?9sqgob3m4d#+-guh1&CE2 z!(QDHb)L~N=1uOGnu8J_=Ew2L1yeC$pFRJ36PNKbVNPQu-; zAlVNES2AiTmAQxUJ+qRzN(n<%cY}Wt^ggkN-u}m4rNm4!An}v^-0o4*z0{ya#^C`9 zcnun_2K95FAiI&eFMl2AUC(7e-(*2Y#eNk|x8KBDZ}3z77V=DT#(-9V(d;?9PhZR- zztnp=sFN*C?LTgEFJJ_O6CdQqVM@SIE9HMd`6>R#3QW6#ni!l-M4M<497AR=Oq6$W zp{p;Dt(-EZh@SJ`mgre0CbsFhk--GVWicOkglgQ4BjKff(bN&6)G+@F0viRN3gUC% zwP!0Agic5YCS0wrYYNz%54`&1&Xx-~;P4?@$#8@pa6ti6}Ujey_FmLC2OIdok%qfi zIG$QqNyBBs37JsS=h7hZi?>g3u0jSv0@0Noo5Qp?C98S8KU z&{(p2dz`?Q-Y}KfO$=q@1+T0?9Jynd<-+AVB94nq7Y^i*AG$%{R=Ow^-s%4EJ}o7- zhGDxCqN%}(Z!g!enG{XcFHVL1JiS<3 znL!+YH^hf1GWz_Y6bM3Ea)~s*?$3@;L7PeE7X)-@^OpI8tA}3SUmGr6DOBZN zj=MFpR+gy5cWsG~qf4QkZMDrC7GWWsSybn&jd110uyji#(NYw|U3{l0FP~wqj!eyj zN(=EcObyx?cB-n^#>R!p*9X%Z>Ka-jtvh@QK)#s^Q@6O+t~m%^92msE&A6>nC^=9= zKV#X=k@x3WUfTSqZH2Q(M@3;D+8)&)IO^Uk7aa!|RgxwyI*Ep?ZseZ~AN@6v;iDSy z(Z%eG_k(-<#WM`^B+keqI&g~^0jBVrtGt}}<;Yd(?~DlD;^KwQ{R_(;!#8NOu+GW0 zcgXiB`P?0R&34i~D#>!MgG7;3vfbbiZD7(PUOm)t&wWy>4dc}1eYO4f^50C$Y4)q8 z+fKo@f+R5_wCsalhE#^c$XuJ(Q|{)4c+;w9mGbBqsXmkFUR=dDr~&*di_>)K58XT8IwL zJcmfo`oq4Nco)61#d1f-v(K(%2$_uxpA#%bfMxmr5s%kI%Xiz6`3Mf38Ff!%l&Q1( zTFQl!vq$F8(Dv7nwzMq)fcpTD3h#FJicu+Bs9xkCq<7*_FCJQ+exv*AE&aDIH;5>9 z38xtY7v`e!*DT-1riPRAMiRqrrrm0ia=hMs!)HzppYF+z63Tk)P|g#zEr52BtTv$z5Yn*QuhX!G@i* zha$!sd9H2qyANC9i(LroGl4KSA6Jc9bfQE{rSnDZ`4r=Y>Jr>SNPpsDw`Ch1y(_2Te$u6*o=T!dB$Y|Or;XYBWNdrR^$@bB9`GKa!$OX6Z0g#G z$*hMUUi*9U>*^6@Z{D)N-t%SNybVE-@1inkYj=iH~zke}F{uS?k?OkSIVD`mHKC*!N<9jySk zC)d@!;k2)q_Tk7Hy0lio%AM^>ue=KIo6x| zQ;&-_aM9X^*b#=54Ax`KYr6vy6f>WL;)D zQ!qOB;=42sk-u_p_%$g^rrm4pWcnzttC#RkW-|TG!i==ghyfXA#&Eg+R#$IZ)Uafa zFu4AWC40`{zv~A&t-mf``}}U7u4>Vj>W+o4aT)uD_)sfwJP_5}VrAim7uYR{Q7y5t zp-3BbMx2fA7D97^Sj-WI$%~nvA%zv+9xXHiR#uYTz3a5nnY@y`<{19Auj4je)im)Gps<2w#5+ZpyztH+#zNOB* zk+WBSb&G$j`sh{hL>7!~N9JE-+icSrUZZ#q@AGb%qUU@4KHn?%dAFhIGWk=5Rl+(s zli?RE$<1m|z(wFP`yDYGwD&;e(l?_&ls;(48g+)6u^6pxi8$MW{wXaXrzMy^tBf$1 zgTw7GCv_Pf!2L1lGu8Fti443KANY^(M*d&ndGg;vbNBvMBO;tEe5R;GgNxYI$-(AX zQ=V%!)zljrqRDnN*h8;qMt<^_-YrLl^0QhwYh#v@z2q(W()sl5~mFmhF&3!?Z|ZRTmlZXglTd(z1|f zPmdgw=@A^%(Bi!Am_biOu@5`X1a&-s-l)m;Mzm^t>;&}&)#UWWskt?o{>ao~Izxye z9%f5Rqn~4?bH#uJ_ffxO>wcm8rPbd9S#?8S+YRSEp>9}3Hyq?X827rt9spwp6$yU0 z<>43+p!1rx#QTSu*DCaP>$(tX)MrTYn(nPu(_%c<0Nf4z(G#1}8G6QoQ3seOg7qBE z_y1gTs8MpvdZ8*<9IJ)q#VnU5Y)H+_7ypgXks7f(r@*ry*keZVpO$xf`EZ_X=Y{v#b~0^1{5{grXHWP*V`h%ApE}pVJX87fhURsa@{4O| zeo>-})>8*8Hj4qch1F8k4~kYXPmZ@t04=wM1 zkBCmocif)S@>#2G%cpVdpL1@DIl`RwH=k~BrcGijTA`@-@Knzxj1w&BHU69fj7QE_ zWyaxge=y|Yv^ooB?QG0p{bB_scdbD1jIiwFIa)Q3Yh<6{3B75-3BlC4bH%ielaM-d zCF0}GRTw2xQ?7S+U6s+b=2@0!>oGHU=jIIFQ)3NLXMEUcL*@}~o%->zSr1S%X4y2+ zkS$xyGM$?&jNp8MbAlqmV*k=zq-GcncXTgziOCH&>Vj+kjcZl3>gtksopFX4IqqHgDrbjzwDp-ytC11 z?fQ;--n9IhLFOB2(@7)m!0?jKMUrdZbv6RJOvi~lm{eve3Z`GMh~Ej~7U$n&39`Zx zchK8x8uX#WMbV`&8_e^{Y=;}3d5=E%(OcoTy;Y1Vr0C+hAQSV zM-Mdwqp3pY)iL|Zcp7d-UutFngR;cV0A~6n{{`gNS2AJwD}YJFB08p3^@9?BQ=W%U zDsU1R$&{|Ips$BPIV*eer_E8P&sBf(lj(1R;py~ucM<(x#4Iw+{q4W62`$x1c!;vUnBmpiSjPW{b@g*?Tm-hdI?)^EqW8U5LTpIb8Kv}$Uh zzALFuGK$8UD%Ilj3*@~y+ZfZ3r5eCG84+B0Db;n4)4TctyNlk3=sjuP7w~RE_!<0E`G`^ZSS(B5ZkEs zqf%kUO(055?zJf4p4Gja+AB#DUJAdTs=u7rTI3J9OMa9QI-WuwPQoNLbK7f5X#fE1 zOw(RdZ(flnHSTeD%i|MuL>gY9XMbSuuE59%J zslc5Sg3|77H>x_|+r?rA9UZQtvdQ8srp5Sa)N{F4&&9d*OmQFm;Xd{JL#s(m5|2X* zu6Rl;4s(i#^SZWavKCsCmseSqzRdOeFsX`Y+~?pqXtXj)A;c_y{Zs>vjTNeHXpWIjy}XUyYtcki{LaLUyGx8LQ~ zkM6S8W*44REIJj-ZYHVe)KFDR{NIt}OjBn;l={FF?E1QQd@AfPquI*DPiBfP@ifh8 zwjzn9Pb4>(G^GOhn{I`2nb}Po9yZcvu}Q_ulhOQDGn)Siu}Pl(S3pl`jE^-^$O@RO zis_B%?xFCfkviTWG-}W>NSXL)W(;M9865Ea>k zZnwXXCUd%L3jgHFqb@6ts1(I{e_3=(t}LqW{uwh`0T8lvsaL2glC5i?`&&ku=A}8_ zY@MY|hTpCHIrqN}cS%jj*fZ-ITC61c9H_K!hR&q#FOXPB_p(Ry@3q=__Sxjjef6ud z!`J3$TxRbXjdCUt?b2&G2Tt6zoX?)UdBq);`>DU{{C{VKCylW9|H^(pF#fC&z8?P? zPY*uZLWpt^wez{Ot0Ed(b8#g7wnj)jJLs$b#aRdT+EbJF{t1(CI$oUkq98Uf;>|)Q zbQj8{X`a(m+6c!hM9VUM>E2_AceLP$#20;IC5o{sCdvLN)$o!GL)GM$;F$4`G_=;f}tQCdQQwQVG)X_7ZM5cF4AF+ z^jKXW$~@0~eb@)0RcFLFA!BruBkk3q&L&2Bk1~sq)P(;FQA~@5vhWfncPX=4-ezP* zMwum#$!+wMMaP7yt}BU8T&;Oo;$whtNewRli}uLb+rQs!WEq*&V&~|xvbp=Ivbaac zvs}me5F;h@NIy9f=1-d)t-7wrwgKFYBECr?A}S?Zc>hGylv)W|?yX;$k^ZYl)hXB9 zoJDDrMd|iGOE}z*M0?hKAGN{?hwo`C92%~j%UUmi-m^rde8Rw$tV+?QAXuYKu*CYinrdVP7#SZ@><7nc3{;6R-$ zFt(F7m`*;*>;kKk#fQ*o%KwO>cR|tJ?r$#fdb#_*nGkySXK_z|&N2PjAD;9#&4cs@ z?9)VUpSFI12(MKyHIl5_BewSS4`yoL;=v&q@&-pYMI&D$4`M45U3>Yxn_UOm8mbuVMFBNYrxo4{CV7YW9P-#Nrc(!tnW-LSlwRf)VjTI^gd?q7x*Fdyv4hRY;6q-QOV5 z>HY&1@YH}AXYe>$aW#s)VEiW>2M-DB=(u}XA zr3T)9_|Ls@oEuf6u@4pCSzVf2qN%{_rJt{59pDeF2B7Zdp>vPuTZ- z`Yl~$e^}zW(!AK1#C0Wku_9+$g*)aqu-fDj3iDH@AE#e(az*m$Qct(dP7t|-Gv&wW zyk1{taz!wi&%gVU+Z%;fc%72#yCG8rs0Ez8wE zGWz$)zx0M>jy(`}?>17={l)QvS3JO{=2~u*|DLoqXO?-Y3qD#4R!Q!Ovpt6e)853yp&%MPFxXLHXnY z%Uecv*lEriZ&~|_4j)@@qMvxsB^LH*>2%+zB4>Ye@iPqmv_ zU1u?4S=!~us{_z)(oME^j7w1L^x(>KY{!2856o_1*F6XY$2-4W4YIRH7P99FS?N9* zWJiOn73Bw{PkT*)R*0Zkkepf&X+XWYR-JRG2}FpI8|{=3D(ST6KYqaeIkZ>*tiLz6 ze}3~V3;-A7;2TX{Yr26;E=enE2k@du7b8JLW{Cp@qJns=gR@RVj|G#3W)4% zUGjD#5bYqDp+RznLBtG_zg^ED;fx;lxu&yYWIW&Hb9x&eySDOWzy3Vpw*Szd7!JDb zrBqLE8vB0iB5!;*-e`Id$EVB??>&&s{`DRAh*$>4V&S;oK>jfqG>|{RA0THSdzEVU zBP+~EvtB|y7_F>?B<`-1!6eH=M*=ey-r;V7;WZ+Tg2V@r){B9}>M)VJ?E=F<+LHH} z1vD~?PK|%;7wFiS=*@=r&um?&1GuAVML0r(|MW~u2=R{&<9GWa4cYO1QZN2l_WNA^ zIp0>V4Gg=;VX&8Q%ZHLaDlR5La<$OX8m; zOWtZBIhc5BybN{eb-~2vZQ{+v ztvmXKoaaLWHwW47iq!?pu0h^nYVkF-%zr7^`c^;k`d74gS-O43uc$UTA~`}HLJLQe zlN=KpQGpBF5?rFqMuvYz(&(i?-VJBr8> z8rVXf54eO2@yeQ7VV}UWyD#hGU~(AKlY;n_b5+a`qNOY<&Em|65YBV%%;0>qdonot zSAW=V;ND1b9C9fLEcIv5Y@Xl{7UbHm@e2oW-)KJqa5FCB|4!`b6Ym>LwEDV-la%;; z@uES_+E!Nqy7|0I3hCnVwIN)(Qw2j8+DrIyWsTt%C;!rRkt)&BC!EYT_ZsBp*@vHu zq`-06S^L>m=RMu5U54-B=AdmR4+=KEIX*O?BecxlUDwz# zp372}@y~YW3!0E#2ZoS$?o} zPd`Zg7MIsVeVcU)bN^slpTi)tNi>Px#u=t{#^3KeLzImF z?=my2b_I(ud@)Z*!!r}ZPkx)77(Tm36GM)2cPZaAC%n!FBPKL4m`zn};1tcWXI89k z`}tB+0b8c#hU~3T=RIk7*O@)$ptFm1eP3t0>LpHRtApms7E~g8%)FaY1rv;CnX}&6 z9rXY8SuPFXU`oV?dHN;X@e%I@&Kuo@i~6Om&9DB~!p$mG5?ljEfEb{fTR7vx-3^}_ z-3)I4X=f2EIw;2Wnz3B%+{&Mk#IP}!3a%^xj9X5gFeUMvCc z^7Zv_!xz974rrzAq5xBvJ!H{?u0~PMe>JlRrm|97zi#lSR^U2?i+|*u59Q+2Y>Z;U zsUUCg@!aS>HW2<$5IGi@6Qs~wW7o|`t^O{6Gyy2QCKBVrV*^OJdy#T|+&*V(it8H2 z7h?qWcGI78e~o`bCYa_Y z1rC#$ziGOM$or`MnV6x)qy<;5qKOn91}3ZIx9cvrT19P)SGNC2s=8=+tUOY6(a6{l z!Ie+g{BM_M@<+V<6{aFNRfMa?#SRUwe9GormCZTc%UMaz*cIWbi;9$OtUws+*)R!;vOJ5#F{?wUw(wAG^Q_jkspLe3K>A-FQUxOAacRN-hIVgxQ(d`1;d$wHH3Sx-=gww-8)B8Y5C4HzC^nc4v?8a5 zs6)gNW?>~ibF|EPW-o~7>%rB(FA#zMR@!I)9Jh4^r^k4ey+4}zuTf3Id-RFPse%D! zw1+q{Z?9_=-~COU2ru|W z#0j-%r(`~KDx9~&43^lrB5Dm}N2H%E+OId!xhQLH>vR7pB2IqCMZEf zkf>47xI}{rMl?evIMJYSsbJk`u@;xFqGk{*LU4jQ{WzB5+HV)FweEG72CSM8Bw-T- zMHUyt?Z(uKR9V&ezuxzLW-R&+;h)8_uO;OJvR*5r4TJ-+X7Uy zwg6cjSv=-94~K-XB8s2!uzBZfe+@A0N8!J3b~^lJz#n4I`#-?{F~xUW>cbz;X-b0s z{D&5NE}8)nqeP?rkA}=bl2b$2j!kRCHnOG~@!jFJ5n1sw{%i_*~A1-@rci ze}F$B(8ee6-wFTMA2{^?BA0cST|668eP*`)aLwj>{mL#vr(g)@n@y5-%Xy9 zPgOTn+Eqb6*ADsa)0XinAZ7Il|D3ag&r!hvzI$XZKLoJoY-yr(-B!c^V;ExSVUA1( zk6~z!_|;5`44_xfx_dyzYsW&PHSwc={vtjnkPi-Ylj%->bOpJ+Y0@sv$5wfVpBeA_ zNU$WdazJFL?r12h_Re29$U0*lH^{ulv`&$G<_%!{AVuu3^X_GtT)Fln18SffkK>rq z`q*+h$CYMKyUPrt(w0f*B}6SNDlip81Eu{MlQGNZLAj^?lCCMUPXAYfh?+^e***j1 zLK<`3*TMq=;>>Jpt*qW-0&T30PUF&;hH-q#vE4|D)TKN-$r6tJqj;;b#vUmarLyh_ z%(+boV6PXV60ipj0}VGSD1P)wY?;qa*s*;IEaG*}XRRbxMs!9AgZkiwSMV(Y(8z|f zhYuBJe;Cf5Fc)Jq((x0dhLXGv&Kc$3`JRZ3z8z$X#vqrB71Q*io z#$8TgF&;q=!J{bWoZC^qTU2!!EBgTxoXU=s5@7Pi4v_r!bn#|V*Lc?s0vL54@c$w) z`V8isSz{O!cm0g7vP9YTwDZV_{Fh`@bC(WxKZS}%L~Np)XrlIpgW?xvNtqcx2O)K( z`3rKDiXTYYj)BqE=Q{c~u4Ka6@wvCLxg+=Lmi5^?)oBBD0rJd(`j*n*9S2q?xOaS2 za7mAh1cOVqbebMjT=62kosUi~oWlvyd(Ju8Ko{M^#V4aS^ zJ@x-2FNteUgSQuG$m55k@BE+_defJdUMj9v`&b`MNy=65_U-}``Y$Cj#nXL!VZRxe zvqnMBLsqtM7RC{*tVF$99E`S%7g?h4S+=D?*dXk95T3Y`bx~5L`j~VbSF#^TFmNrx zHl49qPpHmcWsPs&&`5Z2#o+;2ZL+M3{zjhH%E*aJ- zo?Jf`ZnQMLVrX|-Z~+65H6+Vg*m~I-T(z!W3N>+{J#d$JO|Y>C|Gm{j1pcL&XDcyx ztRsxcNE6mvn`j2q0}B3mU}1(Ce}y8&Od{GkSWlQByM-jyJ~7Yka(q-}r4Cq`O3=c6 znuPHwDa3#-ihqbmWX&S{$ds)K#jEj0<=i2g41oj3Q;JkGxY>0O@XJJ*%#RbLk)<~c z_!AOKu+dt#;fEct7(8qPneB+A7|pd`2P!NeTKA`e;s%rC>EV=Qdfa5GgCnHqb4s!T zbKpJ{fL?`dEz|+n?-CG%$=8MK|Ndx!xR3~8sbq{69vmLl*-85FD7zEJO8bOx$!gvI zop*BIg2-8HZ0r70;Bbj$t`X_&_HbRuJ}l1(0jHAiD6nKT`>uZeeqHn16^2b!!#YYZ zj~O7J@aGN!XdQnZ-u}0lG)d*8nrc6i`=bMFo=^Be~wA?lAq^SND6k^F(Zh zhG=ESHA-gw#DvU&sg6sza?JeJ|8b5N9Dt$8Af2RY-aG*1$!XT`VZ9W!L2v0eZpvzW z>d7aM4DM)`_ON+(mehvBaCDS&F2~LBM-Z4lCb4#Ns0=3t_{&?)!OPj3>AKUJHy;@6 zBb24~WQFF|iUN>C{{-`*;iCL5EmUBlLMO-FU$VW$nmtQ4+g|cEL?;(yMpy;Vq^I5x z3Eiji;)OpPAQEzS6SO}+iG#q7K0d4SbLXG3)^SrXM+a1 zAd#Qh=z_9c&@~EbbwOL#4CDUeyUEd-yP0p>sBT^6>c7I(Z)UDn@olz)AKs*M%IT`X z3YW^dTG?&Rb!qKhBLV=kjPQ6_`$n6uJAQJKE!=4Kw;5Nb@bJWjv;)!ji*`$(wKw`G z$?bnJ?U%5OaA^-b?TqdoTG!iJYPE~w*xAJjp;V220WAZAG@2+4%vnZ&yjr>4(9?() zn|g`RD+1T$t{PG(pK!R&VG_F{uuduxu6F4U@6o?f)6ZpSh^iI@E^CUt3-}p`H;~la zveABDk*s66*BJE5vw(OGoZt`>(Bdcu*fsdz;=`UIq$3P{W-;@^852vmv*oITxj!k@6Qn~ zFB|oy+GgzR&tB;neE#Rdb6^@g4>R#}rLWD`Tc~|_w!LFv-wU2EY`*UBJmT^So&`2z zCp`P_4bN1U+T7*pu=KtK^<9!*U*N}In-+g=|IYXm{rI!e;$O&7eEN7PaH;(E9PHBW z)t=tD%9s30@{_lx_~gIQw4()+8~r5TIKo!sXK?s^)TK7B*`#j#j_KDOo_d$chi9Hk zyB9nQZNBdCggW85up2xZ(i?z1OZ9$*o%SsJj&=LJwA=3|26au}-u-vC^hcz}C-L>j zbw0jik5hLN)5i;Twr`_-)(F(Ra8jm*?GUez*$=}shD9<;eCwk2dBof4Gc^|o2kHG; zk*b5@&!c!1VCPdw^s1)e@3I= zkT~)7SO6Bweq71GbuG0fO$u+V%u_Y7mH$r7hb6 zHetE042vc6Hr6Yw*7P}jux99YX%MsQdjr#E=)lEkGn2!QgYQIFda&^km+Mh-#l!1O zzso2DG-)q?9$}JVA0x@a`yc{mztG3*UvA}CYrjA+IXcZ3EWKgBz_}w`oX}WAv}wD> z$HsA3SX=E73)$Z)qj#4?VRQRLeV>Kn5VkIAII^bBF>kSNV#V^9RlAP?^L_@2u>1Z@ zpl+(Gao!be7A++AV52aC#a#W?K>~gw1%!tP4!o@xFE%GVzgaazhv0aHf*K&^c?t1yzm3PC}S$v?YJbF zC{Kyvh0T8Cg^H~3IHLMtHzYhr3LgoffoVv1Y#%oSJ{&Iy-ZbO6b*-#PG&4aoGf_*# z$q6 zPefv@)Pcc~x)F@aFGX?_@pA3&r(-jtk%RGeA{0aMdCa)jsiuiRVh^p2&$Rc>aMHn; z4pGBSR-<*Nczx3G0q6WpZHgs~C``l0{rw$2R$X9Og4Xd|%7wY(+h8YgftIn8?Ip`@ zeG10D<;*0Z=ZYa$$NHIE#tl5E2VljgCHAU#U}wdz3`nc^K)>P(s2HOY1SNP`H=sA3 zodSARdfqJs4(P$;MaLOva11kUIqabqsb|OKvG5#+g9Fa;n;Xz>3NeYgh+@nZI=y`7 zEi`PLC^#D`(kf(RW&}@dk*Yl06XZl>Xz{-*8IVeqd1xt zYf0Kjr$;OAh*)4!7>K0tr!iL~XCZDT*0nufSbnmb(N>m#me2yqhmp?%zPV5cyHp56 z%8+;1cT5F}AzcfbWa8e3CJsS&9AbrA^VZ8r7C&GLK;#omF6FaRVO9|FQZ3 ziXXBW&}e~%L(mYEN-!84otBfK%^_4kwpzq6dp0CeqHG{=6s45!oUu@apXSJ8KM4lI ztTf<>va&EU=ghxr9cw-&Fx zC0XF(|E0k0{q3yzE^y^@ij}@Ye#gD2Dr*fB!^jEbBU$w$~9Z*2P?svGDi&OHNyRj)NkOz`I?Z zb@c|~D9D6i}Tn+x_$B{;2xe@7Cvt-$to?^b-?$F*V@t)Mi< zNFh})Mjmzx4=QN*n<}v0^?vsaBK!yvaP3*WK=jrvKy=73^-gvhWX4OX_Zh*N^n0-J zGo_0c&a@T1Y3A1|8}gcvWzYU39q_sJ!@8gOSc!@Ig2&UzngfFii} zt?)3)jfW?jyUtU&mdIpo8X#D-@mF#z{1g9@M0Ve?{t&~;G#t;jX0F@RLR^7@pGeQf zCrI7#i`Hy~BqvH&d6{L|de7V`c7ZrFyO*~r92gK$u((mVXu=i~I zyP^l0ndcK3i`qt!?V`q43Ad1;+$sX%OL})w;9tyF$Ed6`2bmrmoV2{?`=`_mXBL=m z_y{((sWSW>l1o&0+1Z`VYK@AH1im}n?c38j{7#+d2Fo~j~vnU*MBa5jn}(ID(^h+tzb$2$Z?S12+hX(i`^bl%|Xy=&5RH9XC_^( zUgk;*KWs6K!CP%lwGYQvpp6uS(huH&JZWCM%x^;O*QfjX!G_`~#9(4lWbJ{!*0s`F zj!3azPmEO0{ZTzf4wA`Fg1f4{iPOV?kJzGKNEu9qy^@%uSHfnA>}~Bs}>hbWkI`(3th1j+P^h} zqQT9CJaZ+-8aw)iV(jYi>!N;^#E-(B6H5GJPl>BqONV4BzRIkqk?colt`CEk=q7gV z7_&nF-d1aEJIxz#o^jqS@O;b{SDEdPgFm}(q=Dn@M;KPhaCoMC>n$_pdh1l)RF}moDBmwK86n}wV9C0=0TdW1k}qD{ANvHr zEVf?$&q_P%M^5&72FsU7_)<7B?*U9~>_6{h6X#~TqV~i8ZSfFjkSF)VlJak7%&A6R zqdn#cpz&d3-Tix73a;jC3I^_7!fD47_F8I#rh z8@cEz0;$N6c(!EK+h!)9xYG92c#Vj0rhTrM6O+uF<{3Zl=x%x0q?Q;avH1W$^I)gB zaWf`HKfupqNvB3W)1*^DD`=Y^tdZ~jQvClSfB0`OqgXpQ{ir#{um5Mk1=)a{f*rxj z)&GO}{g=#MCniB&ZuZDK2hBa^KV?an$;whW6eE0%b^&^kV@bTDyUq^WK2xJmZjKAT zzxulb7vk05r!$+&5+9-dd^iX7X4-q1|N9I7ot5k2kM!SX`0uOy_pSbWp8tN*e=qdk z%l!8m|GnFP9}Kyu-ZB1rH`hz(_fP%bSNZRG{`&?0y~clk;lFqL@7@e;W4>zq5Mzc=F#r_1{!GolUUjR%u9TY#v(M)+j&c(j;Z@E!v>whdTGCeJP%*_G ztv$8=2^2)1)2n|EFWSUMY^*zT*>QmR2B%)IB(0f?@S12j>pSMGzFCC+w?)K{!}sU~ zd&76bXAZuTyy$A`J~Sh<;KxCf@MA$NZPR;x$jUubY>YcP&2sqc0O(F6ZaKoO`P6A=@+Q``d$2$0TQ? zuKPnpUGhJyNx^P1Aq2Q}RMhT|r|MQIFx36U0Fosp_b=W)-=E(GBRd8f?x)$&_N+j| zzVs1-WMIy3`Cz%xLt&6*Qjxn=Jg{KMY-Y-XKLk^Q$Zt0bB;Gg@^B zGb+AvjWzj${*KVZn4~|K{(`;B+t;nXUHpkIo(1banVoHYhaBkOW%#=Njn4h6ykzZJ z@+8X2i^GasndKabp-~xiL?lij+w0jjmoeX zkfdj~tK+x-9LGQ6xqXxEyE|yx=eIuBbDr5&KUUS9NZzz*v8@%FkrFZwjU^dq4k&*=xX>C^@^NXSbH z$#iea&#Z3`Iq|TX9E-sgho6D2daSrCZ5%$|;!a3$@!QXK^zK|1D-FkinoDisWr=kD zn$kBkQu~kS8`OS(E6r_|{@yP-{yR0UtSKDJ#@|D0WuA}_t7L=Djsa7-iZx=J+(VBP z4V9X6hiXa+G(1Q)7Ud(gIL3A=0}PbL&STp?Qi(<2QO%ap>Slz!`t`(W=`bZZJ$a}m z?F=P#W!;6*Gy7WSCl$$+3`Zgr7VBdQ-xT9$GjYt&RK(HxQ45AuTl3~D^ia`u?5$?E zPh=XY>n#OBt`rD46p-c5zixR%p+ck=bKVc?j%gu0H4e%kd=}yTIOM_tc%+LuB0TBLBComR z^diRn(z;UCv)_)8k1S=6Mhuj(QLan zA980b*)6|I*z(h!HC$l=OeC^Did}QCs{|!a)ai_E^ z)9444bC5y{Zs@(>6l!g+C#Y;``*dClPFBEm`WmILU+@Ljb{e4<@ur2ArLOOSk;Ji) zJxa0oaBh&MU%>qNRUbCIXplrfr~2^Ce^zN3%o}V(n>jQEd#-&tkeba&oIvqj5z8%L8QP}MeW&L?#_!Pt;ut2ol| zsMSbup6-(bqcMv8e-T;C`Da*CGuPas=1Mc@E16eTuRje@N>uQtBKFZ;1IwOJFK8= zzlVn7cNbYm1`rvJ|3*K|(TE^4>AdKy85xl?qrc*R74F!km7h87mIAw%)X4-}X1aA} zS_nJM9BY6C&Ysd4+PGL)6OBWHxA_p589IB< zVDi)zHkR8$EzzeE?qKtu>pfp>6i;*b>MW&Ee64$+{oSY$D`~*5&$ZvlFJkjaUsdZg z1<0D*qQF~TwgwN4RdAp9N||VE)^OBGiL-tfU^lqFqgZAcI0>K zp7V4_WC}uLBnO4<$uix!9;Wws-y5$I`agezfg3+NPqSi`$Bn*d{MVW0e_PSXTgj~> zI-mG!;R4AsH(Y+IU|40I{dcCV>L#jm%t@Ob0+s3}3U4VZn&8Fo5O$}XFDQ;k1xFrr zU}T33l>F+p{oS&mKXQgE!Lj&g;)lq-x)l9Q6aET7NQgu(pXjIOg<{iktPC6;bxb5X z96L4aebs&=@*@4y>Hpc%b?0w;{n-jORJ$+$(Q}dRX!X4h^{ui!8T8t5-&o^qafdsT z*C4s(V4%duex57AA!C~7kEmQ7z-mz7mpO#XwX{xliWJyKg z8#pN_q3acV@A@Rm(oU)~yOCgh@1l6&x>il=%grR6f@P{%Z>oV-8yTsz=?vWVpT9R> z>(`g!Lr4|0x0l&5mtJWJ+@+-gy>f?TI}E8(T0^(7AcBJELA;8atM9b+VwPx{$mVw* zyHo4y#?nItehM#e(u(42LNOmLVWxe3I7!? zmzWX`^p>*x02dulNqNgmB#&uW)&>N4a`tFX(AD;*13(Lv^zya_eJ+O|%=Nepsc0fO z6j#t)UWY6lO{SF%Z`Pv1me;9t6#C`)%fdU?m0#sN69aHC>|sL7{eQsB0dUOSKss(@ zsy|4yK#m8e_HV~pz%e(>Gn+6@VQ3siiVtUels2(~Xgb=WTn3_G8!up3m3)+jz2y3+ zN3x~WV*JC~r*2Iyh+ThtR^em9kAJjV{E}|*+qZSi|7a?{$dlQz@TYQgh@Ez7IzB~Lqy2YQEg3r$H_tKX?aeemQX$})k$ZQu^WPScS zCR-L+Gm0zXQ|vV>crjT}PcC*+w`XT^f)aDhcwyjs=DNn=5|7TubfPA9QYcoY3nIhO z7JQ0vU-cR;DN|AL!jHcjz*t^sN|cap3_C3bU-YU^!Q4j8QVVyy=NIFtnuT?Z4i=s# z_CDSjVjb=W?K4;Mz4dF` zoM@^al@a+0(Pmio*79#>9u~iLKybmWfD*6DgadLBZ%sV+pKx+>lR$!~S<|hrnZy+P zZZ&t@!6dI`trbixsVe_w#%&8V!W1~Yzea$(J>5wV?R=av6tVRvC9p<+G)YJl^^N58 z_{Eo8#C32DB=1<&WjL^&b^ZL!Xxq;3+K6>MCm-oF6ITYP!P2Eo zG*e|!?dAVQ0Z6TnDW3ViSB-Zaw?lmyDGpgzr#I~ykg>2r9TLB@xSqEeS_wkqPum{= z_hw(kak+;2xlVAoWdB!XE!v8?FOAk5n%)|XG4oWA@-cz31CBW@ zOsW8>q|!o=SShzKivNf#d)4M(`lL{~2$Aj7O?+03spsf*(I8}B9mN&p}TWX8|PGGBc|^Hu?WJKf{j zsXYobQJVgO7#q<^@%)FB^KNo>lXW%oHHKAFkCSZw3LX~WWVv2hw$dCQ|B+YI@E;cb z&m)EKUmK1O-ERdbXWUQJU>vDoSZeMjb9D4~%MV0Had4-+K+c1d6P4Qa7f@BSr65|K z5ix{ks?H%6%=~ZfAx(VfpH>~1VXAFO^Z3k=AeH}-;>dqoxBSh7oA*fU<*r)^K=Glg z^uj(67Zxdhq6^Lbu}nN(7I?TQi)^L5nDTuB_M@Z!NQR8ML(=@)5P!X2Uo$(5>F}PT zeAiGP&Ygbp2i!w#ulC+g6mI-nosnNgYzQ9iQShh}maaZ9LkPq>v23!1>mynuGShMbclV*LtWJcz||PM`z|~dn_<#o@j0M4;e*7 zL~rItuu{E>>BA-1q$FCxi6u1SaGGI(isV$s&cZKhYjt!< z0jiBzfx9Xt$~kWTlz9`GwaCPkC1ltLk|_kL)KX}o27t7JVK|lh zv+FZor<^gujRJ2sn<^i(ZihhZn%y5%-2CFLYW|qJZR=R->KIo>MxT~6YGTWHmHD-{ zsU)G>y4`S0)`tGt-}}0!%&%*MneJ-pp`@65GjdO-h*a*b3S7ruFL1ekj32WHI9X%Z zv16YfANFJEEhjI+VVyatGeZ)-Z!~3W|3i0uuYrtQo+Ch9wv*DGnfu=iGp!H*#_nzIigWKvXRAqBQ5 zLCCW|apW8OhqJeE@v&2)e#+R4Xhm8kJIA^-tqsv8s*}v@O5rR>PJ%1G8yPUzc&Hx0 z^zK#@0DjKdmL>t7yW9JRABYx5Q$j91Vdt8zyN&;SJ>PVk#TlwlOqd~}c5@dxTl^C#BeyeY%4(_jM)Lqs~32o^3{=niKatsqMnJiXxr9AQ!J_| zCs0;TTGae$UnkA=`M&w{zO6Y?YRKsG!`^s8U~UnfkZ5YdlRVWDYw(0CKkarrNboCD zbIqN$ALyu`{YxFSlyLJXLotc-)&`qEbvZ1D9{};nu0Kop8h>`cRcO>Ebq{tBXuKs& zedm^1d|7#?LBPcGciqJho>rVD@9deMF7K!;nc*`3lTvd|g}1{Y0pW+f@AHEde+nsr zMDvx%ia!nK+JHYQfI0qU#iLR_fkZLFD5%J6KE$S(oyv5!%QV@~RPQn+WhSdy0Tidp z@=wyZ_1FAk-RQZCDOiiIq2Wn)2yfKSnoExwaqI(V*d@I*(iz7tBsiEliAIbY_r zA~JaSt@^%|qWNy&8-Fs-DItI6>Tv|O=05KK?pAyX-#M-Z82?6GVd+*vT6JvAB+KZ~ zfi{0JY{%N>j$wza-LX+lLU*j;e+2_-B%A3K(T}n!d-a`7;obQ~lAk_uw8bcZ?;~J; zVF8!YrS1SLqkZQQ`ju^h@3Y`mth)Cu(Bb0(R~okfWBq(rv+=#KRXZtwQBl)&;NCjaqx1!0D+g{fL&^ zCet@mW?w-ZFTr#9)wulX;m-zlY{t7(&}%DM^p?rSYg5kEP5YL#UEQ1?ENhYw(b;}6 zBhJf9^;QI!=7kcA2s{Ew&G7{)I5X?tNpu7n7SU{UYIUb!5>}3t+o|^q!Rjedmt7s} zSq9VCUYDhP9(mG1tHGuZI@Y-D4ID%$HQBjo0bvV>Z1*1qVHWcY=q{+$YNgKUm3d0$4M6d|IcikpJ;Q_aQn-ElQu24|CQfz zp6gGGD5IDZ6N|!=mO1dHf{odU`$rq`^5<&A(Q3r*LADW^DU(8loAJ?Ob+$s$PNuM5 zGptOJ%u^w%nq(*2y<`dm6eSa$=RC-sjYT*sMk}*dpa|I~7_Z3eI&aenA+OG>2*k5QI@Sa4%f%B>xD$4$d4in5MvO``%)c-L2**z8z=S0Bno>!WuIM;3?B#SoN$}-( z?i;@yLPd-spSli?jg(JXo6sHyo2*#O{CatJT5&GcI~AX$^@Qd>hGVTH>Ng%5Zbw9X+FNXoLDdo6qFRLG7TG)O+kU;U9vzhtXt>aRP0!==EPZ>9`OuVeqlDqg^PaL0h~sQl^Vth=<4 zSrv3&%m0Pb_$O5dJCculimv^PXUqy_lawd&5j2LlJ8aymoB+->PZLl3e(?rvN|*y_ zp^hSTDt2O?fMD9VTg!^r(C?lB5uf)VnfC`G63rMl3tIifY!IdGM`@&8ue8fyon49) z&Shf~Y`lg%7B*n|<`cpDsu^P8p?)h=>~%bt^Nr4I{_Vrud}b{mB8O4J3zVR;)s6Am zljGs->Q%FxDZrHl%SXS{Tg{juwLyNZ;PVF4Ev&S>Rp@ZX5JHdY66i^OaS;_a{;K%d zhv9@QXlB?Mh5V^9z5L;e)m&gU2U1wr8~X0w)TbQ3>&GCd(XF~mSO;5sp1}NqF@gDg zGfLiya2ZMym3=8g%HM#Bu=ji0?`&0L^pn4)1?b``kl78z^wD2`JRk#qhB>E(6RjtQ zj!gvSSf4!6L|%j==*vz2o}lw83KACn>bm-m4F9=>beixFS1J)H!W}`IEEu4E{(ueO;8_dQ65_z8|{iA0UO=OePCU(*X>Ip0sv;t~+EjTn0l zak)9kk9;(h`|BMHw|LL=??}T;zlq2 zO~qEQ8+#I*WH4L!ON#~kW^4=(#e+eS^Lrp3Hwm9EY~h2^`Nn2&vlV5t9fl*dAbYsU zjlxp%z(94x&~qq5#_j#~>Vca`YL3_3)Ty-e9b{qOS4tJ8?qHw4XeZzDmvgC7pve7C zytXpQU#?C9;g*F%d?+f+J{F1x8$~id3dPrG(#_L0)hcs7VrDwsbeX?8_wRk#Zrwo^ zI*eUp;=0>SXMu(ls%zBqqW4HIrp!RYLOv1jusq1WRn^^6sKr#E;bEop@=tw2C`!~F zBd52Bc?0J{^vYhxaI@2q27E_&)Qh&vi^8#2^dXcmhEC{7_Q+T`{r1O&`xl#tvt#IA z`pp@xl6{ltRqnBEP?e{?yjZ$a+zQ)4`H6Aeng|xc-xn6R-VMJPbpxs5DP;-nIj# zlK*qnd$E*-NhLVJNXi06PK?=bV~;1o}+?C4Lz5a4YrwMxnuY(yY1zsAQ$oCTB=M#C|w(9 zXjU~$Xn8)l{c@N?ZghcqKf@B7^RNbj3TV$^YR^IYTIK95fNs0G)i=?kEFab;TkdT8 z@;v+UV;pVFwy#k`A4A_`L3Y8p_w$>UJdg}_<>cPMZ-`f9^Vfd>z(fF$?Bc6SZL5;& z&qogQ>BIWFn`GBwawZ}n24^C(&M|A=htqi9~EzCRi2;Exvy8aU?Nq%v<}df;=++xZPLe-Ugv*ugReSQe}oh!3!!bgSSxjMeH@ zWox|}PDww^y&u8RcCQS9Ysu0HmDhUwB@D*kyJnSW7Lc% z!cN+&sT3EV0q#(@U!5#AS^njz@(=1Pf0!%3z%QTsE|#0+B2R11qeDCS-#kp+IHg#8 zrM5F>4GuQ`5u`y}f7xJ%imP}@FT(6lN!Itx;N*Bs^ba=v)#bS^JSG-2M-|V(+RRgeu{C!x;raul>5Yt>xAXaK&ApOu8!V&?pXqFGiYqlazt%-G9dzLw zDEIq$mWQBNuy5LUmbo4ANVqurz3!|;d-u!D{cLJ<=OdF4M^b#`w)KvWJd-Dg;b=)( z>NfkWSi#UlGb8a^qPN6uiQN7L&AcmkBvw!4kvJ_;8Zp|*&Q56d#pT#+G55}%7dATQ z*UR@$_6O8{F244_@8);m53gup0N;>5p;ZKE+(jv9p#~pmk=hP3V>t_+Vj{6YbanDv zK>GSTBUy))x%zSOSo%to{WVna<`wvnJ)d*LgAY*yUdy7hCTEDY^B+?DMe0~KrN^^y z$iIsaELv|T4&Y&cIC0uDe z`@a;Z^3M@iwWlZL%{`x{p)y|hG-qs>4dy%uXiY53{n=nTzg15BoSRg}PgKSk&jQ>s zO0J+}^J02AUjF6MgtIQLFh8Y~=qnGABg1a|${}p!M6nF^BAE^4qY`It{;DPsRm#-b zW+=s&^^~9`Kc%Jhw4~$5@j|}CUDTH z)?ZitO9Zly@;Bz-jvNaVQmhkeM!EgWqiN{{?>HRp)xR%)VzHQ}=+GxXckiJjKe~Ki zvVY>?k9_p(g_$-mGti4_YE3lxn6bZ*uA@#6uGpw%Nzl*RB-|tz7&94SyYW*xB&s35t}MtH6fMDDY>KnnGt% z=z_!ehT>l|ZCeC+$BpJRlGb>4-$4Yf5Ur?izF+=DEQ1%(ZFP3p&ReZge`2Dgf0V6|Gmpw`g-e{^w0*YykX#wSqgK|}WTw{P?b(~`F{JM0x%9Us)93#q znf}JNZTb}byA<&WAL>+;773-A=(WZ?TpyD%%klU$gwN>Cyuj^p!=Md`QaYno@pnie z*x(1fJ7?#;pPf;iy%f(s-0V>;KVO5nIH~-1By_NAK;j&abl|tRX0ubU9Z080WV}(_uZ_`+B8U9r3pAXsKI_sFUkBeWDjL&~M z8UNy%wD?C;@hevQ`R`7Tzs-;La-V)0lO@>LzI5DX2bn}DDzrDccwzhbRBbP72 z%>!YS-~$#!b@$a%4)`I=h==^>IDSEa_1|9pg0yN#1gPS z$X(!T=CPs6D8ElwbehwBm2l4$=h&q%P2K3tTAOQvPLXJrd=W5+5Weiq>3= z14C6K7s^$wtNQl=i(0k?t1-+@o>hrlUgH%$_awLmlB20uio=@nx9Sek0ioJzk1Z3q ziIobNYDTJ>3L1+%$|{AP=^x9#lI+Brk2S3;U32%Onq@AMGA!4;WR)MeJ8xMY2GHnp!cwYCnsoskZ3XYp;Ch)c~* zt4%e6gJ}`Af{@;3HZmvcloY46m?qb%)??KhuFf~a)GfAsG&u6L{oR{Ry!;6ohGY&p z_45+@(|V}T&kOkJoK#rS@Vh3XpY0mr4^wg-B4QwdnehV94nzdo)g8sM9PtfseO(98 zwdQ{ExNp_=Gl>&!4VI5eS7K3{DX@XGu8V@ijknwKZOvYJxwVZclpP<{BDFDn)mvT`!gu=Q+XQ_g(FDg_3?Hl3g_u-72qZcKYUGacL6au z|9sNd#|?QWkb~87w#;08C{s!njkn``8@K1u@(dwQu(3k?Dqc8j6--d;GYQWSahirE zSzn#YizFfg_J6&J48&Y@mL&jdHgV`etaT}+Em7DA*ig1KCkILth!?&_dh<1_Jj)^| z-)T3E7d=>8t%#|s|kxma=`?y|V8MJ|;{+#==DLXsRO3r0XTLaIJs@uQ3 zweB0QS6LIc#M41(-JDp{n$4o$--Sz8jzP12|NAx3|9xo8f9Zdh{sNaiQ5fkCzqbgj zT4wg5V60Py@rQ&9!~z;=ORPr5BPmDaRv zr&x-Fj2SDP7%9OwUVCFa9H2LXX61T~SQa9VSy=O}OSvS24q2xW{p~)YIDf4IV*Lcd zo;wxDMp!4Xd?o4Q{N71=)U22?fhubni4WD$0I}DhBN?jSwG(g{)Cd==!zF96j|$B1 zb4TC7;rKl`6Uba4q8zClHrR-QN+yB6dSmHMY;l#3f3~Taa7t5Ts zHC*z6kVlmmsGHt`!FnvH+b4+#{0cB*FUgUv#+GI=V&{==?f2=^u3BmxOy2G}Sa}!j zUamp40e2R5+bkYt%3w`JlS(gZFJz>}b7uLMXHRM~4OphRlRW)e6w!hKdTS^OKaTH$a0qd=o0vkeu4k}?0?jL zd_(bxmbq=8WoInsd5h;=p7(h^=4t2oisxINJv^BJ)srWmXJ4NEd4};E%9D|qm7SB@ zqi0^P0{7RuPv8800sqI3yj*;W<}1$YJas>@r=`KNrW&gfgVKNGd>s=%{BkL@@K$@U zQA^?3AJLlA%sgw?wp9c6NcwL%Nz~&~2gYlsCVPCyJ3iC2cR|27nW1YXzf7p+C=siO ziGlg$6%C2Hush!djaSqsPOdwSfy8$M3lonL%?LPkMPU9aP6!>r=bSI6or<@dlbbf@ zRP=u1jvm;HyK*A0$pofHuw;8Mb`pn#CD^c5v*si^qz%>SwpSh3dxmmp+dcrUQ}X-J zo`u>1QY)V2O{2EAX|4P_R-IeTxo_K5=QF7^kGV8!Qfa<6$B-u2__!;00TC*Afwfp@ zzX7aCzZddW%htrdUm2wLt;Q}X(Ok{8MPzG@x4s(BCNh?O`9o-LypoW!;fEGD`;%Z2A|AwEN>&knD*6e& z)spvYKLk?Dqb@&^)hGW%vMRGTOV1@n4jZth)O8KtR*xDUXn2Y#*6e5X1e#mijifr~ ze8{=-5!NpRK@H+FSpG&RP-DhT`m}1!moqO5M!)ZUOV4mz)=dYW5%2pcWg~ACY8f0a z{Avl}z`SkZyQ2TPQtx}^Vw>gtYL0}zYqp<9TrB5l=&$`l0MRLik-_*+XuvA7 z5rzflP5!(HKBad4hIHQhD*Ucle1^U6ZGZc>XcU@5&XK2uTlx}!Xk7)s9ob>rPdNQY z-ybA+9nU2bMOs17vS6O`1SOS7$Xo7Z;^KnpeZ2@sI7o^TPQ^B9akk2=g=^{@M{9NY zcQazv-JSJ99xmTn$I;r8947zzh9;Re&Ane^WB&%0^#l`er@QjBY=!CjU4MT6!QJLO zd+|d=Yy1W;!6fWb4ydN+LW9oSmF3UkxhuX%(M3Hmm`v7qUvP@n^nrsrk0ODFYXyYI zO70Ktc4*FoK15=jAQds01P1-#Nd~k3%c47>hZ^XiwBukdsQr>?=;0g{5HI|2G4yaN zh68v#5Ir0xgUc^x9$B`D`+fQrLlB>W?dl{!gz;kVIV4c=Ye?W%H~_K)alC&0kM+(> zpNY|iIhU&4v9j%D2|2LqQSA-c-f&@Y|lubAWiv9{` zVxu8Sb>|>+3=QJWmVl$uTAOP%`|>O(D)A#?6=K7=1>DQ#+7@+f;=Dnk;U(enZv%Hu zgM)=RjwqOP)3$J=K4sbDBaV(T1lG7d{-wiCbBp7H&wnL&1LlYt-mRKQDdo=MdcEoC zgLl)@vlpu$lRXT_@a2;tLd|m-e(!G3e1$>8(z>DMqO)w1P-^$lIxo2xYQK@acl*`5)1%47X}O_!@)#=C;6z4rKoRq&3Gx7&PdR|Ae`SnXGIWJaXIdwUc9u^nt>1>>&BDIn2St{S5h) zeo?P>EvkW{f{m{U7}igu(J0jY#T~YQ+;M^@z*0Fr0bgLIiUKv2)y8x{ao8fYICiqPhCDoL}TS68)m()*m;yuKI#n;ulOwa_iz1 zmRsLNsAC3`$~NizTiDC_KrG^naCBNhMqQ=Pj|Z8%&rA-@e(;NzE&lD$tnmhXz|iDw zAH3I8dt*QXEI8<8Io5kFSNv#U08jag8;ox7ed}5s0z7r?2paA)S09Cp)rXWOIgrza z;{DsZ4#kT*7Y%!DbsX@$-=$0lM&pvzOjBgESz9f9;$73N=l=1!L(@(4X}tD|Bt?I} z%!-G|XJJQPc2&SCT;sID%shi>VSRb)tRczsacFV5DR?Z%0*ObcT5%u13{NU|?h%0Z8#Po?w7(G7$?$N2|Yn9;;cWWHU?7qoAA&5<=g@ z+rPpfAW7K%+w!M$RbU^NmD8dhMP-8CrtFK5K7q@`6r#gWXgqNLx$}g`mlcfMBCI|HA9}M<4w4RrSH2%(rcp4s6O! z;P`Uwov*o}WOH=%5Guh(S!-^AKKN5>!-+#jKg-mhmbvt|x%A;lOVLLWWrfP$rG(0~ z8eIAd{PbS#BljK%|5?P0Xbaw4)>PkKTEDAT;6A4#i|(3r6ZhBSWIO*LU=RE~Cpc$O zT@SZ*WD%+OB6l}JCh^;I#$?qMc+J-2D7v+X{gqI2i`QJXCiNo?7(ToCUK!t5pU3nt zf0sYVa=-Z~#W$xABc&oFJt0HiIF)!vZvrYTZa6MqDxSdh)%nG2=+`hF;2INkgsnmm zwUX&3D6A+<>_qcDLxT~E+KW?25J7}C1RL*wDVuHV`P+qTM`bvQ28O!vbQUTOYg3o< z%=MRuZe707HeZ~4Z0a_Wlba%`bc(4V5yw~1M{t>ofMw<%zKzz+UaXdOpFUP}x}j;D zOq*Uik*}hsc)V9wyqi&#Wg|0dwXLvUH zC(ad*)z0qZ&H;k`sO^Cfe!X7q4V%04fU5jaBsZTx1@g;cnjuW^{KB3p4*dQD*dFfLm}{zvEzz5;HsTmB?O>9rwN{pT}&ntOhi zn2UtL5_EZB{@R93b+>5Crcbq3g>@iwdE*Vy?|a;IS$NVLY%~u40ZmOj_f9f}v)d9M z)$chp((_fiGeg`5%IC|XJn&k}IBzAJIKs4R=PNlTy z_dNr1BEYB0j~GYg@J+9wxQWy(glhyz;Qr=V-c;5~K$c)`(x6GNlL|Glkb@Qf8q?EO ziakFvBuh5KtA0;W-B0WH98x#7eosl=@%4L-t~;=PPibB6SEX-i{}P=BPz9qa(Dt>q ze~|i_sh_J-KeP0+DfN@(b!+?csh>Ie`7l32f!Fpdq*l(tuQJu>>XSk3PpRjvue8>Z*$A?^I>$0@e{t}x^uS!7&#DO_i(TySRKtV0w6Wj!u>~^4YIc_Bf zG!kukDZ2BR!0o>$FN|(PZc;ONF@%O@FeG}@l{OUQ-weflx$$dr+k+}#{;>Kz*F^RY z%)d-M6nss{)<^u>to9-j1Yc9Xx{#dqelAPbWV_e}vV{xbE@gK6C&@syiNIGOrHuAB z75ds*B$epS^8&X|qiiP6`W(R=M4g%02DI9azmvDyjt2!nJb=|5X#e-+KfZ;7(H}DF zdW0v9-PwWh5C3z+f!D|Gv<9Ogd~H++MI$vpOBwjXyVJO3ULx?@PH}N#&@=%0SO9WWGuvkT&k6i}?9Tc<*F}0Sfcs~(-$V!2?};oZ;KxE~ zRs*4B?LQ}QTQE?-48J6=3rtBC%J>ubcm-Ue7L=+5!?y+civv6fdfU&Y2tl?jP|(9M zW`FpqNR=W+^506iT&48-ze-V`|F=>OR4FacKK}iw*vMNvM*zq?IReNOtMAoXo$ql>E?q73Nx@8$>WRLnn4qYoAfHTw-L@PIx)G7m!f9+ z&g_igyRtLxs%j5*{%BuO2Ll#^eZ=may$|D4%O`K+NDz@SIW~H zt36C(&dq@7RO=jXZ*3sq185xWfR{DB zs5M`k+4?^HWc}AhM#3(hAegQ$I*U}+7%UzxvYTqtUUiEw?e4I~XU#MNp#@nS2alX~ zlad)d!$5%soNZ>VrvFwkri_lE!37sm9tV=nu(hr>y+5EFnF#xWaZE2_D_AUZ&#d*#FJQ@R$m-)xPd{HBJ_qvqaB?S~C`47bf3=}yn z`20tkejtfbgd)f;FG60}uYOkQDVn=k0(as-18*XI6o4M9&4h&zkEpTCT zu%s!ngYfl!#Wyr2bI5P|2yTkpCH{LqwW*@O@Rpmi>dMHlc4~q0CzkWQ`lfG$2)>%9 z?&t3hYzti4oM=&yi}ZF0+B4=X4F*Cx;Vq|HL9?VKd*}4g+8A;zl9IrVYM74I{voyB z@EJWbd$D@S4)lvJ#R+0!RS-ub*@5Bfsp8|QJp<#1Ud6c>ehfXA_l-|)s|g&{5l!@( z+2?g_pW&dkwIfge*|j+}FnkNZe`FgEzK-6HEZYJ{ExsafZ4+m?{~h?OX zcV70=P`DI0=dec*h{42SKdA$;39%sumG2?|>^r$S(M+Bh z4+o>);X{*SHyKrdsuklVeN;_AAbL9^Jj5Dr#F!ke18;3md5rr?TP1Cb>Y~auV zE^VdXYWyY6t`aRf+9gOd@6Ph@aWE`@?)mQx5Jp=d798hkdC5 zGhS_PK&puD$&8$&P4s7nbquo2Hi)Ww}@sX^0zKmXn~A!(eya zLKSmKDITmz0F9oX<6YLC8qOX$5}1VxTx77TiyW;CH zKj}pz4JKBSaMrsl=0`x4j{?JvcgYp~oL*THT~+09%;Z~SuJiL9LO#-;LKjG{>QdY? zP#vTBz?^Q=MFzL;rYjYy3Bera=l)dU&m<-s7BV37B$0i}-wDk-WmY&rvE4f2-xx@! zj~`R+If+^87&*hQ`0@U2_0#@}w9%H#X&ddd(|#>K%^_R*JIhQrZEC*k+#H=IIAfnD zr_5H|qS?(+bUsWZJBdXdSzJ3L10JN)Vr5@4S7P^um-cbq<{Hv$CJi3ztD%Z^mH;C# z4Tx72g}nDe-aFe{D#Uu4rspST&gvcOI}X_1(q-D*-jV}bTW{rX_?Mx;?JaqAL!!I$ zSifg1L{S&0S`yt|04Q6YL{bSk}+D_;U%2dxL9}HHEIO|2UH!3*pw=xMNfOKkO%~n2qci9E*JmLb?d5 zh^oeUi}C#_3xRjp$rEi1Ae$TiwmH;acc7K(*#qxP{e++TGs+0e@6pgycS7fQ4!qVx z4ianp`o&N4Gf0dK%pZ&BwWOgb@(w$c;x85+H@=eaobG36AVXp$qYH!9#LOc_=%Vk_ zEPdPk!A_|5wR!5!7j4s6XxonWA8qgFSVYiu!$sR4SlX5jZlZL7Lq33bql>4dtsUe! zt>Xi8KCzKJn?lp}3ykHSrTJdKikD^bfb0x(N=*UNAzS zNFL$~|r)OQ+?`Su;J$TT8M5jS$i-M1h^R_rv1p{*$XxYu;WdB#=bMSq((bV(zk~_gI z*mJheTFKUN-SK|DBZGn0dXUY}P6xfCjx~QJUv)x0M=oXWC;DY(3^CP{F7VkLj8y70(#P3uJ~h%WUZx3TZ5AU zpE0|^j7HqH27TDyFOBp`R8Hu$m<;9x8|NxrEGrx@ob(udLKnhCk2CkZ1rs_Q1#Vr;Z;v~$DvPCrLkFGR7M3@TQ`*9X03$+r0~^qgMiJ$mLjON4^S2zsj8czQ3QOoIqzxih9Kl((1+pse;Z|{nXwop_51g;hz=+g2$1eC>4T<*d~iY{z7#GFPQeo|{Pq!P(`C43V865$f={`sbIs}X<>)mj4nNToib+9AK*P%nz*_Xv|Udn~)Ud2=>qDO=ea-O2Qys2qtA$C-m-Hx`Ft zzZwD&+ryXpCMrkN#B;ugRSpWqbB+qfPFaMip(Z{6&j^@V*LX|ka=#11ZF~7Ub^BIh z^Mg@)wU@;iQ@(n4P@1fn%liD)hh1~%!58ik{e|KX_UQ=o48 zU)XrR9D4&d^a2g1!7^)Nr5X-Q&b9WSYrjNgO`@{2qZhZq)WnWURMuKE-ixJZ$I8GG zikK2sKV9hqLd+BCCXZrxnm}Y?up8aRzS@qC7w&-n$HTSeveg2@ntN9T-91N~KOquG zt4vU_v25WN@GDMd8z5fz4`R&@HuHnlvoRr0YBHh0TkH;h+D0t|aTx}>iPp+Nd2|c{ z&8IApTPueY=oicD*2-cVF$crPUr88xkcigG;qq8V{MOdWqa-+lV>cG0tmc!vCAl%C zj>_?Zr7&iTha^9~=lvh$$A6;+-`#vs=`dVA)$$foGRS zw**R-Rj)PPGH*2k)7mX8KYRCC6fA4TO!^hCt+~CR%o+%4Jkg)mBoDb*YgH9#UU<*% zSni}=uj>Z9-HGu9o(V3XnvAWXK=aullr7miZYnMxUvy(n2HP7uZsI6c&l>NhJRHA; zy&>4Lj)47dsw+>*e|8204X0l|>gs~XeyN{fsjj?tgNb#_vH9Wnjc~P#Ani?&mFn^e zf9`-vWn>^W26fU&mLDX~e>jMB-=JmAQv>rek=Cvgxt3b@X;;h*yw+ygFsKcAZQj~Y zpEtwtS(#o7=H2)Z%(A$wDr=s-#G*2~IUro3?g+2_0w02FH+viVtPjlZ87$j?K=+bZ zD#z%WO+gu*d$HqDkfc77R#587L)@nK&o)_v1{<4M-b2{E9)i^SVhBNVQYHewVEJGe(%p(dy>K4U$5UEzt{Ko^(C3T_Fk9gdDe4Vw`Z*;%j4R8sJTV1Kn{-m zQMk6R$P8_H8p0>d0rxpvB^5`>xa?(B6skOLav7&o?{>WK7V{|k3om! zMogAD2gUH9zC3srnbW>J{+FlqGn&U2&(4P}pQ_M0eQn0=ev|GkX`3z~9n_TvTg8b~ z?fU!OhF6AUUUT}^R^3u^S0P>BJ z71*iCB1i!fXxQ(D#l3@S)78E8gZnnD+IrXil(N(h30pF3ZrD9%FHM%$)h+6eQ3F>W zm+lUQlxsTQ2%cxFM~y$dq@j7pgDw`T;l&}uyzF(@u|+^;_3?4$B-ZAjo=Ic7lS~uO z_G)5jfokU3y!3p`#nMU-`Vvn3Eh?(<_ax`_BFEDc%uAn% z%U>AcWrC@RzSehkHNW6o;Fq){wspl%XipFZX#CoE<8XaWIvvTXy$c^V9!c1~HrIxZ z3AV49!$Yj&s;!H!0-}a}Q!~Nf$!^iISw0OD zCceBK?WYO*$S*nlGAuFAEn*7cBME;f9m1gWi2i6N_{4q}QGrlJZkucR-e{<-_P74q z;_UsmJ450Vlhy2w{FpyY3^|^AT*ZmwzHK=X<}7u8Yq&A}pKxQb``gW8&5E|ZzIUd< zg(o~dN=%56d-fSwKKU82Wblx+e1WdJqnC8d%DMt|i?ujVg7Z*y9wLm&yvdNMbyf3k zMJ`uTZtPIp-^~bp4>JUvRp%AmHD&49X|Im~)&$SbuLbIPok`SNx&-E2POFGO!BDR% z@AF45EcF_?igfB@NjJ97^;`MZg1y~ZcfiubbV2n+iFvzgxk}XElTbWy6Yo*(ftS9m z&+F;*GOthNaLH6J`i6ggksHHb@7o;Rd9EJNKZMKNEb9GS=uQ~RP`>pxwdM9p59$FueNHVo(?U#ytb-EPc4gP z)mF9YsdZ6}-`cS6F#Pe>d68Sohc>k2>w)W*xp?6E$gO*>kL=%lePr)5JTrm4U+D}v z?uzFf(9e}a4^(w5#S#dPc`by%x|78M&7UXOkLH(W#C-{WnC{kym1L69&52lNB2}hW zXOyt~-b|6DoSB4>Ifv^)`9H${D&B6G@SXF@xeA2sfV=Ao{e>mnj=zvyZqL`9Uv-;N zp{?CR{2jq3Se%sp#NROs~ob+XytV>iu+w(4@NTyz%&j~JI1caohe@5}&S_^cXqKQDA~IY9Tq zszoKsPO%>H9Mpu6{jdb*{x;et;6;28ZQKuI)}^ORoVxzwZCO7ttB+*w z7lis@!8St=-(|D(ZuG(=6v0?;-W=(M5>Q5KShb)LN3if)s0L0d424dwKcL}L2QUZS znNUd#n5quG3a1V}W%WX~eHx4Q9}eLq_g&{LEArZ!r50L=nTb~P2My>m^rt6bYF>N- znleX&9?iI&k%(V_2F3pg8usO>RIGWjTgEJ1)@jv!+RGRM=DkA%+rQyKsQr4d;tbiO zy!w)cC0st6o2}m;Vdx-#gbN$cFlEZujr;dku8G<&;(TVd{kYGyG}8ZfO8>to{a@u4 z-Fa&bMGH~o-6ye-m6}t;;XOZ(H6+>LkQ&~$eO^yT;v<8kEwKvYu?prAvx3fn`Mq3w z-Tp7w2kXDx-f4QipYMG#yk0MA=78Qw<{j*_uk-qx!QE`K#Z;I z{?T&V0`gVh&AYrPj7TU8E~)VB{cp4V*L9=ITr^?a|8$ADjf6`*i9Eb49$ry$2F{be zHrB?r^PUctjuaw&SI^$!w}QKAI@(&BzP-rb+_$!;v*Cs6xN|V>^tx4lUdm>nx=L<1 zp>pjlq{SWxOzVB^s$~DzC~sNS?rV3WYzksAK$3F>cdCX5FL@TL`^nwCfs9|~rNIrY z%}y8}Ez8ZacNzK@uLM`4B0(?q?C~RY~qa_(bfwna4tB5-twK42IM(0&D z+y->2*R$JLAAX{pex_kxSu(bPd^Qs*?Qdo(%FTpYJu(x=r=pz=`wFs|*3$xll1bp6 z^z4$Gqn~Jd!@hjI>g)=E=-J)yLZ0hvaO}w}i=*Y2>06HEm)E~;`Q>;?c*rk%c=tE> zW&C$?`9+%Y2!2^{aL|-NgO(2YtwuE6=aA%#JIQ7;c8@2CMIgCc$2 z$+5qkO|s$LzIw-JFKx?%#8U5V=$*ZEa8)K!n;Fn0!svtJ1v@))J%RR^Brx^~S^X>% zYp+brygqpHZAEuYP2ZANb%QZd8I08S;6b)xfi$;i&YM|;-(R)i&QUCQTKmcTV=`6H z&SC`bm%fp@kv?>ojbm21`~a*N`Eka0CpdfmQvA!IbIP--#B>PCXSj4)T@n7Dq^~vf z1H)Vfzi_b67Ka< zlT#OgM1LO37umm-KTfhOu`*+Bh~#>ML_>2?F!dqgqvdJ`Esf*(`OV|cE2=*=iG4{| zV`#YoupJH0G3kO0N#+H7wu4la)#Kp>cz9iTOI|~>8wb*i?ISY=IFwnF#8-3U9^(j8~+ROlbW}O$349vZoB; zYWx?tXa&+~>|)jkn}@{qKA0V~G#u`$uk;Tv3MtWSn^1_X^63(99y4HDf}b?4T#}UxV)AIMR3EO$8Bdz=)Ll$jwz4bN4yRgjhf^&d7*5F%(Qqna^o+Bs zwrbnL-*wMII95`-{7c4Xcjf)t_08(bsqk@W?D=LQP;>5F#Vr-Dm5ORJC72^IMjjIL zcH#dsah1gX#xY-VW$ioyysuxvK&v@1p3VE^E#dgWYv7RV#~4-=B^ok$iw`J-^K#&x z>6f?6@(Vb;*-gifshtBgQknFj9dWY3e?&4}((;u=!xD}E6B_>m661d}+#HhCGFUoH9*eK>$#Y7U zeVT!{W({)u5uegmFe!Yo(~A*I6!Xit%pG4{gyEI>F~%|4;xb7H6SL)HYflFcWh{tk z`nN2)As%gy7q54#W|u7eSxw3-a?|Wb=^D${3*!Pr+k19v8+uPCf6FLhin$-D)=lK0 zemC>K#_9LljVycfH1?=kQWCjWalk!gzLQwNkP58fxh*bTsP*iD@BHeJ8<$DW?_gKg>6|B@y2uTVp5o;`&#H8=cx1Ka~7S+ zMuVikX@H+qD4oc2`xaa<>W|o?++YVkhLiJ^0Tm??R zRdBCnE(}@)@6l0V+#N2PAKzR%ub0!_-nKu<0!DB#)M;O*27gwOxw$y)_9f>Xz}im{ z>mUV8$FF52?Rb4{uMb<1yCqq(E^a4xKrxKQ; zPHGvmL5DTM^0W^6eUMhC%+@lUd`b3r+p%+yx0ri|hRR^2OPEv|D(k{5ZswH=R0}JI z44k~;Hm~PxBC_lKK9U)duGX3Tcb7bsQ)NzXndAOe--kW)NQ>zqHH)s7nIst5R$^yr ze@TuE2t1gV+n8Ac>I~NZUKG;F?z-^^6JpfY68r_%iZ@4k$N2jaZX`;w1t0!(++L#( zLwL$8JULoWTXcfmkV`Gci|7!-ctx!H4vU0cyX`-EaqIgHM1sXh*zrj<&7@ zzEFQ1kq<>TPB2b> zk5<`%P+yQ)``9T)*4v zVXMU2T0g!CFJ>dGTI3Z6iY>G)@S%f4YJ1brCbnW;*=lIWTD1_Y; z+x8{;7}u~Ivk@=yl>QpL;+90p<-YB$cWu{&qLZ|>2k0nJn<}W3crEB=8p4SYE@H|M zR+R`oSxiI*7WT*D+0c5Ku`Ke4Co&c4BF=poXLCxdx-l4|$Pb9+d?S^Xaz|*mTzD4n){w~;6)l_4KR++|=4w`Wgqiwc z&E9F#0K-AKe(|b{ik9wWCfTrL-es0gjKWZl(###Unfiwf2W6Kj`(duuwhGHXKYwC? ze_mu^AAvXgb3=pWAD!e%&nA|&<)81})6YNJG$6#U@t@Ch57yvlzW=!*PRx&htdA47 z!vq=al0}#Do@96h`l7_$p6AAQyA3Z-t?>^hdY(@}SC}GM+?%NSOWo1T4*br<+7K7+ z?fL>0uwX$q77$Ond{?@L0T}zLlKyG2y_RJrCB|=OPaF|2)1NHD{xi-fHU#uH>w*fF zbhoffo`|+3ikmry472nm6zOWGH?P%vGN9I`;%ngryk{}dg4Fb~)GhQ7pc}rBf<79Z zBG#I3J;H0CdG%lIp0NINHk9P-KZN|i`VrpqhG1;B(Oe%kiYWLhdaPfo%EOda1wAg^ zyVb}hj>gBmszY@nwK%#l_%1sF#Xxu2+3O_EZo0OQ8Itq;5|CvcE#q|tGt=c8*bx?! z8$6Z0oOw*9o-(Znrenai?Bj{?ZyJM_9ZxbtcTBIBz7SiNNie|b3=E+%rgVycjO*`u zhO(#yv{E*}o?sMl#9|@fSq3xvXRQ-F=l3D{Z!%%=AZm)~Thx@(;$K>n=^YG*&kLOG z!3Gglh8hZt!zeLv7%Cnd|0%D*0!HyXW|-;P%GqKjKPt5Yt>&U;;0Dx>80{K#kaSOt z|CUiXiJs>OSrsatWbpy3HWJZwQam|&=d4igz(4;;-%#*KeM5_i5)BwR`et@Fo~M&& zE6}-oUE4CCasIcJrHAS881toBYFd4>N%|&>f0mZ|mA=1tVAIC?j~kj2+r!dym!auF zr=^De5LGodQFVCfu?XTBuVwkmIGko=9|jDAMpFKBYsUBZZ}mKfIQp+!Rh?DQRqxe} za9L5BfQv=%L{{DjGFBGHo}b43@$=pEbR&+})Wlx1!gx+%{I*)3jVnPi{RN~kZpQr) z$z#7bZbTfV`i~Sx*00z48%0V~cYx|ogJ)PqF;NN4z72AIrrjmsmXK>f?^z zh78E@q&@79S$^=;`hv*n^I7G)FwcwBY+HVCV*RMd>htm@%zf;6CKy--l-oUyp6jN) zEx`p$Rer#USzdLjme(R?5>dl?za%z20S@@u{%8rlloriAHNtY#3D>2tWPqY|{( zI2&1coE{*>TZ9|WdgZ5>cg(~eCPG(`;7~kjsrY)gZScfFUF}pTh4~8t=<~YBT{rkt zd~p1n&B5^|Ykf`P5AyR1qHSNc^IaaB7!p-$BIzv#8r0q9;CqS(mcln8is{PV*h&@K zBiL;#UYqo1_9oMX`Jm!8bTehL(;LrdcS{0aX5^DyV%Fl4^+#iYxn}fHZ2CAj|(#PkMLDTj#`NjFVl8ou| zA0i0K?qIW*?am~eOL8N_QY?M!i80A{rdon06F503IQ z_7RT;ip)Nin%cdF3^TwCaDzMpr;q6`o%<{ym6ar ze(=hzkyT%!AqMaaa9$m!^mhl+6-xhZAU#THjkCl2WlHZKNEazRl*aX)=an;f?mC`7 zm}U0TvBG1*V~%JnQcTRF8cj@0lmWmAoXF~}|0G`)(0@5+#lM^r4fQX!UiL5NfghCrVB;ks5;Uu~P=lA5LHj;;pR!zP_=` z_UZVq<{veI**7+FpJp6t(v?%$aAqga5`;To74xXzs29c9+T23Rd`tk<^pPm0uv z{u(ssTo&E$irm-6V?*;)RuQIZH`d^)Y2l8HVOo^l82pGRN5+KyCmD_Uj=j^f->7O- zyVG%F%hBW8m`X@{M=!pX0cF2#M1j?G+Ube@`TxihHK>c5^BRJQa-i7SQ?Qy%m>j`7 zy8Z-CGpNCFc;I0EF|%)cWALE$I-`WW+o~Ch-z!hN3k8-so|(Ntbei14n+lh~Wci4$KmobH# zM?RC6jMTgsdoAw2Kjl>aeg9c?%1_=Z>WR z{`FtMVER1`eP#as-wNBvv@UP_+w8H-`r}eRCk5YlOxUs!FVBs5>%7cM1zzzkkL`z? z9eOrNa2O%u_N{H$UuH;<@CPSSqlaM8i#RUykTDtx>ap0jv;eLeMl`_%ugJm!QZjY6 z+ptW1U&BNcLz=9GvB-OqPm8STLS%%{P>#KKJwrkwELVo5zW#mrH~q{?EY&gx(G~am zCV!!)DO@qjFZ+dI^ThUP{YLAsb!Ys_J#VT^7ol9#aAZNCvL6dJaoT&{EpS|-2I%am-!pnk@Y59d@(VF z@3chfjzilECO&3%zAoe|Sr0Cf@3Jvip%x(h z5gX3z`tuKeVxZ(UcUxo~Mbh4ZVA&&vm(6~bU+_-$e=b?LAJXn;DGmIk;k3Y{*0$;j zzTu4J?q{*bDT(^Tm*5k&9pV)({YL*$%K0$`#PA4j!+KP;Nc4nujNpSzs__pd(}wKY z52(vEx>9V1mQ*d~aAIG5S)z?imO8uDHf_?BN%cMG3l`Ak=QT8UDAb{*m)XCo!Qldy zlFsCCe&kC!ZA^SA3TGsZQMC+bxq(YKZ?k$XFMN061%>W1;RBC_f< z(wLmR=HpK(l~cgvSou{|NQuZwIWS?=Am$H#DK?L+G!en})=ys1_tgg-ZWUyQ|Vu zo=o2rxald&x_{#IVn+53$Xj(}bz9%M%DXcAhn&|~5G8UVQub=scfpGK*x|S-I0cl_ z-r%OMS0=vJ)0LhwBGZ@ex5@PNRvlh8!^Tak+NZtRQfqMRjN9Z4KNW2G7A0p?*zPgL zZsY_$(UFsad3?*po$aQWz`_!o^!Res;cx2O5?sS*!ww%d@J`_22p9nO7+QGqAV!+| zqS+L3ZdJU}i`-|%3vB#mM?06Kl$_%nLLq||Q@SO~y}pf&F1mg1U9al2f2B8XOJ7@K z!HDjBzgKK)ctXvK+StoUT`lk1^Ujy?(rs$sZ}(|px@%4PZl#Y`da+4snWuZW(vO(* zjr=uHQ1QOcT%d8qkAl%lz)8o1l2Ghgw@EAr#YXa36#LGDY^kj6&j3laz(zL`U{|g1O zV$E{Zq}$~cO4$5YeGwCmmoR004WEKf{I}6F3G}zj#X+VVBlk{$sg1K2(}VwE2+XBP zJTG4w>l+lgXEcvVLV`R(4cfplQE|{P2cBF7A}p~D4e^c#KR-o`Uw5M49-KW+aO1o6 z=~A{xa6PmAUTSP2?`+1KUFXBqXl^qxeH+QMNsf z1(>?Q?@X)6tFPo1^_?&E_98mh>&S89ex^FJ@@b!`Lw$Jg*j zS#%Q=C9YCcrMzRnSRPEZ8P#Q3U7GqI6Ban(pO#F0-yFD2`tt}VcgHAV0Mregyr?{q zR^$k`X(Bb^$d%LCL#S2UaNh$OVV=PUUcPy=%)sX0qr9|&Q$H67_VQW)X{F6TmxcNl zw}Ts0DD)$m)dYiYm|4N}DTBi80^?`+ z2#~O#?sTonrbo`FNsf!rVDK92`JvUj(7a_KWKgh^w+-_u4$)X@-YCy`J+-J@Qvq5R z0U{p8CQ_%VD{n=&_0#mQph=ewrJ@0vcGrjYsUNr_?KO3ch<>U*F2+C5)c0r*wBIs&($*x-;CSIt#~&n=ECe zogSBL8=!(uT7VcRX(hP&YL@xps`6sZr)~*0DzF3$3B_rIGqV~}g*ky-^Q-36Z}8?1 zLud;p-q#<=XF1Jy=_>`i+%Y3oW(KF>3!?@_R%)_Jr!0`BW^ytiF3-5#6ar&6J!f|C z<&)72?Ejk;xmU_1o?ejWHns4SU@<&B^2ayg(!G3tKi?;z_yfEX54DmjJ$qS}gBH}G zzNgW@+1A3Q{Cg^wlT&)*&WDZO5Fg3u)>Z79ux0;Odyoep=2|CXMdl5oNu7@Ns&>g# zY*7vAk)vr^&dv9M2z~Z-%=$*x+$6!r51Egff|Ds5=P(h9&+{)GMMUqyO#UFJwd>Qc zk85tFAoq8FI(ks>-cX!fS{Rv_e_&{xJ)rX0lRohMdiy;&&*e}9oAb)+*~M_- zD33F$^zpc^=KrNU53RZ%Wg?IVXW9~S3UO@g{V432eaA)9uwG>xa!uBv;exqZ5-|&` z<}Q#qpR?4~oK1T6b=!{Ie zubJgGoo=)IT3LEcl|#r;kDt3G2>ybQUPlJ;$XWctGWU=%eg1!;_MQp6g&%<2990Dq zi^q}j>gV~@1p{+nUfLblJWWn^fe(B%X?H>H3)`QoWv+CnHLs_-OnYMMPGkqFk$N{h z`^4a+P5DHf%KI&R&=-j#8Q~rtzq-VBV?Ru^-+#7GFMW4zZga#8a!2L97&_;s+~iZK zIY;LA-J6cs-!DU#6Q9A3ybK4u`8|U}(r0Fsy(VwCPYT+EUtO)P8OoiXySjc4v0dLQ zi#+~9Nu)tS>}O6KGAP28-h;Wzfiy!ZySMz*cl#KQnh03tot#%l5Lvm32aa5_kZ~K; z6fdd}nPx+-^hGDip1ix!(8~3p6sEYl!1WiGFv7k4Shwj@ltr?h{45-oF74nanAws) zNK&1?6!F*;{7-v6Hwad>)sKTi%gl!h#_4151$+fut*PDiChG2~zta>>x8wTHH_0;+ zGtCi@hYrI}S5mk2Vd9Z^b9(lt)80eDe$0bg^}HKNK5tj;=4$+QjfThb#arPS)Besh z{g=aBr2FTqat`G!{;r`sUWg&Q+{dLktTa{x@)51}fxg`yU za>?_^^@cn@=O>teVu}N7NS<^XTWSiwUU&Ws;_RYVJbs24ku=r>Idr$+5Bfkvug2FKhbWbC_HuJb%to) z=O^fSk{u{eOoT(<%oovi!8>!i$GIye>1I%Na4&kb2BgtniOL>;;u$0!NK6rgG{4;R1V6}{$w2oX~ zam@m_MjbFQtA#3nQryF3B(qNp9ziysRzL4d%H^Gq4A)+3$nYJ0f&;`z_0pGFGO!|S z+<@#>wXO@-X`2p7V;@*+Hf&Ek<_a(lzW<*FHlK0n4{#Fhs;RpzJ>$^1-{o86OZV{? z!*R_|4~6kj2i-KMfd0Q{`IY=~n_%AyO(&8E0#L8H-^o6v@4F14U2*VLK7Jlgp>T|< zm`7xv)%O%tUZ^_mZ!F_C;dJ!9*rb-jI({_p_`d^>$M-kFJ`WKtNRF26Xvf(P&iF8% z9)T2^BXJh|HU_sTY`Tbmd>Fu5XBP|_1HeuEj^lTb^LPHsv+wi&@#nwu)xI9|_X_{R zQXlx3fBjd60OwKsdoP6Dz+F&KkjKCOWB<$NR<1#&6T*1)gTEb0PF{^~&Io&b*Hjq( z?b-Sf9eeNpkBfDVu(zZuay~yb^oZQj?{hw2zsruWzy6W#MF`LB4;gs4k6yf)9{Jog zNTD3PF<g zOZQ)GJ=7Z1R{a`?JXVT_)dRktvjadTMK+C*MnCVS5b((i{Fr%%!EF^$vD)$hp0>7USV zdE@k{!7ViMcr{hIZPTyh2ZhS~_``S^oU&t~epKTS{ggG%$kT68<<`x}(=J9W~xh1z>{IN1NKOA^rYipJjO$S^5`qFP2et|J` zTgAApvmyTx{h!?rAttEE21%;0r4kHvjAKQ-iO5RLnsBgyk<@wV^5&|JMfn^J^V?FF zma|o5jFa&%xKfw&Fi^QInZA8Aaq6lUjX6JEz=71>>P1H<91P+1;8Yx%yk%E*$(j9K zwduI+-uT^o`>kvjA z5tDE})dz2X!w}d%g~)4h|F#06M8*BfOXB{VvYN>18tf{ec30Qr#kP^GEpVedGW*Kh z*tR$`?Xw9TF)Ci%>}FmVrA+xmP$H=SgGr?wlVCPw3JZ3c`T(d};LMPTU2 zY%WVvC$#GSgvW?)+o#p(gA0+@Y?fI(H?bpu7$WzWDz@?} zv%ysHAve}h+-obSah^jKScYw-4qL^sR6z{~99BnH*L;{@K&l|NwfKM=HQjq0b&|+z z%nyM$v(gstRe>=o{;sR@LtDiZqqF_a^YMm61YulVGnVdVIv&93)Dkk*SFBhkl$>=W zuA2bYxS&aknLm!Aby{=ipSM)@BlHEW#NLV*ABeK{vbyF3H})2F+ZuSA*Nmz^il)sDcw+=S`BAKuypsi|rKD(H(|gUo?GjQf%h{^d}4Y zbwFQe`VIACo6sm9?+BSXgQB%%5j^~xXmU8f`c&t)<(V#k1>{J+*lJVkw zN}WbAK)PyT`e9|@@y;{DPp1PVS?-)f8s>v*#M zsQ%b?__HQzAo^H520!;x4nAu)q>K5=1gD67D@^}Jw;62d3D;Re9rOoao<)r{PG`Kh zw}!jOd2x0;wo#ySB8+!2^X}t3_VcOc&L=A8WH?puIM4Bw^f?r>PgTk;mNYGffw^6$ zjU8!mXH&??^;1@~Wl48#DC1kYk=y#IqABwZ^{WG+m8+$h%tD~c%2labqnAX%=7Em#jv(D{Y%lAsw ztT@c>9OCa3^%o4?xekrNAMtj3C_Ql$*#y5${Am=KzYD^WD3Yd7v5p#NdvvFz9vzIJ z!`-pxt?WTTH@XKYc4NCN#oQGc!;`UV5o;$C=l4v4BeQ<)JQth5Ery^q&d}Bc*ATZj z>%0vc;CdRR!(P$_=zB|tgJ?I%?z7>oCHCxF> zDrt%JxUsj_DcDGeMAm$fT7Fxmp1vKlR{6xT~)Tr3D*gB)?V{1B_r5XFBhD;@4u{~1u6k8ec zrAk%^^VnLU8(V9NGJ9c_IwcECNoNm?u+mbUCSwJa5G2+{Ned}kUriCw27D=pY_^!9 zB8#C|*eGxcxY#=K@ic)JLuiaNh$uE4f=qM-xL{khb(Jmf%Rl8u(g}|7*FariN1qxB zjkC;Z%1#&{67+zIh)UeKxN<_QP0>8|k0&>e@~?X;kd6%m2s=l1AGhrI0MXAwmWK z`Nf90Bt;Ysr46|p?d(E~;4Ull?uuryu=6~O5ehPtp(Qbn8++eS#%0UG(#i?gI$5A8 zi1uNGnpdN!J=#iRmCn000M*$BZxrJuq6plmY<)2W1X&3ija?LgR04kLI9MD63ATBY zy1uQmxhCEC%vGiLZbocRQP*890wk{gpZ`2N?7EP%>Bq+qB!b&MkdIpvO)z{FvsM6Q@Dd(VR){+)?8fz0p#qt4y z(~q$pT9*9#v>B4Wb1fYplGA3W8p5uS(WLAIWB*!YSp81^6mxM9(GxM3kiA%Dbeyw| zegQoIW$D<~(gKjU)o}Qq!+ro%XAgGGZ>8olEz!2RP*CiQ|J^|yJ5|EjktO@Pn55!u z<~t^%4Q3Ikola-_08jcfZg3I%7w;7BS3uF4*n8^V?;CKUh{Uy(qv3dd43qAF-iSq( zu8wps2HJwCZi!+T#*D^=jnJXSxHE4NjPr8W+f-!6UZ2s z_&Y?wiT=8{e`X~#7cGitPVNMcXNuz?O9rTb7QSWpC?BFtS_JcLC0}F40ufXSs3vBH z1{JD*Tu2&!2P&j&X-OsrPnts)2)OM;%HpTFvDO&;xgW5~3wLBbvq5NvyyUcXt__v0gDcjY zngB7F3~Cj1h#E>fR@lcVT2nMDcd_@~*n6P`m{|w zk8{B7Y(*W($7%y6Y@hRfNXHO6_?^*wFY&vX-XWBkZ0-(-xmnKY#1$=KcqY?4H`c9N z9+H+X&W!szp_Q}76}K^lSsPkhi5A`L@1XQJD#ConcG_B`?0pQcyJDS@BD90+ysj=r z@yB6()78%l{nX`BfvMXHVmqY^@c5-|F0QP0=?7Sd?sN8}PEiNWjypS2OwTb9?=}2S zWiv9IS68Z=pfvRDs{Jz){|#&AYc1OBtJgjlJ6Ec|c0P4*gPniZTE_`_i+Szx~j&3%FpQWb)<1d)nNxGm4wJWU+k2 z$hq^|+)G6#&(}uVifk~9*|t>N z|HAxadf_+)#b7ac_q25dA79Rf-9$s*q}xxj6Z7Lpt>m|g-zdLR_&tH&bNT%U zzn|c@g5Rk@0gafM{nY2@YghW2Ut&MejGG#IM@Lq=%w9M2R@5bK*9PPw)&PFQCau26 z7kl~Ouk+GZ6!fk0OTJ`h>8HJ?-?GMO@9VdyaoXX=nW~ET(^Ur+c67C>P{igX;F`&r z7iP_Goay+p!o`AV;bOtG!tm?h#+gG1;9-k$q}P@W*9xW$Yn)l^&kC0criDud)54{K zX~P?5MtoKXC^M>&h@ZCX2>k-$QH?W?_GgucU(GKFj10dX(>U`({;W~qSM$r)W5cf> zZk&0XKWlXO)%@~xO!)Qq#+hTgI^d)nltJ=Htp7iX@@1p!!pcnZTh=)9Sfz^^XMVWx zqT|BF6_#1d3X54-(Z*Oif!`lC^k0zA&%QkLbI9kapM3Ur$mhbhZkd97p7ZvsA0VH1 zT{wIW@_Env!iSL0AMb7$i+motY2OvdXT^YgzD(e3b{71b>n%UCrT*4>ONF1P{J?rk zMRvVqerkGUcD-fX-&t?@!xy#QGXL+aw>-?(zrEfvADmdS`+s4*Wn606{BXTxBF+7) z>n&!@DSyPEL6>;xn<{_Q)C@eqm+rLc&o5kiUAWb<=494dICIKKFTt|Q<)d}lU>BMF z%ZXe2tIBOru+g=4%fSA6E_3FN z;&v}pv(w+Kqsl#+6?dagXpOm`fh^nII=T zaArfXW|3=NA>BSW*5NY=+J@~;7nI@FrN92o)4zNk?zwUgbN$Vk^`$cG1j~;<5 z>$8?t`!Mc8bR!ND)w!{QI4*?YkF0j{1eaY|A{8zw@niwX07&h__%J}ifqVl;caKKb zfZ|5CFb}k%`K$4d-zK11Y1ipsBof`vID~;gl4dd7y4Mic3}DQ{=czf~Fe!sU-{7?L zFee*CH#5WR5({>#X0(f&1?B)idK5%>Wk6!U*so{N17H|bSb|W!TOen5A6I)ku;ozm zuU((zf?u+}s*lwG~bj>EffveP@O_Xsr*E>QL_;HKc9BM>9Dx$~< z=FKojLMjB4YaUxmNG4NPJq$_MZXlY({pVP)i0!F~K4U)3o_-F%JEYygy|ahle%bVnj_Wy$QfvA{az* z{`ZPyH>}8f^S_6%AhuC3p(=(sJLArq{-G!%gpC3*c2K>A&Oqd?F2a*Hau$7FaB*`7 zLYDV0sUj&wIKhBcES{EDw5o{VNOYa;Ly6XkOx_g@M>(DJhqE0plK#yPL!UP1O#=wL zRx`+HVUQ?oK|<}Tw|ETopdKCa)fVucPKrp$T9qsav=radDS|&`$-~5o(*jGj``cDz zo>+B8Wo85G-WhH(ag4096ousZ8_^2_fq9%m2x5$BLR4Y8q>M3^-$J9cjI?_*FEA0g zRUsiW?b3y{gL}4SUcgkas=8k4i&t>-da*%fNL*73wMQGC7)-+7>_#`#IGI?d-@c-y z_0Ez@G8wqDg>mLq~qkb2!fWV&C_02Vj{j@l@Rb*^ZsyXuLBY6Os^4l~1QSQ9ei zMc`w?{mzGsmK1dD^lm)%f`N=VE9ZqQK}yj(FO>Bd8ZlE#)x#l>0Oc{lFRPWPrDW>n zhx;jXoOG`t&=$Y}C;@Z$=g%z%5G_kNyOMrA77vj@Lq8?J{Qbal)dPS&yoL!+0UZta z=K6mzAo$VYFnbUc}O*R>o_qX&a2I)3a5KGC0cIX-2%_`p>f3_M97iW?H%= z&*`j5H`KlHP)6Lf8NlSSz+$}s^E++*^f#m9ej1W$Q*?7|w}5kYv$wqD9CqNPYM)G9 z_2?1tjS}gZPQwckFMa1Lalhm~FFobH1c7GK^{??aR^{3gt|pJ!$Hx#(MukP6B~n? zx76e@qtFHwL=eNhS)LIq629E8eNxEcOCjEFuMcPEvqd28)I8(?BQ%J!YK4UD;}Za_ z&-c<-y%O6{6Xhh!B|mi?oPmvT?kY~zQsDdo14)7JrAPDc{5+Bb2e_9r&;}R&zB-Ia z&q$n`Hhd(N3PB0=6F3Gf;Q1*5K;C1)Nj0(222JQc-NW=odvUZQP9!_fdMch55ipq{ zBA`L*Da&e>f&1|SrT5~_5U_c`zw@CQCx}P4SP_j8>*uPUB6Si`2@-hS30@!sHjuSY z?WbxVsPPNFtj-Ag#xFNrNN^m33mx>2&;bo_py>P5R)aev{pW879XQb9vMHWdY(?7e zy;U)W@w1&1ck<$nC9(v=yasWj6?tV(6nOWTdq86}IUTi=fjqGr)4l8`wLW=Nuv2ldfg zTSRjZiu?Nz9qdW;x(9M~zeR}n1n2i!gly-e&ll7E8wgosYMkMaA0!?E{J38q;)13K zyC{}nDMZ@CGS_++#g*+AYaZwqmMWhLJEq22Yms@tC}FGyxL_~XaUyGxVm&O`HUxBVI5yEQ67smy z3OX1VVZ*@b1E$4!13`Hgc(EzWgr{F2DLxbUM$9GPs4b(5|F+h${SbE|rXM(5SNO2A5~RG}?{`Y(^0qnP9W&4!R=Ikf{I}yong0 z=BRQrmM8>2*Y-5r+?FS+v+AoHkM;aJnX{~aH12bi9vuD#;>U}t%l*p=;#{-i?C`H1 zH7$MSIdP`yYSL32|E|$B4pIHDdT2(voMn*fP&3baehvERrPL+ALE)t46ink28@1_f z9Q-rlsYFTYwz7C?NqIc==~2u@kJh1wRh`5W%pS&7j1bK&Xqs8m@H(`s`3IfF49u^c zqR^3U%~}BF$vThu+I7rytXR{`D|>=FJpXu;odD7N^GBKg%$fgf()99G-}&9fwiUWw zcA_dv<#|n-ZvN;g-}(%5(M4X9W}QEocllRIm3d8?eBSlv(?^mT1S<-mhnn(gl1ex0-)mYK7((&3s&IIA6Zw z#vFKu<-)7;=uJ8X8~h^7;};&dsQ>(|;+}dLt~NNaNW%@=$#=-x zRQ2eFm71?(wn#^V$0_7z)A-)|4{P==p*xUy%f#S8uj!4m$6T$+JadHDYwEoF<^R>B zo|4sG)7YCnF$s$ci&TK2nOT)YMx;nQC0`Q z`x)c|>jT-X-e-NzbWq&?h5C*?|FiAdfV-~XY}N*d(tUV=)&`dIHIXhkyLS9K)&_1~ zIARd7a!g#KEj26>1Zg_gZCY?dt{LQFUccJTFg8xVi~RnKYE}jm+^})_G9@$tJ^fDm z#MXb#@0phsjnnT4AICLL{{q!aZ=Ak_pBatQ7xUvaPXD|=!?P9LZl9>A-ab)L9i{b| ziWY^BRJ4$y7c@@4jh|VK(-#CghJv)h9Axl{{Vz#y%u2&|3e8GGWaV6zBN}=q689Zx zVp?zYu zU+V~-i3F}slNuFmSWi^O(PKSP8B<1jqB2gP>xs&UiLWOrBc`REs7wnBREC$J7gQEL zQP~Llj>?X*PgKSUgs?JBV~3TEv`=hYvg7O%kP*H< ztZa;ZqB1Q#P#FxYPgE8@QQ1fAJ1XM{v%XSU)IL#JrF{ZT4!G(om7UZ$^JFSR(!W zF9g-=vA*}kK)bL|FZMLo13@t-H4<#hJWXWv z(>{$O9%ls$pe%zL(&Svj#U`c?9x%&sri_1Bjj1#KVb+DhgTp_}`c9M}VS=XwtJ)6VexFUjBGoaapUiRB_ix@25( z`~jU~ta@%yX|U=B)=eK)p6=^w{dGY-Y3s+dnUZ{f2RUZ8B{BZFg!4{tkC<}Bq2;_^ zc$_(dw!^x4TY}s4$$87Td2i{ATDkqMunS|TH)Y!SR~JS@kIrlQUhT!lwtxKGd#t~& zO(Ld0cRc+}>iP#?SY-S2?r-;f>?gl@cZ}`NEf1eQw|x6|fZ3 zo{B6yE!QU7|Lf{Y9;Ph(HRtCS-Fjow*Q2E1uRpw6efhDUpY#n4iE&B+ z&(|h@@uCxt|I`ztfakxPR!w;C!MyRLfaiM?)~op7d`h(^|5)Ch6bCB_}pMq!yLid8ewD>l^vMVt(&8fuz*jBPRWA zGgeePKQrlj%vez&78f&D9j`oWR-ji_D!d=u$JB4Uk^#Ubg2Web2XK;==FEmucuh>S z=oY=L+9dLG6HacTAU9DMCb&Mr%d{Wm#X58p(zD6oB)OMbam1Yt zFV>Ezcur?B%HM5_R}v0aM6N#>*promHBia46C3sU1k=@IPDHtrLhnW=V!J#pmvpvz zPK(F#jbI&;EY?A(cx92YXA?tn6T@;7#kq-+Frgn)Nog{Ah&pOxy@rs(bz3&rBz*3> z+{g9-lyx@iOlQ>Ml@TwxiC*AtOp`3jQrPxgymCY?{g28`9G#me z&rOUB6A5{r{oORtCT%yhB%&FMM49*a=~cCV)@nLP=Qdif9Knuw2J|4ql9F3krtm%1|)OqVS=F-<~8?YKSrP?Y}KV7RIBcrWuO?(#4lmQ0TZ*|vn=Lq2fp5qi6t9HO;RYIjr;3AqxmHT_6@`lNH9AI;NYd^AIrQzuIDa}>@QxrvYECStjXGjkJXg$XMvR%IqDu{q*G zt5CoczLG*g79W~*>`%2n0VIiEEM+30lStZ*bKW)B7*(mK*y~1#o$Wk=fdXZCeF)EOv_Eg<>!eK5E%JHX(gf}l_6VA(n3^g$YiA^Yxc@)()OW52k?OE zXbN6gIUN*oX%8c0^oz(9G$yAzpqS#_dWc|BY#COy29*XC8iq{GDdxrv#%iDYh~HcVJ? zIV#D*Fiy}Y1k%14t~Z$P=mtP#v+s~Zbge{l{cB-48@5YMkYzD!% z4T7Jlb#|#n6o$oz#7SWg0x6ysl9U{MYG(XXFYwC_S zwF||dt3E#gl))Ei2j5xO*E)e3Gq|enl*J;s#fxrE#$K>Uu1z{GgiJZ>v#>R&0t8(% zYrYrVJ^=fy8*-jMm-BpM&ht$<&o_t9RxGmJhyEVuz5#sl5=}q<#xYge$Rg46pAvui zPuDt_fej}o9Q3;BD`9pEe=fV7JVMBrPQ$0QvA-lTFBZvsN|>KY_|GJ5PbQr=xS&-i z-I|C!2ZC9A7kJU<1SPCLfc9;P=(Zd*7Un!J%6YEKd9Dwit*B&Coo|ztQ#X0hcH4EJ zde%{GCu%>8K{eZTNrwv{cUW|L$!Y~zJqD^qkaw%cJV%;v*5{MO@~3AlHaOeoB{|Pu zFuRa%($Hn6UW>7cp_5Uqv+hW!Yax~`xHRYa&hXhvg~f&ABsM8rgq4IOWW)PUx?ziU z&wvYetV|ol-9HZTT`#U&Q0ugM;%ey>YYec6tZK&g)<&PPuSO^EO)RR|pO`@~>FoYW zE!Tn(ax1f*n{^KX^trXMLq?+!sFm>wb3}s~PY9UI1~`ff#MYZ?DAL8vq!JPgnpTR8 znwQ5YPebT?&Z|}yjzUmW14p%tp|N_?i*^_sB_pQFjZ!2qU#)Wqpl{cgVO&-XI!AAPHIU%uvN(VGt4pHOmDC+xs!tl*Ity=o&)pCJry< zYyC9h%=7L(RNs9uOY|;3~tf7Sc~;Y&RVY%#%?zm10d%~ zYm5?K+;bVhq_Z9)2s=yTO{5eTDayOU%`o1M@e+AjWBj@f9I2tYj8@J$&aHC^W;z_u z>{Rv69-Bro=vMGZ_qjPyQWMHuDbY=Z{ahDmY%#}A~M=OTRRFCVX0gK$jtY3QxG?Jw`8K2#Nzaz;& z#b7jABQSEudJ@q$vyNowwKK#%V1d^N*8TE!m(vgP4J+YE*?!2g6zHGPz-Q}F zKjh9}m?47c2Snbvgizl18?tdl7o#TYKcJK3akEOTp;t2Ywy_&oCtSG53D0(h9YVoL zM|4IB+i*Q+)pm#qY6J`B< z!LUank;Osm<;lSXgB0I1lHFh#+YEYPg6udRb`TyCmVU9I*Ef2^E(oV#3@&eyL&GLU zLRbl2C8N(;p$f-CS&h!PNQj{P1-_UcZl!O6A^l>(-1o(mW&J&de$jXE1PrTv#2g(M z2IenWXS%SeENSZkfeOOlgzjgo|MD|&PyLmHVnKd8m;ioTxog-pPZCNvWg zE$g+|Cqx7K5O7^)ff(pc7cGOp26Vr%IkE~MAP>;W3oq6q`iSL*Bn219Y8cy)W7o`3 zMRrZ*z;kF}yO*-xtv#^(E<tTWhR`&EVbUWoG76}uXSiA~78Q@Ka7)PW!?2ua7dAbOGFnU-0j(dR{NxvA> zrC_V^r>)zgE|3@-Zyxy>0Nq2rACcT_8dZ~S$}Fv-}<*5MkhF^oK$BgP+0glqhPZpAV&sD|M~X4z&~BuUV0 z<1BRr92C3`Q9Jql<88!JW>GE-d`A@<*GVMOzS)+=4CQOUX-D881~{lxN;_4Kd^> zL2aNAnnMQ_PO{7j2gw%|>&%xZ8xF=cY%?{60}9CpJzyQwYr+A9I7r;nnvfG@27Zi& zcx7z^NDYi97_~E`00T6Uyih7PdcttLA*|7~bPFcjzzeNIzSrk61HAkl(cRcr5dz?a zd6EDJvkmZi3Gl|{4Y?Nx;hl}}&U}Q$;?Sm1gYAJt!>h~rY{n9N94*U`9X?p;Ve~LC zXzviG7qQ+UMzd}mcNCu3_$hx3Lgup6lQm7^keUt`cN zeeWrN-%28Pp>_r)^}TBehA!7_BEvhUD zGZ&l8`z@*mXdqZLkok{lkj%+2^H7ud1j~RMm3jI=<|o6%KYb#^}}2rW?ma+E;X6=S_H3D<|hX-&ki$xQ<;0(1|8-O zl)_*cHz%l_vPG59rrL7BDJr_s6phrJ6;(m*O1)YIB{WtY49IAXGT_nfAD{jSqpgDf z{6YSpw!-D>kJrWrDUTy!udAfZe@vMFf}bn@+<%(?<#TQQpIVzw*Vh-P3O&l0`r8W6 z3X8WDp8nSr+4g>D%Y*Z`4Q+AYgYQigW$R82hDu+i3cuG*jZ{89wmw+RH!m$Wzpe0# zyw`t0=jmMbR@e|GP2)lBRa`~ER`68eFL#Xrl~40ksJ9hf5k7r@2qFFy~wYhv2_Q{Tw? z*GI5zIxlj6YidlPzBGjQUWWMF(!uNH4ut*lx{z0(R9oSTq|`;$s~Ti;2xJ~Y6eX*&2i>~C+f_>WAg^jr$`SE#@n zGea62ILFYSVKQcQH`3eD%zYtu6iARyEae6@-R)Z#4Et6-TgaNJ7b=Y@C@1sApq{(( z`e~BOAZGttXu7`=)_?9d)*91&ux>mCdyjL3!Nyq2W(N&L#$PaIG;6CLmX6?V9*PIk zPUHJt)ayo!&S!W7B3ppyknBUc^kU^1OP(-?XLI~7IfmLC=P1Yfrz!_3eWJeatxHq% z^6g^=1;3g=HTJgV3xVf6%AEnAX|E*s?fC4c$V%Ppr7>x`G^$d^n+EGED8bt7Mhd-` z&qXSiaeZLcB`~-cLq5385nu3}UpJ&}T0xj7P(ofBgzZ;{rj+Q~R`}|gtjPZ{e9HBg z!v3FZd-B{kS-6Esx8OCLJJuvtolXLP7d}14FnC2#GF~4es*{I;;@P76_HtdTof6P<1 zE4b`#C>k<2OS!owdmr{TMG@wRQezhL5Ih7(lgAuXHK{ST@Bi!tTUhmXvhj+t51H@nPjI%r{;11##v2Z7}Y%a5h2RAfGl zaX&TtGD>e&I=IAGw!LoC`?lnVOvx?5)dq{w*~%2Nh4QT&Ow?F;(%-nHAghnBJ=@Z9 zH;oig9`GY8H5Stj+KH(#<*IZ4R}Ks7AOm@~`n|#Pa}5=Ck%pGv1?C`mv3a$YSF83e znI0s8l_E-$NDco!DOgO_+m$qtN-8rB)X}z$E9W{hMiDEYb>#6i(ocZZut~ zyVFDm0|&$I;3NZP>HcP6!I>&{M=Jhblx>*QopE zgMW4Q@(=Wr)jvNx)1d1%-ED9iIr#9=#^iL>Mn8C;jR^5F_%(U_32wFp{lYV8dR6n{ zqN=>es#c*7U1!r{zvtOMR!mUM{?#JrmM61Jgyd^lQV;r?s1nslc=|);=DDflZGSc$!iX3VAnkxDOyz&8QiCPq+?}H-Ja^nex z!LC&9sX!(D0qF#9!x}Fe|1M_ellJxoS13CzYU z`F{*QGyhQd<`aPF7rw<$_YlB-QE3LB$Z>mcooZ<-+{!!s_gi!<_j!p54d*uLWnDQ> ztM!Dx!4F6bsvp)?_^Yr4z#3oL=)3T~p^lGPnas0i>&EBTPp924P(tK7HCV7bB-aVN zp2zFp-n%7Qm;FDKy$O8O#rek{LV$3@jmi;^>Z+(wP@|wG26Yz_*hqj-FFc9$!m1T@ zSD^v{H&M4=7HK`IzqV?vty;Vf48bGZp~xXt#99^4PP!g=1w3H?@6XJ4HyhOc|9@VZ z{eI^=^UO2PJkK-FJoC&94k#`nhY(g;CUe;mZ!Xn5EK?=>X<1hOU0w1=ctwN!Dh@V9 znJV@sIZss#u~neCiidS~vZ%^T|1)3+KVesUBzR_Xo#>I5siVh9d((zt%OwXPEoItp z{G#R;MB#7MxS-gk%zQe-s)~F0;B7EZz#hKiGik%a3@wdm{_NLqY|yUf#$;9&)ZY)P1>UhEEHh-mFl0 z^TJV?ZuoAH-wp1RZEch;gB8Yk?}kw=_V!#e`Eik*`!U5MUeOc|A>poiR0G{prSAEe zx+i3A{qO;>}XU(q$LqM=kY(p8kY!)qK|ZYln< zWqFn)rQsDKiTj%oIT%jA4l~*d(r=_ZWi>7V5jSqkTQhhfFgh+4bCG8r!2PS*@|@iQ~EOw-SAx;zXwvEmltZ-GbK^k*c>Um`n?R zVvhS%L}~9}CX%b1cy|1I$q`w3SY+klLr^evj`5EmN&hV4`}*0|Rpv_7cyDk7qnurT zAeYn`y!L(betD>d;W^6efN3Ia(R+M>%ig!D&3bWBW&M;Np6}*nOF5c^T{4M$Uz3~*)vQjF+OM~!b*F;!+dtH{Kis_4A#lDp zT@qZx9obzdCi#u^M3W8~X)juJ_sbpP%2(UlkOPhH2nttYO7?XBSFJa{m7j5MRDxtNW6JF?|HE)T=NI79Nv=PO+3&5XTdOEqt-3AjO=IL{bpy{-l7U-<;%kH z?dj;zVG0e+7HV{bS}EkN{7jDQYyRG)m{wV*aQLAPZLU{mmW9(Bz0L9MJ7d8t9Bs;? z@@ckmZf73Z$6N#yINTpN%a>*IMqS?8oI3lM<5VZira5|fuDW}f`#Q^LqWMaC-QHlV zQwHeOib#A~abENo_MjDtX^u8a_K7@Jyft~0gc zv)UAbhZa+0k!90wO2ETSt)(dL_hI$z3M*{p080%FWdKIJUJ-HDm_mDVyEg_k)*59K zd7C*HYmX0bnf8mj+o$b^e(nR-xb}X(9$7W26m-eEhDWtL&l?j=Xe)Ow=04npyPIMe zRI6(Q#zb*s75Ww$)lXBwu_fkA_fTjaV^tyCe7TyL9Pq|BFew(`Www1ec;_;#NO_j; zZ<(#Z(5E@qcDF|RM!dQb9m0^GW>Ii#vHA3Rzs3*UL!lXwTjQmEjoSv>#@5 zoe#Rf8=JLJFeGll${b;N$Xv{q)Mb*Mb9S>@20v`kEgeqF!25YEy81bzWiI_nS|-KG z8bw2ezcpD|Oq~Q!P{n**9lch}TxLdGZ7to4$=Z#q40PYd)Z@;gxCx-D^rL=~V<|E* z%3OY_zBkp|YAv^zFTS*@4ZBXb*CzjH?YkQ9oRS*vT4J}}N8>H>P2x?0n;fwJ61mub z7)j2x$YG=PG1KukiIZ=Nc%_&RfyQ4$_i*!kSLU{__sk0?BdzA=R(!Tf265J`F(bi| zgUrLi@DB2}pQY|fOe&PGtTZtx7)i*kOGlYotvCH=sb$ru?$&4+(MWG-YHh&bGM>)d z&)j*fzT#&}x`#sZLEjur761o{)4hA9)9r<-##`B*&oB2!!h&9Y*ee`T=q-V%A$6cJ z2|B(`dt|V$(@-V@PL8Q)O{ux_8qs`g8EIpC!bCT@_Ym*h;m>gM6d;%~sv}o~)K8#& zxcM@r?(I@1k@~t#{iRY1NJaDVNcu~pi$tF>LczDvgPDK6ez`(U88NX;_wX5+6Xkav z&(VIKCZs<@ye)}7o{6_@TCE%uZ4#cZ+V;tj#H zON~ztrj;r<@rJ?K)WJ5@hg1LaOAB|ZN-J9fhI8zWG;np_gt%(f`(G__0*l|ad?P&)+R12O9NA4#vQDj$4wY+HEIHgZ$d$gjkFo6P+K)%Gpa65Bm> zF<~qwbdB8psk3UluY9&1NZxSsP70b)4CG)P8Q0Vi?Ou~OPR-mS5^tE47d?o_UXl0> zlk(_5Z%jR`jk{!$(V7d;3xL@pYfFRZ687< z^jVaZjx4#t>PU8u7JbMU`fC#;WlE;9C^ZQuv(6>(KQ!I@bK2{an)7V@$vk*hXZDQX z`M!Sn1&2rsR)qlQV?AkkkP$y=EG+Gp5 zw1t2I!MhqI*;;-3-&Mk-Za=`>2bg4}%;ZTuK)^#$?sG|#CY=PZmV5b=jPxaY*z~ni zGe}v!Y*lDqTi2>kP@QknYluT~I&IwG`OEN1f5&Jb4I87V&!G3S z0K%bapSiki7yerWdc4 zot4pxH0Phoe_S>{$4U-(B9s3ehRmG2dc=gn#Zx<^ z)nAVaEG!&(LO)!ek#uY0>e$v{t;_alr6)5;!}o6hF7x^_?}x!U*>}fp3xDP__0rm8 zxIU7cSZ5`qmN>>_(Kpc4JixruGSII0zz=w7*z91Vlzr!t9ii$WwK>;8uH|G9#Ko(z zu1Sr#)%1jU5!D7mA5i1nx>>n*+dZAGK@FM}h;$}#5s87~?vi!PlnG^D1d7KN2X=?~ zzXZTWq*NO3_l*L(<|2F+Vi~;EQjJ>StyjRV^;1e$|&}^j+`)92gY^#aht?%h& z<~0aaxp@X5s_q)0^vZDM*MYe#*J`@zNB_}3^;!LSe(rgNoAz;%P5@;e4GMUlYwTFF zdwhG3SU-5~s{+WM205pgo$*XxhfY1yvFL3MM8w-W-rgaud|omm=hL=)EjD(@h5Cgtd^zo;WA6bUUSCInC((+s9sCH%JTj6e_^a5 zzVTZ`Vt+)|q{NHM&h*wxS=q;m@rASc#oG#!6EX?2`pxQ_UJ`FB^fS!b*S#0JcW}I} zcf2h>^R;9aZ$bAKshCw9jl|nR{;M~-xT1WP)|(0g3yTxC-EOfNT^uj(Hfw-OjdWw1 zUf)+zJw5w%&U+2BG2;E4Ys`#U;v9^f4QAs0;<8wAs#ko*;7~fcYvXBmI63ibbJiOW zED;Bcm@Bs1|H?hd3~{;d`ro-*G$#;Yzu#K&M2N04 z=Ui$T_G-Hu?UMQI*(32fnIw46JYy>VX&=p~yCsAto<#>*7&*rH5S}zpj93uRvNNy7Oo`9U8wdjf4D!HLa$)adCJ^S}i>%aC%=ccCyo`oRs)wzXj+@ld z-Rd}mXSP5gi*q0Baw2n#Si&J|BL*N&UwLR23Xx+I|6) zgiRwM(D)V~efw#q#lyv52!TXHsY60jUd^-nbz;!hVi0K3bY8|P3T};g`Pbs3HHk50 z=E+w$g{#-9F=c!Q>xLlZbt&Q`bNq$Ke(m5%m2ES}X&2Xeb2>a_6~tz<_j0QM1_|13 z8*H)}c*oB4iK0VnU>cIB#FsR}!I<$pieS7|1kw*H%w|4Sn!wyA@Bp{J&mVyr)lEZR zJKC>{iRAk8qyD!4v6EkJ_xbhJEtX$fWB_grESWfMSZjJ|{M&AUds}lk-uAa|AK&Mo zM7%k-P)L@i^(^;JZ-^xBRT6`9P{ZjSk&1ga^B(JA9^ug8NMbUyx%EC$%*W4mC)=%3 zC5*D?FHuk3Yrl-7Rkg{Rx9CgaUYo&teNhiy&COUmmigh-gv*gJ#8q9H@2kkm;P-~9 zrb`IIDYUiRr#3^P`*3-{%(?Ca?8iB(D%)hA|M&FeC1LTv_TgqX$-y!!49Bl_!hk$@ zbDqd8-YFlxf5Lg=FLCgOeZnpQwc#?X!-uUZ#3`D%tW@5L#KX3(#KVsOF!8WBnzUy3 z)9QZO+>cY658vnBHoG6gPvYUN{B`>ew7+4_7JXw(z`z+fjrUvh?u{%*E*K~9W2OdC ziA_!Rcw#?Q8IH*56d)HCQ7h9qj!{nGPVDjI!|E(fvGYI6nP5Mc+s`9UvZVp-O2Y~6 zbD8~oTc!OBO!pZu?sJ{}+&I{NuFHG|3HNytLviA=Nttvqxb%8kZ0#UhtUmLZeD3oU z`*{`@b%FAf%xChs&r|K^^a1ws)XZn{xzE$==M7pDON6KCb8qNDzE&pk$sWJ|n?B5$ z4Kd9*pNqj+aNt{?=97El$os7&dKxkCbWmcO8S{w^s5&rJ5RVk^&J^O)>HFlFqqmBy z$08aV%)vHCtXFd#08*z$yivi5Df{ANjg*+)zv-3-kf#!89`K`Q+Dz;!R~9!FhU6Ai z=)LNMY<;Z8Y`>3B%@+c+d5wQ1Dl4#E|Z*sug7etx`_mS63Jzo;-uuCkk88S#d z%Vbo7;G=Fm{MN?7tU<(BZPH-FKY#vTY~?ZBys?m$CI_thkOpj59p9t&MEV11Rx_#c z0lY@0mU(=Y0{}mO=|u~z{FbwZ{9D7940y#~1O;b#z?XR9Q~qJ@{M141>C}baOZKJx z*R6`r0bCzu3)#`{*I46X^{eDRXdQH%NTuIkE7%u+6cOaac$@a#uPrRA} zY=n6Gpy(hh^jMF0WgxnbZA379{$yPO>h+C(Qxy9+8P){qkcjuSw*!BcHwx3dUzvFt zPXWET*6W*Ig_Db1n3V78bL7I+vu6~h&yGE*`COkGZ=j~CQ&L<7!rG;cQ^V6@%+$^yP2;3mOk+_OPB*jbt^y zgnw6vcs}Bt)XT9ay6DT}cJq4!BdJ~dS7es4YOlfE4ba)Z-tQoJr~eW+ z$vX4Vd1C1{bI%I>TFfWweU=3hW%{v>N#uM0Fo}FQp6WL3Fn>NQH_JNnH^2P(w*2cV z+Wj1+bE$6A-^RtSg*_72norO64b;?dG2Y|2K*G&efKO^Sy+3E)FXz4GSNwrR2fVMC zgFl(rn{M&pry1WTlEz=QN(Cuyf<+k~Wz5z%Pt@r4LC$xldPpFnL*gd&v*7tmv9$7XS}lA_m9;_(A{qYtFO#`S>l8h-pl7 zYt1nnT}Au6=Y+EWgCkitflxW5v%*}##MUl|t#Z?0TToQ7N+1%qlY+eH2`vqL5lwfa zJm6k_SA?940$XNE|0fKy*YkF6EhO%wlz{ZNNHjPfVU_t0R#OfVe6-E=kucLHNvFlF z0uu|qV85SQD7F}Swq?S`hqGyG+}uS#%shrClv9nwZdF_ZyZ%XE!Gcz0a%z1AY$)?I z5pU+>u+@$dBY94rT25A&t&<=OMOcm#3eBq^h1~a12X7k!$AQiovzC+iSr|GazF1~S zUTmBLwo8l9XNBgy=XR#ER1J~?`dqgqL)E2bBQxV1qA-%?5+%a}PJf-w0?afrn3;Vn z3)FfKXIa3SP_@h$%FO;Eq-(cll67fw64bLyD(gS2l0OOEEoM!h4Hod zwq#hF!mzR^FVGj%c;gDqs55PUOys3l8Y^Ocdnz)%T8={*EsXMkJCv9}T!2wZ>!VWav%@-yDn02vz%up(U z4{a?-JD$WlTH%>#scQ4&85W}}or^;JqOd*YPaDj27Fqf7(T=}ugkdo-Z#M8-MO0T7t?PdYySysbVj(D*zV@p`KMDm<(6hEYHR(h&W21ey-wH~!&w7K5rGY$JwY z!ro3A(|LcZFAk=^ZETyVeTGKFKkF9z$a>|g5>Jb>Wr0q%V*l^cY^NUNSqDkQn4vSU zFee08jTx#@*A%Jvsxd*z&>+;rBQF1enfzrl2Kh7A)NY-m!8toY^+hs<91-z92P0{_ zxlql@=z1%l=ge^eikZj(55qdzZ=otDs5Zq(Ybw?WysE;sA$FO*Gq)usMP|Vp9~8S3@~aBmS_IN$L?y;Q+-VMF z-KWai9yhpU*=k~UelerL3TP( zOgvOnhj%topsI3PVD4%j#QSw{tBzej$=`J-MPPKzkphhmSy!plLS^o(*4D<+;UYkFz>4QL(Nv+T7m|#DvV?KW)qhtPM z#%;{BXxNiG)9s#Zs~R|%SLvmbC}RPjoSL%*UpM_J*r}XSla==p@}`b)siT3EVq6xi z%{Wr@{TY3KN>2;)RH&!hcnUXHk(&z6qymKC5Hz59`jt!tG(0c-5)5Gbsmv+QXKYtE znwL(b!ymES;BEJ{SLKSpt;7@d^EcRd7ny9@bayHS-!78DeLb=f{Gxr*-QV+k5u3{5&Fs z2~gvZ3G>%SEL+?v>pHz6T>06ImGob$Dsza3UqYGXRW6n`ig6vL_;5ps6{|4nD$w{O zA7~6uU)X!DT+@#LDR_NFVBR12-pS{Q+aBTFoMh43)$|$2CrqDqF)#QB&GE!pqi7{q zHLFGk`N2WFmA{tsiP1xA60=Z)uF94Po#HhMQ`n_GL#phxj~~N9w%)a);XOA;UIio# z_!*lk8wJY&8{YaR5sJ!v_O;8jD}&*{NcM?YEgF zW-a~ErLfpGwZuHTYkGgBKb#fKKe^%mj7^=Q`4lU18DmBL(51qRdDtc1EJ!YMPM$wW z2nTBvbEZh0j!^&N*#6r_S|4Y0;414=8!VXKE4EpT6Q}54K!rDGSh&;J$t~jun;YWO z$_irxn$;3FNr473-EC~+tByw4;aJwrp58;VB28v;^YQMxn6rg#8|?hc`n$D+7wn8T zDpO<*ceci-56%nBI}F-X5BntS?Lh6$+edH7i+j{2PyFJa zd**4rZh3_9_87~dTbt6et`wubzt92lE*sqR$*i+wqYeyLe$1zEV8X}dt5XrT%Bsh| zpLud(v1Ey`mS_*+x>A{$1t8zCN@!Q{8bxkPi9q9HJcg5_vHoUGmz9RbtCt<&O;M$n zP@jhJU@g{CJ@aDK%oxF(zTJ`O6SanF z;0oI})x*-}Ph**IB(G;>j`4F!ZN=ive2?~KPEeh^s%Hv)C{wk*f0Z|-B)sI~p5gch z-Q=~MF?cGY^1KR^V5V`enc03{qgXq_aPY8gvp1+dI5Enpb+0BCsADt*uroWyi3gJ8 zQ@;n$s+&Hb+|9Ne_V6y{7K>!ATxn;ywNxM}2wjh3WrN$$p`NUkIiqMW4e-zKn;h4z za@`E3h+~5w7>xFof4}Mf_@Z_$lGGx4L072q^T52!D##@=BmGroXJ53L-~Ea;in}Ni zXqsmstTRW|3R0W7{#=;^Y(QcS4r}T5R$f+5yC!zBLwy3-Q&GIo3HN@m-Y*ggu6BHx zX<>HLB|Nw+j4XMn@T_QurA%?`nD|R=B&DN=Wr{`jcR3GJ&Ox>bJ{gGTX`HLHv&tDPcf%BwQ%Yj{cy;@Ro9QM?{yDMk zd6<;ZD>Pp%MJ~8HmM)-Y!YrbgW3ID~v4FnH0bm;&J^80mI(iqBTx0g8HXpgycx1{u z>qPHn5d+($UYit-3wK{t**5E_E*zJ`IeT?NxQ#~ydruX0qz%S;rk4;#R-eOzBfXnn zR#m`0s;YAPEat{Jyqp91kPPJLiB;Z9Dicnx;sU-@&#>KKtidR~qVm(g+*KHVzHlQ- zQqCEXmM0UT{*N!z+4aSYKQIVXbI7+=raikhVjW9XqS=OJ){Id{E^Z}Tx{aQWo$d>0 zrI}fjJiVLwSB)}kPYq|@yN+kg`q<&`tsyaeDta}>;)p*?8~_x5m>ERSWg6vmE-c(=9kQO4CW z((&YU;)Z9Z6Yw;Zx@kU1`C8lY(U&Y_>pndTI234NaT=)B!$Ghqt2W6gg{gjcI0gi6 zT&hx^px#l@;wxj$)#5^11iSIPb`7*KR@?n50-aUF4ru?Dw^^O_VgJ&AP723-veUEMzfwu{`r?!g?KjnnjUxWiqR_sMQU7I~au)y0fo< z+%;UYOaoP}DUmxkX?()9Pe+)Gwz*L$zDOeu*nS@Eiybm&xxSvij7xut?dij;4%M=S z`Pug^-FI_)1v0rJ-e}BRZ7Ag^GDYu4yz_&a36`6xjUw#ma$DSbK_p3Je8wIaW={Jr zqxxp-+Os3xJ$G3Q*63Waatq~oJ2^28RifV-%|jm;t;h9>M7YeRu2;3yS``aj;KCf4MA3^Tar%D3;&uIune>Ny64?Ct}ZIg>g*}bmC^|Z(rdMG?B3ed2D9Tm96T>aqgmTT+qg8 zHeRocjOLNAeH^cbgWjlRi@FVM7+)q=TceoN)Ql3T#)oQ?*M+nXVRdvsxH%=AksNUF z8r*uN9}tY4I3(sZoJCC5*BX9AYB){W7h1Ge4=JKN#@KQJEuqhLcBu)D}sT}~)8t|J{y;4Hy& zv&(n>`dZJgY%dWNY^JiTthmkCp2^Yd$`Ic&g8HjAxyuLXtceX5d^=KH zu-!6(9h--(PCWetRnfaBrY=w-=`9&TqrN=j@OecWXHQX}7>F zXTav#W}NjmM7(*@F8JQe1t3=IZO0^v7Ij$5I2dT!hXTHtj2*?%cIY3mb7JXS7?`WfyaL-KSevfkWh z^R$^}oE!3-X%pLAKkWh1DwoB2S*WQil>HT?S%j4J{4i*#NShh^n8?duXiPn2lr-gP z&F700ru$D7yyY(%Pl)!%1y^fF2&1vbz*ep#5 znnVyr1{OEUJC@J`GTu9ubc;n==1V_tN(26t8vQ!<*@kn-SHmV+JD&Ko3ag#UXfm__T9=J z#kA$B#B-c|msQ^XLkpPk)S7B-(VR!ly8B@++;mT@=nQXo#PoR)N1d%sODdR}f6oWi>6T7F9g>MzTw{|WOO z{M^ovaP>K`;D-sI70)_TznoDWVf#CVMhIM#5&0mzWbyj_5`ue(A0{Xrv7SgbxGKZ`y zAvWHNC%zsG2T|K->y9M_(S5N6I+hehvD;mD zoK%TsFx?W>i>Dvrs+qG~#WRx~u0B6+S#8B%Hj@^6yDD+<;;^?oQT^Nx)`M{I+U4Tf z#KjMqk`oa<=R+WtvNrLTR*GZ#Zs14%I`wHJQ5^_0eS;VfdI|Wa=fhp>_*fl1Kvy6p zPk#{8Eu7|<^6#Z-{!GS*7kjY1Cl9OzQrqj4x{3`>JhGkX;`RLhj_GA(|Avxr-d9!L zf`3vaB2Qf$1YkWIJZ`H>T=_Wvb5G~Ymw<681^>hUpP9o?5aR{r1rQ=!Fkz=Nt6&=r zWUozDH+a>LgV}!))eYmkwd`@+29B~|gCo(rv6B_Ea)K5+M%HO> z1gk>Z&G9^HT9-VXt9UpxZrm#K!Dxjn%zTM*gX1$-uyFLCvM#(7^?c~>@6 zaf@K0`ZJKeG*v*tr8Fv>UT&sWFu+xA3Cx`cqpP|x#K08%Q%pbZvl?z8NQ_g^cWoj@ zxaZ8P)M)eUCgPb^o3~%3geFpi{?fFo)RN@s@0gXibhSVqW8}Q@@$j5%NQLUxt<5^~omwvzsPbk$4KuY;qgQ=Z!ZJ}+!gXpQ27hewr-4H3ROlXP zd`Z~hLqS6@J<6m$Osbg5Pn%+QoHWYAz=~LOPuljN{Y-xQEqVj=d(bSl6BWiAe!aMO z2`+gMH$!w_qWWo;FHUTjt!efs#(>lyi?~1Yli_Y>YH}L`>1rTA^I!6VOtkTpzBe%0ljC0MmSi_e`ZAmpD0Qwliqc)Jz)Y&63+zV5H` z-ZQ5jFJn#124z|)=n*{(SKh3_FwV^VeI76Vk|u75|Ccq9-vCZ7uEse$Xw0c&^NY-` zNwWOwb@(4YUX0bb(Wm)WBImM!gpAF3=*y2s|XUk12 zI&H1;zB9{EZEot7K64t@5WE__2b8=oP2@N`w45qKP;0Jh%_S7IVe6FMZX);Ud-OoQ zuv2tzaX=QxTH$TBItHXKeGi7@< zt(FrSWti8#+zuDEEJw#P+CN48h`ssy?SilQr8@s0yJj@{SWAI{cClz?L3QHdG9HKK z1?Eo6c(vQF<>?3UZn^W#ARx_%|M=s~8+L!#KgO{G)%&lh9;-InK?aI?c9=FBhKqbQ zF?oHrbX(>2K-D%3Zv&+dX7z-=|pS=Mah#!55Sc9ae&^Xpq@9-eINKX!!KqSy$B zTA(wY&WzG%t?1QwrHk>%_vIUQ$uIo)JEa2l;LgfU>8x!3A67QPRfdCVY%w*xFw9yb zi&A@p3#<#-2OR^>}g+1jiOF{ zjrYPWdPdoYYrLZ(-pPt~JWlUN$7kksi;ZD;A-u_7XNaHNEk>p@Nnxvf+(KDrrrWAw z*GuzE3$w#Md_YfY47Iy8;D*A~KuQLh{%i|eFL?5h&jiu+wC0(&_$w2uId&Y{RY`SX(>-BeWkzGcHOW|a4Z_Zsn(@31Aq z^roe30mhLq?T9L`)y{m)SAW)=m3hG&h%P0)-Yg+WW6Hz7wc)*~?h)_1uyr_kc9V|2 zTPTNGDAIk8IViD{bxgoI)8Iq6)I!({o3QVet<1sXm~N?`DKJ%jTh(A9eX}HrsO!{Ekmx$ntSk_hY>A(+{5rd6*u6qWrq=tol4c%x4e~CRnC#1&gc{NTDNUx z|8Q%**A{>G`-)!;4b--w5~`ZUmnsN&e4!b86jRXdGUKZThd9eYPE}oI;p?+1HtHnz zuy*$NLKcY3SUMXQZWW>&SeO_1%aTC+BC_MaIIt?Pa7=#qB_R(msKZwJxN?s-p`IjDLr$^%F(3>|^#u zmNYD|mR@JZ-GmAW*bgq@+*_@82aR;gN02~0RA&!0(Ub*@9C}>qnD4fG78F~|_UD4b z{J_Fj8dq}=rSR4U(SC*D%C^9bb0`^DxD@L>dM5T=#N&E(c9n2PcEp1uE5~~U-vFds zThdMz)|_N)+U|Dp{Xyf7T*KGPEg&Q)?^7 z6l>qG&ZAsoE-}S0UUUqap^OZnaC${M+oRLXl~66*+(hA2-{z2g3G>o&Ie%QuMN^(t zw8MR-4Oh37i_}Fn-k^0SCfN0bE(|oqaUhorop}sjBJ{v;%D@-FaP!ORmeE7ma$jN& zStpva94*2pMh8t3WDYmKMi$EC*)nTQ9=Tv7UHTyoiui$OI;JtU8K$4JycOg!b4e|n z{e(T?ZztILwl67GE*PQg39AaI`N&h;ZAWC)Xd5^TqiE=#c(RuxBzIGw)c#DXUPYiI4zx{lGqiA7VrKX)-7C;5=vitl;T_xIo3 zN=YJTbyDsYg?MSsVxp{n&>Ah?9M_3Ut{?TOBZS6w=Y$X|$T16679!YaaQT1NSa$3G zsTl`?i`$>_mhA@)3bsc>aQ)POQBn#=*lma%8|GQ*WHwNzAd^Wl3a9w`BdqA%wPpaw z*@a84T4Kt(HJm;J1Kce@xHYn1boUzPdo|66OV@Xc9#`W%rXG?;cz`qp1qFxgFO|I3 zEFG%$G7_|z2XC{+K^^mmcV@g>!=h5H_mMZM|3g|Sj4vxp6$VsJQOh~`r{Ld~#$m5)*e5mKH_)=a+Dphj8^;yO-hUx}SjX(_$pLD1mQ;)f zW`C0EqsO_CA3T_jbymy9Qa*>GyLl_OZD_I!O0mAFS0fdV-v`tfS3j*ckDaWx)XL!4 zY~HneZ0T}c(h{_&<7QzHjQ+`cE7f~(kZ1H){kAbS&?yF0Q-w;XvF=%1N|}|}o?4l` zCZa0Nu~h)|HM3z2zP;_~hU1m~<&#v6WF4fJkMyE0dCe>!6Ulo{?-TC0X#+KK7=3(A zNY&Ud9^Jg2rwT=>vss^@xMtB)WV^ggP;)1hD)^mj-!Fi2bC*lTms#G!9xtI*E*Tjo3~CBVUf7aW+RW* z$;5%Yx?@lylbJc(&UH%JDqNn|po0uXupkaq0liIg?MM~B;H3^IOZAoxQE~_**~z;b ztq}XyX*=&o1S2eu4fc0O^fCm`9ORfN6I<*31)t{%*pW_lE2CG4(PRUsf0}o`~FlD0g`RKc9 zZ9cIIpf)+JFqNYK&gM=78l=hg`c+N=(BnrpN_-Rq>mY6bEex}*$*xe&??~;Q`=;`}{QxzNaB}mkeNXGAtp;?!h@Y@{z+{ZY zq|@T5O4#jMenVW~%zE?gT=0cihj#+PQeWi^6jnX#K4Isb*<`+=Z*sm=SXbRzvv!vF zz2U?RHJHu!h;Z&dfNV+8Wl^?hFM#IK*x6u_YI%8C3|(UstVGj}vzZpRlHHnNk;DQk z;|@_*3I~i9i09dHWk-9IUu>_=bIw8DL}Yn4@o`A+q})|C!-P)3jPj z8&nPvTH9Xp-%9jWgR9*L(Ks@jwYJ&ye)2G%cZ=i9heJ4&R>B&&_ zm*R$PlvuErlI8hVZgTVC=n&6Fulpo4(+}#(nQrynQQ2EvtF_(eDqey zig8=0JMASW-_9c4v@xr-nHJcyKflfBpWM)}BP9R~&+E-smSx*yVbpL;8NP)+k|S;Z zfJH-{EDC$&1X^w~=N#CTI*v(;AhD%TEYiM?XUx)*e;UT1ABE9710&FQBag!J$WAQ( zf|`T#%bGf-T?&S!S?F1tAJ%{I03qkw{JQ}pRXY8|AI*7tZcb)ERF|0>_|ap#1h3Ff zKNc89{7D(5&1tXrJ#ZF>{t|nK@@!HIXo$O4`@j|?`kE~>y5}|jicc1(KM6mG z$}(paJY-I!hH!I?Jm6NyCy}G=#a*i9z>#8~UUKcMpZ%Xmt%=cs& zPhkS6xkx)_Z{qIIsUq$FW?f58qf)Zf60R4tzt0aY;g@lFD#0(YgCfbs!Lx+~fq!il znG@F@zYnif1ju76)u#@R@5m1{og!d4d9CqcGbMXWe~O(KJlC7w&r<8QitxLuBfkP7 zUEZsGFN%+ohgX-mvOsQ5oFgB!JXimgsm90#fRH(3UuTc)07tvS=v8y=epZyMOK17) zioEE+!2bAePXzSrYdMW?NxGHP*k^&3t@~q_#anleT)4rUcLSJ6{muarEr^}Zk(nG* zekM?Hda+*+dqsdJa01C`yp7mPHBUQ0Dc%ON!}eFL_Hu6ZCKa&Zyx81LffTD{q_SYG zbvC8OmD-ax(zHRQo{%N*tMvlJaBcdFI`$0OJ-(23+Wn$jvcYu&BF|B@!My)Zp)tNN zlDvKJ2DF}8iG2hn!__}~RB?DKlL=rHn!6cBQv=i(wh?qDABeuPqrkG%Z&)-cF;`zM z+E$mSVN)Yq?qDXDAhS4)Nz-eP#wn*(0G3|?A8Ny?s1#^=ng?B0xqx38cMPPFV)G8S zIB3yp7AYZ1FM4Z|NM#BD?bB>Eou_p$djIrrv(_DufamYW*F~K}7iT`Y`-}vMmAr7G zXE<>_^aWJKKI($#FYL=u3k+6KhnfAD4W{-FSDarkvq1S}`noR#`qIO`>s;FFWCV+I z(sIn!nI3z~gC9t0=&fQt5^Db|)3VN%t)OL`tl)4h23NVCH?$}*OcC|cm3&N{(^=$q zwn*lye5|Px!(K1vwG($tNp!2RXU~TV%?c*$Yz+jAY(59no#7x)SJ=*5Tcp2Gf4}{+ z+=367C+`+X*O|knb%%|dz~a8sUA~fG&Cn#%a^pz_$c^{da2m4|~ zWwekiO$x%O@f5`{E;*}PWXRWn#_wqrUCFW2rU52lBqoA>LLuIr`{)$pSq8={<=vtK zw7#2_=cUN=3CJ_s+FQQZKT^3V7SIkY?1N)pwJujoOuN`|I6zsPS)f<*Gy4*ld$THy zHx%Z@_Aq-5qMF2*LaPVxM?>xx^qG4q?nC#N@NDjA7AhKn0*!Cjk42nOnOBvlN8Sd) z28)&}mC*!g-g>X3nR(n=vqK}79e<)@Ie{0=g5foR$;hkb8r#_Df#JZyo;B%}BH*8a zq1X1cSgT@&MI@x68e;@rDQlGSi*WOA_yxlzTUDE>w)l0uH z@wyyGP(iY0nOpC?D*H_kAH8V_tqNY0ldUN;YN=2sS8=N9=mZZ&rWr@2%>E^)O{)v44|Cn$s%Uxkq|B8X z_U1SlFW)GBqUm>lvxd^S=Fdbi%TW5}hK!-qKuV6GM0^anVVOIYu_$#8)Er37qS*-2 zlc!#s9LpKOqo$bu5Hiqtf-ZJTjkl3X*d>eQWNI=%x@6Ip$LVSdzRQ;`4MLv3xiCkb z)jpjHXpO)Lt86F8t-4eWN;z#AgS0XthB)8OWg*y0f7i%8L$1;`^P4SpxlZbP7)=`W zC)cD^VA;~Bc3ERA-|Ru7tZzvymj$_uBDWnS%K*f1Xj03B6 zsPcdQ=wNGo*ufqL!K!Q%C^0==xzkqRMWOx{O8>0b~ zeTf-=fgL(((=4l=fxu_dZ*u9wmA)2damSwMjO{ZPYAw-LtWJA}+Cb{(AeB7jW+bA( z90?xK=fUg632RN7ViGTw`(%BGZ1Zy){}byaIq}ZVuW&kcSh^Z7yN8qG9h_R6LS){v zbZ;~NwO$YnpMk~>P#WjG98R8jMRjsacXiJK-!yuYPi)PDWu?-<`)5b)gBfTEzRs+$ z_NDY$^aPfa8Sh^;N7suu?gkr#3^JU24TEvA==~#dN_yFnv6bd+)>jTrvnMCM{fgM` zY#l8!-!V(A^3v@ysZ~_FKzKB3u9P|peDY(*s>|1zzg#6+S)1OTRWy|x)ydI)Q^OoS z8_b_4+s-;3qt6YE(<~?{CO0%{#(~$2zb#ks2TT|KpZeyH=FZ;1NKpf%GN znZnFXofFI|LFf3-4eGb@-|3IC4qQe+d8Mq#?5h!U$QJy9yY|n>cO(~W<`g>}|H=O8 zYps{SydU(>%%M3{zW4@lRM-A__xxS^=d%U4gb~5ql0&j3>7SG4|Db=)Y3kZP|7VH# z!~R)zW!L_Bn0#IPXQIU?+Sxx(T2P(+leF))f7H8RI`D4w&mT+&c&UGmqyg%m>mZ8c z>coChIOwMvAJF)nPOFR-*l@bw*_!12>-G$;6*9PC!s&%t;pxuO z;>+fj=rh*v`r4=-0y!AbX6+HVur1PkJ*W2vZk%UJd=v4`E7aOh84CzZFg39Z4_T$z z(0m?iy1!$|s6`P`z1;j|xV&YJt<(25g&5aXOP#0ypg_}7AevKeYjcg5x8Vs{%KE zs2A2?rd~3?rm`dAy$uO#0%P8Wtd-`!SNf!UT)BpPsW6wra`wOE(snm=5#*c}xhv9r zdt}Jw*p?bw;mKo@1;^C{My<5-u#VW>%n?LJj^?ZBzP_e%{WT4o5Ko)i_Xa&RN$Nb@ zEPEz(joxq6(=YVov~pPQll1;aoAU;}NA$kZzT1-JdVkTr+x&KRE3J`Y0BRh33r}1< zgN{xerJQm^hnv-BHYx(X{q%O}kNeF+xu#*OBQM8eBjVdpSIbVb$*ozQye^$g+-VYt zIaq4Y`N3AH2gz^7yl5q6oU8@z)0O*4_dMK1Z8ctdl9}xQyF10|V;dJ8LVLYL2j{UW zQgfgd=BluwJz^IK`Y~hBd5o-wst=2qm9TcgxAdu{B<@k`t+1h~YfK0L2&BELVvWhi zE9Fjlq3WMewG`x)kHDqy5HnIKBovbttm7_3Orc6vANl(kXTRWU!EcP^AiLpc0p0+o z&HP=6owU%CU*3*wp-g##1DW4(EJnZlXnl>lH|qK`?S7q!-P3g;nn7Fx=7w!nT@a6z zT-+1OWKj)JQ#ZCq?W+Yt*jB^$$b}O}VAhwI8}NguMOnvK%VXqJcgrJAA0K!dlP>&W zIvljXy!;zCGKAcGBCCfpt+4n@H)WjkH$3kXfyp&EeL*|o(+Weg*f{^3P~x2M-$C1C z(MEpEdH>d+O-q=qtx4Af<(9BF9`*Gm7A9C{>-!VUIt}HJ+pGtcI6TWV2hDDp%hESU z)n?0LAGLoeOl}X_XoFRVhQRXGN;CaBxn0iPOzX1tqHUk;q(5YUe9OR+tizUi!~A}K zA;XopY_xz2mIr* z@Pcilit}Jkt`XpGjxSTzEqF2@0^c3rVYdI7w!`WtX%tJ{FO?Gux6B5v;QJHFvA;!h zbuZ?~o@U!EoetAZfUGm`cCCgf*-p_~59+Tof4oL1+ewLy$by^-XgFp2{7#S$08;s{ z02epm2sxc#ab?*oacv=#Nu3z+DitSqOcq#!1GYfGCJ4X2=FA_(Ps$wa-1rzO+a6mj z_TIM#OLmS{kwj&n34=HtZx{jLZsv(`9{1XS3BZnU`%$>rqq4|_6GoWj+VQD71Q`^Y z&Lu1DDJ7dICcDX^=k6y9n^nO2VWZU1(m1}I;<|;qkc&IHCwuV()M=WN&@5 zM@dK07nJ5^&*+07D3~%=%H7Lmej(Q`iw<3wwTOH_D32&wR^8g{^ShLZbruanD@5Wa zK%K+%!|yJ?ZMl9%Rcl zA#A$Q1o5O)nbqY^jJW>r!VtQVAdfRk%-~jN=8Y*8yWlC3*t!{+xqmKrx`UoGH=|fV zzm$tL%h+|6)wpkPr>Q#H@khE2y>bJsIhptPG{QrU%Tnrbm-Ar0;I?`=sWE44NqEt| zBE^MuBg{@U&ZkX=hGu#e{@9?Ik#wrZeEBC%YgD(3>~}u@Q%&_krHZp;yw})a$QB^TCLe*SD-RDZ*|Fh8NMBUk{BmY7n zJrwH}yIJm}Y6_Qf5QzQB;pmLNYH$X^8|EyK$PUy|P*FqTT9SF`fgkvjT>T$CYwO3Z z7zp2lgg#;MazQ=+VAmp<`krwmtl+=_GOBQO3F(Vme-E<#Z9d-X|7&M2bvgace%|{* zXYc;kAL;D5S@?AJt)Ac6J^z@~*$?9ecReN|Osk$d4I7x%h<~e%5Y4UvcxBNirH! z&mb5haYLzwygOQRK-ovjH2!jT_B`*ep0;iE?0Fhx=Cy;Zk5IwMn!=Qr<^P8nBo(YZ z{z}9B{X|Y$h6Nq}{LMiVPB1T*AA=K)x;h4VU55-KMbhv6ka>5Zf4z?rVK~yr6*&8R z<2g&44DeyK-t77CoMg3E*op~s#=Gr>%9Mu2b@H1jiRj{87JFn;93%Mr|CFOfK6Q4v zf7CT)&)nM7nk+O4Wrh^?H`iXB??c60eS>?Hyl>HZ)w=IujnNV8nr>3E6$M0kjEF3xqs6I$ zgt~V1u<>N}Eff)*F7Kq1W+Y{kX_?oHA&bZ^2kYRRw$rzwD)hz^+vVJ4A#nA`FPSXoYW=x6NMTcuflZHUu;;Wmi1d))Lhe4? zKfG#GDQ~K##H?h2fQMj4I?c06$PT_aYQ&wt|FXiFaX&L=SDb9&jSe zQJ}}D5C%Plgx<+hZZ&tzvgSgZTlZk;Qn2-}sm|O_eVPxE{drvR#*sGWm;*Hx;7Q0I zBtDBEr~87~obT?^fUiL&#;Ov7vmIzm9^YExJ`y^R6(pX&NkdcInvumBBs$$k{(S-~dcP5W?DIm2-;oD~xLA5~}mc`J8zg~wHdS$Ml= z;dK|7n)G{4FZr6p>7z6J@(2gMIA00n2=z~^RQTQ6w*4Ih=x{!gv9eJkdWrc|lHr`% zhd{K)NmeKPmbNDAewi`nx8LA*CZRE$U^z-BDKS6jPGE|jOu6P$iBV$2SS4Vl_+aF! z%>nZyV4Qmd464W@*&M;hY$*q9c`@PCE<>`_pFi&34yo=DkJ_GM^CxlZ?EJ)k+S{si z`91=TKLv74@YGr))E+@6zeYYYSpUzJd!hH38R3{RYDP zCG}iWT4I**;%(wFD9`J&``Pg^Hn8O$a*Jm22EhG0+Y>6z!m5{-=$^Q?K$Ew_w8~EX z?5$Uo(^!RpRC{L2%C}Bgld5wW?Op8}yl&B?m*WUx#i~L+Hy2xzI*_g6&P&7T1e%g* zeN}n3**wqiw?)gM^v1t#%qZQmU;F!V(4?cRCOuAF(EhEpl0v4;a)VW-O*pE|mTz*D z>1}{fZjV8q4nw)r%egZ}2Jlole5TQNA-mb;T=it?-?`&o5M0ds1-?{`EUwlHrQ8Z4 z3Ys@mt_S)cGa5(ITf)t=DHZlMnllTbeP6S+RIwIqnEodTndE>$7N_;*(kInX6wR7- zS-*>upMieOP%?WlQI1(MCD$zJB7R-$!3}@+@qfb_B>ymI|&I?y(0JK zF(OnxtVf#;ks*eQU8b0P5W0?Fy*c)>?p?iH>@|UEnbvpO5V`hVU8a6FKV2Oi-XcYB z?t)A|S<@O;ySjk>shXVG;@dwD+m>crX$<~O=P>wZ71v&9!4|EUP6h4XsJYkt}*ba;P z5JZmyhI^XqYd`y{QIepbH0uSD$78aR=lk#$HlPo!Gi9ggbA5)vBjW8ksU&%i-ozMA z+)(WGB0K_d4k6HEXQQ+YjgTo)sW!+INnBoHj?|0p7E)WqTt!v#=e=$Q(Ckz%!od6O zZOH-pK$5j!z9qz1L>Rm)5uTjYNrWEPLD?0l{eGg^mlyagrtQwfOWW-td{*#$5;%Uk z^Fb#$yUqtDH#!^oMqi*IW4m-1 z(JyW04Ew%Wz9$rYx%p@^Vmk3M%&+yZy!5oz8&J+oGoks|B9#AT^V?`l7lw%Gmrp)!-vM~TozyN_!*Tk*hbns$XuHSHH^8D}?*^Mq7R z6Mied+`-PMo@`T0PWx4AZ>g)NZBoG^X_W9w)}I}y(rv;m7Yc_pW+NG>hwx@KT8Nww z@lF!cq3$M>;O`MHURA;lJZZS@Hg1~}Cu!_qG?q2HaPwbyXn%`8obRYXM-+>#gAOxi zILqT_d~30GLj*ltF(nkeD)Wt= zdBjq1vwCK_TK>F!=h&MqX5#q*^+EIkq1(vjE>`zA=*P5gWnYn9i)bLGjziBvnJ)0D zkKgz+wfh9~BJ1_3@Of|;@2{DNU0>Ywt%4%$Rcv+V0^2XXIY(Z7HF6CLy>Bp|fqWy{| zMt7L%&oX`VrtG(6F)SI#fS7dl(W=z3KhiUM(h$pG<^VA7+A|GQAlt@L$Qn3N7)%{A znX9<$pv*{EB4)y&0Aifz-H}%i^CP*qJKLX+{O$g%z8jt?F@*6gm?sO6#?G%t%us$Y z8%rWH8Wk`yHGs;>agC@?TwvuW=nDB`)4^IRkBf@cIhRcJRfRuG>|~g28xNQ`qSJhU ze>#_9ihZoyRjP8-YPJOyfyPJmfWNLHU&rv*(Zr3>d?vwK51^H}frRulmt9+8@J1*w z&^*G@gA8rE>b+`AA=r^~Jf#5tFTKFPA@l4GXpNSjo6T8AYe-sSt{$detp+4)ErG@w zi-j(3Z8N71)t-((zO>1du5II0bomQ;%Lx7Ugu1;jkf-)O=>qTShtVZ z8;$dPbcm}>Bgr#E-ss_r)cVAj;oSP17*p(x9+4O`!o2wh5lF|k^o&&Y()LqgqETSI z&DEB4V(rn)X~$3(4*OpG&D=MOIjkD3J1bgd*XFaUSuIadm)K++zc9#Y*JI_2H{he+ zn$f=!xykINRyl*Rss^rO;sU(e%dBrD%Q5P%LVtaB%e{_^(JEX_W+pahX=}6i0n(u4 zxi3yZ$52&ksOA7_cQXUuap^~;ba7)^zR+CS_ruJ{)Y0kVDc8L-x7vtT=RxkhI*ZSIELnxhL!hZ<@<2Nn$-&W6}MhpNX(|$ct(m}1SCgJ@YltF zEwb;vRNoszsuh~$bykq}mG)&-RU^+zXfO@}4X0+4~v)`QrD-+)P%NW-DZ5r}m5Q_9HvP%A7qbGlM0;dr_v|8CF26kCa(UmN z(+88sXO@#u-Crx7#w{NTpT4y?x#Vwz6`2UigUAae%Cej}ka%jXjcR9FWRb&ZZR^t* z)@4$0oU57WsTzWYvbHp$f$KU?wOOBH>>d8}m+y;3| z1a+br{o&!}k@UPoc)oMR{q|b8Auaxprz-x-EHkKgYSQo8{;>L7QGO+vpx6^S>+&zj zrY43%TjP<`sIU#yc&z0zRd}VVFsKT(YF?ELA7l1#6-sMpI&bGaoGxQSFtM=wW$w4a z&03?hS{>u?t!pGIZRTJb_8{G0FE3n4vMPFvtSxNL!}=@6oC}*rv0zJfetflcUB&DcwbvBypw+M1tie; zxqUemvA`PmfETlrurfGF&eUyFU3czFdW-xT$#HaN^)JoaSh4N*D|dem+H>}Npix0_ zk}UJMRj*s=%0S}`n|LY_gap&@?R^Wr;m|Bo9!du4@~F$!0aKo1W~u@Pdf<&JvC(|B z-c)t~t}_Rru|dx|#*QFExcS#`O^P^-u|XTAG8XaWY)1AZsa()pL$n(_wMVu>%n(`Y zsnNoRyk-No208kOb7gj<4&Vz`1D1>&YD7VqM+uuDAo4I}Imy;~BVQ~?a9@9wkGolM z33xa1sn#3CRTr!MDl9tEUO~V8v4gVcjB@Az=9Vm&S%67}fC1Tvxp8P-2I91QaJHmw zWTV)`Ofe{Txf!LR?owG7Uk0P4&sQg{Gyge8H_WCwAxK1l5XgZr%ya{SlT{RgHHm*@ zj?Z~hnNZ^=fA82IYS(F&$YwN;ql>=rzBV28+VZpAGJ;OLjChlw>zlD6^Zg19&eo`y zDFab`Rd0^_l|t0SIMHAD!Dk0uZ1pmR+!}Kzh3KdcBi{8etUa`l322xO_O;Xz0tMMM z0p@@NMin?gRKL=8F~d$`a_I{+8bx+Jv{i6*ydjtu!w6ev+8}VG0t``uldKO&6Sp;{ zjt!VPF|qkPoOimQmwCaiJCc0;f2SpdMmbS%A{+?|FcvXaBUA$BG4FE{h7?Vg(fmi^ zr_OPpFxg780bFgIRxEg3SO}1v&D|5;gha#4Q~|E1-9Y4 zGum8iPR>QT>sYN_*B^nOvu`?X_wix8X8#37P9%N*Bp_*j**9pUY%lSC)~@eVpZk4x zXqfwc_b%^;{i^Ht#4hi>k;2aMw0?wdE7xVP#Q)se+;3x6u!isEA>6!^l`jU$a~adc zs~-?9OgnxU-+&$1Q?_b?`vh4lhp#yBv9rF+deH~BS&D?4zi@C1fSZhLG0zi@@8mUh z5TyUaALzd#SBo~cXLxS;1p3~`kFKH|-rg8JMyMgfz0C{aO>H!Oh6l%JiD9^5 zkw^K;5!`aM61!0ElC^A#W5ebMLT(1SO2kU%o5QvNlL}6g;WG3Pt4t#>9Xfq59F%wW z%BsP2X*f`>#$flQ!#2W*lG#X-4_1WDYpk@}qa2d`WjzJVGb~XM6`l_Y@#T?h_hr|c zZ~t9}b!oHlue%Lwx^aMV#UpycnuRv zhp!KnOvY1-W#(K!iv3OuYv#KK9(_B#yJ%vhhIVUyk3`IitJ}Y^sIE7?KHfpRVJ(KK z#$6H_w_79b0Fk~5FVB?xuPa$>uRX99JOGb1500l6H~WY&`w*byfMXEjaPy~>FwZr> zT%YmeHnRHXuAHXBh;YuenKKK7-FkEHrEa=g)V$4RRufZ9GH}4Nd4jE+k8QUVF(~O8 zY8>;;JII(~{bap)>MO@~XGJ_BbCmyeGt1?-Dm<)(qUK(7X}DPqMLOYDG=Uh;c7Pr3 z%@u57(U8aG^8+?q?qvP0Gd1x}b@!)Fp`RYDv-YaxioE$gPyWkihA_;~7j0%fs#CXE zW|#yXy}(11-xuUsdeWkdl)rsm=cr%@6))emoIpu4atj8?-UxrU zgg>4Ia}T(+lw3G3Gk$RPsSNL_3M%1ng4tl}eOl#xs%wn-?<498G#2A1id2*Z8hhD? zsfB^Y9fZB3i;L~|x9khg*y69)XG_08<8oe@RTQEh1C7t|Qd6PAkMiVkQFp7E`Lx{1 zB3x{!$e>6V;y=N{QUQuoBJ3@_pprS@T;=U(ujK_vCWd3%OgNLvJ{k04zE zq|`Ig#nQ`n&_Pyr1)A>T1H}t5%nPf%Bg1oc+(F8$BUETMPqs2DUJ7Gny5bh|z&Wb? zQ`IlmvH8j>dW*QCYVYue^rj4e498v3S?+eqX-m8*6f)9PG2hRp` zbN;DPW`A@$OEM;A_F%DPCu#%;H2vE)@;VyX5eo{Tha5unAY_qDT3vl@JL-y+jDh$U zD>nq@#VO{EFQ{BHYlhd83-GR^o!1DpY1mR?s1wQV4OGe{e##J~oWUCBdh`EK_9pOA zR@eW3RtW1vB#3)dq-d<5K@9{o0~44)0w{u5H*73YSCknA*@BZ;rVpdmwTre|_f}hN zD@I%zKnaR0iVKQXtlJ%@C~gQYj0npX5m#uBR`Hlac z@4qJ**@$OOv~18zAZ?+F^p_Oh4JXHdli-Y77AgNxYjz9i#-9g_I(w?RN@x=>`_^JKxIFetHhTTP@lI@Wj&kMtnI> zEis?`3V9iHq7h}Z7By~ed0wdbueM2d&Y)TM)39AceE#O!ctkg1qrqlaYbG6$k0{&* zEU_tWWqbr}Xk1JO^xxa1$9?BjqR3Ah!H&ff1Y&np!`2yy*Ra1Nfq(5bQN^8b1 zA9FJ^AWcx^Vyd*&GmsaW3$u0KMBQ32iIk7i z(Zs*PJwzhqgf$`fUDwT%cme?O;B2KsU3b&t;971VGH-tBI%OS52a}i{NQxPC3e-uY z=qA|8t*RZn)T(%@rZC-wToQFxmuVmjcnLMPl9_2l!T|kNK2l8WE^xUeeE}t*IM4zW zYF=zBx1aVtQ^OK!Ud^^7g`Yh`%%S0p56ptj$oV4`pB{|VnUm2+lh%c4t=ZKNu}kCY zqTVNF(F_3y;U#95!u*$!$A@j5sm;PRp3mt?{K>X5F55~d+sap`(aK@u(#Ri524`+c z=ObM7sXL$22}ngRZ$hFtq0+bXwfM5=(?^}3X8E6fYClP8rKkCyCU<^n;FDG`&Ym#k zTBlzy&~lc%>SvDe!js&TH>o#N#9r?@o45K<=Zk{CB6BznCts-uHKBdL>pAt)ciq5M|h*7M-z>n@9 z@trk}ahdG>0-rmLHq?9pmAex>XX^=+OoUxz&)HW7s1wcpA7#6wvoHq$kzoC;7PL1o zIDz8v#iamdR-bUN|!7vLjuen%m#pX4Pp+%spC{ zTa1s6XZDrx%_jP?sUVm<0O;r0+Q z9_x~WY4`JUUAsrpZs%ruhul#PhFmfa*j5G1%>Y9eUSgT#V1UB9B4|E z?f$EA$6BoxJu~5J(FK&Qq?-!cW0B~6W^v2DQvHOiIQnsxW4~||NU5`FbJ>k_0Qr?| zktw_D(!{V%>|smnpBFF7!dK!(C#`j|*M+^|sCOv}$ktHvzW`N2^k-k< zNytRixXFyQj~lGja=m#7$Rrluuo>C^cK&UEa_XUg;`YCDn%duQN;{6)CKs_+neF)Q z*f+M{zu~#QvCUc}?QYA1Pz7S**etkmq83B5vSnl5Zi3Gc^Dxy;Mgg*Wb@hn}L$Dy> zjZ~LB3F>G*$5BVmI<;$EF|aMQXU2#i`ch%Ibv_{3HW;VJ7+p6`znfrVaK(!20{@sd z-UYR+&;1&gVX=Vc(0`^mdc`W6b;`&kB}-7^@czUXaG|a(S?#;Xl2s)bV4<5Pz;ML- zl#m}*dpZh{Yu8za>0#LLQ1gEF;cAvurFxP*TCsm;m{b0$*;Ol|Q1cw{VQTCLv300f z2*Nj2v{jDUD^a-C{9!LU_jVFO3%S5-xez znRV>r2XpIppfB8dgHqWK^O^Bsn?ZydYPMd)atpQ*o!`6PDj16&qZr}{^+mfTYyGc( zu;kIhCcJ98vV*|jVt^k{a0$NL{G9nIcrToQa^=WY#>AvZID6qadLpEaeS7_v5|E^xK$=ZJ|1sB zt~bx{QHqo9GZlI+wQ3`StxYOz3Lqe7%EDm%n$K2v34QUW0OU$o-vU{tU(sK=;ywGG zp0^`AT>KSxw!7B*$kLsZ3`=(-^}uN$2xqF>{OBeJ6|HM)gllHh*>CE@YV*ijn!@p8 zz5hGdS*}iPac$4dINQxxvcLMybESmWDKRJ4qqRJ3shItnMIAzCJZ=_qNZ%2%Q|aV9 z!?=XgSCJLDV1r4cDxn>!`8Rs+LB)NQUsO!?%9n+|r5^xk5;qp;u;o>fHAMTlYI~*2 z$+xKEHeN$5x;Zb3-{TatuH$t#FC= z4al^zAMYVSP?G*R4~up=yTUIlzpOD^H#ry%4`7H-jtpyz#wK{P>Jf%fUM9vznx(_k zGvs_wDO}*XCERIEvf7M%U*^zI%Y9TWbd7acdZj<(!?G3r*P;Ac3TGN^N^jw9(Jp5N zxQ=Hb=qEl%H$o-OoP4eY=?n+bsoq5saiAL)@n)T-t7S)$I5p1YC%x{P#29>M`Po5g z6~f6rq?t=1NmzJHX>tbZe|~0`gdL||xNJF1Taft;fLoLqZ9c8)?Dosb@YA5Oa+^(` z*nqQ>%ieksio>mmpc+fO5cF+70kUiAglgzk1okR&%Wl)zfJk;*?yT%AKtOP@<%}#_ z@*&_!r$6?a>+6rj^;0Eh(H|#W%|b_3>iQ$=Vcr^Z7guKZO2lBwzkG%(|1TKap2cvQP$ybeiMx{ofWAwVce+YNjYZ5=R>m zHe`vl|Koo6G&=*^Ign(h={PzXcWcSJpe$|GGs}RT)9-nHH5yGy6~wPF^~X`8)8icb z|2zOq=0$JPP&@C3>e#m3DxB+AxW9j4j$J!N`50~;6>tiKamDG(cWrzyQ%8%S>UCj7 z@mYKgKhZ?)DEkqgT;Nh>LJT97(z=Kg)6UL5UpAa3l3Q=4o~+z35H~W4<7S6Lwc9yI z5X^h{qG$O@^IML8NwD^M>?(hn+isPt&%)j(;v>yYFF*j|qjp+OO}rrBqPuIwMQJub zKtOn?#qcTR;wR05Y?4FD&T(Vk)3juTcsBd4nNoJ-M;9gB0hk*dZr!NS4+ZKfuM zn!5kPSlT+x%Mlc=t#Xa*0VuEVJ>2>>`OFzWQ=hD4ho&2G0t=)0)zU8Lo^T%BeY0lI z>%6Q!5yYpMc%?6+z5%zfxLd-;E^*-!rbo2{z@k$zCcHIujoa|2GHW+k-M%slxlW`z z$d47|S|*tOKrVGh`yCb}x22MQg0%wJ`UI%`YD;K1AEP4m9~!ciGe7;=tQ)18$m~Qh zey3JQbcb#IJ?tfMzYm@Mo-?h#=eu@5!%4P&GKEu@Xl_d-IWP^(-@vWMfQMZk%X}+9cd>v#;?W=c6*JSpYzP=5+likuq{3~ zf+~9YRiMJ2-2O7w` z0E$vD+&YlIPe5LxuX|3#h;Yhu6Qkl*ERG#IyXYw9eR8nouoQ#qsH2!-P%YPVh-NSC z$m9~uOuXg;qKR0HKs0mRp-23~+`}MK_d8`9H^kJqhbnV|d#Eu-yN9Sb+&xS*2e^l6 zW+U^nPc$=r0nyyu)=4y{&*&tYaqihCn&(c*63wya7Fi$VbPO{*Y+Fl-bLa zIlMC2X;PJE?|PHZrI*2Wrrma6M?Ww9ur)BTJ?AjtMHz_Cx+llQ93y=PBT1eT(1uQH zYh+>->yp@h7LN?J)rrrcCP-v-8c{|zt8V!K1%&AT`uIMXVr8g$z_!9-^>576Lya~+x%q`kVV8*n!H*P5qYR+7l*jW(o$J*4KfZUD9D z|GmLBze|5DNH2RzjH&t#%hvZGpZ2Klz94_EB|-k1a_hU+r6b?IV{jaNsK~(Q+MAwD zub=3rPs&Xn9i$gO6_iiFquKHUv*|s9@{PIaU0gbNFR_ik1{u2X*@ND#JMDo%!xJ`elENUoG_hV}IA1_wDaG^CEj-fdE7`MO~7+J=&8_o4Si~8a07>K6P!;HDkJtHQ!nQQDb;u5p#)kqeYFw}gxeL()PSHuF7>%Q8e?!v6UAL;g^ zCMXB2DwS)pIgv_S#{)~?V3$5f>3f+2Ne>)d%Sf^NaIauma)r$IN4Q#dB1h}IRq4aX zc2*Gn zU~c0R_=)71pX(f{H*T7#IoCdvnA2~z52a?jd+2X!-9xz<;T{H=N*>%&9j>}kRK@hP zfGJkv&>6D9(eHg1IVcm$r8W*qzsA`DM_(@eT9^L6=rhy&T5N#J!cK-^^)|rZaQS8~iPR-RXK3i+iCOG3(znDn3(uBZbEJjWAA@rgk zNBYGOM{Kt<^3pGQ`q}6oXxmf2IE$LBe(}=(re6>br<}|t@^hcU=9GZ_ov~w(Wu@Xl zR*p=QrU*u4;a$Rp$IjcV*_6Ew&7V-~x#@mLAIm@XH7mR!QD6Rb`loK55ip#cIAjm`>-Tm_ z4iM5e*tyzG-{@~cB}n(!ZgmfKpU^!ztnP7w(>-nyBPTCHTXqnYnnm`@EU-r007*=9 znf)@i|NpFR`18}M3wG!4YdiT{D!jSRPuE2|#ye&|cB7VJqre{LA!+TarIsK=$bY{GG#ZGTBECo72sg#&Z4KSXOG#az^D zoRtHzzeP=r^?R%*3kR5bnDBLehpTwVcKE#pCpi+Q1#0PTz3!x6_T||GsS!Ec_A`q} zBG3!mDw!1Nrtp&YByynxth@em@Oaf*{0ty$Y^vDGzVVkcbT7Qh#5DTq{dCvw-0Ed z9>qC3O;?VxBw1_DK-mF={p#`0TTCjq{|T+L<-qgawHyN3q55zeC|+Anqm3KGPgsM> zRp3T^K3m~41`3y7DL8_N=RZ7Tae13cF^!(U6fK)jHl~grNeBChn=hxFZxKlEZWrL1 zQb&P4#^0qMpG_Z8=cgZ*o8B**{-2wE;g z$cj)q{=U?@)0L{z`s|xTx_j)XM4EVd`g5#q3klZ|v{=`*egutj_uMgoG=-w%(%Yvl zh5YylUM{TR-ivxTWrob$>+H;ASN$A`$_i6kCcwu)*Rn2%^Vb(u=8xR@8?gMI>x=C_ zwf)b@Uv54RbrN`Ie)>C%X}q()sp2Q#+T8af%F%A`P;c)0&OOrS>``AjcReBe=B`)N z{+{o<;XhTpFQ%DndyYQ(x&FapJwR}kHXi?MxcE&LM?_(`GV6V67n*;e#g8c4B zoJ5KyD}X*^HXcaV0*Je_`^zD#!P!y#A)uOk_|MVT(sO#Bwp)QM^I<4v_83)_`YwQwMF8lo$RhhuOyu0)Pt1`cpT+h!Vuphzka@( zJj6;D?3a}Lz0zUq&m^p@n?H=?hg6vwdy~2HNHCcyTPR}^gmnL50uZplX=jxdqrv)Uz*%lYCAhnp zE~v+V-NlI+pE9j0emvs7M-f^Z6hFtpEnD`W;KrVe65yb|=rEkuUI#K@;{k9(8QV?hG z0yBw6qTXz~PGOge^YZ_&y*ZRBpQB2lGRsHskXXq?j^L=zRdj0{IfS!W$bS(dF@kz) z4a6Q(Z*$#)3=jTmPWkF|g|t$n9-puIwrx3_AtVRwN$g{&8zvL4nT>;lul1%{RkAK% zQdhIz9inDIwI%;Oy&nU4bLCGgnouNfS2@X>ze8T4Z{br@K|s{wTvi)l;4^ceWov5* z(dA}KDJ^td0@%y6f$h){Hpc;7YLt}#H8~`MLM8HOe}ma$gTQTg#GlG9Rk>Bfd zybYsV&Y2?xp<&zFh3km-a4vl;H#jJtJjkbT38hY&Y+dB)`4-^z1vrMj+yZ8=s5QU; zk&w2=ba}vMlOGVYn_s4!;m9aec2t0$yUQJZ(0BNhRRLW7fi6Fdey8=B@VWQlIrB}I zAiemlAbk{$i{Lw0U%o%pC*1v{srEJZaK9!qKcdQKqcc}#$v$_@hdlaCE<82(BKr3n z{VJ%kdB6i;1>nxL{5(92$%xj#O;v66iqO*L0e6zle!^lFN#c?kRySH$)P}}yAQvav zck<;1WzzDd)>|RG+AVYOjf4mB8<0d;UalKnKsKmoW}SDi?#o@QVoV!j?F4#zk(P(r zv0i~%VYaH9GM@5o<$>bVncHwMaDs~OfAWRUHGHgVmqk%xLzVjH-N;Zl()L zWmrdoJ>TWMu9a9#eFe)Vq}3f#Ahfot+-}k|!Ghspdta^nsPp3Yt7Fu-gTR38F30fD z!Fi|)Fztu;DRo0qp(T2o#UKG<|Cy8^oBWZ*%KDC#CPhgu=j1RyZFQ_7{xt8~=KV&_ zgNLB)X}c+genl#1SPyp0Z^@!Q0l5vt$$Z$5JRzEF$V>lH-At9WK`^Rd19MO&vh2@% z6%+rQUx;KlLdM21L(JT2E*{|AWe*gf3-3~Z){9*&eaNR;KDN904uDGqz`g*GjrAx5 zQt1aY8B}_^*@sHSdG5TT#MMmQ%4#XaUQ5*JVUAEye`93jajJGFT(a6R%Uo_!9&wb zBJ5LE<0hoP`7+;9TX5-h%ZIEF*8fmp`4ISeo&`>k& z&|MwYeuDRXd7Z9fZX7PheHLn`avYPxHX+lD9#EHmvYX&$Xu&a4;(0bQ(FW_aiw>(f zxIcEj@%;(5O!8%*E|@wh72N@J4}k~sIDRv3L}JI8U*4&am9tH3kh!GLuFkFMw4Waz z+Q~^B642b>yh!$-@hQ|AkmIdp@gY=?ggQ{`l;3gSElcA^lh4iSsOBYffO2nbwCL)IsXbKtG*$5JBRseRJo(AiY=C-tz^8fx(sk z@Dv|@)qjX=gqlM0vh}a>(^F+dLE_%7e&GG=hw$DS?WXTz$e8wc9ZAvDto+yjchM(+-AIqc_MiVlF;@%X1Ifaf zoQ{>51VIusIj72|2rC#Ij}Cy(oUkm;KuT8aO%_mbPgiMLz9n+Qd zwc81jr6)`CPH!k6nG?w z@t*UIv!;)B`E{h@V=i$dFz=VQ+j*o`6E^p!B2S&P)|^v={Jv+5(~KqgqePBC=GU0( zIe|blC*kP5#Tt6!dwN%-7^&WSU+RCj@3(`pPA*(BfTZcmB zyxd6WQ~&cK%LXkN1frFDp;g%0Xj>Zo_2G*1465CjDCu{Md6V)|mdW zkBJkhaoO$E7pxKXI)Kvxds)juNNAs?WyjRY?WlE9KIM!VHA`$`q3c2rpZEtLn6K}< z!%oqfua7o!Y&%29#TM#e z${#?(BqF9N^6a-W+4#Dw#2Z&+&fiZJZ+vhHW=sW`SZi*4QfLS@*8o|1o2|N`q`kJN zCy(ZXYYOv{wRzq)EJ2~>1I0Pq&xw|}UubEMWzx;eic>A?cY`xK*0pS3_+hkhSF~e& z%k~9_M+?6V^pnuikjs8kHv4*)z21wLRC3&Y6(!Ee-fv0uUoUTBC}YLp#l17fyTVgk z;RC~~x|D~Oj?1S_o4_5$)ix=f&XiKrH1HN)+(j_8bLo2Zu6cj)YD=QtQ&#(rRBS^{ z)8IssafA#G${#!PDnwenZT?xFBcU`CIQ|D~&55_68;S@dX`Hst zFF=*y*6C#9z?#{?#=7`&h(x;eZr1533kJ=P-L3g~G@oJVf*=^vAJx4l9bwoe1>@mu z6m1QJDg%CZ3nN(m(NQ@pZn_RTbBU}#380ficZs^ z14WDJOJ&;jIf`kE*D`vkhM%S^OR)ziQ}4lSIm{<%VC_?HL~`eI7z=;R8VZ=Eu~v%I zv0n!khwzC?mfMv*NJG11=fwPZxWJKyiDq*`Jx}Q7E2E7YR7R7%mC@y9qrL0OYNBPA zfkIH*54G(i^CsQ~QtoB$LFqepr8_odR`A_^4c4(FW#z40-EjMHr|4>E#B8kdCyaks z(o0SKCq6(8-n$YDRYY$>>96^c6VqHBSs&^)vcLgpg)FPxZN z#I-`h2O=^Jzb8?KncEbr3t;+Rk6wF7<|~*TQAK?ngz} zQxW@sT6Hr|+6y;`+-o&mf)3uWn(w+FW`?BZpayS!gGYFH4A7j%Lp*Uwg13q3Kh(lm zySxTsdoaM@?M3rKl~o9@&o(V+WIzUlXP`O@0{Z?5W+q@*ecv7=Rkk@~OOHmnnA6%N zfmfRsG3EFHVC)GSEiuEbcPZZh@`;el19u94<4ddaV>XYv6mC@q(s|_Zy~xY)U2?}5 zOK{hOpIg)rKpo-p)h!h8$JWJa-%y6I^8S^XAu6p>$k8LR3z$EWnX+3)c6Ml}`2z)P zhcd_2H+BU}oZl#^$8#MNmYYYHu*1rFdZ7jKPZr270`g3R*OOq;@m$!`tN8R@@Tx`5D==YA;<*lIY_Jl}vcaUsm4S~bobO!_kvn1@}Z_-{Cf7rM06oMiyN7O66 z=En!-MJwSo-y#O!@*$RnHw034YY3cgm^QQrl>VOLx+J_+)x3SHXvEr270&KTS`%L# zOj>HlC*_*hgJ*P5|2A8H*WK&?Aw2zp{GZtTuP@Do=aAg?UHu=9wEay*-?aJf-!1=nKZIwg z%O6ekiUjSFwEvcE|3|yEe@rgC)c31gcz8c0_ubXk zFMzMCD1fiAn}yG%Zx6fi<=!-qXWM*_>DIyjs~^I*%H>Z*-?w>x(Mb}tzh{3B`5`>l zy7G|fD<}Ew&2sY5?|(MEIY^(Bn?5?5J~T+L%uOGdO@BY=@7}rTU9#z4f=t_oFIXqg zU)TPJH5MOCEk!~7hv7n$O<$Ew|Hp}b`NG`v`?Bfh2kpNHn`X;jn@zttNMD(oK0TX$ zS^(eOE*<~Yk%fZf; zG`u+8)ophi?2Rl+?D#I!tiI^1P;H$$hlRlXeB3xn+`rO9wn zd$_cTe3@P#bl<<)r4D-zO(z$JTK>UzSuUHkr;w;Ctx0RGfnUKQ>6yvGJwc4N=hLNt zIRYqGdLzqyw~|iKSt@f=hzNWuV)%(tikWI03m8_=Vb31CLV_qo2ia2-xntBVJ)bKH z7Tq=CI27Ubni7iVSuEg3k>qx}>by|Pla`Kv!iuKdV~ysFPq~_&INXlU*9Bb|U!-mP z*l6m+{m0?ld}{yt&@(Klkt2tX^ltt|?6Km!XyNM}|Hj=O*@3&gD-?S*yK{m54P;hD zk21JiEK0O;yUG6+20OGytD@U1j9|EFM{#T=OZNQu(_T$E+dWd?cdy_cD(Ihidio6= z|0vEY1p@ushkuRyJJf&ArMISGzRblx=MDPcg*cfUUbH0-M6=LAvLfsGvweBKXhNO` z=0D(T&k_B4c^(Lfm4U(^4)^xuU1BGg4_crFhU{N(^C9Rn8nTbT>9Q971cO%EbS14%@F3^k`kq)a5tvP>~i??MK2YrLRxD+Cex#VS&n zTt1I}13N%znql6;iO|h3-V~N_TvNxT$HqqgyOHd=K#g^s;(esA$-YalDTYt_GXCgP zfeo>5FC0XY7j(R81@x&(REU%H=HS~TY-bOw9$h;B5S*;l(DL_+qlM?t=0;OWvX!B$ z&13XfHHNI@U&UZkV`0auL?j5c$Sa_h_0qWX7NJa1X{#Q*k+Qyon(bHHV#kK`Mp8KW zz6|NdpshD&-sFrIcKJpN`_MuvT3|05dEE#354JWgceQ8B)|-892C&A_rInlUU8r0B zVR3!ol_gjm!-|YEwJz~VIf{Xeuejc1eidA8pnFVV9Q>1R#ic>yy4t)A=p8Go&ncb9 zs$R9Q|R7gk-zEi$SxW{PA3HDkj45#_WEIMU`H?{~rnpjx|>dYsiSPG{y$-idF>cr0PVlgEXuBSK% z3R#%g*(G+MU+ISr{kKZh+*>U|5$rE|=oCqGu2d2|S57(6oBPGu1|(Hpvr<@IFb7mi z8IUc^+;!N0t2#ie|119<-)8gZP>Ws<+WH*pq_=a?2Z1EBTI;+4(FeM45tw)oB@<#p zB|AaeRVQ3yjoL$ff0T7*O0%XeHjl#{Q-~>ou~6zT7MQoc6;-dpYF$Vf_Ns7!UuUl3 zqQb1nx+b6)(aAaN0wGy#9CNa6Ft@9MAca2EOgg=Fv3mPOr7w(&k2%0Ms6^y5#I_Xf zdN7Sd@kAZZu0ci#xT?rvnVUnkZ|LhF@Tk)r6ZI83UoR0WCNy){+QEv45y?vM7m%hd zS~)|3HCtwgRY%eIqGtujxt)9ILb0V^YajEysKy0wI+rK_q@fxLGX9@gu;f5>1Ml*l z@|vv|3(yYYv5BudmYWY*3|iA7dI~_TGsgjxGY?J^B4>c2iPj*J*m=-Zy`zn+XnGwo zjN>Uqi?}B%M`A~lr{S6h30NflD~OgMy%qW)srI{4lP|CS-iv=oj_lF z-)6$w)TN4sN0SAqaK7JnT{0-s)FZ$dWw%f8s_(P4kvFp*2|q&;Xd2uay3WRnVn1gC znIhgj14OeCHip{xt@A!lbQD~%SGZ|-9)5aFSLefOb;u$`(T@ls&g+3T*{5X@eDLN&8@^H<5-mX6u|BGvN-)P!1WYt`ouh=f{BRz2ADCO(i4ll?1P@n+#W0IfPQ zT?t;The&AYYS(e_@IZO2I-K~vIFusX9e!c8`CR_UIA9Y4H4*wYNW16)#ykWkN~Tx% zjYKnJ@B|s9RY7H4c1CF_)UuM#+0uos^d;HS$C*c6Y566!&L=tC`T&oaN!c=c zyE4PFWw`&ymdVUrwuG#L>PVNT%;s4HRF9c6T%OZgFSnIW7Z@}6BTA8JwEOyMlUG%OeJz%qEtC_@I+^AoRo)zn}!exd$du6z3Sg{yNJQDBv zPl=;UQP{hj_$X&Dlrv-#35i|bg<2Ld^pN}EsVOtnfG#crD|^$zpN<26fav3F6dk9p2zR z6z5@%713MPBXe;fhre4yGi>l_qEPOpfZisxW{1ibe7IaA8}x`q>2$OA!KA z@vQ*%m7$g@0JhTf2iVMn|K3_pT2nh4XsO;idqVTeb0%c#62Vc|;%r^J%!}VL6~VEE zk;Tqr5qlD)gc+;#K8=KGFS(3A zU)Oon(d2v~F*aBTJTlrisjqe)3SW_+0%BBeb|WU0`L{*%NA;+vXgTE#M<ecu z03e~}{`O1v&@V({t+^xd2?zFHcLby2Tj zjP})}uV{Uds4@0enP#MiKfmiN!1o6b{rD=g@TW==>2{ei{4+OeKqG@ zytp zClp!pN6TIWyCT#R83j0D=HO2A_Os@1+abHV0gL4dfAccG4kvcy=af=peM$|_DfN3Z zPo*v)e`skzvM_xfERYNL+OopD^r$^PM&WGR8O7SfNzV%x9j-NWkLR$Yr4J%^;`@W* z72)lx@?(>;KyyQ@nt$?W2({r;*tfgs_=?820c+y>18n}n*x}jyF_+)7`9C9n53^qR z+sGgFD&+|>j9vJPaLw@p`O8`3EV2tlb17}B3b^tnm2FnpWMQT-d1+BSI&Bm0wN)bq z#3~dJ7b-uH;^9_8IpvuGY@YI&h9pKKsgJK+JYql^-&{U2s6rBY{rulpr?3``c5+?# z*NA80$7~4 zk$)HPZ-4&jdtR3=UGfVG^NNajDCnYB;P3pe3r3-uNd!D^oybSCXrRwh`^ww3@pH+I zvS_M^`_0_>HZ4L3U9Q~_t@{y$HL}R$VF0=A-~7t|F0rfNiv8t}+OKJDeqOvZnpjzo zXzz&4eHy4cGSj8-&lFR0O5I-z#hlLHL=90fjciee<22UXHv3%RZU}mP$XiqKLgBjP zk^#zwTJIhR?nq)c=IPjgj`mC!#23P=B2)Mkw*Bj8(juHYmg`xq=9rnTk$wSOhgFbtV;>T?6b8GXVlkNFvT`@kulpH{LBx)Y7pcX@3*n9JIi?s@%!PaO?B@P46mUsStW5 z-x}ifqc-~Ra~7KjqD9YclpuP(>BxPfi7 zvb1I~Lua~EOZp}16`KBPo04x#`X)Z9kZuY^*y3BXF|@Rn75s~fwGghIp-IK7ohCs{ zym@ZDSV9Rk>AZlRu~mJjs-m{4vu88kp^q9(e-$-Vm9c?RTPKzJ%2u-W73r;Yg{zX2 zYq-M2Bpartn<$SaSz}jo=&e(k$X{WmG-d^^hTh~FG%l}Us;X>2>w3j%uf}Sx<4RDs zcGtF!3`^Z=UvOxaaC~*E?8ty{D$N<6p}ro6avBA>J%@hNA$_YlTf!%`_l^ik>@q*1 zgq_oC7FP<3a=mh-mu_I2wE5-Off|HR%e}ChGHBWiw|e|dA4LWk1$to=2zxg#n)y}# zyi9@jTFdE0ale$zqbl`=Ev1!PdOMOpq*%r1Xc&jE!^51%B)<`xNjZaLUjCdR*{OX0 z$3YBtoLZh{aR6=~|VTN|rDKiwwPvI0LB-=rbX%%C{1_e!(hFX#oZkj(cFUERQJuq_&TLOq4Ty&7Zru)CGa@cYaUo;9k$7ee&!b{M!OyhML8U;<$?X##wzMY%Vqwe!(J#h0ds+xIcs8Es^9Ua9P9DNV0ZA z`Z@B$cD!Ijf$cVc=o;8=iy3#b90KE8@O|{o-VyOA1pl#s+yLw0tsJgc86hkX%N&+E zqk^U5@+V_3=BA_(!9Mj5ZXQ~N##iEzKj13&C@q&@!Bv|0Um2N z2qM8IsOr7R+q}uIG(SJ*ki5`xXWBjgBC--6NVO7cFq{KWrBk+Jh(ceX;1M-{REni$)BN2aYc>Bnbq8LWm+9*0L z`Bv3V&5slg%0!(sK!9b%MixeY)zf@@<^{Ue6fjMkvck6EcqRGq-Y6~^%`c%Khp{g-i%kXZf6Xihb4Lghh3kOB?*D?0`pqA z`IcS^1KOvSjF9Z;O~xIPS?3@cGPq3EZqp1?XgXG@OA;eXv_0N5pAZK7Sa?pe@Qe>P z0Z)8PU1C*1)BLG<@reK*8>hj%h5Ey-S~I7Q;L+u%$#df=|MhUIwvp03^;oekQkc#> zt#Z1sBit&XWdr+5E{>l*J$pW2H(dVVs!m*PqQv&R{Mdy)Lf=DU_QmgF7Dnm^-ULX; zryaenVrF3|BNgN-HTPaES*~TNqnW*T6G`?47fa{$Nq2hR&f8gO_#iMN4Ieo)kcRo@ z%QSrFjZt9yNBPX%YNe>-f8o(a>b1)|bM9Nr#3!iNiry7&J)b@Vp$r;bW#-RRR8K{e zo~_c54CmD-C_V1>0d2gZ#m#gVZa6F6JuejJ{c>G#-uo{W=luz#>F@lOuW{e3RndB? zpYBw;iv4|+Zl?^1-pBQ9OJO-w=m%Hr+2ONRhCO!R-BAe7Ec!r=YV&Uzwz>xhQYm{? zm{pTZhcej-uvYzIF?_)O5)pvetKRJxB4CE-P#1RTS$(~^C3S_{txd{`YAtOiN_9t* zi$o|CP2Z;GWQh08Qhd`w6nV||iTUky=t<=FR-=nYuCIFzw_RAO9FC84xyluo+s5bZ;cJczkJ?-O&nwF z-!vPs(}ycd3hFqfWaVqR7iC&^P@xkanGj2acU$vCo2^$-k8KB_%4w_EwUvIERi6*G zz*UouaMAs>FD8^&vDuf0bQ`&|D<$_J3ia1ZlXUz;mijl`=GII5_?$(Mq)l3~!d9h> zircr-T{vfAarg3N$C+L49jdLWnGtVCc+p2~v{s+|+1H_ETYAnaVG`(CpNe?o^2|&rwJ(HvRuIiE>-oAWMs6`QH1y140FtHx4o6c(%AfI8YvH(?@dGEup zUGg$lu{qHvT)iVcB2xWL`~>yBknhxKS?jHeH^PN)a-W$jz-WaN=>OL;qfIv-|I|iY zNT=vY)BMZwLM^&xFsLBgw$Bt#9S|U+#^llVvINCM*&`?fq1|rNe+f}PZnnH9u1ver zbnDIKjdmA%kc=mBo|*nT!X1UlmK)MQBd`S~9juZA2EIFGXRs z-BV!$e=@(`K@hzE)f+cWJgG&UWFhUzY77I8=1j{^0kNE6qLs zMsc>tfoj;7e`T|F#nUg570Ry*cbvkeJ*RLde@%B#oV?nFaApnj`Bipx&(i)ft?R>H zZILySlUi;#Z2F=e%R5W=D{RMyC-0r^>x8t z!QfgF`b9qyB0waOjHP%Zw|iohS$x_%zIhlWg*j`L@M@iT*5L#bYOxC~o%d$(mwuI^ ziEle%M+rxl@v_WS*6Y4~J1xIcOzW2K{RQehp0?f8#Q=ixWaCA+LsRs@u0UQ_2e6xBiWro6Askxv zVGkQ;H8gUAMnk5kl(QV-Z>2^r!OD!9aL0mf%uG${;LY^6wUnn?@58Y7YN&Q)@@AV7 zUiALS5F#y9k)<|N`=Pjcr~p35X|p-_2sMu(FG@@kHPw4pF>-GYJGXSf+(5s^A8nmE z`C=I%SYfw?n)e~UBom((&*Y$4{eYpJSZa{}+iEU@ep}Wa9T^^>iPcrF!CP4ILiO^{ z^#l1@xPi4mc}D(gi;W&b#i`pUW=lTrZ5FBELVaAldcBDVQD?mEz^H z+JxwhfDLy%7pcCibl%?t8qzghq6SZ)L19-Oa*S@49E2^D_73#Kp=rcc$MCm`^X9)@ zocA|=hw?jxf9LUhF~6-6BIdr3n5MSW~Raw8&*5kYj&qaz#&X(_NZ1 z9CdArb?w-ovMbrUL03O(Ksna&u3_Cb5bLXu1xU&BM-<0PJd9e&l1zUkeHZUt=M{L| zbum%#;xdI{ucYJo#LfdlzgP=c){Up^Ft)|E8#@Gu`|((ww}3VEZYAv3SS!LB zEgwfPdvY-omqXQQIwiR|8j8GBN0j38zE?;R%K8oMnZDNoiO?WDyokn1w5TqKAIc%x z(%1pi6)Vy8eN#)4B@POR!iFDMN!Lm|Ht06T`tXkh@=N&1)IpYw{Yq_EqM%-U(9YOW zoc9F(e#5^v_&1S%NBYlsY;f59jr=Z!>~9q2{@0~2SAOq)pV-a4EJcL98jMb#HF&FG z1@1FvmHv%9k!DuDjLn@B#b&c8Z4W)&oMbr1zp`*tGW1AN)ShN^QkDkpHSG>_{OP`I~`Z4gafmXC{RPMdca z3D%nlq-#@SWi-Dl_27=Y%G-$eG_PGlLP6F+42KxT$ZcWfUXEqwulfNclP3FD692xZ z-|Nrn)Vg*-7FMNDQ7d*O*)`4Rt-#Rc9p$epj);f^-$klUO%Q7$$#c+T0n zac;dyb6ulP@0vBg1&W&Zg2J%f)NSG|CiB|@DY=hrK=}3(xCl%~g zt3M-A@zi?nIeyATeHibxBAo#+GSgOO{F%$8D@oT>2as6~uc7bqT%JhF<_|q=_Y+SI zxRX~%HC@-ZsoujYeJ3%X5DMnRGi*?l(2}ma*{-?i#tb0A#SZvMA8q-`j1o=ttcxyx zx6nM!4!-Mctj@X}J~W_-`opa^*<58mqKLVXOj4C<+y$!fW5cbo;efFcl2NHl8#yZ5 zv`wzkyG6W`_t2Ru@&9F2qB$MVRM(J*_pM1zwR$cp>O*!VT9>-Aw9}p=NxR{xCC%@Ncb_H({wk{i7vnz|BAnaR#JHQI!U1#vJfMXGnq`;&aI zYE*A8zToD-5I3SPgj@Rqo4Rs3icy_c#AQ1UPA_BreY%k3z{hv_7{Dx<6mhmRJ^vgr&u_icY3IH2i?f}vyqcm<@F4$ zE)71-9^sk>PR;uzKIc~9=U`(Sd=^^vQO{W%OMvd{Qy66AbomH*<;&}{-^z zJwi9OHMcQy3<-yBd5&3|idi1ZL!Yb1MUZ&>Gdn-b2X76D1+fr+i$b?7?^q6;BQizI zoFkBGu~NR5#=AptL*d@4OrMtLNvdLx@Rk*c6{TovL(vc--WTRilkNDP3rR;r_)J-d zPqUKoP>WM#Q@E3kbWG&tOJBig6W*srQe!(zH9L!%7*B9&((39r7TS1t(ZWq(VzJdz zdxT(Y_sg&~RMK^=nLXcXMl}?RyGx z9C%T5#I8p4mqom_l1%I{qDV@k`2%GrP{k||u?n93Oee}sGf6o;vE3wFuy&->2$Uw9 z^$1+1n{Y|WQ&igZ=15A?npK$&;u&2yt!>yk{N#n?Q1dT@oeiDHfk7>5%D-Tkk?D5& zTBx4AuAa@A2b7x>xUE5mi)Opg?ssDo8FFBCgdboYC?x=%W%tklX#s0dohvyJ*W=5M z4P0vD@Uqs=d>ff1_C%{v@STLa-PzR=&rY+(*RyQUKf50DLj!CmwmjjTQR1!it}dy5 z$HfE>HMDb|xH+n~4VGV2@s67({nJ5NPIC`V^}E*9ga{bX%RisG@kMKkih7Hx7<*}e zhjH@29wysQXBB#e75Y0!CIv;YWOrX|wIFz1d_vzVe}C6hSo81a?ucsqWNCOD)yp=u zFX|CzNuH0DnjXs~I}#QM;z2sWf!2jwmJCijTduq0AqSZi$49*<9Jn3v{c#b$v?mkK zgU?Yz($!!i8sQ4%q6x=)o2OPNaSV;2>p}u(+0x8ky;2H>7GA1(kLGewm;-dN#XycP zy6t~wr*Lx3Te(N_i#g?mUo^rtE*|?Y`0f9H#P5@ZzM%Zy@XMJb;rGw~%*Ai#RU`i= z{Pykve(Rq7Z}_Ep#W{bf&Ei*Yx%iF8|Bv`(2!>g*AQGBz=jipd0^3QZ-6h?9dR@8B z(yL2f>e5BeKnRfxO0%S}@xD^UNAM{-3_kq_`Fr&Y^3Pfsy=>sIot+qMxmkDY=@O3W@riIs&^#|$NfPO_VU+NJa(cBOj#4rtA-qI!ER z7`_K$Z*MJa*3c$7ue*a9vhzFDuQgMs9;s!ISgq3$@7nINu`fJ7wAecKDXvMXYzG~$ zY-54gGcVfFHoU$-5$_W_O5*?Fd^ForT%rCwhsImlG6Tu|GP&un+1AaZ5I4BroZkkPL(~1#wp02Z*ZG2yZJ!6 zojS?i;HpFkNkw)nry+AoN5}>c@m@fkg7QRm9p+?e5&>vKOoDsJ^c!er-@*IY4&ahuM zxk-P;4cfnsDaEWMKDV1fWXq^)uPLRg{@G)F3GAIVzIQoE<|0=Wi$xoPr;l!WQm1Pb z8I1e#7=*;!lDq}`(y?!*t7GkSEQO3v^4UeY1GA?~-keRo&QCtcCii#APi2#@_mdAM zSv$KvMp5R=miS5UgY3lI16;{#vL##mZg;WCMuRP<0x3t@A}8az(rkc(DVxz+q_tRu!U%Md?4nPNJRXBEj+kcH** zSG2^D*Yi{yoo1Grhd~PzeEmA=4K1ERQE;|HG9A;3v>brgE1EjJM1!;K>H;=6$XWS( zcD)!{TGS)jv3%t4$Ppd!z8rw;iu6jIPM}lPr{vFE#*CCIJHtYQK8~;}41^uocXW+! zCHn!&{wrm#A@iMn`(0f7+)Z#gv-vtRQyC5>!)1Pk4~i^+b_sxsZ4vf}5)5@B_{`4e*qJ0;pj%g)cof9umh z*}Sgg()^nsTQ;_H_Kg2{a2ODf`ZJRiF&>lEMsQ0BzYEcGg3dF`=86n~NS(=Gd`h zV|{ueMO{4c38k2QKKYaOTxOSLwNB(umKki^;&}q0eT)?&mSvwjL18m=4u> zdI|PCH8F#7nK7JwmJ(4-21|kAR84_Ss|~V5*OwyUCk`&W2BO4*gZGq59?c1P%3L)_ zGt?S$uB<#_34gp?TWxGE3lC`BHL7JiR>SiUVKoQ)ig{s zft+>F=FZ=Kkjl+pTTpAgmr}Erhq(Z_&NBeDaN2(C*sKu3pwZ93*&vzr%YpD$keqqt zds~H55=z(flq!xWOkWQw`ju&-fK3CS4tpSQ~$JxP{CgGGj82@EFI)nCnzTI}T z4qEr{8sbDl%^NgvcNa9Y?TR$a?QOqAje!x+(arLL} zVnHe3XxtmAug*J}X`n87f+?m&`K5-fUbNn{jB=CZG5&j;cRG-o*kOJPwGEqz86?A; zk%eTsgXBa(Vo_0;-e&dHULWVtz4%gG+Wc!F-qv?a@_hxMCL%0dGfV8KX8N`3Ad6F= z*usw{=ajf*v*-(HF;zsZarc89y;$Qyn3hw>lzwGLn6YI=BY7UOGDpi5q+SB0?%Xhk zMjM8m6l!^!0;1X)upx1S4GcGfd6@p#pPOo0M!NoMHm^?|zI|7pJZCS{a(=D3Rm1Ad zE}^P;FJrh=#dR(guOD{eOJuI|-inQL@skzruf4va&6N)=Egh)^O~p&`uFUhe*lg9} zTs%-eY;H+>eWtIscd!ZA+sxl$x#%FJDH!BhOl;{e?7l6uL^Gs+Rt&2G=%E+lpc?JJ zW7;p zj+WWU#Lnm;D@K(x&F+?`=qKOfM%6t7V_5Flo7~}6Hp=oio2tyA7Ol-(0o_s2Vr!jG zJc_n%ng}r2_gYn?CU9}&y~b?%yCBsR7+VUru{4nJ(oFuncz~TQorEZpIctJ9`1{Vb>5lfb>2mT>bzM) z>b$v}6nW2C{1{bVAL^X1tdj8BXLb~2K_kAuZJ-aX7D5j-?TB(;XC(_0b`}s=#aqY_ z@z&T>yOF%sl-X2hFFXC@Y6-dY_CM2;g{0m=qEnhQdXD9@lw<;8*nE1D*lwM-!`%B9 z;Vb+UxLw$SIrzm;bS3-l(Qhl(Yu|o|rMK}Vg*(iXltGfQqA}5|T%}N>HH35*QpMjwvSW~0 z>J;mir}>>9)T3 zdw1rw4j)gjw__jQLM&;(t^8qSPf#)bd3;9$LUcRLy(xc5>K>>DK3liUUjdvrx(`BKNE3&GFtzYy~ z?r+qV1Bt25IFZuW-8vTh1iK7p_%APM@Rk!xa6ws}x4dayVMh%+t{tnR{Er#=6RXM9 zGEZyi(Vdl_oGrNJ!N&J~q2=WT`w`F7!XIv$*M-8}kp|haT9is9)CtkQ0YfTG@oi&M zM;(v%NvK&8L9VwyR{NJVRUaL{FkJmo=(;AphbvwJuxR7Ub%iL3YmCqf7&9_gM617z zon$q^mG#xD;!_l^a*g@t=T_px$0LDszrs56u>XZHt9aDeO1|V1l^n+T_xuLps3V5z z8jA+hSFC6#98(glSXoyX8BkJJ-41aiDh`yr({3 z*GuJ;HY?H&@!n@rrn`IZc%Pyln2S!Z+Js*aQ2_(QtG$F6X zy(Z+}f()9MOxvDzT$H{;yOKZsYc(7qverjOFI6_f|mdN7li$ z6)#Cq(Bh+jEtR4^hb}*~`|#!Qb{G?8sH<2G0nOWD8?4-%TL%}!+7&=lOu_mHg{Qs| zrDO&?xJq)joGGH74dXiRU(4h}T!&Yq`9P`wb7}Llw!>?p6|19#YcYTphL$|aCr(5R z4z=8Gp9*-oL)lWZ3$^|l60La0)`TRhPYtMO@SZids6KDC?IHEXOZh0Zd%c;Y}wU9WSq5zMxtGjNz=t)pdety%~f9fcOgq z{NU=<@%`ED{(q#M34D~*)&H{r5eO4jgQ!GAMI#!(1q^Bi5}073K~!)@QAEY1I)k7H z!AX?(FhI2`TDPigwfeSJEse3Y2`B`R-36s8;CADP#cBh%&Hwwm_nAppZ2P`{KZbdp z``q>1bI(2ZY}cx7*P1Tw%K?08XJBdpSK z;r3OxCXS2XD&JVtyNxI^od=1j$MENv8yloPJ0|GAsNe=gSfGUSw3Ee6F&ZukNy|kXU3PGlD5KU z?Im1gy*pDOHlXo!6PYCQmyd1p7^BB>is`7_%4Al7F2X$iYwev|gpIoMc`KjA`FDX7 z)IUj{SOucf(x6%Nf)$-Q!;6b9hOKeCtmS+aCD6$oAV($McCD{s({8ZiZ-{0L%gc3E zhs3E}yj-6X#1`~ir@lxM$|1RKhJ*x>EboUnVN`7#jX&|(JZ{qiH6vglW7E^ib(@Lz zdaFJ)6LwIcN~})Rzjp zn97sbzLdh?3_pRYlL~`PPpaU*fWq(Tl~k6~kgJEhd3I*Z(U0kc`#SlR`JW~8{#H04 z$>C`6ikMF1WUMKP_3ZbwOzfJ>@5FF$dkU-~SCy1yuBjT9hVw2?Vw!hVJYbUGO{i)H zM?Y-5I4T&cK~42bXKupGv}$r6e@Ff>~3DnqgT5P7nneRiM1SH{377dCh7e5{Jxvzy@-}r>k$KCfOCmYh$qA>&2 zkATG_N=K(lY@;*369$s)(|=KXkc#_*-lnM_0!?;pVW@UWc6=n6#*)dEFzszi7!e3S z+G7ywn68hgylzYZmyjJnw#*L?C(~{up@S9Vu%ad(ujLoMk!A0%ca|RZdFHy~WZnkf zd=--6GOu%g^DO;TE7!t@mw6Zmn+N?Aq}-&u)_g0!S_|@mva5gv@F(D57Xzo>N3DFI z`53Y>Ki_?0=f^zxTUY8TO2v=2~Arx z#or-I@-tZ}#{a3xU$$QlFn_ea$z-43#eNy<<%x{IZ2iEIc7gzJO?m=*aXroDvwn3N zwF~1}$gr2LY5o;Y^gK{=9S;_TE;!bb>gtO~un3^ts|`)J1YK;>P!j-qY!+-lO+U&d znqs%9+WAKVSl>a?W`O3KLCM^b8ErECc(rP8#Pn0h?sYgTW_KsF|H<2X1jBAN%eoMPg;PNUyGVbu zH90Ac_4YE|i2tPAa@iHlv6BL|vXcUM`l%?@+H_^qy0e{WGK)vpQCOzZ!s%e(6bYr4 zeftO9vM;X%0)v8e4JsPz*_XZMhjU{iMobZW!GA>`ALjI|I)vT?=p4~foM7cX?J3EVl8o(+!vdkSngwh2u+sA zL6aplaS;X|09>|wTe_=d+tEHUNh#9~WTL;}-k2p~W}v9>9xe}OXPak(0>$j0w#fvY zU{IwWCeb~9j3~wuM(-|-OYYCT{@D#L#@XfrD_%>&ezjTifV$%5z#K*ld_*?d3&a)= zwOi`m+pTuki!imX{}tKP*q>+&0`?N%iH%W!)5pzpT8Tfdk1}+&nt#1KVY?NkT=Ny8 zQ^^`;xEgLs)v(c=L=EtA$;Oi63)i%cajE|l&-ondT4A=n=d*UKe{|RrQ7q`he2C)?JHvmH|B9F;5Wtkx6vO`%=g^lp5lyDqp&U`X{Ilto`vzVQm#y`S zblN7jGsb#;zn$$}^3kPmr{v*&no8<6=lD5vjdiVMG=+;_W%6k^xq5{%uFZnuaDstzbE za4pRb@s7rEXrTHup4lUzQ^&-!Ut0cIqpOoEzU+Ly>NAl&lk z^9=21{;)f(edReGLbb2d@sk)g)Z3vk>6{=1uqM>Yl^tC4+w@46a_wTNiB!ETO>%T? zljAa%L!nuqKdeCUl2o?FH1$W&^Lk+Z_ar!R@TXu<5`8bF$<|RshAZIP0TtXsP%YAw z>h^I|He^NZv-|6{=t1*cJMGj`PrRKRQzr_fmufe-0Qa}Z2ptr;snYy~#%O5pf7OP3 zt3$30-A88|OE#k^Djzl@J2C>;g-`vj>iZCw`qfl;pZR^B;yOIViV>LQ!7|B0w%Ve7 ztc*^-XQY8=jk0ndIALHE|;?v8tc>CHHwFuP10XAkU@*|NRh!6`^VjQO1 zD(&^(aJ#e3O$Ibe9Qw* zP2Nhm1O4(aOI_ycb{*uoR=@U!`P1Q+$~tF8yD)pPFatHus1CN5a*w_{PIEd_gk*S) z8B0w?n*y;K@`$#tF*mqc!qaRG-L$l?)tuQALYdvjrt`9vO~Paj6JpND;@7E;7I zk=ol{-vwjMq{-$f9}ez-PZ3IR)G9iN`=vLb!R;d8$=}N|-F=g~FD*?dKg zk`k&_zoQ&-uet)fWRLg6e_012%UEo-;2eijFGm-hxb%zf09n!?KcTJ|`kN1pgH<4Y|8-g~16Yx_Q9ulINNdhh*t+x$+x zI8{M#(O~el?Q@AuPDlP4!uR+F7K< zBV;<$PdH5pSCDY7pD<7f<47p?6Ao6w2olcl6FMnj5D6pvgl`K;$R{D_Cp0TTI?j-v zFy$?c=&WpQ|IWX}(jpmhlWUZp>jjGGG&W>AmfO%I?5huUGxiCiNZMOEe&B895&%AQ zvecrhN@aP8l}oJWw;zC;yWeE3AIQXAZkxG}(u&}!kkoIJy8;=-vV%mK0@WWl`26i& zH*Lq$1!WCBpYXGCW_ZZYD@`Iz^!c&3o#IT55+z@2#pXsor#tC#uEf?7+{e$L#3O`K z2Qt@#U|ONzDx=8c1~POZ3! zT5&gOrC6@4-GyAqryPUt9`K#vdKK_2g-=Fzw;_qGl z6gMFI|Nb8#2mbGcDcK>pMcVUSC^ohK%XJL^+8g=3)S9FaFRJ9^~+GdzSPE-&_5&Hp;bT6qpL=AD~tI-fid`q>x)K zv&MhNTK+fIbB+k-8!oNPPm3t6&Zb51y}0fp8H%JWFI`R(VB4t`pI|g_yq|f3GJ7_2 zpk{MBI;R4VGZn~n1&*Zv*|Chf{WCG6*UB7~}0&MKfr&rh~?OOy5zbArZGN;;yzSgU?VcV|Zom##bGpj~++ zSwV65K+A5xzI8#X3c0;16rF*p?OM&P3q1X6%G()c))NdqHYRF5Tcp)xH4|^X*NwT7 ziN*$=_RviH(N7paR)osbXioDWnwuFZEH;8{nu;9detMY~?h;3e+}SBi0@c&CVv*V{ zrw0x65a(Ns=gb@QHw^ZzC+VGnlELOKGdw1W&S-_*O3pR zDbKUje_x3P(e~LM!2;E%@FKou-XIZny$KSwG%DFHf#EtyI9i-7pVGo z*!rzZayf%jQXk+Etg}fk`AHpHlYZqVW!a?P(6Q$Ee$tPvb=^i1^L#q&hvxaWF;}&$ zYU6#>$VWD>Eq<0?d<98K!ZnID0^vd~^@KTwfY9*^ROq+1kk!_F$#GcrMeHiqkjjd~ z)bI@qK_Bk!rYfxSGJb}1P_x>Txzg{&{_mCS@X)klVT6Nqx)X)G>qV8wbN)+Wyee2t zJs+jGsijJm4hrPg6m!Myf{3qo@lC$0+9#!j-NLVQirO71e!T99d-PQn@toHhNV3AX zJ@re4uk*EFi)1C7<_QFao+%gWKBNTRK}Co-&(02nm+ z6>;*oPhWF2#d<#XJ|LGoZpgfpJ}bYiS9K+QF^m2DUb}Ce^SKD@T8Fd{?gn!mj2Jog z|5aOGNo;a9c4y(6WbzZJkyzB4&!Cu@bec$}gj7Y}1r|uwguQWrGpWYl9MdrKXP6cC zURb>_=GU)zZxu9h@z2I@TQ=mMGhB8aF*0J>lDU>a;!YMLf9!vR&sYY7V2o8!Wi%pq1TaBEx|3*$oHL@&}xyCgzK>0`K#!mQ`+KF!IP_QGY zqj2~pdkoh8s|^s{Q<)p$d!%TH5URzn?DUplTF0&py35=Xgx&s%cAZpYjY?~0FB@9?Oe{-UeC{|| zGwMc)=`>)bF7a`=-S2*vW;Hu#QYU}Cpk z#AVubC9$rl>*^Nkx1ab|4rWPeu1|CG;({rIPeUz z2OeioAWQ#>b?n~On5LUqiegLqLsz@)=u+9UvvD@HbDPX(9`!SQ0pjUX@Q)CciY-)O zqW-7#`Xs$%6AxCAHpt@9%eIK{wBq^JRxA8czf6AhTWy=q4Dd5e^E0_t8`Nr!|LH6 zh|VqP`8?6z+lQFN8K1kRT+wfuEdE@8#{}Cx&76z5dd1TQVT=W61M^$%l|JoH(}hf; znVYR4ml&z5Ak!s-cQ6%DQMe&5o08B`qOJD$qsx%Js52~h~AN`9>{ccWc>*o#UOxlHTU%0w{mNwaI$URB6OAWN~vPPS{+kMWUr$tizN zlG8}O4kD|+7VFlU*TE8SNLDTa(GK$x2}$~JiP~wU53*zN*L_nf<~#|V5`7qy{Mwd2 z`1#B%KT~HvlUu2ETB(Y6rt)9WF-so|4{hj!&M`h#Zfb3HpkK-c923sAr4N2Sqw6YE z_5FSou2rK}w=-?}bQ_->VsBz`HW3BxRG1CE)Lv%4h;r2Fi#fujFDOf;8`3wK96w#G zDVz^Vk?FmW4+a*W({2-Sv*wn!+f=gaA?Bl>9at6ww#U-$7FxL3yt}Nl@~hO!0OT%O>r>jS(L-yX>UvvpSSn zdeGXFae{R+E%A1m@wQii`BFRk3o6`E^WZG>bYGAJ|ERXa6e^dsUV`=d!pAZ-wi-$@jmB5tZ`0p#u}LD-dhp-Mamn545BBz1pJG zY^!jS4bggA2)hw_RoU7rU3sToS?Q%U#vAlUK43+<}*tTvO?MKn|o|8`}#lT(>?RHb|kQEQbv&I(z?NbSf1Wjglf15`VrRev|jMGoO)n zhJf?0Njf%Tv-MNn`o8~^RQ*m>VS}!o3+fiC+kIWPhqT0|5Mh>G@N*XcEl`~f$&&~4 zU)#CuNrnWNmf!}BIY*CXk-gBcn^Ew;Z$Btr;a|kqVk!{N*FkZ$R33i-fvnJ}E?4L# zuI*vvhvb~I%i7EzuPABLQ(DoauK!7C&C6SL{YJ=fnTis>h~RXp;RR+@zqh9ASFw>I z#mL}p+u$Uxs~JJP@G2>JJ-dc{wARtBZkf<4MEDwWeg+bV*PHuLJ^hy1!$gGNW=WQl ze8+0(drIDbzD7IwTQqJ*HdiAvcM_wM_PNv$iP;NwbK1*#VZS4iOsULU;DED2aYWYO zfmlYvjCa0H6bqfd=VUw9P<9kkVif6$M07a0@J9Kt`E9bbgj?kv(x7aMxT%&*;5b8yIm#|u=^?AI`cZ;T^!XwjW!}F zQmiayo}GB0@~|HEG)(x3-i662755YXt%(>$kE{x!%Ce+Ma0RO6ya&8``#lzETbS(9 zJ7%yQlY<#d6rEmU&P>zbrn`CS_+R&E8zb^72J+8EtJ>);wwjfpl(_6HYLC z3iR+^`-U!uISb$BTQy@g0pa7MbhMbb{(;3ErPfQaaGk`$bt#Dj1MyByU>MJ2Zz@9( zSca32nZ4Vh*+8N3S^o_%!v*m!2v;pnw#F0#DEcds_zAOTxqyR#Y4d#kk=n~2Pbl#{ zD~jE94#srz}Ct!Id9n+y>$`gVb}y zC~?FIR3EMf4yzM~Y!-FIlmKtu7CowOr1E?ahNP z!^14Ch)qi`I&|iGF7(JH*W=_0a{Si5HJuEW%r^&UghEYLc=5Mf27-Yn;$y=Vi&|sV zUnq$k>onF`!Fu@>pJuOG=~cz8D_vo>GNS)L4beFR6+!y!kIN_R#PA_@>XHZ&KqMn0 zysuG>mYl%lnK?0hB=s!aWCp#7en%8-x?P^~$lOwgPv}yrT9#2()H3sRye@C&5b=)s zd_oT}b8}>Z|9S+kv61QVv8mqs0%S}9W>_o;pFm^%htOE<8}j`u??0HXl=mN`4)rfY zoiM=KAyD@e+O_a-JBBZMxanCY%eiPOma)IhiNE3K#D3u$WqG5Lb$}a>2U>W&axGJx=f$2ru9!r z*3~4(Y`$Kp*2iR^!ndgz{JzY{>6VS?&9c$1@tWo?-jueQMh`3NVSrmUWIB! z7|)o5_QgW`kk~^MoJswEn?t4qG;FE);F5Xcc?&M=XM(Zf4iCZ(M7MPyrd{R|;tn zz2P^Mn~h`)mCDF$3Gpkl>%^gK+|{yf1irWl%d|)nRj~YkU~cL%*GE$4?>wK&@MHVE z{09q?vPpz>--4`@!?yKJWg|sj^MUCO7s6V!x)2yX>7^j5g#RIRdOsVa9TKQ>xF%zw z?KPJPNl4aw9h3{`jam-$#&W-`JGum_mx#85#g%+~c^O(!1YHw+=Z>S5uNL*V2*91n zh_6Ycr@4$!j@HkhRhH4BYAHrlz_8Zl_t#k1E&!n zV0FqL7!^H;Xsu-rFn@_?Sb^#;e&xZxAz`AK?C52JKCSUs#sqAi#dRI82V>)Rk77X= zCb-XicDU=p#1cCh-pY+8$VBh(i(nd7u!Py5C*A16!3o7ESQ8>lLCt2|nQa#YS*<)X z)bE4U4%sHzB~#6ZvP%w_p^C~vla>W7-Jl2M`AC%-qg!SVpB+A|?frC#2Ft$&y{3(y z2fY=CuPj;_fsMp0p@8v>rLtSWk=uQja28UfWIPl0nM#=s%zj-cyViUb7Rtug+e|D( z;i*64NjjC}%Ki1&>hE{P|2TT}tr;Yxh|?!dPpWZmkY#pKwR$%e>tL&iJ5UGYRAWR64^kp8Et#x2y zbjKh8sGN zXLiutK+V(q%UJtU`&jCVg^USOm(E12rT*|kr;scy;w9v){~iA%-C0-MV)c91<431E z$E)}xA3S6RIKt%W6j}ds&}4aWo}OV?%WGd%qh{jObk=uEbcO4$s z_odQZWb0pLK0J;#V?CStyY4Pzprth*&%V^w9_!h_XLB2g=rTjKH)J;tWw*Bj7ZgsV z5&*DqNm~G17eRUba4RY}sYLv46&Of?=GUk~(y7{~`d8Ts+_cokEoCQu?qnbc2Isa; z;gcLU;spFyr?cJ{fQflhSUS;Zb^oBFJ9G;-KcnH_CODD_Wzw^4Q`vvL(TcwCJt_ z{kLz5Gjyos!=4;P@i>O7*)D zCU8xH+tvOOYxi@KQa~z39bG5lZ?-*Y%gFf^o`v=&nt<(1B%h6;i}b{?o;@33%<~X$ zGoU%IsT?Z1rP156^6b`x8oGhB(4+!sq#x%|c8?+t@F7!kFwc|X0eh2V7MTca+C`Hw3S-xrDNg=;i=;+Vy6n^u~RGPKs0S>%14e|tS07${WW6SI{ zeLgvEot?Ji$I81o>L%^o$2)JcPk&|So(Os}_+vRVW3Pf>*c;Kq`!3qBCc0}~;bjlv~#Fa!4)4F||a7mGXnL#$UGez3P zIgh??6X_sdssnki8qa)6p(5{u1f{2883n4X3^b z;42T5HYh?@zBvd8BX7{%Fv!oE2eQ|~}7z^#Rc{|#AY*Q6PiQ-sN!3iN70#`!Q{jn|4 zxGiC;wA8JHh>7$1P<4f8g5H;9mj6#V6koo>$lwdOKVy`Gd&fmi#V&QdKa`XNx=kjiqrpXK*9<<+dyOCh+uV+kBarEv_)cMkb@MfbX0n*BAwan{`_wEh;#a9MZY~T6ewL5C|zAz^oy#z zPQB9t^Az(yZ^e3BAO*F(0`x7w#HE0ob*kPRr?XB|VrwuqV*9mCTHaSQ%Lt3=B8LQ{ z-wwV#hfi93S2RCDx`1>=v%Ks|()A=Q0vQrynAkj%m-0ynGqmWh2u8n4kK9xmnCT8bLO#jPJx$h-0ieaQ>X*}@D|-QJNXX2EFF_XGx%9a)z;jB43& z+x7Uv?nJy--68I+z234%dew`jFyfM;b%6yJ(1sFB$KLd_R$U2ZF3~71qRS^Fv_K?P zoJwyqX7(|%6rl4bBvxcL1@Y10^Hkmo6i>OEMck^Frcl&V8^Xa|KyS zGn){|*4^8`?4HKm8PUe}!ORuG%#}NvGuJnMn~_@79qgK(67Q}tOo(^Z&pG%C@>40W zADeg`bQlmypgm<-wL#mWuLAQ%!G{H-Gy7-dMXn?G3PPvlR>7Cik!~XKo z(4Lp&x^q`x@ma(eeD!qm^{?FWLTH)@ygE8P7(44#JHP{jvCa!(J?v7^!r<8P*>k%S zMZcKi)`mhl^Wv7q3A~g8u42i5``V_9zKR@Ba`iuRyKuhGi3QV(Or-s_ONN(Z?y$1% z*ofu%&+!XEMXBgOFrs@K4z+g6G$>fb+5 z^EY1AUY|fN+zpN17|3PY4F2ktv2? zI5QcN5H88_pUWO{^quo%2c{l=YAL*EpngYobXUhnVRTs5Y>X<=U080h&@5&#F+l7Q zK=qfI>nfZY>VZ}QtAT00d_=YQ^-p&7!)I-?%-a1ZJKd&}JTH{E9Nzg^-iWL@ABo`G zO`>R1xM$5~3oQcvf(oUL)WG@Q^vec8Hit8IZgL5(J~y702i@7eK6YU}bj5yg4#JHaJUu0@XKgz?;B zCw;h*ob{gq(OBp$igz++Tm>__f(UNN1D1MYxQg9POGdcB=F=(VY6?-u6zZ^>A-u+S zrd!*Bf%>i4H@6nJ&J{ShO@Z&tR?dK_mdYm)`fp5j8Ikv<71VE~LuyD;I2ua)skNaW z%`(82GdMQ;8k zZAgJ|BPCMs?d86wK8^w(efSQbV$Bm8gnHn=INhwkeaj4nerS^$pwnj01$01TEcQ)J zUec~tumvi}**Q7m$JBr9gX?QIyp|VQhxdbde3FkU_M(s_n&)DVIB}>j{#2hj6AT0_ zuToA>-%T~PPIsg2)#hTV&;g^^Qeo=ZIXX*t6VCCYjo^R0Tv_b26w_t$v|T{Heqpb8 z=b!$G-UVjZ-@GBl2A6#pmS z?3r3ND<42s6KXYx4pgo1LFwn;YTR_Mg-+Qd!`YBKuYgfG7rJdAl-yq#v+v_|1@=Jd zMPG?PdYC8aim!Ybv%EM90)tO8Oo0xH@3gby8qK)geBO;~n8vk4K=sFU^JR>S8ry}2 z^>u^0?5w2X6N!kfexS#}OD?^HgBt#L=g4-0a~@(+kvLeriD_X0T<8%>KTdUJBI{)2 z@mE?g!mY1Q@3AAS@YX@{AkdMc>bFseQ1Bss>F2TZ(~>-b^KY7%B6+Cu(_q!B$OPJi zGfQeS%4GCm@8-@yyOJTUJ)>pQ+;ls?b`6otwX#BDh!;lUo$V)YQ}gesrb?H{ion{$ zvRD}xzmyYw{?0jS1INajrebPF09WiA0^>IX#&4cHB5-}@T+VZo0~4Dj2QK3;zFvvt zxmil$qJwNddDY~=4ey4EmfXYxc>*^qnH;!z6JO)&k}nj|%d8D$MU6M-YJcjSON_!! z>v_NFtC|ho(!hNU_+8((l<}U%P{yRs*;+;4IJQKNOM&ebQUKe(e&0#}zB7+q+IID_ zT{o2%upe#?kAZQN(yZ{zSXTEwiHgj|;=tkr0lBxPYr8yBVzz>fWd$1+(qM6-LIIo; zD~Bx4Y#K4Q^FfWxmezeN%@?XU0E-b&5ClZr29s>>5EWp2ZtO`+o7VizpbU8D29aHt)?6n zY5o1*4WtC}E3M+BuHc}>bE%oc)U~6hHox#J_q=j%L+Rknvg5;UhdmvG)t%&Ey9`w8 zD1t%~JdGSUe0Jc@cX+qNlpw&FOPci>d@(V+YMPTPxYR}!s*zQnkEUZ1<(xY2w6`7# zNpG=8y1^ppX5neyYBJ04?)uJod*bT5q?PCGjjHQ~rl4qiV-hoe3Qd>XoYxv(19Z*v z(RIm9|J?ar=|P)WqsX;3Mz^KgzQ^6wGJwRYX?63=S!KA6K_5nwbt$GA-LX7MFPYm{ z>_j2L(9920`zQD}7W^wqlqFX3ylTk$lFTKe=4N&0;DI^+hR6q@^!8Q-D@4q@WRJ~< z8L0~a1T$@Z5)ogTmO{kBV7+$p5C`b|ptr=L5&O9Uk!jPBqZtp|V z?2Qc4%}pd-3sZW@BSmEk&AXeV51Nj|H|O_cMUnZy`_gIJrE+?_Fld<)XQLYHdF?R_ zFgDLtR2mC*HrGJ>k)4Ox81u9&I<<_?VN z5WDg*q_CMSM`x@qvyUZv|5E?y8pWK~G+KY#FV^bEm`8hpNzAig$EX!Kr(Nw|AxKL^ z4hwqpe@XGsQ^MWm$Tp^md%qJ6xN{C28u>C%zq7BF(FFCW!a6HU;@?j_bAvunlTc|E zhDF|ZszDe=Q1dO<>0JVR_1tc_+O!5pJfLl>_B23vZQdbiuSfzZ2xpsv-}^oho6tkh zLk@jK|NNTGv!;h8#kq9ou%i!7TZjcnbbI=Yc4gkq_#x5ndfeW=%sb(WcsFV~jGAKO zzAy*;U9+*HWmI;01S{n;bGgHnsLeyWhI>q2IOkh8yfTKjq|^=XpM8toi3G4m7RBlb zV+XuxclN!Ka;P6j-tvXcZF?^ptF2C7eX*~ve%!O*Z3$+>BD@<8!rA2_);{1FO!?~M zL1j+6RS-EtHW*(&tyD$NF#|{q)(zC$VZTbcc!ciC8cpfBk~_9f|6EHoD`q5*5EYB=?r~+ zldp5bIZtPYb6f6EjLNE%pu%k}s#^ng@N3Zq1NXjH{ayE}|8J}@s-%8ZSxo&Is$Y#g z{cr2P|EKCdVUPY_x>x!-`)qolJ&hg*FtEI`ttu>efj&Z&%ygnSDOaUN?mCtBj1Vc z%0NJ*d1bz$v-oAT!NSZjKSy~DUGF8u_$o7rH<4TKBn!k&Ni;&V)D~_wxee00 z@!qe!s9?(;lYJASwqzx(N?MnHvdh26dOqOxgWP&v(O)}AR&l6tOI9c|xvY1xtWWOl zFY8|KB$svF1V&_fx%%+K^wwJm4VgPCGb`^P1jhOHplbpf>`s=go4}&4O>kZ!_Q}UC z=Wl^TqSYSll{@{Vj5Cl6sCK7?A)XW~!pDTX`?u&7@^PrCVuxUIde$9kb0F1dV@VeB zF3r{Uhm4T>&Q7zymIX$qFA_Q`P7Zmq;c63Mj%sTOmXP(Px;pC+XYG3A+t7}oSz)NM zjBG#KXpL+?620EL70lRZ0XtH3S+~V?<98sK~mUgQCiFC5oW9|ds z>g0lG*hSc~Bs<)rB`QMGfe&I}UB0&1wQlE)Odj$w^!E$z&ApjpdZ>Rnajs_1u# zNOzPO8s0-JJ*@X2!$C zW5!@@xtsQ?E0ma+YmY*E8TX3h~eNJosqf_~-8)jrD z!2zl4>{-COT3qw{&@=DnYDj|d=oU?trF~i9k(#PbElYC4!`uqqW18CAY2sS6hH!g3 zMN2h1ftERLcG}z7fef(j?fJsDm3}f)tK&Fr;AU2T$0Lm}FM z%f>1!Y=qrxmAR5HD5F>)XXTp#nFuLtwqmlK;&wX#C|zlff3*0<8$U7rvefub|F6g2)2r3^TN*orJ6Z^|G-iqDx1oN?{q_DkEF?U; z=h*#wjwmj-xLCq)6?{9e?GoM9E;7hLH6tP$5$y(SxOtw1^war~E=>7nPV8>E19&81 zO)LEr{P&h*T4P?+Q15i> z=nRRDo=}3nuuchi4;XcY;V^$|%v;v~LIzB0OxZA>m|^v^N4?E!Sx0UQ*z-dh2)e!N zh%{(Sa>womsK7nZn5sz6x}*4A>f>>wy|vPJsA$&_@fGA69wL*;o#W3!NUWvzE~==S zQdp*>mDM`<^__MhS`i`#5@%^O9iuaV9Ksh}l)qT#L}KXTJzyTm)z~fO}zVn$AOk>P7U~ zvzbeV6^0LpuE?#mZ@!a2_zK_3EYdGf-`t_3_QfU&B(tnF8MkJpxwg{dmulx8^l2hd z8&#%~VJAn91&RZbJroSq`ZbspGg=EC>1x${ztAQ*Ff5W6PL0nFT!X2906~bxdcQ8e zw5ForD_Sf>b0Y(wnDytM{owYv0yZJ~pih9xbQ-b4?2 z@eOjD7AzfH--Q_QpXiQ*?KqQddxOjcqeVa|S51uIk#UsNT7roq+pJ>+)xhFVx&v7T z>X%@rrdm%}rd9LJDHsV307Odg^CyX@pjoam}S zINVfH8_6?+-oP!ZA`jVKOp7fPJMr`dyJ1)a{L(dAv`yxaAHPqW`VwDfpC3MR;2c%5 ztK%&{3oY{I-FaiAJ+ac(B(_F9wVWQmz&&Kd$GV5Cc*s3u$4_?;x$%?SLvehdd&rOX zKlNx(Io$o!`Rp^1UUO_^S`cw&Mip1_mk{QzHM3SFyFBk4SW1p-wR+>=Z-HK-YMtOk(a8X=TI?M%gAj>?h#dTHo2Guj;FfZc$N|+Ww}c zHTwl-$8ek75w87Y7orYdC%~@)nax+Q0rZGn-z+=MuH_>9%WY|ImFs7|`TM^ty9Ot* z%2b{pSXlD<$u67h<91qpYRQm~^?$Cp!u3UP{&!ukf5=~9C%F9C|2}`dtNtp}&Sl@_ zL#AW&_I$+3|In+&zI^lI3Qc9cuur&|l+OwMJQXubm{GY~uue2*Cuq)4EZ8}#Jugp- z2%K<>NFI;t=WLr@1=i$x=jHj2?dp|6<`7a*twst(#yXM2k7f`(fTe|JJ~I~>pG|w> zX}jtjx6E#Q#w~Me97M5Qz_c46|I)6EE)Zc;SY@}-gZ&;SO7qS8P03Ns8w`R9g&j>! zO+bA=fsl%}ono;;inxC}19EIs{uf;Syr0TX9=oisAs@?H)?$Fs!N!{{oE(oM>7OxfK$a9Mv_RAt9I9#jyO>RJ8*BU`O#sRX;0?b(g7q7cOmqw zn2+W7)*_@Qv5Emm+B%vvjJXB&JiB^VnRRT;j^NCTv;j_OBenhXF2x|8YujY<>VcyESGR z=0%o$LkWzQv@EeD*#P@lp!ySv`ZBVashTB-w~|$_5;^FG2xwl(iEu+WBe5ZBWB0cc zZ|prT*w;KEYkqGb&!Oc}CFwu&Xt8kQHhWM!K|aY|<-}xNh$}asJ>!75A^7quw$trS zqSN(-loT>GVgP|KF4u$}w-0&dbo(%l7{u*5lar4Kb0s1$_mMaFvV6$-w&Q*)qJxed zZD!g^X1dA140#WI%Ys{cF#c1{CSC1B?#6cka!}%hvPy=H$$}%JYhExPJPmkf=Cl20 zV}Dqqpi?aw8Q~lY)}$tcqim$FSyZgJ*tk~h(83L17-`*Td~Hd2?Nj}$=qU58dk_4( zH_pLYTr2N6f?Mf}XUwnMqomw($!~t1{Itc~nf!#Eu$j^NGTlt&#W}?Us^!=Y&?~$* z%6-=hBI*NK;c$MUQlaLm54L&QS9oh>05#n*;#ga@&9d8emPEOD41Y{JO`zsuKampi zT=)9>`Z)3sePN@rd}WP*KOowccm} z8}r&Rgr<|g6UE(mWkuPMu_Sj6Lg7ixA~9I5jgXKV8vyfp9L;hON<$8@XOe zjy`8_Kauyk;sp#X_uNd{OFCFrDJ&rSQ-1b?$!?Fn@i*MbqBWacf&z4&Z?k|8oupDW zULZ%KcX0&GPm2t!zlLt9r!}s7U2XS%!{Xj#wvVt28)~ClL9rzW6=j55OVqj&9}@35 zHby1BGq3Dh;=@R8>eS;`jEz>0E2=(d+wlSPQb(Mw5c$f_? z#r)jnntafC7Z}hRXBaih)52zhEAT;cj!tnH9-MbVuzmmm)ca|*i zyO2Ft_nuOVlv+Eo(0QIl6d7R0&z;S}X1>QNuZa-9Az7_JE%!#VVRHN) zUuZtN6$AtV?{df1(0CwNw@ob^ZCkjxkkOHott}H6?*&1mO!+B%PM-Hg$W6gbK2jr$ zToL8~E=^`+Q2kUs3aNYZ>kOBM(d}4hi|I{2T^EbhO2|iS-A)=gBvsB?7UyKC(3qz{ z?YHBv2kQ=_HsJH+Le%a<}*ubQRlL&}blOa|))dx-73)K#7>5u_#ehmA?|R{NjCnz=apqsllTI$#KmA@ z@m}+v`VKw~5aT6$YVzDTb-=0@VN2oD{ha^yk55wkqfAc5yG)wkmAVG7-zoEqvr`h5 z9YHIX`>mWw1F_1}nL>7>?q-N>qFGpo9=_PpiJq`x<~?8`a+u8v+g-6K^AmQ8gxR^% zt@bPQ21EL+|Mg}6y^sI?jD4s0-CBR%>ez&IGn+?3#V?S%j`q1SiGx4KjhvY}wf+Ww zL0m&e>G$vM783o6o#jM(UwmpyQfwCXrAnPOeIq}Pd_>X!eGm?;HK9)Gs7(m3uyHt= z%*SjPv{LW5)VItx_t7g7o>4#Gbk>+{wjU8z&RJ|VZ<`G+N1&!R{fW=9pm>$RsfI+u zg9S_0?}|;xwBs*YIvZZ&tUR<42Sdi2KVu}O+X*^J?4S|i+);&S(U&$2ecoVuLb2Z_ z+HV2e(I0TRB7LdnP1de$@(kPLDjSa##Ks$xL*MvfGsN#+b-pbnX6LLt^Zs*o@~S)8 z#Is<=0nK`|_-D@1;u|~Lm*$x(>88COe4{Y^0sphi)7?0@XCznGo`Y!lW)UZ7jbgF= zyvBqI)qCzsvA<{Knv)-}Q#jKcIz(RefYRN+eYbqXdyk|@J3^Uax+~pF8aw;}W z!TbQuSA1d$`}q}^t%KB?HGXk(Hm!L}n|GokaK_m5;53)^5oyU%&r(Y9iENvMRBB#k zKdv$NKxozLj;`05tQ!Dm^HY3J;hrV~+&gY=68Aba&u;tuT=%_8>iaJ9`AJ%<&6s9e z|5+Bu9{ks{Q!Ht)XIq&MLipC*B?41c7_8e$b*2pUA;?`j8V(O$5N+(OLdr<6&S(~6 zJs-FEkO#`nCtk8z3DJnQrlm%Zs{2 z#<Z7@sP%U;y&YNsJY3ZrcTrQ8S1`AgT01o&od>H2AL$2#%3LhqjXA~MFx%H!{P4w}%<5C!)4UqMn+=P9}!Llpt zXptsb3tA*uMoT?fFFHqHIf3sCf6&cK1&X5X&OA0L**ZfQZzWszYb4$sP5el(7$oG+ zG?jml^06@wu^+wx&d-bDXn(_CZ4x+`mJ>9^JFpyALhL`#ljmEp%spy7egiW*0Lypk zKMc>&L+YoIstOfLfSN{7ldJb1@&8eINp#jx=-0|Lj!eNiNkHNjh0e0?lGaeP14ZkP zfbhJWOM=KhgZEiI9p!*x zrKsD~!v$@76uE;QZJ;*SqcdHPl(LfLNN5#gun_+zMf;jX*QzX_1A>owEgkNfBBx{U)Og0zyIHj|Ap2r+~T@$qwT_j zrgA@B@W;Pb`&-(!zv6$_{_58Dr@QudR0#x&%(~6@tE@a%U?FT!n zqcHI<(Odaz6U&RZik|8_VNOqXvWnJ63a|$b6)nH%LlN5nrsfzi8*t)HY9mi=WWs^6 zDVD@<(Ay6{O=@@~zsohyLd&PJije~^+@WS;4h~w*17vPJ(JpLONjQMS6^tlYsaSkX zo)161)Sn%DK0K1@I#Qh)S|Hd}mL<;>n+N)nuHzwd6P;d}#%Xs3LsIU0$xY$avxFiK zK+IN{XWEnq)>)GQd&-FQ{4Kd&E~KP6cdUAxIw8*IgKB%wwml=s_gqR%d!7(I9fU)* zxyZDUM<&j$WH$N*>wZN!7^~4#Bl^C)VxMvrFj8VMjD6Sd+n2Pi-}U9*gy}e`xGnYv zYA%h9{CC7lwz;T)KGFa(T4zam6d?2B?Sjlb=H6rXT|9Ket{;EbsZ8}k5n1G!vQUZ& z5mNc1T}@4DqaSV59|;afR3XA@PIh%O^-1BLmd!TGCbuKYs@d&G_7zqF&AuQ$5j5mX zU}gS+>PPg^>rn2^brj4eqK<;WXN(CIWkycMW{XwQ2??>7jG`uvrQ-PAPP1M?LsfB- z>r8b@eczY3-8)n8dC=Tk@I%64v$73jh>Z9azS)ryQujhLmK?TXw7Z*NVetKYFeZNG+r7T^K)wZ*KKUen^2Vcq+jZQ zqw1v>Q{ElqCDS@GQRGvKnCIH$-BUB@u+HZHhrfM!jec!x>4ODVzww^YG&%^`p1FG8b z-F9IT)MW%+k{iZ0#ZU#c!C>_j1L>L8PSagOc~Mz{C@Sb*Tu|DH#1$U);6ge=2x|Tn zIqqRv`imUza3)BB>ZqV4Jse(w=7J;i4SS}3mSjV(!(;22C=#1YMa-UTaTq&~V=C;` zYSVF&4O2C+%)3*~kXnI3f>c|g)TrI;kj%)b%Jwpy#^8`CT5Gxs zf~_z^#;5+EQZ&c6f4;y63JwztDCyKd{sGO$)b8t_e^N3({MFor7H}(wi9@so7142O zKv@Fs3`bA)xWB4_4x5(q{r1|OFv9mgsIv>$V=dLn#ag?CkUNo@3q(B{q4 z73^rODF}f$lN1E8#<`1Y5yD)9w0%s`P8~7p-^rz1w8tZ+i2c8=S{4y6c8?Zk(Oilw}h52#~cFd z4DJ7kDL7lA~! zV$?bTkCby@`YSsvVXa-H9Gw~?2bQZc8|);0cru;#c(j%9dyca5J3+tngI0&JnrXF7 zd{@_WbY^uWfr4;gOHVW&n?L-LX_?W+Ogch9QrnSDWs}~IWep1w`MD(11n0nV2@HzA zt%*D|7%L?R_}b8~xEyW7Hwv+3`ZLpI>(^z<|#!rMMSCQ!NloqLfGeC|9Op5tz`j%rppG zA>m!TfJLY$o{|xLVBQ}P^k|H*rdMTymV@a{u3-I96mIw6kWosb0Z9EybZKVFys>nO{JmkdrWHg7IXBYO6?P3_dlBoqd^K7C6 z?%>RVnsU(1^*_bvG>!Q79#YTx3*r9Hxt-fAtkSA2nI_2 zv2!{0R*BL;DP?ElQAROAvRDydx;qahh9w0z(S3F2MlY%);#a#m)Wr;`?YBMp-}byv zS4CcP-nmKo^ovt{`lN_$HZqwG@jnZBw-R8qVaVoT2hF;8$OaoGzY2P$L{|mwM$aG1x###F6K4D4P^;Q@lgVM%ly=be52@c64sY`w;w@o>fwNb5_mv>6x|H zLI=W`wKsQ$6y6B(wvVnzuRWu!0fqJbx16fKownuR-G16@oR2>_2Wxm#(}xjhqYN!? z*N!CpXLr{x1aR${K1MqKp|{UY;$M%V6#i*XECgaJK5$hYCtN8sD<2Wyrh_y&f8Yyt ziE{y^yaPkRmd$5Sm7I%$c7m`so6!%S1@08M3HXXkSVv!E5*^H0E87%&B3UrCR`ekJ z+GD*GGZJ&8-`^TS?y@1+(ZyJALH2IA6FJ8K&5-xGA(A+o_N z^Q%5-SXq`}aa}@KJdaRU;&&sYoZmSAprxR*1$077Xu10m+7xq~b# z+$3o(J4-7$tGyLswlV#;^@)ATlq+W}n5#K;^|yERtMH*E1h9xUf_U6v_v3+9Ym}0Q z4xl=}AzPb+ceZbj*idPEY0qM+>M(QtqwE<=XXVvwp5DWrcSPlUyTpG!sLABjR%xA4 zsMFF1zrGvysqfH#Q{P}=>VE5U_~7pVeO#qbf7mx~rMcGH%NiyePpHx#RRcB2S)!2;DMLXd;Y)AZgfCj^jDuGZ-Z=m#;PVLQCP3+p=k(z0eT zg{ts2iVZtLUDae7^LYn1_5Z}3B3Sf#glleEB3!A1=U>SCfy_8aE_+B7%v>5j$hP}e z>Ip8_jhKmMadNeXl9Lkd!ZO*Y0k*YfA%;Uix$dtuHGU&88Ud=4z^}7y@P!=$@;SqJ^Re;fO-@5psnue4_%{?+{-j`Nqds4a<{@*EAK*0=}F3yP%8miaAEV);!skm z4|j6+Ljb+5&8UDrHJ7rNSUo2*D)WPzuX7xRID}Z`C9zP8H9vT%x4434-H!^|O>PG5 z*tv?$MWslGyG zwPF@({%zZDjZ`ch1+NbH*l22n+FBbcvZOBa;F7upk|?9;XSG!#r3(k!dq49y%Y2fVCh$uA#>6iC_v0qUeI9A zcY(#Z3Ne&cupYe&r|1=t?aWqp-HH)y%#XiLxx9*DGqS_oO1Tsxhiffx18+CN8=evMBDMb%e{X@Ygv(@kpMKnB~Qg<<@$y(@U3O$9%8=d34DhidsVzo7aS>X=U+ zTipCzIYjZ4Bg^&w#^hIWZ*DFE==!Ms1?^1(wnb_Qxt7c#>ZsWs4wxI*RV_@Kb10Om zHbF_U_ij_|2hAU|-KKJEcR6-WZUx*T6Qo+pYx|J0jEkd`?Mp4Ctnl6?c5(FEP7#bL zYel4>m*K9uLx>$;r;0$$Yc(9Z}icVNXvl`)9RAAR@ zFm}d~D1}CvSG%#WmN!sF=M}6g*z-6tT6r~fuNhv>OCcS@2gUII1aD8a@uS2s0=CT$2t8@~xPZfh6H+{ozK z2kw&5Y&miE&)Jp&p*_+gJ6nenB1f4=STMW0WaQe~^DpB9LlJ+w#W zUgeR7xk=){94N_o?4v%&zN-BE`)LpH|3*+nd2c4KqMG^f%xHfu0bJ<S@wbS-B-ifa{|Jl!T#Xgd2Hb~L0I?GdE4HQ}#D*-fCqg2gHqfj(Snj&=;v}og z`ZadTjplBwVS9i^i%y(sJ>qE= z5gdEhtbygoD2n0cbP}KgNEevCSk5)nhgv|anmH89E9%DR$DxmXOb*rlCfn=r-?#U& z8?ZJuwfF5Ct?m8(mH*hDf0lo$xD~=um^6ehVtmr2hWvOJ39g;k!8lL1jPQ`nNqYn2 zE%vyn3Bf7f>%1s2UgepSa*n5+dUMJ{Mp^X1Ope+x$daW<*Xbk*4*o~_t;ceP(|Zg3 zarM^A(VzcR?<)V}{5Lvqk_xk35UdOO-FnS+YdGDi zf1PLg^@$mk>{q4kfy&wWcbJ@iTH~plA#}&i08L5AZ611A#uO6ei81r$i1AG{)Y@N{ zUd!n(=S9_VJw4IVPyiFE2E&s0_0nm{`L5KM{ulWC#L8CuI#Yf5ukg9#zi)3Zd>-7U zy$=ZN@*mps@%hbD+l=r38=os%@p;uB*&F{8KA-2e9?J=@@UbcSXN%7^o?l%)b7ls) zOm_D}myC9x#QQ2x^Bca|B}TXgERtrL4-z9_2>x7IFUjrn*UcT;(5wDKm{l_yz3 zqLRr(11HQFuIP2Bqio>3?ta+3PBv^_P?yPW4^0}K7pNz8-nvMxvvO`Qo8U7TD(`EM zI#kj$Qiu7n=teDvX)l@qbYb@Fr}qwR!KL@{vUg90v=V7g$*Zk0$~X^2$3kF zQKClU5{*kRplOr9ZRlVW607`%Fd#Y~tO#+HDe*gbG|MSC>U<32@tt058TgH zLvdQ(>5_JBobAedhs{&h;WW2#!d-c&DGNV2`00iprjt@qsPQFr@!XlJrrLczub6g|w!>356ct`TuShKSu z4v9LN3yI;6&N7hlBZCPgpO;haYj0aWV4?N$!U%>A;7s5oeHmpu=^+-Zp@!`Ja6mvCKTgJQwN6!YKm)}3K15&pzQ&98Vo_jZ zCPH^7d+_M(9iujde8eM4Md18{Nj|&_>nKm}T5m)KB~=BKXadvZgMXS_CL{r`?4;N?G;20hWuA$u$ahNTuvO0Ih@l*dkmUhX?W8-@Qy^`M3?pZb3O0t z4(t5>B+vW(;rEmHUYct7E5npx94JJ6UKAQ(hvz{AG^DB3ztuD_%#Om09UYmi8cog# z$iWfVk%j67lXHmEjrSo9ufP$k3jBp2D;XQ-2T??%vx0kfpTlht@fS4y*mF)cqllB& zXu}Gg3M1%d{ZOdh#KYE-@yVe~+>Q-NgDE?7o_66&0Tw7P6Q2JXf;%7Q=(=&Hf?ONT z9D?tncA=ViD2GBE3wb2#P-IiNrLDd0KKzQ>KG-Y$Dg{w#r326{?Wm2LVEIp#Pcm&R z)enWLhz}43O(kPl0)MIB;K(YEmYB)a?L7W+%E{ItXvgEdnt77o04`4f`j9UQIy-RX z{V<#^0Y~;D<2|ddQw+Z~UVCfW&JqUbox`txhofXjtIvK+#$Wczs)k1aCboY|kbppR z6t<$*Fa!cuw`%ivG?s;yqH%SU)-;~CVPFBRx6Z&PYTt?MCe&|#WES)<2Kr!-Hf|;c zQN8|@*3x2rU#q{jgr`T&4XBrsnbw1 zYk3TX8Dtr)!02J|p~KcsK24vKx(Tlb&q$jE@dds}<6h^oKx9+};%lRCfyk_}(m%hm zFVnu2s+;sS6f6g>rONW?u(X1O()0mRX(+$Ea#(Jl5{_m?%{T6!SpU;G#*PeWriV~b z^UN(}kzpC)t6}5bO&YTpB!Od1vbb{x$wJc#eQi3D66lflA#%^AHXq-p%>{-d;fV*G zVG(Zpf*Pe>Ih^=Dh*RoSxp;)V!XnK>Q`Pr$U(je64fsKrVs7r@yyrRkUhc_I$>%8F zA*@3fkN1Z>iBjs5fj@?%)E^lCcc8Au?&P zx)(QPV(K~tAEl}5;IkrMU!xxi)unjoAX)ZDi%1cF)BX!%*xNTm%AA&jXgjRuSht?T z+}s^bNTa*NzV*{Go*Z?YGM6cc7@iJvz~+&q8Q@$T4Q z*9G2V;w$-0!B!Rdfup=ceYo8f0x$t_B5zi^E<_u^CK>QL*ABRfCj~i2Em7CDvHUU> zA+uw4D(2q3oU^1tN?nw3sXcRNynV(Wx&AoQB08%>;g%)&PDmBhie1&?P_NdKsM#97 z>OJ>wimna&gHYb3e`w_{gVy0Y@3_Q&Fa8J|Il_^ArJpS&@spiPj_$Q zcj$}T2uYeD0v`yzZSulL`O-VTGdUMKm*SSXotxtYU*gWW$mLX>ZPyVC z-c9Tnq~Y7q15OfI1qa09%LV(m;ST!>IGK=N@TLDa+|GxqJj&qI2ZekX25LwS4?K`% zC-|*vKAK=n{v-+3xZfR*fePvS1Gg+30XJ-fzCZEyv-U|kv|HTOuq{^aEat48 z*DP^cC)n0CsuYW0V-Fj%kk#S_hsi6kHumrO)|#~ewz1*~)~;1}ertlYW4RwULVRmY zI{mQ;)^8DFf7R*<*3LzU!XN*t%LHpZu94suvqwB;jale^$*-Po_Z5Jl3YG>y7JnXA zL4@kxwaW7uzu>3!oq#0(>87!UdVJ}AfhM`lTi?u=%W=JC{1b422m0RI` z2vfV3r9o$xYu|%20DN46)^k?Cd52WCJ~b(6gwt=E9qqM0qY-0vE}AzYk^%#zt}9@b zy>H#$U=Mo;exb+d# zgPW^ieoV<36&+MwhZX6n_1N_IU2js)E>KS@9vBd*5>5;$%gXT+ zENZ*1d$6d<3RCNW-)cKz%G&}W`*?!&!J)@hz#}(Gm#k&M%B6ukoK%@_jrkJeR=fpz zV?c;z_QWlAv>4PhiT5(Rjp1940;S0y3etdFD)KhQ>1^gq0{!3}MxA3fskk05CNkBC zl9GduX9uMK26_@cL~-U#MABQ|q~eWIDN6yc0m{6I8{LvpU}HJS!v=X^UoB9y;Kt+W zQXK8q6v&GOwk;3l0f)_$5QBQ1Vh^I#IL+?a487wNoI|>ztvv7hsttZ;zIONnhjR_X zRhXCcDHq*;Toq*Lt@5)Ivits{M3$6d6<)B_@Ax56wwL)T(tPz0E!e5WCA+w!aTXn= zt`k8*c|0Dokyt3yGg~Ri7ONPpQPRH4G)Js~1Pm1Is_KCrsdpB`8LKBY5z3tf>KUw< zA@#FF>aXUmR3=v7aqsl6S=ZEWT7ee-Hd*Qoz(thk<^6U~cpk|J~ zvWQk1>D}JP=dYPL8D%^t3_-jdL8WFhY!{%U5q%kr*ktf;YrqT*4~v&UgYEp0d(aN- z_yWE~K_7ISMZrinzxDfuU=et0L|PDjgn{r1S~XCMl)%pC@H7;er;EUEza%3NUWp}-1;^w|vRDhMKt=IdvP>=f8cU;WcnjmFDcc`zP4RDQlm^$Fk7k!a11hoe z*4cSGxGB-T{oJfe=}SuT^r5tWoAvv8v=GjAtR7V+S7ECKI0;~JA1uzhA&Q}9aO2X3KR*@G>u}1!4Nh|zy0GdqkP@#hu~%(^m$hO=|fM(~mB=QMnnO@=F4F|A*D9(=#0P;3#e_o-PH+6W~y01FbN zcQ&qP#pY7BU9=;JgAGBeqygwJFKP~0C2;87oE(BFO$DMU$Jq^^X6t-l8_eBQo`)~d zNWenJ?1s;?TS_sC+GV*Xf{O|6=#LC_fgvUmW;in*JhXCdK|O8<*EfaW6b{^jt>4MM zIz}tQew~QHKw#|!34l{6#Mw6Zl99;&iWho54mkT_vjw-eWS2P&m_}elS_JGY1r35Y zfb;SJE7{rLpw)qfjoCyTO5rtVeMPyinf)SdM|&mP=F!(PP}CFm%1OR63Qn6Cl9p^g z%pmxhzVOy_3vh#*U9{YG=9LdvNL(OqF)CgV9JGW;4U!9*gFf&O94%HPjg0of%43n{ zw2^6nBK$<~!;>#~{c|AD1;sANc)5^#D}uh|E{K%`fqEB8t9>H@4L@+~1qiU_N`OE+ zTM}53UIcw$p?Z5jy*+5Y>A_M=x+GPUF@&VlQw3Dze?HGq#64+*inXQaCUj#w~6)ENT=U{<31wg^~T93QlWLG%E+ zI9kL8=+SyNIB34m8qi6Npt&4FSF{4NP8Uc}LI=5>*)8Vg@tA0lvJd1>g ziT6VK(ay}t^~diGB0XXO=&ldknMU;1atE>xr>8I>w7{Jl3xog~dhR1qh&5PARta zWMmd0ju^-b#nJms*+2|Lb~7#~qfi*|r6IFLsB(G0=^q%h+4i*%F9Fz7(`=tA1rs@q zK#pC6<25_%zB_>>JG?q6P_%>i#*<(bb!#y500Jl_4FHj#WEt*3OFfX*X-Y2ltqu54 z-CCjGqMd=rjc9uiI28d#K9x6UmJjzAzlYGo%KI)26t$ZE;@S6Jpop#q#n$f^w1+~O;O*i{BL#>>%%=#R zGH4AX0pW2hg1Fii%XId(Rp7kqf%9&_w=Ph$F3@-DUcg}e>KH9Kn=990!V0 z+v%?%2+o2zz}@mVFt;bb7(oigcD3(FCyWsWq_l?)yfnTZbq69B;m`>{3Hg!KfHGVd z`5wp)T?qJyHFR$;0BH(XqM1n00d64Kfjrg;w~^Gol@0;Uw{C|((%SJdJ>QU; zAs-q%OzX}Ko(_?)HH|?qct~2q0ZGT<0C77Y9RhtfwC_x(;V0JE8IrY`OFhHSiUW}< zkwik^qym8=R}6Fkh7ytt;;<%ZFS}SowN03=>vyd8Dk+HI8^z2l4g6 z|382IxARwG_U0;RkMq~A_Iya<{dvk=Dgs0%likSS-OpcpBZpl^Bx3{zy$ePpaqa#5 z)j@J~Vs;Ts@%igrR=(Hs*XH)~R|il(iL{{BJmTz*`D^QL@aCPrjF8;Rd4I3xFD(B0J`XbVPUbArJ6<{T%uPi-%rL~*BC@uw#R~8%1 zqCMN}Nffsy=+$w8hWg-{zBC+6EO9ty-v9aOtJCB-$P2_fNB%63`0VvFY=gxbd2)=S<(mXR7iD|h6U{drfoK`ierfSP z0?~X!O-A^p7lJm7$?wQE|09fq*pv?G!4TEk8B-{Dll4DF+!l)khNr!(iBHiW0KIk< zLXhRGcNr@N!Qi09p0Pn(!!h|@U51ps6Em3>p%@rWpfKkY!FpoM7_icinDuJ8^GZo9 z8NorTJo1?o;0}(L0yLlwz1b8f+SEx4=p;GWht5F2D4itduM0#|f{an3Vqus~TCAe+ z!Z5Hi{gR1hm1j_hE|>KwG~GEM0no!RdxtK~Fdc!U8FYaHek~xHVOD805hH~Z#ff>w zrLNr!y37GyEz@XaKS#ozIe-{~!U32748;P7OmivOI}ebaJJDDtMZ-hEuIhf*HAevn|TCd_$4eYZW4GVi<7gy2nj=u)f0dvNrwO69QBTu^Q;+{PMp85suOG3pX{u zDsifUS+7~EdQAi}a&%lt*gMN};|Y%>F(wtRu~E!IwE3INr`6`8n-mQZBc zFPg;O*TIVIVHqv-Wj*7vjF-;Z+5Che^y0RIDQ?dkBRZx>S#pWl%Q5YMfcHAViLWyD zFu`;L;MRsv&Pp3l|Y>HuZ0 z7SEbzI&vdWk`M9EsX@d9^_heP#f7t{8DMv8qo>Y}CJmRw+6m{~SsUV$K*xp5&uuMv zu*MERwv8ug%h<=U)=8Lo*D^o1>(h~(-CZB_4gOh)6_d;}33=9G*Jn>sU{4G>(Zism zIcm6Yn{f4j#fe=Xl0m0kA1bwp-Fn&efpbi|T_0G_^sdi)Flv;;KoYrVGIxDs!Fgd0 zXbxLH9d~`Eci8pWz5mQQoOcla8OG7n-V8tKKQqJQKhqc7#r5n@`_F)^wd0KTquG=H zOr&=Jq4KrA$uIDl5tkX)&g{Ch&}$|Iek}6>kzr}5HiI4pzmBI&3M`cks5S%D8t<5R zYa!q1-$Pd)?c)Pq6ytJ3FBv+Z(D{|#G1}9IK0Y?a(e?3(jLKq?-Y@}p#dtho?$jPJ z*TN&l^?waGeSdv-n30jQ4}=>Ed_S}g%tL$jf%z%_7u$hzCw(a$?BZZ~%bBVF-plcPkj@9np*|ics!GV&fbN8-6bW zP!#)_1t_uS0*6FP)0ku%*f(HQ&!uiVWFc?bq3j|>rBIs=+&KxhLa*tgllH?!jd34p z*K?WX+7F}53LPOrLDT>P@U(=7?eGi~!!QCYOyy#t+Ka*4qz5m{9XuL`;B}%$Z%d$P z3y`;Wt12^ME)F}592cVQ$ZfHUwqWlGrU`nL74r=}O=alL;A%Sqekmf;#W@8g@eODb zM-a`S%mo4MZf+;;+y?B19R!au`I?biYZtBM^rv--030TBfk-&L;moJu3YR4~bL|B_ zg&E))m(K|byg=7EPEh4wwswvP|KFD%TYo+I0k4#f^5fSL9$+DnC>Svj9#l1VFF!i0 zD>^O5{|EU&ZUB#U5+B+W)Y0BRy7x{2?ErHn{WG#7&U+$IT-l-5Q6fIRq4L40rt6Bi$A14V1WuOx%L5WYVrKRWU)ZF5)(;Eo4s(@uX(SQt7AeIIt~&;@uI zLGE|(quA}Z{gXQBzi@>8@iV;?u5Ywlgi+i=lQ!v}r)6sbY`N0^n1T(CE6*>JAPxyzn;f zhE~DL;0;kzsIgF0*`dib+nw!pu+Q#nrvgO^qxN6Tb|ia^yTk%=PpX1Ud}KZk?l#GU ztyz7~Rs}Pqd1tv!xMRicG^;R{`A|-TJGSacw3C$izXY0KIm1hPAZ7B=7A$r(n`{y` z!Eenbzec~k>IJ8Dt&kb(H}SxU9HS)M355dNUmX;R-7S1~gYg8LbRO!CjSwA;nVzAh zrK-JgZ|?zvG0C3^+n!5fdjzbdk_&PZDIcQVXi|Hzr~r!+2c5`lj{vF26+(%kGAAs$ zPGm7L@$=J(SxRuP#a&8_foj@L8~v506D?yv79v_Xs91WDCa9TWX5o9!sO|l>OlPTT zBm<2j?2D|-WL$I`^kPO&%fBMvPD8dwXlx4vYq4-Bt&vc_=@Sl0*&yb~|C&(@y(Tsz zTzd6R<~;Wy>JKwLDBpWaTW6GaCfJS;ML022M#8`X2KIWN&ntzEnCOJ^Jp!fTV1r9? z^#(?}xomIrE=*)QghMC}K*MmB>$?EB3us3vSMTzAbMK{;>DUL6+HkNDK@ReD=N8IX z5pO%&&t(6#cj3entV}p+Jv? z2FGyqjuS+i*ew#W?I%eemhUqP$#}5tce2!YwSoT@fh0;VrRqh#9U5hy^JwD1weJES2wuttmh%Af-r~i-#Wb=_ z4mQt?pZPHM7M=$$Sosr2!sF+`8JNd&o;v7sK_u96r#YC{%=5Pk?Yy2i18YaDAP&=8 zf4~9yc?gh;S49hv(vLU}nm0179A@sw88|UMB16ip2<9zkxn?QHN2ncnBQtpDFv9E4 zM`Xzx!YNvWM;KB;$b5K&{@41sCpaXZ~hRgyV<H{iXPE8TE} zh{%QGsx)At=}1Ty@YijBHtJA0y8XCS76(b4d4>Cj`b#{Jn|9*uoT)t!2RPQqxQ&~w zx^E96+Cm2rR~k#848(8w;oF}?mB17FHu2S--y}HmWJSenpq76-G!)c}sI!aAGhr<(e$M8=)sD!zHp-h8{Es9QG!C-D^c{y)**>ckk z(wTMZh1^)HoQL4cJ9f0iaJ;`d>B(;0u-|a+oDlv7e9L1WAIc+UR;{&zv z8+pcsg`g;%pNZ%2jGUxU|L_bTsgH!%Q!k)kQ%NpBA%I9QGPQ6}Q)EVVz*!n8$x#X~ z=O)cbN-EyEAfqm+80{%tfoMIcg0Bg}o4I$tqpmdc3nBys_($u8fC}c^GnAvr#f7#N+@b`|v}n z`YqIltjFHA5ELv$5{T@mZu=M%7EQfxktHogiG2XTl(5Q{ODstB(MK$Gc8-l+s?~Q$ zfU&A^vCMT3@%pdya8Di3DjWR+fjevF0&z*|wU?#t8}SyAIT#{|VdthG$%tz9Tttsy zlP+ZjUS_KS2)al{;U&JUvk_=4QUVHE4D70k(|(Ax)ZhcY?}PXHChFF4yb5G;Akw|{ zN@qq+>x9VEoYvo{!moQLh1+6PV`7;nqltCOW7~dFsO^8 zW0KYJ{}xL878xE&R7isUKII?o1x3$DRS)1QP4yJO4bDPP{zvc-F6H|nYs?u;eECa zp?BjD-qDFD*9+>dKy@H=^$@ZckcZ?&_0HDB1$jT#P?#C2g#7h};>`Qh4BXds^r8O^1D!MZTd1(C~J^zs^5>j?-( z?3eqNAM`tKhd=W9<~6i+Da~uf-Axa&Z-xGC+XIy?d5io-ZzI~GRlXe2*M{H%f!{rc zN_f|7H2tvPeo3X!CUV(sB7@SmqV8Z6z+`r5R}ANEn?(Lpu0_2y*0Btu1dQ2HHLM}lIPA94eiZ@4FuQ37KeEFAMnT+;+pi+Y zkK0pY2qd#)<}-HXDuW0(d$c7_%ZfF!NDt)O`opQS<(nYG@d}b-nA}Qzh;LQu+k(s! zaMc271w4L2QEASQ8`E7XYB?K@AwfrvJ?@{e@krue3`)`qV@{HUZ08Q4M&5h)@j9>s zt`I}E|6)dsyr@xaTi-i=F@a&~-N(;5_e0Ipm8Ci33$`+Nma`F8Wg@r~x@O%WSGz%a z*>-dyLa2cxZUssxYKyTM0VRAO0{86)IkhmbA6Q@k1YZ8vP$3|Wj{5wE7=}6p0Uk56 zQy>J9mxVmU_T^nsXcVcClM&>NnHc)Q_i;|7iHTBPXIBsx`|?Hz8xt` zL+ZIJ5zHN7td77PXPL+U9#O8)?jwM!r@IhW&9TfwO=dq_f_f86L!$}dZle~(0d7jY z9C=u1#W4TfgU@B2v8or~C7CT+hCh&EkinQ)a4S-mSY`prVf|C{ILgE_2i|Q#NxH$R zxd%z7ENLhL>Oy;_k`=2DZ-h@M)<^YSN+V^MC2b2Km#*t!&)p&*W0oEMa0^@_)GHf^ zt`7yC(`+siM^Hv=zX)*LZxzd|Ls!tfqn&e-3fAKm6=zxaqg|16lI#_mCPWSxgI+f$ zbH1b!fCk>z=rrOQVM4N<@-(|(iF#}eUOB*}16)Qg&A137NGX{nK`evlW|o9!JBKk{ z&-IU~osQ0^{iSgmIT97X`RD~^1ZpzycJ6lskoo9cF7kMlF7SRIGSJvd?C9$gS;v#RmvKn;+N+_|hg7%fk->;`^@Y-h1$ z!-`iQ%RB`jT5doEL8pfGVil}5<1b=YCc}{qH^aR56DTizUr>%209eK)7O|>cc68{Y zN&6(Vgg~mCZE_1%f(Fpi>{#Zfcj{4Jhk-?uG`a33NC_3*nQh(tSINDPtq4X-Vxyud z!)*o~^MTJLR^mJ>OackguWRE*TQ^ujWryoCBm$gkKS5y3Vnjqds~8V<8$u&yPq4;= zh8p-6Q7o_Bh*+4{eu!|Jvrm7Fg%PfBe7)o&YsB;XOqrs(R6X02@5J@=$@qk-5Qq*1VuN%##M$?nOK9p2Mc_^s}H#Hj634wcp<;W^i-BH7sCZ&BO{h2L6riz2^?@xmjH`pW=aizb4tzISP+X&UKSplA@}}49<8f7-{uW@xP_7m z=PBs2n*SKZNE_wrP*O>Xlg3+3>@?Ln5|>gaXNz@);xcl7+c_i6u6$oLA|H|TN%C0l z4*dv=fL*bw?7CafR4TQT@E1gugW97bZiS`hbG00i^f87Df7Fv-@}KqX3&m6r;&FvL z=<$hAW+tfcmG4QX!h=&_%|HNP%<-UBCm^x?PnS7e9WHG{I}v3#kL?El1iD+|v{}I| z!O8{dchnc$^=W(wAwh`is2Z>XIl2RtXl-=FE$F~!%3=pNH5;*O7PTI8jFz|N4x9S5 z(p0L95+0or7@_i!#0|N4#!4Uh3bhan!;3%kA=ndWcA#|1SIK|Gm>5Zq*}Ot5SRKaO zSeDM!km49otM7Afx(MyB?_7r1R;T?*f?i{twOEzhyNm0vObnoo%MQh693UEnLoOr0 zmN7@B7|>mtlfXAav61r)ZsCOwE3YuZ1(Ju0$UG&O;J~ z3>HEN{li+)q{uSW9m;~0;j{X5voc0zSbfgOurf-rtv z@}2n@)5!42RGHXBT>QZR|7__z6l=YdUpk{F2P=#7)w$GK9N)I$3|wcD6v~5qp#Y=q zP>~kHG*e&I-)@2gfRw0pIbkuYIWUe_ViUox3E+9W@z)wo*$1tudjen1I&o2)?;j^*p9#WgS@Ebi_F+^T6}U?{!z)MB2zaL zzrd<@?;xe$u8sg?0m`_ouKoDC)dnK%9iefyL&zaW)QVi%k-Nrl|5C_?ad$G`X9&70 z^6@5BowuGn!Ha0-F#zGOJs9v*rpd z&F141t$$9?t-(O~P-ra*MeXUL@eXNfukmVpo#eJY8B1r59y%YoI*uX_?uvp=h0Xg~ z1*sm~9fCau3^xY4D=uVpnu*AvyGNwW_5hI^aj$#9LU8 zi}o6_i|=aAH{>nBH;7R1jgi&(?nQi8btPl+2CLm*{p0uISg&o1WBto{2J8J^ZIAVv z|I<53lc-b~ZSUOl{&>4W!3f9pHJk;J()yav|^^eR%maMi@$!vjo>eO7G4Vd zafOQo3KZ>R;E)&`?P4%maihPM)Yy9T;4>$N(rZ@E>g(THk6Q&JXHIk*hTGiDmMA;PLt2mxHTC9P&9E)T4i3QHsYs~R;u?W_A2 zzCI%fMq#d;&W2S*9!7%EuXq)d;czja79mb*{~5 zg?{T7^BkJ6r8IIaxa7<<+)fk5^)<#yzucaA?L+?H`&kGWlvlas6`8m8>$uYHsqi)Ln_HfR9H zu_KRQ?YMRLRmoMuIiimq#j6*Z)iCFW*rDB$tfZk`l9H3E^4Ofm@v*;_m#?-QO%OoP z!_4Onnr6n9OaZ-2jWN~4aKRYol*xa|uxg$naKJdly!;3+1xC0n)w*>vXbDYwe`8w= z_hhGJcT19cvP&bE!I+Qx)bSCzGYg$yfNqo={hf5;Klr28e8u*x5A|o!9eIc~U0H8O z&&YxnrutGYv?k51Xi+ z2ynhER*?l^T8&%6iDbjqm$A<2&Y3B(MUgQx+2abTZD@IjQPbgR0M^czlV}%WKjMjl zx+U?a06)i?pD_NC?T!3fDy&WU0QMda-7P!RLv6uCjfx5z)kz=?c{2A$Ezspffb;-< z5(0$0j`-bJ{Q8Ym|DiHN7l&+sv0B7JMc9pknD!ui=7VO(~itgcRh49kIyBL~@({n$(7Cc7m0!<;($e z1a>cXz6y#}GgN>!dg`+NQlXnw^A$h^;nTnEbWLBA3f6-r zs!nrOVaupI@2!9{-`=*?S&S1@@Yw#tyz-*?h-%++IU*>4OUo9O!}fY#eNA&Hoek$E zK}&!9DtDHZJNOuP(k%1G&LXjPj~obcb@0-q*4cR8He9GxuHfb-KsM|b`ZHCDRYc1L zC=>osD3K~2#L{bD2_=3CT&d#LSS&nyI#wt3z-M{UcUJY?cqmw}8_y-;eCV3n;1Tqt z+k;?-9+(bPUEnO?B5?M$_wwfZ2Q4dVo_2WM)2NL7>Z@tQ575z(T|p!JsMQb11p6vV z*wH`C!JnWrp9|*{XdXe|_f6F~%tZ5(T90QPT~UWrh=Fd~Y!n<+^@F-ys%o7|*M%?5 zMPIm)yaPJU#`l`3LjhRXJHk z{5`CTlGx?y0xam?tI9{OyP(&^1a}0Y6=%5Q?fk(Nf8c7GEJ5QJleS%%m*bIn(^nhn zVawZ<2k{g`ri5eJ(*|G;0}K$$onH#E+y%(0ZwoFiOvNROp$XecgzB7Z177L2sNR(y?o(tYWZ^E_wD72S^wzrL~_-kXz|lu zXx!c-xSfP~<-(}FR2?gg7xBbjEf%WPVB^1K=yoTxRyFA+8EF-CHfdqwd<7XM6WiD7 z&KxapYzQ2i0>|ksGACGheG0`+35d3;uNr%^SLPf;ZgTc@WsX%%ozc(RFE1*81>qKtk*^)-;AhaVkZp{k4yy7FXK;p%qK-^~g|1 z-zR*!fCFoU5{7B17E04UjZd9Vu|Vaheg*5DRizQ^V&UU*Ea;>e5QODENRmCt5NS?a z3Z99oTCRdD!96Hd`8Bg~7Wku?GC?d(T`U&3yKuZIP z=k4%EC&gS@x5A&-L|HdW7JgF*zP1*nT3)20S-Fn&p;{{_>)h?+GZcS za*aUqy%VgQuijYFJ1KIFZaPI)4fLSB6Il=zHujqxIBeHL@?!(X?=)cMqJtf0E~KDY zTV?Ywf%&cb8vKLwzL?7pq+eX+D)aX8w}b`69HwYw=L!mIy5clG?8Es5wj!GQAhX8V zv5j?9IVec}g~-QLmo(z1G!><8EzY0y6dw4G9B26JKKO@Q(`IK3#!T znb;P}(qBLt__|po-V3}I=H@uGyeB=^r7exjh%GZ!u_%yu_p4BA+L}m=Sti`Wb z6?`QY(Z+sxf1_Xym(?903pX~ys_qT~Qv(h`2aDROPEp4Vz>~Dls-_;xR$hIm?Bux% zHg)6S%;)WLQ;)=2wy~uN1?B24|J)=DlCyd)C)v_y*+B~T$)PNJXjRKfjP+dsETGH7 zf;ex?UDBa2uH;)|R)Pqocl*Y+j$F~&4_kV;6=j98dp0m<`8U?smETzBWj3omNzUjr z+v(}&4fR&p_u&~3xJQL&^uy?;-i_C=BmWtcI8gw_f$(Q*Dj&?M?xg3ObC7sLkW$$kz4I@b0 z`3kgmAB*Io2%fL!^HK0t!}E=J#&+;;@rVCFu~Yf>4V2VNg|N9QR`XX^4PE^XH@~nW z8Q2PeopWKR8)?~&eQ5Y9VIO^`UfQdI^rDKSrV<`30lf>>M+W9FApq3TcunJf>K8#N z5Gq#t>o2}F83(BM3dM*}hGuU-rkV?nDKvN`3*er4W<9O5p3zwkFzX(jbqAg!1OLSr z0lbTXlj!*iHmSD#IrCT2!8bXnz&^6o#W)+YZ+3Y{Jf->0uF0mB_3)L9N zVfE1mz>SkW0Oi!a1n#8w$1{63uq!i@b>{w3(ZHP}k+m5Vj@R9g6&cu_FF*s?#Hnm% zp-J)af76UVe6;(}P9|Qg&8ip8^-U#dGK%h?xxyHKb$^DLujz;f!48jys^h5qfD3zm z+6P(im|h;T{ByZCe5WpOf%s`kEU(0^TJIssNtyE<2ku0tIDfD|f7a1{Y&%WoRC6ajijH^| z9NZH#&W|5MQ7FXS_CnCb#w5Z{OthWzF!t+1=LaLBA#t#hrP!X#*&;tUczl{wokB?k z@n}0UP@p8+&f9Jm(YqTFbF7jd#Ko!!ir!Z~2=Hmeg#HXZshf%>w9LUT=S*BYiW^V0 zj)Kd@)E{Yf)!u-25Ct^U#9M_+*)TuDH#-j+UYl*5-X@paEmqsG;{s+&4@N4}@RQy0 z3Wo(6W%WP#AWZ|t(Fm~+_5tSWXu6!6gI~bHwvRaP`p;9xz|Pik1HK6k9#nOxlwqs) z)zkBG6oU&RP`65@uw;eQ4#~M#g`^2q^-#&mvwc?rLHUvh5_61Pfg!;@rJ8#n+r(UM z|4~DuJ%pkXuyRS+Ht(qgTq(Y;k13AfJj`~sl@9(h%hM9(Pjha&L(0=AWgb~E!Au#% z??!@gN^%8bTc#aSHwC5HqZ4(Hc74bm{foq)j)(oPbwAjcL;dV%%5ioC7>lNSj}MaU zq`VS_q z(y&(NoB(+O*7gORsTj3E7`XfZxqy@gRRYjJZlJX6svzlbc71KAlWE_-dnVI;<%`8?GjFUXSp~4?oS-ZZhb87y5_%Slbj9e3`o2yC091S! zV1gLD$(UWOF)$MsEG&pweM+HMeMobl(I*OJ+l}p zmHvUz^zVj2G>(3bO_SjQBhfiAW9p%Gm!TNPYc2Q&_#Cy78K5AW9mmzg6R)0+q z(*gFHd{zcJ##UKh0Q7c7_^3o(BEXW^@eRkfJy7UByi9GDYniHAchMXm+(* z+{g^lW-2lkdsky~@so|8EYe?bQ*nl7(dnF$&E?cGzb91fjV~K4_)*bzkX<1{b@4#h z@Iu=vSsLDvJT(uEdhkEGQGWtHqZK7l`#ZF2u$osb2ubL_HcscW`^8v5@@^bJszU^%M?g=3=umE*$31^azKsPkDsH1yXvkDtHpz3mYvxA+S5q%Sa6r z+6w@1P(Y!L#9`5L>lQ`H$RG%~pms$|cy>mTRnvkzDt5Zat?Q8V>__lp9w^2wh9$t9 zsp&dJlPXB@byM?~#C>0Rc6s^&3=j1J2i_RvC_Kx2dP#Nrgpw4UQF*rKX@X4jj;0A%465TCUhR zvK2t_`Do(YVtlT~gD#A6NF$~nFW41YVWSlx7oS($M0~b9gfHyK^sHJg`*Bv=wuU2a z+AcdX6@l|k$KM&bcG0eB-H-u7*#$sfujN=SgLMg`xfqqIH*XNs)-GY65 zBT5tc^7hcbm_yoKhfLJ?C#i9ttYr z;Iw}Ug6&F7X)UODU+RR>^bbyj;&48wERM?6$l+n;>ecLiH2o!(NQ>jms_Dh%+9|5~ zI+|jw>VL4DGqeWfq9c<_ozy$=1pA|t`OR4alGIRHr;Ghyx*R6D7v%@n(vlcTuRRL$ zjo#pIJ;e^=u;lfwv8%5n(`yT)#LXz)nx*pDj)-8eqV^PdGYfC(uEQ^?yTIy8YeNka{A4@iBn~l8) zO226OA6ea9s16%QHqDZY)y-&7>l0piQjAa4&gTv4v55QHIzlwI%=>9Nil&c4E!GjR zdRe*OsFk3P_&Ai~jf}&Or~}5fLy?9OYgK=VG)>)~;;%I(Ho-b}mv!q}DFly>g>aX; z0`&x)(G_-ONj~nOF2)tb@J9+|+2L0wvLjW!AIzJ#q7B}-2#Z|qn};*lP|4Qd&@=SW za%*@4>^U%11*{|MTX8VC9$rT_WZlMOyJs`aRShs#;Q;gUDO~}4!8D&WX6rXrM*0Qs z_DTB2x@bW`Jxp1tWk}(5!<7EtSQj?%X==JX7tr}{4h&%51g)d=IV9NLanDJ!>LR4l zlLk6=qY~Y4nq0e81*esn-^Hs^|c;>Y8oeTAyuI zzkR}k@AvUW@O>aq1bn}QwBVcf+{+LV=^TtW(zhVNRfM$m`^W!ZLHcL!c#*ywsb7fn zDBQ`=2^Z;`(G90bV^~WV7wa0~P;x)Q&&LU&F8DY0ij041)JHR4?j`u1eG0f_2Za}8 zg|o~mORqu>5Oyk1d=?(LE<4^JF-<*>l1PMKrFcj#w(f1x$Q>)KqR2Dm4S573hvROg z@dg!-=4SZ0wKl3yv;UzR1Qio!zi^g}JdV92++s{~5T=a7#9d(kCo?B7k!Ik91uNAU zZn8(P?4^WLqzDMq>2~y9sesF_Vyr)d$SmZ2==o~cW`0nbGg+L-;pc2sKSaVg2*|w> zyLF0(nFu^s^u4n!U=7=BIvF}D;V!gT#W3YLVfH@UhU3Iv;ejonO2K9AWV`6fLhIIj z*`T75iPo)jc~>_8YXWv~NmeK|Qj+C-?UaO|cy}EP@79v9?ZL0kLAhB6!|*nX%8fH} zI+kuTdx^#p=DV4x;#M~JRW>oSpD668AVXUR9Fc)o?4@9B50fk!f<_1Q66HT)w+Njb zbRcxTvYjw(8rZ7|I`fI2Z0zDdIL0dAyA~P}E14YheHzUBK6Hchr-lAfwZnjYe=UtV zt%2IpCBbz->yX;3Br%PNW19po$VjTKlI+RM&Z@1D!~`aK)&?a}g+$$z_+=)A$5wDs zn5*u(9*fvC?dR`o4<;<(c$&`3+M$M?KZ@?-z%9mqtfCOftWq<>PB+6gj9gvD_~CEJ$CK*@6CVY-1~ z{8q`2_Tax0N3#wB#{{W4?S^A~_-gRqf0|$V!tu;1!_h#jb)L;(m93|d!uTXUXiyz+ z9$CyKRfn+uOEv0A_i-dnQ){OY6|HC6&i97Fg3gk1P$f{|WiT4I(qCj9ab7_!L<~7b z56NV8yRNM(n9&a=1?^AdT%8q9K2MQH5m#0pEWY4B28Mabr z(oPK{2Lk?H{Ha-JTctP^N~=8V@z9@>)OXLgH9VwisALTr=pIFH=Cbq)B%y1ISk2d{g^Fj-tF_{}32CUC*(e9a)5#3m+(?{B$vkvhf#{&>&A2r<6yg!C zse9Hu$Nr?|`7#@#HP2)Bpm`Q8(VAyo72CX6eavG=>sya#r&w-&d-savVd#ujENwJh zoeZ?lgo(Z|j0(&qGTGs;@O#ENIDdDx|D1#o|Nf^n%WtL7sSM%YlQR{0KspwaCy2w8J@`e+FYTRu9G?8O{JLcl9<``| zEI$Y{6e+6^nR6+w{k1e3!ZW#{Wf<~;&d7=c8J1(tABcLXfL8TGa3bIKgc8~i^i2i& z!(;IhGj8YrkTuSBX+FVHB1kglB(j`N#YJCPH?IMtK+$IF)}?qLB-URMbnapORCY@p z8k`pc2J0aXRv-{oJtnrXVi^d8bEdo^IO$EbywjtV&!7g1V{DOQm!rGuOAVWCNg8P`hhA*q-6Tw z7e#iQU=N;}R&~r4tKn5HG+M=Uc!sp&8l z#HC@Y90YRthIyA-K3Q!fe*LIuu06DaJz&D)GJ-hoCC(<;1n)xw zN-t;NkdgsO&WVeTIUvdL_bd1kXc$zqwkpkf#eYE27CK~$ZX-I)8M$iI7u0(vQ6e&_ACQrOj!uY7I>3%RM?ph0 z&B4p)h}VFh4AnA;qux4oCnVbN^?XkoJR0za6I=}#7=uQ9E!)B;5mfGYLLYYhspkAia0V@5M;=?a z-O0SDcmO7hg;99lJkEg<g9m{JqZ}0OK{+@OU7}g4_thv0X9<6Ydmq*G;SAhyBqKgxHjNBmVH8nhwVvWM9v08L7*d zp+`#Vlb`+3v{sHQ=@V1`LR&P)dKtjjcU<`;655@I9@DiTP>1t1bk1nzD~*^Yr(;|L z&UU|}Xor214LVsjy0)H)^GP<^MPLwwN*Lczjx^$3wBl+lO8n}QE3rFz7OKLUw=ajR zFGd+W)lHg6vs9!cL+wJFv4Vgx7%qCTDmX}|?);D6kk|HG` zD9fMWsWrn%eK(%-A3Wi+IcP;GCZcHS=nbHD&Z}B4g60uT9j9yKe6I%WpqEc*7_F++ z58^X;+iP>l<-j&Vi9&o1F3F!YQ~ec^Sb{0Bn_r+LdL5ldf_w$?c3*Y<6-0RI>{8NaY7~NBvTy?*dW=Gz8swqd^bi24E&yagyF5>!<#7 zIeRuTJE4fGM?MwKL%6e+>oJRzlTqj%M)fEZ9DJrd^+ckn1r_;gufU7C2^wP;0EAY- z0;sj1K2c{&J}Md!O_`5^Fz_@_lcS$J>fo=PiLBPw%AxV%k}OcsMIVzMu&a!zVNlC9 zlmX0%Q}+=l1iTYj)EuJ$2e%(=($jnwcre5VsOm@@)<{6-VwoS#VqMYnf7fGRv1R$> zMA$muXbD{=tJHd>*$^aRSeS6iEMwrFajP${*AcF>{9o|OhJs1W-V^z0X@9Ym&1R`*iFp`NX6 zTF2UhXQWjf0afiq(X$WgsC>AHei^A|FO;uPc6`_v(Gb`_3AIE=ydi4LAyUoA zY;^?2+|{>1ceHC#4d1=Wrsd;;2Rh5gvmk6c%ST=QeqCN|9xI+P>fKyKSX*Hd3z_)D zBwl0U)=PD<=a@LsBpzoX-6ZZ~BHJWxW1`ViFoTJ6&6{hO=x!3fVPfXxy6Ur$fHf=n zRz^}?mpPyX?6yPW-NPOIng+3T3AOFRZpTzto z!oI8SVoi&+vylqx znud5_Kfo_W>Y8#q`FAnDfHgg8J|3n&wmgMquuyOP@wV3!&6~>nt>koCc=dq@DOd`m{=O%F)6Mr*_<28)du9!Ovg*?H! zc3dPdR(bM2pNjmCkgtY*u3>zCC~8VF3B`oZB-S%=m`N;UV*6+Mn+7D%_)P@~fTs{( zL<3yu$v=$w*An0l)Ah&Itmy-jxQ>Z$OyUYAUNVV`n7GX(DwuFgq67&*zvH#UD8BV7 zp!C$xL!SKSng8vDf`$t{`HwMwz0S{BoT%q6<~Qp6I~o)DbC~~ko)y!5Fnpt5`Si5rb*n(#5j|?f}@zY&b&DY3EI6c~gW0ni)z-^s$)D^s$+vOrd>sp@TeqIh=(yoF{$k=E?8R`~}EYH<^#$ zI~d^lnZ(;noNN+rGO@o&{ELaBP2wpgCY!_qObjv!hl!I+VipsFP2yT6t}=;Bn0U@~ zcnlNAn>QnnK!@+~B|1E*7H!^#Z60U}9jXicb7Nvq&t;)6$4ZCq_v8;_{%Yi_IW<&N z5cfD6;HH|ydL|~A#8M{CGl>Q!X1=EB?%zyUCh-gt$D71MOk|owl!;uEn8QS#Nlay8 zlu1lr;y9BykBPTl)o_AHp!b&^n&|!Aub>0{bjQj)`8P5DhcW2bWu_*JHSI7pbzx$l zdGq~2NF0hlUT~cV3TNI;sBHQHxtj9s-HmujU4Z3%nvW4F_X|3TkLJq+^?L`~1Xr4zMGG@8WUnRwbH9%W*#N!-oE ze@vnp2|)jJM}k1NzXT{j4Sk6x|7+%-KY>dlu#-(^y57FCo;c~&=Jj5rreRN=`)i!m5G3<_BbZKSf-2RF!7a6 zz*Lgk(ia)9X=(lbWo*+TnvYt#L6<(4rC;dF#d)&|Ac5wc{{n_4S*zM_{2R@9;cPVH zkqQ$a&3JWnWW2&dZ|e`6Sg1#0-A4OHJ~wU)^=1Ri4hW|Pmy7Gu7~-cJ4g~LvPCZ^d ziC(E?{8bnH0mpD*;}@53Mpvi3B%79#Lark7n^F$~6y$45a=a<>(3IN6ywp}wO-~bU zm-g}63yB*IyLI1GZdAc8fkUbejt`h4Rl591x;&0(y|phazn`z!8AHL}>CMFp5g8~R zPXk5%%p&igh_S9>X97)z7X()RX*3sLdGCwa*|0jC`!Bjoj!g5{(p^T~32y-;Gw@~z z-uP=DX72UK_18Yajz=?dVN0NN^TPUAD=G?a?cfgW`;9ReyvE%WFQdYMx=u(e&60 zAnh(g!H%#+4AQRUXzO%jlR+Pt#cnC$w)$Co(K=0?cuF!~*-iD>EJDEF`oaT}tJ=c# z>G;gg&nnyewOiO_Y=Y#%he3Z|m1;Y!tyik8gOg!oX(q3-FxJ@u3g(tlMyXtaoa<`v zg60%87sk6*U%>eS?oBq%yE{wOuofOGnLPp57G#9_tHaO1f%zCbQNnFgs?wA_0tk2B zM-Qtq{k6Z7K4$*?d3I)rYK8j%s~99~cU8_rxibO82-k_S_qBC;Jh1Hv9D)EmAzVw- zQ~(p$QnkMVAJO=P53@tRM<0q&wSKpY>`OFFCsuG_4$9vkEDf(fWM3}X&1%AGO@QYj zEyto&HE5vJS&9#EBsBx%mZp9K+ao%e>aYHuCfsGQMs*CnD_T4A?UsT3aBa(e_|u+W zNFUjZfo?o!hums7g$CtP<2Saj>R1?i9(+z49lOK!6Rj8?wKu?=R-%psGPQ}5htG%x zgrX+LSCHe!ayNT?koc1OLf|bt$a>jVjcsp9TQ4`Om3PY3COxf}OOg=_y1E|ml*Nro z^}ri?gcmi2&YV+}6vDwKZu3N^$666L(50n0Lwre9+wABJM3`*@fCH?TEp?-=G{buN z4A9#$b+x3cw&d*uOCo-MYYKO}5XrHG zE^0h#dC~P2!I}s=H5Z-`>fiVU*1T~au;yP@?F90%H8}lh5rW?Pfl%f=lyO$6e_^bU z8YwB9+g5#+F~d@WLA-Lf0e;N?q?DLLDKR=kDRGmQ61)CEVqKetWcGy)~rBX zk<`2JO31bW75Zy8vs#c>F?jqUG;pqnoW>T&Sn6ieb8;Z zLKe;u!LR;V;*Kt@s{d5tZWkVrKM(mJ3DpIe014k z;$z5w1^%r~X;#g0)CUoC=u(D{foyzR-5`_xTEU_kTE@}&K)cHUiI^xCi9Dh-M_9h- z* zwRsXti-Pj7QNvpT zGMs?ix^&_m2P}(K>{fuoanE9o6}X6}fG%MD(bQ7>k?=Em%8zCaLWX$Us=A5C#`n%(YY%G2v;AkwmHY??kk_TeaWMmI`@oh@57}t=_n0ZyJ4n zHvL6QJdTirsq;bNovc1Cr}$}Eg9m^#UN4a!@dT<60SY25BqD+lHttsp(f0`I8V4it%`42kFCB1{dxGW~zvkXr?8=m#SB;lBp!sXc6K*9}iCD z+580=$}Iz<&(%|kb~l@QqtFf<8Zo;XT0l%F6M}}p%hXY(MVRFty6Mx@!MuD^zhVmVM4(^+=s(%mEa$C0gDtYK))sO-M zjD&@fPWM>mZ;nMsddv#xIcT98DI%+l1f4DZOy?se31`K%GDhjKG!#0_6oPg&0P*sT zK7!r(;Uao_*n@|sS>dPgh1w}Q`kWp^xm-|0GatmXM!Ma8j7zsx^>9`m!x2Q_sx@8n z2X@-oW`>q6^4ET>k@dxs6#mOpsW>5^2N6FA9unWNA(Ihwssx{i+u~}K1=fnL;T4;eVCQb|%HYdWc^&@GG7)l1Uv7 zGYdl_?xI5fmnN6wLMO?%L!Wv)F4u0D$j{K*yN~kp_TMPL-d>2et#zzr|PH`7Q%Xu<hdtBz=DWFkK&JQ0N4ixoB$CZc|C*VaOTI>iv*M*5gDIt(d^MmeWQ0 zFjH$`V^c95nprR7#Jm5z^izMG?iG$fb z`@PTeeLPR-d+S!6I(6#QsdG+Mow9pv3Tu$1&1U3onn0S(7_?&jE~#*i#TEXl#k{tw3uU6|I$oE#+9tkoP=`ECMzu;@+tfkM z&=ykwUEt2kNa^TO%I~!)XONQbQm%kT}Z zr|K}fYi<`(y110C&=fe4mo1YE`Ox0AZOEl(2}qiLHI|+g^f7#?8LAsnQzxs_v4Ibv zg9r1>Tr?Jl*n3*n3`g`_57_|>_);f8WCW&To&TWF28+y{u0W64t{whI?$n=M?z6JF zJN}Q{&-_sWWRW={n>+u1OKs|HXC}l&;3L;cl>`K z6ZN?#yWG%mDy07(1-^XHwRKpwKwjtnS>P34pl5pldhvhM@SrbXu!UXM>IRQ(7O;{B z(b?YFIU*yJ7hha%*~om89m>%=K4imOgq(8Q4X^vwNuVrN`cogc>~d9`XKu@;&-LlrKX2v{MAYZ+_n{p#lg%jW z2eB}Q+PtZAP0L~lAe;86tuHki6dEjo&1R}gij$;UeN}svOFEDwT@Ik6<)_=JrD^j4_s*+H z83i7Y4nqUxn<9>RB`3r_=2LzCU76SFWAE^2&QV**!{*BQru8$Mr?EZHvplwS4q|`d zmrIn1vB!htPgA}GVIFHT^?S5WU~_}mb!6B&HBq}hQq#jcsk-Vr<**`zJYz0j&*bZe z;;CPL4SBSQ!ep=|ESGxwf1;;mQ8y|!FTJZyDO$P-bekeS@uPo!eXVGLOMWp--k({_ zVbc_O!Y5LL3(=QL@0FL@TC()6sTmY|PQcQ;{gI!VYQq+`b~--tsiou1eDbuO!lUST zl?sWDm+&X1g86X%%KJ1e%r$Yj z`_i##qp*`;{u5?sFi9WgGLClr&iNWq%#hu`wFYMw;bzf+AnN?4&E`Ir zM?MNCi<-^hE~$HC4{P@~n-^>`opfzBeR;NF9G~3)GHyC8@f_gr{qo`v-#TRxzA}hF zQS>ZHCnG3~#U^8yyR9dO zVl}!MtYdyB1;g^qq~Eiw*wrqaw3yEWjlq`Wgr#Qbd_Cevh8sRG9c_N}E1TM)m6DfS zUbyCOB!U^DPl!Ei*=gH|Id=B;!to(ek#3@i`bYlhbale_Pu#q-SV-8uxu%iO9m3iC zc8Tqt^Bdzfq1hbm62>;_^p|+!8;T(qhl=}}&Cl*_5M4Flzp{~<%|@5BFG&-9QV$0N z(mr-;r(!jO-mM?88Do5x#M z^TlUd zX?iRCgRw|FJSur*TzrG$n)Cu9Itex7kKBue>KgCez!IU1j{H$y!^kE*i<-b(}#ppHLtNt?qC3CiI3@xlit1t~OS=DR$OZZC?4QKP6 zrginjUmhb@al+$q4jd8SiRoel~moBxM)C&uE-}y!PUT)_TDc#AZPMxDnXcoUXpV#9gr?ag* z*VZ4z3bxb0ZAIg%p8*UxB_g94Pj+p?uf2(8e8Xwg#SFwJ!U8h)e;wHPPtx>Fya46y zzFWQs?uWvoJ@fF;Dy;^O{;a|WMV0b?3>`=L$Q^~fQRPW1B`unqTOXN1iuqa}V<{db zrsK(Aq5QE)vxC)DHC;!ice0)JAXU=dJ#Cd^O$UZw`l=3|SM~#$0=@{hnPhByiT~0g zv7m=0OlON(tJT$?d>+A9Kcrd=Hi$xR-{lHv+0GS8QiwI+C5MTVw5&#@Pm@bTKF#hn zXd^gHDQ{0HL;Vo&FB&V?$!Pq(LF|tOqVz&jo>aH0F*T!t*iEF`*<_(P zidF`zkkErExCaH3!AA1|WfKkmb~PUgU=~U~w}uN^wWSdRk_yvK=P%?@d6;rAPqjJX z@8S;+VD+62^+$j}aEwM4nP+8LG(MUoqf*FgUOU@!C!W;hc>aZJcT@QmTxugRMC&$7 zR@YAMk;lQi+R1(MqIGSg*z1vD8rCT^C5@Xewzg5z&BIM9tn+$L_mOfl;M>~C$&Lz- zFqSt32pZ3?E}hr%q(bkH?jZ{z=!&P?ELlKl^}f1b(1pp=xwdV~|Dl~H>kuB-o*Zme z5|i>z>~~PBwQOjyC#unxQWV5Ew)dl zDKR*6?bD4fQla?hAHt6KCgiq)0WNPbjfaZJUCmxu0Bg( zQ`Jr`v2olK^SP_}oA#e-ZvrhpnD}3v@-mB$*3ad8nmyrX;ler*Rhk>@R@HUp&Hf~_ zW9V>?C%6`x@~v=P?r?ql_I66FXdQ{jNJNX-55vMW4SZ{V;RGfwL0o8+ny27;ZEM=mij&dBi3Xa&5=e{r zG;UR+Q^l<++Mh(6kkXcFC-=|0exNdK8l+4${YdF>eTlkF?kBqK54SO8h*8p3T%6mQ zU^X(>ahk$b&^ky9B4Jfu9_L688(8vw3GG8x0MaP@q~5rEU0@juZSQrI5p%<{;G$>gfF@8?L?120dk6BL(ck zYJshF4D+X}Wv*I1C>}(*eXGf{rmG3|;|O$Q^EbWovRfPmViUqe9WZ-?`N*ivX6J*{ zFra{DDbXpyEildILA&_TZ0Z^$Fxzv4_`5)EFP`D&g2`D0F9m!yQ_s3`~Vte9}W*_KTCh@XK5G*tzRpD>s!UeH?e*X0AK`zl$oJY z0t`mrvRIad1{K@8t@B6YQS*^zJmjAW>vb*-|8k}M-%Z@kCWRY8NGG7<7{l@7HZxk;fO{nH{@ohYJd~zaC;E|cYSFE-mbBm zV~$1Ju_p63(l&zm1pn*8-c!HZc5o2s6V~@=9}yvzTVG#SU(c|?IoYgUU=v5}ZWB)@kzJWS=g}@PDS)o* zANH`>bc1A~;b<_TV{bz5)MT;8C{bQRHgyO)CZ)t*#HU2VvE(y*4&TIy`gw}=%ZCg3 zAY7X9H?$hQ2a&$5p4NZaTW#;jtNLCm^3I}ZeMa9^ z%Ae^TulqP!KEIw!0KY`Q0}7E54`(`dps)2LeYo5L)|M*1%tg&q8^)bL8)!gpsZ#aq zDB!+RU#LWd)Z`#?o$;t{LWI^wF5y+EDh`uJRenL$%Hm!+wpPk9_txr0gZDtyf>f{4KrA72v(UECiPZ%O6t#uw?4{m zdI(N|j#m}dpK(;{UAza8cfRtNjI-iyf^WCDeOF*ziW8kh2K5+ zyM^bDe2bsd5T|Cd<`gIE(icJG`qN92^)-Ey_1E>UtgnIIk==;FlN>+*rt-o>u&g{- zRgR?9O$q4mtp3K1MwXcVgymGch6ezsi__NmQH3evD3Om^Mb{i))$Z~ zcr)3Fz#xez0WYuWl5F5|T>XnCYgeu^XF8M;vy=oh!UvqFz++58SfKJlW@1Hvle1t7 z@%ltdU~(d0ZZchkm70m|+{KDk;={Q2?RjVS6U+e49h_2c?q_?SpEzsi|Nn&j&y-Xj zd7am66oIQKsQyQ*wf(=se6+6wSljp@@`tcoFI(=G+;W$?a<_-&I+{OI&Xhne3h&L( z?*TrS@j20O4SCJJL&I1C^=I_p%I6XqP?#LB(ERZPi9xz2pnC$kC!l-MXBWF*V45%c zLISg|<~H3fUepadOu;g={Gh0iXRQx>;nxR>mv_pmJ^DX-CHYIAoH{5dYT+4-_E_JG zcr0*XQ1maCa{2~RlB6_6p7i;x`YQFt>OtxkbXJyh2zq&PGWe!pq7b@gj7KQ)&aqxW zC@174KH8;&CVG8uE$0DZU)hh%=H514B5YM1 zrhq*`#Hu6Y{t=vr~%lpMLJkkGJLD z<~3V>ttr05{ta0)!g=V})3ipljEE`hrK3%8Tg z@AeGg{$!32+`mJ^)|7_|-iT|)r;tyVFK#NIEzYq9wf(^0>g#GdI*9!HGf$$UZEer; znk7+JYIA!IpF_{3uNE*HnKD&YKxL*^orc#svxEJm)7XdkF;y{XxG?6?7poTI1CPE~ z{<(EjyGq$M-T7nAhajH=IgdwWLt65c+YQS~Wr@60HFo41uSs#fy$?u_zxc>82V z)hE2YH>3Pr-aejD^)YYn&nSP7w~uC2eZ<=bGs@rR?ZX*WAM&HIaOR0i*%b<5sd3w z5nREALZ1^WE<3cXLZ+Ol%)p#qdH2!|wLk z2E^{1iB0AWP1A|Owch-B2Ad{`O$D6Qa~7GRZv+vE8;){TF58u5p5miVaw6yX(Qbq@ z^l>#U4=#&Kg;U5uov0bhSl2b*(5IX ziHBPt3(ani%dA4O@(&-q+|c^S-beGhi)V5?k?-OH}tSoeS!m>s`67i zF{%;`f|-;S*lhm1v=jSh=9NV2-Vz@KA4qkYTBJvr1~pvC6idiVB=7w|X|=vu4oTSP zmFE5Zl`~3AOw-IG=iGE=D=z8{rsN*JO+!?CTS{MDl=#77@G>mHJbsX zCK~p0lwMo!c6mM%S7Kk6_^C~7G53?G?Up5phI8DPCccQlr`Rv_E=??m8FqY#j^KVv*=ygdpO5|IyPte`07 z_+x;uak*QP{oZE_dKuWh*faWKe)oP$YYLK?IdH;viH3hUDxYZ~w3wb0=N?a@_E~T4 zc#X%gP7TbGCW!R@$cyL)cF}~;jn}QM!D0Z~S+JYghuO%?gdm9qZw>x*DB}e;XL;n-Fo?fD9}`7*op|x{}X6bk)Op0$}NU0h%Z{plwR( z5I1Wiaf>st@4&=qo3aH_R{x#VFgqc0lIWfDuj(YvZtbV5xb?t%J3=UZ>U2(~U8i$a zrmvOGX>{dSg39i!Bq zE>-etgiRf*)J`rHi!fGdQ%_Oqw}U0XPUVsG64KSwr6dNiKdsKrYX1eVUzycxd;I#p z6;dlIZKK$cIe>TvET%bmklHPXqk*^38*~Z|^k7HZ9S6|c&@|DI?{Ijq&f#z(IH=0F zAH{wPCi@q-D&6YK9I4QykG9ftT%}=H_*NP-8bDlIgJ?)6vA$NDe;g@@TC?CRmzV&? z8=I*8xkJq{wMX|^1|Osj$2Zn*s-$02Rlg=DZ(b@sF8Wfpynah+3X`?7J93HeH-wkv zuE?YBn4;UfE(aSe6mbgR+}i8%I$nEbvi7>dyws^WdpBZlF%2H6b!G^U9F{ASs;|8j z>DZ@Mf-F=Y?@LtvM8hXej@>U8CEaiW2qzj=y2Lu0xX2tuVo;6^Goo;g>4p_oyRw9N zi?d`RXC`*yCcB>xHT}q?Uck-TK?1HHuh~1_z62<0{=opX0xqDS6*SsThw2l# zp&FHJL}BnwCbqu=`P(4!)dwErITqwnUb7(E9LNuE@F2H0t9tf zat(T(jPQfGaFDeKi#U2B-Ok~73L!41hz@Rss=T^`V>F$0Uc0KeELa=-oQWL^qRt%o>3!egRCf{a zOJ1{gj$MaI0};QT=3Bg-$uO0eYlsSq;C~V|-#TbHFG-GM{eyj;gVz%cH^>r#i_epI z9B+D;iY;ZEMeAgU2n~y+x00-gJ`H0joj?oy^9GCA=pZsK#B6!7FssbPY=*fBd zoGr{&wu;L#sy`hYAf({3wt;9*Xj^$x2X{^#5kxwLaBr}1*Swe0;@ceDbqo>9Hl0lo zaNC|@P;+7Vw7d^9nI|$+@JH0?I7wpK`nIx)jpP$9e}`xm1n!%=dURRdBEn4w}3f)X9LUJ}>s4cja@k z_KlrfDIFDk(SPZvF90m%6F1W*JH2QA;6Hr@5p`Edl8S>^(Kq-NW`d3xe!p;V>fBuN zFbOxNEaLM`=FZLS9ey0*N*%s|wR#(=(>!;DmhRp%f3?30%}jo6?X5cRMkj5gNKPlk zar^|4&))H!bmsPAymxrb4vF>P&ye`wde0z5=9`^>iC+Rpb^*h#A)0dvz~M4hygXZs z8l5;KbuKm5Y*}LqZu}rJF|6_XBGq^%uVRY_MdgNTXlr;7_6%FEndIs`WXn2#=uDlP znb_6jpO%PfZZfd@LLN(rQ`VUW`Nb%bxo{p#keXoK3G^;XK#SS^z0H|mG@Q4{-XFsE z(S-Vh8%OVym}5|kh$q4Ed6^kO?Ch_5(Hk7#ZZS7f&OCB&*i*W7W?mx`US8`-sEGpC z=W^A%(Co@@5V`(sPvgzq)Z$Bd&CpODw6|$I7U_=okcO?ducW5x<t26}`x$plnHRJh z{Nm1{boJW|i%jg)wN^yATgbKWqO~9V-`8qB&X@3KzKol_2dKf4do_t5l3wB)+|4%l zdS0_9ygIv?kB3HkYc(+bHbOW?oc7Vj8v6(%@ z(#-C&{GptnG_0f2TZy0*L(c4_P`YkiZ8WKY5l=0xT*8g((1GFfT+AN?fdus3-a zRTMB&56N~B`o!0ZJpA)5{1v=r;a}_Ee{zk7zs#&bf&=(n@zyUJ1qYOYrm<$F+^5B?%@Z{%L&T_wMQqu>_z3l`e?ccK{jA*I=NhWtsIOp z7^Rr7dbevr?c15WU^HU@Ic=u&h)z~NAQPF%w+7dOPXWU0`pEbH=_MOQVA3PDGw<@f zKJqq+X2B>Oj&5)9&umDEFzW(7Dln661J!6>Leb*KrcmN9KJ2Jx)1Y^eF1( z%3o+h$uBiKzUJ_nEe?hjdq1YZP_*VPM~f4Es~)kRi#}3vI(94CuBq^q-{?!Of7F(2 z^d;W}5EI0O0($GtmcS4DPg9<-XH}|M;&ax}tyeK^jt7oOX)GcuuL&Y&lG|!YE1A*i zBcpiD9%wJ490UDi%2`?Yp}CMbGl(1*mU-Hi*|k%;&CP>eu~{&Y2NG(yeYmH@$2?vhO%J{ zyf|CMTz|sl3X^2@zfA1G?QQiUKSyZFh9ORdCM9~ zXcLaoOr|xRQ~H*rCoRDpBEg%E9cf28+wWH3LQ3yez$?yZ^XNx1`B@2zt-o5*r^Vbs zN?9`VluLM#_SXZRdfI^+>ds*U{bKm`v=)?>IEB%R7RF16E{W zYj}0)U+PGC@>mk430KktE3ep|gR$vhOtmnqt7>j0)|f3>^QHxtiM>P;daJj-vck<9 zUe=TC{ZZBG)m2A13VVN49Dfws!>+5YtUnvE80onWW5TY1VpmmQ^nO+ua2P%vTY9Ak zyt=6zAV^_%EzJtEC+0&Xp-Zgnl@|z-_bpG4{8?fQ>dQe@1@VK$^(W=SD5_L(= z%KECjbE+Er1n?KmqTChHjUofQKwlOv@O^nxC-vp}`Sj(5;31xU*-a{&ukd~OzS)6k z(4@hcY3>;0GOSXvhS2fZ?g3=g5d*-^+Jl?#1=gB}l|cQ7Xj`r;MhsVZxm z_W=+Mk>Xz#luMSK3fpQJ+`OEnM4OUF`RTJ~>7ZbuVF~|pIaV;gzC6#IyuU=8jF6f^ zL1cE5Z|JcWmA~_vrQJQSbLk*A0P+9ssj+55Qzemf?pEZ!^p|N~Dz!3p7|)Uj z7cuXFlH3uu10oUdh(OK8cPX>3sfXwuStGaF!exC9vl5WiPbu1=XIEV;1~ha z%78tz;5F9nAd5XEd_VpGUUhoxI8y7`+E!_U=+P{58J_w?!(*;14zoa8%s2bO0ZpwD z?U{%jtG)=8&>dX0D53Mo!+j7f$UHY!D{4(=b%C}vfiOqyUAxlmOBBz8vma<$_9~qVl#4G$G zLLeQ?1c2CGL6N`Fu&h;IYA%2*vdT-t4Tg8{-MnrOCczng(sk@&XJ?s-<^AEj+SkX5 zEw@;4Rd6)ir(v*&Wu+#q(s3Y4t}aSD2y@BX=-h&?R+H}jgkaIS|la&NuF6LGzH zG{0RZvFeCD|2p5SuvfZ>$5Jb;mA=Rr>vMF{2=_S4x+A{QsB+7?N80CbS@$vCvdg-A zP@UNCgFfP0?|inEIc1*zE5%dx&~B2a!qM*PLO&iqIovn+2ZmS>8^0V6dhiwJu__1- z_a|IsmGxSFyw8e(bu#k$Cxbd?fTwr6&Pj*L`cjr_`_rIgw0x;llfw6;h>YA?5$T|Y zI6oFKje_C7215N+sY* zU^t*W_&yW6hg*v*Vz-K0l6FpJE!Upl4#SyxQ) z?ymp#c-l!EK>&gcITys5f zcv=_Q>Of3_G-%PfpSg_PrIL(8K*?%oi_9}wX09nxdmdW3G1J=LerK&|)fbHa*v?CP z(G%>RXyM$5=|+nc*tF0bI#pP$1W_Td1{_=0V!#Hm|9qg;rA6irfH`R#?sgamz;IaX zZJ)zok>)KsEDA4l!(ujCyZ{vfh&mFPCi6EcEgQTpdP}}V@-4IL_4>BG!pIB?Vi!=g z>1pew_ZFHF*0{RGay*m>Vim%zz5^x9ab&Z?Mwd}3Ag9cZcE0o@Fju}z)LbbIU-E^6 zU^P2%XClj9yA9Ad&W<10Z(kD3oF&^FMvb3~2ofMQM+K4mSN$NWU9Um()4zW?h}NH< z9YovbF^KBl7E93~5*S-bi|qdB68hiFKE&c1#D>4`*82{AMdqKCU4H+`pFeBwkvr^j z*drTx%l62XpddkYPzf_jY}0$$mAc*7Od~}8*Zz|+q59C@;e+V7q-VSOketwp#9}Fp z^Sjd*OerAro-RSAIx7v#n+5nlV|CQ2-8*l|6_<_`T_A+!o6{GI<1Vxxi4XIy&@*3y z3iZS*p0s_}iL?*!+IR_ck+%GpllKpu=SjQHJkO-i08?dJ<<%|=Zn09yZgRK)s_7X;rr3S9#4g?G;z?Tnbu^_Z_ozb6CYnfGVIZ%i!sg zh;IA-?QCus#Kwjh9A6lfNe*6k?RWSsa3}V!P&hDo(yVV#CXswU=>+=+?ptY1j5CAC z@gW{>tQ7$U=HkJTDVh0$Lp(N_YVa`4i|DZvB{5sftN4r)4IJT8OLwp>Z82}Mh0S(E z+u_LxR_9Oq_GF8hZc7sGT_u;EBO0}s+bJn++!4}Uqz0YCYvZM!XAW`=x`5g&VIyV=6Q4yD$UX=Y`>pH> zp>*c)6f}b!Xqf)$owH1jn*Bnb`FswRRR)jsnavZ*GEs2ZWbK)|yu~ zBDNC@w`m(^^8b`UsRL^_=BIYA-55_rYd2nAGqAC6D$53s0HHBoPxtDnlb*DW(b!E- zwLAsQ(^?+^L@K3yLFYNu?_?0ps(x{EDZLg%x`!CvzD6|en2X^AhhgUs!|hFPFx04t zhw5TyV48cr1#dQYqp44L}c;K@3?Y4Sekp-Iw!Os3s?Kw0TEcZca5F8PL{jV7= zu=CymtWK}0|CT+iU07O#W8^X5G*O*|-y$4)e#gp@u0lNHiyM49M%oJJ@S1JMHLk)p zCir%AG|QP-%t=((c0w7o0RC-z+gswlbC|9(R}QorvO;~L9D#6TdA~OknFR^ShQy5g zBNLg|%4g&cvZWKjf+ekGgO^z=< ztZI=4Otbk3uqqUH$;bHQV^~5|^8O?@7D9jJo#pdt;}X)O(drDuZ}xdND_c7DJgyPt zp6qjf>5>nylQHM7&_e`ykp&t%TzHZD;@ez>I(x*?xqW@|jXwDi2V@}k1}b+Z=5pWc zlJo2~%x1IBCfgHre;el};(xMig$1G$bsL&p;eWWK6N1QdFM9qsc(oYv5ngMLeu)3` zYJNk3);D`0z|5Vt0zvbC=F+sNf_jmoz{#D=qE+EipXgC6KA|Pz_tsA~Z zjkJj5mj6QXyx+=-30N%40}jN^u@|COPT=gq_4_0_H&PWeS9F>ieG!om=UD5D-4ipm zt4ddNm{HxKqW0?!HUA0T(T$RARp6R?Z^M>2v;G)YD^spMtN1Obaf^-dGwhbf>SWVg z$!x8{+3@t|ozs4w!#TCrp3)HtkLysg1}9TldUyw^HKj~x`o*_ly+~XMsreNKSWdep z7?eW>`d2Ubjy&gkb>vcB8!rPJ$@0_iD1AjC^0{6r8XPqF9L=T|+>1`vm}mVLg*`UEo8`X9(ljxT z&Y$#>^p)PDmzVvE^h5KEttU0b>|-INt~3w2hl|ZS?%^ym%)(8LGl@o3kQ!wsxs(d? zy?cn8$KAs~bGplOkh$AE>|>hU!>*>|%eMHAW{`Wxxs=6@b$7nRZ8krCA4_kBZQs^m zWY3C!?MHW~6;}%X-F?0wa#|5mMGi&po#zgEm;#uU)`aN^N%YT~X6 zUMIb;ZXFI5YK&45=W{+1-D(bGutq&z19S1Z(3FCgWZulB1X7ya+Q?T`bVzPRWB+GG z=v~|=ZX?gt{Dz7iAMXfobZ$i#m_^J7s%W6CsO>~O_v1OJ>!XQM&en-`7Dol4L46gh z88w8uX^fdx%?bFpkW)T(5$55AZ!Go+W6f$EL_!ifYAWP`r7ms_X}U=)s^|2Jf^gNY zu*bC5SMn-{p4>nohlKjG+lGE0In4UK95V%xfnBpqGLXTSDbJ}gAH8bgN;nc zmQ;hD?xXoXdaHsE-R`!-n~29ji|Vj>7T|8aBKhNUD>}(nG}NXq;7rl2{|3R@Ogwsn zBF?0T683Mtm@A&_#Kx4JdL{=iy=r@xFnDpa_I5G_i>7^gEE@%{E66OUT`)T{M{5Nq z_Nnei0qv>l*IYSacCsI_xrUU4`s^L(_(`$UTO`A>HV)9k%HNH5^vAAmR{A(Yp8r;H(KH*FcRQ8)&kdYBHF=>|sX~ z!WE&4$>}yv&uN#ZM|_!;r@G_)s?(e}(Gqfc%$4bpor%J8xtS^>tS3E8Tu36Po05k& zYEKA`Q_)E5Ai0r9S9CN#t(Lx8BVfPrz#bB?>MPSpfW@yh0|d++zF~to(B6Is{dB(R z&5t}iqo3o~gZK(9SmW@CTo4zURo}=cBu$#wL}B7wtdeGEDQ-`lwWiEJhuf&NrxGiK z%5eIQDm2q33&*SX%En>vS4~_^ZRugR6Nn+-q^Y8+uyT=2lE8SO&s5=8`+Buq$(ZZrLnrJS_+q;49tyi*owLGDgF(t8 zVV%tA|M!p?!|QQ=%>75>fB52q?Bu%t7h(phHYzgp1>{jR3K(VUbUk>v zxlEPlaJni<+3o)$ishFe`o1}__UFvtH&Xj$vD9W)pzR7Ydk+VAeqas~h@|Bx;C@-<~@vv*6&HhMvZI2 z|0~bt)jv4i8u*NJWs8hJnc<;msUW9?*O}V{8&EAy>{BLDR&6JDTqa^EYZ;u?hZBZUDoV`P>trGQ z%TAuCZ~GuYq*&N3h-A?2D;<47`xf0l$ERj*lWyOIVKSJMmOC=*+@sopzbZ?Ww89yo6)VYj#h6nq|IyA@G4? zT?Zdbjp^zdSg#yebGiA+Sk-PnTWgD1%b3 z`y5>JU-P@OLg%^_bG2g}rX#YL+8|_=AlmvDOQ+fHl#n@}%fB@#-$82S1cZb=n|Bu% zx+_&nLz?w*$lCPDK79h|ni4K->7-GiiE%vQrXpBlN>6u1<75#}^qqo;kWG2@0IhWR z2Gd_6wpd}M2mmX5vV&y>b+l!L)8s3)+hxiI|M&V6G|^F&NBbYXmgN-ImLiXUS$>AA z{Wa2a5Ho+`GHW&HNzxUV>*s5qx7v&=n0EelliCv$CMZsX_?A;+4aMZ|_nOOfU$WC; za{^fy1QWrs(ihVv`M4@$cw2w9W*|nD#?PDOR@5KS7zdD`jyJkb)xY{`4_At6velY> zc}@I_3M`2W7m6L5P5gIkZx3E?oy9z!y<%!GnPAMjPtqiD2U4uaoX47>x@PfPR-eB! zH#_lTl>O{%_9`>TXMe)eR&pe?7oQ7+sQ_z&!GHs;|g=o_X~;tw^Q{ zl7q13U0~3)fJrn==Kt0XwqE9E+h=##ywSRk_yi=@CMx@kHP`u6&3UBaHI=kG*QaU% zPjZH#8eKrsb5bnAZ(Pe6*RmFC-Nb0j-o{}XFJly0w%KvHROQrV$$+aLndCV(jS%5- z#KOu6pj5`>PQJJWZ-MD`+o0y7SOIDnOxxcwE#?!Mo#a;866{5@7wfW|6YL{mYG5WB zo&tR+e8-76(bY+IW-(p9kRr4;#eyw;0w^=7H^fcHmW+13!TnJprE9d?TLn=&uEil% z?Z}bvp+D~Km}i`2W&w^0V$SsycXUQo!6DW(BuQDPiMo`~Ui0gtC44p2Aq*7CW#)!< zFsc1K04vnT^ff!bXAdnDTh-RC9||h&G%Y34NA|^5;rt0}HAiXXwW2TI`nLX_@(u%A zzj}xJ8Y~jcVOBOJEi;?R=(j6kV=0Q^d~-jW#A#YDEiG5^U1Ec3bK=c21vg%=35h}6 z4|!|9dt6c4bI{BBGfxbwUEb)VYO|R($#%;I%f`*-23{QuOHxlj*S?*@(!PD~XWK{r z^cQW{?C2?QO5dtr36@3bnA)!+sou34I;XleAPeLp?Js9-0!^c=Pf6R5DhArf^69fD z4Xc_kTO+`77QiZkx7&V`3{EK4P%K9Gg)HFrj_s4(ve_uYcwwmUv4+lsX8w@Hxa^fC z)EII?PJj5V=kXBd^>&NpGO8xdFn615+8*<{*`9Yijzxwp6`4859a*+rre;V*?fQb6 zHbRb=36EKQKU()EiY0?F?8%$27)*8upJ?~0uY^j>DEG|WVlfekO&3)<9EMe$MHmA@Bvh8|hgGgCwMjRiH|rboj7x!K3I z(vz0tSrC?U<%ci2hvOBsB9cz(D8=mv0P`~YY&3GEElnXooqhx)Ojlng1%%MxX8tFdK^(sz zI13T~@osW-G{y5#i}L2h`x8eT0Z==;FTZiiwTxhWbEVoF7|M?mLwrs_ZmdWRWSd8l z`t}E{^^n!9VdEKTrKb5zt@#cYDB^bViT=`n8rQl+S#rmQYRMhnw&88XzTrQp;qu3G zegiO&z`V--PrtPSJH2Qs$vMq;QPC4-!N<1ww(qdPlWNi#bAOc(mIy=R3iH)8)X^Zg zzHd-a-zgZ{t$s+iU}%2*kbDAO5T=u87hJ%|b}A0y4Cz6vDQ>_ChW4o+(kJ@j(Ec-q zAY?|C8gl_?D$1mN9&;ADpd+24w}}wAX(Ao*3R6wvXO)2)VdWfUeoKWL<_J-X)(E zxFFuOlMC~>sY6gEciSeI`pLP|LOXa{a{32gQ9pUxH?h=aI!14L(Pr58T`G8;h$a@j zNvB3?C->o~=nR{?WSfW}I-|FqYqOS+l~Wtk+-I9vYcoIB>=gaC`gcpR*%~`UZz`d1 ze8yzIO=hc1Ts-T>*w&?!!4QIVcGzZ>7P|!+M)i~1`#rZmf+1rQzfxGElg>F~q_)n^ z6PAO_1gvFy)9d72l&^ghx1(h6{Ww-F{Jd@ zT4eKjxte9F->fXiyO_UKpAf}@-+BDye_D{Y8-IiN8^_<3{5{X#LjJzz?+@hJfxm6a zkEgnM{$H+3oRB@l$seJ;%InOP=r2glqof#&<++igl`L(dsqxD|)Hu=9idukn{H5u? zQsPFlNV^yT+#tYd&fL#|W6|KZOt6bggm@JSxrK{?=xw*fAHD{$uHZGx-t;66c(2)ktt&s$>`*$UkK+W-e^6MGhb%|zf)(V$ZZ(gz1`1A6;(_?F@WjB&965?wr}UCki@ zRN~bNKFF|5osg(C9a4Sm|Gg6gzD{i)YH$-1XK)7A9KWJdURyWwDmF-4#FX;G*{8<) zP)TLa-*?jHtS0FS1S2tf{g!DQ8u!5(a&pbIzZdD~KdYxqEPc&IK(=$p#YiLp6^{$( zkPv9=!+a?p@NMOwOG;C_vwumQqdkMsI(I0J)vfvFu`fUk%jhE}K7F#WLnrK47F@+$ zVwd)in7yqdfXq{Wl>RL5VYF^FbrAt0Q?qko+9rEHmNj(#Ej-JjRb=|MricG@ZGp+V zUw%Kc>^`XuhKe9n%^{l6FvZ^0WxerAuKnc~In$zF!Xe`5t(q`Tza{1jA$b(I)LgDo z)xH!b7HlcTo-I|%5Z9(xmi2N=-|>yiw(C)4noZ>tjF)JwRTL zY3-mR+hONC4%oIrK|E~^KFp>{oXh9Q$0y2Z8B9H{HL%PD7_G;aW28XhlHCR?NpmtK9JZ=UEcN*MHHzIcqt&oS~ZY19Z&X>2VP*!^il6_#W z0#k&kOP75KmO8CRGtqTBF}i|c^XVuN1Irz&118~o?1}OSrCyX;@8qapwXVM^XTdmb z-5V~-@T$%h-^$>!VtZTs)s(`c$nlKJKoRtD8N+2~*_SwW(v_&M3N9j(zcQFqA|>po z4mG2+cXvOz1b2Ufa;!sfH7SJvq1^1}mim=f=Xu-a5N2w+oX%Do6B0}HQahzIFIs2!V#|G4QJ>d#Z^a;V2`%wf)}Pg9l3WT5 z*r~h^SYd8^o#Y7yQT4`9O-TzA4K3hh&Sk%vwpv51F(EGV%^?$$^wWSp20RGqA1 zX)f5=dXq`DZe=tA_JS~n@x9bqhUTxVNC1jH7&=zriBKUrCuX^j@R8xRW_y!+HQO)b zE);fJ*ahF#Wr$3?PjB;+-E;OdFkq1GluQr12L{<>&VI+67@mq*E)4C3J`pb*mob5L z#I)mHrzCd5wQOmlomt0&HBY3NXuUq!0}Ev(*r1unIw|Hij)u~1n{2sxhgz-v>s~;q|-H~?Nz|39nBu+BgJ6%K{!EE`3R&#%B;f+Zx)Lp_Ar|c z9#}5nii$X*8v)pjJeVi#H>4%CwuSOXU^!6acIF&|SE$ib_+#YQ>Ji>wet0f^>+R^> z27Xh{+X}zl7C$Sl!46ZI9g-|`m?P|@g8X-y7bDi583q&I-~C|{GrOZF%GE5UEOT~F z^tO}X)@a>f{GWNVc0;%5O?Cy-8Y`FXXpNPr-+5z2qWi+sMvR7dwC*qBI}%Q{38|=! z7OsQ}n{ZsTZo1D=O2W~PV&bH()c5`Ms@=7^@S@rD(yQGmJ65k<_4+4$t$iHX&?`1!v-w!B!}Q9{c-()g*Wr3ClAU`e^|!txB#26z{|vqJlSqb z_~gb(<@naQ>HIVzq_7bv|D(IQS3(>2k%7LnWD%D$Dz+qArhab$Y;NTo|VLR&2XgBVB z8c5Bge5yAOEA_C0)T|FV>4PZy+< zT}IwByLX!VVOed6b3UfTGbuSdQ zwNlucd?ciW=BEm$uq`qx?!X(*g6nDMWYXFsu_o%wm~Ka}-a>Y&&AIX`&$rL%XYkYd zntpW1DGAph(l^r8%u~zhlfmW(BF}FzQcQosF^K|%dztMqYc}J+4EIv88lD+u6|e=^ z?Fd&fnubN|(r?-ou+aaU+U#kq`Fb;RBXd-LIKvEQOQk5uQQe|FJgXc8W{tfN6XYX% z!kp}I1NykR=QPE8WUPNNI}&r8$iBa=Ki`h0jhlSMnzXqdXf+kT1O;>--y$}VdVk-c zR6o-b<`>m}@Mb${+IclZMArEf{-Scd6`5h|`D3;d;kfE&D14ykfdp;k>-OeaRxwH8 zZFcHd^vRwxhV&#?327z#qG93JlRiuCL!dJwC{hSsiCH7Xvb$*qo|FhE)+_9-c9fD$ zL#(d>Na$@E4E00WeMVl|g+s&sdVVPp@WmTFsqn$-fZB>w8Cw@kJt5}k;bK!F+}&Md zHF0@Zi?q3)Ek2 z$J=ca)~@)^MRp5FoXk=QCfapAi3Ln+q8D*SmMvN6aj&#ln@uW9b*{?7RC|#%iqKZJ z2r}jQEtD_bGP-etr=-*=PSdUfr;X9b<)zpXr`d)}ONove{m$$;WVv+8zLE{{6O{zs^1M3fxhvOMhN6@Ge^=PoOf+I7J^v6OX zvA;KAq<&MK`RQx*^DHXNiX1Y98tB#PkcTzC z0eI1AI4IG%)kn3{=?!z|8`~11c%O6Cu^drG(A6#V&Gv6t-nw4G&%uXg>-~!QsdwpM zE8gjy`DWK`*NRyC$BjRGFBpg1?c~*7LAVrA7`^Fi2uGLPT@ZH3P8+jbqO-0w?af~0 zsy~J5L-v?w{_y&?njO4vUi%>Qb8l67?ax2g9L!=skE3ugwn55@AkK8lQ2Tz&<_u9( zYgbyIdfZ8PtBEpx?aIVUWRK6dq6bd0Xx&usab+hVN4bMSo2SHctb_M3m!q{Xi(Jg; z&`7U|sW(5ui^rVdhW_g^((_<+hBpdIFZ0Q%q2q8Xl+D?p-)d`0+KJ;Upvndx-o7%E zi@X}F)ek1ZEtS>u@u>f-etb$pXjRV~gQ2~z;Gkb|ha(Gqje~Id+!_Ft1&h*cLPa>{ zE`H>q>!-lW2WbkF9cadI3%S}inRyvmI4|iIKl=N{kF5*a#SiA^EgPF-DYZB5c0#k{ zJ-faj?@a`O{=(<*ckA?J|1HRyysjYc9sXXYTt~|E=5HW>WBI#+zvuW1l>k3~wd+gG zKZg2}UEfdunwh1tKbD%`qe?L)*sHBI$uFK~7xjnf`LL_)0>d$SUU#W|KD3eVRvuVi zG3(>Nu^QcRO{Q+nwuVL4m}$HZy0)*FBpN!avl#cA=550O;J$l6i+_Jam4KIZ6~GQQ zsoAWwNf^A`bLf*6+9b9QQi6$z@oFFh1 zXX0-kK<%cVSIyd1Ii#IYgvoaq$gd~*c`YY2WCc8MxI_Ojp|6=XM1RS@9r{~pVy+GU zw7%)3(&~4Wwd7DFzB(w=me;B zhm5C%ZLfwS*Zt=9N3m;KWl(|EDV5XimVKBeD3F=mLn9ZD_34T7$zUwCuBgecAm*G7 zu-K)FuSYw5Zii`BpL3dAsKP}p`fkj$6S+c@(`&ZeF7_(+*azVbAB}MO>?u3g zvZ6pc1KgLaFKByeYXxhU!>ls@Jj#5XIrSA8X%wNPo$IzBKxkj?^u6ar*_Uh5$#o3( z@${r=Q#22{K>Jxn`mWsv#M0H5%Ct-;4>#-nWjoedmolzg^XzMAPpd8Fx$k@(S^EgZ zp{qIndS@R|<98sQXc(Z(Lq3vObQq7MzfZb)^B@wpX%=PM^b2`BIIL7w`Wk1y-UK+B zXreY!iB+cMX_-i}=^j6aS)8?mFv+&NixYk^p}jO%=ht-H}i z@b6(;RiRex_8|?ZA8HkbQmWiMz*VXJIO*yu!YUtsS$)QNA?xk;ET8Rldm#cYd)9Ky z>pwwLU65dzqJC%(ChdC6VHz0eb30=A{@w4Ydy++ z-C~xXVy(vmob@;?iS^j0aU%GNREjA{GmfAcsEZrZ!`?7oH;NnD_Ge4*cza9$zl^O* zWAi|3H~b%6+U*9KyXEuBZ?gEY`;NQS*qAK%(&}V=V#~YuT*o=hT?muREuHH*Le3D4(Z)LTUmdx9Am#G&|ztO8dFLWB!{)BJ| zi{Xo4)H2vBCK%l4*PoPVkRFH>Tzs&k;6k(X14)NfV$!`pe-_Cai}Q1dm@vP4$&SP0 z#F5(LIN#idzL99q8Lzg&0c#TtivVHOK+{T1HGsK2mB(~uG-aq_gU^knh$ zqs))59R1gLCc*uLFUsn_2YUUN`lbKc@Cr!t#kjO-LsF9cFs|0**)C12JIg*xB!6^} zYnyg1q^mDM9$%yx=f)R928rj+hEO3_3k~-RwQHe2zr0QDZx;~M*!c+s03^ zoM=5va*IiOd{c{!Ci*8a#(Xwwm=`KHWooCCu)4mqrcd@Rx*h0FsCpAENe`Qg#Qxa~ z{-ByFnUuYGp^Y)sR2% zdWd9AV>fVhDrT9v$IihejSU_AlY3^iW$ANC(l%k>IoSYkVgpckB9KnGCXTwCD%bw-^xZam z7E9PwwVN}w|FUnH)c&>+YSCb-qcKr6Mxh*N%*p2O|DZ7|TK~j1dJBiiRns!IuX;?& z*uE;Bma%;`H+s+P+S!oSo;Vn6YDOd)j;9o)dj&-VowTDl?0xx3t&H4WH75BkZLSTz zMILf+oO=||0@%*s{FQSL-kh8E@HocM za+ye4JO>8Bz45fm8^QS?*pQb3UXsCaINP~GMJ(=9gbA76B*-eg#eA0 z2q;o)5--)Z28K!8>?sONz>2=Q3m;0f!$`Z#h9CjV;p5eU#ngl7121>ynRS|LK%haY zh+vr~*^|a3bAm+UBqU6iLp1q(keKzczMi(kjd>|d;g~n*CyiZckR9_kKkJA!QE;6= z700pl0t!y_k{~xdJLbwk!HSI?2E5IqB*&IAo`P}ce>192VwT-2dF)@TCE7R9&&@I{Jc7dxn1kE5c>-~{By+o@|swE-($Eg?&`bAEM3 z>twmBLgmwu2T`arpY6olQsJ!CgObE>{WUOd7HfS?HGR_hGC!=t-vhH^!s)G}SgCt}VWtWX+M+MWAElb=_idwG}U0$?I^#-6FFTeE?%p z=Wtuhj=%YJdHoW4OOCuA`?O#SQP|Di4e2&$_P2-ew&bwd4V_Y*Eyd?1n$)*>_8O9G zCg1-bdG1Rf;NFA{tY|BfSYx=e*K+!Ho*{gHZ@pja&+P!h%~-309=Ncgb9YEl&7ISCcaI5Xytb|DboVo^5SNpua>`AMn z{K<}FHy=L!p`~AC@OG8dRm;^iY^2PQ1^akevl|3Wq>t<1L`XOjR@D>UgK5sqhrA`y z@lS1v+<=plwb#UngeZXOk5K9BuzR?C9Wr z^~+&_ocB=wcwxC8F>LyjeIUh?t}zE(?Tmy{^Se_wW+JR=XvylTgKC*cGd26!$iY^#xKIUztyK za`?^Ccw@_fIcu!d*R7|d*{bQEO%kTEf7#fvtIcSR`9-dOk*k4KXg6(y^TCVDZ0ot_ z1QfxLnLL?HG^jFj^9*+RNz%}i(z)UMR_990ihF$C9kVq)qqf9H8O<}l$aTOr@!5B4 zd=j%(f11sCE5DM+HQ{H1C z1bG~ZA^0XLoc3o{AOsg^;}5rol7dXAj%!GBy={VNW_C@nD$q8@M8kBdX-i0)G>k?sDR zjqlrrhP#?Km|lbBLrF66aafvppJ`%n{EEX94QGM0DE%#zg{FrJC+Xx2!Kcl;k6Dx$ zKg=>&Pj*F+;Fb8o7zo~eC@~e*N1R$>^SNGZ>J$gKb5mNoK4hoRziaVT9y5Gvd@r!~ zz_#Oi7WiJCi*HAUEBM~95BSDHeEVea&CZ2{n-rqbyP4?G^X*1$Op!&l8JhgfA7|P= z#KL6$3~`r8bdm!J)b85;1-(mzfAF5CH*R0t@IRO*xiD4q<}h?TwS$!YEf4*vAFS_} z$Xue~mY-XDvjr+kt*k%1y?=XeUEh)I^<5s;7tiT4)h8^x%b8}21Xenm?;g&#EzQlJ zQ#p^}_<8JI-^^w5pcd;GeOYL|GU_B_4>JdUg>QQB($sIV3dRAhuioFAzKYUUSVY&D zNw~f2v`fL9QJUL6C)3HzX^19v0?8@;T;QgqyiFB3ug>Ls-SHA)%6IN~pAZvES zMQ3+@;r~D@Y5kEzk5(`5XW7B|S@2JB4nA2sr&QZ^TM~BDFIb#HZKm!4dE<|#qn9G5 ztsgq!u^0u!Ei}xfGub>iCM0Wgx;D7^Dtr1WySpmOf}hav<|S(9mD(td&1TnPxjCjB znrIk9DQaJ_r_AMM^ZETk;F5Tv;cEBcHT$8(bg?@l+WNa1YKBhTd)?FtdmKA;_#Pn3 zO%pBVuLu}MjQlfW2C4j(wxgIaiA zeqP)2+wNBEo;SGm)l%;}yiS(t&1MHQ4I=BcO2d!VozMCax3#C9t!+Il)zev{KxuoKhaw?tCHD}A^7GU-*XK{i zI{WtQ>puQ|i}qx_A`}3cWdwuf`K^~mi7Zpt7bDu({L}L?dj^t>15QdQ(yMS_9@m*l0=n&$G9K)7R0Fb zM>9}M$ht4%hqfmK`a^aHg!Hq86lcK+QO(s&LnTwB!uhZo9^VqdUD*=iYySCXO;QpC zspFWeO3a#oIwy?g3bV*E+hxOx6SJyS>Ke9zBpOZ-RQ$E}TeCSyXuQolVpjNTSNl_^ zj%;nMk6aj5s`wM%YoB#Gb`?;xo`3A@ESWTgh58fxJH!70ggKNf!TxVY1yvw zS(72#4W%Mc+%qIZD|JNkDOp*p2WKD6Yql+|3{YY#`bxt&Q_+GBZ};Z`tdw~e2X(L= zc}lQzSX4g_)!Ry2PDc_E^H}g{+Z6++Cc;Yal$|-Np1Br9a86-Gu*6(OU^7N^7myLK z%KGg>%J{o5EIxh3lShR3uuix{R#bs4gdxuo&~EV?it~acTnSf(vd#hh?#aw+1nk){ zQ?pC5c0+zmo4vYP?hYIrt*1U}yXCGf9OmD{=HJdA=w}P84)YV=hbw_x=D$4>hU%fH zY>iy`G4oAJCAZzgyv9LyD=}HCW>*I^F~_FiZs^^Az^}&S3GL+*9W2&27_+;$csx^g zW6btr%u4Wuk+kfA)`X=Lcb8(S%C z*~y%Pr#CCkH&Dc?lr1si(H{c!XsqE z0COJ3ArvitZwp+8>g4TC?CX(m7XC>e4u>tuY+TVHnU~hkW*wV>nSU1y-L-xQd_J_q zinW09Isj8U1rJ$*aTf=-lff;~aJpEf`6UgNF-Zh>oK%3u6SID+FP|b&D2h35&n}N- zS%rgzZ|M3aZ**LwKmgg1BJxPzFHzwa=6i~0r`!rHd<`$O@#T3S)?n=2-ooHYWv#Fn zSiJsiQ*}he3?MbppamatKTf(PF?B<0Pvs9gME&9Pea>^ZxS3WLIxMW8V;Rzg6vk_P z6=%A2YE9d_hci90y?Z6n##}|T0majts@f*ZuN=HObwJ~-yl6JLkzXd4y+L7?rdL+c zJD8vD!DRxgWLllL8eU@lF^B^Y!*{J+cSgZOSp{^j4Kfkg8_{OH5kxtlE7`~KomvXqfx{ip_^scf}JSwa)J3| z9G!8--Enso#UySCTY?b+xPdD!qZL~Pb%d};|L=S1-cAS5Z=U~uejiESTes>|)u~gb zPMtdE6e3=8>mSjb zUyefTd~|MPPZy*5IZQq7vC;5Zec5n>dyW`qhvXF@dRx=xl`R$4Jwu+8Jz1EU}m3Sq;g;5vebF~xq^I&!8Vcr+0N$m*QGF9&f zAOgu&0CAnk$ejN=(VKJcd-Ga{)@hjm@1-_GLl+082?$1YoRHbs7?nsn#`k?RL4WT54^DqI6ynCTMo7#jJ=b|JgDyAFSlSOeio` z_8DBbDKxm=Minf*1-}^j8?!nH<$X2c9tuNkA4oGMWUG0n?8ohT38mOTlp2;$Dp_^W zr5QmT9mJr>P%4qAXDj-X(rY!tCl{o$NcYc&jj zD^>?;y2RJ;_$X=*s6)q(O0R5vDCa|?RPq{U6v;7g$~cD{BVZ}<2BWFq1kEuR$u_d^ zxTJ87dgDyoj^}jBYA!{80Tavm`_MmREC0jT%xx#=qj-I81>yi`5(IPk1ClvL2k;AQ zuj|_}MtjwL@CMe*=a2?^y~AQO8A8ZtiH8m-CdNSCa*usD0jbB-igg{Bg3jGJza zF3`6laMlXmviu3uG#=EXb`29!TJ|DIX?%fM@iwTbJE&>o!PInILQCIQ-!FGXYX{v} z4Q7Kk%O;vW@Z+=9F}S9naH~;u2da-lbEs@%W=Fr1qkks_{aq;NI%yCz%m+~r5UVLi zJcBjm1b}BU(-|)1KvEsYb0GAdv|??LUibHDYB3gbFBYs=EqAp>+QE933G;xi0Q{r3 zo|N;D#Mvm<%f9FG66g;;JWsZEOL?O#yhbtDu#m!_AXF*B&k1iD0}C3|t9F8AvSA+p zme8ey@o;AUJx)bO;vwy~_E;SdP0@x()(Rm2})1`>qysP_{@N9afzQJF9Y3qtIZ zqm$?nda9q|EWsQu@O&1+bO(RA>s(>f-N~psW_UUIH0X~0-5n&CC=WPxBsmQUJ^ewL zGlT%Qm-9_Z?YMtRx)$!PXWkd+6$Ta!#SAJUQ+^03E*%I#{eC0}3fCVQOZB2%lv7N* zJo+Qca_@6dQJ_(g=b|Eq7CCAQWPs=i#5)k_z(;NDwSYeZ;LVCn#a4rfi_ja@dFJk| zL}Zz{dlRp1sYH7ibXNZ|eZZT60bR@v@;g9 z?smL1KN^;$^*!~ZGss%!4vUGLnyt$7D4Nn>XcC^tLw=71y`ENc9EiQB z2fXv{-U&QJUA}}IDLNtU{Ecc}&liVQjJg4BL;|!l)eF$H zmYQ2X`966lR#Sj68hZPr9eJ@8O`sE6)`Nv?dLOSr3l*XZo5XjZ(+(BQ~{)bKI> z-J`QTs2ewMMdoIE!rj!AQW3SYYi1lLj3T-$-YzHD&tu+>UM96wfce;WNchM09>!gl z;1ye3JL80nyK&>iBJY_lev6KCz4F?IBU5DVaa}_Fi9CjFlseF7GXZu=TUX>;w6`l} zL)Z)9D_(vNI7{TfFUAtw{R62CVcnq)rz>J_e`GiFEwT!t!^ajK@L+uA_m3CY ztP9u)1=`wz$XS!GS?yRnbH@+0ORKuKjrz&Z06sr0&)Dj6M`FWkS&Iy?A8+f6GVvO= z=^AnqYIv{h8{8LSk3PV#f*G#mblay$j2HV{7yD1Ij-K>w`xkNm_o*89^ih@k=?48)Ti(i3w2;2T@&qH2|zO1MhlR14j_#6ASh!u3>9m~ zBxpMoIb@!Jq{ro`_95;(`yNk_28YIb(??e@D4~LGsvRfTkRcUrR;LfA#`gz!lP+eE z4vt5;wk(pR-f;dqgWEkGg{w=SLTwnBqpNo#Jpe<2v4~fCAk`j| z)P`{S3804%^lKbl9jz10wGA%yu_?=!=B0bQr>A?8oPQI+X3oH~`+IQuPso1&-(Nl> z-SZv()#j&rzQ;S$`20Kky8Q$Vz>;1FCPQXbZDB+v~`AMEvuhL68w}udZpp*X5@O0d7mk>`8_a$ND z6#h<*cH8!YD@y(+0O;5ABfhd+>?v2jNdBjP-|IK>ry)OBm8b0i7ykHPg`a`;Fh6(6 z(c1+0U}R2ga;Gdo$Ok#-S)gWPMo?psi1GU6$jAIsFg_Tr;vVAB^p!dms>6d>zB@*@Arr^w zH3$?GyZ!+f(uXdKy&kPkOYCe9QICCR``e?JNf%ytD@(f2&lkT>yi<32N_T2G$)ke> z@N*cPgFyntwto-96Sk-m(UM}ERk}T|&q9;@wUlMJFYZZvrf!AOv%6e~rvCFeb|lz9bRIRdeSlNr@PxJ>d-%3zIBlN|*oT4i zLpP0u9gt-(X-|SDW<3K+_-pA(jD{Ulrmftj;yNxq&^Qtes&~LVslf~Y7`rU>SAiT$ zAa>>hPO0g-)QP$jSOgR*hgAIa5-C&ZlsQ+I5vS#BJlBgJ6KJRIm$t2FK5^?@QU*HM zh1=K;>J53$7zf~YuXSL6f{DKtbM0^#xKcNypHuE7DTlbOV81*rFC!t1eU7V%)^{EO z^Dfy1h|ZOx@2~3)&~T?lHO}~}$!HzDl^16EYgb}AqGd02<=C{Sp^p+6h@g{`a>53O z{5a9HcEpRqjuEpG`xBfw>SuIF=o!?oJGr&qh-+@tU=%IE;&&B8AXyjZXtghW(8p545bkLXzcDA=CGxwx z0}!zA*C@FWdxs0Ky;!Thg>3=W#d0=Of@wVi?`H_S$D3AHIq7HQ&#w>cm++-6%Eni@ ze<*I_31lYp>@CFm)JGU8|8gXH5a8`Ou82%M1&s~0Gh!*Kh0gSGB+7M2;z_`PpRC?_ zIEkA(Y{zg-2nS^<_X~OIxGYlM2FUQ&ZfEY5Zl;9x8%njWR26 z)n4Z0Rl8%x%Btk-bJIPD<(`EfGv&?LXN&eQ$jrj-p<;dYceKl*Hi-^& zC0_lVy84?@y{oqFtMJE^Yrxs5|wRFvX=aA zA~pOCe_UOA!~71)Nx*&rH|wyM3OV)5`BqQZZllfyjHMa}6CX}~`scrZ1XAg_tfcHl zD)eo0n3|kW56-l*J%~wz-yDuE&$vJt{Dsk>*N28X$NxeJ@$;MiJnyiBOAsN|90vJo z6e@#eJqr@OS3S-?TXNigilq1O*Ifj#Y6(90YbUV=#1D~A&aurkf1yW(wvWD7L#Kbk zqE+p<#h}#M7TKF-+(lz}xyT@6;v3k?u2^)rpTxg8_Bouu1NH^!rL<8A#2M#a0|k$e=A zz0SC7_1oSeHVV4zX@;M9lCAwP&lS>n0ug-%^YiGWS{P{7fmG`gkJU87vpFK$g z=x?zu)N?y1k_C%k4bULk=2w$F(`h#XAkO)2r}F9H-zxuF#4Z2RH@pDmSL=@p6rJn; zrOGYe+3vNQO34lMM+V&AdJwVB`}<8kSPEG=LpC{+^YQlZ+^jl+5EjR?&EaxpPzlW z=GRYkI{c3AaI=(n3muNBc_<+Wito{!$>0n}?PQcuXFV-53ufj4tAYL|rq!LI)k*gG zw-A$`AQMbUZ?(rZ0ija?Ukw0Y2!4?@lVSBc%FAv1AU|RhF#8vheN?i}KAhSAGb^6m zv}7w|!u=3_vG5!WT4S>)^+FLm3U(#MG&X??BOcI>QQ0*0;7hjZcMHTI*4V)z4$&{% z^ptd^#8?RruwsUV*n_*AN~*TN0q%8|2;ne8D!dw0SVJoG8?Uc&$gmH{aP#yrRJ6Ec zxH()9h&7a2ZxSdVg@K}lIet4rPRz5WyH;U|01>s;L1TL#M37X|5kU^7#i0i}2J^F- zE`RcAO(~cZ&wwP(XJ1IVG!EPUix)eTYdJ_)-^Znb#Eq)HWV&tMr=s_AHDy?p@EP@7 zLOB38;}-+<1~S=W*Mkt=Q!`N8VK#_}RxDnT#hJr&gyaFW|CJWu*o$6&omft=)-Ln_}E*_KaLAV&t)A-kdf22ZLpB(#X z>|0#Z(tkgpm#PXJZ|f6LQFL{K8&*=={pe{)_4+wjAKPp^;|^K9G{HCp8oncd?6m#y zVZRY*t^RPqG5)&ikr&_E_VGFdoW5;PxBeNH!+qmK(TXoZ6z{DdQFI|uFapNQNO#G? zF1rcxiP$ofhe&`?gaQ}b=eTKL6u9H*XwRFTL(vXNcox)m`fJMN#_y678* zC^V|R#8+CXT~8ym%s4v*uZmv=1U*Oj2Ox`1PB{ZV&$LY6uL zZiN0ilYpC~9z2m;_U?7aWurO|7nU&K5k@D}1+&u|&D4AM#7>ws&~L@f2s=8bkw#L- z(H8x4wGs8cM>VC>gai5m#Gugn+z6`W$X|_C*k!|9q3qk+HPefmBFhx3Jm(e;gfCoH z`MacR!(%Idm+T4SAc}^N8&v_!285vMuLUpyB@;wM8j$vJsD?893W3|U8y`%^GO_I& zydY8n7VXSm{Cmex1cQ|Zas^w8Y>v9^~80sM6jvDT`RpA}V4CM+uA`Py+& zuQPFJCp>tOC^M^2kRnfK_)tEws8%p;P$N-A^db}SJ^|mk|F55WpC8(@FTHbq8&yS5 ziuZdqYCxw?MqzvGCXs0VJgu|-wKHPh(l?V#dc+x|hM@Idrl6eq3}GCd3Lp}c+9tLo2t>;DKL}!g03czL-&C`ycEklOV>MxBdstZ7qMipZ()~BN#RF9pSwjW!w z4H)tKEp@d0#eE?FhAx?sxeS?Uq(Ny0l5zeP8YOJ|w>}2V$48h)P>uJ**R;bms^~q> z8&16VMJ(kIq7K7N0>%TlpTNoTi;P4ucPSu7=oHmc5WiTMQkVm8l9PE8+gU+=g)6WL zd^tU~d~sdm>tE@5iC44mz)aX4z?bM{1)J?SqN5#_6robDg(XH)#|7~3s{Yc9 zP`Q}`vqz@-%v{`QD|HcOvi|OKn)okWb@feD=EI8LZI=4rb9N^LR@vmVbA$T+Zy6** zy)%af%~Yx1bI@AU2;6;1=)>fa6RuelHOvuF+btbJMh zFk!>R(!%gM)_0mqCU{4sJSbErHcwlF*5{Bj)u&ztP@Zm7esefoO^RHuN)5^^m_F;`?x`> z+o=TDER9KQC+dZn2@KfY7W!4ULyHY&55a`~Tv%zA|A#FC0dG_<*$_;YfzqoHCs^zm zA~BzFhYsL#5tQF!VrI(wX39FVP|Zp+3*VbD3*#GzY;T}Rqg~=PbKezv>z|C?wh3uveD(27av|-#_4p-vjSHqy`2l6Na-V6{L*fn@ckWKjL%3CWQ zaF`tJw^Qm0AR>SUt^~%_4NINn5u;y<1dcxALfU0FyBe;UH#)5Lzm~TKy7h^?m5uKI zDBXATS?^k;k%>7-|3K2mW&7*=s8qcoU+&4129C>9bD@9p*B0Ru+WWlZbtJJxFjsKx zt>k<-o8_PRv(wQI`HN?2MioOyU_gwjH<68k*i8O8@z<$VzNe}Y1jk2ATeu!DMg`>!3M8xJFDVuTYrBT7i1a$7i@c6_mCJxOhMxpOE2mRTbQ-{gZeld2DR`OkrxaY8%%jWJdJhIP zeqMVJh_=V4$#R0x8}~k>yH552&V9}4v2a{p*idgSe5|ivhPLT2l=pb zdC?dCYI*xMxBM#;4qqPkMT2wJ|H={UhIl_xwjRDb{84_Rd`7(f!jrS8uRNsvX}WwD zjEraoI}Jr!DeJd0y6j9i?~mVK4fJVwx2gVDiZ8ttt2ej3juz=HXV0o~60{L?JGOdX4z78RT;STe;1#9~X zg_#e2qDQJ}`+%~FX1fHp9{PmoelOzYF2E16Y)NWT`=$*4?_I1}W=tCwQ@w4B%>A9mi4 z)S{qjTj7rL$@Amm{1CqILQJk=CHXjG-a*wT?r#!l`3DA_^QnG&85!e8l60jjt(x2wP-tFoE@-JPYqbVn7O|M z?4Cmcg=-~8z!-f1OiJyBY!F*#rtCoNg**bkvlP39Qfq%)!Y@}nsN+B__mrhzm1@%7 zSK1nxaW)@VB7?~O9xCi>eo=;RYT!N2AU-f~u{56h5j{Jq239gfZ&68tQ%iw(EO2z8 zD}zGIr5S6rV7{ieP8XKo%5!V}$AM3IZbuzAcvt|xk3ycizY0A7IG$L3j08^XY}9C% z&C~Lnp`JiEJ=r=_p0hUL9!M-^M7(-+7vtbKBlZR^a(6isa5CcbE&Ss&^a@dEu7=To;n zZdtsJzNqE*PRAKFsSA~l9?bwo5PwwHqWRaE}Ou0I$nrD#(ERyM-2 zB94{Q@hy&(7in`L4%?@oEr&`Zh8OJ7UV0yg&5rQL=sh~i@Q%wddXLY+*8;p3;N8T# ziTBBPpN#jZc%O>**?7k;4ojZljR=VnBSvrkPQ#mS^zLSOeO|nI4X>GP^bTa>JrD1B zct@^)5AS7oFT;B|-pdhDXqs8$pBASV9f&27UcAelq1&teJ%yNQCN4in(g-}6k}sDL<+Or zSS#QmafNH#7y6~2&M4t+M5t7Et)n#OgFatB%dIq!6KJBk z7xQ^b2xsDrS?YtkQ{&5f4z$%0|HoB=k{`#F{yVuqJV9Zz z)z96^H2h7&#gE*ybQPf`dJQe#VZ?{cKjwM#c!rLfg;K;WxMQ~JE|-}@I>2Yz0S9ps zpB)}8eh#86s<}wK;$ha)qDnpN_$Jea4*VbShU>W!*9=0&jt?{V8+Xut%MQPB{E-gywgTe%)zi z|7Tvp%)U#$wZQN)M}3G7dSaiC$`59Do#>g|Qhmq;CwDu71ZaN8`vK1eJfJ|mut4{n z+-?BU68i3PyH^qQ?NIKKh=q-+d1o988&!++tVI=7u!mUux2ghp1h;EfLl5kg`H5SZ zaDddR{<2rN9pZ^?RJ|petN{*AmVMO;C);6A5$AR@jL z;W2uTaTwhMhtZ7@Mn_zNHBFEMYBvm2;`lAM98~UA*IlD$2zqzvFS<*@e{T69f&UCT zg#R3PkHvnI|K!Fi!P%Djsu11>(6XWxS&y6#qoE;ceJ99JD z*1+*#c^#hxfr=uJ^|rcexx^|$z&S68jCnX_;|@(=3ca`HC>zZCvvR4oU|3y(Wd_}#JK zbX{Fehp4Pj?SW-vp|R0hBfkjW(|*pH?=1whIN!Sl9ukar>hir|;CtTisU3Xp_hrKO z;1PxRDEmMJn(t{es{zYUNjLDfPQkwq#{=WMj}K1&JM>Y<)(F03e+FX$ImSJlY6bU$ zf5F*;TaO{(K!P}pWB(6IJD7zPTh%|WVt?Ki4D|hXFeBWA?AK|+FVnm82y;9@dVQNa_S-#E%vi%Y!Q>e3!HBfOp8=AzU52KJvLcZ@ zvZaMwDBXkbf&@t}fj%7h(X-e=jjRv-za=|tR&QR}X?=(;?L>12uMbZA&$|Q?q8s`n z%{T^wS=tPA5LG(%ZwcSGe=Xl9>hFpCVVcebR*N`J7zw-VQ%pE@bTTd)f~V{ezFkeJ z;hwuAn^4q~4R@b39f^_*!R_cl^soJ$kr)1-F7!VYK+5o2Jk~FU_{w9UKO+Orp}DzT zA3D$4tsZ-ajCBDP<#FjyBCdUp^x3Tb(giHEuqkxa$fYT0Ko{SxwchXr%oJOvrlCyX z&UuI_Em!6Q)KwbD8Aw1JfJF|BOB@*e6Jfw^phv7p4JC;7c^gG@79B49HhKnXNe`V2 zTrf--#$I(v(kM9+UsA&v{@r&T1}DCRfKeDWZkK4<-4Xw=jA+?cEkg&4)7It(s3ZDE zTGQbpiilTr>?9dmIhoK@;JECnHU=r6qhr^ZgH0>rts{MW++v(mKF3Qxfv+)hRQ z!xcdb#-at0Rqd+(yL-XP2>kF_or+sxnOg?~WanPRwLS;Yk1HSgh^kFh4yu$$wus7( zesd>^`zi82RJU)DJ}-R`DS_AV$KxsUr0R9L8si#dh=4L!bgqKYVs}{8oeX_k<(_k9 zbqN@cZk*l=sb&%km0&2>7VUutSnqjC5vqmREBEAvQv$J7aFzAuH{cD%@d1l#He&0= znz^%u^pS(1kt-GWtIB+0?0+;ES!}i1vKgec)mXvz z0ioybdlBh*enTmEG$iYO(DoE0hx$xeJ`%mGoPpLhvc1DS;qQ(5o&CV%VQwY!yzqG8 z1DgA|{NT<6ctL9$Akxg`$xpnVL*aoPF2jdtf9N5X#&b{!8*5;NJCI=}(gRkDuGY^M zNZoH7*Qsu{feIzW+s{L@l}EQi0#vVp=>v6fy%6n$_$UJaF*$`yL(xc%(@gao93piX zZw7P4eLC>ub>z^Cxn2x?LCa733Q|Iuv=7kzL2Fl|wS{Oc+6bMFZX?gyHmIY~%6LTf zB_DGUq7QI?SVTbMeoFmpw3U)2NeWoH5jpI!PeVDlUR_y6o{jy|^9f>`T-Ffpfs1(O zm;CKUCuWW34jEN#0~AC=BJ8&^djPz8VjAJf%{lu%f~vLl7UFBUr1n6juOyM@BWf-Z z{k6B@5$PL|&LwmTbAsnw#(2LzW?QjH>VoZp7xlr&#HhLtY?z1XuEZkSlBBD*n)R*~f|9$}VA^aAiI%RaPJ<2m>xoiK6cuvUA08MFOCx1LU z=Fuf^POhAtgx~f-=X=@rSWc;&cw^D?n{n*>BXK;khEk^ zsE=gm$F$qRS@?maPH)|Sga+4hY)N!fQ3BaNe?X#p5k$9Fwb6MScM%}@y=7i#MN=^H z@8C)FYvP;;zWpyJAqQF0WpAu};76i3z!17*Nq!5P5s6<4`@4krB-bo-sPlF&U6F3) z4Pb~^3a+~=+^d#{h|s6s()KAH)Jpnbfd`gzC+e+jMVi0XkH2jV_+zZ>GGb`Bhp}>e zlGyA<)2v^NmDmYf37u@oCzX5h!p9pci;{*+e)7}skqB~#6KdQhMoIscx1eFp5U~#_ zYU!K8Q7ec3m_s)dK_vYWfN8qf<4oub;;8G^|R{iEHtnXLmU=SwYsnZ~w>LlQJ0-j(5pvY7*=Lom;zm)fFMR*dF6=!+Znoy?(8xwsr)pPXpHOD%=6U zEc*Pha&LxF^&$FKxwpGf#SlISo#cM3A?Fg7EiZX9g!NhvjY}%YC9RVPWN%krch4a_>33 zfRm8@uX84<>j@kNMo@&^E_qI^+&d%;aff+SfL~G4$uWtpVUr!5ZL=B&(8kJ%GyI2r4kKv7M%7CIV+n#pR_8NPyo z5aQM9PGKVuYl2X~MRs?;C@6HJdIjNcbW6geb$19Hl1n`~Hclu=GX*#Twa31s^2U-? zTgZbU9DqbxFTHXjXEUAH5Px?Mq=s+S@5L;Q4#oacdWP)=Q8pu!O}tAN{^~tlc!3nA zHyXq#kt5J1Eh##ePaGsqIZEU^=L#+PVW0`6wb&g}toR-0$jQ9ceHEmOz8&i)r6Da3 zg}=A98udT*iyjk*HDl?+5oA)(7`+-Z?jA1Zz$`YJ`;umMubkH}<_Tl-)Ity49H0Xy zDhN8Wnrsc-0M=yrrT+{znR?5F)xML|>_i21xmA3B>FN)i{;d4nVf!=p|EWK#xjdsk zXCBfYY^lr97fxs#*FmTDKKn${4o=xT`>X+jvmvi4h zacY52LO%AV3~|Sq`Z`>kE%M;!(dlR+sEnFVAIP1GBjU_zRQ(J2{k2}In(WM8?@)f(pzgetlcF8icY+4Px`=%+Q+5K`i%(FG zqm)^pz#uMhK5Q`UNlA+4;Qrd<#YKBpnziTD8S@Eaz6Ys!B(!O>}$&ix5(Op zt?4=HvYqULQS}+%m=!1pPtox4qGE&NG!hLjiWt4S)OzvKwiYJV zo)lx*LwE`IsE#cdfa7vTV~FfY4jaIDCidUBp{b3BCU~8T*I6*V`J3p?M>FA#@BIINbG>yNaWb2lqQ<4dkxJ@qyP& z*{FOjBpA7HJGW8I?9QsgsiL03AYqt;;C~p5{kNe4C&*BCz?y-T_X}4S%4y^3)2n7W z!>~Mgc$yjsaR@o8KR}8-8N$Ge11tHFo&)RnP;peyPJ6AD=$n93 zSO#BGf8}~9ejP^j!^os#Z~cYYff#U@GFA9ANo)30-Y_@YX&Gs&0-WbP41TuLwgsg$ zN3CR0NRmDwKvWn+h5kC&2ms=H>Qt#uoQqD-Bx+}#!W^|Y!}q8+u7RA%iA{HUR$^!N zl&_ca>%;g8KICW#u*BaCnHbdRPmGyG!w1Ok!GYh z4=h5cF@Z3)+YlS>ZPxex$o`~o7Val_y{SsRQr^TCf-w`KL3~XP4|l#~;0qlHvAmyi zYB&vGb{PI$O%T}A9$}yD3`o=-|LYLKKzhZE(G36VGC%FKGq64~ju-_>Iyv+wl~Ie) zX$tuYPUjw70rJoNT#Y|ZNiI^2XK?=LMS=VXT-*9Y&211x;dRdbRjYgMT?Jj#@a(YP zw3ZBPM&1$&5jb_-4Ezs#ygnMEAfbOO*Dk

        XcU{ukR7+JE7>U~J! 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±yUEj(vie9Gc{6)%yha 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

        uLmYFgid& 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

        n;I+K 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℞{lXUzSYFNp+1OOS6^ZElH}F8ONT2>8XDrv5W!88zkmP{SvED9C*? znp(1uPW2bT1atZ^QS3aW66%1BX>WrTq6858_C0>4Iv+fA<0NRX`yLJsMYBdsE#m%d z05gqILnW(ccr7DQ;zeB!Z@q1t*3juD&Yr9#2EM<=re3)4nL}03yZ&WJk9`FdG)zNL zQ<^09;~JJ{m`vuHek3n45vV{-4j*{KnK)x+i8iQI5Kj#I;jdNNNWk_b6jiQ0kL7%7n8a{nuDRU?2NjRUI{My94~SmuAmO zzJgY{Il@1D1(3J5Gx-8|2QNQ<51PD?OH7yD1+_Lz!r_mSnUbp`(4w4pevkA+*1RDT zO^k2F7P}?0f{;9QO#$O#YU&vC`>mWyat;{J^`R?FcA&_1$=eDwM{@+;>zqwW#IY8}9^;DJT(%u5Aq`A`#bEA1&iuzLqC zu<;j+d=q2+G7q8=y7RyY;oYpp4W3Xs^@^1X6vm5||3j{ScSBUH&Jf1HX?&IWHp~(m z=U;ujO!Lq~#P?to;P+vIG?P;R8`lPqXOzX^U5Wx+&A0V)no<$Wa9$Mubj*ve<(pA3 zc_CYfFF<=5x`DcaI=;6G#J{)S=5NJ(W_jc-^v@_3#&v}GTlNXqUG;QUd=LfBoMgFx zxN|U_|C4<)ILrPN@d0KWb;-tYOLpgGV{)f{2Il{)6y*vMxssq^TzYp7z4!wHCXKdX zudGtw-Kpo0-)+rQgTDZyzWF+^;({2c;<=k@yLcPY=r%=;U%EnWpL26Yl)J&fx9#yV z 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�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

        gSC!_R9zlSv7@XJN=CJ^2u_i@Whp%X&Am$9BK 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 z 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/psycopg2/_range.py b/env/Lib/site-packages/psycopg2/_range.py new file mode 100644 index 0000000..64bae07 --- /dev/null +++ b/env/Lib/site-packages/psycopg2/_range.py @@ -0,0 +1,554 @@ +"""Implementation of the Range type and adaptation + +""" + +# psycopg/_range.py - Implementation of the Range type and adaptation +# +# Copyright (C) 2012-2019 Daniele Varrazzo +# Copyright (C) 2020-2021 The Psycopg Team +# +# psycopg2 is free software: you can redistribute it and/or modify it +# under the terms of the GNU Lesser General Public License as published +# by the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# In addition, as a special exception, the copyright holders give +# permission to link this program with the OpenSSL library (or with +# modified versions of OpenSSL that use the same license as OpenSSL), +# and distribute linked combinations including the two. +# +# You must obey the GNU Lesser General Public License in all respects for +# all of the code used other than OpenSSL. +# +# psycopg2 is distributed in the hope that it will be useful, but WITHOUT +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public +# License for more details. + +import re + +from psycopg2._psycopg import ProgrammingError, InterfaceError +from psycopg2.extensions import ISQLQuote, adapt, register_adapter +from psycopg2.extensions import new_type, new_array_type, register_type + + +class Range: + """Python representation for a PostgreSQL |range|_ type. + + :param lower: lower bound for the range. `!None` means unbound + :param upper: upper bound for the range. `!None` means unbound + :param bounds: one of the literal strings ``()``, ``[)``, ``(]``, ``[]``, + representing whether the lower or upper bounds are included + :param empty: if `!True`, the range is empty + + """ + __slots__ = ('_lower', '_upper', '_bounds') + + def __init__(self, lower=None, upper=None, bounds='[)', empty=False): + if not empty: + if bounds not in ('[)', '(]', '()', '[]'): + raise ValueError(f"bound flags not valid: {bounds!r}") + + self._lower = lower + self._upper = upper + self._bounds = bounds + else: + self._lower = self._upper = self._bounds = None + + def __repr__(self): + if self._bounds is None: + return f"{self.__class__.__name__}(empty=True)" + else: + return "{}({!r}, {!r}, {!r})".format(self.__class__.__name__, + self._lower, self._upper, self._bounds) + + def __str__(self): + if self._bounds is None: + return 'empty' + + items = [ + self._bounds[0], + str(self._lower), + ', ', + str(self._upper), + self._bounds[1] + ] + return ''.join(items) + + @property + def lower(self): + """The lower bound of the range. `!None` if empty or unbound.""" + return self._lower + + @property + def upper(self): + """The upper bound of the range. `!None` if empty or unbound.""" + return self._upper + + @property + def isempty(self): + """`!True` if the range is empty.""" + return self._bounds is None + + @property + def lower_inf(self): + """`!True` if the range doesn't have a lower bound.""" + if self._bounds is None: + return False + return self._lower is None + + @property + def upper_inf(self): + """`!True` if the range doesn't have an upper bound.""" + if self._bounds is None: + return False + return self._upper is None + + @property + def lower_inc(self): + """`!True` if the lower bound is included in the range.""" + if self._bounds is None or self._lower is None: + return False + return self._bounds[0] == '[' + + @property + def upper_inc(self): + """`!True` if the upper bound is included in the range.""" + if self._bounds is None or self._upper is None: + return False + return self._bounds[1] == ']' + + def __contains__(self, x): + if self._bounds is None: + return False + + if self._lower is not None: + if self._bounds[0] == '[': + if x < self._lower: + return False + else: + if x <= self._lower: + return False + + if self._upper is not None: + if self._bounds[1] == ']': + if x > self._upper: + return False + else: + if x >= self._upper: + return False + + return True + + def __bool__(self): + return self._bounds is not None + + def __eq__(self, other): + if not isinstance(other, Range): + return False + return (self._lower == other._lower + and self._upper == other._upper + and self._bounds == other._bounds) + + def __ne__(self, other): + return not self.__eq__(other) + + def __hash__(self): + return hash((self._lower, self._upper, self._bounds)) + + # as the postgres docs describe for the server-side stuff, + # ordering is rather arbitrary, but will remain stable + # and consistent. + + def __lt__(self, other): + if not isinstance(other, Range): + return NotImplemented + for attr in ('_lower', '_upper', '_bounds'): + self_value = getattr(self, attr) + other_value = getattr(other, attr) + if self_value == other_value: + pass + elif self_value is None: + return True + elif other_value is None: + return False + else: + return self_value < other_value + return False + + def __le__(self, other): + if self == other: + return True + else: + return self.__lt__(other) + + def __gt__(self, other): + if isinstance(other, Range): + return other.__lt__(self) + else: + return NotImplemented + + def __ge__(self, other): + if self == other: + return True + else: + return self.__gt__(other) + + def __getstate__(self): + return {slot: getattr(self, slot) + for slot in self.__slots__ if hasattr(self, slot)} + + def __setstate__(self, state): + for slot, value in state.items(): + setattr(self, slot, value) + + +def register_range(pgrange, pyrange, conn_or_curs, globally=False): + """Create and register an adapter and the typecasters to convert between + a PostgreSQL |range|_ type and a PostgreSQL `Range` subclass. + + :param pgrange: the name of the PostgreSQL |range| type. Can be + schema-qualified + :param pyrange: a `Range` strict subclass, or just a name to give to a new + class + :param conn_or_curs: a connection or cursor used to find the oid of the + range and its subtype; the typecaster is registered in a scope limited + to this object, unless *globally* is set to `!True` + :param globally: if `!False` (default) register the typecaster only on + *conn_or_curs*, otherwise register it globally + :return: `RangeCaster` instance responsible for the conversion + + If a string is passed to *pyrange*, a new `Range` subclass is created + with such name and will be available as the `~RangeCaster.range` attribute + of the returned `RangeCaster` object. + + The function queries the database on *conn_or_curs* to inspect the + *pgrange* type and raises `~psycopg2.ProgrammingError` if the type is not + found. If querying the database is not advisable, use directly the + `RangeCaster` class and register the adapter and typecasters using the + provided functions. + + """ + caster = RangeCaster._from_db(pgrange, pyrange, conn_or_curs) + caster._register(not globally and conn_or_curs or None) + return caster + + +class RangeAdapter: + """`ISQLQuote` adapter for `Range` subclasses. + + This is an abstract class: concrete classes must set a `name` class + attribute or override `getquoted()`. + """ + name = None + + def __init__(self, adapted): + self.adapted = adapted + + def __conform__(self, proto): + if self._proto is ISQLQuote: + return self + + def prepare(self, conn): + self._conn = conn + + def getquoted(self): + if self.name is None: + raise NotImplementedError( + 'RangeAdapter must be subclassed overriding its name ' + 'or the getquoted() method') + + r = self.adapted + if r.isempty: + return b"'empty'::" + self.name.encode('utf8') + + if r.lower is not None: + a = adapt(r.lower) + if hasattr(a, 'prepare'): + a.prepare(self._conn) + lower = a.getquoted() + else: + lower = b'NULL' + + if r.upper is not None: + a = adapt(r.upper) + if hasattr(a, 'prepare'): + a.prepare(self._conn) + upper = a.getquoted() + else: + upper = b'NULL' + + return self.name.encode('utf8') + b'(' + lower + b', ' + upper \ + + b", '" + r._bounds.encode('utf8') + b"')" + + +class RangeCaster: + """Helper class to convert between `Range` and PostgreSQL range types. + + Objects of this class are usually created by `register_range()`. Manual + creation could be useful if querying the database is not advisable: in + this case the oids must be provided. + """ + def __init__(self, pgrange, pyrange, oid, subtype_oid, array_oid=None): + self.subtype_oid = subtype_oid + self._create_ranges(pgrange, pyrange) + + name = self.adapter.name or self.adapter.__class__.__name__ + + self.typecaster = new_type((oid,), name, self.parse) + + if array_oid is not None: + self.array_typecaster = new_array_type( + (array_oid,), name + "ARRAY", self.typecaster) + else: + self.array_typecaster = None + + def _create_ranges(self, pgrange, pyrange): + """Create Range and RangeAdapter classes if needed.""" + # if got a string create a new RangeAdapter concrete type (with a name) + # else take it as an adapter. Passing an adapter should be considered + # an implementation detail and is not documented. It is currently used + # for the numeric ranges. + self.adapter = None + if isinstance(pgrange, str): + self.adapter = type(pgrange, (RangeAdapter,), {}) + self.adapter.name = pgrange + else: + try: + if issubclass(pgrange, RangeAdapter) \ + and pgrange is not RangeAdapter: + self.adapter = pgrange + except TypeError: + pass + + if self.adapter is None: + raise TypeError( + 'pgrange must be a string or a RangeAdapter strict subclass') + + self.range = None + try: + if isinstance(pyrange, str): + self.range = type(pyrange, (Range,), {}) + if issubclass(pyrange, Range) and pyrange is not Range: + self.range = pyrange + except TypeError: + pass + + if self.range is None: + raise TypeError( + 'pyrange must be a type or a Range strict subclass') + + @classmethod + def _from_db(self, name, pyrange, conn_or_curs): + """Return a `RangeCaster` instance for the type *pgrange*. + + Raise `ProgrammingError` if the type is not found. + """ + from psycopg2.extensions import STATUS_IN_TRANSACTION + from psycopg2.extras import _solve_conn_curs + conn, curs = _solve_conn_curs(conn_or_curs) + + if conn.info.server_version < 90200: + raise ProgrammingError("range types not available in version %s" + % conn.info.server_version) + + # Store the transaction status of the connection to revert it after use + conn_status = conn.status + + # Use the correct schema + if '.' in name: + schema, tname = name.split('.', 1) + else: + tname = name + schema = 'public' + + # get the type oid and attributes + curs.execute("""\ +select rngtypid, rngsubtype, typarray +from pg_range r +join pg_type t on t.oid = rngtypid +join pg_namespace ns on ns.oid = typnamespace +where typname = %s and ns.nspname = %s; +""", (tname, schema)) + rec = curs.fetchone() + + if not rec: + # The above algorithm doesn't work for customized seach_path + # (#1487) The implementation below works better, but, to guarantee + # backwards compatibility, use it only if the original one failed. + try: + savepoint = False + # Because we executed statements earlier, we are either INTRANS + # or we are IDLE only if the transaction is autocommit, in + # which case we don't need the savepoint anyway. + if conn.status == STATUS_IN_TRANSACTION: + curs.execute("SAVEPOINT register_type") + savepoint = True + + curs.execute("""\ +SELECT rngtypid, rngsubtype, typarray, typname, nspname +from pg_range r +join pg_type t on t.oid = rngtypid +join pg_namespace ns on ns.oid = typnamespace +WHERE t.oid = %s::regtype +""", (name, )) + except ProgrammingError: + pass + else: + rec = curs.fetchone() + if rec: + tname, schema = rec[3:] + finally: + if savepoint: + curs.execute("ROLLBACK TO SAVEPOINT register_type") + + # revert the status of the connection as before the command + if conn_status != STATUS_IN_TRANSACTION and not conn.autocommit: + conn.rollback() + + if not rec: + raise ProgrammingError( + f"PostgreSQL range '{name}' not found") + + type, subtype, array = rec[:3] + + return RangeCaster(name, pyrange, + oid=type, subtype_oid=subtype, array_oid=array) + + _re_range = re.compile(r""" + ( \(|\[ ) # lower bound flag + (?: # lower bound: + " ( (?: [^"] | "")* ) " # - a quoted string + | ( [^",]+ ) # - or an unquoted string + )? # - or empty (not catched) + , + (?: # upper bound: + " ( (?: [^"] | "")* ) " # - a quoted string + | ( [^"\)\]]+ ) # - or an unquoted string + )? # - or empty (not catched) + ( \)|\] ) # upper bound flag + """, re.VERBOSE) + + _re_undouble = re.compile(r'(["\\])\1') + + def parse(self, s, cur=None): + if s is None: + return None + + if s == 'empty': + return self.range(empty=True) + + m = self._re_range.match(s) + if m is None: + raise InterfaceError(f"failed to parse range: '{s}'") + + lower = m.group(3) + if lower is None: + lower = m.group(2) + if lower is not None: + lower = self._re_undouble.sub(r"\1", lower) + + upper = m.group(5) + if upper is None: + upper = m.group(4) + if upper is not None: + upper = self._re_undouble.sub(r"\1", upper) + + if cur is not None: + lower = cur.cast(self.subtype_oid, lower) + upper = cur.cast(self.subtype_oid, upper) + + bounds = m.group(1) + m.group(6) + + return self.range(lower, upper, bounds) + + def _register(self, scope=None): + register_type(self.typecaster, scope) + if self.array_typecaster is not None: + register_type(self.array_typecaster, scope) + + register_adapter(self.range, self.adapter) + + +class NumericRange(Range): + """A `Range` suitable to pass Python numeric types to a PostgreSQL range. + + PostgreSQL types :sql:`int4range`, :sql:`int8range`, :sql:`numrange` are + casted into `!NumericRange` instances. + """ + pass + + +class DateRange(Range): + """Represents :sql:`daterange` values.""" + pass + + +class DateTimeRange(Range): + """Represents :sql:`tsrange` values.""" + pass + + +class DateTimeTZRange(Range): + """Represents :sql:`tstzrange` values.""" + pass + + +# Special adaptation for NumericRange. Allows to pass number range regardless +# of whether they are ints, floats and what size of ints are, which are +# pointless in Python world. On the way back, no numeric range is casted to +# NumericRange, but only to their subclasses + +class NumberRangeAdapter(RangeAdapter): + """Adapt a range if the subtype doesn't need quotes.""" + def getquoted(self): + r = self.adapted + if r.isempty: + return b"'empty'" + + if not r.lower_inf: + # not exactly: we are relying that none of these object is really + # quoted (they are numbers). Also, I'm lazy and not preparing the + # adapter because I assume encoding doesn't matter for these + # objects. + lower = adapt(r.lower).getquoted().decode('ascii') + else: + lower = '' + + if not r.upper_inf: + upper = adapt(r.upper).getquoted().decode('ascii') + else: + upper = '' + + return (f"'{r._bounds[0]}{lower},{upper}{r._bounds[1]}'").encode('ascii') + + +# TODO: probably won't work with infs, nans and other tricky cases. +register_adapter(NumericRange, NumberRangeAdapter) + +# Register globally typecasters and adapters for builtin range types. + +# note: the adapter is registered more than once, but this is harmless. +int4range_caster = RangeCaster(NumberRangeAdapter, NumericRange, + oid=3904, subtype_oid=23, array_oid=3905) +int4range_caster._register() + +int8range_caster = RangeCaster(NumberRangeAdapter, NumericRange, + oid=3926, subtype_oid=20, array_oid=3927) +int8range_caster._register() + +numrange_caster = RangeCaster(NumberRangeAdapter, NumericRange, + oid=3906, subtype_oid=1700, array_oid=3907) +numrange_caster._register() + +daterange_caster = RangeCaster('daterange', DateRange, + oid=3912, subtype_oid=1082, array_oid=3913) +daterange_caster._register() + +tsrange_caster = RangeCaster('tsrange', DateTimeRange, + oid=3908, subtype_oid=1114, array_oid=3909) +tsrange_caster._register() + +tstzrange_caster = RangeCaster('tstzrange', DateTimeTZRange, + oid=3910, subtype_oid=1184, array_oid=3911) +tstzrange_caster._register() diff --git a/env/Lib/site-packages/psycopg2/errorcodes.py b/env/Lib/site-packages/psycopg2/errorcodes.py new file mode 100644 index 0000000..aa646c4 --- /dev/null +++ b/env/Lib/site-packages/psycopg2/errorcodes.py @@ -0,0 +1,449 @@ +"""Error codes for PostgreSQL + +This module contains symbolic names for all PostgreSQL error codes. +""" +# psycopg2/errorcodes.py - PostgreSQL error codes +# +# Copyright (C) 2006-2019 Johan Dahlin +# Copyright (C) 2020-2021 The Psycopg Team +# +# psycopg2 is free software: you can redistribute it and/or modify it +# under the terms of the GNU Lesser General Public License as published +# by the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# In addition, as a special exception, the copyright holders give +# permission to link this program with the OpenSSL library (or with +# modified versions of OpenSSL that use the same license as OpenSSL), +# and distribute linked combinations including the two. +# +# You must obey the GNU Lesser General Public License in all respects for +# all of the code used other than OpenSSL. +# +# psycopg2 is distributed in the hope that it will be useful, but WITHOUT +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public +# License for more details. +# +# Based on: +# +# https://www.postgresql.org/docs/current/static/errcodes-appendix.html +# + + +def lookup(code, _cache={}): + """Lookup an error code or class code and return its symbolic name. + + Raise `KeyError` if the code is not found. + """ + if _cache: + return _cache[code] + + # Generate the lookup map at first usage. + tmp = {} + for k, v in globals().items(): + if isinstance(v, str) and len(v) in (2, 5): + # Strip trailing underscore used to disambiguate duplicate values + tmp[v] = k.rstrip("_") + + assert tmp + + # Atomic update, to avoid race condition on import (bug #382) + _cache.update(tmp) + + return _cache[code] + + +# autogenerated data: do not edit below this point. + +# Error classes +CLASS_SUCCESSFUL_COMPLETION = '00' +CLASS_WARNING = '01' +CLASS_NO_DATA = '02' +CLASS_SQL_STATEMENT_NOT_YET_COMPLETE = '03' +CLASS_CONNECTION_EXCEPTION = '08' +CLASS_TRIGGERED_ACTION_EXCEPTION = '09' +CLASS_FEATURE_NOT_SUPPORTED = '0A' +CLASS_INVALID_TRANSACTION_INITIATION = '0B' +CLASS_LOCATOR_EXCEPTION = '0F' +CLASS_INVALID_GRANTOR = '0L' +CLASS_INVALID_ROLE_SPECIFICATION = '0P' +CLASS_DIAGNOSTICS_EXCEPTION = '0Z' +CLASS_CASE_NOT_FOUND = '20' +CLASS_CARDINALITY_VIOLATION = '21' +CLASS_DATA_EXCEPTION = '22' +CLASS_INTEGRITY_CONSTRAINT_VIOLATION = '23' +CLASS_INVALID_CURSOR_STATE = '24' +CLASS_INVALID_TRANSACTION_STATE = '25' +CLASS_INVALID_SQL_STATEMENT_NAME = '26' +CLASS_TRIGGERED_DATA_CHANGE_VIOLATION = '27' +CLASS_INVALID_AUTHORIZATION_SPECIFICATION = '28' +CLASS_DEPENDENT_PRIVILEGE_DESCRIPTORS_STILL_EXIST = '2B' +CLASS_INVALID_TRANSACTION_TERMINATION = '2D' +CLASS_SQL_ROUTINE_EXCEPTION = '2F' +CLASS_INVALID_CURSOR_NAME = '34' +CLASS_EXTERNAL_ROUTINE_EXCEPTION = '38' +CLASS_EXTERNAL_ROUTINE_INVOCATION_EXCEPTION = '39' +CLASS_SAVEPOINT_EXCEPTION = '3B' +CLASS_INVALID_CATALOG_NAME = '3D' +CLASS_INVALID_SCHEMA_NAME = '3F' +CLASS_TRANSACTION_ROLLBACK = '40' +CLASS_SYNTAX_ERROR_OR_ACCESS_RULE_VIOLATION = '42' +CLASS_WITH_CHECK_OPTION_VIOLATION = '44' +CLASS_INSUFFICIENT_RESOURCES = '53' +CLASS_PROGRAM_LIMIT_EXCEEDED = '54' +CLASS_OBJECT_NOT_IN_PREREQUISITE_STATE = '55' +CLASS_OPERATOR_INTERVENTION = '57' +CLASS_SYSTEM_ERROR = '58' +CLASS_SNAPSHOT_FAILURE = '72' +CLASS_CONFIGURATION_FILE_ERROR = 'F0' +CLASS_FOREIGN_DATA_WRAPPER_ERROR = 'HV' +CLASS_PL_PGSQL_ERROR = 'P0' +CLASS_INTERNAL_ERROR = 'XX' + +# Class 00 - Successful Completion +SUCCESSFUL_COMPLETION = '00000' + +# Class 01 - Warning +WARNING = '01000' +NULL_VALUE_ELIMINATED_IN_SET_FUNCTION = '01003' +STRING_DATA_RIGHT_TRUNCATION_ = '01004' +PRIVILEGE_NOT_REVOKED = '01006' +PRIVILEGE_NOT_GRANTED = '01007' +IMPLICIT_ZERO_BIT_PADDING = '01008' +DYNAMIC_RESULT_SETS_RETURNED = '0100C' +DEPRECATED_FEATURE = '01P01' + +# Class 02 - No Data (this is also a warning class per the SQL standard) +NO_DATA = '02000' +NO_ADDITIONAL_DYNAMIC_RESULT_SETS_RETURNED = '02001' + +# Class 03 - SQL Statement Not Yet Complete +SQL_STATEMENT_NOT_YET_COMPLETE = '03000' + +# Class 08 - Connection Exception +CONNECTION_EXCEPTION = '08000' +SQLCLIENT_UNABLE_TO_ESTABLISH_SQLCONNECTION = '08001' +CONNECTION_DOES_NOT_EXIST = '08003' +SQLSERVER_REJECTED_ESTABLISHMENT_OF_SQLCONNECTION = '08004' +CONNECTION_FAILURE = '08006' +TRANSACTION_RESOLUTION_UNKNOWN = '08007' +PROTOCOL_VIOLATION = '08P01' + +# Class 09 - Triggered Action Exception +TRIGGERED_ACTION_EXCEPTION = '09000' + +# Class 0A - Feature Not Supported +FEATURE_NOT_SUPPORTED = '0A000' + +# Class 0B - Invalid Transaction Initiation +INVALID_TRANSACTION_INITIATION = '0B000' + +# Class 0F - Locator Exception +LOCATOR_EXCEPTION = '0F000' +INVALID_LOCATOR_SPECIFICATION = '0F001' + +# Class 0L - Invalid Grantor +INVALID_GRANTOR = '0L000' +INVALID_GRANT_OPERATION = '0LP01' + +# Class 0P - Invalid Role Specification +INVALID_ROLE_SPECIFICATION = '0P000' + +# Class 0Z - Diagnostics Exception +DIAGNOSTICS_EXCEPTION = '0Z000' +STACKED_DIAGNOSTICS_ACCESSED_WITHOUT_ACTIVE_HANDLER = '0Z002' + +# Class 20 - Case Not Found +CASE_NOT_FOUND = '20000' + +# Class 21 - Cardinality Violation +CARDINALITY_VIOLATION = '21000' + +# Class 22 - Data Exception +DATA_EXCEPTION = '22000' +STRING_DATA_RIGHT_TRUNCATION = '22001' +NULL_VALUE_NO_INDICATOR_PARAMETER = '22002' +NUMERIC_VALUE_OUT_OF_RANGE = '22003' +NULL_VALUE_NOT_ALLOWED_ = '22004' +ERROR_IN_ASSIGNMENT = '22005' +INVALID_DATETIME_FORMAT = '22007' +DATETIME_FIELD_OVERFLOW = '22008' +INVALID_TIME_ZONE_DISPLACEMENT_VALUE = '22009' +ESCAPE_CHARACTER_CONFLICT = '2200B' +INVALID_USE_OF_ESCAPE_CHARACTER = '2200C' +INVALID_ESCAPE_OCTET = '2200D' +ZERO_LENGTH_CHARACTER_STRING = '2200F' +MOST_SPECIFIC_TYPE_MISMATCH = '2200G' +SEQUENCE_GENERATOR_LIMIT_EXCEEDED = '2200H' +NOT_AN_XML_DOCUMENT = '2200L' +INVALID_XML_DOCUMENT = '2200M' +INVALID_XML_CONTENT = '2200N' +INVALID_XML_COMMENT = '2200S' +INVALID_XML_PROCESSING_INSTRUCTION = '2200T' +INVALID_INDICATOR_PARAMETER_VALUE = '22010' +SUBSTRING_ERROR = '22011' +DIVISION_BY_ZERO = '22012' +INVALID_PRECEDING_OR_FOLLOWING_SIZE = '22013' +INVALID_ARGUMENT_FOR_NTILE_FUNCTION = '22014' +INTERVAL_FIELD_OVERFLOW = '22015' +INVALID_ARGUMENT_FOR_NTH_VALUE_FUNCTION = '22016' +INVALID_CHARACTER_VALUE_FOR_CAST = '22018' +INVALID_ESCAPE_CHARACTER = '22019' +INVALID_REGULAR_EXPRESSION = '2201B' +INVALID_ARGUMENT_FOR_LOGARITHM = '2201E' +INVALID_ARGUMENT_FOR_POWER_FUNCTION = '2201F' +INVALID_ARGUMENT_FOR_WIDTH_BUCKET_FUNCTION = '2201G' +INVALID_ROW_COUNT_IN_LIMIT_CLAUSE = '2201W' +INVALID_ROW_COUNT_IN_RESULT_OFFSET_CLAUSE = '2201X' +INVALID_LIMIT_VALUE = '22020' +CHARACTER_NOT_IN_REPERTOIRE = '22021' +INDICATOR_OVERFLOW = '22022' +INVALID_PARAMETER_VALUE = '22023' +UNTERMINATED_C_STRING = '22024' +INVALID_ESCAPE_SEQUENCE = '22025' +STRING_DATA_LENGTH_MISMATCH = '22026' +TRIM_ERROR = '22027' +ARRAY_SUBSCRIPT_ERROR = '2202E' +INVALID_TABLESAMPLE_REPEAT = '2202G' +INVALID_TABLESAMPLE_ARGUMENT = '2202H' +DUPLICATE_JSON_OBJECT_KEY_VALUE = '22030' +INVALID_ARGUMENT_FOR_SQL_JSON_DATETIME_FUNCTION = '22031' +INVALID_JSON_TEXT = '22032' +INVALID_SQL_JSON_SUBSCRIPT = '22033' +MORE_THAN_ONE_SQL_JSON_ITEM = '22034' +NO_SQL_JSON_ITEM = '22035' +NON_NUMERIC_SQL_JSON_ITEM = '22036' +NON_UNIQUE_KEYS_IN_A_JSON_OBJECT = '22037' +SINGLETON_SQL_JSON_ITEM_REQUIRED = '22038' +SQL_JSON_ARRAY_NOT_FOUND = '22039' +SQL_JSON_MEMBER_NOT_FOUND = '2203A' +SQL_JSON_NUMBER_NOT_FOUND = '2203B' +SQL_JSON_OBJECT_NOT_FOUND = '2203C' +TOO_MANY_JSON_ARRAY_ELEMENTS = '2203D' +TOO_MANY_JSON_OBJECT_MEMBERS = '2203E' +SQL_JSON_SCALAR_REQUIRED = '2203F' +SQL_JSON_ITEM_CANNOT_BE_CAST_TO_TARGET_TYPE = '2203G' +FLOATING_POINT_EXCEPTION = '22P01' +INVALID_TEXT_REPRESENTATION = '22P02' +INVALID_BINARY_REPRESENTATION = '22P03' +BAD_COPY_FILE_FORMAT = '22P04' +UNTRANSLATABLE_CHARACTER = '22P05' +NONSTANDARD_USE_OF_ESCAPE_CHARACTER = '22P06' + +# Class 23 - Integrity Constraint Violation +INTEGRITY_CONSTRAINT_VIOLATION = '23000' +RESTRICT_VIOLATION = '23001' +NOT_NULL_VIOLATION = '23502' +FOREIGN_KEY_VIOLATION = '23503' +UNIQUE_VIOLATION = '23505' +CHECK_VIOLATION = '23514' +EXCLUSION_VIOLATION = '23P01' + +# Class 24 - Invalid Cursor State +INVALID_CURSOR_STATE = '24000' + +# Class 25 - Invalid Transaction State +INVALID_TRANSACTION_STATE = '25000' +ACTIVE_SQL_TRANSACTION = '25001' +BRANCH_TRANSACTION_ALREADY_ACTIVE = '25002' +INAPPROPRIATE_ACCESS_MODE_FOR_BRANCH_TRANSACTION = '25003' +INAPPROPRIATE_ISOLATION_LEVEL_FOR_BRANCH_TRANSACTION = '25004' +NO_ACTIVE_SQL_TRANSACTION_FOR_BRANCH_TRANSACTION = '25005' +READ_ONLY_SQL_TRANSACTION = '25006' +SCHEMA_AND_DATA_STATEMENT_MIXING_NOT_SUPPORTED = '25007' +HELD_CURSOR_REQUIRES_SAME_ISOLATION_LEVEL = '25008' +NO_ACTIVE_SQL_TRANSACTION = '25P01' +IN_FAILED_SQL_TRANSACTION = '25P02' +IDLE_IN_TRANSACTION_SESSION_TIMEOUT = '25P03' + +# Class 26 - Invalid SQL Statement Name +INVALID_SQL_STATEMENT_NAME = '26000' + +# Class 27 - Triggered Data Change Violation +TRIGGERED_DATA_CHANGE_VIOLATION = '27000' + +# Class 28 - Invalid Authorization Specification +INVALID_AUTHORIZATION_SPECIFICATION = '28000' +INVALID_PASSWORD = '28P01' + +# Class 2B - Dependent Privilege Descriptors Still Exist +DEPENDENT_PRIVILEGE_DESCRIPTORS_STILL_EXIST = '2B000' +DEPENDENT_OBJECTS_STILL_EXIST = '2BP01' + +# Class 2D - Invalid Transaction Termination +INVALID_TRANSACTION_TERMINATION = '2D000' + +# Class 2F - SQL Routine Exception +SQL_ROUTINE_EXCEPTION = '2F000' +MODIFYING_SQL_DATA_NOT_PERMITTED_ = '2F002' +PROHIBITED_SQL_STATEMENT_ATTEMPTED_ = '2F003' +READING_SQL_DATA_NOT_PERMITTED_ = '2F004' +FUNCTION_EXECUTED_NO_RETURN_STATEMENT = '2F005' + +# Class 34 - Invalid Cursor Name +INVALID_CURSOR_NAME = '34000' + +# Class 38 - External Routine Exception +EXTERNAL_ROUTINE_EXCEPTION = '38000' +CONTAINING_SQL_NOT_PERMITTED = '38001' +MODIFYING_SQL_DATA_NOT_PERMITTED = '38002' +PROHIBITED_SQL_STATEMENT_ATTEMPTED = '38003' +READING_SQL_DATA_NOT_PERMITTED = '38004' + +# Class 39 - External Routine Invocation Exception +EXTERNAL_ROUTINE_INVOCATION_EXCEPTION = '39000' +INVALID_SQLSTATE_RETURNED = '39001' +NULL_VALUE_NOT_ALLOWED = '39004' +TRIGGER_PROTOCOL_VIOLATED = '39P01' +SRF_PROTOCOL_VIOLATED = '39P02' +EVENT_TRIGGER_PROTOCOL_VIOLATED = '39P03' + +# Class 3B - Savepoint Exception +SAVEPOINT_EXCEPTION = '3B000' +INVALID_SAVEPOINT_SPECIFICATION = '3B001' + +# Class 3D - Invalid Catalog Name +INVALID_CATALOG_NAME = '3D000' + +# Class 3F - Invalid Schema Name +INVALID_SCHEMA_NAME = '3F000' + +# Class 40 - Transaction Rollback +TRANSACTION_ROLLBACK = '40000' +SERIALIZATION_FAILURE = '40001' +TRANSACTION_INTEGRITY_CONSTRAINT_VIOLATION = '40002' +STATEMENT_COMPLETION_UNKNOWN = '40003' +DEADLOCK_DETECTED = '40P01' + +# Class 42 - Syntax Error or Access Rule Violation +SYNTAX_ERROR_OR_ACCESS_RULE_VIOLATION = '42000' +INSUFFICIENT_PRIVILEGE = '42501' +SYNTAX_ERROR = '42601' +INVALID_NAME = '42602' +INVALID_COLUMN_DEFINITION = '42611' +NAME_TOO_LONG = '42622' +DUPLICATE_COLUMN = '42701' +AMBIGUOUS_COLUMN = '42702' +UNDEFINED_COLUMN = '42703' +UNDEFINED_OBJECT = '42704' +DUPLICATE_OBJECT = '42710' +DUPLICATE_ALIAS = '42712' +DUPLICATE_FUNCTION = '42723' +AMBIGUOUS_FUNCTION = '42725' +GROUPING_ERROR = '42803' +DATATYPE_MISMATCH = '42804' +WRONG_OBJECT_TYPE = '42809' +INVALID_FOREIGN_KEY = '42830' +CANNOT_COERCE = '42846' +UNDEFINED_FUNCTION = '42883' +GENERATED_ALWAYS = '428C9' +RESERVED_NAME = '42939' +UNDEFINED_TABLE = '42P01' +UNDEFINED_PARAMETER = '42P02' +DUPLICATE_CURSOR = '42P03' +DUPLICATE_DATABASE = '42P04' +DUPLICATE_PREPARED_STATEMENT = '42P05' +DUPLICATE_SCHEMA = '42P06' +DUPLICATE_TABLE = '42P07' +AMBIGUOUS_PARAMETER = '42P08' +AMBIGUOUS_ALIAS = '42P09' +INVALID_COLUMN_REFERENCE = '42P10' +INVALID_CURSOR_DEFINITION = '42P11' +INVALID_DATABASE_DEFINITION = '42P12' +INVALID_FUNCTION_DEFINITION = '42P13' +INVALID_PREPARED_STATEMENT_DEFINITION = '42P14' +INVALID_SCHEMA_DEFINITION = '42P15' +INVALID_TABLE_DEFINITION = '42P16' +INVALID_OBJECT_DEFINITION = '42P17' +INDETERMINATE_DATATYPE = '42P18' +INVALID_RECURSION = '42P19' +WINDOWING_ERROR = '42P20' +COLLATION_MISMATCH = '42P21' +INDETERMINATE_COLLATION = '42P22' + +# Class 44 - WITH CHECK OPTION Violation +WITH_CHECK_OPTION_VIOLATION = '44000' + +# Class 53 - Insufficient Resources +INSUFFICIENT_RESOURCES = '53000' +DISK_FULL = '53100' +OUT_OF_MEMORY = '53200' +TOO_MANY_CONNECTIONS = '53300' +CONFIGURATION_LIMIT_EXCEEDED = '53400' + +# Class 54 - Program Limit Exceeded +PROGRAM_LIMIT_EXCEEDED = '54000' +STATEMENT_TOO_COMPLEX = '54001' +TOO_MANY_COLUMNS = '54011' +TOO_MANY_ARGUMENTS = '54023' + +# Class 55 - Object Not In Prerequisite State +OBJECT_NOT_IN_PREREQUISITE_STATE = '55000' +OBJECT_IN_USE = '55006' +CANT_CHANGE_RUNTIME_PARAM = '55P02' +LOCK_NOT_AVAILABLE = '55P03' +UNSAFE_NEW_ENUM_VALUE_USAGE = '55P04' + +# Class 57 - Operator Intervention +OPERATOR_INTERVENTION = '57000' +QUERY_CANCELED = '57014' +ADMIN_SHUTDOWN = '57P01' +CRASH_SHUTDOWN = '57P02' +CANNOT_CONNECT_NOW = '57P03' +DATABASE_DROPPED = '57P04' +IDLE_SESSION_TIMEOUT = '57P05' + +# Class 58 - System Error (errors external to PostgreSQL itself) +SYSTEM_ERROR = '58000' +IO_ERROR = '58030' +UNDEFINED_FILE = '58P01' +DUPLICATE_FILE = '58P02' + +# Class 72 - Snapshot Failure +SNAPSHOT_TOO_OLD = '72000' + +# Class F0 - Configuration File Error +CONFIG_FILE_ERROR = 'F0000' +LOCK_FILE_EXISTS = 'F0001' + +# Class HV - Foreign Data Wrapper Error (SQL/MED) +FDW_ERROR = 'HV000' +FDW_OUT_OF_MEMORY = 'HV001' +FDW_DYNAMIC_PARAMETER_VALUE_NEEDED = 'HV002' +FDW_INVALID_DATA_TYPE = 'HV004' +FDW_COLUMN_NAME_NOT_FOUND = 'HV005' +FDW_INVALID_DATA_TYPE_DESCRIPTORS = 'HV006' +FDW_INVALID_COLUMN_NAME = 'HV007' +FDW_INVALID_COLUMN_NUMBER = 'HV008' +FDW_INVALID_USE_OF_NULL_POINTER = 'HV009' +FDW_INVALID_STRING_FORMAT = 'HV00A' +FDW_INVALID_HANDLE = 'HV00B' +FDW_INVALID_OPTION_INDEX = 'HV00C' +FDW_INVALID_OPTION_NAME = 'HV00D' +FDW_OPTION_NAME_NOT_FOUND = 'HV00J' +FDW_REPLY_HANDLE = 'HV00K' +FDW_UNABLE_TO_CREATE_EXECUTION = 'HV00L' +FDW_UNABLE_TO_CREATE_REPLY = 'HV00M' +FDW_UNABLE_TO_ESTABLISH_CONNECTION = 'HV00N' +FDW_NO_SCHEMAS = 'HV00P' +FDW_SCHEMA_NOT_FOUND = 'HV00Q' +FDW_TABLE_NOT_FOUND = 'HV00R' +FDW_FUNCTION_SEQUENCE_ERROR = 'HV010' +FDW_TOO_MANY_HANDLES = 'HV014' +FDW_INCONSISTENT_DESCRIPTOR_INFORMATION = 'HV021' +FDW_INVALID_ATTRIBUTE_VALUE = 'HV024' +FDW_INVALID_STRING_LENGTH_OR_BUFFER_LENGTH = 'HV090' +FDW_INVALID_DESCRIPTOR_FIELD_IDENTIFIER = 'HV091' + +# Class P0 - PL/pgSQL Error +PLPGSQL_ERROR = 'P0000' +RAISE_EXCEPTION = 'P0001' +NO_DATA_FOUND = 'P0002' +TOO_MANY_ROWS = 'P0003' +ASSERT_FAILURE = 'P0004' + +# Class XX - Internal Error +INTERNAL_ERROR = 'XX000' +DATA_CORRUPTED = 'XX001' +INDEX_CORRUPTED = 'XX002' diff --git a/env/Lib/site-packages/psycopg2/errors.py b/env/Lib/site-packages/psycopg2/errors.py new file mode 100644 index 0000000..e4e47f5 --- /dev/null +++ b/env/Lib/site-packages/psycopg2/errors.py @@ -0,0 +1,38 @@ +"""Error classes for PostgreSQL error codes +""" + +# psycopg/errors.py - SQLSTATE and DB-API exceptions +# +# Copyright (C) 2018-2019 Daniele Varrazzo +# Copyright (C) 2020-2021 The Psycopg Team +# +# psycopg2 is free software: you can redistribute it and/or modify it +# under the terms of the GNU Lesser General Public License as published +# by the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# In addition, as a special exception, the copyright holders give +# permission to link this program with the OpenSSL library (or with +# modified versions of OpenSSL that use the same license as OpenSSL), +# and distribute linked combinations including the two. +# +# You must obey the GNU Lesser General Public License in all respects for +# all of the code used other than OpenSSL. +# +# psycopg2 is distributed in the hope that it will be useful, but WITHOUT +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public +# License for more details. + +# +# NOTE: the exceptions are injected into this module by the C extention. +# + + +def lookup(code): + """Lookup an error code and return its exception class. + + Raise `!KeyError` if the code is not found. + """ + from psycopg2._psycopg import sqlstate_errors # avoid circular import + return sqlstate_errors[code] diff --git a/env/Lib/site-packages/psycopg2/extensions.py b/env/Lib/site-packages/psycopg2/extensions.py new file mode 100644 index 0000000..b938d0c --- /dev/null +++ b/env/Lib/site-packages/psycopg2/extensions.py @@ -0,0 +1,213 @@ +"""psycopg extensions to the DBAPI-2.0 + +This module holds all the extensions to the DBAPI-2.0 provided by psycopg. + +- `connection` -- the new-type inheritable connection class +- `cursor` -- the new-type inheritable cursor class +- `lobject` -- the new-type inheritable large object class +- `adapt()` -- exposes the PEP-246_ compatible adapting mechanism used + by psycopg to adapt Python types to PostgreSQL ones + +.. _PEP-246: https://www.python.org/dev/peps/pep-0246/ +""" +# psycopg/extensions.py - DBAPI-2.0 extensions specific to psycopg +# +# Copyright (C) 2003-2019 Federico Di Gregorio +# Copyright (C) 2020-2021 The Psycopg Team +# +# psycopg2 is free software: you can redistribute it and/or modify it +# under the terms of the GNU Lesser General Public License as published +# by the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# In addition, as a special exception, the copyright holders give +# permission to link this program with the OpenSSL library (or with +# modified versions of OpenSSL that use the same license as OpenSSL), +# and distribute linked combinations including the two. +# +# You must obey the GNU Lesser General Public License in all respects for +# all of the code used other than OpenSSL. +# +# psycopg2 is distributed in the hope that it will be useful, but WITHOUT +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public +# License for more details. + +import re as _re + +from psycopg2._psycopg import ( # noqa + BINARYARRAY, BOOLEAN, BOOLEANARRAY, BYTES, BYTESARRAY, DATE, DATEARRAY, + DATETIMEARRAY, DECIMAL, DECIMALARRAY, FLOAT, FLOATARRAY, INTEGER, + INTEGERARRAY, INTERVAL, INTERVALARRAY, LONGINTEGER, LONGINTEGERARRAY, + ROWIDARRAY, STRINGARRAY, TIME, TIMEARRAY, UNICODE, UNICODEARRAY, + AsIs, Binary, Boolean, Float, Int, QuotedString, ) + +from psycopg2._psycopg import ( # noqa + PYDATE, PYDATETIME, PYDATETIMETZ, PYINTERVAL, PYTIME, PYDATEARRAY, + PYDATETIMEARRAY, PYDATETIMETZARRAY, PYINTERVALARRAY, PYTIMEARRAY, + DateFromPy, TimeFromPy, TimestampFromPy, IntervalFromPy, ) + +from psycopg2._psycopg import ( # noqa + adapt, adapters, encodings, connection, cursor, + lobject, Xid, libpq_version, parse_dsn, quote_ident, + string_types, binary_types, new_type, new_array_type, register_type, + ISQLQuote, Notify, Diagnostics, Column, ConnectionInfo, + QueryCanceledError, TransactionRollbackError, + set_wait_callback, get_wait_callback, encrypt_password, ) + + +"""Isolation level values.""" +ISOLATION_LEVEL_AUTOCOMMIT = 0 +ISOLATION_LEVEL_READ_UNCOMMITTED = 4 +ISOLATION_LEVEL_READ_COMMITTED = 1 +ISOLATION_LEVEL_REPEATABLE_READ = 2 +ISOLATION_LEVEL_SERIALIZABLE = 3 +ISOLATION_LEVEL_DEFAULT = None + + +"""psycopg connection status values.""" +STATUS_SETUP = 0 +STATUS_READY = 1 +STATUS_BEGIN = 2 +STATUS_SYNC = 3 # currently unused +STATUS_ASYNC = 4 # currently unused +STATUS_PREPARED = 5 + +# This is a useful mnemonic to check if the connection is in a transaction +STATUS_IN_TRANSACTION = STATUS_BEGIN + + +"""psycopg asynchronous connection polling values""" +POLL_OK = 0 +POLL_READ = 1 +POLL_WRITE = 2 +POLL_ERROR = 3 + + +"""Backend transaction status values.""" +TRANSACTION_STATUS_IDLE = 0 +TRANSACTION_STATUS_ACTIVE = 1 +TRANSACTION_STATUS_INTRANS = 2 +TRANSACTION_STATUS_INERROR = 3 +TRANSACTION_STATUS_UNKNOWN = 4 + + +def register_adapter(typ, callable): + """Register 'callable' as an ISQLQuote adapter for type 'typ'.""" + adapters[(typ, ISQLQuote)] = callable + + +# The SQL_IN class is the official adapter for tuples starting from 2.0.6. +class SQL_IN: + """Adapt any iterable to an SQL quotable object.""" + def __init__(self, seq): + self._seq = seq + self._conn = None + + def prepare(self, conn): + self._conn = conn + + def getquoted(self): + # this is the important line: note how every object in the + # list is adapted and then how getquoted() is called on it + pobjs = [adapt(o) for o in self._seq] + if self._conn is not None: + for obj in pobjs: + if hasattr(obj, 'prepare'): + obj.prepare(self._conn) + qobjs = [o.getquoted() for o in pobjs] + return b'(' + b', '.join(qobjs) + b')' + + def __str__(self): + return str(self.getquoted()) + + +class NoneAdapter: + """Adapt None to NULL. + + This adapter is not used normally as a fast path in mogrify uses NULL, + but it makes easier to adapt composite types. + """ + def __init__(self, obj): + pass + + def getquoted(self, _null=b"NULL"): + return _null + + +def make_dsn(dsn=None, **kwargs): + """Convert a set of keywords into a connection strings.""" + if dsn is None and not kwargs: + return '' + + # If no kwarg is specified don't mung the dsn, but verify it + if not kwargs: + parse_dsn(dsn) + return dsn + + # Override the dsn with the parameters + if 'database' in kwargs: + if 'dbname' in kwargs: + raise TypeError( + "you can't specify both 'database' and 'dbname' arguments") + kwargs['dbname'] = kwargs.pop('database') + + # Drop the None arguments + kwargs = {k: v for (k, v) in kwargs.items() if v is not None} + + if dsn is not None: + tmp = parse_dsn(dsn) + tmp.update(kwargs) + kwargs = tmp + + dsn = " ".join(["{}={}".format(k, _param_escape(str(v))) + for (k, v) in kwargs.items()]) + + # verify that the returned dsn is valid + parse_dsn(dsn) + + return dsn + + +def _param_escape(s, + re_escape=_re.compile(r"([\\'])"), + re_space=_re.compile(r'\s')): + """ + Apply the escaping rule required by PQconnectdb + """ + if not s: + return "''" + + s = re_escape.sub(r'\\\1', s) + if re_space.search(s): + s = "'" + s + "'" + + return s + + +# Create default json typecasters for PostgreSQL 9.2 oids +from psycopg2._json import register_default_json, register_default_jsonb # noqa + +try: + JSON, JSONARRAY = register_default_json() + JSONB, JSONBARRAY = register_default_jsonb() +except ImportError: + pass + +del register_default_json, register_default_jsonb + + +# Create default Range typecasters +from psycopg2. _range import Range # noqa +del Range + + +# Add the "cleaned" version of the encodings to the key. +# When the encoding is set its name is cleaned up from - and _ and turned +# uppercase, so an encoding not respecting these rules wouldn't be found in the +# encodings keys and would raise an exception with the unicode typecaster +for k, v in list(encodings.items()): + k = k.replace('_', '').replace('-', '').upper() + encodings[k] = v + +del k, v diff --git a/env/Lib/site-packages/psycopg2/extras.py b/env/Lib/site-packages/psycopg2/extras.py new file mode 100644 index 0000000..36e8ef9 --- /dev/null +++ b/env/Lib/site-packages/psycopg2/extras.py @@ -0,0 +1,1340 @@ +"""Miscellaneous goodies for psycopg2 + +This module is a generic place used to hold little helper functions +and classes until a better place in the distribution is found. +""" +# psycopg/extras.py - miscellaneous extra goodies for psycopg +# +# Copyright (C) 2003-2019 Federico Di Gregorio +# Copyright (C) 2020-2021 The Psycopg Team +# +# psycopg2 is free software: you can redistribute it and/or modify it +# under the terms of the GNU Lesser General Public License as published +# by the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# In addition, as a special exception, the copyright holders give +# permission to link this program with the OpenSSL library (or with +# modified versions of OpenSSL that use the same license as OpenSSL), +# and distribute linked combinations including the two. +# +# You must obey the GNU Lesser General Public License in all respects for +# all of the code used other than OpenSSL. +# +# psycopg2 is distributed in the hope that it will be useful, but WITHOUT +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public +# License for more details. + +import os as _os +import time as _time +import re as _re +from collections import namedtuple, OrderedDict + +import logging as _logging + +import psycopg2 +from psycopg2 import extensions as _ext +from .extensions import cursor as _cursor +from .extensions import connection as _connection +from .extensions import adapt as _A, quote_ident +from functools import lru_cache + +from psycopg2._psycopg import ( # noqa + REPLICATION_PHYSICAL, REPLICATION_LOGICAL, + ReplicationConnection as _replicationConnection, + ReplicationCursor as _replicationCursor, + ReplicationMessage) + + +# expose the json adaptation stuff into the module +from psycopg2._json import ( # noqa + json, Json, register_json, register_default_json, register_default_jsonb) + + +# Expose range-related objects +from psycopg2._range import ( # noqa + Range, NumericRange, DateRange, DateTimeRange, DateTimeTZRange, + register_range, RangeAdapter, RangeCaster) + + +# Expose ipaddress-related objects +from psycopg2._ipaddress import register_ipaddress # noqa + + +class DictCursorBase(_cursor): + """Base class for all dict-like cursors.""" + + def __init__(self, *args, **kwargs): + if 'row_factory' in kwargs: + row_factory = kwargs['row_factory'] + del kwargs['row_factory'] + else: + raise NotImplementedError( + "DictCursorBase can't be instantiated without a row factory.") + super().__init__(*args, **kwargs) + self._query_executed = False + self._prefetch = False + self.row_factory = row_factory + + def fetchone(self): + if self._prefetch: + res = super().fetchone() + if self._query_executed: + self._build_index() + if not self._prefetch: + res = super().fetchone() + return res + + def fetchmany(self, size=None): + if self._prefetch: + res = super().fetchmany(size) + if self._query_executed: + self._build_index() + if not self._prefetch: + res = super().fetchmany(size) + return res + + def fetchall(self): + if self._prefetch: + res = super().fetchall() + if self._query_executed: + self._build_index() + if not self._prefetch: + res = super().fetchall() + return res + + def __iter__(self): + try: + if self._prefetch: + res = super().__iter__() + first = next(res) + if self._query_executed: + self._build_index() + if not self._prefetch: + res = super().__iter__() + first = next(res) + + yield first + while True: + yield next(res) + except StopIteration: + return + + +class DictConnection(_connection): + """A connection that uses `DictCursor` automatically.""" + def cursor(self, *args, **kwargs): + kwargs.setdefault('cursor_factory', self.cursor_factory or DictCursor) + return super().cursor(*args, **kwargs) + + +class DictCursor(DictCursorBase): + """A cursor that keeps a list of column name -> index mappings__. + + .. __: https://docs.python.org/glossary.html#term-mapping + """ + + def __init__(self, *args, **kwargs): + kwargs['row_factory'] = DictRow + super().__init__(*args, **kwargs) + self._prefetch = True + + def execute(self, query, vars=None): + self.index = OrderedDict() + self._query_executed = True + return super().execute(query, vars) + + def callproc(self, procname, vars=None): + self.index = OrderedDict() + self._query_executed = True + return super().callproc(procname, vars) + + def _build_index(self): + if self._query_executed and self.description: + for i in range(len(self.description)): + self.index[self.description[i][0]] = i + self._query_executed = False + + +class DictRow(list): + """A row object that allow by-column-name access to data.""" + + __slots__ = ('_index',) + + def __init__(self, cursor): + self._index = cursor.index + self[:] = [None] * len(cursor.description) + + def __getitem__(self, x): + if not isinstance(x, (int, slice)): + x = self._index[x] + return super().__getitem__(x) + + def __setitem__(self, x, v): + if not isinstance(x, (int, slice)): + x = self._index[x] + super().__setitem__(x, v) + + def items(self): + g = super().__getitem__ + return ((n, g(self._index[n])) for n in self._index) + + def keys(self): + return iter(self._index) + + def values(self): + g = super().__getitem__ + return (g(self._index[n]) for n in self._index) + + def get(self, x, default=None): + try: + return self[x] + except Exception: + return default + + def copy(self): + return OrderedDict(self.items()) + + def __contains__(self, x): + return x in self._index + + def __reduce__(self): + # this is apparently useless, but it fixes #1073 + return super().__reduce__() + + def __getstate__(self): + return self[:], self._index.copy() + + def __setstate__(self, data): + self[:] = data[0] + self._index = data[1] + + +class RealDictConnection(_connection): + """A connection that uses `RealDictCursor` automatically.""" + def cursor(self, *args, **kwargs): + kwargs.setdefault('cursor_factory', self.cursor_factory or RealDictCursor) + return super().cursor(*args, **kwargs) + + +class RealDictCursor(DictCursorBase): + """A cursor that uses a real dict as the base type for rows. + + Note that this cursor is extremely specialized and does not allow + the normal access (using integer indices) to fetched data. If you need + to access database rows both as a dictionary and a list, then use + the generic `DictCursor` instead of `!RealDictCursor`. + """ + def __init__(self, *args, **kwargs): + kwargs['row_factory'] = RealDictRow + super().__init__(*args, **kwargs) + + def execute(self, query, vars=None): + self.column_mapping = [] + self._query_executed = True + return super().execute(query, vars) + + def callproc(self, procname, vars=None): + self.column_mapping = [] + self._query_executed = True + return super().callproc(procname, vars) + + def _build_index(self): + if self._query_executed and self.description: + self.column_mapping = [d[0] for d in self.description] + self._query_executed = False + + +class RealDictRow(OrderedDict): + """A `!dict` subclass representing a data record.""" + + def __init__(self, *args, **kwargs): + if args and isinstance(args[0], _cursor): + cursor = args[0] + args = args[1:] + else: + cursor = None + + super().__init__(*args, **kwargs) + + if cursor is not None: + # Required for named cursors + if cursor.description and not cursor.column_mapping: + cursor._build_index() + + # Store the cols mapping in the dict itself until the row is fully + # populated, so we don't need to add attributes to the class + # (hence keeping its maintenance, special pickle support, etc.) + self[RealDictRow] = cursor.column_mapping + + def __setitem__(self, key, value): + if RealDictRow in self: + # We are in the row building phase + mapping = self[RealDictRow] + super().__setitem__(mapping[key], value) + if key == len(mapping) - 1: + # Row building finished + del self[RealDictRow] + return + + super().__setitem__(key, value) + + +class NamedTupleConnection(_connection): + """A connection that uses `NamedTupleCursor` automatically.""" + def cursor(self, *args, **kwargs): + kwargs.setdefault('cursor_factory', self.cursor_factory or NamedTupleCursor) + return super().cursor(*args, **kwargs) + + +class NamedTupleCursor(_cursor): + """A cursor that generates results as `~collections.namedtuple`. + + `!fetch*()` methods will return named tuples instead of regular tuples, so + their elements can be accessed both as regular numeric items as well as + attributes. + + >>> nt_cur = conn.cursor(cursor_factory=psycopg2.extras.NamedTupleCursor) + >>> rec = nt_cur.fetchone() + >>> rec + Record(id=1, num=100, data="abc'def") + >>> rec[1] + 100 + >>> rec.data + "abc'def" + """ + Record = None + MAX_CACHE = 1024 + + def execute(self, query, vars=None): + self.Record = None + return super().execute(query, vars) + + def executemany(self, query, vars): + self.Record = None + return super().executemany(query, vars) + + def callproc(self, procname, vars=None): + self.Record = None + return super().callproc(procname, vars) + + def fetchone(self): + t = super().fetchone() + if t is not None: + nt = self.Record + if nt is None: + nt = self.Record = self._make_nt() + return nt._make(t) + + def fetchmany(self, size=None): + ts = super().fetchmany(size) + nt = self.Record + if nt is None: + nt = self.Record = self._make_nt() + return list(map(nt._make, ts)) + + def fetchall(self): + ts = super().fetchall() + nt = self.Record + if nt is None: + nt = self.Record = self._make_nt() + return list(map(nt._make, ts)) + + def __iter__(self): + try: + it = super().__iter__() + t = next(it) + + nt = self.Record + if nt is None: + nt = self.Record = self._make_nt() + + yield nt._make(t) + + while True: + yield nt._make(next(it)) + except StopIteration: + return + + def _make_nt(self): + key = tuple(d[0] for d in self.description) if self.description else () + return self._cached_make_nt(key) + + @classmethod + def _do_make_nt(cls, key): + fields = [] + for s in key: + s = _re_clean.sub('_', s) + # Python identifier cannot start with numbers, namedtuple fields + # cannot start with underscore. So... + if s[0] == '_' or '0' <= s[0] <= '9': + s = 'f' + s + fields.append(s) + + nt = namedtuple("Record", fields) + return nt + + +@lru_cache(512) +def _cached_make_nt(cls, key): + return cls._do_make_nt(key) + + +# Exposed for testability, and if someone wants to monkeypatch to tweak +# the cache size. +NamedTupleCursor._cached_make_nt = classmethod(_cached_make_nt) + + +class LoggingConnection(_connection): + """A connection that logs all queries to a file or logger__ object. + + .. __: https://docs.python.org/library/logging.html + """ + + def initialize(self, logobj): + """Initialize the connection to log to `!logobj`. + + The `!logobj` parameter can be an open file object or a Logger/LoggerAdapter + instance from the standard logging module. + """ + self._logobj = logobj + if _logging and isinstance( + logobj, (_logging.Logger, _logging.LoggerAdapter)): + self.log = self._logtologger + else: + self.log = self._logtofile + + def filter(self, msg, curs): + """Filter the query before logging it. + + This is the method to overwrite to filter unwanted queries out of the + log or to add some extra data to the output. The default implementation + just does nothing. + """ + return msg + + def _logtofile(self, msg, curs): + msg = self.filter(msg, curs) + if msg: + if isinstance(msg, bytes): + msg = msg.decode(_ext.encodings[self.encoding], 'replace') + self._logobj.write(msg + _os.linesep) + + def _logtologger(self, msg, curs): + msg = self.filter(msg, curs) + if msg: + self._logobj.debug(msg) + + def _check(self): + if not hasattr(self, '_logobj'): + raise self.ProgrammingError( + "LoggingConnection object has not been initialize()d") + + def cursor(self, *args, **kwargs): + self._check() + kwargs.setdefault('cursor_factory', self.cursor_factory or LoggingCursor) + return super().cursor(*args, **kwargs) + + +class LoggingCursor(_cursor): + """A cursor that logs queries using its connection logging facilities.""" + + def execute(self, query, vars=None): + try: + return super().execute(query, vars) + finally: + self.connection.log(self.query, self) + + def callproc(self, procname, vars=None): + try: + return super().callproc(procname, vars) + finally: + self.connection.log(self.query, self) + + +class MinTimeLoggingConnection(LoggingConnection): + """A connection that logs queries based on execution time. + + This is just an example of how to sub-class `LoggingConnection` to + provide some extra filtering for the logged queries. Both the + `initialize()` and `filter()` methods are overwritten to make sure + that only queries executing for more than ``mintime`` ms are logged. + + Note that this connection uses the specialized cursor + `MinTimeLoggingCursor`. + """ + def initialize(self, logobj, mintime=0): + LoggingConnection.initialize(self, logobj) + self._mintime = mintime + + def filter(self, msg, curs): + t = (_time.time() - curs.timestamp) * 1000 + if t > self._mintime: + if isinstance(msg, bytes): + msg = msg.decode(_ext.encodings[self.encoding], 'replace') + return f"{msg}{_os.linesep} (execution time: {t} ms)" + + def cursor(self, *args, **kwargs): + kwargs.setdefault('cursor_factory', + self.cursor_factory or MinTimeLoggingCursor) + return LoggingConnection.cursor(self, *args, **kwargs) + + +class MinTimeLoggingCursor(LoggingCursor): + """The cursor sub-class companion to `MinTimeLoggingConnection`.""" + + def execute(self, query, vars=None): + self.timestamp = _time.time() + return LoggingCursor.execute(self, query, vars) + + def callproc(self, procname, vars=None): + self.timestamp = _time.time() + return LoggingCursor.callproc(self, procname, vars) + + +class LogicalReplicationConnection(_replicationConnection): + + def __init__(self, *args, **kwargs): + kwargs['replication_type'] = REPLICATION_LOGICAL + super().__init__(*args, **kwargs) + + +class PhysicalReplicationConnection(_replicationConnection): + + def __init__(self, *args, **kwargs): + kwargs['replication_type'] = REPLICATION_PHYSICAL + super().__init__(*args, **kwargs) + + +class StopReplication(Exception): + """ + Exception used to break out of the endless loop in + `~ReplicationCursor.consume_stream()`. + + Subclass of `~exceptions.Exception`. Intentionally *not* inherited from + `~psycopg2.Error` as occurrence of this exception does not indicate an + error. + """ + pass + + +class ReplicationCursor(_replicationCursor): + """A cursor used for communication on replication connections.""" + + def create_replication_slot(self, slot_name, slot_type=None, output_plugin=None): + """Create streaming replication slot.""" + + command = f"CREATE_REPLICATION_SLOT {quote_ident(slot_name, self)} " + + if slot_type is None: + slot_type = self.connection.replication_type + + if slot_type == REPLICATION_LOGICAL: + if output_plugin is None: + raise psycopg2.ProgrammingError( + "output plugin name is required to create " + "logical replication slot") + + command += f"LOGICAL {quote_ident(output_plugin, self)}" + + elif slot_type == REPLICATION_PHYSICAL: + if output_plugin is not None: + raise psycopg2.ProgrammingError( + "cannot specify output plugin name when creating " + "physical replication slot") + + command += "PHYSICAL" + + else: + raise psycopg2.ProgrammingError( + f"unrecognized replication type: {repr(slot_type)}") + + self.execute(command) + + def drop_replication_slot(self, slot_name): + """Drop streaming replication slot.""" + + command = f"DROP_REPLICATION_SLOT {quote_ident(slot_name, self)}" + self.execute(command) + + def start_replication( + self, slot_name=None, slot_type=None, start_lsn=0, + timeline=0, options=None, decode=False, status_interval=10): + """Start replication stream.""" + + command = "START_REPLICATION " + + if slot_type is None: + slot_type = self.connection.replication_type + + if slot_type == REPLICATION_LOGICAL: + if slot_name: + command += f"SLOT {quote_ident(slot_name, self)} " + else: + raise psycopg2.ProgrammingError( + "slot name is required for logical replication") + + command += "LOGICAL " + + elif slot_type == REPLICATION_PHYSICAL: + if slot_name: + command += f"SLOT {quote_ident(slot_name, self)} " + # don't add "PHYSICAL", before 9.4 it was just START_REPLICATION XXX/XXX + + else: + raise psycopg2.ProgrammingError( + f"unrecognized replication type: {repr(slot_type)}") + + if type(start_lsn) is str: + lsn = start_lsn.split('/') + lsn = f"{int(lsn[0], 16):X}/{int(lsn[1], 16):08X}" + else: + lsn = f"{start_lsn >> 32 & 4294967295:X}/{start_lsn & 4294967295:08X}" + + command += lsn + + if timeline != 0: + if slot_type == REPLICATION_LOGICAL: + raise psycopg2.ProgrammingError( + "cannot specify timeline for logical replication") + + command += f" TIMELINE {timeline}" + + if options: + if slot_type == REPLICATION_PHYSICAL: + raise psycopg2.ProgrammingError( + "cannot specify output plugin options for physical replication") + + command += " (" + for k, v in options.items(): + if not command.endswith('('): + command += ", " + command += f"{quote_ident(k, self)} {_A(str(v))}" + command += ")" + + self.start_replication_expert( + command, decode=decode, status_interval=status_interval) + + # allows replication cursors to be used in select.select() directly + def fileno(self): + return self.connection.fileno() + + +# a dbtype and adapter for Python UUID type + +class UUID_adapter: + """Adapt Python's uuid.UUID__ type to PostgreSQL's uuid__. + + .. __: https://docs.python.org/library/uuid.html + .. __: https://www.postgresql.org/docs/current/static/datatype-uuid.html + """ + + def __init__(self, uuid): + self._uuid = uuid + + def __conform__(self, proto): + if proto is _ext.ISQLQuote: + return self + + def getquoted(self): + return (f"'{self._uuid}'::uuid").encode('utf8') + + def __str__(self): + return f"'{self._uuid}'::uuid" + + +def register_uuid(oids=None, conn_or_curs=None): + """Create the UUID type and an uuid.UUID adapter. + + :param oids: oid for the PostgreSQL :sql:`uuid` type, or 2-items sequence + with oids of the type and the array. If not specified, use PostgreSQL + standard oids. + :param conn_or_curs: where to register the typecaster. If not specified, + register it globally. + """ + + import uuid + + if not oids: + oid1 = 2950 + oid2 = 2951 + elif isinstance(oids, (list, tuple)): + oid1, oid2 = oids + else: + oid1 = oids + oid2 = 2951 + + _ext.UUID = _ext.new_type((oid1, ), "UUID", + lambda data, cursor: data and uuid.UUID(data) or None) + _ext.UUIDARRAY = _ext.new_array_type((oid2,), "UUID[]", _ext.UUID) + + _ext.register_type(_ext.UUID, conn_or_curs) + _ext.register_type(_ext.UUIDARRAY, conn_or_curs) + _ext.register_adapter(uuid.UUID, UUID_adapter) + + return _ext.UUID + + +# a type, dbtype and adapter for PostgreSQL inet type + +class Inet: + """Wrap a string to allow for correct SQL-quoting of inet values. + + Note that this adapter does NOT check the passed value to make + sure it really is an inet-compatible address but DOES call adapt() + on it to make sure it is impossible to execute an SQL-injection + by passing an evil value to the initializer. + """ + def __init__(self, addr): + self.addr = addr + + def __repr__(self): + return f"{self.__class__.__name__}({self.addr!r})" + + def prepare(self, conn): + self._conn = conn + + def getquoted(self): + obj = _A(self.addr) + if hasattr(obj, 'prepare'): + obj.prepare(self._conn) + return obj.getquoted() + b"::inet" + + def __conform__(self, proto): + if proto is _ext.ISQLQuote: + return self + + def __str__(self): + return str(self.addr) + + +def register_inet(oid=None, conn_or_curs=None): + """Create the INET type and an Inet adapter. + + :param oid: oid for the PostgreSQL :sql:`inet` type, or 2-items sequence + with oids of the type and the array. If not specified, use PostgreSQL + standard oids. + :param conn_or_curs: where to register the typecaster. If not specified, + register it globally. + """ + import warnings + warnings.warn( + "the inet adapter is deprecated, it's not very useful", + DeprecationWarning) + + if not oid: + oid1 = 869 + oid2 = 1041 + elif isinstance(oid, (list, tuple)): + oid1, oid2 = oid + else: + oid1 = oid + oid2 = 1041 + + _ext.INET = _ext.new_type((oid1, ), "INET", + lambda data, cursor: data and Inet(data) or None) + _ext.INETARRAY = _ext.new_array_type((oid2, ), "INETARRAY", _ext.INET) + + _ext.register_type(_ext.INET, conn_or_curs) + _ext.register_type(_ext.INETARRAY, conn_or_curs) + + return _ext.INET + + +def wait_select(conn): + """Wait until a connection or cursor has data available. + + The function is an example of a wait callback to be registered with + `~psycopg2.extensions.set_wait_callback()`. This function uses + :py:func:`~select.select()` to wait for data to become available, and + therefore is able to handle/receive SIGINT/KeyboardInterrupt. + """ + import select + from psycopg2.extensions import POLL_OK, POLL_READ, POLL_WRITE + + while True: + try: + state = conn.poll() + if state == POLL_OK: + break + elif state == POLL_READ: + select.select([conn.fileno()], [], []) + elif state == POLL_WRITE: + select.select([], [conn.fileno()], []) + else: + raise conn.OperationalError(f"bad state from poll: {state}") + except KeyboardInterrupt: + conn.cancel() + # the loop will be broken by a server error + continue + + +def _solve_conn_curs(conn_or_curs): + """Return the connection and a DBAPI cursor from a connection or cursor.""" + if conn_or_curs is None: + raise psycopg2.ProgrammingError("no connection or cursor provided") + + if hasattr(conn_or_curs, 'execute'): + conn = conn_or_curs.connection + curs = conn.cursor(cursor_factory=_cursor) + else: + conn = conn_or_curs + curs = conn.cursor(cursor_factory=_cursor) + + return conn, curs + + +class HstoreAdapter: + """Adapt a Python dict to the hstore syntax.""" + def __init__(self, wrapped): + self.wrapped = wrapped + + def prepare(self, conn): + self.conn = conn + + # use an old-style getquoted implementation if required + if conn.info.server_version < 90000: + self.getquoted = self._getquoted_8 + + def _getquoted_8(self): + """Use the operators available in PG pre-9.0.""" + if not self.wrapped: + return b"''::hstore" + + adapt = _ext.adapt + rv = [] + for k, v in self.wrapped.items(): + k = adapt(k) + k.prepare(self.conn) + k = k.getquoted() + + if v is not None: + v = adapt(v) + v.prepare(self.conn) + v = v.getquoted() + else: + v = b'NULL' + + # XXX this b'ing is painfully inefficient! + rv.append(b"(" + k + b" => " + v + b")") + + return b"(" + b'||'.join(rv) + b")" + + def _getquoted_9(self): + """Use the hstore(text[], text[]) function.""" + if not self.wrapped: + return b"''::hstore" + + k = _ext.adapt(list(self.wrapped.keys())) + k.prepare(self.conn) + v = _ext.adapt(list(self.wrapped.values())) + v.prepare(self.conn) + return b"hstore(" + k.getquoted() + b", " + v.getquoted() + b")" + + getquoted = _getquoted_9 + + _re_hstore = _re.compile(r""" + # hstore key: + # a string of normal or escaped chars + "((?: [^"\\] | \\. )*)" + \s*=>\s* # hstore value + (?: + NULL # the value can be null - not catched + # or a quoted string like the key + | "((?: [^"\\] | \\. )*)" + ) + (?:\s*,\s*|$) # pairs separated by comma or end of string. + """, _re.VERBOSE) + + @classmethod + def parse(self, s, cur, _bsdec=_re.compile(r"\\(.)")): + """Parse an hstore representation in a Python string. + + The hstore is represented as something like:: + + "a"=>"1", "b"=>"2" + + with backslash-escaped strings. + """ + if s is None: + return None + + rv = {} + start = 0 + for m in self._re_hstore.finditer(s): + if m is None or m.start() != start: + raise psycopg2.InterfaceError( + f"error parsing hstore pair at char {start}") + k = _bsdec.sub(r'\1', m.group(1)) + v = m.group(2) + if v is not None: + v = _bsdec.sub(r'\1', v) + + rv[k] = v + start = m.end() + + if start < len(s): + raise psycopg2.InterfaceError( + f"error parsing hstore: unparsed data after char {start}") + + return rv + + @classmethod + def parse_unicode(self, s, cur): + """Parse an hstore returning unicode keys and values.""" + if s is None: + return None + + s = s.decode(_ext.encodings[cur.connection.encoding]) + return self.parse(s, cur) + + @classmethod + def get_oids(self, conn_or_curs): + """Return the lists of OID of the hstore and hstore[] types. + """ + conn, curs = _solve_conn_curs(conn_or_curs) + + # Store the transaction status of the connection to revert it after use + conn_status = conn.status + + # column typarray not available before PG 8.3 + typarray = conn.info.server_version >= 80300 and "typarray" or "NULL" + + rv0, rv1 = [], [] + + # get the oid for the hstore + curs.execute(f"""SELECT t.oid, {typarray} +FROM pg_type t JOIN pg_namespace ns + ON typnamespace = ns.oid +WHERE typname = 'hstore'; +""") + for oids in curs: + rv0.append(oids[0]) + rv1.append(oids[1]) + + # revert the status of the connection as before the command + if (conn_status != _ext.STATUS_IN_TRANSACTION + and not conn.autocommit): + conn.rollback() + + return tuple(rv0), tuple(rv1) + + +def register_hstore(conn_or_curs, globally=False, unicode=False, + oid=None, array_oid=None): + r"""Register adapter and typecaster for `!dict`\-\ |hstore| conversions. + + :param conn_or_curs: a connection or cursor: the typecaster will be + registered only on this object unless *globally* is set to `!True` + :param globally: register the adapter globally, not only on *conn_or_curs* + :param unicode: if `!True`, keys and values returned from the database + will be `!unicode` instead of `!str`. The option is not available on + Python 3 + :param oid: the OID of the |hstore| type if known. If not, it will be + queried on *conn_or_curs*. + :param array_oid: the OID of the |hstore| array type if known. If not, it + will be queried on *conn_or_curs*. + + The connection or cursor passed to the function will be used to query the + database and look for the OID of the |hstore| type (which may be different + across databases). If querying is not desirable (e.g. with + :ref:`asynchronous connections `) you may specify it in the + *oid* parameter, which can be found using a query such as :sql:`SELECT + 'hstore'::regtype::oid`. Analogously you can obtain a value for *array_oid* + using a query such as :sql:`SELECT 'hstore[]'::regtype::oid`. + + Note that, when passing a dictionary from Python to the database, both + strings and unicode keys and values are supported. Dictionaries returned + from the database have keys/values according to the *unicode* parameter. + + The |hstore| contrib module must be already installed in the database + (executing the ``hstore.sql`` script in your ``contrib`` directory). + Raise `~psycopg2.ProgrammingError` if the type is not found. + """ + if oid is None: + oid = HstoreAdapter.get_oids(conn_or_curs) + if oid is None or not oid[0]: + raise psycopg2.ProgrammingError( + "hstore type not found in the database. " + "please install it from your 'contrib/hstore.sql' file") + else: + array_oid = oid[1] + oid = oid[0] + + if isinstance(oid, int): + oid = (oid,) + + if array_oid is not None: + if isinstance(array_oid, int): + array_oid = (array_oid,) + else: + array_oid = tuple([x for x in array_oid if x]) + + # create and register the typecaster + HSTORE = _ext.new_type(oid, "HSTORE", HstoreAdapter.parse) + _ext.register_type(HSTORE, not globally and conn_or_curs or None) + _ext.register_adapter(dict, HstoreAdapter) + + if array_oid: + HSTOREARRAY = _ext.new_array_type(array_oid, "HSTOREARRAY", HSTORE) + _ext.register_type(HSTOREARRAY, not globally and conn_or_curs or None) + + +class CompositeCaster: + """Helps conversion of a PostgreSQL composite type into a Python object. + + The class is usually created by the `register_composite()` function. + You may want to create and register manually instances of the class if + querying the database at registration time is not desirable (such as when + using an :ref:`asynchronous connections `). + + """ + def __init__(self, name, oid, attrs, array_oid=None, schema=None): + self.name = name + self.schema = schema + self.oid = oid + self.array_oid = array_oid + + self.attnames = [a[0] for a in attrs] + self.atttypes = [a[1] for a in attrs] + self._create_type(name, self.attnames) + self.typecaster = _ext.new_type((oid,), name, self.parse) + if array_oid: + self.array_typecaster = _ext.new_array_type( + (array_oid,), f"{name}ARRAY", self.typecaster) + else: + self.array_typecaster = None + + def parse(self, s, curs): + if s is None: + return None + + tokens = self.tokenize(s) + if len(tokens) != len(self.atttypes): + raise psycopg2.DataError( + "expecting %d components for the type %s, %d found instead" % + (len(self.atttypes), self.name, len(tokens))) + + values = [curs.cast(oid, token) + for oid, token in zip(self.atttypes, tokens)] + + return self.make(values) + + def make(self, values): + """Return a new Python object representing the data being casted. + + *values* is the list of attributes, already casted into their Python + representation. + + You can subclass this method to :ref:`customize the composite cast + `. + """ + + return self._ctor(values) + + _re_tokenize = _re.compile(r""" + \(? ([,)]) # an empty token, representing NULL +| \(? " ((?: [^"] | "")*) " [,)] # or a quoted string +| \(? ([^",)]+) [,)] # or an unquoted string + """, _re.VERBOSE) + + _re_undouble = _re.compile(r'(["\\])\1') + + @classmethod + def tokenize(self, s): + rv = [] + for m in self._re_tokenize.finditer(s): + if m is None: + raise psycopg2.InterfaceError(f"can't parse type: {s!r}") + if m.group(1) is not None: + rv.append(None) + elif m.group(2) is not None: + rv.append(self._re_undouble.sub(r"\1", m.group(2))) + else: + rv.append(m.group(3)) + + return rv + + def _create_type(self, name, attnames): + name = _re_clean.sub('_', name) + self.type = namedtuple(name, attnames) + self._ctor = self.type._make + + @classmethod + def _from_db(self, name, conn_or_curs): + """Return a `CompositeCaster` instance for the type *name*. + + Raise `ProgrammingError` if the type is not found. + """ + conn, curs = _solve_conn_curs(conn_or_curs) + + # Store the transaction status of the connection to revert it after use + conn_status = conn.status + + # Use the correct schema + if '.' in name: + schema, tname = name.split('.', 1) + else: + tname = name + schema = 'public' + + # column typarray not available before PG 8.3 + typarray = conn.info.server_version >= 80300 and "typarray" or "NULL" + + # get the type oid and attributes + curs.execute("""\ +SELECT t.oid, %s, attname, atttypid +FROM pg_type t +JOIN pg_namespace ns ON typnamespace = ns.oid +JOIN pg_attribute a ON attrelid = typrelid +WHERE typname = %%s AND nspname = %%s + AND attnum > 0 AND NOT attisdropped +ORDER BY attnum; +""" % typarray, (tname, schema)) + + recs = curs.fetchall() + + if not recs: + # The above algorithm doesn't work for customized seach_path + # (#1487) The implementation below works better, but, to guarantee + # backwards compatibility, use it only if the original one failed. + try: + savepoint = False + # Because we executed statements earlier, we are either INTRANS + # or we are IDLE only if the transaction is autocommit, in + # which case we don't need the savepoint anyway. + if conn.status == _ext.STATUS_IN_TRANSACTION: + curs.execute("SAVEPOINT register_type") + savepoint = True + + curs.execute("""\ +SELECT t.oid, %s, attname, atttypid, typname, nspname +FROM pg_type t +JOIN pg_namespace ns ON typnamespace = ns.oid +JOIN pg_attribute a ON attrelid = typrelid +WHERE t.oid = %%s::regtype + AND attnum > 0 AND NOT attisdropped +ORDER BY attnum; +""" % typarray, (name, )) + except psycopg2.ProgrammingError: + pass + else: + recs = curs.fetchall() + if recs: + tname = recs[0][4] + schema = recs[0][5] + finally: + if savepoint: + curs.execute("ROLLBACK TO SAVEPOINT register_type") + + # revert the status of the connection as before the command + if conn_status != _ext.STATUS_IN_TRANSACTION and not conn.autocommit: + conn.rollback() + + if not recs: + raise psycopg2.ProgrammingError( + f"PostgreSQL type '{name}' not found") + + type_oid = recs[0][0] + array_oid = recs[0][1] + type_attrs = [(r[2], r[3]) for r in recs] + + return self(tname, type_oid, type_attrs, + array_oid=array_oid, schema=schema) + + +def register_composite(name, conn_or_curs, globally=False, factory=None): + """Register a typecaster to convert a composite type into a tuple. + + :param name: the name of a PostgreSQL composite type, e.g. created using + the |CREATE TYPE|_ command + :param conn_or_curs: a connection or cursor used to find the type oid and + components; the typecaster is registered in a scope limited to this + object, unless *globally* is set to `!True` + :param globally: if `!False` (default) register the typecaster only on + *conn_or_curs*, otherwise register it globally + :param factory: if specified it should be a `CompositeCaster` subclass: use + it to :ref:`customize how to cast composite types ` + :return: the registered `CompositeCaster` or *factory* instance + responsible for the conversion + """ + if factory is None: + factory = CompositeCaster + + caster = factory._from_db(name, conn_or_curs) + _ext.register_type(caster.typecaster, not globally and conn_or_curs or None) + + if caster.array_typecaster is not None: + _ext.register_type( + caster.array_typecaster, not globally and conn_or_curs or None) + + return caster + + +def _paginate(seq, page_size): + """Consume an iterable and return it in chunks. + + Every chunk is at most `page_size`. Never return an empty chunk. + """ + page = [] + it = iter(seq) + while True: + try: + for i in range(page_size): + page.append(next(it)) + yield page + page = [] + except StopIteration: + if page: + yield page + return + + +def execute_batch(cur, sql, argslist, page_size=100): + r"""Execute groups of statements in fewer server roundtrips. + + Execute *sql* several times, against all parameters set (sequences or + mappings) found in *argslist*. + + The function is semantically similar to + + .. parsed-literal:: + + *cur*\.\ `~cursor.executemany`\ (\ *sql*\ , *argslist*\ ) + + but has a different implementation: Psycopg will join the statements into + fewer multi-statement commands, each one containing at most *page_size* + statements, resulting in a reduced number of server roundtrips. + + After the execution of the function the `cursor.rowcount` property will + **not** contain a total result. + + """ + for page in _paginate(argslist, page_size=page_size): + sqls = [cur.mogrify(sql, args) for args in page] + cur.execute(b";".join(sqls)) + + +def execute_values(cur, sql, argslist, template=None, page_size=100, fetch=False): + '''Execute a statement using :sql:`VALUES` with a sequence of parameters. + + :param cur: the cursor to use to execute the query. + + :param sql: the query to execute. It must contain a single ``%s`` + placeholder, which will be replaced by a `VALUES list`__. + Example: ``"INSERT INTO mytable (id, f1, f2) VALUES %s"``. + + :param argslist: sequence of sequences or dictionaries with the arguments + to send to the query. The type and content must be consistent with + *template*. + + :param template: the snippet to merge to every item in *argslist* to + compose the query. + + - If the *argslist* items are sequences it should contain positional + placeholders (e.g. ``"(%s, %s, %s)"``, or ``"(%s, %s, 42)``" if there + are constants value...). + + - If the *argslist* items are mappings it should contain named + placeholders (e.g. ``"(%(id)s, %(f1)s, 42)"``). + + If not specified, assume the arguments are sequence and use a simple + positional template (i.e. ``(%s, %s, ...)``), with the number of + placeholders sniffed by the first element in *argslist*. + + :param page_size: maximum number of *argslist* items to include in every + statement. If there are more items the function will execute more than + one statement. + + :param fetch: if `!True` return the query results into a list (like in a + `~cursor.fetchall()`). Useful for queries with :sql:`RETURNING` + clause. + + .. __: https://www.postgresql.org/docs/current/static/queries-values.html + + After the execution of the function the `cursor.rowcount` property will + **not** contain a total result. + + While :sql:`INSERT` is an obvious candidate for this function it is + possible to use it with other statements, for example:: + + >>> cur.execute( + ... "create table test (id int primary key, v1 int, v2 int)") + + >>> execute_values(cur, + ... "INSERT INTO test (id, v1, v2) VALUES %s", + ... [(1, 2, 3), (4, 5, 6), (7, 8, 9)]) + + >>> execute_values(cur, + ... """UPDATE test SET v1 = data.v1 FROM (VALUES %s) AS data (id, v1) + ... WHERE test.id = data.id""", + ... [(1, 20), (4, 50)]) + + >>> cur.execute("select * from test order by id") + >>> cur.fetchall() + [(1, 20, 3), (4, 50, 6), (7, 8, 9)]) + + ''' + from psycopg2.sql import Composable + if isinstance(sql, Composable): + sql = sql.as_string(cur) + + # we can't just use sql % vals because vals is bytes: if sql is bytes + # there will be some decoding error because of stupid codec used, and Py3 + # doesn't implement % on bytes. + if not isinstance(sql, bytes): + sql = sql.encode(_ext.encodings[cur.connection.encoding]) + pre, post = _split_sql(sql) + + result = [] if fetch else None + for page in _paginate(argslist, page_size=page_size): + if template is None: + template = b'(' + b','.join([b'%s'] * len(page[0])) + b')' + parts = pre[:] + for args in page: + parts.append(cur.mogrify(template, args)) + parts.append(b',') + parts[-1:] = post + cur.execute(b''.join(parts)) + if fetch: + result.extend(cur.fetchall()) + + return result + + +def _split_sql(sql): + """Split *sql* on a single ``%s`` placeholder. + + Split on the %s, perform %% replacement and return pre, post lists of + snippets. + """ + curr = pre = [] + post = [] + tokens = _re.split(br'(%.)', sql) + for token in tokens: + if len(token) != 2 or token[:1] != b'%': + curr.append(token) + continue + + if token[1:] == b's': + if curr is pre: + curr = post + else: + raise ValueError( + "the query contains more than one '%s' placeholder") + elif token[1:] == b'%': + curr.append(b'%') + else: + raise ValueError("unsupported format character: '%s'" + % token[1:].decode('ascii', 'replace')) + + if curr is pre: + raise ValueError("the query doesn't contain any '%s' placeholder") + + return pre, post + + +# ascii except alnum and underscore +_re_clean = _re.compile( + '[' + _re.escape(' !"#$%&\'()*+,-./:;<=>?@[\\]^`{|}~') + ']') diff --git a/env/Lib/site-packages/psycopg2/pool.py b/env/Lib/site-packages/psycopg2/pool.py new file mode 100644 index 0000000..9d67d68 --- /dev/null +++ b/env/Lib/site-packages/psycopg2/pool.py @@ -0,0 +1,187 @@ +"""Connection pooling for psycopg2 + +This module implements thread-safe (and not) connection pools. +""" +# psycopg/pool.py - pooling code for psycopg +# +# Copyright (C) 2003-2019 Federico Di Gregorio +# Copyright (C) 2020-2021 The Psycopg Team +# +# psycopg2 is free software: you can redistribute it and/or modify it +# under the terms of the GNU Lesser General Public License as published +# by the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# In addition, as a special exception, the copyright holders give +# permission to link this program with the OpenSSL library (or with +# modified versions of OpenSSL that use the same license as OpenSSL), +# and distribute linked combinations including the two. +# +# You must obey the GNU Lesser General Public License in all respects for +# all of the code used other than OpenSSL. +# +# psycopg2 is distributed in the hope that it will be useful, but WITHOUT +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public +# License for more details. + +import psycopg2 +from psycopg2 import extensions as _ext + + +class PoolError(psycopg2.Error): + pass + + +class AbstractConnectionPool: + """Generic key-based pooling code.""" + + def __init__(self, minconn, maxconn, *args, **kwargs): + """Initialize the connection pool. + + New 'minconn' connections are created immediately calling 'connfunc' + with given parameters. The connection pool will support a maximum of + about 'maxconn' connections. + """ + self.minconn = int(minconn) + self.maxconn = int(maxconn) + self.closed = False + + self._args = args + self._kwargs = kwargs + + self._pool = [] + self._used = {} + self._rused = {} # id(conn) -> key map + self._keys = 0 + + for i in range(self.minconn): + self._connect() + + def _connect(self, key=None): + """Create a new connection and assign it to 'key' if not None.""" + conn = psycopg2.connect(*self._args, **self._kwargs) + if key is not None: + self._used[key] = conn + self._rused[id(conn)] = key + else: + self._pool.append(conn) + return conn + + def _getkey(self): + """Return a new unique key.""" + self._keys += 1 + return self._keys + + def _getconn(self, key=None): + """Get a free connection and assign it to 'key' if not None.""" + if self.closed: + raise PoolError("connection pool is closed") + if key is None: + key = self._getkey() + + if key in self._used: + return self._used[key] + + if self._pool: + self._used[key] = conn = self._pool.pop() + self._rused[id(conn)] = key + return conn + else: + if len(self._used) == self.maxconn: + raise PoolError("connection pool exhausted") + return self._connect(key) + + def _putconn(self, conn, key=None, close=False): + """Put away a connection.""" + if self.closed: + raise PoolError("connection pool is closed") + + if key is None: + key = self._rused.get(id(conn)) + if key is None: + raise PoolError("trying to put unkeyed connection") + + if len(self._pool) < self.minconn and not close: + # Return the connection into a consistent state before putting + # it back into the pool + if not conn.closed: + status = conn.info.transaction_status + if status == _ext.TRANSACTION_STATUS_UNKNOWN: + # server connection lost + conn.close() + elif status != _ext.TRANSACTION_STATUS_IDLE: + # connection in error or in transaction + conn.rollback() + self._pool.append(conn) + else: + # regular idle connection + self._pool.append(conn) + # If the connection is closed, we just discard it. + else: + conn.close() + + # here we check for the presence of key because it can happen that a + # thread tries to put back a connection after a call to close + if not self.closed or key in self._used: + del self._used[key] + del self._rused[id(conn)] + + def _closeall(self): + """Close all connections. + + Note that this can lead to some code fail badly when trying to use + an already closed connection. If you call .closeall() make sure + your code can deal with it. + """ + if self.closed: + raise PoolError("connection pool is closed") + for conn in self._pool + list(self._used.values()): + try: + conn.close() + except Exception: + pass + self.closed = True + + +class SimpleConnectionPool(AbstractConnectionPool): + """A connection pool that can't be shared across different threads.""" + + getconn = AbstractConnectionPool._getconn + putconn = AbstractConnectionPool._putconn + closeall = AbstractConnectionPool._closeall + + +class ThreadedConnectionPool(AbstractConnectionPool): + """A connection pool that works with the threading module.""" + + def __init__(self, minconn, maxconn, *args, **kwargs): + """Initialize the threading lock.""" + import threading + AbstractConnectionPool.__init__( + self, minconn, maxconn, *args, **kwargs) + self._lock = threading.Lock() + + def getconn(self, key=None): + """Get a free connection and assign it to 'key' if not None.""" + self._lock.acquire() + try: + return self._getconn(key) + finally: + self._lock.release() + + def putconn(self, conn=None, key=None, close=False): + """Put away an unused connection.""" + self._lock.acquire() + try: + self._putconn(conn, key, close) + finally: + self._lock.release() + + def closeall(self): + """Close all connections (even the one currently in use.)""" + self._lock.acquire() + try: + self._closeall() + finally: + self._lock.release() diff --git a/env/Lib/site-packages/psycopg2/sql.py b/env/Lib/site-packages/psycopg2/sql.py new file mode 100644 index 0000000..69b352b --- /dev/null +++ b/env/Lib/site-packages/psycopg2/sql.py @@ -0,0 +1,455 @@ +"""SQL composition utility module +""" + +# psycopg/sql.py - SQL composition utility module +# +# Copyright (C) 2016-2019 Daniele Varrazzo +# Copyright (C) 2020-2021 The Psycopg Team +# +# psycopg2 is free software: you can redistribute it and/or modify it +# under the terms of the GNU Lesser General Public License as published +# by the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# In addition, as a special exception, the copyright holders give +# permission to link this program with the OpenSSL library (or with +# modified versions of OpenSSL that use the same license as OpenSSL), +# and distribute linked combinations including the two. +# +# You must obey the GNU Lesser General Public License in all respects for +# all of the code used other than OpenSSL. +# +# psycopg2 is distributed in the hope that it will be useful, but WITHOUT +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public +# License for more details. + +import string + +from psycopg2 import extensions as ext + + +_formatter = string.Formatter() + + +class Composable: + """ + Abstract base class for objects that can be used to compose an SQL string. + + `!Composable` objects can be passed directly to `~cursor.execute()`, + `~cursor.executemany()`, `~cursor.copy_expert()` in place of the query + string. + + `!Composable` objects can be joined using the ``+`` operator: the result + will be a `Composed` instance containing the objects joined. The operator + ``*`` is also supported with an integer argument: the result is a + `!Composed` instance containing the left argument repeated as many times as + requested. + """ + def __init__(self, wrapped): + self._wrapped = wrapped + + def __repr__(self): + return f"{self.__class__.__name__}({self._wrapped!r})" + + def as_string(self, context): + """ + Return the string value of the object. + + :param context: the context to evaluate the string into. + :type context: `connection` or `cursor` + + The method is automatically invoked by `~cursor.execute()`, + `~cursor.executemany()`, `~cursor.copy_expert()` if a `!Composable` is + passed instead of the query string. + """ + raise NotImplementedError + + def __add__(self, other): + if isinstance(other, Composed): + return Composed([self]) + other + if isinstance(other, Composable): + return Composed([self]) + Composed([other]) + else: + return NotImplemented + + def __mul__(self, n): + return Composed([self] * n) + + def __eq__(self, other): + return type(self) is type(other) and self._wrapped == other._wrapped + + def __ne__(self, other): + return not self.__eq__(other) + + +class Composed(Composable): + """ + A `Composable` object made of a sequence of `!Composable`. + + The object is usually created using `!Composable` operators and methods. + However it is possible to create a `!Composed` directly specifying a + sequence of `!Composable` as arguments. + + Example:: + + >>> comp = sql.Composed( + ... [sql.SQL("insert into "), sql.Identifier("table")]) + >>> print(comp.as_string(conn)) + insert into "table" + + `!Composed` objects are iterable (so they can be used in `SQL.join` for + instance). + """ + def __init__(self, seq): + wrapped = [] + for i in seq: + if not isinstance(i, Composable): + raise TypeError( + f"Composed elements must be Composable, got {i!r} instead") + wrapped.append(i) + + super().__init__(wrapped) + + @property + def seq(self): + """The list of the content of the `!Composed`.""" + return list(self._wrapped) + + def as_string(self, context): + rv = [] + for i in self._wrapped: + rv.append(i.as_string(context)) + return ''.join(rv) + + def __iter__(self): + return iter(self._wrapped) + + def __add__(self, other): + if isinstance(other, Composed): + return Composed(self._wrapped + other._wrapped) + if isinstance(other, Composable): + return Composed(self._wrapped + [other]) + else: + return NotImplemented + + def join(self, joiner): + """ + Return a new `!Composed` interposing the *joiner* with the `!Composed` items. + + The *joiner* must be a `SQL` or a string which will be interpreted as + an `SQL`. + + Example:: + + >>> fields = sql.Identifier('foo') + sql.Identifier('bar') # a Composed + >>> print(fields.join(', ').as_string(conn)) + "foo", "bar" + + """ + if isinstance(joiner, str): + joiner = SQL(joiner) + elif not isinstance(joiner, SQL): + raise TypeError( + "Composed.join() argument must be a string or an SQL") + + return joiner.join(self) + + +class SQL(Composable): + """ + A `Composable` representing a snippet of SQL statement. + + `!SQL` exposes `join()` and `format()` methods useful to create a template + where to merge variable parts of a query (for instance field or table + names). + + The *string* doesn't undergo any form of escaping, so it is not suitable to + represent variable identifiers or values: you should only use it to pass + constant strings representing templates or snippets of SQL statements; use + other objects such as `Identifier` or `Literal` to represent variable + parts. + + Example:: + + >>> query = sql.SQL("select {0} from {1}").format( + ... sql.SQL(', ').join([sql.Identifier('foo'), sql.Identifier('bar')]), + ... sql.Identifier('table')) + >>> print(query.as_string(conn)) + select "foo", "bar" from "table" + """ + def __init__(self, string): + if not isinstance(string, str): + raise TypeError("SQL values must be strings") + super().__init__(string) + + @property + def string(self): + """The string wrapped by the `!SQL` object.""" + return self._wrapped + + def as_string(self, context): + return self._wrapped + + def format(self, *args, **kwargs): + """ + Merge `Composable` objects into a template. + + :param `Composable` args: parameters to replace to numbered + (``{0}``, ``{1}``) or auto-numbered (``{}``) placeholders + :param `Composable` kwargs: parameters to replace to named (``{name}``) + placeholders + :return: the union of the `!SQL` string with placeholders replaced + :rtype: `Composed` + + The method is similar to the Python `str.format()` method: the string + template supports auto-numbered (``{}``), numbered (``{0}``, + ``{1}``...), and named placeholders (``{name}``), with positional + arguments replacing the numbered placeholders and keywords replacing + the named ones. However placeholder modifiers (``{0!r}``, ``{0:<10}``) + are not supported. Only `!Composable` objects can be passed to the + template. + + Example:: + + >>> print(sql.SQL("select * from {} where {} = %s") + ... .format(sql.Identifier('people'), sql.Identifier('id')) + ... .as_string(conn)) + select * from "people" where "id" = %s + + >>> print(sql.SQL("select * from {tbl} where {pkey} = %s") + ... .format(tbl=sql.Identifier('people'), pkey=sql.Identifier('id')) + ... .as_string(conn)) + select * from "people" where "id" = %s + + """ + rv = [] + autonum = 0 + for pre, name, spec, conv in _formatter.parse(self._wrapped): + if spec: + raise ValueError("no format specification supported by SQL") + if conv: + raise ValueError("no format conversion supported by SQL") + if pre: + rv.append(SQL(pre)) + + if name is None: + continue + + if name.isdigit(): + if autonum: + raise ValueError( + "cannot switch from automatic field numbering to manual") + rv.append(args[int(name)]) + autonum = None + + elif not name: + if autonum is None: + raise ValueError( + "cannot switch from manual field numbering to automatic") + rv.append(args[autonum]) + autonum += 1 + + else: + rv.append(kwargs[name]) + + return Composed(rv) + + def join(self, seq): + """ + Join a sequence of `Composable`. + + :param seq: the elements to join. + :type seq: iterable of `!Composable` + + Use the `!SQL` object's *string* to separate the elements in *seq*. + Note that `Composed` objects are iterable too, so they can be used as + argument for this method. + + Example:: + + >>> snip = sql.SQL(', ').join( + ... sql.Identifier(n) for n in ['foo', 'bar', 'baz']) + >>> print(snip.as_string(conn)) + "foo", "bar", "baz" + """ + rv = [] + it = iter(seq) + try: + rv.append(next(it)) + except StopIteration: + pass + else: + for i in it: + rv.append(self) + rv.append(i) + + return Composed(rv) + + +class Identifier(Composable): + """ + A `Composable` representing an SQL identifier or a dot-separated sequence. + + Identifiers usually represent names of database objects, such as tables or + fields. PostgreSQL identifiers follow `different rules`__ than SQL string + literals for escaping (e.g. they use double quotes instead of single). + + .. __: https://www.postgresql.org/docs/current/static/sql-syntax-lexical.html# \ + SQL-SYNTAX-IDENTIFIERS + + Example:: + + >>> t1 = sql.Identifier("foo") + >>> t2 = sql.Identifier("ba'r") + >>> t3 = sql.Identifier('ba"z') + >>> print(sql.SQL(', ').join([t1, t2, t3]).as_string(conn)) + "foo", "ba'r", "ba""z" + + Multiple strings can be passed to the object to represent a qualified name, + i.e. a dot-separated sequence of identifiers. + + Example:: + + >>> query = sql.SQL("select {} from {}").format( + ... sql.Identifier("table", "field"), + ... sql.Identifier("schema", "table")) + >>> print(query.as_string(conn)) + select "table"."field" from "schema"."table" + + """ + def __init__(self, *strings): + if not strings: + raise TypeError("Identifier cannot be empty") + + for s in strings: + if not isinstance(s, str): + raise TypeError("SQL identifier parts must be strings") + + super().__init__(strings) + + @property + def strings(self): + """A tuple with the strings wrapped by the `Identifier`.""" + return self._wrapped + + @property + def string(self): + """The string wrapped by the `Identifier`. + """ + if len(self._wrapped) == 1: + return self._wrapped[0] + else: + raise AttributeError( + "the Identifier wraps more than one than one string") + + def __repr__(self): + return f"{self.__class__.__name__}({', '.join(map(repr, self._wrapped))})" + + def as_string(self, context): + return '.'.join(ext.quote_ident(s, context) for s in self._wrapped) + + +class Literal(Composable): + """ + A `Composable` representing an SQL value to include in a query. + + Usually you will want to include placeholders in the query and pass values + as `~cursor.execute()` arguments. If however you really really need to + include a literal value in the query you can use this object. + + The string returned by `!as_string()` follows the normal :ref:`adaptation + rules ` for Python objects. + + Example:: + + >>> s1 = sql.Literal("foo") + >>> s2 = sql.Literal("ba'r") + >>> s3 = sql.Literal(42) + >>> print(sql.SQL(', ').join([s1, s2, s3]).as_string(conn)) + 'foo', 'ba''r', 42 + + """ + @property + def wrapped(self): + """The object wrapped by the `!Literal`.""" + return self._wrapped + + def as_string(self, context): + # is it a connection or cursor? + if isinstance(context, ext.connection): + conn = context + elif isinstance(context, ext.cursor): + conn = context.connection + else: + raise TypeError("context must be a connection or a cursor") + + a = ext.adapt(self._wrapped) + if hasattr(a, 'prepare'): + a.prepare(conn) + + rv = a.getquoted() + if isinstance(rv, bytes): + rv = rv.decode(ext.encodings[conn.encoding]) + + return rv + + +class Placeholder(Composable): + """A `Composable` representing a placeholder for query parameters. + + If the name is specified, generate a named placeholder (e.g. ``%(name)s``), + otherwise generate a positional placeholder (e.g. ``%s``). + + The object is useful to generate SQL queries with a variable number of + arguments. + + Examples:: + + >>> names = ['foo', 'bar', 'baz'] + + >>> q1 = sql.SQL("insert into table ({}) values ({})").format( + ... sql.SQL(', ').join(map(sql.Identifier, names)), + ... sql.SQL(', ').join(sql.Placeholder() * len(names))) + >>> print(q1.as_string(conn)) + insert into table ("foo", "bar", "baz") values (%s, %s, %s) + + >>> q2 = sql.SQL("insert into table ({}) values ({})").format( + ... sql.SQL(', ').join(map(sql.Identifier, names)), + ... sql.SQL(', ').join(map(sql.Placeholder, names))) + >>> print(q2.as_string(conn)) + insert into table ("foo", "bar", "baz") values (%(foo)s, %(bar)s, %(baz)s) + + """ + + def __init__(self, name=None): + if isinstance(name, str): + if ')' in name: + raise ValueError(f"invalid name: {name!r}") + + elif name is not None: + raise TypeError(f"expected string or None as name, got {name!r}") + + super().__init__(name) + + @property + def name(self): + """The name of the `!Placeholder`.""" + return self._wrapped + + def __repr__(self): + if self._wrapped is None: + return f"{self.__class__.__name__}()" + else: + return f"{self.__class__.__name__}({self._wrapped!r})" + + def as_string(self, context): + if self._wrapped is not None: + return f"%({self._wrapped})s" + else: + return "%s" + + +# Literals +NULL = SQL("NULL") +DEFAULT = SQL("DEFAULT") diff --git a/env/Lib/site-packages/psycopg2/tz.py b/env/Lib/site-packages/psycopg2/tz.py new file mode 100644 index 0000000..d88ca37 --- /dev/null +++ b/env/Lib/site-packages/psycopg2/tz.py @@ -0,0 +1,158 @@ +"""tzinfo implementations for psycopg2 + +This module holds two different tzinfo implementations that can be used as +the 'tzinfo' argument to datetime constructors, directly passed to psycopg +functions or used to set the .tzinfo_factory attribute in cursors. +""" +# psycopg/tz.py - tzinfo implementation +# +# Copyright (C) 2003-2019 Federico Di Gregorio +# Copyright (C) 2020-2021 The Psycopg Team +# +# psycopg2 is free software: you can redistribute it and/or modify it +# under the terms of the GNU Lesser General Public License as published +# by the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# In addition, as a special exception, the copyright holders give +# permission to link this program with the OpenSSL library (or with +# modified versions of OpenSSL that use the same license as OpenSSL), +# and distribute linked combinations including the two. +# +# You must obey the GNU Lesser General Public License in all respects for +# all of the code used other than OpenSSL. +# +# psycopg2 is distributed in the hope that it will be useful, but WITHOUT +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public +# License for more details. + +import datetime +import time + +ZERO = datetime.timedelta(0) + + +class FixedOffsetTimezone(datetime.tzinfo): + """Fixed offset in minutes east from UTC. + + This is exactly the implementation__ found in Python 2.3.x documentation, + with a small change to the `!__init__()` method to allow for pickling + and a default name in the form ``sHH:MM`` (``s`` is the sign.). + + The implementation also caches instances. During creation, if a + FixedOffsetTimezone instance has previously been created with the same + offset and name that instance will be returned. This saves memory and + improves comparability. + + .. versionchanged:: 2.9 + + The constructor can take either a timedelta or a number of minutes of + offset. Previously only minutes were supported. + + .. __: https://docs.python.org/library/datetime.html + """ + _name = None + _offset = ZERO + + _cache = {} + + def __init__(self, offset=None, name=None): + if offset is not None: + if not isinstance(offset, datetime.timedelta): + offset = datetime.timedelta(minutes=offset) + self._offset = offset + if name is not None: + self._name = name + + def __new__(cls, offset=None, name=None): + """Return a suitable instance created earlier if it exists + """ + key = (offset, name) + try: + return cls._cache[key] + except KeyError: + tz = super().__new__(cls, offset, name) + cls._cache[key] = tz + return tz + + def __repr__(self): + return "psycopg2.tz.FixedOffsetTimezone(offset=%r, name=%r)" \ + % (self._offset, self._name) + + def __eq__(self, other): + if isinstance(other, FixedOffsetTimezone): + return self._offset == other._offset + else: + return NotImplemented + + def __ne__(self, other): + if isinstance(other, FixedOffsetTimezone): + return self._offset != other._offset + else: + return NotImplemented + + def __getinitargs__(self): + return self._offset, self._name + + def utcoffset(self, dt): + return self._offset + + def tzname(self, dt): + if self._name is not None: + return self._name + + minutes, seconds = divmod(self._offset.total_seconds(), 60) + hours, minutes = divmod(minutes, 60) + rv = "%+03d" % hours + if minutes or seconds: + rv += ":%02d" % minutes + if seconds: + rv += ":%02d" % seconds + + return rv + + def dst(self, dt): + return ZERO + + +STDOFFSET = datetime.timedelta(seconds=-time.timezone) +if time.daylight: + DSTOFFSET = datetime.timedelta(seconds=-time.altzone) +else: + DSTOFFSET = STDOFFSET +DSTDIFF = DSTOFFSET - STDOFFSET + + +class LocalTimezone(datetime.tzinfo): + """Platform idea of local timezone. + + This is the exact implementation from the Python 2.3 documentation. + """ + def utcoffset(self, dt): + if self._isdst(dt): + return DSTOFFSET + else: + return STDOFFSET + + def dst(self, dt): + if self._isdst(dt): + return DSTDIFF + else: + return ZERO + + def tzname(self, dt): + return time.tzname[self._isdst(dt)] + + def _isdst(self, dt): + tt = (dt.year, dt.month, dt.day, + dt.hour, dt.minute, dt.second, + dt.weekday(), 0, -1) + stamp = time.mktime(tt) + tt = time.localtime(stamp) + return tt.tm_isdst > 0 + + +LOCAL = LocalTimezone() + +# TODO: pre-generate some interesting time zones? diff --git a/env/Lib/site-packages/pydantic-2.8.2.dist-info/INSTALLER b/env/Lib/site-packages/pydantic-2.8.2.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/Lib/site-packages/pydantic-2.8.2.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/Lib/site-packages/pydantic-2.8.2.dist-info/METADATA b/env/Lib/site-packages/pydantic-2.8.2.dist-info/METADATA new file mode 100644 index 0000000..dc57ef4 --- /dev/null +++ b/env/Lib/site-packages/pydantic-2.8.2.dist-info/METADATA @@ -0,0 +1,1271 @@ +Metadata-Version: 2.3 +Name: pydantic +Version: 2.8.2 +Summary: Data validation using Python type hints +Project-URL: Homepage, https://github.com/pydantic/pydantic +Project-URL: Documentation, https://docs.pydantic.dev +Project-URL: Funding, https://github.com/sponsors/samuelcolvin +Project-URL: Source, https://github.com/pydantic/pydantic +Project-URL: Changelog, https://docs.pydantic.dev/latest/changelog/ +Author-email: Samuel Colvin , Eric Jolibois , Hasan Ramezani , Adrian Garcia Badaracco <1755071+adriangb@users.noreply.github.com>, Terrence Dorsey , David Montague , Serge Matveenko , Marcelo Trylesinski , Sydney Runkle , David Hewitt , Alex Hall +License-Expression: MIT +License-File: LICENSE +Classifier: Development Status :: 5 - Production/Stable +Classifier: Environment :: Console +Classifier: Environment :: MacOS X +Classifier: Framework :: Hypothesis +Classifier: Framework :: Pydantic +Classifier: Intended Audience :: Developers +Classifier: Intended Audience :: Information Technology +Classifier: Intended Audience :: System Administrators +Classifier: License :: OSI Approved :: MIT License +Classifier: Operating System :: POSIX :: Linux +Classifier: Operating System :: Unix +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3.13 +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy +Classifier: Topic :: Internet +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Requires-Python: >=3.8 +Requires-Dist: annotated-types>=0.4.0 +Requires-Dist: pydantic-core==2.20.1 +Requires-Dist: typing-extensions>=4.12.2; python_version >= '3.13' +Requires-Dist: typing-extensions>=4.6.1; python_version < '3.13' +Provides-Extra: email +Requires-Dist: email-validator>=2.0.0; extra == 'email' +Description-Content-Type: text/markdown + +# Pydantic +[![CI](https://img.shields.io/github/actions/workflow/status/pydantic/pydantic/ci.yml?branch=main&logo=github&label=CI)](https://github.com/pydantic/pydantic/actions?query=event%3Apush+branch%3Amain+workflow%3ACI) +[![Coverage](https://coverage-badge.samuelcolvin.workers.dev/pydantic/pydantic.svg)](https://coverage-badge.samuelcolvin.workers.dev/redirect/pydantic/pydantic) +[![pypi](https://img.shields.io/pypi/v/pydantic.svg)](https://pypi.python.org/pypi/pydantic) +[![CondaForge](https://img.shields.io/conda/v/conda-forge/pydantic.svg)](https://anaconda.org/conda-forge/pydantic) +[![downloads](https://static.pepy.tech/badge/pydantic/month)](https://pepy.tech/project/pydantic) +[![versions](https://img.shields.io/pypi/pyversions/pydantic.svg)](https://github.com/pydantic/pydantic) +[![license](https://img.shields.io/github/license/pydantic/pydantic.svg)](https://github.com/pydantic/pydantic/blob/main/LICENSE) +[![Pydantic v2](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/pydantic/pydantic/main/docs/badge/v2.json)](https://docs.pydantic.dev/latest/contributing/#badges) + +Data validation using Python type hints. + +Fast and extensible, Pydantic plays nicely with your linters/IDE/brain. +Define how data should be in pure, canonical Python 3.8+; validate it with Pydantic. + +## Pydantic Company :rocket: + +We've started a company based on the principles that I believe have led to Pydantic's success. +Learn more from the [Company Announcement](https://blog.pydantic.dev/blog/2023/02/16/company-announcement--pydantic/). + +## Pydantic V1.10 vs. V2 + +Pydantic V2 is a ground-up rewrite that offers many new features, performance improvements, and some breaking changes compared to Pydantic V1. + +If you're using Pydantic V1 you may want to look at the +[pydantic V1.10 Documentation](https://docs.pydantic.dev/) or, +[`1.10.X-fixes` git branch](https://github.com/pydantic/pydantic/tree/1.10.X-fixes). Pydantic V2 also ships with the latest version of Pydantic V1 built in so that you can incrementally upgrade your code base and projects: `from pydantic import v1 as pydantic_v1`. + +## Help + +See [documentation](https://docs.pydantic.dev/) for more details. + +## Installation + +Install using `pip install -U pydantic` or `conda install pydantic -c conda-forge`. +For more installation options to make Pydantic even faster, +see the [Install](https://docs.pydantic.dev/install/) section in the documentation. + +## A Simple Example + +```py +from datetime import datetime +from typing import List, Optional +from pydantic import BaseModel + +class User(BaseModel): + id: int + name: str = 'John Doe' + signup_ts: Optional[datetime] = None + friends: List[int] = [] + +external_data = {'id': '123', 'signup_ts': '2017-06-01 12:22', 'friends': [1, '2', b'3']} +user = User(**external_data) +print(user) +#> User id=123 name='John Doe' signup_ts=datetime.datetime(2017, 6, 1, 12, 22) friends=[1, 2, 3] +print(user.id) +#> 123 +``` + +## Contributing + +For guidance on setting up a development environment and how to make a +contribution to Pydantic, see +[Contributing to Pydantic](https://docs.pydantic.dev/contributing/). + +## Reporting a Security Vulnerability + +See our [security policy](https://github.com/pydantic/pydantic/security/policy). + +## Changelog + +## v2.8.2 (2024-07-03) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.8.2) + +### What's Changed + +#### Fixes + +* Fix issue with assertion caused by pluggable schema validator by [@dmontagu](https://github.com/dmontagu) in [#9838](https://github.com/pydantic/pydantic/pull/9838) + +## v2.8.1 (2024-07-03) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.8.1) + +### What's Changed + +#### Packaging +* Bump `ruff` to `v0.5.0` and `pyright` to `v1.1.369` by [@sydney-runkle](https://github.com/sydney-runkle) in [#9801](https://github.com/pydantic/pydantic/pull/9801) +* Bump `pydantic-core` to `v2.20.1`, `pydantic-extra-types` to `v2.9.0` by [@sydney-runkle](https://github.com/sydney-runkle) in [#9832](https://github.com/pydantic/pydantic/pull/9832) + +#### Fixes +* Fix breaking change in `to_snake` from v2.7 -> v2.8 by [@sydney-runkle](https://github.com/sydney-runkle) in [#9812](https://github.com/pydantic/pydantic/pull/9812) +* Fix list constraint json schema application by [@sydney-runkle](https://github.com/sydney-runkle) in [#9818](https://github.com/pydantic/pydantic/pull/9818) +* Support time duration more than 23 by [@nix010](https://github.com/nix010) in [pydantic/speedate#64](https://github.com/pydantic/speedate/pull/64) +* Fix millisecond fraction being handled with the wrong scale by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/speedate#65](https://github.com/pydantic/speedate/pull/65) +* Handle negative fractional durations correctly by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/speedate#71](https://github.com/pydantic/speedate/pull/71) + +## v2.8.0 (2024-07-01) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.8.0) + +The code released in v2.8.0 is functionally identical to that of v2.8.0b1. + +### What's Changed + +#### Packaging + +* Update citation version automatically with new releases by [@sydney-runkle](https://github.com/sydney-runkle) in [#9673](https://github.com/pydantic/pydantic/pull/9673) +* Bump pyright to `v1.1.367` and add type checking tests for pipeline API by [@adriangb](https://github.com/adriangb) in [#9674](https://github.com/pydantic/pydantic/pull/9674) +* Update `pydantic.v1` stub to `v1.10.17` by [@sydney-runkle](https://github.com/sydney-runkle) in [#9707](https://github.com/pydantic/pydantic/pull/9707) +* General package updates to prep for `v2.8.0b1` by [@sydney-runkle](https://github.com/sydney-runkle) in [#9741](https://github.com/pydantic/pydantic/pull/9741) +* Bump `pydantic-core` to `v2.20.0` by [@sydney-runkle](https://github.com/sydney-runkle) in [#9745](https://github.com/pydantic/pydantic/pull/9745) +* Add support for Python 3.13 by [@sydney-runkle](https://github.com/sydney-runkle) in [#9743](https://github.com/pydantic/pydantic/pull/9743) +* Update `pdm` version used for `pdm.lock` to v2.16.1 by [@sydney-runkle](https://github.com/sydney-runkle) in [#9761](https://github.com/pydantic/pydantic/pull/9761) +* Update to `ruff` `v0.4.8` by [@Viicos](https://github.com/Viicos) in [#9585](https://github.com/pydantic/pydantic/pull/9585) + +#### New Features + +* Experimental: support `defer_build` for `TypeAdapter` by [@MarkusSintonen](https://github.com/MarkusSintonen) in [#8939](https://github.com/pydantic/pydantic/pull/8939) +* Implement `deprecated` field in json schema by [@NeevCohen](https://github.com/NeevCohen) in [#9298](https://github.com/pydantic/pydantic/pull/9298) +* Experimental: Add pipeline API by [@adriangb](https://github.com/adriangb) in [#9459](https://github.com/pydantic/pydantic/pull/9459) +* Add support for programmatic title generation by [@NeevCohen](https://github.com/NeevCohen) in [#9183](https://github.com/pydantic/pydantic/pull/9183) +* Implement `fail_fast` feature by [@uriyyo](https://github.com/uriyyo) in [#9708](https://github.com/pydantic/pydantic/pull/9708) +* Add `ser_json_inf_nan='strings'` mode to produce valid JSON by [@josh-newman](https://github.com/josh-newman) in [pydantic/pydantic-core#1307](https://github.com/pydantic/pydantic-core/pull/1307) + +#### Changes + +* Add warning when "alias" is set in ignored `Annotated` field by [@nix010](https://github.com/nix010) in [#9170](https://github.com/pydantic/pydantic/pull/9170) +* Support serialization of some serializable defaults in JSON schema by [@sydney-runkle](https://github.com/sydney-runkle) in [#9624](https://github.com/pydantic/pydantic/pull/9624) +* Relax type specification for `__validators__` values in `create_model` by [@sydney-runkle](https://github.com/sydney-runkle) in [#9697](https://github.com/pydantic/pydantic/pull/9697) +* **Breaking Change:** Improve `smart` union matching logic by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/pydantic-core#1322](https://github.com/pydantic/pydantic-core/pull/1322) +You can read more about our `smart` union matching logic [here](https://docs.pydantic.dev/dev/concepts/unions/#smart-mode). In some cases, if the old behavior +is desired, you can switch to `left-to-right` mode and change the order of your `Union` members. + +#### Performance + +##### Internal Improvements + +* ⚡️ Speed up `_display_error_loc()` by 25% in `pydantic/v1/error_wrappers.py` by [@misrasaurabh1](https://github.com/misrasaurabh1) in [#9653](https://github.com/pydantic/pydantic/pull/9653) +* ⚡️ Speed up `_get_all_json_refs()` by 34% in `pydantic/json_schema.py` by [@misrasaurabh1](https://github.com/misrasaurabh1) in [#9650](https://github.com/pydantic/pydantic/pull/9650) +* ⚡️ Speed up `is_pydantic_dataclass()` by 41% in `pydantic/dataclasses.py` by [@misrasaurabh1](https://github.com/misrasaurabh1) in [#9652](https://github.com/pydantic/pydantic/pull/9652) +* ⚡️ Speed up `to_snake()` by 27% in `pydantic/alias_generators.py` by [@misrasaurabh1](https://github.com/misrasaurabh1) in [#9747](https://github.com/pydantic/pydantic/pull/9747) +* ⚡️ Speed up `unwrap_wrapped_function()` by 93% in `pydantic/_internal/_decorators.py` by [@misrasaurabh1](https://github.com/misrasaurabh1) in [#9727](https://github.com/pydantic/pydantic/pull/9727) + +#### Fixes + +* Replace `__spec__.parent` with `__package__` by [@hramezani](https://github.com/hramezani) in [#9331](https://github.com/pydantic/pydantic/pull/9331) +* Fix Outputted Model JSON Schema for `Sequence` type by [@anesmemisevic](https://github.com/anesmemisevic) in [#9303](https://github.com/pydantic/pydantic/pull/9303) +* Fix typing of `_frame_depth` by [@Viicos](https://github.com/Viicos) in [#9353](https://github.com/pydantic/pydantic/pull/9353) +* Make `ImportString` json schema compatible by [@amitschang](https://github.com/amitschang) in [#9344](https://github.com/pydantic/pydantic/pull/9344) +* Hide private attributes (`PrivateAttr`) from `__init__` signature in type checkers by [@idan22moral](https://github.com/idan22moral) in [#9293](https://github.com/pydantic/pydantic/pull/9293) +* Make detection of `TypeVar` defaults robust to the CPython `PEP-696` implementation by [@AlexWaygood](https://github.com/AlexWaygood) in [#9426](https://github.com/pydantic/pydantic/pull/9426) +* Fix usage of `PlainSerializer` with builtin types by [@Viicos](https://github.com/Viicos) in [#9450](https://github.com/pydantic/pydantic/pull/9450) +* Add more robust custom validation examples by [@ChrisPappalardo](https://github.com/ChrisPappalardo) in [#9468](https://github.com/pydantic/pydantic/pull/9468) +* Fix ignored `strict` specification for `StringConstraint(strict=False)` by [@vbmendes](https://github.com/vbmendes) in [#9476](https://github.com/pydantic/pydantic/pull/9476) +* Use `Self` where possible by [@Viicos](https://github.com/Viicos) in [#9479](https://github.com/pydantic/pydantic/pull/9479) +* Do not alter `RootModel.model_construct` signature in the `mypy` plugin by [@Viicos](https://github.com/Viicos) in [#9480](https://github.com/pydantic/pydantic/pull/9480) +* Fixed type hint of `validation_context` by [@OhioDschungel6](https://github.com/OhioDschungel6) in [#9508](https://github.com/pydantic/pydantic/pull/9508) +* Support context being passed to TypeAdapter's `dump_json`/`dump_python` by [@alexcouper](https://github.com/alexcouper) in [#9495](https://github.com/pydantic/pydantic/pull/9495) +* Updates type signature for `Field()` constructor by [@bjmc](https://github.com/bjmc) in [#9484](https://github.com/pydantic/pydantic/pull/9484) +* Improve builtin alias generators by [@sydney-runkle](https://github.com/sydney-runkle) in [#9561](https://github.com/pydantic/pydantic/pull/9561) +* Fix typing of `TypeAdapter` by [@Viicos](https://github.com/Viicos) in [#9570](https://github.com/pydantic/pydantic/pull/9570) +* Add fallback default value for private fields in `__setstate__` of BaseModel by [@anhpham1509](https://github.com/anhpham1509) in [#9584](https://github.com/pydantic/pydantic/pull/9584) +* Support `PEP 746` by [@adriangb](https://github.com/adriangb) in [#9587](https://github.com/pydantic/pydantic/pull/9587) +* Allow validator and serializer functions to have default values by [@Viicos](https://github.com/Viicos) in [#9478](https://github.com/pydantic/pydantic/pull/9478) +* Fix bug with mypy plugin's handling of covariant `TypeVar` fields by [@dmontagu](https://github.com/dmontagu) in [#9606](https://github.com/pydantic/pydantic/pull/9606) +* Fix multiple annotation / constraint application logic by [@sydney-runkle](https://github.com/sydney-runkle) in [#9623](https://github.com/pydantic/pydantic/pull/9623) +* Respect `regex` flags in validation and json schema by [@sydney-runkle](https://github.com/sydney-runkle) in [#9591](https://github.com/pydantic/pydantic/pull/9591) +* Fix type hint on `IpvAnyAddress` by [@sydney-runkle](https://github.com/sydney-runkle) in [#9640](https://github.com/pydantic/pydantic/pull/9640) +* Allow a field specifier on `__pydantic_extra__` by [@dmontagu](https://github.com/dmontagu) in [#9659](https://github.com/pydantic/pydantic/pull/9659) +* Use normalized case for file path comparison by [@sydney-runkle](https://github.com/sydney-runkle) in [#9737](https://github.com/pydantic/pydantic/pull/9737) +* Modify constraint application logic to allow field constraints on `Optional[Decimal]` by [@lazyhope](https://github.com/lazyhope) in [#9754](https://github.com/pydantic/pydantic/pull/9754) +* `validate_call` type params fix by [@sydney-runkle](https://github.com/sydney-runkle) in [#9760](https://github.com/pydantic/pydantic/pull/9760) +* Check all warnings returned by pytest.warns() by [@s-t-e-v-e-n-k](https://github.com/s-t-e-v-e-n-k) in [#9702](https://github.com/pydantic/pydantic/pull/9702) +* Reuse `re.Pattern` object in regex patterns to allow for regex flags by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/pydantic-core#1318](https://github.com/pydantic/pydantic-core/pull/1318) + +### New Contributors + +* [@idan22moral](https://github.com/idan22moral) made their first contribution in [#9294](https://github.com/pydantic/pydantic/pull/9294) +* [@anesmemisevic](https://github.com/anesmemisevic) made their first contribution in [#9303](https://github.com/pydantic/pydantic/pull/9303) +* [@max-muoto](https://github.com/max-muoto) made their first contribution in [#9338](https://github.com/pydantic/pydantic/pull/9338) +* [@amitschang](https://github.com/amitschang) made their first contribution in [#9344](https://github.com/pydantic/pydantic/pull/9344) +* [@paulmartin91](https://github.com/paulmartin91) made their first contribution in [#9410](https://github.com/pydantic/pydantic/pull/9410) +* [@OhioDschungel6](https://github.com/OhioDschungel6) made their first contribution in [#9405](https://github.com/pydantic/pydantic/pull/9405) +* [@AlexWaygood](https://github.com/AlexWaygood) made their first contribution in [#9426](https://github.com/pydantic/pydantic/pull/9426) +* [@kinuax](https://github.com/kinuax) made their first contribution in [#9433](https://github.com/pydantic/pydantic/pull/9433) +* [@antoni-jamiolkowski](https://github.com/antoni-jamiolkowski) made their first contribution in [#9431](https://github.com/pydantic/pydantic/pull/9431) +* [@candleindark](https://github.com/candleindark) made their first contribution in [#9448](https://github.com/pydantic/pydantic/pull/9448) +* [@nix010](https://github.com/nix010) made their first contribution in [#9170](https://github.com/pydantic/pydantic/pull/9170) +* [@tomy0000000](https://github.com/tomy0000000) made their first contribution in [#9457](https://github.com/pydantic/pydantic/pull/9457) +* [@vbmendes](https://github.com/vbmendes) made their first contribution in [#9470](https://github.com/pydantic/pydantic/pull/9470) +* [@micheleAlberto](https://github.com/micheleAlberto) made their first contribution in [#9471](https://github.com/pydantic/pydantic/pull/9471) +* [@ChrisPappalardo](https://github.com/ChrisPappalardo) made their first contribution in [#9468](https://github.com/pydantic/pydantic/pull/9468) +* [@blueTurtz](https://github.com/blueTurtz) made their first contribution in [#9475](https://github.com/pydantic/pydantic/pull/9475) +* [@WinterBlue16](https://github.com/WinterBlue16) made their first contribution in [#9477](https://github.com/pydantic/pydantic/pull/9477) +* [@bittner](https://github.com/bittner) made their first contribution in [#9500](https://github.com/pydantic/pydantic/pull/9500) +* [@alexcouper](https://github.com/alexcouper) made their first contribution in [#9495](https://github.com/pydantic/pydantic/pull/9495) +* [@bjmc](https://github.com/bjmc) made their first contribution in [#9484](https://github.com/pydantic/pydantic/pull/9484) +* [@pjvv](https://github.com/pjvv) made their first contribution in [#9529](https://github.com/pydantic/pydantic/pull/9529) +* [@nedbat](https://github.com/nedbat) made their first contribution in [#9530](https://github.com/pydantic/pydantic/pull/9530) +* [@gunnellEvan](https://github.com/gunnellEvan) made their first contribution in [#9469](https://github.com/pydantic/pydantic/pull/9469) +* [@jaymbans](https://github.com/jaymbans) made their first contribution in [#9531](https://github.com/pydantic/pydantic/pull/9531) +* [@MarcBresson](https://github.com/MarcBresson) made their first contribution in [#9534](https://github.com/pydantic/pydantic/pull/9534) +* [@anhpham1509](https://github.com/anhpham1509) made their first contribution in [#9584](https://github.com/pydantic/pydantic/pull/9584) +* [@K-dash](https://github.com/K-dash) made their first contribution in [#9595](https://github.com/pydantic/pydantic/pull/9595) +* [@s-t-e-v-e-n-k](https://github.com/s-t-e-v-e-n-k) made their first contribution in [#9527](https://github.com/pydantic/pydantic/pull/9527) +* [@airwoodix](https://github.com/airwoodix) made their first contribution in [#9506](https://github.com/pydantic/pydantic/pull/9506) +* [@misrasaurabh1](https://github.com/misrasaurabh1) made their first contribution in [#9653](https://github.com/pydantic/pydantic/pull/9653) +* [@AlessandroMiola](https://github.com/AlessandroMiola) made their first contribution in [#9740](https://github.com/pydantic/pydantic/pull/9740) +* [@mylapallilavanyaa](https://github.com/mylapallilavanyaa) made their first contribution in [#9746](https://github.com/pydantic/pydantic/pull/9746) +* [@lazyhope](https://github.com/lazyhope) made their first contribution in [#9754](https://github.com/pydantic/pydantic/pull/9754) +* [@YassinNouh21](https://github.com/YassinNouh21) made their first contribution in [#9759](https://github.com/pydantic/pydantic/pull/9759) + +## v2.8.0b1 (2024-06-27) + +Pre-release, see [the GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.8.0b1) for details. + +## v2.7.4 (2024-06-12) + +[Github release](https://github.com/pydantic/pydantic/releases/tag/v2.7.4) + +### What's Changed + +#### Packaging + +* Bump `pydantic.v1` to `v1.10.16` reference by [@sydney-runkle](https://github.com/sydney-runkle) in [#9639](https://github.com/pydantic/pydantic/pull/9639) + +#### Fixes + +* Specify `recursive_guard` as kwarg in `FutureRef._evaluate` by [@vfazio](https://github.com/vfazio) in [#9612](https://github.com/pydantic/pydantic/pull/9612) + +## v2.7.3 (2024-06-03) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.7.3) + +### What's Changed + +#### Packaging + +* Bump `pydantic-core` to `v2.18.4` by [@sydney-runkle](https://github.com/sydney-runkle) in [#9550](https://github.com/pydantic/pydantic/pull/9550) + +#### Fixes + +* Fix u style unicode strings in python [@samuelcolvin](https://github.com/samuelcolvin) in [pydantic/jiter#110](https://github.com/pydantic/jiter/pull/110) + +## v2.7.2 (2024-05-28) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.7.2) + +### What's Changed + +#### Packaging + +* Bump `pydantic-core` to `v2.18.3` by [@sydney-runkle](https://github.com/sydney-runkle) in [#9515](https://github.com/pydantic/pydantic/pull/9515) + +#### Fixes + +* Replace `__spec__.parent` with `__package__` by [@hramezani](https://github.com/hramezani) in [#9331](https://github.com/pydantic/pydantic/pull/9331) +* Fix validation of `int`s with leading unary minus by [@RajatRajdeep](https://github.com/RajatRajdeep) in [pydantic/pydantic-core#1291](https://github.com/pydantic/pydantic-core/pull/1291) +* Fix `str` subclass validation for enums by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/pydantic-core#1273](https://github.com/pydantic/pydantic-core/pull/1273) +* Support `BigInt`s in `Literal`s and `Enum`s by [@samuelcolvin](https://github.com/samuelcolvin) in [pydantic/pydantic-core#1297](https://github.com/pydantic/pydantic-core/pull/1297) +* Fix: uuid - allow `str` subclass as input by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/pydantic-core#1296](https://github.com/pydantic/pydantic-core/pull/1296) + +## v2.7.1 (2024-04-23) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.7.1) + +### What's Changed + +#### Packaging + +* Bump `pydantic-core` to `v2.18.2` by [@sydney-runkle](https://github.com/sydney-runkle) in [#9307](https://github.com/pydantic/pydantic/pull/9307) + +#### New Features + +* Ftp and Websocket connection strings support by [@CherrySuryp](https://github.com/CherrySuryp) in [#9205](https://github.com/pydantic/pydantic/pull/9205) + +#### Changes + +* Use field description for RootModel schema description when there is `…` by [@LouisGobert](https://github.com/LouisGobert) in [#9214](https://github.com/pydantic/pydantic/pull/9214) + +#### Fixes + +* Fix `validation_alias` behavior with `model_construct` for `AliasChoices` and `AliasPath` by [@sydney-runkle](https://github.com/sydney-runkle) in [#9223](https://github.com/pydantic/pydantic/pull/9223) +* Revert `typing.Literal` and import it outside the TYPE_CHECKING block by [@frost-nzcr4](https://github.com/frost-nzcr4) in [#9232](https://github.com/pydantic/pydantic/pull/9232) +* Fix `Secret` serialization schema, applicable for unions by [@sydney-runkle](https://github.com/sydney-runkle) in [#9240](https://github.com/pydantic/pydantic/pull/9240) +* Fix `strict` application to `function-after` with `use_enum_values` by [@sydney-runkle](https://github.com/sydney-runkle) in [#9279](https://github.com/pydantic/pydantic/pull/9279) +* Address case where `model_construct` on a class which defines `model_post_init` fails with `AttributeError` by [@babygrimes](https://github.com/babygrimes) in [#9168](https://github.com/pydantic/pydantic/pull/9168) +* Fix `model_json_schema` with config types by [@NeevCohen](https://github.com/NeevCohen) in [#9287](https://github.com/pydantic/pydantic/pull/9287) +* Support multiple zeros as an `int` by [@samuelcolvin](https://github.com/samuelcolvin) in [pydantic/pydantic-core#1269](https://github.com/pydantic/pydantic-core/pull/1269) +* Fix validation of `int`s with leading unary plus by [@cknv](https://github.com/cknv) in [pydantic/pydantic-core#1272](https://github.com/pydantic/pydantic-core/pull/1272) +* Fix interaction between `extra != 'ignore'` and `from_attributes=True` by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/pydantic-core#1276](https://github.com/pydantic/pydantic-core/pull/1276) +* Handle error from `Enum`'s `missing` function as `ValidationError` by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/pydantic-core#1274](https://github.com/pydantic/pydantic-core/pull/1754) +* Fix memory leak with `Iterable` validation by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/pydantic-core#1271](https://github.com/pydantic/pydantic-core/pull/1751) + +### New Contributors + +* [@zzstoatzz](https://github.com/zzstoatzz) made their first contribution in [#9219](https://github.com/pydantic/pydantic/pull/9219) +* [@frost-nzcr4](https://github.com/frost-nzcr4) made their first contribution in [#9232](https://github.com/pydantic/pydantic/pull/9232) +* [@CherrySuryp](https://github.com/CherrySuryp) made their first contribution in [#9205](https://github.com/pydantic/pydantic/pull/9205) +* [@vagenas](https://github.com/vagenas) made their first contribution in [#9268](https://github.com/pydantic/pydantic/pull/9268) +* [@ollz272](https://github.com/ollz272) made their first contribution in [#9262](https://github.com/pydantic/pydantic/pull/9262) +* [@babygrimes](https://github.com/babygrimes) made their first contribution in [#9168](https://github.com/pydantic/pydantic/pull/9168) +* [@swelborn](https://github.com/swelborn) made their first contribution in [#9296](https://github.com/pydantic/pydantic/pull/9296) +* [@kf-novi](https://github.com/kf-novi) made their first contribution in [#9236](https://github.com/pydantic/pydantic/pull/9236) +* [@lgeiger](https://github.com/lgeiger) made their first contribution in [#9288](https://github.com/pydantic/pydantic/pull/9288) + +## v2.7.0 (2024-04-11) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.7.0) + +The code released in v2.7.0 is practically identical to that of v2.7.0b1. + +### What's Changed + +#### Packaging + +* Reorganize `pyproject.toml` sections by [@Viicos](https://github.com/Viicos) in [#8899](https://github.com/pydantic/pydantic/pull/8899) +* Bump `pydantic-core` to `v2.18.1` by [@sydney-runkle](https://github.com/sydney-runkle) in [#9211](https://github.com/pydantic/pydantic/pull/9211) +* Adopt `jiter` `v0.2.0` by [@samuelcolvin](https://github.com/samuelcolvin) in [pydantic/pydantic-core#1250](https://github.com/pydantic/pydantic-core/pull/1250) + +#### New Features + +* Extract attribute docstrings from `FieldInfo.description` by [@Viicos](https://github.com/Viicos) in [#6563](https://github.com/pydantic/pydantic/pull/6563) +* Add a `with_config` decorator to comply with typing spec by [@Viicos](https://github.com/Viicos) in [#8611](https://github.com/pydantic/pydantic/pull/8611) +* Allow an optional separator splitting the value and unit of the result of `ByteSize.human_readable` by [@jks15satoshi](https://github.com/jks15satoshi) in [#8706](https://github.com/pydantic/pydantic/pull/8706) +* Add generic `Secret` base type by [@conradogarciaberrotaran](https://github.com/conradogarciaberrotaran) in [#8519](https://github.com/pydantic/pydantic/pull/8519) +* Make use of `Sphinx` inventories for cross references in docs by [@Viicos](https://github.com/Viicos) in [#8682](https://github.com/pydantic/pydantic/pull/8682) +* Add environment variable to disable plugins by [@geospackle](https://github.com/geospackle) in [#8767](https://github.com/pydantic/pydantic/pull/8767) +* Add support for `deprecated` fields by [@Viicos](https://github.com/Viicos) in [#8237](https://github.com/pydantic/pydantic/pull/8237) +* Allow `field_serializer('*')` by [@ornariece](https://github.com/ornariece) in [#9001](https://github.com/pydantic/pydantic/pull/9001) +* Handle a case when `model_config` is defined as a model property by [@alexeyt101](https://github.com/alexeyt101) in [#9004](https://github.com/pydantic/pydantic/pull/9004) +* Update `create_model()` to support `typing.Annotated` as input by [@wannieman98](https://github.com/wannieman98) in [#8947](https://github.com/pydantic/pydantic/pull/8947) +* Add `ClickhouseDsn` support by [@solidguy7](https://github.com/solidguy7) in [#9062](https://github.com/pydantic/pydantic/pull/9062) +* Add support for `re.Pattern[str]` to `pattern` field by [@jag-k](https://github.com/jag-k) in [#9053](https://github.com/pydantic/pydantic/pull/9053) +* Support for `serialize_as_any` runtime setting by [@sydney-runkle](https://github.com/sydney-runkle) in [#8830](https://github.com/pydantic/pydantic/pull/8830) +* Add support for `typing.Self` by [@Youssefares](https://github.com/Youssefares) in [#9023](https://github.com/pydantic/pydantic/pull/9023) +* Ability to pass `context` to serialization by [@ornariece](https://github.com/ornariece) in [#8965](https://github.com/pydantic/pydantic/pull/8965) +* Add feedback widget to docs with flarelytics integration by [@sydney-runkle](https://github.com/sydney-runkle) in [#9129](https://github.com/pydantic/pydantic/pull/9129) +* Support for parsing partial JSON strings in Python by [@samuelcolvin](https://github.com/samuelcolvin) in [pydantic/jiter#66](https://github.com/pydantic/jiter/pull/66) + +**Finalized in v2.7.0, rather than v2.7.0b1:** +* Add support for field level number to str coercion option by [@NeevCohen](https://github.com/NeevCohen) in [#9137](https://github.com/pydantic/pydantic/pull/9137) +* Update `warnings` parameter for serialization utilities to allow raising a warning by [@Lance-Drane](https://github.com/Lance-Drane) in [#9166](https://github.com/pydantic/pydantic/pull/9166) + +#### Changes + +* Correct docs, logic for `model_construct` behavior with `extra` by [@sydney-runkle](https://github.com/sydney-runkle) in [#8807](https://github.com/pydantic/pydantic/pull/8807) +* Improve error message for improper `RootModel` subclasses by [@sydney-runkle](https://github.com/sydney-runkle) in [#8857](https://github.com/pydantic/pydantic/pull/8857) +* Use `PEP570` syntax by [@Viicos](https://github.com/Viicos) in [#8940](https://github.com/pydantic/pydantic/pull/8940) +* Add `enum` and `type` to the JSON schema for single item literals by [@dmontagu](https://github.com/dmontagu) in [#8944](https://github.com/pydantic/pydantic/pull/8944) +* Deprecate `update_json_schema` internal function by [@sydney-runkle](https://github.com/sydney-runkle) in [#9125](https://github.com/pydantic/pydantic/pull/9125) +* Serialize duration to hour minute second, instead of just seconds by [@kakilangit](https://github.com/kakilangit) in [pydantic/speedate#50](https://github.com/pydantic/speedate/pull/50) +* Trimming str before parsing to int and float by [@hungtsetse](https://github.com/hungtsetse) in [pydantic/pydantic-core#1203](https://github.com/pydantic/pydantic-core/pull/1203) + +#### Performance + +* `enum` validator improvements by [@samuelcolvin](https://github.com/samuelcolvin) in [#9045](https://github.com/pydantic/pydantic/pull/9045) +* Move `enum` validation and serialization to Rust by [@samuelcolvin](https://github.com/samuelcolvin) in [#9064](https://github.com/pydantic/pydantic/pull/9064) +* Improve schema generation for nested dataclasses by [@sydney-runkle](https://github.com/sydney-runkle) in [#9114](https://github.com/pydantic/pydantic/pull/9114) +* Fast path for ASCII python string creation in JSON by [@samuelcolvin](https://github.com/samuelcolvin) in in [pydantic/jiter#72](https://github.com/pydantic/jiter/pull/72) +* SIMD integer and string JSON parsing on `aarch64`(**Note:** SIMD on x86 will be implemented in a future release) by [@samuelcolvin](https://github.com/samuelcolvin) in in [pydantic/jiter#65](https://github.com/pydantic/jiter/pull/65) +* Support JSON `Cow` from `jiter` by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/pydantic-core#1231](https://github.com/pydantic/pydantic-core/pull/1231) +* MAJOR performance improvement: update to PyO3 0.21 final by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/pydantic-core#1248](https://github.com/pydantic/pydantic-core/pull/1248) +* cache Python strings by [@samuelcolvin](https://github.com/samuelcolvin) in [pydantic/pydantic-core#1240](https://github.com/pydantic/pydantic-core/pull/1240) + +#### Fixes + +* Fix strict parsing for some `Sequence`s by [@sydney-runkle](https://github.com/sydney-runkle) in [#8614](https://github.com/pydantic/pydantic/pull/8614) +* Add a check on the existence of `__qualname__` by [@anci3ntr0ck](https://github.com/anci3ntr0ck) in [#8642](https://github.com/pydantic/pydantic/pull/8642) +* Handle `__pydantic_extra__` annotation being a string or inherited by [@alexmojaki](https://github.com/alexmojaki) in [#8659](https://github.com/pydantic/pydantic/pull/8659) +* Fix json validation for `NameEmail` by [@Holi0317](https://github.com/Holi0317) in [#8650](https://github.com/pydantic/pydantic/pull/8650) +* Fix type-safety of attribute access in `BaseModel` by [@bluenote10](https://github.com/bluenote10) in [#8651](https://github.com/pydantic/pydantic/pull/8651) +* Fix bug with `mypy` plugin and `no_strict_optional = True` by [@dmontagu](https://github.com/dmontagu) in [#8666](https://github.com/pydantic/pydantic/pull/8666) +* Fix `ByteSize` error `type` change by [@sydney-runkle](https://github.com/sydney-runkle) in [#8681](https://github.com/pydantic/pydantic/pull/8681) +* Fix inheriting annotations in dataclasses by [@sydney-runkle](https://github.com/sydney-runkle) in [#8679](https://github.com/pydantic/pydantic/pull/8679) +* Fix regression in core schema generation for indirect definition references by [@dmontagu](https://github.com/dmontagu) in [#8702](https://github.com/pydantic/pydantic/pull/8702) +* Fix unsupported types bug with plain validator by [@sydney-runkle](https://github.com/sydney-runkle) in [#8710](https://github.com/pydantic/pydantic/pull/8710) +* Reverting problematic fix from 2.6 release, fixing schema building bug by [@sydney-runkle](https://github.com/sydney-runkle) in [#8718](https://github.com/pydantic/pydantic/pull/8718) +* fixes `__pydantic_config__` ignored for TypeDict by [@13sin](https://github.com/13sin) in [#8734](https://github.com/pydantic/pydantic/pull/8734) +* Fix test failures with `pytest v8.0.0` due to `pytest.warns()` starting to work inside `pytest.raises()` by [@mgorny](https://github.com/mgorny) in [#8678](https://github.com/pydantic/pydantic/pull/8678) +* Use `is_valid_field` from 1.x for `mypy` plugin by [@DanielNoord](https://github.com/DanielNoord) in [#8738](https://github.com/pydantic/pydantic/pull/8738) +* Better-support `mypy` strict equality flag by [@dmontagu](https://github.com/dmontagu) in [#8799](https://github.com/pydantic/pydantic/pull/8799) +* model_json_schema export with Annotated types misses 'required' parameters by [@LouisGobert](https://github.com/LouisGobert) in [#8793](https://github.com/pydantic/pydantic/pull/8793) +* Fix default inclusion in `FieldInfo.__repr_args__` by [@sydney-runkle](https://github.com/sydney-runkle) in [#8801](https://github.com/pydantic/pydantic/pull/8801) +* Fix resolution of forward refs in dataclass base classes that are not present in the subclass module namespace by [@matsjoyce-refeyn](https://github.com/matsjoyce-refeyn) in [#8751](https://github.com/pydantic/pydantic/pull/8751) +* Fix `BaseModel` type annotations to be resolvable by `typing.get_type_hints` by [@devmonkey22](https://github.com/devmonkey22) in [#7680](https://github.com/pydantic/pydantic/pull/7680) +* Fix: allow empty string aliases with `AliasGenerator` by [@sydney-runkle](https://github.com/sydney-runkle) in [#8810](https://github.com/pydantic/pydantic/pull/8810) +* Fix test along with `date` -> `datetime` timezone assumption fix by [@sydney-runkle](https://github.com/sydney-runkle) in [#8823](https://github.com/pydantic/pydantic/pull/8823) +* Fix deprecation warning with usage of `ast.Str` by [@Viicos](https://github.com/Viicos) in [#8837](https://github.com/pydantic/pydantic/pull/8837) +* Add missing `deprecated` decorators by [@Viicos](https://github.com/Viicos) in [#8877](https://github.com/pydantic/pydantic/pull/8877) +* Fix serialization of `NameEmail` if name includes an email address by [@NeevCohen](https://github.com/NeevCohen) in [#8860](https://github.com/pydantic/pydantic/pull/8860) +* Add information about class in error message of schema generation by [@Czaki](https://github.com/Czaki) in [#8917](https://github.com/pydantic/pydantic/pull/8917) +* Make `TypeAdapter`'s typing compatible with special forms by [@adriangb](https://github.com/adriangb) in [#8923](https://github.com/pydantic/pydantic/pull/8923) +* Fix issue with config behavior being baked into the ref schema for `enum`s by [@dmontagu](https://github.com/dmontagu) in [#8920](https://github.com/pydantic/pydantic/pull/8920) +* More helpful error re wrong `model_json_schema` usage by [@sydney-runkle](https://github.com/sydney-runkle) in [#8928](https://github.com/pydantic/pydantic/pull/8928) +* Fix nested discriminated union schema gen, pt 2 by [@sydney-runkle](https://github.com/sydney-runkle) in [#8932](https://github.com/pydantic/pydantic/pull/8932) +* Fix schema build for nested dataclasses / TypedDicts with discriminators by [@sydney-runkle](https://github.com/sydney-runkle) in [#8950](https://github.com/pydantic/pydantic/pull/8950) +* Remove unnecessary logic for definitions schema gen with discriminated unions by [@sydney-runkle](https://github.com/sydney-runkle) in [#8951](https://github.com/pydantic/pydantic/pull/8951) +* Fix handling of optionals in `mypy` plugin by [@dmontagu](https://github.com/dmontagu) in [#9008](https://github.com/pydantic/pydantic/pull/9008) +* Fix `PlainSerializer` usage with std type constructor by [@sydney-runkle](https://github.com/sydney-runkle) in [#9031](https://github.com/pydantic/pydantic/pull/9031) +* Remove unnecessary warning for config in plugin by [@dmontagu](https://github.com/dmontagu) in [#9039](https://github.com/pydantic/pydantic/pull/9039) +* Fix default value serializing by [@NeevCohen](https://github.com/NeevCohen) in [#9066](https://github.com/pydantic/pydantic/pull/9066) +* Fix extra fields check in `Model.__getattr__()` by [@NeevCohen](https://github.com/NeevCohen) in [#9082](https://github.com/pydantic/pydantic/pull/9082) +* Fix `ClassVar` forward ref inherited from parent class by [@alexmojaki](https://github.com/alexmojaki) in [#9097](https://github.com/pydantic/pydantic/pull/9097) +* fix sequence like validator with strict `True` by [@andresliszt](https://github.com/andresliszt) in [#8977](https://github.com/pydantic/pydantic/pull/8977) +* Improve warning message when a field name shadows a field in a parent model by [@chan-vince](https://github.com/chan-vince) in [#9105](https://github.com/pydantic/pydantic/pull/9105) +* Do not warn about shadowed fields if they are not redefined in a child class by [@chan-vince](https://github.com/chan-vince) in [#9111](https://github.com/pydantic/pydantic/pull/9111) +* Fix discriminated union bug with unsubstituted type var by [@sydney-runkle](https://github.com/sydney-runkle) in [#9124](https://github.com/pydantic/pydantic/pull/9124) +* Support serialization of `deque` when passed to `Sequence[blah blah blah]` by [@sydney-runkle](https://github.com/sydney-runkle) in [#9128](https://github.com/pydantic/pydantic/pull/9128) +* Init private attributes from super-types in `model_post_init` by [@Viicos](https://github.com/Viicos) in [#9134](https://github.com/pydantic/pydantic/pull/9134) +* fix `model_construct` with `validation_alias` by [@ornariece](https://github.com/ornariece) in [#9144](https://github.com/pydantic/pydantic/pull/9144) +* Ensure json-schema generator handles `Literal` `null` types by [@bruno-f-cruz](https://github.com/bruno-f-cruz) in [#9135](https://github.com/pydantic/pydantic/pull/9135) +* **Fixed in v2.7.0**: Fix allow extra generic by [@dmontagu](https://github.com/dmontagu) in [#9193](https://github.com/pydantic/pydantic/pull/9193) + +### New Contributors + +* [@hungtsetse](https://github.com/hungtsetse) made their first contribution in [#8546](https://github.com/pydantic/pydantic/pull/8546) +* [@StrawHatDrag0n](https://github.com/StrawHatDrag0n) made their first contribution in [#8583](https://github.com/pydantic/pydantic/pull/8583) +* [@anci3ntr0ck](https://github.com/anci3ntr0ck) made their first contribution in [#8642](https://github.com/pydantic/pydantic/pull/8642) +* [@Holi0317](https://github.com/Holi0317) made their first contribution in [#8650](https://github.com/pydantic/pydantic/pull/8650) +* [@bluenote10](https://github.com/bluenote10) made their first contribution in [#8651](https://github.com/pydantic/pydantic/pull/8651) +* [@ADSteele916](https://github.com/ADSteele916) made their first contribution in [#8703](https://github.com/pydantic/pydantic/pull/8703) +* [@musicinmybrain](https://github.com/musicinmybrain) made their first contribution in [#8731](https://github.com/pydantic/pydantic/pull/8731) +* [@jks15satoshi](https://github.com/jks15satoshi) made their first contribution in [#8706](https://github.com/pydantic/pydantic/pull/8706) +* [@13sin](https://github.com/13sin) made their first contribution in [#8734](https://github.com/pydantic/pydantic/pull/8734) +* [@DanielNoord](https://github.com/DanielNoord) made their first contribution in [#8738](https://github.com/pydantic/pydantic/pull/8738) +* [@conradogarciaberrotaran](https://github.com/conradogarciaberrotaran) made their first contribution in [#8519](https://github.com/pydantic/pydantic/pull/8519) +* [@chris-griffin](https://github.com/chris-griffin) made their first contribution in [#8775](https://github.com/pydantic/pydantic/pull/8775) +* [@LouisGobert](https://github.com/LouisGobert) made their first contribution in [#8793](https://github.com/pydantic/pydantic/pull/8793) +* [@matsjoyce-refeyn](https://github.com/matsjoyce-refeyn) made their first contribution in [#8751](https://github.com/pydantic/pydantic/pull/8751) +* [@devmonkey22](https://github.com/devmonkey22) made their first contribution in [#7680](https://github.com/pydantic/pydantic/pull/7680) +* [@adamency](https://github.com/adamency) made their first contribution in [#8847](https://github.com/pydantic/pydantic/pull/8847) +* [@MamfTheKramf](https://github.com/MamfTheKramf) made their first contribution in [#8851](https://github.com/pydantic/pydantic/pull/8851) +* [@ornariece](https://github.com/ornariece) made their first contribution in [#9001](https://github.com/pydantic/pydantic/pull/9001) +* [@alexeyt101](https://github.com/alexeyt101) made their first contribution in [#9004](https://github.com/pydantic/pydantic/pull/9004) +* [@wannieman98](https://github.com/wannieman98) made their first contribution in [#8947](https://github.com/pydantic/pydantic/pull/8947) +* [@solidguy7](https://github.com/solidguy7) made their first contribution in [#9062](https://github.com/pydantic/pydantic/pull/9062) +* [@kloczek](https://github.com/kloczek) made their first contribution in [#9047](https://github.com/pydantic/pydantic/pull/9047) +* [@jag-k](https://github.com/jag-k) made their first contribution in [#9053](https://github.com/pydantic/pydantic/pull/9053) +* [@priya-gitTest](https://github.com/priya-gitTest) made their first contribution in [#9088](https://github.com/pydantic/pydantic/pull/9088) +* [@Youssefares](https://github.com/Youssefares) made their first contribution in [#9023](https://github.com/pydantic/pydantic/pull/9023) +* [@chan-vince](https://github.com/chan-vince) made their first contribution in [#9105](https://github.com/pydantic/pydantic/pull/9105) +* [@bruno-f-cruz](https://github.com/bruno-f-cruz) made their first contribution in [#9135](https://github.com/pydantic/pydantic/pull/9135) +* [@Lance-Drane](https://github.com/Lance-Drane) made their first contribution in [#9166](https://github.com/pydantic/pydantic/pull/9166) + +## v2.7.0b1 (2024-04-03) + +Pre-release, see [the GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.7.0b1) for details. + +## v2.6.4 (2024-03-12) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.6.4) + +### What's Changed + +#### Fixes + +* Fix usage of `AliasGenerator` with `computed_field` decorator by [@sydney-runkle](https://github.com/sydney-runkle) in [#8806](https://github.com/pydantic/pydantic/pull/8806) +* Fix nested discriminated union schema gen, pt 2 by [@sydney-runkle](https://github.com/sydney-runkle) in [#8932](https://github.com/pydantic/pydantic/pull/8932) +* Fix bug with no_strict_optional=True caused by API deferral by [@dmontagu](https://github.com/dmontagu) in [#8826](https://github.com/pydantic/pydantic/pull/8826) + + +## v2.6.3 (2024-02-27) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.6.3) + +### What's Changed + +#### Packaging + +* Update `pydantic-settings` version in the docs by [@hramezani](https://github.com/hramezani) in [#8906](https://github.com/pydantic/pydantic/pull/8906) + +#### Fixes + +* Fix discriminated union schema gen bug by [@sydney-runkle](https://github.com/sydney-runkle) in [#8904](https://github.com/pydantic/pydantic/pull/8904) + + +## v2.6.2 (2024-02-23) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.6.2) + +### What's Changed + +#### Packaging + +* Upgrade to `pydantic-core` 2.16.3 by [@sydney-runkle](https://github.com/sydney-runkle) in [#8879](https://github.com/pydantic/pydantic/pull/8879) + +#### Fixes + +* 'YYYY-MM-DD' date string coerced to datetime shouldn't infer timezone by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/pydantic-core#1193](https://github.com/pydantic/pydantic-core/pull/1193) + + +## v2.6.1 (2024-02-05) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.6.1) + +### What's Changed + +#### Packaging + +* Upgrade to `pydantic-core` 2.16.2 by [@sydney-runkle](https://github.com/sydney-runkle) in [#8717](https://github.com/pydantic/pydantic/pull/8717) + +#### Fixes + +* Fix bug with `mypy` plugin and `no_strict_optional = True` by [@dmontagu](https://github.com/dmontagu) in [#8666](https://github.com/pydantic/pydantic/pull/8666) +* Fix `ByteSize` error `type` change by [@sydney-runkle](https://github.com/sydney-runkle) in [#8681](https://github.com/pydantic/pydantic/pull/8681) +* Fix inheriting `Field` annotations in dataclasses by [@sydney-runkle](https://github.com/sydney-runkle) in [#8679](https://github.com/pydantic/pydantic/pull/8679) +* Fix regression in core schema generation for indirect definition references by [@dmontagu](https://github.com/dmontagu) in [#8702](https://github.com/pydantic/pydantic/pull/8702) +* Fix unsupported types bug with `PlainValidator` by [@sydney-runkle](https://github.com/sydney-runkle) in [#8710](https://github.com/pydantic/pydantic/pull/8710) +* Reverting problematic fix from 2.6 release, fixing schema building bug by [@sydney-runkle](https://github.com/sydney-runkle) in [#8718](https://github.com/pydantic/pydantic/pull/8718) +* Fix warning for tuple of wrong size in `Union` by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/pydantic-core#1174](https://github.com/pydantic/pydantic-core/pull/1174) +* Fix `computed_field` JSON serializer `exclude_none` behavior by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/pydantic-core#1187](https://github.com/pydantic/pydantic-core/pull/1187) + + +## v2.6.0 (2024-01-23) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.6.0) + +The code released in v2.6.0 is practically identical to that of v2.6.0b1. + +### What's Changed + +#### Packaging + +* Check for `email-validator` version >= 2.0 by [@commonism](https://github.com/commonism) in [#6033](https://github.com/pydantic/pydantic/pull/6033) +* Upgrade `ruff`` target version to Python 3.8 by [@Elkiwa](https://github.com/Elkiwa) in [#8341](https://github.com/pydantic/pydantic/pull/8341) +* Update to `pydantic-extra-types==2.4.1` by [@yezz123](https://github.com/yezz123) in [#8478](https://github.com/pydantic/pydantic/pull/8478) +* Update to `pyright==1.1.345` by [@Viicos](https://github.com/Viicos) in [#8453](https://github.com/pydantic/pydantic/pull/8453) +* Update pydantic-core from 2.14.6 to 2.16.1, significant changes from these updates are described below, full changelog [here](https://github.com/pydantic/pydantic-core/compare/v2.14.6...v2.16.1) + +#### New Features + +* Add `NatsDsn` by [@ekeew](https://github.com/ekeew) in [#6874](https://github.com/pydantic/pydantic/pull/6874) +* Add `ConfigDict.ser_json_inf_nan` by [@davidhewitt](https://github.com/davidhewitt) in [#8159](https://github.com/pydantic/pydantic/pull/8159) +* Add `types.OnErrorOmit` by [@adriangb](https://github.com/adriangb) in [#8222](https://github.com/pydantic/pydantic/pull/8222) +* Support `AliasGenerator` usage by [@sydney-runkle](https://github.com/sydney-runkle) in [#8282](https://github.com/pydantic/pydantic/pull/8282) +* Add Pydantic People Page to docs by [@sydney-runkle](https://github.com/sydney-runkle) in [#8345](https://github.com/pydantic/pydantic/pull/8345) +* Support `yyyy-MM-DD` datetime parsing by [@sydney-runkle](https://github.com/sydney-runkle) in [#8404](https://github.com/pydantic/pydantic/pull/8404) +* Added bits conversions to the `ByteSize` class [#8415](https://github.com/pydantic/pydantic/issues/8415) by [@luca-matei](https://github.com/luca-matei) in [#8507](https://github.com/pydantic/pydantic/pull/8507) +* Enable json schema creation with type `ByteSize` by [@geospackle](https://github.com/geospackle) in [#8537](https://github.com/pydantic/pydantic/pull/8537) +* Add `eval_type_backport` to handle union operator and builtin generic subscripting in older Pythons by [@alexmojaki](https://github.com/alexmojaki) in [#8209](https://github.com/pydantic/pydantic/pull/8209) +* Add support for `dataclass` fields `init` by [@dmontagu](https://github.com/dmontagu) in [#8552](https://github.com/pydantic/pydantic/pull/8552) +* Implement pickling for `ValidationError` by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/pydantic-core#1119](https://github.com/pydantic/pydantic-core/pull/1119) +* Add unified tuple validator that can handle "variadic" tuples via PEP-646 by [@dmontagu](https://github.com/dmontagu) in [pydantic/pydantic-core#865](https://github.com/pydantic/pydantic-core/pull/865) + +#### Changes + +* Drop Python3.7 support by [@hramezani](https://github.com/hramezani) in [#7188](https://github.com/pydantic/pydantic/pull/7188) +* Drop Python 3.7, and PyPy 3.7 and 3.8 by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/pydantic-core#1129](https://github.com/pydantic/pydantic-core/pull/1129) +* Use positional-only `self` in `BaseModel` constructor, so no field name can ever conflict with it by [@ariebovenberg](https://github.com/ariebovenberg) in [#8072](https://github.com/pydantic/pydantic/pull/8072) +* Make `@validate_call` return a function instead of a custom descriptor - fixes binding issue with inheritance and adds `self/cls` argument to validation errors by [@alexmojaki](https://github.com/alexmojaki) in [#8268](https://github.com/pydantic/pydantic/pull/8268) +* Exclude `BaseModel` docstring from JSON schema description by [@sydney-runkle](https://github.com/sydney-runkle) in [#8352](https://github.com/pydantic/pydantic/pull/8352) +* Introducing `classproperty` decorator for `model_computed_fields` by [@Jocelyn-Gas](https://github.com/Jocelyn-Gas) in [#8437](https://github.com/pydantic/pydantic/pull/8437) +* Explicitly raise an error if field names clashes with types by [@Viicos](https://github.com/Viicos) in [#8243](https://github.com/pydantic/pydantic/pull/8243) +* Use stricter serializer for unions of simple types by [@alexdrydew](https://github.com/alexdrydew) [pydantic/pydantic-core#1132](https://github.com/pydantic/pydantic-core/pull/1132) + +#### Performance + +* Add Codspeed profiling Actions workflow by [@lambertsbennett](https://github.com/lambertsbennett) in [#8054](https://github.com/pydantic/pydantic/pull/8054) +* Improve `int` extraction by [@samuelcolvin](https://github.com/samuelcolvin) in [pydantic/pydantic-core#1155](https://github.com/pydantic/pydantic-core/pull/1155) +* Improve performance of recursion guard by [@samuelcolvin](https://github.com/samuelcolvin) in [pydantic/pydantic-core#1156](https://github.com/pydantic/pydantic-core/pull/1156) +* `dataclass` serialization speedups by [@samuelcolvin](https://github.com/samuelcolvin) in [pydantic/pydantic-core#1162](https://github.com/pydantic/pydantic-core/pull/1162) +* Avoid `HashMap` creation when looking up small JSON objects in `LazyIndexMaps` by [@samuelcolvin](https://github.com/samuelcolvin) in [pydantic/jiter#55](https://github.com/pydantic/jiter/pull/55) +* use hashbrown to speedup python string caching by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/jiter#51](https://github.com/pydantic/jiter/pull/51) +* Replace `Peak` with more efficient `Peek` by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/jiter#48](https://github.com/pydantic/jiter/pull/48) + +#### Fixes + +* Move `getattr` warning in deprecated `BaseConfig` by [@tlambert03](https://github.com/tlambert03) in [#7183](https://github.com/pydantic/pydantic/pull/7183) +* Only hash `model_fields`, not whole `__dict__` by [@alexmojaki](https://github.com/alexmojaki) in [#7786](https://github.com/pydantic/pydantic/pull/7786) +* Fix mishandling of unions while freezing types in the `mypy` plugin by [@dmontagu](https://github.com/dmontagu) in [#7411](https://github.com/pydantic/pydantic/pull/7411) +* Fix `mypy` error on untyped `ClassVar` by [@vincent-hachin-wmx](https://github.com/vincent-hachin-wmx) in [#8138](https://github.com/pydantic/pydantic/pull/8138) +* Only compare pydantic fields in `BaseModel.__eq__` instead of whole `__dict__` by [@QuentinSoubeyranAqemia](https://github.com/QuentinSoubeyranAqemia) in [#7825](https://github.com/pydantic/pydantic/pull/7825) +* Update `strict` docstring in `model_validate` method. by [@LukeTonin](https://github.com/LukeTonin) in [#8223](https://github.com/pydantic/pydantic/pull/8223) +* Fix overload position of `computed_field` by [@Viicos](https://github.com/Viicos) in [#8227](https://github.com/pydantic/pydantic/pull/8227) +* Fix custom type type casting used in multiple attributes by [@ianhfc](https://github.com/ianhfc) in [#8066](https://github.com/pydantic/pydantic/pull/8066) +* Fix issue not allowing `validate_call` decorator to be dynamically assigned to a class method by [@jusexton](https://github.com/jusexton) in [#8249](https://github.com/pydantic/pydantic/pull/8249) +* Fix issue `unittest.mock` deprecation warnings by [@ibleedicare](https://github.com/ibleedicare) in [#8262](https://github.com/pydantic/pydantic/pull/8262) +* Added tests for the case `JsonValue` contains subclassed primitive values by [@jusexton](https://github.com/jusexton) in [#8286](https://github.com/pydantic/pydantic/pull/8286) +* Fix `mypy` error on free before validator (classmethod) by [@sydney-runkle](https://github.com/sydney-runkle) in [#8285](https://github.com/pydantic/pydantic/pull/8285) +* Fix `to_snake` conversion by [@jevins09](https://github.com/jevins09) in [#8316](https://github.com/pydantic/pydantic/pull/8316) +* Fix type annotation of `ModelMetaclass.__prepare__` by [@slanzmich](https://github.com/slanzmich) in [#8305](https://github.com/pydantic/pydantic/pull/8305) +* Disallow `config` specification when initializing a `TypeAdapter` when the annotated type has config already by [@sydney-runkle](https://github.com/sydney-runkle) in [#8365](https://github.com/pydantic/pydantic/pull/8365) +* Fix a naming issue with JSON schema for generics parametrized by recursive type aliases by [@dmontagu](https://github.com/dmontagu) in [#8389](https://github.com/pydantic/pydantic/pull/8389) +* Fix type annotation in pydantic people script by [@shenxiangzhuang](https://github.com/shenxiangzhuang) in [#8402](https://github.com/pydantic/pydantic/pull/8402) +* Add support for field `alias` in `dataclass` signature by [@NeevCohen](https://github.com/NeevCohen) in [#8387](https://github.com/pydantic/pydantic/pull/8387) +* Fix bug with schema generation with `Field(...)` in a forward ref by [@dmontagu](https://github.com/dmontagu) in [#8494](https://github.com/pydantic/pydantic/pull/8494) +* Fix ordering of keys in `__dict__` with `model_construct` call by [@sydney-runkle](https://github.com/sydney-runkle) in [#8500](https://github.com/pydantic/pydantic/pull/8500) +* Fix module `path_type` creation when globals does not contain `__name__` by [@hramezani](https://github.com/hramezani) in [#8470](https://github.com/pydantic/pydantic/pull/8470) +* Fix for namespace issue with dataclasses with `from __future__ import annotations` by [@sydney-runkle](https://github.com/sydney-runkle) in [#8513](https://github.com/pydantic/pydantic/pull/8513) +* Fix: make function validator types positional-only by [@pmmmwh](https://github.com/pmmmwh) in [#8479](https://github.com/pydantic/pydantic/pull/8479) +* Fix usage of `@deprecated` by [@Viicos](https://github.com/Viicos) in [#8294](https://github.com/pydantic/pydantic/pull/8294) +* Add more support for private attributes in `model_construct` call by [@sydney-runkle](https://github.com/sydney-runkle) in [#8525](https://github.com/pydantic/pydantic/pull/8525) +* Use a stack for the types namespace by [@dmontagu](https://github.com/dmontagu) in [#8378](https://github.com/pydantic/pydantic/pull/8378) +* Fix schema-building bug with `TypeAliasType` for types with refs by [@dmontagu](https://github.com/dmontagu) in [#8526](https://github.com/pydantic/pydantic/pull/8526) +* Support `pydantic.Field(repr=False)` in dataclasses by [@tigeryy2](https://github.com/tigeryy2) in [#8511](https://github.com/pydantic/pydantic/pull/8511) +* Override `dataclass_transform` behavior for `RootModel` by [@Viicos](https://github.com/Viicos) in [#8163](https://github.com/pydantic/pydantic/pull/8163) +* Refactor signature generation for simplicity by [@sydney-runkle](https://github.com/sydney-runkle) in [#8572](https://github.com/pydantic/pydantic/pull/8572) +* Fix ordering bug of PlainValidator annotation by [@Anvil](https://github.com/Anvil) in [#8567](https://github.com/pydantic/pydantic/pull/8567) +* Fix `exclude_none` for json serialization of `computed_field`s by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/pydantic-core#1098](https://github.com/pydantic/pydantic-core/pull/1098) +* Support yyyy-MM-DD string for datetimes by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/pydantic-core#1124](https://github.com/pydantic/pydantic-core/pull/1124) +* Tweak ordering of definitions in generated schemas by [@StrawHatDrag0n](https://github.com/StrawHatDrag0n) in [#8583](https://github.com/pydantic/pydantic/pull/8583) + + +### New Contributors + +#### `pydantic` +* [@ekeew](https://github.com/ekeew) made their first contribution in [#6874](https://github.com/pydantic/pydantic/pull/6874) +* [@lambertsbennett](https://github.com/lambertsbennett) made their first contribution in [#8054](https://github.com/pydantic/pydantic/pull/8054) +* [@vincent-hachin-wmx](https://github.com/vincent-hachin-wmx) made their first contribution in [#8138](https://github.com/pydantic/pydantic/pull/8138) +* [@QuentinSoubeyranAqemia](https://github.com/QuentinSoubeyranAqemia) made their first contribution in [#7825](https://github.com/pydantic/pydantic/pull/7825) +* [@ariebovenberg](https://github.com/ariebovenberg) made their first contribution in [#8072](https://github.com/pydantic/pydantic/pull/8072) +* [@LukeTonin](https://github.com/LukeTonin) made their first contribution in [#8223](https://github.com/pydantic/pydantic/pull/8223) +* [@denisart](https://github.com/denisart) made their first contribution in [#8231](https://github.com/pydantic/pydantic/pull/8231) +* [@ianhfc](https://github.com/ianhfc) made their first contribution in [#8066](https://github.com/pydantic/pydantic/pull/8066) +* [@eonu](https://github.com/eonu) made their first contribution in [#8255](https://github.com/pydantic/pydantic/pull/8255) +* [@amandahla](https://github.com/amandahla) made their first contribution in [#8263](https://github.com/pydantic/pydantic/pull/8263) +* [@ibleedicare](https://github.com/ibleedicare) made their first contribution in [#8262](https://github.com/pydantic/pydantic/pull/8262) +* [@jevins09](https://github.com/jevins09) made their first contribution in [#8316](https://github.com/pydantic/pydantic/pull/8316) +* [@cuu508](https://github.com/cuu508) made their first contribution in [#8322](https://github.com/pydantic/pydantic/pull/8322) +* [@slanzmich](https://github.com/slanzmich) made their first contribution in [#8305](https://github.com/pydantic/pydantic/pull/8305) +* [@jensenbox](https://github.com/jensenbox) made their first contribution in [#8331](https://github.com/pydantic/pydantic/pull/8331) +* [@szepeviktor](https://github.com/szepeviktor) made their first contribution in [#8356](https://github.com/pydantic/pydantic/pull/8356) +* [@Elkiwa](https://github.com/Elkiwa) made their first contribution in [#8341](https://github.com/pydantic/pydantic/pull/8341) +* [@parhamfh](https://github.com/parhamfh) made their first contribution in [#8395](https://github.com/pydantic/pydantic/pull/8395) +* [@shenxiangzhuang](https://github.com/shenxiangzhuang) made their first contribution in [#8402](https://github.com/pydantic/pydantic/pull/8402) +* [@NeevCohen](https://github.com/NeevCohen) made their first contribution in [#8387](https://github.com/pydantic/pydantic/pull/8387) +* [@zby](https://github.com/zby) made their first contribution in [#8497](https://github.com/pydantic/pydantic/pull/8497) +* [@patelnets](https://github.com/patelnets) made their first contribution in [#8491](https://github.com/pydantic/pydantic/pull/8491) +* [@edwardwli](https://github.com/edwardwli) made their first contribution in [#8503](https://github.com/pydantic/pydantic/pull/8503) +* [@luca-matei](https://github.com/luca-matei) made their first contribution in [#8507](https://github.com/pydantic/pydantic/pull/8507) +* [@Jocelyn-Gas](https://github.com/Jocelyn-Gas) made their first contribution in [#8437](https://github.com/pydantic/pydantic/pull/8437) +* [@bL34cHig0](https://github.com/bL34cHig0) made their first contribution in [#8501](https://github.com/pydantic/pydantic/pull/8501) +* [@tigeryy2](https://github.com/tigeryy2) made their first contribution in [#8511](https://github.com/pydantic/pydantic/pull/8511) +* [@geospackle](https://github.com/geospackle) made their first contribution in [#8537](https://github.com/pydantic/pydantic/pull/8537) +* [@Anvil](https://github.com/Anvil) made their first contribution in [#8567](https://github.com/pydantic/pydantic/pull/8567) +* [@hungtsetse](https://github.com/hungtsetse) made their first contribution in [#8546](https://github.com/pydantic/pydantic/pull/8546) +* [@StrawHatDrag0n](https://github.com/StrawHatDrag0n) made their first contribution in [#8583](https://github.com/pydantic/pydantic/pull/8583) + +#### `pydantic-core` +* [@mariuswinger](https://github.com/mariuswinger) made their first contribution in [pydantic/pydantic-core#1087](https://github.com/pydantic/pydantic-core/pull/1087) +* [@adamchainz](https://github.com/adamchainz) made their first contribution in [pydantic/pydantic-core#1090](https://github.com/pydantic/pydantic-core/pull/1090) +* [@akx](https://github.com/akx) made their first contribution in [pydantic/pydantic-core#1123](https://github.com/pydantic/pydantic-core/pull/1123) + +## v2.6.0b1 (2024-01-19) + +Pre-release, see [the GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.6.0b1) for details. + +## v2.5.3 (2023-12-22) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.5.3) + +### What's Changed + +#### Packaging + +* uprev `pydantic-core` to 2.14.6 + +#### Fixes + +* Fix memory leak with recursive definitions creating reference cycles by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/pydantic-core#1125](https://github.com/pydantic/pydantic-core/pull/1125) + +## v2.5.2 (2023-11-22) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.5.2) + +### What's Changed + +#### Packaging + +* uprev `pydantic-core` to 2.14.5 + +#### New Features + +* Add `ConfigDict.ser_json_inf_nan` by [@davidhewitt](https://github.com/davidhewitt) in [#8159](https://github.com/pydantic/pydantic/pull/8159) + +#### Fixes + +* Fix validation of `Literal` from JSON keys when used as `dict` key by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/pydantic-core#1075](https://github.com/pydantic/pydantic-core/pull/1075) +* Fix bug re `custom_init` on members of `Union` by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/pydantic-core#1076](https://github.com/pydantic/pydantic-core/pull/1076) +* Fix `JsonValue` `bool` serialization by [@sydney-runkle](https://github.com/sydney-runkle) in [#8190](https://github.com/pydantic/pydantic/pull/8159) +* Fix handling of unhashable inputs with `Literal` in `Union`s by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/pydantic-core#1089](https://github.com/pydantic/pydantic-core/pull/1089) + +## v2.5.1 (2023-11-15) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.5.1) + +### What's Changed + +#### Packaging + +* uprev pydantic-core to 2.14.3 by [@samuelcolvin](https://github.com/samuelcolvin) in [#8120](https://github.com/pydantic/pydantic/pull/8120) + +#### Fixes + +* Fix package description limit by [@dmontagu](https://github.com/dmontagu) in [#8097](https://github.com/pydantic/pydantic/pull/8097) +* Fix `ValidateCallWrapper` error when creating a model which has a [@validate_call](https://github.com/validate_call) wrapped field annotation by [@sydney-runkle](https://github.com/sydney-runkle) in [#8110](https://github.com/pydantic/pydantic/pull/8110) + +## v2.5.0 (2023-11-13) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.5.0) + +The code released in v2.5.0 is functionally identical to that of v2.5.0b1. + +### What's Changed + +#### Packaging + +* Update pydantic-core from 2.10.1 to 2.14.1, significant changes from these updates are described below, full changelog [here](https://github.com/pydantic/pydantic-core/compare/v2.10.1...v2.14.1) +* Update to `pyright==1.1.335` by [@Viicos](https://github.com/Viicos) in [#8075](https://github.com/pydantic/pydantic/pull/8075) + +#### New Features + +* Allow plugins to catch non `ValidationError` errors by [@adriangb](https://github.com/adriangb) in [#7806](https://github.com/pydantic/pydantic/pull/7806) +* Support `__doc__` argument in `create_model()` by [@chris-spann](https://github.com/chris-spann) in [#7863](https://github.com/pydantic/pydantic/pull/7863) +* Expose `regex_engine` flag - meaning you can use with the Rust or Python regex libraries in constraints by [@utkini](https://github.com/utkini) in [#7768](https://github.com/pydantic/pydantic/pull/7768) +* Save return type generated from type annotation in `ComputedFieldInfo` by [@alexmojaki](https://github.com/alexmojaki) in [#7889](https://github.com/pydantic/pydantic/pull/7889) +* Adopting `ruff` formatter by [@Luca-Blight](https://github.com/Luca-Blight) in [#7930](https://github.com/pydantic/pydantic/pull/7930) +* Added `validation_error_cause` to config by [@zakstucke](https://github.com/zakstucke) in [#7626](https://github.com/pydantic/pydantic/pull/7626) +* Make path of the item to validate available in plugin by [@hramezani](https://github.com/hramezani) in [#7861](https://github.com/pydantic/pydantic/pull/7861) +* Add `CallableDiscriminator` and `Tag` by [@dmontagu](https://github.com/dmontagu) in [#7983](https://github.com/pydantic/pydantic/pull/7983) + * `CallableDiscriminator` renamed to `Discriminator` by [@dmontagu](https://github.com/dmontagu) in [#8047](https://github.com/pydantic/pydantic/pull/8047) +* Make union case tags affect union error messages by [@dmontagu](https://github.com/dmontagu) in [#8001](https://github.com/pydantic/pydantic/pull/8001) +* Add `examples` and `json_schema_extra` to `@computed_field` by [@alexmojaki](https://github.com/alexmojaki) in [#8013](https://github.com/pydantic/pydantic/pull/8013) +* Add `JsonValue` type by [@dmontagu](https://github.com/dmontagu) in [#7998](https://github.com/pydantic/pydantic/pull/7998) +* Allow `str` as argument to `Discriminator` by [@dmontagu](https://github.com/dmontagu) in [#8047](https://github.com/pydantic/pydantic/pull/8047) +* Add `SchemaSerializer.__reduce__` method to enable pickle serialization by [@edoakes](https://github.com/edoakes) in [pydantic/pydantic-core#1006](https://github.com/pydantic/pydantic-core/pull/1006) + +#### Changes + +* **Significant Change:** replace `ultra_strict` with new smart union implementation, the way unions are validated has changed significantly to improve performance and correctness, we have worked hard to absolutely minimise the number of cases where behaviour has changed, see the PR for details - by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/pydantic-core#867](https://github.com/pydantic/pydantic-core/pull/867) +* Add support for instance method reassignment when `extra='allow'` by [@sydney-runkle](https://github.com/sydney-runkle) in [#7683](https://github.com/pydantic/pydantic/pull/7683) +* Support JSON schema generation for `Enum` types with no cases by [@sydney-runkle](https://github.com/sydney-runkle) in [#7927](https://github.com/pydantic/pydantic/pull/7927) +* Warn if a class inherits from `Generic` before `BaseModel` by [@alexmojaki](https://github.com/alexmojaki) in [#7891](https://github.com/pydantic/pydantic/pull/7891) + +#### Performance + +* New custom JSON parser, `jiter` by [@samuelcolvin](https://github.com/samuelcolvin) in [pydantic/pydantic-core#974](https://github.com/pydantic/pydantic-core/pull/974) +* PGO build for MacOS M1 by [@samuelcolvin](https://github.com/samuelcolvin) in [pydantic/pydantic-core#1063](https://github.com/pydantic/pydantic-core/pull/1063) +* Use `__getattr__` for all package imports, improve import time by [@samuelcolvin](https://github.com/samuelcolvin) in [#7947](https://github.com/pydantic/pydantic/pull/7947) + +#### Fixes + +* Fix `mypy` issue with subclasses of `RootModel` by [@sydney-runkle](https://github.com/sydney-runkle) in [#7677](https://github.com/pydantic/pydantic/pull/7677) +* Properly rebuild the `FieldInfo` when a forward ref gets evaluated by [@dmontagu](https://github.com/dmontagu) in [#7698](https://github.com/pydantic/pydantic/pull/7698) +* Fix failure to load `SecretStr` from JSON (regression in v2.4) by [@sydney-runkle](https://github.com/sydney-runkle) in [#7729](https://github.com/pydantic/pydantic/pull/7729) +* Fix `defer_build` behavior with `TypeAdapter` by [@sydney-runkle](https://github.com/sydney-runkle) in [#7736](https://github.com/pydantic/pydantic/pull/7736) +* Improve compatibility with legacy `mypy` versions by [@dmontagu](https://github.com/dmontagu) in [#7742](https://github.com/pydantic/pydantic/pull/7742) +* Fix: update `TypeVar` handling when default is not set by [@pmmmwh](https://github.com/pmmmwh) in [#7719](https://github.com/pydantic/pydantic/pull/7719) +* Support specification of `strict` on `Enum` type fields by [@sydney-runkle](https://github.com/sydney-runkle) in [#7761](https://github.com/pydantic/pydantic/pull/7761) +* Wrap `weakref.ref` instead of subclassing to fix `cloudpickle` serialization by [@edoakes](https://github.com/edoakes) in [#7780](https://github.com/pydantic/pydantic/pull/7780) +* Keep values of private attributes set within `model_post_init` in subclasses by [@alexmojaki](https://github.com/alexmojaki) in [#7775](https://github.com/pydantic/pydantic/pull/7775) +* Add more specific type for non-callable `json_schema_extra` by [@alexmojaki](https://github.com/alexmojaki) in [#7803](https://github.com/pydantic/pydantic/pull/7803) +* Raise an error when deleting frozen (model) fields by [@alexmojaki](https://github.com/alexmojaki) in [#7800](https://github.com/pydantic/pydantic/pull/7800) +* Fix schema sorting bug with default values by [@sydney-runkle](https://github.com/sydney-runkle) in [#7817](https://github.com/pydantic/pydantic/pull/7817) +* Use generated alias for aliases that are not specified otherwise by [@alexmojaki](https://github.com/alexmojaki) in [#7802](https://github.com/pydantic/pydantic/pull/7802) +* Support `strict` specification for `UUID` types by [@sydney-runkle](https://github.com/sydney-runkle) in [#7865](https://github.com/pydantic/pydantic/pull/7865) +* JSON schema: fix extra parameter handling by [@me-and](https://github.com/me-and) in [#7810](https://github.com/pydantic/pydantic/pull/7810) +* Fix: support `pydantic.Field(kw_only=True)` with inherited dataclasses by [@PrettyWood](https://github.com/PrettyWood) in [#7827](https://github.com/pydantic/pydantic/pull/7827) +* Support `validate_call` decorator for methods in classes with `__slots__` by [@sydney-runkle](https://github.com/sydney-runkle) in [#7883](https://github.com/pydantic/pydantic/pull/7883) +* Fix pydantic dataclass problem with `dataclasses.field` default by [@hramezani](https://github.com/hramezani) in [#7898](https://github.com/pydantic/pydantic/pull/7898) +* Fix schema generation for generics with union type bounds by [@sydney-runkle](https://github.com/sydney-runkle) in [#7899](https://github.com/pydantic/pydantic/pull/7899) +* Fix version for `importlib_metadata` on python 3.7 by [@sydney-runkle](https://github.com/sydney-runkle) in [#7904](https://github.com/pydantic/pydantic/pull/7904) +* Support `|` operator (Union) in PydanticRecursiveRef by [@alexmojaki](https://github.com/alexmojaki) in [#7892](https://github.com/pydantic/pydantic/pull/7892) +* Fix `display_as_type` for `TypeAliasType` in python 3.12 by [@dmontagu](https://github.com/dmontagu) in [#7929](https://github.com/pydantic/pydantic/pull/7929) +* Add support for `NotRequired` generics in `TypedDict` by [@sydney-runkle](https://github.com/sydney-runkle) in [#7932](https://github.com/pydantic/pydantic/pull/7932) +* Make generic `TypeAliasType` specifications produce different schema definitions by [@alexdrydew](https://github.com/alexdrydew) in [#7893](https://github.com/pydantic/pydantic/pull/7893) +* Added fix for signature of inherited dataclass by [@howsunjow](https://github.com/howsunjow) in [#7925](https://github.com/pydantic/pydantic/pull/7925) +* Make the model name generation more robust in JSON schema by [@joakimnordling](https://github.com/joakimnordling) in [#7881](https://github.com/pydantic/pydantic/pull/7881) +* Fix plurals in validation error messages (in tests) by [@Iipin](https://github.com/Iipin) in [#7972](https://github.com/pydantic/pydantic/pull/7972) +* `PrivateAttr` is passed from `Annotated` default position by [@tabassco](https://github.com/tabassco) in [#8004](https://github.com/pydantic/pydantic/pull/8004) +* Don't decode bytes (which may not be UTF8) when displaying SecretBytes by [@alexmojaki](https://github.com/alexmojaki) in [#8012](https://github.com/pydantic/pydantic/pull/8012) +* Use `classmethod` instead of `classmethod[Any, Any, Any]` by [@Mr-Pepe](https://github.com/Mr-Pepe) in [#7979](https://github.com/pydantic/pydantic/pull/7979) +* Clearer error on invalid Plugin by [@samuelcolvin](https://github.com/samuelcolvin) in [#8023](https://github.com/pydantic/pydantic/pull/8023) +* Correct pydantic dataclasses import by [@samuelcolvin](https://github.com/samuelcolvin) in [#8027](https://github.com/pydantic/pydantic/pull/8027) +* Fix misbehavior for models referencing redefined type aliases by [@dmontagu](https://github.com/dmontagu) in [#8050](https://github.com/pydantic/pydantic/pull/8050) +* Fix `Optional` field with `validate_default` only performing one field validation by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/pydantic-core#1002](https://github.com/pydantic/pydantic-core/pull/1002) +* Fix `definition-ref` bug with `Dict` keys by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/pydantic-core#1014](https://github.com/pydantic/pydantic-core/pull/1014) +* Fix bug allowing validation of `bool` types with `coerce_numbers_to_str=True` by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/pydantic-core#1017](https://github.com/pydantic/pydantic-core/pull/1017) +* Don't accept `NaN` in float and decimal constraints by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/pydantic-core#1037](https://github.com/pydantic/pydantic-core/pull/1037) +* Add `lax_str` and `lax_int` support for enum values not inherited from str/int by [@michaelhly](https://github.com/michaelhly) in [pydantic/pydantic-core#1015](https://github.com/pydantic/pydantic-core/pull/1015) +* Support subclasses in lists in `Union` of `List` types by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/pydantic-core#1039](https://github.com/pydantic/pydantic-core/pull/1039) +* Allow validation against `max_digits` and `decimals` to pass if normalized or non-normalized input is valid by [@sydney-runkle](https://github.com/sydney-runkle) in [pydantic/pydantic-core#1049](https://github.com/pydantic/pydantic-core/pull/1049) +* Fix: proper pluralization in `ValidationError` messages by [@Iipin](https://github.com/Iipin) in [pydantic/pydantic-core#1050](https://github.com/pydantic/pydantic-core/pull/1050) +* Disallow the string `'-'` as `datetime` input by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/speedate#52](https://github.com/pydantic/speedate/pull/52) & [pydantic/pydantic-core#1060](https://github.com/pydantic/pydantic-core/pull/1060) +* Fix: NaN and Inf float serialization by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/pydantic-core#1062](https://github.com/pydantic/pydantic-core/pull/1062) +* Restore manylinux-compatible PGO builds by [@davidhewitt](https://github.com/davidhewitt) in [pydantic/pydantic-core#1068](https://github.com/pydantic/pydantic-core/pull/1068) + +### New Contributors + +#### `pydantic` +* [@schneebuzz](https://github.com/schneebuzz) made their first contribution in [#7699](https://github.com/pydantic/pydantic/pull/7699) +* [@edoakes](https://github.com/edoakes) made their first contribution in [#7780](https://github.com/pydantic/pydantic/pull/7780) +* [@alexmojaki](https://github.com/alexmojaki) made their first contribution in [#7775](https://github.com/pydantic/pydantic/pull/7775) +* [@NickG123](https://github.com/NickG123) made their first contribution in [#7751](https://github.com/pydantic/pydantic/pull/7751) +* [@gowthamgts](https://github.com/gowthamgts) made their first contribution in [#7830](https://github.com/pydantic/pydantic/pull/7830) +* [@jamesbraza](https://github.com/jamesbraza) made their first contribution in [#7848](https://github.com/pydantic/pydantic/pull/7848) +* [@laundmo](https://github.com/laundmo) made their first contribution in [#7850](https://github.com/pydantic/pydantic/pull/7850) +* [@rahmatnazali](https://github.com/rahmatnazali) made their first contribution in [#7870](https://github.com/pydantic/pydantic/pull/7870) +* [@waterfountain1996](https://github.com/waterfountain1996) made their first contribution in [#7878](https://github.com/pydantic/pydantic/pull/7878) +* [@chris-spann](https://github.com/chris-spann) made their first contribution in [#7863](https://github.com/pydantic/pydantic/pull/7863) +* [@me-and](https://github.com/me-and) made their first contribution in [#7810](https://github.com/pydantic/pydantic/pull/7810) +* [@utkini](https://github.com/utkini) made their first contribution in [#7768](https://github.com/pydantic/pydantic/pull/7768) +* [@bn-l](https://github.com/bn-l) made their first contribution in [#7744](https://github.com/pydantic/pydantic/pull/7744) +* [@alexdrydew](https://github.com/alexdrydew) made their first contribution in [#7893](https://github.com/pydantic/pydantic/pull/7893) +* [@Luca-Blight](https://github.com/Luca-Blight) made their first contribution in [#7930](https://github.com/pydantic/pydantic/pull/7930) +* [@howsunjow](https://github.com/howsunjow) made their first contribution in [#7925](https://github.com/pydantic/pydantic/pull/7925) +* [@joakimnordling](https://github.com/joakimnordling) made their first contribution in [#7881](https://github.com/pydantic/pydantic/pull/7881) +* [@icfly2](https://github.com/icfly2) made their first contribution in [#7976](https://github.com/pydantic/pydantic/pull/7976) +* [@Yummy-Yums](https://github.com/Yummy-Yums) made their first contribution in [#8003](https://github.com/pydantic/pydantic/pull/8003) +* [@Iipin](https://github.com/Iipin) made their first contribution in [#7972](https://github.com/pydantic/pydantic/pull/7972) +* [@tabassco](https://github.com/tabassco) made their first contribution in [#8004](https://github.com/pydantic/pydantic/pull/8004) +* [@Mr-Pepe](https://github.com/Mr-Pepe) made their first contribution in [#7979](https://github.com/pydantic/pydantic/pull/7979) +* [@0x00cl](https://github.com/0x00cl) made their first contribution in [#8010](https://github.com/pydantic/pydantic/pull/8010) +* [@barraponto](https://github.com/barraponto) made their first contribution in [#8032](https://github.com/pydantic/pydantic/pull/8032) + +#### `pydantic-core` +* [@sisp](https://github.com/sisp) made their first contribution in [pydantic/pydantic-core#995](https://github.com/pydantic/pydantic-core/pull/995) +* [@michaelhly](https://github.com/michaelhly) made their first contribution in [pydantic/pydantic-core#1015](https://github.com/pydantic/pydantic-core/pull/1015) + +## v2.5.0b1 (2023-11-09) + +Pre-release, see [the GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.5.0b1) for details. + +## v2.4.2 (2023-09-27) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.4.2) + +### What's Changed + +#### Fixes + +* Fix bug with JSON schema for sequence of discriminated union by [@dmontagu](https://github.com/dmontagu) in [#7647](https://github.com/pydantic/pydantic/pull/7647) +* Fix schema references in discriminated unions by [@adriangb](https://github.com/adriangb) in [#7646](https://github.com/pydantic/pydantic/pull/7646) +* Fix json schema generation for recursive models by [@adriangb](https://github.com/adriangb) in [#7653](https://github.com/pydantic/pydantic/pull/7653) +* Fix `models_json_schema` for generic models by [@adriangb](https://github.com/adriangb) in [#7654](https://github.com/pydantic/pydantic/pull/7654) +* Fix xfailed test for generic model signatures by [@adriangb](https://github.com/adriangb) in [#7658](https://github.com/pydantic/pydantic/pull/7658) + +### New Contributors + +* [@austinorr](https://github.com/austinorr) made their first contribution in [#7657](https://github.com/pydantic/pydantic/pull/7657) +* [@peterHoburg](https://github.com/peterHoburg) made their first contribution in [#7670](https://github.com/pydantic/pydantic/pull/7670) + +## v2.4.1 (2023-09-26) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.4.1) + +### What's Changed + +#### Packaging + +* Update pydantic-core to 2.10.1 by [@davidhewitt](https://github.com/davidhewitt) in [#7633](https://github.com/pydantic/pydantic/pull/7633) + +#### Fixes + +* Serialize unsubstituted type vars as `Any` by [@adriangb](https://github.com/adriangb) in [#7606](https://github.com/pydantic/pydantic/pull/7606) +* Remove schema building caches by [@adriangb](https://github.com/adriangb) in [#7624](https://github.com/pydantic/pydantic/pull/7624) +* Fix an issue where JSON schema extras weren't JSON encoded by [@dmontagu](https://github.com/dmontagu) in [#7625](https://github.com/pydantic/pydantic/pull/7625) + +## v2.4.0 (2023-09-22) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.4.0) + +### What's Changed + +#### Packaging + +* Update pydantic-core to 2.10.0 by [@samuelcolvin](https://github.com/samuelcolvin) in [#7542](https://github.com/pydantic/pydantic/pull/7542) + +#### New Features + +* Add `Base64Url` types by [@dmontagu](https://github.com/dmontagu) in [#7286](https://github.com/pydantic/pydantic/pull/7286) +* Implement optional `number` to `str` coercion by [@lig](https://github.com/lig) in [#7508](https://github.com/pydantic/pydantic/pull/7508) +* Allow access to `field_name` and `data` in all validators if there is data and a field name by [@samuelcolvin](https://github.com/samuelcolvin) in [#7542](https://github.com/pydantic/pydantic/pull/7542) +* Add `BaseModel.model_validate_strings` and `TypeAdapter.validate_strings` by [@hramezani](https://github.com/hramezani) in [#7552](https://github.com/pydantic/pydantic/pull/7552) +* Add Pydantic `plugins` experimental implementation by [@lig](https://github.com/lig) [@samuelcolvin](https://github.com/samuelcolvin) and [@Kludex](https://github.com/Kludex) in [#6820](https://github.com/pydantic/pydantic/pull/6820) + +#### Changes + +* Do not override `model_post_init` in subclass with private attrs by [@Viicos](https://github.com/Viicos) in [#7302](https://github.com/pydantic/pydantic/pull/7302) +* Make fields with defaults not required in the serialization schema by default by [@dmontagu](https://github.com/dmontagu) in [#7275](https://github.com/pydantic/pydantic/pull/7275) +* Mark `Extra` as deprecated by [@disrupted](https://github.com/disrupted) in [#7299](https://github.com/pydantic/pydantic/pull/7299) +* Make `EncodedStr` a dataclass by [@Kludex](https://github.com/Kludex) in [#7396](https://github.com/pydantic/pydantic/pull/7396) +* Move `annotated_handlers` to be public by [@samuelcolvin](https://github.com/samuelcolvin) in [#7569](https://github.com/pydantic/pydantic/pull/7569) + +#### Performance + +* Simplify flattening and inlining of `CoreSchema` by [@adriangb](https://github.com/adriangb) in [#7523](https://github.com/pydantic/pydantic/pull/7523) +* Remove unused copies in `CoreSchema` walking by [@adriangb](https://github.com/adriangb) in [#7528](https://github.com/pydantic/pydantic/pull/7528) +* Add caches for collecting definitions and invalid schemas from a CoreSchema by [@adriangb](https://github.com/adriangb) in [#7527](https://github.com/pydantic/pydantic/pull/7527) +* Eagerly resolve discriminated unions and cache cases where we can't by [@adriangb](https://github.com/adriangb) in [#7529](https://github.com/pydantic/pydantic/pull/7529) +* Replace `dict.get` and `dict.setdefault` with more verbose versions in `CoreSchema` building hot paths by [@adriangb](https://github.com/adriangb) in [#7536](https://github.com/pydantic/pydantic/pull/7536) +* Cache invalid `CoreSchema` discovery by [@adriangb](https://github.com/adriangb) in [#7535](https://github.com/pydantic/pydantic/pull/7535) +* Allow disabling `CoreSchema` validation for faster startup times by [@adriangb](https://github.com/adriangb) in [#7565](https://github.com/pydantic/pydantic/pull/7565) + +#### Fixes + +* Fix config detection for `TypedDict` from grandparent classes by [@dmontagu](https://github.com/dmontagu) in [#7272](https://github.com/pydantic/pydantic/pull/7272) +* Fix hash function generation for frozen models with unusual MRO by [@dmontagu](https://github.com/dmontagu) in [#7274](https://github.com/pydantic/pydantic/pull/7274) +* Make `strict` config overridable in field for Path by [@hramezani](https://github.com/hramezani) in [#7281](https://github.com/pydantic/pydantic/pull/7281) +* Use `ser_json_` on default in `GenerateJsonSchema` by [@Kludex](https://github.com/Kludex) in [#7269](https://github.com/pydantic/pydantic/pull/7269) +* Adding a check that alias is validated as an identifier for Python by [@andree0](https://github.com/andree0) in [#7319](https://github.com/pydantic/pydantic/pull/7319) +* Raise an error when computed field overrides field by [@sydney-runkle](https://github.com/sydney-runkle) in [#7346](https://github.com/pydantic/pydantic/pull/7346) +* Fix applying `SkipValidation` to referenced schemas by [@adriangb](https://github.com/adriangb) in [#7381](https://github.com/pydantic/pydantic/pull/7381) +* Enforce behavior of private attributes having double leading underscore by [@lig](https://github.com/lig) in [#7265](https://github.com/pydantic/pydantic/pull/7265) +* Standardize `__get_pydantic_core_schema__` signature by [@hramezani](https://github.com/hramezani) in [#7415](https://github.com/pydantic/pydantic/pull/7415) +* Fix generic dataclass fields mutation bug (when using `TypeAdapter`) by [@sydney-runkle](https://github.com/sydney-runkle) in [#7435](https://github.com/pydantic/pydantic/pull/7435) +* Fix `TypeError` on `model_validator` in `wrap` mode by [@pmmmwh](https://github.com/pmmmwh) in [#7496](https://github.com/pydantic/pydantic/pull/7496) +* Improve enum error message by [@hramezani](https://github.com/hramezani) in [#7506](https://github.com/pydantic/pydantic/pull/7506) +* Make `repr` work for instances that failed initialization when handling `ValidationError`s by [@dmontagu](https://github.com/dmontagu) in [#7439](https://github.com/pydantic/pydantic/pull/7439) +* Fixed a regular expression denial of service issue by limiting whitespaces by [@prodigysml](https://github.com/prodigysml) in [#7360](https://github.com/pydantic/pydantic/pull/7360) +* Fix handling of `UUID` values having `UUID.version=None` by [@lig](https://github.com/lig) in [#7566](https://github.com/pydantic/pydantic/pull/7566) +* Fix `__iter__` returning private `cached_property` info by [@sydney-runkle](https://github.com/sydney-runkle) in [#7570](https://github.com/pydantic/pydantic/pull/7570) +* Improvements to version info message by [@samuelcolvin](https://github.com/samuelcolvin) in [#7594](https://github.com/pydantic/pydantic/pull/7594) + +### New Contributors +* [@15498th](https://github.com/15498th) made their first contribution in [#7238](https://github.com/pydantic/pydantic/pull/7238) +* [@GabrielCappelli](https://github.com/GabrielCappelli) made their first contribution in [#7213](https://github.com/pydantic/pydantic/pull/7213) +* [@tobni](https://github.com/tobni) made their first contribution in [#7184](https://github.com/pydantic/pydantic/pull/7184) +* [@redruin1](https://github.com/redruin1) made their first contribution in [#7282](https://github.com/pydantic/pydantic/pull/7282) +* [@FacerAin](https://github.com/FacerAin) made their first contribution in [#7288](https://github.com/pydantic/pydantic/pull/7288) +* [@acdha](https://github.com/acdha) made their first contribution in [#7297](https://github.com/pydantic/pydantic/pull/7297) +* [@andree0](https://github.com/andree0) made their first contribution in [#7319](https://github.com/pydantic/pydantic/pull/7319) +* [@gordonhart](https://github.com/gordonhart) made their first contribution in [#7375](https://github.com/pydantic/pydantic/pull/7375) +* [@pmmmwh](https://github.com/pmmmwh) made their first contribution in [#7496](https://github.com/pydantic/pydantic/pull/7496) +* [@disrupted](https://github.com/disrupted) made their first contribution in [#7299](https://github.com/pydantic/pydantic/pull/7299) +* [@prodigysml](https://github.com/prodigysml) made their first contribution in [#7360](https://github.com/pydantic/pydantic/pull/7360) + +## v2.3.0 (2023-08-23) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.3.0) + +* 🔥 Remove orphaned changes file from repo by [@lig](https://github.com/lig) in [#7168](https://github.com/pydantic/pydantic/pull/7168) +* Add copy button on documentation by [@Kludex](https://github.com/Kludex) in [#7190](https://github.com/pydantic/pydantic/pull/7190) +* Fix docs on JSON type by [@Kludex](https://github.com/Kludex) in [#7189](https://github.com/pydantic/pydantic/pull/7189) +* Update mypy 1.5.0 to 1.5.1 in CI by [@hramezani](https://github.com/hramezani) in [#7191](https://github.com/pydantic/pydantic/pull/7191) +* fix download links badge by [@samuelcolvin](https://github.com/samuelcolvin) in [#7200](https://github.com/pydantic/pydantic/pull/7200) +* add 2.2.1 to changelog by [@samuelcolvin](https://github.com/samuelcolvin) in [#7212](https://github.com/pydantic/pydantic/pull/7212) +* Make ModelWrapValidator protocols generic by [@dmontagu](https://github.com/dmontagu) in [#7154](https://github.com/pydantic/pydantic/pull/7154) +* Correct `Field(..., exclude: bool)` docs by [@samuelcolvin](https://github.com/samuelcolvin) in [#7214](https://github.com/pydantic/pydantic/pull/7214) +* Make shadowing attributes a warning instead of an error by [@adriangb](https://github.com/adriangb) in [#7193](https://github.com/pydantic/pydantic/pull/7193) +* Document `Base64Str` and `Base64Bytes` by [@Kludex](https://github.com/Kludex) in [#7192](https://github.com/pydantic/pydantic/pull/7192) +* Fix `config.defer_build` for serialization first cases by [@samuelcolvin](https://github.com/samuelcolvin) in [#7024](https://github.com/pydantic/pydantic/pull/7024) +* clean Model docstrings in JSON Schema by [@samuelcolvin](https://github.com/samuelcolvin) in [#7210](https://github.com/pydantic/pydantic/pull/7210) +* fix [#7228](https://github.com/pydantic/pydantic/pull/7228) (typo): docs in `validators.md` to correct `validate_default` kwarg by [@lmmx](https://github.com/lmmx) in [#7229](https://github.com/pydantic/pydantic/pull/7229) +* ✅ Implement `tzinfo.fromutc` method for `TzInfo` in `pydantic-core` by [@lig](https://github.com/lig) in [#7019](https://github.com/pydantic/pydantic/pull/7019) +* Support `__get_validators__` by [@hramezani](https://github.com/hramezani) in [#7197](https://github.com/pydantic/pydantic/pull/7197) + +## v2.2.1 (2023-08-18) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.2.1) + +* Make `xfail`ing test for root model extra stop `xfail`ing by [@dmontagu](https://github.com/dmontagu) in [#6937](https://github.com/pydantic/pydantic/pull/6937) +* Optimize recursion detection by stopping on the second visit for the same object by [@mciucu](https://github.com/mciucu) in [#7160](https://github.com/pydantic/pydantic/pull/7160) +* fix link in docs by [@tlambert03](https://github.com/tlambert03) in [#7166](https://github.com/pydantic/pydantic/pull/7166) +* Replace MiMalloc w/ default allocator by [@adriangb](https://github.com/adriangb) in [pydantic/pydantic-core#900](https://github.com/pydantic/pydantic-core/pull/900) +* Bump pydantic-core to 2.6.1 and prepare 2.2.1 release by [@adriangb](https://github.com/adriangb) in [#7176](https://github.com/pydantic/pydantic/pull/7176) + +## v2.2.0 (2023-08-17) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.2.0) + +* Split "pipx install" setup command into two commands on the documentation site by [@nomadmtb](https://github.com/nomadmtb) in [#6869](https://github.com/pydantic/pydantic/pull/6869) +* Deprecate `Field.include` by [@hramezani](https://github.com/hramezani) in [#6852](https://github.com/pydantic/pydantic/pull/6852) +* Fix typo in default factory error msg by [@hramezani](https://github.com/hramezani) in [#6880](https://github.com/pydantic/pydantic/pull/6880) +* Simplify handling of typing.Annotated in GenerateSchema by [@dmontagu](https://github.com/dmontagu) in [#6887](https://github.com/pydantic/pydantic/pull/6887) +* Re-enable fastapi tests in CI by [@dmontagu](https://github.com/dmontagu) in [#6883](https://github.com/pydantic/pydantic/pull/6883) +* Make it harder to hit collisions with json schema defrefs by [@dmontagu](https://github.com/dmontagu) in [#6566](https://github.com/pydantic/pydantic/pull/6566) +* Cleaner error for invalid input to `Path` fields by [@samuelcolvin](https://github.com/samuelcolvin) in [#6903](https://github.com/pydantic/pydantic/pull/6903) +* :memo: support Coordinate Type by [@yezz123](https://github.com/yezz123) in [#6906](https://github.com/pydantic/pydantic/pull/6906) +* Fix `ForwardRef` wrapper for py 3.10.0 (shim until bpo-45166) by [@randomir](https://github.com/randomir) in [#6919](https://github.com/pydantic/pydantic/pull/6919) +* Fix misbehavior related to copying of RootModel by [@dmontagu](https://github.com/dmontagu) in [#6918](https://github.com/pydantic/pydantic/pull/6918) +* Fix issue with recursion error caused by ParamSpec by [@dmontagu](https://github.com/dmontagu) in [#6923](https://github.com/pydantic/pydantic/pull/6923) +* Add section about Constrained classes to the Migration Guide by [@Kludex](https://github.com/Kludex) in [#6924](https://github.com/pydantic/pydantic/pull/6924) +* Use `main` branch for badge links by [@Viicos](https://github.com/Viicos) in [#6925](https://github.com/pydantic/pydantic/pull/6925) +* Add test for v1/v2 Annotated discrepancy by [@carlbordum](https://github.com/carlbordum) in [#6926](https://github.com/pydantic/pydantic/pull/6926) +* Make the v1 mypy plugin work with both v1 and v2 by [@dmontagu](https://github.com/dmontagu) in [#6921](https://github.com/pydantic/pydantic/pull/6921) +* Fix issue where generic models couldn't be parametrized with BaseModel by [@dmontagu](https://github.com/dmontagu) in [#6933](https://github.com/pydantic/pydantic/pull/6933) +* Remove xfail for discriminated union with alias by [@dmontagu](https://github.com/dmontagu) in [#6938](https://github.com/pydantic/pydantic/pull/6938) +* add field_serializer to computed_field by [@andresliszt](https://github.com/andresliszt) in [#6965](https://github.com/pydantic/pydantic/pull/6965) +* Use union_schema with Type[Union[...]] by [@JeanArhancet](https://github.com/JeanArhancet) in [#6952](https://github.com/pydantic/pydantic/pull/6952) +* Fix inherited typeddict attributes / config by [@adriangb](https://github.com/adriangb) in [#6981](https://github.com/pydantic/pydantic/pull/6981) +* fix dataclass annotated before validator called twice by [@davidhewitt](https://github.com/davidhewitt) in [#6998](https://github.com/pydantic/pydantic/pull/6998) +* Update test-fastapi deselected tests by [@hramezani](https://github.com/hramezani) in [#7014](https://github.com/pydantic/pydantic/pull/7014) +* Fix validator doc format by [@hramezani](https://github.com/hramezani) in [#7015](https://github.com/pydantic/pydantic/pull/7015) +* Fix typo in docstring of model_json_schema by [@AdamVinch-Federated](https://github.com/AdamVinch-Federated) in [#7032](https://github.com/pydantic/pydantic/pull/7032) +* remove unused "type ignores" with pyright by [@samuelcolvin](https://github.com/samuelcolvin) in [#7026](https://github.com/pydantic/pydantic/pull/7026) +* Add benchmark representing FastAPI startup time by [@adriangb](https://github.com/adriangb) in [#7030](https://github.com/pydantic/pydantic/pull/7030) +* Fix json_encoders for Enum subclasses by [@adriangb](https://github.com/adriangb) in [#7029](https://github.com/pydantic/pydantic/pull/7029) +* Update docstring of `ser_json_bytes` regarding base64 encoding by [@Viicos](https://github.com/Viicos) in [#7052](https://github.com/pydantic/pydantic/pull/7052) +* Allow `@validate_call` to work on async methods by [@adriangb](https://github.com/adriangb) in [#7046](https://github.com/pydantic/pydantic/pull/7046) +* Fix: mypy error with `Settings` and `SettingsConfigDict` by [@JeanArhancet](https://github.com/JeanArhancet) in [#7002](https://github.com/pydantic/pydantic/pull/7002) +* Fix some typos (repeated words and it's/its) by [@eumiro](https://github.com/eumiro) in [#7063](https://github.com/pydantic/pydantic/pull/7063) +* Fix the typo in docstring by [@harunyasar](https://github.com/harunyasar) in [#7062](https://github.com/pydantic/pydantic/pull/7062) +* Docs: Fix broken URL in the pydantic-settings package recommendation by [@swetjen](https://github.com/swetjen) in [#6995](https://github.com/pydantic/pydantic/pull/6995) +* Handle constraints being applied to schemas that don't accept it by [@adriangb](https://github.com/adriangb) in [#6951](https://github.com/pydantic/pydantic/pull/6951) +* Replace almost_equal_floats with math.isclose by [@eumiro](https://github.com/eumiro) in [#7082](https://github.com/pydantic/pydantic/pull/7082) +* bump pydantic-core to 2.5.0 by [@davidhewitt](https://github.com/davidhewitt) in [#7077](https://github.com/pydantic/pydantic/pull/7077) +* Add `short_version` and use it in links by [@hramezani](https://github.com/hramezani) in [#7115](https://github.com/pydantic/pydantic/pull/7115) +* 📝 Add usage link to `RootModel` by [@Kludex](https://github.com/Kludex) in [#7113](https://github.com/pydantic/pydantic/pull/7113) +* Revert "Fix default port for mongosrv DSNs (#6827)" by [@Kludex](https://github.com/Kludex) in [#7116](https://github.com/pydantic/pydantic/pull/7116) +* Clarify validate_default and _Unset handling in usage docs and migration guide by [@benbenbang](https://github.com/benbenbang) in [#6950](https://github.com/pydantic/pydantic/pull/6950) +* Tweak documentation of `Field.exclude` by [@Viicos](https://github.com/Viicos) in [#7086](https://github.com/pydantic/pydantic/pull/7086) +* Do not require `validate_assignment` to use `Field.frozen` by [@Viicos](https://github.com/Viicos) in [#7103](https://github.com/pydantic/pydantic/pull/7103) +* tweaks to `_core_utils` by [@samuelcolvin](https://github.com/samuelcolvin) in [#7040](https://github.com/pydantic/pydantic/pull/7040) +* Make DefaultDict working with set by [@hramezani](https://github.com/hramezani) in [#7126](https://github.com/pydantic/pydantic/pull/7126) +* Don't always require typing.Generic as a base for partially parametrized models by [@dmontagu](https://github.com/dmontagu) in [#7119](https://github.com/pydantic/pydantic/pull/7119) +* Fix issue with JSON schema incorrectly using parent class core schema by [@dmontagu](https://github.com/dmontagu) in [#7020](https://github.com/pydantic/pydantic/pull/7020) +* Fix xfailed test related to TypedDict and alias_generator by [@dmontagu](https://github.com/dmontagu) in [#6940](https://github.com/pydantic/pydantic/pull/6940) +* Improve error message for NameEmail by [@dmontagu](https://github.com/dmontagu) in [#6939](https://github.com/pydantic/pydantic/pull/6939) +* Fix generic computed fields by [@dmontagu](https://github.com/dmontagu) in [#6988](https://github.com/pydantic/pydantic/pull/6988) +* Reflect namedtuple default values during validation by [@dmontagu](https://github.com/dmontagu) in [#7144](https://github.com/pydantic/pydantic/pull/7144) +* Update dependencies, fix pydantic-core usage, fix CI issues by [@dmontagu](https://github.com/dmontagu) in [#7150](https://github.com/pydantic/pydantic/pull/7150) +* Add mypy 1.5.0 by [@hramezani](https://github.com/hramezani) in [#7118](https://github.com/pydantic/pydantic/pull/7118) +* Handle non-json native enum values by [@adriangb](https://github.com/adriangb) in [#7056](https://github.com/pydantic/pydantic/pull/7056) +* document `round_trip` in Json type documentation by [@jc-louis](https://github.com/jc-louis) in [#7137](https://github.com/pydantic/pydantic/pull/7137) +* Relax signature checks to better support builtins and C extension functions as validators by [@adriangb](https://github.com/adriangb) in [#7101](https://github.com/pydantic/pydantic/pull/7101) +* add union_mode='left_to_right' by [@davidhewitt](https://github.com/davidhewitt) in [#7151](https://github.com/pydantic/pydantic/pull/7151) +* Include an error message hint for inherited ordering by [@yvalencia91](https://github.com/yvalencia91) in [#7124](https://github.com/pydantic/pydantic/pull/7124) +* Fix one docs link and resolve some warnings for two others by [@dmontagu](https://github.com/dmontagu) in [#7153](https://github.com/pydantic/pydantic/pull/7153) +* Include Field extra keys name in warning by [@hramezani](https://github.com/hramezani) in [#7136](https://github.com/pydantic/pydantic/pull/7136) + +## v2.1.1 (2023-07-25) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.1.1) + +* Skip FieldInfo merging when unnecessary by [@dmontagu](https://github.com/dmontagu) in [#6862](https://github.com/pydantic/pydantic/pull/6862) + +## v2.1.0 (2023-07-25) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.1.0) + +* Add `StringConstraints` for use as Annotated metadata by [@adriangb](https://github.com/adriangb) in [#6605](https://github.com/pydantic/pydantic/pull/6605) +* Try to fix intermittently failing CI by [@adriangb](https://github.com/adriangb) in [#6683](https://github.com/pydantic/pydantic/pull/6683) +* Remove redundant example of optional vs default. by [@ehiggs-deliverect](https://github.com/ehiggs-deliverect) in [#6676](https://github.com/pydantic/pydantic/pull/6676) +* Docs update by [@samuelcolvin](https://github.com/samuelcolvin) in [#6692](https://github.com/pydantic/pydantic/pull/6692) +* Remove the Validate always section in validator docs by [@adriangb](https://github.com/adriangb) in [#6679](https://github.com/pydantic/pydantic/pull/6679) +* Fix recursion error in json schema generation by [@adriangb](https://github.com/adriangb) in [#6720](https://github.com/pydantic/pydantic/pull/6720) +* Fix incorrect subclass check for secretstr by [@AlexVndnblcke](https://github.com/AlexVndnblcke) in [#6730](https://github.com/pydantic/pydantic/pull/6730) +* update pdm / pdm lockfile to 2.8.0 by [@davidhewitt](https://github.com/davidhewitt) in [#6714](https://github.com/pydantic/pydantic/pull/6714) +* unpin pdm on more CI jobs by [@davidhewitt](https://github.com/davidhewitt) in [#6755](https://github.com/pydantic/pydantic/pull/6755) +* improve source locations for auxiliary packages in docs by [@davidhewitt](https://github.com/davidhewitt) in [#6749](https://github.com/pydantic/pydantic/pull/6749) +* Assume builtins don't accept an info argument by [@adriangb](https://github.com/adriangb) in [#6754](https://github.com/pydantic/pydantic/pull/6754) +* Fix bug where calling `help(BaseModelSubclass)` raises errors by [@hramezani](https://github.com/hramezani) in [#6758](https://github.com/pydantic/pydantic/pull/6758) +* Fix mypy plugin handling of `@model_validator(mode="after")` by [@ljodal](https://github.com/ljodal) in [#6753](https://github.com/pydantic/pydantic/pull/6753) +* update pydantic-core to 2.3.1 by [@davidhewitt](https://github.com/davidhewitt) in [#6756](https://github.com/pydantic/pydantic/pull/6756) +* Mypy plugin for settings by [@hramezani](https://github.com/hramezani) in [#6760](https://github.com/pydantic/pydantic/pull/6760) +* Use `contentSchema` keyword for JSON schema by [@dmontagu](https://github.com/dmontagu) in [#6715](https://github.com/pydantic/pydantic/pull/6715) +* fast-path checking finite decimals by [@davidhewitt](https://github.com/davidhewitt) in [#6769](https://github.com/pydantic/pydantic/pull/6769) +* Docs update by [@samuelcolvin](https://github.com/samuelcolvin) in [#6771](https://github.com/pydantic/pydantic/pull/6771) +* Improve json schema doc by [@hramezani](https://github.com/hramezani) in [#6772](https://github.com/pydantic/pydantic/pull/6772) +* Update validator docs by [@adriangb](https://github.com/adriangb) in [#6695](https://github.com/pydantic/pydantic/pull/6695) +* Fix typehint for wrap validator by [@dmontagu](https://github.com/dmontagu) in [#6788](https://github.com/pydantic/pydantic/pull/6788) +* 🐛 Fix validation warning for unions of Literal and other type by [@lig](https://github.com/lig) in [#6628](https://github.com/pydantic/pydantic/pull/6628) +* Update documentation for generics support in V2 by [@tpdorsey](https://github.com/tpdorsey) in [#6685](https://github.com/pydantic/pydantic/pull/6685) +* add pydantic-core build info to `version_info()` by [@samuelcolvin](https://github.com/samuelcolvin) in [#6785](https://github.com/pydantic/pydantic/pull/6785) +* Fix pydantic dataclasses that use slots with default values by [@dmontagu](https://github.com/dmontagu) in [#6796](https://github.com/pydantic/pydantic/pull/6796) +* Fix inheritance of hash function for frozen models by [@dmontagu](https://github.com/dmontagu) in [#6789](https://github.com/pydantic/pydantic/pull/6789) +* ✨ Add `SkipJsonSchema` annotation by [@Kludex](https://github.com/Kludex) in [#6653](https://github.com/pydantic/pydantic/pull/6653) +* Error if an invalid field name is used with Field by [@dmontagu](https://github.com/dmontagu) in [#6797](https://github.com/pydantic/pydantic/pull/6797) +* Add `GenericModel` to `MOVED_IN_V2` by [@adriangb](https://github.com/adriangb) in [#6776](https://github.com/pydantic/pydantic/pull/6776) +* Remove unused code from `docs/usage/types/custom.md` by [@hramezani](https://github.com/hramezani) in [#6803](https://github.com/pydantic/pydantic/pull/6803) +* Fix `float` -> `Decimal` coercion precision loss by [@adriangb](https://github.com/adriangb) in [#6810](https://github.com/pydantic/pydantic/pull/6810) +* remove email validation from the north star benchmark by [@davidhewitt](https://github.com/davidhewitt) in [#6816](https://github.com/pydantic/pydantic/pull/6816) +* Fix link to mypy by [@progsmile](https://github.com/progsmile) in [#6824](https://github.com/pydantic/pydantic/pull/6824) +* Improve initialization hooks example by [@hramezani](https://github.com/hramezani) in [#6822](https://github.com/pydantic/pydantic/pull/6822) +* Fix default port for mongosrv DSNs by [@dmontagu](https://github.com/dmontagu) in [#6827](https://github.com/pydantic/pydantic/pull/6827) +* Improve API documentation, in particular more links between usage and API docs by [@samuelcolvin](https://github.com/samuelcolvin) in [#6780](https://github.com/pydantic/pydantic/pull/6780) +* update pydantic-core to 2.4.0 by [@davidhewitt](https://github.com/davidhewitt) in [#6831](https://github.com/pydantic/pydantic/pull/6831) +* Fix `annotated_types.MaxLen` validator for custom sequence types by [@ImogenBits](https://github.com/ImogenBits) in [#6809](https://github.com/pydantic/pydantic/pull/6809) +* Update V1 by [@hramezani](https://github.com/hramezani) in [#6833](https://github.com/pydantic/pydantic/pull/6833) +* Make it so callable JSON schema extra works by [@dmontagu](https://github.com/dmontagu) in [#6798](https://github.com/pydantic/pydantic/pull/6798) +* Fix serialization issue with `InstanceOf` by [@dmontagu](https://github.com/dmontagu) in [#6829](https://github.com/pydantic/pydantic/pull/6829) +* Add back support for `json_encoders` by [@adriangb](https://github.com/adriangb) in [#6811](https://github.com/pydantic/pydantic/pull/6811) +* Update field annotations when building the schema by [@dmontagu](https://github.com/dmontagu) in [#6838](https://github.com/pydantic/pydantic/pull/6838) +* Use `WeakValueDictionary` to fix generic memory leak by [@dmontagu](https://github.com/dmontagu) in [#6681](https://github.com/pydantic/pydantic/pull/6681) +* Add `config.defer_build` to optionally make model building lazy by [@samuelcolvin](https://github.com/samuelcolvin) in [#6823](https://github.com/pydantic/pydantic/pull/6823) +* delegate `UUID` serialization to pydantic-core by [@davidhewitt](https://github.com/davidhewitt) in [#6850](https://github.com/pydantic/pydantic/pull/6850) +* Update `json_encoders` docs by [@adriangb](https://github.com/adriangb) in [#6848](https://github.com/pydantic/pydantic/pull/6848) +* Fix error message for `staticmethod`/`classmethod` order with validate_call by [@dmontagu](https://github.com/dmontagu) in [#6686](https://github.com/pydantic/pydantic/pull/6686) +* Improve documentation for `Config` by [@samuelcolvin](https://github.com/samuelcolvin) in [#6847](https://github.com/pydantic/pydantic/pull/6847) +* Update serialization doc to mention `Field.exclude` takes priority over call-time `include/exclude` by [@hramezani](https://github.com/hramezani) in [#6851](https://github.com/pydantic/pydantic/pull/6851) +* Allow customizing core schema generation by making `GenerateSchema` public by [@adriangb](https://github.com/adriangb) in [#6737](https://github.com/pydantic/pydantic/pull/6737) + +## v2.0.3 (2023-07-05) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.0.3) + +* Mention PyObject (v1) moving to ImportString (v2) in migration doc by [@slafs](https://github.com/slafs) in [#6456](https://github.com/pydantic/pydantic/pull/6456) +* Fix release-tweet CI by [@Kludex](https://github.com/Kludex) in [#6461](https://github.com/pydantic/pydantic/pull/6461) +* Revise the section on required / optional / nullable fields. by [@ybressler](https://github.com/ybressler) in [#6468](https://github.com/pydantic/pydantic/pull/6468) +* Warn if a type hint is not in fact a type by [@adriangb](https://github.com/adriangb) in [#6479](https://github.com/pydantic/pydantic/pull/6479) +* Replace TransformSchema with GetPydanticSchema by [@dmontagu](https://github.com/dmontagu) in [#6484](https://github.com/pydantic/pydantic/pull/6484) +* Fix the un-hashability of various annotation types, for use in caching generic containers by [@dmontagu](https://github.com/dmontagu) in [#6480](https://github.com/pydantic/pydantic/pull/6480) +* PYD-164: Rework custom types docs by [@adriangb](https://github.com/adriangb) in [#6490](https://github.com/pydantic/pydantic/pull/6490) +* Fix ci by [@adriangb](https://github.com/adriangb) in [#6507](https://github.com/pydantic/pydantic/pull/6507) +* Fix forward ref in generic by [@adriangb](https://github.com/adriangb) in [#6511](https://github.com/pydantic/pydantic/pull/6511) +* Fix generation of serialization JSON schemas for core_schema.ChainSchema by [@dmontagu](https://github.com/dmontagu) in [#6515](https://github.com/pydantic/pydantic/pull/6515) +* Document the change in `Field.alias` behavior in Pydantic V2 by [@hramezani](https://github.com/hramezani) in [#6508](https://github.com/pydantic/pydantic/pull/6508) +* Give better error message attempting to compute the json schema of a model with undefined fields by [@dmontagu](https://github.com/dmontagu) in [#6519](https://github.com/pydantic/pydantic/pull/6519) +* Document `alias_priority` by [@tpdorsey](https://github.com/tpdorsey) in [#6520](https://github.com/pydantic/pydantic/pull/6520) +* Add redirect for types documentation by [@tpdorsey](https://github.com/tpdorsey) in [#6513](https://github.com/pydantic/pydantic/pull/6513) +* Allow updating docs without release by [@samuelcolvin](https://github.com/samuelcolvin) in [#6551](https://github.com/pydantic/pydantic/pull/6551) +* Ensure docs tests always run in the right folder by [@dmontagu](https://github.com/dmontagu) in [#6487](https://github.com/pydantic/pydantic/pull/6487) +* Defer evaluation of return type hints for serializer functions by [@dmontagu](https://github.com/dmontagu) in [#6516](https://github.com/pydantic/pydantic/pull/6516) +* Disable E501 from Ruff and rely on just Black by [@adriangb](https://github.com/adriangb) in [#6552](https://github.com/pydantic/pydantic/pull/6552) +* Update JSON Schema documentation for V2 by [@tpdorsey](https://github.com/tpdorsey) in [#6492](https://github.com/pydantic/pydantic/pull/6492) +* Add documentation of cyclic reference handling by [@dmontagu](https://github.com/dmontagu) in [#6493](https://github.com/pydantic/pydantic/pull/6493) +* Remove the need for change files by [@samuelcolvin](https://github.com/samuelcolvin) in [#6556](https://github.com/pydantic/pydantic/pull/6556) +* add "north star" benchmark by [@davidhewitt](https://github.com/davidhewitt) in [#6547](https://github.com/pydantic/pydantic/pull/6547) +* Update Dataclasses docs by [@tpdorsey](https://github.com/tpdorsey) in [#6470](https://github.com/pydantic/pydantic/pull/6470) +* ♻️ Use different error message on v1 redirects by [@Kludex](https://github.com/Kludex) in [#6595](https://github.com/pydantic/pydantic/pull/6595) +* ⬆ Upgrade `pydantic-core` to v2.2.0 by [@lig](https://github.com/lig) in [#6589](https://github.com/pydantic/pydantic/pull/6589) +* Fix serialization for IPvAny by [@dmontagu](https://github.com/dmontagu) in [#6572](https://github.com/pydantic/pydantic/pull/6572) +* Improve CI by using PDM instead of pip to install typing-extensions by [@adriangb](https://github.com/adriangb) in [#6602](https://github.com/pydantic/pydantic/pull/6602) +* Add `enum` error type docs by [@lig](https://github.com/lig) in [#6603](https://github.com/pydantic/pydantic/pull/6603) +* 🐛 Fix `max_length` for unicode strings by [@lig](https://github.com/lig) in [#6559](https://github.com/pydantic/pydantic/pull/6559) +* Add documentation for accessing features via `pydantic.v1` by [@tpdorsey](https://github.com/tpdorsey) in [#6604](https://github.com/pydantic/pydantic/pull/6604) +* Include extra when iterating over a model by [@adriangb](https://github.com/adriangb) in [#6562](https://github.com/pydantic/pydantic/pull/6562) +* Fix typing of model_validator by [@adriangb](https://github.com/adriangb) in [#6514](https://github.com/pydantic/pydantic/pull/6514) +* Touch up Decimal validator by [@adriangb](https://github.com/adriangb) in [#6327](https://github.com/pydantic/pydantic/pull/6327) +* Fix various docstrings using fixed pytest-examples by [@dmontagu](https://github.com/dmontagu) in [#6607](https://github.com/pydantic/pydantic/pull/6607) +* Handle function validators in a discriminated union by [@dmontagu](https://github.com/dmontagu) in [#6570](https://github.com/pydantic/pydantic/pull/6570) +* Review json_schema.md by [@tpdorsey](https://github.com/tpdorsey) in [#6608](https://github.com/pydantic/pydantic/pull/6608) +* Make validate_call work on basemodel methods by [@dmontagu](https://github.com/dmontagu) in [#6569](https://github.com/pydantic/pydantic/pull/6569) +* add test for big int json serde by [@davidhewitt](https://github.com/davidhewitt) in [#6614](https://github.com/pydantic/pydantic/pull/6614) +* Fix pydantic dataclass problem with dataclasses.field default_factory by [@hramezani](https://github.com/hramezani) in [#6616](https://github.com/pydantic/pydantic/pull/6616) +* Fixed mypy type inference for TypeAdapter by [@zakstucke](https://github.com/zakstucke) in [#6617](https://github.com/pydantic/pydantic/pull/6617) +* Make it work to use None as a generic parameter by [@dmontagu](https://github.com/dmontagu) in [#6609](https://github.com/pydantic/pydantic/pull/6609) +* Make it work to use `$ref` as an alias by [@dmontagu](https://github.com/dmontagu) in [#6568](https://github.com/pydantic/pydantic/pull/6568) +* add note to migration guide about changes to `AnyUrl` etc by [@davidhewitt](https://github.com/davidhewitt) in [#6618](https://github.com/pydantic/pydantic/pull/6618) +* 🐛 Support defining `json_schema_extra` on `RootModel` using `Field` by [@lig](https://github.com/lig) in [#6622](https://github.com/pydantic/pydantic/pull/6622) +* Update pre-commit to prevent commits to main branch on accident by [@dmontagu](https://github.com/dmontagu) in [#6636](https://github.com/pydantic/pydantic/pull/6636) +* Fix PDM CI for python 3.7 on MacOS/windows by [@dmontagu](https://github.com/dmontagu) in [#6627](https://github.com/pydantic/pydantic/pull/6627) +* Produce more accurate signatures for pydantic dataclasses by [@dmontagu](https://github.com/dmontagu) in [#6633](https://github.com/pydantic/pydantic/pull/6633) +* Updates to Url types for Pydantic V2 by [@tpdorsey](https://github.com/tpdorsey) in [#6638](https://github.com/pydantic/pydantic/pull/6638) +* Fix list markdown in `transform` docstring by [@StefanBRas](https://github.com/StefanBRas) in [#6649](https://github.com/pydantic/pydantic/pull/6649) +* simplify slots_dataclass construction to appease mypy by [@davidhewitt](https://github.com/davidhewitt) in [#6639](https://github.com/pydantic/pydantic/pull/6639) +* Update TypedDict schema generation docstring by [@adriangb](https://github.com/adriangb) in [#6651](https://github.com/pydantic/pydantic/pull/6651) +* Detect and lint-error for prints by [@dmontagu](https://github.com/dmontagu) in [#6655](https://github.com/pydantic/pydantic/pull/6655) +* Add xfailing test for pydantic-core PR 766 by [@dmontagu](https://github.com/dmontagu) in [#6641](https://github.com/pydantic/pydantic/pull/6641) +* Ignore unrecognized fields from dataclasses metadata by [@dmontagu](https://github.com/dmontagu) in [#6634](https://github.com/pydantic/pydantic/pull/6634) +* Make non-existent class getattr a mypy error by [@dmontagu](https://github.com/dmontagu) in [#6658](https://github.com/pydantic/pydantic/pull/6658) +* Update pydantic-core to 2.3.0 by [@hramezani](https://github.com/hramezani) in [#6648](https://github.com/pydantic/pydantic/pull/6648) +* Use OrderedDict from typing_extensions by [@dmontagu](https://github.com/dmontagu) in [#6664](https://github.com/pydantic/pydantic/pull/6664) +* Fix typehint for JSON schema extra callable by [@dmontagu](https://github.com/dmontagu) in [#6659](https://github.com/pydantic/pydantic/pull/6659) + +## v2.0.2 (2023-07-05) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.0.2) + +* Fix bug where round-trip pickling/unpickling a `RootModel` would change the value of `__dict__`, [#6457](https://github.com/pydantic/pydantic/pull/6457) by [@dmontagu](https://github.com/dmontagu) +* Allow single-item discriminated unions, [#6405](https://github.com/pydantic/pydantic/pull/6405) by [@dmontagu](https://github.com/dmontagu) +* Fix issue with union parsing of enums, [#6440](https://github.com/pydantic/pydantic/pull/6440) by [@dmontagu](https://github.com/dmontagu) +* Docs: Fixed `constr` documentation, renamed old `regex` to new `pattern`, [#6452](https://github.com/pydantic/pydantic/pull/6452) by [@miili](https://github.com/miili) +* Change `GenerateJsonSchema.generate_definitions` signature, [#6436](https://github.com/pydantic/pydantic/pull/6436) by [@dmontagu](https://github.com/dmontagu) + +See the full changelog [here](https://github.com/pydantic/pydantic/releases/tag/v2.0.2) + +## v2.0.1 (2023-07-04) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.0.1) + +First patch release of Pydantic V2 + +* Extra fields added via `setattr` (i.e. `m.some_extra_field = 'extra_value'`) + are added to `.model_extra` if `model_config` `extra='allowed'`. Fixed [#6333](https://github.com/pydantic/pydantic/pull/6333), [#6365](https://github.com/pydantic/pydantic/pull/6365) by [@aaraney](https://github.com/aaraney) +* Automatically unpack JSON schema '$ref' for custom types, [#6343](https://github.com/pydantic/pydantic/pull/6343) by [@adriangb](https://github.com/adriangb) +* Fix tagged unions multiple processing in submodels, [#6340](https://github.com/pydantic/pydantic/pull/6340) by [@suharnikov](https://github.com/suharnikov) + +See the full changelog [here](https://github.com/pydantic/pydantic/releases/tag/v2.0.1) + +## v2.0 (2023-06-30) + +[GitHub release](https://github.com/pydantic/pydantic/releases/tag/v2.0) + +Pydantic V2 is here! :tada: + +See [this post](https://docs.pydantic.dev/2.0/blog/pydantic-v2-final/) for more details. + +## v2.0b3 (2023-06-16) + +Third beta pre-release of Pydantic V2 + +See the full changelog [here](https://github.com/pydantic/pydantic/releases/tag/v2.0b3) + +## v2.0b2 (2023-06-03) + +Add `from_attributes` runtime flag to `TypeAdapter.validate_python` and `BaseModel.model_validate`. + +See the full changelog [here](https://github.com/pydantic/pydantic/releases/tag/v2.0b2) + +## v2.0b1 (2023-06-01) + +First beta pre-release of Pydantic V2 + +See the full changelog [here](https://github.com/pydantic/pydantic/releases/tag/v2.0b1) + +## v2.0a4 (2023-05-05) + +Fourth pre-release of Pydantic V2 + +See the full changelog [here](https://github.com/pydantic/pydantic/releases/tag/v2.0a4) + +## v2.0a3 (2023-04-20) + +Third pre-release of Pydantic V2 + +See the full changelog [here](https://github.com/pydantic/pydantic/releases/tag/v2.0a3) + +## v2.0a2 (2023-04-12) + +Second pre-release of Pydantic V2 + +See the full changelog [here](https://github.com/pydantic/pydantic/releases/tag/v2.0a2) + +## v2.0a1 (2023-04-03) + +First pre-release of Pydantic V2! + +See [this post](https://docs.pydantic.dev/blog/pydantic-v2-alpha/) for more details. + + +... see [here](https://docs.pydantic.dev/changelog/#v0322-2019-08-17) for earlier changes. diff --git a/env/Lib/site-packages/pydantic-2.8.2.dist-info/RECORD b/env/Lib/site-packages/pydantic-2.8.2.dist-info/RECORD new file mode 100644 index 0000000..d60553f --- /dev/null +++ b/env/Lib/site-packages/pydantic-2.8.2.dist-info/RECORD @@ -0,0 +1,207 @@ +pydantic-2.8.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +pydantic-2.8.2.dist-info/METADATA,sha256=H8IPn6l33xNo3SR-xJDe1NhEYzxEsCIl2C2RkhQohu4,125181 +pydantic-2.8.2.dist-info/RECORD,, +pydantic-2.8.2.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87 +pydantic-2.8.2.dist-info/licenses/LICENSE,sha256=qeGG88oWte74QxjnpwFyE1GgDLe4rjpDlLZ7SeNSnvM,1129 +pydantic/__init__.py,sha256=UfcGIDJ0chxdnl0_o6dTyys-5isaoZwlKVMAwwBwPPo,13931 +pydantic/__pycache__/__init__.cpython-311.pyc,, +pydantic/__pycache__/_migration.cpython-311.pyc,, +pydantic/__pycache__/alias_generators.cpython-311.pyc,, +pydantic/__pycache__/aliases.cpython-311.pyc,, +pydantic/__pycache__/annotated_handlers.cpython-311.pyc,, +pydantic/__pycache__/class_validators.cpython-311.pyc,, +pydantic/__pycache__/color.cpython-311.pyc,, +pydantic/__pycache__/config.cpython-311.pyc,, +pydantic/__pycache__/dataclasses.cpython-311.pyc,, +pydantic/__pycache__/datetime_parse.cpython-311.pyc,, +pydantic/__pycache__/decorator.cpython-311.pyc,, +pydantic/__pycache__/env_settings.cpython-311.pyc,, +pydantic/__pycache__/error_wrappers.cpython-311.pyc,, +pydantic/__pycache__/errors.cpython-311.pyc,, +pydantic/__pycache__/fields.cpython-311.pyc,, +pydantic/__pycache__/functional_serializers.cpython-311.pyc,, +pydantic/__pycache__/functional_validators.cpython-311.pyc,, +pydantic/__pycache__/generics.cpython-311.pyc,, +pydantic/__pycache__/json.cpython-311.pyc,, +pydantic/__pycache__/json_schema.cpython-311.pyc,, +pydantic/__pycache__/main.cpython-311.pyc,, +pydantic/__pycache__/mypy.cpython-311.pyc,, +pydantic/__pycache__/networks.cpython-311.pyc,, +pydantic/__pycache__/parse.cpython-311.pyc,, +pydantic/__pycache__/root_model.cpython-311.pyc,, +pydantic/__pycache__/schema.cpython-311.pyc,, +pydantic/__pycache__/tools.cpython-311.pyc,, +pydantic/__pycache__/type_adapter.cpython-311.pyc,, +pydantic/__pycache__/types.cpython-311.pyc,, +pydantic/__pycache__/typing.cpython-311.pyc,, +pydantic/__pycache__/utils.cpython-311.pyc,, +pydantic/__pycache__/validate_call_decorator.cpython-311.pyc,, +pydantic/__pycache__/validators.cpython-311.pyc,, +pydantic/__pycache__/version.cpython-311.pyc,, +pydantic/__pycache__/warnings.cpython-311.pyc,, +pydantic/_internal/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pydantic/_internal/__pycache__/__init__.cpython-311.pyc,, +pydantic/_internal/__pycache__/_config.cpython-311.pyc,, +pydantic/_internal/__pycache__/_core_metadata.cpython-311.pyc,, +pydantic/_internal/__pycache__/_core_utils.cpython-311.pyc,, +pydantic/_internal/__pycache__/_dataclasses.cpython-311.pyc,, +pydantic/_internal/__pycache__/_decorators.cpython-311.pyc,, +pydantic/_internal/__pycache__/_decorators_v1.cpython-311.pyc,, +pydantic/_internal/__pycache__/_discriminated_union.cpython-311.pyc,, +pydantic/_internal/__pycache__/_docs_extraction.cpython-311.pyc,, +pydantic/_internal/__pycache__/_fields.cpython-311.pyc,, +pydantic/_internal/__pycache__/_forward_ref.cpython-311.pyc,, +pydantic/_internal/__pycache__/_generate_schema.cpython-311.pyc,, +pydantic/_internal/__pycache__/_generics.cpython-311.pyc,, +pydantic/_internal/__pycache__/_git.cpython-311.pyc,, +pydantic/_internal/__pycache__/_internal_dataclass.cpython-311.pyc,, +pydantic/_internal/__pycache__/_known_annotated_metadata.cpython-311.pyc,, +pydantic/_internal/__pycache__/_mock_val_ser.cpython-311.pyc,, +pydantic/_internal/__pycache__/_model_construction.cpython-311.pyc,, +pydantic/_internal/__pycache__/_repr.cpython-311.pyc,, +pydantic/_internal/__pycache__/_schema_generation_shared.cpython-311.pyc,, +pydantic/_internal/__pycache__/_signature.cpython-311.pyc,, +pydantic/_internal/__pycache__/_std_types_schema.cpython-311.pyc,, +pydantic/_internal/__pycache__/_typing_extra.cpython-311.pyc,, +pydantic/_internal/__pycache__/_utils.cpython-311.pyc,, +pydantic/_internal/__pycache__/_validate_call.cpython-311.pyc,, +pydantic/_internal/__pycache__/_validators.cpython-311.pyc,, +pydantic/_internal/_config.py,sha256=goVcoEMMsf2ltFE3WHTEiDvu6h5gPo01ZJ5h6PVQqrU,12605 +pydantic/_internal/_core_metadata.py,sha256=Da-e0-DXK__dJvog0e8CZLQ4r_k9RpldG6KQTGrYlHg,3521 +pydantic/_internal/_core_utils.py,sha256=6aD8J26n4_tP2R-Sermk66DGwHpFpksOrwHdI0O22jg,24268 +pydantic/_internal/_dataclasses.py,sha256=EvE43UHTVZZydVt8DjrkYLyciy5S46bXFgt8bsfWEWo,8733 +pydantic/_internal/_decorators.py,sha256=OnUIAbX_CTcHRXu4K5Qav8a5TC0YCXuwPq3bRiZQ04Y,31954 +pydantic/_internal/_decorators_v1.py,sha256=I7Px8gUMJod80_zBMlNkRVq0Mp2Z6mk1T1A4b_0a3Ps,6203 +pydantic/_internal/_discriminated_union.py,sha256=XDzlfKc7LAkJJErQWAZ4EuP_G_CQXJSVFKtwuHRJEmg,26435 +pydantic/_internal/_docs_extraction.py,sha256=bIWhw7nFKFt-qD-txtKRAb5VqGlAD0H9YzEEXE3PHj4,3791 +pydantic/_internal/_fields.py,sha256=_CCzAro7gGA3wsfUVDuRK9Tcrp-EMzH5ddyQ5JfgWQg,14934 +pydantic/_internal/_forward_ref.py,sha256=5n3Y7-3AKLn8_FS3Yc7KutLiPUhyXmAtkEZOaFnonwM,611 +pydantic/_internal/_generate_schema.py,sha256=JWt_d7_bQw_XaLzPAWV_Crvi_3N1N-usAt2lrUGj5BQ,105375 +pydantic/_internal/_generics.py,sha256=56zgcmvHOMQIXTn0r2aKfoFOvpBuFiWKfBu_dXnESig,22206 +pydantic/_internal/_git.py,sha256=lN6QlZm8RNSuNsUdHHC1F5a4VToe8vu5tlUxAfaJgGE,784 +pydantic/_internal/_internal_dataclass.py,sha256=_bedc1XbuuygRGiLZqkUkwwFpQaoR1hKLlR501nyySY,144 +pydantic/_internal/_known_annotated_metadata.py,sha256=qZDjQsw7bZiqzvzY_th2VLfG0KswT22twwYHp4QmE0s,14189 +pydantic/_internal/_mock_val_ser.py,sha256=g_RJhhodJOWnIrxwYRGNGA1v21eh5UrlfTP-7-ommMw,7315 +pydantic/_internal/_model_construction.py,sha256=nloFfqqBmPVomMYeefeEC_95tuTfq4jyDTW_iZfR-bo,31361 +pydantic/_internal/_repr.py,sha256=OxFN-gJMTefCv1yjsi5SRogstTMxRLhhTKCmR8jyJNU,4569 +pydantic/_internal/_schema_generation_shared.py,sha256=SB5kMqd9pzW9V4M4qjyI7R99MHzU1rfQVkNWP-KsiLM,4853 +pydantic/_internal/_signature.py,sha256=gJvpQ9vklQuYfYKI4d0zvHOGhCR44Oa_xltdMUMg59g,6293 +pydantic/_internal/_std_types_schema.py,sha256=3kvNnWRKmaB9RworxQoMaXRUHdMfSHV5bFz9AN6t6k8,28881 +pydantic/_internal/_typing_extra.py,sha256=9dD-4bReZ-FSBzjrvFKMY3aQXvEGcwOdcwClf5ypn84,19430 +pydantic/_internal/_utils.py,sha256=DM-CdDvaCd136ZFIJxvjgaNuaM6oYjYzif-nExcwL1k,12661 +pydantic/_internal/_validate_call.py,sha256=2kLSQjH1NB0d3PKv6JiujcqO8s7mKiyI5CvyOLcz6U0,3791 +pydantic/_internal/_validators.py,sha256=yi301I0sLQAfXWtq92jUwX2og1axVsXvDrR-psPu3Po,11118 +pydantic/_migration.py,sha256=j6TbRpJofjAX8lr-k2nVnQcBR9RD2B91I7Ulcw_ZzEo,11913 +pydantic/alias_generators.py,sha256=KM1n3u4JfLSBl1UuYg3hoYHzXJD-yvgrnq8u1ccwh_A,2124 +pydantic/aliases.py,sha256=X34YwPmkWSXTqaiVisRnxoPXcMbceeDZhMsMPxnOZyk,4819 +pydantic/annotated_handlers.py,sha256=yCeE8kQnLxZCWzT8f689hvwqqepEBW_byDUpVRJwnrM,4353 +pydantic/class_validators.py,sha256=i_V3j-PYdGLSLmj_IJZekTRjunO8SIVz8LMlquPyP7E,148 +pydantic/color.py,sha256=4GrtPvFCBKdM-1NpLVFOC7KkLejyZd1BiELfCKvT2yw,21494 +pydantic/config.py,sha256=9I5EyqzBKvFtlpoIxkrtMu2oxvYhENPaNBA532q2Ahc,35112 +pydantic/dataclasses.py,sha256=wEPHOsFGBjH2wsi2woff7SpwYm_2b_28-Yv-cYIvNOc,13909 +pydantic/datetime_parse.py,sha256=QC-WgMxMr_wQ_mNXUS7AVf-2hLEhvvsPY1PQyhSGOdk,150 +pydantic/decorator.py,sha256=YX-jUApu5AKaVWKPoaV-n-4l7UbS69GEt9Ra3hszmKI,145 +pydantic/deprecated/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pydantic/deprecated/__pycache__/__init__.cpython-311.pyc,, +pydantic/deprecated/__pycache__/class_validators.cpython-311.pyc,, +pydantic/deprecated/__pycache__/config.cpython-311.pyc,, +pydantic/deprecated/__pycache__/copy_internals.cpython-311.pyc,, +pydantic/deprecated/__pycache__/decorator.cpython-311.pyc,, +pydantic/deprecated/__pycache__/json.cpython-311.pyc,, +pydantic/deprecated/__pycache__/parse.cpython-311.pyc,, +pydantic/deprecated/__pycache__/tools.cpython-311.pyc,, +pydantic/deprecated/class_validators.py,sha256=Wt68ZLT5cQe_BwOsxNzlS9YRSxY1LrQ0XC0e9ejuv70,10254 +pydantic/deprecated/config.py,sha256=eKhnG--ZQtJ4A7KA3xeF76E15-4pVau3B5T8D39ptFs,2663 +pydantic/deprecated/copy_internals.py,sha256=SoUj1MevXt3fnloqNg5wivSUHSDPnuSj_YydzkEMzu0,7595 +pydantic/deprecated/decorator.py,sha256=P2V1bCwk8wNJ3g_s2p2ASFefXPLKn8bsUVw-Y8Wwcvk,10776 +pydantic/deprecated/json.py,sha256=Cn4f5r4JR3ondHQN-jpBSQC57nvnSNIbqXl3tcBcEx0,4596 +pydantic/deprecated/parse.py,sha256=Gzd6b_g8zJXcuE7QRq5adhx_EMJahXfcpXCF0RgrqqI,2511 +pydantic/deprecated/tools.py,sha256=XUoIW9W4sgOUWQ6Xzf-Z_NukUC1l_yUwz2_n0fE3MEI,3336 +pydantic/env_settings.py,sha256=6IHeeWEqlUPRUv3V-AXiF_W91fg2Jw_M3O0l34J_eyA,148 +pydantic/error_wrappers.py,sha256=RK6mqATc9yMD-KBD9IJS9HpKCprWHd8wo84Bnm-3fR8,150 +pydantic/errors.py,sha256=ht5bwtXWzq2DrwIVI7pU0tk9IAUjQjcVgPBULEXXMCk,4835 +pydantic/experimental/__init__.py,sha256=j08eROfz-xW4k_X9W4m2AW26IVdyF3Eg1OzlIGA11vk,328 +pydantic/experimental/__pycache__/__init__.cpython-311.pyc,, +pydantic/experimental/__pycache__/pipeline.cpython-311.pyc,, +pydantic/experimental/pipeline.py,sha256=PjiTnmaN5XwLUk-Nlzfr2C2R-xrMz7Nz-XVC8kiFGyU,23979 +pydantic/fields.py,sha256=zez1lSdoSZm3fN7AK3htTtqyt3iO7FIBf5aRVddRUC8,51746 +pydantic/functional_serializers.py,sha256=3RjQu_pxWaeesbJr1rwMgAUlO6wdTC8j_8CBh729b7A,14616 +pydantic/functional_validators.py,sha256=OKrL-nym0Me5bHou_BJCs9h-m2Gb-b3Asy58rJG-lkM,24224 +pydantic/generics.py,sha256=0ZqZ9O9annIj_3mGBRqps4htey3b5lV1-d2tUxPMMnA,144 +pydantic/json.py,sha256=ZH8RkI7h4Bz-zp8OdTAxbJUoVvcoU-jhMdRZ0B-k0xc,140 +pydantic/json_schema.py,sha256=A2GXiNigkfJb1yeRTteEaAWlJGteRSBlgQyHDfAk9x8,106297 +pydantic/main.py,sha256=zQVy0XYPN4-ve3qCCyxr8_6dbdmTSZYWtKWezwQXg1A,70106 +pydantic/mypy.py,sha256=diTpkBZ9hONAGyEU0npoPnVqf7rOleKCIoBHb-qqitQ,56972 +pydantic/networks.py,sha256=XjKPcKTDVGiCNTI_9B8iQKsO8xa9lfzkgUmvE0JIky4,22713 +pydantic/parse.py,sha256=wkd82dgtvWtD895U_I6E1htqMlGhBSYEV39cuBSeo3A,141 +pydantic/plugin/__init__.py,sha256=5pgHgEKA5kZXsaKhJYj2RdWZJ22nK1QAYojlcy2MxAs,6116 +pydantic/plugin/__pycache__/__init__.cpython-311.pyc,, +pydantic/plugin/__pycache__/_loader.cpython-311.pyc,, +pydantic/plugin/__pycache__/_schema_validator.cpython-311.pyc,, +pydantic/plugin/_loader.py,sha256=rmLbIwThDmVR1JwFVi_XvrLH7b1A5teMED-O3pr6Gk4,2140 +pydantic/plugin/_schema_validator.py,sha256=VFaNQpVNSuI2ymRDkTwBGaMKeKmySk1TbW-3rQeozxk,5240 +pydantic/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pydantic/root_model.py,sha256=54JLqe3_x5ZOEobsaMmNHBVPIpQy1tdW4tJnZGUI1pY,6194 +pydantic/schema.py,sha256=Vqqjvq_LnapVknebUd3Bp_J1p2gXZZnZRgL48bVEG7o,142 +pydantic/tools.py,sha256=iHQpd8SJ5DCTtPV5atAV06T89bjSaMFeZZ2LX9lasZY,141 +pydantic/type_adapter.py,sha256=-Jr6N3aPBbrOr_kSXuJEXHwoT6qsV6G8xZ9tWC74UgI,24974 +pydantic/types.py,sha256=wBUol6w4wcLtV0wLC0hre6ZdWseZSSZrRjf_R63Y_uY,95744 +pydantic/typing.py,sha256=P7feA35MwTcLsR1uL7db0S-oydBxobmXa55YDoBgajQ,138 +pydantic/utils.py,sha256=15nR2QpqTBFlQV4TNtTItMyTJx_fbyV-gPmIEY1Gooc,141 +pydantic/v1/__init__.py,sha256=SxQPklgBs4XHJwE6BZ9qoewYoGiNyYUnmHzEFCZbfnI,2946 +pydantic/v1/__pycache__/__init__.cpython-311.pyc,, +pydantic/v1/__pycache__/_hypothesis_plugin.cpython-311.pyc,, +pydantic/v1/__pycache__/annotated_types.cpython-311.pyc,, +pydantic/v1/__pycache__/class_validators.cpython-311.pyc,, +pydantic/v1/__pycache__/color.cpython-311.pyc,, +pydantic/v1/__pycache__/config.cpython-311.pyc,, +pydantic/v1/__pycache__/dataclasses.cpython-311.pyc,, +pydantic/v1/__pycache__/datetime_parse.cpython-311.pyc,, +pydantic/v1/__pycache__/decorator.cpython-311.pyc,, +pydantic/v1/__pycache__/env_settings.cpython-311.pyc,, +pydantic/v1/__pycache__/error_wrappers.cpython-311.pyc,, +pydantic/v1/__pycache__/errors.cpython-311.pyc,, +pydantic/v1/__pycache__/fields.cpython-311.pyc,, +pydantic/v1/__pycache__/generics.cpython-311.pyc,, +pydantic/v1/__pycache__/json.cpython-311.pyc,, +pydantic/v1/__pycache__/main.cpython-311.pyc,, +pydantic/v1/__pycache__/mypy.cpython-311.pyc,, +pydantic/v1/__pycache__/networks.cpython-311.pyc,, +pydantic/v1/__pycache__/parse.cpython-311.pyc,, +pydantic/v1/__pycache__/schema.cpython-311.pyc,, +pydantic/v1/__pycache__/tools.cpython-311.pyc,, +pydantic/v1/__pycache__/types.cpython-311.pyc,, +pydantic/v1/__pycache__/typing.cpython-311.pyc,, +pydantic/v1/__pycache__/utils.cpython-311.pyc,, +pydantic/v1/__pycache__/validators.cpython-311.pyc,, +pydantic/v1/__pycache__/version.cpython-311.pyc,, +pydantic/v1/_hypothesis_plugin.py,sha256=5ES5xWuw1FQAsymLezy8QgnVz0ZpVfU3jkmT74H27VQ,14847 +pydantic/v1/annotated_types.py,sha256=uk2NAAxqiNELKjiHhyhxKaIOh8F1lYW_LzrW3X7oZBc,3157 +pydantic/v1/class_validators.py,sha256=ULOaIUgYUDBsHL7EEVEarcM-UubKUggoN8hSbDonsFE,14672 +pydantic/v1/color.py,sha256=iZABLYp6OVoo2AFkP9Ipri_wSc6-Kklu8YuhSartd5g,16844 +pydantic/v1/config.py,sha256=a6P0Wer9x4cbwKW7Xv8poSUqM4WP-RLWwX6YMpYq9AA,6532 +pydantic/v1/dataclasses.py,sha256=784cqvInbwIPWr9usfpX3ch7z4t3J2tTK6N067_wk1o,18172 +pydantic/v1/datetime_parse.py,sha256=4Qy1kQpq3rNVZJeIHeSPDpuS2Bvhp1KPtzJG1xu-H00,7724 +pydantic/v1/decorator.py,sha256=zaaxxxoWPCm818D1bs0yhapRjXm32V8G0ZHWCdM1uXA,10339 +pydantic/v1/env_settings.py,sha256=A9VXwtRl02AY-jH0C0ouy5VNw3fi6F_pkzuHDjgAAOM,14105 +pydantic/v1/error_wrappers.py,sha256=6625Mfw9qkC2NwitB_JFAWe8B-Xv6zBU7rL9k28tfyo,5196 +pydantic/v1/errors.py,sha256=mIwPED5vGM5Q5v4C4Z1JPldTRH-omvEylH6ksMhOmPw,17726 +pydantic/v1/fields.py,sha256=VqWJCriUNiEyptXroDVJ501JpVA0en2VANcksqXL2b8,50649 +pydantic/v1/generics.py,sha256=VzC9YUV-EbPpQ3aAfk1cNFej79_IzznkQ7WrmTTZS9E,17871 +pydantic/v1/json.py,sha256=WQ5Hy_hIpfdR3YS8k6N2E6KMJzsdbBi_ldWOPJaV81M,3390 +pydantic/v1/main.py,sha256=A48ds4KJN4SgI34YLgPGqi6K3LhO7OwZ3QEy6GERiUc,44541 +pydantic/v1/mypy.py,sha256=kLQ7SHwisFxg0qb68clCLyoiwE6fl1TojeE6y-LY8I0,38774 +pydantic/v1/networks.py,sha256=HYNtKAfOmOnKJpsDg1g6SIkj9WPhU_-i8l5e2JKBpG4,22124 +pydantic/v1/parse.py,sha256=BJtdqiZRtav9VRFCmOxoY-KImQmjPy-A_NoojiFUZxY,1821 +pydantic/v1/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pydantic/v1/schema.py,sha256=JLnq9550F6qx9imoZbc5mJvMMTqqU4ju-5rX5Qg23qQ,47760 +pydantic/v1/tools.py,sha256=1lDdXHk0jL5uP3u5RCYAvUAlGClgAO-45lkq9j7fyBA,2881 +pydantic/v1/types.py,sha256=Fltx5GoP_qaUmAktlGz7nFeJa13yNy3FY1-RcMzEVt8,35455 +pydantic/v1/typing.py,sha256=GjThObaqHMhLaECzYUrDk0X-RHjo7x6vsv4Z4qUYV8I,19387 +pydantic/v1/utils.py,sha256=fjlWL8SStFZj0w3sbfuOVfDITK1vdFfZ5pcgml9Kq7k,25919 +pydantic/v1/validators.py,sha256=Dxcx36zVQjBUfYdjQLs_E0qpYqTeNbrF8PQTcasYgrI,21996 +pydantic/v1/version.py,sha256=DFN4uMBemx_gHk_6i1SK0oMa3VMe9G_wLFyw6KInipg,1039 +pydantic/validate_call_decorator.py,sha256=jj1T9Yz9_sQMhBjBmUn9sv7YK9dyLXJm5podxxsbDfI,2127 +pydantic/validators.py,sha256=pwbIJXVb1CV2mAE4w_EGfNj7DwzsKaWw_tTL6cviTus,146 +pydantic/version.py,sha256=5udPEl9gYDPmqid2QS91qnZNBhLyo6-KHTl_tXkPMv0,2442 +pydantic/warnings.py,sha256=7f5TxYmLkZOCMPb2uGLlJCE6uAGd4XF0qea6n-hv-ys,2711 diff --git a/env/Lib/site-packages/pydantic-2.8.2.dist-info/WHEEL b/env/Lib/site-packages/pydantic-2.8.2.dist-info/WHEEL new file mode 100644 index 0000000..cdd68a4 --- /dev/null +++ b/env/Lib/site-packages/pydantic-2.8.2.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: hatchling 1.25.0 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/env/Lib/site-packages/pydantic-2.8.2.dist-info/licenses/LICENSE b/env/Lib/site-packages/pydantic-2.8.2.dist-info/licenses/LICENSE new file mode 100644 index 0000000..488c626 --- /dev/null +++ b/env/Lib/site-packages/pydantic-2.8.2.dist-info/licenses/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2017 to present Pydantic Services Inc. and individual contributors. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/env/Lib/site-packages/pydantic/__init__.py b/env/Lib/site-packages/pydantic/__init__.py new file mode 100644 index 0000000..2dcb91c --- /dev/null +++ b/env/Lib/site-packages/pydantic/__init__.py @@ -0,0 +1,409 @@ +import typing + +from ._migration import getattr_migration +from .version import VERSION + +if typing.TYPE_CHECKING: + # import of virtually everything is supported via `__getattr__` below, + # but we need them here for type checking and IDE support + import pydantic_core + from pydantic_core.core_schema import ( + FieldSerializationInfo, + SerializationInfo, + SerializerFunctionWrapHandler, + ValidationInfo, + ValidatorFunctionWrapHandler, + ) + + from . import dataclasses + from ._internal._generate_schema import GenerateSchema as GenerateSchema + from .aliases import AliasChoices, AliasGenerator, AliasPath + from .annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler + from .config import ConfigDict, with_config + from .errors import * + from .fields import Field, PrivateAttr, computed_field + from .functional_serializers import ( + PlainSerializer, + SerializeAsAny, + WrapSerializer, + field_serializer, + model_serializer, + ) + from .functional_validators import ( + AfterValidator, + BeforeValidator, + InstanceOf, + PlainValidator, + SkipValidation, + WrapValidator, + field_validator, + model_validator, + ) + from .json_schema import WithJsonSchema + from .main import * + from .networks import * + from .type_adapter import TypeAdapter + from .types import * + from .validate_call_decorator import validate_call + from .warnings import ( + PydanticDeprecatedSince20, + PydanticDeprecatedSince26, + PydanticDeprecationWarning, + PydanticExperimentalWarning, + ) + + # this encourages pycharm to import `ValidationError` from here, not pydantic_core + ValidationError = pydantic_core.ValidationError + from .deprecated.class_validators import root_validator, validator + from .deprecated.config import BaseConfig, Extra + from .deprecated.tools import * + from .root_model import RootModel + +__version__ = VERSION +__all__ = ( + # dataclasses + 'dataclasses', + # functional validators + 'field_validator', + 'model_validator', + 'AfterValidator', + 'BeforeValidator', + 'PlainValidator', + 'WrapValidator', + 'SkipValidation', + 'InstanceOf', + # JSON Schema + 'WithJsonSchema', + # deprecated V1 functional validators, these are imported via `__getattr__` below + 'root_validator', + 'validator', + # functional serializers + 'field_serializer', + 'model_serializer', + 'PlainSerializer', + 'SerializeAsAny', + 'WrapSerializer', + # config + 'ConfigDict', + 'with_config', + # deprecated V1 config, these are imported via `__getattr__` below + 'BaseConfig', + 'Extra', + # validate_call + 'validate_call', + # errors + 'PydanticErrorCodes', + 'PydanticUserError', + 'PydanticSchemaGenerationError', + 'PydanticImportError', + 'PydanticUndefinedAnnotation', + 'PydanticInvalidForJsonSchema', + # fields + 'Field', + 'computed_field', + 'PrivateAttr', + # alias + 'AliasChoices', + 'AliasGenerator', + 'AliasPath', + # main + 'BaseModel', + 'create_model', + # network + 'AnyUrl', + 'AnyHttpUrl', + 'FileUrl', + 'HttpUrl', + 'FtpUrl', + 'WebsocketUrl', + 'AnyWebsocketUrl', + 'UrlConstraints', + 'EmailStr', + 'NameEmail', + 'IPvAnyAddress', + 'IPvAnyInterface', + 'IPvAnyNetwork', + 'PostgresDsn', + 'CockroachDsn', + 'AmqpDsn', + 'RedisDsn', + 'MongoDsn', + 'KafkaDsn', + 'NatsDsn', + 'MySQLDsn', + 'MariaDBDsn', + 'ClickHouseDsn', + 'validate_email', + # root_model + 'RootModel', + # deprecated tools, these are imported via `__getattr__` below + 'parse_obj_as', + 'schema_of', + 'schema_json_of', + # types + 'Strict', + 'StrictStr', + 'conbytes', + 'conlist', + 'conset', + 'confrozenset', + 'constr', + 'StringConstraints', + 'ImportString', + 'conint', + 'PositiveInt', + 'NegativeInt', + 'NonNegativeInt', + 'NonPositiveInt', + 'confloat', + 'PositiveFloat', + 'NegativeFloat', + 'NonNegativeFloat', + 'NonPositiveFloat', + 'FiniteFloat', + 'condecimal', + 'condate', + 'UUID1', + 'UUID3', + 'UUID4', + 'UUID5', + 'FilePath', + 'DirectoryPath', + 'NewPath', + 'Json', + 'Secret', + 'SecretStr', + 'SecretBytes', + 'StrictBool', + 'StrictBytes', + 'StrictInt', + 'StrictFloat', + 'PaymentCardNumber', + 'ByteSize', + 'PastDate', + 'FutureDate', + 'PastDatetime', + 'FutureDatetime', + 'AwareDatetime', + 'NaiveDatetime', + 'AllowInfNan', + 'EncoderProtocol', + 'EncodedBytes', + 'EncodedStr', + 'Base64Encoder', + 'Base64Bytes', + 'Base64Str', + 'Base64UrlBytes', + 'Base64UrlStr', + 'GetPydanticSchema', + 'Tag', + 'Discriminator', + 'JsonValue', + 'FailFast', + # type_adapter + 'TypeAdapter', + # version + '__version__', + 'VERSION', + # warnings + 'PydanticDeprecatedSince20', + 'PydanticDeprecatedSince26', + 'PydanticDeprecationWarning', + 'PydanticExperimentalWarning', + # annotated handlers + 'GetCoreSchemaHandler', + 'GetJsonSchemaHandler', + # generate schema from ._internal + 'GenerateSchema', + # pydantic_core + 'ValidationError', + 'ValidationInfo', + 'SerializationInfo', + 'ValidatorFunctionWrapHandler', + 'FieldSerializationInfo', + 'SerializerFunctionWrapHandler', + 'OnErrorOmit', +) + +# A mapping of {: (package, )} defining dynamic imports +_dynamic_imports: 'dict[str, tuple[str, str]]' = { + 'dataclasses': (__spec__.parent, '__module__'), + # functional validators + 'field_validator': (__spec__.parent, '.functional_validators'), + 'model_validator': (__spec__.parent, '.functional_validators'), + 'AfterValidator': (__spec__.parent, '.functional_validators'), + 'BeforeValidator': (__spec__.parent, '.functional_validators'), + 'PlainValidator': (__spec__.parent, '.functional_validators'), + 'WrapValidator': (__spec__.parent, '.functional_validators'), + 'SkipValidation': (__spec__.parent, '.functional_validators'), + 'InstanceOf': (__spec__.parent, '.functional_validators'), + # JSON Schema + 'WithJsonSchema': (__spec__.parent, '.json_schema'), + # functional serializers + 'field_serializer': (__spec__.parent, '.functional_serializers'), + 'model_serializer': (__spec__.parent, '.functional_serializers'), + 'PlainSerializer': (__spec__.parent, '.functional_serializers'), + 'SerializeAsAny': (__spec__.parent, '.functional_serializers'), + 'WrapSerializer': (__spec__.parent, '.functional_serializers'), + # config + 'ConfigDict': (__spec__.parent, '.config'), + 'with_config': (__spec__.parent, '.config'), + # validate call + 'validate_call': (__spec__.parent, '.validate_call_decorator'), + # errors + 'PydanticErrorCodes': (__spec__.parent, '.errors'), + 'PydanticUserError': (__spec__.parent, '.errors'), + 'PydanticSchemaGenerationError': (__spec__.parent, '.errors'), + 'PydanticImportError': (__spec__.parent, '.errors'), + 'PydanticUndefinedAnnotation': (__spec__.parent, '.errors'), + 'PydanticInvalidForJsonSchema': (__spec__.parent, '.errors'), + # fields + 'Field': (__spec__.parent, '.fields'), + 'computed_field': (__spec__.parent, '.fields'), + 'PrivateAttr': (__spec__.parent, '.fields'), + # alias + 'AliasChoices': (__spec__.parent, '.aliases'), + 'AliasGenerator': (__spec__.parent, '.aliases'), + 'AliasPath': (__spec__.parent, '.aliases'), + # main + 'BaseModel': (__spec__.parent, '.main'), + 'create_model': (__spec__.parent, '.main'), + # network + 'AnyUrl': (__spec__.parent, '.networks'), + 'AnyHttpUrl': (__spec__.parent, '.networks'), + 'FileUrl': (__spec__.parent, '.networks'), + 'HttpUrl': (__spec__.parent, '.networks'), + 'FtpUrl': (__spec__.parent, '.networks'), + 'WebsocketUrl': (__spec__.parent, '.networks'), + 'AnyWebsocketUrl': (__spec__.parent, '.networks'), + 'UrlConstraints': (__spec__.parent, '.networks'), + 'EmailStr': (__spec__.parent, '.networks'), + 'NameEmail': (__spec__.parent, '.networks'), + 'IPvAnyAddress': (__spec__.parent, '.networks'), + 'IPvAnyInterface': (__spec__.parent, '.networks'), + 'IPvAnyNetwork': (__spec__.parent, '.networks'), + 'PostgresDsn': (__spec__.parent, '.networks'), + 'CockroachDsn': (__spec__.parent, '.networks'), + 'AmqpDsn': (__spec__.parent, '.networks'), + 'RedisDsn': (__spec__.parent, '.networks'), + 'MongoDsn': (__spec__.parent, '.networks'), + 'KafkaDsn': (__spec__.parent, '.networks'), + 'NatsDsn': (__spec__.parent, '.networks'), + 'MySQLDsn': (__spec__.parent, '.networks'), + 'MariaDBDsn': (__spec__.parent, '.networks'), + 'ClickHouseDsn': (__spec__.parent, '.networks'), + 'validate_email': (__spec__.parent, '.networks'), + # root_model + 'RootModel': (__spec__.parent, '.root_model'), + # types + 'Strict': (__spec__.parent, '.types'), + 'StrictStr': (__spec__.parent, '.types'), + 'conbytes': (__spec__.parent, '.types'), + 'conlist': (__spec__.parent, '.types'), + 'conset': (__spec__.parent, '.types'), + 'confrozenset': (__spec__.parent, '.types'), + 'constr': (__spec__.parent, '.types'), + 'StringConstraints': (__spec__.parent, '.types'), + 'ImportString': (__spec__.parent, '.types'), + 'conint': (__spec__.parent, '.types'), + 'PositiveInt': (__spec__.parent, '.types'), + 'NegativeInt': (__spec__.parent, '.types'), + 'NonNegativeInt': (__spec__.parent, '.types'), + 'NonPositiveInt': (__spec__.parent, '.types'), + 'confloat': (__spec__.parent, '.types'), + 'PositiveFloat': (__spec__.parent, '.types'), + 'NegativeFloat': (__spec__.parent, '.types'), + 'NonNegativeFloat': (__spec__.parent, '.types'), + 'NonPositiveFloat': (__spec__.parent, '.types'), + 'FiniteFloat': (__spec__.parent, '.types'), + 'condecimal': (__spec__.parent, '.types'), + 'condate': (__spec__.parent, '.types'), + 'UUID1': (__spec__.parent, '.types'), + 'UUID3': (__spec__.parent, '.types'), + 'UUID4': (__spec__.parent, '.types'), + 'UUID5': (__spec__.parent, '.types'), + 'FilePath': (__spec__.parent, '.types'), + 'DirectoryPath': (__spec__.parent, '.types'), + 'NewPath': (__spec__.parent, '.types'), + 'Json': (__spec__.parent, '.types'), + 'Secret': (__spec__.parent, '.types'), + 'SecretStr': (__spec__.parent, '.types'), + 'SecretBytes': (__spec__.parent, '.types'), + 'StrictBool': (__spec__.parent, '.types'), + 'StrictBytes': (__spec__.parent, '.types'), + 'StrictInt': (__spec__.parent, '.types'), + 'StrictFloat': (__spec__.parent, '.types'), + 'PaymentCardNumber': (__spec__.parent, '.types'), + 'ByteSize': (__spec__.parent, '.types'), + 'PastDate': (__spec__.parent, '.types'), + 'FutureDate': (__spec__.parent, '.types'), + 'PastDatetime': (__spec__.parent, '.types'), + 'FutureDatetime': (__spec__.parent, '.types'), + 'AwareDatetime': (__spec__.parent, '.types'), + 'NaiveDatetime': (__spec__.parent, '.types'), + 'AllowInfNan': (__spec__.parent, '.types'), + 'EncoderProtocol': (__spec__.parent, '.types'), + 'EncodedBytes': (__spec__.parent, '.types'), + 'EncodedStr': (__spec__.parent, '.types'), + 'Base64Encoder': (__spec__.parent, '.types'), + 'Base64Bytes': (__spec__.parent, '.types'), + 'Base64Str': (__spec__.parent, '.types'), + 'Base64UrlBytes': (__spec__.parent, '.types'), + 'Base64UrlStr': (__spec__.parent, '.types'), + 'GetPydanticSchema': (__spec__.parent, '.types'), + 'Tag': (__spec__.parent, '.types'), + 'Discriminator': (__spec__.parent, '.types'), + 'JsonValue': (__spec__.parent, '.types'), + 'OnErrorOmit': (__spec__.parent, '.types'), + 'FailFast': (__spec__.parent, '.types'), + # type_adapter + 'TypeAdapter': (__spec__.parent, '.type_adapter'), + # warnings + 'PydanticDeprecatedSince20': (__spec__.parent, '.warnings'), + 'PydanticDeprecatedSince26': (__spec__.parent, '.warnings'), + 'PydanticDeprecationWarning': (__spec__.parent, '.warnings'), + 'PydanticExperimentalWarning': (__spec__.parent, '.warnings'), + # annotated handlers + 'GetCoreSchemaHandler': (__spec__.parent, '.annotated_handlers'), + 'GetJsonSchemaHandler': (__spec__.parent, '.annotated_handlers'), + # generate schema from ._internal + 'GenerateSchema': (__spec__.parent, '._internal._generate_schema'), + # pydantic_core stuff + 'ValidationError': ('pydantic_core', '.'), + 'ValidationInfo': ('pydantic_core', '.core_schema'), + 'SerializationInfo': ('pydantic_core', '.core_schema'), + 'ValidatorFunctionWrapHandler': ('pydantic_core', '.core_schema'), + 'FieldSerializationInfo': ('pydantic_core', '.core_schema'), + 'SerializerFunctionWrapHandler': ('pydantic_core', '.core_schema'), + # deprecated, mostly not included in __all__ + 'root_validator': (__spec__.parent, '.deprecated.class_validators'), + 'validator': (__spec__.parent, '.deprecated.class_validators'), + 'BaseConfig': (__spec__.parent, '.deprecated.config'), + 'Extra': (__spec__.parent, '.deprecated.config'), + 'parse_obj_as': (__spec__.parent, '.deprecated.tools'), + 'schema_of': (__spec__.parent, '.deprecated.tools'), + 'schema_json_of': (__spec__.parent, '.deprecated.tools'), + 'FieldValidationInfo': ('pydantic_core', '.core_schema'), +} + +_getattr_migration = getattr_migration(__name__) + + +def __getattr__(attr_name: str) -> object: + dynamic_attr = _dynamic_imports.get(attr_name) + if dynamic_attr is None: + return _getattr_migration(attr_name) + + package, module_name = dynamic_attr + + from importlib import import_module + + if module_name == '__module__': + return import_module(f'.{attr_name}', package=package) + else: + module = import_module(module_name, package=package) + return getattr(module, attr_name) + + +def __dir__() -> 'list[str]': + return list(__all__) diff --git a/env/Lib/site-packages/pydantic/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e3159ca4e8dac23a917b1b5441e4e546682beac1 GIT binary patch literal 12099 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/alias_generators.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/alias_generators.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..77f7cb089529ab4362c80a99cd57104ba90782a7 GIT binary patch literal 3514 zcmdT`O>7fK6rQ!cabi0m34s(BsT&26*dzuHCBg(Ml!Oa*gmC(24A$B^F-{z>HM@ag z1<40g6_kox5Rp)&oKn(MDy={b2#J7@$e{-q zzyW)sCs>V(j^HRMz-vHw}$reFAS3Z0^lNJ>rg|nE5s!SANR3<`F&R)Po zO=nX=0;?A>&I(d`bQBYuRfVLOORHigofp-#oYi%+lvM(+=oyE7cCA5`<2g}DiW#jQ z*rYgtbxz5O<5=VMu8v@Jl4O&dVH)jtc)OL@=&4W`HO~*#if^GN}9WHPhpCa;P4j67ip(5dRcrY0ISSI7K0a*h3W8;$y z4Dp1l#&GsRER;^fl(dR_b7FE_OkpLKyCjKl>B;>71W}1s@Ds>gdR^b25hoIocr5>} ziGx6YMg}-2$AHl%cfwyQ%|HrhspC=CgRbR{`~HXi0$KwZT#?4BX*Gj28^M}gnM^F$ zNF7XQJVTR0FIf->-GET9FyaA5@dGKK)mGHldi~_JlUKvj;lj|b?#Agu#nwRaz#u%! zxa1C%-Jzl*L|Q@J;$stn6l6D%YI+f&F_V|LDKrmfSTw;#+AW%m^y1y0JZRgHVNbftN zV;ewz*1sq3j7dzKcXgkO`{`UQoSy;@y*bY3s=T)DTZF91B7z9bvOXJWgihl#@rTgl|6Bhr{@~C4V9DQK_V*VM!L)Czm@hBH)qBmm}oYs zL2_9m_c8~%W_d6bf!T;0pF4lI5@(fU-cx~pj{pU994Ev??}n06sWV%a6c#{lQBo=) zXjHFswyLBV^`)(w1=&8I-m~DdRu-D|SY?R;^X3tE3(@>G2WvJr$!^VRx6oI1s6>uo z;s#}ni@%~5L}=2k9e>Pgo8#|&SftP(gzC}qsQp3va?5@1LvQiWX?T{!XQ?Nt74h-d z(=lCA&|@**)UBJYyWv0b0D14N&F+JhYr5HY4*uBpL*LTD?}K-P#RDODmbqunC(ae_ zvFoWzmsFWeGp}*`|39-2Q-^g@LaTMvEi$V%Wv_n)$A9A%k66rk&GixiBt8c#6oeK9 z%}H=BBPKEN(it1e((L=k^5H{+mQb<}UgdKjP$}9_r~ZRYbV~ zWYx}b+;bEuqR0!>P+-3ouKfk)YLkl#b2Cu?Xg_Q8`p81P+qfZaW?&W3e%9#qk%jKr Q&h4UV&`~YuY7%DZA6vHV=l}o! literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/aliases.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/aliases.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..296b5c8da3e932054c0eabbada798783647e70c0 GIT binary patch literal 7078 zcmdTJTWB2D_0H_%O7O=-34O{FatnU;^(j1Vxi2IUc}PqxfT?v~OwotL6b4Lf z`(kQWJToL7EgqUF^<%}llVk(zSYYPP`8(J=_kA95@iE~zqoXzG8yK_43 zu{@L6Wh-!2&Sd2IjB5E`*9?`)8JO9AZdsADhL$>?Rn)YWRh6%SF^J=Uq-9}NR?bL@ zY{;pMtm}ZPZ4wuLNzDQRBS)%s$^oSno<1d}MB(XI+Tr}2v<0RV|8-uM7gSNnrSx&} zqG9Cq@v$*{8_hc>8CBG!vE!qs$ACB~HE-x+j8;b&%)>@U+6HGey-$9fXEKwfTaf z>f>wyTm;u2hov%_Ziuh`V-W{VFGg_U1sD@cICstx5Q7y=Yg9KR znJ!o!=(YrC>03c)!aSI5`KW3XXx0*@b6GW2lXjq>06#w=E-y;l0%su0ovXxu3U9Y+ zJw@m*5vlgBkQwqBHy!6K0k=j`$v`XwUCpFv1YT%603A6F``?$1`28W186qAP(gYK9~gJ0?;5P~1k{ zzFu7KQ2T!p_)7$sXaEo(HIOVthqqu7Q`bDL3U zT!$lHf~S3f@NvbZv&eC30Q2cWVNuOO3m7jy3@2;cf0Hq#K^&0BZ(UStNSKJZ%*Vkv zXH%G?kHBVh+@(l+09qYP1gRkzIa@MSy?C%rot>k7h@cg~6;f>_(b&~xGw=vS>RFs( z35u37C<;fDwD_Qdk>&T$0J3l^d?RV5$lMz%9s{}UTqWK>B+k`r*J#i{e9n~udp|>h zq{Npzcq02+;ja!IAx6M`C&Xah#C|t$|IU^63=rDNk!GCl!u}EO`{V=9yX1YY#54B& zW=551>Y|FeizfwrmgzFHqz2F*l}gm}YD!CMw&G(iHTI9ac6eYH2o`t*q%H*lXBLA*Iw`0xu>!BD%P&$2 zCOGs8*zOPPcJQs`yvmw!fr$+5$I0B1#a-5sF^Jd}pqS1`A|W{>a48aQrPx;&q20zG z2Ne1b0Wcv7x2mZlvdfMa24^ct6fF@&U8BbUd`6gtF^V$>#sF?zM+0-E z;jb$Ayn!k~5GCG6O`!+wvd~i%IPVCMr3v_aULblih(^5aRk8=Lw}CD+1;5(mXfC%o z3SIkn=2j)ZJad?NXrIyoTGd8T8;k$`|MtjE3{Z2*U^opKybX9|xxqarYkHA%TyrOL z&9*zK4bEA92cgw!`)K=hE3$23T_&6CEsEf`^v<*kaDbq9!-GDFZI5jUzTmvi#zW=#!^PSJazYdqXp9a_3x(a_xuC{DiG!O)0khx|D zi;+J_8@KsKXj~@?WQE)2NzSkE5A8{gmAExWb^%?(RpQr>hC8n2IKMf@;mFnJ_r|xt z?U?;`iDO>nC;u%dK#H&^-4!X2g1zFsZxbbW8Kdc8I5smdmQT*-)vUq{k;8w>FJtVa z>K2!3mH@O?#r`G<*cm>&1e0_P0JHofL@{0FN<2o5mdTK;#-k-AL-@jkxKN4$?o+?*J>LREi~y& zaF65JP@E}i?J((2!BE^!<2Yjo!4n9E5sVx^2e6mK)l%@QU5*rUo72#>(*h?TH&VTd!15y=aw0Fh`J6XD z8}qZb11whxK+e0+;&+F!T;24-%UrHYUVV)AEs8R3d2 zcbNlICf$6>Z96_-&iy=EKc$^#SO=Omwt87g;^@R(AtaET!9Ndls`*uMy zIA?`{ySevOMKU0g)wj+Vg?vW6fG_N9ur1cE?He~*?{RlOERK$j&RHQQ6)c>yLuWJ_ zTSvF~;%!HFPM&J?BSH9%d9R-{EmgP`p($&I%&0ln`G8yT(vv(Xc}t#V|FI&J1R8Jh zbOL1EkfYbDQhJZ!RLWpEqVOf|W1@H%gt^f6-taeL{Sj9ZK;wPI-#N7zR0Bs?pw7^o zm>`!%-E@XYiJOivhKV)R6(KW0A!0o!Wq#1xO>W=9csOtl5vNsJug=IH3Q@ics|UjYE_ zv5T~Ku6pnG9bHpyzFO`(Rp~orwwzjhzDm5oj`i4)Yj3Q*T8@oXVq>c>u18|%DLZZ? zZhCL7lplMx^4PPi<8D{~dW^1x%ov6Hi-i3&=W|XYM(=s}?vDEe0AyM19aSHRcDe!C zl&v;8D+nP6nN4s7{T!ydj_x}e;|RSw4L_M{icFC}OapF10}CW;@Z5PRoY7EiN^_tW z@YOBH%MpV0gSDNXL65>We%V+>Xw2}_pat77diKQVX~ek8UO<;ho|2Hp`l?X;vZgsn zCLPJ)UCMvM%)2Cav0X{KE-NyV)2J}J6@4Z}#vqhm<04g^S_A0ENP|~_wa_}-OE#@o zR~shIbOPu{F${pD76Ucg*s;h4Q@*&@)`Xh;*FVtF&NRq<)X{xM?4hV+2ZnXQ-!TCY zILR#3mD)S+L)q+hRuy zuUL$QVWa*70L`&u05f_7F)}oIyPzM2j4Rw%U4WSj%GdV+-3|dg_k_VH++Mep6 z_g3JHU0!*P&HyqFemYi~q0Yl`>txU*gB#?q*?e!14%5BYN!;A~-XKqy&G!ZwGMn#> z&@)&3U^)5jE4>x2%j8bu-7{S2Ic2x2{80|7Dm%eF?7NTPo`>+yRJhaj)N|Z^$R6b& kLD&iIVc&fOb!0eed_P~H+yDRo literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/annotated_handlers.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/annotated_handlers.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e76495f94be23350d12e7b56ac839b9aecac2805 GIT binary patch literal 5774 zcmd5=&2QYs6({%mLo3N2a_u&@M~Yiv3wcunJ+y++LXaFqZXySObH^drslz-2Wm7RGa$86RHZ{aLybK~nIh@FgSiO+y<34}KW)6)CoCP6wIl6&`_(?E?>IVhs#|XuzS^#D8 z{8_K-=1my5iYLay+Af@pbfo45IsiSQC$)>P7O?{&cl4!P4>Ia(@R zg>mk2zwtrr5*w~C!8;yTmLg&hvD;E6bgsniY_z1Q!XkzMs$qriDgeM1#T}N(3K_{F z+_9nbHd4d3lodY|wmr3IDz31|GN_-a5{(3=WT&rKSH-fl#^^*SYl3OTuFv%7(xw+| zbbAi#GB;rKF6t0GHs>>^EimaL-UvClzqY*nYme`3uY#f7-R->)e8uC&ju&h*cYpgm zduQ9X19rP-T6^X$^S2Z8z7+=;MvWMNexuiqN``@GGK|6XN#UW9bQ9SB7}5V&`|1sC zX5p|je++M0G}krzJIvs$Z72Xbmydi7P6V3^C30pui7U6kV@=Zf!@@0CePNk28jU}- z;?C49Hrirh5=aJcZl$ zJZ~@T2?Q;ZST~@9L?vx6bg8<;YhnMagh9tdwV~ab8OFz<>BK!n!=Ro8%`=9fq-4Y3S8&ZAK=DlOE>0uTn zT)s5au$a>F*A8=6;rFlH)nRTrzcAFs3o`yX-YX6)HnL!k(UX-m{rDbK(%dXE^9(IO z9?sDjS`>MCmX*G3pGphBCSDxnNCCAzQm`XYq0j}yq$*A#APRC z@2Ki~A-9+j0F~l-SXWr(EjtS!#gK$V2ww_Y>9D#yc6i-clVgimQNg7#8E#o2hK*j467+wFxA z$H(VQOt0zQa^@&$-?kvOwn*BaCfZXG=2;wJ-ULLc5k`2bNN4FHF^)&+Yz^il>FoP5 zoe2*+7x?}s@|K{h7^UM36uO)_CS-9;7^qV#mf>IKsC6c2&z;aODk!16d@FQRPu7QsK=oH$bnMBR;t!{7&lG$10of`E3!{8zo zn8~8qlp07=p9_fpcr}5dtZlnC-lT3TY$(Oys~Obf+20{9B^4%^f2wx4uC(y5w|7h* zPzSgNLZ}3@*QHKkk#mu!74!oO=p|e~6?sy1kI|zapMsNM7=jO_bCck8mJjV9fJS`i zqyp|o{zx`GmstRb(Svnh3g2`|9sD$5-$;UpCkeIXct9=#(#8w0jAg)c;|sON8{!zx zbiwj`+<{1bR}m8g(;D2I=nClo4%7VjR#8yG@W~vtt>AZXoFxLEK7Rjg4z<3KWL*qi z9)vRl0u8y~?D$nj=rcsW5K$@lHUL+2h55;Ia{Tt8p7OHz@PnDo7f1Es!o>#liRYa( z^Z?f@LGf7o@AN#}rbdhw(^<-r_$_z^MvFKRb;)Q&Yev?Wa70{3f?TigH*oZIEN)sUh)8y;_xIj|8$U@tb-^kWd(wg?CH7O=axLLm<4v3__9l}={AoU#3 zt^u=G>=+fmSYUddgD$CG{Bjx9k_)oX{}$*A%^d@ge2$D!#p zGcYa3^!@mK3t&Ol0KxLTw(50(7cnYc#cd^mdxp4n%L|0i^tkp`*J~h3C0Dhm(FsSFb-WUHW(F zhEgtwx-931v&9Q+dzp4@=|97PXNwou_Hsgp Hu=@W2bOT3J literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/class_validators.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/class_validators.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1d46726a1b85cdca58d33117a5468fa8770c86ab GIT binary patch literal 387 zcmZ8cF-rq66n?p@SX+AFFX*iYTInQ+b1cf7zrkC^xy}KMqTBwshLU3?#QpDMR z;ZVUrZYnsr3EeuGqaLDP@{;$y$NTu+L#x#Qi|5;y;kErg%A$h%lPtDuasv!PV2C*h zN}bR_-~e~HdyfE~Y^)I0n0p36?Q*vtB~)uNp^0GBNTvIJD%m*UzR*7P2Q(VxQkjYz zDw+D{-Ogtz6`*1>=7t)hNGf7QjgZ-CuvV-S!em59(fH+6X|t#klF^jgR+ErwmOR3u z^tC)W+QS!8jqsslB8%~8Y&E4K18FeNCiqwkuoi}I=hhaDxyJdF(aeZw=l>d=e7daf vuU0uwO{-oy)?NF2xd@?m=*^%vhhX;i&b{``Yv0vhz2MCYuA1dh8+Pg&sl9X? literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/color.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/color.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c2e59debc2bfaa96b9555600535ab5d42d7987ec GIT binary patch literal 32513 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 NdnCu*^vAZV{|EW+V{-ri literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/config.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/config.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..15249f3063ea6affda72a934d494b7b1de3872ba GIT binary patch literal 6310 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/dataclasses.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/dataclasses.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..33a57984f57e1790b23ba596cb0c618ac1248fe4 GIT binary patch literal 13401 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/env_settings.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/env_settings.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a219138c84522d2c284e77cce8d5209a3c8e68db GIT binary patch literal 383 zcmZ3^%ge<81Y2jHNt*(sAA>kBzzk)4)&Vl6Go&y?F{Ci2Fy%1jGDR^lGB7cuGNm#v zV`N}h4a5)-#gf7t%%I6qWge1|s*sSHR~BEKT2hjkmtLHpkei=Unv<%KS*(z#kd&C5 zU65Z?0uxLt%Fk5@Gt_$tGD?&2mSB2nNn%M!QG9M@dQoCYW`3TZChINs`1q9k z@=IcXZjABCOo}PaEJ@WZ06Hr%J+(NdpfV*fuOu^BAK43f1(m-zY#`pSE8+&4403I; uA&~gM%*e=igTeL!gY5$b%?qgL0iXN@KKTV47x^@=@M$)1gJ2OSP!|AGEpjdZ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/error_wrappers.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/error_wrappers.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9f30d113acefb038840e821e18db776b19b727af GIT binary patch literal 387 zcmY+9ze)o^5XNWkBF2Oq_yoE3KqDy?F@<)DjiL}1HhbC4xg>Xc%x#od`4n2%SSe!d zTUbP}kgEb#c0#&T?h%9J+kZ2&%*St@YPAYjz23j|ZteS3Bn!EJ!F0n0cOak*f(U0o zVyEp8a6mfJeIx)c_RQ5T3HJno()IS~h4ecTQ6sxTo~9DBjvs3=97tbfKKDc3?WY>e zqS!+n`)AF@cVQNgd_9te8-pxX5ptt+avZGWtBeWVWh}4!*RcT2%Zw#FmiDX4*rJy` z!?Ylq9Ukn^bB%qvuZ2n?+8TWF$(MU(L w^6q?)J*-;qf;Vg0>&GR8d_rpstqBC<De)ob8FSw}|3)gJdFMZW?00000 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/errors.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/errors.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c847353adfbc5387bb5699c77181db01b3f28059 GIT binary patch literal 7134 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 Ef72g4+5i9m literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/fields.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/fields.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..220ccc640a2f4c1f2473a840cd80ac86656cdd22 GIT binary patch literal 57318 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 AlmGw# literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/functional_serializers.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/functional_serializers.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5b067d1bde7246db32caf9a5da5ae8afe7d666be GIT binary patch literal 17127 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 T6;ukIQrL3>c0sOGOrZI{|5BH! literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/generics.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/generics.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0e17d85d31e99ed187ca5cfea601ba7f58830e38 GIT binary patch literal 375 zcmZ3^%ge<81Y2jHNt*zqAA>kBzzk)4)&Vl6Go&y?F{Ci2Fy%1jGDR^lGB7cuGNm#v zV`N}h4a5)-#gf7t%%I6qWgL=`s*sSLnwMIXnOvNpkei=Unv<%KS*(z#kd&C5U65Z? z0uxLt%Fk5@Gt_$tGDef}mSB2nNn%M!QG9M@dQoCYW`3TZChINs`1q9kI%>1JGr2LYY z)V#77pUk9~;>?m%-2$Mq64O(QV+tx$67xzjll5WF*DI*}#bE>Sf?W|e&{U91iw%Lq r2WCb_#v2Tl7Z@xbFlb&tMGyGoFYw7P;JC=Ad4*52fg1#iIDxtV61r}P literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/json.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/json.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3a7a4419b40c20ac8c92c65a3dd0471b0281d6c2 GIT binary patch literal 367 zcmZ3^%ge<81Y2jHN$Ua9k3k$5V1_b2>i`+k8B!Rc7*ZHhm~t3%nWC5&8JHMSnNpdT zF)}c$24V<^Vo6~RX3%7*(htco3F32w`feEG+ z<>xAd8S1?R8KKE|OE5jPB(bEVC_Xncy(qCHGe6Hyll2yRe0)lNa(w(PE`)dy$a%Lo z;^XrYb5ns*-0|@+z40plIY~;;?}@->!%oXd=j!#fCuQ12ZEd n;|&JW3k;?Y7&I@Sq6d8P7x?5Ca9rfmyuzp1zzu>$oIqUwHXdt8 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/json_schema.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/json_schema.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..68cac8fbf1cf8f5d0f47ac0291d7fb663589a1de GIT binary patch literal 119193 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

        -y8B4jWd(!3QiA5Ysdmj`Yls;fX!x*a>h z8j;@|G33dY;UyTFQVeI_K@yg!Nwew5(8wr={F{-%I~<->L<+pZMyoI?6~SPs4rI(O z-lo~B-Wnbq48vqKVPzhKip9-=Fozf%kb=Xv@Ln4BhOtC*r2TR`*};yq2KxtxL-+&S z+|tV0dHrOwu0@v}<~W5gishFCwdV|Hk-_NbCHA@%iLPuMEGjH;gVt2Q4xq#OuKg@* zu!13eax<@N2Ft5d8|DwMBE0-CPjhg0I)*=M$;3TFqrxGd)QhyS+ywbXo{r8)e~VP; zDK^jpO9YyzyvKC)GJ)U5h!Kj2<_NStVce?q8odoVfWjV@o*!$~$$$j$)h-_4ZnH+& zc!4mM7w-Y_SnBYVsNOZR2lW`&MOhb|F&J+2-}?o572A^e*TrfYW`@<8%~QT9pYHTx z%E#I;>*fRN=30%&pYP_BBC^tKhLY2v=72rQ6{QhQoNiG3L6wy4oH^rbTz?_7nFkYYQcHgcRm$06G}ltJKsBp3oBogK+P087bpk$64GCL zijic?$p!%6^nbm3Sh|jo1Y^wF=!>2%>Vvs{CXJ50|lyKWkp!`gC9WzsR0cj2W_+gNAY`L%7^+FxwzxhVLXe~b2sr}gx- zq{q|X1uq>lT6%~y=>bNjd0CC;8fCMd*w`wYQESaIPD8Z?g)yI#S8(s9T--9dVa}!a zH>v(j3;td6{#_6H9&WUnJ4#NB?zne9lqt!D#3=|9NXl=agCIl{{acCNBRYur)HFzt z@T`8Adm2k5KIq%{FAkWfq}iIBz;wla3?%zlf+3;nBbJb1j;S$jUi>phvhE^YK)n24hTB#2SuMX z_Gi!B#5S{_2S85<51Hg=1L4hwE{j0Kw?cPJf=D54B-{lQ25Za9h7G003Xt>xREZ{+ zG9ji^gvNpj;`m5ZVp4*!dwN;4mRN_QRI3DIFy?8#@Z!Y_truG?CO*{dY~phe7n*TP z^-9Jq*!i}g2eZZ?jC^W{HG1OQ&KqhRdcMUO&yb?<2{Hmc&s7Oz9pH#x~es zNwb{P&cf$4!kcUGG^|>Rc8ha1G!=UN%BxqVqcfdKaidz?IP)pBxW%~7OJLk#X$2G` zT46gbv{op+>s$s!A~0X_Vu&v1Dqn&P5dMCUsvzjEodez|JbgVBc}rTDN~d|2E76P3`&s6=RqLSC1pT0J`RVmu279o7vB9G#^?HH{} z(QdV9HzKN)ReYo5Yb7(~N?EH~);gKH$bBoHdJ(;-6kSw{E+SK5@#}|PJv4n(M8%xU zdbbD>MAf49$?U(+cI1^zjVzR~P-dG_vPmu3r1&?h{>_uFM}-ySiK1h^vSThwsobts zZkKnRcvudAQ>i?m6n3kH-IH05%2&vusuh=MWI;2z_ zRx9Aifecz?Z(Yon2d`N(aCE*Ar|R4Iz^VA)XN!K3KeuDgsK+kJeUf^N)FR;LZF)ql z;c{vYzuV9{=a<{g(z*Y%xKJ9-sSW33Pwk`C>*P&GR#E?1Ts1& zKjtfn`6^<*V9eJT^R0QDliBUeo^+|67J2m%#d8$?MzJ^IX%}=I4!VJq23K2(t8p$vcWZ5!=R?@Q00^tCj1F0vDanpiKTY(_s zT?5X3Z0v$ma_PCuf0HF7Ft>rhO`;~_VmYVUC8QB<+8{K`3UHTjDj&=FdU!i&IZq-= zu#sZ@64v{sx+E5F7o~}Bg0T;LfYX2#@wbc!4FD zH}+UYK!OjGYcN4N+!`1h6hr|L7nDUBxO_zmro|-1&n6UrIqhf!DiGhug_>yrWEWdw zB(E@)Zc9jX26-Tp@-9`*z8q?Vr}(-7=#}Y6Q}{-QKhWP1YYls_`3AaBtS7%pSAhUf0r;fZNm!8T|2Y!jcsyi8{ANqRjFki3uPPT%QnoNP|EhHW&0*`W8N~^ z+W;P4Eoqy*u9oa1J@!>I2WJn1Yv#;?0?X25I7^ZsquHtEn zt=TGm+*Ulz?*_`JH>wq_3l$sYD>gi6mMbEqfmEC>me)$UWtR{g`tGAD(*9qMwkOgIru@kJO?{zQQhR z($vS!*hIv<_mnK|#9kRAFX`E*uHkax+Y|?2&}y>?lkFYxaF8O?KG#5!z?e&M?m}5s zAu8%?AVzb$T3giG9?%)7F?N?>j->6VIq&(P+mQy*vL70ICZ2d)4>AG&%H!#~9QT4x z)s~G<+gn%?(3iU$P(^j#bVk#TIzEfvRmDTKB=<+?I5awEFEqa%7Nbop{bY9AQx2oLu~JA^~X0ZqAg zG>Tp%adC$>CX5dZhAz?j*c0ca2!_JIu+(CFBuCiLxRy935gY)qm!Ln#wOBR!>FNZn zBxIB+4H6*xDCpxbqe7~@h)ZO2eb3c|)~{4Tt4%2ZT1=uD0AdLdD@Y59wT)0=7ryyV zXz?IclNS$P!PEuW8&tf(#qx#)Y^j#7R?1sd;OAqD4J``|2j&|N{OGdol3qD@Nj-Q; zY3NfM`Z(NAgY0iZ%!R^|sZT3`IyF!?6Pgb+$$_TD+O~z-_4BpsmD-JJ?Z&BNvBH{# z!qxMIt7o^&?Gw>Z<-#pUoyk-Sn->Z@<_kOKiXT)wJg06uF0a+7e7UeYR$4c6P%d4w zSW+wJ)jle%oW8J7)jnU(tV9aM+X6#Nf-WDd*I>SfFq^zr_YtjPYKP*lfmO`RD(oK0{(A0(=vz3f;*!%2 zX#zK}asN&HVRbOxL179=_uNO{5YGfnL;SHt(U`+7jI}Q#DiIT0?Ae-#wtt{O*o86? zSGS;8Eoh!CRSVWnX2!e)Q;2u4OZL*qx3)cKQVS^70e02VJKE;%q1iKvf4vGHp`P_j zJ;c+){UZ|5;g(i5_7Vh3L%Rlpj_Zh&aUJqztcWJYgd*4@I8VAof|s<0T30~?sB;c& zz%ywpJu~h~uq9wHFjo_j>}6sHV8wddZOwVtJ=6fL%Upb*c0lVAC}AXD|LribA>j=B zjnP|<+vzVjZaFPaW$Pu7v%7?&Ib4(KEgx@ZT6bEol6pd348j9LeGm@@SvM>M&1hOs zvC#=!jnE^fpXqMX6S^CjycOk!M0zJnN!v6_UJ7P}^Z>O?%3;+Y`e>PSe)m$EP2 z8Hq&sx+N#>ftZq0U7adfJ4yr{57m7~J7oCz%pOY{4$wjA>qOe*New^vZDV#j?K1rk6 z$cPrNFu_L!HEO|jdB-LBVlTlRmz07&wE*j0-{W-33{6q&YUWj`{*IV00KP`8*cdCR zQcGGNXS(vTmmB~;B|zTfve}EwmpgMigO2Y9Yxkw43!|VPp$VSkl0WAQ*v03q{EKlH zh0^My1wudQ8tB~l-t)M?Vv#ka0xB4h9M`6~Y-X6OkQ`DB#dq&qgRhARLW~H_hi% zWMKL%ffP(wgkB+n4JBqa(ORZjn1mb}{fcLF35U5oh^)1iqJ8N0V5jlTO#7Nj4^rH+ z0TBAaTp2PVA&)^8Q?r|Eob*8Ajom;t$uwqS*deGIc7n*mSKM!E5lTpz)nsinW*3rN zG*u5V1U;rtuc7IE1f!9s_v&@usrvP*w`$&o8GTyT0ZcQ3h{rW~cxsr$06S!VBhFaI zcDVBB=mHJ(jFQ*-{$qC{w-6DSM>|o$IGpdD2YlTTah!+S=JRP`=XuB!Y11DOZ!^M~ z_uc1RVNWCuy)ZCV)TZ{#}lt;tX31eN-HP@F?Vq;MRtW@-eA~`q;clXG;ak zBR+|hA#}YV;;K@qzF_kuQkp=_3`h+zrRj5x(o?gyr?z7YRWz}^3I0!SyTr)G4vl7p z^-O;}^Lpqu;>}*i1#DpGB9DV{M4^#&Lc3*35qY38-h}>=nhCTJSWRFJfp1{3gSB1g zwy?It>YGgtCy0BESZJbO#|r8ndou!9t^g)85x%gZF;?F2*qxq_G=NF><7|-@ zD+ywaE1;FFARFtm&r#73E3Z$^x;j=4f7|Jl4*>bH9f8Wk%d*_GHUdn#=%1)Q*Zejr z{G^DTcO3>ai0k|euqG2~T22BK32WN)0Ssp}c!>m86xeAbnXK+s6FNj9eiYxZ)}rTEvTIHBBBQwtDj`pT76$X~cY_7?m@JW^W>LB+gh~$?LhV=1$+7 zxqSaKX7ip!{f3g)sOB}wd_F2@oVleGbf^U#lbMgaxs$hE*?Dj0^tyR(CBkIJAdg=6 z+IB>&M5)syvVWEAS;gb&NdePVG>T5q{uk6HtwYF#x-(@(bM6a{FQk1T-KuhCrK!FM z$7Yjhlj#VR2b=fL`@Wc#=6Hn^(a>h!#(!}*9j{REw#>0(hp_Ph@s(hUC~AUv5!Y6B zEVw~U;Dt851=I;`Rl(?(*5!8YD&}ydF1$wi8+5ZpWq>|~6(@*_`%2Phj9V=Bth}Z4 zCS;`!%!9iYc`K9(5@XH!fmTI?ai>`q%35|5@&-~qekJ3k15p9NmnP}tq*-)w(x9x2 z{I6stTn$*HA+RsOJ!6}Xq#@?tW|{M6o#+}j?rMYrWFMxvWBneI1U!ut9JnRtE+V76 z0)jfZgnPMEbF+d5+B{Di5%^?PK~T2o z47g*PYmpmwOg$4TteU<8Q5{aTuxWOkQrIefK^q}fLcz!NM{4TSnoV<8)S5k0hhrr* zGaJ>qqjCwIaE1Vnau2Vl)z8SKD6w{`o9=FyJ4`-S3U{l8yXC^&i)A(6sQOyfS8MKr zx^?DL(fN&2ogzEl+n^RU$b5or)Na3uwCD`8y z$GgoPZ)LrmHJSC;6(DDQKO3xeWR*rQ$2OEr!M9%g@y%xNjzJ)R2dlRAGWx_ zGmvy6UTj6rz+7pzCID&OW2^Ry;IX>6C}<9c%VH(8QU{9ErJQ?lEu~Qd;lBf1pJ<;? zVTg{cvl;7}e0^YuS)U$op=PoDI5ibvP>k-})$*DP?~DQ9RB~Tbb6=D_FN&{rU4t@E zyy&Pw={y&bhCn+XqvVWm1PsKWeRB|VN222y{7pT;-6t!~l6hXGy{AwWrAczbh zBN*#9t1(0euHOJ_5xI`Ye8Fe$(C*McU&@z2CqXx&;3gx+KwIH@;jWlIw&yx=C6^<; znhHdFcZ-YmL!c%l^(5tyULpMUMFJ=A+4>lFq0^)c0{;oOl8Bl=qCT`!iK43OFZc}g z*lrX#;aDsvUMOgrFKC+$&mB|>cBlnASUfFzs~`Ca@12-#`f=S(#kWiK?UMBqMrFPl zWZ-VK@3CeSo~&7eMGRak7D)_b5OlC;38#OZOm-ZXTb3;}tgaGWTn1?Wepbzuj zqt-~!`iw$?8Xb@#Va+In|3@RJbTqm7X;-#hG!35uG zs-mG-v%`1|^WT!Nz9E4c)e-C7s3xoubQZC|95fEqpp8v27+L57UYW)Q7RnWcNz?#B zB1Bij6zh$P?-b(~-vUX1a3n$%K_2Ra{^7yF;aeE{+p~>I1LyG37Ho=M8@NHi-ukW# z5A;QvNM9e^EY#05?nL+ceQQzsV{l zzh(a_N~T?C5=vN#vc6AXFseU9oHX^t4tqGvdPUf@78x*bwJla-e3}}5S*g4>vLSTT z+g%&ftwD_YUg~)c1&TJ&GeFT3W>+K(F*;apm+rB&;Dsm7i&z-GN~lFM1u{^Jbz$&e zdXBZ&EDZK|>;EA1($46G!{SYCR0D0Ymrgd4i4~M$-x23@m-tK2Q^)8;dI8T_$bD>~ z3C`tjaltOBE&6))46T)$0Rg&^HW=}@Bguh>X=7}Lmfw_PJRKpHfmFYZ|KhOzBDVvi z?6DI!@2$PJX~fuOax51z+p-0UtvUKaK2kQH(z>M>*dLI$^g)8&O;XOH_LA-r=mpR{ z1iXancos%C>%&C_2~5;+lAi$SPmng&VbiremqrH$!?cf~J6yq*s3xKM8g=l$z?0yH z*@Yzps^RLb_NW&0rs$y(1~@<^-_eihSl@DpIl^9cLRATKvA)a{tB+wrhj zhUIbHF}3cPQgK|ZIF9Y-mUUCU>F2=~gC~Y;G-o}w-t!uSDGn>Aw#|+|IHT@50gvdk z_W*#hv$Dl{g!VEHVu>(zo$n2y_rBn^l2q0)@TUS_wFshS58r$||@v*q)VW`z_JYvLU?Q* z;0gY1CrMLChko}Q4fWM14P1a+(JRhxo|!p0>wG6)?(UI~&^g^X{V8z;$iuM313R_I zNW7qj7)A1UsWTW+>0SDmZvw>A!H!A?>1QtiqI30~$i29Z2S$hVFEt*I=L{jrxlx?< zQ=jURALBi-uc2{1e}Tg6XZZ@v@g{xxf54N(wyth_tKsbi1Ymeny>_lxsottqZzZ33 zx$qmDk@cc8R@t#oxnaI?gHpLkt=t5k1eHM*K^AwZm7T&tL2#XnxPh?s%qxxgsup~! z=6$PX+6;fdF<;GsuW{bj_~WK+6bGMK9@O66>XNUl>ha!$(QKLf}3D5-q?s zq>HYf~71=(oL;UQB@1Yw2;3trJ&xcrPW8PnFbE z=xEraX4QQ&hi}@ZzG0jCFKtujY*W8$oBDgUso%3reQ2Bd2ezsImu>2g zZBzemYpOOEIQ6gT)_*hZ|94#JbK(CnQaepEd-bS%l zrCKAE-StL>|{sb8^8 z{T18PU$aep(>C=j+tlB%P5n(H^|x?^c3fe=B^C(oDVMPA`@T^E*_oq+pU_A-O@Mpt zPer*z;tP2>r)qCwt)_(Bl&-*1u&k5^9Q*C%h3iN3{C_px^*5qa-bQ<3q-t%Rc%I+& z50qD%`1}ndVC1#cG=efDW-;A#i$z$8NyqP6;XWe{ZIvdbM<0#+1zZCz;fmd^ay(a4 z(1ibDqWYNWmA-;f;)PuY4tAbBex~QtfrC9~4xD)Qc;}e|(!Zix9@4&vNF#ToI%*bP z)PJ3>Vg&w@z&wErCqOoVTmm%&>ItkR&`w}CfqeuH5;#iW83Mfot`m?5j1ss_;4=hj zsQ4g(d-U^51pYaJ`vi#fm41Z)5%$t|2>cF#2L%2tf!`#D z$gBVr+(v0;Q0#SYrSi<6yxNWUwpOs$Sx<>paNOy2522Y;V7ZT)%nB;K?iV<35=7qA zCURutO`MnW&dH&O?Cw|G{i?e^=FWyrs2f{nI-p_T{rp+_bJ>X;k6m=9KzsO%+|wt! z!-_ksy2C3z9Kpk3?cr5a8!I^I%%Z_*1!&CVw54JfJ!}C>zSPfKsw|;=7O=G5htETk znZQzImK!>%7O;f(e)zNvZfrPOz|vJ`zPlU!k_?v`OWYf%k|waUzK$wx0ZT`njc$mv zEMVzbXO4R>N==4K)%k9O9#vJ!{%4z~j)%ElyD>x2JQLvPj?mmN(6Og*U;PWp& z<{L}dmS*KvURob;7h;>z43<`Bxi?YUngF$}=_lV^E^Q~>HG!pK>*S@mytL1`n!dsU zmY#R!5!$eTrTQYuXaP&@dG313X97$0CG=7YSX!UQxGotk)mKuP7O=Fljs}91ATJDA) zWeZr^>U3Yki<03|hReO1Dry2tz5tC%3!n*w3R%DsR+kXUTnUPO4k9$pu;hq&yC*GV z+Hk>eTXzwDaydocZ0-t;gjhTEqMi6Eo~IGGmxUXgVd+UJKb|TAy_k?r^_k_$E>sBg zk@G#0*9b@SY(nIAI>=mz1hdIzJ$Ey#ic|^j2P2@K^dq6hl%yJjh~|kW>`jEMGG`$*f`WTPOVsAv+d|-NcnDq_xv)g>w7EzH zA0+RLy&tqJi#b4|P$*~hAUNI)vXu}YuK%J&B(qsEiqIO9c3sVliHC*n1=H4W@KEE*hpsv~0(^?1^sLmLqO5ExBxQ5@3|dAX$KljA67G$*V5-6a6${---adAQhpt(L zsJSJ0oy-U@;wbtTMjQN)hAfH}24-yKy?Em%wEv@#!T$EKnh|n4f-@AnGiebF82Nq&Np~oDTsHaD2MxJ=?iQ&F$`=OU1 z=4U)pitx^;^aCp4F9F~hgQauE2TJAXxW(cEdQH46dC0*lQgkFl-sWlRms%DF>tMz6 zQ`$zVLuvmS_%uo-!qBAM;SS2K8uPgrTq_6H!a>E!i*oQKCHRsWd`Wgyy_=aoRi_rT ze>X>6dtAvpp=O?7jx*-*s-F4leIj^WL`EKDGU*eDW-I z`xWmw)q75MofBJPZZQVfJ932hao&BQ#)@a~XGfnLg)8_`n9xNo2!}pTy(pSp{+z(H zym-+hMx~cM85Sk7p7cj8-2677ub-MiV}cJ_Wa&S?)A^njnS^v=ck$k5#@$SdE^WqD z{W-@7Ey>!ESSYPaj8rymdSb@(g#IKna&eh3mxGQzWH+#Zbz;Fvaw&J$!yYG5JL@xu zQth$dgdWebZYuLPW#9DW%erie@x{tH+6ZIyq)}iAxTeq*mEf+SnRB*sS#TIE=4LRM zSUR7(5&=rrOm)Q)h$0fYHf-bzjUlox)3yIrz>)L<_Q0ksZsY`6uh7qU4BBsf(!dQe z&Jqus5}vY%)Ya8kGJ`*tbylE4ebKoFPcJgEM@)C-6gS-o7G8eTaXqf;qoIg z7`YB#cw%uN1R$K;LNAY;M{`G!;}6CPJQ{el*Q!cp3xtN)sTAL!5yC2m#^}&Ti6{^Y z@hExQr6P6GK`YG0FaoN9H$vnByC0+F#wgUtgUzTqDkh#Go4PyflqKbLq=0%V(vLMx zCv&JdO)5Khzvk406B8Dz(Fn8*byr$Q)>^1N;p&4vNwlGs*V2gQ2GVT*h*lsI5cBJe ziW#P|x(^m|79I(wd=b4>dl6cAa2RD8PFRL{q(hI6rwez7dB9UQiuo#40o5Alm+&B= z-vFUsTGBNylYT~3ta<{p|7rcUxm9y#Ci5q|rdFv1t?=j%yYHk- zf_>~m5n_d-#SQx|WSqoRWwJ#IqSDeT0x{fZ$&u>mnn@I!^;ZxuzlWT0k4~EiU57uV zVtWaYls*c-vJUDa;}BE}d4Y@!M$I2Dt-%ZbjJ}p+?fBZwjsQ6DG?D=TypjRqqLYuj zMN@rh@%rzcP&YoScu%U{lORyCHpF~>)z`e>TRZPttN7NdzV)(i{rih-S~Xkx&?oy( zDEq-4Ls(H&Qsyx>&?x{6y@YA~lsDq6-YX-7$#f>uGY36!;vaVM0u0@_@8 z%NY;!Tn}A~h;aaC5Zo3}tzq@8y(l#b8r-4V8?cgAGc>TmScb_pQABh6X0oJ7Xkry& z+cH{*$DxRocTAiQihrD6KXXpWZ&mYKXZwwGL2srB_d`FS3F73&C*=@_ptPl7Trvny z!E3nSM_#`usmZk5Arsux< z2V7WH4p+2J+iDhDn5`&9k3S7S{+ajcKl#J%yND_PDUX$3Semh51WU1vNz2Bv~!NvogiMzNV`y)KoQbfG_zEUKDFXwLgizP zHY3r5kcqUqeM8z^Mx9UF)qjnD7+DpkaQ>UF2b~W-HGT5O!3}erN^r9p+$>ja5% zvIniR^j`7;37tW3pABCx zR5Gj8OzdR3-9?Z5gW8XjV!xQ+eRGd-)i%zLD=f_2j=g#7kG~+EeFLP|&*jj!glG3Cr<}03Vh4Lxl zJI|hfux-ArOK$6W1k23&FYkP9=VTY`7Kku8LE8m@llvdlteq>Gi~dgeJLz)Gai!+C zT628z*mSz$tAs~n5imGu1ZUvIZ5?=VA?P4yRu`Am-izQ~P{C4X!8((8nD22(f2J=TQjLC+J4Qk+bI3nE|AmL(&AX{@r!A-&=BnpKuV&;X+1qru6(b2vu z^qKp?ClLk6raQ!2YQ>9SL2y(OZPTf6cA=tif^cGqrX=@_LlHz`2XBOCxr}NL2m3>i z#>4KOJa6*LnX~GHOch>O%=T(VpHYu!U1aCfj-T%yhIbypLc+TxIpG?B|4r_kXb-)d z*xS_R7ZFxqE{T4)9)hE@X8ps_z=my};Nqx(nR(E59s~o*+YeD}nha7I(7{4BxCPTT zL}-tJo`Jm+1TXAz85jJ_@DN@L7c{~R3|C#NpEe-C`SbgTyA)PwWPQh9i|?Vr@Qut( zj|8cS3?`f^s!P~OI1TPumy&aXXsjn`+%c=v{iN+Utk0#;;03b;zcpD7PaAz?yd~tt zrI@HsEMcR~qGw@;D@jDGN?imx0W21ngbeWC`Q8XFh`u7CK^!*_>N4?*)*SP1ZJqLx zo4;i17sBlcvE)RiSun}Y7=iJ{p;2aFms$MHnq4Kh1!cX@;g9gjM8T{C8%^XAv66y| ztn6W934Mr~xyhcMu{BoI)V@;YF2eqYP&oKb_%18FcLxrbrw`pf4ovU$Pi=W^=e!pd ztTk|`F|}nHkq?_xxbyTi;ik$y@ZT+{mVMQ57Y$#ZvQINj`9mdi+*F#UV%@{(d5fpUi%>~s@O#nlwszI&oecI_6Y;@bV# zl}&r_R!|Bqomq7|AnHJG?!!xs1Hb9`SQbprf!iT$PDY|3^5{crSwu@9{AgKBH0-56 zU=kT)zc+M)1c2JJ92YAJw8?g)QGpXtoPJvqFgBCVVa7?k)ac>uJ{I)I7}1O(`E&4j z3G`@u=u@J`{b=*JM}MkY+KGM;BZtPRwA>i9pf_X2kz8tJ^k#?1C=i1U(gPt46z7^T z&=?9gj<9ne$)^bgX0T@lEJVH|;oHSJ&#k|p)BrClVJA^#B7$|dbPP=cQ%=UAFC$&p zh?UV5-_o2ZbGsSXROr#t{e=COChMT7Io5DM8<{Jj&Py~$Y4NZ@oyApCm#42O#jDj~ zNXn8hDIv^Qpqhfp&TOBRl)!p5upTb*J$Ya9f6@Qr($%vY-`=H^Zc|IQDW2`BXS?j# z9;+pZ+fl_+BPd)kVgEPbS!o{)z$Dbl2y86h)KmhW4xw431M~pnwS#nZh`?b2NeJ&K zr4cw|kMJ@H;SnfsxT|DWB~HavX^ZfnMwLyvR0enogvYNZ{)oLOJ@J96VOb-#3NBjK zuMFftEuHUe#`Vd^sHd@7FtO--`bfOns=%C8pPFPi9z<>XHuoH($U z?Oy^tQX4BMdA;S;mM^b)Z4EhNE1J6e^%2EeuX;g+WM$RHsvEv>{cG31I(&Z^CaF2i z48EKVAH8Q|f#T`LS9eYAdh`68`@2!4VTanVV`^8du=MrAuO9yTb2DeZ`qKTE;H*g{ ze@%2gDyo@rzd525wW>v}kap!aLrn1c@mG(}6p6r6!mU$MHm6;-_aEn=Hh-V%$Ss}D ze6vu=X;jIhk`p!d<$vk;7mrVuD85yyZOZS z2yCd;84BmpIUhZrq2!cWpq{ne#K-H8SzFugJ>>or+u@=%a59Wv+17kQukZwI>optI zXt91PeO+j~_?inGsF@hqi@{yY&<2Bb!RB=>t1NY=M=n_&u~zm1mtZMky-g8)+k;8Z zag&-VVJTt*im-m3_~vH*zIK*Bn7Pg77VAEEQ&W@WD?V-cMc>qVhwePnk1Q8bN~hcU@#!WK7$I8|T0DXfA5C`?KBx6e=D&#tC~$Ps-DOL^xO_QH zKPKv^IpC+jwvk+p4k_H!v)o3keVVX!-p} z5S##yU}KudVX>7!tD7!}%J1o6{72#_$ndU1&XR<0z(OVEcu4dFiMk+g2~nb|P2 z;hUS@*ff1X4YbI<7Qr_#$5xD7CTUA2ep;AZ)Jc3`9xgzZ1M0_TozeuZv9rQbHO+04 z!3SFRL7D4YV?~rJ@_v6n-$0}#f?*?&c?~!^QSIe9vhB!iL8!g1THz9S*wXEGlPuu zELihcLAEms^yV@^bPvChTp>Kkqv?79)SE6=w(xtXlo(i-aAEDWgm@S82LtfiGzj^) zs?mK82L~snGExqNCbm37oFefC-SHBgP~iX}@FxX*7fhWfdZix4NdHK{frs@lJbR4< zs=9SR7ojQ=fj_3EZADI!ZXzKg36_|vmk}?RN*@V8?C9dS7D^l2#atZhe(264E6CgQ&6d+JY zpojoR$02;mtBXL8By^0I8M7D)tdVvC+TNj5PWSUgHG1HfDl!!1deZ_cRT5y;w`#gF z+!@64^#a>;vA9zqgQ8vz;;@eHw7%ieIMwUoS$z#mfEQy0dIj0&_1YmiawLPmv`n2nU7*p$KC zk(=mdo$00^xoUQasZeoY;43Kv`kobLYATk)HMCteG z8J-HAbj4F@7hQdYz+nR9QzPy@i%rSrgm+JN8Y`91i%wI9GXz+a@_qW;bNC4tf%;gC zXGaHzN1{C=(rAR8FtRHIHa=lhPTm8OI%wqm3KhijYM8EA_eZ5G+G%0Ar;xBP`NnG# zBW^}wgg^u$K7^|$o}FO65I=mkL^B12JEHGnhyzPGosZM9oGwUObWrSYZjc@8&F7+{ zK-SNgBX@%T#T?!V{ugs(P4K^%!#~0QVvai5dd3`Ovh|EP>SgO0a}>$e^KqKrnFiC| zf3lz!j=yC`p*UlX)AG+cV-B>f<%~IAlt0M1=-47#&&RGTYM`GlD0DbC$&QWYGv?SU zFMq}ym*nNo#q>O=syTx(mdXp+ynr#+5!vpHxwgsHGp73jF`R4fhNd$`2uKV`U-?nv9FI=5<1^rjuIagzP^@_&}Zy`NgM z^zL>Pm&Zz5W9#Ivp!Z-J$-97eR>>H_la(}^nvT0 ziir!VyIgkfq?3ZL?hx0H({_;lK`L0Hw4V|{O)_?=a9F`v$DQd;KiD}7@MSo2sgZ2~ HuZ;gcNk!yf literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/main.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/main.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b448b1269e4e7b2a6ace74012d4c49eec6c7471d GIT binary patch literal 71061 zcmeFa3wRsXeJ2VKAPJHn0g~XGlt7AaQPhi)CF)6&dP}sdw;;(N$N?ov06`Bx$)d@` zPTZDGy$zGPHJ!>0+r};(D>rPK+-iH9)^3tU?d@&{{KiWZySl4(>u!7RZkJvsx32DP zyTAWA^8`RicGKQ(zi&sQ;b7*>dH&D;eg5ay3k<IKJ~se>|Klwp#uJ{ZJ1Fzp;MQ zX|q^fvz)dF7N1413Rxj*ILl|V(!DKY_u1LsY+p9}o8!x2e{+4g?61S;z+ZbPFP!Jg z3+Mat*>~BY+;D-fAnf!x!-c-WaFMSl?DDz7Zl60`>?;nJ_)5a1zS6MA=Lwhj%EINo z@^FQ(LMgM-SIP3O@>St)PN*_m?W<<*azj<&8edJg)>j*@^VQ**L&yuQ3a|F94tssx zaJ{cS+~8{nuko!3H~JdGO}?gZv#&Ya;%f=F`dV4~{7_rC-Pg|U3qotd9lnn6I^R0> z+ZpN%ulKDFZ}4qkzY9Yf!<&4Y*nLrGbGXab72e|8!hX9#TfsSXlHnrZx_2S4mrZReY>reEKATMlnAA_J#S@MEbrhyKYV+F?qF$fZ_qiM zRi!?(2sXhsY}0@HdV*!alHim26a3n1_~i;dY0e?&O3!mRTmQn>E0hKMgz}vzGgu&Q zL0?yd_J#NR_M_fbp)zzJe9(80-B)1@4*3p+5Bm;>kNA$Tc2$RthL8D~~G* zsqk^%)9k)BbRvAxcQSm+cPf0^cbYw`!?QEKvsTM!R&clPoUqDwKG<~Cr#9GkAKnlpe1`q4zm+5G5;nh-^A-}kqb9TX{5+kK zs_Ry^uv>T{Jr&POyKcLcE9?<=zLewhW4zjf&%9+tuK3Rn-+*8{X=&R#QGGOWd1S~t z91*=kVlWUJ8NKWcM}%M~+WFU%w9T3<2#k(KVt5r9jrO-?CGA6zv71SU5DbpdU0Y$Y z@YMO^`~1BJ_w^n*)PEpp>lwxS-asf67z_n*7Yan9X98l<-ZwH7OXeL2jt0d*EFvaz zkB-D}8%o+v24l(WQ{!VupL^=&SdfxupB_b-C@&C=B^{CLK`|5w2ya`H#m8?7fzjB= z(CJYjI6N{M6xwV_`^jKvIGINu_k>0Q(PYl)(XqhLwZEoDx8)~u{X>z_;gQS90>2O( zim(bq@pO137!smMryqTABOnTXF^FvZm#LB?L(ycRKO7ml=D!{Y`J+KGS&EJ_yElWtz{NsK7Uo>nk4Dhm*~`AP1}= zJkbs(zq5YyR-VQ3GoWrki_Z%BmIW$j_1S`U@kJpkm@U`{_vKjxJMOcU`yAZoD)$cD z=h3~8kGleP=fqthyDP$-i`}_#SFAlNVRxl?=3#ebxMNsWsK8w%dscXuSXVadq$MgRpyqNZU zgRm_86k4@W_)z$1{N04H_^-mtFJ=2S2kp@!;iGBGuvPfkmz=&X;YY&HA;lKqBjJnq zyA{7@@b?Mf$HJHKcboA43a{etc6?_S{#N)!+;?M!+l7yXS={ds{!aJ`{_YeW2)~5C zyM+HwcmscT2lrgvtHRFJ9`z1kbg z`wXap@ZHqO4 zolmEX!5?JEhhvv@!Vg*BWeIhBj>sunh(Dt5Pp9Rym@%guL4HI|XHxq9{fznK3QMW^_|B$$ znONb=KTZ4cTw3juD}4KJQ@>5=(eo*F_;)Mhb1yX?pKsdooYi;Xq@~pXd4utFfvH@J z<#aS~8KfgJ6z%q2iN(gE-RsxWug)<=gy|H5*Vk|A+_oM9#ZYi87F{1^;@A58d@qh3 z?;yBe?+}SlW+_c&oK1p1KnBjt0WPs5dgq zbEY?5MU?VJM!hklVAbd}WHQDXSw9Ifya>wd7$h4o^8s%FoOz6WsU-C338|orc}7*n zU9Fe)fHigmG8PGXTrM@_V62wXk&wv35FcYf%IfTuAX1CG5#GV^k&r-=?MT$CrV={5 zkaz)X2`>#0OVTl026{b{UkthsShwXz?!YS5+jjV z%KKq46835!er99F$}2LuKdiu@sR^XgP!cFpWCsSHH4Cs#5X%OKk_Eick?=?;AbQ8f z#jyzHTP&hM7@t7_@iOY&fw>eBM=p6P znjS+dMuG9*ibZKq<@al4F=Y{z(=)1lr{hlVjgip;+?X zxDp)IiXq?~;JpsmhxY423;Vd`l6TiGZwsI?a-$`4UvumSofktlkEokQPWV^e;B#Z4 zk)e?ofE^iR97~m)py7vzX8dRt^x#K#?a(wa+!J*d=Ht{TgNU`zMODG=q^y2(>kUqe>u=%-DUZF6~mX(v;Xh z2hDGcDzaApT-D2Vs>Fe*DMyA>(se0WXUHX; zLQJgI^3uB(n!QWjNpF8-G-&=l9RVBaLdo%!qQkz>!iSvjBtxPt${?vcgZ9GjH?`D= z87Hc>+NI($bN3iA;Y3%;M>=Af^sc0PiHwH?Okl8WpfL=qX^P(tuXgJlV&({KzT<;N3@D1VA-P{2DQoN(&jw zI|>Cg=XY42UJKs55fKG2yqCwrU@oGaTyP*taUw7h1%s6#H}0X2&T^nSxy3>b&*lf z6>!yze0i1BjQeGv$9N;1=A44sy^wOmtmF(p|JzyON%VEnrPc}57(C4=nUN@^=%=^E zem~g*f`hOkT^SL;eMN0}j*fcJ)7O3RY(%_vu{T13#l>sm%%0>QjKnSmN3UNzIx=_> z)eWvA3lt>4=tZ>y*N4GZL;54o;=KGsi3Z$YllimXLOIb6Twbs&msslRB}Y}l;glU~ zmK>WG9h(>W?%E~C=D6dS>^LT==SN6yImG~w?&u%@L!GT3xpDKF#Rz-=C+ozoz@&su zMl)4*f=H?`E)wV{or69%jLiuK>jvqP0H+7jkI5JT@g^}>#vGZPH9%7XBRcFI;Cx6Y zOTxw&#zkThXg~)V*pN0DIFdFin{{tn#bGodN)7UgS8z=haD2-$nkduz(D3*V=o2yt zpc{)UZjbD0mK@C@&A?C8P5()0HRHpmu4p62a(EJmLG-#F1V##u8UdE2BUu`7%<5#| zPP9p}LU$@80idl@><>qLNKM?9)_HYX~^&a zc=o_}h|mB}?)9R_8L|se=NbCj%{x}d?i1Ciovy$86GP9tSc;OkK#!@FrHGra{Zl3f+Z6 zbQ;rLWllGgc9dGF<$T#X<(PEzSuVXkm1im=FGhA*1(puU*nK!2y3-wg!sVs9nrt&BAW14Z!Vi~uJwUhaus&>{_zM_oO0R9qm ztlS$ZWBkd>o3XxfYBG1uWo(;zZ-(b+719xbNIQhA+ctA=sP#bZpP#h8kTsb-1$IR@ zs?Hf;OV3WQn{yGeudx{?t`c%yLXSV*tTWeo)CzX0Al9OnGHDZXC+%iat<{o}!ZB%0 zO@aD*)Lf#)De3bj3o@i9N`{G?Q-zaGRQ0lM-h3ypbBIti=1QZ-un&=%*T=D>ows}k@FF`oqiKM);f zK1o?a+^5P>sTvio(i>3p)l7AvvRGiz!7&>+33E=ILV_4D8VB_y=ere6p+ShyX$R>M z84ZIUP83cUq|k*E$-2}MRl?TCNgeSuq(~u^FR1Dm#D*ZW!BComIC>*cX^95bhq%zO zph)~`P%zZKzP_GlX;34ZRLTG+kzjE^x#1hs+BU$ofK2VD6c%M%gq{>y8I>DSo3E(g z$Hd5W@STFnAgc|bzo&@r7>P2yTZX)h>YWZMaFn=Zg)tk0F#)+6`XL}tG2p;7g`PIF zEzsd=qhV?-Ng8;ia<<&-i46*Ksp|9|0=uX6h}KM2HR$~zNVE)iTd72a32A$bn(_}Z z62{JW5}rfQ=F<2ngHM_;9igLEnSgtlsUBKpyH&<)uzsNz1PNoGTW z3`eQOXIBHPaOtK^!sOEnu8Yc|GfHp?}emo0U9XRRNy z>&r)``(~OFF3&5^ORnbmEw^{vX_nUR#hGaC`1Py5dUc`f+coj#U2^lTnZj8i?p~8{ zSHD*D<)YbG+}$X<8zpz+eYa=!u;gyWIe%JS*DI}i>c=^j%7(cnxnbLPJK_}wknlDwdAk?A-FLRey-&*CCug%0HQx7I zw@Wp2CN@1Wdu+ZjUb{X~+x*r3uk_D%#cManwHu_`4T;+N*?k}1ca_d|ORgrIiPDPM ztuwo4b|>05e6#)Q?F*;k?cH*F_sp@m#<-^?;aT-s|Cjscy5gQz+0!a{T5*%8TD4Tw zzF5^Buj-JiI+iWg; zST=2uH}))T+_$)K-@BLN8~f#r{nCl^iyO~NIN9``9sX+QE1}m%Z;j%2+__HXliokH zY_sIKFfw_Sv)0+}xv98gi|p7UIkwz$RLokXny!UwamSOg<4MW!WWrSdgyh;?AA2bEo9odB31YE@)b|6y)tnI187Yb&JkA0Ecsp>|7%`*L>hApLtfQ z-Vk?flwBK_Ew;j~3julSQEBVBL~X-YkACIo>;1R-mn~VvTiNAHeKS2X&n7A=XM5z@ zE~$dfMAw#Ct6bSR|7^T+J<(_sh6b8j<&iEMk zxghkQ@BB@N%l|@#LBG7C^$l_8SK%VekCnce z)8u(ICH*zGF+E>!{wj!RnsmNbBj^FA{Xu9~bba{a;#AFK(2J8>QmLg~s1n_pNomvHsiZr*jeo#e@iZtO-}C?D8(T8W&xS zb7$kOb+T*SLdBwMo8;PNLVG#I+m|i4=xDD`u3aZp(3x1*Ih%9KHE)eqwo8@m_iO6q znl7nkXJT9T?0&g+OX7)bvpI6*#)bNLWtUXhwOmNKxh=&Nuez4p&5Q2lx$ALvr|j;O z+?@$$iR^4&a&BC7Zd_>ot+n4;`y1=N4U(`|cJ7s&dlRm*=|Zmd%u#F%1xY*gPcj$l z975xC6MRm&0bddWE0c5#-c%U7Lgk%*d=z|F(yjhf)wW5e`eYOu_GG?D%Oha67#T}C zu$qNDc%n(SIuC>XK-3=?y(#`0`u@Rc&2mZWHCj5nExd+s4w!^9lqh};sl+XGd6O=L zDIVm*R;s9K#b2kV^K^NeE?=h$ty~gsq29q&v=pye4s3%5-Z<1Jg z0?WY*04k`qa^X+%^NLR>|aIdj4$ zkIa}E=9rmzoH@#IJES>79c983X_!C{ZF657J)~|3omD z&Og!9{lq^V!nfd`j#{~Sb;-45(X}PvbSH|-5@mG>PmOX`wsQdPturitf7zwg`}|xD0GdGTR)Hp(~C0;fQihidT3IALgT8>7J^HS zitZC$ctfev_8OqXTEPbqygKq9tseG(a7;^L`LT0S0>GOXo3aaBHJ_?MIaypvI zrl#=kio(h=sn$0w!(+UiJ)Kx4=RcC zyP%?fV*I!Z?No__qaCF5V*+hEZeFv*&=B=tqAR0$5LWTcJKA@Qg8c=OszqoN zhF66d`~pl!3vmPdLy5i6?L{!}HjxXe+<@9e`X~%= z3-HazI7t^#vUE{bjSP<<=mds0YRY6KVHs4_<(fz8VpMA{0}X-{D>|vBq*F>G6(L)fpGLeS&U+~ zTwtJ2dYcY!XJ_Xnli!{lnKNKtz)dQ!#|*5S?uBRejETBpG+~q@Rg3>QgnEJxk+m;H zlRcFs*ygD0v?I;K%VyN&{}RGzOxkeGe#4F_mlK#m6_q6(3`#lFk$sZQIMxxc*p5ta zI3isRgAsr-OG?ay23%}$oU(ulF4AQ9SEc}1IAW>-Lsv$yR15&FtmH#MgsvIr@DkPB zwNW(|kj^FYk-}`Fkz$%ACZVF51cR)Ko!$cs6a(g(Yqe$og^TLm!z8y&Ow@%$3>6R5 zJD8L32O%~7D75A=WdW)330LevIJh*BE}T*|fM+40543_f!KGz12FIBjY(W4zNO4y| z=M3<+z&%*2TE+=?GKIuZ2U01d!RNz=RZ>vztNAfsAVV>*RKxKIQZ{-@Z=kVMCP$l{ zGfp8fV+*>uBfY?uVtHdC)7}{|ht@@W*_5h8P{);!58^LrO`O=#tM)1XKv739bsPFe z#Yo)cBPAD20;6d_ihAZKA>igU%VlzuST|)g(I2aEN}4C42xp4X(wIh(ES9U7*!)N} zNqs5nmClpg;R3kqr;vyVgrXOBNtZAZ1sR2sJ4zvwg7C+mpy%0qdel;>ON|qNIH@_bp!SMEb)Ybx4dA_zY>E;b*YnUOTVOa)YE}C{+BT%tI zdnf82*(HBK&A-N)|KkRWyLxub8`p1rChqE#U7cimzF@sqQX|!#kC*u55})MsE$3S* zMy=HP;SjFz@~~VUo-Rn#tp4iuuWX;Y5U<%N*KCv=m5GwFS34wE7oGJRl^fhUx;XPx z>enhqwkKxVFi{57j8g`JOIjX7EY8IHPw6}XjA{z9#Qag*@Vv0_shU(;Ex}fVa^W{H zjJ3GNwa?5&jrScY0OSIvJj3DwhK*4MSdQUw_(%Y@m>#AUIS)OMY-v5iyD-SpX_j&#-)0fM?j1q?^sT zsQz3`ARCb!Uc@9WNgEKb_-}Fdpg^(VklsMUBm|mdmS#jf3srzF#~RH85yeA(h*>n4 z0bLaQtk0Rs9{p)J(b}$2Z7kx6m}dS4 zR?;xkr0sT!>+zTs%K>s?2G{Sa8gqf#YUXycA)I|h=KI_?t&=%#TBov2IcQ~1W}Cm8 zwD`3gN2^TVJVvP~Mavnj(#-de5wguaHX#_TrQT0Egq+*C=8|Ak%f9VMlT7jg8!>37u>1#eKv{6kNUrJ~Y6^=$6p!dJ zo0$f(%DE%hdoYUtaKUJl78KEnW-RmNybHcE#3LkKR=~TTNA5cj99C>vLyUFcwhGiH z8VOwoyU&+3X)}^4piEU-cnrag&3d+0p4Ekv1HugSEUemH>eeunC&^ImLTnzZ2T z3CrHREMMymC3FN#5X#CN>d^sa1TbJOLMg`CZYqPlP;CL`e3%P@j+H2z70?71>KMlG zhQN`AR3jzFDtZ6{b4@p;WKQJWfNFTI?BPl|s5TmHpfa*}%0n+tO{klCP!X^QDnfAG z5N>)K)b-2_Y#a@pegh01fr#q(Xs$SvrG~VAB=&15J8(xUKB2DVE*&V{keD)t{fEF8 zR0ZZ-)J(hq%$z=q{o)Z!Hj$xmYtpG8Y>uW2002SJ&){)CykfH<{SI9N1tCP8bft7` zn_E0gS&?&TG8YUa^S>nIDAv=XawYF!;+PDme>J_V9cQ63{h{FK2vLk1!N4`fk&_`& ze2S9PuzF-pk*pw>Q83MEgr$!@^{7LjhR!6hU5w+ESViv(!QR5t`mBgxi$Sq1k26VT zn#9PF_~(?|#haiKH$>>9lJ%ePPoeA>xg_{z2WO)SIV+%y)kKBHpD6sK^5Q=dwMEoh z3#jb|i@R*uvMR4=wp6a##O~mdIMa3C)i!_f_C?9H9p^oF#jH)Ldm`@MCcC#u?rjOz zYRR=WvHj4}_Ws4~{qgO`@i7iL0^L0}5;XCVbnR)8o zwj=Vk%hHt_@omq^+n$^0l|5S|&z29Gx693E5|uS_<@OJ4SuN!d;akdQp8B!FvSx$a zaNw@(u0P&zNp83_<3gt8d#$rJxw2I%+cUrJP8t5-oZf%0v{^3Qk#LvdeAS6|%I>DQ z;e~yYyF2dgmfhWny0(OO{c=H$r|3fqE5F9>l{)zBJL~34e@IT(>$y$uLCEBv7$gbRTjZ?y?82NC7~e41(^ zX5A9HX~sJ#on-!=7U~WeS92?s&^y(fnZk5Gj`M-i2(!60gOsaupK2>+mH@)MN=;0Z zSM3<%qK1sf{1h_K5~qy@pTSu2BK{4AQWS83R~nO~KBNa4^e~7LFXLI1V26LlXMPc% z`D!5(m8nx-eX|<4IJy~Mv$@Y#UX!10+mdVhqH8;;$8r{2cPlU%-QAf~V~}N8g@|2E z<}pnh`2{|x06@SrI(QSYxs<;FQ4HMFK%R&IF|G{c_u_^H3?M&K-1FmMAP<1Ym-?zL z2JmqJ{HO43qFS$CLsu+dXJG|&h07Ur{?Mp%4JK30QX{>A%W(aPf{(&G)vB4s<)u$5 zt(W-J()0UC&n|63>|<-*b=?&TGP>d@&|sbonO44=A$P?lpU6Cu##Mz8xQzj=6SP(F ziUFB0$>?Q$W}gy&1aJT&a1wu#g(~DSbBU@N{xM$ZaLDHb0T-JSd`gs>rv$gQ)U7lx z*z27%Iogm-`s8?G(e=cgyt~bkFCe*|h`R=5*P!GWWJKVf6vU4kak>tZ3O-_*O5TAy z2*#&`P-JI9`vgb;b*7o+%0>qN|C7Tj$C!j^jS!|TH$uca*3_s9WIFaGWS0@h%2R+$ z$zehd=%TP*8Wbxj5DroUwPqy(hJuH?7hT|>W;hovdb?y{9Ngj6NQCm zDENT!#}_nczC>%1SQvG&nd(aVz#-sE!nW)nMuB18+qiig=af`C1Xdx~UhFg}IBYQ@ zL&~8?2`~%PQLKj06&8YFtAuDS-e@_TL=bJTHYuL}!1DIMio0%ymCs6!ReUxU80sgsP}@3jF-<&W5?Vj1 z#GBVv0&;7>kA#l|a)X)JFs|tghoM>oOQ|EQkB}Ms2*hdW2U+g;dR>4rL97bJq$(m% zWDu?ZD>ppz_40bg>1MDSkbil0dMa=0!1FC6>9=%yTSmt@#FOtl2M#aFlxn646ic`$c^@cfS&Wiev>G&9W;A*OX-us3)h35Uo7s3YH4sjpyU8HL`1sAg zpc--r;lmk{$J{0V;UEY7&AyxtDd;O~E4xtM8I(*Dv0}LD^^XoAza%NO$Kkm9LAy$Y8!a9!Vvgmv*bh4M%h(j6kJcPxWW`$N9 z8NT@v5yg&7h(@caVbs;O>k9KhB^*MA26Mt32;B(WjFOh!&~64y$|7`wm7Y)<0`hTd zyrL@w=pi=6m61VM-=G=3=|$@h<{BPAY^^@QH6!sUT}jV_qfzYB!sdb2)B#h`u)k^J z0oPLQNslFSqu7v#&mX<}d974kFWM6wABIN{DKS%qLKk2S2nZ$y)SuOru_gl?=&(kQ zc!~@T2vjmHvlp;YP-b`{OK<3=j)bw=%FA{?>n2TJ8$ z&=QL8r!XOgk?%WO;u7Kaw{iPAWS<$q0o(1&SbSA zT1d)NoM_Z>@5-sZN{EAOVn7@Xx*arGL=XgNo&xtGw#$Qh`h9^MlAvnI=%VysGfScs zN(qfyKxstiL=Yr43NV3rNfTsI1KkArF=U6I$v1m8>1IzD+N@@dA2BJiUc~>CFu}#} zt$K`G#7B5K8O?#|=F@12(NAj90v{&Z8!6GOK1b1-H1nunCj~q|qD?W)I0z$PM)M?M zjHQ>6onA%^PA2LxX^j!4R}OPeM6q&v*lKn_(T$ktJ%<=ddW9{q8Z}p_eOG8zYTuj9 zvtP*1Z1{XRKXW{+w@~0aTA@f)to<YmCqmM-MIWO8fOBWyipuK{(uL-d{`1lZz&^R?aOCvH9jI)Le{zh5XwE z=8-`BI`=9sjnahfzAUCwdom#I! z#%D|@N%|Bi$nQ6}zp3ftL@^1ZKK?7qUs>P+SL?@lxA%?na$VQL$vYkKx&w0E0sh!{ zWo)>JCg_W}2rvoufe)-75mHxTEl~_WY(Ru4OF3})^WYOENr-=dBu4r#PT|4C`p0Vk znV!jTy!+o!3##!YD(@cR=UmxL*{ogr$?E#okORm=np~LLs(EkMkrHGGKDF=C9O_poUl#eO0xS75RZ5iUvkKZ0lex=5zl>_D zK#{Cb8-PI9#F3B-H$^q31j*W!8cK^5#Q#iXliogA!6I4&wa$Pn#AFaGiDWFB6N8t` z;XRggsBf9GA~^=oL=j79fC(^?N}vbgdByiAdlwdK4?-cO)=R`*xRxlnC3&@DFE>9R zx^fEi8vWGMUVe+9U<5<_F&x!%EG0E^@wPjqcShsI$K>K;s=^AZKBkW$a?UTbNd+}H znQNmzUNRt;3`ov_dkC5nm1;Y9;0W@543qccES_ECXS^gNmxLr|hy~}_uuvjzuEzgs$gQ9eH`_0p+)wnM6=GhVV&E}^JBAGoS!JHOEscWsbe2)1O+Tc23fA=PzG z_uq3A%Z}Fh()rQ2W0&mMB{?X{PM`Il^`6r;W0Tz*7dmA3o_ANpoyTS8ahUA;tmJl& z>$DR_d&HS2SUu-l@@`!8Zj5_3%ihfk7nimiT-K%9X%hkQpM-rv0D2mX4HBr$t zW1q2qP*H0{2hz!B@H1ZPmvOD|%N70^`~9*?xoqpgb8^{UsqDbJz0>;>RjZe(o>;7U z;*LFDwM(wrHGTMAS#^R<+i$eV?MLn&T{`MtJnD}h4ai3W@%BNveGt<)?jDleLuhk3 z90+ik-j5d37;jy;ekT?$?vsoAmMvw4e(POVqO<|t6N#GkH8_(4u#rle5;gV9g`X_T<&xaus{5YmB~R<3r}f=p z7Jmv37`+lZKfYH1ml1n$mEq#BlvU02E$89s#~*+EW2dFINv_#>$9K1!0#lv66t8(k zu6bt00pKXECa74m@R@g?lb${+oxc=!KO?)Jk=)NLuT8DzN{u#lfbkw>8-JSaJ1y?Y zX;+jY82!*=KeXQV!=`Fn?-rIHY|Og5#!B~%`3E;<-|ftz`wdpQ-?$0)f4JU$Xmjo# zZnffS(%q0ef!S;Q=-&V%m}RB3h|QoTb4Znbq*_0wvP||CIGvg$AcM^X`RV**Du11l zOIAuQ8h32w*B+6JEhQIHTCw91xwzDHB-J2tE)bs~LNnQfG?&sBN>XZW7qU}pHM%J+ z4aM9w6YBUP;|cDI9osa^t;c#e>@-^pmU~prib6*%6Jg$Gi@h&EPjTn@Cse1EvYSL z+y*t9MPLFGI86790MFpgTUcUOu)oB|XRLqeI zS>UcX7hqoM62<*C;paSZe55Z0LzM^vVsr=;63~P<9V~m}@Tt8NdZ-6Bnn&U91G2 zL+GSnIHGJ(0{vJA>A5aJb;BIg(IMJFFwOAIe|t2(fi7kRe3PO*fz+by+JDHU62<$U6t>_&%g%yUhX^9a0S&}9Jcq)5&p;T;W6q~IMJIh&`pZ?q?+ zh1o`Y2+aiHAT7toiA|S^gC5;8OhR=`)azJjg^+7(f8|MPj@u%NEe^ok8Ct)johbu=<1tM)AW57-XW(MrU zkQGD9DJaU$Q55SR9Zykm;_DelFTR0a6Xls(kxezuLfMapte#u2f4lJAKB?tUyycLL ztK+cjI4n61YZ$BYPNUrYv~=#GwDD4W<0Tna$1}3y8OiYsI426fiC~*QY0P!cUCBFp zzDr))x3u=~;@ZRUwMXT(NAWmbbxp=#h}R|ejkx=U?7s0(L`D+3NuNyo0mE2-0X+5# zR`5u8pdKsWCyFv};tzPdV=T4#9Qlgqy1X>Zm7=W>*C38PN>4waqt<3AaU>~N#8mo8 z3-nzEO{}p7CoRxz88pn$ZFOK@4g%$Zt3!2mt)U`4i5_emRq!X%4StDF*ndM7@N62T>`==E~#9X7mCD+|@8VW%R)<5h$oe-~dvy>YL; zWvPDKV*R!|9%;|nc>OuK{+#4oh1i!;MVsWJGf~?)A4449nY??Y)wA2@M&hL#N z6z@sYG%nS2EY@_)pZZSM9s6%|f4e(gvs>;0P5hD?UUlm?`W8HIAHIE9?${%>33Of@;5YH=pj;i4u8m5bQ3#SBFWcxty2-Z{ zx8G}8yVSIEv1#X>Q&R8Qc+)w#>D)~JOg{=jJY#Dyg*;X+iKaGsGt*Bwv{ME-77vS0 zebu_0Wh;wX6RX$F3-apCQsw54@71iqr+8?*-dol29s9zm-^l-VzPtf(v9HiMAn=>` zsu6kBh!hc}N>QmOKF1wsMCIz)*sagZ$Kn-Tas?Pzd)Za%z15Ac-?(*SY4sC}t4W8k zdY8ORn?{&32S!4VCnrz(veq&9q#qvFi zv)5(&UXhiqWx2g|mhaW&_m$ed*V58gWcz+mHtxlrM>gUw;=){|@RuF=xH1Yc0K!X) zE`e*6R~8F!{(9psM}#8IxbdX8SG=X zgV$JJxS82{DdeQuyTnzfuQnQ)_wHeque1?*%o20WFeEsxF&;x~V^E=uB%s0@YtuVh zpvAaZ?PQ&?iP+3iU1c53T(c3;2&B(y^dcDP^8#(5mt~EQMxmj&0`iHe34o`HvPYk&pl0GcT7AdY~@GGA~=(=SE3+noqsd%_@8C8e2mGMGIK*xmqH3R{a`#h_`>3@1Gt?^1c7*BGX}Zul zO)g}99(VAlAEpNy-WT^!(RN}tQbPI=H-XNfH>uo&_INiSD*8JBpcgFQ8fId0MZ4sp z^ImylqN0Y#=NKcRW7dVnZ+FU@4jCUM_8t2EGxENRpvhXY1Z{1g|K!O(wAm_3eq_M~ zmV@FF=-12ZTTS z*|Sw*=Y4OZ?A>vvPxkiA9J*JrYWC)Qn@XH*WqYlO%KD|sw#CXe_F?5#xpJ$-&imba zX6+QPyD?t*M8aJ@lXKtcUUIHlbgr6>&7F=r*UHYdl5_0`;FY>=?Vj&K4NJGmrCX=_ z?!jKu_@*Q7YQqvQQi9`q&uh*vJ7-VLZHc?vWOtjSo(QZd7dI>wH!l`9OD#L^2=U@x zxwv=PQp&!P-D{WJdlq5BvA-+a-4}PCkliOF^)!AwcOzcBUM^n0@Wf(qw^ZDHCw8|> zK5|joL+1zOUa9`#+^MfUBRB2D9i6AoD>wBQs+@=KEY(qm`HMgWXce({cZ`+{BG zuvcoOGtsqurcd^)o$rf#HcISVw&#}ZxL3J)&dxUckSo_pm1|+5sA`?J&kGCt;+5TU zWw)fBAOE<(QVVV_s|+?W^>TmPE*gyW3-);B7D+vqv+5j_X&hg|q!;v=$5 zyb?I26#82MouB~&t9hhLz#LmLxfioeEom3Sp}^vruAX7>4)8AqzQU}jGt)|){{bHd zSw4frYhx0x?K3uA;sxJgC{e8s;rLYA4|+n}p(fjds?`}iwN~JNh+3dubc+OUKXTG! z`xi@D&f0I}oNs(TY302GT1id>%JIp{L(dwxBhbedP}ZMV&wftRAhg-~lliodLI|!c zkTRbDT5c=kbb^tHqX0cJrgbd=*3B1=3{U*spXQI|C*Fu7kYj>$KVklm^SuVxSL|MfM z4P3`fmh+ytr&IQHN}kSyr+Q}pvOSvw#L8NRP9>mIdioO;5wW#Qv4)&a#hvZgKS6S~ z-{*v?RdUgJ&t1OcZdi0T%yprP>ShbrZ-KU4AUxbE6?fh7yz7yB&Pm(pOn538GUJ#G z*JZn{c-VT6jI+&)p60pO{HeHS6W=1=3+A`Ks5)k$gQt5?F^xl8mmwIR2ia zC(rU;UVhIW+k2%gJ>9nVy0dZry{ektt(Na?-PqS+Gf8r!cE!+HKl*#zJl<-v)cGsg zgsdsssCmViAt2Y|X>{Z%s+E7OUS-ugY06!EV}%+!XC8-`Ayf| zP1-M~U=L`4aYpA zFwG*ya}{cOnISBYO1i*;DPcUhI;a%chM}_=LO>*Pq@l%|I+vKnjU{a`>R|&q7FdbK zj%jze)|;ldF_MIdTl_rDPcrFYeipdog4(45?_z;>t`b{b6>N|Tps~r$D@~NFneLtL zy;ta&IVG1hFO{_~mbD{A*#_dKTJP+O7d|N$K1n+>A+49v-glNv@4xS<0MySsktnNP z&b4nud`4WRvwxg#an;I2YnO`lEEa(q`F@eS_pIdeOXmmTMFF`eAUU|TQrUC^CNyqG zGudD@5S>f|QF8af)~!|wyOMwUcYm|)7!@bg#fbJn?ycQ(G?cUsy(=ghOS_52Q3Zh^5ItSy@L z8vw^h$P36XX%^pN@9;(Q9coz39)sL^XYy)ihC3E|;vG&P^16W4B_1 zx&*8GeC{_3zh3yZ>$VH+h?k#{%g;<701dcRm}qF08@4A}*2*otiN>|ddD#>NlwZ_P zpxLaKOl%n;3Y2R7s1uVT)!73|sTH6`Kx{5Eb75AWfW#v|^&kiM6?4k^ggF7xWrk$I z_6c*cub7klQ8_WO8%l8o7fecIP(h+1z<_xZ{4Bp`Oao2VRB(U@r~s`Q9Q5b62pqnI zY@leyo^*C;)f0Ehey{4ctEAqG(lZ0`?E!gvAnq8H9khO5NwR5S-)|lI)*)&43F*|C zc-L9E>ulU{PIjD=9OslIT?@hA8u`|UwD*j3&KKW$LEd^H?zkvBE=rDzEXnNE`KE8S zeZ6hr@Vi;@_FlQYH}2?@9et8|vI&yRX5o@d;FN>fGH`O@ngUJ_30FB|6|VrHXk5Ht zu!oK17|{+{%~nij)zK5ycq6!svTIzIQ6Eac2nvn*>6#qVdmyva_ewr))P#^NJ5Uep zp1+U6-bMOIU8jmP)FbRr^2ic^D2=w6R6CtcgCED+2WtupZZ6xW3s+DNpaT(c4pyjiO+ZD#>A(6 zl!SbylMYg_QG|7bU4_jYgbg0eB9pdQrQIh3!@&c=*de?;E=HcanJns$#10`&dyv$H zL7~mTg{)yTCz+@DCMWY5reXfmoNLVCc_)im8onyi4+S5xEa7R5&!R--7$b-a_i4`Y z`>8`F+^JpkHR=!wwGE^TjZ@Q`RdLr^gscD1(pA`uHT8A%a_#Or&&jn1rCQ(JzCZ4t z$xGBV$aQ<)t(5ByOLdp-2LCuRlaG{TtLCZ~J!>V;TBfIwnn@2;*(+D}{@}*lap_D* z8WrOQqVj?0Vr5jSj3!8wTfeYH-h5=S@`zM<)np2}Bu&F%YI|6=JTsdN)e zg0o#v;CUP8`d**7H6gFwy0m)7;_4mT1UBP@7U|VpOQlVVrA_hD7P+)#e&=H86H@6D zclP~G|I*H<7I!`s-}yAf&pjPj+!>H|2C(HT3M#SewH~#?J>rc@Y{fbslB#yl`SdlM zGdasy`Nb!#aJ-$}I@kEMb@7@Fa?OT?{R{i=Z26tt@vg&i*WtyQ!;G-x2^0pI;H76vGaxNEB)?^*5v{YiN-KHoekmdWf`o1R1_nUe=`*zxXu)~V$gObxM zVBUpZ7HX~!j{o|Ob@;?W69?J|>qms3w3W(#4k%!&Pf3*>KmATl$(;_}ERhEVxyhBOQE~^j$5?VYH>q99Ek?L`->8p{RyAXY8Ye5S3VA z9ivs!v}4?05P>ggc`pK%ba=7N&JbVc>*ve0{cPnk>&6vVNz+mxthHcEgaf1IW~}K3{n?E{{v9E+{ueG&Z%GElQ?PEPm9?k50qhfV9y& zhKxd;Ajk=gAOT~iw^dygE?^{;<=8a-Jc7Hnx*bc15EC5>;j!3RycX?jGk0rG+5%%5 z4SkU@+$-=MqNA$qf5ZY~1wgUUml^8Jr2=~g(_w((ZqUH0(V4X<3>ZI6+D}tk{F9poUjZo<9CsvIj99&on_PrXmRHMjs|QKK7dA`^c+85zdi?zz`KDThJHUJ zojeoYe^%aq7O!TWp0&>G*OIZp?S~&YvkJa|Jh*mPi55PN2PRNLM0s8hvtKxW_P10I zT2;sw{M~1DnfKhTTWZ_6*tRp?wp(u7jiTeFh~Yy5T>1$cnCxzu&Q27#Nl$>S<7!`f z{>#sQY3kJ}$=SHl36*FbIr!u?vG$~mAnIlP=prgc3eP$GO+U;)12+_CiZTN&VuzbX zmo0WDZIQkIfwfiqL*)Iy+J=qF3!!SqW~inr|r3&Nk$)zQm(L#Wl%Lw01mhI;50+VwNa1b+DwPu@$N>b$_Wn&>-+s;3{RhJOlSCKh5VajFYD z#2h|nl*O#;VX`rpT{5eFUru*QwXf(wkQ%OhaSuXS35ZdepxF4eLjZxY3pi7pP-l>P08zVpt}dzEY(U&7UwS zBN+sO%wjRBK^v(q@-4=IF@JDnjc>)1QpJ1DVn1;;W%y#Yo5JY zBeJgI4L`o=L|g|0P`wNVnpt%>oTUIwz1CdJMmse`B!Lg6FG5oKHsVZ3Q%zsob5i`I z9Z^CZu?N|ztDQ@Sq|%|ch55ijv2^j0d~pyzXP$l|cg{W+h*!2!z++Dvo~4|ucVJu4 z@iCJ}N&6=0o)VGLTzr)-JxIh{I0lHJ;BumhllXv|tOp$b z@E2BUO%=XZS_5VOtH+i+EsLI(xTj6_z+u6b2X78sUhbRjnSPepz?zmkZHu0^`TDr0 zL-uq`?@PEmz{-U+vt_rc*-fInVzzijn8~MqA1^y?c@6jK)-2U^En-RdDQU-3@w(%3 z-SO%EY4~iq>IkL7CsVy7>gwsuH2G}iHIPj|$KtG(3P2?Y$mVx1t=+S@c29h5kG!@A z58@S1%6Q|B6e$;{CSef*s#&ZNI$pR_yVpYiJX`E9@1^Fm37o1{EkO4Q%9#zx0k)sx~ z$}YLQi!Se6Y24K$yP6~ir;ZQyokA=j@UDtV0W7%YTTBcoV!%UqfcXKuEA90>z}O=t zwZ_+WLQmtMRF@;-%?BRhqb{Hd9ek_JLx?wRmP=7Fu1O_;HEU9dAL0jAHBma{NL|Oo zctCCD6A#xf{v37C7jeO)zK!pacG{Cz+=yFl{Z8#XnAFvF8+W+XpRS@V?8Nt2?VWGQ zD}JRg;XL{NGdHj!Ssv|3mPbpY^I(ghOAg!n&nr2+oXj3GcP*q1l5ifsd&$2_?_v`$ z{S$TIFQjy!`1ACD^&c|^r1l@;Whni}8fOe=ZGO{g=trm0j~DKhbuMSys2_2G{}%Nl zT^xK5Mai+2_hUEfM*=E!J6bbj?l3|oZOf>4+S@sX9U*_6;9#CEZ`0-LxI8E#IhDgI zE#cETnWzvEY&K&@ar5b+bS0*Tboi5Y=#O)5+ulNX?@*cSVCo18lr>90-#>bhDa(u@&2XjlH*3)aYJ_8 zzzw|kzWCWMd{)`f(y*Q7a-qe&`a?@D?a+q{EyLt{IX~FL29Lt-J?7xC2+#TmLTmca z#wByH*CRsZiAf$?JxZH-QG3KU(8vchz0l@ReAWvr43}x4rufT9k#rKoMExmo{%Gv! zKhvHqcqGq};F@+2GpIpe zP8tN}_KPF}Fnl_}QJK=yz+q}ANl*x^j|oLaFC!=()~=A+Ehz8_$uI+SEZCPXgq_i# zJXEwGofD@SP%u)Wjn`x5s_rbR=c{MCeZV-D0~u6Zq_)aX;Z8oqav0SxOfm8ctzgh)F9((^Bw%f=^ zYMiC-SFe={=w#7FuIV8|3aZ|(-y{{#$zDa{B{8`qCOKn?f(l}w&hx$2&c;j5$t76R za}M)*$+c$DwI=h-Zp=8dd)Xi&uo3q9!g8p`nBL6U8C-%syG{00bO6V~^)HE~z7>}r-A&7AVh7`j*t+*qlLN7#mO*ie@CKERY@kyZ`dn%eIi zwHkK<3Pl14QVI@`hmEHlt}=Y5k5|$@9vj|0~!JtTAss*v=dr}PYW~xoXtYEuzf1WYGI+$RzjF|hBC8nXTOCMddRY= z+|l2JE2tB7Q4Zs>&EYIKhJJMlyO;@&{X`aGo167r|=jmt&!{n#c=fe8`V4ZW{xGR?UO1#s?l!a=Vf zW-w2?Qcl2|^0( z>=_NxWT%G&haC0@tl0Kf6IIOW#5XVO93LGa-U1dJTqnwnuLx!H=g9)Y^JG5R%lPL| z>yjcb0xOAMJcAP2N>d0-GGCXk#BU=-vWR9R6W{n$IZ74#6I5RORl55r+$CZ4W7X=U!;4o4;#9M^%UzL zs-Q@yP~1y*RH3AUH5XG^yo8@CY^JVYOJJ~cY>9`@61F^z&w(vhG0L}`Wi32p{Q&Yo zuASrqTo8zZm~q@Iu9@wf^T_pE;>BALAqxIz^lr2E?#=3Wafe*o0ilLow9y*^N zC+K^WK*wDfCTIqq5Q;zvMvXEvsyg(i6tpu+CLYr)JoZUu;r*i0FGju)NjTk@iHWMF z1SG_&Cd@w9D$G6?<}fbPHh6uwOTRevg{j$-aaXuvppneB z3gmEafeS6{6HT)cZMn3I?}$id@P{%q8d%Zrp$9lG@!Pohv|t5_rm3aoD95w|+(wFj zX|&k5Xhg6J7H}BgXWqeoe$c|w6~HZJ*(4|*!0itRMi{t}@H%mjnXPH}1?oIv_!K`2 ztjG*Kag-l1VYguxBXB=f9yyRK%4BWoGrF@>tU{qBkvM z$YcV{@BSnN7{rG$qLRt%6_5rZYYB)LLu+bor|5o$;r>2pqphY1ybyWYu!iOZ5=nAL z*9Z<4H;aTXc4S`d_ZHs0qolB;d2~#fV|h`|j?qb!rs>BrM;J$ft3G^n? zWoM3EfJgy3lliE1F19w!OVb(V2mS>>Sr2nY6Hwi+nQ8kByGGR4*TacQWP8^&=u&@! z$%%=%kLf(=C?>8hF`4xKe6FjgLHFc3#B?Lr#v2}L`b-B(&?Y)FY<25jn4JrmVq_P{ zW@uR1B93&7tqRWArTit|L54PVDSxpyGompgY_d2q#wcl<)-EN-=iA%qt^a_3 zrTve*&rh{YX(`dB5meh$y2>lJ(#LwHCRfCsG=Djzn%&-~*g`YfVhMZz%0q~6LR{V` zocKnDZ_@3JDYGT?p?gLm8y&$J#mC zp&i(tReK#1$hqezwLtUH<0@(Pmbof&Mrft>Q1Cmpu`KbDOxEF%A);DAw1phsEk)bz zjk~cbJI^ui&)^s~Y@;#^z^_aZvwLArdXQ51aK^5vBLEYu(oJx6B*vCOji3${ZTHPa zkrky5jQGbIXQ1dnifF392N3S-*pn{0zb!kN8;fw839}yQRBs+w<)3ZUo57)0F_K47xzB-GVW4>lq>c+s)Es8KqdZrJdBbU307=B)RwSKliDQw5RN%-z2xXL zo*xvKC7jhuPVb`A3un98;C%4T*}Ipe;8pA^Tv!jrnIfPP&uq&sf%b(iu+ElGPtKM= zPoX@T&OvNcr&}&)lnOc$<<-*%rVrd_V>54;TYHvT4=lDGh_@b+TMuEp;^kN5@+(L| z3sD=Sg7(DP_0#*N_uXd;r?+yD11oXjzm?RT(#v+&hHiccEP_a{GGyh)xPP&(}zE(s+~P0 z*KLnib<0)V(}&61q?C*)EeU7&8*64Szus}HBkpXTK78L*x8&Ni=-RZbs|< zQx~K`@V%SjuFJCPvgF`U`G6Zx)NS2#Dz^fKBaNf7$D+;y4{5R{K!m`Av62LPpH|j@ zoN3GxIq`#-MHs40QYmB)c%dz+7zXANhCsfHFVdxt_4HJcKD1;e>4SC|u^3ma@V;3~ zvwk}@~G%mUt=dZkbQF1lLT_o} zPG)NaZf2g{o#LOO?iyoHa(fQ`Gs*84ar0?MgLDNUEP98`mmRW)v!}q|LmIT}OU^J} zU;@(*HeNaA@q#a6?qoJ3N1Gx!I{L+=I(kh1%@pNOT)Q=2cE#w++Lz45Mqz>RPzldB%^V{C-keu~#=Toxtsb!m; z{2Fk%?`d4lrXM*LR}B=@%44RR<}mgogE5s;dkg^6ld9lk(jjQ`dJwJrw2-v&yfzC7 znA32j`ZEnG-ozai<}uR%L9$t;qt@K0(ovrsp@B)Uf*ybWLTn{vfvS|jwiT^1!f!ZQ zd3PRV-O0HfzU2fFZ^SAn4CKdb1{Q+hh>h& zGVKuT(D$LAb=#T}{0y4BzfebFqGLd*y6!3gjRx~*h^ampfgy?|0bcVIn4Sa*f;(u+ zO#Kr)Wm~bRqxu0#FpX+yhQ6LKY{{PC^+_6QA9BVdR2{s0D^EgBI*)Qcgv0TYBXY?R z$$2EFcN`Ete5;;8(3DEYPnQ zRCj-+4lu*LqJ*DqX`U#|D8M*J8Si1hWb7r|0*AIYWK5;%w5%|VlyJhOYr|M4{g3Ld z2DXjsz8@(bc@jxclthV=Wto;_TaqowAF|`vjvPC(n=gBb?Knvt+mub&kt55=QLd6(s{U@QITGqn=b zYuS~>+*N$;?)ZBBn620BXgxdntfS4WvG5Meu2tT#UbY!7X)+=sH>Uy8+`3w_Y9q4E zj#V8C@pa=pzt9*%iOgTYhAV!yhKt}5GiQyfy=wo;#%gmkmOILVqs6SZEcuy6#R0Y$ zR74w*QHU-?Fgnt_d$MHJMn#LEW1YoEM&~3!PZGue_znyE35T7hMM5?Qp8|1I^8y{j zu0c6+j1m00*jiv@vCE?%MEjo+zE0Rlc+T)>h)KDK&3zx4j^LCQ zZhvaKaZ6wNikZbNK7P}7OVai>pf9ffIqiQz_=V;C3UjV=)P;*t$@B8pw0)Z(C^A4> zk|0X!)4xOecWqaZl28909m+Hp4OSNRqbO0F-H&c9GJL zEmys0+sf^bq?>3vP5%k)KP8moR1aA#^=cvg`hPRI{~`P@VIv_)*bP8`!V**3rT-?| zpMntR!eYX)f+9XW#8_cMk`d}*vpTk@i%;Havds=ravi3_D|Q}C7iIWOItW*;IaboY z^unBB9zG#{tkW)Y9%BlaAkm>*O12QnBg%e_@k(jTI_%8Pa{qOQ``2i%uiA(IgryU$ zf9H25$#B2JbejKP>5!>i|9t|P*JaM+Gj`Ne)WYZJZ6a?$?T}>d`W7Py29jH}an&Jd zEm%q3=A&Tv67_P%{tmsqOZe=u>tww@WNb0|2%8wY{*G?kp_TP1=jgBc9t(d#ORcJZ zb$YDmN2T7!wU2{#V<-fApZM^LzO$mQ)2;6rd2IuPhj0ioGYQRX6z6?m2CGWkK#3>F zWZ_5}On-g^&qvN;a~P@;gl-H7P9pGQ`ovXypbtQKvXJ4Fd&*BCw3JgiOj|o6*ORAD zsGXq{Ra!qnpI;+%61*(_BMew~iZ*eFtIERZyrFwv~`XfyHGJ{=Vu%J*pAa^PCMLPch;T^(X5;haI5QYdj!dD4D zA_$g{|D^4|2$10i-3dX$7Q*k*;|;<=J{~1JPM~f>{TyMOaFuYK@I}JQgx??}5I0{> zvF7nKc#{Re^)J!q%K$1+h0pZ#b+iFRA92i860_F7O8+Q$8F2u{J2b|pc(G|(7t5~K zn8I%pC^w@wvxI+08=127ZxjB8@B!g(2|fnF0#MNlgnuOb6M<_oU91NX6gEnxSb=TSbs%tyQ&ox!fr*26_o=XwGKR1 zwVMsCA115y7roxv5O(fsvE?-klhuZcUKLIVb=U)544ABT$kZ+tL=+jz6z-N6lalTQ zZNLyFs|}diE<>2Cw#(GE8p33?t?szoeuc?u$4u?8Axu^~Y-*1f!elk9{IPPO$!bHU zxD*ce!r_8AQ#)Y@lhsaO!)@mQ&#gz_KKjm4Lu)s*gVJQRgXWgqHy{1R(YN5f&d~Nq zlhyW^yAIx(e0%DhDMRb96}&;;8|+{sjkhm^%tV)=tu1uzTiTrK+L!Gb$#sn&5wmv- zm`e-Y`mtW$7dckD z5U3Lwb?;po$aU=zfx2a&ZU*XRpl$?OhZB@&%9DAh(6si(p0DkDZC~b5vtzyCYco5$ z4d0rguTDJ*9@PqLS2k_VJec!!7gQYo_|;8C#e(G;#b5vOQ_{5o_M$hSf*aKW+n)}N zia%QP9`&fvqOuYhF#7VTl6TUp+;_n9!3=v`%jz(qY`YgnDKwp3W?LufVXof@ZBo$3 zWbV5k_Triy=%>nR@VrN1#5oymIG3Mz4yLxmT z6m*EIJBx}1wm%()eW0`Ah7jXuN^1v1lFd!M=Js91@J4T+U;G9e@s! zVy$XVQL(`Gr^9v;zky`4!1kv@&xjf?DsH&n8)Zjy!^S4MRe^pbgqv+IdQ_-R);eo( zWsh=4yx-GTdrwhu!%0uPma3O4a5$u%gL?&b)UvVM(Be}MA#4TWcoZePN8MQT?W_gE zxf{?AIBd784aK@xEmWPjVNg|}&cqG%9(5EMRiHnrrr=(Iy-KV-*W8Oc4l+l~ra1Jb z<(h^u#6(+i(G9ui*382=N3{YJeIAq)i912V0Ai}^4Yehwt~YTp=jYF0AK&lC8L{7w zGh)BL==Z7XS$PS|0n3BU&4Eax7hV=;I!{82HpW$^1Hib7bTpO2lm*MRmWP#29lh!m zf0rzb(RId{xNN9XS#>I>PT@_&3(s+*JmwUmjclw+V3JonjOC?guOrd(&|qh%>8zU0 zsp)EonnU-S>$VnSYngNN^~fH7Z0 z%xko8;Pugmql}#ZPWo#Pc?zIiz(?8v@FfB58kL@2Gu~-#9mY^wj0`Ycz%oJDx9!5H|T(nFswj9Js1+yjm7@bu6w0%auvdEAC9n=z7*j zUo+Gfv+9dE^+l5OFy4ff$ogIfZC|u14%#9dh+FDSr0hhsA~isR;Hbyk{{W^2)N~y_ zB?vRwmFuR4g@=kBnkcCxZ)%UXbAj0NsDT@-{~n3|N@#>6c0^w^4FXW1W6_c9R) z`|2IBDbwlZ#_KMC$ zDW1TTE>HoTSbT{Ec#_F-vq~KNAbG)8!T*Cis^bb9iY;B5 zjJ~1C(zD>A?z$+TT{d0hS_|JwIT`&R5)|-T+!H1PoNjktF+KQm%KWCQ%+0MgcE~aZ9A&OXi%&t% zPY0cax_+$?-bs3$6)9= zKY8Ql{rFdlf8d6`JMQ<>KM)$Mg7YD#fbOL_iw<)^Hw!?za}_ED=7LZ&r@c{gCu+H9 z5L%rE`d(MvYv)4l8qbFy5FHXF56{<6eF0+5Emnzzw(8b-H`7C1D)`n4;ib68u*ui?g}{GIX6qjd8PsZc6B*>E{JAB7x*EeQbe z;QG0!yIv5vV&5$NQuURk{*q_P2gQFOq#K?K>*`z>obN$$>m#*VX?yjDbH2>_=?zvo zigKyRvZq#*alUb`@e((W#4i?`d^t;53O!1pr zq3vY8*%fY$9Zs2RhE|*=w;uavz?L{4n{SzKg>MZssi@Fi(voTxEwWnuTipFb@MOdw z#n3$0bfG2{1Jzqz_s+GJ*x_2oMlo1DksiAUjR+7b+LL&8diweFo}nQ=4O%>LgQ@YW zL)!;;58(?-cANB&;D%2Rb*HXl3wYxEfOsA_uaAp8NGV$|D*f;=yq*v~)P@WW6>Le) z=u@ymNa5NFKJqPOh!;A)sTnr~#lA@ym0Qo_lgUIWLwBNe3H;JC=cKAwaK)c03q>VQ zpR%iApNF0uz|&0S7Q4g6ip*^FOwBa)D-Cp83jI+f@4Be;+A6J?VMS5Fhq@| zpyYs(5_V0c2I*1)Gwi9Q#H*$E?D%EK$6Osx4<;yQiYqzMsi9cpGA=zTiQHY7nUZ1} zldinWQ_#ezXUFyN)4g~3!j&Tqb=xu@yjuyg**<3naZYM0DGR!-&>YR~BHtV9?SLd{x$0UOXXe;cIqYc%h1kg`6Nz3XX7-RiA|WZj#Nq9((v!2xGBXP_ z*Q0Y;A~hA_G@y+bFHVWq_D)0Iv9XEtc)Cm|OJl|pP%tI*We5o%C`gneO-V?!Ji?I| zb3AblV|1yJWs@GAr4~kc^ky{@6}gui3U8ZpD4#tHhq0?yCQ?E)dxqyv)XQis;_QsA za+EK=B|9TtUJNaGg=XV2RqGQZmTd!!Bt*CMFy_j$J49cT8tPdpp?q4(8sXiA+#0lX z@y0TIen@9Zg>~tl!)$9d;+XGKVczVpXmd#A+3Pl|x*S&$$%@W~ZZtUC=_;fs&443` z5*NC@A2Wj4eRs~`&fQQP)#6P5rzpH!or-1aC=v#jyYIPcsWg|qsN+S^!dMC)hJM&? z$C)S(6Q|EYQ3BN+@eN8pKX#tSypa6i2Yy_Bi%W;WeH~?fTbxDCOifQ*9)D8GIqLn$ zR$e`_mgR}^kuxPdL*V>Je~=!J64v7}AHp5MrPJf_ln#zkEab^(M$N3aua56#T97GU zgYOH@d#w*lzV^b|i<4K*LBdNi2ywcp|1;AJmiiPwGI^C_K{_8sEw5k*mqf^iaZt({ z%aciP@`&w#^1^quMWoJEwcbX+Y)wH41;z5}1+MIIjho zBhc}Q*6?cBXgU00eO7xir#)$CPZk0ZBe2E{#*E;4p+?{-Gd6@BYN`Newv8(&y>@MoVi#}_-l*_LhIk!#*zH0@l_3bAe@*0-c* zjuyg^%we;!IrB)Nt^eb;tsk{*&9-gNwL!e8lUwJ2uY?!;H`Lpa7NmP~m!*2fQ~R9f zcBuK)BS!nv#$zXm!hG-4L^gCO7rJDGF5M2sZj8V2L^jx+3*xTb*4nMNo8v}X|II^| zNEMC)!)<2oK(=ASjnLx7#fv|?-2~OTzAz3bEV$jW$!vbuY`YirZf!)pt?QNjO1!NY zsEM`-y)!ik4-5Fc>(}JMn{KMv@L(=HSX9EuwtsJ~f7EPp zOONA7E{v--`<&*JrnQR~m#$}XAiAb9CfF9Sa^a*7Dk^rS@EG z%R*gYc>f2pM&k1@nTN~(+SjAv6gv8`7XL_#FZL}xX|xSwwZWW_o-+eDtnsLQMG;e9_*H|kN}?{9oypZfkjoH?m|jVrbWbzCG>+GeY^8Tbm{Kkf+X8o^KC zhMycM+*^Eimo^o>$)Wsi)8;o1d{^!*&8p>&*lCNpR4X^Pz4Qi#6JuSu1|pX+x!Fp^ z!ZW;C2Ro@^APhMMzO;UsX|ywqPQr(zhv22e1{tVD;HH^mOwwrMUWU%CA{{$viVhwS zFxwHRBtVZ48VKT((n#CW%!3~c$*{r=1)V!LI+yYIP*?)My7(|~jV?bx9kg-NMRFLe zqb)&LPv`<*Z~5}XMY)>OyXg>shEL2e(s~cWa5p61Xn(cNN_z$b^OG|dC#D8V5|QQ2Y<(-kY$I$Zh)yy~ zVtk*EI|-Z(wkQV@^ee^5Zzd==|L2_Y)2f{)2^Tw4&hyS(-JFoeb-H?$JZd zCJIbBW9sb@S25=6k8mg8h_&@E=Mz~bcu)Xq{vvIc2+sm=iJDy9j_CKHe;|O8zJ;C# zMd}`psU!?x3d(lFZ3;>xBmPXKE+hU-C6p0=rV`GGKeHTWouO1QMQ^>wTU378Afb3- zhSDsJsl*M-n963uZA@jSvAQYxf~?;!9^#6p-%$FT##FW#)r_e;Y*aI*(rLJjsT?$_ z8B>`t?#`IXh~YM-GGw?7K1+4ch1MJKr8P$FK(=-uS38jLo6+{gol8wi=a=HI@4q>E ztH)RaJ$v_L>I+Tr#iqsMug8~mETzA``{s#T-M7-Wdfz(p?uqxh-%G#O`&VZ^IAOFs zo@+XmQ4QsoG+E^sCLTU~i^HBBrVqSTE@O&sH9pt2Dfk{SRyPITA)}fxD;!PVVPkb; z`gRx9QSR)QmHYq6)4 sCr;48CnfU4QF<{pvK!cGNLDktcK_chhS*QDy9uGUeSU9VgLDb*Jv-UM;c6a#pE{Yc^Z6vvk~D z>(SKg?)RUI`vNK1-JRV_@ZjLw^M3s2f1UsQsIaiWgy)mr`^lx-|ITFk_w++~Y_iAv zWr5XXddI|>LMG14<;BeLyilH*{Fay{WWl#JW{ulIHWp@!<;U$Id)yIn#GN503(Joc z#9bj5^V?(Ycwwk8UKA=~za248yf{=GFA0^zOGBk`Z^#?>g?#a{P+7b@R35JgRmA-v zf4nkO8LtXe#j8Wr@tROgyf#!DuM5@1>qGVNKqwGj5n2&%2sOkTLyhsKP*c1))EsXK zwZvOPt?{-{TRa#F#@j>f@s**K@s3bOd{t;wyff4pUmaS_>fwy7iFbv%n7<&lHoh*j zF1|jrKE5HeA-*xRF}^9ZDZV+hIld*dg~f5jw#K)GwlTjuwmrThw1fEzV>{!!Lc5s1 zD7HJ^9qML&Pi#+oZ)h*`7sq`udp}!xcy7sT+hBau;k5+?3;s2 z-rVHk+)?z>IG5m#vh%u}C1A7> z;StrjkLO4Dy(3&Cn3r)yZj7Q*;ndC1NTx#fBYg2@IGRYNh7!Y(U?Ah{K7JtF-`%&b zCsU|;!$*$|X6*D+^&C4oAjcgT>^{CW4Sll!uQxttWCRV@KmsksGOuvnMh^hAeKES`H` zEEXM2Mw9GU0l5)mJ(9@S_oJ&RgZ$o0tPIDY=P$G-z zITjllj$9duaS^^BU6rvPk6dDLoCE0g2y23UASLJE8Mqn0I1(GAzGkrM(AjA@~~tRINPhZ3piaCc%Tc5{45aWt{Gq0~@z zy5eUQ=4gbE4#lG5kuXh^OVJx+qink1ZAmhc3e&8mhKCdAMg*3{hpt7!*P}6Rc!#)$;Fj(I(oQTI`P1Z6ADDZCVo z#n_Kmu#QmC8j3TPh<I#QZ2byc)FrwShJCPViDN9FbC5CC~ zDp3$xkgW^mWYElaV<|r?9KFf0Az4Ln$IA^rSH&Z#AsUeJ3MITVJ_InZXDAuz!?cWz zH!3f}7>iUiaXG2Q7|4c<*D8@Z`H_)S7|pTvxoW}Jnpg!$nxnoHeDN*E3#yMpaE7&CV!Oe2>e;fmHvq+ zdCl~5zsX%CSS!E8FViqN%7a0r$NXgs?wc6eh$&1%f$$Q1JGlm~4BrJ@Bj?Ari)-R4@$KfCxf*;IPMU6* zLq(W0E&Lf2IbQj^j_b_WN8}BUUx|qPNjMoR!Si7idqog60RQGM{|KJ%n=v8k3V(dUSK zxj&en@foLtyai_p<$)xKiXAy)PmP2LCSomTU$9>`wi#v|VL;+&3cHFWV@*b4m-v@a zXvP^1%Wy25q?!i;ukj&#^Oxa_R~U=!RI>O@yi6X1^VMsnh1#wMtzzv~sdnq6RdQ6N zYXVYD=X}k^xtfh)&1R`)GX+;JI11mg-?q;?{BsWfbcN_xAvsnE%7;IP%rcHkW3d=* z`TPm|eAcGy*Jsb>pe*M*0vAU{V&?-BfhA)N>RBG^PvLn7BQk^UrB7~e-^!cF<9kx- z=wUqauBs!Rq8%gq7-<#0T|ds8`3*z5tLjMit;%W*R?) z0PGGFKU2D=dthJR(Vl%r!uwAgIYMaq2YH#i&NUh9MIZ_w!)UIssq)OZ{c*c!T7PH9lctSx z-i>mI-enV}pRn8*@&x)wQ|D&*TVvStvAJ@Yf@o5qH8R!&x{VJ~yDUQ>Vk~ifB-0dD z0HcDJ5N!}9Op|8_=tTg~4=nr@B$NBZlDrwuE)u!r8SgUf8*ljfKKKqbn1l10>1k2v zd{J<&C^*|D7Oj(t)=gT{uA)Vg#o2BC{?_T?yH`GPh~6&A+a-s6?kSb~;nBL!Hh;Dq zezEkJ1lMy+@*G<56KpVz*GdJMHmKrdU_Kcrno;T6QtfFk@<&zogN@lrrl# zb$JT0sjC7>OkFdkZr*rD?$o_tMD;F!R8?@_&VG=MetEX_?Hlagd!&0{K%IA)VD3l} z3M&Jx_z-Uxt~_nH^iwobN&}@Oqj@;KVwrI=M)_?TrW$#eT;3-YtLI#+1=s4dw?guE z3-0dayEliL0<0nwecA4%Rm-~fqTIc|2&}3Ad{VnTMNlvM=!S*zXOB88tGl_YV@aS> zz(iz(j^Q4G5gC8F!0_!0DnkJyW911)kXJy_{@#5@dbE-8Ya=6Lv_!bky5Vmkjd87% z&=4rtaF~sNiVMkzPUn&sKcHMT!Fm2VF+01a*4^3u{?0jXm*DMUW3xtZuhET7i?)w| z($EOoZ!|JHQ94ch8GJ8&xE$Ppx9ef73ddJvdp)PeFECnlgpXecVB(=-0qVcbac8IU zf)<7&lHiiWxykrh@K6d^^2M=KB&mWa{xww1FyR>~DrYM9b=~r_9fh*@Gn7Fi9Q3ry zJMXHQbJa|r6T3htF!uNv?x6-*pL4$lD-75bjx%-0YT)5@)%xmWe` zRo($#>%$5UD3Dqs`H1laZkNJX$Rg>$%maPI+ETFbu1@>~hBy%P0iZ#|zF^F-3%k{% z;3f7I^E8@V-Itx;)BLKF?dBZ?cS1^Dj zlXyT{5FkH9;*DRGDV_kPahAOpkdae1RJu_*K~&krn=%mudX9^LNf3`Fz~H=uRWJ5)pfa%|Jcc)xBoclI+)5xpqfvesd1RdG|*@MCCQd{^1?sdD8!;u_syTuzXy=y6y8t*A9Ek){o!~=&FLE(*W$2YC7#G7} zWyq_BxTu`EX0WzexyZ$_%WOHw!=w&%E3ss#l30#|{8*&5gMmuyGsFW7jE?c6Bf$K% z71%$%O4;uNkQ@X?fj?ta()AXj@rIY*9l{I%O?$$_^nZQcH&FO8sCi^9Kz2x33u+O4}g5{SoNa{qfJfSGdFOWX~#Cg+68?v@U zzT?C%6>;Rul}If=T%L?NvISwuT@Z#;R$VHaE>-?AsZ^+^FAED#2M;-2ezzh`7A^cLS#2c7&8D}USoC@PI>gbItiFvp|1IkTfP~hPTeg%(=?j!-OVK8m zeT?NK^CqkVro?-w=)DSp-t`T8c?0cz^|OAg33nny`n} z`7mK0VB-~Z4UJ$z?z;h?0M07`I9kLiO#(u3Xe^ex5E#k|`eYD8@ff+HQY#%y7)pZ9 zD0ss%e_4le>i}tQ0?>+w)M^ZXMB~r42bjz(aQzC<@d(eVk}aKOo%M$yM}u79rdA<> zoU*`GkD{~(j*g{9$5592@k=9*?p|yzg$qqPKhE~- z{4OSb%M-pRlU$QJ2uU6W=)>*05l4#;epxo}jE+nPNgA zA`k@gmzfAO$$x-sGb`D82`ec`Osx2`i;p1=jMvBi9;L8jUda-D%8CF;l4m1bg}3|; zieiIYB%b8AlHY+!uvq*b(oYL&k+G%5Mq`m+fkshe+)Al5MKV6+mr@57s>Y#0A?=pI z6}4z-0*0LsF3g(AGjfB#JrHd9*)8MQzlpH%T$)eAvyC(GZxA{8dzd+20R<^G)znMX zYXyh@si#!(G|qGbkDd+AdDaQ?XTxRDvrc0Ev=&2X-!|vjCdi*1H$=}iiTTqNRd;U8 znD4wg=}y--+`TbtzWb`+sCnwDSTyB1n}nJ*?0dnz3HZGIk@vG|(cLGx`viAi+S@3& z8(GXsXCPf&cX!8ZiB!FEwp*(1oIH}QYMJ@g-PMzaf1Yph)lFafXuIg$EO|ErzbR}= zS2PO6jX-z`n-=p;MGcFl5@gZXa&O0j5~*?BgKnvDqu>tw++ixN5~?~sDUd5nY4@4a zt=pv5?nf)6)*hj_>2psd#c+$B9g=6qqRCl^x~!I}H%~cGvcG=%#%%cmpIEU`s@OPX z1p^6;){=hnLIpCWHTq~h9I@)41h?X#RB;duF6%dc-nL3V&mUXyOI+0_!ENi4+WMv) zcMH=M^;4dwo_fJi&lbT4Rwi`OWL10^LkAWcp=V6!!6aBbF-Mk$PAnVx>&u3|DTls| zFGkhN`Tn*pl&D!b^mmpG&DMB&P|7GX-H{pF=YVe#nrC0iS(i z4~Myt;c%FVlK59C_3PyP7CHY7Io~7a`{WQ=$rBpR)5OmdW`$D25hzbU4T6s%lnFqy z%i|11C5Kv{{4a1Y^_9Q0wNbD(E?O-%Oq=I91$LWn(PVT=trTW-+%^g`Iz`4PEQQ;c z70bEQW?MmN^-fWqtrZi<;5b}1LhF~fRh_oLqUmcLnG~SjAevr%h;GMY{_+@HO=f!n zBq^k}d63pxA~w#t9dDV>ruy<#pPl)Nv(ns>tTfjHUQa215ebL>4p66C<>MM;+F8br ztnie@y}DK2rG|7dsU-Ms7o%Jl8d?0%*1#zR{~96QU0^71p}qYYME#eOKmuh95lm49 zK_uxDgy0}OFDL@a3jtCD8-l_@R;*6Il@&w)m@}3jtGxk7VwyIH#*nY&a@DXW(mR0u z&bP**M2B)WG3TShVF;f{IA+M6ABqAYRiXy6QNbZ&QDwYP%lEkiupv*PwxN**TK&TF zNNVb+ET32<|EUweURWZDA@#uJ$$T(8OO}ieWNRcyW<8myePK`VGngbi0T}+T$oXq> zXuFbMkOVph7#av!BH=KN&0o6nWWKUS#=e$Eh>t;Dt0Qua(pBQ}y#5B5X~<>i!kf$scO==N zYD^~d!5Z{I{*10IYC==0T=P?Z+|Q|D4gtP=8@i|s!Tf%3dccY04(*kD6USs(%;j3)ZE$jz+*XxTU}0p%lERnVPr$*>B#c2I0BkoD|R zBk@?q0=5#VNF-w;sU)^ChEURU&J>)aGML_L#*URptBtqP8!Nc1kUt|Ov5HY_rfBcc z{{6iN_V*sy7e2i2OwcYPm^AyrYDGDU21mYJkBkMCWVsUOjj_g(#0#PIi$|xRQEQ}8 zdA+1<1mT!>CH-PKvDi>T0>9W8(;kUyx zCufg~Wox9eHS=Zb=gQVU2tT?gmi0I2X3D-$v0|q6qxE9N8mR)vp}FK`^FmdV(0oof6(YC!oLF^UsyZ+D&My>KOk1ai zXEuq&E2ZL<0{bjFmF$1+Hq{1y(0{jovM=qfoOjpFx$CB{OZ96-_d3bFPH?Zw)+dkZ z1BdFx`Tq%iHt`Ik;Io45RJ-Ak z_~_2@HOo$?tXh$d&Q()1(hO@x#$Q2g!?Q>J%2EA*994vF32;QgLk~&IuD_AR4iS?yCJD6tFMG7P5EBq%3(N+*o`d-X) z*c^){a(uRu{MUNH6Sma|)@po2YjxV{6WB+z`qI``fqg`4tBkV(Z50V~EwN!f8=aOs z+g{*^FLLENvg$FceKl2-5O%|awjqE`=yQ3w(i5;%@J4ws)2xa=cSnNKhfajGB%R~A z=^BhBXpG#H%CKBgmIGx`t=V%cFVSbr;{_=#6K2HU0Qrph_aNgzKD4gbb5*S)-dNtX z-Lj;x-jrv8c6N0SgI|>f- zbG9y@3unv4N}dxhKc@`agpIS0nfd0_3auW7`m1=tFV`1A$9UIqhWzT;pE)WFGP5xi zh$NV#s&l*ma_CM%Ew=`q6+jCYdMWr3cxDdv^G{IGj3+0DL69Q%@Iv03cT*HA@p%}V zhyPQ0vyB`gA=&cJRLZ=iG16IssxR<&MR3MAN<}m=EA&93=E144eNc{dALZ63PE* z7tfT*+2m9Q%4T$CA)luum~o&rGM}qJ7L8J4GWn2p4@F~{lF_U#FcVC%a{eBvl7#ls zMz3u3-@$L5oECzA&2Ru`@=e9w+c#c2xL_}tYJ2yfXm6J6&Dd^jE7IQTJ3A&F@{1#) zJt*0s!(q3zesuMrU)pl$rw7H(6H@017M3onmC9Ns3nmK|oZhK}?_Lp|t&$TYs?FAl zcl6?E$+77xLdh|F9<)hod!)5}@-MiP`3sH}GcB`?_gf#V`*@q^*d;l3365Qivqa+C zw7=o5NAj^v%#ACt>KhFQ4WFdjmcTj@s#~cSoeUwGZ}weBj~0r)Nb+ujJ?z9KBGV zlUxmgwSmFIVRW1NWTBh+O9GM_Nz4f1R;HqC<=VI^s36;L9xKSTLmk-`%4hzSTpj#& zu7eBUy(8k}R&fn)SdADoRGK@vX1sTCEkFWRXG)drjLCGFxMF+*9kl@UnqcH|r!34( z>UCQ>dlbbMm0<4V{{!mGctjZ+BOad>Ku0610h=kgGL$rup^WOvxLCN%k<3_QP_W2Y zpgErbrWqTHC)mn)#?G^3bK>8lVuEmn^^^ei3VGLf1s)P8Lem*O`I*Qw=u884>V!O2 zy-xIm4ZqY~Wg;KHRLDL7h!>`*&z=bfeyPw}WpYDO%=+O!Aren)cK!=;{)wEQk;6a% zwIS$~vFvXcJxQ%)Yff8tmk~5xy>tXs1ba8F$32LJ^;m8ytDLmncBad!@Kumrv6l3n z>(bRN^zBdk{OoOc4Zd8;FFA11Iq77RHRB#0<9QrkgQ_+J-8PxTE&|yy90|*c?nAMR z6A~_&)gZ$wLJ^@G#v)M)I%$Lq@D;_$2^swYP2}t4wfFOkHO6AJjCcQ13lHcoI8W?^A*n-V9IRuZSCR2hZ|l&;jEfi}^2s)6 zB3z3mxS%tWj|`B6rwPVyA!ipHsP)|#jYWr}DW1kgp2oD_^MqP_v)dnf#i|`r)efO*$4?JD89XlyUJ{R7mX2JW z^elKPuy>?uR;K+m>4r5z$-sjiX?+jAzh665`_tf}(^g#Yg$d5j$iZggEMN;@|F9Lc zP#$%T7Racoh2O6yet?#!^W_DoYKK1Fj1Iw7idn)2v8Ghy5E65%4nz?!Q_Ixn`}!a0 zSu}W~t~Cxi21cau_34y~T44pKU>3-iigM}@PL!vuiw!2TDOIV}e918e8*~y@PS`Z$ z6D*m=Tlt25%YQ*{xeaa4*V=x&Nv|QGZ@a#=S5+p|)ncWV6Sim$kvfb%p+6&(FoUtv zXzDU0t=IG9i8Z*Igrf_%!r!0Z8 z$pS`dN_O4j>@uUO<$aQLlQUjAwlW^bbe0s@D(M2V5CZf(vG100hba4HSG}$eE~E715ja@&P!(+g)#_~j zc>yG9(@l4S@1GStU6O~69Tc{w15Njw^MOrsflXpyixk*0Rk#pbJ5?wZx1?)=Q`S4q zr!LR!ErKiX{;Ao)`)3}y9u11khot61Li0&vSy~~Lw9l@)zfD@XUo1Hwl^j?!!UsYKF_VBYar53z`VVupM{;9_+vt z-h+7#zx=!o1W5aJ%a)+M4}&E?V3q3fBD89G$cDWbx=Kd)V_bDuPv-IMzwFM4DcA`~ zB}2y;rbW$UlN%(^74mCyn(ba}P+Nl;Aie zGfRjBH*iPPL3tZ*2rbfvAenc_^y|QTwLyTN@M8ABuWl{yTXo^;Kp|X3ec)H3m}bZ25$$ z%*!jL!Bly9I;=xY^4m0?N0E$Jd0w`5uzV(OKK1$U^rp)y?}XATnxz$+($!FBSP6s~ zq2*O~t})-duXWDXD*A$wFSzJ&5DFnXSv(?RWpXif6i|$cO#BvpU}W=V@V)dg_WG?n z1Fz}15+oyUWg=J7W6i@%;w(USO+@#8hK8{h z>9H)qlJI@^=67zs_3G_cC#?%bZL_{V_WyVO2Q6Z7ixk}QaGhARODfuh6KAzITBd{?$+3%UlVd6p!|K{XN$N=cHGUY^=<8?n;!TF;&;*3u1KOG zH6X<%5+DrW6w5^x0V;|K(koP@yu?Y1CZM$l=9i}N&6Kf+0!)}49Y$&>N3#+%kuy$F z%9DqX8QwuN<7M)}Op%G-OuqNvDB9G13MCZ9phBIg*5MVXyJCfd)pfjc8KC}x_&-7s z$v;C8m{JZXR5QF{p`?5%3SllB1PVd!Le07dJsK&lxatb`PZlqhn< zFIe=SF;@=xCNA6hbF*3|p~d800VF6%`27!8bo(rS;j?!8?SD~ihT9)3)|fc*mid1o zp3KG|p`uI#GT%SZ&o9YgTn*-9EBxmaMgzilG{GWye+^OqqZ3(bMl3QP+jE(Zp_OYX z9@~Oh*h%_H9u1-a#7YDMJ~Kq!GChM^4?C8-VI86=`mjh7*F zEdCFQna{KNmQyEIZCZ3e_p$<=%aomkCaRNsgjn#jAwkYdXME*jaeM^@SCK=)G8rET zk&jAd4or-hk`jKsrv9a^y9Dd5MQf?8a?xaT+DdHLhKx>|DPc~U7cJEkeHo|6Y-(S< z=qj|G#yozGTj!#DjZT#*zhp7bYJ+@LalWu1?2WT>s5{?A)BZ)S++b?!F#gpi3uw(> z(#p?ak>~Fh29S0?rP`C$!74vAHs3hBd#J`u*e(KmPq+3VV?af+(3l zq6+nC==Y33_l6FU0VcA6rNb#q*+u1=>P&VJTYf9k>{0Sza#$AMpmd_LI(@7M2=wa! zymC+;@=HRau<E;tCs4O8Xtov1^NCCz9nd9 z{jyU}Gw1VTs%4o{%R=u|&z;^yOCBMSd0G6Cjy-FTiNTwCDz63(z}KHs1s;*}7v%hy z92#)GmLf60LhvRRu&^x1d4T`q5E5vBWicW_FG(BKUa@%H+Ph4!gnEe3?>Jyp(5@jt_$BD?l`v=-^JVjw;tam+#q*? z+Y0eYX~fH&R?PmBWz?BoI_$vs#5EfuUj8g(DL?bRLdQV`LBAfw?2w#Ckrcp>r(Pz^IYcJ+cOwll_3__<=vMP=0sXkdZgfgLm6%7#?W7|oqKVxHxl9_y_Sa`Apfeb(B|sITG`~3+GumaMG;hJBWu= zD|Nc9nr0PKhLAUH0+a?Ohq|VB;tjznJuv;|awARtW6fA`KspJ-XxYQ8*06G#6%-DG z#SDZ|{pEU66>}&Y*}9Et0D_IYIw2yw3ZT=pPFs;4@T|yGCQEQCY9YaKr+pRpaz3qX zXI5_j&=i=)1aAhwrV=dQMt2wq7LAzzB?^^M0F7KSB%@QY02kTvn|YO}iu~ki92rR& zC_I{GtV&${ch05&QQh(5|Gpu2o7_kJ>VGUB`c7I*f~ocIgOEsBOdc}R3E|f*ZA@i z7L7B{<&T-}+n32lRol=PZR~mUkpn$~{xgQNlXteX(a&%hrpSswO*6Cu>}H z=u$x4n-u2c7psP#T#SQqiYm8ynoTEWWBCBk0;<8JVAhU?Z0$|1!zDfv8PB$pVTp7I zPllU;9qgd9uJ|O5^=0E`>y`!6@)z)LD%%6oRRjA52YdSuXjX*yf6nGV%V~b)S)mfmhuCD*la;&Y zs&?aN&WAOB5O{VA(i+-NP#;1A^Ot+z$trr*7!7v;#aD+Nk<`by{-OF=n^pY;xy_Jd z!a{*Hk0M3JCeLWvkrlaoQ(r7SpP02R7(a>OKpGRk=x7^)1 zyJddm&bgI4#g)6ImAmCPa9OiqaW7x){7ivXC#KE@mQV+(EHgx2LB{-bIGG}-=ft3! zrYMHjD!=7ynAu!iPWLE{2e6Zw_)`=RswjZLT*^iUkfdn_n?IQXV1mS?1NO*wQUz#Q zW~zsnbtoLQ%-Tc_tFSkjVJ3x`W<4~GAn)Y=fvWpC98g3I@p_M{Q5a2zHIuNck^ELF z0mj=+{3a^Kg(wOdounR*?BFg!G%IS)hfAL$ujH$6fSvi6{O$I)!FKjn%aG^s z;7?8qC(j6{&cOZ2c?62pXC=7)vy%VpWMR6bY`&yvuB1sUX^~1=CiBy^E9Pr=&DHLD zl>fL;tUW2!o)jHbllfBxX;;bQ&gqa)yZWiuKeZuU1~M$qS<9TseQA&H_PF3#k*=tj z8k-thw3vz;aIz5R2N@K|tw-fqvGS}0xBRSBeiq924)?sHX3kMFeG;noXCJN-9S0@H zLBVk_?WqAB=Wuv-=pka#mXBBA ztm4`OlO8pPr<8ZwoTE*2v`db5!O;#TeZ?U&mgS=sIAVFPRNkAGr}FW0n6R>Le!9G7 zzPw|uyhAMSl*&67?bcSJF(TCOR6S)?Dn%8kaMGGdo5Pdztym{{#lW;I*Q%D;WXaM&-fo z!w?R~T_(#8idnVP5OlFFBm4sCe8Bc_*7UcAdBWrZ9s3&@yL=^})D_WW%hj-;f1Mv1 zmGfsd^e-^rE5lM`cL~O-2+tehZ|aOp3`StbDr@12ndbp+2y14nCJ7kj&strFwF%hO z35>v^8y_FRktG%Sl1K-2R_!;pp}*8lxscOccu9th(LzNgOCfZ+UhWb@l{M)PGXr5* zz_d^pBKjIUI;#Vll?8~Y#iju{6S^hDndHeiQm+@nP2@da+i0W!Q_Z4e2BUCAI7h!WbNnv zhM6reJ@CnC(Z5sj?_9JY5W8t*gXC|M{9R8r92ETYF@*Ka`TGQa-$G5jHh!A#^Y(QQ zdOz+L+xJTCdlzjO^e<@c{EQs8WPZ_I^vO*l2hP0n_WjSO$T z%^7lVEYIS}$tz?y*P}~wRqYMbSY;MnRd;t|KES-zv5_pe<(epX&3xPO+_8DyI2TN~ zxV-!MMn>6^aa=!TP82=2okVD6A7lOalZIBPa~bvSW%YL7Dm3KkP7(dKY+e}g>R-5Z z?yCe#*)vgStlN?{9!k7xsEb2C|BPw*NwiC4`f>K`T*#X;-@b-7SjY0CpY7)pw~Rel zq@U}?{LxnbMA5H0W0A|YU%1C~a~w5LXP~iuOZsjE3X-*8#gcS_Ju?-GPyfvU78r9P z1>%GiP{lfxciV|W1W<_NyI}HcHINS#|K{89OXaU8SD+*n>%Lm8l)#szwkUq4A*9x3 z!jW4lV3KN5?J8+Fum{5P97g{6-?-&Tk$5EgOn9ya6#pw`to{;1t5+!R^xvs{+ApMU zRDKzI(fA82Z(T|H8mQf1;tDkXH-!7uS-4+}dC{cQL;nr9U!2=lw`*?0J_E6*$FJ;_ zSsyaXSmrkg|DKhE{zXpPLh zg{r{*!G75Wnp@?OAahs-aK?si$d*Vl`SON3erA9fTf0eFWh+5uLayT?61vn0npeQo z;}@fs$417I9qgu(2(+}JYb9r(Rhe*fh8G27gC@+3n#>Anmhm}UE(c|ESOB;V`D2oy zbQxwmTP`>}#_j~jM5q}1=_;+$cXKByw~h_E#YM;Y(2Tk&4kOogDngyu|=h~qm!0}l7Lv! zAeA&s=0B~$bs3fErXViO0E!7~S{?IM9dlJ3VpXS91tiw$gx)-yw+;cvZAw?w%~!3N zt6KBG_aG%!ZI`OHPacMKUGS_5SEifVgyI$H;_`P2-!7cKCKk6##qB~du*!T>1J0{K zxJh{CqN&BX>I-rvdltO4)7<+ne{x!A+9`T>N#0$g{#KbT_QSr`bkqAqqGz?_S^b5n z5(;;us2iK;>4<@>^$_E$o)a#v}2|*UEL@^JGiDP?XUa& z!rv{N;pSVm&$VoSc=}ONI2jUJwu>!ir4}&#&Po1r0{eVnr}Qu#1}hlWd#;a8i)9<7 zvW@6Gl$>6({$rQ4rke^0v7$m|(cgix+863^Ny8@x#QN=0{dTmzvU$03KYjUeNNhPR zwSZ1IBl*t=?DN&QlaqRhl+|Y(bKW+=+x9>EYSQ(McW>T>d5!!M zro07r>HwX2xct$##p<0>^-dI8wj%8hq^nlkT|K)(s_K~9D<6v3ELN|Vs?mGd2)?R! z`rhuFX_{}?JlC-Kq4!h&qfMXf6dR694aY^_faDtx*ypJS7N%^4<>_MI9p^hmZx^L~ zBN+WJY?hKz5FaI_=m$6sQ%U)h?P*(w;BFS(%}-rmOxm5h%|c*{?0H)3TeRdC?lwR5 zRY|_iMH~5v5~`Q{s~7F;mjfpxC0~o=>sfSC0L*)otfnIy51Yi|T~hHbp?KF*HuH|m zl+2XQluACFNwGUuGY3=9Q;kC&I|R=fd@%8lePPM%UYRrcq@(*$(`T#1j$=~CG12{! z!Wj0{nm$@rTU)v`a^T|hs63LQvDH{zQ`HQ_gqufsR&lXeDR98;uSMZ zvo^7~Q!4Hh*oSmTS3mWXO%^gri$6thZ!er@hnT&mz-2Oov zna>a7WEe5vvk&C>#Qk9pLp@4?dZ?)8@)CFhLYuEKIgOd1{kZ1N}JX5~CQ!mnU2^HCk-Vr_b5gUd-eo%w%23q)Br7 zH*(sf8^4@3b-kcX?q8}lwk5Usx2bKqwpeFWVoM9nWo;Q-X-IGT#nWFR(#0{}Z6IA3 ze?F<|tS}u3_08dys^49QH#H))zVEISAgZo+T`1QM`oHiBDD_$cl+fw6zsqK5Gz zA~;w)S=dVO2r(H3O&maayLaLb|NvLHA@g{v62%uyySah<+=A4T~og)uHO z<2REs2!D}Ykg_SRjD+E|W@sd)!qEKAUdkJ0x3$tew@LYc$VIxJm&YC0rc9H93bXo$ zM{oxh?U5wC&mJZroI6YfFhWK)oG6oNSq;lD?o8Dr&oJrB;TBigdo%em9Ry)JBO%ls zoasAe+?PNl(lxYn(Q2kx{-u_lrCg{`StWQARo8*Lz`}H`SjMZEY>+F?`0yFO5~yX9 z6d~RmH92qfaJf11Kzm9gj04P zDPX8#(-s)>-2pQ#{smvn^uXQIchAkPnB6nmB-O4KeQP8ijulipUowBe+{qrYvRm_u zqFzty8t%qFIwI9=dDte^?VYddovZ5=>kdnGhZjvnh2_loUI9=qZo%I^@83A*-}oT) zaPZOk&$fvEKFQxVWy7)L5@2OrbH!Z`8b5A(*z;+xSiD~<-Y*pIPdB$uxu*xk;)bW7 zg*M;aIbXeMu6orhCswbMs@F|9UsAlL-_AMT&WFiQZ-~Bwk`HEv-A-WFa3*^gHMe)JYVV_-#~s4yD`Hhts)|k?CP~K1 zC#_pV&sNE^b^4Z{_UX`v*ne2FbTU@NG!1+B|h+#(U2%`q~9w`vNGK!%u=c#gbi838+7d zv8>{@`Qnbb;*QyY`=`a?jZ*POp?D**pbnrsKwWyXrSNbEQ)bsQEvhXu!B8Rw=|!xJ~{nZFluCc4%4Y_|$m=z4AAJw;YT1)gO7 zQh+C`Q>HUviCw&jjDlW8w(^s##-6U?Z%QbAL$?&MK2&4w!?m2RT3~%W@3*YjQ=7r& z1FkMVuXpNy>2hy+Ztl9&FDi#r{FHzBqDGjKMx8Q6kh6^?pbI^Gg)C_CuTY>f5`&2t zVhJh7_E-l}0^_m0j<18z(MuZ89^Ypma`c*FzeqNJLO|(v(P6UgAX|Z?Npl1XiCoNf zx?rz`memn6j{nYA@0+XM_XrF7uvC3mC|>6CRT}08b_%ZMS?+#9>O2e|Ohe9Bbk9`~ zS=cF7yd+f+LHN86WNhvhq>?|fNX;g1Po&hbH@xPe*TQ zo*bF0KJs`_tUfMP9~X+3`FsWAqG~BJXkqM9(oK8D%yh~ZpBb9BS0UD)bs56<6T*OV z5r#k|a@L%d!JbV4S`1hLx*l|A4qZRCTWyBtifn>F3Qkg z83c~Hcgp=gxH`)M-F}_1#N@x!>+<7`$}@PrfQi5Oyfm6N{R>j>{rc3peAM;<&&S-- zC~>}CUt2AO&Zi#v)(d8#j3xJiu74&hN~qyR9g{}YFBLsyd-7Kt*(9sWKkMjPm$TF} zql$)=nMmLIIbz(S=;Q}Zg3xTq*96G8aY*GNA+d?{{W6M1~Vb|z?-k0jqVn4qxP{ul4JiA7#=k%GwP!~sv zXszsHtPAWoIka4KqT1|@TRgUbukDZgrTu};V|gw>&Sj?Hg5_)Fzs93iRDmXc4Zl=6 zo97HQsaM*g|JJWV&VD~fT*^3Ij)?-?52f-r5?c(pE_a;2B_HBnexT+sp!khzcESyAqznB|G&+0WS2URLr= zj3idYV10xiib02!-PuMxpyrBW0*s5Yh&d>my7*7z`zLaKM$SEQ-h&hDkVWB)-NV>R z0eW=+PR0v@2kabN7NRj+WR_4tB62;PyqQQ1-QX{vE18g+KT19lCiBPO%lH)Izhp&4 zVfx6NFDjYO;cXGf;Au6=ye(Qm?DztkY2ZyUZWq6oBCy&MBT_yop)o3)C0_V zqI_IWUp<7ryEz`g0gE{9oC;_AO}2Qmg|gd4ITbJ=Hmh=`h%wXX+7M?*ew=*7-LT5 zt%9c+pQjboQz_(DxMIe4uX46WbazSaF2PN=nWJtmY9Nd8xu+a#6qwiBEPB>U9+Cn( z{kV?H@u+`p^KoJG@oYXNx3Anz%ohdbie#2dQM**s4r@%VqRDL#ruzKU5vUgq(YVT{ zxOb0=t`5lsQ}i~cAN8j9pR*UeqN_!6fkJmU{WzO)yZ5{O-|0^mpN13}{IkL$@Xrd1 zh-xdsv1yi!k#iQ&(YX$dO>folCo_oEb zuMsLr>>&gn*~=jbO8$S^`J>wy9eLUw}pH@IA6MHu5{Bw>!+^AoKU(+EFF+a z2PXHzo&}`RgE*oDhI30`&7>Y2*md!St(bdcRj{+AP*=k!rRui;0b`^Nkzl z8o~7x8@Ef1+eJrU(k6HUX_Bs+o!e*5NzHqh?@>xRa7H?Co&8vFqw@E+Jm5t4Hp#tB zaBqXjw0Ym=IUnTw4~IX!@)*25=m__rzi=q2#COM^u3MeOJ~aOUYwC1%5&ZRwIK z_G+=jNv2rg{EQrECS*-u$ZMYv7#V7xAm6_theTui&*2z|TRQ@y8* z`omcL^24*sQw>P4F0K(ZgP5E0%|5szM@39>2|f8rRv<`9X1&I({*d|e{Fg2A!4AGUM<-b&H#wbY zgIwd$ATCWBarqqawME}MSBYiE9^CChGlO2;j2qWb`5=eRQ8K;i&3SOwxwLl|&G&g*6Nk z1~KFyo~VHFwi5{rwbN2k@eSFCxR^B&Xn1CB7_ZVtHogv)F}w!YAkY+Mt(xIF3@0O8 zM<)g(nlj@jBn8@RxZfZFWl4q+$mq&uimhQbuCYY+z7+@~w^CAeu7_-9CwW34_yTf1 zCWjqRWwOQpfS-zOY=)aqfDDy>1YgDsSsxJ!xbeP#*}7w8XIyfajGxe92o*PxQIp>x z)I_}iypPNj=uwleL8^9ODJH*#EP$01n7rk8+9vJTQ*V=wn6olzN6Tq?(~wN zO=vv#c<3jWesT?-?C0f(=({BOE(z?T?xaHfp@-d{?*H^KJo4x90kL>cDjpPy2cLS% zCyQhbE=kIt`IjnLG5+j%`2;cytr-o|s7GRc-Adb)(b$y6iPiL~!27EM(7@!8pXK7{ z`L>!=2s|a|2Oup<%BEF0Ua+T$eM7 z;@9z)jJbqWZY$LJzeJy?ZJi+z_>w23@@%jTpM~~s zaKK`Xp_f#>B&}|&cB($ogj>@aGS(D_L)K}j!1pOKA~eu4a?I$qeJ!p*$H+5L#O3Kn z*m%=|u}nxvr=HJm%(XF;Jf^Q9=QQSZtN0t$uUN0mlOlDc>~mG+OB(YmQ0bc&Uzz4D7zn}n6 z2PVyz$-`A^e}te+zO2FzYb77hPZ#dz#_f4*%MLbbCtVqX2BytoV>r{QSUdv?F-+P1 zH93qg@;l_CW6c>aVI(rENa0>3`R~$e6IG4ik&JH?l8>PpN%F0yx5WC889T@6C!Li5 zVuAahQb{@o4xEL~)lz@Tm`Xe1XYz+esV|vf)r>!hL*+5qFh>~ZmwL;sh70j|ls5sw zOaUE;kO!KlnX4RnUD|?v?d1O;WknN-x5YooZV{R#2)ihA~DB(_C`W zL0wk)jGazCM7bM$oLX3(WlnLVeHA6O0=bF*m8xh#*o#g)>_iUZZO>)%Py?w7StBK+ z_nh2{IRV_M$mA}EL3jE5uHagQ&jaq`=*J0ZGthX`<_QzrS^WQeLyH~O?%q~??z$UacSErVcT#zut^GRpXyy$ zwei7CY11Kb)nREBG^lK4VF=5~75%|!`-~qaA?B+)=c+qrQ|eiO%I1d$=eHl7+kRAl z*3A`<<=qHC@x?gmhk{o2iU;Z#8(7=jNaXVs2 z80G9Un4L=>y?O>nM)SL{pQpj|Z=J}}jhbJG$o^|KmS7KYsnxTQ*R8*ZM_wRSnlxN#RGL+RMlm)EN|b2cuY1Fi|n zc!quMmYuWGpAqK(DehX{G&)MqwNz;_a2?!eVax+qgDxhQgFykqwJ(1qqP|zLW2@K! z`Z%DKryZ9z_5%93NsIMjtYISmvU$Qz1S@3Yty(JmEQ4Rg!Z|0T<|_^H)OXqe*qr*< zfLQ>q*Km7a7Q~WpjsJs!S&YTNPhf(Nzy(#-CL4x=sSpwsy%@NPp%+hA($>|8- zDTILVAJ9wEuG95Pu!127nF7-C<>aliaLk~D@|1mj#M2^ZG(J%u30lnxTr-w3l501hBF(L)*zGx`x@tI<(e;A+hza)OuLx11n?rNhBuL#ihD9Y1I~%N`);mse3o2*3DAuL9wt`D(t1r zoMaNtBJjWGy({OuD{^U$@r5bR2jK;r$sX8X$;M}iV2;B{at(c$ zmZj!nHw7#c3o6vUf6mSEX>p_AX_`rio|ThU?37IKk#%ap=3nqP&v5sm_Y$IigXG@; z^|-}CyAzy#IKXk7;Pe}uBoW3xZm-^3V)@Gw>)tZ^U;52(WpjntMAQc$M&|SXOJHrr z%~fNG5XYY#FxyTBV>Qxz2D4-713s%-f)S_@cmDN1(;q$p0M!9|fJx#NW*_6Wz&pq^ zY*=NV+&-9-Qe_1!;c&MA7#AqHYK)I$l|Fp=4bZrigZ%vsr^%o$mct6Twn)Kv! z6F>(DP2F|`Za)^3#`?JBI0K6Y*G=*zX}H(eL3bEKAxCAQFuu3#meX)d$EmM9{7M5& zMp**tyf9&#(e;iR5e91~@;F#|V@wFITrfbi@F3ar!iVwZu^$9L_VFWR@=I@vfaLEe zpEfn+PFEBwlds54A*%bwJ<5raP9n~>2KfIKE#aTS*$=Csv}rvvcVYu#d%=73PE%E2 zTyRFKrsxH2I!xUl+t8bQ0|gUpi|dn_DJZ6^`0!!R?iN zWE7{1DBZs&$Be}CnS5vX67UGx0r?hsLl`Bl1i3 z7-zDZ7FSabF0y`o^u*i|K{BT*h<1K4qTTTw@ zuCQzlDsxVkLlrE?lpA&ssx`HQJs?U@t|pNM@{Km=$*l=1nD6Kz4UV%mD$1Pex%`|% z-FYuik1j+zY3;BFhe6Sg7=S#^fjo31-h}Ob4igo1Qu_yx_eEs{3}qBR08*jPn{(4$ zB8E6FxgOE%4I{s3Zv_j-g`Nn6cX88cFClq^E{>sLVlIZwP>$UC^MIav>NU1-XJtWtdHGxeRt@P|pe_ zswB~xVtRyuD>~jfHsEY;E&Dp-5DhTq*Rx|$>xpugGK zZ-#@I;U^r`vFhv-xzT5dG)H(}OuyK+!w26zns!u*2sCT|;KYDis51x-u9>kTLd zso-0aX6n)SEHE3^0~@3wt{!{fSMxX4AF{apOcqBb1TC*KiDx!9n4{7VdA$U4%sdSK zJ3z68vu5Kq8rqeomu(u$WA;mlAYunKLEo!#y4;>|BL&n) zPGnV&0i`aEjKm@gp1|Dp5Hn+iTmJy+z<>d~lX)o&)IsV4Ab5fFt6_~6=q3!{erqgB z*JH6*o%{RwAE6TbEIB{L41wn71$@Z>qm@F-$YIK|jpQRJz`sGx5XECG5oRiip@dcR zA^-=Rm231qN)7`Q1Tqxso>_z5-^0rnhy(~Y=(J^VxsfUPACU_{1KlXe?vlhp;@&+d zx|$_dGx3xwnIUdjO;HVYIV(SE#{xh5SFK|EA*mf_$`JH8^^;enqr*=wkIfw&6ON8S zN1-mOXnDV1tlcKnLP5e-$k^#{zvrB?Oby~9*{SVVdt2sU!@hBS8b^$GeBu_Ww+p`P z2VhF5?wIp-2;Po`0JJYZamZIA3xV^{!izl~ncE4Y<1Y)o?1wlEt5~&}$)op=h~6&A z+a-9q1VPk-_^#7-ozS^)NbSwA;E4}QSu5{=} zgfOJ){=&>LI|N?PIs2tWY7g5v|6%#CFX zSAq_hU?l0yDxGUoXz!)K3kt%q1(q?{^p@qygso_)gL(b?nM(M6_y&W8-x$KEvQ-(( zsQ3#+%o=bxjE-mGNd{(eFLe4o-oC)j8i5#Accu?!#|D)Ax0n!sFzn)Px~(=B!qh+Y z)=h0At?Y`a6g0KmEt0!s(PDMhFRa`E3hdfnZ4y@=mR25SVd-Oo(y_DBG49EgSLTkr zA{=`Ku*+9Jwe53oF$eFxtcc|7&IV$C*B$!RhWh z9g}-=upUccL%O2s&dr%-p`sNsLizKw0t#MG@$ytnzA9@%F(xn)xo2EDO-n6`Febe@4{+o_>OmFEpL>g!BJC4cxNynsZ z(mH9H%!B25JFcpN&COh^@?^^w3np*;@xe%pE}d1)oipwTH^yclO@82_n2)%;N4Fq! zIt;`*St_i^$|+RMMm=LjTb|T(T4RiXqjUkbN=Wb%!=Nxo9g@^5vlK-3{xmFBeZC5N z!T^K`0RdOb{N*KhzHfiWbQvPC^Q&%|-*WJFfFgv-&jTF1n!#W!ecrOXWq->yYJSW5 zmgB8_jYs-c-hGo%kn_E~+nwl3b5`Yo|If%w)~;ZzmaKLKJ62<%aVLZxLV{6>#<(vO zgMW`4rar(X2jkbM6DBJIcujtoR^+pS?bLt6Bk|Fl=8TiktQwl2|Xi0j~ zmab}KRs+((ZV2uR>%i2eGY4=ME&p$OS05WycHQTVXY8?O{5>{f^Wm}af=*75Xy&y+D6(WT6L>N z>KpR5Os7R6tw@wsX-$_%5o*%@e&@b7@4XqDZL4nkPalutJNMmt-+kwPoqNu?=VS|I z@iHo)QIh4Ec|<4Kk5_V`tfq=+qRMDV2+{;M!|`EWam!%&SApW>y8jANRuciEM1Z=0 zhWaeeYQgWRw+lB8mU2Q>zWVq=HL~5~gZl)t#S1ZCMID4BN+#}F_Z+9$pGFlxHTaz_ znrMTp72lJ8fnFuGVO_|REz!Fw=d7cOedBlNd@v@I24uE0hw?|qE;vq>Umw(uK;~jt zx~W`eOuFU-rBeg1)?nPmhuhke>JWTCKw^j)1@XSF)ZZ|@)+ zc~ki*6NA*!dV{s<(TgLB7uSTcfw#8uXj%PT0Ndt6R;1{)`9OJI(rf&{tslLViqpr~ ztRk?#!NSYvJ*Ol>}5Za$JKKWdgA#Xh-orTEf;+Z{8! ziu>l6VhWU3o8^sW`6eT@NiBGslRdUMxB){a)jsG&fW$Ef#)z1D!Ebfxm?KHdU52qX zz1)=oWvNSC7)lBr9d8XJf8SnG?4Eg?{yS*?0g`CNeG+LXNWkBu1C%CD`=YaqcZ@0C zkfO{)t?F?aoS|71cO^=U&q{Css#JEddFxU?wOP4ACpHXSFpEMou zAydA${r=|R?YC5S+0XWS9>t^mN_@3AmE)b829?kcToiO*@$@?y$WIisR`z zI6Ux|g7*S27fe^jKD*thUITXYeAj#zw?b?0lt*XJOEdOEeDHa^MywW#=TW_lA0n$; zCm)OuoFF(#Fa&_lmoPQ`?65nY3@xy+o?$`4+}g#E=mknXD(u_4SFwE}v7b`0V*7+L zDfJGC4Jl$2tG>@wsvMYnjYUiT*O@=`A!nx~dRHNxpx;yP!3bymHaQ5(%SS3Dx?q=mmiyA+A>#lWyO_O z3y~@zAx0$Re74Xl5_gm}`Vq@1bd}?vN}e;N=eZ06C%-(eThwcFD~i@{^ChPU-X!Q| z91S;G7g)|v9)PJb|Xh-!$ruq+s)EuTDC_FEdARp-HEL341~ zg3k-~YwLo~qLe&%Ok2THyx@tIL5iyK;EqOq{UV@O^A%Pt_^XKr8-VvzSoP{L7277y z>*#aa2HEF~K!0u9uuxu4Z{3T4$HGCJ#Px!DDKZ?a;R6M-McNVaNG)&d7o7UC7nU|& z+6VL(;P~wx)t)aX_SyeNYe$#Ck8BVgyknygc*G8l){R!+Z{cYDXbt`riN^VInQR=s zoZ2N>#Ee?bERsg)n)eIM@E}Z%l*OJ>Qr;hpl|G;A;3N<3 z@WSba4*pz`jz7x3E7PmD@NXO%$GBBP$~5&E+={l{jJBns>&)o7 zThY#&(auz~%Zy@P)`~%!0=(7(M%*WEN2=#~<{Re^rXmeyqyYjy+#qPJM5;ah8s#hM zNQA50%Z_je+ZQ9GQPgBNjr!WxMKq0flRQ)HVM~i7Jr}J+s)g9z!`SQEMpe|PBlBwU zVZF%sw8myXDCIvwrF6l1fx^0c7eC26!cG$3^|?J8dts{@N#dN;`Hb&w7@GR?)v54G zGrSTe6csvG&!1NZUg0!A-Jtu$%Ay)u!G2z#fn}1ujn}F5L_$AiEhQx9c_bucorL}l zPtj?d5h4?;5WR)^BJJebHiQ9y_YmUZd&4GX1_;8vJ$%?B%j!9F37av%sN^h+-&D+prWyaZ5PlhsN_ z&RO=E)=%kYlPmg^tX~8VLs=Dvgt&yvgzTP^EYIdrb9yprXLQf;$+B!R*}^7cJsuW@ z%}^N|O;%@9o~N^Lcrj+=k!%<{UTl-cr*v1DvX@TAj!Y`$borTO(ja@SU8i2LxoGvk zM6z+W@M%bwgNVOR|RIIZ?1B|XC( z`WM*H%}tJmyrf<%@mI7=U<9AeA%6n7GR3ju%9%`?c8SuOLbCodU?_{bh{D~jf&SjUJwzYBPPWwf==&?8mf+Jw zAA6e%eH*Ve8>Ji7eSPb@D~P>*Gth6?w_wk+)@PTMr%)7GT37Km|3ZJ%JpC|VAx$x} zCKaw0=S70hliq2uOGU@kmiCFaP#hs;za0j*6xP-)EdwvNaV%l=R$*)#QX&|9Zo{8gmPzo=R5X}%nPiQrjMo)${RRr5J>Yj!@hS}wWerRnK& ziESG;oWc>+^CvnW!P#KX$xdKAkvKn=*Z`Yp8%AE5f(PQ{)NgBo*?bYdEb)TDpiZ!In)8hO1Jl(d%lXcX%ei`Xd;xxGK z*n6BDe+8`iMsF9WP+j0i|L$j>-o0yZcMoJ={|Kx(oq?wPC(l5g4$8-HsPHn_aQbOtQK+8-_1S?WNRBvaPBj%1x@L0x*lmD<=IeD3Mp zJ^BJhRl+^i-r!gx;4!yEqu?>SBD7pv``uDvrq>Mg8utCsW9G$&V&?1=Fa$pPWc>7b z2!W5s=^4U8lC3jE3i^1KQs6c@OFwiZI|t}yW0={LP8H=vz_a)lw+IgEk`8C{412rq z3We0&&ki2y9_sDey}xJZ(7?dp(1C%T-TU)#{0ebQ@Kxft$&2G|F12Tg6I3Kg$1TJ-g>x*Faz~Zv0|$Wnen*OnbFMfDbQ;;z1$FI1?%y7rDEPN>6b|$qo|DPN zj@A3xrwyNI-ZRc15Ii+0+Pi{d?${zOihrBQ7ty%8-yl0g8HdqBNNTNcQ z3Qj?R<&^JI*`-q0G%kS9^dzjolsjji6D9k6qlIrHt;2i#ly)()#4#~fPH&xXa=diO zJm3$i%Q*?1m%D7q+%+}tU9g5+Mw`bMbL_Cdx=bOC4DzIQ#ZcDDj^~Ux zIA3mC;BH$rUd-U^zqiL=%sTwCOO^0FSIK>+x~4bVA&h{Ei>Q?>JbD7|`!i=|xCd+ZRgFx}_;%C!oB zR<8E4+b%^txQaTsn*I%^oN4m*tm|Slr_RNbHA|+=X;s*)3S2B6B9SE*EOfi(?u&lG zUg-2%`}v}CZI%7h{TKbm)Az7(;J&Xo`O?ub5ZogZAoW4m=wlPmwc*MN?K+V99rlq# z>=w@A+>B$0W@vg!oq-=-r_2W(kDnZSIlEC`cJad@Da1P$Jitjr!$v6cQr1FL^9 zQ#mwbZ!mBeed6TMP_n5Tx};gvvG`e1YjAExvfi>)(4l`1U!<=DXl)UVEOqqpj~Oc` zUd{snI>&|h5>t+G3iYwG^pHj#g#M>UnyFH!_C=!zD!L?_^{4o>hk(eGlatCC(69OP z8+^mB82TxJk3Y8|lqtr_ErxLtx@ZYB@-c_8G8Qz*gj|~SKWFG)8QKkyiBQ#IY-9@R zzpz;(YkZ6k;{x-0Mer%=(tk6(ocKUMCD5}Gqh7IG>^HH;Gm6#hg!_W@Vire4XcP;U?SH8O} z)!c11cS}?n`S)Hva4QnO8Btb>BW-4+&4{$!EvlSb{r<8osiLiB5xA-a!M$2Kw)~4_ ze^_R$-Ij`NH)GppOJ_^(#FpQRb=-_~7#nuJvojUjW5)I%wg}?Z^5B35MMERHS zu87X`yxMoWqVa0$HTYfYG%Gq8k&ZUu&w(`TUB7tsaH^&Srj=_pAPN?tVH252a(ctv zO1Npe-t+B!%9Yq`VR~ibo6lbhm@C&qpjtAwB^9cNoGb)ggpy!edPSV_)VkY|aypCq z?06~?HzV;`4OR|jwabNccs7YZ7|KPnnh6ULWy|IRS6;bRnrhf$Hf%9gZM{*MD%)Ys;t#4YemB44KusUKn!}<_=0`2 z)2Tr8P9XGZ->YEPExQ$1bu$2?;Hf~f8E7`_TXqflUt-)msG-2|1&qCQaoAV0{rq}F zq9mV%n12j|=wXaK?}V<*NxFGO4k?fGs$>^pf`F+V|3twhZSv7#5Sj=F5N?B|0T&4k zO9Plx>uvd$iH}@LNAuBcCb7Hd2wm;xGrbQwVi`rMS3)^N8m*9C7=a$Of5G3Nu zoz1`q)I|BuTLO<#Ep8%6)EJ7AzmqTSw%ERK;4UZnEx}`nFeD+=rauS>LWJE5EpR!R zF?E(E0&u95TUcF;&n4nYY-THZ%418|jYFh%4yA&b40bREEaRV{QGGuP1BkJ^e%isq*BA@F5m>mX^2py?BR|Kc=-^Ry@s;k zV)H^G6QMg#D9+2dhD;G_Ffo226J%gK6Ye`pE}S~iA0o>Z47o%mz)&UtBM5*KQ^!Xk zN@J&0*@pC5v>x7cGDiUWLw*rKDf(EV3{9uFY0GYf8*YXht`?=jEoPX8_k&S6rFgff z#4O?ohoUB<2-8`E;kp+Bg)|=DXt?fQ-ll{40IbbtK{~R0c7XrxM51pTc>RD;e=-$0 zWkyaJkyD}+I@d*?UNIVpc+3cD5u2gZ{6v=IH)zzKp^5`4M*OT*2uYL0JCn3@e zQlZoh?(ye+Z(L3i`H43y7VX3dW9%D&O}=lf?yfKRUY$m`zGi26!S~ApJFAPnU#kHE z*Mmgl5dslgK7$Zq|9}x2vavfD3y&EIO%oUde79QKMcBMIDq2C?8OQ7#BKc zPMwpo&Up}qp-2{sG=y@rgih9m9s9~TOcO#ua%K}-)sQqY1Fd%?lv&9LAJJNkA}ML% zQLi8%k*5ewZg~|6S;J5*frurAEF?ohuP5LZP*J$t^6A_QsngwYh8hW)2v!p`6Ffp7 zB;{I$S_oPR+5j>UsjD&+mC)N66?Sa{bZJxWn)MC>>6VW&L?tMpsjVWcZG*lE@tJB@ z5edp2u#?cc_(Z)gLCFf-@oaVyV?x9f)?t}i5y!(8BB@R}rf+p}6Wvqi68d9|Qpjdh zLfOqCU9N8@;ND4pl0Z7s#~6BwpqpSP!7hMIsnnK5fSOOpE+A7Zap$MUCoFv z=l>Ga`?MCrx7K~9eVvB)PW!qH?|sL&#_-;0-v+~bF9ZVG=5*i@Bk%rYx(HVM{n};+ z+zE6Ui`}qQq-`ca6!KLy&XlFg*Um)JH64bpDjj>$@YSSif%xh)ys-LW>B<(Qs6j+k z8t!|2u?2t8GT_$+NQgs!wJk=?+G`PIW{F8xJ$ilb%~ekrtDd0G*LON*N^zpLykaK2 zP#DobC3?ZCgr-4pYH>Js^qxGq?|wc}(5~&$7JQ4tdlG-&{q&d?)v#svf{t^VHi%M| z{&P<~yYEeMvY=Lj3VS}d$GH2>gU*2x4V;U`;XR4J?|wQOZPK7EmJjYR?!NN?3V)@w zvwd@u#+sgYPNyOV&B(!-;&gdz_JUE@W~|%!&c0OnfLT6(mMvR0J8r~Uj5ek$J7|_2 zoC&9^SIj+btn4(p`rg}?sy=E~A2oax>596!Vxu1Ud*3TbRU9@e4$qXPm&NBU7>yeZ zc!YR9wd`4Q*|UZ(nr>*BzhJaJZfyU!F?>4JaK>yngR!|#=+}+`qj|8zuMJ3i4lD^u zd>*U_X)x^I1+{){kCc%EQTCL?=Rm|KBt8e$`k>|4gyT%{g~}tE29p#^z;phnh7HFO aKx}ILpt*2YyYC0>;a!gx{NOPS@IL^L#ro|4 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/networks.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/networks.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..053fd6876cdca32b9e4808caf1cb023d2e995e47 GIT binary patch literal 20679 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 pBO~Jt2J;IH<_{P&FQB3aeDW9gG_T>u4}Y`_2j literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/tools.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/tools.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7e64ab271208d31282d98e06b510c10c7a60530e GIT binary patch literal 369 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 WzE9cL&shj2?5w)hytEkO!~YvK$)e`~ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/types.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/types.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4344131c6f053c3b1116ebd8bb1efcbb82e14706 GIT binary patch literal 97931 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

        1|xyS4(%ddXn??c&-wM@jJt++C_VKuO|y6AEaw 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/validators.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/validators.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9fff91a847db3f8b97259fa018d172b407c1ae47 GIT binary patch literal 379 zcmZ3^%ge<81Y2jHNt*kBzzk)4)&Vl6Go&y?F{Ci2Fy%1jGDR^lGB7cuGNm#v zV`N}h4a5)-#gf7t%%I6qWg3!^s*q5Yn3I{3Sdw2Vo7Fxo}VV`E%x~Ml>FrQ_*+~E z@gk5TZ*j!O=OyN*0;Ra)<6(N^S2BDCx$2j@i&ac`eo=OebAC!@UV2P+DbURPqWGlz zl9<%IvKXJtq?qE&l2qLSptBOwQ;TB?DpL~kN-~r65gyPhsQkrY1M!4i5jW6WkXwrl tfy4)9Mn=XP4AvJItRFCFUO+_;_~b9}$uHoz$ftRQPqTp=1dBL#3|LmQXg=o4fNdx+$sk~X*Z>3jvV0Q|6d3$z?XYt#16^n1 zsYet-PvBokyp6a2!uCV6iL9ew3Ob#5%Mi*?dp^Of$e2xtNg2;GDGsZQyjWA(v zGLSB+Ohq4s>5sBQ{fxMul@Tk0Fw7d0b}4rH1ra@L*Xb2mOkx@uxMDK5UsEeXn8s=6;nt7d0Y z8+yRp0%cjoDsF+5eehQXpva-J7x|k%9J@1i@51JlkFMl2XGVcTXqYava(wceS#pIN6eKI=Rj2F~{Sc%8CZ6?Xt%us&L+_O6(ucu&@^9&X@ptQ;^~ z>QR$IDC6M0yzLSA%M$N?reY${C|GF={=MQr3Q7^T5>fhzmwFx3u~gp8v$aMV#4lpi}?)`Xww~L&tP1} zHT~1=)^1~+v|mhu6p{q6tuCjVQXA?r1g$Ct>h6@psU()ATd)A6zyn_eJas1+I3cRL zls8@j60nOK{=+0F-38(@fZHa@pj&6=z?@kMpbh1re}BpV_@$v+ZE(Ac&APqc61*T- zJ%ZJrkPS1EwRID1QUFJ<^E9}JBkj3;Vq!RwWo~D8sS~&dCSV4NX^1S&O4P<=dvzBU zK>4@;{WdnDQ>!|)t`OlMhGBwcyPlIvLQ;4)g(uS8X3!vUn>{JXaZXYu*c!tm@GIA# z_z(PYs1Ot&7q8wZT)kGfe&g=j+a3K|9sQ4~$7ertecAr>+Mf@6ap0?0K7Zvo{XAYA zx}*(VDt27fIxbfxHkL-52_Mwk#6$|>l_V~(2|?w+BRSn&qinK*Uxm-Z9b!WPhl9Na zPD}t$?=syYM!bcMS(-om`5XA>Czq5KX?N zySN3VLhvHYO$fR>7F!f0Ar{kpqCyT;4D2oI?qzOWAWhw0>01}cL8yd#Uo2+YIi|ao zKuuM}dZ2P3QdlMnl6_NTX}5ej}f^Q-8=}f+CiX+33S>}%U`n|D5|$5WQ8ae2RXpH!N))@`Mb9LJzM^syjtiz3HdSqN2x*;{iihlse=F1e|OqDetCRz@}tRo^poSC zPX2E4Y4nTZUrl~K`IoWc@RT+@RqVN<^;{{oPiyVdxv8DQgMT{uhojGq6c1m}4qqs^ z#lN2Y$JF1a{x<#fG&J6~Z@W9U+@1Hkitawm-B*A-FP81d@q=%?=wNT@)!t9K|JB`> zR~}D2>n(OqYTc8C?i^ss5WliliMi=7dT|VCJ{*}hBDE1ojVBho ztt3f)2ZGYV2E#G)1M`d`E+vf@Lv7kfWPlge*~mzoi;pZEyeXM1)mcPc?KG~ReP#BRwq^N9}V-) z?9rGJ*d>VMBrx=>hLKDT-Nv(CV=sT_XP8aCYhObVCZP*Db86h%E8zLBVrFR;J!XDif zi}7+Cpxp}~zXoqtfO$;3QTN9h9=?PRZXPg3{LXl3Rq&4pjmhJpaz2b;>pod|ZBO7? z7$90Jx1lK8DT*qg^96K%2Sp3kyyNZ3xpus*Iadk2Qg%A1BV}YQT8>bQR2l6ne@^+S MGcfR7r6Jt^0G$vdNdN!< literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/__pycache__/warnings.cpython-311.pyc b/env/Lib/site-packages/pydantic/__pycache__/warnings.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..aa7a3d20f39a1a321deccc9477fe13419ff3f471 GIT binary patch literal 4808 zcmc&1OKcn0@xA5pE9zsrk!+=oS4y3PX-&DR;S_4z#)$%_*CQWBXVM(QRp(ky*DLC78W51vv+&@w>FvdkV@R?u=l>)S`m30fX# z{j6^fUtZ7#fHt^~)^7~Wk;0+I0eFbEc)U$4Dk;Cw3G%d9p-6Z)~H0tc_liF66?zd4-BV@bXUyf z6nI`;Hl1il0hDW|!wlv6GP9Jr13FeBUKlOcEge;?RZRDWVp{P|MdjzNQsefDX)p%} zWt&%pF%;Yo*K(Jc*e_ZwkOb$t+&1butgcxGPE#1@QU}{8q5W{9>&vFTEU3E8Idf{Z zWuS1q5?wbd6=jhroK@`=W`svP@4DPvth>ya5+dNStITn=fvZSmoErv5_$F|Pk>n>}qH`6%zg9^*MY6|!oBU1sR(d;g^n(#E^UTH> z0P))zd1C#Y_utvjw?>}b9(i_6zLjr1HVQwv)|qMV%q34bjqm(|_r@=`=T&b}-|iALWD%37pShnmyvuW+_YAhi zpV}UO?r(H^e5#%3@VCyL-#&NQn|pQp+-u$A;d%*@9cpJte(2WJ2g6_Vo$&fjwDL#1 zk(Dn?OIsy#yJP|$yj%H|wVBr7@Y(=B4zd<g_b<(iFZpL zZOJD+@ovc{;nv&Kq3uK}xePY?#&9T|9BGrU1wyw%)}F#AjLmfCdmwyw;UmhPtSD(R zH}fS~lrl-UOgWBWvQa+YDPP`vxGTP?IQ2ylU!hPbLzLcE6hxUB3JQ_Lahx6XH%Z#7?%suJyes36X0oaTG^EN z2##Zr-;_J|HSk*DD>9HUp9JnAvcbN48&|n;GB^WVJCgvwn_8KpJ*nUoOa-sN`^S~P zrvj`S3Nvq}9<4T@kHhNxNd#zkei8wS$1!H`X8?5jIjUBe{fB_;Tm;bN=PkMB$+fmj zlb0~I{0A`bP2A+a_RS0|^1t!Tv;SA$2+k0Gw~*XlG+b`w8+-Ai&7WPa{AR z?{ffDD@X8SM9?(@4jk&SSy&*@9lRx-Hp;*>EcwT0m<4^9{vv}8guSRa?4oV3s3V&# zB=-2_X1EPzK7KX=KLfMz=`V*MV3Go&`c<_n^iMYw)OV z+}q3q?dLb{(;l%@S2+@NBhamNdOc_%u%v``5Bgmn9VX32G;`I;jFL8p@E8-IRpq~y)pTJ9mq`lJb zW}Xi!fuC~pAM{h_DS%MBP}(A69vQn!CcWPGE*bZF-?p6WlUCF1p%WCc?tb8n{pdap zKj_e=sZ2349t=HY>b@X7=$i6!|(@k#k5F{ycFF+Q0|F~ylBsk#M;$=QkNsl_n`l_`mNC7H?k z@tJugsYQ8-Ir{NHW@brzyk0@&FAkgB{FKt1RJ$Tpp!pyd6!Qa#56p~=j2{?aL=iJk F3;;X|F?s+1 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/_internal/__pycache__/_config.cpython-311.pyc b/env/Lib/site-packages/pydantic/_internal/__pycache__/_config.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..65cd85096f6aebf88ae3c833c71474cdee5f2ef5 GIT binary patch literal 17280 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 LOWy-fHvj(txoThl literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/_internal/__pycache__/_core_metadata.cpython-311.pyc b/env/Lib/site-packages/pydantic/_internal/__pycache__/_core_metadata.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b5097b89c895498336d468f1313a7877adc20642 GIT binary patch literal 4438 zcma)9U2GHC6}~f`@n4)c!9W6G)1gp;7cf67u{4d)=7+#iYPJQMtw}UYJmX}-cqY9w z1`-*`t$4`8c7@tXq}^7cRbh9QmLe^`VuQIPvG%Ori)2-fn@A44gUd$NDBLs$I!0XnEx_ozgW!1%X}XHRqyjnSTFN!OY^jS$|ER z2K+y6V-%PNL?anaB^mx2CSf%s^Tch zDcISVbmQvslBQ1TS?7k7v#7LS8LDp1OU{BOW1TiTLn<1Tpo}>V)#nP1 zW{7c|%-mD=Z<*G!En4jkjQZWzru*{;}JQfn^Bx&?3F)Ru2sRF#?&GbJdd zG~DbNuJ6|0eAtw()9z^Hm&DWxP2#YXBTYFD%QZlGkL}i^_7|QVRz1F8wcKFn?#2>RV0oeghH7kYX{SN3Wof>hWdt>II}&cb&4uuMsjaPz)1lB~H!4a8x43a(%S>R}OPQ@536n1Nb_`32lV z*`~Wjr(}bI;Ev}sP$HV*x1@Q?kv6&1r$IUh>v(~A&0)CrqPne{wxgI? z%@a`8i=b;hN2x`V0Z*_sBS-haJ9G$$4ca5%*JwY^0+y|tx+BXg`?i5!sxf*DU(5q3 zk!t@NtHKAd^~9bBBR?HkTP!D%l|*tiTV?vIpXLoTb&`Ucl7 zJW|VjM=E_sYJ`it&pq2Q==JUJZjg0It@YJ|ymP9f07zG9Us)4geu+1w@epK!__J zeh=oithR|q9Lh4a}yA@3tR?_rqpie3x*$*Vi(?iHJ9HCX#VZ=JNM^FRM=o;-DkP@jy z$ijgK_?CSWw=K#0{mh4V=zjFX)p2^GUyH@2_RlXmTkjwAZF2FY=@Vq zwWLvJnVpaBLO~V_&~)hD1~~|fJqx52cxt?WVFyW!^u1Afwg9LkOd_)|m zkp_7lfWCY0ztromjEh1*jNU=?wK=Zyi?6085X;dYfN= zP2y5dA1HbVnnDsoavVtyk`q8SqY#c7lI#`)=*_~z3K}wA5qKtUqXG;Vv+$$CPMfh8 z1*a_vZ1KEpo*X={u)XK)FkG_4%|rBHlrIK86FL+6yCTGFQWPKJMz@s5(9??GlcckK zSA^XMbvVN#t|&g@pe=%l2UmVFUeFB{EYMGj!DcbCD=!(mAKW2leq~V2!(~GT>MSVC z&|i+RjWE59L-(V*Z{=;qofIg3+)xZ)6h5#BjRWa$wx|a%5^e)+{{ey1k=f`B+{s-I zqv_`%h{XKQ_z$|^q+FWW3d9~hb;9Frdfcs!sIwUzMX#2%@=Iq|hUZWzO~kRhGc{^h zS;er=rdop2u&#~ns6^cOgkOKLbFFV}?CE!(&fe$lpL{xtKV~OMksbh1dJxGskYJkV ziI86A?PQR_x(%`ntq4@#vmq8CLPGI_WMZ2w(h(4vfXDtN5O8X{NqE2w9r*o4_wDol z+*v-Ft{hE6`&m!FJCJeDT|>%hx#xPN=eird{@?gub?8lZ=)@;;)#N*Fa_X<+)f4He zl&VF<-r#crx6o#~)24E0!|CYnC zy&(7z2t*V?;`R9rS-S&ipN(I%UiZ}>ymwBXxNvUb+wZ2&dwc3xo?QRx0vXv}P^hM| ze2-$r<>xT$^OD`2?`~1)FZtok@TmVqa+Z$6DEbV0A5cgnIIc=gxt(>LbeGt#N_M-Q zb)5{jjk+F)R093*;lKrJJTC@o1S3`BK6_@qf*=i2ncp literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/_internal/__pycache__/_core_utils.cpython-311.pyc b/env/Lib/site-packages/pydantic/_internal/__pycache__/_core_utils.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a9af42e7b8aa01b6ef9475102579f9d2fdd0334a GIT binary patch literal 30714 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 E0|~!n4*&oF literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/_internal/__pycache__/_dataclasses.cpython-311.pyc b/env/Lib/site-packages/pydantic/_internal/__pycache__/_dataclasses.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5e8cefd88ff9cbae5eec3c5a8271dbd21659d7f2 GIT binary patch literal 10796 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/_internal/__pycache__/_decorators_v1.cpython-311.pyc b/env/Lib/site-packages/pydantic/_internal/__pycache__/_decorators_v1.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..390bb6355488c5336c56419bf1558e1b4e404324 GIT binary patch literal 9945 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%0D`Ji*-I3HjavWQdcy>7H)vz_L@e7V^f&h3Y&Fx z-rkBTAGt+QZnsco(3LthhNd{x2ZZL`ai0!+g#hkB7|qV=8o*8xhVDp#honcqn=hYH+EIj*yn|A+rZZ_ z;Z@BK4@aIe#Q#^Lxa-o}D9U<`4(zpROQ9P`*aTpM>>N9hJ8$jOY}h40u(50O%Gw&~ zRmRQ;*5Rk(Sr49!oBxV@NasT(-r+h~B6|Q+$2frDOjG&Ug+0wt$b!3}C)TT^E<0i# zaRvtc42yfHPNACeNd8R%HA@rJERL+>I(*V&?>=~UW}T4yHD`8q7ckToj?IrSKWP1e zi2+`)_A%kcZ5dK@vzn;J6{t6&h_8m4O7XIfvd0?6EHldaJ9AxovQ;NTmOQ^ehIt&s zP1%^3McETfuUN@>%NZu5$CXSOMcgP$wn+XChr`+$GNEGd@Ybd6xqNW25FFG4gUo!4 z086#Y9!b$wZL8s-fvx6mU|Yj{`FUp<5?8L$JFWQS*(@Om?3t;OA-JjNiqX$98hzd2tTl z{H1^0oAqX!Ryo?8_2gVNtXq#+uYKOEE9*to-#eoC8}pU*Kp*!a`kG^!HbdW#+i)gi z1#)g#gYz?aO*PyrX(+s8gHOa&4T3@{9rDu@^fiqO&CKw|l{gv=RSh5RxCs$IO&Nak zS^k+uqlT|+6gaZmd^TFDokc~yYjDdfe_%&AlMnQ5UfY^1cJ^=G++NLho+xyl*t}K@_H19$nQfOm z@|ecI0AkAUFPJ zpB^0317pl3p{ir?ph2KvIRfCBO4+_*4@As=&9aqe+M#zqj8sAJS146<=LJxdSxxn` zYHCl_&`+TEUn5xr04Sr>O+5ZhY2)V`KgTNJI41m!0VMoAx~IG34!XumWG^rT)sfD3 zl($fx9qCq&o+;LG@O2vfg8m2r%WyAatJ`d4NiAC<_BHX#h##Z_@CQF!FRtMKZh$Y; zxY@(k>ze-xVKl+{O}Zx!7@R!*UiJ zT%%@o$W+c2y?|I50V-+NhuUYJSHW4~d;MklOTa?pCh8-Ir6niFaYgc$PTtxfqq_ax zA*b|4cafaa_jm7*9#T28k@IY~eQ8a?)99I~Hg$Ig{7)2wP`v~Xwh*4Ph z0BP+g@;!R*%lgG1>oZB6Pk!fgv^qBYB_GFKhr#Ng=RDV4B6g7ANLTOn`J8k6;%^k4 z1b2FcTrd~Qb^q=)oq#twxmm_nBe;DV`I=>XS$J5Sw%7Jrw$`#&&e~c(WII-DQ

        T)22x6 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/_internal/__pycache__/_docs_extraction.cpython-311.pyc b/env/Lib/site-packages/pydantic/_internal/__pycache__/_docs_extraction.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f1b05b5663fbca3db30bf99b498cca4d2f20ca4a GIT binary patch literal 5667 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/_internal/__pycache__/_fields.cpython-311.pyc b/env/Lib/site-packages/pydantic/_internal/__pycache__/_fields.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..20c131962307fe8daef2d30483482bd9b8016a71 GIT binary patch literal 15588 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 P$S;b=DDSBem$&~1CUb#T literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/_internal/__pycache__/_forward_ref.cpython-311.pyc b/env/Lib/site-packages/pydantic/_internal/__pycache__/_forward_ref.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..43b9ba64210e8a95161ebba7f47045a8dc2b76a7 GIT binary patch literal 1462 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 n`0gV&U{DXRO&FZLDW z58~rVuOPf5TohzM7E{8MI3|kp>`8gXJnYvy=4HRWF&}=tDgRW(SOv@DO9iHaV?p-p zPlcu`$12%#ManxB9t*SQK*~228H-F+ja5xmk5x}a$D&g;V>MG-#fb-GSxcPI@LDT#@?$^+oraU zZJ(0HBvDX2H+I;Al&f$0=~=Bn&!gx``&c`2MDSiCZ%K7b?Ht>Q_gbY2{}9Tx6P_l! zurT2*K96;J1f@={`@Sd$AK{N*W4l;veOc^oxnZmet;9US8A0CqmLNAO-O3ham$JLG z{_p!x7yhiedeYS_e~jn)4*OM`;+_gZ3L)eJ!Z3 zRjJs}y1V{ftMxXXyR7wIjC0TT(Up(v4hds@toCilzg^jSqu)*_D>)#K%Ddn4jXfn_ zlrPD9-tvzxzn)%0V7;DM4>l)2cF^P?h+2DxqoJL9=S~)t67j2VXojcy?&`jOjg*zHJ7F zvWl9>W>nL6E~#bB0P3DjrmvgT=V!8sYbnKk_m9p@rxY_VdV5;o_1C?kByL_xq-K

        1=ZRf-*j%YROy51;l&IuvH!Xm|+w^ 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 ZKHNv$&}S&1(Qde)DrH4Fz8RDF{s$oamw^BP literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/_internal/__pycache__/_internal_dataclass.cpython-311.pyc b/env/Lib/site-packages/pydantic/_internal/__pycache__/_internal_dataclass.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..95d9d419502358bcf7cf08d16a36547150cc1e1d GIT binary patch literal 335 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 bwsMDg0nS_7Sai$`0&F=8J>w-n(>?wdE^Y_- literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/_internal/__pycache__/_mock_val_ser.cpython-311.pyc b/env/Lib/site-packages/pydantic/_internal/__pycache__/_mock_val_ser.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..afcff117b8ca959033776ade57b6976f59e9cf05 GIT binary patch literal 10338 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/_internal/__pycache__/_model_construction.cpython-311.pyc b/env/Lib/site-packages/pydantic/_internal/__pycache__/_model_construction.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5bd6a808942a0d3f8ef469abdb5df0817620bda9 GIT binary patch literal 34535 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/_internal/__pycache__/_repr.cpython-311.pyc b/env/Lib/site-packages/pydantic/_internal/__pycache__/_repr.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2007d017451a032492fd37dc0af9082630a353b4 GIT binary patch literal 7833 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 F{u@pVJ=g#M literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/_internal/__pycache__/_schema_generation_shared.cpython-311.pyc b/env/Lib/site-packages/pydantic/_internal/__pycache__/_schema_generation_shared.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..53283b7c8256083e92525f2fdbf394c013bb19be GIT binary patch literal 6767 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/_internal/__pycache__/_std_types_schema.cpython-311.pyc b/env/Lib/site-packages/pydantic/_internal/__pycache__/_std_types_schema.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e52cf81d0d499473abf3fe0bc365ed05e9496316 GIT binary patch literal 35061 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/_internal/__pycache__/_utils.cpython-311.pyc b/env/Lib/site-packages/pydantic/_internal/__pycache__/_utils.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..931d4b0bd10554bfa1f8d366790c68f55a041295 GIT binary patch literal 18255 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 Self: + """Build a new `ConfigWrapper` instance for a `BaseModel`. + + The config wrapper built based on (in descending order of priority): + - options from `kwargs` + - options from the `namespace` + - options from the base classes (`bases`) + + Args: + bases: A tuple of base classes. + namespace: The namespace of the class being created. + kwargs: The kwargs passed to the class being created. + + Returns: + A `ConfigWrapper` instance for `BaseModel`. + """ + config_new = ConfigDict() + for base in bases: + config = getattr(base, 'model_config', None) + if config: + config_new.update(config.copy()) + + config_class_from_namespace = namespace.get('Config') + config_dict_from_namespace = namespace.get('model_config') + + raw_annotations = namespace.get('__annotations__', {}) + if raw_annotations.get('model_config') and not config_dict_from_namespace: + raise PydanticUserError( + '`model_config` cannot be used as a model field name. Use `model_config` for model configuration.', + code='model-config-invalid-field-name', + ) + + if config_class_from_namespace and config_dict_from_namespace: + raise PydanticUserError('"Config" and "model_config" cannot be used together', code='config-both') + + config_from_namespace = config_dict_from_namespace or prepare_config(config_class_from_namespace) + + config_new.update(config_from_namespace) + + for k in list(kwargs.keys()): + if k in config_keys: + config_new[k] = kwargs.pop(k) + + return cls(config_new) + + # we don't show `__getattr__` to type checkers so missing attributes cause errors + if not TYPE_CHECKING: # pragma: no branch + + def __getattr__(self, name: str) -> Any: + try: + return self.config_dict[name] + except KeyError: + try: + return config_defaults[name] + except KeyError: + raise AttributeError(f'Config has no attribute {name!r}') from None + + def core_config(self, obj: Any) -> core_schema.CoreConfig: + """Create a pydantic-core config, `obj` is just used to populate `title` if not set in config. + + Pass `obj=None` if you do not want to attempt to infer the `title`. + + We don't use getattr here since we don't want to populate with defaults. + + Args: + obj: An object used to populate `title` if not set in config. + + Returns: + A `CoreConfig` object created from config. + """ + + def dict_not_none(**kwargs: Any) -> Any: + return {k: v for k, v in kwargs.items() if v is not None} + + core_config = core_schema.CoreConfig( + **dict_not_none( + title=self.config_dict.get('title') or (obj and obj.__name__), + extra_fields_behavior=self.config_dict.get('extra'), + allow_inf_nan=self.config_dict.get('allow_inf_nan'), + populate_by_name=self.config_dict.get('populate_by_name'), + str_strip_whitespace=self.config_dict.get('str_strip_whitespace'), + str_to_lower=self.config_dict.get('str_to_lower'), + str_to_upper=self.config_dict.get('str_to_upper'), + strict=self.config_dict.get('strict'), + ser_json_timedelta=self.config_dict.get('ser_json_timedelta'), + ser_json_bytes=self.config_dict.get('ser_json_bytes'), + ser_json_inf_nan=self.config_dict.get('ser_json_inf_nan'), + from_attributes=self.config_dict.get('from_attributes'), + loc_by_alias=self.config_dict.get('loc_by_alias'), + revalidate_instances=self.config_dict.get('revalidate_instances'), + validate_default=self.config_dict.get('validate_default'), + str_max_length=self.config_dict.get('str_max_length'), + str_min_length=self.config_dict.get('str_min_length'), + hide_input_in_errors=self.config_dict.get('hide_input_in_errors'), + coerce_numbers_to_str=self.config_dict.get('coerce_numbers_to_str'), + regex_engine=self.config_dict.get('regex_engine'), + validation_error_cause=self.config_dict.get('validation_error_cause'), + cache_strings=self.config_dict.get('cache_strings'), + ) + ) + return core_config + + def __repr__(self): + c = ', '.join(f'{k}={v!r}' for k, v in self.config_dict.items()) + return f'ConfigWrapper({c})' + + +class ConfigWrapperStack: + """A stack of `ConfigWrapper` instances.""" + + def __init__(self, config_wrapper: ConfigWrapper): + self._config_wrapper_stack: list[ConfigWrapper] = [config_wrapper] + + @property + def tail(self) -> ConfigWrapper: + return self._config_wrapper_stack[-1] + + @contextmanager + def push(self, config_wrapper: ConfigWrapper | ConfigDict | None): + if config_wrapper is None: + yield + return + + if not isinstance(config_wrapper, ConfigWrapper): + config_wrapper = ConfigWrapper(config_wrapper, check=False) + + self._config_wrapper_stack.append(config_wrapper) + try: + yield + finally: + self._config_wrapper_stack.pop() + + +config_defaults = ConfigDict( + title=None, + str_to_lower=False, + str_to_upper=False, + str_strip_whitespace=False, + str_min_length=0, + str_max_length=None, + # let the model / dataclass decide how to handle it + extra=None, + frozen=False, + populate_by_name=False, + use_enum_values=False, + validate_assignment=False, + arbitrary_types_allowed=False, + from_attributes=False, + loc_by_alias=True, + alias_generator=None, + model_title_generator=None, + field_title_generator=None, + ignored_types=(), + allow_inf_nan=True, + json_schema_extra=None, + strict=False, + revalidate_instances='never', + ser_json_timedelta='iso8601', + ser_json_bytes='utf8', + ser_json_inf_nan='null', + validate_default=False, + validate_return=False, + protected_namespaces=('model_',), + hide_input_in_errors=False, + json_encoders=None, + defer_build=False, + experimental_defer_build_mode=('model',), + plugin_settings=None, + schema_generator=None, + json_schema_serialization_defaults_required=False, + json_schema_mode_override=None, + coerce_numbers_to_str=False, + regex_engine='rust-regex', + validation_error_cause=False, + use_attribute_docstrings=False, + cache_strings=True, +) + + +def prepare_config(config: ConfigDict | dict[str, Any] | type[Any] | None) -> ConfigDict: + """Create a `ConfigDict` instance from an existing dict, a class (e.g. old class-based config) or None. + + Args: + config: The input config. + + Returns: + A ConfigDict object created from config. + """ + if config is None: + return ConfigDict() + + if not isinstance(config, dict): + warnings.warn(DEPRECATION_MESSAGE, DeprecationWarning) + config = {k: getattr(config, k) for k in dir(config) if not k.startswith('__')} + + config_dict = cast(ConfigDict, config) + check_deprecated(config_dict) + return config_dict + + +config_keys = set(ConfigDict.__annotations__.keys()) + + +V2_REMOVED_KEYS = { + 'allow_mutation', + 'error_msg_templates', + 'fields', + 'getter_dict', + 'smart_union', + 'underscore_attrs_are_private', + 'json_loads', + 'json_dumps', + 'copy_on_model_validation', + 'post_init_call', +} +V2_RENAMED_KEYS = { + 'allow_population_by_field_name': 'populate_by_name', + 'anystr_lower': 'str_to_lower', + 'anystr_strip_whitespace': 'str_strip_whitespace', + 'anystr_upper': 'str_to_upper', + 'keep_untouched': 'ignored_types', + 'max_anystr_length': 'str_max_length', + 'min_anystr_length': 'str_min_length', + 'orm_mode': 'from_attributes', + 'schema_extra': 'json_schema_extra', + 'validate_all': 'validate_default', +} + + +def check_deprecated(config_dict: ConfigDict) -> None: + """Check for deprecated config keys and warn the user. + + Args: + config_dict: The input config. + """ + deprecated_removed_keys = V2_REMOVED_KEYS & config_dict.keys() + deprecated_renamed_keys = V2_RENAMED_KEYS.keys() & config_dict.keys() + if deprecated_removed_keys or deprecated_renamed_keys: + renamings = {k: V2_RENAMED_KEYS[k] for k in sorted(deprecated_renamed_keys)} + renamed_bullets = [f'* {k!r} has been renamed to {v!r}' for k, v in renamings.items()] + removed_bullets = [f'* {k!r} has been removed' for k in sorted(deprecated_removed_keys)] + message = '\n'.join(['Valid config keys have changed in V2:'] + renamed_bullets + removed_bullets) + warnings.warn(message, UserWarning) diff --git a/env/Lib/site-packages/pydantic/_internal/_core_metadata.py b/env/Lib/site-packages/pydantic/_internal/_core_metadata.py new file mode 100644 index 0000000..296d49f --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_core_metadata.py @@ -0,0 +1,92 @@ +from __future__ import annotations as _annotations + +import typing +from typing import Any + +import typing_extensions + +if typing.TYPE_CHECKING: + from ._schema_generation_shared import ( + CoreSchemaOrField as CoreSchemaOrField, + ) + from ._schema_generation_shared import ( + GetJsonSchemaFunction, + ) + + +class CoreMetadata(typing_extensions.TypedDict, total=False): + """A `TypedDict` for holding the metadata dict of the schema. + + Attributes: + pydantic_js_functions: List of JSON schema functions. + pydantic_js_prefer_positional_arguments: Whether JSON schema generator will + prefer positional over keyword arguments for an 'arguments' schema. + """ + + pydantic_js_functions: list[GetJsonSchemaFunction] + pydantic_js_annotation_functions: list[GetJsonSchemaFunction] + + # If `pydantic_js_prefer_positional_arguments` is True, the JSON schema generator will + # prefer positional over keyword arguments for an 'arguments' schema. + pydantic_js_prefer_positional_arguments: bool | None + + pydantic_typed_dict_cls: type[Any] | None # TODO: Consider moving this into the pydantic-core TypedDictSchema + + +class CoreMetadataHandler: + """Because the metadata field in pydantic_core is of type `Any`, we can't assume much about its contents. + + This class is used to interact with the metadata field on a CoreSchema object in a consistent + way throughout pydantic. + """ + + __slots__ = ('_schema',) + + def __init__(self, schema: CoreSchemaOrField): + self._schema = schema + + metadata = schema.get('metadata') + if metadata is None: + schema['metadata'] = CoreMetadata() + elif not isinstance(metadata, dict): + raise TypeError(f'CoreSchema metadata should be a dict; got {metadata!r}.') + + @property + def metadata(self) -> CoreMetadata: + """Retrieves the metadata dict from the schema, initializing it to a dict if it is None + and raises an error if it is not a dict. + """ + metadata = self._schema.get('metadata') + if metadata is None: + self._schema['metadata'] = metadata = CoreMetadata() + if not isinstance(metadata, dict): + raise TypeError(f'CoreSchema metadata should be a dict; got {metadata!r}.') + return metadata + + +def build_metadata_dict( + *, # force keyword arguments to make it easier to modify this signature in a backwards-compatible way + js_functions: list[GetJsonSchemaFunction] | None = None, + js_annotation_functions: list[GetJsonSchemaFunction] | None = None, + js_prefer_positional_arguments: bool | None = None, + typed_dict_cls: type[Any] | None = None, + initial_metadata: Any | None = None, +) -> Any: + """Builds a dict to use as the metadata field of a CoreSchema object in a manner that is consistent + with the CoreMetadataHandler class. + """ + if initial_metadata is not None and not isinstance(initial_metadata, dict): + raise TypeError(f'CoreSchema metadata should be a dict; got {initial_metadata!r}.') + + metadata = CoreMetadata( + pydantic_js_functions=js_functions or [], + pydantic_js_annotation_functions=js_annotation_functions or [], + pydantic_js_prefer_positional_arguments=js_prefer_positional_arguments, + pydantic_typed_dict_cls=typed_dict_cls, + ) + metadata = {k: v for k, v in metadata.items() if v is not None} + + if initial_metadata is not None: + metadata = {**initial_metadata, **metadata} + + return metadata diff --git a/env/Lib/site-packages/pydantic/_internal/_core_utils.py b/env/Lib/site-packages/pydantic/_internal/_core_utils.py new file mode 100644 index 0000000..baec706 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_core_utils.py @@ -0,0 +1,568 @@ +from __future__ import annotations + +import os +from collections import defaultdict +from typing import ( + Any, + Callable, + Hashable, + TypeVar, + Union, +) + +from pydantic_core import CoreSchema, core_schema +from pydantic_core import validate_core_schema as _validate_core_schema +from typing_extensions import TypeAliasType, TypeGuard, get_args, get_origin + +from . import _repr +from ._typing_extra import is_generic_alias + +AnyFunctionSchema = Union[ + core_schema.AfterValidatorFunctionSchema, + core_schema.BeforeValidatorFunctionSchema, + core_schema.WrapValidatorFunctionSchema, + core_schema.PlainValidatorFunctionSchema, +] + + +FunctionSchemaWithInnerSchema = Union[ + core_schema.AfterValidatorFunctionSchema, + core_schema.BeforeValidatorFunctionSchema, + core_schema.WrapValidatorFunctionSchema, +] + +CoreSchemaField = Union[ + core_schema.ModelField, core_schema.DataclassField, core_schema.TypedDictField, core_schema.ComputedField +] +CoreSchemaOrField = Union[core_schema.CoreSchema, CoreSchemaField] + +_CORE_SCHEMA_FIELD_TYPES = {'typed-dict-field', 'dataclass-field', 'model-field', 'computed-field'} +_FUNCTION_WITH_INNER_SCHEMA_TYPES = {'function-before', 'function-after', 'function-wrap'} +_LIST_LIKE_SCHEMA_WITH_ITEMS_TYPES = {'list', 'set', 'frozenset'} + +TAGGED_UNION_TAG_KEY = 'pydantic.internal.tagged_union_tag' +""" +Used in a `Tag` schema to specify the tag used for a discriminated union. +""" +HAS_INVALID_SCHEMAS_METADATA_KEY = 'pydantic.internal.invalid' +"""Used to mark a schema that is invalid because it refers to a definition that was not yet defined when the +schema was first encountered. +""" + + +def is_core_schema( + schema: CoreSchemaOrField, +) -> TypeGuard[CoreSchema]: + return schema['type'] not in _CORE_SCHEMA_FIELD_TYPES + + +def is_core_schema_field( + schema: CoreSchemaOrField, +) -> TypeGuard[CoreSchemaField]: + return schema['type'] in _CORE_SCHEMA_FIELD_TYPES + + +def is_function_with_inner_schema( + schema: CoreSchemaOrField, +) -> TypeGuard[FunctionSchemaWithInnerSchema]: + return schema['type'] in _FUNCTION_WITH_INNER_SCHEMA_TYPES + + +def is_list_like_schema_with_items_schema( + schema: CoreSchema, +) -> TypeGuard[core_schema.ListSchema | core_schema.SetSchema | core_schema.FrozenSetSchema]: + return schema['type'] in _LIST_LIKE_SCHEMA_WITH_ITEMS_TYPES + + +def get_type_ref(type_: type[Any], args_override: tuple[type[Any], ...] | None = None) -> str: + """Produces the ref to be used for this type by pydantic_core's core schemas. + + This `args_override` argument was added for the purpose of creating valid recursive references + when creating generic models without needing to create a concrete class. + """ + origin = get_origin(type_) or type_ + + args = get_args(type_) if is_generic_alias(type_) else (args_override or ()) + generic_metadata = getattr(type_, '__pydantic_generic_metadata__', None) + if generic_metadata: + origin = generic_metadata['origin'] or origin + args = generic_metadata['args'] or args + + module_name = getattr(origin, '__module__', '') + if isinstance(origin, TypeAliasType): + type_ref = f'{module_name}.{origin.__name__}:{id(origin)}' + else: + try: + qualname = getattr(origin, '__qualname__', f'') + except Exception: + qualname = getattr(origin, '__qualname__', '') + type_ref = f'{module_name}.{qualname}:{id(origin)}' + + arg_refs: list[str] = [] + for arg in args: + if isinstance(arg, str): + # Handle string literals as a special case; we may be able to remove this special handling if we + # wrap them in a ForwardRef at some point. + arg_ref = f'{arg}:str-{id(arg)}' + else: + arg_ref = f'{_repr.display_as_type(arg)}:{id(arg)}' + arg_refs.append(arg_ref) + if arg_refs: + type_ref = f'{type_ref}[{",".join(arg_refs)}]' + return type_ref + + +def get_ref(s: core_schema.CoreSchema) -> None | str: + """Get the ref from the schema if it has one. + This exists just for type checking to work correctly. + """ + return s.get('ref', None) + + +def collect_definitions(schema: core_schema.CoreSchema) -> dict[str, core_schema.CoreSchema]: + defs: dict[str, CoreSchema] = {} + + def _record_valid_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema: + ref = get_ref(s) + if ref: + defs[ref] = s + return recurse(s, _record_valid_refs) + + walk_core_schema(schema, _record_valid_refs) + + return defs + + +def define_expected_missing_refs( + schema: core_schema.CoreSchema, allowed_missing_refs: set[str] +) -> core_schema.CoreSchema | None: + if not allowed_missing_refs: + # in this case, there are no missing refs to potentially substitute, so there's no need to walk the schema + # this is a common case (will be hit for all non-generic models), so it's worth optimizing for + return None + + refs = collect_definitions(schema).keys() + + expected_missing_refs = allowed_missing_refs.difference(refs) + if expected_missing_refs: + definitions: list[core_schema.CoreSchema] = [ + # TODO: Replace this with a (new) CoreSchema that, if present at any level, makes validation fail + # Issue: https://github.com/pydantic/pydantic-core/issues/619 + core_schema.none_schema(ref=ref, metadata={HAS_INVALID_SCHEMAS_METADATA_KEY: True}) + for ref in expected_missing_refs + ] + return core_schema.definitions_schema(schema, definitions) + return None + + +def collect_invalid_schemas(schema: core_schema.CoreSchema) -> bool: + invalid = False + + def _is_schema_valid(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema: + nonlocal invalid + if 'metadata' in s: + metadata = s['metadata'] + if HAS_INVALID_SCHEMAS_METADATA_KEY in metadata: + invalid = metadata[HAS_INVALID_SCHEMAS_METADATA_KEY] + return s + return recurse(s, _is_schema_valid) + + walk_core_schema(schema, _is_schema_valid) + return invalid + + +T = TypeVar('T') + + +Recurse = Callable[[core_schema.CoreSchema, 'Walk'], core_schema.CoreSchema] +Walk = Callable[[core_schema.CoreSchema, Recurse], core_schema.CoreSchema] + +# TODO: Should we move _WalkCoreSchema into pydantic_core proper? +# Issue: https://github.com/pydantic/pydantic-core/issues/615 + + +class _WalkCoreSchema: + def __init__(self): + self._schema_type_to_method = self._build_schema_type_to_method() + + def _build_schema_type_to_method(self) -> dict[core_schema.CoreSchemaType, Recurse]: + mapping: dict[core_schema.CoreSchemaType, Recurse] = {} + key: core_schema.CoreSchemaType + for key in get_args(core_schema.CoreSchemaType): + method_name = f"handle_{key.replace('-', '_')}_schema" + mapping[key] = getattr(self, method_name, self._handle_other_schemas) + return mapping + + def walk(self, schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema: + return f(schema, self._walk) + + def _walk(self, schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema: + schema = self._schema_type_to_method[schema['type']](schema.copy(), f) + ser_schema: core_schema.SerSchema | None = schema.get('serialization') # type: ignore + if ser_schema: + schema['serialization'] = self._handle_ser_schemas(ser_schema, f) + return schema + + def _handle_other_schemas(self, schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema: + sub_schema = schema.get('schema', None) + if sub_schema is not None: + schema['schema'] = self.walk(sub_schema, f) # type: ignore + return schema + + def _handle_ser_schemas(self, ser_schema: core_schema.SerSchema, f: Walk) -> core_schema.SerSchema: + schema: core_schema.CoreSchema | None = ser_schema.get('schema', None) + if schema is not None: + ser_schema['schema'] = self.walk(schema, f) # type: ignore + return_schema: core_schema.CoreSchema | None = ser_schema.get('return_schema', None) + if return_schema is not None: + ser_schema['return_schema'] = self.walk(return_schema, f) # type: ignore + return ser_schema + + def handle_definitions_schema(self, schema: core_schema.DefinitionsSchema, f: Walk) -> core_schema.CoreSchema: + new_definitions: list[core_schema.CoreSchema] = [] + for definition in schema['definitions']: + if 'schema_ref' in definition and 'ref' in definition: + # This indicates a purposely indirect reference + # We want to keep such references around for implications related to JSON schema, etc.: + new_definitions.append(definition) + # However, we still need to walk the referenced definition: + self.walk(definition, f) + continue + + updated_definition = self.walk(definition, f) + if 'ref' in updated_definition: + # If the updated definition schema doesn't have a 'ref', it shouldn't go in the definitions + # This is most likely to happen due to replacing something with a definition reference, in + # which case it should certainly not go in the definitions list + new_definitions.append(updated_definition) + new_inner_schema = self.walk(schema['schema'], f) + + if not new_definitions and len(schema) == 3: + # This means we'd be returning a "trivial" definitions schema that just wrapped the inner schema + return new_inner_schema + + new_schema = schema.copy() + new_schema['schema'] = new_inner_schema + new_schema['definitions'] = new_definitions + return new_schema + + def handle_list_schema(self, schema: core_schema.ListSchema, f: Walk) -> core_schema.CoreSchema: + items_schema = schema.get('items_schema') + if items_schema is not None: + schema['items_schema'] = self.walk(items_schema, f) + return schema + + def handle_set_schema(self, schema: core_schema.SetSchema, f: Walk) -> core_schema.CoreSchema: + items_schema = schema.get('items_schema') + if items_schema is not None: + schema['items_schema'] = self.walk(items_schema, f) + return schema + + def handle_frozenset_schema(self, schema: core_schema.FrozenSetSchema, f: Walk) -> core_schema.CoreSchema: + items_schema = schema.get('items_schema') + if items_schema is not None: + schema['items_schema'] = self.walk(items_schema, f) + return schema + + def handle_generator_schema(self, schema: core_schema.GeneratorSchema, f: Walk) -> core_schema.CoreSchema: + items_schema = schema.get('items_schema') + if items_schema is not None: + schema['items_schema'] = self.walk(items_schema, f) + return schema + + def handle_tuple_schema(self, schema: core_schema.TupleSchema, f: Walk) -> core_schema.CoreSchema: + schema['items_schema'] = [self.walk(v, f) for v in schema['items_schema']] + return schema + + def handle_dict_schema(self, schema: core_schema.DictSchema, f: Walk) -> core_schema.CoreSchema: + keys_schema = schema.get('keys_schema') + if keys_schema is not None: + schema['keys_schema'] = self.walk(keys_schema, f) + values_schema = schema.get('values_schema') + if values_schema: + schema['values_schema'] = self.walk(values_schema, f) + return schema + + def handle_function_schema(self, schema: AnyFunctionSchema, f: Walk) -> core_schema.CoreSchema: + if not is_function_with_inner_schema(schema): + return schema + schema['schema'] = self.walk(schema['schema'], f) + return schema + + def handle_union_schema(self, schema: core_schema.UnionSchema, f: Walk) -> core_schema.CoreSchema: + new_choices: list[CoreSchema | tuple[CoreSchema, str]] = [] + for v in schema['choices']: + if isinstance(v, tuple): + new_choices.append((self.walk(v[0], f), v[1])) + else: + new_choices.append(self.walk(v, f)) + schema['choices'] = new_choices + return schema + + def handle_tagged_union_schema(self, schema: core_schema.TaggedUnionSchema, f: Walk) -> core_schema.CoreSchema: + new_choices: dict[Hashable, core_schema.CoreSchema] = {} + for k, v in schema['choices'].items(): + new_choices[k] = v if isinstance(v, (str, int)) else self.walk(v, f) + schema['choices'] = new_choices + return schema + + def handle_chain_schema(self, schema: core_schema.ChainSchema, f: Walk) -> core_schema.CoreSchema: + schema['steps'] = [self.walk(v, f) for v in schema['steps']] + return schema + + def handle_lax_or_strict_schema(self, schema: core_schema.LaxOrStrictSchema, f: Walk) -> core_schema.CoreSchema: + schema['lax_schema'] = self.walk(schema['lax_schema'], f) + schema['strict_schema'] = self.walk(schema['strict_schema'], f) + return schema + + def handle_json_or_python_schema(self, schema: core_schema.JsonOrPythonSchema, f: Walk) -> core_schema.CoreSchema: + schema['json_schema'] = self.walk(schema['json_schema'], f) + schema['python_schema'] = self.walk(schema['python_schema'], f) + return schema + + def handle_model_fields_schema(self, schema: core_schema.ModelFieldsSchema, f: Walk) -> core_schema.CoreSchema: + extras_schema = schema.get('extras_schema') + if extras_schema is not None: + schema['extras_schema'] = self.walk(extras_schema, f) + replaced_fields: dict[str, core_schema.ModelField] = {} + replaced_computed_fields: list[core_schema.ComputedField] = [] + for computed_field in schema.get('computed_fields', ()): + replaced_field = computed_field.copy() + replaced_field['return_schema'] = self.walk(computed_field['return_schema'], f) + replaced_computed_fields.append(replaced_field) + if replaced_computed_fields: + schema['computed_fields'] = replaced_computed_fields + for k, v in schema['fields'].items(): + replaced_field = v.copy() + replaced_field['schema'] = self.walk(v['schema'], f) + replaced_fields[k] = replaced_field + schema['fields'] = replaced_fields + return schema + + def handle_typed_dict_schema(self, schema: core_schema.TypedDictSchema, f: Walk) -> core_schema.CoreSchema: + extras_schema = schema.get('extras_schema') + if extras_schema is not None: + schema['extras_schema'] = self.walk(extras_schema, f) + replaced_computed_fields: list[core_schema.ComputedField] = [] + for computed_field in schema.get('computed_fields', ()): + replaced_field = computed_field.copy() + replaced_field['return_schema'] = self.walk(computed_field['return_schema'], f) + replaced_computed_fields.append(replaced_field) + if replaced_computed_fields: + schema['computed_fields'] = replaced_computed_fields + replaced_fields: dict[str, core_schema.TypedDictField] = {} + for k, v in schema['fields'].items(): + replaced_field = v.copy() + replaced_field['schema'] = self.walk(v['schema'], f) + replaced_fields[k] = replaced_field + schema['fields'] = replaced_fields + return schema + + def handle_dataclass_args_schema(self, schema: core_schema.DataclassArgsSchema, f: Walk) -> core_schema.CoreSchema: + replaced_fields: list[core_schema.DataclassField] = [] + replaced_computed_fields: list[core_schema.ComputedField] = [] + for computed_field in schema.get('computed_fields', ()): + replaced_field = computed_field.copy() + replaced_field['return_schema'] = self.walk(computed_field['return_schema'], f) + replaced_computed_fields.append(replaced_field) + if replaced_computed_fields: + schema['computed_fields'] = replaced_computed_fields + for field in schema['fields']: + replaced_field = field.copy() + replaced_field['schema'] = self.walk(field['schema'], f) + replaced_fields.append(replaced_field) + schema['fields'] = replaced_fields + return schema + + def handle_arguments_schema(self, schema: core_schema.ArgumentsSchema, f: Walk) -> core_schema.CoreSchema: + replaced_arguments_schema: list[core_schema.ArgumentsParameter] = [] + for param in schema['arguments_schema']: + replaced_param = param.copy() + replaced_param['schema'] = self.walk(param['schema'], f) + replaced_arguments_schema.append(replaced_param) + schema['arguments_schema'] = replaced_arguments_schema + if 'var_args_schema' in schema: + schema['var_args_schema'] = self.walk(schema['var_args_schema'], f) + if 'var_kwargs_schema' in schema: + schema['var_kwargs_schema'] = self.walk(schema['var_kwargs_schema'], f) + return schema + + def handle_call_schema(self, schema: core_schema.CallSchema, f: Walk) -> core_schema.CoreSchema: + schema['arguments_schema'] = self.walk(schema['arguments_schema'], f) + if 'return_schema' in schema: + schema['return_schema'] = self.walk(schema['return_schema'], f) + return schema + + +_dispatch = _WalkCoreSchema().walk + + +def walk_core_schema(schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema: + """Recursively traverse a CoreSchema. + + Args: + schema (core_schema.CoreSchema): The CoreSchema to process, it will not be modified. + f (Walk): A function to apply. This function takes two arguments: + 1. The current CoreSchema that is being processed + (not the same one you passed into this function, one level down). + 2. The "next" `f` to call. This lets you for example use `f=functools.partial(some_method, some_context)` + to pass data down the recursive calls without using globals or other mutable state. + + Returns: + core_schema.CoreSchema: A processed CoreSchema. + """ + return f(schema.copy(), _dispatch) + + +def simplify_schema_references(schema: core_schema.CoreSchema) -> core_schema.CoreSchema: # noqa: C901 + definitions: dict[str, core_schema.CoreSchema] = {} + ref_counts: dict[str, int] = defaultdict(int) + involved_in_recursion: dict[str, bool] = {} + current_recursion_ref_count: dict[str, int] = defaultdict(int) + + def collect_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema: + if s['type'] == 'definitions': + for definition in s['definitions']: + ref = get_ref(definition) + assert ref is not None + if ref not in definitions: + definitions[ref] = definition + recurse(definition, collect_refs) + return recurse(s['schema'], collect_refs) + else: + ref = get_ref(s) + if ref is not None: + new = recurse(s, collect_refs) + new_ref = get_ref(new) + if new_ref: + definitions[new_ref] = new + return core_schema.definition_reference_schema(schema_ref=ref) + else: + return recurse(s, collect_refs) + + schema = walk_core_schema(schema, collect_refs) + + def count_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema: + if s['type'] != 'definition-ref': + return recurse(s, count_refs) + ref = s['schema_ref'] + ref_counts[ref] += 1 + + if ref_counts[ref] >= 2: + # If this model is involved in a recursion this should be detected + # on its second encounter, we can safely stop the walk here. + if current_recursion_ref_count[ref] != 0: + involved_in_recursion[ref] = True + return s + + current_recursion_ref_count[ref] += 1 + recurse(definitions[ref], count_refs) + current_recursion_ref_count[ref] -= 1 + return s + + schema = walk_core_schema(schema, count_refs) + + assert all(c == 0 for c in current_recursion_ref_count.values()), 'this is a bug! please report it' + + def can_be_inlined(s: core_schema.DefinitionReferenceSchema, ref: str) -> bool: + if ref_counts[ref] > 1: + return False + if involved_in_recursion.get(ref, False): + return False + if 'serialization' in s: + return False + if 'metadata' in s: + metadata = s['metadata'] + for k in ( + 'pydantic_js_functions', + 'pydantic_js_annotation_functions', + 'pydantic.internal.union_discriminator', + ): + if k in metadata: + # we need to keep this as a ref + return False + return True + + def inline_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema: + if s['type'] == 'definition-ref': + ref = s['schema_ref'] + # Check if the reference is only used once, not involved in recursion and does not have + # any extra keys (like 'serialization') + if can_be_inlined(s, ref): + # Inline the reference by replacing the reference with the actual schema + new = definitions.pop(ref) + ref_counts[ref] -= 1 # because we just replaced it! + # put all other keys that were on the def-ref schema into the inlined version + # in particular this is needed for `serialization` + if 'serialization' in s: + new['serialization'] = s['serialization'] + s = recurse(new, inline_refs) + return s + else: + return recurse(s, inline_refs) + else: + return recurse(s, inline_refs) + + schema = walk_core_schema(schema, inline_refs) + + def_values = [v for v in definitions.values() if ref_counts[v['ref']] > 0] # type: ignore + + if def_values: + schema = core_schema.definitions_schema(schema=schema, definitions=def_values) + return schema + + +def _strip_metadata(schema: CoreSchema) -> CoreSchema: + def strip_metadata(s: CoreSchema, recurse: Recurse) -> CoreSchema: + s = s.copy() + s.pop('metadata', None) + if s['type'] == 'model-fields': + s = s.copy() + s['fields'] = {k: v.copy() for k, v in s['fields'].items()} + for field_name, field_schema in s['fields'].items(): + field_schema.pop('metadata', None) + s['fields'][field_name] = field_schema + computed_fields = s.get('computed_fields', None) + if computed_fields: + s['computed_fields'] = [cf.copy() for cf in computed_fields] + for cf in computed_fields: + cf.pop('metadata', None) + else: + s.pop('computed_fields', None) + elif s['type'] == 'model': + # remove some defaults + if s.get('custom_init', True) is False: + s.pop('custom_init') + if s.get('root_model', True) is False: + s.pop('root_model') + if {'title'}.issuperset(s.get('config', {}).keys()): + s.pop('config', None) + + return recurse(s, strip_metadata) + + return walk_core_schema(schema, strip_metadata) + + +def pretty_print_core_schema( + schema: CoreSchema, + include_metadata: bool = False, +) -> None: + """Pretty print a CoreSchema using rich. + This is intended for debugging purposes. + + Args: + schema: The CoreSchema to print. + include_metadata: Whether to include metadata in the output. Defaults to `False`. + """ + from rich import print # type: ignore # install it manually in your dev env + + if not include_metadata: + schema = _strip_metadata(schema) + + return print(schema) + + +def validate_core_schema(schema: CoreSchema) -> CoreSchema: + if 'PYDANTIC_SKIP_VALIDATING_CORE_SCHEMAS' in os.environ: + return schema + return _validate_core_schema(schema) diff --git a/env/Lib/site-packages/pydantic/_internal/_dataclasses.py b/env/Lib/site-packages/pydantic/_internal/_dataclasses.py new file mode 100644 index 0000000..7327292 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_dataclasses.py @@ -0,0 +1,231 @@ +"""Private logic for creating pydantic dataclasses.""" + +from __future__ import annotations as _annotations + +import dataclasses +import typing +import warnings +from functools import partial, wraps +from typing import Any, Callable, ClassVar + +from pydantic_core import ( + ArgsKwargs, + SchemaSerializer, + SchemaValidator, + core_schema, +) +from typing_extensions import TypeGuard + +from ..errors import PydanticUndefinedAnnotation +from ..fields import FieldInfo +from ..plugin._schema_validator import PluggableSchemaValidator, create_schema_validator +from ..warnings import PydanticDeprecatedSince20 +from . import _config, _decorators, _typing_extra +from ._fields import collect_dataclass_fields +from ._generate_schema import GenerateSchema +from ._generics import get_standard_typevars_map +from ._mock_val_ser import set_dataclass_mocks +from ._schema_generation_shared import CallbackGetCoreSchemaHandler +from ._signature import generate_pydantic_signature + +if typing.TYPE_CHECKING: + from ..config import ConfigDict + + class StandardDataclass(typing.Protocol): + __dataclass_fields__: ClassVar[dict[str, Any]] + __dataclass_params__: ClassVar[Any] # in reality `dataclasses._DataclassParams` + __post_init__: ClassVar[Callable[..., None]] + + def __init__(self, *args: object, **kwargs: object) -> None: + pass + + class PydanticDataclass(StandardDataclass, typing.Protocol): + """A protocol containing attributes only available once a class has been decorated as a Pydantic dataclass. + + Attributes: + __pydantic_config__: Pydantic-specific configuration settings for the dataclass. + __pydantic_complete__: Whether dataclass building is completed, or if there are still undefined fields. + __pydantic_core_schema__: The pydantic-core schema used to build the SchemaValidator and SchemaSerializer. + __pydantic_decorators__: Metadata containing the decorators defined on the dataclass. + __pydantic_fields__: Metadata about the fields defined on the dataclass. + __pydantic_serializer__: The pydantic-core SchemaSerializer used to dump instances of the dataclass. + __pydantic_validator__: The pydantic-core SchemaValidator used to validate instances of the dataclass. + """ + + __pydantic_config__: ClassVar[ConfigDict] + __pydantic_complete__: ClassVar[bool] + __pydantic_core_schema__: ClassVar[core_schema.CoreSchema] + __pydantic_decorators__: ClassVar[_decorators.DecoratorInfos] + __pydantic_fields__: ClassVar[dict[str, FieldInfo]] + __pydantic_serializer__: ClassVar[SchemaSerializer] + __pydantic_validator__: ClassVar[SchemaValidator | PluggableSchemaValidator] + +else: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + + +def set_dataclass_fields( + cls: type[StandardDataclass], + types_namespace: dict[str, Any] | None = None, + config_wrapper: _config.ConfigWrapper | None = None, +) -> None: + """Collect and set `cls.__pydantic_fields__`. + + Args: + cls: The class. + types_namespace: The types namespace, defaults to `None`. + config_wrapper: The config wrapper instance, defaults to `None`. + """ + typevars_map = get_standard_typevars_map(cls) + fields = collect_dataclass_fields(cls, types_namespace, typevars_map=typevars_map, config_wrapper=config_wrapper) + + cls.__pydantic_fields__ = fields # type: ignore + + +def complete_dataclass( + cls: type[Any], + config_wrapper: _config.ConfigWrapper, + *, + raise_errors: bool = True, + types_namespace: dict[str, Any] | None, +) -> bool: + """Finish building a pydantic dataclass. + + This logic is called on a class which has already been wrapped in `dataclasses.dataclass()`. + + This is somewhat analogous to `pydantic._internal._model_construction.complete_model_class`. + + Args: + cls: The class. + config_wrapper: The config wrapper instance. + raise_errors: Whether to raise errors, defaults to `True`. + types_namespace: The types namespace. + + Returns: + `True` if building a pydantic dataclass is successfully completed, `False` otherwise. + + Raises: + PydanticUndefinedAnnotation: If `raise_error` is `True` and there is an undefined annotations. + """ + if hasattr(cls, '__post_init_post_parse__'): + warnings.warn( + 'Support for `__post_init_post_parse__` has been dropped, the method will not be called', DeprecationWarning + ) + + if types_namespace is None: + types_namespace = _typing_extra.get_cls_types_namespace(cls) + + set_dataclass_fields(cls, types_namespace, config_wrapper=config_wrapper) + + typevars_map = get_standard_typevars_map(cls) + gen_schema = GenerateSchema( + config_wrapper, + types_namespace, + typevars_map, + ) + + # This needs to be called before we change the __init__ + sig = generate_pydantic_signature( + init=cls.__init__, + fields=cls.__pydantic_fields__, # type: ignore + config_wrapper=config_wrapper, + is_dataclass=True, + ) + + # dataclass.__init__ must be defined here so its `__qualname__` can be changed since functions can't be copied. + def __init__(__dataclass_self__: PydanticDataclass, *args: Any, **kwargs: Any) -> None: + __tracebackhide__ = True + s = __dataclass_self__ + s.__pydantic_validator__.validate_python(ArgsKwargs(args, kwargs), self_instance=s) + + __init__.__qualname__ = f'{cls.__qualname__}.__init__' + + cls.__init__ = __init__ # type: ignore + cls.__pydantic_config__ = config_wrapper.config_dict # type: ignore + cls.__signature__ = sig # type: ignore + get_core_schema = getattr(cls, '__get_pydantic_core_schema__', None) + try: + if get_core_schema: + schema = get_core_schema( + cls, + CallbackGetCoreSchemaHandler( + partial(gen_schema.generate_schema, from_dunder_get_core_schema=False), + gen_schema, + ref_mode='unpack', + ), + ) + else: + schema = gen_schema.generate_schema(cls, from_dunder_get_core_schema=False) + except PydanticUndefinedAnnotation as e: + if raise_errors: + raise + set_dataclass_mocks(cls, cls.__name__, f'`{e.name}`') + return False + + core_config = config_wrapper.core_config(cls) + + try: + schema = gen_schema.clean_schema(schema) + except gen_schema.CollectedInvalid: + set_dataclass_mocks(cls, cls.__name__, 'all referenced types') + return False + + # We are about to set all the remaining required properties expected for this cast; + # __pydantic_decorators__ and __pydantic_fields__ should already be set + cls = typing.cast('type[PydanticDataclass]', cls) + # debug(schema) + + cls.__pydantic_core_schema__ = schema + cls.__pydantic_validator__ = validator = create_schema_validator( + schema, cls, cls.__module__, cls.__qualname__, 'dataclass', core_config, config_wrapper.plugin_settings + ) + cls.__pydantic_serializer__ = SchemaSerializer(schema, core_config) + + if config_wrapper.validate_assignment: + + @wraps(cls.__setattr__) + def validated_setattr(instance: Any, field: str, value: str, /) -> None: + validator.validate_assignment(instance, field, value) + + cls.__setattr__ = validated_setattr.__get__(None, cls) # type: ignore + + return True + + +def is_builtin_dataclass(_cls: type[Any]) -> TypeGuard[type[StandardDataclass]]: + """Returns True if a class is a stdlib dataclass and *not* a pydantic dataclass. + + We check that + - `_cls` is a dataclass + - `_cls` does not inherit from a processed pydantic dataclass (and thus have a `__pydantic_validator__`) + - `_cls` does not have any annotations that are not dataclass fields + e.g. + ```py + import dataclasses + + import pydantic.dataclasses + + @dataclasses.dataclass + class A: + x: int + + @pydantic.dataclasses.dataclass + class B(A): + y: int + ``` + In this case, when we first check `B`, we make an extra check and look at the annotations ('y'), + which won't be a superset of all the dataclass fields (only the stdlib fields i.e. 'x') + + Args: + cls: The class. + + Returns: + `True` if the class is a stdlib dataclass, `False` otherwise. + """ + return ( + dataclasses.is_dataclass(_cls) + and not hasattr(_cls, '__pydantic_validator__') + and set(_cls.__dataclass_fields__).issuperset(set(getattr(_cls, '__annotations__', {}))) + ) diff --git a/env/Lib/site-packages/pydantic/_internal/_decorators.py b/env/Lib/site-packages/pydantic/_internal/_decorators.py new file mode 100644 index 0000000..66db218 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_decorators.py @@ -0,0 +1,817 @@ +"""Logic related to validators applied to models etc. via the `@field_validator` and `@model_validator` decorators.""" + +from __future__ import annotations as _annotations + +from collections import deque +from dataclasses import dataclass, field +from functools import cached_property, partial, partialmethod +from inspect import Parameter, Signature, isdatadescriptor, ismethoddescriptor, signature +from itertools import islice +from typing import TYPE_CHECKING, Any, Callable, ClassVar, Generic, Iterable, TypeVar, Union + +from pydantic_core import PydanticUndefined, core_schema +from typing_extensions import Literal, TypeAlias, is_typeddict + +from ..errors import PydanticUserError +from ._core_utils import get_type_ref +from ._internal_dataclass import slots_true +from ._typing_extra import get_function_type_hints + +if TYPE_CHECKING: + from ..fields import ComputedFieldInfo + from ..functional_validators import FieldValidatorModes + + +@dataclass(**slots_true) +class ValidatorDecoratorInfo: + """A container for data from `@validator` so that we can access it + while building the pydantic-core schema. + + Attributes: + decorator_repr: A class variable representing the decorator string, '@validator'. + fields: A tuple of field names the validator should be called on. + mode: The proposed validator mode. + each_item: For complex objects (sets, lists etc.) whether to validate individual + elements rather than the whole object. + always: Whether this method and other validators should be called even if the value is missing. + check_fields: Whether to check that the fields actually exist on the model. + """ + + decorator_repr: ClassVar[str] = '@validator' + + fields: tuple[str, ...] + mode: Literal['before', 'after'] + each_item: bool + always: bool + check_fields: bool | None + + +@dataclass(**slots_true) +class FieldValidatorDecoratorInfo: + """A container for data from `@field_validator` so that we can access it + while building the pydantic-core schema. + + Attributes: + decorator_repr: A class variable representing the decorator string, '@field_validator'. + fields: A tuple of field names the validator should be called on. + mode: The proposed validator mode. + check_fields: Whether to check that the fields actually exist on the model. + """ + + decorator_repr: ClassVar[str] = '@field_validator' + + fields: tuple[str, ...] + mode: FieldValidatorModes + check_fields: bool | None + + +@dataclass(**slots_true) +class RootValidatorDecoratorInfo: + """A container for data from `@root_validator` so that we can access it + while building the pydantic-core schema. + + Attributes: + decorator_repr: A class variable representing the decorator string, '@root_validator'. + mode: The proposed validator mode. + """ + + decorator_repr: ClassVar[str] = '@root_validator' + mode: Literal['before', 'after'] + + +@dataclass(**slots_true) +class FieldSerializerDecoratorInfo: + """A container for data from `@field_serializer` so that we can access it + while building the pydantic-core schema. + + Attributes: + decorator_repr: A class variable representing the decorator string, '@field_serializer'. + fields: A tuple of field names the serializer should be called on. + mode: The proposed serializer mode. + return_type: The type of the serializer's return value. + when_used: The serialization condition. Accepts a string with values `'always'`, `'unless-none'`, `'json'`, + and `'json-unless-none'`. + check_fields: Whether to check that the fields actually exist on the model. + """ + + decorator_repr: ClassVar[str] = '@field_serializer' + fields: tuple[str, ...] + mode: Literal['plain', 'wrap'] + return_type: Any + when_used: core_schema.WhenUsed + check_fields: bool | None + + +@dataclass(**slots_true) +class ModelSerializerDecoratorInfo: + """A container for data from `@model_serializer` so that we can access it + while building the pydantic-core schema. + + Attributes: + decorator_repr: A class variable representing the decorator string, '@model_serializer'. + mode: The proposed serializer mode. + return_type: The type of the serializer's return value. + when_used: The serialization condition. Accepts a string with values `'always'`, `'unless-none'`, `'json'`, + and `'json-unless-none'`. + """ + + decorator_repr: ClassVar[str] = '@model_serializer' + mode: Literal['plain', 'wrap'] + return_type: Any + when_used: core_schema.WhenUsed + + +@dataclass(**slots_true) +class ModelValidatorDecoratorInfo: + """A container for data from `@model_validator` so that we can access it + while building the pydantic-core schema. + + Attributes: + decorator_repr: A class variable representing the decorator string, '@model_serializer'. + mode: The proposed serializer mode. + """ + + decorator_repr: ClassVar[str] = '@model_validator' + mode: Literal['wrap', 'before', 'after'] + + +DecoratorInfo: TypeAlias = """Union[ + ValidatorDecoratorInfo, + FieldValidatorDecoratorInfo, + RootValidatorDecoratorInfo, + FieldSerializerDecoratorInfo, + ModelSerializerDecoratorInfo, + ModelValidatorDecoratorInfo, + ComputedFieldInfo, +]""" + +ReturnType = TypeVar('ReturnType') +DecoratedType: TypeAlias = ( + 'Union[classmethod[Any, Any, ReturnType], staticmethod[Any, ReturnType], Callable[..., ReturnType], property]' +) + + +@dataclass # can't use slots here since we set attributes on `__post_init__` +class PydanticDescriptorProxy(Generic[ReturnType]): + """Wrap a classmethod, staticmethod, property or unbound function + and act as a descriptor that allows us to detect decorated items + from the class' attributes. + + This class' __get__ returns the wrapped item's __get__ result, + which makes it transparent for classmethods and staticmethods. + + Attributes: + wrapped: The decorator that has to be wrapped. + decorator_info: The decorator info. + shim: A wrapper function to wrap V1 style function. + """ + + wrapped: DecoratedType[ReturnType] + decorator_info: DecoratorInfo + shim: Callable[[Callable[..., Any]], Callable[..., Any]] | None = None + + def __post_init__(self): + for attr in 'setter', 'deleter': + if hasattr(self.wrapped, attr): + f = partial(self._call_wrapped_attr, name=attr) + setattr(self, attr, f) + + def _call_wrapped_attr(self, func: Callable[[Any], None], *, name: str) -> PydanticDescriptorProxy[ReturnType]: + self.wrapped = getattr(self.wrapped, name)(func) + return self + + def __get__(self, obj: object | None, obj_type: type[object] | None = None) -> PydanticDescriptorProxy[ReturnType]: + try: + return self.wrapped.__get__(obj, obj_type) + except AttributeError: + # not a descriptor, e.g. a partial object + return self.wrapped # type: ignore[return-value] + + def __set_name__(self, instance: Any, name: str) -> None: + if hasattr(self.wrapped, '__set_name__'): + self.wrapped.__set_name__(instance, name) # pyright: ignore[reportFunctionMemberAccess] + + def __getattr__(self, __name: str) -> Any: + """Forward checks for __isabstractmethod__ and such.""" + return getattr(self.wrapped, __name) + + +DecoratorInfoType = TypeVar('DecoratorInfoType', bound=DecoratorInfo) + + +@dataclass(**slots_true) +class Decorator(Generic[DecoratorInfoType]): + """A generic container class to join together the decorator metadata + (metadata from decorator itself, which we have when the + decorator is called but not when we are building the core-schema) + and the bound function (which we have after the class itself is created). + + Attributes: + cls_ref: The class ref. + cls_var_name: The decorated function name. + func: The decorated function. + shim: A wrapper function to wrap V1 style function. + info: The decorator info. + """ + + cls_ref: str + cls_var_name: str + func: Callable[..., Any] + shim: Callable[[Any], Any] | None + info: DecoratorInfoType + + @staticmethod + def build( + cls_: Any, + *, + cls_var_name: str, + shim: Callable[[Any], Any] | None, + info: DecoratorInfoType, + ) -> Decorator[DecoratorInfoType]: + """Build a new decorator. + + Args: + cls_: The class. + cls_var_name: The decorated function name. + shim: A wrapper function to wrap V1 style function. + info: The decorator info. + + Returns: + The new decorator instance. + """ + func = get_attribute_from_bases(cls_, cls_var_name) + if shim is not None: + func = shim(func) + func = unwrap_wrapped_function(func, unwrap_partial=False) + if not callable(func): + # This branch will get hit for classmethod properties + attribute = get_attribute_from_base_dicts(cls_, cls_var_name) # prevents the binding call to `__get__` + if isinstance(attribute, PydanticDescriptorProxy): + func = unwrap_wrapped_function(attribute.wrapped) + return Decorator( + cls_ref=get_type_ref(cls_), + cls_var_name=cls_var_name, + func=func, + shim=shim, + info=info, + ) + + def bind_to_cls(self, cls: Any) -> Decorator[DecoratorInfoType]: + """Bind the decorator to a class. + + Args: + cls: the class. + + Returns: + The new decorator instance. + """ + return self.build( + cls, + cls_var_name=self.cls_var_name, + shim=self.shim, + info=self.info, + ) + + +def get_bases(tp: type[Any]) -> tuple[type[Any], ...]: + """Get the base classes of a class or typeddict. + + Args: + tp: The type or class to get the bases. + + Returns: + The base classes. + """ + if is_typeddict(tp): + return tp.__orig_bases__ # type: ignore + try: + return tp.__bases__ + except AttributeError: + return () + + +def mro(tp: type[Any]) -> tuple[type[Any], ...]: + """Calculate the Method Resolution Order of bases using the C3 algorithm. + + See https://www.python.org/download/releases/2.3/mro/ + """ + # try to use the existing mro, for performance mainly + # but also because it helps verify the implementation below + if not is_typeddict(tp): + try: + return tp.__mro__ + except AttributeError: + # GenericAlias and some other cases + pass + + bases = get_bases(tp) + return (tp,) + mro_for_bases(bases) + + +def mro_for_bases(bases: tuple[type[Any], ...]) -> tuple[type[Any], ...]: + def merge_seqs(seqs: list[deque[type[Any]]]) -> Iterable[type[Any]]: + while True: + non_empty = [seq for seq in seqs if seq] + if not non_empty: + # Nothing left to process, we're done. + return + candidate: type[Any] | None = None + for seq in non_empty: # Find merge candidates among seq heads. + candidate = seq[0] + not_head = [s for s in non_empty if candidate in islice(s, 1, None)] + if not_head: + # Reject the candidate. + candidate = None + else: + break + if not candidate: + raise TypeError('Inconsistent hierarchy, no C3 MRO is possible') + yield candidate + for seq in non_empty: + # Remove candidate. + if seq[0] == candidate: + seq.popleft() + + seqs = [deque(mro(base)) for base in bases] + [deque(bases)] + return tuple(merge_seqs(seqs)) + + +_sentinel = object() + + +def get_attribute_from_bases(tp: type[Any] | tuple[type[Any], ...], name: str) -> Any: + """Get the attribute from the next class in the MRO that has it, + aiming to simulate calling the method on the actual class. + + The reason for iterating over the mro instead of just getting + the attribute (which would do that for us) is to support TypedDict, + which lacks a real __mro__, but can have a virtual one constructed + from its bases (as done here). + + Args: + tp: The type or class to search for the attribute. If a tuple, this is treated as a set of base classes. + name: The name of the attribute to retrieve. + + Returns: + Any: The attribute value, if found. + + Raises: + AttributeError: If the attribute is not found in any class in the MRO. + """ + if isinstance(tp, tuple): + for base in mro_for_bases(tp): + attribute = base.__dict__.get(name, _sentinel) + if attribute is not _sentinel: + attribute_get = getattr(attribute, '__get__', None) + if attribute_get is not None: + return attribute_get(None, tp) + return attribute + raise AttributeError(f'{name} not found in {tp}') + else: + try: + return getattr(tp, name) + except AttributeError: + return get_attribute_from_bases(mro(tp), name) + + +def get_attribute_from_base_dicts(tp: type[Any], name: str) -> Any: + """Get an attribute out of the `__dict__` following the MRO. + This prevents the call to `__get__` on the descriptor, and allows + us to get the original function for classmethod properties. + + Args: + tp: The type or class to search for the attribute. + name: The name of the attribute to retrieve. + + Returns: + Any: The attribute value, if found. + + Raises: + KeyError: If the attribute is not found in any class's `__dict__` in the MRO. + """ + for base in reversed(mro(tp)): + if name in base.__dict__: + return base.__dict__[name] + return tp.__dict__[name] # raise the error + + +@dataclass(**slots_true) +class DecoratorInfos: + """Mapping of name in the class namespace to decorator info. + + note that the name in the class namespace is the function or attribute name + not the field name! + """ + + validators: dict[str, Decorator[ValidatorDecoratorInfo]] = field(default_factory=dict) + field_validators: dict[str, Decorator[FieldValidatorDecoratorInfo]] = field(default_factory=dict) + root_validators: dict[str, Decorator[RootValidatorDecoratorInfo]] = field(default_factory=dict) + field_serializers: dict[str, Decorator[FieldSerializerDecoratorInfo]] = field(default_factory=dict) + model_serializers: dict[str, Decorator[ModelSerializerDecoratorInfo]] = field(default_factory=dict) + model_validators: dict[str, Decorator[ModelValidatorDecoratorInfo]] = field(default_factory=dict) + computed_fields: dict[str, Decorator[ComputedFieldInfo]] = field(default_factory=dict) + + @staticmethod + def build(model_dc: type[Any]) -> DecoratorInfos: # noqa: C901 (ignore complexity) + """We want to collect all DecFunc instances that exist as + attributes in the namespace of the class (a BaseModel or dataclass) + that called us + But we want to collect these in the order of the bases + So instead of getting them all from the leaf class (the class that called us), + we traverse the bases from root (the oldest ancestor class) to leaf + and collect all of the instances as we go, taking care to replace + any duplicate ones with the last one we see to mimic how function overriding + works with inheritance. + If we do replace any functions we put the replacement into the position + the replaced function was in; that is, we maintain the order. + """ + # reminder: dicts are ordered and replacement does not alter the order + res = DecoratorInfos() + for base in reversed(mro(model_dc)[1:]): + existing: DecoratorInfos | None = base.__dict__.get('__pydantic_decorators__') + if existing is None: + existing = DecoratorInfos.build(base) + res.validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.validators.items()}) + res.field_validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.field_validators.items()}) + res.root_validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.root_validators.items()}) + res.field_serializers.update({k: v.bind_to_cls(model_dc) for k, v in existing.field_serializers.items()}) + res.model_serializers.update({k: v.bind_to_cls(model_dc) for k, v in existing.model_serializers.items()}) + res.model_validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.model_validators.items()}) + res.computed_fields.update({k: v.bind_to_cls(model_dc) for k, v in existing.computed_fields.items()}) + + to_replace: list[tuple[str, Any]] = [] + + for var_name, var_value in vars(model_dc).items(): + if isinstance(var_value, PydanticDescriptorProxy): + info = var_value.decorator_info + if isinstance(info, ValidatorDecoratorInfo): + res.validators[var_name] = Decorator.build( + model_dc, cls_var_name=var_name, shim=var_value.shim, info=info + ) + elif isinstance(info, FieldValidatorDecoratorInfo): + res.field_validators[var_name] = Decorator.build( + model_dc, cls_var_name=var_name, shim=var_value.shim, info=info + ) + elif isinstance(info, RootValidatorDecoratorInfo): + res.root_validators[var_name] = Decorator.build( + model_dc, cls_var_name=var_name, shim=var_value.shim, info=info + ) + elif isinstance(info, FieldSerializerDecoratorInfo): + # check whether a serializer function is already registered for fields + for field_serializer_decorator in res.field_serializers.values(): + # check that each field has at most one serializer function. + # serializer functions for the same field in subclasses are allowed, + # and are treated as overrides + if field_serializer_decorator.cls_var_name == var_name: + continue + for f in info.fields: + if f in field_serializer_decorator.info.fields: + raise PydanticUserError( + 'Multiple field serializer functions were defined ' + f'for field {f!r}, this is not allowed.', + code='multiple-field-serializers', + ) + res.field_serializers[var_name] = Decorator.build( + model_dc, cls_var_name=var_name, shim=var_value.shim, info=info + ) + elif isinstance(info, ModelValidatorDecoratorInfo): + res.model_validators[var_name] = Decorator.build( + model_dc, cls_var_name=var_name, shim=var_value.shim, info=info + ) + elif isinstance(info, ModelSerializerDecoratorInfo): + res.model_serializers[var_name] = Decorator.build( + model_dc, cls_var_name=var_name, shim=var_value.shim, info=info + ) + else: + from ..fields import ComputedFieldInfo + + isinstance(var_value, ComputedFieldInfo) + res.computed_fields[var_name] = Decorator.build( + model_dc, cls_var_name=var_name, shim=None, info=info + ) + to_replace.append((var_name, var_value.wrapped)) + if to_replace: + # If we can save `__pydantic_decorators__` on the class we'll be able to check for it above + # so then we don't need to re-process the type, which means we can discard our descriptor wrappers + # and replace them with the thing they are wrapping (see the other setattr call below) + # which allows validator class methods to also function as regular class methods + setattr(model_dc, '__pydantic_decorators__', res) + for name, value in to_replace: + setattr(model_dc, name, value) + return res + + +def inspect_validator(validator: Callable[..., Any], mode: FieldValidatorModes) -> bool: + """Look at a field or model validator function and determine whether it takes an info argument. + + An error is raised if the function has an invalid signature. + + Args: + validator: The validator function to inspect. + mode: The proposed validator mode. + + Returns: + Whether the validator takes an info argument. + """ + try: + sig = signature(validator) + except (ValueError, TypeError): + # `inspect.signature` might not be able to infer a signature, e.g. with C objects. + # In this case, we assume no info argument is present: + return False + n_positional = count_positional_required_params(sig) + if mode == 'wrap': + if n_positional == 3: + return True + elif n_positional == 2: + return False + else: + assert mode in {'before', 'after', 'plain'}, f"invalid mode: {mode!r}, expected 'before', 'after' or 'plain" + if n_positional == 2: + return True + elif n_positional == 1: + return False + + raise PydanticUserError( + f'Unrecognized field_validator function signature for {validator} with `mode={mode}`:{sig}', + code='validator-signature', + ) + + +def inspect_field_serializer( + serializer: Callable[..., Any], mode: Literal['plain', 'wrap'], computed_field: bool = False +) -> tuple[bool, bool]: + """Look at a field serializer function and determine if it is a field serializer, + and whether it takes an info argument. + + An error is raised if the function has an invalid signature. + + Args: + serializer: The serializer function to inspect. + mode: The serializer mode, either 'plain' or 'wrap'. + computed_field: When serializer is applied on computed_field. It doesn't require + info signature. + + Returns: + Tuple of (is_field_serializer, info_arg). + """ + try: + sig = signature(serializer) + except (ValueError, TypeError): + # `inspect.signature` might not be able to infer a signature, e.g. with C objects. + # In this case, we assume no info argument is present and this is not a method: + return (False, False) + + first = next(iter(sig.parameters.values()), None) + is_field_serializer = first is not None and first.name == 'self' + + n_positional = count_positional_required_params(sig) + if is_field_serializer: + # -1 to correct for self parameter + info_arg = _serializer_info_arg(mode, n_positional - 1) + else: + info_arg = _serializer_info_arg(mode, n_positional) + + if info_arg is None: + raise PydanticUserError( + f'Unrecognized field_serializer function signature for {serializer} with `mode={mode}`:{sig}', + code='field-serializer-signature', + ) + if info_arg and computed_field: + raise PydanticUserError( + 'field_serializer on computed_field does not use info signature', code='field-serializer-signature' + ) + + else: + return is_field_serializer, info_arg + + +def inspect_annotated_serializer(serializer: Callable[..., Any], mode: Literal['plain', 'wrap']) -> bool: + """Look at a serializer function used via `Annotated` and determine whether it takes an info argument. + + An error is raised if the function has an invalid signature. + + Args: + serializer: The serializer function to check. + mode: The serializer mode, either 'plain' or 'wrap'. + + Returns: + info_arg + """ + try: + sig = signature(serializer) + except (ValueError, TypeError): + # `inspect.signature` might not be able to infer a signature, e.g. with C objects. + # In this case, we assume no info argument is present: + return False + info_arg = _serializer_info_arg(mode, count_positional_required_params(sig)) + if info_arg is None: + raise PydanticUserError( + f'Unrecognized field_serializer function signature for {serializer} with `mode={mode}`:{sig}', + code='field-serializer-signature', + ) + else: + return info_arg + + +def inspect_model_serializer(serializer: Callable[..., Any], mode: Literal['plain', 'wrap']) -> bool: + """Look at a model serializer function and determine whether it takes an info argument. + + An error is raised if the function has an invalid signature. + + Args: + serializer: The serializer function to check. + mode: The serializer mode, either 'plain' or 'wrap'. + + Returns: + `info_arg` - whether the function expects an info argument. + """ + if isinstance(serializer, (staticmethod, classmethod)) or not is_instance_method_from_sig(serializer): + raise PydanticUserError( + '`@model_serializer` must be applied to instance methods', code='model-serializer-instance-method' + ) + + sig = signature(serializer) + info_arg = _serializer_info_arg(mode, count_positional_required_params(sig)) + if info_arg is None: + raise PydanticUserError( + f'Unrecognized model_serializer function signature for {serializer} with `mode={mode}`:{sig}', + code='model-serializer-signature', + ) + else: + return info_arg + + +def _serializer_info_arg(mode: Literal['plain', 'wrap'], n_positional: int) -> bool | None: + if mode == 'plain': + if n_positional == 1: + # (input_value: Any, /) -> Any + return False + elif n_positional == 2: + # (model: Any, input_value: Any, /) -> Any + return True + else: + assert mode == 'wrap', f"invalid mode: {mode!r}, expected 'plain' or 'wrap'" + if n_positional == 2: + # (input_value: Any, serializer: SerializerFunctionWrapHandler, /) -> Any + return False + elif n_positional == 3: + # (input_value: Any, serializer: SerializerFunctionWrapHandler, info: SerializationInfo, /) -> Any + return True + + return None + + +AnyDecoratorCallable: TypeAlias = ( + 'Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any], Callable[..., Any]]' +) + + +def is_instance_method_from_sig(function: AnyDecoratorCallable) -> bool: + """Whether the function is an instance method. + + It will consider a function as instance method if the first parameter of + function is `self`. + + Args: + function: The function to check. + + Returns: + `True` if the function is an instance method, `False` otherwise. + """ + sig = signature(unwrap_wrapped_function(function)) + first = next(iter(sig.parameters.values()), None) + if first and first.name == 'self': + return True + return False + + +def ensure_classmethod_based_on_signature(function: AnyDecoratorCallable) -> Any: + """Apply the `@classmethod` decorator on the function. + + Args: + function: The function to apply the decorator on. + + Return: + The `@classmethod` decorator applied function. + """ + if not isinstance( + unwrap_wrapped_function(function, unwrap_class_static_method=False), classmethod + ) and _is_classmethod_from_sig(function): + return classmethod(function) # type: ignore[arg-type] + return function + + +def _is_classmethod_from_sig(function: AnyDecoratorCallable) -> bool: + sig = signature(unwrap_wrapped_function(function)) + first = next(iter(sig.parameters.values()), None) + if first and first.name == 'cls': + return True + return False + + +def unwrap_wrapped_function( + func: Any, + *, + unwrap_partial: bool = True, + unwrap_class_static_method: bool = True, +) -> Any: + """Recursively unwraps a wrapped function until the underlying function is reached. + This handles property, functools.partial, functools.partialmethod, staticmethod, and classmethod. + + Args: + func: The function to unwrap. + unwrap_partial: If True (default), unwrap partial and partialmethod decorators. + unwrap_class_static_method: If True (default), also unwrap classmethod and staticmethod + decorators. If False, only unwrap partial and partialmethod decorators. + + Returns: + The underlying function of the wrapped function. + """ + # Define the types we want to check against as a single tuple. + unwrap_types = ( + (property, cached_property) + + ((partial, partialmethod) if unwrap_partial else ()) + + ((staticmethod, classmethod) if unwrap_class_static_method else ()) + ) + + while isinstance(func, unwrap_types): + if unwrap_class_static_method and isinstance(func, (classmethod, staticmethod)): + func = func.__func__ + elif isinstance(func, (partial, partialmethod)): + func = func.func + elif isinstance(func, property): + func = func.fget # arbitrary choice, convenient for computed fields + else: + # Make coverage happy as it can only get here in the last possible case + assert isinstance(func, cached_property) + func = func.func # type: ignore + + return func + + +def get_function_return_type( + func: Any, explicit_return_type: Any, types_namespace: dict[str, Any] | None = None +) -> Any: + """Get the function return type. + + It gets the return type from the type annotation if `explicit_return_type` is `None`. + Otherwise, it returns `explicit_return_type`. + + Args: + func: The function to get its return type. + explicit_return_type: The explicit return type. + types_namespace: The types namespace, defaults to `None`. + + Returns: + The function return type. + """ + if explicit_return_type is PydanticUndefined: + # try to get it from the type annotation + hints = get_function_type_hints( + unwrap_wrapped_function(func), include_keys={'return'}, types_namespace=types_namespace + ) + return hints.get('return', PydanticUndefined) + else: + return explicit_return_type + + +def count_positional_required_params(sig: Signature) -> int: + """Get the number of positional (required) arguments of a signature. + + This function should only be used to inspect signatures of validation and serialization functions. + The first argument (the value being serialized or validated) is counted as a required argument + even if a default value exists. + + Returns: + The number of positional arguments of a signature. + """ + parameters = list(sig.parameters.values()) + return sum( + 1 + for param in parameters + if can_be_positional(param) + # First argument is the value being validated/serialized, and can have a default value + # (e.g. `float`, which has signature `(x=0, /)`). We assume other parameters (the info arg + # for instance) should be required, and thus without any default value. + and (param.default is Parameter.empty or param == parameters[0]) + ) + + +def can_be_positional(param: Parameter) -> bool: + return param.kind in (Parameter.POSITIONAL_ONLY, Parameter.POSITIONAL_OR_KEYWORD) + + +def ensure_property(f: Any) -> Any: + """Ensure that a function is a `property` or `cached_property`, or is a valid descriptor. + + Args: + f: The function to check. + + Returns: + The function, or a `property` or `cached_property` instance wrapping the function. + """ + if ismethoddescriptor(f) or isdatadescriptor(f): + return f + else: + return property(f) diff --git a/env/Lib/site-packages/pydantic/_internal/_decorators_v1.py b/env/Lib/site-packages/pydantic/_internal/_decorators_v1.py new file mode 100644 index 0000000..0957e01 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_decorators_v1.py @@ -0,0 +1,174 @@ +"""Logic for V1 validators, e.g. `@validator` and `@root_validator`.""" + +from __future__ import annotations as _annotations + +from inspect import Parameter, signature +from typing import Any, Dict, Tuple, Union, cast + +from pydantic_core import core_schema +from typing_extensions import Protocol + +from ..errors import PydanticUserError +from ._decorators import can_be_positional + + +class V1OnlyValueValidator(Protocol): + """A simple validator, supported for V1 validators and V2 validators.""" + + def __call__(self, __value: Any) -> Any: ... + + +class V1ValidatorWithValues(Protocol): + """A validator with `values` argument, supported for V1 validators and V2 validators.""" + + def __call__(self, __value: Any, values: dict[str, Any]) -> Any: ... + + +class V1ValidatorWithValuesKwOnly(Protocol): + """A validator with keyword only `values` argument, supported for V1 validators and V2 validators.""" + + def __call__(self, __value: Any, *, values: dict[str, Any]) -> Any: ... + + +class V1ValidatorWithKwargs(Protocol): + """A validator with `kwargs` argument, supported for V1 validators and V2 validators.""" + + def __call__(self, __value: Any, **kwargs: Any) -> Any: ... + + +class V1ValidatorWithValuesAndKwargs(Protocol): + """A validator with `values` and `kwargs` arguments, supported for V1 validators and V2 validators.""" + + def __call__(self, __value: Any, values: dict[str, Any], **kwargs: Any) -> Any: ... + + +V1Validator = Union[ + V1ValidatorWithValues, V1ValidatorWithValuesKwOnly, V1ValidatorWithKwargs, V1ValidatorWithValuesAndKwargs +] + + +def can_be_keyword(param: Parameter) -> bool: + return param.kind in (Parameter.POSITIONAL_OR_KEYWORD, Parameter.KEYWORD_ONLY) + + +def make_generic_v1_field_validator(validator: V1Validator) -> core_schema.WithInfoValidatorFunction: + """Wrap a V1 style field validator for V2 compatibility. + + Args: + validator: The V1 style field validator. + + Returns: + A wrapped V2 style field validator. + + Raises: + PydanticUserError: If the signature is not supported or the parameters are + not available in Pydantic V2. + """ + sig = signature(validator) + + needs_values_kw = False + + for param_num, (param_name, parameter) in enumerate(sig.parameters.items()): + if can_be_keyword(parameter) and param_name in ('field', 'config'): + raise PydanticUserError( + 'The `field` and `config` parameters are not available in Pydantic V2, ' + 'please use the `info` parameter instead.', + code='validator-field-config-info', + ) + if parameter.kind is Parameter.VAR_KEYWORD: + needs_values_kw = True + elif can_be_keyword(parameter) and param_name == 'values': + needs_values_kw = True + elif can_be_positional(parameter) and param_num == 0: + # value + continue + elif parameter.default is Parameter.empty: # ignore params with defaults e.g. bound by functools.partial + raise PydanticUserError( + f'Unsupported signature for V1 style validator {validator}: {sig} is not supported.', + code='validator-v1-signature', + ) + + if needs_values_kw: + # (v, **kwargs), (v, values, **kwargs), (v, *, values, **kwargs) or (v, *, values) + val1 = cast(V1ValidatorWithValues, validator) + + def wrapper1(value: Any, info: core_schema.ValidationInfo) -> Any: + return val1(value, values=info.data) + + return wrapper1 + else: + val2 = cast(V1OnlyValueValidator, validator) + + def wrapper2(value: Any, _: core_schema.ValidationInfo) -> Any: + return val2(value) + + return wrapper2 + + +RootValidatorValues = Dict[str, Any] +# technically tuple[model_dict, model_extra, fields_set] | tuple[dataclass_dict, init_vars] +RootValidatorFieldsTuple = Tuple[Any, ...] + + +class V1RootValidatorFunction(Protocol): + """A simple root validator, supported for V1 validators and V2 validators.""" + + def __call__(self, __values: RootValidatorValues) -> RootValidatorValues: ... + + +class V2CoreBeforeRootValidator(Protocol): + """V2 validator with mode='before'.""" + + def __call__(self, __values: RootValidatorValues, __info: core_schema.ValidationInfo) -> RootValidatorValues: ... + + +class V2CoreAfterRootValidator(Protocol): + """V2 validator with mode='after'.""" + + def __call__( + self, __fields_tuple: RootValidatorFieldsTuple, __info: core_schema.ValidationInfo + ) -> RootValidatorFieldsTuple: ... + + +def make_v1_generic_root_validator( + validator: V1RootValidatorFunction, pre: bool +) -> V2CoreBeforeRootValidator | V2CoreAfterRootValidator: + """Wrap a V1 style root validator for V2 compatibility. + + Args: + validator: The V1 style field validator. + pre: Whether the validator is a pre validator. + + Returns: + A wrapped V2 style validator. + """ + if pre is True: + # mode='before' for pydantic-core + def _wrapper1(values: RootValidatorValues, _: core_schema.ValidationInfo) -> RootValidatorValues: + return validator(values) + + return _wrapper1 + + # mode='after' for pydantic-core + def _wrapper2(fields_tuple: RootValidatorFieldsTuple, _: core_schema.ValidationInfo) -> RootValidatorFieldsTuple: + if len(fields_tuple) == 2: + # dataclass, this is easy + values, init_vars = fields_tuple + values = validator(values) + return values, init_vars + else: + # ugly hack: to match v1 behaviour, we merge values and model_extra, then split them up based on fields + # afterwards + model_dict, model_extra, fields_set = fields_tuple + if model_extra: + fields = set(model_dict.keys()) + model_dict.update(model_extra) + model_dict_new = validator(model_dict) + for k in list(model_dict_new.keys()): + if k not in fields: + model_extra[k] = model_dict_new.pop(k) + else: + model_dict_new = validator(model_dict) + return model_dict_new, model_extra, fields_set + + return _wrapper2 diff --git a/env/Lib/site-packages/pydantic/_internal/_discriminated_union.py b/env/Lib/site-packages/pydantic/_internal/_discriminated_union.py new file mode 100644 index 0000000..a090c36 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_discriminated_union.py @@ -0,0 +1,503 @@ +from __future__ import annotations as _annotations + +from typing import TYPE_CHECKING, Any, Hashable, Sequence + +from pydantic_core import CoreSchema, core_schema + +from ..errors import PydanticUserError +from . import _core_utils +from ._core_utils import ( + CoreSchemaField, + collect_definitions, +) + +if TYPE_CHECKING: + from ..types import Discriminator + +CORE_SCHEMA_METADATA_DISCRIMINATOR_PLACEHOLDER_KEY = 'pydantic.internal.union_discriminator' + + +class MissingDefinitionForUnionRef(Exception): + """Raised when applying a discriminated union discriminator to a schema + requires a definition that is not yet defined + """ + + def __init__(self, ref: str) -> None: + self.ref = ref + super().__init__(f'Missing definition for ref {self.ref!r}') + + +def set_discriminator_in_metadata(schema: CoreSchema, discriminator: Any) -> None: + schema.setdefault('metadata', {}) + metadata = schema.get('metadata') + assert metadata is not None + metadata[CORE_SCHEMA_METADATA_DISCRIMINATOR_PLACEHOLDER_KEY] = discriminator + + +def apply_discriminators(schema: core_schema.CoreSchema) -> core_schema.CoreSchema: + # We recursively walk through the `schema` passed to `apply_discriminators`, applying discriminators + # where necessary at each level. During this recursion, we allow references to be resolved from the definitions + # that are originally present on the original, outermost `schema`. Before `apply_discriminators` is called, + # `simplify_schema_references` is called on the schema (in the `clean_schema` function), + # which often puts the definitions in the outermost schema. + global_definitions: dict[str, CoreSchema] = collect_definitions(schema) + + def inner(s: core_schema.CoreSchema, recurse: _core_utils.Recurse) -> core_schema.CoreSchema: + nonlocal global_definitions + + s = recurse(s, inner) + if s['type'] == 'tagged-union': + return s + + metadata = s.get('metadata', {}) + discriminator = metadata.pop(CORE_SCHEMA_METADATA_DISCRIMINATOR_PLACEHOLDER_KEY, None) + if discriminator is not None: + s = apply_discriminator(s, discriminator, global_definitions) + return s + + return _core_utils.walk_core_schema(schema, inner) + + +def apply_discriminator( + schema: core_schema.CoreSchema, + discriminator: str | Discriminator, + definitions: dict[str, core_schema.CoreSchema] | None = None, +) -> core_schema.CoreSchema: + """Applies the discriminator and returns a new core schema. + + Args: + schema: The input schema. + discriminator: The name of the field which will serve as the discriminator. + definitions: A mapping of schema ref to schema. + + Returns: + The new core schema. + + Raises: + TypeError: + - If `discriminator` is used with invalid union variant. + - If `discriminator` is used with `Union` type with one variant. + - If `discriminator` value mapped to multiple choices. + MissingDefinitionForUnionRef: + If the definition for ref is missing. + PydanticUserError: + - If a model in union doesn't have a discriminator field. + - If discriminator field has a non-string alias. + - If discriminator fields have different aliases. + - If discriminator field not of type `Literal`. + """ + from ..types import Discriminator + + if isinstance(discriminator, Discriminator): + if isinstance(discriminator.discriminator, str): + discriminator = discriminator.discriminator + else: + return discriminator._convert_schema(schema) + + return _ApplyInferredDiscriminator(discriminator, definitions or {}).apply(schema) + + +class _ApplyInferredDiscriminator: + """This class is used to convert an input schema containing a union schema into one where that union is + replaced with a tagged-union, with all the associated debugging and performance benefits. + + This is done by: + * Validating that the input schema is compatible with the provided discriminator + * Introspecting the schema to determine which discriminator values should map to which union choices + * Handling various edge cases such as 'definitions', 'default', 'nullable' schemas, and more + + I have chosen to implement the conversion algorithm in this class, rather than a function, + to make it easier to maintain state while recursively walking the provided CoreSchema. + """ + + def __init__(self, discriminator: str, definitions: dict[str, core_schema.CoreSchema]): + # `discriminator` should be the name of the field which will serve as the discriminator. + # It must be the python name of the field, and *not* the field's alias. Note that as of now, + # all members of a discriminated union _must_ use a field with the same name as the discriminator. + # This may change if/when we expose a way to manually specify the TaggedUnionSchema's choices. + self.discriminator = discriminator + + # `definitions` should contain a mapping of schema ref to schema for all schemas which might + # be referenced by some choice + self.definitions = definitions + + # `_discriminator_alias` will hold the value, if present, of the alias for the discriminator + # + # Note: following the v1 implementation, we currently disallow the use of different aliases + # for different choices. This is not a limitation of pydantic_core, but if we try to handle + # this, the inference logic gets complicated very quickly, and could result in confusing + # debugging challenges for users making subtle mistakes. + # + # Rather than trying to do the most powerful inference possible, I think we should eventually + # expose a way to more-manually control the way the TaggedUnionSchema is constructed through + # the use of a new type which would be placed as an Annotation on the Union type. This would + # provide the full flexibility/power of pydantic_core's TaggedUnionSchema where necessary for + # more complex cases, without over-complicating the inference logic for the common cases. + self._discriminator_alias: str | None = None + + # `_should_be_nullable` indicates whether the converted union has `None` as an allowed value. + # If `None` is an acceptable value of the (possibly-wrapped) union, we ignore it while + # constructing the TaggedUnionSchema, but set the `_should_be_nullable` attribute to True. + # Once we have constructed the TaggedUnionSchema, if `_should_be_nullable` is True, we ensure + # that the final schema gets wrapped as a NullableSchema. This has the same semantics on the + # python side, but resolves the issue that `None` cannot correspond to any discriminator values. + self._should_be_nullable = False + + # `_is_nullable` is used to track if the final produced schema will definitely be nullable; + # we set it to True if the input schema is wrapped in a nullable schema that we know will be preserved + # as an indication that, even if None is discovered as one of the union choices, we will not need to wrap + # the final value in another nullable schema. + # + # This is more complicated than just checking for the final outermost schema having type 'nullable' thanks + # to the possible presence of other wrapper schemas such as DefinitionsSchema, WithDefaultSchema, etc. + self._is_nullable = False + + # `_choices_to_handle` serves as a stack of choices to add to the tagged union. Initially, choices + # from the union in the wrapped schema will be appended to this list, and the recursive choice-handling + # algorithm may add more choices to this stack as (nested) unions are encountered. + self._choices_to_handle: list[core_schema.CoreSchema] = [] + + # `_tagged_union_choices` is built during the call to `apply`, and will hold the choices to be included + # in the output TaggedUnionSchema that will replace the union from the input schema + self._tagged_union_choices: dict[Hashable, core_schema.CoreSchema] = {} + + # `_used` is changed to True after applying the discriminator to prevent accidental re-use + self._used = False + + def apply(self, schema: core_schema.CoreSchema) -> core_schema.CoreSchema: + """Return a new CoreSchema based on `schema` that uses a tagged-union with the discriminator provided + to this class. + + Args: + schema: The input schema. + + Returns: + The new core schema. + + Raises: + TypeError: + - If `discriminator` is used with invalid union variant. + - If `discriminator` is used with `Union` type with one variant. + - If `discriminator` value mapped to multiple choices. + ValueError: + If the definition for ref is missing. + PydanticUserError: + - If a model in union doesn't have a discriminator field. + - If discriminator field has a non-string alias. + - If discriminator fields have different aliases. + - If discriminator field not of type `Literal`. + """ + assert not self._used + schema = self._apply_to_root(schema) + if self._should_be_nullable and not self._is_nullable: + schema = core_schema.nullable_schema(schema) + self._used = True + return schema + + def _apply_to_root(self, schema: core_schema.CoreSchema) -> core_schema.CoreSchema: + """This method handles the outer-most stage of recursion over the input schema: + unwrapping nullable or definitions schemas, and calling the `_handle_choice` + method iteratively on the choices extracted (recursively) from the possibly-wrapped union. + """ + if schema['type'] == 'nullable': + self._is_nullable = True + wrapped = self._apply_to_root(schema['schema']) + nullable_wrapper = schema.copy() + nullable_wrapper['schema'] = wrapped + return nullable_wrapper + + if schema['type'] == 'definitions': + wrapped = self._apply_to_root(schema['schema']) + definitions_wrapper = schema.copy() + definitions_wrapper['schema'] = wrapped + return definitions_wrapper + + if schema['type'] != 'union': + # If the schema is not a union, it probably means it just had a single member and + # was flattened by pydantic_core. + # However, it still may make sense to apply the discriminator to this schema, + # as a way to get discriminated-union-style error messages, so we allow this here. + schema = core_schema.union_schema([schema]) + + # Reverse the choices list before extending the stack so that they get handled in the order they occur + choices_schemas = [v[0] if isinstance(v, tuple) else v for v in schema['choices'][::-1]] + self._choices_to_handle.extend(choices_schemas) + while self._choices_to_handle: + choice = self._choices_to_handle.pop() + self._handle_choice(choice) + + if self._discriminator_alias is not None and self._discriminator_alias != self.discriminator: + # * We need to annotate `discriminator` as a union here to handle both branches of this conditional + # * We need to annotate `discriminator` as list[list[str | int]] and not list[list[str]] due to the + # invariance of list, and because list[list[str | int]] is the type of the discriminator argument + # to tagged_union_schema below + # * See the docstring of pydantic_core.core_schema.tagged_union_schema for more details about how to + # interpret the value of the discriminator argument to tagged_union_schema. (The list[list[str]] here + # is the appropriate way to provide a list of fallback attributes to check for a discriminator value.) + discriminator: str | list[list[str | int]] = [[self.discriminator], [self._discriminator_alias]] + else: + discriminator = self.discriminator + return core_schema.tagged_union_schema( + choices=self._tagged_union_choices, + discriminator=discriminator, + custom_error_type=schema.get('custom_error_type'), + custom_error_message=schema.get('custom_error_message'), + custom_error_context=schema.get('custom_error_context'), + strict=False, + from_attributes=True, + ref=schema.get('ref'), + metadata=schema.get('metadata'), + serialization=schema.get('serialization'), + ) + + def _handle_choice(self, choice: core_schema.CoreSchema) -> None: + """This method handles the "middle" stage of recursion over the input schema. + Specifically, it is responsible for handling each choice of the outermost union + (and any "coalesced" choices obtained from inner unions). + + Here, "handling" entails: + * Coalescing nested unions and compatible tagged-unions + * Tracking the presence of 'none' and 'nullable' schemas occurring as choices + * Validating that each allowed discriminator value maps to a unique choice + * Updating the _tagged_union_choices mapping that will ultimately be used to build the TaggedUnionSchema. + """ + if choice['type'] == 'definition-ref': + if choice['schema_ref'] not in self.definitions: + raise MissingDefinitionForUnionRef(choice['schema_ref']) + + if choice['type'] == 'none': + self._should_be_nullable = True + elif choice['type'] == 'definitions': + self._handle_choice(choice['schema']) + elif choice['type'] == 'nullable': + self._should_be_nullable = True + self._handle_choice(choice['schema']) # unwrap the nullable schema + elif choice['type'] == 'union': + # Reverse the choices list before extending the stack so that they get handled in the order they occur + choices_schemas = [v[0] if isinstance(v, tuple) else v for v in choice['choices'][::-1]] + self._choices_to_handle.extend(choices_schemas) + elif choice['type'] not in { + 'model', + 'typed-dict', + 'tagged-union', + 'lax-or-strict', + 'dataclass', + 'dataclass-args', + 'definition-ref', + } and not _core_utils.is_function_with_inner_schema(choice): + # We should eventually handle 'definition-ref' as well + raise TypeError( + f'{choice["type"]!r} is not a valid discriminated union variant;' + ' should be a `BaseModel` or `dataclass`' + ) + else: + if choice['type'] == 'tagged-union' and self._is_discriminator_shared(choice): + # In this case, this inner tagged-union is compatible with the outer tagged-union, + # and its choices can be coalesced into the outer TaggedUnionSchema. + subchoices = [x for x in choice['choices'].values() if not isinstance(x, (str, int))] + # Reverse the choices list before extending the stack so that they get handled in the order they occur + self._choices_to_handle.extend(subchoices[::-1]) + return + + inferred_discriminator_values = self._infer_discriminator_values_for_choice(choice, source_name=None) + self._set_unique_choice_for_values(choice, inferred_discriminator_values) + + def _is_discriminator_shared(self, choice: core_schema.TaggedUnionSchema) -> bool: + """This method returns a boolean indicating whether the discriminator for the `choice` + is the same as that being used for the outermost tagged union. This is used to + determine whether this TaggedUnionSchema choice should be "coalesced" into the top level, + or whether it should be treated as a separate (nested) choice. + """ + inner_discriminator = choice['discriminator'] + return inner_discriminator == self.discriminator or ( + isinstance(inner_discriminator, list) + and (self.discriminator in inner_discriminator or [self.discriminator] in inner_discriminator) + ) + + def _infer_discriminator_values_for_choice( # noqa C901 + self, choice: core_schema.CoreSchema, source_name: str | None + ) -> list[str | int]: + """This function recurses over `choice`, extracting all discriminator values that should map to this choice. + + `model_name` is accepted for the purpose of producing useful error messages. + """ + if choice['type'] == 'definitions': + return self._infer_discriminator_values_for_choice(choice['schema'], source_name=source_name) + elif choice['type'] == 'function-plain': + raise TypeError( + f'{choice["type"]!r} is not a valid discriminated union variant;' + ' should be a `BaseModel` or `dataclass`' + ) + elif _core_utils.is_function_with_inner_schema(choice): + return self._infer_discriminator_values_for_choice(choice['schema'], source_name=source_name) + elif choice['type'] == 'lax-or-strict': + return sorted( + set( + self._infer_discriminator_values_for_choice(choice['lax_schema'], source_name=None) + + self._infer_discriminator_values_for_choice(choice['strict_schema'], source_name=None) + ) + ) + + elif choice['type'] == 'tagged-union': + values: list[str | int] = [] + # Ignore str/int "choices" since these are just references to other choices + subchoices = [x for x in choice['choices'].values() if not isinstance(x, (str, int))] + for subchoice in subchoices: + subchoice_values = self._infer_discriminator_values_for_choice(subchoice, source_name=None) + values.extend(subchoice_values) + return values + + elif choice['type'] == 'union': + values = [] + for subchoice in choice['choices']: + subchoice_schema = subchoice[0] if isinstance(subchoice, tuple) else subchoice + subchoice_values = self._infer_discriminator_values_for_choice(subchoice_schema, source_name=None) + values.extend(subchoice_values) + return values + + elif choice['type'] == 'nullable': + self._should_be_nullable = True + return self._infer_discriminator_values_for_choice(choice['schema'], source_name=None) + + elif choice['type'] == 'model': + return self._infer_discriminator_values_for_choice(choice['schema'], source_name=choice['cls'].__name__) + + elif choice['type'] == 'dataclass': + return self._infer_discriminator_values_for_choice(choice['schema'], source_name=choice['cls'].__name__) + + elif choice['type'] == 'model-fields': + return self._infer_discriminator_values_for_model_choice(choice, source_name=source_name) + + elif choice['type'] == 'dataclass-args': + return self._infer_discriminator_values_for_dataclass_choice(choice, source_name=source_name) + + elif choice['type'] == 'typed-dict': + return self._infer_discriminator_values_for_typed_dict_choice(choice, source_name=source_name) + + elif choice['type'] == 'definition-ref': + schema_ref = choice['schema_ref'] + if schema_ref not in self.definitions: + raise MissingDefinitionForUnionRef(schema_ref) + return self._infer_discriminator_values_for_choice(self.definitions[schema_ref], source_name=source_name) + else: + raise TypeError( + f'{choice["type"]!r} is not a valid discriminated union variant;' + ' should be a `BaseModel` or `dataclass`' + ) + + def _infer_discriminator_values_for_typed_dict_choice( + self, choice: core_schema.TypedDictSchema, source_name: str | None = None + ) -> list[str | int]: + """This method just extracts the _infer_discriminator_values_for_choice logic specific to TypedDictSchema + for the sake of readability. + """ + source = 'TypedDict' if source_name is None else f'TypedDict {source_name!r}' + field = choice['fields'].get(self.discriminator) + if field is None: + raise PydanticUserError( + f'{source} needs a discriminator field for key {self.discriminator!r}', code='discriminator-no-field' + ) + return self._infer_discriminator_values_for_field(field, source) + + def _infer_discriminator_values_for_model_choice( + self, choice: core_schema.ModelFieldsSchema, source_name: str | None = None + ) -> list[str | int]: + source = 'ModelFields' if source_name is None else f'Model {source_name!r}' + field = choice['fields'].get(self.discriminator) + if field is None: + raise PydanticUserError( + f'{source} needs a discriminator field for key {self.discriminator!r}', code='discriminator-no-field' + ) + return self._infer_discriminator_values_for_field(field, source) + + def _infer_discriminator_values_for_dataclass_choice( + self, choice: core_schema.DataclassArgsSchema, source_name: str | None = None + ) -> list[str | int]: + source = 'DataclassArgs' if source_name is None else f'Dataclass {source_name!r}' + for field in choice['fields']: + if field['name'] == self.discriminator: + break + else: + raise PydanticUserError( + f'{source} needs a discriminator field for key {self.discriminator!r}', code='discriminator-no-field' + ) + return self._infer_discriminator_values_for_field(field, source) + + def _infer_discriminator_values_for_field(self, field: CoreSchemaField, source: str) -> list[str | int]: + if field['type'] == 'computed-field': + # This should never occur as a discriminator, as it is only relevant to serialization + return [] + alias = field.get('validation_alias', self.discriminator) + if not isinstance(alias, str): + raise PydanticUserError( + f'Alias {alias!r} is not supported in a discriminated union', code='discriminator-alias-type' + ) + if self._discriminator_alias is None: + self._discriminator_alias = alias + elif self._discriminator_alias != alias: + raise PydanticUserError( + f'Aliases for discriminator {self.discriminator!r} must be the same ' + f'(got {alias}, {self._discriminator_alias})', + code='discriminator-alias', + ) + return self._infer_discriminator_values_for_inner_schema(field['schema'], source) + + def _infer_discriminator_values_for_inner_schema( + self, schema: core_schema.CoreSchema, source: str + ) -> list[str | int]: + """When inferring discriminator values for a field, we typically extract the expected values from a literal + schema. This function does that, but also handles nested unions and defaults. + """ + if schema['type'] == 'literal': + return schema['expected'] + + elif schema['type'] == 'union': + # Generally when multiple values are allowed they should be placed in a single `Literal`, but + # we add this case to handle the situation where a field is annotated as a `Union` of `Literal`s. + # For example, this lets us handle `Union[Literal['key'], Union[Literal['Key'], Literal['KEY']]]` + values: list[Any] = [] + for choice in schema['choices']: + choice_schema = choice[0] if isinstance(choice, tuple) else choice + choice_values = self._infer_discriminator_values_for_inner_schema(choice_schema, source) + values.extend(choice_values) + return values + + elif schema['type'] == 'default': + # This will happen if the field has a default value; we ignore it while extracting the discriminator values + return self._infer_discriminator_values_for_inner_schema(schema['schema'], source) + + elif schema['type'] == 'function-after': + # After validators don't affect the discriminator values + return self._infer_discriminator_values_for_inner_schema(schema['schema'], source) + + elif schema['type'] in {'function-before', 'function-wrap', 'function-plain'}: + validator_type = repr(schema['type'].split('-')[1]) + raise PydanticUserError( + f'Cannot use a mode={validator_type} validator in the' + f' discriminator field {self.discriminator!r} of {source}', + code='discriminator-validator', + ) + + else: + raise PydanticUserError( + f'{source} needs field {self.discriminator!r} to be of type `Literal`', + code='discriminator-needs-literal', + ) + + def _set_unique_choice_for_values(self, choice: core_schema.CoreSchema, values: Sequence[str | int]) -> None: + """This method updates `self.tagged_union_choices` so that all provided (discriminator) `values` map to the + provided `choice`, validating that none of these values already map to another (different) choice. + """ + for discriminator_value in values: + if discriminator_value in self._tagged_union_choices: + # It is okay if `value` is already in tagged_union_choices as long as it maps to the same value. + # Because tagged_union_choices may map values to other values, we need to walk the choices dict + # until we get to a "real" choice, and confirm that is equal to the one assigned. + existing_choice = self._tagged_union_choices[discriminator_value] + if existing_choice != choice: + raise TypeError( + f'Value {discriminator_value!r} for discriminator ' + f'{self.discriminator!r} mapped to multiple choices' + ) + else: + self._tagged_union_choices[discriminator_value] = choice diff --git a/env/Lib/site-packages/pydantic/_internal/_docs_extraction.py b/env/Lib/site-packages/pydantic/_internal/_docs_extraction.py new file mode 100644 index 0000000..685a6d0 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_docs_extraction.py @@ -0,0 +1,108 @@ +"""Utilities related to attribute docstring extraction.""" + +from __future__ import annotations + +import ast +import inspect +import textwrap +from typing import Any + + +class DocstringVisitor(ast.NodeVisitor): + def __init__(self) -> None: + super().__init__() + + self.target: str | None = None + self.attrs: dict[str, str] = {} + self.previous_node_type: type[ast.AST] | None = None + + def visit(self, node: ast.AST) -> Any: + node_result = super().visit(node) + self.previous_node_type = type(node) + return node_result + + def visit_AnnAssign(self, node: ast.AnnAssign) -> Any: + if isinstance(node.target, ast.Name): + self.target = node.target.id + + def visit_Expr(self, node: ast.Expr) -> Any: + if ( + isinstance(node.value, ast.Constant) + and isinstance(node.value.value, str) + and self.previous_node_type is ast.AnnAssign + ): + docstring = inspect.cleandoc(node.value.value) + if self.target: + self.attrs[self.target] = docstring + self.target = None + + +def _dedent_source_lines(source: list[str]) -> str: + # Required for nested class definitions, e.g. in a function block + dedent_source = textwrap.dedent(''.join(source)) + if dedent_source.startswith((' ', '\t')): + # We are in the case where there's a dedented (usually multiline) string + # at a lower indentation level than the class itself. We wrap our class + # in a function as a workaround. + dedent_source = f'def dedent_workaround():\n{dedent_source}' + return dedent_source + + +def _extract_source_from_frame(cls: type[Any]) -> list[str] | None: + frame = inspect.currentframe() + + while frame: + if inspect.getmodule(frame) is inspect.getmodule(cls): + lnum = frame.f_lineno + try: + lines, _ = inspect.findsource(frame) + except OSError: + # Source can't be retrieved (maybe because running in an interactive terminal), + # we don't want to error here. + pass + else: + block_lines = inspect.getblock(lines[lnum - 1 :]) + dedent_source = _dedent_source_lines(block_lines) + try: + block_tree = ast.parse(dedent_source) + except SyntaxError: + pass + else: + stmt = block_tree.body[0] + if isinstance(stmt, ast.FunctionDef) and stmt.name == 'dedent_workaround': + # `_dedent_source_lines` wrapped the class around the workaround function + stmt = stmt.body[0] + if isinstance(stmt, ast.ClassDef) and stmt.name == cls.__name__: + return block_lines + + frame = frame.f_back + + +def extract_docstrings_from_cls(cls: type[Any], use_inspect: bool = False) -> dict[str, str]: + """Map model attributes and their corresponding docstring. + + Args: + cls: The class of the Pydantic model to inspect. + use_inspect: Whether to skip usage of frames to find the object and use + the `inspect` module instead. + + Returns: + A mapping containing attribute names and their corresponding docstring. + """ + if use_inspect: + # Might not work as expected if two classes have the same name in the same source file. + try: + source, _ = inspect.getsourcelines(cls) + except OSError: + return {} + else: + source = _extract_source_from_frame(cls) + + if not source: + return {} + + dedent_source = _dedent_source_lines(source) + + visitor = DocstringVisitor() + visitor.visit(ast.parse(dedent_source)) + return visitor.attrs diff --git a/env/Lib/site-packages/pydantic/_internal/_fields.py b/env/Lib/site-packages/pydantic/_internal/_fields.py new file mode 100644 index 0000000..52cd08b --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_fields.py @@ -0,0 +1,361 @@ +"""Private logic related to fields (the `Field()` function and `FieldInfo` class), and arguments to `Annotated`.""" + +from __future__ import annotations as _annotations + +import dataclasses +import sys +import warnings +from copy import copy +from functools import lru_cache +from typing import TYPE_CHECKING, Any + +from pydantic_core import PydanticUndefined + +from pydantic.errors import PydanticUserError + +from . import _typing_extra +from ._config import ConfigWrapper +from ._docs_extraction import extract_docstrings_from_cls +from ._repr import Representation +from ._typing_extra import get_cls_type_hints_lenient, get_type_hints, is_classvar, is_finalvar + +if TYPE_CHECKING: + from annotated_types import BaseMetadata + + from ..fields import FieldInfo + from ..main import BaseModel + from ._dataclasses import StandardDataclass + from ._decorators import DecoratorInfos + + +def get_type_hints_infer_globalns( + obj: Any, + localns: dict[str, Any] | None = None, + include_extras: bool = False, +) -> dict[str, Any]: + """Gets type hints for an object by inferring the global namespace. + + It uses the `typing.get_type_hints`, The only thing that we do here is fetching + global namespace from `obj.__module__` if it is not `None`. + + Args: + obj: The object to get its type hints. + localns: The local namespaces. + include_extras: Whether to recursively include annotation metadata. + + Returns: + The object type hints. + """ + module_name = getattr(obj, '__module__', None) + globalns: dict[str, Any] | None = None + if module_name: + try: + globalns = sys.modules[module_name].__dict__ + except KeyError: + # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363 + pass + return get_type_hints(obj, globalns=globalns, localns=localns, include_extras=include_extras) + + +class PydanticMetadata(Representation): + """Base class for annotation markers like `Strict`.""" + + __slots__ = () + + +def pydantic_general_metadata(**metadata: Any) -> BaseMetadata: + """Create a new `_PydanticGeneralMetadata` class with the given metadata. + + Args: + **metadata: The metadata to add. + + Returns: + The new `_PydanticGeneralMetadata` class. + """ + return _general_metadata_cls()(metadata) # type: ignore + + +@lru_cache(maxsize=None) +def _general_metadata_cls() -> type[BaseMetadata]: + """Do it this way to avoid importing `annotated_types` at import time.""" + from annotated_types import BaseMetadata + + class _PydanticGeneralMetadata(PydanticMetadata, BaseMetadata): + """Pydantic general metadata like `max_digits`.""" + + def __init__(self, metadata: Any): + self.__dict__ = metadata + + return _PydanticGeneralMetadata # type: ignore + + +def _update_fields_from_docstrings(cls: type[Any], fields: dict[str, FieldInfo], config_wrapper: ConfigWrapper) -> None: + if config_wrapper.use_attribute_docstrings: + fields_docs = extract_docstrings_from_cls(cls) + for ann_name, field_info in fields.items(): + if field_info.description is None and ann_name in fields_docs: + field_info.description = fields_docs[ann_name] + + +def collect_model_fields( # noqa: C901 + cls: type[BaseModel], + bases: tuple[type[Any], ...], + config_wrapper: ConfigWrapper, + types_namespace: dict[str, Any] | None, + *, + typevars_map: dict[Any, Any] | None = None, +) -> tuple[dict[str, FieldInfo], set[str]]: + """Collect the fields of a nascent pydantic model. + + Also collect the names of any ClassVars present in the type hints. + + The returned value is a tuple of two items: the fields dict, and the set of ClassVar names. + + Args: + cls: BaseModel or dataclass. + bases: Parents of the class, generally `cls.__bases__`. + config_wrapper: The config wrapper instance. + types_namespace: Optional extra namespace to look for types in. + typevars_map: A dictionary mapping type variables to their concrete types. + + Returns: + A tuple contains fields and class variables. + + Raises: + NameError: + - If there is a conflict between a field name and protected namespaces. + - If there is a field other than `root` in `RootModel`. + - If a field shadows an attribute in the parent model. + """ + from ..fields import FieldInfo + + type_hints = get_cls_type_hints_lenient(cls, types_namespace) + + # https://docs.python.org/3/howto/annotations.html#accessing-the-annotations-dict-of-an-object-in-python-3-9-and-older + # annotations is only used for finding fields in parent classes + annotations = cls.__dict__.get('__annotations__', {}) + fields: dict[str, FieldInfo] = {} + + class_vars: set[str] = set() + for ann_name, ann_type in type_hints.items(): + if ann_name == 'model_config': + # We never want to treat `model_config` as a field + # Note: we may need to change this logic if/when we introduce a `BareModel` class with no + # protected namespaces (where `model_config` might be allowed as a field name) + continue + for protected_namespace in config_wrapper.protected_namespaces: + if ann_name.startswith(protected_namespace): + for b in bases: + if hasattr(b, ann_name): + from ..main import BaseModel + + if not (issubclass(b, BaseModel) and ann_name in b.model_fields): + raise NameError( + f'Field "{ann_name}" conflicts with member {getattr(b, ann_name)}' + f' of protected namespace "{protected_namespace}".' + ) + else: + valid_namespaces = tuple( + x for x in config_wrapper.protected_namespaces if not ann_name.startswith(x) + ) + warnings.warn( + f'Field "{ann_name}" has conflict with protected namespace "{protected_namespace}".' + '\n\nYou may be able to resolve this warning by setting' + f" `model_config['protected_namespaces'] = {valid_namespaces}`.", + UserWarning, + ) + if is_classvar(ann_type): + class_vars.add(ann_name) + continue + if _is_finalvar_with_default_val(ann_type, getattr(cls, ann_name, PydanticUndefined)): + class_vars.add(ann_name) + continue + if not is_valid_field_name(ann_name): + continue + if cls.__pydantic_root_model__ and ann_name != 'root': + raise NameError( + f"Unexpected field with name {ann_name!r}; only 'root' is allowed as a field of a `RootModel`" + ) + + # when building a generic model with `MyModel[int]`, the generic_origin check makes sure we don't get + # "... shadows an attribute" warnings + generic_origin = getattr(cls, '__pydantic_generic_metadata__', {}).get('origin') + for base in bases: + dataclass_fields = { + field.name for field in (dataclasses.fields(base) if dataclasses.is_dataclass(base) else ()) + } + if hasattr(base, ann_name): + if base is generic_origin: + # Don't warn when "shadowing" of attributes in parametrized generics + continue + + if ann_name in dataclass_fields: + # Don't warn when inheriting stdlib dataclasses whose fields are "shadowed" by defaults being set + # on the class instance. + continue + + if ann_name not in annotations: + # Don't warn when a field exists in a parent class but has not been defined in the current class + continue + + warnings.warn( + f'Field name "{ann_name}" in "{cls.__qualname__}" shadows an attribute in parent ' + f'"{base.__qualname__}"', + UserWarning, + ) + + try: + default = getattr(cls, ann_name, PydanticUndefined) + if default is PydanticUndefined: + raise AttributeError + except AttributeError: + if ann_name in annotations: + field_info = FieldInfo.from_annotation(ann_type) + else: + # if field has no default value and is not in __annotations__ this means that it is + # defined in a base class and we can take it from there + model_fields_lookup: dict[str, FieldInfo] = {} + for x in cls.__bases__[::-1]: + model_fields_lookup.update(getattr(x, 'model_fields', {})) + if ann_name in model_fields_lookup: + # The field was present on one of the (possibly multiple) base classes + # copy the field to make sure typevar substitutions don't cause issues with the base classes + field_info = copy(model_fields_lookup[ann_name]) + else: + # The field was not found on any base classes; this seems to be caused by fields not getting + # generated thanks to models not being fully defined while initializing recursive models. + # Nothing stops us from just creating a new FieldInfo for this type hint, so we do this. + field_info = FieldInfo.from_annotation(ann_type) + else: + _warn_on_nested_alias_in_annotation(ann_type, ann_name) + field_info = FieldInfo.from_annotated_attribute(ann_type, default) + # attributes which are fields are removed from the class namespace: + # 1. To match the behaviour of annotation-only fields + # 2. To avoid false positives in the NameError check above + try: + delattr(cls, ann_name) + except AttributeError: + pass # indicates the attribute was on a parent class + + # Use cls.__dict__['__pydantic_decorators__'] instead of cls.__pydantic_decorators__ + # to make sure the decorators have already been built for this exact class + decorators: DecoratorInfos = cls.__dict__['__pydantic_decorators__'] + if ann_name in decorators.computed_fields: + raise ValueError("you can't override a field with a computed field") + fields[ann_name] = field_info + + if typevars_map: + for field in fields.values(): + field.apply_typevars_map(typevars_map, types_namespace) + + _update_fields_from_docstrings(cls, fields, config_wrapper) + + return fields, class_vars + + +def _warn_on_nested_alias_in_annotation(ann_type: type[Any], ann_name: str): + from ..fields import FieldInfo + + if hasattr(ann_type, '__args__'): + for anno_arg in ann_type.__args__: + if _typing_extra.is_annotated(anno_arg): + for anno_type_arg in _typing_extra.get_args(anno_arg): + if isinstance(anno_type_arg, FieldInfo) and anno_type_arg.alias is not None: + warnings.warn( + f'`alias` specification on field "{ann_name}" must be set on outermost annotation to take effect.', + UserWarning, + ) + break + + +def _is_finalvar_with_default_val(type_: type[Any], val: Any) -> bool: + from ..fields import FieldInfo + + if not is_finalvar(type_): + return False + elif val is PydanticUndefined: + return False + elif isinstance(val, FieldInfo) and (val.default is PydanticUndefined and val.default_factory is None): + return False + else: + return True + + +def collect_dataclass_fields( + cls: type[StandardDataclass], + types_namespace: dict[str, Any] | None, + *, + typevars_map: dict[Any, Any] | None = None, + config_wrapper: ConfigWrapper | None = None, +) -> dict[str, FieldInfo]: + """Collect the fields of a dataclass. + + Args: + cls: dataclass. + types_namespace: Optional extra namespace to look for types in. + typevars_map: A dictionary mapping type variables to their concrete types. + config_wrapper: The config wrapper instance. + + Returns: + The dataclass fields. + """ + from ..fields import FieldInfo + + fields: dict[str, FieldInfo] = {} + dataclass_fields: dict[str, dataclasses.Field] = cls.__dataclass_fields__ + cls_localns = dict(vars(cls)) # this matches get_cls_type_hints_lenient, but all tests pass with `= None` instead + + source_module = sys.modules.get(cls.__module__) + if source_module is not None: + types_namespace = {**source_module.__dict__, **(types_namespace or {})} + + for ann_name, dataclass_field in dataclass_fields.items(): + ann_type = _typing_extra.eval_type_lenient(dataclass_field.type, types_namespace, cls_localns) + if is_classvar(ann_type): + continue + + if ( + not dataclass_field.init + and dataclass_field.default == dataclasses.MISSING + and dataclass_field.default_factory == dataclasses.MISSING + ): + # TODO: We should probably do something with this so that validate_assignment behaves properly + # Issue: https://github.com/pydantic/pydantic/issues/5470 + continue + + if isinstance(dataclass_field.default, FieldInfo): + if dataclass_field.default.init_var: + if dataclass_field.default.init is False: + raise PydanticUserError( + f'Dataclass field {ann_name} has init=False and init_var=True, but these are mutually exclusive.', + code='clashing-init-and-init-var', + ) + + # TODO: same note as above re validate_assignment + continue + field_info = FieldInfo.from_annotated_attribute(ann_type, dataclass_field.default) + else: + field_info = FieldInfo.from_annotated_attribute(ann_type, dataclass_field) + + fields[ann_name] = field_info + + if field_info.default is not PydanticUndefined and isinstance(getattr(cls, ann_name, field_info), FieldInfo): + # We need this to fix the default when the "default" from __dataclass_fields__ is a pydantic.FieldInfo + setattr(cls, ann_name, field_info.default) + + if typevars_map: + for field in fields.values(): + field.apply_typevars_map(typevars_map, types_namespace) + + if config_wrapper is not None: + _update_fields_from_docstrings(cls, fields, config_wrapper) + + return fields + + +def is_valid_field_name(name: str) -> bool: + return not name.startswith('_') + + +def is_valid_privateattr_name(name: str) -> bool: + return name.startswith('_') and not name.startswith('__') diff --git a/env/Lib/site-packages/pydantic/_internal/_forward_ref.py b/env/Lib/site-packages/pydantic/_internal/_forward_ref.py new file mode 100644 index 0000000..231f81d --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_forward_ref.py @@ -0,0 +1,23 @@ +from __future__ import annotations as _annotations + +from dataclasses import dataclass +from typing import Union + + +@dataclass +class PydanticRecursiveRef: + type_ref: str + + __name__ = 'PydanticRecursiveRef' + __hash__ = object.__hash__ + + def __call__(self) -> None: + """Defining __call__ is necessary for the `typing` module to let you use an instance of + this class as the result of resolving a standard ForwardRef. + """ + + def __or__(self, other): + return Union[self, other] # type: ignore + + def __ror__(self, other): + return Union[other, self] # type: ignore diff --git a/env/Lib/site-packages/pydantic/_internal/_generate_schema.py b/env/Lib/site-packages/pydantic/_internal/_generate_schema.py new file mode 100644 index 0000000..edd8e72 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_generate_schema.py @@ -0,0 +1,2376 @@ +"""Convert python types to pydantic-core schema.""" + +from __future__ import annotations as _annotations + +import collections.abc +import dataclasses +import inspect +import re +import sys +import typing +import warnings +from contextlib import ExitStack, contextmanager +from copy import copy, deepcopy +from enum import Enum +from functools import partial +from inspect import Parameter, _ParameterKind, signature +from itertools import chain +from operator import attrgetter +from types import FunctionType, LambdaType, MethodType +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Dict, + Final, + ForwardRef, + Iterable, + Iterator, + Mapping, + Type, + TypeVar, + Union, + cast, + overload, +) +from warnings import warn + +from pydantic_core import CoreSchema, PydanticUndefined, core_schema, to_jsonable_python +from typing_extensions import Annotated, Literal, TypeAliasType, TypedDict, get_args, get_origin, is_typeddict + +from ..aliases import AliasGenerator +from ..annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler +from ..config import ConfigDict, JsonDict, JsonEncoder +from ..errors import PydanticSchemaGenerationError, PydanticUndefinedAnnotation, PydanticUserError +from ..json_schema import JsonSchemaValue +from ..version import version_short +from ..warnings import PydanticDeprecatedSince20 +from . import _core_utils, _decorators, _discriminated_union, _known_annotated_metadata, _typing_extra +from ._config import ConfigWrapper, ConfigWrapperStack +from ._core_metadata import CoreMetadataHandler, build_metadata_dict +from ._core_utils import ( + CoreSchemaOrField, + collect_invalid_schemas, + define_expected_missing_refs, + get_ref, + get_type_ref, + is_function_with_inner_schema, + is_list_like_schema_with_items_schema, + simplify_schema_references, + validate_core_schema, +) +from ._decorators import ( + Decorator, + DecoratorInfos, + FieldSerializerDecoratorInfo, + FieldValidatorDecoratorInfo, + ModelSerializerDecoratorInfo, + ModelValidatorDecoratorInfo, + RootValidatorDecoratorInfo, + ValidatorDecoratorInfo, + get_attribute_from_bases, + inspect_field_serializer, + inspect_model_serializer, + inspect_validator, +) +from ._docs_extraction import extract_docstrings_from_cls +from ._fields import collect_dataclass_fields, get_type_hints_infer_globalns +from ._forward_ref import PydanticRecursiveRef +from ._generics import get_standard_typevars_map, has_instance_in_type, recursively_defined_type_refs, replace_types +from ._mock_val_ser import MockCoreSchema +from ._schema_generation_shared import CallbackGetCoreSchemaHandler +from ._typing_extra import is_finalvar, is_self_type +from ._utils import lenient_issubclass + +if TYPE_CHECKING: + from ..fields import ComputedFieldInfo, FieldInfo + from ..main import BaseModel + from ..types import Discriminator + from ..validators import FieldValidatorModes + from ._dataclasses import StandardDataclass + from ._schema_generation_shared import GetJsonSchemaFunction + +_SUPPORTS_TYPEDDICT = sys.version_info >= (3, 12) +_AnnotatedType = type(Annotated[int, 123]) + +FieldDecoratorInfo = Union[ValidatorDecoratorInfo, FieldValidatorDecoratorInfo, FieldSerializerDecoratorInfo] +FieldDecoratorInfoType = TypeVar('FieldDecoratorInfoType', bound=FieldDecoratorInfo) +AnyFieldDecorator = Union[ + Decorator[ValidatorDecoratorInfo], + Decorator[FieldValidatorDecoratorInfo], + Decorator[FieldSerializerDecoratorInfo], +] + +ModifyCoreSchemaWrapHandler = GetCoreSchemaHandler +GetCoreSchemaFunction = Callable[[Any, ModifyCoreSchemaWrapHandler], core_schema.CoreSchema] + +TUPLE_TYPES: list[type] = [tuple, typing.Tuple] +LIST_TYPES: list[type] = [list, typing.List, collections.abc.MutableSequence] +SET_TYPES: list[type] = [set, typing.Set, collections.abc.MutableSet] +FROZEN_SET_TYPES: list[type] = [frozenset, typing.FrozenSet, collections.abc.Set] +DICT_TYPES: list[type] = [dict, typing.Dict, collections.abc.MutableMapping, collections.abc.Mapping] + + +def check_validator_fields_against_field_name( + info: FieldDecoratorInfo, + field: str, +) -> bool: + """Check if field name is in validator fields. + + Args: + info: The field info. + field: The field name to check. + + Returns: + `True` if field name is in validator fields, `False` otherwise. + """ + if '*' in info.fields: + return True + for v_field_name in info.fields: + if v_field_name == field: + return True + return False + + +def check_decorator_fields_exist(decorators: Iterable[AnyFieldDecorator], fields: Iterable[str]) -> None: + """Check if the defined fields in decorators exist in `fields` param. + + It ignores the check for a decorator if the decorator has `*` as field or `check_fields=False`. + + Args: + decorators: An iterable of decorators. + fields: An iterable of fields name. + + Raises: + PydanticUserError: If one of the field names does not exist in `fields` param. + """ + fields = set(fields) + for dec in decorators: + if '*' in dec.info.fields: + continue + if dec.info.check_fields is False: + continue + for field in dec.info.fields: + if field not in fields: + raise PydanticUserError( + f'Decorators defined with incorrect fields: {dec.cls_ref}.{dec.cls_var_name}' + " (use check_fields=False if you're inheriting from the model and intended this)", + code='decorator-missing-field', + ) + + +def filter_field_decorator_info_by_field( + validator_functions: Iterable[Decorator[FieldDecoratorInfoType]], field: str +) -> list[Decorator[FieldDecoratorInfoType]]: + return [dec for dec in validator_functions if check_validator_fields_against_field_name(dec.info, field)] + + +def apply_each_item_validators( + schema: core_schema.CoreSchema, + each_item_validators: list[Decorator[ValidatorDecoratorInfo]], + field_name: str | None, +) -> core_schema.CoreSchema: + # This V1 compatibility shim should eventually be removed + + # push down any `each_item=True` validators + # note that this won't work for any Annotated types that get wrapped by a function validator + # but that's okay because that didn't exist in V1 + if schema['type'] == 'nullable': + schema['schema'] = apply_each_item_validators(schema['schema'], each_item_validators, field_name) + return schema + elif schema['type'] == 'tuple': + if (variadic_item_index := schema.get('variadic_item_index')) is not None: + schema['items_schema'][variadic_item_index] = apply_validators( + schema['items_schema'][variadic_item_index], each_item_validators, field_name + ) + elif is_list_like_schema_with_items_schema(schema): + inner_schema = schema.get('items_schema', None) + if inner_schema is None: + inner_schema = core_schema.any_schema() + schema['items_schema'] = apply_validators(inner_schema, each_item_validators, field_name) + elif schema['type'] == 'dict': + # push down any `each_item=True` validators onto dict _values_ + # this is super arbitrary but it's the V1 behavior + inner_schema = schema.get('values_schema', None) + if inner_schema is None: + inner_schema = core_schema.any_schema() + schema['values_schema'] = apply_validators(inner_schema, each_item_validators, field_name) + elif each_item_validators: + raise TypeError( + f"`@validator(..., each_item=True)` cannot be applied to fields with a schema of {schema['type']}" + ) + return schema + + +def modify_model_json_schema( + schema_or_field: CoreSchemaOrField, + handler: GetJsonSchemaHandler, + *, + cls: Any, + title: str | None = None, +) -> JsonSchemaValue: + """Add title and description for model-like classes' JSON schema. + + Args: + schema_or_field: The schema data to generate a JSON schema from. + handler: The `GetCoreSchemaHandler` instance. + cls: The model-like class. + title: The title to set for the model's schema, defaults to the model's name + + Returns: + JsonSchemaValue: The updated JSON schema. + """ + from ..dataclasses import is_pydantic_dataclass + from ..main import BaseModel + from ..root_model import RootModel + from ._dataclasses import is_builtin_dataclass + + json_schema = handler(schema_or_field) + original_schema = handler.resolve_ref_schema(json_schema) + # Preserve the fact that definitions schemas should never have sibling keys: + if '$ref' in original_schema: + ref = original_schema['$ref'] + original_schema.clear() + original_schema['allOf'] = [{'$ref': ref}] + if title is not None: + original_schema['title'] = title + elif 'title' not in original_schema: + original_schema['title'] = cls.__name__ + # BaseModel + Dataclass; don't use cls.__doc__ as it will contain the verbose class signature by default + docstring = None if cls is BaseModel or is_builtin_dataclass(cls) or is_pydantic_dataclass(cls) else cls.__doc__ + if docstring and 'description' not in original_schema: + original_schema['description'] = inspect.cleandoc(docstring) + elif issubclass(cls, RootModel) and cls.model_fields['root'].description: + original_schema['description'] = cls.model_fields['root'].description + return json_schema + + +JsonEncoders = Dict[Type[Any], JsonEncoder] + + +def _add_custom_serialization_from_json_encoders( + json_encoders: JsonEncoders | None, tp: Any, schema: CoreSchema +) -> CoreSchema: + """Iterate over the json_encoders and add the first matching encoder to the schema. + + Args: + json_encoders: A dictionary of types and their encoder functions. + tp: The type to check for a matching encoder. + schema: The schema to add the encoder to. + """ + if not json_encoders: + return schema + if 'serialization' in schema: + return schema + # Check the class type and its superclasses for a matching encoder + # Decimal.__class__.__mro__ (and probably other cases) doesn't include Decimal itself + # if the type is a GenericAlias (e.g. from list[int]) we need to use __class__ instead of .__mro__ + for base in (tp, *getattr(tp, '__mro__', tp.__class__.__mro__)[:-1]): + encoder = json_encoders.get(base) + if encoder is None: + continue + + warnings.warn( + f'`json_encoders` is deprecated. See https://docs.pydantic.dev/{version_short()}/concepts/serialization/#custom-serializers for alternatives', + PydanticDeprecatedSince20, + ) + + # TODO: in theory we should check that the schema accepts a serialization key + schema['serialization'] = core_schema.plain_serializer_function_ser_schema(encoder, when_used='json') + return schema + + return schema + + +TypesNamespace = Union[Dict[str, Any], None] + + +class TypesNamespaceStack: + """A stack of types namespaces.""" + + def __init__(self, types_namespace: TypesNamespace): + self._types_namespace_stack: list[TypesNamespace] = [types_namespace] + + @property + def tail(self) -> TypesNamespace: + return self._types_namespace_stack[-1] + + @contextmanager + def push(self, for_type: type[Any]): + types_namespace = {**_typing_extra.get_cls_types_namespace(for_type), **(self.tail or {})} + self._types_namespace_stack.append(types_namespace) + try: + yield + finally: + self._types_namespace_stack.pop() + + +def _get_first_non_null(a: Any, b: Any) -> Any: + """Return the first argument if it is not None, otherwise return the second argument. + + Use case: serialization_alias (argument a) and alias (argument b) are both defined, and serialization_alias is ''. + This function will return serialization_alias, which is the first argument, even though it is an empty string. + """ + return a if a is not None else b + + +class GenerateSchema: + """Generate core schema for a Pydantic model, dataclass and types like `str`, `datetime`, ... .""" + + __slots__ = ( + '_config_wrapper_stack', + '_types_namespace_stack', + '_typevars_map', + 'field_name_stack', + 'model_type_stack', + 'defs', + ) + + def __init__( + self, + config_wrapper: ConfigWrapper, + types_namespace: dict[str, Any] | None, + typevars_map: dict[Any, Any] | None = None, + ) -> None: + # we need a stack for recursing into child models + self._config_wrapper_stack = ConfigWrapperStack(config_wrapper) + self._types_namespace_stack = TypesNamespaceStack(types_namespace) + self._typevars_map = typevars_map + self.field_name_stack = _FieldNameStack() + self.model_type_stack = _ModelTypeStack() + self.defs = _Definitions() + + @classmethod + def __from_parent( + cls, + config_wrapper_stack: ConfigWrapperStack, + types_namespace_stack: TypesNamespaceStack, + model_type_stack: _ModelTypeStack, + typevars_map: dict[Any, Any] | None, + defs: _Definitions, + ) -> GenerateSchema: + obj = cls.__new__(cls) + obj._config_wrapper_stack = config_wrapper_stack + obj._types_namespace_stack = types_namespace_stack + obj.model_type_stack = model_type_stack + obj._typevars_map = typevars_map + obj.field_name_stack = _FieldNameStack() + obj.defs = defs + return obj + + @property + def _config_wrapper(self) -> ConfigWrapper: + return self._config_wrapper_stack.tail + + @property + def _types_namespace(self) -> dict[str, Any] | None: + return self._types_namespace_stack.tail + + @property + def _current_generate_schema(self) -> GenerateSchema: + cls = self._config_wrapper.schema_generator or GenerateSchema + return cls.__from_parent( + self._config_wrapper_stack, + self._types_namespace_stack, + self.model_type_stack, + self._typevars_map, + self.defs, + ) + + @property + def _arbitrary_types(self) -> bool: + return self._config_wrapper.arbitrary_types_allowed + + def str_schema(self) -> CoreSchema: + """Generate a CoreSchema for `str`""" + return core_schema.str_schema() + + # the following methods can be overridden but should be considered + # unstable / private APIs + def _list_schema(self, tp: Any, items_type: Any) -> CoreSchema: + return core_schema.list_schema(self.generate_schema(items_type)) + + def _dict_schema(self, tp: Any, keys_type: Any, values_type: Any) -> CoreSchema: + return core_schema.dict_schema(self.generate_schema(keys_type), self.generate_schema(values_type)) + + def _set_schema(self, tp: Any, items_type: Any) -> CoreSchema: + return core_schema.set_schema(self.generate_schema(items_type)) + + def _frozenset_schema(self, tp: Any, items_type: Any) -> CoreSchema: + return core_schema.frozenset_schema(self.generate_schema(items_type)) + + def _arbitrary_type_schema(self, tp: Any) -> CoreSchema: + if not isinstance(tp, type): + warn( + f'{tp!r} is not a Python type (it may be an instance of an object),' + ' Pydantic will allow any object with no validation since we cannot even' + ' enforce that the input is an instance of the given type.' + ' To get rid of this error wrap the type with `pydantic.SkipValidation`.', + UserWarning, + ) + return core_schema.any_schema() + return core_schema.is_instance_schema(tp) + + def _unknown_type_schema(self, obj: Any) -> CoreSchema: + raise PydanticSchemaGenerationError( + f'Unable to generate pydantic-core schema for {obj!r}. ' + 'Set `arbitrary_types_allowed=True` in the model_config to ignore this error' + ' or implement `__get_pydantic_core_schema__` on your type to fully support it.' + '\n\nIf you got this error by calling handler() within' + ' `__get_pydantic_core_schema__` then you likely need to call' + ' `handler.generate_schema()` since we do not call' + ' `__get_pydantic_core_schema__` on `` otherwise to avoid infinite recursion.' + ) + + def _apply_discriminator_to_union( + self, schema: CoreSchema, discriminator: str | Discriminator | None + ) -> CoreSchema: + if discriminator is None: + return schema + try: + return _discriminated_union.apply_discriminator( + schema, + discriminator, + ) + except _discriminated_union.MissingDefinitionForUnionRef: + # defer until defs are resolved + _discriminated_union.set_discriminator_in_metadata( + schema, + discriminator, + ) + return schema + + class CollectedInvalid(Exception): + pass + + def clean_schema(self, schema: CoreSchema) -> CoreSchema: + schema = self.collect_definitions(schema) + schema = simplify_schema_references(schema) + if collect_invalid_schemas(schema): + raise self.CollectedInvalid() + schema = _discriminated_union.apply_discriminators(schema) + schema = validate_core_schema(schema) + return schema + + def collect_definitions(self, schema: CoreSchema) -> CoreSchema: + ref = cast('str | None', schema.get('ref', None)) + if ref: + self.defs.definitions[ref] = schema + if 'ref' in schema: + schema = core_schema.definition_reference_schema(schema['ref']) + return core_schema.definitions_schema( + schema, + list(self.defs.definitions.values()), + ) + + def _add_js_function(self, metadata_schema: CoreSchema, js_function: Callable[..., Any]) -> None: + metadata = CoreMetadataHandler(metadata_schema).metadata + pydantic_js_functions = metadata.setdefault('pydantic_js_functions', []) + # because of how we generate core schemas for nested generic models + # we can end up adding `BaseModel.__get_pydantic_json_schema__` multiple times + # this check may fail to catch duplicates if the function is a `functools.partial` + # or something like that + # but if it does it'll fail by inserting the duplicate + if js_function not in pydantic_js_functions: + pydantic_js_functions.append(js_function) + + def generate_schema( + self, + obj: Any, + from_dunder_get_core_schema: bool = True, + ) -> core_schema.CoreSchema: + """Generate core schema. + + Args: + obj: The object to generate core schema for. + from_dunder_get_core_schema: Whether to generate schema from either the + `__get_pydantic_core_schema__` function or `__pydantic_core_schema__` property. + + Returns: + The generated core schema. + + Raises: + PydanticUndefinedAnnotation: + If it is not possible to evaluate forward reference. + PydanticSchemaGenerationError: + If it is not possible to generate pydantic-core schema. + TypeError: + - If `alias_generator` returns a disallowed type (must be str, AliasPath or AliasChoices). + - If V1 style validator with `each_item=True` applied on a wrong field. + PydanticUserError: + - If `typing.TypedDict` is used instead of `typing_extensions.TypedDict` on Python < 3.12. + - If `__modify_schema__` method is used instead of `__get_pydantic_json_schema__`. + """ + schema: CoreSchema | None = None + + if from_dunder_get_core_schema: + from_property = self._generate_schema_from_property(obj, obj) + if from_property is not None: + schema = from_property + + if schema is None: + schema = self._generate_schema_inner(obj) + + metadata_js_function = _extract_get_pydantic_json_schema(obj, schema) + if metadata_js_function is not None: + metadata_schema = resolve_original_schema(schema, self.defs.definitions) + if metadata_schema: + self._add_js_function(metadata_schema, metadata_js_function) + + schema = _add_custom_serialization_from_json_encoders(self._config_wrapper.json_encoders, obj, schema) + + return schema + + def _model_schema(self, cls: type[BaseModel]) -> core_schema.CoreSchema: + """Generate schema for a Pydantic model.""" + with self.defs.get_schema_or_ref(cls) as (model_ref, maybe_schema): + if maybe_schema is not None: + return maybe_schema + + fields = cls.model_fields + decorators = cls.__pydantic_decorators__ + computed_fields = decorators.computed_fields + check_decorator_fields_exist( + chain( + decorators.field_validators.values(), + decorators.field_serializers.values(), + decorators.validators.values(), + ), + {*fields.keys(), *computed_fields.keys()}, + ) + config_wrapper = ConfigWrapper(cls.model_config, check=False) + core_config = config_wrapper.core_config(cls) + title = self._get_model_title_from_config(cls, config_wrapper) + metadata = build_metadata_dict(js_functions=[partial(modify_model_json_schema, cls=cls, title=title)]) + + model_validators = decorators.model_validators.values() + + extras_schema = None + if core_config.get('extra_fields_behavior') == 'allow': + assert cls.__mro__[0] is cls + assert cls.__mro__[-1] is object + for candidate_cls in cls.__mro__[:-1]: + extras_annotation = getattr(candidate_cls, '__annotations__', {}).get('__pydantic_extra__', None) + if extras_annotation is not None: + if isinstance(extras_annotation, str): + extras_annotation = _typing_extra.eval_type_backport( + _typing_extra._make_forward_ref(extras_annotation, is_argument=False, is_class=True), + self._types_namespace, + ) + tp = get_origin(extras_annotation) + if tp not in (Dict, dict): + raise PydanticSchemaGenerationError( + 'The type annotation for `__pydantic_extra__` must be `Dict[str, ...]`' + ) + extra_items_type = self._get_args_resolving_forward_refs( + extras_annotation, + required=True, + )[1] + if extra_items_type is not Any: + extras_schema = self.generate_schema(extra_items_type) + break + + with self._config_wrapper_stack.push(config_wrapper), self._types_namespace_stack.push(cls): + self = self._current_generate_schema + if cls.__pydantic_root_model__: + root_field = self._common_field_schema('root', fields['root'], decorators) + inner_schema = root_field['schema'] + inner_schema = apply_model_validators(inner_schema, model_validators, 'inner') + model_schema = core_schema.model_schema( + cls, + inner_schema, + custom_init=getattr(cls, '__pydantic_custom_init__', None), + root_model=True, + post_init=getattr(cls, '__pydantic_post_init__', None), + config=core_config, + ref=model_ref, + metadata=metadata, + ) + else: + fields_schema: core_schema.CoreSchema = core_schema.model_fields_schema( + {k: self._generate_md_field_schema(k, v, decorators) for k, v in fields.items()}, + computed_fields=[ + self._computed_field_schema(d, decorators.field_serializers) + for d in computed_fields.values() + ], + extras_schema=extras_schema, + model_name=cls.__name__, + ) + inner_schema = apply_validators(fields_schema, decorators.root_validators.values(), None) + new_inner_schema = define_expected_missing_refs(inner_schema, recursively_defined_type_refs()) + if new_inner_schema is not None: + inner_schema = new_inner_schema + inner_schema = apply_model_validators(inner_schema, model_validators, 'inner') + + model_schema = core_schema.model_schema( + cls, + inner_schema, + custom_init=getattr(cls, '__pydantic_custom_init__', None), + root_model=False, + post_init=getattr(cls, '__pydantic_post_init__', None), + config=core_config, + ref=model_ref, + metadata=metadata, + ) + + schema = self._apply_model_serializers(model_schema, decorators.model_serializers.values()) + schema = apply_model_validators(schema, model_validators, 'outer') + self.defs.definitions[model_ref] = schema + return core_schema.definition_reference_schema(model_ref) + + @staticmethod + def _get_model_title_from_config( + model: type[BaseModel | StandardDataclass], config_wrapper: ConfigWrapper | None = None + ) -> str | None: + """Get the title of a model if `model_title_generator` or `title` are set in the config, else return None""" + if config_wrapper is None: + return None + + if config_wrapper.title: + return config_wrapper.title + + model_title_generator = config_wrapper.model_title_generator + if model_title_generator: + title = model_title_generator(model) + if not isinstance(title, str): + raise TypeError(f'model_title_generator {model_title_generator} must return str, not {title.__class__}') + return title + + return None + + def _unpack_refs_defs(self, schema: CoreSchema) -> CoreSchema: + """Unpack all 'definitions' schemas into `GenerateSchema.defs.definitions` + and return the inner schema. + """ + + def get_ref(s: CoreSchema) -> str: + return s['ref'] # type: ignore + + if schema['type'] == 'definitions': + self.defs.definitions.update({get_ref(s): s for s in schema['definitions']}) + schema = schema['schema'] + return schema + + def _generate_schema_from_property(self, obj: Any, source: Any) -> core_schema.CoreSchema | None: + """Try to generate schema from either the `__get_pydantic_core_schema__` function or + `__pydantic_core_schema__` property. + + Note: `__get_pydantic_core_schema__` takes priority so it can + decide whether to use a `__pydantic_core_schema__` attribute, or generate a fresh schema. + """ + # avoid calling `__get_pydantic_core_schema__` if we've already visited this object + if is_self_type(obj): + obj = self.model_type_stack.get() + with self.defs.get_schema_or_ref(obj) as (_, maybe_schema): + if maybe_schema is not None: + return maybe_schema + if obj is source: + ref_mode = 'unpack' + else: + ref_mode = 'to-def' + + schema: CoreSchema + + if (get_schema := getattr(obj, '__get_pydantic_core_schema__', None)) is not None: + if len(inspect.signature(get_schema).parameters) == 1: + # (source) -> CoreSchema + schema = get_schema(source) + else: + schema = get_schema( + source, CallbackGetCoreSchemaHandler(self._generate_schema_inner, self, ref_mode=ref_mode) + ) + # fmt: off + elif ( + (existing_schema := getattr(obj, '__pydantic_core_schema__', None)) is not None + and not isinstance(existing_schema, MockCoreSchema) + and existing_schema.get('cls', None) == obj + ): + schema = existing_schema + # fmt: on + elif (validators := getattr(obj, '__get_validators__', None)) is not None: + warn( + '`__get_validators__` is deprecated and will be removed, use `__get_pydantic_core_schema__` instead.', + PydanticDeprecatedSince20, + ) + schema = core_schema.chain_schema([core_schema.with_info_plain_validator_function(v) for v in validators()]) + else: + # we have no existing schema information on the property, exit early so that we can go generate a schema + return None + + schema = self._unpack_refs_defs(schema) + + if is_function_with_inner_schema(schema): + ref = schema['schema'].pop('ref', None) # pyright: ignore[reportCallIssue, reportArgumentType] + if ref: + schema['ref'] = ref + else: + ref = get_ref(schema) + + if ref: + self.defs.definitions[ref] = schema + return core_schema.definition_reference_schema(ref) + + return schema + + def _resolve_forward_ref(self, obj: Any) -> Any: + # we assume that types_namespace has the target of forward references in its scope, + # but this could fail, for example, if calling Validator on an imported type which contains + # forward references to other types only defined in the module from which it was imported + # `Validator(SomeImportedTypeAliasWithAForwardReference)` + # or the equivalent for BaseModel + # class Model(BaseModel): + # x: SomeImportedTypeAliasWithAForwardReference + try: + obj = _typing_extra.eval_type_backport(obj, globalns=self._types_namespace) + except NameError as e: + raise PydanticUndefinedAnnotation.from_name_error(e) from e + + # if obj is still a ForwardRef, it means we can't evaluate it, raise PydanticUndefinedAnnotation + if isinstance(obj, ForwardRef): + raise PydanticUndefinedAnnotation(obj.__forward_arg__, f'Unable to evaluate forward reference {obj}') + + if self._typevars_map: + obj = replace_types(obj, self._typevars_map) + + return obj + + @overload + def _get_args_resolving_forward_refs(self, obj: Any, required: Literal[True]) -> tuple[Any, ...]: ... + + @overload + def _get_args_resolving_forward_refs(self, obj: Any) -> tuple[Any, ...] | None: ... + + def _get_args_resolving_forward_refs(self, obj: Any, required: bool = False) -> tuple[Any, ...] | None: + args = get_args(obj) + if args: + args = tuple([self._resolve_forward_ref(a) if isinstance(a, ForwardRef) else a for a in args]) + elif required: # pragma: no cover + raise TypeError(f'Expected {obj} to have generic parameters but it had none') + return args + + def _get_first_arg_or_any(self, obj: Any) -> Any: + args = self._get_args_resolving_forward_refs(obj) + if not args: + return Any + return args[0] + + def _get_first_two_args_or_any(self, obj: Any) -> tuple[Any, Any]: + args = self._get_args_resolving_forward_refs(obj) + if not args: + return (Any, Any) + if len(args) < 2: + origin = get_origin(obj) + raise TypeError(f'Expected two type arguments for {origin}, got 1') + return args[0], args[1] + + def _generate_schema_inner(self, obj: Any) -> core_schema.CoreSchema: + if isinstance(obj, _AnnotatedType): + return self._annotated_schema(obj) + + if isinstance(obj, dict): + # we assume this is already a valid schema + return obj # type: ignore[return-value] + + if isinstance(obj, str): + obj = ForwardRef(obj) + + if isinstance(obj, ForwardRef): + return self.generate_schema(self._resolve_forward_ref(obj)) + + from ..main import BaseModel + + if lenient_issubclass(obj, BaseModel): + with self.model_type_stack.push(obj): + return self._model_schema(obj) + + if isinstance(obj, PydanticRecursiveRef): + return core_schema.definition_reference_schema(schema_ref=obj.type_ref) + + return self.match_type(obj) + + def match_type(self, obj: Any) -> core_schema.CoreSchema: # noqa: C901 + """Main mapping of types to schemas. + + The general structure is a series of if statements starting with the simple cases + (non-generic primitive types) and then handling generics and other more complex cases. + + Each case either generates a schema directly, calls into a public user-overridable method + (like `GenerateSchema.tuple_variable_schema`) or calls into a private method that handles some + boilerplate before calling into the user-facing method (e.g. `GenerateSchema._tuple_schema`). + + The idea is that we'll evolve this into adding more and more user facing methods over time + as they get requested and we figure out what the right API for them is. + """ + if obj is str: + return self.str_schema() + elif obj is bytes: + return core_schema.bytes_schema() + elif obj is int: + return core_schema.int_schema() + elif obj is float: + return core_schema.float_schema() + elif obj is bool: + return core_schema.bool_schema() + elif obj is Any or obj is object: + return core_schema.any_schema() + elif obj is None or obj is _typing_extra.NoneType: + return core_schema.none_schema() + elif obj in TUPLE_TYPES: + return self._tuple_schema(obj) + elif obj in LIST_TYPES: + return self._list_schema(obj, self._get_first_arg_or_any(obj)) + elif obj in SET_TYPES: + return self._set_schema(obj, self._get_first_arg_or_any(obj)) + elif obj in FROZEN_SET_TYPES: + return self._frozenset_schema(obj, self._get_first_arg_or_any(obj)) + elif obj in DICT_TYPES: + return self._dict_schema(obj, *self._get_first_two_args_or_any(obj)) + elif isinstance(obj, TypeAliasType): + return self._type_alias_type_schema(obj) + elif obj is type: + return self._type_schema() + elif _typing_extra.is_callable_type(obj): + return core_schema.callable_schema() + elif _typing_extra.is_literal_type(obj): + return self._literal_schema(obj) + elif is_typeddict(obj): + return self._typed_dict_schema(obj, None) + elif _typing_extra.is_namedtuple(obj): + return self._namedtuple_schema(obj, None) + elif _typing_extra.is_new_type(obj): + # NewType, can't use isinstance because it fails <3.10 + return self.generate_schema(obj.__supertype__) + elif obj == re.Pattern: + return self._pattern_schema(obj) + elif obj is collections.abc.Hashable or obj is typing.Hashable: + return self._hashable_schema() + elif isinstance(obj, typing.TypeVar): + return self._unsubstituted_typevar_schema(obj) + elif is_finalvar(obj): + if obj is Final: + return core_schema.any_schema() + return self.generate_schema( + self._get_first_arg_or_any(obj), + ) + elif isinstance(obj, (FunctionType, LambdaType, MethodType, partial)): + return self._callable_schema(obj) + elif inspect.isclass(obj) and issubclass(obj, Enum): + from ._std_types_schema import get_enum_core_schema + + return get_enum_core_schema(obj, self._config_wrapper.config_dict) + + if _typing_extra.is_dataclass(obj): + return self._dataclass_schema(obj, None) + res = self._get_prepare_pydantic_annotations_for_known_type(obj, ()) + if res is not None: + source_type, annotations = res + return self._apply_annotations(source_type, annotations) + + origin = get_origin(obj) + if origin is not None: + return self._match_generic_type(obj, origin) + + if self._arbitrary_types: + return self._arbitrary_type_schema(obj) + return self._unknown_type_schema(obj) + + def _match_generic_type(self, obj: Any, origin: Any) -> CoreSchema: # noqa: C901 + if isinstance(origin, TypeAliasType): + return self._type_alias_type_schema(obj) + + # Need to handle generic dataclasses before looking for the schema properties because attribute accesses + # on _GenericAlias delegate to the origin type, so lose the information about the concrete parametrization + # As a result, currently, there is no way to cache the schema for generic dataclasses. This may be possible + # to resolve by modifying the value returned by `Generic.__class_getitem__`, but that is a dangerous game. + if _typing_extra.is_dataclass(origin): + return self._dataclass_schema(obj, origin) + if _typing_extra.is_namedtuple(origin): + return self._namedtuple_schema(obj, origin) + + from_property = self._generate_schema_from_property(origin, obj) + if from_property is not None: + return from_property + + if _typing_extra.origin_is_union(origin): + return self._union_schema(obj) + elif origin in TUPLE_TYPES: + return self._tuple_schema(obj) + elif origin in LIST_TYPES: + return self._list_schema(obj, self._get_first_arg_or_any(obj)) + elif origin in SET_TYPES: + return self._set_schema(obj, self._get_first_arg_or_any(obj)) + elif origin in FROZEN_SET_TYPES: + return self._frozenset_schema(obj, self._get_first_arg_or_any(obj)) + elif origin in DICT_TYPES: + return self._dict_schema(obj, *self._get_first_two_args_or_any(obj)) + elif is_typeddict(origin): + return self._typed_dict_schema(obj, origin) + elif origin in (typing.Type, type): + return self._subclass_schema(obj) + elif origin in {typing.Sequence, collections.abc.Sequence}: + return self._sequence_schema(obj) + elif origin in {typing.Iterable, collections.abc.Iterable, typing.Generator, collections.abc.Generator}: + return self._iterable_schema(obj) + elif origin in (re.Pattern, typing.Pattern): + return self._pattern_schema(obj) + + if self._arbitrary_types: + return self._arbitrary_type_schema(origin) + return self._unknown_type_schema(obj) + + def _generate_td_field_schema( + self, + name: str, + field_info: FieldInfo, + decorators: DecoratorInfos, + *, + required: bool = True, + ) -> core_schema.TypedDictField: + """Prepare a TypedDictField to represent a model or typeddict field.""" + common_field = self._common_field_schema(name, field_info, decorators) + return core_schema.typed_dict_field( + common_field['schema'], + required=False if not field_info.is_required() else required, + serialization_exclude=common_field['serialization_exclude'], + validation_alias=common_field['validation_alias'], + serialization_alias=common_field['serialization_alias'], + metadata=common_field['metadata'], + ) + + def _generate_md_field_schema( + self, + name: str, + field_info: FieldInfo, + decorators: DecoratorInfos, + ) -> core_schema.ModelField: + """Prepare a ModelField to represent a model field.""" + common_field = self._common_field_schema(name, field_info, decorators) + return core_schema.model_field( + common_field['schema'], + serialization_exclude=common_field['serialization_exclude'], + validation_alias=common_field['validation_alias'], + serialization_alias=common_field['serialization_alias'], + frozen=common_field['frozen'], + metadata=common_field['metadata'], + ) + + def _generate_dc_field_schema( + self, + name: str, + field_info: FieldInfo, + decorators: DecoratorInfos, + ) -> core_schema.DataclassField: + """Prepare a DataclassField to represent the parameter/field, of a dataclass.""" + common_field = self._common_field_schema(name, field_info, decorators) + return core_schema.dataclass_field( + name, + common_field['schema'], + init=field_info.init, + init_only=field_info.init_var or None, + kw_only=None if field_info.kw_only else False, + serialization_exclude=common_field['serialization_exclude'], + validation_alias=common_field['validation_alias'], + serialization_alias=common_field['serialization_alias'], + frozen=common_field['frozen'], + metadata=common_field['metadata'], + ) + + @staticmethod + def _apply_alias_generator_to_field_info( + alias_generator: Callable[[str], str] | AliasGenerator, field_info: FieldInfo, field_name: str + ) -> None: + """Apply an alias_generator to aliases on a FieldInfo instance if appropriate. + + Args: + alias_generator: A callable that takes a string and returns a string, or an AliasGenerator instance. + field_info: The FieldInfo instance to which the alias_generator is (maybe) applied. + field_name: The name of the field from which to generate the alias. + """ + # Apply an alias_generator if + # 1. An alias is not specified + # 2. An alias is specified, but the priority is <= 1 + if ( + field_info.alias_priority is None + or field_info.alias_priority <= 1 + or field_info.alias is None + or field_info.validation_alias is None + or field_info.serialization_alias is None + ): + alias, validation_alias, serialization_alias = None, None, None + + if isinstance(alias_generator, AliasGenerator): + alias, validation_alias, serialization_alias = alias_generator.generate_aliases(field_name) + elif isinstance(alias_generator, Callable): + alias = alias_generator(field_name) + if not isinstance(alias, str): + raise TypeError(f'alias_generator {alias_generator} must return str, not {alias.__class__}') + + # if priority is not set, we set to 1 + # which supports the case where the alias_generator from a child class is used + # to generate an alias for a field in a parent class + if field_info.alias_priority is None or field_info.alias_priority <= 1: + field_info.alias_priority = 1 + + # if the priority is 1, then we set the aliases to the generated alias + if field_info.alias_priority == 1: + field_info.serialization_alias = _get_first_non_null(serialization_alias, alias) + field_info.validation_alias = _get_first_non_null(validation_alias, alias) + field_info.alias = alias + + # if any of the aliases are not set, then we set them to the corresponding generated alias + if field_info.alias is None: + field_info.alias = alias + if field_info.serialization_alias is None: + field_info.serialization_alias = _get_first_non_null(serialization_alias, alias) + if field_info.validation_alias is None: + field_info.validation_alias = _get_first_non_null(validation_alias, alias) + + @staticmethod + def _apply_alias_generator_to_computed_field_info( + alias_generator: Callable[[str], str] | AliasGenerator, + computed_field_info: ComputedFieldInfo, + computed_field_name: str, + ): + """Apply an alias_generator to alias on a ComputedFieldInfo instance if appropriate. + + Args: + alias_generator: A callable that takes a string and returns a string, or an AliasGenerator instance. + computed_field_info: The ComputedFieldInfo instance to which the alias_generator is (maybe) applied. + computed_field_name: The name of the computed field from which to generate the alias. + """ + # Apply an alias_generator if + # 1. An alias is not specified + # 2. An alias is specified, but the priority is <= 1 + + if ( + computed_field_info.alias_priority is None + or computed_field_info.alias_priority <= 1 + or computed_field_info.alias is None + ): + alias, validation_alias, serialization_alias = None, None, None + + if isinstance(alias_generator, AliasGenerator): + alias, validation_alias, serialization_alias = alias_generator.generate_aliases(computed_field_name) + elif isinstance(alias_generator, Callable): + alias = alias_generator(computed_field_name) + if not isinstance(alias, str): + raise TypeError(f'alias_generator {alias_generator} must return str, not {alias.__class__}') + + # if priority is not set, we set to 1 + # which supports the case where the alias_generator from a child class is used + # to generate an alias for a field in a parent class + if computed_field_info.alias_priority is None or computed_field_info.alias_priority <= 1: + computed_field_info.alias_priority = 1 + + # if the priority is 1, then we set the aliases to the generated alias + # note that we use the serialization_alias with priority over alias, as computed_field + # aliases are used for serialization only (not validation) + if computed_field_info.alias_priority == 1: + computed_field_info.alias = _get_first_non_null(serialization_alias, alias) + + @staticmethod + def _apply_field_title_generator_to_field_info( + config_wrapper: ConfigWrapper, field_info: FieldInfo | ComputedFieldInfo, field_name: str + ) -> None: + """Apply a field_title_generator on a FieldInfo or ComputedFieldInfo instance if appropriate + Args: + config_wrapper: The config of the model + field_info: The FieldInfo or ComputedField instance to which the title_generator is (maybe) applied. + field_name: The name of the field from which to generate the title. + """ + field_title_generator = field_info.field_title_generator or config_wrapper.field_title_generator + + if field_title_generator is None: + return + + if field_info.title is None: + title = field_title_generator(field_name, field_info) # type: ignore + if not isinstance(title, str): + raise TypeError(f'field_title_generator {field_title_generator} must return str, not {title.__class__}') + + field_info.title = title + + def _common_field_schema( # C901 + self, name: str, field_info: FieldInfo, decorators: DecoratorInfos + ) -> _CommonField: + # Update FieldInfo annotation if appropriate: + from .. import AliasChoices, AliasPath + from ..fields import FieldInfo + + if has_instance_in_type(field_info.annotation, (ForwardRef, str)): + types_namespace = self._types_namespace + if self._typevars_map: + types_namespace = (types_namespace or {}).copy() + # Ensure that typevars get mapped to their concrete types: + types_namespace.update({k.__name__: v for k, v in self._typevars_map.items()}) + + evaluated = _typing_extra.eval_type_lenient(field_info.annotation, types_namespace) + if evaluated is not field_info.annotation and not has_instance_in_type(evaluated, PydanticRecursiveRef): + new_field_info = FieldInfo.from_annotation(evaluated) + field_info.annotation = new_field_info.annotation + + # Handle any field info attributes that may have been obtained from now-resolved annotations + for k, v in new_field_info._attributes_set.items(): + # If an attribute is already set, it means it was set by assigning to a call to Field (or just a + # default value), and that should take the highest priority. So don't overwrite existing attributes. + # We skip over "attributes" that are present in the metadata_lookup dict because these won't + # actually end up as attributes of the `FieldInfo` instance. + if k not in field_info._attributes_set and k not in field_info.metadata_lookup: + setattr(field_info, k, v) + + # Finally, ensure the field info also reflects all the `_attributes_set` that are actually metadata. + field_info.metadata = [*new_field_info.metadata, *field_info.metadata] + + source_type, annotations = field_info.annotation, field_info.metadata + + def set_discriminator(schema: CoreSchema) -> CoreSchema: + schema = self._apply_discriminator_to_union(schema, field_info.discriminator) + return schema + + with self.field_name_stack.push(name): + if field_info.discriminator is not None: + schema = self._apply_annotations(source_type, annotations, transform_inner_schema=set_discriminator) + else: + schema = self._apply_annotations( + source_type, + annotations, + ) + + # This V1 compatibility shim should eventually be removed + # push down any `each_item=True` validators + # note that this won't work for any Annotated types that get wrapped by a function validator + # but that's okay because that didn't exist in V1 + this_field_validators = filter_field_decorator_info_by_field(decorators.validators.values(), name) + if _validators_require_validate_default(this_field_validators): + field_info.validate_default = True + each_item_validators = [v for v in this_field_validators if v.info.each_item is True] + this_field_validators = [v for v in this_field_validators if v not in each_item_validators] + schema = apply_each_item_validators(schema, each_item_validators, name) + + schema = apply_validators(schema, filter_field_decorator_info_by_field(this_field_validators, name), name) + schema = apply_validators( + schema, filter_field_decorator_info_by_field(decorators.field_validators.values(), name), name + ) + + # the default validator needs to go outside of any other validators + # so that it is the topmost validator for the field validator + # which uses it to check if the field has a default value or not + if not field_info.is_required(): + schema = wrap_default(field_info, schema) + + schema = self._apply_field_serializers( + schema, filter_field_decorator_info_by_field(decorators.field_serializers.values(), name) + ) + self._apply_field_title_generator_to_field_info(self._config_wrapper, field_info, name) + + json_schema_updates = { + 'title': field_info.title, + 'description': field_info.description, + 'deprecated': bool(field_info.deprecated) or field_info.deprecated == '' or None, + 'examples': to_jsonable_python(field_info.examples), + } + json_schema_updates = {k: v for k, v in json_schema_updates.items() if v is not None} + + json_schema_extra = field_info.json_schema_extra + + metadata = build_metadata_dict( + js_annotation_functions=[get_json_schema_update_func(json_schema_updates, json_schema_extra)] + ) + + alias_generator = self._config_wrapper.alias_generator + if alias_generator is not None: + self._apply_alias_generator_to_field_info(alias_generator, field_info, name) + + if isinstance(field_info.validation_alias, (AliasChoices, AliasPath)): + validation_alias = field_info.validation_alias.convert_to_aliases() + else: + validation_alias = field_info.validation_alias + + return _common_field( + schema, + serialization_exclude=True if field_info.exclude else None, + validation_alias=validation_alias, + serialization_alias=field_info.serialization_alias, + frozen=field_info.frozen, + metadata=metadata, + ) + + def _union_schema(self, union_type: Any) -> core_schema.CoreSchema: + """Generate schema for a Union.""" + args = self._get_args_resolving_forward_refs(union_type, required=True) + choices: list[CoreSchema] = [] + nullable = False + for arg in args: + if arg is None or arg is _typing_extra.NoneType: + nullable = True + else: + choices.append(self.generate_schema(arg)) + + if len(choices) == 1: + s = choices[0] + else: + choices_with_tags: list[CoreSchema | tuple[CoreSchema, str]] = [] + for choice in choices: + tag = choice.get('metadata', {}).get(_core_utils.TAGGED_UNION_TAG_KEY) + if tag is not None: + choices_with_tags.append((choice, tag)) + else: + choices_with_tags.append(choice) + s = core_schema.union_schema(choices_with_tags) + + if nullable: + s = core_schema.nullable_schema(s) + return s + + def _type_alias_type_schema( + self, + obj: Any, # TypeAliasType + ) -> CoreSchema: + with self.defs.get_schema_or_ref(obj) as (ref, maybe_schema): + if maybe_schema is not None: + return maybe_schema + + origin = get_origin(obj) or obj + + annotation = origin.__value__ + typevars_map = get_standard_typevars_map(obj) + + with self._types_namespace_stack.push(origin): + annotation = _typing_extra.eval_type_lenient(annotation, self._types_namespace) + annotation = replace_types(annotation, typevars_map) + schema = self.generate_schema(annotation) + assert schema['type'] != 'definitions' + schema['ref'] = ref # type: ignore + self.defs.definitions[ref] = schema + return core_schema.definition_reference_schema(ref) + + def _literal_schema(self, literal_type: Any) -> CoreSchema: + """Generate schema for a Literal.""" + expected = _typing_extra.all_literal_values(literal_type) + assert expected, f'literal "expected" cannot be empty, obj={literal_type}' + return core_schema.literal_schema(expected) + + def _typed_dict_schema(self, typed_dict_cls: Any, origin: Any) -> core_schema.CoreSchema: + """Generate schema for a TypedDict. + + It is not possible to track required/optional keys in TypedDict without __required_keys__ + since TypedDict.__new__ erases the base classes (it replaces them with just `dict`) + and thus we can track usage of total=True/False + __required_keys__ was added in Python 3.9 + (https://github.com/miss-islington/cpython/blob/1e9939657dd1f8eb9f596f77c1084d2d351172fc/Doc/library/typing.rst?plain=1#L1546-L1548) + however it is buggy + (https://github.com/python/typing_extensions/blob/ac52ac5f2cb0e00e7988bae1e2a1b8257ac88d6d/src/typing_extensions.py#L657-L666). + + On 3.11 but < 3.12 TypedDict does not preserve inheritance information. + + Hence to avoid creating validators that do not do what users expect we only + support typing.TypedDict on Python >= 3.12 or typing_extension.TypedDict on all versions + """ + from ..fields import FieldInfo + + with self.model_type_stack.push(typed_dict_cls), self.defs.get_schema_or_ref(typed_dict_cls) as ( + typed_dict_ref, + maybe_schema, + ): + if maybe_schema is not None: + return maybe_schema + + typevars_map = get_standard_typevars_map(typed_dict_cls) + if origin is not None: + typed_dict_cls = origin + + if not _SUPPORTS_TYPEDDICT and type(typed_dict_cls).__module__ == 'typing': + raise PydanticUserError( + 'Please use `typing_extensions.TypedDict` instead of `typing.TypedDict` on Python < 3.12.', + code='typed-dict-version', + ) + + try: + config: ConfigDict | None = get_attribute_from_bases(typed_dict_cls, '__pydantic_config__') + except AttributeError: + config = None + + with self._config_wrapper_stack.push(config), self._types_namespace_stack.push(typed_dict_cls): + core_config = self._config_wrapper.core_config(typed_dict_cls) + + self = self._current_generate_schema + + required_keys: frozenset[str] = typed_dict_cls.__required_keys__ + + fields: dict[str, core_schema.TypedDictField] = {} + + decorators = DecoratorInfos.build(typed_dict_cls) + + if self._config_wrapper.use_attribute_docstrings: + field_docstrings = extract_docstrings_from_cls(typed_dict_cls, use_inspect=True) + else: + field_docstrings = None + + for field_name, annotation in get_type_hints_infer_globalns( + typed_dict_cls, localns=self._types_namespace, include_extras=True + ).items(): + annotation = replace_types(annotation, typevars_map) + required = field_name in required_keys + + if get_origin(annotation) == _typing_extra.Required: + required = True + annotation = self._get_args_resolving_forward_refs( + annotation, + required=True, + )[0] + elif get_origin(annotation) == _typing_extra.NotRequired: + required = False + annotation = self._get_args_resolving_forward_refs( + annotation, + required=True, + )[0] + + field_info = FieldInfo.from_annotation(annotation) + if ( + field_docstrings is not None + and field_info.description is None + and field_name in field_docstrings + ): + field_info.description = field_docstrings[field_name] + self._apply_field_title_generator_to_field_info(self._config_wrapper, field_info, field_name) + fields[field_name] = self._generate_td_field_schema( + field_name, field_info, decorators, required=required + ) + + title = self._get_model_title_from_config(typed_dict_cls, ConfigWrapper(config)) + metadata = build_metadata_dict( + js_functions=[partial(modify_model_json_schema, cls=typed_dict_cls, title=title)], + typed_dict_cls=typed_dict_cls, + ) + td_schema = core_schema.typed_dict_schema( + fields, + computed_fields=[ + self._computed_field_schema(d, decorators.field_serializers) + for d in decorators.computed_fields.values() + ], + ref=typed_dict_ref, + metadata=metadata, + config=core_config, + ) + + schema = self._apply_model_serializers(td_schema, decorators.model_serializers.values()) + schema = apply_model_validators(schema, decorators.model_validators.values(), 'all') + self.defs.definitions[typed_dict_ref] = schema + return core_schema.definition_reference_schema(typed_dict_ref) + + def _namedtuple_schema(self, namedtuple_cls: Any, origin: Any) -> core_schema.CoreSchema: + """Generate schema for a NamedTuple.""" + with self.model_type_stack.push(namedtuple_cls), self.defs.get_schema_or_ref(namedtuple_cls) as ( + namedtuple_ref, + maybe_schema, + ): + if maybe_schema is not None: + return maybe_schema + typevars_map = get_standard_typevars_map(namedtuple_cls) + if origin is not None: + namedtuple_cls = origin + + annotations: dict[str, Any] = get_type_hints_infer_globalns( + namedtuple_cls, include_extras=True, localns=self._types_namespace + ) + if not annotations: + # annotations is empty, happens if namedtuple_cls defined via collections.namedtuple(...) + annotations = {k: Any for k in namedtuple_cls._fields} + + if typevars_map: + annotations = { + field_name: replace_types(annotation, typevars_map) + for field_name, annotation in annotations.items() + } + + arguments_schema = core_schema.arguments_schema( + [ + self._generate_parameter_schema( + field_name, annotation, default=namedtuple_cls._field_defaults.get(field_name, Parameter.empty) + ) + for field_name, annotation in annotations.items() + ], + metadata=build_metadata_dict(js_prefer_positional_arguments=True), + ) + return core_schema.call_schema(arguments_schema, namedtuple_cls, ref=namedtuple_ref) + + def _generate_parameter_schema( + self, + name: str, + annotation: type[Any], + default: Any = Parameter.empty, + mode: Literal['positional_only', 'positional_or_keyword', 'keyword_only'] | None = None, + ) -> core_schema.ArgumentsParameter: + """Prepare a ArgumentsParameter to represent a field in a namedtuple or function signature.""" + from ..fields import FieldInfo + + if default is Parameter.empty: + field = FieldInfo.from_annotation(annotation) + else: + field = FieldInfo.from_annotated_attribute(annotation, default) + assert field.annotation is not None, 'field.annotation should not be None when generating a schema' + source_type, annotations = field.annotation, field.metadata + with self.field_name_stack.push(name): + schema = self._apply_annotations(source_type, annotations) + + if not field.is_required(): + schema = wrap_default(field, schema) + + parameter_schema = core_schema.arguments_parameter(name, schema) + if mode is not None: + parameter_schema['mode'] = mode + if field.alias is not None: + parameter_schema['alias'] = field.alias + else: + alias_generator = self._config_wrapper.alias_generator + if isinstance(alias_generator, AliasGenerator) and alias_generator.alias is not None: + parameter_schema['alias'] = alias_generator.alias(name) + elif isinstance(alias_generator, Callable): + parameter_schema['alias'] = alias_generator(name) + return parameter_schema + + def _tuple_schema(self, tuple_type: Any) -> core_schema.CoreSchema: + """Generate schema for a Tuple, e.g. `tuple[int, str]` or `tuple[int, ...]`.""" + # TODO: do we really need to resolve type vars here? + typevars_map = get_standard_typevars_map(tuple_type) + params = self._get_args_resolving_forward_refs(tuple_type) + + if typevars_map and params: + params = tuple(replace_types(param, typevars_map) for param in params) + + # NOTE: subtle difference: `tuple[()]` gives `params=()`, whereas `typing.Tuple[()]` gives `params=((),)` + # This is only true for <3.11, on Python 3.11+ `typing.Tuple[()]` gives `params=()` + if not params: + if tuple_type in TUPLE_TYPES: + return core_schema.tuple_schema([core_schema.any_schema()], variadic_item_index=0) + else: + # special case for `tuple[()]` which means `tuple[]` - an empty tuple + return core_schema.tuple_schema([]) + elif params[-1] is Ellipsis: + if len(params) == 2: + return core_schema.tuple_schema([self.generate_schema(params[0])], variadic_item_index=0) + else: + # TODO: something like https://github.com/pydantic/pydantic/issues/5952 + raise ValueError('Variable tuples can only have one type') + elif len(params) == 1 and params[0] == (): + # special case for `Tuple[()]` which means `Tuple[]` - an empty tuple + # NOTE: This conditional can be removed when we drop support for Python 3.10. + return core_schema.tuple_schema([]) + else: + return core_schema.tuple_schema([self.generate_schema(param) for param in params]) + + def _type_schema(self) -> core_schema.CoreSchema: + return core_schema.custom_error_schema( + core_schema.is_instance_schema(type), + custom_error_type='is_type', + custom_error_message='Input should be a type', + ) + + def _union_is_subclass_schema(self, union_type: Any) -> core_schema.CoreSchema: + """Generate schema for `Type[Union[X, ...]]`.""" + args = self._get_args_resolving_forward_refs(union_type, required=True) + return core_schema.union_schema([self.generate_schema(typing.Type[args]) for args in args]) + + def _subclass_schema(self, type_: Any) -> core_schema.CoreSchema: + """Generate schema for a Type, e.g. `Type[int]`.""" + type_param = self._get_first_arg_or_any(type_) + if type_param == Any: + return self._type_schema() + elif isinstance(type_param, typing.TypeVar): + if type_param.__bound__: + if _typing_extra.origin_is_union(get_origin(type_param.__bound__)): + return self._union_is_subclass_schema(type_param.__bound__) + return core_schema.is_subclass_schema(type_param.__bound__) + elif type_param.__constraints__: + return core_schema.union_schema( + [self.generate_schema(typing.Type[c]) for c in type_param.__constraints__] + ) + else: + return self._type_schema() + elif _typing_extra.origin_is_union(get_origin(type_param)): + return self._union_is_subclass_schema(type_param) + else: + return core_schema.is_subclass_schema(type_param) + + def _sequence_schema(self, sequence_type: Any) -> core_schema.CoreSchema: + """Generate schema for a Sequence, e.g. `Sequence[int]`.""" + from ._std_types_schema import serialize_sequence_via_list + + item_type = self._get_first_arg_or_any(sequence_type) + item_type_schema = self.generate_schema(item_type) + list_schema = core_schema.list_schema(item_type_schema) + + python_schema = core_schema.is_instance_schema(typing.Sequence, cls_repr='Sequence') + if item_type != Any: + from ._validators import sequence_validator + + python_schema = core_schema.chain_schema( + [python_schema, core_schema.no_info_wrap_validator_function(sequence_validator, list_schema)], + ) + + serialization = core_schema.wrap_serializer_function_ser_schema( + serialize_sequence_via_list, schema=item_type_schema, info_arg=True + ) + return core_schema.json_or_python_schema( + json_schema=list_schema, python_schema=python_schema, serialization=serialization + ) + + def _iterable_schema(self, type_: Any) -> core_schema.GeneratorSchema: + """Generate a schema for an `Iterable`.""" + item_type = self._get_first_arg_or_any(type_) + + return core_schema.generator_schema(self.generate_schema(item_type)) + + def _pattern_schema(self, pattern_type: Any) -> core_schema.CoreSchema: + from . import _validators + + metadata = build_metadata_dict(js_functions=[lambda _1, _2: {'type': 'string', 'format': 'regex'}]) + ser = core_schema.plain_serializer_function_ser_schema( + attrgetter('pattern'), when_used='json', return_schema=core_schema.str_schema() + ) + if pattern_type == typing.Pattern or pattern_type == re.Pattern: + # bare type + return core_schema.no_info_plain_validator_function( + _validators.pattern_either_validator, serialization=ser, metadata=metadata + ) + + param = self._get_args_resolving_forward_refs( + pattern_type, + required=True, + )[0] + if param is str: + return core_schema.no_info_plain_validator_function( + _validators.pattern_str_validator, serialization=ser, metadata=metadata + ) + elif param is bytes: + return core_schema.no_info_plain_validator_function( + _validators.pattern_bytes_validator, serialization=ser, metadata=metadata + ) + else: + raise PydanticSchemaGenerationError(f'Unable to generate pydantic-core schema for {pattern_type!r}.') + + def _hashable_schema(self) -> core_schema.CoreSchema: + return core_schema.custom_error_schema( + core_schema.is_instance_schema(collections.abc.Hashable), + custom_error_type='is_hashable', + custom_error_message='Input should be hashable', + ) + + def _dataclass_schema( + self, dataclass: type[StandardDataclass], origin: type[StandardDataclass] | None + ) -> core_schema.CoreSchema: + """Generate schema for a dataclass.""" + with self.model_type_stack.push(dataclass), self.defs.get_schema_or_ref(dataclass) as ( + dataclass_ref, + maybe_schema, + ): + if maybe_schema is not None: + return maybe_schema + + typevars_map = get_standard_typevars_map(dataclass) + if origin is not None: + dataclass = origin + + with ExitStack() as dataclass_bases_stack: + # Pushing a namespace prioritises items already in the stack, so iterate though the MRO forwards + for dataclass_base in dataclass.__mro__: + if dataclasses.is_dataclass(dataclass_base): + dataclass_bases_stack.enter_context(self._types_namespace_stack.push(dataclass_base)) + + # Pushing a config overwrites the previous config, so iterate though the MRO backwards + config = None + for dataclass_base in reversed(dataclass.__mro__): + if dataclasses.is_dataclass(dataclass_base): + config = getattr(dataclass_base, '__pydantic_config__', None) + dataclass_bases_stack.enter_context(self._config_wrapper_stack.push(config)) + + core_config = self._config_wrapper.core_config(dataclass) + + self = self._current_generate_schema + + from ..dataclasses import is_pydantic_dataclass + + if is_pydantic_dataclass(dataclass): + fields = deepcopy(dataclass.__pydantic_fields__) + if typevars_map: + for field in fields.values(): + field.apply_typevars_map(typevars_map, self._types_namespace) + else: + fields = collect_dataclass_fields( + dataclass, + self._types_namespace, + typevars_map=typevars_map, + ) + + # disallow combination of init=False on a dataclass field and extra='allow' on a dataclass + if self._config_wrapper_stack.tail.extra == 'allow': + # disallow combination of init=False on a dataclass field and extra='allow' on a dataclass + for field_name, field in fields.items(): + if field.init is False: + raise PydanticUserError( + f'Field {field_name} has `init=False` and dataclass has config setting `extra="allow"`. ' + f'This combination is not allowed.', + code='dataclass-init-false-extra-allow', + ) + + decorators = dataclass.__dict__.get('__pydantic_decorators__') or DecoratorInfos.build(dataclass) + # Move kw_only=False args to the start of the list, as this is how vanilla dataclasses work. + # Note that when kw_only is missing or None, it is treated as equivalent to kw_only=True + args = sorted( + (self._generate_dc_field_schema(k, v, decorators) for k, v in fields.items()), + key=lambda a: a.get('kw_only') is not False, + ) + has_post_init = hasattr(dataclass, '__post_init__') + has_slots = hasattr(dataclass, '__slots__') + + args_schema = core_schema.dataclass_args_schema( + dataclass.__name__, + args, + computed_fields=[ + self._computed_field_schema(d, decorators.field_serializers) + for d in decorators.computed_fields.values() + ], + collect_init_only=has_post_init, + ) + + inner_schema = apply_validators(args_schema, decorators.root_validators.values(), None) + + model_validators = decorators.model_validators.values() + inner_schema = apply_model_validators(inner_schema, model_validators, 'inner') + + title = self._get_model_title_from_config(dataclass, ConfigWrapper(config)) + metadata = build_metadata_dict( + js_functions=[partial(modify_model_json_schema, cls=dataclass, title=title)] + ) + + dc_schema = core_schema.dataclass_schema( + dataclass, + inner_schema, + post_init=has_post_init, + ref=dataclass_ref, + fields=[field.name for field in dataclasses.fields(dataclass)], + slots=has_slots, + config=core_config, + metadata=metadata, + ) + schema = self._apply_model_serializers(dc_schema, decorators.model_serializers.values()) + schema = apply_model_validators(schema, model_validators, 'outer') + self.defs.definitions[dataclass_ref] = schema + return core_schema.definition_reference_schema(dataclass_ref) + + # Type checkers seem to assume ExitStack may suppress exceptions and therefore + # control flow can exit the `with` block without returning. + assert False, 'Unreachable' + + def _callable_schema(self, function: Callable[..., Any]) -> core_schema.CallSchema: + """Generate schema for a Callable. + + TODO support functional validators once we support them in Config + """ + sig = signature(function) + + type_hints = _typing_extra.get_function_type_hints(function, types_namespace=self._types_namespace) + + mode_lookup: dict[_ParameterKind, Literal['positional_only', 'positional_or_keyword', 'keyword_only']] = { + Parameter.POSITIONAL_ONLY: 'positional_only', + Parameter.POSITIONAL_OR_KEYWORD: 'positional_or_keyword', + Parameter.KEYWORD_ONLY: 'keyword_only', + } + + arguments_list: list[core_schema.ArgumentsParameter] = [] + var_args_schema: core_schema.CoreSchema | None = None + var_kwargs_schema: core_schema.CoreSchema | None = None + + for name, p in sig.parameters.items(): + if p.annotation is sig.empty: + annotation = typing.cast(Any, Any) + else: + annotation = type_hints[name] + + parameter_mode = mode_lookup.get(p.kind) + if parameter_mode is not None: + arg_schema = self._generate_parameter_schema(name, annotation, p.default, parameter_mode) + arguments_list.append(arg_schema) + elif p.kind == Parameter.VAR_POSITIONAL: + var_args_schema = self.generate_schema(annotation) + else: + assert p.kind == Parameter.VAR_KEYWORD, p.kind + var_kwargs_schema = self.generate_schema(annotation) + + return_schema: core_schema.CoreSchema | None = None + config_wrapper = self._config_wrapper + if config_wrapper.validate_return: + return_hint = type_hints.get('return') + if return_hint is not None: + return_schema = self.generate_schema(return_hint) + + return core_schema.call_schema( + core_schema.arguments_schema( + arguments_list, + var_args_schema=var_args_schema, + var_kwargs_schema=var_kwargs_schema, + populate_by_name=config_wrapper.populate_by_name, + ), + function, + return_schema=return_schema, + ) + + def _unsubstituted_typevar_schema(self, typevar: typing.TypeVar) -> core_schema.CoreSchema: + assert isinstance(typevar, typing.TypeVar) + + bound = typevar.__bound__ + constraints = typevar.__constraints__ + + try: + typevar_has_default = typevar.has_default() # type: ignore + except AttributeError: + # could still have a default if it's an old version of typing_extensions.TypeVar + typevar_has_default = getattr(typevar, '__default__', None) is not None + + if (bound is not None) + (len(constraints) != 0) + typevar_has_default > 1: + raise NotImplementedError( + 'Pydantic does not support mixing more than one of TypeVar bounds, constraints and defaults' + ) + + if typevar_has_default: + return self.generate_schema(typevar.__default__) # type: ignore + elif constraints: + return self._union_schema(typing.Union[constraints]) # type: ignore + elif bound: + schema = self.generate_schema(bound) + schema['serialization'] = core_schema.wrap_serializer_function_ser_schema( + lambda x, h: h(x), schema=core_schema.any_schema() + ) + return schema + else: + return core_schema.any_schema() + + def _computed_field_schema( + self, + d: Decorator[ComputedFieldInfo], + field_serializers: dict[str, Decorator[FieldSerializerDecoratorInfo]], + ) -> core_schema.ComputedField: + try: + return_type = _decorators.get_function_return_type(d.func, d.info.return_type, self._types_namespace) + except NameError as e: + raise PydanticUndefinedAnnotation.from_name_error(e) from e + if return_type is PydanticUndefined: + raise PydanticUserError( + 'Computed field is missing return type annotation or specifying `return_type`' + ' to the `@computed_field` decorator (e.g. `@computed_field(return_type=int|str)`)', + code='model-field-missing-annotation', + ) + + return_type = replace_types(return_type, self._typevars_map) + # Create a new ComputedFieldInfo so that different type parametrizations of the same + # generic model's computed field can have different return types. + d.info = dataclasses.replace(d.info, return_type=return_type) + return_type_schema = self.generate_schema(return_type) + # Apply serializers to computed field if there exist + return_type_schema = self._apply_field_serializers( + return_type_schema, + filter_field_decorator_info_by_field(field_serializers.values(), d.cls_var_name), + computed_field=True, + ) + + alias_generator = self._config_wrapper.alias_generator + if alias_generator is not None: + self._apply_alias_generator_to_computed_field_info( + alias_generator=alias_generator, computed_field_info=d.info, computed_field_name=d.cls_var_name + ) + self._apply_field_title_generator_to_field_info(self._config_wrapper, d.info, d.cls_var_name) + + def set_computed_field_metadata(schema: CoreSchemaOrField, handler: GetJsonSchemaHandler) -> JsonSchemaValue: + json_schema = handler(schema) + + json_schema['readOnly'] = True + + title = d.info.title + if title is not None: + json_schema['title'] = title + + description = d.info.description + if description is not None: + json_schema['description'] = description + + if d.info.deprecated or d.info.deprecated == '': + json_schema['deprecated'] = True + + examples = d.info.examples + if examples is not None: + json_schema['examples'] = to_jsonable_python(examples) + + json_schema_extra = d.info.json_schema_extra + if json_schema_extra is not None: + add_json_schema_extra(json_schema, json_schema_extra) + + return json_schema + + metadata = build_metadata_dict(js_annotation_functions=[set_computed_field_metadata]) + return core_schema.computed_field( + d.cls_var_name, return_schema=return_type_schema, alias=d.info.alias, metadata=metadata + ) + + def _annotated_schema(self, annotated_type: Any) -> core_schema.CoreSchema: + """Generate schema for an Annotated type, e.g. `Annotated[int, Field(...)]` or `Annotated[int, Gt(0)]`.""" + from ..fields import FieldInfo + + source_type, *annotations = self._get_args_resolving_forward_refs( + annotated_type, + required=True, + ) + schema = self._apply_annotations(source_type, annotations) + # put the default validator last so that TypeAdapter.get_default_value() works + # even if there are function validators involved + for annotation in annotations: + if isinstance(annotation, FieldInfo): + schema = wrap_default(annotation, schema) + return schema + + def _get_prepare_pydantic_annotations_for_known_type( + self, obj: Any, annotations: tuple[Any, ...] + ) -> tuple[Any, list[Any]] | None: + from ._std_types_schema import PREPARE_METHODS + + # Check for hashability + try: + hash(obj) + except TypeError: + # obj is definitely not a known type if this fails + return None + + for gen in PREPARE_METHODS: + res = gen(obj, annotations, self._config_wrapper.config_dict) + if res is not None: + return res + + return None + + def _apply_annotations( + self, + source_type: Any, + annotations: list[Any], + transform_inner_schema: Callable[[CoreSchema], CoreSchema] = lambda x: x, + ) -> CoreSchema: + """Apply arguments from `Annotated` or from `FieldInfo` to a schema. + + This gets called by `GenerateSchema._annotated_schema` but differs from it in that it does + not expect `source_type` to be an `Annotated` object, it expects it to be the first argument of that + (in other words, `GenerateSchema._annotated_schema` just unpacks `Annotated`, this process it). + """ + annotations = list(_known_annotated_metadata.expand_grouped_metadata(annotations)) + res = self._get_prepare_pydantic_annotations_for_known_type(source_type, tuple(annotations)) + if res is not None: + source_type, annotations = res + + pydantic_js_annotation_functions: list[GetJsonSchemaFunction] = [] + + def inner_handler(obj: Any) -> CoreSchema: + from_property = self._generate_schema_from_property(obj, source_type) + if from_property is None: + schema = self._generate_schema_inner(obj) + else: + schema = from_property + metadata_js_function = _extract_get_pydantic_json_schema(obj, schema) + if metadata_js_function is not None: + metadata_schema = resolve_original_schema(schema, self.defs.definitions) + if metadata_schema is not None: + self._add_js_function(metadata_schema, metadata_js_function) + return transform_inner_schema(schema) + + get_inner_schema = CallbackGetCoreSchemaHandler(inner_handler, self) + + for annotation in annotations: + if annotation is None: + continue + get_inner_schema = self._get_wrapped_inner_schema( + get_inner_schema, annotation, pydantic_js_annotation_functions + ) + + schema = get_inner_schema(source_type) + if pydantic_js_annotation_functions: + metadata = CoreMetadataHandler(schema).metadata + metadata.setdefault('pydantic_js_annotation_functions', []).extend(pydantic_js_annotation_functions) + return _add_custom_serialization_from_json_encoders(self._config_wrapper.json_encoders, source_type, schema) + + def _apply_single_annotation(self, schema: core_schema.CoreSchema, metadata: Any) -> core_schema.CoreSchema: + from ..fields import FieldInfo + + if isinstance(metadata, FieldInfo): + for field_metadata in metadata.metadata: + schema = self._apply_single_annotation(schema, field_metadata) + + if metadata.discriminator is not None: + schema = self._apply_discriminator_to_union(schema, metadata.discriminator) + return schema + + if schema['type'] == 'nullable': + # for nullable schemas, metadata is automatically applied to the inner schema + inner = schema.get('schema', core_schema.any_schema()) + inner = self._apply_single_annotation(inner, metadata) + if inner: + schema['schema'] = inner + return schema + + original_schema = schema + ref = schema.get('ref', None) + if ref is not None: + schema = schema.copy() + new_ref = ref + f'_{repr(metadata)}' + if new_ref in self.defs.definitions: + return self.defs.definitions[new_ref] + schema['ref'] = new_ref # type: ignore + elif schema['type'] == 'definition-ref': + ref = schema['schema_ref'] + if ref in self.defs.definitions: + schema = self.defs.definitions[ref].copy() + new_ref = ref + f'_{repr(metadata)}' + if new_ref in self.defs.definitions: + return self.defs.definitions[new_ref] + schema['ref'] = new_ref # type: ignore + + maybe_updated_schema = _known_annotated_metadata.apply_known_metadata(metadata, schema.copy()) + + if maybe_updated_schema is not None: + return maybe_updated_schema + return original_schema + + def _apply_single_annotation_json_schema( + self, schema: core_schema.CoreSchema, metadata: Any + ) -> core_schema.CoreSchema: + from ..fields import FieldInfo + + if isinstance(metadata, FieldInfo): + for field_metadata in metadata.metadata: + schema = self._apply_single_annotation_json_schema(schema, field_metadata) + json_schema_update: JsonSchemaValue = {} + if metadata.title: + json_schema_update['title'] = metadata.title + if metadata.description: + json_schema_update['description'] = metadata.description + if metadata.examples: + json_schema_update['examples'] = to_jsonable_python(metadata.examples) + + json_schema_extra = metadata.json_schema_extra + if json_schema_update or json_schema_extra: + CoreMetadataHandler(schema).metadata.setdefault('pydantic_js_annotation_functions', []).append( + get_json_schema_update_func(json_schema_update, json_schema_extra) + ) + return schema + + def _get_wrapped_inner_schema( + self, + get_inner_schema: GetCoreSchemaHandler, + annotation: Any, + pydantic_js_annotation_functions: list[GetJsonSchemaFunction], + ) -> CallbackGetCoreSchemaHandler: + metadata_get_schema: GetCoreSchemaFunction = getattr(annotation, '__get_pydantic_core_schema__', None) or ( + lambda source, handler: handler(source) + ) + + def new_handler(source: Any) -> core_schema.CoreSchema: + schema = metadata_get_schema(source, get_inner_schema) + schema = self._apply_single_annotation(schema, annotation) + schema = self._apply_single_annotation_json_schema(schema, annotation) + + metadata_js_function = _extract_get_pydantic_json_schema(annotation, schema) + if metadata_js_function is not None: + pydantic_js_annotation_functions.append(metadata_js_function) + return schema + + return CallbackGetCoreSchemaHandler(new_handler, self) + + def _apply_field_serializers( + self, + schema: core_schema.CoreSchema, + serializers: list[Decorator[FieldSerializerDecoratorInfo]], + computed_field: bool = False, + ) -> core_schema.CoreSchema: + """Apply field serializers to a schema.""" + if serializers: + schema = copy(schema) + if schema['type'] == 'definitions': + inner_schema = schema['schema'] + schema['schema'] = self._apply_field_serializers(inner_schema, serializers) + return schema + else: + ref = typing.cast('str|None', schema.get('ref', None)) + if ref is not None: + schema = core_schema.definition_reference_schema(ref) + + # use the last serializer to make it easy to override a serializer set on a parent model + serializer = serializers[-1] + is_field_serializer, info_arg = inspect_field_serializer( + serializer.func, serializer.info.mode, computed_field=computed_field + ) + + try: + return_type = _decorators.get_function_return_type( + serializer.func, serializer.info.return_type, self._types_namespace + ) + except NameError as e: + raise PydanticUndefinedAnnotation.from_name_error(e) from e + + if return_type is PydanticUndefined: + return_schema = None + else: + return_schema = self.generate_schema(return_type) + + if serializer.info.mode == 'wrap': + schema['serialization'] = core_schema.wrap_serializer_function_ser_schema( + serializer.func, + is_field_serializer=is_field_serializer, + info_arg=info_arg, + return_schema=return_schema, + when_used=serializer.info.when_used, + ) + else: + assert serializer.info.mode == 'plain' + schema['serialization'] = core_schema.plain_serializer_function_ser_schema( + serializer.func, + is_field_serializer=is_field_serializer, + info_arg=info_arg, + return_schema=return_schema, + when_used=serializer.info.when_used, + ) + return schema + + def _apply_model_serializers( + self, schema: core_schema.CoreSchema, serializers: Iterable[Decorator[ModelSerializerDecoratorInfo]] + ) -> core_schema.CoreSchema: + """Apply model serializers to a schema.""" + ref: str | None = schema.pop('ref', None) # type: ignore + if serializers: + serializer = list(serializers)[-1] + info_arg = inspect_model_serializer(serializer.func, serializer.info.mode) + + try: + return_type = _decorators.get_function_return_type( + serializer.func, serializer.info.return_type, self._types_namespace + ) + except NameError as e: + raise PydanticUndefinedAnnotation.from_name_error(e) from e + if return_type is PydanticUndefined: + return_schema = None + else: + return_schema = self.generate_schema(return_type) + + if serializer.info.mode == 'wrap': + ser_schema: core_schema.SerSchema = core_schema.wrap_serializer_function_ser_schema( + serializer.func, + info_arg=info_arg, + return_schema=return_schema, + when_used=serializer.info.when_used, + ) + else: + # plain + ser_schema = core_schema.plain_serializer_function_ser_schema( + serializer.func, + info_arg=info_arg, + return_schema=return_schema, + when_used=serializer.info.when_used, + ) + schema['serialization'] = ser_schema + if ref: + schema['ref'] = ref # type: ignore + return schema + + +_VALIDATOR_F_MATCH: Mapping[ + tuple[FieldValidatorModes, Literal['no-info', 'with-info']], + Callable[[Callable[..., Any], core_schema.CoreSchema, str | None], core_schema.CoreSchema], +] = { + ('before', 'no-info'): lambda f, schema, _: core_schema.no_info_before_validator_function(f, schema), + ('after', 'no-info'): lambda f, schema, _: core_schema.no_info_after_validator_function(f, schema), + ('plain', 'no-info'): lambda f, _1, _2: core_schema.no_info_plain_validator_function(f), + ('wrap', 'no-info'): lambda f, schema, _: core_schema.no_info_wrap_validator_function(f, schema), + ('before', 'with-info'): lambda f, schema, field_name: core_schema.with_info_before_validator_function( + f, schema, field_name=field_name + ), + ('after', 'with-info'): lambda f, schema, field_name: core_schema.with_info_after_validator_function( + f, schema, field_name=field_name + ), + ('plain', 'with-info'): lambda f, _, field_name: core_schema.with_info_plain_validator_function( + f, field_name=field_name + ), + ('wrap', 'with-info'): lambda f, schema, field_name: core_schema.with_info_wrap_validator_function( + f, schema, field_name=field_name + ), +} + + +def apply_validators( + schema: core_schema.CoreSchema, + validators: Iterable[Decorator[RootValidatorDecoratorInfo]] + | Iterable[Decorator[ValidatorDecoratorInfo]] + | Iterable[Decorator[FieldValidatorDecoratorInfo]], + field_name: str | None, +) -> core_schema.CoreSchema: + """Apply validators to a schema. + + Args: + schema: The schema to apply validators on. + validators: An iterable of validators. + field_name: The name of the field if validators are being applied to a model field. + + Returns: + The updated schema. + """ + for validator in validators: + info_arg = inspect_validator(validator.func, validator.info.mode) + val_type = 'with-info' if info_arg else 'no-info' + + schema = _VALIDATOR_F_MATCH[(validator.info.mode, val_type)](validator.func, schema, field_name) + return schema + + +def _validators_require_validate_default(validators: Iterable[Decorator[ValidatorDecoratorInfo]]) -> bool: + """In v1, if any of the validators for a field had `always=True`, the default value would be validated. + + This serves as an auxiliary function for re-implementing that logic, by looping over a provided + collection of (v1-style) ValidatorDecoratorInfo's and checking if any of them have `always=True`. + + We should be able to drop this function and the associated logic calling it once we drop support + for v1-style validator decorators. (Or we can extend it and keep it if we add something equivalent + to the v1-validator `always` kwarg to `field_validator`.) + """ + for validator in validators: + if validator.info.always: + return True + return False + + +def apply_model_validators( + schema: core_schema.CoreSchema, + validators: Iterable[Decorator[ModelValidatorDecoratorInfo]], + mode: Literal['inner', 'outer', 'all'], +) -> core_schema.CoreSchema: + """Apply model validators to a schema. + + If mode == 'inner', only "before" validators are applied + If mode == 'outer', validators other than "before" are applied + If mode == 'all', all validators are applied + + Args: + schema: The schema to apply validators on. + validators: An iterable of validators. + mode: The validator mode. + + Returns: + The updated schema. + """ + ref: str | None = schema.pop('ref', None) # type: ignore + for validator in validators: + if mode == 'inner' and validator.info.mode != 'before': + continue + if mode == 'outer' and validator.info.mode == 'before': + continue + info_arg = inspect_validator(validator.func, validator.info.mode) + if validator.info.mode == 'wrap': + if info_arg: + schema = core_schema.with_info_wrap_validator_function(function=validator.func, schema=schema) + else: + schema = core_schema.no_info_wrap_validator_function(function=validator.func, schema=schema) + elif validator.info.mode == 'before': + if info_arg: + schema = core_schema.with_info_before_validator_function(function=validator.func, schema=schema) + else: + schema = core_schema.no_info_before_validator_function(function=validator.func, schema=schema) + else: + assert validator.info.mode == 'after' + if info_arg: + schema = core_schema.with_info_after_validator_function(function=validator.func, schema=schema) + else: + schema = core_schema.no_info_after_validator_function(function=validator.func, schema=schema) + if ref: + schema['ref'] = ref # type: ignore + return schema + + +def wrap_default(field_info: FieldInfo, schema: core_schema.CoreSchema) -> core_schema.CoreSchema: + """Wrap schema with default schema if default value or `default_factory` are available. + + Args: + field_info: The field info object. + schema: The schema to apply default on. + + Returns: + Updated schema by default value or `default_factory`. + """ + if field_info.default_factory: + return core_schema.with_default_schema( + schema, default_factory=field_info.default_factory, validate_default=field_info.validate_default + ) + elif field_info.default is not PydanticUndefined: + return core_schema.with_default_schema( + schema, default=field_info.default, validate_default=field_info.validate_default + ) + else: + return schema + + +def _extract_get_pydantic_json_schema(tp: Any, schema: CoreSchema) -> GetJsonSchemaFunction | None: + """Extract `__get_pydantic_json_schema__` from a type, handling the deprecated `__modify_schema__`.""" + js_modify_function = getattr(tp, '__get_pydantic_json_schema__', None) + + if hasattr(tp, '__modify_schema__'): + from pydantic import BaseModel # circular reference + + has_custom_v2_modify_js_func = ( + js_modify_function is not None + and BaseModel.__get_pydantic_json_schema__.__func__ # type: ignore + not in (js_modify_function, getattr(js_modify_function, '__func__', None)) + ) + + if not has_custom_v2_modify_js_func: + cls_name = getattr(tp, '__name__', None) + raise PydanticUserError( + f'The `__modify_schema__` method is not supported in Pydantic v2. ' + f'Use `__get_pydantic_json_schema__` instead{f" in class `{cls_name}`" if cls_name else ""}.', + code='custom-json-schema', + ) + + # handle GenericAlias' but ignore Annotated which "lies" about its origin (in this case it would be `int`) + if hasattr(tp, '__origin__') and not isinstance(tp, type(Annotated[int, 'placeholder'])): + return _extract_get_pydantic_json_schema(tp.__origin__, schema) + + if js_modify_function is None: + return None + + return js_modify_function + + +def get_json_schema_update_func( + json_schema_update: JsonSchemaValue, json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None +) -> GetJsonSchemaFunction: + def json_schema_update_func( + core_schema_or_field: CoreSchemaOrField, handler: GetJsonSchemaHandler + ) -> JsonSchemaValue: + json_schema = {**handler(core_schema_or_field), **json_schema_update} + add_json_schema_extra(json_schema, json_schema_extra) + return json_schema + + return json_schema_update_func + + +def add_json_schema_extra( + json_schema: JsonSchemaValue, json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None +): + if isinstance(json_schema_extra, dict): + json_schema.update(to_jsonable_python(json_schema_extra)) + elif callable(json_schema_extra): + json_schema_extra(json_schema) + + +class _CommonField(TypedDict): + schema: core_schema.CoreSchema + validation_alias: str | list[str | int] | list[list[str | int]] | None + serialization_alias: str | None + serialization_exclude: bool | None + frozen: bool | None + metadata: dict[str, Any] + + +def _common_field( + schema: core_schema.CoreSchema, + *, + validation_alias: str | list[str | int] | list[list[str | int]] | None = None, + serialization_alias: str | None = None, + serialization_exclude: bool | None = None, + frozen: bool | None = None, + metadata: Any = None, +) -> _CommonField: + return { + 'schema': schema, + 'validation_alias': validation_alias, + 'serialization_alias': serialization_alias, + 'serialization_exclude': serialization_exclude, + 'frozen': frozen, + 'metadata': metadata, + } + + +class _Definitions: + """Keeps track of references and definitions.""" + + def __init__(self) -> None: + self.seen: set[str] = set() + self.definitions: dict[str, core_schema.CoreSchema] = {} + + @contextmanager + def get_schema_or_ref(self, tp: Any) -> Iterator[tuple[str, None] | tuple[str, CoreSchema]]: + """Get a definition for `tp` if one exists. + + If a definition exists, a tuple of `(ref_string, CoreSchema)` is returned. + If no definition exists yet, a tuple of `(ref_string, None)` is returned. + + Note that the returned `CoreSchema` will always be a `DefinitionReferenceSchema`, + not the actual definition itself. + + This should be called for any type that can be identified by reference. + This includes any recursive types. + + At present the following types can be named/recursive: + + - BaseModel + - Dataclasses + - TypedDict + - TypeAliasType + """ + ref = get_type_ref(tp) + # return the reference if we're either (1) in a cycle or (2) it was already defined + if ref in self.seen or ref in self.definitions: + yield (ref, core_schema.definition_reference_schema(ref)) + else: + self.seen.add(ref) + try: + yield (ref, None) + finally: + self.seen.discard(ref) + + +def resolve_original_schema(schema: CoreSchema, definitions: dict[str, CoreSchema]) -> CoreSchema | None: + if schema['type'] == 'definition-ref': + return definitions.get(schema['schema_ref'], None) + elif schema['type'] == 'definitions': + return schema['schema'] + else: + return schema + + +class _FieldNameStack: + __slots__ = ('_stack',) + + def __init__(self) -> None: + self._stack: list[str] = [] + + @contextmanager + def push(self, field_name: str) -> Iterator[None]: + self._stack.append(field_name) + yield + self._stack.pop() + + def get(self) -> str | None: + if self._stack: + return self._stack[-1] + else: + return None + + +class _ModelTypeStack: + __slots__ = ('_stack',) + + def __init__(self) -> None: + self._stack: list[type] = [] + + @contextmanager + def push(self, type_obj: type) -> Iterator[None]: + self._stack.append(type_obj) + yield + self._stack.pop() + + def get(self) -> type | None: + if self._stack: + return self._stack[-1] + else: + return None diff --git a/env/Lib/site-packages/pydantic/_internal/_generics.py b/env/Lib/site-packages/pydantic/_internal/_generics.py new file mode 100644 index 0000000..0bd106b --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_generics.py @@ -0,0 +1,516 @@ +from __future__ import annotations + +import sys +import types +import typing +from collections import ChainMap +from contextlib import contextmanager +from contextvars import ContextVar +from types import prepare_class +from typing import TYPE_CHECKING, Any, Iterator, List, Mapping, MutableMapping, Tuple, TypeVar +from weakref import WeakValueDictionary + +import typing_extensions + +from ._core_utils import get_type_ref +from ._forward_ref import PydanticRecursiveRef +from ._typing_extra import TypeVarType, typing_base +from ._utils import all_identical, is_model_class + +if sys.version_info >= (3, 10): + from typing import _UnionGenericAlias # type: ignore[attr-defined] + +if TYPE_CHECKING: + from ..main import BaseModel + +GenericTypesCacheKey = Tuple[Any, Any, Tuple[Any, ...]] + +# Note: We want to remove LimitedDict, but to do this, we'd need to improve the handling of generics caching. +# Right now, to handle recursive generics, we some types must remain cached for brief periods without references. +# By chaining the WeakValuesDict with a LimitedDict, we have a way to retain caching for all types with references, +# while also retaining a limited number of types even without references. This is generally enough to build +# specific recursive generic models without losing required items out of the cache. + +KT = TypeVar('KT') +VT = TypeVar('VT') +_LIMITED_DICT_SIZE = 100 +if TYPE_CHECKING: + + class LimitedDict(dict, MutableMapping[KT, VT]): + def __init__(self, size_limit: int = _LIMITED_DICT_SIZE): ... + +else: + + class LimitedDict(dict): + """Limit the size/length of a dict used for caching to avoid unlimited increase in memory usage. + + Since the dict is ordered, and we always remove elements from the beginning, this is effectively a FIFO cache. + """ + + def __init__(self, size_limit: int = _LIMITED_DICT_SIZE): + self.size_limit = size_limit + super().__init__() + + def __setitem__(self, key: Any, value: Any, /) -> None: + super().__setitem__(key, value) + if len(self) > self.size_limit: + excess = len(self) - self.size_limit + self.size_limit // 10 + to_remove = list(self.keys())[:excess] + for k in to_remove: + del self[k] + + +# weak dictionaries allow the dynamically created parametrized versions of generic models to get collected +# once they are no longer referenced by the caller. +if sys.version_info >= (3, 9): # Typing for weak dictionaries available at 3.9 + GenericTypesCache = WeakValueDictionary[GenericTypesCacheKey, 'type[BaseModel]'] +else: + GenericTypesCache = WeakValueDictionary + +if TYPE_CHECKING: + + class DeepChainMap(ChainMap[KT, VT]): # type: ignore + ... + +else: + + class DeepChainMap(ChainMap): + """Variant of ChainMap that allows direct updates to inner scopes. + + Taken from https://docs.python.org/3/library/collections.html#collections.ChainMap, + with some light modifications for this use case. + """ + + def clear(self) -> None: + for mapping in self.maps: + mapping.clear() + + def __setitem__(self, key: KT, value: VT) -> None: + for mapping in self.maps: + mapping[key] = value + + def __delitem__(self, key: KT) -> None: + hit = False + for mapping in self.maps: + if key in mapping: + del mapping[key] + hit = True + if not hit: + raise KeyError(key) + + +# Despite the fact that LimitedDict _seems_ no longer necessary, I'm very nervous to actually remove it +# and discover later on that we need to re-add all this infrastructure... +# _GENERIC_TYPES_CACHE = DeepChainMap(GenericTypesCache(), LimitedDict()) + +_GENERIC_TYPES_CACHE = GenericTypesCache() + + +class PydanticGenericMetadata(typing_extensions.TypedDict): + origin: type[BaseModel] | None # analogous to typing._GenericAlias.__origin__ + args: tuple[Any, ...] # analogous to typing._GenericAlias.__args__ + parameters: tuple[type[Any], ...] # analogous to typing.Generic.__parameters__ + + +def create_generic_submodel( + model_name: str, origin: type[BaseModel], args: tuple[Any, ...], params: tuple[Any, ...] +) -> type[BaseModel]: + """Dynamically create a submodel of a provided (generic) BaseModel. + + This is used when producing concrete parametrizations of generic models. This function + only *creates* the new subclass; the schema/validators/serialization must be updated to + reflect a concrete parametrization elsewhere. + + Args: + model_name: The name of the newly created model. + origin: The base class for the new model to inherit from. + args: A tuple of generic metadata arguments. + params: A tuple of generic metadata parameters. + + Returns: + The created submodel. + """ + namespace: dict[str, Any] = {'__module__': origin.__module__} + bases = (origin,) + meta, ns, kwds = prepare_class(model_name, bases) + namespace.update(ns) + created_model = meta( + model_name, + bases, + namespace, + __pydantic_generic_metadata__={ + 'origin': origin, + 'args': args, + 'parameters': params, + }, + __pydantic_reset_parent_namespace__=False, + **kwds, + ) + + model_module, called_globally = _get_caller_frame_info(depth=3) + if called_globally: # create global reference and therefore allow pickling + object_by_reference = None + reference_name = model_name + reference_module_globals = sys.modules[created_model.__module__].__dict__ + while object_by_reference is not created_model: + object_by_reference = reference_module_globals.setdefault(reference_name, created_model) + reference_name += '_' + + return created_model + + +def _get_caller_frame_info(depth: int = 2) -> tuple[str | None, bool]: + """Used inside a function to check whether it was called globally. + + Args: + depth: The depth to get the frame. + + Returns: + A tuple contains `module_name` and `called_globally`. + + Raises: + RuntimeError: If the function is not called inside a function. + """ + try: + previous_caller_frame = sys._getframe(depth) + except ValueError as e: + raise RuntimeError('This function must be used inside another function') from e + except AttributeError: # sys module does not have _getframe function, so there's nothing we can do about it + return None, False + frame_globals = previous_caller_frame.f_globals + return frame_globals.get('__name__'), previous_caller_frame.f_locals is frame_globals + + +DictValues: type[Any] = {}.values().__class__ + + +def iter_contained_typevars(v: Any) -> Iterator[TypeVarType]: + """Recursively iterate through all subtypes and type args of `v` and yield any typevars that are found. + + This is inspired as an alternative to directly accessing the `__parameters__` attribute of a GenericAlias, + since __parameters__ of (nested) generic BaseModel subclasses won't show up in that list. + """ + if isinstance(v, TypeVar): + yield v + elif is_model_class(v): + yield from v.__pydantic_generic_metadata__['parameters'] + elif isinstance(v, (DictValues, list)): + for var in v: + yield from iter_contained_typevars(var) + else: + args = get_args(v) + for arg in args: + yield from iter_contained_typevars(arg) + + +def get_args(v: Any) -> Any: + pydantic_generic_metadata: PydanticGenericMetadata | None = getattr(v, '__pydantic_generic_metadata__', None) + if pydantic_generic_metadata: + return pydantic_generic_metadata.get('args') + return typing_extensions.get_args(v) + + +def get_origin(v: Any) -> Any: + pydantic_generic_metadata: PydanticGenericMetadata | None = getattr(v, '__pydantic_generic_metadata__', None) + if pydantic_generic_metadata: + return pydantic_generic_metadata.get('origin') + return typing_extensions.get_origin(v) + + +def get_standard_typevars_map(cls: type[Any]) -> dict[TypeVarType, Any] | None: + """Package a generic type's typevars and parametrization (if present) into a dictionary compatible with the + `replace_types` function. Specifically, this works with standard typing generics and typing._GenericAlias. + """ + origin = get_origin(cls) + if origin is None: + return None + if not hasattr(origin, '__parameters__'): + return None + + # In this case, we know that cls is a _GenericAlias, and origin is the generic type + # So it is safe to access cls.__args__ and origin.__parameters__ + args: tuple[Any, ...] = cls.__args__ # type: ignore + parameters: tuple[TypeVarType, ...] = origin.__parameters__ + return dict(zip(parameters, args)) + + +def get_model_typevars_map(cls: type[BaseModel]) -> dict[TypeVarType, Any] | None: + """Package a generic BaseModel's typevars and concrete parametrization (if present) into a dictionary compatible + with the `replace_types` function. + + Since BaseModel.__class_getitem__ does not produce a typing._GenericAlias, and the BaseModel generic info is + stored in the __pydantic_generic_metadata__ attribute, we need special handling here. + """ + # TODO: This could be unified with `get_standard_typevars_map` if we stored the generic metadata + # in the __origin__, __args__, and __parameters__ attributes of the model. + generic_metadata = cls.__pydantic_generic_metadata__ + origin = generic_metadata['origin'] + args = generic_metadata['args'] + return dict(zip(iter_contained_typevars(origin), args)) + + +def replace_types(type_: Any, type_map: Mapping[Any, Any] | None) -> Any: + """Return type with all occurrences of `type_map` keys recursively replaced with their values. + + Args: + type_: The class or generic alias. + type_map: Mapping from `TypeVar` instance to concrete types. + + Returns: + A new type representing the basic structure of `type_` with all + `typevar_map` keys recursively replaced. + + Example: + ```py + from typing import List, Tuple, Union + + from pydantic._internal._generics import replace_types + + replace_types(Tuple[str, Union[List[str], float]], {str: int}) + #> Tuple[int, Union[List[int], float]] + ``` + """ + if not type_map: + return type_ + + type_args = get_args(type_) + origin_type = get_origin(type_) + + if origin_type is typing_extensions.Annotated: + annotated_type, *annotations = type_args + annotated = replace_types(annotated_type, type_map) + for annotation in annotations: + annotated = typing_extensions.Annotated[annotated, annotation] + return annotated + + # Having type args is a good indicator that this is a typing module + # class instantiation or a generic alias of some sort. + if type_args: + resolved_type_args = tuple(replace_types(arg, type_map) for arg in type_args) + if all_identical(type_args, resolved_type_args): + # If all arguments are the same, there is no need to modify the + # type or create a new object at all + return type_ + if ( + origin_type is not None + and isinstance(type_, typing_base) + and not isinstance(origin_type, typing_base) + and getattr(type_, '_name', None) is not None + ): + # In python < 3.9 generic aliases don't exist so any of these like `list`, + # `type` or `collections.abc.Callable` need to be translated. + # See: https://www.python.org/dev/peps/pep-0585 + origin_type = getattr(typing, type_._name) + assert origin_type is not None + # PEP-604 syntax (Ex.: list | str) is represented with a types.UnionType object that does not have __getitem__. + # We also cannot use isinstance() since we have to compare types. + if sys.version_info >= (3, 10) and origin_type is types.UnionType: + return _UnionGenericAlias(origin_type, resolved_type_args) + # NotRequired[T] and Required[T] don't support tuple type resolved_type_args, hence the condition below + return origin_type[resolved_type_args[0] if len(resolved_type_args) == 1 else resolved_type_args] + + # We handle pydantic generic models separately as they don't have the same + # semantics as "typing" classes or generic aliases + + if not origin_type and is_model_class(type_): + parameters = type_.__pydantic_generic_metadata__['parameters'] + if not parameters: + return type_ + resolved_type_args = tuple(replace_types(t, type_map) for t in parameters) + if all_identical(parameters, resolved_type_args): + return type_ + return type_[resolved_type_args] + + # Handle special case for typehints that can have lists as arguments. + # `typing.Callable[[int, str], int]` is an example for this. + if isinstance(type_, (List, list)): + resolved_list = list(replace_types(element, type_map) for element in type_) + if all_identical(type_, resolved_list): + return type_ + return resolved_list + + # If all else fails, we try to resolve the type directly and otherwise just + # return the input with no modifications. + return type_map.get(type_, type_) + + +def has_instance_in_type(type_: Any, isinstance_target: Any) -> bool: + """Checks if the type, or any of its arbitrary nested args, satisfy + `isinstance(, isinstance_target)`. + """ + if isinstance(type_, isinstance_target): + return True + + type_args = get_args(type_) + origin_type = get_origin(type_) + + if origin_type is typing_extensions.Annotated: + annotated_type, *annotations = type_args + return has_instance_in_type(annotated_type, isinstance_target) + + # Having type args is a good indicator that this is a typing module + # class instantiation or a generic alias of some sort. + if any(has_instance_in_type(a, isinstance_target) for a in type_args): + return True + + # Handle special case for typehints that can have lists as arguments. + # `typing.Callable[[int, str], int]` is an example for this. + if isinstance(type_, (List, list)) and not isinstance(type_, typing_extensions.ParamSpec): + if any(has_instance_in_type(element, isinstance_target) for element in type_): + return True + + return False + + +def check_parameters_count(cls: type[BaseModel], parameters: tuple[Any, ...]) -> None: + """Check the generic model parameters count is equal. + + Args: + cls: The generic model. + parameters: A tuple of passed parameters to the generic model. + + Raises: + TypeError: If the passed parameters count is not equal to generic model parameters count. + """ + actual = len(parameters) + expected = len(cls.__pydantic_generic_metadata__['parameters']) + if actual != expected: + description = 'many' if actual > expected else 'few' + raise TypeError(f'Too {description} parameters for {cls}; actual {actual}, expected {expected}') + + +_generic_recursion_cache: ContextVar[set[str] | None] = ContextVar('_generic_recursion_cache', default=None) + + +@contextmanager +def generic_recursion_self_type( + origin: type[BaseModel], args: tuple[Any, ...] +) -> Iterator[PydanticRecursiveRef | None]: + """This contextmanager should be placed around the recursive calls used to build a generic type, + and accept as arguments the generic origin type and the type arguments being passed to it. + + If the same origin and arguments are observed twice, it implies that a self-reference placeholder + can be used while building the core schema, and will produce a schema_ref that will be valid in the + final parent schema. + """ + previously_seen_type_refs = _generic_recursion_cache.get() + if previously_seen_type_refs is None: + previously_seen_type_refs = set() + token = _generic_recursion_cache.set(previously_seen_type_refs) + else: + token = None + + try: + type_ref = get_type_ref(origin, args_override=args) + if type_ref in previously_seen_type_refs: + self_type = PydanticRecursiveRef(type_ref=type_ref) + yield self_type + else: + previously_seen_type_refs.add(type_ref) + yield None + finally: + if token: + _generic_recursion_cache.reset(token) + + +def recursively_defined_type_refs() -> set[str]: + visited = _generic_recursion_cache.get() + if not visited: + return set() # not in a generic recursion, so there are no types + + return visited.copy() # don't allow modifications + + +def get_cached_generic_type_early(parent: type[BaseModel], typevar_values: Any) -> type[BaseModel] | None: + """The use of a two-stage cache lookup approach was necessary to have the highest performance possible for + repeated calls to `__class_getitem__` on generic types (which may happen in tighter loops during runtime), + while still ensuring that certain alternative parametrizations ultimately resolve to the same type. + + As a concrete example, this approach was necessary to make Model[List[T]][int] equal to Model[List[int]]. + The approach could be modified to not use two different cache keys at different points, but the + _early_cache_key is optimized to be as quick to compute as possible (for repeated-access speed), and the + _late_cache_key is optimized to be as "correct" as possible, so that two types that will ultimately be the + same after resolving the type arguments will always produce cache hits. + + If we wanted to move to only using a single cache key per type, we would either need to always use the + slower/more computationally intensive logic associated with _late_cache_key, or would need to accept + that Model[List[T]][int] is a different type than Model[List[T]][int]. Because we rely on subclass relationships + during validation, I think it is worthwhile to ensure that types that are functionally equivalent are actually + equal. + """ + return _GENERIC_TYPES_CACHE.get(_early_cache_key(parent, typevar_values)) + + +def get_cached_generic_type_late( + parent: type[BaseModel], typevar_values: Any, origin: type[BaseModel], args: tuple[Any, ...] +) -> type[BaseModel] | None: + """See the docstring of `get_cached_generic_type_early` for more information about the two-stage cache lookup.""" + cached = _GENERIC_TYPES_CACHE.get(_late_cache_key(origin, args, typevar_values)) + if cached is not None: + set_cached_generic_type(parent, typevar_values, cached, origin, args) + return cached + + +def set_cached_generic_type( + parent: type[BaseModel], + typevar_values: tuple[Any, ...], + type_: type[BaseModel], + origin: type[BaseModel] | None = None, + args: tuple[Any, ...] | None = None, +) -> None: + """See the docstring of `get_cached_generic_type_early` for more information about why items are cached with + two different keys. + """ + _GENERIC_TYPES_CACHE[_early_cache_key(parent, typevar_values)] = type_ + if len(typevar_values) == 1: + _GENERIC_TYPES_CACHE[_early_cache_key(parent, typevar_values[0])] = type_ + if origin and args: + _GENERIC_TYPES_CACHE[_late_cache_key(origin, args, typevar_values)] = type_ + + +def _union_orderings_key(typevar_values: Any) -> Any: + """This is intended to help differentiate between Union types with the same arguments in different order. + + Thanks to caching internal to the `typing` module, it is not possible to distinguish between + List[Union[int, float]] and List[Union[float, int]] (and similarly for other "parent" origins besides List) + because `typing` considers Union[int, float] to be equal to Union[float, int]. + + However, you _can_ distinguish between (top-level) Union[int, float] vs. Union[float, int]. + Because we parse items as the first Union type that is successful, we get slightly more consistent behavior + if we make an effort to distinguish the ordering of items in a union. It would be best if we could _always_ + get the exact-correct order of items in the union, but that would require a change to the `typing` module itself. + (See https://github.com/python/cpython/issues/86483 for reference.) + """ + if isinstance(typevar_values, tuple): + args_data = [] + for value in typevar_values: + args_data.append(_union_orderings_key(value)) + return tuple(args_data) + elif typing_extensions.get_origin(typevar_values) is typing.Union: + return get_args(typevar_values) + else: + return () + + +def _early_cache_key(cls: type[BaseModel], typevar_values: Any) -> GenericTypesCacheKey: + """This is intended for minimal computational overhead during lookups of cached types. + + Note that this is overly simplistic, and it's possible that two different cls/typevar_values + inputs would ultimately result in the same type being created in BaseModel.__class_getitem__. + To handle this, we have a fallback _late_cache_key that is checked later if the _early_cache_key + lookup fails, and should result in a cache hit _precisely_ when the inputs to __class_getitem__ + would result in the same type. + """ + return cls, typevar_values, _union_orderings_key(typevar_values) + + +def _late_cache_key(origin: type[BaseModel], args: tuple[Any, ...], typevar_values: Any) -> GenericTypesCacheKey: + """This is intended for use later in the process of creating a new type, when we have more information + about the exact args that will be passed. If it turns out that a different set of inputs to + __class_getitem__ resulted in the same inputs to the generic type creation process, we can still + return the cached type, and update the cache with the _early_cache_key as well. + """ + # The _union_orderings_key is placed at the start here to ensure there cannot be a collision with an + # _early_cache_key, as that function will always produce a BaseModel subclass as the first item in the key, + # whereas this function will always produce a tuple as the first item in the key. + return _union_orderings_key(typevar_values), origin, args diff --git a/env/Lib/site-packages/pydantic/_internal/_git.py b/env/Lib/site-packages/pydantic/_internal/_git.py new file mode 100644 index 0000000..bff0dca --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_git.py @@ -0,0 +1,27 @@ +"""Git utilities, adopted from mypy's git utilities (https://github.com/python/mypy/blob/master/mypy/git.py).""" + +from __future__ import annotations + +import os +import subprocess + + +def is_git_repo(dir: str) -> bool: + """Is the given directory version-controlled with git?""" + return os.path.exists(os.path.join(dir, '.git')) + + +def have_git() -> bool: + """Can we run the git executable?""" + try: + subprocess.check_output(['git', '--help']) + return True + except subprocess.CalledProcessError: + return False + except OSError: + return False + + +def git_revision(dir: str) -> str: + """Get the SHA-1 of the HEAD of a git repository.""" + return subprocess.check_output(['git', 'rev-parse', '--short', 'HEAD'], cwd=dir).decode('utf-8').strip() diff --git a/env/Lib/site-packages/pydantic/_internal/_internal_dataclass.py b/env/Lib/site-packages/pydantic/_internal/_internal_dataclass.py new file mode 100644 index 0000000..33e152c --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_internal_dataclass.py @@ -0,0 +1,7 @@ +import sys + +# `slots` is available on Python >= 3.10 +if sys.version_info >= (3, 10): + slots_true = {'slots': True} +else: + slots_true = {} diff --git a/env/Lib/site-packages/pydantic/_internal/_known_annotated_metadata.py b/env/Lib/site-packages/pydantic/_internal/_known_annotated_metadata.py new file mode 100644 index 0000000..971ab68 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_known_annotated_metadata.py @@ -0,0 +1,359 @@ +from __future__ import annotations + +from collections import defaultdict +from copy import copy +from functools import lru_cache, partial +from typing import TYPE_CHECKING, Any, Callable, Iterable + +from pydantic_core import CoreSchema, PydanticCustomError, to_jsonable_python +from pydantic_core import core_schema as cs + +from ._fields import PydanticMetadata + +if TYPE_CHECKING: + from ..annotated_handlers import GetJsonSchemaHandler + +STRICT = {'strict'} +FAIL_FAST = {'fail_fast'} +LENGTH_CONSTRAINTS = {'min_length', 'max_length'} +INEQUALITY = {'le', 'ge', 'lt', 'gt'} +NUMERIC_CONSTRAINTS = {'multiple_of', *INEQUALITY} +ALLOW_INF_NAN = {'allow_inf_nan'} + +STR_CONSTRAINTS = { + *LENGTH_CONSTRAINTS, + *STRICT, + 'strip_whitespace', + 'to_lower', + 'to_upper', + 'pattern', + 'coerce_numbers_to_str', +} +BYTES_CONSTRAINTS = {*LENGTH_CONSTRAINTS, *STRICT} + +LIST_CONSTRAINTS = {*LENGTH_CONSTRAINTS, *STRICT, *FAIL_FAST} +TUPLE_CONSTRAINTS = {*LENGTH_CONSTRAINTS, *STRICT, *FAIL_FAST} +SET_CONSTRAINTS = {*LENGTH_CONSTRAINTS, *STRICT, *FAIL_FAST} +DICT_CONSTRAINTS = {*LENGTH_CONSTRAINTS, *STRICT} +GENERATOR_CONSTRAINTS = {*LENGTH_CONSTRAINTS, *STRICT} +SEQUENCE_CONSTRAINTS = {*LENGTH_CONSTRAINTS, *FAIL_FAST} + +FLOAT_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *ALLOW_INF_NAN, *STRICT} +DECIMAL_CONSTRAINTS = {'max_digits', 'decimal_places', *FLOAT_CONSTRAINTS} +INT_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *ALLOW_INF_NAN, *STRICT} +BOOL_CONSTRAINTS = STRICT +UUID_CONSTRAINTS = STRICT + +DATE_TIME_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT} +TIMEDELTA_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT} +TIME_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT} +LAX_OR_STRICT_CONSTRAINTS = STRICT +ENUM_CONSTRAINTS = STRICT + +UNION_CONSTRAINTS = {'union_mode'} +URL_CONSTRAINTS = { + 'max_length', + 'allowed_schemes', + 'host_required', + 'default_host', + 'default_port', + 'default_path', +} + +TEXT_SCHEMA_TYPES = ('str', 'bytes', 'url', 'multi-host-url') +SEQUENCE_SCHEMA_TYPES = ('list', 'tuple', 'set', 'frozenset', 'generator', *TEXT_SCHEMA_TYPES) +NUMERIC_SCHEMA_TYPES = ('float', 'int', 'date', 'time', 'timedelta', 'datetime') + +CONSTRAINTS_TO_ALLOWED_SCHEMAS: dict[str, set[str]] = defaultdict(set) + +constraint_schema_pairings: list[tuple[set[str], tuple[str, ...]]] = [ + (STR_CONSTRAINTS, TEXT_SCHEMA_TYPES), + (BYTES_CONSTRAINTS, ('bytes',)), + (LIST_CONSTRAINTS, ('list',)), + (TUPLE_CONSTRAINTS, ('tuple',)), + (SET_CONSTRAINTS, ('set', 'frozenset')), + (DICT_CONSTRAINTS, ('dict',)), + (GENERATOR_CONSTRAINTS, ('generator',)), + (FLOAT_CONSTRAINTS, ('float',)), + (INT_CONSTRAINTS, ('int',)), + (DATE_TIME_CONSTRAINTS, ('date', 'time', 'datetime')), + (TIMEDELTA_CONSTRAINTS, ('timedelta',)), + (TIME_CONSTRAINTS, ('time',)), + # TODO: this is a bit redundant, we could probably avoid some of these + (STRICT, (*TEXT_SCHEMA_TYPES, *SEQUENCE_SCHEMA_TYPES, *NUMERIC_SCHEMA_TYPES, 'typed-dict', 'model')), + (UNION_CONSTRAINTS, ('union',)), + (URL_CONSTRAINTS, ('url', 'multi-host-url')), + (BOOL_CONSTRAINTS, ('bool',)), + (UUID_CONSTRAINTS, ('uuid',)), + (LAX_OR_STRICT_CONSTRAINTS, ('lax-or-strict',)), + (ENUM_CONSTRAINTS, ('enum',)), + (DECIMAL_CONSTRAINTS, ('decimal',)), +] + +for constraints, schemas in constraint_schema_pairings: + for c in constraints: + CONSTRAINTS_TO_ALLOWED_SCHEMAS[c].update(schemas) + + +def add_js_update_schema(s: cs.CoreSchema, f: Callable[[], dict[str, Any]]) -> None: + def update_js_schema(s: cs.CoreSchema, handler: GetJsonSchemaHandler) -> dict[str, Any]: + js_schema = handler(s) + js_schema.update(f()) + return js_schema + + if 'metadata' in s: + metadata = s['metadata'] + if 'pydantic_js_functions' in s: + metadata['pydantic_js_functions'].append(update_js_schema) + else: + metadata['pydantic_js_functions'] = [update_js_schema] + else: + s['metadata'] = {'pydantic_js_functions': [update_js_schema]} + + +def as_jsonable_value(v: Any) -> Any: + if type(v) not in (int, str, float, bytes, bool, type(None)): + return to_jsonable_python(v) + return v + + +def expand_grouped_metadata(annotations: Iterable[Any]) -> Iterable[Any]: + """Expand the annotations. + + Args: + annotations: An iterable of annotations. + + Returns: + An iterable of expanded annotations. + + Example: + ```py + from annotated_types import Ge, Len + + from pydantic._internal._known_annotated_metadata import expand_grouped_metadata + + print(list(expand_grouped_metadata([Ge(4), Len(5)]))) + #> [Ge(ge=4), MinLen(min_length=5)] + ``` + """ + import annotated_types as at + + from pydantic.fields import FieldInfo # circular import + + for annotation in annotations: + if isinstance(annotation, at.GroupedMetadata): + yield from annotation + elif isinstance(annotation, FieldInfo): + yield from annotation.metadata + # this is a bit problematic in that it results in duplicate metadata + # all of our "consumers" can handle it, but it is not ideal + # we probably should split up FieldInfo into: + # - annotated types metadata + # - individual metadata known only to Pydantic + annotation = copy(annotation) + annotation.metadata = [] + yield annotation + else: + yield annotation + + +@lru_cache +def _get_at_to_constraint_map() -> dict[type, str]: + """Return a mapping of annotated types to constraints. + + Normally, we would define a mapping like this in the module scope, but we can't do that + because we don't permit module level imports of `annotated_types`, in an attempt to speed up + the import time of `pydantic`. We still only want to have this dictionary defined in one place, + so we use this function to cache the result. + """ + import annotated_types as at + + return { + at.Gt: 'gt', + at.Ge: 'ge', + at.Lt: 'lt', + at.Le: 'le', + at.MultipleOf: 'multiple_of', + at.MinLen: 'min_length', + at.MaxLen: 'max_length', + } + + +def apply_known_metadata(annotation: Any, schema: CoreSchema) -> CoreSchema | None: # noqa: C901 + """Apply `annotation` to `schema` if it is an annotation we know about (Gt, Le, etc.). + Otherwise return `None`. + + This does not handle all known annotations. If / when it does, it can always + return a CoreSchema and return the unmodified schema if the annotation should be ignored. + + Assumes that GroupedMetadata has already been expanded via `expand_grouped_metadata`. + + Args: + annotation: The annotation. + schema: The schema. + + Returns: + An updated schema with annotation if it is an annotation we know about, `None` otherwise. + + Raises: + PydanticCustomError: If `Predicate` fails. + """ + import annotated_types as at + + from ._validators import forbid_inf_nan_check, get_constraint_validator + + schema = schema.copy() + schema_update, other_metadata = collect_known_metadata([annotation]) + schema_type = schema['type'] + + chain_schema_constraints: set[str] = { + 'pattern', + 'strip_whitespace', + 'to_lower', + 'to_upper', + 'coerce_numbers_to_str', + } + chain_schema_steps: list[CoreSchema] = [] + + for constraint, value in schema_update.items(): + if constraint not in CONSTRAINTS_TO_ALLOWED_SCHEMAS: + raise ValueError(f'Unknown constraint {constraint}') + allowed_schemas = CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint] + + # if it becomes necessary to handle more than one constraint + # in this recursive case with function-after or function-wrap, we should refactor + # this is a bit challenging because we sometimes want to apply constraints to the inner schema, + # whereas other times we want to wrap the existing schema with a new one that enforces a new constraint. + if schema_type in {'function-before', 'function-wrap', 'function-after'} and constraint == 'strict': + schema['schema'] = apply_known_metadata(annotation, schema['schema']) # type: ignore # schema is function-after schema + return schema + + if schema_type in allowed_schemas: + if constraint == 'union_mode' and schema_type == 'union': + schema['mode'] = value # type: ignore # schema is UnionSchema + else: + schema[constraint] = value + continue + + if constraint in chain_schema_constraints: + chain_schema_steps.append(cs.str_schema(**{constraint: value})) + elif constraint in {*NUMERIC_CONSTRAINTS, *LENGTH_CONSTRAINTS}: + if constraint in NUMERIC_CONSTRAINTS: + json_schema_constraint = constraint + elif constraint in LENGTH_CONSTRAINTS: + inner_schema = schema + while inner_schema['type'] in {'function-before', 'function-wrap', 'function-after'}: + inner_schema = inner_schema['schema'] # type: ignore + inner_schema_type = inner_schema['type'] + if inner_schema_type == 'list' or ( + inner_schema_type == 'json-or-python' and inner_schema['json_schema']['type'] == 'list' # type: ignore + ): + json_schema_constraint = 'minItems' if constraint == 'min_length' else 'maxItems' + else: + json_schema_constraint = 'minLength' if constraint == 'min_length' else 'maxLength' + + schema = cs.no_info_after_validator_function( + partial(get_constraint_validator(constraint), **{constraint: value}), schema + ) + add_js_update_schema(schema, lambda: {json_schema_constraint: as_jsonable_value(value)}) + elif constraint == 'allow_inf_nan' and value is False: + schema = cs.no_info_after_validator_function( + forbid_inf_nan_check, + schema, + ) + else: + raise RuntimeError(f'Unable to apply constraint {constraint} to schema {schema_type}') + + for annotation in other_metadata: + if (annotation_type := type(annotation)) in (at_to_constraint_map := _get_at_to_constraint_map()): + constraint = at_to_constraint_map[annotation_type] + schema = cs.no_info_after_validator_function( + partial(get_constraint_validator(constraint), {constraint: getattr(annotation, constraint)}), schema + ) + continue + elif isinstance(annotation, at.Predicate): + predicate_name = f'{annotation.func.__qualname__} ' if hasattr(annotation.func, '__qualname__') else '' + + def val_func(v: Any) -> Any: + # annotation.func may also raise an exception, let it pass through + if not annotation.func(v): + raise PydanticCustomError( + 'predicate_failed', + f'Predicate {predicate_name}failed', # type: ignore + ) + return v + + schema = cs.no_info_after_validator_function(val_func, schema) + else: + # ignore any other unknown metadata + return None + + if chain_schema_steps: + chain_schema_steps = [schema] + chain_schema_steps + return cs.chain_schema(chain_schema_steps) + + return schema + + +def collect_known_metadata(annotations: Iterable[Any]) -> tuple[dict[str, Any], list[Any]]: + """Split `annotations` into known metadata and unknown annotations. + + Args: + annotations: An iterable of annotations. + + Returns: + A tuple contains a dict of known metadata and a list of unknown annotations. + + Example: + ```py + from annotated_types import Gt, Len + + from pydantic._internal._known_annotated_metadata import collect_known_metadata + + print(collect_known_metadata([Gt(1), Len(42), ...])) + #> ({'gt': 1, 'min_length': 42}, [Ellipsis]) + ``` + """ + annotations = expand_grouped_metadata(annotations) + + res: dict[str, Any] = {} + remaining: list[Any] = [] + + for annotation in annotations: + # isinstance(annotation, PydanticMetadata) also covers ._fields:_PydanticGeneralMetadata + if isinstance(annotation, PydanticMetadata): + res.update(annotation.__dict__) + # we don't use dataclasses.asdict because that recursively calls asdict on the field values + elif (annotation_type := type(annotation)) in (at_to_constraint_map := _get_at_to_constraint_map()): + constraint = at_to_constraint_map[annotation_type] + res[constraint] = getattr(annotation, constraint) + elif isinstance(annotation, type) and issubclass(annotation, PydanticMetadata): + # also support PydanticMetadata classes being used without initialisation, + # e.g. `Annotated[int, Strict]` as well as `Annotated[int, Strict()]` + res.update({k: v for k, v in vars(annotation).items() if not k.startswith('_')}) + else: + remaining.append(annotation) + # Nones can sneak in but pydantic-core will reject them + # it'd be nice to clean things up so we don't put in None (we probably don't _need_ to, it was just easier) + # but this is simple enough to kick that can down the road + res = {k: v for k, v in res.items() if v is not None} + return res, remaining + + +def check_metadata(metadata: dict[str, Any], allowed: Iterable[str], source_type: Any) -> None: + """A small utility function to validate that the given metadata can be applied to the target. + More than saving lines of code, this gives us a consistent error message for all of our internal implementations. + + Args: + metadata: A dict of metadata. + allowed: An iterable of allowed metadata. + source_type: The source type. + + Raises: + TypeError: If there is metadatas that can't be applied on source type. + """ + unknown = metadata.keys() - set(allowed) + if unknown: + raise TypeError( + f'The following constraints cannot be applied to {source_type!r}: {", ".join([f"{k!r}" for k in unknown])}' + ) diff --git a/env/Lib/site-packages/pydantic/_internal/_mock_val_ser.py b/env/Lib/site-packages/pydantic/_internal/_mock_val_ser.py new file mode 100644 index 0000000..3e55af7 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_mock_val_ser.py @@ -0,0 +1,194 @@ +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Callable, Generic, Iterator, Mapping, TypeVar, Union + +from pydantic_core import CoreSchema, SchemaSerializer, SchemaValidator +from typing_extensions import Literal + +from ..errors import PydanticErrorCodes, PydanticUserError +from ..plugin._schema_validator import PluggableSchemaValidator + +if TYPE_CHECKING: + from ..dataclasses import PydanticDataclass + from ..main import BaseModel + + +ValSer = TypeVar('ValSer', bound=Union[SchemaValidator, PluggableSchemaValidator, SchemaSerializer]) +T = TypeVar('T') + + +class MockCoreSchema(Mapping[str, Any]): + """Mocker for `pydantic_core.CoreSchema` which optionally attempts to + rebuild the thing it's mocking when one of its methods is accessed and raises an error if that fails. + """ + + __slots__ = '_error_message', '_code', '_attempt_rebuild', '_built_memo' + + def __init__( + self, + error_message: str, + *, + code: PydanticErrorCodes, + attempt_rebuild: Callable[[], CoreSchema | None] | None = None, + ) -> None: + self._error_message = error_message + self._code: PydanticErrorCodes = code + self._attempt_rebuild = attempt_rebuild + self._built_memo: CoreSchema | None = None + + def __getitem__(self, key: str) -> Any: + return self._get_built().__getitem__(key) + + def __len__(self) -> int: + return self._get_built().__len__() + + def __iter__(self) -> Iterator[str]: + return self._get_built().__iter__() + + def _get_built(self) -> CoreSchema: + if self._built_memo is not None: + return self._built_memo + + if self._attempt_rebuild: + schema = self._attempt_rebuild() + if schema is not None: + self._built_memo = schema + return schema + raise PydanticUserError(self._error_message, code=self._code) + + def rebuild(self) -> CoreSchema | None: + self._built_memo = None + if self._attempt_rebuild: + val_ser = self._attempt_rebuild() + if val_ser is not None: + return val_ser + else: + raise PydanticUserError(self._error_message, code=self._code) + return None + + +class MockValSer(Generic[ValSer]): + """Mocker for `pydantic_core.SchemaValidator` or `pydantic_core.SchemaSerializer` which optionally attempts to + rebuild the thing it's mocking when one of its methods is accessed and raises an error if that fails. + """ + + __slots__ = '_error_message', '_code', '_val_or_ser', '_attempt_rebuild' + + def __init__( + self, + error_message: str, + *, + code: PydanticErrorCodes, + val_or_ser: Literal['validator', 'serializer'], + attempt_rebuild: Callable[[], ValSer | None] | None = None, + ) -> None: + self._error_message = error_message + self._val_or_ser = SchemaValidator if val_or_ser == 'validator' else SchemaSerializer + self._code: PydanticErrorCodes = code + self._attempt_rebuild = attempt_rebuild + + def __getattr__(self, item: str) -> None: + __tracebackhide__ = True + if self._attempt_rebuild: + val_ser = self._attempt_rebuild() + if val_ser is not None: + return getattr(val_ser, item) + + # raise an AttributeError if `item` doesn't exist + getattr(self._val_or_ser, item) + raise PydanticUserError(self._error_message, code=self._code) + + def rebuild(self) -> ValSer | None: + if self._attempt_rebuild: + val_ser = self._attempt_rebuild() + if val_ser is not None: + return val_ser + else: + raise PydanticUserError(self._error_message, code=self._code) + return None + + +def set_model_mocks(cls: type[BaseModel], cls_name: str, undefined_name: str = 'all referenced types') -> None: + """Set `__pydantic_validator__` and `__pydantic_serializer__` to `MockValSer`s on a model. + + Args: + cls: The model class to set the mocks on + cls_name: Name of the model class, used in error messages + undefined_name: Name of the undefined thing, used in error messages + """ + undefined_type_error_message = ( + f'`{cls_name}` is not fully defined; you should define {undefined_name},' + f' then call `{cls_name}.model_rebuild()`.' + ) + + def attempt_rebuild_fn(attr_fn: Callable[[type[BaseModel]], T]) -> Callable[[], T | None]: + def handler() -> T | None: + if cls.model_rebuild(raise_errors=False, _parent_namespace_depth=5) is not False: + return attr_fn(cls) + else: + return None + + return handler + + cls.__pydantic_core_schema__ = MockCoreSchema( # type: ignore[assignment] + undefined_type_error_message, + code='class-not-fully-defined', + attempt_rebuild=attempt_rebuild_fn(lambda c: c.__pydantic_core_schema__), + ) + cls.__pydantic_validator__ = MockValSer( # type: ignore[assignment] + undefined_type_error_message, + code='class-not-fully-defined', + val_or_ser='validator', + attempt_rebuild=attempt_rebuild_fn(lambda c: c.__pydantic_validator__), + ) + cls.__pydantic_serializer__ = MockValSer( # type: ignore[assignment] + undefined_type_error_message, + code='class-not-fully-defined', + val_or_ser='serializer', + attempt_rebuild=attempt_rebuild_fn(lambda c: c.__pydantic_serializer__), + ) + + +def set_dataclass_mocks( + cls: type[PydanticDataclass], cls_name: str, undefined_name: str = 'all referenced types' +) -> None: + """Set `__pydantic_validator__` and `__pydantic_serializer__` to `MockValSer`s on a dataclass. + + Args: + cls: The model class to set the mocks on + cls_name: Name of the model class, used in error messages + undefined_name: Name of the undefined thing, used in error messages + """ + from ..dataclasses import rebuild_dataclass + + undefined_type_error_message = ( + f'`{cls_name}` is not fully defined; you should define {undefined_name},' + f' then call `pydantic.dataclasses.rebuild_dataclass({cls_name})`.' + ) + + def attempt_rebuild_fn(attr_fn: Callable[[type[PydanticDataclass]], T]) -> Callable[[], T | None]: + def handler() -> T | None: + if rebuild_dataclass(cls, raise_errors=False, _parent_namespace_depth=5) is not False: + return attr_fn(cls) + else: + return None + + return handler + + cls.__pydantic_core_schema__ = MockCoreSchema( # type: ignore[assignment] + undefined_type_error_message, + code='class-not-fully-defined', + attempt_rebuild=attempt_rebuild_fn(lambda c: c.__pydantic_core_schema__), + ) + cls.__pydantic_validator__ = MockValSer( # type: ignore[assignment] + undefined_type_error_message, + code='class-not-fully-defined', + val_or_ser='validator', + attempt_rebuild=attempt_rebuild_fn(lambda c: c.__pydantic_validator__), + ) + cls.__pydantic_serializer__ = MockValSer( # type: ignore[assignment] + undefined_type_error_message, + code='class-not-fully-defined', + val_or_ser='validator', + attempt_rebuild=attempt_rebuild_fn(lambda c: c.__pydantic_serializer__), + ) diff --git a/env/Lib/site-packages/pydantic/_internal/_model_construction.py b/env/Lib/site-packages/pydantic/_internal/_model_construction.py new file mode 100644 index 0000000..3212476 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_model_construction.py @@ -0,0 +1,708 @@ +"""Private logic for creating models.""" + +from __future__ import annotations as _annotations + +import builtins +import operator +import typing +import warnings +import weakref +from abc import ABCMeta +from functools import partial +from types import FunctionType +from typing import Any, Callable, Generic, NoReturn + +import typing_extensions +from pydantic_core import PydanticUndefined, SchemaSerializer +from typing_extensions import dataclass_transform, deprecated + +from ..errors import PydanticUndefinedAnnotation, PydanticUserError +from ..plugin._schema_validator import create_schema_validator +from ..warnings import GenericBeforeBaseModelWarning, PydanticDeprecatedSince20 +from ._config import ConfigWrapper +from ._decorators import DecoratorInfos, PydanticDescriptorProxy, get_attribute_from_bases, unwrap_wrapped_function +from ._fields import collect_model_fields, is_valid_field_name, is_valid_privateattr_name +from ._generate_schema import GenerateSchema +from ._generics import PydanticGenericMetadata, get_model_typevars_map +from ._mock_val_ser import set_model_mocks +from ._schema_generation_shared import CallbackGetCoreSchemaHandler +from ._signature import generate_pydantic_signature +from ._typing_extra import get_cls_types_namespace, is_annotated, is_classvar, parent_frame_namespace +from ._utils import ClassAttribute, SafeGetItemProxy +from ._validate_call import ValidateCallWrapper + +if typing.TYPE_CHECKING: + from ..fields import Field as PydanticModelField + from ..fields import FieldInfo, ModelPrivateAttr + from ..fields import PrivateAttr as PydanticModelPrivateAttr + from ..main import BaseModel +else: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + PydanticModelField = object() + PydanticModelPrivateAttr = object() + +object_setattr = object.__setattr__ + + +class _ModelNamespaceDict(dict): + """A dictionary subclass that intercepts attribute setting on model classes and + warns about overriding of decorators. + """ + + def __setitem__(self, k: str, v: object) -> None: + existing: Any = self.get(k, None) + if existing and v is not existing and isinstance(existing, PydanticDescriptorProxy): + warnings.warn(f'`{k}` overrides an existing Pydantic `{existing.decorator_info.decorator_repr}` decorator') + + return super().__setitem__(k, v) + + +@dataclass_transform(kw_only_default=True, field_specifiers=(PydanticModelField, PydanticModelPrivateAttr)) +class ModelMetaclass(ABCMeta): + def __new__( + mcs, + cls_name: str, + bases: tuple[type[Any], ...], + namespace: dict[str, Any], + __pydantic_generic_metadata__: PydanticGenericMetadata | None = None, + __pydantic_reset_parent_namespace__: bool = True, + _create_model_module: str | None = None, + **kwargs: Any, + ) -> type: + """Metaclass for creating Pydantic models. + + Args: + cls_name: The name of the class to be created. + bases: The base classes of the class to be created. + namespace: The attribute dictionary of the class to be created. + __pydantic_generic_metadata__: Metadata for generic models. + __pydantic_reset_parent_namespace__: Reset parent namespace. + _create_model_module: The module of the class to be created, if created by `create_model`. + **kwargs: Catch-all for any other keyword arguments. + + Returns: + The new class created by the metaclass. + """ + # Note `ModelMetaclass` refers to `BaseModel`, but is also used to *create* `BaseModel`, so we rely on the fact + # that `BaseModel` itself won't have any bases, but any subclass of it will, to determine whether the `__new__` + # call we're in the middle of is for the `BaseModel` class. + if bases: + base_field_names, class_vars, base_private_attributes = mcs._collect_bases_data(bases) + + config_wrapper = ConfigWrapper.for_model(bases, namespace, kwargs) + namespace['model_config'] = config_wrapper.config_dict + private_attributes = inspect_namespace( + namespace, config_wrapper.ignored_types, class_vars, base_field_names + ) + if private_attributes or base_private_attributes: + original_model_post_init = get_model_post_init(namespace, bases) + if original_model_post_init is not None: + # if there are private_attributes and a model_post_init function, we handle both + + def wrapped_model_post_init(self: BaseModel, context: Any, /) -> None: + """We need to both initialize private attributes and call the user-defined model_post_init + method. + """ + init_private_attributes(self, context) + original_model_post_init(self, context) + + namespace['model_post_init'] = wrapped_model_post_init + else: + namespace['model_post_init'] = init_private_attributes + + namespace['__class_vars__'] = class_vars + namespace['__private_attributes__'] = {**base_private_attributes, **private_attributes} + + cls: type[BaseModel] = super().__new__(mcs, cls_name, bases, namespace, **kwargs) # type: ignore + + from ..main import BaseModel + + mro = cls.__mro__ + if Generic in mro and mro.index(Generic) < mro.index(BaseModel): + warnings.warn( + GenericBeforeBaseModelWarning( + 'Classes should inherit from `BaseModel` before generic classes (e.g. `typing.Generic[T]`) ' + 'for pydantic generics to work properly.' + ), + stacklevel=2, + ) + + cls.__pydantic_custom_init__ = not getattr(cls.__init__, '__pydantic_base_init__', False) + cls.__pydantic_post_init__ = None if cls.model_post_init is BaseModel.model_post_init else 'model_post_init' + + cls.__pydantic_decorators__ = DecoratorInfos.build(cls) + + # Use the getattr below to grab the __parameters__ from the `typing.Generic` parent class + if __pydantic_generic_metadata__: + cls.__pydantic_generic_metadata__ = __pydantic_generic_metadata__ + else: + parent_parameters = getattr(cls, '__pydantic_generic_metadata__', {}).get('parameters', ()) + parameters = getattr(cls, '__parameters__', None) or parent_parameters + if parameters and parent_parameters and not all(x in parameters for x in parent_parameters): + from ..root_model import RootModelRootType + + missing_parameters = tuple(x for x in parameters if x not in parent_parameters) + if RootModelRootType in parent_parameters and RootModelRootType not in parameters: + # This is a special case where the user has subclassed `RootModel`, but has not parametrized + # RootModel with the generic type identifiers being used. Ex: + # class MyModel(RootModel, Generic[T]): + # root: T + # Should instead just be: + # class MyModel(RootModel[T]): + # root: T + parameters_str = ', '.join([x.__name__ for x in missing_parameters]) + error_message = ( + f'{cls.__name__} is a subclass of `RootModel`, but does not include the generic type identifier(s) ' + f'{parameters_str} in its parameters. ' + f'You should parametrize RootModel directly, e.g., `class {cls.__name__}(RootModel[{parameters_str}]): ...`.' + ) + else: + combined_parameters = parent_parameters + missing_parameters + parameters_str = ', '.join([str(x) for x in combined_parameters]) + generic_type_label = f'typing.Generic[{parameters_str}]' + error_message = ( + f'All parameters must be present on typing.Generic;' + f' you should inherit from {generic_type_label}.' + ) + if Generic not in bases: # pragma: no cover + # We raise an error here not because it is desirable, but because some cases are mishandled. + # It would be nice to remove this error and still have things behave as expected, it's just + # challenging because we are using a custom `__class_getitem__` to parametrize generic models, + # and not returning a typing._GenericAlias from it. + bases_str = ', '.join([x.__name__ for x in bases] + [generic_type_label]) + error_message += ( + f' Note: `typing.Generic` must go last: `class {cls.__name__}({bases_str}): ...`)' + ) + raise TypeError(error_message) + + cls.__pydantic_generic_metadata__ = { + 'origin': None, + 'args': (), + 'parameters': parameters, + } + + cls.__pydantic_complete__ = False # Ensure this specific class gets completed + + # preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487 + # for attributes not in `new_namespace` (e.g. private attributes) + for name, obj in private_attributes.items(): + obj.__set_name__(cls, name) + + if __pydantic_reset_parent_namespace__: + cls.__pydantic_parent_namespace__ = build_lenient_weakvaluedict(parent_frame_namespace()) + parent_namespace = getattr(cls, '__pydantic_parent_namespace__', None) + if isinstance(parent_namespace, dict): + parent_namespace = unpack_lenient_weakvaluedict(parent_namespace) + + types_namespace = get_cls_types_namespace(cls, parent_namespace) + set_model_fields(cls, bases, config_wrapper, types_namespace) + + if config_wrapper.frozen and '__hash__' not in namespace: + set_default_hash_func(cls, bases) + + complete_model_class( + cls, + cls_name, + config_wrapper, + raise_errors=False, + types_namespace=types_namespace, + create_model_module=_create_model_module, + ) + + # If this is placed before the complete_model_class call above, + # the generic computed fields return type is set to PydanticUndefined + cls.model_computed_fields = {k: v.info for k, v in cls.__pydantic_decorators__.computed_fields.items()} + + set_deprecated_descriptors(cls) + + # using super(cls, cls) on the next line ensures we only call the parent class's __pydantic_init_subclass__ + # I believe the `type: ignore` is only necessary because mypy doesn't realize that this code branch is + # only hit for _proper_ subclasses of BaseModel + super(cls, cls).__pydantic_init_subclass__(**kwargs) # type: ignore[misc] + return cls + else: + # this is the BaseModel class itself being created, no logic required + return super().__new__(mcs, cls_name, bases, namespace, **kwargs) + + if not typing.TYPE_CHECKING: # pragma: no branch + # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access + + def __getattr__(self, item: str) -> Any: + """This is necessary to keep attribute access working for class attribute access.""" + private_attributes = self.__dict__.get('__private_attributes__') + if private_attributes and item in private_attributes: + return private_attributes[item] + raise AttributeError(item) + + @classmethod + def __prepare__(cls, *args: Any, **kwargs: Any) -> dict[str, object]: + return _ModelNamespaceDict() + + def __instancecheck__(self, instance: Any) -> bool: + """Avoid calling ABC _abc_subclasscheck unless we're pretty sure. + + See #3829 and python/cpython#92810 + """ + return hasattr(instance, '__pydantic_validator__') and super().__instancecheck__(instance) + + @staticmethod + def _collect_bases_data(bases: tuple[type[Any], ...]) -> tuple[set[str], set[str], dict[str, ModelPrivateAttr]]: + from ..main import BaseModel + + field_names: set[str] = set() + class_vars: set[str] = set() + private_attributes: dict[str, ModelPrivateAttr] = {} + for base in bases: + if issubclass(base, BaseModel) and base is not BaseModel: + # model_fields might not be defined yet in the case of generics, so we use getattr here: + field_names.update(getattr(base, 'model_fields', {}).keys()) + class_vars.update(base.__class_vars__) + private_attributes.update(base.__private_attributes__) + return field_names, class_vars, private_attributes + + @property + @deprecated('The `__fields__` attribute is deprecated, use `model_fields` instead.', category=None) + def __fields__(self) -> dict[str, FieldInfo]: + warnings.warn( + 'The `__fields__` attribute is deprecated, use `model_fields` instead.', PydanticDeprecatedSince20 + ) + return self.model_fields # type: ignore + + def __dir__(self) -> list[str]: + attributes = list(super().__dir__()) + if '__fields__' in attributes: + attributes.remove('__fields__') + return attributes + + +def init_private_attributes(self: BaseModel, context: Any, /) -> None: + """This function is meant to behave like a BaseModel method to initialise private attributes. + + It takes context as an argument since that's what pydantic-core passes when calling it. + + Args: + self: The BaseModel instance. + context: The context. + """ + if getattr(self, '__pydantic_private__', None) is None: + pydantic_private = {} + for name, private_attr in self.__private_attributes__.items(): + default = private_attr.get_default() + if default is not PydanticUndefined: + pydantic_private[name] = default + object_setattr(self, '__pydantic_private__', pydantic_private) + + +def get_model_post_init(namespace: dict[str, Any], bases: tuple[type[Any], ...]) -> Callable[..., Any] | None: + """Get the `model_post_init` method from the namespace or the class bases, or `None` if not defined.""" + if 'model_post_init' in namespace: + return namespace['model_post_init'] + + from ..main import BaseModel + + model_post_init = get_attribute_from_bases(bases, 'model_post_init') + if model_post_init is not BaseModel.model_post_init: + return model_post_init + + +def inspect_namespace( # noqa C901 + namespace: dict[str, Any], + ignored_types: tuple[type[Any], ...], + base_class_vars: set[str], + base_class_fields: set[str], +) -> dict[str, ModelPrivateAttr]: + """Iterate over the namespace and: + * gather private attributes + * check for items which look like fields but are not (e.g. have no annotation) and warn. + + Args: + namespace: The attribute dictionary of the class to be created. + ignored_types: A tuple of ignore types. + base_class_vars: A set of base class class variables. + base_class_fields: A set of base class fields. + + Returns: + A dict contains private attributes info. + + Raises: + TypeError: If there is a `__root__` field in model. + NameError: If private attribute name is invalid. + PydanticUserError: + - If a field does not have a type annotation. + - If a field on base class was overridden by a non-annotated attribute. + """ + from ..fields import FieldInfo, ModelPrivateAttr, PrivateAttr + + all_ignored_types = ignored_types + default_ignored_types() + + private_attributes: dict[str, ModelPrivateAttr] = {} + raw_annotations = namespace.get('__annotations__', {}) + + if '__root__' in raw_annotations or '__root__' in namespace: + raise TypeError("To define root models, use `pydantic.RootModel` rather than a field called '__root__'") + + ignored_names: set[str] = set() + for var_name, value in list(namespace.items()): + if var_name == 'model_config' or var_name == '__pydantic_extra__': + continue + elif ( + isinstance(value, type) + and value.__module__ == namespace['__module__'] + and '__qualname__' in namespace + and value.__qualname__.startswith(namespace['__qualname__']) + ): + # `value` is a nested type defined in this namespace; don't error + continue + elif isinstance(value, all_ignored_types) or value.__class__.__module__ == 'functools': + ignored_names.add(var_name) + continue + elif isinstance(value, ModelPrivateAttr): + if var_name.startswith('__'): + raise NameError( + 'Private attributes must not use dunder names;' + f' use a single underscore prefix instead of {var_name!r}.' + ) + elif is_valid_field_name(var_name): + raise NameError( + 'Private attributes must not use valid field names;' + f' use sunder names, e.g. {"_" + var_name!r} instead of {var_name!r}.' + ) + private_attributes[var_name] = value + del namespace[var_name] + elif isinstance(value, FieldInfo) and not is_valid_field_name(var_name): + suggested_name = var_name.lstrip('_') or 'my_field' # don't suggest '' for all-underscore name + raise NameError( + f'Fields must not use names with leading underscores;' + f' e.g., use {suggested_name!r} instead of {var_name!r}.' + ) + + elif var_name.startswith('__'): + continue + elif is_valid_privateattr_name(var_name): + if var_name not in raw_annotations or not is_classvar(raw_annotations[var_name]): + private_attributes[var_name] = PrivateAttr(default=value) + del namespace[var_name] + elif var_name in base_class_vars: + continue + elif var_name not in raw_annotations: + if var_name in base_class_fields: + raise PydanticUserError( + f'Field {var_name!r} defined on a base class was overridden by a non-annotated attribute. ' + f'All field definitions, including overrides, require a type annotation.', + code='model-field-overridden', + ) + elif isinstance(value, FieldInfo): + raise PydanticUserError( + f'Field {var_name!r} requires a type annotation', code='model-field-missing-annotation' + ) + else: + raise PydanticUserError( + f'A non-annotated attribute was detected: `{var_name} = {value!r}`. All model fields require a ' + f'type annotation; if `{var_name}` is not meant to be a field, you may be able to resolve this ' + f"error by annotating it as a `ClassVar` or updating `model_config['ignored_types']`.", + code='model-field-missing-annotation', + ) + + for ann_name, ann_type in raw_annotations.items(): + if ( + is_valid_privateattr_name(ann_name) + and ann_name not in private_attributes + and ann_name not in ignored_names + and not is_classvar(ann_type) + and ann_type not in all_ignored_types + and getattr(ann_type, '__module__', None) != 'functools' + ): + if is_annotated(ann_type): + _, *metadata = typing_extensions.get_args(ann_type) + private_attr = next((v for v in metadata if isinstance(v, ModelPrivateAttr)), None) + if private_attr is not None: + private_attributes[ann_name] = private_attr + continue + private_attributes[ann_name] = PrivateAttr() + + return private_attributes + + +def set_default_hash_func(cls: type[BaseModel], bases: tuple[type[Any], ...]) -> None: + base_hash_func = get_attribute_from_bases(bases, '__hash__') + new_hash_func = make_hash_func(cls) + if base_hash_func in {None, object.__hash__} or getattr(base_hash_func, '__code__', None) == new_hash_func.__code__: + # If `__hash__` is some default, we generate a hash function. + # It will be `None` if not overridden from BaseModel. + # It may be `object.__hash__` if there is another + # parent class earlier in the bases which doesn't override `__hash__` (e.g. `typing.Generic`). + # It may be a value set by `set_default_hash_func` if `cls` is a subclass of another frozen model. + # In the last case we still need a new hash function to account for new `model_fields`. + cls.__hash__ = new_hash_func + + +def make_hash_func(cls: type[BaseModel]) -> Any: + getter = operator.itemgetter(*cls.model_fields.keys()) if cls.model_fields else lambda _: 0 + + def hash_func(self: Any) -> int: + try: + return hash(getter(self.__dict__)) + except KeyError: + # In rare cases (such as when using the deprecated copy method), the __dict__ may not contain + # all model fields, which is how we can get here. + # getter(self.__dict__) is much faster than any 'safe' method that accounts for missing keys, + # and wrapping it in a `try` doesn't slow things down much in the common case. + return hash(getter(SafeGetItemProxy(self.__dict__))) + + return hash_func + + +def set_model_fields( + cls: type[BaseModel], bases: tuple[type[Any], ...], config_wrapper: ConfigWrapper, types_namespace: dict[str, Any] +) -> None: + """Collect and set `cls.model_fields` and `cls.__class_vars__`. + + Args: + cls: BaseModel or dataclass. + bases: Parents of the class, generally `cls.__bases__`. + config_wrapper: The config wrapper instance. + types_namespace: Optional extra namespace to look for types in. + """ + typevars_map = get_model_typevars_map(cls) + fields, class_vars = collect_model_fields(cls, bases, config_wrapper, types_namespace, typevars_map=typevars_map) + + cls.model_fields = fields + cls.__class_vars__.update(class_vars) + + for k in class_vars: + # Class vars should not be private attributes + # We remove them _here_ and not earlier because we rely on inspecting the class to determine its classvars, + # but private attributes are determined by inspecting the namespace _prior_ to class creation. + # In the case that a classvar with a leading-'_' is defined via a ForwardRef (e.g., when using + # `__future__.annotations`), we want to remove the private attribute which was detected _before_ we knew it + # evaluated to a classvar + + value = cls.__private_attributes__.pop(k, None) + if value is not None and value.default is not PydanticUndefined: + setattr(cls, k, value.default) + + +def complete_model_class( + cls: type[BaseModel], + cls_name: str, + config_wrapper: ConfigWrapper, + *, + raise_errors: bool = True, + types_namespace: dict[str, Any] | None, + create_model_module: str | None = None, +) -> bool: + """Finish building a model class. + + This logic must be called after class has been created since validation functions must be bound + and `get_type_hints` requires a class object. + + Args: + cls: BaseModel or dataclass. + cls_name: The model or dataclass name. + config_wrapper: The config wrapper instance. + raise_errors: Whether to raise errors. + types_namespace: Optional extra namespace to look for types in. + create_model_module: The module of the class to be created, if created by `create_model`. + + Returns: + `True` if the model is successfully completed, else `False`. + + Raises: + PydanticUndefinedAnnotation: If `PydanticUndefinedAnnotation` occurs in`__get_pydantic_core_schema__` + and `raise_errors=True`. + """ + typevars_map = get_model_typevars_map(cls) + gen_schema = GenerateSchema( + config_wrapper, + types_namespace, + typevars_map, + ) + + handler = CallbackGetCoreSchemaHandler( + partial(gen_schema.generate_schema, from_dunder_get_core_schema=False), + gen_schema, + ref_mode='unpack', + ) + + if config_wrapper.defer_build and 'model' in config_wrapper.experimental_defer_build_mode: + set_model_mocks(cls, cls_name) + return False + + try: + schema = cls.__get_pydantic_core_schema__(cls, handler) + except PydanticUndefinedAnnotation as e: + if raise_errors: + raise + set_model_mocks(cls, cls_name, f'`{e.name}`') + return False + + core_config = config_wrapper.core_config(cls) + + try: + schema = gen_schema.clean_schema(schema) + except gen_schema.CollectedInvalid: + set_model_mocks(cls, cls_name) + return False + + # debug(schema) + cls.__pydantic_core_schema__ = schema + + cls.__pydantic_validator__ = create_schema_validator( + schema, + cls, + create_model_module or cls.__module__, + cls.__qualname__, + 'create_model' if create_model_module else 'BaseModel', + core_config, + config_wrapper.plugin_settings, + ) + cls.__pydantic_serializer__ = SchemaSerializer(schema, core_config) + cls.__pydantic_complete__ = True + + # set __signature__ attr only for model class, but not for its instances + cls.__signature__ = ClassAttribute( + '__signature__', + generate_pydantic_signature(init=cls.__init__, fields=cls.model_fields, config_wrapper=config_wrapper), + ) + return True + + +def set_deprecated_descriptors(cls: type[BaseModel]) -> None: + """Set data descriptors on the class for deprecated fields.""" + for field, field_info in cls.model_fields.items(): + if (msg := field_info.deprecation_message) is not None: + desc = _DeprecatedFieldDescriptor(msg) + desc.__set_name__(cls, field) + setattr(cls, field, desc) + + for field, computed_field_info in cls.model_computed_fields.items(): + if ( + (msg := computed_field_info.deprecation_message) is not None + # Avoid having two warnings emitted: + and not hasattr(unwrap_wrapped_function(computed_field_info.wrapped_property), '__deprecated__') + ): + desc = _DeprecatedFieldDescriptor(msg, computed_field_info.wrapped_property) + desc.__set_name__(cls, field) + setattr(cls, field, desc) + + +class _DeprecatedFieldDescriptor: + """Data descriptor used to emit a runtime deprecation warning before accessing a deprecated field. + + Attributes: + msg: The deprecation message to be emitted. + wrapped_property: The property instance if the deprecated field is a computed field, or `None`. + field_name: The name of the field being deprecated. + """ + + field_name: str + + def __init__(self, msg: str, wrapped_property: property | None = None) -> None: + self.msg = msg + self.wrapped_property = wrapped_property + + def __set_name__(self, cls: type[BaseModel], name: str) -> None: + self.field_name = name + + def __get__(self, obj: BaseModel | None, obj_type: type[BaseModel] | None = None) -> Any: + if obj is None: + raise AttributeError(self.field_name) + + warnings.warn(self.msg, builtins.DeprecationWarning, stacklevel=2) + + if self.wrapped_property is not None: + return self.wrapped_property.__get__(obj, obj_type) + return obj.__dict__[self.field_name] + + # Defined to take precedence over the instance's dictionary + # Note that it will not be called when setting a value on a model instance + # as `BaseModel.__setattr__` is defined and takes priority. + def __set__(self, obj: Any, value: Any) -> NoReturn: + raise AttributeError(self.field_name) + + +class _PydanticWeakRef: + """Wrapper for `weakref.ref` that enables `pickle` serialization. + + Cloudpickle fails to serialize `weakref.ref` objects due to an arcane error related + to abstract base classes (`abc.ABC`). This class works around the issue by wrapping + `weakref.ref` instead of subclassing it. + + See https://github.com/pydantic/pydantic/issues/6763 for context. + + Semantics: + - If not pickled, behaves the same as a `weakref.ref`. + - If pickled along with the referenced object, the same `weakref.ref` behavior + will be maintained between them after unpickling. + - If pickled without the referenced object, after unpickling the underlying + reference will be cleared (`__call__` will always return `None`). + """ + + def __init__(self, obj: Any): + if obj is None: + # The object will be `None` upon deserialization if the serialized weakref + # had lost its underlying object. + self._wr = None + else: + self._wr = weakref.ref(obj) + + def __call__(self) -> Any: + if self._wr is None: + return None + else: + return self._wr() + + def __reduce__(self) -> tuple[Callable, tuple[weakref.ReferenceType | None]]: + return _PydanticWeakRef, (self(),) + + +def build_lenient_weakvaluedict(d: dict[str, Any] | None) -> dict[str, Any] | None: + """Takes an input dictionary, and produces a new value that (invertibly) replaces the values with weakrefs. + + We can't just use a WeakValueDictionary because many types (including int, str, etc.) can't be stored as values + in a WeakValueDictionary. + + The `unpack_lenient_weakvaluedict` function can be used to reverse this operation. + """ + if d is None: + return None + result = {} + for k, v in d.items(): + try: + proxy = _PydanticWeakRef(v) + except TypeError: + proxy = v + result[k] = proxy + return result + + +def unpack_lenient_weakvaluedict(d: dict[str, Any] | None) -> dict[str, Any] | None: + """Inverts the transform performed by `build_lenient_weakvaluedict`.""" + if d is None: + return None + + result = {} + for k, v in d.items(): + if isinstance(v, _PydanticWeakRef): + v = v() + if v is not None: + result[k] = v + else: + result[k] = v + return result + + +def default_ignored_types() -> tuple[type[Any], ...]: + from ..fields import ComputedFieldInfo + + return ( + FunctionType, + property, + classmethod, + staticmethod, + PydanticDescriptorProxy, + ComputedFieldInfo, + ValidateCallWrapper, + ) diff --git a/env/Lib/site-packages/pydantic/_internal/_repr.py b/env/Lib/site-packages/pydantic/_internal/_repr.py new file mode 100644 index 0000000..83cb4cc --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_repr.py @@ -0,0 +1,118 @@ +"""Tools to provide pretty/human-readable display of objects.""" + +from __future__ import annotations as _annotations + +import types +import typing +from typing import Any + +import typing_extensions + +from . import _typing_extra + +if typing.TYPE_CHECKING: + ReprArgs: typing_extensions.TypeAlias = 'typing.Iterable[tuple[str | None, Any]]' + RichReprResult: typing_extensions.TypeAlias = ( + 'typing.Iterable[Any | tuple[Any] | tuple[str, Any] | tuple[str, Any, Any]]' + ) + + +class PlainRepr(str): + """String class where repr doesn't include quotes. Useful with Representation when you want to return a string + representation of something that is valid (or pseudo-valid) python. + """ + + def __repr__(self) -> str: + return str(self) + + +class Representation: + # Mixin to provide `__str__`, `__repr__`, and `__pretty__` and `__rich_repr__` methods. + # `__pretty__` is used by [devtools](https://python-devtools.helpmanual.io/). + # `__rich_repr__` is used by [rich](https://rich.readthedocs.io/en/stable/pretty.html). + # (this is not a docstring to avoid adding a docstring to classes which inherit from Representation) + + # we don't want to use a type annotation here as it can break get_type_hints + __slots__ = tuple() # type: typing.Collection[str] + + def __repr_args__(self) -> ReprArgs: + """Returns the attributes to show in __str__, __repr__, and __pretty__ this is generally overridden. + + Can either return: + * name - value pairs, e.g.: `[('foo_name', 'foo'), ('bar_name', ['b', 'a', 'r'])]` + * or, just values, e.g.: `[(None, 'foo'), (None, ['b', 'a', 'r'])]` + """ + attrs_names = self.__slots__ + if not attrs_names and hasattr(self, '__dict__'): + attrs_names = self.__dict__.keys() + attrs = ((s, getattr(self, s)) for s in attrs_names) + return [(a, v) for a, v in attrs if v is not None] + + def __repr_name__(self) -> str: + """Name of the instance's class, used in __repr__.""" + return self.__class__.__name__ + + def __repr_str__(self, join_str: str) -> str: + return join_str.join(repr(v) if a is None else f'{a}={v!r}' for a, v in self.__repr_args__()) + + def __pretty__(self, fmt: typing.Callable[[Any], Any], **kwargs: Any) -> typing.Generator[Any, None, None]: + """Used by devtools (https://python-devtools.helpmanual.io/) to pretty print objects.""" + yield self.__repr_name__() + '(' + yield 1 + for name, value in self.__repr_args__(): + if name is not None: + yield name + '=' + yield fmt(value) + yield ',' + yield 0 + yield -1 + yield ')' + + def __rich_repr__(self) -> RichReprResult: + """Used by Rich (https://rich.readthedocs.io/en/stable/pretty.html) to pretty print objects.""" + for name, field_repr in self.__repr_args__(): + if name is None: + yield field_repr + else: + yield name, field_repr + + def __str__(self) -> str: + return self.__repr_str__(' ') + + def __repr__(self) -> str: + return f'{self.__repr_name__()}({self.__repr_str__(", ")})' + + +def display_as_type(obj: Any) -> str: + """Pretty representation of a type, should be as close as possible to the original type definition string. + + Takes some logic from `typing._type_repr`. + """ + if isinstance(obj, types.FunctionType): + return obj.__name__ + elif obj is ...: + return '...' + elif isinstance(obj, Representation): + return repr(obj) + elif isinstance(obj, typing_extensions.TypeAliasType): + return str(obj) + + if not isinstance(obj, (_typing_extra.typing_base, _typing_extra.WithArgsTypes, type)): + obj = obj.__class__ + + if _typing_extra.origin_is_union(typing_extensions.get_origin(obj)): + args = ', '.join(map(display_as_type, typing_extensions.get_args(obj))) + return f'Union[{args}]' + elif isinstance(obj, _typing_extra.WithArgsTypes): + if typing_extensions.get_origin(obj) == typing_extensions.Literal: + args = ', '.join(map(repr, typing_extensions.get_args(obj))) + else: + args = ', '.join(map(display_as_type, typing_extensions.get_args(obj))) + try: + return f'{obj.__qualname__}[{args}]' + except AttributeError: + return str(obj) # handles TypeAliasType in 3.12 + elif isinstance(obj, type): + return obj.__qualname__ + else: + return repr(obj).replace('typing.', '').replace('typing_extensions.', '') diff --git a/env/Lib/site-packages/pydantic/_internal/_schema_generation_shared.py b/env/Lib/site-packages/pydantic/_internal/_schema_generation_shared.py new file mode 100644 index 0000000..f35c665 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_schema_generation_shared.py @@ -0,0 +1,125 @@ +"""Types and utility functions used by various other internal tools.""" + +from __future__ import annotations + +from typing import TYPE_CHECKING, Any, Callable + +from pydantic_core import core_schema +from typing_extensions import Literal + +from ..annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler + +if TYPE_CHECKING: + from ..json_schema import GenerateJsonSchema, JsonSchemaValue + from ._core_utils import CoreSchemaOrField + from ._generate_schema import GenerateSchema + + GetJsonSchemaFunction = Callable[[CoreSchemaOrField, GetJsonSchemaHandler], JsonSchemaValue] + HandlerOverride = Callable[[CoreSchemaOrField], JsonSchemaValue] + + +class GenerateJsonSchemaHandler(GetJsonSchemaHandler): + """JsonSchemaHandler implementation that doesn't do ref unwrapping by default. + + This is used for any Annotated metadata so that we don't end up with conflicting + modifications to the definition schema. + + Used internally by Pydantic, please do not rely on this implementation. + See `GetJsonSchemaHandler` for the handler API. + """ + + def __init__(self, generate_json_schema: GenerateJsonSchema, handler_override: HandlerOverride | None) -> None: + self.generate_json_schema = generate_json_schema + self.handler = handler_override or generate_json_schema.generate_inner + self.mode = generate_json_schema.mode + + def __call__(self, core_schema: CoreSchemaOrField, /) -> JsonSchemaValue: + return self.handler(core_schema) + + def resolve_ref_schema(self, maybe_ref_json_schema: JsonSchemaValue) -> JsonSchemaValue: + """Resolves `$ref` in the json schema. + + This returns the input json schema if there is no `$ref` in json schema. + + Args: + maybe_ref_json_schema: The input json schema that may contains `$ref`. + + Returns: + Resolved json schema. + + Raises: + LookupError: If it can't find the definition for `$ref`. + """ + if '$ref' not in maybe_ref_json_schema: + return maybe_ref_json_schema + ref = maybe_ref_json_schema['$ref'] + json_schema = self.generate_json_schema.get_schema_from_definitions(ref) + if json_schema is None: + raise LookupError( + f'Could not find a ref for {ref}.' + ' Maybe you tried to call resolve_ref_schema from within a recursive model?' + ) + return json_schema + + +class CallbackGetCoreSchemaHandler(GetCoreSchemaHandler): + """Wrapper to use an arbitrary function as a `GetCoreSchemaHandler`. + + Used internally by Pydantic, please do not rely on this implementation. + See `GetCoreSchemaHandler` for the handler API. + """ + + def __init__( + self, + handler: Callable[[Any], core_schema.CoreSchema], + generate_schema: GenerateSchema, + ref_mode: Literal['to-def', 'unpack'] = 'to-def', + ) -> None: + self._handler = handler + self._generate_schema = generate_schema + self._ref_mode = ref_mode + + def __call__(self, source_type: Any, /) -> core_schema.CoreSchema: + schema = self._handler(source_type) + ref = schema.get('ref') + if self._ref_mode == 'to-def': + if ref is not None: + self._generate_schema.defs.definitions[ref] = schema + return core_schema.definition_reference_schema(ref) + return schema + else: # ref_mode = 'unpack + return self.resolve_ref_schema(schema) + + def _get_types_namespace(self) -> dict[str, Any] | None: + return self._generate_schema._types_namespace + + def generate_schema(self, source_type: Any, /) -> core_schema.CoreSchema: + return self._generate_schema.generate_schema(source_type) + + @property + def field_name(self) -> str | None: + return self._generate_schema.field_name_stack.get() + + def resolve_ref_schema(self, maybe_ref_schema: core_schema.CoreSchema) -> core_schema.CoreSchema: + """Resolves reference in the core schema. + + Args: + maybe_ref_schema: The input core schema that may contains reference. + + Returns: + Resolved core schema. + + Raises: + LookupError: If it can't find the definition for reference. + """ + if maybe_ref_schema['type'] == 'definition-ref': + ref = maybe_ref_schema['schema_ref'] + if ref not in self._generate_schema.defs.definitions: + raise LookupError( + f'Could not find a ref for {ref}.' + ' Maybe you tried to call resolve_ref_schema from within a recursive model?' + ) + return self._generate_schema.defs.definitions[ref] + elif maybe_ref_schema['type'] == 'definitions': + return self.resolve_ref_schema(maybe_ref_schema['schema']) + return maybe_ref_schema diff --git a/env/Lib/site-packages/pydantic/_internal/_signature.py b/env/Lib/site-packages/pydantic/_internal/_signature.py new file mode 100644 index 0000000..816a165 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_signature.py @@ -0,0 +1,164 @@ +from __future__ import annotations + +import dataclasses +from inspect import Parameter, Signature, signature +from typing import TYPE_CHECKING, Any, Callable + +from pydantic_core import PydanticUndefined + +from ._config import ConfigWrapper +from ._utils import is_valid_identifier + +if TYPE_CHECKING: + from ..fields import FieldInfo + + +def _field_name_for_signature(field_name: str, field_info: FieldInfo) -> str: + """Extract the correct name to use for the field when generating a signature. + + Assuming the field has a valid alias, this will return the alias. Otherwise, it will return the field name. + First priority is given to the validation_alias, then the alias, then the field name. + + Args: + field_name: The name of the field + field_info: The corresponding FieldInfo object. + + Returns: + The correct name to use when generating a signature. + """ + + def _alias_if_valid(x: Any) -> str | None: + """Return the alias if it is a valid alias and identifier, else None.""" + return x if isinstance(x, str) and is_valid_identifier(x) else None + + return _alias_if_valid(field_info.alias) or _alias_if_valid(field_info.validation_alias) or field_name + + +def _process_param_defaults(param: Parameter) -> Parameter: + """Modify the signature for a parameter in a dataclass where the default value is a FieldInfo instance. + + Args: + param (Parameter): The parameter + + Returns: + Parameter: The custom processed parameter + """ + from ..fields import FieldInfo + + param_default = param.default + if isinstance(param_default, FieldInfo): + annotation = param.annotation + # Replace the annotation if appropriate + # inspect does "clever" things to show annotations as strings because we have + # `from __future__ import annotations` in main, we don't want that + if annotation == 'Any': + annotation = Any + + # Replace the field default + default = param_default.default + if default is PydanticUndefined: + if param_default.default_factory is PydanticUndefined: + default = Signature.empty + else: + # this is used by dataclasses to indicate a factory exists: + default = dataclasses._HAS_DEFAULT_FACTORY # type: ignore + return param.replace( + annotation=annotation, name=_field_name_for_signature(param.name, param_default), default=default + ) + return param + + +def _generate_signature_parameters( # noqa: C901 (ignore complexity, could use a refactor) + init: Callable[..., None], + fields: dict[str, FieldInfo], + config_wrapper: ConfigWrapper, +) -> dict[str, Parameter]: + """Generate a mapping of parameter names to Parameter objects for a pydantic BaseModel or dataclass.""" + from itertools import islice + + present_params = signature(init).parameters.values() + merged_params: dict[str, Parameter] = {} + var_kw = None + use_var_kw = False + + for param in islice(present_params, 1, None): # skip self arg + # inspect does "clever" things to show annotations as strings because we have + # `from __future__ import annotations` in main, we don't want that + if fields.get(param.name): + # exclude params with init=False + if getattr(fields[param.name], 'init', True) is False: + continue + param = param.replace(name=_field_name_for_signature(param.name, fields[param.name])) + if param.annotation == 'Any': + param = param.replace(annotation=Any) + if param.kind is param.VAR_KEYWORD: + var_kw = param + continue + merged_params[param.name] = param + + if var_kw: # if custom init has no var_kw, fields which are not declared in it cannot be passed through + allow_names = config_wrapper.populate_by_name + for field_name, field in fields.items(): + # when alias is a str it should be used for signature generation + param_name = _field_name_for_signature(field_name, field) + + if field_name in merged_params or param_name in merged_params: + continue + + if not is_valid_identifier(param_name): + if allow_names: + param_name = field_name + else: + use_var_kw = True + continue + + kwargs = {} if field.is_required() else {'default': field.get_default(call_default_factory=False)} + merged_params[param_name] = Parameter( + param_name, Parameter.KEYWORD_ONLY, annotation=field.rebuild_annotation(), **kwargs + ) + + if config_wrapper.extra == 'allow': + use_var_kw = True + + if var_kw and use_var_kw: + # Make sure the parameter for extra kwargs + # does not have the same name as a field + default_model_signature = [ + ('self', Parameter.POSITIONAL_ONLY), + ('data', Parameter.VAR_KEYWORD), + ] + if [(p.name, p.kind) for p in present_params] == default_model_signature: + # if this is the standard model signature, use extra_data as the extra args name + var_kw_name = 'extra_data' + else: + # else start from var_kw + var_kw_name = var_kw.name + + # generate a name that's definitely unique + while var_kw_name in fields: + var_kw_name += '_' + merged_params[var_kw_name] = var_kw.replace(name=var_kw_name) + + return merged_params + + +def generate_pydantic_signature( + init: Callable[..., None], fields: dict[str, FieldInfo], config_wrapper: ConfigWrapper, is_dataclass: bool = False +) -> Signature: + """Generate signature for a pydantic BaseModel or dataclass. + + Args: + init: The class init. + fields: The model fields. + config_wrapper: The config wrapper instance. + is_dataclass: Whether the model is a dataclass. + + Returns: + The dataclass/BaseModel subclass signature. + """ + merged_params = _generate_signature_parameters(init, fields, config_wrapper) + + if is_dataclass: + merged_params = {k: _process_param_defaults(v) for k, v in merged_params.items()} + + return Signature(parameters=list(merged_params.values()), return_annotation=None) diff --git a/env/Lib/site-packages/pydantic/_internal/_std_types_schema.py b/env/Lib/site-packages/pydantic/_internal/_std_types_schema.py new file mode 100644 index 0000000..9f8b958 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_std_types_schema.py @@ -0,0 +1,722 @@ +"""Logic for generating pydantic-core schemas for standard library types. + +Import of this module is deferred since it contains imports of many standard library modules. +""" + +from __future__ import annotations as _annotations + +import collections +import collections.abc +import dataclasses +import decimal +import inspect +import os +import typing +from enum import Enum +from functools import partial +from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network +from operator import attrgetter +from typing import Any, Callable, Iterable, Literal, Tuple, TypeVar + +import typing_extensions +from pydantic_core import ( + CoreSchema, + MultiHostUrl, + PydanticCustomError, + PydanticOmit, + Url, + core_schema, +) +from typing_extensions import get_args, get_origin + +from pydantic.errors import PydanticSchemaGenerationError +from pydantic.fields import FieldInfo +from pydantic.types import Strict + +from ..config import ConfigDict +from ..json_schema import JsonSchemaValue +from . import _known_annotated_metadata, _typing_extra, _validators +from ._core_utils import get_type_ref +from ._internal_dataclass import slots_true +from ._schema_generation_shared import GetCoreSchemaHandler, GetJsonSchemaHandler + +if typing.TYPE_CHECKING: + from ._generate_schema import GenerateSchema + + StdSchemaFunction = Callable[[GenerateSchema, type[Any]], core_schema.CoreSchema] + + +@dataclasses.dataclass(**slots_true) +class SchemaTransformer: + get_core_schema: Callable[[Any, GetCoreSchemaHandler], CoreSchema] + get_json_schema: Callable[[CoreSchema, GetJsonSchemaHandler], JsonSchemaValue] + + def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema: + return self.get_core_schema(source_type, handler) + + def __get_pydantic_json_schema__(self, schema: CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue: + return self.get_json_schema(schema, handler) + + +def get_enum_core_schema(enum_type: type[Enum], config: ConfigDict) -> CoreSchema: + cases: list[Any] = list(enum_type.__members__.values()) + + enum_ref = get_type_ref(enum_type) + description = None if not enum_type.__doc__ else inspect.cleandoc(enum_type.__doc__) + if description == 'An enumeration.': # This is the default value provided by enum.EnumMeta.__new__; don't use it + description = None + js_updates = {'title': enum_type.__name__, 'description': description} + js_updates = {k: v for k, v in js_updates.items() if v is not None} + + sub_type: Literal['str', 'int', 'float'] | None = None + if issubclass(enum_type, int): + sub_type = 'int' + value_ser_type: core_schema.SerSchema = core_schema.simple_ser_schema('int') + elif issubclass(enum_type, str): + # this handles `StrEnum` (3.11 only), and also `Foobar(str, Enum)` + sub_type = 'str' + value_ser_type = core_schema.simple_ser_schema('str') + elif issubclass(enum_type, float): + sub_type = 'float' + value_ser_type = core_schema.simple_ser_schema('float') + else: + # TODO this is an ugly hack, how do we trigger an Any schema for serialization? + value_ser_type = core_schema.plain_serializer_function_ser_schema(lambda x: x) + + if cases: + + def get_json_schema(schema: CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue: + json_schema = handler(schema) + original_schema = handler.resolve_ref_schema(json_schema) + original_schema.update(js_updates) + return json_schema + + # we don't want to add the missing to the schema if it's the default one + default_missing = getattr(enum_type._missing_, '__func__', None) == Enum._missing_.__func__ # type: ignore + enum_schema = core_schema.enum_schema( + enum_type, + cases, + sub_type=sub_type, + missing=None if default_missing else enum_type._missing_, + ref=enum_ref, + metadata={'pydantic_js_functions': [get_json_schema]}, + ) + + if config.get('use_enum_values', False): + enum_schema = core_schema.no_info_after_validator_function( + attrgetter('value'), enum_schema, serialization=value_ser_type + ) + + return enum_schema + + else: + + def get_json_schema_no_cases(_, handler: GetJsonSchemaHandler) -> JsonSchemaValue: + json_schema = handler(core_schema.enum_schema(enum_type, cases, sub_type=sub_type, ref=enum_ref)) + original_schema = handler.resolve_ref_schema(json_schema) + original_schema.update(js_updates) + return json_schema + + # Use an isinstance check for enums with no cases. + # The most important use case for this is creating TypeVar bounds for generics that should + # be restricted to enums. This is more consistent than it might seem at first, since you can only + # subclass enum.Enum (or subclasses of enum.Enum) if all parent classes have no cases. + # We use the get_json_schema function when an Enum subclass has been declared with no cases + # so that we can still generate a valid json schema. + return core_schema.is_instance_schema( + enum_type, + metadata={'pydantic_js_functions': [get_json_schema_no_cases]}, + ) + + +@dataclasses.dataclass(**slots_true) +class InnerSchemaValidator: + """Use a fixed CoreSchema, avoiding interference from outward annotations.""" + + core_schema: CoreSchema + js_schema: JsonSchemaValue | None = None + js_core_schema: CoreSchema | None = None + js_schema_update: JsonSchemaValue | None = None + + def __get_pydantic_json_schema__(self, _schema: CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue: + if self.js_schema is not None: + return self.js_schema + js_schema = handler(self.js_core_schema or self.core_schema) + if self.js_schema_update is not None: + js_schema.update(self.js_schema_update) + return js_schema + + def __get_pydantic_core_schema__(self, _source_type: Any, _handler: GetCoreSchemaHandler) -> CoreSchema: + return self.core_schema + + +def decimal_prepare_pydantic_annotations( + source: Any, annotations: Iterable[Any], config: ConfigDict +) -> tuple[Any, list[Any]] | None: + if source is not decimal.Decimal: + return None + + metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations) + + config_allow_inf_nan = config.get('allow_inf_nan') + if config_allow_inf_nan is not None: + metadata.setdefault('allow_inf_nan', config_allow_inf_nan) + + _known_annotated_metadata.check_metadata( + metadata, {*_known_annotated_metadata.FLOAT_CONSTRAINTS, 'max_digits', 'decimal_places'}, decimal.Decimal + ) + return source, [InnerSchemaValidator(core_schema.decimal_schema(**metadata)), *remaining_annotations] + + +def datetime_prepare_pydantic_annotations( + source_type: Any, annotations: Iterable[Any], _config: ConfigDict +) -> tuple[Any, list[Any]] | None: + import datetime + + metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations) + if source_type is datetime.date: + sv = InnerSchemaValidator(core_schema.date_schema(**metadata)) + elif source_type is datetime.datetime: + sv = InnerSchemaValidator(core_schema.datetime_schema(**metadata)) + elif source_type is datetime.time: + sv = InnerSchemaValidator(core_schema.time_schema(**metadata)) + elif source_type is datetime.timedelta: + sv = InnerSchemaValidator(core_schema.timedelta_schema(**metadata)) + else: + return None + # check now that we know the source type is correct + _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.DATE_TIME_CONSTRAINTS, source_type) + return (source_type, [sv, *remaining_annotations]) + + +def uuid_prepare_pydantic_annotations( + source_type: Any, annotations: Iterable[Any], _config: ConfigDict +) -> tuple[Any, list[Any]] | None: + # UUIDs have no constraints - they are fixed length, constructing a UUID instance checks the length + + from uuid import UUID + + if source_type is not UUID: + return None + + return (source_type, [InnerSchemaValidator(core_schema.uuid_schema()), *annotations]) + + +def path_schema_prepare_pydantic_annotations( + source_type: Any, annotations: Iterable[Any], _config: ConfigDict +) -> tuple[Any, list[Any]] | None: + import pathlib + + if source_type not in { + os.PathLike, + pathlib.Path, + pathlib.PurePath, + pathlib.PosixPath, + pathlib.PurePosixPath, + pathlib.PureWindowsPath, + }: + return None + + metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations) + _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.STR_CONSTRAINTS, source_type) + + construct_path = pathlib.PurePath if source_type is os.PathLike else source_type + + def path_validator(input_value: str) -> os.PathLike[Any]: + try: + return construct_path(input_value) + except TypeError as e: + raise PydanticCustomError('path_type', 'Input is not a valid path') from e + + constrained_str_schema = core_schema.str_schema(**metadata) + + instance_schema = core_schema.json_or_python_schema( + json_schema=core_schema.no_info_after_validator_function(path_validator, constrained_str_schema), + python_schema=core_schema.is_instance_schema(source_type), + ) + + strict: bool | None = None + for annotation in annotations: + if isinstance(annotation, Strict): + strict = annotation.strict + + schema = core_schema.lax_or_strict_schema( + lax_schema=core_schema.union_schema( + [ + instance_schema, + core_schema.no_info_after_validator_function(path_validator, constrained_str_schema), + ], + custom_error_type='path_type', + custom_error_message='Input is not a valid path', + strict=True, + ), + strict_schema=instance_schema, + serialization=core_schema.to_string_ser_schema(), + strict=strict, + ) + + return ( + source_type, + [ + InnerSchemaValidator(schema, js_core_schema=constrained_str_schema, js_schema_update={'format': 'path'}), + *remaining_annotations, + ], + ) + + +def dequeue_validator( + input_value: Any, handler: core_schema.ValidatorFunctionWrapHandler, maxlen: None | int +) -> collections.deque[Any]: + if isinstance(input_value, collections.deque): + maxlens = [v for v in (input_value.maxlen, maxlen) if v is not None] + if maxlens: + maxlen = min(maxlens) + return collections.deque(handler(input_value), maxlen=maxlen) + else: + return collections.deque(handler(input_value), maxlen=maxlen) + + +def serialize_sequence_via_list( + v: Any, handler: core_schema.SerializerFunctionWrapHandler, info: core_schema.SerializationInfo +) -> Any: + items: list[Any] = [] + + mapped_origin = SEQUENCE_ORIGIN_MAP.get(type(v), None) + if mapped_origin is None: + # we shouldn't hit this branch, should probably add a serialization error or something + return v + + for index, item in enumerate(v): + try: + v = handler(item, index) + except PydanticOmit: + pass + else: + items.append(v) + + if info.mode_is_json(): + return items + else: + return mapped_origin(items) + + +@dataclasses.dataclass(**slots_true) +class SequenceValidator: + mapped_origin: type[Any] + item_source_type: type[Any] + min_length: int | None = None + max_length: int | None = None + strict: bool | None = None + fail_fast: bool | None = None + + def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema: + if self.item_source_type is Any: + items_schema = None + else: + items_schema = handler.generate_schema(self.item_source_type) + + metadata = { + 'min_length': self.min_length, + 'max_length': self.max_length, + 'strict': self.strict, + 'fail_fast': self.fail_fast, + } + + if self.mapped_origin in (list, set, frozenset): + if self.mapped_origin is list: + constrained_schema = core_schema.list_schema(items_schema, **metadata) + elif self.mapped_origin is set: + constrained_schema = core_schema.set_schema(items_schema, **metadata) + else: + assert self.mapped_origin is frozenset # safety check in case we forget to add a case + constrained_schema = core_schema.frozenset_schema(items_schema, **metadata) + + schema = constrained_schema + else: + # safety check in case we forget to add a case + assert self.mapped_origin in (collections.deque, collections.Counter) + + if self.mapped_origin is collections.deque: + # if we have a MaxLen annotation might as well set that as the default maxlen on the deque + # this lets us re-use existing metadata annotations to let users set the maxlen on a dequeue + # that e.g. comes from JSON + coerce_instance_wrap = partial( + core_schema.no_info_wrap_validator_function, + partial(dequeue_validator, maxlen=metadata.get('max_length', None)), + ) + else: + coerce_instance_wrap = partial(core_schema.no_info_after_validator_function, self.mapped_origin) + + # we have to use a lax list schema here, because we need to validate the deque's + # items via a list schema, but it's ok if the deque itself is not a list (same for Counter) + metadata_with_strict_override = {**metadata, 'strict': False} + constrained_schema = core_schema.list_schema(items_schema, **metadata_with_strict_override) + + check_instance = core_schema.json_or_python_schema( + json_schema=core_schema.list_schema(), + python_schema=core_schema.is_instance_schema(self.mapped_origin), + ) + + serialization = core_schema.wrap_serializer_function_ser_schema( + serialize_sequence_via_list, schema=items_schema or core_schema.any_schema(), info_arg=True + ) + + strict = core_schema.chain_schema([check_instance, coerce_instance_wrap(constrained_schema)]) + + if metadata.get('strict', False): + schema = strict + else: + lax = coerce_instance_wrap(constrained_schema) + schema = core_schema.lax_or_strict_schema(lax_schema=lax, strict_schema=strict) + schema['serialization'] = serialization + + return schema + + +SEQUENCE_ORIGIN_MAP: dict[Any, Any] = { + typing.Deque: collections.deque, + collections.deque: collections.deque, + list: list, + typing.List: list, + set: set, + typing.AbstractSet: set, + typing.Set: set, + frozenset: frozenset, + typing.FrozenSet: frozenset, + typing.Sequence: list, + typing.MutableSequence: list, + typing.MutableSet: set, + # this doesn't handle subclasses of these + # parametrized typing.Set creates one of these + collections.abc.MutableSet: set, + collections.abc.Set: frozenset, +} + + +def identity(s: CoreSchema) -> CoreSchema: + return s + + +def sequence_like_prepare_pydantic_annotations( + source_type: Any, annotations: Iterable[Any], _config: ConfigDict +) -> tuple[Any, list[Any]] | None: + origin: Any = get_origin(source_type) + + mapped_origin = SEQUENCE_ORIGIN_MAP.get(origin, None) if origin else SEQUENCE_ORIGIN_MAP.get(source_type, None) + if mapped_origin is None: + return None + + args = get_args(source_type) + + if not args: + args = typing.cast(Tuple[Any], (Any,)) + elif len(args) != 1: + raise ValueError('Expected sequence to have exactly 1 generic parameter') + + item_source_type = args[0] + + metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations) + _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.SEQUENCE_CONSTRAINTS, source_type) + + return (source_type, [SequenceValidator(mapped_origin, item_source_type, **metadata), *remaining_annotations]) + + +MAPPING_ORIGIN_MAP: dict[Any, Any] = { + typing.DefaultDict: collections.defaultdict, + collections.defaultdict: collections.defaultdict, + collections.OrderedDict: collections.OrderedDict, + typing_extensions.OrderedDict: collections.OrderedDict, + dict: dict, + typing.Dict: dict, + collections.Counter: collections.Counter, + typing.Counter: collections.Counter, + # this doesn't handle subclasses of these + typing.Mapping: dict, + typing.MutableMapping: dict, + # parametrized typing.{Mutable}Mapping creates one of these + collections.abc.MutableMapping: dict, + collections.abc.Mapping: dict, +} + + +def defaultdict_validator( + input_value: Any, handler: core_schema.ValidatorFunctionWrapHandler, default_default_factory: Callable[[], Any] +) -> collections.defaultdict[Any, Any]: + if isinstance(input_value, collections.defaultdict): + default_factory = input_value.default_factory + return collections.defaultdict(default_factory, handler(input_value)) + else: + return collections.defaultdict(default_default_factory, handler(input_value)) + + +def get_defaultdict_default_default_factory(values_source_type: Any) -> Callable[[], Any]: + def infer_default() -> Callable[[], Any]: + allowed_default_types: dict[Any, Any] = { + typing.Tuple: tuple, + tuple: tuple, + collections.abc.Sequence: tuple, + collections.abc.MutableSequence: list, + typing.List: list, + list: list, + typing.Sequence: list, + typing.Set: set, + set: set, + typing.MutableSet: set, + collections.abc.MutableSet: set, + collections.abc.Set: frozenset, + typing.MutableMapping: dict, + typing.Mapping: dict, + collections.abc.Mapping: dict, + collections.abc.MutableMapping: dict, + float: float, + int: int, + str: str, + bool: bool, + } + values_type_origin = get_origin(values_source_type) or values_source_type + instructions = 'set using `DefaultDict[..., Annotated[..., Field(default_factory=...)]]`' + if isinstance(values_type_origin, TypeVar): + + def type_var_default_factory() -> None: + raise RuntimeError( + 'Generic defaultdict cannot be used without a concrete value type or an' + ' explicit default factory, ' + instructions + ) + + return type_var_default_factory + elif values_type_origin not in allowed_default_types: + # a somewhat subjective set of types that have reasonable default values + allowed_msg = ', '.join([t.__name__ for t in set(allowed_default_types.values())]) + raise PydanticSchemaGenerationError( + f'Unable to infer a default factory for keys of type {values_source_type}.' + f' Only {allowed_msg} are supported, other types require an explicit default factory' + ' ' + instructions + ) + return allowed_default_types[values_type_origin] + + # Assume Annotated[..., Field(...)] + if _typing_extra.is_annotated(values_source_type): + field_info = next((v for v in get_args(values_source_type) if isinstance(v, FieldInfo)), None) + else: + field_info = None + if field_info and field_info.default_factory: + default_default_factory = field_info.default_factory + else: + default_default_factory = infer_default() + return default_default_factory + + +@dataclasses.dataclass(**slots_true) +class MappingValidator: + mapped_origin: type[Any] + keys_source_type: type[Any] + values_source_type: type[Any] + min_length: int | None = None + max_length: int | None = None + strict: bool = False + + def serialize_mapping_via_dict(self, v: Any, handler: core_schema.SerializerFunctionWrapHandler) -> Any: + return handler(v) + + def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema: + if self.keys_source_type is Any: + keys_schema = None + else: + keys_schema = handler.generate_schema(self.keys_source_type) + if self.values_source_type is Any: + values_schema = None + else: + values_schema = handler.generate_schema(self.values_source_type) + + metadata = {'min_length': self.min_length, 'max_length': self.max_length, 'strict': self.strict} + + if self.mapped_origin is dict: + schema = core_schema.dict_schema(keys_schema, values_schema, **metadata) + else: + constrained_schema = core_schema.dict_schema(keys_schema, values_schema, **metadata) + check_instance = core_schema.json_or_python_schema( + json_schema=core_schema.dict_schema(), + python_schema=core_schema.is_instance_schema(self.mapped_origin), + ) + + if self.mapped_origin is collections.defaultdict: + default_default_factory = get_defaultdict_default_default_factory(self.values_source_type) + coerce_instance_wrap = partial( + core_schema.no_info_wrap_validator_function, + partial(defaultdict_validator, default_default_factory=default_default_factory), + ) + else: + coerce_instance_wrap = partial(core_schema.no_info_after_validator_function, self.mapped_origin) + + serialization = core_schema.wrap_serializer_function_ser_schema( + self.serialize_mapping_via_dict, + schema=core_schema.dict_schema( + keys_schema or core_schema.any_schema(), values_schema or core_schema.any_schema() + ), + info_arg=False, + ) + + strict = core_schema.chain_schema([check_instance, coerce_instance_wrap(constrained_schema)]) + + if metadata.get('strict', False): + schema = strict + else: + lax = coerce_instance_wrap(constrained_schema) + schema = core_schema.lax_or_strict_schema(lax_schema=lax, strict_schema=strict) + schema['serialization'] = serialization + + return schema + + +def mapping_like_prepare_pydantic_annotations( + source_type: Any, annotations: Iterable[Any], _config: ConfigDict +) -> tuple[Any, list[Any]] | None: + origin: Any = get_origin(source_type) + + mapped_origin = MAPPING_ORIGIN_MAP.get(origin, None) if origin else MAPPING_ORIGIN_MAP.get(source_type, None) + if mapped_origin is None: + return None + + args = get_args(source_type) + + if not args: + args = typing.cast(Tuple[Any, Any], (Any, Any)) + elif mapped_origin is collections.Counter: + # a single generic + if len(args) != 1: + raise ValueError('Expected Counter to have exactly 1 generic parameter') + args = (args[0], int) # keys are always an int + elif len(args) != 2: + raise ValueError('Expected mapping to have exactly 2 generic parameters') + + keys_source_type, values_source_type = args + + metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations) + _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.SEQUENCE_CONSTRAINTS, source_type) + + return ( + source_type, + [ + MappingValidator(mapped_origin, keys_source_type, values_source_type, **metadata), + *remaining_annotations, + ], + ) + + +def ip_prepare_pydantic_annotations( + source_type: Any, annotations: Iterable[Any], _config: ConfigDict +) -> tuple[Any, list[Any]] | None: + def make_strict_ip_schema(tp: type[Any]) -> CoreSchema: + return core_schema.json_or_python_schema( + json_schema=core_schema.no_info_after_validator_function(tp, core_schema.str_schema()), + python_schema=core_schema.is_instance_schema(tp), + ) + + if source_type is IPv4Address: + return source_type, [ + SchemaTransformer( + lambda _1, _2: core_schema.lax_or_strict_schema( + lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v4_address_validator), + strict_schema=make_strict_ip_schema(IPv4Address), + serialization=core_schema.to_string_ser_schema(), + ), + lambda _1, _2: {'type': 'string', 'format': 'ipv4'}, + ), + *annotations, + ] + if source_type is IPv4Network: + return source_type, [ + SchemaTransformer( + lambda _1, _2: core_schema.lax_or_strict_schema( + lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v4_network_validator), + strict_schema=make_strict_ip_schema(IPv4Network), + serialization=core_schema.to_string_ser_schema(), + ), + lambda _1, _2: {'type': 'string', 'format': 'ipv4network'}, + ), + *annotations, + ] + if source_type is IPv4Interface: + return source_type, [ + SchemaTransformer( + lambda _1, _2: core_schema.lax_or_strict_schema( + lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v4_interface_validator), + strict_schema=make_strict_ip_schema(IPv4Interface), + serialization=core_schema.to_string_ser_schema(), + ), + lambda _1, _2: {'type': 'string', 'format': 'ipv4interface'}, + ), + *annotations, + ] + + if source_type is IPv6Address: + return source_type, [ + SchemaTransformer( + lambda _1, _2: core_schema.lax_or_strict_schema( + lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v6_address_validator), + strict_schema=make_strict_ip_schema(IPv6Address), + serialization=core_schema.to_string_ser_schema(), + ), + lambda _1, _2: {'type': 'string', 'format': 'ipv6'}, + ), + *annotations, + ] + if source_type is IPv6Network: + return source_type, [ + SchemaTransformer( + lambda _1, _2: core_schema.lax_or_strict_schema( + lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v6_network_validator), + strict_schema=make_strict_ip_schema(IPv6Network), + serialization=core_schema.to_string_ser_schema(), + ), + lambda _1, _2: {'type': 'string', 'format': 'ipv6network'}, + ), + *annotations, + ] + if source_type is IPv6Interface: + return source_type, [ + SchemaTransformer( + lambda _1, _2: core_schema.lax_or_strict_schema( + lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v6_interface_validator), + strict_schema=make_strict_ip_schema(IPv6Interface), + serialization=core_schema.to_string_ser_schema(), + ), + lambda _1, _2: {'type': 'string', 'format': 'ipv6interface'}, + ), + *annotations, + ] + + return None + + +def url_prepare_pydantic_annotations( + source_type: Any, annotations: Iterable[Any], _config: ConfigDict +) -> tuple[Any, list[Any]] | None: + if source_type is Url: + return source_type, [ + SchemaTransformer( + lambda _1, _2: core_schema.url_schema(), + lambda cs, handler: handler(cs), + ), + *annotations, + ] + if source_type is MultiHostUrl: + return source_type, [ + SchemaTransformer( + lambda _1, _2: core_schema.multi_host_url_schema(), + lambda cs, handler: handler(cs), + ), + *annotations, + ] + + +PREPARE_METHODS: tuple[Callable[[Any, Iterable[Any], ConfigDict], tuple[Any, list[Any]] | None], ...] = ( + decimal_prepare_pydantic_annotations, + sequence_like_prepare_pydantic_annotations, + datetime_prepare_pydantic_annotations, + uuid_prepare_pydantic_annotations, + path_schema_prepare_pydantic_annotations, + mapping_like_prepare_pydantic_annotations, + ip_prepare_pydantic_annotations, + url_prepare_pydantic_annotations, +) diff --git a/env/Lib/site-packages/pydantic/_internal/_typing_extra.py b/env/Lib/site-packages/pydantic/_internal/_typing_extra.py new file mode 100644 index 0000000..71be20b --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_typing_extra.py @@ -0,0 +1,508 @@ +"""Logic for interacting with type annotations, mostly extensions, shims and hacks to wrap python's typing module.""" + +from __future__ import annotations as _annotations + +import dataclasses +import re +import sys +import types +import typing +import warnings +from collections.abc import Callable +from functools import partial +from types import GetSetDescriptorType +from typing import TYPE_CHECKING, Any, Final + +from typing_extensions import Annotated, Literal, TypeAliasType, TypeGuard, deprecated, get_args, get_origin + +if TYPE_CHECKING: + from ._dataclasses import StandardDataclass + +try: + from typing import _TypingBase # type: ignore[attr-defined] +except ImportError: + from typing import _Final as _TypingBase # type: ignore[attr-defined] + +typing_base = _TypingBase + + +if sys.version_info < (3, 9): + # python < 3.9 does not have GenericAlias (list[int], tuple[str, ...] and so on) + TypingGenericAlias = () +else: + from typing import GenericAlias as TypingGenericAlias # type: ignore + + +if sys.version_info < (3, 11): + from typing_extensions import NotRequired, Required +else: + from typing import NotRequired, Required # noqa: F401 + + +if sys.version_info < (3, 10): + + def origin_is_union(tp: type[Any] | None) -> bool: + return tp is typing.Union + + WithArgsTypes = (TypingGenericAlias,) + +else: + + def origin_is_union(tp: type[Any] | None) -> bool: + return tp is typing.Union or tp is types.UnionType + + WithArgsTypes = typing._GenericAlias, types.GenericAlias, types.UnionType # type: ignore[attr-defined] + + +if sys.version_info < (3, 10): + NoneType = type(None) + EllipsisType = type(Ellipsis) +else: + from types import NoneType as NoneType + + +LITERAL_TYPES: set[Any] = {Literal} +if hasattr(typing, 'Literal'): + LITERAL_TYPES.add(typing.Literal) # type: ignore + +# Check if `deprecated` is a type to prevent errors when using typing_extensions < 4.9.0 +DEPRECATED_TYPES: tuple[Any, ...] = (deprecated,) if isinstance(deprecated, type) else () +if hasattr(warnings, 'deprecated'): + DEPRECATED_TYPES = (*DEPRECATED_TYPES, warnings.deprecated) # type: ignore + +NONE_TYPES: tuple[Any, ...] = (None, NoneType, *(tp[None] for tp in LITERAL_TYPES)) + + +TypeVarType = Any # since mypy doesn't allow the use of TypeVar as a type + + +def is_none_type(type_: Any) -> bool: + return type_ in NONE_TYPES + + +def is_callable_type(type_: type[Any]) -> bool: + return type_ is Callable or get_origin(type_) is Callable + + +def is_literal_type(type_: type[Any]) -> bool: + return Literal is not None and get_origin(type_) in LITERAL_TYPES + + +def is_deprecated_instance(instance: Any) -> TypeGuard[deprecated]: + return isinstance(instance, DEPRECATED_TYPES) + + +def literal_values(type_: type[Any]) -> tuple[Any, ...]: + return get_args(type_) + + +def all_literal_values(type_: type[Any]) -> list[Any]: + """This method is used to retrieve all Literal values as + Literal can be used recursively (see https://www.python.org/dev/peps/pep-0586) + e.g. `Literal[Literal[Literal[1, 2, 3], "foo"], 5, None]`. + """ + if not is_literal_type(type_): + return [type_] + + values = literal_values(type_) + return list(x for value in values for x in all_literal_values(value)) + + +def is_annotated(ann_type: Any) -> bool: + return get_origin(ann_type) is Annotated + + +def annotated_type(type_: Any) -> Any | None: + return get_args(type_)[0] if is_annotated(type_) else None + + +def is_namedtuple(type_: type[Any]) -> bool: + """Check if a given class is a named tuple. + It can be either a `typing.NamedTuple` or `collections.namedtuple`. + """ + from ._utils import lenient_issubclass + + return lenient_issubclass(type_, tuple) and hasattr(type_, '_fields') + + +test_new_type = typing.NewType('test_new_type', str) + + +def is_new_type(type_: type[Any]) -> bool: + """Check whether type_ was created using typing.NewType. + + Can't use isinstance because it fails <3.10. + """ + return isinstance(type_, test_new_type.__class__) and hasattr(type_, '__supertype__') # type: ignore[arg-type] + + +def _check_classvar(v: type[Any] | None) -> bool: + if v is None: + return False + + return v.__class__ == typing.ClassVar.__class__ and getattr(v, '_name', None) == 'ClassVar' + + +def is_classvar(ann_type: type[Any]) -> bool: + if _check_classvar(ann_type) or _check_classvar(get_origin(ann_type)): + return True + + # this is an ugly workaround for class vars that contain forward references and are therefore themselves + # forward references, see #3679 + if ann_type.__class__ == typing.ForwardRef and re.match( + r'(\w+\.)?ClassVar\[', + ann_type.__forward_arg__, # type: ignore + ): + return True + + return False + + +def _check_finalvar(v: type[Any] | None) -> bool: + """Check if a given type is a `typing.Final` type.""" + if v is None: + return False + + return v.__class__ == Final.__class__ and (sys.version_info < (3, 8) or getattr(v, '_name', None) == 'Final') + + +def is_finalvar(ann_type: Any) -> bool: + return _check_finalvar(ann_type) or _check_finalvar(get_origin(ann_type)) + + +def parent_frame_namespace(*, parent_depth: int = 2) -> dict[str, Any] | None: + """We allow use of items in parent namespace to get around the issue with `get_type_hints` only looking in the + global module namespace. See https://github.com/pydantic/pydantic/issues/2678#issuecomment-1008139014 -> Scope + and suggestion at the end of the next comment by @gvanrossum. + + WARNING 1: it matters exactly where this is called. By default, this function will build a namespace from the + parent of where it is called. + + WARNING 2: this only looks in the parent namespace, not other parents since (AFAIK) there's no way to collect a + dict of exactly what's in scope. Using `f_back` would work sometimes but would be very wrong and confusing in many + other cases. See https://discuss.python.org/t/is-there-a-way-to-access-parent-nested-namespaces/20659. + """ + frame = sys._getframe(parent_depth) + # if f_back is None, it's the global module namespace and we don't need to include it here + if frame.f_back is None: + return None + else: + return frame.f_locals + + +def add_module_globals(obj: Any, globalns: dict[str, Any] | None = None) -> dict[str, Any]: + module_name = getattr(obj, '__module__', None) + if module_name: + try: + module_globalns = sys.modules[module_name].__dict__ + except KeyError: + # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363 + pass + else: + if globalns: + return {**module_globalns, **globalns} + else: + # copy module globals to make sure it can't be updated later + return module_globalns.copy() + + return globalns or {} + + +def get_cls_types_namespace(cls: type[Any], parent_namespace: dict[str, Any] | None = None) -> dict[str, Any]: + ns = add_module_globals(cls, parent_namespace) + ns[cls.__name__] = cls + return ns + + +def get_cls_type_hints_lenient(obj: Any, globalns: dict[str, Any] | None = None) -> dict[str, Any]: + """Collect annotations from a class, including those from parent classes. + + Unlike `typing.get_type_hints`, this function will not error if a forward reference is not resolvable. + """ + hints = {} + for base in reversed(obj.__mro__): + ann = base.__dict__.get('__annotations__') + localns = dict(vars(base)) + if ann is not None and ann is not GetSetDescriptorType: + for name, value in ann.items(): + hints[name] = eval_type_lenient(value, globalns, localns) + return hints + + +def eval_type_lenient(value: Any, globalns: dict[str, Any] | None = None, localns: dict[str, Any] | None = None) -> Any: + """Behaves like typing._eval_type, except it won't raise an error if a forward reference can't be resolved.""" + if value is None: + value = NoneType + elif isinstance(value, str): + value = _make_forward_ref(value, is_argument=False, is_class=True) + + try: + return eval_type_backport(value, globalns, localns) + except NameError: + # the point of this function is to be tolerant to this case + return value + + +def eval_type_backport( + value: Any, + globalns: dict[str, Any] | None = None, + localns: dict[str, Any] | None = None, + type_params: tuple[Any] | None = None, +) -> Any: + """Like `typing._eval_type`, but falls back to the `eval_type_backport` package if it's + installed to let older Python versions use newer typing features. + Specifically, this transforms `X | Y` into `typing.Union[X, Y]` + and `list[X]` into `typing.List[X]` etc. (for all the types made generic in PEP 585) + if the original syntax is not supported in the current Python version. + """ + try: + if sys.version_info >= (3, 13): + return typing._eval_type( # type: ignore + value, globalns, localns, type_params=type_params + ) + else: + return typing._eval_type( # type: ignore + value, globalns, localns + ) + except TypeError as e: + if not (isinstance(value, typing.ForwardRef) and is_backport_fixable_error(e)): + raise + try: + from eval_type_backport import eval_type_backport + except ImportError: + raise TypeError( + f'You have a type annotation {value.__forward_arg__!r} ' + f'which makes use of newer typing features than are supported in your version of Python. ' + f'To handle this error, you should either remove the use of new syntax ' + f'or install the `eval_type_backport` package.' + ) from e + + return eval_type_backport(value, globalns, localns, try_default=False) + + +def is_backport_fixable_error(e: TypeError) -> bool: + msg = str(e) + return msg.startswith('unsupported operand type(s) for |: ') or "' object is not subscriptable" in msg + + +def get_function_type_hints( + function: Callable[..., Any], *, include_keys: set[str] | None = None, types_namespace: dict[str, Any] | None = None +) -> dict[str, Any]: + """Like `typing.get_type_hints`, but doesn't convert `X` to `Optional[X]` if the default value is `None`, also + copes with `partial`. + """ + try: + if isinstance(function, partial): + annotations = function.func.__annotations__ + else: + annotations = function.__annotations__ + except AttributeError: + type_hints = get_type_hints(function) + if isinstance(function, type): + # `type[...]` is a callable, which returns an instance of itself. + # At some point, we might even look into the return type of `__new__` + # if it returns something else. + type_hints.setdefault('return', function) + return type_hints + + globalns = add_module_globals(function) + type_hints = {} + type_params: tuple[Any] = getattr(function, '__type_params__', ()) # type: ignore + for name, value in annotations.items(): + if include_keys is not None and name not in include_keys: + continue + if value is None: + value = NoneType + elif isinstance(value, str): + value = _make_forward_ref(value) + + type_hints[name] = eval_type_backport(value, globalns, types_namespace, type_params) + + return type_hints + + +if sys.version_info < (3, 9, 8) or (3, 10) <= sys.version_info < (3, 10, 1): + + def _make_forward_ref( + arg: Any, + is_argument: bool = True, + *, + is_class: bool = False, + ) -> typing.ForwardRef: + """Wrapper for ForwardRef that accounts for the `is_class` argument missing in older versions. + The `module` argument is omitted as it breaks <3.9.8, =3.10.0 and isn't used in the calls below. + + See https://github.com/python/cpython/pull/28560 for some background. + The backport happened on 3.9.8, see: + https://github.com/pydantic/pydantic/discussions/6244#discussioncomment-6275458, + and on 3.10.1 for the 3.10 branch, see: + https://github.com/pydantic/pydantic/issues/6912 + + Implemented as EAFP with memory. + """ + return typing.ForwardRef(arg, is_argument) + +else: + _make_forward_ref = typing.ForwardRef + + +if sys.version_info >= (3, 10): + get_type_hints = typing.get_type_hints + +else: + """ + For older versions of python, we have a custom implementation of `get_type_hints` which is a close as possible to + the implementation in CPython 3.10.8. + """ + + @typing.no_type_check + def get_type_hints( # noqa: C901 + obj: Any, + globalns: dict[str, Any] | None = None, + localns: dict[str, Any] | None = None, + include_extras: bool = False, + ) -> dict[str, Any]: # pragma: no cover + """Taken verbatim from python 3.10.8 unchanged, except: + * type annotations of the function definition above. + * prefixing `typing.` where appropriate + * Use `_make_forward_ref` instead of `typing.ForwardRef` to handle the `is_class` argument. + + https://github.com/python/cpython/blob/aaaf5174241496afca7ce4d4584570190ff972fe/Lib/typing.py#L1773-L1875 + + DO NOT CHANGE THIS METHOD UNLESS ABSOLUTELY NECESSARY. + ====================================================== + + Return type hints for an object. + + This is often the same as obj.__annotations__, but it handles + forward references encoded as string literals, adds Optional[t] if a + default value equal to None is set and recursively replaces all + 'Annotated[T, ...]' with 'T' (unless 'include_extras=True'). + + The argument may be a module, class, method, or function. The annotations + are returned as a dictionary. For classes, annotations include also + inherited members. + + TypeError is raised if the argument is not of a type that can contain + annotations, and an empty dictionary is returned if no annotations are + present. + + BEWARE -- the behavior of globalns and localns is counterintuitive + (unless you are familiar with how eval() and exec() work). The + search order is locals first, then globals. + + - If no dict arguments are passed, an attempt is made to use the + globals from obj (or the respective module's globals for classes), + and these are also used as the locals. If the object does not appear + to have globals, an empty dictionary is used. For classes, the search + order is globals first then locals. + + - If one dict argument is passed, it is used for both globals and + locals. + + - If two dict arguments are passed, they specify globals and + locals, respectively. + """ + if getattr(obj, '__no_type_check__', None): + return {} + # Classes require a special treatment. + if isinstance(obj, type): + hints = {} + for base in reversed(obj.__mro__): + if globalns is None: + base_globals = getattr(sys.modules.get(base.__module__, None), '__dict__', {}) + else: + base_globals = globalns + ann = base.__dict__.get('__annotations__', {}) + if isinstance(ann, types.GetSetDescriptorType): + ann = {} + base_locals = dict(vars(base)) if localns is None else localns + if localns is None and globalns is None: + # This is surprising, but required. Before Python 3.10, + # get_type_hints only evaluated the globalns of + # a class. To maintain backwards compatibility, we reverse + # the globalns and localns order so that eval() looks into + # *base_globals* first rather than *base_locals*. + # This only affects ForwardRefs. + base_globals, base_locals = base_locals, base_globals + for name, value in ann.items(): + if value is None: + value = type(None) + if isinstance(value, str): + value = _make_forward_ref(value, is_argument=False, is_class=True) + + value = eval_type_backport(value, base_globals, base_locals) + hints[name] = value + if not include_extras and hasattr(typing, '_strip_annotations'): + return { + k: typing._strip_annotations(t) # type: ignore + for k, t in hints.items() + } + else: + return hints + + if globalns is None: + if isinstance(obj, types.ModuleType): + globalns = obj.__dict__ + else: + nsobj = obj + # Find globalns for the unwrapped object. + while hasattr(nsobj, '__wrapped__'): + nsobj = nsobj.__wrapped__ + globalns = getattr(nsobj, '__globals__', {}) + if localns is None: + localns = globalns + elif localns is None: + localns = globalns + hints = getattr(obj, '__annotations__', None) + if hints is None: + # Return empty annotations for something that _could_ have them. + if isinstance(obj, typing._allowed_types): # type: ignore + return {} + else: + raise TypeError(f'{obj!r} is not a module, class, method, ' 'or function.') + defaults = typing._get_defaults(obj) # type: ignore + hints = dict(hints) + for name, value in hints.items(): + if value is None: + value = type(None) + if isinstance(value, str): + # class-level forward refs were handled above, this must be either + # a module-level annotation or a function argument annotation + + value = _make_forward_ref( + value, + is_argument=not isinstance(obj, types.ModuleType), + is_class=False, + ) + value = eval_type_backport(value, globalns, localns) + if name in defaults and defaults[name] is None: + value = typing.Optional[value] + hints[name] = value + return hints if include_extras else {k: typing._strip_annotations(t) for k, t in hints.items()} # type: ignore + + +def is_dataclass(_cls: type[Any]) -> TypeGuard[type[StandardDataclass]]: + # The dataclasses.is_dataclass function doesn't seem to provide TypeGuard functionality, + # so I created this convenience function + return dataclasses.is_dataclass(_cls) + + +def origin_is_type_alias_type(origin: Any) -> TypeGuard[TypeAliasType]: + return isinstance(origin, TypeAliasType) + + +if sys.version_info >= (3, 10): + + def is_generic_alias(type_: type[Any]) -> bool: + return isinstance(type_, (types.GenericAlias, typing._GenericAlias)) # type: ignore[attr-defined] + +else: + + def is_generic_alias(type_: type[Any]) -> bool: + return isinstance(type_, typing._GenericAlias) # type: ignore + + +def is_self_type(tp: Any) -> bool: + """Check if a given class is a Self type (from `typing` or `typing_extensions`)""" + return isinstance(tp, typing_base) and getattr(tp, '_name', None) == 'Self' diff --git a/env/Lib/site-packages/pydantic/_internal/_utils.py b/env/Lib/site-packages/pydantic/_internal/_utils.py new file mode 100644 index 0000000..de19243 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_utils.py @@ -0,0 +1,362 @@ +"""Bucket of reusable internal utilities. + +This should be reduced as much as possible with functions only used in one place, moved to that place. +""" + +from __future__ import annotations as _annotations + +import dataclasses +import keyword +import typing +import weakref +from collections import OrderedDict, defaultdict, deque +from copy import deepcopy +from itertools import zip_longest +from types import BuiltinFunctionType, CodeType, FunctionType, GeneratorType, LambdaType, ModuleType +from typing import Any, Mapping, TypeVar + +from typing_extensions import TypeAlias, TypeGuard + +from . import _repr, _typing_extra + +if typing.TYPE_CHECKING: + MappingIntStrAny: TypeAlias = 'typing.Mapping[int, Any] | typing.Mapping[str, Any]' + AbstractSetIntStr: TypeAlias = 'typing.AbstractSet[int] | typing.AbstractSet[str]' + from ..main import BaseModel + + +# these are types that are returned unchanged by deepcopy +IMMUTABLE_NON_COLLECTIONS_TYPES: set[type[Any]] = { + int, + float, + complex, + str, + bool, + bytes, + type, + _typing_extra.NoneType, + FunctionType, + BuiltinFunctionType, + LambdaType, + weakref.ref, + CodeType, + # note: including ModuleType will differ from behaviour of deepcopy by not producing error. + # It might be not a good idea in general, but considering that this function used only internally + # against default values of fields, this will allow to actually have a field with module as default value + ModuleType, + NotImplemented.__class__, + Ellipsis.__class__, +} + +# these are types that if empty, might be copied with simple copy() instead of deepcopy() +BUILTIN_COLLECTIONS: set[type[Any]] = { + list, + set, + tuple, + frozenset, + dict, + OrderedDict, + defaultdict, + deque, +} + + +def sequence_like(v: Any) -> bool: + return isinstance(v, (list, tuple, set, frozenset, GeneratorType, deque)) + + +def lenient_isinstance(o: Any, class_or_tuple: type[Any] | tuple[type[Any], ...] | None) -> bool: # pragma: no cover + try: + return isinstance(o, class_or_tuple) # type: ignore[arg-type] + except TypeError: + return False + + +def lenient_issubclass(cls: Any, class_or_tuple: Any) -> bool: # pragma: no cover + try: + return isinstance(cls, type) and issubclass(cls, class_or_tuple) + except TypeError: + if isinstance(cls, _typing_extra.WithArgsTypes): + return False + raise # pragma: no cover + + +def is_model_class(cls: Any) -> TypeGuard[type[BaseModel]]: + """Returns true if cls is a _proper_ subclass of BaseModel, and provides proper type-checking, + unlike raw calls to lenient_issubclass. + """ + from ..main import BaseModel + + return lenient_issubclass(cls, BaseModel) and cls is not BaseModel + + +def is_valid_identifier(identifier: str) -> bool: + """Checks that a string is a valid identifier and not a Python keyword. + :param identifier: The identifier to test. + :return: True if the identifier is valid. + """ + return identifier.isidentifier() and not keyword.iskeyword(identifier) + + +KeyType = TypeVar('KeyType') + + +def deep_update(mapping: dict[KeyType, Any], *updating_mappings: dict[KeyType, Any]) -> dict[KeyType, Any]: + updated_mapping = mapping.copy() + for updating_mapping in updating_mappings: + for k, v in updating_mapping.items(): + if k in updated_mapping and isinstance(updated_mapping[k], dict) and isinstance(v, dict): + updated_mapping[k] = deep_update(updated_mapping[k], v) + else: + updated_mapping[k] = v + return updated_mapping + + +def update_not_none(mapping: dict[Any, Any], **update: Any) -> None: + mapping.update({k: v for k, v in update.items() if v is not None}) + + +T = TypeVar('T') + + +def unique_list( + input_list: list[T] | tuple[T, ...], + *, + name_factory: typing.Callable[[T], str] = str, +) -> list[T]: + """Make a list unique while maintaining order. + We update the list if another one with the same name is set + (e.g. model validator overridden in subclass). + """ + result: list[T] = [] + result_names: list[str] = [] + for v in input_list: + v_name = name_factory(v) + if v_name not in result_names: + result_names.append(v_name) + result.append(v) + else: + result[result_names.index(v_name)] = v + + return result + + +class ValueItems(_repr.Representation): + """Class for more convenient calculation of excluded or included fields on values.""" + + __slots__ = ('_items', '_type') + + def __init__(self, value: Any, items: AbstractSetIntStr | MappingIntStrAny) -> None: + items = self._coerce_items(items) + + if isinstance(value, (list, tuple)): + items = self._normalize_indexes(items, len(value)) # type: ignore + + self._items: MappingIntStrAny = items # type: ignore + + def is_excluded(self, item: Any) -> bool: + """Check if item is fully excluded. + + :param item: key or index of a value + """ + return self.is_true(self._items.get(item)) + + def is_included(self, item: Any) -> bool: + """Check if value is contained in self._items. + + :param item: key or index of value + """ + return item in self._items + + def for_element(self, e: int | str) -> AbstractSetIntStr | MappingIntStrAny | None: + """:param e: key or index of element on value + :return: raw values for element if self._items is dict and contain needed element + """ + item = self._items.get(e) # type: ignore + return item if not self.is_true(item) else None + + def _normalize_indexes(self, items: MappingIntStrAny, v_length: int) -> dict[int | str, Any]: + """:param items: dict or set of indexes which will be normalized + :param v_length: length of sequence indexes of which will be + + >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4) + {0: True, 2: True, 3: True} + >>> self._normalize_indexes({'__all__': True}, 4) + {0: True, 1: True, 2: True, 3: True} + """ + normalized_items: dict[int | str, Any] = {} + all_items = None + for i, v in items.items(): + if not (isinstance(v, typing.Mapping) or isinstance(v, typing.AbstractSet) or self.is_true(v)): + raise TypeError(f'Unexpected type of exclude value for index "{i}" {v.__class__}') + if i == '__all__': + all_items = self._coerce_value(v) + continue + if not isinstance(i, int): + raise TypeError( + 'Excluding fields from a sequence of sub-models or dicts must be performed index-wise: ' + 'expected integer keys or keyword "__all__"' + ) + normalized_i = v_length + i if i < 0 else i + normalized_items[normalized_i] = self.merge(v, normalized_items.get(normalized_i)) + + if not all_items: + return normalized_items + if self.is_true(all_items): + for i in range(v_length): + normalized_items.setdefault(i, ...) + return normalized_items + for i in range(v_length): + normalized_item = normalized_items.setdefault(i, {}) + if not self.is_true(normalized_item): + normalized_items[i] = self.merge(all_items, normalized_item) + return normalized_items + + @classmethod + def merge(cls, base: Any, override: Any, intersect: bool = False) -> Any: + """Merge a `base` item with an `override` item. + + Both `base` and `override` are converted to dictionaries if possible. + Sets are converted to dictionaries with the sets entries as keys and + Ellipsis as values. + + Each key-value pair existing in `base` is merged with `override`, + while the rest of the key-value pairs are updated recursively with this function. + + Merging takes place based on the "union" of keys if `intersect` is + set to `False` (default) and on the intersection of keys if + `intersect` is set to `True`. + """ + override = cls._coerce_value(override) + base = cls._coerce_value(base) + if override is None: + return base + if cls.is_true(base) or base is None: + return override + if cls.is_true(override): + return base if intersect else override + + # intersection or union of keys while preserving ordering: + if intersect: + merge_keys = [k for k in base if k in override] + [k for k in override if k in base] + else: + merge_keys = list(base) + [k for k in override if k not in base] + + merged: dict[int | str, Any] = {} + for k in merge_keys: + merged_item = cls.merge(base.get(k), override.get(k), intersect=intersect) + if merged_item is not None: + merged[k] = merged_item + + return merged + + @staticmethod + def _coerce_items(items: AbstractSetIntStr | MappingIntStrAny) -> MappingIntStrAny: + if isinstance(items, typing.Mapping): + pass + elif isinstance(items, typing.AbstractSet): + items = dict.fromkeys(items, ...) # type: ignore + else: + class_name = getattr(items, '__class__', '???') + raise TypeError(f'Unexpected type of exclude value {class_name}') + return items # type: ignore + + @classmethod + def _coerce_value(cls, value: Any) -> Any: + if value is None or cls.is_true(value): + return value + return cls._coerce_items(value) + + @staticmethod + def is_true(v: Any) -> bool: + return v is True or v is ... + + def __repr_args__(self) -> _repr.ReprArgs: + return [(None, self._items)] + + +if typing.TYPE_CHECKING: + + def ClassAttribute(name: str, value: T) -> T: ... + +else: + + class ClassAttribute: + """Hide class attribute from its instances.""" + + __slots__ = 'name', 'value' + + def __init__(self, name: str, value: Any) -> None: + self.name = name + self.value = value + + def __get__(self, instance: Any, owner: type[Any]) -> None: + if instance is None: + return self.value + raise AttributeError(f'{self.name!r} attribute of {owner.__name__!r} is class-only') + + +Obj = TypeVar('Obj') + + +def smart_deepcopy(obj: Obj) -> Obj: + """Return type as is for immutable built-in types + Use obj.copy() for built-in empty collections + Use copy.deepcopy() for non-empty collections and unknown objects. + """ + obj_type = obj.__class__ + if obj_type in IMMUTABLE_NON_COLLECTIONS_TYPES: + return obj # fastest case: obj is immutable and not collection therefore will not be copied anyway + try: + if not obj and obj_type in BUILTIN_COLLECTIONS: + # faster way for empty collections, no need to copy its members + return obj if obj_type is tuple else obj.copy() # tuple doesn't have copy method # type: ignore + except (TypeError, ValueError, RuntimeError): + # do we really dare to catch ALL errors? Seems a bit risky + pass + + return deepcopy(obj) # slowest way when we actually might need a deepcopy + + +_SENTINEL = object() + + +def all_identical(left: typing.Iterable[Any], right: typing.Iterable[Any]) -> bool: + """Check that the items of `left` are the same objects as those in `right`. + + >>> a, b = object(), object() + >>> all_identical([a, b, a], [a, b, a]) + True + >>> all_identical([a, b, [a]], [a, b, [a]]) # new list object, while "equal" is not "identical" + False + """ + for left_item, right_item in zip_longest(left, right, fillvalue=_SENTINEL): + if left_item is not right_item: + return False + return True + + +@dataclasses.dataclass(frozen=True) +class SafeGetItemProxy: + """Wrapper redirecting `__getitem__` to `get` with a sentinel value as default + + This makes is safe to use in `operator.itemgetter` when some keys may be missing + """ + + # Define __slots__manually for performances + # @dataclasses.dataclass() only support slots=True in python>=3.10 + __slots__ = ('wrapped',) + + wrapped: Mapping[str, Any] + + def __getitem__(self, key: str, /) -> Any: + return self.wrapped.get(key, _SENTINEL) + + # required to pass the object to operator.itemgetter() instances due to a quirk of typeshed + # https://github.com/python/mypy/issues/13713 + # https://github.com/python/typeshed/pull/8785 + # Since this is typing-only, hide it in a typing.TYPE_CHECKING block + if typing.TYPE_CHECKING: + + def __contains__(self, key: str, /) -> bool: + return self.wrapped.__contains__(key) diff --git a/env/Lib/site-packages/pydantic/_internal/_validate_call.py b/env/Lib/site-packages/pydantic/_internal/_validate_call.py new file mode 100644 index 0000000..3fae2d1 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_validate_call.py @@ -0,0 +1,99 @@ +from __future__ import annotations as _annotations + +import inspect +from functools import partial +from typing import Any, Awaitable, Callable + +import pydantic_core + +from ..config import ConfigDict +from ..plugin._schema_validator import create_schema_validator +from . import _generate_schema, _typing_extra +from ._config import ConfigWrapper + + +class ValidateCallWrapper: + """This is a wrapper around a function that validates the arguments passed to it, and optionally the return value.""" + + __slots__ = ( + '__pydantic_validator__', + '__name__', + '__qualname__', + '__annotations__', + '__dict__', # required for __module__ + ) + + def __init__( + self, + function: Callable[..., Any], + config: ConfigDict | None, + validate_return: bool, + namespace: dict[str, Any] | None, + ): + if isinstance(function, partial): + func = function.func + schema_type = func + self.__name__ = f'partial({func.__name__})' + self.__qualname__ = f'partial({func.__qualname__})' + self.__module__ = func.__module__ + else: + schema_type = function + self.__name__ = function.__name__ + self.__qualname__ = function.__qualname__ + self.__module__ = function.__module__ + + global_ns = _typing_extra.add_module_globals(function, None) + # TODO: this is a bit of a hack, we should probably have a better way to handle this + # specifically, we shouldn't be pumping the namespace full of type_params + # when we take namespace and type_params arguments in eval_type_backport + type_params = getattr(schema_type, '__type_params__', ()) + namespace = { + **{param.__name__: param for param in type_params}, + **(global_ns or {}), + **(namespace or {}), + } + config_wrapper = ConfigWrapper(config) + gen_schema = _generate_schema.GenerateSchema(config_wrapper, namespace) + schema = gen_schema.clean_schema(gen_schema.generate_schema(function)) + core_config = config_wrapper.core_config(self) + + self.__pydantic_validator__ = create_schema_validator( + schema, + schema_type, + self.__module__, + self.__qualname__, + 'validate_call', + core_config, + config_wrapper.plugin_settings, + ) + + if validate_return: + signature = inspect.signature(function) + return_type = signature.return_annotation if signature.return_annotation is not signature.empty else Any + gen_schema = _generate_schema.GenerateSchema(config_wrapper, namespace) + schema = gen_schema.clean_schema(gen_schema.generate_schema(return_type)) + validator = create_schema_validator( + schema, + schema_type, + self.__module__, + self.__qualname__, + 'validate_call', + core_config, + config_wrapper.plugin_settings, + ) + if inspect.iscoroutinefunction(function): + + async def return_val_wrapper(aw: Awaitable[Any]) -> None: + return validator.validate_python(await aw) + + self.__return_pydantic_validator__ = return_val_wrapper + else: + self.__return_pydantic_validator__ = validator.validate_python + else: + self.__return_pydantic_validator__ = None + + def __call__(self, *args: Any, **kwargs: Any) -> Any: + res = self.__pydantic_validator__.validate_python(pydantic_core.ArgsKwargs(args, kwargs)) + if self.__return_pydantic_validator__: + return self.__return_pydantic_validator__(res) + return res diff --git a/env/Lib/site-packages/pydantic/_internal/_validators.py b/env/Lib/site-packages/pydantic/_internal/_validators.py new file mode 100644 index 0000000..870b536 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_internal/_validators.py @@ -0,0 +1,308 @@ +"""Validator functions for standard library types. + +Import of this module is deferred since it contains imports of many standard library modules. +""" + +from __future__ import annotations as _annotations + +import math +import re +import typing +from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network +from typing import Any, Callable + +from pydantic_core import PydanticCustomError, core_schema +from pydantic_core._pydantic_core import PydanticKnownError + + +def sequence_validator( + input_value: typing.Sequence[Any], + /, + validator: core_schema.ValidatorFunctionWrapHandler, +) -> typing.Sequence[Any]: + """Validator for `Sequence` types, isinstance(v, Sequence) has already been called.""" + value_type = type(input_value) + + # We don't accept any plain string as a sequence + # Relevant issue: https://github.com/pydantic/pydantic/issues/5595 + if issubclass(value_type, (str, bytes)): + raise PydanticCustomError( + 'sequence_str', + "'{type_name}' instances are not allowed as a Sequence value", + {'type_name': value_type.__name__}, + ) + + # TODO: refactor sequence validation to validate with either a list or a tuple + # schema, depending on the type of the value. + # Additionally, we should be able to remove one of either this validator or the + # SequenceValidator in _std_types_schema.py (preferably this one, while porting over some logic). + # Effectively, a refactor for sequence validation is needed. + if value_type is tuple: + input_value = list(input_value) + + v_list = validator(input_value) + + # the rest of the logic is just re-creating the original type from `v_list` + if value_type is list: + return v_list + elif issubclass(value_type, range): + # return the list as we probably can't re-create the range + return v_list + elif value_type is tuple: + return tuple(v_list) + else: + # best guess at how to re-create the original type, more custom construction logic might be required + return value_type(v_list) # type: ignore[call-arg] + + +def import_string(value: Any) -> Any: + if isinstance(value, str): + try: + return _import_string_logic(value) + except ImportError as e: + raise PydanticCustomError('import_error', 'Invalid python path: {error}', {'error': str(e)}) from e + else: + # otherwise we just return the value and let the next validator do the rest of the work + return value + + +def _import_string_logic(dotted_path: str) -> Any: + """Inspired by uvicorn — dotted paths should include a colon before the final item if that item is not a module. + (This is necessary to distinguish between a submodule and an attribute when there is a conflict.). + + If the dotted path does not include a colon and the final item is not a valid module, importing as an attribute + rather than a submodule will be attempted automatically. + + So, for example, the following values of `dotted_path` result in the following returned values: + * 'collections': + * 'collections.abc': + * 'collections.abc:Mapping': + * `collections.abc.Mapping`: (though this is a bit slower than the previous line) + + An error will be raised under any of the following scenarios: + * `dotted_path` contains more than one colon (e.g., 'collections:abc:Mapping') + * the substring of `dotted_path` before the colon is not a valid module in the environment (e.g., '123:Mapping') + * the substring of `dotted_path` after the colon is not an attribute of the module (e.g., 'collections:abc123') + """ + from importlib import import_module + + components = dotted_path.strip().split(':') + if len(components) > 2: + raise ImportError(f"Import strings should have at most one ':'; received {dotted_path!r}") + + module_path = components[0] + if not module_path: + raise ImportError(f'Import strings should have a nonempty module name; received {dotted_path!r}') + + try: + module = import_module(module_path) + except ModuleNotFoundError as e: + if '.' in module_path: + # Check if it would be valid if the final item was separated from its module with a `:` + maybe_module_path, maybe_attribute = dotted_path.strip().rsplit('.', 1) + try: + return _import_string_logic(f'{maybe_module_path}:{maybe_attribute}') + except ImportError: + pass + raise ImportError(f'No module named {module_path!r}') from e + raise e + + if len(components) > 1: + attribute = components[1] + try: + return getattr(module, attribute) + except AttributeError as e: + raise ImportError(f'cannot import name {attribute!r} from {module_path!r}') from e + else: + return module + + +def pattern_either_validator(input_value: Any, /) -> typing.Pattern[Any]: + if isinstance(input_value, typing.Pattern): + return input_value + elif isinstance(input_value, (str, bytes)): + # todo strict mode + return compile_pattern(input_value) # type: ignore + else: + raise PydanticCustomError('pattern_type', 'Input should be a valid pattern') + + +def pattern_str_validator(input_value: Any, /) -> typing.Pattern[str]: + if isinstance(input_value, typing.Pattern): + if isinstance(input_value.pattern, str): + return input_value + else: + raise PydanticCustomError('pattern_str_type', 'Input should be a string pattern') + elif isinstance(input_value, str): + return compile_pattern(input_value) + elif isinstance(input_value, bytes): + raise PydanticCustomError('pattern_str_type', 'Input should be a string pattern') + else: + raise PydanticCustomError('pattern_type', 'Input should be a valid pattern') + + +def pattern_bytes_validator(input_value: Any, /) -> typing.Pattern[bytes]: + if isinstance(input_value, typing.Pattern): + if isinstance(input_value.pattern, bytes): + return input_value + else: + raise PydanticCustomError('pattern_bytes_type', 'Input should be a bytes pattern') + elif isinstance(input_value, bytes): + return compile_pattern(input_value) + elif isinstance(input_value, str): + raise PydanticCustomError('pattern_bytes_type', 'Input should be a bytes pattern') + else: + raise PydanticCustomError('pattern_type', 'Input should be a valid pattern') + + +PatternType = typing.TypeVar('PatternType', str, bytes) + + +def compile_pattern(pattern: PatternType) -> typing.Pattern[PatternType]: + try: + return re.compile(pattern) + except re.error: + raise PydanticCustomError('pattern_regex', 'Input should be a valid regular expression') + + +def ip_v4_address_validator(input_value: Any, /) -> IPv4Address: + if isinstance(input_value, IPv4Address): + return input_value + + try: + return IPv4Address(input_value) + except ValueError: + raise PydanticCustomError('ip_v4_address', 'Input is not a valid IPv4 address') + + +def ip_v6_address_validator(input_value: Any, /) -> IPv6Address: + if isinstance(input_value, IPv6Address): + return input_value + + try: + return IPv6Address(input_value) + except ValueError: + raise PydanticCustomError('ip_v6_address', 'Input is not a valid IPv6 address') + + +def ip_v4_network_validator(input_value: Any, /) -> IPv4Network: + """Assume IPv4Network initialised with a default `strict` argument. + + See more: + https://docs.python.org/library/ipaddress.html#ipaddress.IPv4Network + """ + if isinstance(input_value, IPv4Network): + return input_value + + try: + return IPv4Network(input_value) + except ValueError: + raise PydanticCustomError('ip_v4_network', 'Input is not a valid IPv4 network') + + +def ip_v6_network_validator(input_value: Any, /) -> IPv6Network: + """Assume IPv6Network initialised with a default `strict` argument. + + See more: + https://docs.python.org/library/ipaddress.html#ipaddress.IPv6Network + """ + if isinstance(input_value, IPv6Network): + return input_value + + try: + return IPv6Network(input_value) + except ValueError: + raise PydanticCustomError('ip_v6_network', 'Input is not a valid IPv6 network') + + +def ip_v4_interface_validator(input_value: Any, /) -> IPv4Interface: + if isinstance(input_value, IPv4Interface): + return input_value + + try: + return IPv4Interface(input_value) + except ValueError: + raise PydanticCustomError('ip_v4_interface', 'Input is not a valid IPv4 interface') + + +def ip_v6_interface_validator(input_value: Any, /) -> IPv6Interface: + if isinstance(input_value, IPv6Interface): + return input_value + + try: + return IPv6Interface(input_value) + except ValueError: + raise PydanticCustomError('ip_v6_interface', 'Input is not a valid IPv6 interface') + + +def greater_than_validator(x: Any, gt: Any) -> Any: + if not (x > gt): + raise PydanticKnownError('greater_than', {'gt': gt}) + return x + + +def greater_than_or_equal_validator(x: Any, ge: Any) -> Any: + if not (x >= ge): + raise PydanticKnownError('greater_than_equal', {'ge': ge}) + return x + + +def less_than_validator(x: Any, lt: Any) -> Any: + if not (x < lt): + raise PydanticKnownError('less_than', {'lt': lt}) + return x + + +def less_than_or_equal_validator(x: Any, le: Any) -> Any: + if not (x <= le): + raise PydanticKnownError('less_than_equal', {'le': le}) + return x + + +def multiple_of_validator(x: Any, multiple_of: Any) -> Any: + if not (x % multiple_of == 0): + raise PydanticKnownError('multiple_of', {'multiple_of': multiple_of}) + return x + + +def min_length_validator(x: Any, min_length: Any) -> Any: + if not (len(x) >= min_length): + raise PydanticKnownError( + 'too_short', + {'field_type': 'Value', 'min_length': min_length, 'actual_length': len(x)}, + ) + return x + + +def max_length_validator(x: Any, max_length: Any) -> Any: + if len(x) > max_length: + raise PydanticKnownError( + 'too_long', + {'field_type': 'Value', 'max_length': max_length, 'actual_length': len(x)}, + ) + return x + + +def forbid_inf_nan_check(x: Any) -> Any: + if not math.isfinite(x): + raise PydanticKnownError('finite_number') + return x + + +_CONSTRAINT_TO_VALIDATOR_MAP: dict[str, Callable] = { + 'gt': greater_than_validator, + 'ge': greater_than_or_equal_validator, + 'lt': less_than_validator, + 'le': less_than_or_equal_validator, + 'multiple_of': multiple_of_validator, + 'min_length': min_length_validator, + 'max_length': max_length_validator, +} + + +def get_constraint_validator(constraint: str) -> Callable: + """Fetch the validator function for the given constraint.""" + try: + return _CONSTRAINT_TO_VALIDATOR_MAP[constraint] + except KeyError: + raise TypeError(f'Unknown constraint {constraint}') diff --git a/env/Lib/site-packages/pydantic/_migration.py b/env/Lib/site-packages/pydantic/_migration.py new file mode 100644 index 0000000..c8478a6 --- /dev/null +++ b/env/Lib/site-packages/pydantic/_migration.py @@ -0,0 +1,308 @@ +import sys +from typing import Any, Callable, Dict + +from .version import version_short + +MOVED_IN_V2 = { + 'pydantic.utils:version_info': 'pydantic.version:version_info', + 'pydantic.error_wrappers:ValidationError': 'pydantic:ValidationError', + 'pydantic.utils:to_camel': 'pydantic.alias_generators:to_pascal', + 'pydantic.utils:to_lower_camel': 'pydantic.alias_generators:to_camel', + 'pydantic:PyObject': 'pydantic.types:ImportString', + 'pydantic.types:PyObject': 'pydantic.types:ImportString', + 'pydantic.generics:GenericModel': 'pydantic.BaseModel', +} + +DEPRECATED_MOVED_IN_V2 = { + 'pydantic.tools:schema_of': 'pydantic.deprecated.tools:schema_of', + 'pydantic.tools:parse_obj_as': 'pydantic.deprecated.tools:parse_obj_as', + 'pydantic.tools:schema_json_of': 'pydantic.deprecated.tools:schema_json_of', + 'pydantic.json:pydantic_encoder': 'pydantic.deprecated.json:pydantic_encoder', + 'pydantic:validate_arguments': 'pydantic.deprecated.decorator:validate_arguments', + 'pydantic.json:custom_pydantic_encoder': 'pydantic.deprecated.json:custom_pydantic_encoder', + 'pydantic.json:timedelta_isoformat': 'pydantic.deprecated.json:timedelta_isoformat', + 'pydantic.decorator:validate_arguments': 'pydantic.deprecated.decorator:validate_arguments', + 'pydantic.class_validators:validator': 'pydantic.deprecated.class_validators:validator', + 'pydantic.class_validators:root_validator': 'pydantic.deprecated.class_validators:root_validator', + 'pydantic.config:BaseConfig': 'pydantic.deprecated.config:BaseConfig', + 'pydantic.config:Extra': 'pydantic.deprecated.config:Extra', +} + +REDIRECT_TO_V1 = { + f'pydantic.utils:{obj}': f'pydantic.v1.utils:{obj}' + for obj in ( + 'deep_update', + 'GetterDict', + 'lenient_issubclass', + 'lenient_isinstance', + 'is_valid_field', + 'update_not_none', + 'import_string', + 'Representation', + 'ROOT_KEY', + 'smart_deepcopy', + 'sequence_like', + ) +} + + +REMOVED_IN_V2 = { + 'pydantic:ConstrainedBytes', + 'pydantic:ConstrainedDate', + 'pydantic:ConstrainedDecimal', + 'pydantic:ConstrainedFloat', + 'pydantic:ConstrainedFrozenSet', + 'pydantic:ConstrainedInt', + 'pydantic:ConstrainedList', + 'pydantic:ConstrainedSet', + 'pydantic:ConstrainedStr', + 'pydantic:JsonWrapper', + 'pydantic:NoneBytes', + 'pydantic:NoneStr', + 'pydantic:NoneStrBytes', + 'pydantic:Protocol', + 'pydantic:Required', + 'pydantic:StrBytes', + 'pydantic:compiled', + 'pydantic.config:get_config', + 'pydantic.config:inherit_config', + 'pydantic.config:prepare_config', + 'pydantic:create_model_from_namedtuple', + 'pydantic:create_model_from_typeddict', + 'pydantic.dataclasses:create_pydantic_model_from_dataclass', + 'pydantic.dataclasses:make_dataclass_validator', + 'pydantic.dataclasses:set_validation', + 'pydantic.datetime_parse:parse_date', + 'pydantic.datetime_parse:parse_time', + 'pydantic.datetime_parse:parse_datetime', + 'pydantic.datetime_parse:parse_duration', + 'pydantic.error_wrappers:ErrorWrapper', + 'pydantic.errors:AnyStrMaxLengthError', + 'pydantic.errors:AnyStrMinLengthError', + 'pydantic.errors:ArbitraryTypeError', + 'pydantic.errors:BoolError', + 'pydantic.errors:BytesError', + 'pydantic.errors:CallableError', + 'pydantic.errors:ClassError', + 'pydantic.errors:ColorError', + 'pydantic.errors:ConfigError', + 'pydantic.errors:DataclassTypeError', + 'pydantic.errors:DateError', + 'pydantic.errors:DateNotInTheFutureError', + 'pydantic.errors:DateNotInThePastError', + 'pydantic.errors:DateTimeError', + 'pydantic.errors:DecimalError', + 'pydantic.errors:DecimalIsNotFiniteError', + 'pydantic.errors:DecimalMaxDigitsError', + 'pydantic.errors:DecimalMaxPlacesError', + 'pydantic.errors:DecimalWholeDigitsError', + 'pydantic.errors:DictError', + 'pydantic.errors:DurationError', + 'pydantic.errors:EmailError', + 'pydantic.errors:EnumError', + 'pydantic.errors:EnumMemberError', + 'pydantic.errors:ExtraError', + 'pydantic.errors:FloatError', + 'pydantic.errors:FrozenSetError', + 'pydantic.errors:FrozenSetMaxLengthError', + 'pydantic.errors:FrozenSetMinLengthError', + 'pydantic.errors:HashableError', + 'pydantic.errors:IPv4AddressError', + 'pydantic.errors:IPv4InterfaceError', + 'pydantic.errors:IPv4NetworkError', + 'pydantic.errors:IPv6AddressError', + 'pydantic.errors:IPv6InterfaceError', + 'pydantic.errors:IPv6NetworkError', + 'pydantic.errors:IPvAnyAddressError', + 'pydantic.errors:IPvAnyInterfaceError', + 'pydantic.errors:IPvAnyNetworkError', + 'pydantic.errors:IntEnumError', + 'pydantic.errors:IntegerError', + 'pydantic.errors:InvalidByteSize', + 'pydantic.errors:InvalidByteSizeUnit', + 'pydantic.errors:InvalidDiscriminator', + 'pydantic.errors:InvalidLengthForBrand', + 'pydantic.errors:JsonError', + 'pydantic.errors:JsonTypeError', + 'pydantic.errors:ListError', + 'pydantic.errors:ListMaxLengthError', + 'pydantic.errors:ListMinLengthError', + 'pydantic.errors:ListUniqueItemsError', + 'pydantic.errors:LuhnValidationError', + 'pydantic.errors:MissingDiscriminator', + 'pydantic.errors:MissingError', + 'pydantic.errors:NoneIsAllowedError', + 'pydantic.errors:NoneIsNotAllowedError', + 'pydantic.errors:NotDigitError', + 'pydantic.errors:NotNoneError', + 'pydantic.errors:NumberNotGeError', + 'pydantic.errors:NumberNotGtError', + 'pydantic.errors:NumberNotLeError', + 'pydantic.errors:NumberNotLtError', + 'pydantic.errors:NumberNotMultipleError', + 'pydantic.errors:PathError', + 'pydantic.errors:PathNotADirectoryError', + 'pydantic.errors:PathNotAFileError', + 'pydantic.errors:PathNotExistsError', + 'pydantic.errors:PatternError', + 'pydantic.errors:PyObjectError', + 'pydantic.errors:PydanticTypeError', + 'pydantic.errors:PydanticValueError', + 'pydantic.errors:SequenceError', + 'pydantic.errors:SetError', + 'pydantic.errors:SetMaxLengthError', + 'pydantic.errors:SetMinLengthError', + 'pydantic.errors:StrError', + 'pydantic.errors:StrRegexError', + 'pydantic.errors:StrictBoolError', + 'pydantic.errors:SubclassError', + 'pydantic.errors:TimeError', + 'pydantic.errors:TupleError', + 'pydantic.errors:TupleLengthError', + 'pydantic.errors:UUIDError', + 'pydantic.errors:UUIDVersionError', + 'pydantic.errors:UrlError', + 'pydantic.errors:UrlExtraError', + 'pydantic.errors:UrlHostError', + 'pydantic.errors:UrlHostTldError', + 'pydantic.errors:UrlPortError', + 'pydantic.errors:UrlSchemeError', + 'pydantic.errors:UrlSchemePermittedError', + 'pydantic.errors:UrlUserInfoError', + 'pydantic.errors:WrongConstantError', + 'pydantic.main:validate_model', + 'pydantic.networks:stricturl', + 'pydantic:parse_file_as', + 'pydantic:parse_raw_as', + 'pydantic:stricturl', + 'pydantic.tools:parse_file_as', + 'pydantic.tools:parse_raw_as', + 'pydantic.types:ConstrainedBytes', + 'pydantic.types:ConstrainedDate', + 'pydantic.types:ConstrainedDecimal', + 'pydantic.types:ConstrainedFloat', + 'pydantic.types:ConstrainedFrozenSet', + 'pydantic.types:ConstrainedInt', + 'pydantic.types:ConstrainedList', + 'pydantic.types:ConstrainedSet', + 'pydantic.types:ConstrainedStr', + 'pydantic.types:JsonWrapper', + 'pydantic.types:NoneBytes', + 'pydantic.types:NoneStr', + 'pydantic.types:NoneStrBytes', + 'pydantic.types:StrBytes', + 'pydantic.typing:evaluate_forwardref', + 'pydantic.typing:AbstractSetIntStr', + 'pydantic.typing:AnyCallable', + 'pydantic.typing:AnyClassMethod', + 'pydantic.typing:CallableGenerator', + 'pydantic.typing:DictAny', + 'pydantic.typing:DictIntStrAny', + 'pydantic.typing:DictStrAny', + 'pydantic.typing:IntStr', + 'pydantic.typing:ListStr', + 'pydantic.typing:MappingIntStrAny', + 'pydantic.typing:NoArgAnyCallable', + 'pydantic.typing:NoneType', + 'pydantic.typing:ReprArgs', + 'pydantic.typing:SetStr', + 'pydantic.typing:StrPath', + 'pydantic.typing:TupleGenerator', + 'pydantic.typing:WithArgsTypes', + 'pydantic.typing:all_literal_values', + 'pydantic.typing:display_as_type', + 'pydantic.typing:get_all_type_hints', + 'pydantic.typing:get_args', + 'pydantic.typing:get_origin', + 'pydantic.typing:get_sub_types', + 'pydantic.typing:is_callable_type', + 'pydantic.typing:is_classvar', + 'pydantic.typing:is_finalvar', + 'pydantic.typing:is_literal_type', + 'pydantic.typing:is_namedtuple', + 'pydantic.typing:is_new_type', + 'pydantic.typing:is_none_type', + 'pydantic.typing:is_typeddict', + 'pydantic.typing:is_typeddict_special', + 'pydantic.typing:is_union', + 'pydantic.typing:new_type_supertype', + 'pydantic.typing:resolve_annotations', + 'pydantic.typing:typing_base', + 'pydantic.typing:update_field_forward_refs', + 'pydantic.typing:update_model_forward_refs', + 'pydantic.utils:ClassAttribute', + 'pydantic.utils:DUNDER_ATTRIBUTES', + 'pydantic.utils:PyObjectStr', + 'pydantic.utils:ValueItems', + 'pydantic.utils:almost_equal_floats', + 'pydantic.utils:get_discriminator_alias_and_values', + 'pydantic.utils:get_model', + 'pydantic.utils:get_unique_discriminator_alias', + 'pydantic.utils:in_ipython', + 'pydantic.utils:is_valid_identifier', + 'pydantic.utils:path_type', + 'pydantic.utils:validate_field_name', + 'pydantic:validate_model', +} + + +def getattr_migration(module: str) -> Callable[[str], Any]: + """Implement PEP 562 for objects that were either moved or removed on the migration + to V2. + + Args: + module: The module name. + + Returns: + A callable that will raise an error if the object is not found. + """ + # This avoids circular import with errors.py. + from .errors import PydanticImportError + + def wrapper(name: str) -> object: + """Raise an error if the object is not found, or warn if it was moved. + + In case it was moved, it still returns the object. + + Args: + name: The object name. + + Returns: + The object. + """ + if name == '__path__': + raise AttributeError(f'module {module!r} has no attribute {name!r}') + + import warnings + + from ._internal._validators import import_string + + import_path = f'{module}:{name}' + if import_path in MOVED_IN_V2.keys(): + new_location = MOVED_IN_V2[import_path] + warnings.warn(f'`{import_path}` has been moved to `{new_location}`.') + return import_string(MOVED_IN_V2[import_path]) + if import_path in DEPRECATED_MOVED_IN_V2: + # skip the warning here because a deprecation warning will be raised elsewhere + return import_string(DEPRECATED_MOVED_IN_V2[import_path]) + if import_path in REDIRECT_TO_V1: + new_location = REDIRECT_TO_V1[import_path] + warnings.warn( + f'`{import_path}` has been removed. We are importing from `{new_location}` instead.' + 'See the migration guide for more details: https://docs.pydantic.dev/latest/migration/' + ) + return import_string(REDIRECT_TO_V1[import_path]) + if import_path == 'pydantic:BaseSettings': + raise PydanticImportError( + '`BaseSettings` has been moved to the `pydantic-settings` package. ' + f'See https://docs.pydantic.dev/{version_short()}/migration/#basesettings-has-moved-to-pydantic-settings ' + 'for more details.' + ) + if import_path in REMOVED_IN_V2: + raise PydanticImportError(f'`{import_path}` has been removed in V2.') + globals: Dict[str, Any] = sys.modules[module].__dict__ + if name in globals: + return globals[name] + raise AttributeError(f'module {module!r} has no attribute {name!r}') + + return wrapper diff --git a/env/Lib/site-packages/pydantic/alias_generators.py b/env/Lib/site-packages/pydantic/alias_generators.py new file mode 100644 index 0000000..0b7653f --- /dev/null +++ b/env/Lib/site-packages/pydantic/alias_generators.py @@ -0,0 +1,62 @@ +"""Alias generators for converting between different capitalization conventions.""" + +import re + +__all__ = ('to_pascal', 'to_camel', 'to_snake') + +# TODO: in V3, change the argument names to be more descriptive +# Generally, don't only convert from snake_case, or name the functions +# more specifically like snake_to_camel. + + +def to_pascal(snake: str) -> str: + """Convert a snake_case string to PascalCase. + + Args: + snake: The string to convert. + + Returns: + The PascalCase string. + """ + camel = snake.title() + return re.sub('([0-9A-Za-z])_(?=[0-9A-Z])', lambda m: m.group(1), camel) + + +def to_camel(snake: str) -> str: + """Convert a snake_case string to camelCase. + + Args: + snake: The string to convert. + + Returns: + The converted camelCase string. + """ + # If the string is already in camelCase and does not contain a digit followed + # by a lowercase letter, return it as it is + if re.match('^[a-z]+[A-Za-z0-9]*$', snake) and not re.search(r'\d[a-z]', snake): + return snake + + camel = to_pascal(snake) + return re.sub('(^_*[A-Z])', lambda m: m.group(1).lower(), camel) + + +def to_snake(camel: str) -> str: + """Convert a PascalCase, camelCase, or kebab-case string to snake_case. + + Args: + camel: The string to convert. + + Returns: + The converted string in snake_case. + """ + # Handle the sequence of uppercase letters followed by a lowercase letter + snake = re.sub(r'([A-Z]+)([A-Z][a-z])', lambda m: f'{m.group(1)}_{m.group(2)}', camel) + # Insert an underscore between a lowercase letter and an uppercase letter + snake = re.sub(r'([a-z])([A-Z])', lambda m: f'{m.group(1)}_{m.group(2)}', snake) + # Insert an underscore between a digit and an uppercase letter + snake = re.sub(r'([0-9])([A-Z])', lambda m: f'{m.group(1)}_{m.group(2)}', snake) + # Insert an underscore between a lowercase letter and a digit + snake = re.sub(r'([a-z])([0-9])', lambda m: f'{m.group(1)}_{m.group(2)}', snake) + # Replace hyphens with underscores to handle kebab-case + snake = snake.replace('-', '_') + return snake.lower() diff --git a/env/Lib/site-packages/pydantic/aliases.py b/env/Lib/site-packages/pydantic/aliases.py new file mode 100644 index 0000000..441fee1 --- /dev/null +++ b/env/Lib/site-packages/pydantic/aliases.py @@ -0,0 +1,132 @@ +"""Support for alias configurations.""" + +from __future__ import annotations + +import dataclasses +from typing import Any, Callable, Literal + +from pydantic_core import PydanticUndefined + +from ._internal import _internal_dataclass + +__all__ = ('AliasGenerator', 'AliasPath', 'AliasChoices') + + +@dataclasses.dataclass(**_internal_dataclass.slots_true) +class AliasPath: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/alias#aliaspath-and-aliaschoices + + A data class used by `validation_alias` as a convenience to create aliases. + + Attributes: + path: A list of string or integer aliases. + """ + + path: list[int | str] + + def __init__(self, first_arg: str, *args: str | int) -> None: + self.path = [first_arg] + list(args) + + def convert_to_aliases(self) -> list[str | int]: + """Converts arguments to a list of string or integer aliases. + + Returns: + The list of aliases. + """ + return self.path + + def search_dict_for_path(self, d: dict) -> Any: + """Searches a dictionary for the path specified by the alias. + + Returns: + The value at the specified path, or `PydanticUndefined` if the path is not found. + """ + v = d + for k in self.path: + if isinstance(v, str): + # disallow indexing into a str, like for AliasPath('x', 0) and x='abc' + return PydanticUndefined + try: + v = v[k] + except (KeyError, IndexError, TypeError): + return PydanticUndefined + return v + + +@dataclasses.dataclass(**_internal_dataclass.slots_true) +class AliasChoices: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/alias#aliaspath-and-aliaschoices + + A data class used by `validation_alias` as a convenience to create aliases. + + Attributes: + choices: A list containing a string or `AliasPath`. + """ + + choices: list[str | AliasPath] + + def __init__(self, first_choice: str | AliasPath, *choices: str | AliasPath) -> None: + self.choices = [first_choice] + list(choices) + + def convert_to_aliases(self) -> list[list[str | int]]: + """Converts arguments to a list of lists containing string or integer aliases. + + Returns: + The list of aliases. + """ + aliases: list[list[str | int]] = [] + for c in self.choices: + if isinstance(c, AliasPath): + aliases.append(c.convert_to_aliases()) + else: + aliases.append([c]) + return aliases + + +@dataclasses.dataclass(**_internal_dataclass.slots_true) +class AliasGenerator: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/alias#using-an-aliasgenerator + + A data class used by `alias_generator` as a convenience to create various aliases. + + Attributes: + alias: A callable that takes a field name and returns an alias for it. + validation_alias: A callable that takes a field name and returns a validation alias for it. + serialization_alias: A callable that takes a field name and returns a serialization alias for it. + """ + + alias: Callable[[str], str] | None = None + validation_alias: Callable[[str], str | AliasPath | AliasChoices] | None = None + serialization_alias: Callable[[str], str] | None = None + + def _generate_alias( + self, + alias_kind: Literal['alias', 'validation_alias', 'serialization_alias'], + allowed_types: tuple[type[str] | type[AliasPath] | type[AliasChoices], ...], + field_name: str, + ) -> str | AliasPath | AliasChoices | None: + """Generate an alias of the specified kind. Returns None if the alias generator is None. + + Raises: + TypeError: If the alias generator produces an invalid type. + """ + alias = None + if alias_generator := getattr(self, alias_kind): + alias = alias_generator(field_name) + if alias and not isinstance(alias, allowed_types): + raise TypeError( + f'Invalid `{alias_kind}` type. `{alias_kind}` generator must produce one of `{allowed_types}`' + ) + return alias + + def generate_aliases(self, field_name: str) -> tuple[str | None, str | AliasPath | AliasChoices | None, str | None]: + """Generate `alias`, `validation_alias`, and `serialization_alias` for a field. + + Returns: + A tuple of three aliases - validation, alias, and serialization. + """ + alias = self._generate_alias('alias', (str,), field_name) + validation_alias = self._generate_alias('validation_alias', (str, AliasChoices, AliasPath), field_name) + serialization_alias = self._generate_alias('serialization_alias', (str,), field_name) + + return alias, validation_alias, serialization_alias # type: ignore diff --git a/env/Lib/site-packages/pydantic/annotated_handlers.py b/env/Lib/site-packages/pydantic/annotated_handlers.py new file mode 100644 index 0000000..ac3d213 --- /dev/null +++ b/env/Lib/site-packages/pydantic/annotated_handlers.py @@ -0,0 +1,121 @@ +"""Type annotations to use with `__get_pydantic_core_schema__` and `__get_pydantic_json_schema__`.""" + +from __future__ import annotations as _annotations + +from typing import TYPE_CHECKING, Any, Union + +from pydantic_core import core_schema + +if TYPE_CHECKING: + from .json_schema import JsonSchemaMode, JsonSchemaValue + + CoreSchemaOrField = Union[ + core_schema.CoreSchema, + core_schema.ModelField, + core_schema.DataclassField, + core_schema.TypedDictField, + core_schema.ComputedField, + ] + +__all__ = 'GetJsonSchemaHandler', 'GetCoreSchemaHandler' + + +class GetJsonSchemaHandler: + """Handler to call into the next JSON schema generation function. + + Attributes: + mode: Json schema mode, can be `validation` or `serialization`. + """ + + mode: JsonSchemaMode + + def __call__(self, core_schema: CoreSchemaOrField, /) -> JsonSchemaValue: + """Call the inner handler and get the JsonSchemaValue it returns. + This will call the next JSON schema modifying function up until it calls + into `pydantic.json_schema.GenerateJsonSchema`, which will raise a + `pydantic.errors.PydanticInvalidForJsonSchema` error if it cannot generate + a JSON schema. + + Args: + core_schema: A `pydantic_core.core_schema.CoreSchema`. + + Returns: + JsonSchemaValue: The JSON schema generated by the inner JSON schema modify + functions. + """ + raise NotImplementedError + + def resolve_ref_schema(self, maybe_ref_json_schema: JsonSchemaValue, /) -> JsonSchemaValue: + """Get the real schema for a `{"$ref": ...}` schema. + If the schema given is not a `$ref` schema, it will be returned as is. + This means you don't have to check before calling this function. + + Args: + maybe_ref_json_schema: A JsonSchemaValue which may be a `$ref` schema. + + Raises: + LookupError: If the ref is not found. + + Returns: + JsonSchemaValue: A JsonSchemaValue that has no `$ref`. + """ + raise NotImplementedError + + +class GetCoreSchemaHandler: + """Handler to call into the next CoreSchema schema generation function.""" + + def __call__(self, source_type: Any, /) -> core_schema.CoreSchema: + """Call the inner handler and get the CoreSchema it returns. + This will call the next CoreSchema modifying function up until it calls + into Pydantic's internal schema generation machinery, which will raise a + `pydantic.errors.PydanticSchemaGenerationError` error if it cannot generate + a CoreSchema for the given source type. + + Args: + source_type: The input type. + + Returns: + CoreSchema: The `pydantic-core` CoreSchema generated. + """ + raise NotImplementedError + + def generate_schema(self, source_type: Any, /) -> core_schema.CoreSchema: + """Generate a schema unrelated to the current context. + Use this function if e.g. you are handling schema generation for a sequence + and want to generate a schema for its items. + Otherwise, you may end up doing something like applying a `min_length` constraint + that was intended for the sequence itself to its items! + + Args: + source_type: The input type. + + Returns: + CoreSchema: The `pydantic-core` CoreSchema generated. + """ + raise NotImplementedError + + def resolve_ref_schema(self, maybe_ref_schema: core_schema.CoreSchema, /) -> core_schema.CoreSchema: + """Get the real schema for a `definition-ref` schema. + If the schema given is not a `definition-ref` schema, it will be returned as is. + This means you don't have to check before calling this function. + + Args: + maybe_ref_schema: A `CoreSchema`, `ref`-based or not. + + Raises: + LookupError: If the `ref` is not found. + + Returns: + A concrete `CoreSchema`. + """ + raise NotImplementedError + + @property + def field_name(self) -> str | None: + """Get the name of the closest field to this validator.""" + raise NotImplementedError + + def _get_types_namespace(self) -> dict[str, Any] | None: + """Internal method used during type resolution for serializer annotations.""" + raise NotImplementedError diff --git a/env/Lib/site-packages/pydantic/class_validators.py b/env/Lib/site-packages/pydantic/class_validators.py new file mode 100644 index 0000000..9977150 --- /dev/null +++ b/env/Lib/site-packages/pydantic/class_validators.py @@ -0,0 +1,5 @@ +"""`class_validators` module is a backport module from V1.""" + +from ._migration import getattr_migration + +__getattr__ = getattr_migration(__name__) diff --git a/env/Lib/site-packages/pydantic/color.py b/env/Lib/site-packages/pydantic/color.py new file mode 100644 index 0000000..c702fc6 --- /dev/null +++ b/env/Lib/site-packages/pydantic/color.py @@ -0,0 +1,604 @@ +"""Color definitions are used as per the CSS3 +[CSS Color Module Level 3](http://www.w3.org/TR/css3-color/#svg-color) specification. + +A few colors have multiple names referring to the sames colors, eg. `grey` and `gray` or `aqua` and `cyan`. + +In these cases the _last_ color when sorted alphabetically takes preferences, +eg. `Color((0, 255, 255)).as_named() == 'cyan'` because "cyan" comes after "aqua". + +Warning: Deprecated + The `Color` class is deprecated, use `pydantic_extra_types` instead. + See [`pydantic-extra-types.Color`](../usage/types/extra_types/color_types.md) + for more information. +""" + +import math +import re +from colorsys import hls_to_rgb, rgb_to_hls +from typing import Any, Callable, Optional, Tuple, Type, Union, cast + +from pydantic_core import CoreSchema, PydanticCustomError, core_schema +from typing_extensions import deprecated + +from ._internal import _repr +from ._internal._schema_generation_shared import GetJsonSchemaHandler as _GetJsonSchemaHandler +from .json_schema import JsonSchemaValue +from .warnings import PydanticDeprecatedSince20 + +ColorTuple = Union[Tuple[int, int, int], Tuple[int, int, int, float]] +ColorType = Union[ColorTuple, str] +HslColorTuple = Union[Tuple[float, float, float], Tuple[float, float, float, float]] + + +class RGBA: + """Internal use only as a representation of a color.""" + + __slots__ = 'r', 'g', 'b', 'alpha', '_tuple' + + def __init__(self, r: float, g: float, b: float, alpha: Optional[float]): + self.r = r + self.g = g + self.b = b + self.alpha = alpha + + self._tuple: Tuple[float, float, float, Optional[float]] = (r, g, b, alpha) + + def __getitem__(self, item: Any) -> Any: + return self._tuple[item] + + +# these are not compiled here to avoid import slowdown, they'll be compiled the first time they're used, then cached +_r_255 = r'(\d{1,3}(?:\.\d+)?)' +_r_comma = r'\s*,\s*' +_r_alpha = r'(\d(?:\.\d+)?|\.\d+|\d{1,2}%)' +_r_h = r'(-?\d+(?:\.\d+)?|-?\.\d+)(deg|rad|turn)?' +_r_sl = r'(\d{1,3}(?:\.\d+)?)%' +r_hex_short = r'\s*(?:#|0x)?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?\s*' +r_hex_long = r'\s*(?:#|0x)?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?\s*' +# CSS3 RGB examples: rgb(0, 0, 0), rgba(0, 0, 0, 0.5), rgba(0, 0, 0, 50%) +r_rgb = rf'\s*rgba?\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}(?:{_r_comma}{_r_alpha})?\s*\)\s*' +# CSS3 HSL examples: hsl(270, 60%, 50%), hsla(270, 60%, 50%, 0.5), hsla(270, 60%, 50%, 50%) +r_hsl = rf'\s*hsla?\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}(?:{_r_comma}{_r_alpha})?\s*\)\s*' +# CSS4 RGB examples: rgb(0 0 0), rgb(0 0 0 / 0.5), rgb(0 0 0 / 50%), rgba(0 0 0 / 50%) +r_rgb_v4_style = rf'\s*rgba?\(\s*{_r_255}\s+{_r_255}\s+{_r_255}(?:\s*/\s*{_r_alpha})?\s*\)\s*' +# CSS4 HSL examples: hsl(270 60% 50%), hsl(270 60% 50% / 0.5), hsl(270 60% 50% / 50%), hsla(270 60% 50% / 50%) +r_hsl_v4_style = rf'\s*hsla?\(\s*{_r_h}\s+{_r_sl}\s+{_r_sl}(?:\s*/\s*{_r_alpha})?\s*\)\s*' + +# colors where the two hex characters are the same, if all colors match this the short version of hex colors can be used +repeat_colors = {int(c * 2, 16) for c in '0123456789abcdef'} +rads = 2 * math.pi + + +@deprecated( + 'The `Color` class is deprecated, use `pydantic_extra_types` instead. ' + 'See https://docs.pydantic.dev/latest/api/pydantic_extra_types_color/.', + category=PydanticDeprecatedSince20, +) +class Color(_repr.Representation): + """Represents a color.""" + + __slots__ = '_original', '_rgba' + + def __init__(self, value: ColorType) -> None: + self._rgba: RGBA + self._original: ColorType + if isinstance(value, (tuple, list)): + self._rgba = parse_tuple(value) + elif isinstance(value, str): + self._rgba = parse_str(value) + elif isinstance(value, Color): + self._rgba = value._rgba + value = value._original + else: + raise PydanticCustomError( + 'color_error', 'value is not a valid color: value must be a tuple, list or string' + ) + + # if we've got here value must be a valid color + self._original = value + + @classmethod + def __get_pydantic_json_schema__( + cls, core_schema: core_schema.CoreSchema, handler: _GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = {} + field_schema.update(type='string', format='color') + return field_schema + + def original(self) -> ColorType: + """Original value passed to `Color`.""" + return self._original + + def as_named(self, *, fallback: bool = False) -> str: + """Returns the name of the color if it can be found in `COLORS_BY_VALUE` dictionary, + otherwise returns the hexadecimal representation of the color or raises `ValueError`. + + Args: + fallback: If True, falls back to returning the hexadecimal representation of + the color instead of raising a ValueError when no named color is found. + + Returns: + The name of the color, or the hexadecimal representation of the color. + + Raises: + ValueError: When no named color is found and fallback is `False`. + """ + if self._rgba.alpha is None: + rgb = cast(Tuple[int, int, int], self.as_rgb_tuple()) + try: + return COLORS_BY_VALUE[rgb] + except KeyError as e: + if fallback: + return self.as_hex() + else: + raise ValueError('no named color found, use fallback=True, as_hex() or as_rgb()') from e + else: + return self.as_hex() + + def as_hex(self) -> str: + """Returns the hexadecimal representation of the color. + + Hex string representing the color can be 3, 4, 6, or 8 characters depending on whether the string + a "short" representation of the color is possible and whether there's an alpha channel. + + Returns: + The hexadecimal representation of the color. + """ + values = [float_to_255(c) for c in self._rgba[:3]] + if self._rgba.alpha is not None: + values.append(float_to_255(self._rgba.alpha)) + + as_hex = ''.join(f'{v:02x}' for v in values) + if all(c in repeat_colors for c in values): + as_hex = ''.join(as_hex[c] for c in range(0, len(as_hex), 2)) + return '#' + as_hex + + def as_rgb(self) -> str: + """Color as an `rgb(, , )` or `rgba(, , , )` string.""" + if self._rgba.alpha is None: + return f'rgb({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)})' + else: + return ( + f'rgba({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)}, ' + f'{round(self._alpha_float(), 2)})' + ) + + def as_rgb_tuple(self, *, alpha: Optional[bool] = None) -> ColorTuple: + """Returns the color as an RGB or RGBA tuple. + + Args: + alpha: Whether to include the alpha channel. There are three options for this input: + + - `None` (default): Include alpha only if it's set. (e.g. not `None`) + - `True`: Always include alpha. + - `False`: Always omit alpha. + + Returns: + A tuple that contains the values of the red, green, and blue channels in the range 0 to 255. + If alpha is included, it is in the range 0 to 1. + """ + r, g, b = (float_to_255(c) for c in self._rgba[:3]) + if alpha is None: + if self._rgba.alpha is None: + return r, g, b + else: + return r, g, b, self._alpha_float() + elif alpha: + return r, g, b, self._alpha_float() + else: + # alpha is False + return r, g, b + + def as_hsl(self) -> str: + """Color as an `hsl(, , )` or `hsl(, , , )` string.""" + if self._rgba.alpha is None: + h, s, li = self.as_hsl_tuple(alpha=False) # type: ignore + return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%})' + else: + h, s, li, a = self.as_hsl_tuple(alpha=True) # type: ignore + return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%}, {round(a, 2)})' + + def as_hsl_tuple(self, *, alpha: Optional[bool] = None) -> HslColorTuple: + """Returns the color as an HSL or HSLA tuple. + + Args: + alpha: Whether to include the alpha channel. + + - `None` (default): Include the alpha channel only if it's set (e.g. not `None`). + - `True`: Always include alpha. + - `False`: Always omit alpha. + + Returns: + The color as a tuple of hue, saturation, lightness, and alpha (if included). + All elements are in the range 0 to 1. + + Note: + This is HSL as used in HTML and most other places, not HLS as used in Python's `colorsys`. + """ + h, l, s = rgb_to_hls(self._rgba.r, self._rgba.g, self._rgba.b) # noqa: E741 + if alpha is None: + if self._rgba.alpha is None: + return h, s, l + else: + return h, s, l, self._alpha_float() + if alpha: + return h, s, l, self._alpha_float() + else: + # alpha is False + return h, s, l + + def _alpha_float(self) -> float: + return 1 if self._rgba.alpha is None else self._rgba.alpha + + @classmethod + def __get_pydantic_core_schema__( + cls, source: Type[Any], handler: Callable[[Any], CoreSchema] + ) -> core_schema.CoreSchema: + return core_schema.with_info_plain_validator_function( + cls._validate, serialization=core_schema.to_string_ser_schema() + ) + + @classmethod + def _validate(cls, __input_value: Any, _: Any) -> 'Color': + return cls(__input_value) + + def __str__(self) -> str: + return self.as_named(fallback=True) + + def __repr_args__(self) -> '_repr.ReprArgs': + return [(None, self.as_named(fallback=True))] + [('rgb', self.as_rgb_tuple())] + + def __eq__(self, other: Any) -> bool: + return isinstance(other, Color) and self.as_rgb_tuple() == other.as_rgb_tuple() + + def __hash__(self) -> int: + return hash(self.as_rgb_tuple()) + + +def parse_tuple(value: Tuple[Any, ...]) -> RGBA: + """Parse a tuple or list to get RGBA values. + + Args: + value: A tuple or list. + + Returns: + An `RGBA` tuple parsed from the input tuple. + + Raises: + PydanticCustomError: If tuple is not valid. + """ + if len(value) == 3: + r, g, b = (parse_color_value(v) for v in value) + return RGBA(r, g, b, None) + elif len(value) == 4: + r, g, b = (parse_color_value(v) for v in value[:3]) + return RGBA(r, g, b, parse_float_alpha(value[3])) + else: + raise PydanticCustomError('color_error', 'value is not a valid color: tuples must have length 3 or 4') + + +def parse_str(value: str) -> RGBA: + """Parse a string representing a color to an RGBA tuple. + + Possible formats for the input string include: + + * named color, see `COLORS_BY_NAME` + * hex short eg. `fff` (prefix can be `#`, `0x` or nothing) + * hex long eg. `ffffff` (prefix can be `#`, `0x` or nothing) + * `rgb(, , )` + * `rgba(, , , )` + + Args: + value: A string representing a color. + + Returns: + An `RGBA` tuple parsed from the input string. + + Raises: + ValueError: If the input string cannot be parsed to an RGBA tuple. + """ + value_lower = value.lower() + try: + r, g, b = COLORS_BY_NAME[value_lower] + except KeyError: + pass + else: + return ints_to_rgba(r, g, b, None) + + m = re.fullmatch(r_hex_short, value_lower) + if m: + *rgb, a = m.groups() + r, g, b = (int(v * 2, 16) for v in rgb) + if a: + alpha: Optional[float] = int(a * 2, 16) / 255 + else: + alpha = None + return ints_to_rgba(r, g, b, alpha) + + m = re.fullmatch(r_hex_long, value_lower) + if m: + *rgb, a = m.groups() + r, g, b = (int(v, 16) for v in rgb) + if a: + alpha = int(a, 16) / 255 + else: + alpha = None + return ints_to_rgba(r, g, b, alpha) + + m = re.fullmatch(r_rgb, value_lower) or re.fullmatch(r_rgb_v4_style, value_lower) + if m: + return ints_to_rgba(*m.groups()) # type: ignore + + m = re.fullmatch(r_hsl, value_lower) or re.fullmatch(r_hsl_v4_style, value_lower) + if m: + return parse_hsl(*m.groups()) # type: ignore + + raise PydanticCustomError('color_error', 'value is not a valid color: string not recognised as a valid color') + + +def ints_to_rgba(r: Union[int, str], g: Union[int, str], b: Union[int, str], alpha: Optional[float] = None) -> RGBA: + """Converts integer or string values for RGB color and an optional alpha value to an `RGBA` object. + + Args: + r: An integer or string representing the red color value. + g: An integer or string representing the green color value. + b: An integer or string representing the blue color value. + alpha: A float representing the alpha value. Defaults to None. + + Returns: + An instance of the `RGBA` class with the corresponding color and alpha values. + """ + return RGBA(parse_color_value(r), parse_color_value(g), parse_color_value(b), parse_float_alpha(alpha)) + + +def parse_color_value(value: Union[int, str], max_val: int = 255) -> float: + """Parse the color value provided and return a number between 0 and 1. + + Args: + value: An integer or string color value. + max_val: Maximum range value. Defaults to 255. + + Raises: + PydanticCustomError: If the value is not a valid color. + + Returns: + A number between 0 and 1. + """ + try: + color = float(value) + except ValueError: + raise PydanticCustomError('color_error', 'value is not a valid color: color values must be a valid number') + if 0 <= color <= max_val: + return color / max_val + else: + raise PydanticCustomError( + 'color_error', + 'value is not a valid color: color values must be in the range 0 to {max_val}', + {'max_val': max_val}, + ) + + +def parse_float_alpha(value: Union[None, str, float, int]) -> Optional[float]: + """Parse an alpha value checking it's a valid float in the range 0 to 1. + + Args: + value: The input value to parse. + + Returns: + The parsed value as a float, or `None` if the value was None or equal 1. + + Raises: + PydanticCustomError: If the input value cannot be successfully parsed as a float in the expected range. + """ + if value is None: + return None + try: + if isinstance(value, str) and value.endswith('%'): + alpha = float(value[:-1]) / 100 + else: + alpha = float(value) + except ValueError: + raise PydanticCustomError('color_error', 'value is not a valid color: alpha values must be a valid float') + + if math.isclose(alpha, 1): + return None + elif 0 <= alpha <= 1: + return alpha + else: + raise PydanticCustomError('color_error', 'value is not a valid color: alpha values must be in the range 0 to 1') + + +def parse_hsl(h: str, h_units: str, sat: str, light: str, alpha: Optional[float] = None) -> RGBA: + """Parse raw hue, saturation, lightness, and alpha values and convert to RGBA. + + Args: + h: The hue value. + h_units: The unit for hue value. + sat: The saturation value. + light: The lightness value. + alpha: Alpha value. + + Returns: + An instance of `RGBA`. + """ + s_value, l_value = parse_color_value(sat, 100), parse_color_value(light, 100) + + h_value = float(h) + if h_units in {None, 'deg'}: + h_value = h_value % 360 / 360 + elif h_units == 'rad': + h_value = h_value % rads / rads + else: + # turns + h_value = h_value % 1 + + r, g, b = hls_to_rgb(h_value, l_value, s_value) + return RGBA(r, g, b, parse_float_alpha(alpha)) + + +def float_to_255(c: float) -> int: + """Converts a float value between 0 and 1 (inclusive) to an integer between 0 and 255 (inclusive). + + Args: + c: The float value to be converted. Must be between 0 and 1 (inclusive). + + Returns: + The integer equivalent of the given float value rounded to the nearest whole number. + + Raises: + ValueError: If the given float value is outside the acceptable range of 0 to 1 (inclusive). + """ + return int(round(c * 255)) + + +COLORS_BY_NAME = { + 'aliceblue': (240, 248, 255), + 'antiquewhite': (250, 235, 215), + 'aqua': (0, 255, 255), + 'aquamarine': (127, 255, 212), + 'azure': (240, 255, 255), + 'beige': (245, 245, 220), + 'bisque': (255, 228, 196), + 'black': (0, 0, 0), + 'blanchedalmond': (255, 235, 205), + 'blue': (0, 0, 255), + 'blueviolet': (138, 43, 226), + 'brown': (165, 42, 42), + 'burlywood': (222, 184, 135), + 'cadetblue': (95, 158, 160), + 'chartreuse': (127, 255, 0), + 'chocolate': (210, 105, 30), + 'coral': (255, 127, 80), + 'cornflowerblue': (100, 149, 237), + 'cornsilk': (255, 248, 220), + 'crimson': (220, 20, 60), + 'cyan': (0, 255, 255), + 'darkblue': (0, 0, 139), + 'darkcyan': (0, 139, 139), + 'darkgoldenrod': (184, 134, 11), + 'darkgray': (169, 169, 169), + 'darkgreen': (0, 100, 0), + 'darkgrey': (169, 169, 169), + 'darkkhaki': (189, 183, 107), + 'darkmagenta': (139, 0, 139), + 'darkolivegreen': (85, 107, 47), + 'darkorange': (255, 140, 0), + 'darkorchid': (153, 50, 204), + 'darkred': (139, 0, 0), + 'darksalmon': (233, 150, 122), + 'darkseagreen': (143, 188, 143), + 'darkslateblue': (72, 61, 139), + 'darkslategray': (47, 79, 79), + 'darkslategrey': (47, 79, 79), + 'darkturquoise': (0, 206, 209), + 'darkviolet': (148, 0, 211), + 'deeppink': (255, 20, 147), + 'deepskyblue': (0, 191, 255), + 'dimgray': (105, 105, 105), + 'dimgrey': (105, 105, 105), + 'dodgerblue': (30, 144, 255), + 'firebrick': (178, 34, 34), + 'floralwhite': (255, 250, 240), + 'forestgreen': (34, 139, 34), + 'fuchsia': (255, 0, 255), + 'gainsboro': (220, 220, 220), + 'ghostwhite': (248, 248, 255), + 'gold': (255, 215, 0), + 'goldenrod': (218, 165, 32), + 'gray': (128, 128, 128), + 'green': (0, 128, 0), + 'greenyellow': (173, 255, 47), + 'grey': (128, 128, 128), + 'honeydew': (240, 255, 240), + 'hotpink': (255, 105, 180), + 'indianred': (205, 92, 92), + 'indigo': (75, 0, 130), + 'ivory': (255, 255, 240), + 'khaki': (240, 230, 140), + 'lavender': (230, 230, 250), + 'lavenderblush': (255, 240, 245), + 'lawngreen': (124, 252, 0), + 'lemonchiffon': (255, 250, 205), + 'lightblue': (173, 216, 230), + 'lightcoral': (240, 128, 128), + 'lightcyan': (224, 255, 255), + 'lightgoldenrodyellow': (250, 250, 210), + 'lightgray': (211, 211, 211), + 'lightgreen': (144, 238, 144), + 'lightgrey': (211, 211, 211), + 'lightpink': (255, 182, 193), + 'lightsalmon': (255, 160, 122), + 'lightseagreen': (32, 178, 170), + 'lightskyblue': (135, 206, 250), + 'lightslategray': (119, 136, 153), + 'lightslategrey': (119, 136, 153), + 'lightsteelblue': (176, 196, 222), + 'lightyellow': (255, 255, 224), + 'lime': (0, 255, 0), + 'limegreen': (50, 205, 50), + 'linen': (250, 240, 230), + 'magenta': (255, 0, 255), + 'maroon': (128, 0, 0), + 'mediumaquamarine': (102, 205, 170), + 'mediumblue': (0, 0, 205), + 'mediumorchid': (186, 85, 211), + 'mediumpurple': (147, 112, 219), + 'mediumseagreen': (60, 179, 113), + 'mediumslateblue': (123, 104, 238), + 'mediumspringgreen': (0, 250, 154), + 'mediumturquoise': (72, 209, 204), + 'mediumvioletred': (199, 21, 133), + 'midnightblue': (25, 25, 112), + 'mintcream': (245, 255, 250), + 'mistyrose': (255, 228, 225), + 'moccasin': (255, 228, 181), + 'navajowhite': (255, 222, 173), + 'navy': (0, 0, 128), + 'oldlace': (253, 245, 230), + 'olive': (128, 128, 0), + 'olivedrab': (107, 142, 35), + 'orange': (255, 165, 0), + 'orangered': (255, 69, 0), + 'orchid': (218, 112, 214), + 'palegoldenrod': (238, 232, 170), + 'palegreen': (152, 251, 152), + 'paleturquoise': (175, 238, 238), + 'palevioletred': (219, 112, 147), + 'papayawhip': (255, 239, 213), + 'peachpuff': (255, 218, 185), + 'peru': (205, 133, 63), + 'pink': (255, 192, 203), + 'plum': (221, 160, 221), + 'powderblue': (176, 224, 230), + 'purple': (128, 0, 128), + 'red': (255, 0, 0), + 'rosybrown': (188, 143, 143), + 'royalblue': (65, 105, 225), + 'saddlebrown': (139, 69, 19), + 'salmon': (250, 128, 114), + 'sandybrown': (244, 164, 96), + 'seagreen': (46, 139, 87), + 'seashell': (255, 245, 238), + 'sienna': (160, 82, 45), + 'silver': (192, 192, 192), + 'skyblue': (135, 206, 235), + 'slateblue': (106, 90, 205), + 'slategray': (112, 128, 144), + 'slategrey': (112, 128, 144), + 'snow': (255, 250, 250), + 'springgreen': (0, 255, 127), + 'steelblue': (70, 130, 180), + 'tan': (210, 180, 140), + 'teal': (0, 128, 128), + 'thistle': (216, 191, 216), + 'tomato': (255, 99, 71), + 'turquoise': (64, 224, 208), + 'violet': (238, 130, 238), + 'wheat': (245, 222, 179), + 'white': (255, 255, 255), + 'whitesmoke': (245, 245, 245), + 'yellow': (255, 255, 0), + 'yellowgreen': (154, 205, 50), +} + +COLORS_BY_VALUE = {v: k for k, v in COLORS_BY_NAME.items()} diff --git a/env/Lib/site-packages/pydantic/dataclasses.py b/env/Lib/site-packages/pydantic/dataclasses.py new file mode 100644 index 0000000..acfd3d5 --- /dev/null +++ b/env/Lib/site-packages/pydantic/dataclasses.py @@ -0,0 +1,338 @@ +"""Provide an enhanced dataclass that performs validation.""" + +from __future__ import annotations as _annotations + +import dataclasses +import sys +import types +from typing import TYPE_CHECKING, Any, Callable, Generic, NoReturn, TypeVar, overload + +from typing_extensions import Literal, TypeGuard, dataclass_transform + +from ._internal import _config, _decorators, _typing_extra +from ._internal import _dataclasses as _pydantic_dataclasses +from ._migration import getattr_migration +from .config import ConfigDict +from .errors import PydanticUserError +from .fields import Field, FieldInfo, PrivateAttr + +if TYPE_CHECKING: + from ._internal._dataclasses import PydanticDataclass + +__all__ = 'dataclass', 'rebuild_dataclass' + +_T = TypeVar('_T') + +if sys.version_info >= (3, 10): + + @dataclass_transform(field_specifiers=(dataclasses.field, Field, PrivateAttr)) + @overload + def dataclass( + *, + init: Literal[False] = False, + repr: bool = True, + eq: bool = True, + order: bool = False, + unsafe_hash: bool = False, + frozen: bool = False, + config: ConfigDict | type[object] | None = None, + validate_on_init: bool | None = None, + kw_only: bool = ..., + slots: bool = ..., + ) -> Callable[[type[_T]], type[PydanticDataclass]]: # type: ignore + ... + + @dataclass_transform(field_specifiers=(dataclasses.field, Field, PrivateAttr)) + @overload + def dataclass( + _cls: type[_T], # type: ignore + *, + init: Literal[False] = False, + repr: bool = True, + eq: bool = True, + order: bool = False, + unsafe_hash: bool = False, + frozen: bool = False, + config: ConfigDict | type[object] | None = None, + validate_on_init: bool | None = None, + kw_only: bool = ..., + slots: bool = ..., + ) -> type[PydanticDataclass]: ... + +else: + + @dataclass_transform(field_specifiers=(dataclasses.field, Field, PrivateAttr)) + @overload + def dataclass( + *, + init: Literal[False] = False, + repr: bool = True, + eq: bool = True, + order: bool = False, + unsafe_hash: bool = False, + frozen: bool = False, + config: ConfigDict | type[object] | None = None, + validate_on_init: bool | None = None, + ) -> Callable[[type[_T]], type[PydanticDataclass]]: # type: ignore + ... + + @dataclass_transform(field_specifiers=(dataclasses.field, Field, PrivateAttr)) + @overload + def dataclass( + _cls: type[_T], # type: ignore + *, + init: Literal[False] = False, + repr: bool = True, + eq: bool = True, + order: bool = False, + unsafe_hash: bool = False, + frozen: bool = False, + config: ConfigDict | type[object] | None = None, + validate_on_init: bool | None = None, + ) -> type[PydanticDataclass]: ... + + +@dataclass_transform(field_specifiers=(dataclasses.field, Field, PrivateAttr)) +def dataclass( # noqa: C901 + _cls: type[_T] | None = None, + *, + init: Literal[False] = False, + repr: bool = True, + eq: bool = True, + order: bool = False, + unsafe_hash: bool = False, + frozen: bool = False, + config: ConfigDict | type[object] | None = None, + validate_on_init: bool | None = None, + kw_only: bool = False, + slots: bool = False, +) -> Callable[[type[_T]], type[PydanticDataclass]] | type[PydanticDataclass]: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/dataclasses/ + + A decorator used to create a Pydantic-enhanced dataclass, similar to the standard Python `dataclass`, + but with added validation. + + This function should be used similarly to `dataclasses.dataclass`. + + Args: + _cls: The target `dataclass`. + init: Included for signature compatibility with `dataclasses.dataclass`, and is passed through to + `dataclasses.dataclass` when appropriate. If specified, must be set to `False`, as pydantic inserts its + own `__init__` function. + repr: A boolean indicating whether to include the field in the `__repr__` output. + eq: Determines if a `__eq__` method should be generated for the class. + order: Determines if comparison magic methods should be generated, such as `__lt__`, but not `__eq__`. + unsafe_hash: Determines if a `__hash__` method should be included in the class, as in `dataclasses.dataclass`. + frozen: Determines if the generated class should be a 'frozen' `dataclass`, which does not allow its + attributes to be modified after it has been initialized. + config: The Pydantic config to use for the `dataclass`. + validate_on_init: A deprecated parameter included for backwards compatibility; in V2, all Pydantic dataclasses + are validated on init. + kw_only: Determines if `__init__` method parameters must be specified by keyword only. Defaults to `False`. + slots: Determines if the generated class should be a 'slots' `dataclass`, which does not allow the addition of + new attributes after instantiation. + + Returns: + A decorator that accepts a class as its argument and returns a Pydantic `dataclass`. + + Raises: + AssertionError: Raised if `init` is not `False` or `validate_on_init` is `False`. + """ + assert init is False, 'pydantic.dataclasses.dataclass only supports init=False' + assert validate_on_init is not False, 'validate_on_init=False is no longer supported' + + if sys.version_info >= (3, 10): + kwargs = dict(kw_only=kw_only, slots=slots) + else: + kwargs = {} + + def make_pydantic_fields_compatible(cls: type[Any]) -> None: + """Make sure that stdlib `dataclasses` understands `Field` kwargs like `kw_only` + To do that, we simply change + `x: int = pydantic.Field(..., kw_only=True)` + into + `x: int = dataclasses.field(default=pydantic.Field(..., kw_only=True), kw_only=True)` + """ + for annotation_cls in cls.__mro__: + # In Python < 3.9, `__annotations__` might not be present if there are no fields. + # we therefore need to use `getattr` to avoid an `AttributeError`. + annotations = getattr(annotation_cls, '__annotations__', []) + for field_name in annotations: + field_value = getattr(cls, field_name, None) + # Process only if this is an instance of `FieldInfo`. + if not isinstance(field_value, FieldInfo): + continue + + # Initialize arguments for the standard `dataclasses.field`. + field_args: dict = {'default': field_value} + + # Handle `kw_only` for Python 3.10+ + if sys.version_info >= (3, 10) and field_value.kw_only: + field_args['kw_only'] = True + + # Set `repr` attribute if it's explicitly specified to be not `True`. + if field_value.repr is not True: + field_args['repr'] = field_value.repr + + setattr(cls, field_name, dataclasses.field(**field_args)) + # In Python 3.8, dataclasses checks cls.__dict__['__annotations__'] for annotations, + # so we must make sure it's initialized before we add to it. + if cls.__dict__.get('__annotations__') is None: + cls.__annotations__ = {} + cls.__annotations__[field_name] = annotations[field_name] + + def create_dataclass(cls: type[Any]) -> type[PydanticDataclass]: + """Create a Pydantic dataclass from a regular dataclass. + + Args: + cls: The class to create the Pydantic dataclass from. + + Returns: + A Pydantic dataclass. + """ + from ._internal._utils import is_model_class + + if is_model_class(cls): + raise PydanticUserError( + f'Cannot create a Pydantic dataclass from {cls.__name__} as it is already a Pydantic model', + code='dataclass-on-model', + ) + + original_cls = cls + + config_dict = config + if config_dict is None: + # if not explicitly provided, read from the type + cls_config = getattr(cls, '__pydantic_config__', None) + if cls_config is not None: + config_dict = cls_config + config_wrapper = _config.ConfigWrapper(config_dict) + decorators = _decorators.DecoratorInfos.build(cls) + + # Keep track of the original __doc__ so that we can restore it after applying the dataclasses decorator + # Otherwise, classes with no __doc__ will have their signature added into the JSON schema description, + # since dataclasses.dataclass will set this as the __doc__ + original_doc = cls.__doc__ + + if _pydantic_dataclasses.is_builtin_dataclass(cls): + # Don't preserve the docstring for vanilla dataclasses, as it may include the signature + # This matches v1 behavior, and there was an explicit test for it + original_doc = None + + # We don't want to add validation to the existing std lib dataclass, so we will subclass it + # If the class is generic, we need to make sure the subclass also inherits from Generic + # with all the same parameters. + bases = (cls,) + if issubclass(cls, Generic): + generic_base = Generic[cls.__parameters__] # type: ignore + bases = bases + (generic_base,) + cls = types.new_class(cls.__name__, bases) + + make_pydantic_fields_compatible(cls) + + cls = dataclasses.dataclass( # type: ignore[call-overload] + cls, + # the value of init here doesn't affect anything except that it makes it easier to generate a signature + init=True, + repr=repr, + eq=eq, + order=order, + unsafe_hash=unsafe_hash, + frozen=frozen, + **kwargs, + ) + + cls.__pydantic_decorators__ = decorators # type: ignore + cls.__doc__ = original_doc + cls.__module__ = original_cls.__module__ + cls.__qualname__ = original_cls.__qualname__ + pydantic_complete = _pydantic_dataclasses.complete_dataclass( + cls, config_wrapper, raise_errors=False, types_namespace=None + ) + cls.__pydantic_complete__ = pydantic_complete # type: ignore + return cls + + if _cls is None: + return create_dataclass + + return create_dataclass(_cls) + + +__getattr__ = getattr_migration(__name__) + +if (3, 8) <= sys.version_info < (3, 11): + # Monkeypatch dataclasses.InitVar so that typing doesn't error if it occurs as a type when evaluating type hints + # Starting in 3.11, typing.get_type_hints will not raise an error if the retrieved type hints are not callable. + + def _call_initvar(*args: Any, **kwargs: Any) -> NoReturn: + """This function does nothing but raise an error that is as similar as possible to what you'd get + if you were to try calling `InitVar[int]()` without this monkeypatch. The whole purpose is just + to ensure typing._type_check does not error if the type hint evaluates to `InitVar[]`. + """ + raise TypeError("'InitVar' object is not callable") + + dataclasses.InitVar.__call__ = _call_initvar + + +def rebuild_dataclass( + cls: type[PydanticDataclass], + *, + force: bool = False, + raise_errors: bool = True, + _parent_namespace_depth: int = 2, + _types_namespace: dict[str, Any] | None = None, +) -> bool | None: + """Try to rebuild the pydantic-core schema for the dataclass. + + This may be necessary when one of the annotations is a ForwardRef which could not be resolved during + the initial attempt to build the schema, and automatic rebuilding fails. + + This is analogous to `BaseModel.model_rebuild`. + + Args: + cls: The class to rebuild the pydantic-core schema for. + force: Whether to force the rebuilding of the schema, defaults to `False`. + raise_errors: Whether to raise errors, defaults to `True`. + _parent_namespace_depth: The depth level of the parent namespace, defaults to 2. + _types_namespace: The types namespace, defaults to `None`. + + Returns: + Returns `None` if the schema is already "complete" and rebuilding was not required. + If rebuilding _was_ required, returns `True` if rebuilding was successful, otherwise `False`. + """ + if not force and cls.__pydantic_complete__: + return None + else: + if _types_namespace is not None: + types_namespace: dict[str, Any] | None = _types_namespace.copy() + else: + if _parent_namespace_depth > 0: + frame_parent_ns = _typing_extra.parent_frame_namespace(parent_depth=_parent_namespace_depth) or {} + # Note: we may need to add something similar to cls.__pydantic_parent_namespace__ from BaseModel + # here when implementing handling of recursive generics. See BaseModel.model_rebuild for reference. + types_namespace = frame_parent_ns + else: + types_namespace = {} + + types_namespace = _typing_extra.get_cls_types_namespace(cls, types_namespace) + return _pydantic_dataclasses.complete_dataclass( + cls, + _config.ConfigWrapper(cls.__pydantic_config__, check=False), + raise_errors=raise_errors, + types_namespace=types_namespace, + ) + + +def is_pydantic_dataclass(class_: type[Any], /) -> TypeGuard[type[PydanticDataclass]]: + """Whether a class is a pydantic dataclass. + + Args: + class_: The class. + + Returns: + `True` if the class is a pydantic dataclass, `False` otherwise. + """ + try: + return '__pydantic_validator__' in class_.__dict__ and dataclasses.is_dataclass(class_) + except AttributeError: + return False diff --git a/env/Lib/site-packages/pydantic/datetime_parse.py b/env/Lib/site-packages/pydantic/datetime_parse.py new file mode 100644 index 0000000..53d5264 --- /dev/null +++ b/env/Lib/site-packages/pydantic/datetime_parse.py @@ -0,0 +1,5 @@ +"""The `datetime_parse` module is a backport module from V1.""" + +from ._migration import getattr_migration + +__getattr__ = getattr_migration(__name__) diff --git a/env/Lib/site-packages/pydantic/decorator.py b/env/Lib/site-packages/pydantic/decorator.py new file mode 100644 index 0000000..0d97560 --- /dev/null +++ b/env/Lib/site-packages/pydantic/decorator.py @@ -0,0 +1,5 @@ +"""The `decorator` module is a backport module from V1.""" + +from ._migration import getattr_migration + +__getattr__ = getattr_migration(__name__) diff --git a/env/Lib/site-packages/pydantic/deprecated/__init__.py b/env/Lib/site-packages/pydantic/deprecated/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/pydantic/deprecated/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/pydantic/deprecated/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6f2f20da8ac12c859ceaa174e54119a331790de1 GIT binary patch literal 189 zcmZ3^%ge<81Y2jHNdwW3K?DpiLK&agfQ;!3DGb33nv8xc8H$*I{LdiCUjZ&wG2!_| z*)h)fDVcfcG1;X>i6!|(@k#k5F{ycFF+Q0|F~ylBsk#M;$=QkNsl_n`l_`mNC7H?k zDX9fTsmX~YsVVyL@tJv!bM`UN literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/deprecated/__pycache__/class_validators.cpython-311.pyc b/env/Lib/site-packages/pydantic/deprecated/__pycache__/class_validators.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..53b45f82f721f9643f7a1ceddd8deda19742435c GIT binary patch literal 12882 zcmd5iTWlLwb~AhqNlDbhmL*x1#&6M)7|V9z-S`nHmYn#V^)sgJQX|f#Onb=D-k~f@ zRkmtjz;e(Q`Dl=!O$(zy-54kyHXSq z12EEd=oPC}r9BSp9>BgwBKVi~R_n0TQX=ooy3CYB!0iJ%?cek3gE$&18TK z)zJ2RhUs;#16DQk$OjyNAHNcNa~{&07>2f;>K3){N&h1c;NizFRc3#E0JnbcR}ZW4 zdx1xQ`mxeLNbDm~^?h~k_o8}4Jy3_;Z)1SUp&eWvlwds;m0t_g-~GJyhRM z?YkhvM(2;6(^Pq4$vtd`8i%=5irR@;7xA8a5p-k9Kixn#2ND^Tn&5k0+0PHh%2X ziL;+t-qGBgB^^^VO_|h)6~tDT6>9k}hF+ku((K4B`KZamJO@L@sPYT4CA(aKBp?Vd?t0t zAatBkokC@IrE<(3?m{M)BK!8v|7rqOtIsAWnK8(OoH69;l#HUY8BLQXiJY0r>6EC4 zRZt62Y{hTgqdTxqP#OFwg7=}XUQnvI!p)70S>rQz1RvHB_4Qw*ajtVVnq#0Pc+EJ-Hk zcdoUcc%>N)NLv3(zc?FeK9T@|nq3PvvgJ~6_gG-A4M-Vytx;AdZ}iA6{aGO>_AEW%cQ z^761P4_7kzn@mECs$}eVM+1j&?0RR@vV5?A#!8EtN#(B@c{(VAQr}>tOZn^#G!z=T z1@MesF(2*6@*V{5As7T;V1JMvnNt#}J3sJ_b=iDoGPn(gLSCGWNqlg|VKxIR;WTsz zfz4~W10QR+h^H4tfUK$G;uogmx;YoI`Oo0u&c-`DHH$i5<>j7rHFI!uaGf0(LmB<6 zgt65hRlkAy*K=|h8q$3TR^w!RUF)&=iJC)Q{A5!wF0y%k50sgKRqMSZtTT*Y3D=G2-E zT0@QHvA$)M9}X>HTSsBCRRzjSRaR$9+2|dDhI}N(n+8U2c)d%rxx^Uc;F3hyEHyf^ zUVeRqD@1@MxQ<^}P04k0eqr-<@k>$z>9on*S9LF$`NpW zR_mWc$6cVWMVPIth0W1nH zhYvjMV1z{9gpJF1hlA5m1So5~)ablAidY1QGzI`vy^fN{6Z)VetO7XqSpQb&1`PR} zd-uSIbMyjw{i(8}*$P{-`Gih5IHon!cl!S;k1K99#1gWRpVNptAOZexo*S}4iNmpu z%UAW8iWi;DOo8u6N!GBV>PmPC0+@Su3f7o z_l-fht}2CsikBaL=%0f;iLa-j_P*!7_rC9b;J);&kgv3Y2CA5MoFuB}iPs%Fi^76m z_051^?Ch2ILD%x-?C*}4MIn#!T)q~BDe*zzZ^iS%Bbfh3dktR&@}Wu_L3j{Q{nbc6 zU(WC#-aR&L%QshhsR1?kL~^(I6EPokvB zo4=COjwSDsZ^^S1Sd!9ywf$bxm%#-zW*e0M03wa?=o4g)MQ4T#LWd&AVi`G;1HTzm zDmMj{N**zD6+wp}5n@ag1-+~pAgCzaMm!vb(_0<|H{v5!!l$yh$pav6v5(}7Fh@E= zjXdwe=Cl>eF$D%sFo~W!1Wh2Eh1(zy$Aj?OL*wu)2Qb0spTISdoG}9$qvT|QVKa85 zN(L94Ny~Gfud1HgotLK}WRqcM8c|>^Alq?!*gbr-%8Ex-HG?SyMdM2zFks4c5OK4;t+D?}0ycmf2O|%e5rwMuI&u4US3@2kngRPxLmna) zm&Zt2nbGnFlH|AonCgmbbJ1X3$AMxgJv*(DyRtrci=<$L0fXd?L0QWf@IdmZcubzH zEWauPu4SS8+{vgAg33fAS(1aEz&gHTU=5UD3>_>jpJdJTa+}s*u`VKVIcB*IolWE* zO*zp4l3Nxla);zV9$ah2H9?;l$dMRei46m!f6a9{Z7g41*-SR(v@Wv_uy?LdT$(@# zQ+c41HYbz2K;eoWLMTtPD$kJDPL`rIu3{bbeJwKSa-KpSgVBiTghNZxP_ChyOi7wh zl%P5~m2+31RF%A3LrSrJ=UJx4VG$}P$4Bxg9Bkzz7$-{#WW!-!D$~e{YXy}#QMN0s z6(D3)8#rm`aWJ#A9l&GJ3WNTnZfn4K?IOjKW&V#`X~(LJFzYr8c?z3DkdeGi=4N%O zf(I})!{m7o@@9E?5pTDLRk71=oS;K5{M#--@E}r#+Yx zV*wasAj27ua5O3@LeIjuQ00m5wfuY?NTG6uV_wsei9@Q;bx6ol@*Mq==-~;~y?*rcx-y>-KW3`9J zHKXlbEeH#q1@VdB?Yw~-5;!}*&&71meWp=xhD}dv8DKZ4cSS-gZpwVOlRaE|hq&pd zmtl!9KRpNkEFap>8dnxo%ea}zLe33{E?Ap0MzS(~l8=!@cOq$kE01YWYbSRmAU6&2 zS8g$>fFvgM9Jb0Skc1|51GeqYDz`}z6@_L}ki_R+cGcszIxkn^h_Q;%JCRH4)}~d& z1(um)TbZTGwAE?vJBiQJgu>dvH?SRbzFFKnodjSYU*XVL#ET^=EiYJ=`RX`T1%~>s zu*=r~e!nQZh;$Yr`<@OjM?NS-AR_aIT3)noFSd@Er_v>_r=#VS0N@P*2-lih-bzAq zSE1?1GiAAHq|h|7B)*7lDMXJf`Ce=tENnei?C37GZ7g>7W1)LzDH7NgekA~SgTR#f z-nIy>n+s8x(){qWdEtr~{bD)#MInmGOJ*J*4~wLz>KmPaM<5V-+E#nzbqF|VSKxIF zm<5RVMo*tUcO`j#{L+Q-!3!|ToTmJkEcsTSbj)}6(x$T8xG!~*~ zumav^7HmB&X0gEA%u@AKI_joM|Z$A?Se+Yx! z18)ODXmhb+15m^t0E+knKoNhS#6YVcb$qRw!5+9@NKLI|Oh33O0!EX<66$W^((Ez0;;lROX zJDwhTdg$TZhj*WUx;R$yMg3RBlJK+OHlZoHc#`ox9upbmt*CK3GmVOuhEN#PZl$^W z&h6SoIzw)(9IyBlEFyJfPn_XCk4{%d+sPq30nvzp@pQgYa^x>Plmecu&cN2?^U`Xe zu9uhe4&eRql7KPFV!53WI&vy5dW@AFhpMVPd1jMkUM_e01Z_{tB@K}d*fWT^lVyaY%30zU|O60Y+SAPZc%@=cWzcnps7`$@#z z>#Km;w&Y(5q&;dYBo%xMJ~++WmA4?1<%7+YR8Sy;1)5)Lb}%UP$`Z9_wZYR7L3@?$zg~f&MqCe!#uKjSAV}T5~@_QP&@^71jrjBop7CJ_rr_9L7<;clG zer z1W{*xsnGzR=XmBOuZoxW>~q+E?UBkY+3HwJR;pPOleGi*R!!AY{41>V3}ywANs4YW ze2V4xD$xqD+$FpXFt`+=Zb3K-FDVTciCO_DgUdouqIkTEP8v=u=c_6mV!!_f|JGPt>5d5ZvhO=57(=)|^6QSgHz z_GJwlYyZ-*Wx}bZATyjSdk9HK?z^k9i@K> zk9bHKN5PGx2j6(Z9f8GDr7mGp zZ&BLH@Ntl`(B3y*@20@wxl&jd9Dcg_*@frZpBv9^6oyaz%XKqx!%R+^iOIs5lu4** z+$oS*b9lD!-d)qT#q-U? z6jxVK-cjt@Qi`4s#b`-r3|}?d9h+E-FFb-L45_8=-clqa21`Occ;$sA_qs|RM0Nd) o<}EmSa~Maj2lnWQ>UqazTXD0!TXCDA1Gvk2;M}1L%k0bl0DBEUVE_OC literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/deprecated/__pycache__/config.cpython-311.pyc b/env/Lib/site-packages/pydantic/deprecated/__pycache__/config.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..61cbcdf63d85f5b158c2c16920d43cc98c0797be GIT binary patch literal 4855 zcmb7HTWl2989sB{n|HnI^)1}uu`yjQN!A9^7||q(F*fD4MKvjSF&f4@W3y&2?wMJP zS0=Jj)KH05RBePRibSQ9g5V(!=}Y@Wo~vpcZ4_%HOO~oWET!CZ`JrQ5^et$zZm80CN-PQnW~w}WsP{0w*wc(&yOg>KOPxA zb1Ht)7KXC(Q0qRMGIgq^ZJ(ykQa!1fy7n!u4m7xxWG*|EnuhGI^YfaTHB-qG)m~$% zY*Ifw06KifRYMTOn6t)44}nH3*4?s zmfYe^R8vkf)iZ7wDOTD|hDxW@c=8-sfc@T2On;>>A-#mkw*)g-tI@axGUKU~9{^ex zga_oI_!#E)tTsR4V_qY-gpY(dZjRg(#>pHP72<_}IX|n*xyczlY08m8Yec@L8ge!# ztENd)lX+8@qh9I-^>)xXD@D_%)O^}BY|orZv#IPfY$WFF))OP=e>yTebm7!b;>x*^ zv9Y0(BX+oQo`8~zPJi2TMxP&{G)L{`p~`2RvPV&}YDQO-sA!9Zo}Qw(Qd@ut+Jb&F zY2dcWkiLtbI5u%HN3Tx|=QNnZ#PvK?%^X!GbLNDey)kh%H929x`Mx!)Ca1*vekX*^R_Sc!3&?U zpE;SO@OUviZYh(NfAS@yl7K@YW3mUhz9Yu3Rv_i&+fmp2mO1w+L zHT*A0dn*bGAJmLjP8o7-_ha&hhAx}ebopxKY+{ayo=7Flt8yx9n7XRPfE_$Y8`C*D z-(dG;%i`7t;A5ZETRsO?@4G{$IL&q2pAfYsmiIzlxZun#$^$Je8yJBmfBTtwE<;W)|pfGL=r5^D&riuiX&@1Mt>wEpSRXP1^bV#SWw=fhTLup~h{avY?R z8@>i_;~-4@7elTgA9>;P9ghev+V>6(@-Gf?m>=vr-X(q6B^>V&zU+~p#&)5RqA!Z) zvU;)}%D7`->fHKAkU=A;H-VZ9H$`YJr#h!y2kS<#aS(TyNFn9aXiPKZkdi2$H<(AP&smOP_H`YT@LpBI{&M=yK}{0pA|d|&y#nY zx8*tPFuDxm!JV*4;J!Le2K@sp37rh>M$rQTqB}*)CBX_1qZB7-2g*23>glwiJms8) z;9-5>z!~?G@iM~R&_Td#E5DK`N}duy;rB^^s-47ZymSOG_x}rLarkj?Hr`AnLfqcl z$k469+qjr_k-)nM%)5wi&~EUyEK|&4raiDz;wm;q?yxO*sz^ADk!N2jm-SIjv z2msw`Q;XGp*lNOu1$E1znUzq_@}9jVw-{(%BOo?V03ZX+|M8JfJDScn!N^y^$P?F6 zu)i4Ww>gQ68oHIN$lHF;j}p4K+VxM z4AZCba2tg%oid~I*UyiE-*!R70M{Oh_RC^?yTz$dz<~6ufp>C>E{LM-L;R4+g4Jc! zv=fNnos$J3NYY?y@TE7f3L_>)zYJ>5=I_V4UKF?o-+A73?hxkuyqsJ7^|bg|+7mR=tL88z|NU!kb)m z%z&2zW85n4wXI?8My=^J_TgpmtaWj=B=9`HMnG(!D7geKimTf!?#-~;HEh~IvF6@k I3_G;{0%Z$oA^-pY literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/deprecated/__pycache__/copy_internals.cpython-311.pyc b/env/Lib/site-packages/pydantic/deprecated/__pycache__/copy_internals.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1ddc4ed23eca5124b7e4c9f1b908ac025c99e134 GIT binary patch literal 9643 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/deprecated/__pycache__/json.cpython-311.pyc b/env/Lib/site-packages/pydantic/deprecated/__pycache__/json.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..87ad4d3e1b44db7a37a15092de21e0a9fc320ddd GIT binary patch literal 6759 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 NnGmY8w+?Yv{=djmgX#bP literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/deprecated/__pycache__/parse.cpython-311.pyc b/env/Lib/site-packages/pydantic/deprecated/__pycache__/parse.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..028530010d65c2310c31bf08c4e47bb7d9d71f72 GIT binary patch literal 3657 zcmbtX-EZ606~FwDM2Y&a72Am&$CjP6joQU2<~VWFIzVbW^}5D$>U?a91BDjpR5nFw zm$XxR6d)9Na0deoh6FLt70AQpHA{fyWkCOk0iz5RB?uTWFyx_cDzd%!Y3E+*BaBmE zLoY9n4$r+j_v`$AJo-y47C}({{^dUw{uxH-U*w@tLY~4rPcaBRKr)gU6&08a!w{WS z*$hj6xeP~t`3w)goEj(uGeO#iS3?CMBTzk{h6|BQq#$O*LNpVlwxAj-#4~ZwL$aXq zg+wO7ASGh3N+Q$7q7RT9zJuh5(yj!zc!VCq?UhWDMM_*2W%fyQi-i`ry&|)64DPtX zE*@yw5`PTHN9Ddd!7VU7ZkSP~gL>)zKfD~12lsjDl-XI7e(ihWH_f=Bq-nY-nR#6^ zrs0{N)Rqh6cSbTlNpo)O@^5A)v*S~fB`2AR z{5@F~n7U_HWl1yhxrt`eY+lPLKYu&dTns31Or$W+yFflb3d%4tfd~XXmczcxi52m-E`Kxus<+nL5tS>*k!It;~ItpPw`GrgEYv<(8ydiZNHL zujXWHr6-FLHk6^_DvlBVM0CJy90E~pUXIvao^WEF{6%;K;SKtPUWQW`+oQZxr z>urx4A)A#Y!x%0zzbC?2DJw-s!`(2Ey@+R-)-?t9fWhU!fDed>W7O0@IY>k9JCAp@&K8QHZU(Xb(t}n zctL>IC)^gi^B8WgFv#M{(-wn2vY3ZWYonF?%KR31d))Mh8SS*iDRElTBu88?a?oPFL|?J~w?AVnt|7Ix7$ljbVxGnuh?BVitFd6z?e51%pr^ITaA zX$N4w(U!NC=I6Fj&=gy3i_P7(g8tEGk?$k~i+j~cq{GvgkP0R{^@zn}IW7b|AX-&c z6gACKUI36tE0U4J`JzcVVy)|nwxsE|wNxEyCkWKerq)hf#;ZUUDN_fS0_>F3?Y#L( z%EOwczlgrE3zBLmYsrQ;3Q(Z1v#E646>dvd180WI6AhDf6Ew>P@#zr?AuKn183v!k zSjY9*=8e1tivT8d0~E<_(3_1L{dgJpw&3-4gOnPe6NP^|g!{l9MLk721vw^|rf7EA z`FVqcYRW6PlMEjBGZY>HBjF9>4B)Gb{?ma1u{#&-b7I{!#DTu4e%Cj=-8cMns?s-B?Hlu~ zI~~3EeziWiKKU$p*zO&FItK!3B{@+|PT0|j-DtZV9lZbRdpF9HyP@cP;a+Szbi@uF z*%3SMN?&zW#Qv(-UqejzsMFT|K=^~Od8pDhSZy0zKkp>E*Vi@&J}+&QY@yc)$L}A% zcXB&CV21~s#9{KzHD)K-XZK&JB(GMJSMBK4on-Ikr9THM$=9pN*X`Kp^-JrQzCQoA zslQG=`tZqz>+DXVbHmzvzmn*$Ci-om|5^N?edyHJS3p3m#7C;}5nC9cUx2+HkNg+% zs`4`LyL=Hox(#Y3A7CGk5_Y0I3MtA@;8C;5ON49u_$qt?=y^~L5mz@P_xeFJs2iTe6C*|)@*&1?wf7_>Nxu~>_@0#AZlLEw0}y#gsh zXd0h}2a0w4254z^jT>4t)&d}OZH*r)E~)8&7xg5BJrFeGKOMnu66;$;5HMoGiEacd z@QJR&%vfGn$baf#vzbv)OaQvhkat>+$tSdhE{eVV@Cs9Skr=@5LH~E*HogGy0cjZ@KgMBk$i7q z8Ildi_b|x?T4^3VOP5z5iNz$2-4KD4nxFShH3)1#7(Me$vbZ)z6&MKcmf@P3Y z7{lKSFC5%tBaH?7HIKW!b<^B$nDis;NDmT|xb-qULZf@adtP384v)hlNllF3fvj;1 z!#HTr_San`mg(i7Seaf9N|fp4pibLg9dyX{R|lQ6f4uIZ!!o= literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/deprecated/__pycache__/tools.cpython-311.pyc b/env/Lib/site-packages/pydantic/deprecated/__pycache__/tools.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f03b2c4e44654d9dc22e9847e36c6b72433713e4 GIT binary patch literal 3901 zcmb_f&2Jmm5r0c^$>r{n5@mf`c2{ofh>k5MvV)+3QN)#Hx2~)x5gj9I8PtmVB-38* z5^q;(WUv5T_}~IYp<7%u1$+ox8}_L{FFo}S=z$6ZWU+t%0YwkF(QtavsWWd$ij-^z zar?L&zK@xCvv1}%^Z1ukN+!_$_NRX?Nhw19g@a~`haKUCEfDf0F^MTyq$KEqfc=OS z(Ifmfsz>2BYQ;*TE|%hYyp+%rB}tb`Nj+JTb(!W8^GVP-YD$)2*(>k&&(7vU}?zp|L_eTg#n(`yC z{3(3HrVqfZYAR;rnffRKEAS1Q`IdRq?7b^Kg5lHVB+&;sf8R^^BW6EM(=K!1tC)Gr z)b7UjNDgty(I1d}+x+Q1$zd}xN3vtzp%qynPz>94Ji{wGwmXxJ2dUiWvs3xWUrtT_ z`d2d-gXlSXEs!P+%Q6-%8pLvIWf~-qerB*hykdhKXpv1?X0%{<)cg)#IvWXk&re-A zcV#-4|8(j?J~wrFcKTdyD(JaLZOVY}lIz%Wg&VYFpb@C>oN1Ij%3wG&yJi};S1g=w zX`L(D1v>F=HX5j9gSj;CEZ)o;Zjf}jj=ZxJq#NCvpc%(PZs(JQcIE}G=xV!$j%!z3 zsx6codyTi*FurP7MH8&dm)E=-jt!Ew>rulT2kRt!&1HwJ1)>LL=XVnLb1ip0h=Nf} zgx3#}e8o0Obf;$q=mn$TfrM7kW*nOaaYnrrW*4I9ghoR-7z;1{4xKNF*NQ4aZnpZS z;KiB(1TgX}`Uqs6w)6<361g+-3fY*~KpbiSS#htdm)zA|A)T@P5bfL7Dnch0L{@x; z^#UJLfINw?KKKb_*E0&YEV@dq+n?obP_1=58aN2f2mHR*Iqja)Y)7*kdl|S2jKcA| znnz1zhZ%6DCC8+e`$S-eVJnDW={E+mi}tb`#IVP@(1M<3C_%hl4cA#37rOSiIvZvE zFwX{&AoyK8Tusw^mOEZvW8Js`l40D$22v&ek%^ePd)b$+ZDo%82YTy?m>7RffP9an z&WTKnj_|p-tt`x5~+Hl#`DO z8_L9{GEs|7ynr3a&ZUJGfPMr#IK)E1U1;QokfN>^nh-&F zw4l@vvu_S1F9Et5Z66%kVA$j#0KQ7B5`7ly1lDiGig0JjLqIfIMex*SpODT{!QvI6 z0wwG$Fxbam0p)~;!P{s6WvO#VfkX&s*#qIG)`|!)P2Qes9;;?(m*zg6(L(2FV+LeN zINYqZ$ZW*|6ooad;YwJB#5T^3flVCx>=5(-Oz2zgOYYhk z?(o~6&Vok35bTUvu(Y%`Ti_wI@T$b18MfJ$4&0S8qyZ>9>?gRN#5CM*6ba%!#JJKH zuYp{Iogp7VJz*!2tg1FBmj-Qg+iGoK^5*_fdG1k8|clw z8ohu?rGK4n$RnHb$hY#?H}aUD8S;m+e&1+4L6j_DSV6Qa@#Z`xC4=&6_2LZgdlq#WcP(&4=P0R39c>xfe;*Ngy83|4MDa0{)byqX8q`c zmB(NF!>ZAhnzXtht!_%I^=MRuLIY%5?yrl@0nCVT9xz#924Kc(@az4Mb z0(UN&&oeCO>;ohkkRT2<267R@ND2iJ>=Wi8Ofo?t4^`0u3(%-QX}cKm!wRniJhPx%pAdfDJm2g{XW^Q& zV$q+ok6;Olo$CXwM+HIf$&p&;vrUvL|M;Y<%0E7ts{NQ}n~c>upKbDs+RGlF9IJIc zK6$s+`D`b8A%KL_^*9+mU5oW^%O6w|+vx-AlMecNi}xn)Oy8ZZ3NVbQ)nPw&)lX$0E+diW1jzSD>XHh&Ne6kJ>|8zE5TAXC yc$$nJ_4|hW!4v*_ll9agp{q{zlXi```VmxFZqbz=R@ox}ruLI|l^v_x^Zy0QuCE3F literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/deprecated/class_validators.py b/env/Lib/site-packages/pydantic/deprecated/class_validators.py new file mode 100644 index 0000000..aae3362 --- /dev/null +++ b/env/Lib/site-packages/pydantic/deprecated/class_validators.py @@ -0,0 +1,256 @@ +"""Old `@validator` and `@root_validator` function validators from V1.""" + +from __future__ import annotations as _annotations + +from functools import partial, partialmethod +from types import FunctionType +from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union, overload +from warnings import warn + +from typing_extensions import Literal, Protocol, TypeAlias, deprecated + +from .._internal import _decorators, _decorators_v1 +from ..errors import PydanticUserError +from ..warnings import PydanticDeprecatedSince20 + +_ALLOW_REUSE_WARNING_MESSAGE = '`allow_reuse` is deprecated and will be ignored; it should no longer be necessary' + + +if TYPE_CHECKING: + + class _OnlyValueValidatorClsMethod(Protocol): + def __call__(self, __cls: Any, __value: Any) -> Any: ... + + class _V1ValidatorWithValuesClsMethod(Protocol): + def __call__(self, __cls: Any, __value: Any, values: dict[str, Any]) -> Any: ... + + class _V1ValidatorWithValuesKwOnlyClsMethod(Protocol): + def __call__(self, __cls: Any, __value: Any, *, values: dict[str, Any]) -> Any: ... + + class _V1ValidatorWithKwargsClsMethod(Protocol): + def __call__(self, __cls: Any, **kwargs: Any) -> Any: ... + + class _V1ValidatorWithValuesAndKwargsClsMethod(Protocol): + def __call__(self, __cls: Any, values: dict[str, Any], **kwargs: Any) -> Any: ... + + class _V1RootValidatorClsMethod(Protocol): + def __call__( + self, __cls: Any, __values: _decorators_v1.RootValidatorValues + ) -> _decorators_v1.RootValidatorValues: ... + + V1Validator = Union[ + _OnlyValueValidatorClsMethod, + _V1ValidatorWithValuesClsMethod, + _V1ValidatorWithValuesKwOnlyClsMethod, + _V1ValidatorWithKwargsClsMethod, + _V1ValidatorWithValuesAndKwargsClsMethod, + _decorators_v1.V1ValidatorWithValues, + _decorators_v1.V1ValidatorWithValuesKwOnly, + _decorators_v1.V1ValidatorWithKwargs, + _decorators_v1.V1ValidatorWithValuesAndKwargs, + ] + + V1RootValidator = Union[ + _V1RootValidatorClsMethod, + _decorators_v1.V1RootValidatorFunction, + ] + + _PartialClsOrStaticMethod: TypeAlias = Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any]] + + # Allow both a V1 (assumed pre=False) or V2 (assumed mode='after') validator + # We lie to type checkers and say we return the same thing we get + # but in reality we return a proxy object that _mostly_ behaves like the wrapped thing + _V1ValidatorType = TypeVar('_V1ValidatorType', V1Validator, _PartialClsOrStaticMethod) + _V1RootValidatorFunctionType = TypeVar( + '_V1RootValidatorFunctionType', + _decorators_v1.V1RootValidatorFunction, + _V1RootValidatorClsMethod, + _PartialClsOrStaticMethod, + ) +else: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + + +@deprecated( + 'Pydantic V1 style `@validator` validators are deprecated.' + ' You should migrate to Pydantic V2 style `@field_validator` validators,' + ' see the migration guide for more details', + category=None, +) +def validator( + __field: str, + *fields: str, + pre: bool = False, + each_item: bool = False, + always: bool = False, + check_fields: bool | None = None, + allow_reuse: bool = False, +) -> Callable[[_V1ValidatorType], _V1ValidatorType]: + """Decorate methods on the class indicating that they should be used to validate fields. + + Args: + __field (str): The first field the validator should be called on; this is separate + from `fields` to ensure an error is raised if you don't pass at least one. + *fields (str): Additional field(s) the validator should be called on. + pre (bool, optional): Whether this validator should be called before the standard + validators (else after). Defaults to False. + each_item (bool, optional): For complex objects (sets, lists etc.) whether to validate + individual elements rather than the whole object. Defaults to False. + always (bool, optional): Whether this method and other validators should be called even if + the value is missing. Defaults to False. + check_fields (bool | None, optional): Whether to check that the fields actually exist on the model. + Defaults to None. + allow_reuse (bool, optional): Whether to track and raise an error if another validator refers to + the decorated function. Defaults to False. + + Returns: + Callable: A decorator that can be used to decorate a + function to be used as a validator. + """ + warn( + 'Pydantic V1 style `@validator` validators are deprecated.' + ' You should migrate to Pydantic V2 style `@field_validator` validators,' + ' see the migration guide for more details', + DeprecationWarning, + stacklevel=2, + ) + + if allow_reuse is True: # pragma: no cover + warn(_ALLOW_REUSE_WARNING_MESSAGE, DeprecationWarning) + fields = tuple((__field, *fields)) + if isinstance(fields[0], FunctionType): + raise PydanticUserError( + '`@validator` should be used with fields and keyword arguments, not bare. ' + "E.g. usage should be `@validator('', ...)`", + code='validator-no-fields', + ) + elif not all(isinstance(field, str) for field in fields): + raise PydanticUserError( + '`@validator` fields should be passed as separate string args. ' + "E.g. usage should be `@validator('', '', ...)`", + code='validator-invalid-fields', + ) + + mode: Literal['before', 'after'] = 'before' if pre is True else 'after' + + def dec(f: Any) -> _decorators.PydanticDescriptorProxy[Any]: + if _decorators.is_instance_method_from_sig(f): + raise PydanticUserError( + '`@validator` cannot be applied to instance methods', code='validator-instance-method' + ) + # auto apply the @classmethod decorator + f = _decorators.ensure_classmethod_based_on_signature(f) + wrap = _decorators_v1.make_generic_v1_field_validator + validator_wrapper_info = _decorators.ValidatorDecoratorInfo( + fields=fields, + mode=mode, + each_item=each_item, + always=always, + check_fields=check_fields, + ) + return _decorators.PydanticDescriptorProxy(f, validator_wrapper_info, shim=wrap) + + return dec # type: ignore[return-value] + + +@overload +def root_validator( + *, + # if you don't specify `pre` the default is `pre=False` + # which means you need to specify `skip_on_failure=True` + skip_on_failure: Literal[True], + allow_reuse: bool = ..., +) -> Callable[ + [_V1RootValidatorFunctionType], + _V1RootValidatorFunctionType, +]: ... + + +@overload +def root_validator( + *, + # if you specify `pre=True` then you don't need to specify + # `skip_on_failure`, in fact it is not allowed as an argument! + pre: Literal[True], + allow_reuse: bool = ..., +) -> Callable[ + [_V1RootValidatorFunctionType], + _V1RootValidatorFunctionType, +]: ... + + +@overload +def root_validator( + *, + # if you explicitly specify `pre=False` then you + # MUST specify `skip_on_failure=True` + pre: Literal[False], + skip_on_failure: Literal[True], + allow_reuse: bool = ..., +) -> Callable[ + [_V1RootValidatorFunctionType], + _V1RootValidatorFunctionType, +]: ... + + +@deprecated( + 'Pydantic V1 style `@root_validator` validators are deprecated.' + ' You should migrate to Pydantic V2 style `@model_validator` validators,' + ' see the migration guide for more details', + category=None, +) +def root_validator( + *__args, + pre: bool = False, + skip_on_failure: bool = False, + allow_reuse: bool = False, +) -> Any: + """Decorate methods on a model indicating that they should be used to validate (and perhaps + modify) data either before or after standard model parsing/validation is performed. + + Args: + pre (bool, optional): Whether this validator should be called before the standard + validators (else after). Defaults to False. + skip_on_failure (bool, optional): Whether to stop validation and return as soon as a + failure is encountered. Defaults to False. + allow_reuse (bool, optional): Whether to track and raise an error if another validator + refers to the decorated function. Defaults to False. + + Returns: + Any: A decorator that can be used to decorate a function to be used as a root_validator. + """ + warn( + 'Pydantic V1 style `@root_validator` validators are deprecated.' + ' You should migrate to Pydantic V2 style `@model_validator` validators,' + ' see the migration guide for more details', + DeprecationWarning, + stacklevel=2, + ) + + if __args: + # Ensure a nice error is raised if someone attempts to use the bare decorator + return root_validator()(*__args) # type: ignore + + if allow_reuse is True: # pragma: no cover + warn(_ALLOW_REUSE_WARNING_MESSAGE, DeprecationWarning) + mode: Literal['before', 'after'] = 'before' if pre is True else 'after' + if pre is False and skip_on_failure is not True: + raise PydanticUserError( + 'If you use `@root_validator` with pre=False (the default) you MUST specify `skip_on_failure=True`.' + ' Note that `@root_validator` is deprecated and should be replaced with `@model_validator`.', + code='root-validator-pre-skip', + ) + + wrap = partial(_decorators_v1.make_v1_generic_root_validator, pre=pre) + + def dec(f: Callable[..., Any] | classmethod[Any, Any, Any] | staticmethod[Any, Any]) -> Any: + if _decorators.is_instance_method_from_sig(f): + raise TypeError('`@root_validator` cannot be applied to instance methods') + # auto apply the @classmethod decorator + res = _decorators.ensure_classmethod_based_on_signature(f) + dec_info = _decorators.RootValidatorDecoratorInfo(mode=mode) + return _decorators.PydanticDescriptorProxy(res, dec_info, shim=wrap) + + return dec diff --git a/env/Lib/site-packages/pydantic/deprecated/copy_internals.py b/env/Lib/site-packages/pydantic/deprecated/copy_internals.py new file mode 100644 index 0000000..efe5de2 --- /dev/null +++ b/env/Lib/site-packages/pydantic/deprecated/copy_internals.py @@ -0,0 +1,224 @@ +from __future__ import annotations as _annotations + +import typing +from copy import deepcopy +from enum import Enum +from typing import Any, Tuple + +import typing_extensions + +from .._internal import ( + _model_construction, + _typing_extra, + _utils, +) + +if typing.TYPE_CHECKING: + from .. import BaseModel + from .._internal._utils import AbstractSetIntStr, MappingIntStrAny + + AnyClassMethod = classmethod[Any, Any, Any] + TupleGenerator = typing.Generator[Tuple[str, Any], None, None] + Model = typing.TypeVar('Model', bound='BaseModel') + # should be `set[int] | set[str] | dict[int, IncEx] | dict[str, IncEx] | None`, but mypy can't cope + IncEx: typing_extensions.TypeAlias = 'set[int] | set[str] | dict[int, Any] | dict[str, Any] | None' + +_object_setattr = _model_construction.object_setattr + + +def _iter( + self: BaseModel, + to_dict: bool = False, + by_alias: bool = False, + include: AbstractSetIntStr | MappingIntStrAny | None = None, + exclude: AbstractSetIntStr | MappingIntStrAny | None = None, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, +) -> TupleGenerator: + # Merge field set excludes with explicit exclude parameter with explicit overriding field set options. + # The extra "is not None" guards are not logically necessary but optimizes performance for the simple case. + if exclude is not None: + exclude = _utils.ValueItems.merge( + {k: v.exclude for k, v in self.model_fields.items() if v.exclude is not None}, exclude + ) + + if include is not None: + include = _utils.ValueItems.merge({k: True for k in self.model_fields}, include, intersect=True) + + allowed_keys = _calculate_keys(self, include=include, exclude=exclude, exclude_unset=exclude_unset) # type: ignore + if allowed_keys is None and not (to_dict or by_alias or exclude_unset or exclude_defaults or exclude_none): + # huge boost for plain _iter() + yield from self.__dict__.items() + if self.__pydantic_extra__: + yield from self.__pydantic_extra__.items() + return + + value_exclude = _utils.ValueItems(self, exclude) if exclude is not None else None + value_include = _utils.ValueItems(self, include) if include is not None else None + + if self.__pydantic_extra__ is None: + items = self.__dict__.items() + else: + items = list(self.__dict__.items()) + list(self.__pydantic_extra__.items()) + + for field_key, v in items: + if (allowed_keys is not None and field_key not in allowed_keys) or (exclude_none and v is None): + continue + + if exclude_defaults: + try: + field = self.model_fields[field_key] + except KeyError: + pass + else: + if not field.is_required() and field.default == v: + continue + + if by_alias and field_key in self.model_fields: + dict_key = self.model_fields[field_key].alias or field_key + else: + dict_key = field_key + + if to_dict or value_include or value_exclude: + v = _get_value( + type(self), + v, + to_dict=to_dict, + by_alias=by_alias, + include=value_include and value_include.for_element(field_key), + exclude=value_exclude and value_exclude.for_element(field_key), + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + yield dict_key, v + + +def _copy_and_set_values( + self: Model, + values: dict[str, Any], + fields_set: set[str], + extra: dict[str, Any] | None = None, + private: dict[str, Any] | None = None, + *, + deep: bool, # UP006 +) -> Model: + if deep: + # chances of having empty dict here are quite low for using smart_deepcopy + values = deepcopy(values) + extra = deepcopy(extra) + private = deepcopy(private) + + cls = self.__class__ + m = cls.__new__(cls) + _object_setattr(m, '__dict__', values) + _object_setattr(m, '__pydantic_extra__', extra) + _object_setattr(m, '__pydantic_fields_set__', fields_set) + _object_setattr(m, '__pydantic_private__', private) + + return m + + +@typing.no_type_check +def _get_value( + cls: type[BaseModel], + v: Any, + to_dict: bool, + by_alias: bool, + include: AbstractSetIntStr | MappingIntStrAny | None, + exclude: AbstractSetIntStr | MappingIntStrAny | None, + exclude_unset: bool, + exclude_defaults: bool, + exclude_none: bool, +) -> Any: + from .. import BaseModel + + if isinstance(v, BaseModel): + if to_dict: + return v.model_dump( + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + include=include, # type: ignore + exclude=exclude, # type: ignore + exclude_none=exclude_none, + ) + else: + return v.copy(include=include, exclude=exclude) + + value_exclude = _utils.ValueItems(v, exclude) if exclude else None + value_include = _utils.ValueItems(v, include) if include else None + + if isinstance(v, dict): + return { + k_: _get_value( + cls, + v_, + to_dict=to_dict, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + include=value_include and value_include.for_element(k_), + exclude=value_exclude and value_exclude.for_element(k_), + exclude_none=exclude_none, + ) + for k_, v_ in v.items() + if (not value_exclude or not value_exclude.is_excluded(k_)) + and (not value_include or value_include.is_included(k_)) + } + + elif _utils.sequence_like(v): + seq_args = ( + _get_value( + cls, + v_, + to_dict=to_dict, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + include=value_include and value_include.for_element(i), + exclude=value_exclude and value_exclude.for_element(i), + exclude_none=exclude_none, + ) + for i, v_ in enumerate(v) + if (not value_exclude or not value_exclude.is_excluded(i)) + and (not value_include or value_include.is_included(i)) + ) + + return v.__class__(*seq_args) if _typing_extra.is_namedtuple(v.__class__) else v.__class__(seq_args) + + elif isinstance(v, Enum) and getattr(cls.model_config, 'use_enum_values', False): + return v.value + + else: + return v + + +def _calculate_keys( + self: BaseModel, + include: MappingIntStrAny | None, + exclude: MappingIntStrAny | None, + exclude_unset: bool, + update: typing.Dict[str, Any] | None = None, # noqa UP006 +) -> typing.AbstractSet[str] | None: + if include is None and exclude is None and exclude_unset is False: + return None + + keys: typing.AbstractSet[str] + if exclude_unset: + keys = self.__pydantic_fields_set__.copy() + else: + keys = set(self.__dict__.keys()) + keys = keys | (self.__pydantic_extra__ or {}).keys() + + if include is not None: + keys &= include.keys() + + if update: + keys -= update.keys() + + if exclude: + keys -= {k for k, v in exclude.items() if _utils.ValueItems.is_true(v)} + + return keys diff --git a/env/Lib/site-packages/pydantic/deprecated/decorator.py b/env/Lib/site-packages/pydantic/deprecated/decorator.py new file mode 100644 index 0000000..0c0ea74 --- /dev/null +++ b/env/Lib/site-packages/pydantic/deprecated/decorator.py @@ -0,0 +1,279 @@ +import warnings +from functools import wraps +from typing import TYPE_CHECKING, Any, Callable, Dict, List, Mapping, Optional, Tuple, Type, TypeVar, Union, overload + +from typing_extensions import deprecated + +from .._internal import _config, _typing_extra +from ..alias_generators import to_pascal +from ..errors import PydanticUserError +from ..functional_validators import field_validator +from ..main import BaseModel, create_model +from ..warnings import PydanticDeprecatedSince20 + +if not TYPE_CHECKING: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + +__all__ = ('validate_arguments',) + +if TYPE_CHECKING: + AnyCallable = Callable[..., Any] + + AnyCallableT = TypeVar('AnyCallableT', bound=AnyCallable) + ConfigType = Union[None, Type[Any], Dict[str, Any]] + + +@overload +def validate_arguments( + func: None = None, *, config: 'ConfigType' = None +) -> Callable[['AnyCallableT'], 'AnyCallableT']: ... + + +@overload +def validate_arguments(func: 'AnyCallableT') -> 'AnyCallableT': ... + + +@deprecated( + 'The `validate_arguments` method is deprecated; use `validate_call` instead.', + category=None, +) +def validate_arguments(func: Optional['AnyCallableT'] = None, *, config: 'ConfigType' = None) -> Any: + """Decorator to validate the arguments passed to a function.""" + warnings.warn( + 'The `validate_arguments` method is deprecated; use `validate_call` instead.', + PydanticDeprecatedSince20, + stacklevel=2, + ) + + def validate(_func: 'AnyCallable') -> 'AnyCallable': + vd = ValidatedFunction(_func, config) + + @wraps(_func) + def wrapper_function(*args: Any, **kwargs: Any) -> Any: + return vd.call(*args, **kwargs) + + wrapper_function.vd = vd # type: ignore + wrapper_function.validate = vd.init_model_instance # type: ignore + wrapper_function.raw_function = vd.raw_function # type: ignore + wrapper_function.model = vd.model # type: ignore + return wrapper_function + + if func: + return validate(func) + else: + return validate + + +ALT_V_ARGS = 'v__args' +ALT_V_KWARGS = 'v__kwargs' +V_POSITIONAL_ONLY_NAME = 'v__positional_only' +V_DUPLICATE_KWARGS = 'v__duplicate_kwargs' + + +class ValidatedFunction: + def __init__(self, function: 'AnyCallable', config: 'ConfigType'): + from inspect import Parameter, signature + + parameters: Mapping[str, Parameter] = signature(function).parameters + + if parameters.keys() & {ALT_V_ARGS, ALT_V_KWARGS, V_POSITIONAL_ONLY_NAME, V_DUPLICATE_KWARGS}: + raise PydanticUserError( + f'"{ALT_V_ARGS}", "{ALT_V_KWARGS}", "{V_POSITIONAL_ONLY_NAME}" and "{V_DUPLICATE_KWARGS}" ' + f'are not permitted as argument names when using the "{validate_arguments.__name__}" decorator', + code=None, + ) + + self.raw_function = function + self.arg_mapping: Dict[int, str] = {} + self.positional_only_args: set[str] = set() + self.v_args_name = 'args' + self.v_kwargs_name = 'kwargs' + + type_hints = _typing_extra.get_type_hints(function, include_extras=True) + takes_args = False + takes_kwargs = False + fields: Dict[str, Tuple[Any, Any]] = {} + for i, (name, p) in enumerate(parameters.items()): + if p.annotation is p.empty: + annotation = Any + else: + annotation = type_hints[name] + + default = ... if p.default is p.empty else p.default + if p.kind == Parameter.POSITIONAL_ONLY: + self.arg_mapping[i] = name + fields[name] = annotation, default + fields[V_POSITIONAL_ONLY_NAME] = List[str], None + self.positional_only_args.add(name) + elif p.kind == Parameter.POSITIONAL_OR_KEYWORD: + self.arg_mapping[i] = name + fields[name] = annotation, default + fields[V_DUPLICATE_KWARGS] = List[str], None + elif p.kind == Parameter.KEYWORD_ONLY: + fields[name] = annotation, default + elif p.kind == Parameter.VAR_POSITIONAL: + self.v_args_name = name + fields[name] = Tuple[annotation, ...], None + takes_args = True + else: + assert p.kind == Parameter.VAR_KEYWORD, p.kind + self.v_kwargs_name = name + fields[name] = Dict[str, annotation], None + takes_kwargs = True + + # these checks avoid a clash between "args" and a field with that name + if not takes_args and self.v_args_name in fields: + self.v_args_name = ALT_V_ARGS + + # same with "kwargs" + if not takes_kwargs and self.v_kwargs_name in fields: + self.v_kwargs_name = ALT_V_KWARGS + + if not takes_args: + # we add the field so validation below can raise the correct exception + fields[self.v_args_name] = List[Any], None + + if not takes_kwargs: + # same with kwargs + fields[self.v_kwargs_name] = Dict[Any, Any], None + + self.create_model(fields, takes_args, takes_kwargs, config) + + def init_model_instance(self, *args: Any, **kwargs: Any) -> BaseModel: + values = self.build_values(args, kwargs) + return self.model(**values) + + def call(self, *args: Any, **kwargs: Any) -> Any: + m = self.init_model_instance(*args, **kwargs) + return self.execute(m) + + def build_values(self, args: Tuple[Any, ...], kwargs: Dict[str, Any]) -> Dict[str, Any]: + values: Dict[str, Any] = {} + if args: + arg_iter = enumerate(args) + while True: + try: + i, a = next(arg_iter) + except StopIteration: + break + arg_name = self.arg_mapping.get(i) + if arg_name is not None: + values[arg_name] = a + else: + values[self.v_args_name] = [a] + [a for _, a in arg_iter] + break + + var_kwargs: Dict[str, Any] = {} + wrong_positional_args = [] + duplicate_kwargs = [] + fields_alias = [ + field.alias + for name, field in self.model.model_fields.items() + if name not in (self.v_args_name, self.v_kwargs_name) + ] + non_var_fields = set(self.model.model_fields) - {self.v_args_name, self.v_kwargs_name} + for k, v in kwargs.items(): + if k in non_var_fields or k in fields_alias: + if k in self.positional_only_args: + wrong_positional_args.append(k) + if k in values: + duplicate_kwargs.append(k) + values[k] = v + else: + var_kwargs[k] = v + + if var_kwargs: + values[self.v_kwargs_name] = var_kwargs + if wrong_positional_args: + values[V_POSITIONAL_ONLY_NAME] = wrong_positional_args + if duplicate_kwargs: + values[V_DUPLICATE_KWARGS] = duplicate_kwargs + return values + + def execute(self, m: BaseModel) -> Any: + d = {k: v for k, v in m.__dict__.items() if k in m.__pydantic_fields_set__ or m.model_fields[k].default_factory} + var_kwargs = d.pop(self.v_kwargs_name, {}) + + if self.v_args_name in d: + args_: List[Any] = [] + in_kwargs = False + kwargs = {} + for name, value in d.items(): + if in_kwargs: + kwargs[name] = value + elif name == self.v_args_name: + args_ += value + in_kwargs = True + else: + args_.append(value) + return self.raw_function(*args_, **kwargs, **var_kwargs) + elif self.positional_only_args: + args_ = [] + kwargs = {} + for name, value in d.items(): + if name in self.positional_only_args: + args_.append(value) + else: + kwargs[name] = value + return self.raw_function(*args_, **kwargs, **var_kwargs) + else: + return self.raw_function(**d, **var_kwargs) + + def create_model(self, fields: Dict[str, Any], takes_args: bool, takes_kwargs: bool, config: 'ConfigType') -> None: + pos_args = len(self.arg_mapping) + + config_wrapper = _config.ConfigWrapper(config) + + if config_wrapper.alias_generator: + raise PydanticUserError( + 'Setting the "alias_generator" property on custom Config for ' + '@validate_arguments is not yet supported, please remove.', + code=None, + ) + if config_wrapper.extra is None: + config_wrapper.config_dict['extra'] = 'forbid' + + class DecoratorBaseModel(BaseModel): + @field_validator(self.v_args_name, check_fields=False) + @classmethod + def check_args(cls, v: Optional[List[Any]]) -> Optional[List[Any]]: + if takes_args or v is None: + return v + + raise TypeError(f'{pos_args} positional arguments expected but {pos_args + len(v)} given') + + @field_validator(self.v_kwargs_name, check_fields=False) + @classmethod + def check_kwargs(cls, v: Optional[Dict[str, Any]]) -> Optional[Dict[str, Any]]: + if takes_kwargs or v is None: + return v + + plural = '' if len(v) == 1 else 's' + keys = ', '.join(map(repr, v.keys())) + raise TypeError(f'unexpected keyword argument{plural}: {keys}') + + @field_validator(V_POSITIONAL_ONLY_NAME, check_fields=False) + @classmethod + def check_positional_only(cls, v: Optional[List[str]]) -> None: + if v is None: + return + + plural = '' if len(v) == 1 else 's' + keys = ', '.join(map(repr, v)) + raise TypeError(f'positional-only argument{plural} passed as keyword argument{plural}: {keys}') + + @field_validator(V_DUPLICATE_KWARGS, check_fields=False) + @classmethod + def check_duplicate_kwargs(cls, v: Optional[List[str]]) -> None: + if v is None: + return + + plural = '' if len(v) == 1 else 's' + keys = ', '.join(map(repr, v)) + raise TypeError(f'multiple values for argument{plural}: {keys}') + + model_config = config_wrapper.config_dict + + self.model = create_model(to_pascal(self.raw_function.__name__), __base__=DecoratorBaseModel, **fields) diff --git a/env/Lib/site-packages/pydantic/deprecated/json.py b/env/Lib/site-packages/pydantic/deprecated/json.py new file mode 100644 index 0000000..9ba5256 --- /dev/null +++ b/env/Lib/site-packages/pydantic/deprecated/json.py @@ -0,0 +1,140 @@ +import datetime +import warnings +from collections import deque +from decimal import Decimal +from enum import Enum +from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network +from pathlib import Path +from re import Pattern +from types import GeneratorType +from typing import TYPE_CHECKING, Any, Callable, Dict, Type, Union +from uuid import UUID + +from typing_extensions import deprecated + +from ..color import Color +from ..networks import NameEmail +from ..types import SecretBytes, SecretStr +from ..warnings import PydanticDeprecatedSince20 + +if not TYPE_CHECKING: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + +__all__ = 'pydantic_encoder', 'custom_pydantic_encoder', 'timedelta_isoformat' + + +def isoformat(o: Union[datetime.date, datetime.time]) -> str: + return o.isoformat() + + +def decimal_encoder(dec_value: Decimal) -> Union[int, float]: + """Encodes a Decimal as int of there's no exponent, otherwise float. + + This is useful when we use ConstrainedDecimal to represent Numeric(x,0) + where a integer (but not int typed) is used. Encoding this as a float + results in failed round-tripping between encode and parse. + Our Id type is a prime example of this. + + >>> decimal_encoder(Decimal("1.0")) + 1.0 + + >>> decimal_encoder(Decimal("1")) + 1 + """ + exponent = dec_value.as_tuple().exponent + if isinstance(exponent, int) and exponent >= 0: + return int(dec_value) + else: + return float(dec_value) + + +ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = { + bytes: lambda o: o.decode(), + Color: str, + datetime.date: isoformat, + datetime.datetime: isoformat, + datetime.time: isoformat, + datetime.timedelta: lambda td: td.total_seconds(), + Decimal: decimal_encoder, + Enum: lambda o: o.value, + frozenset: list, + deque: list, + GeneratorType: list, + IPv4Address: str, + IPv4Interface: str, + IPv4Network: str, + IPv6Address: str, + IPv6Interface: str, + IPv6Network: str, + NameEmail: str, + Path: str, + Pattern: lambda o: o.pattern, + SecretBytes: str, + SecretStr: str, + set: list, + UUID: str, +} + + +@deprecated( + '`pydantic_encoder` is deprecated, use `pydantic_core.to_jsonable_python` instead.', + category=None, +) +def pydantic_encoder(obj: Any) -> Any: + warnings.warn( + '`pydantic_encoder` is deprecated, use `pydantic_core.to_jsonable_python` instead.', + category=PydanticDeprecatedSince20, + stacklevel=2, + ) + from dataclasses import asdict, is_dataclass + + from ..main import BaseModel + + if isinstance(obj, BaseModel): + return obj.model_dump() + elif is_dataclass(obj): + return asdict(obj) # type: ignore + + # Check the class type and its superclasses for a matching encoder + for base in obj.__class__.__mro__[:-1]: + try: + encoder = ENCODERS_BY_TYPE[base] + except KeyError: + continue + return encoder(obj) + else: # We have exited the for loop without finding a suitable encoder + raise TypeError(f"Object of type '{obj.__class__.__name__}' is not JSON serializable") + + +# TODO: Add a suggested migration path once there is a way to use custom encoders +@deprecated( + '`custom_pydantic_encoder` is deprecated, use `BaseModel.model_dump` instead.', + category=None, +) +def custom_pydantic_encoder(type_encoders: Dict[Any, Callable[[Type[Any]], Any]], obj: Any) -> Any: + warnings.warn( + '`custom_pydantic_encoder` is deprecated, use `BaseModel.model_dump` instead.', + category=PydanticDeprecatedSince20, + stacklevel=2, + ) + # Check the class type and its superclasses for a matching encoder + for base in obj.__class__.__mro__[:-1]: + try: + encoder = type_encoders[base] + except KeyError: + continue + + return encoder(obj) + else: # We have exited the for loop without finding a suitable encoder + return pydantic_encoder(obj) + + +@deprecated('`timedelta_isoformat` is deprecated.', category=None) +def timedelta_isoformat(td: datetime.timedelta) -> str: + """ISO 8601 encoding for Python timedelta object.""" + warnings.warn('`timedelta_isoformat` is deprecated.', category=PydanticDeprecatedSince20, stacklevel=2) + minutes, seconds = divmod(td.seconds, 60) + hours, minutes = divmod(minutes, 60) + return f'{"-" if td.days < 0 else ""}P{abs(td.days)}DT{hours:d}H{minutes:d}M{seconds:d}.{td.microseconds:06d}S' diff --git a/env/Lib/site-packages/pydantic/deprecated/parse.py b/env/Lib/site-packages/pydantic/deprecated/parse.py new file mode 100644 index 0000000..2a92e62 --- /dev/null +++ b/env/Lib/site-packages/pydantic/deprecated/parse.py @@ -0,0 +1,80 @@ +from __future__ import annotations + +import json +import pickle +import warnings +from enum import Enum +from pathlib import Path +from typing import TYPE_CHECKING, Any, Callable + +from typing_extensions import deprecated + +from ..warnings import PydanticDeprecatedSince20 + +if not TYPE_CHECKING: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + + +class Protocol(str, Enum): + json = 'json' + pickle = 'pickle' + + +@deprecated('`load_str_bytes` is deprecated.', category=None) +def load_str_bytes( + b: str | bytes, + *, + content_type: str | None = None, + encoding: str = 'utf8', + proto: Protocol | None = None, + allow_pickle: bool = False, + json_loads: Callable[[str], Any] = json.loads, +) -> Any: + warnings.warn('`load_str_bytes` is deprecated.', category=PydanticDeprecatedSince20, stacklevel=2) + if proto is None and content_type: + if content_type.endswith(('json', 'javascript')): + pass + elif allow_pickle and content_type.endswith('pickle'): + proto = Protocol.pickle + else: + raise TypeError(f'Unknown content-type: {content_type}') + + proto = proto or Protocol.json + + if proto == Protocol.json: + if isinstance(b, bytes): + b = b.decode(encoding) + return json_loads(b) # type: ignore + elif proto == Protocol.pickle: + if not allow_pickle: + raise RuntimeError('Trying to decode with pickle with allow_pickle=False') + bb = b if isinstance(b, bytes) else b.encode() # type: ignore + return pickle.loads(bb) + else: + raise TypeError(f'Unknown protocol: {proto}') + + +@deprecated('`load_file` is deprecated.', category=None) +def load_file( + path: str | Path, + *, + content_type: str | None = None, + encoding: str = 'utf8', + proto: Protocol | None = None, + allow_pickle: bool = False, + json_loads: Callable[[str], Any] = json.loads, +) -> Any: + warnings.warn('`load_file` is deprecated.', category=PydanticDeprecatedSince20, stacklevel=2) + path = Path(path) + b = path.read_bytes() + if content_type is None: + if path.suffix in ('.js', '.json'): + proto = Protocol.json + elif path.suffix == '.pkl': + proto = Protocol.pickle + + return load_str_bytes( + b, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, json_loads=json_loads + ) diff --git a/env/Lib/site-packages/pydantic/deprecated/tools.py b/env/Lib/site-packages/pydantic/deprecated/tools.py new file mode 100644 index 0000000..b04eae4 --- /dev/null +++ b/env/Lib/site-packages/pydantic/deprecated/tools.py @@ -0,0 +1,103 @@ +from __future__ import annotations + +import json +import warnings +from typing import TYPE_CHECKING, Any, Callable, Type, TypeVar, Union + +from typing_extensions import deprecated + +from ..json_schema import DEFAULT_REF_TEMPLATE, GenerateJsonSchema +from ..type_adapter import TypeAdapter +from ..warnings import PydanticDeprecatedSince20 + +if not TYPE_CHECKING: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + +__all__ = 'parse_obj_as', 'schema_of', 'schema_json_of' + +NameFactory = Union[str, Callable[[Type[Any]], str]] + + +T = TypeVar('T') + + +@deprecated( + '`parse_obj_as` is deprecated. Use `pydantic.TypeAdapter.validate_python` instead.', + category=None, +) +def parse_obj_as(type_: type[T], obj: Any, type_name: NameFactory | None = None) -> T: + warnings.warn( + '`parse_obj_as` is deprecated. Use `pydantic.TypeAdapter.validate_python` instead.', + category=PydanticDeprecatedSince20, + stacklevel=2, + ) + if type_name is not None: # pragma: no cover + warnings.warn( + 'The type_name parameter is deprecated. parse_obj_as no longer creates temporary models', + DeprecationWarning, + stacklevel=2, + ) + return TypeAdapter(type_).validate_python(obj) + + +@deprecated( + '`schema_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.', + category=None, +) +def schema_of( + type_: Any, + *, + title: NameFactory | None = None, + by_alias: bool = True, + ref_template: str = DEFAULT_REF_TEMPLATE, + schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema, +) -> dict[str, Any]: + """Generate a JSON schema (as dict) for the passed model or dynamically generated one.""" + warnings.warn( + '`schema_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.', + category=PydanticDeprecatedSince20, + stacklevel=2, + ) + res = TypeAdapter(type_).json_schema( + by_alias=by_alias, + schema_generator=schema_generator, + ref_template=ref_template, + ) + if title is not None: + if isinstance(title, str): + res['title'] = title + else: + warnings.warn( + 'Passing a callable for the `title` parameter is deprecated and no longer supported', + DeprecationWarning, + stacklevel=2, + ) + res['title'] = title(type_) + return res + + +@deprecated( + '`schema_json_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.', + category=None, +) +def schema_json_of( + type_: Any, + *, + title: NameFactory | None = None, + by_alias: bool = True, + ref_template: str = DEFAULT_REF_TEMPLATE, + schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema, + **dumps_kwargs: Any, +) -> str: + """Generate a JSON schema (as JSON) for the passed model or dynamically generated one.""" + warnings.warn( + '`schema_json_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.', + category=PydanticDeprecatedSince20, + stacklevel=2, + ) + return json.dumps( + schema_of(type_, title=title, by_alias=by_alias, ref_template=ref_template, schema_generator=schema_generator), + **dumps_kwargs, + ) diff --git a/env/Lib/site-packages/pydantic/env_settings.py b/env/Lib/site-packages/pydantic/env_settings.py new file mode 100644 index 0000000..cd0b04e --- /dev/null +++ b/env/Lib/site-packages/pydantic/env_settings.py @@ -0,0 +1,5 @@ +"""The `env_settings` module is a backport module from V1.""" + +from ._migration import getattr_migration + +__getattr__ = getattr_migration(__name__) diff --git a/env/Lib/site-packages/pydantic/error_wrappers.py b/env/Lib/site-packages/pydantic/error_wrappers.py new file mode 100644 index 0000000..2985419 --- /dev/null +++ b/env/Lib/site-packages/pydantic/error_wrappers.py @@ -0,0 +1,5 @@ +"""The `error_wrappers` module is a backport module from V1.""" + +from ._migration import getattr_migration + +__getattr__ = getattr_migration(__name__) diff --git a/env/Lib/site-packages/pydantic/errors.py b/env/Lib/site-packages/pydantic/errors.py new file mode 100644 index 0000000..de2e512 --- /dev/null +++ b/env/Lib/site-packages/pydantic/errors.py @@ -0,0 +1,156 @@ +"""Pydantic-specific errors.""" + +from __future__ import annotations as _annotations + +import re + +from typing_extensions import Literal, Self + +from ._migration import getattr_migration +from .version import version_short + +__all__ = ( + 'PydanticUserError', + 'PydanticUndefinedAnnotation', + 'PydanticImportError', + 'PydanticSchemaGenerationError', + 'PydanticInvalidForJsonSchema', + 'PydanticErrorCodes', +) + +# We use this URL to allow for future flexibility about how we host the docs, while allowing for Pydantic +# code in the while with "old" URLs to still work. +# 'u' refers to "user errors" - e.g. errors caused by developers using pydantic, as opposed to validation errors. +DEV_ERROR_DOCS_URL = f'https://errors.pydantic.dev/{version_short()}/u/' +PydanticErrorCodes = Literal[ + 'class-not-fully-defined', + 'custom-json-schema', + 'decorator-missing-field', + 'discriminator-no-field', + 'discriminator-alias-type', + 'discriminator-needs-literal', + 'discriminator-alias', + 'discriminator-validator', + 'callable-discriminator-no-tag', + 'typed-dict-version', + 'model-field-overridden', + 'model-field-missing-annotation', + 'config-both', + 'removed-kwargs', + 'invalid-for-json-schema', + 'json-schema-already-used', + 'base-model-instantiated', + 'undefined-annotation', + 'schema-for-unknown-type', + 'import-error', + 'create-model-field-definitions', + 'create-model-config-base', + 'validator-no-fields', + 'validator-invalid-fields', + 'validator-instance-method', + 'root-validator-pre-skip', + 'model-serializer-instance-method', + 'validator-field-config-info', + 'validator-v1-signature', + 'validator-signature', + 'field-serializer-signature', + 'model-serializer-signature', + 'multiple-field-serializers', + 'invalid_annotated_type', + 'type-adapter-config-unused', + 'root-model-extra', + 'unevaluable-type-annotation', + 'dataclass-init-false-extra-allow', + 'clashing-init-and-init-var', + 'model-config-invalid-field-name', + 'with-config-on-model', + 'dataclass-on-model', +] + + +class PydanticErrorMixin: + """A mixin class for common functionality shared by all Pydantic-specific errors. + + Attributes: + message: A message describing the error. + code: An optional error code from PydanticErrorCodes enum. + """ + + def __init__(self, message: str, *, code: PydanticErrorCodes | None) -> None: + self.message = message + self.code = code + + def __str__(self) -> str: + if self.code is None: + return self.message + else: + return f'{self.message}\n\nFor further information visit {DEV_ERROR_DOCS_URL}{self.code}' + + +class PydanticUserError(PydanticErrorMixin, TypeError): + """An error raised due to incorrect use of Pydantic.""" + + +class PydanticUndefinedAnnotation(PydanticErrorMixin, NameError): + """A subclass of `NameError` raised when handling undefined annotations during `CoreSchema` generation. + + Attributes: + name: Name of the error. + message: Description of the error. + """ + + def __init__(self, name: str, message: str) -> None: + self.name = name + super().__init__(message=message, code='undefined-annotation') + + @classmethod + def from_name_error(cls, name_error: NameError) -> Self: + """Convert a `NameError` to a `PydanticUndefinedAnnotation` error. + + Args: + name_error: `NameError` to be converted. + + Returns: + Converted `PydanticUndefinedAnnotation` error. + """ + try: + name = name_error.name # type: ignore # python > 3.10 + except AttributeError: + name = re.search(r".*'(.+?)'", str(name_error)).group(1) # type: ignore[union-attr] + return cls(name=name, message=str(name_error)) + + +class PydanticImportError(PydanticErrorMixin, ImportError): + """An error raised when an import fails due to module changes between V1 and V2. + + Attributes: + message: Description of the error. + """ + + def __init__(self, message: str) -> None: + super().__init__(message, code='import-error') + + +class PydanticSchemaGenerationError(PydanticUserError): + """An error raised during failures to generate a `CoreSchema` for some type. + + Attributes: + message: Description of the error. + """ + + def __init__(self, message: str) -> None: + super().__init__(message, code='schema-for-unknown-type') + + +class PydanticInvalidForJsonSchema(PydanticUserError): + """An error raised during failures to generate a JSON schema for some `CoreSchema`. + + Attributes: + message: Description of the error. + """ + + def __init__(self, message: str) -> None: + super().__init__(message, code='invalid-for-json-schema') + + +__getattr__ = getattr_migration(__name__) diff --git a/env/Lib/site-packages/pydantic/experimental/__init__.py b/env/Lib/site-packages/pydantic/experimental/__init__.py new file mode 100644 index 0000000..4aa58c6 --- /dev/null +++ b/env/Lib/site-packages/pydantic/experimental/__init__.py @@ -0,0 +1,10 @@ +"""The "experimental" module of pydantic contains potential new features that are subject to change.""" + +import warnings + +from pydantic.warnings import PydanticExperimentalWarning + +warnings.warn( + 'This module is experimental, its contents are subject to change and deprecation.', + category=PydanticExperimentalWarning, +) diff --git a/env/Lib/site-packages/pydantic/experimental/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/pydantic/experimental/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a818f6a9af8b0d294e8c65c5d09d186c045edf0c GIT binary patch literal 592 zcmZuvzfT)66n?%-N>ue!F?X?;h}4F;6=Eo@#86eCpdv*lSk6F$O8LF%*p{5|{WeV>2)h@zL^?bpTc-VOoyQwEjQp1|!# z56(eA2Lus8MmogLVHOO-PDmgCB!^Wlh#H1J>z4t*wI2&3Ac8$;zBuLkeWYu6lB1DB zRE}qBbg0EBL#lf;9}BLWOlYG0mQ@gK}%hqJIW1GJL(={;;7R! z>2sB0>u<^UwMmLM?Wby=m)H)tQBtL+?ft&A6|+anir!M`?4txvZU0Y0xe`=hZZP3a zYSr?D4G%HZX56e7D~t)9Fjh2<7mT)8txngfmQ3iS7PT_Gg4Rt#tS<=gEMlXydBt#_|z17?Vmm##;IKzOlKu;VtvZQ}{Oq zyX)ONB!o;My@7NFuP2Xf2Jdg4_ZdW!##uD2eV<0_^Lj{vf8gC+>E_R!DL>K!5OTJ4 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/experimental/__pycache__/pipeline.cpython-311.pyc b/env/Lib/site-packages/pydantic/experimental/__pycache__/pipeline.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f9ba03b10722e12d20ddd966a45d9573b4ab7185 GIT binary patch literal 38828 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/experimental/pipeline.py b/env/Lib/site-packages/pydantic/experimental/pipeline.py new file mode 100644 index 0000000..29da979 --- /dev/null +++ b/env/Lib/site-packages/pydantic/experimental/pipeline.py @@ -0,0 +1,669 @@ +"""Experimental pipeline API functionality. Be careful with this API, it's subject to change.""" + +from __future__ import annotations + +import datetime +import operator +import re +import sys +from collections import deque +from collections.abc import Container +from dataclasses import dataclass +from decimal import Decimal +from functools import cached_property, partial +from typing import TYPE_CHECKING, Any, Callable, Generic, Pattern, Protocol, TypeVar, Union, overload + +import annotated_types +from typing_extensions import Annotated + +if TYPE_CHECKING: + from pydantic_core import core_schema as cs + + from pydantic import GetCoreSchemaHandler + +from pydantic._internal._internal_dataclass import slots_true as _slots_true + +if sys.version_info < (3, 10): + EllipsisType = type(Ellipsis) +else: + from types import EllipsisType + +__all__ = ['validate_as', 'validate_as_deferred', 'transform'] + +_slots_frozen = {**_slots_true, 'frozen': True} + + +@dataclass(**_slots_frozen) +class _ValidateAs: + tp: type[Any] + strict: bool = False + + +@dataclass +class _ValidateAsDefer: + func: Callable[[], type[Any]] + + @cached_property + def tp(self) -> type[Any]: + return self.func() + + +@dataclass(**_slots_frozen) +class _Transform: + func: Callable[[Any], Any] + + +@dataclass(**_slots_frozen) +class _PipelineOr: + left: _Pipeline[Any, Any] + right: _Pipeline[Any, Any] + + +@dataclass(**_slots_frozen) +class _PipelineAnd: + left: _Pipeline[Any, Any] + right: _Pipeline[Any, Any] + + +@dataclass(**_slots_frozen) +class _Eq: + value: Any + + +@dataclass(**_slots_frozen) +class _NotEq: + value: Any + + +@dataclass(**_slots_frozen) +class _In: + values: Container[Any] + + +@dataclass(**_slots_frozen) +class _NotIn: + values: Container[Any] + + +_ConstraintAnnotation = Union[ + annotated_types.Le, + annotated_types.Ge, + annotated_types.Lt, + annotated_types.Gt, + annotated_types.Len, + annotated_types.MultipleOf, + annotated_types.Timezone, + annotated_types.Interval, + annotated_types.Predicate, + # common predicates not included in annotated_types + _Eq, + _NotEq, + _In, + _NotIn, + # regular expressions + Pattern[str], +] + + +@dataclass(**_slots_frozen) +class _Constraint: + constraint: _ConstraintAnnotation + + +_Step = Union[_ValidateAs, _ValidateAsDefer, _Transform, _PipelineOr, _PipelineAnd, _Constraint] + +_InT = TypeVar('_InT') +_OutT = TypeVar('_OutT') +_NewOutT = TypeVar('_NewOutT') + + +class _FieldTypeMarker: + pass + + +# TODO: ultimately, make this public, see https://github.com/pydantic/pydantic/pull/9459#discussion_r1628197626 +# Also, make this frozen eventually, but that doesn't work right now because of the generic base +# Which attempts to modify __orig_base__ and such. +# We could go with a manual freeze, but that seems overkill for now. +@dataclass(**_slots_true) +class _Pipeline(Generic[_InT, _OutT]): + """Abstract representation of a chain of validation, transformation, and parsing steps.""" + + _steps: tuple[_Step, ...] + + def transform( + self, + func: Callable[[_OutT], _NewOutT], + ) -> _Pipeline[_InT, _NewOutT]: + """Transform the output of the previous step. + + If used as the first step in a pipeline, the type of the field is used. + That is, the transformation is applied to after the value is parsed to the field's type. + """ + return _Pipeline[_InT, _NewOutT](self._steps + (_Transform(func),)) + + @overload + def validate_as(self, tp: type[_NewOutT], *, strict: bool = ...) -> _Pipeline[_InT, _NewOutT]: ... + + @overload + def validate_as(self, tp: EllipsisType, *, strict: bool = ...) -> _Pipeline[_InT, Any]: # type: ignore + ... + + def validate_as(self, tp: type[_NewOutT] | EllipsisType, *, strict: bool = False) -> _Pipeline[_InT, Any]: # type: ignore + """Validate / parse the input into a new type. + + If no type is provided, the type of the field is used. + + Types are parsed in Pydantic's `lax` mode by default, + but you can enable `strict` mode by passing `strict=True`. + """ + if isinstance(tp, EllipsisType): + return _Pipeline[_InT, Any](self._steps + (_ValidateAs(_FieldTypeMarker, strict=strict),)) + return _Pipeline[_InT, _NewOutT](self._steps + (_ValidateAs(tp, strict=strict),)) + + def validate_as_deferred(self, func: Callable[[], type[_NewOutT]]) -> _Pipeline[_InT, _NewOutT]: + """Parse the input into a new type, deferring resolution of the type until the current class + is fully defined. + + This is useful when you need to reference the class in it's own type annotations. + """ + return _Pipeline[_InT, _NewOutT](self._steps + (_ValidateAsDefer(func),)) + + # constraints + @overload + def constrain(self: _Pipeline[_InT, _NewOutGe], constraint: annotated_types.Ge) -> _Pipeline[_InT, _NewOutGe]: ... + + @overload + def constrain(self: _Pipeline[_InT, _NewOutGt], constraint: annotated_types.Gt) -> _Pipeline[_InT, _NewOutGt]: ... + + @overload + def constrain(self: _Pipeline[_InT, _NewOutLe], constraint: annotated_types.Le) -> _Pipeline[_InT, _NewOutLe]: ... + + @overload + def constrain(self: _Pipeline[_InT, _NewOutLt], constraint: annotated_types.Lt) -> _Pipeline[_InT, _NewOutLt]: ... + + @overload + def constrain( + self: _Pipeline[_InT, _NewOutLen], constraint: annotated_types.Len + ) -> _Pipeline[_InT, _NewOutLen]: ... + + @overload + def constrain( + self: _Pipeline[_InT, _NewOutT], constraint: annotated_types.MultipleOf + ) -> _Pipeline[_InT, _NewOutT]: ... + + @overload + def constrain( + self: _Pipeline[_InT, _NewOutDatetime], constraint: annotated_types.Timezone + ) -> _Pipeline[_InT, _NewOutDatetime]: ... + + @overload + def constrain(self: _Pipeline[_InT, _OutT], constraint: annotated_types.Predicate) -> _Pipeline[_InT, _OutT]: ... + + @overload + def constrain( + self: _Pipeline[_InT, _NewOutInterval], constraint: annotated_types.Interval + ) -> _Pipeline[_InT, _NewOutInterval]: ... + + @overload + def constrain(self: _Pipeline[_InT, _OutT], constraint: _Eq) -> _Pipeline[_InT, _OutT]: ... + + @overload + def constrain(self: _Pipeline[_InT, _OutT], constraint: _NotEq) -> _Pipeline[_InT, _OutT]: ... + + @overload + def constrain(self: _Pipeline[_InT, _OutT], constraint: _In) -> _Pipeline[_InT, _OutT]: ... + + @overload + def constrain(self: _Pipeline[_InT, _OutT], constraint: _NotIn) -> _Pipeline[_InT, _OutT]: ... + + @overload + def constrain(self: _Pipeline[_InT, _NewOutT], constraint: Pattern[str]) -> _Pipeline[_InT, _NewOutT]: ... + + def constrain(self, constraint: _ConstraintAnnotation) -> Any: + """Constrain a value to meet a certain condition. + + We support most conditions from `annotated_types`, as well as regular expressions. + + Most of the time you'll be calling a shortcut method like `gt`, `lt`, `len`, etc + so you don't need to call this directly. + """ + return _Pipeline[_InT, _OutT](self._steps + (_Constraint(constraint),)) + + def predicate(self: _Pipeline[_InT, _NewOutT], func: Callable[[_NewOutT], bool]) -> _Pipeline[_InT, _NewOutT]: + """Constrain a value to meet a certain predicate.""" + return self.constrain(annotated_types.Predicate(func)) + + def gt(self: _Pipeline[_InT, _NewOutGt], gt: _NewOutGt) -> _Pipeline[_InT, _NewOutGt]: + """Constrain a value to be greater than a certain value.""" + return self.constrain(annotated_types.Gt(gt)) + + def lt(self: _Pipeline[_InT, _NewOutLt], lt: _NewOutLt) -> _Pipeline[_InT, _NewOutLt]: + """Constrain a value to be less than a certain value.""" + return self.constrain(annotated_types.Lt(lt)) + + def ge(self: _Pipeline[_InT, _NewOutGe], ge: _NewOutGe) -> _Pipeline[_InT, _NewOutGe]: + """Constrain a value to be greater than or equal to a certain value.""" + return self.constrain(annotated_types.Ge(ge)) + + def le(self: _Pipeline[_InT, _NewOutLe], le: _NewOutLe) -> _Pipeline[_InT, _NewOutLe]: + """Constrain a value to be less than or equal to a certain value.""" + return self.constrain(annotated_types.Le(le)) + + def len(self: _Pipeline[_InT, _NewOutLen], min_len: int, max_len: int | None = None) -> _Pipeline[_InT, _NewOutLen]: + """Constrain a value to have a certain length.""" + return self.constrain(annotated_types.Len(min_len, max_len)) + + @overload + def multiple_of(self: _Pipeline[_InT, _NewOutDiv], multiple_of: _NewOutDiv) -> _Pipeline[_InT, _NewOutDiv]: ... + + @overload + def multiple_of(self: _Pipeline[_InT, _NewOutMod], multiple_of: _NewOutMod) -> _Pipeline[_InT, _NewOutMod]: ... + + def multiple_of(self: _Pipeline[_InT, Any], multiple_of: Any) -> _Pipeline[_InT, Any]: + """Constrain a value to be a multiple of a certain number.""" + return self.constrain(annotated_types.MultipleOf(multiple_of)) + + def eq(self: _Pipeline[_InT, _OutT], value: _OutT) -> _Pipeline[_InT, _OutT]: + """Constrain a value to be equal to a certain value.""" + return self.constrain(_Eq(value)) + + def not_eq(self: _Pipeline[_InT, _OutT], value: _OutT) -> _Pipeline[_InT, _OutT]: + """Constrain a value to not be equal to a certain value.""" + return self.constrain(_NotEq(value)) + + def in_(self: _Pipeline[_InT, _OutT], values: Container[_OutT]) -> _Pipeline[_InT, _OutT]: + """Constrain a value to be in a certain set.""" + return self.constrain(_In(values)) + + def not_in(self: _Pipeline[_InT, _OutT], values: Container[_OutT]) -> _Pipeline[_InT, _OutT]: + """Constrain a value to not be in a certain set.""" + return self.constrain(_NotIn(values)) + + # timezone methods + def datetime_tz_naive(self: _Pipeline[_InT, datetime.datetime]) -> _Pipeline[_InT, datetime.datetime]: + return self.constrain(annotated_types.Timezone(None)) + + def datetime_tz_aware(self: _Pipeline[_InT, datetime.datetime]) -> _Pipeline[_InT, datetime.datetime]: + return self.constrain(annotated_types.Timezone(...)) + + def datetime_tz( + self: _Pipeline[_InT, datetime.datetime], tz: datetime.tzinfo + ) -> _Pipeline[_InT, datetime.datetime]: + return self.constrain(annotated_types.Timezone(tz)) # type: ignore + + def datetime_with_tz( + self: _Pipeline[_InT, datetime.datetime], tz: datetime.tzinfo | None + ) -> _Pipeline[_InT, datetime.datetime]: + return self.transform(partial(datetime.datetime.replace, tzinfo=tz)) + + # string methods + def str_lower(self: _Pipeline[_InT, str]) -> _Pipeline[_InT, str]: + return self.transform(str.lower) + + def str_upper(self: _Pipeline[_InT, str]) -> _Pipeline[_InT, str]: + return self.transform(str.upper) + + def str_title(self: _Pipeline[_InT, str]) -> _Pipeline[_InT, str]: + return self.transform(str.title) + + def str_strip(self: _Pipeline[_InT, str]) -> _Pipeline[_InT, str]: + return self.transform(str.strip) + + def str_pattern(self: _Pipeline[_InT, str], pattern: str) -> _Pipeline[_InT, str]: + return self.constrain(re.compile(pattern)) + + def str_contains(self: _Pipeline[_InT, str], substring: str) -> _Pipeline[_InT, str]: + return self.predicate(lambda v: substring in v) + + def str_starts_with(self: _Pipeline[_InT, str], prefix: str) -> _Pipeline[_InT, str]: + return self.predicate(lambda v: v.startswith(prefix)) + + def str_ends_with(self: _Pipeline[_InT, str], suffix: str) -> _Pipeline[_InT, str]: + return self.predicate(lambda v: v.endswith(suffix)) + + # operators + def otherwise(self, other: _Pipeline[_OtherIn, _OtherOut]) -> _Pipeline[_InT | _OtherIn, _OutT | _OtherOut]: + """Combine two validation chains, returning the result of the first chain if it succeeds, and the second chain if it fails.""" + return _Pipeline((_PipelineOr(self, other),)) + + __or__ = otherwise + + def then(self, other: _Pipeline[_OutT, _OtherOut]) -> _Pipeline[_InT, _OtherOut]: + """Pipe the result of one validation chain into another.""" + return _Pipeline((_PipelineAnd(self, other),)) + + __and__ = then + + def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> cs.CoreSchema: + from pydantic_core import core_schema as cs + + queue = deque(self._steps) + + s = None + + while queue: + step = queue.popleft() + s = _apply_step(step, s, handler, source_type) + + s = s or cs.any_schema() + return s + + def __supports_type__(self, _: _OutT) -> bool: + raise NotImplementedError + + +validate_as = _Pipeline[Any, Any](()).validate_as +validate_as_deferred = _Pipeline[Any, Any](()).validate_as_deferred +transform = _Pipeline[Any, Any]((_ValidateAs(_FieldTypeMarker),)).transform + + +def _check_func( + func: Callable[[Any], bool], predicate_err: str | Callable[[], str], s: cs.CoreSchema | None +) -> cs.CoreSchema: + from pydantic_core import core_schema as cs + + def handler(v: Any) -> Any: + if func(v): + return v + raise ValueError(f'Expected {predicate_err if isinstance(predicate_err, str) else predicate_err()}') + + if s is None: + return cs.no_info_plain_validator_function(handler) + else: + return cs.no_info_after_validator_function(handler, s) + + +def _apply_step(step: _Step, s: cs.CoreSchema | None, handler: GetCoreSchemaHandler, source_type: Any) -> cs.CoreSchema: + from pydantic_core import core_schema as cs + + if isinstance(step, _ValidateAs): + s = _apply_parse(s, step.tp, step.strict, handler, source_type) + elif isinstance(step, _ValidateAsDefer): + s = _apply_parse(s, step.tp, False, handler, source_type) + elif isinstance(step, _Transform): + s = _apply_transform(s, step.func, handler) + elif isinstance(step, _Constraint): + s = _apply_constraint(s, step.constraint) + elif isinstance(step, _PipelineOr): + s = cs.union_schema([handler(step.left), handler(step.right)]) + else: + assert isinstance(step, _PipelineAnd) + s = cs.chain_schema([handler(step.left), handler(step.right)]) + return s + + +def _apply_parse( + s: cs.CoreSchema | None, + tp: type[Any], + strict: bool, + handler: GetCoreSchemaHandler, + source_type: Any, +) -> cs.CoreSchema: + from pydantic_core import core_schema as cs + + from pydantic import Strict + + if tp is _FieldTypeMarker: + return handler(source_type) + + if strict: + tp = Annotated[tp, Strict()] # type: ignore + + if s and s['type'] == 'any': + return handler(tp) + else: + return cs.chain_schema([s, handler(tp)]) if s else handler(tp) + + +def _apply_transform( + s: cs.CoreSchema | None, func: Callable[[Any], Any], handler: GetCoreSchemaHandler +) -> cs.CoreSchema: + from pydantic_core import core_schema as cs + + if s is None: + return cs.no_info_plain_validator_function(func) + + if s['type'] == 'str': + if func is str.strip: + s = s.copy() + s['strip_whitespace'] = True + return s + elif func is str.lower: + s = s.copy() + s['to_lower'] = True + return s + elif func is str.upper: + s = s.copy() + s['to_upper'] = True + return s + + return cs.no_info_after_validator_function(func, s) + + +def _apply_constraint( # noqa: C901 + s: cs.CoreSchema | None, constraint: _ConstraintAnnotation +) -> cs.CoreSchema: + """Apply a single constraint to a schema.""" + if isinstance(constraint, annotated_types.Gt): + gt = constraint.gt + if s and s['type'] in {'int', 'float', 'decimal'}: + s = s.copy() + if s['type'] == 'int' and isinstance(gt, int): + s['gt'] = gt + elif s['type'] == 'float' and isinstance(gt, float): + s['gt'] = gt + elif s['type'] == 'decimal' and isinstance(gt, Decimal): + s['gt'] = gt + else: + + def check_gt(v: Any) -> bool: + return v > gt + + s = _check_func(check_gt, f'> {gt}', s) + elif isinstance(constraint, annotated_types.Ge): + ge = constraint.ge + if s and s['type'] in {'int', 'float', 'decimal'}: + s = s.copy() + if s['type'] == 'int' and isinstance(ge, int): + s['ge'] = ge + elif s['type'] == 'float' and isinstance(ge, float): + s['ge'] = ge + elif s['type'] == 'decimal' and isinstance(ge, Decimal): + s['ge'] = ge + + def check_ge(v: Any) -> bool: + return v >= ge + + s = _check_func(check_ge, f'>= {ge}', s) + elif isinstance(constraint, annotated_types.Lt): + lt = constraint.lt + if s and s['type'] in {'int', 'float', 'decimal'}: + s = s.copy() + if s['type'] == 'int' and isinstance(lt, int): + s['lt'] = lt + elif s['type'] == 'float' and isinstance(lt, float): + s['lt'] = lt + elif s['type'] == 'decimal' and isinstance(lt, Decimal): + s['lt'] = lt + + def check_lt(v: Any) -> bool: + return v < lt + + s = _check_func(check_lt, f'< {lt}', s) + elif isinstance(constraint, annotated_types.Le): + le = constraint.le + if s and s['type'] in {'int', 'float', 'decimal'}: + s = s.copy() + if s['type'] == 'int' and isinstance(le, int): + s['le'] = le + elif s['type'] == 'float' and isinstance(le, float): + s['le'] = le + elif s['type'] == 'decimal' and isinstance(le, Decimal): + s['le'] = le + + def check_le(v: Any) -> bool: + return v <= le + + s = _check_func(check_le, f'<= {le}', s) + elif isinstance(constraint, annotated_types.Len): + min_len = constraint.min_length + max_len = constraint.max_length + + if s and s['type'] in {'str', 'list', 'tuple', 'set', 'frozenset', 'dict'}: + assert ( + s['type'] == 'str' + or s['type'] == 'list' + or s['type'] == 'tuple' + or s['type'] == 'set' + or s['type'] == 'dict' + or s['type'] == 'frozenset' + ) + s = s.copy() + if min_len != 0: + s['min_length'] = min_len + if max_len is not None: + s['max_length'] = max_len + + def check_len(v: Any) -> bool: + if max_len is not None: + return (min_len <= len(v)) and (len(v) <= max_len) + return min_len <= len(v) + + s = _check_func(check_len, f'length >= {min_len} and length <= {max_len}', s) + elif isinstance(constraint, annotated_types.MultipleOf): + multiple_of = constraint.multiple_of + if s and s['type'] in {'int', 'float', 'decimal'}: + s = s.copy() + if s['type'] == 'int' and isinstance(multiple_of, int): + s['multiple_of'] = multiple_of + elif s['type'] == 'float' and isinstance(multiple_of, float): + s['multiple_of'] = multiple_of + elif s['type'] == 'decimal' and isinstance(multiple_of, Decimal): + s['multiple_of'] = multiple_of + + def check_multiple_of(v: Any) -> bool: + return v % multiple_of == 0 + + s = _check_func(check_multiple_of, f'% {multiple_of} == 0', s) + elif isinstance(constraint, annotated_types.Timezone): + tz = constraint.tz + + if tz is ...: + if s and s['type'] == 'datetime': + s = s.copy() + s['tz_constraint'] = 'aware' + else: + + def check_tz_aware(v: object) -> bool: + assert isinstance(v, datetime.datetime) + return v.tzinfo is not None + + s = _check_func(check_tz_aware, 'timezone aware', s) + elif tz is None: + if s and s['type'] == 'datetime': + s = s.copy() + s['tz_constraint'] = 'naive' + else: + + def check_tz_naive(v: object) -> bool: + assert isinstance(v, datetime.datetime) + return v.tzinfo is None + + s = _check_func(check_tz_naive, 'timezone naive', s) + else: + raise NotImplementedError('Constraining to a specific timezone is not yet supported') + elif isinstance(constraint, annotated_types.Interval): + if constraint.ge: + s = _apply_constraint(s, annotated_types.Ge(constraint.ge)) + if constraint.gt: + s = _apply_constraint(s, annotated_types.Gt(constraint.gt)) + if constraint.le: + s = _apply_constraint(s, annotated_types.Le(constraint.le)) + if constraint.lt: + s = _apply_constraint(s, annotated_types.Lt(constraint.lt)) + assert s is not None + elif isinstance(constraint, annotated_types.Predicate): + func = constraint.func + + if func.__name__ == '': + # attempt to extract the source code for a lambda function + # to use as the function name in error messages + # TODO: is there a better way? should we just not do this? + import inspect + + try: + # remove ')' suffix, can use removesuffix once we drop 3.8 + source = inspect.getsource(func).strip() + if source.endswith(')'): + source = source[:-1] + lambda_source_code = '`' + ''.join(''.join(source.split('lambda ')[1:]).split(':')[1:]).strip() + '`' + except OSError: + # stringified annotations + lambda_source_code = 'lambda' + + s = _check_func(func, lambda_source_code, s) + else: + s = _check_func(func, func.__name__, s) + elif isinstance(constraint, _NotEq): + value = constraint.value + + def check_not_eq(v: Any) -> bool: + return operator.__ne__(v, value) + + s = _check_func(check_not_eq, f'!= {value}', s) + elif isinstance(constraint, _Eq): + value = constraint.value + + def check_eq(v: Any) -> bool: + return operator.__eq__(v, value) + + s = _check_func(check_eq, f'== {value}', s) + elif isinstance(constraint, _In): + values = constraint.values + + def check_in(v: Any) -> bool: + return operator.__contains__(values, v) + + s = _check_func(check_in, f'in {values}', s) + elif isinstance(constraint, _NotIn): + values = constraint.values + + def check_not_in(v: Any) -> bool: + return operator.__not__(operator.__contains__(values, v)) + + s = _check_func(check_not_in, f'not in {values}', s) + else: + assert isinstance(constraint, Pattern) + if s and s['type'] == 'str': + s = s.copy() + s['pattern'] = constraint.pattern + else: + + def check_pattern(v: object) -> bool: + assert isinstance(v, str) + return constraint.match(v) is not None + + s = _check_func(check_pattern, f'~ {constraint.pattern}', s) + return s + + +class _SupportsRange(annotated_types.SupportsLe, annotated_types.SupportsGe, Protocol): + pass + + +class _SupportsLen(Protocol): + def __len__(self) -> int: ... + + +_NewOutGt = TypeVar('_NewOutGt', bound=annotated_types.SupportsGt) +_NewOutGe = TypeVar('_NewOutGe', bound=annotated_types.SupportsGe) +_NewOutLt = TypeVar('_NewOutLt', bound=annotated_types.SupportsLt) +_NewOutLe = TypeVar('_NewOutLe', bound=annotated_types.SupportsLe) +_NewOutLen = TypeVar('_NewOutLen', bound=_SupportsLen) +_NewOutDiv = TypeVar('_NewOutDiv', bound=annotated_types.SupportsDiv) +_NewOutMod = TypeVar('_NewOutMod', bound=annotated_types.SupportsMod) +_NewOutDatetime = TypeVar('_NewOutDatetime', bound=datetime.datetime) +_NewOutInterval = TypeVar('_NewOutInterval', bound=_SupportsRange) +_OtherIn = TypeVar('_OtherIn') +_OtherOut = TypeVar('_OtherOut') diff --git a/env/Lib/site-packages/pydantic/fields.py b/env/Lib/site-packages/pydantic/fields.py new file mode 100644 index 0000000..7b41a4d --- /dev/null +++ b/env/Lib/site-packages/pydantic/fields.py @@ -0,0 +1,1255 @@ +"""Defining fields on models.""" + +from __future__ import annotations as _annotations + +import dataclasses +import inspect +import sys +import typing +from copy import copy +from dataclasses import Field as DataclassField +from functools import cached_property +from typing import Any, ClassVar +from warnings import warn + +import annotated_types +import typing_extensions +from pydantic_core import PydanticUndefined +from typing_extensions import Literal, TypeAlias, Unpack, deprecated + +from . import types +from ._internal import _decorators, _fields, _generics, _internal_dataclass, _repr, _typing_extra, _utils +from .aliases import AliasChoices, AliasPath +from .config import JsonDict +from .errors import PydanticUserError +from .warnings import PydanticDeprecatedSince20 + +if typing.TYPE_CHECKING: + from ._internal._repr import ReprArgs +else: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + +__all__ = 'Field', 'PrivateAttr', 'computed_field' + + +_Unset: Any = PydanticUndefined + +if sys.version_info >= (3, 13): + import warnings + + Deprecated: TypeAlias = warnings.deprecated | deprecated +else: + Deprecated: TypeAlias = deprecated + + +class _FromFieldInfoInputs(typing_extensions.TypedDict, total=False): + """This class exists solely to add type checking for the `**kwargs` in `FieldInfo.from_field`.""" + + annotation: type[Any] | None + default_factory: typing.Callable[[], Any] | None + alias: str | None + alias_priority: int | None + validation_alias: str | AliasPath | AliasChoices | None + serialization_alias: str | None + title: str | None + field_title_generator: typing_extensions.Callable[[str, FieldInfo], str] | None + description: str | None + examples: list[Any] | None + exclude: bool | None + gt: annotated_types.SupportsGt | None + ge: annotated_types.SupportsGe | None + lt: annotated_types.SupportsLt | None + le: annotated_types.SupportsLe | None + multiple_of: float | None + strict: bool | None + min_length: int | None + max_length: int | None + pattern: str | typing.Pattern[str] | None + allow_inf_nan: bool | None + max_digits: int | None + decimal_places: int | None + union_mode: Literal['smart', 'left_to_right'] | None + discriminator: str | types.Discriminator | None + deprecated: Deprecated | str | bool | None + json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None + frozen: bool | None + validate_default: bool | None + repr: bool + init: bool | None + init_var: bool | None + kw_only: bool | None + coerce_numbers_to_str: bool | None + fail_fast: bool | None + + +class _FieldInfoInputs(_FromFieldInfoInputs, total=False): + """This class exists solely to add type checking for the `**kwargs` in `FieldInfo.__init__`.""" + + default: Any + + +class FieldInfo(_repr.Representation): + """This class holds information about a field. + + `FieldInfo` is used for any field definition regardless of whether the [`Field()`][pydantic.fields.Field] + function is explicitly used. + + !!! warning + You generally shouldn't be creating `FieldInfo` directly, you'll only need to use it when accessing + [`BaseModel`][pydantic.main.BaseModel] `.model_fields` internals. + + Attributes: + annotation: The type annotation of the field. + default: The default value of the field. + default_factory: The factory function used to construct the default for the field. + alias: The alias name of the field. + alias_priority: The priority of the field's alias. + validation_alias: The validation alias of the field. + serialization_alias: The serialization alias of the field. + title: The title of the field. + field_title_generator: A callable that takes a field name and returns title for it. + description: The description of the field. + examples: List of examples of the field. + exclude: Whether to exclude the field from the model serialization. + discriminator: Field name or Discriminator for discriminating the type in a tagged union. + deprecated: A deprecation message, an instance of `warnings.deprecated` or the `typing_extensions.deprecated` backport, + or a boolean. If `True`, a default deprecation message will be emitted when accessing the field. + json_schema_extra: A dict or callable to provide extra JSON schema properties. + frozen: Whether the field is frozen. + validate_default: Whether to validate the default value of the field. + repr: Whether to include the field in representation of the model. + init: Whether the field should be included in the constructor of the dataclass. + init_var: Whether the field should _only_ be included in the constructor of the dataclass, and not stored. + kw_only: Whether the field should be a keyword-only argument in the constructor of the dataclass. + metadata: List of metadata constraints. + """ + + annotation: type[Any] | None + default: Any + default_factory: typing.Callable[[], Any] | None + alias: str | None + alias_priority: int | None + validation_alias: str | AliasPath | AliasChoices | None + serialization_alias: str | None + title: str | None + field_title_generator: typing.Callable[[str, FieldInfo], str] | None + description: str | None + examples: list[Any] | None + exclude: bool | None + discriminator: str | types.Discriminator | None + deprecated: Deprecated | str | bool | None + json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None + frozen: bool | None + validate_default: bool | None + repr: bool + init: bool | None + init_var: bool | None + kw_only: bool | None + metadata: list[Any] + + __slots__ = ( + 'annotation', + 'default', + 'default_factory', + 'alias', + 'alias_priority', + 'validation_alias', + 'serialization_alias', + 'title', + 'field_title_generator', + 'description', + 'examples', + 'exclude', + 'discriminator', + 'deprecated', + 'json_schema_extra', + 'frozen', + 'validate_default', + 'repr', + 'init', + 'init_var', + 'kw_only', + 'metadata', + '_attributes_set', + ) + + # used to convert kwargs to metadata/constraints, + # None has a special meaning - these items are collected into a `PydanticGeneralMetadata` + metadata_lookup: ClassVar[dict[str, typing.Callable[[Any], Any] | None]] = { + 'strict': types.Strict, + 'gt': annotated_types.Gt, + 'ge': annotated_types.Ge, + 'lt': annotated_types.Lt, + 'le': annotated_types.Le, + 'multiple_of': annotated_types.MultipleOf, + 'min_length': annotated_types.MinLen, + 'max_length': annotated_types.MaxLen, + 'pattern': None, + 'allow_inf_nan': None, + 'max_digits': None, + 'decimal_places': None, + 'union_mode': None, + 'coerce_numbers_to_str': None, + 'fail_fast': types.FailFast, + } + + def __init__(self, **kwargs: Unpack[_FieldInfoInputs]) -> None: + """This class should generally not be initialized directly; instead, use the `pydantic.fields.Field` function + or one of the constructor classmethods. + + See the signature of `pydantic.fields.Field` for more details about the expected arguments. + """ + self._attributes_set = {k: v for k, v in kwargs.items() if v is not _Unset} + kwargs = {k: _DefaultValues.get(k) if v is _Unset else v for k, v in kwargs.items()} # type: ignore + self.annotation, annotation_metadata = self._extract_metadata(kwargs.get('annotation')) + + default = kwargs.pop('default', PydanticUndefined) + if default is Ellipsis: + self.default = PydanticUndefined + else: + self.default = default + + self.default_factory = kwargs.pop('default_factory', None) + + if self.default is not PydanticUndefined and self.default_factory is not None: + raise TypeError('cannot specify both default and default_factory') + + self.alias = kwargs.pop('alias', None) + self.validation_alias = kwargs.pop('validation_alias', None) + self.serialization_alias = kwargs.pop('serialization_alias', None) + alias_is_set = any(alias is not None for alias in (self.alias, self.validation_alias, self.serialization_alias)) + self.alias_priority = kwargs.pop('alias_priority', None) or 2 if alias_is_set else None + self.title = kwargs.pop('title', None) + self.field_title_generator = kwargs.pop('field_title_generator', None) + self.description = kwargs.pop('description', None) + self.examples = kwargs.pop('examples', None) + self.exclude = kwargs.pop('exclude', None) + self.discriminator = kwargs.pop('discriminator', None) + # For compatibility with FastAPI<=0.110.0, we preserve the existing value if it is not overridden + self.deprecated = kwargs.pop('deprecated', getattr(self, 'deprecated', None)) + self.repr = kwargs.pop('repr', True) + self.json_schema_extra = kwargs.pop('json_schema_extra', None) + self.validate_default = kwargs.pop('validate_default', None) + self.frozen = kwargs.pop('frozen', None) + # currently only used on dataclasses + self.init = kwargs.pop('init', None) + self.init_var = kwargs.pop('init_var', None) + self.kw_only = kwargs.pop('kw_only', None) + + self.metadata = self._collect_metadata(kwargs) + annotation_metadata # type: ignore + + @staticmethod + def from_field(default: Any = PydanticUndefined, **kwargs: Unpack[_FromFieldInfoInputs]) -> FieldInfo: + """Create a new `FieldInfo` object with the `Field` function. + + Args: + default: The default value for the field. Defaults to Undefined. + **kwargs: Additional arguments dictionary. + + Raises: + TypeError: If 'annotation' is passed as a keyword argument. + + Returns: + A new FieldInfo object with the given parameters. + + Example: + This is how you can create a field with default value like this: + + ```python + import pydantic + + class MyModel(pydantic.BaseModel): + foo: int = pydantic.Field(4) + ``` + """ + if 'annotation' in kwargs: + raise TypeError('"annotation" is not permitted as a Field keyword argument') + return FieldInfo(default=default, **kwargs) + + @staticmethod + def from_annotation(annotation: type[Any]) -> FieldInfo: + """Creates a `FieldInfo` instance from a bare annotation. + + This function is used internally to create a `FieldInfo` from a bare annotation like this: + + ```python + import pydantic + + class MyModel(pydantic.BaseModel): + foo: int # <-- like this + ``` + + We also account for the case where the annotation can be an instance of `Annotated` and where + one of the (not first) arguments in `Annotated` is an instance of `FieldInfo`, e.g.: + + ```python + import annotated_types + from typing_extensions import Annotated + + import pydantic + + class MyModel(pydantic.BaseModel): + foo: Annotated[int, annotated_types.Gt(42)] + bar: Annotated[int, pydantic.Field(gt=42)] + ``` + + Args: + annotation: An annotation object. + + Returns: + An instance of the field metadata. + """ + final = False + if _typing_extra.is_finalvar(annotation): + final = True + if annotation is not typing_extensions.Final: + annotation = typing_extensions.get_args(annotation)[0] + + if _typing_extra.is_annotated(annotation): + first_arg, *extra_args = typing_extensions.get_args(annotation) + if _typing_extra.is_finalvar(first_arg): + final = True + field_info_annotations = [a for a in extra_args if isinstance(a, FieldInfo)] + field_info = FieldInfo.merge_field_infos(*field_info_annotations, annotation=first_arg) + if field_info: + new_field_info = copy(field_info) + new_field_info.annotation = first_arg + new_field_info.frozen = final or field_info.frozen + metadata: list[Any] = [] + for a in extra_args: + if _typing_extra.is_deprecated_instance(a): + new_field_info.deprecated = a.message + elif not isinstance(a, FieldInfo): + metadata.append(a) + else: + metadata.extend(a.metadata) + new_field_info.metadata = metadata + return new_field_info + + return FieldInfo(annotation=annotation, frozen=final or None) # pyright: ignore[reportArgumentType] + + @staticmethod + def from_annotated_attribute(annotation: type[Any], default: Any) -> FieldInfo: + """Create `FieldInfo` from an annotation with a default value. + + This is used in cases like the following: + + ```python + import annotated_types + from typing_extensions import Annotated + + import pydantic + + class MyModel(pydantic.BaseModel): + foo: int = 4 # <-- like this + bar: Annotated[int, annotated_types.Gt(4)] = 4 # <-- or this + spam: Annotated[int, pydantic.Field(gt=4)] = 4 # <-- or this + ``` + + Args: + annotation: The type annotation of the field. + default: The default value of the field. + + Returns: + A field object with the passed values. + """ + if annotation is default: + raise PydanticUserError( + 'Error when building FieldInfo from annotated attribute. ' + "Make sure you don't have any field name clashing with a type annotation ", + code='unevaluable-type-annotation', + ) + + final = False + if _typing_extra.is_finalvar(annotation): + final = True + if annotation is not typing_extensions.Final: + annotation = typing_extensions.get_args(annotation)[0] + + if isinstance(default, FieldInfo): + default.annotation, annotation_metadata = FieldInfo._extract_metadata(annotation) # pyright: ignore[reportArgumentType] + default.metadata += annotation_metadata + default = default.merge_field_infos( + *[x for x in annotation_metadata if isinstance(x, FieldInfo)], default, annotation=default.annotation + ) + default.frozen = final or default.frozen + return default + elif isinstance(default, dataclasses.Field): + init_var = False + if annotation is dataclasses.InitVar: + init_var = True + annotation = typing.cast(Any, Any) + elif isinstance(annotation, dataclasses.InitVar): + init_var = True + annotation = annotation.type + pydantic_field = FieldInfo._from_dataclass_field(default) + pydantic_field.annotation, annotation_metadata = FieldInfo._extract_metadata(annotation) # pyright: ignore[reportArgumentType] + pydantic_field.metadata += annotation_metadata + pydantic_field = pydantic_field.merge_field_infos( + *[x for x in annotation_metadata if isinstance(x, FieldInfo)], + pydantic_field, + annotation=pydantic_field.annotation, + ) + pydantic_field.frozen = final or pydantic_field.frozen + pydantic_field.init_var = init_var + pydantic_field.init = getattr(default, 'init', None) + pydantic_field.kw_only = getattr(default, 'kw_only', None) + return pydantic_field + else: + if _typing_extra.is_annotated(annotation): + first_arg, *extra_args = typing_extensions.get_args(annotation) + field_infos = [a for a in extra_args if isinstance(a, FieldInfo)] + field_info = FieldInfo.merge_field_infos(*field_infos, annotation=first_arg, default=default) + metadata: list[Any] = [] + for a in extra_args: + if _typing_extra.is_deprecated_instance(a): + field_info.deprecated = a.message + elif not isinstance(a, FieldInfo): + metadata.append(a) + else: + metadata.extend(a.metadata) + field_info.metadata = metadata + return field_info + + return FieldInfo(annotation=annotation, default=default, frozen=final or None) # pyright: ignore[reportArgumentType] + + @staticmethod + def merge_field_infos(*field_infos: FieldInfo, **overrides: Any) -> FieldInfo: + """Merge `FieldInfo` instances keeping only explicitly set attributes. + + Later `FieldInfo` instances override earlier ones. + + Returns: + FieldInfo: A merged FieldInfo instance. + """ + flattened_field_infos: list[FieldInfo] = [] + for field_info in field_infos: + flattened_field_infos.extend(x for x in field_info.metadata if isinstance(x, FieldInfo)) + flattened_field_infos.append(field_info) + field_infos = tuple(flattened_field_infos) + if len(field_infos) == 1: + # No merging necessary, but we still need to make a copy and apply the overrides + field_info = copy(field_infos[0]) + field_info._attributes_set.update(overrides) + + default_override = overrides.pop('default', PydanticUndefined) + if default_override is Ellipsis: + default_override = PydanticUndefined + if default_override is not PydanticUndefined: + field_info.default = default_override + + for k, v in overrides.items(): + setattr(field_info, k, v) + return field_info # type: ignore + + new_kwargs: dict[str, Any] = {} + metadata = {} + for field_info in field_infos: + new_kwargs.update(field_info._attributes_set) + for x in field_info.metadata: + if not isinstance(x, FieldInfo): + metadata[type(x)] = x + new_kwargs.update(overrides) + field_info = FieldInfo(**new_kwargs) + field_info.metadata = list(metadata.values()) + return field_info + + @staticmethod + def _from_dataclass_field(dc_field: DataclassField[Any]) -> FieldInfo: + """Return a new `FieldInfo` instance from a `dataclasses.Field` instance. + + Args: + dc_field: The `dataclasses.Field` instance to convert. + + Returns: + The corresponding `FieldInfo` instance. + + Raises: + TypeError: If any of the `FieldInfo` kwargs does not match the `dataclass.Field` kwargs. + """ + default = dc_field.default + if default is dataclasses.MISSING: + default = PydanticUndefined + + if dc_field.default_factory is dataclasses.MISSING: + default_factory: typing.Callable[[], Any] | None = None + else: + default_factory = dc_field.default_factory + + # use the `Field` function so in correct kwargs raise the correct `TypeError` + dc_field_metadata = {k: v for k, v in dc_field.metadata.items() if k in _FIELD_ARG_NAMES} + return Field(default=default, default_factory=default_factory, repr=dc_field.repr, **dc_field_metadata) + + @staticmethod + def _extract_metadata(annotation: type[Any] | None) -> tuple[type[Any] | None, list[Any]]: + """Tries to extract metadata/constraints from an annotation if it uses `Annotated`. + + Args: + annotation: The type hint annotation for which metadata has to be extracted. + + Returns: + A tuple containing the extracted metadata type and the list of extra arguments. + """ + if annotation is not None: + if _typing_extra.is_annotated(annotation): + first_arg, *extra_args = typing_extensions.get_args(annotation) + return first_arg, list(extra_args) + + return annotation, [] + + @staticmethod + def _collect_metadata(kwargs: dict[str, Any]) -> list[Any]: + """Collect annotations from kwargs. + + Args: + kwargs: Keyword arguments passed to the function. + + Returns: + A list of metadata objects - a combination of `annotated_types.BaseMetadata` and + `PydanticMetadata`. + """ + metadata: list[Any] = [] + general_metadata = {} + for key, value in list(kwargs.items()): + try: + marker = FieldInfo.metadata_lookup[key] + except KeyError: + continue + + del kwargs[key] + if value is not None: + if marker is None: + general_metadata[key] = value + else: + metadata.append(marker(value)) + if general_metadata: + metadata.append(_fields.pydantic_general_metadata(**general_metadata)) + return metadata + + @property + def deprecation_message(self) -> str | None: + """The deprecation message to be emitted, or `None` if not set.""" + if self.deprecated is None: + return None + if isinstance(self.deprecated, bool): + return 'deprecated' if self.deprecated else None + return self.deprecated if isinstance(self.deprecated, str) else self.deprecated.message + + def get_default(self, *, call_default_factory: bool = False) -> Any: + """Get the default value. + + We expose an option for whether to call the default_factory (if present), as calling it may + result in side effects that we want to avoid. However, there are times when it really should + be called (namely, when instantiating a model via `model_construct`). + + Args: + call_default_factory: Whether to call the default_factory or not. Defaults to `False`. + + Returns: + The default value, calling the default factory if requested or `None` if not set. + """ + if self.default_factory is None: + return _utils.smart_deepcopy(self.default) + elif call_default_factory: + return self.default_factory() + else: + return None + + def is_required(self) -> bool: + """Check if the field is required (i.e., does not have a default value or factory). + + Returns: + `True` if the field is required, `False` otherwise. + """ + return self.default is PydanticUndefined and self.default_factory is None + + def rebuild_annotation(self) -> Any: + """Attempts to rebuild the original annotation for use in function signatures. + + If metadata is present, it adds it to the original annotation using + `Annotated`. Otherwise, it returns the original annotation as-is. + + Note that because the metadata has been flattened, the original annotation + may not be reconstructed exactly as originally provided, e.g. if the original + type had unrecognized annotations, or was annotated with a call to `pydantic.Field`. + + Returns: + The rebuilt annotation. + """ + if not self.metadata: + return self.annotation + else: + # Annotated arguments must be a tuple + return typing_extensions.Annotated[(self.annotation, *self.metadata)] # type: ignore + + def apply_typevars_map(self, typevars_map: dict[Any, Any] | None, types_namespace: dict[str, Any] | None) -> None: + """Apply a `typevars_map` to the annotation. + + This method is used when analyzing parametrized generic types to replace typevars with their concrete types. + + This method applies the `typevars_map` to the annotation in place. + + Args: + typevars_map: A dictionary mapping type variables to their concrete types. + types_namespace (dict | None): A dictionary containing related types to the annotated type. + + See Also: + pydantic._internal._generics.replace_types is used for replacing the typevars with + their concrete types. + """ + annotation = _typing_extra.eval_type_lenient(self.annotation, types_namespace) + self.annotation = _generics.replace_types(annotation, typevars_map) + + def __repr_args__(self) -> ReprArgs: + yield 'annotation', _repr.PlainRepr(_repr.display_as_type(self.annotation)) + yield 'required', self.is_required() + + for s in self.__slots__: + if s == '_attributes_set': + continue + if s == 'annotation': + continue + elif s == 'metadata' and not self.metadata: + continue + elif s == 'repr' and self.repr is True: + continue + if s == 'frozen' and self.frozen is False: + continue + if s == 'validation_alias' and self.validation_alias == self.alias: + continue + if s == 'serialization_alias' and self.serialization_alias == self.alias: + continue + if s == 'default' and self.default is not PydanticUndefined: + yield 'default', self.default + elif s == 'default_factory' and self.default_factory is not None: + yield 'default_factory', _repr.PlainRepr(_repr.display_as_type(self.default_factory)) + else: + value = getattr(self, s) + if value is not None and value is not PydanticUndefined: + yield s, value + + +class _EmptyKwargs(typing_extensions.TypedDict): + """This class exists solely to ensure that type checking warns about passing `**extra` in `Field`.""" + + +_DefaultValues = dict( + default=..., + default_factory=None, + alias=None, + alias_priority=None, + validation_alias=None, + serialization_alias=None, + title=None, + description=None, + examples=None, + exclude=None, + discriminator=None, + json_schema_extra=None, + frozen=None, + validate_default=None, + repr=True, + init=None, + init_var=None, + kw_only=None, + pattern=None, + strict=None, + gt=None, + ge=None, + lt=None, + le=None, + multiple_of=None, + allow_inf_nan=None, + max_digits=None, + decimal_places=None, + min_length=None, + max_length=None, + coerce_numbers_to_str=None, +) + + +def Field( # noqa: C901 + default: Any = PydanticUndefined, + *, + default_factory: typing.Callable[[], Any] | None = _Unset, + alias: str | None = _Unset, + alias_priority: int | None = _Unset, + validation_alias: str | AliasPath | AliasChoices | None = _Unset, + serialization_alias: str | None = _Unset, + title: str | None = _Unset, + field_title_generator: typing_extensions.Callable[[str, FieldInfo], str] | None = _Unset, + description: str | None = _Unset, + examples: list[Any] | None = _Unset, + exclude: bool | None = _Unset, + discriminator: str | types.Discriminator | None = _Unset, + deprecated: Deprecated | str | bool | None = _Unset, + json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None = _Unset, + frozen: bool | None = _Unset, + validate_default: bool | None = _Unset, + repr: bool = _Unset, + init: bool | None = _Unset, + init_var: bool | None = _Unset, + kw_only: bool | None = _Unset, + pattern: str | typing.Pattern[str] | None = _Unset, + strict: bool | None = _Unset, + coerce_numbers_to_str: bool | None = _Unset, + gt: annotated_types.SupportsGt | None = _Unset, + ge: annotated_types.SupportsGe | None = _Unset, + lt: annotated_types.SupportsLt | None = _Unset, + le: annotated_types.SupportsLe | None = _Unset, + multiple_of: float | None = _Unset, + allow_inf_nan: bool | None = _Unset, + max_digits: int | None = _Unset, + decimal_places: int | None = _Unset, + min_length: int | None = _Unset, + max_length: int | None = _Unset, + union_mode: Literal['smart', 'left_to_right'] = _Unset, + fail_fast: bool | None = _Unset, + **extra: Unpack[_EmptyKwargs], +) -> Any: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/fields + + Create a field for objects that can be configured. + + Used to provide extra information about a field, either for the model schema or complex validation. Some arguments + apply only to number fields (`int`, `float`, `Decimal`) and some apply only to `str`. + + Note: + - Any `_Unset` objects will be replaced by the corresponding value defined in the `_DefaultValues` dictionary. If a key for the `_Unset` object is not found in the `_DefaultValues` dictionary, it will default to `None` + + Args: + default: Default value if the field is not set. + default_factory: A callable to generate the default value, such as :func:`~datetime.utcnow`. + alias: The name to use for the attribute when validating or serializing by alias. + This is often used for things like converting between snake and camel case. + alias_priority: Priority of the alias. This affects whether an alias generator is used. + validation_alias: Like `alias`, but only affects validation, not serialization. + serialization_alias: Like `alias`, but only affects serialization, not validation. + title: Human-readable title. + field_title_generator: A callable that takes a field name and returns title for it. + description: Human-readable description. + examples: Example values for this field. + exclude: Whether to exclude the field from the model serialization. + discriminator: Field name or Discriminator for discriminating the type in a tagged union. + deprecated: A deprecation message, an instance of `warnings.deprecated` or the `typing_extensions.deprecated` backport, + or a boolean. If `True`, a default deprecation message will be emitted when accessing the field. + json_schema_extra: A dict or callable to provide extra JSON schema properties. + frozen: Whether the field is frozen. If true, attempts to change the value on an instance will raise an error. + validate_default: If `True`, apply validation to the default value every time you create an instance. + Otherwise, for performance reasons, the default value of the field is trusted and not validated. + repr: A boolean indicating whether to include the field in the `__repr__` output. + init: Whether the field should be included in the constructor of the dataclass. + (Only applies to dataclasses.) + init_var: Whether the field should _only_ be included in the constructor of the dataclass. + (Only applies to dataclasses.) + kw_only: Whether the field should be a keyword-only argument in the constructor of the dataclass. + (Only applies to dataclasses.) + coerce_numbers_to_str: Whether to enable coercion of any `Number` type to `str` (not applicable in `strict` mode). + strict: If `True`, strict validation is applied to the field. + See [Strict Mode](../concepts/strict_mode.md) for details. + gt: Greater than. If set, value must be greater than this. Only applicable to numbers. + ge: Greater than or equal. If set, value must be greater than or equal to this. Only applicable to numbers. + lt: Less than. If set, value must be less than this. Only applicable to numbers. + le: Less than or equal. If set, value must be less than or equal to this. Only applicable to numbers. + multiple_of: Value must be a multiple of this. Only applicable to numbers. + min_length: Minimum length for iterables. + max_length: Maximum length for iterables. + pattern: Pattern for strings (a regular expression). + allow_inf_nan: Allow `inf`, `-inf`, `nan`. Only applicable to numbers. + max_digits: Maximum number of allow digits for strings. + decimal_places: Maximum number of decimal places allowed for numbers. + union_mode: The strategy to apply when validating a union. Can be `smart` (the default), or `left_to_right`. + See [Union Mode](../concepts/unions.md#union-modes) for details. + fail_fast: If `True`, validation will stop on the first error. If `False`, all validation errors will be collected. + This option can be applied only to iterable types (list, tuple, set, and frozenset). + extra: (Deprecated) Extra fields that will be included in the JSON schema. + + !!! warning Deprecated + The `extra` kwargs is deprecated. Use `json_schema_extra` instead. + + Returns: + A new [`FieldInfo`][pydantic.fields.FieldInfo]. The return annotation is `Any` so `Field` can be used on + type-annotated fields without causing a type error. + """ + # Check deprecated and removed params from V1. This logic should eventually be removed. + const = extra.pop('const', None) # type: ignore + if const is not None: + raise PydanticUserError('`const` is removed, use `Literal` instead', code='removed-kwargs') + + min_items = extra.pop('min_items', None) # type: ignore + if min_items is not None: + warn('`min_items` is deprecated and will be removed, use `min_length` instead', DeprecationWarning) + if min_length in (None, _Unset): + min_length = min_items # type: ignore + + max_items = extra.pop('max_items', None) # type: ignore + if max_items is not None: + warn('`max_items` is deprecated and will be removed, use `max_length` instead', DeprecationWarning) + if max_length in (None, _Unset): + max_length = max_items # type: ignore + + unique_items = extra.pop('unique_items', None) # type: ignore + if unique_items is not None: + raise PydanticUserError( + ( + '`unique_items` is removed, use `Set` instead' + '(this feature is discussed in https://github.com/pydantic/pydantic-core/issues/296)' + ), + code='removed-kwargs', + ) + + allow_mutation = extra.pop('allow_mutation', None) # type: ignore + if allow_mutation is not None: + warn('`allow_mutation` is deprecated and will be removed. use `frozen` instead', DeprecationWarning) + if allow_mutation is False: + frozen = True + + regex = extra.pop('regex', None) # type: ignore + if regex is not None: + raise PydanticUserError('`regex` is removed. use `pattern` instead', code='removed-kwargs') + + if extra: + warn( + 'Using extra keyword arguments on `Field` is deprecated and will be removed.' + ' Use `json_schema_extra` instead.' + f' (Extra keys: {", ".join(k.__repr__() for k in extra.keys())})', + DeprecationWarning, + ) + if not json_schema_extra or json_schema_extra is _Unset: + json_schema_extra = extra # type: ignore + + if ( + validation_alias + and validation_alias is not _Unset + and not isinstance(validation_alias, (str, AliasChoices, AliasPath)) + ): + raise TypeError('Invalid `validation_alias` type. it should be `str`, `AliasChoices`, or `AliasPath`') + + if serialization_alias in (_Unset, None) and isinstance(alias, str): + serialization_alias = alias + + if validation_alias in (_Unset, None): + validation_alias = alias + + include = extra.pop('include', None) # type: ignore + if include is not None: + warn('`include` is deprecated and does nothing. It will be removed, use `exclude` instead', DeprecationWarning) + + return FieldInfo.from_field( + default, + default_factory=default_factory, + alias=alias, + alias_priority=alias_priority, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + title=title, + field_title_generator=field_title_generator, + description=description, + examples=examples, + exclude=exclude, + discriminator=discriminator, + deprecated=deprecated, + json_schema_extra=json_schema_extra, + frozen=frozen, + pattern=pattern, + validate_default=validate_default, + repr=repr, + init=init, + init_var=init_var, + kw_only=kw_only, + coerce_numbers_to_str=coerce_numbers_to_str, + strict=strict, + gt=gt, + ge=ge, + lt=lt, + le=le, + multiple_of=multiple_of, + min_length=min_length, + max_length=max_length, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + union_mode=union_mode, + fail_fast=fail_fast, + ) + + +_FIELD_ARG_NAMES = set(inspect.signature(Field).parameters) +_FIELD_ARG_NAMES.remove('extra') # do not include the varkwargs parameter + + +class ModelPrivateAttr(_repr.Representation): + """A descriptor for private attributes in class models. + + !!! warning + You generally shouldn't be creating `ModelPrivateAttr` instances directly, instead use + `pydantic.fields.PrivateAttr`. (This is similar to `FieldInfo` vs. `Field`.) + + Attributes: + default: The default value of the attribute if not provided. + default_factory: A callable function that generates the default value of the + attribute if not provided. + """ + + __slots__ = 'default', 'default_factory' + + def __init__( + self, default: Any = PydanticUndefined, *, default_factory: typing.Callable[[], Any] | None = None + ) -> None: + self.default = default + self.default_factory = default_factory + + if not typing.TYPE_CHECKING: + # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access + + def __getattr__(self, item: str) -> Any: + """This function improves compatibility with custom descriptors by ensuring delegation happens + as expected when the default value of a private attribute is a descriptor. + """ + if item in {'__get__', '__set__', '__delete__'}: + if hasattr(self.default, item): + return getattr(self.default, item) + raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') + + def __set_name__(self, cls: type[Any], name: str) -> None: + """Preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487.""" + if self.default is PydanticUndefined: + return + if not hasattr(self.default, '__set_name__'): + return + set_name = self.default.__set_name__ + if callable(set_name): + set_name(cls, name) + + def get_default(self) -> Any: + """Retrieve the default value of the object. + + If `self.default_factory` is `None`, the method will return a deep copy of the `self.default` object. + + If `self.default_factory` is not `None`, it will call `self.default_factory` and return the value returned. + + Returns: + The default value of the object. + """ + return _utils.smart_deepcopy(self.default) if self.default_factory is None else self.default_factory() + + def __eq__(self, other: Any) -> bool: + return isinstance(other, self.__class__) and (self.default, self.default_factory) == ( + other.default, + other.default_factory, + ) + + +def PrivateAttr( + default: Any = PydanticUndefined, + *, + default_factory: typing.Callable[[], Any] | None = None, + init: Literal[False] = False, +) -> Any: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/models/#private-model-attributes + + Indicates that an attribute is intended for private use and not handled during normal validation/serialization. + + Private attributes are not validated by Pydantic, so it's up to you to ensure they are used in a type-safe manner. + + Private attributes are stored in `__private_attributes__` on the model. + + Args: + default: The attribute's default value. Defaults to Undefined. + default_factory: Callable that will be + called when a default value is needed for this attribute. + If both `default` and `default_factory` are set, an error will be raised. + init: Whether the attribute should be included in the constructor of the dataclass. Always `False`. + + Returns: + An instance of [`ModelPrivateAttr`][pydantic.fields.ModelPrivateAttr] class. + + Raises: + ValueError: If both `default` and `default_factory` are set. + """ + if default is not PydanticUndefined and default_factory is not None: + raise TypeError('cannot specify both default and default_factory') + + return ModelPrivateAttr( + default, + default_factory=default_factory, + ) + + +@dataclasses.dataclass(**_internal_dataclass.slots_true) +class ComputedFieldInfo: + """A container for data from `@computed_field` so that we can access it while building the pydantic-core schema. + + Attributes: + decorator_repr: A class variable representing the decorator string, '@computed_field'. + wrapped_property: The wrapped computed field property. + return_type: The type of the computed field property's return value. + alias: The alias of the property to be used during serialization. + alias_priority: The priority of the alias. This affects whether an alias generator is used. + title: Title of the computed field to include in the serialization JSON schema. + field_title_generator: A callable that takes a field name and returns title for it. + description: Description of the computed field to include in the serialization JSON schema. + deprecated: A deprecation message, an instance of `warnings.deprecated` or the `typing_extensions.deprecated` backport, + or a boolean. If `True`, a default deprecation message will be emitted when accessing the field. + examples: Example values of the computed field to include in the serialization JSON schema. + json_schema_extra: A dict or callable to provide extra JSON schema properties. + repr: A boolean indicating whether to include the field in the __repr__ output. + """ + + decorator_repr: ClassVar[str] = '@computed_field' + wrapped_property: property + return_type: Any + alias: str | None + alias_priority: int | None + title: str | None + field_title_generator: typing.Callable[[str, ComputedFieldInfo], str] | None + description: str | None + deprecated: Deprecated | str | bool | None + examples: list[Any] | None + json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None + repr: bool + + @property + def deprecation_message(self) -> str | None: + """The deprecation message to be emitted, or `None` if not set.""" + if self.deprecated is None: + return None + if isinstance(self.deprecated, bool): + return 'deprecated' if self.deprecated else None + return self.deprecated if isinstance(self.deprecated, str) else self.deprecated.message + + +def _wrapped_property_is_private(property_: cached_property | property) -> bool: # type: ignore + """Returns true if provided property is private, False otherwise.""" + wrapped_name: str = '' + + if isinstance(property_, property): + wrapped_name = getattr(property_.fget, '__name__', '') + elif isinstance(property_, cached_property): # type: ignore + wrapped_name = getattr(property_.func, '__name__', '') # type: ignore + + return wrapped_name.startswith('_') and not wrapped_name.startswith('__') + + +# this should really be `property[T], cached_property[T]` but property is not generic unlike cached_property +# See https://github.com/python/typing/issues/985 and linked issues +PropertyT = typing.TypeVar('PropertyT') + + +@typing.overload +def computed_field( + *, + alias: str | None = None, + alias_priority: int | None = None, + title: str | None = None, + field_title_generator: typing.Callable[[str, ComputedFieldInfo], str] | None = None, + description: str | None = None, + deprecated: Deprecated | str | bool | None = None, + examples: list[Any] | None = None, + json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None = None, + repr: bool = True, + return_type: Any = PydanticUndefined, +) -> typing.Callable[[PropertyT], PropertyT]: ... + + +@typing.overload +def computed_field(__func: PropertyT) -> PropertyT: ... + + +def computed_field( + func: PropertyT | None = None, + /, + *, + alias: str | None = None, + alias_priority: int | None = None, + title: str | None = None, + field_title_generator: typing.Callable[[str, ComputedFieldInfo], str] | None = None, + description: str | None = None, + deprecated: Deprecated | str | bool | None = None, + examples: list[Any] | None = None, + json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None = None, + repr: bool | None = None, + return_type: Any = PydanticUndefined, +) -> PropertyT | typing.Callable[[PropertyT], PropertyT]: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/fields#the-computed_field-decorator + + Decorator to include `property` and `cached_property` when serializing models or dataclasses. + + This is useful for fields that are computed from other fields, or for fields that are expensive to compute and should be cached. + + ```py + from pydantic import BaseModel, computed_field + + class Rectangle(BaseModel): + width: int + length: int + + @computed_field + @property + def area(self) -> int: + return self.width * self.length + + print(Rectangle(width=3, length=2).model_dump()) + #> {'width': 3, 'length': 2, 'area': 6} + ``` + + If applied to functions not yet decorated with `@property` or `@cached_property`, the function is + automatically wrapped with `property`. Although this is more concise, you will lose IntelliSense in your IDE, + and confuse static type checkers, thus explicit use of `@property` is recommended. + + !!! warning "Mypy Warning" + Even with the `@property` or `@cached_property` applied to your function before `@computed_field`, + mypy may throw a `Decorated property not supported` error. + See [mypy issue #1362](https://github.com/python/mypy/issues/1362), for more information. + To avoid this error message, add `# type: ignore[misc]` to the `@computed_field` line. + + [pyright](https://github.com/microsoft/pyright) supports `@computed_field` without error. + + ```py + import random + + from pydantic import BaseModel, computed_field + + class Square(BaseModel): + width: float + + @computed_field + def area(self) -> float: # converted to a `property` by `computed_field` + return round(self.width**2, 2) + + @area.setter + def area(self, new_area: float) -> None: + self.width = new_area**0.5 + + @computed_field(alias='the magic number', repr=False) + def random_number(self) -> int: + return random.randint(0, 1_000) + + square = Square(width=1.3) + + # `random_number` does not appear in representation + print(repr(square)) + #> Square(width=1.3, area=1.69) + + print(square.random_number) + #> 3 + + square.area = 4 + + print(square.model_dump_json(by_alias=True)) + #> {"width":2.0,"area":4.0,"the magic number":3} + ``` + + !!! warning "Overriding with `computed_field`" + You can't override a field from a parent class with a `computed_field` in the child class. + `mypy` complains about this behavior if allowed, and `dataclasses` doesn't allow this pattern either. + See the example below: + + ```py + from pydantic import BaseModel, computed_field + + class Parent(BaseModel): + a: str + + try: + + class Child(Parent): + @computed_field + @property + def a(self) -> str: + return 'new a' + + except ValueError as e: + print(repr(e)) + #> ValueError("you can't override a field with a computed field") + ``` + + Private properties decorated with `@computed_field` have `repr=False` by default. + + ```py + from functools import cached_property + + from pydantic import BaseModel, computed_field + + class Model(BaseModel): + foo: int + + @computed_field + @cached_property + def _private_cached_property(self) -> int: + return -self.foo + + @computed_field + @property + def _private_property(self) -> int: + return -self.foo + + m = Model(foo=1) + print(repr(m)) + #> M(foo=1) + ``` + + Args: + func: the function to wrap. + alias: alias to use when serializing this computed field, only used when `by_alias=True` + alias_priority: priority of the alias. This affects whether an alias generator is used + title: Title to use when including this computed field in JSON Schema + field_title_generator: A callable that takes a field name and returns title for it. + description: Description to use when including this computed field in JSON Schema, defaults to the function's + docstring + deprecated: A deprecation message (or an instance of `warnings.deprecated` or the `typing_extensions.deprecated` backport). + to be emitted when accessing the field. Or a boolean. This will automatically be set if the property is decorated with the + `deprecated` decorator. + examples: Example values to use when including this computed field in JSON Schema + json_schema_extra: A dict or callable to provide extra JSON schema properties. + repr: whether to include this computed field in model repr. + Default is `False` for private properties and `True` for public properties. + return_type: optional return for serialization logic to expect when serializing to JSON, if included + this must be correct, otherwise a `TypeError` is raised. + If you don't include a return type Any is used, which does runtime introspection to handle arbitrary + objects. + + Returns: + A proxy wrapper for the property. + """ + + def dec(f: Any) -> Any: + nonlocal description, deprecated, return_type, alias_priority + unwrapped = _decorators.unwrap_wrapped_function(f) + + if description is None and unwrapped.__doc__: + description = inspect.cleandoc(unwrapped.__doc__) + + if deprecated is None and hasattr(unwrapped, '__deprecated__'): + deprecated = unwrapped.__deprecated__ + + # if the function isn't already decorated with `@property` (or another descriptor), then we wrap it now + f = _decorators.ensure_property(f) + alias_priority = (alias_priority or 2) if alias is not None else None + + if repr is None: + repr_: bool = not _wrapped_property_is_private(property_=f) + else: + repr_ = repr + + dec_info = ComputedFieldInfo( + f, + return_type, + alias, + alias_priority, + title, + field_title_generator, + description, + deprecated, + examples, + json_schema_extra, + repr_, + ) + return _decorators.PydanticDescriptorProxy(f, dec_info) + + if func is None: + return dec + else: + return dec(func) diff --git a/env/Lib/site-packages/pydantic/functional_serializers.py b/env/Lib/site-packages/pydantic/functional_serializers.py new file mode 100644 index 0000000..478c4a9 --- /dev/null +++ b/env/Lib/site-packages/pydantic/functional_serializers.py @@ -0,0 +1,395 @@ +"""This module contains related classes and functions for serialization.""" + +from __future__ import annotations + +import dataclasses +from functools import partialmethod +from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union, overload + +from pydantic_core import PydanticUndefined, core_schema +from pydantic_core import core_schema as _core_schema +from typing_extensions import Annotated, Literal, TypeAlias + +from . import PydanticUndefinedAnnotation +from ._internal import _decorators, _internal_dataclass +from .annotated_handlers import GetCoreSchemaHandler + + +@dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True) +class PlainSerializer: + """Plain serializers use a function to modify the output of serialization. + + This is particularly helpful when you want to customize the serialization for annotated types. + Consider an input of `list`, which will be serialized into a space-delimited string. + + ```python + from typing import List + + from typing_extensions import Annotated + + from pydantic import BaseModel, PlainSerializer + + CustomStr = Annotated[ + List, PlainSerializer(lambda x: ' '.join(x), return_type=str) + ] + + class StudentModel(BaseModel): + courses: CustomStr + + student = StudentModel(courses=['Math', 'Chemistry', 'English']) + print(student.model_dump()) + #> {'courses': 'Math Chemistry English'} + ``` + + Attributes: + func: The serializer function. + return_type: The return type for the function. If omitted it will be inferred from the type annotation. + when_used: Determines when this serializer should be used. Accepts a string with values `'always'`, + `'unless-none'`, `'json'`, and `'json-unless-none'`. Defaults to 'always'. + """ + + func: core_schema.SerializerFunction + return_type: Any = PydanticUndefined + when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always' + + def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + """Gets the Pydantic core schema. + + Args: + source_type: The source type. + handler: The `GetCoreSchemaHandler` instance. + + Returns: + The Pydantic core schema. + """ + schema = handler(source_type) + try: + return_type = _decorators.get_function_return_type( + self.func, self.return_type, handler._get_types_namespace() + ) + except NameError as e: + raise PydanticUndefinedAnnotation.from_name_error(e) from e + return_schema = None if return_type is PydanticUndefined else handler.generate_schema(return_type) + schema['serialization'] = core_schema.plain_serializer_function_ser_schema( + function=self.func, + info_arg=_decorators.inspect_annotated_serializer(self.func, 'plain'), + return_schema=return_schema, + when_used=self.when_used, + ) + return schema + + +@dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True) +class WrapSerializer: + """Wrap serializers receive the raw inputs along with a handler function that applies the standard serialization + logic, and can modify the resulting value before returning it as the final output of serialization. + + For example, here's a scenario in which a wrap serializer transforms timezones to UTC **and** utilizes the existing `datetime` serialization logic. + + ```python + from datetime import datetime, timezone + from typing import Any, Dict + + from typing_extensions import Annotated + + from pydantic import BaseModel, WrapSerializer + + class EventDatetime(BaseModel): + start: datetime + end: datetime + + def convert_to_utc(value: Any, handler, info) -> Dict[str, datetime]: + # Note that `helper` can actually help serialize the `value` for further custom serialization in case it's a subclass. + partial_result = handler(value, info) + if info.mode == 'json': + return { + k: datetime.fromisoformat(v).astimezone(timezone.utc) + for k, v in partial_result.items() + } + return {k: v.astimezone(timezone.utc) for k, v in partial_result.items()} + + UTCEventDatetime = Annotated[EventDatetime, WrapSerializer(convert_to_utc)] + + class EventModel(BaseModel): + event_datetime: UTCEventDatetime + + dt = EventDatetime( + start='2024-01-01T07:00:00-08:00', end='2024-01-03T20:00:00+06:00' + ) + event = EventModel(event_datetime=dt) + print(event.model_dump()) + ''' + { + 'event_datetime': { + 'start': datetime.datetime( + 2024, 1, 1, 15, 0, tzinfo=datetime.timezone.utc + ), + 'end': datetime.datetime( + 2024, 1, 3, 14, 0, tzinfo=datetime.timezone.utc + ), + } + } + ''' + + print(event.model_dump_json()) + ''' + {"event_datetime":{"start":"2024-01-01T15:00:00Z","end":"2024-01-03T14:00:00Z"}} + ''' + ``` + + Attributes: + func: The serializer function to be wrapped. + return_type: The return type for the function. If omitted it will be inferred from the type annotation. + when_used: Determines when this serializer should be used. Accepts a string with values `'always'`, + `'unless-none'`, `'json'`, and `'json-unless-none'`. Defaults to 'always'. + """ + + func: core_schema.WrapSerializerFunction + return_type: Any = PydanticUndefined + when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always' + + def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + """This method is used to get the Pydantic core schema of the class. + + Args: + source_type: Source type. + handler: Core schema handler. + + Returns: + The generated core schema of the class. + """ + schema = handler(source_type) + try: + return_type = _decorators.get_function_return_type( + self.func, self.return_type, handler._get_types_namespace() + ) + except NameError as e: + raise PydanticUndefinedAnnotation.from_name_error(e) from e + return_schema = None if return_type is PydanticUndefined else handler.generate_schema(return_type) + schema['serialization'] = core_schema.wrap_serializer_function_ser_schema( + function=self.func, + info_arg=_decorators.inspect_annotated_serializer(self.func, 'wrap'), + return_schema=return_schema, + when_used=self.when_used, + ) + return schema + + +if TYPE_CHECKING: + _PartialClsOrStaticMethod: TypeAlias = Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any]] + _PlainSerializationFunction = Union[_core_schema.SerializerFunction, _PartialClsOrStaticMethod] + _WrapSerializationFunction = Union[_core_schema.WrapSerializerFunction, _PartialClsOrStaticMethod] + _PlainSerializeMethodType = TypeVar('_PlainSerializeMethodType', bound=_PlainSerializationFunction) + _WrapSerializeMethodType = TypeVar('_WrapSerializeMethodType', bound=_WrapSerializationFunction) + + +@overload +def field_serializer( + field: str, + /, + *fields: str, + return_type: Any = ..., + when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = ..., + check_fields: bool | None = ..., +) -> Callable[[_PlainSerializeMethodType], _PlainSerializeMethodType]: ... + + +@overload +def field_serializer( + field: str, + /, + *fields: str, + mode: Literal['plain'], + return_type: Any = ..., + when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = ..., + check_fields: bool | None = ..., +) -> Callable[[_PlainSerializeMethodType], _PlainSerializeMethodType]: ... + + +@overload +def field_serializer( + field: str, + /, + *fields: str, + mode: Literal['wrap'], + return_type: Any = ..., + when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = ..., + check_fields: bool | None = ..., +) -> Callable[[_WrapSerializeMethodType], _WrapSerializeMethodType]: ... + + +def field_serializer( + *fields: str, + mode: Literal['plain', 'wrap'] = 'plain', + return_type: Any = PydanticUndefined, + when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always', + check_fields: bool | None = None, +) -> Callable[[Any], Any]: + """Decorator that enables custom field serialization. + + In the below example, a field of type `set` is used to mitigate duplication. A `field_serializer` is used to serialize the data as a sorted list. + + ```python + from typing import Set + + from pydantic import BaseModel, field_serializer + + class StudentModel(BaseModel): + name: str = 'Jane' + courses: Set[str] + + @field_serializer('courses', when_used='json') + def serialize_courses_in_order(courses: Set[str]): + return sorted(courses) + + student = StudentModel(courses={'Math', 'Chemistry', 'English'}) + print(student.model_dump_json()) + #> {"name":"Jane","courses":["Chemistry","English","Math"]} + ``` + + See [Custom serializers](../concepts/serialization.md#custom-serializers) for more information. + + Four signatures are supported: + + - `(self, value: Any, info: FieldSerializationInfo)` + - `(self, value: Any, nxt: SerializerFunctionWrapHandler, info: FieldSerializationInfo)` + - `(value: Any, info: SerializationInfo)` + - `(value: Any, nxt: SerializerFunctionWrapHandler, info: SerializationInfo)` + + Args: + fields: Which field(s) the method should be called on. + mode: The serialization mode. + + - `plain` means the function will be called instead of the default serialization logic, + - `wrap` means the function will be called with an argument to optionally call the + default serialization logic. + return_type: Optional return type for the function, if omitted it will be inferred from the type annotation. + when_used: Determines the serializer will be used for serialization. + check_fields: Whether to check that the fields actually exist on the model. + + Returns: + The decorator function. + """ + + def dec( + f: Callable[..., Any] | staticmethod[Any, Any] | classmethod[Any, Any, Any], + ) -> _decorators.PydanticDescriptorProxy[Any]: + dec_info = _decorators.FieldSerializerDecoratorInfo( + fields=fields, + mode=mode, + return_type=return_type, + when_used=when_used, + check_fields=check_fields, + ) + return _decorators.PydanticDescriptorProxy(f, dec_info) + + return dec + + +FuncType = TypeVar('FuncType', bound=Callable[..., Any]) + + +@overload +def model_serializer(__f: FuncType) -> FuncType: ... + + +@overload +def model_serializer( + *, + mode: Literal['plain', 'wrap'] = ..., + when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always', + return_type: Any = ..., +) -> Callable[[FuncType], FuncType]: ... + + +def model_serializer( + f: Callable[..., Any] | None = None, + /, + *, + mode: Literal['plain', 'wrap'] = 'plain', + when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always', + return_type: Any = PydanticUndefined, +) -> Callable[[Any], Any]: + """Decorator that enables custom model serialization. + + This is useful when a model need to be serialized in a customized manner, allowing for flexibility beyond just specific fields. + + An example would be to serialize temperature to the same temperature scale, such as degrees Celsius. + + ```python + from typing import Literal + + from pydantic import BaseModel, model_serializer + + class TemperatureModel(BaseModel): + unit: Literal['C', 'F'] + value: int + + @model_serializer() + def serialize_model(self): + if self.unit == 'F': + return {'unit': 'C', 'value': int((self.value - 32) / 1.8)} + return {'unit': self.unit, 'value': self.value} + + temperature = TemperatureModel(unit='F', value=212) + print(temperature.model_dump()) + #> {'unit': 'C', 'value': 100} + ``` + + See [Custom serializers](../concepts/serialization.md#custom-serializers) for more information. + + Args: + f: The function to be decorated. + mode: The serialization mode. + + - `'plain'` means the function will be called instead of the default serialization logic + - `'wrap'` means the function will be called with an argument to optionally call the default + serialization logic. + when_used: Determines when this serializer should be used. + return_type: The return type for the function. If omitted it will be inferred from the type annotation. + + Returns: + The decorator function. + """ + + def dec(f: Callable[..., Any]) -> _decorators.PydanticDescriptorProxy[Any]: + dec_info = _decorators.ModelSerializerDecoratorInfo(mode=mode, return_type=return_type, when_used=when_used) + return _decorators.PydanticDescriptorProxy(f, dec_info) + + if f is None: + return dec + else: + return dec(f) # type: ignore + + +AnyType = TypeVar('AnyType') + + +if TYPE_CHECKING: + SerializeAsAny = Annotated[AnyType, ...] # SerializeAsAny[list[str]] will be treated by type checkers as list[str] + """Force serialization to ignore whatever is defined in the schema and instead ask the object + itself how it should be serialized. + In particular, this means that when model subclasses are serialized, fields present in the subclass + but not in the original schema will be included. + """ +else: + + @dataclasses.dataclass(**_internal_dataclass.slots_true) + class SerializeAsAny: # noqa: D101 + def __class_getitem__(cls, item: Any) -> Any: + return Annotated[item, SerializeAsAny()] + + def __get_pydantic_core_schema__( + self, source_type: Any, handler: GetCoreSchemaHandler + ) -> core_schema.CoreSchema: + schema = handler(source_type) + schema_to_update = schema + while schema_to_update['type'] == 'definitions': + schema_to_update = schema_to_update.copy() + schema_to_update = schema_to_update['schema'] + schema_to_update['serialization'] = core_schema.wrap_serializer_function_ser_schema( + lambda x, h: h(x), schema=core_schema.any_schema() + ) + return schema + + __hash__ = object.__hash__ diff --git a/env/Lib/site-packages/pydantic/functional_validators.py b/env/Lib/site-packages/pydantic/functional_validators.py new file mode 100644 index 0000000..b29880f --- /dev/null +++ b/env/Lib/site-packages/pydantic/functional_validators.py @@ -0,0 +1,697 @@ +"""This module contains related classes and functions for validation.""" + +from __future__ import annotations as _annotations + +import dataclasses +import sys +from functools import partialmethod +from types import FunctionType +from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union, cast, overload + +from pydantic_core import core_schema +from pydantic_core import core_schema as _core_schema +from typing_extensions import Annotated, Literal, TypeAlias + +from . import GetCoreSchemaHandler as _GetCoreSchemaHandler +from ._internal import _core_metadata, _decorators, _generics, _internal_dataclass +from .annotated_handlers import GetCoreSchemaHandler +from .errors import PydanticUserError + +if sys.version_info < (3, 11): + from typing_extensions import Protocol +else: + from typing import Protocol + +_inspect_validator = _decorators.inspect_validator + + +@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true) +class AfterValidator: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/validators/#annotated-validators + + A metadata class that indicates that a validation should be applied **after** the inner validation logic. + + Attributes: + func: The validator function. + + Example: + ```py + from typing_extensions import Annotated + + from pydantic import AfterValidator, BaseModel, ValidationError + + MyInt = Annotated[int, AfterValidator(lambda v: v + 1)] + + class Model(BaseModel): + a: MyInt + + print(Model(a=1).a) + #> 2 + + try: + Model(a='a') + except ValidationError as e: + print(e.json(indent=2)) + ''' + [ + { + "type": "int_parsing", + "loc": [ + "a" + ], + "msg": "Input should be a valid integer, unable to parse string as an integer", + "input": "a", + "url": "https://errors.pydantic.dev/2/v/int_parsing" + } + ] + ''' + ``` + """ + + func: core_schema.NoInfoValidatorFunction | core_schema.WithInfoValidatorFunction + + def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema: + schema = handler(source_type) + info_arg = _inspect_validator(self.func, 'after') + if info_arg: + func = cast(core_schema.WithInfoValidatorFunction, self.func) + return core_schema.with_info_after_validator_function(func, schema=schema, field_name=handler.field_name) + else: + func = cast(core_schema.NoInfoValidatorFunction, self.func) + return core_schema.no_info_after_validator_function(func, schema=schema) + + +@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true) +class BeforeValidator: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/validators/#annotated-validators + + A metadata class that indicates that a validation should be applied **before** the inner validation logic. + + Attributes: + func: The validator function. + + Example: + ```py + from typing_extensions import Annotated + + from pydantic import BaseModel, BeforeValidator + + MyInt = Annotated[int, BeforeValidator(lambda v: v + 1)] + + class Model(BaseModel): + a: MyInt + + print(Model(a=1).a) + #> 2 + + try: + Model(a='a') + except TypeError as e: + print(e) + #> can only concatenate str (not "int") to str + ``` + """ + + func: core_schema.NoInfoValidatorFunction | core_schema.WithInfoValidatorFunction + + def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema: + schema = handler(source_type) + info_arg = _inspect_validator(self.func, 'before') + if info_arg: + func = cast(core_schema.WithInfoValidatorFunction, self.func) + return core_schema.with_info_before_validator_function(func, schema=schema, field_name=handler.field_name) + else: + func = cast(core_schema.NoInfoValidatorFunction, self.func) + return core_schema.no_info_before_validator_function(func, schema=schema) + + +@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true) +class PlainValidator: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/validators/#annotated-validators + + A metadata class that indicates that a validation should be applied **instead** of the inner validation logic. + + Attributes: + func: The validator function. + + Example: + ```py + from typing_extensions import Annotated + + from pydantic import BaseModel, PlainValidator + + MyInt = Annotated[int, PlainValidator(lambda v: int(v) + 1)] + + class Model(BaseModel): + a: MyInt + + print(Model(a='1').a) + #> 2 + ``` + """ + + func: core_schema.NoInfoValidatorFunction | core_schema.WithInfoValidatorFunction + + def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema: + # Note that for some valid uses of PlainValidator, it is not possible to generate a core schema for the + # source_type, so calling `handler(source_type)` will error, which prevents us from generating a proper + # serialization schema. To work around this for use cases that will not involve serialization, we simply + # catch any PydanticSchemaGenerationError that may be raised while attempting to build the serialization schema + # and abort any attempts to handle special serialization. + from pydantic import PydanticSchemaGenerationError + + try: + schema = handler(source_type) + serialization = core_schema.wrap_serializer_function_ser_schema(function=lambda v, h: h(v), schema=schema) + except PydanticSchemaGenerationError: + serialization = None + + info_arg = _inspect_validator(self.func, 'plain') + if info_arg: + func = cast(core_schema.WithInfoValidatorFunction, self.func) + return core_schema.with_info_plain_validator_function( + func, field_name=handler.field_name, serialization=serialization + ) + else: + func = cast(core_schema.NoInfoValidatorFunction, self.func) + return core_schema.no_info_plain_validator_function(func, serialization=serialization) + + +@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true) +class WrapValidator: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/validators/#annotated-validators + + A metadata class that indicates that a validation should be applied **around** the inner validation logic. + + Attributes: + func: The validator function. + + ```py + from datetime import datetime + + from typing_extensions import Annotated + + from pydantic import BaseModel, ValidationError, WrapValidator + + def validate_timestamp(v, handler): + if v == 'now': + # we don't want to bother with further validation, just return the new value + return datetime.now() + try: + return handler(v) + except ValidationError: + # validation failed, in this case we want to return a default value + return datetime(2000, 1, 1) + + MyTimestamp = Annotated[datetime, WrapValidator(validate_timestamp)] + + class Model(BaseModel): + a: MyTimestamp + + print(Model(a='now').a) + #> 2032-01-02 03:04:05.000006 + print(Model(a='invalid').a) + #> 2000-01-01 00:00:00 + ``` + """ + + func: core_schema.NoInfoWrapValidatorFunction | core_schema.WithInfoWrapValidatorFunction + + def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema: + schema = handler(source_type) + info_arg = _inspect_validator(self.func, 'wrap') + if info_arg: + func = cast(core_schema.WithInfoWrapValidatorFunction, self.func) + return core_schema.with_info_wrap_validator_function(func, schema=schema, field_name=handler.field_name) + else: + func = cast(core_schema.NoInfoWrapValidatorFunction, self.func) + return core_schema.no_info_wrap_validator_function(func, schema=schema) + + +if TYPE_CHECKING: + + class _OnlyValueValidatorClsMethod(Protocol): + def __call__(self, cls: Any, value: Any, /) -> Any: ... + + class _V2ValidatorClsMethod(Protocol): + def __call__(self, cls: Any, value: Any, info: _core_schema.ValidationInfo, /) -> Any: ... + + class _V2WrapValidatorClsMethod(Protocol): + def __call__( + self, + cls: Any, + value: Any, + handler: _core_schema.ValidatorFunctionWrapHandler, + info: _core_schema.ValidationInfo, + /, + ) -> Any: ... + + _V2Validator = Union[ + _V2ValidatorClsMethod, + _core_schema.WithInfoValidatorFunction, + _OnlyValueValidatorClsMethod, + _core_schema.NoInfoValidatorFunction, + ] + + _V2WrapValidator = Union[ + _V2WrapValidatorClsMethod, + _core_schema.WithInfoWrapValidatorFunction, + ] + + _PartialClsOrStaticMethod: TypeAlias = Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any]] + + _V2BeforeAfterOrPlainValidatorType = TypeVar( + '_V2BeforeAfterOrPlainValidatorType', + _V2Validator, + _PartialClsOrStaticMethod, + ) + _V2WrapValidatorType = TypeVar('_V2WrapValidatorType', _V2WrapValidator, _PartialClsOrStaticMethod) + + +@overload +def field_validator( + field: str, + /, + *fields: str, + mode: Literal['before', 'after', 'plain'] = ..., + check_fields: bool | None = ..., +) -> Callable[[_V2BeforeAfterOrPlainValidatorType], _V2BeforeAfterOrPlainValidatorType]: ... + + +@overload +def field_validator( + field: str, + /, + *fields: str, + mode: Literal['wrap'], + check_fields: bool | None = ..., +) -> Callable[[_V2WrapValidatorType], _V2WrapValidatorType]: ... + + +FieldValidatorModes: TypeAlias = Literal['before', 'after', 'wrap', 'plain'] + + +def field_validator( + field: str, + /, + *fields: str, + mode: FieldValidatorModes = 'after', + check_fields: bool | None = None, +) -> Callable[[Any], Any]: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/validators/#field-validators + + Decorate methods on the class indicating that they should be used to validate fields. + + Example usage: + ```py + from typing import Any + + from pydantic import ( + BaseModel, + ValidationError, + field_validator, + ) + + class Model(BaseModel): + a: str + + @field_validator('a') + @classmethod + def ensure_foobar(cls, v: Any): + if 'foobar' not in v: + raise ValueError('"foobar" not found in a') + return v + + print(repr(Model(a='this is foobar good'))) + #> Model(a='this is foobar good') + + try: + Model(a='snap') + except ValidationError as exc_info: + print(exc_info) + ''' + 1 validation error for Model + a + Value error, "foobar" not found in a [type=value_error, input_value='snap', input_type=str] + ''' + ``` + + For more in depth examples, see [Field Validators](../concepts/validators.md#field-validators). + + Args: + field: The first field the `field_validator` should be called on; this is separate + from `fields` to ensure an error is raised if you don't pass at least one. + *fields: Additional field(s) the `field_validator` should be called on. + mode: Specifies whether to validate the fields before or after validation. + check_fields: Whether to check that the fields actually exist on the model. + + Returns: + A decorator that can be used to decorate a function to be used as a field_validator. + + Raises: + PydanticUserError: + - If `@field_validator` is used bare (with no fields). + - If the args passed to `@field_validator` as fields are not strings. + - If `@field_validator` applied to instance methods. + """ + if isinstance(field, FunctionType): + raise PydanticUserError( + '`@field_validator` should be used with fields and keyword arguments, not bare. ' + "E.g. usage should be `@validator('', ...)`", + code='validator-no-fields', + ) + fields = field, *fields + if not all(isinstance(field, str) for field in fields): + raise PydanticUserError( + '`@field_validator` fields should be passed as separate string args. ' + "E.g. usage should be `@validator('', '', ...)`", + code='validator-invalid-fields', + ) + + def dec( + f: Callable[..., Any] | staticmethod[Any, Any] | classmethod[Any, Any, Any], + ) -> _decorators.PydanticDescriptorProxy[Any]: + if _decorators.is_instance_method_from_sig(f): + raise PydanticUserError( + '`@field_validator` cannot be applied to instance methods', code='validator-instance-method' + ) + + # auto apply the @classmethod decorator + f = _decorators.ensure_classmethod_based_on_signature(f) + + dec_info = _decorators.FieldValidatorDecoratorInfo(fields=fields, mode=mode, check_fields=check_fields) + return _decorators.PydanticDescriptorProxy(f, dec_info) + + return dec + + +_ModelType = TypeVar('_ModelType') +_ModelTypeCo = TypeVar('_ModelTypeCo', covariant=True) + + +class ModelWrapValidatorHandler(_core_schema.ValidatorFunctionWrapHandler, Protocol[_ModelTypeCo]): + """@model_validator decorated function handler argument type. This is used when `mode='wrap'`.""" + + def __call__( # noqa: D102 + self, + value: Any, + outer_location: str | int | None = None, + /, + ) -> _ModelTypeCo: # pragma: no cover + ... + + +class ModelWrapValidatorWithoutInfo(Protocol[_ModelType]): + """A @model_validator decorated function signature. + This is used when `mode='wrap'` and the function does not have info argument. + """ + + def __call__( # noqa: D102 + self, + cls: type[_ModelType], + # this can be a dict, a model instance + # or anything else that gets passed to validate_python + # thus validators _must_ handle all cases + value: Any, + handler: ModelWrapValidatorHandler[_ModelType], + /, + ) -> _ModelType: ... + + +class ModelWrapValidator(Protocol[_ModelType]): + """A @model_validator decorated function signature. This is used when `mode='wrap'`.""" + + def __call__( # noqa: D102 + self, + cls: type[_ModelType], + # this can be a dict, a model instance + # or anything else that gets passed to validate_python + # thus validators _must_ handle all cases + value: Any, + handler: ModelWrapValidatorHandler[_ModelType], + info: _core_schema.ValidationInfo, + /, + ) -> _ModelType: ... + + +class FreeModelBeforeValidatorWithoutInfo(Protocol): + """A @model_validator decorated function signature. + This is used when `mode='before'` and the function does not have info argument. + """ + + def __call__( # noqa: D102 + self, + # this can be a dict, a model instance + # or anything else that gets passed to validate_python + # thus validators _must_ handle all cases + value: Any, + /, + ) -> Any: ... + + +class ModelBeforeValidatorWithoutInfo(Protocol): + """A @model_validator decorated function signature. + This is used when `mode='before'` and the function does not have info argument. + """ + + def __call__( # noqa: D102 + self, + cls: Any, + # this can be a dict, a model instance + # or anything else that gets passed to validate_python + # thus validators _must_ handle all cases + value: Any, + /, + ) -> Any: ... + + +class FreeModelBeforeValidator(Protocol): + """A `@model_validator` decorated function signature. This is used when `mode='before'`.""" + + def __call__( # noqa: D102 + self, + # this can be a dict, a model instance + # or anything else that gets passed to validate_python + # thus validators _must_ handle all cases + value: Any, + info: _core_schema.ValidationInfo, + /, + ) -> Any: ... + + +class ModelBeforeValidator(Protocol): + """A `@model_validator` decorated function signature. This is used when `mode='before'`.""" + + def __call__( # noqa: D102 + self, + cls: Any, + # this can be a dict, a model instance + # or anything else that gets passed to validate_python + # thus validators _must_ handle all cases + value: Any, + info: _core_schema.ValidationInfo, + /, + ) -> Any: ... + + +ModelAfterValidatorWithoutInfo = Callable[[_ModelType], _ModelType] +"""A `@model_validator` decorated function signature. This is used when `mode='after'` and the function does not +have info argument. +""" + +ModelAfterValidator = Callable[[_ModelType, _core_schema.ValidationInfo], _ModelType] +"""A `@model_validator` decorated function signature. This is used when `mode='after'`.""" + +_AnyModelWrapValidator = Union[ModelWrapValidator[_ModelType], ModelWrapValidatorWithoutInfo[_ModelType]] +_AnyModeBeforeValidator = Union[ + FreeModelBeforeValidator, ModelBeforeValidator, FreeModelBeforeValidatorWithoutInfo, ModelBeforeValidatorWithoutInfo +] +_AnyModelAfterValidator = Union[ModelAfterValidator[_ModelType], ModelAfterValidatorWithoutInfo[_ModelType]] + + +@overload +def model_validator( + *, + mode: Literal['wrap'], +) -> Callable[ + [_AnyModelWrapValidator[_ModelType]], _decorators.PydanticDescriptorProxy[_decorators.ModelValidatorDecoratorInfo] +]: ... + + +@overload +def model_validator( + *, + mode: Literal['before'], +) -> Callable[ + [_AnyModeBeforeValidator], _decorators.PydanticDescriptorProxy[_decorators.ModelValidatorDecoratorInfo] +]: ... + + +@overload +def model_validator( + *, + mode: Literal['after'], +) -> Callable[ + [_AnyModelAfterValidator[_ModelType]], _decorators.PydanticDescriptorProxy[_decorators.ModelValidatorDecoratorInfo] +]: ... + + +def model_validator( + *, + mode: Literal['wrap', 'before', 'after'], +) -> Any: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/validators/#model-validators + + Decorate model methods for validation purposes. + + Example usage: + ```py + from typing_extensions import Self + + from pydantic import BaseModel, ValidationError, model_validator + + class Square(BaseModel): + width: float + height: float + + @model_validator(mode='after') + def verify_square(self) -> Self: + if self.width != self.height: + raise ValueError('width and height do not match') + return self + + s = Square(width=1, height=1) + print(repr(s)) + #> Square(width=1.0, height=1.0) + + try: + Square(width=1, height=2) + except ValidationError as e: + print(e) + ''' + 1 validation error for Square + Value error, width and height do not match [type=value_error, input_value={'width': 1, 'height': 2}, input_type=dict] + ''' + ``` + + For more in depth examples, see [Model Validators](../concepts/validators.md#model-validators). + + Args: + mode: A required string literal that specifies the validation mode. + It can be one of the following: 'wrap', 'before', or 'after'. + + Returns: + A decorator that can be used to decorate a function to be used as a model validator. + """ + + def dec(f: Any) -> _decorators.PydanticDescriptorProxy[Any]: + # auto apply the @classmethod decorator + f = _decorators.ensure_classmethod_based_on_signature(f) + dec_info = _decorators.ModelValidatorDecoratorInfo(mode=mode) + return _decorators.PydanticDescriptorProxy(f, dec_info) + + return dec + + +AnyType = TypeVar('AnyType') + + +if TYPE_CHECKING: + # If we add configurable attributes to IsInstance, we'd probably need to stop hiding it from type checkers like this + InstanceOf = Annotated[AnyType, ...] # `IsInstance[Sequence]` will be recognized by type checkers as `Sequence` + +else: + + @dataclasses.dataclass(**_internal_dataclass.slots_true) + class InstanceOf: + '''Generic type for annotating a type that is an instance of a given class. + + Example: + ```py + from pydantic import BaseModel, InstanceOf + + class Foo: + ... + + class Bar(BaseModel): + foo: InstanceOf[Foo] + + Bar(foo=Foo()) + try: + Bar(foo=42) + except ValidationError as e: + print(e) + """ + [ + │ { + │ │ 'type': 'is_instance_of', + │ │ 'loc': ('foo',), + │ │ 'msg': 'Input should be an instance of Foo', + │ │ 'input': 42, + │ │ 'ctx': {'class': 'Foo'}, + │ │ 'url': 'https://errors.pydantic.dev/0.38.0/v/is_instance_of' + │ } + ] + """ + ``` + ''' + + @classmethod + def __class_getitem__(cls, item: AnyType) -> AnyType: + return Annotated[item, cls()] + + @classmethod + def __get_pydantic_core_schema__(cls, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + from pydantic import PydanticSchemaGenerationError + + # use the generic _origin_ as the second argument to isinstance when appropriate + instance_of_schema = core_schema.is_instance_schema(_generics.get_origin(source) or source) + + try: + # Try to generate the "standard" schema, which will be used when loading from JSON + original_schema = handler(source) + except PydanticSchemaGenerationError: + # If that fails, just produce a schema that can validate from python + return instance_of_schema + else: + # Use the "original" approach to serialization + instance_of_schema['serialization'] = core_schema.wrap_serializer_function_ser_schema( + function=lambda v, h: h(v), schema=original_schema + ) + return core_schema.json_or_python_schema(python_schema=instance_of_schema, json_schema=original_schema) + + __hash__ = object.__hash__ + + +if TYPE_CHECKING: + SkipValidation = Annotated[AnyType, ...] # SkipValidation[list[str]] will be treated by type checkers as list[str] +else: + + @dataclasses.dataclass(**_internal_dataclass.slots_true) + class SkipValidation: + """If this is applied as an annotation (e.g., via `x: Annotated[int, SkipValidation]`), validation will be + skipped. You can also use `SkipValidation[int]` as a shorthand for `Annotated[int, SkipValidation]`. + + This can be useful if you want to use a type annotation for documentation/IDE/type-checking purposes, + and know that it is safe to skip validation for one or more of the fields. + + Because this converts the validation schema to `any_schema`, subsequent annotation-applied transformations + may not have the expected effects. Therefore, when used, this annotation should generally be the final + annotation applied to a type. + """ + + def __class_getitem__(cls, item: Any) -> Any: + return Annotated[item, SkipValidation()] + + @classmethod + def __get_pydantic_core_schema__(cls, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + original_schema = handler(source) + metadata = _core_metadata.build_metadata_dict(js_annotation_functions=[lambda _c, h: h(original_schema)]) + return core_schema.any_schema( + metadata=metadata, + serialization=core_schema.wrap_serializer_function_ser_schema( + function=lambda v, h: h(v), schema=original_schema + ), + ) + + __hash__ = object.__hash__ diff --git a/env/Lib/site-packages/pydantic/generics.py b/env/Lib/site-packages/pydantic/generics.py new file mode 100644 index 0000000..3f1070d --- /dev/null +++ b/env/Lib/site-packages/pydantic/generics.py @@ -0,0 +1,5 @@ +"""The `generics` module is a backport module from V1.""" + +from ._migration import getattr_migration + +__getattr__ = getattr_migration(__name__) diff --git a/env/Lib/site-packages/pydantic/json.py b/env/Lib/site-packages/pydantic/json.py new file mode 100644 index 0000000..bcaff9f --- /dev/null +++ b/env/Lib/site-packages/pydantic/json.py @@ -0,0 +1,5 @@ +"""The `json` module is a backport module from V1.""" + +from ._migration import getattr_migration + +__getattr__ = getattr_migration(__name__) diff --git a/env/Lib/site-packages/pydantic/json_schema.py b/env/Lib/site-packages/pydantic/json_schema.py new file mode 100644 index 0000000..63dcde7 --- /dev/null +++ b/env/Lib/site-packages/pydantic/json_schema.py @@ -0,0 +1,2520 @@ +""" +Usage docs: https://docs.pydantic.dev/2.5/concepts/json_schema/ + +The `json_schema` module contains classes and functions to allow the way [JSON Schema](https://json-schema.org/) +is generated to be customized. + +In general you shouldn't need to use this module directly; instead, you can use +[`BaseModel.model_json_schema`][pydantic.BaseModel.model_json_schema] and +[`TypeAdapter.json_schema`][pydantic.TypeAdapter.json_schema]. +""" + +from __future__ import annotations as _annotations + +import dataclasses +import inspect +import math +import re +import warnings +from collections import defaultdict +from copy import deepcopy +from dataclasses import is_dataclass +from enum import Enum +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Counter, + Dict, + Hashable, + Iterable, + NewType, + Pattern, + Sequence, + Tuple, + TypeVar, + Union, + cast, +) + +import pydantic_core +from pydantic_core import CoreSchema, PydanticOmit, core_schema, to_jsonable_python +from pydantic_core.core_schema import ComputedField +from typing_extensions import Annotated, Literal, TypeAlias, assert_never, deprecated, final + +from pydantic.warnings import PydanticDeprecatedSince26 + +from ._internal import ( + _config, + _core_metadata, + _core_utils, + _decorators, + _internal_dataclass, + _mock_val_ser, + _schema_generation_shared, + _typing_extra, +) +from .annotated_handlers import GetJsonSchemaHandler +from .config import JsonDict, JsonSchemaExtraCallable, JsonValue +from .errors import PydanticInvalidForJsonSchema, PydanticSchemaGenerationError, PydanticUserError + +if TYPE_CHECKING: + from . import ConfigDict + from ._internal._core_utils import CoreSchemaField, CoreSchemaOrField + from ._internal._dataclasses import PydanticDataclass + from ._internal._schema_generation_shared import GetJsonSchemaFunction + from .main import BaseModel + + +CoreSchemaOrFieldType = Literal[core_schema.CoreSchemaType, core_schema.CoreSchemaFieldType] +""" +A type alias for defined schema types that represents a union of +`core_schema.CoreSchemaType` and +`core_schema.CoreSchemaFieldType`. +""" + +JsonSchemaValue = Dict[str, Any] +""" +A type alias for a JSON schema value. This is a dictionary of string keys to arbitrary JSON values. +""" + +JsonSchemaMode = Literal['validation', 'serialization'] +""" +A type alias that represents the mode of a JSON schema; either 'validation' or 'serialization'. + +For some types, the inputs to validation differ from the outputs of serialization. For example, +computed fields will only be present when serializing, and should not be provided when +validating. This flag provides a way to indicate whether you want the JSON schema required +for validation inputs, or that will be matched by serialization outputs. +""" + +_MODE_TITLE_MAPPING: dict[JsonSchemaMode, str] = {'validation': 'Input', 'serialization': 'Output'} + + +@deprecated( + '`update_json_schema` is deprecated, use a simple `my_dict.update(update_dict)` call instead.', + category=None, +) +def update_json_schema(schema: JsonSchemaValue, updates: dict[str, Any]) -> JsonSchemaValue: + """Update a JSON schema in-place by providing a dictionary of updates. + + This function sets the provided key-value pairs in the schema and returns the updated schema. + + Args: + schema: The JSON schema to update. + updates: A dictionary of key-value pairs to set in the schema. + + Returns: + The updated JSON schema. + """ + schema.update(updates) + return schema + + +JsonSchemaWarningKind = Literal['skipped-choice', 'non-serializable-default'] +""" +A type alias representing the kinds of warnings that can be emitted during JSON schema generation. + +See [`GenerateJsonSchema.render_warning_message`][pydantic.json_schema.GenerateJsonSchema.render_warning_message] +for more details. +""" + + +class PydanticJsonSchemaWarning(UserWarning): + """This class is used to emit warnings produced during JSON schema generation. + See the [`GenerateJsonSchema.emit_warning`][pydantic.json_schema.GenerateJsonSchema.emit_warning] and + [`GenerateJsonSchema.render_warning_message`][pydantic.json_schema.GenerateJsonSchema.render_warning_message] + methods for more details; these can be overridden to control warning behavior. + """ + + +# ##### JSON Schema Generation ##### +DEFAULT_REF_TEMPLATE = '#/$defs/{model}' +"""The default format string used to generate reference names.""" + +# There are three types of references relevant to building JSON schemas: +# 1. core_schema "ref" values; these are not exposed as part of the JSON schema +# * these might look like the fully qualified path of a model, its id, or something similar +CoreRef = NewType('CoreRef', str) +# 2. keys of the "definitions" object that will eventually go into the JSON schema +# * by default, these look like "MyModel", though may change in the presence of collisions +# * eventually, we may want to make it easier to modify the way these names are generated +DefsRef = NewType('DefsRef', str) +# 3. the values corresponding to the "$ref" key in the schema +# * By default, these look like "#/$defs/MyModel", as in {"$ref": "#/$defs/MyModel"} +JsonRef = NewType('JsonRef', str) + +CoreModeRef = Tuple[CoreRef, JsonSchemaMode] +JsonSchemaKeyT = TypeVar('JsonSchemaKeyT', bound=Hashable) + + +@dataclasses.dataclass(**_internal_dataclass.slots_true) +class _DefinitionsRemapping: + defs_remapping: dict[DefsRef, DefsRef] + json_remapping: dict[JsonRef, JsonRef] + + @staticmethod + def from_prioritized_choices( + prioritized_choices: dict[DefsRef, list[DefsRef]], + defs_to_json: dict[DefsRef, JsonRef], + definitions: dict[DefsRef, JsonSchemaValue], + ) -> _DefinitionsRemapping: + """ + This function should produce a remapping that replaces complex DefsRef with the simpler ones from the + prioritized_choices such that applying the name remapping would result in an equivalent JSON schema. + """ + # We need to iteratively simplify the definitions until we reach a fixed point. + # The reason for this is that outer definitions may reference inner definitions that get simplified + # into an equivalent reference, and the outer definitions won't be equivalent until we've simplified + # the inner definitions. + copied_definitions = deepcopy(definitions) + definitions_schema = {'$defs': copied_definitions} + for _iter in range(100): # prevent an infinite loop in the case of a bug, 100 iterations should be enough + # For every possible remapped DefsRef, collect all schemas that that DefsRef might be used for: + schemas_for_alternatives: dict[DefsRef, list[JsonSchemaValue]] = defaultdict(list) + for defs_ref in copied_definitions: + alternatives = prioritized_choices[defs_ref] + for alternative in alternatives: + schemas_for_alternatives[alternative].append(copied_definitions[defs_ref]) + + # Deduplicate the schemas for each alternative; the idea is that we only want to remap to a new DefsRef + # if it introduces no ambiguity, i.e., there is only one distinct schema for that DefsRef. + for defs_ref, schemas in schemas_for_alternatives.items(): + schemas_for_alternatives[defs_ref] = _deduplicate_schemas(schemas_for_alternatives[defs_ref]) + + # Build the remapping + defs_remapping: dict[DefsRef, DefsRef] = {} + json_remapping: dict[JsonRef, JsonRef] = {} + for original_defs_ref in definitions: + alternatives = prioritized_choices[original_defs_ref] + # Pick the first alternative that has only one schema, since that means there is no collision + remapped_defs_ref = next(x for x in alternatives if len(schemas_for_alternatives[x]) == 1) + defs_remapping[original_defs_ref] = remapped_defs_ref + json_remapping[defs_to_json[original_defs_ref]] = defs_to_json[remapped_defs_ref] + remapping = _DefinitionsRemapping(defs_remapping, json_remapping) + new_definitions_schema = remapping.remap_json_schema({'$defs': copied_definitions}) + if definitions_schema == new_definitions_schema: + # We've reached the fixed point + return remapping + definitions_schema = new_definitions_schema + + raise PydanticInvalidForJsonSchema('Failed to simplify the JSON schema definitions') + + def remap_defs_ref(self, ref: DefsRef) -> DefsRef: + return self.defs_remapping.get(ref, ref) + + def remap_json_ref(self, ref: JsonRef) -> JsonRef: + return self.json_remapping.get(ref, ref) + + def remap_json_schema(self, schema: Any) -> Any: + """ + Recursively update the JSON schema replacing all $refs + """ + if isinstance(schema, str): + # Note: this may not really be a JsonRef; we rely on having no collisions between JsonRefs and other strings + return self.remap_json_ref(JsonRef(schema)) + elif isinstance(schema, list): + return [self.remap_json_schema(item) for item in schema] + elif isinstance(schema, dict): + for key, value in schema.items(): + if key == '$ref' and isinstance(value, str): + schema['$ref'] = self.remap_json_ref(JsonRef(value)) + elif key == '$defs': + schema['$defs'] = { + self.remap_defs_ref(DefsRef(key)): self.remap_json_schema(value) + for key, value in schema['$defs'].items() + } + else: + schema[key] = self.remap_json_schema(value) + return schema + + +class GenerateJsonSchema: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/json_schema/#customizing-the-json-schema-generation-process + + A class for generating JSON schemas. + + This class generates JSON schemas based on configured parameters. The default schema dialect + is [https://json-schema.org/draft/2020-12/schema](https://json-schema.org/draft/2020-12/schema). + The class uses `by_alias` to configure how fields with + multiple names are handled and `ref_template` to format reference names. + + Attributes: + schema_dialect: The JSON schema dialect used to generate the schema. See + [Declaring a Dialect](https://json-schema.org/understanding-json-schema/reference/schema.html#id4) + in the JSON Schema documentation for more information about dialects. + ignored_warning_kinds: Warnings to ignore when generating the schema. `self.render_warning_message` will + do nothing if its argument `kind` is in `ignored_warning_kinds`; + this value can be modified on subclasses to easily control which warnings are emitted. + by_alias: Whether to use field aliases when generating the schema. + ref_template: The format string used when generating reference names. + core_to_json_refs: A mapping of core refs to JSON refs. + core_to_defs_refs: A mapping of core refs to definition refs. + defs_to_core_refs: A mapping of definition refs to core refs. + json_to_defs_refs: A mapping of JSON refs to definition refs. + definitions: Definitions in the schema. + + Args: + by_alias: Whether to use field aliases in the generated schemas. + ref_template: The format string to use when generating reference names. + + Raises: + JsonSchemaError: If the instance of the class is inadvertently re-used after generating a schema. + """ + + schema_dialect = 'https://json-schema.org/draft/2020-12/schema' + + # `self.render_warning_message` will do nothing if its argument `kind` is in `ignored_warning_kinds`; + # this value can be modified on subclasses to easily control which warnings are emitted + ignored_warning_kinds: set[JsonSchemaWarningKind] = {'skipped-choice'} + + def __init__(self, by_alias: bool = True, ref_template: str = DEFAULT_REF_TEMPLATE): + self.by_alias = by_alias + self.ref_template = ref_template + + self.core_to_json_refs: dict[CoreModeRef, JsonRef] = {} + self.core_to_defs_refs: dict[CoreModeRef, DefsRef] = {} + self.defs_to_core_refs: dict[DefsRef, CoreModeRef] = {} + self.json_to_defs_refs: dict[JsonRef, DefsRef] = {} + + self.definitions: dict[DefsRef, JsonSchemaValue] = {} + self._config_wrapper_stack = _config.ConfigWrapperStack(_config.ConfigWrapper({})) + + self._mode: JsonSchemaMode = 'validation' + + # The following includes a mapping of a fully-unique defs ref choice to a list of preferred + # alternatives, which are generally simpler, such as only including the class name. + # At the end of schema generation, we use these to produce a JSON schema with more human-readable + # definitions, which would also work better in a generated OpenAPI client, etc. + self._prioritized_defsref_choices: dict[DefsRef, list[DefsRef]] = {} + self._collision_counter: dict[str, int] = defaultdict(int) + self._collision_index: dict[str, int] = {} + + self._schema_type_to_method = self.build_schema_type_to_method() + + # When we encounter definitions we need to try to build them immediately + # so that they are available schemas that reference them + # But it's possible that CoreSchema was never going to be used + # (e.g. because the CoreSchema that references short circuits is JSON schema generation without needing + # the reference) so instead of failing altogether if we can't build a definition we + # store the error raised and re-throw it if we end up needing that def + self._core_defs_invalid_for_json_schema: dict[DefsRef, PydanticInvalidForJsonSchema] = {} + + # This changes to True after generating a schema, to prevent issues caused by accidental re-use + # of a single instance of a schema generator + self._used = False + + @property + def _config(self) -> _config.ConfigWrapper: + return self._config_wrapper_stack.tail + + @property + def mode(self) -> JsonSchemaMode: + if self._config.json_schema_mode_override is not None: + return self._config.json_schema_mode_override + else: + return self._mode + + def build_schema_type_to_method( + self, + ) -> dict[CoreSchemaOrFieldType, Callable[[CoreSchemaOrField], JsonSchemaValue]]: + """Builds a dictionary mapping fields to methods for generating JSON schemas. + + Returns: + A dictionary containing the mapping of `CoreSchemaOrFieldType` to a handler method. + + Raises: + TypeError: If no method has been defined for generating a JSON schema for a given pydantic core schema type. + """ + mapping: dict[CoreSchemaOrFieldType, Callable[[CoreSchemaOrField], JsonSchemaValue]] = {} + core_schema_types: list[CoreSchemaOrFieldType] = _typing_extra.all_literal_values( + CoreSchemaOrFieldType # type: ignore + ) + for key in core_schema_types: + method_name = f"{key.replace('-', '_')}_schema" + try: + mapping[key] = getattr(self, method_name) + except AttributeError as e: # pragma: no cover + raise TypeError( + f'No method for generating JsonSchema for core_schema.type={key!r} ' + f'(expected: {type(self).__name__}.{method_name})' + ) from e + return mapping + + def generate_definitions( + self, inputs: Sequence[tuple[JsonSchemaKeyT, JsonSchemaMode, core_schema.CoreSchema]] + ) -> tuple[dict[tuple[JsonSchemaKeyT, JsonSchemaMode], JsonSchemaValue], dict[DefsRef, JsonSchemaValue]]: + """Generates JSON schema definitions from a list of core schemas, pairing the generated definitions with a + mapping that links the input keys to the definition references. + + Args: + inputs: A sequence of tuples, where: + + - The first element is a JSON schema key type. + - The second element is the JSON mode: either 'validation' or 'serialization'. + - The third element is a core schema. + + Returns: + A tuple where: + + - The first element is a dictionary whose keys are tuples of JSON schema key type and JSON mode, and + whose values are the JSON schema corresponding to that pair of inputs. (These schemas may have + JsonRef references to definitions that are defined in the second returned element.) + - The second element is a dictionary whose keys are definition references for the JSON schemas + from the first returned element, and whose values are the actual JSON schema definitions. + + Raises: + PydanticUserError: Raised if the JSON schema generator has already been used to generate a JSON schema. + """ + if self._used: + raise PydanticUserError( + 'This JSON schema generator has already been used to generate a JSON schema. ' + f'You must create a new instance of {type(self).__name__} to generate a new JSON schema.', + code='json-schema-already-used', + ) + + for key, mode, schema in inputs: + self._mode = mode + self.generate_inner(schema) + + definitions_remapping = self._build_definitions_remapping() + + json_schemas_map: dict[tuple[JsonSchemaKeyT, JsonSchemaMode], DefsRef] = {} + for key, mode, schema in inputs: + self._mode = mode + json_schema = self.generate_inner(schema) + json_schemas_map[(key, mode)] = definitions_remapping.remap_json_schema(json_schema) + + json_schema = {'$defs': self.definitions} + json_schema = definitions_remapping.remap_json_schema(json_schema) + self._used = True + return json_schemas_map, _sort_json_schema(json_schema['$defs']) # type: ignore + + def generate(self, schema: CoreSchema, mode: JsonSchemaMode = 'validation') -> JsonSchemaValue: + """Generates a JSON schema for a specified schema in a specified mode. + + Args: + schema: A Pydantic model. + mode: The mode in which to generate the schema. Defaults to 'validation'. + + Returns: + A JSON schema representing the specified schema. + + Raises: + PydanticUserError: If the JSON schema generator has already been used to generate a JSON schema. + """ + self._mode = mode + if self._used: + raise PydanticUserError( + 'This JSON schema generator has already been used to generate a JSON schema. ' + f'You must create a new instance of {type(self).__name__} to generate a new JSON schema.', + code='json-schema-already-used', + ) + + json_schema: JsonSchemaValue = self.generate_inner(schema) + json_ref_counts = self.get_json_ref_counts(json_schema) + + # Remove the top-level $ref if present; note that the _generate method already ensures there are no sibling keys + ref = cast(JsonRef, json_schema.get('$ref')) + while ref is not None: # may need to unpack multiple levels + ref_json_schema = self.get_schema_from_definitions(ref) + if json_ref_counts[ref] > 1 or ref_json_schema is None: + # Keep the ref, but use an allOf to remove the top level $ref + json_schema = {'allOf': [{'$ref': ref}]} + else: + # "Unpack" the ref since this is the only reference + json_schema = ref_json_schema.copy() # copy to prevent recursive dict reference + json_ref_counts[ref] -= 1 + ref = cast(JsonRef, json_schema.get('$ref')) + + self._garbage_collect_definitions(json_schema) + definitions_remapping = self._build_definitions_remapping() + + if self.definitions: + json_schema['$defs'] = self.definitions + + json_schema = definitions_remapping.remap_json_schema(json_schema) + + # For now, we will not set the $schema key. However, if desired, this can be easily added by overriding + # this method and adding the following line after a call to super().generate(schema): + # json_schema['$schema'] = self.schema_dialect + + self._used = True + return _sort_json_schema(json_schema) + + def generate_inner(self, schema: CoreSchemaOrField) -> JsonSchemaValue: # noqa: C901 + """Generates a JSON schema for a given core schema. + + Args: + schema: The given core schema. + + Returns: + The generated JSON schema. + """ + # If a schema with the same CoreRef has been handled, just return a reference to it + # Note that this assumes that it will _never_ be the case that the same CoreRef is used + # on types that should have different JSON schemas + if 'ref' in schema: + core_ref = CoreRef(schema['ref']) # type: ignore[typeddict-item] + core_mode_ref = (core_ref, self.mode) + if core_mode_ref in self.core_to_defs_refs and self.core_to_defs_refs[core_mode_ref] in self.definitions: + return {'$ref': self.core_to_json_refs[core_mode_ref]} + + # Generate the JSON schema, accounting for the json_schema_override and core_schema_override + metadata_handler = _core_metadata.CoreMetadataHandler(schema) + + def populate_defs(core_schema: CoreSchema, json_schema: JsonSchemaValue) -> JsonSchemaValue: + if 'ref' in core_schema: + core_ref = CoreRef(core_schema['ref']) # type: ignore[typeddict-item] + defs_ref, ref_json_schema = self.get_cache_defs_ref_schema(core_ref) + json_ref = JsonRef(ref_json_schema['$ref']) + self.json_to_defs_refs[json_ref] = defs_ref + # Replace the schema if it's not a reference to itself + # What we want to avoid is having the def be just a ref to itself + # which is what would happen if we blindly assigned any + if json_schema.get('$ref', None) != json_ref: + self.definitions[defs_ref] = json_schema + self._core_defs_invalid_for_json_schema.pop(defs_ref, None) + json_schema = ref_json_schema + return json_schema + + def convert_to_all_of(json_schema: JsonSchemaValue) -> JsonSchemaValue: + if '$ref' in json_schema and len(json_schema.keys()) > 1: + # technically you can't have any other keys next to a "$ref" + # but it's an easy mistake to make and not hard to correct automatically here + json_schema = json_schema.copy() + ref = json_schema.pop('$ref') + json_schema = {'allOf': [{'$ref': ref}], **json_schema} + return json_schema + + def handler_func(schema_or_field: CoreSchemaOrField) -> JsonSchemaValue: + """Generate a JSON schema based on the input schema. + + Args: + schema_or_field: The core schema to generate a JSON schema from. + + Returns: + The generated JSON schema. + + Raises: + TypeError: If an unexpected schema type is encountered. + """ + # Generate the core-schema-type-specific bits of the schema generation: + json_schema: JsonSchemaValue | None = None + if self.mode == 'serialization' and 'serialization' in schema_or_field: + ser_schema = schema_or_field['serialization'] # type: ignore + json_schema = self.ser_schema(ser_schema) + if json_schema is None: + if _core_utils.is_core_schema(schema_or_field) or _core_utils.is_core_schema_field(schema_or_field): + generate_for_schema_type = self._schema_type_to_method[schema_or_field['type']] + json_schema = generate_for_schema_type(schema_or_field) + else: + raise TypeError(f'Unexpected schema type: schema={schema_or_field}') + if _core_utils.is_core_schema(schema_or_field): + json_schema = populate_defs(schema_or_field, json_schema) + json_schema = convert_to_all_of(json_schema) + return json_schema + + current_handler = _schema_generation_shared.GenerateJsonSchemaHandler(self, handler_func) + + for js_modify_function in metadata_handler.metadata.get('pydantic_js_functions', ()): + + def new_handler_func( + schema_or_field: CoreSchemaOrField, + current_handler: GetJsonSchemaHandler = current_handler, + js_modify_function: GetJsonSchemaFunction = js_modify_function, + ) -> JsonSchemaValue: + json_schema = js_modify_function(schema_or_field, current_handler) + if _core_utils.is_core_schema(schema_or_field): + json_schema = populate_defs(schema_or_field, json_schema) + original_schema = current_handler.resolve_ref_schema(json_schema) + ref = json_schema.pop('$ref', None) + if ref and json_schema: + original_schema.update(json_schema) + return original_schema + + current_handler = _schema_generation_shared.GenerateJsonSchemaHandler(self, new_handler_func) + + for js_modify_function in metadata_handler.metadata.get('pydantic_js_annotation_functions', ()): + + def new_handler_func( + schema_or_field: CoreSchemaOrField, + current_handler: GetJsonSchemaHandler = current_handler, + js_modify_function: GetJsonSchemaFunction = js_modify_function, + ) -> JsonSchemaValue: + json_schema = js_modify_function(schema_or_field, current_handler) + if _core_utils.is_core_schema(schema_or_field): + json_schema = populate_defs(schema_or_field, json_schema) + json_schema = convert_to_all_of(json_schema) + return json_schema + + current_handler = _schema_generation_shared.GenerateJsonSchemaHandler(self, new_handler_func) + + json_schema = current_handler(schema) + if _core_utils.is_core_schema(schema): + json_schema = populate_defs(schema, json_schema) + json_schema = convert_to_all_of(json_schema) + return json_schema + + # ### Schema generation methods + def any_schema(self, schema: core_schema.AnySchema) -> JsonSchemaValue: + """Generates a JSON schema that matches any value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return {} + + def none_schema(self, schema: core_schema.NoneSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches `None`. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return {'type': 'null'} + + def bool_schema(self, schema: core_schema.BoolSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a bool value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return {'type': 'boolean'} + + def int_schema(self, schema: core_schema.IntSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches an int value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema: dict[str, Any] = {'type': 'integer'} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.numeric) + json_schema = {k: v for k, v in json_schema.items() if v not in {math.inf, -math.inf}} + return json_schema + + def float_schema(self, schema: core_schema.FloatSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a float value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema: dict[str, Any] = {'type': 'number'} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.numeric) + json_schema = {k: v for k, v in json_schema.items() if v not in {math.inf, -math.inf}} + return json_schema + + def decimal_schema(self, schema: core_schema.DecimalSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a decimal value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema = self.str_schema(core_schema.str_schema()) + if self.mode == 'validation': + multiple_of = schema.get('multiple_of') + le = schema.get('le') + ge = schema.get('ge') + lt = schema.get('lt') + gt = schema.get('gt') + json_schema = { + 'anyOf': [ + self.float_schema( + core_schema.float_schema( + allow_inf_nan=schema.get('allow_inf_nan'), + multiple_of=None if multiple_of is None else float(multiple_of), + le=None if le is None else float(le), + ge=None if ge is None else float(ge), + lt=None if lt is None else float(lt), + gt=None if gt is None else float(gt), + ) + ), + json_schema, + ], + } + return json_schema + + def str_schema(self, schema: core_schema.StringSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a string value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema = {'type': 'string'} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.string) + if isinstance(json_schema.get('pattern'), Pattern): + # TODO: should we add regex flags to the pattern? + json_schema['pattern'] = json_schema.get('pattern').pattern # type: ignore + return json_schema + + def bytes_schema(self, schema: core_schema.BytesSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a bytes value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema = {'type': 'string', 'format': 'base64url' if self._config.ser_json_bytes == 'base64' else 'binary'} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.bytes) + return json_schema + + def date_schema(self, schema: core_schema.DateSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a date value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema = {'type': 'string', 'format': 'date'} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.date) + return json_schema + + def time_schema(self, schema: core_schema.TimeSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a time value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return {'type': 'string', 'format': 'time'} + + def datetime_schema(self, schema: core_schema.DatetimeSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a datetime value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return {'type': 'string', 'format': 'date-time'} + + def timedelta_schema(self, schema: core_schema.TimedeltaSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a timedelta value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + if self._config.ser_json_timedelta == 'float': + return {'type': 'number'} + return {'type': 'string', 'format': 'duration'} + + def literal_schema(self, schema: core_schema.LiteralSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a literal value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + expected = [v.value if isinstance(v, Enum) else v for v in schema['expected']] + # jsonify the expected values + expected = [to_jsonable_python(v) for v in expected] + + result: dict[str, Any] = {'enum': expected} + if len(expected) == 1: + result['const'] = expected[0] + + types = {type(e) for e in expected} + if types == {str}: + result['type'] = 'string' + elif types == {int}: + result['type'] = 'integer' + elif types == {float}: + result['type'] = 'numeric' + elif types == {bool}: + result['type'] = 'boolean' + elif types == {list}: + result['type'] = 'array' + elif types == {type(None)}: + result['type'] = 'null' + return result + + def enum_schema(self, schema: core_schema.EnumSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches an Enum value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + enum_type = schema['cls'] + description = None if not enum_type.__doc__ else inspect.cleandoc(enum_type.__doc__) + if ( + description == 'An enumeration.' + ): # This is the default value provided by enum.EnumMeta.__new__; don't use it + description = None + result: dict[str, Any] = {'title': enum_type.__name__, 'description': description} + result = {k: v for k, v in result.items() if v is not None} + + expected = [to_jsonable_python(v.value) for v in schema['members']] + + result['enum'] = expected + if len(expected) == 1: + result['const'] = expected[0] + + types = {type(e) for e in expected} + if isinstance(enum_type, str) or types == {str}: + result['type'] = 'string' + elif isinstance(enum_type, int) or types == {int}: + result['type'] = 'integer' + elif isinstance(enum_type, float) or types == {float}: + result['type'] = 'numeric' + elif types == {bool}: + result['type'] = 'boolean' + elif types == {list}: + result['type'] = 'array' + + return result + + def is_instance_schema(self, schema: core_schema.IsInstanceSchema) -> JsonSchemaValue: + """Handles JSON schema generation for a core schema that checks if a value is an instance of a class. + + Unless overridden in a subclass, this raises an error. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.handle_invalid_for_json_schema(schema, f'core_schema.IsInstanceSchema ({schema["cls"]})') + + def is_subclass_schema(self, schema: core_schema.IsSubclassSchema) -> JsonSchemaValue: + """Handles JSON schema generation for a core schema that checks if a value is a subclass of a class. + + For backwards compatibility with v1, this does not raise an error, but can be overridden to change this. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + # Note: This is for compatibility with V1; you can override if you want different behavior. + return {} + + def callable_schema(self, schema: core_schema.CallableSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a callable value. + + Unless overridden in a subclass, this raises an error. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.handle_invalid_for_json_schema(schema, 'core_schema.CallableSchema') + + def list_schema(self, schema: core_schema.ListSchema) -> JsonSchemaValue: + """Returns a schema that matches a list schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + items_schema = {} if 'items_schema' not in schema else self.generate_inner(schema['items_schema']) + json_schema = {'type': 'array', 'items': items_schema} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.array) + return json_schema + + @deprecated('`tuple_positional_schema` is deprecated. Use `tuple_schema` instead.', category=None) + @final + def tuple_positional_schema(self, schema: core_schema.TupleSchema) -> JsonSchemaValue: + """Replaced by `tuple_schema`.""" + warnings.warn( + '`tuple_positional_schema` is deprecated. Use `tuple_schema` instead.', + PydanticDeprecatedSince26, + stacklevel=2, + ) + return self.tuple_schema(schema) + + @deprecated('`tuple_variable_schema` is deprecated. Use `tuple_schema` instead.', category=None) + @final + def tuple_variable_schema(self, schema: core_schema.TupleSchema) -> JsonSchemaValue: + """Replaced by `tuple_schema`.""" + warnings.warn( + '`tuple_variable_schema` is deprecated. Use `tuple_schema` instead.', + PydanticDeprecatedSince26, + stacklevel=2, + ) + return self.tuple_schema(schema) + + def tuple_schema(self, schema: core_schema.TupleSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a tuple schema e.g. `Tuple[int, + str, bool]` or `Tuple[int, ...]`. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema: JsonSchemaValue = {'type': 'array'} + if 'variadic_item_index' in schema: + variadic_item_index = schema['variadic_item_index'] + if variadic_item_index > 0: + json_schema['minItems'] = variadic_item_index + json_schema['prefixItems'] = [ + self.generate_inner(item) for item in schema['items_schema'][:variadic_item_index] + ] + if variadic_item_index + 1 == len(schema['items_schema']): + # if the variadic item is the last item, then represent it faithfully + json_schema['items'] = self.generate_inner(schema['items_schema'][variadic_item_index]) + else: + # otherwise, 'items' represents the schema for the variadic + # item plus the suffix, so just allow anything for simplicity + # for now + json_schema['items'] = True + else: + prefixItems = [self.generate_inner(item) for item in schema['items_schema']] + if prefixItems: + json_schema['prefixItems'] = prefixItems + json_schema['minItems'] = len(prefixItems) + json_schema['maxItems'] = len(prefixItems) + self.update_with_validations(json_schema, schema, self.ValidationsMapping.array) + return json_schema + + def set_schema(self, schema: core_schema.SetSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a set schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self._common_set_schema(schema) + + def frozenset_schema(self, schema: core_schema.FrozenSetSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a frozenset schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self._common_set_schema(schema) + + def _common_set_schema(self, schema: core_schema.SetSchema | core_schema.FrozenSetSchema) -> JsonSchemaValue: + items_schema = {} if 'items_schema' not in schema else self.generate_inner(schema['items_schema']) + json_schema = {'type': 'array', 'uniqueItems': True, 'items': items_schema} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.array) + return json_schema + + def generator_schema(self, schema: core_schema.GeneratorSchema) -> JsonSchemaValue: + """Returns a JSON schema that represents the provided GeneratorSchema. + + Args: + schema: The schema. + + Returns: + The generated JSON schema. + """ + items_schema = {} if 'items_schema' not in schema else self.generate_inner(schema['items_schema']) + json_schema = {'type': 'array', 'items': items_schema} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.array) + return json_schema + + def dict_schema(self, schema: core_schema.DictSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a dict schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema: JsonSchemaValue = {'type': 'object'} + + keys_schema = self.generate_inner(schema['keys_schema']).copy() if 'keys_schema' in schema else {} + keys_pattern = keys_schema.pop('pattern', None) + + values_schema = self.generate_inner(schema['values_schema']).copy() if 'values_schema' in schema else {} + values_schema.pop('title', None) # don't give a title to the additionalProperties + if values_schema or keys_pattern is not None: # don't add additionalProperties if it's empty + if keys_pattern is None: + json_schema['additionalProperties'] = values_schema + else: + json_schema['patternProperties'] = {keys_pattern: values_schema} + + self.update_with_validations(json_schema, schema, self.ValidationsMapping.object) + return json_schema + + def _function_schema( + self, + schema: _core_utils.AnyFunctionSchema, + ) -> JsonSchemaValue: + if _core_utils.is_function_with_inner_schema(schema): + # This could be wrong if the function's mode is 'before', but in practice will often be right, and when it + # isn't, I think it would be hard to automatically infer what the desired schema should be. + return self.generate_inner(schema['schema']) + + # function-plain + return self.handle_invalid_for_json_schema( + schema, f'core_schema.PlainValidatorFunctionSchema ({schema["function"]})' + ) + + def function_before_schema(self, schema: core_schema.BeforeValidatorFunctionSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a function-before schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self._function_schema(schema) + + def function_after_schema(self, schema: core_schema.AfterValidatorFunctionSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a function-after schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self._function_schema(schema) + + def function_plain_schema(self, schema: core_schema.PlainValidatorFunctionSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a function-plain schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self._function_schema(schema) + + def function_wrap_schema(self, schema: core_schema.WrapValidatorFunctionSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a function-wrap schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self._function_schema(schema) + + def default_schema(self, schema: core_schema.WithDefaultSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema with a default value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema = self.generate_inner(schema['schema']) + + if 'default' not in schema: + return json_schema + default = schema['default'] + # Note: if you want to include the value returned by the default_factory, + # override this method and replace the code above with: + # if 'default' in schema: + # default = schema['default'] + # elif 'default_factory' in schema: + # default = schema['default_factory']() + # else: + # return json_schema + + # we reflect the application of custom plain, no-info serializers to defaults for + # json schemas viewed in serialization mode + # TODO: improvements along with https://github.com/pydantic/pydantic/issues/8208 + # TODO: improve type safety here + if self.mode == 'serialization': + if ( + (ser_schema := schema['schema'].get('serialization', {})) + and (ser_func := ser_schema.get('function')) + and ser_schema.get('type') == 'function-plain' # type: ignore + and ser_schema.get('info_arg') is False # type: ignore + ): + default = ser_func(default) # type: ignore + + try: + encoded_default = self.encode_default(default) + except pydantic_core.PydanticSerializationError: + self.emit_warning( + 'non-serializable-default', + f'Default value {default} is not JSON serializable; excluding default from JSON schema', + ) + # Return the inner schema, as though there was no default + return json_schema + + if '$ref' in json_schema: + # Since reference schemas do not support child keys, we wrap the reference schema in a single-case allOf: + return {'allOf': [json_schema], 'default': encoded_default} + else: + json_schema['default'] = encoded_default + return json_schema + + def nullable_schema(self, schema: core_schema.NullableSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that allows null values. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + null_schema = {'type': 'null'} + inner_json_schema = self.generate_inner(schema['schema']) + + if inner_json_schema == null_schema: + return null_schema + else: + # Thanks to the equality check against `null_schema` above, I think 'oneOf' would also be valid here; + # I'll use 'anyOf' for now, but it could be changed it if it would work better with some external tooling + return self.get_flattened_anyof([inner_json_schema, null_schema]) + + def union_schema(self, schema: core_schema.UnionSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that allows values matching any of the given schemas. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + generated: list[JsonSchemaValue] = [] + + choices = schema['choices'] + for choice in choices: + # choice will be a tuple if an explicit label was provided + choice_schema = choice[0] if isinstance(choice, tuple) else choice + try: + generated.append(self.generate_inner(choice_schema)) + except PydanticOmit: + continue + except PydanticInvalidForJsonSchema as exc: + self.emit_warning('skipped-choice', exc.message) + if len(generated) == 1: + return generated[0] + return self.get_flattened_anyof(generated) + + def tagged_union_schema(self, schema: core_schema.TaggedUnionSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that allows values matching any of the given schemas, where + the schemas are tagged with a discriminator field that indicates which schema should be used to validate + the value. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + generated: dict[str, JsonSchemaValue] = {} + for k, v in schema['choices'].items(): + if isinstance(k, Enum): + k = k.value + try: + # Use str(k) since keys must be strings for json; while not technically correct, + # it's the closest that can be represented in valid JSON + generated[str(k)] = self.generate_inner(v).copy() + except PydanticOmit: + continue + except PydanticInvalidForJsonSchema as exc: + self.emit_warning('skipped-choice', exc.message) + + one_of_choices = _deduplicate_schemas(generated.values()) + json_schema: JsonSchemaValue = {'oneOf': one_of_choices} + + # This reflects the v1 behavior; TODO: we should make it possible to exclude OpenAPI stuff from the JSON schema + openapi_discriminator = self._extract_discriminator(schema, one_of_choices) + if openapi_discriminator is not None: + json_schema['discriminator'] = { + 'propertyName': openapi_discriminator, + 'mapping': {k: v.get('$ref', v) for k, v in generated.items()}, + } + + return json_schema + + def _extract_discriminator( + self, schema: core_schema.TaggedUnionSchema, one_of_choices: list[JsonDict] + ) -> str | None: + """Extract a compatible OpenAPI discriminator from the schema and one_of choices that end up in the final + schema.""" + openapi_discriminator: str | None = None + + if isinstance(schema['discriminator'], str): + return schema['discriminator'] + + if isinstance(schema['discriminator'], list): + # If the discriminator is a single item list containing a string, that is equivalent to the string case + if len(schema['discriminator']) == 1 and isinstance(schema['discriminator'][0], str): + return schema['discriminator'][0] + # When an alias is used that is different from the field name, the discriminator will be a list of single + # str lists, one for the attribute and one for the actual alias. The logic here will work even if there is + # more than one possible attribute, and looks for whether a single alias choice is present as a documented + # property on all choices. If so, that property will be used as the OpenAPI discriminator. + for alias_path in schema['discriminator']: + if not isinstance(alias_path, list): + break # this means that the discriminator is not a list of alias paths + if len(alias_path) != 1: + continue # this means that the "alias" does not represent a single field + alias = alias_path[0] + if not isinstance(alias, str): + continue # this means that the "alias" does not represent a field + alias_is_present_on_all_choices = True + for choice in one_of_choices: + while '$ref' in choice: + assert isinstance(choice['$ref'], str) + choice = self.get_schema_from_definitions(JsonRef(choice['$ref'])) or {} + properties = choice.get('properties', {}) + if not isinstance(properties, dict) or alias not in properties: + alias_is_present_on_all_choices = False + break + if alias_is_present_on_all_choices: + openapi_discriminator = alias + break + return openapi_discriminator + + def chain_schema(self, schema: core_schema.ChainSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a core_schema.ChainSchema. + + When generating a schema for validation, we return the validation JSON schema for the first step in the chain. + For serialization, we return the serialization JSON schema for the last step in the chain. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + step_index = 0 if self.mode == 'validation' else -1 # use first step for validation, last for serialization + return self.generate_inner(schema['steps'][step_index]) + + def lax_or_strict_schema(self, schema: core_schema.LaxOrStrictSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that allows values matching either the lax schema or the + strict schema. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + # TODO: Need to read the default value off of model config or whatever + use_strict = schema.get('strict', False) # TODO: replace this default False + # If your JSON schema fails to generate it is probably + # because one of the following two branches failed. + if use_strict: + return self.generate_inner(schema['strict_schema']) + else: + return self.generate_inner(schema['lax_schema']) + + def json_or_python_schema(self, schema: core_schema.JsonOrPythonSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that allows values matching either the JSON schema or the + Python schema. + + The JSON schema is used instead of the Python schema. If you want to use the Python schema, you should override + this method. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.generate_inner(schema['json_schema']) + + def typed_dict_schema(self, schema: core_schema.TypedDictSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a typed dict. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + total = schema.get('total', True) + named_required_fields: list[tuple[str, bool, CoreSchemaField]] = [ + (name, self.field_is_required(field, total), field) + for name, field in schema['fields'].items() + if self.field_is_present(field) + ] + if self.mode == 'serialization': + named_required_fields.extend(self._name_required_computed_fields(schema.get('computed_fields', []))) + cls = _get_typed_dict_cls(schema) + config = _get_typed_dict_config(cls) + with self._config_wrapper_stack.push(config): + json_schema = self._named_required_fields_schema(named_required_fields) + + json_schema_extra = config.get('json_schema_extra') + extra = schema.get('extra_behavior') + if extra is None: + extra = config.get('extra', 'ignore') + + if cls is not None: + title = config.get('title') or cls.__name__ + json_schema = self._update_class_schema(json_schema, title, extra, cls, json_schema_extra) + else: + if extra == 'forbid': + json_schema['additionalProperties'] = False + elif extra == 'allow': + json_schema['additionalProperties'] = True + + return json_schema + + @staticmethod + def _name_required_computed_fields( + computed_fields: list[ComputedField], + ) -> list[tuple[str, bool, core_schema.ComputedField]]: + return [(field['property_name'], True, field) for field in computed_fields] + + def _named_required_fields_schema( + self, named_required_fields: Sequence[tuple[str, bool, CoreSchemaField]] + ) -> JsonSchemaValue: + properties: dict[str, JsonSchemaValue] = {} + required_fields: list[str] = [] + for name, required, field in named_required_fields: + if self.by_alias: + name = self._get_alias_name(field, name) + try: + field_json_schema = self.generate_inner(field).copy() + except PydanticOmit: + continue + if 'title' not in field_json_schema and self.field_title_should_be_set(field): + title = self.get_title_from_name(name) + field_json_schema['title'] = title + field_json_schema = self.handle_ref_overrides(field_json_schema) + properties[name] = field_json_schema + if required: + required_fields.append(name) + + json_schema = {'type': 'object', 'properties': properties} + if required_fields: + json_schema['required'] = required_fields + return json_schema + + def _get_alias_name(self, field: CoreSchemaField, name: str) -> str: + if field['type'] == 'computed-field': + alias: Any = field.get('alias', name) + elif self.mode == 'validation': + alias = field.get('validation_alias', name) + else: + alias = field.get('serialization_alias', name) + if isinstance(alias, str): + name = alias + elif isinstance(alias, list): + alias = cast('list[str] | str', alias) + for path in alias: + if isinstance(path, list) and len(path) == 1 and isinstance(path[0], str): + # Use the first valid single-item string path; the code that constructs the alias array + # should ensure the first such item is what belongs in the JSON schema + name = path[0] + break + else: + assert_never(alias) + return name + + def typed_dict_field_schema(self, schema: core_schema.TypedDictField) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a typed dict field. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.generate_inner(schema['schema']) + + def dataclass_field_schema(self, schema: core_schema.DataclassField) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a dataclass field. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.generate_inner(schema['schema']) + + def model_field_schema(self, schema: core_schema.ModelField) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a model field. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.generate_inner(schema['schema']) + + def computed_field_schema(self, schema: core_schema.ComputedField) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a computed field. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.generate_inner(schema['return_schema']) + + def model_schema(self, schema: core_schema.ModelSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a model. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + # We do not use schema['model'].model_json_schema() here + # because it could lead to inconsistent refs handling, etc. + cls = cast('type[BaseModel]', schema['cls']) + config = cls.model_config + title = config.get('title') + + with self._config_wrapper_stack.push(config): + json_schema = self.generate_inner(schema['schema']) + + json_schema_extra = config.get('json_schema_extra') + if cls.__pydantic_root_model__: + root_json_schema_extra = cls.model_fields['root'].json_schema_extra + if json_schema_extra and root_json_schema_extra: + raise ValueError( + '"model_config[\'json_schema_extra\']" and "Field.json_schema_extra" on "RootModel.root"' + ' field must not be set simultaneously' + ) + if root_json_schema_extra: + json_schema_extra = root_json_schema_extra + + json_schema = self._update_class_schema(json_schema, title, config.get('extra', None), cls, json_schema_extra) + + return json_schema + + def _update_class_schema( + self, + json_schema: JsonSchemaValue, + title: str | None, + extra: Literal['allow', 'ignore', 'forbid'] | None, + cls: type[Any], + json_schema_extra: JsonDict | JsonSchemaExtraCallable | None, + ) -> JsonSchemaValue: + if '$ref' in json_schema: + schema_to_update = self.get_schema_from_definitions(JsonRef(json_schema['$ref'])) or json_schema + else: + schema_to_update = json_schema + + if title is not None: + # referenced_schema['title'] = title + schema_to_update.setdefault('title', title) + + if 'additionalProperties' not in schema_to_update: + if extra == 'allow': + schema_to_update['additionalProperties'] = True + elif extra == 'forbid': + schema_to_update['additionalProperties'] = False + + if isinstance(json_schema_extra, (staticmethod, classmethod)): + # In older versions of python, this is necessary to ensure staticmethod/classmethods are callable + json_schema_extra = json_schema_extra.__get__(cls) + + if isinstance(json_schema_extra, dict): + schema_to_update.update(json_schema_extra) + elif callable(json_schema_extra): + if len(inspect.signature(json_schema_extra).parameters) > 1: + json_schema_extra(schema_to_update, cls) # type: ignore + else: + json_schema_extra(schema_to_update) # type: ignore + elif json_schema_extra is not None: + raise ValueError( + f"model_config['json_schema_extra']={json_schema_extra} should be a dict, callable, or None" + ) + + if hasattr(cls, '__deprecated__'): + json_schema['deprecated'] = True + + return json_schema + + def resolve_schema_to_update(self, json_schema: JsonSchemaValue) -> JsonSchemaValue: + """Resolve a JsonSchemaValue to the non-ref schema if it is a $ref schema. + + Args: + json_schema: The schema to resolve. + + Returns: + The resolved schema. + """ + if '$ref' in json_schema: + schema_to_update = self.get_schema_from_definitions(JsonRef(json_schema['$ref'])) + if schema_to_update is None: + raise RuntimeError(f'Cannot update undefined schema for $ref={json_schema["$ref"]}') + return self.resolve_schema_to_update(schema_to_update) + else: + schema_to_update = json_schema + return schema_to_update + + def model_fields_schema(self, schema: core_schema.ModelFieldsSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a model's fields. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + named_required_fields: list[tuple[str, bool, CoreSchemaField]] = [ + (name, self.field_is_required(field, total=True), field) + for name, field in schema['fields'].items() + if self.field_is_present(field) + ] + if self.mode == 'serialization': + named_required_fields.extend(self._name_required_computed_fields(schema.get('computed_fields', []))) + json_schema = self._named_required_fields_schema(named_required_fields) + extras_schema = schema.get('extras_schema', None) + if extras_schema is not None: + schema_to_update = self.resolve_schema_to_update(json_schema) + schema_to_update['additionalProperties'] = self.generate_inner(extras_schema) + return json_schema + + def field_is_present(self, field: CoreSchemaField) -> bool: + """Whether the field should be included in the generated JSON schema. + + Args: + field: The schema for the field itself. + + Returns: + `True` if the field should be included in the generated JSON schema, `False` otherwise. + """ + if self.mode == 'serialization': + # If you still want to include the field in the generated JSON schema, + # override this method and return True + return not field.get('serialization_exclude') + elif self.mode == 'validation': + return True + else: + assert_never(self.mode) + + def field_is_required( + self, + field: core_schema.ModelField | core_schema.DataclassField | core_schema.TypedDictField, + total: bool, + ) -> bool: + """Whether the field should be marked as required in the generated JSON schema. + (Note that this is irrelevant if the field is not present in the JSON schema.). + + Args: + field: The schema for the field itself. + total: Only applies to `TypedDictField`s. + Indicates if the `TypedDict` this field belongs to is total, in which case any fields that don't + explicitly specify `required=False` are required. + + Returns: + `True` if the field should be marked as required in the generated JSON schema, `False` otherwise. + """ + if self.mode == 'serialization' and self._config.json_schema_serialization_defaults_required: + return not field.get('serialization_exclude') + else: + if field['type'] == 'typed-dict-field': + return field.get('required', total) + else: + return field['schema']['type'] != 'default' + + def dataclass_args_schema(self, schema: core_schema.DataclassArgsSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a dataclass's constructor arguments. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + named_required_fields: list[tuple[str, bool, CoreSchemaField]] = [ + (field['name'], self.field_is_required(field, total=True), field) + for field in schema['fields'] + if self.field_is_present(field) + ] + if self.mode == 'serialization': + named_required_fields.extend(self._name_required_computed_fields(schema.get('computed_fields', []))) + return self._named_required_fields_schema(named_required_fields) + + def dataclass_schema(self, schema: core_schema.DataclassSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a dataclass. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + cls = schema['cls'] + config: ConfigDict = getattr(cls, '__pydantic_config__', cast('ConfigDict', {})) + title = config.get('title') or cls.__name__ + + with self._config_wrapper_stack.push(config): + json_schema = self.generate_inner(schema['schema']).copy() + + json_schema_extra = config.get('json_schema_extra') + json_schema = self._update_class_schema(json_schema, title, config.get('extra', None), cls, json_schema_extra) + + # Dataclass-specific handling of description + if is_dataclass(cls) and not hasattr(cls, '__pydantic_validator__'): + # vanilla dataclass; don't use cls.__doc__ as it will contain the class signature by default + description = None + else: + description = None if cls.__doc__ is None else inspect.cleandoc(cls.__doc__) + if description: + json_schema['description'] = description + + return json_schema + + def arguments_schema(self, schema: core_schema.ArgumentsSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a function's arguments. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + metadata = _core_metadata.CoreMetadataHandler(schema).metadata + prefer_positional = metadata.get('pydantic_js_prefer_positional_arguments') + + arguments = schema['arguments_schema'] + kw_only_arguments = [a for a in arguments if a.get('mode') == 'keyword_only'] + kw_or_p_arguments = [a for a in arguments if a.get('mode') in {'positional_or_keyword', None}] + p_only_arguments = [a for a in arguments if a.get('mode') == 'positional_only'] + var_args_schema = schema.get('var_args_schema') + var_kwargs_schema = schema.get('var_kwargs_schema') + + if prefer_positional: + positional_possible = not kw_only_arguments and not var_kwargs_schema + if positional_possible: + return self.p_arguments_schema(p_only_arguments + kw_or_p_arguments, var_args_schema) + + keyword_possible = not p_only_arguments and not var_args_schema + if keyword_possible: + return self.kw_arguments_schema(kw_or_p_arguments + kw_only_arguments, var_kwargs_schema) + + if not prefer_positional: + positional_possible = not kw_only_arguments and not var_kwargs_schema + if positional_possible: + return self.p_arguments_schema(p_only_arguments + kw_or_p_arguments, var_args_schema) + + raise PydanticInvalidForJsonSchema( + 'Unable to generate JSON schema for arguments validator with positional-only and keyword-only arguments' + ) + + def kw_arguments_schema( + self, arguments: list[core_schema.ArgumentsParameter], var_kwargs_schema: CoreSchema | None + ) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a function's keyword arguments. + + Args: + arguments: The core schema. + + Returns: + The generated JSON schema. + """ + properties: dict[str, JsonSchemaValue] = {} + required: list[str] = [] + for argument in arguments: + name = self.get_argument_name(argument) + argument_schema = self.generate_inner(argument['schema']).copy() + argument_schema['title'] = self.get_title_from_name(name) + properties[name] = argument_schema + + if argument['schema']['type'] != 'default': + # This assumes that if the argument has a default value, + # the inner schema must be of type WithDefaultSchema. + # I believe this is true, but I am not 100% sure + required.append(name) + + json_schema: JsonSchemaValue = {'type': 'object', 'properties': properties} + if required: + json_schema['required'] = required + + if var_kwargs_schema: + additional_properties_schema = self.generate_inner(var_kwargs_schema) + if additional_properties_schema: + json_schema['additionalProperties'] = additional_properties_schema + else: + json_schema['additionalProperties'] = False + return json_schema + + def p_arguments_schema( + self, arguments: list[core_schema.ArgumentsParameter], var_args_schema: CoreSchema | None + ) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a function's positional arguments. + + Args: + arguments: The core schema. + + Returns: + The generated JSON schema. + """ + prefix_items: list[JsonSchemaValue] = [] + min_items = 0 + + for argument in arguments: + name = self.get_argument_name(argument) + + argument_schema = self.generate_inner(argument['schema']).copy() + argument_schema['title'] = self.get_title_from_name(name) + prefix_items.append(argument_schema) + + if argument['schema']['type'] != 'default': + # This assumes that if the argument has a default value, + # the inner schema must be of type WithDefaultSchema. + # I believe this is true, but I am not 100% sure + min_items += 1 + + json_schema: JsonSchemaValue = {'type': 'array', 'prefixItems': prefix_items} + if min_items: + json_schema['minItems'] = min_items + + if var_args_schema: + items_schema = self.generate_inner(var_args_schema) + if items_schema: + json_schema['items'] = items_schema + else: + json_schema['maxItems'] = len(prefix_items) + + return json_schema + + def get_argument_name(self, argument: core_schema.ArgumentsParameter) -> str: + """Retrieves the name of an argument. + + Args: + argument: The core schema. + + Returns: + The name of the argument. + """ + name = argument['name'] + if self.by_alias: + alias = argument.get('alias') + if isinstance(alias, str): + name = alias + else: + pass # might want to do something else? + return name + + def call_schema(self, schema: core_schema.CallSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a function call. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.generate_inner(schema['arguments_schema']) + + def custom_error_schema(self, schema: core_schema.CustomErrorSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a custom error. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return self.generate_inner(schema['schema']) + + def json_schema(self, schema: core_schema.JsonSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a JSON object. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + content_core_schema = schema.get('schema') or core_schema.any_schema() + content_json_schema = self.generate_inner(content_core_schema) + if self.mode == 'validation': + return {'type': 'string', 'contentMediaType': 'application/json', 'contentSchema': content_json_schema} + else: + # self.mode == 'serialization' + return content_json_schema + + def url_schema(self, schema: core_schema.UrlSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a URL. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + json_schema = {'type': 'string', 'format': 'uri', 'minLength': 1} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.string) + return json_schema + + def multi_host_url_schema(self, schema: core_schema.MultiHostUrlSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a URL that can be used with multiple hosts. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + # Note: 'multi-host-uri' is a custom/pydantic-specific format, not part of the JSON Schema spec + json_schema = {'type': 'string', 'format': 'multi-host-uri', 'minLength': 1} + self.update_with_validations(json_schema, schema, self.ValidationsMapping.string) + return json_schema + + def uuid_schema(self, schema: core_schema.UuidSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a UUID. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + return {'type': 'string', 'format': 'uuid'} + + def definitions_schema(self, schema: core_schema.DefinitionsSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that defines a JSON object with definitions. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + for definition in schema['definitions']: + try: + self.generate_inner(definition) + except PydanticInvalidForJsonSchema as e: + core_ref: CoreRef = CoreRef(definition['ref']) # type: ignore + self._core_defs_invalid_for_json_schema[self.get_defs_ref((core_ref, self.mode))] = e + continue + return self.generate_inner(schema['schema']) + + def definition_ref_schema(self, schema: core_schema.DefinitionReferenceSchema) -> JsonSchemaValue: + """Generates a JSON schema that matches a schema that references a definition. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + core_ref = CoreRef(schema['schema_ref']) + _, ref_json_schema = self.get_cache_defs_ref_schema(core_ref) + return ref_json_schema + + def ser_schema( + self, schema: core_schema.SerSchema | core_schema.IncExSeqSerSchema | core_schema.IncExDictSerSchema + ) -> JsonSchemaValue | None: + """Generates a JSON schema that matches a schema that defines a serialized object. + + Args: + schema: The core schema. + + Returns: + The generated JSON schema. + """ + schema_type = schema['type'] + if schema_type == 'function-plain' or schema_type == 'function-wrap': + # PlainSerializerFunctionSerSchema or WrapSerializerFunctionSerSchema + return_schema = schema.get('return_schema') + if return_schema is not None: + return self.generate_inner(return_schema) + elif schema_type == 'format' or schema_type == 'to-string': + # FormatSerSchema or ToStringSerSchema + return self.str_schema(core_schema.str_schema()) + elif schema['type'] == 'model': + # ModelSerSchema + return self.generate_inner(schema['schema']) + return None + + # ### Utility methods + + def get_title_from_name(self, name: str) -> str: + """Retrieves a title from a name. + + Args: + name: The name to retrieve a title from. + + Returns: + The title. + """ + return name.title().replace('_', ' ') + + def field_title_should_be_set(self, schema: CoreSchemaOrField) -> bool: + """Returns true if a field with the given schema should have a title set based on the field name. + + Intuitively, we want this to return true for schemas that wouldn't otherwise provide their own title + (e.g., int, float, str), and false for those that would (e.g., BaseModel subclasses). + + Args: + schema: The schema to check. + + Returns: + `True` if the field should have a title set, `False` otherwise. + """ + if _core_utils.is_core_schema_field(schema): + if schema['type'] == 'computed-field': + field_schema = schema['return_schema'] + else: + field_schema = schema['schema'] + return self.field_title_should_be_set(field_schema) + + elif _core_utils.is_core_schema(schema): + if schema.get('ref'): # things with refs, such as models and enums, should not have titles set + return False + if schema['type'] in {'default', 'nullable', 'definitions'}: + return self.field_title_should_be_set(schema['schema']) # type: ignore[typeddict-item] + if _core_utils.is_function_with_inner_schema(schema): + return self.field_title_should_be_set(schema['schema']) + if schema['type'] == 'definition-ref': + # Referenced schemas should not have titles set for the same reason + # schemas with refs should not + return False + return True # anything else should have title set + + else: + raise PydanticInvalidForJsonSchema(f'Unexpected schema type: schema={schema}') # pragma: no cover + + def normalize_name(self, name: str) -> str: + """Normalizes a name to be used as a key in a dictionary. + + Args: + name: The name to normalize. + + Returns: + The normalized name. + """ + return re.sub(r'[^a-zA-Z0-9.\-_]', '_', name).replace('.', '__') + + def get_defs_ref(self, core_mode_ref: CoreModeRef) -> DefsRef: + """Override this method to change the way that definitions keys are generated from a core reference. + + Args: + core_mode_ref: The core reference. + + Returns: + The definitions key. + """ + # Split the core ref into "components"; generic origins and arguments are each separate components + core_ref, mode = core_mode_ref + components = re.split(r'([\][,])', core_ref) + # Remove IDs from each component + components = [x.rsplit(':', 1)[0] for x in components] + core_ref_no_id = ''.join(components) + # Remove everything before the last period from each "component" + components = [re.sub(r'(?:[^.[\]]+\.)+((?:[^.[\]]+))', r'\1', x) for x in components] + short_ref = ''.join(components) + + mode_title = _MODE_TITLE_MAPPING[mode] + + # It is important that the generated defs_ref values be such that at least one choice will not + # be generated for any other core_ref. Currently, this should be the case because we include + # the id of the source type in the core_ref + name = DefsRef(self.normalize_name(short_ref)) + name_mode = DefsRef(self.normalize_name(short_ref) + f'-{mode_title}') + module_qualname = DefsRef(self.normalize_name(core_ref_no_id)) + module_qualname_mode = DefsRef(f'{module_qualname}-{mode_title}') + module_qualname_id = DefsRef(self.normalize_name(core_ref)) + occurrence_index = self._collision_index.get(module_qualname_id) + if occurrence_index is None: + self._collision_counter[module_qualname] += 1 + occurrence_index = self._collision_index[module_qualname_id] = self._collision_counter[module_qualname] + + module_qualname_occurrence = DefsRef(f'{module_qualname}__{occurrence_index}') + module_qualname_occurrence_mode = DefsRef(f'{module_qualname_mode}__{occurrence_index}') + + self._prioritized_defsref_choices[module_qualname_occurrence_mode] = [ + name, + name_mode, + module_qualname, + module_qualname_mode, + module_qualname_occurrence, + module_qualname_occurrence_mode, + ] + + return module_qualname_occurrence_mode + + def get_cache_defs_ref_schema(self, core_ref: CoreRef) -> tuple[DefsRef, JsonSchemaValue]: + """This method wraps the get_defs_ref method with some cache-lookup/population logic, + and returns both the produced defs_ref and the JSON schema that will refer to the right definition. + + Args: + core_ref: The core reference to get the definitions reference for. + + Returns: + A tuple of the definitions reference and the JSON schema that will refer to it. + """ + core_mode_ref = (core_ref, self.mode) + maybe_defs_ref = self.core_to_defs_refs.get(core_mode_ref) + if maybe_defs_ref is not None: + json_ref = self.core_to_json_refs[core_mode_ref] + return maybe_defs_ref, {'$ref': json_ref} + + defs_ref = self.get_defs_ref(core_mode_ref) + + # populate the ref translation mappings + self.core_to_defs_refs[core_mode_ref] = defs_ref + self.defs_to_core_refs[defs_ref] = core_mode_ref + + json_ref = JsonRef(self.ref_template.format(model=defs_ref)) + self.core_to_json_refs[core_mode_ref] = json_ref + self.json_to_defs_refs[json_ref] = defs_ref + ref_json_schema = {'$ref': json_ref} + return defs_ref, ref_json_schema + + def handle_ref_overrides(self, json_schema: JsonSchemaValue) -> JsonSchemaValue: + """It is not valid for a schema with a top-level $ref to have sibling keys. + + During our own schema generation, we treat sibling keys as overrides to the referenced schema, + but this is not how the official JSON schema spec works. + + Because of this, we first remove any sibling keys that are redundant with the referenced schema, then if + any remain, we transform the schema from a top-level '$ref' to use allOf to move the $ref out of the top level. + (See bottom of https://swagger.io/docs/specification/using-ref/ for a reference about this behavior) + """ + if '$ref' in json_schema: + # prevent modifications to the input; this copy may be safe to drop if there is significant overhead + json_schema = json_schema.copy() + + referenced_json_schema = self.get_schema_from_definitions(JsonRef(json_schema['$ref'])) + if referenced_json_schema is None: + # This can happen when building schemas for models with not-yet-defined references. + # It may be a good idea to do a recursive pass at the end of the generation to remove + # any redundant override keys. + if len(json_schema) > 1: + # Make it an allOf to at least resolve the sibling keys issue + json_schema = json_schema.copy() + json_schema.setdefault('allOf', []) + json_schema['allOf'].append({'$ref': json_schema['$ref']}) + del json_schema['$ref'] + + return json_schema + for k, v in list(json_schema.items()): + if k == '$ref': + continue + if k in referenced_json_schema and referenced_json_schema[k] == v: + del json_schema[k] # redundant key + if len(json_schema) > 1: + # There is a remaining "override" key, so we need to move $ref out of the top level + json_ref = JsonRef(json_schema['$ref']) + del json_schema['$ref'] + assert 'allOf' not in json_schema # this should never happen, but just in case + json_schema['allOf'] = [{'$ref': json_ref}] + + return json_schema + + def get_schema_from_definitions(self, json_ref: JsonRef) -> JsonSchemaValue | None: + def_ref = self.json_to_defs_refs[json_ref] + if def_ref in self._core_defs_invalid_for_json_schema: + raise self._core_defs_invalid_for_json_schema[def_ref] + return self.definitions.get(def_ref, None) + + def encode_default(self, dft: Any) -> Any: + """Encode a default value to a JSON-serializable value. + + This is used to encode default values for fields in the generated JSON schema. + + Args: + dft: The default value to encode. + + Returns: + The encoded default value. + """ + from .type_adapter import TypeAdapter, _type_has_config + + config = self._config + try: + default = ( + dft + if _type_has_config(type(dft)) + else TypeAdapter(type(dft), config=config.config_dict).dump_python(dft, mode='json') + ) + except PydanticSchemaGenerationError: + raise pydantic_core.PydanticSerializationError(f'Unable to encode default value {dft}') + + return pydantic_core.to_jsonable_python( + default, + timedelta_mode=config.ser_json_timedelta, + bytes_mode=config.ser_json_bytes, + ) + + def update_with_validations( + self, json_schema: JsonSchemaValue, core_schema: CoreSchema, mapping: dict[str, str] + ) -> None: + """Update the json_schema with the corresponding validations specified in the core_schema, + using the provided mapping to translate keys in core_schema to the appropriate keys for a JSON schema. + + Args: + json_schema: The JSON schema to update. + core_schema: The core schema to get the validations from. + mapping: A mapping from core_schema attribute names to the corresponding JSON schema attribute names. + """ + for core_key, json_schema_key in mapping.items(): + if core_key in core_schema: + json_schema[json_schema_key] = core_schema[core_key] + + class ValidationsMapping: + """This class just contains mappings from core_schema attribute names to the corresponding + JSON schema attribute names. While I suspect it is unlikely to be necessary, you can in + principle override this class in a subclass of GenerateJsonSchema (by inheriting from + GenerateJsonSchema.ValidationsMapping) to change these mappings. + """ + + numeric = { + 'multiple_of': 'multipleOf', + 'le': 'maximum', + 'ge': 'minimum', + 'lt': 'exclusiveMaximum', + 'gt': 'exclusiveMinimum', + } + bytes = { + 'min_length': 'minLength', + 'max_length': 'maxLength', + } + string = { + 'min_length': 'minLength', + 'max_length': 'maxLength', + 'pattern': 'pattern', + } + array = { + 'min_length': 'minItems', + 'max_length': 'maxItems', + } + object = { + 'min_length': 'minProperties', + 'max_length': 'maxProperties', + } + date = { + 'le': 'maximum', + 'ge': 'minimum', + 'lt': 'exclusiveMaximum', + 'gt': 'exclusiveMinimum', + } + + def get_flattened_anyof(self, schemas: list[JsonSchemaValue]) -> JsonSchemaValue: + members = [] + for schema in schemas: + if len(schema) == 1 and 'anyOf' in schema: + members.extend(schema['anyOf']) + else: + members.append(schema) + members = _deduplicate_schemas(members) + if len(members) == 1: + return members[0] + return {'anyOf': members} + + def get_json_ref_counts(self, json_schema: JsonSchemaValue) -> dict[JsonRef, int]: + """Get all values corresponding to the key '$ref' anywhere in the json_schema.""" + json_refs: dict[JsonRef, int] = Counter() + + def _add_json_refs(schema: Any) -> None: + if isinstance(schema, dict): + if '$ref' in schema: + json_ref = JsonRef(schema['$ref']) + if not isinstance(json_ref, str): + return # in this case, '$ref' might have been the name of a property + already_visited = json_ref in json_refs + json_refs[json_ref] += 1 + if already_visited: + return # prevent recursion on a definition that was already visited + defs_ref = self.json_to_defs_refs[json_ref] + if defs_ref in self._core_defs_invalid_for_json_schema: + raise self._core_defs_invalid_for_json_schema[defs_ref] + _add_json_refs(self.definitions[defs_ref]) + + for v in schema.values(): + _add_json_refs(v) + elif isinstance(schema, list): + for v in schema: + _add_json_refs(v) + + _add_json_refs(json_schema) + return json_refs + + def handle_invalid_for_json_schema(self, schema: CoreSchemaOrField, error_info: str) -> JsonSchemaValue: + raise PydanticInvalidForJsonSchema(f'Cannot generate a JsonSchema for {error_info}') + + def emit_warning(self, kind: JsonSchemaWarningKind, detail: str) -> None: + """This method simply emits PydanticJsonSchemaWarnings based on handling in the `warning_message` method.""" + message = self.render_warning_message(kind, detail) + if message is not None: + warnings.warn(message, PydanticJsonSchemaWarning) + + def render_warning_message(self, kind: JsonSchemaWarningKind, detail: str) -> str | None: + """This method is responsible for ignoring warnings as desired, and for formatting the warning messages. + + You can override the value of `ignored_warning_kinds` in a subclass of GenerateJsonSchema + to modify what warnings are generated. If you want more control, you can override this method; + just return None in situations where you don't want warnings to be emitted. + + Args: + kind: The kind of warning to render. It can be one of the following: + + - 'skipped-choice': A choice field was skipped because it had no valid choices. + - 'non-serializable-default': A default value was skipped because it was not JSON-serializable. + detail: A string with additional details about the warning. + + Returns: + The formatted warning message, or `None` if no warning should be emitted. + """ + if kind in self.ignored_warning_kinds: + return None + return f'{detail} [{kind}]' + + def _build_definitions_remapping(self) -> _DefinitionsRemapping: + defs_to_json: dict[DefsRef, JsonRef] = {} + for defs_refs in self._prioritized_defsref_choices.values(): + for defs_ref in defs_refs: + json_ref = JsonRef(self.ref_template.format(model=defs_ref)) + defs_to_json[defs_ref] = json_ref + + return _DefinitionsRemapping.from_prioritized_choices( + self._prioritized_defsref_choices, defs_to_json, self.definitions + ) + + def _garbage_collect_definitions(self, schema: JsonSchemaValue) -> None: + visited_defs_refs: set[DefsRef] = set() + unvisited_json_refs = _get_all_json_refs(schema) + while unvisited_json_refs: + next_json_ref = unvisited_json_refs.pop() + next_defs_ref = self.json_to_defs_refs[next_json_ref] + if next_defs_ref in visited_defs_refs: + continue + visited_defs_refs.add(next_defs_ref) + unvisited_json_refs.update(_get_all_json_refs(self.definitions[next_defs_ref])) + + self.definitions = {k: v for k, v in self.definitions.items() if k in visited_defs_refs} + + +# ##### Start JSON Schema Generation Functions ##### + + +def model_json_schema( + cls: type[BaseModel] | type[PydanticDataclass], + by_alias: bool = True, + ref_template: str = DEFAULT_REF_TEMPLATE, + schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema, + mode: JsonSchemaMode = 'validation', +) -> dict[str, Any]: + """Utility function to generate a JSON Schema for a model. + + Args: + cls: The model class to generate a JSON Schema for. + by_alias: If `True` (the default), fields will be serialized according to their alias. + If `False`, fields will be serialized according to their attribute name. + ref_template: The template to use for generating JSON Schema references. + schema_generator: The class to use for generating the JSON Schema. + mode: The mode to use for generating the JSON Schema. It can be one of the following: + + - 'validation': Generate a JSON Schema for validating data. + - 'serialization': Generate a JSON Schema for serializing data. + + Returns: + The generated JSON Schema. + """ + from .main import BaseModel + + schema_generator_instance = schema_generator(by_alias=by_alias, ref_template=ref_template) + + if isinstance(cls.__pydantic_core_schema__, _mock_val_ser.MockCoreSchema): + cls.__pydantic_core_schema__.rebuild() + + if cls is BaseModel: + raise AttributeError('model_json_schema() must be called on a subclass of BaseModel, not BaseModel itself.') + + assert not isinstance(cls.__pydantic_core_schema__, _mock_val_ser.MockCoreSchema), 'this is a bug! please report it' + return schema_generator_instance.generate(cls.__pydantic_core_schema__, mode=mode) + + +def models_json_schema( + models: Sequence[tuple[type[BaseModel] | type[PydanticDataclass], JsonSchemaMode]], + *, + by_alias: bool = True, + title: str | None = None, + description: str | None = None, + ref_template: str = DEFAULT_REF_TEMPLATE, + schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema, +) -> tuple[dict[tuple[type[BaseModel] | type[PydanticDataclass], JsonSchemaMode], JsonSchemaValue], JsonSchemaValue]: + """Utility function to generate a JSON Schema for multiple models. + + Args: + models: A sequence of tuples of the form (model, mode). + by_alias: Whether field aliases should be used as keys in the generated JSON Schema. + title: The title of the generated JSON Schema. + description: The description of the generated JSON Schema. + ref_template: The reference template to use for generating JSON Schema references. + schema_generator: The schema generator to use for generating the JSON Schema. + + Returns: + A tuple where: + - The first element is a dictionary whose keys are tuples of JSON schema key type and JSON mode, and + whose values are the JSON schema corresponding to that pair of inputs. (These schemas may have + JsonRef references to definitions that are defined in the second returned element.) + - The second element is a JSON schema containing all definitions referenced in the first returned + element, along with the optional title and description keys. + """ + for cls, _ in models: + if isinstance(cls.__pydantic_core_schema__, _mock_val_ser.MockCoreSchema): + cls.__pydantic_core_schema__.rebuild() + + instance = schema_generator(by_alias=by_alias, ref_template=ref_template) + inputs: list[tuple[type[BaseModel] | type[PydanticDataclass], JsonSchemaMode, CoreSchema]] = [ + (m, mode, m.__pydantic_core_schema__) for m, mode in models + ] + json_schemas_map, definitions = instance.generate_definitions(inputs) + + json_schema: dict[str, Any] = {} + if definitions: + json_schema['$defs'] = definitions + if title: + json_schema['title'] = title + if description: + json_schema['description'] = description + + return json_schemas_map, json_schema + + +# ##### End JSON Schema Generation Functions ##### + + +_HashableJsonValue: TypeAlias = Union[ + int, float, str, bool, None, Tuple['_HashableJsonValue', ...], Tuple[Tuple[str, '_HashableJsonValue'], ...] +] + + +def _deduplicate_schemas(schemas: Iterable[JsonDict]) -> list[JsonDict]: + return list({_make_json_hashable(schema): schema for schema in schemas}.values()) + + +def _make_json_hashable(value: JsonValue) -> _HashableJsonValue: + if isinstance(value, dict): + return tuple(sorted((k, _make_json_hashable(v)) for k, v in value.items())) + elif isinstance(value, list): + return tuple(_make_json_hashable(v) for v in value) + else: + return value + + +def _sort_json_schema(value: JsonSchemaValue, parent_key: str | None = None) -> JsonSchemaValue: + if isinstance(value, dict): + sorted_dict: dict[str, JsonSchemaValue] = {} + keys = value.keys() + if (parent_key != 'properties') and (parent_key != 'default'): + keys = sorted(keys) + for key in keys: + sorted_dict[key] = _sort_json_schema(value[key], parent_key=key) + return sorted_dict + elif isinstance(value, list): + sorted_list: list[JsonSchemaValue] = [] + for item in value: # type: ignore + sorted_list.append(_sort_json_schema(item, parent_key)) + return sorted_list # type: ignore + else: + return value + + +@dataclasses.dataclass(**_internal_dataclass.slots_true) +class WithJsonSchema: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/json_schema/#withjsonschema-annotation + + Add this as an annotation on a field to override the (base) JSON schema that would be generated for that field. + This provides a way to set a JSON schema for types that would otherwise raise errors when producing a JSON schema, + such as Callable, or types that have an is-instance core schema, without needing to go so far as creating a + custom subclass of pydantic.json_schema.GenerateJsonSchema. + Note that any _modifications_ to the schema that would normally be made (such as setting the title for model fields) + will still be performed. + + If `mode` is set this will only apply to that schema generation mode, allowing you + to set different json schemas for validation and serialization. + """ + + json_schema: JsonSchemaValue | None + mode: Literal['validation', 'serialization'] | None = None + + def __get_pydantic_json_schema__( + self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler + ) -> JsonSchemaValue: + mode = self.mode or handler.mode + if mode != handler.mode: + return handler(core_schema) + if self.json_schema is None: + # This exception is handled in pydantic.json_schema.GenerateJsonSchema._named_required_fields_schema + raise PydanticOmit + else: + return self.json_schema + + def __hash__(self) -> int: + return hash(type(self.mode)) + + +@dataclasses.dataclass(**_internal_dataclass.slots_true) +class Examples: + """Add examples to a JSON schema. + + Examples should be a map of example names (strings) + to example values (any valid JSON). + + If `mode` is set this will only apply to that schema generation mode, + allowing you to add different examples for validation and serialization. + """ + + examples: dict[str, Any] + mode: Literal['validation', 'serialization'] | None = None + + def __get_pydantic_json_schema__( + self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler + ) -> JsonSchemaValue: + mode = self.mode or handler.mode + json_schema = handler(core_schema) + if mode != handler.mode: + return json_schema + examples = json_schema.get('examples', {}) + examples.update(to_jsonable_python(self.examples)) + json_schema['examples'] = examples + return json_schema + + def __hash__(self) -> int: + return hash(type(self.mode)) + + +def _get_all_json_refs(item: Any) -> set[JsonRef]: + """Get all the definitions references from a JSON schema.""" + refs: set[JsonRef] = set() + stack = [item] + + while stack: + current = stack.pop() + if isinstance(current, dict): + for key, value in current.items(): + if key == '$ref' and isinstance(value, str): + refs.add(JsonRef(value)) + elif isinstance(value, dict): + stack.append(value) + elif isinstance(value, list): + stack.extend(value) + elif isinstance(current, list): + stack.extend(current) + + return refs + + +AnyType = TypeVar('AnyType') + +if TYPE_CHECKING: + SkipJsonSchema = Annotated[AnyType, ...] +else: + + @dataclasses.dataclass(**_internal_dataclass.slots_true) + class SkipJsonSchema: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/json_schema/#skipjsonschema-annotation + + Add this as an annotation on a field to skip generating a JSON schema for that field. + + Example: + ```py + from typing import Union + + from pydantic import BaseModel + from pydantic.json_schema import SkipJsonSchema + + from pprint import pprint + + + class Model(BaseModel): + a: Union[int, None] = None # (1)! + b: Union[int, SkipJsonSchema[None]] = None # (2)! + c: SkipJsonSchema[Union[int, None]] = None # (3)! + + + pprint(Model.model_json_schema()) + ''' + { + 'properties': { + 'a': { + 'anyOf': [ + {'type': 'integer'}, + {'type': 'null'} + ], + 'default': None, + 'title': 'A' + }, + 'b': { + 'default': None, + 'title': 'B', + 'type': 'integer' + } + }, + 'title': 'Model', + 'type': 'object' + } + ''' + ``` + + 1. The integer and null types are both included in the schema for `a`. + 2. The integer type is the only type included in the schema for `b`. + 3. The entirety of the `c` field is omitted from the schema. + """ + + def __class_getitem__(cls, item: AnyType) -> AnyType: + return Annotated[item, cls()] + + def __get_pydantic_json_schema__( + self, core_schema: CoreSchema, handler: GetJsonSchemaHandler + ) -> JsonSchemaValue: + raise PydanticOmit + + def __hash__(self) -> int: + return hash(type(self)) + + +def _get_typed_dict_cls(schema: core_schema.TypedDictSchema) -> type[Any] | None: + metadata = _core_metadata.CoreMetadataHandler(schema).metadata + cls = metadata.get('pydantic_typed_dict_cls') + return cls + + +def _get_typed_dict_config(cls: type[Any] | None) -> ConfigDict: + if cls is not None: + try: + return _decorators.get_attribute_from_bases(cls, '__pydantic_config__') + except AttributeError: + pass + return {} diff --git a/env/Lib/site-packages/pydantic/main.py b/env/Lib/site-packages/pydantic/main.py new file mode 100644 index 0000000..c40c818 --- /dev/null +++ b/env/Lib/site-packages/pydantic/main.py @@ -0,0 +1,1580 @@ +"""Logic for creating models.""" + +from __future__ import annotations as _annotations + +import operator +import sys +import types +import typing +import warnings +from copy import copy, deepcopy +from typing import ( + TYPE_CHECKING, + Any, + Callable, + ClassVar, + Dict, + Generator, + Literal, + Set, + Tuple, + TypeVar, + Union, + cast, + overload, +) + +import pydantic_core +import typing_extensions +from pydantic_core import PydanticUndefined +from typing_extensions import Self, TypeAlias, Unpack + +from ._internal import ( + _config, + _decorators, + _fields, + _forward_ref, + _generics, + _mock_val_ser, + _model_construction, + _repr, + _typing_extra, + _utils, +) +from ._migration import getattr_migration +from .aliases import AliasChoices, AliasPath +from .annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler +from .config import ConfigDict +from .errors import PydanticUndefinedAnnotation, PydanticUserError +from .json_schema import DEFAULT_REF_TEMPLATE, GenerateJsonSchema, JsonSchemaMode, JsonSchemaValue, model_json_schema +from .plugin._schema_validator import PluggableSchemaValidator +from .warnings import PydanticDeprecatedSince20 + +# Always define certain types that are needed to resolve method type hints/annotations +# (even when not type checking) via typing.get_type_hints. +ModelT = TypeVar('ModelT', bound='BaseModel') +TupleGenerator = Generator[Tuple[str, Any], None, None] +# should be `set[int] | set[str] | dict[int, IncEx] | dict[str, IncEx] | None`, but mypy can't cope +IncEx: TypeAlias = Union[Set[int], Set[str], Dict[int, Any], Dict[str, Any], None] + + +if TYPE_CHECKING: + from inspect import Signature + from pathlib import Path + + from pydantic_core import CoreSchema, SchemaSerializer, SchemaValidator + + from ._internal._utils import AbstractSetIntStr, MappingIntStrAny + from .deprecated.parse import Protocol as DeprecatedParseProtocol + from .fields import ComputedFieldInfo, FieldInfo, ModelPrivateAttr + from .fields import PrivateAttr as _PrivateAttr +else: + # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915 + # and https://youtrack.jetbrains.com/issue/PY-51428 + DeprecationWarning = PydanticDeprecatedSince20 + +__all__ = 'BaseModel', 'create_model' + +_object_setattr = _model_construction.object_setattr + + +class BaseModel(metaclass=_model_construction.ModelMetaclass): + """Usage docs: https://docs.pydantic.dev/2.8/concepts/models/ + + A base class for creating Pydantic models. + + Attributes: + __class_vars__: The names of classvars defined on the model. + __private_attributes__: Metadata about the private attributes of the model. + __signature__: The signature for instantiating the model. + + __pydantic_complete__: Whether model building is completed, or if there are still undefined fields. + __pydantic_core_schema__: The pydantic-core schema used to build the SchemaValidator and SchemaSerializer. + __pydantic_custom_init__: Whether the model has a custom `__init__` function. + __pydantic_decorators__: Metadata containing the decorators defined on the model. + This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1. + __pydantic_generic_metadata__: Metadata for generic models; contains data used for a similar purpose to + __args__, __origin__, __parameters__ in typing-module generics. May eventually be replaced by these. + __pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models. + __pydantic_post_init__: The name of the post-init method for the model, if defined. + __pydantic_root_model__: Whether the model is a `RootModel`. + __pydantic_serializer__: The pydantic-core SchemaSerializer used to dump instances of the model. + __pydantic_validator__: The pydantic-core SchemaValidator used to validate instances of the model. + + __pydantic_extra__: An instance attribute with the values of extra fields from validation when + `model_config['extra'] == 'allow'`. + __pydantic_fields_set__: An instance attribute with the names of fields explicitly set. + __pydantic_private__: Instance attribute with the values of private attributes set on the model instance. + """ + + if TYPE_CHECKING: + # Here we provide annotations for the attributes of BaseModel. + # Many of these are populated by the metaclass, which is why this section is in a `TYPE_CHECKING` block. + # However, for the sake of easy review, we have included type annotations of all class and instance attributes + # of `BaseModel` here: + + # Class attributes + model_config: ClassVar[ConfigDict] + """ + Configuration for the model, should be a dictionary conforming to [`ConfigDict`][pydantic.config.ConfigDict]. + """ + + model_fields: ClassVar[dict[str, FieldInfo]] + """ + Metadata about the fields defined on the model, + mapping of field names to [`FieldInfo`][pydantic.fields.FieldInfo]. + + This replaces `Model.__fields__` from Pydantic V1. + """ + + model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] + """A dictionary of computed field names and their corresponding `ComputedFieldInfo` objects.""" + + __class_vars__: ClassVar[set[str]] + __private_attributes__: ClassVar[dict[str, ModelPrivateAttr]] + __signature__: ClassVar[Signature] + + __pydantic_complete__: ClassVar[bool] + __pydantic_core_schema__: ClassVar[CoreSchema] + __pydantic_custom_init__: ClassVar[bool] + __pydantic_decorators__: ClassVar[_decorators.DecoratorInfos] + __pydantic_generic_metadata__: ClassVar[_generics.PydanticGenericMetadata] + __pydantic_parent_namespace__: ClassVar[dict[str, Any] | None] + __pydantic_post_init__: ClassVar[None | Literal['model_post_init']] + __pydantic_root_model__: ClassVar[bool] + __pydantic_serializer__: ClassVar[SchemaSerializer] + __pydantic_validator__: ClassVar[SchemaValidator | PluggableSchemaValidator] + + # Instance attributes + __pydantic_extra__: dict[str, Any] | None = _PrivateAttr() + __pydantic_fields_set__: set[str] = _PrivateAttr() + __pydantic_private__: dict[str, Any] | None = _PrivateAttr() + + else: + # `model_fields` and `__pydantic_decorators__` must be set for + # pydantic._internal._generate_schema.GenerateSchema.model_schema to work for a plain BaseModel annotation + model_fields = {} + model_computed_fields = {} + + __pydantic_decorators__ = _decorators.DecoratorInfos() + __pydantic_parent_namespace__ = None + # Prevent `BaseModel` from being instantiated directly: + __pydantic_core_schema__ = _mock_val_ser.MockCoreSchema( + 'Pydantic models should inherit from BaseModel, BaseModel cannot be instantiated directly', + code='base-model-instantiated', + ) + __pydantic_validator__ = _mock_val_ser.MockValSer( + 'Pydantic models should inherit from BaseModel, BaseModel cannot be instantiated directly', + val_or_ser='validator', + code='base-model-instantiated', + ) + __pydantic_serializer__ = _mock_val_ser.MockValSer( + 'Pydantic models should inherit from BaseModel, BaseModel cannot be instantiated directly', + val_or_ser='serializer', + code='base-model-instantiated', + ) + + __slots__ = '__dict__', '__pydantic_fields_set__', '__pydantic_extra__', '__pydantic_private__' + + model_config = ConfigDict() + __pydantic_complete__ = False + __pydantic_root_model__ = False + + def __init__(self, /, **data: Any) -> None: # type: ignore + """Create a new model by parsing and validating input data from keyword arguments. + + Raises [`ValidationError`][pydantic_core.ValidationError] if the input data cannot be + validated to form a valid model. + + `self` is explicitly positional-only to allow `self` as a field name. + """ + # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks + __tracebackhide__ = True + self.__pydantic_validator__.validate_python(data, self_instance=self) + + # The following line sets a flag that we use to determine when `__init__` gets overridden by the user + __init__.__pydantic_base_init__ = True # pyright: ignore[reportFunctionMemberAccess] + + @property + def model_extra(self) -> dict[str, Any] | None: + """Get extra fields set during validation. + + Returns: + A dictionary of extra fields, or `None` if `config.extra` is not set to `"allow"`. + """ + return self.__pydantic_extra__ + + @property + def model_fields_set(self) -> set[str]: + """Returns the set of fields that have been explicitly set on this model instance. + + Returns: + A set of strings representing the fields that have been set, + i.e. that were not filled from defaults. + """ + return self.__pydantic_fields_set__ + + @classmethod + def model_construct(cls, _fields_set: set[str] | None = None, **values: Any) -> Self: # noqa: C901 + """Creates a new instance of the `Model` class with validated data. + + Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data. + Default values are respected, but no other validation is performed. + + !!! note + `model_construct()` generally respects the `model_config.extra` setting on the provided model. + That is, if `model_config.extra == 'allow'`, then all extra passed values are added to the model instance's `__dict__` + and `__pydantic_extra__` fields. If `model_config.extra == 'ignore'` (the default), then all extra passed values are ignored. + Because no validation is performed with a call to `model_construct()`, having `model_config.extra == 'forbid'` does not result in + an error if extra values are passed, but they will be ignored. + + Args: + _fields_set: The set of field names accepted for the Model instance. + values: Trusted or pre-validated data dictionary. + + Returns: + A new instance of the `Model` class with validated data. + """ + m = cls.__new__(cls) + fields_values: dict[str, Any] = {} + fields_set = set() + + for name, field in cls.model_fields.items(): + if field.alias is not None and field.alias in values: + fields_values[name] = values.pop(field.alias) + fields_set.add(name) + + if (name not in fields_set) and (field.validation_alias is not None): + validation_aliases: list[str | AliasPath] = ( + field.validation_alias.choices + if isinstance(field.validation_alias, AliasChoices) + else [field.validation_alias] + ) + + for alias in validation_aliases: + if isinstance(alias, str) and alias in values: + fields_values[name] = values.pop(alias) + fields_set.add(name) + break + elif isinstance(alias, AliasPath): + value = alias.search_dict_for_path(values) + if value is not PydanticUndefined: + fields_values[name] = value + fields_set.add(name) + break + + if name not in fields_set: + if name in values: + fields_values[name] = values.pop(name) + fields_set.add(name) + elif not field.is_required(): + fields_values[name] = field.get_default(call_default_factory=True) + if _fields_set is None: + _fields_set = fields_set + + _extra: dict[str, Any] | None = ( + {k: v for k, v in values.items()} if cls.model_config.get('extra') == 'allow' else None + ) + _object_setattr(m, '__dict__', fields_values) + _object_setattr(m, '__pydantic_fields_set__', _fields_set) + if not cls.__pydantic_root_model__: + _object_setattr(m, '__pydantic_extra__', _extra) + + if cls.__pydantic_post_init__: + m.model_post_init(None) + # update private attributes with values set + if hasattr(m, '__pydantic_private__') and m.__pydantic_private__ is not None: + for k, v in values.items(): + if k in m.__private_attributes__: + m.__pydantic_private__[k] = v + + elif not cls.__pydantic_root_model__: + # Note: if there are any private attributes, cls.__pydantic_post_init__ would exist + # Since it doesn't, that means that `__pydantic_private__` should be set to None + _object_setattr(m, '__pydantic_private__', None) + + return m + + def model_copy(self, *, update: dict[str, Any] | None = None, deep: bool = False) -> Self: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/serialization/#model_copy + + Returns a copy of the model. + + Args: + update: Values to change/add in the new model. Note: the data is not validated + before creating the new model. You should trust this data. + deep: Set to `True` to make a deep copy of the model. + + Returns: + New model instance. + """ + copied = self.__deepcopy__() if deep else self.__copy__() + if update: + if self.model_config.get('extra') == 'allow': + for k, v in update.items(): + if k in self.model_fields: + copied.__dict__[k] = v + else: + if copied.__pydantic_extra__ is None: + copied.__pydantic_extra__ = {} + copied.__pydantic_extra__[k] = v + else: + copied.__dict__.update(update) + copied.__pydantic_fields_set__.update(update.keys()) + return copied + + def model_dump( + self, + *, + mode: Literal['json', 'python'] | str = 'python', + include: IncEx = None, + exclude: IncEx = None, + context: Any | None = None, + by_alias: bool = False, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + round_trip: bool = False, + warnings: bool | Literal['none', 'warn', 'error'] = True, + serialize_as_any: bool = False, + ) -> dict[str, Any]: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/serialization/#modelmodel_dump + + Generate a dictionary representation of the model, optionally specifying which fields to include or exclude. + + Args: + mode: The mode in which `to_python` should run. + If mode is 'json', the output will only contain JSON serializable types. + If mode is 'python', the output may contain non-JSON-serializable Python objects. + include: A set of fields to include in the output. + exclude: A set of fields to exclude from the output. + context: Additional context to pass to the serializer. + by_alias: Whether to use the field's alias in the dictionary key if defined. + exclude_unset: Whether to exclude fields that have not been explicitly set. + exclude_defaults: Whether to exclude fields that are set to their default value. + exclude_none: Whether to exclude fields that have a value of `None`. + round_trip: If True, dumped values should be valid as input for non-idempotent types such as Json[T]. + warnings: How to handle serialization errors. False/"none" ignores them, True/"warn" logs errors, + "error" raises a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError]. + serialize_as_any: Whether to serialize fields with duck-typing serialization behavior. + + Returns: + A dictionary representation of the model. + """ + return self.__pydantic_serializer__.to_python( + self, + mode=mode, + by_alias=by_alias, + include=include, + exclude=exclude, + context=context, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + round_trip=round_trip, + warnings=warnings, + serialize_as_any=serialize_as_any, + ) + + def model_dump_json( + self, + *, + indent: int | None = None, + include: IncEx = None, + exclude: IncEx = None, + context: Any | None = None, + by_alias: bool = False, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + round_trip: bool = False, + warnings: bool | Literal['none', 'warn', 'error'] = True, + serialize_as_any: bool = False, + ) -> str: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/serialization/#modelmodel_dump_json + + Generates a JSON representation of the model using Pydantic's `to_json` method. + + Args: + indent: Indentation to use in the JSON output. If None is passed, the output will be compact. + include: Field(s) to include in the JSON output. + exclude: Field(s) to exclude from the JSON output. + context: Additional context to pass to the serializer. + by_alias: Whether to serialize using field aliases. + exclude_unset: Whether to exclude fields that have not been explicitly set. + exclude_defaults: Whether to exclude fields that are set to their default value. + exclude_none: Whether to exclude fields that have a value of `None`. + round_trip: If True, dumped values should be valid as input for non-idempotent types such as Json[T]. + warnings: How to handle serialization errors. False/"none" ignores them, True/"warn" logs errors, + "error" raises a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError]. + serialize_as_any: Whether to serialize fields with duck-typing serialization behavior. + + Returns: + A JSON string representation of the model. + """ + return self.__pydantic_serializer__.to_json( + self, + indent=indent, + include=include, + exclude=exclude, + context=context, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + round_trip=round_trip, + warnings=warnings, + serialize_as_any=serialize_as_any, + ).decode() + + @classmethod + def model_json_schema( + cls, + by_alias: bool = True, + ref_template: str = DEFAULT_REF_TEMPLATE, + schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema, + mode: JsonSchemaMode = 'validation', + ) -> dict[str, Any]: + """Generates a JSON schema for a model class. + + Args: + by_alias: Whether to use attribute aliases or not. + ref_template: The reference template. + schema_generator: To override the logic used to generate the JSON schema, as a subclass of + `GenerateJsonSchema` with your desired modifications + mode: The mode in which to generate the schema. + + Returns: + The JSON schema for the given model class. + """ + return model_json_schema( + cls, by_alias=by_alias, ref_template=ref_template, schema_generator=schema_generator, mode=mode + ) + + @classmethod + def model_parametrized_name(cls, params: tuple[type[Any], ...]) -> str: + """Compute the class name for parametrizations of generic classes. + + This method can be overridden to achieve a custom naming scheme for generic BaseModels. + + Args: + params: Tuple of types of the class. Given a generic class + `Model` with 2 type variables and a concrete model `Model[str, int]`, + the value `(str, int)` would be passed to `params`. + + Returns: + String representing the new class where `params` are passed to `cls` as type variables. + + Raises: + TypeError: Raised when trying to generate concrete names for non-generic models. + """ + if not issubclass(cls, typing.Generic): + raise TypeError('Concrete names should only be generated for generic models.') + + # Any strings received should represent forward references, so we handle them specially below. + # If we eventually move toward wrapping them in a ForwardRef in __class_getitem__ in the future, + # we may be able to remove this special case. + param_names = [param if isinstance(param, str) else _repr.display_as_type(param) for param in params] + params_component = ', '.join(param_names) + return f'{cls.__name__}[{params_component}]' + + def model_post_init(self, __context: Any) -> None: + """Override this method to perform additional initialization after `__init__` and `model_construct`. + This is useful if you want to do some validation that requires the entire model to be initialized. + """ + pass + + @classmethod + def model_rebuild( + cls, + *, + force: bool = False, + raise_errors: bool = True, + _parent_namespace_depth: int = 2, + _types_namespace: dict[str, Any] | None = None, + ) -> bool | None: + """Try to rebuild the pydantic-core schema for the model. + + This may be necessary when one of the annotations is a ForwardRef which could not be resolved during + the initial attempt to build the schema, and automatic rebuilding fails. + + Args: + force: Whether to force the rebuilding of the model schema, defaults to `False`. + raise_errors: Whether to raise errors, defaults to `True`. + _parent_namespace_depth: The depth level of the parent namespace, defaults to 2. + _types_namespace: The types namespace, defaults to `None`. + + Returns: + Returns `None` if the schema is already "complete" and rebuilding was not required. + If rebuilding _was_ required, returns `True` if rebuilding was successful, otherwise `False`. + """ + if not force and cls.__pydantic_complete__: + return None + else: + if '__pydantic_core_schema__' in cls.__dict__: + delattr(cls, '__pydantic_core_schema__') # delete cached value to ensure full rebuild happens + if _types_namespace is not None: + types_namespace: dict[str, Any] | None = _types_namespace.copy() + else: + if _parent_namespace_depth > 0: + frame_parent_ns = _typing_extra.parent_frame_namespace(parent_depth=_parent_namespace_depth) or {} + cls_parent_ns = ( + _model_construction.unpack_lenient_weakvaluedict(cls.__pydantic_parent_namespace__) or {} + ) + types_namespace = {**cls_parent_ns, **frame_parent_ns} + cls.__pydantic_parent_namespace__ = _model_construction.build_lenient_weakvaluedict(types_namespace) + else: + types_namespace = _model_construction.unpack_lenient_weakvaluedict( + cls.__pydantic_parent_namespace__ + ) + + types_namespace = _typing_extra.get_cls_types_namespace(cls, types_namespace) + + # manually override defer_build so complete_model_class doesn't skip building the model again + config = {**cls.model_config, 'defer_build': False} + return _model_construction.complete_model_class( + cls, + cls.__name__, + _config.ConfigWrapper(config, check=False), + raise_errors=raise_errors, + types_namespace=types_namespace, + ) + + @classmethod + def model_validate( + cls, + obj: Any, + *, + strict: bool | None = None, + from_attributes: bool | None = None, + context: Any | None = None, + ) -> Self: + """Validate a pydantic model instance. + + Args: + obj: The object to validate. + strict: Whether to enforce types strictly. + from_attributes: Whether to extract data from object attributes. + context: Additional context to pass to the validator. + + Raises: + ValidationError: If the object could not be validated. + + Returns: + The validated model instance. + """ + # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks + __tracebackhide__ = True + return cls.__pydantic_validator__.validate_python( + obj, strict=strict, from_attributes=from_attributes, context=context + ) + + @classmethod + def model_validate_json( + cls, + json_data: str | bytes | bytearray, + *, + strict: bool | None = None, + context: Any | None = None, + ) -> Self: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/json/#json-parsing + + Validate the given JSON data against the Pydantic model. + + Args: + json_data: The JSON data to validate. + strict: Whether to enforce types strictly. + context: Extra variables to pass to the validator. + + Returns: + The validated Pydantic model. + + Raises: + ValueError: If `json_data` is not a JSON string. + """ + # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks + __tracebackhide__ = True + return cls.__pydantic_validator__.validate_json(json_data, strict=strict, context=context) + + @classmethod + def model_validate_strings( + cls, + obj: Any, + *, + strict: bool | None = None, + context: Any | None = None, + ) -> Self: + """Validate the given object with string data against the Pydantic model. + + Args: + obj: The object containing string data to validate. + strict: Whether to enforce types strictly. + context: Extra variables to pass to the validator. + + Returns: + The validated Pydantic model. + """ + # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks + __tracebackhide__ = True + return cls.__pydantic_validator__.validate_strings(obj, strict=strict, context=context) + + @classmethod + def __get_pydantic_core_schema__(cls, source: type[BaseModel], handler: GetCoreSchemaHandler, /) -> CoreSchema: + """Hook into generating the model's CoreSchema. + + Args: + source: The class we are generating a schema for. + This will generally be the same as the `cls` argument if this is a classmethod. + handler: A callable that calls into Pydantic's internal CoreSchema generation logic. + + Returns: + A `pydantic-core` `CoreSchema`. + """ + # Only use the cached value from this _exact_ class; we don't want one from a parent class + # This is why we check `cls.__dict__` and don't use `cls.__pydantic_core_schema__` or similar. + schema = cls.__dict__.get('__pydantic_core_schema__') + if schema is not None and not isinstance(schema, _mock_val_ser.MockCoreSchema): + # Due to the way generic classes are built, it's possible that an invalid schema may be temporarily + # set on generic classes. I think we could resolve this to ensure that we get proper schema caching + # for generics, but for simplicity for now, we just always rebuild if the class has a generic origin. + if not cls.__pydantic_generic_metadata__['origin']: + return cls.__pydantic_core_schema__ + + return handler(source) + + @classmethod + def __get_pydantic_json_schema__( + cls, + core_schema: CoreSchema, + handler: GetJsonSchemaHandler, + /, + ) -> JsonSchemaValue: + """Hook into generating the model's JSON schema. + + Args: + core_schema: A `pydantic-core` CoreSchema. + You can ignore this argument and call the handler with a new CoreSchema, + wrap this CoreSchema (`{'type': 'nullable', 'schema': current_schema}`), + or just call the handler with the original schema. + handler: Call into Pydantic's internal JSON schema generation. + This will raise a `pydantic.errors.PydanticInvalidForJsonSchema` if JSON schema + generation fails. + Since this gets called by `BaseModel.model_json_schema` you can override the + `schema_generator` argument to that function to change JSON schema generation globally + for a type. + + Returns: + A JSON schema, as a Python object. + """ + return handler(core_schema) + + @classmethod + def __pydantic_init_subclass__(cls, **kwargs: Any) -> None: + """This is intended to behave just like `__init_subclass__`, but is called by `ModelMetaclass` + only after the class is actually fully initialized. In particular, attributes like `model_fields` will + be present when this is called. + + This is necessary because `__init_subclass__` will always be called by `type.__new__`, + and it would require a prohibitively large refactor to the `ModelMetaclass` to ensure that + `type.__new__` was called in such a manner that the class would already be sufficiently initialized. + + This will receive the same `kwargs` that would be passed to the standard `__init_subclass__`, namely, + any kwargs passed to the class definition that aren't used internally by pydantic. + + Args: + **kwargs: Any keyword arguments passed to the class definition that aren't used internally + by pydantic. + """ + pass + + def __class_getitem__( + cls, typevar_values: type[Any] | tuple[type[Any], ...] + ) -> type[BaseModel] | _forward_ref.PydanticRecursiveRef: + cached = _generics.get_cached_generic_type_early(cls, typevar_values) + if cached is not None: + return cached + + if cls is BaseModel: + raise TypeError('Type parameters should be placed on typing.Generic, not BaseModel') + if not hasattr(cls, '__parameters__'): + raise TypeError(f'{cls} cannot be parametrized because it does not inherit from typing.Generic') + if not cls.__pydantic_generic_metadata__['parameters'] and typing.Generic not in cls.__bases__: + raise TypeError(f'{cls} is not a generic class') + + if not isinstance(typevar_values, tuple): + typevar_values = (typevar_values,) + _generics.check_parameters_count(cls, typevar_values) + + # Build map from generic typevars to passed params + typevars_map: dict[_typing_extra.TypeVarType, type[Any]] = dict( + zip(cls.__pydantic_generic_metadata__['parameters'], typevar_values) + ) + + if _utils.all_identical(typevars_map.keys(), typevars_map.values()) and typevars_map: + submodel = cls # if arguments are equal to parameters it's the same object + _generics.set_cached_generic_type(cls, typevar_values, submodel) + else: + parent_args = cls.__pydantic_generic_metadata__['args'] + if not parent_args: + args = typevar_values + else: + args = tuple(_generics.replace_types(arg, typevars_map) for arg in parent_args) + + origin = cls.__pydantic_generic_metadata__['origin'] or cls + model_name = origin.model_parametrized_name(args) + params = tuple( + {param: None for param in _generics.iter_contained_typevars(typevars_map.values())} + ) # use dict as ordered set + + with _generics.generic_recursion_self_type(origin, args) as maybe_self_type: + if maybe_self_type is not None: + return maybe_self_type + + cached = _generics.get_cached_generic_type_late(cls, typevar_values, origin, args) + if cached is not None: + return cached + + # Attempt to rebuild the origin in case new types have been defined + try: + # depth 3 gets you above this __class_getitem__ call + origin.model_rebuild(_parent_namespace_depth=3) + except PydanticUndefinedAnnotation: + # It's okay if it fails, it just means there are still undefined types + # that could be evaluated later. + # TODO: Make sure validation fails if there are still undefined types, perhaps using MockValidator + pass + + submodel = _generics.create_generic_submodel(model_name, origin, args, params) + + # Update cache + _generics.set_cached_generic_type(cls, typevar_values, submodel, origin, args) + + return submodel + + def __copy__(self) -> Self: + """Returns a shallow copy of the model.""" + cls = type(self) + m = cls.__new__(cls) + _object_setattr(m, '__dict__', copy(self.__dict__)) + _object_setattr(m, '__pydantic_extra__', copy(self.__pydantic_extra__)) + _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__)) + + if not hasattr(self, '__pydantic_private__') or self.__pydantic_private__ is None: + _object_setattr(m, '__pydantic_private__', None) + else: + _object_setattr( + m, + '__pydantic_private__', + {k: v for k, v in self.__pydantic_private__.items() if v is not PydanticUndefined}, + ) + + return m + + def __deepcopy__(self, memo: dict[int, Any] | None = None) -> Self: + """Returns a deep copy of the model.""" + cls = type(self) + m = cls.__new__(cls) + _object_setattr(m, '__dict__', deepcopy(self.__dict__, memo=memo)) + _object_setattr(m, '__pydantic_extra__', deepcopy(self.__pydantic_extra__, memo=memo)) + # This next line doesn't need a deepcopy because __pydantic_fields_set__ is a set[str], + # and attempting a deepcopy would be marginally slower. + _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__)) + + if not hasattr(self, '__pydantic_private__') or self.__pydantic_private__ is None: + _object_setattr(m, '__pydantic_private__', None) + else: + _object_setattr( + m, + '__pydantic_private__', + deepcopy({k: v for k, v in self.__pydantic_private__.items() if v is not PydanticUndefined}, memo=memo), + ) + + return m + + if not TYPE_CHECKING: + # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access + # The same goes for __setattr__ and __delattr__, see: https://github.com/pydantic/pydantic/issues/8643 + + def __getattr__(self, item: str) -> Any: + private_attributes = object.__getattribute__(self, '__private_attributes__') + if item in private_attributes: + attribute = private_attributes[item] + if hasattr(attribute, '__get__'): + return attribute.__get__(self, type(self)) # type: ignore + + try: + # Note: self.__pydantic_private__ cannot be None if self.__private_attributes__ has items + return self.__pydantic_private__[item] # type: ignore + except KeyError as exc: + raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') from exc + else: + # `__pydantic_extra__` can fail to be set if the model is not yet fully initialized. + # See `BaseModel.__repr_args__` for more details + try: + pydantic_extra = object.__getattribute__(self, '__pydantic_extra__') + except AttributeError: + pydantic_extra = None + + if pydantic_extra: + try: + return pydantic_extra[item] + except KeyError as exc: + raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') from exc + else: + if hasattr(self.__class__, item): + return super().__getattribute__(item) # Raises AttributeError if appropriate + else: + # this is the current error + raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') + + def __setattr__(self, name: str, value: Any) -> None: + if name in self.__class_vars__: + raise AttributeError( + f'{name!r} is a ClassVar of `{self.__class__.__name__}` and cannot be set on an instance. ' + f'If you want to set a value on the class, use `{self.__class__.__name__}.{name} = value`.' + ) + elif not _fields.is_valid_field_name(name): + if self.__pydantic_private__ is None or name not in self.__private_attributes__: + _object_setattr(self, name, value) + else: + attribute = self.__private_attributes__[name] + if hasattr(attribute, '__set__'): + attribute.__set__(self, value) # type: ignore + else: + self.__pydantic_private__[name] = value + return + + self._check_frozen(name, value) + + attr = getattr(self.__class__, name, None) + if isinstance(attr, property): + attr.__set__(self, value) + elif self.model_config.get('validate_assignment', None): + self.__pydantic_validator__.validate_assignment(self, name, value) + elif self.model_config.get('extra') != 'allow' and name not in self.model_fields: + # TODO - matching error + raise ValueError(f'"{self.__class__.__name__}" object has no field "{name}"') + elif self.model_config.get('extra') == 'allow' and name not in self.model_fields: + if self.model_extra and name in self.model_extra: + self.__pydantic_extra__[name] = value # type: ignore + else: + try: + getattr(self, name) + except AttributeError: + # attribute does not already exist on instance, so put it in extra + self.__pydantic_extra__[name] = value # type: ignore + else: + # attribute _does_ already exist on instance, and was not in extra, so update it + _object_setattr(self, name, value) + else: + self.__dict__[name] = value + self.__pydantic_fields_set__.add(name) + + def __delattr__(self, item: str) -> Any: + if item in self.__private_attributes__: + attribute = self.__private_attributes__[item] + if hasattr(attribute, '__delete__'): + attribute.__delete__(self) # type: ignore + return + + try: + # Note: self.__pydantic_private__ cannot be None if self.__private_attributes__ has items + del self.__pydantic_private__[item] # type: ignore + return + except KeyError as exc: + raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') from exc + + self._check_frozen(item, None) + + if item in self.model_fields: + object.__delattr__(self, item) + elif self.__pydantic_extra__ is not None and item in self.__pydantic_extra__: + del self.__pydantic_extra__[item] + else: + try: + object.__delattr__(self, item) + except AttributeError: + raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') + + def _check_frozen(self, name: str, value: Any) -> None: + if self.model_config.get('frozen', None): + typ = 'frozen_instance' + elif getattr(self.model_fields.get(name), 'frozen', False): + typ = 'frozen_field' + else: + return + error: pydantic_core.InitErrorDetails = { + 'type': typ, + 'loc': (name,), + 'input': value, + } + raise pydantic_core.ValidationError.from_exception_data(self.__class__.__name__, [error]) + + def __getstate__(self) -> dict[Any, Any]: + private = self.__pydantic_private__ + if private: + private = {k: v for k, v in private.items() if v is not PydanticUndefined} + return { + '__dict__': self.__dict__, + '__pydantic_extra__': self.__pydantic_extra__, + '__pydantic_fields_set__': self.__pydantic_fields_set__, + '__pydantic_private__': private, + } + + def __setstate__(self, state: dict[Any, Any]) -> None: + _object_setattr(self, '__pydantic_fields_set__', state.get('__pydantic_fields_set__', {})) + _object_setattr(self, '__pydantic_extra__', state.get('__pydantic_extra__', {})) + _object_setattr(self, '__pydantic_private__', state.get('__pydantic_private__', {})) + _object_setattr(self, '__dict__', state.get('__dict__', {})) + + if not TYPE_CHECKING: + + def __eq__(self, other: Any) -> bool: + if isinstance(other, BaseModel): + # When comparing instances of generic types for equality, as long as all field values are equal, + # only require their generic origin types to be equal, rather than exact type equality. + # This prevents headaches like MyGeneric(x=1) != MyGeneric[Any](x=1). + self_type = self.__pydantic_generic_metadata__['origin'] or self.__class__ + other_type = other.__pydantic_generic_metadata__['origin'] or other.__class__ + + # Perform common checks first + if not ( + self_type == other_type + and getattr(self, '__pydantic_private__', None) == getattr(other, '__pydantic_private__', None) + and self.__pydantic_extra__ == other.__pydantic_extra__ + ): + return False + + # We only want to compare pydantic fields but ignoring fields is costly. + # We'll perform a fast check first, and fallback only when needed + # See GH-7444 and GH-7825 for rationale and a performance benchmark + + # First, do the fast (and sometimes faulty) __dict__ comparison + if self.__dict__ == other.__dict__: + # If the check above passes, then pydantic fields are equal, we can return early + return True + + # We don't want to trigger unnecessary costly filtering of __dict__ on all unequal objects, so we return + # early if there are no keys to ignore (we would just return False later on anyway) + model_fields = type(self).model_fields.keys() + if self.__dict__.keys() <= model_fields and other.__dict__.keys() <= model_fields: + return False + + # If we reach here, there are non-pydantic-fields keys, mapped to unequal values, that we need to ignore + # Resort to costly filtering of the __dict__ objects + # We use operator.itemgetter because it is much faster than dict comprehensions + # NOTE: Contrary to standard python class and instances, when the Model class has a default value for an + # attribute and the model instance doesn't have a corresponding attribute, accessing the missing attribute + # raises an error in BaseModel.__getattr__ instead of returning the class attribute + # So we can use operator.itemgetter() instead of operator.attrgetter() + getter = operator.itemgetter(*model_fields) if model_fields else lambda _: _utils._SENTINEL + try: + return getter(self.__dict__) == getter(other.__dict__) + except KeyError: + # In rare cases (such as when using the deprecated BaseModel.copy() method), + # the __dict__ may not contain all model fields, which is how we can get here. + # getter(self.__dict__) is much faster than any 'safe' method that accounts + # for missing keys, and wrapping it in a `try` doesn't slow things down much + # in the common case. + self_fields_proxy = _utils.SafeGetItemProxy(self.__dict__) + other_fields_proxy = _utils.SafeGetItemProxy(other.__dict__) + return getter(self_fields_proxy) == getter(other_fields_proxy) + + # other instance is not a BaseModel + else: + return NotImplemented # delegate to the other item in the comparison + + if TYPE_CHECKING: + # We put `__init_subclass__` in a TYPE_CHECKING block because, even though we want the type-checking benefits + # described in the signature of `__init_subclass__` below, we don't want to modify the default behavior of + # subclass initialization. + + def __init_subclass__(cls, **kwargs: Unpack[ConfigDict]): + """This signature is included purely to help type-checkers check arguments to class declaration, which + provides a way to conveniently set model_config key/value pairs. + + ```py + from pydantic import BaseModel + + class MyModel(BaseModel, extra='allow'): + ... + ``` + + However, this may be deceiving, since the _actual_ calls to `__init_subclass__` will not receive any + of the config arguments, and will only receive any keyword arguments passed during class initialization + that are _not_ expected keys in ConfigDict. (This is due to the way `ModelMetaclass.__new__` works.) + + Args: + **kwargs: Keyword arguments passed to the class definition, which set model_config + + Note: + You may want to override `__pydantic_init_subclass__` instead, which behaves similarly but is called + *after* the class is fully initialized. + """ + + def __iter__(self) -> TupleGenerator: + """So `dict(model)` works.""" + yield from [(k, v) for (k, v) in self.__dict__.items() if not k.startswith('_')] + extra = self.__pydantic_extra__ + if extra: + yield from extra.items() + + def __repr__(self) -> str: + return f'{self.__repr_name__()}({self.__repr_str__(", ")})' + + def __repr_args__(self) -> _repr.ReprArgs: + for k, v in self.__dict__.items(): + field = self.model_fields.get(k) + if field and field.repr: + yield k, v + + # `__pydantic_extra__` can fail to be set if the model is not yet fully initialized. + # This can happen if a `ValidationError` is raised during initialization and the instance's + # repr is generated as part of the exception handling. Therefore, we use `getattr` here + # with a fallback, even though the type hints indicate the attribute will always be present. + try: + pydantic_extra = object.__getattribute__(self, '__pydantic_extra__') + except AttributeError: + pydantic_extra = None + + if pydantic_extra is not None: + yield from ((k, v) for k, v in pydantic_extra.items()) + yield from ((k, getattr(self, k)) for k, v in self.model_computed_fields.items() if v.repr) + + # take logic from `_repr.Representation` without the side effects of inheritance, see #5740 + __repr_name__ = _repr.Representation.__repr_name__ + __repr_str__ = _repr.Representation.__repr_str__ + __pretty__ = _repr.Representation.__pretty__ + __rich_repr__ = _repr.Representation.__rich_repr__ + + def __str__(self) -> str: + return self.__repr_str__(' ') + + # ##### Deprecated methods from v1 ##### + @property + @typing_extensions.deprecated( + 'The `__fields__` attribute is deprecated, use `model_fields` instead.', category=None + ) + def __fields__(self) -> dict[str, FieldInfo]: + warnings.warn( + 'The `__fields__` attribute is deprecated, use `model_fields` instead.', category=PydanticDeprecatedSince20 + ) + return self.model_fields + + @property + @typing_extensions.deprecated( + 'The `__fields_set__` attribute is deprecated, use `model_fields_set` instead.', + category=None, + ) + def __fields_set__(self) -> set[str]: + warnings.warn( + 'The `__fields_set__` attribute is deprecated, use `model_fields_set` instead.', + category=PydanticDeprecatedSince20, + ) + return self.__pydantic_fields_set__ + + @typing_extensions.deprecated('The `dict` method is deprecated; use `model_dump` instead.', category=None) + def dict( # noqa: D102 + self, + *, + include: IncEx = None, + exclude: IncEx = None, + by_alias: bool = False, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + ) -> Dict[str, Any]: # noqa UP006 + warnings.warn('The `dict` method is deprecated; use `model_dump` instead.', category=PydanticDeprecatedSince20) + return self.model_dump( + include=include, + exclude=exclude, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + + @typing_extensions.deprecated('The `json` method is deprecated; use `model_dump_json` instead.', category=None) + def json( # noqa: D102 + self, + *, + include: IncEx = None, + exclude: IncEx = None, + by_alias: bool = False, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + encoder: Callable[[Any], Any] | None = PydanticUndefined, # type: ignore[assignment] + models_as_dict: bool = PydanticUndefined, # type: ignore[assignment] + **dumps_kwargs: Any, + ) -> str: + warnings.warn( + 'The `json` method is deprecated; use `model_dump_json` instead.', category=PydanticDeprecatedSince20 + ) + if encoder is not PydanticUndefined: + raise TypeError('The `encoder` argument is no longer supported; use field serializers instead.') + if models_as_dict is not PydanticUndefined: + raise TypeError('The `models_as_dict` argument is no longer supported; use a model serializer instead.') + if dumps_kwargs: + raise TypeError('`dumps_kwargs` keyword arguments are no longer supported.') + return self.model_dump_json( + include=include, + exclude=exclude, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + + @classmethod + @typing_extensions.deprecated('The `parse_obj` method is deprecated; use `model_validate` instead.', category=None) + def parse_obj(cls, obj: Any) -> Self: # noqa: D102 + warnings.warn( + 'The `parse_obj` method is deprecated; use `model_validate` instead.', category=PydanticDeprecatedSince20 + ) + return cls.model_validate(obj) + + @classmethod + @typing_extensions.deprecated( + 'The `parse_raw` method is deprecated; if your data is JSON use `model_validate_json`, ' + 'otherwise load the data then use `model_validate` instead.', + category=None, + ) + def parse_raw( # noqa: D102 + cls, + b: str | bytes, + *, + content_type: str | None = None, + encoding: str = 'utf8', + proto: DeprecatedParseProtocol | None = None, + allow_pickle: bool = False, + ) -> Self: # pragma: no cover + warnings.warn( + 'The `parse_raw` method is deprecated; if your data is JSON use `model_validate_json`, ' + 'otherwise load the data then use `model_validate` instead.', + category=PydanticDeprecatedSince20, + ) + from .deprecated import parse + + try: + obj = parse.load_str_bytes( + b, + proto=proto, + content_type=content_type, + encoding=encoding, + allow_pickle=allow_pickle, + ) + except (ValueError, TypeError) as exc: + import json + + # try to match V1 + if isinstance(exc, UnicodeDecodeError): + type_str = 'value_error.unicodedecode' + elif isinstance(exc, json.JSONDecodeError): + type_str = 'value_error.jsondecode' + elif isinstance(exc, ValueError): + type_str = 'value_error' + else: + type_str = 'type_error' + + # ctx is missing here, but since we've added `input` to the error, we're not pretending it's the same + error: pydantic_core.InitErrorDetails = { + # The type: ignore on the next line is to ignore the requirement of LiteralString + 'type': pydantic_core.PydanticCustomError(type_str, str(exc)), # type: ignore + 'loc': ('__root__',), + 'input': b, + } + raise pydantic_core.ValidationError.from_exception_data(cls.__name__, [error]) + return cls.model_validate(obj) + + @classmethod + @typing_extensions.deprecated( + 'The `parse_file` method is deprecated; load the data from file, then if your data is JSON ' + 'use `model_validate_json`, otherwise `model_validate` instead.', + category=None, + ) + def parse_file( # noqa: D102 + cls, + path: str | Path, + *, + content_type: str | None = None, + encoding: str = 'utf8', + proto: DeprecatedParseProtocol | None = None, + allow_pickle: bool = False, + ) -> Self: + warnings.warn( + 'The `parse_file` method is deprecated; load the data from file, then if your data is JSON ' + 'use `model_validate_json`, otherwise `model_validate` instead.', + category=PydanticDeprecatedSince20, + ) + from .deprecated import parse + + obj = parse.load_file( + path, + proto=proto, + content_type=content_type, + encoding=encoding, + allow_pickle=allow_pickle, + ) + return cls.parse_obj(obj) + + @classmethod + @typing_extensions.deprecated( + 'The `from_orm` method is deprecated; set ' + "`model_config['from_attributes']=True` and use `model_validate` instead.", + category=None, + ) + def from_orm(cls, obj: Any) -> Self: # noqa: D102 + warnings.warn( + 'The `from_orm` method is deprecated; set ' + "`model_config['from_attributes']=True` and use `model_validate` instead.", + category=PydanticDeprecatedSince20, + ) + if not cls.model_config.get('from_attributes', None): + raise PydanticUserError( + 'You must set the config attribute `from_attributes=True` to use from_orm', code=None + ) + return cls.model_validate(obj) + + @classmethod + @typing_extensions.deprecated('The `construct` method is deprecated; use `model_construct` instead.', category=None) + def construct(cls, _fields_set: set[str] | None = None, **values: Any) -> Self: # noqa: D102 + warnings.warn( + 'The `construct` method is deprecated; use `model_construct` instead.', category=PydanticDeprecatedSince20 + ) + return cls.model_construct(_fields_set=_fields_set, **values) + + @typing_extensions.deprecated( + 'The `copy` method is deprecated; use `model_copy` instead. ' + 'See the docstring of `BaseModel.copy` for details about how to handle `include` and `exclude`.', + category=None, + ) + def copy( + self, + *, + include: AbstractSetIntStr | MappingIntStrAny | None = None, + exclude: AbstractSetIntStr | MappingIntStrAny | None = None, + update: Dict[str, Any] | None = None, # noqa UP006 + deep: bool = False, + ) -> Self: # pragma: no cover + """Returns a copy of the model. + + !!! warning "Deprecated" + This method is now deprecated; use `model_copy` instead. + + If you need `include` or `exclude`, use: + + ```py + data = self.model_dump(include=include, exclude=exclude, round_trip=True) + data = {**data, **(update or {})} + copied = self.model_validate(data) + ``` + + Args: + include: Optional set or mapping specifying which fields to include in the copied model. + exclude: Optional set or mapping specifying which fields to exclude in the copied model. + update: Optional dictionary of field-value pairs to override field values in the copied model. + deep: If True, the values of fields that are Pydantic models will be deep-copied. + + Returns: + A copy of the model with included, excluded and updated fields as specified. + """ + warnings.warn( + 'The `copy` method is deprecated; use `model_copy` instead. ' + 'See the docstring of `BaseModel.copy` for details about how to handle `include` and `exclude`.', + category=PydanticDeprecatedSince20, + ) + from .deprecated import copy_internals + + values = dict( + copy_internals._iter( + self, to_dict=False, by_alias=False, include=include, exclude=exclude, exclude_unset=False + ), + **(update or {}), + ) + if self.__pydantic_private__ is None: + private = None + else: + private = {k: v for k, v in self.__pydantic_private__.items() if v is not PydanticUndefined} + + if self.__pydantic_extra__ is None: + extra: dict[str, Any] | None = None + else: + extra = self.__pydantic_extra__.copy() + for k in list(self.__pydantic_extra__): + if k not in values: # k was in the exclude + extra.pop(k) + for k in list(values): + if k in self.__pydantic_extra__: # k must have come from extra + extra[k] = values.pop(k) + + # new `__pydantic_fields_set__` can have unset optional fields with a set value in `update` kwarg + if update: + fields_set = self.__pydantic_fields_set__ | update.keys() + else: + fields_set = set(self.__pydantic_fields_set__) + + # removing excluded fields from `__pydantic_fields_set__` + if exclude: + fields_set -= set(exclude) + + return copy_internals._copy_and_set_values(self, values, fields_set, extra, private, deep=deep) + + @classmethod + @typing_extensions.deprecated('The `schema` method is deprecated; use `model_json_schema` instead.', category=None) + def schema( # noqa: D102 + cls, by_alias: bool = True, ref_template: str = DEFAULT_REF_TEMPLATE + ) -> Dict[str, Any]: # noqa UP006 + warnings.warn( + 'The `schema` method is deprecated; use `model_json_schema` instead.', category=PydanticDeprecatedSince20 + ) + return cls.model_json_schema(by_alias=by_alias, ref_template=ref_template) + + @classmethod + @typing_extensions.deprecated( + 'The `schema_json` method is deprecated; use `model_json_schema` and json.dumps instead.', + category=None, + ) + def schema_json( # noqa: D102 + cls, *, by_alias: bool = True, ref_template: str = DEFAULT_REF_TEMPLATE, **dumps_kwargs: Any + ) -> str: # pragma: no cover + warnings.warn( + 'The `schema_json` method is deprecated; use `model_json_schema` and json.dumps instead.', + category=PydanticDeprecatedSince20, + ) + import json + + from .deprecated.json import pydantic_encoder + + return json.dumps( + cls.model_json_schema(by_alias=by_alias, ref_template=ref_template), + default=pydantic_encoder, + **dumps_kwargs, + ) + + @classmethod + @typing_extensions.deprecated('The `validate` method is deprecated; use `model_validate` instead.', category=None) + def validate(cls, value: Any) -> Self: # noqa: D102 + warnings.warn( + 'The `validate` method is deprecated; use `model_validate` instead.', category=PydanticDeprecatedSince20 + ) + return cls.model_validate(value) + + @classmethod + @typing_extensions.deprecated( + 'The `update_forward_refs` method is deprecated; use `model_rebuild` instead.', + category=None, + ) + def update_forward_refs(cls, **localns: Any) -> None: # noqa: D102 + warnings.warn( + 'The `update_forward_refs` method is deprecated; use `model_rebuild` instead.', + category=PydanticDeprecatedSince20, + ) + if localns: # pragma: no cover + raise TypeError('`localns` arguments are not longer accepted.') + cls.model_rebuild(force=True) + + @typing_extensions.deprecated( + 'The private method `_iter` will be removed and should no longer be used.', category=None + ) + def _iter(self, *args: Any, **kwargs: Any) -> Any: + warnings.warn( + 'The private method `_iter` will be removed and should no longer be used.', + category=PydanticDeprecatedSince20, + ) + from .deprecated import copy_internals + + return copy_internals._iter(self, *args, **kwargs) + + @typing_extensions.deprecated( + 'The private method `_copy_and_set_values` will be removed and should no longer be used.', + category=None, + ) + def _copy_and_set_values(self, *args: Any, **kwargs: Any) -> Any: + warnings.warn( + 'The private method `_copy_and_set_values` will be removed and should no longer be used.', + category=PydanticDeprecatedSince20, + ) + from .deprecated import copy_internals + + return copy_internals._copy_and_set_values(self, *args, **kwargs) + + @classmethod + @typing_extensions.deprecated( + 'The private method `_get_value` will be removed and should no longer be used.', + category=None, + ) + def _get_value(cls, *args: Any, **kwargs: Any) -> Any: + warnings.warn( + 'The private method `_get_value` will be removed and should no longer be used.', + category=PydanticDeprecatedSince20, + ) + from .deprecated import copy_internals + + return copy_internals._get_value(cls, *args, **kwargs) + + @typing_extensions.deprecated( + 'The private method `_calculate_keys` will be removed and should no longer be used.', + category=None, + ) + def _calculate_keys(self, *args: Any, **kwargs: Any) -> Any: + warnings.warn( + 'The private method `_calculate_keys` will be removed and should no longer be used.', + category=PydanticDeprecatedSince20, + ) + from .deprecated import copy_internals + + return copy_internals._calculate_keys(self, *args, **kwargs) + + +@overload +def create_model( + model_name: str, + /, + *, + __config__: ConfigDict | None = None, + __doc__: str | None = None, + __base__: None = None, + __module__: str = __name__, + __validators__: dict[str, Callable[..., Any]] | None = None, + __cls_kwargs__: dict[str, Any] | None = None, + **field_definitions: Any, +) -> type[BaseModel]: ... + + +@overload +def create_model( + model_name: str, + /, + *, + __config__: ConfigDict | None = None, + __doc__: str | None = None, + __base__: type[ModelT] | tuple[type[ModelT], ...], + __module__: str = __name__, + __validators__: dict[str, Callable[..., Any]] | None = None, + __cls_kwargs__: dict[str, Any] | None = None, + **field_definitions: Any, +) -> type[ModelT]: ... + + +def create_model( # noqa: C901 + model_name: str, + /, + *, + __config__: ConfigDict | None = None, + __doc__: str | None = None, + __base__: type[ModelT] | tuple[type[ModelT], ...] | None = None, + __module__: str | None = None, + __validators__: dict[str, Callable[..., Any]] | None = None, + __cls_kwargs__: dict[str, Any] | None = None, + __slots__: tuple[str, ...] | None = None, + **field_definitions: Any, +) -> type[ModelT]: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/models/#dynamic-model-creation + + Dynamically creates and returns a new Pydantic model, in other words, `create_model` dynamically creates a + subclass of [`BaseModel`][pydantic.BaseModel]. + + Args: + model_name: The name of the newly created model. + __config__: The configuration of the new model. + __doc__: The docstring of the new model. + __base__: The base class or classes for the new model. + __module__: The name of the module that the model belongs to; + if `None`, the value is taken from `sys._getframe(1)` + __validators__: A dictionary of methods that validate fields. The keys are the names of the validation methods to + be added to the model, and the values are the validation methods themselves. You can read more about functional + validators [here](https://docs.pydantic.dev/2.8/concepts/validators/#field-validators). + __cls_kwargs__: A dictionary of keyword arguments for class creation, such as `metaclass`. + __slots__: Deprecated. Should not be passed to `create_model`. + **field_definitions: Attributes of the new model. They should be passed in the format: + `=(, )`, `=(, )`, or `typing.Annotated[, ]`. + Any additional metadata in `typing.Annotated[, , ...]` will be ignored. + + Returns: + The new [model][pydantic.BaseModel]. + + Raises: + PydanticUserError: If `__base__` and `__config__` are both passed. + """ + if __slots__ is not None: + # __slots__ will be ignored from here on + warnings.warn('__slots__ should not be passed to create_model', RuntimeWarning) + + if __base__ is not None: + if __config__ is not None: + raise PydanticUserError( + 'to avoid confusion `__config__` and `__base__` cannot be used together', + code='create-model-config-base', + ) + if not isinstance(__base__, tuple): + __base__ = (__base__,) + else: + __base__ = (cast('type[ModelT]', BaseModel),) + + __cls_kwargs__ = __cls_kwargs__ or {} + + fields = {} + annotations = {} + + for f_name, f_def in field_definitions.items(): + if not _fields.is_valid_field_name(f_name): + warnings.warn(f'fields may not start with an underscore, ignoring "{f_name}"', RuntimeWarning) + if isinstance(f_def, tuple): + f_def = cast('tuple[str, Any]', f_def) + try: + f_annotation, f_value = f_def + except ValueError as e: + raise PydanticUserError( + 'Field definitions should be a `(, )`.', + code='create-model-field-definitions', + ) from e + + elif _typing_extra.is_annotated(f_def): + (f_annotation, f_value, *_) = typing_extensions.get_args( + f_def + ) # first two input are expected from Annotated, refer to https://docs.python.org/3/library/typing.html#typing.Annotated + from .fields import FieldInfo + + if not isinstance(f_value, FieldInfo): + raise PydanticUserError( + 'Field definitions should be a Annotated[, ]', + code='create-model-field-definitions', + ) + + else: + f_annotation, f_value = None, f_def + + if f_annotation: + annotations[f_name] = f_annotation + fields[f_name] = f_value + + if __module__ is None: + f = sys._getframe(1) + __module__ = f.f_globals['__name__'] + + namespace: dict[str, Any] = {'__annotations__': annotations, '__module__': __module__} + if __doc__: + namespace.update({'__doc__': __doc__}) + if __validators__: + namespace.update(__validators__) + namespace.update(fields) + if __config__: + namespace['model_config'] = _config.ConfigWrapper(__config__).config_dict + resolved_bases = types.resolve_bases(__base__) + meta, ns, kwds = types.prepare_class(model_name, resolved_bases, kwds=__cls_kwargs__) + if resolved_bases is not __base__: + ns['__orig_bases__'] = __base__ + namespace.update(ns) + + return meta( + model_name, + resolved_bases, + namespace, + __pydantic_reset_parent_namespace__=False, + _create_model_module=__module__, + **kwds, + ) + + +__getattr__ = getattr_migration(__name__) diff --git a/env/Lib/site-packages/pydantic/mypy.py b/env/Lib/site-packages/pydantic/mypy.py new file mode 100644 index 0000000..93e29d5 --- /dev/null +++ b/env/Lib/site-packages/pydantic/mypy.py @@ -0,0 +1,1313 @@ +"""This module includes classes and functions designed specifically for use with the mypy plugin.""" + +from __future__ import annotations + +import sys +from configparser import ConfigParser +from typing import Any, Callable, Iterator + +from mypy.errorcodes import ErrorCode +from mypy.expandtype import expand_type, expand_type_by_instance +from mypy.nodes import ( + ARG_NAMED, + ARG_NAMED_OPT, + ARG_OPT, + ARG_POS, + ARG_STAR2, + INVARIANT, + MDEF, + Argument, + AssignmentStmt, + Block, + CallExpr, + ClassDef, + Context, + Decorator, + DictExpr, + EllipsisExpr, + Expression, + FuncDef, + IfStmt, + JsonDict, + MemberExpr, + NameExpr, + PassStmt, + PlaceholderNode, + RefExpr, + Statement, + StrExpr, + SymbolTableNode, + TempNode, + TypeAlias, + TypeInfo, + Var, +) +from mypy.options import Options +from mypy.plugin import ( + CheckerPluginInterface, + ClassDefContext, + FunctionContext, + MethodContext, + Plugin, + ReportConfigContext, + SemanticAnalyzerPluginInterface, +) +from mypy.plugins import dataclasses +from mypy.plugins.common import ( + deserialize_and_fixup_type, +) +from mypy.semanal import set_callable_name +from mypy.server.trigger import make_wildcard_trigger +from mypy.state import state +from mypy.typeops import map_type_from_supertype +from mypy.types import ( + AnyType, + CallableType, + Instance, + NoneType, + Overloaded, + Type, + TypeOfAny, + TypeType, + TypeVarType, + UnionType, + get_proper_type, +) +from mypy.typevars import fill_typevars +from mypy.util import get_unique_redefinition_name +from mypy.version import __version__ as mypy_version + +from pydantic._internal import _fields +from pydantic.version import parse_mypy_version + +try: + from mypy.types import TypeVarDef # type: ignore[attr-defined] +except ImportError: # pragma: no cover + # Backward-compatible with TypeVarDef from Mypy 0.930. + from mypy.types import TypeVarType as TypeVarDef + +CONFIGFILE_KEY = 'pydantic-mypy' +METADATA_KEY = 'pydantic-mypy-metadata' +BASEMODEL_FULLNAME = 'pydantic.main.BaseModel' +BASESETTINGS_FULLNAME = 'pydantic_settings.main.BaseSettings' +ROOT_MODEL_FULLNAME = 'pydantic.root_model.RootModel' +MODEL_METACLASS_FULLNAME = 'pydantic._internal._model_construction.ModelMetaclass' +FIELD_FULLNAME = 'pydantic.fields.Field' +DATACLASS_FULLNAME = 'pydantic.dataclasses.dataclass' +MODEL_VALIDATOR_FULLNAME = 'pydantic.functional_validators.model_validator' +DECORATOR_FULLNAMES = { + 'pydantic.functional_validators.field_validator', + 'pydantic.functional_validators.model_validator', + 'pydantic.functional_serializers.serializer', + 'pydantic.functional_serializers.model_serializer', + 'pydantic.deprecated.class_validators.validator', + 'pydantic.deprecated.class_validators.root_validator', +} + + +MYPY_VERSION_TUPLE = parse_mypy_version(mypy_version) +BUILTINS_NAME = 'builtins' if MYPY_VERSION_TUPLE >= (0, 930) else '__builtins__' + +# Increment version if plugin changes and mypy caches should be invalidated +__version__ = 2 + + +def plugin(version: str) -> type[Plugin]: + """`version` is the mypy version string. + + We might want to use this to print a warning if the mypy version being used is + newer, or especially older, than we expect (or need). + + Args: + version: The mypy version string. + + Return: + The Pydantic mypy plugin type. + """ + return PydanticPlugin + + +class PydanticPlugin(Plugin): + """The Pydantic mypy plugin.""" + + def __init__(self, options: Options) -> None: + self.plugin_config = PydanticPluginConfig(options) + self._plugin_data = self.plugin_config.to_data() + super().__init__(options) + + def get_base_class_hook(self, fullname: str) -> Callable[[ClassDefContext], bool] | None: + """Update Pydantic model class.""" + sym = self.lookup_fully_qualified(fullname) + if sym and isinstance(sym.node, TypeInfo): # pragma: no branch + # No branching may occur if the mypy cache has not been cleared + if any(base.fullname == BASEMODEL_FULLNAME for base in sym.node.mro): + return self._pydantic_model_class_maker_callback + return None + + def get_metaclass_hook(self, fullname: str) -> Callable[[ClassDefContext], None] | None: + """Update Pydantic `ModelMetaclass` definition.""" + if fullname == MODEL_METACLASS_FULLNAME: + return self._pydantic_model_metaclass_marker_callback + return None + + def get_function_hook(self, fullname: str) -> Callable[[FunctionContext], Type] | None: + """Adjust the return type of the `Field` function.""" + sym = self.lookup_fully_qualified(fullname) + if sym and sym.fullname == FIELD_FULLNAME: + return self._pydantic_field_callback + return None + + def get_method_hook(self, fullname: str) -> Callable[[MethodContext], Type] | None: + """Adjust return type of `from_orm` method call.""" + if fullname.endswith('.from_orm'): + return from_attributes_callback + return None + + def get_class_decorator_hook(self, fullname: str) -> Callable[[ClassDefContext], None] | None: + """Mark pydantic.dataclasses as dataclass. + + Mypy version 1.1.1 added support for `@dataclass_transform` decorator. + """ + if fullname == DATACLASS_FULLNAME and MYPY_VERSION_TUPLE < (1, 1): + return dataclasses.dataclass_class_maker_callback # type: ignore[return-value] + return None + + def report_config_data(self, ctx: ReportConfigContext) -> dict[str, Any]: + """Return all plugin config data. + + Used by mypy to determine if cache needs to be discarded. + """ + return self._plugin_data + + def _pydantic_model_class_maker_callback(self, ctx: ClassDefContext) -> bool: + transformer = PydanticModelTransformer(ctx.cls, ctx.reason, ctx.api, self.plugin_config) + return transformer.transform() + + def _pydantic_model_metaclass_marker_callback(self, ctx: ClassDefContext) -> None: + """Reset dataclass_transform_spec attribute of ModelMetaclass. + + Let the plugin handle it. This behavior can be disabled + if 'debug_dataclass_transform' is set to True', for testing purposes. + """ + if self.plugin_config.debug_dataclass_transform: + return + info_metaclass = ctx.cls.info.declared_metaclass + assert info_metaclass, "callback not passed from 'get_metaclass_hook'" + if getattr(info_metaclass.type, 'dataclass_transform_spec', None): + info_metaclass.type.dataclass_transform_spec = None + + def _pydantic_field_callback(self, ctx: FunctionContext) -> Type: + """Extract the type of the `default` argument from the Field function, and use it as the return type. + + In particular: + * Check whether the default and default_factory argument is specified. + * Output an error if both are specified. + * Retrieve the type of the argument which is specified, and use it as return type for the function. + """ + default_any_type = ctx.default_return_type + + assert ctx.callee_arg_names[0] == 'default', '"default" is no longer first argument in Field()' + assert ctx.callee_arg_names[1] == 'default_factory', '"default_factory" is no longer second argument in Field()' + default_args = ctx.args[0] + default_factory_args = ctx.args[1] + + if default_args and default_factory_args: + error_default_and_default_factory_specified(ctx.api, ctx.context) + return default_any_type + + if default_args: + default_type = ctx.arg_types[0][0] + default_arg = default_args[0] + + # Fallback to default Any type if the field is required + if not isinstance(default_arg, EllipsisExpr): + return default_type + + elif default_factory_args: + default_factory_type = ctx.arg_types[1][0] + + # Functions which use `ParamSpec` can be overloaded, exposing the callable's types as a parameter + # Pydantic calls the default factory without any argument, so we retrieve the first item + if isinstance(default_factory_type, Overloaded): + default_factory_type = default_factory_type.items[0] + + if isinstance(default_factory_type, CallableType): + ret_type = default_factory_type.ret_type + # mypy doesn't think `ret_type` has `args`, you'd think mypy should know, + # add this check in case it varies by version + args = getattr(ret_type, 'args', None) + if args: + if all(isinstance(arg, TypeVarType) for arg in args): + # Looks like the default factory is a type like `list` or `dict`, replace all args with `Any` + ret_type.args = tuple(default_any_type for _ in args) # type: ignore[attr-defined] + return ret_type + + return default_any_type + + +class PydanticPluginConfig: + """A Pydantic mypy plugin config holder. + + Attributes: + init_forbid_extra: Whether to add a `**kwargs` at the end of the generated `__init__` signature. + init_typed: Whether to annotate fields in the generated `__init__`. + warn_required_dynamic_aliases: Whether to raise required dynamic aliases error. + debug_dataclass_transform: Whether to not reset `dataclass_transform_spec` attribute + of `ModelMetaclass` for testing purposes. + """ + + __slots__ = ( + 'init_forbid_extra', + 'init_typed', + 'warn_required_dynamic_aliases', + 'debug_dataclass_transform', + ) + init_forbid_extra: bool + init_typed: bool + warn_required_dynamic_aliases: bool + debug_dataclass_transform: bool # undocumented + + def __init__(self, options: Options) -> None: + if options.config_file is None: # pragma: no cover + return + + toml_config = parse_toml(options.config_file) + if toml_config is not None: + config = toml_config.get('tool', {}).get('pydantic-mypy', {}) + for key in self.__slots__: + setting = config.get(key, False) + if not isinstance(setting, bool): + raise ValueError(f'Configuration value must be a boolean for key: {key}') + setattr(self, key, setting) + else: + plugin_config = ConfigParser() + plugin_config.read(options.config_file) + for key in self.__slots__: + setting = plugin_config.getboolean(CONFIGFILE_KEY, key, fallback=False) + setattr(self, key, setting) + + def to_data(self) -> dict[str, Any]: + """Returns a dict of config names to their values.""" + return {key: getattr(self, key) for key in self.__slots__} + + +def from_attributes_callback(ctx: MethodContext) -> Type: + """Raise an error if from_attributes is not enabled.""" + model_type: Instance + ctx_type = ctx.type + if isinstance(ctx_type, TypeType): + ctx_type = ctx_type.item + if isinstance(ctx_type, CallableType) and isinstance(ctx_type.ret_type, Instance): + model_type = ctx_type.ret_type # called on the class + elif isinstance(ctx_type, Instance): + model_type = ctx_type # called on an instance (unusual, but still valid) + else: # pragma: no cover + detail = f'ctx.type: {ctx_type} (of type {ctx_type.__class__.__name__})' + error_unexpected_behavior(detail, ctx.api, ctx.context) + return ctx.default_return_type + pydantic_metadata = model_type.type.metadata.get(METADATA_KEY) + if pydantic_metadata is None: + return ctx.default_return_type + from_attributes = pydantic_metadata.get('config', {}).get('from_attributes') + if from_attributes is not True: + error_from_attributes(model_type.type.name, ctx.api, ctx.context) + return ctx.default_return_type + + +class PydanticModelField: + """Based on mypy.plugins.dataclasses.DataclassAttribute.""" + + def __init__( + self, + name: str, + alias: str | None, + has_dynamic_alias: bool, + has_default: bool, + line: int, + column: int, + type: Type | None, + info: TypeInfo, + ): + self.name = name + self.alias = alias + self.has_dynamic_alias = has_dynamic_alias + self.has_default = has_default + self.line = line + self.column = column + self.type = type + self.info = info + + def to_argument( + self, + current_info: TypeInfo, + typed: bool, + force_optional: bool, + use_alias: bool, + api: SemanticAnalyzerPluginInterface, + force_typevars_invariant: bool, + ) -> Argument: + """Based on mypy.plugins.dataclasses.DataclassAttribute.to_argument.""" + variable = self.to_var(current_info, api, use_alias, force_typevars_invariant) + type_annotation = self.expand_type(current_info, api) if typed else AnyType(TypeOfAny.explicit) + return Argument( + variable=variable, + type_annotation=type_annotation, + initializer=None, + kind=ARG_NAMED_OPT if force_optional or self.has_default else ARG_NAMED, + ) + + def expand_type( + self, current_info: TypeInfo, api: SemanticAnalyzerPluginInterface, force_typevars_invariant: bool = False + ) -> Type | None: + """Based on mypy.plugins.dataclasses.DataclassAttribute.expand_type.""" + # The getattr in the next line is used to prevent errors in legacy versions of mypy without this attribute + if force_typevars_invariant: + # In some cases, mypy will emit an error "Cannot use a covariant type variable as a parameter" + # To prevent that, we add an option to replace typevars with invariant ones while building certain + # method signatures (in particular, `__init__`). There may be a better way to do this, if this causes + # us problems in the future, we should look into why the dataclasses plugin doesn't have this issue. + if isinstance(self.type, TypeVarType): + modified_type = self.type.copy_modified() + modified_type.variance = INVARIANT + self.type = modified_type + + if self.type is not None and getattr(self.info, 'self_type', None) is not None: + # In general, it is not safe to call `expand_type()` during semantic analyzis, + # however this plugin is called very late, so all types should be fully ready. + # Also, it is tricky to avoid eager expansion of Self types here (e.g. because + # we serialize attributes). + with state.strict_optional_set(api.options.strict_optional): + filled_with_typevars = fill_typevars(current_info) + if force_typevars_invariant: + for arg in filled_with_typevars.args: + if isinstance(arg, TypeVarType): + arg.variance = INVARIANT + return expand_type(self.type, {self.info.self_type.id: filled_with_typevars}) + return self.type + + def to_var( + self, + current_info: TypeInfo, + api: SemanticAnalyzerPluginInterface, + use_alias: bool, + force_typevars_invariant: bool = False, + ) -> Var: + """Based on mypy.plugins.dataclasses.DataclassAttribute.to_var.""" + if use_alias and self.alias is not None: + name = self.alias + else: + name = self.name + + return Var(name, self.expand_type(current_info, api, force_typevars_invariant)) + + def serialize(self) -> JsonDict: + """Based on mypy.plugins.dataclasses.DataclassAttribute.serialize.""" + assert self.type + return { + 'name': self.name, + 'alias': self.alias, + 'has_dynamic_alias': self.has_dynamic_alias, + 'has_default': self.has_default, + 'line': self.line, + 'column': self.column, + 'type': self.type.serialize(), + } + + @classmethod + def deserialize(cls, info: TypeInfo, data: JsonDict, api: SemanticAnalyzerPluginInterface) -> PydanticModelField: + """Based on mypy.plugins.dataclasses.DataclassAttribute.deserialize.""" + data = data.copy() + typ = deserialize_and_fixup_type(data.pop('type'), api) + return cls(type=typ, info=info, **data) + + def expand_typevar_from_subtype(self, sub_type: TypeInfo, api: SemanticAnalyzerPluginInterface) -> None: + """Expands type vars in the context of a subtype when an attribute is inherited + from a generic super type. + """ + if self.type is not None: + with state.strict_optional_set(api.options.strict_optional): + self.type = map_type_from_supertype(self.type, sub_type, self.info) + + +class PydanticModelClassVar: + """Based on mypy.plugins.dataclasses.DataclassAttribute. + + ClassVars are ignored by subclasses. + + Attributes: + name: the ClassVar name + """ + + def __init__(self, name): + self.name = name + + @classmethod + def deserialize(cls, data: JsonDict) -> PydanticModelClassVar: + """Based on mypy.plugins.dataclasses.DataclassAttribute.deserialize.""" + data = data.copy() + return cls(**data) + + def serialize(self) -> JsonDict: + """Based on mypy.plugins.dataclasses.DataclassAttribute.serialize.""" + return { + 'name': self.name, + } + + +class PydanticModelTransformer: + """Transform the BaseModel subclass according to the plugin settings. + + Attributes: + tracked_config_fields: A set of field configs that the plugin has to track their value. + """ + + tracked_config_fields: set[str] = { + 'extra', + 'frozen', + 'from_attributes', + 'populate_by_name', + 'alias_generator', + } + + def __init__( + self, + cls: ClassDef, + reason: Expression | Statement, + api: SemanticAnalyzerPluginInterface, + plugin_config: PydanticPluginConfig, + ) -> None: + self._cls = cls + self._reason = reason + self._api = api + + self.plugin_config = plugin_config + + def transform(self) -> bool: + """Configures the BaseModel subclass according to the plugin settings. + + In particular: + + * determines the model config and fields, + * adds a fields-aware signature for the initializer and construct methods + * freezes the class if frozen = True + * stores the fields, config, and if the class is settings in the mypy metadata for access by subclasses + """ + info = self._cls.info + is_root_model = any(ROOT_MODEL_FULLNAME in base.fullname for base in info.mro[:-1]) + config = self.collect_config() + fields, class_vars = self.collect_fields_and_class_vars(config, is_root_model) + if fields is None or class_vars is None: + # Some definitions are not ready. We need another pass. + return False + for field in fields: + if field.type is None: + return False + + is_settings = any(base.fullname == BASESETTINGS_FULLNAME for base in info.mro[:-1]) + self.add_initializer(fields, config, is_settings, is_root_model) + if not is_root_model: + self.add_model_construct_method(fields, config, is_settings) + self.set_frozen(fields, self._api, frozen=config.frozen is True) + + self.adjust_decorator_signatures() + + info.metadata[METADATA_KEY] = { + 'fields': {field.name: field.serialize() for field in fields}, + 'class_vars': {class_var.name: class_var.serialize() for class_var in class_vars}, + 'config': config.get_values_dict(), + } + + return True + + def adjust_decorator_signatures(self) -> None: + """When we decorate a function `f` with `pydantic.validator(...)`, `pydantic.field_validator` + or `pydantic.serializer(...)`, mypy sees `f` as a regular method taking a `self` instance, + even though pydantic internally wraps `f` with `classmethod` if necessary. + + Teach mypy this by marking any function whose outermost decorator is a `validator()`, + `field_validator()` or `serializer()` call as a `classmethod`. + """ + for name, sym in self._cls.info.names.items(): + if isinstance(sym.node, Decorator): + first_dec = sym.node.original_decorators[0] + if ( + isinstance(first_dec, CallExpr) + and isinstance(first_dec.callee, NameExpr) + and first_dec.callee.fullname in DECORATOR_FULLNAMES + # @model_validator(mode="after") is an exception, it expects a regular method + and not ( + first_dec.callee.fullname == MODEL_VALIDATOR_FULLNAME + and any( + first_dec.arg_names[i] == 'mode' and isinstance(arg, StrExpr) and arg.value == 'after' + for i, arg in enumerate(first_dec.args) + ) + ) + ): + # TODO: Only do this if the first argument of the decorated function is `cls` + sym.node.func.is_class = True + + def collect_config(self) -> ModelConfigData: # noqa: C901 (ignore complexity) + """Collects the values of the config attributes that are used by the plugin, accounting for parent classes.""" + cls = self._cls + config = ModelConfigData() + + has_config_kwargs = False + has_config_from_namespace = False + + # Handle `class MyModel(BaseModel, =, ...):` + for name, expr in cls.keywords.items(): + config_data = self.get_config_update(name, expr) + if config_data: + has_config_kwargs = True + config.update(config_data) + + # Handle `model_config` + stmt: Statement | None = None + for stmt in cls.defs.body: + if not isinstance(stmt, (AssignmentStmt, ClassDef)): + continue + + if isinstance(stmt, AssignmentStmt): + lhs = stmt.lvalues[0] + if not isinstance(lhs, NameExpr) or lhs.name != 'model_config': + continue + + if isinstance(stmt.rvalue, CallExpr): # calls to `dict` or `ConfigDict` + for arg_name, arg in zip(stmt.rvalue.arg_names, stmt.rvalue.args): + if arg_name is None: + continue + config.update(self.get_config_update(arg_name, arg, lax_extra=True)) + elif isinstance(stmt.rvalue, DictExpr): # dict literals + for key_expr, value_expr in stmt.rvalue.items: + if not isinstance(key_expr, StrExpr): + continue + config.update(self.get_config_update(key_expr.value, value_expr)) + + elif isinstance(stmt, ClassDef): + if stmt.name != 'Config': # 'deprecated' Config-class + continue + for substmt in stmt.defs.body: + if not isinstance(substmt, AssignmentStmt): + continue + lhs = substmt.lvalues[0] + if not isinstance(lhs, NameExpr): + continue + config.update(self.get_config_update(lhs.name, substmt.rvalue)) + + if has_config_kwargs: + self._api.fail( + 'Specifying config in two places is ambiguous, use either Config attribute or class kwargs', + cls, + ) + break + + has_config_from_namespace = True + + if has_config_kwargs or has_config_from_namespace: + if ( + stmt + and config.has_alias_generator + and not config.populate_by_name + and self.plugin_config.warn_required_dynamic_aliases + ): + error_required_dynamic_aliases(self._api, stmt) + + for info in cls.info.mro[1:]: # 0 is the current class + if METADATA_KEY not in info.metadata: + continue + + # Each class depends on the set of fields in its ancestors + self._api.add_plugin_dependency(make_wildcard_trigger(info.fullname)) + for name, value in info.metadata[METADATA_KEY]['config'].items(): + config.setdefault(name, value) + return config + + def collect_fields_and_class_vars( + self, model_config: ModelConfigData, is_root_model: bool + ) -> tuple[list[PydanticModelField] | None, list[PydanticModelClassVar] | None]: + """Collects the fields for the model, accounting for parent classes.""" + cls = self._cls + + # First, collect fields and ClassVars belonging to any class in the MRO, ignoring duplicates. + # + # We iterate through the MRO in reverse because attrs defined in the parent must appear + # earlier in the attributes list than attrs defined in the child. See: + # https://docs.python.org/3/library/dataclasses.html#inheritance + # + # However, we also want fields defined in the subtype to override ones defined + # in the parent. We can implement this via a dict without disrupting the attr order + # because dicts preserve insertion order in Python 3.7+. + found_fields: dict[str, PydanticModelField] = {} + found_class_vars: dict[str, PydanticModelClassVar] = {} + for info in reversed(cls.info.mro[1:-1]): # 0 is the current class, -2 is BaseModel, -1 is object + # if BASEMODEL_METADATA_TAG_KEY in info.metadata and BASEMODEL_METADATA_KEY not in info.metadata: + # # We haven't processed the base class yet. Need another pass. + # return None, None + if METADATA_KEY not in info.metadata: + continue + + # Each class depends on the set of attributes in its dataclass ancestors. + self._api.add_plugin_dependency(make_wildcard_trigger(info.fullname)) + + for name, data in info.metadata[METADATA_KEY]['fields'].items(): + field = PydanticModelField.deserialize(info, data, self._api) + # (The following comment comes directly from the dataclasses plugin) + # TODO: We shouldn't be performing type operations during the main + # semantic analysis pass, since some TypeInfo attributes might + # still be in flux. This should be performed in a later phase. + field.expand_typevar_from_subtype(cls.info, self._api) + found_fields[name] = field + + sym_node = cls.info.names.get(name) + if sym_node and sym_node.node and not isinstance(sym_node.node, Var): + self._api.fail( + 'BaseModel field may only be overridden by another field', + sym_node.node, + ) + # Collect ClassVars + for name, data in info.metadata[METADATA_KEY]['class_vars'].items(): + found_class_vars[name] = PydanticModelClassVar.deserialize(data) + + # Second, collect fields and ClassVars belonging to the current class. + current_field_names: set[str] = set() + current_class_vars_names: set[str] = set() + for stmt in self._get_assignment_statements_from_block(cls.defs): + maybe_field = self.collect_field_or_class_var_from_stmt(stmt, model_config, found_class_vars) + if isinstance(maybe_field, PydanticModelField): + lhs = stmt.lvalues[0] + if is_root_model and lhs.name != 'root': + error_extra_fields_on_root_model(self._api, stmt) + else: + current_field_names.add(lhs.name) + found_fields[lhs.name] = maybe_field + elif isinstance(maybe_field, PydanticModelClassVar): + lhs = stmt.lvalues[0] + current_class_vars_names.add(lhs.name) + found_class_vars[lhs.name] = maybe_field + + return list(found_fields.values()), list(found_class_vars.values()) + + def _get_assignment_statements_from_if_statement(self, stmt: IfStmt) -> Iterator[AssignmentStmt]: + for body in stmt.body: + if not body.is_unreachable: + yield from self._get_assignment_statements_from_block(body) + if stmt.else_body is not None and not stmt.else_body.is_unreachable: + yield from self._get_assignment_statements_from_block(stmt.else_body) + + def _get_assignment_statements_from_block(self, block: Block) -> Iterator[AssignmentStmt]: + for stmt in block.body: + if isinstance(stmt, AssignmentStmt): + yield stmt + elif isinstance(stmt, IfStmt): + yield from self._get_assignment_statements_from_if_statement(stmt) + + def collect_field_or_class_var_from_stmt( # noqa C901 + self, stmt: AssignmentStmt, model_config: ModelConfigData, class_vars: dict[str, PydanticModelClassVar] + ) -> PydanticModelField | PydanticModelClassVar | None: + """Get pydantic model field from statement. + + Args: + stmt: The statement. + model_config: Configuration settings for the model. + class_vars: ClassVars already known to be defined on the model. + + Returns: + A pydantic model field if it could find the field in statement. Otherwise, `None`. + """ + cls = self._cls + + lhs = stmt.lvalues[0] + if not isinstance(lhs, NameExpr) or not _fields.is_valid_field_name(lhs.name) or lhs.name == 'model_config': + return None + + if not stmt.new_syntax: + if ( + isinstance(stmt.rvalue, CallExpr) + and isinstance(stmt.rvalue.callee, CallExpr) + and isinstance(stmt.rvalue.callee.callee, NameExpr) + and stmt.rvalue.callee.callee.fullname in DECORATOR_FULLNAMES + ): + # This is a (possibly-reused) validator or serializer, not a field + # In particular, it looks something like: my_validator = validator('my_field')(f) + # Eventually, we may want to attempt to respect model_config['ignored_types'] + return None + + if lhs.name in class_vars: + # Class vars are not fields and are not required to be annotated + return None + + # The assignment does not have an annotation, and it's not anything else we recognize + error_untyped_fields(self._api, stmt) + return None + + lhs = stmt.lvalues[0] + if not isinstance(lhs, NameExpr): + return None + + if not _fields.is_valid_field_name(lhs.name) or lhs.name == 'model_config': + return None + + sym = cls.info.names.get(lhs.name) + if sym is None: # pragma: no cover + # This is likely due to a star import (see the dataclasses plugin for a more detailed explanation) + # This is the same logic used in the dataclasses plugin + return None + + node = sym.node + if isinstance(node, PlaceholderNode): # pragma: no cover + # See the PlaceholderNode docstring for more detail about how this can occur + # Basically, it is an edge case when dealing with complex import logic + + # The dataclasses plugin now asserts this cannot happen, but I'd rather not error if it does.. + return None + + if isinstance(node, TypeAlias): + self._api.fail( + 'Type aliases inside BaseModel definitions are not supported at runtime', + node, + ) + # Skip processing this node. This doesn't match the runtime behaviour, + # but the only alternative would be to modify the SymbolTable, + # and it's a little hairy to do that in a plugin. + return None + + if not isinstance(node, Var): # pragma: no cover + # Don't know if this edge case still happens with the `is_valid_field` check above + # but better safe than sorry + + # The dataclasses plugin now asserts this cannot happen, but I'd rather not error if it does.. + return None + + # x: ClassVar[int] is not a field + if node.is_classvar: + return PydanticModelClassVar(lhs.name) + + # x: InitVar[int] is not supported in BaseModel + node_type = get_proper_type(node.type) + if isinstance(node_type, Instance) and node_type.type.fullname == 'dataclasses.InitVar': + self._api.fail( + 'InitVar is not supported in BaseModel', + node, + ) + + has_default = self.get_has_default(stmt) + + if sym.type is None and node.is_final and node.is_inferred: + # This follows the logic from the dataclasses plugin. The following comment is taken verbatim: + # + # This is a special case, assignment like x: Final = 42 is classified + # annotated above, but mypy strips the `Final` turning it into x = 42. + # We do not support inferred types in dataclasses, so we can try inferring + # type for simple literals, and otherwise require an explicit type + # argument for Final[...]. + typ = self._api.analyze_simple_literal_type(stmt.rvalue, is_final=True) + if typ: + node.type = typ + else: + self._api.fail( + 'Need type argument for Final[...] with non-literal default in BaseModel', + stmt, + ) + node.type = AnyType(TypeOfAny.from_error) + + alias, has_dynamic_alias = self.get_alias_info(stmt) + if has_dynamic_alias and not model_config.populate_by_name and self.plugin_config.warn_required_dynamic_aliases: + error_required_dynamic_aliases(self._api, stmt) + + init_type = self._infer_dataclass_attr_init_type(sym, lhs.name, stmt) + return PydanticModelField( + name=lhs.name, + has_dynamic_alias=has_dynamic_alias, + has_default=has_default, + alias=alias, + line=stmt.line, + column=stmt.column, + type=init_type, + info=cls.info, + ) + + def _infer_dataclass_attr_init_type(self, sym: SymbolTableNode, name: str, context: Context) -> Type | None: + """Infer __init__ argument type for an attribute. + + In particular, possibly use the signature of __set__. + """ + default = sym.type + if sym.implicit: + return default + t = get_proper_type(sym.type) + + # Perform a simple-minded inference from the signature of __set__, if present. + # We can't use mypy.checkmember here, since this plugin runs before type checking. + # We only support some basic scanerios here, which is hopefully sufficient for + # the vast majority of use cases. + if not isinstance(t, Instance): + return default + setter = t.type.get('__set__') + if setter: + if isinstance(setter.node, FuncDef): + super_info = t.type.get_containing_type_info('__set__') + assert super_info + if setter.type: + setter_type = get_proper_type(map_type_from_supertype(setter.type, t.type, super_info)) + else: + return AnyType(TypeOfAny.unannotated) + if isinstance(setter_type, CallableType) and setter_type.arg_kinds == [ + ARG_POS, + ARG_POS, + ARG_POS, + ]: + return expand_type_by_instance(setter_type.arg_types[2], t) + else: + self._api.fail(f'Unsupported signature for "__set__" in "{t.type.name}"', context) + else: + self._api.fail(f'Unsupported "__set__" in "{t.type.name}"', context) + + return default + + def add_initializer( + self, fields: list[PydanticModelField], config: ModelConfigData, is_settings: bool, is_root_model: bool + ) -> None: + """Adds a fields-aware `__init__` method to the class. + + The added `__init__` will be annotated with types vs. all `Any` depending on the plugin settings. + """ + if '__init__' in self._cls.info.names and not self._cls.info.names['__init__'].plugin_generated: + return # Don't generate an __init__ if one already exists + + typed = self.plugin_config.init_typed + use_alias = config.populate_by_name is not True + requires_dynamic_aliases = bool(config.has_alias_generator and not config.populate_by_name) + args = self.get_field_arguments( + fields, + typed=typed, + requires_dynamic_aliases=requires_dynamic_aliases, + use_alias=use_alias, + is_settings=is_settings, + force_typevars_invariant=True, + ) + + if is_root_model and MYPY_VERSION_TUPLE <= (1, 0, 1): + # convert root argument to positional argument + # This is needed because mypy support for `dataclass_transform` isn't complete on 1.0.1 + args[0].kind = ARG_POS if args[0].kind == ARG_NAMED else ARG_OPT + + if is_settings: + base_settings_node = self._api.lookup_fully_qualified(BASESETTINGS_FULLNAME).node + if '__init__' in base_settings_node.names: + base_settings_init_node = base_settings_node.names['__init__'].node + if base_settings_init_node is not None and base_settings_init_node.type is not None: + func_type = base_settings_init_node.type + for arg_idx, arg_name in enumerate(func_type.arg_names): + if arg_name.startswith('__') or not arg_name.startswith('_'): + continue + analyzed_variable_type = self._api.anal_type(func_type.arg_types[arg_idx]) + variable = Var(arg_name, analyzed_variable_type) + args.append(Argument(variable, analyzed_variable_type, None, ARG_OPT)) + + if not self.should_init_forbid_extra(fields, config): + var = Var('kwargs') + args.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2)) + + add_method(self._api, self._cls, '__init__', args=args, return_type=NoneType()) + + def add_model_construct_method( + self, fields: list[PydanticModelField], config: ModelConfigData, is_settings: bool + ) -> None: + """Adds a fully typed `model_construct` classmethod to the class. + + Similar to the fields-aware __init__ method, but always uses the field names (not aliases), + and does not treat settings fields as optional. + """ + set_str = self._api.named_type(f'{BUILTINS_NAME}.set', [self._api.named_type(f'{BUILTINS_NAME}.str')]) + optional_set_str = UnionType([set_str, NoneType()]) + fields_set_argument = Argument(Var('_fields_set', optional_set_str), optional_set_str, None, ARG_OPT) + with state.strict_optional_set(self._api.options.strict_optional): + args = self.get_field_arguments( + fields, typed=True, requires_dynamic_aliases=False, use_alias=False, is_settings=is_settings + ) + if not self.should_init_forbid_extra(fields, config): + var = Var('kwargs') + args.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2)) + + args = [fields_set_argument] + args + + add_method( + self._api, + self._cls, + 'model_construct', + args=args, + return_type=fill_typevars(self._cls.info), + is_classmethod=True, + ) + + def set_frozen(self, fields: list[PydanticModelField], api: SemanticAnalyzerPluginInterface, frozen: bool) -> None: + """Marks all fields as properties so that attempts to set them trigger mypy errors. + + This is the same approach used by the attrs and dataclasses plugins. + """ + info = self._cls.info + for field in fields: + sym_node = info.names.get(field.name) + if sym_node is not None: + var = sym_node.node + if isinstance(var, Var): + var.is_property = frozen + elif isinstance(var, PlaceholderNode) and not self._api.final_iteration: + # See https://github.com/pydantic/pydantic/issues/5191 to hit this branch for test coverage + self._api.defer() + else: # pragma: no cover + # I don't know whether it's possible to hit this branch, but I've added it for safety + try: + var_str = str(var) + except TypeError: + # This happens for PlaceholderNode; perhaps it will happen for other types in the future.. + var_str = repr(var) + detail = f'sym_node.node: {var_str} (of type {var.__class__})' + error_unexpected_behavior(detail, self._api, self._cls) + else: + var = field.to_var(info, api, use_alias=False) + var.info = info + var.is_property = frozen + var._fullname = info.fullname + '.' + var.name + info.names[var.name] = SymbolTableNode(MDEF, var) + + def get_config_update(self, name: str, arg: Expression, lax_extra: bool = False) -> ModelConfigData | None: + """Determines the config update due to a single kwarg in the ConfigDict definition. + + Warns if a tracked config attribute is set to a value the plugin doesn't know how to interpret (e.g., an int) + """ + if name not in self.tracked_config_fields: + return None + if name == 'extra': + if isinstance(arg, StrExpr): + forbid_extra = arg.value == 'forbid' + elif isinstance(arg, MemberExpr): + forbid_extra = arg.name == 'forbid' + else: + if not lax_extra: + # Only emit an error for other types of `arg` (e.g., `NameExpr`, `ConditionalExpr`, etc.) when + # reading from a config class, etc. If a ConfigDict is used, then we don't want to emit an error + # because you'll get type checking from the ConfigDict itself. + # + # It would be nice if we could introspect the types better otherwise, but I don't know what the API + # is to evaluate an expr into its type and then check if that type is compatible with the expected + # type. Note that you can still get proper type checking via: `model_config = ConfigDict(...)`, just + # if you don't use an explicit string, the plugin won't be able to infer whether extra is forbidden. + error_invalid_config_value(name, self._api, arg) + return None + return ModelConfigData(forbid_extra=forbid_extra) + if name == 'alias_generator': + has_alias_generator = True + if isinstance(arg, NameExpr) and arg.fullname == 'builtins.None': + has_alias_generator = False + return ModelConfigData(has_alias_generator=has_alias_generator) + if isinstance(arg, NameExpr) and arg.fullname in ('builtins.True', 'builtins.False'): + return ModelConfigData(**{name: arg.fullname == 'builtins.True'}) + error_invalid_config_value(name, self._api, arg) + return None + + @staticmethod + def get_has_default(stmt: AssignmentStmt) -> bool: + """Returns a boolean indicating whether the field defined in `stmt` is a required field.""" + expr = stmt.rvalue + if isinstance(expr, TempNode): + # TempNode means annotation-only, so has no default + return False + if isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME: + # The "default value" is a call to `Field`; at this point, the field has a default if and only if: + # * there is a positional argument that is not `...` + # * there is a keyword argument named "default" that is not `...` + # * there is a "default_factory" that is not `None` + for arg, name in zip(expr.args, expr.arg_names): + # If name is None, then this arg is the default because it is the only positional argument. + if name is None or name == 'default': + return arg.__class__ is not EllipsisExpr + if name == 'default_factory': + return not (isinstance(arg, NameExpr) and arg.fullname == 'builtins.None') + return False + # Has no default if the "default value" is Ellipsis (i.e., `field_name: Annotation = ...`) + return not isinstance(expr, EllipsisExpr) + + @staticmethod + def get_alias_info(stmt: AssignmentStmt) -> tuple[str | None, bool]: + """Returns a pair (alias, has_dynamic_alias), extracted from the declaration of the field defined in `stmt`. + + `has_dynamic_alias` is True if and only if an alias is provided, but not as a string literal. + If `has_dynamic_alias` is True, `alias` will be None. + """ + expr = stmt.rvalue + if isinstance(expr, TempNode): + # TempNode means annotation-only + return None, False + + if not ( + isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME + ): + # Assigned value is not a call to pydantic.fields.Field + return None, False + + for i, arg_name in enumerate(expr.arg_names): + if arg_name != 'alias': + continue + arg = expr.args[i] + if isinstance(arg, StrExpr): + return arg.value, False + else: + return None, True + return None, False + + def get_field_arguments( + self, + fields: list[PydanticModelField], + typed: bool, + use_alias: bool, + requires_dynamic_aliases: bool, + is_settings: bool, + force_typevars_invariant: bool = False, + ) -> list[Argument]: + """Helper function used during the construction of the `__init__` and `model_construct` method signatures. + + Returns a list of mypy Argument instances for use in the generated signatures. + """ + info = self._cls.info + arguments = [ + field.to_argument( + info, + typed=typed, + force_optional=requires_dynamic_aliases or is_settings, + use_alias=use_alias, + api=self._api, + force_typevars_invariant=force_typevars_invariant, + ) + for field in fields + if not (use_alias and field.has_dynamic_alias) + ] + return arguments + + def should_init_forbid_extra(self, fields: list[PydanticModelField], config: ModelConfigData) -> bool: + """Indicates whether the generated `__init__` should get a `**kwargs` at the end of its signature. + + We disallow arbitrary kwargs if the extra config setting is "forbid", or if the plugin config says to, + *unless* a required dynamic alias is present (since then we can't determine a valid signature). + """ + if not config.populate_by_name: + if self.is_dynamic_alias_present(fields, bool(config.has_alias_generator)): + return False + if config.forbid_extra: + return True + return self.plugin_config.init_forbid_extra + + @staticmethod + def is_dynamic_alias_present(fields: list[PydanticModelField], has_alias_generator: bool) -> bool: + """Returns whether any fields on the model have a "dynamic alias", i.e., an alias that cannot be + determined during static analysis. + """ + for field in fields: + if field.has_dynamic_alias: + return True + if has_alias_generator: + for field in fields: + if field.alias is None: + return True + return False + + +class ModelConfigData: + """Pydantic mypy plugin model config class.""" + + def __init__( + self, + forbid_extra: bool | None = None, + frozen: bool | None = None, + from_attributes: bool | None = None, + populate_by_name: bool | None = None, + has_alias_generator: bool | None = None, + ): + self.forbid_extra = forbid_extra + self.frozen = frozen + self.from_attributes = from_attributes + self.populate_by_name = populate_by_name + self.has_alias_generator = has_alias_generator + + def get_values_dict(self) -> dict[str, Any]: + """Returns a dict of Pydantic model config names to their values. + + It includes the config if config value is not `None`. + """ + return {k: v for k, v in self.__dict__.items() if v is not None} + + def update(self, config: ModelConfigData | None) -> None: + """Update Pydantic model config values.""" + if config is None: + return + for k, v in config.get_values_dict().items(): + setattr(self, k, v) + + def setdefault(self, key: str, value: Any) -> None: + """Set default value for Pydantic model config if config value is `None`.""" + if getattr(self, key) is None: + setattr(self, key, value) + + +ERROR_ORM = ErrorCode('pydantic-orm', 'Invalid from_attributes call', 'Pydantic') +ERROR_CONFIG = ErrorCode('pydantic-config', 'Invalid config value', 'Pydantic') +ERROR_ALIAS = ErrorCode('pydantic-alias', 'Dynamic alias disallowed', 'Pydantic') +ERROR_UNEXPECTED = ErrorCode('pydantic-unexpected', 'Unexpected behavior', 'Pydantic') +ERROR_UNTYPED = ErrorCode('pydantic-field', 'Untyped field disallowed', 'Pydantic') +ERROR_FIELD_DEFAULTS = ErrorCode('pydantic-field', 'Invalid Field defaults', 'Pydantic') +ERROR_EXTRA_FIELD_ROOT_MODEL = ErrorCode('pydantic-field', 'Extra field on RootModel subclass', 'Pydantic') + + +def error_from_attributes(model_name: str, api: CheckerPluginInterface, context: Context) -> None: + """Emits an error when the model does not have `from_attributes=True`.""" + api.fail(f'"{model_name}" does not have from_attributes=True', context, code=ERROR_ORM) + + +def error_invalid_config_value(name: str, api: SemanticAnalyzerPluginInterface, context: Context) -> None: + """Emits an error when the config value is invalid.""" + api.fail(f'Invalid value for "Config.{name}"', context, code=ERROR_CONFIG) + + +def error_required_dynamic_aliases(api: SemanticAnalyzerPluginInterface, context: Context) -> None: + """Emits required dynamic aliases error. + + This will be called when `warn_required_dynamic_aliases=True`. + """ + api.fail('Required dynamic aliases disallowed', context, code=ERROR_ALIAS) + + +def error_unexpected_behavior( + detail: str, api: CheckerPluginInterface | SemanticAnalyzerPluginInterface, context: Context +) -> None: # pragma: no cover + """Emits unexpected behavior error.""" + # Can't think of a good way to test this, but I confirmed it renders as desired by adding to a non-error path + link = 'https://github.com/pydantic/pydantic/issues/new/choose' + full_message = f'The pydantic mypy plugin ran into unexpected behavior: {detail}\n' + full_message += f'Please consider reporting this bug at {link} so we can try to fix it!' + api.fail(full_message, context, code=ERROR_UNEXPECTED) + + +def error_untyped_fields(api: SemanticAnalyzerPluginInterface, context: Context) -> None: + """Emits an error when there is an untyped field in the model.""" + api.fail('Untyped fields disallowed', context, code=ERROR_UNTYPED) + + +def error_extra_fields_on_root_model(api: CheckerPluginInterface, context: Context) -> None: + """Emits an error when there is more than just a root field defined for a subclass of RootModel.""" + api.fail('Only `root` is allowed as a field of a `RootModel`', context, code=ERROR_EXTRA_FIELD_ROOT_MODEL) + + +def error_default_and_default_factory_specified(api: CheckerPluginInterface, context: Context) -> None: + """Emits an error when `Field` has both `default` and `default_factory` together.""" + api.fail('Field default and default_factory cannot be specified together', context, code=ERROR_FIELD_DEFAULTS) + + +def add_method( + api: SemanticAnalyzerPluginInterface | CheckerPluginInterface, + cls: ClassDef, + name: str, + args: list[Argument], + return_type: Type, + self_type: Type | None = None, + tvar_def: TypeVarDef | None = None, + is_classmethod: bool = False, +) -> None: + """Very closely related to `mypy.plugins.common.add_method_to_class`, with a few pydantic-specific changes.""" + info = cls.info + + # First remove any previously generated methods with the same name + # to avoid clashes and problems in the semantic analyzer. + if name in info.names: + sym = info.names[name] + if sym.plugin_generated and isinstance(sym.node, FuncDef): + cls.defs.body.remove(sym.node) # pragma: no cover + + if isinstance(api, SemanticAnalyzerPluginInterface): + function_type = api.named_type('builtins.function') + else: + function_type = api.named_generic_type('builtins.function', []) + + if is_classmethod: + self_type = self_type or TypeType(fill_typevars(info)) + first = [Argument(Var('_cls'), self_type, None, ARG_POS, True)] + else: + self_type = self_type or fill_typevars(info) + # `self` is positional *ONLY* here, but this can't be expressed + # fully in the mypy internal API. ARG_POS is the closest we can get. + # Using ARG_POS will, however, give mypy errors if a `self` field + # is present on a model: + # + # Name "self" already defined (possibly by an import) [no-redef] + # + # As a workaround, we give this argument a name that will + # never conflict. By its positional nature, this name will not + # be used or exposed to users. + first = [Argument(Var('__pydantic_self__'), self_type, None, ARG_POS)] + args = first + args + + arg_types, arg_names, arg_kinds = [], [], [] + for arg in args: + assert arg.type_annotation, 'All arguments must be fully typed.' + arg_types.append(arg.type_annotation) + arg_names.append(arg.variable.name) + arg_kinds.append(arg.kind) + + signature = CallableType(arg_types, arg_kinds, arg_names, return_type, function_type) + if tvar_def: + signature.variables = [tvar_def] + + func = FuncDef(name, args, Block([PassStmt()])) + func.info = info + func.type = set_callable_name(signature, func) + func.is_class = is_classmethod + func._fullname = info.fullname + '.' + name + func.line = info.line + + # NOTE: we would like the plugin generated node to dominate, but we still + # need to keep any existing definitions so they get semantically analyzed. + if name in info.names: + # Get a nice unique name instead. + r_name = get_unique_redefinition_name(name, info.names) + info.names[r_name] = info.names[name] + + # Add decorator for is_classmethod + # The dataclasses plugin claims this is unnecessary for classmethods, but not including it results in a + # signature incompatible with the superclass, which causes mypy errors to occur for every subclass of BaseModel. + if is_classmethod: + func.is_decorated = True + v = Var(name, func.type) + v.info = info + v._fullname = func._fullname + v.is_classmethod = True + dec = Decorator(func, [NameExpr('classmethod')], v) + dec.line = info.line + sym = SymbolTableNode(MDEF, dec) + else: + sym = SymbolTableNode(MDEF, func) + sym.plugin_generated = True + info.names[name] = sym + + info.defn.defs.body.append(func) + + +def parse_toml(config_file: str) -> dict[str, Any] | None: + """Returns a dict of config keys to values. + + It reads configs from toml file and returns `None` if the file is not a toml file. + """ + if not config_file.endswith('.toml'): + return None + + if sys.version_info >= (3, 11): + import tomllib as toml_ + else: + try: + import tomli as toml_ + except ImportError: # pragma: no cover + import warnings + + warnings.warn('No TOML parser installed, cannot read configuration from `pyproject.toml`.') + return None + + with open(config_file, 'rb') as rf: + return toml_.load(rf) diff --git a/env/Lib/site-packages/pydantic/networks.py b/env/Lib/site-packages/pydantic/networks.py new file mode 100644 index 0000000..830ab39 --- /dev/null +++ b/env/Lib/site-packages/pydantic/networks.py @@ -0,0 +1,761 @@ +"""The networks module contains types for common network-related fields.""" + +from __future__ import annotations as _annotations + +import dataclasses as _dataclasses +import re +from importlib.metadata import version +from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network +from typing import TYPE_CHECKING, Any + +from pydantic_core import MultiHostUrl, PydanticCustomError, Url, core_schema +from typing_extensions import Annotated, Self, TypeAlias + +from ._internal import _fields, _repr, _schema_generation_shared +from ._migration import getattr_migration +from .annotated_handlers import GetCoreSchemaHandler +from .json_schema import JsonSchemaValue + +if TYPE_CHECKING: + import email_validator + + NetworkType: TypeAlias = 'str | bytes | int | tuple[str | bytes | int, str | int]' + +else: + email_validator = None + + +__all__ = [ + 'AnyUrl', + 'AnyHttpUrl', + 'FileUrl', + 'FtpUrl', + 'HttpUrl', + 'WebsocketUrl', + 'AnyWebsocketUrl', + 'UrlConstraints', + 'EmailStr', + 'NameEmail', + 'IPvAnyAddress', + 'IPvAnyInterface', + 'IPvAnyNetwork', + 'PostgresDsn', + 'CockroachDsn', + 'AmqpDsn', + 'RedisDsn', + 'MongoDsn', + 'KafkaDsn', + 'NatsDsn', + 'validate_email', + 'MySQLDsn', + 'MariaDBDsn', + 'ClickHouseDsn', +] + + +@_dataclasses.dataclass +class UrlConstraints(_fields.PydanticMetadata): + """Url constraints. + + Attributes: + max_length: The maximum length of the url. Defaults to `None`. + allowed_schemes: The allowed schemes. Defaults to `None`. + host_required: Whether the host is required. Defaults to `None`. + default_host: The default host. Defaults to `None`. + default_port: The default port. Defaults to `None`. + default_path: The default path. Defaults to `None`. + """ + + max_length: int | None = None + allowed_schemes: list[str] | None = None + host_required: bool | None = None + default_host: str | None = None + default_port: int | None = None + default_path: str | None = None + + def __hash__(self) -> int: + return hash( + ( + self.max_length, + tuple(self.allowed_schemes) if self.allowed_schemes is not None else None, + self.host_required, + self.default_host, + self.default_port, + self.default_path, + ) + ) + + +AnyUrl = Url +"""Base type for all URLs. + +* Any scheme allowed +* Top-level domain (TLD) not required +* Host required + +Assuming an input URL of `http://samuel:pass@example.com:8000/the/path/?query=here#fragment=is;this=bit`, +the types export the following properties: + +- `scheme`: the URL scheme (`http`), always set. +- `host`: the URL host (`example.com`), always set. +- `username`: optional username if included (`samuel`). +- `password`: optional password if included (`pass`). +- `port`: optional port (`8000`). +- `path`: optional path (`/the/path/`). +- `query`: optional URL query (for example, `GET` arguments or "search string", such as `query=here`). +- `fragment`: optional fragment (`fragment=is;this=bit`). +""" +AnyHttpUrl = Annotated[Url, UrlConstraints(allowed_schemes=['http', 'https'])] +"""A type that will accept any http or https URL. + +* TLD not required +* Host required +""" +HttpUrl = Annotated[Url, UrlConstraints(max_length=2083, allowed_schemes=['http', 'https'])] +"""A type that will accept any http or https URL. + +* TLD not required +* Host required +* Max length 2083 + +```py +from pydantic import BaseModel, HttpUrl, ValidationError + +class MyModel(BaseModel): + url: HttpUrl + +m = MyModel(url='http://www.example.com') # (1)! +print(m.url) +#> http://www.example.com/ + +try: + MyModel(url='ftp://invalid.url') +except ValidationError as e: + print(e) + ''' + 1 validation error for MyModel + url + URL scheme should be 'http' or 'https' [type=url_scheme, input_value='ftp://invalid.url', input_type=str] + ''' + +try: + MyModel(url='not a url') +except ValidationError as e: + print(e) + ''' + 1 validation error for MyModel + url + Input should be a valid URL, relative URL without a base [type=url_parsing, input_value='not a url', input_type=str] + ''' +``` + +1. Note: mypy would prefer `m = MyModel(url=HttpUrl('http://www.example.com'))`, but Pydantic will convert the string to an HttpUrl instance anyway. + +"International domains" (e.g. a URL where the host or TLD includes non-ascii characters) will be encoded via +[punycode](https://en.wikipedia.org/wiki/Punycode) (see +[this article](https://www.xudongz.com/blog/2017/idn-phishing/) for a good description of why this is important): + +```py +from pydantic import BaseModel, HttpUrl + +class MyModel(BaseModel): + url: HttpUrl + +m1 = MyModel(url='http://puny£code.com') +print(m1.url) +#> http://xn--punycode-eja.com/ +m2 = MyModel(url='https://www.аррӏе.com/') +print(m2.url) +#> https://www.xn--80ak6aa92e.com/ +m3 = MyModel(url='https://www.example.珠宝/') +print(m3.url) +#> https://www.example.xn--pbt977c/ +``` + + +!!! warning "Underscores in Hostnames" + In Pydantic, underscores are allowed in all parts of a domain except the TLD. + Technically this might be wrong - in theory the hostname cannot have underscores, but subdomains can. + + To explain this; consider the following two cases: + + - `exam_ple.co.uk`: the hostname is `exam_ple`, which should not be allowed since it contains an underscore. + - `foo_bar.example.com` the hostname is `example`, which should be allowed since the underscore is in the subdomain. + + Without having an exhaustive list of TLDs, it would be impossible to differentiate between these two. Therefore + underscores are allowed, but you can always do further validation in a validator if desired. + + Also, Chrome, Firefox, and Safari all currently accept `http://exam_ple.com` as a URL, so we're in good + (or at least big) company. +""" +AnyWebsocketUrl = Annotated[Url, UrlConstraints(allowed_schemes=['ws', 'wss'])] +"""A type that will accept any ws or wss URL. + +* TLD not required +* Host required +""" +WebsocketUrl = Annotated[Url, UrlConstraints(max_length=2083, allowed_schemes=['ws', 'wss'])] +"""A type that will accept any ws or wss URL. + +* TLD not required +* Host required +* Max length 2083 +""" +FileUrl = Annotated[Url, UrlConstraints(allowed_schemes=['file'])] +"""A type that will accept any file URL. + +* Host not required +""" +FtpUrl = Annotated[Url, UrlConstraints(allowed_schemes=['ftp'])] +"""A type that will accept ftp URL. + +* TLD not required +* Host required +""" +PostgresDsn = Annotated[ + MultiHostUrl, + UrlConstraints( + host_required=True, + allowed_schemes=[ + 'postgres', + 'postgresql', + 'postgresql+asyncpg', + 'postgresql+pg8000', + 'postgresql+psycopg', + 'postgresql+psycopg2', + 'postgresql+psycopg2cffi', + 'postgresql+py-postgresql', + 'postgresql+pygresql', + ], + ), +] +"""A type that will accept any Postgres DSN. + +* User info required +* TLD not required +* Host required +* Supports multiple hosts + +If further validation is required, these properties can be used by validators to enforce specific behaviour: + +```py +from pydantic import ( + BaseModel, + HttpUrl, + PostgresDsn, + ValidationError, + field_validator, +) + +class MyModel(BaseModel): + url: HttpUrl + +m = MyModel(url='http://www.example.com') + +# the repr() method for a url will display all properties of the url +print(repr(m.url)) +#> Url('http://www.example.com/') +print(m.url.scheme) +#> http +print(m.url.host) +#> www.example.com +print(m.url.port) +#> 80 + +class MyDatabaseModel(BaseModel): + db: PostgresDsn + + @field_validator('db') + def check_db_name(cls, v): + assert v.path and len(v.path) > 1, 'database must be provided' + return v + +m = MyDatabaseModel(db='postgres://user:pass@localhost:5432/foobar') +print(m.db) +#> postgres://user:pass@localhost:5432/foobar + +try: + MyDatabaseModel(db='postgres://user:pass@localhost:5432') +except ValidationError as e: + print(e) + ''' + 1 validation error for MyDatabaseModel + db + Assertion failed, database must be provided + assert (None) + + where None = MultiHostUrl('postgres://user:pass@localhost:5432').path [type=assertion_error, input_value='postgres://user:pass@localhost:5432', input_type=str] + ''' +``` +""" + +CockroachDsn = Annotated[ + Url, + UrlConstraints( + host_required=True, + allowed_schemes=[ + 'cockroachdb', + 'cockroachdb+psycopg2', + 'cockroachdb+asyncpg', + ], + ), +] +"""A type that will accept any Cockroach DSN. + +* User info required +* TLD not required +* Host required +""" +AmqpDsn = Annotated[Url, UrlConstraints(allowed_schemes=['amqp', 'amqps'])] +"""A type that will accept any AMQP DSN. + +* User info required +* TLD not required +* Host required +""" +RedisDsn = Annotated[ + Url, + UrlConstraints(allowed_schemes=['redis', 'rediss'], default_host='localhost', default_port=6379, default_path='/0'), +] +"""A type that will accept any Redis DSN. + +* User info required +* TLD not required +* Host required (e.g., `rediss://:pass@localhost`) +""" +MongoDsn = Annotated[MultiHostUrl, UrlConstraints(allowed_schemes=['mongodb', 'mongodb+srv'], default_port=27017)] +"""A type that will accept any MongoDB DSN. + +* User info not required +* Database name not required +* Port not required +* User info may be passed without user part (e.g., `mongodb://mongodb0.example.com:27017`). +""" +KafkaDsn = Annotated[Url, UrlConstraints(allowed_schemes=['kafka'], default_host='localhost', default_port=9092)] +"""A type that will accept any Kafka DSN. + +* User info required +* TLD not required +* Host required +""" +NatsDsn = Annotated[ + MultiHostUrl, UrlConstraints(allowed_schemes=['nats', 'tls', 'ws'], default_host='localhost', default_port=4222) +] +"""A type that will accept any NATS DSN. + +NATS is a connective technology built for the ever increasingly hyper-connected world. +It is a single technology that enables applications to securely communicate across +any combination of cloud vendors, on-premise, edge, web and mobile, and devices. +More: https://nats.io +""" +MySQLDsn = Annotated[ + Url, + UrlConstraints( + allowed_schemes=[ + 'mysql', + 'mysql+mysqlconnector', + 'mysql+aiomysql', + 'mysql+asyncmy', + 'mysql+mysqldb', + 'mysql+pymysql', + 'mysql+cymysql', + 'mysql+pyodbc', + ], + default_port=3306, + ), +] +"""A type that will accept any MySQL DSN. + +* User info required +* TLD not required +* Host required +""" +MariaDBDsn = Annotated[ + Url, + UrlConstraints( + allowed_schemes=['mariadb', 'mariadb+mariadbconnector', 'mariadb+pymysql'], + default_port=3306, + ), +] +"""A type that will accept any MariaDB DSN. + +* User info required +* TLD not required +* Host required +""" +ClickHouseDsn = Annotated[ + Url, + UrlConstraints( + allowed_schemes=['clickhouse+native', 'clickhouse+asynch'], + default_host='localhost', + default_port=9000, + ), +] +"""A type that will accept any ClickHouse DSN. + +* User info required +* TLD not required +* Host required +""" + + +def import_email_validator() -> None: + global email_validator + try: + import email_validator + except ImportError as e: + raise ImportError('email-validator is not installed, run `pip install pydantic[email]`') from e + if not version('email-validator').partition('.')[0] == '2': + raise ImportError('email-validator version >= 2.0 required, run pip install -U email-validator') + + +if TYPE_CHECKING: + EmailStr = Annotated[str, ...] +else: + + class EmailStr: + """ + Info: + To use this type, you need to install the optional + [`email-validator`](https://github.com/JoshData/python-email-validator) package: + + ```bash + pip install email-validator + ``` + + Validate email addresses. + + ```py + from pydantic import BaseModel, EmailStr + + class Model(BaseModel): + email: EmailStr + + print(Model(email='contact@mail.com')) + #> email='contact@mail.com' + ``` + """ # noqa: D212 + + @classmethod + def __get_pydantic_core_schema__( + cls, + _source: type[Any], + _handler: GetCoreSchemaHandler, + ) -> core_schema.CoreSchema: + import_email_validator() + return core_schema.no_info_after_validator_function(cls._validate, core_schema.str_schema()) + + @classmethod + def __get_pydantic_json_schema__( + cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = handler(core_schema) + field_schema.update(type='string', format='email') + return field_schema + + @classmethod + def _validate(cls, input_value: str, /) -> str: + return validate_email(input_value)[1] + + +class NameEmail(_repr.Representation): + """ + Info: + To use this type, you need to install the optional + [`email-validator`](https://github.com/JoshData/python-email-validator) package: + + ```bash + pip install email-validator + ``` + + Validate a name and email address combination, as specified by + [RFC 5322](https://datatracker.ietf.org/doc/html/rfc5322#section-3.4). + + The `NameEmail` has two properties: `name` and `email`. + In case the `name` is not provided, it's inferred from the email address. + + ```py + from pydantic import BaseModel, NameEmail + + class User(BaseModel): + email: NameEmail + + user = User(email='Fred Bloggs ') + print(user.email) + #> Fred Bloggs + print(user.email.name) + #> Fred Bloggs + + user = User(email='fred.bloggs@example.com') + print(user.email) + #> fred.bloggs + print(user.email.name) + #> fred.bloggs + ``` + """ # noqa: D212 + + __slots__ = 'name', 'email' + + def __init__(self, name: str, email: str): + self.name = name + self.email = email + + def __eq__(self, other: Any) -> bool: + return isinstance(other, NameEmail) and (self.name, self.email) == (other.name, other.email) + + @classmethod + def __get_pydantic_json_schema__( + cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = handler(core_schema) + field_schema.update(type='string', format='name-email') + return field_schema + + @classmethod + def __get_pydantic_core_schema__( + cls, + _source: type[Any], + _handler: GetCoreSchemaHandler, + ) -> core_schema.CoreSchema: + import_email_validator() + + return core_schema.no_info_after_validator_function( + cls._validate, + core_schema.json_or_python_schema( + json_schema=core_schema.str_schema(), + python_schema=core_schema.union_schema( + [core_schema.is_instance_schema(cls), core_schema.str_schema()], + custom_error_type='name_email_type', + custom_error_message='Input is not a valid NameEmail', + ), + serialization=core_schema.to_string_ser_schema(), + ), + ) + + @classmethod + def _validate(cls, input_value: Self | str, /) -> Self: + if isinstance(input_value, str): + name, email = validate_email(input_value) + return cls(name, email) + else: + return input_value + + def __str__(self) -> str: + if '@' in self.name: + return f'"{self.name}" <{self.email}>' + + return f'{self.name} <{self.email}>' + + +class IPvAnyAddress: + """Validate an IPv4 or IPv6 address. + + ```py + from pydantic import BaseModel + from pydantic.networks import IPvAnyAddress + + class IpModel(BaseModel): + ip: IPvAnyAddress + + print(IpModel(ip='127.0.0.1')) + #> ip=IPv4Address('127.0.0.1') + + try: + IpModel(ip='http://www.example.com') + except ValueError as e: + print(e.errors()) + ''' + [ + { + 'type': 'ip_any_address', + 'loc': ('ip',), + 'msg': 'value is not a valid IPv4 or IPv6 address', + 'input': 'http://www.example.com', + } + ] + ''' + ``` + """ + + __slots__ = () + + def __new__(cls, value: Any) -> IPv4Address | IPv6Address: + """Validate an IPv4 or IPv6 address.""" + try: + return IPv4Address(value) + except ValueError: + pass + + try: + return IPv6Address(value) + except ValueError: + raise PydanticCustomError('ip_any_address', 'value is not a valid IPv4 or IPv6 address') + + @classmethod + def __get_pydantic_json_schema__( + cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = {} + field_schema.update(type='string', format='ipvanyaddress') + return field_schema + + @classmethod + def __get_pydantic_core_schema__( + cls, + _source: type[Any], + _handler: GetCoreSchemaHandler, + ) -> core_schema.CoreSchema: + return core_schema.no_info_plain_validator_function( + cls._validate, serialization=core_schema.to_string_ser_schema() + ) + + @classmethod + def _validate(cls, input_value: Any, /) -> IPv4Address | IPv6Address: + return cls(input_value) # type: ignore[return-value] + + +class IPvAnyInterface: + """Validate an IPv4 or IPv6 interface.""" + + __slots__ = () + + def __new__(cls, value: NetworkType) -> IPv4Interface | IPv6Interface: + """Validate an IPv4 or IPv6 interface.""" + try: + return IPv4Interface(value) + except ValueError: + pass + + try: + return IPv6Interface(value) + except ValueError: + raise PydanticCustomError('ip_any_interface', 'value is not a valid IPv4 or IPv6 interface') + + @classmethod + def __get_pydantic_json_schema__( + cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = {} + field_schema.update(type='string', format='ipvanyinterface') + return field_schema + + @classmethod + def __get_pydantic_core_schema__( + cls, + _source: type[Any], + _handler: GetCoreSchemaHandler, + ) -> core_schema.CoreSchema: + return core_schema.no_info_plain_validator_function( + cls._validate, serialization=core_schema.to_string_ser_schema() + ) + + @classmethod + def _validate(cls, input_value: NetworkType, /) -> IPv4Interface | IPv6Interface: + return cls(input_value) # type: ignore[return-value] + + +IPvAnyNetworkType: TypeAlias = 'IPv4Network | IPv6Network' + +if TYPE_CHECKING: + IPvAnyNetwork = IPvAnyNetworkType +else: + + class IPvAnyNetwork: + """Validate an IPv4 or IPv6 network.""" + + __slots__ = () + + def __new__(cls, value: NetworkType) -> IPvAnyNetworkType: + """Validate an IPv4 or IPv6 network.""" + # Assume IP Network is defined with a default value for `strict` argument. + # Define your own class if you want to specify network address check strictness. + try: + return IPv4Network(value) + except ValueError: + pass + + try: + return IPv6Network(value) + except ValueError: + raise PydanticCustomError('ip_any_network', 'value is not a valid IPv4 or IPv6 network') + + @classmethod + def __get_pydantic_json_schema__( + cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = {} + field_schema.update(type='string', format='ipvanynetwork') + return field_schema + + @classmethod + def __get_pydantic_core_schema__( + cls, + _source: type[Any], + _handler: GetCoreSchemaHandler, + ) -> core_schema.CoreSchema: + return core_schema.no_info_plain_validator_function( + cls._validate, serialization=core_schema.to_string_ser_schema() + ) + + @classmethod + def _validate(cls, input_value: NetworkType, /) -> IPvAnyNetworkType: + return cls(input_value) # type: ignore[return-value] + + +def _build_pretty_email_regex() -> re.Pattern[str]: + name_chars = r'[\w!#$%&\'*+\-/=?^_`{|}~]' + unquoted_name_group = rf'((?:{name_chars}+\s+)*{name_chars}+)' + quoted_name_group = r'"((?:[^"]|\")+)"' + email_group = r'<\s*(.+)\s*>' + return re.compile(rf'\s*(?:{unquoted_name_group}|{quoted_name_group})?\s*{email_group}\s*') + + +pretty_email_regex = _build_pretty_email_regex() + +MAX_EMAIL_LENGTH = 2048 +"""Maximum length for an email. +A somewhat arbitrary but very generous number compared to what is allowed by most implementations. +""" + + +def validate_email(value: str) -> tuple[str, str]: + """Email address validation using [email-validator](https://pypi.org/project/email-validator/). + + Note: + Note that: + + * Raw IP address (literal) domain parts are not allowed. + * `"John Doe "` style "pretty" email addresses are processed. + * Spaces are striped from the beginning and end of addresses, but no error is raised. + """ + if email_validator is None: + import_email_validator() + + if len(value) > MAX_EMAIL_LENGTH: + raise PydanticCustomError( + 'value_error', + 'value is not a valid email address: {reason}', + {'reason': f'Length must not exceed {MAX_EMAIL_LENGTH} characters'}, + ) + + m = pretty_email_regex.fullmatch(value) + name: str | None = None + if m: + unquoted_name, quoted_name, value = m.groups() + name = unquoted_name or quoted_name + + email = value.strip() + + try: + parts = email_validator.validate_email(email, check_deliverability=False) + except email_validator.EmailNotValidError as e: + raise PydanticCustomError( + 'value_error', 'value is not a valid email address: {reason}', {'reason': str(e.args[0])} + ) from e + + email = parts.normalized + assert email is not None + name = name or parts.local_part + return name, email + + +__getattr__ = getattr_migration(__name__) diff --git a/env/Lib/site-packages/pydantic/parse.py b/env/Lib/site-packages/pydantic/parse.py new file mode 100644 index 0000000..68b7f04 --- /dev/null +++ b/env/Lib/site-packages/pydantic/parse.py @@ -0,0 +1,5 @@ +"""The `parse` module is a backport module from V1.""" + +from ._migration import getattr_migration + +__getattr__ = getattr_migration(__name__) diff --git a/env/Lib/site-packages/pydantic/plugin/__init__.py b/env/Lib/site-packages/pydantic/plugin/__init__.py new file mode 100644 index 0000000..549c095 --- /dev/null +++ b/env/Lib/site-packages/pydantic/plugin/__init__.py @@ -0,0 +1,171 @@ +"""Usage docs: https://docs.pydantic.dev/2.8/concepts/plugins#build-a-plugin + +Plugin interface for Pydantic plugins, and related types. +""" + +from __future__ import annotations + +from typing import Any, Callable, NamedTuple + +from pydantic_core import CoreConfig, CoreSchema, ValidationError +from typing_extensions import Literal, Protocol, TypeAlias + +__all__ = ( + 'PydanticPluginProtocol', + 'BaseValidateHandlerProtocol', + 'ValidatePythonHandlerProtocol', + 'ValidateJsonHandlerProtocol', + 'ValidateStringsHandlerProtocol', + 'NewSchemaReturns', + 'SchemaTypePath', + 'SchemaKind', +) + +NewSchemaReturns: TypeAlias = 'tuple[ValidatePythonHandlerProtocol | None, ValidateJsonHandlerProtocol | None, ValidateStringsHandlerProtocol | None]' + + +class SchemaTypePath(NamedTuple): + """Path defining where `schema_type` was defined, or where `TypeAdapter` was called.""" + + module: str + name: str + + +SchemaKind: TypeAlias = Literal['BaseModel', 'TypeAdapter', 'dataclass', 'create_model', 'validate_call'] + + +class PydanticPluginProtocol(Protocol): + """Protocol defining the interface for Pydantic plugins.""" + + def new_schema_validator( + self, + schema: CoreSchema, + schema_type: Any, + schema_type_path: SchemaTypePath, + schema_kind: SchemaKind, + config: CoreConfig | None, + plugin_settings: dict[str, object], + ) -> tuple[ + ValidatePythonHandlerProtocol | None, ValidateJsonHandlerProtocol | None, ValidateStringsHandlerProtocol | None + ]: + """This method is called for each plugin every time a new [`SchemaValidator`][pydantic_core.SchemaValidator] + is created. + + It should return an event handler for each of the three validation methods, or `None` if the plugin does not + implement that method. + + Args: + schema: The schema to validate against. + schema_type: The original type which the schema was created from, e.g. the model class. + schema_type_path: Path defining where `schema_type` was defined, or where `TypeAdapter` was called. + schema_kind: The kind of schema to validate against. + config: The config to use for validation. + plugin_settings: Any plugin settings. + + Returns: + A tuple of optional event handlers for each of the three validation methods - + `validate_python`, `validate_json`, `validate_strings`. + """ + raise NotImplementedError('Pydantic plugins should implement `new_schema_validator`.') + + +class BaseValidateHandlerProtocol(Protocol): + """Base class for plugin callbacks protocols. + + You shouldn't implement this protocol directly, instead use one of the subclasses with adds the correctly + typed `on_error` method. + """ + + on_enter: Callable[..., None] + """`on_enter` is changed to be more specific on all subclasses""" + + def on_success(self, result: Any) -> None: + """Callback to be notified of successful validation. + + Args: + result: The result of the validation. + """ + return + + def on_error(self, error: ValidationError) -> None: + """Callback to be notified of validation errors. + + Args: + error: The validation error. + """ + return + + def on_exception(self, exception: Exception) -> None: + """Callback to be notified of validation exceptions. + + Args: + exception: The exception raised during validation. + """ + return + + +class ValidatePythonHandlerProtocol(BaseValidateHandlerProtocol, Protocol): + """Event handler for `SchemaValidator.validate_python`.""" + + def on_enter( + self, + input: Any, + *, + strict: bool | None = None, + from_attributes: bool | None = None, + context: dict[str, Any] | None = None, + self_instance: Any | None = None, + ) -> None: + """Callback to be notified of validation start, and create an instance of the event handler. + + Args: + input: The input to be validated. + strict: Whether to validate the object in strict mode. + from_attributes: Whether to validate objects as inputs by extracting attributes. + context: The context to use for validation, this is passed to functional validators. + self_instance: An instance of a model to set attributes on from validation, this is used when running + validation from the `__init__` method of a model. + """ + pass + + +class ValidateJsonHandlerProtocol(BaseValidateHandlerProtocol, Protocol): + """Event handler for `SchemaValidator.validate_json`.""" + + def on_enter( + self, + input: str | bytes | bytearray, + *, + strict: bool | None = None, + context: dict[str, Any] | None = None, + self_instance: Any | None = None, + ) -> None: + """Callback to be notified of validation start, and create an instance of the event handler. + + Args: + input: The JSON data to be validated. + strict: Whether to validate the object in strict mode. + context: The context to use for validation, this is passed to functional validators. + self_instance: An instance of a model to set attributes on from validation, this is used when running + validation from the `__init__` method of a model. + """ + pass + + +StringInput: TypeAlias = 'dict[str, StringInput]' + + +class ValidateStringsHandlerProtocol(BaseValidateHandlerProtocol, Protocol): + """Event handler for `SchemaValidator.validate_strings`.""" + + def on_enter( + self, input: StringInput, *, strict: bool | None = None, context: dict[str, Any] | None = None + ) -> None: + """Callback to be notified of validation start, and create an instance of the event handler. + + Args: + input: The string data to be validated. + strict: Whether to validate the object in strict mode. + context: The context to use for validation, this is passed to functional validators. + """ + pass diff --git a/env/Lib/site-packages/pydantic/plugin/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/pydantic/plugin/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..feeb343db3f3c783760c6502a6ba9dae35276516 GIT binary patch literal 8302 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/plugin/__pycache__/_loader.cpython-311.pyc b/env/Lib/site-packages/pydantic/plugin/__pycache__/_loader.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7b32d6bdd8827c122754e839d515901a320537ae GIT binary patch literal 2500 zcmaJDTWlLeaPQ%FoJZ4Q*G-yhL)8Y-xFM-2Au0+<+*q|jL{p&{SI60RaW6gJS$pe- z1P29#5JHjQ0|`(;>JK0UNc`~lraycjajuN8PO4N1@xh-_L8|)2?Ad2Kg0h~Qo0;34 zo!NP;KMRM02*x)zep=7^5&DfX?%dfE{*1pE$OMYPOprl}AA4n9_GqDEPo@Xfcr#(yr}WDHStByYWafg zNvgV}+5Qw!u$0r3KbYpSM^?6ENhfN4MJpFneFYoD$Qv-R)RJ!pos}<|1YfaZD{BjL z%d4q*adCO|`89FnxzzHic;WfyF0X8#lGQw+)5eAW)_Fy!2+M}9*nY9(Y-T2HK4-vY z{i0?_vZ@!{54IO8q>S|kf@|-K57C*Y?z@AA4uZton`LQ$2=%cwHrlkzdCEa-`>pTZx7!|?gnRNRBC*a&GSs2h*+&sRyTg%@j%=gtWrf=qaOE2ZTk z?%4g_?>CfHaQpQ%q@>VFRAJq~?W~>%1_c-?-7KkCk%ipWjBu5Zk~tHP7gTb!oSVoS z#dv9pC?+{AE7#*xOJOUX(~Mkva$;)YOx(nIS1J}IT`DMeqO>)do_aEIIz4^n31H}tc`=GFSRn-)sRZ;@E zst7M_KlxJI{+3hY@I^ISjIgO{ng9(%$SH!Vn*=l~GI*LCJ7}|pX?qI_QS|FL49A9P zuGt6FV#&ZnQ*&ZbA(AW+$qvgZGypYMcG{5Lqv!;0i6ukTiD`QZ*eI7UOm z&FfN8u{~xQq zEO?(ytGTSH66JJB%3p(^nOV0@I?+`1xYNm;VA>%#GIwKq8n!qDkNF`qo?Y~J5Jh9} zZCS^ju102Sky(pB_`5ICKrzpWyL|(1;dIB7+uz7N&TEm`U8uj$Q)t-bHt!!bjoyi15)XwUMa? zVumj=P5k4LT57FZP+v?oxX$-KIqq=mF9fLZzvw=U1_#^G_aJqhqbDLD;e^#Q1aSX@ zvO_#-^|avk(BM1Iy!}iyG*k->S^SWhfDnB>H#~nH{m^^t*)#kPafZ@o2IdpKTg>D0 zlfGNy9+2Fc^iWBHr}TM#f#t?n+zX3wAE2=Vc2E@8%W#E3LSov~yUJyvT`qo?!iVY7 z2t}iGvX^X?ApbB;Oib?$lKTO{k)$KolFXP``zaHld1+HoT+Ea05LA;c4*c EAFybhZ2$lO literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/plugin/__pycache__/_schema_validator.cpython-311.pyc b/env/Lib/site-packages/pydantic/plugin/__pycache__/_schema_validator.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2660e3559de5f5e2c16299145ca5499776c4b578 GIT binary patch literal 7605 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 Iterable[PydanticPluginProtocol]: + """Load plugins for Pydantic. + + Inspired by: https://github.com/pytest-dev/pluggy/blob/1.3.0/src/pluggy/_manager.py#L376-L402 + """ + disabled_plugins = os.getenv('PYDANTIC_DISABLE_PLUGINS') + global _plugins, _loading_plugins + if _loading_plugins: + # this happens when plugins themselves use pydantic, we return no plugins + return () + elif disabled_plugins in ('__all__', '1', 'true'): + return () + elif _plugins is None: + _plugins = {} + # set _loading_plugins so any plugins that use pydantic don't themselves use plugins + _loading_plugins = True + try: + for dist in importlib_metadata.distributions(): + for entry_point in dist.entry_points: + if entry_point.group != PYDANTIC_ENTRY_POINT_GROUP: + continue + if entry_point.value in _plugins: + continue + if disabled_plugins is not None and entry_point.name in disabled_plugins.split(','): + continue + try: + _plugins[entry_point.value] = entry_point.load() + except (ImportError, AttributeError) as e: + warnings.warn( + f'{e.__class__.__name__} while loading the `{entry_point.name}` Pydantic plugin, ' + f'this plugin will not be installed.\n\n{e!r}' + ) + finally: + _loading_plugins = False + + return _plugins.values() diff --git a/env/Lib/site-packages/pydantic/plugin/_schema_validator.py b/env/Lib/site-packages/pydantic/plugin/_schema_validator.py new file mode 100644 index 0000000..21287f4 --- /dev/null +++ b/env/Lib/site-packages/pydantic/plugin/_schema_validator.py @@ -0,0 +1,139 @@ +"""Pluggable schema validator for pydantic.""" + +from __future__ import annotations + +import functools +from typing import TYPE_CHECKING, Any, Callable, Iterable, TypeVar + +from pydantic_core import CoreConfig, CoreSchema, SchemaValidator, ValidationError +from typing_extensions import Literal, ParamSpec + +if TYPE_CHECKING: + from . import BaseValidateHandlerProtocol, PydanticPluginProtocol, SchemaKind, SchemaTypePath + + +P = ParamSpec('P') +R = TypeVar('R') +Event = Literal['on_validate_python', 'on_validate_json', 'on_validate_strings'] +events: list[Event] = list(Event.__args__) # type: ignore + + +def create_schema_validator( + schema: CoreSchema, + schema_type: Any, + schema_type_module: str, + schema_type_name: str, + schema_kind: SchemaKind, + config: CoreConfig | None = None, + plugin_settings: dict[str, Any] | None = None, +) -> SchemaValidator | PluggableSchemaValidator: + """Create a `SchemaValidator` or `PluggableSchemaValidator` if plugins are installed. + + Returns: + If plugins are installed then return `PluggableSchemaValidator`, otherwise return `SchemaValidator`. + """ + from . import SchemaTypePath + from ._loader import get_plugins + + plugins = get_plugins() + if plugins: + return PluggableSchemaValidator( + schema, + schema_type, + SchemaTypePath(schema_type_module, schema_type_name), + schema_kind, + config, + plugins, + plugin_settings or {}, + ) + else: + return SchemaValidator(schema, config) + + +class PluggableSchemaValidator: + """Pluggable schema validator.""" + + __slots__ = '_schema_validator', 'validate_json', 'validate_python', 'validate_strings' + + def __init__( + self, + schema: CoreSchema, + schema_type: Any, + schema_type_path: SchemaTypePath, + schema_kind: SchemaKind, + config: CoreConfig | None, + plugins: Iterable[PydanticPluginProtocol], + plugin_settings: dict[str, Any], + ) -> None: + self._schema_validator = SchemaValidator(schema, config) + + python_event_handlers: list[BaseValidateHandlerProtocol] = [] + json_event_handlers: list[BaseValidateHandlerProtocol] = [] + strings_event_handlers: list[BaseValidateHandlerProtocol] = [] + for plugin in plugins: + try: + p, j, s = plugin.new_schema_validator( + schema, schema_type, schema_type_path, schema_kind, config, plugin_settings + ) + except TypeError as e: # pragma: no cover + raise TypeError(f'Error using plugin `{plugin.__module__}:{plugin.__class__.__name__}`: {e}') from e + if p is not None: + python_event_handlers.append(p) + if j is not None: + json_event_handlers.append(j) + if s is not None: + strings_event_handlers.append(s) + + self.validate_python = build_wrapper(self._schema_validator.validate_python, python_event_handlers) + self.validate_json = build_wrapper(self._schema_validator.validate_json, json_event_handlers) + self.validate_strings = build_wrapper(self._schema_validator.validate_strings, strings_event_handlers) + + def __getattr__(self, name: str) -> Any: + return getattr(self._schema_validator, name) + + +def build_wrapper(func: Callable[P, R], event_handlers: list[BaseValidateHandlerProtocol]) -> Callable[P, R]: + if not event_handlers: + return func + else: + on_enters = tuple(h.on_enter for h in event_handlers if filter_handlers(h, 'on_enter')) + on_successes = tuple(h.on_success for h in event_handlers if filter_handlers(h, 'on_success')) + on_errors = tuple(h.on_error for h in event_handlers if filter_handlers(h, 'on_error')) + on_exceptions = tuple(h.on_exception for h in event_handlers if filter_handlers(h, 'on_exception')) + + @functools.wraps(func) + def wrapper(*args: P.args, **kwargs: P.kwargs) -> R: + for on_enter_handler in on_enters: + on_enter_handler(*args, **kwargs) + + try: + result = func(*args, **kwargs) + except ValidationError as error: + for on_error_handler in on_errors: + on_error_handler(error) + raise + except Exception as exception: + for on_exception_handler in on_exceptions: + on_exception_handler(exception) + raise + else: + for on_success_handler in on_successes: + on_success_handler(result) + return result + + return wrapper + + +def filter_handlers(handler_cls: BaseValidateHandlerProtocol, method_name: str) -> bool: + """Filter out handler methods which are not implemented by the plugin directly - e.g. are missing + or are inherited from the protocol. + """ + handler = getattr(handler_cls, method_name, None) + if handler is None: + return False + elif handler.__module__ == 'pydantic.plugin': + # this is the original handler, from the protocol due to runtime inheritance + # we don't want to call it + return False + else: + return True diff --git a/env/Lib/site-packages/pydantic/py.typed b/env/Lib/site-packages/pydantic/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/pydantic/root_model.py b/env/Lib/site-packages/pydantic/root_model.py new file mode 100644 index 0000000..b073631 --- /dev/null +++ b/env/Lib/site-packages/pydantic/root_model.py @@ -0,0 +1,154 @@ +"""RootModel class and type definitions.""" + +from __future__ import annotations as _annotations + +import typing +from copy import copy, deepcopy + +from pydantic_core import PydanticUndefined + +from . import PydanticUserError +from ._internal import _model_construction, _repr +from .main import BaseModel, _object_setattr + +if typing.TYPE_CHECKING: + from typing import Any + + from typing_extensions import Literal, Self, dataclass_transform + + from .fields import Field as PydanticModelField + from .fields import PrivateAttr as PydanticModelPrivateAttr + + # dataclass_transform could be applied to RootModel directly, but `ModelMetaclass`'s dataclass_transform + # takes priority (at least with pyright). We trick type checkers into thinking we apply dataclass_transform + # on a new metaclass. + @dataclass_transform(kw_only_default=False, field_specifiers=(PydanticModelField, PydanticModelPrivateAttr)) + class _RootModelMetaclass(_model_construction.ModelMetaclass): ... +else: + _RootModelMetaclass = _model_construction.ModelMetaclass + +__all__ = ('RootModel',) + +RootModelRootType = typing.TypeVar('RootModelRootType') + + +class RootModel(BaseModel, typing.Generic[RootModelRootType], metaclass=_RootModelMetaclass): + """Usage docs: https://docs.pydantic.dev/2.8/concepts/models/#rootmodel-and-custom-root-types + + A Pydantic `BaseModel` for the root object of the model. + + Attributes: + root: The root object of the model. + __pydantic_root_model__: Whether the model is a RootModel. + __pydantic_private__: Private fields in the model. + __pydantic_extra__: Extra fields in the model. + + """ + + __pydantic_root_model__ = True + __pydantic_private__ = None + __pydantic_extra__ = None + + root: RootModelRootType + + def __init_subclass__(cls, **kwargs): + extra = cls.model_config.get('extra') + if extra is not None: + raise PydanticUserError( + "`RootModel` does not support setting `model_config['extra']`", code='root-model-extra' + ) + super().__init_subclass__(**kwargs) + + def __init__(self, /, root: RootModelRootType = PydanticUndefined, **data) -> None: # type: ignore + __tracebackhide__ = True + if data: + if root is not PydanticUndefined: + raise ValueError( + '"RootModel.__init__" accepts either a single positional argument or arbitrary keyword arguments' + ) + root = data # type: ignore + self.__pydantic_validator__.validate_python(root, self_instance=self) + + __init__.__pydantic_base_init__ = True # pyright: ignore[reportFunctionMemberAccess] + + @classmethod + def model_construct(cls, root: RootModelRootType, _fields_set: set[str] | None = None) -> Self: # type: ignore + """Create a new model using the provided root object and update fields set. + + Args: + root: The root object of the model. + _fields_set: The set of fields to be updated. + + Returns: + The new model. + + Raises: + NotImplemented: If the model is not a subclass of `RootModel`. + """ + return super().model_construct(root=root, _fields_set=_fields_set) + + def __getstate__(self) -> dict[Any, Any]: + return { + '__dict__': self.__dict__, + '__pydantic_fields_set__': self.__pydantic_fields_set__, + } + + def __setstate__(self, state: dict[Any, Any]) -> None: + _object_setattr(self, '__pydantic_fields_set__', state['__pydantic_fields_set__']) + _object_setattr(self, '__dict__', state['__dict__']) + + def __copy__(self) -> Self: + """Returns a shallow copy of the model.""" + cls = type(self) + m = cls.__new__(cls) + _object_setattr(m, '__dict__', copy(self.__dict__)) + _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__)) + return m + + def __deepcopy__(self, memo: dict[int, Any] | None = None) -> Self: + """Returns a deep copy of the model.""" + cls = type(self) + m = cls.__new__(cls) + _object_setattr(m, '__dict__', deepcopy(self.__dict__, memo=memo)) + # This next line doesn't need a deepcopy because __pydantic_fields_set__ is a set[str], + # and attempting a deepcopy would be marginally slower. + _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__)) + return m + + if typing.TYPE_CHECKING: + + def model_dump( # type: ignore + self, + *, + mode: Literal['json', 'python'] | str = 'python', + include: Any = None, + exclude: Any = None, + context: dict[str, Any] | None = None, + by_alias: bool = False, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + round_trip: bool = False, + warnings: bool | Literal['none', 'warn', 'error'] = True, + serialize_as_any: bool = False, + ) -> Any: + """This method is included just to get a more accurate return type for type checkers. + It is included in this `if TYPE_CHECKING:` block since no override is actually necessary. + + See the documentation of `BaseModel.model_dump` for more details about the arguments. + + Generally, this method will have a return type of `RootModelRootType`, assuming that `RootModelRootType` is + not a `BaseModel` subclass. If `RootModelRootType` is a `BaseModel` subclass, then the return + type will likely be `dict[str, Any]`, as `model_dump` calls are recursive. The return type could + even be something different, in the case of a custom serializer. + Thus, `Any` is used here to catch all of these cases. + """ + ... + + def __eq__(self, other: Any) -> bool: + if not isinstance(other, RootModel): + return NotImplemented + return self.model_fields['root'].annotation == other.model_fields['root'].annotation and super().__eq__(other) + + def __repr_args__(self) -> _repr.ReprArgs: + yield 'root', self.root diff --git a/env/Lib/site-packages/pydantic/schema.py b/env/Lib/site-packages/pydantic/schema.py new file mode 100644 index 0000000..a3245a6 --- /dev/null +++ b/env/Lib/site-packages/pydantic/schema.py @@ -0,0 +1,5 @@ +"""The `schema` module is a backport module from V1.""" + +from ._migration import getattr_migration + +__getattr__ = getattr_migration(__name__) diff --git a/env/Lib/site-packages/pydantic/tools.py b/env/Lib/site-packages/pydantic/tools.py new file mode 100644 index 0000000..fdc68c4 --- /dev/null +++ b/env/Lib/site-packages/pydantic/tools.py @@ -0,0 +1,5 @@ +"""The `tools` module is a backport module from V1.""" + +from ._migration import getattr_migration + +__getattr__ = getattr_migration(__name__) diff --git a/env/Lib/site-packages/pydantic/type_adapter.py b/env/Lib/site-packages/pydantic/type_adapter.py new file mode 100644 index 0000000..d6001df --- /dev/null +++ b/env/Lib/site-packages/pydantic/type_adapter.py @@ -0,0 +1,601 @@ +"""Type adapter specification.""" + +from __future__ import annotations as _annotations + +import sys +from contextlib import contextmanager +from dataclasses import is_dataclass +from functools import cached_property, wraps +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Dict, + Generic, + Iterable, + Iterator, + Literal, + Set, + TypeVar, + Union, + cast, + final, + overload, +) + +from pydantic_core import CoreSchema, SchemaSerializer, SchemaValidator, Some +from typing_extensions import Concatenate, ParamSpec, is_typeddict + +from pydantic.errors import PydanticUserError +from pydantic.main import BaseModel + +from ._internal import _config, _generate_schema, _mock_val_ser, _typing_extra, _utils +from .config import ConfigDict +from .json_schema import ( + DEFAULT_REF_TEMPLATE, + GenerateJsonSchema, + JsonSchemaKeyT, + JsonSchemaMode, + JsonSchemaValue, +) +from .plugin._schema_validator import PluggableSchemaValidator, create_schema_validator + +T = TypeVar('T') +R = TypeVar('R') +P = ParamSpec('P') +TypeAdapterT = TypeVar('TypeAdapterT', bound='TypeAdapter') + + +if TYPE_CHECKING: + # should be `set[int] | set[str] | dict[int, IncEx] | dict[str, IncEx] | None`, but mypy can't cope + IncEx = Union[Set[int], Set[str], Dict[int, Any], Dict[str, Any]] + + +def _get_schema(type_: Any, config_wrapper: _config.ConfigWrapper, parent_depth: int) -> CoreSchema: + """`BaseModel` uses its own `__module__` to find out where it was defined + and then looks for symbols to resolve forward references in those globals. + On the other hand this function can be called with arbitrary objects, + including type aliases, where `__module__` (always `typing.py`) is not useful. + So instead we look at the globals in our parent stack frame. + + This works for the case where this function is called in a module that + has the target of forward references in its scope, but + does not always work for more complex cases. + + For example, take the following: + + a.py + ```python + from typing import Dict, List + + IntList = List[int] + OuterDict = Dict[str, 'IntList'] + ``` + + b.py + ```python test="skip" + from a import OuterDict + + from pydantic import TypeAdapter + + IntList = int # replaces the symbol the forward reference is looking for + v = TypeAdapter(OuterDict) + v({'x': 1}) # should fail but doesn't + ``` + + If `OuterDict` were a `BaseModel`, this would work because it would resolve + the forward reference within the `a.py` namespace. + But `TypeAdapter(OuterDict)` can't determine what module `OuterDict` came from. + + In other words, the assumption that _all_ forward references exist in the + module we are being called from is not technically always true. + Although most of the time it is and it works fine for recursive models and such, + `BaseModel`'s behavior isn't perfect either and _can_ break in similar ways, + so there is no right or wrong between the two. + + But at the very least this behavior is _subtly_ different from `BaseModel`'s. + """ + local_ns = _typing_extra.parent_frame_namespace(parent_depth=parent_depth) + global_ns = sys._getframe(max(parent_depth - 1, 1)).f_globals.copy() + global_ns.update(local_ns or {}) + gen = _generate_schema.GenerateSchema(config_wrapper, types_namespace=global_ns, typevars_map={}) + schema = gen.generate_schema(type_) + schema = gen.clean_schema(schema) + return schema + + +def _getattr_no_parents(obj: Any, attribute: str) -> Any: + """Returns the attribute value without attempting to look up attributes from parent types.""" + if hasattr(obj, '__dict__'): + try: + return obj.__dict__[attribute] + except KeyError: + pass + + slots = getattr(obj, '__slots__', None) + if slots is not None and attribute in slots: + return getattr(obj, attribute) + else: + raise AttributeError(attribute) + + +def _type_has_config(type_: Any) -> bool: + """Returns whether the type has config.""" + type_ = _typing_extra.annotated_type(type_) or type_ + try: + return issubclass(type_, BaseModel) or is_dataclass(type_) or is_typeddict(type_) + except TypeError: + # type is not a class + return False + + +# This is keeping track of the frame depth for the TypeAdapter functions. This is required for _parent_depth used for +# ForwardRef resolution. We may enter the TypeAdapter schema building via different TypeAdapter functions. Hence, we +# need to keep track of the frame depth relative to the originally provided _parent_depth. +def _frame_depth( + depth: int, +) -> Callable[[Callable[Concatenate[TypeAdapterT, P], R]], Callable[Concatenate[TypeAdapterT, P], R]]: + def wrapper(func: Callable[Concatenate[TypeAdapterT, P], R]) -> Callable[Concatenate[TypeAdapterT, P], R]: + @wraps(func) + def wrapped(self: TypeAdapterT, *args: P.args, **kwargs: P.kwargs) -> R: + with self._with_frame_depth(depth + 1): # depth + 1 for the wrapper function + return func(self, *args, **kwargs) + + return wrapped + + return wrapper + + +@final +class TypeAdapter(Generic[T]): + """Usage docs: https://docs.pydantic.dev/2.8/concepts/type_adapter/ + + Type adapters provide a flexible way to perform validation and serialization based on a Python type. + + A `TypeAdapter` instance exposes some of the functionality from `BaseModel` instance methods + for types that do not have such methods (such as dataclasses, primitive types, and more). + + **Note:** `TypeAdapter` instances are not types, and cannot be used as type annotations for fields. + + **Note:** By default, `TypeAdapter` does not respect the + [`defer_build=True`][pydantic.config.ConfigDict.defer_build] setting in the + [`model_config`][pydantic.BaseModel.model_config] or in the `TypeAdapter` constructor `config`. You need to also + explicitly set [`experimental_defer_build_mode=('model', 'type_adapter')`][pydantic.config.ConfigDict.experimental_defer_build_mode] of the + config to defer the model validator and serializer construction. Thus, this feature is opt-in to ensure backwards + compatibility. + + Attributes: + core_schema: The core schema for the type. + validator (SchemaValidator): The schema validator for the type. + serializer: The schema serializer for the type. + """ + + @overload + def __init__( + self, + type: type[T], + *, + config: ConfigDict | None = ..., + _parent_depth: int = ..., + module: str | None = ..., + ) -> None: ... + + # This second overload is for unsupported special forms (such as Annotated, Union, etc.) + # Currently there is no way to type this correctly + # See https://github.com/python/typing/pull/1618 + @overload + def __init__( + self, + type: Any, + *, + config: ConfigDict | None = ..., + _parent_depth: int = ..., + module: str | None = ..., + ) -> None: ... + + def __init__( + self, + type: Any, + *, + config: ConfigDict | None = None, + _parent_depth: int = 2, + module: str | None = None, + ) -> None: + """Initializes the TypeAdapter object. + + Args: + type: The type associated with the `TypeAdapter`. + config: Configuration for the `TypeAdapter`, should be a dictionary conforming to [`ConfigDict`][pydantic.config.ConfigDict]. + _parent_depth: depth at which to search the parent namespace to construct the local namespace. + module: The module that passes to plugin if provided. + + !!! note + You cannot use the `config` argument when instantiating a `TypeAdapter` if the type you're using has its own + config that cannot be overridden (ex: `BaseModel`, `TypedDict`, and `dataclass`). A + [`type-adapter-config-unused`](../errors/usage_errors.md#type-adapter-config-unused) error will be raised in this case. + + !!! note + The `_parent_depth` argument is named with an underscore to suggest its private nature and discourage use. + It may be deprecated in a minor version, so we only recommend using it if you're + comfortable with potential change in behavior / support. + + ??? tip "Compatibility with `mypy`" + Depending on the type used, `mypy` might raise an error when instantiating a `TypeAdapter`. As a workaround, you can explicitly + annotate your variable: + + ```py + from typing import Union + + from pydantic import TypeAdapter + + ta: TypeAdapter[Union[str, int]] = TypeAdapter(Union[str, int]) # type: ignore[arg-type] + ``` + + Returns: + A type adapter configured for the specified `type`. + """ + if _type_has_config(type) and config is not None: + raise PydanticUserError( + 'Cannot use `config` when the type is a BaseModel, dataclass or TypedDict.' + ' These types can have their own config and setting the config via the `config`' + ' parameter to TypeAdapter will not override it, thus the `config` you passed to' + ' TypeAdapter becomes meaningless, which is probably not what you want.', + code='type-adapter-config-unused', + ) + + self._type = type + self._config = config + self._parent_depth = _parent_depth + if module is None: + f = sys._getframe(1) + self._module_name = cast(str, f.f_globals.get('__name__', '')) + else: + self._module_name = module + + self._core_schema: CoreSchema | None = None + self._validator: SchemaValidator | PluggableSchemaValidator | None = None + self._serializer: SchemaSerializer | None = None + + if not self._defer_build(): + # Immediately initialize the core schema, validator and serializer + with self._with_frame_depth(1): # +1 frame depth for this __init__ + # Model itself may be using deferred building. For backward compatibility we don't rebuild model mocks + # here as part of __init__ even though TypeAdapter itself is not using deferred building. + self._init_core_attrs(rebuild_mocks=False) + + @contextmanager + def _with_frame_depth(self, depth: int) -> Iterator[None]: + self._parent_depth += depth + try: + yield + finally: + self._parent_depth -= depth + + @_frame_depth(1) + def _init_core_attrs(self, rebuild_mocks: bool) -> None: + try: + self._core_schema = _getattr_no_parents(self._type, '__pydantic_core_schema__') + self._validator = _getattr_no_parents(self._type, '__pydantic_validator__') + self._serializer = _getattr_no_parents(self._type, '__pydantic_serializer__') + except AttributeError: + config_wrapper = _config.ConfigWrapper(self._config) + core_config = config_wrapper.core_config(None) + + self._core_schema = _get_schema(self._type, config_wrapper, parent_depth=self._parent_depth) + self._validator = create_schema_validator( + schema=self._core_schema, + schema_type=self._type, + schema_type_module=self._module_name, + schema_type_name=str(self._type), + schema_kind='TypeAdapter', + config=core_config, + plugin_settings=config_wrapper.plugin_settings, + ) + self._serializer = SchemaSerializer(self._core_schema, core_config) + + if rebuild_mocks and isinstance(self._core_schema, _mock_val_ser.MockCoreSchema): + self._core_schema.rebuild() + self._init_core_attrs(rebuild_mocks=False) + assert not isinstance(self._core_schema, _mock_val_ser.MockCoreSchema) + assert not isinstance(self._validator, _mock_val_ser.MockValSer) + assert not isinstance(self._serializer, _mock_val_ser.MockValSer) + + @cached_property + @_frame_depth(2) # +2 for @cached_property and core_schema(self) + def core_schema(self) -> CoreSchema: + """The pydantic-core schema used to build the SchemaValidator and SchemaSerializer.""" + if self._core_schema is None or isinstance(self._core_schema, _mock_val_ser.MockCoreSchema): + self._init_core_attrs(rebuild_mocks=True) # Do not expose MockCoreSchema from public function + assert self._core_schema is not None and not isinstance(self._core_schema, _mock_val_ser.MockCoreSchema) + return self._core_schema + + @cached_property + @_frame_depth(2) # +2 for @cached_property + validator(self) + def validator(self) -> SchemaValidator | PluggableSchemaValidator: + """The pydantic-core SchemaValidator used to validate instances of the model.""" + if not isinstance(self._validator, (SchemaValidator, PluggableSchemaValidator)): + self._init_core_attrs(rebuild_mocks=True) # Do not expose MockValSer from public function + assert isinstance(self._validator, (SchemaValidator, PluggableSchemaValidator)) + return self._validator + + @cached_property + @_frame_depth(2) # +2 for @cached_property + serializer(self) + def serializer(self) -> SchemaSerializer: + """The pydantic-core SchemaSerializer used to dump instances of the model.""" + if not isinstance(self._serializer, SchemaSerializer): + self._init_core_attrs(rebuild_mocks=True) # Do not expose MockValSer from public function + assert isinstance(self._serializer, SchemaSerializer) + return self._serializer + + def _defer_build(self) -> bool: + config = self._config if self._config is not None else self._model_config() + return self._is_defer_build_config(config) if config is not None else False + + def _model_config(self) -> ConfigDict | None: + type_: Any = _typing_extra.annotated_type(self._type) or self._type # Eg FastAPI heavily uses Annotated + if _utils.lenient_issubclass(type_, BaseModel): + return type_.model_config + return getattr(type_, '__pydantic_config__', None) + + @staticmethod + def _is_defer_build_config(config: ConfigDict) -> bool: + # TODO reevaluate this logic when we have a better understanding of how defer_build should work with TypeAdapter + # Should we drop the special experimental_defer_build_mode check? + return config.get('defer_build', False) is True and 'type_adapter' in config.get( + 'experimental_defer_build_mode', tuple() + ) + + @_frame_depth(1) + def validate_python( + self, + object: Any, + /, + *, + strict: bool | None = None, + from_attributes: bool | None = None, + context: dict[str, Any] | None = None, + ) -> T: + """Validate a Python object against the model. + + Args: + object: The Python object to validate against the model. + strict: Whether to strictly check types. + from_attributes: Whether to extract data from object attributes. + context: Additional context to pass to the validator. + + !!! note + When using `TypeAdapter` with a Pydantic `dataclass`, the use of the `from_attributes` + argument is not supported. + + Returns: + The validated object. + """ + return self.validator.validate_python(object, strict=strict, from_attributes=from_attributes, context=context) + + @_frame_depth(1) + def validate_json( + self, data: str | bytes, /, *, strict: bool | None = None, context: dict[str, Any] | None = None + ) -> T: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/json/#json-parsing + + Validate a JSON string or bytes against the model. + + Args: + data: The JSON data to validate against the model. + strict: Whether to strictly check types. + context: Additional context to use during validation. + + Returns: + The validated object. + """ + return self.validator.validate_json(data, strict=strict, context=context) + + @_frame_depth(1) + def validate_strings(self, obj: Any, /, *, strict: bool | None = None, context: dict[str, Any] | None = None) -> T: + """Validate object contains string data against the model. + + Args: + obj: The object contains string data to validate. + strict: Whether to strictly check types. + context: Additional context to use during validation. + + Returns: + The validated object. + """ + return self.validator.validate_strings(obj, strict=strict, context=context) + + @_frame_depth(1) + def get_default_value(self, *, strict: bool | None = None, context: dict[str, Any] | None = None) -> Some[T] | None: + """Get the default value for the wrapped type. + + Args: + strict: Whether to strictly check types. + context: Additional context to pass to the validator. + + Returns: + The default value wrapped in a `Some` if there is one or None if not. + """ + return self.validator.get_default_value(strict=strict, context=context) + + @_frame_depth(1) + def dump_python( + self, + instance: T, + /, + *, + mode: Literal['json', 'python'] = 'python', + include: IncEx | None = None, + exclude: IncEx | None = None, + by_alias: bool = False, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + round_trip: bool = False, + warnings: bool | Literal['none', 'warn', 'error'] = True, + serialize_as_any: bool = False, + context: dict[str, Any] | None = None, + ) -> Any: + """Dump an instance of the adapted type to a Python object. + + Args: + instance: The Python object to serialize. + mode: The output format. + include: Fields to include in the output. + exclude: Fields to exclude from the output. + by_alias: Whether to use alias names for field names. + exclude_unset: Whether to exclude unset fields. + exclude_defaults: Whether to exclude fields with default values. + exclude_none: Whether to exclude fields with None values. + round_trip: Whether to output the serialized data in a way that is compatible with deserialization. + warnings: How to handle serialization errors. False/"none" ignores them, True/"warn" logs errors, + "error" raises a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError]. + serialize_as_any: Whether to serialize fields with duck-typing serialization behavior. + context: Additional context to pass to the serializer. + + Returns: + The serialized object. + """ + return self.serializer.to_python( + instance, + mode=mode, + by_alias=by_alias, + include=include, + exclude=exclude, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + round_trip=round_trip, + warnings=warnings, + serialize_as_any=serialize_as_any, + context=context, + ) + + @_frame_depth(1) + def dump_json( + self, + instance: T, + /, + *, + indent: int | None = None, + include: IncEx | None = None, + exclude: IncEx | None = None, + by_alias: bool = False, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + round_trip: bool = False, + warnings: bool | Literal['none', 'warn', 'error'] = True, + serialize_as_any: bool = False, + context: dict[str, Any] | None = None, + ) -> bytes: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/json/#json-serialization + + Serialize an instance of the adapted type to JSON. + + Args: + instance: The instance to be serialized. + indent: Number of spaces for JSON indentation. + include: Fields to include. + exclude: Fields to exclude. + by_alias: Whether to use alias names for field names. + exclude_unset: Whether to exclude unset fields. + exclude_defaults: Whether to exclude fields with default values. + exclude_none: Whether to exclude fields with a value of `None`. + round_trip: Whether to serialize and deserialize the instance to ensure round-tripping. + warnings: How to handle serialization errors. False/"none" ignores them, True/"warn" logs errors, + "error" raises a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError]. + serialize_as_any: Whether to serialize fields with duck-typing serialization behavior. + context: Additional context to pass to the serializer. + + Returns: + The JSON representation of the given instance as bytes. + """ + return self.serializer.to_json( + instance, + indent=indent, + include=include, + exclude=exclude, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + round_trip=round_trip, + warnings=warnings, + serialize_as_any=serialize_as_any, + context=context, + ) + + @_frame_depth(1) + def json_schema( + self, + *, + by_alias: bool = True, + ref_template: str = DEFAULT_REF_TEMPLATE, + schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema, + mode: JsonSchemaMode = 'validation', + ) -> dict[str, Any]: + """Generate a JSON schema for the adapted type. + + Args: + by_alias: Whether to use alias names for field names. + ref_template: The format string used for generating $ref strings. + schema_generator: The generator class used for creating the schema. + mode: The mode to use for schema generation. + + Returns: + The JSON schema for the model as a dictionary. + """ + schema_generator_instance = schema_generator(by_alias=by_alias, ref_template=ref_template) + return schema_generator_instance.generate(self.core_schema, mode=mode) + + @staticmethod + def json_schemas( + inputs: Iterable[tuple[JsonSchemaKeyT, JsonSchemaMode, TypeAdapter[Any]]], + /, + *, + by_alias: bool = True, + title: str | None = None, + description: str | None = None, + ref_template: str = DEFAULT_REF_TEMPLATE, + schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema, + ) -> tuple[dict[tuple[JsonSchemaKeyT, JsonSchemaMode], JsonSchemaValue], JsonSchemaValue]: + """Generate a JSON schema including definitions from multiple type adapters. + + Args: + inputs: Inputs to schema generation. The first two items will form the keys of the (first) + output mapping; the type adapters will provide the core schemas that get converted into + definitions in the output JSON schema. + by_alias: Whether to use alias names. + title: The title for the schema. + description: The description for the schema. + ref_template: The format string used for generating $ref strings. + schema_generator: The generator class used for creating the schema. + + Returns: + A tuple where: + + - The first element is a dictionary whose keys are tuples of JSON schema key type and JSON mode, and + whose values are the JSON schema corresponding to that pair of inputs. (These schemas may have + JsonRef references to definitions that are defined in the second returned element.) + - The second element is a JSON schema containing all definitions referenced in the first returned + element, along with the optional title and description keys. + + """ + schema_generator_instance = schema_generator(by_alias=by_alias, ref_template=ref_template) + + inputs_ = [] + for key, mode, adapter in inputs: + with adapter._with_frame_depth(1): # +1 for json_schemas staticmethod + inputs_.append((key, mode, adapter.core_schema)) + + json_schemas_map, definitions = schema_generator_instance.generate_definitions(inputs_) + + json_schema: dict[str, Any] = {} + if definitions: + json_schema['$defs'] = definitions + if title: + json_schema['title'] = title + if description: + json_schema['description'] = description + + return json_schemas_map, json_schema diff --git a/env/Lib/site-packages/pydantic/types.py b/env/Lib/site-packages/pydantic/types.py new file mode 100644 index 0000000..50f397e --- /dev/null +++ b/env/Lib/site-packages/pydantic/types.py @@ -0,0 +1,3043 @@ +"""The types module contains custom types used by pydantic.""" + +from __future__ import annotations as _annotations + +import base64 +import dataclasses as _dataclasses +import re +from datetime import date, datetime +from decimal import Decimal +from enum import Enum +from pathlib import Path +from types import ModuleType +from typing import ( + TYPE_CHECKING, + Any, + Callable, + ClassVar, + Dict, + FrozenSet, + Generic, + Hashable, + Iterator, + List, + Pattern, + Set, + TypeVar, + Union, + cast, + get_args, + get_origin, +) +from uuid import UUID + +import annotated_types +from annotated_types import BaseMetadata, MaxLen, MinLen +from pydantic_core import CoreSchema, PydanticCustomError, core_schema +from typing_extensions import Annotated, Literal, Protocol, TypeAlias, TypeAliasType, deprecated + +from ._internal import ( + _core_utils, + _fields, + _internal_dataclass, + _typing_extra, + _utils, + _validators, +) +from ._migration import getattr_migration +from .annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler +from .errors import PydanticUserError +from .json_schema import JsonSchemaValue +from .warnings import PydanticDeprecatedSince20 + +__all__ = ( + 'Strict', + 'StrictStr', + 'conbytes', + 'conlist', + 'conset', + 'confrozenset', + 'constr', + 'ImportString', + 'conint', + 'PositiveInt', + 'NegativeInt', + 'NonNegativeInt', + 'NonPositiveInt', + 'confloat', + 'PositiveFloat', + 'NegativeFloat', + 'NonNegativeFloat', + 'NonPositiveFloat', + 'FiniteFloat', + 'condecimal', + 'UUID1', + 'UUID3', + 'UUID4', + 'UUID5', + 'FilePath', + 'DirectoryPath', + 'NewPath', + 'Json', + 'Secret', + 'SecretStr', + 'SecretBytes', + 'StrictBool', + 'StrictBytes', + 'StrictInt', + 'StrictFloat', + 'PaymentCardNumber', + 'ByteSize', + 'PastDate', + 'FutureDate', + 'PastDatetime', + 'FutureDatetime', + 'condate', + 'AwareDatetime', + 'NaiveDatetime', + 'AllowInfNan', + 'EncoderProtocol', + 'EncodedBytes', + 'EncodedStr', + 'Base64Encoder', + 'Base64Bytes', + 'Base64Str', + 'Base64UrlBytes', + 'Base64UrlStr', + 'GetPydanticSchema', + 'StringConstraints', + 'Tag', + 'Discriminator', + 'JsonValue', + 'OnErrorOmit', + 'FailFast', +) + + +T = TypeVar('T') + + +@_dataclasses.dataclass +class Strict(_fields.PydanticMetadata, BaseMetadata): + """Usage docs: https://docs.pydantic.dev/2.8/concepts/strict_mode/#strict-mode-with-annotated-strict + + A field metadata class to indicate that a field should be validated in strict mode. + + Attributes: + strict: Whether to validate the field in strict mode. + + Example: + ```python + from typing_extensions import Annotated + + from pydantic.types import Strict + + StrictBool = Annotated[bool, Strict()] + ``` + """ + + strict: bool = True + + def __hash__(self) -> int: + return hash(self.strict) + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BOOLEAN TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +StrictBool = Annotated[bool, Strict()] +"""A boolean that must be either ``True`` or ``False``.""" + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ INTEGER TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +def conint( + *, + strict: bool | None = None, + gt: int | None = None, + ge: int | None = None, + lt: int | None = None, + le: int | None = None, + multiple_of: int | None = None, +) -> type[int]: + """ + !!! warning "Discouraged" + This function is **discouraged** in favor of using + [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with + [`Field`][pydantic.fields.Field] instead. + + This function will be **deprecated** in Pydantic 3.0. + + The reason is that `conint` returns a type, which doesn't play well with static analysis tools. + + === ":x: Don't do this" + ```py + from pydantic import BaseModel, conint + + class Foo(BaseModel): + bar: conint(strict=True, gt=0) + ``` + + === ":white_check_mark: Do this" + ```py + from typing_extensions import Annotated + + from pydantic import BaseModel, Field + + class Foo(BaseModel): + bar: Annotated[int, Field(strict=True, gt=0)] + ``` + + A wrapper around `int` that allows for additional constraints. + + Args: + strict: Whether to validate the integer in strict mode. Defaults to `None`. + gt: The value must be greater than this. + ge: The value must be greater than or equal to this. + lt: The value must be less than this. + le: The value must be less than or equal to this. + multiple_of: The value must be a multiple of this. + + Returns: + The wrapped integer type. + + ```py + from pydantic import BaseModel, ValidationError, conint + + class ConstrainedExample(BaseModel): + constrained_int: conint(gt=1) + + m = ConstrainedExample(constrained_int=2) + print(repr(m)) + #> ConstrainedExample(constrained_int=2) + + try: + ConstrainedExample(constrained_int=0) + except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'greater_than', + 'loc': ('constrained_int',), + 'msg': 'Input should be greater than 1', + 'input': 0, + 'ctx': {'gt': 1}, + 'url': 'https://errors.pydantic.dev/2/v/greater_than', + } + ] + ''' + ``` + + """ # noqa: D212 + return Annotated[ # pyright: ignore[reportReturnType] + int, + Strict(strict) if strict is not None else None, + annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le), + annotated_types.MultipleOf(multiple_of) if multiple_of is not None else None, + ] + + +PositiveInt = Annotated[int, annotated_types.Gt(0)] +"""An integer that must be greater than zero. + +```py +from pydantic import BaseModel, PositiveInt, ValidationError + +class Model(BaseModel): + positive_int: PositiveInt + +m = Model(positive_int=1) +print(repr(m)) +#> Model(positive_int=1) + +try: + Model(positive_int=-1) +except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'greater_than', + 'loc': ('positive_int',), + 'msg': 'Input should be greater than 0', + 'input': -1, + 'ctx': {'gt': 0}, + 'url': 'https://errors.pydantic.dev/2/v/greater_than', + } + ] + ''' +``` +""" +NegativeInt = Annotated[int, annotated_types.Lt(0)] +"""An integer that must be less than zero. + +```py +from pydantic import BaseModel, NegativeInt, ValidationError + +class Model(BaseModel): + negative_int: NegativeInt + +m = Model(negative_int=-1) +print(repr(m)) +#> Model(negative_int=-1) + +try: + Model(negative_int=1) +except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'less_than', + 'loc': ('negative_int',), + 'msg': 'Input should be less than 0', + 'input': 1, + 'ctx': {'lt': 0}, + 'url': 'https://errors.pydantic.dev/2/v/less_than', + } + ] + ''' +``` +""" +NonPositiveInt = Annotated[int, annotated_types.Le(0)] +"""An integer that must be less than or equal to zero. + +```py +from pydantic import BaseModel, NonPositiveInt, ValidationError + +class Model(BaseModel): + non_positive_int: NonPositiveInt + +m = Model(non_positive_int=0) +print(repr(m)) +#> Model(non_positive_int=0) + +try: + Model(non_positive_int=1) +except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'less_than_equal', + 'loc': ('non_positive_int',), + 'msg': 'Input should be less than or equal to 0', + 'input': 1, + 'ctx': {'le': 0}, + 'url': 'https://errors.pydantic.dev/2/v/less_than_equal', + } + ] + ''' +``` +""" +NonNegativeInt = Annotated[int, annotated_types.Ge(0)] +"""An integer that must be greater than or equal to zero. + +```py +from pydantic import BaseModel, NonNegativeInt, ValidationError + +class Model(BaseModel): + non_negative_int: NonNegativeInt + +m = Model(non_negative_int=0) +print(repr(m)) +#> Model(non_negative_int=0) + +try: + Model(non_negative_int=-1) +except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'greater_than_equal', + 'loc': ('non_negative_int',), + 'msg': 'Input should be greater than or equal to 0', + 'input': -1, + 'ctx': {'ge': 0}, + 'url': 'https://errors.pydantic.dev/2/v/greater_than_equal', + } + ] + ''' +``` +""" +StrictInt = Annotated[int, Strict()] +"""An integer that must be validated in strict mode. + +```py +from pydantic import BaseModel, StrictInt, ValidationError + +class StrictIntModel(BaseModel): + strict_int: StrictInt + +try: + StrictIntModel(strict_int=3.14159) +except ValidationError as e: + print(e) + ''' + 1 validation error for StrictIntModel + strict_int + Input should be a valid integer [type=int_type, input_value=3.14159, input_type=float] + ''' +``` +""" + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ FLOAT TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +@_dataclasses.dataclass +class AllowInfNan(_fields.PydanticMetadata): + """A field metadata class to indicate that a field should allow ``-inf``, ``inf``, and ``nan``.""" + + allow_inf_nan: bool = True + + def __hash__(self) -> int: + return hash(self.allow_inf_nan) + + +def confloat( + *, + strict: bool | None = None, + gt: float | None = None, + ge: float | None = None, + lt: float | None = None, + le: float | None = None, + multiple_of: float | None = None, + allow_inf_nan: bool | None = None, +) -> type[float]: + """ + !!! warning "Discouraged" + This function is **discouraged** in favor of using + [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with + [`Field`][pydantic.fields.Field] instead. + + This function will be **deprecated** in Pydantic 3.0. + + The reason is that `confloat` returns a type, which doesn't play well with static analysis tools. + + === ":x: Don't do this" + ```py + from pydantic import BaseModel, confloat + + class Foo(BaseModel): + bar: confloat(strict=True, gt=0) + ``` + + === ":white_check_mark: Do this" + ```py + from typing_extensions import Annotated + + from pydantic import BaseModel, Field + + class Foo(BaseModel): + bar: Annotated[float, Field(strict=True, gt=0)] + ``` + + A wrapper around `float` that allows for additional constraints. + + Args: + strict: Whether to validate the float in strict mode. + gt: The value must be greater than this. + ge: The value must be greater than or equal to this. + lt: The value must be less than this. + le: The value must be less than or equal to this. + multiple_of: The value must be a multiple of this. + allow_inf_nan: Whether to allow `-inf`, `inf`, and `nan`. + + Returns: + The wrapped float type. + + ```py + from pydantic import BaseModel, ValidationError, confloat + + class ConstrainedExample(BaseModel): + constrained_float: confloat(gt=1.0) + + m = ConstrainedExample(constrained_float=1.1) + print(repr(m)) + #> ConstrainedExample(constrained_float=1.1) + + try: + ConstrainedExample(constrained_float=0.9) + except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'greater_than', + 'loc': ('constrained_float',), + 'msg': 'Input should be greater than 1', + 'input': 0.9, + 'ctx': {'gt': 1.0}, + 'url': 'https://errors.pydantic.dev/2/v/greater_than', + } + ] + ''' + ``` + """ # noqa: D212 + return Annotated[ # pyright: ignore[reportReturnType] + float, + Strict(strict) if strict is not None else None, + annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le), + annotated_types.MultipleOf(multiple_of) if multiple_of is not None else None, + AllowInfNan(allow_inf_nan) if allow_inf_nan is not None else None, + ] + + +PositiveFloat = Annotated[float, annotated_types.Gt(0)] +"""A float that must be greater than zero. + +```py +from pydantic import BaseModel, PositiveFloat, ValidationError + +class Model(BaseModel): + positive_float: PositiveFloat + +m = Model(positive_float=1.0) +print(repr(m)) +#> Model(positive_float=1.0) + +try: + Model(positive_float=-1.0) +except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'greater_than', + 'loc': ('positive_float',), + 'msg': 'Input should be greater than 0', + 'input': -1.0, + 'ctx': {'gt': 0.0}, + 'url': 'https://errors.pydantic.dev/2/v/greater_than', + } + ] + ''' +``` +""" +NegativeFloat = Annotated[float, annotated_types.Lt(0)] +"""A float that must be less than zero. + +```py +from pydantic import BaseModel, NegativeFloat, ValidationError + +class Model(BaseModel): + negative_float: NegativeFloat + +m = Model(negative_float=-1.0) +print(repr(m)) +#> Model(negative_float=-1.0) + +try: + Model(negative_float=1.0) +except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'less_than', + 'loc': ('negative_float',), + 'msg': 'Input should be less than 0', + 'input': 1.0, + 'ctx': {'lt': 0.0}, + 'url': 'https://errors.pydantic.dev/2/v/less_than', + } + ] + ''' +``` +""" +NonPositiveFloat = Annotated[float, annotated_types.Le(0)] +"""A float that must be less than or equal to zero. + +```py +from pydantic import BaseModel, NonPositiveFloat, ValidationError + +class Model(BaseModel): + non_positive_float: NonPositiveFloat + +m = Model(non_positive_float=0.0) +print(repr(m)) +#> Model(non_positive_float=0.0) + +try: + Model(non_positive_float=1.0) +except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'less_than_equal', + 'loc': ('non_positive_float',), + 'msg': 'Input should be less than or equal to 0', + 'input': 1.0, + 'ctx': {'le': 0.0}, + 'url': 'https://errors.pydantic.dev/2/v/less_than_equal', + } + ] + ''' +``` +""" +NonNegativeFloat = Annotated[float, annotated_types.Ge(0)] +"""A float that must be greater than or equal to zero. + +```py +from pydantic import BaseModel, NonNegativeFloat, ValidationError + +class Model(BaseModel): + non_negative_float: NonNegativeFloat + +m = Model(non_negative_float=0.0) +print(repr(m)) +#> Model(non_negative_float=0.0) + +try: + Model(non_negative_float=-1.0) +except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'greater_than_equal', + 'loc': ('non_negative_float',), + 'msg': 'Input should be greater than or equal to 0', + 'input': -1.0, + 'ctx': {'ge': 0.0}, + 'url': 'https://errors.pydantic.dev/2/v/greater_than_equal', + } + ] + ''' +``` +""" +StrictFloat = Annotated[float, Strict(True)] +"""A float that must be validated in strict mode. + +```py +from pydantic import BaseModel, StrictFloat, ValidationError + +class StrictFloatModel(BaseModel): + strict_float: StrictFloat + +try: + StrictFloatModel(strict_float='1.0') +except ValidationError as e: + print(e) + ''' + 1 validation error for StrictFloatModel + strict_float + Input should be a valid number [type=float_type, input_value='1.0', input_type=str] + ''' +``` +""" +FiniteFloat = Annotated[float, AllowInfNan(False)] +"""A float that must be finite (not ``-inf``, ``inf``, or ``nan``). + +```py +from pydantic import BaseModel, FiniteFloat + +class Model(BaseModel): + finite: FiniteFloat + +m = Model(finite=1.0) +print(m) +#> finite=1.0 +``` +""" + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTES TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +def conbytes( + *, + min_length: int | None = None, + max_length: int | None = None, + strict: bool | None = None, +) -> type[bytes]: + """A wrapper around `bytes` that allows for additional constraints. + + Args: + min_length: The minimum length of the bytes. + max_length: The maximum length of the bytes. + strict: Whether to validate the bytes in strict mode. + + Returns: + The wrapped bytes type. + """ + return Annotated[ # pyright: ignore[reportReturnType] + bytes, + Strict(strict) if strict is not None else None, + annotated_types.Len(min_length or 0, max_length), + ] + + +StrictBytes = Annotated[bytes, Strict()] +"""A bytes that must be validated in strict mode.""" + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ STRING TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +@_dataclasses.dataclass(frozen=True) +class StringConstraints(annotated_types.GroupedMetadata): + """Usage docs: https://docs.pydantic.dev/2.8/concepts/fields/#string-constraints + + Apply constraints to `str` types. + + Attributes: + strip_whitespace: Whether to remove leading and trailing whitespace. + to_upper: Whether to convert the string to uppercase. + to_lower: Whether to convert the string to lowercase. + strict: Whether to validate the string in strict mode. + min_length: The minimum length of the string. + max_length: The maximum length of the string. + pattern: A regex pattern that the string must match. + """ + + strip_whitespace: bool | None = None + to_upper: bool | None = None + to_lower: bool | None = None + strict: bool | None = None + min_length: int | None = None + max_length: int | None = None + pattern: str | Pattern[str] | None = None + + def __iter__(self) -> Iterator[BaseMetadata]: + if self.min_length is not None: + yield MinLen(self.min_length) + if self.max_length is not None: + yield MaxLen(self.max_length) + if self.strict is not None: + yield Strict(self.strict) + if ( + self.strip_whitespace is not None + or self.pattern is not None + or self.to_lower is not None + or self.to_upper is not None + ): + yield _fields.pydantic_general_metadata( + strip_whitespace=self.strip_whitespace, + to_upper=self.to_upper, + to_lower=self.to_lower, + pattern=self.pattern, + ) + + +def constr( + *, + strip_whitespace: bool | None = None, + to_upper: bool | None = None, + to_lower: bool | None = None, + strict: bool | None = None, + min_length: int | None = None, + max_length: int | None = None, + pattern: str | Pattern[str] | None = None, +) -> type[str]: + """ + !!! warning "Discouraged" + This function is **discouraged** in favor of using + [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with + [`StringConstraints`][pydantic.types.StringConstraints] instead. + + This function will be **deprecated** in Pydantic 3.0. + + The reason is that `constr` returns a type, which doesn't play well with static analysis tools. + + === ":x: Don't do this" + ```py + from pydantic import BaseModel, constr + + class Foo(BaseModel): + bar: constr(strip_whitespace=True, to_upper=True, pattern=r'^[A-Z]+$') + ``` + + === ":white_check_mark: Do this" + ```py + from typing_extensions import Annotated + + from pydantic import BaseModel, StringConstraints + + class Foo(BaseModel): + bar: Annotated[str, StringConstraints(strip_whitespace=True, to_upper=True, pattern=r'^[A-Z]+$')] + ``` + + A wrapper around `str` that allows for additional constraints. + + ```py + from pydantic import BaseModel, constr + + class Foo(BaseModel): + bar: constr(strip_whitespace=True, to_upper=True, pattern=r'^[A-Z]+$') + + + foo = Foo(bar=' hello ') + print(foo) + #> bar='HELLO' + ``` + + Args: + strip_whitespace: Whether to remove leading and trailing whitespace. + to_upper: Whether to turn all characters to uppercase. + to_lower: Whether to turn all characters to lowercase. + strict: Whether to validate the string in strict mode. + min_length: The minimum length of the string. + max_length: The maximum length of the string. + pattern: A regex pattern to validate the string against. + + Returns: + The wrapped string type. + """ # noqa: D212 + return Annotated[ # pyright: ignore[reportReturnType] + str, + StringConstraints( + strip_whitespace=strip_whitespace, + to_upper=to_upper, + to_lower=to_lower, + strict=strict, + min_length=min_length, + max_length=max_length, + pattern=pattern, + ), + ] + + +StrictStr = Annotated[str, Strict()] +"""A string that must be validated in strict mode.""" + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~ COLLECTION TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +HashableItemType = TypeVar('HashableItemType', bound=Hashable) + + +def conset( + item_type: type[HashableItemType], *, min_length: int | None = None, max_length: int | None = None +) -> type[set[HashableItemType]]: + """A wrapper around `typing.Set` that allows for additional constraints. + + Args: + item_type: The type of the items in the set. + min_length: The minimum length of the set. + max_length: The maximum length of the set. + + Returns: + The wrapped set type. + """ + return Annotated[Set[item_type], annotated_types.Len(min_length or 0, max_length)] # pyright: ignore[reportReturnType] + + +def confrozenset( + item_type: type[HashableItemType], *, min_length: int | None = None, max_length: int | None = None +) -> type[frozenset[HashableItemType]]: + """A wrapper around `typing.FrozenSet` that allows for additional constraints. + + Args: + item_type: The type of the items in the frozenset. + min_length: The minimum length of the frozenset. + max_length: The maximum length of the frozenset. + + Returns: + The wrapped frozenset type. + """ + return Annotated[FrozenSet[item_type], annotated_types.Len(min_length or 0, max_length)] # pyright: ignore[reportReturnType] + + +AnyItemType = TypeVar('AnyItemType') + + +def conlist( + item_type: type[AnyItemType], + *, + min_length: int | None = None, + max_length: int | None = None, + unique_items: bool | None = None, +) -> type[list[AnyItemType]]: + """A wrapper around typing.List that adds validation. + + Args: + item_type: The type of the items in the list. + min_length: The minimum length of the list. Defaults to None. + max_length: The maximum length of the list. Defaults to None. + unique_items: Whether the items in the list must be unique. Defaults to None. + !!! warning Deprecated + The `unique_items` parameter is deprecated, use `Set` instead. + See [this issue](https://github.com/pydantic/pydantic-core/issues/296) for more details. + + Returns: + The wrapped list type. + """ + if unique_items is not None: + raise PydanticUserError( + ( + '`unique_items` is removed, use `Set` instead' + '(this feature is discussed in https://github.com/pydantic/pydantic-core/issues/296)' + ), + code='removed-kwargs', + ) + return Annotated[List[item_type], annotated_types.Len(min_length or 0, max_length)] # pyright: ignore[reportReturnType] + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~ IMPORT STRING TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +AnyType = TypeVar('AnyType') +if TYPE_CHECKING: + ImportString = Annotated[AnyType, ...] +else: + + class ImportString: + """A type that can be used to import a type from a string. + + `ImportString` expects a string and loads the Python object importable at that dotted path. + Attributes of modules may be separated from the module by `:` or `.`, e.g. if `'math:cos'` was provided, + the resulting field value would be the function`cos`. If a `.` is used and both an attribute and submodule + are present at the same path, the module will be preferred. + + On model instantiation, pointers will be evaluated and imported. There is + some nuance to this behavior, demonstrated in the examples below. + + **Good behavior:** + ```py + from math import cos + + from pydantic import BaseModel, Field, ImportString, ValidationError + + + class ImportThings(BaseModel): + obj: ImportString + + + # A string value will cause an automatic import + my_cos = ImportThings(obj='math.cos') + + # You can use the imported function as you would expect + cos_of_0 = my_cos.obj(0) + assert cos_of_0 == 1 + + + # A string whose value cannot be imported will raise an error + try: + ImportThings(obj='foo.bar') + except ValidationError as e: + print(e) + ''' + 1 validation error for ImportThings + obj + Invalid python path: No module named 'foo.bar' [type=import_error, input_value='foo.bar', input_type=str] + ''' + + + # Actual python objects can be assigned as well + my_cos = ImportThings(obj=cos) + my_cos_2 = ImportThings(obj='math.cos') + my_cos_3 = ImportThings(obj='math:cos') + assert my_cos == my_cos_2 == my_cos_3 + + + # You can set default field value either as Python object: + class ImportThingsDefaultPyObj(BaseModel): + obj: ImportString = math.cos + + + # or as a string value (but only if used with `validate_default=True`) + class ImportThingsDefaultString(BaseModel): + obj: ImportString = Field(default='math.cos', validate_default=True) + + + my_cos_default1 = ImportThingsDefaultPyObj() + my_cos_default2 = ImportThingsDefaultString() + assert my_cos_default1.obj == my_cos_default2.obj == math.cos + + + # note: this will not work! + class ImportThingsMissingValidateDefault(BaseModel): + obj: ImportString = 'math.cos' + + my_cos_default3 = ImportThingsMissingValidateDefault() + assert my_cos_default3.obj == 'math.cos' # just string, not evaluated + ``` + + Serializing an `ImportString` type to json is also possible. + + ```py + from pydantic import BaseModel, ImportString + + + class ImportThings(BaseModel): + obj: ImportString + + + # Create an instance + m = ImportThings(obj='math.cos') + print(m) + #> obj= + print(m.model_dump_json()) + #> {"obj":"math.cos"} + ``` + """ + + @classmethod + def __class_getitem__(cls, item: AnyType) -> AnyType: + return Annotated[item, cls()] + + @classmethod + def __get_pydantic_core_schema__( + cls, source: type[Any], handler: GetCoreSchemaHandler + ) -> core_schema.CoreSchema: + serializer = core_schema.plain_serializer_function_ser_schema(cls._serialize, when_used='json') + if cls is source: + # Treat bare usage of ImportString (`schema is None`) as the same as ImportString[Any] + return core_schema.no_info_plain_validator_function( + function=_validators.import_string, serialization=serializer + ) + else: + return core_schema.no_info_before_validator_function( + function=_validators.import_string, schema=handler(source), serialization=serializer + ) + + @classmethod + def __get_pydantic_json_schema__(cls, cs: CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue: + return handler(core_schema.str_schema()) + + @staticmethod + def _serialize(v: Any) -> str: + if isinstance(v, ModuleType): + return v.__name__ + elif hasattr(v, '__module__') and hasattr(v, '__name__'): + return f'{v.__module__}.{v.__name__}' + else: + return v + + def __repr__(self) -> str: + return 'ImportString' + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DECIMAL TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +def condecimal( + *, + strict: bool | None = None, + gt: int | Decimal | None = None, + ge: int | Decimal | None = None, + lt: int | Decimal | None = None, + le: int | Decimal | None = None, + multiple_of: int | Decimal | None = None, + max_digits: int | None = None, + decimal_places: int | None = None, + allow_inf_nan: bool | None = None, +) -> type[Decimal]: + """ + !!! warning "Discouraged" + This function is **discouraged** in favor of using + [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with + [`Field`][pydantic.fields.Field] instead. + + This function will be **deprecated** in Pydantic 3.0. + + The reason is that `condecimal` returns a type, which doesn't play well with static analysis tools. + + === ":x: Don't do this" + ```py + from pydantic import BaseModel, condecimal + + class Foo(BaseModel): + bar: condecimal(strict=True, allow_inf_nan=True) + ``` + + === ":white_check_mark: Do this" + ```py + from decimal import Decimal + + from typing_extensions import Annotated + + from pydantic import BaseModel, Field + + class Foo(BaseModel): + bar: Annotated[Decimal, Field(strict=True, allow_inf_nan=True)] + ``` + + A wrapper around Decimal that adds validation. + + Args: + strict: Whether to validate the value in strict mode. Defaults to `None`. + gt: The value must be greater than this. Defaults to `None`. + ge: The value must be greater than or equal to this. Defaults to `None`. + lt: The value must be less than this. Defaults to `None`. + le: The value must be less than or equal to this. Defaults to `None`. + multiple_of: The value must be a multiple of this. Defaults to `None`. + max_digits: The maximum number of digits. Defaults to `None`. + decimal_places: The number of decimal places. Defaults to `None`. + allow_inf_nan: Whether to allow infinity and NaN. Defaults to `None`. + + ```py + from decimal import Decimal + + from pydantic import BaseModel, ValidationError, condecimal + + class ConstrainedExample(BaseModel): + constrained_decimal: condecimal(gt=Decimal('1.0')) + + m = ConstrainedExample(constrained_decimal=Decimal('1.1')) + print(repr(m)) + #> ConstrainedExample(constrained_decimal=Decimal('1.1')) + + try: + ConstrainedExample(constrained_decimal=Decimal('0.9')) + except ValidationError as e: + print(e.errors()) + ''' + [ + { + 'type': 'greater_than', + 'loc': ('constrained_decimal',), + 'msg': 'Input should be greater than 1.0', + 'input': Decimal('0.9'), + 'ctx': {'gt': Decimal('1.0')}, + 'url': 'https://errors.pydantic.dev/2/v/greater_than', + } + ] + ''' + ``` + """ # noqa: D212 + return Annotated[ # pyright: ignore[reportReturnType] + Decimal, + Strict(strict) if strict is not None else None, + annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le), + annotated_types.MultipleOf(multiple_of) if multiple_of is not None else None, + _fields.pydantic_general_metadata(max_digits=max_digits, decimal_places=decimal_places), + AllowInfNan(allow_inf_nan) if allow_inf_nan is not None else None, + ] + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ UUID TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +@_dataclasses.dataclass(**_internal_dataclass.slots_true) +class UuidVersion: + """A field metadata class to indicate a [UUID](https://docs.python.org/3/library/uuid.html) version.""" + + uuid_version: Literal[1, 3, 4, 5] + + def __get_pydantic_json_schema__( + self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = handler(core_schema) + field_schema.pop('anyOf', None) # remove the bytes/str union + field_schema.update(type='string', format=f'uuid{self.uuid_version}') + return field_schema + + def __get_pydantic_core_schema__(self, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + if isinstance(self, source): + # used directly as a type + return core_schema.uuid_schema(version=self.uuid_version) + else: + # update existing schema with self.uuid_version + schema = handler(source) + _check_annotated_type(schema['type'], 'uuid', self.__class__.__name__) + schema['version'] = self.uuid_version # type: ignore + return schema + + def __hash__(self) -> int: + return hash(type(self.uuid_version)) + + +UUID1 = Annotated[UUID, UuidVersion(1)] +"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 1. + +```py +import uuid + +from pydantic import UUID1, BaseModel + +class Model(BaseModel): + uuid1: UUID1 + +Model(uuid1=uuid.uuid1()) +``` +""" +UUID3 = Annotated[UUID, UuidVersion(3)] +"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 3. + +```py +import uuid + +from pydantic import UUID3, BaseModel + +class Model(BaseModel): + uuid3: UUID3 + +Model(uuid3=uuid.uuid3(uuid.NAMESPACE_DNS, 'pydantic.org')) +``` +""" +UUID4 = Annotated[UUID, UuidVersion(4)] +"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 4. + +```py +import uuid + +from pydantic import UUID4, BaseModel + +class Model(BaseModel): + uuid4: UUID4 + +Model(uuid4=uuid.uuid4()) +``` +""" +UUID5 = Annotated[UUID, UuidVersion(5)] +"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 5. + +```py +import uuid + +from pydantic import UUID5, BaseModel + +class Model(BaseModel): + uuid5: UUID5 + +Model(uuid5=uuid.uuid5(uuid.NAMESPACE_DNS, 'pydantic.org')) +``` +""" + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PATH TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +@_dataclasses.dataclass +class PathType: + path_type: Literal['file', 'dir', 'new'] + + def __get_pydantic_json_schema__( + self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = handler(core_schema) + format_conversion = {'file': 'file-path', 'dir': 'directory-path'} + field_schema.update(format=format_conversion.get(self.path_type, 'path'), type='string') + return field_schema + + def __get_pydantic_core_schema__(self, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + function_lookup = { + 'file': cast(core_schema.WithInfoValidatorFunction, self.validate_file), + 'dir': cast(core_schema.WithInfoValidatorFunction, self.validate_directory), + 'new': cast(core_schema.WithInfoValidatorFunction, self.validate_new), + } + + return core_schema.with_info_after_validator_function( + function_lookup[self.path_type], + handler(source), + ) + + @staticmethod + def validate_file(path: Path, _: core_schema.ValidationInfo) -> Path: + if path.is_file(): + return path + else: + raise PydanticCustomError('path_not_file', 'Path does not point to a file') + + @staticmethod + def validate_directory(path: Path, _: core_schema.ValidationInfo) -> Path: + if path.is_dir(): + return path + else: + raise PydanticCustomError('path_not_directory', 'Path does not point to a directory') + + @staticmethod + def validate_new(path: Path, _: core_schema.ValidationInfo) -> Path: + if path.exists(): + raise PydanticCustomError('path_exists', 'Path already exists') + elif not path.parent.exists(): + raise PydanticCustomError('parent_does_not_exist', 'Parent directory does not exist') + else: + return path + + def __hash__(self) -> int: + return hash(type(self.path_type)) + + +FilePath = Annotated[Path, PathType('file')] +"""A path that must point to a file. + +```py +from pathlib import Path + +from pydantic import BaseModel, FilePath, ValidationError + +class Model(BaseModel): + f: FilePath + +path = Path('text.txt') +path.touch() +m = Model(f='text.txt') +print(m.model_dump()) +#> {'f': PosixPath('text.txt')} +path.unlink() + +path = Path('directory') +path.mkdir(exist_ok=True) +try: + Model(f='directory') # directory +except ValidationError as e: + print(e) + ''' + 1 validation error for Model + f + Path does not point to a file [type=path_not_file, input_value='directory', input_type=str] + ''' +path.rmdir() + +try: + Model(f='not-exists-file') +except ValidationError as e: + print(e) + ''' + 1 validation error for Model + f + Path does not point to a file [type=path_not_file, input_value='not-exists-file', input_type=str] + ''' +``` +""" +DirectoryPath = Annotated[Path, PathType('dir')] +"""A path that must point to a directory. + +```py +from pathlib import Path + +from pydantic import BaseModel, DirectoryPath, ValidationError + +class Model(BaseModel): + f: DirectoryPath + +path = Path('directory/') +path.mkdir() +m = Model(f='directory/') +print(m.model_dump()) +#> {'f': PosixPath('directory')} +path.rmdir() + +path = Path('file.txt') +path.touch() +try: + Model(f='file.txt') # file +except ValidationError as e: + print(e) + ''' + 1 validation error for Model + f + Path does not point to a directory [type=path_not_directory, input_value='file.txt', input_type=str] + ''' +path.unlink() + +try: + Model(f='not-exists-directory') +except ValidationError as e: + print(e) + ''' + 1 validation error for Model + f + Path does not point to a directory [type=path_not_directory, input_value='not-exists-directory', input_type=str] + ''' +``` +""" +NewPath = Annotated[Path, PathType('new')] +"""A path for a new file or directory that must not already exist. The parent directory must already exist.""" + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ JSON TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +if TYPE_CHECKING: + # Json[list[str]] will be recognized by type checkers as list[str] + Json = Annotated[AnyType, ...] + +else: + + class Json: + """A special type wrapper which loads JSON before parsing. + + You can use the `Json` data type to make Pydantic first load a raw JSON string before + validating the loaded data into the parametrized type: + + ```py + from typing import Any, List + + from pydantic import BaseModel, Json, ValidationError + + + class AnyJsonModel(BaseModel): + json_obj: Json[Any] + + + class ConstrainedJsonModel(BaseModel): + json_obj: Json[List[int]] + + + print(AnyJsonModel(json_obj='{"b": 1}')) + #> json_obj={'b': 1} + print(ConstrainedJsonModel(json_obj='[1, 2, 3]')) + #> json_obj=[1, 2, 3] + + try: + ConstrainedJsonModel(json_obj=12) + except ValidationError as e: + print(e) + ''' + 1 validation error for ConstrainedJsonModel + json_obj + JSON input should be string, bytes or bytearray [type=json_type, input_value=12, input_type=int] + ''' + + try: + ConstrainedJsonModel(json_obj='[a, b]') + except ValidationError as e: + print(e) + ''' + 1 validation error for ConstrainedJsonModel + json_obj + Invalid JSON: expected value at line 1 column 2 [type=json_invalid, input_value='[a, b]', input_type=str] + ''' + + try: + ConstrainedJsonModel(json_obj='["a", "b"]') + except ValidationError as e: + print(e) + ''' + 2 validation errors for ConstrainedJsonModel + json_obj.0 + Input should be a valid integer, unable to parse string as an integer [type=int_parsing, input_value='a', input_type=str] + json_obj.1 + Input should be a valid integer, unable to parse string as an integer [type=int_parsing, input_value='b', input_type=str] + ''' + ``` + + When you dump the model using `model_dump` or `model_dump_json`, the dumped value will be the result of validation, + not the original JSON string. However, you can use the argument `round_trip=True` to get the original JSON string back: + + ```py + from typing import List + + from pydantic import BaseModel, Json + + + class ConstrainedJsonModel(BaseModel): + json_obj: Json[List[int]] + + + print(ConstrainedJsonModel(json_obj='[1, 2, 3]').model_dump_json()) + #> {"json_obj":[1,2,3]} + print( + ConstrainedJsonModel(json_obj='[1, 2, 3]').model_dump_json(round_trip=True) + ) + #> {"json_obj":"[1,2,3]"} + ``` + """ + + @classmethod + def __class_getitem__(cls, item: AnyType) -> AnyType: + return Annotated[item, cls()] + + @classmethod + def __get_pydantic_core_schema__(cls, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + if cls is source: + return core_schema.json_schema(None) + else: + return core_schema.json_schema(handler(source)) + + def __repr__(self) -> str: + return 'Json' + + def __hash__(self) -> int: + return hash(type(self)) + + def __eq__(self, other: Any) -> bool: + return type(other) == type(self) + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SECRET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +SecretType = TypeVar('SecretType') + + +class _SecretBase(Generic[SecretType]): + def __init__(self, secret_value: SecretType) -> None: + self._secret_value: SecretType = secret_value + + def get_secret_value(self) -> SecretType: + """Get the secret value. + + Returns: + The secret value. + """ + return self._secret_value + + def __eq__(self, other: Any) -> bool: + return isinstance(other, self.__class__) and self.get_secret_value() == other.get_secret_value() + + def __hash__(self) -> int: + return hash(self.get_secret_value()) + + def __str__(self) -> str: + return str(self._display()) + + def __repr__(self) -> str: + return f'{self.__class__.__name__}({self._display()!r})' + + def _display(self) -> str | bytes: + raise NotImplementedError + + +class Secret(_SecretBase[SecretType]): + """A generic base class used for defining a field with sensitive information that you do not want to be visible in logging or tracebacks. + + You may either directly parametrize `Secret` with a type, or subclass from `Secret` with a parametrized type. The benefit of subclassing + is that you can define a custom `_display` method, which will be used for `repr()` and `str()` methods. The examples below demonstrate both + ways of using `Secret` to create a new secret type. + + 1. Directly parametrizing `Secret` with a type: + + ```py + from pydantic import BaseModel, Secret + + SecretBool = Secret[bool] + + class Model(BaseModel): + secret_bool: SecretBool + + m = Model(secret_bool=True) + print(m.model_dump()) + #> {'secret_bool': Secret('**********')} + + print(m.model_dump_json()) + #> {"secret_bool":"**********"} + + print(m.secret_bool.get_secret_value()) + #> True + ``` + + 2. Subclassing from parametrized `Secret`: + + ```py + from datetime import date + + from pydantic import BaseModel, Secret + + class SecretDate(Secret[date]): + def _display(self) -> str: + return '****/**/**' + + class Model(BaseModel): + secret_date: SecretDate + + m = Model(secret_date=date(2022, 1, 1)) + print(m.model_dump()) + #> {'secret_date': SecretDate('****/**/**')} + + print(m.model_dump_json()) + #> {"secret_date":"****/**/**"} + + print(m.secret_date.get_secret_value()) + #> 2022-01-01 + ``` + + The value returned by the `_display` method will be used for `repr()` and `str()`. + """ + + def _display(self) -> str | bytes: + return '**********' if self.get_secret_value() else '' + + @classmethod + def __get_pydantic_core_schema__(cls, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + inner_type = None + # if origin_type is Secret, then cls is a GenericAlias, and we can extract the inner type directly + origin_type = get_origin(source) + if origin_type is not None: + inner_type = get_args(source)[0] + # otherwise, we need to get the inner type from the base class + else: + bases = getattr(cls, '__orig_bases__', getattr(cls, '__bases__', [])) + for base in bases: + if get_origin(base) is Secret: + inner_type = get_args(base)[0] + if bases == [] or inner_type is None: + raise TypeError( + f"Can't get secret type from {cls.__name__}. " + 'Please use Secret[], or subclass from Secret[] instead.' + ) + + inner_schema = handler.generate_schema(inner_type) # type: ignore + + def validate_secret_value(value, handler) -> Secret[SecretType]: + if isinstance(value, Secret): + value = value.get_secret_value() + validated_inner = handler(value) + return cls(validated_inner) + + def serialize(value: Secret[SecretType], info: core_schema.SerializationInfo) -> str | Secret[SecretType]: + if info.mode == 'json': + return str(value) + else: + return value + + return core_schema.json_or_python_schema( + python_schema=core_schema.no_info_wrap_validator_function( + validate_secret_value, + inner_schema, + ), + json_schema=core_schema.no_info_after_validator_function(lambda x: cls(x), inner_schema), + serialization=core_schema.plain_serializer_function_ser_schema( + serialize, + info_arg=True, + when_used='always', + ), + ) + + +def _secret_display(value: SecretType) -> str: # type: ignore + return '**********' if value else '' + + +class _SecretField(_SecretBase[SecretType]): + _inner_schema: ClassVar[CoreSchema] + _error_kind: ClassVar[str] + + @classmethod + def __get_pydantic_core_schema__(cls, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + def serialize( + value: _SecretField[SecretType], info: core_schema.SerializationInfo + ) -> str | _SecretField[SecretType]: + if info.mode == 'json': + # we want the output to always be string without the `b'` prefix for bytes, + # hence we just use `secret_display` + return _secret_display(value.get_secret_value()) + else: + return value + + def get_json_schema(_core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue: + json_schema = handler(cls._inner_schema) + _utils.update_not_none( + json_schema, + type='string', + writeOnly=True, + format='password', + ) + return json_schema + + json_schema = core_schema.no_info_after_validator_function( + source, # construct the type + cls._inner_schema, + ) + + def get_secret_schema(strict: bool) -> CoreSchema: + return core_schema.json_or_python_schema( + python_schema=core_schema.union_schema( + [ + core_schema.is_instance_schema(source), + json_schema, + ], + custom_error_type=cls._error_kind, + strict=strict, + ), + json_schema=json_schema, + serialization=core_schema.plain_serializer_function_ser_schema( + serialize, + info_arg=True, + return_schema=core_schema.str_schema(), + when_used='json', + ), + ) + + return core_schema.lax_or_strict_schema( + lax_schema=get_secret_schema(strict=False), + strict_schema=get_secret_schema(strict=True), + metadata={'pydantic_js_functions': [get_json_schema]}, + ) + + +class SecretStr(_SecretField[str]): + """A string used for storing sensitive information that you do not want to be visible in logging or tracebacks. + + When the secret value is nonempty, it is displayed as `'**********'` instead of the underlying value in + calls to `repr()` and `str()`. If the value _is_ empty, it is displayed as `''`. + + ```py + from pydantic import BaseModel, SecretStr + + class User(BaseModel): + username: str + password: SecretStr + + user = User(username='scolvin', password='password1') + + print(user) + #> username='scolvin' password=SecretStr('**********') + print(user.password.get_secret_value()) + #> password1 + print((SecretStr('password'), SecretStr(''))) + #> (SecretStr('**********'), SecretStr('')) + ``` + """ + + _inner_schema: ClassVar[CoreSchema] = core_schema.str_schema() + _error_kind: ClassVar[str] = 'string_type' + + def __len__(self) -> int: + return len(self._secret_value) + + def _display(self) -> str: + return _secret_display(self._secret_value) + + +class SecretBytes(_SecretField[bytes]): + """A bytes used for storing sensitive information that you do not want to be visible in logging or tracebacks. + + It displays `b'**********'` instead of the string value on `repr()` and `str()` calls. + When the secret value is nonempty, it is displayed as `b'**********'` instead of the underlying value in + calls to `repr()` and `str()`. If the value _is_ empty, it is displayed as `b''`. + + ```py + from pydantic import BaseModel, SecretBytes + + class User(BaseModel): + username: str + password: SecretBytes + + user = User(username='scolvin', password=b'password1') + #> username='scolvin' password=SecretBytes(b'**********') + print(user.password.get_secret_value()) + #> b'password1' + print((SecretBytes(b'password'), SecretBytes(b''))) + #> (SecretBytes(b'**********'), SecretBytes(b'')) + ``` + """ + + _inner_schema: ClassVar[CoreSchema] = core_schema.bytes_schema() + _error_kind: ClassVar[str] = 'bytes_type' + + def __len__(self) -> int: + return len(self._secret_value) + + def _display(self) -> bytes: + return _secret_display(self._secret_value).encode() + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PAYMENT CARD TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class PaymentCardBrand(str, Enum): + amex = 'American Express' + mastercard = 'Mastercard' + visa = 'Visa' + other = 'other' + + def __str__(self) -> str: + return self.value + + +@deprecated( + 'The `PaymentCardNumber` class is deprecated, use `pydantic_extra_types` instead. ' + 'See https://docs.pydantic.dev/latest/api/pydantic_extra_types_payment/#pydantic_extra_types.payment.PaymentCardNumber.', + category=PydanticDeprecatedSince20, +) +class PaymentCardNumber(str): + """Based on: https://en.wikipedia.org/wiki/Payment_card_number.""" + + strip_whitespace: ClassVar[bool] = True + min_length: ClassVar[int] = 12 + max_length: ClassVar[int] = 19 + bin: str + last4: str + brand: PaymentCardBrand + + def __init__(self, card_number: str): + self.validate_digits(card_number) + + card_number = self.validate_luhn_check_digit(card_number) + + self.bin = card_number[:6] + self.last4 = card_number[-4:] + self.brand = self.validate_brand(card_number) + + @classmethod + def __get_pydantic_core_schema__(cls, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + return core_schema.with_info_after_validator_function( + cls.validate, + core_schema.str_schema( + min_length=cls.min_length, max_length=cls.max_length, strip_whitespace=cls.strip_whitespace + ), + ) + + @classmethod + def validate(cls, input_value: str, /, _: core_schema.ValidationInfo) -> PaymentCardNumber: + """Validate the card number and return a `PaymentCardNumber` instance.""" + return cls(input_value) + + @property + def masked(self) -> str: + """Mask all but the last 4 digits of the card number. + + Returns: + A masked card number string. + """ + num_masked = len(self) - 10 # len(bin) + len(last4) == 10 + return f'{self.bin}{"*" * num_masked}{self.last4}' + + @classmethod + def validate_digits(cls, card_number: str) -> None: + """Validate that the card number is all digits.""" + if not card_number.isdigit(): + raise PydanticCustomError('payment_card_number_digits', 'Card number is not all digits') + + @classmethod + def validate_luhn_check_digit(cls, card_number: str) -> str: + """Based on: https://en.wikipedia.org/wiki/Luhn_algorithm.""" + sum_ = int(card_number[-1]) + length = len(card_number) + parity = length % 2 + for i in range(length - 1): + digit = int(card_number[i]) + if i % 2 == parity: + digit *= 2 + if digit > 9: + digit -= 9 + sum_ += digit + valid = sum_ % 10 == 0 + if not valid: + raise PydanticCustomError('payment_card_number_luhn', 'Card number is not luhn valid') + return card_number + + @staticmethod + def validate_brand(card_number: str) -> PaymentCardBrand: + """Validate length based on BIN for major brands: + https://en.wikipedia.org/wiki/Payment_card_number#Issuer_identification_number_(IIN). + """ + if card_number[0] == '4': + brand = PaymentCardBrand.visa + elif 51 <= int(card_number[:2]) <= 55: + brand = PaymentCardBrand.mastercard + elif card_number[:2] in {'34', '37'}: + brand = PaymentCardBrand.amex + else: + brand = PaymentCardBrand.other + + required_length: None | int | str = None + if brand in PaymentCardBrand.mastercard: + required_length = 16 + valid = len(card_number) == required_length + elif brand == PaymentCardBrand.visa: + required_length = '13, 16 or 19' + valid = len(card_number) in {13, 16, 19} + elif brand == PaymentCardBrand.amex: + required_length = 15 + valid = len(card_number) == required_length + else: + valid = True + + if not valid: + raise PydanticCustomError( + 'payment_card_number_brand', + 'Length for a {brand} card must be {required_length}', + {'brand': brand, 'required_length': required_length}, + ) + return brand + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTE SIZE TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class ByteSize(int): + """Converts a string representing a number of bytes with units (such as `'1KB'` or `'11.5MiB'`) into an integer. + + You can use the `ByteSize` data type to (case-insensitively) convert a string representation of a number of bytes into + an integer, and also to print out human-readable strings representing a number of bytes. + + In conformance with [IEC 80000-13 Standard](https://en.wikipedia.org/wiki/ISO/IEC_80000) we interpret `'1KB'` to mean 1000 bytes, + and `'1KiB'` to mean 1024 bytes. In general, including a middle `'i'` will cause the unit to be interpreted as a power of 2, + rather than a power of 10 (so, for example, `'1 MB'` is treated as `1_000_000` bytes, whereas `'1 MiB'` is treated as `1_048_576` bytes). + + !!! info + Note that `1b` will be parsed as "1 byte" and not "1 bit". + + ```py + from pydantic import BaseModel, ByteSize + + class MyModel(BaseModel): + size: ByteSize + + print(MyModel(size=52000).size) + #> 52000 + print(MyModel(size='3000 KiB').size) + #> 3072000 + + m = MyModel(size='50 PB') + print(m.size.human_readable()) + #> 44.4PiB + print(m.size.human_readable(decimal=True)) + #> 50.0PB + print(m.size.human_readable(separator=' ')) + #> 44.4 PiB + + print(m.size.to('TiB')) + #> 45474.73508864641 + ``` + """ + + byte_sizes = { + 'b': 1, + 'kb': 10**3, + 'mb': 10**6, + 'gb': 10**9, + 'tb': 10**12, + 'pb': 10**15, + 'eb': 10**18, + 'kib': 2**10, + 'mib': 2**20, + 'gib': 2**30, + 'tib': 2**40, + 'pib': 2**50, + 'eib': 2**60, + 'bit': 1 / 8, + 'kbit': 10**3 / 8, + 'mbit': 10**6 / 8, + 'gbit': 10**9 / 8, + 'tbit': 10**12 / 8, + 'pbit': 10**15 / 8, + 'ebit': 10**18 / 8, + 'kibit': 2**10 / 8, + 'mibit': 2**20 / 8, + 'gibit': 2**30 / 8, + 'tibit': 2**40 / 8, + 'pibit': 2**50 / 8, + 'eibit': 2**60 / 8, + } + byte_sizes.update({k.lower()[0]: v for k, v in byte_sizes.items() if 'i' not in k}) + + byte_string_pattern = r'^\s*(\d*\.?\d+)\s*(\w+)?' + byte_string_re = re.compile(byte_string_pattern, re.IGNORECASE) + + @classmethod + def __get_pydantic_core_schema__(cls, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + return core_schema.with_info_after_validator_function( + function=cls._validate, + schema=core_schema.union_schema( + [ + core_schema.str_schema(pattern=cls.byte_string_pattern), + core_schema.int_schema(ge=0), + ], + custom_error_type='byte_size', + custom_error_message='could not parse value and unit from byte string', + ), + serialization=core_schema.plain_serializer_function_ser_schema( + int, return_schema=core_schema.int_schema(ge=0) + ), + ) + + @classmethod + def _validate(cls, input_value: Any, /, _: core_schema.ValidationInfo) -> ByteSize: + try: + return cls(int(input_value)) + except ValueError: + pass + + str_match = cls.byte_string_re.match(str(input_value)) + if str_match is None: + raise PydanticCustomError('byte_size', 'could not parse value and unit from byte string') + + scalar, unit = str_match.groups() + if unit is None: + unit = 'b' + + try: + unit_mult = cls.byte_sizes[unit.lower()] + except KeyError: + raise PydanticCustomError('byte_size_unit', 'could not interpret byte unit: {unit}', {'unit': unit}) + + return cls(int(float(scalar) * unit_mult)) + + def human_readable(self, decimal: bool = False, separator: str = '') -> str: + """Converts a byte size to a human readable string. + + Args: + decimal: If True, use decimal units (e.g. 1000 bytes per KB). If False, use binary units + (e.g. 1024 bytes per KiB). + separator: A string used to split the value and unit. Defaults to an empty string (''). + + Returns: + A human readable string representation of the byte size. + """ + if decimal: + divisor = 1000 + units = 'B', 'KB', 'MB', 'GB', 'TB', 'PB' + final_unit = 'EB' + else: + divisor = 1024 + units = 'B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB' + final_unit = 'EiB' + + num = float(self) + for unit in units: + if abs(num) < divisor: + if unit == 'B': + return f'{num:0.0f}{separator}{unit}' + else: + return f'{num:0.1f}{separator}{unit}' + num /= divisor + + return f'{num:0.1f}{separator}{final_unit}' + + def to(self, unit: str) -> float: + """Converts a byte size to another unit, including both byte and bit units. + + Args: + unit: The unit to convert to. Must be one of the following: B, KB, MB, GB, TB, PB, EB, + KiB, MiB, GiB, TiB, PiB, EiB (byte units) and + bit, kbit, mbit, gbit, tbit, pbit, ebit, + kibit, mibit, gibit, tibit, pibit, eibit (bit units). + + Returns: + The byte size in the new unit. + """ + try: + unit_div = self.byte_sizes[unit.lower()] + except KeyError: + raise PydanticCustomError('byte_size_unit', 'Could not interpret byte unit: {unit}', {'unit': unit}) + + return self / unit_div + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DATE TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +def _check_annotated_type(annotated_type: str, expected_type: str, annotation: str) -> None: + if annotated_type != expected_type: + raise PydanticUserError(f"'{annotation}' cannot annotate '{annotated_type}'.", code='invalid_annotated_type') + + +if TYPE_CHECKING: + PastDate = Annotated[date, ...] + FutureDate = Annotated[date, ...] +else: + + class PastDate: + """A date in the past.""" + + @classmethod + def __get_pydantic_core_schema__( + cls, source: type[Any], handler: GetCoreSchemaHandler + ) -> core_schema.CoreSchema: + if cls is source: + # used directly as a type + return core_schema.date_schema(now_op='past') + else: + schema = handler(source) + _check_annotated_type(schema['type'], 'date', cls.__name__) + schema['now_op'] = 'past' + return schema + + def __repr__(self) -> str: + return 'PastDate' + + class FutureDate: + """A date in the future.""" + + @classmethod + def __get_pydantic_core_schema__( + cls, source: type[Any], handler: GetCoreSchemaHandler + ) -> core_schema.CoreSchema: + if cls is source: + # used directly as a type + return core_schema.date_schema(now_op='future') + else: + schema = handler(source) + _check_annotated_type(schema['type'], 'date', cls.__name__) + schema['now_op'] = 'future' + return schema + + def __repr__(self) -> str: + return 'FutureDate' + + +def condate( + *, + strict: bool | None = None, + gt: date | None = None, + ge: date | None = None, + lt: date | None = None, + le: date | None = None, +) -> type[date]: + """A wrapper for date that adds constraints. + + Args: + strict: Whether to validate the date value in strict mode. Defaults to `None`. + gt: The value must be greater than this. Defaults to `None`. + ge: The value must be greater than or equal to this. Defaults to `None`. + lt: The value must be less than this. Defaults to `None`. + le: The value must be less than or equal to this. Defaults to `None`. + + Returns: + A date type with the specified constraints. + """ + return Annotated[ # pyright: ignore[reportReturnType] + date, + Strict(strict) if strict is not None else None, + annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le), + ] + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DATETIME TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +if TYPE_CHECKING: + AwareDatetime = Annotated[datetime, ...] + NaiveDatetime = Annotated[datetime, ...] + PastDatetime = Annotated[datetime, ...] + FutureDatetime = Annotated[datetime, ...] + +else: + + class AwareDatetime: + """A datetime that requires timezone info.""" + + @classmethod + def __get_pydantic_core_schema__( + cls, source: type[Any], handler: GetCoreSchemaHandler + ) -> core_schema.CoreSchema: + if cls is source: + # used directly as a type + return core_schema.datetime_schema(tz_constraint='aware') + else: + schema = handler(source) + _check_annotated_type(schema['type'], 'datetime', cls.__name__) + schema['tz_constraint'] = 'aware' + return schema + + def __repr__(self) -> str: + return 'AwareDatetime' + + class NaiveDatetime: + """A datetime that doesn't require timezone info.""" + + @classmethod + def __get_pydantic_core_schema__( + cls, source: type[Any], handler: GetCoreSchemaHandler + ) -> core_schema.CoreSchema: + if cls is source: + # used directly as a type + return core_schema.datetime_schema(tz_constraint='naive') + else: + schema = handler(source) + _check_annotated_type(schema['type'], 'datetime', cls.__name__) + schema['tz_constraint'] = 'naive' + return schema + + def __repr__(self) -> str: + return 'NaiveDatetime' + + class PastDatetime: + """A datetime that must be in the past.""" + + @classmethod + def __get_pydantic_core_schema__( + cls, source: type[Any], handler: GetCoreSchemaHandler + ) -> core_schema.CoreSchema: + if cls is source: + # used directly as a type + return core_schema.datetime_schema(now_op='past') + else: + schema = handler(source) + _check_annotated_type(schema['type'], 'datetime', cls.__name__) + schema['now_op'] = 'past' + return schema + + def __repr__(self) -> str: + return 'PastDatetime' + + class FutureDatetime: + """A datetime that must be in the future.""" + + @classmethod + def __get_pydantic_core_schema__( + cls, source: type[Any], handler: GetCoreSchemaHandler + ) -> core_schema.CoreSchema: + if cls is source: + # used directly as a type + return core_schema.datetime_schema(now_op='future') + else: + schema = handler(source) + _check_annotated_type(schema['type'], 'datetime', cls.__name__) + schema['now_op'] = 'future' + return schema + + def __repr__(self) -> str: + return 'FutureDatetime' + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Encoded TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class EncoderProtocol(Protocol): + """Protocol for encoding and decoding data to and from bytes.""" + + @classmethod + def decode(cls, data: bytes) -> bytes: + """Decode the data using the encoder. + + Args: + data: The data to decode. + + Returns: + The decoded data. + """ + ... + + @classmethod + def encode(cls, value: bytes) -> bytes: + """Encode the data using the encoder. + + Args: + value: The data to encode. + + Returns: + The encoded data. + """ + ... + + @classmethod + def get_json_format(cls) -> str: + """Get the JSON format for the encoded data. + + Returns: + The JSON format for the encoded data. + """ + ... + + +class Base64Encoder(EncoderProtocol): + """Standard (non-URL-safe) Base64 encoder.""" + + @classmethod + def decode(cls, data: bytes) -> bytes: + """Decode the data from base64 encoded bytes to original bytes data. + + Args: + data: The data to decode. + + Returns: + The decoded data. + """ + try: + return base64.decodebytes(data) + except ValueError as e: + raise PydanticCustomError('base64_decode', "Base64 decoding error: '{error}'", {'error': str(e)}) + + @classmethod + def encode(cls, value: bytes) -> bytes: + """Encode the data from bytes to a base64 encoded bytes. + + Args: + value: The data to encode. + + Returns: + The encoded data. + """ + return base64.encodebytes(value) + + @classmethod + def get_json_format(cls) -> Literal['base64']: + """Get the JSON format for the encoded data. + + Returns: + The JSON format for the encoded data. + """ + return 'base64' + + +class Base64UrlEncoder(EncoderProtocol): + """URL-safe Base64 encoder.""" + + @classmethod + def decode(cls, data: bytes) -> bytes: + """Decode the data from base64 encoded bytes to original bytes data. + + Args: + data: The data to decode. + + Returns: + The decoded data. + """ + try: + return base64.urlsafe_b64decode(data) + except ValueError as e: + raise PydanticCustomError('base64_decode', "Base64 decoding error: '{error}'", {'error': str(e)}) + + @classmethod + def encode(cls, value: bytes) -> bytes: + """Encode the data from bytes to a base64 encoded bytes. + + Args: + value: The data to encode. + + Returns: + The encoded data. + """ + return base64.urlsafe_b64encode(value) + + @classmethod + def get_json_format(cls) -> Literal['base64url']: + """Get the JSON format for the encoded data. + + Returns: + The JSON format for the encoded data. + """ + return 'base64url' + + +@_dataclasses.dataclass(**_internal_dataclass.slots_true) +class EncodedBytes: + """A bytes type that is encoded and decoded using the specified encoder. + + `EncodedBytes` needs an encoder that implements `EncoderProtocol` to operate. + + ```py + from typing_extensions import Annotated + + from pydantic import BaseModel, EncodedBytes, EncoderProtocol, ValidationError + + class MyEncoder(EncoderProtocol): + @classmethod + def decode(cls, data: bytes) -> bytes: + if data == b'**undecodable**': + raise ValueError('Cannot decode data') + return data[13:] + + @classmethod + def encode(cls, value: bytes) -> bytes: + return b'**encoded**: ' + value + + @classmethod + def get_json_format(cls) -> str: + return 'my-encoder' + + MyEncodedBytes = Annotated[bytes, EncodedBytes(encoder=MyEncoder)] + + class Model(BaseModel): + my_encoded_bytes: MyEncodedBytes + + # Initialize the model with encoded data + m = Model(my_encoded_bytes=b'**encoded**: some bytes') + + # Access decoded value + print(m.my_encoded_bytes) + #> b'some bytes' + + # Serialize into the encoded form + print(m.model_dump()) + #> {'my_encoded_bytes': b'**encoded**: some bytes'} + + # Validate encoded data + try: + Model(my_encoded_bytes=b'**undecodable**') + except ValidationError as e: + print(e) + ''' + 1 validation error for Model + my_encoded_bytes + Value error, Cannot decode data [type=value_error, input_value=b'**undecodable**', input_type=bytes] + ''' + ``` + """ + + encoder: type[EncoderProtocol] + + def __get_pydantic_json_schema__( + self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler + ) -> JsonSchemaValue: + field_schema = handler(core_schema) + field_schema.update(type='string', format=self.encoder.get_json_format()) + return field_schema + + def __get_pydantic_core_schema__(self, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + return core_schema.with_info_after_validator_function( + function=self.decode, + schema=core_schema.bytes_schema(), + serialization=core_schema.plain_serializer_function_ser_schema(function=self.encode), + ) + + def decode(self, data: bytes, _: core_schema.ValidationInfo) -> bytes: + """Decode the data using the specified encoder. + + Args: + data: The data to decode. + + Returns: + The decoded data. + """ + return self.encoder.decode(data) + + def encode(self, value: bytes) -> bytes: + """Encode the data using the specified encoder. + + Args: + value: The data to encode. + + Returns: + The encoded data. + """ + return self.encoder.encode(value) + + def __hash__(self) -> int: + return hash(self.encoder) + + +@_dataclasses.dataclass(**_internal_dataclass.slots_true) +class EncodedStr(EncodedBytes): + """A str type that is encoded and decoded using the specified encoder. + + `EncodedStr` needs an encoder that implements `EncoderProtocol` to operate. + + ```py + from typing_extensions import Annotated + + from pydantic import BaseModel, EncodedStr, EncoderProtocol, ValidationError + + class MyEncoder(EncoderProtocol): + @classmethod + def decode(cls, data: bytes) -> bytes: + if data == b'**undecodable**': + raise ValueError('Cannot decode data') + return data[13:] + + @classmethod + def encode(cls, value: bytes) -> bytes: + return b'**encoded**: ' + value + + @classmethod + def get_json_format(cls) -> str: + return 'my-encoder' + + MyEncodedStr = Annotated[str, EncodedStr(encoder=MyEncoder)] + + class Model(BaseModel): + my_encoded_str: MyEncodedStr + + # Initialize the model with encoded data + m = Model(my_encoded_str='**encoded**: some str') + + # Access decoded value + print(m.my_encoded_str) + #> some str + + # Serialize into the encoded form + print(m.model_dump()) + #> {'my_encoded_str': '**encoded**: some str'} + + # Validate encoded data + try: + Model(my_encoded_str='**undecodable**') + except ValidationError as e: + print(e) + ''' + 1 validation error for Model + my_encoded_str + Value error, Cannot decode data [type=value_error, input_value='**undecodable**', input_type=str] + ''' + ``` + """ + + def __get_pydantic_core_schema__(self, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema: + return core_schema.with_info_after_validator_function( + function=self.decode_str, + schema=super(EncodedStr, self).__get_pydantic_core_schema__(source=source, handler=handler), # noqa: UP008 + serialization=core_schema.plain_serializer_function_ser_schema(function=self.encode_str), + ) + + def decode_str(self, data: bytes, _: core_schema.ValidationInfo) -> str: + """Decode the data using the specified encoder. + + Args: + data: The data to decode. + + Returns: + The decoded data. + """ + return data.decode() + + def encode_str(self, value: str) -> str: + """Encode the data using the specified encoder. + + Args: + value: The data to encode. + + Returns: + The encoded data. + """ + return super(EncodedStr, self).encode(value=value.encode()).decode() # noqa: UP008 + + def __hash__(self) -> int: + return hash(self.encoder) + + +Base64Bytes = Annotated[bytes, EncodedBytes(encoder=Base64Encoder)] +"""A bytes type that is encoded and decoded using the standard (non-URL-safe) base64 encoder. + +Note: + Under the hood, `Base64Bytes` use standard library `base64.encodebytes` and `base64.decodebytes` functions. + + As a result, attempting to decode url-safe base64 data using the `Base64Bytes` type may fail or produce an incorrect + decoding. + +```py +from pydantic import Base64Bytes, BaseModel, ValidationError + +class Model(BaseModel): + base64_bytes: Base64Bytes + +# Initialize the model with base64 data +m = Model(base64_bytes=b'VGhpcyBpcyB0aGUgd2F5') + +# Access decoded value +print(m.base64_bytes) +#> b'This is the way' + +# Serialize into the base64 form +print(m.model_dump()) +#> {'base64_bytes': b'VGhpcyBpcyB0aGUgd2F5\n'} + +# Validate base64 data +try: + print(Model(base64_bytes=b'undecodable').base64_bytes) +except ValidationError as e: + print(e) + ''' + 1 validation error for Model + base64_bytes + Base64 decoding error: 'Incorrect padding' [type=base64_decode, input_value=b'undecodable', input_type=bytes] + ''' +``` +""" +Base64Str = Annotated[str, EncodedStr(encoder=Base64Encoder)] +"""A str type that is encoded and decoded using the standard (non-URL-safe) base64 encoder. + +Note: + Under the hood, `Base64Bytes` use standard library `base64.encodebytes` and `base64.decodebytes` functions. + + As a result, attempting to decode url-safe base64 data using the `Base64Str` type may fail or produce an incorrect + decoding. + +```py +from pydantic import Base64Str, BaseModel, ValidationError + +class Model(BaseModel): + base64_str: Base64Str + +# Initialize the model with base64 data +m = Model(base64_str='VGhlc2UgYXJlbid0IHRoZSBkcm9pZHMgeW91J3JlIGxvb2tpbmcgZm9y') + +# Access decoded value +print(m.base64_str) +#> These aren't the droids you're looking for + +# Serialize into the base64 form +print(m.model_dump()) +#> {'base64_str': 'VGhlc2UgYXJlbid0IHRoZSBkcm9pZHMgeW91J3JlIGxvb2tpbmcgZm9y\n'} + +# Validate base64 data +try: + print(Model(base64_str='undecodable').base64_str) +except ValidationError as e: + print(e) + ''' + 1 validation error for Model + base64_str + Base64 decoding error: 'Incorrect padding' [type=base64_decode, input_value='undecodable', input_type=str] + ''' +``` +""" +Base64UrlBytes = Annotated[bytes, EncodedBytes(encoder=Base64UrlEncoder)] +"""A bytes type that is encoded and decoded using the URL-safe base64 encoder. + +Note: + Under the hood, `Base64UrlBytes` use standard library `base64.urlsafe_b64encode` and `base64.urlsafe_b64decode` + functions. + + As a result, the `Base64UrlBytes` type can be used to faithfully decode "vanilla" base64 data + (using `'+'` and `'/'`). + +```py +from pydantic import Base64UrlBytes, BaseModel + +class Model(BaseModel): + base64url_bytes: Base64UrlBytes + +# Initialize the model with base64 data +m = Model(base64url_bytes=b'SHc_dHc-TXc==') +print(m) +#> base64url_bytes=b'Hw?tw>Mw' +``` +""" +Base64UrlStr = Annotated[str, EncodedStr(encoder=Base64UrlEncoder)] +"""A str type that is encoded and decoded using the URL-safe base64 encoder. + +Note: + Under the hood, `Base64UrlStr` use standard library `base64.urlsafe_b64encode` and `base64.urlsafe_b64decode` + functions. + + As a result, the `Base64UrlStr` type can be used to faithfully decode "vanilla" base64 data (using `'+'` and `'/'`). + +```py +from pydantic import Base64UrlStr, BaseModel + +class Model(BaseModel): + base64url_str: Base64UrlStr + +# Initialize the model with base64 data +m = Model(base64url_str='SHc_dHc-TXc==') +print(m) +#> base64url_str='Hw?tw>Mw' +``` +""" + + +__getattr__ = getattr_migration(__name__) + + +@_dataclasses.dataclass(**_internal_dataclass.slots_true) +class GetPydanticSchema: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/types/#using-getpydanticschema-to-reduce-boilerplate + + A convenience class for creating an annotation that provides pydantic custom type hooks. + + This class is intended to eliminate the need to create a custom "marker" which defines the + `__get_pydantic_core_schema__` and `__get_pydantic_json_schema__` custom hook methods. + + For example, to have a field treated by type checkers as `int`, but by pydantic as `Any`, you can do: + ```python + from typing import Any + + from typing_extensions import Annotated + + from pydantic import BaseModel, GetPydanticSchema + + HandleAsAny = GetPydanticSchema(lambda _s, h: h(Any)) + + class Model(BaseModel): + x: Annotated[int, HandleAsAny] # pydantic sees `x: Any` + + print(repr(Model(x='abc').x)) + #> 'abc' + ``` + """ + + get_pydantic_core_schema: Callable[[Any, GetCoreSchemaHandler], CoreSchema] | None = None + get_pydantic_json_schema: Callable[[Any, GetJsonSchemaHandler], JsonSchemaValue] | None = None + + # Note: we may want to consider adding a convenience staticmethod `def for_type(type_: Any) -> GetPydanticSchema:` + # which returns `GetPydanticSchema(lambda _s, h: h(type_))` + + if not TYPE_CHECKING: + # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access + + def __getattr__(self, item: str) -> Any: + """Use this rather than defining `__get_pydantic_core_schema__` etc. to reduce the number of nested calls.""" + if item == '__get_pydantic_core_schema__' and self.get_pydantic_core_schema: + return self.get_pydantic_core_schema + elif item == '__get_pydantic_json_schema__' and self.get_pydantic_json_schema: + return self.get_pydantic_json_schema + else: + return object.__getattribute__(self, item) + + __hash__ = object.__hash__ + + +@_dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True) +class Tag: + """Provides a way to specify the expected tag to use for a case of a (callable) discriminated union. + + Also provides a way to label a union case in error messages. + + When using a callable `Discriminator`, attach a `Tag` to each case in the `Union` to specify the tag that + should be used to identify that case. For example, in the below example, the `Tag` is used to specify that + if `get_discriminator_value` returns `'apple'`, the input should be validated as an `ApplePie`, and if it + returns `'pumpkin'`, the input should be validated as a `PumpkinPie`. + + The primary role of the `Tag` here is to map the return value from the callable `Discriminator` function to + the appropriate member of the `Union` in question. + + ```py + from typing import Any, Union + + from typing_extensions import Annotated, Literal + + from pydantic import BaseModel, Discriminator, Tag + + class Pie(BaseModel): + time_to_cook: int + num_ingredients: int + + class ApplePie(Pie): + fruit: Literal['apple'] = 'apple' + + class PumpkinPie(Pie): + filling: Literal['pumpkin'] = 'pumpkin' + + def get_discriminator_value(v: Any) -> str: + if isinstance(v, dict): + return v.get('fruit', v.get('filling')) + return getattr(v, 'fruit', getattr(v, 'filling', None)) + + class ThanksgivingDinner(BaseModel): + dessert: Annotated[ + Union[ + Annotated[ApplePie, Tag('apple')], + Annotated[PumpkinPie, Tag('pumpkin')], + ], + Discriminator(get_discriminator_value), + ] + + apple_variation = ThanksgivingDinner.model_validate( + {'dessert': {'fruit': 'apple', 'time_to_cook': 60, 'num_ingredients': 8}} + ) + print(repr(apple_variation)) + ''' + ThanksgivingDinner(dessert=ApplePie(time_to_cook=60, num_ingredients=8, fruit='apple')) + ''' + + pumpkin_variation = ThanksgivingDinner.model_validate( + { + 'dessert': { + 'filling': 'pumpkin', + 'time_to_cook': 40, + 'num_ingredients': 6, + } + } + ) + print(repr(pumpkin_variation)) + ''' + ThanksgivingDinner(dessert=PumpkinPie(time_to_cook=40, num_ingredients=6, filling='pumpkin')) + ''' + ``` + + !!! note + You must specify a `Tag` for every case in a `Tag` that is associated with a + callable `Discriminator`. Failing to do so will result in a `PydanticUserError` with code + [`callable-discriminator-no-tag`](../errors/usage_errors.md#callable-discriminator-no-tag). + + See the [Discriminated Unions] concepts docs for more details on how to use `Tag`s. + + [Discriminated Unions]: ../concepts/unions.md#discriminated-unions + """ + + tag: str + + def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema: + schema = handler(source_type) + metadata = schema.setdefault('metadata', {}) + assert isinstance(metadata, dict) + metadata[_core_utils.TAGGED_UNION_TAG_KEY] = self.tag + return schema + + +@_dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True) +class Discriminator: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/unions/#discriminated-unions-with-callable-discriminator + + Provides a way to use a custom callable as the way to extract the value of a union discriminator. + + This allows you to get validation behavior like you'd get from `Field(discriminator=)`, + but without needing to have a single shared field across all the union choices. This also makes it + possible to handle unions of models and primitive types with discriminated-union-style validation errors. + Finally, this allows you to use a custom callable as the way to identify which member of a union a value + belongs to, while still seeing all the performance benefits of a discriminated union. + + Consider this example, which is much more performant with the use of `Discriminator` and thus a `TaggedUnion` + than it would be as a normal `Union`. + + ```py + from typing import Any, Union + + from typing_extensions import Annotated, Literal + + from pydantic import BaseModel, Discriminator, Tag + + class Pie(BaseModel): + time_to_cook: int + num_ingredients: int + + class ApplePie(Pie): + fruit: Literal['apple'] = 'apple' + + class PumpkinPie(Pie): + filling: Literal['pumpkin'] = 'pumpkin' + + def get_discriminator_value(v: Any) -> str: + if isinstance(v, dict): + return v.get('fruit', v.get('filling')) + return getattr(v, 'fruit', getattr(v, 'filling', None)) + + class ThanksgivingDinner(BaseModel): + dessert: Annotated[ + Union[ + Annotated[ApplePie, Tag('apple')], + Annotated[PumpkinPie, Tag('pumpkin')], + ], + Discriminator(get_discriminator_value), + ] + + apple_variation = ThanksgivingDinner.model_validate( + {'dessert': {'fruit': 'apple', 'time_to_cook': 60, 'num_ingredients': 8}} + ) + print(repr(apple_variation)) + ''' + ThanksgivingDinner(dessert=ApplePie(time_to_cook=60, num_ingredients=8, fruit='apple')) + ''' + + pumpkin_variation = ThanksgivingDinner.model_validate( + { + 'dessert': { + 'filling': 'pumpkin', + 'time_to_cook': 40, + 'num_ingredients': 6, + } + } + ) + print(repr(pumpkin_variation)) + ''' + ThanksgivingDinner(dessert=PumpkinPie(time_to_cook=40, num_ingredients=6, filling='pumpkin')) + ''' + ``` + + See the [Discriminated Unions] concepts docs for more details on how to use `Discriminator`s. + + [Discriminated Unions]: ../concepts/unions.md#discriminated-unions + """ + + discriminator: str | Callable[[Any], Hashable] + """The callable or field name for discriminating the type in a tagged union. + + A `Callable` discriminator must extract the value of the discriminator from the input. + A `str` discriminator must be the name of a field to discriminate against. + """ + custom_error_type: str | None = None + """Type to use in [custom errors](../errors/errors.md#custom-errors) replacing the standard discriminated union + validation errors. + """ + custom_error_message: str | None = None + """Message to use in custom errors.""" + custom_error_context: dict[str, int | str | float] | None = None + """Context to use in custom errors.""" + + def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema: + origin = _typing_extra.get_origin(source_type) + if not origin or not _typing_extra.origin_is_union(origin): + raise TypeError(f'{type(self).__name__} must be used with a Union type, not {source_type}') + + if isinstance(self.discriminator, str): + from pydantic import Field + + return handler(Annotated[source_type, Field(discriminator=self.discriminator)]) + else: + original_schema = handler(source_type) + return self._convert_schema(original_schema) + + def _convert_schema(self, original_schema: core_schema.CoreSchema) -> core_schema.TaggedUnionSchema: + if original_schema['type'] != 'union': + # This likely indicates that the schema was a single-item union that was simplified. + # In this case, we do the same thing we do in + # `pydantic._internal._discriminated_union._ApplyInferredDiscriminator._apply_to_root`, namely, + # package the generated schema back into a single-item union. + original_schema = core_schema.union_schema([original_schema]) + + tagged_union_choices = {} + for i, choice in enumerate(original_schema['choices']): + tag = None + if isinstance(choice, tuple): + choice, tag = choice + metadata = choice.get('metadata') + if metadata is not None: + metadata_tag = metadata.get(_core_utils.TAGGED_UNION_TAG_KEY) + if metadata_tag is not None: + tag = metadata_tag + if tag is None: + raise PydanticUserError( + f'`Tag` not provided for choice {choice} used with `Discriminator`', + code='callable-discriminator-no-tag', + ) + tagged_union_choices[tag] = choice + + # Have to do these verbose checks to ensure falsy values ('' and {}) don't get ignored + custom_error_type = self.custom_error_type + if custom_error_type is None: + custom_error_type = original_schema.get('custom_error_type') + + custom_error_message = self.custom_error_message + if custom_error_message is None: + custom_error_message = original_schema.get('custom_error_message') + + custom_error_context = self.custom_error_context + if custom_error_context is None: + custom_error_context = original_schema.get('custom_error_context') + + custom_error_type = original_schema.get('custom_error_type') if custom_error_type is None else custom_error_type + return core_schema.tagged_union_schema( + tagged_union_choices, + self.discriminator, + custom_error_type=custom_error_type, + custom_error_message=custom_error_message, + custom_error_context=custom_error_context, + strict=original_schema.get('strict'), + ref=original_schema.get('ref'), + metadata=original_schema.get('metadata'), + serialization=original_schema.get('serialization'), + ) + + +_JSON_TYPES = {int, float, str, bool, list, dict, type(None)} + + +def _get_type_name(x: Any) -> str: + type_ = type(x) + if type_ in _JSON_TYPES: + return type_.__name__ + + # Handle proper subclasses; note we don't need to handle None or bool here + if isinstance(x, int): + return 'int' + if isinstance(x, float): + return 'float' + if isinstance(x, str): + return 'str' + if isinstance(x, list): + return 'list' + if isinstance(x, dict): + return 'dict' + + # Fail by returning the type's actual name + return getattr(type_, '__name__', '') + + +class _AllowAnyJson: + @classmethod + def __get_pydantic_core_schema__(cls, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema: + python_schema = handler(source_type) + return core_schema.json_or_python_schema(json_schema=core_schema.any_schema(), python_schema=python_schema) + + +if TYPE_CHECKING: + # This seems to only be necessary for mypy + JsonValue: TypeAlias = Union[ + List['JsonValue'], + Dict[str, 'JsonValue'], + str, + bool, + int, + float, + None, + ] + """A `JsonValue` is used to represent a value that can be serialized to JSON. + + It may be one of: + + * `List['JsonValue']` + * `Dict[str, 'JsonValue']` + * `str` + * `bool` + * `int` + * `float` + * `None` + + The following example demonstrates how to use `JsonValue` to validate JSON data, + and what kind of errors to expect when input data is not json serializable. + + ```py + import json + + from pydantic import BaseModel, JsonValue, ValidationError + + class Model(BaseModel): + j: JsonValue + + valid_json_data = {'j': {'a': {'b': {'c': 1, 'd': [2, None]}}}} + invalid_json_data = {'j': {'a': {'b': ...}}} + + print(repr(Model.model_validate(valid_json_data))) + #> Model(j={'a': {'b': {'c': 1, 'd': [2, None]}}}) + print(repr(Model.model_validate_json(json.dumps(valid_json_data)))) + #> Model(j={'a': {'b': {'c': 1, 'd': [2, None]}}}) + + try: + Model.model_validate(invalid_json_data) + except ValidationError as e: + print(e) + ''' + 1 validation error for Model + j.dict.a.dict.b + input was not a valid JSON value [type=invalid-json-value, input_value=Ellipsis, input_type=ellipsis] + ''' + ``` + """ + +else: + JsonValue = TypeAliasType( + 'JsonValue', + Annotated[ + Union[ + Annotated[List['JsonValue'], Tag('list')], + Annotated[Dict[str, 'JsonValue'], Tag('dict')], + Annotated[str, Tag('str')], + Annotated[bool, Tag('bool')], + Annotated[int, Tag('int')], + Annotated[float, Tag('float')], + Annotated[None, Tag('NoneType')], + ], + Discriminator( + _get_type_name, + custom_error_type='invalid-json-value', + custom_error_message='input was not a valid JSON value', + ), + _AllowAnyJson, + ], + ) + + +class _OnErrorOmit: + @classmethod + def __get_pydantic_core_schema__(cls, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema: + # there is no actual default value here but we use with_default_schema since it already has the on_error + # behavior implemented and it would be no more efficient to implement it on every other validator + # or as a standalone validator + return core_schema.with_default_schema(schema=handler(source_type), on_error='omit') + + +OnErrorOmit = Annotated[T, _OnErrorOmit] +""" +When used as an item in a list, the key type in a dict, optional values of a TypedDict, etc. +this annotation omits the item from the iteration if there is any error validating it. +That is, instead of a [`ValidationError`][pydantic_core.ValidationError] being propagated up and the entire iterable being discarded +any invalid items are discarded and the valid ones are returned. +""" + + +@_dataclasses.dataclass +class FailFast(_fields.PydanticMetadata, BaseMetadata): + """A `FailFast` annotation can be used to specify that validation should stop at the first error. + + This can be useful when you want to validate a large amount of data and you only need to know if it's valid or not. + + You might want to enable this setting if you want to validate your data faster (basically, if you use this, + validation will be more performant with the caveat that you get less information). + + ```py + from typing import List + from typing_extensions import Annotated + from pydantic import BaseModel, FailFast, ValidationError + + class Model(BaseModel): + x: Annotated[List[int], FailFast()] + + # This will raise a single error for the first invalid value and stop validation + try: + obj = Model(x=[1, 2, 'a', 4, 5, 'b', 7, 8, 9, 'c']) + except ValidationError as e: + print(e) + ''' + 1 validation error for Model + x.2 + Input should be a valid integer, unable to parse string as an integer [type=int_parsing, input_value='a', input_type=str] + ''' + ``` + """ + + fail_fast: bool = True diff --git a/env/Lib/site-packages/pydantic/typing.py b/env/Lib/site-packages/pydantic/typing.py new file mode 100644 index 0000000..0bda22d --- /dev/null +++ b/env/Lib/site-packages/pydantic/typing.py @@ -0,0 +1,5 @@ +"""`typing` module is a backport module from V1.""" + +from ._migration import getattr_migration + +__getattr__ = getattr_migration(__name__) diff --git a/env/Lib/site-packages/pydantic/utils.py b/env/Lib/site-packages/pydantic/utils.py new file mode 100644 index 0000000..8d1e2a8 --- /dev/null +++ b/env/Lib/site-packages/pydantic/utils.py @@ -0,0 +1,5 @@ +"""The `utils` module is a backport module from V1.""" + +from ._migration import getattr_migration + +__getattr__ = getattr_migration(__name__) diff --git a/env/Lib/site-packages/pydantic/v1/__init__.py b/env/Lib/site-packages/pydantic/v1/__init__.py new file mode 100644 index 0000000..6ad3f46 --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/__init__.py @@ -0,0 +1,131 @@ +# flake8: noqa +from pydantic.v1 import dataclasses +from pydantic.v1.annotated_types import create_model_from_namedtuple, create_model_from_typeddict +from pydantic.v1.class_validators import root_validator, validator +from pydantic.v1.config import BaseConfig, ConfigDict, Extra +from pydantic.v1.decorator import validate_arguments +from pydantic.v1.env_settings import BaseSettings +from pydantic.v1.error_wrappers import ValidationError +from pydantic.v1.errors import * +from pydantic.v1.fields import Field, PrivateAttr, Required +from pydantic.v1.main import * +from pydantic.v1.networks import * +from pydantic.v1.parse import Protocol +from pydantic.v1.tools import * +from pydantic.v1.types import * +from pydantic.v1.version import VERSION, compiled + +__version__ = VERSION + +# WARNING __all__ from pydantic.errors is not included here, it will be removed as an export here in v2 +# please use "from pydantic.v1.errors import ..." instead +__all__ = [ + # annotated types utils + 'create_model_from_namedtuple', + 'create_model_from_typeddict', + # dataclasses + 'dataclasses', + # class_validators + 'root_validator', + 'validator', + # config + 'BaseConfig', + 'ConfigDict', + 'Extra', + # decorator + 'validate_arguments', + # env_settings + 'BaseSettings', + # error_wrappers + 'ValidationError', + # fields + 'Field', + 'Required', + # main + 'BaseModel', + 'create_model', + 'validate_model', + # network + 'AnyUrl', + 'AnyHttpUrl', + 'FileUrl', + 'HttpUrl', + 'stricturl', + 'EmailStr', + 'NameEmail', + 'IPvAnyAddress', + 'IPvAnyInterface', + 'IPvAnyNetwork', + 'PostgresDsn', + 'CockroachDsn', + 'AmqpDsn', + 'RedisDsn', + 'MongoDsn', + 'KafkaDsn', + 'validate_email', + # parse + 'Protocol', + # tools + 'parse_file_as', + 'parse_obj_as', + 'parse_raw_as', + 'schema_of', + 'schema_json_of', + # types + 'NoneStr', + 'NoneBytes', + 'StrBytes', + 'NoneStrBytes', + 'StrictStr', + 'ConstrainedBytes', + 'conbytes', + 'ConstrainedList', + 'conlist', + 'ConstrainedSet', + 'conset', + 'ConstrainedFrozenSet', + 'confrozenset', + 'ConstrainedStr', + 'constr', + 'PyObject', + 'ConstrainedInt', + 'conint', + 'PositiveInt', + 'NegativeInt', + 'NonNegativeInt', + 'NonPositiveInt', + 'ConstrainedFloat', + 'confloat', + 'PositiveFloat', + 'NegativeFloat', + 'NonNegativeFloat', + 'NonPositiveFloat', + 'FiniteFloat', + 'ConstrainedDecimal', + 'condecimal', + 'ConstrainedDate', + 'condate', + 'UUID1', + 'UUID3', + 'UUID4', + 'UUID5', + 'FilePath', + 'DirectoryPath', + 'Json', + 'JsonWrapper', + 'SecretField', + 'SecretStr', + 'SecretBytes', + 'StrictBool', + 'StrictBytes', + 'StrictInt', + 'StrictFloat', + 'PaymentCardNumber', + 'PrivateAttr', + 'ByteSize', + 'PastDate', + 'FutureDate', + # version + 'compiled', + 'VERSION', +] diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7856ad5b01429d676e62899d870319e9449ac819 GIT binary patch literal 2439 zcmZ`*OK%%D5a#-&l~$79X_}-?ngRt}pbm_tJ+wgq+p-b2iDJY}0xX0s=v_+Lm|Q9( zrBpcu{S!U()=SYJ(0@@BdlYyI&{J;#a?7bhQi^xoL>>?4NpXh5&;Gs9s3G|L`RiZZ zp96&cG0OBaGZ9|@4Z<%dL5W8Z^Fq%v@(i6}v*9e83+JppOXt}_xWFo5#p-j^XVtLE zYGI89VPI|Zw9Xn~!^#V^$ri&!D_7_eTMn14?9-JW%>Grn%GSa)wjQpt3*m){?*r@e z=|#KN=!fi5cxmFhJn>zzYd}9@8{r1K8ea7f*$A)oP*VTR3qMX8$7r+puPJWR(?Nn2 zjwzOs$jupjB^CrL5;2|-8g&I{QHB{w)Syp^zWjf$8udw%q_KkJrr=yfLrhcHlnY&b zD{ju}+Afx4k7wPqr)zF)L7JZ5|49i9Cs~<9lL(96fRRi|u+~l5F;ObbdPZM-=(bOJ zwl4%1VDdhL?dK0tLK7VviF61B>?kF)f1f-Zq=F<6L(CgCYuJKe6~lbPs)m_S5ili4)D3GGwrJQgFkLk#y=(fW>%~6l=G($- zSM|b9HhLhauEBa+slJgb2XG84Of6NZ1oUSBPJf@_lpaGx)izv))pXP4p>W{QX|j>**DCh8d%r_dNKRS!a2GSl@v9-j)1dDi3B z_C4;NVk4cELCkT)iYdC$$3l{*3#X5;)ODxwlP3jD;Acjw%J?y4M!c(=6Y+`Unb9k4 zo)K3c2)iRir1n8~QhnleS{3Zj7Zbe%VNBs1PRc;Oj*%NK6B>6S0GZ)W=ltH-+0g4Y-WG>oh|_Z{57 z4h(-JaKBH44vq=D9pxT#)hXtxCw6zsH8%pgoKtYvaVX7(ZLzbvx|Wad$N-cAP#ZaDiAVTT<;{0FRCsS*)4Iy$Y6GmMmHK%-YmaTY1hfsbAjz*^L_ zXr(We+y*+MXRhheB3b$Cp+j8AvaM?nRyxEp?Q^iVRNNPUA=7I`OXl!L>gA%v`Tw^hsW(F~a$~XpDCAchMN#%HL08bTcp07;Wce8l$iBGL6x-d`e^V zP5yowqm6t@V{|>A(inZ3muZZy=2I%m=g;Gg_p-VEB6#I9FPM1+|36Lni;DRX3cC0o Db>c~1 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/_hypothesis_plugin.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/_hypothesis_plugin.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..68d1914d29c41cc0166a54bcec72a8c39f4baf2b GIT binary patch literal 20240 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 Z+DjZTzsY9WtEk^r+1hKZzuiFt{J(fd*FXRO literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/annotated_types.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/annotated_types.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a7fe21821bd3a215f7671c66933b140c822ad37b GIT binary patch literal 4686 zcmcIoTWl2989rxcZ(d*4#x@uT&6E-+!(|s^7g1_x!9a1TZBo-BZ=HAlaK0cOoAQ>dfKt) zIqnWI9?|3V6*6JH6L@>|E?9X-yo?@XBI=-J@>whwP_CgEL(TxGiTj zn~hmIGu^f{XPU#*9JXMn&9GGmX6QPu+0)ok?E*_1nyFB?1sBzETP5&Bf}=fY1>&~X zW~yn^=5g!`bLJFzJ`KjK6`XRSLMU$zjLOB}T#%<&;CeEFlzH0IL=@CnZS<~}Ht~nN0 zXDw%%KxOYx~sob|DdPlW2HBz9ww(s(Wx!qBra8( zl!s>)$_qmU;sgC7Fn-}40ipInmnRhOgR0n55Fsr_)(x^5?^!MKJy3VU^Vc<=wK*EE zX^#+eVCUA`u-p66b`$CJ4k-J6P5E}b(MWor*@W*>2iL2X?Iz^kar}q}4qbYWER$8kU>YAt>%Lk+S_KcdTlkLWMZcHyPJ$7CoYA`oRwo~cFWj64g0s>@bhcIKFzF_@{_ zvXw!mS_IA{#PmrcpJwum=lF^GsBGlr%Ztt&tTC84A?p^iWpG&81`lU4FM=EA7%*il zp3@uy*tA)z=*U(98=5K4vqk%`*y1|yYlh8aEiW_9EiM}wIGAC}b6TOm^0xej&6qsr zI0gG;GC5n!Vl?2^35#cwhHV$w;E5B1LyC7~w@X!dH7lvOjjAsFe#$D!_MBBTb-4&z zRRvPnI}U6BC$gJmvmK^^f-*j1%FfDf-IVn;X$r%h6XW zlHXtFsMkaSS-SmywAR4Dml}(+jLFiD>_b~}+;aT7@Y`maV4QcuyLBAMujnlTkx1U^ zod&h8(3QY4#N;ylnY2K7!~qV!G%u0}d13qp{c!Qb;#P#a} zZQ6a`5uRH|19-Jy2xd_k4eYg8Q)k{5-70G86lY|kKm>ZeXY|U}FhwJAtv;}Iok_Oj{ zxT;n$4#Q7X-SC2D7MaauID{JlV9ePZZgIqoszMKduR(#Y{A<|TX^>~E@L$S{~c2xqj-Jnk; zDIWWr00AjmV$WhEx_9l=Mnow`lnM!lVxOezj=ZTHFDn-wDPs?nu?=OStV{^Ue~MA@ zITENPv6ciy!`x?K67R!(E^ptb5+ko2D<2rSF;)pQsafdyasObsf8jR&lV?PV*BK;pxFbVDTQ18&QJmuXnQ&>4rxW);81dVn-@+5(d? zRmd}NiLatKPk?sEn~aHJBC-|+Q#EJBR_HQq%u$e?S|K~_0~SCHoT3E0{6yy)VS^up zp{1kG$68&A2E?f4985R%5g-CC<|yJtjc#`LtkMq$A#7@0-mvi2CRxxig)DDCr7BCj zG5ZT*ZvR)WW-J~^z8?yOP8igZ_jQFrptqv zHK3*7o=VskZF5w8G|C>1vW?Mfc{D3z24)3$6_KREn4~(&eaTYm1U&1<@p}sL6}C#j z2~RJ(T*+Rvc`uxfqm_hHa&!QWILt9=@hA{?hyQCTu`rORY7qZD;C40+P55c|8rcM(@XH+XCZwiB$2v>jq~n%k+LDA;1WgiVzYKct{-`_I@*- z=I4L~6Qun<(27JU-6XLa;%}2&Ed4LfWAb{b`Pn2xr58P$K zejZEVvebPu`%v0flJ-@CG?b!uht^xmhlXJWH2%=zeg7kk(NOQ2jl;dSy^p9jkm%Rx z1by7SYpu21eV`J;Rs~>jMQku?|ug-bRms4S=e*;{+uMGeI literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/class_validators.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/class_validators.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b69820aa2f771c76c429928d4a170bb9dbb1dc1b GIT binary patch literal 22799 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/config.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/config.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..869dcaa40ec2a3a38d382e774022737d4ea280a0 GIT binary patch literal 10046 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 B51Rl0 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/datetime_parse.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/datetime_parse.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..98c7ea63e5b06a2d3d516fb25a17d24fc710144f GIT binary patch literal 11977 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�xWP*s-pLK1KTw62*y${^IlDoHj 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/env_settings.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/env_settings.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2afb759f105127891714add9641cdd61ec5848d3 GIT binary patch literal 20031 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 M!}*;MOr|pbKQ3}+SpWb4 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/fields.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/fields.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..74a8687cd97a9789f2ceb566f7c50c67cbcb1be7 GIT binary patch literal 62980 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 IP%OXy6BiZC^Z)<= literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/generics.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/generics.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..06a280093a2f96d2b867127b9c449e9018c951f1 GIT binary patch literal 19719 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 Y?N@5La}^lnq-@Td3q#avJaRewFC=ac+yDRo literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/json.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/json.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..be5810501e2e2ea837400d221fab47aa115a917e GIT binary patch literal 5688 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/mypy.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/mypy.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fa3ca635265bd4a7e5cd2eb445dc6466d0b936e5 GIT binary patch literal 50332 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 R?OssWrQ%;mIxZ7H{1e1+KqCME literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/networks.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/networks.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3a424feda9fe43d53e7d2fbbf24e4e96c1e6d5c1 GIT binary patch literal 34178 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 ylq%np;Jj&HB`5p@G literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/parse.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/parse.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a4a9ed569d5dcfc02cb8484e9d8bc662272f3977 GIT binary patch literal 3036 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/tools.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/tools.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..204a914e797c5189ec03ee0bc3446d462c23e203 GIT binary patch literal 4463 zcmc&%-ER|D7Qfds_ShbO+ez$%4?{wW7YL<COZ; zD6G5^4?I+>ykV(S$^**=fmXb%#N++}`!JEb(r6^4Nc*&JuGqftwCCKh6C1jfXr=DW zo#S)A&N=sY&pqenFX3>IK>6D@|Cm1^6Y?)?bV{<#ynN&#jWkFvS^zCZnz56x1hw;3$ z5kO`S%-r=OGv8^StY3QJ3@yiP* z^OI*zPX6}n^l3*pQCV{QlWM7?&Xsh>f4*iGs};56h!>Y?x+5XItTM-YsRI2u!SP>U zRkK>CmOy+})$;R2SQg=|VY2+(lBpY@&Oc+aPmq61ov2ncY9)0kuNrw1AFo3m5JxmlxV>IZ6S;fA`P8?&_~ zO|6*4!oiz|4w}_!$r!CIIYapcy`sZXJ&$OBBo0=-qLy`rS0aHbhk(?HEsuTs(b|#q zp+n7~LzX<&uHx8B7$!yHM;jfftp468-qzs=0vsDIY8TAd1P6EEg^z>t2Vf8!2yUcI z??7-{rgh0g@Y>}LHKh(uVAKRfoq{3q34CrbWDktL4(%NZy&mk>gn7?Xv3CtX?ww{R z0*nt8n2uPK5&2QrfU)vB4#gZsof2#(%7G+I`R6*dg3I7&{i2-q2>S}Ev`04|vm z_+c^JH=kzUX0zEW+XlZ*9AGzl5NA2)?}yL$5=fnFhzG3Rx*^3ZDg7dK@Lu4B+_zHv zb8=nY)0FqL2=(rNHaBZFJQ|9_l`FLYnPr)u1#6;__{pal*cV`ob5pM z^r9nx+ZQ^(;el*=>nUj5C%wM9?0HIiVY?#$sKPRR>go04>nMvC?#nC-JR1R$^YAUQ zJ;;kLI{R=CA##EoaqfEtS^`M9P%+GgoS+cnS3v6IMSS<_k!NSE_{4gAq8Xp4e`d>l z_l`9TOCDaAhnraUTjG9qx8kBXfAmz&2d7)Dn0m$JY8<~_De$}FcxxD4oDjsL>aBdO zShxYvCCKkPh8V*&QLI5MV+YZk_mCVy@;;KoKsK@TK?5C>JNE@(Uc-_ui{OmHvUk}B zn8NHQxPq5EeiK)<%Q9K^FH3+g^gY?^pCONh>73WqzGcj&9UO4LIt)@cY`K7o^%!<+ zE$Fr0^;0|!BLD=^=Y@MK!x+E``lxXNNS%D&Pvn&C5808V-M7n*XOJehx5AR_`;Gwl z50d)i_c0PmH@ppFt!T+d*X5&4`KToxZTsQeF9#d@HP{WnL~t|cR2^VGz>c2=ObVAG z`3Sx)U^2Ep@NLejjRSqFPELKvaESc&(>7K(6ubT zwpr-YmLSd-3vh*&vYnKoWvh@|vS8HX&h>YEuEb7!#QiZeyC*)fKI}$v35U?_AR@{i z{!`x8xU{B2;#rr+npi)yWQcE5&&%$wB~H1XmFP~|E^hw^$PmJx3K=^NyKVU9Kw(&ION954f*3Yq5Ig9FJqm&)MmuX9J}1GBVz1x0`rTN0)Htm z)Zj=M087O=CSuD6$sL{x3==uS5XLY`GYowUV+g~4a2UF!6Yox({L#fiILKoZ-pAe< z_-Zg%6#En1E87a=I3VTo;A)VZ_hL()hUdyD6^vy|{Ce=D?B*LpfZun=%Y(Ti&cWly zjcNS;a$n=9A>teYj^r!t!O?Fzn)h21Hx7y^q z_4ajxoUs0PwaGhHZ?(y&)mt}$N?qEBBv&RI>D93{;o+^IgPGJaRp=GG@{AI!!le+CDSYA`(5eMH(}l zf98Ka)O_zG=dI5#ZjE#9JArsIu)O8LwJG8a)lc7>{NvQ!sXA@>$QSf7Z4nPWutgeT zI${ROStPkwWPAIG^Kx&jC7 zq37u8nYF9U5!e$pteMMg=IVmW`~VG-Pv|Kw>q-x84CCZ0bS?dCUo$u1Hmt9H*Jku< LF7xA*-{=1VmW3UJ literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/types.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/types.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..becdb1ce2427e1156bd3c2423c98537045ee39b1 GIT binary patch literal 55095 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/typing.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/typing.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5449f69a2b257f8a6628fd8dfcd0ad0892f693c4 GIT binary patch literal 25273 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/__pycache__/utils.cpython-311.pyc b/env/Lib/site-packages/pydantic/v1/__pycache__/utils.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fa01e0a8ff428694e19af099cebe0a5c0f9d554f GIT binary patch literal 40726 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic/v1/_hypothesis_plugin.py b/env/Lib/site-packages/pydantic/v1/_hypothesis_plugin.py new file mode 100644 index 0000000..b62234d --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/_hypothesis_plugin.py @@ -0,0 +1,391 @@ +""" +Register Hypothesis strategies for Pydantic custom types. + +This enables fully-automatic generation of test data for most Pydantic classes. + +Note that this module has *no* runtime impact on Pydantic itself; instead it +is registered as a setuptools entry point and Hypothesis will import it if +Pydantic is installed. See also: + +https://hypothesis.readthedocs.io/en/latest/strategies.html#registering-strategies-via-setuptools-entry-points +https://hypothesis.readthedocs.io/en/latest/data.html#hypothesis.strategies.register_type_strategy +https://hypothesis.readthedocs.io/en/latest/strategies.html#interaction-with-pytest-cov +https://docs.pydantic.dev/usage/types/#pydantic-types + +Note that because our motivation is to *improve user experience*, the strategies +are always sound (never generate invalid data) but sacrifice completeness for +maintainability (ie may be unable to generate some tricky but valid data). + +Finally, this module makes liberal use of `# type: ignore[]` pragmas. +This is because Hypothesis annotates `register_type_strategy()` with +`(T, SearchStrategy[T])`, but in most cases we register e.g. `ConstrainedInt` +to generate instances of the builtin `int` type which match the constraints. +""" + +import contextlib +import datetime +import ipaddress +import json +import math +from fractions import Fraction +from typing import Callable, Dict, Type, Union, cast, overload + +import hypothesis.strategies as st + +import pydantic +import pydantic.color +import pydantic.types +from pydantic.v1.utils import lenient_issubclass + +# FilePath and DirectoryPath are explicitly unsupported, as we'd have to create +# them on-disk, and that's unsafe in general without being told *where* to do so. +# +# URLs are unsupported because it's easy for users to define their own strategy for +# "normal" URLs, and hard for us to define a general strategy which includes "weird" +# URLs but doesn't also have unpredictable performance problems. +# +# conlist() and conset() are unsupported for now, because the workarounds for +# Cython and Hypothesis to handle parametrized generic types are incompatible. +# We are rethinking Hypothesis compatibility in Pydantic v2. + +# Emails +try: + import email_validator +except ImportError: # pragma: no cover + pass +else: + + def is_valid_email(s: str) -> bool: + # Hypothesis' st.emails() occasionally generates emails like 0@A0--0.ac + # that are invalid according to email-validator, so we filter those out. + try: + email_validator.validate_email(s, check_deliverability=False) + return True + except email_validator.EmailNotValidError: # pragma: no cover + return False + + # Note that these strategies deliberately stay away from any tricky Unicode + # or other encoding issues; we're just trying to generate *something* valid. + st.register_type_strategy(pydantic.EmailStr, st.emails().filter(is_valid_email)) # type: ignore[arg-type] + st.register_type_strategy( + pydantic.NameEmail, + st.builds( + '{} <{}>'.format, # type: ignore[arg-type] + st.from_regex('[A-Za-z0-9_]+( [A-Za-z0-9_]+){0,5}', fullmatch=True), + st.emails().filter(is_valid_email), + ), + ) + +# PyObject - dotted names, in this case taken from the math module. +st.register_type_strategy( + pydantic.PyObject, # type: ignore[arg-type] + st.sampled_from( + [cast(pydantic.PyObject, f'math.{name}') for name in sorted(vars(math)) if not name.startswith('_')] + ), +) + +# CSS3 Colors; as name, hex, rgb(a) tuples or strings, or hsl strings +_color_regexes = ( + '|'.join( + ( + pydantic.color.r_hex_short, + pydantic.color.r_hex_long, + pydantic.color.r_rgb, + pydantic.color.r_rgba, + pydantic.color.r_hsl, + pydantic.color.r_hsla, + ) + ) + # Use more precise regex patterns to avoid value-out-of-range errors + .replace(pydantic.color._r_sl, r'(?:(\d\d?(?:\.\d+)?|100(?:\.0+)?)%)') + .replace(pydantic.color._r_alpha, r'(?:(0(?:\.\d+)?|1(?:\.0+)?|\.\d+|\d{1,2}%))') + .replace(pydantic.color._r_255, r'(?:((?:\d|\d\d|[01]\d\d|2[0-4]\d|25[0-4])(?:\.\d+)?|255(?:\.0+)?))') +) +st.register_type_strategy( + pydantic.color.Color, + st.one_of( + st.sampled_from(sorted(pydantic.color.COLORS_BY_NAME)), + st.tuples( + st.integers(0, 255), + st.integers(0, 255), + st.integers(0, 255), + st.none() | st.floats(0, 1) | st.floats(0, 100).map('{}%'.format), + ), + st.from_regex(_color_regexes, fullmatch=True), + ), +) + + +# Card numbers, valid according to the Luhn algorithm + + +def add_luhn_digit(card_number: str) -> str: + # See https://en.wikipedia.org/wiki/Luhn_algorithm + for digit in '0123456789': + with contextlib.suppress(Exception): + pydantic.PaymentCardNumber.validate_luhn_check_digit(card_number + digit) + return card_number + digit + raise AssertionError('Unreachable') # pragma: no cover + + +card_patterns = ( + # Note that these patterns omit the Luhn check digit; that's added by the function above + '4[0-9]{14}', # Visa + '5[12345][0-9]{13}', # Mastercard + '3[47][0-9]{12}', # American Express + '[0-26-9][0-9]{10,17}', # other (incomplete to avoid overlap) +) +st.register_type_strategy( + pydantic.PaymentCardNumber, + st.from_regex('|'.join(card_patterns), fullmatch=True).map(add_luhn_digit), # type: ignore[arg-type] +) + +# UUIDs +st.register_type_strategy(pydantic.UUID1, st.uuids(version=1)) +st.register_type_strategy(pydantic.UUID3, st.uuids(version=3)) +st.register_type_strategy(pydantic.UUID4, st.uuids(version=4)) +st.register_type_strategy(pydantic.UUID5, st.uuids(version=5)) + +# Secrets +st.register_type_strategy(pydantic.SecretBytes, st.binary().map(pydantic.SecretBytes)) +st.register_type_strategy(pydantic.SecretStr, st.text().map(pydantic.SecretStr)) + +# IP addresses, networks, and interfaces +st.register_type_strategy(pydantic.IPvAnyAddress, st.ip_addresses()) # type: ignore[arg-type] +st.register_type_strategy( + pydantic.IPvAnyInterface, + st.from_type(ipaddress.IPv4Interface) | st.from_type(ipaddress.IPv6Interface), # type: ignore[arg-type] +) +st.register_type_strategy( + pydantic.IPvAnyNetwork, + st.from_type(ipaddress.IPv4Network) | st.from_type(ipaddress.IPv6Network), # type: ignore[arg-type] +) + +# We hook into the con***() functions and the ConstrainedNumberMeta metaclass, +# so here we only have to register subclasses for other constrained types which +# don't go via those mechanisms. Then there are the registration hooks below. +st.register_type_strategy(pydantic.StrictBool, st.booleans()) +st.register_type_strategy(pydantic.StrictStr, st.text()) + + +# FutureDate, PastDate +st.register_type_strategy(pydantic.FutureDate, st.dates(min_value=datetime.date.today() + datetime.timedelta(days=1))) +st.register_type_strategy(pydantic.PastDate, st.dates(max_value=datetime.date.today() - datetime.timedelta(days=1))) + + +# Constrained-type resolver functions +# +# For these ones, we actually want to inspect the type in order to work out a +# satisfying strategy. First up, the machinery for tracking resolver functions: + +RESOLVERS: Dict[type, Callable[[type], st.SearchStrategy]] = {} # type: ignore[type-arg] + + +@overload +def _registered(typ: Type[pydantic.types.T]) -> Type[pydantic.types.T]: + pass + + +@overload +def _registered(typ: pydantic.types.ConstrainedNumberMeta) -> pydantic.types.ConstrainedNumberMeta: + pass + + +def _registered( + typ: Union[Type[pydantic.types.T], pydantic.types.ConstrainedNumberMeta] +) -> Union[Type[pydantic.types.T], pydantic.types.ConstrainedNumberMeta]: + # This function replaces the version in `pydantic.types`, in order to + # effect the registration of new constrained types so that Hypothesis + # can generate valid examples. + pydantic.types._DEFINED_TYPES.add(typ) + for supertype, resolver in RESOLVERS.items(): + if issubclass(typ, supertype): + st.register_type_strategy(typ, resolver(typ)) # type: ignore + return typ + raise NotImplementedError(f'Unknown type {typ!r} has no resolver to register') # pragma: no cover + + +def resolves( + typ: Union[type, pydantic.types.ConstrainedNumberMeta] +) -> Callable[[Callable[..., st.SearchStrategy]], Callable[..., st.SearchStrategy]]: # type: ignore[type-arg] + def inner(f): # type: ignore + assert f not in RESOLVERS + RESOLVERS[typ] = f + return f + + return inner + + +# Type-to-strategy resolver functions + + +@resolves(pydantic.JsonWrapper) +def resolve_json(cls): # type: ignore[no-untyped-def] + try: + inner = st.none() if cls.inner_type is None else st.from_type(cls.inner_type) + except Exception: # pragma: no cover + finite = st.floats(allow_infinity=False, allow_nan=False) + inner = st.recursive( + base=st.one_of(st.none(), st.booleans(), st.integers(), finite, st.text()), + extend=lambda x: st.lists(x) | st.dictionaries(st.text(), x), # type: ignore + ) + inner_type = getattr(cls, 'inner_type', None) + return st.builds( + cls.inner_type.json if lenient_issubclass(inner_type, pydantic.BaseModel) else json.dumps, + inner, + ensure_ascii=st.booleans(), + indent=st.none() | st.integers(0, 16), + sort_keys=st.booleans(), + ) + + +@resolves(pydantic.ConstrainedBytes) +def resolve_conbytes(cls): # type: ignore[no-untyped-def] # pragma: no cover + min_size = cls.min_length or 0 + max_size = cls.max_length + if not cls.strip_whitespace: + return st.binary(min_size=min_size, max_size=max_size) + # Fun with regex to ensure we neither start nor end with whitespace + repeats = '{{{},{}}}'.format( + min_size - 2 if min_size > 2 else 0, + max_size - 2 if (max_size or 0) > 2 else '', + ) + if min_size >= 2: + pattern = rf'\W.{repeats}\W' + elif min_size == 1: + pattern = rf'\W(.{repeats}\W)?' + else: + assert min_size == 0 + pattern = rf'(\W(.{repeats}\W)?)?' + return st.from_regex(pattern.encode(), fullmatch=True) + + +@resolves(pydantic.ConstrainedDecimal) +def resolve_condecimal(cls): # type: ignore[no-untyped-def] + min_value = cls.ge + max_value = cls.le + if cls.gt is not None: + assert min_value is None, 'Set `gt` or `ge`, but not both' + min_value = cls.gt + if cls.lt is not None: + assert max_value is None, 'Set `lt` or `le`, but not both' + max_value = cls.lt + s = st.decimals(min_value, max_value, allow_nan=False, places=cls.decimal_places) + if cls.lt is not None: + s = s.filter(lambda d: d < cls.lt) + if cls.gt is not None: + s = s.filter(lambda d: cls.gt < d) + return s + + +@resolves(pydantic.ConstrainedFloat) +def resolve_confloat(cls): # type: ignore[no-untyped-def] + min_value = cls.ge + max_value = cls.le + exclude_min = False + exclude_max = False + + if cls.gt is not None: + assert min_value is None, 'Set `gt` or `ge`, but not both' + min_value = cls.gt + exclude_min = True + if cls.lt is not None: + assert max_value is None, 'Set `lt` or `le`, but not both' + max_value = cls.lt + exclude_max = True + + if cls.multiple_of is None: + return st.floats(min_value, max_value, exclude_min=exclude_min, exclude_max=exclude_max, allow_nan=False) + + if min_value is not None: + min_value = math.ceil(min_value / cls.multiple_of) + if exclude_min: + min_value = min_value + 1 + if max_value is not None: + assert max_value >= cls.multiple_of, 'Cannot build model with max value smaller than multiple of' + max_value = math.floor(max_value / cls.multiple_of) + if exclude_max: + max_value = max_value - 1 + + return st.integers(min_value, max_value).map(lambda x: x * cls.multiple_of) + + +@resolves(pydantic.ConstrainedInt) +def resolve_conint(cls): # type: ignore[no-untyped-def] + min_value = cls.ge + max_value = cls.le + if cls.gt is not None: + assert min_value is None, 'Set `gt` or `ge`, but not both' + min_value = cls.gt + 1 + if cls.lt is not None: + assert max_value is None, 'Set `lt` or `le`, but not both' + max_value = cls.lt - 1 + + if cls.multiple_of is None or cls.multiple_of == 1: + return st.integers(min_value, max_value) + + # These adjustments and the .map handle integer-valued multiples, while the + # .filter handles trickier cases as for confloat. + if min_value is not None: + min_value = math.ceil(Fraction(min_value) / Fraction(cls.multiple_of)) + if max_value is not None: + max_value = math.floor(Fraction(max_value) / Fraction(cls.multiple_of)) + return st.integers(min_value, max_value).map(lambda x: x * cls.multiple_of) + + +@resolves(pydantic.ConstrainedDate) +def resolve_condate(cls): # type: ignore[no-untyped-def] + if cls.ge is not None: + assert cls.gt is None, 'Set `gt` or `ge`, but not both' + min_value = cls.ge + elif cls.gt is not None: + min_value = cls.gt + datetime.timedelta(days=1) + else: + min_value = datetime.date.min + if cls.le is not None: + assert cls.lt is None, 'Set `lt` or `le`, but not both' + max_value = cls.le + elif cls.lt is not None: + max_value = cls.lt - datetime.timedelta(days=1) + else: + max_value = datetime.date.max + return st.dates(min_value, max_value) + + +@resolves(pydantic.ConstrainedStr) +def resolve_constr(cls): # type: ignore[no-untyped-def] # pragma: no cover + min_size = cls.min_length or 0 + max_size = cls.max_length + + if cls.regex is None and not cls.strip_whitespace: + return st.text(min_size=min_size, max_size=max_size) + + if cls.regex is not None: + strategy = st.from_regex(cls.regex) + if cls.strip_whitespace: + strategy = strategy.filter(lambda s: s == s.strip()) + elif cls.strip_whitespace: + repeats = '{{{},{}}}'.format( + min_size - 2 if min_size > 2 else 0, + max_size - 2 if (max_size or 0) > 2 else '', + ) + if min_size >= 2: + strategy = st.from_regex(rf'\W.{repeats}\W') + elif min_size == 1: + strategy = st.from_regex(rf'\W(.{repeats}\W)?') + else: + assert min_size == 0 + strategy = st.from_regex(rf'(\W(.{repeats}\W)?)?') + + if min_size == 0 and max_size is None: + return strategy + elif max_size is None: + return strategy.filter(lambda s: min_size <= len(s)) + return strategy.filter(lambda s: min_size <= len(s) <= max_size) + + +# Finally, register all previously-defined types, and patch in our new function +for typ in list(pydantic.types._DEFINED_TYPES): + _registered(typ) +pydantic.types._registered = _registered +st.register_type_strategy(pydantic.Json, resolve_json) diff --git a/env/Lib/site-packages/pydantic/v1/annotated_types.py b/env/Lib/site-packages/pydantic/v1/annotated_types.py new file mode 100644 index 0000000..d9eaaaf --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/annotated_types.py @@ -0,0 +1,72 @@ +import sys +from typing import TYPE_CHECKING, Any, Dict, FrozenSet, NamedTuple, Type + +from pydantic.v1.fields import Required +from pydantic.v1.main import BaseModel, create_model +from pydantic.v1.typing import is_typeddict, is_typeddict_special + +if TYPE_CHECKING: + from typing_extensions import TypedDict + +if sys.version_info < (3, 11): + + def is_legacy_typeddict(typeddict_cls: Type['TypedDict']) -> bool: # type: ignore[valid-type] + return is_typeddict(typeddict_cls) and type(typeddict_cls).__module__ == 'typing' + +else: + + def is_legacy_typeddict(_: Any) -> Any: + return False + + +def create_model_from_typeddict( + # Mypy bug: `Type[TypedDict]` is resolved as `Any` https://github.com/python/mypy/issues/11030 + typeddict_cls: Type['TypedDict'], # type: ignore[valid-type] + **kwargs: Any, +) -> Type['BaseModel']: + """ + Create a `BaseModel` based on the fields of a `TypedDict`. + Since `typing.TypedDict` in Python 3.8 does not store runtime information about optional keys, + we raise an error if this happens (see https://bugs.python.org/issue38834). + """ + field_definitions: Dict[str, Any] + + # Best case scenario: with python 3.9+ or when `TypedDict` is imported from `typing_extensions` + if not hasattr(typeddict_cls, '__required_keys__'): + raise TypeError( + 'You should use `typing_extensions.TypedDict` instead of `typing.TypedDict` with Python < 3.9.2. ' + 'Without it, there is no way to differentiate required and optional fields when subclassed.' + ) + + if is_legacy_typeddict(typeddict_cls) and any( + is_typeddict_special(t) for t in typeddict_cls.__annotations__.values() + ): + raise TypeError( + 'You should use `typing_extensions.TypedDict` instead of `typing.TypedDict` with Python < 3.11. ' + 'Without it, there is no way to reflect Required/NotRequired keys.' + ) + + required_keys: FrozenSet[str] = typeddict_cls.__required_keys__ # type: ignore[attr-defined] + field_definitions = { + field_name: (field_type, Required if field_name in required_keys else None) + for field_name, field_type in typeddict_cls.__annotations__.items() + } + + return create_model(typeddict_cls.__name__, **kwargs, **field_definitions) + + +def create_model_from_namedtuple(namedtuple_cls: Type['NamedTuple'], **kwargs: Any) -> Type['BaseModel']: + """ + Create a `BaseModel` based on the fields of a named tuple. + A named tuple can be created with `typing.NamedTuple` and declared annotations + but also with `collections.namedtuple`, in this case we consider all fields + to have type `Any`. + """ + # With python 3.10+, `__annotations__` always exists but can be empty hence the `getattr... or...` logic + namedtuple_annotations: Dict[str, Type[Any]] = getattr(namedtuple_cls, '__annotations__', None) or { + k: Any for k in namedtuple_cls._fields + } + field_definitions: Dict[str, Any] = { + field_name: (field_type, Required) for field_name, field_type in namedtuple_annotations.items() + } + return create_model(namedtuple_cls.__name__, **kwargs, **field_definitions) diff --git a/env/Lib/site-packages/pydantic/v1/class_validators.py b/env/Lib/site-packages/pydantic/v1/class_validators.py new file mode 100644 index 0000000..2f68fc8 --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/class_validators.py @@ -0,0 +1,361 @@ +import warnings +from collections import ChainMap +from functools import partial, partialmethod, wraps +from itertools import chain +from types import FunctionType +from typing import TYPE_CHECKING, Any, Callable, Dict, Iterable, List, Optional, Set, Tuple, Type, Union, overload + +from pydantic.v1.errors import ConfigError +from pydantic.v1.typing import AnyCallable +from pydantic.v1.utils import ROOT_KEY, in_ipython + +if TYPE_CHECKING: + from pydantic.v1.typing import AnyClassMethod + + +class Validator: + __slots__ = 'func', 'pre', 'each_item', 'always', 'check_fields', 'skip_on_failure' + + def __init__( + self, + func: AnyCallable, + pre: bool = False, + each_item: bool = False, + always: bool = False, + check_fields: bool = False, + skip_on_failure: bool = False, + ): + self.func = func + self.pre = pre + self.each_item = each_item + self.always = always + self.check_fields = check_fields + self.skip_on_failure = skip_on_failure + + +if TYPE_CHECKING: + from inspect import Signature + + from pydantic.v1.config import BaseConfig + from pydantic.v1.fields import ModelField + from pydantic.v1.types import ModelOrDc + + ValidatorCallable = Callable[[Optional[ModelOrDc], Any, Dict[str, Any], ModelField, Type[BaseConfig]], Any] + ValidatorsList = List[ValidatorCallable] + ValidatorListDict = Dict[str, List[Validator]] + +_FUNCS: Set[str] = set() +VALIDATOR_CONFIG_KEY = '__validator_config__' +ROOT_VALIDATOR_CONFIG_KEY = '__root_validator_config__' + + +def validator( + *fields: str, + pre: bool = False, + each_item: bool = False, + always: bool = False, + check_fields: bool = True, + whole: Optional[bool] = None, + allow_reuse: bool = False, +) -> Callable[[AnyCallable], 'AnyClassMethod']: + """ + Decorate methods on the class indicating that they should be used to validate fields + :param fields: which field(s) the method should be called on + :param pre: whether or not this validator should be called before the standard validators (else after) + :param each_item: for complex objects (sets, lists etc.) whether to validate individual elements rather than the + whole object + :param always: whether this method and other validators should be called even if the value is missing + :param check_fields: whether to check that the fields actually exist on the model + :param allow_reuse: whether to track and raise an error if another validator refers to the decorated function + """ + if not fields: + raise ConfigError('validator with no fields specified') + elif isinstance(fields[0], FunctionType): + raise ConfigError( + "validators should be used with fields and keyword arguments, not bare. " # noqa: Q000 + "E.g. usage should be `@validator('', ...)`" + ) + elif not all(isinstance(field, str) for field in fields): + raise ConfigError( + "validator fields should be passed as separate string args. " # noqa: Q000 + "E.g. usage should be `@validator('', '', ...)`" + ) + + if whole is not None: + warnings.warn( + 'The "whole" keyword argument is deprecated, use "each_item" (inverse meaning, default False) instead', + DeprecationWarning, + ) + assert each_item is False, '"each_item" and "whole" conflict, remove "whole"' + each_item = not whole + + def dec(f: AnyCallable) -> 'AnyClassMethod': + f_cls = _prepare_validator(f, allow_reuse) + setattr( + f_cls, + VALIDATOR_CONFIG_KEY, + ( + fields, + Validator(func=f_cls.__func__, pre=pre, each_item=each_item, always=always, check_fields=check_fields), + ), + ) + return f_cls + + return dec + + +@overload +def root_validator(_func: AnyCallable) -> 'AnyClassMethod': + ... + + +@overload +def root_validator( + *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False +) -> Callable[[AnyCallable], 'AnyClassMethod']: + ... + + +def root_validator( + _func: Optional[AnyCallable] = None, *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False +) -> Union['AnyClassMethod', Callable[[AnyCallable], 'AnyClassMethod']]: + """ + Decorate methods on a model indicating that they should be used to validate (and perhaps modify) data either + before or after standard model parsing/validation is performed. + """ + if _func: + f_cls = _prepare_validator(_func, allow_reuse) + setattr( + f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure) + ) + return f_cls + + def dec(f: AnyCallable) -> 'AnyClassMethod': + f_cls = _prepare_validator(f, allow_reuse) + setattr( + f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure) + ) + return f_cls + + return dec + + +def _prepare_validator(function: AnyCallable, allow_reuse: bool) -> 'AnyClassMethod': + """ + Avoid validators with duplicated names since without this, validators can be overwritten silently + which generally isn't the intended behaviour, don't run in ipython (see #312) or if allow_reuse is False. + """ + f_cls = function if isinstance(function, classmethod) else classmethod(function) + if not in_ipython() and not allow_reuse: + ref = ( + getattr(f_cls.__func__, '__module__', '') + + '.' + + getattr(f_cls.__func__, '__qualname__', f'') + ) + if ref in _FUNCS: + raise ConfigError(f'duplicate validator function "{ref}"; if this is intended, set `allow_reuse=True`') + _FUNCS.add(ref) + return f_cls + + +class ValidatorGroup: + def __init__(self, validators: 'ValidatorListDict') -> None: + self.validators = validators + self.used_validators = {'*'} + + def get_validators(self, name: str) -> Optional[Dict[str, Validator]]: + self.used_validators.add(name) + validators = self.validators.get(name, []) + if name != ROOT_KEY: + validators += self.validators.get('*', []) + if validators: + return {getattr(v.func, '__name__', f''): v for v in validators} + else: + return None + + def check_for_unused(self) -> None: + unused_validators = set( + chain.from_iterable( + ( + getattr(v.func, '__name__', f'') + for v in self.validators[f] + if v.check_fields + ) + for f in (self.validators.keys() - self.used_validators) + ) + ) + if unused_validators: + fn = ', '.join(unused_validators) + raise ConfigError( + f"Validators defined with incorrect fields: {fn} " # noqa: Q000 + f"(use check_fields=False if you're inheriting from the model and intended this)" + ) + + +def extract_validators(namespace: Dict[str, Any]) -> Dict[str, List[Validator]]: + validators: Dict[str, List[Validator]] = {} + for var_name, value in namespace.items(): + validator_config = getattr(value, VALIDATOR_CONFIG_KEY, None) + if validator_config: + fields, v = validator_config + for field in fields: + if field in validators: + validators[field].append(v) + else: + validators[field] = [v] + return validators + + +def extract_root_validators(namespace: Dict[str, Any]) -> Tuple[List[AnyCallable], List[Tuple[bool, AnyCallable]]]: + from inspect import signature + + pre_validators: List[AnyCallable] = [] + post_validators: List[Tuple[bool, AnyCallable]] = [] + for name, value in namespace.items(): + validator_config: Optional[Validator] = getattr(value, ROOT_VALIDATOR_CONFIG_KEY, None) + if validator_config: + sig = signature(validator_config.func) + args = list(sig.parameters.keys()) + if args[0] == 'self': + raise ConfigError( + f'Invalid signature for root validator {name}: {sig}, "self" not permitted as first argument, ' + f'should be: (cls, values).' + ) + if len(args) != 2: + raise ConfigError(f'Invalid signature for root validator {name}: {sig}, should be: (cls, values).') + # check function signature + if validator_config.pre: + pre_validators.append(validator_config.func) + else: + post_validators.append((validator_config.skip_on_failure, validator_config.func)) + return pre_validators, post_validators + + +def inherit_validators(base_validators: 'ValidatorListDict', validators: 'ValidatorListDict') -> 'ValidatorListDict': + for field, field_validators in base_validators.items(): + if field not in validators: + validators[field] = [] + validators[field] += field_validators + return validators + + +def make_generic_validator(validator: AnyCallable) -> 'ValidatorCallable': + """ + Make a generic function which calls a validator with the right arguments. + + Unfortunately other approaches (eg. return a partial of a function that builds the arguments) is slow, + hence this laborious way of doing things. + + It's done like this so validators don't all need **kwargs in their signature, eg. any combination of + the arguments "values", "fields" and/or "config" are permitted. + """ + from inspect import signature + + if not isinstance(validator, (partial, partialmethod)): + # This should be the default case, so overhead is reduced + sig = signature(validator) + args = list(sig.parameters.keys()) + else: + # Fix the generated argument lists of partial methods + sig = signature(validator.func) + args = [ + k + for k in signature(validator.func).parameters.keys() + if k not in validator.args | validator.keywords.keys() + ] + + first_arg = args.pop(0) + if first_arg == 'self': + raise ConfigError( + f'Invalid signature for validator {validator}: {sig}, "self" not permitted as first argument, ' + f'should be: (cls, value, values, config, field), "values", "config" and "field" are all optional.' + ) + elif first_arg == 'cls': + # assume the second argument is value + return wraps(validator)(_generic_validator_cls(validator, sig, set(args[1:]))) + else: + # assume the first argument was value which has already been removed + return wraps(validator)(_generic_validator_basic(validator, sig, set(args))) + + +def prep_validators(v_funcs: Iterable[AnyCallable]) -> 'ValidatorsList': + return [make_generic_validator(f) for f in v_funcs if f] + + +all_kwargs = {'values', 'field', 'config'} + + +def _generic_validator_cls(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable': + # assume the first argument is value + has_kwargs = False + if 'kwargs' in args: + has_kwargs = True + args -= {'kwargs'} + + if not args.issubset(all_kwargs): + raise ConfigError( + f'Invalid signature for validator {validator}: {sig}, should be: ' + f'(cls, value, values, config, field), "values", "config" and "field" are all optional.' + ) + + if has_kwargs: + return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config) + elif args == set(): + return lambda cls, v, values, field, config: validator(cls, v) + elif args == {'values'}: + return lambda cls, v, values, field, config: validator(cls, v, values=values) + elif args == {'field'}: + return lambda cls, v, values, field, config: validator(cls, v, field=field) + elif args == {'config'}: + return lambda cls, v, values, field, config: validator(cls, v, config=config) + elif args == {'values', 'field'}: + return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field) + elif args == {'values', 'config'}: + return lambda cls, v, values, field, config: validator(cls, v, values=values, config=config) + elif args == {'field', 'config'}: + return lambda cls, v, values, field, config: validator(cls, v, field=field, config=config) + else: + # args == {'values', 'field', 'config'} + return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config) + + +def _generic_validator_basic(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable': + has_kwargs = False + if 'kwargs' in args: + has_kwargs = True + args -= {'kwargs'} + + if not args.issubset(all_kwargs): + raise ConfigError( + f'Invalid signature for validator {validator}: {sig}, should be: ' + f'(value, values, config, field), "values", "config" and "field" are all optional.' + ) + + if has_kwargs: + return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config) + elif args == set(): + return lambda cls, v, values, field, config: validator(v) + elif args == {'values'}: + return lambda cls, v, values, field, config: validator(v, values=values) + elif args == {'field'}: + return lambda cls, v, values, field, config: validator(v, field=field) + elif args == {'config'}: + return lambda cls, v, values, field, config: validator(v, config=config) + elif args == {'values', 'field'}: + return lambda cls, v, values, field, config: validator(v, values=values, field=field) + elif args == {'values', 'config'}: + return lambda cls, v, values, field, config: validator(v, values=values, config=config) + elif args == {'field', 'config'}: + return lambda cls, v, values, field, config: validator(v, field=field, config=config) + else: + # args == {'values', 'field', 'config'} + return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config) + + +def gather_all_validators(type_: 'ModelOrDc') -> Dict[str, 'AnyClassMethod']: + all_attributes = ChainMap(*[cls.__dict__ for cls in type_.__mro__]) # type: ignore[arg-type,var-annotated] + return { + k: v + for k, v in all_attributes.items() + if hasattr(v, VALIDATOR_CONFIG_KEY) or hasattr(v, ROOT_VALIDATOR_CONFIG_KEY) + } diff --git a/env/Lib/site-packages/pydantic/v1/color.py b/env/Lib/site-packages/pydantic/v1/color.py new file mode 100644 index 0000000..b0bbf78 --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/color.py @@ -0,0 +1,494 @@ +""" +Color definitions are used as per CSS3 specification: +http://www.w3.org/TR/css3-color/#svg-color + +A few colors have multiple names referring to the sames colors, eg. `grey` and `gray` or `aqua` and `cyan`. + +In these cases the LAST color when sorted alphabetically takes preferences, +eg. Color((0, 255, 255)).as_named() == 'cyan' because "cyan" comes after "aqua". +""" +import math +import re +from colorsys import hls_to_rgb, rgb_to_hls +from typing import TYPE_CHECKING, Any, Dict, Optional, Tuple, Union, cast + +from pydantic.v1.errors import ColorError +from pydantic.v1.utils import Representation, almost_equal_floats + +if TYPE_CHECKING: + from pydantic.v1.typing import CallableGenerator, ReprArgs + +ColorTuple = Union[Tuple[int, int, int], Tuple[int, int, int, float]] +ColorType = Union[ColorTuple, str] +HslColorTuple = Union[Tuple[float, float, float], Tuple[float, float, float, float]] + + +class RGBA: + """ + Internal use only as a representation of a color. + """ + + __slots__ = 'r', 'g', 'b', 'alpha', '_tuple' + + def __init__(self, r: float, g: float, b: float, alpha: Optional[float]): + self.r = r + self.g = g + self.b = b + self.alpha = alpha + + self._tuple: Tuple[float, float, float, Optional[float]] = (r, g, b, alpha) + + def __getitem__(self, item: Any) -> Any: + return self._tuple[item] + + +# these are not compiled here to avoid import slowdown, they'll be compiled the first time they're used, then cached +r_hex_short = r'\s*(?:#|0x)?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?\s*' +r_hex_long = r'\s*(?:#|0x)?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?\s*' +_r_255 = r'(\d{1,3}(?:\.\d+)?)' +_r_comma = r'\s*,\s*' +r_rgb = fr'\s*rgb\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}\)\s*' +_r_alpha = r'(\d(?:\.\d+)?|\.\d+|\d{1,2}%)' +r_rgba = fr'\s*rgba\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_alpha}\s*\)\s*' +_r_h = r'(-?\d+(?:\.\d+)?|-?\.\d+)(deg|rad|turn)?' +_r_sl = r'(\d{1,3}(?:\.\d+)?)%' +r_hsl = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}\s*\)\s*' +r_hsla = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}{_r_comma}{_r_alpha}\s*\)\s*' + +# colors where the two hex characters are the same, if all colors match this the short version of hex colors can be used +repeat_colors = {int(c * 2, 16) for c in '0123456789abcdef'} +rads = 2 * math.pi + + +class Color(Representation): + __slots__ = '_original', '_rgba' + + def __init__(self, value: ColorType) -> None: + self._rgba: RGBA + self._original: ColorType + if isinstance(value, (tuple, list)): + self._rgba = parse_tuple(value) + elif isinstance(value, str): + self._rgba = parse_str(value) + elif isinstance(value, Color): + self._rgba = value._rgba + value = value._original + else: + raise ColorError(reason='value must be a tuple, list or string') + + # if we've got here value must be a valid color + self._original = value + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='string', format='color') + + def original(self) -> ColorType: + """ + Original value passed to Color + """ + return self._original + + def as_named(self, *, fallback: bool = False) -> str: + if self._rgba.alpha is None: + rgb = cast(Tuple[int, int, int], self.as_rgb_tuple()) + try: + return COLORS_BY_VALUE[rgb] + except KeyError as e: + if fallback: + return self.as_hex() + else: + raise ValueError('no named color found, use fallback=True, as_hex() or as_rgb()') from e + else: + return self.as_hex() + + def as_hex(self) -> str: + """ + Hex string representing the color can be 3, 4, 6 or 8 characters depending on whether the string + a "short" representation of the color is possible and whether there's an alpha channel. + """ + values = [float_to_255(c) for c in self._rgba[:3]] + if self._rgba.alpha is not None: + values.append(float_to_255(self._rgba.alpha)) + + as_hex = ''.join(f'{v:02x}' for v in values) + if all(c in repeat_colors for c in values): + as_hex = ''.join(as_hex[c] for c in range(0, len(as_hex), 2)) + return '#' + as_hex + + def as_rgb(self) -> str: + """ + Color as an rgb(, , ) or rgba(, , , ) string. + """ + if self._rgba.alpha is None: + return f'rgb({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)})' + else: + return ( + f'rgba({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)}, ' + f'{round(self._alpha_float(), 2)})' + ) + + def as_rgb_tuple(self, *, alpha: Optional[bool] = None) -> ColorTuple: + """ + Color as an RGB or RGBA tuple; red, green and blue are in the range 0 to 255, alpha if included is + in the range 0 to 1. + + :param alpha: whether to include the alpha channel, options are + None - (default) include alpha only if it's set (e.g. not None) + True - always include alpha, + False - always omit alpha, + """ + r, g, b = (float_to_255(c) for c in self._rgba[:3]) + if alpha is None: + if self._rgba.alpha is None: + return r, g, b + else: + return r, g, b, self._alpha_float() + elif alpha: + return r, g, b, self._alpha_float() + else: + # alpha is False + return r, g, b + + def as_hsl(self) -> str: + """ + Color as an hsl(, , ) or hsl(, , , ) string. + """ + if self._rgba.alpha is None: + h, s, li = self.as_hsl_tuple(alpha=False) # type: ignore + return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%})' + else: + h, s, li, a = self.as_hsl_tuple(alpha=True) # type: ignore + return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%}, {round(a, 2)})' + + def as_hsl_tuple(self, *, alpha: Optional[bool] = None) -> HslColorTuple: + """ + Color as an HSL or HSLA tuple, e.g. hue, saturation, lightness and optionally alpha; all elements are in + the range 0 to 1. + + NOTE: this is HSL as used in HTML and most other places, not HLS as used in python's colorsys. + + :param alpha: whether to include the alpha channel, options are + None - (default) include alpha only if it's set (e.g. not None) + True - always include alpha, + False - always omit alpha, + """ + h, l, s = rgb_to_hls(self._rgba.r, self._rgba.g, self._rgba.b) + if alpha is None: + if self._rgba.alpha is None: + return h, s, l + else: + return h, s, l, self._alpha_float() + if alpha: + return h, s, l, self._alpha_float() + else: + # alpha is False + return h, s, l + + def _alpha_float(self) -> float: + return 1 if self._rgba.alpha is None else self._rgba.alpha + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls + + def __str__(self) -> str: + return self.as_named(fallback=True) + + def __repr_args__(self) -> 'ReprArgs': + return [(None, self.as_named(fallback=True))] + [('rgb', self.as_rgb_tuple())] # type: ignore + + def __eq__(self, other: Any) -> bool: + return isinstance(other, Color) and self.as_rgb_tuple() == other.as_rgb_tuple() + + def __hash__(self) -> int: + return hash(self.as_rgb_tuple()) + + +def parse_tuple(value: Tuple[Any, ...]) -> RGBA: + """ + Parse a tuple or list as a color. + """ + if len(value) == 3: + r, g, b = (parse_color_value(v) for v in value) + return RGBA(r, g, b, None) + elif len(value) == 4: + r, g, b = (parse_color_value(v) for v in value[:3]) + return RGBA(r, g, b, parse_float_alpha(value[3])) + else: + raise ColorError(reason='tuples must have length 3 or 4') + + +def parse_str(value: str) -> RGBA: + """ + Parse a string to an RGBA tuple, trying the following formats (in this order): + * named color, see COLORS_BY_NAME below + * hex short eg. `fff` (prefix can be `#`, `0x` or nothing) + * hex long eg. `ffffff` (prefix can be `#`, `0x` or nothing) + * `rgb(, , ) ` + * `rgba(, , , )` + """ + value_lower = value.lower() + try: + r, g, b = COLORS_BY_NAME[value_lower] + except KeyError: + pass + else: + return ints_to_rgba(r, g, b, None) + + m = re.fullmatch(r_hex_short, value_lower) + if m: + *rgb, a = m.groups() + r, g, b = (int(v * 2, 16) for v in rgb) + if a: + alpha: Optional[float] = int(a * 2, 16) / 255 + else: + alpha = None + return ints_to_rgba(r, g, b, alpha) + + m = re.fullmatch(r_hex_long, value_lower) + if m: + *rgb, a = m.groups() + r, g, b = (int(v, 16) for v in rgb) + if a: + alpha = int(a, 16) / 255 + else: + alpha = None + return ints_to_rgba(r, g, b, alpha) + + m = re.fullmatch(r_rgb, value_lower) + if m: + return ints_to_rgba(*m.groups(), None) # type: ignore + + m = re.fullmatch(r_rgba, value_lower) + if m: + return ints_to_rgba(*m.groups()) # type: ignore + + m = re.fullmatch(r_hsl, value_lower) + if m: + h, h_units, s, l_ = m.groups() + return parse_hsl(h, h_units, s, l_) + + m = re.fullmatch(r_hsla, value_lower) + if m: + h, h_units, s, l_, a = m.groups() + return parse_hsl(h, h_units, s, l_, parse_float_alpha(a)) + + raise ColorError(reason='string not recognised as a valid color') + + +def ints_to_rgba(r: Union[int, str], g: Union[int, str], b: Union[int, str], alpha: Optional[float]) -> RGBA: + return RGBA(parse_color_value(r), parse_color_value(g), parse_color_value(b), parse_float_alpha(alpha)) + + +def parse_color_value(value: Union[int, str], max_val: int = 255) -> float: + """ + Parse a value checking it's a valid int in the range 0 to max_val and divide by max_val to give a number + in the range 0 to 1 + """ + try: + color = float(value) + except ValueError: + raise ColorError(reason='color values must be a valid number') + if 0 <= color <= max_val: + return color / max_val + else: + raise ColorError(reason=f'color values must be in the range 0 to {max_val}') + + +def parse_float_alpha(value: Union[None, str, float, int]) -> Optional[float]: + """ + Parse a value checking it's a valid float in the range 0 to 1 + """ + if value is None: + return None + try: + if isinstance(value, str) and value.endswith('%'): + alpha = float(value[:-1]) / 100 + else: + alpha = float(value) + except ValueError: + raise ColorError(reason='alpha values must be a valid float') + + if almost_equal_floats(alpha, 1): + return None + elif 0 <= alpha <= 1: + return alpha + else: + raise ColorError(reason='alpha values must be in the range 0 to 1') + + +def parse_hsl(h: str, h_units: str, sat: str, light: str, alpha: Optional[float] = None) -> RGBA: + """ + Parse raw hue, saturation, lightness and alpha values and convert to RGBA. + """ + s_value, l_value = parse_color_value(sat, 100), parse_color_value(light, 100) + + h_value = float(h) + if h_units in {None, 'deg'}: + h_value = h_value % 360 / 360 + elif h_units == 'rad': + h_value = h_value % rads / rads + else: + # turns + h_value = h_value % 1 + + r, g, b = hls_to_rgb(h_value, l_value, s_value) + return RGBA(r, g, b, alpha) + + +def float_to_255(c: float) -> int: + return int(round(c * 255)) + + +COLORS_BY_NAME = { + 'aliceblue': (240, 248, 255), + 'antiquewhite': (250, 235, 215), + 'aqua': (0, 255, 255), + 'aquamarine': (127, 255, 212), + 'azure': (240, 255, 255), + 'beige': (245, 245, 220), + 'bisque': (255, 228, 196), + 'black': (0, 0, 0), + 'blanchedalmond': (255, 235, 205), + 'blue': (0, 0, 255), + 'blueviolet': (138, 43, 226), + 'brown': (165, 42, 42), + 'burlywood': (222, 184, 135), + 'cadetblue': (95, 158, 160), + 'chartreuse': (127, 255, 0), + 'chocolate': (210, 105, 30), + 'coral': (255, 127, 80), + 'cornflowerblue': (100, 149, 237), + 'cornsilk': (255, 248, 220), + 'crimson': (220, 20, 60), + 'cyan': (0, 255, 255), + 'darkblue': (0, 0, 139), + 'darkcyan': (0, 139, 139), + 'darkgoldenrod': (184, 134, 11), + 'darkgray': (169, 169, 169), + 'darkgreen': (0, 100, 0), + 'darkgrey': (169, 169, 169), + 'darkkhaki': (189, 183, 107), + 'darkmagenta': (139, 0, 139), + 'darkolivegreen': (85, 107, 47), + 'darkorange': (255, 140, 0), + 'darkorchid': (153, 50, 204), + 'darkred': (139, 0, 0), + 'darksalmon': (233, 150, 122), + 'darkseagreen': (143, 188, 143), + 'darkslateblue': (72, 61, 139), + 'darkslategray': (47, 79, 79), + 'darkslategrey': (47, 79, 79), + 'darkturquoise': (0, 206, 209), + 'darkviolet': (148, 0, 211), + 'deeppink': (255, 20, 147), + 'deepskyblue': (0, 191, 255), + 'dimgray': (105, 105, 105), + 'dimgrey': (105, 105, 105), + 'dodgerblue': (30, 144, 255), + 'firebrick': (178, 34, 34), + 'floralwhite': (255, 250, 240), + 'forestgreen': (34, 139, 34), + 'fuchsia': (255, 0, 255), + 'gainsboro': (220, 220, 220), + 'ghostwhite': (248, 248, 255), + 'gold': (255, 215, 0), + 'goldenrod': (218, 165, 32), + 'gray': (128, 128, 128), + 'green': (0, 128, 0), + 'greenyellow': (173, 255, 47), + 'grey': (128, 128, 128), + 'honeydew': (240, 255, 240), + 'hotpink': (255, 105, 180), + 'indianred': (205, 92, 92), + 'indigo': (75, 0, 130), + 'ivory': (255, 255, 240), + 'khaki': (240, 230, 140), + 'lavender': (230, 230, 250), + 'lavenderblush': (255, 240, 245), + 'lawngreen': (124, 252, 0), + 'lemonchiffon': (255, 250, 205), + 'lightblue': (173, 216, 230), + 'lightcoral': (240, 128, 128), + 'lightcyan': (224, 255, 255), + 'lightgoldenrodyellow': (250, 250, 210), + 'lightgray': (211, 211, 211), + 'lightgreen': (144, 238, 144), + 'lightgrey': (211, 211, 211), + 'lightpink': (255, 182, 193), + 'lightsalmon': (255, 160, 122), + 'lightseagreen': (32, 178, 170), + 'lightskyblue': (135, 206, 250), + 'lightslategray': (119, 136, 153), + 'lightslategrey': (119, 136, 153), + 'lightsteelblue': (176, 196, 222), + 'lightyellow': (255, 255, 224), + 'lime': (0, 255, 0), + 'limegreen': (50, 205, 50), + 'linen': (250, 240, 230), + 'magenta': (255, 0, 255), + 'maroon': (128, 0, 0), + 'mediumaquamarine': (102, 205, 170), + 'mediumblue': (0, 0, 205), + 'mediumorchid': (186, 85, 211), + 'mediumpurple': (147, 112, 219), + 'mediumseagreen': (60, 179, 113), + 'mediumslateblue': (123, 104, 238), + 'mediumspringgreen': (0, 250, 154), + 'mediumturquoise': (72, 209, 204), + 'mediumvioletred': (199, 21, 133), + 'midnightblue': (25, 25, 112), + 'mintcream': (245, 255, 250), + 'mistyrose': (255, 228, 225), + 'moccasin': (255, 228, 181), + 'navajowhite': (255, 222, 173), + 'navy': (0, 0, 128), + 'oldlace': (253, 245, 230), + 'olive': (128, 128, 0), + 'olivedrab': (107, 142, 35), + 'orange': (255, 165, 0), + 'orangered': (255, 69, 0), + 'orchid': (218, 112, 214), + 'palegoldenrod': (238, 232, 170), + 'palegreen': (152, 251, 152), + 'paleturquoise': (175, 238, 238), + 'palevioletred': (219, 112, 147), + 'papayawhip': (255, 239, 213), + 'peachpuff': (255, 218, 185), + 'peru': (205, 133, 63), + 'pink': (255, 192, 203), + 'plum': (221, 160, 221), + 'powderblue': (176, 224, 230), + 'purple': (128, 0, 128), + 'red': (255, 0, 0), + 'rosybrown': (188, 143, 143), + 'royalblue': (65, 105, 225), + 'saddlebrown': (139, 69, 19), + 'salmon': (250, 128, 114), + 'sandybrown': (244, 164, 96), + 'seagreen': (46, 139, 87), + 'seashell': (255, 245, 238), + 'sienna': (160, 82, 45), + 'silver': (192, 192, 192), + 'skyblue': (135, 206, 235), + 'slateblue': (106, 90, 205), + 'slategray': (112, 128, 144), + 'slategrey': (112, 128, 144), + 'snow': (255, 250, 250), + 'springgreen': (0, 255, 127), + 'steelblue': (70, 130, 180), + 'tan': (210, 180, 140), + 'teal': (0, 128, 128), + 'thistle': (216, 191, 216), + 'tomato': (255, 99, 71), + 'turquoise': (64, 224, 208), + 'violet': (238, 130, 238), + 'wheat': (245, 222, 179), + 'white': (255, 255, 255), + 'whitesmoke': (245, 245, 245), + 'yellow': (255, 255, 0), + 'yellowgreen': (154, 205, 50), +} + +COLORS_BY_VALUE = {v: k for k, v in COLORS_BY_NAME.items()} diff --git a/env/Lib/site-packages/pydantic/v1/dataclasses.py b/env/Lib/site-packages/pydantic/v1/dataclasses.py new file mode 100644 index 0000000..bd16702 --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/dataclasses.py @@ -0,0 +1,500 @@ +""" +The main purpose is to enhance stdlib dataclasses by adding validation +A pydantic dataclass can be generated from scratch or from a stdlib one. + +Behind the scene, a pydantic dataclass is just like a regular one on which we attach +a `BaseModel` and magic methods to trigger the validation of the data. +`__init__` and `__post_init__` are hence overridden and have extra logic to be +able to validate input data. + +When a pydantic dataclass is generated from scratch, it's just a plain dataclass +with validation triggered at initialization + +The tricky part if for stdlib dataclasses that are converted after into pydantic ones e.g. + +```py +@dataclasses.dataclass +class M: + x: int + +ValidatedM = pydantic.dataclasses.dataclass(M) +``` + +We indeed still want to support equality, hashing, repr, ... as if it was the stdlib one! + +```py +assert isinstance(ValidatedM(x=1), M) +assert ValidatedM(x=1) == M(x=1) +``` + +This means we **don't want to create a new dataclass that inherits from it** +The trick is to create a wrapper around `M` that will act as a proxy to trigger +validation without altering default `M` behaviour. +""" +import copy +import dataclasses +import sys +from contextlib import contextmanager +from functools import wraps + +try: + from functools import cached_property +except ImportError: + # cached_property available only for python3.8+ + pass + +from typing import TYPE_CHECKING, Any, Callable, ClassVar, Dict, Generator, Optional, Type, TypeVar, Union, overload + +from typing_extensions import dataclass_transform + +from pydantic.v1.class_validators import gather_all_validators +from pydantic.v1.config import BaseConfig, ConfigDict, Extra, get_config +from pydantic.v1.error_wrappers import ValidationError +from pydantic.v1.errors import DataclassTypeError +from pydantic.v1.fields import Field, FieldInfo, Required, Undefined +from pydantic.v1.main import create_model, validate_model +from pydantic.v1.utils import ClassAttribute + +if TYPE_CHECKING: + from pydantic.v1.main import BaseModel + from pydantic.v1.typing import CallableGenerator, NoArgAnyCallable + + DataclassT = TypeVar('DataclassT', bound='Dataclass') + + DataclassClassOrWrapper = Union[Type['Dataclass'], 'DataclassProxy'] + + class Dataclass: + # stdlib attributes + __dataclass_fields__: ClassVar[Dict[str, Any]] + __dataclass_params__: ClassVar[Any] # in reality `dataclasses._DataclassParams` + __post_init__: ClassVar[Callable[..., None]] + + # Added by pydantic + __pydantic_run_validation__: ClassVar[bool] + __post_init_post_parse__: ClassVar[Callable[..., None]] + __pydantic_initialised__: ClassVar[bool] + __pydantic_model__: ClassVar[Type[BaseModel]] + __pydantic_validate_values__: ClassVar[Callable[['Dataclass'], None]] + __pydantic_has_field_info_default__: ClassVar[bool] # whether a `pydantic.Field` is used as default value + + def __init__(self, *args: object, **kwargs: object) -> None: + pass + + @classmethod + def __get_validators__(cls: Type['Dataclass']) -> 'CallableGenerator': + pass + + @classmethod + def __validate__(cls: Type['DataclassT'], v: Any) -> 'DataclassT': + pass + + +__all__ = [ + 'dataclass', + 'set_validation', + 'create_pydantic_model_from_dataclass', + 'is_builtin_dataclass', + 'make_dataclass_validator', +] + +_T = TypeVar('_T') + +if sys.version_info >= (3, 10): + + @dataclass_transform(field_specifiers=(dataclasses.field, Field)) + @overload + def dataclass( + *, + init: bool = True, + repr: bool = True, + eq: bool = True, + order: bool = False, + unsafe_hash: bool = False, + frozen: bool = False, + config: Union[ConfigDict, Type[object], None] = None, + validate_on_init: Optional[bool] = None, + use_proxy: Optional[bool] = None, + kw_only: bool = ..., + ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']: + ... + + @dataclass_transform(field_specifiers=(dataclasses.field, Field)) + @overload + def dataclass( + _cls: Type[_T], + *, + init: bool = True, + repr: bool = True, + eq: bool = True, + order: bool = False, + unsafe_hash: bool = False, + frozen: bool = False, + config: Union[ConfigDict, Type[object], None] = None, + validate_on_init: Optional[bool] = None, + use_proxy: Optional[bool] = None, + kw_only: bool = ..., + ) -> 'DataclassClassOrWrapper': + ... + +else: + + @dataclass_transform(field_specifiers=(dataclasses.field, Field)) + @overload + def dataclass( + *, + init: bool = True, + repr: bool = True, + eq: bool = True, + order: bool = False, + unsafe_hash: bool = False, + frozen: bool = False, + config: Union[ConfigDict, Type[object], None] = None, + validate_on_init: Optional[bool] = None, + use_proxy: Optional[bool] = None, + ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']: + ... + + @dataclass_transform(field_specifiers=(dataclasses.field, Field)) + @overload + def dataclass( + _cls: Type[_T], + *, + init: bool = True, + repr: bool = True, + eq: bool = True, + order: bool = False, + unsafe_hash: bool = False, + frozen: bool = False, + config: Union[ConfigDict, Type[object], None] = None, + validate_on_init: Optional[bool] = None, + use_proxy: Optional[bool] = None, + ) -> 'DataclassClassOrWrapper': + ... + + +@dataclass_transform(field_specifiers=(dataclasses.field, Field)) +def dataclass( + _cls: Optional[Type[_T]] = None, + *, + init: bool = True, + repr: bool = True, + eq: bool = True, + order: bool = False, + unsafe_hash: bool = False, + frozen: bool = False, + config: Union[ConfigDict, Type[object], None] = None, + validate_on_init: Optional[bool] = None, + use_proxy: Optional[bool] = None, + kw_only: bool = False, +) -> Union[Callable[[Type[_T]], 'DataclassClassOrWrapper'], 'DataclassClassOrWrapper']: + """ + Like the python standard lib dataclasses but with type validation. + The result is either a pydantic dataclass that will validate input data + or a wrapper that will trigger validation around a stdlib dataclass + to avoid modifying it directly + """ + the_config = get_config(config) + + def wrap(cls: Type[Any]) -> 'DataclassClassOrWrapper': + should_use_proxy = ( + use_proxy + if use_proxy is not None + else ( + is_builtin_dataclass(cls) + and (cls.__bases__[0] is object or set(dir(cls)) == set(dir(cls.__bases__[0]))) + ) + ) + if should_use_proxy: + dc_cls_doc = '' + dc_cls = DataclassProxy(cls) + default_validate_on_init = False + else: + dc_cls_doc = cls.__doc__ or '' # needs to be done before generating dataclass + if sys.version_info >= (3, 10): + dc_cls = dataclasses.dataclass( + cls, + init=init, + repr=repr, + eq=eq, + order=order, + unsafe_hash=unsafe_hash, + frozen=frozen, + kw_only=kw_only, + ) + else: + dc_cls = dataclasses.dataclass( # type: ignore + cls, init=init, repr=repr, eq=eq, order=order, unsafe_hash=unsafe_hash, frozen=frozen + ) + default_validate_on_init = True + + should_validate_on_init = default_validate_on_init if validate_on_init is None else validate_on_init + _add_pydantic_validation_attributes(cls, the_config, should_validate_on_init, dc_cls_doc) + dc_cls.__pydantic_model__.__try_update_forward_refs__(**{cls.__name__: cls}) + return dc_cls + + if _cls is None: + return wrap + + return wrap(_cls) + + +@contextmanager +def set_validation(cls: Type['DataclassT'], value: bool) -> Generator[Type['DataclassT'], None, None]: + original_run_validation = cls.__pydantic_run_validation__ + try: + cls.__pydantic_run_validation__ = value + yield cls + finally: + cls.__pydantic_run_validation__ = original_run_validation + + +class DataclassProxy: + __slots__ = '__dataclass__' + + def __init__(self, dc_cls: Type['Dataclass']) -> None: + object.__setattr__(self, '__dataclass__', dc_cls) + + def __call__(self, *args: Any, **kwargs: Any) -> Any: + with set_validation(self.__dataclass__, True): + return self.__dataclass__(*args, **kwargs) + + def __getattr__(self, name: str) -> Any: + return getattr(self.__dataclass__, name) + + def __setattr__(self, __name: str, __value: Any) -> None: + return setattr(self.__dataclass__, __name, __value) + + def __instancecheck__(self, instance: Any) -> bool: + return isinstance(instance, self.__dataclass__) + + def __copy__(self) -> 'DataclassProxy': + return DataclassProxy(copy.copy(self.__dataclass__)) + + def __deepcopy__(self, memo: Any) -> 'DataclassProxy': + return DataclassProxy(copy.deepcopy(self.__dataclass__, memo)) + + +def _add_pydantic_validation_attributes( # noqa: C901 (ignore complexity) + dc_cls: Type['Dataclass'], + config: Type[BaseConfig], + validate_on_init: bool, + dc_cls_doc: str, +) -> None: + """ + We need to replace the right method. If no `__post_init__` has been set in the stdlib dataclass + it won't even exist (code is generated on the fly by `dataclasses`) + By default, we run validation after `__init__` or `__post_init__` if defined + """ + init = dc_cls.__init__ + + @wraps(init) + def handle_extra_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None: + if config.extra == Extra.ignore: + init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__}) + + elif config.extra == Extra.allow: + for k, v in kwargs.items(): + self.__dict__.setdefault(k, v) + init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__}) + + else: + init(self, *args, **kwargs) + + if hasattr(dc_cls, '__post_init__'): + try: + post_init = dc_cls.__post_init__.__wrapped__ # type: ignore[attr-defined] + except AttributeError: + post_init = dc_cls.__post_init__ + + @wraps(post_init) + def new_post_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None: + if config.post_init_call == 'before_validation': + post_init(self, *args, **kwargs) + + if self.__class__.__pydantic_run_validation__: + self.__pydantic_validate_values__() + if hasattr(self, '__post_init_post_parse__'): + self.__post_init_post_parse__(*args, **kwargs) + + if config.post_init_call == 'after_validation': + post_init(self, *args, **kwargs) + + setattr(dc_cls, '__init__', handle_extra_init) + setattr(dc_cls, '__post_init__', new_post_init) + + else: + + @wraps(init) + def new_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None: + handle_extra_init(self, *args, **kwargs) + + if self.__class__.__pydantic_run_validation__: + self.__pydantic_validate_values__() + + if hasattr(self, '__post_init_post_parse__'): + # We need to find again the initvars. To do that we use `__dataclass_fields__` instead of + # public method `dataclasses.fields` + + # get all initvars and their default values + initvars_and_values: Dict[str, Any] = {} + for i, f in enumerate(self.__class__.__dataclass_fields__.values()): + if f._field_type is dataclasses._FIELD_INITVAR: # type: ignore[attr-defined] + try: + # set arg value by default + initvars_and_values[f.name] = args[i] + except IndexError: + initvars_and_values[f.name] = kwargs.get(f.name, f.default) + + self.__post_init_post_parse__(**initvars_and_values) + + setattr(dc_cls, '__init__', new_init) + + setattr(dc_cls, '__pydantic_run_validation__', ClassAttribute('__pydantic_run_validation__', validate_on_init)) + setattr(dc_cls, '__pydantic_initialised__', False) + setattr(dc_cls, '__pydantic_model__', create_pydantic_model_from_dataclass(dc_cls, config, dc_cls_doc)) + setattr(dc_cls, '__pydantic_validate_values__', _dataclass_validate_values) + setattr(dc_cls, '__validate__', classmethod(_validate_dataclass)) + setattr(dc_cls, '__get_validators__', classmethod(_get_validators)) + + if dc_cls.__pydantic_model__.__config__.validate_assignment and not dc_cls.__dataclass_params__.frozen: + setattr(dc_cls, '__setattr__', _dataclass_validate_assignment_setattr) + + +def _get_validators(cls: 'DataclassClassOrWrapper') -> 'CallableGenerator': + yield cls.__validate__ + + +def _validate_dataclass(cls: Type['DataclassT'], v: Any) -> 'DataclassT': + with set_validation(cls, True): + if isinstance(v, cls): + v.__pydantic_validate_values__() + return v + elif isinstance(v, (list, tuple)): + return cls(*v) + elif isinstance(v, dict): + return cls(**v) + else: + raise DataclassTypeError(class_name=cls.__name__) + + +def create_pydantic_model_from_dataclass( + dc_cls: Type['Dataclass'], + config: Type[Any] = BaseConfig, + dc_cls_doc: Optional[str] = None, +) -> Type['BaseModel']: + field_definitions: Dict[str, Any] = {} + for field in dataclasses.fields(dc_cls): + default: Any = Undefined + default_factory: Optional['NoArgAnyCallable'] = None + field_info: FieldInfo + + if field.default is not dataclasses.MISSING: + default = field.default + elif field.default_factory is not dataclasses.MISSING: + default_factory = field.default_factory + else: + default = Required + + if isinstance(default, FieldInfo): + field_info = default + dc_cls.__pydantic_has_field_info_default__ = True + else: + field_info = Field(default=default, default_factory=default_factory, **field.metadata) + + field_definitions[field.name] = (field.type, field_info) + + validators = gather_all_validators(dc_cls) + model: Type['BaseModel'] = create_model( + dc_cls.__name__, + __config__=config, + __module__=dc_cls.__module__, + __validators__=validators, + __cls_kwargs__={'__resolve_forward_refs__': False}, + **field_definitions, + ) + model.__doc__ = dc_cls_doc if dc_cls_doc is not None else dc_cls.__doc__ or '' + return model + + +if sys.version_info >= (3, 8): + + def _is_field_cached_property(obj: 'Dataclass', k: str) -> bool: + return isinstance(getattr(type(obj), k, None), cached_property) + +else: + + def _is_field_cached_property(obj: 'Dataclass', k: str) -> bool: + return False + + +def _dataclass_validate_values(self: 'Dataclass') -> None: + # validation errors can occur if this function is called twice on an already initialised dataclass. + # for example if Extra.forbid is enabled, it would consider __pydantic_initialised__ an invalid extra property + if getattr(self, '__pydantic_initialised__'): + return + if getattr(self, '__pydantic_has_field_info_default__', False): + # We need to remove `FieldInfo` values since they are not valid as input + # It's ok to do that because they are obviously the default values! + input_data = { + k: v + for k, v in self.__dict__.items() + if not (isinstance(v, FieldInfo) or _is_field_cached_property(self, k)) + } + else: + input_data = {k: v for k, v in self.__dict__.items() if not _is_field_cached_property(self, k)} + d, _, validation_error = validate_model(self.__pydantic_model__, input_data, cls=self.__class__) + if validation_error: + raise validation_error + self.__dict__.update(d) + object.__setattr__(self, '__pydantic_initialised__', True) + + +def _dataclass_validate_assignment_setattr(self: 'Dataclass', name: str, value: Any) -> None: + if self.__pydantic_initialised__: + d = dict(self.__dict__) + d.pop(name, None) + known_field = self.__pydantic_model__.__fields__.get(name, None) + if known_field: + value, error_ = known_field.validate(value, d, loc=name, cls=self.__class__) + if error_: + raise ValidationError([error_], self.__class__) + + object.__setattr__(self, name, value) + + +def is_builtin_dataclass(_cls: Type[Any]) -> bool: + """ + Whether a class is a stdlib dataclass + (useful to discriminated a pydantic dataclass that is actually a wrapper around a stdlib dataclass) + + we check that + - `_cls` is a dataclass + - `_cls` is not a processed pydantic dataclass (with a basemodel attached) + - `_cls` is not a pydantic dataclass inheriting directly from a stdlib dataclass + e.g. + ``` + @dataclasses.dataclass + class A: + x: int + + @pydantic.dataclasses.dataclass + class B(A): + y: int + ``` + In this case, when we first check `B`, we make an extra check and look at the annotations ('y'), + which won't be a superset of all the dataclass fields (only the stdlib fields i.e. 'x') + """ + return ( + dataclasses.is_dataclass(_cls) + and not hasattr(_cls, '__pydantic_model__') + and set(_cls.__dataclass_fields__).issuperset(set(getattr(_cls, '__annotations__', {}))) + ) + + +def make_dataclass_validator(dc_cls: Type['Dataclass'], config: Type[BaseConfig]) -> 'CallableGenerator': + """ + Create a pydantic.dataclass from a builtin dataclass to add type validation + and yield the validators + It retrieves the parameters of the dataclass and forwards them to the newly created dataclass + """ + yield from _get_validators(dataclass(dc_cls, config=config, use_proxy=True)) diff --git a/env/Lib/site-packages/pydantic/v1/datetime_parse.py b/env/Lib/site-packages/pydantic/v1/datetime_parse.py new file mode 100644 index 0000000..a7598fc --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/datetime_parse.py @@ -0,0 +1,248 @@ +""" +Functions to parse datetime objects. + +We're using regular expressions rather than time.strptime because: +- They provide both validation and parsing. +- They're more flexible for datetimes. +- The date/datetime/time constructors produce friendlier error messages. + +Stolen from https://raw.githubusercontent.com/django/django/main/django/utils/dateparse.py at +9718fa2e8abe430c3526a9278dd976443d4ae3c6 + +Changed to: +* use standard python datetime types not django.utils.timezone +* raise ValueError when regex doesn't match rather than returning None +* support parsing unix timestamps for dates and datetimes +""" +import re +from datetime import date, datetime, time, timedelta, timezone +from typing import Dict, Optional, Type, Union + +from pydantic.v1 import errors + +date_expr = r'(?P\d{4})-(?P\d{1,2})-(?P\d{1,2})' +time_expr = ( + r'(?P\d{1,2}):(?P\d{1,2})' + r'(?::(?P\d{1,2})(?:\.(?P\d{1,6})\d{0,6})?)?' + r'(?PZ|[+-]\d{2}(?::?\d{2})?)?$' +) + +date_re = re.compile(f'{date_expr}$') +time_re = re.compile(time_expr) +datetime_re = re.compile(f'{date_expr}[T ]{time_expr}') + +standard_duration_re = re.compile( + r'^' + r'(?:(?P-?\d+) (days?, )?)?' + r'((?:(?P-?\d+):)(?=\d+:\d+))?' + r'(?:(?P-?\d+):)?' + r'(?P-?\d+)' + r'(?:\.(?P\d{1,6})\d{0,6})?' + r'$' +) + +# Support the sections of ISO 8601 date representation that are accepted by timedelta +iso8601_duration_re = re.compile( + r'^(?P[-+]?)' + r'P' + r'(?:(?P\d+(.\d+)?)D)?' + r'(?:T' + r'(?:(?P\d+(.\d+)?)H)?' + r'(?:(?P\d+(.\d+)?)M)?' + r'(?:(?P\d+(.\d+)?)S)?' + r')?' + r'$' +) + +EPOCH = datetime(1970, 1, 1) +# if greater than this, the number is in ms, if less than or equal it's in seconds +# (in seconds this is 11th October 2603, in ms it's 20th August 1970) +MS_WATERSHED = int(2e10) +# slightly more than datetime.max in ns - (datetime.max - EPOCH).total_seconds() * 1e9 +MAX_NUMBER = int(3e20) +StrBytesIntFloat = Union[str, bytes, int, float] + + +def get_numeric(value: StrBytesIntFloat, native_expected_type: str) -> Union[None, int, float]: + if isinstance(value, (int, float)): + return value + try: + return float(value) + except ValueError: + return None + except TypeError: + raise TypeError(f'invalid type; expected {native_expected_type}, string, bytes, int or float') + + +def from_unix_seconds(seconds: Union[int, float]) -> datetime: + if seconds > MAX_NUMBER: + return datetime.max + elif seconds < -MAX_NUMBER: + return datetime.min + + while abs(seconds) > MS_WATERSHED: + seconds /= 1000 + dt = EPOCH + timedelta(seconds=seconds) + return dt.replace(tzinfo=timezone.utc) + + +def _parse_timezone(value: Optional[str], error: Type[Exception]) -> Union[None, int, timezone]: + if value == 'Z': + return timezone.utc + elif value is not None: + offset_mins = int(value[-2:]) if len(value) > 3 else 0 + offset = 60 * int(value[1:3]) + offset_mins + if value[0] == '-': + offset = -offset + try: + return timezone(timedelta(minutes=offset)) + except ValueError: + raise error() + else: + return None + + +def parse_date(value: Union[date, StrBytesIntFloat]) -> date: + """ + Parse a date/int/float/string and return a datetime.date. + + Raise ValueError if the input is well formatted but not a valid date. + Raise ValueError if the input isn't well formatted. + """ + if isinstance(value, date): + if isinstance(value, datetime): + return value.date() + else: + return value + + number = get_numeric(value, 'date') + if number is not None: + return from_unix_seconds(number).date() + + if isinstance(value, bytes): + value = value.decode() + + match = date_re.match(value) # type: ignore + if match is None: + raise errors.DateError() + + kw = {k: int(v) for k, v in match.groupdict().items()} + + try: + return date(**kw) + except ValueError: + raise errors.DateError() + + +def parse_time(value: Union[time, StrBytesIntFloat]) -> time: + """ + Parse a time/string and return a datetime.time. + + Raise ValueError if the input is well formatted but not a valid time. + Raise ValueError if the input isn't well formatted, in particular if it contains an offset. + """ + if isinstance(value, time): + return value + + number = get_numeric(value, 'time') + if number is not None: + if number >= 86400: + # doesn't make sense since the time time loop back around to 0 + raise errors.TimeError() + return (datetime.min + timedelta(seconds=number)).time() + + if isinstance(value, bytes): + value = value.decode() + + match = time_re.match(value) # type: ignore + if match is None: + raise errors.TimeError() + + kw = match.groupdict() + if kw['microsecond']: + kw['microsecond'] = kw['microsecond'].ljust(6, '0') + + tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.TimeError) + kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None} + kw_['tzinfo'] = tzinfo + + try: + return time(**kw_) # type: ignore + except ValueError: + raise errors.TimeError() + + +def parse_datetime(value: Union[datetime, StrBytesIntFloat]) -> datetime: + """ + Parse a datetime/int/float/string and return a datetime.datetime. + + This function supports time zone offsets. When the input contains one, + the output uses a timezone with a fixed offset from UTC. + + Raise ValueError if the input is well formatted but not a valid datetime. + Raise ValueError if the input isn't well formatted. + """ + if isinstance(value, datetime): + return value + + number = get_numeric(value, 'datetime') + if number is not None: + return from_unix_seconds(number) + + if isinstance(value, bytes): + value = value.decode() + + match = datetime_re.match(value) # type: ignore + if match is None: + raise errors.DateTimeError() + + kw = match.groupdict() + if kw['microsecond']: + kw['microsecond'] = kw['microsecond'].ljust(6, '0') + + tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.DateTimeError) + kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None} + kw_['tzinfo'] = tzinfo + + try: + return datetime(**kw_) # type: ignore + except ValueError: + raise errors.DateTimeError() + + +def parse_duration(value: StrBytesIntFloat) -> timedelta: + """ + Parse a duration int/float/string and return a datetime.timedelta. + + The preferred format for durations in Django is '%d %H:%M:%S.%f'. + + Also supports ISO 8601 representation. + """ + if isinstance(value, timedelta): + return value + + if isinstance(value, (int, float)): + # below code requires a string + value = f'{value:f}' + elif isinstance(value, bytes): + value = value.decode() + + try: + match = standard_duration_re.match(value) or iso8601_duration_re.match(value) + except TypeError: + raise TypeError('invalid type; expected timedelta, string, bytes, int or float') + + if not match: + raise errors.DurationError() + + kw = match.groupdict() + sign = -1 if kw.pop('sign', '+') == '-' else 1 + if kw.get('microseconds'): + kw['microseconds'] = kw['microseconds'].ljust(6, '0') + + if kw.get('seconds') and kw.get('microseconds') and kw['seconds'].startswith('-'): + kw['microseconds'] = '-' + kw['microseconds'] + + kw_ = {k: float(v) for k, v in kw.items() if v is not None} + + return sign * timedelta(**kw_) diff --git a/env/Lib/site-packages/pydantic/v1/decorator.py b/env/Lib/site-packages/pydantic/v1/decorator.py new file mode 100644 index 0000000..2c7c2c2 --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/decorator.py @@ -0,0 +1,264 @@ +from functools import wraps +from typing import TYPE_CHECKING, Any, Callable, Dict, List, Mapping, Optional, Tuple, Type, TypeVar, Union, overload + +from pydantic.v1 import validator +from pydantic.v1.config import Extra +from pydantic.v1.errors import ConfigError +from pydantic.v1.main import BaseModel, create_model +from pydantic.v1.typing import get_all_type_hints +from pydantic.v1.utils import to_camel + +__all__ = ('validate_arguments',) + +if TYPE_CHECKING: + from pydantic.v1.typing import AnyCallable + + AnyCallableT = TypeVar('AnyCallableT', bound=AnyCallable) + ConfigType = Union[None, Type[Any], Dict[str, Any]] + + +@overload +def validate_arguments(func: None = None, *, config: 'ConfigType' = None) -> Callable[['AnyCallableT'], 'AnyCallableT']: + ... + + +@overload +def validate_arguments(func: 'AnyCallableT') -> 'AnyCallableT': + ... + + +def validate_arguments(func: Optional['AnyCallableT'] = None, *, config: 'ConfigType' = None) -> Any: + """ + Decorator to validate the arguments passed to a function. + """ + + def validate(_func: 'AnyCallable') -> 'AnyCallable': + vd = ValidatedFunction(_func, config) + + @wraps(_func) + def wrapper_function(*args: Any, **kwargs: Any) -> Any: + return vd.call(*args, **kwargs) + + wrapper_function.vd = vd # type: ignore + wrapper_function.validate = vd.init_model_instance # type: ignore + wrapper_function.raw_function = vd.raw_function # type: ignore + wrapper_function.model = vd.model # type: ignore + return wrapper_function + + if func: + return validate(func) + else: + return validate + + +ALT_V_ARGS = 'v__args' +ALT_V_KWARGS = 'v__kwargs' +V_POSITIONAL_ONLY_NAME = 'v__positional_only' +V_DUPLICATE_KWARGS = 'v__duplicate_kwargs' + + +class ValidatedFunction: + def __init__(self, function: 'AnyCallableT', config: 'ConfigType'): # noqa C901 + from inspect import Parameter, signature + + parameters: Mapping[str, Parameter] = signature(function).parameters + + if parameters.keys() & {ALT_V_ARGS, ALT_V_KWARGS, V_POSITIONAL_ONLY_NAME, V_DUPLICATE_KWARGS}: + raise ConfigError( + f'"{ALT_V_ARGS}", "{ALT_V_KWARGS}", "{V_POSITIONAL_ONLY_NAME}" and "{V_DUPLICATE_KWARGS}" ' + f'are not permitted as argument names when using the "{validate_arguments.__name__}" decorator' + ) + + self.raw_function = function + self.arg_mapping: Dict[int, str] = {} + self.positional_only_args = set() + self.v_args_name = 'args' + self.v_kwargs_name = 'kwargs' + + type_hints = get_all_type_hints(function) + takes_args = False + takes_kwargs = False + fields: Dict[str, Tuple[Any, Any]] = {} + for i, (name, p) in enumerate(parameters.items()): + if p.annotation is p.empty: + annotation = Any + else: + annotation = type_hints[name] + + default = ... if p.default is p.empty else p.default + if p.kind == Parameter.POSITIONAL_ONLY: + self.arg_mapping[i] = name + fields[name] = annotation, default + fields[V_POSITIONAL_ONLY_NAME] = List[str], None + self.positional_only_args.add(name) + elif p.kind == Parameter.POSITIONAL_OR_KEYWORD: + self.arg_mapping[i] = name + fields[name] = annotation, default + fields[V_DUPLICATE_KWARGS] = List[str], None + elif p.kind == Parameter.KEYWORD_ONLY: + fields[name] = annotation, default + elif p.kind == Parameter.VAR_POSITIONAL: + self.v_args_name = name + fields[name] = Tuple[annotation, ...], None + takes_args = True + else: + assert p.kind == Parameter.VAR_KEYWORD, p.kind + self.v_kwargs_name = name + fields[name] = Dict[str, annotation], None # type: ignore + takes_kwargs = True + + # these checks avoid a clash between "args" and a field with that name + if not takes_args and self.v_args_name in fields: + self.v_args_name = ALT_V_ARGS + + # same with "kwargs" + if not takes_kwargs and self.v_kwargs_name in fields: + self.v_kwargs_name = ALT_V_KWARGS + + if not takes_args: + # we add the field so validation below can raise the correct exception + fields[self.v_args_name] = List[Any], None + + if not takes_kwargs: + # same with kwargs + fields[self.v_kwargs_name] = Dict[Any, Any], None + + self.create_model(fields, takes_args, takes_kwargs, config) + + def init_model_instance(self, *args: Any, **kwargs: Any) -> BaseModel: + values = self.build_values(args, kwargs) + return self.model(**values) + + def call(self, *args: Any, **kwargs: Any) -> Any: + m = self.init_model_instance(*args, **kwargs) + return self.execute(m) + + def build_values(self, args: Tuple[Any, ...], kwargs: Dict[str, Any]) -> Dict[str, Any]: + values: Dict[str, Any] = {} + if args: + arg_iter = enumerate(args) + while True: + try: + i, a = next(arg_iter) + except StopIteration: + break + arg_name = self.arg_mapping.get(i) + if arg_name is not None: + values[arg_name] = a + else: + values[self.v_args_name] = [a] + [a for _, a in arg_iter] + break + + var_kwargs: Dict[str, Any] = {} + wrong_positional_args = [] + duplicate_kwargs = [] + fields_alias = [ + field.alias + for name, field in self.model.__fields__.items() + if name not in (self.v_args_name, self.v_kwargs_name) + ] + non_var_fields = set(self.model.__fields__) - {self.v_args_name, self.v_kwargs_name} + for k, v in kwargs.items(): + if k in non_var_fields or k in fields_alias: + if k in self.positional_only_args: + wrong_positional_args.append(k) + if k in values: + duplicate_kwargs.append(k) + values[k] = v + else: + var_kwargs[k] = v + + if var_kwargs: + values[self.v_kwargs_name] = var_kwargs + if wrong_positional_args: + values[V_POSITIONAL_ONLY_NAME] = wrong_positional_args + if duplicate_kwargs: + values[V_DUPLICATE_KWARGS] = duplicate_kwargs + return values + + def execute(self, m: BaseModel) -> Any: + d = {k: v for k, v in m._iter() if k in m.__fields_set__ or m.__fields__[k].default_factory} + var_kwargs = d.pop(self.v_kwargs_name, {}) + + if self.v_args_name in d: + args_: List[Any] = [] + in_kwargs = False + kwargs = {} + for name, value in d.items(): + if in_kwargs: + kwargs[name] = value + elif name == self.v_args_name: + args_ += value + in_kwargs = True + else: + args_.append(value) + return self.raw_function(*args_, **kwargs, **var_kwargs) + elif self.positional_only_args: + args_ = [] + kwargs = {} + for name, value in d.items(): + if name in self.positional_only_args: + args_.append(value) + else: + kwargs[name] = value + return self.raw_function(*args_, **kwargs, **var_kwargs) + else: + return self.raw_function(**d, **var_kwargs) + + def create_model(self, fields: Dict[str, Any], takes_args: bool, takes_kwargs: bool, config: 'ConfigType') -> None: + pos_args = len(self.arg_mapping) + + class CustomConfig: + pass + + if not TYPE_CHECKING: # pragma: no branch + if isinstance(config, dict): + CustomConfig = type('Config', (), config) # noqa: F811 + elif config is not None: + CustomConfig = config # noqa: F811 + + if hasattr(CustomConfig, 'fields') or hasattr(CustomConfig, 'alias_generator'): + raise ConfigError( + 'Setting the "fields" and "alias_generator" property on custom Config for ' + '@validate_arguments is not yet supported, please remove.' + ) + + class DecoratorBaseModel(BaseModel): + @validator(self.v_args_name, check_fields=False, allow_reuse=True) + def check_args(cls, v: Optional[List[Any]]) -> Optional[List[Any]]: + if takes_args or v is None: + return v + + raise TypeError(f'{pos_args} positional arguments expected but {pos_args + len(v)} given') + + @validator(self.v_kwargs_name, check_fields=False, allow_reuse=True) + def check_kwargs(cls, v: Optional[Dict[str, Any]]) -> Optional[Dict[str, Any]]: + if takes_kwargs or v is None: + return v + + plural = '' if len(v) == 1 else 's' + keys = ', '.join(map(repr, v.keys())) + raise TypeError(f'unexpected keyword argument{plural}: {keys}') + + @validator(V_POSITIONAL_ONLY_NAME, check_fields=False, allow_reuse=True) + def check_positional_only(cls, v: Optional[List[str]]) -> None: + if v is None: + return + + plural = '' if len(v) == 1 else 's' + keys = ', '.join(map(repr, v)) + raise TypeError(f'positional-only argument{plural} passed as keyword argument{plural}: {keys}') + + @validator(V_DUPLICATE_KWARGS, check_fields=False, allow_reuse=True) + def check_duplicate_kwargs(cls, v: Optional[List[str]]) -> None: + if v is None: + return + + plural = '' if len(v) == 1 else 's' + keys = ', '.join(map(repr, v)) + raise TypeError(f'multiple values for argument{plural}: {keys}') + + class Config(CustomConfig): + extra = getattr(CustomConfig, 'extra', Extra.forbid) + + self.model = create_model(to_camel(self.raw_function.__name__), __base__=DecoratorBaseModel, **fields) diff --git a/env/Lib/site-packages/pydantic/v1/env_settings.py b/env/Lib/site-packages/pydantic/v1/env_settings.py new file mode 100644 index 0000000..5f6f217 --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/env_settings.py @@ -0,0 +1,350 @@ +import os +import warnings +from pathlib import Path +from typing import AbstractSet, Any, Callable, ClassVar, Dict, List, Mapping, Optional, Tuple, Type, Union + +from pydantic.v1.config import BaseConfig, Extra +from pydantic.v1.fields import ModelField +from pydantic.v1.main import BaseModel +from pydantic.v1.types import JsonWrapper +from pydantic.v1.typing import StrPath, display_as_type, get_origin, is_union +from pydantic.v1.utils import deep_update, lenient_issubclass, path_type, sequence_like + +env_file_sentinel = str(object()) + +SettingsSourceCallable = Callable[['BaseSettings'], Dict[str, Any]] +DotenvType = Union[StrPath, List[StrPath], Tuple[StrPath, ...]] + + +class SettingsError(ValueError): + pass + + +class BaseSettings(BaseModel): + """ + Base class for settings, allowing values to be overridden by environment variables. + + This is useful in production for secrets you do not wish to save in code, it plays nicely with docker(-compose), + Heroku and any 12 factor app design. + """ + + def __init__( + __pydantic_self__, + _env_file: Optional[DotenvType] = env_file_sentinel, + _env_file_encoding: Optional[str] = None, + _env_nested_delimiter: Optional[str] = None, + _secrets_dir: Optional[StrPath] = None, + **values: Any, + ) -> None: + # Uses something other than `self` the first arg to allow "self" as a settable attribute + super().__init__( + **__pydantic_self__._build_values( + values, + _env_file=_env_file, + _env_file_encoding=_env_file_encoding, + _env_nested_delimiter=_env_nested_delimiter, + _secrets_dir=_secrets_dir, + ) + ) + + def _build_values( + self, + init_kwargs: Dict[str, Any], + _env_file: Optional[DotenvType] = None, + _env_file_encoding: Optional[str] = None, + _env_nested_delimiter: Optional[str] = None, + _secrets_dir: Optional[StrPath] = None, + ) -> Dict[str, Any]: + # Configure built-in sources + init_settings = InitSettingsSource(init_kwargs=init_kwargs) + env_settings = EnvSettingsSource( + env_file=(_env_file if _env_file != env_file_sentinel else self.__config__.env_file), + env_file_encoding=( + _env_file_encoding if _env_file_encoding is not None else self.__config__.env_file_encoding + ), + env_nested_delimiter=( + _env_nested_delimiter if _env_nested_delimiter is not None else self.__config__.env_nested_delimiter + ), + env_prefix_len=len(self.__config__.env_prefix), + ) + file_secret_settings = SecretsSettingsSource(secrets_dir=_secrets_dir or self.__config__.secrets_dir) + # Provide a hook to set built-in sources priority and add / remove sources + sources = self.__config__.customise_sources( + init_settings=init_settings, env_settings=env_settings, file_secret_settings=file_secret_settings + ) + if sources: + return deep_update(*reversed([source(self) for source in sources])) + else: + # no one should mean to do this, but I think returning an empty dict is marginally preferable + # to an informative error and much better than a confusing error + return {} + + class Config(BaseConfig): + env_prefix: str = '' + env_file: Optional[DotenvType] = None + env_file_encoding: Optional[str] = None + env_nested_delimiter: Optional[str] = None + secrets_dir: Optional[StrPath] = None + validate_all: bool = True + extra: Extra = Extra.forbid + arbitrary_types_allowed: bool = True + case_sensitive: bool = False + + @classmethod + def prepare_field(cls, field: ModelField) -> None: + env_names: Union[List[str], AbstractSet[str]] + field_info_from_config = cls.get_field_info(field.name) + + env = field_info_from_config.get('env') or field.field_info.extra.get('env') + if env is None: + if field.has_alias: + warnings.warn( + 'aliases are no longer used by BaseSettings to define which environment variables to read. ' + 'Instead use the "env" field setting. ' + 'See https://pydantic-docs.helpmanual.io/usage/settings/#environment-variable-names', + FutureWarning, + ) + env_names = {cls.env_prefix + field.name} + elif isinstance(env, str): + env_names = {env} + elif isinstance(env, (set, frozenset)): + env_names = env + elif sequence_like(env): + env_names = list(env) + else: + raise TypeError(f'invalid field env: {env!r} ({display_as_type(env)}); should be string, list or set') + + if not cls.case_sensitive: + env_names = env_names.__class__(n.lower() for n in env_names) + field.field_info.extra['env_names'] = env_names + + @classmethod + def customise_sources( + cls, + init_settings: SettingsSourceCallable, + env_settings: SettingsSourceCallable, + file_secret_settings: SettingsSourceCallable, + ) -> Tuple[SettingsSourceCallable, ...]: + return init_settings, env_settings, file_secret_settings + + @classmethod + def parse_env_var(cls, field_name: str, raw_val: str) -> Any: + return cls.json_loads(raw_val) + + # populated by the metaclass using the Config class defined above, annotated here to help IDEs only + __config__: ClassVar[Type[Config]] + + +class InitSettingsSource: + __slots__ = ('init_kwargs',) + + def __init__(self, init_kwargs: Dict[str, Any]): + self.init_kwargs = init_kwargs + + def __call__(self, settings: BaseSettings) -> Dict[str, Any]: + return self.init_kwargs + + def __repr__(self) -> str: + return f'InitSettingsSource(init_kwargs={self.init_kwargs!r})' + + +class EnvSettingsSource: + __slots__ = ('env_file', 'env_file_encoding', 'env_nested_delimiter', 'env_prefix_len') + + def __init__( + self, + env_file: Optional[DotenvType], + env_file_encoding: Optional[str], + env_nested_delimiter: Optional[str] = None, + env_prefix_len: int = 0, + ): + self.env_file: Optional[DotenvType] = env_file + self.env_file_encoding: Optional[str] = env_file_encoding + self.env_nested_delimiter: Optional[str] = env_nested_delimiter + self.env_prefix_len: int = env_prefix_len + + def __call__(self, settings: BaseSettings) -> Dict[str, Any]: # noqa C901 + """ + Build environment variables suitable for passing to the Model. + """ + d: Dict[str, Any] = {} + + if settings.__config__.case_sensitive: + env_vars: Mapping[str, Optional[str]] = os.environ + else: + env_vars = {k.lower(): v for k, v in os.environ.items()} + + dotenv_vars = self._read_env_files(settings.__config__.case_sensitive) + if dotenv_vars: + env_vars = {**dotenv_vars, **env_vars} + + for field in settings.__fields__.values(): + env_val: Optional[str] = None + for env_name in field.field_info.extra['env_names']: + env_val = env_vars.get(env_name) + if env_val is not None: + break + + is_complex, allow_parse_failure = self.field_is_complex(field) + if is_complex: + if env_val is None: + # field is complex but no value found so far, try explode_env_vars + env_val_built = self.explode_env_vars(field, env_vars) + if env_val_built: + d[field.alias] = env_val_built + else: + # field is complex and there's a value, decode that as JSON, then add explode_env_vars + try: + env_val = settings.__config__.parse_env_var(field.name, env_val) + except ValueError as e: + if not allow_parse_failure: + raise SettingsError(f'error parsing env var "{env_name}"') from e + + if isinstance(env_val, dict): + d[field.alias] = deep_update(env_val, self.explode_env_vars(field, env_vars)) + else: + d[field.alias] = env_val + elif env_val is not None: + # simplest case, field is not complex, we only need to add the value if it was found + d[field.alias] = env_val + + return d + + def _read_env_files(self, case_sensitive: bool) -> Dict[str, Optional[str]]: + env_files = self.env_file + if env_files is None: + return {} + + if isinstance(env_files, (str, os.PathLike)): + env_files = [env_files] + + dotenv_vars = {} + for env_file in env_files: + env_path = Path(env_file).expanduser() + if env_path.is_file(): + dotenv_vars.update( + read_env_file(env_path, encoding=self.env_file_encoding, case_sensitive=case_sensitive) + ) + + return dotenv_vars + + def field_is_complex(self, field: ModelField) -> Tuple[bool, bool]: + """ + Find out if a field is complex, and if so whether JSON errors should be ignored + """ + if lenient_issubclass(field.annotation, JsonWrapper): + return False, False + + if field.is_complex(): + allow_parse_failure = False + elif is_union(get_origin(field.type_)) and field.sub_fields and any(f.is_complex() for f in field.sub_fields): + allow_parse_failure = True + else: + return False, False + + return True, allow_parse_failure + + def explode_env_vars(self, field: ModelField, env_vars: Mapping[str, Optional[str]]) -> Dict[str, Any]: + """ + Process env_vars and extract the values of keys containing env_nested_delimiter into nested dictionaries. + + This is applied to a single field, hence filtering by env_var prefix. + """ + prefixes = [f'{env_name}{self.env_nested_delimiter}' for env_name in field.field_info.extra['env_names']] + result: Dict[str, Any] = {} + for env_name, env_val in env_vars.items(): + if not any(env_name.startswith(prefix) for prefix in prefixes): + continue + # we remove the prefix before splitting in case the prefix has characters in common with the delimiter + env_name_without_prefix = env_name[self.env_prefix_len :] + _, *keys, last_key = env_name_without_prefix.split(self.env_nested_delimiter) + env_var = result + for key in keys: + env_var = env_var.setdefault(key, {}) + env_var[last_key] = env_val + + return result + + def __repr__(self) -> str: + return ( + f'EnvSettingsSource(env_file={self.env_file!r}, env_file_encoding={self.env_file_encoding!r}, ' + f'env_nested_delimiter={self.env_nested_delimiter!r})' + ) + + +class SecretsSettingsSource: + __slots__ = ('secrets_dir',) + + def __init__(self, secrets_dir: Optional[StrPath]): + self.secrets_dir: Optional[StrPath] = secrets_dir + + def __call__(self, settings: BaseSettings) -> Dict[str, Any]: + """ + Build fields from "secrets" files. + """ + secrets: Dict[str, Optional[str]] = {} + + if self.secrets_dir is None: + return secrets + + secrets_path = Path(self.secrets_dir).expanduser() + + if not secrets_path.exists(): + warnings.warn(f'directory "{secrets_path}" does not exist') + return secrets + + if not secrets_path.is_dir(): + raise SettingsError(f'secrets_dir must reference a directory, not a {path_type(secrets_path)}') + + for field in settings.__fields__.values(): + for env_name in field.field_info.extra['env_names']: + path = find_case_path(secrets_path, env_name, settings.__config__.case_sensitive) + if not path: + # path does not exist, we currently don't return a warning for this + continue + + if path.is_file(): + secret_value = path.read_text().strip() + if field.is_complex(): + try: + secret_value = settings.__config__.parse_env_var(field.name, secret_value) + except ValueError as e: + raise SettingsError(f'error parsing env var "{env_name}"') from e + + secrets[field.alias] = secret_value + else: + warnings.warn( + f'attempted to load secret file "{path}" but found a {path_type(path)} instead.', + stacklevel=4, + ) + return secrets + + def __repr__(self) -> str: + return f'SecretsSettingsSource(secrets_dir={self.secrets_dir!r})' + + +def read_env_file( + file_path: StrPath, *, encoding: str = None, case_sensitive: bool = False +) -> Dict[str, Optional[str]]: + try: + from dotenv import dotenv_values + except ImportError as e: + raise ImportError('python-dotenv is not installed, run `pip install pydantic[dotenv]`') from e + + file_vars: Dict[str, Optional[str]] = dotenv_values(file_path, encoding=encoding or 'utf8') + if not case_sensitive: + return {k.lower(): v for k, v in file_vars.items()} + else: + return file_vars + + +def find_case_path(dir_path: Path, file_name: str, case_sensitive: bool) -> Optional[Path]: + """ + Find a file within path's directory matching filename, optionally ignoring case. + """ + for f in dir_path.iterdir(): + if f.name == file_name: + return f + elif not case_sensitive and f.name.lower() == file_name.lower(): + return f + return None diff --git a/env/Lib/site-packages/pydantic/v1/error_wrappers.py b/env/Lib/site-packages/pydantic/v1/error_wrappers.py new file mode 100644 index 0000000..bc7f263 --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/error_wrappers.py @@ -0,0 +1,161 @@ +import json +from typing import TYPE_CHECKING, Any, Dict, Generator, List, Optional, Sequence, Tuple, Type, Union + +from pydantic.v1.json import pydantic_encoder +from pydantic.v1.utils import Representation + +if TYPE_CHECKING: + from typing_extensions import TypedDict + + from pydantic.v1.config import BaseConfig + from pydantic.v1.types import ModelOrDc + from pydantic.v1.typing import ReprArgs + + Loc = Tuple[Union[int, str], ...] + + class _ErrorDictRequired(TypedDict): + loc: Loc + msg: str + type: str + + class ErrorDict(_ErrorDictRequired, total=False): + ctx: Dict[str, Any] + + +__all__ = 'ErrorWrapper', 'ValidationError' + + +class ErrorWrapper(Representation): + __slots__ = 'exc', '_loc' + + def __init__(self, exc: Exception, loc: Union[str, 'Loc']) -> None: + self.exc = exc + self._loc = loc + + def loc_tuple(self) -> 'Loc': + if isinstance(self._loc, tuple): + return self._loc + else: + return (self._loc,) + + def __repr_args__(self) -> 'ReprArgs': + return [('exc', self.exc), ('loc', self.loc_tuple())] + + +# ErrorList is something like Union[List[Union[List[ErrorWrapper], ErrorWrapper]], ErrorWrapper] +# but recursive, therefore just use: +ErrorList = Union[Sequence[Any], ErrorWrapper] + + +class ValidationError(Representation, ValueError): + __slots__ = 'raw_errors', 'model', '_error_cache' + + def __init__(self, errors: Sequence[ErrorList], model: 'ModelOrDc') -> None: + self.raw_errors = errors + self.model = model + self._error_cache: Optional[List['ErrorDict']] = None + + def errors(self) -> List['ErrorDict']: + if self._error_cache is None: + try: + config = self.model.__config__ # type: ignore + except AttributeError: + config = self.model.__pydantic_model__.__config__ # type: ignore + self._error_cache = list(flatten_errors(self.raw_errors, config)) + return self._error_cache + + def json(self, *, indent: Union[None, int, str] = 2) -> str: + return json.dumps(self.errors(), indent=indent, default=pydantic_encoder) + + def __str__(self) -> str: + errors = self.errors() + no_errors = len(errors) + return ( + f'{no_errors} validation error{"" if no_errors == 1 else "s"} for {self.model.__name__}\n' + f'{display_errors(errors)}' + ) + + def __repr_args__(self) -> 'ReprArgs': + return [('model', self.model.__name__), ('errors', self.errors())] + + +def display_errors(errors: List['ErrorDict']) -> str: + return '\n'.join(f'{_display_error_loc(e)}\n {e["msg"]} ({_display_error_type_and_ctx(e)})' for e in errors) + + +def _display_error_loc(error: 'ErrorDict') -> str: + return ' -> '.join(str(e) for e in error['loc']) + + +def _display_error_type_and_ctx(error: 'ErrorDict') -> str: + t = 'type=' + error['type'] + ctx = error.get('ctx') + if ctx: + return t + ''.join(f'; {k}={v}' for k, v in ctx.items()) + else: + return t + + +def flatten_errors( + errors: Sequence[Any], config: Type['BaseConfig'], loc: Optional['Loc'] = None +) -> Generator['ErrorDict', None, None]: + for error in errors: + if isinstance(error, ErrorWrapper): + if loc: + error_loc = loc + error.loc_tuple() + else: + error_loc = error.loc_tuple() + + if isinstance(error.exc, ValidationError): + yield from flatten_errors(error.exc.raw_errors, config, error_loc) + else: + yield error_dict(error.exc, config, error_loc) + elif isinstance(error, list): + yield from flatten_errors(error, config, loc=loc) + else: + raise RuntimeError(f'Unknown error object: {error}') + + +def error_dict(exc: Exception, config: Type['BaseConfig'], loc: 'Loc') -> 'ErrorDict': + type_ = get_exc_type(exc.__class__) + msg_template = config.error_msg_templates.get(type_) or getattr(exc, 'msg_template', None) + ctx = exc.__dict__ + if msg_template: + msg = msg_template.format(**ctx) + else: + msg = str(exc) + + d: 'ErrorDict' = {'loc': loc, 'msg': msg, 'type': type_} + + if ctx: + d['ctx'] = ctx + + return d + + +_EXC_TYPE_CACHE: Dict[Type[Exception], str] = {} + + +def get_exc_type(cls: Type[Exception]) -> str: + # slightly more efficient than using lru_cache since we don't need to worry about the cache filling up + try: + return _EXC_TYPE_CACHE[cls] + except KeyError: + r = _get_exc_type(cls) + _EXC_TYPE_CACHE[cls] = r + return r + + +def _get_exc_type(cls: Type[Exception]) -> str: + if issubclass(cls, AssertionError): + return 'assertion_error' + + base_name = 'type_error' if issubclass(cls, TypeError) else 'value_error' + if cls in (TypeError, ValueError): + # just TypeError or ValueError, no extra code + return base_name + + # if it's not a TypeError or ValueError, we just take the lowercase of the exception name + # no chaining or snake case logic, use "code" for more complex error types. + code = getattr(cls, 'code', None) or cls.__name__.replace('Error', '').lower() + return base_name + '.' + code diff --git a/env/Lib/site-packages/pydantic/v1/errors.py b/env/Lib/site-packages/pydantic/v1/errors.py new file mode 100644 index 0000000..6e86442 --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/errors.py @@ -0,0 +1,646 @@ +from decimal import Decimal +from pathlib import Path +from typing import TYPE_CHECKING, Any, Callable, Sequence, Set, Tuple, Type, Union + +from pydantic.v1.typing import display_as_type + +if TYPE_CHECKING: + from pydantic.v1.typing import DictStrAny + +# explicitly state exports to avoid "from pydantic.v1.errors import *" also importing Decimal, Path etc. +__all__ = ( + 'PydanticTypeError', + 'PydanticValueError', + 'ConfigError', + 'MissingError', + 'ExtraError', + 'NoneIsNotAllowedError', + 'NoneIsAllowedError', + 'WrongConstantError', + 'NotNoneError', + 'BoolError', + 'BytesError', + 'DictError', + 'EmailError', + 'UrlError', + 'UrlSchemeError', + 'UrlSchemePermittedError', + 'UrlUserInfoError', + 'UrlHostError', + 'UrlHostTldError', + 'UrlPortError', + 'UrlExtraError', + 'EnumError', + 'IntEnumError', + 'EnumMemberError', + 'IntegerError', + 'FloatError', + 'PathError', + 'PathNotExistsError', + 'PathNotAFileError', + 'PathNotADirectoryError', + 'PyObjectError', + 'SequenceError', + 'ListError', + 'SetError', + 'FrozenSetError', + 'TupleError', + 'TupleLengthError', + 'ListMinLengthError', + 'ListMaxLengthError', + 'ListUniqueItemsError', + 'SetMinLengthError', + 'SetMaxLengthError', + 'FrozenSetMinLengthError', + 'FrozenSetMaxLengthError', + 'AnyStrMinLengthError', + 'AnyStrMaxLengthError', + 'StrError', + 'StrRegexError', + 'NumberNotGtError', + 'NumberNotGeError', + 'NumberNotLtError', + 'NumberNotLeError', + 'NumberNotMultipleError', + 'DecimalError', + 'DecimalIsNotFiniteError', + 'DecimalMaxDigitsError', + 'DecimalMaxPlacesError', + 'DecimalWholeDigitsError', + 'DateTimeError', + 'DateError', + 'DateNotInThePastError', + 'DateNotInTheFutureError', + 'TimeError', + 'DurationError', + 'HashableError', + 'UUIDError', + 'UUIDVersionError', + 'ArbitraryTypeError', + 'ClassError', + 'SubclassError', + 'JsonError', + 'JsonTypeError', + 'PatternError', + 'DataclassTypeError', + 'CallableError', + 'IPvAnyAddressError', + 'IPvAnyInterfaceError', + 'IPvAnyNetworkError', + 'IPv4AddressError', + 'IPv6AddressError', + 'IPv4NetworkError', + 'IPv6NetworkError', + 'IPv4InterfaceError', + 'IPv6InterfaceError', + 'ColorError', + 'StrictBoolError', + 'NotDigitError', + 'LuhnValidationError', + 'InvalidLengthForBrand', + 'InvalidByteSize', + 'InvalidByteSizeUnit', + 'MissingDiscriminator', + 'InvalidDiscriminator', +) + + +def cls_kwargs(cls: Type['PydanticErrorMixin'], ctx: 'DictStrAny') -> 'PydanticErrorMixin': + """ + For built-in exceptions like ValueError or TypeError, we need to implement + __reduce__ to override the default behaviour (instead of __getstate__/__setstate__) + By default pickle protocol 2 calls `cls.__new__(cls, *args)`. + Since we only use kwargs, we need a little constructor to change that. + Note: the callable can't be a lambda as pickle looks in the namespace to find it + """ + return cls(**ctx) + + +class PydanticErrorMixin: + code: str + msg_template: str + + def __init__(self, **ctx: Any) -> None: + self.__dict__ = ctx + + def __str__(self) -> str: + return self.msg_template.format(**self.__dict__) + + def __reduce__(self) -> Tuple[Callable[..., 'PydanticErrorMixin'], Tuple[Type['PydanticErrorMixin'], 'DictStrAny']]: + return cls_kwargs, (self.__class__, self.__dict__) + + +class PydanticTypeError(PydanticErrorMixin, TypeError): + pass + + +class PydanticValueError(PydanticErrorMixin, ValueError): + pass + + +class ConfigError(RuntimeError): + pass + + +class MissingError(PydanticValueError): + msg_template = 'field required' + + +class ExtraError(PydanticValueError): + msg_template = 'extra fields not permitted' + + +class NoneIsNotAllowedError(PydanticTypeError): + code = 'none.not_allowed' + msg_template = 'none is not an allowed value' + + +class NoneIsAllowedError(PydanticTypeError): + code = 'none.allowed' + msg_template = 'value is not none' + + +class WrongConstantError(PydanticValueError): + code = 'const' + + def __str__(self) -> str: + permitted = ', '.join(repr(v) for v in self.permitted) # type: ignore + return f'unexpected value; permitted: {permitted}' + + +class NotNoneError(PydanticTypeError): + code = 'not_none' + msg_template = 'value is not None' + + +class BoolError(PydanticTypeError): + msg_template = 'value could not be parsed to a boolean' + + +class BytesError(PydanticTypeError): + msg_template = 'byte type expected' + + +class DictError(PydanticTypeError): + msg_template = 'value is not a valid dict' + + +class EmailError(PydanticValueError): + msg_template = 'value is not a valid email address' + + +class UrlError(PydanticValueError): + code = 'url' + + +class UrlSchemeError(UrlError): + code = 'url.scheme' + msg_template = 'invalid or missing URL scheme' + + +class UrlSchemePermittedError(UrlError): + code = 'url.scheme' + msg_template = 'URL scheme not permitted' + + def __init__(self, allowed_schemes: Set[str]): + super().__init__(allowed_schemes=allowed_schemes) + + +class UrlUserInfoError(UrlError): + code = 'url.userinfo' + msg_template = 'userinfo required in URL but missing' + + +class UrlHostError(UrlError): + code = 'url.host' + msg_template = 'URL host invalid' + + +class UrlHostTldError(UrlError): + code = 'url.host' + msg_template = 'URL host invalid, top level domain required' + + +class UrlPortError(UrlError): + code = 'url.port' + msg_template = 'URL port invalid, port cannot exceed 65535' + + +class UrlExtraError(UrlError): + code = 'url.extra' + msg_template = 'URL invalid, extra characters found after valid URL: {extra!r}' + + +class EnumMemberError(PydanticTypeError): + code = 'enum' + + def __str__(self) -> str: + permitted = ', '.join(repr(v.value) for v in self.enum_values) # type: ignore + return f'value is not a valid enumeration member; permitted: {permitted}' + + +class IntegerError(PydanticTypeError): + msg_template = 'value is not a valid integer' + + +class FloatError(PydanticTypeError): + msg_template = 'value is not a valid float' + + +class PathError(PydanticTypeError): + msg_template = 'value is not a valid path' + + +class _PathValueError(PydanticValueError): + def __init__(self, *, path: Path) -> None: + super().__init__(path=str(path)) + + +class PathNotExistsError(_PathValueError): + code = 'path.not_exists' + msg_template = 'file or directory at path "{path}" does not exist' + + +class PathNotAFileError(_PathValueError): + code = 'path.not_a_file' + msg_template = 'path "{path}" does not point to a file' + + +class PathNotADirectoryError(_PathValueError): + code = 'path.not_a_directory' + msg_template = 'path "{path}" does not point to a directory' + + +class PyObjectError(PydanticTypeError): + msg_template = 'ensure this value contains valid import path or valid callable: {error_message}' + + +class SequenceError(PydanticTypeError): + msg_template = 'value is not a valid sequence' + + +class IterableError(PydanticTypeError): + msg_template = 'value is not a valid iterable' + + +class ListError(PydanticTypeError): + msg_template = 'value is not a valid list' + + +class SetError(PydanticTypeError): + msg_template = 'value is not a valid set' + + +class FrozenSetError(PydanticTypeError): + msg_template = 'value is not a valid frozenset' + + +class DequeError(PydanticTypeError): + msg_template = 'value is not a valid deque' + + +class TupleError(PydanticTypeError): + msg_template = 'value is not a valid tuple' + + +class TupleLengthError(PydanticValueError): + code = 'tuple.length' + msg_template = 'wrong tuple length {actual_length}, expected {expected_length}' + + def __init__(self, *, actual_length: int, expected_length: int) -> None: + super().__init__(actual_length=actual_length, expected_length=expected_length) + + +class ListMinLengthError(PydanticValueError): + code = 'list.min_items' + msg_template = 'ensure this value has at least {limit_value} items' + + def __init__(self, *, limit_value: int) -> None: + super().__init__(limit_value=limit_value) + + +class ListMaxLengthError(PydanticValueError): + code = 'list.max_items' + msg_template = 'ensure this value has at most {limit_value} items' + + def __init__(self, *, limit_value: int) -> None: + super().__init__(limit_value=limit_value) + + +class ListUniqueItemsError(PydanticValueError): + code = 'list.unique_items' + msg_template = 'the list has duplicated items' + + +class SetMinLengthError(PydanticValueError): + code = 'set.min_items' + msg_template = 'ensure this value has at least {limit_value} items' + + def __init__(self, *, limit_value: int) -> None: + super().__init__(limit_value=limit_value) + + +class SetMaxLengthError(PydanticValueError): + code = 'set.max_items' + msg_template = 'ensure this value has at most {limit_value} items' + + def __init__(self, *, limit_value: int) -> None: + super().__init__(limit_value=limit_value) + + +class FrozenSetMinLengthError(PydanticValueError): + code = 'frozenset.min_items' + msg_template = 'ensure this value has at least {limit_value} items' + + def __init__(self, *, limit_value: int) -> None: + super().__init__(limit_value=limit_value) + + +class FrozenSetMaxLengthError(PydanticValueError): + code = 'frozenset.max_items' + msg_template = 'ensure this value has at most {limit_value} items' + + def __init__(self, *, limit_value: int) -> None: + super().__init__(limit_value=limit_value) + + +class AnyStrMinLengthError(PydanticValueError): + code = 'any_str.min_length' + msg_template = 'ensure this value has at least {limit_value} characters' + + def __init__(self, *, limit_value: int) -> None: + super().__init__(limit_value=limit_value) + + +class AnyStrMaxLengthError(PydanticValueError): + code = 'any_str.max_length' + msg_template = 'ensure this value has at most {limit_value} characters' + + def __init__(self, *, limit_value: int) -> None: + super().__init__(limit_value=limit_value) + + +class StrError(PydanticTypeError): + msg_template = 'str type expected' + + +class StrRegexError(PydanticValueError): + code = 'str.regex' + msg_template = 'string does not match regex "{pattern}"' + + def __init__(self, *, pattern: str) -> None: + super().__init__(pattern=pattern) + + +class _NumberBoundError(PydanticValueError): + def __init__(self, *, limit_value: Union[int, float, Decimal]) -> None: + super().__init__(limit_value=limit_value) + + +class NumberNotGtError(_NumberBoundError): + code = 'number.not_gt' + msg_template = 'ensure this value is greater than {limit_value}' + + +class NumberNotGeError(_NumberBoundError): + code = 'number.not_ge' + msg_template = 'ensure this value is greater than or equal to {limit_value}' + + +class NumberNotLtError(_NumberBoundError): + code = 'number.not_lt' + msg_template = 'ensure this value is less than {limit_value}' + + +class NumberNotLeError(_NumberBoundError): + code = 'number.not_le' + msg_template = 'ensure this value is less than or equal to {limit_value}' + + +class NumberNotFiniteError(PydanticValueError): + code = 'number.not_finite_number' + msg_template = 'ensure this value is a finite number' + + +class NumberNotMultipleError(PydanticValueError): + code = 'number.not_multiple' + msg_template = 'ensure this value is a multiple of {multiple_of}' + + def __init__(self, *, multiple_of: Union[int, float, Decimal]) -> None: + super().__init__(multiple_of=multiple_of) + + +class DecimalError(PydanticTypeError): + msg_template = 'value is not a valid decimal' + + +class DecimalIsNotFiniteError(PydanticValueError): + code = 'decimal.not_finite' + msg_template = 'value is not a valid decimal' + + +class DecimalMaxDigitsError(PydanticValueError): + code = 'decimal.max_digits' + msg_template = 'ensure that there are no more than {max_digits} digits in total' + + def __init__(self, *, max_digits: int) -> None: + super().__init__(max_digits=max_digits) + + +class DecimalMaxPlacesError(PydanticValueError): + code = 'decimal.max_places' + msg_template = 'ensure that there are no more than {decimal_places} decimal places' + + def __init__(self, *, decimal_places: int) -> None: + super().__init__(decimal_places=decimal_places) + + +class DecimalWholeDigitsError(PydanticValueError): + code = 'decimal.whole_digits' + msg_template = 'ensure that there are no more than {whole_digits} digits before the decimal point' + + def __init__(self, *, whole_digits: int) -> None: + super().__init__(whole_digits=whole_digits) + + +class DateTimeError(PydanticValueError): + msg_template = 'invalid datetime format' + + +class DateError(PydanticValueError): + msg_template = 'invalid date format' + + +class DateNotInThePastError(PydanticValueError): + code = 'date.not_in_the_past' + msg_template = 'date is not in the past' + + +class DateNotInTheFutureError(PydanticValueError): + code = 'date.not_in_the_future' + msg_template = 'date is not in the future' + + +class TimeError(PydanticValueError): + msg_template = 'invalid time format' + + +class DurationError(PydanticValueError): + msg_template = 'invalid duration format' + + +class HashableError(PydanticTypeError): + msg_template = 'value is not a valid hashable' + + +class UUIDError(PydanticTypeError): + msg_template = 'value is not a valid uuid' + + +class UUIDVersionError(PydanticValueError): + code = 'uuid.version' + msg_template = 'uuid version {required_version} expected' + + def __init__(self, *, required_version: int) -> None: + super().__init__(required_version=required_version) + + +class ArbitraryTypeError(PydanticTypeError): + code = 'arbitrary_type' + msg_template = 'instance of {expected_arbitrary_type} expected' + + def __init__(self, *, expected_arbitrary_type: Type[Any]) -> None: + super().__init__(expected_arbitrary_type=display_as_type(expected_arbitrary_type)) + + +class ClassError(PydanticTypeError): + code = 'class' + msg_template = 'a class is expected' + + +class SubclassError(PydanticTypeError): + code = 'subclass' + msg_template = 'subclass of {expected_class} expected' + + def __init__(self, *, expected_class: Type[Any]) -> None: + super().__init__(expected_class=display_as_type(expected_class)) + + +class JsonError(PydanticValueError): + msg_template = 'Invalid JSON' + + +class JsonTypeError(PydanticTypeError): + code = 'json' + msg_template = 'JSON object must be str, bytes or bytearray' + + +class PatternError(PydanticValueError): + code = 'regex_pattern' + msg_template = 'Invalid regular expression' + + +class DataclassTypeError(PydanticTypeError): + code = 'dataclass' + msg_template = 'instance of {class_name}, tuple or dict expected' + + +class CallableError(PydanticTypeError): + msg_template = '{value} is not callable' + + +class EnumError(PydanticTypeError): + code = 'enum_instance' + msg_template = '{value} is not a valid Enum instance' + + +class IntEnumError(PydanticTypeError): + code = 'int_enum_instance' + msg_template = '{value} is not a valid IntEnum instance' + + +class IPvAnyAddressError(PydanticValueError): + msg_template = 'value is not a valid IPv4 or IPv6 address' + + +class IPvAnyInterfaceError(PydanticValueError): + msg_template = 'value is not a valid IPv4 or IPv6 interface' + + +class IPvAnyNetworkError(PydanticValueError): + msg_template = 'value is not a valid IPv4 or IPv6 network' + + +class IPv4AddressError(PydanticValueError): + msg_template = 'value is not a valid IPv4 address' + + +class IPv6AddressError(PydanticValueError): + msg_template = 'value is not a valid IPv6 address' + + +class IPv4NetworkError(PydanticValueError): + msg_template = 'value is not a valid IPv4 network' + + +class IPv6NetworkError(PydanticValueError): + msg_template = 'value is not a valid IPv6 network' + + +class IPv4InterfaceError(PydanticValueError): + msg_template = 'value is not a valid IPv4 interface' + + +class IPv6InterfaceError(PydanticValueError): + msg_template = 'value is not a valid IPv6 interface' + + +class ColorError(PydanticValueError): + msg_template = 'value is not a valid color: {reason}' + + +class StrictBoolError(PydanticValueError): + msg_template = 'value is not a valid boolean' + + +class NotDigitError(PydanticValueError): + code = 'payment_card_number.digits' + msg_template = 'card number is not all digits' + + +class LuhnValidationError(PydanticValueError): + code = 'payment_card_number.luhn_check' + msg_template = 'card number is not luhn valid' + + +class InvalidLengthForBrand(PydanticValueError): + code = 'payment_card_number.invalid_length_for_brand' + msg_template = 'Length for a {brand} card must be {required_length}' + + +class InvalidByteSize(PydanticValueError): + msg_template = 'could not parse value and unit from byte string' + + +class InvalidByteSizeUnit(PydanticValueError): + msg_template = 'could not interpret byte unit: {unit}' + + +class MissingDiscriminator(PydanticValueError): + code = 'discriminated_union.missing_discriminator' + msg_template = 'Discriminator {discriminator_key!r} is missing in value' + + +class InvalidDiscriminator(PydanticValueError): + code = 'discriminated_union.invalid_discriminator' + msg_template = ( + 'No match for discriminator {discriminator_key!r} and value {discriminator_value!r} ' + '(allowed values: {allowed_values})' + ) + + def __init__(self, *, discriminator_key: str, discriminator_value: Any, allowed_values: Sequence[Any]) -> None: + super().__init__( + discriminator_key=discriminator_key, + discriminator_value=discriminator_value, + allowed_values=', '.join(map(repr, allowed_values)), + ) diff --git a/env/Lib/site-packages/pydantic/v1/fields.py b/env/Lib/site-packages/pydantic/v1/fields.py new file mode 100644 index 0000000..002b60c --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/fields.py @@ -0,0 +1,1253 @@ +import copy +import re +from collections import Counter as CollectionCounter, defaultdict, deque +from collections.abc import Callable, Hashable as CollectionsHashable, Iterable as CollectionsIterable +from typing import ( + TYPE_CHECKING, + Any, + Counter, + DefaultDict, + Deque, + Dict, + ForwardRef, + FrozenSet, + Generator, + Iterable, + Iterator, + List, + Mapping, + Optional, + Pattern, + Sequence, + Set, + Tuple, + Type, + TypeVar, + Union, +) + +from typing_extensions import Annotated, Final + +from pydantic.v1 import errors as errors_ +from pydantic.v1.class_validators import Validator, make_generic_validator, prep_validators +from pydantic.v1.error_wrappers import ErrorWrapper +from pydantic.v1.errors import ConfigError, InvalidDiscriminator, MissingDiscriminator, NoneIsNotAllowedError +from pydantic.v1.types import Json, JsonWrapper +from pydantic.v1.typing import ( + NoArgAnyCallable, + convert_generics, + display_as_type, + get_args, + get_origin, + is_finalvar, + is_literal_type, + is_new_type, + is_none_type, + is_typeddict, + is_typeddict_special, + is_union, + new_type_supertype, +) +from pydantic.v1.utils import ( + PyObjectStr, + Representation, + ValueItems, + get_discriminator_alias_and_values, + get_unique_discriminator_alias, + lenient_isinstance, + lenient_issubclass, + sequence_like, + smart_deepcopy, +) +from pydantic.v1.validators import constant_validator, dict_validator, find_validators, validate_json + +Required: Any = Ellipsis + +T = TypeVar('T') + + +class UndefinedType: + def __repr__(self) -> str: + return 'PydanticUndefined' + + def __copy__(self: T) -> T: + return self + + def __reduce__(self) -> str: + return 'Undefined' + + def __deepcopy__(self: T, _: Any) -> T: + return self + + +Undefined = UndefinedType() + +if TYPE_CHECKING: + from pydantic.v1.class_validators import ValidatorsList + from pydantic.v1.config import BaseConfig + from pydantic.v1.error_wrappers import ErrorList + from pydantic.v1.types import ModelOrDc + from pydantic.v1.typing import AbstractSetIntStr, MappingIntStrAny, ReprArgs + + ValidateReturn = Tuple[Optional[Any], Optional[ErrorList]] + LocStr = Union[Tuple[Union[int, str], ...], str] + BoolUndefined = Union[bool, UndefinedType] + + +class FieldInfo(Representation): + """ + Captures extra information about a field. + """ + + __slots__ = ( + 'default', + 'default_factory', + 'alias', + 'alias_priority', + 'title', + 'description', + 'exclude', + 'include', + 'const', + 'gt', + 'ge', + 'lt', + 'le', + 'multiple_of', + 'allow_inf_nan', + 'max_digits', + 'decimal_places', + 'min_items', + 'max_items', + 'unique_items', + 'min_length', + 'max_length', + 'allow_mutation', + 'repr', + 'regex', + 'discriminator', + 'extra', + ) + + # field constraints with the default value, it's also used in update_from_config below + __field_constraints__ = { + 'min_length': None, + 'max_length': None, + 'regex': None, + 'gt': None, + 'lt': None, + 'ge': None, + 'le': None, + 'multiple_of': None, + 'allow_inf_nan': None, + 'max_digits': None, + 'decimal_places': None, + 'min_items': None, + 'max_items': None, + 'unique_items': None, + 'allow_mutation': True, + } + + def __init__(self, default: Any = Undefined, **kwargs: Any) -> None: + self.default = default + self.default_factory = kwargs.pop('default_factory', None) + self.alias = kwargs.pop('alias', None) + self.alias_priority = kwargs.pop('alias_priority', 2 if self.alias is not None else None) + self.title = kwargs.pop('title', None) + self.description = kwargs.pop('description', None) + self.exclude = kwargs.pop('exclude', None) + self.include = kwargs.pop('include', None) + self.const = kwargs.pop('const', None) + self.gt = kwargs.pop('gt', None) + self.ge = kwargs.pop('ge', None) + self.lt = kwargs.pop('lt', None) + self.le = kwargs.pop('le', None) + self.multiple_of = kwargs.pop('multiple_of', None) + self.allow_inf_nan = kwargs.pop('allow_inf_nan', None) + self.max_digits = kwargs.pop('max_digits', None) + self.decimal_places = kwargs.pop('decimal_places', None) + self.min_items = kwargs.pop('min_items', None) + self.max_items = kwargs.pop('max_items', None) + self.unique_items = kwargs.pop('unique_items', None) + self.min_length = kwargs.pop('min_length', None) + self.max_length = kwargs.pop('max_length', None) + self.allow_mutation = kwargs.pop('allow_mutation', True) + self.regex = kwargs.pop('regex', None) + self.discriminator = kwargs.pop('discriminator', None) + self.repr = kwargs.pop('repr', True) + self.extra = kwargs + + def __repr_args__(self) -> 'ReprArgs': + field_defaults_to_hide: Dict[str, Any] = { + 'repr': True, + **self.__field_constraints__, + } + + attrs = ((s, getattr(self, s)) for s in self.__slots__) + return [(a, v) for a, v in attrs if v != field_defaults_to_hide.get(a, None)] + + def get_constraints(self) -> Set[str]: + """ + Gets the constraints set on the field by comparing the constraint value with its default value + + :return: the constraints set on field_info + """ + return {attr for attr, default in self.__field_constraints__.items() if getattr(self, attr) != default} + + def update_from_config(self, from_config: Dict[str, Any]) -> None: + """ + Update this FieldInfo based on a dict from get_field_info, only fields which have not been set are dated. + """ + for attr_name, value in from_config.items(): + try: + current_value = getattr(self, attr_name) + except AttributeError: + # attr_name is not an attribute of FieldInfo, it should therefore be added to extra + # (except if extra already has this value!) + self.extra.setdefault(attr_name, value) + else: + if current_value is self.__field_constraints__.get(attr_name, None): + setattr(self, attr_name, value) + elif attr_name == 'exclude': + self.exclude = ValueItems.merge(value, current_value) + elif attr_name == 'include': + self.include = ValueItems.merge(value, current_value, intersect=True) + + def _validate(self) -> None: + if self.default is not Undefined and self.default_factory is not None: + raise ValueError('cannot specify both default and default_factory') + + +def Field( + default: Any = Undefined, + *, + default_factory: Optional[NoArgAnyCallable] = None, + alias: Optional[str] = None, + title: Optional[str] = None, + description: Optional[str] = None, + exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny', Any]] = None, + include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny', Any]] = None, + const: Optional[bool] = None, + gt: Optional[float] = None, + ge: Optional[float] = None, + lt: Optional[float] = None, + le: Optional[float] = None, + multiple_of: Optional[float] = None, + allow_inf_nan: Optional[bool] = None, + max_digits: Optional[int] = None, + decimal_places: Optional[int] = None, + min_items: Optional[int] = None, + max_items: Optional[int] = None, + unique_items: Optional[bool] = None, + min_length: Optional[int] = None, + max_length: Optional[int] = None, + allow_mutation: bool = True, + regex: Optional[str] = None, + discriminator: Optional[str] = None, + repr: bool = True, + **extra: Any, +) -> Any: + """ + Used to provide extra information about a field, either for the model schema or complex validation. Some arguments + apply only to number fields (``int``, ``float``, ``Decimal``) and some apply only to ``str``. + + :param default: since this is replacing the field’s default, its first argument is used + to set the default, use ellipsis (``...``) to indicate the field is required + :param default_factory: callable that will be called when a default value is needed for this field + If both `default` and `default_factory` are set, an error is raised. + :param alias: the public name of the field + :param title: can be any string, used in the schema + :param description: can be any string, used in the schema + :param exclude: exclude this field while dumping. + Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method. + :param include: include this field while dumping. + Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method. + :param const: this field is required and *must* take it's default value + :param gt: only applies to numbers, requires the field to be "greater than". The schema + will have an ``exclusiveMinimum`` validation keyword + :param ge: only applies to numbers, requires the field to be "greater than or equal to". The + schema will have a ``minimum`` validation keyword + :param lt: only applies to numbers, requires the field to be "less than". The schema + will have an ``exclusiveMaximum`` validation keyword + :param le: only applies to numbers, requires the field to be "less than or equal to". The + schema will have a ``maximum`` validation keyword + :param multiple_of: only applies to numbers, requires the field to be "a multiple of". The + schema will have a ``multipleOf`` validation keyword + :param allow_inf_nan: only applies to numbers, allows the field to be NaN or infinity (+inf or -inf), + which is a valid Python float. Default True, set to False for compatibility with JSON. + :param max_digits: only applies to Decimals, requires the field to have a maximum number + of digits within the decimal. It does not include a zero before the decimal point or trailing decimal zeroes. + :param decimal_places: only applies to Decimals, requires the field to have at most a number of decimal places + allowed. It does not include trailing decimal zeroes. + :param min_items: only applies to lists, requires the field to have a minimum number of + elements. The schema will have a ``minItems`` validation keyword + :param max_items: only applies to lists, requires the field to have a maximum number of + elements. The schema will have a ``maxItems`` validation keyword + :param unique_items: only applies to lists, requires the field not to have duplicated + elements. The schema will have a ``uniqueItems`` validation keyword + :param min_length: only applies to strings, requires the field to have a minimum length. The + schema will have a ``minLength`` validation keyword + :param max_length: only applies to strings, requires the field to have a maximum length. The + schema will have a ``maxLength`` validation keyword + :param allow_mutation: a boolean which defaults to True. When False, the field raises a TypeError if the field is + assigned on an instance. The BaseModel Config must set validate_assignment to True + :param regex: only applies to strings, requires the field match against a regular expression + pattern string. The schema will have a ``pattern`` validation keyword + :param discriminator: only useful with a (discriminated a.k.a. tagged) `Union` of sub models with a common field. + The `discriminator` is the name of this common field to shorten validation and improve generated schema + :param repr: show this field in the representation + :param **extra: any additional keyword arguments will be added as is to the schema + """ + field_info = FieldInfo( + default, + default_factory=default_factory, + alias=alias, + title=title, + description=description, + exclude=exclude, + include=include, + const=const, + gt=gt, + ge=ge, + lt=lt, + le=le, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + min_items=min_items, + max_items=max_items, + unique_items=unique_items, + min_length=min_length, + max_length=max_length, + allow_mutation=allow_mutation, + regex=regex, + discriminator=discriminator, + repr=repr, + **extra, + ) + field_info._validate() + return field_info + + +# used to be an enum but changed to int's for small performance improvement as less access overhead +SHAPE_SINGLETON = 1 +SHAPE_LIST = 2 +SHAPE_SET = 3 +SHAPE_MAPPING = 4 +SHAPE_TUPLE = 5 +SHAPE_TUPLE_ELLIPSIS = 6 +SHAPE_SEQUENCE = 7 +SHAPE_FROZENSET = 8 +SHAPE_ITERABLE = 9 +SHAPE_GENERIC = 10 +SHAPE_DEQUE = 11 +SHAPE_DICT = 12 +SHAPE_DEFAULTDICT = 13 +SHAPE_COUNTER = 14 +SHAPE_NAME_LOOKUP = { + SHAPE_LIST: 'List[{}]', + SHAPE_SET: 'Set[{}]', + SHAPE_TUPLE_ELLIPSIS: 'Tuple[{}, ...]', + SHAPE_SEQUENCE: 'Sequence[{}]', + SHAPE_FROZENSET: 'FrozenSet[{}]', + SHAPE_ITERABLE: 'Iterable[{}]', + SHAPE_DEQUE: 'Deque[{}]', + SHAPE_DICT: 'Dict[{}]', + SHAPE_DEFAULTDICT: 'DefaultDict[{}]', + SHAPE_COUNTER: 'Counter[{}]', +} + +MAPPING_LIKE_SHAPES: Set[int] = {SHAPE_DEFAULTDICT, SHAPE_DICT, SHAPE_MAPPING, SHAPE_COUNTER} + + +class ModelField(Representation): + __slots__ = ( + 'type_', + 'outer_type_', + 'annotation', + 'sub_fields', + 'sub_fields_mapping', + 'key_field', + 'validators', + 'pre_validators', + 'post_validators', + 'default', + 'default_factory', + 'required', + 'final', + 'model_config', + 'name', + 'alias', + 'has_alias', + 'field_info', + 'discriminator_key', + 'discriminator_alias', + 'validate_always', + 'allow_none', + 'shape', + 'class_validators', + 'parse_json', + ) + + def __init__( + self, + *, + name: str, + type_: Type[Any], + class_validators: Optional[Dict[str, Validator]], + model_config: Type['BaseConfig'], + default: Any = None, + default_factory: Optional[NoArgAnyCallable] = None, + required: 'BoolUndefined' = Undefined, + final: bool = False, + alias: Optional[str] = None, + field_info: Optional[FieldInfo] = None, + ) -> None: + self.name: str = name + self.has_alias: bool = alias is not None + self.alias: str = alias if alias is not None else name + self.annotation = type_ + self.type_: Any = convert_generics(type_) + self.outer_type_: Any = type_ + self.class_validators = class_validators or {} + self.default: Any = default + self.default_factory: Optional[NoArgAnyCallable] = default_factory + self.required: 'BoolUndefined' = required + self.final: bool = final + self.model_config = model_config + self.field_info: FieldInfo = field_info or FieldInfo(default) + self.discriminator_key: Optional[str] = self.field_info.discriminator + self.discriminator_alias: Optional[str] = self.discriminator_key + + self.allow_none: bool = False + self.validate_always: bool = False + self.sub_fields: Optional[List[ModelField]] = None + self.sub_fields_mapping: Optional[Dict[str, 'ModelField']] = None # used for discriminated union + self.key_field: Optional[ModelField] = None + self.validators: 'ValidatorsList' = [] + self.pre_validators: Optional['ValidatorsList'] = None + self.post_validators: Optional['ValidatorsList'] = None + self.parse_json: bool = False + self.shape: int = SHAPE_SINGLETON + self.model_config.prepare_field(self) + self.prepare() + + def get_default(self) -> Any: + return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory() + + @staticmethod + def _get_field_info( + field_name: str, annotation: Any, value: Any, config: Type['BaseConfig'] + ) -> Tuple[FieldInfo, Any]: + """ + Get a FieldInfo from a root typing.Annotated annotation, value, or config default. + + The FieldInfo may be set in typing.Annotated or the value, but not both. If neither contain + a FieldInfo, a new one will be created using the config. + + :param field_name: name of the field for use in error messages + :param annotation: a type hint such as `str` or `Annotated[str, Field(..., min_length=5)]` + :param value: the field's assigned value + :param config: the model's config object + :return: the FieldInfo contained in the `annotation`, the value, or a new one from the config. + """ + field_info_from_config = config.get_field_info(field_name) + + field_info = None + if get_origin(annotation) is Annotated: + field_infos = [arg for arg in get_args(annotation)[1:] if isinstance(arg, FieldInfo)] + if len(field_infos) > 1: + raise ValueError(f'cannot specify multiple `Annotated` `Field`s for {field_name!r}') + field_info = next(iter(field_infos), None) + if field_info is not None: + field_info = copy.copy(field_info) + field_info.update_from_config(field_info_from_config) + if field_info.default not in (Undefined, Required): + raise ValueError(f'`Field` default cannot be set in `Annotated` for {field_name!r}') + if value is not Undefined and value is not Required: + # check also `Required` because of `validate_arguments` that sets `...` as default value + field_info.default = value + + if isinstance(value, FieldInfo): + if field_info is not None: + raise ValueError(f'cannot specify `Annotated` and value `Field`s together for {field_name!r}') + field_info = value + field_info.update_from_config(field_info_from_config) + elif field_info is None: + field_info = FieldInfo(value, **field_info_from_config) + value = None if field_info.default_factory is not None else field_info.default + field_info._validate() + return field_info, value + + @classmethod + def infer( + cls, + *, + name: str, + value: Any, + annotation: Any, + class_validators: Optional[Dict[str, Validator]], + config: Type['BaseConfig'], + ) -> 'ModelField': + from pydantic.v1.schema import get_annotation_from_field_info + + field_info, value = cls._get_field_info(name, annotation, value, config) + required: 'BoolUndefined' = Undefined + if value is Required: + required = True + value = None + elif value is not Undefined: + required = False + annotation = get_annotation_from_field_info(annotation, field_info, name, config.validate_assignment) + + return cls( + name=name, + type_=annotation, + alias=field_info.alias, + class_validators=class_validators, + default=value, + default_factory=field_info.default_factory, + required=required, + model_config=config, + field_info=field_info, + ) + + def set_config(self, config: Type['BaseConfig']) -> None: + self.model_config = config + info_from_config = config.get_field_info(self.name) + config.prepare_field(self) + new_alias = info_from_config.get('alias') + new_alias_priority = info_from_config.get('alias_priority') or 0 + if new_alias and new_alias_priority >= (self.field_info.alias_priority or 0): + self.field_info.alias = new_alias + self.field_info.alias_priority = new_alias_priority + self.alias = new_alias + new_exclude = info_from_config.get('exclude') + if new_exclude is not None: + self.field_info.exclude = ValueItems.merge(self.field_info.exclude, new_exclude) + new_include = info_from_config.get('include') + if new_include is not None: + self.field_info.include = ValueItems.merge(self.field_info.include, new_include, intersect=True) + + @property + def alt_alias(self) -> bool: + return self.name != self.alias + + def prepare(self) -> None: + """ + Prepare the field but inspecting self.default, self.type_ etc. + + Note: this method is **not** idempotent (because _type_analysis is not idempotent), + e.g. calling it it multiple times may modify the field and configure it incorrectly. + """ + self._set_default_and_type() + if self.type_.__class__ is ForwardRef or self.type_.__class__ is DeferredType: + # self.type_ is currently a ForwardRef and there's nothing we can do now, + # user will need to call model.update_forward_refs() + return + + self._type_analysis() + if self.required is Undefined: + self.required = True + if self.default is Undefined and self.default_factory is None: + self.default = None + self.populate_validators() + + def _set_default_and_type(self) -> None: + """ + Set the default value, infer the type if needed and check if `None` value is valid. + """ + if self.default_factory is not None: + if self.type_ is Undefined: + raise errors_.ConfigError( + f'you need to set the type of field {self.name!r} when using `default_factory`' + ) + return + + default_value = self.get_default() + + if default_value is not None and self.type_ is Undefined: + self.type_ = default_value.__class__ + self.outer_type_ = self.type_ + self.annotation = self.type_ + + if self.type_ is Undefined: + raise errors_.ConfigError(f'unable to infer type for attribute "{self.name}"') + + if self.required is False and default_value is None: + self.allow_none = True + + def _type_analysis(self) -> None: # noqa: C901 (ignore complexity) + # typing interface is horrible, we have to do some ugly checks + if lenient_issubclass(self.type_, JsonWrapper): + self.type_ = self.type_.inner_type + self.parse_json = True + elif lenient_issubclass(self.type_, Json): + self.type_ = Any + self.parse_json = True + elif isinstance(self.type_, TypeVar): + if self.type_.__bound__: + self.type_ = self.type_.__bound__ + elif self.type_.__constraints__: + self.type_ = Union[self.type_.__constraints__] + else: + self.type_ = Any + elif is_new_type(self.type_): + self.type_ = new_type_supertype(self.type_) + + if self.type_ is Any or self.type_ is object: + if self.required is Undefined: + self.required = False + self.allow_none = True + return + elif self.type_ is Pattern or self.type_ is re.Pattern: + # python 3.7 only, Pattern is a typing object but without sub fields + return + elif is_literal_type(self.type_): + return + elif is_typeddict(self.type_): + return + + if is_finalvar(self.type_): + self.final = True + + if self.type_ is Final: + self.type_ = Any + else: + self.type_ = get_args(self.type_)[0] + + self._type_analysis() + return + + origin = get_origin(self.type_) + + if origin is Annotated or is_typeddict_special(origin): + self.type_ = get_args(self.type_)[0] + self._type_analysis() + return + + if self.discriminator_key is not None and not is_union(origin): + raise TypeError('`discriminator` can only be used with `Union` type with more than one variant') + + # add extra check for `collections.abc.Hashable` for python 3.10+ where origin is not `None` + if origin is None or origin is CollectionsHashable: + # field is not "typing" object eg. Union, Dict, List etc. + # allow None for virtual superclasses of NoneType, e.g. Hashable + if isinstance(self.type_, type) and isinstance(None, self.type_): + self.allow_none = True + return + elif origin is Callable: + return + elif is_union(origin): + types_ = [] + for type_ in get_args(self.type_): + if is_none_type(type_) or type_ is Any or type_ is object: + if self.required is Undefined: + self.required = False + self.allow_none = True + if is_none_type(type_): + continue + types_.append(type_) + + if len(types_) == 1: + # Optional[] + self.type_ = types_[0] + # this is the one case where the "outer type" isn't just the original type + self.outer_type_ = self.type_ + # re-run to correctly interpret the new self.type_ + self._type_analysis() + else: + self.sub_fields = [self._create_sub_type(t, f'{self.name}_{display_as_type(t)}') for t in types_] + + if self.discriminator_key is not None: + self.prepare_discriminated_union_sub_fields() + return + elif issubclass(origin, Tuple): # type: ignore + # origin == Tuple without item type + args = get_args(self.type_) + if not args: # plain tuple + self.type_ = Any + self.shape = SHAPE_TUPLE_ELLIPSIS + elif len(args) == 2 and args[1] is Ellipsis: # e.g. Tuple[int, ...] + self.type_ = args[0] + self.shape = SHAPE_TUPLE_ELLIPSIS + self.sub_fields = [self._create_sub_type(args[0], f'{self.name}_0')] + elif args == ((),): # Tuple[()] means empty tuple + self.shape = SHAPE_TUPLE + self.type_ = Any + self.sub_fields = [] + else: + self.shape = SHAPE_TUPLE + self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(args)] + return + elif issubclass(origin, List): + # Create self validators + get_validators = getattr(self.type_, '__get_validators__', None) + if get_validators: + self.class_validators.update( + {f'list_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())} + ) + + self.type_ = get_args(self.type_)[0] + self.shape = SHAPE_LIST + elif issubclass(origin, Set): + # Create self validators + get_validators = getattr(self.type_, '__get_validators__', None) + if get_validators: + self.class_validators.update( + {f'set_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())} + ) + + self.type_ = get_args(self.type_)[0] + self.shape = SHAPE_SET + elif issubclass(origin, FrozenSet): + # Create self validators + get_validators = getattr(self.type_, '__get_validators__', None) + if get_validators: + self.class_validators.update( + {f'frozenset_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())} + ) + + self.type_ = get_args(self.type_)[0] + self.shape = SHAPE_FROZENSET + elif issubclass(origin, Deque): + self.type_ = get_args(self.type_)[0] + self.shape = SHAPE_DEQUE + elif issubclass(origin, Sequence): + self.type_ = get_args(self.type_)[0] + self.shape = SHAPE_SEQUENCE + # priority to most common mapping: dict + elif origin is dict or origin is Dict: + self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True) + self.type_ = get_args(self.type_)[1] + self.shape = SHAPE_DICT + elif issubclass(origin, DefaultDict): + self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True) + self.type_ = get_args(self.type_)[1] + self.shape = SHAPE_DEFAULTDICT + elif issubclass(origin, Counter): + self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True) + self.type_ = int + self.shape = SHAPE_COUNTER + elif issubclass(origin, Mapping): + self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True) + self.type_ = get_args(self.type_)[1] + self.shape = SHAPE_MAPPING + # Equality check as almost everything inherits form Iterable, including str + # check for Iterable and CollectionsIterable, as it could receive one even when declared with the other + elif origin in {Iterable, CollectionsIterable}: + self.type_ = get_args(self.type_)[0] + self.shape = SHAPE_ITERABLE + self.sub_fields = [self._create_sub_type(self.type_, f'{self.name}_type')] + elif issubclass(origin, Type): # type: ignore + return + elif hasattr(origin, '__get_validators__') or self.model_config.arbitrary_types_allowed: + # Is a Pydantic-compatible generic that handles itself + # or we have arbitrary_types_allowed = True + self.shape = SHAPE_GENERIC + self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(get_args(self.type_))] + self.type_ = origin + return + else: + raise TypeError(f'Fields of type "{origin}" are not supported.') + + # type_ has been refined eg. as the type of a List and sub_fields needs to be populated + self.sub_fields = [self._create_sub_type(self.type_, '_' + self.name)] + + def prepare_discriminated_union_sub_fields(self) -> None: + """ + Prepare the mapping -> and update `sub_fields` + Note that this process can be aborted if a `ForwardRef` is encountered + """ + assert self.discriminator_key is not None + + if self.type_.__class__ is DeferredType: + return + + assert self.sub_fields is not None + sub_fields_mapping: Dict[str, 'ModelField'] = {} + all_aliases: Set[str] = set() + + for sub_field in self.sub_fields: + t = sub_field.type_ + if t.__class__ is ForwardRef: + # Stopping everything...will need to call `update_forward_refs` + return + + alias, discriminator_values = get_discriminator_alias_and_values(t, self.discriminator_key) + all_aliases.add(alias) + for discriminator_value in discriminator_values: + sub_fields_mapping[discriminator_value] = sub_field + + self.sub_fields_mapping = sub_fields_mapping + self.discriminator_alias = get_unique_discriminator_alias(all_aliases, self.discriminator_key) + + def _create_sub_type(self, type_: Type[Any], name: str, *, for_keys: bool = False) -> 'ModelField': + if for_keys: + class_validators = None + else: + # validators for sub items should not have `each_item` as we want to check only the first sublevel + class_validators = { + k: Validator( + func=v.func, + pre=v.pre, + each_item=False, + always=v.always, + check_fields=v.check_fields, + skip_on_failure=v.skip_on_failure, + ) + for k, v in self.class_validators.items() + if v.each_item + } + + field_info, _ = self._get_field_info(name, type_, None, self.model_config) + + return self.__class__( + type_=type_, + name=name, + class_validators=class_validators, + model_config=self.model_config, + field_info=field_info, + ) + + def populate_validators(self) -> None: + """ + Prepare self.pre_validators, self.validators, and self.post_validators based on self.type_'s __get_validators__ + and class validators. This method should be idempotent, e.g. it should be safe to call multiple times + without mis-configuring the field. + """ + self.validate_always = getattr(self.type_, 'validate_always', False) or any( + v.always for v in self.class_validators.values() + ) + + class_validators_ = self.class_validators.values() + if not self.sub_fields or self.shape == SHAPE_GENERIC: + get_validators = getattr(self.type_, '__get_validators__', None) + v_funcs = ( + *[v.func for v in class_validators_ if v.each_item and v.pre], + *(get_validators() if get_validators else list(find_validators(self.type_, self.model_config))), + *[v.func for v in class_validators_ if v.each_item and not v.pre], + ) + self.validators = prep_validators(v_funcs) + + self.pre_validators = [] + self.post_validators = [] + + if self.field_info and self.field_info.const: + self.post_validators.append(make_generic_validator(constant_validator)) + + if class_validators_: + self.pre_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and v.pre) + self.post_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and not v.pre) + + if self.parse_json: + self.pre_validators.append(make_generic_validator(validate_json)) + + self.pre_validators = self.pre_validators or None + self.post_validators = self.post_validators or None + + def validate( + self, v: Any, values: Dict[str, Any], *, loc: 'LocStr', cls: Optional['ModelOrDc'] = None + ) -> 'ValidateReturn': + assert self.type_.__class__ is not DeferredType + + if self.type_.__class__ is ForwardRef: + assert cls is not None + raise ConfigError( + f'field "{self.name}" not yet prepared so type is still a ForwardRef, ' + f'you might need to call {cls.__name__}.update_forward_refs().' + ) + + errors: Optional['ErrorList'] + if self.pre_validators: + v, errors = self._apply_validators(v, values, loc, cls, self.pre_validators) + if errors: + return v, errors + + if v is None: + if is_none_type(self.type_): + # keep validating + pass + elif self.allow_none: + if self.post_validators: + return self._apply_validators(v, values, loc, cls, self.post_validators) + else: + return None, None + else: + return v, ErrorWrapper(NoneIsNotAllowedError(), loc) + + if self.shape == SHAPE_SINGLETON: + v, errors = self._validate_singleton(v, values, loc, cls) + elif self.shape in MAPPING_LIKE_SHAPES: + v, errors = self._validate_mapping_like(v, values, loc, cls) + elif self.shape == SHAPE_TUPLE: + v, errors = self._validate_tuple(v, values, loc, cls) + elif self.shape == SHAPE_ITERABLE: + v, errors = self._validate_iterable(v, values, loc, cls) + elif self.shape == SHAPE_GENERIC: + v, errors = self._apply_validators(v, values, loc, cls, self.validators) + else: + # sequence, list, set, generator, tuple with ellipsis, frozen set + v, errors = self._validate_sequence_like(v, values, loc, cls) + + if not errors and self.post_validators: + v, errors = self._apply_validators(v, values, loc, cls, self.post_validators) + return v, errors + + def _validate_sequence_like( # noqa: C901 (ignore complexity) + self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] + ) -> 'ValidateReturn': + """ + Validate sequence-like containers: lists, tuples, sets and generators + Note that large if-else blocks are necessary to enable Cython + optimization, which is why we disable the complexity check above. + """ + if not sequence_like(v): + e: errors_.PydanticTypeError + if self.shape == SHAPE_LIST: + e = errors_.ListError() + elif self.shape in (SHAPE_TUPLE, SHAPE_TUPLE_ELLIPSIS): + e = errors_.TupleError() + elif self.shape == SHAPE_SET: + e = errors_.SetError() + elif self.shape == SHAPE_FROZENSET: + e = errors_.FrozenSetError() + else: + e = errors_.SequenceError() + return v, ErrorWrapper(e, loc) + + loc = loc if isinstance(loc, tuple) else (loc,) + result = [] + errors: List[ErrorList] = [] + for i, v_ in enumerate(v): + v_loc = *loc, i + r, ee = self._validate_singleton(v_, values, v_loc, cls) + if ee: + errors.append(ee) + else: + result.append(r) + + if errors: + return v, errors + + converted: Union[List[Any], Set[Any], FrozenSet[Any], Tuple[Any, ...], Iterator[Any], Deque[Any]] = result + + if self.shape == SHAPE_SET: + converted = set(result) + elif self.shape == SHAPE_FROZENSET: + converted = frozenset(result) + elif self.shape == SHAPE_TUPLE_ELLIPSIS: + converted = tuple(result) + elif self.shape == SHAPE_DEQUE: + converted = deque(result, maxlen=getattr(v, 'maxlen', None)) + elif self.shape == SHAPE_SEQUENCE: + if isinstance(v, tuple): + converted = tuple(result) + elif isinstance(v, set): + converted = set(result) + elif isinstance(v, Generator): + converted = iter(result) + elif isinstance(v, deque): + converted = deque(result, maxlen=getattr(v, 'maxlen', None)) + return converted, None + + def _validate_iterable( + self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] + ) -> 'ValidateReturn': + """ + Validate Iterables. + + This intentionally doesn't validate values to allow infinite generators. + """ + + try: + iterable = iter(v) + except TypeError: + return v, ErrorWrapper(errors_.IterableError(), loc) + return iterable, None + + def _validate_tuple( + self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] + ) -> 'ValidateReturn': + e: Optional[Exception] = None + if not sequence_like(v): + e = errors_.TupleError() + else: + actual_length, expected_length = len(v), len(self.sub_fields) # type: ignore + if actual_length != expected_length: + e = errors_.TupleLengthError(actual_length=actual_length, expected_length=expected_length) + + if e: + return v, ErrorWrapper(e, loc) + + loc = loc if isinstance(loc, tuple) else (loc,) + result = [] + errors: List[ErrorList] = [] + for i, (v_, field) in enumerate(zip(v, self.sub_fields)): # type: ignore + v_loc = *loc, i + r, ee = field.validate(v_, values, loc=v_loc, cls=cls) + if ee: + errors.append(ee) + else: + result.append(r) + + if errors: + return v, errors + else: + return tuple(result), None + + def _validate_mapping_like( + self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] + ) -> 'ValidateReturn': + try: + v_iter = dict_validator(v) + except TypeError as exc: + return v, ErrorWrapper(exc, loc) + + loc = loc if isinstance(loc, tuple) else (loc,) + result, errors = {}, [] + for k, v_ in v_iter.items(): + v_loc = *loc, '__key__' + key_result, key_errors = self.key_field.validate(k, values, loc=v_loc, cls=cls) # type: ignore + if key_errors: + errors.append(key_errors) + continue + + v_loc = *loc, k + value_result, value_errors = self._validate_singleton(v_, values, v_loc, cls) + if value_errors: + errors.append(value_errors) + continue + + result[key_result] = value_result + if errors: + return v, errors + elif self.shape == SHAPE_DICT: + return result, None + elif self.shape == SHAPE_DEFAULTDICT: + return defaultdict(self.type_, result), None + elif self.shape == SHAPE_COUNTER: + return CollectionCounter(result), None + else: + return self._get_mapping_value(v, result), None + + def _get_mapping_value(self, original: T, converted: Dict[Any, Any]) -> Union[T, Dict[Any, Any]]: + """ + When type is `Mapping[KT, KV]` (or another unsupported mapping), we try to avoid + coercing to `dict` unwillingly. + """ + original_cls = original.__class__ + + if original_cls == dict or original_cls == Dict: + return converted + elif original_cls in {defaultdict, DefaultDict}: + return defaultdict(self.type_, converted) + else: + try: + # Counter, OrderedDict, UserDict, ... + return original_cls(converted) # type: ignore + except TypeError: + raise RuntimeError(f'Could not convert dictionary to {original_cls.__name__!r}') from None + + def _validate_singleton( + self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] + ) -> 'ValidateReturn': + if self.sub_fields: + if self.discriminator_key is not None: + return self._validate_discriminated_union(v, values, loc, cls) + + errors = [] + + if self.model_config.smart_union and is_union(get_origin(self.type_)): + # 1st pass: check if the value is an exact instance of one of the Union types + # (e.g. to avoid coercing a bool into an int) + for field in self.sub_fields: + if v.__class__ is field.outer_type_: + return v, None + + # 2nd pass: check if the value is an instance of any subclass of the Union types + for field in self.sub_fields: + # This whole logic will be improved later on to support more complex `isinstance` checks + # It will probably be done once a strict mode is added and be something like: + # ``` + # value, error = field.validate(v, values, strict=True) + # if error is None: + # return value, None + # ``` + try: + if isinstance(v, field.outer_type_): + return v, None + except TypeError: + # compound type + if lenient_isinstance(v, get_origin(field.outer_type_)): + value, error = field.validate(v, values, loc=loc, cls=cls) + if not error: + return value, None + + # 1st pass by default or 3rd pass with `smart_union` enabled: + # check if the value can be coerced into one of the Union types + for field in self.sub_fields: + value, error = field.validate(v, values, loc=loc, cls=cls) + if error: + errors.append(error) + else: + return value, None + return v, errors + else: + return self._apply_validators(v, values, loc, cls, self.validators) + + def _validate_discriminated_union( + self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'] + ) -> 'ValidateReturn': + assert self.discriminator_key is not None + assert self.discriminator_alias is not None + + try: + try: + discriminator_value = v[self.discriminator_alias] + except KeyError: + if self.model_config.allow_population_by_field_name: + discriminator_value = v[self.discriminator_key] + else: + raise + except KeyError: + return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc) + except TypeError: + try: + # BaseModel or dataclass + discriminator_value = getattr(v, self.discriminator_key) + except (AttributeError, TypeError): + return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc) + + if self.sub_fields_mapping is None: + assert cls is not None + raise ConfigError( + f'field "{self.name}" not yet prepared so type is still a ForwardRef, ' + f'you might need to call {cls.__name__}.update_forward_refs().' + ) + + try: + sub_field = self.sub_fields_mapping[discriminator_value] + except (KeyError, TypeError): + # KeyError: `discriminator_value` is not in the dictionary. + # TypeError: `discriminator_value` is unhashable. + assert self.sub_fields_mapping is not None + return v, ErrorWrapper( + InvalidDiscriminator( + discriminator_key=self.discriminator_key, + discriminator_value=discriminator_value, + allowed_values=list(self.sub_fields_mapping), + ), + loc, + ) + else: + if not isinstance(loc, tuple): + loc = (loc,) + return sub_field.validate(v, values, loc=(*loc, display_as_type(sub_field.type_)), cls=cls) + + def _apply_validators( + self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'], validators: 'ValidatorsList' + ) -> 'ValidateReturn': + for validator in validators: + try: + v = validator(cls, v, values, self, self.model_config) + except (ValueError, TypeError, AssertionError) as exc: + return v, ErrorWrapper(exc, loc) + return v, None + + def is_complex(self) -> bool: + """ + Whether the field is "complex" eg. env variables should be parsed as JSON. + """ + from pydantic.v1.main import BaseModel + + return ( + self.shape != SHAPE_SINGLETON + or hasattr(self.type_, '__pydantic_model__') + or lenient_issubclass(self.type_, (BaseModel, list, set, frozenset, dict)) + ) + + def _type_display(self) -> PyObjectStr: + t = display_as_type(self.type_) + + if self.shape in MAPPING_LIKE_SHAPES: + t = f'Mapping[{display_as_type(self.key_field.type_)}, {t}]' # type: ignore + elif self.shape == SHAPE_TUPLE: + t = 'Tuple[{}]'.format(', '.join(display_as_type(f.type_) for f in self.sub_fields)) # type: ignore + elif self.shape == SHAPE_GENERIC: + assert self.sub_fields + t = '{}[{}]'.format( + display_as_type(self.type_), ', '.join(display_as_type(f.type_) for f in self.sub_fields) + ) + elif self.shape != SHAPE_SINGLETON: + t = SHAPE_NAME_LOOKUP[self.shape].format(t) + + if self.allow_none and (self.shape != SHAPE_SINGLETON or not self.sub_fields): + t = f'Optional[{t}]' + return PyObjectStr(t) + + def __repr_args__(self) -> 'ReprArgs': + args = [('name', self.name), ('type', self._type_display()), ('required', self.required)] + + if not self.required: + if self.default_factory is not None: + args.append(('default_factory', f'')) + else: + args.append(('default', self.default)) + + if self.alt_alias: + args.append(('alias', self.alias)) + return args + + +class ModelPrivateAttr(Representation): + __slots__ = ('default', 'default_factory') + + def __init__(self, default: Any = Undefined, *, default_factory: Optional[NoArgAnyCallable] = None) -> None: + self.default = default + self.default_factory = default_factory + + def get_default(self) -> Any: + return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory() + + def __eq__(self, other: Any) -> bool: + return isinstance(other, self.__class__) and (self.default, self.default_factory) == ( + other.default, + other.default_factory, + ) + + +def PrivateAttr( + default: Any = Undefined, + *, + default_factory: Optional[NoArgAnyCallable] = None, +) -> Any: + """ + Indicates that attribute is only used internally and never mixed with regular fields. + + Types or values of private attrs are not checked by pydantic and it's up to you to keep them relevant. + + Private attrs are stored in model __slots__. + + :param default: the attribute’s default value + :param default_factory: callable that will be called when a default value is needed for this attribute + If both `default` and `default_factory` are set, an error is raised. + """ + if default is not Undefined and default_factory is not None: + raise ValueError('cannot specify both default and default_factory') + + return ModelPrivateAttr( + default, + default_factory=default_factory, + ) + + +class DeferredType: + """ + Used to postpone field preparation, while creating recursive generic models. + """ + + +def is_finalvar_with_default_val(type_: Type[Any], val: Any) -> bool: + return is_finalvar(type_) and val is not Undefined and not isinstance(val, FieldInfo) diff --git a/env/Lib/site-packages/pydantic/v1/generics.py b/env/Lib/site-packages/pydantic/v1/generics.py new file mode 100644 index 0000000..9a69f2b --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/generics.py @@ -0,0 +1,400 @@ +import sys +import types +import typing +from typing import ( + TYPE_CHECKING, + Any, + ClassVar, + Dict, + ForwardRef, + Generic, + Iterator, + List, + Mapping, + Optional, + Tuple, + Type, + TypeVar, + Union, + cast, +) +from weakref import WeakKeyDictionary, WeakValueDictionary + +from typing_extensions import Annotated, Literal as ExtLiteral + +from pydantic.v1.class_validators import gather_all_validators +from pydantic.v1.fields import DeferredType +from pydantic.v1.main import BaseModel, create_model +from pydantic.v1.types import JsonWrapper +from pydantic.v1.typing import display_as_type, get_all_type_hints, get_args, get_origin, typing_base +from pydantic.v1.utils import all_identical, lenient_issubclass + +if sys.version_info >= (3, 10): + from typing import _UnionGenericAlias +if sys.version_info >= (3, 8): + from typing import Literal + +GenericModelT = TypeVar('GenericModelT', bound='GenericModel') +TypeVarType = Any # since mypy doesn't allow the use of TypeVar as a type + +CacheKey = Tuple[Type[Any], Any, Tuple[Any, ...]] +Parametrization = Mapping[TypeVarType, Type[Any]] + +# weak dictionaries allow the dynamically created parametrized versions of generic models to get collected +# once they are no longer referenced by the caller. +if sys.version_info >= (3, 9): # Typing for weak dictionaries available at 3.9 + GenericTypesCache = WeakValueDictionary[CacheKey, Type[BaseModel]] + AssignedParameters = WeakKeyDictionary[Type[BaseModel], Parametrization] +else: + GenericTypesCache = WeakValueDictionary + AssignedParameters = WeakKeyDictionary + +# _generic_types_cache is a Mapping from __class_getitem__ arguments to the parametrized version of generic models. +# This ensures multiple calls of e.g. A[B] return always the same class. +_generic_types_cache = GenericTypesCache() + +# _assigned_parameters is a Mapping from parametrized version of generic models to assigned types of parametrizations +# as captured during construction of the class (not instances). +# E.g., for generic model `Model[A, B]`, when parametrized model `Model[int, str]` is created, +# `Model[int, str]`: {A: int, B: str}` will be stored in `_assigned_parameters`. +# (This information is only otherwise available after creation from the class name string). +_assigned_parameters = AssignedParameters() + + +class GenericModel(BaseModel): + __slots__ = () + __concrete__: ClassVar[bool] = False + + if TYPE_CHECKING: + # Putting this in a TYPE_CHECKING block allows us to replace `if Generic not in cls.__bases__` with + # `not hasattr(cls, "__parameters__")`. This means we don't need to force non-concrete subclasses of + # `GenericModel` to also inherit from `Generic`, which would require changes to the use of `create_model` below. + __parameters__: ClassVar[Tuple[TypeVarType, ...]] + + # Setting the return type as Type[Any] instead of Type[BaseModel] prevents PyCharm warnings + def __class_getitem__(cls: Type[GenericModelT], params: Union[Type[Any], Tuple[Type[Any], ...]]) -> Type[Any]: + """Instantiates a new class from a generic class `cls` and type variables `params`. + + :param params: Tuple of types the class . Given a generic class + `Model` with 2 type variables and a concrete model `Model[str, int]`, + the value `(str, int)` would be passed to `params`. + :return: New model class inheriting from `cls` with instantiated + types described by `params`. If no parameters are given, `cls` is + returned as is. + + """ + + def _cache_key(_params: Any) -> CacheKey: + args = get_args(_params) + # python returns a list for Callables, which is not hashable + if len(args) == 2 and isinstance(args[0], list): + args = (tuple(args[0]), args[1]) + return cls, _params, args + + cached = _generic_types_cache.get(_cache_key(params)) + if cached is not None: + return cached + if cls.__concrete__ and Generic not in cls.__bases__: + raise TypeError('Cannot parameterize a concrete instantiation of a generic model') + if not isinstance(params, tuple): + params = (params,) + if cls is GenericModel and any(isinstance(param, TypeVar) for param in params): + raise TypeError('Type parameters should be placed on typing.Generic, not GenericModel') + if not hasattr(cls, '__parameters__'): + raise TypeError(f'Type {cls.__name__} must inherit from typing.Generic before being parameterized') + + check_parameters_count(cls, params) + # Build map from generic typevars to passed params + typevars_map: Dict[TypeVarType, Type[Any]] = dict(zip(cls.__parameters__, params)) + if all_identical(typevars_map.keys(), typevars_map.values()) and typevars_map: + return cls # if arguments are equal to parameters it's the same object + + # Create new model with original model as parent inserting fields with DeferredType. + model_name = cls.__concrete_name__(params) + validators = gather_all_validators(cls) + + type_hints = get_all_type_hints(cls).items() + instance_type_hints = {k: v for k, v in type_hints if get_origin(v) is not ClassVar} + + fields = {k: (DeferredType(), cls.__fields__[k].field_info) for k in instance_type_hints if k in cls.__fields__} + + model_module, called_globally = get_caller_frame_info() + created_model = cast( + Type[GenericModel], # casting ensures mypy is aware of the __concrete__ and __parameters__ attributes + create_model( + model_name, + __module__=model_module or cls.__module__, + __base__=(cls,) + tuple(cls.__parameterized_bases__(typevars_map)), + __config__=None, + __validators__=validators, + __cls_kwargs__=None, + **fields, + ), + ) + + _assigned_parameters[created_model] = typevars_map + + if called_globally: # create global reference and therefore allow pickling + object_by_reference = None + reference_name = model_name + reference_module_globals = sys.modules[created_model.__module__].__dict__ + while object_by_reference is not created_model: + object_by_reference = reference_module_globals.setdefault(reference_name, created_model) + reference_name += '_' + + created_model.Config = cls.Config + + # Find any typevars that are still present in the model. + # If none are left, the model is fully "concrete", otherwise the new + # class is a generic class as well taking the found typevars as + # parameters. + new_params = tuple( + {param: None for param in iter_contained_typevars(typevars_map.values())} + ) # use dict as ordered set + created_model.__concrete__ = not new_params + if new_params: + created_model.__parameters__ = new_params + + # Save created model in cache so we don't end up creating duplicate + # models that should be identical. + _generic_types_cache[_cache_key(params)] = created_model + if len(params) == 1: + _generic_types_cache[_cache_key(params[0])] = created_model + + # Recursively walk class type hints and replace generic typevars + # with concrete types that were passed. + _prepare_model_fields(created_model, fields, instance_type_hints, typevars_map) + + return created_model + + @classmethod + def __concrete_name__(cls: Type[Any], params: Tuple[Type[Any], ...]) -> str: + """Compute class name for child classes. + + :param params: Tuple of types the class . Given a generic class + `Model` with 2 type variables and a concrete model `Model[str, int]`, + the value `(str, int)` would be passed to `params`. + :return: String representing a the new class where `params` are + passed to `cls` as type variables. + + This method can be overridden to achieve a custom naming scheme for GenericModels. + """ + param_names = [display_as_type(param) for param in params] + params_component = ', '.join(param_names) + return f'{cls.__name__}[{params_component}]' + + @classmethod + def __parameterized_bases__(cls, typevars_map: Parametrization) -> Iterator[Type[Any]]: + """ + Returns unbound bases of cls parameterised to given type variables + + :param typevars_map: Dictionary of type applications for binding subclasses. + Given a generic class `Model` with 2 type variables [S, T] + and a concrete model `Model[str, int]`, + the value `{S: str, T: int}` would be passed to `typevars_map`. + :return: an iterator of generic sub classes, parameterised by `typevars_map` + and other assigned parameters of `cls` + + e.g.: + ``` + class A(GenericModel, Generic[T]): + ... + + class B(A[V], Generic[V]): + ... + + assert A[int] in B.__parameterized_bases__({V: int}) + ``` + """ + + def build_base_model( + base_model: Type[GenericModel], mapped_types: Parametrization + ) -> Iterator[Type[GenericModel]]: + base_parameters = tuple(mapped_types[param] for param in base_model.__parameters__) + parameterized_base = base_model.__class_getitem__(base_parameters) + if parameterized_base is base_model or parameterized_base is cls: + # Avoid duplication in MRO + return + yield parameterized_base + + for base_model in cls.__bases__: + if not issubclass(base_model, GenericModel): + # not a class that can be meaningfully parameterized + continue + elif not getattr(base_model, '__parameters__', None): + # base_model is "GenericModel" (and has no __parameters__) + # or + # base_model is already concrete, and will be included transitively via cls. + continue + elif cls in _assigned_parameters: + if base_model in _assigned_parameters: + # cls is partially parameterised but not from base_model + # e.g. cls = B[S], base_model = A[S] + # B[S][int] should subclass A[int], (and will be transitively via B[int]) + # but it's not viable to consistently subclass types with arbitrary construction + # So don't attempt to include A[S][int] + continue + else: # base_model not in _assigned_parameters: + # cls is partially parameterized, base_model is original generic + # e.g. cls = B[str, T], base_model = B[S, T] + # Need to determine the mapping for the base_model parameters + mapped_types: Parametrization = { + key: typevars_map.get(value, value) for key, value in _assigned_parameters[cls].items() + } + yield from build_base_model(base_model, mapped_types) + else: + # cls is base generic, so base_class has a distinct base + # can construct the Parameterised base model using typevars_map directly + yield from build_base_model(base_model, typevars_map) + + +def replace_types(type_: Any, type_map: Mapping[Any, Any]) -> Any: + """Return type with all occurrences of `type_map` keys recursively replaced with their values. + + :param type_: Any type, class or generic alias + :param type_map: Mapping from `TypeVar` instance to concrete types. + :return: New type representing the basic structure of `type_` with all + `typevar_map` keys recursively replaced. + + >>> replace_types(Tuple[str, Union[List[str], float]], {str: int}) + Tuple[int, Union[List[int], float]] + + """ + if not type_map: + return type_ + + type_args = get_args(type_) + origin_type = get_origin(type_) + + if origin_type is Annotated: + annotated_type, *annotations = type_args + return Annotated[replace_types(annotated_type, type_map), tuple(annotations)] + + if (origin_type is ExtLiteral) or (sys.version_info >= (3, 8) and origin_type is Literal): + return type_map.get(type_, type_) + # Having type args is a good indicator that this is a typing module + # class instantiation or a generic alias of some sort. + if type_args: + resolved_type_args = tuple(replace_types(arg, type_map) for arg in type_args) + if all_identical(type_args, resolved_type_args): + # If all arguments are the same, there is no need to modify the + # type or create a new object at all + return type_ + if ( + origin_type is not None + and isinstance(type_, typing_base) + and not isinstance(origin_type, typing_base) + and getattr(type_, '_name', None) is not None + ): + # In python < 3.9 generic aliases don't exist so any of these like `list`, + # `type` or `collections.abc.Callable` need to be translated. + # See: https://www.python.org/dev/peps/pep-0585 + origin_type = getattr(typing, type_._name) + assert origin_type is not None + # PEP-604 syntax (Ex.: list | str) is represented with a types.UnionType object that does not have __getitem__. + # We also cannot use isinstance() since we have to compare types. + if sys.version_info >= (3, 10) and origin_type is types.UnionType: # noqa: E721 + return _UnionGenericAlias(origin_type, resolved_type_args) + return origin_type[resolved_type_args] + + # We handle pydantic generic models separately as they don't have the same + # semantics as "typing" classes or generic aliases + if not origin_type and lenient_issubclass(type_, GenericModel) and not type_.__concrete__: + type_args = type_.__parameters__ + resolved_type_args = tuple(replace_types(t, type_map) for t in type_args) + if all_identical(type_args, resolved_type_args): + return type_ + return type_[resolved_type_args] + + # Handle special case for typehints that can have lists as arguments. + # `typing.Callable[[int, str], int]` is an example for this. + if isinstance(type_, (List, list)): + resolved_list = list(replace_types(element, type_map) for element in type_) + if all_identical(type_, resolved_list): + return type_ + return resolved_list + + # For JsonWrapperValue, need to handle its inner type to allow correct parsing + # of generic Json arguments like Json[T] + if not origin_type and lenient_issubclass(type_, JsonWrapper): + type_.inner_type = replace_types(type_.inner_type, type_map) + return type_ + + # If all else fails, we try to resolve the type directly and otherwise just + # return the input with no modifications. + new_type = type_map.get(type_, type_) + # Convert string to ForwardRef + if isinstance(new_type, str): + return ForwardRef(new_type) + else: + return new_type + + +def check_parameters_count(cls: Type[GenericModel], parameters: Tuple[Any, ...]) -> None: + actual = len(parameters) + expected = len(cls.__parameters__) + if actual != expected: + description = 'many' if actual > expected else 'few' + raise TypeError(f'Too {description} parameters for {cls.__name__}; actual {actual}, expected {expected}') + + +DictValues: Type[Any] = {}.values().__class__ + + +def iter_contained_typevars(v: Any) -> Iterator[TypeVarType]: + """Recursively iterate through all subtypes and type args of `v` and yield any typevars that are found.""" + if isinstance(v, TypeVar): + yield v + elif hasattr(v, '__parameters__') and not get_origin(v) and lenient_issubclass(v, GenericModel): + yield from v.__parameters__ + elif isinstance(v, (DictValues, list)): + for var in v: + yield from iter_contained_typevars(var) + else: + args = get_args(v) + for arg in args: + yield from iter_contained_typevars(arg) + + +def get_caller_frame_info() -> Tuple[Optional[str], bool]: + """ + Used inside a function to check whether it was called globally + + Will only work against non-compiled code, therefore used only in pydantic.generics + + :returns Tuple[module_name, called_globally] + """ + try: + previous_caller_frame = sys._getframe(2) + except ValueError as e: + raise RuntimeError('This function must be used inside another function') from e + except AttributeError: # sys module does not have _getframe function, so there's nothing we can do about it + return None, False + frame_globals = previous_caller_frame.f_globals + return frame_globals.get('__name__'), previous_caller_frame.f_locals is frame_globals + + +def _prepare_model_fields( + created_model: Type[GenericModel], + fields: Mapping[str, Any], + instance_type_hints: Mapping[str, type], + typevars_map: Mapping[Any, type], +) -> None: + """ + Replace DeferredType fields with concrete type hints and prepare them. + """ + + for key, field in created_model.__fields__.items(): + if key not in fields: + assert field.type_.__class__ is not DeferredType + # https://github.com/nedbat/coveragepy/issues/198 + continue # pragma: no cover + + assert field.type_.__class__ is DeferredType, field.type_.__class__ + + field_type_hint = instance_type_hints[key] + concrete_type = replace_types(field_type_hint, typevars_map) + field.type_ = concrete_type + field.outer_type_ = concrete_type + field.prepare() + created_model.__annotations__[key] = concrete_type diff --git a/env/Lib/site-packages/pydantic/v1/json.py b/env/Lib/site-packages/pydantic/v1/json.py new file mode 100644 index 0000000..41d0d5f --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/json.py @@ -0,0 +1,112 @@ +import datetime +from collections import deque +from decimal import Decimal +from enum import Enum +from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network +from pathlib import Path +from re import Pattern +from types import GeneratorType +from typing import Any, Callable, Dict, Type, Union +from uuid import UUID + +from pydantic.v1.color import Color +from pydantic.v1.networks import NameEmail +from pydantic.v1.types import SecretBytes, SecretStr + +__all__ = 'pydantic_encoder', 'custom_pydantic_encoder', 'timedelta_isoformat' + + +def isoformat(o: Union[datetime.date, datetime.time]) -> str: + return o.isoformat() + + +def decimal_encoder(dec_value: Decimal) -> Union[int, float]: + """ + Encodes a Decimal as int of there's no exponent, otherwise float + + This is useful when we use ConstrainedDecimal to represent Numeric(x,0) + where a integer (but not int typed) is used. Encoding this as a float + results in failed round-tripping between encode and parse. + Our Id type is a prime example of this. + + >>> decimal_encoder(Decimal("1.0")) + 1.0 + + >>> decimal_encoder(Decimal("1")) + 1 + """ + if dec_value.as_tuple().exponent >= 0: + return int(dec_value) + else: + return float(dec_value) + + +ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = { + bytes: lambda o: o.decode(), + Color: str, + datetime.date: isoformat, + datetime.datetime: isoformat, + datetime.time: isoformat, + datetime.timedelta: lambda td: td.total_seconds(), + Decimal: decimal_encoder, + Enum: lambda o: o.value, + frozenset: list, + deque: list, + GeneratorType: list, + IPv4Address: str, + IPv4Interface: str, + IPv4Network: str, + IPv6Address: str, + IPv6Interface: str, + IPv6Network: str, + NameEmail: str, + Path: str, + Pattern: lambda o: o.pattern, + SecretBytes: str, + SecretStr: str, + set: list, + UUID: str, +} + + +def pydantic_encoder(obj: Any) -> Any: + from dataclasses import asdict, is_dataclass + + from pydantic.v1.main import BaseModel + + if isinstance(obj, BaseModel): + return obj.dict() + elif is_dataclass(obj): + return asdict(obj) + + # Check the class type and its superclasses for a matching encoder + for base in obj.__class__.__mro__[:-1]: + try: + encoder = ENCODERS_BY_TYPE[base] + except KeyError: + continue + return encoder(obj) + else: # We have exited the for loop without finding a suitable encoder + raise TypeError(f"Object of type '{obj.__class__.__name__}' is not JSON serializable") + + +def custom_pydantic_encoder(type_encoders: Dict[Any, Callable[[Type[Any]], Any]], obj: Any) -> Any: + # Check the class type and its superclasses for a matching encoder + for base in obj.__class__.__mro__[:-1]: + try: + encoder = type_encoders[base] + except KeyError: + continue + + return encoder(obj) + else: # We have exited the for loop without finding a suitable encoder + return pydantic_encoder(obj) + + +def timedelta_isoformat(td: datetime.timedelta) -> str: + """ + ISO 8601 encoding for Python timedelta object. + """ + minutes, seconds = divmod(td.seconds, 60) + hours, minutes = divmod(minutes, 60) + return f'{"-" if td.days < 0 else ""}P{abs(td.days)}DT{hours:d}H{minutes:d}M{seconds:d}.{td.microseconds:06d}S' diff --git a/env/Lib/site-packages/pydantic/v1/main.py b/env/Lib/site-packages/pydantic/v1/main.py new file mode 100644 index 0000000..cd37603 --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/main.py @@ -0,0 +1,1107 @@ +import warnings +from abc import ABCMeta +from copy import deepcopy +from enum import Enum +from functools import partial +from pathlib import Path +from types import FunctionType, prepare_class, resolve_bases +from typing import ( + TYPE_CHECKING, + AbstractSet, + Any, + Callable, + ClassVar, + Dict, + List, + Mapping, + Optional, + Tuple, + Type, + TypeVar, + Union, + cast, + no_type_check, + overload, +) + +from typing_extensions import dataclass_transform + +from pydantic.v1.class_validators import ValidatorGroup, extract_root_validators, extract_validators, inherit_validators +from pydantic.v1.config import BaseConfig, Extra, inherit_config, prepare_config +from pydantic.v1.error_wrappers import ErrorWrapper, ValidationError +from pydantic.v1.errors import ConfigError, DictError, ExtraError, MissingError +from pydantic.v1.fields import ( + MAPPING_LIKE_SHAPES, + Field, + ModelField, + ModelPrivateAttr, + PrivateAttr, + Undefined, + is_finalvar_with_default_val, +) +from pydantic.v1.json import custom_pydantic_encoder, pydantic_encoder +from pydantic.v1.parse import Protocol, load_file, load_str_bytes +from pydantic.v1.schema import default_ref_template, model_schema +from pydantic.v1.types import PyObject, StrBytes +from pydantic.v1.typing import ( + AnyCallable, + get_args, + get_origin, + is_classvar, + is_namedtuple, + is_union, + resolve_annotations, + update_model_forward_refs, +) +from pydantic.v1.utils import ( + DUNDER_ATTRIBUTES, + ROOT_KEY, + ClassAttribute, + GetterDict, + Representation, + ValueItems, + generate_model_signature, + is_valid_field, + is_valid_private_name, + lenient_issubclass, + sequence_like, + smart_deepcopy, + unique_list, + validate_field_name, +) + +if TYPE_CHECKING: + from inspect import Signature + + from pydantic.v1.class_validators import ValidatorListDict + from pydantic.v1.types import ModelOrDc + from pydantic.v1.typing import ( + AbstractSetIntStr, + AnyClassMethod, + CallableGenerator, + DictAny, + DictStrAny, + MappingIntStrAny, + ReprArgs, + SetStr, + TupleGenerator, + ) + + Model = TypeVar('Model', bound='BaseModel') + +__all__ = 'BaseModel', 'create_model', 'validate_model' + +_T = TypeVar('_T') + + +def validate_custom_root_type(fields: Dict[str, ModelField]) -> None: + if len(fields) > 1: + raise ValueError(f'{ROOT_KEY} cannot be mixed with other fields') + + +def generate_hash_function(frozen: bool) -> Optional[Callable[[Any], int]]: + def hash_function(self_: Any) -> int: + return hash(self_.__class__) + hash(tuple(self_.__dict__.values())) + + return hash_function if frozen else None + + +# If a field is of type `Callable`, its default value should be a function and cannot to ignored. +ANNOTATED_FIELD_UNTOUCHED_TYPES: Tuple[Any, ...] = (property, type, classmethod, staticmethod) +# When creating a `BaseModel` instance, we bypass all the methods, properties... added to the model +UNTOUCHED_TYPES: Tuple[Any, ...] = (FunctionType,) + ANNOTATED_FIELD_UNTOUCHED_TYPES +# Note `ModelMetaclass` refers to `BaseModel`, but is also used to *create* `BaseModel`, so we need to add this extra +# (somewhat hacky) boolean to keep track of whether we've created the `BaseModel` class yet, and therefore whether it's +# safe to refer to it. If it *hasn't* been created, we assume that the `__new__` call we're in the middle of is for +# the `BaseModel` class, since that's defined immediately after the metaclass. +_is_base_model_class_defined = False + + +@dataclass_transform(kw_only_default=True, field_specifiers=(Field,)) +class ModelMetaclass(ABCMeta): + @no_type_check # noqa C901 + def __new__(mcs, name, bases, namespace, **kwargs): # noqa C901 + fields: Dict[str, ModelField] = {} + config = BaseConfig + validators: 'ValidatorListDict' = {} + + pre_root_validators, post_root_validators = [], [] + private_attributes: Dict[str, ModelPrivateAttr] = {} + base_private_attributes: Dict[str, ModelPrivateAttr] = {} + slots: SetStr = namespace.get('__slots__', ()) + slots = {slots} if isinstance(slots, str) else set(slots) + class_vars: SetStr = set() + hash_func: Optional[Callable[[Any], int]] = None + + for base in reversed(bases): + if _is_base_model_class_defined and issubclass(base, BaseModel) and base != BaseModel: + fields.update(smart_deepcopy(base.__fields__)) + config = inherit_config(base.__config__, config) + validators = inherit_validators(base.__validators__, validators) + pre_root_validators += base.__pre_root_validators__ + post_root_validators += base.__post_root_validators__ + base_private_attributes.update(base.__private_attributes__) + class_vars.update(base.__class_vars__) + hash_func = base.__hash__ + + resolve_forward_refs = kwargs.pop('__resolve_forward_refs__', True) + allowed_config_kwargs: SetStr = { + key + for key in dir(config) + if not (key.startswith('__') and key.endswith('__')) # skip dunder methods and attributes + } + config_kwargs = {key: kwargs.pop(key) for key in kwargs.keys() & allowed_config_kwargs} + config_from_namespace = namespace.get('Config') + if config_kwargs and config_from_namespace: + raise TypeError('Specifying config in two places is ambiguous, use either Config attribute or class kwargs') + config = inherit_config(config_from_namespace, config, **config_kwargs) + + validators = inherit_validators(extract_validators(namespace), validators) + vg = ValidatorGroup(validators) + + for f in fields.values(): + f.set_config(config) + extra_validators = vg.get_validators(f.name) + if extra_validators: + f.class_validators.update(extra_validators) + # re-run prepare to add extra validators + f.populate_validators() + + prepare_config(config, name) + + untouched_types = ANNOTATED_FIELD_UNTOUCHED_TYPES + + def is_untouched(v: Any) -> bool: + return isinstance(v, untouched_types) or v.__class__.__name__ == 'cython_function_or_method' + + if (namespace.get('__module__'), namespace.get('__qualname__')) != ('pydantic.main', 'BaseModel'): + annotations = resolve_annotations(namespace.get('__annotations__', {}), namespace.get('__module__', None)) + # annotation only fields need to come first in fields + for ann_name, ann_type in annotations.items(): + if is_classvar(ann_type): + class_vars.add(ann_name) + elif is_finalvar_with_default_val(ann_type, namespace.get(ann_name, Undefined)): + class_vars.add(ann_name) + elif is_valid_field(ann_name): + validate_field_name(bases, ann_name) + value = namespace.get(ann_name, Undefined) + allowed_types = get_args(ann_type) if is_union(get_origin(ann_type)) else (ann_type,) + if ( + is_untouched(value) + and ann_type != PyObject + and not any( + lenient_issubclass(get_origin(allowed_type), Type) for allowed_type in allowed_types + ) + ): + continue + fields[ann_name] = ModelField.infer( + name=ann_name, + value=value, + annotation=ann_type, + class_validators=vg.get_validators(ann_name), + config=config, + ) + elif ann_name not in namespace and config.underscore_attrs_are_private: + private_attributes[ann_name] = PrivateAttr() + + untouched_types = UNTOUCHED_TYPES + config.keep_untouched + for var_name, value in namespace.items(): + can_be_changed = var_name not in class_vars and not is_untouched(value) + if isinstance(value, ModelPrivateAttr): + if not is_valid_private_name(var_name): + raise NameError( + f'Private attributes "{var_name}" must not be a valid field name; ' + f'Use sunder or dunder names, e. g. "_{var_name}" or "__{var_name}__"' + ) + private_attributes[var_name] = value + elif config.underscore_attrs_are_private and is_valid_private_name(var_name) and can_be_changed: + private_attributes[var_name] = PrivateAttr(default=value) + elif is_valid_field(var_name) and var_name not in annotations and can_be_changed: + validate_field_name(bases, var_name) + inferred = ModelField.infer( + name=var_name, + value=value, + annotation=annotations.get(var_name, Undefined), + class_validators=vg.get_validators(var_name), + config=config, + ) + if var_name in fields: + if lenient_issubclass(inferred.type_, fields[var_name].type_): + inferred.type_ = fields[var_name].type_ + else: + raise TypeError( + f'The type of {name}.{var_name} differs from the new default value; ' + f'if you wish to change the type of this field, please use a type annotation' + ) + fields[var_name] = inferred + + _custom_root_type = ROOT_KEY in fields + if _custom_root_type: + validate_custom_root_type(fields) + vg.check_for_unused() + if config.json_encoders: + json_encoder = partial(custom_pydantic_encoder, config.json_encoders) + else: + json_encoder = pydantic_encoder + pre_rv_new, post_rv_new = extract_root_validators(namespace) + + if hash_func is None: + hash_func = generate_hash_function(config.frozen) + + exclude_from_namespace = fields | private_attributes.keys() | {'__slots__'} + new_namespace = { + '__config__': config, + '__fields__': fields, + '__exclude_fields__': { + name: field.field_info.exclude for name, field in fields.items() if field.field_info.exclude is not None + } + or None, + '__include_fields__': { + name: field.field_info.include for name, field in fields.items() if field.field_info.include is not None + } + or None, + '__validators__': vg.validators, + '__pre_root_validators__': unique_list( + pre_root_validators + pre_rv_new, + name_factory=lambda v: v.__name__, + ), + '__post_root_validators__': unique_list( + post_root_validators + post_rv_new, + name_factory=lambda skip_on_failure_and_v: skip_on_failure_and_v[1].__name__, + ), + '__schema_cache__': {}, + '__json_encoder__': staticmethod(json_encoder), + '__custom_root_type__': _custom_root_type, + '__private_attributes__': {**base_private_attributes, **private_attributes}, + '__slots__': slots | private_attributes.keys(), + '__hash__': hash_func, + '__class_vars__': class_vars, + **{n: v for n, v in namespace.items() if n not in exclude_from_namespace}, + } + + cls = super().__new__(mcs, name, bases, new_namespace, **kwargs) + # set __signature__ attr only for model class, but not for its instances + cls.__signature__ = ClassAttribute('__signature__', generate_model_signature(cls.__init__, fields, config)) + if resolve_forward_refs: + cls.__try_update_forward_refs__() + + # preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487 + # for attributes not in `new_namespace` (e.g. private attributes) + for name, obj in namespace.items(): + if name not in new_namespace: + set_name = getattr(obj, '__set_name__', None) + if callable(set_name): + set_name(cls, name) + + return cls + + def __instancecheck__(self, instance: Any) -> bool: + """ + Avoid calling ABC _abc_subclasscheck unless we're pretty sure. + + See #3829 and python/cpython#92810 + """ + return hasattr(instance, '__fields__') and super().__instancecheck__(instance) + + +object_setattr = object.__setattr__ + + +class BaseModel(Representation, metaclass=ModelMetaclass): + if TYPE_CHECKING: + # populated by the metaclass, defined here to help IDEs only + __fields__: ClassVar[Dict[str, ModelField]] = {} + __include_fields__: ClassVar[Optional[Mapping[str, Any]]] = None + __exclude_fields__: ClassVar[Optional[Mapping[str, Any]]] = None + __validators__: ClassVar[Dict[str, AnyCallable]] = {} + __pre_root_validators__: ClassVar[List[AnyCallable]] + __post_root_validators__: ClassVar[List[Tuple[bool, AnyCallable]]] + __config__: ClassVar[Type[BaseConfig]] = BaseConfig + __json_encoder__: ClassVar[Callable[[Any], Any]] = lambda x: x + __schema_cache__: ClassVar['DictAny'] = {} + __custom_root_type__: ClassVar[bool] = False + __signature__: ClassVar['Signature'] + __private_attributes__: ClassVar[Dict[str, ModelPrivateAttr]] + __class_vars__: ClassVar[SetStr] + __fields_set__: ClassVar[SetStr] = set() + + Config = BaseConfig + __slots__ = ('__dict__', '__fields_set__') + __doc__ = '' # Null out the Representation docstring + + def __init__(__pydantic_self__, **data: Any) -> None: + """ + Create a new model by parsing and validating input data from keyword arguments. + + Raises ValidationError if the input data cannot be parsed to form a valid model. + """ + # Uses something other than `self` the first arg to allow "self" as a settable attribute + values, fields_set, validation_error = validate_model(__pydantic_self__.__class__, data) + if validation_error: + raise validation_error + try: + object_setattr(__pydantic_self__, '__dict__', values) + except TypeError as e: + raise TypeError( + 'Model values must be a dict; you may not have returned a dictionary from a root validator' + ) from e + object_setattr(__pydantic_self__, '__fields_set__', fields_set) + __pydantic_self__._init_private_attributes() + + @no_type_check + def __setattr__(self, name, value): # noqa: C901 (ignore complexity) + if name in self.__private_attributes__ or name in DUNDER_ATTRIBUTES: + return object_setattr(self, name, value) + + if self.__config__.extra is not Extra.allow and name not in self.__fields__: + raise ValueError(f'"{self.__class__.__name__}" object has no field "{name}"') + elif not self.__config__.allow_mutation or self.__config__.frozen: + raise TypeError(f'"{self.__class__.__name__}" is immutable and does not support item assignment') + elif name in self.__fields__ and self.__fields__[name].final: + raise TypeError( + f'"{self.__class__.__name__}" object "{name}" field is final and does not support reassignment' + ) + elif self.__config__.validate_assignment: + new_values = {**self.__dict__, name: value} + + for validator in self.__pre_root_validators__: + try: + new_values = validator(self.__class__, new_values) + except (ValueError, TypeError, AssertionError) as exc: + raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], self.__class__) + + known_field = self.__fields__.get(name, None) + if known_field: + # We want to + # - make sure validators are called without the current value for this field inside `values` + # - keep other values (e.g. submodels) untouched (using `BaseModel.dict()` will change them into dicts) + # - keep the order of the fields + if not known_field.field_info.allow_mutation: + raise TypeError(f'"{known_field.name}" has allow_mutation set to False and cannot be assigned') + dict_without_original_value = {k: v for k, v in self.__dict__.items() if k != name} + value, error_ = known_field.validate(value, dict_without_original_value, loc=name, cls=self.__class__) + if error_: + raise ValidationError([error_], self.__class__) + else: + new_values[name] = value + + errors = [] + for skip_on_failure, validator in self.__post_root_validators__: + if skip_on_failure and errors: + continue + try: + new_values = validator(self.__class__, new_values) + except (ValueError, TypeError, AssertionError) as exc: + errors.append(ErrorWrapper(exc, loc=ROOT_KEY)) + if errors: + raise ValidationError(errors, self.__class__) + + # update the whole __dict__ as other values than just `value` + # may be changed (e.g. with `root_validator`) + object_setattr(self, '__dict__', new_values) + else: + self.__dict__[name] = value + + self.__fields_set__.add(name) + + def __getstate__(self) -> 'DictAny': + private_attrs = ((k, getattr(self, k, Undefined)) for k in self.__private_attributes__) + return { + '__dict__': self.__dict__, + '__fields_set__': self.__fields_set__, + '__private_attribute_values__': {k: v for k, v in private_attrs if v is not Undefined}, + } + + def __setstate__(self, state: 'DictAny') -> None: + object_setattr(self, '__dict__', state['__dict__']) + object_setattr(self, '__fields_set__', state['__fields_set__']) + for name, value in state.get('__private_attribute_values__', {}).items(): + object_setattr(self, name, value) + + def _init_private_attributes(self) -> None: + for name, private_attr in self.__private_attributes__.items(): + default = private_attr.get_default() + if default is not Undefined: + object_setattr(self, name, default) + + def dict( + self, + *, + include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + by_alias: bool = False, + skip_defaults: Optional[bool] = None, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + ) -> 'DictStrAny': + """ + Generate a dictionary representation of the model, optionally specifying which fields to include or exclude. + + """ + if skip_defaults is not None: + warnings.warn( + f'{self.__class__.__name__}.dict(): "skip_defaults" is deprecated and replaced by "exclude_unset"', + DeprecationWarning, + ) + exclude_unset = skip_defaults + + return dict( + self._iter( + to_dict=True, + by_alias=by_alias, + include=include, + exclude=exclude, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + ) + + def json( + self, + *, + include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + by_alias: bool = False, + skip_defaults: Optional[bool] = None, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + encoder: Optional[Callable[[Any], Any]] = None, + models_as_dict: bool = True, + **dumps_kwargs: Any, + ) -> str: + """ + Generate a JSON representation of the model, `include` and `exclude` arguments as per `dict()`. + + `encoder` is an optional function to supply as `default` to json.dumps(), other arguments as per `json.dumps()`. + """ + if skip_defaults is not None: + warnings.warn( + f'{self.__class__.__name__}.json(): "skip_defaults" is deprecated and replaced by "exclude_unset"', + DeprecationWarning, + ) + exclude_unset = skip_defaults + encoder = cast(Callable[[Any], Any], encoder or self.__json_encoder__) + + # We don't directly call `self.dict()`, which does exactly this with `to_dict=True` + # because we want to be able to keep raw `BaseModel` instances and not as `dict`. + # This allows users to write custom JSON encoders for given `BaseModel` classes. + data = dict( + self._iter( + to_dict=models_as_dict, + by_alias=by_alias, + include=include, + exclude=exclude, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + ) + if self.__custom_root_type__: + data = data[ROOT_KEY] + return self.__config__.json_dumps(data, default=encoder, **dumps_kwargs) + + @classmethod + def _enforce_dict_if_root(cls, obj: Any) -> Any: + if cls.__custom_root_type__ and ( + not (isinstance(obj, dict) and obj.keys() == {ROOT_KEY}) + and not (isinstance(obj, BaseModel) and obj.__fields__.keys() == {ROOT_KEY}) + or cls.__fields__[ROOT_KEY].shape in MAPPING_LIKE_SHAPES + ): + return {ROOT_KEY: obj} + else: + return obj + + @classmethod + def parse_obj(cls: Type['Model'], obj: Any) -> 'Model': + obj = cls._enforce_dict_if_root(obj) + if not isinstance(obj, dict): + try: + obj = dict(obj) + except (TypeError, ValueError) as e: + exc = TypeError(f'{cls.__name__} expected dict not {obj.__class__.__name__}') + raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls) from e + return cls(**obj) + + @classmethod + def parse_raw( + cls: Type['Model'], + b: StrBytes, + *, + content_type: str = None, + encoding: str = 'utf8', + proto: Protocol = None, + allow_pickle: bool = False, + ) -> 'Model': + try: + obj = load_str_bytes( + b, + proto=proto, + content_type=content_type, + encoding=encoding, + allow_pickle=allow_pickle, + json_loads=cls.__config__.json_loads, + ) + except (ValueError, TypeError, UnicodeDecodeError) as e: + raise ValidationError([ErrorWrapper(e, loc=ROOT_KEY)], cls) + return cls.parse_obj(obj) + + @classmethod + def parse_file( + cls: Type['Model'], + path: Union[str, Path], + *, + content_type: str = None, + encoding: str = 'utf8', + proto: Protocol = None, + allow_pickle: bool = False, + ) -> 'Model': + obj = load_file( + path, + proto=proto, + content_type=content_type, + encoding=encoding, + allow_pickle=allow_pickle, + json_loads=cls.__config__.json_loads, + ) + return cls.parse_obj(obj) + + @classmethod + def from_orm(cls: Type['Model'], obj: Any) -> 'Model': + if not cls.__config__.orm_mode: + raise ConfigError('You must have the config attribute orm_mode=True to use from_orm') + obj = {ROOT_KEY: obj} if cls.__custom_root_type__ else cls._decompose_class(obj) + m = cls.__new__(cls) + values, fields_set, validation_error = validate_model(cls, obj) + if validation_error: + raise validation_error + object_setattr(m, '__dict__', values) + object_setattr(m, '__fields_set__', fields_set) + m._init_private_attributes() + return m + + @classmethod + def construct(cls: Type['Model'], _fields_set: Optional['SetStr'] = None, **values: Any) -> 'Model': + """ + Creates a new model setting __dict__ and __fields_set__ from trusted or pre-validated data. + Default values are respected, but no other validation is performed. + Behaves as if `Config.extra = 'allow'` was set since it adds all passed values + """ + m = cls.__new__(cls) + fields_values: Dict[str, Any] = {} + for name, field in cls.__fields__.items(): + if field.alt_alias and field.alias in values: + fields_values[name] = values[field.alias] + elif name in values: + fields_values[name] = values[name] + elif not field.required: + fields_values[name] = field.get_default() + fields_values.update(values) + object_setattr(m, '__dict__', fields_values) + if _fields_set is None: + _fields_set = set(values.keys()) + object_setattr(m, '__fields_set__', _fields_set) + m._init_private_attributes() + return m + + def _copy_and_set_values(self: 'Model', values: 'DictStrAny', fields_set: 'SetStr', *, deep: bool) -> 'Model': + if deep: + # chances of having empty dict here are quite low for using smart_deepcopy + values = deepcopy(values) + + cls = self.__class__ + m = cls.__new__(cls) + object_setattr(m, '__dict__', values) + object_setattr(m, '__fields_set__', fields_set) + for name in self.__private_attributes__: + value = getattr(self, name, Undefined) + if value is not Undefined: + if deep: + value = deepcopy(value) + object_setattr(m, name, value) + + return m + + def copy( + self: 'Model', + *, + include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + update: Optional['DictStrAny'] = None, + deep: bool = False, + ) -> 'Model': + """ + Duplicate a model, optionally choose which fields to include, exclude and change. + + :param include: fields to include in new model + :param exclude: fields to exclude from new model, as with values this takes precedence over include + :param update: values to change/add in the new model. Note: the data is not validated before creating + the new model: you should trust this data + :param deep: set to `True` to make a deep copy of the model + :return: new model instance + """ + + values = dict( + self._iter(to_dict=False, by_alias=False, include=include, exclude=exclude, exclude_unset=False), + **(update or {}), + ) + + # new `__fields_set__` can have unset optional fields with a set value in `update` kwarg + if update: + fields_set = self.__fields_set__ | update.keys() + else: + fields_set = set(self.__fields_set__) + + return self._copy_and_set_values(values, fields_set, deep=deep) + + @classmethod + def schema(cls, by_alias: bool = True, ref_template: str = default_ref_template) -> 'DictStrAny': + cached = cls.__schema_cache__.get((by_alias, ref_template)) + if cached is not None: + return cached + s = model_schema(cls, by_alias=by_alias, ref_template=ref_template) + cls.__schema_cache__[(by_alias, ref_template)] = s + return s + + @classmethod + def schema_json( + cls, *, by_alias: bool = True, ref_template: str = default_ref_template, **dumps_kwargs: Any + ) -> str: + from pydantic.v1.json import pydantic_encoder + + return cls.__config__.json_dumps( + cls.schema(by_alias=by_alias, ref_template=ref_template), default=pydantic_encoder, **dumps_kwargs + ) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + + @classmethod + def validate(cls: Type['Model'], value: Any) -> 'Model': + if isinstance(value, cls): + copy_on_model_validation = cls.__config__.copy_on_model_validation + # whether to deep or shallow copy the model on validation, None means do not copy + deep_copy: Optional[bool] = None + if copy_on_model_validation not in {'deep', 'shallow', 'none'}: + # Warn about deprecated behavior + warnings.warn( + "`copy_on_model_validation` should be a string: 'deep', 'shallow' or 'none'", DeprecationWarning + ) + if copy_on_model_validation: + deep_copy = False + + if copy_on_model_validation == 'shallow': + # shallow copy + deep_copy = False + elif copy_on_model_validation == 'deep': + # deep copy + deep_copy = True + + if deep_copy is None: + return value + else: + return value._copy_and_set_values(value.__dict__, value.__fields_set__, deep=deep_copy) + + value = cls._enforce_dict_if_root(value) + + if isinstance(value, dict): + return cls(**value) + elif cls.__config__.orm_mode: + return cls.from_orm(value) + else: + try: + value_as_dict = dict(value) + except (TypeError, ValueError) as e: + raise DictError() from e + return cls(**value_as_dict) + + @classmethod + def _decompose_class(cls: Type['Model'], obj: Any) -> GetterDict: + if isinstance(obj, GetterDict): + return obj + return cls.__config__.getter_dict(obj) + + @classmethod + @no_type_check + def _get_value( + cls, + v: Any, + to_dict: bool, + by_alias: bool, + include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']], + exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']], + exclude_unset: bool, + exclude_defaults: bool, + exclude_none: bool, + ) -> Any: + if isinstance(v, BaseModel): + if to_dict: + v_dict = v.dict( + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + include=include, + exclude=exclude, + exclude_none=exclude_none, + ) + if ROOT_KEY in v_dict: + return v_dict[ROOT_KEY] + return v_dict + else: + return v.copy(include=include, exclude=exclude) + + value_exclude = ValueItems(v, exclude) if exclude else None + value_include = ValueItems(v, include) if include else None + + if isinstance(v, dict): + return { + k_: cls._get_value( + v_, + to_dict=to_dict, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + include=value_include and value_include.for_element(k_), + exclude=value_exclude and value_exclude.for_element(k_), + exclude_none=exclude_none, + ) + for k_, v_ in v.items() + if (not value_exclude or not value_exclude.is_excluded(k_)) + and (not value_include or value_include.is_included(k_)) + } + + elif sequence_like(v): + seq_args = ( + cls._get_value( + v_, + to_dict=to_dict, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + include=value_include and value_include.for_element(i), + exclude=value_exclude and value_exclude.for_element(i), + exclude_none=exclude_none, + ) + for i, v_ in enumerate(v) + if (not value_exclude or not value_exclude.is_excluded(i)) + and (not value_include or value_include.is_included(i)) + ) + + return v.__class__(*seq_args) if is_namedtuple(v.__class__) else v.__class__(seq_args) + + elif isinstance(v, Enum) and getattr(cls.Config, 'use_enum_values', False): + return v.value + + else: + return v + + @classmethod + def __try_update_forward_refs__(cls, **localns: Any) -> None: + """ + Same as update_forward_refs but will not raise exception + when forward references are not defined. + """ + update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns, (NameError,)) + + @classmethod + def update_forward_refs(cls, **localns: Any) -> None: + """ + Try to update ForwardRefs on fields based on this Model, globalns and localns. + """ + update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns) + + def __iter__(self) -> 'TupleGenerator': + """ + so `dict(model)` works + """ + yield from self.__dict__.items() + + def _iter( + self, + to_dict: bool = False, + by_alias: bool = False, + include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + ) -> 'TupleGenerator': + # Merge field set excludes with explicit exclude parameter with explicit overriding field set options. + # The extra "is not None" guards are not logically necessary but optimizes performance for the simple case. + if exclude is not None or self.__exclude_fields__ is not None: + exclude = ValueItems.merge(self.__exclude_fields__, exclude) + + if include is not None or self.__include_fields__ is not None: + include = ValueItems.merge(self.__include_fields__, include, intersect=True) + + allowed_keys = self._calculate_keys( + include=include, exclude=exclude, exclude_unset=exclude_unset # type: ignore + ) + if allowed_keys is None and not (to_dict or by_alias or exclude_unset or exclude_defaults or exclude_none): + # huge boost for plain _iter() + yield from self.__dict__.items() + return + + value_exclude = ValueItems(self, exclude) if exclude is not None else None + value_include = ValueItems(self, include) if include is not None else None + + for field_key, v in self.__dict__.items(): + if (allowed_keys is not None and field_key not in allowed_keys) or (exclude_none and v is None): + continue + + if exclude_defaults: + model_field = self.__fields__.get(field_key) + if not getattr(model_field, 'required', True) and getattr(model_field, 'default', _missing) == v: + continue + + if by_alias and field_key in self.__fields__: + dict_key = self.__fields__[field_key].alias + else: + dict_key = field_key + + if to_dict or value_include or value_exclude: + v = self._get_value( + v, + to_dict=to_dict, + by_alias=by_alias, + include=value_include and value_include.for_element(field_key), + exclude=value_exclude and value_exclude.for_element(field_key), + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + yield dict_key, v + + def _calculate_keys( + self, + include: Optional['MappingIntStrAny'], + exclude: Optional['MappingIntStrAny'], + exclude_unset: bool, + update: Optional['DictStrAny'] = None, + ) -> Optional[AbstractSet[str]]: + if include is None and exclude is None and exclude_unset is False: + return None + + keys: AbstractSet[str] + if exclude_unset: + keys = self.__fields_set__.copy() + else: + keys = self.__dict__.keys() + + if include is not None: + keys &= include.keys() + + if update: + keys -= update.keys() + + if exclude: + keys -= {k for k, v in exclude.items() if ValueItems.is_true(v)} + + return keys + + def __eq__(self, other: Any) -> bool: + if isinstance(other, BaseModel): + return self.dict() == other.dict() + else: + return self.dict() == other + + def __repr_args__(self) -> 'ReprArgs': + return [ + (k, v) + for k, v in self.__dict__.items() + if k not in DUNDER_ATTRIBUTES and (k not in self.__fields__ or self.__fields__[k].field_info.repr) + ] + + +_is_base_model_class_defined = True + + +@overload +def create_model( + __model_name: str, + *, + __config__: Optional[Type[BaseConfig]] = None, + __base__: None = None, + __module__: str = __name__, + __validators__: Dict[str, 'AnyClassMethod'] = None, + __cls_kwargs__: Dict[str, Any] = None, + **field_definitions: Any, +) -> Type['BaseModel']: + ... + + +@overload +def create_model( + __model_name: str, + *, + __config__: Optional[Type[BaseConfig]] = None, + __base__: Union[Type['Model'], Tuple[Type['Model'], ...]], + __module__: str = __name__, + __validators__: Dict[str, 'AnyClassMethod'] = None, + __cls_kwargs__: Dict[str, Any] = None, + **field_definitions: Any, +) -> Type['Model']: + ... + + +def create_model( + __model_name: str, + *, + __config__: Optional[Type[BaseConfig]] = None, + __base__: Union[None, Type['Model'], Tuple[Type['Model'], ...]] = None, + __module__: str = __name__, + __validators__: Dict[str, 'AnyClassMethod'] = None, + __cls_kwargs__: Dict[str, Any] = None, + __slots__: Optional[Tuple[str, ...]] = None, + **field_definitions: Any, +) -> Type['Model']: + """ + Dynamically create a model. + :param __model_name: name of the created model + :param __config__: config class to use for the new model + :param __base__: base class for the new model to inherit from + :param __module__: module of the created model + :param __validators__: a dict of method names and @validator class methods + :param __cls_kwargs__: a dict for class creation + :param __slots__: Deprecated, `__slots__` should not be passed to `create_model` + :param field_definitions: fields of the model (or extra fields if a base is supplied) + in the format `=(, )` or `=, e.g. + `foobar=(str, ...)` or `foobar=123`, or, for complex use-cases, in the format + `=` or `=(, )`, e.g. + `foo=Field(datetime, default_factory=datetime.utcnow, alias='bar')` or + `foo=(str, FieldInfo(title='Foo'))` + """ + if __slots__ is not None: + # __slots__ will be ignored from here on + warnings.warn('__slots__ should not be passed to create_model', RuntimeWarning) + + if __base__ is not None: + if __config__ is not None: + raise ConfigError('to avoid confusion __config__ and __base__ cannot be used together') + if not isinstance(__base__, tuple): + __base__ = (__base__,) + else: + __base__ = (cast(Type['Model'], BaseModel),) + + __cls_kwargs__ = __cls_kwargs__ or {} + + fields = {} + annotations = {} + + for f_name, f_def in field_definitions.items(): + if not is_valid_field(f_name): + warnings.warn(f'fields may not start with an underscore, ignoring "{f_name}"', RuntimeWarning) + if isinstance(f_def, tuple): + try: + f_annotation, f_value = f_def + except ValueError as e: + raise ConfigError( + 'field definitions should either be a tuple of (, ) or just a ' + 'default value, unfortunately this means tuples as ' + 'default values are not allowed' + ) from e + else: + f_annotation, f_value = None, f_def + + if f_annotation: + annotations[f_name] = f_annotation + fields[f_name] = f_value + + namespace: 'DictStrAny' = {'__annotations__': annotations, '__module__': __module__} + if __validators__: + namespace.update(__validators__) + namespace.update(fields) + if __config__: + namespace['Config'] = inherit_config(__config__, BaseConfig) + resolved_bases = resolve_bases(__base__) + meta, ns, kwds = prepare_class(__model_name, resolved_bases, kwds=__cls_kwargs__) + if resolved_bases is not __base__: + ns['__orig_bases__'] = __base__ + namespace.update(ns) + return meta(__model_name, resolved_bases, namespace, **kwds) + + +_missing = object() + + +def validate_model( # noqa: C901 (ignore complexity) + model: Type[BaseModel], input_data: 'DictStrAny', cls: 'ModelOrDc' = None +) -> Tuple['DictStrAny', 'SetStr', Optional[ValidationError]]: + """ + validate data against a model. + """ + values = {} + errors = [] + # input_data names, possibly alias + names_used = set() + # field names, never aliases + fields_set = set() + config = model.__config__ + check_extra = config.extra is not Extra.ignore + cls_ = cls or model + + for validator in model.__pre_root_validators__: + try: + input_data = validator(cls_, input_data) + except (ValueError, TypeError, AssertionError) as exc: + return {}, set(), ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls_) + + for name, field in model.__fields__.items(): + value = input_data.get(field.alias, _missing) + using_name = False + if value is _missing and config.allow_population_by_field_name and field.alt_alias: + value = input_data.get(field.name, _missing) + using_name = True + + if value is _missing: + if field.required: + errors.append(ErrorWrapper(MissingError(), loc=field.alias)) + continue + + value = field.get_default() + + if not config.validate_all and not field.validate_always: + values[name] = value + continue + else: + fields_set.add(name) + if check_extra: + names_used.add(field.name if using_name else field.alias) + + v_, errors_ = field.validate(value, values, loc=field.alias, cls=cls_) + if isinstance(errors_, ErrorWrapper): + errors.append(errors_) + elif isinstance(errors_, list): + errors.extend(errors_) + else: + values[name] = v_ + + if check_extra: + if isinstance(input_data, GetterDict): + extra = input_data.extra_keys() - names_used + else: + extra = input_data.keys() - names_used + if extra: + fields_set |= extra + if config.extra is Extra.allow: + for f in extra: + values[f] = input_data[f] + else: + for f in sorted(extra): + errors.append(ErrorWrapper(ExtraError(), loc=f)) + + for skip_on_failure, validator in model.__post_root_validators__: + if skip_on_failure and errors: + continue + try: + values = validator(cls_, values) + except (ValueError, TypeError, AssertionError) as exc: + errors.append(ErrorWrapper(exc, loc=ROOT_KEY)) + + if errors: + return values, fields_set, ValidationError(errors, cls_) + else: + return values, fields_set, None diff --git a/env/Lib/site-packages/pydantic/v1/mypy.py b/env/Lib/site-packages/pydantic/v1/mypy.py new file mode 100644 index 0000000..20fc039 --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/mypy.py @@ -0,0 +1,945 @@ +import sys +from configparser import ConfigParser +from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Type as TypingType, Union + +from mypy.errorcodes import ErrorCode +from mypy.nodes import ( + ARG_NAMED, + ARG_NAMED_OPT, + ARG_OPT, + ARG_POS, + ARG_STAR2, + MDEF, + Argument, + AssignmentStmt, + Block, + CallExpr, + ClassDef, + Context, + Decorator, + EllipsisExpr, + FuncBase, + FuncDef, + JsonDict, + MemberExpr, + NameExpr, + PassStmt, + PlaceholderNode, + RefExpr, + StrExpr, + SymbolNode, + SymbolTableNode, + TempNode, + TypeInfo, + TypeVarExpr, + Var, +) +from mypy.options import Options +from mypy.plugin import ( + CheckerPluginInterface, + ClassDefContext, + FunctionContext, + MethodContext, + Plugin, + ReportConfigContext, + SemanticAnalyzerPluginInterface, +) +from mypy.plugins import dataclasses +from mypy.semanal import set_callable_name # type: ignore +from mypy.server.trigger import make_wildcard_trigger +from mypy.types import ( + AnyType, + CallableType, + Instance, + NoneType, + Overloaded, + ProperType, + Type, + TypeOfAny, + TypeType, + TypeVarId, + TypeVarType, + UnionType, + get_proper_type, +) +from mypy.typevars import fill_typevars +from mypy.util import get_unique_redefinition_name +from mypy.version import __version__ as mypy_version + +from pydantic.v1.utils import is_valid_field + +try: + from mypy.types import TypeVarDef # type: ignore[attr-defined] +except ImportError: # pragma: no cover + # Backward-compatible with TypeVarDef from Mypy 0.910. + from mypy.types import TypeVarType as TypeVarDef + +CONFIGFILE_KEY = 'pydantic-mypy' +METADATA_KEY = 'pydantic-mypy-metadata' +_NAMESPACE = __name__[:-5] # 'pydantic' in 1.10.X, 'pydantic.v1' in v2.X +BASEMODEL_FULLNAME = f'{_NAMESPACE}.main.BaseModel' +BASESETTINGS_FULLNAME = f'{_NAMESPACE}.env_settings.BaseSettings' +MODEL_METACLASS_FULLNAME = f'{_NAMESPACE}.main.ModelMetaclass' +FIELD_FULLNAME = f'{_NAMESPACE}.fields.Field' +DATACLASS_FULLNAME = f'{_NAMESPACE}.dataclasses.dataclass' + + +def parse_mypy_version(version: str) -> Tuple[int, ...]: + return tuple(map(int, version.partition('+')[0].split('.'))) + + +MYPY_VERSION_TUPLE = parse_mypy_version(mypy_version) +BUILTINS_NAME = 'builtins' if MYPY_VERSION_TUPLE >= (0, 930) else '__builtins__' + +# Increment version if plugin changes and mypy caches should be invalidated +__version__ = 2 + + +def plugin(version: str) -> 'TypingType[Plugin]': + """ + `version` is the mypy version string + + We might want to use this to print a warning if the mypy version being used is + newer, or especially older, than we expect (or need). + """ + return PydanticPlugin + + +class PydanticPlugin(Plugin): + def __init__(self, options: Options) -> None: + self.plugin_config = PydanticPluginConfig(options) + self._plugin_data = self.plugin_config.to_data() + super().__init__(options) + + def get_base_class_hook(self, fullname: str) -> 'Optional[Callable[[ClassDefContext], None]]': + sym = self.lookup_fully_qualified(fullname) + if sym and isinstance(sym.node, TypeInfo): # pragma: no branch + # No branching may occur if the mypy cache has not been cleared + if any(get_fullname(base) == BASEMODEL_FULLNAME for base in sym.node.mro): + return self._pydantic_model_class_maker_callback + return None + + def get_metaclass_hook(self, fullname: str) -> Optional[Callable[[ClassDefContext], None]]: + if fullname == MODEL_METACLASS_FULLNAME: + return self._pydantic_model_metaclass_marker_callback + return None + + def get_function_hook(self, fullname: str) -> 'Optional[Callable[[FunctionContext], Type]]': + sym = self.lookup_fully_qualified(fullname) + if sym and sym.fullname == FIELD_FULLNAME: + return self._pydantic_field_callback + return None + + def get_method_hook(self, fullname: str) -> Optional[Callable[[MethodContext], Type]]: + if fullname.endswith('.from_orm'): + return from_orm_callback + return None + + def get_class_decorator_hook(self, fullname: str) -> Optional[Callable[[ClassDefContext], None]]: + """Mark pydantic.dataclasses as dataclass. + + Mypy version 1.1.1 added support for `@dataclass_transform` decorator. + """ + if fullname == DATACLASS_FULLNAME and MYPY_VERSION_TUPLE < (1, 1): + return dataclasses.dataclass_class_maker_callback # type: ignore[return-value] + return None + + def report_config_data(self, ctx: ReportConfigContext) -> Dict[str, Any]: + """Return all plugin config data. + + Used by mypy to determine if cache needs to be discarded. + """ + return self._plugin_data + + def _pydantic_model_class_maker_callback(self, ctx: ClassDefContext) -> None: + transformer = PydanticModelTransformer(ctx, self.plugin_config) + transformer.transform() + + def _pydantic_model_metaclass_marker_callback(self, ctx: ClassDefContext) -> None: + """Reset dataclass_transform_spec attribute of ModelMetaclass. + + Let the plugin handle it. This behavior can be disabled + if 'debug_dataclass_transform' is set to True', for testing purposes. + """ + if self.plugin_config.debug_dataclass_transform: + return + info_metaclass = ctx.cls.info.declared_metaclass + assert info_metaclass, "callback not passed from 'get_metaclass_hook'" + if getattr(info_metaclass.type, 'dataclass_transform_spec', None): + info_metaclass.type.dataclass_transform_spec = None # type: ignore[attr-defined] + + def _pydantic_field_callback(self, ctx: FunctionContext) -> 'Type': + """ + Extract the type of the `default` argument from the Field function, and use it as the return type. + + In particular: + * Check whether the default and default_factory argument is specified. + * Output an error if both are specified. + * Retrieve the type of the argument which is specified, and use it as return type for the function. + """ + default_any_type = ctx.default_return_type + + assert ctx.callee_arg_names[0] == 'default', '"default" is no longer first argument in Field()' + assert ctx.callee_arg_names[1] == 'default_factory', '"default_factory" is no longer second argument in Field()' + default_args = ctx.args[0] + default_factory_args = ctx.args[1] + + if default_args and default_factory_args: + error_default_and_default_factory_specified(ctx.api, ctx.context) + return default_any_type + + if default_args: + default_type = ctx.arg_types[0][0] + default_arg = default_args[0] + + # Fallback to default Any type if the field is required + if not isinstance(default_arg, EllipsisExpr): + return default_type + + elif default_factory_args: + default_factory_type = ctx.arg_types[1][0] + + # Functions which use `ParamSpec` can be overloaded, exposing the callable's types as a parameter + # Pydantic calls the default factory without any argument, so we retrieve the first item + if isinstance(default_factory_type, Overloaded): + if MYPY_VERSION_TUPLE > (0, 910): + default_factory_type = default_factory_type.items[0] + else: + # Mypy0.910 exposes the items of overloaded types in a function + default_factory_type = default_factory_type.items()[0] # type: ignore[operator] + + if isinstance(default_factory_type, CallableType): + ret_type = default_factory_type.ret_type + # mypy doesn't think `ret_type` has `args`, you'd think mypy should know, + # add this check in case it varies by version + args = getattr(ret_type, 'args', None) + if args: + if all(isinstance(arg, TypeVarType) for arg in args): + # Looks like the default factory is a type like `list` or `dict`, replace all args with `Any` + ret_type.args = tuple(default_any_type for _ in args) # type: ignore[attr-defined] + return ret_type + + return default_any_type + + +class PydanticPluginConfig: + __slots__ = ( + 'init_forbid_extra', + 'init_typed', + 'warn_required_dynamic_aliases', + 'warn_untyped_fields', + 'debug_dataclass_transform', + ) + init_forbid_extra: bool + init_typed: bool + warn_required_dynamic_aliases: bool + warn_untyped_fields: bool + debug_dataclass_transform: bool # undocumented + + def __init__(self, options: Options) -> None: + if options.config_file is None: # pragma: no cover + return + + toml_config = parse_toml(options.config_file) + if toml_config is not None: + config = toml_config.get('tool', {}).get('pydantic-mypy', {}) + for key in self.__slots__: + setting = config.get(key, False) + if not isinstance(setting, bool): + raise ValueError(f'Configuration value must be a boolean for key: {key}') + setattr(self, key, setting) + else: + plugin_config = ConfigParser() + plugin_config.read(options.config_file) + for key in self.__slots__: + setting = plugin_config.getboolean(CONFIGFILE_KEY, key, fallback=False) + setattr(self, key, setting) + + def to_data(self) -> Dict[str, Any]: + return {key: getattr(self, key) for key in self.__slots__} + + +def from_orm_callback(ctx: MethodContext) -> Type: + """ + Raise an error if orm_mode is not enabled + """ + model_type: Instance + ctx_type = ctx.type + if isinstance(ctx_type, TypeType): + ctx_type = ctx_type.item + if isinstance(ctx_type, CallableType) and isinstance(ctx_type.ret_type, Instance): + model_type = ctx_type.ret_type # called on the class + elif isinstance(ctx_type, Instance): + model_type = ctx_type # called on an instance (unusual, but still valid) + else: # pragma: no cover + detail = f'ctx.type: {ctx_type} (of type {ctx_type.__class__.__name__})' + error_unexpected_behavior(detail, ctx.api, ctx.context) + return ctx.default_return_type + pydantic_metadata = model_type.type.metadata.get(METADATA_KEY) + if pydantic_metadata is None: + return ctx.default_return_type + orm_mode = pydantic_metadata.get('config', {}).get('orm_mode') + if orm_mode is not True: + error_from_orm(get_name(model_type.type), ctx.api, ctx.context) + return ctx.default_return_type + + +class PydanticModelTransformer: + tracked_config_fields: Set[str] = { + 'extra', + 'allow_mutation', + 'frozen', + 'orm_mode', + 'allow_population_by_field_name', + 'alias_generator', + } + + def __init__(self, ctx: ClassDefContext, plugin_config: PydanticPluginConfig) -> None: + self._ctx = ctx + self.plugin_config = plugin_config + + def transform(self) -> None: + """ + Configures the BaseModel subclass according to the plugin settings. + + In particular: + * determines the model config and fields, + * adds a fields-aware signature for the initializer and construct methods + * freezes the class if allow_mutation = False or frozen = True + * stores the fields, config, and if the class is settings in the mypy metadata for access by subclasses + """ + ctx = self._ctx + info = ctx.cls.info + + self.adjust_validator_signatures() + config = self.collect_config() + fields = self.collect_fields(config) + is_settings = any(get_fullname(base) == BASESETTINGS_FULLNAME for base in info.mro[:-1]) + self.add_initializer(fields, config, is_settings) + self.add_construct_method(fields) + self.set_frozen(fields, frozen=config.allow_mutation is False or config.frozen is True) + info.metadata[METADATA_KEY] = { + 'fields': {field.name: field.serialize() for field in fields}, + 'config': config.set_values_dict(), + } + + def adjust_validator_signatures(self) -> None: + """When we decorate a function `f` with `pydantic.validator(...), mypy sees + `f` as a regular method taking a `self` instance, even though pydantic + internally wraps `f` with `classmethod` if necessary. + + Teach mypy this by marking any function whose outermost decorator is a + `validator()` call as a classmethod. + """ + for name, sym in self._ctx.cls.info.names.items(): + if isinstance(sym.node, Decorator): + first_dec = sym.node.original_decorators[0] + if ( + isinstance(first_dec, CallExpr) + and isinstance(first_dec.callee, NameExpr) + and first_dec.callee.fullname == f'{_NAMESPACE}.class_validators.validator' + ): + sym.node.func.is_class = True + + def collect_config(self) -> 'ModelConfigData': + """ + Collects the values of the config attributes that are used by the plugin, accounting for parent classes. + """ + ctx = self._ctx + cls = ctx.cls + config = ModelConfigData() + for stmt in cls.defs.body: + if not isinstance(stmt, ClassDef): + continue + if stmt.name == 'Config': + for substmt in stmt.defs.body: + if not isinstance(substmt, AssignmentStmt): + continue + config.update(self.get_config_update(substmt)) + if ( + config.has_alias_generator + and not config.allow_population_by_field_name + and self.plugin_config.warn_required_dynamic_aliases + ): + error_required_dynamic_aliases(ctx.api, stmt) + for info in cls.info.mro[1:]: # 0 is the current class + if METADATA_KEY not in info.metadata: + continue + + # Each class depends on the set of fields in its ancestors + ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info))) + for name, value in info.metadata[METADATA_KEY]['config'].items(): + config.setdefault(name, value) + return config + + def collect_fields(self, model_config: 'ModelConfigData') -> List['PydanticModelField']: + """ + Collects the fields for the model, accounting for parent classes + """ + # First, collect fields belonging to the current class. + ctx = self._ctx + cls = self._ctx.cls + fields = [] # type: List[PydanticModelField] + known_fields = set() # type: Set[str] + for stmt in cls.defs.body: + if not isinstance(stmt, AssignmentStmt): # `and stmt.new_syntax` to require annotation + continue + + lhs = stmt.lvalues[0] + if not isinstance(lhs, NameExpr) or not is_valid_field(lhs.name): + continue + + if not stmt.new_syntax and self.plugin_config.warn_untyped_fields: + error_untyped_fields(ctx.api, stmt) + + # if lhs.name == '__config__': # BaseConfig not well handled; I'm not sure why yet + # continue + + sym = cls.info.names.get(lhs.name) + if sym is None: # pragma: no cover + # This is likely due to a star import (see the dataclasses plugin for a more detailed explanation) + # This is the same logic used in the dataclasses plugin + continue + + node = sym.node + if isinstance(node, PlaceholderNode): # pragma: no cover + # See the PlaceholderNode docstring for more detail about how this can occur + # Basically, it is an edge case when dealing with complex import logic + # This is the same logic used in the dataclasses plugin + continue + if not isinstance(node, Var): # pragma: no cover + # Don't know if this edge case still happens with the `is_valid_field` check above + # but better safe than sorry + continue + + # x: ClassVar[int] is ignored by dataclasses. + if node.is_classvar: + continue + + is_required = self.get_is_required(cls, stmt, lhs) + alias, has_dynamic_alias = self.get_alias_info(stmt) + if ( + has_dynamic_alias + and not model_config.allow_population_by_field_name + and self.plugin_config.warn_required_dynamic_aliases + ): + error_required_dynamic_aliases(ctx.api, stmt) + fields.append( + PydanticModelField( + name=lhs.name, + is_required=is_required, + alias=alias, + has_dynamic_alias=has_dynamic_alias, + line=stmt.line, + column=stmt.column, + ) + ) + known_fields.add(lhs.name) + all_fields = fields.copy() + for info in cls.info.mro[1:]: # 0 is the current class, -2 is BaseModel, -1 is object + if METADATA_KEY not in info.metadata: + continue + + superclass_fields = [] + # Each class depends on the set of fields in its ancestors + ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info))) + + for name, data in info.metadata[METADATA_KEY]['fields'].items(): + if name not in known_fields: + field = PydanticModelField.deserialize(info, data) + known_fields.add(name) + superclass_fields.append(field) + else: + (field,) = (a for a in all_fields if a.name == name) + all_fields.remove(field) + superclass_fields.append(field) + all_fields = superclass_fields + all_fields + return all_fields + + def add_initializer(self, fields: List['PydanticModelField'], config: 'ModelConfigData', is_settings: bool) -> None: + """ + Adds a fields-aware `__init__` method to the class. + + The added `__init__` will be annotated with types vs. all `Any` depending on the plugin settings. + """ + ctx = self._ctx + typed = self.plugin_config.init_typed + use_alias = config.allow_population_by_field_name is not True + force_all_optional = is_settings or bool( + config.has_alias_generator and not config.allow_population_by_field_name + ) + init_arguments = self.get_field_arguments( + fields, typed=typed, force_all_optional=force_all_optional, use_alias=use_alias + ) + if not self.should_init_forbid_extra(fields, config): + var = Var('kwargs') + init_arguments.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2)) + + if '__init__' not in ctx.cls.info.names: + add_method(ctx, '__init__', init_arguments, NoneType()) + + def add_construct_method(self, fields: List['PydanticModelField']) -> None: + """ + Adds a fully typed `construct` classmethod to the class. + + Similar to the fields-aware __init__ method, but always uses the field names (not aliases), + and does not treat settings fields as optional. + """ + ctx = self._ctx + set_str = ctx.api.named_type(f'{BUILTINS_NAME}.set', [ctx.api.named_type(f'{BUILTINS_NAME}.str')]) + optional_set_str = UnionType([set_str, NoneType()]) + fields_set_argument = Argument(Var('_fields_set', optional_set_str), optional_set_str, None, ARG_OPT) + construct_arguments = self.get_field_arguments(fields, typed=True, force_all_optional=False, use_alias=False) + construct_arguments = [fields_set_argument] + construct_arguments + + obj_type = ctx.api.named_type(f'{BUILTINS_NAME}.object') + self_tvar_name = '_PydanticBaseModel' # Make sure it does not conflict with other names in the class + tvar_fullname = ctx.cls.fullname + '.' + self_tvar_name + if MYPY_VERSION_TUPLE >= (1, 4): + tvd = TypeVarType( + self_tvar_name, + tvar_fullname, + TypeVarId(-1), + [], + obj_type, + AnyType(TypeOfAny.from_omitted_generics), # type: ignore[arg-type] + ) + self_tvar_expr = TypeVarExpr( + self_tvar_name, + tvar_fullname, + [], + obj_type, + AnyType(TypeOfAny.from_omitted_generics), # type: ignore[arg-type] + ) + else: + tvd = TypeVarDef(self_tvar_name, tvar_fullname, -1, [], obj_type) + self_tvar_expr = TypeVarExpr(self_tvar_name, tvar_fullname, [], obj_type) + ctx.cls.info.names[self_tvar_name] = SymbolTableNode(MDEF, self_tvar_expr) + + # Backward-compatible with TypeVarDef from Mypy 0.910. + if isinstance(tvd, TypeVarType): + self_type = tvd + else: + self_type = TypeVarType(tvd) + + add_method( + ctx, + 'construct', + construct_arguments, + return_type=self_type, + self_type=self_type, + tvar_def=tvd, + is_classmethod=True, + ) + + def set_frozen(self, fields: List['PydanticModelField'], frozen: bool) -> None: + """ + Marks all fields as properties so that attempts to set them trigger mypy errors. + + This is the same approach used by the attrs and dataclasses plugins. + """ + ctx = self._ctx + info = ctx.cls.info + for field in fields: + sym_node = info.names.get(field.name) + if sym_node is not None: + var = sym_node.node + if isinstance(var, Var): + var.is_property = frozen + elif isinstance(var, PlaceholderNode) and not ctx.api.final_iteration: + # See https://github.com/pydantic/pydantic/issues/5191 to hit this branch for test coverage + ctx.api.defer() + else: # pragma: no cover + # I don't know whether it's possible to hit this branch, but I've added it for safety + try: + var_str = str(var) + except TypeError: + # This happens for PlaceholderNode; perhaps it will happen for other types in the future.. + var_str = repr(var) + detail = f'sym_node.node: {var_str} (of type {var.__class__})' + error_unexpected_behavior(detail, ctx.api, ctx.cls) + else: + var = field.to_var(info, use_alias=False) + var.info = info + var.is_property = frozen + var._fullname = get_fullname(info) + '.' + get_name(var) + info.names[get_name(var)] = SymbolTableNode(MDEF, var) + + def get_config_update(self, substmt: AssignmentStmt) -> Optional['ModelConfigData']: + """ + Determines the config update due to a single statement in the Config class definition. + + Warns if a tracked config attribute is set to a value the plugin doesn't know how to interpret (e.g., an int) + """ + lhs = substmt.lvalues[0] + if not (isinstance(lhs, NameExpr) and lhs.name in self.tracked_config_fields): + return None + if lhs.name == 'extra': + if isinstance(substmt.rvalue, StrExpr): + forbid_extra = substmt.rvalue.value == 'forbid' + elif isinstance(substmt.rvalue, MemberExpr): + forbid_extra = substmt.rvalue.name == 'forbid' + else: + error_invalid_config_value(lhs.name, self._ctx.api, substmt) + return None + return ModelConfigData(forbid_extra=forbid_extra) + if lhs.name == 'alias_generator': + has_alias_generator = True + if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname == 'builtins.None': + has_alias_generator = False + return ModelConfigData(has_alias_generator=has_alias_generator) + if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname in ('builtins.True', 'builtins.False'): + return ModelConfigData(**{lhs.name: substmt.rvalue.fullname == 'builtins.True'}) + error_invalid_config_value(lhs.name, self._ctx.api, substmt) + return None + + @staticmethod + def get_is_required(cls: ClassDef, stmt: AssignmentStmt, lhs: NameExpr) -> bool: + """ + Returns a boolean indicating whether the field defined in `stmt` is a required field. + """ + expr = stmt.rvalue + if isinstance(expr, TempNode): + # TempNode means annotation-only, so only non-required if Optional + value_type = get_proper_type(cls.info[lhs.name].type) + return not PydanticModelTransformer.type_has_implicit_default(value_type) + if isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME: + # The "default value" is a call to `Field`; at this point, the field is + # only required if default is Ellipsis (i.e., `field_name: Annotation = Field(...)`) or if default_factory + # is specified. + for arg, name in zip(expr.args, expr.arg_names): + # If name is None, then this arg is the default because it is the only positional argument. + if name is None or name == 'default': + return arg.__class__ is EllipsisExpr + if name == 'default_factory': + return False + # In this case, default and default_factory are not specified, so we need to look at the annotation + value_type = get_proper_type(cls.info[lhs.name].type) + return not PydanticModelTransformer.type_has_implicit_default(value_type) + # Only required if the "default value" is Ellipsis (i.e., `field_name: Annotation = ...`) + return isinstance(expr, EllipsisExpr) + + @staticmethod + def type_has_implicit_default(type_: Optional[ProperType]) -> bool: + """ + Returns True if the passed type will be given an implicit default value. + + In pydantic v1, this is the case for Optional types and Any (with default value None). + """ + if isinstance(type_, AnyType): + # Annotated as Any + return True + if isinstance(type_, UnionType) and any( + isinstance(item, NoneType) or isinstance(item, AnyType) for item in type_.items + ): + # Annotated as Optional, or otherwise having NoneType or AnyType in the union + return True + return False + + @staticmethod + def get_alias_info(stmt: AssignmentStmt) -> Tuple[Optional[str], bool]: + """ + Returns a pair (alias, has_dynamic_alias), extracted from the declaration of the field defined in `stmt`. + + `has_dynamic_alias` is True if and only if an alias is provided, but not as a string literal. + If `has_dynamic_alias` is True, `alias` will be None. + """ + expr = stmt.rvalue + if isinstance(expr, TempNode): + # TempNode means annotation-only + return None, False + + if not ( + isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME + ): + # Assigned value is not a call to pydantic.fields.Field + return None, False + + for i, arg_name in enumerate(expr.arg_names): + if arg_name != 'alias': + continue + arg = expr.args[i] + if isinstance(arg, StrExpr): + return arg.value, False + else: + return None, True + return None, False + + def get_field_arguments( + self, fields: List['PydanticModelField'], typed: bool, force_all_optional: bool, use_alias: bool + ) -> List[Argument]: + """ + Helper function used during the construction of the `__init__` and `construct` method signatures. + + Returns a list of mypy Argument instances for use in the generated signatures. + """ + info = self._ctx.cls.info + arguments = [ + field.to_argument(info, typed=typed, force_optional=force_all_optional, use_alias=use_alias) + for field in fields + if not (use_alias and field.has_dynamic_alias) + ] + return arguments + + def should_init_forbid_extra(self, fields: List['PydanticModelField'], config: 'ModelConfigData') -> bool: + """ + Indicates whether the generated `__init__` should get a `**kwargs` at the end of its signature + + We disallow arbitrary kwargs if the extra config setting is "forbid", or if the plugin config says to, + *unless* a required dynamic alias is present (since then we can't determine a valid signature). + """ + if not config.allow_population_by_field_name: + if self.is_dynamic_alias_present(fields, bool(config.has_alias_generator)): + return False + if config.forbid_extra: + return True + return self.plugin_config.init_forbid_extra + + @staticmethod + def is_dynamic_alias_present(fields: List['PydanticModelField'], has_alias_generator: bool) -> bool: + """ + Returns whether any fields on the model have a "dynamic alias", i.e., an alias that cannot be + determined during static analysis. + """ + for field in fields: + if field.has_dynamic_alias: + return True + if has_alias_generator: + for field in fields: + if field.alias is None: + return True + return False + + +class PydanticModelField: + def __init__( + self, name: str, is_required: bool, alias: Optional[str], has_dynamic_alias: bool, line: int, column: int + ): + self.name = name + self.is_required = is_required + self.alias = alias + self.has_dynamic_alias = has_dynamic_alias + self.line = line + self.column = column + + def to_var(self, info: TypeInfo, use_alias: bool) -> Var: + name = self.name + if use_alias and self.alias is not None: + name = self.alias + return Var(name, info[self.name].type) + + def to_argument(self, info: TypeInfo, typed: bool, force_optional: bool, use_alias: bool) -> Argument: + if typed and info[self.name].type is not None: + type_annotation = info[self.name].type + else: + type_annotation = AnyType(TypeOfAny.explicit) + return Argument( + variable=self.to_var(info, use_alias), + type_annotation=type_annotation, + initializer=None, + kind=ARG_NAMED_OPT if force_optional or not self.is_required else ARG_NAMED, + ) + + def serialize(self) -> JsonDict: + return self.__dict__ + + @classmethod + def deserialize(cls, info: TypeInfo, data: JsonDict) -> 'PydanticModelField': + return cls(**data) + + +class ModelConfigData: + def __init__( + self, + forbid_extra: Optional[bool] = None, + allow_mutation: Optional[bool] = None, + frozen: Optional[bool] = None, + orm_mode: Optional[bool] = None, + allow_population_by_field_name: Optional[bool] = None, + has_alias_generator: Optional[bool] = None, + ): + self.forbid_extra = forbid_extra + self.allow_mutation = allow_mutation + self.frozen = frozen + self.orm_mode = orm_mode + self.allow_population_by_field_name = allow_population_by_field_name + self.has_alias_generator = has_alias_generator + + def set_values_dict(self) -> Dict[str, Any]: + return {k: v for k, v in self.__dict__.items() if v is not None} + + def update(self, config: Optional['ModelConfigData']) -> None: + if config is None: + return + for k, v in config.set_values_dict().items(): + setattr(self, k, v) + + def setdefault(self, key: str, value: Any) -> None: + if getattr(self, key) is None: + setattr(self, key, value) + + +ERROR_ORM = ErrorCode('pydantic-orm', 'Invalid from_orm call', 'Pydantic') +ERROR_CONFIG = ErrorCode('pydantic-config', 'Invalid config value', 'Pydantic') +ERROR_ALIAS = ErrorCode('pydantic-alias', 'Dynamic alias disallowed', 'Pydantic') +ERROR_UNEXPECTED = ErrorCode('pydantic-unexpected', 'Unexpected behavior', 'Pydantic') +ERROR_UNTYPED = ErrorCode('pydantic-field', 'Untyped field disallowed', 'Pydantic') +ERROR_FIELD_DEFAULTS = ErrorCode('pydantic-field', 'Invalid Field defaults', 'Pydantic') + + +def error_from_orm(model_name: str, api: CheckerPluginInterface, context: Context) -> None: + api.fail(f'"{model_name}" does not have orm_mode=True', context, code=ERROR_ORM) + + +def error_invalid_config_value(name: str, api: SemanticAnalyzerPluginInterface, context: Context) -> None: + api.fail(f'Invalid value for "Config.{name}"', context, code=ERROR_CONFIG) + + +def error_required_dynamic_aliases(api: SemanticAnalyzerPluginInterface, context: Context) -> None: + api.fail('Required dynamic aliases disallowed', context, code=ERROR_ALIAS) + + +def error_unexpected_behavior( + detail: str, api: Union[CheckerPluginInterface, SemanticAnalyzerPluginInterface], context: Context +) -> None: # pragma: no cover + # Can't think of a good way to test this, but I confirmed it renders as desired by adding to a non-error path + link = 'https://github.com/pydantic/pydantic/issues/new/choose' + full_message = f'The pydantic mypy plugin ran into unexpected behavior: {detail}\n' + full_message += f'Please consider reporting this bug at {link} so we can try to fix it!' + api.fail(full_message, context, code=ERROR_UNEXPECTED) + + +def error_untyped_fields(api: SemanticAnalyzerPluginInterface, context: Context) -> None: + api.fail('Untyped fields disallowed', context, code=ERROR_UNTYPED) + + +def error_default_and_default_factory_specified(api: CheckerPluginInterface, context: Context) -> None: + api.fail('Field default and default_factory cannot be specified together', context, code=ERROR_FIELD_DEFAULTS) + + +def add_method( + ctx: ClassDefContext, + name: str, + args: List[Argument], + return_type: Type, + self_type: Optional[Type] = None, + tvar_def: Optional[TypeVarDef] = None, + is_classmethod: bool = False, + is_new: bool = False, + # is_staticmethod: bool = False, +) -> None: + """ + Adds a new method to a class. + + This can be dropped if/when https://github.com/python/mypy/issues/7301 is merged + """ + info = ctx.cls.info + + # First remove any previously generated methods with the same name + # to avoid clashes and problems in the semantic analyzer. + if name in info.names: + sym = info.names[name] + if sym.plugin_generated and isinstance(sym.node, FuncDef): + ctx.cls.defs.body.remove(sym.node) # pragma: no cover + + self_type = self_type or fill_typevars(info) + if is_classmethod or is_new: + first = [Argument(Var('_cls'), TypeType.make_normalized(self_type), None, ARG_POS)] + # elif is_staticmethod: + # first = [] + else: + self_type = self_type or fill_typevars(info) + first = [Argument(Var('__pydantic_self__'), self_type, None, ARG_POS)] + args = first + args + arg_types, arg_names, arg_kinds = [], [], [] + for arg in args: + assert arg.type_annotation, 'All arguments must be fully typed.' + arg_types.append(arg.type_annotation) + arg_names.append(get_name(arg.variable)) + arg_kinds.append(arg.kind) + + function_type = ctx.api.named_type(f'{BUILTINS_NAME}.function') + signature = CallableType(arg_types, arg_kinds, arg_names, return_type, function_type) + if tvar_def: + signature.variables = [tvar_def] + + func = FuncDef(name, args, Block([PassStmt()])) + func.info = info + func.type = set_callable_name(signature, func) + func.is_class = is_classmethod + # func.is_static = is_staticmethod + func._fullname = get_fullname(info) + '.' + name + func.line = info.line + + # NOTE: we would like the plugin generated node to dominate, but we still + # need to keep any existing definitions so they get semantically analyzed. + if name in info.names: + # Get a nice unique name instead. + r_name = get_unique_redefinition_name(name, info.names) + info.names[r_name] = info.names[name] + + if is_classmethod: # or is_staticmethod: + func.is_decorated = True + v = Var(name, func.type) + v.info = info + v._fullname = func._fullname + # if is_classmethod: + v.is_classmethod = True + dec = Decorator(func, [NameExpr('classmethod')], v) + # else: + # v.is_staticmethod = True + # dec = Decorator(func, [NameExpr('staticmethod')], v) + + dec.line = info.line + sym = SymbolTableNode(MDEF, dec) + else: + sym = SymbolTableNode(MDEF, func) + sym.plugin_generated = True + + info.names[name] = sym + info.defn.defs.body.append(func) + + +def get_fullname(x: Union[FuncBase, SymbolNode]) -> str: + """ + Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped. + """ + fn = x.fullname + if callable(fn): # pragma: no cover + return fn() + return fn + + +def get_name(x: Union[FuncBase, SymbolNode]) -> str: + """ + Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped. + """ + fn = x.name + if callable(fn): # pragma: no cover + return fn() + return fn + + +def parse_toml(config_file: str) -> Optional[Dict[str, Any]]: + if not config_file.endswith('.toml'): + return None + + read_mode = 'rb' + if sys.version_info >= (3, 11): + import tomllib as toml_ + else: + try: + import tomli as toml_ + except ImportError: + # older versions of mypy have toml as a dependency, not tomli + read_mode = 'r' + try: + import toml as toml_ # type: ignore[no-redef] + except ImportError: # pragma: no cover + import warnings + + warnings.warn('No TOML parser installed, cannot read configuration from `pyproject.toml`.') + return None + + with open(config_file, read_mode) as rf: + return toml_.load(rf) # type: ignore[arg-type] diff --git a/env/Lib/site-packages/pydantic/v1/networks.py b/env/Lib/site-packages/pydantic/v1/networks.py new file mode 100644 index 0000000..ba07b74 --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/networks.py @@ -0,0 +1,747 @@ +import re +from ipaddress import ( + IPv4Address, + IPv4Interface, + IPv4Network, + IPv6Address, + IPv6Interface, + IPv6Network, + _BaseAddress, + _BaseNetwork, +) +from typing import ( + TYPE_CHECKING, + Any, + Collection, + Dict, + Generator, + List, + Match, + Optional, + Pattern, + Set, + Tuple, + Type, + Union, + cast, + no_type_check, +) + +from pydantic.v1 import errors +from pydantic.v1.utils import Representation, update_not_none +from pydantic.v1.validators import constr_length_validator, str_validator + +if TYPE_CHECKING: + import email_validator + from typing_extensions import TypedDict + + from pydantic.v1.config import BaseConfig + from pydantic.v1.fields import ModelField + from pydantic.v1.typing import AnyCallable + + CallableGenerator = Generator[AnyCallable, None, None] + + class Parts(TypedDict, total=False): + scheme: str + user: Optional[str] + password: Optional[str] + ipv4: Optional[str] + ipv6: Optional[str] + domain: Optional[str] + port: Optional[str] + path: Optional[str] + query: Optional[str] + fragment: Optional[str] + + class HostParts(TypedDict, total=False): + host: str + tld: Optional[str] + host_type: Optional[str] + port: Optional[str] + rebuild: bool + +else: + email_validator = None + + class Parts(dict): + pass + + +NetworkType = Union[str, bytes, int, Tuple[Union[str, bytes, int], Union[str, int]]] + +__all__ = [ + 'AnyUrl', + 'AnyHttpUrl', + 'FileUrl', + 'HttpUrl', + 'stricturl', + 'EmailStr', + 'NameEmail', + 'IPvAnyAddress', + 'IPvAnyInterface', + 'IPvAnyNetwork', + 'PostgresDsn', + 'CockroachDsn', + 'AmqpDsn', + 'RedisDsn', + 'MongoDsn', + 'KafkaDsn', + 'validate_email', +] + +_url_regex_cache = None +_multi_host_url_regex_cache = None +_ascii_domain_regex_cache = None +_int_domain_regex_cache = None +_host_regex_cache = None + +_host_regex = ( + r'(?:' + r'(?P(?:\d{1,3}\.){3}\d{1,3})(?=$|[/:#?])|' # ipv4 + r'(?P\[[A-F0-9]*:[A-F0-9:]+\])(?=$|[/:#?])|' # ipv6 + r'(?P[^\s/:?#]+)' # domain, validation occurs later + r')?' + r'(?::(?P\d+))?' # port +) +_scheme_regex = r'(?:(?P[a-z][a-z0-9+\-.]+)://)?' # scheme https://tools.ietf.org/html/rfc3986#appendix-A +_user_info_regex = r'(?:(?P[^\s:/]*)(?::(?P[^\s/]*))?@)?' +_path_regex = r'(?P/[^\s?#]*)?' +_query_regex = r'(?:\?(?P[^\s#]*))?' +_fragment_regex = r'(?:#(?P[^\s#]*))?' + + +def url_regex() -> Pattern[str]: + global _url_regex_cache + if _url_regex_cache is None: + _url_regex_cache = re.compile( + rf'{_scheme_regex}{_user_info_regex}{_host_regex}{_path_regex}{_query_regex}{_fragment_regex}', + re.IGNORECASE, + ) + return _url_regex_cache + + +def multi_host_url_regex() -> Pattern[str]: + """ + Compiled multi host url regex. + + Additionally to `url_regex` it allows to match multiple hosts. + E.g. host1.db.net,host2.db.net + """ + global _multi_host_url_regex_cache + if _multi_host_url_regex_cache is None: + _multi_host_url_regex_cache = re.compile( + rf'{_scheme_regex}{_user_info_regex}' + r'(?P([^/]*))' # validation occurs later + rf'{_path_regex}{_query_regex}{_fragment_regex}', + re.IGNORECASE, + ) + return _multi_host_url_regex_cache + + +def ascii_domain_regex() -> Pattern[str]: + global _ascii_domain_regex_cache + if _ascii_domain_regex_cache is None: + ascii_chunk = r'[_0-9a-z](?:[-_0-9a-z]{0,61}[_0-9a-z])?' + ascii_domain_ending = r'(?P\.[a-z]{2,63})?\.?' + _ascii_domain_regex_cache = re.compile( + fr'(?:{ascii_chunk}\.)*?{ascii_chunk}{ascii_domain_ending}', re.IGNORECASE + ) + return _ascii_domain_regex_cache + + +def int_domain_regex() -> Pattern[str]: + global _int_domain_regex_cache + if _int_domain_regex_cache is None: + int_chunk = r'[_0-9a-\U00040000](?:[-_0-9a-\U00040000]{0,61}[_0-9a-\U00040000])?' + int_domain_ending = r'(?P(\.[^\W\d_]{2,63})|(\.(?:xn--)[_0-9a-z-]{2,63}))?\.?' + _int_domain_regex_cache = re.compile(fr'(?:{int_chunk}\.)*?{int_chunk}{int_domain_ending}', re.IGNORECASE) + return _int_domain_regex_cache + + +def host_regex() -> Pattern[str]: + global _host_regex_cache + if _host_regex_cache is None: + _host_regex_cache = re.compile( + _host_regex, + re.IGNORECASE, + ) + return _host_regex_cache + + +class AnyUrl(str): + strip_whitespace = True + min_length = 1 + max_length = 2**16 + allowed_schemes: Optional[Collection[str]] = None + tld_required: bool = False + user_required: bool = False + host_required: bool = True + hidden_parts: Set[str] = set() + + __slots__ = ('scheme', 'user', 'password', 'host', 'tld', 'host_type', 'port', 'path', 'query', 'fragment') + + @no_type_check + def __new__(cls, url: Optional[str], **kwargs) -> object: + return str.__new__(cls, cls.build(**kwargs) if url is None else url) + + def __init__( + self, + url: str, + *, + scheme: str, + user: Optional[str] = None, + password: Optional[str] = None, + host: Optional[str] = None, + tld: Optional[str] = None, + host_type: str = 'domain', + port: Optional[str] = None, + path: Optional[str] = None, + query: Optional[str] = None, + fragment: Optional[str] = None, + ) -> None: + str.__init__(url) + self.scheme = scheme + self.user = user + self.password = password + self.host = host + self.tld = tld + self.host_type = host_type + self.port = port + self.path = path + self.query = query + self.fragment = fragment + + @classmethod + def build( + cls, + *, + scheme: str, + user: Optional[str] = None, + password: Optional[str] = None, + host: str, + port: Optional[str] = None, + path: Optional[str] = None, + query: Optional[str] = None, + fragment: Optional[str] = None, + **_kwargs: str, + ) -> str: + parts = Parts( + scheme=scheme, + user=user, + password=password, + host=host, + port=port, + path=path, + query=query, + fragment=fragment, + **_kwargs, # type: ignore[misc] + ) + + url = scheme + '://' + if user: + url += user + if password: + url += ':' + password + if user or password: + url += '@' + url += host + if port and ('port' not in cls.hidden_parts or cls.get_default_parts(parts).get('port') != port): + url += ':' + port + if path: + url += path + if query: + url += '?' + query + if fragment: + url += '#' + fragment + return url + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length, format='uri') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + + @classmethod + def validate(cls, value: Any, field: 'ModelField', config: 'BaseConfig') -> 'AnyUrl': + if value.__class__ == cls: + return value + value = str_validator(value) + if cls.strip_whitespace: + value = value.strip() + url: str = cast(str, constr_length_validator(value, field, config)) + + m = cls._match_url(url) + # the regex should always match, if it doesn't please report with details of the URL tried + assert m, 'URL regex failed unexpectedly' + + original_parts = cast('Parts', m.groupdict()) + parts = cls.apply_default_parts(original_parts) + parts = cls.validate_parts(parts) + + if m.end() != len(url): + raise errors.UrlExtraError(extra=url[m.end() :]) + + return cls._build_url(m, url, parts) + + @classmethod + def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'AnyUrl': + """ + Validate hosts and build the AnyUrl object. Split from `validate` so this method + can be altered in `MultiHostDsn`. + """ + host, tld, host_type, rebuild = cls.validate_host(parts) + + return cls( + None if rebuild else url, + scheme=parts['scheme'], + user=parts['user'], + password=parts['password'], + host=host, + tld=tld, + host_type=host_type, + port=parts['port'], + path=parts['path'], + query=parts['query'], + fragment=parts['fragment'], + ) + + @staticmethod + def _match_url(url: str) -> Optional[Match[str]]: + return url_regex().match(url) + + @staticmethod + def _validate_port(port: Optional[str]) -> None: + if port is not None and int(port) > 65_535: + raise errors.UrlPortError() + + @classmethod + def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts': + """ + A method used to validate parts of a URL. + Could be overridden to set default values for parts if missing + """ + scheme = parts['scheme'] + if scheme is None: + raise errors.UrlSchemeError() + + if cls.allowed_schemes and scheme.lower() not in cls.allowed_schemes: + raise errors.UrlSchemePermittedError(set(cls.allowed_schemes)) + + if validate_port: + cls._validate_port(parts['port']) + + user = parts['user'] + if cls.user_required and user is None: + raise errors.UrlUserInfoError() + + return parts + + @classmethod + def validate_host(cls, parts: 'Parts') -> Tuple[str, Optional[str], str, bool]: + tld, host_type, rebuild = None, None, False + for f in ('domain', 'ipv4', 'ipv6'): + host = parts[f] # type: ignore[literal-required] + if host: + host_type = f + break + + if host is None: + if cls.host_required: + raise errors.UrlHostError() + elif host_type == 'domain': + is_international = False + d = ascii_domain_regex().fullmatch(host) + if d is None: + d = int_domain_regex().fullmatch(host) + if d is None: + raise errors.UrlHostError() + is_international = True + + tld = d.group('tld') + if tld is None and not is_international: + d = int_domain_regex().fullmatch(host) + assert d is not None + tld = d.group('tld') + is_international = True + + if tld is not None: + tld = tld[1:] + elif cls.tld_required: + raise errors.UrlHostTldError() + + if is_international: + host_type = 'int_domain' + rebuild = True + host = host.encode('idna').decode('ascii') + if tld is not None: + tld = tld.encode('idna').decode('ascii') + + return host, tld, host_type, rebuild # type: ignore + + @staticmethod + def get_default_parts(parts: 'Parts') -> 'Parts': + return {} + + @classmethod + def apply_default_parts(cls, parts: 'Parts') -> 'Parts': + for key, value in cls.get_default_parts(parts).items(): + if not parts[key]: # type: ignore[literal-required] + parts[key] = value # type: ignore[literal-required] + return parts + + def __repr__(self) -> str: + extra = ', '.join(f'{n}={getattr(self, n)!r}' for n in self.__slots__ if getattr(self, n) is not None) + return f'{self.__class__.__name__}({super().__repr__()}, {extra})' + + +class AnyHttpUrl(AnyUrl): + allowed_schemes = {'http', 'https'} + + __slots__ = () + + +class HttpUrl(AnyHttpUrl): + tld_required = True + # https://stackoverflow.com/questions/417142/what-is-the-maximum-length-of-a-url-in-different-browsers + max_length = 2083 + hidden_parts = {'port'} + + @staticmethod + def get_default_parts(parts: 'Parts') -> 'Parts': + return {'port': '80' if parts['scheme'] == 'http' else '443'} + + +class FileUrl(AnyUrl): + allowed_schemes = {'file'} + host_required = False + + __slots__ = () + + +class MultiHostDsn(AnyUrl): + __slots__ = AnyUrl.__slots__ + ('hosts',) + + def __init__(self, *args: Any, hosts: Optional[List['HostParts']] = None, **kwargs: Any): + super().__init__(*args, **kwargs) + self.hosts = hosts + + @staticmethod + def _match_url(url: str) -> Optional[Match[str]]: + return multi_host_url_regex().match(url) + + @classmethod + def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts': + return super().validate_parts(parts, validate_port=False) + + @classmethod + def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'MultiHostDsn': + hosts_parts: List['HostParts'] = [] + host_re = host_regex() + for host in m.groupdict()['hosts'].split(','): + d: Parts = host_re.match(host).groupdict() # type: ignore + host, tld, host_type, rebuild = cls.validate_host(d) + port = d.get('port') + cls._validate_port(port) + hosts_parts.append( + { + 'host': host, + 'host_type': host_type, + 'tld': tld, + 'rebuild': rebuild, + 'port': port, + } + ) + + if len(hosts_parts) > 1: + return cls( + None if any([hp['rebuild'] for hp in hosts_parts]) else url, + scheme=parts['scheme'], + user=parts['user'], + password=parts['password'], + path=parts['path'], + query=parts['query'], + fragment=parts['fragment'], + host_type=None, + hosts=hosts_parts, + ) + else: + # backwards compatibility with single host + host_part = hosts_parts[0] + return cls( + None if host_part['rebuild'] else url, + scheme=parts['scheme'], + user=parts['user'], + password=parts['password'], + host=host_part['host'], + tld=host_part['tld'], + host_type=host_part['host_type'], + port=host_part.get('port'), + path=parts['path'], + query=parts['query'], + fragment=parts['fragment'], + ) + + +class PostgresDsn(MultiHostDsn): + allowed_schemes = { + 'postgres', + 'postgresql', + 'postgresql+asyncpg', + 'postgresql+pg8000', + 'postgresql+psycopg', + 'postgresql+psycopg2', + 'postgresql+psycopg2cffi', + 'postgresql+py-postgresql', + 'postgresql+pygresql', + } + user_required = True + + __slots__ = () + + +class CockroachDsn(AnyUrl): + allowed_schemes = { + 'cockroachdb', + 'cockroachdb+psycopg2', + 'cockroachdb+asyncpg', + } + user_required = True + + +class AmqpDsn(AnyUrl): + allowed_schemes = {'amqp', 'amqps'} + host_required = False + + +class RedisDsn(AnyUrl): + __slots__ = () + allowed_schemes = {'redis', 'rediss'} + host_required = False + + @staticmethod + def get_default_parts(parts: 'Parts') -> 'Parts': + return { + 'domain': 'localhost' if not (parts['ipv4'] or parts['ipv6']) else '', + 'port': '6379', + 'path': '/0', + } + + +class MongoDsn(AnyUrl): + allowed_schemes = {'mongodb'} + + # TODO: Needed to generic "Parts" for "Replica Set", "Sharded Cluster", and other mongodb deployment modes + @staticmethod + def get_default_parts(parts: 'Parts') -> 'Parts': + return { + 'port': '27017', + } + + +class KafkaDsn(AnyUrl): + allowed_schemes = {'kafka'} + + @staticmethod + def get_default_parts(parts: 'Parts') -> 'Parts': + return { + 'domain': 'localhost', + 'port': '9092', + } + + +def stricturl( + *, + strip_whitespace: bool = True, + min_length: int = 1, + max_length: int = 2**16, + tld_required: bool = True, + host_required: bool = True, + allowed_schemes: Optional[Collection[str]] = None, +) -> Type[AnyUrl]: + # use kwargs then define conf in a dict to aid with IDE type hinting + namespace = dict( + strip_whitespace=strip_whitespace, + min_length=min_length, + max_length=max_length, + tld_required=tld_required, + host_required=host_required, + allowed_schemes=allowed_schemes, + ) + return type('UrlValue', (AnyUrl,), namespace) + + +def import_email_validator() -> None: + global email_validator + try: + import email_validator + except ImportError as e: + raise ImportError('email-validator is not installed, run `pip install pydantic[email]`') from e + + +class EmailStr(str): + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='string', format='email') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + # included here and below so the error happens straight away + import_email_validator() + + yield str_validator + yield cls.validate + + @classmethod + def validate(cls, value: Union[str]) -> str: + return validate_email(value)[1] + + +class NameEmail(Representation): + __slots__ = 'name', 'email' + + def __init__(self, name: str, email: str): + self.name = name + self.email = email + + def __eq__(self, other: Any) -> bool: + return isinstance(other, NameEmail) and (self.name, self.email) == (other.name, other.email) + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='string', format='name-email') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + import_email_validator() + + yield cls.validate + + @classmethod + def validate(cls, value: Any) -> 'NameEmail': + if value.__class__ == cls: + return value + value = str_validator(value) + return cls(*validate_email(value)) + + def __str__(self) -> str: + return f'{self.name} <{self.email}>' + + +class IPvAnyAddress(_BaseAddress): + __slots__ = () + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='string', format='ipvanyaddress') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + + @classmethod + def validate(cls, value: Union[str, bytes, int]) -> Union[IPv4Address, IPv6Address]: + try: + return IPv4Address(value) + except ValueError: + pass + + try: + return IPv6Address(value) + except ValueError: + raise errors.IPvAnyAddressError() + + +class IPvAnyInterface(_BaseAddress): + __slots__ = () + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='string', format='ipvanyinterface') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + + @classmethod + def validate(cls, value: NetworkType) -> Union[IPv4Interface, IPv6Interface]: + try: + return IPv4Interface(value) + except ValueError: + pass + + try: + return IPv6Interface(value) + except ValueError: + raise errors.IPvAnyInterfaceError() + + +class IPvAnyNetwork(_BaseNetwork): # type: ignore + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='string', format='ipvanynetwork') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + + @classmethod + def validate(cls, value: NetworkType) -> Union[IPv4Network, IPv6Network]: + # Assume IP Network is defined with a default value for ``strict`` argument. + # Define your own class if you want to specify network address check strictness. + try: + return IPv4Network(value) + except ValueError: + pass + + try: + return IPv6Network(value) + except ValueError: + raise errors.IPvAnyNetworkError() + + +pretty_email_regex = re.compile(r'([\w ]*?) *<(.*)> *') +MAX_EMAIL_LENGTH = 2048 +"""Maximum length for an email. +A somewhat arbitrary but very generous number compared to what is allowed by most implementations. +""" + + +def validate_email(value: Union[str]) -> Tuple[str, str]: + """ + Email address validation using https://pypi.org/project/email-validator/ + Notes: + * raw ip address (literal) domain parts are not allowed. + * "John Doe " style "pretty" email addresses are processed + * spaces are striped from the beginning and end of addresses but no error is raised + """ + if email_validator is None: + import_email_validator() + + if len(value) > MAX_EMAIL_LENGTH: + raise errors.EmailError() + + m = pretty_email_regex.fullmatch(value) + name: Union[str, None] = None + if m: + name, value = m.groups() + email = value.strip() + try: + parts = email_validator.validate_email(email, check_deliverability=False) + except email_validator.EmailNotValidError as e: + raise errors.EmailError from e + + if hasattr(parts, 'normalized'): + # email-validator >= 2 + email = parts.normalized + assert email is not None + name = name or parts.local_part + return name, email + else: + # email-validator >1, <2 + at_index = email.index('@') + local_part = email[:at_index] # RFC 5321, local part must be case-sensitive. + global_part = email[at_index:].lower() + + return name or local_part, local_part + global_part diff --git a/env/Lib/site-packages/pydantic/v1/parse.py b/env/Lib/site-packages/pydantic/v1/parse.py new file mode 100644 index 0000000..431d75a --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/parse.py @@ -0,0 +1,66 @@ +import json +import pickle +from enum import Enum +from pathlib import Path +from typing import Any, Callable, Union + +from pydantic.v1.types import StrBytes + + +class Protocol(str, Enum): + json = 'json' + pickle = 'pickle' + + +def load_str_bytes( + b: StrBytes, + *, + content_type: str = None, + encoding: str = 'utf8', + proto: Protocol = None, + allow_pickle: bool = False, + json_loads: Callable[[str], Any] = json.loads, +) -> Any: + if proto is None and content_type: + if content_type.endswith(('json', 'javascript')): + pass + elif allow_pickle and content_type.endswith('pickle'): + proto = Protocol.pickle + else: + raise TypeError(f'Unknown content-type: {content_type}') + + proto = proto or Protocol.json + + if proto == Protocol.json: + if isinstance(b, bytes): + b = b.decode(encoding) + return json_loads(b) + elif proto == Protocol.pickle: + if not allow_pickle: + raise RuntimeError('Trying to decode with pickle with allow_pickle=False') + bb = b if isinstance(b, bytes) else b.encode() + return pickle.loads(bb) + else: + raise TypeError(f'Unknown protocol: {proto}') + + +def load_file( + path: Union[str, Path], + *, + content_type: str = None, + encoding: str = 'utf8', + proto: Protocol = None, + allow_pickle: bool = False, + json_loads: Callable[[str], Any] = json.loads, +) -> Any: + path = Path(path) + b = path.read_bytes() + if content_type is None: + if path.suffix in ('.js', '.json'): + proto = Protocol.json + elif path.suffix == '.pkl': + proto = Protocol.pickle + + return load_str_bytes( + b, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, json_loads=json_loads + ) diff --git a/env/Lib/site-packages/pydantic/v1/py.typed b/env/Lib/site-packages/pydantic/v1/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/env/Lib/site-packages/pydantic/v1/schema.py b/env/Lib/site-packages/pydantic/v1/schema.py new file mode 100644 index 0000000..bac4c0a --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/schema.py @@ -0,0 +1,1163 @@ +import re +import warnings +from collections import defaultdict +from dataclasses import is_dataclass +from datetime import date, datetime, time, timedelta +from decimal import Decimal +from enum import Enum +from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network +from pathlib import Path +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Dict, + ForwardRef, + FrozenSet, + Generic, + Iterable, + List, + Optional, + Pattern, + Sequence, + Set, + Tuple, + Type, + TypeVar, + Union, + cast, +) +from uuid import UUID + +from typing_extensions import Annotated, Literal + +from pydantic.v1.fields import ( + MAPPING_LIKE_SHAPES, + SHAPE_DEQUE, + SHAPE_FROZENSET, + SHAPE_GENERIC, + SHAPE_ITERABLE, + SHAPE_LIST, + SHAPE_SEQUENCE, + SHAPE_SET, + SHAPE_SINGLETON, + SHAPE_TUPLE, + SHAPE_TUPLE_ELLIPSIS, + FieldInfo, + ModelField, +) +from pydantic.v1.json import pydantic_encoder +from pydantic.v1.networks import AnyUrl, EmailStr +from pydantic.v1.types import ( + ConstrainedDecimal, + ConstrainedFloat, + ConstrainedFrozenSet, + ConstrainedInt, + ConstrainedList, + ConstrainedSet, + ConstrainedStr, + SecretBytes, + SecretStr, + StrictBytes, + StrictStr, + conbytes, + condecimal, + confloat, + confrozenset, + conint, + conlist, + conset, + constr, +) +from pydantic.v1.typing import ( + all_literal_values, + get_args, + get_origin, + get_sub_types, + is_callable_type, + is_literal_type, + is_namedtuple, + is_none_type, + is_union, +) +from pydantic.v1.utils import ROOT_KEY, get_model, lenient_issubclass + +if TYPE_CHECKING: + from pydantic.v1.dataclasses import Dataclass + from pydantic.v1.main import BaseModel + +default_prefix = '#/definitions/' +default_ref_template = '#/definitions/{model}' + +TypeModelOrEnum = Union[Type['BaseModel'], Type[Enum]] +TypeModelSet = Set[TypeModelOrEnum] + + +def _apply_modify_schema( + modify_schema: Callable[..., None], field: Optional[ModelField], field_schema: Dict[str, Any] +) -> None: + from inspect import signature + + sig = signature(modify_schema) + args = set(sig.parameters.keys()) + if 'field' in args or 'kwargs' in args: + modify_schema(field_schema, field=field) + else: + modify_schema(field_schema) + + +def schema( + models: Sequence[Union[Type['BaseModel'], Type['Dataclass']]], + *, + by_alias: bool = True, + title: Optional[str] = None, + description: Optional[str] = None, + ref_prefix: Optional[str] = None, + ref_template: str = default_ref_template, +) -> Dict[str, Any]: + """ + Process a list of models and generate a single JSON Schema with all of them defined in the ``definitions`` + top-level JSON key, including their sub-models. + + :param models: a list of models to include in the generated JSON Schema + :param by_alias: generate the schemas using the aliases defined, if any + :param title: title for the generated schema that includes the definitions + :param description: description for the generated schema + :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the + default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere + else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the + top-level key ``definitions``, so you can extract them from there. But all the references will have the set + prefix. + :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful + for references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For + a sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``. + :return: dict with the JSON Schema with a ``definitions`` top-level key including the schema definitions for + the models and sub-models passed in ``models``. + """ + clean_models = [get_model(model) for model in models] + flat_models = get_flat_models_from_models(clean_models) + model_name_map = get_model_name_map(flat_models) + definitions = {} + output_schema: Dict[str, Any] = {} + if title: + output_schema['title'] = title + if description: + output_schema['description'] = description + for model in clean_models: + m_schema, m_definitions, m_nested_models = model_process_schema( + model, + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + ) + definitions.update(m_definitions) + model_name = model_name_map[model] + definitions[model_name] = m_schema + if definitions: + output_schema['definitions'] = definitions + return output_schema + + +def model_schema( + model: Union[Type['BaseModel'], Type['Dataclass']], + by_alias: bool = True, + ref_prefix: Optional[str] = None, + ref_template: str = default_ref_template, +) -> Dict[str, Any]: + """ + Generate a JSON Schema for one model. With all the sub-models defined in the ``definitions`` top-level + JSON key. + + :param model: a Pydantic model (a class that inherits from BaseModel) + :param by_alias: generate the schemas using the aliases defined, if any + :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the + default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere + else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the + top-level key ``definitions``, so you can extract them from there. But all the references will have the set + prefix. + :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for + references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a + sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``. + :return: dict with the JSON Schema for the passed ``model`` + """ + model = get_model(model) + flat_models = get_flat_models_from_model(model) + model_name_map = get_model_name_map(flat_models) + model_name = model_name_map[model] + m_schema, m_definitions, nested_models = model_process_schema( + model, by_alias=by_alias, model_name_map=model_name_map, ref_prefix=ref_prefix, ref_template=ref_template + ) + if model_name in nested_models: + # model_name is in Nested models, it has circular references + m_definitions[model_name] = m_schema + m_schema = get_schema_ref(model_name, ref_prefix, ref_template, False) + if m_definitions: + m_schema.update({'definitions': m_definitions}) + return m_schema + + +def get_field_info_schema(field: ModelField, schema_overrides: bool = False) -> Tuple[Dict[str, Any], bool]: + # If no title is explicitly set, we don't set title in the schema for enums. + # The behaviour is the same as `BaseModel` reference, where the default title + # is in the definitions part of the schema. + schema_: Dict[str, Any] = {} + if field.field_info.title or not lenient_issubclass(field.type_, Enum): + schema_['title'] = field.field_info.title or field.alias.title().replace('_', ' ') + + if field.field_info.title: + schema_overrides = True + + if field.field_info.description: + schema_['description'] = field.field_info.description + schema_overrides = True + + if not field.required and field.default is not None and not is_callable_type(field.outer_type_): + schema_['default'] = encode_default(field.default) + schema_overrides = True + + return schema_, schema_overrides + + +def field_schema( + field: ModelField, + *, + by_alias: bool = True, + model_name_map: Dict[TypeModelOrEnum, str], + ref_prefix: Optional[str] = None, + ref_template: str = default_ref_template, + known_models: Optional[TypeModelSet] = None, +) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: + """ + Process a Pydantic field and return a tuple with a JSON Schema for it as the first item. + Also return a dictionary of definitions with models as keys and their schemas as values. If the passed field + is a model and has sub-models, and those sub-models don't have overrides (as ``title``, ``default``, etc), they + will be included in the definitions and referenced in the schema instead of included recursively. + + :param field: a Pydantic ``ModelField`` + :param by_alias: use the defined alias (if any) in the returned schema + :param model_name_map: used to generate the JSON Schema references to other models included in the definitions + :param ref_prefix: the JSON Pointer prefix to use for references to other schemas, if None, the default of + #/definitions/ will be used + :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for + references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a + sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``. + :param known_models: used to solve circular references + :return: tuple of the schema for this field and additional definitions + """ + s, schema_overrides = get_field_info_schema(field) + + validation_schema = get_field_schema_validations(field) + if validation_schema: + s.update(validation_schema) + schema_overrides = True + + f_schema, f_definitions, f_nested_models = field_type_schema( + field, + by_alias=by_alias, + model_name_map=model_name_map, + schema_overrides=schema_overrides, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models or set(), + ) + + # $ref will only be returned when there are no schema_overrides + if '$ref' in f_schema: + return f_schema, f_definitions, f_nested_models + else: + s.update(f_schema) + return s, f_definitions, f_nested_models + + +numeric_types = (int, float, Decimal) +_str_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = ( + ('max_length', numeric_types, 'maxLength'), + ('min_length', numeric_types, 'minLength'), + ('regex', str, 'pattern'), +) + +_numeric_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = ( + ('gt', numeric_types, 'exclusiveMinimum'), + ('lt', numeric_types, 'exclusiveMaximum'), + ('ge', numeric_types, 'minimum'), + ('le', numeric_types, 'maximum'), + ('multiple_of', numeric_types, 'multipleOf'), +) + + +def get_field_schema_validations(field: ModelField) -> Dict[str, Any]: + """ + Get the JSON Schema validation keywords for a ``field`` with an annotation of + a Pydantic ``FieldInfo`` with validation arguments. + """ + f_schema: Dict[str, Any] = {} + + if lenient_issubclass(field.type_, Enum): + # schema is already updated by `enum_process_schema`; just update with field extra + if field.field_info.extra: + f_schema.update(field.field_info.extra) + return f_schema + + if lenient_issubclass(field.type_, (str, bytes)): + for attr_name, t, keyword in _str_types_attrs: + attr = getattr(field.field_info, attr_name, None) + if isinstance(attr, t): + f_schema[keyword] = attr + if lenient_issubclass(field.type_, numeric_types) and not issubclass(field.type_, bool): + for attr_name, t, keyword in _numeric_types_attrs: + attr = getattr(field.field_info, attr_name, None) + if isinstance(attr, t): + f_schema[keyword] = attr + if field.field_info is not None and field.field_info.const: + f_schema['const'] = field.default + if field.field_info.extra: + f_schema.update(field.field_info.extra) + modify_schema = getattr(field.outer_type_, '__modify_schema__', None) + if modify_schema: + _apply_modify_schema(modify_schema, field, f_schema) + return f_schema + + +def get_model_name_map(unique_models: TypeModelSet) -> Dict[TypeModelOrEnum, str]: + """ + Process a set of models and generate unique names for them to be used as keys in the JSON Schema + definitions. By default the names are the same as the class name. But if two models in different Python + modules have the same name (e.g. "users.Model" and "items.Model"), the generated names will be + based on the Python module path for those conflicting models to prevent name collisions. + + :param unique_models: a Python set of models + :return: dict mapping models to names + """ + name_model_map = {} + conflicting_names: Set[str] = set() + for model in unique_models: + model_name = normalize_name(model.__name__) + if model_name in conflicting_names: + model_name = get_long_model_name(model) + name_model_map[model_name] = model + elif model_name in name_model_map: + conflicting_names.add(model_name) + conflicting_model = name_model_map.pop(model_name) + name_model_map[get_long_model_name(conflicting_model)] = conflicting_model + name_model_map[get_long_model_name(model)] = model + else: + name_model_map[model_name] = model + return {v: k for k, v in name_model_map.items()} + + +def get_flat_models_from_model(model: Type['BaseModel'], known_models: Optional[TypeModelSet] = None) -> TypeModelSet: + """ + Take a single ``model`` and generate a set with itself and all the sub-models in the tree. I.e. if you pass + model ``Foo`` (subclass of Pydantic ``BaseModel``) as ``model``, and it has a field of type ``Bar`` (also + subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also subclass of ``BaseModel``), + the return value will be ``set([Foo, Bar, Baz])``. + + :param model: a Pydantic ``BaseModel`` subclass + :param known_models: used to solve circular references + :return: a set with the initial model and all its sub-models + """ + known_models = known_models or set() + flat_models: TypeModelSet = set() + flat_models.add(model) + known_models |= flat_models + fields = cast(Sequence[ModelField], model.__fields__.values()) + flat_models |= get_flat_models_from_fields(fields, known_models=known_models) + return flat_models + + +def get_flat_models_from_field(field: ModelField, known_models: TypeModelSet) -> TypeModelSet: + """ + Take a single Pydantic ``ModelField`` (from a model) that could have been declared as a subclass of BaseModel + (so, it could be a submodel), and generate a set with its model and all the sub-models in the tree. + I.e. if you pass a field that was declared to be of type ``Foo`` (subclass of BaseModel) as ``field``, and that + model ``Foo`` has a field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of + type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``. + + :param field: a Pydantic ``ModelField`` + :param known_models: used to solve circular references + :return: a set with the model used in the declaration for this field, if any, and all its sub-models + """ + from pydantic.v1.main import BaseModel + + flat_models: TypeModelSet = set() + + field_type = field.type_ + if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel): + field_type = field_type.__pydantic_model__ + + if field.sub_fields and not lenient_issubclass(field_type, BaseModel): + flat_models |= get_flat_models_from_fields(field.sub_fields, known_models=known_models) + elif lenient_issubclass(field_type, BaseModel) and field_type not in known_models: + flat_models |= get_flat_models_from_model(field_type, known_models=known_models) + elif lenient_issubclass(field_type, Enum): + flat_models.add(field_type) + return flat_models + + +def get_flat_models_from_fields(fields: Sequence[ModelField], known_models: TypeModelSet) -> TypeModelSet: + """ + Take a list of Pydantic ``ModelField``s (from a model) that could have been declared as subclasses of ``BaseModel`` + (so, any of them could be a submodel), and generate a set with their models and all the sub-models in the tree. + I.e. if you pass a the fields of a model ``Foo`` (subclass of ``BaseModel``) as ``fields``, and on of them has a + field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also + subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``. + + :param fields: a list of Pydantic ``ModelField``s + :param known_models: used to solve circular references + :return: a set with any model declared in the fields, and all their sub-models + """ + flat_models: TypeModelSet = set() + for field in fields: + flat_models |= get_flat_models_from_field(field, known_models=known_models) + return flat_models + + +def get_flat_models_from_models(models: Sequence[Type['BaseModel']]) -> TypeModelSet: + """ + Take a list of ``models`` and generate a set with them and all their sub-models in their trees. I.e. if you pass + a list of two models, ``Foo`` and ``Bar``, both subclasses of Pydantic ``BaseModel`` as models, and ``Bar`` has + a field of type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``. + """ + flat_models: TypeModelSet = set() + for model in models: + flat_models |= get_flat_models_from_model(model) + return flat_models + + +def get_long_model_name(model: TypeModelOrEnum) -> str: + return f'{model.__module__}__{model.__qualname__}'.replace('.', '__') + + +def field_type_schema( + field: ModelField, + *, + by_alias: bool, + model_name_map: Dict[TypeModelOrEnum, str], + ref_template: str, + schema_overrides: bool = False, + ref_prefix: Optional[str] = None, + known_models: TypeModelSet, +) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: + """ + Used by ``field_schema()``, you probably should be using that function. + + Take a single ``field`` and generate the schema for its type only, not including additional + information as title, etc. Also return additional schema definitions, from sub-models. + """ + from pydantic.v1.main import BaseModel # noqa: F811 + + definitions = {} + nested_models: Set[str] = set() + f_schema: Dict[str, Any] + if field.shape in { + SHAPE_LIST, + SHAPE_TUPLE_ELLIPSIS, + SHAPE_SEQUENCE, + SHAPE_SET, + SHAPE_FROZENSET, + SHAPE_ITERABLE, + SHAPE_DEQUE, + }: + items_schema, f_definitions, f_nested_models = field_singleton_schema( + field, + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + definitions.update(f_definitions) + nested_models.update(f_nested_models) + f_schema = {'type': 'array', 'items': items_schema} + if field.shape in {SHAPE_SET, SHAPE_FROZENSET}: + f_schema['uniqueItems'] = True + + elif field.shape in MAPPING_LIKE_SHAPES: + f_schema = {'type': 'object'} + key_field = cast(ModelField, field.key_field) + regex = getattr(key_field.type_, 'regex', None) + items_schema, f_definitions, f_nested_models = field_singleton_schema( + field, + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + definitions.update(f_definitions) + nested_models.update(f_nested_models) + if regex: + # Dict keys have a regex pattern + # items_schema might be a schema or empty dict, add it either way + f_schema['patternProperties'] = {ConstrainedStr._get_pattern(regex): items_schema} + if items_schema: + # The dict values are not simply Any, so they need a schema + f_schema['additionalProperties'] = items_schema + elif field.shape == SHAPE_TUPLE or (field.shape == SHAPE_GENERIC and not issubclass(field.type_, BaseModel)): + sub_schema = [] + sub_fields = cast(List[ModelField], field.sub_fields) + for sf in sub_fields: + sf_schema, sf_definitions, sf_nested_models = field_type_schema( + sf, + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + definitions.update(sf_definitions) + nested_models.update(sf_nested_models) + sub_schema.append(sf_schema) + + sub_fields_len = len(sub_fields) + if field.shape == SHAPE_GENERIC: + all_of_schemas = sub_schema[0] if sub_fields_len == 1 else {'type': 'array', 'items': sub_schema} + f_schema = {'allOf': [all_of_schemas]} + else: + f_schema = { + 'type': 'array', + 'minItems': sub_fields_len, + 'maxItems': sub_fields_len, + } + if sub_fields_len >= 1: + f_schema['items'] = sub_schema + else: + assert field.shape in {SHAPE_SINGLETON, SHAPE_GENERIC}, field.shape + f_schema, f_definitions, f_nested_models = field_singleton_schema( + field, + by_alias=by_alias, + model_name_map=model_name_map, + schema_overrides=schema_overrides, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + definitions.update(f_definitions) + nested_models.update(f_nested_models) + + # check field type to avoid repeated calls to the same __modify_schema__ method + if field.type_ != field.outer_type_: + if field.shape == SHAPE_GENERIC: + field_type = field.type_ + else: + field_type = field.outer_type_ + modify_schema = getattr(field_type, '__modify_schema__', None) + if modify_schema: + _apply_modify_schema(modify_schema, field, f_schema) + return f_schema, definitions, nested_models + + +def model_process_schema( + model: TypeModelOrEnum, + *, + by_alias: bool = True, + model_name_map: Dict[TypeModelOrEnum, str], + ref_prefix: Optional[str] = None, + ref_template: str = default_ref_template, + known_models: Optional[TypeModelSet] = None, + field: Optional[ModelField] = None, +) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: + """ + Used by ``model_schema()``, you probably should be using that function. + + Take a single ``model`` and generate its schema. Also return additional schema definitions, from sub-models. The + sub-models of the returned schema will be referenced, but their definitions will not be included in the schema. All + the definitions are returned as the second value. + """ + from inspect import getdoc, signature + + known_models = known_models or set() + if lenient_issubclass(model, Enum): + model = cast(Type[Enum], model) + s = enum_process_schema(model, field=field) + return s, {}, set() + model = cast(Type['BaseModel'], model) + s = {'title': model.__config__.title or model.__name__} + doc = getdoc(model) + if doc: + s['description'] = doc + known_models.add(model) + m_schema, m_definitions, nested_models = model_type_schema( + model, + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + s.update(m_schema) + schema_extra = model.__config__.schema_extra + if callable(schema_extra): + if len(signature(schema_extra).parameters) == 1: + schema_extra(s) + else: + schema_extra(s, model) + else: + s.update(schema_extra) + return s, m_definitions, nested_models + + +def model_type_schema( + model: Type['BaseModel'], + *, + by_alias: bool, + model_name_map: Dict[TypeModelOrEnum, str], + ref_template: str, + ref_prefix: Optional[str] = None, + known_models: TypeModelSet, +) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: + """ + You probably should be using ``model_schema()``, this function is indirectly used by that function. + + Take a single ``model`` and generate the schema for its type only, not including additional + information as title, etc. Also return additional schema definitions, from sub-models. + """ + properties = {} + required = [] + definitions: Dict[str, Any] = {} + nested_models: Set[str] = set() + for k, f in model.__fields__.items(): + try: + f_schema, f_definitions, f_nested_models = field_schema( + f, + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + except SkipField as skip: + warnings.warn(skip.message, UserWarning) + continue + definitions.update(f_definitions) + nested_models.update(f_nested_models) + if by_alias: + properties[f.alias] = f_schema + if f.required: + required.append(f.alias) + else: + properties[k] = f_schema + if f.required: + required.append(k) + if ROOT_KEY in properties: + out_schema = properties[ROOT_KEY] + out_schema['title'] = model.__config__.title or model.__name__ + else: + out_schema = {'type': 'object', 'properties': properties} + if required: + out_schema['required'] = required + if model.__config__.extra == 'forbid': + out_schema['additionalProperties'] = False + return out_schema, definitions, nested_models + + +def enum_process_schema(enum: Type[Enum], *, field: Optional[ModelField] = None) -> Dict[str, Any]: + """ + Take a single `enum` and generate its schema. + + This is similar to the `model_process_schema` function, but applies to ``Enum`` objects. + """ + import inspect + + schema_: Dict[str, Any] = { + 'title': enum.__name__, + # Python assigns all enums a default docstring value of 'An enumeration', so + # all enums will have a description field even if not explicitly provided. + 'description': inspect.cleandoc(enum.__doc__ or 'An enumeration.'), + # Add enum values and the enum field type to the schema. + 'enum': [item.value for item in cast(Iterable[Enum], enum)], + } + + add_field_type_to_schema(enum, schema_) + + modify_schema = getattr(enum, '__modify_schema__', None) + if modify_schema: + _apply_modify_schema(modify_schema, field, schema_) + + return schema_ + + +def field_singleton_sub_fields_schema( + field: ModelField, + *, + by_alias: bool, + model_name_map: Dict[TypeModelOrEnum, str], + ref_template: str, + schema_overrides: bool = False, + ref_prefix: Optional[str] = None, + known_models: TypeModelSet, +) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: + """ + This function is indirectly used by ``field_schema()``, you probably should be using that function. + + Take a list of Pydantic ``ModelField`` from the declaration of a type with parameters, and generate their + schema. I.e., fields used as "type parameters", like ``str`` and ``int`` in ``Tuple[str, int]``. + """ + sub_fields = cast(List[ModelField], field.sub_fields) + definitions = {} + nested_models: Set[str] = set() + if len(sub_fields) == 1: + return field_type_schema( + sub_fields[0], + by_alias=by_alias, + model_name_map=model_name_map, + schema_overrides=schema_overrides, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + else: + s: Dict[str, Any] = {} + # https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#discriminator-object + field_has_discriminator: bool = field.discriminator_key is not None + if field_has_discriminator: + assert field.sub_fields_mapping is not None + + discriminator_models_refs: Dict[str, Union[str, Dict[str, Any]]] = {} + + for discriminator_value, sub_field in field.sub_fields_mapping.items(): + if isinstance(discriminator_value, Enum): + discriminator_value = str(discriminator_value.value) + # sub_field is either a `BaseModel` or directly an `Annotated` `Union` of many + if is_union(get_origin(sub_field.type_)): + sub_models = get_sub_types(sub_field.type_) + discriminator_models_refs[discriminator_value] = { + model_name_map[sub_model]: get_schema_ref( + model_name_map[sub_model], ref_prefix, ref_template, False + ) + for sub_model in sub_models + } + else: + sub_field_type = sub_field.type_ + if hasattr(sub_field_type, '__pydantic_model__'): + sub_field_type = sub_field_type.__pydantic_model__ + + discriminator_model_name = model_name_map[sub_field_type] + discriminator_model_ref = get_schema_ref(discriminator_model_name, ref_prefix, ref_template, False) + discriminator_models_refs[discriminator_value] = discriminator_model_ref['$ref'] + + s['discriminator'] = { + 'propertyName': field.discriminator_alias, + 'mapping': discriminator_models_refs, + } + + sub_field_schemas = [] + for sf in sub_fields: + sub_schema, sub_definitions, sub_nested_models = field_type_schema( + sf, + by_alias=by_alias, + model_name_map=model_name_map, + schema_overrides=schema_overrides, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + definitions.update(sub_definitions) + if schema_overrides and 'allOf' in sub_schema: + # if the sub_field is a referenced schema we only need the referenced + # object. Otherwise we will end up with several allOf inside anyOf/oneOf. + # See https://github.com/pydantic/pydantic/issues/1209 + sub_schema = sub_schema['allOf'][0] + + if sub_schema.keys() == {'discriminator', 'oneOf'}: + # we don't want discriminator information inside oneOf choices, this is dealt with elsewhere + sub_schema.pop('discriminator') + sub_field_schemas.append(sub_schema) + nested_models.update(sub_nested_models) + s['oneOf' if field_has_discriminator else 'anyOf'] = sub_field_schemas + return s, definitions, nested_models + + +# Order is important, e.g. subclasses of str must go before str +# this is used only for standard library types, custom types should use __modify_schema__ instead +field_class_to_schema: Tuple[Tuple[Any, Dict[str, Any]], ...] = ( + (Path, {'type': 'string', 'format': 'path'}), + (datetime, {'type': 'string', 'format': 'date-time'}), + (date, {'type': 'string', 'format': 'date'}), + (time, {'type': 'string', 'format': 'time'}), + (timedelta, {'type': 'number', 'format': 'time-delta'}), + (IPv4Network, {'type': 'string', 'format': 'ipv4network'}), + (IPv6Network, {'type': 'string', 'format': 'ipv6network'}), + (IPv4Interface, {'type': 'string', 'format': 'ipv4interface'}), + (IPv6Interface, {'type': 'string', 'format': 'ipv6interface'}), + (IPv4Address, {'type': 'string', 'format': 'ipv4'}), + (IPv6Address, {'type': 'string', 'format': 'ipv6'}), + (Pattern, {'type': 'string', 'format': 'regex'}), + (str, {'type': 'string'}), + (bytes, {'type': 'string', 'format': 'binary'}), + (bool, {'type': 'boolean'}), + (int, {'type': 'integer'}), + (float, {'type': 'number'}), + (Decimal, {'type': 'number'}), + (UUID, {'type': 'string', 'format': 'uuid'}), + (dict, {'type': 'object'}), + (list, {'type': 'array', 'items': {}}), + (tuple, {'type': 'array', 'items': {}}), + (set, {'type': 'array', 'items': {}, 'uniqueItems': True}), + (frozenset, {'type': 'array', 'items': {}, 'uniqueItems': True}), +) + +json_scheme = {'type': 'string', 'format': 'json-string'} + + +def add_field_type_to_schema(field_type: Any, schema_: Dict[str, Any]) -> None: + """ + Update the given `schema` with the type-specific metadata for the given `field_type`. + + This function looks through `field_class_to_schema` for a class that matches the given `field_type`, + and then modifies the given `schema` with the information from that type. + """ + for type_, t_schema in field_class_to_schema: + # Fallback for `typing.Pattern` and `re.Pattern` as they are not a valid class + if lenient_issubclass(field_type, type_) or field_type is type_ is Pattern: + schema_.update(t_schema) + break + + +def get_schema_ref(name: str, ref_prefix: Optional[str], ref_template: str, schema_overrides: bool) -> Dict[str, Any]: + if ref_prefix: + schema_ref = {'$ref': ref_prefix + name} + else: + schema_ref = {'$ref': ref_template.format(model=name)} + return {'allOf': [schema_ref]} if schema_overrides else schema_ref + + +def field_singleton_schema( # noqa: C901 (ignore complexity) + field: ModelField, + *, + by_alias: bool, + model_name_map: Dict[TypeModelOrEnum, str], + ref_template: str, + schema_overrides: bool = False, + ref_prefix: Optional[str] = None, + known_models: TypeModelSet, +) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]: + """ + This function is indirectly used by ``field_schema()``, you should probably be using that function. + + Take a single Pydantic ``ModelField``, and return its schema and any additional definitions from sub-models. + """ + from pydantic.v1.main import BaseModel + + definitions: Dict[str, Any] = {} + nested_models: Set[str] = set() + field_type = field.type_ + + # Recurse into this field if it contains sub_fields and is NOT a + # BaseModel OR that BaseModel is a const + if field.sub_fields and ( + (field.field_info and field.field_info.const) or not lenient_issubclass(field_type, BaseModel) + ): + return field_singleton_sub_fields_schema( + field, + by_alias=by_alias, + model_name_map=model_name_map, + schema_overrides=schema_overrides, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + if field_type is Any or field_type is object or field_type.__class__ == TypeVar or get_origin(field_type) is type: + return {}, definitions, nested_models # no restrictions + if is_none_type(field_type): + return {'type': 'null'}, definitions, nested_models + if is_callable_type(field_type): + raise SkipField(f'Callable {field.name} was excluded from schema since JSON schema has no equivalent type.') + f_schema: Dict[str, Any] = {} + if field.field_info is not None and field.field_info.const: + f_schema['const'] = field.default + + if is_literal_type(field_type): + values = tuple(x.value if isinstance(x, Enum) else x for x in all_literal_values(field_type)) + + if len({v.__class__ for v in values}) > 1: + return field_schema( + multitypes_literal_field_for_schema(values, field), + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + ) + + # All values have the same type + field_type = values[0].__class__ + f_schema['enum'] = list(values) + add_field_type_to_schema(field_type, f_schema) + elif lenient_issubclass(field_type, Enum): + enum_name = model_name_map[field_type] + f_schema, schema_overrides = get_field_info_schema(field, schema_overrides) + f_schema.update(get_schema_ref(enum_name, ref_prefix, ref_template, schema_overrides)) + definitions[enum_name] = enum_process_schema(field_type, field=field) + elif is_namedtuple(field_type): + sub_schema, *_ = model_process_schema( + field_type.__pydantic_model__, + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + field=field, + ) + items_schemas = list(sub_schema['properties'].values()) + f_schema.update( + { + 'type': 'array', + 'items': items_schemas, + 'minItems': len(items_schemas), + 'maxItems': len(items_schemas), + } + ) + elif not hasattr(field_type, '__pydantic_model__'): + add_field_type_to_schema(field_type, f_schema) + + modify_schema = getattr(field_type, '__modify_schema__', None) + if modify_schema: + _apply_modify_schema(modify_schema, field, f_schema) + + if f_schema: + return f_schema, definitions, nested_models + + # Handle dataclass-based models + if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel): + field_type = field_type.__pydantic_model__ + + if issubclass(field_type, BaseModel): + model_name = model_name_map[field_type] + if field_type not in known_models: + sub_schema, sub_definitions, sub_nested_models = model_process_schema( + field_type, + by_alias=by_alias, + model_name_map=model_name_map, + ref_prefix=ref_prefix, + ref_template=ref_template, + known_models=known_models, + field=field, + ) + definitions.update(sub_definitions) + definitions[model_name] = sub_schema + nested_models.update(sub_nested_models) + else: + nested_models.add(model_name) + schema_ref = get_schema_ref(model_name, ref_prefix, ref_template, schema_overrides) + return schema_ref, definitions, nested_models + + # For generics with no args + args = get_args(field_type) + if args is not None and not args and Generic in field_type.__bases__: + return f_schema, definitions, nested_models + + raise ValueError(f'Value not declarable with JSON Schema, field: {field}') + + +def multitypes_literal_field_for_schema(values: Tuple[Any, ...], field: ModelField) -> ModelField: + """ + To support `Literal` with values of different types, we split it into multiple `Literal` with same type + e.g. `Literal['qwe', 'asd', 1, 2]` becomes `Union[Literal['qwe', 'asd'], Literal[1, 2]]` + """ + literal_distinct_types = defaultdict(list) + for v in values: + literal_distinct_types[v.__class__].append(v) + distinct_literals = (Literal[tuple(same_type_values)] for same_type_values in literal_distinct_types.values()) + + return ModelField( + name=field.name, + type_=Union[tuple(distinct_literals)], # type: ignore + class_validators=field.class_validators, + model_config=field.model_config, + default=field.default, + required=field.required, + alias=field.alias, + field_info=field.field_info, + ) + + +def encode_default(dft: Any) -> Any: + from pydantic.v1.main import BaseModel + + if isinstance(dft, BaseModel) or is_dataclass(dft): + dft = cast('dict[str, Any]', pydantic_encoder(dft)) + + if isinstance(dft, dict): + return {encode_default(k): encode_default(v) for k, v in dft.items()} + elif isinstance(dft, Enum): + return dft.value + elif isinstance(dft, (int, float, str)): + return dft + elif isinstance(dft, (list, tuple)): + t = dft.__class__ + seq_args = (encode_default(v) for v in dft) + return t(*seq_args) if is_namedtuple(t) else t(seq_args) + elif dft is None: + return None + else: + return pydantic_encoder(dft) + + +_map_types_constraint: Dict[Any, Callable[..., type]] = {int: conint, float: confloat, Decimal: condecimal} + + +def get_annotation_from_field_info( + annotation: Any, field_info: FieldInfo, field_name: str, validate_assignment: bool = False +) -> Type[Any]: + """ + Get an annotation with validation implemented for numbers and strings based on the field_info. + :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr`` + :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema + :param field_name: name of the field for use in error messages + :param validate_assignment: default False, flag for BaseModel Config value of validate_assignment + :return: the same ``annotation`` if unmodified or a new annotation with validation in place + """ + constraints = field_info.get_constraints() + used_constraints: Set[str] = set() + if constraints: + annotation, used_constraints = get_annotation_with_constraints(annotation, field_info) + if validate_assignment: + used_constraints.add('allow_mutation') + + unused_constraints = constraints - used_constraints + if unused_constraints: + raise ValueError( + f'On field "{field_name}" the following field constraints are set but not enforced: ' + f'{", ".join(unused_constraints)}. ' + f'\nFor more details see https://docs.pydantic.dev/usage/schema/#unenforced-field-constraints' + ) + + return annotation + + +def get_annotation_with_constraints(annotation: Any, field_info: FieldInfo) -> Tuple[Type[Any], Set[str]]: # noqa: C901 + """ + Get an annotation with used constraints implemented for numbers and strings based on the field_info. + + :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr`` + :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema + :return: the same ``annotation`` if unmodified or a new annotation along with the used constraints. + """ + used_constraints: Set[str] = set() + + def go(type_: Any) -> Type[Any]: + if ( + is_literal_type(type_) + or isinstance(type_, ForwardRef) + or lenient_issubclass(type_, (ConstrainedList, ConstrainedSet, ConstrainedFrozenSet)) + ): + return type_ + origin = get_origin(type_) + if origin is not None: + args: Tuple[Any, ...] = get_args(type_) + if any(isinstance(a, ForwardRef) for a in args): + # forward refs cause infinite recursion below + return type_ + + if origin is Annotated: + return go(args[0]) + if is_union(origin): + return Union[tuple(go(a) for a in args)] # type: ignore + + if issubclass(origin, List) and ( + field_info.min_items is not None + or field_info.max_items is not None + or field_info.unique_items is not None + ): + used_constraints.update({'min_items', 'max_items', 'unique_items'}) + return conlist( + go(args[0]), + min_items=field_info.min_items, + max_items=field_info.max_items, + unique_items=field_info.unique_items, + ) + + if issubclass(origin, Set) and (field_info.min_items is not None or field_info.max_items is not None): + used_constraints.update({'min_items', 'max_items'}) + return conset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items) + + if issubclass(origin, FrozenSet) and (field_info.min_items is not None or field_info.max_items is not None): + used_constraints.update({'min_items', 'max_items'}) + return confrozenset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items) + + for t in (Tuple, List, Set, FrozenSet, Sequence): + if issubclass(origin, t): # type: ignore + return t[tuple(go(a) for a in args)] # type: ignore + + if issubclass(origin, Dict): + return Dict[args[0], go(args[1])] # type: ignore + + attrs: Optional[Tuple[str, ...]] = None + constraint_func: Optional[Callable[..., type]] = None + if isinstance(type_, type): + if issubclass(type_, (SecretStr, SecretBytes)): + attrs = ('max_length', 'min_length') + + def constraint_func(**kw: Any) -> Type[Any]: # noqa: F811 + return type(type_.__name__, (type_,), kw) + + elif issubclass(type_, str) and not issubclass(type_, (EmailStr, AnyUrl)): + attrs = ('max_length', 'min_length', 'regex') + if issubclass(type_, StrictStr): + + def constraint_func(**kw: Any) -> Type[Any]: + return type(type_.__name__, (type_,), kw) + + else: + constraint_func = constr + elif issubclass(type_, bytes): + attrs = ('max_length', 'min_length', 'regex') + if issubclass(type_, StrictBytes): + + def constraint_func(**kw: Any) -> Type[Any]: + return type(type_.__name__, (type_,), kw) + + else: + constraint_func = conbytes + elif issubclass(type_, numeric_types) and not issubclass( + type_, + ( + ConstrainedInt, + ConstrainedFloat, + ConstrainedDecimal, + ConstrainedList, + ConstrainedSet, + ConstrainedFrozenSet, + bool, + ), + ): + # Is numeric type + attrs = ('gt', 'lt', 'ge', 'le', 'multiple_of') + if issubclass(type_, float): + attrs += ('allow_inf_nan',) + if issubclass(type_, Decimal): + attrs += ('max_digits', 'decimal_places') + numeric_type = next(t for t in numeric_types if issubclass(type_, t)) # pragma: no branch + constraint_func = _map_types_constraint[numeric_type] + + if attrs: + used_constraints.update(set(attrs)) + kwargs = { + attr_name: attr + for attr_name, attr in ((attr_name, getattr(field_info, attr_name)) for attr_name in attrs) + if attr is not None + } + if kwargs: + constraint_func = cast(Callable[..., type], constraint_func) + return constraint_func(**kwargs) + return type_ + + return go(annotation), used_constraints + + +def normalize_name(name: str) -> str: + """ + Normalizes the given name. This can be applied to either a model *or* enum. + """ + return re.sub(r'[^a-zA-Z0-9.\-_]', '_', name) + + +class SkipField(Exception): + """ + Utility exception used to exclude fields from schema. + """ + + def __init__(self, message: str) -> None: + self.message = message diff --git a/env/Lib/site-packages/pydantic/v1/tools.py b/env/Lib/site-packages/pydantic/v1/tools.py new file mode 100644 index 0000000..6838a23 --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/tools.py @@ -0,0 +1,92 @@ +import json +from functools import lru_cache +from pathlib import Path +from typing import TYPE_CHECKING, Any, Callable, Optional, Type, TypeVar, Union + +from pydantic.v1.parse import Protocol, load_file, load_str_bytes +from pydantic.v1.types import StrBytes +from pydantic.v1.typing import display_as_type + +__all__ = ('parse_file_as', 'parse_obj_as', 'parse_raw_as', 'schema_of', 'schema_json_of') + +NameFactory = Union[str, Callable[[Type[Any]], str]] + +if TYPE_CHECKING: + from pydantic.v1.typing import DictStrAny + + +def _generate_parsing_type_name(type_: Any) -> str: + return f'ParsingModel[{display_as_type(type_)}]' + + +@lru_cache(maxsize=2048) +def _get_parsing_type(type_: Any, *, type_name: Optional[NameFactory] = None) -> Any: + from pydantic.v1.main import create_model + + if type_name is None: + type_name = _generate_parsing_type_name + if not isinstance(type_name, str): + type_name = type_name(type_) + return create_model(type_name, __root__=(type_, ...)) + + +T = TypeVar('T') + + +def parse_obj_as(type_: Type[T], obj: Any, *, type_name: Optional[NameFactory] = None) -> T: + model_type = _get_parsing_type(type_, type_name=type_name) # type: ignore[arg-type] + return model_type(__root__=obj).__root__ + + +def parse_file_as( + type_: Type[T], + path: Union[str, Path], + *, + content_type: str = None, + encoding: str = 'utf8', + proto: Protocol = None, + allow_pickle: bool = False, + json_loads: Callable[[str], Any] = json.loads, + type_name: Optional[NameFactory] = None, +) -> T: + obj = load_file( + path, + proto=proto, + content_type=content_type, + encoding=encoding, + allow_pickle=allow_pickle, + json_loads=json_loads, + ) + return parse_obj_as(type_, obj, type_name=type_name) + + +def parse_raw_as( + type_: Type[T], + b: StrBytes, + *, + content_type: str = None, + encoding: str = 'utf8', + proto: Protocol = None, + allow_pickle: bool = False, + json_loads: Callable[[str], Any] = json.loads, + type_name: Optional[NameFactory] = None, +) -> T: + obj = load_str_bytes( + b, + proto=proto, + content_type=content_type, + encoding=encoding, + allow_pickle=allow_pickle, + json_loads=json_loads, + ) + return parse_obj_as(type_, obj, type_name=type_name) + + +def schema_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_kwargs: Any) -> 'DictStrAny': + """Generate a JSON schema (as dict) for the passed model or dynamically generated one""" + return _get_parsing_type(type_, type_name=title).schema(**schema_kwargs) + + +def schema_json_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_json_kwargs: Any) -> str: + """Generate a JSON schema (as JSON) for the passed model or dynamically generated one""" + return _get_parsing_type(type_, type_name=title).schema_json(**schema_json_kwargs) diff --git a/env/Lib/site-packages/pydantic/v1/types.py b/env/Lib/site-packages/pydantic/v1/types.py new file mode 100644 index 0000000..0cd789a --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/types.py @@ -0,0 +1,1205 @@ +import abc +import math +import re +import warnings +from datetime import date +from decimal import Decimal, InvalidOperation +from enum import Enum +from pathlib import Path +from types import new_class +from typing import ( + TYPE_CHECKING, + Any, + Callable, + ClassVar, + Dict, + FrozenSet, + List, + Optional, + Pattern, + Set, + Tuple, + Type, + TypeVar, + Union, + cast, + overload, +) +from uuid import UUID +from weakref import WeakSet + +from pydantic.v1 import errors +from pydantic.v1.datetime_parse import parse_date +from pydantic.v1.utils import import_string, update_not_none +from pydantic.v1.validators import ( + bytes_validator, + constr_length_validator, + constr_lower, + constr_strip_whitespace, + constr_upper, + decimal_validator, + float_finite_validator, + float_validator, + frozenset_validator, + int_validator, + list_validator, + number_multiple_validator, + number_size_validator, + path_exists_validator, + path_validator, + set_validator, + str_validator, + strict_bytes_validator, + strict_float_validator, + strict_int_validator, + strict_str_validator, +) + +__all__ = [ + 'NoneStr', + 'NoneBytes', + 'StrBytes', + 'NoneStrBytes', + 'StrictStr', + 'ConstrainedBytes', + 'conbytes', + 'ConstrainedList', + 'conlist', + 'ConstrainedSet', + 'conset', + 'ConstrainedFrozenSet', + 'confrozenset', + 'ConstrainedStr', + 'constr', + 'PyObject', + 'ConstrainedInt', + 'conint', + 'PositiveInt', + 'NegativeInt', + 'NonNegativeInt', + 'NonPositiveInt', + 'ConstrainedFloat', + 'confloat', + 'PositiveFloat', + 'NegativeFloat', + 'NonNegativeFloat', + 'NonPositiveFloat', + 'FiniteFloat', + 'ConstrainedDecimal', + 'condecimal', + 'UUID1', + 'UUID3', + 'UUID4', + 'UUID5', + 'FilePath', + 'DirectoryPath', + 'Json', + 'JsonWrapper', + 'SecretField', + 'SecretStr', + 'SecretBytes', + 'StrictBool', + 'StrictBytes', + 'StrictInt', + 'StrictFloat', + 'PaymentCardNumber', + 'ByteSize', + 'PastDate', + 'FutureDate', + 'ConstrainedDate', + 'condate', +] + +NoneStr = Optional[str] +NoneBytes = Optional[bytes] +StrBytes = Union[str, bytes] +NoneStrBytes = Optional[StrBytes] +OptionalInt = Optional[int] +OptionalIntFloat = Union[OptionalInt, float] +OptionalIntFloatDecimal = Union[OptionalIntFloat, Decimal] +OptionalDate = Optional[date] +StrIntFloat = Union[str, int, float] + +if TYPE_CHECKING: + from typing_extensions import Annotated + + from pydantic.v1.dataclasses import Dataclass + from pydantic.v1.main import BaseModel + from pydantic.v1.typing import CallableGenerator + + ModelOrDc = Type[Union[BaseModel, Dataclass]] + +T = TypeVar('T') +_DEFINED_TYPES: 'WeakSet[type]' = WeakSet() + + +@overload +def _registered(typ: Type[T]) -> Type[T]: + pass + + +@overload +def _registered(typ: 'ConstrainedNumberMeta') -> 'ConstrainedNumberMeta': + pass + + +def _registered(typ: Union[Type[T], 'ConstrainedNumberMeta']) -> Union[Type[T], 'ConstrainedNumberMeta']: + # In order to generate valid examples of constrained types, Hypothesis needs + # to inspect the type object - so we keep a weakref to each contype object + # until it can be registered. When (or if) our Hypothesis plugin is loaded, + # it monkeypatches this function. + # If Hypothesis is never used, the total effect is to keep a weak reference + # which has minimal memory usage and doesn't even affect garbage collection. + _DEFINED_TYPES.add(typ) + return typ + + +class ConstrainedNumberMeta(type): + def __new__(cls, name: str, bases: Any, dct: Dict[str, Any]) -> 'ConstrainedInt': # type: ignore + new_cls = cast('ConstrainedInt', type.__new__(cls, name, bases, dct)) + + if new_cls.gt is not None and new_cls.ge is not None: + raise errors.ConfigError('bounds gt and ge cannot be specified at the same time') + if new_cls.lt is not None and new_cls.le is not None: + raise errors.ConfigError('bounds lt and le cannot be specified at the same time') + + return _registered(new_cls) # type: ignore + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BOOLEAN TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +if TYPE_CHECKING: + StrictBool = bool +else: + + class StrictBool(int): + """ + StrictBool to allow for bools which are not type-coerced. + """ + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='boolean') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + + @classmethod + def validate(cls, value: Any) -> bool: + """ + Ensure that we only allow bools. + """ + if isinstance(value, bool): + return value + + raise errors.StrictBoolError() + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ INTEGER TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class ConstrainedInt(int, metaclass=ConstrainedNumberMeta): + strict: bool = False + gt: OptionalInt = None + ge: OptionalInt = None + lt: OptionalInt = None + le: OptionalInt = None + multiple_of: OptionalInt = None + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none( + field_schema, + exclusiveMinimum=cls.gt, + exclusiveMaximum=cls.lt, + minimum=cls.ge, + maximum=cls.le, + multipleOf=cls.multiple_of, + ) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield strict_int_validator if cls.strict else int_validator + yield number_size_validator + yield number_multiple_validator + + +def conint( + *, + strict: bool = False, + gt: Optional[int] = None, + ge: Optional[int] = None, + lt: Optional[int] = None, + le: Optional[int] = None, + multiple_of: Optional[int] = None, +) -> Type[int]: + # use kwargs then define conf in a dict to aid with IDE type hinting + namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of) + return type('ConstrainedIntValue', (ConstrainedInt,), namespace) + + +if TYPE_CHECKING: + PositiveInt = int + NegativeInt = int + NonPositiveInt = int + NonNegativeInt = int + StrictInt = int +else: + + class PositiveInt(ConstrainedInt): + gt = 0 + + class NegativeInt(ConstrainedInt): + lt = 0 + + class NonPositiveInt(ConstrainedInt): + le = 0 + + class NonNegativeInt(ConstrainedInt): + ge = 0 + + class StrictInt(ConstrainedInt): + strict = True + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ FLOAT TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class ConstrainedFloat(float, metaclass=ConstrainedNumberMeta): + strict: bool = False + gt: OptionalIntFloat = None + ge: OptionalIntFloat = None + lt: OptionalIntFloat = None + le: OptionalIntFloat = None + multiple_of: OptionalIntFloat = None + allow_inf_nan: Optional[bool] = None + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none( + field_schema, + exclusiveMinimum=cls.gt, + exclusiveMaximum=cls.lt, + minimum=cls.ge, + maximum=cls.le, + multipleOf=cls.multiple_of, + ) + # Modify constraints to account for differences between IEEE floats and JSON + if field_schema.get('exclusiveMinimum') == -math.inf: + del field_schema['exclusiveMinimum'] + if field_schema.get('minimum') == -math.inf: + del field_schema['minimum'] + if field_schema.get('exclusiveMaximum') == math.inf: + del field_schema['exclusiveMaximum'] + if field_schema.get('maximum') == math.inf: + del field_schema['maximum'] + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield strict_float_validator if cls.strict else float_validator + yield number_size_validator + yield number_multiple_validator + yield float_finite_validator + + +def confloat( + *, + strict: bool = False, + gt: float = None, + ge: float = None, + lt: float = None, + le: float = None, + multiple_of: float = None, + allow_inf_nan: Optional[bool] = None, +) -> Type[float]: + # use kwargs then define conf in a dict to aid with IDE type hinting + namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of, allow_inf_nan=allow_inf_nan) + return type('ConstrainedFloatValue', (ConstrainedFloat,), namespace) + + +if TYPE_CHECKING: + PositiveFloat = float + NegativeFloat = float + NonPositiveFloat = float + NonNegativeFloat = float + StrictFloat = float + FiniteFloat = float +else: + + class PositiveFloat(ConstrainedFloat): + gt = 0 + + class NegativeFloat(ConstrainedFloat): + lt = 0 + + class NonPositiveFloat(ConstrainedFloat): + le = 0 + + class NonNegativeFloat(ConstrainedFloat): + ge = 0 + + class StrictFloat(ConstrainedFloat): + strict = True + + class FiniteFloat(ConstrainedFloat): + allow_inf_nan = False + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTES TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class ConstrainedBytes(bytes): + strip_whitespace = False + to_upper = False + to_lower = False + min_length: OptionalInt = None + max_length: OptionalInt = None + strict: bool = False + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield strict_bytes_validator if cls.strict else bytes_validator + yield constr_strip_whitespace + yield constr_upper + yield constr_lower + yield constr_length_validator + + +def conbytes( + *, + strip_whitespace: bool = False, + to_upper: bool = False, + to_lower: bool = False, + min_length: Optional[int] = None, + max_length: Optional[int] = None, + strict: bool = False, +) -> Type[bytes]: + # use kwargs then define conf in a dict to aid with IDE type hinting + namespace = dict( + strip_whitespace=strip_whitespace, + to_upper=to_upper, + to_lower=to_lower, + min_length=min_length, + max_length=max_length, + strict=strict, + ) + return _registered(type('ConstrainedBytesValue', (ConstrainedBytes,), namespace)) + + +if TYPE_CHECKING: + StrictBytes = bytes +else: + + class StrictBytes(ConstrainedBytes): + strict = True + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ STRING TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class ConstrainedStr(str): + strip_whitespace = False + to_upper = False + to_lower = False + min_length: OptionalInt = None + max_length: OptionalInt = None + curtail_length: OptionalInt = None + regex: Optional[Union[str, Pattern[str]]] = None + strict = False + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none( + field_schema, + minLength=cls.min_length, + maxLength=cls.max_length, + pattern=cls.regex and cls._get_pattern(cls.regex), + ) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield strict_str_validator if cls.strict else str_validator + yield constr_strip_whitespace + yield constr_upper + yield constr_lower + yield constr_length_validator + yield cls.validate + + @classmethod + def validate(cls, value: Union[str]) -> Union[str]: + if cls.curtail_length and len(value) > cls.curtail_length: + value = value[: cls.curtail_length] + + if cls.regex: + if not re.match(cls.regex, value): + raise errors.StrRegexError(pattern=cls._get_pattern(cls.regex)) + + return value + + @staticmethod + def _get_pattern(regex: Union[str, Pattern[str]]) -> str: + return regex if isinstance(regex, str) else regex.pattern + + +def constr( + *, + strip_whitespace: bool = False, + to_upper: bool = False, + to_lower: bool = False, + strict: bool = False, + min_length: Optional[int] = None, + max_length: Optional[int] = None, + curtail_length: Optional[int] = None, + regex: Optional[str] = None, +) -> Type[str]: + # use kwargs then define conf in a dict to aid with IDE type hinting + namespace = dict( + strip_whitespace=strip_whitespace, + to_upper=to_upper, + to_lower=to_lower, + strict=strict, + min_length=min_length, + max_length=max_length, + curtail_length=curtail_length, + regex=regex and re.compile(regex), + ) + return _registered(type('ConstrainedStrValue', (ConstrainedStr,), namespace)) + + +if TYPE_CHECKING: + StrictStr = str +else: + + class StrictStr(ConstrainedStr): + strict = True + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +# This types superclass should be Set[T], but cython chokes on that... +class ConstrainedSet(set): # type: ignore + # Needed for pydantic to detect that this is a set + __origin__ = set + __args__: Set[Type[T]] # type: ignore + + min_items: Optional[int] = None + max_items: Optional[int] = None + item_type: Type[T] # type: ignore + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.set_length_validator + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items) + + @classmethod + def set_length_validator(cls, v: 'Optional[Set[T]]') -> 'Optional[Set[T]]': + if v is None: + return None + + v = set_validator(v) + v_len = len(v) + + if cls.min_items is not None and v_len < cls.min_items: + raise errors.SetMinLengthError(limit_value=cls.min_items) + + if cls.max_items is not None and v_len > cls.max_items: + raise errors.SetMaxLengthError(limit_value=cls.max_items) + + return v + + +def conset(item_type: Type[T], *, min_items: Optional[int] = None, max_items: Optional[int] = None) -> Type[Set[T]]: + # __args__ is needed to conform to typing generics api + namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]} + # We use new_class to be able to deal with Generic types + return new_class('ConstrainedSetValue', (ConstrainedSet,), {}, lambda ns: ns.update(namespace)) + + +# This types superclass should be FrozenSet[T], but cython chokes on that... +class ConstrainedFrozenSet(frozenset): # type: ignore + # Needed for pydantic to detect that this is a set + __origin__ = frozenset + __args__: FrozenSet[Type[T]] # type: ignore + + min_items: Optional[int] = None + max_items: Optional[int] = None + item_type: Type[T] # type: ignore + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.frozenset_length_validator + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items) + + @classmethod + def frozenset_length_validator(cls, v: 'Optional[FrozenSet[T]]') -> 'Optional[FrozenSet[T]]': + if v is None: + return None + + v = frozenset_validator(v) + v_len = len(v) + + if cls.min_items is not None and v_len < cls.min_items: + raise errors.FrozenSetMinLengthError(limit_value=cls.min_items) + + if cls.max_items is not None and v_len > cls.max_items: + raise errors.FrozenSetMaxLengthError(limit_value=cls.max_items) + + return v + + +def confrozenset( + item_type: Type[T], *, min_items: Optional[int] = None, max_items: Optional[int] = None +) -> Type[FrozenSet[T]]: + # __args__ is needed to conform to typing generics api + namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]} + # We use new_class to be able to deal with Generic types + return new_class('ConstrainedFrozenSetValue', (ConstrainedFrozenSet,), {}, lambda ns: ns.update(namespace)) + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ LIST TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +# This types superclass should be List[T], but cython chokes on that... +class ConstrainedList(list): # type: ignore + # Needed for pydantic to detect that this is a list + __origin__ = list + __args__: Tuple[Type[T], ...] # type: ignore + + min_items: Optional[int] = None + max_items: Optional[int] = None + unique_items: Optional[bool] = None + item_type: Type[T] # type: ignore + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.list_length_validator + if cls.unique_items: + yield cls.unique_items_validator + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items, uniqueItems=cls.unique_items) + + @classmethod + def list_length_validator(cls, v: 'Optional[List[T]]') -> 'Optional[List[T]]': + if v is None: + return None + + v = list_validator(v) + v_len = len(v) + + if cls.min_items is not None and v_len < cls.min_items: + raise errors.ListMinLengthError(limit_value=cls.min_items) + + if cls.max_items is not None and v_len > cls.max_items: + raise errors.ListMaxLengthError(limit_value=cls.max_items) + + return v + + @classmethod + def unique_items_validator(cls, v: 'Optional[List[T]]') -> 'Optional[List[T]]': + if v is None: + return None + + for i, value in enumerate(v, start=1): + if value in v[i:]: + raise errors.ListUniqueItemsError() + + return v + + +def conlist( + item_type: Type[T], *, min_items: Optional[int] = None, max_items: Optional[int] = None, unique_items: bool = None +) -> Type[List[T]]: + # __args__ is needed to conform to typing generics api + namespace = dict( + min_items=min_items, max_items=max_items, unique_items=unique_items, item_type=item_type, __args__=(item_type,) + ) + # We use new_class to be able to deal with Generic types + return new_class('ConstrainedListValue', (ConstrainedList,), {}, lambda ns: ns.update(namespace)) + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PYOBJECT TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +if TYPE_CHECKING: + PyObject = Callable[..., Any] +else: + + class PyObject: + validate_always = True + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + + @classmethod + def validate(cls, value: Any) -> Any: + if isinstance(value, Callable): + return value + + try: + value = str_validator(value) + except errors.StrError: + raise errors.PyObjectError(error_message='value is neither a valid import path not a valid callable') + + try: + return import_string(value) + except ImportError as e: + raise errors.PyObjectError(error_message=str(e)) + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DECIMAL TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class ConstrainedDecimal(Decimal, metaclass=ConstrainedNumberMeta): + gt: OptionalIntFloatDecimal = None + ge: OptionalIntFloatDecimal = None + lt: OptionalIntFloatDecimal = None + le: OptionalIntFloatDecimal = None + max_digits: OptionalInt = None + decimal_places: OptionalInt = None + multiple_of: OptionalIntFloatDecimal = None + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none( + field_schema, + exclusiveMinimum=cls.gt, + exclusiveMaximum=cls.lt, + minimum=cls.ge, + maximum=cls.le, + multipleOf=cls.multiple_of, + ) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield decimal_validator + yield number_size_validator + yield number_multiple_validator + yield cls.validate + + @classmethod + def validate(cls, value: Decimal) -> Decimal: + try: + normalized_value = value.normalize() + except InvalidOperation: + normalized_value = value + digit_tuple, exponent = normalized_value.as_tuple()[1:] + if exponent in {'F', 'n', 'N'}: + raise errors.DecimalIsNotFiniteError() + + if exponent >= 0: + # A positive exponent adds that many trailing zeros. + digits = len(digit_tuple) + exponent + decimals = 0 + else: + # If the absolute value of the negative exponent is larger than the + # number of digits, then it's the same as the number of digits, + # because it'll consume all of the digits in digit_tuple and then + # add abs(exponent) - len(digit_tuple) leading zeros after the + # decimal point. + if abs(exponent) > len(digit_tuple): + digits = decimals = abs(exponent) + else: + digits = len(digit_tuple) + decimals = abs(exponent) + whole_digits = digits - decimals + + if cls.max_digits is not None and digits > cls.max_digits: + raise errors.DecimalMaxDigitsError(max_digits=cls.max_digits) + + if cls.decimal_places is not None and decimals > cls.decimal_places: + raise errors.DecimalMaxPlacesError(decimal_places=cls.decimal_places) + + if cls.max_digits is not None and cls.decimal_places is not None: + expected = cls.max_digits - cls.decimal_places + if whole_digits > expected: + raise errors.DecimalWholeDigitsError(whole_digits=expected) + + return value + + +def condecimal( + *, + gt: Decimal = None, + ge: Decimal = None, + lt: Decimal = None, + le: Decimal = None, + max_digits: Optional[int] = None, + decimal_places: Optional[int] = None, + multiple_of: Decimal = None, +) -> Type[Decimal]: + # use kwargs then define conf in a dict to aid with IDE type hinting + namespace = dict( + gt=gt, ge=ge, lt=lt, le=le, max_digits=max_digits, decimal_places=decimal_places, multiple_of=multiple_of + ) + return type('ConstrainedDecimalValue', (ConstrainedDecimal,), namespace) + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ UUID TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +if TYPE_CHECKING: + UUID1 = UUID + UUID3 = UUID + UUID4 = UUID + UUID5 = UUID +else: + + class UUID1(UUID): + _required_version = 1 + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='string', format=f'uuid{cls._required_version}') + + class UUID3(UUID1): + _required_version = 3 + + class UUID4(UUID1): + _required_version = 4 + + class UUID5(UUID1): + _required_version = 5 + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PATH TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +if TYPE_CHECKING: + FilePath = Path + DirectoryPath = Path +else: + + class FilePath(Path): + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(format='file-path') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield path_validator + yield path_exists_validator + yield cls.validate + + @classmethod + def validate(cls, value: Path) -> Path: + if not value.is_file(): + raise errors.PathNotAFileError(path=value) + + return value + + class DirectoryPath(Path): + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(format='directory-path') + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield path_validator + yield path_exists_validator + yield cls.validate + + @classmethod + def validate(cls, value: Path) -> Path: + if not value.is_dir(): + raise errors.PathNotADirectoryError(path=value) + + return value + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ JSON TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class JsonWrapper: + pass + + +class JsonMeta(type): + def __getitem__(self, t: Type[Any]) -> Type[JsonWrapper]: + if t is Any: + return Json # allow Json[Any] to replecate plain Json + return _registered(type('JsonWrapperValue', (JsonWrapper,), {'inner_type': t})) + + +if TYPE_CHECKING: + Json = Annotated[T, ...] # Json[list[str]] will be recognized by type checkers as list[str] + +else: + + class Json(metaclass=JsonMeta): + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update(type='string', format='json-string') + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SECRET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class SecretField(abc.ABC): + """ + Note: this should be implemented as a generic like `SecretField(ABC, Generic[T])`, + the `__init__()` should be part of the abstract class and the + `get_secret_value()` method should use the generic `T` type. + + However Cython doesn't support very well generics at the moment and + the generated code fails to be imported (see + https://github.com/cython/cython/issues/2753). + """ + + def __eq__(self, other: Any) -> bool: + return isinstance(other, self.__class__) and self.get_secret_value() == other.get_secret_value() + + def __str__(self) -> str: + return '**********' if self.get_secret_value() else '' + + def __hash__(self) -> int: + return hash(self.get_secret_value()) + + @abc.abstractmethod + def get_secret_value(self) -> Any: # pragma: no cover + ... + + +class SecretStr(SecretField): + min_length: OptionalInt = None + max_length: OptionalInt = None + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none( + field_schema, + type='string', + writeOnly=True, + format='password', + minLength=cls.min_length, + maxLength=cls.max_length, + ) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + yield constr_length_validator + + @classmethod + def validate(cls, value: Any) -> 'SecretStr': + if isinstance(value, cls): + return value + value = str_validator(value) + return cls(value) + + def __init__(self, value: str): + self._secret_value = value + + def __repr__(self) -> str: + return f"SecretStr('{self}')" + + def __len__(self) -> int: + return len(self._secret_value) + + def display(self) -> str: + warnings.warn('`secret_str.display()` is deprecated, use `str(secret_str)` instead', DeprecationWarning) + return str(self) + + def get_secret_value(self) -> str: + return self._secret_value + + +class SecretBytes(SecretField): + min_length: OptionalInt = None + max_length: OptionalInt = None + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none( + field_schema, + type='string', + writeOnly=True, + format='password', + minLength=cls.min_length, + maxLength=cls.max_length, + ) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + yield constr_length_validator + + @classmethod + def validate(cls, value: Any) -> 'SecretBytes': + if isinstance(value, cls): + return value + value = bytes_validator(value) + return cls(value) + + def __init__(self, value: bytes): + self._secret_value = value + + def __repr__(self) -> str: + return f"SecretBytes(b'{self}')" + + def __len__(self) -> int: + return len(self._secret_value) + + def display(self) -> str: + warnings.warn('`secret_bytes.display()` is deprecated, use `str(secret_bytes)` instead', DeprecationWarning) + return str(self) + + def get_secret_value(self) -> bytes: + return self._secret_value + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PAYMENT CARD TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +class PaymentCardBrand(str, Enum): + # If you add another card type, please also add it to the + # Hypothesis strategy in `pydantic._hypothesis_plugin`. + amex = 'American Express' + mastercard = 'Mastercard' + visa = 'Visa' + other = 'other' + + def __str__(self) -> str: + return self.value + + +class PaymentCardNumber(str): + """ + Based on: https://en.wikipedia.org/wiki/Payment_card_number + """ + + strip_whitespace: ClassVar[bool] = True + min_length: ClassVar[int] = 12 + max_length: ClassVar[int] = 19 + bin: str + last4: str + brand: PaymentCardBrand + + def __init__(self, card_number: str): + self.bin = card_number[:6] + self.last4 = card_number[-4:] + self.brand = self._get_brand(card_number) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield str_validator + yield constr_strip_whitespace + yield constr_length_validator + yield cls.validate_digits + yield cls.validate_luhn_check_digit + yield cls + yield cls.validate_length_for_brand + + @property + def masked(self) -> str: + num_masked = len(self) - 10 # len(bin) + len(last4) == 10 + return f'{self.bin}{"*" * num_masked}{self.last4}' + + @classmethod + def validate_digits(cls, card_number: str) -> str: + if not card_number.isdigit(): + raise errors.NotDigitError + return card_number + + @classmethod + def validate_luhn_check_digit(cls, card_number: str) -> str: + """ + Based on: https://en.wikipedia.org/wiki/Luhn_algorithm + """ + sum_ = int(card_number[-1]) + length = len(card_number) + parity = length % 2 + for i in range(length - 1): + digit = int(card_number[i]) + if i % 2 == parity: + digit *= 2 + if digit > 9: + digit -= 9 + sum_ += digit + valid = sum_ % 10 == 0 + if not valid: + raise errors.LuhnValidationError + return card_number + + @classmethod + def validate_length_for_brand(cls, card_number: 'PaymentCardNumber') -> 'PaymentCardNumber': + """ + Validate length based on BIN for major brands: + https://en.wikipedia.org/wiki/Payment_card_number#Issuer_identification_number_(IIN) + """ + required_length: Union[None, int, str] = None + if card_number.brand in PaymentCardBrand.mastercard: + required_length = 16 + valid = len(card_number) == required_length + elif card_number.brand == PaymentCardBrand.visa: + required_length = '13, 16 or 19' + valid = len(card_number) in {13, 16, 19} + elif card_number.brand == PaymentCardBrand.amex: + required_length = 15 + valid = len(card_number) == required_length + else: + valid = True + if not valid: + raise errors.InvalidLengthForBrand(brand=card_number.brand, required_length=required_length) + return card_number + + @staticmethod + def _get_brand(card_number: str) -> PaymentCardBrand: + if card_number[0] == '4': + brand = PaymentCardBrand.visa + elif 51 <= int(card_number[:2]) <= 55: + brand = PaymentCardBrand.mastercard + elif card_number[:2] in {'34', '37'}: + brand = PaymentCardBrand.amex + else: + brand = PaymentCardBrand.other + return brand + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTE SIZE TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +BYTE_SIZES = { + 'b': 1, + 'kb': 10**3, + 'mb': 10**6, + 'gb': 10**9, + 'tb': 10**12, + 'pb': 10**15, + 'eb': 10**18, + 'kib': 2**10, + 'mib': 2**20, + 'gib': 2**30, + 'tib': 2**40, + 'pib': 2**50, + 'eib': 2**60, +} +BYTE_SIZES.update({k.lower()[0]: v for k, v in BYTE_SIZES.items() if 'i' not in k}) +byte_string_re = re.compile(r'^\s*(\d*\.?\d+)\s*(\w+)?', re.IGNORECASE) + + +class ByteSize(int): + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield cls.validate + + @classmethod + def validate(cls, v: StrIntFloat) -> 'ByteSize': + try: + return cls(int(v)) + except ValueError: + pass + + str_match = byte_string_re.match(str(v)) + if str_match is None: + raise errors.InvalidByteSize() + + scalar, unit = str_match.groups() + if unit is None: + unit = 'b' + + try: + unit_mult = BYTE_SIZES[unit.lower()] + except KeyError: + raise errors.InvalidByteSizeUnit(unit=unit) + + return cls(int(float(scalar) * unit_mult)) + + def human_readable(self, decimal: bool = False) -> str: + if decimal: + divisor = 1000 + units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'] + final_unit = 'EB' + else: + divisor = 1024 + units = ['B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB'] + final_unit = 'EiB' + + num = float(self) + for unit in units: + if abs(num) < divisor: + return f'{num:0.1f}{unit}' + num /= divisor + + return f'{num:0.1f}{final_unit}' + + def to(self, unit: str) -> float: + try: + unit_div = BYTE_SIZES[unit.lower()] + except KeyError: + raise errors.InvalidByteSizeUnit(unit=unit) + + return self / unit_div + + +# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DATE TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +if TYPE_CHECKING: + PastDate = date + FutureDate = date +else: + + class PastDate(date): + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield parse_date + yield cls.validate + + @classmethod + def validate(cls, value: date) -> date: + if value >= date.today(): + raise errors.DateNotInThePastError() + + return value + + class FutureDate(date): + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield parse_date + yield cls.validate + + @classmethod + def validate(cls, value: date) -> date: + if value <= date.today(): + raise errors.DateNotInTheFutureError() + + return value + + +class ConstrainedDate(date, metaclass=ConstrainedNumberMeta): + gt: OptionalDate = None + ge: OptionalDate = None + lt: OptionalDate = None + le: OptionalDate = None + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + update_not_none(field_schema, exclusiveMinimum=cls.gt, exclusiveMaximum=cls.lt, minimum=cls.ge, maximum=cls.le) + + @classmethod + def __get_validators__(cls) -> 'CallableGenerator': + yield parse_date + yield number_size_validator + + +def condate( + *, + gt: date = None, + ge: date = None, + lt: date = None, + le: date = None, +) -> Type[date]: + # use kwargs then define conf in a dict to aid with IDE type hinting + namespace = dict(gt=gt, ge=ge, lt=lt, le=le) + return type('ConstrainedDateValue', (ConstrainedDate,), namespace) diff --git a/env/Lib/site-packages/pydantic/v1/typing.py b/env/Lib/site-packages/pydantic/v1/typing.py new file mode 100644 index 0000000..7dd341c --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/typing.py @@ -0,0 +1,608 @@ +import sys +import typing +from collections.abc import Callable +from os import PathLike +from typing import ( # type: ignore + TYPE_CHECKING, + AbstractSet, + Any, + Callable as TypingCallable, + ClassVar, + Dict, + ForwardRef, + Generator, + Iterable, + List, + Mapping, + NewType, + Optional, + Sequence, + Set, + Tuple, + Type, + TypeVar, + Union, + _eval_type, + cast, + get_type_hints, +) + +from typing_extensions import ( + Annotated, + Final, + Literal, + NotRequired as TypedDictNotRequired, + Required as TypedDictRequired, +) + +try: + from typing import _TypingBase as typing_base # type: ignore +except ImportError: + from typing import _Final as typing_base # type: ignore + +try: + from typing import GenericAlias as TypingGenericAlias # type: ignore +except ImportError: + # python < 3.9 does not have GenericAlias (list[int], tuple[str, ...] and so on) + TypingGenericAlias = () + +try: + from types import UnionType as TypesUnionType # type: ignore +except ImportError: + # python < 3.10 does not have UnionType (str | int, byte | bool and so on) + TypesUnionType = () + + +if sys.version_info < (3, 9): + + def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any: + return type_._evaluate(globalns, localns) + +else: + + def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any: + # Even though it is the right signature for python 3.9, mypy complains with + # `error: Too many arguments for "_evaluate" of "ForwardRef"` hence the cast... + # Python 3.13/3.12.4+ made `recursive_guard` a kwarg, so name it explicitly to avoid: + # TypeError: ForwardRef._evaluate() missing 1 required keyword-only argument: 'recursive_guard' + return cast(Any, type_)._evaluate(globalns, localns, recursive_guard=set()) + + +if sys.version_info < (3, 9): + # Ensure we always get all the whole `Annotated` hint, not just the annotated type. + # For 3.7 to 3.8, `get_type_hints` doesn't recognize `typing_extensions.Annotated`, + # so it already returns the full annotation + get_all_type_hints = get_type_hints + +else: + + def get_all_type_hints(obj: Any, globalns: Any = None, localns: Any = None) -> Any: + return get_type_hints(obj, globalns, localns, include_extras=True) + + +_T = TypeVar('_T') + +AnyCallable = TypingCallable[..., Any] +NoArgAnyCallable = TypingCallable[[], Any] + +# workaround for https://github.com/python/mypy/issues/9496 +AnyArgTCallable = TypingCallable[..., _T] + + +# Annotated[...] is implemented by returning an instance of one of these classes, depending on +# python/typing_extensions version. +AnnotatedTypeNames = {'AnnotatedMeta', '_AnnotatedAlias'} + + +LITERAL_TYPES: Set[Any] = {Literal} +if hasattr(typing, 'Literal'): + LITERAL_TYPES.add(typing.Literal) + + +if sys.version_info < (3, 8): + + def get_origin(t: Type[Any]) -> Optional[Type[Any]]: + if type(t).__name__ in AnnotatedTypeNames: + # weirdly this is a runtime requirement, as well as for mypy + return cast(Type[Any], Annotated) + return getattr(t, '__origin__', None) + +else: + from typing import get_origin as _typing_get_origin + + def get_origin(tp: Type[Any]) -> Optional[Type[Any]]: + """ + We can't directly use `typing.get_origin` since we need a fallback to support + custom generic classes like `ConstrainedList` + It should be useless once https://github.com/cython/cython/issues/3537 is + solved and https://github.com/pydantic/pydantic/pull/1753 is merged. + """ + if type(tp).__name__ in AnnotatedTypeNames: + return cast(Type[Any], Annotated) # mypy complains about _SpecialForm + return _typing_get_origin(tp) or getattr(tp, '__origin__', None) + + +if sys.version_info < (3, 8): + from typing import _GenericAlias + + def get_args(t: Type[Any]) -> Tuple[Any, ...]: + """Compatibility version of get_args for python 3.7. + + Mostly compatible with the python 3.8 `typing` module version + and able to handle almost all use cases. + """ + if type(t).__name__ in AnnotatedTypeNames: + return t.__args__ + t.__metadata__ + if isinstance(t, _GenericAlias): + res = t.__args__ + if t.__origin__ is Callable and res and res[0] is not Ellipsis: + res = (list(res[:-1]), res[-1]) + return res + return getattr(t, '__args__', ()) + +else: + from typing import get_args as _typing_get_args + + def _generic_get_args(tp: Type[Any]) -> Tuple[Any, ...]: + """ + In python 3.9, `typing.Dict`, `typing.List`, ... + do have an empty `__args__` by default (instead of the generic ~T for example). + In order to still support `Dict` for example and consider it as `Dict[Any, Any]`, + we retrieve the `_nparams` value that tells us how many parameters it needs. + """ + if hasattr(tp, '_nparams'): + return (Any,) * tp._nparams + # Special case for `tuple[()]`, which used to return ((),) with `typing.Tuple` + # in python 3.10- but now returns () for `tuple` and `Tuple`. + # This will probably be clarified in pydantic v2 + try: + if tp == Tuple[()] or sys.version_info >= (3, 9) and tp == tuple[()]: # type: ignore[misc] + return ((),) + # there is a TypeError when compiled with cython + except TypeError: # pragma: no cover + pass + return () + + def get_args(tp: Type[Any]) -> Tuple[Any, ...]: + """Get type arguments with all substitutions performed. + + For unions, basic simplifications used by Union constructor are performed. + Examples:: + get_args(Dict[str, int]) == (str, int) + get_args(int) == () + get_args(Union[int, Union[T, int], str][int]) == (int, str) + get_args(Union[int, Tuple[T, int]][str]) == (int, Tuple[str, int]) + get_args(Callable[[], T][int]) == ([], int) + """ + if type(tp).__name__ in AnnotatedTypeNames: + return tp.__args__ + tp.__metadata__ + # the fallback is needed for the same reasons as `get_origin` (see above) + return _typing_get_args(tp) or getattr(tp, '__args__', ()) or _generic_get_args(tp) + + +if sys.version_info < (3, 9): + + def convert_generics(tp: Type[Any]) -> Type[Any]: + """Python 3.9 and older only supports generics from `typing` module. + They convert strings to ForwardRef automatically. + + Examples:: + typing.List['Hero'] == typing.List[ForwardRef('Hero')] + """ + return tp + +else: + from typing import _UnionGenericAlias # type: ignore + + from typing_extensions import _AnnotatedAlias + + def convert_generics(tp: Type[Any]) -> Type[Any]: + """ + Recursively searches for `str` type hints and replaces them with ForwardRef. + + Examples:: + convert_generics(list['Hero']) == list[ForwardRef('Hero')] + convert_generics(dict['Hero', 'Team']) == dict[ForwardRef('Hero'), ForwardRef('Team')] + convert_generics(typing.Dict['Hero', 'Team']) == typing.Dict[ForwardRef('Hero'), ForwardRef('Team')] + convert_generics(list[str | 'Hero'] | int) == list[str | ForwardRef('Hero')] | int + """ + origin = get_origin(tp) + if not origin or not hasattr(tp, '__args__'): + return tp + + args = get_args(tp) + + # typing.Annotated needs special treatment + if origin is Annotated: + return _AnnotatedAlias(convert_generics(args[0]), args[1:]) + + # recursively replace `str` instances inside of `GenericAlias` with `ForwardRef(arg)` + converted = tuple( + ForwardRef(arg) if isinstance(arg, str) and isinstance(tp, TypingGenericAlias) else convert_generics(arg) + for arg in args + ) + + if converted == args: + return tp + elif isinstance(tp, TypingGenericAlias): + return TypingGenericAlias(origin, converted) + elif isinstance(tp, TypesUnionType): + # recreate types.UnionType (PEP604, Python >= 3.10) + return _UnionGenericAlias(origin, converted) + else: + try: + setattr(tp, '__args__', converted) + except AttributeError: + pass + return tp + + +if sys.version_info < (3, 10): + + def is_union(tp: Optional[Type[Any]]) -> bool: + return tp is Union + + WithArgsTypes = (TypingGenericAlias,) + +else: + import types + import typing + + def is_union(tp: Optional[Type[Any]]) -> bool: + return tp is Union or tp is types.UnionType # noqa: E721 + + WithArgsTypes = (typing._GenericAlias, types.GenericAlias, types.UnionType) + + +StrPath = Union[str, PathLike] + + +if TYPE_CHECKING: + from pydantic.v1.fields import ModelField + + TupleGenerator = Generator[Tuple[str, Any], None, None] + DictStrAny = Dict[str, Any] + DictAny = Dict[Any, Any] + SetStr = Set[str] + ListStr = List[str] + IntStr = Union[int, str] + AbstractSetIntStr = AbstractSet[IntStr] + DictIntStrAny = Dict[IntStr, Any] + MappingIntStrAny = Mapping[IntStr, Any] + CallableGenerator = Generator[AnyCallable, None, None] + ReprArgs = Sequence[Tuple[Optional[str], Any]] + + MYPY = False + if MYPY: + AnyClassMethod = classmethod[Any] + else: + # classmethod[TargetType, CallableParamSpecType, CallableReturnType] + AnyClassMethod = classmethod[Any, Any, Any] + +__all__ = ( + 'AnyCallable', + 'NoArgAnyCallable', + 'NoneType', + 'is_none_type', + 'display_as_type', + 'resolve_annotations', + 'is_callable_type', + 'is_literal_type', + 'all_literal_values', + 'is_namedtuple', + 'is_typeddict', + 'is_typeddict_special', + 'is_new_type', + 'new_type_supertype', + 'is_classvar', + 'is_finalvar', + 'update_field_forward_refs', + 'update_model_forward_refs', + 'TupleGenerator', + 'DictStrAny', + 'DictAny', + 'SetStr', + 'ListStr', + 'IntStr', + 'AbstractSetIntStr', + 'DictIntStrAny', + 'CallableGenerator', + 'ReprArgs', + 'AnyClassMethod', + 'CallableGenerator', + 'WithArgsTypes', + 'get_args', + 'get_origin', + 'get_sub_types', + 'typing_base', + 'get_all_type_hints', + 'is_union', + 'StrPath', + 'MappingIntStrAny', +) + + +NoneType = None.__class__ + + +NONE_TYPES: Tuple[Any, Any, Any] = (None, NoneType, Literal[None]) + + +if sys.version_info < (3, 8): + # Even though this implementation is slower, we need it for python 3.7: + # In python 3.7 "Literal" is not a builtin type and uses a different + # mechanism. + # for this reason `Literal[None] is Literal[None]` evaluates to `False`, + # breaking the faster implementation used for the other python versions. + + def is_none_type(type_: Any) -> bool: + return type_ in NONE_TYPES + +elif sys.version_info[:2] == (3, 8): + + def is_none_type(type_: Any) -> bool: + for none_type in NONE_TYPES: + if type_ is none_type: + return True + # With python 3.8, specifically 3.8.10, Literal "is" check sare very flakey + # can change on very subtle changes like use of types in other modules, + # hopefully this check avoids that issue. + if is_literal_type(type_): # pragma: no cover + return all_literal_values(type_) == (None,) + return False + +else: + + def is_none_type(type_: Any) -> bool: + return type_ in NONE_TYPES + + +def display_as_type(v: Type[Any]) -> str: + if not isinstance(v, typing_base) and not isinstance(v, WithArgsTypes) and not isinstance(v, type): + v = v.__class__ + + if is_union(get_origin(v)): + return f'Union[{", ".join(map(display_as_type, get_args(v)))}]' + + if isinstance(v, WithArgsTypes): + # Generic alias are constructs like `list[int]` + return str(v).replace('typing.', '') + + try: + return v.__name__ + except AttributeError: + # happens with typing objects + return str(v).replace('typing.', '') + + +def resolve_annotations(raw_annotations: Dict[str, Type[Any]], module_name: Optional[str]) -> Dict[str, Type[Any]]: + """ + Partially taken from typing.get_type_hints. + + Resolve string or ForwardRef annotations into type objects if possible. + """ + base_globals: Optional[Dict[str, Any]] = None + if module_name: + try: + module = sys.modules[module_name] + except KeyError: + # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363 + pass + else: + base_globals = module.__dict__ + + annotations = {} + for name, value in raw_annotations.items(): + if isinstance(value, str): + if (3, 10) > sys.version_info >= (3, 9, 8) or sys.version_info >= (3, 10, 1): + value = ForwardRef(value, is_argument=False, is_class=True) + else: + value = ForwardRef(value, is_argument=False) + try: + if sys.version_info >= (3, 13): + value = _eval_type(value, base_globals, None, type_params=()) + else: + value = _eval_type(value, base_globals, None) + except NameError: + # this is ok, it can be fixed with update_forward_refs + pass + annotations[name] = value + return annotations + + +def is_callable_type(type_: Type[Any]) -> bool: + return type_ is Callable or get_origin(type_) is Callable + + +def is_literal_type(type_: Type[Any]) -> bool: + return Literal is not None and get_origin(type_) in LITERAL_TYPES + + +def literal_values(type_: Type[Any]) -> Tuple[Any, ...]: + return get_args(type_) + + +def all_literal_values(type_: Type[Any]) -> Tuple[Any, ...]: + """ + This method is used to retrieve all Literal values as + Literal can be used recursively (see https://www.python.org/dev/peps/pep-0586) + e.g. `Literal[Literal[Literal[1, 2, 3], "foo"], 5, None]` + """ + if not is_literal_type(type_): + return (type_,) + + values = literal_values(type_) + return tuple(x for value in values for x in all_literal_values(value)) + + +def is_namedtuple(type_: Type[Any]) -> bool: + """ + Check if a given class is a named tuple. + It can be either a `typing.NamedTuple` or `collections.namedtuple` + """ + from pydantic.v1.utils import lenient_issubclass + + return lenient_issubclass(type_, tuple) and hasattr(type_, '_fields') + + +def is_typeddict(type_: Type[Any]) -> bool: + """ + Check if a given class is a typed dict (from `typing` or `typing_extensions`) + In 3.10, there will be a public method (https://docs.python.org/3.10/library/typing.html#typing.is_typeddict) + """ + from pydantic.v1.utils import lenient_issubclass + + return lenient_issubclass(type_, dict) and hasattr(type_, '__total__') + + +def _check_typeddict_special(type_: Any) -> bool: + return type_ is TypedDictRequired or type_ is TypedDictNotRequired + + +def is_typeddict_special(type_: Any) -> bool: + """ + Check if type is a TypedDict special form (Required or NotRequired). + """ + return _check_typeddict_special(type_) or _check_typeddict_special(get_origin(type_)) + + +test_type = NewType('test_type', str) + + +def is_new_type(type_: Type[Any]) -> bool: + """ + Check whether type_ was created using typing.NewType + """ + return isinstance(type_, test_type.__class__) and hasattr(type_, '__supertype__') # type: ignore + + +def new_type_supertype(type_: Type[Any]) -> Type[Any]: + while hasattr(type_, '__supertype__'): + type_ = type_.__supertype__ + return type_ + + +def _check_classvar(v: Optional[Type[Any]]) -> bool: + if v is None: + return False + + return v.__class__ == ClassVar.__class__ and getattr(v, '_name', None) == 'ClassVar' + + +def _check_finalvar(v: Optional[Type[Any]]) -> bool: + """ + Check if a given type is a `typing.Final` type. + """ + if v is None: + return False + + return v.__class__ == Final.__class__ and (sys.version_info < (3, 8) or getattr(v, '_name', None) == 'Final') + + +def is_classvar(ann_type: Type[Any]) -> bool: + if _check_classvar(ann_type) or _check_classvar(get_origin(ann_type)): + return True + + # this is an ugly workaround for class vars that contain forward references and are therefore themselves + # forward references, see #3679 + if ann_type.__class__ == ForwardRef and ann_type.__forward_arg__.startswith('ClassVar['): + return True + + return False + + +def is_finalvar(ann_type: Type[Any]) -> bool: + return _check_finalvar(ann_type) or _check_finalvar(get_origin(ann_type)) + + +def update_field_forward_refs(field: 'ModelField', globalns: Any, localns: Any) -> None: + """ + Try to update ForwardRefs on fields based on this ModelField, globalns and localns. + """ + prepare = False + if field.type_.__class__ == ForwardRef: + prepare = True + field.type_ = evaluate_forwardref(field.type_, globalns, localns or None) + if field.outer_type_.__class__ == ForwardRef: + prepare = True + field.outer_type_ = evaluate_forwardref(field.outer_type_, globalns, localns or None) + if prepare: + field.prepare() + + if field.sub_fields: + for sub_f in field.sub_fields: + update_field_forward_refs(sub_f, globalns=globalns, localns=localns) + + if field.discriminator_key is not None: + field.prepare_discriminated_union_sub_fields() + + +def update_model_forward_refs( + model: Type[Any], + fields: Iterable['ModelField'], + json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable], + localns: 'DictStrAny', + exc_to_suppress: Tuple[Type[BaseException], ...] = (), +) -> None: + """ + Try to update model fields ForwardRefs based on model and localns. + """ + if model.__module__ in sys.modules: + globalns = sys.modules[model.__module__].__dict__.copy() + else: + globalns = {} + + globalns.setdefault(model.__name__, model) + + for f in fields: + try: + update_field_forward_refs(f, globalns=globalns, localns=localns) + except exc_to_suppress: + pass + + for key in set(json_encoders.keys()): + if isinstance(key, str): + fr: ForwardRef = ForwardRef(key) + elif isinstance(key, ForwardRef): + fr = key + else: + continue + + try: + new_key = evaluate_forwardref(fr, globalns, localns or None) + except exc_to_suppress: # pragma: no cover + continue + + json_encoders[new_key] = json_encoders.pop(key) + + +def get_class(type_: Type[Any]) -> Union[None, bool, Type[Any]]: + """ + Tries to get the class of a Type[T] annotation. Returns True if Type is used + without brackets. Otherwise returns None. + """ + if type_ is type: + return True + + if get_origin(type_) is None: + return None + + args = get_args(type_) + if not args or not isinstance(args[0], type): + return True + else: + return args[0] + + +def get_sub_types(tp: Any) -> List[Any]: + """ + Return all the types that are allowed by type `tp` + `tp` can be a `Union` of allowed types or an `Annotated` type + """ + origin = get_origin(tp) + if origin is Annotated: + return get_sub_types(get_args(tp)[0]) + elif is_union(origin): + return [x for t in get_args(tp) for x in get_sub_types(t)] + else: + return [tp] diff --git a/env/Lib/site-packages/pydantic/v1/utils.py b/env/Lib/site-packages/pydantic/v1/utils.py new file mode 100644 index 0000000..a09997b --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/utils.py @@ -0,0 +1,803 @@ +import keyword +import warnings +import weakref +from collections import OrderedDict, defaultdict, deque +from copy import deepcopy +from itertools import islice, zip_longest +from types import BuiltinFunctionType, CodeType, FunctionType, GeneratorType, LambdaType, ModuleType +from typing import ( + TYPE_CHECKING, + AbstractSet, + Any, + Callable, + Collection, + Dict, + Generator, + Iterable, + Iterator, + List, + Mapping, + NoReturn, + Optional, + Set, + Tuple, + Type, + TypeVar, + Union, +) + +from typing_extensions import Annotated + +from pydantic.v1.errors import ConfigError +from pydantic.v1.typing import ( + NoneType, + WithArgsTypes, + all_literal_values, + display_as_type, + get_args, + get_origin, + is_literal_type, + is_union, +) +from pydantic.v1.version import version_info + +if TYPE_CHECKING: + from inspect import Signature + from pathlib import Path + + from pydantic.v1.config import BaseConfig + from pydantic.v1.dataclasses import Dataclass + from pydantic.v1.fields import ModelField + from pydantic.v1.main import BaseModel + from pydantic.v1.typing import AbstractSetIntStr, DictIntStrAny, IntStr, MappingIntStrAny, ReprArgs + + RichReprResult = Iterable[Union[Any, Tuple[Any], Tuple[str, Any], Tuple[str, Any, Any]]] + +__all__ = ( + 'import_string', + 'sequence_like', + 'validate_field_name', + 'lenient_isinstance', + 'lenient_issubclass', + 'in_ipython', + 'is_valid_identifier', + 'deep_update', + 'update_not_none', + 'almost_equal_floats', + 'get_model', + 'to_camel', + 'is_valid_field', + 'smart_deepcopy', + 'PyObjectStr', + 'Representation', + 'GetterDict', + 'ValueItems', + 'version_info', # required here to match behaviour in v1.3 + 'ClassAttribute', + 'path_type', + 'ROOT_KEY', + 'get_unique_discriminator_alias', + 'get_discriminator_alias_and_values', + 'DUNDER_ATTRIBUTES', +) + +ROOT_KEY = '__root__' +# these are types that are returned unchanged by deepcopy +IMMUTABLE_NON_COLLECTIONS_TYPES: Set[Type[Any]] = { + int, + float, + complex, + str, + bool, + bytes, + type, + NoneType, + FunctionType, + BuiltinFunctionType, + LambdaType, + weakref.ref, + CodeType, + # note: including ModuleType will differ from behaviour of deepcopy by not producing error. + # It might be not a good idea in general, but considering that this function used only internally + # against default values of fields, this will allow to actually have a field with module as default value + ModuleType, + NotImplemented.__class__, + Ellipsis.__class__, +} + +# these are types that if empty, might be copied with simple copy() instead of deepcopy() +BUILTIN_COLLECTIONS: Set[Type[Any]] = { + list, + set, + tuple, + frozenset, + dict, + OrderedDict, + defaultdict, + deque, +} + + +def import_string(dotted_path: str) -> Any: + """ + Stolen approximately from django. Import a dotted module path and return the attribute/class designated by the + last name in the path. Raise ImportError if the import fails. + """ + from importlib import import_module + + try: + module_path, class_name = dotted_path.strip(' ').rsplit('.', 1) + except ValueError as e: + raise ImportError(f'"{dotted_path}" doesn\'t look like a module path') from e + + module = import_module(module_path) + try: + return getattr(module, class_name) + except AttributeError as e: + raise ImportError(f'Module "{module_path}" does not define a "{class_name}" attribute') from e + + +def truncate(v: Union[str], *, max_len: int = 80) -> str: + """ + Truncate a value and add a unicode ellipsis (three dots) to the end if it was too long + """ + warnings.warn('`truncate` is no-longer used by pydantic and is deprecated', DeprecationWarning) + if isinstance(v, str) and len(v) > (max_len - 2): + # -3 so quote + string + … + quote has correct length + return (v[: (max_len - 3)] + '…').__repr__() + try: + v = v.__repr__() + except TypeError: + v = v.__class__.__repr__(v) # in case v is a type + if len(v) > max_len: + v = v[: max_len - 1] + '…' + return v + + +def sequence_like(v: Any) -> bool: + return isinstance(v, (list, tuple, set, frozenset, GeneratorType, deque)) + + +def validate_field_name(bases: List[Type['BaseModel']], field_name: str) -> None: + """ + Ensure that the field's name does not shadow an existing attribute of the model. + """ + for base in bases: + if getattr(base, field_name, None): + raise NameError( + f'Field name "{field_name}" shadows a BaseModel attribute; ' + f'use a different field name with "alias=\'{field_name}\'".' + ) + + +def lenient_isinstance(o: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool: + try: + return isinstance(o, class_or_tuple) # type: ignore[arg-type] + except TypeError: + return False + + +def lenient_issubclass(cls: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool: + try: + return isinstance(cls, type) and issubclass(cls, class_or_tuple) # type: ignore[arg-type] + except TypeError: + if isinstance(cls, WithArgsTypes): + return False + raise # pragma: no cover + + +def in_ipython() -> bool: + """ + Check whether we're in an ipython environment, including jupyter notebooks. + """ + try: + eval('__IPYTHON__') + except NameError: + return False + else: # pragma: no cover + return True + + +def is_valid_identifier(identifier: str) -> bool: + """ + Checks that a string is a valid identifier and not a Python keyword. + :param identifier: The identifier to test. + :return: True if the identifier is valid. + """ + return identifier.isidentifier() and not keyword.iskeyword(identifier) + + +KeyType = TypeVar('KeyType') + + +def deep_update(mapping: Dict[KeyType, Any], *updating_mappings: Dict[KeyType, Any]) -> Dict[KeyType, Any]: + updated_mapping = mapping.copy() + for updating_mapping in updating_mappings: + for k, v in updating_mapping.items(): + if k in updated_mapping and isinstance(updated_mapping[k], dict) and isinstance(v, dict): + updated_mapping[k] = deep_update(updated_mapping[k], v) + else: + updated_mapping[k] = v + return updated_mapping + + +def update_not_none(mapping: Dict[Any, Any], **update: Any) -> None: + mapping.update({k: v for k, v in update.items() if v is not None}) + + +def almost_equal_floats(value_1: float, value_2: float, *, delta: float = 1e-8) -> bool: + """ + Return True if two floats are almost equal + """ + return abs(value_1 - value_2) <= delta + + +def generate_model_signature( + init: Callable[..., None], fields: Dict[str, 'ModelField'], config: Type['BaseConfig'] +) -> 'Signature': + """ + Generate signature for model based on its fields + """ + from inspect import Parameter, Signature, signature + + from pydantic.v1.config import Extra + + present_params = signature(init).parameters.values() + merged_params: Dict[str, Parameter] = {} + var_kw = None + use_var_kw = False + + for param in islice(present_params, 1, None): # skip self arg + if param.kind is param.VAR_KEYWORD: + var_kw = param + continue + merged_params[param.name] = param + + if var_kw: # if custom init has no var_kw, fields which are not declared in it cannot be passed through + allow_names = config.allow_population_by_field_name + for field_name, field in fields.items(): + param_name = field.alias + if field_name in merged_params or param_name in merged_params: + continue + elif not is_valid_identifier(param_name): + if allow_names and is_valid_identifier(field_name): + param_name = field_name + else: + use_var_kw = True + continue + + # TODO: replace annotation with actual expected types once #1055 solved + kwargs = {'default': field.default} if not field.required else {} + merged_params[param_name] = Parameter( + param_name, Parameter.KEYWORD_ONLY, annotation=field.annotation, **kwargs + ) + + if config.extra is Extra.allow: + use_var_kw = True + + if var_kw and use_var_kw: + # Make sure the parameter for extra kwargs + # does not have the same name as a field + default_model_signature = [ + ('__pydantic_self__', Parameter.POSITIONAL_OR_KEYWORD), + ('data', Parameter.VAR_KEYWORD), + ] + if [(p.name, p.kind) for p in present_params] == default_model_signature: + # if this is the standard model signature, use extra_data as the extra args name + var_kw_name = 'extra_data' + else: + # else start from var_kw + var_kw_name = var_kw.name + + # generate a name that's definitely unique + while var_kw_name in fields: + var_kw_name += '_' + merged_params[var_kw_name] = var_kw.replace(name=var_kw_name) + + return Signature(parameters=list(merged_params.values()), return_annotation=None) + + +def get_model(obj: Union[Type['BaseModel'], Type['Dataclass']]) -> Type['BaseModel']: + from pydantic.v1.main import BaseModel + + try: + model_cls = obj.__pydantic_model__ # type: ignore + except AttributeError: + model_cls = obj + + if not issubclass(model_cls, BaseModel): + raise TypeError('Unsupported type, must be either BaseModel or dataclass') + return model_cls + + +def to_camel(string: str) -> str: + return ''.join(word.capitalize() for word in string.split('_')) + + +def to_lower_camel(string: str) -> str: + if len(string) >= 1: + pascal_string = to_camel(string) + return pascal_string[0].lower() + pascal_string[1:] + return string.lower() + + +T = TypeVar('T') + + +def unique_list( + input_list: Union[List[T], Tuple[T, ...]], + *, + name_factory: Callable[[T], str] = str, +) -> List[T]: + """ + Make a list unique while maintaining order. + We update the list if another one with the same name is set + (e.g. root validator overridden in subclass) + """ + result: List[T] = [] + result_names: List[str] = [] + for v in input_list: + v_name = name_factory(v) + if v_name not in result_names: + result_names.append(v_name) + result.append(v) + else: + result[result_names.index(v_name)] = v + + return result + + +class PyObjectStr(str): + """ + String class where repr doesn't include quotes. Useful with Representation when you want to return a string + representation of something that valid (or pseudo-valid) python. + """ + + def __repr__(self) -> str: + return str(self) + + +class Representation: + """ + Mixin to provide __str__, __repr__, and __pretty__ methods. See #884 for more details. + + __pretty__ is used by [devtools](https://python-devtools.helpmanual.io/) to provide human readable representations + of objects. + """ + + __slots__: Tuple[str, ...] = tuple() + + def __repr_args__(self) -> 'ReprArgs': + """ + Returns the attributes to show in __str__, __repr__, and __pretty__ this is generally overridden. + + Can either return: + * name - value pairs, e.g.: `[('foo_name', 'foo'), ('bar_name', ['b', 'a', 'r'])]` + * or, just values, e.g.: `[(None, 'foo'), (None, ['b', 'a', 'r'])]` + """ + attrs = ((s, getattr(self, s)) for s in self.__slots__) + return [(a, v) for a, v in attrs if v is not None] + + def __repr_name__(self) -> str: + """ + Name of the instance's class, used in __repr__. + """ + return self.__class__.__name__ + + def __repr_str__(self, join_str: str) -> str: + return join_str.join(repr(v) if a is None else f'{a}={v!r}' for a, v in self.__repr_args__()) + + def __pretty__(self, fmt: Callable[[Any], Any], **kwargs: Any) -> Generator[Any, None, None]: + """ + Used by devtools (https://python-devtools.helpmanual.io/) to provide a human readable representations of objects + """ + yield self.__repr_name__() + '(' + yield 1 + for name, value in self.__repr_args__(): + if name is not None: + yield name + '=' + yield fmt(value) + yield ',' + yield 0 + yield -1 + yield ')' + + def __str__(self) -> str: + return self.__repr_str__(' ') + + def __repr__(self) -> str: + return f'{self.__repr_name__()}({self.__repr_str__(", ")})' + + def __rich_repr__(self) -> 'RichReprResult': + """Get fields for Rich library""" + for name, field_repr in self.__repr_args__(): + if name is None: + yield field_repr + else: + yield name, field_repr + + +class GetterDict(Representation): + """ + Hack to make object's smell just enough like dicts for validate_model. + + We can't inherit from Mapping[str, Any] because it upsets cython so we have to implement all methods ourselves. + """ + + __slots__ = ('_obj',) + + def __init__(self, obj: Any): + self._obj = obj + + def __getitem__(self, key: str) -> Any: + try: + return getattr(self._obj, key) + except AttributeError as e: + raise KeyError(key) from e + + def get(self, key: Any, default: Any = None) -> Any: + return getattr(self._obj, key, default) + + def extra_keys(self) -> Set[Any]: + """ + We don't want to get any other attributes of obj if the model didn't explicitly ask for them + """ + return set() + + def keys(self) -> List[Any]: + """ + Keys of the pseudo dictionary, uses a list not set so order information can be maintained like python + dictionaries. + """ + return list(self) + + def values(self) -> List[Any]: + return [self[k] for k in self] + + def items(self) -> Iterator[Tuple[str, Any]]: + for k in self: + yield k, self.get(k) + + def __iter__(self) -> Iterator[str]: + for name in dir(self._obj): + if not name.startswith('_'): + yield name + + def __len__(self) -> int: + return sum(1 for _ in self) + + def __contains__(self, item: Any) -> bool: + return item in self.keys() + + def __eq__(self, other: Any) -> bool: + return dict(self) == dict(other.items()) + + def __repr_args__(self) -> 'ReprArgs': + return [(None, dict(self))] + + def __repr_name__(self) -> str: + return f'GetterDict[{display_as_type(self._obj)}]' + + +class ValueItems(Representation): + """ + Class for more convenient calculation of excluded or included fields on values. + """ + + __slots__ = ('_items', '_type') + + def __init__(self, value: Any, items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> None: + items = self._coerce_items(items) + + if isinstance(value, (list, tuple)): + items = self._normalize_indexes(items, len(value)) + + self._items: 'MappingIntStrAny' = items + + def is_excluded(self, item: Any) -> bool: + """ + Check if item is fully excluded. + + :param item: key or index of a value + """ + return self.is_true(self._items.get(item)) + + def is_included(self, item: Any) -> bool: + """ + Check if value is contained in self._items + + :param item: key or index of value + """ + return item in self._items + + def for_element(self, e: 'IntStr') -> Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']]: + """ + :param e: key or index of element on value + :return: raw values for element if self._items is dict and contain needed element + """ + + item = self._items.get(e) + return item if not self.is_true(item) else None + + def _normalize_indexes(self, items: 'MappingIntStrAny', v_length: int) -> 'DictIntStrAny': + """ + :param items: dict or set of indexes which will be normalized + :param v_length: length of sequence indexes of which will be + + >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4) + {0: True, 2: True, 3: True} + >>> self._normalize_indexes({'__all__': True}, 4) + {0: True, 1: True, 2: True, 3: True} + """ + + normalized_items: 'DictIntStrAny' = {} + all_items = None + for i, v in items.items(): + if not (isinstance(v, Mapping) or isinstance(v, AbstractSet) or self.is_true(v)): + raise TypeError(f'Unexpected type of exclude value for index "{i}" {v.__class__}') + if i == '__all__': + all_items = self._coerce_value(v) + continue + if not isinstance(i, int): + raise TypeError( + 'Excluding fields from a sequence of sub-models or dicts must be performed index-wise: ' + 'expected integer keys or keyword "__all__"' + ) + normalized_i = v_length + i if i < 0 else i + normalized_items[normalized_i] = self.merge(v, normalized_items.get(normalized_i)) + + if not all_items: + return normalized_items + if self.is_true(all_items): + for i in range(v_length): + normalized_items.setdefault(i, ...) + return normalized_items + for i in range(v_length): + normalized_item = normalized_items.setdefault(i, {}) + if not self.is_true(normalized_item): + normalized_items[i] = self.merge(all_items, normalized_item) + return normalized_items + + @classmethod + def merge(cls, base: Any, override: Any, intersect: bool = False) -> Any: + """ + Merge a ``base`` item with an ``override`` item. + + Both ``base`` and ``override`` are converted to dictionaries if possible. + Sets are converted to dictionaries with the sets entries as keys and + Ellipsis as values. + + Each key-value pair existing in ``base`` is merged with ``override``, + while the rest of the key-value pairs are updated recursively with this function. + + Merging takes place based on the "union" of keys if ``intersect`` is + set to ``False`` (default) and on the intersection of keys if + ``intersect`` is set to ``True``. + """ + override = cls._coerce_value(override) + base = cls._coerce_value(base) + if override is None: + return base + if cls.is_true(base) or base is None: + return override + if cls.is_true(override): + return base if intersect else override + + # intersection or union of keys while preserving ordering: + if intersect: + merge_keys = [k for k in base if k in override] + [k for k in override if k in base] + else: + merge_keys = list(base) + [k for k in override if k not in base] + + merged: 'DictIntStrAny' = {} + for k in merge_keys: + merged_item = cls.merge(base.get(k), override.get(k), intersect=intersect) + if merged_item is not None: + merged[k] = merged_item + + return merged + + @staticmethod + def _coerce_items(items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> 'MappingIntStrAny': + if isinstance(items, Mapping): + pass + elif isinstance(items, AbstractSet): + items = dict.fromkeys(items, ...) + else: + class_name = getattr(items, '__class__', '???') + assert_never( + items, + f'Unexpected type of exclude value {class_name}', + ) + return items + + @classmethod + def _coerce_value(cls, value: Any) -> Any: + if value is None or cls.is_true(value): + return value + return cls._coerce_items(value) + + @staticmethod + def is_true(v: Any) -> bool: + return v is True or v is ... + + def __repr_args__(self) -> 'ReprArgs': + return [(None, self._items)] + + +class ClassAttribute: + """ + Hide class attribute from its instances + """ + + __slots__ = ( + 'name', + 'value', + ) + + def __init__(self, name: str, value: Any) -> None: + self.name = name + self.value = value + + def __get__(self, instance: Any, owner: Type[Any]) -> None: + if instance is None: + return self.value + raise AttributeError(f'{self.name!r} attribute of {owner.__name__!r} is class-only') + + +path_types = { + 'is_dir': 'directory', + 'is_file': 'file', + 'is_mount': 'mount point', + 'is_symlink': 'symlink', + 'is_block_device': 'block device', + 'is_char_device': 'char device', + 'is_fifo': 'FIFO', + 'is_socket': 'socket', +} + + +def path_type(p: 'Path') -> str: + """ + Find out what sort of thing a path is. + """ + assert p.exists(), 'path does not exist' + for method, name in path_types.items(): + if getattr(p, method)(): + return name + + return 'unknown' + + +Obj = TypeVar('Obj') + + +def smart_deepcopy(obj: Obj) -> Obj: + """ + Return type as is for immutable built-in types + Use obj.copy() for built-in empty collections + Use copy.deepcopy() for non-empty collections and unknown objects + """ + + obj_type = obj.__class__ + if obj_type in IMMUTABLE_NON_COLLECTIONS_TYPES: + return obj # fastest case: obj is immutable and not collection therefore will not be copied anyway + try: + if not obj and obj_type in BUILTIN_COLLECTIONS: + # faster way for empty collections, no need to copy its members + return obj if obj_type is tuple else obj.copy() # type: ignore # tuple doesn't have copy method + except (TypeError, ValueError, RuntimeError): + # do we really dare to catch ALL errors? Seems a bit risky + pass + + return deepcopy(obj) # slowest way when we actually might need a deepcopy + + +def is_valid_field(name: str) -> bool: + if not name.startswith('_'): + return True + return ROOT_KEY == name + + +DUNDER_ATTRIBUTES = { + '__annotations__', + '__classcell__', + '__doc__', + '__module__', + '__orig_bases__', + '__orig_class__', + '__qualname__', +} + + +def is_valid_private_name(name: str) -> bool: + return not is_valid_field(name) and name not in DUNDER_ATTRIBUTES + + +_EMPTY = object() + + +def all_identical(left: Iterable[Any], right: Iterable[Any]) -> bool: + """ + Check that the items of `left` are the same objects as those in `right`. + + >>> a, b = object(), object() + >>> all_identical([a, b, a], [a, b, a]) + True + >>> all_identical([a, b, [a]], [a, b, [a]]) # new list object, while "equal" is not "identical" + False + """ + for left_item, right_item in zip_longest(left, right, fillvalue=_EMPTY): + if left_item is not right_item: + return False + return True + + +def assert_never(obj: NoReturn, msg: str) -> NoReturn: + """ + Helper to make sure that we have covered all possible types. + + This is mostly useful for ``mypy``, docs: + https://mypy.readthedocs.io/en/latest/literal_types.html#exhaustive-checks + """ + raise TypeError(msg) + + +def get_unique_discriminator_alias(all_aliases: Collection[str], discriminator_key: str) -> str: + """Validate that all aliases are the same and if that's the case return the alias""" + unique_aliases = set(all_aliases) + if len(unique_aliases) > 1: + raise ConfigError( + f'Aliases for discriminator {discriminator_key!r} must be the same (got {", ".join(sorted(all_aliases))})' + ) + return unique_aliases.pop() + + +def get_discriminator_alias_and_values(tp: Any, discriminator_key: str) -> Tuple[str, Tuple[str, ...]]: + """ + Get alias and all valid values in the `Literal` type of the discriminator field + `tp` can be a `BaseModel` class or directly an `Annotated` `Union` of many. + """ + is_root_model = getattr(tp, '__custom_root_type__', False) + + if get_origin(tp) is Annotated: + tp = get_args(tp)[0] + + if hasattr(tp, '__pydantic_model__'): + tp = tp.__pydantic_model__ + + if is_union(get_origin(tp)): + alias, all_values = _get_union_alias_and_all_values(tp, discriminator_key) + return alias, tuple(v for values in all_values for v in values) + elif is_root_model: + union_type = tp.__fields__[ROOT_KEY].type_ + alias, all_values = _get_union_alias_and_all_values(union_type, discriminator_key) + + if len(set(all_values)) > 1: + raise ConfigError( + f'Field {discriminator_key!r} is not the same for all submodels of {display_as_type(tp)!r}' + ) + + return alias, all_values[0] + + else: + try: + t_discriminator_type = tp.__fields__[discriminator_key].type_ + except AttributeError as e: + raise TypeError(f'Type {tp.__name__!r} is not a valid `BaseModel` or `dataclass`') from e + except KeyError as e: + raise ConfigError(f'Model {tp.__name__!r} needs a discriminator field for key {discriminator_key!r}') from e + + if not is_literal_type(t_discriminator_type): + raise ConfigError(f'Field {discriminator_key!r} of model {tp.__name__!r} needs to be a `Literal`') + + return tp.__fields__[discriminator_key].alias, all_literal_values(t_discriminator_type) + + +def _get_union_alias_and_all_values( + union_type: Type[Any], discriminator_key: str +) -> Tuple[str, Tuple[Tuple[str, ...], ...]]: + zipped_aliases_values = [get_discriminator_alias_and_values(t, discriminator_key) for t in get_args(union_type)] + # unzip: [('alias_a',('v1', 'v2)), ('alias_b', ('v3',))] => [('alias_a', 'alias_b'), (('v1', 'v2'), ('v3',))] + all_aliases, all_values = zip(*zipped_aliases_values) + return get_unique_discriminator_alias(all_aliases, discriminator_key), all_values diff --git a/env/Lib/site-packages/pydantic/v1/validators.py b/env/Lib/site-packages/pydantic/v1/validators.py new file mode 100644 index 0000000..7c39aa9 --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/validators.py @@ -0,0 +1,765 @@ +import math +import re +from collections import OrderedDict, deque +from collections.abc import Hashable as CollectionsHashable +from datetime import date, datetime, time, timedelta +from decimal import Decimal, DecimalException +from enum import Enum, IntEnum +from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network +from pathlib import Path +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Deque, + Dict, + ForwardRef, + FrozenSet, + Generator, + Hashable, + List, + NamedTuple, + Pattern, + Set, + Tuple, + Type, + TypeVar, + Union, +) +from uuid import UUID + +from pydantic.v1 import errors +from pydantic.v1.datetime_parse import parse_date, parse_datetime, parse_duration, parse_time +from pydantic.v1.typing import ( + AnyCallable, + all_literal_values, + display_as_type, + get_class, + is_callable_type, + is_literal_type, + is_namedtuple, + is_none_type, + is_typeddict, +) +from pydantic.v1.utils import almost_equal_floats, lenient_issubclass, sequence_like + +if TYPE_CHECKING: + from typing_extensions import Literal, TypedDict + + from pydantic.v1.config import BaseConfig + from pydantic.v1.fields import ModelField + from pydantic.v1.types import ConstrainedDecimal, ConstrainedFloat, ConstrainedInt + + ConstrainedNumber = Union[ConstrainedDecimal, ConstrainedFloat, ConstrainedInt] + AnyOrderedDict = OrderedDict[Any, Any] + Number = Union[int, float, Decimal] + StrBytes = Union[str, bytes] + + +def str_validator(v: Any) -> Union[str]: + if isinstance(v, str): + if isinstance(v, Enum): + return v.value + else: + return v + elif isinstance(v, (float, int, Decimal)): + # is there anything else we want to add here? If you think so, create an issue. + return str(v) + elif isinstance(v, (bytes, bytearray)): + return v.decode() + else: + raise errors.StrError() + + +def strict_str_validator(v: Any) -> Union[str]: + if isinstance(v, str) and not isinstance(v, Enum): + return v + raise errors.StrError() + + +def bytes_validator(v: Any) -> Union[bytes]: + if isinstance(v, bytes): + return v + elif isinstance(v, bytearray): + return bytes(v) + elif isinstance(v, str): + return v.encode() + elif isinstance(v, (float, int, Decimal)): + return str(v).encode() + else: + raise errors.BytesError() + + +def strict_bytes_validator(v: Any) -> Union[bytes]: + if isinstance(v, bytes): + return v + elif isinstance(v, bytearray): + return bytes(v) + else: + raise errors.BytesError() + + +BOOL_FALSE = {0, '0', 'off', 'f', 'false', 'n', 'no'} +BOOL_TRUE = {1, '1', 'on', 't', 'true', 'y', 'yes'} + + +def bool_validator(v: Any) -> bool: + if v is True or v is False: + return v + if isinstance(v, bytes): + v = v.decode() + if isinstance(v, str): + v = v.lower() + try: + if v in BOOL_TRUE: + return True + if v in BOOL_FALSE: + return False + except TypeError: + raise errors.BoolError() + raise errors.BoolError() + + +# matches the default limit cpython, see https://github.com/python/cpython/pull/96500 +max_str_int = 4_300 + + +def int_validator(v: Any) -> int: + if isinstance(v, int) and not (v is True or v is False): + return v + + # see https://github.com/pydantic/pydantic/issues/1477 and in turn, https://github.com/python/cpython/issues/95778 + # this check should be unnecessary once patch releases are out for 3.7, 3.8, 3.9 and 3.10 + # but better to check here until then. + # NOTICE: this does not fully protect user from the DOS risk since the standard library JSON implementation + # (and other std lib modules like xml) use `int()` and are likely called before this, the best workaround is to + # 1. update to the latest patch release of python once released, 2. use a different JSON library like ujson + if isinstance(v, (str, bytes, bytearray)) and len(v) > max_str_int: + raise errors.IntegerError() + + try: + return int(v) + except (TypeError, ValueError, OverflowError): + raise errors.IntegerError() + + +def strict_int_validator(v: Any) -> int: + if isinstance(v, int) and not (v is True or v is False): + return v + raise errors.IntegerError() + + +def float_validator(v: Any) -> float: + if isinstance(v, float): + return v + + try: + return float(v) + except (TypeError, ValueError): + raise errors.FloatError() + + +def strict_float_validator(v: Any) -> float: + if isinstance(v, float): + return v + raise errors.FloatError() + + +def float_finite_validator(v: 'Number', field: 'ModelField', config: 'BaseConfig') -> 'Number': + allow_inf_nan = getattr(field.type_, 'allow_inf_nan', None) + if allow_inf_nan is None: + allow_inf_nan = config.allow_inf_nan + + if allow_inf_nan is False and (math.isnan(v) or math.isinf(v)): + raise errors.NumberNotFiniteError() + return v + + +def number_multiple_validator(v: 'Number', field: 'ModelField') -> 'Number': + field_type: ConstrainedNumber = field.type_ + if field_type.multiple_of is not None: + mod = float(v) / float(field_type.multiple_of) % 1 + if not almost_equal_floats(mod, 0.0) and not almost_equal_floats(mod, 1.0): + raise errors.NumberNotMultipleError(multiple_of=field_type.multiple_of) + return v + + +def number_size_validator(v: 'Number', field: 'ModelField') -> 'Number': + field_type: ConstrainedNumber = field.type_ + if field_type.gt is not None and not v > field_type.gt: + raise errors.NumberNotGtError(limit_value=field_type.gt) + elif field_type.ge is not None and not v >= field_type.ge: + raise errors.NumberNotGeError(limit_value=field_type.ge) + + if field_type.lt is not None and not v < field_type.lt: + raise errors.NumberNotLtError(limit_value=field_type.lt) + if field_type.le is not None and not v <= field_type.le: + raise errors.NumberNotLeError(limit_value=field_type.le) + + return v + + +def constant_validator(v: 'Any', field: 'ModelField') -> 'Any': + """Validate ``const`` fields. + + The value provided for a ``const`` field must be equal to the default value + of the field. This is to support the keyword of the same name in JSON + Schema. + """ + if v != field.default: + raise errors.WrongConstantError(given=v, permitted=[field.default]) + + return v + + +def anystr_length_validator(v: 'StrBytes', config: 'BaseConfig') -> 'StrBytes': + v_len = len(v) + + min_length = config.min_anystr_length + if v_len < min_length: + raise errors.AnyStrMinLengthError(limit_value=min_length) + + max_length = config.max_anystr_length + if max_length is not None and v_len > max_length: + raise errors.AnyStrMaxLengthError(limit_value=max_length) + + return v + + +def anystr_strip_whitespace(v: 'StrBytes') -> 'StrBytes': + return v.strip() + + +def anystr_upper(v: 'StrBytes') -> 'StrBytes': + return v.upper() + + +def anystr_lower(v: 'StrBytes') -> 'StrBytes': + return v.lower() + + +def ordered_dict_validator(v: Any) -> 'AnyOrderedDict': + if isinstance(v, OrderedDict): + return v + + try: + return OrderedDict(v) + except (TypeError, ValueError): + raise errors.DictError() + + +def dict_validator(v: Any) -> Dict[Any, Any]: + if isinstance(v, dict): + return v + + try: + return dict(v) + except (TypeError, ValueError): + raise errors.DictError() + + +def list_validator(v: Any) -> List[Any]: + if isinstance(v, list): + return v + elif sequence_like(v): + return list(v) + else: + raise errors.ListError() + + +def tuple_validator(v: Any) -> Tuple[Any, ...]: + if isinstance(v, tuple): + return v + elif sequence_like(v): + return tuple(v) + else: + raise errors.TupleError() + + +def set_validator(v: Any) -> Set[Any]: + if isinstance(v, set): + return v + elif sequence_like(v): + return set(v) + else: + raise errors.SetError() + + +def frozenset_validator(v: Any) -> FrozenSet[Any]: + if isinstance(v, frozenset): + return v + elif sequence_like(v): + return frozenset(v) + else: + raise errors.FrozenSetError() + + +def deque_validator(v: Any) -> Deque[Any]: + if isinstance(v, deque): + return v + elif sequence_like(v): + return deque(v) + else: + raise errors.DequeError() + + +def enum_member_validator(v: Any, field: 'ModelField', config: 'BaseConfig') -> Enum: + try: + enum_v = field.type_(v) + except ValueError: + # field.type_ should be an enum, so will be iterable + raise errors.EnumMemberError(enum_values=list(field.type_)) + return enum_v.value if config.use_enum_values else enum_v + + +def uuid_validator(v: Any, field: 'ModelField') -> UUID: + try: + if isinstance(v, str): + v = UUID(v) + elif isinstance(v, (bytes, bytearray)): + try: + v = UUID(v.decode()) + except ValueError: + # 16 bytes in big-endian order as the bytes argument fail + # the above check + v = UUID(bytes=v) + except ValueError: + raise errors.UUIDError() + + if not isinstance(v, UUID): + raise errors.UUIDError() + + required_version = getattr(field.type_, '_required_version', None) + if required_version and v.version != required_version: + raise errors.UUIDVersionError(required_version=required_version) + + return v + + +def decimal_validator(v: Any) -> Decimal: + if isinstance(v, Decimal): + return v + elif isinstance(v, (bytes, bytearray)): + v = v.decode() + + v = str(v).strip() + + try: + v = Decimal(v) + except DecimalException: + raise errors.DecimalError() + + if not v.is_finite(): + raise errors.DecimalIsNotFiniteError() + + return v + + +def hashable_validator(v: Any) -> Hashable: + if isinstance(v, Hashable): + return v + + raise errors.HashableError() + + +def ip_v4_address_validator(v: Any) -> IPv4Address: + if isinstance(v, IPv4Address): + return v + + try: + return IPv4Address(v) + except ValueError: + raise errors.IPv4AddressError() + + +def ip_v6_address_validator(v: Any) -> IPv6Address: + if isinstance(v, IPv6Address): + return v + + try: + return IPv6Address(v) + except ValueError: + raise errors.IPv6AddressError() + + +def ip_v4_network_validator(v: Any) -> IPv4Network: + """ + Assume IPv4Network initialised with a default ``strict`` argument + + See more: + https://docs.python.org/library/ipaddress.html#ipaddress.IPv4Network + """ + if isinstance(v, IPv4Network): + return v + + try: + return IPv4Network(v) + except ValueError: + raise errors.IPv4NetworkError() + + +def ip_v6_network_validator(v: Any) -> IPv6Network: + """ + Assume IPv6Network initialised with a default ``strict`` argument + + See more: + https://docs.python.org/library/ipaddress.html#ipaddress.IPv6Network + """ + if isinstance(v, IPv6Network): + return v + + try: + return IPv6Network(v) + except ValueError: + raise errors.IPv6NetworkError() + + +def ip_v4_interface_validator(v: Any) -> IPv4Interface: + if isinstance(v, IPv4Interface): + return v + + try: + return IPv4Interface(v) + except ValueError: + raise errors.IPv4InterfaceError() + + +def ip_v6_interface_validator(v: Any) -> IPv6Interface: + if isinstance(v, IPv6Interface): + return v + + try: + return IPv6Interface(v) + except ValueError: + raise errors.IPv6InterfaceError() + + +def path_validator(v: Any) -> Path: + if isinstance(v, Path): + return v + + try: + return Path(v) + except TypeError: + raise errors.PathError() + + +def path_exists_validator(v: Any) -> Path: + if not v.exists(): + raise errors.PathNotExistsError(path=v) + + return v + + +def callable_validator(v: Any) -> AnyCallable: + """ + Perform a simple check if the value is callable. + + Note: complete matching of argument type hints and return types is not performed + """ + if callable(v): + return v + + raise errors.CallableError(value=v) + + +def enum_validator(v: Any) -> Enum: + if isinstance(v, Enum): + return v + + raise errors.EnumError(value=v) + + +def int_enum_validator(v: Any) -> IntEnum: + if isinstance(v, IntEnum): + return v + + raise errors.IntEnumError(value=v) + + +def make_literal_validator(type_: Any) -> Callable[[Any], Any]: + permitted_choices = all_literal_values(type_) + + # To have a O(1) complexity and still return one of the values set inside the `Literal`, + # we create a dict with the set values (a set causes some problems with the way intersection works). + # In some cases the set value and checked value can indeed be different (see `test_literal_validator_str_enum`) + allowed_choices = {v: v for v in permitted_choices} + + def literal_validator(v: Any) -> Any: + try: + return allowed_choices[v] + except (KeyError, TypeError): + raise errors.WrongConstantError(given=v, permitted=permitted_choices) + + return literal_validator + + +def constr_length_validator(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes': + v_len = len(v) + + min_length = field.type_.min_length if field.type_.min_length is not None else config.min_anystr_length + if v_len < min_length: + raise errors.AnyStrMinLengthError(limit_value=min_length) + + max_length = field.type_.max_length if field.type_.max_length is not None else config.max_anystr_length + if max_length is not None and v_len > max_length: + raise errors.AnyStrMaxLengthError(limit_value=max_length) + + return v + + +def constr_strip_whitespace(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes': + strip_whitespace = field.type_.strip_whitespace or config.anystr_strip_whitespace + if strip_whitespace: + v = v.strip() + + return v + + +def constr_upper(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes': + upper = field.type_.to_upper or config.anystr_upper + if upper: + v = v.upper() + + return v + + +def constr_lower(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes': + lower = field.type_.to_lower or config.anystr_lower + if lower: + v = v.lower() + return v + + +def validate_json(v: Any, config: 'BaseConfig') -> Any: + if v is None: + # pass None through to other validators + return v + try: + return config.json_loads(v) # type: ignore + except ValueError: + raise errors.JsonError() + except TypeError: + raise errors.JsonTypeError() + + +T = TypeVar('T') + + +def make_arbitrary_type_validator(type_: Type[T]) -> Callable[[T], T]: + def arbitrary_type_validator(v: Any) -> T: + if isinstance(v, type_): + return v + raise errors.ArbitraryTypeError(expected_arbitrary_type=type_) + + return arbitrary_type_validator + + +def make_class_validator(type_: Type[T]) -> Callable[[Any], Type[T]]: + def class_validator(v: Any) -> Type[T]: + if lenient_issubclass(v, type_): + return v + raise errors.SubclassError(expected_class=type_) + + return class_validator + + +def any_class_validator(v: Any) -> Type[T]: + if isinstance(v, type): + return v + raise errors.ClassError() + + +def none_validator(v: Any) -> 'Literal[None]': + if v is None: + return v + raise errors.NotNoneError() + + +def pattern_validator(v: Any) -> Pattern[str]: + if isinstance(v, Pattern): + return v + + str_value = str_validator(v) + + try: + return re.compile(str_value) + except re.error: + raise errors.PatternError() + + +NamedTupleT = TypeVar('NamedTupleT', bound=NamedTuple) + + +def make_namedtuple_validator( + namedtuple_cls: Type[NamedTupleT], config: Type['BaseConfig'] +) -> Callable[[Tuple[Any, ...]], NamedTupleT]: + from pydantic.v1.annotated_types import create_model_from_namedtuple + + NamedTupleModel = create_model_from_namedtuple( + namedtuple_cls, + __config__=config, + __module__=namedtuple_cls.__module__, + ) + namedtuple_cls.__pydantic_model__ = NamedTupleModel # type: ignore[attr-defined] + + def namedtuple_validator(values: Tuple[Any, ...]) -> NamedTupleT: + annotations = NamedTupleModel.__annotations__ + + if len(values) > len(annotations): + raise errors.ListMaxLengthError(limit_value=len(annotations)) + + dict_values: Dict[str, Any] = dict(zip(annotations, values)) + validated_dict_values: Dict[str, Any] = dict(NamedTupleModel(**dict_values)) + return namedtuple_cls(**validated_dict_values) + + return namedtuple_validator + + +def make_typeddict_validator( + typeddict_cls: Type['TypedDict'], config: Type['BaseConfig'] # type: ignore[valid-type] +) -> Callable[[Any], Dict[str, Any]]: + from pydantic.v1.annotated_types import create_model_from_typeddict + + TypedDictModel = create_model_from_typeddict( + typeddict_cls, + __config__=config, + __module__=typeddict_cls.__module__, + ) + typeddict_cls.__pydantic_model__ = TypedDictModel # type: ignore[attr-defined] + + def typeddict_validator(values: 'TypedDict') -> Dict[str, Any]: # type: ignore[valid-type] + return TypedDictModel.parse_obj(values).dict(exclude_unset=True) + + return typeddict_validator + + +class IfConfig: + def __init__(self, validator: AnyCallable, *config_attr_names: str, ignored_value: Any = False) -> None: + self.validator = validator + self.config_attr_names = config_attr_names + self.ignored_value = ignored_value + + def check(self, config: Type['BaseConfig']) -> bool: + return any(getattr(config, name) not in {None, self.ignored_value} for name in self.config_attr_names) + + +# order is important here, for example: bool is a subclass of int so has to come first, datetime before date same, +# IPv4Interface before IPv4Address, etc +_VALIDATORS: List[Tuple[Type[Any], List[Any]]] = [ + (IntEnum, [int_validator, enum_member_validator]), + (Enum, [enum_member_validator]), + ( + str, + [ + str_validator, + IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'), + IfConfig(anystr_upper, 'anystr_upper'), + IfConfig(anystr_lower, 'anystr_lower'), + IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'), + ], + ), + ( + bytes, + [ + bytes_validator, + IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'), + IfConfig(anystr_upper, 'anystr_upper'), + IfConfig(anystr_lower, 'anystr_lower'), + IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'), + ], + ), + (bool, [bool_validator]), + (int, [int_validator]), + (float, [float_validator, IfConfig(float_finite_validator, 'allow_inf_nan', ignored_value=True)]), + (Path, [path_validator]), + (datetime, [parse_datetime]), + (date, [parse_date]), + (time, [parse_time]), + (timedelta, [parse_duration]), + (OrderedDict, [ordered_dict_validator]), + (dict, [dict_validator]), + (list, [list_validator]), + (tuple, [tuple_validator]), + (set, [set_validator]), + (frozenset, [frozenset_validator]), + (deque, [deque_validator]), + (UUID, [uuid_validator]), + (Decimal, [decimal_validator]), + (IPv4Interface, [ip_v4_interface_validator]), + (IPv6Interface, [ip_v6_interface_validator]), + (IPv4Address, [ip_v4_address_validator]), + (IPv6Address, [ip_v6_address_validator]), + (IPv4Network, [ip_v4_network_validator]), + (IPv6Network, [ip_v6_network_validator]), +] + + +def find_validators( # noqa: C901 (ignore complexity) + type_: Type[Any], config: Type['BaseConfig'] +) -> Generator[AnyCallable, None, None]: + from pydantic.v1.dataclasses import is_builtin_dataclass, make_dataclass_validator + + if type_ is Any or type_ is object: + return + type_type = type_.__class__ + if type_type == ForwardRef or type_type == TypeVar: + return + + if is_none_type(type_): + yield none_validator + return + if type_ is Pattern or type_ is re.Pattern: + yield pattern_validator + return + if type_ is Hashable or type_ is CollectionsHashable: + yield hashable_validator + return + if is_callable_type(type_): + yield callable_validator + return + if is_literal_type(type_): + yield make_literal_validator(type_) + return + if is_builtin_dataclass(type_): + yield from make_dataclass_validator(type_, config) + return + if type_ is Enum: + yield enum_validator + return + if type_ is IntEnum: + yield int_enum_validator + return + if is_namedtuple(type_): + yield tuple_validator + yield make_namedtuple_validator(type_, config) + return + if is_typeddict(type_): + yield make_typeddict_validator(type_, config) + return + + class_ = get_class(type_) + if class_ is not None: + if class_ is not Any and isinstance(class_, type): + yield make_class_validator(class_) + else: + yield any_class_validator + return + + for val_type, validators in _VALIDATORS: + try: + if issubclass(type_, val_type): + for v in validators: + if isinstance(v, IfConfig): + if v.check(config): + yield v.validator + else: + yield v + return + except TypeError: + raise RuntimeError(f'error checking inheritance of {type_!r} (type: {display_as_type(type_)})') + + if config.arbitrary_types_allowed: + yield make_arbitrary_type_validator(type_) + else: + raise RuntimeError(f'no validator found for {type_}, see `arbitrary_types_allowed` in Config') diff --git a/env/Lib/site-packages/pydantic/v1/version.py b/env/Lib/site-packages/pydantic/v1/version.py new file mode 100644 index 0000000..8127c11 --- /dev/null +++ b/env/Lib/site-packages/pydantic/v1/version.py @@ -0,0 +1,38 @@ +__all__ = 'compiled', 'VERSION', 'version_info' + +VERSION = '1.10.17' + +try: + import cython # type: ignore +except ImportError: + compiled: bool = False +else: # pragma: no cover + try: + compiled = cython.compiled + except AttributeError: + compiled = False + + +def version_info() -> str: + import platform + import sys + from importlib import import_module + from pathlib import Path + + optional_deps = [] + for p in ('devtools', 'dotenv', 'email-validator', 'typing-extensions'): + try: + import_module(p.replace('-', '_')) + except ImportError: + continue + optional_deps.append(p) + + info = { + 'pydantic version': VERSION, + 'pydantic compiled': compiled, + 'install path': Path(__file__).resolve().parent, + 'python version': sys.version, + 'platform': platform.platform(), + 'optional deps. installed': optional_deps, + } + return '\n'.join('{:>30} {}'.format(k + ':', str(v).replace('\n', ' ')) for k, v in info.items()) diff --git a/env/Lib/site-packages/pydantic/validate_call_decorator.py b/env/Lib/site-packages/pydantic/validate_call_decorator.py new file mode 100644 index 0000000..5314c92 --- /dev/null +++ b/env/Lib/site-packages/pydantic/validate_call_decorator.py @@ -0,0 +1,69 @@ +"""Decorator for validating function calls.""" + +from __future__ import annotations as _annotations + +import functools +from typing import TYPE_CHECKING, Any, Callable, TypeVar, overload + +from ._internal import _typing_extra, _validate_call + +__all__ = ('validate_call',) + +if TYPE_CHECKING: + from .config import ConfigDict + + AnyCallableT = TypeVar('AnyCallableT', bound=Callable[..., Any]) + + +@overload +def validate_call( + *, config: ConfigDict | None = None, validate_return: bool = False +) -> Callable[[AnyCallableT], AnyCallableT]: ... + + +@overload +def validate_call(func: AnyCallableT, /) -> AnyCallableT: ... + + +def validate_call( + func: AnyCallableT | None = None, + /, + *, + config: ConfigDict | None = None, + validate_return: bool = False, +) -> AnyCallableT | Callable[[AnyCallableT], AnyCallableT]: + """Usage docs: https://docs.pydantic.dev/2.8/concepts/validation_decorator/ + + Returns a decorated wrapper around the function that validates the arguments and, optionally, the return value. + + Usage may be either as a plain decorator `@validate_call` or with arguments `@validate_call(...)`. + + Args: + func: The function to be decorated. + config: The configuration dictionary. + validate_return: Whether to validate the return value. + + Returns: + The decorated function. + """ + local_ns = _typing_extra.parent_frame_namespace() + + def validate(function: AnyCallableT) -> AnyCallableT: + if isinstance(function, (classmethod, staticmethod)): + name = type(function).__name__ + raise TypeError(f'The `@{name}` decorator should be applied after `@validate_call` (put `@{name}` on top)') + + validate_call_wrapper = _validate_call.ValidateCallWrapper(function, config, validate_return, local_ns) + + @functools.wraps(function) + def wrapper_function(*args, **kwargs): + return validate_call_wrapper(*args, **kwargs) + + wrapper_function.raw_function = function # type: ignore + + return wrapper_function # type: ignore + + if func: + return validate(func) + else: + return validate diff --git a/env/Lib/site-packages/pydantic/validators.py b/env/Lib/site-packages/pydantic/validators.py new file mode 100644 index 0000000..7921b04 --- /dev/null +++ b/env/Lib/site-packages/pydantic/validators.py @@ -0,0 +1,5 @@ +"""The `validators` module is a backport module from V1.""" + +from ._migration import getattr_migration + +__getattr__ = getattr_migration(__name__) diff --git a/env/Lib/site-packages/pydantic/version.py b/env/Lib/site-packages/pydantic/version.py new file mode 100644 index 0000000..fa69a3a --- /dev/null +++ b/env/Lib/site-packages/pydantic/version.py @@ -0,0 +1,78 @@ +"""The `version` module holds the version information for Pydantic.""" + +from __future__ import annotations as _annotations + +__all__ = 'VERSION', 'version_info' + +VERSION = '2.8.2' +"""The version of Pydantic.""" + + +def version_short() -> str: + """Return the `major.minor` part of Pydantic version. + + It returns '2.1' if Pydantic version is '2.1.1'. + """ + return '.'.join(VERSION.split('.')[:2]) + + +def version_info() -> str: + """Return complete version information for Pydantic and its dependencies.""" + import importlib.metadata as importlib_metadata + import os + import platform + import sys + from pathlib import Path + + import pydantic_core._pydantic_core as pdc + + from ._internal import _git as git + + # get data about packages that are closely related to pydantic, use pydantic or often conflict with pydantic + package_names = { + 'email-validator', + 'fastapi', + 'mypy', + 'pydantic-extra-types', + 'pydantic-settings', + 'pyright', + 'typing_extensions', + } + related_packages = [] + + for dist in importlib_metadata.distributions(): + name = dist.metadata['Name'] + if name in package_names: + related_packages.append(f'{name}-{dist.version}') + + pydantic_dir = os.path.abspath(os.path.dirname(os.path.dirname(__file__))) + most_recent_commit = ( + git.git_revision(pydantic_dir) if git.is_git_repo(pydantic_dir) and git.have_git() else 'unknown' + ) + + info = { + 'pydantic version': VERSION, + 'pydantic-core version': pdc.__version__, + 'pydantic-core build': getattr(pdc, 'build_info', None) or pdc.build_profile, + 'install path': Path(__file__).resolve().parent, + 'python version': sys.version, + 'platform': platform.platform(), + 'related packages': ' '.join(related_packages), + 'commit': most_recent_commit, + } + return '\n'.join('{:>30} {}'.format(k + ':', str(v).replace('\n', ' ')) for k, v in info.items()) + + +def parse_mypy_version(version: str) -> tuple[int, ...]: + """Parse mypy string version to tuple of ints. + + It parses normal version like `0.930` and extra info followed by a `+` sign + like `0.940+dev.04cac4b5d911c4f9529e6ce86a27b44f28846f5d.dirty`. + + Args: + version: The mypy version string. + + Returns: + A tuple of ints. e.g. (0, 930). + """ + return tuple(map(int, version.partition('+')[0].split('.'))) diff --git a/env/Lib/site-packages/pydantic/warnings.py b/env/Lib/site-packages/pydantic/warnings.py new file mode 100644 index 0000000..ea9fa6d --- /dev/null +++ b/env/Lib/site-packages/pydantic/warnings.py @@ -0,0 +1,72 @@ +"""Pydantic-specific warnings.""" + +from __future__ import annotations as _annotations + +from .version import version_short + +__all__ = ( + 'PydanticDeprecatedSince20', + 'PydanticDeprecationWarning', + 'PydanticDeprecatedSince26', + 'PydanticExperimentalWarning', +) + + +class PydanticDeprecationWarning(DeprecationWarning): + """A Pydantic specific deprecation warning. + + This warning is raised when using deprecated functionality in Pydantic. It provides information on when the + deprecation was introduced and the expected version in which the corresponding functionality will be removed. + + Attributes: + message: Description of the warning. + since: Pydantic version in what the deprecation was introduced. + expected_removal: Pydantic version in what the corresponding functionality expected to be removed. + """ + + message: str + since: tuple[int, int] + expected_removal: tuple[int, int] + + def __init__( + self, message: str, *args: object, since: tuple[int, int], expected_removal: tuple[int, int] | None = None + ) -> None: + super().__init__(message, *args) + self.message = message.rstrip('.') + self.since = since + self.expected_removal = expected_removal if expected_removal is not None else (since[0] + 1, 0) + + def __str__(self) -> str: + message = ( + f'{self.message}. Deprecated in Pydantic V{self.since[0]}.{self.since[1]}' + f' to be removed in V{self.expected_removal[0]}.{self.expected_removal[1]}.' + ) + if self.since == (2, 0): + message += f' See Pydantic V2 Migration Guide at https://errors.pydantic.dev/{version_short()}/migration/' + return message + + +class PydanticDeprecatedSince20(PydanticDeprecationWarning): + """A specific `PydanticDeprecationWarning` subclass defining functionality deprecated since Pydantic 2.0.""" + + def __init__(self, message: str, *args: object) -> None: + super().__init__(message, *args, since=(2, 0), expected_removal=(3, 0)) + + +class PydanticDeprecatedSince26(PydanticDeprecationWarning): + """A specific `PydanticDeprecationWarning` subclass defining functionality deprecated since Pydantic 2.6.""" + + def __init__(self, message: str, *args: object) -> None: + super().__init__(message, *args, since=(2, 0), expected_removal=(3, 0)) + + +class GenericBeforeBaseModelWarning(Warning): + pass + + +class PydanticExperimentalWarning(Warning): + """A Pydantic specific experimental functionality warning. + + This warning is raised when using experimental functionality in Pydantic. + It is raised to warn users that the functionality may change or be removed in future versions of Pydantic. + """ diff --git a/env/Lib/site-packages/pydantic_core-2.20.1.dist-info/INSTALLER b/env/Lib/site-packages/pydantic_core-2.20.1.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/env/Lib/site-packages/pydantic_core-2.20.1.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/env/Lib/site-packages/pydantic_core-2.20.1.dist-info/METADATA b/env/Lib/site-packages/pydantic_core-2.20.1.dist-info/METADATA new file mode 100644 index 0000000..a5efeb6 --- /dev/null +++ b/env/Lib/site-packages/pydantic_core-2.20.1.dist-info/METADATA @@ -0,0 +1,161 @@ +Metadata-Version: 2.3 +Name: pydantic_core +Version: 2.20.1 +Classifier: Development Status :: 3 - Alpha +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3.13 +Classifier: Programming Language :: Rust +Classifier: Framework :: Pydantic +Classifier: Intended Audience :: Developers +Classifier: Intended Audience :: Information Technology +Classifier: License :: OSI Approved :: MIT License +Classifier: Operating System :: POSIX :: Linux +Classifier: Operating System :: Microsoft :: Windows +Classifier: Operating System :: MacOS +Classifier: Typing :: Typed +Requires-Dist: typing-extensions >=4.6.0, !=4.7.0 +License-File: LICENSE +Summary: Core functionality for Pydantic validation and serialization +Home-Page: https://github.com/pydantic/pydantic-core +Author-email: Samuel Colvin +License: MIT +Requires-Python: >=3.8 +Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM +Project-URL: Homepage, https://github.com/pydantic/pydantic-core +Project-URL: Funding, https://github.com/sponsors/samuelcolvin +Project-URL: Source, https://github.com/pydantic/pydantic-core + +# pydantic-core + +[![CI](https://github.com/pydantic/pydantic-core/workflows/ci/badge.svg?event=push)](https://github.com/pydantic/pydantic-core/actions?query=event%3Apush+branch%3Amain+workflow%3Aci) +[![Coverage](https://codecov.io/gh/pydantic/pydantic-core/branch/main/graph/badge.svg)](https://codecov.io/gh/pydantic/pydantic-core) +[![pypi](https://img.shields.io/pypi/v/pydantic-core.svg)](https://pypi.python.org/pypi/pydantic-core) +[![versions](https://img.shields.io/pypi/pyversions/pydantic-core.svg)](https://github.com/pydantic/pydantic-core) +[![license](https://img.shields.io/github/license/pydantic/pydantic-core.svg)](https://github.com/pydantic/pydantic-core/blob/main/LICENSE) + +This package provides the core functionality for [pydantic](https://docs.pydantic.dev) validation and serialization. + +Pydantic-core is currently around 17x faster than pydantic V1. +See [`tests/benchmarks/`](./tests/benchmarks/) for details. + +## Example of direct usage + +_NOTE: You should not need to use pydantic-core directly; instead, use pydantic, which in turn uses pydantic-core._ + +```py +from pydantic_core import SchemaValidator, ValidationError + + +v = SchemaValidator( + { + 'type': 'typed-dict', + 'fields': { + 'name': { + 'type': 'typed-dict-field', + 'schema': { + 'type': 'str', + }, + }, + 'age': { + 'type': 'typed-dict-field', + 'schema': { + 'type': 'int', + 'ge': 18, + }, + }, + 'is_developer': { + 'type': 'typed-dict-field', + 'schema': { + 'type': 'default', + 'schema': {'type': 'bool'}, + 'default': True, + }, + }, + }, + } +) + +r1 = v.validate_python({'name': 'Samuel', 'age': 35}) +assert r1 == {'name': 'Samuel', 'age': 35, 'is_developer': True} + +# pydantic-core can also validate JSON directly +r2 = v.validate_json('{"name": "Samuel", "age": 35}') +assert r1 == r2 + +try: + v.validate_python({'name': 'Samuel', 'age': 11}) +except ValidationError as e: + print(e) + """ + 1 validation error for model + age + Input should be greater than or equal to 18 + [type=greater_than_equal, context={ge: 18}, input_value=11, input_type=int] + """ +``` + +## Getting Started + +You'll need rust stable [installed](https://rustup.rs/), or rust nightly if you want to generate accurate coverage. + +With rust and python 3.8+ installed, compiling pydantic-core should be possible with roughly the following: + +```bash +# clone this repo or your fork +git clone git@github.com:pydantic/pydantic-core.git +cd pydantic-core +# create a new virtual env +python3 -m venv env +source env/bin/activate +# install dependencies and install pydantic-core +make install +``` + +That should be it, the example shown above should now run. + +You might find it useful to look at [`python/pydantic_core/_pydantic_core.pyi`](./python/pydantic_core/_pydantic_core.pyi) and +[`python/pydantic_core/core_schema.py`](./python/pydantic_core/core_schema.py) for more information on the python API, +beyond that, [`tests/`](./tests) provide a large number of examples of usage. + +If you want to contribute to pydantic-core, you'll want to use some other make commands: +* `make build-dev` to build the package during development +* `make build-prod` to perform an optimised build for benchmarking +* `make test` to run the tests +* `make testcov` to run the tests and generate a coverage report +* `make lint` to run the linter +* `make format` to format python and rust code +* `make` to run `format build-dev lint test` + +## Profiling + +It's possible to profile the code using the [`flamegraph` utility from `flamegraph-rs`](https://github.com/flamegraph-rs/flamegraph). (Tested on Linux.) You can install this with `cargo install flamegraph`. + +Run `make build-profiling` to install a release build with debugging symbols included (needed for profiling). + +Once that is built, you can profile pytest benchmarks with (e.g.): + +```bash +flamegraph -- pytest tests/benchmarks/test_micro_benchmarks.py -k test_list_of_ints_core_py --benchmark-enable +``` +The `flamegraph` command will produce an interactive SVG at `flamegraph.svg`. + +## Releasing + +1. Bump package version locally. Do not just edit `Cargo.toml` on Github, you need both `Cargo.toml` and `Cargo.lock` to be updated. +2. Make a PR for the version bump and merge it. +3. Go to https://github.com/pydantic/pydantic-core/releases and click "Draft a new release" +4. In the "Choose a tag" dropdown enter the new tag `v` and select "Create new tag on publish" when the option appears. +5. Enter the release title in the form "v " +6. Click Generate release notes button +7. Click Publish release +8. Go to https://github.com/pydantic/pydantic-core/actions and ensure that all build for release are done successfully. +9. Go to https://pypi.org/project/pydantic-core/ and ensure that the latest release is published. +10. Done 🎉 + diff --git a/env/Lib/site-packages/pydantic_core-2.20.1.dist-info/RECORD b/env/Lib/site-packages/pydantic_core-2.20.1.dist-info/RECORD new file mode 100644 index 0000000..df60d5a --- /dev/null +++ b/env/Lib/site-packages/pydantic_core-2.20.1.dist-info/RECORD @@ -0,0 +1,12 @@ +pydantic_core-2.20.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +pydantic_core-2.20.1.dist-info/METADATA,sha256=qAqRrEvYKJGzNlDiGv779DhZbe-ruBg6K_7Bcoj9oT4,6711 +pydantic_core-2.20.1.dist-info/RECORD,, +pydantic_core-2.20.1.dist-info/WHEEL,sha256=DzHgklH-N2Rm5CKeMVkz9xJT6rK_2P-i_Xf1Csdhcdo,95 +pydantic_core-2.20.1.dist-info/license_files/LICENSE,sha256=--f2FfGNE1wHAA5ahjJdsn9Cx3KWme8WasH3o_RYa_Q,1101 +pydantic_core/__init__.py,sha256=DTBLhkPl5ANdVSdJiItk1d9jtno2ZUTwyMw2zmnLx6Q,4336 +pydantic_core/__pycache__/__init__.cpython-311.pyc,, +pydantic_core/__pycache__/core_schema.cpython-311.pyc,, +pydantic_core/_pydantic_core.cp311-win_amd64.pyd,sha256=9bHbBwGd6jn7os4DfwofOR4WywcmT9_OMXE2R5tsNvQ,5021696 +pydantic_core/_pydantic_core.pyi,sha256=CYb_5evOcv9rR1ScvX_0f1snRV8SIVTI8I6cqEwo1h8,36062 +pydantic_core/core_schema.py,sha256=qNWrObkmOlxoSblaERlr5VISc5G1EcKesMcHY1h2j-w,142069 +pydantic_core/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 diff --git a/env/Lib/site-packages/pydantic_core-2.20.1.dist-info/WHEEL b/env/Lib/site-packages/pydantic_core-2.20.1.dist-info/WHEEL new file mode 100644 index 0000000..5522df5 --- /dev/null +++ b/env/Lib/site-packages/pydantic_core-2.20.1.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: maturin (1.6.0) +Root-Is-Purelib: false +Tag: cp311-none-win_amd64 diff --git a/env/Lib/site-packages/pydantic_core-2.20.1.dist-info/license_files/LICENSE b/env/Lib/site-packages/pydantic_core-2.20.1.dist-info/license_files/LICENSE new file mode 100644 index 0000000..0716871 --- /dev/null +++ b/env/Lib/site-packages/pydantic_core-2.20.1.dist-info/license_files/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2022 Samuel Colvin + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/env/Lib/site-packages/pydantic_core/__init__.py b/env/Lib/site-packages/pydantic_core/__init__.py new file mode 100644 index 0000000..5b2655c --- /dev/null +++ b/env/Lib/site-packages/pydantic_core/__init__.py @@ -0,0 +1,139 @@ +from __future__ import annotations + +import sys as _sys +from typing import Any as _Any + +from ._pydantic_core import ( + ArgsKwargs, + MultiHostUrl, + PydanticCustomError, + PydanticKnownError, + PydanticOmit, + PydanticSerializationError, + PydanticSerializationUnexpectedValue, + PydanticUndefined, + PydanticUndefinedType, + PydanticUseDefault, + SchemaError, + SchemaSerializer, + SchemaValidator, + Some, + TzInfo, + Url, + ValidationError, + __version__, + from_json, + to_json, + to_jsonable_python, + validate_core_schema, +) +from .core_schema import CoreConfig, CoreSchema, CoreSchemaType, ErrorType + +if _sys.version_info < (3, 11): + from typing_extensions import NotRequired as _NotRequired +else: + from typing import NotRequired as _NotRequired + +if _sys.version_info < (3, 9): + from typing_extensions import TypedDict as _TypedDict +else: + from typing import TypedDict as _TypedDict + +__all__ = [ + '__version__', + 'CoreConfig', + 'CoreSchema', + 'CoreSchemaType', + 'SchemaValidator', + 'SchemaSerializer', + 'Some', + 'Url', + 'MultiHostUrl', + 'ArgsKwargs', + 'PydanticUndefined', + 'PydanticUndefinedType', + 'SchemaError', + 'ErrorDetails', + 'InitErrorDetails', + 'ValidationError', + 'PydanticCustomError', + 'PydanticKnownError', + 'PydanticOmit', + 'PydanticUseDefault', + 'PydanticSerializationError', + 'PydanticSerializationUnexpectedValue', + 'TzInfo', + 'to_json', + 'from_json', + 'to_jsonable_python', + 'validate_core_schema', +] + + +class ErrorDetails(_TypedDict): + type: str + """ + The type of error that occurred, this is an identifier designed for + programmatic use that will change rarely or never. + + `type` is unique for each error message, and can hence be used as an identifier to build custom error messages. + """ + loc: tuple[int | str, ...] + """Tuple of strings and ints identifying where in the schema the error occurred.""" + msg: str + """A human readable error message.""" + input: _Any + """The input data at this `loc` that caused the error.""" + ctx: _NotRequired[dict[str, _Any]] + """ + Values which are required to render the error message, and could hence be useful in rendering custom error messages. + Also useful for passing custom error data forward. + """ + + +class InitErrorDetails(_TypedDict): + type: str | PydanticCustomError + """The type of error that occurred, this should a "slug" identifier that changes rarely or never.""" + loc: _NotRequired[tuple[int | str, ...]] + """Tuple of strings and ints identifying where in the schema the error occurred.""" + input: _Any + """The input data at this `loc` that caused the error.""" + ctx: _NotRequired[dict[str, _Any]] + """ + Values which are required to render the error message, and could hence be useful in rendering custom error messages. + Also useful for passing custom error data forward. + """ + + +class ErrorTypeInfo(_TypedDict): + """ + Gives information about errors. + """ + + type: ErrorType + """The type of error that occurred, this should a "slug" identifier that changes rarely or never.""" + message_template_python: str + """String template to render a human readable error message from using context, when the input is Python.""" + example_message_python: str + """Example of a human readable error message, when the input is Python.""" + message_template_json: _NotRequired[str] + """String template to render a human readable error message from using context, when the input is JSON data.""" + example_message_json: _NotRequired[str] + """Example of a human readable error message, when the input is JSON data.""" + example_context: dict[str, _Any] | None + """Example of context values.""" + + +class MultiHostHost(_TypedDict): + """ + A host part of a multi-host URL. + """ + + username: str | None + """The username part of this host, or `None`.""" + password: str | None + """The password part of this host, or `None`.""" + host: str | None + """The host part of this host, or `None`.""" + port: int | None + """The port part of this host, or `None`.""" diff --git a/env/Lib/site-packages/pydantic_core/__pycache__/__init__.cpython-311.pyc b/env/Lib/site-packages/pydantic_core/__pycache__/__init__.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..71a43d3af8dae614a5e4c884e0cedecc134e2877 GIT binary patch literal 3720 zcmd^B&2QY+5r161)qd-9^=W-`3r2w#jUq1@B|dBn^ATf&j~b(V%oyY2#yFoaCV1H>^GRcpPZ?8u z+L-1u#tfe|X8D{k$Ilt(_`EUC7mNk<{2_OdFBwa`VpRAC#s~boab6=#|LQ{5Wjpgk zu_6PWW!+_d(OA)lH>6fHS@qfHdhGLH{}ba<$3745rB?gIF8p0Hswwh0v5S8tc8Oj3 zhfc`9;Fny+Wu+Si-N=CMiqegOZfroes&wO^n;6htwNu-qT7HdNR5e+!JkJlU(DA)s z3)cEg@9;I`g;b|x{-)RuHlJF6viRGE8#=fBAlwnIocP_LZF!+nTW#ZpUNK>Z}$r`wy1eU~;T$wd2`r&+(Wo zCkI4d9@g23H#-5l#r7<4Ulz7&j~Ta;4M&qj*A*t@NFsrq9NP-vjp(+|nH>7Ex#8{k zQpYzR>1ZKd$zuwpdB8*fYtxjuJ>hfntHAeUCiD|#yu(d^1hcCtQ9)HM zQRUFwzU9=y>NznDGBJ;^fUt-#jxdHWfiQ`XK^Q_PAq*oxJrh|}9^7J~<+y1QA*4Bk$TTOzM%`r(951Z=xdP(V z%G%o6L#exdP3k<@m(+yXkZH%OH^TP|W>2Ia*bvnR>K?Rt2zS-OXIn3+%$lZWaRx^t zZ<^e<8*m0pSv1YB8aa6wyVXBf1#V`!OxHZnthfza7(ROh;Oqtuci&O*c?SKa#W=|!T7`U`zI zIy1cw#bxw%72ztv8p4MFTjCnBKSNM&^b6#0Uj=^xCb$dGAIA$3MLMDvV){6ytC6B3 zx~jtX<3fjfoE(z| z3XePA6nkcYgqdA~q$4)R`f>${eJCfpCdbcEjkSFG2`Ft&ohm^%7hAr^~B1K2^N=$#>zg&*!a&rFAiL;NzuR-&J#{!Q? zw>=`?Jt9NEtM+JTA^ka7Iv(;k=$n^SYHwB^!=h5RL|F0nDprN#m%vpe-1*{elK*Bt zsYMm@Y$IR-o14tmtsr>n3tLjOZ|0Nks;p?;7vYxp6*zx7=<6s$_zV1k`vCtt=(7=> z0Xm{HG5sV~e9y8RQKTbUj_I{n@yE-EUP~g2J5|@PL+>@h2Fznq=pcgOa2P<>M;w9? z0XLzd=Qx(4EOtLiux{m8;=Tz5z&!j`3B-A2)mwF98AW;X_&WhB!*X2+ z2hPf*_o;eN`ROl|_t{UA@peOOgE4+V28Ss^+PbD`F*zUg(6!2J@{6b6>Wh&MgZZ;)fL_s$qkih#bnvad5a|ms{be*jujpFT zPi;D1fCO}*m1*A?*Pzi2!i(!~Q2Opfb-93+gYcsH2Bq&#RP&?S#Wop)7kA#E^xcVS UrKo+>CWC;MAbod+N|pA10pBIiU;qFB literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic_core/__pycache__/core_schema.cpython-311.pyc b/env/Lib/site-packages/pydantic_core/__pycache__/core_schema.cpython-311.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5062f41f1692b63be11c43c87c82d0f3dd5246ec GIT binary patch literal 146328 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

        ~ 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 literal 0 HcmV?d00001 diff --git a/env/Lib/site-packages/pydantic_core/_pydantic_core.cp311-win_amd64.pyd b/env/Lib/site-packages/pydantic_core/_pydantic_core.cp311-win_amd64.pyd new file mode 100644 index 0000000000000000000000000000000000000000..a10c613c0f4b47dfbecca066748b39dfe227cd07 GIT binary patch literal 5021696 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
      2. 3BgH< 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∾uT>q|E*fFl;xz9dExT!hTWlw3;tGek5Aaf)kEX@wpClb_I{<;Ms5r zm0E_#FHfzZ3;IgWd%LW8?+p8DXXx8e=>GV5iqMTZGA)vDVRv{wOq_n6MX}|l35((n z@MY;!red9OeL}x+>FemSKf@7vIsAO1H>h0(z&Zod8M@5z75G-1l&)IkLwE2uO94C^P)?9ojCk*3^C+}I5#DPTw7{96^^MCabrH*akQnMnoTCzF;etwJ`~{xCQc~0! zNY6(t!8%mDDfnTA_^9jge+iC-~M_iKne_8TnK(q$Q*c{~Dufr8XSVJF$9#3v#&R#P}EMw8Zn0=Sg^O zGpg{HKfEEi@Md^j(=$la3_qZ4Go~amtWX&=<79brd*TfVE|vZgZ^{R6!XUi{NvMR( zM0MOq8c|gv)%nBkHq*0XyTF6UYQ_v?L|?9znp!mDWfp9KLLQCR!?gu-H?Y11jsM04 zz&f!O7f6d78`-5275JJ(Hz8A)Z8ozR{K8^%gqR5nlkuj!_KWJ>hd`cmtmbA23^)+V|kB%oEp8^1iG@64cd8^zf;DiGI_GM z2o$!Ci?+Zfx$A6hU9fESN1c78+>`Wm_Alg~#ICci!ae$DA}*v1FSa3Y0VO=O%CJgY zitxlAZUf#ePWt8@U?oXWz8H_g>mrxq0*)@>#g^O*Zxx5kYZ0-*;t*uUwEZl+<_e9H z_wpzQOl4KYsw&lo^?XnzU?C7m=hHHrjI_gtFSHQTUJ^KCo^rC927l zt*T0TQB5$pngDV;Z{L|zO&HbGdzg@UJJiKpt{$mTmp{2KtX20pMsi)Dq`Jub9qO8y zQrD~3C85XD3!EXzbxnsK3_{P~loRR)957_}nAeu2+F6;|D0RdomV6-J6Ug>Ry9_ z!|NmLBu{I)eFS{5f1&V(`hP!2n%Uq+#nv^-NH}mSzyM|?c)~z98Bgsefu5Az)MS8^ zR0J4NuAFcC!0j@dM8-U+)r{%Xa&g^?xjc%i9R9-_=YzpK{kOB&-hLodw5)}gfNZ*z zH~PaekSJP^+aKefiePdC2a+gGzybeSJc&TXnLu=g>!Sc#Hl+aCUd)R8W3i0t6-5>S zWHbPAUt|JeJ+*J(2E_B)e)j{__Fac!jr6n30|i&`5A@$Vcu*^%7^^y*4dAn;fVhul z&@pYEd~4Mtk3PreXbUTPPv3C;bw1zjOT1x6GyXvo;skPMaxaJN2{p*BGZ<5Z8WD`C z2rwc8ekl}uJzY`o$t}ksBm>^X_sWJah-2_QR_Ic3yT7JhNkx9&V}R?`V7*i}?%Yr$ zwW0C9V(dqZ9uQ!fv?VLqwEXg4X!(^@u1^|M11cy|r-35%{vXzWek+}$PZw9Ms$4gh zV2qnYBybEIa097HH0OqPM#OC1BZKI2%aDAg>I;;@JNK6eCMdF}$c9H#=Y`otaIaF4 z!;uLOfkKecdR*Es?fACxY#?!3`%lIASGs3H=O*UUw(GBnP|e;=t*_`{<9BJFgAX|{;QJ~aI)DG8AaQYi z>m-mmcq1c$eC6*-C~o;FtxjdvC>7Po=HJozGI9R~hAX?>SXs4)3Xi_QL*Yo^!XE@rQquYW zlc&hgQi6VVYI}(fzZ=5xF$AN&Q_a5j>FS3g9~5rZ;?5ZHyF zi12~4u%2U=N2{$U1svEnVxpgnLgjKpqc8--Cu;SH}5fQ(H zEo~~RjaK&#hQC69E>Z{pVZp9tp*Ew10O6M;1vs<=iHb1viPqQgJ1@Hs|p0uyCd03HUlg@Sak#bMU z*4anNJ!x5IAC3Frb#uA3ALCk~Tx8!yt8D)v7MvsE54UU79Y8%6IT1viw;mTb0E48U zoF$`MGjw^9Y3bWBOC1}-Id^TVCEm2>kuD4)6S20;&%sD1}X!hW`PqEyYjTn>GeJa z1#=nsp>_!Q1K(T5D-IgWQiU}JdB?3T6YJpX1E7p*B9tVs+yTs;tm@dwunpLbX6%Ev z5FAUX281uo6*6rgi$ZQK44F5;A=q21{ef^`DGDwr-T*YeNNm7X02@>>9W{O%3wy`U z#99g#p(xo)%MW6z2hmbBQ{g_u%tH(QdkCjS9`s7`5)&HH9L}qlH6am*BklG#^A8o}o!%y31(Q*fJ)|`&$$51APAy-g~kevi+ee z;;Q!3GtE1^;0Je^$0hSEf|*{uN1( zh%J0|awP{RRYEC?RZ^N#$)m}Yh>Oubxsr__nnK4ERTrxyFQt-SCRZZ9#XoLMqRC2B zGQ55+i4rTnR)Xjf=5fEkeJVr2VBy3*3>I=Q`Z*1I#bk!Q#dxv-HnRXrH^h5eB07_+DYqa9B{^DfQ0wI;>yJ_HUGeO3b0LS({rx7r@T@w~J+7#>W0I4?!!+ATm&V9p3=h z#BZTTK?tevbX4em%mnO1DSlg~YS{(Kh-(4$q~hNz-y*rHrv4~7hJLj-)LX$K*w)n2 z6*q4IXvsMoqrq0V)xUU`vwW4c#+;MF$wf^@IGz^ixNQ}8Nn zJRfU~)P4-hriGMj|GkxNHDp)u@_2pTC?NK4a_{VaXb1b3y`A7A9emKCJ34Iy*^xb) z)IQlz&3D}QdJ3Bl-zVLAWY3;e(>9ZI`&uj~Yb)PE6IRYYL=^iq9s8ac334L9B=AIQ!3Df$)YY3D;y%2)cF z{^t*3r>{rHtpyLmkPoGw;Ou%L&)2d8Fj^mmTJh=*-0YM=V=wl1Oly%;qaU(p$P_ z%t6N3+QnHAa;|X;d)LX{b%J*t?Oi!oFdvly#|2(e9m&0kqFvC2APX{tAz9AQ{~%(5 zfD-Ou+lldOH7GTSnVK=mfHjRRtjsg#Dag0QUgQ!ZWjTmDH9huXm6Q-?rq$RVsmdkf zdkl!<_?B})PvE)D_y&*s;SI5pH?PW@^@%r=VsF;54!dC7F&x2o!Uh1CEH44sfpE>h zzu_pCJQ!<{{0g!&%amA_;m8uQk3NLuU)o*0498yL1Q-DHA3XAhVs)`Mf5scGHc^2H zQsFO5p<_5ZmgiHX;G9oTcNR)JjTdn}Aa8w|@hnCG_?Jz;WxXl`@Fj#iTxRw7q^x%$ zD?HJpoFVgToJ;8(bwyGxn%aohGZ%Se?e0uz}HK6zKL*P=2$ z(Kdts#WwL2z>~J1ft_F1a0DJEwi!p_0)^ec9-vLY>bLKv25 zIG;i;LL=wkV)0R>4$b&G-&nSSZ=18KAA{X(kWN;rhWV$LdBZ$2MGMC7iILjlwG9Vi z)yWX)TFv;9Rn;U;7*`-y&lnEIgYGfGH}}Mt2nr#UqsM_rm|2nos}pQL%*^6}Nog zjDC|&Cyzoo1FJWM>okMM%c*9R5^`@=26P$H#f>};Rlz;rd8z7yNE$@L>2fP>ivYdYM_M6XoUVs@R9g#puVe*ah)odGTVV z=royKL2J(>7o+FKVny*{%KhU!hAFF*-Mv+7Ke;3cNGfj@dvaz!tV2Bw2c(>zTZyxQ zu^b(a5s9Bfby6JbJ8{sm$sI2~R1FUWV~lS8J!G~4q~DHAs@nqz$Fe#j*ibT)AZ8J@8i{76Jm996+IPUK4W#?W8;(@eOqZ=I}q^xVj!v- zl~mQIE>50GscH?p_ITIiE38@7`fFmn!GnS*F1JC#@DBACws`81pc28&sUJP&Ar*? zk8Wk!m)H?@NBJ7J1TQ<-w~6&{<2?TowpSImxG2Nwij(?*YD}nEJ}yP2cI97os*j!J z^xH4?MeQ^d?r?oqhx(F-lkt%hrrX;e`;uIzHoQp@>?fM^Kil7P?4`7lnGuS~)PIUW#bX7WjVz9<%zHq@~gt>eG(EybC? zux?*~;acFtDR+pK7;}&eEx{-rT6bWfgmDY`Ca%ss*L@EkZmL5N)>ogxPYdj=mZp>k z)Vh@NB3YEuChemLTz#xhxtp!Z`V{s9co$By#r=(y2rHLw(FT@ z`Mji_cijG>ZkJ(yX;&|!^Za4F|ZfkP&os;D!dJqm)*n-m4ZVTdn(5w zr!#3r5rb`szH)}W9PrUTZ{UE}49NHkqpcFI6E-hGIDA-uBa3d{hHob%I@u%KW6}P; z_Wjemh@1n+l|>XoeNg!X*la`}^qK6DcY;S=KEs?;pBi|Q&B z@;*EUMs=@8*FohaZXe0H)#)2SaNsIDbk-lrS1wJ&xr8Aw&sm_iO&3NZc(N{c$xDeT z&+*Gp;gRw&T6g-TlHMTjjav{nhF=&3<9eOC9`} z2-wJ1WWVr-9LVj;way-=i*#YXFrrcArQs<>yJ1y4@$0-zcrlXW+l09X1K||RN{uYS z=ur|sT|K@nxD+{{voqWl{D>x8-2cF2E`I5XI2S)SnOxlEw%~h_&6#^gk>*`W@NrYHB78f$f?M}azbp8d zX;gh&dTQsL^9$J(JQVSAwJUgu5;HqbU(#_m!9=9c>RG}+@m;}*^#_W-VsT3uCzJOB zpA2xa+Yfwbj0LLq<{fs4JFl&S?5bVBpXPPk&6~pSsqnC?oTGgmOF-DRCvU0cllK2c zH*I(SZ#U(o@eX!~$jd`ANR_9N7g1z(!R3Dvd3kDy$jfmsOhsNk92%1stP(0OttsuL z)vi>W=73%ZXEMsq*iG##NLHKeTIHDwA!!yPxEX9#w%FKG=hzjfuMec6d8-m zb$f}(XobllW8%zOPw`Lubw(m{8L~My-VTwOLja`XC+E61Dw#RD88UNXOlDpmlO!{L ze<2|=y$~n@mMJpxW7YO$<~V!_B4l^oNxyDtLS}w?xyVdk1mBg+*pO=sO?KYCFL#ug zW|H-BDt{&IpMM%Yp~O{S z!#qk%=Y4P?X7QvfPm`;4kW^la0|Z^%&~D(xXh9a1*J?i%fMnH0&8;Pn`lA6x#gHGg zdt07EEcPQTo<~A078RaE`0OzyNv4u1YkLtXEM%>=9IgxNat-Q)bs0dSGx!&@E@KNJ z3gJ95I2tKq0qiW0OD{dTf+iP{+aEbR;9!*qsR1p7Y!n`0CUa`F4 zVHUwO)ZY|5b5k83BP)aDc@725r5DY8AwHTIo0BI#{z3>?r zV5QKp!jvn1t1PyQctozw&%f~(*0BT6uGASl?|s)k2p7*oX2dV@PDJozF^5IxpoQpp zaaL3TVO^EcS8r21anf{2SzQ&JJMY|aLKi}{hz9Z8!#xW6kjRp1%_Vm;rlI4S=mI5s zTq02=WRv)(bN;iS5n7MyfW@n?5>`aq=G_yZESr}eoLfvMRx_#^iLR4_P7*{J1o1V?dSXvlY7VXbBw z-q-tIn^)$0CAs4^?BjLZQWWacao`1M+Nvj{aE(X_{@{L&6PV;{dU%>70L>%DP<2EY zD--dzfSIise$T9fjM)~Pa-AbBCH-!93YMEN+$Z$zJwV|Pq)79q*EB$0ed9ZCL#sx0rx-C`u4 z^?X{AGh-JdN6=Yhaaw*KpIfIilW?OwvZQ`SEh^Bhdx<@QCRMxXQJi%j;rrp*!UtyH zDiPU<+T@nu6Sa5!v%eqYn^>VuTUP(DftMK1$etBuMM*^)Zg@K;03Ck)o)}P8Ptp#S_cTF@u727amzZ6IbtQbat|9N>@% z8o+C05Kpi9zBiR}WHugL<+RF%4)kaVY9PItk1Re1SMar*z(7qSViHq}YW0LQi)_$p zJcYkG&fw=rUX=Au;oJ|0b$p=tmYjGi%l)xBR^~Pk>=;@cb>7)f7bY2o`t@Wn^KA^AFo`v*|qnJ{K zpI}dOXvmYZkwL5JkH7W)flqeOQfFzNq@2d;I}R@%suflpEAe=e8^ZxD#OAglC>jnm zIC<$B4mX8uy{MKdG8t!zs80T1khlMe$~n&b%@^bC7v`tsZDvg3?R4V|KoZ`56uUaz zrx9ny*jGm2m0g%->>wv#_QCxZ&b6lD<36^@+p8dBuv0h*Ud&+8Z7QKJ6N-`&HeHPb zEh*tkBw#zkA!xPp`Ju76QaB>$RAJ{=c@d6_$*DS&4%A@~|6=FL1%4m)gmv60Ebrc5 zzbVbW-R;KH6YY_)eN{(+BEtP_avwJN6EJEa-Z|ekp;aC)C{Nd?Z6}TYzTN#09eDQs zClkT4;3dKFY5`H_ctHC4!VytzLN9(rHi=$7=XgS%mR>&R@qcAWFVV)bU%Hgk(Y{e< z1gCE7=+sA<<0GS^;Ik?fpEb^vFKiE=HO~9rWr+`M0JZ;H@HxHxe~b_9MW5iKr{Xi( zx$pVy;WOIln;kx2YJ5RAMc%YkL^@_94EHtL(EKD zb@FBz+;>>-G+Ru(rw4{XXV{GV3=BqZEH-S@&3CwE9vc(k7CPl0`!P%4|MBx(Pqs^~{OQG%#!MZN163v>F&7#EKz3Fp`zgxusELO5IG=4a1bg^-ol-89GrG6jFm#g zHgjX`=@ZzP)*Ldc=Wr1%lZtHxX2S$|Y9wGd_N+x(Y?v<><)veHkThVkMl{DK=a#=A zP=P_4r2v@}mV-v{#046Fa~8AHt1jY=Wv}4{TfF%epU>bWUrv$%NMSzVD-$Y_izF~j zE0!Skl;eq?CxM4$Ak1&9_={>{S2>&?%GwD?U;VpE6 zZuviZxJ-dG4yB)m&mYx{`-z<8e>3*#H9Q9wsCO##;$IwlcM2U|7P<{L7~ilTJ{bNd zhS`WB(bze`=Jl)(-uPeO4g*g@kGZFSTpEhx(pbVvzO0r5p0mgy`3-aA(#T2pU~>su z;&lHu=L%E=QWI_6ypu0N=3g0S2$_$S;ZpZU9e;<{EvS&o%W@dq^yTF1lt_eb9pW9( z(u>rH?p9%b93z*V_vRirk_bh7&RrN1;^``uBi~_g_Bn-NT0s>&I!~C>co~gW8sBQQ zJmSZlO;^&K$B%`hiY)}$&a1;>iN*V}>LrLC;j17Q{;`Z*_#}$zray!ym=Mg2T3OV+ zymK|y{t!e`xx#F5KDd4x*R0_Q)$ECC>KlKHhYq!H{;Cr&8iAqj;hdm=dACu38Lfb6 z!&8T9xVXGSH7US^l7X29FtAG?4Ky!wuEx$Q#4PY)+4b=lY)+8oYz56GR0GlkJ3}+I zb2Si*6o7v9^F%*+@e$2f!y2)ZE``uq?a8RlBP_y^4*J0P;i^M{!dy}phd$uIA5aE6 zsfiM#m{}wsc07{hJwKX}TCMv9oXU1}0 z9C1_MN$2pwnbDAW9m0Bj2&}t_5JRK%TiKtg;`hHVqZUcUSu?~iw)66u0L==TvlCh7 zlND0t`t)V)qcLsgeeeRx+|M${vCLDd%o*v+{6>|T%Q6#ChMPD%3}kEo0R#y(ZXg=Q z*X%VS=#2|J@qu3nR0zf}@pLD)Nka&ofq(+1TUH_Z_L;N4fMin%IeYTnmSw=sWvkJF zmq5_yF_Lttji&(SM$m1}=YK>1N%mtLQVY5guFm#+acrL0Yi7&a$~=>`-U%yryY_j! zyrn=M*VbRYN03E%8D8Kc`kj5!Rx)dc@O!je(@HKdL?L4R9DBoCxSotm2K2BDC4ee$ zD)M@7qq3(u;I>2iEJmMjgr9!#knWj%V#kkikn1{4&9lh*4HcS>g z@g8G%kO~-Q=d&5&BgfZlspw+0O$;!jc)jmg5|nJup9%p#l#oe#95T1$!xYd=g@9owqP^uDQ5#* zYTcSy!n$d{t`jA-HTjI!k5rO(#w#nt8Luq61Z6pE!!NM*@fIk7Xf(vs&Yq$EfnN^7 z)Ynf*H+-%O7-NanfdhHwXQNakXMXa_WY1rWbz4|$9KvE_eDqF~ten_LP0j$9Xp(PpXk{{V8mzxVGFGukCT^d?Pl zNV=W(=Z8DaH!npBJa{YgWv~{nKqV49 zdA8(Ptx_{qVjdFDTx8!cCzj)FrXY6DZ`46ti-%*HsVD(LnEA|YL2%IIeV)=%ITd z8G2~Jyw50hpP)w}ZYVa4#f)1B_dtf-3YtJ=vqKK$@%DEvTI)G zALz1ZPWj-KA+C8n8zTm-^7C=#0v2SFh2zpg%UVefX&9Ft)OE*8G%WLqQCItOD8vO+ zlL6`!Of!T*gZ8U1|2-?AfS=hU3RtUE$}Vp+kBU&A&nRd1qwD?WC1nrCvda<3aBhAQ z&wduNL$9@B?riYNpc1v?(VY;&Nm`(CN{mlqW6UW^ObC<`6Rd4XxFJBx=k{fmp#{5r zLP?!0jO=gyijrD6!4uPaV4sB9(Y1G@M4~OO7OpI6AA;h`K?|++G*!IvQpF;ke2w;s zS6!S`^lKE|76aFny|VULUBqe%`-o!oBRx*Le6+~a6-X7C+DwP0-@TBjOVM2Y_{&{> z!Ekte_2ur%xJeqhMvQ`U=N*0<0OZa|NZ@ov*>>eiF@Sdr(7fNK7p~6n%u)t-5>hrF z3N%H^itye$;sviTiWP~9wdIm3X0RdH#Y5%nxys4Ta|jSYh9*PIo@Xmqp^mcrp@$}8 z#Ns1`?LmAFNHT&Or@-)J_sIL;%M(jO^2 zy}@cwaE_l0(}+s{uyI=`Vv`XS$C-i!$c8SRf>0av3f%rWwwZ5CVMT3njGLgNj`~4} zHOv=D!%o8_CJb2$%WwjV)}Dj>I6<8C=s0#392zqJU5N>{BMZeUVhY~KMn-kYr?-wA zG%aHdgXEwjrO_t0s$Gs8d--m`3<=YjjcZX$tKs19ZU9s2WVJY-ht=~IYv*x`2-GUc zx(0u9ux{%EdE)8Wz3PmQZ~>6(aX~k*bqtTJ%(-+Jr*>`D27RKxqAKOVk)N|WRByIR z&qz7MAN0Zac)`|Ot;UrcTl;7;r%3$;?%mX7d)4bXZ%02vFX^PskS&OZ@;y!om*=g} zJtSfEWk@1O$hn1=nytO7Cnwnq5~omRgT$CU%i#&u64!m#5eQl7PtK<9i@VH8-8W>3 z;;#zqF*mu^tlB(s0EUG_>&v)W zw%~)e2l*sQlOiIiW(-5O0ER^J%$P84RhOuvsQ4jptPG2toN34U$x~5#*l?T7AKg)` zXlTKyYp8|~L4XbRmT#SC@yVVRUwJ(AgSk0ORZ>gdO@XT%ht1*JTILole-sXm!*VLM zHVp?5V9Pi#lWlGPcwbcWR`*Sbhsn{g>X?^hcoX6=FKv87wIUPovV>Au=*n&m*}Yd| zEpTFkj zJNaI+e6GMLW5znBAiIbE@_$_KKBf%v8L2>RaGVo*=oS^F-o49lkG1{Gc5?uDicJ?QCLN|1hy1 zE~!3GGsfy0zH{|apH^XAWrD!-KElTU5bg%p&Y{cG%?@wZpG^zzB;t=V2v}e6`*iii z3~%r1eM)T7cF$5d<7-HgS-uKp^O_^b-#km@oI5)mhmrm)6`Y}B<73n2)E1nn0zn#! z{Wvf0jlE6P=YvPr;}{j99zW5f`YbPXG*Wp;%F62Fp!=$RZuvhoIyD(Tfdd18Iv{2I zGV|~4eZA^fRXdg^FLCU;fUo_fm!a>$Ti%%@`<#2Iul>=b1E}Mk;n3dNb9|`NA6`qu|nzM5lQ8pk(g9|qr>+olipkYFKf4t zdAyZW`A8{0cc;oj&#ZDL;@DcnFgu8sjv;sKOuTe0z63;KC&y4z+QNFX0+v!YPW*3@TOp&t7-d3<}+4>3EBTVL+e!@VT`^3>keX6 zhf0D?${76!Nj0a2E-UjPviLdbh_%ETa0Uh9c&I2cAJw-S&G<`;EzHL7Ll{gHA+HZ2 zZFt?hCvm}X5>MgMi|}l`w2T0+LX$Ak2sey0mUqlo_J%Domv1U+etu?8u#oR4q-o#VAi%?F>KLdKmC}9;Q!=G!oJRS5)F`=BZ zkHeyIvlZivPjX`Kp)r|ZYS@pc)j4e+ypK1z90LMoDc9Us2J`M%-709q9h7-9FJ==9 zIv-+^Qmn`b96S~m&~p~@V+1__|HlOQ*`{C-ZYxS!jb{KHrs^A5BOQoe zoV=G$AvOe{&%#@+b~W)+or3NC1V~Nj!}51NyiYAqXA4-XFh?#8^X1amf(zQYv;=?7 zXNzY`<9)D>TQzGxL572wL81Y!22SirjBFm(=Dace2 zEaJraTI2^Ag2iMx9S^9T+@v6Ojs&>yWs3L$u>f9hh&?Wtm@kp1rc!x|l<~>(-}NRm z9Oja7KHRD!eT%^@cWBV~)Drg4;S)Y|mBn zQ{KyG&O`8%89Oe*OPCUb0bhb+ZO2Q%|@UdI6MFXxc;(0tuZEGEY1J??UFOKatB} z2jZfe{)6O_cQ7w@-cRM}YX!G+H<|*;5BM7g75^UNktNng{@#3Q^XK5gUz`8OOVk~X z2STH!e-obT1*$s#cer=Y6C+Zh@gOXx6tw)aU^(NAk~YqC``jOCa}6zc@(tSLg?NAv zUi)|2H~2Ic3Gi_PxahWV zJuf)TQxezfFw$|jS&P2dtW!U{3p2~+b@1zi+Y~FJKItFYnJ)uzP?as|cHJyKnKrv0 zg;ghd+&h0V$Crf1H>6doovsQqd&q8Ph6?+F++cGZ)1iVu0cYhsba<2$N&~P>=+ctQhn+eepe?m)^~PA=3e&Kx0uYOTO-lVTT?CG$w#KB9tt1y&0Es)-3xLPMI^0b1?(NW}QShg-Cn7a=nH z3M4OcA_<=RA)8V;;BGisVyuGU4e=C4k8~}LO1T^}diu0UcKl ztH_0FG>Z=<18;}W!+Mj^2YV?zjiO_hvONdDW7|H=E*Tzhix5HsG35qB+kfwC{c$HB z+zX%ZhyNVA4t%S#)`7|BTvTul}-(gnSqa>|-yn$HJ6@H*6??E#m1;T*pNto7(u!rjX|G5Q1Scn=Rghih~2t6x;ftm@>2r6pM3{HM2 zFi^V;MZ>@zRQ%t>`eDdW*D1@6XoxL69`cM1SjCp9TYe<0$|~^a<4m}XD?_91;baoe zY7HSxzE}rEy$1arGH+fJGN-K#nG<2>oCyQxY*;ql_)VMQbyJ4$^IxUfxKp%$YzV(I zz_Fn1&O%)HYrFFh@6H>-?;L<zwJWLsy|i#X>%rF0@e zX8a`sc-0}v=Cs%w36g)aFdeKQ#B4(F*GBAWUzYw@)(MwmKqMW*rKjC<{;D(Ly;Q&0AtedWHhDsq+vqwAp4=|^A~&4J?cEz@h3 z=DLSo{R7U|IR65KC?}+Zvvn&cR;N~@c4@R!?~6+B_&K&edfIJ*oDzo99_)hLJ7iJD z3_WKR7G+rYRJJvyu>B(x_-@t-zQr)KeC>b3(-8b+*NK&sQ?^&Z%=si~KnHN+2NQu4Cilyh*Pl&p# z*fr?fSk+Cj0{n1DR_Pa70ZrqQ`A;Jt5_pOIQqUcV?E5xH$X${q0nDhn`aPIA?a2g^ ztE=DDax?J0Ts6t^6UQYAq43=nOJ4hoOfgR|rMxUgQZS=d%v2L}p;u-2HLN}f&cCe@Ao2lCM>cKJI; zR-OarJNJHB{c$!Sbt@Gp`|W!C{Ib6ka5@SyY;&7iW(7ytRAmh*P$zyeFZmH?5Q(!jPzZA7Y?BElS|KBy5lGS1l0r^k9GB*+BKwY> zzBgVVpbXE^JoDUyO`^;Ha2C5?9=U0rF>dBsVE9zkWUd>HkDel}=IHIJ7&iyTJ>SsQ zWY$P5>S|q)zceeLc+b}B%Y^2n;e`r%b%v4w6~$w@35L2XOGSt$m1&5V&XIvphhtWM z)p?C|`~(~Ez3~{TZ_?wNv}(C~MXSA&Uume|!)EHwOw_+Ca+y`XR_!E-TvBd^*{6uf z`ZC#6`{TKl6UDkt`TiMZi>_T;FAeZfO`59TbC0UK!Fxz*l9WFYx>K;xGuCCRD{4&PFRb*FRr)5< zoAcTYb14|URK~eIaw}!BqhzmjV{WQDqrtIL5S0RNww**i#_oD{9&!mU| z=f|exo2nQ0cu%i$cF@V4bUqT9$Z+d{c`Q>?jX-6Vy)NSlMv^I8DNR{)1t`4a9+`Dg z`^9)NcFDf>ftM^)z6h(;HYq33*~5|63-i-rR~cq|Yy^qpqq|=$u%v(D_u2o}LPZ?r zZ7OPvv9-n1N&x!+@=KEL`^5<*ZY?@{HH3f5pcG}N6#cbtzn%^5SLVUl?nbPK|!!TW{#ti6%Tv9 zs|WGES=^*+Ga$4_vn@fZb}b~VZ~Q_sexgfC$4zHj>iF#t`px(?%lQ3NP6YfoUd2;^ z9Mda=yoMH)3tfj^doRdm)YMUWXXIW!tl1BK^>SZ^8G^&fqpo&PbMje&*WzYnc=QRO zdhQUoC&xL8>hVzcuUdwtfrP^mgmkk7_Y#r1f;0uw`TbyF;d9DXx#~czD(8jqK6%zV z)#0$)d<$X&E7Xh*f^>5=j74+gJ3pZc>_yy=Le74?Yw2)9n&(Qa+Q98LkFM4Jnr1+x z=HD$uQjU|Jd`A&Uty(GAoAt2?_6^chWVtdg5exO7v{4taDurR*9buBU%Y-9Cn!EVp zMPmfyMO#7B$ld4X%Pixr@-lpaUtQ3 z*w+d(Dsz0iDuD7Sq|Pxm{f!0n8DkG_(EXbRNiH;Wnpsj-8bR-BBe-;B?92rHI!RiT zkf=6N%H2pt-~r(CnWsVrKD4bta9=Ojp%=GTVsa~-)-D#^$n)c+`Bv>#vp<#Kw--UV zt!9g@;Pc7c{?7Epk0;u06%x5CrG)4`io12P;=0>()6O}rGop>OaYQZSEAy&%GamU9 zf^jwZWqfv@2PVpd8#sSckc0&~siiI$F7p=*4-7x$PHX-){n47gva0pf(~IBM+IF+G zgeNe}GI7!aH)M$pc=g*dCV?Sli+}GRxzxIHNKq?i%CSpy|Gr~JP@kect^J*A&@IjU zwei>P8gz!sAIfm~!zD)XM(;mFk!h0BL6fP?7AL$ngL3-yZ|0ye>14_^io@P7bpNuv zG|ySOe@RxF_B7M4J6HR07za*EF3%5pi*#En@16p!7StESUhy44Y(bw_8m!fSRPUnk zlXLSex+yFDJcfaRuXnbSk%>CmS*!SxHX#-T7vP023l#E>JH zd7~*)-T}uF9NtA%c==5$%@jnR5|9s9PV93o_>iLrov$v!aQyfDjT>Z z7sNM;LlvAZT$iQWb_#~?uS{V0?YXRi{$7d=>!^4fH9Km@<-_zG)&sZa#*%zsFFrvp zt*RnL0KzIHrBTv;m)Q)+w>~~8ZC>>C@oBxZR?)v+&{+InRhN%qDktaxScIw9;H=3! zWNwSR%?X*g3r;_)cGMJ>cHtnRFOss}nZa+G*<96?mPN+AaAa^!sMeX`+c(|U#ir85-&S0OOwrUp_ZnN8*W0N|o;oiC*4w%k~w0;w8r zagZD+1qLN~0M7OEZ=ew%M^B7;TN3bz=K%d8;e3<&MO=5aZ0SPz_0E^y2g>F5?h^T( zS17-8^X1o_E5A<89G5M{cknV85>_zbs@%fHe&8}UyK6$MY^$~Ee*jFacGnO!{jyLd zl69pkas_tJ|@u~~737OZe#_^YSun~6k{7Uuy(8Z5f&&vl{ z&#Q;Y(*dhnk$4&YaN=dOFY$8rip0ys|1K~6=!qVftRaIRrBTMheV;FIYmc?L&9E!` zkgEpY?-OYg446webC#no!k=f6@WGGua7J-DBAb2{-#wu2P+>>+635drZ-S1*RU<8x1sWc^agd+74YMA(?h%aJFOyQq+5?j?H|*%?rcfaA&I2gWTHGt^ob<; zQW6d2?V&bFWR)b)3`g?`ZEf!@X_zEB)K`*~2nTIi>t0DjNef#ACJ*iFD@kGxORQ?l zaEbjw72yg;1VpX-B~m)pdin3*Dy5BduCjXsZveqAP$1Jsl1a*qNedr(e}Q&v^wW}F zjo_}cpH=T3Mzi(oUs>hEKIAZUOqLNuIOY%M8^uRatJfYEyB1zzLlkGJa9b~Eg7sQ! z1Se~3beIOt2Bt!@VT&sVE$y-M2H>BwVSzcBQa7S(CM+ACNk0@bg6iQ=Dje2kp>5w% zy>-cGBe=vCTc*&rZ@rgAcPy#OZFWBttZUDrYxpWjw}TWR#x~8_REcc<*3Gc8l2*8_Cz8@ZKDIc7wy* zDDqvy+^-jGGHl&dUB4xd=aOUza*=U@7*7qBZYXM;b|!0acyFc@6crOPC7%_(=pJM0 z-D@kqeXVcW1sj%qEBYuod-XxrF3S{(U{_DkKW&L%E5`bH-RqOmoPnIMohuot&!IR2 zSCxDi+KiA(D{T_?yP#q5mgr2Ws^&rpofVvX0c^-wfUK84T5YpeaSTYGYyJ#{G>UP$ zd9x6yHM8T@jZ1R%_-5c2jeR%4FKTOU?D2JlmYz>&*>StCbHlRpc%6Mr_tzb>15i7_ zvH;x><3yvb$G>kZdslzmaYD5|STi2Jz0;*^d-mUwZK(b`jjiUWSM*#QW;8OqUVT^3 z<=g&-w6iGGoA|m!q6rOFqLpNJ`QJ+ScoabIwE%igbe0g(;PA6wo0Jxq6K3VQJZ(ps zc(FJbzd9}JV0`U;^c*pB<+-r5p~!!VmIyEFhXAw4FZnVQ5=Iw^uuM{{=nMM}VOmX; zn%%Z90q!{i@G%9xA5)9CFRm^iHKrmNQGJKgR(zGu-)rof!>;PhS#ahn*2_KI1g`rh~iQY&=-Xu7~Q`@LR>y(CTWzm*{% z{tnQK6$-o*dNi=f^vrpQQ`g zQpl3ukJX1?-JZNhfV~hcSqsu#4{XPfX>Na&V%MRKrK_^VzwZ17iF^)4Y>wQ{#2Tbmc=3U4KX&0Vi0c&qn_ zVa*XyqPF}Mp$Y4ffe=a=2gGb;~;3pj~jBjsEr@;XRd2nyHCJaxA5<8J3?ZW=%H za{0MCpPvV07JFqvFD+*#%jE1glXcr3m+eFRtgJMG7jNG)DQ&@1YTaV_X@&zkm1QgT zSpW6PZ1%UMELXySm66;?tX8b}*^R7L2Nyk{*04eTwjtrRQ>=w7yD58Pl6|^>=`Aaj z#X?o&#md!6)dnNhV3Nv5TPvq6cq&->>ps@12-Zq`qkPg%W>(so*_0A(g;c2ZtSu)y zY{KG6-io@lt#AOsS;@1P-?I2CXTW$n4Q9%7#>u&=ov~-_fjMvYXC>l84#pSzs`ka> z)1h%0H^6fIVEDypfl*aPz*Cjs6o2No(IB_k;R+wjM@x~WPNS(j9h@^2C11ND7w~Fb zn?sT_lHrFVBP9G>%82~+qh0}jSLBmiS!2H9y#N31^<|~CzN}(>*>at=zO4A!|Fi2$ zstm+nx2>!v2gq$2DyF!gvjv^Tpk-OEV9u4Y?=Jj~m_e|2VLRI%IgKwRuDm@dXh>eT zjSyW)a^BQn0M@21a3_@)u^f5MTQUO)5G&ES0u)xF!;$h=)Jo*JOgA@CWh~P=yfc*~ z>F0M)xp}2--kznKi=_eiG8d7bMH=?^j`iV4_Xx(i@85v>MbNz#^p<}D&205@d6)!-gxk5z56 z@(y9M=RGqvRxfTA&$gTz1#_n8wv94EK52rjM;#6&ML~VAkT*GhC{zcJdeE-v9XsVP z+18@3MF1xMmg&V|MA!cC5PdCNycIOAfzA{vN#!JOpQJLk>k4*N!;32ulFEsIBk~B$ zX-bt!-n90%qYr%795(qyef`vZr#%?H{o9L^B0P)#nPXvSz9mx(WV^)#LA>6$Ob)FZ zWUK1nq$8L)ddVadt|uejs@fYz7F2cgY^amwZzFB^^I@ghtB&&Y^CgDOogOTY+h042 z1g?U2^x)OsBC~GWf_U$>F$C%b?|^s34W4;=@jITIUB!(asQl41b~Re{!xYHo%cI4i z=#OS)Ij3}Z3phUV6uL+}(FopQa~Hqsk*)M(O(n^O+T-kxgq}b0qx*NK#qhhjd1i17 zvffQYIHB9{UIH?)k;(Jf(%Ov6=&k1#H>dUSMpspjP3rf51T1H0Yi=zZLdRX(_PcD` z42;k^K4EHJp~o9paR)&}Pceeid_))por$Jb{FmqnykM{MkHWlW2UaHP;PP0%Cc6{Q9-E zj;t&i&XL;CieISXsAgK(*St|a-E1%lnq3xTD>h5>HupB~Ewon}z^V1pB*ScsymLxE zNR|1IM<%7MlQ0z#dBqA{L+E-LyU5c7D11)QXJU(?2eQ{*D6=w{`K@0}=1!TTxqNEN ze@~eGHHmSppLNUQQ?|eTz~sbw(BQ%vB>d^H`!-5ab8|u6eLat$jvYRD>izY171U|3 z9&rV)J!aQlowj5_srl&Hf8%xXLS8**BfH#09r3pR&ZO&$U*Gw6N zQlcXr_qW{TDA=mKx|NKh$`_b(GCu&e%u)^_yM|Vt?rSQnos+o(=*P~m0`FY>T5Lb5 zb4YC@QU`M;FfDhkmrihWE*qr@VmXj+SF8`Pds*D!L_}ZfDMn2xZ1wlo>_4E(3@b6r zci0+mxVNNwt7lrkKH1#p-)FP06ZwICtxRL5=D^)-*QyN9H@NXqU2#DyDA8^67Ey~6 zuk=460J|O=`R!{j=3`ZccWV*W0S_#c69t?D6Bd1!AG_IV_wPSPEJDeP*lhURXN5a_ zX!JaJ@~?OQR|beQ7(QW&??P%hzx6Q8F(Nnh(@N<3n>YYUcNf3o-9~5wstE5lh$=#( ztGLy3y0d6&sc+iYkX?IjqubWvif=NCTfI@k)|70Q=V~r{%5oKKUo?3YUL%&%KG85> zB0oF@3UkTrVt6%bEfm#ZI#E7&AQImPOTrOm^e}1B0mwH3cL4fZMZtulK(;H~Cj?TK zylP`df2z`Z(fcuqu7G1aC%q)*l6O&y=@*UE9lbKs`DMMmu#hUWHTEgB&LMU7DcnnS z2bFLv9QeLfBNT?EQfj<3S)=z!SG+DsPh9cMo>3%PF9pSK%%?#IqThv#6K2&OzcEiF z7B@;*;DOG7^GmzQU88H9L+rKADX64RBSv_zmV=b*YWZB+z};9A0^cum#p?&iD_rp{ z937c^&BONiT&eAIpb$L@OQ`^4)#~8nOPail9i{@3R`UTVh(vf0;e4@^%&Ju(75s(X z(W=+i%i;r#n~F>$?m4Bm66iPed>q4Gx5FszDA9ggukH*{w6))Qk}KGrD_i1rJ@|d} zT|VvL+dvUi2S z$q+ah5}cHuhekiEVp=zn-X_VBA@`#0JCdxCAGuouMAa6C1!Kd4u_3!sMDv`Rg8xh` z@OPx(?)677*1dA?(X zrT2vm^31lv2K9wyc&@U-GWx(VEQLxKlw)*!EV&!v>t7DU$=LkDLMQ(`jCs_ zu5mqD^&uibVZmkpCp`w2nTPjhLWKU|He1~0F-8AHziFiW+?UT#LSDZ2cb;F6ileH^ z?XiOQ~qM4080)cz^U9SwZ1PY_K{*Qu^-8qH+!@mOa2HJy)RhwzF<*{n|p_< z{~!~`wk$X%j^ykj{>^+idvoJzTlH4&Iig#2I=nVC9NH@cJhAzJ zboV>ghQF>l-~%8@A)X@Mrnvb)T|-nEgPATdPqZ{`+KF!CJwouA9QgCP65-t{uw2x0 zLOdvmT%u5hP)~*9t=~ZB=Z0+Ifcozr%mz4RBXEX0IE&+>ts<5!-sYL@LTUgjg+n2x z(yU;PuS{Fx$jx#GGjtB{p(xuvr-$BKAvK8gQ3@=hQr`M*Zz+wDJwx&V;zj}Dr-`B}hnCgO5so?> z%W=Y;4N36vbSnW`n(b|hE(0Wr|NWowZ6}U@Pl9i|s{b{7+c#L@TYpoU3D%BH>60rh zkn3}~V!)N%tW^&JSryGbSLk=Zg$8@Zm1uLx*6tU88vJyb-PZADAOGhHe%r>Vu{h{9 zcGazdk`?Y^6l7b;gG}tK>eh#M`MTRG+`jJiirLzlR(4;Noc(+}otH<_?fy^X<<3F= z{X@e0IlTNh#~%J9NQ89fY-k*=-bW z@;m@bILKKYdf1IXuB~E*Iz+Nlc8G{s>a>ZMZ&D+>Q*F(+2XTPM@m?EsastW$lau2i z|9m_p_PR%&{rGEml#C$* znUn$iHJg)keEFsF*Ek^HxDt9IZHDUz3Du2n)Qh)!KXnz7|b$tx8vYuW75 z<9V)Br5cGxqM`0658N4BR%DMcaYH@a9lINggA@z;XDtiY&A3Ig7;S%DnHZe7>L=UhT%-YZ=Gw>j|NVJtHwzoArqN97p-M_!gaem!vXDa>-eFJ+W=Wdulydh zhko)7hgtVe1Rf77fyWCX@c6zGc)WSmyy}nahAwK=0-NH8`=jek9 zy6FgaHm;p9>McPJ(Hy0!$s!T+@f}$nA8YZ0y&97V zwOgna3zKJ|9(Zyk37LKcn*Sw`M7&~Eza>Gz(N8194UAgO8XY8n#ksL4B=oi{Flq!F zvaQ$^8WhAiVwpK=1guSlySTx-SA==Yy`vMf>KT-1W;`jD8>XtLHPioO+xN<7NsGhiTtN}${MAt zw20qxuf$v9c_?BMFQs{2ChA=km66E$pcPf(d5);CiW-uL`ldux#~-dGW|N8;k%%eg zX*EWx5&y|CMj`Ws8hFqN#H^Q}$ScRk3J>~ILal&NJu=z@){CkGvL5tpJvLkJa|>|@ zp3h${e`)-+^Vh~-Gk+oeR`a(~511>-jGnaSN0BIjCUPMpOXia?f<{nVknB_MyJ*ab8rbRZ^+?jeHNObr9Ohjl3%GTI zJt-SFY@2kg?5GlUkqR7_{r~JB%t+8qMZ@U#nR3`)AG$KE=!WJgOBA*j5V0}sDFRBi#LWr2e7b9?rTh#M^n+sS1 zGg%cO4=?h8fr!D`7ptUJy+(a+bK5p)%Qwn$PV}tFlmCzGy%?)SPK69beXEq6Yf8W+pcdpy@rmy@|$EhT6*|v*LhwNHg4ftW+ zHOFDQ_RJ;`;+oHiLYl)=H}09Q+{KJjR)FeC5Ajqj0V8W_t%vx(;7hzd@DQ&-JW%16 z#}4Ze;ejisP9E})-H6+K2Z00U{*GPLx>0r^T ztcQ3oAjwMWvD$istVc5s>TKg-)!E4I4*`eN$>G2=VYYpSb;+Ltzb>*_HlO*G?A$5P zddLNLe1)t>v-N1R9_`j6&FWyT^~ksSS(xZ2d3{zgkM+3Add#sN4(l=5dW^RoqpU}U z_4v~2#8Z4Ri@A@wod9`TP}8{NTJ2Rt9qIxVInn(b8po$DS@_&zeM-mVvzgBY9Q!Xh zpVe?X>7=BX-mwEDLQtYUBY#RHdbrhLws-94U;YSjY}HqO9BBfd$@1IfGw_BW4xuY) zqaIZFV@Grv&(TlN_Er)za#DISfU$ z>ZFW?T7{L{T=8Ec@Gjm=w>DdZ@m3P+;l1hW<1%dh_J`8jX*6NDTsu$K98;edegFW0 zoost&z`TWzNwpt1uBwsAy!0}AybkYZa`R{O0qGa~P*peqZ1pH^k<9iZI}%wQeNWEX zZ)EwGbw(C-z9Cb`LTjav&=t9_M3DQHXBm?9f)NBqZWl0E_<*5X zdB60n#)$AMR5#<@T^Q(cqlvhZ$#w&EYz z)NekQM>G>os-hnyGIWWXb8+oveJPYRYqCfQ3-PAlDGsY{CNfsk4_`&`^mqaqdcdl$ zcynKs-}B@L8` zKWViMxyyYjzb!(-RV>}BP{1JPkzHh1v<2^c=Aq~^a@a**q3s&Ug8Uth;h9zTjuyy* zq6#CQP!uTOc;cR3pb zDad|gr(|EmWNAnMC@geSWq*pQYs&2%TeUTf+WNg|Wh0-iksg=AXwB(pDINJljX=l^ zDZ@IzjS=7GRW{E>Wki#!h1si;3ysv)9Cg_CkgC*tT?Gn>%&LZm`7t~=C?Z(tYhs_S z?odPV0{}Hx^kEh$l4PNOe-iL{I`d2V{ZByjfdWyf!keZf-b`IBAc_jylk`pCQx%d) zi@RNU41m&`tUpm9jfL0NjzUoMoGeMM;@!v|6C?@{ zZdM4s)FvzPQ?j&8b$`w$a>G@k(f3LU&*Lh_gfrYnF{e|Zv|_X(ePb=2XGs!&8J~3wS8x5P zOpuKK|DOLDE&PujyRHBH6A~y~gd>F;qK-DF?L*;)9Omzm>=5pWWqs(!70qDf{R*z= z8A0Vfe*la_nXpNWK|lNvNU&a1D}G2V8HycBE*W82GFr7YLE(i;rfgX{B`R0__R-gq zu|sOr=*y!$aT{5tG-*$WJ6JU%unl2WjZ(Aff5{(>W=6puIl&`%s8@ujau%LIPBC-# zz_2_=Jr)C&9A8L;!lqPyMPb)Keg%H0oAN)R$>tN!sU-1DEbfBg5CQLn(K}$jpHi0p zYC=$__X#nUPA1W+rz?Ivg>7OjSHs^2KWWd`;h(hX4mk^v-Fo%)s!d5AD!QA9DNXP_ z!lP=zZFHHD(t-hAm>mKc#UVu!lS1tmaQ3CR=9ER^0*V#<;PAPRo(q0lDEJ}t&ccsg zmIAq(g&)4I^oso0Jopgis!%biRgdC^1P75`Io(wsLii)LRH^h!=;<8Ulf>CphtST; zi5Gi5wfAHo42v!vYS{L^Tp0P`72=^AYU96M+8C%24$Cm}4RcA>0&`(5!h}_X^b;oF zNMwAG_%0aj3Sv9;a-rLdM9Qp!w8gWpt#eGWVg2-Wx+qW_jQtVeLmo216q(exn36zL z+(hU|K%$&5MTS|S2P%?+itkzhcalt{K%Y4B@uyho1&8k;5#@#??U|GinQf(gDVdp$ zM=r9$ewhptUh_1<$Upl=mH%EI>&Hm`5mxv^R(P$1pDp1>tonXvg|F&OzuO9*LEC7@ z5^3TUlD;m{J}Z5$gkLG)FA`3|m!tscvh?NO2+_2n9lN))}f;lDjzU+ZrkUepiZZ` zP0EPbv$r|STOU6rRXNP9uzRS~R%|wRmTnur1_b~!WSFX5a<18{K_Noy4GV$i1S*ZZ z7f}FyF&Q8Tu+9qmMQ>PrSSCv3H-v)(e|hJg6xYN1a-G3%F*1!ra(dz1#qbk3MHErO z`?H+EZ+2RdyNKLo<(y{a%t++22WO&?>TDAA=dprL(d#vTfLzMq%o|V15a6-H2#)^YoJnc30~sSleS73k(|NC`I&;(@ zF3!+RbegT4|F{T{(<|*Iq=5)CUc&d8_huxqJ4I@TDxhr-$LMzRZJO<}9bZs3$TKoa zDSaW+Gmj!^;~WDe>bdiAJHYEvN`eb}iSwmsz8w{QTa(l5cH4k>hnPInQNF|a9&*{xv|^X_lDp7V^%=eKA>h4PwOfP-;m`8z9lKpsF%?4-aTBsb z#KmZvE|ezYZHHsqrRcA{RPU;as${0zx9QGRuB=cRvbCUps-r<(fNWh<99TVTN$9}n z096-3H^ih$|5xAEM&CLqG|z2AVaS{1vb9Tl4O6ZIbGBir6R+x)Bf`ov{M~m|78f<5 z8Ls^#>R(AHdE^*gMFQRIk1}c9mY~x)ONk z{9(Q}uTvj1FN?n^dcd8B0}v4&7c{vG_ThOb&6s$1A>k1)`d#9{8I6ZgaMUO`MD@Bc z(K+8$u)~EWKI$Db+M?(99XQjN`ig+MVmQVGL*2z)+H$e^?P(DBxC_|C|G3_;ZAql6 z9N{i#VgeYpcbx1+Ht4pl=pJ&r;%{3=m3X}{m?8mHCM|0-0(0-}-7mnV?SAzR$zuHv^AUk@Xuh@1(s-JBJ>U1>aFD#h_flN7O4ig?#m@NUHg zM)AJNaTxN{(0CT89MdRn#Kq?%nD=G{)U;S2 zF7&J3l7+4xzsC|eVQxQ8?T)=_t-S%_yZ(C0iTKXjP;`B4F1H zwbB+#2E}gu+6qr|_l2t!c!d?7pAxRpKV*gPu)-Uq9K~+kWQ8xZ!hbH|irt!Sh367L z^HseUOG7WT!dK5!;ZYve%C8aL$BL=9e(S$-ZS_5l=mXEFf#E_3ibJKrU9fG@Rpr3x~eX{ z=r1t!M{S-WU5I4xdJr4V03!B*WPi(z<+b@<K?cMqKxa5ibfL<{Dp+2kE^2fYv@Bj06%=r58>C=Y$1YX25j^|1 zs+l*-RVKOY)VRr`Bv0xo&p&xViwsm07tKHwJ~oL8RBNpC0`ZFynS#R~slpt|)TdBx zi8PJ~UDE00>)3#%#WEB6BG?4Il`p1t!^77r^xk*_=sk`kk;2_-8a5KZbl4~1V{V&wX zGT^hmmi`y&Uk=p28e_Bj71t+Eq6H_G_tpAe$?}loe0}w=v`qulzhrBOWne=6t0STQ zr7Qt0$b3EZufm2C)W0rgNw?I${5us9I1zu)Hcg zwa=3sSSo$^|MdsaNBnC1>D5R4mk?+}XaEBJAJQK@`1T11^rfsKJ`f{P`hg&j=qGd3 z*!Xffa_6L+g7F0L6^m*x@iabs*5d!bvsL)WE| zLB1ctH5LbA`4!WAN0)i7e3@e%Hc*r(kvFVMV^1k>`nt3V>+PC#X%AX&lh>u4YrS2B zpu)cwmsn9$en+46oyp26)JR&FGZGd1JXGy-U(Q&UwuIeTcB3OZl-+qS6kM@O~d}lH~Uah2JZz!_n`8dgl?*X^$_p+}(^4A87E3-eftjrv(#_6cl@sb5 znVpX;sCRH*q*r@&ZqEYqdXCoT9)a7fwGXYc4;u5t zi@)_1`@Cla?3_Q#Xy1TAL}|V#L&NQ1A%OkFP%zs*%rPaj_yW#0hc3Qcz>f_i>8$jY zj1iHOm1i%$7cQr6s)atd&4$P&+ZCsspKK7~DcNj9Qre{UL*i}0{D>JS+>bw^8QQfd zEOOo}ZugAf4MSZ1eVy>wXsZV=KSdbV4Zg&`*xCK}C+bY89k;KVe+ikjHDl7NTbJB| zOxRwq$$n(h5YI@_W7(bDe*}W6D@E4o* ztaC(y=bdBs_5Av=1<^P7=uQ16K9Z^1CH1*g z-J%YlQvdL=TcbbZ!|waIjm#@O1yP^+tXs%uVZ}Ar5eFX`Yxl)-Dzbe0dwkuWd%r_W zXz8s~fE{~XQp_Uz?T-ie z2RAp{*Vue=Wx`lT?V_x@vTU1(?oZ-n8fl3#uMeCPxOOt$4zqCuumq6_QaFfybt6-H z+$7K_IQqXP^3WX3cKk29{0-@PU>4YY?F7r>;@RXUR`nRlTY>&$AlVBmCnq$q6Gkd` zGPcSXiuGu2UbF?!WBYRn`&p4PCkiKH1R;UtQ9F_GA~Mog_P1zqTl5cyhBl5T^8 z9|8y89+-vqr!}*tn9ldv5IAbxJG9(EqA5*6(WG8Y!Zs2zM>21ubk>T7$ULbZvy^w$ zMtF2pg>>58W+{(HrYB-wRIzhc((t6=`!6LZKw$y=e+EZSQ_YoShvwSNy67XsEBcwL zzw1A6ud)x)3YMbN?WHFi<>RkkuH-Srk09ekapKq++nb_RY=1AG_$_4`cJ-;Z6r@aR zgru=6Wd2?2d-UA+PzJ|caKLT*n>48wYbLHP5Z485G_P4&l!dqrOB=E6!4`PY87^}V zV!j>G@`3YJLSv`(&0hrauHp`D#f6d+DR#k5S1{vDPLy&hC+o$#wd!F+K$(*C0zA(e zs;NsYL^-y&k^3tmfF&7k1WTY+++zVLJvK!B4t~lg zZdyE5Y`Rftc&Gux=*`$VZ{ePcFow_KTq35NOEkG^y1b{N9*zxF2w%#*@=RUai~f$% z5!zvSf(Wu1DXWlHI*$Gq^=A+DSi%zSzldGpvbD?(P8)`S8xmAtr}?7{t<}sLxk*T! zn0I5J9y^`<9L_Kaftu)=n_s$$|J!3{5JEm~R>-%n714o=4k(kZgM-%aNZlw?jBytq z&}uHCOq7r&@u0BiT=f}CU)}2qlI7&9Es_SFX9gb5^-ZUqB5d=rJQsue|29KrmTHK3 z$SxO`U_70NeI8n(!&j$X(;z#)r-v}x^JU~t*+?{wO-k7NHmI-PRoMGvs&Ny;`9 z{@(}#v{u3Uh4DUln%hnHWaXP_Sh{zK9&}#LjJpEa<(2HcCnHX8XN`7(RlIgG59G;w zaOd*OW4h$?oIpRmd##$oA^1Ge6c>K4jRylOZrkDcu(q?nJv(3SR-*J!#7*;}&swPy za?_L6|29efhx$J){hIX$N8b);=;SKZgeLrCFxcY|Pp^{gM&)$+zFI5_%HOisG69$6 zXZ~YV2TU9ij2l)f?@f<5MVjOct)ED$$Qzp#2hl@1b#qmMgLwX(Bv;dSe}%S&vF*I8 zqDWiQ;0R`zWx))*NJnz)_cz=%0Zu$b9oui1j3_n3zQA<$tQ$`SY|dlZ>n`AJ+R)0Z zoWfei@SQQP8XNvXYRdD8PcWW4lO|CRAZ1}i>}jz(T;yOLu^ONN`=KJ+gy z;S4_EU2kaZ+zjOcEcVzxaS#8d5b>|+9{x>{B>hY7;or0{5<0&T{|R&xey+>v<|gl$ zWH)gXZ*^6Cgq4r_ims|@);IsU95VmD$Ck0*{Ogr2vhlcD4hJi~$(DmXn&ZB(s9S*o zr`qppkeGr7Vv=rsn?QltWPz=+8+hiV7E>$^LpZ#VmeI`9rHZ z;FC-VZ3U6j2Yvube~X>NBY6C;Bu4Zg$IR$Q{7grmNY9!W7l#s#`9y0&*c}xN3CEkOpRL^ zs!?TgqRQ5dQl)2ZY_2PC4*g^j?}Q`K*DbL>f7AER3amr1*L$VD_JMitY@bvfyHgC= zp$4NTpHMIBd4S7JaG;lHh&R3Hh~jU3w8uI;OW~BQVHbJAYNC_Fg1p=kTOwu?{t5Xa ziV9y_UI_(d9l~BUb@zSMKeH|U?Th{Q-e>)Fz~1{@dvfo+@a-hk?n7DYe4s=ywghL0 zt1bS1SS@h$zg42HBMDsNdn_C7;>e828D3V_>p;300>ae_;ZPb8rZo0$O3V*c%#cLP z%WUXjr)MPCX{Sh6m>Q!O34$qZSkNd^^xtYEGq8{LrIZyoJBc9F5*7Zwuk}LTd#Stc z;cWJs*JpVOl#>>x_;w7~j+D@9uDsJ}b&0h4Ph*o?hS-?ut>_Npp}H^j?9|#=G;86N zSprxt6XPxXwyY^9?2UX}B4-4OR@*#dYRhufKKP3M+arZMTr`pum@%0Rk%KcjYeR&N zC-ZIQS!zf0%X5-DqGv*=_$47h=M#<$ej_SCW|uvFQ(o*DvU)GG3QDG=k7KV9Qjpj# zSlP6i1+v4L!43zmXP33ZQA4tlF_0b3>cDlf!?}(f&X>?Gb~s#vG=!Z^h_RC$4qTYb zblDPRdahQ)Awp2dI?u4vLMGyn)wbv{cuKg?HrP)Rj9y0C-qu9-5ZO0^7XIZYmS+*> zu~$I{?jaQ2;bOjnqcaAe%jUhp_b}dg3XhaAoEPEDfJ58aGMuNLnM4n3NfRr3CUC-2 z&$%fntMBSdDQBEkN=7)BBL*r16&Pw|_jChFcBE@{1|n1< z$^P(tiR?l(`?4p;`98+kDvB1=Ikn`}lX2Gm)p34e>WSmroEYXbDoPpVXGz*O%=@ij z{>t@>*_o6koZVlV;7dR;;bGGE*w8es=CAY>se+y=QJ4u>QKFv(SZ4`X?_dHkp^{*I zA125GtH=&Ore_sM5e(1)Zy+fQQ0)3iWdtMdO(Kj!ZLMaG%%G%Xi}n%^;BxFoTqgAaw>^deuoGtJQqofA+W$boYW)R>#dM-Z{UnY^bfSEGtb9 zoEDfl`A9g!%jh1J&S^D&Bu#9w5iA>~<(8`EvD;Yf2$aeUpE<>Jf9Ze*TT?vUYG7$% zigSi(u>?OVmIlHS1m`lv69r%2zj41KO~1w!5l_R|vLA__FKL6BdsR98*q-Jr#@M>G za|d(yprjC{=gBt*u28bSC>QEbt^`k6Y6Dq5Z%=Ka9otL86nFnYI4L!&-R!?sa?gQpDQa|U+-aT*l~bA$NMz>;OH|ew z$suQnYLq1k)t=r3><6bMyGV_)(doO>lJ&5^JjiOZ_>z^m^PJk523}bS^wGpxh>UIt z2C+Uqr4ufz6XN|c(Ft8T!TooLQ^e^r0w0t=B0FNjD|(2*>yV|EXIPp?_y&!vC-!Ug z^4z?C*2||ypRAX?_t+&V^jGxvJ;)0NAktqn&sM4q%1F&am#(+J;u1#(`sZsDMI`Xo<8oi2(UUcK&QH)*4bR=Y)Rt^CGOk0 z`kl$Lw#;KQ<|7lMbz`Ry7;H^+@g#pVl1(ph7nMr}*!Iod524S^zNIaxG`isg8hw|- zp0Dci_S^woRuWZf1CaFAWky+9JK4%ML{57nx$cR)MXhRC^P(lYLWBJ{Jk{ho7+E z=+{T2bRfZ!j!B8X@|KkNSh^`(hvJ`QF-mTh7*jQWtnnPs2i8t66lW=;J8=E%-xsb) zRo?BOHj$-=WvZYvi;i}Ce| z+-u6EiisU@f+D1L(+FPv=X<_^EM;lCtg2T3et1Y09=^Jyw^i~L%)Ba}WC|dWhY0y! z^*<-2e<$nzO)2qTqyP4Vzy1=Lu_bc&hgUGnnuO<&*=w;DVAbc5iK$Rn%9WR$KtV_k zh zn9X?l5WYQ$@JCOE@b3&u>GMfoQg&lXd@4*z`bmb={6)VnIJ%-xSYy#oo)_KzLUPY* z#W(x7Vf8c;ou)~tN@y#t179Q^q1|foWs;R`>b&T)y}3`|@0JL}7sB5uoa3zJ9aq4f zkCcA>xhgjoWXo>tRK+$gv06GWaZ87|k`y~lun`tG11W+NeH<>#nb$6kj!bVuY@FM6 zj3I33JFjyWbht3AnK}>cfEi@Q%@aF{iE=C3C|B?{+ray69A<@8Yklm=WbDGcl?UFUV*u>uR!ob{P^-hM0p-$X%U4%}_(fHgp zDZxnzCB7b?X9vK!JKb^B-GeG`wFe#JZMDvHyYCo&^F~m6Dc9Sb-x;gd)_4c0gni>B zeYz-_1Dk|wZH1`)SvjnV)Ma{}?a>`von(KV;?e-QkB7GWxC#P@5|oxDL7z&HT!Cmy zv%fBg>+*k?7JZ*kv_lH;+Kkb!&@YY_>{a-!;l3^d>bEp4^eD^;hcAf5F4!6@ol_?`%X z4QZZ<5_Dm7KSAdGkcKB$AO%t9gSDfyxJ50capThCmIg8|*V5%ZQ5MYJa$x zon}|~(^39?=z$Ht;3|%H){Nq$?Wlz25^8;R$!AXQXSaN2^?n|c&y3#B<7St7&ly_l z?(sLE?iEU?dtuCaV($@!tKJW;ojnwR&(PSZ(x-Fvdb>;vI%pr7hNjqCg~IqCkFGk< zDIM%Rr@@{0Gph+f0<#w5yVb6$ZgI$3aj#wZ%JHoe;B8oTwq5zz@vV!KcEhp}SO@vm z_3(~^i|01Fg3ASGN`0@7l;;NR$tmPQJTo79+%-nq`Q^^+L&Z7{z7K12yxM1m-8$+G7n-{ zCo~Pema9~B7SU9RnWCJa2Qxb-$<%ZfLeZwErLEpsPPtNW8{s8{i(4PQ-Gz}~z95z_ zJKXqQ0XQMjghoEL_A zV#TiDLT+C>j$>ux$slXDfn6t_6^3JThusKSh9q|coj^Q9N<}IjhZZiEDD!$2`YVFWdvarF6EPQ0>Q6c z)Q7x^13L*Wsc^xi-T&Ed@lg96bvo30sg|(775NEmUg|ic?(5|XM3zhTQjd)lJ?i%)Qk62o@eF5n?UyBOH%S# z7p?p~I)gDy_QX)O`-vW~kTVw=VSE$%uSX*}10dAzyhoISfKPVh#w|)`C3SPTt&@6O!Ef?YWY>B)C=qDjgjC0jE*WHJnp#r}V|= zb9vgBT!(EJ`hCMWR)vUq_v21je7uLoi&mPP@#9VO`Hy3Beg>q4pzrQ>n% zGW(RV-m9@Y)mDg_gsXU~w&Jh6xUsDk548?is(U9O)~54Xk2IKfM`{(t%_OE(B(0Ko@kzZas3Nrn)`+(MKT zxrFD^zz-&yow$z9@SJ0I`WvzqaIL~&PQN+Gs~-%_fFzY=ox;=KfIc0!s#Qst*_5LH zF8m0*tvDIWSrL4jA# zNvN72wuq$vRz^CZFKT|2Vn*P(5Oo?BL{KddD_n+!uOww_fuFR~(8qFBQG(E@<{##O*@LJV{NTK6)qZ<4z#4b#Cyo z>y&F*#5Z~@6N!V&R6KMvCDwBl5<8em9#Z9@a2sNK9{d&x%lkWB1^6NfVL>itEqH1X zmbh$(SYoK)25tFkln;GO#}LC+un`6`9a<+Kq&ZCx-MD=U*EAmT9>6zy><7%@M%Vfz zY;cm$qQ990Tc7#HQ?S2cvR>#4+S>um&~~F}8$KW|vp_RD;2GNKF52!6PP@XzT|47? zT-m!_H9ejNG4(Dj3Oyx8&7;L`ymX2&6p>1c_cN>8(1NW(RTV7kw+ns@-*dLCxk>Ak zy(`ted>?^mNujU}xsDjW8Au2Kj5x1oJH`@<$9VL$ zM~|4Gl-bWdO+C4r{3-0Aa?~YkdwGL}m8(v;W9u&NzMB6Ju5J4Vms_cy*8M1YzeNnU zZ_WRVn2-9!yvxkU5F3;iNrql{^4d0LET$>Vo^z7+Rz;0!{~$N9AuV8~5hwN0zV(&u zp^xS#sewAxz7egL>{|4qf=V}P2Q0?#-dEgd8{4V~pXUeFr*OAdG0EUnSHb_SW?hoa zP6H20#P z>G_zFMw+!cflvx za<1D2H9j?L`?Te9HJ*4PS`p%9R&dleINn0&6Zu(GOA}KixgFMBjO+Lr7;Tru%|rgZ zgV3fMq+tvs^%QN57P1G_&6{-Y3@$g!#W(BqGv-sVrHFtA)a@AS&&adc>Smmo7VRLh zwP9wRwi*lS6@~2T{*u^viSfqsNS64fH{Wv=yiEe!h-8T?DDLz5CjN?P@*&Otx|D^P z;s_S)(<=QO}}T!HiS&;`Yi1#MKj5#&Nz}(4u4QCh!X|f^ypg;kYm>XeOcNuOZMKe8dJ| zGX~qIWQ?fzt#_PU@Kuaic{5-Qxiu%=D?V^@E4#Td_KbpOvVm;mcg2+VcKREAk0 zB2bIvC+$h#%BCvM@7s(5n6OsLGm2v#FYV>V<@U<&;h!(r-kr(zwt|a^e%RU(0jT!= zO%RmpQG46FShbfcYH)AABhlU+a(9}IE0H!O+M8${^&XA+F-~EMG%4Uf`9HI+fm z*~Xt>4>m&W@INd^C}RxUVTM$}54*Pl2;|^?FosMXY{Y&TeQ%>=AOY zQIm#zmTX&W0geT&)&S_IV9Q61;OEv6(w=7icJMW4gw)Zj-lRQ{dCT=S?b+%%hg%0N z6k8zq$BdL*GDyW+y$9tYN~zQ^m-S6_bMbt=eu$zn<~{5kugf*ehw^lDMm{t^ws+8l z+Y1eI#uVs73CosJsp(ZVfwlST8A5drN2dKkv9@m{J}(pmh5}aj)%poLkBK5Ep z@+}n-jr`(Qs)Si83moI&$jv0^qo+!K0KXI{m3xS^YCLUmet`Kk*TtRv%nZ>Hz5GEk z$4*s1F`HzAg#$MK6cQrWpT<3Y*W2W3k&pQrGuGdo;kn7*ja?+yDQY#RkZNXdS}s}G z;`C^1#`^Y$kQ->q6EH=l$NmJjl!)KW1#5a$ybTC>rdGv2DWN3@am6B3F< z!ZWriuFN6t@OA(2vHPPd3G?l5^L4NEOjN#keVZ2gx(h3=k3LR}Be-}hrj0ojLrZ+0 z^dPJF+*{%64lR9vUSJKmac1z*tn_{@_1-`$2SwAtwGv;wMwax&(;~nsQfxcZfdQ>wl{K{d->@dye@_Xn&7C zHNlccDt@N;@d5hkDQ+=(+xsu*tDnRlM&&pVHug@Wsj~ z31A3P33Kcu@MZt=e+a(L0nL4*dO&mE8kubFDbn2j`gc_al*8=ANr0No;@L!7lkV@l z*pun+oaoJQ#T&Hh>k#kA^?7Enfj6_}eSV9MAQH*amTx78Yh795pX;^eE!Mw2CSF%Z z26AkmzjhbD;$Y9EERn?O27it0Ad>5uJ8;!?!SNbvqC5MTtLB*ZQRBXk#p&Lx;N%T> zBh2C|-o@epa@-d7Q{0gId9FTgGfw1=7`7g9E@;?3h86B)vy=sUHDvLNB7(lsj!Op| zCx!nn;@$;3s_JU|o(UNUNIZ!U8xyDRK?IQ`U=mOg6i?xe@6M02Eez`GXRGkrNW>==ZMq8uRG`0z{3Q^C} z<{EG%P2(Ue@ILsBYu?DA_yFGQI;u+1(Y!)LZCcSnw@D+kFhLL>+)@-gcy-`{Dk3r` zwrQa&_(=M#&R{~wH8DKk0c4^Jd#n#rvm_iWx#MRuDm0NC`Fr}pQ)6<;77;Hq{d10j z<9@~?a?k=>TXv8INd=Hs{D+}F&t22P_@jJ2O$JWlWIBnLQTzzs#24T-Ud>0uCEp$~ z)_NU7V=q<@2X?a#jPT)J)#u#Jr3mhmH>IFiLaVG9pCQ$IBeAqNu!mM(N+hoO{c~&DbGg`_q7Tlw z!Pt=EnoVsrU-w^p4u|X3pnT0^v22MFE!qPFq2IqaJG9&1#>=7~=uTwFoyuwDrug;x z0S>gu_qzWQDc#loGnEf4wnuyn&H&gmriNT9{jL-VcCyjh8F(Xp9QvMw7OG|DN$AVO z>w%}Ch(5Tl(@Qx%0#RGs+T$;aXTyMQOgfg5W3^>EBZ5JP7M{QhK3UXX5nGvU+Ojhw zDfsoV+E3+37lqYLT#)`zu4jmByl3ZDsb>i)?t;dB+AIm!9W{iTX?15nGweoB2#s*; z)4rd*Gd6+*SX>`}u`s&86n*U;`%gb5OMk&TZL)Wocl!6azvUkvFNHjbC*^Ex&*|TK zD)}7a$>8vxGJcwSnj?i8N||yF|W~HwTU>e@hE} zK*@McIH5(}<_(JwVm!Oo<}!?UbpG=$jp;CWoJ{FRdpCO4*5uS2EaNI09y1cJU?=8t zz8&~9c05IK;Xc&(z9P#TnJ->rN@C=GrFq$-*B(yL|HV0Vvq!IF)4oE%#iP7a3rX|| zAF&jfe*SSzw{Zm)5m!2)?nRtRXOE*L$Ky3%(p~g@yo& zD5YDpyZ*$|9LQnMe)7ou@r!w)+-Ty`tp6BBfBL`#j-Sr-f5E?H{*R-E6nAddOF701 ztZ;rAQ3(Jbh+H(dIsBA-M<2C95?+#jgo~;u%h0L4+T6|r(-T|$SNJ$jhrQ(l56WV5 zaCiXU3XO;TQ!QeGY_?tY-$?JC3>84Uwh;yM&B9ZBDE6!NbR}avB5Aglq|DG)QQrw1e@v;4KYyWr&Im zGhJq19^jj&kSaj{Hz?JcW#AJHi}}U)7g_SOdt6Z9#sqVDyu`KCe)<&^`iv3dzZ%X` zxF6q@V|8P-6kb1$FTu`13;RVHWS>?7onSU)j=c+`F{?&LCpF&tIQiVpcf$>LzG@fc zJgnfr&Qt|M?F!<@YHPxBVmdB+@#*8TL|qK4euJezRs5Spsfq=@JFjq;Qt2Jfx)a;n z5H>-J?;PviC{XFfV*=qzS)^5#?hhUw=hh}2u=&&@wIn+CyCeH+4@-sxJLCO`)6BkQ zzj1d09F0Fr?ROAJeSd6-7=BqeTsNAE&69vZtYHMHY~+ihhM*Kl&Sa3HFR z2V8;=v6HaUtBh()Hg+t0jc<=C51Vj{_(rTMvV17(B*=vX#u<$2W8pwXC8WyRfk(@? zE;^677Rpt1qL-6UZR}k;U4i3jHoQnj9D!p2zhHkT_j#Ii26E#4`JBC|4_ptuH&Wqf zKT#hPQCT4-s%p9*Ka>SjMV%CbZrCs@h>Ofk+njKyzxE`;c;rs`h>6g(b4)5tm$|S zZ<~7Hx97|$fPaXWtsRw-wgYYdlc2i5afEI;N3U&?k4i20BYd%M_Xc+`)25t&%yr3v zLROAM;289}Yv~)|5}Ir+gQz_l%?a1Ob=}2%9F2$aO1C1qnzwrs?Jg5o(;q;AsOO=1`8(;rDy5`|X{-CH> zSh^1nk!Pe8>qT)Ep{VJ5LQTP4iP|QisMKOg_+=6?=*oiZ_$|m3FtB6Oh~|ww#yb zL`sg&Oc@}gZ00mD|ZM_>Zzqq!V6n|u({29;Dh{CbpJzI>ySApgt{l4KJ$GKjKCF2XMg11#|yt^h)uAUqUSc?YXiM z6pz^W_2=7yvY6NaDg_kMh7}`-9&4eS_(gvSKFLd*Nx79GIg77hfZg~W(eC~m<-~wR zG2Wpfv8T?v-P$t^#AQ%oiWZVR6{9(%zuQ>Y2DA&>-N9Fi+`&zc^FJEHiMuKz?|RBN zEkMgCFvLEm08E2c7R|6)klHirKhUn#1Qp!*mBtSs>#qkaC9G|`2J!1l#vZWd;JCf z9#KJyivj6TrBf!0NM3vJSzpAFJqP7eL7kxkLFZ8mh5$cHB$!=rX0Wv=*zkC;VE}%6 zU|*B)3%aGUTzvH4Kj^(2FXl>u*S=N}wQln-`K1@-}|bhvT_BkyMXQ@uR9}<*_+FjOv3;h4>cpUyei1>|=3)?*9lx zIs<3%o6{S2?Liafyzsl$>=PHB0~RPxofO#s z&}Q%Uy?XSDB42b-3FkthpY@`~;9C0I;;&+65tiPc#|Qb89WYv`eddjnCQ*ETcq=0} zQqxD?1Aq6nv?x-bJm+j@u|g&YMU(mXf~_)oBaVJ#5UcvtO&imF zq>{F6!os?pSKBrivO(e%L~9@ zN&yvn4P`W{g}n-@mIg{yEZ!44g`a8u2#|O`R(UmB$|hoil#s9{A(LgrOJ0-;n5gZjymrSgkE3Ue zpK5L_6|E9G#2ffUhgJTyDfW#jHkD$WfLz-k-m7q4h2tpq*RfHgs+l^D7s0B9LhcYLEHd=Oh2ax~EDNn| z_>ww7Os%3K-{6J;3H{bQhrfV0Q-%AqJhll4T#@bg*OJk}tAXN$;Q3B{Sfl6%(5Rj1 z()y!!5+&3^3?cFgI&(w~RkCxg*0jqxSG$y`(@kyJbG7Mj%+>B_Tj>l8l4>onK~=s7 z0W{UpU4`OczRP^z=7LDU_IU*@-O-A=is)pc+_fJo0ofSr&|jjP{Gq-W_NG^@YSz}G z$*Z=U4o9A7YmX<8w@<757`V4+_2P`RGV*@#eW$*W9`e_5r;c~ZVG^Ipf3zryhPrE; zUqgP4PteN`qat-bo9!;yCEAHwNbsM9%By(f{;KkKDzpchy)Rm|K=7L9eYn|vcjGgRd|@RY!e3WW1FDqO_p5(8k57wEKTG3s9PA?#5R6VDEcZ+ zx~|H;3!y`NM-)_Al?2wKn)fyWTo@Uh-dI%~p_0j&mCS7k%c)Klh;{u8tx$ZtRlzFG zba!WS0^86XhJHsXK7-^AbT3P~ zWNjDzk5p`!yr?@U$+|9;x)?|HqW@&X*GooS)3Hq3c$h;C)P`R-oG&`FSIOv$JXQhq z_#)vkLPQaxj0ax65A5_}I$eWVt^9*AV#M(Cg&SX5=qbwSjd5->Y$}kua|EzLr70qV z+nB~0y?l;T72e_1Je!GchS#1Z@{}PvdU5uRE9(wE`ZP}i;mt6-V@F|*;qoIszjNHi z#oYfSJeY@oMIN?tt$ZAZS1w8tHm!kDjYLf&Xqv?PAZVI#(c!6fOk`-1`Y1{ya2qOKSLrfb;Ab4qkj%5Y~y^7x!w z272CiPR?BC_I08kK#K-NMnqLqA?PgLq(U5`Nxj4B3*{6k7pAP|@M-=X9e$ znG3O7(Dc+El7mNLg&neEg}K*DrR(Jva^`L;R@fntQ$(~=N0sa4m-SI%g&neEg&neE zg}K*DmFwk~l}TcS9kOGExz|hX_43R5*q@`X$hOMTZHeZ}=msIOxs|Yzdv6!ewT;ch zX!DeU_lL>}!qOTlNljm^a)CpHz{;WC_p@ya)aEiO5YD z0<@vxRpW!fZ3UtDZZ9sGYq=SjUR)*yxE$~pg#d{HvK8+w0xyCl;;}jUA=%;mD}HgL z&8o`hGzss6ZX%<~%IMP;5+XNb)QpJ>mlk@h*?jjwS={C=VRG#lUanJfoiSBC3)dark3RYznuIAAkePrlw8VJT@p$&Q}Og;o+< z5fUaS4s4^u2G|-eH3znfwt+buzL&AWzDf&jrD&D&GZZmTljQI@@$K?AW`u6(1+8gA zSZ0EMoruvUk(%BP{6!E|p-02k7%?0^5Lwm>R@0-z@R+|?E;_yL*b6tYY{rj)Z3|lE z&#p)qUZPd$nUEVg&@(9!&0E^yy|!gyRbCYb{ndjiMKi5Cp|UTEQ0;6%i)!;moM#hN zojn;WH;<|-BTvrfoFKB?&%esYQh15H<%jF6$HUfRrS({AJzA~DPU~S>k4_!{oMQt_ z6)RZ+csy!7?y(-XTaO#8$8782vmWED#~IdR2oEZh9fz z)L?L{=TW(L-6cPGWW`x)D@pj0A+sqQJy+?%c}jp!?a$?;>U@dv%UUh+HIaQcQ>~Yf zp5Fcho|L$h{p|=S`n65MjJ&0rA`hrssOY{4yoPr900MshMfe#sqHD|@-!?7zEY3haie1rjBzMitp`!l`SM(JFS9Xv<7=GAw*zb0)Dh);h8JNbh%~*TnaJz%>{c>0jm82V64X zqNgNYJ@FaR@#?b{o}Oq?EYSD`mBa=xPgHz*MVaLt>A>_^3*MB$yNc+B201P5tlE!H zrYY$o((V1MD%BGsA@y5UdkBZ9&P|LKKn;d!=-ePW7YV5;lAiJkhI^tipo3ry79X$@ z7m>)?*Ah8YS^6m}-OIkx2ECkn1smVzZovmi3cHv*K4U|xEX8YA0G{n$ zF-bPhSSD`6_v7?PCK;vX^EFjUw)754=@AuNTM3g=YCmRab`d)-%}IH+J2qciuZjpo zDq&oTY@$eVURuP;YN9xCG%SI;`6aT75Hb+(OWDU*V4+rI;s`Tzub1JK35OLiN^&kG zR1xTojk_8LPS!Cc4y~iU;ESVW9N-&^vWY(t2`lz$GyihJx=xX~K{c;RtH!7>c^z}_ zll{rrmC+YR3z3Z6T{-r}(Kk?ywtSOYo3b1A`!`s5>>_}}!qe4UI`hv?PF5G{&d>GQ zW`zPvZujBVX!)l7yUDrWO}Wz98k2L0$fn>2=Sz{Kej3tTEydgib|CF&>)vBRJ+N9J zkKVId=GB4i`S+|A)=x*Wkh5?pFZ0WPPV`Y#@W2~Ds|rju&LGI@n(ZFvr{t@QSk+WI zzqS{q1v&Vh3tcJQjf4f6&v6mnP)HYEF$HD5pmh{mF7To7Y2jl6K#snFQQ^`W^G6|s zxzOU#rhF|JkvO4mVc_Fjd@i#>3pLPD>T(9kRta)&TR8YkZ*7xMmd^;w1ItaRz`cKu z6k7y|H^v^IlsodeJNU`@Qq1Ouu$|S4BoDBkYfy|RpA^AQXtkfJ4z%$*jUV{WfxuQd z^cyXxwTkXYqG*b7h8+1dc$}uFnIcwA9_OJniqMCQ6Kq?PuI3etuoWrlnKbh-1Cyee zF8UauAMh0#y;)>&!B^6su4E5T1|YxmrYMLzMvP}AzU(gfiN|jWY0|`^GD+XOLkMm!OqMlNS_c+_q z=wi5Y1sN7a)odb|2|Cy>)8zCKhu%qYLccHg@d|z{e*ACnWm@}=}z%DH=^FA;B!L|=BT{&5*KbiO6+*o?dn0{YCy%+YuX(s`B@>@Pmg${bdVgahDv< zf9MS!hDH3H;@ISAp(sO=3{MY}9=YSb$N32wJ6_`Vu zw~^-k)2R$t@~Lbh%t}h(WjQ|HTmFu=tWBE02MkyD@T)WsX4}~MY?&Ee%@StqUv#6Y z)!MI2M=Xe4fMYa_3XllbQjxFxOKw(tX@M(VgS?F&XDPEi}qf zWiFmbLcf*|(jn=leX)Xj1Q1_{FI2(cjud4^VhcAgYHoM6l>6g{Da-Y#h1bw?&M8#S zqkl>DJbt0L*EzM>)2gDqe&h6?05Z55R9Tz=M?cKSNnBSh2n(8S&-aaeQfO;o&cwRe zr?M&9jNZcDgbILiQl7%;z2Ar{GHWT5ZBr5295?>CMj*AbXp~WpFRBzn?7J)ES41&( zltxQn%CLhP^;ljf4`aFTVYBFC%h_b*ECR z*<_`E`i4rM{SN6vB>fLo9Y-bWfSZ|jTX`pwMjahrkoN@1dxw?x8k$#^Lw1?7t(+f` zg`CZj^LWWQ-O71mI_KF|%Aj;g5h*Ffvi*|sw^zGYj-E1gxv$V;CfBIi_bpX!_6hpN zv?{lS>!IooQEb?|X;m&aPEQgYTjg7pCU-1!iERT00^XNsfIrdX?(q#fAgsDT=iKb% z+9pxtj&fS+l=%5R*4XS-ed43}s)hDJI9Qt>Gm_JQT_|%~yfPd3t3apfc~guF(P@<) zs%;W&?kIxY%xK^wt(9V6?eey{gfy!2>>8I9INhzR+>f9|-M%J6lPh}Qaag0G(OvM5 zbHMdz7bA!|c%Qmq)vFrzzRU`&vfrbu)uK*uk_)us5-GnTfa32NZ@>={lU%#ll(TfwF6 z4*vx@PRppJTFdiDe1wYl)KsGtZ!8_>I#-RYkHD^WAG@ z`jQZxp`&Q@R4WIt;%IBSi02}`2P!y9)unNcRcBGM!kqWMHE)Fgl^Kg%|6P?GI|pi8 zm8BvNrN~zKx2)Y;sF=x9#WfVM&m9`Q7&5tQ-%Fi4WDx6HnZ(-Ml~_H904Zt}d(Fzo z4mo$Q4=03LTet@<)cPHv)?#;UqmZi{8z@?cPs9mIAp6-q@p474YZ#Y*L$4@Nx426W zQj>iE0nJu3h_h^(or89-YF^!p>uL@`wMsoZazAGWy_`P`|4TQj9WTqV;d-%ykut_# z_%`&S>79!3d#@q(Tt*FY$kO<^oLW%F66&yY!_?4w;iobSLqrXVa(C?JLN^RW#f z!uRDu0+F}1=a)-nt06o>wSvYrL8DUn$w8_AY(C!%0AWVQTR+aC~L=eSajg#^C`Y=80E~neH@?!?ISmv^Cf$ilt&d`xYZ$o%ARq=rJ^woV?#jQM8AyVkrb1QpD? z%Qron9b1TE{@JY94ayQT_g5BRU+`Erlw#&*KkT-ISpF%ur;jM}eNk_r92#mRt(V7M z`#@~))DP6qm&c5Q-7JK<-`8S0V8tW#L>fhZ#tO?3N3ql07E=*<{-hgjvFgjh@zlci zkzJBumH%DL(W_wJNyij&^X(K&t-8b)de?EVT*c)*A#%<(go_WC@lExrwDk-a?{Sr`&0rr|$pxN_%yu@s-~7 z`rD1uxBprl+Vk*`$r1%?$Pean)8OyCjk|Sjwf z)#B&lA9T&lN~--rSWyX@$oJeYs7{sQzQb2s;u9g?;#hJX_2dPD)!^n?itnUWckBx+ z-_I8Q<-YTk$gm{Pr<`qoZ})p72oAVbWd4e@4C3Rpr$4h(6#fuc z3Vs_C{K@Z3{QWQdnVp=%pXJZ&dV~cem6QK3{h0*;R_q>XJFlbm|Ja||4P<^n;IZ+y zxgB)LZ*#%-75*L};e}JcfkK2io77AU_Q2oTV-@~{{$_K;>s}|nGx7Jopud6?{w(?% zivR=t75rb)Uq67g=%b9KaRet79ntYM3YOBrme4IUhZx;du}hFa9k<4(`< z5UyuQ9{veF5E;{MG2?hqT~8=}WZG{k+p>ocg_s zN3c&Aeby!1d5pY?>^%6KNj2k6cKEs6-7Mbs_Qqt>lp#-Gn?3k!%=R%K#pn`@cAx^) z?mAa$#r9=cg}gX-RjhWp_qU*5oXBtYpPf`!QFlY}5*))7-=aqzD6XNfFA^#in_exi zvUrJB8Y*64C)P+}X=O2+kNJ60ZO}tCfQNNcu=6}EtR{%uKH_sUR4n;1yD!vAD5K@$ zK3Z`NQfu(5!9_+v%Vn1ndE7RT#QfHWwM*o1{0#f;&G^Ym#1LiTJeB4VgO1Z^*ZYD- zasFyV5?QhqJ4RZoES@7ViOO_rRr$v!KPv~$@6s26P3@NKj!HIKb?0gMSYQ66F!n?C zZ_LeWss;aCTiIvswWw-_O5q;eA@dK@B?@zkg2`w2CEmf8=4$S7d4uP(>3s(X1qOYp zF$!I5bC$jq^BDQ75g^Of=J2Y(ja?+W#mLt9+57_@ixyA74#m6Hahhcv;pM)}!ZXyp zO~E>Mj<#Dq<-wD#cC}WeYzr3@#(sx#MHgcZ`KyVW&;;IIYHVnV^p*-CR*2$F?XID0 zH}$nCG8C{Bv7ASeMM02^Ag9Q@r=*Az^yW0wYWN?bF?Y=;&id?g>MD!z5z7snAKo#< z(C_C0thVfKX~-zZc~U7N>Xj*_EQkGroo8ubOD%x-s7L4J>0?ppKaqkms^`>CFFvbo zaH*bnSY>mS@em6;NdT#+}0>bNyr?=Lu1B70y5-4<{ggbx&aA*0LLR{m`pqo3rD}vD z_LV>yc{BErszoT`yqktPV$=AU`^mUxho*(ykkjYnVSGj5l;Cx+}QP8ad5RePGQmSaJ` zJ31vt0Eq}^kC{M zcH2cJT319=*iPH^shxMA?faCxU5ie%i%zoKpT-*L93(UO0!ZesoCETHvAnOb-c|aG zyuYf}N83Fvte1O}I0>xH5sJh_O1tYp`s#~b!)iGt4=$^Y!d@XwR|-#FYVbZmzSnv6 zmhbVSuX-ChS=OLmOA3xl8b5YPRSSNIHye`0TvLzc{`l?*_)Z`SU!vfL+e*Z^NejtR z+Qlu{6xhw<3YG|m(&Av+_5()XCJvpZc?zew2h3O&MAQNrj(TGa?01oLuOBbTat z%xX?0yyf3$%l1kOxC__rI>eiI1DWNo##^57FCMvj-57r0$V5NzKG@J|&X+#Cz(K$K z-6^*&mI<@wthxV!`6G9~Ala2)z4tKZoL|m8vc<$5&Rr2ojp1Xj+GF^+)NDD+^+o39 z=#j~c;Y$LoFA~QI3S(H2adyZkPEL*DtFZ~R55gJ6r=)H*in~5lqiFfPsJebLREn-= z7d}(WQy&sLrJZrE8Rov>RztX#hc$%1@iBz!lRZ~`xll~KThyAY8`E;E$_`;=E7b5i z0Wzbj^Uu*=K$|LmcVdjUkl>cNe+pXT+nFf1>J`R!I3L%`_(E>6llUP+TxJikH&TJq zA=j>o^f2F1riS^_vB_cnEK^n$$++A7kClQ>!#amSsb0ji=GqH$dNCbUXWeKm1&{#*p(v_517) z_dcaTyE}@=q3*AuTit~Od^=MDk@plNsd~zAEB_Jf>9q@tAs0{-hj5Kr@KPyLKUh4d z?XvS;(K9dZ-pD(=XWp}W=FL`l<$80sdi(aw>r#2&=$UsHO?88}ugd%To_WR3Mz_5E zRNmWq=Dn+D-W-+p!k&3&_RQN~)y<2XVpB4c?`Q(~QYKfPYA#DfQEHu>wt%_(&@1l0DyBeozaFbBOMFj+;F>xaVpfq`$;C%U_MeYLNBlu+lr=+Xs^u9I1+(p{KsmCB16{ zij#rjWzvX|gYz`JT+pjM{GL)@nJf3L+pI0=OnP)bR=}Fq7<@4qvsA`4Ju{Bzma&h@ zDE5L~Yt+I|(|3Fa$1lVYTJ7Oi>7ur5qTmBXbXZ-tmB5B9KtEP~x6BKD!&o$y;$k72 z-eP(r5o&gs4}Xj%Akq=jU|y^@%IPV0q#Jgy$vSuOcf54JhSqDiJN885!hXt00X#kO zMm$1xtP^oj!@T!K-tji>&CzW$2S*JUmIKUH`dUO%`MXox(FQyJrQv&({EZ*xXlpk4 z`nOj}jLL%~QDPPQ-$FK*EKNi${BiS8U<-P!cABoArl6Y+hkp=9 zx1B7sp4(-iO%(iV6LLj*XI!4dhZg!Ry@?$Xkv`SQ_%q!o8<)AvmFLLRjj}_hNx`o3 z#icUe-Am?!vghiWxv$Fn{a!M^+B0)MmHCWbGC$rkbB@ZK;6rzq7xc{BUuE9WOJ+~c z%mY;BCws|U*faA{D)W+FGRN8Obi>9#mHC2RGQZR_bFRvKQZJc*)-&_bD)X0o=#Gsa z_sp!R%$s}3d~VOogcg7{9_l6YfF7BvSxQiNTxVr25T@G-)0KrvF4Fpp`Nv@C2lIUo z<~zj8M)EalpY>olg5EJqH}e7aP=|JuzIGr#_^S~Hz^YLsKaxx!APv97WR$-eVFI$X z6cY>k=9GQO7PjKDjGkh@Qbl0N$s(1JuVWw5c)F$7eUfKgy5Wm5Igh^mV=Qm9&_O8^ z&3$c&CEzyn!V>kwsW&w+9S`h|{e;{cRn<>)T5!nLJo1&Ky%`(Ix3s=nLR#f@5o&{b zx#a(c8USX>w^>tuCrw|hnobl9pba^?RFMi&7q(OOmfv1q1`Elu>sz<6xB8M==nVTj zrIbj^+IcV-(5Nsg19py+r6mV$$%vy&`_BEDRy|Qzdh{aJl}7X9TiKL|h%T!-Xq0MY zWwC+{M@MHhgTr87w1i)pzj^{L%RY3cgdJdqBPF7)F`LPeaKxLqRPN3(q1i4=2o^hfl=x23OY_X5lGPrhPgn|J--Di( z7}+!MvEN`el$=c7Du>zf8?|`sB(%Wa$?2&(?7hC3W?JHpAROiB!7+S!Pu0#=t~nMa zlTx6@o{+?-#5cT8tY$dJ?Z1F)TGfSmw4x|p*bSYrKb=jB!G=OESGja2*To62fI>TR z5gRY$0$Jfvdox zp7W)9`6`Dw^w-0>6}#_G!$LVl~A?0#O*+-^*&*%7Y>Fw=?_(7VR#PR@fnwG@~gI*<>Y{F7y%Y zEz)G3wEAeqf9Xo(3k18oDiH@ew9+a^U^3EHhgMRB^ikDLY8!Yeg7`|<$}gD6$2LB; zYx&a(wfxC&VoNCyTw3P9@oDX5>5y1#rD{oMln%uI2F(}BfeRu%pkCqw)P+^*YMV6C z=zlE!9-_<`_}Z-tEm7v|^(Bt@Z^c&+fgQugD&~SzD}ObpNnpy8K~!I<-Vz62kSnJA z@pYOgQj%Z6L7Vy4!9|W3rZe5+KUm|(pr|lTNj6(%u~`8pzQ6+K2@I@-&8jGwNp9Ff z|BwTO>48;7;mNU0b4FY+j}%c7w&G&-VxApuNPO0Tbw2S`L-Z)-^ABKd^Ib`nLX={57z99dKoT?Pc=9sW(Y5t-7d#J_mkO|mQLSEUE&kX^W@C(O6_ynOfzP-W7TEyr z;&v5$CK8?_xsC9{A~Q$Av*cHc`XxZ{s>~MU)d)+CZgoqqMbzy%u0f1_S{mXCnil#8wfS(Z6TKS8Ni*`q!$QOmgM2-*e2HWV z{f4e-b@$6V`p=&TF3l(2vJrVR$!Knsaq#=TXjqDv@u0><2$`K5%G7tPMh=>HatG5+ z(G4Sq4_q5CV+gJlb?@r1aIf=aEiWt|v^=9w9;M-SI-r#r9fA<6c5h^|SrxgXgJ-8! zVr3{%8QfZaU;bw&A5}dN|6@T`hUkWQ(pdTHTG# zuXzUG!$eldWZ}6|p4Qds23|qJjq@is)|G)4F!75wZA|=9h#3u_avv%mWx0OuE~?^^ zzO)#*1u{{(UN!5SfG~#i4j8Q#ejGG_6`>Y$@=46Tdr4r0o|v;wv5>WVkiVMP0zSL| zIvlYtk#g%N=F|!K35@*J#4h2pmY1dFP34?(8vpl=O_I8kL@D$dRzzu2TePN-!bs%&{10~UCY>@{$)q-Xy3Xd3qYAQoH z{6~4iL$J1?^}u#JT!>uNPc&(vJ@U;k6uRH~1n`uSLOK8k)xzuLb2Kc?0j;7&RpnGW zT>y?KS|e9Gzv8p3XfDbEHrWH?7MAXIm(MtZ>F_cOwW?6yXL4IpA>EDptZt}j^@1o} z>7X=hUzMd!1xC5*wH9o)Fr`q?_#SPjDF-oKzJmEx{sn^0W-VkLVsdZgkXg&f(_@*C zqP5tkB;v6AbZdG2p!5~IdZQNtnz2eUDIk&<35mwMvhHI!?!d*TMfy@gXdWC$2~y#L z)~G1TFOr)>_Ar$z@U`%jvNA+1l%_DK#>_4m$$@R;so_a?1+|nI)XV7$U0DO4$>_>= zdvv8e-4!))GrNN8@rat^Kp`K!oKfW2^O(+L7u#gPl*|DN^93eDW!-+O^maP6QhC=-A%do7d7h%5FU?7JYL=BZEWCsNJL_Hd-@w!^;yY9O zC3Krg)-F_ZXishVC{w#Hg+aG2P^hU5R^+cnWW=cAsTcls#I>zUWF@|%b6=Sum3o`YN)+6_h=`!tRNd}oC z!Cwn}*7Crlm-N`*XvHT-Z`O(u8N=n0wfOxN>Qk$OkalWWut@hK*@Q)xvM6|DwkSfE zeTS&Bv^qJ6sdrs{y;@kK7V>|(-A32Te6$u<4#bjc!dpv|Yr^Uhfi?2Bc@s}=BW*NVk^nj?LK5$es|AE zhCNN~8G;*xNF4rS8S*k2;%M$W^DJ@jfmOZjlDR+rt^4ha`V@^sbMLY1tNh>8XH&mD zjx7A$wE+JH9(%c}LpJWIL9p%%e`|lzJi(veqwOSvs6V#I5r41e{;C&z%bw|xoFf1e zVkBgieT#l1Eq;6pJnIVnD|k-m|NjDyOuXa@_P-yWe!YQU?Lp+cd*-Fs>WP{twZ-s7 zv%EO%RQi{nfi><5y+x#@3$Mzqts;6mj^U!Wva&8aRmqTfiaxf;_phJYUX!@P9^>2J#U9>nq7y?^=CzawGJ?D>koI z9$>{GCM)|sjsncH*z8wD&h^kY|mo-_^3{)F~wTz zWm^saW0s7scTKTd+h+!>*8Ie%v|8d=s>6JFF$-v94;m`AVX;53oM}g?6ZQCR^B)Hf zTP$0a#M4e4Y8lUpiQaMiNNp(7@xK$e0L)!Ja{@IILQ^8cM`m>DhU*7(oGoLYAz$I# zzG0c`!K=t(xF(TP{k~WIF1XD~9+gb~u6k))mV261X}A_rjmm$z`dww3LxEn|`<97) zX&L(j5g=i!t)e{R3@gxA_P<1#j#lTHQr^7x^FEGOyZVDr^V2dKzOKxCtSqB%(n;xG zb<%$I!mC8*gRX)5a5DTn+eJ`STN5sI8U^DehwR@+4Yw*v<0lQDoSMxr6UXRL$^@6> zIQ+Rh^70oBM5WLXKN_eB5H9cdN9}}(e+S$kG)po{+AV)5!3|~detIVS73msJw_o$} z7YyXJ1N~a38kA`6mLExNQhlOeDRl`eO_@Do?`&JqrZuHy7FxH_13Ig^ZQ9QU^^C+= z^-c6P4dxYdMJAhp_K?0sxu+<*Sx-@5Xi^2kuq@(3k&KU@4ZZLH6ftC?oa?b4GT2xX z4%N$>{Ik^@lg&N46DImJ_UAK;^hn=0)}U4Vn331)Im>B|`MIbg$IqcGsy=1e5^-I^ zFMucl7&r$9Yfqbb_oC1Xn*HSwPS${qDln?vH3X!*R0J%_xCGI25?(rF!4F6iN;b62 zPEI%(0U|+0NoS}V^vI{?X(I3jmp0J+FZraBqbMmOGjhzW0-YgIWoI;)pB*Ff*i!A~ zsv1PSXZ%=@764(M4q)z#pTK$AUDt7*mS2&_>ow|?&9MMTT`N?lh>^z=e9#cuDxPxQ zspwMOSH#S9BAA;fNOG9xET`8~lR%r=PvnspyQ6KGz+_Maw*7P z+CP}0_ssG&OV4s3n+2B^TCEnECDN7P(i9Yhs%uqwrj`MY&A~G5<4Q!ODG>^WfJ8AR zioD?s-jYKEMy1gb!b0`1?@BNf{5pT(k1dVX@y!qlW|78B_HB@MQ>q^Kt;BZ(X5J&RF!#|=4I3@HghOe4kijt|2_J|-*FN*7HVAmvZ6-+ zjk<9`0vEMd!Ad!w#P@<2|FQM1cPXh9 zce~6#?mL`_?S)_jJ3EyfYihCJMQJW|L3DJ0dFqd#duBUxdvXd>`juB~(y=v#un(Fy z%Gp+Mg2Rt>R%LMsLEM$iCgze-guv*EFBB=z;v4H-GXP{AC(p8Zti{ET)IOYb>8opm zbE5~Y$Qi*`QU=W%p?v#p5eL7-BeShU6&wq~qwtm$6oBP8s5&B3RCu|bXHH80z)7~X*0E}+MIv^Z`e?xl*Ea>$$czrP zQW%c3hQ^7>(eQDG1=#- z4NJHAYOk*qHuM58MQbQ(FFr?J&unmIJ(Jg7z&&_b65K?=(@&(ZO{gtxT zRJEH~fXK^E^WfdQaOq!_O$Il|?|}MkENw%h*6K3?4ORuPC-asos6$mJzb;cXsuP%2 z79#TXwN5l<=0QJm)Y+&AVXl>MG(C#yBlqJUu^&I32FzElm)ThGHxgvN7f@I1a;T`Q ze3L|4k#1Z!CykSD5pq8KzD*PeIS>EZCJGyrp6f}s`oYeJVSB9YGT#ahNc>B;{K-*I z^Sj7)^OM<%Q+x}*Te|VV}vKTzi5m>4YSCUj?%xHsG6`I9X2epuFcao6|MITp%40btrxIKVK zh689!sAm>t$rYmh0L^E zVyr;xhqfN=l<>WYwBjx_$BSkZMb``p>d{L$Qq5Ab7zdZ8`yuE)xYXo;NmrxFULlY`ykXNzb7 z9CHgC;3rR;0vy+htbLY70t26Ji0VKl!=_+DY=DLGJ9Lk}ysW!J{o z6fuf^1m%v{Y&oWpTE3a3?hnK+kOU+5ali+Nojlf!6X2SM4V8Xh161arTM?|a48h^J zV=d{phMd5q^glM!FG^a*Sgoql{UY;TT2t%bf5M-vBj2c^JypKYoc6ydpQmqc7dc}P z6!!e|B!wjku79)#v;0=E#nF&EdtGBdH4yqw$OVlaI?L9s@OUzSd%7nq*LI~hE-H;ntFMxRK zvKwjK=-FI?6rOuI_MK+ol3^)@kGc;%%TkD-4v+$EUr&ysjG9I$;lLqIH@dO}EW(=!H#Y zmVL|$p`NtDq%e&Z^BQn1@pO(GFG_>OC3TaD++8Q83{psJP&f)&DY8%P=Yo<6=nzc4 zuyI7EqDQjymWdWIv6BaNDmhEqfQJCHLzKg?A+io_omRTgu+0$9Q(Lm*I>=_})fU7MVIH zQLr$xe42;+TY5L338B9eg=!hJ6uk#*dXGJGF*$_hSL{vFd`Sk)i#9Mt@6&90Uu(~m zdRGt_lk4s?tJAc8%J;j|x|@_9wEjc}t=DLZ)`f#~+n*hQ-oLu2C%wZ!%4GVNrME8h zK=y`zW+AkuFwvwLVEGecf|ME-EPdsRPK2&&s^lMCUd6@Os_-dvDwW( ztL>rt=+orTjm#LjBeJWtRZ(Yrd1?$dR;9-<{#<$tue`MT7%nBH#~A)HV+>!+{V({{ zXuucjh!)KzX*H8(iHihL!A#BBUn|?gJb#7GRoxO9GP#voB4?AAO6Nh(9OZVwt$>i* z*d<_bY9yNz@WDs>lyYm9sBF?hP6cIpWB?4gSvgj~JgjA+S_sidvI^Vhz zbi`j0Z4U*oPl{O_(0{gE&>bTefh*KqWofn=B`~aLTAp=z_=O_Mx?d1Z61z!BsNeUc zu^fKZ!tyZDd>F3%iZiNp*;4ETIg=t?uoXd z3l-Y5&?E9$#8TpnC~%n-~O|LRSUK9MXrPd6aBRC6a0ww ziC)mh9ht`eY^m=+MqQMrjN+2!jLQF$`v}PQ;@m=y^n(17`w%_OO<}#iX=8nspc$-J zTDP)wbxRtRJ6N~W?-?eH@w=>}{j~kwlFQjE%w#0YwR<=^Qt}VIiw_veioIcKdTe5t z%2?A5`C@wa8E_jZ#9OG#p!rs+NRCM_^IMO)?)D;-L8|@iDQAv8T1=H)H(BXu*0FyU zjogW1>4e{iz-jfa(hQhpSTF@H$!PW>nq{)Li)>;FUuP{N)VYJG2zORs5UoSXu7Pu< z10qTpx%01<^)C0gX>1dQF?{A1gJrVvWs#Z(ncMLPNa-=re>L~MF8cKAs)I{+T6@l& z=8m`}=VnZ1kRtS{PE+UGH-}xf>J~2U^hN(t+%8mfPw`G3zG(FrxpBtjhDIz~?GA^%o&8LUSCGpWerP*noBKS-!pGis&EN3ctZ_G)PmLf6Rf0`~!96T{C z;j(V+ud!5VV-TN^3K@5$u`_?;(;Vtjo0tWu^&k7ysI2SLn68rxAxfRCo#?>Ef5?KR zC;F+I_!1R!safw@0alXzdG%@fBh`c3W<7`Y|>U%3Q!rSUSE!kz|3TRii_(mm}wNJIC@Nv}$itB!Jj_vrhFaX)%F z5)VVeIVU$5H0|zp$?hXmgE#nor?<2z;MI+(9XMQ{tKIB6otflaTVwzIW1@ERz&z5o z&(;3gHdouTb*?sl`{#4D`1ZM8?T+nL;YPyt2AjCPv~|&r_<4kDA#TWyky~u}sAgOa zS|zpeh^6_~z~|BwFN?MK&yer9PnzfOUrY2}AAw%J#D6o`qWh55<>MsxiI^}x!M;EV6<=i0~AvJXGdCPbz^Dsja%|#Yv*}B8O}_uK8uv@Ts?+kS1Os2QAw>`$#^RHN|8-wC4+jay)3BAY~WCklCC1^{Io|jP??Ydfj(Bp<4<2Sz4 zEwfQCE4sCcY7_ zRh*lSKQv(iWx^sm=#hfY_$3w$u`9qNbkJ)4@$ZTbTH#uXOX8mz3JVYeEMO{eQR>FC zi&-~G%$_=97gAD0eJFepOlVP2d`j9-3?95vbRxvNn<8YvX42kTVCYb2fk~qu8^hFc z(8`^mopK3?%Gf+uJVUW=QQTvTA?jZ4F!bng>=1DfRdvkNo!86iS&&cP1p9PP3*W)O z*jRa+J)8N!QD`@2)VuylrsP`gz}teX<7a_7zqdOT-%pBAu?jca!2vW2MnkNUdNU~S zwZut^vF7&1}ut}1$)_6=y7%)T-^K82xtT^3?FvEW1NcGh$?dKp8w5)Y0C0M&# z`xc7Mpl4ZQl8e63^L*&pUiquo%z0RUZMuGDyuvK;Nrj3yqLCAc8MDkk(o~YJ#RDEn zeL6Ku&L={b$#0?SKS`OCbe5%s{>T>wN%tb5sg<6Z{w7yLf=gFHspm<-WGy$Uyj9iq zMMs$i9^L#sM-t7RYn;uVxstWoeDhkF#q@v+NR&u&(M@C`<6M~=>*Xke8wL*Z7osar zbK}i%YHqBN79#~)_@$i4=-5j|@*&Beu%r7)p;<>Ui8LceCUEeU3bim0c}4-}`WfY< zFRD95OjQ=xS-5gE9e_!vis;l|q=~3U*4}m;H1zRf^kah-iJ1@W5kjBQZg~|mIN&JQ zrDi2XL+e%18Dd)zC}UPu#2!|(Z58)M-ZDR*Ag3XRVg~85I;>?@aU$#~QuiU}vK<1^ zu49z))!GU9S>4$QX>M>*EI9cHAvN|SEhWJ+e?g@&2^pO+xp4t#h(VLg?@3BGV$E;* z2?D3G->Pa)RghJ$WZHHHs1r%MNFXz1p0g%q&h=^`T_(iUG9jwXVYCaTbW*i&iL@WB z(t8=(Sm*h|0g_1EZtl27ae+Q#CkPkN!qYh$N`1#a5gR)5Ug@TIl@MUKLsi9TWK{=1 zdD>&uiX-NJjh4=Ao`dz3xZXliZI`?yv`lAk`o%|G{g@KGMrjScvY%3hIBJ* zHTEySuXp_rh>|SF__f7y&V(YJp6)DXC@Ec8&d43HKX8XBgX3KGwc-BP8tur)P0|QUZkvy?e#dLz9hV2oi@un7C3vU zCa%jecCy~g1`w(jz)dn+7e!(%h@ zYV$jQ+k3tq`r#vuf6daXt@S~slR6~P&4#hPtq=bhJw4~FyZoAw`zz`KbJb+M;>W`P z@f!KvOLs(y>P;VnW>eYGsPm{P46>ZR6lCh={bLZvQfE;)e^bm5Uj=6{pvkkSUiI?H zbEw_t$vM;~=cZ@gpkG-tPtKv1!S}j~tWT2CU1W_vo-yq{JfNnXO}|Ib$6rmW-SoMt z|MO(0F^A=~>v>!U=W!C1qbkyBPG+zL4JUO$gBvWP6zK1t06ylavnZse&Nmc3S{?p# zz=w!yI6R7Sh~85h^PIW8Tyw)8#xNGk=B>q#z@|Es`sIBE(w<92P#KuETe+5#na{F(jhN-u;qP=^6Y1y`Q` zA`v$T>cRrW3N-^dlC#}L(?fkC&|Z&}ga$;qoNt+WO-52j(Pb+VBKfjHhQdcyaW2BfPk5_$oii#;oLBzRBF+<;vu}uZq%PacFG)cY{i_UeJpZ2-Irh+($+5a^ zo0c(NtG|~XuO$A3l_swe)$W~zaw$Vb-awojE?ci&#e=)%D|xWQBTeG&i$=6dJh?sZ9Rlnmezuz0)q; zujQ{^A%bB`cvUhnf3&ODl z6}s21BCq)y*;+@@*D8147+FS?KjlbAu7le_q1{?#GczTRtd2;ym4Cfaj%vaWQ<*o) zX$@C#hA2qGznA*C0jHpwmGcrm9r1z6xfNmlq<}Aa6?RG27joM>yUO`dRry{mbUV2` z(NV=-PLXol#^l$6or4!2552y1f$~pNi|2wwdvkaj`JC~B``p39NQ=dg0dFoXbQ*8I z=+ZLZ*ri4OVcy{8JSIaNljBX`KVWHD{2qEYId7v`US%xos2a9y za$WZElj|za&hsAFeW8(k86Ih~-8Jt!Id9qOEA{40jZ|i}O^w{1wR5VGorSlF_NgtE zS?vJmn5gCZvshU$5yD$dpg+i(RAlW0E-1tTBQF+|jf&O9#3iUkZdP*xCk+CGmbY9w zqvbueN*<+;)j&*I>GJvNVa(yd{ySXF6I`f=@t8bfGpV*YEPi>NHO3Ym6|vWq$(xPL z8636>QJas*PMqtLLcDSTDjJ?=y^6FHUP-gkLIqD~S+R-8W7YBtCdNblcop#MsV{j{ zD)UwH3Bo;m)5|w$p(O)&f!WCi&W*U;Z!4lJkCqJ*N6!fqsa6B!JGHwv;`>z9@DS9l zH-6y4Lg0fDqO0YWn>X@yqTufVl<=&}q9OaKWQtnsZR~16U|^8VLYl+B11(PT*iRKF z5f&oaF{VmOc1{KGauSw<5hj|4v@i#aBvSIZNJU z8b4Pn8oC5ki=k?X1lS;Z07nokl`BTAN0)aBkjC^pC&INu2)}_ayKt{|$rWs1>M2ts z*t3WN#MBFS%9n`YPz5ii+Q)L#EB3v{aw%s1@dPQmG>;=zdMZ>Vf4t7()gFAINcoF- zrEt`$jw6MZ2BvpH*F17>+NJzx5_W=vm%-}#r2fJ=)?Xi-J=~9F3IA!!zF;demJceh!MXJdA|BIC0AN70bWb#SG;<0Yhw?pPVmmE#W0R z_)iuyg$$mCpn&Ic`M`Lq*~PQV^s>*yjiq@$<7w%;^2+k5`QY(XD@gH=^Nm%_X`yn6 z_5ve&4R!YAe~t>H(}2;pxkwI}eVg;-k-Zr|mE6!5fa1@REiAAKxv6Q)Eqs15OoGuQ zzth6wshS~GdC2Rb>eVVoBv1sSl~oCM)-o5weJD~C_{n|tbeS-Tg6kIG`1n_(>v+`+ zO-6BsQV7+{z%^CGO_(g+(@g+($RYt)cFj zs_x{?rfOPHt@l%mG;=0uAr))hV$u?epz(dCUcOh_h*aihOg(K)SXS(s4Hf+BkTAc@ zohArOf~Yt0tl8ks_>u!k;zEZ1xSZdeS)cg-=#T5-^ zUjjMkM)u1q_|0j(tA^&9!xPBl)UC#~&`H*f?1$Aj!vNaBhjWw^i1?iu_((SOKx55@ zNz!N_YvdMs9G<6eFav2C(Osr#>rQYDzoXK7+h%sc_Ew0K1Zl{?gSXSu61{iJR#18qgP6F8r}2JX?CnAH3E=l3^jq5ImZH zID=)FFM?>9zN^t3Q|nIoZ8?{KgiZO?qTJ|6O}w^~BIC)ce3U;XXEx4`fmlJUN4Sw2 z3Emt~irZ zY`_=UA3OXt4op^(CpHuvYjgOwf)Rz-x%eUxMjZP!7fHO%*346M=*eIJh}10@j5S#D zm~bMi1{h6?8F&wN#9`SExrhRLx|-jyztNujm?b|>p-IKTUsp7;p+xYIWa9Af*Oeso zI#d1iBEYhzdYR-BPA(o16eoXPUKA%EBAoo5V!USj>gT27kpiVCBIz5h{@%U=%f;evw`_IDM!n@pb$TQtAt6fVDm7C%|o@? zJXD(}KuDl+7Jb`@ZlD1LX={;C=?WYGu40*QRUK`$b`W!7<%}$zc&ZQvBX5|0-ylP` z%UYRYO&u~!A_5AXR)7ohjANvFC8Nf!6%VK)sOEuNMUxd`Zz1$J7P5hcs>(M7K8uMv z+av5tMhLXs_a&zY(*N^)$wC-g=Dws}ZA+FML#MMuh-;INyKuOU{m_5AN%7%iGuYIQ zTBbvf+}f$P2riH%lo`mxJZp=>^{>bW(CE`V z4UE}5P$@Ft)h{xx$_A14#0Xgnp9ORAMJ)->2o%O@ptk1lb_L@uHSlffeVclh-8#p5 z<4aIdtz(sgN)DPs&yj($M5(c>g(C+BHLHz1SuGBIj}mFDb&lDlN5-{cj^D{PTnICV z_kH#|$ZSq-Yg$2}sy5~Usy{np=Zb%zBkfTHHsT5X9Ts4-qm)E)hCpf*oF?6mOwZh^ z)GKi*_OVs}mon9?`jcW#dJkmPe@wdmw8ZmWtNvq?^;^>E3a}n~nksd54K3WRa=F^y zCdJ-D7_O7gL&0XqBB`!4NFO-6FXBP6RYYz$v`j3dHj*rSp0R;d)ZVmOY88ITQc1wW@JhM*$%hDGb*KXNn$> zop{of0!AF4tmL?EqHraVZLd?!T6~R7(#RdbarxPSeu$|f1aNG(^zydAr}ps04Dh1% zaI6$p;4eD1Lm`Ug^}ZLWQFaBI;xF~ChlZwglbgbJA0CqCjNEfd1+GjBmWxQ~t~`%r z3okLauMt^_P*0a7M#=ITNsSnSS(d~(>Q^|AN1_^Kj7n!aC<*2xdxw&>Gq%t6P&Itd zNsidb!0@e8*Z*yLJ7g~F?FeB3(cEg4#+E!$;3C;=Mb7yN^9|~k zF;bdV*~YGUmqwok9QM7gRO$*zmB3x8RGI4a{~vMh0v}az{{JVCK(NFU)U;Hsh88un zer>Q`lA?AO5jkwc zNNs~!J==H*YB6Xf|MzFk*<^Def^C2QeZ7)7XU<%ndFGjCo_Xe(XB0b^SY`q2Jf5oe@*gq!gT5ZL5`95K z$18dIp~vAwU>mitbAK|W2d5sHzH#edjo{Y6>a}K;WjPvO8xn$y&$2*PD>Oj2 z=Qm%BX(zT*MNA0t2N5@Bw4Ksn=YC1LQoYyuK*jTibm`kTg$L@MzUtWP_Lv?q?NLAY z?Fq)hBvW&He%^nzJ^i}2XXQm|kLkDnLVM^IO{IP_DtH2cHy`W|=?FFTRYe#5>|W!~ z2**_i`&trR6Cs_%VL_EIeP4|;^HN_mW81lx^-=b^FL$Ab>81)nk=a)jds%+aXSYfF%{Q=2?SoTx->=+jddUUo{}R3AdG(BgJ__q*AJgaj0sXak<-hD3nfo$7 zXeuvf!P*xVwS}wm3>_ZfIy}xjW5=&WxeME36Wq=HLB7u^4?myfaeOx9TYCp>=P|_N zJ$iH}%#c$VtVP0^j}|HBqu1h4}mFn#X&yUQ>n~1!*$2n#NQsomn(j>+3CxzF>zEVvvO6yG0q|ZY5W}+Bo(kB zUXCo*%(C3$xIpFCWo95_gGQ+_iEZT&J`2b*`sH}T0mLlP+jQ;nUn#UePzU27y}Y1h z<^b>R1O4$TS9TAa8yp2yzF@aK@HaKd*f${0G;naC^2h8apyYVcwoZK#d}sfO^|Y?H z-eo_U+FwAObj<`b3ZL?Y?eZ+gSUsawsyaz0NJ}}l#G(1ZDE~s<>XnFEaSr)qRE^T% zxgukK=$t|ubTE?j$XhQQhFID1Cz_2$Jgb@>K&eb#6;*D8z?R?Yz!SZ|2|Vu+(g!W* z9I57h>pI|JjX#Hbo{cm$S<+N_)cLc~XZYr{;|jR?8s$lJxE;ke-2zrOxrNf$|crDX)(;$;uXiJ^#A6SoV3bUD$nbf_lp(sAkKH5qb zMWl-t)fLz!=k2!zFI-NO-JhKv;g-dXy_rRVPBIpGe`Q-7>y?sHr+G@;%cPbm;rPEX z3njBsgwzGa*1Q8D@s=Cx%%|=66M0hhMu$BST*#{;WnJpb&Kp@Db?^iJ_vFDO?~C59 z-6Oqmk80IL(xu@ey@SF=_N1`0?(d+m6MLaBxmfRwq*g(Cmp^An@18X3I-95tc)MKP zGxu%vN6H=roqLBpnf&Rf*SGTBdSo0-?%Pwe0q`{M5X@r@rHM#;c-SWP2*(YLe6;1e ziQ_^MshByi<%}*E=a!zhd4hY%iLK+@^G~w4a$3{@x=A@;?KFc{H*)*g@hsG)E9pfFg!RnPiR zTjg%<4f_Xd*K5xob*9gD0|$ra`}ZJq(pPWur8zB#Jt1BLbV*%9k^yYyvn?I-8B>Fq z&stOSnLMS!Y=-xk&q&!hpS`-xpU)tV-0iu7vU7U6d7>cgeSTsCp_loIsWvq~)ll$W z&QCt1k|&vsT|sh|fuud(G7tn)n~x&@e55pwX~Ql=7eg)2qK>+LxYRynsLIN6Fq6T! z>uL(yllPh#Tpey4*qr7k>dk@80qv*2xZ5}=af7KfwwWUZ?JqG=Z#IJl8sk8n$DKO$ zNGMg)-2AMrH4c8xZg-eeborG4*L*84IQ}JOzIw#V`dd&-xQe6O9Qi%K~cnJpW!Lr&V1HK5hjR@1rbt?{2K?Jxng;pHBZZ=s5~oR^u`^#I{6-s zf08x5n4_)ixaq)Sd{ZXd!dD#|E7>wVKbE=fpDCC%;AUQFjuz zk$@2wbZ!EP;P?Xu26zl`{P#%1dT{(nG;=FY`H_)-_VGRhJPZZ*LN#asr??UTMq?M@2GtH43;p35x2TXqX9`7v7`Z$pv`(dTGEt6Q+YEsK6>4G#eO=g<|cqQY3ZZ( z&G@-Z`S1Px-Qq*|@BKeBiqMg3eZ&}J%=U2Ya5s!=^B^qY>lS3+IG|HXT6MWEB~`#& zkIvJ4n7$1%j+pM-AT4(-$R3wg!qq_uIu`XnK}QKvWp|!0=ipc(`>%)V>)4^mAA)yZ z;hje+uXLj?H1~GiLjEuhnSu>Org4qQ;Ub)_aHs+%>L04mvX>=rVqDI~vUZB+T;{FM z$}1NpeW(aIBM_LSvB|AFrR%3iFvg#F|4I(7ak>CE;IrO~tgl zLu_WHP|il|fM4#gX9?t;H2ZYKlj02KGP87NGQG8azq0n_ndbCPt9LoIq>dO+xaWW;&G7Fj0eSH`s6ITbwsQwKM z<~)q&ZKgP6l2&Df-e!5~+KDD|qup**o@!_iBR{4hBSebKXa3S4t3IRZ*ag}1`*kAV z0W6Lwsp`VCQTc~;NNiCRJ1!f(@ka`5(iY%mNEa1CS$%hRJ)fH4E$u)e_qjh9-w>A# zKu$BhAwo|JM|^4gLU*$H2QfYH`-=|!uaT#ayDqB$0xxwI&hsA3@)263=5?3jG?SNMb`$6IwSODy)bG?!(A475ftX->jMtb?C$Nc`7oH`KZ_lG%WjWVDFBn2H} z)%=6f(f4zuJojuuDKEr_*l}J@5BaAnL}qIlSQ6qu~Wl`@Lq4*cu4q z8zy)3-r75Z-m4tbr7ya0`;K$?6nQ;GngVIlL#A54xa76{H3DigItk$ZDTV;7nq|UE zB6rw+-FxXf#PsN;8r)pei$sPQ*qDos{7lfyeJcyH2d35jEx&fybt3mSgSyxJ1Tj5o zUY16wS@oi=w1^M>q;>bgwEl%AFPoggg-)opdX@cr`Z2oD?(`F+2Z<+sBXCx&e&}G; z0X;B+F^;-?czL=$2Q7y=)3wgK&-8F+)zFP&GkwpLI@iVQr5loTM3Nylgl`!wulW(l zzh^>4@@KetNs6y=h3}ruO|HmnxexzeyHDxhWXVf9IobKRL@y*sUZe|&Z-_)o`C*6oJ1{cd=*!p1UlN4b9! z30oL&@Ff69FKHt5{Y9WLjJ$IS8pA7=M{(zapZ@*3t@pRKzpM#(EDS|i+c2T?UIGqj zY-*C!<7R*DlT*5>l;UPnB4aiOfDJdOdc^ZSrPEe0&?%*p`FGxb-eI(ByV-wu+t)F1 zZAT*eF1~oyw7EH9fL0`+u zNE%=2s^^fO8j|I3a~b7e(%#$Q=FSM!(qf=Rs}+&_sYNb&q(e@;jsy9&*g-a>6>PCU?O)`|L(-OgqR-0IgdH2NpsY!+XNkR)CHdjT(Vl~CYrDywgpjV z6{1eKjyW9tn;8-QxOsb-88_Lxj}C+!$+sjwm9~)g2$$jT%6L{3{PS|%SK&M)?uzf}abyx08xJZ$9Wl^-)|)8*%Pzl8kUa47P# zksK!l{#bjsVEs#w@rb>1!J6`;dg84C6@7D`{HV74Zb9}zA9WIQ=zO0nhH2w8k$peB zH&E&Ni>d5qiDAXxl0H2j@<_M!ll=cJHKU<}t)=_NK9z3Qe0#{r+FiNk>rgc*yRz6O06grN^A-W8{4C08Ki3_KsY%#?J2Phm5e(%}2H=b1TEYi~PuZ=99JVw2&E!dlrdRv$jwSmiONm66Ub!ofD^5WB4u^- zICrNoM8xm{LkIRXNEq zA1TLr*y(1m(_?N92Eru6=lK_ti=eLlz>-&ssRud!y)eje5f$igt4@V!@=4QH1+zo) z6yk*hx&19=bXo=$g6@XG|k)LyB zNUU`}Bg0JWS7k_&)D_F*PP+C3z*#3`L!$^5REJoAAR6YIdoSJjrvBJlBL zp14wy!Jk6NxBk^9LY6<2LddJFLdcp9gxqw~=S4_mIzlc4q7*{hvpNydZrEKK8TCL& z?k9#JVs;-~%yPL{EC@NMD?-Zd4-nFUj|0?{%45LCAf9x^rtsl!uR|sKdxw446DcB( zpFNnu#25C!=az2P&#=3{Wvzdh>l5 zDKk3=<8*&a{$xS+cYrO0ksnR$#K_;m&17+^$mLG|@R+B2%o zks(g|lNc58>)=Pme{62bf2{a6%sP91K9i*^s`}hAt{|1SjTw;~Ki{hyD%blhIXWgR zpA#0yAWSZ5ZiF|a-SlYHE+B%_U=x3 zA5x&LCd_Wk2gNyGrX;_w?oaJT_^-c;aMvJkRvs8} z2jSF{dm+6g_{b@sj9(M-^yAR8|Gmh6%Q%oU?l{=Q=umi#a&+V~wV5pcCdQ_0Sv<@vUuCwRKUMK2?xI44ns{2r7J1cdDA?mm*VDgdG+#aCcoEXQw;yZHnWyy?e z&eGN``VDz)$1P_gkKGwohHeEPtcS;4SLgcnnETnz_zJUgN@w= z{?j#e?%n>=j5_yM{?oN}?p^*~hZeUHh-o32$%WB@S zYF;K&=n?i!AKoyDHat5ty*q$?YJJ#75gP!A4V?*=MK~1tK4By|ctOj=$ zzabl@N4T)VX3&~;{DxC>X>l8Z)XIgX6HGN!f4klq<2eNS@tDV>F)wM15ABRC?tBb& zCa{CpXyU#++VeoBzrjCpXEd?0Rj3l~^sBa=F_YNE)-B^7=UIyz@L2=7L$s6V?49dy zCG>N-5^9Vu1RwhGcsq{9*;YF&bZV^{GsAtDaEv<`l z1x3cjIM;oM0^=(P8F_0ARE_ZrUe!pX(KR_dQ`=Cbs0^ijLxssJgP~mw~ps=?yU!^LngRCKTur}bygM&Z_Xn5Rfsz0h8RTVBvr5I z2pR^+YL|$R$DGdU6ssSxdBg?@3Of@h)+C6pDbk}=dnDab*Mxy^gtMrPamAW!uB&$2 zZroPj#H&focfIMykhbYbapd?a;+!?-(VWsc_m}45%E^3;I*ZB)D5F}D?jj}Ru%1gl5n{x5i=D#U9 zZ_WOjDTjjf))+U8Uf&zz^~3~p-^8PS;l~s)vVG&2@30B%s%N}!*Je`Tn2=p!NY$#j zmi172f=zXq83}t!eAl3kCS0ZQntzrF17D*A zQ8(UXg1ZfJ+%-OSS2ml-mBL@ty|0zP%8R!t7!l8)L}1TRlbm>--d6ENzv@UyqgDGU z$YMYXrBUZ@q0@HOs7){(brZC$mPMWWg03)SBwRI<1p=m$(@Z6FYi7VulJl4l<83po znyJhu@wV%&np=5DNB225Wb)x$>nHC5NW5)0yiZe)yHZq?o^T`y&5`7jt4V3augsGf z&@Q@cEnhC*IhQZg}!g%t+aBQr1KXlq$YD=I8_e!kypBX)OtlD{cSM5u{Q(#OyERb< z>!%7iF^LNZLRZy8)gie;unTC7fIz2F6gEzl=;(UNqT5X?N3GEisu~Qb>A}nSrN(VA zpxUrD&x$$6WksCIEX-W+%Vx${a?&RpO!fJcDa>a9-WTW>H(p0M!O#bZss$waxO9a} z+wF7ci%4MvB14cV^5so*$XkW~R_MP~^A>d%74wD{q#0 z+;S5vnrwn46$*wdsaBF9iz-auPBuZjoPbhpBnhSboHy6Kl^4hTHP4KV&6-%8MO(}? z6K^(w>zT-vt>$fIn+fid+wRoJQ|G8TgaLP*X1Fc=w4|7Hgo_IO&>iZB@f<>CGMfPL ziT}{U`P-ofArg9UP7UbcQPasA!>bI2rNdn$D7|M`j%vOkIb*L|w+D>Rs#(3CKAG;0 zG-hQfWm4A>bki^WS0@wbr}rtu8y-)aJMK1Q>aGz1*^l#2KjwgsY-eW3s(lG+X9CCo zuMlSr!NxJOHGkHVtaED8cki!;w#}SGegpwUX|;v%up@v z${Yfaska=Z?i7C*(KRyV2X&$y<4(4V*ko|+8nA|vw;AS>Inj!D-hRO zDr_{yR}cj4U&W(-8{>^UWg-oi*WnmP#5~QFtZ66wT!=)xLE^5b*hVuKDJPGUI?K}l zSJ5OiL!YlRh|RcRx3B;TY$;-*(^Y>gUPOZOMPOaag)*$jV zfs#<9+|LD(|4`%%MHY5Ou2SU1iaaog^p)6}&%A9vC;k)q+m93L@){NQ7IAj3f}+DQ z3nMGi%nSQmMWlp_M9qXtHmjjsu#t>YA9UYDz!$?{Ag=#; zy+OaLBfQA%2>38wBw3)a3jM+2n*Lx4Qny-#uG(M~E>aV$5sUJmZRWzI8b|11OyI5} zutvD`CRnstkqNg|RlIqY2z@5IHm=sy-fa`qV-v(9#Y()f+lGOl_jXcUIqxy&tz^kT z%AWh6y8f(X^v79}+k64P=lJQQYWSjvK~>iasexGVmz$vK_dd{Q%8l+kJ|lARUh68Qsy7i1et4$H_c~#6erQnk@ID{dEai)ITY$X8v9u%j5XRroX@uH@Zm*{@vno#9U%-I( zPP*X;D%+84!b=N6N42o(JR4<9L>ycM`|F22Nim-__L9dKSznS5G$O>EPDb|!;m7--P1I#`A!XERI$ z=y{fL)*TdGPm&a%N773j;0AR#NLo*JPHk%DYytG6ILx|!C>Wu zJ)Ebu!Be!LfZu3+L2RCca-cR7j}xyjkLi;POiW2dCqd4o0nSzs!e}#;1zn{7W(siP zTTGg1rf5z6P5K(FNopQ}F2x`9)AApVY1Q1!G?`p4pLjvC*exAPmlO&L@#1DDxJ=bO zdCphl75E8`F}LBVFp4Rxn|t4j+Aj}dG!<{;3L%`rdREP7%58a(uL<+jxG)+`=41&U zdLf*RHUAaDxsXMR)4DID1BMJj0@88JB57m%P=<0w@&pLp+*5h7PnJ5+ zoNuw?TQicE6P2E19K*g_k`svv|H%~iJ5mRaKOuHO_Dg?(br(?=%aDGfeAa!!-mvbl z(LJQP=yCuRR(*c0^1KbV!nEGtX+idtszkB^mE8I5&pSWB!Bb;9`EP*ltWQOIXHZ|u zHIPv~Z)UUSG|m!B`*-EgsB>)r7dI7lr|Kc$BFHon>Y(Rvx%y5cgZMDJc>d6E!c$e7 zSM*>9m4Ku0<8Z!=WCgHTUtsRxT)Np%vF86MSDHX|t$!kzS^0L}*d4KIFXx-tIk}1l za%j#l?^p6JQ9;A1NU7JXpwF1ll*5kCtYB$8g~#eObtK~6SJ?Z^a^$^9=*NuUQ4{6! zxWsXv>N{)9UC*a>6pkthR+v8|MJ#b@CMUvn#}e1HbA{!PacWmlUrNJsn~yA{k9f*I z^9X7G-&==&fo;4W@e*GMlf?a#@LyA`DUkWqD5NSrgSWmo|r5McS&nm(|tSN^>`u(_1^C`yczTB_6$z$!hcf!k+`XR0%eJ?A91VT z9WR2H?ax7v<@&tI%Pj^o5*THlS(it7?$|>4VZ+zQ7mU$>vuFiLQ~Ox8C$s4gb9Qq% zZ$XTWzATP<6}lBR>#`Y9j(ioBT8~VQ+3x8fU8wE4%Bwq_F>hoe&0XlfLXqEtBF`y| zI^!V0X`y21ZFI47m0enQU6eEV7sc#RYlM)P!)ba0KL@!JuA;n>ADgAMkR-iw#K~&+ z)jGlzXYNMbC&b9qBXQ6ZRG1OX{AZ+OHV(yhWkBUXu z&gmiCg~~gMRlA%oY{B491B0FVoQQj6LBzeb5RKWD#bxf=Der^N+d$9w`!+RARRDyb7u$KctSv$A4+|}k{2@?X~Uw4a#OjH-=(lHUv>;Pk?N+b~Np2jBDj>9$oee(ev?2(y0ni z_xW!#{I^#Bt-^n6^WQYKNGUB4`6L?hCY=t@B2c<{{s)PKyh-UpGL2x~3j8-ogS<&G z#JA;sfkpnCkw+a@$|Jr>Bqe2tH|yc?u#m4VRi-_gPDy7x)*{s?foh|g75Nu5GY zq}`}HW-9kXlzZ_vd1pnZudc5?`4dRhubLrYy0L_d9Y0{8BjgXTZn_#d0yz2!jy#e9 z$1y25W&np=%R5CPE>ivVX;OtKkW@K-Dg-hCVb!>-lw<-B-(Jr)Lov)M1WC1$n7a7l zw(&@ebV&Nq3-#uKxF+*pK5ypHWPk>P*pc<}dM=;la8Z+q&{aahMa_P=q}7CTv`G+= zruno2{+*3!l&Mj)y!SN*+Ay|Dn}Ef7#8m1oT1O$Us`y62sOt)9R7wIQ>Mjwqg0I;R zT?3C34mqcdhBt-BMx6*_|1>6_vnK&rc(MSk2*3k1`wkw{+~ofdyt&m>?A$z0)t5SR z=MzR9r_Ka7FEqg&x9g)dXYNuzbXE`sV5=+l8LN0UXogn)6Rggyr()-3^@qSV{oy#K zKb)IQe>ive{V`{5vl3Zz9Q8*4HY0K0!OjBP|0&pFsm{&v&nd765Q1%g+v#R4L!!Pdb{dvIVcAVw`{~@+Rz~J0GS`Y#DSVF+IO>lF$3GSGrkAOYd51k6a z0BmaCcWe&;+y5!p)xZF43nI}rp=jF#H!n279VnrE+V(?d1z`X-eZB8sb1#s1?B3J1 zq-#~AHKRgjZapAC+5$+VO$gLYCb)UC3GUcJV2zmDOkgORP&15pE$=?}Z#26zum`f= zZ6@qQ_KRPUP9@$7gfvn!wSHlW^~mNbkBE_~o1G(7O7TBa@r9(N_>KP;6raI2CQJjDV;86`Dw5C$ z9?Y8lm7&tp%E^~>dhwa%zWH|ZMlEGE1GeYix<9_z0&U;&Z<|8%80^f5+6b_nF%`yg zLj28k#+M@qR?wJV_T#eP{J>|B9qUR?AVek2nQQgY7lPOwSv42yqoRS|Wx=Q4fL>JWJz&44_- z(eqhh&Xb>Uw?os%qYAZtGK=`+rTn8PWO>BTCz7@1^$lO4w;?%)R}8KY{1-Pcr%Pf> z-k@wh(Z9w1S423WyRlM$1$) zDt!Gj!jh;D5lN#0-H=9v_F@(I8fWdr`fn>}0dEpa`Bu-HC|0tl8GULx_B*@+VKw!C zz}Aw4P+~<`$X%SV8ue*ME4GLfTqCV|qhn}{59eD)-ZDOpsxNS|~I z)#nfB`}2HfqF5@rD|8L{6)qCpS%phBD;Tk)UJPW!q7^1^mzp5HkN~2qhrSHa)hvfn zf>i}0h;@J@}28?{I#p{A>kx|kE+}aQ>cy8qLWi^{@tMvV9qp@QBRGeOXhelwh!DD9Cgj5km z`*2WaT8yVr@{SLwqFc?TMzrMpuyspA>3*)ZIHFeB`(b0EB>hUnDtk`tFROcn`}sDr zdQk(=O^hzK3Y)AmpRvx^Xl-ozxmCEs+PGr|m99|pzc7xai+QZs|uOvFl_3|l{4U%KBCMaHbMCn;JQ3%>_qR_Tk$ z54BO_x*}W|(hzvg{9zf%5R6fN26ZUZm`~r@kbHn={1PSqO!z>i-*d)K(fE)#@M8Sq z#^1}d=E(&r<_?q1AUN(%QTO`yxy+^=!G0NEqV90k(UtGxgXr@23yAMmH4xydPH!1t z#Y^GBc%6&6S;J$T=fOhWUx6nUHIvo5aa(4Zo*tXU&5RSP_Bk^L%w%xApS%|8=sd5P z$a+80{&XZUArGI3G3Uc59*bCGqjINMLng{Hv^eUr%D>A)r4s`4%8rExN1rYW+RPi370A_kB~XiNP3zp z1%{?^6S$HcZTFg?_NZ&vjG0+()qY4N$!ituSBfH*6b9$E+pnYU#U@3+|Ge(2sQW7F zKE1r^`sAzNDySC?TyOOr^WU$RYavywdpg1?%Fo2$tL6DsI21~S!vL3ygiHG5jGO}g zM{{KOAWJo@UT8&oKapxD&CG;hu&>?vavIGJm;3SlNq)QqK?DloyG01BgYBA^S zq=X$)UFmR`)npDgykXUNrlB*qmh~w+aVn%graWwvRT1aYgCECD0qsnDlb5JmXGN(jp(-KChCM#LQ6gL`)Accv5R4Zn_O6aNICQ zpe5|gh=ayinqMOo`qq?{eB<1_!HssrBaOz^Jkl5%s+N$R1qmB5rxns=A}cmKxrr(@ zYHV=1dTn9A&u9PV{yG`im{a8DghI}7YVO#$sVqjPZXT`DaVlOAU9sR?V}L9euk| z%HvQE-M!2EBI#QGkj5q_1>3;Sk-Qr_tNe=2D|KOI3?#t$G<9X z<6?f|oJgOIhVenpQ%&(alt-N1>?N#HWw-E8guNhyAOVl2EQE>LW|f&RGc2KICn#I5HzS%LwN%dF>efTfvH7e?AQpeIu$ny(&Uv4(IHO;i-kHCIEMS*P}3 zuzP-+MY89+CH3{KxID^_3f2XoHLRCLy}+(b{PQ(6&}4) zF2+vh-DXq5w`WkotFtNLRX<{wiafNMh^L4^pC%X?`N#!WsJka+Nm8|H76EZ2aZpyo zjUoj&Q~zKN$2`}*J(%IJU(;+7bv_o7yqD;y-brd8ovdbl zO^aCe_W=PmJY}WNh7bGXD0E8dVZX5uK|P&nSc4oJI4{8<{6mLK(gMdZ-EF&9(H|@{ z-OCE$VIghm+9Cdxm-BDZWU<1fz$ezIMK7UQ^%9z8FRfTA{O!JvrNNiBsQ%F?#l*s{ zEb`iZHw?Pmkvz?i9wLfcF|^wlD%(SYs}A&rIyr3SeI#rg}Q|z5Fwd{X;;$`)^b}+;5HMm;5Vfdnkki| zS)L+?xNQXVQc#M9U-B6=88&11GY06CANLrbm|quN!T6NMa1Yr*JODDjuem%uyD$GU zzFUb--idlC(Bql$<&O;WpHY(hrmpF%)fyT>Fy>ZfAtOE;N!+%SvNhb-RP(?^1Kfc6 zaJ@D%V@`=kQvT;7P9!geJxatmt$=Z^lte+=W+Z5|4y1A&&BxpT!Dp8@dp;0752<#p zw|eo}dVJv+#ZSU^a>C&F+nX}~!nC6HeE;O}#r|()YmFhczF#LJj zTRjtBTO9|TzWI|QKBKCI`-)F@=2QmpW*FPZo%GyyX}Y+hck79)ar_U8?i0`dLHn4C zUin?H3lwV4zv;uH7>!*tfqe{%&(Xi^7O1V&GryZrSwdS2;E~?#IAAl3{J zU)`I!()_FLH9e(<^J1##qZxb0pL)(O!qlS_O+RJQd3{x}7vrHv`Jn~VW7RXG8I{B6 ziYa}P9$dpGBqslWfOd>DlhJ47+qdyiJ#z{!=mQp|A@UhOb!;25@(K0{4+gBgEg
        okobjR|hoGM|Os|ISf;_Q~fQ-=@Ex`1HSkuO8zMGA-vkQJ*yapYh*r^tAim zeKzBB^oKNk?WjTfn6=b`&nut7U&|#a{)>}1Jex)B2=3(htO`GGeZIWS)qnmuxKn;T zOf$!X&#Lb8x6ii`Et1150 zTl+fI%&*-Qv=24&ZOOh_!`}5@&-x@vmy8MF_ANMXbmvb$i#GcjDW7Bf1&Xr#!=x5r z6}pFeeLwGbF!Iz7Xr1AL7Y@tNaQMMz4u`$NXD{<#^~@h+R31fr)tY7BE9kRTeKokN zfB3zg->YX%$f%TlqaN8qf^+3DJyjkcd5@Sz3Q<-R6lQP!oheZH+HQ-BRfXt5)_gX7 z_ktfVWA-}!fs?O3d*O4ozf<2(&*H{={M`SszM)%v6aLrrfj`r*BbHz{m9h`J{i}WB za&PCa-uT0RbAJC{m)|?R`SQ;#!}{Vc9qtvm4+eM7%cTttybf9;9?H`z?ga_h3PT_J z46f}bL0=ixSv#!}RUuwwu8$74YAVm#=SNliP&EPhWDKLPJl;;AUt{f31^kGVic!BQ zjkPPx!^YYN2=}9edO}i2g&dS1HL`xhHWTC>W%7B7Qe3NfFpttE2bqisuSrn0lz@a~ z%k>F(SMXdPJU8*KZ+XG{P@W5e^hGpY--?6xEvAh_s+x&w)ia@L1aGmWo-DHM#7%+* zAJSFFvh*R6DM1R=T}%m#ui#bCKOvk&a|x|7fiAWYpcmY^i&=f`j0bsTxuTY*AZ}A z`U(Zk{M!{-SX*y`#AXvLZZ^T4g4P-`f2j#>QU+_tZS^Mjg;G+A5J@S`dTX5T5$I

        y8C>i`;CeNEw*k*F0d0- zNDW~2DKglJL_H;YODU6m5U=eAK5-Y|jQ1P$S;ecDz#ay{D zoF^#Rb_&^vlkmNS3vqf>aop9t*>+}av30kp8)ic%QWzc4#ObxGzJm|Ts*9zW9?@z) zdf&bNk1N1A3R8$6Xw}|n3V6mF%sdE;Kvph;XIxx=41#Ru&zvH{9_mSN)YM^EJOs${ zEiZm!@@{3f0OfcSZfFbG{)-@hJ*UfzF%21NKPmwERde;X7s0~&$I--@9PS?5$|2WQ zF1Kupv~ysoVW?7bJKxYq$;VYMVA#$ja)rr@HHsVlnZ-v;Bu_4GK8lTpmkdy|IZ3^L z)E&UO?EANybr}b#Hv;MV_=4rW#j2N*M;IQ^ko;8p;!cCNX_E1Aet5M23iN3K(&@L$ zKs>Is52Bg6nM0md!9vF^H>vK?HUJ$0IM=e3+FqF#;g&P2_W#t~@%GHBImYiamr3M4 z`BQ(nIPdRAvGp{zz;#;_9w(9NV_k|Gc`t0HRbiM;= z1%>7Yg+B2&HWqb7UDTbwP=&d<@89OP>t202&(FfK#@tte_*)eJT|b_!&)jt;9+dhZ zbANjUDI#tN9Of=FAEVCth*RI5f0jPr=v)ScL4ukt2~G$StXG%1{VCuQ^POACO#xrz zd(3G~=1{%=y|l~sov(I&@0?5YB*`u1v)8>ckM12xXH|W}j$fOTQFW&6UP&9T<-Bcs z)fD2?DL4B);ZsWZLj3Yxz*s&07V3y_r>=THhy4ZRg=jq*0L2R z&cEi1Zs64gh~~Ke>11bh){+Q{8`Dd1(|Q)iA#2)fdmUF1s8099 zroG{b;WL7J_6liWil(c+ZDZnErF)qQyWE*hL;iKE8seATSN)NKBlt;=I8PhK@q~Bb#lz?VFX|*) zZZS!oQs#&|F-LCS3xZT7ekyr~FKD^9D>?Lj-<$|zt}bJlb4|HA%?&f6>#M5lQ72YW zH1;a;4ds3}hZD?KW2X0<-I(l7`P6Io68==c0j5_u;x9auZe>)xNO_D zPJI#^ylnZX%LvQ<7<=q7C_j=XTeY|HHX)IOr{uIez>%!4eeW>Po4i6CjB>bioUQ{3 z0ad4Z5>=T863K-b ziLxutBGC+!2xq!}Bd$*+n(ikWPVAZ$(Hj zf_|k0jqm?N1F}8;%P%u?#2>dwm?2xu`Q^&u=7xjsyI#_!>`jHlG7JY*?Qa;o#GK>= z;w1G1QbokK$-AR-8vgVqGw6eP`j3>Pd3uHt#Ah%rYHst>7Es@FUDC#bv{ioE5NQ|r zX(co)>yq}YAnjFt+DW8c=%-2?WMz-!_Ee~{m)e|w49*)15N(O+>Jta zB;J@8o{QlU^!yrSwmcX~WZ~<~_OLZ-^{zb^o!2VOq^pOjnICP(+lOVxn_KP7jo|Y= zt0qe0aJLj0QBTWDZdA9W+G?5rPG5h)h(*2J*XWD+;XLxV$3I3gyJTJEMCQ?E+lkSf z!QYb#T`RF@CJYyg`-yFQY4ytA(9R$aN1ZLwDr?0o3LNIHa?L<}iMf*&P=rfS?!>m1 zdn9n7x^{CHnc>jJ|JXhnPeub=lJ^t1Q2J`Ugm z9YZGtT!yN;-5+5VDuE`4b!|Dl-(KoGgX0@kd#=#~h%eS2E0)G3wo&Jw-s-O!?AF`H zXATrlUFudfmAbQ@vgKey=eI*OJGlukWYxULOC&x^Gx#<=qA;Nb>@_Fio}z3ynGvV5son)$B?McT{g%(D7Y_tGX)(fQ;G%D#aNon==Q2~>_A zl{sx?&USD4msG+;MgiXX+Up|@LCLIo9BWX5FB&(FHgI+1Yc4}?P(eOwWCIK`G8yD~ zw$z!PQ|eqi*mg#7g_#i8<)kvUuyy}BI>S5gjKi?&Yt#Xuchnpgkx@(5ny(n4Y(@@` z2k6nqDj2hB&IKOt-f9;7v@`Np4*B>Q^hQgXty-y^(R9$X9dv|_XZ+tV6+NI7X{FSi zJ=mmL>#IFTQRcLIKZ4MrB}ZDdhowb>mL1+{sV`X_t(rbK>U_;#z$Z{{BxdHVmWjEH zSRJmjSHouxPG-}CDPnkg85XFQid!dgi`DK!PCqQ8y@@N&mWBhFJM4rG0+^Un7|~fT z;Fs^)m3OmNK$0{rUe(GlZE#}IGMZsr_TK?=qKQjMygg`asDNJPa8H@e#FQZn4z|sC zQROyAQtGBgFznB6VM{U%2WqlR8~c*W`gW7FxEJiw~m4)OX}FLRnp z-I(ni*fY^%9f?ZaGFvEqS9NzS>8B)e%P^46A&oO;aN1|5fAU@(7ver+7OFv`$FsDF zaN4Y+rDfQUm$^RxNgTqtO;x5*(ErgMZ|ZEn#SF=&&U_~Q-%NUQU$UVO=zN!FcY|_Z zK(Ypg04KwHrr88`((B$r+1}f;Qgt&*J76|-|K6le;oAG2fpUP~>)n!82uwrdpj(Js zro`!ptomNZce*3$)$~X(GL@jsB)GUof;>hsoe)i4ZOFH(-dw`SDnW-jhRJR>QN{VJ znS)n<1;{_}hrq=-$pQYS?!&|HR5L){;M@Y4yQfHTj^qaadym4W=Oll-r>x`svFG%f z)sRw7^739k0#Z)$G(LIX`4xk8sh*D4)0;HJ`-YyLf$Vy=)^CwHh2do>+1EgnnGU

        s-1$8Ypu6aZlbgF@!%O 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

        YCZ&w0+XopYX(&5FN7V;FXj#ancrMWsLHgzFnj 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�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

        W{$oK z-X8x}W$QTXQMQSf)8n0P#9wfXDI8;hBk9@^<>!j_%>R5o^z`_=)5ioqV2f6 z(PL&tm3W-0#NmXj)Pv5$%%$C04}H-IAmSysq$hbMOCFONI)vS9)&xxWCT8QhEpDpL zkJvKOgfR=Zvt}N?3AZ4Ha9k7~COf$1lWv%T!C13{Cw!8NiaY|$Ml-$U=aM)PYdAD8 zw`q$x?=K=^~X)+w3{)r?+%$6Ta zp&vLN%s7BG+F2_e1oK=s6U?(W5`5>*?q;SgNYgC7RL(hzW_0$*^E0mun^>j+;vBCz zFrYHUw&H()HdoFE%g*IT<)9E{Z4csjqRH$#W{c)eXI5;gvnS<-tdW@^bqAoBg1BMG zrm?_T|I-)a$cy%2?D8I|qvl|-SxRCQLFJ~PF+zq~ijaHn4-np3;^59f5F7DOU6uJY zE5**rV{Axp1)HqbGp*qpAg=73z!s*iI6@}nvL3dy_944B=A8C6v`=4rst*2$FLFQ# zEU@=#%>sB15LMTsD{r}zl7@RDMr0nu`s`tkBL#NK&lnG?gR^|4Kl?$K?iVk8LbKAB zsnWN>%Bc=s<177;DqVIk7@?aK!@=l$U1`=Jq>K$2;}`Lty0OM(a|hPB{a}13F3ARJ z&Xr+siCo>NGyxa@_dLQ6824|Vgk7rx!2w7nciMU^F3Lqi=P!iXu!^vEFgT$&&IY*D zN;9sUi^xSi$i=Y@wkv4|G-}mq*CcK6i$qi}C#!q#yswyFE&wa0nmBlHS zNSl-tX_Hc(w5gtkE9G(Uir4Qr8OxYfdEM}ugnKsrZ*;19s$x@X}mVjQ@e*(ShX8^riK~L$=0+ylk)T0Y472k{2ZNX%{mZ*6D>BYm#fw)py1U9b>6R^mCS`UKLnCF$M1s8$hJIt z;23`wNNkzR%99z*o0b1?vy|qD>>SitPFl!F8LQzC={%0zy`V<`z_Bt8(`#H*6E+)3 zjX6Euz~F`pY^kq}XfGbNj%5{jc`_x>y4OMcPW*(IJCTtmH1Gkflv%ZM`?x>gjwUt( z==v$-EPqpm4)z+#FPGM!teH;`kiMZJ2srejn>~Gr?58ImB7dIztPNSKWhRO()<^&o z5KhGEh^fYf8JVHRd9dK&3F|JoYY5t%gF|Bj-+^Mi4~Irk-vIgc|HUmy+_ZV`?#r7A zFcFJAg>j>D*e?^rCJ)Jp&8)xO2UT_w>};iwX<<3<49B5?uy4GY%Y?zcgqcj(&sXH{ zOxUg7T!ya8@MXLi=|-0p_LoflmXlJw1s=2Iv-;-Z-&6Yzz`v2c`J7M}_8kT7!56lT z8_W7mNF`#gMT3E4H4d$Wy!bcqGB^A#fQWwudLC+m=Y_Q=dtTsz*v$T__QAIY@NENz z?TX*C8C6rco(1_Vfe1OX>pS83B&MW~Vaxkv(x9JKo!L93ynnxSz1r&c61U8MK6-I% za;je4w&+z+OCL?345z%bHqI>X?$_AR>(s7J&E#N`CQrM&{lL=((ti4(*^vD;Hnq14 zj#HZNPfLTJwTWDYi$v74NXEue%HFRroL1fuk|?no>Q|+DnXk1RU&sNr>3-_8@V!SE ziq=IJxNpQSG#g2cIWNucnZA}VXp^@Keq?85{akuo5`KGb1Nc?ca%vnXkDy!Y*vb1n z+{tr)rY$YneVTUpcGQQ}Q@J?n@v5$>&Su=d?RJwS`wJ(1-29 zuNAeVNuV6t6w)+N64MXNI~HHp22-M4M0MWGtQAfD&=%0?KZcxzkBQTS@l#d zcji~m;&i^EmQ(vc*~t)2nPR=RaaCh})hzC4tD4FUZE0iNK2T&qtX=KBYH3zQEt|-O zWA_v}ThAx|^d_wt?iEbC;cYD5-u8DzEn5@7aGPRoe*47DKQe@|wuN~@diDxtHJHxG zn{GxwPGF()zyOVfGa8+oM@T?%Gu zojKT^`jfkuD{5s+bJ_7woK^HqowSIGgLD5jD2_H2Zzp@QqLx^+pfAoV``_w|RQ?Y? ze_RJgj@aY$G&bfOIQx&c$K&&3JFYfE+C8aG+?IaJLWwiQ*RgLNCp7`;crtjl*msR%}eMw91fWaHN zV*B>Jc`S8x8^qRW| zz-+O(>vM=An!EO31bof?7V#}K_xc_zl4$PZ`wL>y#UCWfmkvH#^UyIUXN+kS+yTST(J8yOX#ox5n<{EGdm@# zGXq$iA3avz8^FM!@+Br;;;dd5XZ1UGMLG6;Pb{(f`@TEk-V=iI>|#`S99hWnvZweF zHcD+>md6**lfDP6D3F#u-vojb{HsHuWk-P+M7?0F?)^>_v8FP9@#S9g4f8oDhcp>r zUw}cwQ^|Ou;h*v_92-95Kw_4V@k0?$Fnt~FC~em87vzkX9A*<4|56wLuy!Q{8q6`e zi)8n-91)4-oOqFL`H|$jB)*?;S)$o*Qi-O=_x%B8i_JdBYxZdeBsY5$;#+9;Yv?m< zWTK5N&3+8cmYw3`0Tde@`$Dt}UdH-)0GI5^zMkXW(mM^FL)QBIj+ZqAim$lvqJmm} z$ElO#D{So)c2@Z@Y35oNKC9B;cF!!h+4xGAs#TCte-9CuU0_9ED{J zkG$ZAf51Y>i^F{=rc%s&!pBW+^7BE+o|@MQOvA%_t5GasKPhYJ_AK^Z(LkPW8Crmg zL-D8s{gW();dLN&5YDrKCk1SS4D%ASYgk#a<%F@3X+mi*z_vuVKd8}`O1(YwIN2bj zaFcO3enn|64#0}0vqUu*(V2UrWa3mUu7%Gfs0?52_2zA0L#%Rt1*Nn!J$IG3)Y;yKsZH*g#^0nPX6!VU|!4k>MYZcH2yq_}>sO(C_hL z#U31Umr{_HY9w~$F)I%$y(U9`Efq!)U*{di&f=N2duTOO9s{dT8?gt(_| zw?M?du?0R0>rXQH)RL2^jLAu~w<@4p>djjf1@TPPTF1JG>T!W^;lDt6sOkdaE*unm zSb8`*0;D&pE(SPAe<^Hm9PCE1zbzE$mrkU_9El8ap3Yo{el(u%jCSy2RYt*c88~}# z0NccevDP}>P$L+3l(Z5>$12!60`?pT3wL@BR?q`pmNSusV@Pxn@CP0%&hzlti8+bD z3gC$Yjzv-2U(d%RfI>l45gPw+cR~S&;3r}Y#0e2x(}+!=F@=E~8ksd6Lk&`-IgmfZ zFyPEqiP9a|<-!Kdy@SO`c&GP;2^Q}`ZQo$70FwMekfW#$QvM}q+suF(_z|NbKRBOVAZ*Sr&=vfW zU~^_rx`L!P%tchH)D`zAWv6-<@jDQ2%I1_9kXU|Vw(tsdMI8-YxUKP3jEl25R#K3) zK6(#Lfo+XbP6q1C$54d6$R^%e;b8X27`Eu)2gheJp)8E9l_e;L*aq|(Vxv^dQL%g# zBa7foWio}4UBkXNvZsjIN`MIJy9f1Yb);@Do`X3i z@SKM9$WR#=ar_h}Qh3~A8Gg5uQL5i2}6zv{~Tm`p^g3JR*u7#=e@8>uQd7CVOMv`E@96mHCj6KPLu z{q)CwX%hbwTO46Dc;=tG44dj0*B%154x8Hi@kep2!k>S!JoROZIBDq}{9{KbfLbO| z49tbS(aPt|MMT&n=Y!yJnQ`!uxtF#1v1=*j<_AyX3^4 zrAB8pWdx^>;tM-0T-%pWH6PS0LI2{+S|`K29POMl?&9%R9GYEdypZ3qVDjp#E}ngC5A2 z-Z2NL*Z>t9tYWz;mak&jh`FOcI52}BpMS4Qflro)&nwOG*&!L9qW}_pl@>nAQ{#4O zj@3S?u)2n_PAYZBsevX`DqEdIrL|zKbg^<@V&UXY$Vmckz79+ZAp*TfTc571K{`9> zE*wvCpB2km8M(SI-}=FirMUpvA!vl6Na2TdiiUL*b|bqNH-~joGOSkwRx^ycX((S2 zN-sdc6eAl9ABqLnoX+u_g2AD5$UGx@A1A*JvWXvE!mQMSv`z3Mo1$g|9Q5!y_gbix z1gJ+mP}rHPKuvEQC>$d#he84*4*EdqEDzFB57G+?5(jCG)HLD`-!6U1zX z-;NAw%H&I-;Sxe;E1|P`0SsrtZ*jl((5&qr;VB-QB4tG9i)$)=pOF!LkqMsmTB4DG z_L8@r`Cy1>R1AoeIyz;)7YHV^iW2*QagzJ*L?2#y{OHlo?T=BdiCp$cLRssH-$8yF zL28uJW1A5z=E2@%hP@Co4eU^$)?n@C?Wnzas^V8Q$0Uxkkt&}*0N{!*I4P|HT553A z;N2f&U$;0Z&_VwmEnI_~6+$QzHH3%E#e4L`Ex|lcUq0p$zCjliai_KA!MdUetSKI> zFIof3NrKg<39S1)SZ-@zO~I>Dz>6j)+PLggEg4S=5cJu)EdyESM);&zym5DUKxTVD zwj;xBi9!LWjs%cm56FBENOo(0Jfnb!l@tqRDj-_97|{j~)@~_b!B(QY^In#K>bG_7 zgA@_PVVG~Q=Q;QKdnV4J#bhkw6x&>}A6a^qj0Lf&9F%ZYTSg4$Ktlqo<4aSg=byaUv z!LU;nFXWym2wkEIeTMae(0 zoQ(*h*f;pm&K;*yyx12=O%z)yS;hWvkHApvO~&o489RE!c&!n~wS;sd6{eRdOpioN zvxIws45(S%Gf{{OWKInVaZ#XhSZ`IR9EBoQFb6SDFTBbFyLQ%HJD?D{I^dMVYx?R0 z!E%DCX*ptgw&^Z_MFg`8Z%GuxA2a8?%PteM>v@=6m8-82qv|kx!1EXGLwL{1BftTp zd6p{CLZ=54&H&m@HbaNY(UL4<209h9(}45d?`U=9u$M*%BCiM{!KV>(-LD1hwND^x z4zoU{vfit*KCQCe!mMu~Ys8uxvF1CEpGwEZa<}Hoc+%ZE=}LJ`N^(VY(#a_3T!V-^ z3f$&g&d@P938p#8Ig1JV2x}?6IGzck$u@S@Nsj?DA*i7+`=Ll0v1cAx9_LtspCZ8< zI!1nhLYA`6t(pM14Aa1?@l$V>3(I{tSq^M;P`uqifCPV*eiUa$+^-;oq1VMjp)7v) zD;}tC3cXCA|5>14ub}@^amkJf`rU}Zwk0x6;H^;bCUOYG$|rt+?NtKrN`ZHvf_JKd zx0`}T#*MpPq!hpsI{25M+;DhFb}CCqG!} z#d`Bv0lVx*AwpxZ@X;6rb}eGw?Az<~q}Fej0^VN)-pvZ$(+b|13f_ZTg115J2u)3m z-$a3Tgo1ajf_ILBck-6teMfW8>m3d68iBX+25GOM;GL)7bx6R|YA?>4(rlGaP5 z7L!X)zMi9eHHe=B8w((x!R_b5PV}rTxZ(>kIa1=6o}qwodL29jIBc77Ge(pMHFjJEQRe1@JxlQ<8tBE;(QXG zt5N*vdR(^AwF43-sKg3M)Q&GZ6EXPN>FR<5c&7Y_8x*T>bbMm|x|%=QQ`(5fzWo}> zFtafrdPAD(9jEt+X!iyv%GpA6Ea0KX-6b$j^ojB(5cGf31CJJI+>E7r-KoMH-DM3R z8XZQ?+!{GnxDa7rwgK(;c;E$?BZ~F`=N~7a*vCk4?q=w7hHQrLbRNm9j9ybu#c47M8n@`M_b&zUU3YaoGOeU3YnYTEh795<6T{qz<@jy6ypCkm>VFU}x zN?jUWH;~0^{%W+O-poQK_9SC8+In;WHyQitxf4?|ney8{O$#2wg7xOn_~B!FUilAq zK<>rJ?fK#DtWPh&@xN!Tz)9v8RQgURqt5T;0*2GTA`jpbXrLx<9(_26OVDSgiYfZ= zv?fV}?x7RT>97kgNtA^#r_IBDQVZEb`tkIbBr`vnd%QUbK zg|(Bjyi1j=nmO-9;5Fqc5gjA$1^CBfH#=(wHtLh{Xw>I$9C@Oruu{E^mtp6EyiX^I-hziEr=sgbz4>4V3kT0sW7W9v>j7G3VslfFcGuMSwc~ z;68B4&GS-BcgDX97`D2I7w>QpI&La~yIDeLE!Hem5Gy{m;?oeXA(=+OwWase-6rp? z+33I9B!lLP*Xa(zy70pCYh!vYOyE?cp zn&{nUa`KaU?dlF(YNl>jkTP<^f)w#?SkU_9yeV>@iE?cx-Dk2An}p@Y2z{SP2;&Tt zJVy#>eop9cDHVAKPIh50v|MRTae~;vrMy@JmqC%pw#R|XB^KP_9>^~IJu3Dd-l_*{ z3)|!FiKf&5X$7QpoNzdzRn!GbKNr?!7@#z3Pf;<=+T8A39Sp*Z_Xsp_Mlx$3EbF72 zXYGUvW;>mOZ(9Ww3>*E`7fB&u2Cha6tH3LEFIOjYYvMCoh-}CXWYMiPk^$W(xmJ?8&d!k(*9KW1I4dowkNugb zj|Ko@x;|Zlu8(6rzDa$frdM zfNMO!BNSlYl*kA8Tmn8-v8^yYe0b(k%zeC3OB+eQ6~P{P8R^x*j;P7I?q&ch(LF4V zNGb|DcrUrc({W<&1sO7>NJh~;|;p*T| z@R)e?$eo@{k4L!&*ba96fdhrs`9hDwNe?wq#At>rC(NQSi&-Z}R9KO7b0O~Us6%o- z#c~#BPny-S>6dhi*@}F6;HVMdQvCsAPD+hKDeWXs{SI~sI2UK2-_Ig;o9O|!kfhdz zgtD2qT?_qtG;IkiTH3*}Yc^|0z{1ytgm@*OZL>i;rxf?Ip=O5Bx)QVwvF<8XA+cGx zh*byg&QECD`Hv`3iJq_4=cSkorc%T+9U4ro1o97{xvmE+SFaZ8l92{3S~VfzBTU#p z$o0zKk`*fYeuCg6SECWC(-@_mQ_0xV*0@l7nx0jk_W^0G{4cK$hs5lUgpl54IwMz0hw(G5 zuO3Y*Q9I_GWd*dwX36*pzCvb9jh5rb{RzaYH>uq4BYqyQUX9qgPyL8JP3G2^`w+Vw z8Xw71h=oS%sUMmmmQ;yG>}Z9U6jT-~5SvEC77JojjzCNtMv0bl0m(UAA;vbrOFBp) zrdpVw*apm0P);mvwNu~8X@*!*B^t4Z^Mzt+mB0+35+IgI#2y#Kk}TDU$n2i?DTcl= z<1qB~TY}ID4E1NIkfDxmBXlG~J1{hWp)VQQm!WSM+LNK>?;x}@L;qnYlcCyo5&FFp zq4^B`#L%?&5c-CpM-Ylwi=0mwnfpGH-({!)A>84=vZxRAc78U3Z%7b(Npe9k5ak{; zM7!=n)=9idOzbHO)QibpAEahuCj_#2y~;<6Vc5`cO>#X3oEtgj|C1ZCvV(t4)H$X} zovMGtU6@{-iD5Y4bYYzXRGp25@pgVG!9+W=(Q9Z?34c^O1K=tI+0Kb7)z?lzF{z!2 z5jx=9&8hE8*jMG*VS22f;U@wOHt7!Va52fw!i(3ia#_-cvPsJf!_&b-%CCWP6U!N! zCd@)?{BX8|ec>L7P!o~Y)7G~x1EQ~sUp-0i^yjDfIVko-68kId;!NS^WAGWx4ACOA zCoL(My^tIOkJR8|2#0m>gH0Xd&L3gp}gA+}@-_OUwx3)utf+`XASVf@GEHW;$5$!}_p>p7+j zS>yvJLf56@2^d(cGj3qn$_f{gN*)n`D=5Ank*#xI_!u|`i1W(`={CD~aT{7;sHcrq zF!T`h(o%*#MMzheAkvoFikvjiutVDY?LX<4Z;%aA&?Eu3LmSWl7TcqE#Ht}uz)h5x z+PV&dNF>A>5VEt5`J4=fX}q2FW z|DKFp0~9yuIp<&%D`CB{S^0=n2X8+jVFlGrO*S#F;SQ-3?i2yw*+j6@h+PwR%Br)p zGI6@Uml%D^u1L4@JTxF}946!DtzmBBrXS^`ah@3h9&wQXm$=*YBTgy)b$G&r{^Wt= z_Dz?4D!~zC^du8nPbtn82@q8+==yR+{obNxq_eCy_gp-|;o%bysrz+goeUTdJ`EdOt8tb#NLA zC(S<_?gv$%zRdSvzU!4J-!$%?pJDvj++y7vVu?UJp((_258@93Q5Kg6$&U#bUpL`I1`UwzSti8u^RO^D=_Wh1Pe7q^dx9`)f-bWzH(vuJ3 zgM@f@YKUFHfz`n=O(EXsK_pMqo3i-igE)#1`AAI)918_vr=}1O@*tim5GO)zGkg$# z{}B*>!~$~ix)L{?nUe(KbB8ve<45=ER$na;WdX_uaRwp&0}wSEXc>m;p?T{(=@Vtc zoIod9k|8|`2s)vQ#9kE}L>tlmV^ym0^`++Vg>pdQR1|cL%9Smma*UuNjOW#)QMvowgo4Af z9H~(`q&X@lHbX^0*Qk7bSW8stC8!9;CQzZ7@9da_O1IRgJbHmpMQlplK?{_J($_%> zx<=(pg^H9=b7`1}x!?$QJ3&QQJ%Nhw%H((aRQV^^&CB5Hpgk2TeqI^U3>5`kqq5}C zmZp4`F1QT-$J%<`Y z;Z$=AHN4B*LJWt^&7qVi2b|&PN%vyFKxKy~D%+!-E2FRmocBQ>cN55i$`&0FZ`o54 zY`>OK9N|x5Wwxs9tVCr6O)68g_vW9Rif$blDR2Sjm-A2=B?~S4;qZ9N-jiVawTvPa zaBgK~&q8mYvYQf>UEI!emWk2NG&X_S!1hJgQ@~|t2Bk5mX!4|*Eq31%@ z+s;t+@h(6hN`LIBKHlhkJbE5J9x57AZOH?GO{WX=3%oqL&W~dhva^0Y7OS`~ ztj8d{Cy>|fKGr*56}!HNMym6IxHk~RUS+Wg7W+zu_1n-^IPTtdZc)X~R>icHY?yQE zSz6_?vu5eQt4yCdG%;|<=*w}mz zieV8!@4v&0|4kUBcGm99|K2*}A3{Y8Bv+m$Bq>qV=p7J-8G23fyTg(HpUl6#V5ckx z?E;u_7W%m#X0pjff^!$sFOYQqi0xd@^r@2WA3mK6nZ8WY{bQLEVR~2bK==n1=P;%p zFX?_Q@9fER6Y0Er*kHRVhpp@>``m_r_b)i?G&Mk(^tcCgb z$^lL1Q_=&I#Sj@i>2bwp4cELiCAx({tIDxmg5f|P0_Zp&#TUfDC zVhy2H#Pe^lGt7B#QF*qzopmBH*nt>aA&`|J4amDG$j592A zfvjX0kY74ksP@%9t;hKhfvmMa*8PNh8X^B1@}_qjlB3R7kYi0Dry|2W0#YlGtPnwN zN06lgQYjFCG!)3etpQmrAhqtv`gs`JzlQA>kV^Nk{U@pR_ifVtR9IdwAXQO2>p_A% zn;_>wsOwFowg7UR0(nOgNG+{#8S-yAG|ce=Su4J*5Fu{|$g3{ZV~S!%+1q~IS4cm_ zmv9LahWps{3?>Xz3G}QwAtvPdavZ?~!v|wuB=Caud<-8=@6)aPHcwx!j{P#UUezwE zW6?ahH;hJEW6n=FZH~u47vv=!Y{dNun}cU#i^~DuZEQ?Yu;u%|efY$^-{nDP`~6Zq zbidj9_0q81>sUecpm!=U?7X<|R>K2*NDM`vK7BNO2o3LFUD7jdeKe!eX74BTw^uo_ zHJbTEbLW(3ZtnhhAH2%iDyTz+@1J`odBFMtUreOvJ9QR5)hSiqws3!?558Ur@Z)>_ zKB>ssYJ3%ac`GDC&hN$DQeoCwdV2j8hxb%F!#k&);qBDU@LrCzFa5^1GrXQ{gNH{w z!Qa|JrnWSw-2l!SeepGr#HOBSa@(Y@sQeYayLk9gaW&>FxG)X=&>J_W zk6o2|$Sef2Z*IKRmy{?kt+F<>yX*D6DGw^CDcyL1^k(jlPSW>2f2XpOH2g~izDjB* z_{y}?@Vf|nmDEn~ll-+$^dx;$Qaiy{2DHZic!95y+6jJ=7k<@V#9t+~6a1tFhnT=u zNo|2oc}X(E4gug4=3#63u^GJ2_iSHyceD>YEZ``ImY&oP1z0aBZF*MJvO@x8$HfhI z8amXM&Z~u(_B1npo@T0=s5%cJ+??>ulvi(f;+K+G>+Yk3%GyQXZ_x9C4JGV2udEMHC-v(`OW6NpM4l=!g z@u3Ljzqr-vr+5&rl;BzU}h2g2=*4>$b_K2#aa@!7j6K0EpF>Co=@R8J+R zVbtm{{?e|+%O<^v7?mn_0pN$JDa{{O0XvBgn) z+;2G?8d0CT&o7qIM2)H3McaReB%j=hleXxS+wA&G^;8-?6}2>U0_AKH74~0WwdIpaS zK?8SenNzkn{*p*M46hxBue`mnMaQjj=r$**46m)z$JJBm69%Vv*DM5`KX(bDugHhZ z`fAJeOGPaU2FklOD+@xE5T;&PVi>nrq>|Ll`6qn(J+3e3?T`ve>)M|RtE<`s&%5Uq z>zn-mDETggW>ndd{aZbiW?V(B98)XbA6y~#p160=(Cd#+7}gIaS(|E%&3|pR{Z%c{ zD{5I)psZWfRF2QhDgzb0RU7sS!_I-*lZ{el-wOV$s3n9zIpmKccM9S4FNmHW^n_ka z<6VlW%vu`pTjh_esFmVSDVR8DOITk#@$-~aOCosoXmr8p1*a8^E;#kH(@zOa{&oX* zc-b@hR-het%zRb}<9Pf7KYaHnVlBpHWg+V=91aa(=@y^3m5zsqu>r3nz)cRgKlLY` z6u<@Eu|w4z-aPE@oRgV&+2Vb6OoLg%f-H-tlM=x(fGDYW?pwCo*2oP%w#g69UI2q# z4)P@?U(kvCf}Lx?Y80x%8%J3H%FDYC;_-V7wQL6C`ypNsf9$A^4_b`D76xRI3kl?M zV0|Aol8gA*(Q+OUW7)B|xeixE<3gMbL@SmvVeMh6y@#;9cCdtT%dFy8@A`6S`URb_ z*%vpfnK-iX4LSzx?GB8jkx5kWHJur-mzeFu#UIl2-UJh?;TKH-?)pK~d1WWAs7JbC zc1P3YQI8RFjz7`#V-fe7E-!izH9mA81YpZUa(Kut@mh{UAJXz@Hc5bIA_`-(rvvFC z+{I|UBWa0;Jc?)YG&ouq4f3F3tO#+FRY>mJBzMkfYc$0M@Kl8z9KpDyF1Ge4#%4GJ zJ0&P47bfBP7*Ik}EH$$*11RQameoO_7{7pG^2JXv?z1z@L(#87u>*Ktf!=+`4$nh8 ziDJS=ev0Mt!rR!xaf;z0Er7zE{(B=3t~{zQ?gjV|LGa89Vpmy9)#JX z^q*bB&taT9obdv2sAVbv3-W}mUp*-z zqp+Fs=EW;)W~{Jp=DLa}(5`IMC0rQ&Rb8qZ??2o=P-6~s>5&I)Y@hH^kn zD?8k{V_zfs2(!h6@M!cKzvxEq;x(F&43H6=+U*iNcOepzrPRlM>>U1qgPo7T*riY0N)-HDl8$1L$15%(^#_g*ORQPt}QviR9x52y^%R-SIa4PzW( z4D(6ss})kRE;Ku~Q8&A%Zg!&0mt`c{d?>f$CaHaLhHw#v*Ud820R+=>n+E_7!#o}P z^rejtV+$}E!c>X>9r0GS`OlDaR1|OXQV21gr;t7Mzfr}+avt8GTYC-}m~YU;d-#Sx zqP3%$JH6HpBbY6<_E}+Y^ziFAi0^OhtB5C5wtC2?g&w|*{iRwf==*8U$kDyg+o8gb*d9@4MDme({}dm_PXskOXiNcwV(sIo-gu0s4-^>X7D*m(xK zOEs4F$DhEqKBwCHJg|?%4!Yp`!@%I*;b|IhQY<(Cdh()BY{z}ZP|?LY&J9)0#s{$4 zt#eQqqX-pQxUwj~I|$Aqz3j7R7R**Rn|$b0!$E+Kkx`HGREI){i{(Vo><)Q|1z&^C zXrY#SSxZdS(pZeLQ)RS{?hc*Bms0p}S3$*>FgZRl#LfuWCltn2)C}ZuIuVD4PM{vE z&ZR_HC*b}C86HB`2;4<;LidPubuN;WF*G7CVvQews0g<;0?%yRkY8AJLqTEHSUjT|9Zg1|%eHNW~@V9{ag}$LRzxO+0S#lz}h)1aCU{~TzST$5F&V{#i4Df{lN(#ltq{V~y86r7~ zMcMEBBU!}j6#|;t9MB#L(8CH4o=NF|5`^3o(vAWNw$%logZpc9NN?XNj~@^ac-;IN ztpuEho5ER*bjm;`=;fXR11{Xy5!d-83@JcYs^`>r&0OHeq`KPA|A0$ipV>G|0J(Aksahwxf#MFNuG;389-fI>Wkaj z1=10@M)Vw39e+44Y`x)`+fU$wm&-gCN7&sm(c=UmPwy4T6ME?PSQ8M7JrJJ?hpiHi1gy8C)WnQ>t3V&d(rVAo!vS}?8^NhCkas19;mN9P#3li)WDD2*C@t~T@3RT+=~WV#_5CCbKGYb zQJTQn@pd_hENZ}rK887T>S>w#F<2sGXZ4@lM_;b~%rumQg-|(c5pC+!W8xDDvZ#Bj(=$G57y)6Fm%)omBqD&yfG*cz#Ba{~?us zEn@Dp)q+j&?!bn_w$nGBdoBigd(^O$=T@7A!h8XiY(2uZ-XGoCx7a^w0`Hg_m< zKc}w#zqAgyVWtI~i{iO^tK8KpcMfxxaiF!cmR2J-?3{peL_GJe-$`RlmHP+8+`~8w zH<+AK^Dl(^;6~)4X0gH}_CZI6b0J($QsLur7j}HeD(ssVYAEcRiy;V!Im?!SXm&9F zr%w3EIwmZO+B7qr@2-J9#Fa2)#mb2rK<8^&wVFsoFy_W`Ivm67Qx)J3ocq5?Fc=l6 zj5D|&6}85FH_>&BC*gdQ4`+?6byhN#0~MC{{fJc*d#`&#aV*1N^g<$9DN}DC`Dg;k zP%PUsyJE$ep&@S@W)SK++=$l+VOD&*XE&4^cG#Cf*PHMqVjZ*}V(vopg7XDlm2qF@ zoz)*O^c1c&aTYVQ6bv81^nV^BBf)6SY=-Uy6a7E-zC1pvVhMKw3D}~umrFE84&8#x93I%w#DtJ#Scye!+<$Vxuj$L9<xE7 z(4>OOoWQuX;3QTUVz8l@gUlLv6kdBs^dK{`0+1q*#q-R$<@WCGUqsvY=AN+yoo|6-5*9*s{hFkcy$*$r1vJlIZB==4eI0bf63m;6x$d zrQb&hIQ9!YmB`TRqntt0o=A6lSd<-iRhig<*W7%>xJV~%DN zb1oUtO^W(d6!SKvF;UD1VoO%Gm5!|5=X<9DHE}pHBt2NuAzUgRQ56EHsR-9H@1At0 zbU&Xpd+RwDZ)*IMQClwYUbZ#b{e^>c_b;Fm7Cvdm4S?%_RVk}KIN&;PK<)zj-m?(S zyqfVan0Xqb(w}%O$5g-ea5D5lYUnFyX?mz@9|Laf`4!h>*#D+AK9*zR)oDM6L!Gg* zASyc@+M#ET^n{K=3VG@A?~ySV88O6&I7bdKN8heuX`P?>;8ai7YQL^zRoU*Q) z%<$5i=Rk*z>CKA(*J+=-H_w!Gr#B7%1@IV%{dF!LLT{s0u7keU5z}#q6C8&XlyN<2 z2#2gX64C&X)Pa?KYrgE^NJUfBIi-KvF-RXrq}^=y-)%(HK?o>w^yarEm$gP`ZXnRx zB#(B|sGcgSU_KaM)941#F+>=?dc3^LfVQ(xE;JMgarmoHZo(%;6>N#xv&Sd0h8h08SXLE+_u_+Y;3LQzN<%^u5WU2OXg?RC zzfOunH1ur@q7NfZeM}FWST~{%Ih-+z4;s;3As{*(2~9xsnZu(LE#tGM=-_xn(_<0+ zscRgfQ&4#=Rx$iL*yD5|e8&fk=tV^IVH9tcNEBlV~cH9L!dB*li2rao{=X6LR z+nNuqzZpvhwwFN8m0Q%j+dhG+Q?$2PehwgR;tS$SbA$%H8{`c_P)}_^^#N5`S0Of} zTD!I~aK(dKkI^Wu`=cF7mvQ{k6m7;nEb0yId@allw37~w64646O%GVp7r3fDq(nD9 z_P#2yfbirc=u5OOd+a!tk@rA`qtfSCT{if_SirxkeTk@hcI!6a4&_@7&E*t!SX%@{ zSg){bM+WYRQS$d3NbiKW|#ZS#5SoAdtG|TMd z&SYG11){Sl9mw^rwOOr&)3+L46`BunGP=(D--2tNr&16pOHmV7HdICGKf%0f_M7)> z=DnGDx9&Hu2mESZ%)BinUXnB`zVaujRl5nJxR8W-r5A>s)>(iyo?W`1*sJ!QQ>eYv zxmq2g6lN2Z%5Q+m#YDwjU$i3@g#1n1bLGQjKE-3^LX_23s4EQPNsmKD zT#9iTYh}uc;Ua;!5pJ0nh|L^`?+8ROM_mv<_%9$PD2SXrwVf#tw+Tcm9^!)j8b@0o zib3jvID-&hgkuM-Ci4PfB7Ov7Cy=tl+an(0wGPB)heS+L7sN9NQ5<(#3@KYvATkhS ziT9hDxK_7zAf6}?#VB<_{9+Cu9;R><8K;a+f%t$xye}T&vVOYN=LV}wzWvvqL_AldF-OhnHMIib>c6V6N z?;Zoh6hPFB|?4?2wvNP=>NNXgkDM<8Yd(JFTilwjB9(Hk_ zV2ntK9$PqlE|wCGgGzkLp{<~cc91wV1!dcjJv0WDH?c_WWN@Lf7h)R8Vv8vi-cG57 zitxLG%JZ8A6)6Fe2Gb}+Debk;JA#U^vQv}VZeg#V?xxD%TBz966vru4+*B#KTd2a% zdS}0aj%}qZ(LtdiC1R<<9LdE0)VMyMhsls5oWnM10~5>#aHI5p`GdTpAUD*vp7N+MCYvNkID3Kf3Vs3_|1r-@}aj0~UL1izO+heFAsH|yIiz=a@P{oCcg04|1{IWi(&|gty%5ZgR z(o}isHaAtwx>3ofjmovPP*Kn|D!**150&!;6(6VxzmT)tMtJ4e7*r0g8qR9Ms32VArC)cHc%qmvy*=;@6*m&YF&Fl_zWq(EWRNLTT~$D<3PDC) zR~0C)P~=JmC9*vBE>JHt7_tduRY@G;|hC7ZU++&}|>SjYwfRd-Xsyn=%>efg?ZJa}L7xvamP-6k#g$jL@23-N zObJiJNh_T4(Fst}A!z8y>&0s>+%A;?pHWOHud>_sbFQSvxmpbW>s*_p{k)hD+BiKF zc|%V!K`z&(cDHQ&s41hky00$Rp2Ven|9?OR`0ZrQf?Z`@#CwFKD}&zD89)pR>TFuj zdpI4^Q4b$5M}wmt@*HbYjEC>S$s+$`UUu9~YMm|4!#C;UsE6;-^ObJszmprd#KWhC zNG%Vao3^VyilOZ-$J6iNnCgRoeU-Tf|B7TM!B;&RL-1pwnSGLZH#6I-HpKLTE7uTw zM~8{;>~YBz*C%oAuW8H^^!^v?j`ZwS@}E6)N_VdWc`0&2zhVil#Cro8;uy*I_12^a z!h`7xCN=*u-bn6%lvqzOP39K3>4!02cX==+1yXLsqN3PI$04L3!2Iv~j);E?jhK1f zS9yl4)Ol=`X9M%xN3FR#>qf?>RL1^J#-AA7G??@vGv3IIi8|wLDq|Z}tF!Of9PokU zpU(W}G5-b*EC9|``M-T%V{iFGyWEa zS0<41q?7UJk0oOZW?asULv_aWDr1q8ag)lp5q<^x0cJc~XM9Fwyxz(9#3urA5i^cs z#>1GgXy4(6xd>aGF#J8nD}$2rjPY;h8TsDN{)TQh@{_j6@5WVm#wY7$VCxveH>>xvH@v&f<59?sujMt#|-?wp)VjKp&LjqtC zt-V+Y51a| z_g;TWDnMXS9sQFx{WPwm5A1$|XW3~0ZGTh-Sj|P2B>i+I?x=owPdiU&CkKjJU9Z1k zCG^r@z3Z&FhCP03q+!!b8r!e}V}EI6?O9A8E9sm~ z9nIOE%Jip@Ug9lTaZcj5Mcz;dIRW zjbh6??mY@ZaBLmBA`G(vNI7Ldzwf{+-xGd`z)}`EVD0@?V0BQi^h~7{XzlXU8zT(! z6#=P=29q{@3y=>HWDfzU*a;x#Dv-U!27C?GW_CItwxA3=T%f#lfZ z0C|Z5`ELbM`~HAsBKl5aiF!Ew8|HHYQZsQbR7?zz;eFEZGzZH%c1U2G zmcY`CpY;7Vfb}$CWeF_B_<;42g7x_t-QqenNf_olfu#pa(j3D22Vw1lAaMo@VBMf# z&1w+VQvyp{!%3GBmO)ta1(q6MfOV{bmDwPyxdKZM%A`cXS~(jren+~vux}6vI&g4% z%JA+?(1C-oTi0W!GC>CpmK+8Xbl_mg@yARgxC00OfCS^P{hY7%>G;8z*YZ1cgSO31 zR;!J_zoS(-@>e+Jg(En3PLN!0`eJr&8z&Z`5C&fD_{6o~({fbs%N+PNBzHJv0N^`n z_@evwh3l!SY3*^V@w}4JQAIZyKRkWSCwunK?dt2jS&hKA7ChfUhPQXupTtkeBes`M z_Pjp}k36r#3K8CrKMRi|Q^Dhto%mYl$= zR@aN_pP9eLHUPHi^H*(8S?hxeKYo6Ep{hPzs@P0@Fv z{5=1S7=7y6Ll44u3FIy)xxC!IottMHgLzZ=kDK>CI&53G?g_E!`hhwJs8`99POKMU zzIn3+)O1OzM;mF>c$AY-8h*@rlPT~e>0rTEwuZ+4B!MqU2MfNki!}VVR+2uF^rzsH z-|Jd19VPI^tou{&smyEm%Iwr@!(M?eNq-7HwEzu2W*L0$8>EjU9W3}UEB;vmUy}X= zeC0{BZ%;f(`muJ7oq6!!alOIba>zl#PtT7#L-lGgO|s_-E7$>^{DCl3;}oyEQ3X=t z)SX+Hst$_S;~GGsZo9V0@~yCf3|J?A+wHpW`;@5~zjyIm4{Ozz+|>EGuz~|n;g>2; zRIK@A4^;TYQMH%CPgL)&|2OcHWnAfB*6G?y{Ni_Y(eELqY6%&{bA5z5X#Gn8tmsEU zs_^5JZ7BTWu-^Br;OAkEAMpH_(trUrt7-+Vm(<@EE_N53=b#P4Vqeo22le$erp`8(nPc>dM;&4Q-Nhq~bB z{KfFUUv}{DXH@Q^(1UvA&Azd4Us$CypujfCKUdoy)#V`Kj{%x03`qO>wk0u3>8Jm3 ze8fL`?{qBRxNXCym&PoRlR0Eb{BB8)H=1ryxzkCh2Azsc<{!s@9P!ue-CXaWZInK* znz5*UC{5BIz!$|7bsaNW)+SNn%^P(yuUx5@lbhkx{Ytgil*@Mr$T@Vgvb_%bN9|CrDAn#F%Dea0SK_!K*| z&mtnI^!vY}-khFs+=QqM8~oNa!5r0i_OdRLr6Xn%e% zLpdOMc=-8$fjq2uF-9Ja-xDVfcP*-)u@6`tJ_?|X@`N>Ry{y)JmbUR=^xu}x z>V&3Q>-(!E-$`Ph0^8`%FyNPW$Qj z`WoK&^^-dE#n+y%pY5BhkLqpTeJA||`%R8$0MW+EmpVA)wdW3E`vXC;fQvD%1@wAs z<;K}-ag5fcUU;?Rr*ogVj-PIHuHZ#O45L1X$eKN-Mpp7)fp`$vfp&;8bvP2B*QH`Rnf?0oA9eJl4mhy8CLHd6r+y~ z=|}70hX2?u%q%$MSZ^S3wVnUT_uRuMk@lAIa0C7dff7+etQBI0ExL=l@wL|~!(UFY z>I}ONhi*~ANH)_|uHYd2f=t0~Ozv!|6H6w;_u(xW4dDLaLY2u(Wjj^70FaOXa0jY4 z(p1Sb1*dJWhKX&>wfKSb5#KpdN3Kkpx**yL&$9I3B}jNmGWxt#ZNZk zNcb<62FSZ_DdGt5Z@Mo5aZ&d*Gj7kuS45jN5uv(_d(pAgb2NI`F#EEYi{jO0Pkcs= zOijll|9nf;ucy%0eHDTVG&hR2vK+f{8y~Renb|C91Kvmzypd48px5`-R-UU!Q*Vbe zz8Jot4phO8z}8EtjkWSIs0v!9^bRn>2Y&MfQ;u&Y8`y*^kPWH!p<{jy`+>-V=OPDu zcfc9oi-`e7wt8dCSoAvEQ)QkDE>EzxJ5Pvq^iy2GWHgji!;cR?3ll84+=PLPgHvgR2FuvV7}tos$?nJr zo^*@n1OzkqLGPF7oso=SevDsKR6!7k+W9fxs-=^q3OurV@rMD=9?P~ifCM0l_WZe8d<{}^A%J#%x-X0qNR%)9 zD+KD2vDXU2T$75d*d4~Y7&UhtHtRF&xQUy9NHUYKAR%?!4`~Q+OJ)sNIa0+6T34C< z@R(o^eX@mTx5-;_5)AVe5eurMBS5?#g)n>&jgy$-4iC@=7=WleK-L^75r%>2BJuEt z7IAb^dLsp#%#PAEW~cy7!IbeU)3ARGEv3Xb6On>|o(QXe)TOf{a%^}lb0n)A!fZt= zeupeQ*C@hn7!}9S7xb3>6Y_}hqAx>bY%vkGN(JwT7!*PWy(<_71d@qFX?&X~IO=H= z8xEP6u^eqWdxL6I>9I(|U1~yksVlxslaT`_M5sgPQ2D_irLfQX%+6Pqy^Ja)qH}uB zr@S!yYgk!8q(=6bclWYD!oG}hJ}}U3Ka|W4zlFe*qMYC+OkjXLW*B#gf=kljk5P3E zr@Z~G*jOBt!b=i`6FV){xTdfPRU@LVqrZk%qlt&#dz!~LqD6@>VQsjELY_PmDCIy4 z-NA4_LGMeIX`W?x_k;>m!U;ohCP5NLs)T3W?4%Pel>~L3{v!DYLQvVs-~^7X+nuz%hvH0i=v~9pMWNhAA9~IB?)Opir*h5I69y`8GQ6g5Gln zfbKDKH7X+aa)|LSI@ia|)ltH5Q07=$a;+Wqb;H$EecVZrk;zCx^Sa{bBz4VC&<655 z&e3spg#63typJJ1Z)eDFur;U7oCI70vXc_4igt8@WUUryLX1MEsFqGuEiGhA8Ic>^ zn~1Yysy8oD342B&0XMyPLK#S~s~*Ean3EXI8TXe+@&3t*zTb7@+}FKwhp}K_H^ck} zufE_w1T?}ON_(5<4{#o`d_`~IC|iHTJu0P$0_|jI1w~@xjZ}i}MKOVief#d?d92KS zjK{r7nP^{w&}+Ux|5RV#%CzpQ?-8?is5>a;fAR^Zw+-?JP-*>sd&4F zN2_MbPsJ?x3C_V!m3aasJ;sH!>J9`rscSM=o;IsrpI3js`0q^c_ z!0o;ILtu3T2poZb_tX<;Q%yv*czaR34O4ITsJB7tZL)gfd;!{eFT*Qo+70jMltTRQ z4_bM%hoIGyHKEm?9^M-kjX$eB>kl#;Cf8x4PnxQ=vpGn;5t5M>WCccAsnnWQHjHnb z%hH*pb7?pE5pLFopf7xg&uZ_JV@Ig6(1(MQh|!sfx>$+NDlR5gX{wU8=~LqkKfEij zX{wU8LqXX6p{24r&%E5J=EZuyAXI@Dps0Td`Jh7pV;)aKpXFGUzV17GOS?`l z&FT8{;32*}n>lQ{uk%@}vhm#g4c`ZEfE9YO8kbpFRFRC*V3m=avjSRAl-MoV*6QpI z>wGJ=_QDC`H}Z^Ol{<}zmFP_Tlhu8FR`-p&`Wh2jCxSBTaISc5UZ(NM*1RlS1!ArM z?%74ZB^dr2anlGttU&fGvogadUAZgEc&#!wVO4eq96`>1566)A@ydX;DAUha(i*ou ztTwFk5XK^-aC1VIv1D~l=OB^H4f=LucUaxG_()IR;>!|~ePM|Mn*-f=&zIRNYFcFP z*>I7S@7dvu$razV$g%Q!?nNI9bty0z5-->K10$G&B6J7m8_N`nskgUy3%K5@pf-&g z-+%$RrkuTqze41jN9tJ>3ltIO;0HpPLysMgnS$T#+h6)VTqMeU3s6G%S-1h^sab=_ z!Vp^BM;s+4n!64E)yQiU-;02O7#&}iLMwwcx6?lSe|l_;#TUdP$hLm*;l?doJb{AQ zn7yx@#}KMY4p|lL2@YePKgyQS^vJQca;_io48oCO%Ha228w~R&brX(bLYVJCdkT4g z3eFS1_Ipmk`@Rmi@8LJ!imzH^TW@A}{yZZ%G@RLCTZZ*TcCY+SJ0K`MgcXs1hPekb zeF$euJ-G?%vWr$EXJhh3&xO_?y~=D!?yoYvdJuRhajZ{rtheo{HPmr_4dqi)h~6H7 zN0ORJL-TCM272h}aEiFn-yq*8$ zST!8tE4Jd+vQlC#(@G*9w7mDh!p0d^CO|^)rxz~JxSe)Wk%WYX09l-fYQz-ajE7w} zhrpphQ(*aLXbVIGFikM-uf!t}!f+mj^8U(#);g}PLOD>@9u3HNSzW2q8#%j&)0ZSb zS)7e@xesJ45`jk{8>*ZG@Z!VD^1mvCUv2GG_L@tQhwwtF95M- z0IESE=NU)Q|Wbe8WY7Km$bC4O(PZ$Vj2=g0as! z5DfR2%;LG!w9<;!2n=2^2G-|-t0%F85rYDnW}1#B62#uLH|!@ z7OY#zPsKz@oV$Q;U^WGF2NMHHp9dK*0g{57it%-{{B)}_&jZyU-g=R$Rc24VdRv7zwuYu%CNy}wTBe`fWCe@m z8#H}+EuF(3c$yR`MOp$6^`=DV;xxVmz22+EN#0Gp-Pu!&a#5-xrewPM_T0zv&8OZz zIxpV24mRR+#`f?J0z`nuIM-pQbpWv*_o5DO>_+DaZ@oW|WgF>}@c`L1Ge<976ixR|p6WS%6pY zkq1BI3~FuUlvGJB>&BmCvr^vFvNwbm-oVv^@B=_uK626=RvX9~g7gJ^RN9o9si-q! zrW!g^%~UBLVy430LisE7^-{wFD|=*Y|8T}$XkQ(i<{KCfmep%vHR{2FN~6zOf>v;c!TudfaiSWKU=N=S>;<%<5i1r z?;HM9q(LYbk|3Qcvx_Qgz+t~xio;%7cf2R`$6i87dF2)?_ym&X;m1C#2LrVAc@EE* zZs+qN9LxJC-a@w_m^Cs#t}@?;p9KlUvUXG~OGozFbERmpDk^?f%lmH@eE>19nVFM_ zovq4o7VYlHb_cyrKMemXP(tuy1lC5vqZc6o z?jNLYFpo^q`1zTi2xwLihL%Qv^g+X-MC>weI7ZNWT%Tl1imih$*LR|tec{EHcf zHj@48x~*(Ii{SP}@bEezy`IojxY#H=A#B{f4jt?Zw)W)o z+LvSW-{-de)@NTCD&t&-yc~W2 zCbJvDB*~kMO-<46tBZp)^ooPD^J2SXFrwi**cJ3p9Q?*Pu)=C=>Uszq0wFq~%ztaD630iJl0bcvKO9jHp>@I<@ z=EJpvcFqD26$I`1fe2~T8wzH$*kD(&Bvoume6a!+Yk^|m%e?@Gp>5+Qy|^L^_*a>k z_&320zl@ERMSV^wQqo!cHr`|K7WI;7w~6DMi3k%y10xZ3Xga-9YPSb>jiB8pb04u| zNHll@MQh}=54jlFUO^=&2FfffZ!`|d6y&s5Tm&e|go1U|Gq~`iNZSg}SS7h+bCk3_ z&>8mN0mxs2MmuZmdK1#V6D6c6hciSmFFytmM0lwsevFQu9O{9xbo}U@0>l%{X+Lr? zcBvs=*zQ5dqbmyrlQx^V#-Gy0dOla5M*WUwkMwGvwcN zX1WfU_~9H$I$Qod3;zNIF16a7Ux*Co(5dVi-L4KX?b;+wP(qnIa{OI!wIJk^+BAc8 z9Da{D6rWDUB$n|iVTR`7rVkZhY!)+a zP6s~@qMLKim!U7^7LYpt+X)A_=vys;c5p2d>Id#;Vw^`P$<_V!MIh(&K?ESp) z*yMy7_~(NcKq~V-C3(y=zPX61J9cje^inWs%uFb2P+|~ob(SRT#k%G)MBMh+Pf0>b zf8@vsdTY4esdkgtkAtSDX9poG_aDaWHfl(LAQSCRZ)XNNRpoUpUmdo_)m4@D)ko7x zRcx#5SNl84MVK1|>iEB)9Mxq+TwV|3}&@+iMUk8hJvWeNM(y#e%^(Bo=ST z(LQ+ZrCpCA@Yw_x^uAllmWfXRffBQ;(-Ub^<2MyQ$RINUCb(oI(eOi3%HWM69%&BP zS$%)z=9_@3hfBTdG4k!RXMp2YQ3mMd{|yOx7m!BtETS3o-hKgSP5U%7QpOJE>*`N~hu{bcxDy;@`0v3|$%P-ztyzr2=B{hfY^{7N3SZ90;M~Rl@C| z<8@7~Rl;h-KUGkE11`(iI&A+6EysO1R3-f_smlkF4!=#0Gm3?9%E~t}&bIMRoq>gD z2L|?qw{_9z=_Ow|JjwN#Nx14cl)!5|bnb=R zMk!_qC|s!R8~fs)M28eogj<0VPThe$;gA43aO>UA(^`l)xsG?Au6r6GYNvzZ+A^>! znQ+|K5tYV%|Mixh&|PQ_R%qD*cq%zJC>e)E3XlDJZy+@mIU?$eNPhd58?lQfAWRgq zjV`nUHAA+pMMu*5DF^rQuQ1noGxUW7KNh{)&TQ|N^!H=EB!1GCZJ-zjl>2O7^sYk? znDDvr#l-y|94vgdci#rant%kb5ZTDrigAfc-r=74eDA&TyKw~;1}poh@We|QwmIVE z3H>8X(p(4%z{*--KTU8C5$B~a4EV?WwV|h(QnU{{*(_A5^FtioGzTLRDIUB0cC;-} zN)QJ!tPseXm^`6(&^}?&P-|)FUbJ+l z3_P{z*V#yjm1eVs^+v`W5~x#gmI@|a_z*V%^Tx_S$+9XQOzMVclo6qsNTEq0I6~8r zmK3CrmVf(Lq$T|__ECM<47HItARC!OzoP3LlO>q61mf84@F>{35;kR(c?kPZU6I4x zyLP)?VB@*+>BP8CzxBkY5;0|CIr%YqHpcAQ3-`t|^-Eg(9rE8MU|%jxly8|JZj>88)LSeXg# z_br_~YHVKD$sPU8Eq@aYVU2P>1UxZ?i~IMJ*51&PfX7 zv;3}4F>pp#ivzOKVt1MXVN(rU>ZWj&*@DvCX~>Qjw_;9cu9KuaUwl`0dkS>rT^rw? zzPiY-OY3e=NB#XXepf3+t~H_rdq@FP`JxI=yvnQg(@i8m#H;qWl#@v=^enE+aA<1y z?}7Io+34BJw%!8+z9J>VDHBj62jXoaGL(2*0Re}1&e;Io(epZW@(HNbR~}&@oQhzA zl~A1_oK#M}Lw+JBJQ#Xw4KN6p;$MrHRFx_hZFdo)UYT^%F@a!*kq7`3z zvlD*q9`3#|r`NY^I`++ERbg}4TUp&Xap0-S@V_A-)Rs0goPX*vfvLy!%%QTMN9_ra zYN}c!o{l|b-KZHs#*<`f)z}yGo<5%QlR6?0^p>Yac3+DEhA-mAa$w}ZD2!98tv7ysx>gZkd$^j0UAiA5( z1ca&g_yk*DLe2x3vaQTjvXIwem1~|=$6b73Y%W>_vI^CE3qu&@6ll$a%Yi6xK>+|` zFT&F=^gyqZEY)!QQ5A&OZ|n@}xXMPTd~RRZ(H8^h&?40?o(!%+Va6g{P?Ywx!$qQb zTCZ@0oL3hl<(+sM{m-H-;7$wboT;dXuIFUlaRHjW3bO#kMbCWkOjzYBG4Kdl$v^r= zFygYtYx%cWa*GJR=Pj?tzcE%XHT+{%W8eh6YmSLJG<)J1O`D;5XBHqX6NhFYwNe9p zQDxH0iyv|GI*kd+UNie&h8PTjl3^wY8!7LHy5f*Dw^Qaoxz}C`y|etx6UE4tE`iVT zn7B&xL8Uh)LMjCoi@O6ifnY?Uix%J~R01|A@xDAR>Pf2kKo8s;I3AQoEB9u4rCc5@ z?>~`3k5)F+=l@r9s{_@h8ql8_v1zKxeb}kUg3cx5U|e!A>if<_5UYFfM3Ti^uSSOPS&@73V$^4k z{o!NK(C>q-NvdsomoLNW;njxFIBebqke1AFh)ka5;$@Jsouy`kN2!(K#P zI9R|Pi!hvrJP2ki>SJFm%M?{B2{&m(5$u8!psFuSC=T+#V{wq@9hpB(>_c zh2)WiZInKVrEAW`c=-}+8OO?M3b8lS=vcC=o|SIi4!!&VUP_ZRb+p=JWj+F`Q%gG! zh{P|8zXTh}9?u%bQ62`pzqX5x=sY}QM862%v16Lah<@Q5Ox)O^=$WK@sfhZAO z5Wk@=P!qea-sY9ORkBtg_MdCH0zRtuI^#Z!VRe#B8D!KW?0L*}o_2k>(q}QfW26>3 zy>4TY`+|*`NWcXfjfxLpbiTDyDrN%SD-dxBNsy$q;79wrf9hlRMjG<@isCNV*nfO) zH+&p&=L{tZuA1DFx{p?KLg+;*eA*c(QxxO|aH^-;#>Z1|*ROf}_~l;Aef2}1)lmE- zH@rILxZyXb_8g7&G*ky0(B%G6C-@cp=nKW1`cs~&@0k~l$LJHcTZ7f^H@<_reah*@ z*o6dazjbdrL_y(WLsb}9iEbeNlpB5>^y{G8^XdG9-=2~(o??$N9~O-w`7m2kl@F(k zK&|_4VPpBDq>L^!ml@-=XOC`y3W!ESBy1%8O3LVmLwjnOg&RjIuDI`cwue|WR9$1+ zgO*Ukqe14i-@8FA$i}bKHdIk#;*+`gL+=h5daoC|(&`rmjmKZ@Zc+=mI3k&UiqHC3 zl+7|r;L8STH%?67Kfg=RA#@bBu4wVcZ7&$UXO2)E zwe{Kki;E`93l3Z!XL2<2%b)Rr8<^5?C+)vIdcM#*c7h1<-w?#c_Kyo+>RmPu`5jbz zwb`40gtN^{ucv+=YzN^vqL?GgEf+|;oWx2!K}Zqf~Jrs|E7{M zRssH_g6nZNp9%I4GuwG~uS_V2C(B1jkMs$4d@=6|r0u^?8bizjnEyl#LJJC=b-bdF z8sG!azB+eRes~d75xgmz3)K0<(~oi z(L}b(ioJ~)ZjE4~ruA=0nHRJztl-{94^&*;op(LG6|tE2Cl(JxU(-7l%Wn3H84$mt zvB9x^0QD7Cuo0eu;~D}?hh1b6Z#B#b*;O|uH2 z`??l1;$_LJ%(Y*$A&i@vzv26JT=Kc3thd6Kh!j>3DNp`6U<=t@(qq$B*o2FZM{04| zark#XI5sY0Q}pi=skX3!kcn9A7S>Z1adu?HfQAs;e~!lM>xC7p&6D4uzD1d0e6?T1 z=&mzELuk?*YO;QVo)RBop9iCBFWujV;#SAn%j&C?qBY~c$K%)%#je|9fiqz|4Avke z4;;U;2M*GF5v<@*2`ssCJh@jvwhhs8T$wSC%z-iOC_CJH{EqXT4G*W>itj~#T%Uhz z(I3ML4#k0Gd+P?TM^e5K-vagTvq@#}H<$2Oq!gSa&iq6(VcEPjKAb|RoP zP_zm5LS#Kp+%X$~v_0hN7M>E#zC1P65UH9lp2R*WRN6?vei~lO*c^X_BIC)AHrVi{ z^G9KY91P1(jp6n1){F!4@9S{83Uy zp$~n9uIs`IITc)Rz9aa)n%F$`3i^|{ z=ei+Du;2cV_$ zkRDF)Kh&^M)pYwt7LPQ&_-wy&S;Nh0BE4iuQT%P!0&qipd?5N$tD^R@zXVjh6S(U~=@O= zJR53{%F2xAngBxb*rqQEBo6H7R+) zATg{PS+a5duo6L`u!2B61s#iJxuHRf>QIXZ<*1>Sct3|47c3fr&?J4Ku!3t*o`w}x zeZ=zU6)sHas;Q(0r&(xUP>M z9DO$83)WkU<{rUI%=YIvYrKB}3@vl$&?(OK7j=838Y_>x@5We?DL^AUa)OuMCnhz} zpS9w@+sN<4e@DEu>17O)z=u-N2k{W>rc-3g9JHy5WF{b*qK9P>5D^2F=O29BdU%X4 zaG?&}o{F7t*YGg>ySWS=_8~$O^goX~7}gv9PkpS`+k@}eg(yxtoXh_d+q0?8*juoJ zh{1{(U1=u2x>cntEh{a`Hix28tm4q0&1MlgtB$TtZ?(6Y|sQIk>y&i6hVN|!O{!)U+EExUR ze;V2=M+q`2>gh6q>N8|m~m&jGYBDNQE%)| z8POUsbJro()@I|C#2G(L&IbjS3~E-ib5dTbw+;XH zP6xe0cr|=MSFjUtG5}R^>BcaPlab6$+$fZn1s!?+2=5t7R43vdfE>%Ox=;5rd-2J^ z1X;me%<>~1-X}u{3&E_HpTiF+OEYv6U(UvROcT!oZcYFKoF_?+>m|o2HMVojn`1$~wcox9ymr;84m7^EaXe zMtw}siZ<~fyzi%p=>yo3D5G9{IborRb2umiDZlj4O+1?!V|ww0er)0j5jWf(jV6wU zY~UXr>lQc65GQWN0Ssmd`4T5?usdCgn?E|D9GkdS(26$kZM-{kMppOLpcO@7jx|%H zj$F)fLoUi<`!sq%CXLU9QP&&h3pfY9s2L;QnOQhdS-2&k9EX;$Dc)GJ-UlI!&{+_E zM%#XfAluSsU6Gh$^}`JfS0HB00Bk0cc;fhqI2O}~j`p-!n#dJ&66r9#zZgaxT^eg~Y{YKEw;=p~`S7mSEf)aTyb+&%4| z%YF~^3F3`%(qAp_DFu9wVTZdjqUU@2{D>0n9=V;M!QL{2Ja64iy6HG zpkvJFFS4XWWCr+<1`cT8|4}TR7&AK6@XsSGpt`TT@`L&NhTn6hI=sIXUl0fVb1)Xq2L5Uv`j{M*Ok*W9 zy5ALW{gQEf9-t5_9yec+@>ZF2031DnP7vFnNpPH>l0U@G;6Or3PyFx?U6w9cpK$gMefd8N6j~KcUCLf1TIg3+a)4*XQ2~4Xk|8bLhLwC z-Ji9yCCWHAX9fAy7e?4@@tHt79?^O;oICmq z|0&Syvk~4tib$3DKC;5sA)X6+BdQkab)yCe<%yN5xGsP?gk%V$%sN^48lTA`xWX<2 z$wBWeOtwUs7xpfd?E=dQQM-t~^de&nZ&Odn!8_;rU#iS!*l`O^#B*tAiQ1%PQ*;5EIgqLm1_)p#q9P!og0t2AD^Vr!Q*(hLTw4%M2zAeu zcnCxZ7r?tC7PKlbOxQq9c8h!Ma`u0qlw(;erS0T=PK$G(&Q_WK0yfRCaF5T{O8>_E z4p_w}UlmsL#lHw3k4U9^PtR}GeKl@&Fh618K#KoNEjy=Zg;_g-G;zj2JUHHtd9ai~ z2A2`Z2G=HzHX`|v#OVSMAdWU5g+}IjeGfo9b$WJYi-6soYFI?rY6jlpsFRN7f`Gzc zG&_9hd@uDOS*Y_RIV(^x2xuTggA6IssxMUHD)T$!g41yyE@QBNIhSp$mf>hY)5tY{ z$T04I6G}8;8~!75@Ne-_c*P(GKLj(ujzzI%59`yN_u)%+(eDWR@*`jyOAHK7B3_)B z@k#X$l zVX4s5)#g+rV%z~Cbteq2<#STXk<7nBAUlsB0&_`okY3Roc(o^9#b3ec1`6H_j#D#9 zb;xPD6?aZwI|eqv6I8iw3rP&pqvcO@CdC?PKL<) z`*1QK@+(l`rCPhk zHB_}-+#L~2e?Yw1>~PfG@fE}Iy4)$BcD6AXfb{ba||4hn2{DWGyK*MfS~e%GdKxT0qR`U9DH2HQkcQa zWz*>3SW2nE6DEws{g7a!89m32nVfIWjYK3A-ZF z^v~>HZr-jZTTmzu1v3MS5sVW1Ye_V9qs}g4+Txjb%L#a^PSarib5;zP7u;Y@1ejf! z#x#?FP`E-DzQ-y2EL3P04mY_AZ-FYz!a)|s_|avDI%P{~fkfJFpW`n3lqx%+lx1C+ zWk12C}~Z`1m9%Cx4W@#6}4?E*JvHxOz16+MB^ z$JhFdC89|d4;WP3Z*a&51#0QYQ6t8jmAGuoxZz{Z8q}Olz)RX8rU?cp7tOk_UN&}2 z{;0E(Gs;Iz8a_7jtn}s?t#E%$qVO7hi@1u`woCp9hko7W8Y^nS%d;|Opu7&LQP)6O zgLDq0-!mw6ehnRg2%^5FBZub?A2D|LWO)C4%Z5*$+;#Y*8}KryrFbfzK^foDyn^u~ z^69(`B>TF*on1a*eAnT5`J*P~oR!`(8+iJEp~^x4_%d? zuOe>f2D=zmE~e|RPK9og27IBL7*6JI3A|cq1PDuqxeN6Uf%APLeDOn4aT%k>xa;~k z)U>7mF-9C>JD@g!4xAF8Q`+m!L0AMWePN=i2F^T+Xa{F=WSXn<50!fz{ll>IoLyA4 zBRlYSxtvXIUn?RKkX6Mq_@FNU9hg|K8OCiQ$~8Cc`tmVCi^}BTf_KXv#5XcGA>`h) zWS@0y`_Q=vN*m+aZgb5~;ZQ2W*yfF$Fx+vk=X03+ibgNZFPJ#iNgc&h2L8*ne)I)X zYSwfVoyJ}4Y|uC(~D z(gLbsR-cxdSv(~z^gjkO)z|x~0J$hc*usC7Og{GrY$jk1X%0q)q)VWRQQZ>L7!-oU z&|-j53-NG_s)cx2Z}(SV!c=r^KA@9}t|4W@n^oXm!08A$p@{%edzIpdi95of%ZcXF z@dabY4!?fvC|@rGw*3KPQKZc%PNR~v^Drijz|8C9G9R%7eiy<|R&A9&R1+=CZT4f0 z(+_@(m)L$NfGBi$J)&tGN0XQR_*r`?KhG)uL@hozr>^p!U#81HtjbSx%CD})2fw^g zNBxgD<$2>B@bBrAe;VzK#eZ>K<*#wdAEU~9obs&_^a~^5LjE zTzvQgT;5v2LNt=cQ<)|DMxtMT0j48(?<#DiIjhPq!3ulp@^ozxa zhy2?B$sjiWe0=2ONZ${}B5nM_-=LZ%K~*mN3Rl4$!8;nT?-c{-bi?$jH@Xfn$mU%j z&KS_i6WR@3JEyldb22v9`>W`mf?I2M;dA(gtvIhSAq;X>(!z%jqey=#VQDgce3n0n zwpBLcKqqqof;EqKx^LR>mHOfYiq3%8UR<3KceI+7Xc_p2^RsK!IViUup@34VKeOLH z1ydIReL&%a+dxqPCWTbWhoXHg4by)H!a$9=Vf=)%k~580(pzNA*f9x0g6fDrbr`i8!0NrH%4{D<_ z6sVL$Ou6vPC|S6~R0kqYxe!^>35b*;!9D!(iV>rh-8b90w`2H!SraQEXca`W{OdDh zc@0@&bY4t;xNvxo{A);=yMg1Ho?Hnkh8U^L47$_bG%Fzy#n;He>LWY>PN=H*>2fWKp z5W2wSN!e!jQv}!w!#`!ez#u+03oNz0AV!gL&2YZyt{H9;phjj7)`*GxhW1*aEbai5 zA`>g_m;W)Gr!{Vb0*7HVgaF@ktydy}t|EVisvhQn_A(7ZKaaAnR|47Kh zeXx0OPx9Blp8w(!K$$Nr^K3|pJWMp_<5#%~)fQf)&HY-^NDc&JWTjRGga)koigdnZ zT8lIB3yjXCxUu@R!J`7(51U?07SFT#9i!G3tbXl~#_~u@MZ^(2S^bVf8i63~WNZtS zw2sh)K{wPhJ`K!4wkYn`C3FRu%V7sKGhFi$b&=@I@B$p|nw{dO2DqWWVv%jo`>7qq3T2s&sI#yU4{wMH} z>d9t+359yb%12PhB_Frl5BbVo-ZCxOBY?!&DvL-1xv13|&|dAHvIf9QuFAr}7m#w+ zfFn@>hQ2kR6F%06Xc%xD#`Gyfz#5Qd_3M&pUE7UL_Omg@Gx0FZ2Up<`80FW9$ucrB z?8iEM+HYLw@(oH8Np;kZnp~`dPtC^=I1it&Vp|kWGW@Hc#Nf%m)c^+K$h?Sg-= z`}$C_Amg5&+Qf_$``DM5KRVmVBH1rvBWayP54wQDI{}Zy$e48!N)mxl{w(sR#!0WcP2*;EY$l8DtK__E&;|1TFu9dUal36Vpf>yMx zfD^e74!ntcb8h}I=Kz1%`XU^q*wAi&A>)TuFbPe3j3laVc?|JzuC(sQr5FJyj+<+F zwHZ;p61`YEFKmvrN4ungNje(FI17W@k zf?@U|aaB)c6n=}<$_tnfsh#5J*#Z~RTpP}^w&$8(8|DOLjkqzq7do{U9Iq^y2oT%1 z&}~o&=S6Ck{(+rr?uKcOMznCia1(H>&n2NQFu&5&RN5X*0CSxJ^Hv*8P24sb2WHuV zI0{^9I$Qgy;$!I%#=ZOlu93(jDIX>Xzqn%yUM8L%XE+W7Jb4g>Os-? zwT9|+bTn2M(z{`B8@|AmiP_fL><$}t^))86NWcX6$*L^Mm2cq|=H0uia}!o%cUadC z+X`A`A*{Q#i~iyj+j`{&2k*%4u)c5cajp6mU(+@@d(WpCg*6G-f3Viq`O4&rgGXlL z0@-zTPVnq?T!4U&Z`}@`mAP)OFWkR#_e1r?7U+o7P1$eChPNED^()m5 z!8c;lSxiQrcOi1@FP?~jmru#Zb-o#!Jvhx;PBjlc4fY>YV?}0hXXgaU6m3KSfecd( zn$PBi2J>1B^4z?>t`3&T{dNRej7;u_o)1*i!nd;*A!$V-NsUqbDCBt^j{bW_y8x{2 z9RYw{SLeggKNLe89abbz;Nv)7?}{zl)>Rm01xG8e4zeutDz(Sdyd5y)vO?UAS;IRA*?GlCjFOH5blo&C~nd7mCFuDw;9oJ!Qa^lv!PY;FU$0Z2f>J}P87REv>gf4YKsBj?s zNC+F3b^@=42H*}N%y*N!ju}5We|XMWp6sRaG=2o6rLTEzE4bwPf}17J}^S}a|V6#KFpx) zPzdMeuueR3)Y$x}AAY#Z+#gE6xXm1T;&X!D^)GgE4Ig{yWzNzMB+Y{uT8`J0vQm;SL8)av)H_Z`6FmkavkQLHReON%qXP$r?OD?_hH^> ziDkl!LTvTAe+4f9`U6?g3uO-&v^xK8mRQ`JUv~0KiQ4xUQ^nqkT@I=90Zz|sK#rDv zo)t{S4@B90CedC6){Hnr2=xpv^4+IBDM3HiAXR|0~oSh;;N z3)_;QOnS+20yaJ%2ZgKMf;o~TK{>r7$Av1#TISf&5;@LfLQyY(pMWR(J*JJ4wBAVj z51*`0?N^w5m%O-zJ~j_wR_b%(PiK)HVd%{epF{B$l|%NDjZp;>s5ke}dkq}9hb(*o7%si`V8OlE*8fqeW-Yw^BlE`i*&Msn5$oWoC}*_4uqy}NZEiOkkm~e2{4=4F73?Ee z)i`DoOqpNKoBcxEj_~o3YOCGG5o~$B-j@Rn0J{(IJ=fZ7f7b)7lnnrNZrK_0Ili8T zuL~1G&9HAp?K?Z|h>qBt!5N(=72vuUuj|=`hDGa9SyXMTs`ViNwy6@hI=!b>%ARcf z3zRK!eCU-A*;#)9x{H@L?~!Z5o%T`%>V+?o<)I$Pl5I@e6Ize`?r~sq1?>Dn;RNxH z@$871q`~fbRn$K{fC%;w0gEh#$}(+7r~+W^&zgg|yOpzo6wh1iZ|-CCSu5=+N3`%D ztc0}zrkQyx*q=jHZGLjpWFhk5oqr04zFrOpfs`xA(}AS^__42^k9*dN`dox(45nv> zv5(*IS>E%I5ZbeZH75P90(YpBVeBrUE!lh)!bG#`7K0Q>3J zKuL-ud&_eUCO!5^?mPwiRJ?@-z)z3dw?uNk9LXJ0xreLVpELI_axNmJ^>fGTA%UT1 zU)xrVJC)HHck$!l^G9Gmy;mW%r9Fg}z-#8Q`=K^8<2}{I-=Qin#0tDQntW#&K}o;O zMhUw9>?2tM4#lEA|5b%*q)?yxU4>exLQh4Oxkql6 z+!sW0zk}RrfN8udklSZ*fUPC!$Ep$8CQ{(x2>4G_Ll-IVZ!>pKoGAb@-(2I6Wo#t( zLX~^I%KapBk5IYW;8IyN+W#KO9Zbe1?%AD90)h$u zC;oUIGCe)j)z#J2Rn^tUMxeVW++!5^rIQ$Gd05^v5BYJ*_%CAJu>v+<}f7r<4Gvy)Ivu_+h1FkL-S zOtI-SWVmelNlEnlv)#^EHPdAi-BOh6t*XnT1rDikGjWc~)aN769Tl5SR?uz9rgmH+ z3MCGTKu?T7Z&$d}6!Zq-?!m2pp~Tb(^q>gzlS-VARnXHY&Zl9b0qFZ5b%j4Q0zF%? z>0b)^S+Z#aPYs0<7vTqIm3G+ll-tS&6eWi%=ps^*{*^#mgqH4I6oGzDL3dElj}UqU zcHsi|c@gMofL5G;Qc;ouXvO*aNKDgNQsDCvm-Ndb=+9E<6BYU_qR&$3XAN_qPl-T( zs-P1TbS0r@!6gMT>tAtV%k6Csu=C z1K+`$(?n4+>2;ThFGZj=-P;wk(0z%bCIU)kxMM3|hpbsJRDusK(3*bpBA1vl?PoRSePJ2m7tPM~&6f^Lq z2L+<`!MckVDe$>WN;aH=!+Wc{}F>|@dV^zkbEIXXcw#35?bb*&ea%P?s4)^ z;sxVD0LG@z9v3NokfPzUNb#1)aEp(F3X2wR{|btWdvj8x_;*UcK8_Usm;!bdTpRo3 z>ZVA&jMTAA9rFrOhcnd-;%BEY^%YaCnVRz|J@xV&c|B(h)Kb9KePs5w@X_e4(nSoos42kdpscqrPV_NUBv z27P3|%hYAB3lDRx3VS}@al3&t9M<1{i64i-QPK=9!8;k;6P4Lh`LQPmwWlzZ`UdM$ z3Vb{>+Rm3&-#XCkg^2Z;M?>=*;~CJ5Frz*k|;!rwT1-VuUtjnXc<$3DRu zFc1#-ROnhlj?VMTYa@C^5RFlYv_4*;2%|o(8__d$AbMF49i2fzUl2qC z6`~syqHh(VQ3_ENAoRY(8a#g(_;3(qIsgzmV(hiBWDfpTn6vRW&i<{Fw6lZ4x=CS8 z!W%?FcOeU*)r{w&4q|dnUMD@tG(>^`g(a`!Z-x0k{Ef38Q&=m1m7)BH!a5&sz(Z&d zDdAy_?$}!B@I%b63BFea-x&(uO$uMri=;QM+$FwF3ZKZbE3u`5sJTLPoI=z^A?llUCYi*UbLD_{;YMJy`ZDC{>PuC z^*t2YFYp#^eH~<8T?f8-f^Uq%_khB8io#d)SNM2#46@B`hHSIK3UjXD>!|ScSNQ&| z@clcAPg_}tAxl9h**kjof-{t8)%H;Aq>$~QYM%u6LgYz=G;0|`kLd_K_Qc8N1cchS zOaehs5!1vZ-d|#c)LteDZzDK5@IT<0CHU|*^Yo4gddkTzztvaS&3hr&>GC3e?OmVc za}Dl;uVSRkV4w+V`$(U--gZAtVd{MNZ>kcx03vVUJ%JMIcE#^4lc)Vrab-|rx~C#&@=HbK612| z(Q!h6htZbH;nF0unM)0?6_Uv<{0M+ECrIX~O@YDNlZxWkBmU>Iw*6U}wKK8O=^9ZB z+Y7}9^jm%uoq!(9S_4YX;_oL}SvGd$1+%Ku4qJTS#@k?)Eez%sJ>Bk4p0B}B3Ef&` z=oOnf0g+-T`-y@lv=0DZb643J-63hNMUV4`mpG+Qz{^Pe1y02Rq##X1X16S)Pb3|I z1&Kaj4N9rC0<|wTSj>Gy7#=h5!0~Pz>&CWV*+#~gc@gN{3n(xq7|Iq;Zd7JCWXm-uil{gVn{ zsolL@JD+pq;~?iKrp7XLC{u?#iBwyrIx&^N)K5(9Oh&4TsVz*s@f1=&F|~lHHB1%G zMCvo9?q=$JriML@)Iz34Fg1^;b!eEyFm;fK()x0Med5>i}F$jCg)5mQH(&r3JB^MJ$g3 zi+gn)#>}Gi=){qjHl&qpHF@YJ&TnK^M@SPjD{Cx{eZWB**wiHyDLFU+O7pSQA@Z%3 zywKn>GyuAVEBLs?g<|OMwZsT~K^95-qTYr!@z?=4hmWzY7Tk-#|SstO5sV#GHGCGR|Xs_HiU>v1HsN86B9h z2pO?1q1+sLI_Aek@rgg4=zBXAh3E4RM7T$;5@GWcqlWJ&zr-wHcKB(CM37r&V`SJ! z(jqKdahy*?y2XRkUZd>px5#X>GsggF~{>0K!R`~8_{Sx=gkI*5Md zo(R!ja?N!wiB2cc?@bn>nT`_ek0Clwi2fZ>4VUPnVu=p)8jjM~;0wAjkfh~e{-o8e z`3uE=gpFTZy{wWWDx%CDCTrEi#48LxVLhfO{!UaGBZV&y(8BOABI&V{1CKOJcnUmg zMpYX$^GK2!gcu~l@diCIQZiR!mGs)h{IhM8adj1dl?G7FutZq(1(VQVbY$$eUqt

        4Tw#3BuY@9ynMd;f!m)kfn4iMV;lD-oa|&2fVYWtt z$sE4%_QoDhK!(bOVfUN9pfQx#tI6R$tk=WBKdbT$lu<)96@~3iEE2*e5k(^T^>O6f ziX7J#sJd=uT@~g8Ja|1GGkI@ZIiYg_4N;IGg!OlGIJ_%Y&1egA;aX_#bWeUL@zFSt zc3pFjmWcAMLDv3V*W0}Q-E`E73JRrCz5CKV{-nmQ>>8&u0EDBpT!t)%h?9a^p@>Ek zM`UBj&0o{Y)*D0O``){IN89z!mA@S&H3>NF(vXz$IC3cP=pw1!&+0TmACi{FsT7)!_`}tr$tALyHWRKFP(sqsYr+$E$yQx3QuI$eZ;CDVoSuDCqB?w z6o1Y)QJ$DtHF$CsnX!8X9o2Qx7k6~wPie;=GPo9-e&>#7J++I@^<++Ru}_85E9-co9#@I=9$#T&hSTBsml&E%{BA!h4QFpy2`cD9u9U&Qje=G z+K_X?;%%fzkdnWM^>f)uIdp#CzUw*05?~P0RuD+t&y!!u8*(r+EP>Nq6urW#rCTcWZ*FkK~+OdE+faAv?N%Xj&DWr zYgR`GUaLM}3Aeo8cm|uS!|%020je)U@tJpVz{vf%X-n5%6%#w56eB7Gb{%j+?65-D z^puaB>dTD99?TFQw$(Blm%WFV=sAJY7E^t9L80^4Fdd1=;B8a8aFvw+yuA$;65T@L zIK#kkkKQN;8so*}RfyLCQ$x2Sj^?Y$!!TcWLjo#HMwaoA(6Szl&=+gS)IV?a7$dWc z)ar?A@JvKWWTC)*pcUE@3Z(;$_G#_cgVGt&3-GWGu2G5JznS?J{jk|mFet|v5Vgny z8m9#ATZPHl10E8ccI(xIT@piBzq$$AxxWyWkT7<<^q6vH9OCd}O22ENt5SB{9 zZWh8AB80^_oa+T#33%M5%caf=!fc1i^5%>wk zogayVcWnJarFu8fu0^USzIatsyOf_Et6d%kR*Z$Czk}wF(JtL6rlI%@eBh;(N`U)7 zfbGMYK_Ndf9jODEdV;C_n7aExq&(zkYNEJMU)CQ(3roLn9l82F6#ncr{eaO_g zk07;(sgX?0XR2ojQnQ#k9VrH*p5#ksXm$HRrjAC+NQ!@HO($MWjR5DE_D|GYgVep%HOXvIwAMjAMJ-qgXkty`p!4emOg`YOiR@`_`8+HO#FQIIjl8VghPd! zwV|Qr6#0ZiSA%D~R;}Az=$+tf(X0`#V+L6pxdWgOZ}dUv{ACyH>}8lic8~rI1`6%G zP3YCnS3ziBMyiG;($2?IoF}}F?OAmy9oyvR*4P|dVaAL~U3wHh|B2;p&^i@#&=pJ9=Iv$2|R)&PvI|GNArynH9hgLivP_Q+{{FEhZ~uAZU(Q#sVr`l z9F7MrU`ofsD(S=G`m&{9NL{}a8ifMDIT8jKtu>C@Ulo_dMU;G&&<;`~pgH;v`Y33~A+{M^)zB&M<3{HK{h8_j2ma&b151 zh=FDrsKn|h3ye2*H?Atl!=otvwU49T($_t;x3r}ni*f2MC1p)YN_p3$st&=_{cO_c+516C;d($bcPHy6r|wCU zw;Y5fU-douUhYoB?it=pwDV%@7N2pCNCfpHgp85^1vCSXZ0jR3B**HB`eVTY#Dp?9eU`^ zG0-!f%#g$D7&Emwgie!D#z@n0S$k5d`OoE0&1J~Qc$?0K(;UlT;`;NA*McYC184tn zP^hm|fOX)&Rnf360J0At#O;9CJk=S^)wI{J>g!y~M!EW*mE4U_ph8HC2JP92PD_q- z6=o>vlVBwEX^G1S^6>@96r+uKk0j-R)>HV5HXQ9^1PCTCBd!op2MNjKKn}7kD!^ND zZ%DS4jtfEjT-1IGTLkb5{SbdpM|5%>aTz*SaI!el5>5Bum3ye^mV6NH)-5OMZaufp zUv;Zm<8Rs?J$uU<;f@6Bg4zTs0XLP&3(?ADpKcvUEAU&jxdQ3f)1@~`yA#SVUKj!%Mm7B(fW!#?26Ogk9NfsC+M#D zKK-w{0vjQ2O-4U#`WgZp_a;))u&B)40bhIw;T>2S4qHo{53n!{PDw9CLO69vbYH9% zyL$;AB!WK3z)F96jo+4X=MBuVT3}*?dHVoX5{=V&_hcOPacmS#N1zzBgS4|j_8$hiNi~k11)GJTr9)8? zBZf)IhbYL{Pg|}1LHOJ=AXLsb;0<;?+RuN0=6+8`DGtd&2P{7-b1(Z1W%={!_ zS%TYm#^kO+v-GAD=b*1R8BG8cZm6q=CLplzbR{&Q_{TpX^IG^T`|DNw4hxV&FLx#b zd#;b7qM4Zg(j@sYUa(yVRgJ}@ZKSJHz(VDpC4PAWhe{0_-Tn~oP`U2ly&Nji*6%Od zLu1r-X>_QZe!LzkYfjsPp_11Y1Ei7%BlP{oxINIZe?JzI`{$j^mDMoF*eXbdtoinq z-k!0fMsHUhr+YgYce3bRrk>uOUWnfAEd5XmBUMvT{Ggf`$GaGh7mTlffH)7ve#H2( zw6PY(mjvUVl{IKQ!o`>^7-iq72jiAIfib^sj6Vp*=WAkI-c7gq62T}NP(2u*AjaeB z#@G?RdAf_!SO0_oV3R{xM@akZ| z9DIz_T}Wt}qNUgzNP{7zMXuD6veNW=D_ki4ot_<{(Yp0#fdsmC_QZ?4{%ZmDd=MAD zfCL&8ym>4u-aP(3x=m`;)49lUJD2z?B8!-YSuI|b@^sr)g0(*)!`;c~Y=4Ylmzh#$ zq%vwO7zqgq`DIR#irPevVS5ABdF|;|n`_CK8mc@8JH*fw+0qq?fBL|`qsmio0Rmc1 zwI1mhcl)Qf^X~S~{_jM)>4vUKy97?_$zp#o)izr}mH)Yd?uwil(A@*6Vm!q@`BG0W znPqK&QT3l+Me)fPd-;}RX46q~W75CeAe0N=)IJG?U9W7L{56|8!}s@K?Wwj-$^F4- zll2)KSGm=PSCyeIJm}5_vwnc8VBJCUY(A7S37Y5QW&JHmsBjZ7e;5p1Nui4DbM*Mu z4$jaaa4RAR0T8Fc)n=?%qBgiq4P0?6HmT_%b<-e4>ZZ$#p@hHA&A>oSj;D=SYkw0+IU!PQhL`S zMPb*Ze9RxNsgo;%gcPyjZcUmi)g!$fbbQ^U+_$k7S7wc^$rXiNlhS{eq#Q4#i21KU z$~7^hyangl1@Op9LTyrxtVN2#u1R^Td{mu(aBB+5FC*CBUFhXXcHN{*s;b46 zhg9IvBen{=CM9i`q-?~&&d7lJ12H4&&TMPt`tkly{3Gwfxz_@M4T8JbQv2?0*bJLx z!tuEm#~`wUEu1?z=Lyb~wQIcttk?nFddba-rm?QWO6`*mz|Jf&E9xYHgsNnAKvf1K zqGtzhUtWhv+1}b~QUGmS+4g-JP~IZVoPJVX{s zzHJg_u!`YWiMAg&v>gLU)6rI^zf7iOcc^`#o$Pb+m{Iri_0P7k%i`X7Yu`BFbVFZW zpTRZb&|cEvL1?=r&V{O4>5ZNEl^Ew-WMCQV&qdK?tTjkO_t#pmTPA%Z3wA7zRXQ%% zDSu}-3wFx1`s@dPMJtDZg)U_<7qpPM)&^%Pv^?hYIW5;1f!Uy_DE@{w(E(7TT*G;+ z6U9MKr{H=Ob?5kvpE?0-alI3f-M)awhgY)ou8XX+wa!UEjjJ#n3uv>gMUH`YJYg=i zgGCx5B)Kt(jP<_Y)vGid`4iF2itYT_LyLMf0tB{ z*9sd`_Gt=RjXM4nQ%8=cjzrecTQYXhObVf@fGPXSbwX~9YAaN3jcRA9T-~&-D2_(+ z4foY1L$iG8lw;pv^g5iHzXg`hX!gew$X|)oW)_LR88jb+=~p{kf)e+$%%*TLu#uG^ z1@$A|!4R{o&;h7UhyS#jiqLmv;n*Z~v0JcM0Q_yNyaRKr(Y50b=U-BXhIs%htdKM9 zv~FzqcQni;L-tU^{C8ed!@PZ%)-dG=W&NdwSr!Kk(_b!6Q0undmT-~8 zg$rdS!~6M0z;}r_`g_4}$R^RcJ9VXl-<#hQzoRblfM420;2amZF9T4h{|^3KM8QRv zE=SCXTyOhi`{)g+0p6ZlCn=FWRw9rDl&%P{Bc1jVw6EjVU+0XaAR^{|U+~XKM=qZD zps)JP0~7r7AUgb)@9!l|Gww(q7eI1L0rqhL$+d9u<{bdEzHuI1LJC=F_gz%VaXIl0 zR4PLi_o?y_OfYfNY+W%ufpGGZz~`KUPryX$>5~6ul>Cw|s6nV=LQ(aii>0Sv89}Og zl}MFrr&KBJEN}r;bv+c|D$*9qkaJx?#gP3KAo*b2^=c(Zk0`?@`4&v<>K0Ip`QlGB zq!6F8|(5oneo*frgxQgIMN^OQV*# zAJSgSj1aFn)2a8-kdxXhvln)|k48;HzmbyeJfhm7f3f;U7XjzKKzKf z&Qf(1dFr~hLF?kg1^bCv*AHE!U59zJ zwh;D$K`M89LXPz#hS@e}$TxL-`W3jwR5`us`nHYVHaZ<@fAd=(0p&)g2|s~^(@4Tq zTv?3-&FCrMZ6wHtPba<)Iza7>`~){2#m0H;b>E?Z<9;B8UgN@|Yzx;4lYq)OW->vP zlT(Qw_i~O#20fjXxF$&bf@Gms0;i(7X1v1AXC*s+WWG0eV2@`0DK_)HGkH6Y`PWIl zcUo=tWc~}1@15h?smxy|`Q8bqoxuE#4%t&H+J8DMK~a3`Sv8{lC$&?Kh?$hgSclvq z;E8)T9}6}6-y_N5T9Ndd1mjz;)WG8%H@o-2-QGCVAHCp}i zfx6WJ!AM)?U59!5T3{SdH^%b>A&a#wd& z;Q)jAlo;#<9MA#zlo#Z8%qZ;BDg#H0vaPcY%qr}2Xsr!#7Y`A)PVEd-zwa7~FZmPG z-^k2w+aHI)({oS8%B(>j_DKapIl+-QRrCN8<4N`v{r7O@H~snO%x_VWQWOEFBQ@4v z#FjqW?1Y_M?8f+;5){&7O*jXpsj()!(_)fi<$i|M0*>@dYslBmX0#XK`_0%6f^++S z@KNS8rLSyqXcn5hyB#`#0~4#0WCY$gBJjqUO_9mbQfTs8cYL8(;tMBQMJ7eI(B$q^ zeBq=EUs91*B=^-9nujBuVeN1pMYa2|#UZZEMjBn*ns1g!rIu0Wf*r1v7X|4|FQ(BJ z>*&sQLvrJ~-E4q2x_h=~I_wEFKlTNrEq2A|EftvbM0XW-9o-%L!md_~0@(UiVTxI; zLCVe9UQ)h2Km<1*EY*uwtjj*IHYsVfNKx1|DNCN;6)B^I6tTxONcqL@B?X3s&96y{ z^?5C>JUzVTN`S(yNjYtoq~r)GV#wW^bO&7$L&_g*>m+68s#>HRQi~LYU6b&T23~Utbg@g<8R0*w4$ACu*&^ zir9`&q>y%(E4K`-$rbTv;I&JMHi{G}5qmP}OBoWeyGBcAAT!(g%y~xXd&;W4B*Q~l zpe0xNVmFMzw_!Onh}Ok##bN4!TX}HCr6Qv`&QAHoL5Sg@r=lT-iv6_q|MMWi<9FfW zZIyy8UER>tQ9JwWBU#O3FRo(Nb!q7+H?ygxK{iOPY?xKa0IAyj8wUvB~yoc2Ny7M~4s1!AM9 ztslYS2(|;Bmfc<<>*-dRbe=$^5^D98fLaMC?$Z6`-DDWW_%j|j5x*sY%V_QyFM!+T z0Pr;ezN`TkE5PO@8nAy*06!$4ML<&km)egAVB(1B1Vo(q}2VYX8ys~PT= z^l`j2B(h^}+OJ;SzDGOea_8Ao|4rSVH4k`1p#`(bkgO7!nzW=SehIkaUQ)89saEMZ zbn?_%sM;4N@a`QsksJ4Lv6?jtbfZ(wS;|h43!c!?@1hgY(LI$sjF^p9r(A(nA4t52 z{T<_h4xTnsx;$){DGI(D;qB3YUkhJ`UH-=s>GDg9H9Nml64Z=<3kdk82K-n7HU&nJ zjh)vB-&em5z-a{huLgWh0scNs1D>UX=rsafL%=IEV7>zU+^zchNrKTLU?u_6HQ+D> znCfEeHbnqO67UcLw%35iDZp1;jMK1%3d7+P0&cn-fWN?PvJ(J>A=(B~E<<$q5P@n# zsP_rA1W@G7HAx`1CO zz-a_LlYqGz@KOc%k_)(>2yx;y1nfe<&H%Je7bqnf!Q?WG9cj=}7f6HB3H-+>0B?g& zX14(_nteD>3RI?Q_Q8Z&K`8mHXB=I&E7$13%FlE0RMOu zfO81=8UXG01}@%4grCILqh@O%w;g97~WznVoq z-y(n$33v(tdH)&d9H0Q-b20jr2n{A+YXa`40Xr$ci(L^~ex+bMntm<_bq2=j zMbdK1t-7gVQ5*r^A|RKi-76&C6JVDCzul>YX(kw;K``JdW})b07R3n*spEcCM2*T&I07C|z+*IE9|ib77vr{@1#ln%n-j2!20Tas zUhFD`c*Tdq3Ha3|0Q?+rUh<*p9pS^xZq-N2aht^LuK@6M0?yKal?rgATXkEdxRwzx zNWeQa;G+ugCKs^B9YW(X1iYAl7XZ+n04NMh)++;Z-5CNknNX(^s;5SGhCK*S+uXG=ulO3n=2tVjP#Zn&N2tEjKK!(X1~0< zoeLMvU_R~~NoBN0;5^#k1ojx5rx={C0bUgU4s^b|U+vf5x2el~`jz3d+>HHVb_Vy#u_5*-3Huh+D zgzk5aTT5Pf1A%r6=8u+qZ&c3y6&lldLh`*KGJ7TSzm$A$yvkm{{C4Yz-y1x#pJ9HU zD@9s^lnc?^VxXA9C$5z zO`mN@Y)6#KM*!sqkX#Q5?3d|rIyHnD^1}#cel9S5L|j$J@GK& z`uu$0T7d%=6{cEN2d;H*NgG@57T5m-mtKlb{PE-*xDa4gQT&D>xwR{g;xeC{f5nP--p;INcRHF-?5tMr6Kk-DO{N+5L{0Y%sPZwXA zhrG{_=e)>p@05vmoLN%aV1_5dUR@OKD}`8n19Y>f#drGCF4K!aPVYYrUR$HZdE-yuV;pdL5V#QJ6DpVy+8i zx}el1Au*09-#P~<=V7I;!c-;!D3`n;4c~Z|ZulM$d!k_0MkVo?nZSH8F<&5<$!O`h zYZc}PYGSU7*dqm{DvBR)B1(fO_ZO7&T$G0>l$m>ivb~^GMMH^kMETZmwjWV@cTs}v zpQqX%^tK-ot0EtD{FZ`YwiL|T7$!dR6x&bC7XY(oEPjpXh%+EI?_K7d9Gf?Xd51^x zL`0up9@i*6`0i%j?+pCxftQ1gn8P7E>cU(uWZRFm=dlcRrEb#{@8!8T=J+g(5pRPk zL&ARVZU)Yg(te_%LFn3#G~5UpR9+QQ_SS*Oq2-hAdA6`S`o z^V-Jd{g-(=(H>77w=wUhNS@GlCG$RuAozwZq>72($ zX6KRE^fs~cSp0pxGeIFP)O2dw@OZeTvg?^+Ae?;Ea=5X^7zKy~%Vip4hy)LXa*V2A z465@_UPKzsyYPaH^D{gv-F?A&vm!O@N-&4W8|m0=zC6$n^12qPTfcG$aUjl^w+ev4n+W8e%+?N($tXg zQ!Z=h`JYR#p8vhs2=%S^mJ9O+&0j_D$)Hz9{u?KMS6m-M@09tZSGJ`XT~w6X=z<`1 zrqKm4YWzir8h;U?#@}58s2f_}K~K$qJh<1YFl~<;U+)nn;op6u4{GbxMdKPVy#;b3 zjpyi;_Q)2Cw_HGfrnEi#^x9&A+d>c&$e^o^a~xanK=K;x#bdn2cB>a@nqzpCQK zOf1l09l6gn?)8|Lo^8DJ1x>~Sv_BbhN6j@C(Vvv8 zdb&Uj=}*Sct2WK+J9SD&l3vMbtn_l1bmXT!5`|vLYOM6CqZ69HBQ7L=C9AR0s}7N9 zdSAjZj|x+=8Y{i(9F3-T#|Y9ZS&fz6m|Ng-gORP@qWas2_N?WfLf#PPy9;>TOg z`)ARc*_i3Ab-XD3`(}~jMNc7JVNRk}t}rL!QQwuBhF_mADCO-;h}Yv>-e{z7RsC&4 z=|+Z=Pkyu!`eQNnSseq_`mMt`)Nhj2sPu)$|4}DlHNDpiC%ux@Sm{-#fHl3P!$_}W zHCB4n3204kqR=Z@jg?+?`diaGVkr45S&fz6S=40MZbXr`Um8MsC9Cn!n_nvT3XZ!8 z6XRu6xbhoCOxZt9!U5M>%TvpltAD9*G1B#HNPVuN-CQD#seS;)sLM z6{j7HuKFe)^<$;l5(VYvGW&qEpRn!fM)0-1+phM8US2h{r}q!l5wFk8{Ac+m_xJs0 z(Yv-!W2RRL?$KA(TMO*@_}VLZm8&=HqAMFGefgyfSl2mUTX{uY^R;s3>iODir0Z+s z8rgke`K4TNsFNR+qwC_wtIXB>n2GfNIeu`#s7`*&y}T}dJkDIrk7A_%&+&r`5Own7 znNfA|<6h=!ewaxApW_D?km}^e1DDmskIBr{{1}h)|2cll+7&c@XI-q-8a;%zAbFn`9yvx18_=yNvK*6W6EB6vGf<|_8fmKXRh{^XCwW8 zuD|40eIm00;lz&4?yR7`&29Mjs=Hv>4%4l5Jz^&7(-Q||7@5jLv=4+(A!h97EF3XEBw>z0(ckh>a4q>BX z{m&P9CgmiO(P5C!3(!I9|GeZ6JBj3bzqpZEG~;jGxZ4o-x71Dl97X?ZFZ~bnApPDi zje-8?{l;~S&$TBu-tk%2JvTiXHNA=dIbLh&o{)=ha@CDIg=kPzTuIpLTR9r;KAHc; z6_(r#TGFiR$aCuLRMkJ8>(OT}I}dPwu1GuUA0A(St~S{EPK4fC>})eUIWn&Pu7zko z`&Ns->xMN3`Xc(jsDzpbT6MY}MeVFro#P74TP0VmIDFczsW1O~C<MJ03*YqO&XS{%cUjf11? zSckMLAAeI<=v@qduXMw$cSrd_=TrDWm$NoMHl0<2AKxOw6^|82|KH$8M8DPMK-HOO zaIMY2Um&->qP@rKm3yKc)5e7rgwf5ipvXS8q->EPcylM38?>*;Qvq z|8v^u34VQn+(z2}HTc`T{**Q>e`|1Z>LB574XSTJ?mvUS%W~^YX+!e2j`?|J=YQ7x z{Qe{U5%glh(kTJN#7kNnlT;x&Oz|15exP5o!l+xZ_x z@3@ZtEdDM!tWndu3d&3Gzn2&o93N)ci6FbaVX=lC$5{` zkHA*0vj}@%K9uxImOF>q>$q-%#m6H4d65KdTpG7zCi?=b$8+uQxfC6hRvVws9m%M4 zYc{B!rlg_Qt4Wh@Tt6+j^(4+CZ=4WF$NhG2M9}Jqz2WBbk^Za8erAH;`cg`Bzfb0? zb@;3IAN0?ncWuf)i{2jpFnR;+|5^O~v|Zz+H@}oN-Z$1jO;GlZ7x>46?b)u}s^=2hhGY1onMkUyDjeSY1~3>$ViDoA9-sJZXsiG7*0uzmydD z8shhYYIW3xHuctX4K+WAv=<}2J8vNhbEFRhf$I7sJa~Ol{e9I2njb{yEh-^h`K7$$ z$v1vD*CU~*>=z#7#ZR}B>Km6;Si<;OJsXSB>E1z3 zr=4j#-QehK0OSp9pYlsdQv;08g3=_klPeUsA)GC)o>uRz#QQ*hqCZkOKFy`$_EUrO z>BM?#k%oZjI)Oh8|{8MXgX09>$z=hGxHw^89zZKXg)3!qNCvyb1;U z!6rFzRXFe7*(kt;l|KI^&8GO{s={k3%o%Y|PyXO+!4&M5;13gTs^B$8va*nVgb12r zeVb$bZm&t*9zL~+5!l?4$U_1iZfOMWKEdY;lo{s3c>2T5{nkwh{z`}nw`52=jV{t` z{PvWv0Z+}AE}BhUG~2ppHg*xd`X?_Uzt6kyf{gPsMr2%&ap8z}6zwhcn)c3`_LQVp z+Q%r`1DW8TF{iAcx`|=lG6XQaPii?7mr@7Hk7WUq%+8;Xhm2MDYRrj$v&D(N`6*~) z+EV++Yqo{`W|06!eTSe*c5nX#XH=xRW_w-T_lK$KiVlmd4nIWC z&JQ#NZkK^w|4kU-nLn73{0{flnL6_de{|0%7f4C?CUk!ZC4ns!KKyybpyeBPF@;s6<(ZL9e zI^El(9PFm%2!MZ!hY@giX+*G?0>I6fU2-hY@3*#F3v;b%`_Sea!cH=(mDA_W^gl^} zYB}K8W@7Q{GQh);iGsQo`>oLWu(JZCDr8WSZE8@a@8O^v*g^Hn4M%z#VFa4@_4(vN zBX-Uf;fvA=aqs$rZJkwrfKaQHRQrP^s>;5au{lQz4{ASn) z90}xptJ+^~pK6%+6$*4@j~(n142&n5A>6psZ*8)dU8#pfQ-J3LZ%9Ig(*Xo*Gx(@9 zpT&d!{NbibLj;YUYr+?r!mrLC55Ry3ZK-K!$o=u_eE^^Q?6 zO&SwYjmb#y2b-;uQTfO*tbx^bMB?9jf8XR^?j%v)`w%*4DjIt-Ng8v4sfIcIX!NeR)-ZbjdB$6;A*~D*Q&*;K%}V<@ z*IaFw0|hE{4CaZVW3unOyj3>{+@A$)&z^ElW z$yHmHAa}Y$h2X0QUBSG3REyy^7nvA~%*+nvPbDpB)&4iS-Cms2ZOfU%{oB6vTjl<= z<$h~P_O=;?@_nKIlZAe3xxd`$1w}G;lyPnOC}U*VCSzxXl8E-Agj$5AHsXV*<+orkJce!2P z%?kO$S)IzWPi<#`pGEWKWf*hv&J49$!O!!2P2zl?*x5lDFsjnf5_Y#Wa~U4^&=Vs` ziBM=2a!}fTR-ufo!q6t2F}N^9=`9RxMn;w~XZYEfg(X|m#|cBy3rl}Py0By`{^kbr z(sQihHIf|d&#_*zkwh7PUS?sa3TX(&EIcr>DH!~RI>!#fzVdB&2Sq8MXdaS<=0^O@ z4W_5&SY{cLTNlO|W;{kgPH;B+IwSwKG>GNl$jJ^4P37zgx!O9|Q|507=PN-r%--oR z1*I3^Go*F4Ffk}Y8H#Nga*e>h0RcjW;^K%o(#{&_9(ZemXJCXlFbs1f3V~XYRZ9dL zgmm$Tq-h*w7;5L!l9@7Ct&Q2%cKd_hD8iA>HviZf4%@diY3g$}BIOEqC@%p?<-d*1 z)5K^soNcYjur}I(xn7dgSPh283S~$21!dx?oWfMF@2*XSGITc`L_=58u;oeNh~r?k zhkCHyv6sa)^;xU5`O{^bKOlv8GM6U2J_ZvXdESP#prMw3O0e~eN&G(gtuBnS)` zD4#4dg>RK+Djxg?8SKuSaMN6Pw(PT9vrMxa-?{)FWG){dM&KLxPT9dhN!g+Paan1r z{au&k7=2gyd%bJi;m-mNt9Ur!rVPf5h~X9GRjeX(U=z^X#6P)`uh|6^$|s4a`kc^A zifh_d$)P+0RW+%yiaAm-il*}onlkW58WOmVj6it5zbvQM@(esO5@5K0#>cd>9P0~z z!B27GSo)2=@4|=xqCCg?INQklB#RdQGXQ4H15RI70P2^PN9%TorQcea(@RW-QSctV zV6rhm9%8s$bL;A5B@w~QB`L!9)96Q9rmra;Frt`~plF3z33}r=47wwW!%P{TN{kD9 zM-`YdY|@I`b$0%4o6!~a3)0?f-(UQ!~9le63P;U#R}%q?Pw~j zQl!9#Ks}JDXQd@GsdsX$*<=9>Fz~XY4f9kKfyK!8kbJ zV2%J&COw}MEE!H*K~cV_iTz;&*27P8+OzRjh~!ba{7seQ^jc{YFBI=-3)DP;CFUD{0fJlxhd(hiX*two=LQS7A z)d=Lsu+=VOsR(uOrY`ntJDQ-m%Ia|r)E+8Z{JFjuswHeY9X-;>`Ye+jg$Fw-Cv-cc zM|DK-oGutORHZqgmpFK`-_~XF{h`uADOB$7wZt%2(v>JEB?8EVK}Vxfbg)!VDHB&o zYCRk(X6?Dwnq14VH~iVeM=HM~!m!vP2q~+@90Dw3%@A{F2vwz7O{zT-o?|(f3%e4X z_yjC>#HCX5q0}_WC|Q1v1ezZkfi!7Dh{K2Di7oAQq7k^C&2e4ryi_EWVA8-~G^MgB zs5INEh8){h|BB9uROtF}G*X6n1#2o0?T5EdfLHm7tO^+)A|tJ=!h9F6+{;i?{vBv{ z$Uhrw$9t+lTPgR3c@pqz3k+suhvPsNkH51e%F(c|c^+Fr)nwGZu5&WPjI}X~B-$4s z%cb5hJCNRB)Mq?NIH4FsAF`)elkZ*8+L)wa!9=wSoKmstsYQJimPVthoH`O^iD}z^7SFoC>nU9To!< z{Jj$sG7%s!?^Sr!co>`Nw?4Ns{%C?3Mun))AUwbnqtc`@;6Kewe;B_k@DW-QXK&lSISf}bN6n^lLZ!kIH&9e= zzwn0AEB41UZGFM{tW zI!n(C$oEI_6?|v^J7W-Ki3qqJS~^yBeUiUmC&qL7DFkmW+Y^c?gj!zwv78 z@jt-+%Mc1q@o^;KI!D872f&=*fTZk#?d&5PTrmPipj>uAIpQvAG88JNBxwP*|9AHK z=s*g|Kr+lfPb0<(=u$tFSBR?0Nb(_i$03A_BtDe7@G}%w#|&S1mkl9UxE^iQOSMCf zgYs9FQyR7wJmq-B6@o|Dr|Fh3`*1R8+?8%O zCn|hYV-%{yduzLqI?(5;sbZz3iZY~yGE6_&MwKq|Yi_5=gc4gNckl5d7w#FCuDJ4}x<#p-H`Gk~+i* zQ@w+LG=eaxgM(lxzM|8jgFwloJ!0zS2wqIWCD7&09>%xQEwoSD3etDg<$~D`q^WvfT*x{sOf)JnjA=%|KsE;I zUmm@RSu_}VL&ehSfm?Uo>TvHpYxT`-q}6Lc5+tDo8yrkLVIw5^W2hUd*>LjrJrDIc z8|;Xcx#6-6VN9R;{6t_inxHhU@u@+6;cf@{-Ka;0PU($WU)bZPa-5%z+S~UB4N3hH zjHE#+Mpvc6x{9znPj^7EXkFj#*enWV=E-d3=k~Wd<=rgCJ0m=h35+%}iT`#jf1j~K z5Wur8OmLc^ffZ8bP*-*B@$$mt1Qp3#ki^;|^U}aP;6F9axO1^|yz-8MHJw_s;KzuV zahAHJbWauEy+o_#`Sur^B8o5YYC7`WKwIEnL?28X@vH7sN_{xF^(pAoR`N-r7XHvs zcV=JPIH-w$wm+@|Iq^}UQ@CuHT|i5|a2`GBSMAmQvJ5jz`KQ65>27z335vLhYSjk8 zX}XFT>qxRvj_VGF=Dzj^w{s9}-OJU6war!MWEioXvk^mt^Ur3$?S}sgl}9A*#V*7D z`zQU&=e&9_L`{tl#AnhG+FDFm%MRutxKg|Xq8ABfjYTkP_A2CL1oO_aiW$CAQK<|g zDLvh2W3E9?9kD2U_TeiTj4JYm6&5oTHQ&eJ*-wSV3_~#xn4YrPxLqbC&ms`jNwHqp zvb>&JWw@@x@H;)xr$p&89evWC$HCs>>FLmw!=Z6Vm z6`v*m4A@yOd?yA1yC6BrSo~3wawh@tEPx`wJ`$kQ0V)a|)*4u4f|r%H6{W=#^cGwh zM)6`J@F7bDlla(x8-f3b%P)lbgRSAh zVv0CbNX^iT5A?g}oEw2QbP_5h+(4m#!tTztPt{ei-KPR1tMHcrp&n?nV9g1>L@3C& zG`--q?!dIAi;zPOQ{ z0&JK^0wO!^>+ImPWejOs-;$1lcFJ_rOb`m=r}g3`%qBU42vB}0d&xJxNm^N;OuMxZ zMH+IfAz)oHdve7Z;L0@G6i-Dao+UG+jS_uAe0H?THOJyP%J{5wmU<86g00LfxEPAg!?vsfv>jGqPf)sH5-xMjQVrb@R#{t6p7y+rp;L&iB9{8OrE>=ip zY6#&02cj>qSVDT>M}D1mBy#aDKf71I6eA!op-~tDbIjMJvSM-p*QbC5kdlqL*0=Vr zXRb%sS7-H7ms1IpB?&`VuWN&PE2Oz6zOk0HUiU)<%d0roODv z-fs=mW`U{&TAD34%oiZQ`K7P1vT?0)gHw_KiLm1M7Dy)`t>(it#=&AgpfDe%wAdpa z<{Vg6i%savIyYJ7z`7Mvj}pB!B?UxWTyiU@c*$9DIo>%sL!?&L zR+b_sD}XE=o6+N^C)Xk|`pn~z$SizmDQZU~ehGqkZBX@+@y6syzq+lVuD)cG=H|MoCW*%5p`51%k) zKN}A$+Q%7zOBrRhmPrg3%SB4*`L8IG$*LvJt3PfT@;Txd&&70FbRx%tBuEcb>?*#m zj_O9jXOyCKz8oV9dzFeS(!yNPD=s$z51@l`d;Mt?+|8a+-v5AL<{A}OEyB1dlsGJ^ zrOY7gRAE*ifw;=VU4&I#=T)sEW4sDkYQ@@K^HG#lk-+Ngu|yrzv%GGoG`(=M|B82{ z<#D3oG2|wI!t}yQe_SaMVj?f`)*~VHpj(Ku#DqepJPS}TViwzE70<(iV_Sujbl4Tz zmwYqK1AqVnF~|Cm5im0euVkhhb9Fo2`pJ#EhQ36f1||L{>!Lr&?hBc3MS`wG3aYBv zE~^!$(G}4BtdAxDUZ}w97uP!BZ0k>=3-p1ubmkt)0hG3yU313)Jq4L~SDcT( z2!Fi7#4$ByE8l5>jj?jS_~|l&jX4=9Fg|7~Wh!`PLQXIPF^1gXP!>dE_qrP{o%M&m zpfbTfkCK6Z*s72<9B~RMk~PwAwICmwI;+v%3gK+?y>`jY+)*vtaXyF_TE$q0TWZG= zJ-&=x5Lk`|(tF;Z8XArHU@t=|JjK_VJ3YQ3(`D9}8$72c+@$Ow*}*ti^2n0S*C?GW zZIy5h{HzSD`H8h)dKlcasi-c;Dj^woOvhVcXg2?r%)wu{VHxz&W*`lDA1M!smjcaP z4UhzYu}lXu&a})|k)msskxJJrA8+{0IsA>w4&IWK9qglqQ8p-ptrc+&l@KrD$1^CL z%G_{~E@m4BgO=9so&eWDUx>nI8Sv{NDJqlZ&Bhqm^fCS zkWj`(`-pDvDD-;J=YKR5yIU3!XNlSzMJH7fIm9#i^fyS-vfYoA{g z^IP8p%Eo=6+6q5Qqd;--^jJ<=5`XY!$X$tyN0$M!*$Obg$7bhri@+&qz(9Gqcl8K*dvO_wa^LmFw^+bG<1BYbeE=p|fnM>Tg0jOI5T$1u#> zIrok1;K;}BG_3cDVi$q!9e+soLn*gD5noX*2yBYf`xCZKegRBLHOwnHRqmZ=9LIpy zMwus@>8J+)2?S~?*=m_TjC~yvak39+g&FOnpLg|n%l`O$_AmIn zCyh<~Aik4tK7<1Mx9{4Fn#=qJr#-s@(R#yN2c4Z`#XpQU&3VmV=T+s$<5l$j9`$3uS}8~Kb7_A`j~;`0nV^yf1ppPL)zA-~J# z1M$#S)9y6U6HE&n&sbHkM5I0_S`=!wn#xQqL_z%W!S+#pZid01s!_((Rn9P3=Ts^t zx+|fM*o8Y%J$keJ#TMvn3|8~cBuXI1Dn@S41gVq$0j&B+)zxHBwnbW2F(a7gcY8G^ zfT1H7cYX>podHH=TRZ#(QY0aOeN#ser}ZlsuCTOq+N?md9CIh1(}7A1R#&-Mm`yVf zqrfI4kj(K3aL?^cYcLXf?KA@YWm}(?tX=IQ< z&!MCy@X=;qiqS^mq~wP42U?=(Kzt*?A4&{=*_AtSC;Q`;gx9##_Ktt#7;ZKlN8YLW zP!j|AkKD#irbZ0NH(eR(;|fK!(dG=)*FS*@62!G|ilP@sAFLph4Tk_?;Qo5e#QntQj+s>Nii^#)QT+@y55OUkYyfU;LQ zSUgq)ObD_Etp)cK-OeGhkTD)kJ|}5X^<(k1s}^0wW#+?F)w_>kl{_np=alk{H(H|) z?5pmhbm+ZFfltAtni8UVOm6}9hjLfhKX%5#&$5pxDoU~o7E*enzM8kYtnHpLxMOw; zpEFHL?t(3WFvx;Np)mdDB8*t?!Y?jLBDdg>r()>Ij#lkI+I?4JW9q5ItWCjdH+j`f zj_Q4iJ{$$5Z-T|tFo35f@LO?k+pw9$aX|u6`!XQT zLHuUFFJVQeBhU6RH5m-o-VFp`INJ$%IR3(TI0kEt09SSB%$~q8qW7fWyMgb4GF_Ds zI2P!f7XX^0f>6#lWatfX&IC!T{fsw#0C`@>42B=pAz|OL8dR)yv%X{2<;+^etWe^* zUsHW{{*D8E&Z%7W!%y{*#K@LN%m9>(QKaBYD+OW6R!Px(k)5dS*_8c&9OZpP!(CQi zQZ7i%CrH>EzChJWm8eh?sEtjM!Zvb!cmboh3dPY+Cw)Y5O&qyW2mh%f!pUtqBKUu> zeA>m>Ge0?m9UT9k548h!JB$t;uv$uRd_bvrKUPZ+I1t;UqIA~4R49f<7Pk==AqPy^+{f0B% zhk&-ka*Xwk-SYD$*v6)ITqEDoC{H2E7V`k+jE7wX$2H&BK$WHcl9bSaT7sYQT&x~Fy}+HU>V$=)?2TE zU&xikP-63MQZZm5nCS^{IhfNKIdtQe@(+U6SC^-iIg^1sI$q6*%fs9j;%pUR*oBM+ z?%KxwRZG*KfD)I%wU*cdg8;eyQ+yYNg@J-93z3I9kjb&4^%hjTtDjnd27IhmAJc{P zd#o%!`X*{iBh`vSVg#NQRH8JYLMf|&m>`*Y;K+(cjMCKPxwMU4CY|xkXWq^zhYSHz zO|x%}lS3=VU=pguBI6A@gzHbJ16cc@jI3kPdFH*IGN2P&+GuA6T_OQJ;|NyK3vJkZeV}Vl4F(Iv;RDhhHDCP896Zf!{j)5ux1!S z60>pVR(aUqjlGTEaB||+%pQ+b$9A#B!1XPksbK#`cE^}2DuI0kMkAU=2}ke@bjHu> z8*#4TO~Q#x5Rt0PNJ4E`&-%5D?m&t^lspZP_Pr0Z^*K8jFpj};@E&9F5z9bgnJZyu zcdnZ1n$VDJ3e}-fd--b{*|RjGY`ap5YQ;4&0atoS2j6>$q6jBH)eg=^M|yE;vzXIaJi0Z`u>_}Mvk(dUfR8aU=eb!6nB`;E zY^Js@N9s+cHZWCAFq{S}Sct86YadMwpNxd{!~Oy`$I6Dj5Y$>d*eCsdpl^LQS1szvHPDbMqm7@s5wmH% zo3m1;mniBZ8>8owo1>M;?GBnfxmC*~x0-Dbwe*e3C?uFhxIr*U7V(GV$taX{9{am}~R<56( z?%O20oC1qg97kl)>JKxd4#~7RBWV)@BhI~x1c`KJbmo8LA8O{WV+st8j#o3&?l~WXq$HWPQOV}Dr26cKe!(nv=uyHn4`YB;dIb6a&z>=WZ}jdDA8CChhA2%e!h-zq|?^T7jOPKs`wfbqxHU8ZLB?$fbaiC)qyA# z{{(QzqMf=_!8;#ub=7W2x*u~4`;4jZrLXD)6+iwQM5g{)au5Qh62ydFbfNO^a;%Z) ze(sPI*BM$%6d1d}qrkMEC;nO@4krRysRWs5z6aaL3dAwHn9&l3!-!Wn^->L zWI_Tj_VEGG`(`Scwl~f7VEDNJ7;dhO!Cl=|v%J{#;ZWj*KY&?x*su$yqiCpKxKou? zF^Z>F)rJ%EiIv=`bz>P$rH`|*?{MW}>^|Aa;rPTOD^UV&CJB>e84=eAF&yADaXW~D@ z*KR|fxfRZd55q_MzQw}%Le}E_IFui6R3C)|6goJqtk4`nl!c{d<56f1CR84v(gRz^ zN5Z_ci0j15)BD@>Zm9(MA|l+J?TZlQsmAJ| z^TS&*#9SvrGnu=1a)Q|@?qwxB+Z}Zo?E7!l-a?=+NQrgvQ0qKU!Fh?%2GbH{Ql0QT z+zLYBLN_>Z&<-Le)c?;+Zi~eQC6gC{E@uO5jo*qtelBcHI|T8x9=WGK^oZKVq&7`? z*K5?o%ju7e*V;LRTU7`;^j;ifrgHq_s4+5&WJ6tHF}E-l$ri=J;{PFy!~WcEi7uFp zhuW)y)5$aN!o6OEu-?Pz{#lYyIu;Miw|iVm6I?u!Zl1 z+)z8dwK1FH;dDau2FJ*ga)X0Xu!#kQYHwn3mrpgr?JI7gs2~b&uGoRT(VJX?gSvAG z?yW3zDT0YzoZ}f7a^q+HNFkYPwCM*52Z6%oLgD;5Q7F~pFh9cqn1j_1B-zDCq70VV zFhzHMq^siHHJy0oFsSZY}4WI$NEpW8clT7U3HLSWD(+IOlO| zM-4VS-v+o5^bUeXGulZqe6;wE8n8jhGRzn91_lSYN5~kw82t%1i!OnIEtoe3*SpcQ z+PX}SB_ugPnIM0$2S1O_brdfcT^2zbJpyW{dY@Dy)ThIBmDR<-=hqLx5h4Ae5$y+u zp2Wh-M4d~pyRHZ5+%LP?GA`#Kes9H2oj-Exlzy2Kyfe6Zjak$UcSl=vV#tM#3%?=NM=nelfK$dUb=r ztUv%T`{W&AlWQc28lLU<&g05+wh&^ty$#V-dhMf8&V7#t9Eg}h5@9S0 zOeFGt=ikt!Le}ffsrbaAA}fL;0E>gs3_qFHFrRbL$L#ed(Qei%|ACSQa0o9z8~lfe zO<(1H_M0zb1`xLU!EZX|dcVj1u!-7{(oPvll{^#Y7|#jg=5egQ9s4cR#PoZloWD}) z#IuiDg*NU+8=A#G6-cUzPA-5!naDux>gZwx4X!wQAV;CXyPcom`ax{-^|J}eN#fl)sO12`!-n?2%vFLQ{lIbB7a0sn;|2utu&-r1&8YK)tH7yt@tQ_Y!fJDp0 z&Gwy>DHGjG3FgrD)9wN5IcRDhL6~lt_UF)e;Fe0pC74{}=_CST$d&H^MMD(Ev1Z+r z>+lska+q|$6{I$D?AcclHtrfYX+Mxno6w%tfg9-Y*zR!RYj3=IA}IrW6V+2#J>}!c=|%pd zF7#e?DLm{LVx@S%ILE>?C(8{Bdsqy>8aw- z3m8Sx%$g&kRDKHQY#9FbO)p};7MuyXaezIWvgq+JWD&CU0pAR?&d}wMpOgXi0sQ$y z{9L%w$${Er%v~9pu$2C=UC8Zh{h!U5o?s&kaT>Sy;8`&QR=N8*1+v%C#!28Due^3?^d&lh-XVPM zOcItjEdxT_PPSOhIe+zHJRdAj<9WMv8>!X1H67Gx{G2G(gSYWIq-jX=bOwVvV{8G0aP}7{T5u!)ZZCkc>x@IJg*tVN`Z)hm1YQvw&K#J>d`TrrNJ(i5dPoh!}3FjrmkI)q0^+Hq|x~%JJ+8%lyb> zjPYn>0MyljHxV+eq9%F$)EJ_zT@atE8;Z=aPk&PIr+tM+wBji~i$U!CX%4&&z&9Ksx7a*k-JcC zWPnr^&{x|ZjX+$ax-G)2n$&_F(|#~jQfz~*>+2$%lhJ~;$PUj<4=*?#el$R`UC%1K zV87Am`Myu23Kv6C!Kdyr3@8~zJ;v|6MEq`J()xX&~j>^V!u6z4%T&4xlgna|V`@+a{7GSef*ty*KYJ0EV+tuK{IXP*h zJCC7OTdkp$J$b0sJe6P5-4NWSWeK0bJ`<>((5jp+hKCBs)>h>>j)7Js*1>X_yhL<< z;1qC=cZ;A=p6+GmizpBzCzTJbB#MHGXvvAwy&fNug#zKcNjur3ivTkv`(PSL zaVtky?IkDj%^GFOt^_k_0b!ZOVBEth3J;cG%IIC1dReVJ+&HV^bCtoW?OSW1{m|2J z93QZj1N6>)>^P6}xL_*#4{t%7ocInXdM%7s&1=*t$o)Uy7*h zT)_<8)NwY}2=FyVad=BEr0S%+N>;b|fTX*2{rHOSLs7Fd*QJSgd5QfIIC=8f-ES_j zH;f`#Yu**r%Jg{Bn-$f{G>IEeTA9|WwJ6hfD>Z{`MxEA7+a%_-VYtB#ZHsR$AsMG9 zPWR4&On;>x2DyNL5W)A(K6*c^o)dRB{DVb?&ud+PK;=FqSUy*J|Agx(9_)``<2(n2PY&&e;+Z}44=Bl(32p5@K39gh2S=5j z@UNP!pBSwrOpNG37=JMF8ctdANNBW1IdIhMU26xMv_^E63hLo6_AO6C55EruqG#NP zA`Xxr1H7|0_a#8MJaJDU>Nr#3cy?W_@sXox%UwD$8E*;o8|MOh&c`@_u~?gq5@$?P-(S>5X_Ibhs5Ed)}Y?ATzC@V>;NPScOp>f|sykJ8CfplYP!2tfKFi zV--CKy4O&a^&%LyzqkzgOz5e>U{>*x$_pvsP!-xREGkzY$#u`0nt;PI@}EsT?_taNSDO{MIJq6vD(q za5an<+;;Eo_~BlGfX^=GhWx)D5|SZR;&c*(2F_b1Lr*|gf|Ha*`j0G&wYncoGZ1G@%gtM>%~lE zi&z7aLHdu9LUnj{%Ms#kKkzC#g_T*)@DY(zIL#Nv5zi?ZYUXOu%9w`^c*=3Jil4hS!Pbs1mHiE5y$ytk9@9&-aaRUenyd8V8Y)dVrwm&?KoH7 zBFkx(tg6;Am3rN#@64%vE@}RyCnT`4-1?rUSBf4%V_LW=V2Bwk&Vu%q8LnT2oM*@S znEpR!0ALq&py|5cj@%EIgfj*@2w={kgXXBq0k0m#Tb?0L)L_e1W7J63_{AIKM@|$> z(=K@$8_eq;fQp(5$@m*ukdTb~0IKQUFQG`dLFj$5MTAups&I_Uhd?@SAsl1Do-7w? zVmQWP_}Ej!C8Y7h;i68FdJ+zq4r#S1q4r>(90$hAgR^*zP?O`Nk+0Q6r2u;u*B+I2 zFh$SUh}?p(Jm)jeh{T_3GM_^P>eb^+#rkqX>Z12co8Gh5_4PQb?{7Qm6p*(%YTER- ztk{w)YR4BLp_`6`;+uEVF}VZhplUWIx87H3a8R$Z~i;`6QKePpkgd~(3+Iit0odlNxf>4deU-EaYYf0 zN`{jANwb4+ULNhCWhySzAR?E&4E%ip_jalaLAc&P7!dVgJe3Ec1%9#n+}qZ}iT4P5 z%t*-rS$3x7Ud$_nh;YZt&J~ac)4dxWPLca>_DJ_GRP;0B-rHvR*;or+&;iKWv+x*x zfM?-ppja7&@I-j*=CONw)=bmRW^FdSQP30GgSekt0lJl)*81e#l82$#&yZX5vfup) zf^_`iebZNn#cm*-vhOL!k#+b#@Uh@94j^&G-X3GmZRY!=-_49a5yl5|*j%1h!jDVx zh9ghS1$kre_nf?m_%kxSs7k>P|x?ZqMvN(s6?ap2%yJo#(y?7`ebmT5<5>5vJyf@8IfqbWZ35|Al zTK^)tbui=|eRSG5vf<97EJ?W2VZPMPTmRaskyLn(Q^qg*vePMTSI#GS#tA_SlkV?q zMz*#5>z#)WEniZR?ic>ORiyh~pY2}jMH&9~b)R=SRT&3IuVk~>w||5R^Fpg zK@}j8Q-$EJ&ShO&&6nAU^rdu`A+PS9`XjtBlB6dijw)AG#$f zdzrlNX5&Y@DgRYhr`UJDvTqlx?Onld-Q5YXM~D&o)0)m!OLnRMVG^~(o-glK_%I4w z_ldh{o;t~J)?HnJj#R$PE|njJ8xXI|jY{wtaq?YsfRoTgop1B*g7uQFZ~fu6R{GXH z@9&2CmaG4++HLu-_#5|Mu$$^9>GZUBycInydS^GJr{r#TN}k+tTURi!UF3h*!hGs) z-F@d%C5gbgi#tW}errlQ` zc`l=R26N$HFLV`9f=I`GapasOU4fl2*;$v`yRQ7!`@3SB+!5)9fDcI^()p7b*X91- z+W|9s-c!4kKLvp)u0usd5N>>O_a6VryY2W@$X;r{@aU;pk)X&*ES8R%Ob$m)v zrA?k>Pla!oWj7|R@sZtCUdpji+|N<5H`A$uE$fSc4!g|h$4Mg=lLl4nM#rH z`ITLv1nfflMb2}i=CjXkKA-mdG;qc4OmB0FL_4T0!AH1O^5ItIL0jn0VxTP-7f4m^ z!!*-kTg_q2u6^d8V1lI!9ISH$bb;+zn!U6ARe$n^5dIm0=1__6b+woBtLIfb<3 zDtBJCJM)upEyb^=vh$;^<-qdHAG;&!de@#mx?TKxyU;=>Yl#_8WfwG!Q*NWNo;^_3 z^eydrTaBgmgJYq}RMm!)HTca%B){9!P^0rFyo>zt+&Xk;!|(R9f7pHX@o+6YbDoNe zTz}o0)4Rfv-TBDgMe7q_X=6_=8q*cDyQ}0e=F^|6F(rxDU%Z>oM>Ho%@{`{sQ|V%T zR%u2u{_z)e1uD9F{5(cLo84k;{3N#-FujZsh4sD&h37v!BA zjQu6Azsh!b4`0Qthw^Wl89(uma|)0Mvs);m87Ug_jH)YmwS85K*N9jckvTT=CNrZs z(S&CCs)<|hnH1ED*6|6+6Y=5ROloZkS>M=y`BO_`;IE9x6{oR!Tj?*}wf4_(M!<5k{CWB6~2C z5*^+A7shCcSkszO!jDu&GF-#T9{?`-;YC&76Al)CWJIl#IIK_2jUNOJ^Nj$`_2b+EVZGgLLf!SKQg8RUZ1E)pOO1I;ap~o=4<7C@=Jg&r zuGG5a#9z==u&Ut~(^`o4_AsiR=irw1FRi}o!~}m!yjdRo!l?c?+Lqoz1siaMC#P!y z53$L(a=boNu*oc5YuxyRB+M9^6^!qDjCsRCfp*5GVAU^uDu)|$OS@GEx*7Ajjk7X> z85@BjHWIQX@g87;(zJ4AjyIw!q{|>l8TmqCxB-!b*XjmDw7Pf2vq7ub{vP)8nptMt zyJ{vUmN^^~izFxJoC@N>h!s7QW^D*Ri5cRm-IfwgL6C@x&N!BBcIq5c(E{48$s)!S zip^L+H`&dI_yR2dGbSYTV8+h#nZ*Yfky6PmiF|bNYci01um!I-Waj=ZWL@P$mKxkM zYDBurt5MZ5(hgg3JFSxht~5tm@!`1ZzGgmusHz)Jdd62t_(QTn0?ZA#l)rE#>Wsm3 za8WAGLliGEjnYNI;#Z9-b;WfccW5lLiMhQZhaQ8LWPLQ@eHnRGEh!w=v)-SDTzL3~ zqyzF-=n#$!E(ZMkBXZXOZ)z+>{K~PIu_7b-CtL!`IZ5o{D=1|$tHKR3&N{qZ9{tdW z-hubaqu&|P4CDuqo70z{Dz71p7b_W&*YG0tfVeY&%`Ro9Z7`xMj*|8;5>~@V-jIUt z0^wgW^g66KAc$m@!Qu=fG7N7AW5KM3%#5Rg38VpZ6JX*V_>gsZUVg~>3)Awr$?gbr zFo-6!Y-gyOdOhgI6iA>DS`)#l6uul=maCeCO|{JptZ>v4%UeQ3Jp}v591wx;YAekB0iZ&n8#1dCkfDS~E73 zD8JB5pipy{6bh{@=RV*zgqx=`z_rSL%R%8>YVlG`1nhHDFG+!A8iO{ajh<8bH`*3D z9*?nNBE&dmq32`2b*D^(rI<)UiIiMcRSX9CcyXO~k@IifUECOLLN)%wS9wK!CB5+< zu2*l8j~dmBx|$Jp|F0Pap%SZ+A8{I5n%90AEPWAmMs!LpS|BY}b9P#=F;&rIrc&N; z9WGO!D2V{y#*d0OBIU#Y@8y5TQPyas-{VA1}LYTwxoP*WCugA!A6vITe zO26)sN$8t{xIy~-N54rp-(svtdLK+QAgdZ0GUJ(jL&eQO z*QWOlYPqrF-XFXpz4zPLuFgiU<*PLmy&q@BN`20;|3#iv>#g-=#!HKX87qQ^)CcQ7 z?H;r?mlrH8i<^nEL+Z<{#aJ(60QU0Yp}5g{6Bw}E^_@Uwp<6^UYpE1Ovx;CWNq0#m z?s3lM2W&YmQs(9Kqh3Z)QC*ekG|gs zR33s0tjn$U8x$o0;EMXTuBqt-h7^oc*slLQ6gDh#<4}QD9fkvbP;PBDBEJC$BM@sN zFxg<$!mRSx-p*S;a-bryps}j7bSBw$t3mZ^+J*w$42xkAk!W`6zMb$T6UzvceAw>w?x>p#i6!RMQvmpAnWJDoz>+4JOowWo@{D zilg6%)&f%H)-rQIcE3BxEKdQjfYv6=5$~>&sYaLMqapeV8UhT|rE-ly^6j`ZPVMV_ z3`V~PjLLhOPh0Wy*VW9Bk~nD9*#`|-5AG@>Orq{G3_zn!)GZ@=0L&s>x!-f3zH(ot zg1*LMJVxZV2VzDEx9=^FIoYZG#OdvO^rU(;qECVO0uh9~BqNA^jbF<2# zlAVWm$J=uQGK?%dK_noT^2e%RTkJ*im1`~*Lom7#8KY37Ee8AB`4DNJGmDgxalu#? z)F~J}OU(jWOqs@w@dIR8W;JGJTv2)X<-w{FUuK$}rz9xu$9MXHoI@4_uB<>NNm0Vl zZ$u6$CCI)+PCA#8wOV8ES%*pLdzq6e3{r$}o=6Kv9w9nuH?)9jP>{%vMMgo{aMSw4 zj9udo#m45FG$5D+Tj{KgVtN8wYmuxT#iQ;Ln@tDuVAYMmoqQ-rEPYgIWEfvZlJ z+@BG0H8UX@$^mrt#BAsq1SH$2Xt>~c(o&M4_@PZeUjy@~#<1+at`YI7spC;KGENOE zz{f72JK+gK$>oO?l~6QGrY$Y4gCW44K+3lF@U>~|?sYU4j1BPx3|~*+K$LPTIumt~ zIwH&u?P{ZTTsL6pB-m>2*vypq-vff>7v2@Wmwh+W_;vu z41ui^JXfEJbPn_Jz<;nq6rQ7RaAGkvhSa^?_n;2$TzxaZ&cP48|*-rkQxfC`zJF~v*_@;T?AM#y?Eq)hc-%r(_BjmS_m7>u1y zZIo(RD0Y=ER9t98dhAb5@;+_w^7zz@(uU0bFslFT3(SU5{UNff;k{7oVjozXU_8+i z3yhg|@{x!Hg&xd@vJ-6@ksy+tnpQJ%@%V!AK^fp)X2J51F{lN0fpOy*0o1waLi{yj z7x~Qz_05D;d|-DZ8S5Urp-vvF8cbNMl$w$WOEk}BJed;~%I_JgKp5lE8&ak-2a6V! zRLh4F;u!N?b!PET0el3q>cFW{T8NQuHmknLkkt<*cPY$e)Tjro2aUn+mqqF{Pc$NZ zQU7Ihh>1x4uCfS_d!~R)D>5~8cq%Xc*r+;>#a5hb`;6E*&AF24ayA+mjFiSIiztL5 zdPNUb7+ zdsLQSOa^B}%P@$5wGLU;pzn*LVg%e?AaWUrT3Q$vmlimhv|yfZSZ_r0(O1y= zSwYFwlPj3V^%q-<&1jJiQ4)YjA_QgzRBdM+(#k^U2NNKLgNsoY z=60yKK4c8355npZb30^|){D9QIp~+Pvd}evbjlfZ;uEw+-l27A`>?1mM=oeA)7OND z#L0`(Ol|<2uLR+)qwG-Fah5561R)R_pfX<8EM&Ug$Y?C~$VwwRigqs|UQokRf%lYx z&-_{!k-ZMs>?hQJlz;y2}5nG#F$0P$PKG2Bl z4YQ68272=vG7kX9x!PAkHy&W{1l|kArunsivzHYk!&h8VNkgy_+`*Rt7XAyv0Ry{& zaE#AVbfr`!*u2NFTejDob{me8pjL5_jP*r?BYvC$cYgYY|^!cpCcq_}v@{$&~ z^7n)+M=bdd>}PHiqT^fv;=|e27W_Pg;^)a1uWd&L>zW$ac)7Ik)_lDMJjQM&9?gM- z-&*^v)7s;4sU&UQG9FLDdue!t{$$TSb*E7INA^rq-botjWK>@CRclm!PSiY*5d2FaJShWdS=>2#nSXH0YtD#ld@7?`PQk{d! zMoD5sZ=iFtssS7e8SasOxggp^LM@2au>;s-{J^4+4-|A@&H@-S1>Nh?ydTdpZ)!Zw z_w7rsf?UvA8;PSgNSG(|jc7M~LoH6qo_3^@aMlvXioMxqzKh(jNvqq>0VnsY5OQ+j z0EC3XCwfq8-dgdyE%-x2R)6PjX-%(xC%x(1woR`-MKz5J7}MEy<)bdkUQ8~seJuNb zu<#(Mw#KrpshVX+uUDLDJQ#-CZJJN)NMRAOb0Zslu3|8Q8UdxK$ANRQnaHNOJR9}y!`U2~;-*`8@uN!u%FZ-MpQb`^9#VQiAi)Al5QQtJg;cRoK%S;@0 z)|9^VJeB4?PUVU4smKlu$lfOcz8ZNxm;CW8xY!`Qb-uaZe~h71W8gm;C_do8h<+i; zMNKXqNQTOd0#j5edyyaI=k#qjd+}(DU(vN4`aL|=|M{Huw}6fwW3yC&?(^fx4e&fj zo}+Ke^DH5kl-b!3#X)#UQt!cM2rw>sI~~SK`BD0)Qpmx8NJ1UrGjeu1jLR`Vm|GX0 zkOt#Kj_)tXO?VuCN@~VJW-UuI;8qg>TrC6yr)Bg;z#-{>I|4+3Q4m#Ia5x;$o5f~U zu&T}nr$fcnm6yH@J;4*q=sA^*AhkjWuXB7v4y${jwh@apuWdASF_ehg>4H zU=vvPY7ZVo9H>&VrOQ5(mBd=xBpzqhN$A3Lsz#eIG&AO%ecW+M5I(RMo{JY6k-w42 zSS#%D7sH*N+@h%P+M`&Y^Yp^0z-r3nKqW@mhxT)$S!VzU?4~^>9lJR0v7aTrQCQRB zK%iAkwbuDZ6UHwdI!BQdJX-fF&V5ITtKSI35u5^ld^w%af$4+uMh2#zlQ+Ct_I2TP$jmFZ zmItPX@N!dYVzld#8j*XO}KsDd1MnnamGPGoUz?c@wD+w5VGV=n}c-8Qg z!h_LgaGoz#IwAmZHUf*X1;9e}Qa`K1j~{3loHrZ>!1*wu#i?9A;p$u(v%!pyp+$#^ z*OwSI&t(r>NIO`X+K~>@Ag%k2kFc8iZ1!z^dXo;5>Vn(_ykk)J9Vms{7ID$FVMHm!Yjenc^wW(AXFN6yi45!^aB~`KP?FErRAYqLqP`s; zEW)mV@HTwhgQ5V6&a!H_U7+>>fWN_cCCCat6Gde}VjIuD;1@p=bVU28>Kc0f7kId1 z@lACN{bM?c07$xWa9%E{d=g3@r~kizzrF|NTm*|lvAj)MrLtdMvL+D-!y1Ynj%rDE zvsO64MI~lz&tS%zh^#pDx;^k0K2)#l9-f|?vRXn2^oafkFO(H731&bYI1>UOvt9!( zXkn+eB&*ySkJ34u!3$WO7*Jxp`6&0=i?A9d39C`+6CDKZZUEUGzk_b{wmu3|(S8CNb&@9+qltkRIex_WPT(TBv)1LF}H=yN{jOY;u z6E1aV6F~aUk$k9^hsdkg@`C(cjHd-?A04c1)W$f+Op6pYsn?9BjR> zQ4|RO1q;ZCECV%7K*h9cd)W^BBA=U&w|7@CqRwA43_e zVnX1s8Zd*+sECb_QMM*v)VxYx$anaHMcRj*7mK68sLGU)=-oGAEM{!*a=3x8ys|NI zjL9Y(6WGT<%q-R*n97ztKio-ITTUP}jt$F(h_$cSFC}R)SkakcHA=XOx6_DDfQd4= z`fD?}k_T6BFf-<`6*o#Ey2SO0+>F2q&=Q)Gp{ZR=cub{XOEqjs!}MlFZ$))5DS9XL z_b&!!w2v4F(8z{r!XObHF_5Gn;c0G=2LPlFNdhwc^Z z@YW{#syTL|jU%W*W6+2c(T9o?&zv?qLck*3a7o{ZT&O6@!-!+M(K!YV+Ke7Sq{~WL zcPt1nB6t0V!%~4&TDDr)_Z*WZyskH;~jl{Ur%KZBUS}%2xV_NSA4=brK|G-_4F<3pQ+AQ)nQxa zjA*ZW|a8vI?+8Oqz76FakF^qYjmWi2K~W z0F9no9|OI2QzyERpD1HcK`5=lBSMz#TnnVT{g>=e|4(%95c9uW>Gt33Ph!5cDa!s| zh9l9mK4zq6Vv!Ls`xEz!jQRkS_kmgUQ_@TJ0oiMGl=KSGvqe`ew!>UE?NsSs{DxRM z>y$ZMl)<4WD_qRs0~sP>TI-zwj93%mpCeY~b`k$~z@QL6*OGRi(%+~Zs6Sodg5XlN z8Pi_kcEo?B?A2>=qJlY;P{z(DY=I`wpc(g;zXz=yf<-+wzJhJ3c#Q`mFs*L$(J4Ml zv&_a)KfdBS970wpQh6)o&-W@e;lRE4lZ2#~9YL?23W3rVOe~r!W7h+j~9ALbN9Ouvtks^B=}r!ZzdH#(!YEdaG0g?6Qj1 za_t*J-Ie}F9TDEFaxj0K!GhX{4H61ZXqVpkUmVOAIOV_#AOny6&BxwWf=#J7M? za&8=x>rD#ypd-ug(D=V%5EXki_j2=y2G_xV{g0V@Huwf24eK&aSsiypHtSaHmIQC|tn zFd`>FJLc|oN*~oGWMl>1aWo;P7(xh2#SvN$#?JN0ZrzD^yF>F8TDcG7(*)#dEcwfY zD&!aJ*G6w!iJg&0Kq|q+oAUS zR(w2()GD9k61D)6K{&rG0`o|kzhPEOdM|I=TjnK&1H3O?MF&L{92BT8WpHpLLvB2n zD7+Z+uI%fnC`AR;VYEpNM5W0H{+uZ;fsC#VSxWVZqWlQ8p5I)eA6hwhPKQjCVRRdO&RWG zk7vT|0zddap$5=&u0d=N2*N{X={iGDhr7u7{U{M^L;@rW3vZe6>`RON9@{enzPLK< zbCL@QJu1coX2dv2I-EH2wBxjo30-bnuEiY<+1ZW*b)biuI70U6}0%(V?Er3y8Wj~3Rl4A@GKeu zJJH4@=1C!C{~C}ZG5X>C{kmR(*swj|*8`FR#=K#BjkDsH;5#c zi0;i9E1!=sFOWITioS|=Vi~|4KFh5i84&DZ(zR`{IrEwi0TF5}GQFGM;RKYhsoI2K z&v%4o70t!P%mWE_bA3c+>@50|{fhRC=w{ZoqD|-%t8o&>uDl8iR6rSL4OO_@YIe=k z#-1rN)rek)6A55bgcVjn6aJzVO=YsQqjhjc3Z)x^SAnkKfFnpk#$d$Zi~k5bktN|; z0uDU9roTt_Z!3PKT?d=&hxerGUxr4m)iX5bP(N|f7qm}a<^K1fi}3iJ!?PQ(+CC|FbA3t9l& zxg{o}YEo`U&CgtcecfVk;%~57w_PJj^R=G#4IG^^n!kaMCr5K<$D=Vj9*xt8(OiJh z!12Q63f@#raK^a8EXlE}&V116&bjd7BX@PXJTw2a99OSp8ik8|JPl27D({(Ec|{R~70 zkh~MU&OhV4n~L6h?N29!;@OD_hhr8v+tY+|G-9jvqQHbj>VV%qmo;A! zD8TuEc^{U?ul^bAIWxd>a5+Dt^+9+#Po8+(uN>Z^8#X1He)MAV#kgr1(7EQp(uRnf z_d6N~{+xX<3?9ykRN@PUdh-FC9AefJIRiP&i=^1)i3%J6?3pXmr4K9<e8%|>Z^O1)?}aK!8`4=k?3=P8pC!H&K$xo zp1m>;J|-Nj^Vqo!u8+ykTBx>_A@4Le!$}XqC)aq5wV~_0dNYE5vq4X?^riG6JQwq6>}}4Utxj z$QnQkEYZg@_r#jgVPkQ>R1}9{E9KSso!VlNb*Ke_vK+z9OfgRS!u#2Vk+`g{HAwDV z1g!Ly{l%>^NbIR}#30XQ6H7jY1yi*U{CY*?!^%B_*3wX{kMkye3dJ(u9LMfM3IFII zzjVzYDdV6QxSaf@7fqx#1jzX@H|l9XH?e6g^7ejD2n3+^1cro zg&1$h@?PBgIFI8^vzhgUS+X7`0;XD6Xx`8btRX`M-dLqLK`dJ3II9#Y$YghY*~dTC z!{fXLWMg&7*j&HT&|K~kak;}zfpZB$N2#cG{};Vt$_V&0(2^DnoK`q)_;;=iwZ5To zvbIS{#y6mS4)x&=nw!&~z~Fum7?RM_og zx8~+*95R^7vTb&yTt3&LAK;VS(iSUX_o_dbVagm!9XgG^OAXGN z=3GGKSE-Lz--|+W4X3y+fpbp!XwzJX42((7$(at{7C|T+F^PQFoE6GQ-469`PP!6p zMDFIM4b9nG@x`8pU!4ex+Bhh7h*Mv-e~+YlA^ISqIS?trp;OJi1Y?(@Ed#)Pr+Y{5 z4X-B5XL>awleAZJI+22K&A4~=Y;ubpX5;Bu1*n9QW3OY0uzkhNAx*D97i)4jWO-5T zL&j<*@(G>+6k&d0CPpLll(X8WOe zLeu9&=A_5tkPY#I+zvD_MYH}{eBYs8unq^ zH@_-5M1|FJfRcbBlNlk?OP<9SWb=6?j2R8?1(V7Xy$)9RG#Q;vSWw^^&;wZ{U%K*8))13TYRnP0G!oJ=A|MJUrDV z*dHintzFi(P56e_OVBygcQby=0 zo5HtOt8lXVk(@>OVtf2BXpF005=PU)RTLXuG`(c_7JOBc7o^b#&2HlI&ke2T-ouEV zKvGp~bHH6-n`yBz&QA-r0o{||I@se}i}MPt?ZLt&YYu8%f@Y~aKzs7z!>(Tj62Iy< zC~((Q^t@ktJmMq8=@<%*4Xy&bm_!@%9@AaNke$YMcq&Z$p5slbVc|Vi$BtYcqkK1e zed_4z0G#b`y%!t^ahH0sC(pL6#R+^ z?A-f+uOnUrxlSztr?~>+$ewP1aQ_BJydCDZQSh~HT?|pq(~WbieKsnu$=`NOuU&we zF2f~zdID$!xavS%&U{hwcF2n!&t6*S?&&{1pX%+YGc&~4I!2rct?{5_fIigPUPFLs zR&g?2eBKMu1~=oP$L=t*gb6t8P;l=(-Uk^S;Rl2oWuFdg71r3y$@60@)!U3yiQT(|6!UDNwo$2P6#a(=k7nlgY06JirzqYjmbstDX1pgr00Pi>P}vGauh@d<*N`!!qlW*5|S?O1#k! zeH!G%x$#B2VNaRS7?kPv5SXLeat>w>unh5|b0zhW_@guyr@7GCD<9r{$@yEP;@D zXBKHRX$Fxo;-wzW7aIW<%X{g63q8&N=-%$oHAt`7qZ|E+?qFJ0w^mMRAVPdhB=GcB z$n}j_az`HI@uVxUTc~$7>vc!HYS9GkUg!z8MogC{=QUA^MDU*yhX7Q{g0mUG)l)Wn z=`%J8hWgZmxfCc>KYxl7?lB#%Lu}823T9%gL2Ecv-E({46aNvhYGyfy%pvKifIF)u zpEJVsMrvYp@>ElVkLj|rTwQY(zT<)k-fDxZC3t~4E|uW@D$UCxA33u5Yz>OT}s|JCo&FTJXk{C82 zYkxi4-JGtLvv6X7!nsqYXo|DIY(Z>Uf+*Zt<@&t0eP#wC_8In3^(-Xp00?7qz=;o> zjm_bx$-Y!jDdH{R#rej*HAWk+0yf^r*_u*{WT?uC7ON?d0f^AHN4y3K$T*M=&}ALR zugT66PTc~FV>p&S`lt(vF3{eI#wBb-z7#1a%N;Yw#ao!ZpC7QdFbHLD!7O5RSF8C1 zDr|=%iRHWser7M~iB+L?XR-IBtSFpr1_e|MlC{I3Q4#pNa{+#4pa)uWCNOM6 zYXtm`*0!z@%x8so_9wGIk!0U?zgg~v#}^w5IranL$>WB{uaA-qkGD`NLC>c_!s5+- zxuDt4K*k|BhOnip)=P&vfe~3rPaqH zF9}ys>J3S`1$(b9DIX3p((4K9tna_T3g%KckHfxKoAP5=ekRI63J=1{H|DMkO;}2O zt~{eYdC?(OIK`54*ee92xPTBmZTIUYkRun{AK zv^yX6BoChYk~}b}W+=Dsv`0X%F|l$$mgI{1Km-*z07Wl*u|oS~IR8-gDIE{^#g7lj z=rMRJXqh-O0yQ2*Q2wWtAcPsL&wFw=KTs|QFtQ(hA|KVW2cl@fkwo#{OMr`oh>pPs zw!g_QGEz+rS4}!7Qcb=BjncUiO;)ww(zewz6_Afwp}M1`pRiFE>u%4 zLBZ7-P@}PR`Nq$MARe?qW|PR7G8h{fd9H??WPX?uDM;oHnl$c8bDPjybRJ=ZF+EwS zSF}d{@OZR1i9tq?_kb;UloD5^^aS_>M^ubuY~ZVx0f)|K*f!+lj4nSz1@H9kehfgO zU&TZkkd}|>gBdjddLZbPGop7NIcxq!}4Gu7;&$69ch4g2y z7z|eY_CFJemuU#eRxrq%c(zZsx#(1gG%k|C;SOIYUg~QYoRxVg!aTZ`+;QPq!WRUTDxoYi}joG-wx4{P<0C5rK)7042Ih-4p_20)6d%B0Jmz3pWfLJp!uW~+)$u@f9cT7iY|xflYqWSl z-Db2-wHrS=w}C#e<5=5V=yCe5PYNEqYonIk9q+aga*;QP2C=@9TV>H4p^2|s3Oz6T zF{%ap11ov2ixpu+8CY-<0XH=ddSidEWmgA-DtBfsj%em% z*hvngxrKAAy-k~D3VS#jJ*4dt-HNfvF46bU3Z{FH!=T+=qKht)@m3V59ikWRp>>$t zAp*P4#zt>)YiK0kl?45kf^C&%4Nxx!EcI=7X?qwR4(|5eoPO$dxXAsoDq6*;Hcn|B ze@e_jjdorIn{2~%)4&8q{jd3qrk6DwcmcD8KMQe59lr85_5z&6sO3U@fVZTKvBwW$ zKN@}lFhS+^Nt6aO>?U?}FIhNlQ4w0hri7wUL_tP=C7vH0 z2M8ygUW`~s-j|=m2?n{NM#rCwK;R;sklsrkrN~i+I*vjB0KiQ8QHY^(6e4Mdlo#0< zcdm8yD0Je%D`tFTk$vDyuR0r;9%cq_mXg^@zg0FV6u?}(mF^01Zh~xdA)|;Ervew} zVt!mNFkFmClwVx!*Av+AYDVQ%)4i|%Sm=4BABMevf3P;z{Z2E@aZ+EMwv7dg44?OZ z9|6Gol+YvOjo~{ydmeMage&|Nl@l+&)U<{loCF0n4!LJP+1C)g7Guq@e}bPS@H|g> zk|p5wtseRplqh7h_A&UkazB;J7hnGM-p)_mAj1| zeOCzD^(7k7XNZ5zUmo6=;c*^7fkGS^0hhTQL%FL}FP|$QCw^R|4AuPXI!O?K5Wzr= zKmre)TR*`|@$6-L`aSme1He`CVJvD$C=Nt4*cU#JC73OCWCspF#3yz~Z&qy`Q043g z+D|gmIqCk2(nn;ZOBDRnwJ6BIRKPq`pE@Y(?qcMxQoh!J|qzJr7N~0fJRYF><1wX@ScwY zR*1G=ewZhm)bSL=#2~l296$j%h*~r9M@TE|!K*3e;sc7UA0G~`PDCT(hfB(HG|HNy z08;FNbT~NY?2pnI-9P!FRx@J5A&yFr#ZKfZ7Ko7Q6Hfrtk#9+ENoA?wR;?^WE)gwC zxDQO_Kov{ksQlbyWY=69c{ez&zTr?>mE80CnF;w&<$(~N#)4BeH(=zZ^ z!Do-tvao}RlRl#eM@$K{-h{D(Wm1lbWu-KCSXPK)Nd}}-=2xSJvbfyslhtTfkbUEQ zFbPljf^e5+)A7o+l#W;8*|{E`dkkIql5WF1fJjkte!ZSbj#}KsSm@xuIhzhna^OuZ z2MY%d%=dHHT3)G>O{O&h^q{XZ0O`7ZYsjs}4B|7%qK+e@Mkp^BHEGsk&ps4f>8~O> zX9=rz!-wXCWzuuDwo>KlMeSD@yDkF|Tn`Jp;el2Z`263fH1+^cP6y3RQ_?ndTBI1q zM3zHygtR8CoHd|djZr|IcmbH3@rz~!PU3$FFE>g7a^LJfU7Wvdchx}vWAGkaWEw7Z z!T+{4f_fN{XPTt7iLB@%Hn}tGG<{66RV!NwZu?R{fb|df|FCPm7hWlnH^qHz-}^7{ znjr9|j}vNA|7!(FT@D!TFsZ+HKS=#0#GFEeY#t&0&O>pRvGR8o&qaS95Jd4=lziG} z1?Z5Pg4U2`=qo?p*Oy;gg4V%7Yg!hruEg<&pK#C!AK!;-=c8suMZR{1D1v@=bvvU> z9ej{*pcc-UD#7ehHaR%)PF0QZ0fp#N;N?Vdjx6bpqIk+0x=OkKoatp^Cm60u`g(c6{Y*Pu=t;r_4hQ^Nfm zIxyqj|K5|Y*Lgg90=`4lo;?(IO{+bV1vp)g%$f55_uq3QdM8EkVH%oB>Tw@C?)_#Y z;@m}t^fumyR+BmcCxKtuD~%d}_VQ{<7e&7CNVBKd3{9hT9KkCE-8m$JhG*KXN$?B7 zQx977B69m78!!(SlBpEi+R{>i@M-kh{~-f*|fb7`>6JeQ#Un!kYZT6o)b z+#CEGS~`sVUknJW`GY$nSBT?~0M1h4i30|M!F`Ll&JVa`!(BrV?1$|y;RI)XQ%D^Z zE0g4eb2sx+wc^?S?tYK`A$m9V)b3%ul!jczrF0#pEygsM^!7`Q*gvq8J_D;sGkkhJ z*~jw+Qf3e4fX~VEwMwE?_3d~w{zMpkfo~xs8GkGChP&EA#eUk~1>cnqv*Dih;=;bD zdnIb&FN2t?ULD^m7fy%yGPly7hOUmht;5{y4d3Eks(f@~_d;Y!Hqj;Jc8;w055I)ACK&k;^fMiY|885O-r4aE?7Z;`&3)Ua)8;Sj-Pc*|r5~>9`K4Zp>>`mf z|EO&(#hsuBZLP`Dzx#_;OW*98{x}&G=-IDzf2)q{lKD|>MSqYlO7v$x^SP2Q8srX z867Si{cGs2P z$6qY+n?)Uy)z0B(OY`|^Rp-qoT+5MrDh6(8y-q<#IJGgB{oZ+n$e`^zJr*w4?BU z2J0>D{9SIRwjZt~rEXT}|yRGrGJ89hE zV0LsprTERV6`c?ND!Bnv`Db&%U!OrYy*v;Q!_0%~<8cvoO|x5v(2h+{U-AQzh%aH;p(pcnpK-l zGOFsq!Vw@9AJKwT=smCLjmQ)~BU3I4T#SrNIfLFneA3w7)6I+(iBECSEg~Mz%}VUY z19)FB;5ar6jjprr!I=@O9%o|F7H)>9sarFTx8j-;F3zPaB0;CRL_qN_nN#Wbaq6_?^Af00f{zP>(>qLH!7@t66gFEdQe_@2@8VsITN4PGj>ij2ffM z)J>eGs+!K(>PLUuw)*Nm*35Q)A)X1y-?+W-0T)(tYD5Z>PpO9zdB|4}xHQs5*IXde z8KdXpgjC14M_~w#AuKfOKf})3z=d+B`5}a5{N5}!fk6+$ivVd0KQu_EvIgml*UdGt zDGh{3E*_i<@$(CK+vA+bmtwc&Oa0d1Dw49>`tyUse~oWGMtb3dgruFhY`Uru!QHrD zWSxE3HG3g#A&!Hll?7^0wwh&v;%T{>GAb@gql#PjdpcEo?C|(=S~E}Fj%Myu%@BeW z2g}?JlkpFmnBbyk`GBw&!cjCFEb)EHBqwFZv4f35&%a;`w zO;kLC(YmYe%0=wFxdadz_Ybv`}}{?sb8?uKt$xX9yA<%QAbV54Bh7(C;%X1Mx{ zm*8_83Znh_#VDxttIs(;eBzFREPMcyIHbRwe=z=+JmilYn1_JJSvKCo$%$rs7}35sZEfNP_^KA4QT0z8Zw$sm zc}O>b?vDi~L&e2LWVkelGrN(4P*h(0mps1_d0G|Xw)UR7u)h)cmn!UTMAiW#tXYES zXjPbLL_X4m!;Q#nRp>P$i*?}`q#0F(h^T%}7fv)Hb5&tar1q7Ph{wfVA}m(YAI*f>O5u{D zGSCh(!3V0PAXrrdRDOp;_rVx)x-cR(PW0+w;JOmFo>&}2u09SiSRC^BknInpp^Q4A zmEz&JH0+1|d`De)4GFaeJ)=gXgm(`7U&$PK2^Mzds(E|tCNSGhZF0>0o0v$}ad-__;J+~HmlsuS>TX1@;JHs>ek^Cg)95$& z7DO`oO5EPD$-cQh!?R|uKzK?K*340WDOw9z*W*|*v%cemp@@`DozXET{KOeeDJTgi zWKNT_z`S||nTKG2cVchEW4nCdAj}H`dZrtWl%yv0780~XRvM9aK^SF`gb|&O8o7IBgKHhH=09y9k9RbJI%RdN_>@8`vXSyt1Ti#D zqBI`oiozPOYeT?ttcH(xiC!vn?g8+je`XrdB9b+m$VOy(EPFt0q32RFw(nu1rDAVf zJS$P!9^=*m){J2dc$~rD_aUn#@QNR`g4U~m#4&pU!;#m){f5T&J*C|G+W7@%&9+1f zKMO6KkHbm;Rxn8h&vq+ZSq9Q63J5=*%--Z!9=Zqzi z)iqQCN=O5*f*5e_>%{SAaSNe9ZbQcNsiu0a^#eZ;x;}3|7Et<Xiu7XaW8o!bn=LxyV%{ zP}~Sfa*huy#HBJge~-iS3(Ij2@qEu|IH$rMqR2lYL})}TG*Y+{*Zu>6z3~5ovdD)< z^>rvMw^ra3p;@pA22G&qC;xTXW!CDD@$hov#wj?$5xC)}FxoPz_654jt);<&&B2W2 zl4l$)4+NFO;sEj2p3&kaaed-;$muu zzZk~N|KY^y0^xz4i;YNv)f07QaYN;IDWpLmQpj>~K)WclrwF;4qt z`t@nwGmb;MSfPNondp{Ayg0_979Y7GE+D}%Uq22APK1A<&!q7ni#{cz@y9grXLym> z7^Z)n|Dcvp!O>qI$5+9aO013_Nt03{)*h;b!5WBfv$)=fJ}1}uNa_I;^X-tj7y>8e z`KBGNcM1UI!Ca1F}bBu|g!{zITH6V20DTZZzI2=X;vfZCKB1tE|>f2l(O*Ikj>dfnx!XBU+|@5Ui**4=w3 zNMCnz)$E7WreOwX_&oju*Az>;K7 zSE}bNfN9y>6qq(0q``C=MoJi^7g$0_vJU-eE)@+M5V&#x;91*emj4In8q*N<*oV=B)Omia@mGB_FPu%cza(O&2btJT#%?3_=r21nyOWhbkI z|9zErG6pobM^`VUVz>9dn zV@2=72LMmOj(2Xy2b8}c&eGP@;aUqkR!7NKi7=1}fN$f;m>Yl;{ymWVMMY*Xk(mbu z%5sc3Sb#qxjtIv7oEwZ?<;TPVN0vc-jQ*O}fmw2c5pJ#|Q^xt^XXIlJnR2x_L#yNT zFILwq#NWZy(M9+OGz5ye1slokAz?oXSr@h>wa+q~OBF>?TRGGhKl(mN@gSGV-vz7w zi>&6yk*5EtQjjS zX*_sMh!+5=D#}zd<_^bQds*SlFoV~i0#VxwYr=@|h8DC>aGA&(38yMX_m#AvJFU!x zE5cf?aD%Fpgt)g!Ko&D`#T5SICJh|8XA$p@ApG!Y`oTa;_$SU1EMpLppthnHb{34t z?~Wzz1fhZI#=%xgeN(T}cqZ~%3wDDUb+}XqI3^i5KR}hloja@2fB|50_1X*SHYA)s zh__BAV$2nStTy2qs~OF%Es&h1KqO19`U&RFyU@=E$I7AjZ0a70jm$NoXJOXm@OP@r zmJi@}s5_F4)rEg@byrRCqlwAP9|G23AK-kQa4yG_K<^GrD^Oil2WjSrJgP$v%IM5(~J(0Pmmp;yAf@r5RI^RQ0CyK2p^ycaDA9$GFm{4?F7IH9zhH zi15yB^6Wov#>F=!P=>{kV-~iUFC0CsCUo=;3g0#j3j4SHL8Dr|!858RuIPr(d^C3$?T)mO_;EW(!wGfR8&+irI7B`g^E8(EAp+S- z!@p8$z`A{PJDXufnz8bUV5uc!Fut-ebU>=Fe#2MZ-|&qrF?<&ehr`m(;sUw2L)%5D z%OP)Dk$|g_72#>5IEAB;R+f>kn(R|jL=^+N#%QC@=<)hq1h9@tSeqP{X;oL_Z5Z(Q zi;qDR#wdl3(Kv{r*yCjJ%2j3w;KjI<0QO$XY{^4(6cS)NA>Mo5xkP;$vgvUR!vkXs zF3pP6!Eme7T%MNTf39~DRkfTojK9H91i{eAl<>~TqAKv)=tsDuH3DtqSxzzLjc&r> zdD#5JNfMnq*3Y_q+u2RN@*$c8bzw%Zfk*nuzMg#=LOxbx?CR=>@iJ-@dOZ%K>`;BqqO80-WDUKT3j4#=}%=M>p`@cz6}A?yKASa>qL znvtn+LBT!VpKCZ;BtTe>3;yzbhGHbFiy20Dn#|nHz9s7jJ+i1yOzgg{c+QclF4NyaI=fV zjVq&5HU{iR%D+uGjYu>Bp-6ELLZ#YPT?#1~RZ^1I{e?wd@*-h2mecv7h;;~8v3>p@+C)tb5Q4rG|D~k@1uQa>f#Kxo8N_!{4~lt zc_pm6;k(Xm^3jXG#r-Wq{mrl+nUkk!WAp`}O()t}e2@a7PpEa!hRDAMPU zEd+1{9nrkju0kSUqLVEC?$dxuq7j~>d?WhU5v;OVK|yV%Se5fb*7v$WQ7YkoqV83W zrmBZ>rN2C$keN$F5)wykK)Qdj`p%Aac|f?cu4vNMVr^WP`uG&g4R1w>4sj?jw@ze!K9`#YAS>z zbY79e;e*5!rORnO5Fup*)K0L^Of^hJoI&No9!fhXc9J_|%IM`a~9Dw^gNDky0xGRw^)c^B_hjYh4ARDG~{yq(j zr;l!jzVl`#(FgD;xVg|)a1-GRYL!?E@^wjoX=+Q57;Z~zs~40r3gyoJ}7{Ra_B=T6J=PIHc^U& z_wOg+m zx;Fujs!AHayMaIg#2Yq^j!V#}#FdOVLlh;A1a4!u;DUl1xZyVQ>OdkoiZpb$n{pu|MV`eFUd-=38Jy=BmAlRgBAIG}%OK|5O!J zSlq>Xil4crfJ(x!i;=5X_p-`w{MRpTkbUiaFK~UMJo$?jn{l;W1M!Li_6q;RdW&r+ z((-?*ibcNnRySGpv=-V*3zKS9RoY|=-8BGE|8l_E>FU%E{q7JD&EpIRXuBn^xVjIq z$P^33l#td%MIEoyYS)OE_qSFIw+O;ret+e~H@0_fmDdC=vVyV+P{IoGdE(*Z zCRoUjw<-TNY@SR*CmzfZp+^;=TEBlSB;mH$4iA7i|~fPe3Xw_z3}rj}AmcA~nDdtY5=ZEYsi zbxu@wz}{DvXGB&q=~5lctR8IFy|1pj5xLK;u6v@o1NXkV{PIE4v;0I=hqS7y4`dmZ z$ucZ=mw|Splbo|GR{AF#PZH_a>yktcfwd@ed73nIj4IPDeWx>wY7palod_r z&c4XrR`Sla6zuP}HaRZ<&(!041EL4JXk!>8=YfMkFxWdd_w!k6E&Gy7L|u`GyecwC zLxTt`sk6)B(ymj+f4!{}c=xg~@CMx3>DeDivAu~xEZ-6a*RZ4%; zW?Vvlvr4ASzVKojWyfD6BNSW-HaLE07XMpQSbXWEM<6Tq7n|CGu_=mti@xaN!MH(< zyGr~4P&BC|2(Rxox`=kv2RApMpso$#Y{WeccF6*iKp*xb7ZQQ}Xy^OS3H3_Iupg_u zymZ~JR%~nm1CSNFkV(t9Vvir5wqlp>V#RWhsw>%6k<_Zp=%`W~K1P20h}#F8-q!IO z-sV+`H|I#y;9c==w8f; zi7g`7$%vfz0R@^E)g$CBmV571_uMI4q_KzZGtQmu_#~(+lhrCW34lK^+%-OWUXKa-x%?oF>b^4_rBMTUP9{R|3&Ni`n6fcLAB3Wf^Q z^Tbe|`zzn@_$<4{ZyEl&!P&A8_{|d@j$bybQZSdv*)-T&;ztcGkpGAFo|(rd^9;eK z<%a~~*X3a-(hfef9rEmL_No_cro*oPBEiCIjxC`}n#X5)*3qz!qAW8PsiIp(c`r{2$dz2eLc`@6~)>-KwwT!e(H-CW;EDP zC-@CQudUZbFgvIK-8DqLy^(iLp5v4F6|t-fsYKMj=Pu>7PMx*|n?Y1gkm!JKTnth9 z>PSh*dJrd~2}HH~_~DbtY4^F1qEAuO{?Abx8kJa5G){KG%qcr6|*z>@_6$v3)Po=`4UrKlt>UG?Fu>GG(b?ySZSVV z%x>tfV!I*6$$bt^0G$Qm?5%2wPd)IMOzSkTa*hZVg)Yl-ZJ4#&^DM?6PB-a6JnN3XOQbC= z154iy#zob{nk6_&kGrwpw~swvf`_~CJhjkP4SoI=4fRrXWZUfMY29HjmY}88%sVDF z^Xw%PVa$o7!o4t#b!_!xaZKlO>Z!I_$*um6nKGsA<+@>jVbD<~_BQG5+4Bt-Y zzsouHiWYVPD;2bsBLw402E5`tnh;(wXe|yB5dLyLlV5bN%l{;I(|a|r!dV}Da)_s* zy%D>W>ad2D+dpGJLZUadT5di>PF~04oSr*MlA=e-OZ?RH4$a(Ywcnj8RZ);VtM#$g zw5I?OY$2Z)NU@alqp71lYv$nl2{7wI|obP?1Z79?(VTgRWxDChnw&7JBYF2gi)qF#qugLS0FXwIUGjM0Y z;~_At=AF>5av)#KIIN{X>wAC6b|bQph}nK-t?JxHOgAe(g#Qc1M@lHx@OExMpg!dW zM71$F#3^&q_K>V~cpaGnMN0!-^sZc4Amp)AMy(8lTDddftNAt?ldU6+d+vixQ^sBG zWj(^%41I~G#lgoEhk9n8DUMJB7^)RR7XLruNRR!uszVHPP@ZS z2!iMf%P$MWe$VynvfjYMy;6S>qhBSV&BGOdc3UMnNBMm--(X>{<0s&iV@%Mp?adt0 zgI=r@)Mv^SFS7$uEH+2#s=wPT+DZ4M-$ILulQl9%Rh3(@ZhJ_)GiGhd((NH?ra4to zP^bKb0Lze6RZ^4Sv?KH1Wl_Cb5_1rnChf|ZX!xuRjipt}1Va|hwKdmbWaT2Z&lL9% zBPAMptbOkgx#WdJ_+j<#PI4A~-7AG<{@3ZQ+%PG4w8wGpqN5`pv` z1FaS8iZ_gV$|1H~u=$zPD}VNd*L3jJtZ5%!*?(ZpN@o<`5_MQRd^O(zi#veDeo_l3 z&d4S*kc4Y-_e3!nB?DHFF#H7qW3JLW>;fz|1ywSoqQeav#R~T97j-~^>z~dIlqETfrkoooI{>^Cos}+@&$C++r>z?Gaf)}C#d)c zrw1>948<1dr`}D#Q>Mx_y5;H|F>_;c>7~%2;A-!dfZlbo#1wB-bwC&F455XD@(+#;`>7ILCk+p(<@^R(1B}KtPw4SwATs2u#S1@Jgd*C1eH) zmGh>eN+GBcH{FCXO=?V`H^~clMsyR);vBIEa&5f2JP#bnXLL=HoYCcg30W_cqXLYY)_LMT% z-a$x9XCevG$w2(Xy0y}DzmrwdlJKgV;9CM|{f4I5OByvquBCDqh+xUbns`cEBc(sq z?`>wcL3Ub`uHS3lPg4V3G0>e$WUaD#-nTo}%8j9@n5*BO1#|V5A3!)$89}yOJC@rO zmtd$MR%P1O(3yqs4Py7y!$>$zf0C7K6l3iDE6qIr4bG==%o(k+UdsN!xr)6<-1bAE zv?2~{mHi~Bn-AjEGj8|)nybTEc+^8U9$q$M_74k zyT!iGATQHqzi4+CD%7Ek-YvN687s2oV z%=vS9G2;SCw%HGdMa=;>`74UTocJxwn7RoZ3DV|TjS;a0SW7DMxkAp9^D+Omyp2Ic z1y8fID`+!`h3!KROGIiMPwk9aa4B%2O@drohPYxv!M_?+NSM*O0WuI)^wfXh2riuo z7gJh-$ur6zVZxF(|NIu2kwY%H6q*)SNY3uH=o=6X=F71On%9X1`wpxsE9C-+Z=e;F ziy#B}ZL6Dii->6q$p>3@ zZhozAtJi*b;Wr@KM(1S}wleGM{)|oR`#+NNhv!R?!){k+1~Z2Ltv1dqIJj= z;c0$B2qA>x>~yg91i8p1aB8ow1#+}U0xn!6_qM(c<*b9UvV&MNyZkpB8l88)P^*zc z$6@wmQLv*fU||lXt8`JRy12~Cqh>gW>3l3iO_0RfG%pCEqu{8yyl}H_a9`(To;dQq zBKe&fUV@mQqJm0T1KOAT9qGTQJUIORR_rpXBEo|5Bi3;uSHdeH#ZB_8E^VDjukUh^^r+5ffa=0KBj+^2E!y*d9T{XH z8oj1L9>j|tWG+t$<35)ITazz4OmkpHWF9A~v|XlFob9DwT{*gtpx`@g?}1#Ys3ROA@R1er;+flj4UjXa_TsL9Kw2}#|+e_@BgrE#O<}=+E&B556T6j)IVS>}(#>JYNO;QEAmrAx1e~;N z=?}D2Kb5)^6R5l4wL9JNL!;w+ExlH2NM2o=lT|g^?A4vT`Kt*|uvYve{zr zUtsU=>|}EaMRqB(x&_U)3jT)w%8uc`v-4$_iCR&?_@mgRiG^2hvGBq>71XwU5ir<0U4T24?CvZcw6&lKag7B#9FLCVtvM@LXe{j3xY=YYP@mVdFu zQ_{Bomb5?VZGX~9Ft8)f>XQ2X6Z!r>^1TV_SE$2tZr=E2P+v1w6rJ*k7|hHBs(txE zwJ*{bp=OQ8G7WWuWFkFvgBncLRi)^6j)&k^WgSC}2{L@%=PpVj_^0ggd7+jlX(cIX zD5(>6G}?s4DfpbexcEFatQX;O8)%X1zf7>mlSaQJN687EcI79yILZDT+F3P7uB5gx z!Ye_O7{=5N>I*Vb(o!crOI0Z&aGstiEfvV)XXJ!v3HB2Gb%#wzcZ`&T%|FTnNKAU^ z0eEAR>RRr5748g5$;KWN=P-kx$fu@by8Tnv1S`e4c^61N1-A<%LQ|mR+h1wM+;;m7 z%lKrD^kbX-^sVqlpGiZ!JR&cXzLW!F!n9)z)N~i79k=)0wP}ZOtn^h(JMP!(FOua{ z(~g}-XWR$7H0`+jU+e;xOPxIT8z^oWycHKR70E3tbt<=N!np+jkT3?{^9!$XI->z( zX7mG`tAwk6HrwNoE2{T#3XgD*vG{fVKrWX(`6t}BERg7%N6KOnM}8_O|Czsm^8Y~L zS-n{yd*@oXm@9d$%DSBcLIPBu{KN&-Rl@DYa}T<+C8)lFASMk|%Rnpui4rtu=Qbh+ zJc+J|2sH9<&PQ_Yh#nvd@6!Esc}coo@rSCcAIBxTQQ&qXil<$72Ma>C^ZPIZPh+T< z-dN2oZe#rtjdf0GY+_1dM&vU2(vp?eY-NJYJu5p2f3v6&(pW#%1#w~S_E|?_HXeQP zY;=UNtmC1vs0y1*nH7$S<#s38p7D=vf_-|W3}wv=O=nWT)1)shn*wr`^Oh+_3c4|(#@01;C)vP%OjZJ@&RgLE)eKcb z?!4Pu0@Y|FfoVW>vjVD9J4>IzaZf+oO`)Pwe|keFJV=7sctFD4X#!KH?o^5mKe8F7 z784WaTu!?*cjsnI7;D$dQ?>KVi)2D6au*EYuQA>UR*rN!{U_xhhjh3 z#gBPs7c8tf>j`8&JDc-E{M0va2cr~7oVew3zt+9NzX>J0_#e>VPi83L&lSj%e@1#N zGCX8Kz8${MR$dqIiq1oX$=4%HUW+hUR4pq}qu37japew~uf|46zqyJ%T&cF`CjHzNnB* z>dKbf0M07?)Nx=Lbq^_W2W?kn{pRLk&s=b_XSV#u+4Hgw-9^7j7JXK~;s0~v|J*eG ze>i^DmS*GJ_7yqNo0jYI|CO5+XasxN*UZAlLMe4-=*^;|GWX`mu}!_np`NO&r*3M| zo5dfvy~!86*81LjG?U(l^>WHoJ#aG9cdXPC%e@IYXZNCc=k^_(*y1CR(XKh7z8gPg#0HfcnUS__t62Bmcd@Wc`p;8T(z@YGv>C1-EF znBrrX(kR&PTY9u-KvnlPj@pv3GDKlfnLuH$ddUS$HMdEPrzZLK?0>WuT%kY88cUG( ztQi=`OOSW#4``UO20ct3OJsmqH^M?C7&8Rsbpyl#6UEnn0)EIe1fjrye46Fiu|My~ zK8xx5MKLAivH$pN8)3DiJvSOGPfXgselLi$vB$-)u#sbB6n7)<#cqERi-8WwqYNPw@Y%~wB<(H*Lam*eM`YM7r{>#NnoZ5| z4>e8AuoM3`Q!_6oZE8k6lX+^U{7z3z|Ce_^HFe}mOwGn+E^J3+DYQ!*k@9FRPB}KQ zZf+9b;BJ9z%sI?eJZsb{!KHW``v5i~WeV>(p^K+}kcPIS7Heo*@-4D(amjc$=Rxkg zTOa#oN>#y;5V|iT@|W58kjYE$q$zTqxoH z03qo48CWy-2Zo4{DHmeFQmi1_vLRef8YC#Wsdi^cm2t*A-mk5p>EL&Km*4J zPkA@oUI9V5Tdvn%p5x2D4FE8^pfIn66Xm^G|K>R6!2h(_r;ergd*4s}%P_w$T&HL8 z`sep;7XQ!Sv*Cqb5_~52_pR49+uudc{Q~DN!+O_@(d&KNvn}`2lkS&MeECK0r`jj} zf3TmfxJJ+K!O!g5EdHPDrwrV3hwGG`*Iv`5{YpPwF_O#8D?^5Bua)p3x_gRh{%?rp zuH&cd9ev6$e|7jf*|*&?P&l6bM1K;ReHETX&EK)~?-w(Fu8`@lrx7yk{hF5UxA}4< zg^FK$>WXIgeB{4>f%`YLzgtH)>+ipx`UUpaUGEeB^9xz;4EUwPRllJ95l*oU%pc{h z@4Xx;8hb2y;+MO=!KZ#9>zje!S$dhK$JXP&!1;6GG2X6>+)n#<|BFt^< zvG}n=TtV4B5t?T4qxKWMamD33{?%q*Xw3e@=b{C?na=DRLEdludC6P(uxL$1YH6?d zXB&@x-Iv~t*`NHD3csu_KuZUIO9x9UUy=8H>EZsB2gnw{CtZc(wmUN1p8@!W|*vlF5Rce5;-0Ky`TE$;*WPHBXNwmS3$~V?hEwo z*Zm=4N*S%zJ=lMKdfzb1{+H*tcF8A(yY17Ky?1}DXDm2V$9{cb_Xqc>OZ$yJCDh$#{KES4%-{EIqwP2Nas7fM!$XJ9cbRfITQ~OT^B}iG z_Vyr~8qah8;M0)0X-QzMOlr}?ae1*1ef__YN9mgfzrS;zNalXq51~22t$8X+_IjS6 z7|QxoTb|k%)DnaG#r=oR66X45@2W{+*jv2J4S6@OQoTc|L^@Ry51U!YVa^AU68R3W@DRtj#sw7(zFn_LS*cUcnztrKHU*GgMF~8pTKJEYg zZpJDan9r@QDTh7nOZX^jg3au$)NVD2TEF+2z5ULwR6Q)NKGEXYZ7K#-J}hpy_oaVk zEV$Ax{$n?eRr^|%V7L9hKA}0%FAvc?Fh^;FGjer4jqa1MBt(V#jsJGf2TA(&XrP%; z@q($pDEgK-BY-!$Ht6e)t^Ud$4)@8goo zdw%O9zx6H_Z&&p4$2{h1vibN6NeFI&$Pn(`m~u!vEZrj9PwU6kU;iwf!xIYNt281; z1l&F9bwMvIbPwXL=nj8)JCT#8F&>^e8j&Zk(I0wM_xlLM=xbb!|FA(4XjOT)CKA&2 zEZmLK9W48BzcDjWw`rB(Ij?Nk^Ijr9niM)m`#gU@RyP(LmUOS_m*{_r*oI3m$;>Yh z?Ht>nJ4m(y5?Thl>H9Rc%l1pxm}gA`u4F@G*+u z4OiPw@uR)$zgZwdO7t2HpC|Gu-XHRLz*Sf_KStyo@&qM}MYtzq!cQ2U+UPyh;I*F* zU{WVG#A~=E;wEAbe9twQ5?}dyOo^ADC-tc6%-HY|zR;b=Gir6EprS-f$KR=ydD0o& zaI1fn8zbK|h+bQ~O zx_;}S-(+$D)0Ow_S%&m~s9O8;3JB;DC4%~>_U z*x&*`k>mqbd0~OX661E;6Ypo^v8S`NmhpS-mwf+>@7SJ4rZG4fWLyoBIcgA_!aAR< zD+`NzLp^2K3HB}^sdhkLf-bg^D?^wM7GQt&&A-I{YycbI%(nmj{06Bm(pAaoAg!_M#QVFHKGsQVe#n`&kiqB!~#Dk)jP-jk?#1X9x3x|7q{!CYI~wYfU~RtG-GN*$g&aC4!Uu7QgZ)3qMTTl z4Z}cEc5o8;U^cGya`ZU52Jul}!xEHR`s{8%J31H>)w4*@z@;IOtM88vlUeEDC)~WB zaPvXqtamciHPtFwts%zpHokGCqju0>-`WbbYR*+LxpfJ&UiVLI@LaBi~ z(4G)K_NEh)-7=yZrCf}15_fQDff}G>Q}2HLE~R-dox#nNQj+|!K?IGwsBdZI9O<;~ zv&KBKNHMj)0RxR#J=&zOYw6B7S?ND5D|{U z-9>uoHOHZMQFeh;2SIr%d4}nd0Nw;V^79_WQLP z#2uACHVQNS8hh;x+~_I!%!qVhrWtK-Gak(6`mk)wML$BRC*Z0~3&1GVD&fC}_CC4uC?1WFU_nhgem95Bh)tpvj zTK{DZV9tHa8a-8@|6OrwFD-80+N>*no88*1pO0*H)_MI~opnp7)meYnrekaSx`CbE z%E`L$(^h9a{`gie!OfmlXFd9>R(If!2erD^Bj&VvvVQ!e)mayvfdkXl0pWWSRMt$} zYh!mcj7*<;9hk#yT6L>f1-g~{#PL&Ce-EP2oPLV)L^@(Wbsd=XSwYfGM|Qo)TEaAQS|_&Q@RZYf zPk6GFTm+((kS*a+sspgoL<(ny+{rGCGYr+!3&JLKB6PWtKARa+gmW|Cv7|2b5^L|!JI`N$%ZwL zcYebcUS$O1{rr?{6DV0_gda;O;^rNfp0};aduw{$!RdM1sl0*oyuV7%o2Bv=r012; z(=GbjUgiA}{a#{-Zhz;e=k1{KitnWsdH<50H(TX>C_V3u>3MTh-ka0&_D|2-QRN+& zp0`_i-cBm7+%s&^-)~s!7W2?q3MTiUc{ZADh(Cxl---2^#GMsom0u~~WCBixD&LI{$r8^bOXQ`O$WtX&0p-aOwz%WYtNLdTYhwFHKLC(Ljh}X{TM=PbGw(Gn3EdcVLps0r|?M~2ySD5iNo4# zkLT(qUwUS=95MdoC25i7DxOk;f?$yZyM2a_)g3hGrSY7_i2a$ zUZw6O8~I1nmR*N1Ct$5dmuCj73Bz!;C#$dIo`-|skl0=4JT3105D`QRrFl5`vfsF( z(M5c5?(9iwV_k9pbZcx!;)xZ1>hz}n#;fhljGN2C+kQK~yLep;(Rj#X8jrqZOrFks zv|G}zp`= zJ1^32)#Tt?iGF)tzx_(TP1kQb7O8SFC(Y%Z4GDSYSEI#&OGN_?WVhm2O(a&??v8OD zW4RGbn{QBD{z6cFvv?b1^+4nPYJR-Nv>J&mc2L2>3b|C+OXR=BBD&%J?`^_21ef3| z0$*2lr$t=1jqy6OX>*m-R9sE}doD~JTU-5BO>=x(Tc^IcW2@6|)AhH1>$hEx4F|Hy zxh3K@nO0bb74&hX9Ld-tB5klA$Dc3K-h595;PHFqSx&*3zhp;6mfzY@---F?oxmWj z{7or;xXH~KobkTcyP2r!s#_6N-N+|;KUnv0iSBQaeyi4Ro%EYKvhQluIH&7xi}l-X zM`j;4YL^QqBeV}0(uVMFz^IZ~m$>oE-`gw_Yb7V1&!c}%Vl@EhQS3=}FESCCu7O%0 zC4AC2 z$c#s)lPKQ4iprMMpU?8#d-M^aM9|4uWA&SqbXK$X-*`6<25&}ga`PsnTIIOsb;TsP zFQ25L{dczj?K1^M@h98XoiZcRnZY~lWKOKl>z`|Z(%XU3jqnh}rYUH>fay@g!iW^{ zrA3h}Rpg-NMZQB8=oZ;57_B*tX|IZ`;X_I*vy(;Urx)p3oAAToQWGx?3hW}c!$b$4D zomG(+n-{4}7P&9INUka}v3Zf<$s(7h7db!`2{bQqWU|Qd=|v1xYlHd&xUpJ(ZW|J3EPsD-x`U!hPpu6~C5BH@fM!YTD!5CY^`89EiK3+NwdsGmrq^XCiu}Hdoty9ejq!yss63WLRTU0;TgN?(KvM)Rs;3 z+9%^L%Nazk{BzI^${(BnEK6NkUwLr`vf%zXtcv`Fpd>wnw1j^~Q#yx~BnI`($WjrZ zoh@WY@@k`D&qgS|0Jr{5K+z>(Ci$bbGJ<$5K-8OT+R(m8{KszF}W zWt>7gc?~oRA*;AuIK}=axSZl6--F>_?#V!{_v~%QlWH|MRU`r$kImc-Xo&Out1e>M z!e^q|{+8hab)!uzAnB4g{HHgiqInjFMEE0ed{i2UmyJkp@m3dc?t*Cp9Ir3Wp7Awu z_Ab(JLT675R;fzM;YDxX{Yk0078Q?>PHo3xM7N+{!fB7@k`gX`)thDFFVG`&%~`OX zS%IaxoLTvSHir?DFA0G2Z2$Cj9vMjVP-+Hzg!meHTIJIvI6~B*nkRQ|LlRzvy1YSo zrJVL}GD0q8vj$m8zcu_|Kkj^k*6{40#ipw)%XbFTcmSa*an~iDitcI4cq*gDi}B4# z3j=z*m`}(cjVW8cP-`($d`+cEvb6aFAA+S4abWpywf9G-D*lsuziE?1Uj0s{S$9NK z4o|3e&1j|zn4Hx`UJw0u#_3`*R>1Z;rb)Ii(==Uv+-Xu=F~w9CKlR`lnTD6ZLO)%g&_f`0IjWxvaRhr|e$}9Yfw4h72U=wf z{1)=NQ6q`AN|n6SF<2iJRHFwE0qYCDwFr&<|*$Zu_Qek3$oXBXLQ&bgMMSVmBpp-qS1`0?6IOKVZrjRlvgtE2YUx#cUp1Zb` z$-8w3ljodF?{J;yb-D^P&Xp$l3;AXi@MD%V7?Ixfjg3QN{W>_$<8)XVa@_Z&%ttM{ z#XOFaPz>s51egKJ)86zrD?2-bfO1;E&CnacSN+&IxR_UEh|FfNU2+7#`@i-j_ z`u@DPQmM!*m4;mTxBE|GrHWX_7rd2m(MDIsMT0Ku_VhWjZtopg?0F+~-8NOa>-J23 z^K~oH>qeBA`0&!*uUqlA$#r{E2gGQxZVjxD5eXsf-19gkuS|$l3egfU<(pSH0v=^ano`-MBIN9hHLWB*~shR_}`$6*QaX!I4s)>}!#cq?OPcg4N^>u(iU>` zP&;0!doH3h?vZK2>$c~T2Gv-(YD^1+W3LE{qQm5DQ{v=AEADsYU+#JG7)9~vlGQb< zksz{DkTy~jE0eXI-0pra4{>FNq&wiT*Pgh!(fLTyW39n8;N()f%X0{BF2Z4;7~$o8 zq>b>h`Neo_FHF;}yd40*2v4jP{``4YWdrah8B9Fuxwn!wc)#KqarV`Bq}t$(aRBE! zAX&N+{ZMyh0>69Lm5=_YyCU3UX|~-rqAUWV?FePT3b!znbFRXZc-rn0Tp99rWA7?+ z9(PYB$kKsCPfAE>SS+=?nkXQT=0vfFZNq256bkEKBs;em6%(j+88v4;2S4%C`(HTA zs`%gdB1Sk-(Np*;&*|$tARK2b>vGVc7+Fk!Ca4Yn28SfkHBRBE%ZYcE$iKq#^8+_F z^!0lQXsfnHS@D`c36XH8y;(lWjGvuv-}IQWxltH1CSeE8&$B&E%9A(OS;qWtHpvH!kRl7Nvd~hY5AnO^sR%R(dHAT;Ep(7ApnY zydcvS$5>js$rm=kC>p}dwJ^*T ziuqSE1A756ot&#Bp&5aX)Ep&^pSlH4Q0a`j%h`%>`S2lv!>IloaM&Ohhh6C6FbU&# zt5g&d_H%fF=!7)3gwP8=>U=A#1)(X_ERdlYGZ579P^{f69PZj= zXUX{;JyDJ^Voz;Eb}rUvZZp4Z(fbGjEhePXpneV!+_kZF9mi26M4!t;(^BNlec@2g zY$WX-`<*w%F09%NpRuhw$1@{R!Pwl4f{9-rC~@AhKIfw>Y4k*Rgp_)Eb3D0i4aj%M zQL?I8bKHE9)0(PbM-(c_gKe4jA;92;rkeRUD$E!~1!?nfk zIX!F5H3;+~FEbq1+_0=vvl~Hpr{_Lj*XZ0MloCZ={>LoTcnt)7h22c-R;PsXVr^7t zUnb7r;=aO$q;m$F*u#k`niN61;|zW;V^y5NB?(661NzN0$&~00cc^!R zzde}k{cn|U5EBxj)2^X@0^g^in)BPF!rPTpEQ@byB}QAK0ZW7x^gPYw~RW zSEoyZ3Mq9>>E}IsbG$l10b2?N?-iX+ai<4h5U{ewcPaKbZ}XhoVV}%9L?4drBj+V{ z>P2J&$ch<5%1-U-Q#5eU@y%>W7XS&ExlS4Q}8%a}>92z+AXw3Wx z2an=LXN(FzlKZD;68PewnnW*V<*8oGpp+nr2TE1*kCCdHZxqfxp8L=Vw0n`X+lzL= z5HUAHq)O&0mI5IPEu0XL7~R?`+lYQ4l{6i}Fsx>>63gG09y+Ua!tSs_lB|uA76pm@ z>l5i)lB|7mBrqOVi5hgoZhobG?*u};?TWP$y5!2)=cq|aR@dt?+;yKR)wxia3PF>Y z=9KC0oS5+Ib-D{d3bN$cK9}?WcOx3%dbEYO0&*o^+F*b8bG_^bHFaJ3LshOsWZATX z<#6G#|8}Xw00TWf3dRA-4mN9Gpm4nfs!Q^ot!=#aeTAj{yj*)jQTfyRhOZgK`0w5 zYtqg1c}eMJIJvs_6Q+o0Dpod(sLXz2_SXJfIBBPpC4OVTLe6(>D?lm<0XGENs|fUU zD;SQLVVtKVTQ&AvqJ{xe6&zu6hb=uEeEA!wOY=J_LGt>gFIw_M*SM-;>gy*-9Y?Ly zIFlupKg{42RjC+b#$Hh{!3ACcU+d;3IrnD}61kt1Jc^5){--YmB5+Gh@MaPFiREH6 zCUpyU@VGq0dYkbc%RiJe&IbFZn+a&}Pll?X?cq`M9 zWBaPeOp?8^$6+IoeU0XmJF6n_12pYx{>n|1*P)JLhwRRyx{YEx66!WR^|p+um695} zrNHDQ8$FG>-DV!-r0QNS`8$tVM46EBGYcZ6Y*Q;8R=l<;cR19ol4o>oZk4QKR0*!s zequY5mc|Im$c^Ze(pJ@|0ndBoTFJY-RYoOBW2Fih=Mp%0cH8d#>0Ysu(a9ncO($S* z`qBf=Ei%^$mO1uQva3e)u9Tu2Rw9l1-K9@P#G_@L3W6H5;h^Cg$&x@N@Xa!mS~V1x zdTO9|PfJ18(%M=t7fzzT`#>f%XxmSn2BNu~xAbNFW5#9V-d2XZf0fkuBL#FI({&O5 zOu$F}Ci=Y#ix&aNZPeD3-FK-Bv)K_WI!lHXFVpu$5}<%M$o}?Rxi!LufX$Ab<8Fv` zQh^*%+A~4+jA=y6))zzAqcZ7)b<{!`cQ%9|IQI9;;olZ#9L%}zWg6n>jHwIWk%7zA z49D(A)7Y{k?qvi^*ncHo8j+A%CApU|0qOTP7p6~|4};sE4gF8)zue3iAqE>ww^aga zx%F+8Ql4);GkH_x+e|lAj*$Y~RB^Yc+f3a&Skobl)Bb#DTO@XSR_acx;aZ32)V`); zRf?~on0upR3uz)uC}v_2Hf#`_F$In?9ejploG&9|>MaUCCpKPs z6Z0}wHYH0^uM>VjU&lhHFe|bjmS)DO;G^tFOeGwCOA>5uB&w6Y|QWTcQ zGorAO2yc*&xYtoH`4Ce4y4XF$QWch<51}7H%U9sH&P8vTc2)0gi| zUMlVCV~wkA-;Fl&zKgXs)0lDvGGoLbTe%;bE(SqEFYE!zOWQuMMC2g5RUw~-D9Y`F zGmbMnw5K7*r9INw#vcDfN93$W7%?y=ioxKLzX{04?#*kirE6^ z*(Hh45<SY5evt%P6f0?@YiKarrK)W&XoFL#?<TWRSTLt+FWSwn1r(gHjNX(mbAak||@=j}Td&bTg8M{%KF|{OP z>Ny!xugaKuYsS<#siHS*t(oP3Jsn!;+|cmfn6e(L*w z$u#^XQKN0YbgFEzgqe-(7{v}IEN*tKRgYXxYl$s|X@a1QGHVDsYXCc|V-v0zB4|Sx z3qLV<{MLDFvjGLpU=|AzOnEm2vnNoMz-%GEt~KYuJaXuN3IK=4kjgnpm7=7f4ig13 zxJx1*drg4VmBQ#7-TEr9<})8bP2=jo7w{;Q{=B$Q`WmeUFG0d;k1iHn>g22zy3~K) z=;~7cK&Dh3c&aXS4?6I*?<94px8-EgfeSN@&X{_`$Y7n>=Z7MqiAy`?R=8#+g_G4hGw&36M&*AD`y%06Jw~;eF7uv4sbnke_ua|7Hz`2~=RUdF zrG($nf2m%(GH>Ys`WZhGswzouW;wA{!tBM~hAF#LiBU2jn|mpq(7k?-{<%r#THYnR z9VTuQz$L=}@Ay>;*fj!e3Etdx+F(flFwEs*MLKhnLft<&QGj7kfm>7~ZDq3S+)A?? z2X#jDNRq&t&M zXhhByT|;v`-GpjXX^m<$;!>za$~B>yU&9;O#~vp8_A5MR6y20x*`l32Zp9Bk ztSKjeytyp31gmYX^093+S;iv8vR>TQTZ4b0j4Yme<)0I>@|&@xLa}x)85sCZ z(XGJM-B3h_V_CN+ihZYaF1h1+z}%g*h!z_Ky@%`a%^O#s{Qk*BJ7vY25e%SgUx1cM zwKO!}-ic*G(>xCaMPHO>-;mW@;l2TEEfXt9>x*ZlZ7u3s-77h9M)WeOEUWz5e`76e z*45vah9m74$?wXG5~$Z*0#gWj+7ieLmXB-Y66odjiG<4eA7;Ec(M?&CJ6>moJ{L6G zObzwHPkK$_XQ?$gX{);?OPSo-=z1UsSzm75)Wp(!AXZG_GqT9X(ma-uixpaUtXd&w zi(ARvDWBuHZ*^m#qIGoRLg_{`1}8F8E#|4~<9pb@J&u$8yBkA*o1`KP0bCxr37KD@ zDU9AJO5-@zFB->-$ls)KOhx66T~dS8>R`pMD${|~Dm5=9960Q^aNpTZv_^2lZVU** zTX8vbH0>!1f@f7nwQ#zwg&l$VCX}IA>Qt%$jbLxdLE&i^>O+btra+$U3KkF?2Eomk(owLq{pq~Rut-SxfOY~=l?9rlF&yc zwKV_L>1tWTXhd5GXuZrmd~^ON(`02uHvv;(J*T?KmZXbP$Sz!;(#2?wn$)aOl3V6) znG*iwzKd%qEu84_go58Q$iU*`tzMxP<7frAy%NP9)Wz~~@?tMv0K^KQLmR}DMxz7~ zooiE?M|(7x(%@SbM7A4K8aZNhBLsNH&3&(+`GlRgz7Fsh6*ix7I?+rHGEICixN?w# zA6IgaHi#y)9HeqSU3b(Nvo83tcXC6kNlc=*#B#4#mok?sHg)sH>2@k}DmbTBCOn?o zeu2nvvQFk_c9E?29GZ3)OEX6H?N>A@1)C9H#eB3J_Y6_N#s&LiF!8%DUl^%$rpBvg z>wjV5S0Ga(!faC>)UJFNv%ID)BOUPA_m{%dydvqcxi!n7`3BvT(_f@SDVy{PDKLJH z6i8Qi&*q9G=?ZVV8$_P%f9dq5jj)zP8dETS7vG%sCBe#y{E)s8LekCSPfAe$NB%_a z-7cQHmdOK#+p^l4s?|KzBYh@V-xKDiKYBCfz)a3TLcK?2O&!1Ub;+eW{w~r6=l3ch z>(dSHo-CtlNz(FbWS)9!{_$UGYraT6wx-mV$OUQnJsp7f|2a{Kz+vJu8rWPm>Txx2 z&fFc@Gh$>ArE0k&*HMi^6bl8-r>tRaJMiR73ioRvg|}yn)0uad1i&Sj+0JBD zi;HkI^ekvgMdOn)S*#qAQ~b;pIaaoBsiSr$STrYPU$7iL4_PoSynloHnn3>5oS!2*AVo5xBjQY>p;l= z2~k7U!@{_vR4v8=s?+_btn%Tc>dtG17xYSX#yNl2{&|!2hvq2MRB^BZB<_dw0(VrL zU;;n()&0I{tnaB$WZ;w*wW};IcsGOH6hTkRup58!sqL%tUd6EqEpvHyt#0;Kbf<-_ z_LryA3Gt=9)gDM=_og>?Nj^_>_{|ky*?8C@i&LGI8LQ+ zquu%c-&Orry7eDI{pk?XI(XJpdBh=mxgN5gVt2O5(0r@#4~V7IzWukErn+_I!xI{` z5%gBHljnV>=ey&ndpjSY2@^dPM}iCm$9u{XTzWH7JD_17;H_DI|Fur{_u@W#+uy{V z{A>PRu3rXm@ReALr$bXK;WGoD+I8RROE3>jly@E^xw&v6!)|IdeHRKInxpuHijy;u ztMh5D@?pi0w4}kiNS0^{0b*GhcXTx9&OwJ!am{&WazRexQc^sim^ay^9qc)Mcn`4@c}bWhCo6&Gi$ zsrB@L`AOktCa=-+bJ_{}IzPAO?dAN4ZXYzH>67_QCP>{KKFfq}+GMO{@A-=tziw$l zmPU(OP4DQhaQ_+31FtU2L|yiD9;i|nJEU%dd&-5sNJDQM*9v0)PFiibsdka9z^Qff z6`CUzd&-**Z#Nx~5fG@db@Z(ne6C)l;q&iBdkvqi&MMVU+TCug12fh-W>557omZ3m z(3z^XCVuGqUYWYudiaRrF0X#OHv_tA-Fd}5zb5$}Kzp>MeFf(tJie!e+rT_x%>Qq!7RSV`iLc)N}P6c~MjMGMRGahIHj`L$$uOHQI zprp0fls=RJ|U+8pv#azf&T(kzPI|@f|g`Gx1{raAS@jFj}__bapFj%xYXnmz- z>uhtju

        AZ+#!IJ|7b6lizIif>ynMPI3a*2d&T59O784BXj7Nwcinl(OR%%{8&$4dpyL9Bg%NGi8VIF+0I@$&&bAk>TMEogmgyxKW0yp0|6GIJK*cA^or zX_7!mZG1Dl&J$`PS)Yg0ZcC{qJny?QY0DW<)j2z~tv3eJROkkS$MmirrPf+aO$ zzmo7`k*frria#}Dfx^+aLO!^6g~37wN-ixNQSrUN-3a+KB2e_PZ)P`!h80+cTOgZc z9}??)uzyx!C;GjM%()3bGQAu8Ig5f($B3Mz8rU2-ovMuR4(UhS` z_@!Drh>rR~HA~KpA1VN~2!I+nB!1|bLGisVMaSX9d|Sl_{AWa8p%T;D87TU~ELtBZ zde3=~nZW!zM{XX+d&KXNE!SXfdF+Q_Oz+L7n(hU<0u2?QNA(ZJ$Se<>x^s|JWIbIdH&YYS8?@FXXP8T30qY0*l%Tj)9w->^g2KK)T6w4N z9fd@AvMytt^kXGq`+yp-pjorBkJ*Xbsso|d3qw@zDbF5be4jOvF362nKkSA?Q^;LT5`kx=*GiUk76B zf2m(kRRYTx;q!k&sdNwjvC-KK$yph985_rMEeELc0TsOTk3ZHw2}1%;-q3jG$AFq4 zxUviwfmH$PW3#cwZ@nD=&X<6Y{3Xki^_2GrSgXw~pRitjW8nLy_e19&G>5a>s)!-ZVv0$bA7MSsu3;!xBNPM@LCTjs%Onb|DtUd01jL7@>638_#QaGJ_JltLQyn5&| zG;fU2rGxW>8q24lZ72DRsq=@%`yCt<$~1u+rhe~y5C~g9A@}GFlB9R(Qa_%n1*6uD z{mMCybaOTvN&Z64-*BMnk6*}j$qn}NL+C~covr9t0t_0F`v8j9O34?DZZ6OE8*{!e z!yEept<1^t)lwvPFdllXrDl!OKfJ-K5-%t$y}tH_^V)i9w&r<1E?St?Cn6KVIGx{6 zpMTO$Sw&-VCkE!9dG^S=`hNK4@B6UH{99J)sydnB+IHk?TnX4%?~VV;SMktV>=^HYHJV^Z=0JwN7gvFVk! z1c>^*?-6|s=-iq;{%_{#<%Pq>{hC|88Gfw4NnNL0f}m}XZEZxHoHK|PIJHl?|Wb!Lno=S$K+nAw4N zJJtVl;(dJnS&4lf02lRKnD~5k?h76n6ut>Inn^$HnyxXYre%BA9J|%DhiMP zR;HzImM0{;FH$JSz%h0F0)s-c7RhI!S=owa)dWfym(VPJimT;nk8QO(s;-@U~sRj`;aYc!kAGFH@rX!!(Pb(H&&04CFjYQu_PG% zl+81*yo9#P`}k%u63;o_hZYEV_8Irj^Qj1jWtGbl)l+6%XMcQz*Iz zS`uE_pDQ=ZS8e_zXf3yv`j^)Sb3T@o)iR`M)lL>woAHO51|{Wn&rR!NJF>>(nFN=! zc_NpV;%)gh(;E^T2Kgyk65d)mtCV3F0fi$=&E`5BTQO**HEX>zQ^WG7P>;--(z@%LN^{xFT%&Z!84d~@F=!$70#2fr~8 zqOu56*4NeSo0c)AZi<`$yfT-*Ei1SxtZ1j*u1rs>)rIjCZ7zfO{7KA)2UB^b5kgmi$_648>Q@53;>>B5+yRQ`5&%E)WtbTsxiyKl*pWYKr1TX{ z`Qv|1;;m)UMW!1vxm{$&wS0ze{MN5RtSBmMJhwdHl@$YbEz%t0 zQaTRqs>o&*e)fmI$HVdc)e3bL`X{}q@z{>+u?K-7=xdoA)6QXm>)X@qfTdB`F!gbZ zi-X4d%+r}8BYX>sszz4T{WK;}V=zl$u+A<98=s276aoxdTgJXYO&Wt8haI)TV4~Gw zjaT?;zG^)No1YPb9cZ)ygDn#B-vWc(oxosqKByHtymDJJ3>J(J6ATu#mW*Adahy+W z89CBMJ_9vrZ1(2^1QhSijLiU7kzG8ia9V05swRal?&n+m+@Q7IxkE4{+QhRJ@+)MA z;Ss(KvmUhGh7veAq#yz5HL&u6!UDflV_!KKNk~_2-3mh3I0c08r|rPgOflD|=ppc} zOma0x=&h3u_i$ib;;UJychMqEG4w|AF7$(l!b^o>B)1TbOj0Puq6EeGFxQ>$yBADn z)-q5GTupx}1f#DIj8mEuj3#>FOQjbJ$8`=8`o~`aU0pbKxx~OZ8U{yC@HI3Dxp+rf z8`G%ClGC2ghIIp@^=>z=xm0Yrg;?D7z9R6np!iM$ ztwobo2_*Q$k2x`ows|N#{#U*lrxSq(y!zdkTI0*E@f9rM*uOO3g^`ex$*I10yX-7| zJp?B3jGa_-%Yh26)Uib92!|f$Q3hl#|JIzTs6?aTF?%klUvp0E?gdRVUqS~H)bO0x z)CD0u0wZ!9A9hC#pZ6*fzlBXPAl~^+h9KN>9+Zo4QHmLOy|V;sgI4;tmalQ%lQhM$ zb_$UQ3NDptFlQzEw$$kWyAQ`CB*T`&#F2>|kI^dJkX+RcSP=!-2~hKeca{>5jxR!! zWL(A!h&o_WTs@{_DgE)y6!z9<45$`#I*I25fu3;wY$49-$U3lSUU++gI=>~S?^6Hr zb;ZkkleP+Z#*wXQ40uc7g?=EIAE<_djW8S0FL+jq=zPYLS%Z+blQbn*G?7R28j3Y@ z;BJsbc7De{sYZHfLO9JW9|z*y--nYGrp>HbP0A<2vsMR6J~kpjrYKPIi4hsd!`ZPu z2NzeLeR`imWM~Wuxx-eDQp=rV`0A@!-(K-VQZ@3&_TqRcB8+=@=b6ToXLw+P{Af<9 zna-o28o3J9gri6_pR`}PD&m$X}dtJanB&|D{N3I9H{zA zowZy!3-9c2Og>6LC!V|fPMjs3IW^CtSSaTiIra;eIg(zQ$G@)SQALZ*S-ssqbw)A6 zjU8^e)*t6OYPfFe*(II1v$C|@5i%Ez11LmhprT zZ6iOr`E6i({pn3Q!l$pLKY;aU_egOOD zI#1^};H?(6BD_R!yh=ehKvcj*6)O^3K=y-sDtJIaIhaa!JPpUo;37u>4(b||Mlc)+ z1Kz3cxTk{Z#3nIjAW%Jy`U3Hh-m=P?AlRt{1o-jT_ndAdt9c5k-K5Cg1FQwK>r`e( zO};ma2gRQiZ8K*lXI=yj2t$p#Hj*ml?>P?Mx8)HL}T0HtYLO0v5x%M00(AhPe zpjLuYLRsLRt^4R*lybIKDSiZ7!IFklPO0f^EitWB=XZIw-b+qN_)<8fC7M&Zg2mIE z(qI{#%PFPpS*L`2`?@SgN<-tv?{P^w&{nIKWL(#@ZLmz^Ms+qh0tRDDc>9^gRc6VDSQS#g*MMK}z9Pir7ZIfd$N>THKDy3m_=xq>^)n4o-|+(`-Q$7t<3n-g&{gQW}q=KIvt8V z#+W$gUj6$@NGNz+^j3Z#kTAOO>v)7rhqfPSM7L8c5W6Iv1$&VH5oQdRbVGktvvX#^> zdJA7+KmA2ZjLGZex#Vk@ejfbZk9;qCeVgAzw6{&(8*2mB_`IN1TNYVkMEZ1R2s7!a z{DqRbAmxOFg$P);AhpRss?ijOCXwh5fWhsL`<<_mvq42>6FNKqp2&NsqKAUjQE2&E{Q zhoxsG1}~W(&5-%1^vpzeB=ap9GH=GzqeVA}>qusQhRlo7GZWE~%!g*k{7`ykVmXpo z*s_)bl&C>1x&bOB^Slh12c%~vej}NuWystkJu{IT$$VXg%r{OVs+Ko7$zUp&q2PObXJ>K^d9V; z8i0H8)xz48^$l3P#~3%2@!!PgFeVWMI+`CrFSXI@ctW!`zniG|LnMVji?66`)(ULV zWc-A%QS=F$3xaR2Fv3rgk8d)G#Nckj>@Q*VPh*9q4$%~XT<#5{hQK#w_T zJMMc3NVg`37jd|H0uLx(MUCNx<38#x75i4^NyWaEX#%;4w-Kq#zN$d%MOHYUK!!|f zev44tcN2 zCVvwH-p&5kbRG%w_=?P6u=ooEEtpKT#rWq7j<^*=-O-yfrK9{2^R^lfDndssh+q?) zk>sdF25vP8X-F1;_+zqhTb>hxD+*Y1WX=5HpAZ#!yFwHyKNJaZEp`;*PFTamJUhZA za{~LyD?ao_@RMRO6^qNX`LT?M9!nK|B}$UMF%hWWtREZ^5}8fOs&75WnWWclFP%}6 zu`b$IkwP-mmGzcULbo9DgY(SBYSS8=7x;g~y$g6$)zvpX6DAmxa3)+dDr!*Fq!tZc zDiM$jBya|21Zq)gMe&AMtx!n-t;pbHAcx~Ys$yv?l~0RBU$L|n1Qbm`6F?LY%SF5d zujd#q0Tcov^ZkBnpP9)d0iyr+d;WQz%sFRY*Is+=wbx#I?X_XD82uLWQpmcs550-6 z@|>gS8Um(SxJ4ir<`qX^g${8t1vgZ`H(ZL&Lo#m3vDn z#V?e!6&EeS?E-OckDyEyl_q=kYU5*UG#nz3FgUP0NQ3){{Cvcwb!Xss6_~FA3&MFw z2RGTK#pZCgUYk*gR6Y~1^YSVmPJ&qgTRw;C& zUj6~8!ra_J>*#0~@C?`UL=q->f6yxS!ceOnYJ@KEQ&2wSW*>ZuYcsdw19}@Rx)CoB z`@3go%gQn`sz39WbogNU;qp80L}OlHBIBAS#H1U8;8Os69=fLMh!(e7&{K_WPr(wZ z3LwXd0Ve$Rpto>KHH;x32A1Fq5CKEr76T?82m0^Q{xikjFp zz)Onw4!R_7SDgb-1g3DbVA5PqTV@eG=GK^Co@*ozdn zBGH-@1&#&23$`X10nxq5SM77R3KK(TE*_u8I=9n z3$A4|o8hzvXhO@605+lJ$!Gy+d1*eLN1*5F^k3-GGn@`IA!l5#kw(oSl-iP->qyO; z65tuJDnUa`@M^@?^2=CCaSlm@3Zjke!1mlu)+%}sk7i6#7&0N@OA0a6EM>Zd2xuG( zn=lyaNL1`JEytR|o-~EzpmN7(>LLLnF`8Cu6#@AO7wZ;=*Bx(zFT^4Uf)#TPr$ebj z%NJIq<q_{KTWPBfGr1d7dPmHvl z+}YzuI~6Z2N7~)xw_>ElA-k%P=8mEWM_SDwzc(@3zNQmA8g;I@yCWGq>|mVUR8K7H zm|J3vcpD=6rIWjITQ|Z11{=YrwrCIV7D+L)qkB`**u*u#R}n8s0{`jAIS6$6TBt)~ z5KF1mn<58~pLiBf%d{b53g(C5e%;V>bz>ChQX~iGW`GiizK&JF4?Q@jQHLK$gn{5w z_T6iQJFmbb%)ba`&DKaeIf_EP8_|O&Y7gT=dTdh6t*WTjVs!Wyj)7$z5GQiko0gE~ z!v@HpjY}due)ew~Pxh3-v*>EwQiNiK`#4`gsi@3$2pn-Z2}|&@n>iehR2F6&?GUcRE)fdkRGixhh#;{eQ%NBrXdB{qN8V z&}j!cYthSmL`CMW$5U<86_}J6)ZTGlE0R<~lyIe~ZYSl?4M};YB^f`H(OoIOAyWj= zkhzfD$rYU-ZwL#=w2Z*|aS(p5TzERK8D}tN=FAK5nUHmz9@qo{B@-vQHSbN#WkK<5 z%Jv5Slbsp|30^42Wmq5B?C9s!A)IdePHrNcz&`ybnAKu12Z}q3ph!+3u>R3z@~h94 zU$y9H0O(F>X%ezl(T|{~OUaqZZ08&?TV~5_?UUKQ0oQN6wzoJRq}O&_GTZVaX8Tji zY+1={oMT$AZA{B-9g^9G9x+=%%WTIdvvoOQwmoE<>1{h9ne9D9whrV=Ewgn@W?Oi~ zY!xlDWhb-Ub;NApmf1Qbvt4?`Y$vwNrX{m^j+pI3GSzgHV7V(RHZ8gik*%X-QHyND zvEG$cB2MF^W%EOjTZ_eB5tfBxFth2_sLrt0eHaDBu`?&aCEAOaDP2WYeS!NDG~TH{&3&g8T}-Z7S`M=v{zbyZw-kplc$eqmo9{A% zE#&YI8=rv@C{`&vQa2vVlm!h!kp*mq90bc6G8TPB@&pKZc@7((CQs**F9qBQcY)Cv zn|XTRyD~r49+}r8gf_g!NA?SMW9_Z9aPVtdD5ne#+N=Hs@7`i*zLHgNZEjuM4*NbC z`f{|Ee-QvpXqUshDbWCjd+9K07aQwGkyERzhGJ({=Go7JKjB2u9{VbP;)Y^G@QNFP zfm=Nq>?d9Z%QN=#7=>}bd9a>rNkn(lB?jGZI8*3sA6u#rE1UA@a zmE`iI(}9&;0Zvs2D%$$vF!w`W3tjCVyoqv|7j#0AJcx>9(Idk$SM@~ul1|eH15PnG<8@laU#J)nyL1-o%s>TbwwnQp_j~U= z9p2Q%#igPY)fLHxZbJR7HuQLB8jEfnJ^yp0T-i?W$hl@5DOU%l%aL>4eWYAj&im+B z>IlePpd%n#(Q>ZH#o9#{&P29z7TPWrIhW%zv5{~Hqh3Zt952{N;0l#pFQeH$e^3tC z)BRZ05BAIcLTn8qQ~YK0UlRP~Nk$xvzc>vPZV9CK|%pzE3`ov z)fD%*fiV|HX=Q4zU&Uf9#D12EH8FdI{hO6P>cQ z^;-0Nd?Zv+MSHZ^gCsIzt8*%nml%6_Vzh$WBU-h#p;-H|A2Kk|)Oyy{OW@Ge-SDc3#ij~?nlO*;#9?w|#6rr?2QPaU zS&f3h@Di%9aYkoag9m2pr~(;4Ble{*t`C`u`H2q9!Xs$B7wqvZ&H`d3y>vT37^~e? zGgcdebCwgT@G+r*rfEh@MtY&7(XHp&^3h32Jx#2?+b6M?Dh@s-2FJb#-WiQO)M;8W33*sSNj4ExIsa z01akP?R1W;Yj6{GOeRdrcA?4!+i^e#D@oxYLJ5IcC7C#!GvySLXDJAG8&uXWla5Iz z65G=Y*-|fvQL}}y#Bkjj*g(29t?f)z8S2KLOlY@bxlC34Q6}#7)(fB-6~#X$s|Lyf z#2&|Y9n58uq*KzZF-0!US6`r0tn3?pL(_!JN<3CVN$Rmr{4IFhB2ucAJy1p7k&HZW zJ0f`%dC1t}Oris1jE@0GnX6J3BvW267AbFJF-Y+7X7c-OHoMtZNS z&lEjdVq*YVOOe%?2~@?q{q_@#tv4`jf}v6F(lJ>DmXjCSbN`9YS`o_75WaF~@l{)v z`R?O|o|T38?!C@#-%j{^*|}UuS#v4H1(q|8Xc@**mZJjxMVttJS8%N+neCm|`91Y? zaID5!8W2>&+Ww;fF_J*!AsK*}o}qyFMN=RcMwA(SziTv$|JrLUmA1%HwHN-%^^uNH>T>6!%RdHhz8&iQBsS;lEdu|}nM2M@)Y z-n|hiIx+>w^8H`qBMwHM^e<+HL2pob!~H(y^8>(7F-9adWY#s=kjXmohD=r-C^Abn zWU{#XDb`)Xu;aT+i;A_jIiPn{(0CK;?yeU^4}vNiF;0W=*F(m5f4JyVEgHutkyva4 zpQ+9Kn$g-*TPJpP6QM(p?(X-TPdUJuCbk}LVQaKET=X%NT7aB8vIRI;y!vp+djQ7a z8F2a%Ha;M+dzIDLiCFEkYl~KwJI+nWqWlqJq5H?tr+b>1jlDob6nzJKB)}z0Jrge> zV;_8AguUOt0K>7>FdXCE5=*=&v~oU~RAr3&nUKc#A=YHngzz|#C>)}Vmuaz$$bt-v zjeMU0*hDp;RqW-mF1gi$*-c~%Lo8b=cBZBut>P_|kT&M)F`Rf95f%&F)HK!w_ro0n zPI4^!l?THS+v?{FF7vqyAGEq+gL*ZwfXjf&-*ujKM|%_hS0Q6QMXj3H0Q_Qu5~c-U zkz}w<#`@>m0I)mObxWAE#_N`JfAgKmdr?X=X&U1llIFD1B_Me=6z#3ztnF(4j{JUP&B zORZvo9Ez}EZsAEjrZ!L^4_5vf zGQxTYhm=06?ZV2yNj!Ht))>(Z*du*_!$DZMJ&ntGF9nzT8n-`TwAViyHr`7qFHjT5 zMM5xE^u3S;DV?tXZ7MZiy3Q9Pib6t2ty3`y)78EeF94}d5R_4()=i>weu|XRROjsc z0h24}*n=8F#=Be$ZmEPO#!{<-D9zHgvRQCZhXVjeUV4H5C&T&h;A--Ua8 z3IP;ncotTo7|8f{z1GT-bq?ZWxw-%^gcOgxgSGL#e69+>O0Z}x(YDo<#y%+pdE{ZpBsslQ&j4@scxCl`Yyr8zMAZeIs zn-MbozCpw#2XTUUk_u}C2>+l_HxK%N3d054F+scN!7v#IBx1DN^LnN2Q*fZjJ_V<6 zHS6^BszEkrR`*M_Wox31P4+5Y2U4(C@y0XF_9{AIuYwyE*J-iK6k1rHZcgy)eGALG zq=R9Zb}T-t zzYoDXewEs>=!m5fYUf}5yExi+4^UfvPq^p>avBwGcyUao1*}8 zZVQ<6(qXRg<#u$23AF;>{EH-dMU6_Q8_L8EU;Q_#GqeYIOP7dHm+_^wzBzQB@CWHC za}-vp6a4$6DKKvw$!Xe}Po@oOboutFQEJfpg1Qbf`WOt`d4e{R(2+^kh>i`1D+go$ zKcSZ*+MGoIoX2OZODcYe1?^^zBbOwPfEyn+K%4X@aC5wK5myUG&-NyF9TjDg43I6` zIYim~=-D1?k*$OC`mwX!&>~xwGaK2Kczf@30;-YZkAR4b3+BI2ww#7927-Bbn`m5A z0&i1&3)E!{g*qGh7OvmO#$6@Mz{-vpm7$D;(j^FHjN`tcf+{5As;`C8B?#vsin9zg zN-~-#U0iPB-~tvfH`E}M=bQ>;H|yA)P9A$8nZ~6~NFvU)L>A851ZDZO5f8OE8a)bZ z^BWw+!tzOrMTOw9BP!J&ld1mnE2LV7R83SH!l9{i{%r`6&ml6!m$l*K+QOGZ%sM+Q zcK5I(Prv?Z#7;cyjDt}+D1sQFiRAR=s1p2duV=+C&g`?Qt&>mGy1{} z(ei}xAl4k4CKfbZzkQjKNifPzM>DjTgB=HD{v&b~YL7VMNR?8 z!_}LL3?~}H7*7kk+S3tWOG-C+p{tvebWQb)7L%)t8Iln!$>ZcAqpPG$=1Ax%B}ZBj z%&3Z>j@4CI{ue}N&h3Z*3<%OTw8Of5EzQM4KeB?DGm-NHjAD-Ne|VgG9}^E;mGtB( zf&1XtP@4vSWf(Hj_bHdUR~StM{&=@Tn@)z{Cwmka(8z&b<}QKSzh@zwE{{t)qBMu6 z>HTSkzM@|qrT!PZmGfzqty^Kg9r;-foH_HeEma-)K7gat*LxrC$6{;TMXCKI>U4wJ zQt6LvUt|?4^ORkZ91G!1_B zNL!q2c!R@M7Rvw6`je$6_}9->e=_L*MSYP~ELr#$6?){;OYH4EMdq#|!)n35PKYZ0 zwPrmLA(`3&*iRh4kyTPd87DH%h6#AU%pQ0kjf-3)@U)qq{s`8aw%_q1`9WlrKvWh6 z{FFPJz`uIB3%`xMXQnZ1w6aIG-x-qAe@N`LAIa1#7Xy&vEVmx@6nnc5Y$bP)5#ik({Q@l@HTxMj!215~WPu6_cZ z1q%M&*<+q$mRx$s`3=`=(Zhai#;NQ;^H-NPpwHm;>C(p5Iu1wX7>i@^t@Nrj_(Kre z*V@ePC^TeEs^e|+Dt&G%>4VY3IobmavM#(PFJxY(n*-sP@g_eMzYXEuA0kU||K~2% z^oHB1>XWd^gk1i~Z#yfH4OG#HMV?J3d_l7lwmS!BVIOl7RFLBb=W>Um4n+RaeI)tV z7B;Uo^I3f1jj#V;1YeEpMR)~|E!~74IX{*8H-tb%m;E%J&WF$lhAuiIbP=&)0IH9j zpA&59zLHs`eeB6_4X7K^bAjs5eIf7nx-l98;T4Js2LK`V#AiBtoJ)vrD|_1jbi!+cf+vcO5%bx7)slVRdy9o6!1>CbT{g7E#(rN{p z=>0y1h8xs;K9Vn)L3?c+TrAG&Ma)>)Zy|&p+}F8&_b-VMjPucgJH;&nqn zcD4QP{jFV6@{`Kr^+koY(Q1LM%7^*xdJ~K!6Af!|Gf&!laP{&&9-qhdfdce`*Al)# zV7jp+-cDSA=*C+}Lh(lKf2*y?oPrKS07gMcW@X}KUgBkuyhN*t_5Lim{LNXJ9|8)T z{PvMxPS~XgW-xZC7X`rneCWg2B2-4SU1gDO!i($*b`11M65d|(moC!$;pJKm#%Ru! zx%AF~jMtA|qX>zm*wvSjkec}uQS8gu=cFw!w)k zDGWB7PxHw;UH>Y;;R1{|3|S1cZ9pUT!u*WKH9B~NjIfPi-VidunRO72H3z9f<`h3v zE$R=3wHKCMf~!ifR~K$XVozjRF(%+=5FIkcVx)=EAJ|~MX){IG*Z>ig)+vGbChUdq z4K-W&c;YZ>As+>?B@!4b#uqxF3SU}m2S0F7lu<@$G0Ys83Y@VpRCK8p+a+l=^1DK? zmLXs@usAS=Kb*r#{f3)L?ZTa49>j@xl~6z4|!=y8->8g>tQuLu3n?Ks|OHsy}WY^6rJ1bg<|Hn32C8 zsQ$El*!vy6%AOCJ?IBkjSEk{&omR0NCBc7h{o6q(S8HNVpg_p=f5XEY-$XM)_AZVT z$O!Sz<8cTV_1;2Z|hPW2-s3L3A63T%DF|2(Vy)cpbwhUZR@)QfZR2wJ24DY7(U zjKXF?L<-u3;|l-|jD`hcbp3+Cm_+cwzZW2Os{ZF*eaw%v@SISHL0728#E?ErMyCcC zp7|7>hUB5k%ES_Zow_LLTAZe!|CWNGP-6+ipo0I&Aksj+S6bL`- zmNk#C^o+udhZ$SI%<%fd-ZL#pY59WaW+59KVF($%)ghy7HO!TyY@GIAjZGp_ouoD_ zA#^peoku8SCSf6I1aV3uY!1e5=~^8Y^sL7?V7I@Gn}P!X{X^(KSnx0c-8?W$w@Md* z7!Ve23|XcAAmmHz1D&@UU8-YuyBHxjHg9FVAi`&cUOO-gMS%7O=HY=Z9q7k9CtRTa zaTE*mLkIkArv_~J@Eb)d7Hh%T0&Is6V$ax5j-&=B7_tIJxFC7ta74+dHcH3T#Qv(v zRA^kxF2zO~!hkf6WBc9jI+MeeLURxH3NAVZ2#&B`#m?|W%F^;nCuliB--wWSm{KvB zgDDt z4y6OExdb3&$!)myEHt4xAB4z-P5>3v(*9GOeRp%)E73khlwQS0nrseq;u@Sax%OWlN9uF`?1txnd^LXp`EwX=W^h5x<$N3*=$C#B`!d{{lA*Spu+hVoBhPYq2uBCk zbJ5wMYBV@M1KXRGdCU0JT5ZmMmFRsZ zknFps`C9Evgfv^L?Q{yzF(d}U!{G;$ooT6Yl=(HB`_c7t9!h-j)N_#}`>zwRH+vo+ zwR0ek*K18ydU+Ql1@yMv*Xd3f=)vZfi()ZSfjZcCE%j&l?)rzya5CHkedO)#41KtS z{G{?QuqUv%#H6>r45y~wB2^o;GW)9geBtc0+HbG;5rW%D zzmZie)Kd)m7CUmsZ|GiCXSY5gsjD(~1DrjDS$PvAr7lE@&T zy7bA(!T!hG&fIillpE2!0Z9eJ$iUTCUqjEWRcL8SvryUx;vhsTOg?=x{mV}F;Os!( zZtRM0P)eN@%f8|Vs zIQP!%e7ozNsFXZ`e-Ygp2_-}ZM31M1@5{{RrwT$h?uHC@MV9^5Vot$3mUx|e1-_9G zsi?UaS!fUZXJ^b0<#2s>ehzj@cxh)`2n3i4 z6EGFpkvlwaWdpB8v>DN@sb~&PJ&eq^|M(Bo&E}}XjMAk3f9Z_X`@Zy6U5*mOn^zBk z5n_$0j}e{0Ube*?q08#vGiliF_}kR*e~7+}n~h z)U)EQ^50FkC<~f?U$o(#4r`0GM{AwF&2jOI=LJ;ap)bliCLZ?v2kD7O6No%O98=$` zRh-wB%qx&t;ec4wV&BLj11iN|{1&3zE`AAJG*H4cKps}+)^4B-gYt0Zsc_?)=y=H1 zl%rD;=Di|Y0|-L5z<#0~#CS8@098wQroHWUBC~V>3c@PAbdivqS-xae=EkuQN^+44 z`oQluh)|+c$es=~ozx(kVGt;FVlc*p9=LW87m0vq5a=ZHMz}Y|Yp(McbqEUmy!H=u zcvjpre*B#Y^xx0{x`)>h6IkYTeqahD_9YNd>Y3h$sd3R{ja(b3de!5+!bJ-<2cR9d zv)gg$ce$tROqLEw$W^UVIXx%~vYq`v5)os6dp2dICc@Ll2uSIpg(*b8%u8r`l^F?^%N+p%55kt_$GcTMcd}?K z^IRs-tH>U8I$=JlnG=;xc|X=T1SYW}-^ zO8zEX?)+x?lgt+{Bd-SURqKKDT~d+!HixjR#{EF{bQA%Wik*=1$=D(E3%S;oa@NLh zDP;j1A|T(94UnVP+E+7!Ins}wY5=*f1;;^Ih2?|Dhhk4NImZG&p2CM{3VXlJQ}SKg z>qaL;VoB4Xtkm5lB#Vz{NUHjGQIKCZGk<>*bpP0z!Pe#KvODzJ!C4%rA!9H|_R8E9 z{8*lcpZfo?e?AtE|6uTA*p1AqDIMUo+dWDy)Bijaf@QfnrJ8vEp0?3I*a1S0ed5gAf2C!0uex67vzbQ)MB*9AYpL{S;!i_2)y3z z{e!YZFZ(%YV+k^^#WvG&%u?I69PIrXAgkKaP15Jk9G6`S;@Dn4Y*uCtx-qf+*}uk} zy*?CxvKQapjMIm=gKh*`r9F6A5NNM?5oefWYkoi zZpoinqV%!He(T2cIU$X|rr%FswUHm1kxFPl*X6Y)XSg>%a6o(#(2{!)HPDl2{9?jv{;gUf>p>z2PoD5kpfUOI?NbR z1<7ig-(%eG;qJ58eHOY;x8j&U!iwGS27t@_b?$SM`>b-GOWfxIJbPEc^CWpLcChMm zIscbbR%HJl1W{!>{QzaIvJvpY6Vw)N4jAhLxK%jt60-!id>n{=&*fxsY$ZGmphU4U}bb!+w? z#^Z3CwrnAnJo{!&M+A_48L$*IXN*Ib+PvugI%S`*`3iAj_vp0;O5UxICbPbiIXEfj;EUuz1y8U3+=$a$NtwPOgHes&A=-y9|;;&@@;N+|R!n zvf#1I>NpE_0v+%@N%wBiy>H-d>S=(YQul5j%AJ(V8Wh7l3b`{)odO%iqt+#r3$I0i zG!n-{dw_=~Tw;tZKo#tp2KPA!Fi79K&k636rl$<&xm-Sr-Djcu%yXZ9_vvw;b#A$v z+-H^hT!Lp!jK_i7)x;L#;j4+o@xTQgUiVKoVv?&iww)0;8ZtifpNmh1Ogl~Xbou0I zWIny9j?WYD1h%I~5RO}@apN{yyzH7O7&Q@~r!w{%1Vj$D1G?8DZROnS@Lkp+auDaj z-p4C$!N94U6NY4oqjfFj0j_ZVxtPllh&H&gZWXdY&Nz?(wd*FlYZVzPjgB(6v;N8& z7y=E)&J!=(g(p;$UExUC*Nj4@I@XITF<%Ev(*>r{hy<;@`T)N0{6`c|L{>=T^@zkr zOg?VFhjj1X@S>a3u;Dv<4%!Mvxxgjd)mQ;*%VO;D${7z4zGti4{1nL;LQ*{?(Y*a zCKV%yXh4u2GVU6VPqrAJqww0GUdQ0IQN51CtF2xq0B-h20tSYc10-mB(e1gD$u`W^_!MQGQr?&%D z&T;T}xh}z?N1JQ#*h zgY*7{aEHr%dbG5pOL0_f0RnWRU1GrrGF4m66c>KEv5RLBxYlHJDi4)pRjez!?C?4) zwzP!@1IF5bNV2#KG*D$92f%__>1OcGw=jTk&7UvS;lXT~J32g?O*RVmFTLLeQP8#CHf2 z-uE1l<)5kfNqSoibC`YF+s9!v%zBDbqVsEWtwmS@i{b+npufMQ^W{-VS9i3UvTAVuGx3%4PSf+MSCM*r=hC>FCtui3&6$2sMJE zBe8Zu8}!5On3M^!qps#TyYK4OG?ht_tC_tL7p5tBOWFVGX77E%8$j%vPhgk2V?L6Y zso_(#v?FsGVZ`18)`qQo^M+zf(t5#;ApD_vBK)U4P;@W6C1Cu7yt}mr4rr_nJIzJw zanA|Ne-C7?^dV*7RsM#wK?iVVxxW_Mj&xUAzEudMh^tlfVjF-!62~bJQ#ms?wEt3LdGrga2MiXA1=mp zKVdg|7|uHDIv`(k4c6E<6x&bq+!I%%{UY2%h0MwMxbk6C5dEtyn@!Fa5a@9myly^J zNb0vb8ju-^!`_BayCD-o?PgZ8UF~KrQjaS2pvV^V;u7cTp77Ia=+ACvS3B6r)ufMA?IC zOL#EV6N%!Ml#0Cwxxxr7$)cCciu>Fz^jGZxCL|k-KsJQ)nB#P7s5emS<0Kpb`wPZ5 zmVa5=0WOPS(}lSiNCCKcy7|~VzMk;dB0fwNae|t{JHSQb%_IWqAidHfiUj@xiV9hi zbrAX}z3&ZrIoAKX?T(%HVz;#%%f}(ZLFKr=*9Wh1Ah(NQAyJwS^N1|0c4-neO1B=O z_P?g|azarBkV}nS_Fp08mKe7lY6!;LYqN);lCZHSgvv=Bs4E{OkD_V1OL9VSdJBpR zdbb~o;?PTrLS86UAmp~2X#+=iD2nq%;KEn$EAzKD^K3RByizFbGJFVu6$kbWB!!Ja zK*)Sv$Upk2OJXI40~!OUm|(~QgvPpJDFABj+vc_=Ruj(r8gFBDi?GEe9VS1N$8{>3Vi zq=##Z=i%nLA3$S08G%osG2{^vnFhef{Vcm zL9rlsP?KOA9i5@g9-GZTMM+x4MoDr^3aTmXPr6Ky&Y1IrbQ%@ubVZ3Eo&Qym(c3|7 ze@uEggU~1Fm*7c4FL}s( zYf=L=T**MJ+@Irf)>b;u2$OR!Py+MlJRn z0@<5fUF-ev#C%kRFwmbT5Bl&xQH>V+909P$?7g#@J$A*;vVJ&tLshCQkAm7DcoO>} zWzRAFAZ4_Pw*`&=YReuxQI=!z)qy@6%08*@K6VcBQbN;ao&h;{AX1#q6hUjGx72WY zSH0jxzJReIP`xWF(4m@&)moURAV&n-InamE;@lIlKRss;?w6tB00w_$XJeT-n~OVS z^9QC^djUcK623@(!P?iUVW@vjn)AN~|81zQP4Jf(_rbnKfG;%~?ehrvBmm^0vPOcwUyP1XePqIi!y>l{w8Jc}{y~ku!T5KIy83kQRXh3wnK$T2&rJL$0H&s#|eU}_C zk>zGIgjryHK6T^i&^}^;_NX7a!QW$E6DcKf-lJb_z7HGOVb0Bhu4F`II5`)XNgWxZ4f7VVd=7L~a z(T^GeYR$HZ(?1p-rPaVfUg)e}^!46e$r(X6Cg`57(aAWiUZcN~FiTyRMm~zfSm6(YXraD$DOjUz@ zQ&f?rzuGj#7gZ|76K;wmrnVqJlFvtS5i#N5Iocl%$A= zS8U)~PMNC`G$ib0H2lI%MhPIK1g`3iL`TFG*8jD^vr4*x&TFG&nx`&OT$lt zeS048^RVFOEidqM5vt*yaIh9|sGT|3QNHj;D66dSA?PBr?0vwAgS`#fV8TytAGKka z`RXH7Xesl{v-X@r^UDzS5S97m!yIvOjGvZek5^^Gz7=Kvg=KF`O9z7I25jc!Cgrc$ zE#-fSE8SK37qa{(((=j1Er2*zmH)Doe;Lc4jC9!fJ?!(tI>9NxMe%6A9}Fhf{z8R4 zCGP807{{CaHo~0&%=fnQ1+U<7GjK@ROBs2liu?hrBo*1uYtLh3CL+m^L_3m=cwuLD z#|u9PF-q$?;Dk~Fd!IH)>pI~MccM$Ra5$V|Ivhv}>xIGwt;~XlQu!9Ed|Q!E<>}5m zhMOm7w_!ef#ZgF{%E8?02t!&Rnxk`=$o3>Tzl*wUmI&rlikWQN(uAV&h* zWKY^kbKbvz&A}Xr-Rv~^B7J|p=_Y3Cq+w(#42Mo?rPP^HDu}RosgOU8V$a-4N&TfH zbXoI~+6G_$*5Uj7e76&um-?gOn=d7yXPcMQHu(Cr4&RWU2A^0mwALT{dwt%D9jxd~ zo9RobL`djMwF0^M9jBaf5z1}qkg+j{O;ubjtj#=#1!~Bs**CC@x9s@Hz1^@Qb|ZC? zhBYP=kLbPm&{B$Sw02-Vvczj2pw!7f-Mm&0nRi2(bMUuRk+wZLvTeh)lsSt0+~O^qfFt zB`tLl(LvK6<~7C`4v^=J+U1W>{n8Wnawx^xvWt!r^CZ`@( zr3gxJI$eNHT4}+Hy_#5|o!ny|+5j^PHziPkSH`CHQA*5(;}`&U?6H|ZU5T-9Is3?1 znkSF>`Fywq;J6>ZR1G?g>fp=%?bbc0VXhSWDoWsAL@zq1Rouez%*8CWC`t_HA?OWmB7a*ql?z!WGhKUi_HUh z1{GayVlTOL>DDOf$~vyO{=A+jnlGej4uTzB6>K5%Qz+7l1fyE)F_c2xOl%QfY6l74 zqc2smMOy3$2~3*G<+7>hlsv{_Oc6f-kgr6D`#J%y{6pvzyh7gfXxHr1a+XH$g}^y@ zuporYQz45|AxrRziwH*agZ<7JB!WOP^-0%$Cq!tB8XUcmR5`_%{9_B4A*Z+)uLK9D zLRr7&pUc{CDwMTpIim`-oZ)%!{Eov(*dESY_aLmWaakrK^E2<5BVUp+Kl69$OY-Mu zj#pn&On&C?)z<=*Z=(8IqQ1)2SC#sjtiCp>uY1&2o%;HN`f5;LQ`Hv{1z4u3FP^@{ z*L3xjr@o@kcUcf6U8r{U;uGH7#u>cQbU6P1c79}gHjJ0DEmqp2m zDq}wNLB0bQi1Q0O;*p4U_wW3NX9cG;&HN@?=c8Gcr+%Q(k)Mh#MTpF-7$I_uv^Op5M2^O|8 zxxB}+xIBb#6&#aBt`Oya- zdg5bv@10n5;T%2BX=@eBkOpdt=}=c-){G8EGQ(m^lR*{e63m8v&Q^1=F%ZRfWvq(G zzyV37H1Eaa!o#DJ5ruo!YGU1hIa-kV(cWuc+8r;g{N@VFH;oQptgf#Gt3UGvy@#O& z@9Fs#=n@3D>jD6|mhi zSB)Vd$qpqN7zq~DYO($R3U+A2VTUH8+K(DZzW|xEoVj!4VMXK- zo4}G<<%j6j*rh36_OJQUu`X-IWt$`;t)h`AGHP4rY&_dXP>;#l(2tzfI9ikY&HS+6 zSVX(TReZ;+CUia>HVG7g9+uAe11x#A;Dmmr?)@G;&$I}4PJz1E9F!;0Oe1h4(#$vV z0%_(myr}Kk3$en7k`9ij)(j7s{lA<=U|-t94z>b!z*IpEH5CtU}& zKpgho=iHAW3*d)YKc9A`SyG>MrFly|DDsoC&OuYnaSK7Y!RR4x`3RVg)$2IsF2~pJ zb8EO5H3Z|e;iCPnXr@)nKz;R#0Td*`3XLqm9E3$`cF@h@B~bezR|ex7g4S@rn<2C5 z<=hI0uEr7S4dwOqf5Z_OKh0n}|EvpkDSGAsb4e*dP3^e(0fq~9;8_uEgff$I08VzJ z`;EEm6Ua7qlGrHQ48dsT0J7^*taBPW;Z>H5zlhVww!VrUSD%i2BB%O%7oRCF=5nY6 zCIYnqKdHjm%8Ay>ew?19E{JP+?np84xKA|m zIykqIuIF`u6nP4Rka*7r zsg%G<-yGdtaMvH-aKexR2L53Q#Zp39er77FNsHE}Qk4A}J_VF`A~{z00TlXAeDs3Q zF8CV=ZRH^nT`FD&vj&h%b{Q$x%HH%il072HGH;m&eS|B(<9JkUAWKQ20YB0vrn>+R zzjYgml=f&?xHz2pwL|GfdV&E+Ub-W&$bx#kKMAbR`h zdYD4<0#Ps&SeWRwK2jfyxNCz3xW8FC3X&swrgRkKINcfqx`|a16c-FLwBgVov+K8d z!DfB4qgx}8U~V4kEP6wWZDLU>1Lh}f2Jh#BZO|kPLxIZ-tw-6)$enY;9>n)vH!DVT zR#qEpX`zT^E52|;1~zbX?^^m_GXIx{?T?n(mIY7|((n zEXaWZ`@p3jxNDIo1wp4&i95eTiT#dJ;=x5NO8f^)%tD@{&M1n{8hWE?k)s;=A!j5N z?4ft-_$GQUkx^BYCrR!hKwpX{Z6DaAJ}Hi9!cj1J7&@e#A~u7L79fMHaz^%%p;8Gzudw<} z3L5bsy&1NfitXCPRV0t->rk>_x$y<+VK%$}g|gXGF&=qpV&5PLGldA!ridhA`gpP= z>4g_{0eCX6x=IpPUNKk6texb9c_<~p3G?xecCd13cLg^T(&h4s-q;!qR)3PG1XCRC zKw`y1k&}g?sUAE^jQUWAk9G2>WfuSexD6Bt^@w+dx#v;JM61}7@os}Bp3HbzfQoDD zDJ;g!zDttDyPd;$wUV}<{R_o1SF*X*pJ0gOG^`Z|&AOvlycq*~>ejt5WGi2?0wN%1 ztftqBXW#-z^psL^L3QQuK0z0!*oob_Pz|aR_JW?(Rf7q%z;yRFP11_cLX5ec6oB#b zCFm!x8JB}i!jYp=i1jhDhmiI2#-KUXAM88TLz_6qZu~5rTbXlN8Vyv?&IR)ND_X^+ zn3v@n4hGiK;YBPdkc$<_9M>Z`hjOimg)jA1YOXZIfsd=ea*BBsY`W|QT;(O@H(lhn zJ-7o}4T0s@|E8UmF_)bN%&A9eKx}H{Q7MT{jEf4%V@Z2dTkL0%%6SGfq~$Ap@buTH zB~IThfH`jkpqFY$3nfOs#uDR}MxVF{SrtK0*w`O3zHygrSeNQWA8K6h)&s}EqHSU0 za4@=+Z(8&TBvF0X%n|;&4d*gK_=50QRH7r%{D^yrMGts`I2^*G0 zinSL#FBDmacP9j)J?%WMImCyKzXd?4H7Q;&`i~|KG*uYchf-yifY6HG(q`lXTW+%h zhVMaz2j?IrVbs;MD$aR7qN+bOuWIt2ooy%sR~+VYrKZK6GB+(Y45lJtzZqYx zRZKvf?yl~m20lv6Asum3F);_HVf?i?cfoHQeieP7ltib6;F%8XONh2AqBGfi2$pVD(2RultEZ%&sQ}q6gcTpB{| zcbygV;(&d1AP!S~P?J($V{Y};B3F_^(Pyo!!Q6?O`jZ6DinYeGT#%gs(0?7BPi6lw z7AvI4H|X#-5oL`?M;ZsCtUAK332aRc(MjAs4>=k5o_nvCaI%H%m3WC##Q%6hFjof;+E8 zgD@eHafJFV=(Jq0s0HBt ziE*+4@0?*xkMky$%gGIjjte>Ju&87)I`=7dNXlvcS(*RJldTGKF5~Q-Gu-Wpmzlt* z2Cu7P9^)WnGD&g9Mfg;UhLF(%K&tovWYHTjwJWjiD08XZhZ-d8PT$>IH)MUhe+Tw9 z<^-`B!=us0>QeKRL1w?ofN|LnqkCmAzAhMD?F$vHEB`F9%rs!eZ4CDZYSk{&u`6|Z znZ84ug{h8S#2Mh&xk1Q(5K`M?_x&6l{kWJw9kZp#R_12&G25-kb~HwX^cTY!Bgy%l z&yfC-Hdhm#sj|&yw!;vbk5&!D*B{_i5w+cg+E#W0W!M!QpRcDfHkTc;O(eB1XDaMx z!G2CH_YJHsMHX$IKJz?jh_aP?Rcgx~GXk}BVQphMTCNeXqGJXEt5v!btI&30^nFO*6Yz@4O=?0@23ItB1j8|6GLR&i|s`05G;a3=yhzRlS- zqFS-u-TDdgUE1b+{}j;o*iSH<2ibm<%F`YAZ@-7kYxckd6Wg20?f6gRq?J!5MN8)< z^p+HOk4Ou$i>+p{HVnH2YrYf(CgkjWN>g&IwE~EHw>VAPV;di%VPC-9(cNei$<8?! z8nL4d5;u^(pCUQuv$9m<>Dokb)l%l)`shEW~1+WX-Q(5KC(2aD5%$?4(YQ<_c> zFGpm0C@X7qYVh^q)F7RVMyYv$etT~6*JeP}`Z0pjpam%+It^6$Q%E|#11M;~m5*xq z`ISKMzcM|4_qR4q&t-!Wge$^No2Hs^ZVzs%1NgmpV`ZDNos4Y4J?1gr0o(<7lc7&m>sTE3m+`{)Y>Ot207@p89W3Q zFgrdNFoHfr!95H-o6yps{1wxpWr?KXGBjZN9#n_?O^a(piTETLAwjOo3HV@wD<$#B zq2sJJ3LR*6%#aMl*mh-o1C5RukgFg(Rh54P?HsnC=2C|eSRNq(Kv(9~Pa-UW1bBX(;gvxYt+-JmnPH>-N@Jw@^b6WCz z8vW@}V zufiD{JXEjtAg_o|d#)aY}m!MOMpSbiJ|xVM}bO3z;_3VIaD zQQum%!L(`*a0k+y&uVpJeneF}rA4*a;D$NYXXmig?k~Zf-ALd2qhDyA7;Ffb1u1|x_6C;Y@ zTgU4D0(MpA;H%WQ)TJVnK=NT@_y=Y5D-0r+fDu;3cDx6TeR>?eua}bQ2AQE34;j`W zl1h;%$F&(euZz}DYi0T>gGH}T>J}_|EfFqjyP}Q{ls%7)*j(U8Ze^pvGPu|V( zT_q8=$}eD#O@;kO+lbDpQ;L|#o2?{|5j|uUfdI( zYIwP*B02LFCRuxOV3I|i29ul9r?|7%*@O~K%o3xS@tDo*n^_Wu2%=Hvs_jf>&L2bY zOtJq%-%vCQzKqeszldx%or5}LyNT$DciT2fwwwB}6p3%2h$s5v-Ck7jLIJWJ#qP#- z)Q5f+6YusX6%d)Y~0JC(C>e>0qMHGBF3L1JKFyC#{w5 zQ{|VXmEX=S|2HiEP<>RCpefGBJXh{1)r+$vXS16FK`VZpJRy#W6B6FwhY9;BNxHlgQz5kru9?BX66 z4BmY%tAY6u3w0(!QQ}r$PVnIrecI6OyOgvp9_{&JKX#uOWs>X%85h6EV~j~AkSMVS zO00=J0Lt<@-SCbT+mOG2D%I|#z2(1X*2SNs!s(FiBl~3rpN3%Fq9@oqG>_~Ink|{y ztn4>%APZk)5MbHDNDNEnA1fvd(}>AzVP*c_E4%74TUeP_{TX$u2@ZxV%aI-V=@~na zhgU?YRgG(q1Ag~QWU$|V2jI;9SfKnhOHfdrNGK<(;4|-M@IgC+VK*Zz)$zk5YLERn zOVQJ!LT=OsM)g9JZe>OuBZ$h51U7kA=7$~GR(Qa$GE0=*6d4=A2UhWH0)7hapV4mW zY!{wbzo%RS9DDu{W1+-+OqkyT*IW+fWG&X!*i^%gD4-c zZ;e;(GT`KAziPYN1W`be=#+|oa=^v$na;<&ifo2e`+?j z_hxs&P9zP*kI)mYe}z`g6d)oWESRQY50g)FMTABUgF zDmI(0p-CTamh;9EcHj{}JSP34&D+^#o=a?%T@bt& zZpq@4-t#tWNS*W@DXcHJ5=#jDX`Zn`?S8CG>`;$Qv{SBjE~eY5%FD5)fr4QAt~eK> z@Q9uTn}mvX2xZgrLq@1)Awzm1#Cqlp2p&PJA8xIx4O!ij{_o~i!9!}X_Ha!xt}OgY zGki#V`}>)jzl~SdckNvj{UHuhp@KEu_YHgh_S^sauRFhLSN%m7V@Cll%*LhGRyV7- zCk%|<4Mx|)JxD)zoiFi2T4}@u+Cc+O>~SeEUfzboi?H{tVDxQIr24+du4$3o#bIsn z*5H;e;2`I%;Qq~F?+(ee3to047hX08jn~57FN4v|9wgon+~P=*kAucGb=z^!*c9?M z2BVwcXJc_yaErZ?$!7Ob}04T6CPA|4Lx|De>fwWO#~d$g(;p71Na!b>0z4%}EpApRPa z-KZ#0HzlDo(i{SI+&Yp!j ze&84|tRe^8>)(4Vk}-V=g8*^0ovrtObmD4Vo7p!R)KTw0e5ln)n|Wa}=mfq0d!3vN zZDv6-=y<(e@@>Oz#)a=7ixTJqKHf zfg0cG=Le1NFfv7S8;uKbt_zF~Tpze$4Nl}8FQRF5d%PZ|b1a1x_a~vu(%2{EBVe6< z{#e{{>^Z-X*NH}7&!~SfXbtx9h@cid3q3Y=U~Ne+PvQCEt~6AzkEhfs2OuKoeLv{^ zF68}6H@>iIzK5TWd%-3E*uM+0c((6@m+JZj18Yi-&nQG0zT*qe4_1FQ09CYeMj#^or!#Xd5JFMD(9~?_@-ovxx_OAjL(^u73oufba0@44*1Gm3E4A&1- z+g;$2ufXwQk)kfPx4IRaiwj{5+(h;!c)-O89?+og|5Wh+d3hTK@FDLTiU&+pJOIOX z3wS`WwrpR}*qvYl4Z-~w{qHnk1GQoA=Pn!AC~N>pzy`K9VFL~6YyiW53)sL$vH`f> zJ5h`7Mi1&MF1|?pg$VQ(t8s9jI zH6D-ReYM`QUPnZ_uKm-ASLsFn6{Le`;`JBl%M(4MuSj%`zJF`T`+-cA$kGsBO%)6J z=?g7NYhH8_n^bLQ=&!8#F8{iRR)3eT@Bhr@>qKy|8Ymd|fI00bF+d&&NV^gr{qyef_Me`*!X-p~sb`sMe=ynsa ztI&9a9FyO|^x*+!10bmA!Aw@X#7pj8aUpELa0%mic)*Ei`ArerNw27^q-Q=jRX%n= zGb)E3t{E7=6(;faJHN{1=?StJX9N%rPS=Yq(7j+=hkXHIlOZi!gWVH&MA(Rh{l9U8 z6DSqdOwL2dp_^rx61+HfaUaAA>*6y+%dy8Ex_@tcR>`H_O5de5c$^=oX@4u2=NSZm zHD8OGVZ#lRSX8|g@G8!;9-7bMWjG+a(^(0MOo%}7vwwTV$)5Px*U9gd@>?vw7s~IQ zLm7L${0^7jf%1E?{GKkqe)-Li-v@(Cf4}@rkl$pZuOLzj^X|y!;-L^1qhfI{E##{Qg~jACuoa zDY>)!`sDYqA%rJaVl(77Bq4t*W%vU5eNuk^F27I9?;`nqR(_w8-(~W->veyU4Gw{-}mJA1NpV(_Y3*`QhvXd-v;^JBfpPJ zEB48Iqx@zJW?Ovn+g^UN?&6D3V<+rE&ejr%Nm-nCj zU+Ufju*oV58*YI>5n_rEts+viXmJC?rHE((6cS8X6ck0EE+FnGt>7rqTB?K?#a%|x z!i>u3jDn+BP_zYXK@bs8QCtdcZ!Ai2VR6gEde@;JF@5<4F4`B6 zg)novXJ23HAM6et#X`>s=Wrl>E(iN_^HD?QBRxoatA3jy3~#fyidrKaKFm ztF(xKS%R(hbxWBc7+DvHG!I4GN1!l&{N1=Kyr+AH;Ha@#ubKdG55>47uYi0oK+O8b zu2@33s}-Q^+30k^%Y{Hj58tf45mylTD{H2^Rc0Tu^cc4yzAEhMfe#uZqX}kmEBX$> zi)N+0G;Ybz?!*V}DimDN^>n_rvV;cFwzvky2hQA8%jOBy$g4D&zRn-S553oKp*XgF#MTQ ze1V8-_OT!(px6~1mD!jT_hy5pBb(9LJ-96Uc_aq1A|C)#8uz8((*S%zS3h9?bU*r3 zeZu@}>FFr%6lCkQf!S^*^)TK-t@e&A)^#1J>MS|fNE7$Y0b8hym$)k8%}dWRYdphN zV@X#)yREAYT4R~W%@pva6L3cRC4LpDi z%*NSk&*Y(zr7h#$&Zx-Z0&6kSp85$H;$43~i`)#)58+wgzU-QV`xW3g>WcETuK`M+ zA}deBG!<`}p{{(zZ?qMlU@Y9|GCmM#(X|JVio-Co8eM@tt4ccbs%Z*%7P*U2VCi?K zD1NgrvvD_Z%5v{gd0T1Ek}n;u-GFBd+3(cr7N^uSw$i@F!$OJwC2a%ap^*m0^N=df zDC;w%Lr^DXIz-!`9$IOuanrcnmS1}XZ?qTjqrcSq7kuto^0|_{9GzJ9axj5jVp;>p z0OWlr6|r_gzk$fxfk=Ja`+h(6^@zMtkr2810ba%QIoXwF)5@3^H=WT zAEmeQV}}uzRg8-cc#V}AgvK)>TT|zeX1T> zBj-lkHhyC^P|1+8z70Qs%|t#dy%K?Brd+MHRuJV^ZYjmaK=)hts!f-7Tvp@Wz~>uO znv;RmUOXRT%+VN(6{~Qj_jK1BBmnKr$Ayo);_*3L>RhGx%@hD2n3jNTWoSR+NBSMC zxVE|ou7(M{T}97+884k0xZGWa8!-C5yflBSy!Ws|knXr@o**=#w?C(JMCgR&o>zu< zfYzB4X#TF}6@N?2+Lwi*n5&1l4fc7rBquVsZKzM}O$Q-{dh^;)pPHK>M3?6`e%5OP zHpK{Kbg1}SUdA-i$U&gPmbf+(vdmeba5U>f?FW!zFC5ug(q_h%(pG`Hyz{@8-auOS&`&o=XY zWKChOnz(m&Z+t;HX9X&*$Sc6tXoGx}M4h5B3|0&(wnd<;ZGdA_*!GTdSuxG~B~vZ8_JTCGTq$Me<$Q#_3r7al|m zo-QL4hu(cn(Gcz1fJ-CR7Bpwu!R~zLpioS^2l{+=6JkM-w{t8e=6zM=eaVrxMVh?J zLAl+u$$%{;KQ82mR$u*O!dHc0gp!fJjrX z)xv>2^9$Rohh*@V?;JG#`qJ>29}C;O8!p-t*&81DYw74fh5N&8-JvHpofG#2>Rq*X z$SBLm=v#vYjwShhi*e#kNteEpcsatgaPO}W>bX<$0$AP4|9~jZKWZm;7!YywYU-Zh zuUM5iAneM=ZDT9E>x`SiUaS3)orRGP3nTCPD}HZv+jxJ}--@sUs>t^M2=D?Rfa6*E zdF#n-P)IWr^7)SLh_RD-+u`Dahz5RUV?RP3|$AntaS8>GvW9p0Y_X@k?+NZid9+luJO3#7z?{D#~lLy z<(7=8Se0Av3gHn%h7W^rw*-fwtq0hr;C{d{s{zk%05FeFeO8yAA{8t@b9pItjJOWQ z+X{Dk{Q8h?OSqE@w@AIKftW{vZ*k*U`qg2R+Xg&Kn{dd5YYX1^f#LR(2b)Ft{1I%n zTMnN>cGq}Di;Rk`t-`Je-=V1T)%jfExBK0|G46TD83?=ojte^E<~D(ft#9CYmMUDfGVmIP1(?pcw(jyC9b_{db=he9mFc0tiO2ILr$mN z_Qh%Z{Yri{`Ta(Ix6AME^4lc8XG;1J@_VfO_K@FG0G_8cO<1&)oGq;3BjmP|wnCk7%#lK>*3ffWW&@F-8aAi@b| zHkQfsR?_@d@_C!-N+9dhK_@;F;+a-#pBji>n>PvglK7?i8JpM>AL*AJ=;O~;u|5LW z*M*g!xj;hCnozWGAp$CeqD9p~1jLD6n5Ai0cno|^48(^5mm?SABw|RV>OchB2MRSD z4OUke&(yXBfSAa%>QLmm8bl>ug=L>DO8bVw)0$M`k(zc+&`2`gN^+q(8!G$@PX9u_ zrpC@Vw~WKQ@kGSe!w4U<8OTF5JahbVfKn9R9tfWu3Qxcc*X=OoZ^m#Pn+rTlO<1>K z%Z$nU)}?CzWrlV%3TUiB2Qpd}7rERzh7t~~Nsj*Gxv<95PGbK|KqBqZMIQFNk@5RW z4j|(vNTlT>BTiE-Lz}=DcwVkG%SiVDWc<~WKqRuppfwuXq}_@r280)_N{maKHh4!Ikcu9x&xg!setQ#>Y1E}{YKjsp$h0st4j_?dXJGFsp@e4IkO=AVic#5Mn-CZ za62-AxbZ65F#&%7%sp-1a@P_ik=1=Hu-0^jejEOW*O0{v(Zo(K_b@$qGR@8`bsrdu z3?_@~ooVbaoSszQFZUF@uW!}`zbGmfA?&oR?Z3u=EE=X|_4o?iKMlOH6im3Vz|*Y| z9Sr^{ETA}saT`9{)9&UhPkv#Qr`^CDMCK@CLFFsiN}U@DTR{=S8lhOO2X6+v%}`vH zryW+X(XJ;X(J>(L4>eb7a`pauP)bI9|0V_2nA}jbvf||q*$Mz^Y0#sE6obg1T{7%X>&A26j2M#dgvfq>p4>9CvLW%{8dsm`+z28 z<%(SF{zdFn=qHOVx(FUHi~j(m?2jX7aIf=1iOlk!NC7ed;dP}4Cs?lIskhNN-hgTJU}>D z0mcX<#e!$hzc^+kGI9@&uV(1Nfe&-Q^J`Y=2{Q64R*nKv#>8%dZv*zoW)EVnW-|is zkR0?lmPv9$5eKFugVc79Et8D*iG6o>dO;{-WN8tS@(*Hqt$sPv% z33x9Lr@(LCAB6WutR;593+e?|=XwHtw1Mq~U`cE9x5@}70hY7`&5N@azp)p%AlX=- zr1+CQT6!domOG8w4B?IuBf}*>5PlzX!q~`%UAEwdP@g(rXhT&3|3p>!*0#=H^1yei4T6= zPXcO&MCL*x`~u;=(fVwhSxlR#2{sWzBM$+CZ;4S{z)^fCn;3b zMF>^7Tzh637R1x0#(`FFC6=`GmlcdF>4p8K_*~e7cq{pey>l3HQ~_t&X%ReDOsmQ$ zDc~!u5*8pzK&Oi70myQcHs_gfofw+#2R@-*826sr6;XRHl6NB)gd(o~8@qE}4m{IW za+`=iwC?>`>n#9!CwQ$fpFgYsc}3AwT0jeywi_ z-yShj0L)~`sm?Z7G88PW1Qx;@_r973crm7Gf) zWVdDjK-YbELx>|IeV)p}EHUc#{?sW$TfYEnyV{gZTaEgQe4ZI&`7PesQ@IVrYuabn zU%nZ4p|EQRieUa&8XXs5n?NWeY4#^3#Q>O?0WR(JYwc086@9=b=(fg#&B z&_ZY@7#p(D1Chz|t;ooTr&|WS0|(Zp8#Ig2eH=7_NQYVp_4GC;2VgL(K?B2EA2hjv z@IzdjT6$S1ylghngkY^uVFKYw8ZB75T7`?ar$0vhqmwPj-JqrTNU0eQpjms#c*297{2qHANLlupddD zT&I6Tjk|KH`X))RElGV_dOSeFY=L_Eu|!C4J)Rg+j$bzO3nKFJk#De|oNvO>2D!)q z@OUW^=%NoXr*?Dc4&Y<1yo$VBgI8z;16|E>{daTs3|Sljx&9fBD5OO>BaBhQu()BE z9FySIDTcKeoz0Sd?eY~E&M(#wr1vL!T4m^PEdTu$9VB>T2Mt9ZX#KYUqlLIbL{fb~ zkXHTGs}$t4NHL1Icu=eV1{PR$B`F($IXJLD%N%Q0E>xkBRsQNGwq}YL=6%dM`=cW-hk&O8R&5+xQT%y$gsv;jxjg?F30)%9`b$G`NZD55Artj9sV9H{03?^SQvO(8} zcq@L1%Qy<7?%;P2MlI%JE7(v_5Eki|wn5KuAP3`x>|;18k?$cH+AvlRr?5uIJp}~& z4n!}w(ht=!S*&8J(QM}Dn*NAFF)0jLd{QiC#_$CG*S4U-YR_EY|2l>DAawEanS@T_3&$%9%jQi5SB^ABk13 z*rdh>VoFCjK+$@FsT~z2UYGF|-n}d%9T9?=Lg((0|7dvf%qT+&K+z1_MM5Fl!O;3;r}`kEG1&%#ic#*fwap5t?=6jI(5fWe7h{VnIw#!(n>mPQdLj1Y9;$w&p zK=-frmEMx*&fQ;r3rAP|iTpYbt;Y6cs!WMhr{Dhuzlnn1-l-2j<&!PxL`vK{;0WER znZO$ieJl+=bhfwP_&*6xq*6K;x?NkHptSSeONCaazc(#B9Q0Za;6ZsL6>a-(?GlOk zv3C>N9Xg!EoD9cXn>ffh;E~;l>HX|qGV!g$FcC2P&;9lJ`UJQi%t;ORA%HtYT@HU# z8vNNu-|CI23fd=q&zei7m@tMbP|D1?WQNIDwAlx#;h8m;_y;Q@gU+C@PKnuq{I5`` z)aC4&G_Mbge#({+(2UY{NwA_#1q4OZ;1@Qe!py$sgLM9(WV=r9!%(7jS<1o=3|>IR zGX9Ki;KZBw7R0|`?~3y6Qz;59dy0AigfgU5bTdara0-jM$ZfezlU3c_Eji4 ze!a{{BIJprf?pnoi{UmD`CG1>Lj#^%!%r0}pimrz0VoO88ka!S^)%yfge$33LHCuE zx)~L94St&yRaVJ2*R@;`hI14G;c3O3|G-;jp)r8h6Y+Wy$Yz1O9XU$-&(&09^&?Vb zsRBgjLVU$$PKu5B~=D@O#>Y^0M*UBF~eJ2@TFp z7u8^nWFc3Xn7KS6=F@X&=e-w4!F8%`*|Th4q&c~%t+3VPW6m?5D7 zTPa;;K@`q{I>-)AVEMp@q{FcvoG)C$T`>}py%|c7THyX^d^6GiWhWY&ytE_hn6(MW z+SL9}$QvDieKs>KWh)YQ_zPAg(zg$fq;Kqn42H4fkc3+}6r+R&Z7k-C=i~@z&Kd3VrLC+V?5Kc;~$Js zgd{qOcI;uaVVVKrdT;`ARV*VQNc9l$Q*sMnso}E;i(b193r7~d z5f+Ro0w0@*nk4=dw6MkRK?^%^idY7Ds1;i3Ym%c@J9ZbOc*NyVu%JGLx2p)}DU5i| z*f8^%*!0JMuZWw)Q~3$sD->$(`7l2tVh09$|L&>enz>o79jjr(W+NGF*p5AP8#dmC zVAi5fnntouus9+rD8`vWJq4~0wUgUJ(}=oW;goJzP>%UG=&Eemdy>XA`gPz>0UTQb z+M4Amx7GHa?s{$0%-UYqL>H^QHt`@vU48+>QOj{C5}5goP8a$B6=r5Mr(Unx%-*Wo zE>^AHTT%8F_B1oiALy}FK!Bn+#ZPIZFMye%J+THO#w4!T6L<#(#ZDJ&u)ksD!)9Z> zz&GK??11@sTOf_=B*xOao*)#LrgV;;KRp1~9jQ71ZI*k z&d1`BSKk4F>jPT#7CWf$a%(sNL#l(gmEn(cP)r-*hT9uQ+XCF!NKl4R^JT30-N`bv z-hGurtMWId`JOd|qdnNXXta!AMr71zrxHxK5AllcX5s=7IU5(OF=E!YkTrzUhbpcS zepe}FL`Lk%k+C=jVndb{3Fp$Du9H$oe>MkVZyZr@5_8Av!I9WzI3j9r3HA9;87`%M zjA0=UMR+{4rrVyS_=07Z{nukRu@1C$Y@DmIUM7?%NfD{!92{+N9n*(0H7r}k>akEA zWb-9;IE;@`$=IIQ>EI#|#+b4QHhJ0&#y>x{1!2!^>rnWh5JqA}ttQK$Mh?R#Fd!{TlAL?Rv&n$P$bU%!-sPz#Z049^tv88OREEhkNd*!`&>`h?N#= zE<0Wy_M1pF!kR0&fI5L$p2|Yw2YY7t>A8=(I(9R8Gxli5-pAg^K-l$mwZ)Y;(e0u} zBu*tDic!HX`>X~FRC zU>~ClKiI=VF(jW~(*#yoiq#iN!dndC)NugHl&?~?@=wu+a=?{C#z|lgP5UvB2`2ni z?0q0V5`78K!c|J3agr!mucuuR*5-)PirWI*?on^Cx>1HEXfa&W0^gub7UsnAQ4T?& z%n@~(PPwk{XYcq(XL)Aagb#LR85@TH&A~`Z z=(a_Xo3mw}B@^VLv#F9nfyi*hWBPL>#+%huo`WLjierCieU_6`J(b96#KqnP$-o_i zG`ZBVlm^2@P&PotAm)XGWt zMa}W9%OUC@=xgwGmg~_P3T(zMt2b&cujFB&WeV@*F#&ITgD>8iismo zDxLs_QU?6XcpJN$o<5ve$#&~TwDeUcv;^;&1yXtvD7y@|FrkV`pGqJDDmLqNe8{jw zvu8#QyDKtgB90B<5;;#rEmC2vX>sfz>Bybh8_OlU19-_hn486rXF0Lx9(MEpfGVDe zXQJvlXtoMfk9E~i)eYbOG^z|NMSR)lm!PL#T>wWKSFB{?bp%FyAiNHHg!0_1i>rXu z7}^aiLFgxrp#a5o1q=9}#r2fk|AV;hBJ^w!fv2)Ly2+sL4z-}~??wMakeT&?cQu@g zcwPvBbfRt7K#uPTM$gZVdC+wbZ#!vk{5uTs)*T(H{KDC2pO$|+-gP7yC@t3Z$<0rs zOQ@lZ9{g0}o-~n-E1=*-TQv=dw%|STbG$UR*KblJrb_xK(?6%ulb&t$&E+T3H9Y9# zJMyWqmHxz`H5w@zZ%p_My+sl$f;y84hM~RXFf6nqw?X1Z-KD(G#(m@ICjWF7^W`sF z@v;k&oX4kc`PAOzNbbITxfw4#Z4SWStSioHf$*W26h7)T-3dUn#J%q{$9i0y+d1v_ z1M{a5C;Bp7mj60*Tk*)K@^6sxm3a7bVW)h zDbU(1B~*W`zpK%0ic9>_{^rn2gRZMyO@*#~_jkoIjz{Hu-S|qvP?-_WNrkq3mzM%x z8wxh^k*Q5RBTW|$pr}Z>UqsCh*yur&j8d%c73EudGb7a$Thctme&*}20_DWt z5Yiwy-+}Tg8fpeV;k`D0$^U>atQ|mq8s+g`J1=E<=JbTV{*e;VnwBWcf(if~0LC@; zKux|-mO)~Dc&HYJ0;csBF?HnjfLGK9+t0T`3AN+tcRlk7CJJ9{kiaz#RulV+Go>b?KbT1wGg(~e1vIf zC;d6s(+Li_B0fWFhq~FpvINhd2WR^IL1W}kT3S~Y$}07ANj_Ed1D+3>J8a+cK}C^+>7jsT zM^I;xma$HTiTdFk z(w#oV73Et}-~aJ>p;Y`0OLC3%2O8i|{JZ^&2}oMGSMhI0tmc&b+br)un&%AvY_Sr# zbIb=FIDP-6^PP)Fr>F0W7uxCjHY`{E1N6PDXy5b=3L#;KA}QuOZ+yr>*ToAHx~$!v z{}<>wX}+@~r+*KmrJyNJP} z5$5M;&g2Ip1M=W7sE5O#9!G$9D&|PVSUg<>mpEoaqhqRr;zGguGN#TM9OYm>yqWmcZ-Ad2(X&SG(SkiGU$Of$-WpRZrCHkbi|9Lq48ji6ifPpur5EBHdfCgg zij&se3abKQDYFiG9V+Q{aDaBx9gSC8kc7fLAv)Q(1V=flZvf}ri~*wsA=9yWV2?QI z_sIInNxKpJgn$`~D@7D%fk_G+N;+$@mJ%D08voAiiAc{00<6=0zcCCe`NTINqw68M!!%3z#@{&FxGhIYkAY_$GMbn}OadJQZEwEX6x|Pd5walZE$O z;DL?F<52Dts<*~oDwL34IxH04s?Fm$SKN^qDUy7ZBgDg7)C15g#8kurz?$J-lxbVI zjeS^hf>REZX>5KNdN2k(emc-@iln-OxM!83!JGWHW` zU^z`_M=o~VA#wwDPK_^M0Y%{-i^AUp!@pr$w%9B^Lt(yUVZrdHf$$Glq+AqUsjYa9 z@fjL|;U5FxPeb7!kgF*CTL?uI&VXeFS&ZzMR%Me%!oZ@-)m*mZ!=fk8jAg)i><~1d zh{uyXh#a1oeepQUHFW_<25|kXJ$f z1^5^{Ri-jV7R+*;h_Z|&9HWfVxYkL{6E2fwV$6;$Vg4*m+5;uh#|5$ZfKUWZ;|xfM zeBca3f$3burw8w(l)$U{3;;*`qn+GD&5jGefCFsd0NP&!ath=c=rC8*-~&Vh0nj3|Dq2Kfb?y`|8U_~$qwjbsKLv&Z;b;vnkqdIse@)s-?C!#> z7~+Bd-U8w4^ciUSNe&i2$qMb!XXq!vPI)Y;xjn1#F)$;#NT|Hs$g-H zT!B2$swQ!tlYCQ2lr@i8446Jp+GN2HY+6{i^pI&ewFFGL0rYhvAUk7K9DOTNnsTpH zRw0Y%a0;;4Z$MEff*>5=M39)MN031B549Coe_)Fsk%Ll-B8Y)EW&tub zAw>{)y?#0(14Vj;BA0_7^v~6sh<#jG!)dk3Xifu>=b7;l8DeK}E-U_s_{;Uvd4O+Y zwQvnV*C#r8ubuj|?%c6;U8?=s`zr4bU<_U)TSdxVmi@=lS(X{0{BPWRd`l1QtqVYF zU<;>#KahT)y~4>h1E&gr3eq{*MnCn3ooxA%MLF48Vy%^MyaRBuW!s!=>HK4Yb>&a1 z{pVloPm@p}<=a!DFw#5F=a#GzKRlSB$c5DOy~3_nDC+mYM0bdW(8=xaRc|OwWzpH(~uqI$1q`cSf%(F2WBhH5b zwjN(4U_fidAzK3)8bK?vQ)zEp;VJe%>C%=jwOnm|SGj1ruZ&eeAAXQdFt zyVNss*A!zv%>YBCWZ-;^3W9?{#tuZ>ts?;j0zW8Iy-8bEr7)th0vL5eoE$K{{R?G? zMh=?mZgm;kT`*M09D%-Cmt>)Ip*#H=^CO>5g9SC9!O_e0$@fI~^$~&Q1KT>_n$|)G zTqXl-{s{-Y0@wCj>z=gHE8vjaIsxdYDlkH3=>5+DCe*4Z_5FY9eP6i+>S1K$DAn;F zYRm8eO;&xckGUr8j3J6%>HHnD0NFiTaUeC3VU^aTZ4K)X05h~J?fqv4%hk*p{)=|Mnu(0c}7pmZRO#<==e6aKht3Eq?yXNj6K06)M zS?Lc1p9P5yaG?D;6n?8_++3hk-y7e*1B2W89zk=^p_#z_TXRy zdoXYSe7!H5Lm8)E1S)=RaZ|rQ#QXA`?ikvLV)ZVTQ-oJwiFMq2=~fUG6jbo~`u3H%z^> zw38>>Rd;VEtgJ*_#%$Mfa?8+6YIxHLu@3JacpS_9qeTs#ZnT`FA=(-DaP=^{B3xit zd`(y=mkm`J#$3y~fjP|@7pvfpC}DVt5`K!Jgx#O*yAYh211&U_{%G+B_!Sz2mjarI zd+eiR$Z_wX4T=d1XJ7%2`Qvo?kJ9tM|CuenNn5#=3hS}W@fo}R`hoT6*28||w@G%9w+re9MTV8?K4Bz|VMR*A5A$Yc?ZIax|CxU|(moS?F+5tDu}$0Ilka}SOns==uU6R-qz>ZQTmpZ3I4>8N1z zPEbmj+TR5v#^LI?shbwPLxppr9R27i;qG-dyMj)DcoZ21tL_ekTzsu$p35 zuo!|Z**0qa6VZ&wIU(6&LviF;Lkzuvbgsmq=HZ94W`4HRgD3019V`M15iLQJZfXPo*7U6 z&Xubc8XiK>pk1CvYqD0we#WOzrv!oF+y$tS;52=LlWM}J z(;P%}&+M6Fb7Gaqnb6<5Jef#&!u7cN_N#Xb8J^)4K!{NsjNFKsi69oq!sS#+sKYo% zXlwJHTLO^*2SacDD7YKrVVJ?#`6v@Wn_1w7SP4H0lh-kMH(PSO zzKUD2p@cz!1A)6@50IDR?D|>~)ni-Wg-4xiA03~>XVg!aTY zp%MFRPgj;TQ!k5UsQeYT1QdM30ADZxzF$64@DZNaJ=pqZ)U2)v^>_c*{_1~fAnMOb zs-LEIFkADyK@rR42_|wK{V|^TSB-`ryMPN<%9=CsA?q*vOzTXSC zu9<(n^Lw^7G;e?O@@666%eTSjn4j9i0b@BDCV_oGe|(SR5MA1UkD(||9e`~de1l^P ze`P^#8suLY{Gbpav@obK$!SV|#k7oOo*8YBC8$<*1pBC65Hoh;b0F%^ z464N`!HQ+8@WzF$M>n+y(u);s8wBrZ5r}lazUOV88FkD+hieosBB3n&49LoX9~qY0 zfGlvG!T`8bRz55vAA}VOXaVNc&;kr%R45Zn2#eGix-SciS9=}-bP#WOB8K`XK+u4) zanV=>B8cI(N!=FXR!{?z3%7JkBS8SSvY-k9ws4z`x3OP=F*vLi_^W3#D{QYS7`_ap z%lt|J%HfJ*Rs_r6%wa){bp1_=1hJ~K*xmbBzZNM3Bb% zgFwSto%{d}N62kKh@#$)r+4Q}O6k8q4^j8kKOTdZJg@++m91W&3PDZ-kvSbYKgRg-9T~={|tQ+@J#}Iu`R=3>R=)qtzqQ50eL>eGtEW>Yg_WhQ;tc}-Y4ZjC$G-xzG2rjwg#UJYUCMmgz(>-;-|;Vm z|Ans%_<#GFcXs&ODER+`2Xnvfq&=cHu$$5;(&i6zRH}M)-pZ(TX00mUq%1B_Zsxm_h%>l9HQXA z`&xm2 z;J@>MwD6A({dM?%;}Zk_FMsNUAG@W6|6HZ;f3Lv*4NPi_{t-z(Vf?Pe*QLy-)!m;K z{>RS!>)^k4j{*OCN%YfR!T;~81%B640)NmB|5lF!{u2m4^Jy*9!@p(lUkCq`R>t`4 zn&lk7c?$kZ6#bXpCGanU9d6>kixd7Q@pUQlX#)}OIt~Bn_!q)|@5v_or#j(puHgT1 zlEVLe0{_qO1DNn%dawikALFa+VAt-PofiJl!M_gw(@!(t_nzs5UzfiRD)=8#_}^)V zf1cX`|3<3#_ywo|9`<1VB&vkTL=6R zd|k?XTFdnCZyEI0!9S(Bf&bs+&aOWkq2T{@qQL*={Q|!qcDM1g_C}C{BKh7w-62~=s%Ca3^(Dw6v1~B_~$fyRrtR%nil@i1OE{I zl|An2x&al#x!K2c4DJ|q(kE*kO24lCwOq|CEyKoMXTQ18hCnZ4JL)w;uva?)|*r9{$f|2Rz*T{b22P zh|`aS0^e)rW6N+TGCdm`K;vStH6M!12(Z0bd*Wd%YRbfJ{3!qrj-Rl&b!Fu_7emDI zd;SPtx_y3yUP;>=1aoQ4kcwVJu~K9a1rY*#j1r$MPGYQe)uFdJ$#`tUeQ!ng44m26 zq3b9Ta-{8Bb>&paU{I9j@J+?aQHX!-`c)`Gb{WV@8dyRpJVsw3l{RlM`eNh-^oL`n z_*xh-#(ZZ4_{XgAjW9u&UqBeglOMEBbu{5HDFC3(2}G3rRk61@&ey7_fz?v0om4fP`0Q@0NZQ4{x3+vCv0jo(42=_6Z1LaMch!jN+s_(W9gBl)PU> zoc5Sr>j5)WD);E~CR|%G6$Q%#083S7p82c$2dA=ulMMf$w5|XPvQ*=+tn3Bci5rsV z)d3r>r5nir4dYK&-k-!vj5=Nrf}p`Khq}`ye*bE^1TTQ?PSZ`5Fg>9J#2R4MYa}ZI zfpcMV6>};7I9zM}%ITBC6dzoyyH;^H$iicU6~S`iZd_Un-(ousu&FQy1%2mK0%6A& z5n+k+W)6U>Cs`G2Ewd_k2o(@zYR1gO7S2%J^571;hZW(*a^ZH!$AHWM`(N0)BRs_L z)L?}}1GBLv9FE8rSOEsYi4M;RMg6&SJ_tpBAlj9bI6`+1=<4lUd_k#C;o`3rmd*LuFiXW0 zG>DVOD^*EtI<^XcEzCXyfwAE}V9Os+{{5puz!uyv?E&i^GoH~<Oe z7o%`LK))Zxeh2`r`+BpRLLiK&`vpwf>OH07wfIn02LFps?0-69^s)Fk@&VH&?;inx z+c6aYzFsh`R`M%OV9W=NBnLtFz0WBMgQlb2Bjz20>|}Cr9&b~Umye)*J?aMJ^#t>u zl7ktGl4+PjDT-d1J;Cp}q16P>2Q@gsH+tHS_rrAxI?flOo&a`u>JOgR*4J)pj!C0H zw|6<0P;z#3V!R8YShICpA@UJJL>*tTBOb;|l69r48#}Sk7I`c+SW#aV#2Mm!d5Un! z*Sps@zAy`*EXu@mQD+*+7=i%|MIUPP?w)G{J6s!H1?uvR9%D{NSpyoa#(>ai4GWWT z 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�vF;2DqrxK@c?0_r7#nrg3ne&6f3FVsYw1zGs5>4 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⋘T+aw#YvI2P@}E9Qz)W*|B$x^?#l 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 RCv5-+I|E;5C-xkP~>A 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%0D)FanB&`SzR8HDJPZEfVx_ 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

        mFl(ws4l{VWPw2f>gS{9K@=0_&&xYG*1}0wy=UL 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∌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%0DYs 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 Kr29NKpzGD3G^}0pFtl7{RQ+1&|g8H1pN(k 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

        @tx@@;>q+>@m=U?;=9tv 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

        3. vfUrSAoDmGlmg)@{O_XA4wjfv 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%0DTRUlPIU~l5o==Br=&cYmqFs&ag~VZ89DqX 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%0DElZr&!Ct0TKQ2F2e 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Ξ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