Add docs

Author: mosquito

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

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: aiomisc 16.1.16\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-03-03 15:03+0100\n"
+"POT-Creation-Date: 2025-07-24 00:14+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: Ivan Sitkin <[email protected]>\n"
 "Language-Team: LANGUAGE <[email protected]>\n"
@@ -604,12 +604,18 @@ msgid "Bases: :py:class:`~aiomisc.iterator_wrapper.QueueWrapperBase`"
 msgstr ""
 
 #: aiomisc.iterator_wrapper.IteratorProxy:1 of
-msgid "Bases: :py:class:`~typing.AsyncIterator`"
+msgid ""
+"Bases: :py:class:`~typing.Generic`\\ "
+"[:py:obj:`~aiomisc.iterator_wrapper.T`], "
+":py:class:`~typing.AsyncIterator`"
 msgstr ""
 
 #: aiomisc.iterator_wrapper.IteratorWrapper:1 of
 msgid ""
-"Bases: :py:class:`~typing.AsyncIterator`, "
+"Bases: :py:class:`~typing.Generic`\\ "
+"[:py:obj:`~aiomisc.iterator_wrapper.P`, "
+":py:obj:`~aiomisc.iterator_wrapper.T`], "
+":py:class:`~typing.AsyncIterator`, "
 ":py:class:`~aiomisc.compat.EventLoopMixin`"
 msgstr ""
 
@@ -864,6 +870,30 @@ msgstr ""
 msgid "futures. Futures that are completed or running will not be cancelled."
 msgstr ""
 
+#: aiomisc.thread_pool.Threaded:1 aiomisc.thread_pool.ThreadedIterable:1 of
+msgid ""
+"Bases: :py:class:`~typing.Generic`\\ [:py:obj:`~aiomisc.thread_pool.P`, "
+":py:obj:`~aiomisc.thread_pool.T`]"
+msgstr ""
+
+#: aiomisc.thread_pool.ThreadedIterableSeparate:1 of
+msgid ""
+"Bases: :py:class:`~aiomisc.thread_pool.ThreadedIterable`\\ "
+"[:py:obj:`~aiomisc.thread_pool.P`, :py:obj:`~aiomisc.thread_pool.T`]"
+msgstr ""
+
+#: aiomisc.thread_pool.ThreadedSeparate:1 of
+msgid ""
+"Bases: :py:class:`~aiomisc.thread_pool.Threaded`\\ "
+"[:py:obj:`~aiomisc.thread_pool.P`, :py:obj:`~aiomisc.thread_pool.T`]"
+msgstr ""
+
+#: aiomisc.thread_pool.ThreadedSeparate:1 of
+msgid ""
+"A decorator to run a function in a separate thread. It returns an "
+"`asyncio.Future` that can be awaited."
+msgstr ""
+
 #: aiomisc.thread_pool.WorkItem:1 of
 msgid "Bases: :py:class:`~aiomisc.thread_pool.WorkItemBase`"
 msgstr ""
@@ -1283,3 +1313,12 @@ msgstr "Модуль ``aiomisc.worker_pool``"
 #~ "\n"
 #~ "asyncio.run(main())"
 #~ msgstr ""
+
+#~ msgid "Bases: :py:class:`~typing.AsyncIterator`"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Bases: :py:class:`~typing.AsyncIterator`, "
+#~ ":py:class:`~aiomisc.compat.EventLoopMixin`"
+#~ msgstr ""
+

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

@@ -201,7 +201,6 @@ msgid "``pip install aiomisc[uvicorn]``"
 msgstr ""
 
 #: ../../source/index.rst:101
-#, fuzzy
 msgid "For running ASGI_ application using uvicorn_"
 msgstr "Для запуска ASGI_ приложений через uvicorn_"
 

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

@@ -221,13 +221,12 @@ msgid "Buffered log handler"
 msgstr "Буфферизирующий лог-хендлер"
 
 #: ../../source/logging.rst:137
-#, fuzzy
 msgid ""
 "Parameter `buffered=True` enables a memory buffer that flushes logs in a "
 "thread. In case the `handlers=` each will be buffered."
 msgstr ""
 "Параметр `buffered=True` включает буферизацию логов в памяти, отдельный "
-"поток переодически сбрасывает логи в файловый дескриптор."
+"поток переодически сбрасывает логи в файловый дескриптор. В случае `handlers=` все станут буферизированными."
 
 #: ../../source/logging.rst:140
 #, python-format

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

@@ -82,7 +82,6 @@ msgstr ""
 "параметре services."
 
 #: ../../source/plugins.rst:40
-#, fuzzy
 msgid ""
 "# Content of: ``aiomisc_myplugin/plugin.py``\n"
 "from typing import Tuple\n"
@@ -144,36 +143,36 @@ msgstr ""
 "\n"
 "\n"
 "event = Event()\n"
-"# Будет показываться при вызове ``python -m aiomisc.plugins``\n"
-"__doc__ = \"Example plugin\"\n"
+"# Будет показано в ``python -m aiomisc.plugins``\n"
+"__doc__ = \"Пример плагина\"\n"
 "\n"
 "\n"
 "async def hello(\n"
 "    *,\n"
 "    entrypoint: aiomisc.Entrypoint,\n"
 "    services: Tuple[aiomisc.Service, ...]\n"
 ") -> None:\n"
-"    print('Привет от плагина aiomisc')\n"
+"    print('Hello from aiomisc plugin')\n"
 "    event.set()\n"
 "\n"
 "\n"
 "def setup() -> None:\n"
 "    \"\"\"\n"
-"    Этот код будет вызван при загрузке плагинов описанных в \n"
+"    Этот код будет вызван при загрузке плагинов, объявленных в\n"
 "    ``pyproject.toml`` или ``setup.py``.\n"
 "    \"\"\"\n"
 "    aiomisc.Entrypoint.PRE_START.connect(hello)\n"
 "\n"
 "# Содержимое: ``my_plugin_example.py``\n"
 "# ======================================================================\n"
-"# Код представленный ниже, не имеет отношения к плагину, и служит\n"
-"# для демонстрации работы.\n"
+"# Код ниже не относится к плагину, а служит для демонстрации\n"
+"# его работы.\n"
 "# ======================================================================\n"
 "def main():\n"
-"    \"\"\" какая-то пользовательская функция \"\"\"\n"
+"    \"\"\" некоторая функция в пользовательском коде \"\"\"\n"
 "\n"
 "    # Эта функция будет вызвана модулем aiomisc.plugin\n"
-"    # здесь, вызовем её чисто для демонстрации того как это работает.\n"
+"    # в этом примере только для демонстрации.\n"
 "    setup()\n"
 "\n"
 "    assert not event.is_set()\n"
@@ -183,7 +182,10 @@ msgstr ""
 "\n"
 "    assert event.is_set()\n"
 "\n"
-"main()"
+"main()\n"
+"\n"
+"# удаление плагина, когда он больше не нужен\n"
+"aiomisc.entrypoint.PRE_START.disconnect(hello)"
 
 #: ../../source/plugins.rst:96
 msgid "The following signals are available in total:"

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

@@ -522,9 +522,8 @@ msgstr ""
 "    loop.run_forever()"
 
 #: ../../source/services.rst:393
-#, fuzzy
 msgid "DNS Server"
-msgstr "asgi сервис"
+msgstr "DNS сервис"
 
 #: ../../source/services.rst:395
 msgid ""
@@ -1333,12 +1332,10 @@ msgstr ""
 "``TLSServer``)."
 
 #: ../../source/services.rst:999
-#, fuzzy
 msgid "uvicorn service"
-msgstr "Uvicorn сервис"
+msgstr "uvicorn сервис"
 
 #: ../../source/services.rst:1003
-#, fuzzy
 msgid "requires installed uvicorn:"
 msgstr "необходимо установить библиотеку uvicorn_:"
 
@@ -1351,7 +1348,6 @@ msgid "pip install aiomisc[uvicorn]"
 msgstr ""
 
 #: ../../source/services.rst:1016
-#, fuzzy
 msgid "Any ASGI-like application can be started via uvicorn as a service:"
 msgstr ""
 "Любое ASGI совместимое приложение может быть запущено через uvicorn как "
@@ -1396,7 +1392,6 @@ msgid ""
 msgstr ""
 
 #: ../../source/services.rst:1061
-#, fuzzy
 msgid "GRPC service"
 msgstr "GRPC сервис"