https://github.com/lzap/git-xcleaner

TUI utility for fast git topic branch cleanup
https://github.com/lzap/git-xcleaner

Last synced: 2 months ago
JSON representation

TUI utility for fast git topic branch cleanup

• Host: GitHub
• URL: https://github.com/lzap/git-xcleaner
• Owner: lzap
• License: gpl-2.0
• Created: 2014-07-23T12:35:38.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2024-04-30T15:12:42.000Z (8 months ago)
• Last Synced: 2024-10-14T23:25:03.330Z (3 months ago)
• Language: Shell
• Size: 55.7 KB
• Stars: 20
• Watchers: 5
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
git-xcleaner

============

TUI utility for interactive and fast git topic branch cleanup. Upstream site

at https://github.com/lzap/git-xcleaner

![Main menu](https://raw.githubusercontent.com/lzap/git-xcleaner/master/screenshots/01_main_menu.png)

![Selection](https://raw.githubusercontent.com/lzap/git-xcleaner/master/screenshots/02_select.png)

[![Short demonstration](http://img.youtube.com/vi/nKIRFqD02nQ/0.jpg)](https://www.youtube.com/watch?v=nKIRFqD02nQ)

Requirements

------------

* bash

* whiptail

* resize

Usage

-----

Install package or drop git-xcleaner on your path and

    $ git xcleaner

I *DO NOT* recommend running garbage collection after cleanup, this can wipe

mis-deleted branches:

    $ git gc

If you want to do this, do it *prior* running cleaning, so you are still able

to recover after few weeks.

Also, it is a good idea to prune branches prior cleaning:

    $ git fetch --prune

Installation

------------

On Fedora do `yum install git-xcleaner`, on other distros do this:

    TARGET=/usr/local/bin/git-xcleaner

    curl https://raw.githubusercontent.com/lzap/git-xcleaner/master/git-xcleaner > $TARGET

    chmod +x $TARGET

Documentation

-------------

See the [manual page](man/git-xcleaner.md).

How to undelete

---------------

If you mis-deleted a branch and ignored all the warnings in documentation and

on the screen, check out this file which contains all the deleted branch names

and commit shas:

    $ cat ~/.git-xcleaner.log

    Deleted branch feature_42 (was d82f87f).

    Deleted branch feature_21 (was 796b718).

Now you know the sha, if you haven't run git garbage collection, you can still

restore the branch with:

    $ git checkout d82f87f

    $ git checkout -b restored_branch_name

Authors

-------

* Lukáš Zapletal (lzap_at_redhat_dot_com)

License

-------

GNU GPL v2. See the LICENSE file.

TODO

----

* Fedora package

* show some details for each branch (sha, last commit message)

* fuzzy comparison of commit messages