feat: add support for step-level xray-test-case annotations

.gitignore

@@ -29,4 +29,3 @@ replay_pid*
 
 # Properties file which can have sensitive information
 *.properties
-

README.adoc

@@ -24,7 +24,7 @@ xray-test-env | No  | Yes | @xray-test-env=DEV,TST
 
 The associations can be done either with a normal gherkin tag, a tabular parameter, or both:
 
-By default a new execution will be created for however many groups of tests
+By default, a new execution will be created for however many groups of tests
 are extracted from the feature file. This is elaborated in more detail in the below feature
 file example, but the short answer is you will have a number of executions equal to  `[Distinct Test Plans] x
 [Distinct Test Environment Combinations]`
@@ -148,6 +148,16 @@ xray.api.url=https://xray.cloud.getxray.app/api/v2/authenticate
 
 `XrayAuth.fromPropertiesFile("src/test/resources/xray.properties")`
 
+[IMPORTANT]
+====
+To avoid accidentally publishing secrets to Git, run the following command:
+
+[source,bash]
+----
+git update-index --assume-unchanged src/test/resources/xray.properties
+----
+====
+
 ==== Xray Updater
 
 This is the thing that actually monitors your test execution and can

pom.xml

@@ -17,10 +17,10 @@ limitations under the License.
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.google.pdsl</groupId>
     <artifactId>pdsl-xray</artifactId>
-    <version>5.1.2</version>
+    <version>5.2.0-SNAPSHOT</version>
     <packaging>jar</packaging>
     <name>xray_pdsl</name>
-    <url>http://maven.apache.org</url>
+    <url>https://maven.apache.org</url>
     <description> Plugin to integrate the XRAY test management system with the Polymorphic DSL test framework. </description>
     <licenses>
         <license>
@@ -52,13 +52,14 @@ limitations under the License.
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <maven.compiler.source>21</maven.compiler.source>
         <maven.compiler.target>21</maven.compiler.target>
-        <mvn.jar.version>3.2.2</mvn.jar.version>
-        <antlr.version>4.9.1</antlr.version>
-        <maven.source.plugin.version>3.3.1</maven.source.plugin.version>
-        <maven.javadoc.plugin.version>3.7.0</maven.javadoc.plugin.version>
-        <maven.install.plugin.version>3.1.2</maven.install.plugin.version>
+        <antlr.version>4.13.2</antlr.version>
+        <pdsl.version>1.13.0</pdsl.version>
         <maven.deploy.plugin.version>3.1.2</maven.deploy.plugin.version>
         <maven.gpg.plugin.version>3.2.4</maven.gpg.plugin.version>
+        <maven.install.plugin.version>3.1.2</maven.install.plugin.version>
+        <maven.javadoc.plugin.version>3.7.0</maven.javadoc.plugin.version>
+        <maven.source.plugin.version>3.3.1</maven.source.plugin.version>
+        <mvn.jar.version>3.2.2</mvn.jar.version>
     </properties>
     <distributionManagement>
         <snapshotRepository>
@@ -100,7 +101,7 @@ limitations under the License.
         <dependency>
             <groupId>com.google.pdsl</groupId>
             <artifactId>pdsl</artifactId>
-            <version>1.11.1</version>
+            <version>${pdsl.version}</version>
         </dependency>
         <dependency>
             <groupId>org.antlr</groupId>
@@ -123,6 +124,11 @@ limitations under the License.
             <artifactId>plexus-cipher</artifactId>
             <version>1.7</version>
         </dependency>
+        <dependency>
+            <groupId>com.google.guava</groupId>
+            <artifactId>guava</artifactId>
+            <version>33.2.1-jre</version>
+        </dependency>
     </dependencies>
     <repositories>
         <repository>
@@ -136,7 +142,7 @@ limitations under the License.
         </repository>
         <repository>
             <id>artifact-registry</id>
-            <url> artifactregistry://us-central1-maven.pkg.dev/gfp-p-artifacts-hub-01/ar-maven-experimental </url>
+            <url>artifactregistry://us-central1-maven.pkg.dev/gfp-p-artifacts-hub-01/ar-maven-experimental</url>
             <releases>
                 <enabled>true</enabled>
             </releases>
@@ -224,6 +230,7 @@ limitations under the License.
                     <artifactId>antlr4-maven-plugin</artifactId>
                     <version>${antlr.version}</version>
                     <configuration>
+                        <sourceDirectory>src/test/antlr4</sourceDirectory>
                         <arguments>
                             <argumenent>-visitor</argumenent>
                         </arguments>

src/main/java/com/google/pdsl/xray/constants/StepStatus.java

@@ -0,0 +1,16 @@
+package com.google.pdsl.xray.constants;
+
+import java.util.Arrays;
+import java.util.List;
+
+public enum StepStatus {
+    EXECUTING,
+    FAILED,
+    BLOCKED,
+    PASSED,
+    TODO;
+
+    public static List<String> getStringStatuses() {
+        return Arrays.stream(values()).map(Enum::toString).toList();
+    }
+}

src/main/java/com/google/pdsl/xray/constants/XrayTestTag.java

@@ -0,0 +1,45 @@
+package com.google.pdsl.xray.constants;
+
+/**
+ * XrayTags enum representing the supported Xray tags with their prefix values.
+ */
+public enum XrayTestTag {
+
+    CASE("xray-test-case"),
+    ENV("xray-test-env"),
+    EXECUTION("xray-test-execution"),
+    PLAN("xray-test-plan");
+
+    // Defined locally within the enum
+    private static final String GHERKIN_TAG_PREFIX = "@";
+    private static final String GHERKIN_EQUAL = "=";
+
+    private final String value;
+
+    XrayTestTag(String value) {
+        this.value = value;
+    }
+
+    /**
+     * Gets the full Gherkin tag string including the prefix symbol.
+     *
+     * @return the complete tag string (e.g. "@xray-test-env=")
+     */
+    public String getTagValue() {
+        return GHERKIN_TAG_PREFIX + value + GHERKIN_EQUAL;
+    }
+
+    /**
+     * Wraps the tag value in angle brackets as an HTML or XML tag.
+     *
+     * @return the tag value wrapped in angle brackets (e.g., "<xray-test-case>")
+     */
+    public String toHtmlTag() {
+        return "<" + value + ">";
+    }
+
+    @Override
+    public String toString() {
+        return value;
+    }
+}