more clear docstrings

Signed-off-by: varun-edachali-dbx <varun.edachali@databricks.com>

Author: varun-edachali-dbx

src/databricks/sql/backend/sea/models/requests.py

@@ -10,7 +10,7 @@
 
 @dataclass
 class StatementParameter:
-    """Parameter for a SQL statement."""
+    """Representation of a parameter for a SQL statement."""
 
     name: str
     value: Optional[str] = None
@@ -19,7 +19,7 @@ class StatementParameter:
 
 @dataclass
 class ExecuteStatementRequest:
-    """Request to execute a SQL statement."""
+    """Representation of a request to execute a SQL statement."""
 
     session_id: str
     statement: str
@@ -65,7 +65,7 @@ def to_dict(self) -> Dict[str, Any]:
 
 @dataclass
 class GetStatementRequest:
-    """Request to get information about a statement."""
+    """Representation of a request to get information about a statement."""
 
     statement_id: str
 
@@ -76,7 +76,7 @@ def to_dict(self) -> Dict[str, Any]:
 
 @dataclass
 class CancelStatementRequest:
-    """Request to cancel a statement."""
+    """Representation of a request to cancel a statement."""
 
     statement_id: str
 
@@ -87,7 +87,7 @@ def to_dict(self) -> Dict[str, Any]:
 
 @dataclass
 class CloseStatementRequest:
-    """Request to close a statement."""
+    """Representation of a request to close a statement."""
 
     statement_id: str
 

src/databricks/sql/backend/sea/models/responses.py

@@ -85,7 +85,7 @@ def _parse_result(data: Dict[str, Any]) -> ResultData:
 
 @dataclass
 class ExecuteStatementResponse:
-    """Response from executing a SQL statement."""
+    """Representation of the response from executing a SQL statement."""
 
     statement_id: str
     status: StatementStatus
@@ -105,7 +105,7 @@ def from_dict(cls, data: Dict[str, Any]) -> "ExecuteStatementResponse":
 
 @dataclass
 class GetStatementResponse:
-    """Response from getting information about a statement."""
+    """Representation of the response from getting information about a statement."""
 
     statement_id: str
     status: StatementStatus
@@ -125,7 +125,7 @@ def from_dict(cls, data: Dict[str, Any]) -> "GetStatementResponse":
 
 @dataclass
 class CreateSessionResponse:
-    """Response from creating a new session."""
+    """Representation of the response from creating a new session."""
 
     session_id: str