feat(library): support getting uses string and YAML arguments as string (#1583) (#1590)

Fixes #1583

Author: Vampire

.github/workflows/end-to-end-tests.main.kts

@@ -8,10 +8,12 @@
 @file:DependsOn("actions:setup-java:v4")
 @file:DependsOn("actions:setup-python:v5")
 @file:DependsOn("gradle:actions__setup-gradle:v4")
+@file:DependsOn("Wandalen:wretry.action:v3")
 @file:OptIn(ExperimentalKotlinLogicStep::class)
 
 import io.github.typesafegithub.workflows.actions.actions.*
 import io.github.typesafegithub.workflows.actions.gradle.ActionsSetupGradle
+import io.github.typesafegithub.workflows.actions.wandalen.WretryAction
 import io.github.typesafegithub.workflows.annotations.ExperimentalKotlinLogicStep
 import io.github.typesafegithub.workflows.domain.JobOutputs
 import io.github.typesafegithub.workflows.domain.Mode
@@ -253,5 +255,21 @@ workflow(
                 echo ${expr { testJob1.outputs.scriptResult }}
             """.trimIndent(),
         )
+
+        val setupJava11And20 = SetupJava(
+            javaVersion = """
+                11
+                20
+            """.trimIndent(),
+            distribution = SetupJava.Distribution.Temurin,
+        )
+
+        uses(
+            name = "Setup Java 11 and 20",
+            action = WretryAction(
+                action = setupJava11And20.usesString,
+                with = setupJava11And20.yamlArgumentsString,
+            )
+        )
     }
 }

.github/workflows/end-to-end-tests.yaml

@@ -161,3 +161,13 @@ jobs:
         echo ${{ needs.test_job_1.outputs.scriptKey }}
         echo ${{ needs.test_job_1.outputs.scriptKey2 }}
         echo ${{ needs.test_job_1.outputs.scriptResult }}
+    - id: 'step-2'
+      name: 'Setup Java 11 and 20'
+      uses: 'Wandalen/wretry.action@v3'
+      with:
+        action: 'actions/setup-java@v4'
+        with: |
+          java-version: |-
+            11
+            20
+          distribution: 'temurin'

github-workflows-kt/api/github-workflows-kt.api

@@ -513,6 +513,8 @@ public final class io/github/typesafegithub/workflows/domain/Workflow : io/githu
 public abstract class io/github/typesafegithub/workflows/domain/actions/Action {
 	public fun <init> ()V
 	public abstract fun buildOutputObject (Ljava/lang/String;)Lio/github/typesafegithub/workflows/domain/actions/Action$Outputs;
+	public abstract fun getUsesString ()Ljava/lang/String;
+	public final fun getYamlArgumentsString ()Ljava/lang/String;
 	public abstract fun toYamlArguments ()Ljava/util/LinkedHashMap;
 }
 
@@ -583,18 +585,21 @@ public abstract class io/github/typesafegithub/workflows/domain/actions/DockerAc
 	public fun getActionHost ()Ljava/lang/String;
 	public fun getActionImage ()Ljava/lang/String;
 	public fun getActionTag ()Ljava/lang/String;
+	public fun getUsesString ()Ljava/lang/String;
 }
 
 public abstract class io/github/typesafegithub/workflows/domain/actions/LocalAction : io/github/typesafegithub/workflows/domain/actions/Action {
 	public fun <init> (Ljava/lang/String;)V
 	public fun getActionPath ()Ljava/lang/String;
+	public fun getUsesString ()Ljava/lang/String;
 }
 
 public abstract class io/github/typesafegithub/workflows/domain/actions/RegularAction : io/github/typesafegithub/workflows/domain/actions/Action {
 	public fun <init> (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)V
 	public fun getActionName ()Ljava/lang/String;
 	public fun getActionOwner ()Ljava/lang/String;
 	public fun getActionVersion ()Ljava/lang/String;
+	public fun getUsesString ()Ljava/lang/String;
 }
 
 public final class io/github/typesafegithub/workflows/domain/contexts/Contexts {

github-workflows-kt/src/main/kotlin/io/github/typesafegithub/workflows/domain/actions/Action.kt

@@ -1,13 +1,16 @@
 package io.github.typesafegithub.workflows.domain.actions
 
 import io.github.typesafegithub.workflows.domain.actions.Action.Outputs
+import io.github.typesafegithub.workflows.yaml.toYaml
 
 public abstract class Action<out OUTPUTS : Outputs> {
     public abstract fun toYamlArguments(): LinkedHashMap<String, String>
 
+    public val yamlArgumentsString: String get() = toYamlArguments().toYaml()
+
     public abstract fun buildOutputObject(stepId: String): OUTPUTS
 
-    internal abstract val usesString: String
+    public abstract val usesString: String
 
     public open class Outputs(
         private val stepId: String,
@@ -21,14 +24,14 @@ public abstract class RegularAction<out OUTPUTS : Outputs>(
     public open val actionName: String,
     public open val actionVersion: String,
 ) : Action<OUTPUTS>() {
-    override val usesString
+    override val usesString: String
         get() = "$actionOwner/$actionName@$actionVersion"
 }
 
 public abstract class LocalAction<out OUTPUTS : Outputs>(
     public open val actionPath: String,
 ) : Action<OUTPUTS>() {
-    override val usesString
+    override val usesString: String
         get() = actionPath
 }
 
@@ -37,6 +40,6 @@ public abstract class DockerAction<out OUTPUTS : Outputs>(
     public open val actionTag: String,
     public open val actionHost: String? = null,
 ) : Action<OUTPUTS>() {
-    override val usesString
+    override val usesString: String
         get() = "docker://${if (actionHost == null) "" else "$actionHost/"}$actionImage:$actionTag"
 }