@maccuaa/git-clean

@maccuaa/git-clean

Keeping the number of branches in your git repository sane.

About

Use this scipt to identify stale git branches that should be deleted. It does this by iterating over every branch in the repository and getting the last commit author, and the date of the last commit.

Install

1. Install git-clean from NPM.

# globally
npm i -g @maccuaa/git-clean

# in your project
npm i -D @maccuaa/git-clean

Configure

Once installed, you must configure some parameters for git-clean.

It is recommended to create a .gitcleanrc file in the root of your project.

git-clean uses the rc library for finding and loading configs. It is possible to define these settings in other places as well, for a list of all supported option please see the rc project.

This example also shows the default values git-clean uses.

# .gitcleanrc

# Required
REMOTE_URL =

# Optional
JIRA_PROJECTS =
MAIN_BRANCH = master
PROTECTED_BRANCHES = HEAD, origin/master

# SMTP Settings
# see nodeemailer for more support servers
# https://github.com/nodemailer/nodemailer/blob/master/lib/well-known/services.json

SMTP_SERVER = Hotmail
SMTP_USER = <username>
SMTP_PASSWORD = <password>

Options

Option	Description
REMOTE_URL	the URL to the remote Git server
JIRA_PROJECTS	comma separated list of Jira project codes that you want to display links for
MAIN_BRANCH	the name of your main branch. Generally this is the master branch
PROTECTED_BRANCHES	comma separated list of branches that are protected and should not be deleted.

Branches matching any of PROTECTED_BRANCHES values these values will not be displayed by git-clean.

Recommended Setup for large projects

For large projects with multiple developers and a large number of branches it is recommended to commit a .gitcleanrc file in the root of your project.

install git-clean as a devDependency

Contribute