Improves documentations of the connection class.

- Adds sync class the offer a thread-safe and synchronous API.
- Fixes documentation of adapt functions.
- Removes compose.hpp header.
- Adds test to aedis::error and resp3::type.
- Simplifies some code.

.codecov.yml

@@ -0,0 +1,13 @@
+codecov:
+  max_report_age: off
+  require_ci_to_pass: yes
+  notify:
+    after_n_builds: 1
+    wait_for_ci: yes
+
+ignore:
+  - "benchmarks/cpp/asio/*"
+  - "examples/*"
+  - "tests/*"
+  - "/usr/*"
+  - "**/boost/*"

.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: CI
+
+on: [push, pull_request]
+
+jobs:
+  posix:
+    defaults:
+      run:
+        shell: bash
+
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - { toolset: gcc,   compiler: g++-10,     install: g++-10,   os: ubuntu-22.04, cxxstd: 'c++17' }
+          - { toolset: gcc,   compiler: g++-11,     install: g++-11,   os: ubuntu-22.04, cxxstd: 'c++17' }
+          - { toolset: gcc,   compiler: g++-11,     install: g++-11,   os: ubuntu-22.04, cxxstd: 'c++20' }
+          - { toolset: clang, compiler: clang++-11, install: clang-11, os: ubuntu-22.04, cxxstd: 'c++17' }
+          - { toolset: clang, compiler: clang++-11, install: clang-11, os: ubuntu-22.04, cxxstd: 'c++20' }
+          - { toolset: clang, compiler: clang++-13, install: clang-13, os: ubuntu-22.04, cxxstd: 'c++17' }
+          - { toolset: clang, compiler: clang++-13, install: clang-13, os: ubuntu-22.04, cxxstd: 'c++20' }
+    runs-on: ${{ matrix.os }}
+    env:
+      CXX: ${{ matrix.compiler }}
+      CXXFLAGS: -std=${{matrix.cxxstd}} -Wall -Wextra
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v3
+    - name: Install Autotools
+      run: sudo apt install automake
+    - name: Install compiler
+      run: sudo apt-get install -y ${{ matrix.install }}
+    - name: Install Redis
+      run: sudo apt-get install -y redis-server
+    - name: Install boost
+      uses: MarkusJx/install-boost@v2.3.0
+      id: install-boost
+      with:
+        boost_version: 1.79.0
+        platform_version: 22.04
+    - name: Configure
+      run: |
+        autoreconf -i
+        ./configure --with-boost=${{ steps.install-boost.outputs.BOOST_ROOT }}
+    - name: Build
+      run: make
+    - name: Check
+      run: make check VERBOSE=1

.github/workflows/coverage.yml

@@ -0,0 +1,50 @@
+name: Coverage
+
+on:
+  push:
+    branches:
+      - master
+jobs:
+  posix:
+    defaults:
+      run:
+        shell: bash
+
+    runs-on: ubuntu-22.04
+    env:
+      CXX: g++-11
+      CXXFLAGS: -std=c++20 -Wall -Wextra --coverage -fkeep-inline-functions -fkeep-static-functions -O0
+      LDFLAGS: --coverage
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v3
+    - name: Install Autotools
+      run: sudo apt install automake
+    - name: Install compiler
+      run: sudo apt-get install -y g++-11
+    - name: Install Redis
+      run: sudo apt-get install -y redis-server
+    - name: Install boost
+      uses: MarkusJx/install-boost@v2.3.0
+      id: install-boost
+      with:
+        boost_version: 1.79.0
+        platform_version: 22.04
+    - name: Configure
+      run: |
+        autoreconf -i
+        ./configure --with-boost=${{ steps.install-boost.outputs.BOOST_ROOT }}
+    - name: Build
+      run: make
+    - name: Check
+      run: make check VERBOSE=1
+        #    - name: Generate coverage report
+        #      run: |
+        #        lcov --base-directory . --directory tests/ --output-file aedis.info --capture
+        #        lcov --remove aedis.info '/usr/*' "${{ steps.install-boost.outputs.BOOST_ROOT }}/include/boost/*" --output-file aedis.info
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v3
+      with:
+        gcov: true
+        working_directory: ${{ env.GITHUB_WORKSPACE }}
+

CHANGELOG.md

@@ -0,0 +1,102 @@
+# Changelog
+
+## v1.0.0
+
+* Adds experimental cmake support for windows users.
+
+* Adds new class `aedis::sync` that wraps an `aedis::connection` in
+  a thread-safe and synchronous API.  All free functions from the
+  `sync.hpp` are now member functions of `aedis::sync`.
+
+* Split `aedis::connection::async_receive_event` in two functions, one
+  to receive events and another for server side pushes, see
+  `aedis::connection::async_receive_push`.
+
+* Removes collision between `aedis::adapter::adapt` and
+  `aedis::adapt`.
+
+* Adds `connection::operation` enum to replace `cancel_*` member
+  functions with a single cancel function that gets the operations
+  that should be cancelled as argument.
+
+* Bugfix: a bug on reconnect from a state where the `connection` object
+  had unsent commands. It could cause `async_exec` to never
+  complete under certain conditions.
+
+* Bugfix: Documentation of `adapt()` functions were missing from
+  doxygen.
+
+## v0.3.0
+
+* Adds `experimental::exec` and `receive_event` functions to offer a
+  thread safe and synchronous way of executing requests across
+  threads. See `intro_sync.cpp` and `subscriber_sync.cpp` for
+  examples.
+
+* `connection::async_read_push` was renamed to `async_receive_event`.
+
+* `connection::async_receive_event` is now being used to communicate
+  internal events to the user, such as resolve, connect, push etc. For
+  examples see subscriber.cpp and `connection::event`.
+
+* The `aedis` directory has been moved to `include` to look more
+  similar to Boost libraries. Users should now replace `-I/aedis-path`
+  with `-I/aedis-path/include` in the compiler flags.
+
+* The `AUTH` and `HELLO` commands are now sent automatically. This change was
+  necessary to implement reconnection. The username and password
+  used in `AUTH` should be provided by the user on
+  `connection::config`.
+
+* Adds support for reconnection. See `connection::enable_reconnect`.
+
+* Fixes a bug in the `connection::async_run(host, port)` overload
+  that was causing crashes on reconnection.
+
+* Fixes the executor usage in the connection class. Before theses
+  changes it was imposing `any_io_executor` on users.
+
+* `connection::async_receiver_event` is not cancelled anymore when
+  `connection::async_run` exits. This change makes user code simpler.
+
+* `connection::async_exec` with host and port overload has been
+  removed. Use the other `connection::async_run` overload.
+
+* The host and port parameters from `connection::async_run` have been
+  move to `connection::config` to better support authentication and
+  failover.
+
+* Many simplifications in the `chat_room` example.
+
+* Fixes build in clang the compilers and makes some improvements in
+  the documentation.
+
+## v0.2.1
+
+* Fixes a bug that happens on very high load.
+
+## v0.2.0
+
+* Major rewrite of the high-level API. There is no more need to use the low-level API anymore.
+* No more callbacks: Sending requests follows the ASIO asynchrnous model.
+* Support for reconnection: Pending requests are not canceled when a connection is lost and are re-sent when a new one is established.
+* The library is not sending HELLO-3 on user behalf anymore. This is important to support AUTH properly.
+
+## v0.1.2
+
+* Adds reconnect coroutine in the `echo_server` example.
+* Corrects `client::async_wait_for_data` with `make_parallel_group` to launch operation.
+* Improvements in the documentation.
+* Avoids dynamic memory allocation in the client class after reconnection.
+
+## v0.1.1
+
+* Improves the documentation and adds some features to the high-level client.
+
+## v0.1.0
+
+* Improvements in the design and documentation.
+
+## v0.0.1
+
+* First release to collect design feedback.

CMakeLists.txt

@@ -0,0 +1,50 @@
+# At the moment the official build system is still autotools and this
+# file is meant to support Aedis on windows.
+
+cmake_minimum_required(VERSION 3.14)
+
+project(
+    Aedis
+    VERSION 1.0.0
+    DESCRIPTION "An async redis client designed for performance and scalability"
+    HOMEPAGE_URL "https://mzimbres.github.io/aedis"
+    LANGUAGES CXX
+)
+
+add_library(aedis INTERFACE)
+target_include_directories(aedis INTERFACE include)
+
+find_package(Boost 1.79 REQUIRED)
+include_directories(${Boost_INCLUDE_DIRS})
+
+enable_testing()
+include_directories(include)
+
+add_executable(chat_room examples/chat_room.cpp)
+add_executable(containers examples/containers.cpp)
+add_executable(echo_server examples/echo_server.cpp)
+add_executable(intro examples/intro.cpp)
+add_executable(intro_sync examples/intro_sync.cpp)
+add_executable(serialization examples/serialization.cpp)
+add_executable(subscriber examples/subscriber.cpp)
+add_executable(subscriber_sync examples/subscriber_sync.cpp)
+add_executable(test_low_level tests/low_level.cpp)
+add_executable(test_connection tests/connection.cpp)
+add_executable(low_level_sync tests/low_level_sync.cpp)
+
+add_test(containers containers)
+add_test(intro intro)
+add_test(intro_sync intro_sync)
+add_test(serialization serialization)
+add_test(test_low_level test_low_level)
+add_test(test_connection test_connection)
+add_test(low_level_sync low_level_sync)
+
+include(GNUInstallDirs)
+install(DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/include/boost
+   DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}
+   FILES_MATCHING
+      PATTERN "*.hpp"
+      PATTERN "*.ipp"
+)
+

INSTALL

@@ -1 +0,0 @@
-See file:///tmp/aedis/html/installation.html

LICENSE

@@ -1,373 +0,0 @@
-Mozilla Public License Version 2.0
-==================================
-
-1. Definitions
---------------
-
-1.1. "Contributor"
-    means each individual or legal entity that creates, contributes to
-    the creation of, or owns Covered Software.
-
-1.2. "Contributor Version"
-    means the combination of the Contributions of others (if any) used
-    by a Contributor and that particular Contributor's Contribution.
-
-1.3. "Contribution"
-    means Covered Software of a particular Contributor.
-
-1.4. "Covered Software"
-    means Source Code Form to which the initial Contributor has attached
-    the notice in Exhibit A, the Executable Form of such Source Code
-    Form, and Modifications of such Source Code Form, in each case
-    including portions thereof.
-
-1.5. "Incompatible With Secondary Licenses"
-    means
-
-    (a) that the initial Contributor has attached the notice described
-        in Exhibit B to the Covered Software; or
-
-    (b) that the Covered Software was made available under the terms of
-        version 1.1 or earlier of the License, but not also under the
-        terms of a Secondary License.
-
-1.6. "Executable Form"
-    means any form of the work other than Source Code Form.
-
-1.7. "Larger Work"
-    means a work that combines Covered Software with other material, in
-    a separate file or files, that is not Covered Software.
-
-1.8. "License"
-    means this document.
-
-1.9. "Licensable"
-    means having the right to grant, to the maximum extent possible,
-    whether at the time of the initial grant or subsequently, any and
-    all of the rights conveyed by this License.
-
-1.10. "Modifications"
-    means any of the following:
-
-    (a) any file in Source Code Form that results from an addition to,
-        deletion from, or modification of the contents of Covered
-        Software; or
-
-    (b) any new file in Source Code Form that contains any Covered
-        Software.
-
-1.11. "Patent Claims" of a Contributor
-    means any patent claim(s), including without limitation, method,
-    process, and apparatus claims, in any patent Licensable by such
-    Contributor that would be infringed, but for the grant of the
-    License, by the making, using, selling, offering for sale, having
-    made, import, or transfer of either its Contributions or its
-    Contributor Version.
-
-1.12. "Secondary License"
-    means either the GNU General Public License, Version 2.0, the GNU
-    Lesser General Public License, Version 2.1, the GNU Affero General
-    Public License, Version 3.0, or any later versions of those
-    licenses.
-
-1.13. "Source Code Form"
-    means the form of the work preferred for making modifications.
-
-1.14. "You" (or "Your")
-    means an individual or a legal entity exercising rights under this
-    License. For legal entities, "You" includes any entity that
-    controls, is controlled by, or is under common control with You. For
-    purposes of this definition, "control" means (a) the power, direct
-    or indirect, to cause the direction or management of such entity,
-    whether by contract or otherwise, or (b) ownership of more than
-    fifty percent (50%) of the outstanding shares or beneficial
-    ownership of such entity.
-
-2. License Grants and Conditions
---------------------------------
-
-2.1. Grants
-
-Each Contributor hereby grants You a world-wide, royalty-free,
-non-exclusive license:
-
-(a) under intellectual property rights (other than patent or trademark)
-    Licensable by such Contributor to use, reproduce, make available,
-    modify, display, perform, distribute, and otherwise exploit its
-    Contributions, either on an unmodified basis, with Modifications, or
-    as part of a Larger Work; and
-
-(b) under Patent Claims of such Contributor to make, use, sell, offer
-    for sale, have made, import, and otherwise transfer either its
-    Contributions or its Contributor Version.
-
-2.2. Effective Date
-
-The licenses granted in Section 2.1 with respect to any Contribution
-become effective for each Contribution on the date the Contributor first
-distributes such Contribution.
-
-2.3. Limitations on Grant Scope
-
-The licenses granted in this Section 2 are the only rights granted under
-this License. No additional rights or licenses will be implied from the
-distribution or licensing of Covered Software under this License.
-Notwithstanding Section 2.1(b) above, no patent license is granted by a
-Contributor:
-
-(a) for any code that a Contributor has removed from Covered Software;
-    or
-
-(b) for infringements caused by: (i) Your and any other third party's
-    modifications of Covered Software, or (ii) the combination of its
-    Contributions with other software (except as part of its Contributor
-    Version); or
-
-(c) under Patent Claims infringed by Covered Software in the absence of
-    its Contributions.
-
-This License does not grant any rights in the trademarks, service marks,
-or logos of any Contributor (except as may be necessary to comply with
-the notice requirements in Section 3.4).
-
-2.4. Subsequent Licenses
-
-No Contributor makes additional grants as a result of Your choice to
-distribute the Covered Software under a subsequent version of this
-License (see Section 10.2) or under the terms of a Secondary License (if
-permitted under the terms of Section 3.3).
-
-2.5. Representation
-
-Each Contributor represents that the Contributor believes its
-Contributions are its original creation(s) or it has sufficient rights
-to grant the rights to its Contributions conveyed by this License.
-
-2.6. Fair Use
-
-This License is not intended to limit any rights You have under
-applicable copyright doctrines of fair use, fair dealing, or other
-equivalents.
-
-2.7. Conditions
-
-Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted
-in Section 2.1.
-
-3. Responsibilities
--------------------
-
-3.1. Distribution of Source Form
-
-All distribution of Covered Software in Source Code Form, including any
-Modifications that You create or to which You contribute, must be under
-the terms of this License. You must inform recipients that the Source
-Code Form of the Covered Software is governed by the terms of this
-License, and how they can obtain a copy of this License. You may not
-attempt to alter or restrict the recipients' rights in the Source Code
-Form.
-
-3.2. Distribution of Executable Form
-
-If You distribute Covered Software in Executable Form then:
-
-(a) such Covered Software must also be made available in Source Code
-    Form, as described in Section 3.1, and You must inform recipients of
-    the Executable Form how they can obtain a copy of such Source Code
-    Form by reasonable means in a timely manner, at a charge no more
-    than the cost of distribution to the recipient; and
-
-(b) You may distribute such Executable Form under the terms of this
-    License, or sublicense it under different terms, provided that the
-    license for the Executable Form does not attempt to limit or alter
-    the recipients' rights in the Source Code Form under this License.
-
-3.3. Distribution of a Larger Work
-
-You may create and distribute a Larger Work under terms of Your choice,
-provided that You also comply with the requirements of this License for
-the Covered Software. If the Larger Work is a combination of Covered
-Software with a work governed by one or more Secondary Licenses, and the
-Covered Software is not Incompatible With Secondary Licenses, this
-License permits You to additionally distribute such Covered Software
-under the terms of such Secondary License(s), so that the recipient of
-the Larger Work may, at their option, further distribute the Covered
-Software under the terms of either this License or such Secondary
-License(s).
-
-3.4. Notices
-
-You may not remove or alter the substance of any license notices
-(including copyright notices, patent notices, disclaimers of warranty,
-or limitations of liability) contained within the Source Code Form of
-the Covered Software, except that You may alter any license notices to
-the extent required to remedy known factual inaccuracies.
-
-3.5. Application of Additional Terms
-
-You may choose to offer, and to charge a fee for, warranty, support,
-indemnity or liability obligations to one or more recipients of Covered
-Software. However, You may do so only on Your own behalf, and not on
-behalf of any Contributor. You must make it absolutely clear that any
-such warranty, support, indemnity, or liability obligation is offered by
-You alone, and You hereby agree to indemnify every Contributor for any
-liability incurred by such Contributor as a result of warranty, support,
-indemnity or liability terms You offer. You may include additional
-disclaimers of warranty and limitations of liability specific to any
-jurisdiction.
-
-4. Inability to Comply Due to Statute or Regulation
----------------------------------------------------
-
-If it is impossible for You to comply with any of the terms of this
-License with respect to some or all of the Covered Software due to
-statute, judicial order, or regulation then You must: (a) comply with
-the terms of this License to the maximum extent possible; and (b)
-describe the limitations and the code they affect. Such description must
-be placed in a text file included with all distributions of the Covered
-Software under this License. Except to the extent prohibited by statute
-or regulation, such description must be sufficiently detailed for a
-recipient of ordinary skill to be able to understand it.
-
-5. Termination
---------------
-
-5.1. The rights granted under this License will terminate automatically
-if You fail to comply with any of its terms. However, if You become
-compliant, then the rights granted under this License from a particular
-Contributor are reinstated (a) provisionally, unless and until such
-Contributor explicitly and finally terminates Your grants, and (b) on an
-ongoing basis, if such Contributor fails to notify You of the
-non-compliance by some reasonable means prior to 60 days after You have
-come back into compliance. Moreover, Your grants from a particular
-Contributor are reinstated on an ongoing basis if such Contributor
-notifies You of the non-compliance by some reasonable means, this is the
-first time You have received notice of non-compliance with this License
-from such Contributor, and You become compliant prior to 30 days after
-Your receipt of the notice.
-
-5.2. If You initiate litigation against any entity by asserting a patent
-infringement claim (excluding declaratory judgment actions,
-counter-claims, and cross-claims) alleging that a Contributor Version
-directly or indirectly infringes any patent, then the rights granted to
-You by any and all Contributors for the Covered Software under Section
-2.1 of this License shall terminate.
-
-5.3. In the event of termination under Sections 5.1 or 5.2 above, all
-end user license agreements (excluding distributors and resellers) which
-have been validly granted by You or Your distributors under this License
-prior to termination shall survive termination.
-
-************************************************************************
-*                                                                      *
-*  6. Disclaimer of Warranty                                           *
-*  -------------------------                                           *
-*                                                                      *
-*  Covered Software is provided under this License on an "as is"       *
-*  basis, without warranty of any kind, either expressed, implied, or  *
-*  statutory, including, without limitation, warranties that the       *
-*  Covered Software is free of defects, merchantable, fit for a        *
-*  particular purpose or non-infringing. The entire risk as to the     *
-*  quality and performance of the Covered Software is with You.        *
-*  Should any Covered Software prove defective in any respect, You     *
-*  (not any Contributor) assume the cost of any necessary servicing,   *
-*  repair, or correction. This disclaimer of warranty constitutes an   *
-*  essential part of this License. No use of any Covered Software is   *
-*  authorized under this License except under this disclaimer.         *
-*                                                                      *
-************************************************************************
-
-************************************************************************
-*                                                                      *
-*  7. Limitation of Liability                                          *
-*  --------------------------                                          *
-*                                                                      *
-*  Under no circumstances and under no legal theory, whether tort      *
-*  (including negligence), contract, or otherwise, shall any           *
-*  Contributor, or anyone who distributes Covered Software as          *
-*  permitted above, be liable to You for any direct, indirect,         *
-*  special, incidental, or consequential damages of any character      *
-*  including, without limitation, damages for lost profits, loss of    *
-*  goodwill, work stoppage, computer failure or malfunction, or any    *
-*  and all other commercial damages or losses, even if such party      *
-*  shall have been informed of the possibility of such damages. This   *
-*  limitation of liability shall not apply to liability for death or   *
-*  personal injury resulting from such party's negligence to the       *
-*  extent applicable law prohibits such limitation. Some               *
-*  jurisdictions do not allow the exclusion or limitation of           *
-*  incidental or consequential damages, so this exclusion and          *
-*  limitation may not apply to You.                                    *
-*                                                                      *
-************************************************************************
-
-8. Litigation
--------------
-
-Any litigation relating to this License may be brought only in the
-courts of a jurisdiction where the defendant maintains its principal
-place of business and such litigation shall be governed by laws of that
-jurisdiction, without reference to its conflict-of-law provisions.
-Nothing in this Section shall prevent a party's ability to bring
-cross-claims or counter-claims.
-
-9. Miscellaneous
-----------------
-
-This License represents the complete agreement concerning the subject
-matter hereof. If any provision of this License is held to be
-unenforceable, such provision shall be reformed only to the extent
-necessary to make it enforceable. Any law or regulation which provides
-that the language of a contract shall be construed against the drafter
-shall not be used to construe this License against a Contributor.
-
-10. Versions of the License
----------------------------
-
-10.1. New Versions
-
-Mozilla Foundation is the license steward. Except as provided in Section
-10.3, no one other than the license steward has the right to modify or
-publish new versions of this License. Each version will be given a
-distinguishing version number.
-
-10.2. Effect of New Versions
-
-You may distribute the Covered Software under the terms of the version
-of the License under which You originally received the Covered Software,
-or under the terms of any subsequent version published by the license
-steward.
-
-10.3. Modified Versions
-
-If you create software not governed by this License, and you want to
-create a new license for such software, you may create and use a
-modified version of this License if you rename the license and remove
-any references to the name of the license steward (except to note that
-such modified license differs from this License).
-
-10.4. Distributing Source Code Form that is Incompatible With Secondary
-Licenses
-
-If You choose to distribute Source Code Form that is Incompatible With
-Secondary Licenses under the terms of this version of the License, the
-notice described in Exhibit B of this License must be attached.
-
-Exhibit A - Source Code Form License Notice
--------------------------------------------
-
-  This Source Code Form is subject to the terms of the Mozilla Public
-  License, v. 2.0. If a copy of the MPL was not distributed with this
-  file, You can obtain one at http://mozilla.org/MPL/2.0/.
-
-If it is not possible or desirable to put the notice in a particular
-file, then You may include the notice in a location (such as a LICENSE
-file in a relevant directory) where a recipient would be likely to look
-for such a notice.
-
-You may add additional accurate notices of copyright ownership.
-
-Exhibit B - "Incompatible With Secondary Licenses" Notice
----------------------------------------------------------
-
-  This Source Code Form is "Incompatible With Secondary Licenses", as
-  defined by the Mozilla Public License, v. 2.0.

LICENSE.txt

@@ -0,0 +1,23 @@
+Boost Software License - Version 1.0 - August 17th, 2003
+
+Permission is hereby granted, free of charge, to any person or organization
+obtaining a copy of the software and accompanying documentation covered by
+this license (the "Software") to use, reproduce, display, distribute,
+execute, and transmit the Software, and to prepare derivative works of the
+Software, and to permit third-parties to whom the Software is furnished to
+do so, all subject to the following:
+
+The copyright notices in the Software and this entire statement, including
+the above license grant, this restriction and the following disclaimer,
+must be included in all copies of the Software, in whole or in part, and
+all derivative works of the Software, unless such copies or derivative
+works are solely in the form of machine-executable object code generated by
+a source language processor.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
+SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
+FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.

Makefile.am

@@ -6,30 +6,31 @@ DISTCHECK_CONFIGURE_FLAGS = CPPFLAGS="$(BOOST_CPPFLAGS) $(CPPFLAGS)" LDFLAGS="$(
 
 AM_CPPFLAGS =
 AM_CPPFLAGS += $(BOOST_CPPFLAGS)
+AM_CPPFLAGS += -I$(top_srcdir)/include
 
 AM_LDFLAGS =
 AM_LDFLAGS += -pthread
 
+SUBDIRS = include
+
 check_PROGRAMS =
+check_PROGRAMS += low_level_sync
 check_PROGRAMS += intro
-check_PROGRAMS += sets
-check_PROGRAMS += hashes
+check_PROGRAMS += intro_sync
+check_PROGRAMS += containers
 check_PROGRAMS += serialization
-check_PROGRAMS += multipurpose_response
-check_PROGRAMS += lists
-check_PROGRAMS += key_expiration
-check_PROGRAMS += response_adapter
-check_PROGRAMS += sync
-check_PROGRAMS += multipurpose_client
-check_PROGRAMS += test_offline
-check_PROGRAMS += test_online
-check_PROGRAMS += transaction
+check_PROGRAMS += test_low_level
+check_PROGRAMS += test_connection
 
 EXTRA_PROGRAMS =
+if HAVE_COROUTINES
 EXTRA_PROGRAMS += subscriber
+EXTRA_PROGRAMS += subscriber_sync
 EXTRA_PROGRAMS += echo_server
+EXTRA_PROGRAMS += echo_server_direct
 EXTRA_PROGRAMS += chat_room
-EXTRA_PROGRAMS += commands
+EXTRA_PROGRAMS += echo_server_client
+endif
 
 CLEANFILES =
 CLEANFILES += $(EXTRA_PROGRAMS)
@@ -37,55 +38,23 @@ CLEANFILES += $(EXTRA_PROGRAMS)
 .PHONY: all
 all: $(check_PROGRAMS) $(EXTRA_PROGRAMS)
 
+low_level_sync_SOURCES = $(top_srcdir)/tests/low_level_sync.cpp
+test_low_level_SOURCES = $(top_srcdir)/tests/low_level.cpp
 intro_SOURCES = $(top_srcdir)/examples/intro.cpp
-sets_SOURCES = $(top_srcdir)/examples/sets.cpp
-hashes_SOURCES = $(top_srcdir)/examples/hashes.cpp
+intro_sync_SOURCES = $(top_srcdir)/examples/intro_sync.cpp
+containers_SOURCES = $(top_srcdir)/examples/containers.cpp
 serialization_SOURCES = $(top_srcdir)/examples/serialization.cpp
-multipurpose_response_SOURCES = $(top_srcdir)/examples/multipurpose_response.cpp
-lists_SOURCES = $(top_srcdir)/examples/lists.cpp
-key_expiration_SOURCES = $(top_srcdir)/examples/key_expiration.cpp
-response_adapter_SOURCES = $(top_srcdir)/examples/response_adapter.cpp
-sync_SOURCES = $(top_srcdir)/examples/sync.cpp
-multipurpose_client_SOURCES = $(top_srcdir)/examples/multipurpose_client.cpp
-commands_SOURCES = $(top_srcdir)/tools/commands.cpp
-test_offline_SOURCES = $(top_srcdir)/tests/offline.cpp
-test_online_SOURCES = $(top_srcdir)/tests/online.cpp
+test_connection_SOURCES = $(top_srcdir)/tests/connection.cpp
+subscriber_sync_SOURCES = $(top_srcdir)/examples/subscriber_sync.cpp
+if HAVE_COROUTINES
 subscriber_SOURCES = $(top_srcdir)/examples/subscriber.cpp
-echo_server_SOURCES = $(top_srcdir)/examples/echo_server.cpp
 chat_room_SOURCES = $(top_srcdir)/examples/chat_room.cpp
-transaction_SOURCES = $(top_srcdir)/examples/transaction.cpp
+echo_server_SOURCES = $(top_srcdir)/examples/echo_server.cpp
+echo_server_direct_SOURCES = $(top_srcdir)/benchmarks/cpp/asio/echo_server_direct.cpp
+echo_server_client_SOURCES = $(top_srcdir)/benchmarks/cpp/asio/echo_server_client.cpp
+endif
 
-nobase_include_HEADERS =\
-  $(top_srcdir)/aedis/config.hpp\
-  $(top_srcdir)/aedis/src.hpp\
-  $(top_srcdir)/aedis/redis/command.hpp\
-  $(top_srcdir)/aedis/sentinel/command.hpp\
-  $(top_srcdir)/aedis/aedis.hpp\
-  $(top_srcdir)/aedis/resp3/adapter/detail/adapters.hpp\
-  $(top_srcdir)/aedis/resp3/adapter/error.hpp\
-  $(top_srcdir)/aedis/resp3/adapt.hpp\
-  $(top_srcdir)/aedis/resp3/detail/composer.hpp\
-  $(top_srcdir)/aedis/resp3/detail/read_ops.hpp\
-  $(top_srcdir)/aedis/resp3/detail/parser.hpp\
-  $(top_srcdir)/aedis/resp3/serializer.hpp\
-  $(top_srcdir)/aedis/resp3/response_traits.hpp\
-  $(top_srcdir)/aedis/resp3/node.hpp\
-  $(top_srcdir)/aedis/resp3/error.hpp\
-  $(top_srcdir)/aedis/resp3/type.hpp\
-  $(top_srcdir)/aedis/resp3/read.hpp\
-  $(top_srcdir)/aedis/redis/impl/command.ipp\
-  $(top_srcdir)/aedis/sentinel/impl/command.ipp\
-  $(top_srcdir)/aedis/resp3/detail/impl/parser.ipp\
-  $(top_srcdir)/aedis/resp3/impl/type.ipp\
-  $(top_srcdir)/aedis/resp3/impl/node.ipp\
-  $(top_srcdir)/aedis/redis/experimental/client.hpp\
-  $(top_srcdir)/aedis/redis/experimental/impl/client.ipp
-
-nobase_noinst_HEADERS =\
-  $(top_srcdir)/examples/lib/net_utils.hpp\
-  $(top_srcdir)/examples/lib/user_session.hpp\
-  $(top_srcdir)/tests/check.hpp\
-  $(top_srcdir)/tests/test_stream.hpp
+nobase_noinst_HEADERS = $(top_srcdir)/examples/print.hpp
 
 TESTS = $(check_PROGRAMS)
 
@@ -95,9 +64,33 @@ EXTRA_DIST += $(top_srcdir)/doc/DoxygenLayout.xml
 EXTRA_DIST += $(top_srcdir)/doc/aedis.css
 EXTRA_DIST += $(top_srcdir)/doc/htmlfooter.html
 EXTRA_DIST += $(top_srcdir)/doc/htmlheader.html
+EXTRA_DIST += $(top_srcdir)/benchmarks/benchmarks.md
+EXTRA_DIST += $(top_srcdir)/benchmarks/benchmarks.tex
+EXTRA_DIST += $(top_srcdir)/benchmarks/c/libuv/echo_server_direct.c
+EXTRA_DIST += $(top_srcdir)/benchmarks/c/libuv/README.md
+EXTRA_DIST += $(top_srcdir)/benchmarks/go/echo_server_direct.go
+EXTRA_DIST += $(top_srcdir)/benchmarks/nodejs/echo_server_direct/echo_server_direct.js
+EXTRA_DIST += $(top_srcdir)/benchmarks/nodejs/echo_server_direct/package.json
+EXTRA_DIST += $(top_srcdir)/benchmarks/nodejs/echo_server_over_redis/echo_server_over_redis.js
+EXTRA_DIST += $(top_srcdir)/benchmarks/nodejs/echo_server_over_redis/package.json
+EXTRA_DIST += $(top_srcdir)/benchmarks/rust/echo_server_direct/Cargo.toml
+EXTRA_DIST += $(top_srcdir)/benchmarks/rust/echo_server_direct/src/main.rs
+EXTRA_DIST += $(top_srcdir)/benchmarks/rust/echo_server_over_redis/Cargo.toml
+EXTRA_DIST += $(top_srcdir)/benchmarks/rust/echo_server_over_redis/src/main.rs
+EXTRA_DIST += $(top_srcdir)/CMakeLists.txt
 
 .PHONY: doc
 doc:
-	rm -rf ../aedis-gh-pages/*
 	doxygen doc/Doxyfile
 
+.PHONY: coverage
+coverage:
+	lcov --base-directory . --directory tests/ --output-file aedis.info --capture
+	lcov --remove aedis.info '/usr/*' '/opt/boost_1_79_0/include/boost/*' --output-file aedis.info
+	genhtml --output-directory html aedis.info
+
+.PHONY: bench
+bench:
+	pdflatex --jobname=echo-f0 benchmarks/benchmarks.tex
+	pdflatex --jobname=echo-f1 benchmarks/benchmarks.tex
+

README.md

@@ -1 +1,20 @@
-See https://mzimbres.github.io/aedis/
+Branch          | GH Actions | codecov.io |
+:-------------: | ---------- | ---------- |
+[`master`](https://github.com/mzimbres/aedis/tree/master) | [![CI](https://github.com/mzimbres/aedis/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/mzimbres/aedis/actions/workflows/ci.yml) | [![codecov](https://codecov.io/gh/mzimbres/aedis/branch/master/graph/badge.svg)](https://codecov.io/gh/mzimbres/aedis/branch/master)
+
+## Aedis
+
+An async redis client designed for performance and scalability
+
+### License
+
+Distributed under the [Boost Software License, Version 1.0](http://www.boost.org/LICENSE_1_0.txt).
+
+### More information
+
+* See the official github-pages for documentation: https://mzimbres.github.io/aedis
+
+### Installation
+
+See https://mzimbres.github.io/aedis/#using-aedis
+

aedis/aedis.hpp

@@ -1,183 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#pragma once
-
-#include <aedis/config.hpp>
-#include <aedis/redis/command.hpp>
-#include <aedis/sentinel/command.hpp>
-#include <aedis/resp3/type.hpp>
-#include <aedis/resp3/read.hpp>
-#include <aedis/resp3/adapt.hpp>
-#include <aedis/resp3/error.hpp>
-#include <aedis/resp3/serializer.hpp>
-#include <aedis/resp3/response_traits.hpp>
-#include <aedis/redis/experimental/client.hpp>
-
-/** \mainpage Documentation
-    \tableofcontents
-  
-    \section Overview
-  
-    Aedis is low-level redis client library built on top of Boost.Asio
-    that implements communication with a Redis server over its native
-    protocol RESP3. It has first-class support for STL containers and
-    C++ built in types among other things. You will be able to
-    implement your own redis client or use a general purpose provided
-    by the library. For more information about Redis see
-    https://redis.io/
-  
-    \section examples Examples
-
-    \b Basics: Focuses on small examples that show basic usage of
-    the library.
-
-    - intro.cpp: A good starting point. Some commands are sent to the
-      Redis server and the responses are printed to screen. 
-
-    - transaction.cpp: Shows how to read the responses to a trasaction
-      efficiently. See also https://redis.io/topics/transactions.
-
-    - multipurpose_response.cpp: Shows how to read any responses to
-      Redis commands, including nested aggegagtes.
-
-    - subscriber.cpp: Shows how channel subscription works at a low
-      level. See also https://redis.io/topics/pubsub.
-
-    - sync.cpp: Shows hot to use the Aedis synchronous api.
-
-    - key_expiration.cpp: Shows how to use \c std::optional to deal
-      with keys that may have expired or do not exist.
-
-    \b STL \b Containers: Many of the Redis data structures can be
-    directly translated in to STL containers, below you will find some
-    example code. For a list of Redis data types see
-    https://redis.io/topics/data-types.
-
-    - hashes.cpp: Shows how to read Redis hashes in a \c std::map, \c
-      std::unordered_map and \c std::vector.
-
-    - lists.cpp: Shows how to read Redis lists in \c std::list,
-      \c std::deque, \c std::vector. It also illustrates basic serialization.
-
-    - sets.cpp: Shows how to read Redis sets in a \c std::set, \c
-      std::unordered_set and \c std::vector.
-
-    \b Customization \b points: Shows how de/serialize user types
-    avoiding copies. This is particularly useful for low latency
-    applications that want to avoid unneeded copies, for examples when
-    storing json strings in Redis keys.
-
-    - serialization.cpp: Shows how to de/serialize your own
-      non-aggregate data-structures.
-
-    - response_adapter.cpp: Customization point for users that want to
-      de/serialize their own data-structures like containers for example.
-
-    \b Asynchronous \b servers: Contains some non-trivial examples
-    servers that interact with users and Redis asynchronously over
-    long lasting connections using a higher level API.
-
-    - multipurpose_client.cpp: Shows how to use and experimental high
-      level redis client that keeps a long lasting connections to a
-      redis server. This is the starting point for the next examples.
-
-    - echo_server.cpp: Shows the basic principles behind asynchronous
-      communication with a database in an asynchronous server. In this
-      case, the server is a proxy between the user and Redis.
-
-    - chat_room.cpp: Shows how to build a scalable chat room that
-      scales to millions of users.
-
-    \section using-aedis Using Aedis
-
-    To install and use Aedis you will need
-  
-    - Boost 1.78 or greater.
-    - Unix Shell and Make.
-    - Compiler with C++20 coroutine support e.g. GCC 10 or greater.
-    - Redis server.
-  
-    Some examples will also require interaction with
-  
-    - redis-cli: used in one example.
-    - Redis Sentinel Server: used in some examples.
-  
-    \subsection Installation
-  
-    Start by downloading and configuring the library
-  
-    ```
-    # Download the libray on github.
-    $ wget https://github.com/mzimbres/aedis/release-path # TODO
-  
-    # Uncompress the tarball and cd into the dir
-    $ tar -xzvf aedis-1.0.0.tar.gz && cd aedis-1.0.0
-  
-    # Run configure with appropriate C++ flags and your boost
-    # installation, for example # You may also have to use
-    # -Wno-subobject-linkage on gcc.
-    $ CXXFLAGS="-std=c++20 -fcoroutines -g -Wall"\
-    ./configure  --prefix=/opt/aedis-1.0.0 --with-boost=/opt/boost_1_78_0 --with-boost-libdir=/opt/boost_1_78_0/lib
-  
-    ```
-  
-    To install the library run
-  
-    ```
-    # Install Aedis in the path specified in --prefix
-    $ sudo make install
-  
-    ```
-  
-    At this point you can start using Aedis. To build the examples and
-    test you can also run
-  
-    ```
-    # Build aedis examples.
-    $ make examples
-  
-    # Test aedis in your machine.
-    $ make check
-    ```
-  
-    Finally you will have to include the following header 
-  
-    ```cpp
-    #include <aedis/src.hpp>
-    ```
-    in exactly one source file in your applications.
-  
-    Windows users can use aedis by either adding the project root
-    directory to their include path or manually copying to another
-    location. 
-  
-    \subsection Developers
-  
-    To generate the build system run
-  
-    ```
-    $ autoreconf -i
-    ```
-  
-    After that you will have a config in the project dir that you can
-    run as explained above, for example, to use a compiler other that
-    the system compiler use
-  
-    ```
-    CC=/opt/gcc-10.2.0/bin/gcc-10.2.0\
-    CXX=/opt/gcc-10.2.0/bin/g++-10.2.0\
-    CXXFLAGS="-std=c++20 -fcoroutines -g -Wall -Wno-subobject-linkage -Werror"  ./configure ...
-    ```
-    \section Referece
-  
-    See \subpage any.
- */
-
-/** \defgroup any Reference
- */
-

aedis/config.hpp

@@ -1,16 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#pragma once
-
-// TODO: Remove this.
-#include <boost/asio.hpp>
-
-namespace aedis {
-namespace net = boost::asio;
-}
-

aedis/redis/command.hpp

@@ -1,471 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#pragma once
-
-#include <ostream>
-#include <string>
-
-#include <aedis/resp3/serializer.hpp>
-
-namespace aedis {
-namespace redis {
-
-/** \brief Redis commands.
- *  \ingroup any
- *
- *  For a full list of commands see https://redis.io/commands.
- *
- *  \remark The list of commands below are read from Redis with the
- *  help of the command \c command.
- */
-enum class command {
-   /// https://redis.io/commands/acl
-   acl,
-   /// https://redis.io/commands/append
-   append,
-   /// https://redis.io/commands/asking
-   asking,
-   /// https://redis.io/commands/auth
-   auth,
-   /// https://redis.io/commands/bgrewriteaof
-   bgrewriteaof,
-   /// https://redis.io/commands/bgsave
-   bgsave,
-   /// https://redis.io/commands/bitcount
-   bitcount,
-   /// https://redis.io/commands/bitfield
-   bitfield,
-   /// https://redis.io/commands/bitfield_ro
-   bitfield_ro,
-   /// https://redis.io/commands/bitop
-   bitop,
-   /// https://redis.io/commands/bitpos
-   bitpos,
-   /// https://redis.io/commands/blpop
-   blpop,
-   /// https://redis.io/commands/brpop
-   brpop,
-   /// https://redis.io/commands/brpoplpush
-   brpoplpush,
-   /// https://redis.io/commands/bzpopmax
-   bzpopmax,
-   /// https://redis.io/commands/bzpopmin
-   bzpopmin,
-   /// https://redis.io/commands/client
-   client,
-   /// https://redis.io/commands/cluster
-   cluster,
-   /// https://redis.io/commands/command
-   command,
-   /// https://redis.io/commands/config
-   config,
-   /// https://redis.io/commands/dbsize
-   dbsize,
-   /// https://redis.io/commands/debug
-   debug,
-   /// https://redis.io/commands/decr
-   decr,
-   /// https://redis.io/commands/decrby
-   decrby,
-   /// https://redis.io/commands/del
-   del,
-   /// https://redis.io/commands/discard
-   discard,
-   /// https://redis.io/commands/dump
-   dump,
-   /// https://redis.io/commands/echo
-   echo,
-   /// https://redis.io/commands/eval
-   eval,
-   /// https://redis.io/commands/evalsha
-   evalsha,
-   /// https://redis.io/commands/exec
-   exec,
-   /// https://redis.io/commands/exists
-   exists,
-   /// https://redis.io/commands/expire
-   expire,
-   /// https://redis.io/commands/expireat
-   expireat,
-   /// https://redis.io/commands/flushall
-   flushall,
-   /// https://redis.io/commands/flushdb
-   flushdb,
-   /// https://redis.io/commands/geoadd
-   geoadd,
-   /// https://redis.io/commands/geodist
-   geodist,
-   /// https://redis.io/commands/geohash
-   geohash,
-   /// https://redis.io/commands/geopos
-   geopos,
-   /// https://redis.io/commands/georadius
-   georadius,
-   /// https://redis.io/commands/georadius_ro
-   georadius_ro,
-   /// https://redis.io/commands/georadiusbymember
-   georadiusbymember,
-   /// https://redis.io/commands/georadiusbymember_ro
-   georadiusbymember_ro,
-   /// https://redis.io/commands/get
-   get,
-   /// https://redis.io/commands/getbit
-   getbit,
-   /// https://redis.io/commands/getrange
-   getrange,
-   /// https://redis.io/commands/getset
-   getset,
-   /// https://redis.io/commands/hdel
-   hdel,
-   /// https://redis.io/commands/hello
-   hello,
-   /// https://redis.io/commands/hexists
-   hexists,
-   /// https://redis.io/commands/hget
-   hget,
-   /// https://redis.io/commands/hgetall
-   hgetall,
-   /// https://redis.io/commands/hincrby
-   hincrby,
-   /// https://redis.io/commands/hincrbyfloat
-   hincrbyfloat,
-   /// https://redis.io/commands/hkeys
-   hkeys,
-   /// https://redis.io/commands/hlen
-   hlen,
-   /// https://redis.io/commands/hmget
-   hmget,
-   /// https://redis.io/commands/hmset
-   hmset,
-   /// https://redis.io/commands/hscan
-   hscan,
-   /// https://redis.io/commands/hset
-   hset,
-   /// https://redis.io/commands/hsetnx
-   hsetnx,
-   /// https://redis.io/commands/hstrlen
-   hstrlen,
-   /// https://redis.io/commands/hvals
-   hvals,
-   /// https://redis.io/commands/incr
-   incr,
-   /// https://redis.io/commands/incrby
-   incrby,
-   /// https://redis.io/commands/incrbyfloat
-   incrbyfloat,
-   /// https://redis.io/commands/info
-   info,
-   /// https://redis.io/commands/keys
-   keys,
-   /// https://redis.io/commands/lastsave
-   lastsave,
-   /// https://redis.io/commands/latency
-   latency,
-   /// https://redis.io/commands/lindex
-   lindex,
-   /// https://redis.io/commands/linsert
-   linsert,
-   /// https://redis.io/commands/llen
-   llen,
-   /// https://redis.io/commands/lolwut
-   lolwut,
-   /// https://redis.io/commands/lpop
-   lpop,
-   /// https://redis.io/commands/lpos
-   lpos,
-   /// https://redis.io/commands/lpush
-   lpush,
-   /// https://redis.io/commands/lpushx
-   lpushx,
-   /// https://redis.io/commands/lrange
-   lrange,
-   /// https://redis.io/commands/lrem
-   lrem,
-   /// https://redis.io/commands/lset
-   lset,
-   /// https://redis.io/commands/ltrim
-   ltrim,
-   /// https://redis.io/commands/memory
-   memory,
-   /// https://redis.io/commands/mget
-   mget,
-   /// https://redis.io/commands/migrate
-   migrate,
-   /// https://redis.io/commands/module
-   module,
-   /// https://redis.io/commands/monitor
-   monitor,
-   /// https://redis.io/commands/move
-   move,
-   /// https://redis.io/commands/mset
-   mset,
-   /// https://redis.io/commands/msetnx
-   msetnx,
-   /// https://redis.io/commands/multi
-   multi,
-   /// https://redis.io/commands/object
-   object,
-   /// https://redis.io/commands/persist
-   persist,
-   /// https://redis.io/commands/pexpire
-   pexpire,
-   /// https://redis.io/commands/pexpireat
-   pexpireat,
-   /// https://redis.io/commands/pfadd
-   pfadd,
-   /// https://redis.io/commands/pfcount
-   pfcount,
-   /// https://redis.io/commands/pfdebug
-   pfdebug,
-   /// https://redis.io/commands/pfmerge
-   pfmerge,
-   /// https://redis.io/commands/pfselftest
-   pfselftest,
-   /// https://redis.io/commands/ping
-   ping,
-   /// https://redis.io/commands/post
-   post,
-   /// https://redis.io/commands/psetex
-   psetex,
-   /// https://redis.io/commands/psubscribe
-   psubscribe,
-   /// https://redis.io/commands/psync
-   psync,
-   /// https://redis.io/commands/pttl
-   pttl,
-   /// https://redis.io/commands/publish
-   publish,
-   /// https://redis.io/commands/pubsub
-   pubsub,
-   /// https://redis.io/commands/punsubscribe
-   punsubscribe,
-   /// https://redis.io/commands/randomkey
-   randomkey,
-   /// https://redis.io/commands/readonly
-   readonly,
-   /// https://redis.io/commands/readwrite
-   readwrite,
-   /// https://redis.io/commands/rename
-   rename,
-   /// https://redis.io/commands/renamenx
-   renamenx,
-   /// https://redis.io/commands/replconf
-   replconf,
-   /// https://redis.io/commands/replicaof
-   replicaof,
-   /// https://redis.io/commands/restore
-   restore,
-   /// https://redis.io/commands/role
-   role,
-   /// https://redis.io/commands/rpop
-   rpop,
-   /// https://redis.io/commands/rpoplpush
-   rpoplpush,
-   /// https://redis.io/commands/rpush
-   rpush,
-   /// https://redis.io/commands/rpushx
-   rpushx,
-   /// https://redis.io/commands/sadd
-   sadd,
-   /// https://redis.io/commands/save
-   save,
-   /// https://redis.io/commands/scan
-   scan,
-   /// https://redis.io/commands/scard
-   scard,
-   /// https://redis.io/commands/script
-   script,
-   /// https://redis.io/commands/sdiff
-   sdiff,
-   /// https://redis.io/commands/sdiffstore
-   sdiffstore,
-   /// https://redis.io/commands/select
-   select,
-   /// https://redis.io/commands/set
-   set,
-   /// https://redis.io/commands/setbit
-   setbit,
-   /// https://redis.io/commands/setex
-   setex,
-   /// https://redis.io/commands/setnx
-   setnx,
-   /// https://redis.io/commands/setrange
-   setrange,
-   /// https://redis.io/commands/shutdown
-   shutdown,
-   /// https://redis.io/commands/sinter
-   sinter,
-   /// https://redis.io/commands/sinterstore
-   sinterstore,
-   /// https://redis.io/commands/sismember
-   sismember,
-   /// https://redis.io/commands/slaveof
-   slaveof,
-   /// https://redis.io/commands/slowlog
-   slowlog,
-   /// https://redis.io/commands/smembers
-   smembers,
-   /// https://redis.io/commands/smove
-   smove,
-   /// https://redis.io/commands/sort
-   sort,
-   /// https://redis.io/commands/spop
-   spop,
-   /// https://redis.io/commands/srandmember
-   srandmember,
-   /// https://redis.io/commands/srem
-   srem,
-   /// https://redis.io/commands/sscan
-   sscan,
-   /// https://redis.io/commands/stralgo
-   stralgo,
-   /// https://redis.io/commands/strlen
-   strlen,
-   /// https://redis.io/commands/subscribe
-   subscribe,
-   /// https://redis.io/commands/substr
-   substr,
-   /// https://redis.io/commands/sunion
-   sunion,
-   /// https://redis.io/commands/sunionstore
-   sunionstore,
-   /// https://redis.io/commands/swapdb
-   swapdb,
-   /// https://redis.io/commands/sync
-   sync,
-   /// https://redis.io/commands/time
-   time,
-   /// https://redis.io/commands/touch
-   touch,
-   /// https://redis.io/commands/ttl
-   ttl,
-   /// https://redis.io/commands/type
-   type,
-   /// https://redis.io/commands/unlink
-   unlink,
-   /// https://redis.io/commands/quit
-   quit,
-   /// https://redis.io/commands/unsubscribe
-   unsubscribe,
-   /// https://redis.io/commands/unwatch
-   unwatch,
-   /// https://redis.io/commands/wait
-   wait,
-   /// https://redis.io/commands/watch
-   watch,
-   /// https://redis.io/commands/xack
-   xack,
-   /// https://redis.io/commands/xadd
-   xadd,
-   /// https://redis.io/commands/xclaim
-   xclaim,
-   /// https://redis.io/commands/xdel
-   xdel,
-   /// https://redis.io/commands/xgroup
-   xgroup,
-   /// https://redis.io/commands/xinfo
-   xinfo,
-   /// https://redis.io/commands/xlen
-   xlen,
-   /// https://redis.io/commands/xpending
-   xpending,
-   /// https://redis.io/commands/xrange
-   xrange,
-   /// https://redis.io/commands/xread
-   xread,
-   /// https://redis.io/commands/xreadgroup
-   xreadgroup,
-   /// https://redis.io/commands/xrevrange
-   xrevrange,
-   /// https://redis.io/commands/xsetid
-   xsetid,
-   /// https://redis.io/commands/xtrim
-   xtrim,
-   /// https://redis.io/commands/zadd
-   zadd,
-   /// https://redis.io/commands/zcard
-   zcard,
-   /// https://redis.io/commands/zcount
-   zcount,
-   /// https://redis.io/commands/zincrby
-   zincrby,
-   /// https://redis.io/commands/zinterstore
-   zinterstore,
-   /// https://redis.io/commands/zlexcount
-   zlexcount,
-   /// https://redis.io/commands/zpopmax
-   zpopmax,
-   /// https://redis.io/commands/zpopmin
-   zpopmin,
-   /// https://redis.io/commands/zrange
-   zrange,
-   /// https://redis.io/commands/zrangebylex
-   zrangebylex,
-   /// https://redis.io/commands/zrangebyscore
-   zrangebyscore,
-   /// https://redis.io/commands/zrank
-   zrank,
-   /// https://redis.io/commands/zrem
-   zrem,
-   /// https://redis.io/commands/zremrangebylex
-   zremrangebylex,
-   /// https://redis.io/commands/zremrangebyrank
-   zremrangebyrank,
-   /// https://redis.io/commands/zremrangebyscore
-   zremrangebyscore,
-   /// https://redis.io/commands/zrevrange
-   zrevrange,
-   /// https://redis.io/commands/zrevrangebylex
-   zrevrangebylex,
-   /// https://redis.io/commands/zrevrangebyscore
-   zrevrangebyscore,
-   /// https://redis.io/commands/zrevrank
-   zrevrank,
-   /// https://redis.io/commands/zscan
-   zscan,
-   /// https://redis.io/commands/zscore
-   zscore,
-   /// https://redis.io/commands/zunionstore
-   zunionstore,
-   /// Unknown/invalid command.
-   unknown
-};
-
-/** \brief Converts a command to a string
- *  \ingroup any
- *
- *  \param c The command to convert.
- */
-char const* to_string(command c);
-
-/** \brief Write the text for a command name to an output stream.
- *  \ingroup operators
- *
- *  \param os Output stream.
- *  \param c Redis command
- */
-std::ostream& operator<<(std::ostream& os, command c);
-
-/** \brief Returns true for commands with push response.
- *  \ingroup any
- */
-bool has_push_response(command cmd);
-
-/** \brief Creates a serializer for a \c std::string.
- *  \ingroup any
- *  \param storage The string.
- */
-template <class CharT, class Traits, class Allocator>
-resp3::serializer<std::string, command>
-make_serializer(std::basic_string<CharT, Traits, Allocator>& storage)
-{
-   return resp3::serializer<std::basic_string<CharT, Traits, Allocator>, command>(storage);
-}
-
-} // redis
-} // aedis

aedis/redis/experimental/client.hpp

@@ -1,158 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#pragma once
-
-#include <queue>
-#include <functional>
-
-#include <aedis/aedis.hpp>
-#include <aedis/redis/command.hpp>
-
-namespace aedis {
-namespace resp3 {
-namespace experimental {
-
-/**  \brief A high level redis client.
- *   \ingroup any
- *
- *   This Redis client keeps a connection to the database open and
- *   uses it for all communication with Redis. For examples on how to
- *   use see the examples chat_room.cpp, echo_server.cpp and redis_client.cpp.
- *
- *   \remarks This class reuses its internal buffers for requests and
- *   for reading Redis responses. With time it will allocate less and
- *   less.
- */
-class client : public std::enable_shared_from_this<client> {
-public:
-   /** \brief The extended response adapter type.
-    *
-    *  The difference between the adapter and extended_adapter
-    *  concepts is that the extended get a command redis::parameter.
-    */
-   using extented_adapter_type = std::function<void(redis::command, type, std::size_t, std::size_t, char const*, std::size_t, std::error_code&)>;
-
-   /// The type of the message callback.
-   using on_message_type = std::function<void(std::error_code ec, redis::command)>;
-
-   /// The type of the socket used by the client.
-   //using socket_type = net::use_awaitable_t<>::as_default_on_t<net::ip::tcp::socket>;
-   using socket_type = net::ip::tcp::socket;
-
-private:
-   struct request_info {
-      // Request size in bytes.
-      std::size_t size = 0;
-
-      // The number of commands it contains excluding commands that
-      // have push types as responses, see has_push_response.
-      std::size_t cmds = 0;
-   };
-
-   // Requests payload.
-   std::string requests_;
-
-   // The commands contained in the requests.
-   std::queue<redis::command> commands_;
-
-   // Info about the requests.
-   std::queue<request_info> req_info_;
-
-   // The stream.
-   socket_type socket_;
-
-   // Timer used to inform the write coroutine that it can write the
-   // next message in the output queue.
-   net::steady_timer timer_;
-
-   // Response adapter.
-   extented_adapter_type extended_adapter_ = [](redis::command, type, std::size_t, std::size_t, char const*, std::size_t, std::error_code&) {};
-
-   // Message callback.
-   on_message_type on_msg_ = [](std::error_code ec, redis::command) {};
-
-   // Set when the writer coroutine should stop.
-   bool stop_writer_ = false;
-
-   // A coroutine that keeps reading the socket. When a message
-   // arrives it calls on_message.
-   net::awaitable<void> reader();
-
-   // Write coroutine. It is kept suspended until there are messages
-   // to be sent.
-   net::awaitable<void> writer();
-
-   /* Prepares the back of the queue to receive further commands. 
-    *
-    * If true is returned the request in the front of the queue can be
-    * sent to the server. See async_write_some.
-    */
-   bool prepare_next();
-
-public:
-   /** \brief Client constructor.
-    *
-    *  Constructos the client from an executor.
-    *
-    *  \param ex The executor.
-    */
-   client(net::any_io_executor ex);
-
-   /// Returns the executor used for I/O with Redis.
-   auto get_executor() {return socket_.get_executor();}
-
-   /** \brief Starts communication with Redis.
-    *
-    *  This functions will send the hello command to Redis and spawn
-    *  the read and write coroutines.
-    *
-    *  \param socket A socket that is connected to redis.
-    *
-    *  \returns This function returns an awaitable on which users should \c
-    *  co_await. When the communication with Redis is lost the
-    *  coroutine will finally co_return.
-    */
-   net::awaitable<void> engage(socket_type socket);
-
-   /** \brief Adds a command to the command queue.
-    *
-    *  \sa serializer.hpp
-    */
-   template <class... Ts>
-   void send(redis::command cmd, Ts const&... args);
-
-   /// Sets an extended response adapter.
-   void set_extended_adapter(extented_adapter_type adapter);
-
-   /// Sets the message callback;
-   void set_msg_callback(on_message_type on_msg);
-};
-
-template <class... Ts>
-void client::send(redis::command cmd, Ts const&... args)
-{
-   auto const can_write = prepare_next();
-
-   auto sr = redis::make_serializer(requests_);
-   auto const before = std::size(requests_);
-   sr.push(cmd, args...);
-   auto const after = std::size(requests_);
-   req_info_.front().size += after - before;;
-
-   if (!has_push_response(cmd)) {
-      commands_.emplace(cmd);
-      ++req_info_.front().cmds;
-   }
-
-   if (can_write)
-      timer_.cancel_one();
-}
-
-} // experimental
-} // resp3
-} // aedis

aedis/redis/experimental/impl/client.ipp

@@ -1,200 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#pragma once
-
-#include <aedis/redis/experimental/client.hpp>
-
-#include <boost/asio/experimental/awaitable_operators.hpp>
-
-namespace aedis {
-namespace resp3 {
-namespace experimental {
-
-client::client(net::any_io_executor ex)
-: socket_{ex}
-, timer_{ex}
-{
-   timer_.expires_at(std::chrono::steady_clock::time_point::max());
-}
-
-net::awaitable<void> client::reader()
-{
-   // Writes and reads continuosly from the socket.
-   for (std::string buffer;;) {
-      // Notice this coro can get scheduled while the write operation
-      // in the writer is ongoing. so we have to check.
-      while (!std::empty(req_info_) && req_info_.front().size != 0) {
-         assert(!std::empty(requests_));
-         boost::system::error_code ec;
-         co_await
-            net::async_write(
-               socket_,
-               net::buffer(requests_.data(), req_info_.front().size),
-               net::redirect_error(net::use_awaitable, ec));
-
-	 requests_.erase(0, req_info_.front().size);
-         req_info_.front().size = 0;
-
-	 if (req_info_.front().cmds != 0)
-	    break; // We must await the responses.
-
-	 req_info_.pop();
-      }
-
-      do { // Keeps reading while there are no messages queued waiting to be sent.
-	 do { // Consumes the responses to all commands in the request.
-            boost::system::error_code ec;
-	    auto const t =
-               co_await async_read_type(socket_, net::dynamic_buffer(buffer),
-                     net::redirect_error(net::use_awaitable, ec));
-            if (ec) {
-               stop_writer_ = true;
-               timer_.cancel();
-               co_return;
-            }
-
-	    if (t == type::push) {
-	       auto adapter = [this](type t, std::size_t aggregate_size, std::size_t depth, char const* data, std::size_t size, std::error_code& ec)
-		  {extended_adapter_(redis::command::unknown, t, aggregate_size, depth, data, size, ec);};
-
-	       co_await resp3::async_read(socket_, net::dynamic_buffer(buffer), adapter, net::redirect_error(net::use_awaitable, ec));
-	       on_msg_(ec, redis::command::unknown);
-               if (ec) { // TODO: Return only on non aedis errors.
-                  stop_writer_ = true;
-                  timer_.cancel();
-                  co_return;
-               }
-
-	    } else {
-	       auto adapter = [this](type t, std::size_t aggregate_size, std::size_t depth, char const* data, std::size_t size, std::error_code& ec)
-		  {extended_adapter_(commands_.front(), t, aggregate_size, depth, data, size, ec);};
-
-	       boost::system::error_code ec;
-	       co_await resp3::async_read(socket_, net::dynamic_buffer(buffer), adapter, net::redirect_error(net::use_awaitable, ec));
-	       on_msg_(ec, commands_.front());
-               if (ec) { // TODO: Return only on non aedis errors.
-                  stop_writer_ = true;
-                  timer_.cancel();
-                  co_return;
-               }
-
-	       commands_.pop();
-	       --req_info_.front().cmds;
-	    }
-
-	 } while (!std::empty(req_info_) && req_info_.front().cmds != 0);
-
-	 // We may exit the loop above either because we are done
-	 // with the response or because we received a server push
-	 // while the queue was empty so we have to check before
-	 // poping..
-	 if (!std::empty(req_info_))
-	    req_info_.pop();
-
-      } while (std::empty(req_info_));
-   }
-}
-
-net::awaitable<void> client::writer()
-{
-   boost::system::error_code ec;
-   while (socket_.is_open()) {
-      ec = {};
-      co_await timer_.async_wait(net::redirect_error(net::use_awaitable, ec));
-      if (stop_writer_)
-         co_return;
-
-      // Notice this coro can get scheduled while the write operation
-      // in the reader is ongoing. so we have to check.
-      while (!std::empty(req_info_) && req_info_.front().size != 0) {
-         assert(!std::empty(requests_));
-         ec = {};
-         co_await net::async_write(
-            socket_, net::buffer(requests_.data(), req_info_.front().size),
-            net::redirect_error(net::use_awaitable, ec));
-         if (ec) {
-           // What should we do here exactly? Closing the socket will
-           // cause the reader coroutine to return so that the engage
-           // coroutine returns to the user.
-           socket_.close();
-           co_return;
-         }
-
-         requests_.erase(0, req_info_.front().size);
-         req_info_.front().size = 0;
-         
-         if (req_info_.front().cmds != 0) 
-            break;
-         
-         req_info_.pop();
-      }
-   }
-}
-
-bool client::prepare_next()
-{
-   if (std::empty(req_info_)) {
-      req_info_.push({});
-      return true;
-   }
-
-   if (req_info_.front().size == 0) {
-      // It has already been written and we are waiting for the
-      // responses.
-      req_info_.push({});
-      return false;
-   }
-
-   return false;
-}
-
-void client::set_extended_adapter(extented_adapter_type adapter)
-{
-   extended_adapter_ = adapter;
-}
-
-void client::set_msg_callback(on_message_type on_msg)
-{
-   on_msg_ = on_msg;
-}
-
-net::awaitable<void> client::engage(socket_type socket)
-{
-   using namespace aedis::net::experimental::awaitable_operators;
-
-   socket_ = std::move(socket);
-
-   std::string request;
-   auto sr = redis::make_serializer(request);
-   sr.push(redis::command::hello, 3);
-
-   boost::system::error_code ec;
-   co_await net::async_write(socket_, net::buffer(request), net::redirect_error(net::use_awaitable, ec));
-   if (ec)
-      co_return;
-
-   std::string buffer;
-   auto adapter = [this](type t, std::size_t aggregate_size, std::size_t depth, char const* data, std::size_t size, std::error_code& ec)
-      {extended_adapter_(redis::command::hello, t, aggregate_size, depth, data, size, ec);};
-
-   co_await
-      resp3::async_read(
-         socket_, net::dynamic_buffer(buffer), adapter, net::redirect_error(net::use_awaitable, ec));
-
-   on_msg_(ec, redis::command::hello);
-
-   if (ec)
-      co_return;
-
-   co_await (reader() && writer());
-}
-
-} // experimental
-} // resp3
-} // aedis
-

aedis/redis/impl/command.ipp

@@ -1,245 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#include <aedis/redis/command.hpp>
-
-namespace aedis {
-namespace redis {
-
-char const* to_string(command c)
-{
-   static char const* table[] = {
-      "ACL",
-      "APPEND",
-      "ASKING",
-      "AUTH",
-      "BGREWRITEAOF",
-      "BGSAVE",
-      "BITCOUNT",
-      "BITFIELD",
-      "BITFIELD_RO",
-      "BITOP",
-      "BITPOS",
-      "BLPOP",
-      "BRPOP",
-      "BRPOPLPUSH",
-      "BZPOPMAX",
-      "BZPOPMIN",
-      "CLIENT",
-      "CLUSTER",
-      "COMMAND",
-      "CONFIG",
-      "DBSIZE",
-      "DEBUG",
-      "DECR",
-      "DECRBY",
-      "DEL",
-      "DISCARD",
-      "DUMP",
-      "ECHO",
-      "EVAL",
-      "EVALSHA",
-      "EXEC",
-      "EXISTS",
-      "EXPIRE",
-      "EXPIREAT",
-      "FLUSHALL",
-      "FLUSHDB",
-      "GEOADD",
-      "GEODIST",
-      "GEOHASH",
-      "GEOPOS",
-      "GEORADIUS",
-      "GEORADIUS_RO",
-      "GEORADIUSBYMEMBER",
-      "GEORADIUSBYMEMBER_RO",
-      "GET",
-      "GETBIT",
-      "GETRANGE",
-      "GETSET",
-      "HDEL",
-      "HELLO",
-      "HEXISTS",
-      "HGET",
-      "HGETALL",
-      "HINCRBY",
-      "HINCRBYFLOAT",
-      "HKEYS",
-      "HLEN",
-      "HMGET",
-      "HMSET",
-      "HSCAN",
-      "HSET",
-      "HSETNX",
-      "HSTRLEN",
-      "HVALS",
-      "INCR",
-      "INCRBY",
-      "INCRBYFLOAT",
-      "INFO",
-      "KEYS",
-      "LASTSAVE",
-      "LATENCY",
-      "LINDEX",
-      "LINSERT",
-      "LLEN",
-      "LOLWUT",
-      "LPOP",
-      "LPOS",
-      "LPUSH",
-      "LPUSHX",
-      "LRANGE",
-      "LREM",
-      "LSET",
-      "LTRIM",
-      "MEMORY",
-      "MGET",
-      "MIGRATE",
-      "MODULE",
-      "MONITOR",
-      "MOVE",
-      "MSET",
-      "MSETNX",
-      "MULTI",
-      "OBJECT",
-      "PERSIST",
-      "PEXPIRE",
-      "PEXPIREAT",
-      "PFADD",
-      "PFCOUNT",
-      "PFDEBUG",
-      "PFMERGE",
-      "PFSELFTEST",
-      "PING",
-      "POST",
-      "PSETEX",
-      "PSUBSCRIBE",
-      "PSYNC",
-      "PTTL",
-      "PUBLISH",
-      "PUBSUB",
-      "PUNSUBSCRIBE",
-      "RANDOMKEY",
-      "READONLY",
-      "READWRITE",
-      "RENAME",
-      "RENAMENX",
-      "REPLCONF",
-      "REPLICAOF",
-      "RESTORE",
-      "ROLE",
-      "RPOP",
-      "RPOPLPUSH",
-      "RPUSH",
-      "RPUSHX",
-      "SADD",
-      "SAVE",
-      "SCAN",
-      "SCARD",
-      "SCRIPT",
-      "SDIFF",
-      "SDIFFSTORE",
-      "SELECT",
-      "SET",
-      "SETBIT",
-      "SETEX",
-      "SETNX",
-      "SETRANGE",
-      "SHUTDOWN",
-      "SINTER",
-      "SINTERSTORE",
-      "SISMEMBER",
-      "SLAVEOF",
-      "SLOWLOG",
-      "SMEMBERS",
-      "SMOVE",
-      "SORT",
-      "SPOP",
-      "SRANDMEMBER",
-      "SREM",
-      "SSCAN",
-      "STRALGO",
-      "STRLEN",
-      "SUBSCRIBE",
-      "SUBSTR",
-      "SUNION",
-      "SUNIONSTORE",
-      "SWAPDB",
-      "SYNC",
-      "TIME",
-      "TOUCH",
-      "TTL",
-      "TYPE",
-      "UNLINK",
-      "QUIT",
-      "UNSUBSCRIBE",
-      "UNWATCH",
-      "WAIT",
-      "WATCH",
-      "XACK",
-      "XADD",
-      "XCLAIM",
-      "XDEL",
-      "XGROUP",
-      "XINFO",
-      "XLEN",
-      "XPENDING",
-      "XRANGE",
-      "XREAD",
-      "XREADGROUP",
-      "XREVRANGE",
-      "XSETID",
-      "XTRIM",
-      "ZADD",
-      "ZCARD",
-      "ZCOUNT",
-      "ZINCRBY",
-      "ZINTERSTORE",
-      "ZLEXCOUNT",
-      "ZPOPMAX",
-      "ZPOPMIN",
-      "ZRANGE",
-      "ZRANGEBYLEX",
-      "ZRANGEBYSCORE",
-      "ZRANK",
-      "ZREM",
-      "ZREMRANGEBYLEX",
-      "ZREMRANGEBYRANK",
-      "ZREMRANGEBYSCORE",
-      "ZREVRANGE",
-      "ZREVRANGEBYLEX",
-      "ZREVRANGEBYSCORE",
-      "ZREVRANK",
-      "ZSCAN",
-      "ZSCORE",
-      "ZUNIONSTORE",
-   };
-
-   return table[static_cast<int>(c)];
-}
-
-std::ostream& operator<<(std::ostream& os, command c)
-{
-   os << to_string(c);
-   return os;
-}
-
-bool has_push_response(command cmd)
-{
-   switch (cmd) {
-      case command::subscribe:
-      case command::unsubscribe:
-      case command::psubscribe:
-      return true;
-
-      default:
-      return false;
-   }
-}
-
-} // redis
-} // aedis

aedis/resp3/adapt.hpp

@@ -1,94 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#pragma once
-
-#include <aedis/resp3/response_traits.hpp>
-
-namespace aedis {
-namespace resp3 {
-
-/** \brief Creates a void response adapter.
-    \ingroup any
-  
-    The adapter returned by this function ignores responses and is
-    useful to avoid wasting time with responses which the user is
-    insterested in.
-
-    Example usage:
-
-    @code
-    co_await async_read(socket, buffer, adapt());
-    @endcode
- */
-inline
-auto adapt() noexcept
-   { return response_traits<void>::adapt(); }
-
-/** \brief Adapts user data to read operations.
- *  \ingroup any
- *
- *  For example
- *  The following types are supported.
- *
- *  - Integer data types e.g. `int`, `unsigned`, etc.
- *
- *  - `std::string`
- *
- *  We also support the following C++ containers
- *
- *  - `std::vector<T>`. Can be used with any RESP3 aggregate type.
- *
- *  - `std::deque<T>`. Can be used with any RESP3 aggregate type.
- *
- *  - `std::list<T>`. Can be used with any RESP3 aggregate type.
- *
- *  - `std::set<T>`. Can be used with RESP3 set type.
- *
- *  - `std::unordered_set<T>`. Can be used with RESP3 set type.
- *
- *  - `std::map<T>`. Can be used with RESP3 hash type.
- *
- *  - `std::unordered_map<T>`. Can be used with RESP3 hash type.
- *
- *  All these types can be wrapped in an `std::optional<T>`. This
- *  function also support \c std::tuple to read the response to
- *  tuples. At the moment this feature supports only transactions that
- *  contain simple types or aggregates that don't contain aggregates
- *  themselves (as in most cases).
- *
- *  Example usage:
- *
- *  @code
- *  std::unordered_map<std::string, std::string> cont;
- *  co_await async_read(socket, buffer, adapt(cont));
- *  @endcode
- * 
- *  For a transaction
- *
- *  @code
-    sr.push(command::multi);
-    sr.push(command::ping, ...);
-    sr.push(command::incr, ...);
-    sr.push_range(command::rpush, ...);
-    sr.push(command::lrange, ...);
-    sr.push(command::incr, ...);
-    sr.push(command::exec);
-
-    co_await async_write(socket, buffer(request));
-
-    // Reads the response to a transaction
-    std::tuple<std::string, int, int, std::vector<std::string>, int> execs;
-    co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(execs));
- *  @endcode
- */
-template<class T>
-auto adapt(T& t) noexcept
-   { return response_traits<T>::adapt(t); }
-
-} // resp3
-} // aedis

aedis/resp3/adapter/detail/adapters.hpp

@@ -1,382 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#pragma once
-
-#include <set>
-#include <optional>
-#include <system_error>
-#include <map>
-#include <list>
-#include <deque>
-#include <vector>
-#include <charconv>
-
-#include <aedis/resp3/type.hpp>
-#include <aedis/resp3/node.hpp>
-#include <aedis/resp3/serializer.hpp>
-#include <aedis/resp3/adapter/error.hpp>
-
-namespace aedis {
-namespace resp3 {
-namespace adapter {
-namespace detail {
-
-template <class T>
-typename std::enable_if<std::is_integral<T>::value, void>::type
-from_string(
-   T& i,
-   char const* data,
-   std::size_t data_size,
-   std::error_code& ec)
-{
-   auto const res = std::from_chars(data, data + data_size, i);
-   if (res.ec != std::errc())
-      ec = std::make_error_code(res.ec);
-}
-
-template <class CharT, class Traits, class Allocator>
-void
-from_string(
-   std::basic_string<CharT, Traits, Allocator>& s,
-   char const* data,
-   std::size_t data_size,
-   std::error_code&)
-{
-  s.assign(data, data_size);
-}
-
-void set_on_resp3_error(type t, std::error_code& ec)
-{
-   switch (t) {
-      case type::simple_error: ec = adapter::error::simple_error; return;
-      case type::blob_error: ec = adapter::error::blob_error; return;
-      case type::null: ec = adapter::error::null; return;
-      default: return;
-   }
-}
-
-// For optional responses.
-void set_on_resp3_error2(type t, std::error_code& ec)
-{
-   switch (t) {
-      case type::simple_error: ec = adapter::error::simple_error; return;
-      case type::blob_error: ec = adapter::error::blob_error; return;
-      default: return;
-   }
-}
-
-// Adapter that ignores responses.
-struct ignore {
-   void
-   operator()(
-      type, std::size_t, std::size_t, char const*, std::size_t,
-      std::error_code&) { }
-};
-
-template <class Container>
-class general {
-private:
-   Container* result_;
-
-public:
-   general(Container* c = nullptr): result_(c) {}
-
-   /** @brief Function called by the parser when new data has been processed.
-    *  
-    *  Users who what to customize their response types are required to derive
-    *  from this class and override this function, see examples.
-    *
-    *  \param t The RESP3 type of the data.
-    *
-    *  \param n When t is an aggregate data type this will contain its size
-    *     (see also element_multiplicity) for simple data types this is always 1.
-    *
-    *  \param depth The element depth in the tree.
-    *
-    *  \param data A pointer to the data.
-    *
-    *  \param size The size of data.
-    */
-   void
-   operator()(
-      type t,
-      std::size_t aggregate_size,
-      std::size_t depth,
-      char const* data,
-      std::size_t size,
-      std::error_code&)
-      {
-	 result_->emplace_back(t, aggregate_size, depth, std::string{data, size});
-      }
-};
-
-template <class Node>
-class adapter_node {
-private:
-   Node* result_;
-
-public:
-   adapter_node(Node* t = nullptr) : result_(t) {}
-
-   void
-   operator()(
-      type t,
-      std::size_t aggregate_size,
-      std::size_t depth,
-      char const* data,
-      std::size_t data_size,
-      std::error_code&)
-   {
-     result_->data_type = t;
-     result_->aggregate_size = aggregate_size;
-     result_->depth = depth;
-     result_->data.assign(data, data_size);
-   }
-};
-
-// Adapter for RESP3 simple data types.
-template <class T>
-class simple {
-private:
-   T* result_;
-
-public:
-   simple(T* t = nullptr) : result_(t) {}
-
-   void
-   operator()(
-      type t,
-      std::size_t aggregate_size,
-      std::size_t depth,
-      char const* data,
-      std::size_t data_size,
-      std::error_code& ec)
-   {
-      set_on_resp3_error(t, ec);
-
-      if (is_aggregate(t)) {
-	 ec = adapter::error::expects_simple_type;
-	 return;
-      }
-
-      assert(aggregate_size == 1);
-      from_string(*result_, data, data_size, ec);
-   }
-};
-
-template <class T>
-class simple_optional {
-private:
-  std::optional<T>* result_;
-
-public:
-   simple_optional(std::optional<T>* o = nullptr) : result_(o) {}
-
-   void
-   operator()(
-      type t,
-      std::size_t aggregate_size,
-      std::size_t depth,
-      char const* data,
-      std::size_t data_size,
-      std::error_code& ec)
-   {
-      set_on_resp3_error2(t, ec);
-
-      if (is_aggregate(t)) {
-	 ec = adapter::error::expects_simple_type;
-	 return;
-      }
-
-      assert(aggregate_size == 1);
-
-      if (depth != 0) {
-	 ec = adapter::error::nested_unsupported;
-	 return;
-      }
-
-      if (t == type::null)
-         return;
-
-      if (!result_->has_value())
-        *result_ = T{};
-
-      from_string(result_->value(), data, data_size, ec);
-   }
-};
-
-/* A std::vector adapter.
- */
-template <class Container>
-class vector {
-private:
-   int i_ = -1;
-   Container* result_;
-
-public:
-   vector(Container* v = nullptr) : result_{v} {}
-
-   void
-   operator()(type t,
-       std::size_t aggregate_size,
-       std::size_t depth,
-       char const* data,
-       std::size_t data_size,
-       std::error_code& ec)
-   {
-      set_on_resp3_error(t, ec);
-
-      if (is_aggregate(t)) {
-	 if (i_ != -1) {
-	    ec = adapter::error::nested_unsupported;
-	    return;
-	 }
-
-         auto const m = element_multiplicity(t);
-         result_->resize(m * aggregate_size);
-         ++i_;
-      } else {
-	 assert(aggregate_size == 1);
-
-         from_string(result_->at(i_), data, data_size, ec);
-         ++i_;
-      }
-   }
-};
-
-template <class Container>
-class list {
-private:
-   Container* result_;
-
-public:
-   list(Container* ref = nullptr): result_(ref) {}
-
-   void
-   operator()(type t,
-       std::size_t aggregate_size,
-       std::size_t depth,
-       char const* data,
-       std::size_t data_size,
-       std::error_code& ec)
-   {
-      set_on_resp3_error(t, ec);
-
-      if (is_aggregate(t)) {
-	 if (depth != 0) {
-	    ec = adapter::error::nested_unsupported;
-	    return;
-	 }
-         return;
-      }
-
-      assert(aggregate_size == 1);
-
-      if (depth != 1) {
-	 ec = adapter::error::nested_unsupported;
-	 return;
-      }
-
-      result_->push_back({});
-      from_string(result_->back(), data, data_size, ec);
-   }
-};
-
-template <class Container>
-class set {
-private:
-   Container* result_;
-   typename Container::iterator hint_;
-
-public:
-   set(Container* c = nullptr)
-   : result_(c)
-   , hint_(std::end(*c))
-   {}
-
-   void
-   operator()(type t,
-       std::size_t aggregate_size,
-       std::size_t depth,
-       char const* data,
-       std::size_t data_size,
-       std::error_code& ec)
-   {
-      set_on_resp3_error(t, ec);
-
-      if (t == type::set) {
-        assert(depth == 0);
-        return;
-      }
-
-      assert(!is_aggregate(t));
-
-      assert(depth == 1);
-      assert(aggregate_size == 1);
-
-      typename Container::key_type obj;
-      from_string(obj, data, data_size, ec);
-      if (hint_ == std::end(*result_)) {
-         auto const ret = result_->insert(std::move(obj));
-         hint_ = ret.first;
-      } else {
-         hint_ = result_->insert(hint_, std::move(obj));
-      }
-   }
-};
-
-template <class Container>
-class map {
-private:
-   Container* result_;
-   typename Container::iterator current_;
-   bool on_key_ = true;
-
-public:
-   map(Container* c = nullptr)
-   : result_(c)
-   , current_(std::end(*c))
-   {}
-
-   void
-   operator()(type t,
-       std::size_t aggregate_size,
-       std::size_t depth,
-       char const* data,
-       std::size_t data_size,
-       std::error_code& ec)
-   {
-      set_on_resp3_error(t, ec);
-
-      if (t == type::map) {
-        assert(depth == 0);
-        return;
-      }
-
-      assert(!is_aggregate(t));
-      assert(depth == 1);
-      assert(aggregate_size == 1);
-
-      if (on_key_) {
-         typename Container::key_type obj;
-         from_string(obj, data, data_size, ec);
-         current_ = result_->insert(current_, {std::move(obj), {}});
-      } else {
-         typename Container::mapped_type obj;
-         from_string(obj, data, data_size, ec);
-         current_->second = std::move(obj);
-      }
-
-      on_key_ = !on_key_;
-   }
-};
-
-} // detail
-} // adapter
-} // resp3
-} // aedis

aedis/resp3/adapter/error.hpp

@@ -1,87 +0,0 @@
-#pragma once
-
-# include <system_error>
-
-namespace aedis {
-namespace resp3 {
-namespace adapter {
-
-/** \brief Errors that may occurr when reading a response.
- *  \ingroup any
- */
-enum class error
-{
-   /// Expects a simple RESP3 type but got an aggregate.
-   expects_simple_type = 1,
-
-   /// Nested response not supported.
-   nested_unsupported,
-
-   /// Got RESP3 simple error.
-   simple_error,
-
-   /// Got RESP3 blob_error.
-   blob_error,
-
-   /// The tuple used as response has incompatible size.
-   incompatible_tuple_size,
-
-   /// Got RESP3 null type.
-   null
-};
-
-namespace detail {
-
-struct error_category_impl : std::error_category {
-
-   /// \todo Fix string lifetime.
-   char const* name() const noexcept override
-      { return "aedis.response_adapter"; }
-
-   // TODO: Move to .ipp
-   std::string message(int ev) const override
-   {
-      switch(static_cast<error>(ev)) {
-	 case error::expects_simple_type: return "Expects a simple RESP3 type";
-	 case error::nested_unsupported: return "Nested responses unsupported.";
-	 case error::simple_error: return "Got RESP3 simple-error.";
-	 case error::blob_error: return "Got RESP3 blob-error.";
-	 case error::incompatible_tuple_size: return "The tuple used as response has incompatible size.";
-	 case error::null: return "Got RESP3 null.";
-	 default: assert(false);
-      }
-   }
-};
-
-inline
-std::error_category const& adapter_category()
-{
-  static error_category_impl instance;
-  return instance;
-}
-
-} // detail
-
-inline
-std::error_code make_error_code(error e)
-{
-    static detail::error_category_impl const eci{};
-    return std::error_code{static_cast<int>(e), detail::adapter_category()};
-}
-
-inline
-std::error_condition make_error_condition(error e)
-{
-  return std::error_condition(static_cast<int>(e), detail::adapter_category());
-}
-
-} // adapter
-} // resp3
-} // aedis
-
-namespace std {
-
-template<>
-struct is_error_code_enum<::aedis::resp3::adapter::error> : std::true_type {};
-
-} // std

aedis/resp3/detail/composer.hpp

@@ -1,87 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#pragma once
-
-#include <string>
-#include <string_view>
-#include <utility>
-
-namespace aedis {
-namespace resp3 {
-namespace detail {
-
-template <class>
-struct needs_to_string : std::true_type {};
-
-template <> struct needs_to_string<std::string> : std::false_type {};
-template <> struct needs_to_string<std::string_view> : std::false_type {};
-template <> struct needs_to_string<char const*> : std::false_type {};
-template <> struct needs_to_string<char*> : std::false_type {};
-
-template <std::size_t N>
-struct needs_to_string<char[N]> : std::false_type {};
-
-template <std::size_t N>
-struct needs_to_string<char const[N]> : std::false_type {};
-
-template <class Storage>
-void add_header(Storage& to, int size)
-{
-   // std::string does not support allocators.
-   using std::to_string;
-   auto const str = to_string(size);
-
-   to += "*";
-   to.append(std::cbegin(str), std::cend(str));
-   to += "\r\n";
-}
-
-template <class Storage>
-void add_bulk(Storage& to, std::string_view data)
-{
-   // std::string does not support allocators.
-   using std::to_string;
-   auto const str = to_string(std::size(data));
-
-   to += "$";
-   to.append(std::cbegin(str), std::cend(str));
-   to += "\r\n";
-   to += data;
-   to += "\r\n";
-}
-
-template <class Storage, class T>
-void add_bulk(Storage& to, T const& data, typename std::enable_if<needs_to_string<T>::value, bool>::type = false)
-{
-  using std::to_string;
-  auto const s = to_string(data);
-  add_bulk(to, s);
-}
-
-// Overload for pairs.
-// TODO: Overload for tuples.
-template <class Storage, class T1, class T2>
-void add_bulk(Storage& to, std::pair<T1, T2> const& pair)
-{
-  add_bulk(to, pair.first);
-  add_bulk(to, pair.second);
-}
-
-template <class>
-struct value_type_size {
-  static constexpr auto size = 1U;
-};
-
-template <class T, class U>
-struct value_type_size<std::pair<T, U>> {
-  static constexpr auto size = 2U;
-};
-
-} // detail
-} // resp3
-} // aedis

aedis/resp3/detail/impl/parser.ipp

@@ -1,40 +0,0 @@
-/* Copyright (c) 2019 - 2021 Marcelo Zimbres Silva (mzimbres at gmail dot com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#include <aedis/resp3/detail/parser.hpp>
-#include <aedis/resp3/type.hpp>
-
-namespace aedis {
-namespace resp3 {
-namespace detail {
-
-type to_type(char c)
-{
-   switch (c) {
-      case '!': return type::blob_error;
-      case '=': return type::verbatim_string;
-      case '$': return type::blob_string;
-      case ';': return type::streamed_string_part;
-      case '-': return type::simple_error;
-      case ':': return type::number;
-      case ',': return type::doublean;
-      case '#': return type::boolean;
-      case '(': return type::big_number;
-      case '+': return type::simple_string;
-      case '_': return type::null;
-      case '>': return type::push;
-      case '~': return type::set;
-      case '*': return type::array;
-      case '|': return type::attribute;
-      case '%': return type::map;
-      default: return type::invalid;
-   }
-}
-
-} // detail
-} // resp3
-} // aedis

aedis/resp3/detail/read_ops.hpp

@@ -1,137 +0,0 @@
-/* Copyright (c) 2019 - 2021 Marcelo Zimbres Silva (mzimbres at gmail dot com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#pragma once
-
-#include <string_view>
-
-#include <aedis/config.hpp>
-#include <aedis/resp3/detail/parser.hpp>
-#include <boost/core/ignore_unused.hpp>
-
-namespace aedis {
-namespace resp3 {
-namespace detail {
-
-// TODO: Use asio::coroutine.
-template <
-   class AsyncReadStream,
-   class DynamicBuffer,
-   class ResponseAdapter>
-class parse_op {
-private:
-   AsyncReadStream& stream_;
-   DynamicBuffer buf_;
-   parser<ResponseAdapter> parser_;
-   std::size_t consumed_;
-   int start_;
-
-public:
-   parse_op(AsyncReadStream& stream, DynamicBuffer buf, ResponseAdapter adapter)
-   : stream_ {stream}
-   , buf_ {buf}
-   , parser_ {adapter}
-   , consumed_{0}
-   , start_{1}
-   { }
-
-   template <class Self>
-   void operator()( Self& self
-                  , boost::system::error_code ec = {}
-                  , std::size_t n = 0)
-   {
-      switch (start_) {
-         for (;;) {
-            if (parser_.bulk() == type::invalid) {
-               case 1:
-               start_ = 0;
-               net::async_read_until(stream_, buf_, "\r\n", std::move(self));
-               return;
-            }
-
-	    // On a bulk read we can't read until delimiter since the
-	    // payload may contain the delimiter itself so we have to
-	    // read the whole chunk. However if the bulk blob is small
-	    // enough it may be already on the buffer (from the last
-	    // read), in which case there is no need of initiating
-	    // another async op, otherwise we have to read the missing
-	    // bytes.
-            if (std::size(buf_) < (parser_.bulk_length() + 2)) {
-               start_ = 0;
-	       auto const s = std::size(buf_);
-	       auto const l = parser_.bulk_length();
-	       auto const to_read = l + 2 - s;
-               buf_.grow(to_read);
-               net::async_read(stream_, buf_.data(s, to_read), net::transfer_all(), std::move(self));
-               return;
-            }
-
-            default:
-	    {
-	       if (ec) {
-		  self.complete(ec, 0);
-		  return;
-	       }
-
-	       n = parser_.advance((char const*)buf_.data(0, n).data(), n, ec);
-	       if (ec) {
-		  self.complete(ec, 0);
-		  return;
-	       }
-
-	       buf_.consume(n);
-	       consumed_ += n;
-	       if (parser_.done()) {
-		  self.complete({}, consumed_);
-		  return;
-	       }
-	    }
-         }
-      }
-   }
-};
-
-// TODO: Use asio::coroutine.
-template <class AsyncReadStream, class DynamicBuffer>
-class type_op {
-private:
-   AsyncReadStream& stream_;
-   DynamicBuffer buf_;
-
-public:
-   type_op(AsyncReadStream& stream, DynamicBuffer buf)
-   : stream_ {stream}
-   , buf_ {buf}
-   { }
-
-   template <class Self>
-   void operator()( Self& self
-                  , boost::system::error_code ec = {}
-                  , std::size_t n = 0)
-   {
-      boost::ignore_unused(n);
-
-      if (ec) {
-	 self.complete(ec, type::invalid);
-         return;
-      }
-
-      if (std::size(buf_) == 0) {
-	 net::async_read_until(stream_, buf_, "\r\n", std::move(self));
-	 return;
-      }
-
-      auto const* data = (char const*)buf_.data(0, n).data();
-      auto const type = to_type(*data);
-      self.complete(ec, type);
-      return;
-   }
-};
-
-} // detail
-} // resp3
-} // aedis

aedis/resp3/error.hpp

@@ -1,80 +0,0 @@
-#pragma once
-
-# include <system_error>
-
-/// \file error.hpp
-
-namespace aedis {
-namespace resp3 {
-
-/** \brief RESP3 parsing errors.
- *  \ingroup any
- */
-enum class error
-{
-   /// Invalid RESP3 type.
-   invalid_type = 1,
-
-   /// Can't parse the string as an integer.
-   not_a_number,
-
-   /// Received less bytes than expected.
-   unexpected_read_size,
-
-   /// The maximum depth of a nested response was exceeded.
-   exceeeds_max_nested_depth
-};
-
-namespace detail {
-
-struct error_category_impl : std::error_category {
-
-   char const* name() const noexcept override
-      { return "aedis.resp3"; }
-
-   std::string message(int ev) const override
-   {
-      switch(static_cast<error>(ev)) {
-	 case error::invalid_type: return "Invalid resp3 type.";
-	 case error::not_a_number: return "Can't convert string to number.";
-	 case error::unexpected_read_size: return "Unexpected read size.";
-	 case error::exceeeds_max_nested_depth: return "Exceeds the maximum number of nested responses.";
-	 default: assert(false);
-      }
-   }
-};
-
-inline
-std::error_category const& category()
-{
-  static error_category_impl instance;
-  return instance;
-}
-
-} // detail
-
-/** \brief Converts an error in an std::error_code object.
- *  \ingroup any
- */
-inline
-std::error_code make_error_code(error e)
-{
-    static detail::error_category_impl const eci{};
-    return std::error_code{static_cast<int>(e), detail::category()};
-}
-
-inline
-std::error_condition make_error_condition(error e)
-{
-  return std::error_condition(static_cast<int>(e), detail::category());
-}
-
-} // resp3
-} // aedis
-
-namespace std {
-
-template<>
-struct is_error_code_enum<::aedis::resp3::error> : std::true_type {};
-
-} // std

aedis/resp3/impl/node.ipp

@@ -1,67 +0,0 @@
-/* Copyright (c) 2019 - 2022 Marcelo Zimbres Silva (mzimbres at gmail dot com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#pragma once
-
-#include <aedis/resp3/node.hpp>
-
-namespace aedis {
-namespace resp3 {
-
-std::string to_string(node const& in)
-{
-   std::string out;
-   out += std::to_string(in.depth);
-   out += '\t';
-   out += to_string(in.data_type);
-   out += '\t';
-   out += std::to_string(in.aggregate_size);
-   out += '\t';
-   if (!is_aggregate(in.data_type))
-      out += in.data;
-
-   return out;
-}
-
-bool operator==(node const& a, node const& b)
-{
-   return a.aggregate_size == b.aggregate_size
-       && a.depth == b.depth
-       && a.data_type == b.data_type
-       && a.data == b.data;
-};
-
-std::ostream& operator<<(std::ostream& os, node const& o)
-{
-   os << to_string(o);
-   return os;
-}
-
-std::ostream& operator<<(std::ostream& os, std::vector<node> const& r)
-{
-   os << to_string(r);
-   return os;
-}
-
-// TODO: Output like in redis-cli.
-std::string to_string(std::vector<node> const& vec)
-{
-   if (std::empty(vec))
-      return {};
-
-   auto begin = std::cbegin(vec);
-   std::string res;
-   for (; begin != std::prev(std::cend(vec)); ++begin) {
-      res += to_string(*begin);
-      res += '\n';
-   }
-
-   res += to_string(*begin);
-   return res;
-}
-} // resp3
-} // aedis

aedis/resp3/impl/type.ipp

@@ -1,68 +0,0 @@
-/* Copyright (c) 2019 - 2021 Marcelo Zimbres Silva (mzimbres at gmail dot com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#include <aedis/resp3/type.hpp>
-
-#include <cassert>
-
-namespace aedis {
-namespace resp3 {
-
-char const* to_string(type t)
-{
-   static char const* table[] =
-   { "array"
-   , "push"
-   , "set"
-   , "map"
-   , "attribute"
-   , "simple_string"
-   , "simple_error"
-   , "number"
-   , "doublean"
-   , "boolean"
-   , "big_number"
-   , "null"
-   , "blob_error"
-   , "verbatim_string"
-   , "blob_string"
-   , "streamed_string_part"
-   , "invalid"
-   };
-
-   return table[static_cast<int>(t)];
-}
-
-std::ostream& operator<<(std::ostream& os, type t)
-{
-   os << to_string(t);
-   return os;
-}
-
-bool is_aggregate(type t)
-{
-   switch (t) {
-      case type::array:
-      case type::push:
-      case type::set:
-      case type::map:
-      case type::attribute: return true;
-      default: return false;
-   }
-}
-
-std::size_t element_multiplicity(type t)
-{
-   switch (t) {
-      case type::map:
-      case type::attribute: return 2ULL;
-      default: return 1ULL;
-   }
-}
-
-} // resp3
-} // aedis

aedis/resp3/node.hpp

@@ -1,68 +0,0 @@
-/* Copyright (c) 2019 - 2022 Marcelo Zimbres Silva (mzimbres at gmail dot com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#pragma once
-
-#include <aedis/resp3/type.hpp>
-
-#include <string>
-#include <vector>
-
-namespace aedis {
-namespace resp3 {
-
-/** \brief A node in the response tree.
- *  \ingroup any
- *
- *  Redis responses are the pre-order view of the response tree (see
- *  https://en.wikipedia.org/wiki/Tree_traversal#Pre-order,_NLR).
- */
-struct node {
-   /// The RESP3 type of the data in this node.
-   type data_type;
-
-   /// The number of elements of an aggregate.
-   std::size_t aggregate_size;
-
-   /// The depth of this node in the response tree.
-   std::size_t depth;
-
-   /// The actual data. For aggregate data types this is always empty.
-   std::string data;
-};
-
-/** \brief Converts the node to a string.
- *  \ingroup any
- *
- *  \param obj The node object.
- */
-std::string to_string(node const& obj);
-
-/** \brief Compares a node for equality.
- *  \ingroup any
- */
-bool operator==(node const& a, node const& b);
-
-/** \brief Writes the node to the stream.
- *  \ingroup any
- *
- *  NOTE: Binary data is not converted to text.
- */
-std::ostream& operator<<(std::ostream& os, node const& o);
-
-/** \brief Writes the response to the output stream
- *  \ingroup any
- */
-std::string to_string(std::vector<node> const& vec);
-
-/** \brief Writes the response to the output stream
- *  \ingroup any
- */
-std::ostream& operator<<(std::ostream& os, std::vector<node> const& r);
-
-} // resp3
-} // aedis

aedis/resp3/read.hpp

@@ -1,197 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#pragma once
-
-#include <aedis/config.hpp>
-#include <aedis/resp3/type.hpp>
-#include <aedis/resp3/adapt.hpp>
-#include <aedis/resp3/response_traits.hpp>
-#include <aedis/resp3/detail/parser.hpp>
-#include <aedis/resp3/detail/read_ops.hpp>
-
-#include <boost/asio/yield.hpp>
-
-namespace aedis {
-namespace resp3 {
-
-/** \brief Read the response to a command sychronously.
- *  \ingroup functions
- *
- *  This function has to be called once for each command in the
- *  request until the whole request has been read.
- *
- *  \param stream The stream from which to read.
- *  \param buf Auxiliary read buffer, usually a `std::string`.
- *  \param adapter The response adapter, see adapt.
- *  \param ec Error if any.
- *  \returns The number of bytes that have been consumed from the
- *  auxiliary buffer.
- */
-template <
-  class SyncReadStream,
-  class DynamicBuffer,
-  class ResponseAdapter
-  >
-std::size_t
-read(
-   SyncReadStream& stream,
-   DynamicBuffer buf,
-   ResponseAdapter adapter,
-   boost::system::error_code& ec)
-{
-   detail::parser p {adapter};
-   std::size_t n = 0;
-   std::size_t consumed = 0;
-   do {
-      if (p.bulk() == type::invalid) {
-	 n = net::read_until(stream, buf, "\r\n", ec);
-	 if (ec)
-	    return 0;
-
-	 if (n < 3) {
-            ec = error::unexpected_read_size;
-            return 0;
-         }
-      } else {
-	 auto const s = std::size(buf);
-	 auto const l = p.bulk_length();
-	 if (s < (l + 2)) {
-	    auto const to_read = l + 2 - s;
-	    buf.grow(to_read);
-	    n = net::read(stream, buf.data(s, to_read), ec);
-	    if (ec)
-	       return 0;
-
-            if (n < to_read) {
-               ec = error::unexpected_read_size;
-               return 0;
-            }
-	 }
-      }
-
-      std::error_code ec;
-      auto const* data = (char const*) buf.data(0, n).data();
-      n = p.advance(data, n, ec);
-      if (ec)
-         return 0;
-
-      buf.consume(n);
-      consumed += n;
-   } while (!p.done());
-
-   return consumed;
-}
-
-/** \brief Reads the reponse to a command.
- *  \ingroup functions
- *  
- *  This function has to be called once for each command in the
- *  request until the whole request has been read.
- *
- *  \param stream The stream from which to read.
- *  \param buf Auxiliary read buffer, usually a `std::string`.
- *  \param adapter The response adapter, see adapt.
- *  \returns The number of bytes that have been consumed from the
- *  auxiliary buffer.
- */
-template<
-   class SyncReadStream,
-   class DynamicBuffer,
-   class ResponseAdapter = response_traits<void>::adapter_type>
-std::size_t
-read(
-   SyncReadStream& stream,
-   DynamicBuffer buf,
-   ResponseAdapter adapter = adapt())
-{
-   boost::system::error_code ec;
-   auto const n = resp3::read(stream, buf, adapter, ec);
-
-   if (ec)
-       BOOST_THROW_EXCEPTION(boost::system::system_error{ec});
-
-   return n;
-}
-
-/** @brief Reads the response to a Redis command asynchronously.
- *  \ingroup functions
- *
- *  This function has to be called once for each command in the
- *  request until the whole request has been read.
- *
- *  The completion handler must have the following signature.
- *
- *  @code
- *  void(boost::system::error_code, std::size_t)
- *  @endcode
- *
- *  The second argumet to the completion handler is the number of
- *  bytes that have been consumed in the read operation.
- *
- *  \param stream The stream from which to read.
- *  \param buffer Auxiliary read buffer, usually a `std::string`.
- *  \param adapter The response adapter, see adapt.
- *  \param token The completion token.
- */
-template <
-   class AsyncReadStream,
-   class DynamicBuffer,
-   class ResponseAdapter = response_traits<void>::adapter_type,
-   class CompletionToken = net::default_completion_token_t<typename AsyncReadStream::executor_type>
-   >
-auto async_read(
-   AsyncReadStream& stream,
-   DynamicBuffer buffer,
-   ResponseAdapter adapter = adapt(),
-   CompletionToken&& token =
-      net::default_completion_token_t<typename AsyncReadStream::executor_type>{})
-{
-   return net::async_compose
-      < CompletionToken
-      , void(boost::system::error_code, std::size_t)
-      >(detail::parse_op<AsyncReadStream, DynamicBuffer, ResponseAdapter> {stream, buffer, adapter},
-        token,
-        stream);
-}
-
-/** \brief Reads the RESP3 type of the next incomming.
- *  \ingroup functions
- *
- *  This function won't consume any data from the buffer. The
- *  completion handler must have the following signature.
- *
- *  @code
-    void(boost::system::error_code, type)
- *  @endcode
- *  
- *  \param stream The stream from which to read.
- *  \param buffer Auxiliary read buffer, usually a `std::string`.
- *  \param token The completion token.
- */
-template <
-   class AsyncReadStream,
-   class DynamicBuffer,
-   class CompletionToken =
-      net::default_completion_token_t<typename AsyncReadStream::executor_type>
-   >
-auto async_read_type(
-   AsyncReadStream& stream,
-   DynamicBuffer buffer,
-   CompletionToken&& token =
-      net::default_completion_token_t<typename AsyncReadStream::executor_type>{})
-{
-   return net::async_compose
-      < CompletionToken
-      , void(boost::system::error_code, type)
-      >(detail::type_op<AsyncReadStream, DynamicBuffer> {stream, buffer}, token, stream);
-}
-
-} // resp3
-} // aedis
-
-#include <boost/asio/unyield.hpp>

aedis/resp3/response_traits.hpp

@@ -1,229 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#pragma once
-
-#include <set>
-#include <array>
-#include <unordered_set>
-#include <list>
-#include <deque>
-#include <vector>
-#include <charconv>
-#include <tuple>
-#include <variant>
-
-#include <boost/mp11.hpp>
-
-#include <aedis/resp3/type.hpp>
-#include <aedis/resp3/adapter/detail/adapters.hpp>
-#include <aedis/resp3/adapter/error.hpp>
-
-namespace aedis {
-namespace resp3 {
-
-/** \brief Traits class for response objects.
- *  \ingroup any
- */
-template <class T>
-struct response_traits
-{
-   /// The response type.
-   using response_type = T;
-
-   /// The adapter type.
-   using adapter_type = adapter::detail::simple<response_type>;
-
-   /// Returns an adapter for the reponse r
-   static auto adapt(response_type& r) noexcept { return adapter_type{&r}; }
-};
-
-/// Template typedef for response_traits.
-template <class T>
-using response_traits_t = typename response_traits<T>::adapter_type;
-
-template <class T>
-struct response_traits<std::optional<T>>
-{
-   using response_type = std::optional<T>;
-   using adapter_type = adapter::detail::simple_optional<typename response_type::value_type>;
-   static auto adapt(response_type& i) noexcept { return adapter_type{&i}; }
-};
-
-template <class T, class Allocator>
-struct response_traits<std::vector<T, Allocator>>
-{
-   using response_type = std::vector<T, Allocator>;
-   using adapter_type = adapter::detail::vector<response_type>;
-   static auto adapt(response_type& v) noexcept { return adapter_type{&v}; }
-};
-
-template <>
-struct response_traits<node>
-{
-   using response_type = node;
-   using adapter_type = adapter::detail::adapter_node<response_type>;
-   static auto adapt(response_type& v) noexcept { return adapter_type{&v}; }
-};
-
-template <class Allocator>
-struct response_traits<std::vector<node, Allocator>>
-{
-   using response_type = std::vector<node, Allocator>;
-   using adapter_type = adapter::detail::general<response_type>;
-   static auto adapt(response_type& v) noexcept { return adapter_type{&v}; }
-};
-
-template <class T, class Allocator>
-struct response_traits<std::list<T, Allocator>>
-{
-   using response_type = std::list<T, Allocator>;
-   using adapter_type = adapter::detail::list<response_type>;
-   static auto adapt(response_type& v) noexcept { return adapter_type{&v}; }
-};
-
-template <class T, class Allocator>
-struct response_traits<std::deque<T, Allocator>>
-{
-   using response_type = std::deque<T, Allocator>;
-   using adapter_type = adapter::detail::list<response_type>;
-   static auto adapt(response_type& v) noexcept { return adapter_type{&v}; }
-};
-
-template <class Key, class Compare, class Allocator>
-struct response_traits<std::set<Key, Compare, Allocator>>
-{
-   using response_type = std::set<Key, Compare, Allocator>;
-   using adapter_type = adapter::detail::set<response_type>;
-   static auto adapt(response_type& s) noexcept { return adapter_type{&s}; }
-};
-
-template <class Key, class Hash, class KeyEqual, class Allocator>
-struct response_traits<std::unordered_set<Key, Hash, KeyEqual, Allocator>>
-{
-   using response_type = std::unordered_set<Key, Hash, KeyEqual, Allocator>;
-   using adapter_type = adapter::detail::set<response_type>;
-   static auto adapt(response_type& s) noexcept { return adapter_type{&s}; }
-};
-
-template <class Key, class T, class Compare, class Allocator>
-struct response_traits<std::map<Key, T, Compare, Allocator>>
-{
-   using response_type = std::map<Key, T, Compare, Allocator>;
-   using adapter_type = adapter::detail::map<response_type>;
-   static auto adapt(response_type& s) noexcept { return adapter_type{&s}; }
-};
-
-template <class Key, class Hash, class KeyEqual, class Allocator>
-struct response_traits<std::unordered_map<Key, Hash, KeyEqual, Allocator>>
-{
-   using response_type = std::unordered_map<Key, Hash, KeyEqual, Allocator>;
-   using adapter_type = adapter::detail::map<response_type>;
-   static auto adapt(response_type& s) noexcept { return adapter_type{&s}; }
-};
-
-template <>
-struct response_traits<void>
-{
-   using response_type = void;
-   using adapter_type = adapter::detail::ignore;
-   static auto adapt() noexcept { return adapter_type{}; }
-};
-
-namespace adapter {
-namespace detail {
-
-// Duplicated here to avoid circular include dependency.
-template<class T>
-auto internal_adapt(T& t) noexcept
-   { return response_traits<T>::adapt(t); }
-
-template <std::size_t N>
-struct assigner {
-  template <class T1, class T2>
-  static void assign(T1& dest, T2& from)
-  {
-     dest[N].template emplace<N>(internal_adapt(std::get<N>(from)));
-     assigner<N - 1>::assign(dest, from);
-  }
-};
-
-template <>
-struct assigner<0> {
-  template <class T1, class T2>
-  static void assign(T1& dest, T2& from)
-  {
-     dest[0] = internal_adapt(std::get<0>(from));
-  }
-};
-
-template <class Tuple>
-class flat_transaction_adapter {
-private:
-   using variant_type =
-      boost::mp11::mp_rename<boost::mp11::mp_transform<response_traits_t, Tuple>, std::variant>;
-
-   std::size_t i_ = 0;
-   std::size_t aggregate_size_ = 0;
-   std::array<variant_type, std::tuple_size<Tuple>::value> adapters_;
-
-public:
-   flat_transaction_adapter(Tuple* r)
-      { assigner<std::tuple_size<Tuple>::value - 1>::assign(adapters_, *r); }
-
-   void count(type t, std::size_t aggregate_size, std::size_t depth)
-   {
-      if (depth == 1) {
-         if (is_aggregate(t))
-            aggregate_size_ = aggregate_size;
-         else
-            ++i_;
-
-         return;
-      }
-
-      if (--aggregate_size_ == 0)
-         ++i_;
-   }
-
-   void
-   operator()(
-      type t,
-      std::size_t aggregate_size,
-      std::size_t depth,
-      char const* data,
-      std::size_t size,
-      std::error_code& ec)
-   {
-      if (depth == 0) {
-         if (aggregate_size != std::tuple_size<Tuple>::value) {
-	    ec = adapter::error::incompatible_tuple_size;
-	    return;
-	 }
-
-         return;
-      }
-
-      std::visit([&](auto& arg){arg(t, aggregate_size, depth, data, size, ec);}, adapters_[i_]);
-      count(t, aggregate_size, depth);
-   }
-};
-
-} // detail
-} // adapter
-
-// The adapter of responses to transactions, move it to its own header?
-template <class... Ts>
-struct response_traits<std::tuple<Ts...>>
-{
-   using response_type = std::tuple<Ts...>;
-   using adapter_type = adapter::detail::flat_transaction_adapter<response_type>;
-   static auto adapt(response_type& r) noexcept { return adapter_type{&r}; }
-};
-
-} // resp3
-} // aedis

aedis/resp3/serializer.hpp

@@ -1,157 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#pragma once
-
-#include <aedis/resp3/detail/composer.hpp>
-
-namespace aedis {
-namespace resp3 {
-
-/** @brief Creates a Redis request from user data.
- *  \ingroup any
- *  
- *  A request is composed of one or more redis commands and is
- *  referred to in the redis documentation as a pipeline, see
- *  https://redis.io/topics/pipelining.
- *
- *  For example
- *
- *  @code
- *  std::string request;
- *  auto sr = make_serializer(request);
- *  sr.push(command::hello, 3);
- *  sr.push(command::flushall);
- *  sr.push(command::ping);
- *  sr.push(command::incr, "key");
- *  sr.push(command::quit);
- *  co_await async_write(socket, buffer(request));
- *  @endcode
- *
- *  \tparam Storage The storage type. This is currently a \c std::string.
- *  \tparam Command The command to serialize.
- *
- *  \remarks  Non-string types will be converted to string by using \c
- *  to_string, which must be made available over ADL.
- */
-
-// NOTE: Consider adding an overload for containers.
-//
-// TODO: Should we detect any std::pair or tuple in the type in the parameter
-// pack to calculate the header size correctly?
-//
-// NOTE: For some commands like hset it would be a good idea to assert
-// the value type is a pair.
-template <class Storage, class Command>
-class serializer {
-private:
-   Storage* request_;
-
-public:
-   /** \brief Constructor
-    *  
-    *  \param storage Object where the serialized request will be
-    *  stored.
-    */
-   serializer(Storage& storage) : request_(&storage) {}
-
-   /** @brief Appends a new command to the end of the request.
-    *
-    *  For example
-    *
-    *  \code
-    *  std::string request;
-    *  auto sr = make_serializer<command>(request);
-    *  sr.push(command::set, "key", "some string", "EX", "2");
-    *  \endcode
-    *
-    *  will add the \c set command with payload "some string" and an
-    *  expiration of 2 seconds.
-    *
-    *  \param cmd The redis command.
-    *  \param args The arguments of the Redis command.
-    *
-    */
-   template <class... Ts>
-   void push(Command cmd, Ts const&... args)
-   {
-      auto constexpr pack_size = sizeof...(Ts);
-      detail::add_header(*request_, 1 + pack_size);
-
-      detail::add_bulk(*request_, to_string(cmd));
-      (detail::add_bulk(*request_, args), ...);
-   }
-
-   /** @brief Appends a new command to the end of the request.
-    *  
-    *  This overload is useful for commands that require a key. For example
-    *
-    *  \code{.cpp}
-    *  std::map<std::string, std::string> map
-    *     { {"key1", "value1"}
-    *     , {"key2", "value2"}
-    *     , {"key3", "value3"}
-    *     };
-    *
-    *  request req;
-    *  req.push_range(command::hset, "key", std::cbegin(map), std::cend(map));
-    *  \endcode
-    *  
-    *  \param cmd The Redis command
-    *  \param key The key the Redis command refers to.
-    *  \param begin Iterator to the begin of the range.
-    *  \param end Iterator to the end of the range.
-    */
-   template <class Key, class ForwardIterator>
-   void push_range(Command cmd, Key const& key, ForwardIterator begin, ForwardIterator end)
-   {
-      using value_type = typename std::iterator_traits<ForwardIterator>::value_type;
-
-      auto constexpr size = detail::value_type_size<value_type>::size;
-      auto const distance = std::distance(begin, end);
-      detail::add_header(*request_, 2 + size * distance);
-      detail::add_bulk(*request_, to_string(cmd));
-      detail::add_bulk(*request_, key);
-
-      for (; begin != end; ++begin)
-	 detail::add_bulk(*request_, *begin);
-   }
-
-   /** @brief Appends a new command to the end of the request.
-    *
-    *  This overload is useful for commands that don't have a key. For
-    *  example
-    *
-    *  \code
-    *  std::set<std::string> channels
-    *     { "channel1" , "channel2" , "channel3" }
-    *
-    *  request req;
-    *  req.push(command::subscribe, std::cbegin(channels), std::cedn(channels));
-    *  \endcode
-    *
-    *  \param cmd The Redis command
-    *  \param begin Iterator to the begin of the range.
-    *  \param end Iterator to the end of the range.
-    */
-   template <class ForwardIterator>
-   void push_range(Command cmd, ForwardIterator begin, ForwardIterator end)
-   {
-      using value_type = typename std::iterator_traits<ForwardIterator>::value_type;
-
-      auto constexpr size = detail::value_type_size<value_type>::size;
-      auto const distance = std::distance(begin, end);
-      detail::add_header(*request_, 1 + size * distance);
-      detail::add_bulk(*request_, to_string(cmd));
-
-      for (; begin != end; ++begin)
-	 detail::add_bulk(*request_, *begin);
-   }
-};
-
-} // resp3
-} // aedis

aedis/sentinel/command.hpp

@@ -1,79 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#pragma once
-
-#include <ostream>
-
-namespace aedis {
-namespace sentinel {
-
-/** \brief Sentinel commands.
- *  \ingroup any
- *
- *  For a full list of commands see https://redis.io/topics/sentinel
- *
- *  \remark The list of commands below are read from Redis with the
- *  help of the command \c command.
- */
-enum class command {
-   /// https://redis.io/commands/acl
-   acl,
-   /// https://redis.io/commands/auth
-   auth,
-   /// https://redis.io/commands/client
-   client,
-   /// https://redis.io/commands/command
-   command,
-   /// https://redis.io/commands/hello
-   hello,
-   /// https://redis.io/commands/info
-   info,
-   /// https://redis.io/commands/ping
-   ping,
-   /// https://redis.io/commands/psubscribe
-   psubscribe,
-   /// https://redis.io/commands/publish
-   publish,
-   /// https://redis.io/commands/punsubscribe
-   punsubscribe,
-   /// https://redis.io/commands/role
-   role,
-   /// https://redis.io/topics/sentinel
-   sentinel,
-   /// https://redis.io/commands/shutdown
-   shutdown,
-   /// https://redis.io/commands/subscribe
-   subscribe,
-   /// https://redis.io/commands/unsubscribe
-   unsubscribe,
-   /// Unknown/invalid command.
-   unknown
-};
-
-/** \brief Converts a sentinel command to a string
- *  \ingroup any
- *
- *  \param c The command to convert.
- */
-char const* to_string(command c);
-
-/** \brief Write the text for a sentinel command name to an output stream.
- *  \ingroup operators
- *
- *  \param os Output stream.
- *  \param c Sentinel command
- */
-std::ostream& operator<<(std::ostream& os, command c);
-
-/** \brief Returns true for sentinel commands with push response.
- *  \ingroup any
- */
-bool has_push_response(command cmd);
-
-} // sentinel
-} // aedis

aedis/sentinel/impl/command.ipp

@@ -1,56 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#include <aedis/sentinel/command.hpp>
-
-namespace aedis {
-namespace sentinel {
-
-char const* to_string(command c)
-{
-   static char const* table[] = {
-      "ACL",
-      "AUTH",
-      "CLIENT",
-      "COMMAND",
-      "HELLO",
-      "INFO",
-      "PING",
-      "PSUBSCRIBE",
-      "PUBLISH",
-      "PUNSUBSCRIBE",
-      "ROLE",
-      "SENTINEL",
-      "SHUTDOWN",
-      "SUBSCRIBE",
-      "UNSUBSCRIBE",
-   };
-
-   return table[static_cast<int>(c)];
-}
-
-std::ostream& operator<<(std::ostream& os, command c)
-{
-   os << to_string(c);
-   return os;
-}
-
-bool has_push_response(command cmd)
-{
-   switch (cmd) {
-      case command::subscribe:
-      case command::unsubscribe:
-      case command::psubscribe:
-      return true;
-
-      default:
-      return false;
-   }
-}
-
-} // sentinel
-} // aedis

aedis/src.hpp

@@ -1,15 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-// Include this file in no more than one source file in your application.
-
-#include <aedis/redis/impl/command.ipp>
-#include <aedis/sentinel/impl/command.ipp>
-#include <aedis/resp3/impl/type.ipp>
-#include <aedis/resp3/impl/node.ipp>
-#include <aedis/redis/experimental/impl/client.ipp>
-#include <aedis/resp3/detail/impl/parser.ipp>

benchmarks/benchmarks.md

@@ -0,0 +1,87 @@
+# TCP echo server performance
+
+This document benchmarks the performance of TCP echo servers I
+implemented in different languages using different Redis clients.  The
+main motivations for choosing an echo server are
+
+   * Simple to implement and does not require expertise level in most languages.
+   * I/O bound: Echo servers have very low CPU consumption in general
+     and  therefore are excelent to  measure how a program handles concurrent requests.
+   * It simulates very well a typical backend in regard to concurrency.
+
+I also imposed some constraints on the implementations
+
+   * It should be simple enough and not require writing too much code.
+   * Favor the use standard idioms and avoid optimizations that require expert level.
+   * Avoid the use of complex things like connection and thread pool.
+
+## No Redis
+
+First I tested a pure TCP echo server, i.e. one that sends the messages
+directly to the client without interacting with Redis. The result can
+be seen below
+
+![](https://mzimbres.github.io/aedis/tcp-echo-direct.png)
+
+The tests were performed with a 1000 concurrent TCP connections on the
+localhost where latency is 0.07ms on average on my machine. On higher
+latency networks the difference among libraries is expected to
+decrease. 
+
+### Remarks
+
+   * I expected Libuv to have similar performance to Asio and Tokio.
+   * I did expect nodejs to come a little behind given it is is
+     javascript code. Otherwise I did expect it to have similar
+     performance to libuv since it is the framework behind it.
+   * Go performance did not surprise me: decent and not some much far behind nodejs.
+
+The code used in the benchmarks can be found at
+
+   * [Asio](https://github.com/mzimbres/aedis/blob/3fb018ccc6138d310ac8b73540391cdd8f2fdad6/benchmarks/cpp/asio/echo_server_direct.cpp): A variation of [this](https://github.com/chriskohlhoff/asio/blob/4915cfd8a1653c157a1480162ae5601318553eb8/asio/src/examples/cpp20/coroutines/echo_server.cpp) Asio example.
+   * [Libuv](https://github.com/mzimbres/aedis/tree/835a1decf477b09317f391eddd0727213cdbe12b/benchmarks/c/libuv): Taken from [here](https://github.com/libuv/libuv/blob/06948c6ee502862524f233af4e2c3e4ca876f5f6/docs/code/tcp-echo-server/main.c) Libuv example .
+   * [Tokio](https://github.com/mzimbres/aedis/tree/3fb018ccc6138d310ac8b73540391cdd8f2fdad6/benchmarks/rust/echo_server_direct): Taken from [here](https://docs.rs/tokio/latest/tokio/).
+   * [Nodejs](https://github.com/mzimbres/aedis/tree/3fb018ccc6138d310ac8b73540391cdd8f2fdad6/benchmarks/nodejs/echo_server_direct)
+   * [Go](https://github.com/mzimbres/aedis/blob/3fb018ccc6138d310ac8b73540391cdd8f2fdad6/benchmarks/go/echo_server_direct.go)
+
+## Echo over Redis
+
+This is similar to the echo server described above but messages are
+echoed by Redis and not by the echo-server itself, which acts
+as a proxy between the client and the Redis server. The results
+can be seen below
+
+![](https://mzimbres.github.io/aedis/tcp-echo-over-redis.png)
+
+The tests were performed on a network where latency is 35ms on
+average, otherwise it uses the same number of TCP connections
+as the previous example.
+
+### Remarks
+
+As the reader can see, the Libuv and the Rust test are not depicted
+in the graph, the reasons are
+
+   * [redis-rs](https://github.com/redis-rs/redis-rs): This client
+     comes so far behind that it can't even be represented together
+     with the other benchmarks without making them look insignificant.
+     I don't know for sure why it is so slow, I suppose it has
+     something to do with its lack of proper
+     [pipelining](https://redis.io/docs/manual/pipelining/) support.
+     In fact, the more TCP connections I lauch the worst its
+     performance gets.
+
+   * Libuv: I left it out because it would require too much work to
+     write it and make it have a good performance. More specifically,
+     I would have to use hiredis and implement support for pipelines
+     manually.
+
+The code used in the benchmarks can be found at
+
+   * [Aedis](https://github.com/mzimbres/aedis): [code](https://github.com/mzimbres/aedis/blob/3fb018ccc6138d310ac8b73540391cdd8f2fdad6/examples/echo_server.cpp)
+   * [node-redis](https://github.com/redis/node-redis): [code](https://github.com/mzimbres/aedis/tree/3fb018ccc6138d310ac8b73540391cdd8f2fdad6/benchmarks/nodejs/echo_server_over_redis)
+   * [go-redis](https://github.com/go-redis/redis): [code](https://github.com/mzimbres/aedis/blob/3fb018ccc6138d310ac8b73540391cdd8f2fdad6/benchmarks/go/echo_server_over_redis.go)
+
+## Running the benchmarks
+
+Run one of the echo-server programs in one terminal and the [echo-server-client](https://github.com/mzimbres/aedis/blob/42880e788bec6020dd018194075a211ad9f339e8/benchmarks/cpp/asio/echo_server_client.cpp) in another.

benchmarks/benchmarks.tex

@@ -0,0 +1,73 @@
+\documentclass{article}
+\usepackage{pgfplots}
+\pgfrealjobname{echo}
+\pgfplotsset{compat=newest}
+
+\begin{document}
+
+\beginpgfgraphicnamed{echo-f0}
+% time ./echo_server_client 1000 5000
+\begin{tikzpicture}[scale=1.0]
+  \begin{axis}[
+    y dir=reverse,
+    %xbar stacked,
+    xbar, xmin=0,
+    %hide x axis,
+    bar shift=0pt,
+    width=15cm, height=6cm, enlarge y limits=0.5,
+    title={TCP Echo Server Performance},
+    xlabel={Seconds},
+    symbolic y coords={Asio,Tokio,Libuv,Nodejs,Go},
+    ytick=data,
+    %bar width=1cm,
+    nodes near coords,
+    nodes near coords align={horizontal},
+    ]
+    \addplot coordinates {
+       (31.1,Asio)
+       (30.7,Tokio)
+       (43.6,Libuv)
+       (74.2,Nodejs)
+       (81.0,Go)
+    };
+  \end{axis}
+\end{tikzpicture}
+\endpgfgraphicnamed
+
+\beginpgfgraphicnamed{echo-f1}
+%debian2[0]$ time ./echo_server_client 1000 1000
+%Go  (1):   1.000s
+%C++ (1):   0.07s
+\begin{tikzpicture}[scale=1.0]
+  \begin{axis}[
+    y dir=reverse,
+    %xbar stacked,
+    xbar, xmin=0,
+    %hide x axis,
+    bar shift=0pt,
+    width=12cm, height=6cm, enlarge y limits=0.5,
+     title={TCP Echo Server Performance (over Redis)},
+    xlabel={Seconds},
+    symbolic y coords={Aedis,Rust-rs,Libuv,Node-redis,Go-redis},
+    ytick=data,
+    %bar width=1cm,
+    nodes near coords,
+    nodes near coords align={horizontal},
+    ]
+    \addplot coordinates {
+       (12.6,Aedis)
+       (28.8,Node-redis)
+       (352.4,Go-redis)
+    };
+    %\addplot coordinates {
+    %   (30.0,Asio)
+    %   (90.6,Rust-rs)
+    %   (0.0,Libuv)
+    %   (68.9,Nodejs)
+    %   (0.0,Go)
+    %};
+  \end{axis}
+\end{tikzpicture}
+\endpgfgraphicnamed
+
+\end{document}

benchmarks/c/libuv/README.md

@@ -0,0 +1,7 @@
+This example was taken from
+
+   https://github.com/libuv/libuv/tree/v1.x/docs/code/tcp-echo-server
+
+To build it run, for example
+
+   $ gcc echo_server_direct.c -luv -O2 -o echo_server_direct

benchmarks/c/libuv/echo_server_direct.c

@@ -0,0 +1,87 @@
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <uv.h>
+
+#define DEFAULT_PORT 55555
+#define DEFAULT_BACKLOG 1024
+
+uv_loop_t *loop;
+struct sockaddr_in addr;
+
+typedef struct {
+    uv_write_t req;
+    uv_buf_t buf;
+} write_req_t;
+
+void free_write_req(uv_write_t *req) {
+    write_req_t *wr = (write_req_t*) req;
+    free(wr->buf.base);
+    free(wr);
+}
+
+void alloc_buffer(uv_handle_t *handle, size_t suggested_size, uv_buf_t *buf) {
+    buf->base = (char*) malloc(suggested_size);
+    buf->len = suggested_size;
+}
+
+void on_close(uv_handle_t* handle) {
+    free(handle);
+}
+
+void echo_write(uv_write_t *req, int status) {
+    if (status) {
+        fprintf(stderr, "Write error %s\n", uv_strerror(status));
+    }
+    free_write_req(req);
+}
+
+void echo_read(uv_stream_t *client, ssize_t nread, const uv_buf_t *buf) {
+    if (nread > 0) {
+        write_req_t *req = (write_req_t*) malloc(sizeof(write_req_t));
+        req->buf = uv_buf_init(buf->base, nread);
+        uv_write((uv_write_t*) req, client, &req->buf, 1, echo_write);
+        return;
+    }
+    if (nread < 0) {
+        if (nread != UV_EOF)
+            fprintf(stderr, "Read error %s\n", uv_err_name(nread));
+        uv_close((uv_handle_t*) client, on_close);
+    }
+
+    free(buf->base);
+}
+
+void on_new_connection(uv_stream_t *server, int status) {
+    if (status < 0) {
+        fprintf(stderr, "New connection error %s\n", uv_strerror(status));
+        // error!
+        return;
+    }
+
+    uv_tcp_t *client = (uv_tcp_t*) malloc(sizeof(uv_tcp_t));
+    uv_tcp_init(loop, client);
+    if (uv_accept(server, (uv_stream_t*) client) == 0) {
+        uv_read_start((uv_stream_t*) client, alloc_buffer, echo_read);
+    }
+    else {
+        uv_close((uv_handle_t*) client, on_close);
+    }
+}
+
+int main() {
+    loop = uv_default_loop();
+
+    uv_tcp_t server;
+    uv_tcp_init(loop, &server);
+
+    uv_ip4_addr("0.0.0.0", DEFAULT_PORT, &addr);
+
+    uv_tcp_bind(&server, (const struct sockaddr*)&addr, 0);
+    int r = uv_listen((uv_stream_t*) &server, DEFAULT_BACKLOG, on_new_connection);
+    if (r) {
+        fprintf(stderr, "Listen error %s\n", uv_strerror(r));
+        return 1;
+    }
+    return uv_run(loop, UV_RUN_DEFAULT);
+}

benchmarks/cpp/asio/echo_server_client.cpp

@@ -0,0 +1,64 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#include <iostream>
+#include <boost/asio.hpp>
+
+namespace net = boost::asio;
+
+using net::ip::tcp;
+using tcp_socket = net::use_awaitable_t<>::as_default_on_t<net::ip::tcp::socket>;
+using timer_type = net::use_awaitable_t<>::as_default_on_t<net::steady_timer>;
+
+net::awaitable<void>
+example(boost::asio::ip::tcp::endpoint ep, std::string msg, int n)
+{
+   try {
+      auto ex = co_await net::this_coro::executor;
+
+      tcp_socket socket{ex};
+      co_await socket.async_connect(ep);
+
+      std::string buffer;
+      auto dbuffer = net::dynamic_buffer(buffer);
+      for (int i = 0; i < n; ++i) {
+         co_await net::async_write(socket, net::buffer(msg));
+         auto n = co_await net::async_read_until(socket, dbuffer, "\n");
+         //std::printf("> %s", buffer.data());
+         dbuffer.consume(n);
+      }
+
+      //std::printf("Ok: %s", msg.data());
+   } catch (std::exception const& e) {
+      std::cerr << "Error: " << e.what() << std::endl;
+   }
+}
+
+int main(int argc, char* argv[])
+{
+   try {
+      int sessions = 1;
+      int msgs = 1;
+
+      if (argc == 3) {
+         sessions = std::stoi(argv[1]);
+         msgs = std::stoi(argv[2]);
+      }
+
+      net::io_context ioc;
+
+      tcp::resolver resv{ioc};
+      auto const res = resv.resolve("127.0.0.1", "55555");
+      auto ep = *std::begin(res);
+
+      for (int i = 0; i < sessions; ++i)
+         net::co_spawn(ioc, example(ep, "Some message\n", msgs), net::detached);
+
+      ioc.run();
+   } catch (std::exception const& e) {
+      std::cerr << e.what() << std::endl;
+   }
+}

benchmarks/cpp/asio/echo_server_direct.cpp

@@ -0,0 +1,58 @@
+//
+// echo_server.cpp
+// ~~~~~~~~~~~~~~~
+//
+// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+
+#include <cstdio>
+#include <boost/asio.hpp>
+
+namespace net = boost::asio;
+namespace this_coro = net::this_coro;
+using net::ip::tcp;
+using net::detached;
+using executor_type = net::io_context::executor_type;
+using socket_type = net::basic_stream_socket<net::ip::tcp, executor_type>;
+using tcp_socket = net::use_awaitable_t<executor_type>::as_default_on_t<socket_type>;
+using acceptor_type = net::basic_socket_acceptor<net::ip::tcp, executor_type>;
+using tcp_acceptor = net::use_awaitable_t<executor_type>::as_default_on_t<acceptor_type>;
+using awaitable_type = net::awaitable<void, executor_type>;
+constexpr net::use_awaitable_t<executor_type> use_awaitable;
+
+awaitable_type echo(tcp_socket socket)
+{
+  try {
+     char data[1024];
+     for (;;) {
+        std::size_t n = co_await socket.async_read_some(net::buffer(data), use_awaitable);
+        co_await async_write(socket, net::buffer(data, n), use_awaitable);
+     }
+  } catch (std::exception const& e) {
+     //std::printf("echo Exception: %s\n", e.what());
+  }
+}
+
+awaitable_type listener()
+{
+  auto ex = co_await this_coro::executor;
+  tcp_acceptor acceptor(ex, {tcp::v4(), 55555});
+  for (;;) {
+     tcp_socket socket = co_await acceptor.async_accept(use_awaitable);
+     co_spawn(ex, echo(std::move(socket)), detached);
+  }
+}
+
+int main()
+{
+  try {
+     net::io_context io_context{BOOST_ASIO_CONCURRENCY_HINT_UNSAFE_IO};
+     co_spawn(io_context, listener(), detached);
+     io_context.run();
+  } catch (std::exception const& e) {
+     std::printf("Exception: %s\n", e.what());
+  }
+}

benchmarks/go/echo_server_direct.go

@@ -0,0 +1,41 @@
+package main
+
+import (
+	"bufio"
+	"fmt"
+	"io"
+	"net"
+	"os"
+)
+
+func echo(conn net.Conn) {
+	r := bufio.NewReader(conn)
+	for {
+		line, err := r.ReadBytes(byte('\n'))
+		switch err {
+		case nil:
+			break
+		case io.EOF:
+		default:
+			fmt.Println("ERROR", err)
+		}
+		conn.Write(line)
+	}
+}
+
+func main() {
+	l, err := net.Listen("tcp", "0.0.0.0:55555")
+	if err != nil {
+		fmt.Println("ERROR", err)
+		os.Exit(1)
+	}
+
+	for {
+		conn, err := l.Accept()
+		if err != nil {
+			fmt.Println("ERROR", err)
+			continue
+		}
+		go echo(conn)
+	}
+}

benchmarks/go/echo_server_over_redis.go

@@ -0,0 +1,54 @@
+package main
+
+import (
+    "context"
+    "github.com/go-redis/redis/v8"
+     "bufio"
+     "fmt"
+     "io"
+     "net"
+     "os"
+)
+
+var ctx = context.Background()
+var rdb = redis.NewClient(&redis.Options{Addr: "db.occase.de:6379", Password: "", DB: 0,})
+
+func echo(conn net.Conn) {
+	r := bufio.NewReader(conn)
+	for {
+		line, err := r.ReadBytes(byte('\n'))
+		switch err {
+		case nil:
+			break
+		case io.EOF:
+		default:
+			fmt.Println("ERROR", err)
+		}
+
+               err2 := rdb.Ping(ctx).Err()
+               if err2 != nil {
+                  fmt.Println("ERROR", err2)
+                  panic(err2)
+               }
+
+	       conn.Write(line)
+	}
+}
+
+func main() {
+	l, err := net.Listen("tcp", "0.0.0.0:55555")
+	if err != nil {
+		fmt.Println("ERROR", err)
+		os.Exit(1)
+	}
+
+	for {
+		conn, err := l.Accept()
+		if err != nil {
+			fmt.Println("ERROR", err)
+			continue
+		}
+
+		go echo(conn)
+	}
+}

benchmarks/java/echo_server_direct/TcpEchoServer.java

@@ -0,0 +1,105 @@
+import java.nio.*;
+import java.nio.channels.*;
+import java.net.*;
+import java.util.*;
+import java.io.IOException;
+
+public class TcpEchoServer {
+
+  public static int DEFAULT_PORT = 55555;
+
+ public static void main(String[] args) {
+int port;
+   try {
+      port = Integer.parseInt(args[0]);
+    }
+
+    catch (Exception ex) {
+      port = DEFAULT_PORT;
+    }
+
+    //System.out.println("Listening for connections on port " + port);
+    ServerSocketChannel serverChannel;
+    Selector selector;
+    try {
+      serverChannel = ServerSocketChannel.open( );
+      ServerSocket ss = serverChannel.socket( );
+      InetSocketAddress address = new InetSocketAddress(port);
+      ss.bind(address);
+      serverChannel.configureBlocking(false);
+      selector = Selector.open( );
+      serverChannel.register(selector, SelectionKey.OP_ACCEPT);
+    }
+    catch (IOException ex) {
+      ex.printStackTrace( );
+      return;
+    }
+   while (true) {
+     try {
+        selector.select( );
+      }
+      catch (IOException ex) {
+        ex.printStackTrace( );
+        break;
+      }
+      Set readyKeys = selector.selectedKeys( );
+      Iterator iterator = readyKeys.iterator( );
+      while (iterator.hasNext( )) {
+       SelectionKey key = (SelectionKey) iterator.next( );
+        iterator.remove( );
+        try {
+          if (key.isAcceptable( )) {
+            ServerSocketChannel server = (ServerSocketChannel ) key.channel( );
+            SocketChannel client = server.accept( );
+            //System.out.println("Accepted connection from " + client);
+            client.configureBlocking(false);
+            SelectionKey clientKey = client.register(
+              selector, SelectionKey.OP_WRITE | SelectionKey.OP_READ);
+            ByteBuffer buffer = ByteBuffer.allocate(100);
+            clientKey.attach(buffer);
+           //System.out.println(buffer.toString());
+
+          }
+
+          if (key.isReadable( )) {
+            SocketChannel client = (SocketChannel) key.channel( );
+            ByteBuffer output = (ByteBuffer) key.attachment( );
+            client.read(output);
+          }
+
+          if (key.isWritable( )) {
+            SocketChannel client = (SocketChannel) key.channel( );
+            ByteBuffer output = (ByteBuffer) key.attachment( );
+            output.flip( );
+            client.write(output);
+            output.compact( );
+
+    }
+
+        }
+
+        catch (IOException ex) {
+          key.cancel( );
+          try {
+            key.channel().close();
+        }
+
+          catch (IOException cex) {}
+
+        }
+
+
+
+      }
+
+
+
+    }
+
+
+
+  }
+
+
+
+}

benchmarks/nodejs/echo_server_direct/echo_server_direct.js

@@ -0,0 +1,7 @@
+var net = require('net');
+
+net.createServer(function(socket){
+    socket.on('data', function(data){
+        socket.write(data.toString())
+    });
+}).listen(55555);

benchmarks/nodejs/echo_server_direct/package.json

@@ -0,0 +1,2 @@
+{
+}

benchmarks/nodejs/echo_server_over_redis/echo_server_over_redis.js

@@ -0,0 +1,13 @@
+import { createClient } from 'redis';
+import * as net from 'net';
+
+const client = createClient({url: 'redis://db.occase.de:6379' });
+client.on('error', (err) => console.log('Redis Client Error', err));
+await client.connect();
+
+net.createServer(function(socket){
+   socket.on('data', async function(data) {
+      const value = await client.ping(data.toString());
+      socket.write(data)
+   });
+}).listen(55555);

benchmarks/nodejs/echo_server_over_redis/package-lock.json

@@ -0,0 +1,169 @@
+{
+   "name": "echo_server_over_redis",
+   "lockfileVersion": 2,
+   "requires": true,
+   "packages": {
+      "": {
+         "dependencies": {
+            "redis": "^4.2.0"
+         }
+      },
+      "node_modules/@redis/bloom": {
+         "version": "1.0.2",
+         "resolved": "https://registry.npmjs.org/@redis/bloom/-/bloom-1.0.2.tgz",
+         "integrity": "sha512-EBw7Ag1hPgFzdznK2PBblc1kdlj5B5Cw3XwI9/oG7tSn85/HKy3X9xHy/8tm/eNXJYHLXHJL/pkwBpFMVVefkw==",
+         "peerDependencies": {
+            "@redis/client": "^1.0.0"
+         }
+      },
+      "node_modules/@redis/client": {
+         "version": "1.2.0",
+         "resolved": "https://registry.npmjs.org/@redis/client/-/client-1.2.0.tgz",
+         "integrity": "sha512-a8Nlw5fv2EIAFJxTDSSDVUT7yfBGpZO96ybZXzQpgkyLg/dxtQ1uiwTc0EGfzg1mrPjZokeBSEGTbGXekqTNOg==",
+         "dependencies": {
+            "cluster-key-slot": "1.1.0",
+            "generic-pool": "3.8.2",
+            "yallist": "4.0.0"
+         },
+         "engines": {
+            "node": ">=14"
+         }
+      },
+      "node_modules/@redis/graph": {
+         "version": "1.0.1",
+         "resolved": "https://registry.npmjs.org/@redis/graph/-/graph-1.0.1.tgz",
+         "integrity": "sha512-oDE4myMCJOCVKYMygEMWuriBgqlS5FqdWerikMoJxzmmTUErnTRRgmIDa2VcgytACZMFqpAOWDzops4DOlnkfQ==",
+         "peerDependencies": {
+            "@redis/client": "^1.0.0"
+         }
+      },
+      "node_modules/@redis/json": {
+         "version": "1.0.3",
+         "resolved": "https://registry.npmjs.org/@redis/json/-/json-1.0.3.tgz",
+         "integrity": "sha512-4X0Qv0BzD9Zlb0edkUoau5c1bInWSICqXAGrpwEltkncUwcxJIGEcVryZhLgb0p/3PkKaLIWkjhHRtLe9yiA7Q==",
+         "peerDependencies": {
+            "@redis/client": "^1.0.0"
+         }
+      },
+      "node_modules/@redis/search": {
+         "version": "1.0.6",
+         "resolved": "https://registry.npmjs.org/@redis/search/-/search-1.0.6.tgz",
+         "integrity": "sha512-pP+ZQRis5P21SD6fjyCeLcQdps+LuTzp2wdUbzxEmNhleighDDTD5ck8+cYof+WLec4csZX7ks+BuoMw0RaZrA==",
+         "peerDependencies": {
+            "@redis/client": "^1.0.0"
+         }
+      },
+      "node_modules/@redis/time-series": {
+         "version": "1.0.3",
+         "resolved": "https://registry.npmjs.org/@redis/time-series/-/time-series-1.0.3.tgz",
+         "integrity": "sha512-OFp0q4SGrTH0Mruf6oFsHGea58u8vS/iI5+NpYdicaM+7BgqBZH8FFvNZ8rYYLrUO/QRqMq72NpXmxLVNcdmjA==",
+         "peerDependencies": {
+            "@redis/client": "^1.0.0"
+         }
+      },
+      "node_modules/cluster-key-slot": {
+         "version": "1.1.0",
+         "resolved": "https://registry.npmjs.org/cluster-key-slot/-/cluster-key-slot-1.1.0.tgz",
+         "integrity": "sha512-2Nii8p3RwAPiFwsnZvukotvow2rIHM+yQ6ZcBXGHdniadkYGZYiGmkHJIbZPIV9nfv7m/U1IPMVVcAhoWFeklw==",
+         "engines": {
+            "node": ">=0.10.0"
+         }
+      },
+      "node_modules/generic-pool": {
+         "version": "3.8.2",
+         "resolved": "https://registry.npmjs.org/generic-pool/-/generic-pool-3.8.2.tgz",
+         "integrity": "sha512-nGToKy6p3PAbYQ7p1UlWl6vSPwfwU6TMSWK7TTu+WUY4ZjyZQGniGGt2oNVvyNSpyZYSB43zMXVLcBm08MTMkg==",
+         "engines": {
+            "node": ">= 4"
+         }
+      },
+      "node_modules/redis": {
+         "version": "4.2.0",
+         "resolved": "https://registry.npmjs.org/redis/-/redis-4.2.0.tgz",
+         "integrity": "sha512-bCR0gKVhIXFg8zCQjXEANzgI01DDixtPZgIUZHBCmwqixnu+MK3Tb2yqGjh+HCLASQVVgApiwhNkv+FoedZOGQ==",
+         "dependencies": {
+            "@redis/bloom": "1.0.2",
+            "@redis/client": "1.2.0",
+            "@redis/graph": "1.0.1",
+            "@redis/json": "1.0.3",
+            "@redis/search": "1.0.6",
+            "@redis/time-series": "1.0.3"
+         }
+      },
+      "node_modules/yallist": {
+         "version": "4.0.0",
+         "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz",
+         "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A=="
+      }
+   },
+   "dependencies": {
+      "@redis/bloom": {
+         "version": "1.0.2",
+         "resolved": "https://registry.npmjs.org/@redis/bloom/-/bloom-1.0.2.tgz",
+         "integrity": "sha512-EBw7Ag1hPgFzdznK2PBblc1kdlj5B5Cw3XwI9/oG7tSn85/HKy3X9xHy/8tm/eNXJYHLXHJL/pkwBpFMVVefkw==",
+         "requires": {}
+      },
+      "@redis/client": {
+         "version": "1.2.0",
+         "resolved": "https://registry.npmjs.org/@redis/client/-/client-1.2.0.tgz",
+         "integrity": "sha512-a8Nlw5fv2EIAFJxTDSSDVUT7yfBGpZO96ybZXzQpgkyLg/dxtQ1uiwTc0EGfzg1mrPjZokeBSEGTbGXekqTNOg==",
+         "requires": {
+            "cluster-key-slot": "1.1.0",
+            "generic-pool": "3.8.2",
+            "yallist": "4.0.0"
+         }
+      },
+      "@redis/graph": {
+         "version": "1.0.1",
+         "resolved": "https://registry.npmjs.org/@redis/graph/-/graph-1.0.1.tgz",
+         "integrity": "sha512-oDE4myMCJOCVKYMygEMWuriBgqlS5FqdWerikMoJxzmmTUErnTRRgmIDa2VcgytACZMFqpAOWDzops4DOlnkfQ==",
+         "requires": {}
+      },
+      "@redis/json": {
+         "version": "1.0.3",
+         "resolved": "https://registry.npmjs.org/@redis/json/-/json-1.0.3.tgz",
+         "integrity": "sha512-4X0Qv0BzD9Zlb0edkUoau5c1bInWSICqXAGrpwEltkncUwcxJIGEcVryZhLgb0p/3PkKaLIWkjhHRtLe9yiA7Q==",
+         "requires": {}
+      },
+      "@redis/search": {
+         "version": "1.0.6",
+         "resolved": "https://registry.npmjs.org/@redis/search/-/search-1.0.6.tgz",
+         "integrity": "sha512-pP+ZQRis5P21SD6fjyCeLcQdps+LuTzp2wdUbzxEmNhleighDDTD5ck8+cYof+WLec4csZX7ks+BuoMw0RaZrA==",
+         "requires": {}
+      },
+      "@redis/time-series": {
+         "version": "1.0.3",
+         "resolved": "https://registry.npmjs.org/@redis/time-series/-/time-series-1.0.3.tgz",
+         "integrity": "sha512-OFp0q4SGrTH0Mruf6oFsHGea58u8vS/iI5+NpYdicaM+7BgqBZH8FFvNZ8rYYLrUO/QRqMq72NpXmxLVNcdmjA==",
+         "requires": {}
+      },
+      "cluster-key-slot": {
+         "version": "1.1.0",
+         "resolved": "https://registry.npmjs.org/cluster-key-slot/-/cluster-key-slot-1.1.0.tgz",
+         "integrity": "sha512-2Nii8p3RwAPiFwsnZvukotvow2rIHM+yQ6ZcBXGHdniadkYGZYiGmkHJIbZPIV9nfv7m/U1IPMVVcAhoWFeklw=="
+      },
+      "generic-pool": {
+         "version": "3.8.2",
+         "resolved": "https://registry.npmjs.org/generic-pool/-/generic-pool-3.8.2.tgz",
+         "integrity": "sha512-nGToKy6p3PAbYQ7p1UlWl6vSPwfwU6TMSWK7TTu+WUY4ZjyZQGniGGt2oNVvyNSpyZYSB43zMXVLcBm08MTMkg=="
+      },
+      "redis": {
+         "version": "4.2.0",
+         "resolved": "https://registry.npmjs.org/redis/-/redis-4.2.0.tgz",
+         "integrity": "sha512-bCR0gKVhIXFg8zCQjXEANzgI01DDixtPZgIUZHBCmwqixnu+MK3Tb2yqGjh+HCLASQVVgApiwhNkv+FoedZOGQ==",
+         "requires": {
+            "@redis/bloom": "1.0.2",
+            "@redis/client": "1.2.0",
+            "@redis/graph": "1.0.1",
+            "@redis/json": "1.0.3",
+            "@redis/search": "1.0.6",
+            "@redis/time-series": "1.0.3"
+         }
+      },
+      "yallist": {
+         "version": "4.0.0",
+         "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz",
+         "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A=="
+      }
+   }
+}

benchmarks/nodejs/echo_server_over_redis/package.json

@@ -0,0 +1,6 @@
+{
+   "type": "module",
+   "dependencies": {
+      "redis": "^4.2.0"
+   }
+}

benchmarks/rust/echo_server_direct/Cargo.lock

@@ -0,0 +1,309 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 3
+
+[[package]]
+name = "autocfg"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d468802bab17cbc0cc575e9b053f41e72aa36bfa6b7f55e3529ffa43161b97fa"
+
+[[package]]
+name = "bitflags"
+version = "1.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
+
+[[package]]
+name = "bytes"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c4872d67bab6358e59559027aa3b9157c53d9358c51423c17554809a8858e0f8"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
+
+[[package]]
+name = "echo_server_direct"
+version = "0.1.0"
+dependencies = [
+ "tokio",
+]
+
+[[package]]
+name = "hermit-abi"
+version = "0.1.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "62b467343b94ba476dcb2500d242dadbb39557df889310ac77c5d99100aaac33"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.126"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "349d5a591cd28b49e1d1037471617a32ddcda5731b99419008085f72d5a53836"
+
+[[package]]
+name = "lock_api"
+version = "0.4.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "327fa5b6a6940e4699ec49a9beae1ea4845c6bab9314e4f84ac68742139d8c53"
+dependencies = [
+ "autocfg",
+ "scopeguard",
+]
+
+[[package]]
+name = "log"
+version = "0.4.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "abb12e687cfb44aa40f41fc3978ef76448f9b6038cad6aef4259d3c095a2382e"
+dependencies = [
+ "cfg-if",
+]
+
+[[package]]
+name = "memchr"
+version = "2.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2dffe52ecf27772e601905b7522cb4ef790d2cc203488bbd0e2fe85fcb74566d"
+
+[[package]]
+name = "mio"
+version = "0.8.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "57ee1c23c7c63b0c9250c339ffdc69255f110b298b901b9f6c82547b7b87caaf"
+dependencies = [
+ "libc",
+ "log",
+ "wasi",
+ "windows-sys",
+]
+
+[[package]]
+name = "num_cpus"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "19e64526ebdee182341572e50e9ad03965aa510cd94427a4549448f285e957a1"
+dependencies = [
+ "hermit-abi",
+ "libc",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "18a6dbe30758c9f83eb00cbea4ac95966305f5a7772f3f42ebfc7fc7eddbd8e1"
+
+[[package]]
+name = "parking_lot"
+version = "0.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3742b2c103b9f06bc9fff0a37ff4912935851bee6d36f3c02bcc755bcfec228f"
+dependencies = [
+ "lock_api",
+ "parking_lot_core",
+]
+
+[[package]]
+name = "parking_lot_core"
+version = "0.9.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09a279cbf25cb0757810394fbc1e359949b59e348145c643a939a525692e6929"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "redox_syscall",
+ "smallvec",
+ "windows-sys",
+]
+
+[[package]]
+name = "pin-project-lite"
+version = "0.2.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e0a7ae3ac2f1173085d398531c705756c94a4c56843785df85a60c1a0afac116"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.39"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c54b25569025b7fc9651de43004ae593a75ad88543b17178aa5e1b9c4f15f56f"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f53dc8cf16a769a6f677e09e7ff2cd4be1ea0f48754aac39520536962011de0d"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "redox_syscall"
+version = "0.2.13"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "62f25bc4c7e55e0b0b7a1d43fb893f4fa1361d0abe38b9ce4f323c2adfe6ef42"
+dependencies = [
+ "bitflags",
+]
+
+[[package]]
+name = "scopeguard"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d29ab0c6d3fc0ee92fe66e2d99f700eab17a8d57d1c1d3b748380fb20baa78cd"
+
+[[package]]
+name = "signal-hook-registry"
+version = "1.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e51e73328dc4ac0c7ccbda3a494dfa03df1de2f46018127f60c693f2648455b0"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "smallvec"
+version = "1.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2fd0db749597d91ff862fd1d55ea87f7855a744a8425a64695b6fca237d1dad1"
+
+[[package]]
+name = "socket2"
+version = "0.4.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "66d72b759436ae32898a2af0a14218dbf55efde3feeb170eb623637db85ee1e0"
+dependencies = [
+ "libc",
+ "winapi",
+]
+
+[[package]]
+name = "syn"
+version = "1.0.98"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c50aef8a904de4c23c788f104b7dddc7d6f79c647c7c8ce4cc8f73eb0ca773dd"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "tokio"
+version = "1.20.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "57aec3cfa4c296db7255446efb4928a6be304b431a806216105542a67b6ca82e"
+dependencies = [
+ "autocfg",
+ "bytes",
+ "libc",
+ "memchr",
+ "mio",
+ "num_cpus",
+ "once_cell",
+ "parking_lot",
+ "pin-project-lite",
+ "signal-hook-registry",
+ "socket2",
+ "tokio-macros",
+ "winapi",
+]
+
+[[package]]
+name = "tokio-macros"
+version = "1.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9724f9a975fb987ef7a3cd9be0350edcbe130698af5b8f7a631e23d42d052484"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5bd2fe26506023ed7b5e1e315add59d6f584c621d037f9368fea9cfb988f368c"
+
+[[package]]
+name = "wasi"
+version = "0.11.0+wasi-snapshot-preview1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423"
+
+[[package]]
+name = "winapi"
+version = "0.3.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5c839a674fcd7a98952e593242ea400abe93992746761e38641405d28b00f419"
+dependencies = [
+ "winapi-i686-pc-windows-gnu",
+ "winapi-x86_64-pc-windows-gnu",
+]
+
+[[package]]
+name = "winapi-i686-pc-windows-gnu"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6"
+
+[[package]]
+name = "winapi-x86_64-pc-windows-gnu"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f"
+
+[[package]]
+name = "windows-sys"
+version = "0.36.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ea04155a16a59f9eab786fe12a4a450e75cdb175f9e0d80da1e17db09f55b8d2"
+dependencies = [
+ "windows_aarch64_msvc",
+ "windows_i686_gnu",
+ "windows_i686_msvc",
+ "windows_x86_64_gnu",
+ "windows_x86_64_msvc",
+]
+
+[[package]]
+name = "windows_aarch64_msvc"
+version = "0.36.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9bb8c3fd39ade2d67e9874ac4f3db21f0d710bee00fe7cab16949ec184eeaa47"
+
+[[package]]
+name = "windows_i686_gnu"
+version = "0.36.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "180e6ccf01daf4c426b846dfc66db1fc518f074baa793aa7d9b9aaeffad6a3b6"
+
+[[package]]
+name = "windows_i686_msvc"
+version = "0.36.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e2e7917148b2812d1eeafaeb22a97e4813dfa60a3f8f78ebe204bcc88f12f024"
+
+[[package]]
+name = "windows_x86_64_gnu"
+version = "0.36.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4dcd171b8776c41b97521e5da127a2d86ad280114807d0b2ab1e462bc764d9e1"
+
+[[package]]
+name = "windows_x86_64_msvc"
+version = "0.36.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c811ca4a8c853ef420abd8592ba53ddbbac90410fab6903b3e79972a631f7680"

benchmarks/rust/echo_server_direct/Cargo.toml

@@ -0,0 +1,9 @@
+[package]
+name = "echo_server_direct"
+version = "0.1.0"
+edition = "2021"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[dependencies]
+tokio = { version = "1.0", features = ["full"] }

benchmarks/rust/echo_server_direct/src/main.rs

@@ -0,0 +1,35 @@
+use tokio::net::TcpListener;
+use tokio::io::AsyncReadExt;
+use tokio::io::AsyncWriteExt;
+
+#[tokio::main(flavor = "current_thread")]
+async fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let listener = TcpListener::bind("127.0.0.1:55555").await?;
+
+    loop {
+        let (mut socket, _) = listener.accept().await?;
+
+        tokio::spawn(async move {
+            let mut buf = [0; 1024];
+
+            // In a loop, read data from the socket and write the data back.
+            loop {
+                let n = match socket.read(&mut buf).await {
+                    // socket closed
+                    Ok(n) if n == 0 => return,
+                    Ok(n) => n,
+                    Err(e) => {
+                        eprintln!("failed to read from socket; err = {:?}", e);
+                        return;
+                    }
+                };
+
+                // Write the data back
+                if let Err(e) = socket.write_all(&buf[0..n]).await {
+                    eprintln!("failed to write to socket; err = {:?}", e);
+                    return;
+                }
+            }
+        });
+    }
+}

benchmarks/rust/echo_server_over_redis/Cargo.toml

@@ -0,0 +1,11 @@
+[package]
+name = "echo_server_over_redis"
+version = "0.1.0"
+edition = "2021"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[dependencies]
+tokio = { version = "1.16.1", features = ["full"] }
+redis = { version = "0.21.5", features = ["tokio-comp"] }
+futures = "0.3"

benchmarks/rust/echo_server_over_redis/src/main.rs

@@ -0,0 +1,44 @@
+use tokio::net::TcpListener;
+use tokio::io::AsyncReadExt;
+use tokio::io::AsyncWriteExt;
+use tokio::sync::Mutex;
+use std::sync::{Arc};
+
+#[tokio::main]
+async fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let listener = TcpListener::bind("127.0.0.1:55555").await?;
+    let client = redis::Client::open("redis://db.occase.de/").unwrap();
+    let con = Arc::new(Mutex::new(client.get_async_connection().await?));
+
+    loop {
+        let conn = Arc::clone(&con);
+        let (mut socket, _) = listener.accept().await?;
+
+        tokio::spawn(async move {
+            let mut buf = [0; 1024];
+
+            loop {
+                let n = match socket.read(&mut buf).await {
+                    Ok(n) if n == 0 => return,
+                    Ok(n) => n,
+                    Err(e) => {
+                        eprintln!("failed to read from socket; err = {:?}", e);
+                        return;
+                    }
+                };
+
+                let mut local_conn = conn.lock().await;
+
+                let result =
+                    redis::cmd("PING")
+                    .arg(&buf[0..n])
+                    .query_async::<redis::aio::Connection, String>(&mut local_conn).await.unwrap();
+
+                if let Err(e) = socket.write_all(result.as_bytes()).await {
+                    eprintln!("failed to write to socket; err = {:?}", e);
+                    return;
+                }
+            }
+        });
+    }
+}

configure.ac

@@ -1,9 +1,10 @@
 AC_PREREQ([2.69])
-AC_INIT([Aedis], [0.0.1], [mzimbres@gmail.com])
+AC_INIT([Aedis], [1.0.0], [mzimbres@gmail.com])
 AC_CONFIG_MACRO_DIR([m4])
-#AC_CONFIG_SRCDIR([src/aedis.cpp])
 AC_CONFIG_HEADERS([config.h])
+AC_CONFIG_SRCDIR(include/aedis.hpp)
 AM_INIT_AUTOMAKE([-Wall foreign])
+AC_LANG(C++)
 
 # Checks for programs.
 AC_PROG_CXX
@@ -18,5 +19,32 @@ AC_CHECK_HEADER_STDBOOL
 AC_TYPE_UINT64_T
 AC_CHECK_TYPES([ptrdiff_t])
 
-AC_CONFIG_FILES([Makefile doc/Doxyfile])
+# This check has been stolen from Asio
+AC_MSG_CHECKING([whether coroutines are enabled])
+AC_COMPILE_IFELSE(
+  [AC_LANG_PROGRAM(
+    [[#if defined(__clang__)]]
+    [[# if (__cplusplus >= 201703) && (__cpp_coroutines >= 201703)]]
+    [[#  if __has_include(<experimental/coroutine>)]]
+    [[#   define AEDIS_HAS_CO_AWAIT 1]]
+    [[#  endif]]
+    [[# endif]]
+    [[#elif defined(__GNUC__)]]
+    [[# if (__cplusplus >= 201709) && (__cpp_impl_coroutine >= 201902)]]
+    [[#  if __has_include(<coroutine>)]]
+    [[#   define AEDIS_HAS_CO_AWAIT 1]]
+    [[#  endif]]
+    [[# endif]]
+    [[#endif]]
+    [[#ifndef AEDIS_HAS_CO_AWAIT]]
+    [[# error coroutines not available]]
+    [[#endif]])],
+  [AC_MSG_RESULT([yes])
+    HAVE_COROUTINES=yes;],
+  [AC_MSG_RESULT([no])
+    HAVE_COROUTINES=no;])
+
+AM_CONDITIONAL(HAVE_COROUTINES,test x$HAVE_COROUTINES = xyes)
+
+AC_CONFIG_FILES([Makefile include/Makefile doc/Doxyfile])
 AC_OUTPUT

doc/Doxyfile.in

@@ -32,19 +32,19 @@ DOXYFILE_ENCODING      = UTF-8
 # title of most generated pages and in a few other places.
 # The default value is: My Project.
 
-PROJECT_NAME           = "Aedis"
+PROJECT_NAME           = "@PACKAGE_NAME@"
 
 # The PROJECT_NUMBER tag can be used to enter a project or revision number. This
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         = "0.0.1"
+PROJECT_NUMBER         = "@PACKAGE_VERSION@"
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer a
 # quick idea about the purpose of the project. Keep the description short.
 
-PROJECT_BRIEF          = "Low level Redis client library"
+PROJECT_BRIEF          = "High level Redis client"
 
 # With the PROJECT_LOGO tag one can specify a logo or an icon that is included
 # in the documentation. The maximum height of the logo should not exceed 55
@@ -179,7 +179,7 @@ STRIP_FROM_PATH        =
 # specify the list of include paths that are normally passed to the compiler
 # using the -I flag.
 
-STRIP_FROM_INC_PATH    =
+STRIP_FROM_INC_PATH    = .
 
 # If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter (but
 # less readable) file names. This can be useful is your file systems doesn't
@@ -823,7 +823,7 @@ WARN_LOGFILE           =
 # spaces. See also FILE_PATTERNS and EXTENSION_MAPPING
 # Note: If this tag is empty the current directory is searched.
 
-INPUT                  = aedis examples
+INPUT                  = include benchmarks/benchmarks.md CHANGELOG.md examples
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
@@ -850,52 +850,7 @@ INPUT_ENCODING         = UTF-8
 # C comment), *.py, *.pyw, *.f90, *.f95, *.f03, *.f08, *.f, *.for, *.tcl, *.vhd,
 # *.vhdl, *.ucf, *.qsf and *.ice.
 
-FILE_PATTERNS          = *.c \
-                         *.cc \
-                         *.cxx \
-                         *.cpp \
-                         *.c++ \
-                         *.java \
-                         *.ii \
-                         *.ixx \
-                         *.ipp \
-                         *.i++ \
-                         *.inl \
-                         *.ddl \
-                         *.odl \
-                         *.h \
-                         *.hh \
-                         *.hxx \
-                         *.hpp \
-                         *.h++ \
-                         *.cs \
-                         *.d \
-                         *.php \
-                         *.php4 \
-                         *.php5 \
-                         *.phtml \
-                         *.inc \
-                         *.m \
-                         *.markdown \
-                         *.md \
-                         *.mm \
-                         *.dox \
-                         *.doc \
-                         *.txt \
-                         *.py \
-                         *.pyw \
-                         *.f90 \
-                         *.f95 \
-                         *.f03 \
-                         *.f08 \
-                         *.f \
-                         *.for \
-                         *.tcl \
-                         *.vhd \
-                         *.vhdl \
-                         *.ucf \
-                         *.qsf \
-                         *.ice
+FILE_PATTERNS          = *.hpp *.cpp
 
 # The RECURSIVE tag can be used to specify whether or not subdirectories should
 # be searched for input files as well.
@@ -910,7 +865,7 @@ RECURSIVE              = YES
 # Note that relative paths are relative to the directory from which doxygen is
 # run.
 
-EXCLUDE                = include/aedis/impl include/aedis/resp3/impl include/aedis/resp3/detail
+EXCLUDE                =
 
 # The EXCLUDE_SYMLINKS tag can be used to select whether or not files or
 # directories that are symbolic links (a Unix file system feature) are excluded
@@ -943,7 +898,7 @@ EXCLUDE_SYMBOLS        = std
 # that contain example code fragments that are included (see the \include
 # command).
 
-EXAMPLE_PATH           = examples
+EXAMPLE_PATH           =
 
 # If the value of the EXAMPLE_PATH tag contains directories, you can use the
 # EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp and

doc/aedis.css

@@ -24,9 +24,7 @@ div.contents {
   padding: 15px;
 }
 
-/*
 code
 {
-    background-color:#EFD25E;
+    background-color:#fffbeb;
 }
-*/

examples/chat_room.cpp

@@ -1,111 +1,69 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
  *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
  */
 
+#include <string>
 #include <iostream>
-#include <vector>
+#include <boost/asio.hpp>
+#include <aedis.hpp>
+#include "unistd.h"
+#include "print.hpp"
 
-#include <aedis/aedis.hpp>
+// Include this in no more than one .cpp file.
 #include <aedis/src.hpp>
 
-#include "lib/user_session.hpp"
-#include "lib/net_utils.hpp"
+#if defined(BOOST_ASIO_HAS_POSIX_STREAM_DESCRIPTOR)
 
-namespace net = aedis::net;
-using aedis::redis::command;
-using aedis::resp3::adapt;
-using aedis::resp3::experimental::client;
+namespace net = boost::asio;
+using aedis::adapt;
+using aedis::resp3::request;
 using aedis::resp3::node;
-using aedis::resp3::type;
-using aedis::user_session;
-using aedis::user_session_base;
+using tcp_socket = net::use_awaitable_t<>::as_default_on_t<net::ip::tcp::socket>;
+using tcp_acceptor = net::use_awaitable_t<>::as_default_on_t<net::ip::tcp::acceptor>;
+using stream_descriptor = net::use_awaitable_t<>::as_default_on_t<net::posix::stream_descriptor>;
+using connection = aedis::connection<tcp_socket>;
 
-// TODO: Delete sessions that have expired.
-class receiver : public std::enable_shared_from_this<receiver> {
-public:
-private:
-   std::vector<node> resps_;
-   std::vector<std::weak_ptr<user_session_base>> sessions_;
+// Chat over redis pubsub. To test, run this program from different
+// terminals and type messages to stdin. Use
+//
+//    $ redis-cli monitor
+//
+// to monitor the message traffic.
 
-public:
-   void on_message(std::error_code ec, command cmd)
-   {
-      if (ec) {
-         std::cerr << "Error: " << ec.message() << std::endl;
-         return;
-      }
-
-      switch (cmd) {
-         case command::incr:
-         {
-            std::cout << "Message so far: " << resps_.front().data << std::endl;
-         } break;
-         case command::unknown: // Push
-         {
-            for (auto& weak: sessions_) {
-               if (auto session = weak.lock()) {
-                  session->deliver(resps_.at(3).data);
-               } else {
-                  std::cout << "Session expired." << std::endl;
-               }
-            }
-
-         } break;
-         default: { /* Ignore */ }
-      }
-
-      resps_.clear();
-   }
-
-   auto get_extended_adapter()
-   {
-      return [adapter = adapt(resps_)](command, type t, std::size_t aggregate_size, std::size_t depth, char const* data, std::size_t size, std::error_code& ec) mutable
-         { return adapter(t, aggregate_size, depth, data, size, ec); };
-   }
-
-   auto add(std::shared_ptr<user_session_base> session)
-      { sessions_.push_back(session); }
-};
-
-net::awaitable<void> connection_manager(std::shared_ptr<client> db)
+// Receives messages from other users.
+net::awaitable<void> push_receiver(std::shared_ptr<connection> db)
 {
-   try {
-      auto socket = co_await connect();
-      co_await db->engage(std::move(socket));
-   } catch (std::exception const& e) {
-      std::cerr << "Error: " << e.what() << std::endl;
+   for (std::vector<node<std::string>> resp;;) {
+      co_await db->async_receive_push(adapt(resp));
+      print_push(resp);
+      resp.clear();
    }
 }
 
-net::awaitable<void> listener()
+// Subscribes to the channels when a new connection is stablished.
+net::awaitable<void> event_receiver(std::shared_ptr<connection> db)
 {
-   auto ex = co_await net::this_coro::executor;
-   net::ip::tcp::acceptor acceptor(ex, {net::ip::tcp::v4(), 55555});
-
-   auto recv = std::make_shared<receiver>();
-   auto on_db_msg = [recv](std::error_code ec, command cmd)
-      { recv->on_message(ec, cmd); };
-
-   auto db = std::make_shared<client>(ex);
-   db->set_extended_adapter(recv->get_extended_adapter());
-   db->set_msg_callback(on_db_msg);
-   net::co_spawn(ex, connection_manager(db), net::detached);
-   db->send(command::subscribe, "channel");
-
-   auto on_user_msg = [db](std::string const& msg)
-   {
-      db->send(command::publish, "channel", msg);
-      db->send(command::incr, "message-counter");
-   };
+   request req;
+   req.push("SUBSCRIBE", "chat-channel");
 
    for (;;) {
-      auto socket = co_await acceptor.async_accept(net::use_awaitable);
-      auto session = std::make_shared<user_session>(std::move(socket));
-      recv->add(session);
-      session->start(on_user_msg);
+      auto ev = co_await db->async_receive_event();
+      if (ev == connection::event::hello)
+         co_await db->async_exec(req);
+   }
+}
+
+// Publishes messages to other users.
+net::awaitable<void> publisher(stream_descriptor& in, std::shared_ptr<connection> db)
+{
+   for (std::string msg;;) {
+      auto n = co_await net::async_read_until(in, net::dynamic_buffer(msg, 1024), "\n");
+      request req;
+      req.push("PUBLISH", "chat-channel", msg);
+      co_await db->async_exec(req);
+      msg.erase(0, n);
    }
 }
 
@@ -113,11 +71,26 @@ int main()
 {
    try {
       net::io_context ioc{1};
+      stream_descriptor in{ioc, ::dup(STDIN_FILENO)};
+
+      auto db = std::make_shared<connection>(ioc);
+      db->get_config().enable_events = true;
+      db->get_config().enable_reconnect = true;
+
+      co_spawn(ioc, publisher(in, db), net::detached);
+      co_spawn(ioc, push_receiver(db), net::detached);
+      co_spawn(ioc, event_receiver(db), net::detached);
+      db->async_run(net::detached);
+
       net::signal_set signals(ioc, SIGINT, SIGTERM);
       signals.async_wait([&](auto, auto){ ioc.stop(); });
-      co_spawn(ioc, listener(), net::detached);
+
       ioc.run();
    } catch (std::exception const& e) {
       std::cerr << e.what() << std::endl;
    }
 }
+
+#else // defined(BOOST_ASIO_HAS_POSIX_STREAM_DESCRIPTOR)
+int main() {}
+#endif // defined(BOOST_ASIO_HAS_POSIX_STREAM_DESCRIPTOR)

examples/containers.cpp

@@ -0,0 +1,59 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#include <map>
+#include <vector>
+#include <iostream>
+#include <aedis.hpp>
+#include "print.hpp"
+
+// Include this in no more than one .cpp file.
+#include <aedis/src.hpp>
+
+namespace net = boost::asio;
+using boost::optional;
+using aedis::adapt;
+using aedis::resp3::request;
+using connection = aedis::connection<>;
+
+int main()
+{
+   std::vector<int> vec
+      {1, 2, 3, 4, 5, 6};
+
+   std::map<std::string, int> map
+      {{"key1", 10}, {"key2", 20}, {"key3", 30}};
+
+   request req;
+
+   req.push_range("RPUSH", "rpush-key", vec); // Sends
+   req.push_range("HSET", "hset-key", map); // Sends
+   req.push("MULTI");
+   req.push("LRANGE", "rpush-key", 0, -1); // Retrieves
+   req.push("HGETALL", "hset-key"); // Retrieves
+   req.push("EXEC");
+   req.push("QUIT");
+
+   std::tuple<
+      aedis::ignore, // rpush
+      aedis::ignore, // hset
+      aedis::ignore, // multi
+      aedis::ignore, // lrange
+      aedis::ignore, // hgetall
+      std::tuple<optional<std::vector<int>>, optional<std::map<std::string, int>>>, // exec
+      aedis::ignore  // quit
+   > resp;
+
+   net::io_context ioc;
+   connection db{ioc};
+   db.async_run(req, adapt(resp), [](auto ec, auto) {
+      std::cout << ec.message() << std::endl;
+   });
+   ioc.run();
+
+   print(std::get<0>(std::get<5>(resp)).value());
+   print(std::get<1>(std::get<5>(resp)).value());
+}

examples/echo_server.cpp

@@ -1,118 +1,59 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
  *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
  */
 
+#include <string>
 #include <iostream>
-#include <queue>
-#include <vector>
+#include <boost/asio.hpp>
+#include <aedis.hpp>
 
-#include <aedis/aedis.hpp>
+// Include this in no more than one .cpp file.
 #include <aedis/src.hpp>
 
-#include "lib/user_session.hpp"
-#include "lib/net_utils.hpp"
+namespace net = boost::asio;
+using aedis::adapt;
+using aedis::resp3::request;
+using executor_type = net::io_context::executor_type;
+using socket_type = net::basic_stream_socket<net::ip::tcp, executor_type>;
+using tcp_socket = net::use_awaitable_t<executor_type>::as_default_on_t<socket_type>;
+using acceptor_type = net::basic_socket_acceptor<net::ip::tcp, executor_type>;
+using tcp_acceptor = net::use_awaitable_t<executor_type>::as_default_on_t<acceptor_type>;
+using awaitable_type = net::awaitable<void, executor_type>;
+using connection = aedis::connection<tcp_socket>;
 
-namespace net = aedis::net;
-using aedis::redis::command;
-using aedis::user_session;
-using aedis::user_session_base;
-using aedis::resp3::node;
-using aedis::resp3::adapt;
-using aedis::resp3::experimental::client;
-using aedis::resp3::type;
-
-class receiver : public std::enable_shared_from_this<receiver> {
-private:
-   std::vector<node> resps_;
-   std::queue<std::weak_ptr<user_session_base>> sessions_;
-
-public:
-   void on_message(std::error_code ec, command cmd)
-   {
-      if (ec) {
-         std::cerr << "Error: " << ec.message() << std::endl;
-         return;
-      }
-
-      switch (cmd) {
-         case command::ping:
-         {
-            if (auto session = sessions_.front().lock()) {
-               session->deliver(resps_.front().data);
-            } else {
-               std::cout << "Session expired." << std::endl;
-            }
-
-            sessions_.pop();
-         } break;
-         case command::incr:
-         {
-            std::cout << "Echos so far: " << resps_.front().data << std::endl;
-         } break;
-         default: { /* Ignore */; }
-      }
-
-      resps_.clear();
-   }
-
-   auto get_extended_adapter()
-   {
-      return [adapter = adapt(resps_)](command, type t, std::size_t aggregate_size, std::size_t depth, char const* data, std::size_t size, std::error_code& ec) mutable
-         { return adapter(t, aggregate_size, depth, data, size, ec); };
-   }
-
-   void add_user_session(std::shared_ptr<user_session_base> session)
-      { sessions_.push(session); }
-};
-
-net::awaitable<void> connection_manager(std::shared_ptr<client> db)
+awaitable_type echo_loop(tcp_socket socket, std::shared_ptr<connection> db)
 {
-   try {
-      auto socket = co_await connect();
-      co_await db->engage(std::move(socket));
-   } catch (std::exception const& e) {
-      std::cerr << "Error: " << e.what() << std::endl;
+   request req;
+   std::tuple<std::string> resp;
+
+   for (std::string buffer;;) {
+      auto n = co_await net::async_read_until(socket, net::dynamic_buffer(buffer, 1024), "\n");
+      req.push("PING", buffer);
+      co_await db->async_exec(req, adapt(resp));
+      co_await net::async_write(socket, net::buffer(std::get<0>(resp)));
+      std::get<0>(resp).clear();
+      req.clear();
+      buffer.erase(0, n);
    }
 }
 
-net::awaitable<void> listener()
+awaitable_type listener()
 {
    auto ex = co_await net::this_coro::executor;
-   net::ip::tcp::acceptor acceptor(ex, {net::ip::tcp::v4(), 55555});
+   auto db = std::make_shared<connection>(ex);
+   db->async_run(net::detached);
 
-   auto recv = std::make_shared<receiver>();
-   auto on_db_msg = [recv](std::error_code ec, command cmd)
-      { recv->on_message(ec, cmd); };
-
-   auto db = std::make_shared<client>(ex);
-   db->set_extended_adapter(recv->get_extended_adapter());
-   db->set_msg_callback(on_db_msg);
-   net::co_spawn(ex, connection_manager(db), net::detached);
-
-   for (;;) {
-      auto socket = co_await acceptor.async_accept(net::use_awaitable);
-      auto session = std::make_shared<user_session>(std::move(socket));
-
-      auto on_user_msg = [db, recv, session](std::string const& msg)
-      {
-         db->send(command::ping, msg);
-         db->send(command::incr, "echo-counter");
-         recv->add_user_session(session);
-      };
-
-      session->start(on_user_msg);
-   }
+   tcp_acceptor acc(ex, {net::ip::tcp::v4(), 55555});
+   for (;;)
+      net::co_spawn(ex, echo_loop(co_await acc.async_accept(), db), net::detached);
 }
 
 int main()
 {
    try {
-      net::io_context ioc{1};
-      net::signal_set signals(ioc, SIGINT, SIGTERM);
-      signals.async_wait([&](auto, auto){ ioc.stop(); });
+      net::io_context ioc{BOOST_ASIO_CONCURRENCY_HINT_UNSAFE_IO};
       co_spawn(ioc, listener(), net::detached);
       ioc.run();
    } catch (std::exception const& e) {

examples/hashes.cpp

@@ -1,88 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#include <iostream>
-#include <vector>
-#include <map>
-#include <unordered_map>
-
-#include <aedis/aedis.hpp>
-#include <aedis/src.hpp>
-
-#include "lib/net_utils.hpp"
-
-namespace resp3 = aedis::resp3;
-using aedis::redis::command;
-using aedis::redis::make_serializer;
-using resp3::adapt;
-
-namespace net = aedis::net;
-using net::async_write;
-using net::buffer;
-using net::dynamic_buffer;
-
-net::awaitable<void> containers()
-{
-   try {
-      auto socket = co_await connect();
-
-      std::map<std::string, std::string> map
-         { {"key1", "value1"}
-         , {"key2", "value2"}
-         , {"key3", "value3"}
-         };
-
-      // Creates and sends the request.
-      std::string request;
-      auto sr = make_serializer(request);
-      sr.push(command::hello, 3);
-      sr.push(command::flushall);
-      sr.push_range(command::hset, "key", std::cbegin(map), std::cend(map));
-      sr.push(command::hgetall, "key");
-      sr.push(command::hgetall, "key");
-      sr.push(command::hgetall, "key");
-      sr.push(command::quit);
-      co_await async_write(socket, buffer(request));
-
-      // The expected responses
-      int hset;
-      std::vector<std::string> hgetall1;
-      std::map<std::string, std::string> hgetall2;
-      std::unordered_map<std::string, std::string> hgetall3;
-
-      // Reads the responses.
-      std::string buffer;
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // hello
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // flushall
-      co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(hset));
-      co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(hgetall1));
-      co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(hgetall2));
-      co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(hgetall3));
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // quit
-
-      // Prints the responses.
-      std::cout << "hset: " << hset;
-      std::cout << "\nhgetall (as vector): ";
-      for (auto const& e: hgetall1) std::cout << e << ", ";
-      std::cout << "\nhgetall (as map): ";
-      for (auto const& e: hgetall2) std::cout << e.first << " ==> " << e.second << "; ";
-      std::cout << "\nhgetall (as unordered_map): ";
-      for (auto const& e: hgetall3) std::cout << e.first << " ==> " << e.second << "; ";
-      std::cout << "\n";
-
-   } catch (std::exception const& e) {
-      std::cerr << e.what() << std::endl;
-      exit(EXIT_FAILURE);
-   }
-}
-
-int main()
-{
-   net::io_context ioc;
-   co_spawn(ioc, containers(), net::detached);
-   ioc.run();
-}

examples/intro.cpp

@@ -1,68 +1,38 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
  *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
  */
 
-#include <iostream>
+#include <tuple>
+#include <string>
+#include <boost/asio.hpp>
+#include <aedis.hpp>
 
-#include <aedis/aedis.hpp>
+// Include this in no more than one .cpp file.
 #include <aedis/src.hpp>
 
-#include "lib/net_utils.hpp"
+namespace net = boost::asio;
 
-namespace resp3 = aedis::resp3;
-using aedis::redis::command;
-using aedis::redis::make_serializer;
-using resp3::adapt;
-
-namespace net = aedis::net;
-using net::async_write;
-using net::buffer;
-using net::dynamic_buffer;
-
-net::awaitable<void> ping()
-{
-   try {
-      auto socket = co_await connect(); // See lib/net_utils.hpp
-
-      // Creates and sends the request.
-      std::string request;
-      auto sr = make_serializer(request);
-      sr.push(command::hello, 3);
-      sr.push(command::flushall);
-      sr.push(command::ping);
-      sr.push(command::incr, "key");
-      sr.push(command::quit);
-      co_await async_write(socket, buffer(request));
-
-      // Responses we are interested in.
-      int incr;
-      std::string ping;
-
-      // Reads the responses to ping and incr, ignore the others.
-      std::string buffer;
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // hello
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // flushall 
-      co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(ping));
-      co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(incr));
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // quit
-
-      // Print the responses.
-      std::cout
-         << "ping: " << ping << "\n"
-         << "incr: " << incr << "\n";
-
-   } catch (std::exception const& e) {
-      std::cerr << e.what() << std::endl;
-      exit(EXIT_FAILURE);
-   }
-}
+using aedis::adapt;
+using aedis::resp3::request;
+using connection = aedis::connection<>;
 
 int main()
 {
    net::io_context ioc;
-   co_spawn(ioc, ping(), net::detached);
+   connection db{ioc};
+
+   request req;
+   req.push("PING");
+   req.push("QUIT");
+
+   std::tuple<std::string, aedis::ignore> resp;
+   db.async_run(req, adapt(resp), [](auto ec, auto) {
+      std::cout << ec.message() << std::endl;
+   });
+
    ioc.run();
+
+   std::cout << std::get<0>(resp) << std::endl;
 }

examples/intro_sync.cpp

@@ -0,0 +1,46 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#include <tuple>
+#include <string>
+#include <thread>
+#include <boost/asio/io_context.hpp>
+#include <aedis.hpp>
+
+// Include this in no more than one .cpp file.
+#include <aedis/src.hpp>
+
+namespace net = boost::asio;
+using aedis::adapt;
+using aedis::resp3::request;
+using connection = aedis::sync<aedis::connection<>>;
+
+int main()
+{
+   try {
+      net::io_context ioc{1};
+      auto work = net::make_work_guard(ioc);
+      std::thread t1{[&]() { ioc.run(); }};
+
+      connection conn{work.get_executor()};
+      std::thread t2{[&]() { boost::system::error_code ec; conn.run(ec); }};
+
+      request req;
+      req.push("PING");
+      req.push("QUIT");
+
+      std::tuple<std::string, aedis::ignore> resp;
+      conn.exec(req, adapt(resp));
+      std::cout << "Response: " << std::get<0>(resp) << std::endl;
+
+      work.reset();
+
+      t1.join();
+      t2.join();
+   } catch (std::exception const& e) {
+      std::cerr << e.what() << std::endl;
+   }
+}

examples/key_expiration.cpp

@@ -1,93 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#include <iostream>
-#include <chrono>
-#include <optional>
-
-#include <aedis/src.hpp>
-#include <aedis/aedis.hpp>
-
-#include "lib/net_utils.hpp"
-
-namespace resp3 = aedis::resp3;
-using aedis::redis::command;
-using aedis::redis::make_serializer;
-using resp3::adapt;
-using resp3::node;
-
-namespace net = aedis::net;
-using net::async_write;
-using net::buffer;
-using net::dynamic_buffer;
-
-net::awaitable<void> key_expiration()
-{
-   try {
-      auto socket = co_await connect();
-
-      // Creates and sends the first request.
-      std::string request;
-      auto sr = make_serializer(request);
-      sr.push(command::hello, 3);
-      sr.push(command::flushall);
-      sr.push(command::set, "key", "Some payload", "EX", "2");
-      sr.push(command::get, "key");
-      co_await async_write(socket, buffer(request));
-
-      // Will hold the response to get.
-      std::optional<std::string> get;
-
-      // Reads the responses.
-      std::string rbuffer;
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer)); // hello
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer)); // flushall
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer)); // set
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer), adapt(get));
-
-      std::cout
-        << "Before expiration: " << get.has_value() << ", "
-        << *get << std::endl;
-
-      // Waits some seconds for the key to expire.
-      timer tm{socket.get_executor(), std::chrono::seconds{3}};
-      co_await tm.async_wait();
-
-      // Creates a request to get after expiration.
-      get.reset(); request.clear();
-      sr.push(command::get, "key");
-      sr.push(command::get, "key");
-      sr.push(command::quit);
-      co_await async_write(socket, buffer(request));
-
-      // Reads the response to the second request.
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer), adapt(get));
-
-      // Reading without an optional will result in an error.
-      std::string str;
-      boost::system::error_code ec;
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer),
-	          adapt(str), net::redirect_error(net::use_awaitable, ec));
-
-      // Quit
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer));
-
-      std::cout << "After expiration (optional): " << get.has_value() << "\n";
-      std::cout << "After expiration (non-optional): " << ec.message() << "\n";
-
-   } catch (std::exception const& e) {
-      std::cerr << e.what() << std::endl;
-      exit(EXIT_FAILURE);
-   }
-}
-
-int main()
-{
-   net::io_context ioc;
-   co_spawn(ioc, key_expiration(), net::detached);
-   ioc.run();
-}

examples/lib/net_utils.hpp

@@ -1,51 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#include <aedis/config.hpp>
-
-using tcp_socket = aedis::net::use_awaitable_t<>::as_default_on_t<aedis::net::ip::tcp::socket>;
-using tcp_resolver = aedis::net::use_awaitable_t<>::as_default_on_t<aedis::net::ip::tcp::resolver>;
-using timer = aedis::net::use_awaitable_t<>::as_default_on_t<aedis::net::steady_timer>;
-
-aedis::net::awaitable<tcp_socket>
-connect(
-   std::string host = "127.0.0.1",
-   std::string port = "6379")
-{
-   auto ex = co_await aedis::net::this_coro::executor;
-   tcp_resolver resolver{ex};
-   auto const res = co_await resolver.async_resolve(host, port);
-   tcp_socket socket{ex};
-   co_await aedis::net::async_connect(socket, res);
-   co_return std::move(socket);
-}
-
-//net::awaitable<void>
-//client::connection_manager()
-//{
-//   using namespace aedis::net::experimental::awaitable_operators;
-//   using tcp_resolver = aedis::net::use_awaitable_t<>::as_default_on_t<aedis::net::ip::tcp::resolver>;
-//
-//   for (;;) {
-//      tcp_resolver resolver{socket_.get_executor()};
-//      auto const res = co_await resolver.async_resolve("127.0.0.1", "6379");
-//      co_await net::async_connect(socket_, res);
-//
-//      co_await say_hello();
-//
-//      timer_.expires_at(std::chrono::steady_clock::time_point::max());
-//      co_await (reader() && writer());
-//
-//      socket_.close();
-//      timer_.cancel();
-//
-//      timer_.expires_after(std::chrono::seconds{1});
-//      boost::system::error_code ec;
-//      co_await timer_.async_wait(net::redirect_error(net::use_awaitable, ec));
-//   }
-//}
-

examples/lib/user_session.hpp

@@ -1,94 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#pragma once
-
-#include <functional>
-
-#include <aedis/config.hpp>
-
-// An example user session.
-
-namespace aedis
-{
-
-// Base class for user sessions.
-struct user_session_base {
-  virtual ~user_session_base() {}
-  virtual void deliver(std::string const& msg) = 0;
-};
-
-class user_session:
-   public user_session_base,
-   public std::enable_shared_from_this<user_session> {
-public:
-   user_session(net::ip::tcp::socket socket)
-   : socket_(std::move(socket))
-   , timer_(socket_.get_executor())
-      { timer_.expires_at(std::chrono::steady_clock::time_point::max()); }
-
-   void start(std::function<void(std::string const&)> on_msg)
-   {
-      co_spawn(socket_.get_executor(),
-          [self = shared_from_this(), on_msg]{ return self->reader(on_msg); },
-          net::detached);
-
-      co_spawn(socket_.get_executor(),
-          [self = shared_from_this()]{ return self->writer(); },
-          net::detached);
-   }
-
-   void deliver(std::string const& msg)
-   {
-      write_msgs_.push_back(msg);
-      timer_.cancel_one();
-   }
-
-private:
-   net::awaitable<void>
-   reader(std::function<void(std::string const&)> on_msg)
-   {
-      try {
-         for (std::string msg;;) {
-            auto const n = co_await net::async_read_until(socket_, net::dynamic_buffer(msg, 1024), "\n", net::use_awaitable);
-            on_msg(msg);
-            msg.erase(0, n);
-         }
-      } catch (std::exception&) {
-         stop();
-      }
-   }
-
-   net::awaitable<void> writer()
-   {
-      try {
-         while (socket_.is_open()) {
-            if (write_msgs_.empty()) {
-               boost::system::error_code ec;
-               co_await timer_.async_wait(redirect_error(net::use_awaitable, ec));
-            } else {
-               co_await net::async_write(socket_, net::buffer(write_msgs_.front()), net::use_awaitable);
-               write_msgs_.pop_front();
-            }
-         }
-      } catch (std::exception&) {
-        stop();
-      }
-   }
-
-   void stop()
-   {
-      socket_.close();
-      timer_.cancel();
-   }
-
-   net::ip::tcp::socket socket_;
-   net::steady_timer timer_;
-   std::deque<std::string> write_msgs_;
-};
-
-} // aedis

examples/lists.cpp

@@ -1,89 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#include <iostream>
-#include <string>
-#include <vector>
-#include <list>
-#include <deque>
-
-#include <aedis/aedis.hpp>
-#include <aedis/src.hpp>
-
-#include "lib/net_utils.hpp"
-
-namespace resp3 = aedis::resp3;
-using aedis::redis::command;
-using aedis::redis::make_serializer;
-using resp3::adapt;
-
-namespace net = aedis::net;
-using net::async_write;
-using net::buffer;
-using net::dynamic_buffer;
-
-net::awaitable<void> ping()
-{
-   try {
-      auto socket = co_await connect();
-
-      // Creates and sends the request.
-      auto vec  = {1, 2, 3, 4, 5, 6};
-      std::string request;
-      auto sr = make_serializer(request);
-      sr.push(command::hello, 3);
-      sr.push(command::flushall);
-      sr.push_range(command::rpush, "key", std::cbegin(vec), std::cend(vec));
-      sr.push(command::lrange, "key", 0, -1);
-      sr.push(command::lrange, "key", 0, -1);
-      sr.push(command::lrange, "key", 0, -1);
-      sr.push(command::lrange, "key", 0, -1);
-      sr.push(command::quit);
-      co_await async_write(socket, buffer(request));
-
-      // Expected responses.
-      int rpush;
-      std::vector<std::string> svec;
-      std::list<std::string> slist;
-      std::deque<std::string> sdeq;
-      std::vector<int> ivec;
-
-      // Reads the responses.
-      std::string rbuffer;
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer)); // hello
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer)); // flushall
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer), adapt(rpush)); // rpush
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer), adapt(svec));
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer), adapt(slist));
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer), adapt(sdeq));
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer), adapt(ivec));
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer)); // quit
-
-      // Prints the responses.
-      std::cout << "rpush: " << rpush;
-      std::cout << "\nlrange (as vector): ";
-      for (auto e: svec) std::cout << e << " ";
-      std::cout << "\nlrange (as list): ";
-      for (auto e: slist) std::cout << e << " ";
-      std::cout << "\nlrange (as deque): ";
-      for (auto e: sdeq) std::cout << e << " ";
-      std::cout << "\nlrange (as vector<int>): ";
-      for (auto e: ivec) std::cout << e << " ";
-      std::cout << std::endl;
-
-   } catch (std::exception const& e) {
-      std::cerr << e.what() << std::endl;
-      exit(EXIT_FAILURE);
-   }
-}
-
-int main()
-{
-   net::io_context ioc;
-   co_spawn(ioc, ping(), net::detached);
-   ioc.run();
-}

examples/print.hpp

@@ -0,0 +1,62 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#include <map>
+#include <set>
+#include <vector>
+#include <string>
+#include <iostream>
+
+#include <aedis/resp3/type.hpp>
+#include <aedis/resp3/node.hpp>
+
+// Some functions to make the examples less repetitive.
+
+namespace net = boost::asio;
+using aedis::resp3::node;
+
+void print_aggr(std::vector<aedis::resp3::node<std::string>>& v)
+{
+   auto const m = aedis::resp3::element_multiplicity(v.front().data_type);
+   for (auto i = 0lu; i < m * v.front().aggregate_size; ++i)
+      std::cout << v[i + 1].value << " ";
+   std::cout << "\n";
+   v.clear();
+}
+
+template <class T>
+void print(std::vector<T> const& cont)
+{
+   for (auto const& e: cont) std::cout << e << " ";
+   std::cout << "\n";
+}
+
+template <class T>
+void print(std::set<T> const& cont)
+{
+   for (auto const& e: cont) std::cout << e << "\n";
+}
+
+template <class T, class U>
+void print(std::map<T, U> const& cont)
+{
+   for (auto const& e: cont)
+      std::cout << e.first << ": " << e.second << "\n";
+}
+
+void print(std::string const& e)
+{
+   std::cout << e << std::endl;
+}
+
+void print_push(std::vector<aedis::resp3::node<std::string>>& resp)
+{
+   std::cout
+      << "Push type: "   << resp.at(1).value << "\n"
+      << "Channel: " << resp.at(2).value << "\n"
+      << "Message: " << resp.at(3).value << "\n"
+      << std::endl;
+}

examples/response_adapter.cpp

@@ -1,82 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres at gmail dot com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#include <iostream>
-#include <string_view>
-
-#include <aedis/aedis.hpp>
-#include <aedis/src.hpp>
-
-#include "lib/net_utils.hpp"
-
-namespace resp3 = aedis::resp3;
-using aedis::redis::command;
-using resp3::type;
-using aedis::redis::make_serializer;
-using resp3::adapt;
-
-namespace net = aedis::net;
-using net::async_write;
-using net::buffer;
-using net::dynamic_buffer;
-
-// An adapter that prints the data it receives in the screen.
-struct myadapter {
-   void operator()(
-      type t,
-      std::size_t aggregate_size,
-      std::size_t depth,
-      char const* data,
-      std::size_t size,
-      std::error_code&)
-      {
-         std::cout
-            << "Type: " << t << "\n"
-            << "Aggregate_size: " << aggregate_size << "\n"
-            << "Depth: " << depth << "\n"
-            << "Data: " << std::string_view(data, size) << "\n"
-            << "----------------------" << "\n";
-      }
-};
-
-net::awaitable<void> adapter_example()
-{
-   try {
-      auto socket = co_await connect();
-
-      auto list = {"one", "two", "three"};
-
-      // Creates and sends the request.
-      std::string request;
-      auto sr = make_serializer(request);
-      sr.push(command::hello, 3);
-      sr.push(command::flushall);
-      sr.push_range(command::rpush, "key", std::cbegin(list), std::cend(list));
-      sr.push(command::lrange, "key", 0, -1);
-      sr.push(command::quit);
-      co_await async_write(socket, buffer(request));
-
-      // Reads the responses.
-      std::string rbuffer;
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer)); // hello
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer)); // flushall
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer)); // rpush
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer), myadapter{}); // lrange
-      co_await resp3::async_read(socket, dynamic_buffer(rbuffer)); // quit
-
-   } catch (std::exception const& e) {
-      std::cerr << e.what() << std::endl;
-      exit(EXIT_FAILURE);
-   }
-}
-
-int main()
-{
-   net::io_context ioc;
-   co_spawn(ioc, adapter_example(), net::detached);
-   ioc.run();
-}

examples/serialization.cpp

@@ -1,109 +1,109 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
  *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
  */
 
-#include <string>
+#include <algorithm>
+#include <cstdint>
 #include <iostream>
-#include <charconv>
+#include <set>
+#include <iterator>
+#include <string>
+#include <boost/json.hpp>
+#include <boost/json/src.hpp>
+#include <aedis.hpp>
+#include "print.hpp"
 
-#include <aedis/aedis.hpp>
+// Include this in no more than one .cpp file.
 #include <aedis/src.hpp>
 
-#include "lib/net_utils.hpp"
+namespace net = boost::asio;
+using aedis::resp3::request;
+using aedis::adapt;
+using connection = aedis::connection<>;
+using namespace boost::json;
 
-namespace resp3 = aedis::resp3;
-using aedis::redis::make_serializer;
-using aedis::redis::command;
-using resp3::adapt;
-
-namespace net = aedis::net;
-using net::async_write;
-using net::buffer;
-using net::dynamic_buffer;
-
-// Define the to_string and from_string functions for your own data
-// types.
-
-// The struct we would like to store in redis using our own
-// serialization.
-struct mydata {
-  int a;
-  int b;
+struct user {
+   std::string name;
+   std::string age;
+   std::string country;
 };
 
-// Serializes to Tab Separated Value (TSV).
-std::string to_string(mydata const& obj)
+void tag_invoke(value_from_tag, value& jv, user const& u)
 {
-   return std::to_string(obj.a) + '\t' + std::to_string(obj.b);
+   jv =
+   { {"name", u.name}
+   , {"age", u.age}
+   , {"country", u.country}
+   };
 }
 
-// Deserializes TSV.
-void
-from_string(
-   mydata& obj,
-   char const* data,
-   std::size_t size,
-   std::error_code& ec)
+template<class T>
+void extract(object const& obj, T& t, boost::string_view key)
 {
-   auto const* end = data + size;
-   auto const* pos = std::find(data, end, '\t');
-   assert(pos != end); // Or use your own error code.
-
-   auto const res1 = std::from_chars(data, pos, obj.a);
-   if (res1.ec != std::errc()) {
-      ec = std::make_error_code(res1.ec);
-      return;
-   }
-
-   auto const res2 = std::from_chars(pos + 1, end, obj.b);
-   if (res2.ec != std::errc()) {
-      ec = std::make_error_code(res2.ec);
-      return;
-   }
+    t = value_to<T>(obj.at(key));
 }
 
-net::awaitable<void> serialization()
+user tag_invoke(value_to_tag<user>, value const& jv)
 {
-   try {
-      auto socket = co_await connect();
+    user u;
+    object const& obj = jv.as_object();
+    extract(obj, u.name, "name");
+    extract(obj, u.age, "age");
+    extract(obj, u.country, "country");
+    return u;
+}
 
-      mydata obj{21, 22};
+// Serializes
+void to_bulk(std::string& to, user const& u)
+{
+   aedis::resp3::to_bulk(to, serialize(value_from(u)));
+}
 
-      std::string request;
-      auto sr = make_serializer(request);
-      sr.push(command::hello, 3);
-      sr.push(command::flushall);
-      sr.push(command::set, "key", obj);
-      sr.push(command::get, "key");
-      sr.push(command::quit);
-      co_await async_write(socket, buffer(request));
+// Deserializes
+void from_bulk(user& u, boost::string_view sv, boost::system::error_code&)
+{
+   value jv = parse(sv);
+   u = value_to<user>(jv);
+}
 
-      // The response.
-      mydata get;
+std::ostream& operator<<(std::ostream& os, user const& u)
+{
+   os << "Name: " << u.name << "\n"
+      << "Age: " << u.age << "\n"
+      << "Country: " << u.country;
 
-      // Reads the responses.
-      std::string buffer;
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // hello
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // flushall
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // set
-      co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(get));
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // quit
+   return os;
+}
 
-      // Print the responses.
-      std::cout << "get: a = " << get.a << ", b = " << get.b << "\n";
-
-   } catch (std::exception const& e) {
-      std::cerr << e.what() << std::endl;
-      exit(EXIT_FAILURE);
-   }
+bool operator<(user const& a, user const& b)
+{
+   return std::tie(a.name, a.age, a.country) < std::tie(b.name, b.age, b.country);
 }
 
 int main()
 {
    net::io_context ioc;
-   co_spawn(ioc, serialization(), net::detached);
+   connection db{ioc};
+
+   std::set<user> users
+      {{"Joao", "58", "Brazil"} , {"Serge", "60", "France"}};
+
+   request req;
+   req.push("HELLO", 3);
+   req.push_range("SADD", "sadd-key", users); // Sends
+   req.push("SMEMBERS", "sadd-key"); // Retrieves
+   req.push("QUIT");
+
+   std::tuple<aedis::ignore, int, std::set<user>, std::string> resp;
+
+   db.async_run(req, adapt(resp), [](auto ec, auto) {
+      std::cout << ec.message() << std::endl;
+   });
+
    ioc.run();
+
+   // Print
+   print(std::get<2>(resp));
 }

examples/sets.cpp

@@ -1,85 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres at gmail dot com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#include <iostream>
-#include <set>
-#include <vector>
-#include <unordered_map>
-
-#include <aedis/aedis.hpp>
-#include <aedis/src.hpp>
-
-#include "lib/net_utils.hpp"
-
-namespace resp3 = aedis::resp3;
-using aedis::redis::command;
-using aedis::redis::make_serializer;
-using resp3::adapt;
-
-namespace net = aedis::net;
-using net::async_write;
-using net::buffer;
-using net::dynamic_buffer;
-
-net::awaitable<void> containers()
-{
-   try {
-      auto socket = co_await connect();
-
-      std::set<std::string> set
-         {"one", "two", "three", "four"};
-
-      // Creates and sends the request.
-      std::string request;
-      auto sr = make_serializer(request);
-      sr.push(command::hello, 3);
-      sr.push(command::flushall);
-      sr.push_range(command::sadd, "key", std::cbegin(set), std::cend(set));
-      sr.push(command::smembers, "key");
-      sr.push(command::smembers, "key");
-      sr.push(command::smembers, "key");
-      sr.push(command::quit);
-      co_await async_write(socket, buffer(request));
-
-      // Expected responses.
-      int sadd;
-      std::vector<std::string> smembers1;
-      std::set<std::string> smembers2;
-      std::unordered_set<std::string> smembers3;
-
-      // Reads the responses.
-      std::string buffer;
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // hello
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // flushall
-      co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(sadd));
-      co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(smembers1));
-      co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(smembers2));
-      co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(smembers3));
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // quit
-
-      // Prints the responses.
-      std::cout << "sadd: " << sadd;
-      std::cout << "\nsmembers (as vector): ";
-      for (auto const& e: smembers1) std::cout << e << " ";
-      std::cout << "\nsmembers (as set): ";
-      for (auto const& e: smembers2) std::cout << e << " ";
-      std::cout << "\nsmembers (as unordered_set): ";
-      for (auto const& e: smembers3) std::cout << e << " ";
-      std::cout << "\n";
-
-   } catch (std::exception const& e) {
-      std::cerr << e.what() << std::endl;
-      exit(EXIT_FAILURE);
-   }
-}
-
-int main()
-{
-   net::io_context ioc;
-   co_spawn(ioc, containers(), net::detached);
-   ioc.run();
-}

examples/subscriber.cpp

@@ -1,86 +1,84 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres at gmail dot com)
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
  *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
  */
 
+#include <string>
+#include <vector>
 #include <iostream>
-#include <chrono>
+#include <tuple>
+#include <boost/asio.hpp>
+#include <aedis.hpp>
+#include "print.hpp"
 
-#include <aedis/aedis.hpp>
+// Include this in no more than one .cpp file.
 #include <aedis/src.hpp>
 
-#include "lib/net_utils.hpp"
+namespace net = boost::asio;
+using aedis::adapt;
+using aedis::resp3::request;
+using aedis::resp3::node;
+using tcp_socket = net::use_awaitable_t<>::as_default_on_t<net::ip::tcp::socket>;
+using connection = aedis::connection<tcp_socket>;
 
-namespace resp3 = aedis::resp3;
-using aedis::redis::command;
-using aedis::redis::make_serializer;
-using resp3::adapt;
-using resp3::node;
-
-namespace net = aedis::net;
-using net::async_write;
-using net::buffer;
-using net::dynamic_buffer;
-
-/* In this example we send a subscription to a channel and start
-   reading server side messages indefinitely.
-  
-   Notice we store the id of the connection (attributed by the redis
-   server) to be able to identify it (in the logs for example).
-  
-   After starting the example you can test it by sending messages with
-   redis-cli like this
-  
-      $ redis-cli -3
-      127.0.0.1:6379> PUBLISH channel1 some-message
-      (integer) 3
-      127.0.0.1:6379>
-  
-   The messages will then appear on the terminal you are running the
-   example.
+/* This example will subscribe and read pushes indefinitely.
+ *
+ * To test send messages with redis-cli
+ *
+ *    $ redis-cli -3
+ *    127.0.0.1:6379> PUBLISH channel some-message
+ *    (integer) 3
+ *    127.0.0.1:6379>
+ *
+ * To test reconnection try, for example, to close all clients currently
+ * connected to the Redis instance
+ *
+ * $ redis-cli
+ * > CLIENT kill TYPE pubsub
  */
-net::awaitable<void> subscriber()
+
+// Receives pushes.
+net::awaitable<void> push_receiver(std::shared_ptr<connection> db)
 {
-   try {
-      auto socket = co_await connect();
+   for (std::vector<node<std::string>> resp;;) {
+      co_await db->async_receive_push(adapt(resp));
+      print_push(resp);
+      resp.clear();
+   }
+}
 
-      std::string request;
-      auto sr = make_serializer(request);
-      sr.push(command::hello, "3");
-      sr.push(command::subscribe, "channel1", "channel2");
-      co_await async_write(socket, buffer(request));
+// Receives events.
+net::awaitable<void> event_receiver(std::shared_ptr<connection> db)
+{
+   request req;
+   req.push("SUBSCRIBE", "channel");
 
-      std::vector<node> resp;
-
-      // Reads the response to the hello command.
-      std::string buffer;
-      co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(resp));
-      co_await resp3::async_read(socket, dynamic_buffer(buffer));
-
-      // Saves the id of this connection.
-      auto const id = resp.at(8).data;
-
-      // Loops to receive server pushes.
-      for (;;) {
-         resp.clear();
-         co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(resp));
-
-         std::cout
-            << "Subscriber " << id << ":\n"
-            << resp << std::endl;
-      }
-   } catch (std::exception const& e) {
-      std::cerr << e.what() << std::endl;
+   for (;;) {
+      auto ev = co_await db->async_receive_event();
+      if (ev == connection::event::hello)
+         co_await db->async_exec(req);
    }
 }
 
 int main()
 {
-   net::io_context ioc;
-   co_spawn(ioc, subscriber(), net::detached);
-   co_spawn(ioc, subscriber(), net::detached);
-   co_spawn(ioc, subscriber(), net::detached);
-   ioc.run();
+   try {
+      net::io_context ioc;
+      auto db = std::make_shared<connection>(ioc);
+
+      db->get_config().enable_events = true;
+      db->get_config().enable_reconnect = true;
+
+      net::co_spawn(ioc, push_receiver(db), net::detached);
+      net::co_spawn(ioc, event_receiver(db), net::detached);
+      db->async_run(net::detached);
+
+      net::signal_set signals(ioc, SIGINT, SIGTERM);
+      signals.async_wait([&](auto, auto){ ioc.stop(); });
+
+      ioc.run();
+   } catch (std::exception const& e) {
+      std::cerr << "Error: " << e.what() << std::endl;
+   }
 }

examples/subscriber_sync.cpp

@@ -0,0 +1,67 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#include <tuple>
+#include <string>
+#include <thread>
+#include <boost/asio.hpp>
+#include <aedis.hpp>
+#include "print.hpp"
+
+// Include this in no more than one .cpp file.
+#include <aedis/src.hpp>
+
+namespace net = boost::asio;
+using aedis::adapt;
+using aedis::resp3::node;
+using aedis::resp3::request;
+using connection = aedis::sync<aedis::connection<>>;
+using event = connection::event;
+
+// See subscriber.cpp for more info about how to run this example.
+
+// Subscribe again everytime there is a disconnection.
+void event_receiver(connection& conn)
+{
+   request req;
+   req.push("SUBSCRIBE", "channel");
+
+   for (;;) {
+      auto ev = conn.receive_event();
+      if (ev == connection::event::hello)
+         conn.exec(req);
+   }
+}
+
+int main()
+{
+   try {
+      net::io_context ioc{1};
+      auto work = net::make_work_guard(ioc);
+
+      connection::config cfg;
+      cfg.enable_events = true;
+      cfg.enable_reconnect = true;
+      connection conn{work.get_executor(), cfg};
+
+      std::thread t1{[&]() { ioc.run(); }};
+      std::thread t2{[&]() { boost::system::error_code ec; conn.run(ec); }};
+      std::thread t3{[&]() { event_receiver(conn); }};
+
+      for (std::vector<node<std::string>> resp;;) {
+         conn.receive_push(adapt(resp));
+         print_push(resp);
+         resp.clear();
+      }
+
+      t1.join();
+      t2.join();
+      t3.join();
+
+   } catch (std::exception const& e) {
+      std::cerr << e.what() << std::endl;
+   }
+}

examples/sync.cpp

@@ -1,55 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#include <iostream>
-#include <string>
-
-#include <aedis/aedis.hpp>
-#include <aedis/src.hpp>
-
-namespace resp3 = aedis::resp3;
-using aedis::redis::command;
-using aedis::redis::make_serializer;
-using aedis::resp3::adapt;
-
-namespace net = aedis::net;
-using net::dynamic_buffer;
-using net::ip::tcp;
-
-int main()
-{
-   try {
-      net::io_context ioc;
-      tcp::resolver resv{ioc};
-      auto const res = resv.resolve("127.0.0.1", "6379");
-      tcp::socket socket{ioc};
-      connect(socket, res);
-
-      // Creates and sends the request to redis.
-      std::string request;
-      auto sr = make_serializer(request);
-      sr.push(command::hello, 3);
-      sr.push(command::ping);
-      sr.push(command::quit);
-      net::write(socket, net::buffer(request));
-
-      // Will store the response to ping.
-      std::string resp;
-
-      // Reads the responses to all commands in the request.
-      std::string buffer;
-      resp3::read(socket, dynamic_buffer(buffer)); // hello (ignored)
-      resp3::read(socket, dynamic_buffer(buffer), adapt(resp));
-      resp3::read(socket, dynamic_buffer(buffer)); // quit (ignored)
-
-      std::cout << "Ping: " << resp << std::endl;
-
-   } catch (std::exception const& e) {
-      std::cerr << e.what() << std::endl;
-      exit(EXIT_FAILURE);
-   }
-}

examples/transaction.cpp

@@ -1,85 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres at gmail dot com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#include <iostream>
-#include <vector>
-#include <tuple>
-#include <array>
-
-#include <aedis/aedis.hpp>
-#include <aedis/src.hpp>
-
-#include "lib/net_utils.hpp"
-
-namespace resp3 = aedis::resp3;
-using aedis::redis::command;
-using aedis::redis::make_serializer;
-using resp3::adapt;
-
-namespace net = aedis::net;
-using net::async_write;
-using net::buffer;
-using net::dynamic_buffer;
-
-net::awaitable<void> transaction()
-{
-   try {
-      auto socket = co_await connect();
-
-      auto list  = {"one", "two", "three"};
-
-      std::string request;
-      auto sr = make_serializer(request);
-      sr.push(command::hello, 3);
-      sr.push(command::flushall);
-      sr.push(command::multi); // Starts a transaction
-      sr.push(command::ping, "Some message");
-      sr.push(command::incr, "incr1-key");
-      sr.push_range(command::rpush, "list-key", std::cbegin(list), std::cend(list));
-      sr.push(command::lrange, "list-key", 0, -1);
-      sr.push(command::incr, "incr2-key");
-      sr.push(command::exec); // Ends the transaction.
-      sr.push(command::quit);
-      co_await async_write(socket, buffer(request));
-
-      // Expected responses.
-      std::tuple<std::string, int, int, std::vector<std::string>, int> execs;
-
-      // Reads the response.
-      std::string buffer;
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // hello
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // flushall
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // multi
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // ping
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // incr
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // rpush
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // lrange
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // incr
-      co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(execs));
-      co_await resp3::async_read(socket, dynamic_buffer(buffer)); // quit
-
-      // Prints the response to the transaction.
-      std::cout << "ping: " << std::get<0>(execs) << "\n";
-      std::cout << "incr1: " << std::get<1>(execs) << "\n";
-      std::cout << "rpush: " << std::get<2>(execs) << "\n";
-      std::cout << "lrange: ";
-      for (auto const& e: std::get<3>(execs)) std::cout << e << " ";
-      std::cout << "\n";
-      std::cout << "incr2: " << std::get<4>(execs) << "\n";
-
-   } catch (std::exception const& e) {
-      std::cerr << e.what() << std::endl;
-      exit(EXIT_FAILURE);
-   }
-}
-
-int main()
-{
-   net::io_context ioc;
-   co_spawn(ioc, transaction(), net::detached);
-   ioc.run();
-}

include/Makefile.am

@@ -0,0 +1,25 @@
+
+nobase_include_HEADERS =\
+  $(top_srcdir)/include/aedis/src.hpp\
+  $(top_srcdir)/include/aedis/error.hpp\
+  $(top_srcdir)/include/aedis/impl/error.ipp\
+  $(top_srcdir)/include/aedis/detail/net.hpp\
+  $(top_srcdir)/include/aedis/connection.hpp\
+  $(top_srcdir)/include/aedis/adapt.hpp\
+  $(top_srcdir)/include/aedis/sync.hpp\
+  $(top_srcdir)/include/aedis/detail/connection_ops.hpp\
+  $(top_srcdir)/include/aedis.hpp\
+  $(top_srcdir)/include/aedis/adapter/detail/adapters.hpp\
+  $(top_srcdir)/include/aedis/adapter/adapt.hpp\
+  $(top_srcdir)/include/aedis/adapter/detail/response_traits.hpp\
+  $(top_srcdir)/include/aedis/resp3/node.hpp\
+  $(top_srcdir)/include/aedis/resp3/detail/read_ops.hpp\
+  $(top_srcdir)/include/aedis/resp3/detail/parser.hpp\
+  $(top_srcdir)/include/aedis/resp3/detail/exec.hpp\
+  $(top_srcdir)/include/aedis/resp3/type.hpp\
+  $(top_srcdir)/include/aedis/resp3/read.hpp\
+  $(top_srcdir)/include/aedis/resp3/write.hpp\
+  $(top_srcdir)/include/aedis/resp3/request.hpp\
+  $(top_srcdir)/include/aedis/resp3/impl/request.ipp\
+  $(top_srcdir)/include/aedis/resp3/detail/impl/parser.ipp\
+  $(top_srcdir)/include/aedis/resp3/impl/type.ipp

include/aedis.hpp

@@ -0,0 +1,636 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#ifndef AEDIS_HPP
+#define AEDIS_HPP
+
+#include <aedis/error.hpp>
+#include <aedis/adapt.hpp>
+#include <aedis/connection.hpp>
+#include <aedis/sync.hpp>
+#include <aedis/resp3/request.hpp>
+
+/** \mainpage Documentation
+    \tableofcontents
+  
+    Useful links: \subpage any, [Changelog](CHANGELOG.md) and [Benchmarks](benchmarks/benchmarks.md).
+
+    \section Overview
+  
+    Aedis is a high-level [Redis](https://redis.io/) client library
+    built on top of
+    [Asio](https://www.boost.org/doc/libs/release/doc/html/boost_asio.html).
+    Some of its distinctive features are
+
+    \li Support for the latest version of the Redis communication protocol [RESP3](https://github.com/redis/redis-specifications/blob/master/protocol/RESP3.md).
+    \li First class support for STL containers and C++ built-in types.
+    \li Serialization and deserialization of your own data types.
+    \li Healthy checks, back pressure and low latency.
+    \li Hides most of the low level asynchronous operations away from the user.
+
+    Let us have a look a some code snippets
+
+    @subsection Async
+
+    The code below sends a ping command to Redis and quits (see intro.cpp)
+
+    @code
+    int main()
+    {
+       net::io_context ioc;
+       connection db{ioc};
+
+       request req;
+       req.push("PING");
+       req.push("QUIT");
+
+       std::tuple<std::string, aedis::ignore> resp;
+       db.async_run(req, adapt(resp), net::detached);
+
+       ioc.run();
+
+       std::cout << std::get<0>(resp) << std::endl;
+    }
+    @endcode
+
+    The connection class maintains a healthy connection with Redis
+    over which users can execute their commands, without any need of
+    queuing. For example, to execute more than one request
+
+    @code
+    int main()
+    {
+       ...
+       net::io_context ioc;
+       connection db{ioc};
+
+       db.async_exec(req1, adapt(resp1), handler1);
+       db.async_exec(req2, adapt(resp2), handler2);
+       db.async_exec(req3, adapt(resp3), handler3);
+
+       db.async_run(net::detached);
+
+       ioc.run();
+       ...
+    }
+    @endcode
+
+    The `connection::async_exec` functions above can be called from different
+    places in the code without knowing about each other, see for
+    example echo_server.cpp.  Server-side pushes are supported on the
+    same connection where commands are executed, a typical subscriber
+    will look like
+    (see subscriber.cpp)
+
+    @code
+    net::awaitable<void> reader(std::shared_ptr<connection> db)
+    {
+       for (std::vector<node_type> resp;;) {
+          co_await db->async_receive_event(adapt(resp));
+          // Use resp and clear it.
+          resp.clear();
+       }
+    }
+    @endcode
+
+    @subsection Sync
+
+    The `connection` class offers only an asynchronous API.
+    Synchronous communications with redis is provided by the `aedis::sync`
+    wrapper class. (see intro_sync.cpp)
+
+    @code
+    int main()
+    {
+       net::io_context ioc{1};
+       auto work = net::make_work_guard(ioc);
+       std::thread t1{[&]() { ioc.run(); }};
+ 
+       sync<connection> conn{work.get_executor()};
+       std::thread t2{[&]() { boost::system::error_code ec; conn.run(ec); }};
+ 
+       request req;
+       req.push("PING");
+       req.push("QUIT");
+ 
+       std::tuple<std::string, aedis::ignore> resp;
+       conn.exec(req, adapt(resp));
+       std::cout << "Response: " << std::get<0>(resp) << std::endl;
+ 
+       work.reset();
+ 
+       t1.join();
+       t2.join();
+    }
+    @endcode
+
+    \subsection using-aedis Installation
+
+    To install and use Aedis you will need
+  
+    - Boost 1.78 or greater.
+    - C++17. Some examples require C++20 with coroutine support.
+    - Redis 6 or higher. Optionally also redis-cli and Redis Sentinel.
+
+    For a simple installation run
+
+    ```
+    $ git clone --branch v1.0.0 https://github.com/mzimbres/aedis.git
+    $ cd aedis
+
+    # Option 1: Direct compilation.
+    $ g++ -std=c++17 -pthread examples/intro.cpp -I./include -I/path/boost_1_79_0/include/
+
+    # Option 2: Use cmake.
+    $ BOOST_ROOT=/opt/boost_1_79_0/ cmake -DCMAKE_CXX_FLAGS=-std=c++20 .
+    ```
+
+    @note CMake support is still experimental.
+
+    For a proper full installation on the system run
+
+    ```
+    # Download and unpack the latest release
+    $ wget https://github.com/mzimbres/aedis/releases/download/v1.0.0/aedis-1.0.0.tar.gz
+    $ tar -xzvf aedis-1.0.0.tar.gz
+
+    # Configure, build and install
+    $ CXXFLAGS="-std=c++17" ./configure --prefix=/opt/aedis-1.0.0 --with-boost=/opt/boost_1_78_0
+    $ sudo make install
+    ```
+
+    To build examples and tests
+
+    ```
+    $ make
+    ```
+
+    @subsubsection using_aedis Using Aedis
+
+    When writing you own applications include the following header 
+  
+    ```cpp
+    #include <aedis/src.hpp>
+
+    ```
+
+    in no more than one source file in your applications.
+
+    @subsubsection sup-comp Supported compilers
+
+    Aedis has been tested with the following compilers
+
+    - Tested with gcc: 12, 11.
+    - Tested with clang: 14, 13, 11.
+  
+    \subsubsection Developers
+  
+    To generate the build system clone the repository and run
+  
+    ```
+    # git clone https://github.com/mzimbres/aedis.git
+    $ autoreconf -i
+    ```
+  
+    After that we get a configure script that can be run as explained
+    above, for example, to build with a compiler other that the system
+    compiler with coverage support run
+  
+    ```
+    $ CXX=clang++-14 \
+      CXXFLAGS="-g -std=c++20 -Wall -Wextra --coverage -fkeep-inline-functions -fkeep-static-functions" \
+      LDFLAGS="--coverage" \
+      ./configure --with-boost=/opt/boost_1_79_0
+    ```
+
+    To generate release tarballs run
+
+    ```
+    $ make distcheck
+    ```
+
+    \section requests Requests
+
+    Redis requests are composed of one of more Redis commands (in
+    Redis documentation they are called
+    [pipelines](https://redis.io/topics/pipelining)). For example
+
+    @code
+    request req;
+
+    // Command with variable length of arguments.
+    req.push("SET", "key", "some value", value, "EX", "2");
+
+    // Pushes a list.
+    std::list<std::string> list
+       {"channel1", "channel2", "channel3"};
+    req.push_range("SUBSCRIBE", list);
+
+    // Same as above but as an iterator range.
+    req.push_range2("SUBSCRIBE", std::cbegin(list), std::cend(list));
+
+    // Pushes a map.
+    std::map<std::string, mystruct> map
+       { {"key1", "value1"}
+       , {"key2", "value2"}
+       , {"key3", "value3"}};
+    req.push_range("HSET", "key", map);
+    @endcode
+
+    Sending a request to Redis is then peformed with the following function
+
+    @code
+    co_await db->async_exec(req, adapt(resp));
+    @endcode
+
+    \subsection requests-serialization Serialization
+
+    The \c push and \c push_range functions above work with integers
+    e.g. \c int and \c std::string out of the box. To send your own
+    data type defined a \c to_bulk function like this
+
+    @code
+    struct mystruct {
+       // Example struct.
+    };
+    
+    void to_bulk(std::string& to, mystruct const& obj)
+    {
+       std::string dummy = "Dummy serializaiton string.";
+       aedis::resp3::to_bulk(to, dummy);
+    }
+    @endcode
+
+    Once \c to_bulk is defined and accessible over ADL \c mystruct can
+    be passed to the \c request
+
+    @code
+    request req;
+
+    std::map<std::string, mystruct> map {...};
+
+    req.push_range("HSET", "key", map);
+    @endcode
+
+    Example serialization.cpp shows how store json string in Redis.
+
+    \section low-level-responses Responses
+
+    To read responses effectively, users must know their RESP3 type,
+    this can be found in the Redis documentation for each command
+    (https://redis.io/commands). For example
+
+    Command  | RESP3 type                          | Documentation
+    ---------|-------------------------------------|--------------
+    lpush    | Number                              | https://redis.io/commands/lpush
+    lrange   | Array                               | https://redis.io/commands/lrange
+    set      | Simple-string, null or blob-string  | https://redis.io/commands/set
+    get      | Blob-string                         | https://redis.io/commands/get
+    smembers | Set                                 | https://redis.io/commands/smembers
+    hgetall  | Map                                 | https://redis.io/commands/hgetall
+
+    Once the RESP3 type of a given response is known we can choose a
+    proper C++ data structure to receive it in. Fortunately, this is a
+    simple task for most types. The table below summarises the options
+
+    RESP3 type     | Possible C++ type                                            | Type
+    ---------------|--------------------------------------------------------------|------------------
+    Simple-string  | \c std::string                                             | Simple
+    Simple-error   | \c std::string                                             | Simple
+    Blob-string    | \c std::string, \c std::vector                             | Simple
+    Blob-error     | \c std::string, \c std::vector                             | Simple
+    Number         | `long long`, `int`, `std::size_t`, \c std::string          | Simple
+    Double         | `double`, \c std::string                                   | Simple
+    Null           | `boost::optional<T>`                                       | Simple
+    Array          | \c std::vector, \c std::list, \c std::array, \c std::deque | Aggregate
+    Map            | \c std::vector, \c std::map, \c std::unordered_map         | Aggregate
+    Set            | \c std::vector, \c std::set, \c std::unordered_set         | Aggregate
+    Push           | \c std::vector, \c std::map, \c std::unordered_map         | Aggregate
+
+    For example
+
+    @code
+    request req;
+    req.push("HELLO", 3);
+    req.push_range("RPUSH", "key1", vec);
+    req.push_range("HSET", "key2", map);
+    req.push("LRANGE", "key3", 0, -1);
+    req.push("HGETALL", "key4");
+    req.push("QUIT");
+
+    std::tuple<
+       aedis::ignore,  // hello
+       int,            // rpush
+       int,            // hset
+       std::vector<T>, // lrange
+       std::map<U, V>, // hgetall
+       std::string     // quit
+    > resp;
+
+    co_await db->async_exec(req, adapt(resp));
+    @endcode
+
+    The tag @c aedis::ignore can be used to ignore individual
+    elements in the responses. If the intention is to ignore the
+    response to all commands in the request use @c adapt()
+
+    @code
+    co_await db->async_exec(req, adapt());
+    @endcode
+
+    Responses that contain nested aggregates or heterogeneous data
+    types will be given special treatment later in \ref gen-case.  As
+    of this writing, not all RESP3 types are used by the Redis server,
+    which means in practice users will be concerned with a reduced
+    subset of the RESP3 specification.
+
+    \subsection Optional
+
+    It is not uncommon for apps to access keys that do not exist or
+    that have already expired in the Redis server, to deal with these
+    cases Aedis provides support for \c boost::optional. To use it,
+    wrap your type around \c boost::optional like this
+
+    @code
+    boost::optional<std::unordered_map<T, U>> resp;
+    co_await db->async_exec(req, adapt(resp));
+    @endcode
+
+    Everything else stays the same.
+
+    \subsection transactions Transactions
+
+    To read the response to transactions we have to observe that Redis
+    queues the commands as they arrive and sends the responses back to
+    the user as an array, in the response to the @c exec command.
+    For example, to read the response to the this request
+
+    @code
+    db.send("MULTI");
+    db.send("GET", "key1");
+    db.send("LRANGE", "key2", 0, -1);
+    db.send("HGETALL", "key3");
+    db.send("EXEC");
+    @endcode
+
+    use the following response type
+
+    @code
+    using aedis::ignore;
+    using boost::optional;
+
+    using exec_resp_type = 
+       std::tuple<
+          optional<std::string>, // get
+          optional<std::vector<std::string>>, // lrange
+          optional<std::map<std::string, std::string>> // hgetall
+       >;
+
+    std::tuple<
+       ignore,     // multi
+       ignore,     // get
+       ignore,     // lrange
+       ignore,     // hgetall
+       exec_resp_type, // exec
+    > resp;
+
+    co_await db->async_exec(req, adapt(resp));
+    @endcode
+
+    Note that above we are not ignoring the response to the commands
+    themselves but whether they have been successfully queued. For a
+    complete example see containers.cpp.
+
+    \subsection Deserialization
+
+    As mentioned in \ref requests-serialization, it is common to
+    serialize data before sending it to Redis e.g.  to json strings.
+    For performance and convenience reasons, we may also want to
+    deserialize it directly in its final data structure. Aedis
+    supports this use case by calling a user provided \c from_bulk
+    function while parsing the response. For example
+
+    @code
+    void from_bulk(mystruct& obj, char const* p, std::size_t size, boost::system::error_code& ec)
+    {
+       // Deserializes p into obj.
+    }
+    @endcode
+
+    After that, you can start receiving data efficiently in the desired
+    types e.g. \c mystruct, \c std::map<std::string, mystruct> etc.
+
+    \subsection gen-case The general case
+
+    There are cases where responses to Redis
+    commands won't fit in the model presented above, some examples are
+
+    @li Commands (like \c set) whose responses don't have a fixed
+    RESP3 type. Expecting an \c int and receiving a blob-string
+    will result in error.
+    @li RESP3 aggregates that contain nested aggregates can't be read in STL containers.
+    @li Transactions with a dynamic number of commands can't be read in a \c std::tuple.
+
+    To deal with these cases Aedis provides the \c resp3::node
+    type, that is the most general form of an element in a response,
+    be it a simple RESP3 type or an aggregate. It is defined like this
+
+    @code
+    template <class String>
+    struct node {
+       // The RESP3 type of the data in this node.
+       type data_type;
+
+       // The number of elements of an aggregate (or 1 for simple data).
+       std::size_t aggregate_size;
+
+       // The depth of this node in the response tree.
+       std::size_t depth;
+
+       // The actual data. For aggregate types this is always empty.
+       String value;
+    };
+    @endcode
+
+    Any response to a Redis command can be received in a \c
+    std::vector<node<std::string>>.  The vector can be seen as a
+    pre-order view of the response tree
+    (https://en.wikipedia.org/wiki/Tree_traversal#Pre-order,_NLR).
+    Using it is no different than using other types
+
+    @code
+    // Receives any RESP3 simple data type.
+    node<std::string> resp;
+    co_await db->async_exec(req, adapt(resp));
+
+    // Receives any RESP3 simple or aggregate data type.
+    std::vector<node<std::string>> resp;
+    co_await db->async_exec(req, adapt(resp));
+    @endcode
+
+    For example, suppose we want to retrieve a hash data structure
+    from Redis with `HGETALL`, some of the options are
+
+    @li \c std::vector<node<std::string>: Works always.
+    @li \c std::vector<std::string>: Efficient and flat, all elements as string.
+    @li \c std::map<std::string, std::string>: Efficient if you need the data as a \c std::map
+    @li \c std::map<U, V>: Efficient if you are storing serialized data. Avoids temporaries and requires \c from_bulk for \c U and \c V.
+
+    In addition to the above users can also use unordered versions of the containers. The same reasoning also applies to sets e.g. `SMEMBERS`.
+
+    \section examples Examples
+
+    The examples listed below cover most use cases presented in the documentation above.
+
+    @li intro.cpp: Basic steps with Aedis.
+    @li intro_sync.cpp: Synchronous version of intro.cpp.
+    @li containers.cpp: Shows how to send and receive stl containers.
+    @li serialization.cpp: Shows how to serialize your own types.
+    @li subscriber.cpp: Shows how to use pubsub.
+    @li subscriber_sync.cpp: Synchronous version of subscriber.cpp.
+    @li echo_server.cpp: A simple TCP echo server that uses coroutines.
+    @li chat_room.cpp: A simple chat room that uses coroutines.
+
+    \section why-aedis Why Aedis
+
+    At the time of this writing there are seventeen Redis clients
+    listed in the [official](https://redis.io/docs/clients/#cpp) list.
+    With so many clients available it is not unlikely that users are
+    asking themselves why yet another one.  In this section I will try
+    to compare Aedis with the most popular clients and why we need
+    Aedis. Notice however that this is ongoing work as comparing
+    client objectively is difficult and time consuming.
+
+    The most popular client at the moment of this writing ranked by
+    github stars is
+
+    @li https://github.com/sewenew/redis-plus-plus
+
+    Before we start it is worth mentioning some of the things it does
+    not support
+
+    @li RESP3. Without RESP3 is impossible to support some important Redis features like client side caching, among other things.
+    @li Coroutines.
+    @li Reading responses directly in user data structures avoiding temporaries.
+    @li Error handling with error-code and exception overloads.
+    @li Healthy checks.
+
+    The remaining points will be addressed individually.
+
+    @subsection redis-plus-plus
+
+    Let us first have a look at what sending a command a pipeline and a
+    transaction look like
+
+    @code
+    auto redis = Redis("tcp://127.0.0.1:6379");
+
+    // Send commands
+    redis.set("key", "val");
+    auto val = redis.get("key"); // val is of type OptionalString.
+    if (val)
+        std::cout << *val << std::endl;
+
+    // Sending pipelines
+    auto pipe = redis.pipeline();
+    auto pipe_replies = pipe.set("key", "value")
+                            .get("key")
+                            .rename("key", "new-key")
+                            .rpush("list", {"a", "b", "c"})
+                            .lrange("list", 0, -1)
+                            .exec();
+
+    // Parse reply with reply type and index.
+    auto set_cmd_result = pipe_replies.get<bool>(0);
+    // ...
+
+    // Sending a transaction
+    auto tx = redis.transaction();
+    auto tx_replies = tx.incr("num0")
+                        .incr("num1")
+                        .mget({"num0", "num1"})
+                        .exec();
+
+    auto incr_result0 = tx_replies.get<long long>(0);
+    // ...
+    @endcode
+
+    Some of the problems with this API are
+
+    @li Heterogeneous treatment of commands, pipelines and transaction. This makes auto-pipelining impossible.
+    @li Any Api that sends individual commands has a very restricted scope of usability and should be avoided for performance reasons.
+    @li The API imposes exceptions on users, no error-code overload is provided.
+    @li No way to reuse the buffer for new calls to e.g. \c redis.get in order to avoid further dynamic memory allocations.
+    @li Error handling of resolve and connection not clear.
+
+    According to the documentation, pipelines in redis-plus-plus have
+    the following characteristics
+
+    > NOTE: By default, creating a Pipeline object is NOT cheap, since
+    > it creates a new connection.
+
+    This is clearly a downside of the API as pipelines should be the
+    default way of communicating and not an exception, paying such a
+    high price for each pipeline imposes a severe cost in performance.
+    Transactions also suffer from the very same problem.
+
+    > NOTE: Creating a Transaction object is NOT cheap, since it
+    > creates a new connection.
+
+    In Aedis there is no difference between sending one command, a
+    pipeline or a transaction because requests are decoupled
+    from the IO objects.
+
+    > redis-plus-plus also supports async interface, however, async
+    > support for Transaction and Subscriber is still on the way.
+    > 
+    > The async interface depends on third-party event library, and so
+    > far, only libuv is supported.
+
+    Async code in redis-plus-plus looks like the following
+
+    @code
+    auto async_redis = AsyncRedis(opts, pool_opts);
+    
+    Future<string> ping_res = async_redis.ping();
+    
+    cout << ping_res.get() << endl;
+    @endcode
+
+    As the reader can see, the async interface is based on futures
+    which is also known to have a bad performance.  The biggest
+    problem however with this async design is that it makes it
+    impossible to write asynchronous programs correctly since it
+    starts an async operation on every command sent instead of
+    enqueueing a message and triggering a write when it can be sent.
+    It is also not clear how are pipelines realised with the design
+    (if at all).
+
+    \section Acknowledgement
+
+    Some people that were helpful in the development of Aedis
+
+    @li Richard Hodges ([madmongo1](https://github.com/madmongo1)): For helping me with Asio and the design of asynchronous programs in general.
+    @li Vinícius dos Santos Oliveira ([vinipsmaker](https://github.com/vinipsmaker)): For useful discussion about how Aedis consumes buffers in the read operation (among other things).
+    @li Petr Dannhofer ([Eddie-cz](https://github.com/Eddie-cz)): For helping me understand how the `AUTH` and `HELLO` command can influence each other.
+ */
+
+/** \defgroup any Reference
+ *
+ *  This page contains the documentation of all user facing code.
+ */
+
+//  Support sentinel support as described in 
+//
+//  - https://redis.io/docs/manual/sentinel.
+//  - https://redis.io/docs/reference/sentinel-clients.
+//
+//  Avoid conflicts between
+//
+//  - aedis::adapt 
+//  - aedis::resp3::adapt.
+
+#endif // AEDIS_HPP

include/aedis/adapt.hpp

@@ -0,0 +1,159 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#ifndef AEDIS_ADAPT_HPP
+#define AEDIS_ADAPT_HPP
+
+#include <tuple>
+
+#include <boost/mp11.hpp>
+#include <boost/variant2.hpp>
+#include <boost/utility/string_view.hpp>
+#include <boost/system.hpp>
+
+#include <aedis/resp3/node.hpp>
+#include <aedis/adapter/adapt.hpp>
+#include <aedis/adapter/detail/response_traits.hpp>
+
+namespace aedis {
+
+/** @brief Tag used to ignore responses.
+ *  @ingroup any
+ *
+ *  For example
+ *
+ *  @code
+ *  std::tuple<aedis::ignore, std::string, aedis::ignore> resp;
+ *  @endcode
+ *
+ *  will cause only the second tuple type to be parsed, the others
+ *  will be ignored.
+ */
+using ignore = adapter::detail::ignore;
+
+namespace detail {
+
+struct ignore_adapter {
+   void
+   operator()(
+      std::size_t,
+      resp3::node<boost::string_view> const&,
+      boost::system::error_code&)
+   {
+   }
+
+   auto supported_response_size() const noexcept { return std::size_t(-1);}
+};
+
+template <class Tuple>
+class static_adapter {
+private:
+   static constexpr auto size = std::tuple_size<Tuple>::value;
+   using adapter_tuple = boost::mp11::mp_transform<adapter::adapter_t, Tuple>;
+   using variant_type = boost::mp11::mp_rename<adapter_tuple, boost::variant2::variant>;
+   using adapters_array_type = std::array<variant_type, size>;
+
+   adapters_array_type adapters_;
+
+public:
+   static_adapter(Tuple& r = nullptr)
+   {
+      adapter::detail::assigner<size - 1>::assign(adapters_, r);
+   }
+
+   auto supported_response_size() const noexcept { return size;}
+
+   void
+   operator()(
+      std::size_t i,
+      resp3::node<boost::string_view> const& nd,
+      boost::system::error_code& ec)
+   {
+      using boost::variant2::visit;
+      BOOST_ASSERT(i < adapters_.size());
+      visit([&](auto& arg){arg(nd, ec);}, adapters_.at(i));
+   }
+};
+
+template <class Vector>
+class vector_adapter {
+private:
+   using adapter_type = typename adapter::detail::response_traits<Vector>::adapter_type;
+   adapter_type adapter_;
+
+public:
+   vector_adapter(Vector& v) : adapter_{adapter::adapt2(v)} { }
+
+   auto supported_response_size() const noexcept { return std::size_t(-1);}
+
+   void
+   operator()(
+      std::size_t,
+      resp3::node<boost::string_view> const& nd,
+      boost::system::error_code& ec)
+   {
+      adapter_(nd, ec);
+   }
+};
+
+template <class>
+struct response_traits;
+
+template <>
+struct response_traits<void> {
+   using response_type = void;
+   using adapter_type = detail::ignore_adapter;
+
+   static auto adapt() noexcept
+      { return detail::ignore_adapter{}; }
+};
+
+template <class String, class Allocator>
+struct response_traits<std::vector<resp3::node<String>, Allocator>> {
+   using response_type = std::vector<resp3::node<String>, Allocator>;
+   using adapter_type = vector_adapter<response_type>;
+
+   static auto adapt(response_type& v) noexcept
+      { return adapter_type{v}; }
+};
+
+template <class ...Ts>
+struct response_traits<std::tuple<Ts...>> {
+   using response_type = std::tuple<Ts...>;
+   using adapter_type = static_adapter<response_type>;
+
+   static auto adapt(response_type& r) noexcept
+      { return adapter_type{r}; }
+};
+
+} // detail
+
+/** @brief Creates an adapter that ignores responses.
+ *  @ingroup any
+ *
+ *  This function can be used to create adapters that ignores
+ *  responses.
+ */
+auto adapt() noexcept
+{
+   return detail::response_traits<void>::adapt();
+}
+
+/** @brief Adapts a type to be used as a response.
+ *  @ingroup any
+ *
+ *  The type T can be any STL container, any integer type and
+ *  \c std::string
+ */
+template<class T>
+auto adapt(T& t) noexcept
+{
+   return detail::response_traits<T>::adapt(t);
+}
+
+} // aedis
+
+#endif // AEDIS_ADAPT_HPP

include/aedis/adapter/adapt.hpp

@@ -0,0 +1,84 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#ifndef AEDIS_ADAPTER_ADAPT_HPP
+#define AEDIS_ADAPTER_ADAPT_HPP
+
+#include <aedis/adapter/detail/response_traits.hpp>
+
+namespace aedis {
+namespace adapter {
+
+template <class T>
+using adapter_t = typename detail::adapter_t<T>;
+
+/** \internal
+    \brief Creates a dummy response adapter.
+    \ingroup any
+  
+    The adapter returned by this function ignores responses. It is
+    useful to avoid wasting time with responses which are not needed.
+
+    Example:
+
+    @code
+    // Pushes and writes some commands to the server.
+    sr.push(command::hello, 3);
+    sr.push(command::ping);
+    sr.push(command::quit);
+    net::write(socket, net::buffer(request));
+
+    // Ignores all responses except for the response to ping.
+    std::string buffer;
+    resp3::read(socket, dynamic_buffer(buffer), adapt());     // hello
+    resp3::read(socket, dynamic_buffer(buffer), adapt(resp)); // ping
+    resp3::read(socket, dynamic_buffer(buffer, adapt()));     // quit
+    @endcode
+ */
+inline
+auto adapt2() noexcept
+   { return detail::response_traits<void>::adapt(); }
+
+/** \internal
+ *  \brief Adapts user data to read operations.
+ *  \ingroup any
+ *
+ *  STL containers, \c std::tuple and built-in types are supported and
+ *  can be used in conjunction with \c boost::optional<T>.
+ *
+ *  Example usage:
+ *
+ *  @code
+ *  std::unordered_map<std::string, std::string> cont;
+ *  co_await async_read(socket, buffer, adapt(cont));
+ *  @endcode
+ * 
+ *  For a transaction
+ *
+ *  @code
+ *  sr.push(command::multi);
+ *  sr.push(command::ping, ...);
+ *  sr.push(command::incr, ...);
+ *  sr.push_range(command::rpush, ...);
+ *  sr.push(command::lrange, ...);
+ *  sr.push(command::incr, ...);
+ *  sr.push(command::exec);
+ *
+ *  co_await async_write(socket, buffer(request));
+ *
+ *  // Reads the response to a transaction
+ *  std::tuple<std::string, int, int, std::vector<std::string>, int> execs;
+ *  co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(execs));
+ *  @endcode
+ */
+template<class T>
+auto adapt2(T& t) noexcept
+   { return detail::response_traits<T>::adapt(t); }
+
+} // adapter
+} // aedis
+
+#endif // AEDIS_ADAPTER_ADAPT_HPP

include/aedis/adapter/detail/adapters.hpp

@@ -0,0 +1,430 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#ifndef AEDIS_ADAPTER_ADAPTERS_HPP
+#define AEDIS_ADAPTER_ADAPTERS_HPP
+
+#include <set>
+#include <unordered_set>
+#include <forward_list>
+#include <system_error>
+#include <map>
+#include <unordered_map>
+#include <list>
+#include <deque>
+#include <vector>
+#include <array>
+
+#include <boost/assert.hpp>
+#include <boost/optional.hpp>
+#include <boost/spirit/include/qi.hpp>
+#include <boost/spirit/home/x3.hpp>
+#include <boost/utility/string_view.hpp>
+
+#include <aedis/error.hpp>
+#include <aedis/resp3/type.hpp>
+#include <aedis/resp3/request.hpp>
+#include <aedis/resp3/detail/parser.hpp>
+#include <aedis/resp3/node.hpp>
+
+namespace aedis {
+namespace adapter {
+namespace detail {
+
+double
+parse_double(
+   char const* data,
+   std::size_t size,
+   boost::system::error_code& ec)
+{
+   static constexpr boost::spirit::x3::real_parser<double> p{};
+   double ret;
+   if (!parse(data, data + size, p, ret))
+      ec = error::not_a_double;
+
+   return ret;
+}
+
+// Serialization.
+
+template <class T>
+typename std::enable_if<std::is_integral<T>::value, void>::type
+from_bulk(
+   T& i,
+   boost::string_view sv,
+   boost::system::error_code& ec)
+{
+   i = resp3::detail::parse_uint(sv.data(), sv.size(), ec);
+}
+
+void from_bulk(
+   bool& t,
+   boost::string_view sv,
+   boost::system::error_code&)
+{
+   t = *sv.data() == 't';
+}
+
+void from_bulk(
+   double& d,
+   boost::string_view sv,
+   boost::system::error_code& ec)
+{
+   d = parse_double(sv.data(), sv.size(), ec);
+}
+
+template <class CharT, class Traits, class Allocator>
+void
+from_bulk(
+   std::basic_string<CharT, Traits, Allocator>& s,
+   boost::string_view sv,
+   boost::system::error_code&)
+{
+  s.append(sv.data(), sv.size());
+}
+
+//================================================
+
+void set_on_resp3_error(resp3::type t, boost::system::error_code& ec)
+{
+   switch (t) {
+      case resp3::type::simple_error: ec = error::simple_error; return;
+      case resp3::type::blob_error: ec = error::blob_error; return;
+      case resp3::type::null: ec = error::null; return;
+      default: return;
+   }
+}
+
+template <class Result>
+class general_aggregate {
+private:
+   Result* result_;
+
+public:
+   general_aggregate(Result* c = nullptr): result_(c) {}
+   void operator()(resp3::node<boost::string_view> const& n, boost::system::error_code& ec)
+   {
+      result_->push_back({n.data_type, n.aggregate_size, n.depth, std::string{std::cbegin(n.value), std::cend(n.value)}});
+      set_on_resp3_error(n.data_type, ec);
+   }
+};
+
+template <class Node>
+class general_simple {
+private:
+   Node* result_;
+
+public:
+   general_simple(Node* t = nullptr) : result_(t) {}
+
+   void operator()(resp3::node<boost::string_view> const& n, boost::system::error_code& ec)
+   {
+      result_->data_type = n.data_type;
+      result_->aggregate_size = n.aggregate_size;
+      result_->depth = n.depth;
+      result_->value.assign(n.value.data(), n.value.size());
+      set_on_resp3_error(n.data_type, ec);
+   }
+};
+
+template <class Result>
+class simple_impl {
+public:
+   void on_value_available(Result&) {}
+
+   void
+   operator()(
+      Result& result,
+      resp3::node<boost::string_view> const& n,
+      boost::system::error_code& ec)
+   {
+      set_on_resp3_error(n.data_type, ec);
+      if (ec)
+         return;
+
+      if (is_aggregate(n.data_type)) {
+         ec = error::expects_resp3_simple_type;
+         return;
+      }
+
+      from_bulk(result, n.value, ec);
+   }
+};
+
+template <class Result>
+class set_impl {
+private:
+   typename Result::iterator hint_;
+
+public:
+   void on_value_available(Result& result)
+      { hint_ = std::end(result); }
+
+   void
+   operator()(
+      Result& result,
+      resp3::node<boost::string_view> const& nd,
+      boost::system::error_code& ec)
+   {
+      set_on_resp3_error(nd.data_type, ec);
+      if (ec)
+         return;
+
+      if (is_aggregate(nd.data_type)) {
+         if (nd.data_type != resp3::type::set)
+            ec = error::expects_resp3_set;
+         return;
+      }
+
+      BOOST_ASSERT(nd.aggregate_size == 1);
+
+      if (nd.depth < 1) {
+	 ec = error::expects_resp3_set;
+	 return;
+      }
+
+      typename Result::key_type obj;
+      from_bulk(obj, nd.value, ec);
+      hint_ = result.insert(hint_, std::move(obj));
+   }
+};
+
+template <class Result>
+class map_impl {
+private:
+   typename Result::iterator current_;
+   bool on_key_ = true;
+
+public:
+   void on_value_available(Result& result)
+      { current_ = std::end(result); }
+
+   void
+   operator()(
+      Result& result,
+      resp3::node<boost::string_view> const& nd,
+      boost::system::error_code& ec)
+   {
+      set_on_resp3_error(nd.data_type, ec);
+      if (ec)
+         return;
+
+      if (is_aggregate(nd.data_type)) {
+         if (element_multiplicity(nd.data_type) != 2)
+           ec = error::expects_resp3_map;
+         return;
+      }
+
+      BOOST_ASSERT(nd.aggregate_size == 1);
+
+      if (nd.depth < 1) {
+	 ec = error::expects_resp3_map;
+	 return;
+      }
+
+      if (on_key_) {
+         typename Result::key_type obj;
+         from_bulk(obj, nd.value, ec);
+         current_ = result.insert(current_, {std::move(obj), {}});
+      } else {
+         typename Result::mapped_type obj;
+         from_bulk(obj, nd.value, ec);
+         current_->second = std::move(obj);
+      }
+
+      on_key_ = !on_key_;
+   }
+};
+
+template <class Result>
+class vector_impl {
+public:
+   void on_value_available(Result& ) { }
+
+   void
+   operator()(
+      Result& result,
+      resp3::node<boost::string_view> const& nd,
+      boost::system::error_code& ec)
+   {
+      set_on_resp3_error(nd.data_type, ec);
+      if (ec)
+         return;
+
+      if (is_aggregate(nd.data_type)) {
+         auto const m = element_multiplicity(nd.data_type);
+         result.reserve(result.size() + m * nd.aggregate_size);
+      } else {
+         result.push_back({});
+         from_bulk(result.back(), nd.value, ec);
+      }
+   }
+};
+
+template <class Result>
+class array_impl {
+private:
+   int i_ = -1;
+
+public:
+   void on_value_available(Result& ) { }
+
+   void
+   operator()(
+      Result& result,
+      resp3::node<boost::string_view> const& nd,
+      boost::system::error_code& ec)
+   {
+      set_on_resp3_error(nd.data_type, ec);
+      if (ec)
+         return;
+
+      if (is_aggregate(nd.data_type)) {
+	 if (i_ != -1) {
+            ec = error::nested_aggregate_unsupported;
+            return;
+         }
+
+         if (result.size() != nd.aggregate_size * element_multiplicity(nd.data_type)) {
+            ec = error::incompatible_size;
+            return;
+         }
+      } else {
+         if (i_ == -1) {
+            ec = error::expects_resp3_aggregate;
+            return;
+         }
+
+         BOOST_ASSERT(nd.aggregate_size == 1);
+         from_bulk(result.at(i_), nd.value, ec);
+      }
+
+      ++i_;
+   }
+};
+
+template <class Result>
+struct list_impl {
+
+   void on_value_available(Result& ) { }
+
+   void
+   operator()(
+      Result& result,
+      resp3::node<boost::string_view> const& nd,
+      boost::system::error_code& ec)
+   {
+      set_on_resp3_error(nd.data_type, ec);
+      if (ec)
+         return;
+
+      if (!is_aggregate(nd.data_type)) {
+        BOOST_ASSERT(nd.aggregate_size == 1);
+        if (nd.depth < 1) {
+           ec = error::expects_resp3_aggregate;
+           return;
+        }
+
+        result.push_back({});
+        from_bulk(result.back(), nd.value, ec);
+      }
+   }
+};
+
+//---------------------------------------------------
+
+template <class T>
+struct impl_map { using type = simple_impl<T>; };
+
+template <class Key, class Compare, class Allocator>
+struct impl_map<std::set<Key, Compare, Allocator>> { using type = set_impl<std::set<Key, Compare, Allocator>>; };
+
+template <class Key, class Compare, class Allocator>
+struct impl_map<std::multiset<Key, Compare, Allocator>> { using type = set_impl<std::multiset<Key, Compare, Allocator>>; };
+
+template <class Key, class Hash, class KeyEqual, class Allocator>
+struct impl_map<std::unordered_set<Key, Hash, KeyEqual, Allocator>> { using type = set_impl<std::unordered_set<Key, Hash, KeyEqual, Allocator>>; };
+
+template <class Key, class Hash, class KeyEqual, class Allocator>
+struct impl_map<std::unordered_multiset<Key, Hash, KeyEqual, Allocator>> { using type = set_impl<std::unordered_multiset<Key, Hash, KeyEqual, Allocator>>; };
+
+template <class Key, class T, class Compare, class Allocator>
+struct impl_map<std::map<Key, T, Compare, Allocator>> { using type = map_impl<std::map<Key, T, Compare, Allocator>>; };
+
+template <class Key, class T, class Compare, class Allocator>
+struct impl_map<std::multimap<Key, T, Compare, Allocator>> { using type = map_impl<std::multimap<Key, T, Compare, Allocator>>; };
+
+template <class Key, class Hash, class KeyEqual, class Allocator>
+struct impl_map<std::unordered_map<Key, Hash, KeyEqual, Allocator>> { using type = map_impl<std::unordered_map<Key, Hash, KeyEqual, Allocator>>; };
+
+template <class Key, class Hash, class KeyEqual, class Allocator>
+struct impl_map<std::unordered_multimap<Key, Hash, KeyEqual, Allocator>> { using type = map_impl<std::unordered_multimap<Key, Hash, KeyEqual, Allocator>>; };
+
+template <class T, class Allocator>
+struct impl_map<std::vector<T, Allocator>> { using type = vector_impl<std::vector<T, Allocator>>; };
+
+template <class T, std::size_t N>
+struct impl_map<std::array<T, N>> { using type = array_impl<std::array<T, N>>; };
+
+template <class T, class Allocator>
+struct impl_map<std::list<T, Allocator>> { using type = list_impl<std::list<T, Allocator>>; };
+
+template <class T, class Allocator>
+struct impl_map<std::deque<T, Allocator>> { using type = list_impl<std::deque<T, Allocator>>; };
+
+//---------------------------------------------------
+
+template <class Result>
+class wrapper {
+private:
+   Result* result_;
+   typename impl_map<Result>::type impl_;
+
+public:
+   wrapper(Result* t = nullptr) : result_(t)
+      { impl_.on_value_available(*result_); }
+
+   void
+   operator()(
+      resp3::node<boost::string_view> const& nd,
+      boost::system::error_code& ec)
+   {
+      BOOST_ASSERT(result_);
+      impl_(*result_, nd, ec);
+   }
+};
+
+template <class T>
+class wrapper<boost::optional<T>> {
+private:
+   boost::optional<T>* result_;
+   typename impl_map<T>::type impl_;
+
+public:
+   wrapper(boost::optional<T>* o = nullptr) : result_(o), impl_{} {}
+
+   void
+   operator()(
+      resp3::node<boost::string_view> const& nd,
+      boost::system::error_code& ec)
+   {
+      if (nd.data_type == resp3::type::null)
+         return;
+
+      if (!result_->has_value()) {
+        *result_ = T{};
+        impl_.on_value_available(result_->value());
+      }
+
+      impl_(result_->value(), nd, ec);
+   }
+};
+
+} // detail
+} // adapter
+} // aedis
+
+#endif // AEDIS_ADAPTER_ADAPTERS_HPP

include/aedis/adapter/detail/response_traits.hpp

@@ -0,0 +1,161 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#ifndef AEDIS_ADAPTER_RESPONSE_TRAITS_HPP
+#define AEDIS_ADAPTER_RESPONSE_TRAITS_HPP
+
+#include <vector>
+#include <tuple>
+
+#include <boost/mp11.hpp>
+#include <boost/variant2.hpp>
+
+#include <aedis/error.hpp>
+#include <aedis/resp3/type.hpp>
+#include <aedis/resp3/read.hpp>
+#include <aedis/adapter/detail/adapters.hpp>
+
+namespace aedis {
+namespace adapter {
+namespace detail {
+
+struct ignore {};
+
+/* Traits class for response objects.
+ *
+ * Provides traits for all supported response types i.e. all STL
+ * containers and C++ buil-in types.
+ */
+template <class ResponseType>
+struct response_traits {
+   using adapter_type = adapter::detail::wrapper<ResponseType>;
+   static auto adapt(ResponseType& r) noexcept { return adapter_type{&r}; }
+};
+
+template <class T>
+using adapter_t = typename response_traits<T>::adapter_type;
+
+template <>
+struct response_traits<ignore> {
+   using response_type = ignore;
+   using adapter_type = resp3::detail::ignore_response;
+   static auto adapt(response_type&) noexcept { return adapter_type{}; }
+};
+
+template <class T>
+struct response_traits<resp3::node<T>> {
+   using response_type = resp3::node<T>;
+   using adapter_type = adapter::detail::general_simple<response_type>;
+   static auto adapt(response_type& v) noexcept { return adapter_type{&v}; }
+};
+
+template <class String, class Allocator>
+struct response_traits<std::vector<resp3::node<String>, Allocator>> {
+   using response_type = std::vector<resp3::node<String>, Allocator>;
+   using adapter_type = adapter::detail::general_aggregate<response_type>;
+   static auto adapt(response_type& v) noexcept { return adapter_type{&v}; }
+};
+
+template <>
+struct response_traits<void> {
+   using response_type = void;
+   using adapter_type = resp3::detail::ignore_response;
+   static auto adapt() noexcept { return adapter_type{}; }
+};
+
+// Duplicated here to avoid circular include dependency.
+template<class T>
+auto internal_adapt(T& t) noexcept
+   { return response_traits<T>::adapt(t); }
+
+template <std::size_t N>
+struct assigner {
+  template <class T1, class T2>
+  static void assign(T1& dest, T2& from)
+  {
+     dest[N] = internal_adapt(std::get<N>(from));
+     assigner<N - 1>::assign(dest, from);
+  }
+};
+
+template <>
+struct assigner<0> {
+  template <class T1, class T2>
+  static void assign(T1& dest, T2& from)
+  {
+     dest[0] = internal_adapt(std::get<0>(from));
+  }
+};
+
+template <class Tuple>
+class static_aggregate_adapter {
+private:
+   using adapters_array_type = 
+      std::array<
+         boost::mp11::mp_rename<
+            boost::mp11::mp_transform<
+               adapter_t, Tuple>,
+               boost::variant2::variant>,
+         std::tuple_size<Tuple>::value>;
+
+   std::size_t i_ = 0;
+   std::size_t aggregate_size_ = 0;
+   adapters_array_type adapters_;
+
+public:
+   static_aggregate_adapter(Tuple* r = nullptr)
+   {
+      detail::assigner<std::tuple_size<Tuple>::value - 1>::assign(adapters_, *r);
+   }
+
+   void count(resp3::node<boost::string_view> const& nd)
+   {
+      if (nd.depth == 1) {
+         if (is_aggregate(nd.data_type))
+            aggregate_size_ = element_multiplicity(nd.data_type) * nd.aggregate_size;
+         else
+            ++i_;
+
+         return;
+      }
+
+      if (--aggregate_size_ == 0)
+         ++i_;
+   }
+
+   void
+   operator()(
+      resp3::node<boost::string_view> const& nd,
+      boost::system::error_code& ec)
+   {
+      using boost::variant2::visit;
+
+      if (nd.depth == 0) {
+         auto const real_aggr_size = nd.aggregate_size * element_multiplicity(nd.data_type);
+         if (real_aggr_size != std::tuple_size<Tuple>::value)
+	    ec = error::incompatible_size;
+
+         return;
+      }
+
+      visit([&](auto& arg){arg(nd, ec);}, adapters_[i_]);
+      count(nd);
+   }
+};
+
+template <class... Ts>
+struct response_traits<std::tuple<Ts...>>
+{
+   using response_type = std::tuple<Ts...>;
+   using adapter_type = static_aggregate_adapter<response_type>;
+   static auto adapt(response_type& r) noexcept { return adapter_type{&r}; }
+};
+
+} // detail
+} // adapter
+} // aedis
+
+#endif // AEDIS_ADAPTER_RESPONSE_TRAITS_HPP

include/aedis/connection.hpp

@@ -0,0 +1,616 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#ifndef AEDIS_CONNECTION_HPP
+#define AEDIS_CONNECTION_HPP
+
+#include <vector>
+#include <queue>
+#include <limits>
+#include <chrono>
+#include <memory>
+#include <type_traits>
+
+#include <boost/assert.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <boost/asio/steady_timer.hpp>
+#include <boost/asio/bind_executor.hpp>
+#include <boost/asio/experimental/channel.hpp>
+
+#include <aedis/adapt.hpp>
+#include <aedis/resp3/request.hpp>
+#include <aedis/detail/connection_ops.hpp>
+
+namespace aedis {
+
+/** @brief A high level connection to Redis.
+ *  @ingroup any
+ *
+ *  This class keeps a healthy connection to the Redis instance where
+ *  commands can be sent at any time. For more details, please see the
+ *  documentation of each individual function.
+ *
+ *  @remarks This class exposes only asynchronous member functions,
+ *  synchronous communications with the Redis server is provided by
+ *  the sync class.
+ *
+ *  @tparam AsyncReadWriteStream A stream that supports
+ *  `async_read_some` and `async_write_some`.
+ *
+ */
+template <class AsyncReadWriteStream = boost::asio::ip::tcp::socket>
+class connection {
+public:
+   /// Executor type.
+   using executor_type = typename AsyncReadWriteStream::executor_type;
+
+   /// Type of the next layer
+   using next_layer_type = AsyncReadWriteStream;
+
+   /** @brief Connection configuration parameters.
+    */
+   struct config {
+      /// Redis server address.
+      std::string host = "127.0.0.1";
+
+      /// Redis server port.
+      std::string port = "6379";
+
+      /// Username if authentication is required.
+      std::string username;
+
+      /// Password if authentication is required.
+      std::string password;
+
+      /// Timeout of the resolve operation.
+      std::chrono::milliseconds resolve_timeout = std::chrono::seconds{10};
+
+      /// Timeout of the connect operation.
+      std::chrono::milliseconds connect_timeout = std::chrono::seconds{10};
+
+      /// Time interval of ping operations.
+      std::chrono::milliseconds ping_interval = std::chrono::seconds{1};
+
+      /// Time waited before trying a reconnection (see config::enable_reconnect).
+      std::chrono::milliseconds reconnect_interval = std::chrono::seconds{1};
+
+      /// The maximum size of read operations.
+      std::size_t max_read_size = (std::numeric_limits<std::size_t>::max)();
+
+      /// Whether to coalesce requests (see [pipelines](https://redis.io/topics/pipelining)).
+      bool coalesce_requests = true;
+
+      /// Enable internal events, see connection::async_receive_event.
+      bool enable_events = false;
+
+      /// Enable automatic reconnection (see also config::reconnect_interval).
+      bool enable_reconnect = false;
+   };
+
+   /// Events that are communicated by `connection::async_receive_event`.
+   enum class event {
+      /// Resolve operation was successful.
+      resolve,
+      /// Connect operation was successful.
+      connect,
+      /// Success sending AUTH and HELLO.
+      hello,
+      /// Used internally.
+      invalid
+   };
+
+   /** @brief Async operations exposed by this class.
+    *  
+    *  The operations listed below can be cancelled with the `cancel`
+    *  member function.
+    */
+   enum class operation {
+      /// `connection::async_exec` operations.
+      exec,
+      /// `connection::async_run` operations.
+      run,
+      /// `connection::async_receive_event` operations.
+      receive_event,
+      /// `connection::async_receive_push` operations.
+      receive_push,
+   };
+
+   /** \brief Contructor
+    *
+    *  \param ex The executor.
+    *  \param cfg Configuration parameters.
+    */
+   connection(executor_type ex, config cfg = config{})
+   : resv_{ex}
+   , ping_timer_{ex}
+   , check_idle_timer_{ex}
+   , writer_timer_{ex}
+   , read_timer_{ex}
+   , push_channel_{ex}
+   , event_channel_{ex}
+   , cfg_{cfg}
+   , last_data_{std::chrono::time_point<std::chrono::steady_clock>::min()}
+   {
+      writer_timer_.expires_at(std::chrono::steady_clock::time_point::max());
+      read_timer_.expires_at(std::chrono::steady_clock::time_point::max());
+   }
+
+   /** \brief Constructor
+    *
+    *  \param ioc The executor.
+    *  \param cfg Configuration parameters.
+    */
+   connection(boost::asio::io_context& ioc, config cfg = config{})
+   : connection(ioc.get_executor(), cfg)
+   { }
+
+   /// Returns the executor.
+   auto get_executor() {return resv_.get_executor();}
+
+   /** @brief Cancel operations.
+    *
+    * @li `operation::exec`: Cancels operations started with `async_exec`.
+    *
+    * @li operation::run: Cancels `async_run`. Notice that the
+    *     preferred way to close a connection is to ensure
+    *     `config::enable_reconnect` is set to `false` and send `QUIT`
+    *     to the server. An unresponsive Redis server will also cause
+    *     the idle-checks to kick in and lead to
+    *     `connection::async_run` completing with
+    *     `error::idle_timeout`. Calling `cancel(operation::run)`
+    *     directly should be seen as the last option.
+    *
+    * @li operation::receive_event: Cancels `connection::async_receive_event`.
+    *
+    * @param op: The operation to be cancelled.
+    * @returns The number of operations that have been canceled.
+    */
+   std::size_t cancel(operation op)
+   {
+      switch (op) {
+         case operation::exec:
+         {
+            for (auto& e: reqs_) {
+               e->stop = true;
+               e->timer.cancel_one();
+            }
+
+            auto const ret = reqs_.size();
+            reqs_ = {};
+            return ret;
+         }
+         case operation::run:
+         {
+            if (socket_)
+               socket_->close();
+
+            read_timer_.cancel();
+            check_idle_timer_.cancel();
+            writer_timer_.cancel();
+            ping_timer_.cancel();
+
+            auto point = std::stable_partition(std::begin(reqs_), std::end(reqs_), [](auto const& ptr) {
+               return !ptr->req->close_on_run_completion;
+            });
+
+            // Cancel own pings if there are any waiting.
+            std::for_each(point, std::end(reqs_), [](auto const& ptr) {
+               ptr->stop = true;
+               ptr->timer.cancel();
+            });
+
+            reqs_.erase(point, std::end(reqs_));
+            return 1U;
+         }
+         case operation::receive_event:
+         {
+            event_channel_.cancel();
+            return 1U;
+         }
+         case operation::receive_push:
+         {
+            push_channel_.cancel();
+            return 1U;
+         }
+      }
+
+      return 0;
+   }
+
+   /// Get the config object.
+   config& get_config() noexcept { return cfg_;}
+
+   /// Gets the config object.
+   config const& get_config() const noexcept { return cfg_;}
+
+   /** @name Asynchronous functions
+    *  
+    *  Each of these operations a individually cancellable.
+    **/
+
+   /// @{
+   /** @brief Starts communication with the Redis server asynchronously.
+    *
+    *  This function performs the following steps
+    *
+    *  @li Resolves the Redis host as of `async_resolve` with the
+    *  timeout passed in `config::resolve_timeout`.
+    *
+    *  @li Connects to one of the endpoints returned by the resolve
+    *  operation with the timeout passed in `config::connect_timeout`.
+    *
+    *  @li Starts healthy checks with a timeout twice
+    *  the value of `config::ping_interval`. If no data is
+    *  received during that time interval `connection::async_run` completes with
+    *  `error::idle_timeout`.
+    *
+    *  @li Starts the healthy check operation that sends `PING`s to
+    *  Redis with a frequency equal to `config::ping_interval`.
+    *
+    *  @li Starts reading from the socket and executes all requests
+    *  that have been started prior to this function call.
+    *
+    *  @remark When a timeout occur and config::enable_reconnect is
+    *  set, this function will automatically try a reconnection
+    *  without returning control to the user.
+    *  
+    *  For an example see echo_server.cpp.
+    *
+    *  \param token Completion token.
+    *
+    *  The completion token must have the following signature
+    *
+    *  @code
+    *  void f(boost::system::error_code);
+    *  @endcode
+    */
+   template <class CompletionToken = boost::asio::default_completion_token_t<executor_type>>
+   auto async_run(CompletionToken token = CompletionToken{})
+   {
+      return boost::asio::async_compose
+         < CompletionToken
+         , void(boost::system::error_code)
+         >(detail::run_op<connection>{this}, token, resv_);
+   }
+
+   /** @brief Connects and executes a request asynchronously.
+    *
+    *  Combines the other `async_run` overload with `async_exec` in a
+    *  single function. This function is useful for users that want to
+    *  send a single request to the server and close it.
+    *
+    *  \param req Request object.
+    *  \param adapter Response adapter.
+    *  \param token Asio completion token.
+    *
+    *  For an example see intro.cpp. The completion token must have
+    *  the following signature
+    *
+    *  @code
+    *  void f(boost::system::error_code, std::size_t);
+    *  @endcode
+    *
+    *  Where the second parameter is the size of the response in bytes.
+    */
+   template <
+      class Adapter = detail::response_traits<void>::adapter_type,
+      class CompletionToken = boost::asio::default_completion_token_t<executor_type>>
+   auto async_run(
+      resp3::request const& req,
+      Adapter adapter = adapt(),
+      CompletionToken token = CompletionToken{})
+   {
+      return boost::asio::async_compose
+         < CompletionToken
+         , void(boost::system::error_code, std::size_t)
+         >(detail::runexec_op<connection, Adapter>
+            {this, &req, adapter}, token, resv_);
+   }
+
+   /** @brief Executes a command on the redis server asynchronously.
+    *
+    *  There is no need to synchronize multiple calls to this
+    *  function as it keeps an internal queue.
+    *
+    *  \param req Request object.
+    *  \param adapter Response adapter.
+    *  \param token Asio completion token.
+    *
+    *  For an example see echo_server.cpp. The completion token must
+    *  have the following signature
+    *
+    *  @code
+    *  void f(boost::system::error_code, std::size_t);
+    *  @endcode
+    *
+    *  Where the second parameter is the size of the response in
+    *  bytes.
+    */
+   template <
+      class Adapter = detail::response_traits<void>::adapter_type,
+      class CompletionToken = boost::asio::default_completion_token_t<executor_type>>
+   auto async_exec(
+      resp3::request const& req,
+      Adapter adapter = adapt(),
+      CompletionToken token = CompletionToken{})
+   {
+      BOOST_ASSERT_MSG(req.size() <= adapter.supported_response_size(), "Request and adapter have incompatible sizes.");
+
+      return boost::asio::async_compose
+         < CompletionToken
+         , void(boost::system::error_code, std::size_t)
+         >(detail::exec_op<connection, Adapter>{this, &req, adapter}, token, resv_);
+   }
+
+   /** @brief Receives server side pushes asynchronously.
+    *
+    *  Users that expect server pushes have to call this function in a
+    *  loop. If an unsolicited event comes in and there is no reader,
+    *  the connection will hang and eventually timeout.
+    *
+    *  \param adapter The response adapter.
+    *  \param token The Asio completion token.
+    *
+    *  For an example see subscriber.cpp. The completion token must
+    *  have the following signature
+    *
+    *  @code
+    *  void f(boost::system::error_code, std::size_t);
+    *  @endcode
+    *
+    *  Where the second parameter is the size of the push in
+    *  bytes.
+    */
+   template <
+      class Adapter = detail::response_traits<void>::adapter_type,
+      class CompletionToken = boost::asio::default_completion_token_t<executor_type>>
+   auto async_receive_push(
+      Adapter adapter = adapt(),
+      CompletionToken token = CompletionToken{})
+   {
+      auto f =
+         [adapter]
+         (resp3::node<boost::string_view> const& node, boost::system::error_code& ec) mutable
+      {
+         adapter(std::size_t(-1), node, ec);
+      };
+
+      return boost::asio::async_compose
+         < CompletionToken
+         , void(boost::system::error_code, std::size_t)
+         >(detail::receive_push_op<connection, decltype(f)>{this, f}, token, resv_);
+   }
+
+   /** @brief Receives internal events.
+    *
+    *  See enum \c events for the list of events.
+    *
+    *  \param token The Asio completion token.
+    *
+    *  The completion token must have the following signature
+    *
+    *  @code
+    *  void f(boost::system::error_code, event);
+    *  @endcode
+    */
+   template <class CompletionToken = boost::asio::default_completion_token_t<executor_type>>
+   auto async_receive_event(CompletionToken token = CompletionToken{})
+   {
+      return event_channel_.async_receive(token);
+   }
+   /// @}
+
+private:
+   using clock_type = std::chrono::steady_clock;
+   using clock_traits_type = boost::asio::wait_traits<clock_type>;
+   using timer_type = boost::asio::basic_waitable_timer<clock_type, clock_traits_type, executor_type>;
+   using resolver_type = boost::asio::ip::basic_resolver<boost::asio::ip::tcp, executor_type>;
+   using push_channel_type = boost::asio::experimental::channel<executor_type, void(boost::system::error_code, std::size_t)>;
+   using time_point_type = std::chrono::time_point<std::chrono::steady_clock>;
+   using event_channel_type = boost::asio::experimental::channel<executor_type, void(boost::system::error_code, event)>;
+
+   struct req_info {
+      req_info(executor_type ex) : timer{ex} {}
+      timer_type timer;
+      resp3::request const* req = nullptr;
+      std::size_t cmds = 0;
+      bool stop = false;
+      bool written = false;
+   };
+
+   using reqs_type = std::deque<std::shared_ptr<req_info>>;
+
+   template <class T, class U> friend struct detail::receive_push_op;
+   template <class T> friend struct detail::reader_op;
+   template <class T> friend struct detail::writer_op;
+   template <class T> friend struct detail::ping_op;
+   template <class T> friend struct detail::run_op;
+   template <class T> friend struct detail::run_one_op;
+   template <class T, class U> friend struct detail::exec_op;
+   template <class T, class U> friend struct detail::exec_read_op;
+   template <class T, class U> friend struct detail::runexec_op;
+   template <class T> friend struct detail::connect_with_timeout_op;
+   template <class T> friend struct detail::resolve_with_timeout_op;
+   template <class T> friend struct detail::check_idle_op;
+   template <class T> friend struct detail::start_op;
+   template <class T> friend struct detail::send_receive_op;
+
+   template <class CompletionToken>
+   auto async_run_one(CompletionToken token = CompletionToken{})
+   {
+      return boost::asio::async_compose
+         < CompletionToken
+         , void(boost::system::error_code)
+         >(detail::run_one_op<connection>{this}, token, resv_);
+   }
+
+   void cancel_push_requests()
+   {
+      auto point = std::stable_partition(std::begin(reqs_), std::end(reqs_), [](auto const& ptr) {
+         return !(ptr->written && ptr->req->size() == 0);
+      });
+
+      std::for_each(point, std::end(reqs_), [](auto const& ptr) {
+         ptr->timer.cancel();
+      });
+
+      reqs_.erase(point, std::end(reqs_));
+   }
+
+   void add_request_info(std::shared_ptr<req_info> const& info)
+   {
+      reqs_.push_back(info);
+      if (socket_ != nullptr && socket_->is_open() && cmds_ == 0 && write_buffer_.empty())
+         writer_timer_.cancel();
+   }
+
+   auto make_dynamic_buffer()
+      { return boost::asio::dynamic_buffer(read_buffer_, cfg_.max_read_size); }
+
+   template <class CompletionToken>
+   auto async_resolve_with_timeout(CompletionToken&& token)
+   {
+      return boost::asio::async_compose
+         < CompletionToken
+         , void(boost::system::error_code)
+         >(detail::resolve_with_timeout_op<connection>{this},
+            token, resv_);
+   }
+
+   template <class CompletionToken>
+   auto async_connect_with_timeout(CompletionToken&& token)
+   {
+      return boost::asio::async_compose
+         < CompletionToken
+         , void(boost::system::error_code)
+         >(detail::connect_with_timeout_op<connection>{this}, token, resv_);
+   }
+
+   template <class CompletionToken>
+   auto reader(CompletionToken&& token)
+   {
+      return boost::asio::async_compose
+         < CompletionToken
+         , void(boost::system::error_code)
+         >(detail::reader_op<connection>{this}, token, resv_.get_executor());
+   }
+
+   template <class CompletionToken>
+   auto writer(CompletionToken&& token)
+   {
+      return boost::asio::async_compose
+         < CompletionToken
+         , void(boost::system::error_code)
+         >(detail::writer_op<connection>{this}, token, resv_.get_executor());
+   }
+
+   template <class CompletionToken>
+   auto
+   async_start(CompletionToken&& token)
+   {
+      return boost::asio::async_compose
+         < CompletionToken
+         , void(boost::system::error_code)
+         >(detail::start_op<connection>{this}, token, resv_);
+   }
+
+   template <class CompletionToken>
+   auto async_ping(CompletionToken&& token)
+   {
+      return boost::asio::async_compose
+         < CompletionToken
+         , void(boost::system::error_code)
+         >(detail::ping_op<connection>{this}, token, resv_);
+   }
+
+   template <class CompletionToken>
+   auto async_check_idle(CompletionToken&& token)
+   {
+      return boost::asio::async_compose
+         < CompletionToken
+         , void(boost::system::error_code)
+         >(detail::check_idle_op<connection>{this}, token, check_idle_timer_);
+   }
+
+   template <class Adapter, class CompletionToken>
+   auto async_exec_read(Adapter adapter, std::size_t cmds, CompletionToken token)
+   {
+      return boost::asio::async_compose
+         < CompletionToken
+         , void(boost::system::error_code, std::size_t)
+         >(detail::exec_read_op<connection, Adapter>{this, adapter, cmds}, token, resv_);
+   }
+
+   void coalesce_requests()
+   {
+      // Coaleces all requests: Copies the request to the variables
+      // that won't be touched while async_write is suspended.
+      BOOST_ASSERT(write_buffer_.empty());
+      BOOST_ASSERT(!reqs_.empty());
+
+      auto const size = cfg_.coalesce_requests ? reqs_.size() : 1;
+      for (auto i = 0UL; i < size; ++i) {
+         write_buffer_ += reqs_.at(i)->req->payload();
+         cmds_ += reqs_.at(i)->req->size();
+         reqs_.at(i)->written = true;
+      }
+   }
+
+   // IO objects
+   resolver_type resv_;
+   std::shared_ptr<AsyncReadWriteStream> socket_;
+   timer_type ping_timer_;
+   timer_type check_idle_timer_;
+   timer_type writer_timer_;
+   timer_type read_timer_;
+   push_channel_type push_channel_;
+   event_channel_type event_channel_;
+
+   config cfg_;
+   std::string read_buffer_;
+   std::string write_buffer_;
+   std::size_t cmds_ = 0;
+   reqs_type reqs_;
+
+   // Last time we received data.
+   time_point_type last_data_;
+
+   // The result of async_resolve.
+   boost::asio::ip::tcp::resolver::results_type endpoints_;
+
+   resp3::request req_;
+};
+
+/** @brief Converts a connection event to a string.
+ *  @relates connection
+ */
+template <class T>
+char const* to_string(typename connection<T>::event e)
+{
+   using event_type = typename connection<T>::event;
+   switch (e) {
+      case event_type::resolve: return "resolve";
+      case event_type::connect: return "connect";
+      case event_type::hello: return "hello";
+      case event_type::push: return "push";
+      case event_type::invalid: return "invalid";
+      default: BOOST_ASSERT_MSG(false, "to_string: unhandled event.");
+   }
+}
+
+/** @brief Writes a connection event to the stream.
+ *  @relates connection
+ */
+template <class T>
+std::ostream& operator<<(std::ostream& os, typename connection<T>::event e)
+{
+   os << to_string(e);
+   return os;
+}
+
+} // aedis
+
+#endif // AEDIS_CONNECTION_HPP

include/aedis/detail/connection_ops.hpp

@@ -0,0 +1,664 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#ifndef AEDIS_CONNECTION_OPS_HPP
+#define AEDIS_CONNECTION_OPS_HPP
+
+#include <array>
+#include <algorithm>
+
+#include <boost/assert.hpp>
+#include <boost/system.hpp>
+#include <boost/asio/write.hpp>
+#include <boost/core/ignore_unused.hpp>
+#include <boost/asio/experimental/parallel_group.hpp>
+
+#include <aedis/adapt.hpp>
+#include <aedis/error.hpp>
+#include <aedis/detail/net.hpp>
+#include <aedis/resp3/type.hpp>
+#include <aedis/resp3/detail/exec.hpp>
+#include <aedis/resp3/detail/parser.hpp>
+#include <aedis/resp3/read.hpp>
+#include <aedis/resp3/write.hpp>
+#include <aedis/resp3/request.hpp>
+
+#define HANDLER_LOCATION \
+  BOOST_ASIO_HANDLER_LOCATION((__FILE__, __LINE__, __func__))
+
+namespace aedis {
+namespace detail {
+
+#include <boost/asio/yield.hpp>
+
+template <class Conn>
+struct connect_with_timeout_op {
+   Conn* conn;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void operator()( Self& self
+                  , boost::system::error_code ec = {}
+                  , boost::asio::ip::tcp::endpoint const& = {})
+   {
+      reenter (coro)
+      {
+         BOOST_ASSERT(conn->socket_ != nullptr);
+         conn->ping_timer_.expires_after(conn->cfg_.connect_timeout);
+         yield
+         aedis::detail::async_connect(*conn->socket_, conn->ping_timer_, conn->endpoints_, std::move(self));
+         self.complete(ec);
+      }
+   }
+};
+
+template <class Conn>
+struct resolve_with_timeout_op {
+   Conn* conn;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void operator()( Self& self
+                  , boost::system::error_code ec = {}
+                  , boost::asio::ip::tcp::resolver::results_type res = {})
+   {
+      reenter (coro)
+      {
+         conn->ping_timer_.expires_after(conn->cfg_.resolve_timeout);
+         yield
+         aedis::detail::async_resolve(
+            conn->resv_, conn->ping_timer_,
+            conn->cfg_.host, conn->cfg_.port, std::move(self));
+         conn->endpoints_ = res;
+         self.complete(ec);
+      }
+   }
+};
+
+template <class Conn, class Adapter>
+struct receive_push_op {
+   Conn* conn = nullptr;
+   Adapter adapter;
+   std::size_t read_size = 0;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void
+   operator()( Self& self
+             , boost::system::error_code ec = {}
+             , std::size_t n = 0)
+   {
+      reenter (coro)
+      {
+         yield
+         conn->push_channel_.async_receive(std::move(self));
+         if (ec) {
+            self.complete(ec, 0);
+            return;
+         }
+
+         BOOST_ASSERT(conn->socket_ != nullptr);
+         yield
+         resp3::async_read(*conn->socket_, conn->make_dynamic_buffer(), adapter, std::move(self));
+         if (ec) {
+            conn->cancel(Conn::operation::run);
+            self.complete(ec, 0);
+            return;
+         }
+
+         read_size = n;
+
+         yield
+         conn->push_channel_.async_send({}, 0, std::move(self));
+         self.complete(ec, read_size);
+         return;
+      }
+   }
+};
+
+template <class Conn, class Adapter>
+struct exec_read_op {
+   Conn* conn;
+   Adapter adapter;
+   std::size_t cmds = 0;
+   std::size_t read_size = 0;
+   std::size_t index = 0;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void
+   operator()( Self& self
+             , boost::system::error_code ec = {}
+             , std::size_t n = 0)
+   {
+      reenter (coro)
+      {
+         // Loop reading the responses to this request.
+         BOOST_ASSERT(!conn->reqs_.empty());
+         while (cmds != 0) {
+            BOOST_ASSERT(conn->cmds_ != 0);
+
+            //-----------------------------------
+            // If we detect a push in the middle of a request we have
+            // to hand it to the push consumer. To do that we need
+            // some data in the read bufer.
+            if (conn->read_buffer_.empty()) {
+               BOOST_ASSERT(conn->socket_ != nullptr);
+               yield
+               boost::asio::async_read_until(*conn->socket_, conn->make_dynamic_buffer(), "\r\n", std::move(self));
+               if (ec) {
+                  conn->cancel(Conn::operation::run);
+                  self.complete(ec, 0);
+                  return;
+               }
+            }
+
+            // If the next request is a push we have to handle it to
+            // the receive_push_op wait for it to be done and continue.
+            if (resp3::to_type(conn->read_buffer_.front()) == resp3::type::push) {
+               yield
+               async_send_receive(conn->push_channel_, std::move(self));
+               if (ec) {
+                  // Notice we don't call cancel_run() as that is the
+                  // responsability of the receive_push_op.
+                  self.complete(ec, 0);
+                  return;
+               }
+
+               continue;
+            }
+            //-----------------------------------
+
+            yield
+            resp3::async_read(*conn->socket_, conn->make_dynamic_buffer(),
+               [i = index, adpt = adapter] (resp3::node<boost::string_view> const& nd, boost::system::error_code& ec) mutable { adpt(i, nd, ec); },
+               std::move(self));
+
+            ++index;
+
+            if (ec) {
+               conn->cancel(Conn::operation::run);
+               self.complete(ec, 0);
+               return;
+            }
+
+            read_size += n;
+
+            BOOST_ASSERT(cmds != 0);
+            --cmds;
+
+            BOOST_ASSERT(conn->cmds_ != 0);
+            --conn->cmds_;
+         }
+
+         self.complete({}, read_size);
+      }
+   }
+};
+
+template <class Conn, class Adapter>
+struct exec_op {
+   using req_info_type = typename Conn::req_info;
+
+   Conn* conn = nullptr;
+   resp3::request const* req = nullptr;
+   Adapter adapter{};
+   std::shared_ptr<req_info_type> info = nullptr;
+   std::size_t read_size = 0;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void
+   operator()( Self& self
+             , boost::system::error_code ec = {}
+             , std::size_t n = 0)
+   {
+      reenter (coro)
+      {
+         info = std::allocate_shared<req_info_type>(boost::asio::get_associated_allocator(self), conn->resv_.get_executor());
+         info->timer.expires_at(std::chrono::steady_clock::time_point::max());
+         info->req = req;
+         info->cmds = req->size();
+         info->stop = false;
+
+         conn->add_request_info(info);
+         yield
+         info->timer.async_wait(std::move(self));
+         BOOST_ASSERT(conn->socket_ != nullptr);
+         BOOST_ASSERT(!!ec);
+         if (info->stop) {
+            self.complete(ec, 0);
+            return;
+         }
+
+         BOOST_ASSERT(conn->socket_->is_open());
+          
+         if (req->size() == 0) {
+            self.complete({}, 0);
+            return;
+         }
+
+         BOOST_ASSERT(!conn->reqs_.empty());
+         BOOST_ASSERT(conn->reqs_.front() != nullptr);
+         BOOST_ASSERT(conn->cmds_ != 0);
+         yield
+         conn->async_exec_read(adapter, conn->reqs_.front()->cmds, std::move(self));
+         if (ec) {
+            self.complete(ec, 0);
+            return;
+         }
+
+         read_size = n;
+
+         BOOST_ASSERT(!conn->reqs_.empty());
+         conn->reqs_.pop_front();
+
+         if (conn->cmds_ == 0) {
+            conn->read_timer_.cancel_one();
+            if (!conn->reqs_.empty())
+               conn->writer_timer_.cancel_one();
+         } else {
+            BOOST_ASSERT(!conn->reqs_.empty());
+            conn->reqs_.front()->timer.cancel_one();
+         }
+
+         self.complete({}, read_size);
+      }
+   }
+};
+
+template <class Conn>
+struct ping_op {
+   Conn* conn;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void
+   operator()( Self& self
+             , boost::system::error_code ec = {}
+             , std::size_t = 0)
+   {
+      reenter (coro) for (;;)
+      {
+         conn->ping_timer_.expires_after(conn->cfg_.ping_interval);
+         yield
+         conn->ping_timer_.async_wait(std::move(self));
+         BOOST_ASSERT(conn->socket_ != nullptr);
+         if (ec || !conn->socket_->is_open()) {
+            self.complete(ec);
+            return;
+         }
+
+         conn->req_.clear();
+         conn->req_.push("PING");
+         conn->req_.close_on_run_completion = true;
+         yield
+         conn->async_exec(conn->req_, adapt(), std::move(self));
+         if (ec) {
+            // Notice we don't report error but let the idle check
+            // timeout. It is enough to finish the op.
+            self.complete({});
+            return;
+         }
+      }
+   }
+};
+
+template <class Conn>
+struct check_idle_op {
+   Conn* conn;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void operator()(Self& self, boost::system::error_code ec = {})
+   {
+      reenter (coro) for (;;)
+      {
+         conn->check_idle_timer_.expires_after(2 * conn->cfg_.ping_interval);
+         yield
+         conn->check_idle_timer_.async_wait(std::move(self));
+         BOOST_ASSERT(conn->socket_ != nullptr);
+         if (ec || !conn->socket_->is_open()) {
+            // Notice this is not an error, it was requested from an
+            // external op.
+            self.complete({});
+            return;
+         }
+
+         auto const now = std::chrono::steady_clock::now();
+         if (conn->last_data_ +  (2 * conn->cfg_.ping_interval) < now) {
+            conn->cancel(Conn::operation::run);
+            self.complete(error::idle_timeout);
+            return;
+         }
+
+         conn->last_data_ = now;
+      }
+   }
+};
+
+template <class Conn>
+struct start_op {
+   Conn* conn;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void operator()( Self& self
+                  , std::array<std::size_t, 4> order = {}
+                  , boost::system::error_code ec0 = {}
+                  , boost::system::error_code ec1 = {}
+                  , boost::system::error_code ec2 = {}
+                  , boost::system::error_code ec3 = {})
+   {
+      reenter (coro)
+      {
+         yield
+         boost::asio::experimental::make_parallel_group(
+            [this](auto token) { return conn->reader(token);},
+            [this](auto token) { return conn->writer(token);},
+            [this](auto token) { return conn->async_check_idle(token);},
+            [this](auto token) { return conn->async_ping(token);}
+         ).async_wait(
+            boost::asio::experimental::wait_for_one_error(),
+            std::move(self));
+
+         switch (order[0]) {
+           case 0: self.complete(ec0); break;
+           case 1: self.complete(ec1); break;
+           case 2: self.complete(ec2); break;
+           case 3: self.complete(ec3); break;
+           default: BOOST_ASSERT(false);
+         }
+      }
+   }
+};
+
+template <class Conn>
+struct run_one_op {
+   Conn* conn;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void operator()(
+      Self& self,
+      boost::system::error_code ec = {},
+      std::size_t = 0)
+   {
+      reenter (coro)
+      {
+         yield
+         conn->async_resolve_with_timeout(std::move(self));
+         if (ec) {
+            conn->cancel(Conn::operation::run);
+            self.complete(ec);
+            return;
+         }
+
+         if (conn->cfg_.enable_events) {
+            yield
+            conn->event_channel_.async_send({}, Conn::event::resolve, std::move(self));
+            if (ec) {
+               self.complete(ec);
+               return;
+            }
+         }
+
+         conn->socket_ = std::make_shared<typename Conn::next_layer_type>(conn->resv_.get_executor());
+
+         yield
+         conn->async_connect_with_timeout(std::move(self));
+         if (ec) {
+            conn->cancel(Conn::operation::run);
+            self.complete(ec);
+            return;
+         }
+
+         if (conn->cfg_.enable_events) {
+            yield
+            conn->event_channel_.async_send({}, Conn::event::connect, std::move(self));
+            if (ec) {
+               self.complete(ec);
+               return;
+            }
+         }
+
+         conn->req_.clear();
+         if (!std::empty(conn->cfg_.username) && !std::empty(conn->cfg_.password))
+            conn->req_.push("AUTH", conn->cfg_.username, conn->cfg_.password);
+         conn->req_.push("HELLO", "3");
+
+         conn->ping_timer_.expires_after(conn->cfg_.ping_interval);
+
+         yield
+         async_exec(
+            *conn->socket_,
+            conn->ping_timer_,
+            conn->req_,
+            adapter::adapt2(),
+            conn->make_dynamic_buffer(),
+            std::move(self)
+         );
+
+         if (ec) {
+            conn->cancel(Conn::operation::run);
+            self.complete(ec);
+            return;
+         }
+
+         if (conn->cfg_.enable_events) {
+            yield
+            conn->event_channel_.async_send({}, Conn::event::hello, std::move(self));
+            if (ec) {
+               self.complete(ec);
+               return;
+            }
+         }
+
+         conn->write_buffer_.clear();
+         conn->cmds_ = 0;
+         std::for_each(std::begin(conn->reqs_), std::end(conn->reqs_), [](auto const& ptr) {
+            return ptr->written = false;
+         });
+
+         yield
+         conn->async_start(std::move(self));
+         self.complete(ec);
+      }
+   }
+};
+
+template <class Conn>
+struct run_op {
+   Conn* conn;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void operator()(
+      Self& self,
+      boost::system::error_code ec = {},
+      std::size_t = 0)
+   {
+      reenter (coro) for(;;)
+      {
+         yield
+         conn->async_run_one(std::move(self));
+
+         if (!conn->cfg_.enable_reconnect) {
+            self.complete(ec);
+            return;
+         }
+
+         // Consider communicating the return of async_run_one as an
+         // event here.
+
+         conn->ping_timer_.expires_after(conn->cfg_.reconnect_interval);
+         yield
+         conn->ping_timer_.async_wait(std::move(self)); 
+      }
+   }
+};
+
+
+template <class Conn>
+struct writer_op {
+   Conn* conn;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void operator()( Self& self
+                  , boost::system::error_code ec = {}
+                  , std::size_t n = 0)
+   {
+      boost::ignore_unused(n);
+
+      reenter (coro) for (;;)
+      {
+         while (!conn->reqs_.empty() && conn->cmds_ == 0 && conn->write_buffer_.empty()) {
+            conn->coalesce_requests();
+            yield
+            boost::asio::async_write(*conn->socket_, boost::asio::buffer(conn->write_buffer_), std::move(self));
+            if (ec) {
+               self.complete(ec);
+               return;
+            }
+
+            // We have to clear the payload right after the read op in
+            // order to to use it as a flag that informs there is no
+            // ongoing write.
+            conn->write_buffer_.clear();
+            conn->cancel_push_requests();
+         }
+
+         if (conn->socket_->is_open()) {
+            yield
+            conn->writer_timer_.async_wait(std::move(self));
+            // The timer may be canceled either to stop the write op
+            // or to proceed to the next write, the difference between
+            // the two is that for the former the socket will be
+            // closed first. We check for that below.
+         }
+
+         if (!conn->socket_->is_open()) {
+            // Notice this is not an error of the op, stoping was
+            // requested from the outside, so we complete with
+            // success.
+            self.complete({});
+            return;
+         }
+      }
+   }
+};
+
+template <class Conn>
+struct reader_op {
+   Conn* conn;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void operator()( Self& self
+                  , boost::system::error_code ec = {}
+                  , std::size_t n = 0)
+   {
+      boost::ignore_unused(n);
+
+      reenter (coro) for (;;)
+      {
+         BOOST_ASSERT(conn->socket_->is_open());
+         yield
+         boost::asio::async_read_until(*conn->socket_, conn->make_dynamic_buffer(), "\r\n", std::move(self));
+         if (ec) {
+            conn->cancel(Conn::operation::run);
+            self.complete(ec);
+            return;
+         }
+
+         conn->last_data_ = std::chrono::steady_clock::now();
+
+         // We handle unsolicited events in the following way
+         //
+         // 1. Its resp3 type is a push.
+         //
+         // 2. A non-push type is received with an empty requests
+         //    queue. I have noticed this is possible (e.g. -MISCONF).
+         //    I expect them to have type push so we can distinguish
+         //    them from responses to commands, but it is a
+         //    simple-error. If we are lucky enough to receive them
+         //    when the command queue is empty we can treat them as
+         //    server pushes, otherwise it is impossible to handle
+         //    them properly
+         //
+         // 3. The request does not expect any response but we got
+         //    one. This may happen if for example, subscribe with
+         //    wrong syntax.
+         //
+         BOOST_ASSERT(!conn->read_buffer_.empty());
+         if (resp3::to_type(conn->read_buffer_.front()) == resp3::type::push
+             || conn->reqs_.empty()
+             || (!conn->reqs_.empty() && conn->reqs_.front()->cmds == 0)) {
+            yield
+            async_send_receive(conn->push_channel_, std::move(self));
+            if (ec) {
+               self.complete(ec);
+               return;
+            }
+         } else {
+            BOOST_ASSERT(conn->cmds_ != 0);
+            BOOST_ASSERT(!conn->reqs_.empty());
+            BOOST_ASSERT(conn->reqs_.front()->cmds != 0);
+            conn->reqs_.front()->timer.cancel_one();
+            yield
+            conn->read_timer_.async_wait(std::move(self));
+            if (!conn->socket_->is_open()) {
+               self.complete({});
+               return;
+            }
+         }
+
+      }
+   }
+};
+
+template <class Conn, class Adapter>
+struct runexec_op {
+   Conn* conn;
+   resp3::request const* req = nullptr;
+   Adapter adapter;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void operator()( Self& self
+                  , std::array<std::size_t, 2> order = {}
+                  , boost::system::error_code ec1 = {}
+                  , boost::system::error_code ec2 = {}
+                  , std::size_t n = 0)
+   {
+      reenter (coro)
+      {
+         req->close_on_run_completion = true;
+
+         yield
+         boost::asio::experimental::make_parallel_group(
+            [this](auto token) { return conn->async_run(token);},
+            [this](auto token) { return conn->async_exec(*req, adapter, token);}
+         ).async_wait(
+            boost::asio::experimental::wait_for_one_error(),
+            std::move(self));
+
+         switch (order[0]) {
+           case 0: self.complete(ec1, n); break;
+           case 1: self.complete(ec2, n); break;
+           default: BOOST_ASSERT(false);
+         }
+      }
+   }
+};
+
+#include <boost/asio/unyield.hpp>
+
+} // detail
+} // aedis
+
+#endif // AEDIS_CONNECTION_OPS_HPP

include/aedis/detail/net.hpp

@@ -0,0 +1,208 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#ifndef AEDIS_NET_HPP
+#define AEDIS_NET_HPP
+
+#include <array>
+
+#include <boost/system.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <boost/asio/connect.hpp>
+#include <boost/assert.hpp>
+#include <boost/asio/experimental/parallel_group.hpp>
+
+namespace aedis {
+namespace detail {
+
+template <class Executor>
+using conn_timer_t = boost::asio::basic_waitable_timer<std::chrono::steady_clock, boost::asio::wait_traits<std::chrono::steady_clock>, Executor>;
+
+#include <boost/asio/yield.hpp>
+
+template <
+   class Protocol,
+   class Executor,
+   class EndpointSequence
+   >
+struct connect_op {
+   boost::asio::basic_socket<Protocol, Executor>* socket;
+   conn_timer_t<Executor>* timer;
+   EndpointSequence* endpoints;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void operator()( Self& self
+                  , std::array<std::size_t, 2> order = {}
+                  , boost::system::error_code ec1 = {}
+                  , typename Protocol::endpoint const& ep = {}
+                  , boost::system::error_code ec2 = {})
+   {
+      reenter (coro)
+      {
+         yield
+         boost::asio::experimental::make_parallel_group(
+            [this](auto token)
+            {
+               auto f = [](boost::system::error_code const&, typename Protocol::endpoint const&) { return true; };
+               return boost::asio::async_connect(*socket, *endpoints, f, token);
+            },
+            [this](auto token) { return timer->async_wait(token);}
+         ).async_wait(
+            boost::asio::experimental::wait_for_one(),
+            std::move(self));
+
+         switch (order[0]) {
+            case 0: self.complete(ec1, ep); break;
+            case 1:
+            {
+               if (ec2)
+                  self.complete({}, ep);
+               else
+                  self.complete(error::connect_timeout, ep);
+
+            } break;
+
+            default: BOOST_ASSERT(false);
+         }
+      }
+   }
+};
+
+template <class Resolver, class Timer>
+struct resolve_op {
+   Resolver* resv;
+   Timer* timer;
+   boost::string_view host;
+   boost::string_view port;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void operator()( Self& self
+                  , std::array<std::size_t, 2> order = {}
+                  , boost::system::error_code ec1 = {}
+                  , boost::asio::ip::tcp::resolver::results_type res = {}
+                  , boost::system::error_code ec2 = {})
+   {
+      reenter (coro)
+      {
+         yield
+         boost::asio::experimental::make_parallel_group(
+            [this](auto token) { return resv->async_resolve(host.data(), port.data(), token);},
+            [this](auto token) { return timer->async_wait(token);}
+         ).async_wait(
+            boost::asio::experimental::wait_for_one(),
+            std::move(self));
+
+         switch (order[0]) {
+            case 0:
+            {
+               if (ec1) {
+                  self.complete(ec1, {});
+                  return;
+               }
+            } break;
+
+            case 1:
+            {
+               if (!ec2) {
+                  self.complete(error::resolve_timeout, {});
+                  return;
+               }
+            } break;
+
+            default: BOOST_ASSERT(false);
+         }
+
+         self.complete({}, res);
+      }
+   }
+};
+
+template <class Channel>
+struct send_receive_op {
+   Channel* channel;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void operator()( Self& self
+                  , boost::system::error_code ec = {}
+                  , std::size_t = 0)
+   {
+      reenter (coro)
+      {
+         yield
+         channel->async_send(boost::system::error_code{}, 0, std::move(self));
+         if (ec) {
+            self.complete(ec, 0);
+            return;
+         }
+
+         yield
+         channel->async_receive(std::move(self));
+         self.complete(ec, 0);
+      }
+   }
+};
+
+#include <boost/asio/unyield.hpp>
+
+template <
+   class Protocol,
+   class Executor,
+   class EndpointSequence,
+   class CompletionToken = boost::asio::default_completion_token_t<Executor>
+   >
+auto async_connect(
+      boost::asio::basic_socket<Protocol, Executor>& socket,
+      conn_timer_t<Executor>& timer,
+      EndpointSequence ep,
+      CompletionToken&& token = boost::asio::default_completion_token_t<Executor>{})
+{
+   return boost::asio::async_compose
+      < CompletionToken
+      , void(boost::system::error_code, typename Protocol::endpoint const&)
+      >(connect_op<Protocol, Executor, EndpointSequence>
+            {&socket, &timer, &ep}, token, socket, timer);
+}
+
+template <
+   class Resolver,
+   class Timer,
+   class CompletionToken =
+      boost::asio::default_completion_token_t<typename Resolver::executor_type>
+   >
+auto async_resolve(
+      Resolver& resv,
+      Timer& timer,
+      boost::string_view host,
+      boost::string_view port,
+      CompletionToken&& token = CompletionToken{})
+{
+   // TODO: Use static_assert to check Resolver::executor_type and
+   // Timer::executor_type are same.
+   return boost::asio::async_compose
+      < CompletionToken
+      , void(boost::system::error_code, boost::asio::ip::tcp::resolver::results_type)
+      >(resolve_op<Resolver, Timer>{&resv, &timer, host, port}, token, resv, timer);
+}
+
+template <
+   class Channel,
+   class CompletionToken =
+      boost::asio::default_completion_token_t<typename Channel::executor_type>
+   >
+auto async_send_receive(Channel& channel, CompletionToken&& token = CompletionToken{})
+{
+   return boost::asio::async_compose
+      < CompletionToken
+      , void(boost::system::error_code, std::size_t)
+      >(send_receive_op<Channel>{&channel}, token, channel);
+}
+} // detail
+} // aedis
+
+#endif // AEDIS_NET_HPP

include/aedis/error.hpp

@@ -0,0 +1,96 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#ifndef AEDIS_ERROR_HPP
+#define AEDIS_ERROR_HPP
+
+#include <boost/system/error_code.hpp>
+
+namespace aedis {
+
+/** \brief Generic errors.
+ *  \ingroup any
+ */
+enum class error
+{
+   /// Resolve timeout.
+   resolve_timeout = 1,
+
+   /// Connect timeout.
+   connect_timeout,
+
+   /// Idle timeout.
+   idle_timeout,
+
+   /// Exec timeout.
+   exec_timeout,
+
+   /// Invalid RESP3 type.
+   invalid_data_type,
+
+   /// Can't parse the string as a number.
+   not_a_number,
+
+   /// Received less bytes than expected.
+   unexpected_read_size,
+
+   /// The maximum depth of a nested response was exceeded.
+   exceeeds_max_nested_depth,
+
+   /// Got non boolean value.
+   unexpected_bool_value,
+
+   /// Expected field value is empty.
+   empty_field,
+
+   /// Expects a simple RESP3 type but got an aggregate.
+   expects_resp3_simple_type,
+
+   /// Expects aggregate.
+   expects_resp3_aggregate,
+
+   /// Expects a map but got other aggregate.
+   expects_resp3_map,
+
+   /// Expects a set aggregate but got something else.
+   expects_resp3_set,
+
+   /// Nested response not supported.
+   nested_aggregate_unsupported,
+
+   /// Got RESP3 simple error.
+   simple_error,
+
+   /// Got RESP3 blob_error.
+   blob_error,
+
+   /// Aggregate container has incompatible size.
+   incompatible_size,
+
+   /// Not a double
+   not_a_double,
+
+   /// Got RESP3 null.
+   null
+};
+
+/** \internal
+ *  \brief Creates a error_code object from an error.
+ *  \param e Error code.
+ *  \ingroup any
+ */
+boost::system::error_code make_error_code(error e);
+
+} // aedis
+
+namespace std {
+
+template<>
+struct is_error_code_enum<::aedis::error> : std::true_type {};
+
+} // std
+
+#endif // AEDIS_ERROR_HPP

include/aedis/impl/error.ipp

@@ -0,0 +1,62 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#include <aedis/error.hpp>
+
+namespace aedis {
+namespace detail {
+
+struct error_category_impl : boost::system::error_category {
+
+   char const* name() const noexcept override
+   {
+      return "aedis";
+   }
+
+   std::string message(int ev) const override
+   {
+      switch(static_cast<error>(ev)) {
+	 case error::resolve_timeout: return "Resolve operation timeout.";
+	 case error::connect_timeout: return "Connect operation timeout.";
+	 case error::idle_timeout: return "Idle timeout.";
+	 case error::exec_timeout: return "Exec timeout.";
+	 case error::invalid_data_type: return "Invalid resp3 type.";
+	 case error::not_a_number: return "Can't convert string to number.";
+	 case error::unexpected_read_size: return "Unexpected read size.";
+	 case error::exceeeds_max_nested_depth: return "Exceeds the maximum number of nested responses.";
+	 case error::unexpected_bool_value: return "Unexpected bool value.";
+	 case error::empty_field: return "Expected field value is empty.";
+	 case error::expects_resp3_simple_type: return "Expects a resp3 simple type.";
+	 case error::expects_resp3_aggregate: return "Expects resp3 aggregate.";
+	 case error::expects_resp3_map: return "Expects resp3 map.";
+	 case error::expects_resp3_set: return "Expects resp3 set.";
+	 case error::nested_aggregate_unsupported: return "Nested aggregate unsupported.";
+	 case error::simple_error: return "Got RESP3 simple-error.";
+	 case error::blob_error: return "Got RESP3 blob-error.";
+	 case error::incompatible_size: return "Aggregate container has incompatible size.";
+	 case error::not_a_double: return "Not a double.";
+	 case error::null: return "Got RESP3 null.";
+	 default:
+            BOOST_ASSERT(false);
+            return "Aedis error.";
+      }
+   }
+};
+
+boost::system::error_category const& category()
+{
+  static error_category_impl instance;
+  return instance;
+}
+
+} // detail
+
+boost::system::error_code make_error_code(error e)
+{
+    return boost::system::error_code{static_cast<int>(e), detail::category()};
+}
+
+} // aedis

include/aedis/resp3/detail/exec.hpp

@@ -0,0 +1,176 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#ifndef AEDIS_RESP3_EXEC_HPP
+#define AEDIS_RESP3_EXEC_HPP
+
+#include <boost/assert.hpp>
+#include <boost/asio/ip/tcp.hpp>
+#include <boost/asio/read.hpp>
+#include <boost/asio/write.hpp>
+#include <boost/asio/coroutine.hpp>
+#include <boost/asio/compose.hpp>
+#include <boost/asio/steady_timer.hpp>
+#include <boost/asio/experimental/parallel_group.hpp>
+
+#include <aedis/error.hpp>
+#include <aedis/resp3/read.hpp>
+#include <aedis/resp3/request.hpp>
+
+namespace aedis {
+namespace resp3 {
+namespace detail {
+
+#include <boost/asio/yield.hpp>
+
+template <
+   class AsyncStream,
+   class Adapter,
+   class DynamicBuffer
+   >
+struct exec_op {
+   AsyncStream* socket = nullptr;
+   request const* req = nullptr;
+   Adapter adapter;
+   DynamicBuffer dbuf{};
+   std::size_t n_cmds = 0;
+   std::size_t size = 0;
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void operator()( Self& self
+                  , boost::system::error_code ec = {}
+                  , std::size_t n = 0)
+   {
+      reenter (coro) for (;;)
+      {
+         if (req) {
+            yield
+            boost::asio::async_write(
+               *socket,
+               boost::asio::buffer(req->payload()),
+               std::move(self));
+
+            if (ec || n_cmds == 0) {
+               self.complete(ec, n);
+               return;
+            }
+
+            req = nullptr;
+         }
+
+         yield resp3::async_read(*socket, dbuf, adapter, std::move(self));
+         if (ec) {
+            self.complete(ec, 0);
+            return;
+         }
+
+         size += n;
+         if (--n_cmds == 0) {
+            self.complete(ec, size);
+            return;
+         }
+      }
+   }
+};
+
+template <
+   class AsyncStream,
+   class Adapter,
+   class DynamicBuffer,
+   class CompletionToken = boost::asio::default_completion_token_t<typename AsyncStream::executor_type>
+   >
+auto async_exec(
+   AsyncStream& socket,
+   request const& req,
+   Adapter adapter,
+   DynamicBuffer dbuf,
+   CompletionToken token = CompletionToken{})
+{
+   return boost::asio::async_compose
+      < CompletionToken
+      , void(boost::system::error_code, std::size_t)
+      >(detail::exec_op<AsyncStream, Adapter, DynamicBuffer>
+         {&socket, &req, adapter, dbuf, req.size()}, token, socket);
+}
+
+template <
+   class AsyncStream,
+   class Timer,
+   class Adapter,
+   class DynamicBuffer
+   >
+struct exec_with_timeout_op {
+   AsyncStream* socket = nullptr;
+   Timer* timer = nullptr;
+   request const* req = nullptr;
+   Adapter adapter;
+   DynamicBuffer dbuf{};
+   boost::asio::coroutine coro{};
+
+   template <class Self>
+   void operator()( Self& self
+                  , std::array<std::size_t, 2> order = {}
+                  , boost::system::error_code ec1 = {}
+                  , std::size_t n = 0
+                  , boost::system::error_code ec2 = {})
+   {
+      reenter (coro)
+      {
+         yield
+         boost::asio::experimental::make_parallel_group(
+            [this](auto token) { return detail::async_exec(*socket, *req, adapter, dbuf, token);},
+            [this](auto token) { return timer->async_wait(token);}
+         ).async_wait(
+            boost::asio::experimental::wait_for_one(),
+            std::move(self));
+
+         switch (order[0]) {
+            case 0: self.complete(ec1, n); break;
+            case 1:
+            {
+               if (ec2)
+                  self.complete({}, n);
+               else
+                  self.complete(aedis::error::exec_timeout, 0);
+
+            } break;
+
+            default: BOOST_ASSERT(false);
+         }
+      }
+   }
+};
+
+#include <boost/asio/unyield.hpp>
+
+template <
+   class AsyncStream,
+   class Timer,
+   class Adapter,
+   class DynamicBuffer,
+   class CompletionToken = boost::asio::default_completion_token_t<typename AsyncStream::executor_type>
+   >
+auto async_exec(
+   AsyncStream& socket,
+   Timer& timer,
+   request const& req,
+   Adapter adapter,
+   DynamicBuffer dbuf,
+   CompletionToken token = CompletionToken{})
+{
+   return boost::asio::async_compose
+      < CompletionToken
+      , void(boost::system::error_code, std::size_t)
+      >(detail::exec_with_timeout_op<AsyncStream, Timer, Adapter, DynamicBuffer>
+         {&socket, &timer, &req, adapter, dbuf}, token, socket, timer);
+}
+
+} // detail
+} // resp3
+} // aedis
+
+#endif // AEDIS_RESP3_EXEC_HPP

include/aedis/resp3/detail/impl/parser.ipp

@@ -0,0 +1,30 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#include <boost/spirit/include/qi.hpp>
+#include <boost/spirit/home/x3.hpp>
+
+#include <aedis/resp3/detail/parser.hpp>
+#include <aedis/resp3/type.hpp>
+
+namespace aedis {
+namespace resp3 {
+namespace detail {
+
+std::size_t
+parse_uint(char const* data, std::size_t size, boost::system::error_code& ec)
+{
+   static constexpr boost::spirit::x3::uint_parser<std::size_t, 10> p{};
+   std::size_t ret;
+   if (!parse(data, data + size, p, ret))
+      ec = error::not_a_number;
+
+   return ret;
+}
+
+} // detail
+} // resp3
+} // aedis

include/aedis/resp3/detail/parser.hpp

@@ -1,29 +1,31 @@
-/* Copyright (c) 2019 - 2021 Marcelo Zimbres Silva (mzimbres at gmail dot com)
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
  *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
  */
 
-#pragma once
+#ifndef AEDIS_RESP3_PARSER_HPP
+#define AEDIS_RESP3_PARSER_HPP
 
-#include <string_view>
-#include <charconv>
-#include <system_error>
 #include <limits>
+#include <system_error>
 
-#include <aedis/resp3/error.hpp>
+#include <boost/assert.hpp>
+#include <boost/utility/string_view.hpp>
+
+#include <aedis/error.hpp>
+#include <aedis/resp3/node.hpp>
 
 namespace aedis {
 namespace resp3 {
 namespace detail {
 
-// Converts a wire-format RESP3 type (char) to a resp3 type.
-type to_type(char c);
+std::size_t parse_uint(char const* data, std::size_t size, boost::system::error_code& ec);
 
 template <class ResponseAdapter>
 class parser {
 private:
+   using node_type = node<boost::string_view>;
    static constexpr std::size_t max_embedded_depth = 5;
 
    ResponseAdapter adapter_;
@@ -54,24 +56,21 @@ public:
 
    // Returns the number of bytes that have been consumed.
    std::size_t
-   advance(char const* data, std::size_t n, std::error_code& ec)
+   consume(char const* data, std::size_t n, boost::system::error_code& ec)
    {
       if (bulk_ != type::invalid) {
          n = bulk_length_ + 2;
          switch (bulk_) {
             case type::streamed_string_part:
             {
-              if (bulk_length_ == 0) {
-                 sizes_[depth_] = 1;
-              } else {
-                 adapter_(bulk_, 1, depth_, data, bulk_length_, ec);
-		 if (ec)
-		    return 0;
-              }
+               BOOST_ASSERT(bulk_length_ != 0);
+               adapter_({bulk_, 1, depth_, {data, bulk_length_}}, ec);
+               if (ec)
+                  return 0;
             } break;
             default:
 	    {
-	       adapter_(bulk_, 1, depth_, data, bulk_length_, ec);
+	       adapter_({bulk_, 1, depth_, {data, bulk_length_}}, ec);
 	       if (ec)
 		  return 0;
 	    }
@@ -83,46 +82,75 @@ public:
       } else if (sizes_[depth_] != 0) {
          auto const t = to_type(*data);
          switch (t) {
-            case type::blob_error:
-            case type::verbatim_string:
             case type::streamed_string_part:
             {
-               auto const r =
-		  std::from_chars(data + 1, data + n - 2, bulk_length_);
-	       if (r.ec != std::errc()) {
-		  ec = error::not_a_number;
+               bulk_length_ = parse_uint(data + 1, n - 2, ec);
+	       if (ec)
 		  return 0;
-	       }
 
-               bulk_ = t;
+               if (bulk_length_ == 0) {
+                  adapter_({type::streamed_string_part, 1, depth_, {}}, ec);
+                  sizes_[depth_] = 0; // We are done.
+               } else {
+                  bulk_ = type::streamed_string_part;
+               }
             } break;
+            case type::blob_error:
+            case type::verbatim_string:
             case type::blob_string:
             {
                if (*(data + 1) == '?') {
+                  // NOTE: This can only be triggered with blob_string.
 		  // Trick: A streamed string is read as an aggregate
 		  // of infinite lenght. When the streaming is done
-		  // the server is supposed to send a part with lenght
+		  // the server is supposed to send a part with length
 		  // 0.
                   sizes_[++depth_] = (std::numeric_limits<std::size_t>::max)();
                } else {
-		  auto const r =
-		     std::from_chars(data + 1, data + n - 2, bulk_length_);
-		  if (r.ec != std::errc()) {
-		     ec = error::not_a_number;
-		     return 0;
-		  }
+                  bulk_length_ = parse_uint(data + 1, n - 2, ec);
+                  if (ec)
+                     return 0;
 
-                  bulk_ = type::blob_string;
+                  bulk_ = t;
                }
             } break;
-            case type::simple_error:
-            case type::number:
-            case type::doublean:
             case type::boolean:
+            {
+               if (n == 3) {
+                   ec = error::empty_field;
+                   return 0;
+               }
+
+               if (*(data + 1) != 'f' && *(data + 1) != 't') {
+                   ec = error::unexpected_bool_value;
+                   return 0;
+               }
+
+               adapter_({t, 1, depth_, {data + 1, n - 3}}, ec);
+	       if (ec)
+		  return 0;
+
+               --sizes_[depth_];
+            } break;
+            case type::doublean:
             case type::big_number:
+            case type::number:
+            {
+               if (n == 3) {
+                   ec = error::empty_field;
+                   return 0;
+               }
+
+               adapter_({t, 1, depth_, {data + 1, n - 3}}, ec);
+	       if (ec)
+		  return 0;
+
+               --sizes_[depth_];
+            } break;
+            case type::simple_error:
             case type::simple_string:
             {
-               adapter_(t, 1, depth_, data + 1, n - 3, ec);
+               adapter_({t, 1, depth_, {data + 1, n - 3}}, ec);
 	       if (ec)
 		  return 0;
 
@@ -130,7 +158,7 @@ public:
             } break;
             case type::null:
             {
-               adapter_(type::null, 1, depth_, nullptr, 0, ec);
+               adapter_({type::null, 1, depth_, {}}, ec);
 	       if (ec)
 		  return 0;
 
@@ -142,14 +170,11 @@ public:
             case type::attribute:
             case type::map:
             {
-	       std::size_t l;
-               auto const r = std::from_chars(data + 1, data + n - 2, l);
-	       if (r.ec != std::errc()) {
-		  ec = error::not_a_number;
-		  return 0;
-	       }
+	       auto const l = parse_uint(data + 1, n - 2, ec);
+               if (ec)
+                  return 0;
 
-               adapter_(t, l, depth_, nullptr, 0, ec);
+               adapter_({t, l, depth_, {}}, ec);
 	       if (ec)
 		  return 0;
 
@@ -168,7 +193,7 @@ public:
             } break;
             default:
             {
-	       ec = error::invalid_type;
+	       ec = error::invalid_data_type;
 	       return 0;
             }
          }
@@ -197,3 +222,5 @@ public:
 } // detail
 } // resp3
 } // aedis
+
+#endif // AEDIS_RESP3_PARSER_HPP

include/aedis/resp3/detail/read_ops.hpp

@@ -0,0 +1,115 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#ifndef AEDIS_RESP3_READ_OPS_HPP
+#define AEDIS_RESP3_READ_OPS_HPP
+
+#include <boost/assert.hpp>
+#include <boost/asio/read.hpp>
+#include <boost/asio/read_until.hpp>
+#include <boost/asio/coroutine.hpp>
+#include <boost/core/ignore_unused.hpp>
+#include <boost/utility/string_view.hpp>
+
+#include <aedis/resp3/detail/parser.hpp>
+
+namespace aedis {
+namespace resp3 {
+namespace detail {
+
+#include <boost/asio/yield.hpp>
+
+struct ignore_response {
+   void operator()(node<boost::string_view>, boost::system::error_code&) { }
+};
+
+template <
+   class AsyncReadStream,
+   class DynamicBuffer,
+   class ResponseAdapter>
+class parse_op {
+private:
+   AsyncReadStream& stream_;
+   DynamicBuffer buf_;
+   parser<ResponseAdapter> parser_;
+   std::size_t consumed_;
+   std::size_t buffer_size_;
+   boost::asio::coroutine coro_{};
+
+public:
+   parse_op(AsyncReadStream& stream, DynamicBuffer buf, ResponseAdapter adapter)
+   : stream_ {stream}
+   , buf_ {buf}
+   , parser_ {adapter}
+   , consumed_{0}
+   { }
+
+   template <class Self>
+   void operator()( Self& self
+                  , boost::system::error_code ec = {}
+                  , std::size_t n = 0)
+   {
+      reenter (coro_) for (;;) {
+         if (parser_.bulk() == type::invalid) {
+            yield
+            boost::asio::async_read_until(stream_, buf_, "\r\n", std::move(self));
+
+            if (ec) {
+               self.complete(ec, 0);
+               return;
+            }
+         } else {
+	    // On a bulk read we can't read until delimiter since the
+	    // payload may contain the delimiter itself so we have to
+	    // read the whole chunk. However if the bulk blob is small
+	    // enough it may be already on the buffer (from the last
+	    // read), in which case there is no need of initiating
+	    // another async op, otherwise we have to read the missing
+	    // bytes.
+            if (buf_.size() < (parser_.bulk_length() + 2)) {
+               buffer_size_ = buf_.size();
+               buf_.grow(parser_.bulk_length() + 2 - buffer_size_);
+
+               yield
+               boost::asio::async_read(
+                  stream_,
+                  buf_.data(buffer_size_, parser_.bulk_length() + 2 - buffer_size_),
+                  boost::asio::transfer_all(),
+                  std::move(self));
+
+               if (ec) {
+                  self.complete(ec, 0);
+                  return;
+               }
+            }
+
+            n = parser_.bulk_length() + 2;
+            BOOST_ASSERT(buf_.size() >= n);
+         }
+
+         n = parser_.consume((char const*)buf_.data(0, n).data(), n, ec);
+         if (ec) {
+            self.complete(ec, 0);
+            return;
+         }
+
+         buf_.consume(n);
+         consumed_ += n;
+         if (parser_.done()) {
+            self.complete({}, consumed_);
+            return;
+         }
+      }
+   }
+};
+
+#include <boost/asio/unyield.hpp>
+
+} // detail
+} // resp3
+} // aedis
+
+#endif // AEDIS_RESP3_READ_OPS_HPP

include/aedis/resp3/impl/request.ipp

@@ -0,0 +1,23 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#include <aedis/resp3/request.hpp>
+
+namespace aedis {
+namespace resp3 {
+namespace detail {
+
+bool has_push_response(boost::string_view cmd)
+{
+   if (cmd == "SUBSCRIBE") return true;
+   if (cmd == "PSUBSCRIBE") return true;
+   if (cmd == "UNSUBSCRIBE") return true;
+   return false;
+}
+
+} // detail
+} // resp3
+} // aedis

include/aedis/resp3/impl/type.ipp

@@ -0,0 +1,113 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#include <boost/assert.hpp>
+#include <aedis/resp3/type.hpp>
+
+namespace aedis {
+namespace resp3 {
+
+char const* to_string(type t)
+{
+   switch (t) {
+      case type::array: return "array";
+      case type::push: return "push";
+      case type::set: return "set";
+      case type::map: return "map";
+      case type::attribute: return "attribute";
+      case type::simple_string: return "simple_string";
+      case type::simple_error: return "simple_error";
+      case type::number: return "number";
+      case type::doublean: return "doublean";
+      case type::boolean: return "boolean";
+      case type::big_number: return "big_number";
+      case type::null: return "null";
+      case type::blob_error: return "blob_error";
+      case type::verbatim_string: return "verbatim_string";
+      case type::blob_string: return "blob_string";
+      case type::streamed_string_part: return "streamed_string_part";
+      default: return "invalid";
+   }
+}
+
+std::ostream& operator<<(std::ostream& os, type t)
+{
+   os << to_string(t);
+   return os;
+}
+
+bool is_aggregate(type t)
+{
+   switch (t) {
+      case type::array:
+      case type::push:
+      case type::set:
+      case type::map:
+      case type::attribute: return true;
+      default: return false;
+   }
+}
+
+std::size_t element_multiplicity(type t)
+{
+   switch (t) {
+      case type::map:
+      case type::attribute: return 2ULL;
+      default: return 1ULL;
+   }
+}
+
+char to_code(type t)
+{
+   switch (t) {
+      case type::blob_error:           return '!';
+      case type::verbatim_string:      return '=';
+      case type::blob_string:          return '$';
+      case type::streamed_string_part: return ';';
+      case type::simple_error:         return '-';
+      case type::number:               return ':';
+      case type::doublean:             return ',';
+      case type::boolean:              return '#';
+      case type::big_number:           return '(';
+      case type::simple_string:        return '+';
+      case type::null:                 return '_';
+      case type::push:                 return '>';
+      case type::set:                  return '~';
+      case type::array:                return '*';
+      case type::attribute:            return '|';
+      case type::map:                  return '%';
+
+      default:
+      BOOST_ASSERT(false);
+      return ' ';
+   }
+}
+
+type to_type(char c)
+{
+   switch (c) {
+      case '!': return type::blob_error;
+      case '=': return type::verbatim_string;
+      case '$': return type::blob_string;
+      case ';': return type::streamed_string_part;
+      case '-': return type::simple_error;
+      case ':': return type::number;
+      case ',': return type::doublean;
+      case '#': return type::boolean;
+      case '(': return type::big_number;
+      case '+': return type::simple_string;
+      case '_': return type::null;
+      case '>': return type::push;
+      case '~': return type::set;
+      case '*': return type::array;
+      case '|': return type::attribute;
+      case '%': return type::map;
+      default: return type::invalid;
+   }
+}
+
+} // resp3
+} // aedis

include/aedis/resp3/node.hpp

@@ -0,0 +1,96 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#ifndef AEDIS_RESP3_NODE_HPP
+#define AEDIS_RESP3_NODE_HPP
+
+#include <aedis/resp3/type.hpp>
+
+#include <string>
+#include <vector>
+
+namespace aedis {
+namespace resp3 {
+
+/** \brief A node in the response tree.
+ *  \ingroup any
+ *
+ *  Redis responses are the pre-order view of the response tree (see
+ *  https://en.wikipedia.org/wiki/Tree_traversal#Pre-order,_NLR).
+ *
+ *  \remark Any Redis response can be received in an array of nodes,
+ *  for example \c std::vector<node<std::string>>.
+ */
+template <class String>
+struct node {
+   /// The RESP3 type of the data in this node.
+   resp3::type data_type;
+
+   /// The number of elements of an aggregate.
+   std::size_t aggregate_size;
+
+   /// The depth of this node in the response tree.
+   std::size_t depth;
+
+   /// The actual data. For aggregate types this is usually empty.
+   String value;
+};
+
+/** @brief Converts the node to a string.
+ *  @relates node
+ *
+ *  @param in The node object.
+ */
+template <class String>
+std::string to_string(node<String> const& in)
+{
+   std::string out;
+   out += std::to_string(in.depth);
+   out += '\t';
+   out += to_string(in.data_type);
+   out += '\t';
+   out += std::to_string(in.aggregate_size);
+   out += '\t';
+   if (!is_aggregate(in.data_type))
+      out.append(in.value.data(), in.value.size());
+
+   return out;
+}
+
+/** @brief Compares a node for equality.
+ *  @relates node
+ *
+ *  @param a Left hand side node object.
+ *  @param b Right hand side node object.
+ */
+template <class String>
+bool operator==(node<String> const& a, node<String> const& b)
+{
+   return a.aggregate_size == b.aggregate_size
+       && a.depth == b.depth
+       && a.data_type == b.data_type
+       && a.value == b.value;
+};
+
+/** @brief Writes the node string to the stream.
+ *  @relates node
+ *
+ *  @param os Output stream.
+ *  @param node Node object.
+ *
+ *  \remark Binary data is not converted to text.
+ */
+template <class String>
+std::ostream& operator<<(std::ostream& os, node<String> const& node)
+{
+   os << to_string(node);
+   return os;
+}
+
+} // adapter
+} // aedis
+
+#endif // AEDIS_RESP3_NODE_HPP

include/aedis/resp3/read.hpp

@@ -0,0 +1,194 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#ifndef AEDIS_RESP3_READ_HPP
+#define AEDIS_RESP3_READ_HPP
+
+#include <aedis/resp3/type.hpp>
+#include <aedis/resp3/detail/parser.hpp>
+#include <aedis/resp3/detail/read_ops.hpp>
+
+#include <boost/asio/read.hpp>
+#include <boost/asio/compose.hpp>
+#include <boost/asio/async_result.hpp>
+
+namespace aedis {
+namespace resp3 {
+
+/** \internal
+ *  \brief Reads a complete response to a command sychronously.
+ *  \ingroup any
+ *
+ *  This function reads a complete response to a command or a
+ *  server push synchronously. For example
+ *
+ *  @code
+ *  int resp;
+ *  std::string buffer;
+ *  resp3::read(socket, dynamic_buffer(buffer), adapt(resp));
+ *  @endcode
+ *
+ *  For a complete example see examples/intro_sync.cpp. This function
+ *  is implemented in terms of one or more calls to @c
+ *  asio::read_until and @c asio::read functions, and is known as a @a
+ *  composed @a operation. Furthermore, the implementation may read
+ *  additional bytes from the stream that lie past the end of the
+ *  message being read. These additional bytes are stored in the
+ *  dynamic buffer, which must be preserved for subsequent reads.
+ *
+ *  \param stream The stream from which to read e.g. a tcp socket.
+ *  \param buf Dynamic buffer (version 2).
+ *  \param adapter The response adapter, see more on \ref low-level-responses.
+ *  \param ec If an error occurs, it will be assigned to this paramter.
+ *  \returns The number of bytes that have been consumed from the dynamic buffer.
+ *
+ *  \remark This function calls buf.consume() in each chunk of data
+ *  after it has been passed to the adapter. Users must not consume
+ *  the bytes after it returns.
+ */
+template <
+  class SyncReadStream,
+  class DynamicBuffer,
+  class ResponseAdapter
+  >
+std::size_t
+read(
+   SyncReadStream& stream,
+   DynamicBuffer buf,
+   ResponseAdapter adapter,
+   boost::system::error_code& ec)
+{
+   detail::parser<ResponseAdapter> p {adapter};
+   std::size_t n = 0;
+   std::size_t consumed = 0;
+   do {
+      if (p.bulk() == type::invalid) {
+	 n = boost::asio::read_until(stream, buf, "\r\n", ec);
+	 if (ec)
+	    return 0;
+
+	 if (n < 3) {
+            ec = error::unexpected_read_size;
+            return 0;
+         }
+      } else {
+	 auto const s = buf.size();
+	 auto const l = p.bulk_length();
+	 if (s < (l + 2)) {
+	    auto const to_read = l + 2 - s;
+	    buf.grow(to_read);
+	    n = boost::asio::read(stream, buf.data(s, to_read), ec);
+	    if (ec)
+	       return 0;
+
+            if (n < to_read) {
+               ec = error::unexpected_read_size;
+               return 0;
+            }
+	 }
+      }
+
+      auto const* data = (char const*) buf.data(0, n).data();
+      n = p.consume(data, n, ec);
+      if (ec)
+         return 0;
+
+      buf.consume(n);
+      consumed += n;
+   } while (!p.done());
+
+   return consumed;
+}
+
+/** \internal
+ *  \brief Reads a complete response to a command sychronously.
+ *  \ingroup any
+ *  
+ *  Same as the error_code overload but throws on error.
+ */
+template<
+   class SyncReadStream,
+   class DynamicBuffer,
+   class ResponseAdapter = detail::ignore_response>
+std::size_t
+read(
+   SyncReadStream& stream,
+   DynamicBuffer buf,
+   ResponseAdapter adapter = ResponseAdapter{})
+{
+   boost::system::error_code ec;
+   auto const n = resp3::read(stream, buf, adapter, ec);
+
+   if (ec)
+       BOOST_THROW_EXCEPTION(boost::system::system_error{ec});
+
+   return n;
+}
+
+/** \internal
+ *  \brief Reads a complete response to a Redis command asynchronously.
+ *  \ingroup any
+ *
+ *  This function reads a complete response to a command or a
+ *  server push asynchronously. For example
+ *
+ *  @code
+ *  std::string buffer;
+ *  std::set<std::string> resp;
+ *  co_await resp3::async_read(socket, dynamic_buffer(buffer), adapt(resp));
+ *  @endcode
+ *
+ *  For a complete example see examples/transaction.cpp. This function
+ *  is implemented in terms of one or more calls to @c
+ *  asio::async_read_until and @c asio::async_read functions, and is
+ *  known as a @a composed @a operation.  Furthermore, the
+ *  implementation may read additional bytes from the stream that lie
+ *  past the end of the message being read. These additional bytes are
+ *  stored in the dynamic buffer, which must be preserved for
+ *  subsequent reads.
+ *
+ *  \param stream The stream from which to read e.g. a tcp socket.
+ *  \param buffer Dynamic buffer (version 2).
+ *  \param adapter The response adapter, see more on \ref low-level-responses.
+ *  \param token The completion token.
+ *
+ *  The completion handler will receive as a parameter the total
+ *  number of bytes transferred from the stream and must have the
+ *  following signature
+ *
+ *  @code
+ *  void(boost::system::error_code, std::size_t);
+ *  @endcode
+ *
+ *  \remark This function calls buf.consume() in each chunk of data
+ *  after it has been passed to the adapter. Users must not consume
+ *  the bytes after it returns.
+ */
+template <
+   class AsyncReadStream,
+   class DynamicBuffer,
+   class ResponseAdapter = detail::ignore_response,
+   class CompletionToken = boost::asio::default_completion_token_t<typename AsyncReadStream::executor_type>
+   >
+auto async_read(
+   AsyncReadStream& stream,
+   DynamicBuffer buffer,
+   ResponseAdapter adapter = ResponseAdapter{},
+   CompletionToken&& token =
+      boost::asio::default_completion_token_t<typename AsyncReadStream::executor_type>{})
+{
+   return boost::asio::async_compose
+      < CompletionToken
+      , void(boost::system::error_code, std::size_t)
+      >(detail::parse_op<AsyncReadStream, DynamicBuffer, ResponseAdapter> {stream, buffer, adapter},
+        token,
+        stream);
+}
+
+} // resp3
+} // aedis
+
+#endif // AEDIS_RESP3_READ_HPP

include/aedis/resp3/request.hpp

@@ -0,0 +1,340 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#ifndef AEDIS_RESP3_REQUEST_HPP
+#define AEDIS_RESP3_REQUEST_HPP
+
+#include <string>
+#include <tuple>
+
+#include <boost/hana.hpp>
+#include <boost/utility/string_view.hpp>
+
+#include <aedis/resp3/type.hpp>
+
+// NOTE: Consider detecting tuples in the type in the parameter pack
+// to calculate the header size correctly.
+//
+// NOTE: For some commands like hset it would be a good idea to assert
+// the value type is a pair.
+
+namespace aedis {
+namespace resp3 {
+
+constexpr char separator[] = "\r\n";
+
+/** @brief Adds a bulk to the request.
+ *  @relates request
+ *
+ *  This function is useful in serialization of your own data
+ *  structures in a request. For example
+ *
+ *  @code
+ *  void to_bulk(std::string& to, mystruct const& obj)
+ *  {
+ *     auto const str = // Convert obj to a string.
+ *     resp3::to_bulk(to, str);
+ *  }
+ *  @endcode
+ *
+ *  @param to Storage on which data will be copied into.
+ *  @param data Data that will be serialized and stored in @c to.
+ *
+ *  See more in \ref requests-serialization.
+ */
+template <class Request>
+void to_bulk(Request& to, boost::string_view data)
+{
+   auto const str = std::to_string(data.size());
+
+   to += to_code(type::blob_string);
+   to.append(std::cbegin(str), std::cend(str));
+   to += separator;
+   to.append(std::cbegin(data), std::cend(data));
+   to += separator;
+}
+
+template <class Request, class T, typename = typename std::enable_if<std::is_integral<T>::value>::type>
+void to_bulk(Request& to, T n)
+{
+   auto const s = std::to_string(n);
+   to_bulk(to, boost::string_view{s});
+}
+
+namespace detail {
+
+bool has_push_response(boost::string_view cmd);
+
+template <class T>
+struct add_bulk_impl {
+   template <class Request>
+   static void add(Request& to, T const& from)
+   {
+      using namespace aedis::resp3;
+      to_bulk(to, from);
+   }
+};
+
+template <class U, class V>
+struct add_bulk_impl<std::pair<U, V>> {
+   template <class Request>
+   static void add(Request& to, std::pair<U, V> const& from)
+   {
+      using namespace aedis::resp3;
+      to_bulk(to, from.first);
+      to_bulk(to, from.second);
+   }
+};
+
+template <class ...Ts>
+struct add_bulk_impl<boost::hana::tuple<Ts...>> {
+   template <class Request>
+   static void add(Request& to, boost::hana::tuple<Ts...> const& from)
+   {
+      using boost::hana::for_each;
+
+      // Fold expressions is C++17 so we use hana.
+      //(detail::add_bulk(*request_, args), ...);
+
+      for_each(from, [&](auto const& e) {
+         using namespace aedis::resp3;
+         to_bulk(to, e);
+      });
+   }
+};
+
+template <class Request>
+void add_header(Request& to, type t, std::size_t size)
+{
+   auto const str = std::to_string(size);
+
+   to += to_code(t);
+   to.append(std::cbegin(str), std::cend(str));
+   to += separator;
+}
+
+template <class Request, class T>
+void add_bulk(Request& to, T const& data)
+{
+   detail::add_bulk_impl<T>::add(to, data);
+}
+
+template <class>
+struct bulk_counter;
+
+template <class>
+struct bulk_counter {
+  static constexpr auto size = 1U;
+};
+
+template <class T, class U>
+struct bulk_counter<std::pair<T, U>> {
+  static constexpr auto size = 2U;
+};
+
+template <class Request>
+void add_blob(Request& to, boost::string_view blob)
+{
+   to.append(std::cbegin(blob), std::cend(blob));
+   to += separator;
+}
+
+template <class Request>
+void add_separator(Request& to)
+{
+   to += separator;
+}
+} // detail
+
+/** @brief Creates Redis requests.
+ *  \ingroup any
+ *  
+ *  A request is composed of one or more Redis commands and is
+ *  referred to in the redis documentation as a pipeline, see
+ *  https://redis.io/topics/pipelining. For example
+ *
+ *  @code
+ *  request r;
+ *  r.push("HELLO", 3);
+ *  r.push("FLUSHALL");
+ *  r.push("PING");
+ *  r.push("PING", "key");
+ *  r.push("QUIT");
+ *  co_await async_write(socket, buffer(r));
+ *  @endcode
+ *
+ *  \remarks  Non-string types will be converted to string by using \c
+ *  to_bulk, which must be made available over ADL.
+ */
+class request {
+public:
+   //// Returns the number of commands contained in this request.
+   std::size_t size() const noexcept { return commands_;};
+
+   // Returns the request payload.
+   auto const& payload() const noexcept { return payload_;}
+
+   /// Clears the request preserving allocated memory.
+   void clear()
+   {
+      payload_.clear();
+      commands_ = 0;
+   }
+
+   /** @brief Appends a new command to the end of the request.
+    *
+    *  For example
+    *
+    *  \code
+    *  request req;
+    *  req.push("SET", "key", "some string", "EX", "2");
+    *  \endcode
+    *
+    *  will add the \c set command with value "some string" and an
+    *  expiration of 2 seconds.
+    *
+    *  \param cmd The command e.g redis or sentinel command.
+    *  \param args Command arguments.
+    */
+   template <class... Ts>
+   void push(boost::string_view cmd, Ts const&... args)
+   {
+      using boost::hana::for_each;
+      using boost::hana::make_tuple;
+      using resp3::type;
+
+      auto constexpr pack_size = sizeof...(Ts);
+      detail::add_header(payload_, type::array, 1 + pack_size);
+      detail::add_bulk(payload_, cmd);
+      detail::add_bulk(payload_, make_tuple(args...));
+
+      if (!detail::has_push_response(cmd))
+         ++commands_;
+   }
+
+   /** @brief Appends a new command to the end of the request.
+    *  
+    *  This overload is useful for commands that have a key and have a
+    *  dynamic range of arguments. For example
+    *
+    *  @code
+    *  std::map<std::string, std::string> map
+    *     { {"key1", "value1"}
+    *     , {"key2", "value2"}
+    *     , {"key3", "value3"}
+    *     };
+    *
+    *  request req;
+    *  req.push_range2("HSET", "key", std::cbegin(map), std::cend(map));
+    *  @endcode
+    *  
+    *  \param cmd The command e.g. Redis or Sentinel command.
+    *  \param key The command key.
+    *  \param begin Iterator to the begin of the range.
+    *  \param end Iterator to the end of the range.
+    */
+   template <class Key, class ForwardIterator>
+   void push_range2(boost::string_view cmd, Key const& key, ForwardIterator begin, ForwardIterator end)
+   {
+      using value_type = typename std::iterator_traits<ForwardIterator>::value_type;
+      using resp3::type;
+
+      if (begin == end)
+         return;
+
+      auto constexpr size = detail::bulk_counter<value_type>::size;
+      auto const distance = std::distance(begin, end);
+      detail::add_header(payload_, type::array, 2 + size * distance);
+      detail::add_bulk(payload_, cmd);
+      detail::add_bulk(payload_, key);
+
+      for (; begin != end; ++begin)
+	 detail::add_bulk(payload_, *begin);
+
+      if (!detail::has_push_response(cmd))
+         ++commands_;
+   }
+
+   /** @brief Appends a new command to the end of the request.
+    *
+    *  This overload is useful for commands that have a dynamic number
+    *  of arguments and don't have a key. For example
+    *
+    *  \code
+    *  std::set<std::string> channels
+    *     { "channel1" , "channel2" , "channel3" }
+    *
+    *  request req;
+    *  req.push("SUBSCRIBE", std::cbegin(channels), std::cedn(channels));
+    *  \endcode
+    *
+    *  \param cmd The Redis command
+    *  \param begin Iterator to the begin of the range.
+    *  \param end Iterator to the end of the range.
+    */
+   template <class ForwardIterator>
+   void push_range2(boost::string_view cmd, ForwardIterator begin, ForwardIterator end)
+   {
+      using value_type = typename std::iterator_traits<ForwardIterator>::value_type;
+      using resp3::type;
+
+      if (begin == end)
+         return;
+
+      auto constexpr size = detail::bulk_counter<value_type>::size;
+      auto const distance = std::distance(begin, end);
+      detail::add_header(payload_, type::array, 1 + size * distance);
+      detail::add_bulk(payload_, cmd);
+
+      for (; begin != end; ++begin)
+	 detail::add_bulk(payload_, *begin);
+
+      if (!detail::has_push_response(cmd))
+         ++commands_;
+   }
+
+   /** @brief Appends a new command to the end of the request.
+    *  
+    *  Equivalent to the overload taking a range (i.e. send_range2).
+    *
+    *  \param cmd Redis command.
+    *  \param key Redis key.
+    *  \param range Range to send e.g. and \c std::map.
+    */
+   template <class Key, class Range>
+   void push_range(boost::string_view cmd, Key const& key, Range const& range)
+   {
+      using std::begin;
+      using std::end;
+      push_range2(cmd, key, begin(range), end(range));
+   }
+
+   /** @brief Appends a new command to the end of the request.
+    *
+    *  Equivalent to the overload taking a range (i.e. send_range2).
+    *
+    *  \param cmd Redis command.
+    *  \param range Range to send e.g. and \c std::map.
+    */
+   template <class Range>
+   void push_range(boost::string_view cmd, Range const& range)
+   {
+      using std::begin;
+      using std::end;
+      push_range2(cmd, begin(range), end(range));
+   }
+
+   mutable bool close_on_run_completion = false;
+
+private:
+   std::string payload_;
+   std::size_t commands_ = 0;
+};
+
+} // resp3
+} // aedis
+
+#endif // AEDIS_RESP3_SERIALIZER_HPP

include/aedis/resp3/type.hpp

@@ -1,11 +1,11 @@
-/* Copyright (c) 2019 - 2021 Marcelo Zimbres Silva (mzimbres at gmail dot com)
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
  *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
  */
 
-#pragma once
+#ifndef AEDIS_RESP3_TYPE_HPP
+#define AEDIS_RESP3_TYPE_HPP
 
 #include <ostream>
 #include <vector>
@@ -14,10 +14,10 @@
 namespace aedis {
 namespace resp3 {
 
-/** \brief RESP3 types
+/** \brief RESP3 data types.
     \ingroup any
   
-    The RESP3 full specification can be found at https://github.com/antirez/RESP3/blob/74adea588783e463c7e84793b325b088fe6edd1c/spec.md
+    The RESP3 specification can be found at https://github.com/redis/redis-specifications/blob/master/protocol/RESP3.md.
  */
 enum class type
 { /// Aggregate
@@ -56,33 +56,34 @@ enum class type
   invalid
 };
 
-/** \brief Returns the string representation of the type.
+/** \brief Converts the data type to a string.
  *  \ingroup any
  *  \param t RESP3 type.
  */
 char const* to_string(type t);
 
 /** \brief Writes the type to the output stream.
- *  \ingroup operators
+ *  \ingroup any
  *  \param os Output stream.
  *  \param t RESP3 type.
  */
 std::ostream& operator<<(std::ostream& os, type t);
 
-/** \brief Returns true if the data type is an aggregate.
- *  \ingroup any
- *  \param t RESP3 type.
+/* Checks whether the data type is an aggregate.
  */
 bool is_aggregate(type t);
 
-/** @brief Returns the element multilicity.
- *  \ingroup any
- *  \param t RESP3 type.
- *
- *  For type map and attribute this value is 2, all other types have
- *  1.
- */
+// For map and attribute data types this function returns 2.  All
+// other types have value 1.
 std::size_t element_multiplicity(type t);
 
+// Returns the wire code of a given type.
+char to_code(type t);
+
+// Converts a wire-format RESP3 type (char) to a resp3 type.
+type to_type(char c);
+
 } // resp3
 } // aedis
+
+#endif // AEDIS_RESP3_TYPE_HPP

include/aedis/resp3/write.hpp

@@ -0,0 +1,53 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#ifndef AEDIS_RESP3_WRITE_HPP
+#define AEDIS_RESP3_WRITE_HPP
+
+#include <boost/asio/write.hpp>
+
+namespace aedis {
+namespace resp3 {
+
+template<
+   class SyncWriteStream,
+   class Request
+   >
+std::size_t write(SyncWriteStream& stream, Request const& req)
+{
+   return boost::asio::write(stream, boost::asio::buffer(req.payload()));
+}
+
+template<
+    class SyncWriteStream,
+    class Request
+    >
+std::size_t write(
+    SyncWriteStream& stream,
+    Request const& req,
+    boost::system::error_code& ec)
+{
+   return boost::asio::write(stream, boost::asio::buffer(req.payload()), ec);
+}
+
+template<
+   class AsyncWriteStream,
+   class Request,
+   class CompletionToken = boost::asio::default_completion_token_t<typename AsyncWriteStream::executor_type>
+   >
+auto async_write(
+   AsyncWriteStream& stream,
+   Request const& req,
+   CompletionToken&& token =
+      boost::asio::default_completion_token_t<typename AsyncWriteStream::executor_type>{})
+{
+   return boost::asio::async_write(stream, boost::asio::buffer(req.payload()), token);
+}
+
+} // resp3
+} // aedis
+
+#endif // AEDIS_RESP3_WRITE_HPP

include/aedis/src.hpp

@@ -0,0 +1,10 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#include <aedis/impl/error.ipp>
+#include <aedis/resp3/impl/request.ipp>
+#include <aedis/resp3/impl/type.ipp>
+#include <aedis/resp3/detail/impl/parser.ipp>

include/aedis/sync.hpp

@@ -0,0 +1,245 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+#ifndef AEDIS_SYNC_HPP
+#define AEDIS_SYNC_HPP
+
+#include <condition_variable>
+#include <aedis/resp3/request.hpp>
+
+namespace aedis {
+
+/** @brief A high level synchronous connection to Redis.
+ *  @ingroup any
+ *
+ *  This class keeps a healthy and thread safe connection to the Redis
+ *  instance where commands can be sent at any time. For more details,
+ *  please see the documentation of each individual function.
+ *
+ */
+template <class Connection>
+class sync {
+public:
+   using event = typename Connection::event;
+   using config = typename Connection::config;
+
+   /** @brief Constructor
+    *  
+    *  @param ex Executor
+    *  @param cfg Config options.
+    */
+   template <class Executor>
+   sync(Executor ex, config cfg = config{}) : conn_{ex, cfg} { }
+
+   /** @brief Executes a request synchronously.
+    *
+    *  The functions calls `connection::async_exec` and waits
+    *  for its completion.
+    *
+    *  @param req The request.
+    *  @param adapter The response adapter.
+    *  @param ec Error code in case of error.
+    *  @returns The number of bytes of the response.
+    */
+   template <class ResponseAdapter>
+   std::size_t
+   exec(resp3::request const& req, ResponseAdapter adapter, boost::system::error_code& ec)
+   {
+      sync_helper sh;
+      std::size_t res = 0;
+
+      auto f = [this, &ec, &res, &sh, &req, adapter]()
+      {
+         conn_.async_exec(req, adapter, [&sh, &res, &ec](auto const& ecp, std::size_t n) {
+            std::unique_lock ul(sh.mutex);
+            ec = ecp;
+            res = n;
+            sh.ready = true;
+            ul.unlock();
+            sh.cv.notify_one();
+         });
+      };
+
+      boost::asio::dispatch(boost::asio::bind_executor(conn_.get_executor(), f));
+      std::unique_lock lk(sh.mutex);
+      sh.cv.wait(lk, [&sh]{return sh.ready;});
+      return res;
+   }
+
+   /** @brief Executes a command synchronously
+    *
+    *  The functions calls `connection::async_exec` and waits for its
+    *  completion.
+    *
+    *  @param req The request.
+    *  @param adapter The response adapter.
+    *  @throws std::system_error in case of error.
+    *  @returns The number of bytes of the response.
+    */
+   template <class ResponseAdapter = detail::response_traits<void>::adapter_type>
+   std::size_t exec(resp3::request const& req, ResponseAdapter adapter = aedis::adapt())
+   {
+      boost::system::error_code ec;
+      auto const res = exec(req, adapter, ec);
+      if (ec)
+         throw std::system_error(ec);
+      return res;
+   }
+
+   /** @brief Receives server pushes synchronusly.
+    *
+    *  The functions calls `connection::async_receive_push` and
+    *  waits for its completion.
+    *
+    *  @param adapter The response adapter.
+    *  @param ec Error code in case of error.
+    *  @returns The number of bytes received.
+    */
+   template <class ResponseAdapter>
+   auto receive_push(ResponseAdapter adapter, boost::system::error_code& ec)
+   {
+      sync_helper sh;
+      std::size_t res = 0;
+
+      auto f = [this, &ec, &res, &sh, adapter]()
+      {
+         conn_.async_receive_push(adapter, [&ec, &res, &sh](auto const& e, std::size_t n) {
+            std::unique_lock ul(sh.mutex);
+            ec = e;
+            res = n;
+            sh.ready = true;
+            ul.unlock();
+            sh.cv.notify_one();
+         });
+      };
+
+      boost::asio::dispatch(boost::asio::bind_executor(conn_.get_executor(), f));
+      std::unique_lock lk(sh.mutex);
+      sh.cv.wait(lk, [&sh]{return sh.ready;});
+      return res;
+   }
+
+   /** @brief Receives server pushes synchronusly.
+    *
+    *  The functions calls `connection::async_receive_push` and
+    *  waits for its completion.
+    *
+    *  @param adapter The response adapter.
+    *  @throws std::system_error in case of error.
+    *  @returns The number of bytes received.
+    */
+   template <class ResponseAdapter = aedis::detail::response_traits<void>::adapter_type>
+   auto receive_push(ResponseAdapter adapter = aedis::adapt())
+   {
+      boost::system::error_code ec;
+      auto const res = receive_push(adapter, ec);
+      if (ec)
+         throw std::system_error(ec);
+      return res;
+   }
+
+   /** @brief Receives events synchronously.
+    *
+    *  The functions calls `connection::async_receive_event` and
+    *  waits for its completion.
+    *
+    *  @param ec Error code in case of error.
+    *  @returns The event received.
+    */
+   auto receive_event(boost::system::error_code& ec)
+   {
+      sync_helper sh;
+      auto res = event::invalid;
+
+      auto f = [this, &ec, &res, &sh]()
+      {
+         conn_.async_receive_event([&ec, &res, &sh](auto const& ecp, event ev) {
+            std::unique_lock ul(sh.mutex);
+            ec = ecp;
+            res = ev;
+            sh.ready = true;
+            ul.unlock();
+            sh.cv.notify_one();
+         });
+      };
+
+      boost::asio::dispatch(boost::asio::bind_executor(conn_.get_executor(), f));
+      std::unique_lock lk(sh.mutex);
+      sh.cv.wait(lk, [&sh]{return sh.ready;});
+      return res;
+   }
+
+   /** @brief Receives events synchronously
+    *
+    *  The functions calls `connection::async_receive_event` and
+    *  waits for its completion.
+    *
+    *  @throws std::system_error in case of error.
+    *  @returns The event received.
+    */
+   auto receive_event()
+   {
+      boost::system::error_code ec;
+      auto const res = receive_event(ec);
+      if (ec)
+         throw std::system_error(ec);
+      return res;
+   }
+
+   /** @brief Calls \c async_run from the underlying connection.
+    *
+    *  The functions calls `connection::async_run` and waits for its
+    *  completion.
+    *
+    *  @param ec Error code.
+    */
+   void run(boost::system::error_code& ec)
+   {
+      sync_helper sh;
+      auto f = [this, &ec, &sh]()
+      {
+         conn_.async_run([&ec, &sh](auto const& e) {
+            std::unique_lock ul(sh.mutex);
+            ec = e;
+            sh.ready = true;
+            ul.unlock();
+            sh.cv.notify_one();
+         });
+      };
+
+      boost::asio::dispatch(boost::asio::bind_executor(conn_.get_executor(), f));
+      std::unique_lock lk(sh.mutex);
+      sh.cv.wait(lk, [&sh]{return sh.ready;});
+   }
+
+   /** @brief Calls \c async_run from the underlying connection.
+    *
+    *  The functions calls `connection::async_run` and waits for its
+    *  completion.
+    *
+    *  @throws std::system_error.
+    */
+   void run()
+   {
+      boost::system::error_code ec;
+      run(ec);
+      if (ec)
+         throw std::system_error(ec);
+   }
+
+private:
+   struct sync_helper {
+      std::mutex mutex;
+      std::condition_variable cv;
+      bool ready = false;
+   };
+
+   Connection conn_;
+};
+
+} // aedis
+
+#endif // AEDIS_SYNC_HPP

tests/check.hpp

@@ -1,17 +0,0 @@
-/* Copyright (c) 2019 Marcelo Zimbres Silva (mzimbres@gmail.com)
- *
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-#include <iostream>
-
-template <class T>
-void check_equal(T const& a, T const& b, std::string const& msg = "")
-{
-   if (a == b)
-     std::cout << "Success: " << msg << std::endl;
-   else
-     std::cout << "Error: " << msg << std::endl;
-}

tests/connection.cpp

@@ -0,0 +1,491 @@
+/* Copyright (c) 2018-2022 Marcelo Zimbres Silva (mzimbres@gmail.com)
+ *
+ * Distributed under the Boost Software License, Version 1.0. (See
+ * accompanying file LICENSE.txt)
+ */
+
+// TODO: Avoid usage of co_await to improve tests is compilers that
+// don't support it.
+// TODO: Add reconnect test that kills the server and waits some
+// seconds.
+
+#include <iostream>
+#include <boost/asio.hpp>
+#include <boost/system/errc.hpp>
+#include <boost/asio/experimental/as_tuple.hpp>
+
+#define BOOST_TEST_MODULE low level
+#include <boost/test/included/unit_test.hpp>
+
+#include <aedis.hpp>
+#include <aedis/src.hpp>
+
+namespace net = boost::asio;
+
+using aedis::resp3::request;
+using aedis::adapt;
+using connection = aedis::connection<>;
+using error_code = boost::system::error_code;
+using net::experimental::as_tuple;
+
+bool is_host_not_found(boost::system::error_code ec)
+{
+   if (ec == net::error::netdb_errors::host_not_found) return true;
+   if (ec == net::error::netdb_errors::host_not_found_try_again) return true;
+   return false;
+}
+
+//----------------------------------------------------------------
+
+// Tests whether resolve fails with the correct error.
+BOOST_AUTO_TEST_CASE(test_resolve)
+{
+   connection::config cfg;
+   cfg.host = "Atibaia";
+   cfg.port = "6379";
+   cfg.resolve_timeout = std::chrono::seconds{100};
+
+   net::io_context ioc;
+   connection db{ioc, cfg};
+   db.async_run([](auto ec) {
+      BOOST_TEST(is_host_not_found(ec));
+   });
+
+   ioc.run();
+}
+
+//----------------------------------------------------------------
+
+BOOST_AUTO_TEST_CASE(test_connect)
+{
+   connection::config cfg;
+   cfg.host = "127.0.0.1";
+   cfg.port = "1";
+   cfg.connect_timeout = std::chrono::seconds{100};
+
+   net::io_context ioc;
+   connection db{ioc, cfg};
+   db.async_run([](auto ec) {
+      BOOST_CHECK_EQUAL(ec, net::error::basic_errors::connection_refused);
+   });
+   ioc.run();
+}
+
+//----------------------------------------------------------------
+
+// Test if quit causes async_run to exit.
+void test_quit1(connection::config const& cfg)
+{
+   net::io_context ioc;
+   auto db = std::make_shared<connection>(ioc, cfg);
+
+   request req;
+   req.push("QUIT");
+
+   db->async_exec(req, adapt(), [](auto ec, auto){
+      BOOST_TEST(!ec);
+   });
+
+   db->async_run([](auto ec){
+      BOOST_CHECK_EQUAL(ec, net::error::misc_errors::eof);
+   });
+
+   ioc.run();
+}
+
+void test_quit2(connection::config const& cfg)
+{
+   std::cout << "test_quit2" << std::endl;
+   request req;
+   req.push("QUIT");
+
+   net::io_context ioc;
+   auto db = std::make_shared<connection>(ioc, cfg);
+   db->async_run(req, adapt(), [](auto ec, auto){
+      BOOST_TEST(!ec);
+   });
+
+   ioc.run();
+}
+
+BOOST_AUTO_TEST_CASE(test_quit)
+{
+   connection::config cfg;
+
+   cfg.coalesce_requests = true;
+   test_quit1(cfg);
+
+   cfg.coalesce_requests = false;
+   test_quit1(cfg);
+
+   cfg.coalesce_requests = true;
+   test_quit2(cfg);
+
+   cfg.coalesce_requests = false;
+   test_quit2(cfg);
+}
+
+// Checks whether we get idle timeout when no push reader is set.
+void test_missing_push_reader1(connection::config const& cfg)
+{
+   std::cout << "test_missing_push_reader1" << std::endl;
+   net::io_context ioc;
+   auto db = std::make_shared<connection>(ioc, cfg);
+
+   request req;
+   req.push("SUBSCRIBE", "channel");
+
+   db->async_run(req, adapt(), [](auto ec, auto){
+      BOOST_TEST(!ec);
+   });
+
+   ioc.run();
+}
+
+void test_missing_push_reader2(connection::config const& cfg)
+{
+   std::cout << "test_missing_push_reader2" << std::endl;
+   net::io_context ioc;
+   auto db = std::make_shared<connection>(ioc, cfg);
+
+   request req; // Wrong command syntax.
+   req.push("SUBSCRIBE");
+
+   db->async_run(req, adapt(), [](auto ec, auto){
+      BOOST_TEST(!ec);
+   });
+
+   ioc.run();
+}
+
+void test_missing_push_reader3(connection::config const& cfg)
+{
+   std::cout << "test_missing_push_reader3" << std::endl;
+   net::io_context ioc;
+   auto db = std::make_shared<connection>(ioc, cfg);
+
+   request req; // Wrong command synthax.
+   req.push("PING", "Message");
+   req.push("SUBSCRIBE");
+
+   db->async_run(req, adapt(), [](auto ec, auto){
+      BOOST_TEST(!ec);
+   });
+
+   ioc.run();
+}
+
+BOOST_AUTO_TEST_CASE(test_idle)
+{
+   std::chrono::milliseconds ms{5000};
+
+   {
+      std::cout << "test_idle" << std::endl;
+      connection::config cfg;
+      cfg.resolve_timeout = std::chrono::seconds{1};
+      cfg.connect_timeout = std::chrono::seconds{1};
+      cfg.ping_interval = std::chrono::seconds{1};
+
+      net::io_context ioc;
+      auto db = std::make_shared<connection>(ioc, cfg);
+
+      request req;
+      req.push("CLIENT", "PAUSE", ms.count());
+
+      db->async_exec(req, adapt(), [](auto ec, auto){
+         BOOST_TEST(!ec);
+      });
+
+      db->async_run([](auto ec){
+         BOOST_CHECK_EQUAL(ec, aedis::error::idle_timeout);
+      });
+
+      ioc.run();
+   }
+
+   //----------------------------------------------------------------
+   // Since we have paused the server above, we have to wait until the
+   // server is responsive again, so as not to cause other tests to
+   // fail.
+
+   {
+      net::io_context ioc;
+      auto db = std::make_shared<connection>(ioc);
+      db->get_config().ping_interval = 2* ms;
+      db->get_config().resolve_timeout = 2 * ms;
+      db->get_config().connect_timeout = 2 * ms;
+      db->get_config().ping_interval = 2 * ms;
+
+      request req;
+      req.push("QUIT");
+
+      db->async_run(req, adapt(), [](auto ec, auto){
+         BOOST_TEST(!ec);
+      });
+
+      ioc.run();
+   }
+}
+
+#ifdef BOOST_ASIO_HAS_CO_AWAIT
+net::awaitable<void> push_consumer1(std::shared_ptr<connection> db, bool& push_received)
+{
+   {
+      auto [ec, ev] = co_await db->async_receive_push(adapt(), as_tuple(net::use_awaitable));
+      BOOST_TEST(!ec);
+   }
+
+   {
+      auto [ec, ev] = co_await db->async_receive_push(adapt(), as_tuple(net::use_awaitable));
+      BOOST_CHECK_EQUAL(ec, boost::asio::experimental::channel_errc::channel_cancelled);
+   }
+
+   push_received = true;
+}
+
+net::awaitable<void> event_consumer1(std::shared_ptr<connection> db, bool& event_received)
+{
+   {
+      auto [ec, ev] = co_await db->async_receive_event(as_tuple(net::use_awaitable));
+      auto const r = ev == connection::event::resolve;
+      BOOST_TEST(r);
+      BOOST_TEST(!ec);
+   }
+
+   {
+      auto [ec, ev] = co_await db->async_receive_event(as_tuple(net::use_awaitable));
+      auto const r = ev == connection::event::connect;
+      BOOST_TEST(r);
+      BOOST_TEST(!ec);
+   }
+
+   {
+      auto [ec, ev] = co_await db->async_receive_event(as_tuple(net::use_awaitable));
+      auto const r = ev == connection::event::hello;
+      BOOST_TEST(r);
+      BOOST_TEST(!ec);
+   }
+
+   {
+      auto [ec, ev] = co_await db->async_receive_event(as_tuple(net::use_awaitable));
+      BOOST_CHECK_EQUAL(ec, boost::asio::experimental::channel_errc::channel_cancelled);
+   }
+
+   event_received = true;
+}
+
+
+void test_push_is_received1(connection::config const& cfg)
+{
+   std::cout << "test_push_is_received1" << std::endl;
+   net::io_context ioc;
+   auto db = std::make_shared<connection>(ioc, cfg);
+   db->get_config().enable_events = true;
+
+   request req;
+   req.push("SUBSCRIBE", "channel");
+   req.push("QUIT");
+
+   db->async_run(req, adapt(), [db](auto ec, auto){
+      BOOST_TEST(!ec);
+      db->cancel(connection::operation::receive_event);
+      db->cancel(connection::operation::receive_push);
+   });
+
+   bool push_received = false;
+   net::co_spawn(
+      ioc.get_executor(),
+      push_consumer1(db, push_received),
+      net::detached);
+
+   bool event_received = false;
+   net::co_spawn(
+      ioc.get_executor(),
+      event_consumer1(db, event_received),
+      net::detached);
+
+   ioc.run();
+
+   BOOST_TEST(push_received);
+   BOOST_TEST(event_received);
+}
+
+void test_push_is_received2(connection::config const& cfg)
+{
+   request req1;
+   req1.push("PING", "Message1");
+
+   request req2;
+   req2.push("SUBSCRIBE", "channel");
+
+   request req3;
+   req3.push("PING", "Message2");
+   req3.push("QUIT");
+
+   net::io_context ioc;
+
+   auto db = std::make_shared<connection>(ioc, cfg);
+   db->get_config().enable_events = true;
+
+   auto handler =[](auto ec, auto...)
+   {
+      BOOST_TEST(!ec);
+   };
+
+   db->async_exec(req1, adapt(), handler);
+   db->async_exec(req2, adapt(), handler);
+   db->async_exec(req3, adapt(), handler);
+
+   db->async_run([db](auto ec, auto...) {
+      BOOST_CHECK_EQUAL(ec, net::error::misc_errors::eof);
+      db->cancel(connection::operation::receive_event);
+      db->cancel(connection::operation::receive_push);
+   });
+
+   bool push_received = false;
+   net::co_spawn(
+      ioc.get_executor(),
+      push_consumer1(db, push_received),
+      net::detached);
+
+   bool event_received = false;
+   net::co_spawn(
+      ioc.get_executor(),
+      event_consumer1(db, event_received),
+      net::detached);
+
+   ioc.run();
+
+   BOOST_TEST(push_received);
+   BOOST_TEST(event_received);
+}
+
+net::awaitable<void> test_reconnect_impl(std::shared_ptr<connection> db)
+{
+   request req;
+   req.push("QUIT");
+
+   for (auto i = 0;;) {
+      auto ev = co_await db->async_receive_event(net::use_awaitable);
+      auto const r1 = ev == connection::event::resolve;
+      BOOST_TEST(r1);
+
+      ev = co_await db->async_receive_event(net::use_awaitable);
+      auto const r2 = ev == connection::event::connect;
+      BOOST_TEST(r2);
+
+      ev = co_await db->async_receive_event(net::use_awaitable);
+      auto const r3 = ev == connection::event::hello;
+      BOOST_TEST(r3);
+
+      co_await db->async_exec(req, adapt(), net::use_awaitable);
+
+      // Test 5 reconnetions and returns.
+
+      ++i;
+      if (i == 5) {
+         db->get_config().enable_reconnect = false;
+         co_return;
+      }
+   }
+
+   co_return;
+}
+
+// Test whether the client works after a reconnect.
+void test_reconnect()
+{
+   std::cout << "Start: test_reconnect" << std::endl;
+   net::io_context ioc;
+   auto db = std::make_shared<connection>(ioc.get_executor());
+   db->get_config().enable_events = true;
+   db->get_config().enable_reconnect = true;
+   db->get_config().reconnect_interval = std::chrono::milliseconds{100};
+
+   net::co_spawn(ioc, test_reconnect_impl(db), net::detached);
+
+   db->async_run([](auto ec) {
+      BOOST_CHECK_EQUAL(ec, net::error::misc_errors::eof);
+   });
+
+   ioc.run();
+   std::cout << "End: test_reconnect()" << std::endl;
+}
+
+net::awaitable<void>
+push_consumer3(std::shared_ptr<connection> db)
+{
+   for (;;)
+      co_await db->async_receive_push(adapt(), net::use_awaitable);
+}
+
+// Test many subscribe requests.
+void test_push_many_subscribes(connection::config const& cfg)
+{
+   std::cout << "test_push_many_subscribes" << std::endl;
+   request req0;
+   req0.push("HELLO", 3);
+
+   request req1;
+   req1.push("PING", "Message1");
+
+   request req2;
+   req2.push("SUBSCRIBE", "channel");
+
+   request req3;
+   req3.push("QUIT");
+
+   auto handler =[](auto ec, auto...)
+   {
+      BOOST_TEST(!ec);
+   };
+
+   net::io_context ioc;
+   auto db = std::make_shared<connection>(ioc, cfg);
+   db->async_exec(req0, adapt(), handler);
+   db->async_exec(req1, adapt(), handler);
+   db->async_exec(req2, adapt(), handler);
+   db->async_exec(req2, adapt(), handler);
+   db->async_exec(req1, adapt(), handler);
+   db->async_exec(req2, adapt(), handler);
+   db->async_exec(req1, adapt(), handler);
+   db->async_exec(req2, adapt(), handler);
+   db->async_exec(req2, adapt(), handler);
+   db->async_exec(req1, adapt(), handler);
+   db->async_exec(req2, adapt(), handler);
+   db->async_exec(req3, adapt(), handler);
+
+   db->async_run([db](auto ec, auto...) {
+      BOOST_CHECK_EQUAL(ec, net::error::misc_errors::eof);
+      db->cancel(connection::operation::receive_push);
+   });
+
+   net::co_spawn(ioc.get_executor(), push_consumer3(db), net::detached);
+   ioc.run();
+}
+
+#endif
+
+BOOST_AUTO_TEST_CASE(test_push)
+{
+   connection::config cfg;
+
+   cfg.coalesce_requests = true;
+#ifdef BOOST_ASIO_HAS_CO_AWAIT
+   test_push_is_received1(cfg);
+   test_push_is_received2(cfg);
+   test_push_many_subscribes(cfg);
+#endif
+   test_missing_push_reader1(cfg);
+   test_missing_push_reader3(cfg);
+
+   cfg.coalesce_requests = false;
+#ifdef BOOST_ASIO_HAS_CO_AWAIT
+   test_push_is_received1(cfg);
+   test_push_is_received2(cfg);
+   test_push_many_subscribes(cfg);
+#endif
+   test_missing_push_reader2(cfg);
+   test_missing_push_reader3(cfg);
+}
+