adding comments

Author: Saumya Garg

mssql_python/pybind/connection/connection.cpp

@@ -1,6 +1,10 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 
+// Implements the Connection class declared in connection.h.
+// This class wraps low-level ODBC operations like connect/disconnect,
+// transaction control, and autocommit configuration.
+
 #include "connection.h"
 #include <iostream>
 

mssql_python/pybind/connection/connection.h

@@ -6,24 +6,41 @@
 
 #include "ddbc_bindings.h"
 
+// Represents a single ODBC database connection.
+// Manages its own environment and connection handles.
+// Note: This class does NOT implement pooling logic directly.
+
 class Connection {
 public:
     Connection(const std::wstring& conn_str);
     ~Connection();
 
+    // Establish the connection using the stored connection string.
     SQLRETURN connect();
+
+    // Close the connection and free resources.
     SQLRETURN close();
+
+    // Commit the current transaction.
     SQLRETURN commit();
+
+    // Rollback the current transaction.
     SQLRETURN rollback();
+
+    // End the transaction with the specified completion type.
     SQLRETURN end_transaction(SQLSMALLINT completion_type);
+
+    // Enable or disable autocommit mode.
     SQLRETURN set_autocommit(bool value);
+
+    //  Check whether autocommit is enabled.
     bool get_autocommit() const;
 
 private:
 
-    std::wstring _conn_str;
-    SqlHandlePtr _env_handle;
-    SqlHandlePtr _dbc_handle;
+    std::wstring _conn_str;     // Connection string
+    SqlHandlePtr _env_handle;   // Environment handle
+    SqlHandlePtr _dbc_handle;   // Connection handle
 
     bool _autocommit = false;
     std::shared_ptr<Connection> _conn;