Command-line tool to delete merged Git branches

These details have not been verified by PyPI

Project links

Homepage

Project description

git-delete-merged-branches

A convenient command-line tool helping you keep repositories clean.

Installation

pip install git-delete-merged-branches

Example

# git-delete-merged-branches
Do you want to run "git remote update --prune" for 1 remote(s):
  - origin

Update? [y/N] y
Do you want to run "git pull --ff-only" for 1 branches(s):
  - master

Pull? [y/N] y
You are about to delete 6 local branch(es):
  - improve-setup-py
  - issue-12-enable-ci-for-pull-requests
  - issue-5-fix-waste-of-one-second-per-service
  - keep-github-actions-up-to-date
  - refactoring-one
  - simple-ci

Delete? [y/N] y
6 local branch(es) deleted.
You are about to delete 6 remote branch(es):
  - origin/improve-setup-py
  - origin/issue-12-enable-ci-for-pull-requests
  - origin/issue-5-fix-waste-of-one-second-per-service
  - origin/keep-github-actions-up-to-date
  - origin/refactoring-one
  - origin/simple-ci

Delete? [y/N] y
To github.com:hartwork/wait-for-it.git
 - [deleted]         improve-setup-py
 - [deleted]         issue-12-enable-ci-for-pull-requests
 - [deleted]         issue-5-fix-waste-of-one-second-per-service
 - [deleted]         keep-github-actions-up-to-date
 - [deleted]         refactoring-one
 - [deleted]         simple-ci
6 remote branch(es) deleted.

Features

Supports deletion of both local and remote branches
Detects certain forms of de-facto merges (certain no-squash rebase merges as well as certain single or range cherry-picks, as recognized by git cherry)
Supports workflows with multiple release branches, e.g. only delete branches that have been merged to all of master, dev and staging
Quick interactive configuration
Provider agnostic: Works with GitHub, GitLab and any other Git hosting
Takes safety seriously

Safety

Deletion is a sharp knife that requires care. While git reflog would have your back in most cases, git-delete-merged-branches takes safety seriously.

Here's what git-delete-merged-branches does for your safety:

No branches are deleted without confirmation or passing --yes.
Confirmation defaults to "no"; plain [Enter]/[Return] does not delete.
git branch --delete is used without --force whereever possible
git push is used with --force-with-lease so if the server and you have a different understanding of that branch, it is not deleted.
There is no use of os.system or shell code to go wrong.
With --dry-run you can get a feel for the changes that git-delete-merged-branches would be making to your branches.
Show any Git commands run using --verbose.

Best Practices

When the repository is a fork (with an upstream remote and a fork remote):

Make sure that release branches are tracking the right remote, e.g. master should probably track original upstream's master rather than master of your fork.
Consider keeping your fork's remote master up to date (using git push).

Support

Please report any bugs that you find.

Like this tool? Support it with a star!

Project details

These details have not been verified by PyPI

Project links

Homepage

Release history Release notifications | RSS feed

7.4.1

May 22, 2024

7.4.0

Dec 23, 2022

7.3.1

Dec 13, 2022

7.3.0

Dec 13, 2022

7.2.2

Nov 27, 2022

7.2.1

Nov 26, 2022

7.2.0

Aug 18, 2022

7.0.0

Jul 29, 2022

6.4.0

Aug 26, 2021

6.3.0

Aug 22, 2021

6.2.0

Aug 16, 2021

6.1.0

Aug 13, 2021

6.0.5

Oct 7, 2020

6.0.4

Sep 30, 2020

6.0.3

Sep 15, 2020

6.0.2

Aug 19, 2020

6.0.1

Aug 19, 2020

6.0.0

Aug 18, 2020

5.4.0

Aug 17, 2020

5.3.1

Aug 16, 2020

5.3.0

Aug 14, 2020

5.2.1

Aug 13, 2020

5.1.1

Aug 13, 2020

5.1.0

Aug 12, 2020

5.0.0

Aug 11, 2020

4.1.0

Aug 9, 2020

4.0.1

Aug 8, 2020

This version

4.0.0

Aug 5, 2020

3.1.0

Aug 5, 2020

3.0.0

Aug 3, 2020

2.0.1

Aug 1, 2020

2.0.0

Aug 1, 2020

1.2.1

Jul 29, 2020

1.2.0

Jul 28, 2020

1.1.2

Jul 27, 2020

1.1.1

Jul 26, 2020

1.1.0

Jul 23, 2020

1.0.0

Jul 22, 2020

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

git-delete-merged-branches-4.0.0.tar.gz (12.2 kB view details)

Uploaded Aug 5, 2020 Source

Built Distribution

git_delete_merged_branches-4.0.0-py3-none-any.whl (14.6 kB view details)

Uploaded Aug 5, 2020 Python 3

File details

Details for the file git-delete-merged-branches-4.0.0.tar.gz.

File metadata

Download URL: git-delete-merged-branches-4.0.0.tar.gz
Upload date: Aug 5, 2020
Size: 12.2 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/46.4.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.7.8

File hashes

Hashes for git-delete-merged-branches-4.0.0.tar.gz
Algorithm	Hash digest
SHA256	`51fd17ff98a13229f0cfd4741fd6bfad946cf78da0d17a55d488c35cbeecde1c`
MD5	`7da7f2ad782bd2949967aea819a449f8`
BLAKE2b-256	`661d26d008166e8dad9b7fec21fc0fa3a7d78b0f15993417bbefb5cf13b3143c`

See more details on using hashes here.

File details

Details for the file git_delete_merged_branches-4.0.0-py3-none-any.whl.

File metadata

Download URL: git_delete_merged_branches-4.0.0-py3-none-any.whl
Upload date: Aug 5, 2020
Size: 14.6 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/46.4.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.7.8

File hashes

Hashes for git_delete_merged_branches-4.0.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`85c702d4369b8df28d3705f685861d9f985514ee36bebf6c05d0dd858ac589c7`
MD5	`2324150e204865a22d9e7624e66bac47`
BLAKE2b-256	`431202524717ab1347971f01b1f2ef751f3159627110a6443fb2d49671b036fd`