CDRIVER-3364 expose transaction state for session

Author: alcaeus

src/libmongoc/doc/api.rst

@@ -52,6 +52,7 @@ API Reference
    mongoc_stream_tls_t
    mongoc_topology_description_t
    mongoc_transaction_opt_t
+   mongoc_transaction_state_t
    mongoc_update_flags_t
    mongoc_uri_t
    mongoc_version

src/libmongoc/doc/mongoc_client_session_get_transaction_state.rst

@@ -0,0 +1,24 @@
+:man_page: mongoc_client_session_get_transaction_state
+
+mongoc_client_session_get_transaction_state()
+=============================================
+
+Synopsis
+--------
+
+.. code-block:: c
+
+  mongoc_transaction_state_t
+  mongoc_client_session_get_transaction_state (const mongoc_client_session_t *session);
+
+Returns the current transaction state for this session.
+
+Parameters
+----------
+
+* ``session``: A :symbol:`mongoc_client_session_t`.
+
+Return
+------
+
+Returns a :symbol:`mongoc_transaction_state_t` that represents the current transaction state.

src/libmongoc/doc/mongoc_client_session_t.rst

@@ -29,6 +29,7 @@ Example
 
     mongoc_client_session_start_transaction
     mongoc_client_session_in_transaction
+    mongoc_client_session_get_transaction_state
     mongoc_client_session_commit_transaction
     mongoc_client_session_abort_transaction
     mongoc_client_session_advance_cluster_time

src/libmongoc/doc/mongoc_transaction_state_t.rst

@@ -0,0 +1,35 @@
+:man_page: mongoc_transaction_state_t
+
+mongoc_transaction_state_t
+==========================
+
+Constants for transaction states
+
+Synopsis
+--------
+
+.. code-block:: c
+
+  typedef enum {
+    MONGOC_TRANSACTION_NONE = 0,
+    MONGOC_TRANSACTION_STARTING = 1,
+    MONGOC_TRANSACTION_IN_PROGRESS = 2,
+    MONGOC_TRANSACTION_COMMITTED = 3,
+    MONGOC_TRANSACTION_ABORTED = 4,
+  } mongoc_transaction_state_t;
+
+Description
+-----------
+
+These constants describe the current transaction state of a session.
+
+Flag Values
+-----------
+
+==================================  =============================================================================
+MONGOC_TRANSACTION_NONE             There is no transaction in progress.
+MONGOC_TRANSACTION_STARTING         A transaction has been started, but no operation has been sent to the server.
+MONGOC_TRANSACTION_IN_PROGRESS      A transaction is in progress.
+MONGOC_TRANSACTION_COMMITTED        The transaction was committed.
+MONGOC_TRANSACTION_ABORTED          The transaction was aborted.
+==================================  =============================================================================

src/libmongoc/src/mongoc/mongoc-client-session-private.h

@@ -55,17 +55,17 @@ typedef struct _mongoc_server_session_t {
 } mongoc_server_session_t;
 
 typedef enum {
-   MONGOC_TRANSACTION_NONE,
-   MONGOC_TRANSACTION_STARTING,
-   MONGOC_TRANSACTION_IN_PROGRESS,
-   MONGOC_TRANSACTION_ENDING,
-   MONGOC_TRANSACTION_COMMITTED,
-   MONGOC_TRANSACTION_COMMITTED_EMPTY,
-   MONGOC_TRANSACTION_ABORTED,
-} mongoc_transaction_state_t;
+   MONGOC_INTERNAL_TRANSACTION_NONE,
+   MONGOC_INTERNAL_TRANSACTION_STARTING,
+   MONGOC_INTERNAL_TRANSACTION_IN_PROGRESS,
+   MONGOC_INTERNAL_TRANSACTION_ENDING,
+   MONGOC_INTERNAL_TRANSACTION_COMMITTED,
+   MONGOC_INTERNAL_TRANSACTION_COMMITTED_EMPTY,
+   MONGOC_INTERNAL_TRANSACTION_ABORTED,
+} mongoc_internal_transaction_state_t;
 
 typedef struct _mongoc_transaction_t {
-   mongoc_transaction_state_t state;
+   mongoc_internal_transaction_state_t state;
    mongoc_transaction_opt_t opts;
 } mongoc_transaction_t;