cleanup and README update

igorcoding · Jun 29, 2022 · a836c07 · a836c07
1 parent 0fafbf0
commit a836c07
Show file tree

Hide file tree

Showing 19 changed files with 31 additions and 596 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Changelog
 
-## v2.0.0b1
+## v2.0.0
 **Breaking changes:**
 * `Connection.sql()` method is renamed to `Connection.execute()`
 * Drop support for `loop` argument in the `Connection` (fixes [#18](https://github.com/igorcoding/asynctnt/issues/18))

diff --git a/README.md b/README.md
@@ -31,9 +31,11 @@ Documentation is available [here](https://igorcoding.github.io/asynctnt).
 
 * Support for all the **basic requests** that Tarantool supports. This includes:
   `insert`, `select`, `update`, `upsert`, `call`, `eval`, `execute`.
-* Full support for **SQL**, including prepared statements.
-* Support for **interactive transaction** via Tarantool streams.
-* Support of `Decimal` and `UUID` types natively (starting from Tarantool 2.4.1).
+* Full support for [SQL](https://www.tarantool.io/en/doc/latest/tutorials/sql_tutorial/),
+  including [prepared statements](https://www.tarantool.io/en/doc/latest/reference/reference_lua/box_sql/prepare/).
+* Support for [interactive transaction](https://www.tarantool.io/en/doc/latest/book/box/atomic/txn_mode_mvcc/) via Tarantool streams.
+* Support of `Decimal`, `UUID` and `datetime` types natively.
+* Support for parsing [custom errors](https://www.tarantool.io/en/doc/latest/reference/reference_lua/box_error/new/).
 * **Schema fetching** on connection establishment, so you can use spaces and
   indexes names rather than their ids, and **auto refetching** if schema in
   Tarantool is changed
@@ -142,8 +144,8 @@ async def main():
     conn = asynctnt.Connection(host='127.0.0.1', port=3301)
     await conn.connect()
 
-    await conn.execute("insert into users (id, name) values (1, 'James Bond')")
-    await conn.execute("insert into users (id, name) values (2, 'Ethan Hunt')")
+    await conn.execute("insert into users (id, name) values (?, ?)", [1, 'James Bond'])
+    await conn.execute("insert into users (id, name) values (?, ?)", [2, 'Ethan Hunt'])
     data = await conn.execute('select * from users')
 
     for row in data:
@@ -160,25 +162,36 @@ Stdout:
 <TarantoolTuple ID=2 NAME='Ethan Hunt'>
 ```
 
-More about SQL features in asynctnt please refer to the [documentation](https://igorcoding.github.io/asynctnt/examples.html#using-sql)
+More about SQL features in asynctnt please refer to the [documentation](https://igorcoding.github.io/asynctnt/sql.html)
 
 ## Performance
 
 Two performance tests were conducted:
 1. `Seq` -- Sequentially calling 40k requests and measuring performance
 2. `Parallel` -- Sending 200k in 300 parallel coroutines
 
-On all the benchmarks below `wal_mode = none`
+On all the benchmarks below `wal_mode = none`.
 Turning `uvloop` on has a massive effect on the performance, so it is recommended to use `asynctnt` with it
 
-|          | Seq (uvloop=off) | Seq (uvloop=on) | Parallel (uvloop=off) | Parallel (uvloop=on) |
-|----------|-----------------:|----------------:|----------------------:|---------------------:|
-| `ping`   |          9037.07 |        20372.59 |              44090.53 |            134043.41 |
-| `call`   |          9113.32 |        17279.21 |              41129.16 |             99866.28 |
-| `eval`   |          8921.95 |        16642.67 |              44097.02 |             91056.69 |
-| `select` |          9681.12 |        17730.24 |              35853.33 |            108940.41 |
-| `insert` |          9332.21 |        17384.26 |              31329.85 |            102971.13 |
-| `update` |         10532.75 |        15990.12 |              36281.59 |             98643.46 |
+**Benchmark environment**
+* MacBook Pro 2020
+* CPU: 2 GHz Quad-Core Intel Core i5
+* Memory: 16GB 3733 MHz LPDDR4X
+
+Tarantool:
+```lua
+box.cfg{wal_mode = 'none'}
+```
+
+|           |  Seq (uvloop=off) | Seq (uvloop=on) | Parallel (uvloop=off) | Parallel (uvloop=on) |
+|-----------|------------------:|----------------:|----------------------:|---------------------:|
+| `ping`    |          12940.93 |        19980.82 |              88341.95 |            215756.24 |
+| `call`    |          11586.38 |        18783.56 |              74651.40 |            137557.25 |
+| `eval`    |          10631.19 |        17040.57 |              61077.84 |            121542.42 |
+| `select`  |           9613.88 |        16718.97 |              61584.07 |            152526.21 |
+| `insert`  |          10077.10 |        16989.06 |              65594.82 |            135491.25 |
+| `update`  |          10832.16 |        16562.80 |              63003.31 |            121892.28 |
+| `execute` |          10431.75 |        16967.85 |              58377.81 |             96891.61 |
 
 
 ## License

diff --git a/asynctnt/__init__.py b/asynctnt/__init__.py
@@ -5,4 +5,4 @@
     Db, IProtoError, IProtoErrorStackFrame
 )
 
-__version__ = '2.0.0b1'
+__version__ = '2.0.0b2'
diff --git a/temp/superbench.py → bench/benchmark.py b/temp/superbench.py → bench/benchmark.py
@@ -32,7 +32,7 @@ def main():
         ['execute', ['select 1 as a, 2 as b'], dict(parse_metadata=False)],
     ]
 
-    for use_uvloop in [True, ]:
+    for use_uvloop in [True]:
         if use_uvloop:
             import uvloop
             asyncio.set_event_loop_policy(uvloop.EventLoopPolicy())

diff --git a/temp/init.lua → bench/init.lua b/temp/init.lua → bench/init.lua
diff --git a/temp/bench.py b/temp/bench.py
diff --git a/temp/bench_cmp.py b/temp/bench_cmp.py
diff --git a/temp/bug_push_hangs.py b/temp/bug_push_hangs.py
diff --git a/temp/demo.lua b/temp/demo.lua
diff --git a/temp/demo/demo.py b/temp/demo/demo.py