git 1.6.0 → 1.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87d2d900d69f6d803a09dab4f7668b550bc21cecbf51194b494f8b9366dce3d7
-  data.tar.gz: f8c1dc4b41a65b7c562f496f78a7d0f9f8ad98f26b70588186b5a890f058873b
+  metadata.gz: 1c98b8817ceb2d65efcf09cd2461023a5fb514fb738524332dbd98daae2b8cf0
+  data.tar.gz: 7fa575c50ed9f3c85bbd9aadd6e1d0a74d4421f9b3d612d43f761a1d77f7b1e2
 SHA512:
-  metadata.gz: 9c4364cfc57fd1eb54be4c5229ca0b14b4d83227d08fabb57e0c326dee91be43bb1560376f013965f2377f651ad64900b5bd90ff96737855d8acdcb87cef7ac2
-  data.tar.gz: 1d1114b7f1a2af9964e57e5cac34c8c88ffddebb39f79cdad89023827a3863697db435055c08961653a7a82c6cdf9f983e6c3b4119002c75b5f263acf2830e3e
+  metadata.gz: ecec9d8d598576983f48b9193ebadb4dc0a53745df0b0c27466ee075947945ea793dbb112107d4e5eaf70cca2cb93c3b0f83489af12d4b42d6336051261124ee
+  data.tar.gz: c164e57a0f9006672826c993719c85a8997e08b2272da7e48e17e945bffb9917d74cb3957ce09c9cb3b8cb4cec03f236b88f0334c5322a948e1f12021ffad5b7

data/.github/stale.yml

@@ -0,0 +1,25 @@
+# Probot: Stale
+# https://github.com/probot/stale
+
+# Number of days of inactivity before an issue becomes stale
+daysUntilStale: 60
+
+# Number of days of inactivity before a stale issue is closed
+# Set to false to disable. If disabled, issues still need to be closed
+# manually, but will remain marked as stale.
+daysUntilClose: false
+
+# Issues with these labels will never be considered stale
+exemptLabels:
+  - pinned
+  - security
+
+# Label to use when marking an issue as stale
+staleLabel: stale
+
+# Comment to post when marking an issue as stale. Set to `false` to disable
+markComment: >
+  A friendly reminder that this issue had no activity for 60 days.
+
+# Comment to post when closing a stale issue. Set to `false` to disable
+closeComment: false

data/.github/workflows/continuous_integration.yml

@@ -0,0 +1,45 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  continuous_integration_build:
+    continue-on-error: true
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: [2.3, 2.7]
+        operating-system: [ubuntu-latest]
+        include:
+          - ruby: head
+            operating-system: ubuntu-latest
+          - ruby: truffleruby-head
+            operating-system: ubuntu-latest
+          - ruby: 2.7
+            operating-system: windows-latest
+          - ruby: jruby-head
+            operating-system: windows-latest
+
+    name: Ruby ${{ matrix.ruby }} on ${{ matrix.operating-system }}
+
+    runs-on: ${{ matrix.operating-system }}
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v2
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+
+      - name: Run Build
+        run: bundle exec rake default
+
+      - name: Test Gem
+        run: bundle exec rake test:gem

data/.gitignore

@@ -0,0 +1,10 @@
+*.gem
+*.kpf
+*.sw?
+.DS_Store
+coverage
+doc
+.yardoc
+pkg
+rdoc
+Gemfile.lock

data/.yardopts

@@ -0,0 +1,11 @@
+--default-return=''
+--hide-void-return
+--markup-provider=redcarpet
+--markup=markdown
+--fail-on-warning
+-
+README.md
+CHANGELOG.md
+CONTRIBUTING.md
+RELEASING.md
+MAINTAINERS.md

data/CHANGELOG.md

@@ -1,5 +1,30 @@
+<!--
+# @markup markdown
+# @title Change Log
+-->
+
 # Change Log
 
+## 1.9.1
+
+See https://github.com/ruby-git/ruby-git/releases/tag/v1.9.1
+
+## 1.9.0
+
+See https://github.com/ruby-git/ruby-git/releases/tag/v1.9.0
+
+## 1.8.1
+
+See https://github.com/ruby-git/ruby-git/releases/tag/v1.8.1
+
+## 1.8.0
+
+See https://github.com/ruby-git/ruby-git/releases/tag/v1.8.0
+
+## 1.7.0
+
+See https://github.com/ruby-git/ruby-git/releases/tag/v1.7.0
+
 ## 1.6.0
 
 See https://github.com/ruby-git/ruby-git/releases/tag/v1.6.0

data/CONTRIBUTING.md

@@ -1,3 +1,8 @@
+<!--
+# @markup markdown
+# @title How To Contribute
+-->
+
 # Contributing to ruby-git
 
 Thank you for your interest in contributing to the ruby-git project.
@@ -8,7 +13,7 @@ judgement.
 
 Propose changes to these guidelines with a pull request.
 
-## How to contribute to ruby-git
+## How to contribute
 
 You can contribute in two ways:
 
@@ -73,12 +78,14 @@ In order to ensure high quality, all pull requests must meet these requirements:
 
 ### Unit tests
   * All changes must be accompanied by new or modified unit tests
-  * The entire test suite must pass when `bundle exec rake test` is run from the
-    project's local working copy
-
-### Continuous Integration
-  * All tests must pass in the project's [Travis CI](https://travis-ci.org/ruby-git/ruby-git)
-    build before the pull request will be merged
+  * The entire test suite must pass when `bundle exec rake default` is run from the
+    project's local working copy.
+
+### Continuous integration
+  * All tests must pass in the project's [GitHub Continuous Integration build](https://github.com/ruby-git/ruby-git/actions?query=workflow%3ACI)
+    before the pull request will be merged.
+  * The [Continuous Integration workflow](https://github.com/ruby-git/ruby-git/blob/master/.github/workflows/continuous_integration.yml)
+    runs both `bundle exec rake default` and `bundle exec rake test:gem` from the project's [Rakefile](https://github.com/ruby-git/ruby-git/blob/master/Rakefile).
 
 ### Documentation
   * New and updated public methods must have [YARD](https://yardoc.org/)

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+gemspec :name => 'git'
+

data/ISSUE_TEMPLATE.md

@@ -0,0 +1,15 @@
+### Subject of the issue
+Describe your issue here.
+
+### Your environment
+* version of git and ruby-git
+* version of ruby
+
+### Steps to reproduce
+Tell us how to reproduce this issue. 
+
+### Expected behaviour
+What did you expect to happen?
+
+### Actual behaviour
+What actually happened?

data/MAINTAINERS.md

@@ -1,3 +1,8 @@
+<!--
+# @markup markdown
+# @title Maintainers
+-->
+
 # Maintainers
 
 When making changes in this repository, one of the maintainers below must review and approve your pull request.

data/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,9 @@
+### Your checklist for this pull request
+🚨Please review the [guidelines for contributing](https://github.com/ruby-git/ruby-git/blob/master/CONTRIBUTING.md) to this repository.
+
+- [ ] Ensure all commits include DCO sign-off.
+- [ ] Ensure that your contributions pass unit testing.
+- [ ] Ensure that your contributions contain documentation if applicable.
+
+### Description
+Please describe your pull request.

data/README.md

@@ -1,24 +1,49 @@
-# Git Library for Ruby
+<!--
+# @markup markdown
+# @title README
+-->
 
-Library for using Git in Ruby.
+# The Git Gem
+
+The Git Gem provides an API that can be used to create, read, and manipulate
+Git repositories by wrapping system calls to the `git` binary. The API can be
+used for working with Git in complex interactions including branching and
+merging, object inspection and manipulation, history, patch generation and
+more.
 
 ## Homepage
 
-Git public hosting of the project source code is at:
+The project source code is at:
 
 http://github.com/ruby-git/ruby-git
 
+## Documentation
+
+Detailed documentation can be found at:
+
+https://rubydoc.info/gems/git/Git.html
+
+Get started by obtaining a repository object by:
+
+* opening an existing working copy with [Git.open](https://rubydoc.info/gems/git/Git#open-class_method)
+* initializing a new repository with [Git.init](https://rubydoc.info/gems/git/Git#init-class_method)
+* cloning a repository with [Git.clone](https://rubydoc.info/gems/git/Git#clone-class_method)
+
+Methods that can be called on a repository object are documented in [Git::Base](https://rubydoc.info/gems/git/Git/Base)
+
 ## Install
 
 You can install Ruby/Git like this:
 
-    $ sudo gem install git
+```
+sudo gem install git
+```
 
 ## Code Status
 
-* [![Build Status](https://travis-ci.org/ruby-git/ruby-git.svg?branch=master)](https://travis-ci.org/ruby-git/ruby-git)
+* [![Build Status](https://github.com/ruby-git/ruby-git/workflows/CI/badge.svg?branch=master)](https://github.com/ruby-git/ruby-git/actions?query=workflow%3ACI)
 * [![Code Climate](https://codeclimate.com/github/ruby-git/ruby-git.png)](https://codeclimate.com/github/ruby-git/ruby-git)
-* [![Gem Version](https://badge.fury.io/rb/git.png)](http://badge.fury.io/rb/git)
+* [![Gem Version](https://badge.fury.io/rb/git.svg)](https://badge.fury.io/rb/git)
 
 ## Major Objects
 
@@ -41,6 +66,8 @@ like:
 
  `@git.log(20).object("some_file").since("2 weeks ago").between('v2.6', 'v2.7').each { |commit| [block] }`
 
+ **Git::Worktrees** - Enumerable object that holds `Git::Worktree objects`.
+
 ## Examples
 
 Here are a bunch of examples of how to use the Ruby/Git package.
@@ -48,24 +75,24 @@ Here are a bunch of examples of how to use the Ruby/Git package.
 Ruby < 1.9 will require rubygems to be loaded.
 
 ```ruby
-    require 'rubygems'
+require 'rubygems'
 ```
 
 Require the 'git' gem.
 ```ruby
-    require 'git'
+require 'git'
 ```
 
 Git env config
 
 ```ruby
-  Git.configure do |config|
-    # If you want to use a custom git binary
-    config.binary_path = '/git/bin/path'
+Git.configure do |config|
+  # If you want to use a custom git binary
+  config.binary_path = '/git/bin/path'
 
-    # If you need to use a custom SSH script
-    config.git_ssh = '/path/to/ssh/script'
-  end
+  # If you need to use a custom SSH script
+  config.git_ssh = '/path/to/ssh/script'
+end
 ```
 
 _NOTE: Another way to specify where is the `git` binary is through the environment variable `GIT_PATH`_
@@ -73,226 +100,252 @@ _NOTE: Another way to specify where is the `git` binary is through the environme
 Here are the operations that need read permission only.
 
 ```ruby
-    g = Git.open(working_dir, :log => Logger.new(STDOUT))
-
-    g.index
-    g.index.readable?
-    g.index.writable?
-    g.repo
-    g.dir
-
-    g.log   # returns array of Git::Commit objects
-    g.log.since('2 weeks ago')
-    g.log.between('v2.5', 'v2.6')
-    g.log.each {|l| puts l.sha }
-    g.gblob('v2.5:Makefile').log.since('2 weeks ago')
-
-    g.object('HEAD^').to_s  # git show / git rev-parse
-    g.object('HEAD^').contents
-    g.object('v2.5:Makefile').size
-    g.object('v2.5:Makefile').sha
-
-    g.gtree(treeish)
-    g.gblob(treeish)
-    g.gcommit(treeish)
-
-
-    commit = g.gcommit('1cc8667014381')
-
-    commit.gtree
-    commit.parent.sha
-    commit.parents.size
-    commit.author.name
-    commit.author.email
-    commit.author.date.strftime("%m-%d-%y")
-    commit.committer.name
-    commit.date.strftime("%m-%d-%y")
-    commit.message
-
-    tree = g.gtree("HEAD^{tree}")
-
-    tree.blobs
-    tree.subtrees
-    tree.children # blobs and subtrees
-
-    g.revparse('v2.5:Makefile')
-
-    g.branches # returns Git::Branch objects
-    g.branches.local
-    g.branches.remote
-    g.branches[:master].gcommit
-    g.branches['origin/master'].gcommit
-
-    g.grep('hello')  # implies HEAD
-    g.blob('v2.5:Makefile').grep('hello')
-    g.tag('v2.5').grep('hello', 'docs/')
-    g.describe()
-    g.describe('0djf2aa')
-    g.describe('HEAD', {:all => true, :tags => true})
-
-    g.diff(commit1, commit2).size
-    g.diff(commit1, commit2).stats
-    g.diff(commit1, commit2).name_status
-    g.gtree('v2.5').diff('v2.6').insertions
-    g.diff('gitsearch1', 'v2.5').path('lib/')
-    g.diff('gitsearch1', @git.gtree('v2.5'))
-    g.diff('gitsearch1', 'v2.5').path('docs/').patch
-    g.gtree('v2.5').diff('v2.6').patch
-
-    g.gtree('v2.5').diff('v2.6').each do |file_diff|
-       puts file_diff.path
-       puts file_diff.patch
-       puts file_diff.blob(:src).contents
-    end
-
-    g.config('user.name')  # returns 'Scott Chacon'
-    g.config # returns whole config hash
-
-    g.tags # returns array of Git::Tag objects
-
-    g.show()
-    g.show('HEAD')
-    g.show('v2.8', 'README.md')
-
-    Git.ls_remote('https://github.com/ruby-git/ruby-git.git') # returns a hash containing the available references of the repo.
-    Git.ls_remote('/path/to/local/repo')
-    Git.ls_remote() # same as Git.ls_remote('.')
-
+g = Git.open(working_dir, :log => Logger.new(STDOUT))
+
+g.index
+g.index.readable?
+g.index.writable?
+g.repo
+g.dir
+
+g.log   # returns array of Git::Commit objects
+g.log.since('2 weeks ago')
+g.log.between('v2.5', 'v2.6')
+g.log.each {|l| puts l.sha }
+g.gblob('v2.5:Makefile').log.since('2 weeks ago')
+
+g.object('HEAD^').to_s  # git show / git rev-parse
+g.object('HEAD^').contents
+g.object('v2.5:Makefile').size
+g.object('v2.5:Makefile').sha
+
+g.gtree(treeish)
+g.gblob(treeish)
+g.gcommit(treeish)
+
+
+commit = g.gcommit('1cc8667014381')
+
+commit.gtree
+commit.parent.sha
+commit.parents.size
+commit.author.name
+commit.author.email
+commit.author.date.strftime("%m-%d-%y")
+commit.committer.name
+commit.date.strftime("%m-%d-%y")
+commit.message
+
+tree = g.gtree("HEAD^{tree}")
+
+tree.blobs
+tree.subtrees
+tree.children # blobs and subtrees
+
+g.revparse('v2.5:Makefile')
+
+g.branches # returns Git::Branch objects
+g.branches.local
+g.current_branch
+g.branches.remote
+g.branches[:master].gcommit
+g.branches['origin/master'].gcommit
+
+g.grep('hello')  # implies HEAD
+g.blob('v2.5:Makefile').grep('hello')
+g.tag('v2.5').grep('hello', 'docs/')
+g.describe()
+g.describe('0djf2aa')
+g.describe('HEAD', {:all => true, :tags => true})
+
+g.diff(commit1, commit2).size
+g.diff(commit1, commit2).stats
+g.diff(commit1, commit2).name_status
+g.gtree('v2.5').diff('v2.6').insertions
+g.diff('gitsearch1', 'v2.5').path('lib/')
+g.diff('gitsearch1', @git.gtree('v2.5'))
+g.diff('gitsearch1', 'v2.5').path('docs/').patch
+g.gtree('v2.5').diff('v2.6').patch
+
+g.gtree('v2.5').diff('v2.6').each do |file_diff|
+  puts file_diff.path
+  puts file_diff.patch
+  puts file_diff.blob(:src).contents
+end
+
+g.worktrees # returns Git::Worktree objects
+g.worktrees.count
+g.worktrees.each do |worktree|
+  worktree.dir
+  worktree.gcommit
+  worktree.to_s
+end
+
+g.config('user.name')  # returns 'Scott Chacon'
+g.config # returns whole config hash
+
+g.tags # returns array of Git::Tag objects
+
+g.show()
+g.show('HEAD')
+g.show('v2.8', 'README.md')
+
+Git.ls_remote('https://github.com/ruby-git/ruby-git.git') # returns a hash containing the available references of the repo.
+Git.ls_remote('/path/to/local/repo')
+Git.ls_remote() # same as Git.ls_remote('.')
 ```
 
 And here are the operations that will need to write to your git repository.
 
 ```ruby
-      g = Git.init
-       Git.init('project')
-       Git.init('/home/schacon/proj',
-        { :repository => '/opt/git/proj.git',
-           :index => '/tmp/index'} )
-
-     g = Git.clone(URI, NAME, :path => '/tmp/checkout')
-     g.config('user.name', 'Scott Chacon')
-     g.config('user.email', 'email@email.com')
-
-     g.add                                   # git add -- "."
-     g.add(:all=>true)                       # git add --all -- "."
-     g.add('file_path')                      # git add -- "file_path"
-     g.add(['file_path_1', 'file_path_2'])   # git add -- "file_path_1" "file_path_2"
-
-     g.remove()									# git rm -f -- "."
-     g.remove('file.txt')						# git rm -f -- "file.txt"
-     g.remove(['file.txt', 'file2.txt'])		# git rm -f -- "file.txt" "file2.txt"
-     g.remove('file.txt', :recursive => true) 	# git rm -f -r -- "file.txt"
-     g.remove('file.txt', :cached => true)		# git rm -f --cached -- "file.txt"
-
-     g.commit('message')
-     g.commit_all('message')
-
-     g = Git.clone(repo, 'myrepo')
-     g.chdir do
-      new_file('test-file', 'blahblahblah')
-      g.status.changed.each do |file|
-       puts file.blob(:index).contents
-      end
-     end
-
-     g.reset # defaults to HEAD
-     g.reset_hard(Git::Commit)
-
-     g.branch('new_branch') # creates new or fetches existing
-     g.branch('new_branch').checkout
-     g.branch('new_branch').delete
-     g.branch('existing_branch').checkout
-     g.branch('master').contains?('existing_branch')
-
-     g.checkout('new_branch')
-     g.checkout(g.branch('new_branch'))
-
-     g.branch(name).merge(branch2)
-     g.branch(branch2).merge  # merges HEAD with branch2
-
-     g.branch(name).in_branch(message) { # add files }  # auto-commits
-     g.merge('new_branch')
-     g.merge('origin/remote_branch')
-     g.merge(g.branch('master'))
-     g.merge([branch1, branch2])
-
-     g.merge_base('branch1', 'branch2')
-
-     r = g.add_remote(name, uri)  # Git::Remote
-     r = g.add_remote(name, Git::Base)  # Git::Remote
-
-     g.remotes  # array of Git::Remotes
-     g.remote(name).fetch
-     g.remote(name).remove
-     g.remote(name).merge
-     g.remote(name).merge(branch)
-
-     g.fetch
-     g.fetch(g.remotes.first)
-     g.fetch('origin', {:ref => 'some/ref/head'} )
-
-     g.pull
-     g.pull(Git::Repo, Git::Branch) # fetch and a merge
-
-     g.add_tag('tag_name') # returns Git::Tag
-     g.add_tag('tag_name', 'object_reference')
-     g.add_tag('tag_name', 'object_reference', {:options => 'here'})
-     g.add_tag('tag_name', {:options => 'here'})
-
-     Options:
-       :a | :annotate
-       :d
-       :f
-       :m | :message
-       :s
-
-     g.delete_tag('tag_name')
-
-     g.repack
-
-     g.push
-     g.push(g.remote('name'))
+g = Git.init
+  Git.init('project')
+  Git.init('/home/schacon/proj',
+  { :repository => '/opt/git/proj.git',
+      :index => '/tmp/index'} )
+
+g = Git.clone(URI, NAME, :path => '/tmp/checkout')
+g.config('user.name', 'Scott Chacon')
+g.config('user.email', 'email@email.com')
+
+# Clone can take an optional logger
+logger = Logger.new
+g = Git.clone(URI, NAME, :log => logger)
+
+g.add                                   # git add -- "."
+g.add(:all=>true)                       # git add --all -- "."
+g.add('file_path')                      # git add -- "file_path"
+g.add(['file_path_1', 'file_path_2'])   # git add -- "file_path_1" "file_path_2"
+
+g.remove()									# git rm -f -- "."
+g.remove('file.txt')						# git rm -f -- "file.txt"
+g.remove(['file.txt', 'file2.txt'])		# git rm -f -- "file.txt" "file2.txt"
+g.remove('file.txt', :recursive => true) 	# git rm -f -r -- "file.txt"
+g.remove('file.txt', :cached => true)		# git rm -f --cached -- "file.txt"
+
+g.commit('message')
+g.commit_all('message')
+
+# Sign a commit using the gpg key configured in the user.signingkey config setting
+g.config('user.signingkey', '0A46826A')
+g.commit('message', gpg_sign: true)
+
+# Sign a commit using a specified gpg key
+key_id = '0A46826A'
+g.commit('message', gpg_sign: key_id)
+
+g = Git.clone(repo, 'myrepo')
+g.chdir do
+new_file('test-file', 'blahblahblah')
+g.status.changed.each do |file|
+  puts file.blob(:index).contents
+end
+end
+
+g.reset # defaults to HEAD
+g.reset_hard(Git::Commit)
+
+g.branch('new_branch') # creates new or fetches existing
+g.branch('new_branch').checkout
+g.branch('new_branch').delete
+g.branch('existing_branch').checkout
+g.branch('master').contains?('existing_branch')
+
+g.checkout('new_branch')
+g.checkout(g.branch('new_branch'))
+
+g.branch(name).merge(branch2)
+g.branch(branch2).merge  # merges HEAD with branch2
+
+g.branch(name).in_branch(message) { # add files }  # auto-commits
+g.merge('new_branch')
+g.merge('new_branch', 'merge commit message', no_ff: true)
+g.merge('origin/remote_branch')
+g.merge(g.branch('master'))
+g.merge([branch1, branch2])
+
+g.merge_base('branch1', 'branch2')
+
+r = g.add_remote(name, uri)  # Git::Remote
+r = g.add_remote(name, Git::Base)  # Git::Remote
+
+g.remotes  # array of Git::Remotes
+g.remote(name).fetch
+g.remote(name).remove
+g.remote(name).merge
+g.remote(name).merge(branch)
+
+g.fetch
+g.fetch(g.remotes.first)
+g.fetch('origin', {:ref => 'some/ref/head'} )
+
+g.pull
+g.pull(Git::Repo, Git::Branch) # fetch and a merge
+
+g.add_tag('tag_name') # returns Git::Tag
+g.add_tag('tag_name', 'object_reference')
+g.add_tag('tag_name', 'object_reference', {:options => 'here'})
+g.add_tag('tag_name', {:options => 'here'})
+
+Options:
+  :a | :annotate
+  :d
+  :f
+  :m | :message
+  :s
+
+g.delete_tag('tag_name')
+
+g.repack
+
+g.push
+g.push(g.remote('name'))
+
+g.worktree('/tmp/new_worktree').add
+g.worktree('/tmp/new_worktree', 'branch1').add
+g.worktree('/tmp/new_worktree').remove
+g.worktrees.prune
 ```
 
 Some examples of more low-level index and tree operations
 
 ```ruby
-     g.with_temp_index do
+g.with_temp_index do
 
-       g.read_tree(tree3) # calls self.index.read_tree
-       g.read_tree(tree1, :prefix => 'hi/')
+  g.read_tree(tree3) # calls self.index.read_tree
+  g.read_tree(tree1, :prefix => 'hi/')
 
-       c = g.commit_tree('message')
-       # or #
-       t = g.write_tree
-       c = g.commit_tree(t, :message => 'message', :parents => [sha1, sha2])
+  c = g.commit_tree('message')
+  # or #
+  t = g.write_tree
+  c = g.commit_tree(t, :message => 'message', :parents => [sha1, sha2])
 
-       g.branch('branch_name').update_ref(c)
-       g.update_ref(branch, c)
+  g.branch('branch_name').update_ref(c)
+  g.update_ref(branch, c)
 
-       g.with_temp_working do # new blank working directory
-         g.checkout
-         g.checkout(another_index)
-         g.commit # commits to temp_index
-       end
-     end
+  g.with_temp_working do # new blank working directory
+    g.checkout
+    g.checkout(another_index)
+    g.commit # commits to temp_index
+  end
+end
 
-     g.set_index('/path/to/index')
+g.set_index('/path/to/index')
 
 
-     g.with_index(path) do
-       # calls set_index, then switches back after
-     end
+g.with_index(path) do
+  # calls set_index, then switches back after
+end
 
-     g.with_working(dir) do
-     # calls set_working, then switches back after
-     end
+g.with_working(dir) do
+# calls set_working, then switches back after
+end
 
-     g.with_temp_working(dir) do
-       g.checkout_index(:prefix => dir, :path_limiter => path)
-       # do file work
-       g.commit # commits to index
-     end
+g.with_temp_working(dir) do
+  g.checkout_index(:prefix => dir, :path_limiter => path)
+  # do file work
+  g.commit # commits to index
+end
 ```
 
 ## License