{"id":6383,"date":"2014-12-16T17:43:18","date_gmt":"2014-12-16T17:43:18","guid":{"rendered":"http:\/\/livecode.com\/?p=6383"},"modified":"2014-12-16T17:43:18","modified_gmt":"2014-12-16T17:43:18","slug":"using-git-bisect-to-find-a-buggy-commit","status":"publish","type":"post","link":"https:\/\/legacy.livecode.com\/using-git-bisect-to-find-a-buggy-commit\/","title":{"rendered":"Using git bisect to find a buggy commit"},"content":{"rendered":"

During the last month I have been switching between translating the IDE to Greek, and refining LC 6.7 and 7.0 releases, in terms of fixing bugs. Some bugs are quite easy to fix. Some others though, can be quite tricky. The first thing to do is locate where the bug comes from, and the next step is to actually fix it. In some cases, tracking down the cause of the bug is not that obvious. However, if you can find a previous version of the code where the bug was not present, then you can use some Git tools to find the specific commit in the history which introduced the bug. You could try to check out each commit, build it, and check if the bug is present or not. Usually there are a large number of commits, so this can take a really long time. This is a linear search. Hopefully, we can do much better by doing a binary search. \u00a0This is where the git bisect<\/span><\/span> command comes in.<\/p>\n

What is git bisect?<\/b><\/p>\n

Git bisect is an extremely useful command in the Git version control system. The bisect command does a binary search through your commit history to help you identify which commit introduced an issue. It is quite quick. Imagine that between a working version of the code and a buggy one, there are a few hundreds commits, say N. Using git bisect requires only log(N) steps!<\/p>\n

How to use it?<\/strong><\/p>\n

1. You start by specifying two states, a bad and a good one. A state can be a commit hash, a branch name, or a tag name:<\/p>\n


\"code1panos\"<\/a><\/p>\n

In this example, HEAD is the current revision (ie the bad one), and 6.7.0-dp-6 is a tag of a good revision.<\/p>\n

2. We then test it for the presence of the bug. We inform Git if the bug is there by running git bisect good, or git bisect bad:<\/p>\n

\"code2panos\"<\/a><\/p>\n

3. Repeating the same process bring us closer to the faulty commit:<\/p>\n

\"codepanos3\"<\/a><\/p>\n

4. If we ever arrive at a commit that won’t build for a known or irrelevant reason, or if we just don’t know if the specific revision is good or bad, then we simply run git bisect skip. It doesn\u2019t define it as good or bad, picks a neighbor commit and moves on:<\/p>\n

\"codepanos4\"<\/a><\/p>\n

5. Voil\u00e0! We fould the commit that introduced the bug!<\/p>\n

\"codepanos5\"<\/a><\/p>\n

After finding the problematic commit, we can see the diffs in github, and find out the cause of the bug.<\/p>\n

6. We then move back to the HEAD (git bisect reset) and fix the bug!
<\/span><\/p>\n

\"codepanos6\"<\/a><\/p>\n

 <\/p>\n","protected":false},"excerpt":{"rendered":"

During the last month I have been switching between translating the IDE to Greek, and refining LC 6.7 and 7.0 releases, in terms of fixing bugs. Some bugs are quite easy to fix. Some others though, can be quite tricky. The first thing to do is locate where the bug comes from, and the next<\/p>\n","protected":false},"author":20,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"om_disable_all_campaigns":false,"footnotes":""},"categories":[45],"tags":[],"class_list":["post-6383","post","type-post","status-publish","format-standard","hentry","category-blog"],"acf":[],"_links":{"self":[{"href":"https:\/\/legacy.livecode.com\/wp-json\/wp\/v2\/posts\/6383","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/legacy.livecode.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/legacy.livecode.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/legacy.livecode.com\/wp-json\/wp\/v2\/users\/20"}],"replies":[{"embeddable":true,"href":"https:\/\/legacy.livecode.com\/wp-json\/wp\/v2\/comments?post=6383"}],"version-history":[{"count":0,"href":"https:\/\/legacy.livecode.com\/wp-json\/wp\/v2\/posts\/6383\/revisions"}],"wp:attachment":[{"href":"https:\/\/legacy.livecode.com\/wp-json\/wp\/v2\/media?parent=6383"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/legacy.livecode.com\/wp-json\/wp\/v2\/categories?post=6383"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/legacy.livecode.com\/wp-json\/wp\/v2\/tags?post=6383"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}