TIFU (Today I Fucked Up)
TIFU is a tool that helps to restore commits erased by a force push on Github, Gitlab and Bitbucket.
Just clone, install dependencies, and you're ready to go!
git clone email@example.com:c0riolis/tifu.git cd tifu pip3 install -r requirements.txt --user ./tifu.py --help
How to use it?
The simplest way to run the tool is to launch it with a remote as argument:
It will automatically infer the API, repository name and hostname to use.
If you want to run it on your own instance of Gitlab for example, this will fail since the tool can't determine which API to use. Just specify it:
./tifu.py firstname.lastname@example.org:namespace/project.git --api gitlab
This is equivalent to the following command:
./tifu.py --api gitlab --host mydomain.com --repo namespace/project
You can also just connect to a specific API and select the repository interactively:
./tifu.py --api bitbucket
Which works for your own instances as well:
./tifu.py --api github --host mydomain.com
usage: tifu.py [-h] [-a] [--host HOST] [-n REPO] [remote] positional arguments: remote git remote optional arguments: -h, --help show this help message and exit -a , --api API to use (github, gitlab, bitbucket) --host HOST server hostname -r REPO, --repo REPO repository name (namespace/project)
How does it work?
Git repository managers are usually using event systems to build users' threads. These events are accessible via APIs and are providing various pieces of information.
In this case, we are using events generated on push to get the ID of the previous HEAD and create a branch pointing to it.
Old HEAD's objects are usually still available since they are not removed until the repository is garbage collected on the server side.