77 lines
1.5 KiB
Markdown
77 lines
1.5 KiB
Markdown
|
---
|
||
|
|
stage: none
|
||
|
|
group: unassigned
|
||
|
|
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
|
||
|
|
comments: false
|
||
|
|
---
|
||
|
|
|
||
|
|
# Bisect
|
||
|
|
|
||
|
|
- Find a commit that introduced a bug
|
||
|
|
- Works through a process of elimination
|
||
|
|
- Specify a known good and bad revision to begin
|
||
|
|
|
||
|
|
## Bisect sample workflow
|
||
|
|
|
||
|
|
1. Start the bisect process
|
||
|
|
1. Enter the bad revision (usually latest commit)
|
||
|
|
1. Enter a known good revision (commit/branch)
|
||
|
|
1. Run code to see if bug still exists
|
||
|
|
1. Tell bisect the result
|
||
|
|
1. Repeat the previous 2 items until you find the offending commit
|
||
|
|
|
||
|
|
## Setup
|
||
|
|
|
||
|
|
```shell
|
||
|
|
mkdir bisect-ex
|
||
|
|
cd bisect-ex
|
||
|
|
touch index.html
|
||
|
|
git add -A
|
||
|
|
git commit -m "starting out"
|
||
|
|
vi index.html
|
||
|
|
# Add all good
|
||
|
|
git add -A
|
||
|
|
git commit -m "second commit"
|
||
|
|
vi index.html
|
||
|
|
# Add all good 2
|
||
|
|
git add -A
|
||
|
|
git commit -m "third commit"
|
||
|
|
vi index.html
|
||
|
|
```
|
||
|
|
|
||
|
|
```shell
|
||
|
|
# Add all good 3
|
||
|
|
git add -A
|
||
|
|
git commit -m "fourth commit"
|
||
|
|
vi index.html
|
||
|
|
# This looks bad
|
||
|
|
git add -A
|
||
|
|
git commit -m "fifth commit"
|
||
|
|
vi index.html
|
||
|
|
# Really bad
|
||
|
|
git add -A
|
||
|
|
git commit -m "sixth commit"
|
||
|
|
vi index.html
|
||
|
|
# again just bad
|
||
|
|
git add -A
|
||
|
|
git commit -m "seventh commit"
|
||
|
|
```
|
||
|
|
|
||
|
|
## Commands
|
||
|
|
|
||
|
|
```shell
|
||
|
|
git bisect start
|
||
|
|
# Test your code
|
||
|
|
git bisect bad
|
||
|
|
git bisect next
|
||
|
|
# Say yes to the warning
|
||
|
|
# Test
|
||
|
|
git bisect good
|
||
|
|
# Test
|
||
|
|
git bisect bad
|
||
|
|
# Test
|
||
|
|
git bisect good
|
||
|
|
# done
|
||
|
|
git bisect reset
|
||
|
|
```
|