Default branch checkout option

__test__/git-auth-helper.test.ts

@@ -813,8 +813,7 @@ async function setup(testName: string): Promise<void> {
     nestedSubmodules: false,
     persistCredentials: true,
     ref: 'refs/heads/main',
-    defaultRefOnError: true,
+    defaultBranchCheckout: false,
-    defaultBranch: 'main',
     repositoryName: 'my-repo',
     repositoryOwner: 'my-org',
     repositoryPath: '',

dist/index.js

@@ -1226,17 +1226,6 @@ function getSource(settings) {
             core.startGroup('Setting up auth');
             yield authHelper.configureAuth();
             core.endGroup();
-            if (settings.defaultRefOnError && settings.defaultRefOnError === true) {
-                // Configure default branch
-                core.startGroup('Setting up default branch');
-                if (settings.sshKey) {
-                    settings.defaultBranch = yield git.getDefaultBranch(repositoryUrl);
-                }
-                else {
-                    settings.defaultBranch = yield githubApiHelper.getDefaultBranch(settings.authToken, settings.repositoryOwner, settings.repositoryName);
-                }
-                core.endGroup();
-            }
             // Determine the default branch
             if (!settings.ref && !settings.commit) {
                 core.startGroup('Determining the default branch');
@@ -1261,8 +1250,7 @@ function getSource(settings) {
             else if (settings.sparseCheckout) {
                 fetchOptions.filter = 'blob:none';
             }
-            if (settings.fetchDepth <= 0 ||
+            if (settings.fetchDepth <= 0 || settings.defaultBranchCheckout) {
-                (settings.defaultRefOnError && settings.defaultRefOnError === true)) {
                 // Fetch all branches and tags
                 let refSpec = refHelper.getRefSpecForAllHistory(settings.ref, settings.commit);
                 yield git.fetch(refSpec, fetchOptions);
@@ -1283,18 +1271,21 @@ function getSource(settings) {
             // Checkout info
             core.startGroup('Determining the checkout info');
             let checkoutInfo;
-            if (settings.defaultRefOnError && settings.defaultRefOnError === true) {
+            try {
-                try {
-                    checkoutInfo = yield refHelper.getCheckoutInfo(git, settings.ref, settings.commit);
-                }
-                catch (error) {
-                    core.info('Could not determine the checkout info. Trying the default repo branch');
-                    checkoutInfo = yield refHelper.getCheckoutInfo(git, settings.defaultBranch, settings.commit);
-                }
-            }
-            else {
                 checkoutInfo = yield refHelper.getCheckoutInfo(git, settings.ref, settings.commit);
             }
+            catch (error) {
+                if (settings.defaultBranchCheckout) {
+                    core.info('Could not determine the checkout info. Trying the default repository branch');
+                    const repositoryDefaultBranch = settings.sshKey
+                        ? yield git.getDefaultBranch(repositoryUrl)
+                        : yield githubApiHelper.getDefaultBranch(settings.authToken, settings.repositoryOwner, settings.repositoryName);
+                    checkoutInfo = yield refHelper.getCheckoutInfo(git, repositoryDefaultBranch, settings.commit);
+                }
+                else {
+                    throw error;
+                }
+            }
             core.endGroup();
             // LFS fetch
             // Explicit lfs-fetch to avoid slow checkout (fetches one lfs object at a time).
@@ -1748,10 +1739,10 @@ function getInputs() {
         }
         core.debug(`ref = '${result.ref}'`);
         core.debug(`commit = '${result.commit}'`);
-        // Default ref on error
+        // Default branch checkout
-        result.defaultRefOnError =
+        result.defaultBranchCheckout =
-            (core.getInput('default-ref-on-error') || 'true').toUpperCase() === 'TRUE';
+            (core.getInput('default-branch-checkout') || 'true').toUpperCase() === 'TRUE';
-        core.debug(`default-ref-on-error = '${result.defaultRefOnError}'`);
+        core.debug(`default-branch-checkout = '${result.defaultBranchCheckout}'`);
         // Clean
         result.clean = (core.getInput('clean') || 'true').toUpperCase() === 'TRUE';
         core.debug(`clean = ${result.clean}`);

src/git-source-provider.ts

@@ -130,21 +130,6 @@ export async function getSource(settings: IGitSourceSettings): Promise<void> {
     await authHelper.configureAuth()
     core.endGroup()
 
-    if (settings.defaultRefOnError && settings.defaultRefOnError === true) {
-      // Configure default branch
-      core.startGroup('Setting up default branch')
-      if (settings.sshKey) {
-        settings.defaultBranch = await git.getDefaultBranch(repositoryUrl)
-      } else {
-        settings.defaultBranch = await githubApiHelper.getDefaultBranch(
-          settings.authToken,
-          settings.repositoryOwner,
-          settings.repositoryName
-        )
-      }
-      core.endGroup()
-    }
-
     // Determine the default branch
     if (!settings.ref && !settings.commit) {
       core.startGroup('Determining the default branch')
@@ -181,10 +166,7 @@ export async function getSource(settings: IGitSourceSettings): Promise<void> {
       fetchOptions.filter = 'blob:none'
     }
 
-    if (
+    if (settings.fetchDepth <= 0 || settings.defaultBranchCheckout) {
-      settings.fetchDepth <= 0 ||
-      (settings.defaultRefOnError && settings.defaultRefOnError === true)
-    ) {
       // Fetch all branches and tags
       let refSpec = refHelper.getRefSpecForAllHistory(
         settings.ref,
@@ -209,29 +191,32 @@ export async function getSource(settings: IGitSourceSettings): Promise<void> {
     // Checkout info
     core.startGroup('Determining the checkout info')
     let checkoutInfo: refHelper.ICheckoutInfo
-    if (settings.defaultRefOnError && settings.defaultRefOnError === true) {
+    try {
-      try {
-        checkoutInfo = await refHelper.getCheckoutInfo(
-          git,
-          settings.ref,
-          settings.commit
-        )
-      } catch (error) {
-        core.info(
-          'Could not determine the checkout info. Trying the default repo branch'
-        )
-        checkoutInfo = await refHelper.getCheckoutInfo(
-          git,
-          settings.defaultBranch,
-          settings.commit
-        )
-      }
-    } else {
       checkoutInfo = await refHelper.getCheckoutInfo(
         git,
         settings.ref,
         settings.commit
       )
+    } catch (error) {
+      if (settings.defaultBranchCheckout) {
+        core.info(
+          'Could not determine the checkout info. Trying the default repository branch'
+        )
+        const repositoryDefaultBranch = settings.sshKey
+          ? await git.getDefaultBranch(repositoryUrl)
+          : await githubApiHelper.getDefaultBranch(
+              settings.authToken,
+              settings.repositoryOwner,
+              settings.repositoryName
+            )
+        checkoutInfo = await refHelper.getCheckoutInfo(
+          git,
+          repositoryDefaultBranch,
+          settings.commit
+        )
+      } else {
+        throw error
+      }
     }
     core.endGroup()
 

src/git-source-settings.ts

@@ -20,14 +20,9 @@ export interface IGitSourceSettings {
   ref: string
 
   /**
-   * Whether to checkout the default repository branch if specified ref does not exist.
+   * Indicates whether to checkout the default repository branch if the requested ref does not exist
    */
-  defaultRefOnError: boolean
+  defaultBranchCheckout: boolean
-
-  /**
-   * The target ref to fetch if it exists
-   */
-  defaultBranch: string
 
   /**
    * The commit to checkout

src/input-helper.ts

@@ -78,10 +78,11 @@ export async function getInputs(): Promise<IGitSourceSettings> {
   core.debug(`ref = '${result.ref}'`)
   core.debug(`commit = '${result.commit}'`)
 
-  // Default ref on error
+  // Default branch checkout
-  result.defaultRefOnError =
+  result.defaultBranchCheckout =
-    (core.getInput('default-ref-on-error') || 'true').toUpperCase() === 'TRUE'
+    (core.getInput('default-branch-checkout') || 'true').toUpperCase() ===
-  core.debug(`default-ref-on-error = '${result.defaultRefOnError}'`)
+    'TRUE'
+  core.debug(`default-branch-checkout = '${result.defaultBranchCheckout}'`)
 
   // Clean
   result.clean = (core.getInput('clean') || 'true').toUpperCase() === 'TRUE'