feat: add support to passing path specs to Worktree#status

Author: jcouball

lib/ruby_git/worktree.rb

@@ -121,6 +121,12 @@ def self.cloned_to(clone_output)
     # @example worktree = Worktree.open(worktree_path) worktree.status #=>
     #   #<RubyGit::Status::Report ...>
     #
+    # @param path_specs [Array<String>] paths to limit the status to
+    #   (default is all paths)
+    #
+    #   See [git-glossary
+    #   pathspec](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddefpathspecapathspec).
+    #
     # @param untracked_files [:all, :normal, :no] Defines how untracked files will be
     # handled
     #
@@ -140,11 +146,15 @@ def self.cloned_to(clone_output)
     #
     # @return [RubyGit::Status::Report] the status of the working tree
     #
-    def status(untracked_files: :all, ignored: :no, ignore_submodules: :all)
+    def status(*path_specs, untracked_files: :all, ignored: :no, ignore_submodules: :all) # rubocop:disable Metrics/MethodLength
       command = %w[status --porcelain=v2 --branch --show-stash --ahead-behind --renames -z]
       command << "--untracked-files=#{untracked_files}"
       command << "--ignored=#{ignored}"
       command << "--ignore-submodules=#{ignore_submodules}"
+      unless path_specs.empty?
+        command << '--'
+        command.concat(path_specs)
+      end
       options = { out: StringIO.new, err: StringIO.new }
       status_output = run(*command, **options).stdout
       RubyGit::Status.parse(status_output)

spec/lib/ruby_git/worktree_status_spec.rb

@@ -171,6 +171,30 @@
           worktree.status(**given_options)
         end
       end
+
+      context 'when a path spec is given' do
+        it 'should build the correct command' do
+          expect(worktree).to(
+            receive(:run) do |*args, **_options|
+              expect(args).to end_with('--', 'lib')
+            end.and_return(result)
+          )
+          worktree.status('lib')
+        end
+      end
+
+      context 'when multiple path specs are given' do
+        let(:given_options) { { path_spec: 'file_1' } }
+
+        it 'should build the correct command' do
+          expect(worktree).to(
+            receive(:run) do |*args, **_options|
+              expect(args).to end_with('--', 'lib', 'spec')
+            end.and_return(result)
+          )
+          worktree.status('lib', 'spec')
+        end
+      end
     end
   end
 end