git-fastclone 1.6.0.pre1 → 1.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 691025585b07db11da08c4cba7a6a6f8adbc6fa869c4d05cb4fb4abe9f29231c
-  data.tar.gz: 68d8a58de28932d66eb99f37630bb3bb7a9ee5e23738ed6c9c50550cc72f8a74
+  metadata.gz: 2da379c2c47cd84f92907ba6095ed656563316a58806111ff60676bb68175157
+  data.tar.gz: 7bc30f52cbd2f8cf91d40f108fd36c40f82da8c37386d428e7faf59c6431186f
 SHA512:
-  metadata.gz: 7594ba7271f38731ec3522e7af1f067d606ae3dc91860ffb9d0cff6a34dee62d1dee62a8c5a77d206f9fa9ef782ea44893a9542c1ef5ef5163176269a979c8cf
-  data.tar.gz: 4b0b325e9ca5c756a9efce9e28f6edc7d8a9084616e60de8e33feca4a890a9319946914eece980b192aa4dcc54da362fb93954071820b4008410c6a0abfee62c
+  metadata.gz: b99f903732f2a3b1607e544f7b778d9503daa40145db48bae0e695f34f7aea6f60ffc09ba3a2bb2e4fea6bcaec92459243d644fac572eab5040ad8349193cd77
+  data.tar.gz: f3586247be04241d0c9bb62c5bc76b37420800c13182640e9d8a4529e5e69df0153c8d2c4a7fcedb68e8c3f3be7499f4da4ab6dc3e14dee5b91efd2e2ac9f1ec

data/README.md

@@ -14,13 +14,13 @@ Why fastclone?
 Doing lots of repeated checkouts on a specific machine?
 
 | Repository | 1st Fastclone | 2nd Fastclone | git clone | cp -R |
-| -----------|---------------|---------------|-----------|-------|
-| angular.js |    8s         |     3s        | 6s        | 0.5s  |
-| bootstrap  |    26s        |     3s        | 11s       | 0.2s  |
-| gradle     |    25s        |     9s        | 19s       | 6.2s  |
-| linux      |    4m 53s     |     1m 6s     | 3m 51s    | 29s   |
-| react.js   |    18s        |     3s        | 8s        | 0.5s  |
-| tensorflow |    19s        |     4s        | 8s        | 1.5s  |
+| ---------- | ------------- | ------------- | --------- | ----- |
+| angular.js | 8s            | 3s            | 6s        | 0.5s  |
+| bootstrap  | 26s           | 3s            | 11s       | 0.2s  |
+| gradle     | 25s           | 9s            | 19s       | 6.2s  |
+| linux      | 4m 53s        | 1m 6s         | 3m 51s    | 29s   |
+| react.js   | 18s           | 3s            | 8s        | 0.5s  |
+| tensorflow | 19s           | 4s            | 8s        | 1.5s  |
 
 Above times captured using `time` without verbose mode.
 
@@ -51,6 +51,8 @@ Usage
         --lock-timeout N             Timeout in seconds to acquire a lock on any reference repo.
                 Default is 0 which waits indefinitely.
         --pre-clone-hook command     An optional command that should be invoked before cloning mirror repo
+        --sparse-paths PATHS         Comma-separated list of paths for sparse checkout.
+                                     Enables sparse checkout mode using git sparse-checkout.
 
 Change the default `REFERENCE_REPO_DIR` environment variable if necessary.
 
@@ -66,6 +68,11 @@ The hook is invoked with given arguments:
 1. path to the repo mirror location
 1. attempt number, 0-indexed
 
+Sparse checkout support
+-----------------------
+
+In passing `--sparse-paths`, git-fastclone will instead perform a sparse checkout, where the passed list of paths will be set up as patterns. This can be useful if you're interested only in a subset of paths in the repository.
+
 How to test?
 ------------
 Manual testing:

data/lib/git-fastclone/version.rb

@@ -2,5 +2,5 @@
 
 # Version string for git-fastclone
 module GitFastCloneVersion
-  VERSION = '1.6.0.pre1'
+  VERSION = '1.6.1'
 end

data/lib/git-fastclone.rb

@@ -252,10 +252,12 @@ module GitFastClone
         clear_clone_dest_if_needed(attempt_number, clone_dest)
 
         clone_commands = ['git', 'clone', verbose ? '--verbose' : '--quiet']
-        clone_commands.push('--no-checkout', '--shared') if sparse_paths
-        # For sparse checkouts with --shared, clone directly from the local mirror
+        # For sparse checkouts, clone directly from the local mirror and skip the actual checkout process
+        # --shared is included so that the checkout remains fast even if the reference and destination directories
+        #          live on different filesystem volumes.
         # For normal clones, use --reference and clone from the remote URL
         if sparse_paths
+          clone_commands.push('--no-checkout', '--shared')
           clone_commands << mirror.to_s << clone_dest
         else
           clone_commands << '--reference' << mirror.to_s << url.to_s << clone_dest
@@ -264,7 +266,7 @@ module GitFastClone
         fail_on_error(*clone_commands, quiet: !verbose, print_on_failure: print_git_errors)
 
         # Configure sparse checkout if enabled
-        configure_sparse_checkout(clone_dest, rev) if sparse_paths
+        perform_sparse_checkout(clone_dest, rev) if sparse_paths
       end
 
       # Only checkout if we're changing branches to a non-default branch (for non-sparse clones)
@@ -286,7 +288,7 @@ module GitFastClone
       end
     end
 
-    def configure_sparse_checkout(clone_dest, rev)
+    def perform_sparse_checkout(clone_dest, rev)
       puts 'Configuring sparse checkout...' if verbose
 
       # Initialize sparse checkout with cone mode

data/spec/git_fastclone_runner_spec.rb

@@ -145,6 +145,47 @@ describe GitFastClone::Runner do
       end
     end
 
+    context 'with sparse checkout' do
+      before(:each) do
+        subject.sparse_paths = %w[path1 path2]
+      end
+
+      it 'should clone with --no-checkout and --shared flags' do
+        expect(subject).to receive(:fail_on_error).with(
+          'git', 'clone', '--quiet', '--no-checkout', '--shared', '/cache', '/pwd/.',
+          { quiet: true, print_on_failure: false }
+        ) { runner_execution_double }
+        expect(subject).to receive(:perform_sparse_checkout).with('/pwd/.', 'PH')
+
+        subject.clone(placeholder_arg, 'PH', '.', nil)
+      end
+
+      it 'should clone with verbose mode and --shared flag' do
+        subject.verbose = true
+        expect(subject).to receive(:fail_on_error).with(
+          'git', 'clone', '--verbose', '--no-checkout', '--shared', '/cache', '/pwd/.',
+          { quiet: false, print_on_failure: false }
+        ) { runner_execution_double }
+        expect(subject).to receive(:perform_sparse_checkout).with('/pwd/.', 'PH')
+
+        subject.clone(placeholder_arg, 'PH', '.', nil)
+      end
+
+      it 'should not perform regular checkout when sparse checkout is enabled' do
+        expect(subject).to receive(:fail_on_error).with(
+          'git', 'clone', '--quiet', '--no-checkout', '--shared', '/cache', '/pwd/.',
+          { quiet: true, print_on_failure: false }
+        ) { runner_execution_double }
+        expect(subject).to receive(:perform_sparse_checkout).with('/pwd/.', 'PH')
+        expect(subject).not_to receive(:fail_on_error).with(
+          'git', 'checkout', '--quiet', 'PH',
+          anything
+        )
+
+        subject.clone(placeholder_arg, 'PH', '.', nil)
+      end
+    end
+
     context 'with pre-clone-hook' do
       let(:pre_clone_hook) { '/some/command' }
       before(:each) do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: git-fastclone
 version: !ruby/object:Gem::Version
-  version: 1.6.0.pre1
+  version: 1.6.1
 platform: ruby
 authors:
 - Michael Tauraso
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-10 00:00:00.000000000 Z
+date: 2025-11-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: colorize