CDRIVER-3821 implement versioned api

Author: samantharitter

src/libmongoc/CMakeLists.txt

@@ -534,6 +534,7 @@ set (SOURCES ${SOURCES}
    ${PROJECT_SOURCE_DIR}/src/mongoc/mongoc-read-concern.c
    ${PROJECT_SOURCE_DIR}/src/mongoc/mongoc-read-prefs.c
    ${PROJECT_SOURCE_DIR}/src/mongoc/mongoc-rpc.c
+   ${PROJECT_SOURCE_DIR}/src/mongoc/mongoc-server-api.c
    ${PROJECT_SOURCE_DIR}/src/mongoc/mongoc-server-description.c
    ${PROJECT_SOURCE_DIR}/src/mongoc/mongoc-server-stream.c
    ${PROJECT_SOURCE_DIR}/src/mongoc/mongoc-client-session.c
@@ -598,6 +599,7 @@ set (HEADERS
    ${PROJECT_SOURCE_DIR}/src/mongoc/mongoc-prelude.h
    ${PROJECT_SOURCE_DIR}/src/mongoc/mongoc-read-concern.h
    ${PROJECT_SOURCE_DIR}/src/mongoc/mongoc-read-prefs.h
+   ${PROJECT_SOURCE_DIR}/src/mongoc/mongoc-server-api.h
    ${PROJECT_SOURCE_DIR}/src/mongoc/mongoc-server-description.h
    ${PROJECT_SOURCE_DIR}/src/mongoc/mongoc-client-session.h
    ${PROJECT_SOURCE_DIR}/src/mongoc/mongoc-socket.h
@@ -993,6 +995,7 @@ set (test-libmongoc-sources
    ${PROJECT_SOURCE_DIR}/tests/test-mongoc-usleep.c
    ${PROJECT_SOURCE_DIR}/tests/test-mongoc-util.c
    ${PROJECT_SOURCE_DIR}/tests/test-mongoc-version.c
+   ${PROJECT_SOURCE_DIR}/tests/test-mongoc-versioned-api.c
    ${PROJECT_SOURCE_DIR}/tests/test-mongoc-with-transaction.c
    ${PROJECT_SOURCE_DIR}/tests/test-mongoc-write-commands.c
    ${PROJECT_SOURCE_DIR}/tests/test-mongoc-write-concern.c

src/libmongoc/doc/api.rst

@@ -45,6 +45,8 @@ API Reference
    mongoc_read_prefs_t
    mongoc_remove_flags_t
    mongoc_reply_flags_t
+   mongoc_server_api_t
+   mongoc_server_api_version_t
    mongoc_server_description_t
    mongoc_session_opt_t
    mongoc_socket_t

src/libmongoc/doc/mongoc_client_pool_set_server_api.rst

@@ -0,0 +1,28 @@
+:man_page: mongoc_client_pool_set_server_api
+
+mongoc_client_pool_set_server_api()
+===================================
+
+Synopsis
+--------
+
+.. code-block:: c
+
+  bool
+  mongoc_client_pool_set_server_api (mongoc_client_pool_t *pool,
+                                     const mongoc_server_api_t *api,
+                                     bson_error_t *error);
+
+Set the API version to use for clients created through ``pool``. Once the API version is set on a pool, it may not be changed to a new value. Attempting to do so will cause this method to fail and set ``error``.
+
+Parameters
+----------
+
+* ``pool``: A :symbol:`mongoc_client_pool_t`.
+* ``api``: A :symbol:`mongoc_server_api_t`.
+* ``error``: A :symbol:`bson_error_t`.
+
+Returns
+-------
+
+True if the version was successfully set, false if not. On failure, ``error`` will be set.

src/libmongoc/doc/mongoc_client_pool_t.rst

@@ -40,6 +40,7 @@ Example
     mongoc_client_pool_set_apm_callbacks
     mongoc_client_pool_set_appname
     mongoc_client_pool_set_error_api
+    mongoc_client_pool_set_server_api
     mongoc_client_pool_set_ssl_opts
     mongoc_client_pool_try_pop
 

src/libmongoc/doc/mongoc_client_set_server_api.rst

@@ -0,0 +1,28 @@
+:man_page: mongoc_client_set_server_api
+
+mongoc_client_set_server_api()
+==============================
+
+Synopsis
+--------
+
+.. code-block:: c
+
+  bool
+  mongoc_client_set_server_api (mongoc_client_t *client,
+                                const mongoc_server_api_t *api,
+                                bson_error_t *error);
+
+Set the API version to use for ``client``. Once the API version is set on a client, it may not be changed to a new value. Attempting to do so will cause this method to fail and set ``error``.
+
+Parameters
+----------
+
+* ``client``: A :symbol:`mongoc_client_t`.
+* ``api``: A :symbol:`mongoc_server_api_t`.
+* ``error``: A :symbol:`bson_error_t`.
+
+Returns
+-------
+
+True if the version was successfully set, false if not. On failure, ``error`` will be set.

src/libmongoc/doc/mongoc_client_t.rst

@@ -82,6 +82,7 @@ Example
     mongoc_client_set_error_api
     mongoc_client_set_read_concern
     mongoc_client_set_read_prefs
+    mongoc_client_set_server_api
     mongoc_client_set_ssl_opts
     mongoc_client_set_stream_initiator
     mongoc_client_set_write_concern

src/libmongoc/doc/mongoc_server_api_copy.rst

@@ -0,0 +1,24 @@
+:man_page: mongoc_server_api_copy
+
+mongoc_server_api_copy()
+========================
+
+Synopsis
+--------
+
+.. code-block:: c
+
+  mongoc_server_api_t *
+  mongoc_server_api_copy (const mongoc_server_api_t *api);
+
+Creates a deep copy of ``api``.
+
+Parameters
+----------
+
+* ``api``: A :symbol:`mongoc_server_api_t`.
+
+Returns
+-------
+
+Returns a newly allocated copy of ``api`` that must be freed with :symbol:`mongoc_server_api_destroy()` when no longer in use.

src/libmongoc/doc/mongoc_server_api_deprecation_errors.rst

@@ -0,0 +1,21 @@
+:man_page: mongoc_server_api_deprecation_errors
+
+mongoc_server_api_deprecation_errors()
+======================================
+
+Synopsis
+--------
+
+.. code-block:: c
+
+  void
+  mongoc_server_api_deprecation_errors (mongoc_server_api_t *api,
+                                        bool deprecation_errors);
+
+Set whether or not to error on commands that are deprecated in this API version.
+
+Parameters
+----------
+
+* ``api``: A :symbol:`mongoc_server_api_t`.
+* ``deprecation_errors``: Whether or not to error on commands that are deprecated.

src/libmongoc/doc/mongoc_server_api_destroy.rst

@@ -0,0 +1,14 @@
+:man_page: mongoc_server_api_destroy
+
+mongoc_server_api_destroy()
+===========================
+
+Synopsis
+--------
+
+.. code-block:: c
+
+  void
+  mongoc_server_api_destroy (mongoc_server_api_t *api);
+
+Free a :symbol:`mongoc_server_api_t`. Does nothing if ``api`` is NULL.

src/libmongoc/doc/mongoc_server_api_new.rst

@@ -0,0 +1,19 @@
+:man_page: mongoc_server_api_new
+
+mongoc_server_api_new()
+=======================
+
+Synopsis
+--------
+
+.. code-block:: c
+
+  mongoc_server_api_t *
+  mongoc_server_api_new (mongoc_server_api_version_t version);
+
+Create a struct to hold server API preferences.
+
+Returns
+-------
+
+A new ``mongoc_server_api_t`` you must free with :symbol:`mongoc_server_api_destroy`.