fix: Rename precondition. (#112)

Author: goloroden

README.md

@@ -105,19 +105,19 @@ written_events = await client.write_events(
 
 *Note that according to the CloudEvents standard, event IDs must be of type string.*
 
-#### Using the `isEventQlTrue` precondition
+#### Using the `isEventQlQueryTrue` precondition
 
-If you want to write events depending on an EventQL query, import the `IsEventQlTrue` class and pass it as a list of preconditions in the second argument:
+If you want to write events depending on an EventQL query, import the `IsEventQlQueryTrue` class and pass it as a list of preconditions in the second argument:
 
 ```python
-from eventsourcingdb import IsEventQlTrue
+from eventsourcingdb import IsEventQlQueryTrue
 
 written_events = await client.write_events(
   events = [
     # events
   ],
   preconditions = [
-    IsEventQlTrue('FROM e IN events WHERE e.type == "io.eventsourcingdb.library.book-borrowed" PROJECT INTO COUNT() < 10')
+    IsEventQlQueryTrue('FROM e IN events WHERE e.type == "io.eventsourcingdb.library.book-borrowed" PROJECT INTO COUNT() < 10')
   ],
 )
 ```

eventsourcingdb/__init__.py

@@ -10,7 +10,7 @@
 )
 from .read_event_types import EventType
 from .read_events import IfEventIsMissingDuringRead, Order, ReadEventsOptions, ReadFromLatestEvent
-from .write_events import IsEventQlTrue, IsSubjectOnEventId, IsSubjectPristine, Precondition
+from .write_events import IsEventQlQueryTrue, IsSubjectOnEventId, IsSubjectPristine, Precondition
 
 __all__ = [
     "Bound",
@@ -25,7 +25,7 @@
     "IfEventIsMissingDuringObserve",
     "IfEventIsMissingDuringRead",
     "InternalError",
-    "IsEventQlTrue",
+    "IsEventQlQueryTrue",
     "IsSubjectOnEventId",
     "IsSubjectPristine",
     "ObserveEventsOptions",

eventsourcingdb/write_events/__init__.py

@@ -1,7 +1,7 @@
-from .preconditions import IsEventQlTrue, IsSubjectOnEventId, IsSubjectPristine, Precondition
+from .preconditions import IsEventQlQueryTrue, IsSubjectOnEventId, IsSubjectPristine, Precondition
 
 __all__ = [
-    "IsEventQlTrue",
+    "IsEventQlQueryTrue",
     "IsSubjectOnEventId",
     "IsSubjectPristine",
     "Precondition",

eventsourcingdb/write_events/preconditions.py

@@ -29,12 +29,12 @@ def to_json(self) -> dict[str, Any]:
         }
 
 @dataclass
-class IsEventQlTrue(Precondition):
+class IsEventQlQueryTrue(Precondition):
     query: str
 
     def to_json(self) -> dict[str, Any]:
         return {
-            'type': 'isEventQlTrue',
+            'type': 'isEventQlQueryTrue',
             'payload': {
                 'query': self.query
             }

tests/test_write_events.py

@@ -1,7 +1,7 @@
 import pytest
 from aiohttp import ClientConnectorDNSError
 
-from eventsourcingdb import EventCandidate, IsEventQlTrue, IsSubjectOnEventId, IsSubjectPristine, ServerError
+from eventsourcingdb import EventCandidate, IsEventQlQueryTrue, IsSubjectOnEventId, IsSubjectPristine, ServerError
 
 from .conftest import TestData
 from .shared.database import Database
@@ -206,7 +206,7 @@ async def test_is_event_ql_true_precondition_works(
                     source=test_data.TEST_SOURCE_STRING, subject="/", type="com.foo.bar", data={}
                 )
             ],
-            [IsEventQlTrue("FROM e IN events PROJECT INTO COUNT() > 0")]
+            [IsEventQlQueryTrue("FROM e IN events PROJECT INTO COUNT() > 0")]
         )
 
     @staticmethod
@@ -235,7 +235,7 @@ async def test_is_event_ql_true_precondition_fails(
                         data={},
                     )
                 ],
-                [IsEventQlTrue("FROM e IN events PROJECT INTO COUNT() == 0")]
+                [IsEventQlQueryTrue("FROM e IN events PROJECT INTO COUNT() == 0")]
             )
 
     @staticmethod