telegrinder 0.3.3.post1__py3-none-any.whl → 0.3.4.post1__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 (165) hide show
  1. telegrinder/__init__.py +144 -144
  2. telegrinder/api/__init__.py +8 -8
  3. telegrinder/api/api.py +93 -93
  4. telegrinder/api/error.py +16 -16
  5. telegrinder/api/response.py +20 -20
  6. telegrinder/api/token.py +36 -36
  7. telegrinder/bot/__init__.py +66 -66
  8. telegrinder/bot/bot.py +76 -76
  9. telegrinder/bot/cute_types/__init__.py +17 -17
  10. telegrinder/bot/cute_types/base.py +258 -258
  11. telegrinder/bot/cute_types/callback_query.py +385 -385
  12. telegrinder/bot/cute_types/chat_join_request.py +61 -61
  13. telegrinder/bot/cute_types/chat_member_updated.py +160 -160
  14. telegrinder/bot/cute_types/inline_query.py +43 -43
  15. telegrinder/bot/cute_types/message.py +2637 -2637
  16. telegrinder/bot/cute_types/update.py +104 -109
  17. telegrinder/bot/cute_types/utils.py +95 -95
  18. telegrinder/bot/dispatch/__init__.py +55 -55
  19. telegrinder/bot/dispatch/abc.py +77 -77
  20. telegrinder/bot/dispatch/context.py +98 -98
  21. telegrinder/bot/dispatch/dispatch.py +202 -202
  22. telegrinder/bot/dispatch/handler/__init__.py +13 -13
  23. telegrinder/bot/dispatch/handler/abc.py +24 -24
  24. telegrinder/bot/dispatch/handler/audio_reply.py +44 -44
  25. telegrinder/bot/dispatch/handler/base.py +57 -57
  26. telegrinder/bot/dispatch/handler/document_reply.py +44 -44
  27. telegrinder/bot/dispatch/handler/func.py +135 -135
  28. telegrinder/bot/dispatch/handler/media_group_reply.py +43 -43
  29. telegrinder/bot/dispatch/handler/message_reply.py +36 -36
  30. telegrinder/bot/dispatch/handler/photo_reply.py +44 -44
  31. telegrinder/bot/dispatch/handler/sticker_reply.py +37 -37
  32. telegrinder/bot/dispatch/handler/video_reply.py +44 -44
  33. telegrinder/bot/dispatch/middleware/__init__.py +3 -3
  34. telegrinder/bot/dispatch/middleware/abc.py +22 -16
  35. telegrinder/bot/dispatch/process.py +157 -132
  36. telegrinder/bot/dispatch/return_manager/__init__.py +13 -13
  37. telegrinder/bot/dispatch/return_manager/abc.py +108 -108
  38. telegrinder/bot/dispatch/return_manager/callback_query.py +20 -20
  39. telegrinder/bot/dispatch/return_manager/inline_query.py +15 -15
  40. telegrinder/bot/dispatch/return_manager/message.py +36 -36
  41. telegrinder/bot/dispatch/view/__init__.py +13 -13
  42. telegrinder/bot/dispatch/view/abc.py +41 -41
  43. telegrinder/bot/dispatch/view/base.py +200 -200
  44. telegrinder/bot/dispatch/view/box.py +129 -129
  45. telegrinder/bot/dispatch/view/callback_query.py +17 -17
  46. telegrinder/bot/dispatch/view/chat_join_request.py +16 -16
  47. telegrinder/bot/dispatch/view/chat_member.py +39 -39
  48. telegrinder/bot/dispatch/view/inline_query.py +17 -17
  49. telegrinder/bot/dispatch/view/message.py +44 -44
  50. telegrinder/bot/dispatch/view/raw.py +114 -114
  51. telegrinder/bot/dispatch/waiter_machine/__init__.py +17 -17
  52. telegrinder/bot/dispatch/waiter_machine/actions.py +13 -13
  53. telegrinder/bot/dispatch/waiter_machine/hasher/__init__.py +8 -8
  54. telegrinder/bot/dispatch/waiter_machine/hasher/callback.py +55 -55
  55. telegrinder/bot/dispatch/waiter_machine/hasher/hasher.py +57 -57
  56. telegrinder/bot/dispatch/waiter_machine/hasher/message.py +51 -51
  57. telegrinder/bot/dispatch/waiter_machine/hasher/state.py +19 -19
  58. telegrinder/bot/dispatch/waiter_machine/machine.py +172 -167
  59. telegrinder/bot/dispatch/waiter_machine/middleware.py +89 -89
  60. telegrinder/bot/dispatch/waiter_machine/short_state.py +68 -68
  61. telegrinder/bot/polling/__init__.py +4 -4
  62. telegrinder/bot/polling/abc.py +25 -25
  63. telegrinder/bot/polling/polling.py +131 -131
  64. telegrinder/bot/rules/__init__.py +62 -62
  65. telegrinder/bot/rules/abc.py +213 -213
  66. telegrinder/bot/rules/adapter/__init__.py +12 -9
  67. telegrinder/bot/rules/adapter/abc.py +31 -29
  68. telegrinder/bot/rules/adapter/errors.py +5 -5
  69. telegrinder/bot/rules/adapter/event.py +65 -67
  70. telegrinder/bot/rules/adapter/node.py +48 -48
  71. telegrinder/bot/rules/adapter/raw_event.py +27 -0
  72. telegrinder/bot/rules/adapter/raw_update.py +30 -30
  73. telegrinder/bot/rules/callback_data.py +170 -170
  74. telegrinder/bot/rules/chat_join.py +46 -46
  75. telegrinder/bot/rules/command.py +126 -126
  76. telegrinder/bot/rules/enum_text.py +36 -36
  77. telegrinder/bot/rules/func.py +26 -26
  78. telegrinder/bot/rules/fuzzy.py +24 -24
  79. telegrinder/bot/rules/inline.py +60 -60
  80. telegrinder/bot/rules/integer.py +20 -20
  81. telegrinder/bot/rules/is_from.py +127 -127
  82. telegrinder/bot/rules/markup.py +43 -43
  83. telegrinder/bot/rules/mention.py +14 -14
  84. telegrinder/bot/rules/message.py +17 -17
  85. telegrinder/bot/rules/message_entities.py +35 -35
  86. telegrinder/bot/rules/node.py +27 -27
  87. telegrinder/bot/rules/regex.py +37 -37
  88. telegrinder/bot/rules/rule_enum.py +72 -72
  89. telegrinder/bot/rules/start.py +42 -42
  90. telegrinder/bot/rules/state.py +37 -37
  91. telegrinder/bot/rules/text.py +33 -33
  92. telegrinder/bot/rules/update.py +15 -15
  93. telegrinder/bot/scenario/__init__.py +5 -5
  94. telegrinder/bot/scenario/abc.py +19 -19
  95. telegrinder/bot/scenario/checkbox.py +176 -167
  96. telegrinder/bot/scenario/choice.py +51 -46
  97. telegrinder/client/__init__.py +4 -4
  98. telegrinder/client/abc.py +75 -75
  99. telegrinder/client/aiohttp.py +130 -130
  100. telegrinder/model.py +320 -295
  101. telegrinder/modules.py +237 -237
  102. telegrinder/msgspec_json.py +14 -14
  103. telegrinder/msgspec_utils.py +410 -410
  104. telegrinder/node/__init__.py +0 -0
  105. telegrinder/node/attachment.py +87 -87
  106. telegrinder/node/base.py +166 -166
  107. telegrinder/node/callback_query.py +53 -53
  108. telegrinder/node/command.py +33 -33
  109. telegrinder/node/composer.py +198 -198
  110. telegrinder/node/container.py +27 -27
  111. telegrinder/node/event.py +65 -65
  112. telegrinder/node/me.py +16 -16
  113. telegrinder/node/message.py +14 -14
  114. telegrinder/node/polymorphic.py +48 -48
  115. telegrinder/node/rule.py +76 -76
  116. telegrinder/node/scope.py +38 -38
  117. telegrinder/node/source.py +71 -71
  118. telegrinder/node/text.py +41 -41
  119. telegrinder/node/tools/__init__.py +3 -3
  120. telegrinder/node/tools/generator.py +40 -40
  121. telegrinder/node/update.py +15 -15
  122. telegrinder/rules.py +0 -0
  123. telegrinder/tools/__init__.py +74 -74
  124. telegrinder/tools/buttons.py +79 -79
  125. telegrinder/tools/error_handler/__init__.py +7 -7
  126. telegrinder/tools/error_handler/abc.py +33 -33
  127. telegrinder/tools/error_handler/error.py +9 -9
  128. telegrinder/tools/error_handler/error_handler.py +193 -193
  129. telegrinder/tools/formatting/__init__.py +46 -46
  130. telegrinder/tools/formatting/html.py +283 -283
  131. telegrinder/tools/formatting/links.py +33 -33
  132. telegrinder/tools/formatting/spec_html_formats.py +111 -111
  133. telegrinder/tools/functional.py +12 -12
  134. telegrinder/tools/global_context/__init__.py +7 -7
  135. telegrinder/tools/global_context/abc.py +63 -63
  136. telegrinder/tools/global_context/global_context.py +412 -412
  137. telegrinder/tools/global_context/telegrinder_ctx.py +27 -27
  138. telegrinder/tools/i18n/__init__.py +7 -7
  139. telegrinder/tools/i18n/abc.py +30 -30
  140. telegrinder/tools/i18n/middleware/__init__.py +3 -3
  141. telegrinder/tools/i18n/middleware/abc.py +25 -25
  142. telegrinder/tools/i18n/simple.py +43 -43
  143. telegrinder/tools/kb_set/__init__.py +4 -4
  144. telegrinder/tools/kb_set/base.py +15 -15
  145. telegrinder/tools/kb_set/yaml.py +63 -63
  146. telegrinder/tools/keyboard.py +132 -132
  147. telegrinder/tools/limited_dict.py +37 -37
  148. telegrinder/tools/loop_wrapper/__init__.py +4 -4
  149. telegrinder/tools/loop_wrapper/abc.py +15 -15
  150. telegrinder/tools/loop_wrapper/loop_wrapper.py +224 -224
  151. telegrinder/tools/magic.py +157 -157
  152. telegrinder/tools/parse_mode.py +6 -6
  153. telegrinder/tools/state_storage/__init__.py +4 -4
  154. telegrinder/tools/state_storage/abc.py +35 -35
  155. telegrinder/tools/state_storage/memory.py +25 -25
  156. telegrinder/types/__init__.py +260 -260
  157. telegrinder/types/enums.py +701 -701
  158. telegrinder/types/methods.py +4633 -4633
  159. telegrinder/types/objects.py +6950 -8561
  160. telegrinder/verification_utils.py +32 -32
  161. {telegrinder-0.3.3.post1.dist-info → telegrinder-0.3.4.post1.dist-info}/LICENSE +22 -22
  162. {telegrinder-0.3.3.post1.dist-info → telegrinder-0.3.4.post1.dist-info}/METADATA +1 -1
  163. telegrinder-0.3.4.post1.dist-info/RECORD +165 -0
  164. telegrinder-0.3.3.post1.dist-info/RECORD +0 -164
  165. {telegrinder-0.3.3.post1.dist-info → telegrinder-0.3.4.post1.dist-info}/WHEEL +0 -0
@@ -1,77 +1,77 @@
1
- import importlib.util as importlib_util
2
- import os
3
- import pathlib
4
- import sys
5
- import typing
6
- from abc import ABC, abstractmethod
7
-
8
- from fntypes.option import Option
9
-
10
- from telegrinder.api.api import API
11
- from telegrinder.tools.global_context.abc import ABCGlobalContext
12
- from telegrinder.types.objects import Update
13
-
14
- T = typing.TypeVar("T")
15
-
16
-
17
- class PathExistsError(BaseException):
18
- pass
19
-
20
-
21
- class ABCDispatch(ABC):
22
- @property
23
- @abstractmethod
24
- def global_context(self) -> ABCGlobalContext:
25
- pass
26
-
27
- @abstractmethod
28
- async def feed(self, event: Update, api: API) -> bool:
29
- pass
30
-
31
- @abstractmethod
32
- def load(self, external: typing.Self) -> None:
33
- pass
34
-
35
- @abstractmethod
36
- def get_view(self, of_type: type[T]) -> Option[T]:
37
- pass
38
-
39
- def load_many(self, *externals: typing.Self) -> None:
40
- for external in externals:
41
- self.load(external)
42
-
43
- def load_from_dir(self, directory: str | pathlib.Path) -> bool:
44
- """Loads dispatchers from a directory containing Python modules where global variables
45
- are declared with instances of dispatch.
46
- Returns True if dispatchers were found, otherwise False."""
47
-
48
- directory = pathlib.Path(directory)
49
-
50
- if not directory.exists():
51
- raise PathExistsError(f"Path {str(directory)!r} does not exists.")
52
-
53
- dps: list[typing.Self] = []
54
- for root, _, files in os.walk(directory):
55
- for f in files:
56
- if f.endswith(".py") and f != "__init__.py":
57
- module_path = os.path.join(root, f)
58
- module_name = os.path.splitext(os.path.relpath(module_path, directory))[0]
59
- module_name = module_name.replace(os.sep, ".")
60
-
61
- spec = importlib_util.spec_from_file_location(module_name, module_path)
62
- if spec is None or spec.loader is None:
63
- continue
64
-
65
- module = importlib_util.module_from_spec(spec)
66
- sys.modules[module_name] = module
67
- spec.loader.exec_module(module)
68
-
69
- for obj in module.__dict__.values():
70
- if isinstance(obj, self.__class__):
71
- dps.append(obj)
72
-
73
- self.load_many(*dps)
74
- return bool(dps)
75
-
76
-
77
- __all__ = ("ABCDispatch",)
1
+ import importlib.util as importlib_util
2
+ import os
3
+ import pathlib
4
+ import sys
5
+ import typing
6
+ from abc import ABC, abstractmethod
7
+
8
+ from fntypes.option import Option
9
+
10
+ from telegrinder.api.api import API
11
+ from telegrinder.tools.global_context.abc import ABCGlobalContext
12
+ from telegrinder.types.objects import Update
13
+
14
+ T = typing.TypeVar("T")
15
+
16
+
17
+ class PathExistsError(BaseException):
18
+ pass
19
+
20
+
21
+ class ABCDispatch(ABC):
22
+ @property
23
+ @abstractmethod
24
+ def global_context(self) -> ABCGlobalContext:
25
+ pass
26
+
27
+ @abstractmethod
28
+ async def feed(self, event: Update, api: API) -> bool:
29
+ pass
30
+
31
+ @abstractmethod
32
+ def load(self, external: typing.Self) -> None:
33
+ pass
34
+
35
+ @abstractmethod
36
+ def get_view(self, of_type: type[T]) -> Option[T]:
37
+ pass
38
+
39
+ def load_many(self, *externals: typing.Self) -> None:
40
+ for external in externals:
41
+ self.load(external)
42
+
43
+ def load_from_dir(self, directory: str | pathlib.Path) -> bool:
44
+ """Loads dispatchers from a directory containing Python modules where global variables
45
+ are declared with instances of dispatch.
46
+ Returns True if dispatchers were found, otherwise False."""
47
+
48
+ directory = pathlib.Path(directory)
49
+
50
+ if not directory.exists():
51
+ raise PathExistsError(f"Path {str(directory)!r} does not exists.")
52
+
53
+ dps: list[typing.Self] = []
54
+ for root, _, files in os.walk(directory):
55
+ for f in files:
56
+ if f.endswith(".py") and f != "__init__.py":
57
+ module_path = os.path.join(root, f)
58
+ module_name = os.path.splitext(os.path.relpath(module_path, directory))[0]
59
+ module_name = module_name.replace(os.sep, ".")
60
+
61
+ spec = importlib_util.spec_from_file_location(module_name, module_path)
62
+ if spec is None or spec.loader is None:
63
+ continue
64
+
65
+ module = importlib_util.module_from_spec(spec)
66
+ sys.modules[module_name] = module
67
+ spec.loader.exec_module(module)
68
+
69
+ for obj in module.__dict__.values():
70
+ if isinstance(obj, self.__class__):
71
+ dps.append(obj)
72
+
73
+ self.load_many(*dps)
74
+ return bool(dps)
75
+
76
+
77
+ __all__ = ("ABCDispatch",)
@@ -1,98 +1,98 @@
1
- from __future__ import annotations
2
-
3
- import enum
4
- import typing
5
- from reprlib import recursive_repr
6
-
7
- from telegrinder.types.objects import Update
8
-
9
- if typing.TYPE_CHECKING:
10
- from telegrinder.node.composer import NodeCollection
11
-
12
- T = typing.TypeVar("T")
13
-
14
- Key: typing.TypeAlias = str | enum.Enum
15
- AnyValue: typing.TypeAlias = typing.Any
16
-
17
-
18
- class Context(dict[str, AnyValue]):
19
- """Context class like dict & dotdict.
20
-
21
- For example:
22
- ```python
23
- class MyRule(ABCRule[T]):
24
- async def check(self, event: T, ctx: Context) -> bool:
25
- ctx.me = (await event.ctx_api.get_me()).unwrap()
26
- ctx["items"] = [1, 2, 3]
27
- return True
28
- ```
29
- """
30
-
31
- raw_update: Update
32
- node_col: NodeCollection | None = None
33
-
34
- def __init__(self, **kwargs: AnyValue) -> None:
35
- cls_vars = vars(self.__class__)
36
- defaults = {}
37
-
38
- for k in self.__class__.__annotations__:
39
- if k in cls_vars:
40
- defaults[k] = cls_vars[k]
41
- delattr(self.__class__, k)
42
-
43
- dict.__init__(self, **defaults | kwargs)
44
-
45
- @recursive_repr()
46
- def __repr__(self) -> str:
47
- return "{}({})".format(self.__class__.__name__, ", ".join(f"{k}={v!r}" for k, v in self.items()))
48
-
49
- def __setitem__(self, __key: Key, __value: AnyValue) -> None:
50
- dict.__setitem__(self, self.key_to_str(__key), __value)
51
-
52
- def __getitem__(self, __key: Key) -> AnyValue:
53
- return dict.__getitem__(self, self.key_to_str(__key))
54
-
55
- def __delitem__(self, __key: Key) -> None:
56
- dict.__delitem__(self, self.key_to_str(__key))
57
-
58
- def __setattr__(self, __name: str, __value: AnyValue) -> None:
59
- self.__setitem__(__name, __value)
60
-
61
- def __getattr__(self, __name: str) -> AnyValue:
62
- return self.__getitem__(__name)
63
-
64
- def __delattr__(self, __name: str) -> None:
65
- self.__delitem__(__name)
66
-
67
- @staticmethod
68
- def key_to_str(key: Key) -> str:
69
- return key if isinstance(key, str) else str(key.value)
70
-
71
- def copy(self) -> typing.Self:
72
- return self.__class__(**dict.copy(self))
73
-
74
- def set(self, key: Key, value: AnyValue) -> None:
75
- self[key] = value
76
-
77
- @typing.overload
78
- def get(self, key: Key) -> AnyValue | None: ...
79
-
80
- @typing.overload
81
- def get(self, key: Key, default: T) -> T | AnyValue: ...
82
-
83
- @typing.overload
84
- def get(self, key: Key, default: None = None) -> AnyValue | None: ...
85
-
86
- def get(self, key: Key, default: T | None = None) -> T | AnyValue | None:
87
- return dict.get(self, key, default)
88
-
89
- def get_or_set(self, key: Key, default: T) -> T:
90
- if key not in self:
91
- self.set(key, default)
92
- return self.get(key, default)
93
-
94
- def delete(self, key: Key) -> None:
95
- del self[key]
96
-
97
-
98
- __all__ = ("Context",)
1
+ from __future__ import annotations
2
+
3
+ import enum
4
+ import typing
5
+ from reprlib import recursive_repr
6
+
7
+ from telegrinder.types.objects import Update
8
+
9
+ if typing.TYPE_CHECKING:
10
+ from telegrinder.node.composer import NodeCollection
11
+
12
+ T = typing.TypeVar("T")
13
+
14
+ Key: typing.TypeAlias = str | enum.Enum
15
+ AnyValue: typing.TypeAlias = typing.Any
16
+
17
+
18
+ class Context(dict[str, AnyValue]):
19
+ """Context class like dict & dotdict.
20
+
21
+ For example:
22
+ ```python
23
+ class MyRule(ABCRule[T]):
24
+ async def check(self, event: T, ctx: Context) -> bool:
25
+ ctx.me = (await event.ctx_api.get_me()).unwrap()
26
+ ctx["items"] = [1, 2, 3]
27
+ return True
28
+ ```
29
+ """
30
+
31
+ raw_update: Update
32
+ node_col: NodeCollection | None = None
33
+
34
+ def __init__(self, **kwargs: AnyValue) -> None:
35
+ cls_vars = vars(self.__class__)
36
+ defaults = {}
37
+
38
+ for k in self.__class__.__annotations__:
39
+ if k in cls_vars:
40
+ defaults[k] = cls_vars[k]
41
+ delattr(self.__class__, k)
42
+
43
+ dict.__init__(self, **defaults | kwargs)
44
+
45
+ @recursive_repr()
46
+ def __repr__(self) -> str:
47
+ return "{}({})".format(self.__class__.__name__, ", ".join(f"{k}={v!r}" for k, v in self.items()))
48
+
49
+ def __setitem__(self, __key: Key, __value: AnyValue) -> None:
50
+ dict.__setitem__(self, self.key_to_str(__key), __value)
51
+
52
+ def __getitem__(self, __key: Key) -> AnyValue:
53
+ return dict.__getitem__(self, self.key_to_str(__key))
54
+
55
+ def __delitem__(self, __key: Key) -> None:
56
+ dict.__delitem__(self, self.key_to_str(__key))
57
+
58
+ def __setattr__(self, __name: str, __value: AnyValue) -> None:
59
+ self.__setitem__(__name, __value)
60
+
61
+ def __getattr__(self, __name: str) -> AnyValue:
62
+ return self.__getitem__(__name)
63
+
64
+ def __delattr__(self, __name: str) -> None:
65
+ self.__delitem__(__name)
66
+
67
+ @staticmethod
68
+ def key_to_str(key: Key) -> str:
69
+ return key if isinstance(key, str) else str(key.value)
70
+
71
+ def copy(self) -> typing.Self:
72
+ return self.__class__(**dict.copy(self))
73
+
74
+ def set(self, key: Key, value: AnyValue) -> None:
75
+ self[key] = value
76
+
77
+ @typing.overload
78
+ def get(self, key: Key) -> AnyValue | None: ...
79
+
80
+ @typing.overload
81
+ def get(self, key: Key, default: T) -> T | AnyValue: ...
82
+
83
+ @typing.overload
84
+ def get(self, key: Key, default: None = None) -> AnyValue | None: ...
85
+
86
+ def get(self, key: Key, default: T | None = None) -> T | AnyValue | None:
87
+ return dict.get(self, key, default)
88
+
89
+ def get_or_set(self, key: Key, default: T) -> T:
90
+ if key not in self:
91
+ self.set(key, default)
92
+ return self.get(key, default)
93
+
94
+ def delete(self, key: Key) -> None:
95
+ del self[key]
96
+
97
+
98
+ __all__ = ("Context",)