feat: add query language tests, some reamde extensions

Author: Matthias Zimmermann

CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.0a6] - 2025-11-10
+
+### Added Features
+- Switch to iterator pattern for query_entities
+
+### Other Changes
+- Add README sections for querying
+- Renamings and refactorings for the iterator approach
+- Add query tests for select, paging and query language
+
 ## [1.0.0a5] - 2025-11-05
 
 ### Added Features

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "arkiv-sdk"
-version = "1.0.0a5"
+version = "1.0.0a6"
 description = "Python SDK for Arkiv networks - Web3.py + Entities"
 readme = "README.md"
 requires-python = ">=3.10"

tests/test_query_language.py

@@ -3,8 +3,6 @@
 import logging
 import uuid
 
-import pytest
-
 from arkiv import Arkiv
 from arkiv.types import ATTRIBUTES, KEY, CreateOp, Operations, QueryOptions
 
@@ -254,22 +252,22 @@ def test_query_language_comparison_range(self, arkiv_client_http: Arkiv) -> None
         )
 
     # === IN Tests ===#
-    @pytest.mark.xfail(reason="IN operator not yet supported by query parser")
+    # @pytest.mark.xfail(reason="IN operator not yet supported by query parser")
     def test_query_language_in_type_list(self, arkiv_client_http: Arkiv) -> None:
         """Test IN condition: type in ('A', 'B')."""
         execute_query_test(
             arkiv_client_http,
             "IN Type A or B",
-            'type IN ("A", "B")',
+            'type IN ("A" "B")',
             [1, 2, 3, 4, 5, 6, 7, 8],
         )
 
-    @pytest.mark.xfail(reason="IN operator not yet supported by query parser")
+    # @pytest.mark.xfail(reason="IN operator not yet supported by query parser")
     def test_query_language_in_idx_list(self, arkiv_client_http: Arkiv) -> None:
         """Test IN condition: idx in (1, 3, 4)."""
         execute_query_test(
             arkiv_client_http,
-            "IN Idx 1, 3, 4",
-            "idx IN (1, 3, 4)",
+            "IN Idx 1, 3 or 4",
+            "idx IN (1 3 4)",
             [1, 3, 4, 5, 7, 8, 9, 11, 12],
         )