Skip to content

Commit 78be209

Browse files
committed
Add docs
1 parent 748edd3 commit 78be209

File tree

7 files changed

+158
-60
lines changed

7 files changed

+158
-60
lines changed

docs/source/locale/ru/LC_MESSAGES/api/aiomisc.po

Lines changed: 42 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ msgid ""
66
msgstr ""
77
"Project-Id-Version: aiomisc 16.1.16\n"
88
"Report-Msgid-Bugs-To: \n"
9-
"POT-Creation-Date: 2025-03-03 15:03+0100\n"
9+
"POT-Creation-Date: 2025-07-24 00:14+0200\n"
1010
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1111
"Last-Translator: Ivan Sitkin <alvinera@yandex.ru>\n"
1212
"Language-Team: LANGUAGE <LL@li.org>\n"
@@ -604,12 +604,18 @@ msgid "Bases: :py:class:`~aiomisc.iterator_wrapper.QueueWrapperBase`"
604604
msgstr ""
605605

606606
#: aiomisc.iterator_wrapper.IteratorProxy:1 of
607-
msgid "Bases: :py:class:`~typing.AsyncIterator`"
607+
msgid ""
608+
"Bases: :py:class:`~typing.Generic`\\ "
609+
"[:py:obj:`~aiomisc.iterator_wrapper.T`], "
610+
":py:class:`~typing.AsyncIterator`"
608611
msgstr ""
609612

610613
#: aiomisc.iterator_wrapper.IteratorWrapper:1 of
611614
msgid ""
612-
"Bases: :py:class:`~typing.AsyncIterator`, "
615+
"Bases: :py:class:`~typing.Generic`\\ "
616+
"[:py:obj:`~aiomisc.iterator_wrapper.P`, "
617+
":py:obj:`~aiomisc.iterator_wrapper.T`], "
618+
":py:class:`~typing.AsyncIterator`, "
613619
":py:class:`~aiomisc.compat.EventLoopMixin`"
614620
msgstr ""
615621

@@ -864,6 +870,30 @@ msgstr ""
864870
msgid "futures. Futures that are completed or running will not be cancelled."
865871
msgstr ""
866872

873+
#: aiomisc.thread_pool.Threaded:1 aiomisc.thread_pool.ThreadedIterable:1 of
874+
msgid ""
875+
"Bases: :py:class:`~typing.Generic`\\ [:py:obj:`~aiomisc.thread_pool.P`, "
876+
":py:obj:`~aiomisc.thread_pool.T`]"
877+
msgstr ""
878+
879+
#: aiomisc.thread_pool.ThreadedIterableSeparate:1 of
880+
msgid ""
881+
"Bases: :py:class:`~aiomisc.thread_pool.ThreadedIterable`\\ "
882+
"[:py:obj:`~aiomisc.thread_pool.P`, :py:obj:`~aiomisc.thread_pool.T`]"
883+
msgstr ""
884+
885+
#: aiomisc.thread_pool.ThreadedSeparate:1 of
886+
msgid ""
887+
"Bases: :py:class:`~aiomisc.thread_pool.Threaded`\\ "
888+
"[:py:obj:`~aiomisc.thread_pool.P`, :py:obj:`~aiomisc.thread_pool.T`]"
889+
msgstr ""
890+
891+
#: aiomisc.thread_pool.ThreadedSeparate:1 of
892+
msgid ""
893+
"A decorator to run a function in a separate thread. It returns an "
894+
"`asyncio.Future` that can be awaited."
895+
msgstr ""
896+
867897
#: aiomisc.thread_pool.WorkItem:1 of
868898
msgid "Bases: :py:class:`~aiomisc.thread_pool.WorkItemBase`"
869899
msgstr ""
@@ -1283,3 +1313,12 @@ msgstr "Модуль ``aiomisc.worker_pool``"
12831313
#~ "\n"
12841314
#~ "asyncio.run(main())"
12851315
#~ msgstr ""
1316+
1317+
#~ msgid "Bases: :py:class:`~typing.AsyncIterator`"
1318+
#~ msgstr ""
1319+
1320+
#~ msgid ""
1321+
#~ "Bases: :py:class:`~typing.AsyncIterator`, "
1322+
#~ ":py:class:`~aiomisc.compat.EventLoopMixin`"
1323+
#~ msgstr ""
1324+

docs/source/locale/ru/LC_MESSAGES/index.po

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -201,7 +201,6 @@ msgid "``pip install aiomisc[uvicorn]``"
201201
msgstr ""
202202

203203
#: ../../source/index.rst:101
204-
#, fuzzy
205204
msgid "For running ASGI_ application using uvicorn_"
206205
msgstr "Для запуска ASGI_ приложений через uvicorn_"
207206

docs/source/locale/ru/LC_MESSAGES/logging.po

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -221,13 +221,12 @@ msgid "Buffered log handler"
221221
msgstr "Буфферизирующий лог-хендлер"
222222

223223
#: ../../source/logging.rst:137
224-
#, fuzzy
225224
msgid ""
226225
"Parameter `buffered=True` enables a memory buffer that flushes logs in a "
227226
"thread. In case the `handlers=` each will be buffered."
228227
msgstr ""
229228
"Параметр `buffered=True` включает буферизацию логов в памяти, отдельный "
230-
"поток переодически сбрасывает логи в файловый дескриптор."
229+
"поток переодически сбрасывает логи в файловый дескриптор. В случае `handlers=` все станут буферизированными."
231230

232231
#: ../../source/logging.rst:140
233232
#, python-format

docs/source/locale/ru/LC_MESSAGES/plugins.po

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,6 @@ msgstr ""
8282
"параметре services."
8383

8484
#: ../../source/plugins.rst:40
85-
#, fuzzy
8685
msgid ""
8786
"# Content of: ``aiomisc_myplugin/plugin.py``\n"
8887
"from typing import Tuple\n"
@@ -144,36 +143,36 @@ msgstr ""
144143
"\n"
145144
"\n"
146145
"event = Event()\n"
147-
"# Будет показываться при вызове ``python -m aiomisc.plugins``\n"
148-
"__doc__ = \"Example plugin\"\n"
146+
"# Будет показано в ``python -m aiomisc.plugins``\n"
147+
"__doc__ = \"Пример плагина\"\n"
149148
"\n"
150149
"\n"
151150
"async def hello(\n"
152151
" *,\n"
153152
" entrypoint: aiomisc.Entrypoint,\n"
154153
" services: Tuple[aiomisc.Service, ...]\n"
155154
") -> None:\n"
156-
" print('Привет от плагина aiomisc')\n"
155+
" print('Hello from aiomisc plugin')\n"
157156
" event.set()\n"
158157
"\n"
159158
"\n"
160159
"def setup() -> None:\n"
161160
" \"\"\"\n"
162-
" Этот код будет вызван при загрузке плагинов описанных в \n"
161+
" Этот код будет вызван при загрузке плагинов, объявленных в\n"
163162
" ``pyproject.toml`` или ``setup.py``.\n"
164163
" \"\"\"\n"
165164
" aiomisc.Entrypoint.PRE_START.connect(hello)\n"
166165
"\n"
167166
"# Содержимое: ``my_plugin_example.py``\n"
168167
"# ======================================================================\n"
169-
"# Код представленный ниже, не имеет отношения к плагину, и служит\n"
170-
"# для демонстрации работы.\n"
168+
"# Код ниже не относится к плагину, а служит для демонстрации\n"
169+
"# его работы.\n"
171170
"# ======================================================================\n"
172171
"def main():\n"
173-
" \"\"\" какая-то пользовательская функция \"\"\"\n"
172+
" \"\"\" некоторая функция в пользовательском коде \"\"\"\n"
174173
"\n"
175174
" # Эта функция будет вызвана модулем aiomisc.plugin\n"
176-
" # здесь, вызовем её чисто для демонстрации того как это работает.\n"
175+
" # в этом примере только для демонстрации.\n"
177176
" setup()\n"
178177
"\n"
179178
" assert not event.is_set()\n"
@@ -183,7 +182,10 @@ msgstr ""
183182
"\n"
184183
" assert event.is_set()\n"
185184
"\n"
186-
"main()"
185+
"main()\n"
186+
"\n"
187+
"# удаление плагина, когда он больше не нужен\n"
188+
"aiomisc.entrypoint.PRE_START.disconnect(hello)"
187189

188190
#: ../../source/plugins.rst:96
189191
msgid "The following signals are available in total:"

docs/source/locale/ru/LC_MESSAGES/services.po

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -522,9 +522,8 @@ msgstr ""
522522
" loop.run_forever()"
523523

524524
#: ../../source/services.rst:393
525-
#, fuzzy
526525
msgid "DNS Server"
527-
msgstr "asgi сервис"
526+
msgstr "DNS сервис"
528527

529528
#: ../../source/services.rst:395
530529
msgid ""
@@ -1333,12 +1332,10 @@ msgstr ""
13331332
"``TLSServer``)."
13341333

13351334
#: ../../source/services.rst:999
1336-
#, fuzzy
13371335
msgid "uvicorn service"
1338-
msgstr "Uvicorn сервис"
1336+
msgstr "uvicorn сервис"
13391337

13401338
#: ../../source/services.rst:1003
1341-
#, fuzzy
13421339
msgid "requires installed uvicorn:"
13431340
msgstr "необходимо установить библиотеку uvicorn_:"
13441341

@@ -1351,7 +1348,6 @@ msgid "pip install aiomisc[uvicorn]"
13511348
msgstr ""
13521349

13531350
#: ../../source/services.rst:1016
1354-
#, fuzzy
13551351
msgid "Any ASGI-like application can be started via uvicorn as a service:"
13561352
msgstr ""
13571353
"Любое ASGI совместимое приложение может быть запущено через uvicorn как "
@@ -1396,7 +1392,6 @@ msgid ""
13961392
msgstr ""
13971393

13981394
#: ../../source/services.rst:1061
1399-
#, fuzzy
14001395
msgid "GRPC service"
14011396
msgstr "GRPC сервис"
14021397

0 commit comments

Comments
 (0)