Skip to main content

Git Recover One Deleted File Among Many

Git can include many files in a single commit. You can modify, add, or delete multiple files, then commit the new state of the working directory.

What if we deleted multiple files, and now we need to recover in Git some but not all of what has been deleted?

Since Git tracks the state of our repository as a series of snapshots (aka Commits) in time, we can recover the file by looking at a past snapshot / commit and “checking out” the resource(s) we must recover.

For example: Let's say that a few days ago I deleted several files from the Git repository. I deleted them on my local, committed the change, and pushed to the server. Other developers have done many other commits since then.

Now, it turns out one of the files is needed after all, but the others should remain deleted. How to get the one file back?

I will show some Git command-line steps to retrieve it. There are other ways, using your IDE, File Explorer, Tortoise or your UI of choice. But the command-line shows best what has to happen.


$ git rev-list -n 1 HEAD -- src/js/SomeOldFile.js
b654fa9411d11624035c7e2eacb69caa65399782

The first step is to see what commit in our repository history last referred to the file to be restored. The command “git rev-list” lists commits in reverse-chronological order. I specified “-n 1” because I was only interested in 1 commit: the most recent, i.e. the commit that deleted the file. 

“HEAD” tells the command where to start from. In my case, I wanted to start from the HEAD commit, which was currently pointing to the most recent commit on the dev branch. 

“-- WebContent/Common/InfoPopupPos.js” specifies the file that we are interested in.

The result is the name of the last commit in which that file was affected: “b654fa9411d11624035c7e2eacb69caa65399782”

$ git checkout b654fa94^ src/js/SomeOldFile.js

Next, we ask git to put into the Working Directory the deleted file as it looked right before the commit that deleted it.

“git checkout” is the command to check out a branch or a certain moment in history snapshot.

“b654fa94^” is the start of the commit name. I don’t want to type the whole commit name, so I give it enough for git to know which one I mean.

Notice the “^” at the end of the commit name. That character tells git that we don’t want the commit, we want the state of the file right before that commit.

If we stop there, the Working Directory would revert to look like our whole code base did at that point in time. But since I want to restore a single file, not the whole repository, we add the file name to the command. The result is that the deleted file is restored to the Working Directory, and everything else remains at the present state.

We would expect that we now have 1 new file change to commit. Let’s check:

$ git status
On branch dev
Your branch is up-to-date with 'origin/dev'.
Changes to be committed:
        new file:   src/js/SomeOldFile.js

Just as expected, the deleted file has appeared in the Working Directory. Now we still need to commit it to be sure to keep it. (Actually, since the file is ready to be committed, it added the file not just to the Working Directory, but also to the Index).

$ git commit -m "Restore SomeOldFile.js since it is used after all"
[dev 748f49b] Restore SomeOldFile.js since it is used after all
 1 file changed, 53 insertions(+)

The file is now committed to the local repository. Let’s check the status again, to verify that. We should expect nothing local to commit, but a difference between the local repository and the server repository upstream:

$ git status
On branch dev
Your branch is ahead of 'origin/dev' by 1 commit.
nothing to commit, working tree clean

Good. Our change is committed locally, and is ready to push to the server. As always, do a pull before attempting any push.

$ git pull
Current branch dev is up to date.

$ git push
Counting objects: 5, done.
Compressing objects: 100% (5/5), done.
Writing objects: 100% (5/5), 962 bytes | 0 bytes/s, done.
Total 5 (delta 2), reused 0 (delta 0)

Done! We have now used Git to restore a file that had been deleted, committed and pushed several days ago, and many other commits had happened since then. There were many other ways to accomplish it, but the steps were:
  • Find the commit that deleted the file;
  • Restore (“check out”) the file from the commit before the one that deleted it;
  • Commit it locally;
  • Push it to the central repository.


Labels:

Popular posts from this blog

How to do Git Rebase in Eclipse

This is an abbreviated version of a fuller post about Git Rebase in Eclipse. See the longer one here : One side-effect of merging Git branches is that it leaves a Merge commit. This can create a history view something like: The clutter of parallel lines shows the life spans of those local branches, and extra commits (nine in the above screen-shot, marked by the green arrows icon). Check out this extreme-case history:  http://agentdero.cachefly.net/unethicalblogger.com/images/branch_madness.jpeg Merge Commits show all the gory details of how the code base evolved. For some teams, that’s what they want or need, all the time. Others may find it unnecessarily long and cluttered. They prefer the history to tell the bigger story, and not dwell on tiny details like every trivial Merge-commit. Git Rebase offers us 2 benefits over Git Merge: First, Rebase allows us to clean up a set of local commits before pushing them to the shared, central repository. For this
Read more

Java 8: Rewrite For-loops using Stream API

Java 8 Tip: Anytime you write a Java For-loop, ask yourself if you can rewrite it with the Streams API. Now that I have moved to Java 8 in my work and home development, whenever I want to use a For-loop, I write it and then see if I can rewrite it using the Stream API. For example: I have an object called myThing, some Collection-like data structure which contains an arbitrary number of Fields. Something has happened, and I want to set all of the fields to some common state, in my case "Hidden"
Read more

Git Reset in Eclipse

Using Git and the Eclipse IDE, you have a series of commits in your branch history, but need to back up to an earlier version. The Git Reset feature is a powerful tool with just a whiff of danger, and is accessible with just a couple clicks in Eclipse. In Eclipse, switch to the History view. In my example it shows a series of 3 changes, 3 separate committed versions of the Person file. After commit 6d5ef3e, the HEAD (shown), Index, and Working Directory all have the same version, Person 3.0.
Read more

Code Coverage in C#.NET Unit Tests - Setting up OpenCover

The purpose of this post is to be a brain-dump for how we set up and used OpenCover and ReportGenerator command-line tools for code coverage analysis and reporting in our projects. The documentation made some assumptions that took some digging to fully understand, so to save my (and maybe others') time and effort in the future, here are my notes. Our project, which I will call CEP for short, includes a handful of sub-projects within the same solution. They are a mix of Web APIs, ASP MVC applications and Class libraries. For Unit Tests, we chose to write them using the MSTest framework, along with the Moq mocking framework. As the various sub-projects evolved, we needed to know more about the coverage of our automated tests. What classes, methods and instructions had tests exercising them, and what ones did not? Code Coverage tools are conveniently built-in for Visual Studio 2017 Enterprise Edition, but not for our Professional Edition installations. Much less for any Commun
Read more

Scala Collections: A Group of groupBy() Examples

Scala provides a rich Collections API. Let's look at the useful groupBy() function. What does groupBy() do? It takes a collection, assesses each item in that collection against a discriminator function, and returns a Map data structure. Each key in the returned map is a distinct result of the discriminator function, and the key's corresponding value is another collection which contains all elements of the original one that evaluate the same way against the discriminator function. So, for example, here is a collection of Strings: val sports = Seq ("baseball", "ice hockey", "football", "basketball", "110m hurdles", "field hockey") Running it through the Scala interpreter produces this output showing our value's definition: sports: Seq[String] = List(baseball, ice hockey, football, basketball, 110m hurdles, field hockey) We can group those sports names by, say, their first letter. To do so, we need a disc
Read more