feat(library): allow building ActionStep outside of job (#1785)

Closes #1780.

Author: krzema12

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

@@ -1857,6 +1857,7 @@ public final class io/github/typesafegithub/workflows/dsl/JobBuilder : io/github
 	public final fun run ([Lkotlin/Unit;Ljava/lang/String;Ljava/util/Map;Ljava/lang/String;Ljava/lang/String;Lkotlin/jvm/functions/Function1;Ljava/lang/Boolean;Ljava/lang/Integer;Lio/github/typesafegithub/workflows/domain/Shell;Ljava/lang/String;Ljava/util/Map;Lkotlin/jvm/functions/Function1;)Lio/github/typesafegithub/workflows/domain/KotlinLogicStep;
 	public static synthetic fun run$default (Lio/github/typesafegithub/workflows/dsl/JobBuilder;[Lkotlin/Unit;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/Map;Ljava/lang/String;Ljava/lang/String;Ljava/lang/Boolean;Ljava/lang/Integer;Lio/github/typesafegithub/workflows/domain/Shell;Ljava/lang/String;Ljava/util/Map;ILjava/lang/Object;)Lio/github/typesafegithub/workflows/domain/CommandStep;
 	public static synthetic fun run$default (Lio/github/typesafegithub/workflows/dsl/JobBuilder;[Lkotlin/Unit;Ljava/lang/String;Ljava/util/Map;Ljava/lang/String;Ljava/lang/String;Lkotlin/jvm/functions/Function1;Ljava/lang/Boolean;Ljava/lang/Integer;Lio/github/typesafegithub/workflows/domain/Shell;Ljava/lang/String;Ljava/util/Map;Lkotlin/jvm/functions/Function1;ILjava/lang/Object;)Lio/github/typesafegithub/workflows/domain/KotlinLogicStep;
+	public final fun uses (Lio/github/typesafegithub/workflows/domain/ActionStep;)V
 	public final fun uses ([Lkotlin/Unit;Lio/github/typesafegithub/workflows/domain/actions/Action;Ljava/lang/String;Ljava/lang/String;Ljava/util/Map;Ljava/lang/String;Ljava/lang/String;Ljava/lang/Boolean;Ljava/lang/Integer;Ljava/util/Map;)Lio/github/typesafegithub/workflows/domain/ActionStep;
 	public static synthetic fun uses$default (Lio/github/typesafegithub/workflows/dsl/JobBuilder;[Lkotlin/Unit;Lio/github/typesafegithub/workflows/domain/actions/Action;Ljava/lang/String;Ljava/lang/String;Ljava/util/Map;Ljava/lang/String;Ljava/lang/String;Ljava/lang/Boolean;Ljava/lang/Integer;Ljava/util/Map;ILjava/lang/Object;)Lio/github/typesafegithub/workflows/domain/ActionStep;
 }

github-workflows-kt/build.gradle.kts

@@ -34,6 +34,7 @@ dependencies {
 
     // GitHub action bindings
     testImplementation("actions:checkout:v4")
+    testImplementation("actions:deploy-pages:v4")
     testImplementation("actions:setup-java:v4")
     testImplementation("actions:upload-artifact:v3")
     testImplementation("aws-actions:configure-aws-credentials:v4")

github-workflows-kt/src/main/kotlin/io/github/typesafegithub/workflows/dsl/JobBuilder.kt

@@ -200,5 +200,13 @@ public class JobBuilder<OUTPUT : JobOutputs>(
         return newStep
     }
 
+    /**
+     * Useful when you need to build your action step outside the job, then you can call this function to register the
+     * step in the job.
+     */
+    public fun <T : Action.Outputs> uses(actionStep: ActionStep<T>) {
+        job = job.copy(steps = job.steps + actionStep)
+    }
+
     public fun build(): Job<OUTPUT> = job
 }

github-workflows-kt/src/test/kotlin/io/github/typesafegithub/workflows/dsl/JobBuilderTest.kt

@@ -1,11 +1,15 @@
 package io.github.typesafegithub.workflows.dsl
 
 import io.github.typesafegithub.workflows.actions.actions.Checkout
+import io.github.typesafegithub.workflows.actions.actions.DeployPages
 import io.github.typesafegithub.workflows.actions.actions.SetupJava
 import io.github.typesafegithub.workflows.actions.actions.SetupJava.Distribution.Adopt
+import io.github.typesafegithub.workflows.domain.ActionStep
+import io.github.typesafegithub.workflows.domain.Environment
 import io.github.typesafegithub.workflows.domain.RunnerType
 import io.github.typesafegithub.workflows.domain.Workflow
 import io.github.typesafegithub.workflows.domain.triggers.Push
+import io.github.typesafegithub.workflows.dsl.expressions.expr
 import io.kotest.assertions.throwables.shouldThrow
 import io.kotest.core.spec.style.FunSpec
 import io.kotest.engine.spec.tempdir
@@ -209,4 +213,36 @@ class JobBuilderTest :
                 }
             }
         }
+
+        test("action output passed to environment") {
+            // When
+            var workflow: Workflow? = null
+            workflow(
+                name = "test",
+                on = listOf(Push()),
+                sourceFile = sourceTempFile,
+                useWorkflow = { workflow = it },
+            ) {
+                val deploymentStep =
+                    ActionStep(
+                        id = "deployment",
+                        name = "Deploy to GitHub Pages",
+                        action = DeployPages(),
+                    )
+                job(
+                    id = "deploy",
+                    runsOn = RunnerType.UbuntuLatest,
+                    environment =
+                        Environment(
+                            name = "github-pages",
+                            url = expr(deploymentStep.outputs.pageUrl),
+                        ),
+                ) {
+                    uses(actionStep = deploymentStep)
+                }
+            }
+
+            // Then
+            workflow!!.jobs[0].environment?.url shouldBe "${'$'}{{ steps.deployment.outputs.page_url }}"
+        }
     })