info

Author: rcarver

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Ryan Carver
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,75 @@
+# swift-elasticsearch-query-builder
+
+Status: Experimental / In Progress
+
+A simple DSL to make it easier to construct Elasticsearch queries in Swift.
+
+## Goals
+
+* Builder Syntax supporting conditionals and loops
+* Simple typing system for scalar values
+* Doesn't try to define the whole syntax language, just enough to provide structure.
+
+## Examples
+
+Static
+
+```swift
+@ElasticsearchQueryBuilder 
+func build() -> some esb.QueryDSL {
+    esb.Query {
+        esb.Bool {
+            esb.Key("match_bool_prefix") {
+                [
+                    "message": "quick brown f"
+                ]
+            }
+        }
+    }
+    esb.Pagination.init(size: 20)
+}
+```
+
+Conditionals
+
+```swift
+@ElasticsearchQueryBuilder 
+func build(message: String?) -> some esb.QueryDSL {
+    esb.Query {
+        esb.Bool {
+            if let message { 
+                esb.Key("match") {
+                    [
+                        "message": .string(message)
+                    ]
+                }
+            }
+        }
+    }
+}
+```
+
+Loops
+
+```swift
+@ElasticsearchQueryBuilder 
+func build(messages: [String]) -> some esb.QueryDSL {
+    esb.Query {
+        esb.Bool {
+            esb.Should {
+                for message in messages {
+                    esb.Key("match") {
+                        [
+                            "message": .string(message)
+                        ]
+                    }
+                }
+            }
+        }
+    }
+}
+```
+
+## License
+
+This library is released under the MIT license. See LICENSE for details.

Tests/ElasticsearchQueryBuilderTests/ComponentTests.swift

@@ -45,15 +45,18 @@ final class KeyTests: XCTestCase {
 
 final class QueryTests: XCTestCase {
     func testBuild() throws {
-        @ElasticsearchQueryBuilder func build() -> some esb.QueryDSL {
-            esb.Query {
-                esb.Key("match_bool_prefix") {
-                    [
-                        "message": "quick brown f"
-                    ]
-                }
+@ElasticsearchQueryBuilder func build() -> some esb.QueryDSL {
+    esb.Query {
+        esb.Bool {
+            esb.Key("match_bool_prefix") {
+                [
+                    "message": "quick brown f"
+                ]
             }
         }
+    }
+    esb.Pagination.init(size: 20)
+}
         XCTAssertNoDifference(build().makeQuery(), [
             "query": [
                 "match_bool_prefix": [