telegrinder 0.3.4__py3-none-any.whl → 0.4.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of telegrinder might be problematic. Click here for more details.

Files changed (192) hide show
  1. telegrinder/__init__.py +148 -149
  2. telegrinder/api/__init__.py +9 -8
  3. telegrinder/api/api.py +101 -93
  4. telegrinder/api/error.py +20 -16
  5. telegrinder/api/response.py +20 -20
  6. telegrinder/api/token.py +36 -36
  7. telegrinder/bot/__init__.py +72 -66
  8. telegrinder/bot/bot.py +83 -76
  9. telegrinder/bot/cute_types/__init__.py +19 -17
  10. telegrinder/bot/cute_types/base.py +184 -258
  11. telegrinder/bot/cute_types/callback_query.py +400 -385
  12. telegrinder/bot/cute_types/chat_join_request.py +62 -61
  13. telegrinder/bot/cute_types/chat_member_updated.py +157 -160
  14. telegrinder/bot/cute_types/inline_query.py +44 -43
  15. telegrinder/bot/cute_types/message.py +2590 -2637
  16. telegrinder/bot/cute_types/pre_checkout_query.py +42 -0
  17. telegrinder/bot/cute_types/update.py +112 -104
  18. telegrinder/bot/cute_types/utils.py +62 -95
  19. telegrinder/bot/dispatch/__init__.py +59 -55
  20. telegrinder/bot/dispatch/abc.py +76 -77
  21. telegrinder/bot/dispatch/context.py +96 -98
  22. telegrinder/bot/dispatch/dispatch.py +254 -202
  23. telegrinder/bot/dispatch/handler/__init__.py +13 -13
  24. telegrinder/bot/dispatch/handler/abc.py +23 -24
  25. telegrinder/bot/dispatch/handler/audio_reply.py +44 -44
  26. telegrinder/bot/dispatch/handler/base.py +57 -57
  27. telegrinder/bot/dispatch/handler/document_reply.py +44 -44
  28. telegrinder/bot/dispatch/handler/func.py +129 -135
  29. telegrinder/bot/dispatch/handler/media_group_reply.py +44 -43
  30. telegrinder/bot/dispatch/handler/message_reply.py +36 -36
  31. telegrinder/bot/dispatch/handler/photo_reply.py +44 -44
  32. telegrinder/bot/dispatch/handler/sticker_reply.py +37 -37
  33. telegrinder/bot/dispatch/handler/video_reply.py +44 -44
  34. telegrinder/bot/dispatch/middleware/__init__.py +3 -3
  35. telegrinder/bot/dispatch/middleware/abc.py +97 -22
  36. telegrinder/bot/dispatch/middleware/global_middleware.py +70 -0
  37. telegrinder/bot/dispatch/process.py +151 -157
  38. telegrinder/bot/dispatch/return_manager/__init__.py +15 -13
  39. telegrinder/bot/dispatch/return_manager/abc.py +104 -108
  40. telegrinder/bot/dispatch/return_manager/callback_query.py +20 -20
  41. telegrinder/bot/dispatch/return_manager/inline_query.py +15 -15
  42. telegrinder/bot/dispatch/return_manager/message.py +36 -36
  43. telegrinder/bot/dispatch/return_manager/pre_checkout_query.py +20 -0
  44. telegrinder/bot/dispatch/view/__init__.py +15 -13
  45. telegrinder/bot/dispatch/view/abc.py +45 -41
  46. telegrinder/bot/dispatch/view/base.py +231 -200
  47. telegrinder/bot/dispatch/view/box.py +140 -129
  48. telegrinder/bot/dispatch/view/callback_query.py +16 -17
  49. telegrinder/bot/dispatch/view/chat_join_request.py +11 -16
  50. telegrinder/bot/dispatch/view/chat_member.py +37 -39
  51. telegrinder/bot/dispatch/view/inline_query.py +16 -17
  52. telegrinder/bot/dispatch/view/message.py +43 -44
  53. telegrinder/bot/dispatch/view/pre_checkout_query.py +16 -0
  54. telegrinder/bot/dispatch/view/raw.py +116 -114
  55. telegrinder/bot/dispatch/waiter_machine/__init__.py +17 -17
  56. telegrinder/bot/dispatch/waiter_machine/actions.py +14 -13
  57. telegrinder/bot/dispatch/waiter_machine/hasher/__init__.py +8 -8
  58. telegrinder/bot/dispatch/waiter_machine/hasher/callback.py +55 -55
  59. telegrinder/bot/dispatch/waiter_machine/hasher/hasher.py +59 -57
  60. telegrinder/bot/dispatch/waiter_machine/hasher/message.py +51 -51
  61. telegrinder/bot/dispatch/waiter_machine/hasher/state.py +20 -19
  62. telegrinder/bot/dispatch/waiter_machine/machine.py +251 -172
  63. telegrinder/bot/dispatch/waiter_machine/middleware.py +94 -89
  64. telegrinder/bot/dispatch/waiter_machine/short_state.py +57 -68
  65. telegrinder/bot/polling/__init__.py +4 -4
  66. telegrinder/bot/polling/abc.py +25 -25
  67. telegrinder/bot/polling/polling.py +139 -131
  68. telegrinder/bot/rules/__init__.py +85 -62
  69. telegrinder/bot/rules/abc.py +213 -206
  70. telegrinder/bot/rules/callback_data.py +122 -163
  71. telegrinder/bot/rules/chat_join.py +45 -43
  72. telegrinder/bot/rules/command.py +126 -126
  73. telegrinder/bot/rules/enum_text.py +33 -36
  74. telegrinder/bot/rules/func.py +28 -26
  75. telegrinder/bot/rules/fuzzy.py +24 -24
  76. telegrinder/bot/rules/id.py +24 -0
  77. telegrinder/bot/rules/inline.py +58 -56
  78. telegrinder/bot/rules/integer.py +21 -20
  79. telegrinder/bot/rules/is_from.py +127 -127
  80. telegrinder/bot/rules/logic.py +18 -0
  81. telegrinder/bot/rules/markup.py +42 -43
  82. telegrinder/bot/rules/mention.py +14 -14
  83. telegrinder/bot/rules/message.py +15 -17
  84. telegrinder/bot/rules/message_entities.py +33 -35
  85. telegrinder/bot/rules/node.py +33 -27
  86. telegrinder/bot/rules/payload.py +81 -0
  87. telegrinder/bot/rules/payment_invoice.py +29 -0
  88. telegrinder/bot/rules/regex.py +36 -37
  89. telegrinder/bot/rules/rule_enum.py +72 -72
  90. telegrinder/bot/rules/start.py +42 -42
  91. telegrinder/bot/rules/state.py +35 -37
  92. telegrinder/bot/rules/text.py +38 -33
  93. telegrinder/bot/rules/update.py +15 -15
  94. telegrinder/bot/scenario/__init__.py +5 -5
  95. telegrinder/bot/scenario/abc.py +17 -19
  96. telegrinder/bot/scenario/checkbox.py +174 -176
  97. telegrinder/bot/scenario/choice.py +48 -51
  98. telegrinder/client/__init__.py +12 -4
  99. telegrinder/client/abc.py +100 -75
  100. telegrinder/client/aiohttp.py +134 -130
  101. telegrinder/client/form_data.py +31 -0
  102. telegrinder/client/sonic.py +212 -0
  103. telegrinder/model.py +208 -315
  104. telegrinder/modules.py +239 -237
  105. telegrinder/msgspec_json.py +14 -14
  106. telegrinder/msgspec_utils.py +478 -410
  107. telegrinder/node/__init__.py +86 -25
  108. telegrinder/node/attachment.py +163 -87
  109. telegrinder/node/base.py +288 -160
  110. telegrinder/node/callback_query.py +54 -53
  111. telegrinder/node/command.py +34 -33
  112. telegrinder/node/composer.py +163 -198
  113. telegrinder/node/container.py +33 -27
  114. telegrinder/node/either.py +82 -0
  115. telegrinder/node/event.py +54 -65
  116. telegrinder/node/file.py +51 -0
  117. telegrinder/node/me.py +15 -16
  118. telegrinder/node/payload.py +78 -0
  119. telegrinder/node/polymorphic.py +67 -48
  120. telegrinder/node/rule.py +72 -76
  121. telegrinder/node/scope.py +36 -38
  122. telegrinder/node/source.py +87 -71
  123. telegrinder/node/text.py +53 -41
  124. telegrinder/node/tools/__init__.py +3 -3
  125. telegrinder/node/tools/generator.py +36 -40
  126. telegrinder/py.typed +0 -0
  127. telegrinder/rules.py +1 -62
  128. telegrinder/tools/__init__.py +152 -93
  129. telegrinder/tools/adapter/__init__.py +19 -0
  130. telegrinder/tools/adapter/abc.py +49 -0
  131. telegrinder/tools/adapter/dataclass.py +56 -0
  132. telegrinder/{bot/rules → tools}/adapter/errors.py +5 -5
  133. telegrinder/{bot/rules → tools}/adapter/event.py +63 -65
  134. telegrinder/{bot/rules → tools}/adapter/node.py +46 -48
  135. telegrinder/{bot/rules → tools}/adapter/raw_event.py +27 -27
  136. telegrinder/{bot/rules → tools}/adapter/raw_update.py +30 -30
  137. telegrinder/tools/buttons.py +106 -80
  138. telegrinder/tools/callback_data_serilization/__init__.py +5 -0
  139. telegrinder/tools/callback_data_serilization/abc.py +51 -0
  140. telegrinder/tools/callback_data_serilization/json_ser.py +60 -0
  141. telegrinder/tools/callback_data_serilization/msgpack_ser.py +172 -0
  142. telegrinder/tools/error_handler/__init__.py +7 -7
  143. telegrinder/tools/error_handler/abc.py +30 -33
  144. telegrinder/tools/error_handler/error.py +9 -9
  145. telegrinder/tools/error_handler/error_handler.py +179 -193
  146. telegrinder/tools/formatting/__init__.py +83 -63
  147. telegrinder/tools/formatting/deep_links.py +541 -0
  148. telegrinder/tools/formatting/{html.py → html_formatter.py} +266 -294
  149. telegrinder/tools/formatting/spec_html_formats.py +71 -117
  150. telegrinder/tools/functional.py +8 -12
  151. telegrinder/tools/global_context/__init__.py +7 -7
  152. telegrinder/tools/global_context/abc.py +63 -63
  153. telegrinder/tools/global_context/global_context.py +387 -412
  154. telegrinder/tools/global_context/telegrinder_ctx.py +27 -27
  155. telegrinder/tools/i18n/__init__.py +7 -7
  156. telegrinder/tools/i18n/abc.py +30 -30
  157. telegrinder/tools/i18n/middleware/__init__.py +3 -3
  158. telegrinder/tools/i18n/middleware/abc.py +22 -25
  159. telegrinder/tools/i18n/simple.py +43 -43
  160. telegrinder/tools/input_file_directory.py +30 -0
  161. telegrinder/tools/keyboard.py +128 -128
  162. telegrinder/tools/lifespan.py +105 -0
  163. telegrinder/tools/limited_dict.py +32 -37
  164. telegrinder/tools/loop_wrapper/__init__.py +4 -4
  165. telegrinder/tools/loop_wrapper/abc.py +20 -15
  166. telegrinder/tools/loop_wrapper/loop_wrapper.py +169 -224
  167. telegrinder/tools/magic.py +307 -157
  168. telegrinder/tools/parse_mode.py +6 -6
  169. telegrinder/tools/state_storage/__init__.py +4 -4
  170. telegrinder/tools/state_storage/abc.py +31 -35
  171. telegrinder/tools/state_storage/memory.py +25 -25
  172. telegrinder/tools/strings.py +13 -0
  173. telegrinder/types/__init__.py +268 -260
  174. telegrinder/types/enums.py +711 -701
  175. telegrinder/types/input_file.py +51 -0
  176. telegrinder/types/methods.py +5055 -4633
  177. telegrinder/types/objects.py +7058 -6950
  178. telegrinder/verification_utils.py +30 -32
  179. {telegrinder-0.3.4.dist-info → telegrinder-0.4.0.dist-info}/LICENSE +22 -22
  180. telegrinder-0.4.0.dist-info/METADATA +144 -0
  181. telegrinder-0.4.0.dist-info/RECORD +182 -0
  182. {telegrinder-0.3.4.dist-info → telegrinder-0.4.0.dist-info}/WHEEL +1 -1
  183. telegrinder/bot/rules/adapter/__init__.py +0 -17
  184. telegrinder/bot/rules/adapter/abc.py +0 -31
  185. telegrinder/node/message.py +0 -14
  186. telegrinder/node/update.py +0 -15
  187. telegrinder/tools/formatting/links.py +0 -38
  188. telegrinder/tools/kb_set/__init__.py +0 -4
  189. telegrinder/tools/kb_set/base.py +0 -15
  190. telegrinder/tools/kb_set/yaml.py +0 -63
  191. telegrinder-0.3.4.dist-info/METADATA +0 -110
  192. telegrinder-0.3.4.dist-info/RECORD +0 -165
@@ -1,130 +1,134 @@
1
- import ssl
2
- import typing
3
-
4
- import aiohttp
5
- import certifi
6
- from aiohttp import ClientSession, TCPConnector
7
-
8
- import telegrinder.msgspec_json as json
9
- from telegrinder.client.abc import ABCClient
10
-
11
- if typing.TYPE_CHECKING:
12
- from aiohttp import ClientResponse
13
-
14
-
15
- class AiohttpClient(ABCClient):
16
- def __init__(
17
- self,
18
- session: ClientSession | None = None,
19
- timeout: aiohttp.ClientTimeout | None = None,
20
- **session_params: typing.Any,
21
- ) -> None:
22
- self.session = session
23
- self.session_params = session_params
24
- self.timeout = timeout or aiohttp.ClientTimeout(total=0)
25
-
26
- def __repr__(self) -> str:
27
- return "<{}: session={!r}, timeout={}, closed={}>".format(
28
- self.__class__.__name__,
29
- self.session,
30
- self.timeout,
31
- True if self.session is None else self.session.closed,
32
- )
33
-
34
- async def request_raw(
35
- self,
36
- url: str,
37
- method: str = "GET",
38
- data: dict[str, typing.Any] | None = None,
39
- **kwargs: typing.Any,
40
- ) -> "ClientResponse":
41
- if not self.session:
42
- self.session = ClientSession(
43
- connector=TCPConnector(ssl=ssl.create_default_context(cafile=certifi.where())),
44
- json_serialize=json.dumps,
45
- **self.session_params,
46
- )
47
- async with self.session.request(
48
- url=url,
49
- method=method,
50
- data=data,
51
- timeout=self.timeout,
52
- **kwargs,
53
- ) as response:
54
- await response.read()
55
- return response
56
-
57
- async def request_json(
58
- self,
59
- url: str,
60
- method: str = "GET",
61
- data: dict[str, typing.Any] | None = None,
62
- **kwargs: typing.Any,
63
- ) -> dict[str, typing.Any]:
64
- response = await self.request_raw(url, method, data, **kwargs)
65
- return await response.json(
66
- encoding="UTF-8",
67
- loads=json.loads,
68
- content_type=None,
69
- )
70
-
71
- async def request_text(
72
- self,
73
- url: str,
74
- method: str = "GET",
75
- data: dict[str, typing.Any] | aiohttp.FormData | None = None,
76
- **kwargs: typing.Any,
77
- ) -> str:
78
- response = await self.request_raw(url, method, data, **kwargs) # type: ignore
79
- return await response.text(encoding="UTF-8")
80
-
81
- async def request_bytes(
82
- self,
83
- url: str,
84
- method: str = "GET",
85
- data: dict[str, typing.Any] | aiohttp.FormData | None = None,
86
- **kwargs: typing.Any,
87
- ) -> bytes:
88
- response = await self.request_raw(url, method, data, **kwargs) # type: ignore
89
- if response._body is None:
90
- await response.read()
91
- return response._body
92
-
93
- async def request_content(
94
- self,
95
- url: str,
96
- method: str = "GET",
97
- data: dict[str, typing.Any] | None = None,
98
- **kwargs: typing.Any,
99
- ) -> bytes:
100
- response = await self.request_raw(url, method, data, **kwargs)
101
- return response._body
102
-
103
- async def close(self) -> None:
104
- if self.session and not self.session.closed:
105
- await self.session.close()
106
-
107
- @classmethod
108
- def get_form(
109
- cls,
110
- data: dict[str, typing.Any],
111
- files: dict[str, tuple[str, bytes]] | None = None,
112
- ) -> aiohttp.formdata.FormData:
113
- files = files or {}
114
- form = aiohttp.formdata.FormData(quote_fields=False)
115
- for k, v in data.items():
116
- form.add_field(k, str(v))
117
-
118
- for n, f in files.items():
119
- form.add_field(n, f[1], filename=f[0])
120
-
121
- return form
122
-
123
- def __del__(self) -> None:
124
- if self.session and not self.session.closed:
125
- if self.session._connector is not None and self.session._connector_owner:
126
- self.session._connector.close()
127
- self.session._connector = None
128
-
129
-
130
- __all__ = ("AiohttpClient",)
1
+ import ssl
2
+ import typing
3
+
4
+ import aiohttp
5
+ import certifi
6
+ from aiohttp import ClientSession, TCPConnector
7
+
8
+ import telegrinder.msgspec_json as json
9
+ from telegrinder.client.abc import ABCClient
10
+
11
+ if typing.TYPE_CHECKING:
12
+ from aiohttp import ClientResponse
13
+
14
+ type Data = dict[str, typing.Any] | aiohttp.formdata.FormData
15
+ type Response = ClientResponse
16
+
17
+
18
+ class AiohttpClient(ABCClient[aiohttp.formdata.FormData]):
19
+ """HTTP client based on `aiohttp` module."""
20
+
21
+ CONNECTION_TIMEOUT_ERRORS = (
22
+ aiohttp.client.ServerConnectionError,
23
+ TimeoutError,
24
+ )
25
+ CLIENT_CONNECTION_ERRORS = (
26
+ aiohttp.client.ClientConnectionError,
27
+ aiohttp.client.ClientConnectorError,
28
+ aiohttp.ClientOSError,
29
+ )
30
+
31
+ def __init__(
32
+ self,
33
+ session: ClientSession | None = None,
34
+ timeout: aiohttp.ClientTimeout | None = None,
35
+ **session_params: typing.Any,
36
+ ) -> None:
37
+ self.session = session
38
+ self.session_params = session_params
39
+ self.timeout = timeout or aiohttp.ClientTimeout(total=0)
40
+
41
+ def __repr__(self) -> str:
42
+ return "<{}: session={!r}, timeout={}, closed={}>".format(
43
+ self.__class__.__name__,
44
+ self.session,
45
+ self.timeout,
46
+ True if self.session is None else self.session.closed,
47
+ )
48
+
49
+ async def request_raw(
50
+ self,
51
+ url: str,
52
+ method: str = "GET",
53
+ data: Data | None = None,
54
+ **kwargs: typing.Any,
55
+ ) -> Response:
56
+ if not self.session:
57
+ self.session = ClientSession(
58
+ connector=TCPConnector(ssl=ssl.create_default_context(cafile=certifi.where())),
59
+ json_serialize=json.dumps,
60
+ **self.session_params,
61
+ )
62
+
63
+ async with self.session.request(
64
+ url=url,
65
+ method=method,
66
+ data=data,
67
+ timeout=self.timeout,
68
+ **kwargs,
69
+ ) as response:
70
+ await response.read()
71
+ return response
72
+
73
+ async def request_json(
74
+ self,
75
+ url: str,
76
+ method: str = "GET",
77
+ data: Data | None = None,
78
+ **kwargs: typing.Any,
79
+ ) -> dict[str, typing.Any]:
80
+ response = await self.request_raw(url, method, data, **kwargs)
81
+ return await response.json(
82
+ encoding="UTF-8",
83
+ loads=json.loads,
84
+ content_type=None,
85
+ )
86
+
87
+ async def request_text(
88
+ self,
89
+ url: str,
90
+ method: str = "GET",
91
+ data: Data | None = None,
92
+ **kwargs: typing.Any,
93
+ ) -> str:
94
+ response = await self.request_raw(url, method, data, **kwargs) # type: ignore
95
+ return await response.text(encoding="UTF-8")
96
+
97
+ async def request_bytes(
98
+ self,
99
+ url: str,
100
+ method: str = "GET",
101
+ data: Data | None = None,
102
+ **kwargs: typing.Any,
103
+ ) -> bytes:
104
+ response = await self.request_raw(url, method, data, **kwargs) # type: ignore
105
+ if response._body is None:
106
+ await response.read()
107
+ return response._body or bytes()
108
+
109
+ async def request_content(
110
+ self,
111
+ url: str,
112
+ method: str = "GET",
113
+ data: Data | None = None,
114
+ **kwargs: typing.Any,
115
+ ) -> bytes:
116
+ response = await self.request_raw(url, method, data, **kwargs)
117
+ return response._body or bytes()
118
+
119
+ async def close(self) -> None:
120
+ if self.session and not self.session.closed:
121
+ await self.session.close()
122
+
123
+ @classmethod
124
+ def multipart_form_factory(cls) -> aiohttp.formdata.FormData:
125
+ return aiohttp.formdata.FormData(quote_fields=False)
126
+
127
+ def __del__(self) -> None:
128
+ if self.session and not self.session.closed:
129
+ if self.session._connector is not None and self.session._connector_owner:
130
+ self.session._connector._close()
131
+ self.session._connector = None
132
+
133
+
134
+ __all__ = ("AiohttpClient",)
@@ -0,0 +1,31 @@
1
+ import typing
2
+
3
+ from telegrinder.msgspec_utils import encoder
4
+
5
+
6
+ def encode_form_data(
7
+ data: dict[str, typing.Any],
8
+ files: dict[str, tuple[str, typing.Any]],
9
+ /,
10
+ ) -> dict[str, str]:
11
+ context = dict(files=files)
12
+ return {
13
+ k: encoder.encode(v, context=context).removeprefix('"').removesuffix('"') # Remove quoted strings
14
+ if not isinstance(v, str)
15
+ else v
16
+ for k, v in data.items()
17
+ }
18
+
19
+
20
+ class MultipartFormProto(typing.Protocol):
21
+ def add_field(
22
+ self,
23
+ name: str,
24
+ value: typing.Any,
25
+ /,
26
+ *,
27
+ filename: str | None = None,
28
+ ) -> None: ...
29
+
30
+
31
+ __all__ = ("MultipartFormProto", "encode_form_data")
@@ -0,0 +1,212 @@
1
+ from __future__ import annotations
2
+
3
+ import io
4
+ import ssl
5
+ import typing
6
+
7
+ import certifi
8
+
9
+ import telegrinder.msgspec_json as json
10
+ from telegrinder.client.abc import ABCClient
11
+
12
+ if typing.TYPE_CHECKING:
13
+ from aiosonic import Connection, HTTPClient, HttpResponse, MultipartForm, Proxy, TCPConnector, Timeouts
14
+
15
+ type Data = dict[str, typing.Any] | MultipartForm
16
+ type Response = HttpResponse
17
+
18
+ AIOSONIC_OBJECTS = (
19
+ "Connection",
20
+ "HTTPClient",
21
+ "HttpResponse",
22
+ "Proxy",
23
+ "TCPConnector",
24
+ "Timeouts",
25
+ )
26
+
27
+
28
+ def init_aiosonic_module(client_class: type[ABCClient[typing.Any]], /) -> None:
29
+ try:
30
+ import aiosonic
31
+ import aiosonic.exceptions
32
+ except ImportError:
33
+ raise ImportError(
34
+ "Module 'aiosonic' is not installed. You can install as follows: pip install aiosonic"
35
+ ) from None
36
+
37
+ globalns = globals()
38
+ for name in AIOSONIC_OBJECTS:
39
+ globalns.setdefault(name, getattr(aiosonic, name))
40
+
41
+ if "MultipartForm" not in globalns:
42
+ globalns["MultipartForm"] = type("MultiPartForm", (_MultipartForm, aiosonic.MultipartForm), {})
43
+
44
+ if not client_class.CONNECTION_TIMEOUT_ERRORS:
45
+ client_class.CONNECTION_TIMEOUT_ERRORS = (
46
+ aiosonic.exceptions.ConnectTimeout,
47
+ aiosonic.exceptions.RequestTimeout,
48
+ TimeoutError,
49
+ )
50
+
51
+ if not client_class.CLIENT_CONNECTION_ERRORS:
52
+ client_class.CLIENT_CONNECTION_ERRORS = (
53
+ aiosonic.exceptions.ConnectionDisconnected,
54
+ aiosonic.exceptions.ConnectionPoolAcquireTimeout,
55
+ )
56
+
57
+
58
+ class _MultipartForm(MultipartForm if typing.TYPE_CHECKING else object):
59
+ async def _generate_chunks(self) -> typing.AsyncGenerator[bytes, None]:
60
+ for field in self.fields:
61
+ yield (f"--{self.boundary}\r\n").encode()
62
+
63
+ if isinstance(field[1], io.IOBase):
64
+ yield (
65
+ "Content-Type: application/octet-stream\r\n"
66
+ "Content-Disposition: form-data; " + f'name="{field[0]}"; filename="{field[2]}"\r\n\r\n'
67
+ ).encode()
68
+
69
+ async for data in self._read_file(field[1]):
70
+ yield data + b"\r\n"
71
+
72
+ field[1].close()
73
+ else:
74
+ yield (
75
+ "Content-Type: text/plain; charset=utf-8\r\n"
76
+ f'Content-Disposition: form-data; name="{field[0]}"\r\n\r\n'
77
+ ).encode()
78
+ yield field[1].encode() + b"\r\n"
79
+
80
+ yield (f"--{self.boundary}--").encode()
81
+
82
+ async def get_body_size(self) -> tuple[bytes, int]:
83
+ if not self.fields:
84
+ return b"", 0
85
+ return await super().get_body_size()
86
+
87
+ def get_headers(self, size: int | None = None) -> dict[str, str]:
88
+ if not self.fields:
89
+ return {"Content-Type": "application/x-www-form-urlencoded"}
90
+ return super().get_headers(size)
91
+
92
+
93
+ class AiosonicClient(ABCClient["MultipartForm"]):
94
+ """HTTP client based on `aiosonic` module."""
95
+
96
+ def __init_subclass__(cls, *args: typing.Any, **kwargs: typing.Any) -> None:
97
+ init_aiosonic_module(cls)
98
+ return super().__init_subclass__(*args, **kwargs)
99
+
100
+ def __init__(
101
+ self,
102
+ *,
103
+ verify_ssl: bool = True,
104
+ tpc_pool_size: int = 25,
105
+ tpc_timeouts: Timeouts | None = None,
106
+ proxy: Proxy | None = None,
107
+ conn_max_requests: int = 100,
108
+ use_dns_cache: bool = True,
109
+ handle_cookies: bool = False,
110
+ ttl_dns_cache: int = 10000,
111
+ **kwargs: typing.Any,
112
+ ) -> None:
113
+ init_aiosonic_module(self.__class__)
114
+ self.ssl = ssl.create_default_context(cafile=certifi.where())
115
+ self.proxy = proxy
116
+ self.verify_ssl = verify_ssl
117
+ self.handle_cookies = handle_cookies
118
+ self.tpc_timeouts = tpc_timeouts or Timeouts()
119
+ self.tcp_connector = TCPConnector(
120
+ pool_size=tpc_pool_size,
121
+ timeouts=self.tpc_timeouts,
122
+ connection_cls=Connection,
123
+ conn_max_requests=conn_max_requests,
124
+ use_dns_cache=use_dns_cache,
125
+ ttl_dns_cache=ttl_dns_cache,
126
+ **kwargs,
127
+ )
128
+ self.client: HTTPClient | None = None
129
+
130
+ def __repr__(self) -> str:
131
+ return "<{}: proxy={!r}, tpc_timeouts={!r}, tcp_connector={!r}, client={!r}>".format(
132
+ self.__class__.__name__,
133
+ self.proxy,
134
+ self.tpc_timeouts,
135
+ self.tcp_connector,
136
+ self.client,
137
+ )
138
+
139
+ @classmethod
140
+ def multipart_form_factory(cls) -> MultipartForm:
141
+ return MultipartForm()
142
+
143
+ async def request_raw(
144
+ self,
145
+ url: str,
146
+ method: str = "GET",
147
+ data: Data | None = None,
148
+ **kwargs: typing.Any,
149
+ ) -> Response:
150
+ if self.client is None:
151
+ self.client = HTTPClient(
152
+ connector=self.tcp_connector,
153
+ handle_cookies=self.handle_cookies,
154
+ verify_ssl=self.verify_ssl,
155
+ proxy=self.proxy,
156
+ )
157
+
158
+ return await self.client.request(
159
+ url=url,
160
+ method=method,
161
+ data=data,
162
+ json_serializer=json.dumps,
163
+ ssl=self.ssl,
164
+ **kwargs,
165
+ )
166
+
167
+ async def request_text(
168
+ self,
169
+ url: str,
170
+ method: str = "GET",
171
+ data: Data | None = None,
172
+ **kwargs: typing.Any,
173
+ ) -> str:
174
+ response = await self.request_raw(url, method, data, **kwargs)
175
+ return await response.text()
176
+
177
+ async def request_json(
178
+ self,
179
+ url: str,
180
+ method: str = "GET",
181
+ data: Data | None = None,
182
+ **kwargs: typing.Any,
183
+ ) -> dict[str, typing.Any]:
184
+ return json.loads(await self.request_content(url, method, data, **kwargs))
185
+
186
+ async def request_bytes(
187
+ self,
188
+ url: str,
189
+ method: str = "GET",
190
+ data: Data | None = None,
191
+ **kwargs: typing.Any,
192
+ ) -> bytes:
193
+ response = await self.request_raw(url, method, data, **kwargs)
194
+ return response.body
195
+
196
+ async def request_content(
197
+ self,
198
+ url: str,
199
+ method: str = "GET",
200
+ data: Data | None = None,
201
+ **kwargs: typing.Any,
202
+ ) -> bytes:
203
+ response = await self.request_raw(url, method, data, **kwargs)
204
+ return await response.content()
205
+
206
+ async def close(self) -> None:
207
+ if self.client is not None:
208
+ await self.client.connector.cleanup()
209
+ self.client = None
210
+
211
+
212
+ __all__ = ("AiosonicClient",)