From 8875d3779aa49a13a554242e18d20cf76f778ce2 Mon Sep 17 00:00:00 2001
From: Sergey Bronnikov <estetus@gmail.com>
Date: Wed, 26 Jan 2022 10:32:25 +0300
Subject: [PATCH] [2pt] Add a table with feature comparison of Python
 connectors (#2482)

* Add a table with feature comparison of Python connectors

Written by Sergey Bronnikov, reviewed by Valeria Beresneva and Alexander Turenko
Translated by Maria Kovalevskaya, translation reviewed by Patience Daur

Co-authored-by: Sergey Bronnikov <sergeyb@tarantool.org>
Co-authored-by: Valeria Beresneva <valeria.khokha@gmail.com>
Co-authored-by: Maria Kovalevskaya <maryartkey@gmail.com>
Co-authored-by: Patience Daur <patiencedaur@gmail.com>
Co-authored-by: Alexander Turenko <alexander.turenko@tarantool.org>
---
 doc/book/connectors/__python.rst         | 178 +++++++++++-
 locale/ru/LC_MESSAGES/book/connectors.po | 344 ++++++++++++++++++++++-
 2 files changed, 514 insertions(+), 8 deletions(-)

diff --git a/doc/book/connectors/__python.rst b/doc/book/connectors/__python.rst
index 13ec24ad85..feff7e3565 100644
--- a/doc/book/connectors/__python.rst
+++ b/doc/book/connectors/__python.rst
@@ -43,4 +43,180 @@ Also there are several community-driven Python connectors:
 
 * `asynctnt <https://github.com/igorcoding/asynctnt>`__ with asyncio support
 * `aiotarantool <https://github.com/shveenkov/aiotarantool>`__ also with asyncio support
-* `gtarantool <https://github.com/shveenkov/gtarantool>`__ with gevent support **no active maintenance**
+* `gtarantool <https://github.com/shveenkov/gtarantool>`__ with gevent support, **no active maintenance**
+
+The table below contains a feature comparison for asynctnt, gtarantool and
+tarantool-python. aiotarantool is absent there because it is quite outdated and
+unmaintained.
+
+Feature comparison
+------------------
+
+Last update: February 2022
+
+..  list-table::
+    :header-rows: 1
+    :stub-columns: 1
+
+    *   -   Parameter
+        -   `igorcoding/asynctnt <https://github.com/igorcoding/asynctnt>`__
+        -   `shveenkov/gtarantool <https://github.com/shveenkov/gtarantool>`__
+        -   `tarantool/tarantool-python <https://github.com/tarantool/tarantool-python>`__
+
+    *   -   License
+        -   Apache License 2.0
+        -   LGPL
+        -   BSD-2
+
+    *   -   Is maintained
+        -   Yes
+        -   No (last updated in 2018)
+        -   Yes
+
+    *   -   Known Issues
+        -   `issue #18 <https://github.com/igorcoding/asynctnt/issues/18>`__ (no running event loop)
+        -   None
+        -   `issue #105 <https://github.com/tarantool/tarantool-python/issues/105>`__ (unpack of binary data)
+
+    *   -   Documentation
+        -   Yes (`github.io <https://igorcoding.github.io/asynctnt/>`__)
+        -   No
+        -   Yes (`tarantool.io
+            <https://www.tarantool.io/en/doc/latest/getting_started/getting_started_python/>`__
+            and `readthedocs
+            <https://tarantool-python.readthedocs.io/en/latest/quick-start.en.html>`__
+            (`obsolete
+            <https://github.com/tarantool/tarantool-python/issues/67>`__))
+
+    *   -   Testing / CI / CD
+        -   GitHub Actions
+        -   No (tests exist)
+        -   AppVeyor (only Windows)
+
+    *   -   GitHub Stars
+        -   51
+        -   17
+        -   78
+
+    *   -   Static Analysis
+        -   Yes (Flake8)
+        -   No
+        -   No
+
+    *   -   Packaging
+        -   `pip <https://pypi.org/project/asynctnt/>`__
+        -   `pip <https://pypi.org/project/gtarantool/>`__
+        -   `deb, rpm, pip <https://github.com/tarantool/tarantool-python#download-and-install>`__
+
+    *   -   Code coverage
+        -   Yes
+        -   No
+        -   Yes
+
+    *   -   Support asynchronous mode
+        -   Yes, `asyncio <https://docs.python.org/3/library/asyncio.html>`__
+        -   Yes (`gevent
+            <https://www.gevent.org/api/gevent.event.html#gevent.event.AsyncResult>`__,
+            example: `test_gevent.py
+            <https://github.com/shveenkov/gtarantool/blob/master/tests/test_gevent.py>`__)
+        -   No
+
+    *   -   Batching support
+        -   No
+        -   No
+        -   No (`issue #55 <https://github.com/tarantool/tarantool-python/issues/55>`__)
+
+    *   -   Schema reload
+        -   Yes (automatically, see `auto_refetch_schema <https://igorcoding.github.io/asynctnt/api.html>`__)
+        -   Yes (automatically)
+        -   Yes (automatically)
+
+    *   -   Space / index names
+        -   Yes
+        -   Yes
+        -   Yes
+
+    *   -   Access tuple fields by names
+        -   Yes
+        -   No
+        -   No
+
+    *   -   `SQL support <https://www.tarantool.io/en/doc/latest/reference/reference_sql/>`__
+        -   Yes (tests/test_op_sql.py)
+        -   No
+        -   Yes (tarantool/connection.py)
+
+    *   -   `Interactive transactions <https://www.tarantool.io/en/doc/latest/book/box/stream/>`__
+        -   No
+        -   No
+        -   No (`issue #163 <https://github.com/tarantool/tarantool-python/issues/163>`__)
+
+    *   -   `Varbinary support <https://www.tarantool.io/en/doc/latest/book/box/data_model/>`__
+        -   No
+        -   No
+        -   Yes (`issue #105 <https://github.com/tarantool/tarantool-python/issues/105>`__)
+
+    *   -   `UUID support <https://www.tarantool.io/en/doc/latest/book/box/data_model/>`__
+        -   No
+        -   No
+        -   No
+
+    *   -   `Decimal support <https://www.tarantool.io/en/doc/latest/book/box/data_model/>`__
+        -   Almost (v2 branch)
+        -   No
+        -   No
+
+    *   -   `EXT_ERROR support <https://www.tarantool.io/ru/doc/latest/dev_guide/internals/msgpack_extensions/#the-error-type>`__
+        -   No
+        -   No
+        -   No
+
+    *   -   `Datetime support <https://github.com/tarantool/tarantool/discussions/6244>`__
+        -   No
+        -   No
+        -   No
+
+    *   -   `box.session.push() responses <https://www.tarantool.io/ru/doc/latest/reference/reference_lua/box_session/push/>`__
+        -   Yes (see push_subscribe option and docs/pushes.rst)
+        -   No
+        -   No
+
+    *   -   `Session settings <https://www.tarantool.io/en/doc/latest/reference/reference_lua/box_space/_session_settings/>`__
+        -   No
+        -   No
+        -   No
+
+    *   -   `Graceful shutdown <https://github.com/tarantool/tarantool/issues/5924>`__
+        -   No
+        -   No
+        -   No
+
+    *   -   `IPROTO_ID (feature discovering) <https://github.com/tarantool/doc/issues/2419>`__
+        -   No
+        -   No
+        -   No
+
+    *   -   Support `CRUD <https://github.com/tarantool/crud>`__
+        -   No
+        -   No
+        -   No
+
+    *   -   Transparent request retrying
+        -   No
+        -   No
+        -   No
+
+    *   -   Transparent reconnecting
+        -   Autoreconnect
+        -   Yes (reconnect_max_attempts, reconnect_delay)
+        -   Yes (reconnect_max_attempts, reconnect_delay), checking of connection liveness
+
+    *   -   Connection pool
+        -   No
+        -   No
+        -   Yes (round robin failover)
+
+    *   -   Support of `PEP 249 -- Python Database API Specification v2.0 <https://www.python.org/dev/peps/pep-0249/>`__
+        -   No
+        -   No
+        -   `Yes <https://github.com/tarantool/tarantool-python/wiki/PEP-249-Database-API>`__
diff --git a/locale/ru/LC_MESSAGES/book/connectors.po b/locale/ru/LC_MESSAGES/book/connectors.po
index 271626b68f..ff8c96186f 100644
--- a/locale/ru/LC_MESSAGES/book/connectors.po
+++ b/locale/ru/LC_MESSAGES/book/connectors.po
@@ -697,11 +697,344 @@ msgstr ""
 "поддержкой asyncio"
 
 msgid ""
-"`gtarantool <https://github.com/shveenkov/gtarantool>`__ with gevent support"
-" **no active maintenance**"
+"`gtarantool <https://github.com/shveenkov/gtarantool>`__ with gevent "
+"support, **no active maintenance**"
 msgstr ""
-"`gtarantool <https://github.com/shveenkov/gtarantool>`_ с поддержкой gevent "
-"(**не обновляется**)"
+"`gtarantool <https://github.com/shveenkov/gtarantool>`__ с поддержкой "
+"gevent, **не обновляется**"
+
+msgid ""
+"The table below contains a feature comparison for asynctnt, gtarantool and "
+"tarantool-python. aiotarantool is absent there because it is quite outdated "
+"and unmaintained."
+msgstr ""
+"В этой таблице сравниваются функции коннекторов asynctnt, gtarantool и "
+"tarantool-python. aiotarantool здесь отсутствует, так как он устарел и "
+"больше не поддерживается."
+
+msgid "Feature comparison"
+msgstr "Сравнение функций"
+
+msgid "Last update: February 2022"
+msgstr "Последнее обновление: февраль 2022"
+
+msgid "Parameter"
+msgstr "Параметры"
+
+msgid "`igorcoding/asynctnt <https://github.com/igorcoding/asynctnt>`__"
+msgstr "`igorcoding/asynctnt <https://github.com/igorcoding/asynctnt>`__"
+
+msgid "`shveenkov/gtarantool <https://github.com/shveenkov/gtarantool>`__"
+msgstr "`shveenkov/gtarantool <https://github.com/shveenkov/gtarantool>`__"
+
+msgid ""
+"`tarantool/tarantool-python <https://github.com/tarantool/tarantool-"
+"python>`__"
+msgstr ""
+"`tarantool/tarantool-python <https://github.com/tarantool/tarantool-"
+"python>`__"
+
+msgid "License"
+msgstr "Лицензия"
+
+msgid "Apache License 2.0"
+msgstr "Apache License 2.0"
+
+msgid "LGPL"
+msgstr "LGPL"
+
+msgid "BSD-2"
+msgstr "BSD-2"
+
+msgid "Is maintained"
+msgstr "Поддерживается"
+
+msgid "Yes"
+msgstr "Да"
+
+msgid "No (last updated in 2018)"
+msgstr "Нет (последнее обновление в 2018)"
+
+msgid "Known Issues"
+msgstr "Известные проблемы"
+
+msgid ""
+"`issue #18 <https://github.com/igorcoding/asynctnt/issues/18>`__ (no running"
+" event loop)"
+msgstr ""
+"`тикет #18 <https://github.com/igorcoding/asynctnt/issues/18>`__ (нет "
+"событийного цикла)"
+
+msgid "None"
+msgstr "Нет"
+
+msgid ""
+"`issue #105 <https://github.com/tarantool/tarantool-python/issues/105>`__ "
+"(unpack of binary data)"
+msgstr ""
+"`тикет #105 <https://github.com/tarantool/tarantool-python/issues/105>`__ "
+"(распаковка бинарных данных)"
+
+msgid "Documentation"
+msgstr "Документация"
+
+msgid "Yes (`github.io <https://igorcoding.github.io/asynctnt/>`__)"
+msgstr "Есть (`github.io <https://igorcoding.github.io/asynctnt/>`__)"
+
+msgid "No"
+msgstr "Нет"
+
+msgid ""
+"Yes (`tarantool.io "
+"<https://www.tarantool.io/en/doc/latest/getting_started/getting_started_python/>`__"
+" and `readthedocs <https://tarantool-python.readthedocs.io/en/latest/quick-"
+"start.en.html>`__ (`obsolete <https://github.com/tarantool/tarantool-"
+"python/issues/67>`__))"
+msgstr ""
+"Есть (`tarantool.io "
+"<https://www.tarantool.io/en/doc/latest/getting_started/getting_started_python/>`__"
+" и `readthedocs <https://tarantool-python.readthedocs.io/en/latest/quick-"
+"start.en.html>`__ (`неактуальна <https://github.com/tarantool/tarantool-"
+"python/issues/67>`__))"
+
+msgid "Testing / CI / CD"
+msgstr "Тестирование / CI / CD"
+
+msgid "GitHub Actions"
+msgstr "GitHub Actions"
+
+msgid "No (tests exist)"
+msgstr "Нет (есть тесты)"
+
+msgid "AppVeyor (only Windows)"
+msgstr "AppVeyor (только на Windows)"
+
+msgid "GitHub Stars"
+msgstr "GitHub-звезды"
+
+msgid "51"
+msgstr "51"
+
+msgid "17"
+msgstr "17"
+
+msgid "78"
+msgstr "78"
+
+msgid "Static Analysis"
+msgstr "Статический анализ"
+
+msgid "Yes (Flake8)"
+msgstr "Есть (Flake8)"
+
+msgid "Packaging"
+msgstr "Способ упаковки"
+
+msgid "`pip <https://pypi.org/project/asynctnt/>`__"
+msgstr "`pip <https://pypi.org/project/asynctnt/>`__"
+
+msgid "`pip <https://pypi.org/project/gtarantool/>`__"
+msgstr "`pip <https://pypi.org/project/gtarantool/>`__"
+
+msgid ""
+"`deb, rpm, pip <https://github.com/tarantool/tarantool-python#download-and-"
+"install>`__"
+msgstr ""
+"`deb, rpm, pip <https://github.com/tarantool/tarantool-python#download-and-"
+"install>`__"
+
+msgid "Code coverage"
+msgstr "Покрытие кода"
+
+msgid "Support asynchronous mode"
+msgstr "Поддержка асинхронного режима"
+
+msgid "Yes, `asyncio <https://docs.python.org/3/library/asyncio.html>`__"
+msgstr "Есть, `asyncio <https://docs.python.org/3/library/asyncio.html>`__"
+
+msgid ""
+"Yes (`gevent "
+"<https://www.gevent.org/api/gevent.event.html#gevent.event.AsyncResult>`__, "
+"example: `test_gevent.py "
+"<https://github.com/shveenkov/gtarantool/blob/master/tests/test_gevent.py>`__)"
+msgstr ""
+"Есть, `gevent "
+"<https://www.gevent.org/api/gevent.event.html#gevent.event.AsyncResult>`__ "
+"(пример: `test_gevent.py "
+"<https://github.com/shveenkov/gtarantool/blob/master/tests/test_gevent.py>`__)"
+
+msgid "Batching support"
+msgstr "Поддержка пакетной обработки"
+
+msgid ""
+"No (`issue #55 <https://github.com/tarantool/tarantool-python/issues/55>`__)"
+msgstr ""
+"Нет (`тикет #55 <https://github.com/tarantool/tarantool-"
+"python/issues/55>`__)"
+
+msgid "Schema reload"
+msgstr "Обновление схемы"
+
+msgid ""
+"Yes (automatically, see `auto_refetch_schema "
+"<https://igorcoding.github.io/asynctnt/api.html>`__)"
+msgstr ""
+"Автоматическое (см. `auto_refetch_schema "
+"<https://igorcoding.github.io/asynctnt/api.html>`__)"
+
+msgid "Yes (automatically)"
+msgstr "Автоматическое"
+
+msgid "Space / index names"
+msgstr "Имена спейсов/индексов"
+
+msgid "Access tuple fields by names"
+msgstr "Доступ к полям кортежей по именам"
+
+msgid ""
+"`SQL support "
+"<https://www.tarantool.io/en/doc/latest/reference/reference_sql/>`__"
+msgstr ""
+"`Поддержка SQL "
+"<https://www.tarantool.io/en/doc/latest/reference/reference_sql/>`__"
+
+msgid "Yes (tests/test_op_sql.py)"
+msgstr "Есть (tests/test_op_sql.py)"
+
+msgid "Yes (tarantool/connection.py)"
+msgstr "Есть (tarantool/connection.py)"
+
+msgid ""
+"`Interactive transactions "
+"<https://www.tarantool.io/en/doc/latest/book/box/stream/>`__"
+msgstr ""
+"`Интерактивные транзакции "
+"<https://www.tarantool.io/en/doc/latest/book/box/stream/>`__"
+
+msgid ""
+"No (`issue #163 <https://github.com/tarantool/tarantool-"
+"python/issues/163>`__)"
+msgstr ""
+"Нет (`тикет #163 <https://github.com/tarantool/tarantool-"
+"python/issues/163>`__)"
+
+msgid ""
+"`Varbinary support "
+"<https://www.tarantool.io/en/doc/latest/book/box/data_model/>`__"
+msgstr ""
+"`Поддержка varbinary "
+"<https://www.tarantool.io/en/doc/latest/book/box/data_model/>`__"
+
+msgid ""
+"Yes (`issue #105 <https://github.com/tarantool/tarantool-"
+"python/issues/105>`__)"
+msgstr ""
+"Есть (`тикет #105 <https://github.com/tarantool/tarantool-"
+"python/issues/105>`__)"
+
+msgid ""
+"`UUID support "
+"<https://www.tarantool.io/en/doc/latest/book/box/data_model/>`__"
+msgstr ""
+"`Поддержка UUID "
+"<https://www.tarantool.io/en/doc/latest/book/box/data_model/>`__"
+
+msgid ""
+"`Decimal support "
+"<https://www.tarantool.io/en/doc/latest/book/box/data_model/>`__"
+msgstr ""
+"`Поддержка decimal "
+"<https://www.tarantool.io/en/doc/latest/book/box/data_model/>`__"
+
+msgid "Almost (v2 branch)"
+msgstr "Частично (в ветке v2)"
+
+msgid ""
+"`EXT_ERROR support "
+"<https://www.tarantool.io/ru/doc/latest/dev_guide/internals/msgpack_extensions/#the-"
+"error-type>`__"
+msgstr ""
+"`Поддержка EXT_ERROR "
+"<https://www.tarantool.io/ru/doc/latest/dev_guide/internals/msgpack_extensions/#the-"
+"error-type>`__"
+
+msgid ""
+"`Datetime support "
+"<https://github.com/tarantool/tarantool/discussions/6244>`__"
+msgstr ""
+"`Поддержка datetime "
+"<https://github.com/tarantool/tarantool/discussions/6244>`__"
+
+msgid ""
+"`box.session.push() responses "
+"<https://www.tarantool.io/ru/doc/latest/reference/reference_lua/box_session/push/>`__"
+msgstr ""
+"`Возвращаемые значения box.session.push() "
+"<https://www.tarantool.io/ru/doc/latest/reference/reference_lua/box_session/push/>`__"
+
+msgid "Yes (see push_subscribe option and docs/pushes.rst)"
+msgstr "Есть (см. push_subscribe option и docs/pushes.rst)"
+
+msgid ""
+"`Session settings "
+"<https://www.tarantool.io/en/doc/latest/reference/reference_lua/box_space/_session_settings/>`__"
+msgstr ""
+"`Настройки сессии "
+"<https://www.tarantool.io/en/doc/latest/reference/reference_lua/box_space/_session_settings/>`__"
+
+msgid ""
+"`Graceful shutdown <https://github.com/tarantool/tarantool/issues/5924>`__"
+msgstr ""
+"`Мягкое завершение <https://github.com/tarantool/tarantool/issues/5924>`__"
+
+msgid ""
+"`IPROTO_ID (feature discovering) "
+"<https://github.com/tarantool/doc/issues/2419>`__"
+msgstr ""
+"`IPROTO_ID (обнаружение поддерживаемых функций) "
+"<https://github.com/tarantool/doc/issues/2419>`__"
+
+msgid "Support `CRUD <https://github.com/tarantool/crud>`__"
+msgstr "Поддержка `CRUD <https://github.com/tarantool/crud>`__"
+
+msgid "Transparent request retrying"
+msgstr "Прозрачная переотправка запроса"
+
+msgid "Transparent reconnecting"
+msgstr "Прозрачное переподключение"
+
+msgid "Autoreconnect"
+msgstr "Автоматическое переподключение"
+
+msgid "Yes (reconnect_max_attempts, reconnect_delay)"
+msgstr "Есть (reconnect_max_attempts, reconnect_delay)"
+
+msgid ""
+"Yes (reconnect_max_attempts, reconnect_delay), checking of connection "
+"liveness"
+msgstr ""
+"Есть (reconnect_max_attempts, reconnect_delay), проверка состояния "
+"соединения"
+
+msgid "Connection pool"
+msgstr "Пул соединений"
+
+msgid "Yes (round robin failover)"
+msgstr "Есть (циклическое восстановление после сбоев)"
+
+msgid ""
+"Support of `PEP 249 -- Python Database API Specification v2.0 "
+"<https://www.python.org/dev/peps/pep-0249/>`__"
+msgstr ""
+"Поддержка `PEP 249 --- Python Database API Specification v2.0 "
+"<https://www.python.org/dev/peps/pep-0249/>`__"
+
+msgid ""
+"`Yes <https://github.com/tarantool/tarantool-python/wiki/PEP-249-Database-"
+"API>`__"
+msgstr ""
+"`Есть <https://github.com/tarantool/tarantool-python/wiki/PEP-249-Database-"
+"API>`__"
 
 msgid "Node.js"
 msgstr "Node.js"
@@ -977,9 +1310,6 @@ msgstr ""
 "документации `проекта tarantool-php на GitHub "
 "<https://github.com/tarantool/tarantool-php>`__."
 
-msgid "C"
-msgstr "C"
-
 msgid "Here follow two examples of using Tarantool's high-level C API."
 msgstr ""
 "В этом разделе приведены два примера использования высокоуровневого API "