Add string[] option to submodules

Allows checking out only specific submodules instead of all

Author: Maddimax

.github/workflows/test.yml

@@ -154,6 +154,16 @@ jobs:
           submodules: true
       - name: Verify submodules true
         run: __test__/verify-submodules-true.sh
+  
+      # Submodules limited
+      - name: Checkout submodules true
+        uses: ./
+        with:
+          ref: test-data/v2/submodule-ssh-url
+          path: submodules-true
+          submodules: submodule-level-1
+      - name: Verify submodules true
+        run: __test__/verify-submodules-true.sh
 
       # Submodules recursive
       - name: Checkout submodules recursive

README.md

@@ -108,7 +108,8 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
     lfs: ''
 
     # Whether to checkout submodules: `true` to checkout submodules or `recursive` to
-    # recursively checkout submodules.
+    # recursively checkout submodules. Provide a list to specify which submodules to
+    # check out.
     #
     # When the `ssh-key` input is not provided, SSH URLs beginning with
     # `git@github.com:` are converted to HTTPS.

action.yml

@@ -87,6 +87,7 @@ inputs:
     description: >
       Whether to checkout submodules: `true` to checkout submodules or `recursive` to
       recursively checkout submodules.
+      Provide a list to specify which submodules to check out.
 
 
       When the `ssh-key` input is not provided, SSH URLs beginning with `git@github.com:` are

dist/index.js

@@ -795,17 +795,32 @@ class GitCommandManager {
             yield this.execGit(args);
         });
     }
-    submoduleUpdate(fetchDepth, recursive) {
+    submoduleUpdate(fetchDepth, recursive, submodules) {
         return __awaiter(this, void 0, void 0, function* () {
-            const args = ['-c', 'protocol.version=2'];
-            args.push('submodule', 'update', '--init', '--force');
-            if (fetchDepth > 0) {
-                args.push(`--depth=${fetchDepth}`);
+            if (Array.isArray(submodules)) {
+                for (const submodule of submodules) {
+                    const args = ['-c', 'protocol.version=2'];
+                    args.push('submodule', 'update', '--init', '--force', submodule);
+                    if (fetchDepth > 0) {
+                        args.push(`--depth=${fetchDepth}`);
+                    }
+                    if (recursive) {
+                        args.push('--recursive');
+                    }
+                    yield this.execGit(args);
+                }
             }
-            if (recursive) {
-                args.push('--recursive');
+            else {
+                const args = ['-c', 'protocol.version=2'];
+                args.push('submodule', 'update', '--init', '--force');
+                if (fetchDepth > 0) {
+                    args.push(`--depth=${fetchDepth}`);
+                }
+                if (recursive) {
+                    args.push('--recursive');
+                }
+                yield this.execGit(args);
             }
-            yield this.execGit(args);
         });
     }
     submoduleStatus() {
@@ -1342,7 +1357,7 @@ function getSource(settings) {
                 // Checkout submodules
                 core.startGroup('Fetching submodules');
                 yield git.submoduleSync(settings.nestedSubmodules);
-                yield git.submoduleUpdate(settings.fetchDepth, settings.nestedSubmodules);
+                yield git.submoduleUpdate(settings.fetchDepth, settings.nestedSubmodules, settings.submodules);
                 yield git.submoduleForeach('git config --local gc.auto 0', settings.nestedSubmodules);
                 core.endGroup();
                 // Persist credentials

src/git-command-manager.ts

@@ -54,7 +54,11 @@ export interface IGitCommandManager {
   shaExists(sha: string): Promise<boolean>
   submoduleForeach(command: string, recursive: boolean): Promise<string>
   submoduleSync(recursive: boolean): Promise<void>
-  submoduleUpdate(fetchDepth: number, recursive: boolean): Promise<void>
+  submoduleUpdate(
+    fetchDepth: number,
+    recursive: boolean,
+    submodules: boolean | string[]
+  ): Promise<void>
   submoduleStatus(): Promise<boolean>
   tagExists(pattern: string): Promise<boolean>
   tryClean(): Promise<boolean>
@@ -409,18 +413,38 @@ class GitCommandManager {
     await this.execGit(args)
   }
 
-  async submoduleUpdate(fetchDepth: number, recursive: boolean): Promise<void> {
-    const args = ['-c', 'protocol.version=2']
-    args.push('submodule', 'update', '--init', '--force')
-    if (fetchDepth > 0) {
-      args.push(`--depth=${fetchDepth}`)
-    }
+  async submoduleUpdate(
+    fetchDepth: number,
+    recursive: boolean,
+    submodules: boolean | string[]
+  ): Promise<void> {
+    if (Array.isArray(submodules)) {
+      for (const submodule of submodules) {
+        const args = ['-c', 'protocol.version=2']
+        args.push('submodule', 'update', '--init', '--force', submodule)
+        if (fetchDepth > 0) {
+          args.push(`--depth=${fetchDepth}`)
+        }
 
-    if (recursive) {
-      args.push('--recursive')
-    }
+        if (recursive) {
+          args.push('--recursive')
+        }
 
-    await this.execGit(args)
+        await this.execGit(args)
+      }
+    } else {
+      const args = ['-c', 'protocol.version=2']
+      args.push('submodule', 'update', '--init', '--force')
+      if (fetchDepth > 0) {
+        args.push(`--depth=${fetchDepth}`)
+      }
+
+      if (recursive) {
+        args.push('--recursive')
+      }
+
+      await this.execGit(args)
+    }
   }
 
   async submoduleStatus(): Promise<boolean> {

src/git-source-provider.ts

@@ -242,7 +242,11 @@ export async function getSource(settings: IGitSourceSettings): Promise<void> {
       // Checkout submodules
       core.startGroup('Fetching submodules')
       await git.submoduleSync(settings.nestedSubmodules)
-      await git.submoduleUpdate(settings.fetchDepth, settings.nestedSubmodules)
+      await git.submoduleUpdate(
+        settings.fetchDepth,
+        settings.nestedSubmodules,
+        settings.submodules
+      )
       await git.submoduleForeach(
         'git config --local gc.auto 0',
         settings.nestedSubmodules

src/git-source-settings.ts

@@ -67,7 +67,7 @@ export interface IGitSourceSettings {
   /**
    * Indicates whether to checkout submodules
    */
-  submodules: boolean
+  submodules: boolean | string[]
 
   /**
    * Indicates whether to recursively checkout submodules