test: including official opencypher tck

engine/pom.xml

@@ -45,6 +45,8 @@
         <buildnumber-maven-plugin.version>3.3.0</buildnumber-maven-plugin.version>
         <antlr4.version>4.9.1</antlr4.version>
         <antlr4.visitor>true</antlr4.visitor>
+        <cucumber.version>7.22.1</cucumber.version>
+        <junit-platform-suite.version>6.0.2</junit-platform-suite.version>
     </properties>
 
     <build>
@@ -91,6 +93,21 @@
                     </execution>
                 </executions>
             </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-surefire-plugin</artifactId>
+                <configuration>
+                    <excludes>
+                        <exclude>**/tck/OpenCypherTCKRunner.java</exclude>
+                    </excludes>
+                    <!-- Exclude Cucumber engine from normal test runs to prevent
+                         auto-discovery of TCK feature files. Run TCK explicitly with:
+                         mvn test -Dtest=OpenCypherTCKRunner -DfailIfNoTests=false -->
+                    <excludeJUnit5Engines>
+                        <excludeJUnit5Engine>cucumber</excludeJUnit5Engine>
+                    </excludeJUnit5Engines>
+                </configuration>
+            </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-jar-plugin</artifactId>
@@ -187,5 +204,31 @@
             <version>1.37</version>
             <scope>test</scope>
         </dependency>
+
+        <!-- Cucumber for OpenCypher TCK -->
+        <dependency>
+            <groupId>io.cucumber</groupId>
+            <artifactId>cucumber-java</artifactId>
+            <version>${cucumber.version}</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>io.cucumber</groupId>
+            <artifactId>cucumber-junit-platform-engine</artifactId>
+            <version>${cucumber.version}</version>
+            <scope>test</scope>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.junit.platform</groupId>
+                    <artifactId>junit-platform-engine</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.platform</groupId>
+            <artifactId>junit-platform-suite</artifactId>
+            <version>${junit-platform-suite.version}</version>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
 </project>

engine/src/test/java/com/arcadedb/query/opencypher/tck/OpenCypherTCKRunner.java

@@ -0,0 +1,35 @@
+/*
+ * Copyright © 2021-present Arcade Data Ltd ([email protected])
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-FileCopyrightText: 2021-present Arcade Data Ltd ([email protected])
+ * SPDX-License-Identifier: Apache-2.0
+ */
+package com.arcadedb.query.opencypher.tck;
+
+import org.junit.platform.suite.api.ConfigurationParameter;
+import org.junit.platform.suite.api.IncludeEngines;
+import org.junit.platform.suite.api.SelectClasspathResource;
+import org.junit.platform.suite.api.Suite;
+
+import static io.cucumber.junit.platform.engine.Constants.GLUE_PROPERTY_NAME;
+import static io.cucumber.junit.platform.engine.Constants.PLUGIN_PROPERTY_NAME;
+
+@Suite
+@IncludeEngines("cucumber")
+@SelectClasspathResource("opencypher/tck/features")
+@ConfigurationParameter(key = GLUE_PROPERTY_NAME, value = "com.arcadedb.query.opencypher.tck")
+@ConfigurationParameter(key = PLUGIN_PROPERTY_NAME, value = "pretty, html:target/tck-report.html, com.arcadedb.query.opencypher.tck.TCKReportPlugin")
+public class OpenCypherTCKRunner {
+}

engine/src/test/java/com/arcadedb/query/opencypher/tck/TCKReportPlugin.java

@@ -0,0 +1,132 @@
+/*
+ * Copyright © 2021-present Arcade Data Ltd ([email protected])
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-FileCopyrightText: 2021-present Arcade Data Ltd ([email protected])
+ * SPDX-License-Identifier: Apache-2.0
+ */
+package com.arcadedb.query.opencypher.tck;
+
+import io.cucumber.plugin.ConcurrentEventListener;
+import io.cucumber.plugin.event.EventPublisher;
+import io.cucumber.plugin.event.TestCaseFinished;
+import io.cucumber.plugin.event.TestCaseStarted;
+import io.cucumber.plugin.event.TestRunFinished;
+
+import java.io.FileWriter;
+import java.io.IOException;
+import java.io.PrintWriter;
+import java.net.URI;
+import java.util.Map;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.atomic.AtomicInteger;
+
+/**
+ * Cucumber plugin that generates a summary compliance report for the OpenCypher TCK.
+ */
+public class TCKReportPlugin implements ConcurrentEventListener {
+
+  private final AtomicInteger totalScenarios = new AtomicInteger();
+  private final AtomicInteger passed = new AtomicInteger();
+  private final AtomicInteger failed = new AtomicInteger();
+  private final AtomicInteger skipped = new AtomicInteger();
+  private final Map<String, int[]> categoryStats = new ConcurrentHashMap<>();
+  // categoryStats value: [total, passed, failed, skipped]
+
+  @Override
+  public void setEventPublisher(final EventPublisher publisher) {
+    publisher.registerHandlerFor(TestCaseStarted.class, this::handleTestCaseStarted);
+    publisher.registerHandlerFor(TestCaseFinished.class, this::handleTestCaseFinished);
+    publisher.registerHandlerFor(TestRunFinished.class, this::handleTestRunFinished);
+  }
+
+  private void handleTestCaseStarted(final TestCaseStarted event) {
+    totalScenarios.incrementAndGet();
+  }
+
+  private void handleTestCaseFinished(final TestCaseFinished event) {
+    final String category = extractCategory(event.getTestCase().getUri());
+
+    final int[] stats = categoryStats.computeIfAbsent(category, k -> new int[4]);
+    stats[0]++;
+
+    switch (event.getResult().getStatus()) {
+    case PASSED:
+      passed.incrementAndGet();
+      stats[1]++;
+      break;
+    case FAILED:
+      failed.incrementAndGet();
+      stats[2]++;
+      break;
+    case SKIPPED:
+    case PENDING:
+    case AMBIGUOUS:
+    case UNDEFINED:
+      skipped.incrementAndGet();
+      stats[3]++;
+      break;
+    }
+  }
+
+  private void handleTestRunFinished(final TestRunFinished event) {
+    final int total = totalScenarios.get();
+    final int pass = passed.get();
+    final int fail = failed.get();
+    final int skip = skipped.get();
+
+    final StringBuilder sb = new StringBuilder();
+    sb.append("\n");
+    sb.append("=======================================================\n");
+    sb.append("         OpenCypher TCK Compliance Report\n");
+    sb.append("=======================================================\n");
+    sb.append(String.format("Total scenarios:  %d%n", total));
+    sb.append(String.format("Passed:           %d (%d%%)%n", pass, total > 0 ? pass * 100 / total : 0));
+    sb.append(String.format("Failed:           %d (%d%%)%n", fail, total > 0 ? fail * 100 / total : 0));
+    sb.append(String.format("Skipped:          %d (%d%%)%n", skip, total > 0 ? skip * 100 / total : 0));
+    sb.append("-------------------------------------------------------\n");
+    sb.append("By category:\n");
+
+    categoryStats.entrySet().stream().sorted(Map.Entry.comparingByKey()).forEach(entry -> {
+      final String cat = entry.getKey();
+      final int[] s = entry.getValue();
+      sb.append(String.format("  %-40s %3d/%3d passed (%d%%)%n", cat, s[1], s[0], s[0] > 0 ? s[1] * 100 / s[0] : 0));
+    });
+
+    sb.append("=======================================================\n");
+
+    System.out.println(sb);
+
+    // Write report to file
+    try (final PrintWriter writer = new PrintWriter(new FileWriter("target/tck-compliance-report.txt"))) {
+      writer.print(sb);
+    } catch (final IOException e) {
+      System.err.println("Failed to write TCK report: " + e.getMessage());
+    }
+  }
+
+  private String extractCategory(final URI uri) {
+    final String path = uri.toString();
+    // Extract category from path like: classpath:opencypher/tck/features/clauses/match/Match1.feature
+    final int featuresIdx = path.indexOf("features/");
+    if (featuresIdx < 0)
+      return "unknown";
+
+    final String relative = path.substring(featuresIdx + "features/".length());
+    final int lastSlash = relative.lastIndexOf('/');
+    if (lastSlash < 0)
+      return relative;
+    return relative.substring(0, lastSlash);
+  }
+}