/posh-gitflow

A set of scripts to incorporate PoSH GitFlow extensions with posh-git, the PowerShell environment for git.

Primary LanguageShell

posh-gitflow

Adds PowerShell extensions to posh-git to enable GitFlow source code management. Posh-git is a PowerShell environment for git that can be installed by itself, or bundled with GitHub for Windows as the 'Git Shell.'

Description

This script adds GitFlow support to posh-git. The GitFlow concept and core scripts were developed by nvie. The cheatsheet and script offered here is a modified version of one developed by Howard van Rooijen and documented in a fantastic series of blog posts about using GitHub with TeamCity.

Installation

  1. Open a posh-git shell. (If using the GitHub for Windows client browse to a repository and 'Open in Git Shell'. Be sure to change to an appropriate directory so you don't clone into an existing repository.)
  2. Run git clone https://github.com/jhoerr/posh-gitflow.git;cd posh-gitflow;./Configure-GitFlow.ps1;cd ..
  3. Run git flow init to initialize the repository for GitFlow.
  4. Review the One-Page GitFlow Cheatsheet to learn the commands.

Known Issues Depending on your computer's PowerShell execution policy, you may receive the following error during installation step #1:

.\Configure-GitFlow.ps1 : File Configure-GitFlow.ps1 cannot be loaded. The file Configure-GitFlow.ps1 is
not digitally signed. You cannot run this script on the current system. For more information about running
scripts and setting execution policy, see about_Execution_Policies at
http://go.microsoft.com/fwlink/?LinkID=135170.
At line:1 char:1
+ .\Configure-GitFlow.ps1
+ ~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : SecurityError: (:) [], PSSecurityException
    + FullyQualifiedErrorId : UnauthorizedAccess

To proceed without adjusting the system's execution policy, navigate to the file in Explorer, right-click and choose Properties, then click the Unblock button.