Type execute_query query arg as LiteralString (#923)

Author: robsdedude

CHANGELOG.md

@@ -3,8 +3,15 @@
 See also https://github.com/neo4j/neo4j-python-driver/wiki for more details.
 
 ## NEXT RELEASE
-- Renamed experimental `neo4j.RoutingControl.READERS` to `READ` and `WRITERS` to `WRITE`.
-- Renamed experimental `driver.query_bookmark_manager` to `execute_query_bookmark_manager`.
+- Renamed experimental `neo4j.RoutingControl.READERS` to `READ` and `WRITERS` to
+  `WRITE`.
+- Renamed experimental `driver.query_bookmark_manager` to
+  `execute_query_bookmark_manager`.
+- Query argument to experimental `driver.execute_query` not is typed
+  `LiteralString` instead of `str` to help mitigate accidental Cypher
+  injections. There are rare use-cases where a computed string is necessary.
+  Please use `# type: ignore`, or `typing.cast` to suppress the type checking in
+  those cases.
 
 
 ## Version 5.7

src/neo4j/_async/driver.py

@@ -565,7 +565,7 @@ async def close(self) -> None:
     @t.overload
     async def execute_query(
         self,
-        query_: str,
+        query_: te.LiteralString,
         parameters_: t.Optional[t.Dict[str, t.Any]] = None,
         routing_: T_RoutingControl = RoutingControl.WRITE,
         database_: t.Optional[str] = None,
@@ -584,7 +584,7 @@ async def execute_query(
     @t.overload
     async def execute_query(
         self,
-        query_: str,
+        query_: te.LiteralString,
         parameters_: t.Optional[t.Dict[str, t.Any]] = None,
         routing_: T_RoutingControl = RoutingControl.WRITE,
         database_: t.Optional[str] = None,
@@ -602,7 +602,7 @@ async def execute_query(
 
     async def execute_query(
         self,
-        query_: str,
+        query_: te.LiteralString,
         parameters_: t.Optional[t.Dict[str, t.Any]] = None,
         routing_: T_RoutingControl = RoutingControl.WRITE,
         database_: t.Optional[str] = None,

src/neo4j/_sync/driver.py

@@ -564,7 +564,7 @@ def close(self) -> None:
     @t.overload
     def execute_query(
         self,
-        query_: str,
+        query_: te.LiteralString,
         parameters_: t.Optional[t.Dict[str, t.Any]] = None,
         routing_: T_RoutingControl = RoutingControl.WRITE,
         database_: t.Optional[str] = None,
@@ -583,7 +583,7 @@ def execute_query(
     @t.overload
     def execute_query(
         self,
-        query_: str,
+        query_: te.LiteralString,
         parameters_: t.Optional[t.Dict[str, t.Any]] = None,
         routing_: T_RoutingControl = RoutingControl.WRITE,
         database_: t.Optional[str] = None,
@@ -601,7 +601,7 @@ def execute_query(
 
     def execute_query(
         self,
-        query_: str,
+        query_: te.LiteralString,
         parameters_: t.Optional[t.Dict[str, t.Any]] = None,
         routing_: T_RoutingControl = RoutingControl.WRITE,
         database_: t.Optional[str] = None,