Skip to content

[2pt] Add a table with feature comparison of Python connectors #2482

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
Jan 26, 2022
Merged

[2pt] Add a table with feature comparison of Python connectors #2482

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
bb68a09
Add a table with feature comparison of Python connectors
ligurio Dec 6, 2021
47987d5
Apply suggestions from code review
art-dr Jan 11, 2022
5e05cfb
Update translations
maryartkey Jan 20, 2022
edef627
Fix a capitalization issue
patiencedaur Jan 20, 2022
7c0ce8e
Update translations
patiencedaur Jan 20, 2022
3e0e916
Update translations
patiencedaur Jan 24, 2022
f883254
Update translations
patiencedaur Jan 25, 2022
28ceb25
Apply suggestions from code review
patiencedaur Jan 26, 2022
f5f1e33
Apply suggestions from code review
patiencedaur Jan 26, 2022
e8eef96
Update translations
patiencedaur Jan 26, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
178 changes: 177 additions & 1 deletion doc/book/connectors/__python.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't know why we have two docs regarding connectors in different sections (that's odd and confusing), but as result we end up with the comparison tables in different sections (see PR #2484).

Copy link
Contributor

@patiencedaur patiencedaur Jan 26, 2022 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We noticed that and filed an issue: #2591

------------------

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>`__
Loading