CD2H gitForager

pivotal-sprout/sprout-git

Name: sprout-git

Owner: Pivotal Sprout

Description: Recipes to manage git on OS X

Created: 2014-04-19 23:45:23.0

Updated: 2017-06-25 18:48:38.0

Pushed: 2016-09-12 16:01:36.0

Homepage:

Size: 164

Language: Ruby

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

sprout-git cookbook

Recipes to install git related tools on OS X.

Prerequisites

system ruby

Quickstart

rout

Cookbook Usage

Recent changes:

remove support for legacy array based format for specifying projects
adds projects sub-attributes for update
you can now specify that a project should auto-update using the update: true attribute (default false)

adds projects_settings attribute to allow for global project settings

also adds subattribute recursive to allow all given projects to be cloned recursively e.g.

_attributes:
ut:
t:
projects_settings:
  recursive: true
projects:
  - github: foo/bar
  - github: pivotal-sprout/sprout-git

will cause the git commands:

t clone --recursive git@github.com:foo/bar.git bar
t clone --recursive git@github.com:pivotal-sprout:sprout-git.git pivotal-sprout

to be used

Adds projects sub-attributes for branch, recursive & github
you can now clone a specific branch using the branch: branch_name attribute (default master)
you can now clone the repositories submodules using recursive: true (default false)
you can now specify git Github url using github: account]/repo syntax. the url attribute will override this attribute if both are provided.

e.g.
```
_attributes:
ut:
t:
projects:
  - github: pivotal-sprout/sprout-git
    branch: develop
    recursive: true
```
will cause the git command: $ git clone -b develop --recursive git@github.com:pivotal-sprout/sprout-git.git pivotal-sprout to be used
Support for new brew tap syntax
Brew has recently changed the output of each brew tap tap from “name-of-tap/homebrew-tap” to “name-of-tap/tap”. If you getting an error adding custom taps, update your Cheffile.lock to use the latest sprout-git cookbook by using librarian-chef update sprout-git.
Adds git_duet recipe:
This will install git-duet, which allows git commits to have multiple authors. See the git-duet repo
Adds git_duet_rotate_authors recipe:
This will add a custom bash_it plugin that causes git-duet to rotate which author is the committer.
Adds git_duet_global recipe:
This will add a custom bash_it plugin that causes git-duet to set global git properties.
the projects attributes have changed from an array of tuples:
NOTE support for the array syntax has been removed as of 2016-06-08
```
_attributes:
ut:
t:
projects:
  - # e.g. ~/workspace/foo
    - foo
    - https://github.com/pivotal-sprout/sprout-git.git
```
to an array of hashes:
```
_attributes:
ut:
t:
projects:
  - # e.g. ~/workspace/foo
    url: https://github.com/pivotal-sprout/sprout-git.git
    name: foo
```
the tuple syntax is deprecated but will continue to work for the near term until enough people have transitioned. See the Attributes section for more details an the new syntax.

the projects attributes now include a way to run arbitrary commands on the freshly cloned repo:

The commands will be run in sequence. If one of the commands fails (retunrs non-zero) subsequen commands continue to run and the Sprout run is not affected. Future runs of sprout would not re-run these commands unless the repo was previously deleted. i.e. they only get run on a fresh clone of the project.

_attributes:
ut:
t:
projects:
  - # an example that initializes submodules, installs all gems, sets up the databases, runs rspec, and executes other arbitrary commands even with some failing
    url: https://github.com/pivotal-sprout/sprout-git.git
    post_clone_commands:
      - git submodule update --init
      - gem install bundler
      - bundle
      - rake db:create db:migrate
      - RAILS_ENV=test rake db:create db:migrate
      - rake spec
      - false
      - echo "I'm still run even though the last command failed"

Projects no longer explicity set master's upstream branch to origin/master
This is done when the repo is cloned so sprout does not need to explicitly do this.
Projects using the new hash syntax no longer automatically do a git submodule update --init
If the project needs to have submodules initialized then those entries should include the command as a post-clone command. If the soloistrc is still using the legacy tuple syntax which cannot specify post_clone_commands then we continue to run the submodule update –init on all projects regardless of whether they have submodules.

Attributes:

NOTE: All preferences are namespaced under sprout => git they include:

prefix — the email prefix to used by git-pair — default is 'pair'
domain — email address domain to be used by git-pair — default is 'example.com'
authors — a list of authors to install either into the ~/.pairs or ~/.git-authors files — default is empty. _see the soloistrc file for examples.
editor — the value to set for GIT_EDITOR, defaults to vim.
global_config A set of configurations to be installed globally by the global_config recipe. — see config.rb
base_aliases A set of git aliases like ci,br, etc to install. Used by the aliases recipe — dfault is empty. see the soloistrc or aliases.rb files for examples.
aliases — an additional set of custom aliases to be installed in addition to the base_aliases. Used by the aliases recipe — default is empty. see the soloistrc or aliases.rb files for examples.
projects_settings — Global project settings. Used by the projects recipe — this is empty by default see the soloistrc or the attributes/projects.rb files for examples. it contains an array of project hashes with the following keys:
recursive — optional — if true will recursively clone all project repos — defaults to false and is overridden by the specific project flag
projects — The list of repositories to automatically clone. Used by the projects recipe — this is empty by default see the soloistrc or the attributes/projects.rb files for examples. it contains an array of project hashes with the following keys:
url — optional — The repo url to clone. Note: attribute is required unless github is provided — e.g. https://example.com/some/repo.git
github — optional — The github repo to clone. Note: will be overridden by the url attribute — e.g. pivotal-sprout/sprout-git generates a git@github.com:account/repo.git url
name — optional — The name of the local folder containing the repo. — e.g. my_repo
branch — optional — the initial branch to clone — e.g. develop
recursive — optional — if true will recursively clone the repo (essintially cloning the projects submodules if present) — defaults to false
update — optional — if true will update existing repos with a rebase — defaults to false
workspace_path — optional — The path to clone into. — e.g. ~/personal_projects or /abs/path/to/personal_projects
post_clone_commands — optional — A list of commands to run on the freshly cloned repository. Note this is only run on a fresh clone. Future runs of sprout will not cause these commands to be re-run. — Some example commands could include:
- gem install bundler
- bundle
- rake db:create:all db:test:prepare default
- pod install
- git submodule update --init

Recipes:

sprout-git — default recipe
sprout-git::aliases — installs common git aliases such as git st
sprout-git::authors — install ~/.git-authors file used by git-duet ; note: this is not in the default recipe
sprout-git::default_editor — installs bash-it plugin to set default git editor
sprout-git::git_duet — installs git-duet, which allows git commits to have multiple authors. See the git-duet repo ; note: this is not in the default recipe
sprout-git::git_duet_global — installs a custom bash_it plugin that causes git-duet to set global git properties ; note: this is not in the default recipe
sprout-git::git_duet_rotate_authors — installs a custom bash_it plugin that causes git-duet to rotate which author is the committer ; note: this is not in the default recipe
sprout-git::git_scripts — installs pivotal [git_scripts] onto to the system using system ruby. Also installs/overwrites the ~/.pairs file. ; note: this is not in the default recipe
sprout-git::global_config — adds global git configurations defined by the sprout => git => global_config node attributes
sprout-git::global_ignore — adds basic global git ignore file. node.git_global_ignore_idea, which is used to determine if .idea files should be ignored, has been flipped from the original behavior in effort to be more intuitive.
sprout-git::install — install git using homebrew
sprout-git::projects — clones all projects defined byt the sprout => git => projects node attribute ; note: this is not in the default recipe

Contributing

Before committing

rout exec rake

The default rake task includes rubocop, foodcritic, unit specs

Rubocop

rout exec rake rubocop

FoodCritic

rout exec rake foodcritic

Unit specs

Unit specs use ChefSpec

rout exec rake spec:unit

Integration specs

Integrations specs will run the default recipe on the host system (destructive) and make assertions on the system after install.

Note: It has a precondition that git-pair is not already installed on the system.

rout exec rake spec:integration

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.