https://github.com/piszmog/lopper
✂️ Deletes dead local Git branches
https://github.com/piszmog/lopper
branches cli delete git merge squash
Last synced: 3 months ago
JSON representation
✂️ Deletes dead local Git branches
- Host: GitHub
- URL: https://github.com/piszmog/lopper
- Owner: Piszmog
- License: mit
- Created: 2022-01-04T01:54:55.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-03-06T23:07:15.000Z (about 2 years ago)
- Last Synced: 2024-06-19T19:48:23.810Z (11 months ago)
- Topics: branches, cli, delete, git, merge, squash
- Language: Go
- Homepage:
- Size: 143 KB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Lopper
[](https://github.com/Piszmog/lopper/actions/workflows/ci.yml)
[](https://img.shields.io/github/v/release/Piszmog/lopper)
[](https://opensource.org/licenses/MIT)
Lopper is a tool that deletes local Git branches that have been merged into the main remote branch.
## What does it do?
Lopper will,
1. Check if there are any uncommitted changes.
2. Checks out the main branch.
3. The main branch is updated (pulled)
4. Lopper retrieves the list of local branches that have been merged commit and squashed merged into the main branch.
5. Lopper deletes the local branches.
See the `Usage` section for more details on modifying the behaviour of Lopper.
## Installation
### Homebrew
Install by running commands
```shell
brew tap piszmog/tools
brew install piszmog/tools/lopper
```
### Manual
Head over to [Releases](https://github.com/Piszmog/lopper/releases) and download the artifact for your architecture.
#### Example Installation
```shell
# Download the latest 64-bit version for Linux
gh release download -R Piszmog/lopper -p '*linux_x86_64*'
# Download the latest 64-bit Intel version for macOS
gh release download -R Piszmog/lopper -p '*macos_x86_64*'
# Download the latest Silicon for macOS
gh release download -R Piszmog/lopper -p '*macos_arm64*'
# Download the latest 64-bit version for Windows
gh release download -R Piszmog/lopper -p '*windows_x86_64*'
# Untar the artifact
tar -xf lopper_0.1.0_linux_x86_64.tar.gz
# Delete the artifact
rm lopper_0.1.0_linux_x86_64.tar.gz
# Move the binary to a directory on your PATH
mv lopper /some/directory/that/is/in/your/path
```
## Usage
```shell
$ ./lopper -p /path/to/repo/or/directory/of/repos
```
### Options
| Option | Default | Required | Description |
|:-----------------------|:-------:|:---------:|:-----------------------------------------------------------------------------------------------------------------------------|
| `--path`, `-p` | N/A | **True** | The path to the repository or directory of repositories |
| `--protected-branch` | N/A | **False** | The branches other than `main` and `master` to protect from deletion (e.g. `--protected-branch dev --protected-pranch prod`) |
| `--concurrency`, `-c` | `1` | **False** | The number of repositories to process in parallel |
| `--dry-run` | `false` | **False** | Run `lopper` without actually deleting any branches |
| `--help`, `-h` | `false` | **False** | Shows help |
### Commands
| Command | Description |
|:------------|:-------------------------------------------------|
| `help`, `h` | Shows a list of commands or help for one command |
## Dependencies
* [bubbles](https://github.com/charmbracelet/bubbles)
* [bubbletea](https://github.com/charmbracelet/bubbletea/)
* [lipgloss](https://github.com/charmbracelet/lipgloss)
* [urfave/cli](https://github.com/urfave/cli)
* [testify](https://github.com/stretchr/testify)