From 469c3610b9b05805e9526b89a311f4df1255c44e Mon Sep 17 00:00:00 2001 From: Georgy Moiseev Date: Wed, 8 Dec 2021 10:53:07 +0300 Subject: [PATCH 1/8] Add comparison table of Go connectors Compare features of our own tarantool/go-tarantool connector with two open-source connectors: viciious/go-tarantool [1] and FZambia/tarantool [2]. 1. https://github.com/viciious/go-tarantool 2. https://github.com/FZambia/tarantool --- doc/getting_started/getting_started_go.rst | 182 +++++++++++++++++++++ 1 file changed, 182 insertions(+) diff --git a/doc/getting_started/getting_started_go.rst b/doc/getting_started/getting_started_go.rst index 4eb4dbe7eb..9bb78a052c 100644 --- a/doc/getting_started/getting_started_go.rst +++ b/doc/getting_started/getting_started_go.rst @@ -245,3 +245,185 @@ To send bare Lua code for execution, use ``Eval``: .. code-block:: go resp, err = connection.Eval("return 4 + 5", []interface{}{}) + +.. _getting_started-go-comparison: + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Feature comparison +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +There are two more connectors from open-source community available: +`viciious/go-tarantool `_ and +`FZambia/tarantool `_. + +Last update: January 2022 + +.. list-table:: + :header-rows: 1 + :stub-columns: 1 + + * - + - `tarantool/go-tarantool `_ + - `viciious/go-tarantool `_ + - `FZambia/tarantool `_ + + * - License + - BSD 2-Clause + - MIT + - BSD 2-Clause + + * - Last update + - 2022 + - 2021 + - 2021 + + * - Documentation + - README with examples, API described in code comments + - README with examples, code comments + - README with examples + + * - Testing / CI / CD + - GitHub Actions + - Travis CI + - GitHub Actions + + * - GitHub Stars + - 127 + - 43 + - 12 + + * - Static analysis + - No + - golint + - golangci-lint + + * - Packaging + - go get + - go get + - go get + + * - Code coverage + - No + - No + - No + + * - msgpack driver + - `vmihailenco/msgpack/v2 `_ (`#124 `_) + - `tinylib/msgp `_ + - `vmihailenco/msgpack/v5 `_ + + * - Async work + - Yes + - Yes + - Yes + + * - Schema reload + - Yes (manual pull) + - Yes (manual pull) + - Yes (manual pull) + + * - Space / index names + - Yes + - Yes + - Yes + + * - Tuples as structures + - Yes (structure and marshall functions must be predefined in Go code) + - No + - Yes (structure and marshall functions must be predefined in Go code) + + * - Access tuple fields by names + - Only if marshalled to structure + - No + - Only if marshalled to structure + + * - `SQL `_ support + - No (`#62 `_) + - No (`#18 `_, closed) + - No + + * - `Interactive transactions `_ + - No (`#101 `_) + - No + - No + + * - `Varbinary `_ support + - Yes (with in-built language tools) + - Yes (with in-built language tools) + - Yes (decodes to string by default, see `#6 `_) + + * - `UUID `_ support + - Yes + - No + - No + + * - Decimal support + - No (`#96 `_) + - No + - No + + * - `EXT_ERROR `_ + support + - No + - No + - No + + * - `Datetime `_ support + - No (`#118 `_) + - No + - No + + * - `box.session.push() responses `_ + - No (`#67 `_) + - No (`#21 `_) + - Yes + + * - `Session settings `_ + - No + - No + - No + + * - `Graceful shutdown `_ + - No + - No + - No + + * - `IPROTO_ID (feature discovering) `_ + - No + - No + - No + + * - `tarantool/crud `_ support + - No + - No + - No + + * - Connection pool + - Yes (round-robin failover, no balancing, master discovering planned in `#113 `_) + - No + - No + + * - Implicit reconnecting strategy + - Yes (see comments in `#129 `_) + - No (handle reconnects explicitly, refer to `#11 `_) + - Yes (see comments in `#7 `_) + + * - Support retrying + - No + - No + - No + + * - `Watchers `_ + - No + - No + - No + + * - Language features + - No (`#48 `_) + - context + - context + + * - Miscellanious + - Supports `tarantool/queue `_ API + - Can mimic a Tarantool instance (also as replica) + - API is experimental and breaking changes may happen From 63baa9710b55c4f406ff156f6fd3718789f0bda3 Mon Sep 17 00:00:00 2001 From: Valeria Beresneva <32414756+arctic-dreamer@users.noreply.github.com> Date: Fri, 14 Jan 2022 15:57:04 +0300 Subject: [PATCH 2/8] Update doc/getting_started/getting_started_go.rst Minor update after proofreading --- doc/getting_started/getting_started_go.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/getting_started/getting_started_go.rst b/doc/getting_started/getting_started_go.rst index 9bb78a052c..5bed0715d1 100644 --- a/doc/getting_started/getting_started_go.rst +++ b/doc/getting_started/getting_started_go.rst @@ -252,7 +252,7 @@ To send bare Lua code for execution, use ``Eval``: Feature comparison ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -There are two more connectors from open-source community available: +There are two more connectors from the open-source community available: `viciious/go-tarantool `_ and `FZambia/tarantool `_. From 7584aa4748fc16d334745d26d306b40d89d6fc74 Mon Sep 17 00:00:00 2001 From: maryartkey Date: Thu, 20 Jan 2022 00:27:58 +0000 Subject: [PATCH 3/8] Update translations --- .../getting_started/getting_started_go.po | 314 ++++++++++++++++++ 1 file changed, 314 insertions(+) diff --git a/locale/ru/LC_MESSAGES/getting_started/getting_started_go.po b/locale/ru/LC_MESSAGES/getting_started/getting_started_go.po index eeac84d7d4..8d42686bdd 100644 --- a/locale/ru/LC_MESSAGES/getting_started/getting_started_go.po +++ b/locale/ru/LC_MESSAGES/getting_started/getting_started_go.po @@ -372,3 +372,317 @@ msgstr "" msgid "resp, err = connection.Eval(\"return 4 + 5\", []interface{}{})" msgstr "resp, err = connection.Eval(\"return 4 + 5\", []interface{}{})" + +msgid "Feature comparison" +msgstr "Сравнение функций" + +msgid "" +"There are two more connectors from the open-source community available: " +"`viciious/go-tarantool `_ and " +"`FZambia/tarantool `_." +msgstr "" +"Есть еще два доступных коннектора от опенсорс-сообщества: `viciious/go-" +"tarantool `_ и `FZambia/tarantool " +"`_." + +msgid "Last update: January 2022" +msgstr "Последнее обновление: январь 2022" + +msgid "`tarantool/go-tarantool `_" +msgstr "`tarantool/go-tarantool `_" + +msgid "`viciious/go-tarantool `_" +msgstr "`viciious/go-tarantool `_" + +msgid "`FZambia/tarantool `_" +msgstr "`FZambia/tarantool `_" + +msgid "License" +msgstr "Лицензия" + +msgid "BSD 2-Clause" +msgstr "BSD 2-Clause" + +msgid "MIT" +msgstr "MIT" + +msgid "Last update" +msgstr "Последнее обновление" + +msgid "2022" +msgstr "2022" + +msgid "2021" +msgstr "2021" + +msgid "Documentation" +msgstr "Документация" + +msgid "README with examples, API described in code comments" +msgstr "README с примерами. Описание API в комментариях к коду." + +msgid "README with examples, code comments" +msgstr "README с примерами и комментариями к коду" + +msgid "README with examples" +msgstr "README с примерами" + +msgid "Testing / CI / CD" +msgstr "Тестирование / CI / CD" + +msgid "GitHub Actions" +msgstr "GitHub Actions" + +msgid "Travis CI" +msgstr "Travis CI" + +msgid "GitHub Stars" +msgstr "Звезды GitHub" + +msgid "127" +msgstr "127" + +msgid "43" +msgstr "43" + +msgid "12" +msgstr "12" + +msgid "Static analysis" +msgstr "Статический анализ" + +msgid "No" +msgstr "Нет" + +msgid "golint" +msgstr "golint" + +msgid "golangci-lint" +msgstr "golangci-lint" + +msgid "Packaging" +msgstr "Формат пакета" + +msgid "go get" +msgstr "go get" + +msgid "Code coverage" +msgstr "Покрытие кода" + +msgid "msgpack driver" +msgstr "драйвер msgpack" + +msgid "" +"`vmihailenco/msgpack/v2 `_ " +"(`#124 `_)" +msgstr "" +"`vmihailenco/msgpack/v2 `_ " +"(`#124 `_)" + +msgid "`tinylib/msgp `_" +msgstr "`tinylib/msgp `_" + +msgid "" +"`vmihailenco/msgpack/v5 `_" +msgstr "" +"`vmihailenco/msgpack/v5 `_" + +msgid "Async work" +msgstr "Асинхронная работа" + +msgid "Yes" +msgstr "Есть" + +msgid "Schema reload" +msgstr "Обновление схемы" + +msgid "Yes (manual pull)" +msgstr "Есть (запускается вручную)" + +msgid "Space / index names" +msgstr "Имена спейсов/индексов" + +msgid "Tuples as structures" +msgstr "Кортежи как структуры" + +msgid "Yes (structure and marshall functions must be predefined in Go code)" +msgstr "" +"Есть (структура и функции маршалинга должны быть предопределены в коде Go)" + +msgid "Access tuple fields by names" +msgstr "Доступ к полям кортежей по именам" + +msgid "Only if marshalled to structure" +msgstr "Только при маршалинге в структуру" + +msgid "" +"`SQL `_ " +"support" +msgstr "" +"Поддержка `SQL " +"`_" + +msgid "No (`#62 `_)" +msgstr "Нет (`#62 `_)" + +msgid "" +"No (`#18 `_, closed)" +msgstr "" +"Нет (`#18 `_, тикет " +"закрыт)" + +msgid "" +"`Interactive transactions " +"`_" +msgstr "" +"`Интерактивные транзакции " +"`_" + +msgid "No (`#101 `_)" +msgstr "Нет (`#101 `_)" + +msgid "" +"`Varbinary `_ " +"support" +msgstr "" +"Поддержка `varbinary " +"`_" + +msgid "Yes (with in-built language tools)" +msgstr "Есть (со встроенными инструментами языка)" + +msgid "" +"Yes (decodes to string by default, see `#6 " +"`_)" +msgstr "" +"Есть (декодирование в строку по умолчанию, см. `#6 " +"`_)" + +msgid "" +"`UUID `_ " +"support" +msgstr "" +"Поддержка `UUID " +"`_" + +msgid "Decimal support" +msgstr "Поддержка типа данных decimal" + +msgid "No (`#96 `_)" +msgstr "Нет (`#96 `_)" + +msgid "" +"`EXT_ERROR " +"`_ support" +msgstr "" +"Поддержка `EXT_ERROR " +"`_" + +msgid "" +"`Datetime `_ " +"support" +msgstr "" +"Поддержка `datetime " +"`_" + +msgid "No (`#118 `_)" +msgstr "Нет (`#118 `_)" + +msgid "" +"`box.session.push() responses " +"`_" +msgstr "" +"`Возвращаемые значения box.session.push() " +"`_" + +msgid "No (`#67 `_)" +msgstr "Нет (`#67 `_)" + +msgid "No (`#21 `_)" +msgstr "Нет (`#21 `_)" + +msgid "" +"`Session settings " +"`_" +msgstr "" +"`Настройки сессии " +"`_" + +msgid "" +"`Graceful shutdown `_" +msgstr "" +"`Мягкое завершение `_" + +msgid "" +"`IPROTO_ID (feature discovering) " +"`_" +msgstr "" +"`IPROTO_ID (поиск поддерживаемых функций) " +"`_" + +msgid "`tarantool/crud `_ support" +msgstr "поддержка `tarantool/crud `_" + +msgid "Connection pool" +msgstr "Пул соединений" + +msgid "" +"Yes (round-robin failover, no balancing, master discovering planned in `#113" +" `_)" +msgstr "" +"Есть (циклическое переключение при сбое, без балансировки, алгоритм поиска " +"мастера планируется в `#113 `_)" + +msgid "Implicit reconnecting strategy" +msgstr "Стратегия повторного подключения по умолчанию" + +msgid "" +"Yes (see comments in `#129 `_)" +msgstr "" +"Есть (см. комментарии к `#129 `_)" + +msgid "" +"No (handle reconnects explicitly, refer to `#11 " +"`_)" +msgstr "" +"Нет (дескриптор переподключается явно, см. `#11 " +"`_)" + +msgid "" +"Yes (see comments in `#7 `_)" +msgstr "" +"Есть (см. комментарии к `#7 " +"`_)" + +msgid "Support retrying" +msgstr "Поддержка повторной попытки подключения" + +msgid "`Watchers `_" +msgstr "" +"`Наблюдатели (watchers) `_" + +msgid "Language features" +msgstr "Возможности языка" + +msgid "No (`#48 `_)" +msgstr "Нет (`#48 `_)" + +msgid "context" +msgstr "контекст" + +msgid "Miscellanious" +msgstr "Разное" + +msgid "Supports `tarantool/queue `_ API" +msgstr "Поддержка API `tarantool/queue `_" + +msgid "Can mimic a Tarantool instance (also as replica)" +msgstr "Может имитировать инстанс Tarantool (также как реплика)" + +msgid "API is experimental and breaking changes may happen" +msgstr "Это экспериментальный API и он может значительно измениться" From 6babc831287045da3e98f9898e0c3fccced34fe6 Mon Sep 17 00:00:00 2001 From: Patience Daur Date: Mon, 24 Jan 2022 08:49:08 +0300 Subject: [PATCH 4/8] Fix typo --- doc/getting_started/getting_started_go.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/getting_started/getting_started_go.rst b/doc/getting_started/getting_started_go.rst index 5bed0715d1..c7821a0335 100644 --- a/doc/getting_started/getting_started_go.rst +++ b/doc/getting_started/getting_started_go.rst @@ -423,7 +423,7 @@ Last update: January 2022 - context - context - * - Miscellanious + * - Miscellaneous - Supports `tarantool/queue `_ API - Can mimic a Tarantool instance (also as replica) - API is experimental and breaking changes may happen From ea14306f8f0e7ed3df075ac7a26da9ae2aedb279 Mon Sep 17 00:00:00 2001 From: patiencedaur Date: Mon, 24 Jan 2022 06:02:04 +0000 Subject: [PATCH 5/8] Update translations --- .../getting_started/getting_started_go.po | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/locale/ru/LC_MESSAGES/getting_started/getting_started_go.po b/locale/ru/LC_MESSAGES/getting_started/getting_started_go.po index 8d42686bdd..ea0c52921c 100644 --- a/locale/ru/LC_MESSAGES/getting_started/getting_started_go.po +++ b/locale/ru/LC_MESSAGES/getting_started/getting_started_go.po @@ -419,10 +419,10 @@ msgid "Documentation" msgstr "Документация" msgid "README with examples, API described in code comments" -msgstr "README с примерами. Описание API в комментариях к коду." +msgstr "README с примерами, описание API в комментариях к коду" msgid "README with examples, code comments" -msgstr "README с примерами и комментариями к коду" +msgstr "README с примерами, комментарии к коду" msgid "README with examples" msgstr "README с примерами" @@ -437,7 +437,7 @@ msgid "Travis CI" msgstr "Travis CI" msgid "GitHub Stars" -msgstr "Звезды GitHub" +msgstr "GitHub-звезды" msgid "127" msgstr "127" @@ -461,7 +461,7 @@ msgid "golangci-lint" msgstr "golangci-lint" msgid "Packaging" -msgstr "Формат пакета" +msgstr "Способ упаковки" msgid "go get" msgstr "go get" @@ -470,7 +470,7 @@ msgid "Code coverage" msgstr "Покрытие кода" msgid "msgpack driver" -msgstr "драйвер msgpack" +msgstr "Драйвер msgpack" msgid "" "`vmihailenco/msgpack/v2 `_ " @@ -549,7 +549,7 @@ msgstr "" "`_" msgid "Yes (with in-built language tools)" -msgstr "Есть (со встроенными инструментами языка)" +msgstr "Есть (встроенными инструментами языка)" msgid "" "Yes (decodes to string by default, see `#6 " @@ -566,7 +566,7 @@ msgstr "" "`_" msgid "Decimal support" -msgstr "Поддержка типа данных decimal" +msgstr "Поддержка decimal" msgid "No (`#96 `_)" msgstr "Нет (`#96 `_)" @@ -619,11 +619,11 @@ msgid "" "`IPROTO_ID (feature discovering) " "`_" msgstr "" -"`IPROTO_ID (поиск поддерживаемых функций) " +"`IPROTO_ID (обнаружение поддерживаемых функций) " "`_" msgid "`tarantool/crud `_ support" -msgstr "поддержка `tarantool/crud `_" +msgstr "Поддержка `tarantool/crud `_" msgid "Connection pool" msgstr "Пул соединений" @@ -632,7 +632,7 @@ msgid "" "Yes (round-robin failover, no balancing, master discovering planned in `#113" " `_)" msgstr "" -"Есть (циклическое переключение при сбое, без балансировки, алгоритм поиска " +"Есть (циклическое восстановление после сбоев; без балансировки; обнаружение " "мастера планируется в `#113 `_)" @@ -673,16 +673,16 @@ msgid "No (`#48 `_)" msgstr "Нет (`#48 `_)" msgid "context" -msgstr "контекст" +msgstr "context" -msgid "Miscellanious" -msgstr "Разное" +msgid "Miscellaneous" +msgstr "Прочее" msgid "Supports `tarantool/queue `_ API" msgstr "Поддержка API `tarantool/queue `_" msgid "Can mimic a Tarantool instance (also as replica)" -msgstr "Может имитировать инстанс Tarantool (также как реплика)" +msgstr "Может имитировать экземпляр Tarantool (в том числе реплику)" msgid "API is experimental and breaking changes may happen" -msgstr "Это экспериментальный API и он может значительно измениться" +msgstr "API коннектора экспериментальный и может значительно измениться" From c5bc32550623177d74dd4a6e658981bfea401a88 Mon Sep 17 00:00:00 2001 From: patiencedaur Date: Tue, 25 Jan 2022 07:15:48 +0000 Subject: [PATCH 6/8] Update translations --- locale/ru/LC_MESSAGES/getting_started/getting_started_go.po | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/locale/ru/LC_MESSAGES/getting_started/getting_started_go.po b/locale/ru/LC_MESSAGES/getting_started/getting_started_go.po index ea0c52921c..2a5eb678b4 100644 --- a/locale/ru/LC_MESSAGES/getting_started/getting_started_go.po +++ b/locale/ru/LC_MESSAGES/getting_started/getting_started_go.po @@ -660,7 +660,7 @@ msgstr "" "`_)" msgid "Support retrying" -msgstr "Поддержка повторной попытки подключения" +msgstr "Повторная отправка запросов" msgid "`Watchers `_" msgstr "" From 0c3669378eb02a2f3a062a934fa294becd4926d6 Mon Sep 17 00:00:00 2001 From: Patience Daur Date: Wed, 26 Jan 2022 08:49:15 +0300 Subject: [PATCH 7/8] Apply suggestions from code review --- doc/getting_started/getting_started_go.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/getting_started/getting_started_go.rst b/doc/getting_started/getting_started_go.rst index c7821a0335..38cbe0480d 100644 --- a/doc/getting_started/getting_started_go.rst +++ b/doc/getting_started/getting_started_go.rst @@ -403,12 +403,12 @@ Last update: January 2022 - No - No - * - Implicit reconnecting strategy + * - Transparent reconnecting - Yes (see comments in `#129 `_) - No (handle reconnects explicitly, refer to `#11 `_) - Yes (see comments in `#7 `_) - * - Support retrying + * - Transparent request retrying - No - No - No From 969241bfa8c4aba362bf01c6068b97075e84e93b Mon Sep 17 00:00:00 2001 From: patiencedaur Date: Wed, 26 Jan 2022 06:02:20 +0000 Subject: [PATCH 8/8] Update translations --- .../ru/LC_MESSAGES/getting_started/getting_started_go.po | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/locale/ru/LC_MESSAGES/getting_started/getting_started_go.po b/locale/ru/LC_MESSAGES/getting_started/getting_started_go.po index 2a5eb678b4..9cdd72672a 100644 --- a/locale/ru/LC_MESSAGES/getting_started/getting_started_go.po +++ b/locale/ru/LC_MESSAGES/getting_started/getting_started_go.po @@ -636,8 +636,8 @@ msgstr "" "мастера планируется в `#113 `_)" -msgid "Implicit reconnecting strategy" -msgstr "Стратегия повторного подключения по умолчанию" +msgid "Transparent reconnecting" +msgstr "Прозрачное переподключение" msgid "" "Yes (see comments in `#129 `_)" -msgid "Support retrying" -msgstr "Повторная отправка запросов" +msgid "Transparent request retrying" +msgstr "Прозрачная переотправка запроса" msgid "`Watchers `_" msgstr ""