couchbase 3.3.0 → 3.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac08a1f11e2a448331f8d900fdf83f919860e4dfb58e82446ad195e900fbc55f
-  data.tar.gz: 54ee4c666ad5d25ac1c859c87a6dedb4751782ec91ff31ad6d9e35c54b27539b
+  metadata.gz: 738d96522993c221d75dc83546dc6c9f5447309fbbe4969f6fb92719b0427e78
+  data.tar.gz: 5189c37096e7193f5756050a9713bd7d8f75acd8949e5afe2402fc1834ed538f
 SHA512:
-  metadata.gz: 5d4ff24a9812790153298add2dcbd4b0ba53a1faa92d1c893379ca524b39a153ee2b66a5f519d3df660a7146941b6854b1bfe461c9c413659a5a56df0df300d2
-  data.tar.gz: fe0431eb1a6b433035c9d947106d504ee44c788c29f0350368a2b9c53119c2fa3148bd7796094fff277dcfe42df3220f7bb6b49e70cdd11b09f9e1ef9409ba28
+  metadata.gz: 85632d1eea3c7139c246f80fadbe8135aacd4b550fdd49a0e33a98342846d39d7d1a7b45abd2d03f1ecbecb9fbdb3401d5ef16b2c52e4bfa3c08edcebfa976e3
+  data.tar.gz: 34202c48810d9ebc8c9930a1f860acafa9a97b4de8304a22e56fa811a9462f02a857d277fb3abf1572226244ed05aeaafd61d23689a74aad6cdae83c33669fca

data/README.md

@@ -3,8 +3,7 @@
 [![license](https://img.shields.io/github/license/couchbase/couchbase-ruby-client?color=brightgreen)](https://opensource.org/licenses/Apache-2.0)
 [![gem](https://img.shields.io/gem/v/couchbase?color=brightgreen)](https://rubygems.org/gems/couchbase)
 [![commits](https://img.shields.io/github/commits-since/couchbase/couchbase-ruby-client/latest?color=brightgreen)](https://github.com/couchbase/couchbase-ruby-client/commits/master)
-[![tests](https://img.shields.io/github/workflow/status/couchbase/couchbase-ruby-client/tests?label=tests)](https://github.com/couchbase/couchbase-ruby-client/actions?query=workflow%3Atests)
-[![linters](https://img.shields.io/github/workflow/status/couchbase/couchbase-ruby-client/linters?label=linters)](https://github.com/couchbase/couchbase-ruby-client/actions?query=workflow%3Alinters)
+[![linters](https://img.shields.io/github/actions/workflow/status/couchbase/couchbase-ruby-client/linters.yml?branch=main&label=linters)](https://github.com/couchbase/couchbase-ruby-client/actions?query=workflow%3Alinters)
 
 This repository contains the third generation of the official Couchbase SDK for Ruby (aka. SDKv3)
 
@@ -13,18 +12,18 @@ This repository contains the third generation of the official Couchbase SDK for
 If you find an issue, please file it in [our JIRA issue tracker](https://couchbase.com/issues/browse/RCBC). Also you are
 always welcome on [our forum](https://forums.couchbase.com/c/ruby-sdk) and [Discord](https://discord.com/invite/sQ5qbPZuTh).
 
-Please attach version information to ticket/post. To obtain this information use the following command:
+Please attach version information to the ticket/post. To obtain this information, use the following command:
 
     $ ruby -r couchbase -e 'p Couchbase::VERSION'
 
 ## Installation
 
-The library tested with the MRI 2.6, 2.7 and 3.0. Supported platforms are Linux and MacOS.
+The library has been tested with MRI 3.0, 3.1 and 3.2. Supported platforms are Linux and MacOS.
 
 Add this line to your application's Gemfile:
 
 ```ruby
-gem "couchbase", "3.3.0"
+gem "couchbase", "3.4.1"
 ```
 
 And then execute:
@@ -35,13 +34,13 @@ Or install it yourself as:
 
     $ gem install couchbase
 
-For some platforms we precompile binary packages. When, for some reason, binary package cannot be used, pass
-`--platform=ruby` to `gem install` command (or check `specific_platform` and `force_ruby_platform` options of Bundler).
-In latter case, see [Development](#development) section for build dependencies.
+For some platforms we precompile binary packages. When, for some reason, binary packages cannot be used, pass
+`--platform=ruby` to the `gem install` command (or check the `specific_platform` and `force_ruby_platform` options of Bundler).
+In latter case, see the [Development](#development) section for build dependencies.
 
 ## Usage
 
-Here is a basic steps demonstrating basic operations with data:
+Here are some basic steps demonstrating basic operations with data:
 
 ```ruby
 require "couchbase"
@@ -92,10 +91,35 @@ end
 After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive
 prompt that will allow you to experiment.
 
-Part of the library is written in C++, and requires both C and C++ compilers installed on the system. To configure build
-environment, it uses `cmake`. When these tools installed, the build process is easy:
+### Compiling
 
-    $ rake compile
+Part of the library is written in C++, and requires both C and C++ compilers installed on the system. To configure the build
+environment it uses `cmake`. When these tools are installed, the build process is easy:
+
+    $ bundle exec rake compile
+
+### Testing
+
+By default, a mock cluster is used for testing. If you wish to use a real cluster, you can define the
+`TEST_CONNECTION_STRING` environment variable (e.g. `TEST_CONNECTION_STRING=couchbase://localhost`). You might also need to set the values for the `TEST_USERNAME`, `TEST_PASSWORD`, and `TEST_BUCKET`
+ environment variables.
+
+To run the tests:
+
+    $ bundle exec rake test
+
+### Linting
+
+We use the [RuboCop linter](https://rubocop.org/). To run it:
+
+    $ bundle exec rubocop
+
+### Packaging
+
+To build and install the Ruby gem (where `VERSION` is the current version of the SDK):
+
+    $ gem build couchbase.gemspec
+    $ gem install couchbase-VERSION.snapshot.gem
 
 ## Generate Documentation
 
@@ -107,7 +131,7 @@ The following steps will generate API reference for selected git tag:
 
     $ rake doc
 
-Now the API reference is accessible using web browser (where `VERSION` is current version of the SDK)
+Now the API reference is accessible using a web browser (where `VERSION` is the current version of the SDK)
 
     $ firefox doc/couchbase-ruby-client-VERSION/index.html
 

data/ext/couchbase/CMakeLists.txt

@@ -3,22 +3,22 @@ cmake_minimum_required(VERSION 3.17)
 message(STATUS "CMake version ${CMAKE_VERSION}")
 
 set(couchbase_cxx_client_BUILD_NUMBER 0)
-if(DEFINED ENV{BUILD_NUMBER})
-  set(couchbase_cxx_client_BUILD_NUMBER $ENV{BUILD_NUMBER})
-endif()
-
-if(NOT DEFINED COUCHBASE_CXX_CLIENT_MASTER_PROJECT)
-  if(CMAKE_CURRENT_SOURCE_DIR STREQUAL CMAKE_SOURCE_DIR)
-    set(COUCHBASE_CXX_CLIENT_MASTER_PROJECT ON)
-  else()
-    set(COUCHBASE_CXX_CLIENT_MASTER_PROJECT OFF)
-  endif()
-endif()
+if (DEFINED ENV{BUILD_NUMBER})
+    set(couchbase_cxx_client_BUILD_NUMBER $ENV{BUILD_NUMBER})
+endif ()
+
+if (NOT DEFINED COUCHBASE_CXX_CLIENT_MASTER_PROJECT)
+    if (CMAKE_CURRENT_SOURCE_DIR STREQUAL CMAKE_SOURCE_DIR)
+        set(COUCHBASE_CXX_CLIENT_MASTER_PROJECT ON)
+    else ()
+        set(COUCHBASE_CXX_CLIENT_MASTER_PROJECT OFF)
+    endif ()
+endif ()
 
 project(
-  couchbase_cxx_client
-  VERSION "1.0.0.${couchbase_cxx_client_BUILD_NUMBER}"
-  LANGUAGES CXX C)
+        couchbase_cxx_client
+        VERSION "1.0.0.${couchbase_cxx_client_BUILD_NUMBER}"
+        LANGUAGES CXX C)
 message(STATUS "Couchbase C++ client ${couchbase_cxx_client_VERSION}")
 
 include(cmake/PreventInSourceBuilds.cmake)
@@ -46,97 +46,383 @@ include(cmake/Sanitizers.cmake)
 include(cmake/StaticAnalyzers.cmake)
 
 include(cmake/Backtrace.cmake)
+enable_sanitizers(project_options)
 
-if(COUCHBASE_CXX_CLIENT_MASTER_PROJECT)
-  set_project_warnings(project_warnings)
-  enable_sanitizers(project_options)
-endif()
+if (COUCHBASE_CXX_CLIENT_MASTER_PROJECT)
+    set_project_warnings(project_warnings)
+    if (WIN32)
+        add_definitions(-D_WIN32_WINNT=0x0601)
+    endif ()
+endif ()
 
 find_package(Threads REQUIRED)
 
 include(cmake/ThirdPartyDependencies.cmake)
 
 option(COUCHBASE_CXX_CLIENT_STATIC_STDLIB "Statically link C++ standard library" FALSE)
-if("${CMAKE_CXX_COMPILER_ID}" STREQUAL "GNU")
-  if(COUCHBASE_CXX_CLIENT_STATIC_STDLIB)
-    target_compile_options(project_options INTERFACE -static-libgcc -static-libstdc++)
-    target_link_libraries(project_options INTERFACE -static-libgcc -static-libstdc++)
-  endif()
-endif()
+if ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "GNU")
+    if (COUCHBASE_CXX_CLIENT_STATIC_STDLIB)
+        target_compile_options(project_options INTERFACE -static-libgcc -static-libstdc++)
+        target_link_libraries(project_options INTERFACE -static-libgcc -static-libstdc++)
+    endif ()
+endif ()
 
 include(cmake/OpenSSL.cmake)
 
 include(cmake/VersionInfo.cmake)
 
-add_subdirectory(couchbase/meta)
-add_subdirectory(couchbase/platform)
-add_subdirectory(couchbase/logger)
-add_subdirectory(couchbase/crypto)
-add_subdirectory(couchbase/sasl)
-add_subdirectory(couchbase/topology)
-add_subdirectory(couchbase/utils)
-add_subdirectory(couchbase/protocol)
-add_subdirectory(couchbase/io)
-add_subdirectory(couchbase/management)
-add_subdirectory(couchbase/operations)
-add_subdirectory(couchbase/tracing)
-add_subdirectory(couchbase/metrics)
-
-if(COUCHBASE_CXX_CLIENT_BUILD_SHARED)
-  add_library(couchbase_cxx_client SHARED couchbase/cluster.cxx couchbase/document_id.cxx couchbase/cluster_options.cxx)
-else()
-  add_library(couchbase_cxx_client STATIC couchbase/cluster.cxx couchbase/document_id.cxx couchbase/cluster_options.cxx)
-endif()
+add_subdirectory(core/meta)
+add_subdirectory(core/platform)
+add_subdirectory(core/logger)
+add_subdirectory(core/crypto)
+add_subdirectory(core/sasl)
+add_subdirectory(core/tracing)
+add_subdirectory(core/metrics)
+
+set(couchbase_cxx_client_FILES
+        core/agent.cxx
+        core/agent_config.cxx
+        core/agent_group.cxx
+        core/agent_group_config.cxx
+        core/analytics_query_options.cxx
+        core/bucket.cxx
+        core/cluster.cxx
+        core/cluster_agent.cxx
+        core/cluster_agent_config.cxx
+        core/cluster_options.cxx
+        core/collections_component.cxx
+        core/config_profile.cxx
+        core/core_sdk_shim.cxx
+        core/crud_component.cxx
+        core/dispatcher.cxx
+        core/document_id.cxx
+        core/free_form_http_request.cxx
+        core/key_value_config.cxx
+        core/n1ql_query_options.cxx
+        core/range_scan_options.cxx
+        core/range_scan_orchestrator.cxx
+        core/retry_orchestrator.cxx
+        core/scan_result.cxx
+        core/search_query_options.cxx
+        core/seed_config.cxx
+        core/view_query_options.cxx
+        core/error_context/key_value.cxx
+        core/management/analytics_link_azure_blob_external.cxx
+        core/management/analytics_link_couchbase_remote.cxx
+        core/management/analytics_link_s3_external.cxx
+        core/mcbp/big_endian.cxx
+        core/mcbp/buffer_writer.cxx
+        core/mcbp/codec.cxx
+        core/mcbp/command_code.cxx
+        core/mcbp/operation_consumer.cxx
+        core/mcbp/operation_queue.cxx
+        core/mcbp/packet.cxx
+        core/mcbp/queue_request.cxx
+        core/mcbp/server_duration.cxx
+        core/operations/document_analytics.cxx
+        core/operations/document_append.cxx
+        core/operations/document_decrement.cxx
+        core/operations/document_exists.cxx
+        core/operations/document_get.cxx
+        core/operations/document_get_and_lock.cxx
+        core/operations/document_get_and_touch.cxx
+        core/operations/document_get_projected.cxx
+        core/operations/document_increment.cxx
+        core/operations/document_insert.cxx
+        core/operations/document_lookup_in.cxx
+        core/operations/document_mutate_in.cxx
+        core/operations/document_prepend.cxx
+        core/operations/document_query.cxx
+        core/operations/document_remove.cxx
+        core/operations/document_replace.cxx
+        core/operations/document_search.cxx
+        core/operations/document_touch.cxx
+        core/operations/document_unlock.cxx
+        core/operations/document_upsert.cxx
+        core/operations/document_view.cxx
+        core/operations/http_noop.cxx
+        core/operations/management/analytics_dataset_create.cxx
+        core/operations/management/analytics_dataset_drop.cxx
+        core/operations/management/analytics_dataset_get_all.cxx
+        core/operations/management/analytics_dataverse_create.cxx
+        core/operations/management/analytics_dataverse_drop.cxx
+        core/operations/management/analytics_get_pending_mutations.cxx
+        core/operations/management/analytics_index_create.cxx
+        core/operations/management/analytics_index_drop.cxx
+        core/operations/management/analytics_index_get_all.cxx
+        core/operations/management/analytics_link_connect.cxx
+        core/operations/management/analytics_link_create.cxx
+        core/operations/management/analytics_link_disconnect.cxx
+        core/operations/management/analytics_link_drop.cxx
+        core/operations/management/analytics_link_get_all.cxx
+        core/operations/management/analytics_link_replace.cxx
+        core/operations/management/bucket_create.cxx
+        core/operations/management/bucket_describe.cxx
+        core/operations/management/bucket_drop.cxx
+        core/operations/management/bucket_flush.cxx
+        core/operations/management/bucket_get.cxx
+        core/operations/management/bucket_get_all.cxx
+        core/operations/management/bucket_update.cxx
+        core/operations/management/change_password.cxx
+        core/operations/management/cluster_describe.cxx
+        core/operations/management/cluster_developer_preview_enable.cxx
+        core/operations/management/collection_create.cxx
+        core/operations/management/collection_drop.cxx
+        core/operations/management/collections_manifest_get.cxx
+        core/operations/management/error_utils.cxx
+        core/operations/management/eventing_deploy_function.cxx
+        core/operations/management/eventing_drop_function.cxx
+        core/operations/management/eventing_get_all_functions.cxx
+        core/operations/management/eventing_get_function.cxx
+        core/operations/management/eventing_get_status.cxx
+        core/operations/management/eventing_pause_function.cxx
+        core/operations/management/eventing_resume_function.cxx
+        core/operations/management/eventing_undeploy_function.cxx
+        core/operations/management/eventing_upsert_function.cxx
+        core/operations/management/freeform.cxx
+        core/operations/management/group_drop.cxx
+        core/operations/management/group_get.cxx
+        core/operations/management/group_get_all.cxx
+        core/operations/management/group_upsert.cxx
+        core/operations/management/query_index_build.cxx
+        core/operations/management/query_index_create.cxx
+        core/operations/management/query_index_drop.cxx
+        core/operations/management/query_index_get_all.cxx
+        core/operations/management/query_index_get_all_deferred.cxx
+        core/operations/management/role_get_all.cxx
+        core/operations/management/scope_create.cxx
+        core/operations/management/scope_drop.cxx
+        core/operations/management/scope_get_all.cxx
+        core/operations/management/search_get_stats.cxx
+        core/operations/management/search_index_analyze_document.cxx
+        core/operations/management/search_index_control_ingest.cxx
+        core/operations/management/search_index_control_plan_freeze.cxx
+        core/operations/management/search_index_control_query.cxx
+        core/operations/management/search_index_drop.cxx
+        core/operations/management/search_index_get.cxx
+        core/operations/management/search_index_get_all.cxx
+        core/operations/management/search_index_get_documents_count.cxx
+        core/operations/management/search_index_get_stats.cxx
+        core/operations/management/search_index_upsert.cxx
+        core/operations/management/user_drop.cxx
+        core/operations/management/user_get.cxx
+        core/operations/management/user_get_all.cxx
+        core/operations/management/user_upsert.cxx
+        core/operations/management/view_index_drop.cxx
+        core/operations/management/view_index_get.cxx
+        core/operations/management/view_index_get_all.cxx
+        core/operations/management/view_index_upsert.cxx
+        core/operations/mcbp_noop.cxx
+        core/protocol/client_request.cxx
+        core/protocol/client_response.cxx
+        core/protocol/cmd_append.cxx
+        core/protocol/cmd_cluster_map_change_notification.cxx
+        core/protocol/cmd_decrement.cxx
+        core/protocol/cmd_get.cxx
+        core/protocol/cmd_get_and_lock.cxx
+        core/protocol/cmd_get_and_touch.cxx
+        core/protocol/cmd_get_cluster_config.cxx
+        core/protocol/cmd_get_collection_id.cxx
+        core/protocol/cmd_get_collections_manifest.cxx
+        core/protocol/cmd_get_error_map.cxx
+        core/protocol/cmd_get_meta.cxx
+        core/protocol/cmd_get_replica.cxx
+        core/protocol/cmd_hello.cxx
+        core/protocol/cmd_increment.cxx
+        core/protocol/cmd_insert.cxx
+        core/protocol/cmd_lookup_in.cxx
+        core/protocol/cmd_mutate_in.cxx
+        core/protocol/cmd_noop.cxx
+        core/protocol/cmd_observe_seqno.cxx
+        core/protocol/cmd_prepend.cxx
+        core/protocol/cmd_remove.cxx
+        core/protocol/cmd_replace.cxx
+        core/protocol/cmd_sasl_auth.cxx
+        core/protocol/cmd_sasl_list_mechs.cxx
+        core/protocol/cmd_sasl_step.cxx
+        core/protocol/cmd_select_bucket.cxx
+        core/protocol/cmd_touch.cxx
+        core/protocol/cmd_unlock.cxx
+        core/protocol/cmd_upsert.cxx
+        core/protocol/frame_info_utils.cxx
+        core/protocol/status.cxx
+        core/topology/configuration.cxx
+        core/utils/binary.cxx
+        core/utils/connection_string.cxx
+        core/utils/duration_parser.cxx
+        core/utils/json.cxx
+        core/utils/json_streaming_lexer.cxx
+        core/utils/mutation_token.cxx
+        core/utils/split_string.cxx
+        core/utils/url_codec.cxx
+        core/impl/analytics_error_category.cxx
+        core/impl/append.cxx
+        core/impl/best_effort_retry_strategy.cxx
+        core/impl/build_deferred_query_indexes.cxx
+        core/impl/collection_query_index_manager.cxx
+        core/impl/cluster.cxx
+        core/impl/common_error_category.cxx
+        core/impl/configuration_profiles_registry.cxx
+        core/impl/create_query_index.cxx
+        core/impl/decrement.cxx
+        core/impl/dns_srv_tracker.cxx
+        core/impl/drop_query_index.cxx
+        core/impl/exists.cxx
+        core/impl/expiry.cxx
+        core/impl/fail_fast_retry_strategy.cxx
+        core/impl/field_level_encryption_error_category.cxx
+        core/impl/get.cxx
+        core/impl/get_all_replicas.cxx
+        core/impl/get_and_lock.cxx
+        core/impl/get_and_touch.cxx
+        core/impl/get_all_query_indexes.cxx
+        core/impl/get_any_replica.cxx
+        core/impl/get_replica.cxx
+        core/impl/increment.cxx
+        core/impl/insert.cxx
+        core/impl/key_value_error_category.cxx
+        core/impl/lookup_in.cxx
+        core/impl/management_error_category.cxx
+        core/impl/mutate_in.cxx
+        core/impl/network_error_category.cxx
+        core/impl/observe_poll.cxx
+        core/impl/observe_seqno.cxx
+        core/impl/prepend.cxx
+        core/impl/query.cxx
+        core/impl/query_error_category.cxx
+        core/impl/remove.cxx
+        core/impl/replace.cxx
+        core/impl/retry_action.cxx
+        core/impl/retry_reason.cxx
+        core/impl/search_error_category.cxx
+        core/impl/streaming_json_lexter_error_category.cxx
+        core/impl/subdoc/array_add_unique.cxx
+        core/impl/subdoc/array_append.cxx
+        core/impl/subdoc/array_insert.cxx
+        core/impl/subdoc/array_prepend.cxx
+        core/impl/subdoc/count.cxx
+        core/impl/subdoc/counter.cxx
+        core/impl/subdoc/exists.cxx
+        core/impl/subdoc/get.cxx
+        core/impl/subdoc/insert.cxx
+        core/impl/subdoc/join_values.cxx
+        core/impl/subdoc/lookup_in_macro.cxx
+        core/impl/subdoc/lookup_in_specs.cxx
+        core/impl/subdoc/mutate_in_macro.cxx
+        core/impl/subdoc/mutate_in_specs.cxx
+        core/impl/subdoc/remove.cxx
+        core/impl/subdoc/replace.cxx
+        core/impl/subdoc/upsert.cxx
+        core/impl/touch.cxx
+        core/impl/transaction_error_category.cxx
+        core/impl/transaction_get_result.cxx
+        core/impl/transaction_op_error_category.cxx
+        core/impl/unlock.cxx
+        core/impl/upsert.cxx
+        core/impl/view_error_category.cxx
+        core/impl/watch_query_indexes.cxx
+        core/io/dns_config.cxx
+        core/io/http_parser.cxx
+        core/io/mcbp_message.cxx
+        core/io/mcbp_parser.cxx
+        core/io/mcbp_session.cxx
+        core/transactions/atr_cleanup_entry.cxx
+        core/transactions/atr_ids.cxx
+        core/transactions/attempt_context_impl.cxx
+        core/transactions/binary.cxx
+        core/transactions/exceptions.cxx
+        core/transactions/result.cxx
+        core/transactions/staged_mutation.cxx
+        core/transactions/utils.cxx
+        core/transactions/transaction_attempt.cxx
+        core/transactions/transaction_context.cxx
+        core/transactions/transaction_get_result.cxx
+        core/transactions/transaction_links.cxx
+        core/transactions/transaction_options.cxx
+        core/transactions/transactions.cxx
+        core/transactions/transactions_cleanup.cxx
+        core/transactions/transactions_config.cxx
+        core/transactions/uid_generator.cxx)
+
+if (COUCHBASE_CXX_CLIENT_BUILD_SHARED)
+    add_library(couchbase_cxx_client SHARED ${couchbase_cxx_client_FILES})
+else ()
+    add_library(couchbase_cxx_client STATIC ${couchbase_cxx_client_FILES})
+endif ()
 set_target_properties(couchbase_cxx_client PROPERTIES POSITION_INDEPENDENT_CODE ON)
-target_include_directories(couchbase_cxx_client PUBLIC ${PROJECT_SOURCE_DIR})
+target_include_directories(couchbase_cxx_client PUBLIC ${PROJECT_SOURCE_DIR} ${PROJECT_SOURCE_DIR}/private)
 target_include_directories(
-  couchbase_cxx_client SYSTEM
-  PUBLIC ${PROJECT_SOURCE_DIR}/third_party/asio/asio/include
-         ${PROJECT_SOURCE_DIR}/third_party/gsl/include
-         ${PROJECT_SOURCE_DIR}/third_party/json/external/PEGTL/include
-         ${PROJECT_SOURCE_DIR}/third_party/json/include
-         ${PROJECT_SOURCE_DIR}/third_party/cxx_function
-         ${PROJECT_SOURCE_DIR}/third_party/fmt/include
-         ${PROJECT_SOURCE_DIR}/third_party/spdlog/include)
+        couchbase_cxx_client SYSTEM
+        PUBLIC ${PROJECT_SOURCE_DIR}/third_party/asio/asio/include
+        ${PROJECT_SOURCE_DIR}/third_party/gsl/include
+        ${PROJECT_SOURCE_DIR}/third_party/http_parser/include
+        ${PROJECT_SOURCE_DIR}/third_party/json/external/PEGTL/include
+        ${PROJECT_SOURCE_DIR}/third_party/json/include
+        ${PROJECT_SOURCE_DIR}/third_party/cxx_function
+        ${PROJECT_SOURCE_DIR}/third_party/fmt/include
+        ${PROJECT_SOURCE_DIR}/third_party/expected/include
+        ${PROJECT_SOURCE_DIR}/third_party/spdlog/include)
 target_link_libraries(couchbase_cxx_client PRIVATE project_options project_warnings)
 
 include(cmake/DetectStandardFilesystem.cmake)
 couchbase_cxx_check_filesystem(
-  couchbase_cxx_client
-  "filesystem"
-  "std::filesystem"
-  "stdc++fs;c++fs"
-  STD_FILESYSTEM)
-if(STD_FILESYSTEM)
-  message(STATUS "Using std::filesystem")
-else()
-  message(FATAL_ERROR "Couchbase C++ Client requires C++17, including an implementation of std::filesystem.")
-endif()
+        couchbase_cxx_client
+        "filesystem"
+        "std::filesystem"
+        "stdc++fs;c++fs"
+        STD_FILESYSTEM)
+if (STD_FILESYSTEM)
+    message(STATUS "Using std::filesystem")
+else ()
+    message(FATAL_ERROR "Couchbase C++ Client requires C++17, including an implementation of std::filesystem.")
+endif ()
 
 target_link_libraries(
-  couchbase_cxx_client
-  PUBLIC fmt::fmt
-         spdlog::spdlog
-         couchbase_backtrace
-         couchbase_logger
-         couchbase_platform
-         couchbase_io
-         couchbase_meta
-         couchbase_crypto
-         couchbase_sasl
-         couchbase_topology
-         couchbase_utils
-         couchbase_protocol
-         couchbase_management
-         couchbase_operations
-         couchbase_operations_management
-         couchbase_tracing
-         couchbase_metrics)
-if(NOT COUCHBASE_CXX_CLIENT_POST_LINKED_OPENSSL)
-  target_link_libraries(couchbase_cxx_client PUBLIC OpenSSL::SSL OpenSSL::Crypto)
-endif()
+        couchbase_cxx_client
+        PUBLIC fmt::fmt
+        spdlog::spdlog
+        snappy
+        jsonsl
+        hdr_histogram_static
+        couchbase_backtrace
+        couchbase_logger
+        couchbase_platform
+        couchbase_meta
+        couchbase_crypto
+        couchbase_sasl
+        couchbase_tracing
+        couchbase_metrics)
+
+target_link_libraries(couchbase_cxx_client PRIVATE http_parser)
+if (WIN32)
+    target_link_libraries(couchbase_cxx_client PRIVATE iphlpapi)
+endif ()
+
+if (NOT COUCHBASE_CXX_CLIENT_POST_LINKED_OPENSSL)
+    if (TARGET PkgConfig::PKG_CONFIG_OPENSSL)
+        target_link_libraries(couchbase_cxx_client PUBLIC PkgConfig::PKG_CONFIG_OPENSSL)
+    else()
+        target_link_libraries(couchbase_cxx_client PUBLIC OpenSSL::SSL OpenSSL::Crypto)
+    endif()
+endif ()
 
 option(COUCHBASE_CXX_CLIENT_BUILD_TESTS "Build test programs" TRUE)
-if(COUCHBASE_CXX_CLIENT_BUILD_TESTS)
-  include(cmake/Testing.cmake)
-endif()
+if (COUCHBASE_CXX_CLIENT_BUILD_TESTS)
+    include(cmake/Testing.cmake)
+endif ()
+
+option(COUCHBASE_CXX_CLIENT_BUILD_DOCS "Build API documentation" TRUE)
+if (COUCHBASE_CXX_CLIENT_BUILD_DOCS)
+    include(cmake/Documentation.cmake)
+endif ()
+
+option(COUCHBASE_CXX_CLIENT_BUILD_EXAMPLES "Build example programs" TRUE)
+if (COUCHBASE_CXX_CLIENT_BUILD_EXAMPLES)
+    add_subdirectory(examples)
+endif ()
+
+option(COUCHBASE_CXX_CLIENT_BUILD_TOOLS "Build tools" TRUE)
+if (COUCHBASE_CXX_CLIENT_BUILD_TOOLS)
+    add_subdirectory(third_party/docopt)
+    add_subdirectory(tools)
+endif ()

data/ext/couchbase/cmake/CompilerWarnings.cmake

@@ -7,6 +7,7 @@ function(set_project_warnings project_name)
 
   set(MSVC_WARNINGS
       /W4 # Baseline reasonable warnings
+      /wd4189 # 'identifier': local variable is initialized but not referenced
       /wd4242 # 'identifier': conversion from 'type1' to 'type1', possible loss of data
       /wd4244 # 'identifier': conversion from 'type1' to 'type1', possible loss of data
       /w14254 # 'operator': conversion from 'type1:field_bits' to 'type2:field_bits', possible loss of data
@@ -32,10 +33,9 @@ function(set_project_warnings project_name)
       /permissive- # standards conformance mode for MSVC compiler.
   )
 
-  set(CLANG_WARNINGS
+  set(COMMON_WARNINGS
       -Wall
       -Wextra # reasonable and standard
-      -Wshadow # warn the user if a variable declaration shadows one from a parent context
       -Wnon-virtual-dtor # warn the user if a class with virtual functions has a non-virtual destructor. This helps
                          # catch hard to track down memory errors
       -Wold-style-cast # warn for c-style casts
@@ -54,12 +54,12 @@ function(set_project_warnings project_name)
       -Wno-compound-token-split-by-macro)
 
   if(WARNINGS_AS_ERRORS)
-    set(CLANG_WARNINGS ${CLANG_WARNINGS} -Werror)
+    set(COMMON_WARNINGS ${COMMON_WARNINGS} -Werror)
     set(MSVC_WARNINGS ${MSVC_WARNINGS} /WX)
   endif()
 
   set(GCC_WARNINGS
-      ${CLANG_WARNINGS}
+      ${COMMON_WARNINGS}
       -Wmisleading-indentation # warn if indentation implies blocks where blocks do not exist
       -Wduplicated-cond # warn if if / else chain has duplicated conditions
       -Wduplicated-branches # warn if if / else branches have duplicated code
@@ -67,12 +67,27 @@ function(set_project_warnings project_name)
       -Wuseless-cast # warn if you perform a cast to the same type
       -Wdeprecated-declarations # warn if [[deprecated]] elements being used
   )
+  set(CLANG_WARNINGS ${COMMON_WARNINGS} -Wshadow # warn the user if a variable declaration shadows one from a parent
+                                                 # context
+  )
 
   if(MSVC)
     set(PROJECT_WARNINGS ${MSVC_WARNINGS})
   elseif(CMAKE_CXX_COMPILER_ID MATCHES ".*Clang")
     set(PROJECT_WARNINGS ${CLANG_WARNINGS})
   elseif(CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
+    if(CMAKE_CXX_COMPILER_VERSION VERSION_GREATER_EQUAL "11.0.0"
+       AND NOT
+           CMAKE_BUILD_TYPE
+           STREQUAL
+           "Debug")
+      # One of the occurrences: https://github.com/chriskohlhoff/asio/pull/1176
+      set(GCC_WARNINGS
+          ${GCC_WARNINGS}
+          -Wno-error=null-dereference
+          -Wno-error=array-bounds
+          -Wno-error=stringop-overflow)
+    endif()
     set(PROJECT_WARNINGS ${GCC_WARNINGS})
   else()
     message(AUTHOR_WARNING "No compiler warnings set for '${CMAKE_CXX_COMPILER_ID}' compiler.")