Skip to content

Latest commit

 

History

History
135 lines (102 loc) · 4.7 KB

CHANGELOG.md

File metadata and controls

135 lines (102 loc) · 4.7 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

Added

  • Reusable testing workflow for integration with tarantool artifacts (PR #192).

  • Connection pool with master discovery (PR #211, #196).

    ConnectionPool is supported only for Python 3.7 or newer. Authenticated user must be able to call box.info on instances.

    ConnectionPool updates information about each server state (RO/RW) on initial connect and then asynchronously in separate threads. Application retries must be written considering the asynchronous nature of cluster state refresh. User does not need to use any synchronization mechanisms in requests, it's all handled with ConnectionPool methods.

    ConnectionPool API is the same as a plain Connection API. On each request, a connection is chosen to execute this request. A connection is chosen based on a request mode:

    • Mode.ANY chooses any instance.
    • Mode.RW chooses an RW instance.
    • Mode.RO chooses an RO instance.
    • Mode.PREFER_RW chooses an RW instance, if possible, RO instance otherwise.
    • Mode.PREFER_RO chooses an RO instance, if possible, RW instance otherwise. All requests that are guaranteed to write (insert, replace, delete, upsert, update) use RW mode by default. select uses ANY by default. You can set the mode explicitly. call, eval, execute and ping requests require to set the mode explicitly.

    Example:

    pool = tarantool.ConnectionPool(
    addrs=[
        {'host': '108.177.16.0', 'port': 3301},
        {'host': '108.177.16.0', 'port': 3302},
    ],
    user='test',
    password='test',)

pool.call('some_write_procedure', arg, mode=tarantool.Mode.RW)

Changed

  • Breaking: drop Python 2 support (PR #207).

  • Breaking: change binary types encode/decode for Python 3 to support working with varbinary (PR #211, #105). With Python 2 the behavior of the connector remains the same.

    Before this patch:

    • encoding="utf-8" (default)

      Python 3 -> Tarantool -> Python 3
      str -> mp_str (string) -> str
      bytes -> mp_str (string) -> str
      mp_bin (varbinary) -> bytes

    • encoding=None

      Python 3 -> Tarantool -> Python 3
      bytes -> mp_str (string) -> bytes
      str -> mp_str (string) -> bytes
      mp_bin (varbinary) -> bytes

    Using bytes as key was not supported by several methods (delete, update, select).

    After this patch:

    • encoding="utf-8" (default)

      Python 3 -> Tarantool -> Python 3
      str -> mp_str (string) -> str
      bytes -> mp_bin (varbinary) -> bytes

    • encoding=None

      Python 3 -> Tarantool -> Python 3
      bytes -> mp_str (string) -> bytes
      str -> mp_str (string) -> bytes
      mp_bin (varbinary) -> bytes

    Using bytes as key are now supported by all methods.

    Thus, encoding="utf-8" connection may be used to work with utf-8 strings and varbinary and encodine=None connection may be used to work with non-utf-8 strings.

  • Clarify license of the project (BSD-2-Clause) (PR #210, #197).

  • Migrate CI to GitHub Actions (PR #213, PR #216, #182).

  • Various improvements and fixes in README (PR #210, PR #215).

Fixed

  • json.dumps compatibility with Python 2 (PR #186).
  • Unix socket support in mesh_connection (PR #189, #111).
  • Various fixes in tests (PR #189, #111, PR #195, #194).

0.7.1 - 2020-12-28

Fixed

  • msgpack library dependency (PR #185).

0.7.0 - 2020-12-28

Caution: Use tarantool-python 0.7.1 instead of 0.7.0. It fixes the dependency on the msgpack library.

Added

  • Support msgpack 1.0.0 (#155, PR #173).
  • SQL support (.execute() method) (#159, PR #161).
  • Allow to receive a Tarantool tuple as a Python tuple, not a list, with use_list=False connection option (#166, PR #161).
  • Support the Database API (PEP-0249) (PR #161).

Changed

  • Various improvements in README (PR #147, PR #151, PR #180).

Fixed

  • Support encoding=None connections (PR #172).
  • Various improvements and fixes in tests (8ff9a3f, bd37703, PR #165, #178, PR #179, PR #181).