Flake ref output

.github/workflows/build.yaml

@@ -59,7 +59,7 @@ jobs:
           - nix-system: aarch64-darwin
             runner: macos-latest-xlarge
           - nix-system: x86_64-darwin
-            runner: macos-12
+            runner: macos-13-large
     steps:
       - uses: actions/checkout@v3
 

README.md

@@ -16,8 +16,12 @@ Although the `flakehub-push` Action requires little configuration, you may benef
 
 ## Integration
 
-This action sets the `flakeref` output to the exact name and version that was published.
-The flake reference can be used in subsequent steps or workflows as part of a deployment process.
+This action sets outputs for integrating into CD pipelines:
+
+- `flake_name` Name of the flake. Example: `DeterminateSystems/flakehub-push`
+- `flake_version` Name of the flake. Example: `0.1.99+rev-2075013a3f3544d45a96f4b35df4ed03cd53779c`
+- `flakeref_descriptive` A loose reference to this release. Depending on this reference will require at least this version, and will also resolve to newer releases. This output is not sufficient for deployment pipelines, use `flake_exact` instead. Example: `DeterminateSystems/flakehub-push/0.1.99+rev-2075013a3f3544d45a96f4b35df4ed03cd53779c`
+- `flake_exact` A precise reference that always resolves to this to this exact release. Example: `DeterminateSystems/flakehub-push/=0.1.99+rev-2075013a3f3544d45a96f4b35df4ed03cd53779c`
 
 ## More Information
 

src/main.rs

@@ -182,13 +182,27 @@ async fn execute() -> Result<std::process::ExitCode> {
         ctx.release_version
     );
 
-    if let Err(e) = github_actions::set_output(
-        "flakeref",
-        &format!("{}/{}", ctx.upload_name, ctx.release_version),
-    )
-    .await
-    {
-        tracing::warn!("Failed to set the `flakeref` output: {}", e);
+    let outputs = [
+        ("flake_name", &ctx.upload_name),
+        ("flake_version", &ctx.release_version),
+        (
+            "flakeref_descriptive",
+            &format!("{}/{}", ctx.upload_name, ctx.release_version),
+        ),
+        (
+            "flakeref_exact",
+            &format!("{}/={}", ctx.upload_name, ctx.release_version),
+        ),
+    ];
+    for (output_name, value) in outputs.into_iter() {
+        if let Err(e) = github_actions::set_output(output_name, value).await {
+            tracing::warn!(
+                "Failed to set the `{}` output to {}: {}",
+                output_name,
+                value,
+                e
+            );
+        }
     }
 
     Ok(ExitCode::SUCCESS)