Refactor highlight and diff (#36599)

1. fix a performance regression when using line-by-line highlighting
* the root cause is that chroma's `lexers.Get` is slow and a lexer cache
is missing during recent changes
2. clarify the chroma lexer detection behavior
* now we fully manage our logic to detect lexer, and handle overriding
problems, everything is fully under control
3. clarify "code analyze" behavior, now only 2 usages:
* only use file name and language to detect lexer (very fast), mainly
for "diff" page which contains a lot of files
* if no lexer is detected by file name and language, use code content to
detect again (slow), mainly for "view file" or "blame" page, which can
get best result
4. fix git diff bug, it caused "broken pipe" error for large diff files

modules/git/diff.go

@@ -28,44 +28,37 @@ const (
 
 // GetRawDiff dumps diff results of repository in given commit ID to io.Writer.
 func GetRawDiff(repo *Repository, commitID string, diffType RawDiffType, writer io.Writer) (retErr error) {
-	diffOutput, diffFinish, err := getRepoRawDiffForFile(repo.Ctx, repo, "", commitID, diffType, "")
+	cmd, err := getRepoRawDiffForFileCmd(repo.Ctx, repo, "", commitID, diffType, "")
 	if err != nil {
-		return err
+		return fmt.Errorf("getRepoRawDiffForFileCmd: %w", err)
 	}
-	defer func() {
-		err := diffFinish()
-		if retErr == nil {
-			retErr = err // only return command's error if no previous error
-		}
-	}()
-	_, err = io.Copy(writer, diffOutput)
-	return err
+	return cmd.WithStdoutCopy(writer).RunWithStderr(repo.Ctx)
 }
 
 // GetFileDiffCutAroundLine cuts the old or new part of the diff of a file around a specific line number
 func GetFileDiffCutAroundLine(
 	repo *Repository, startCommit, endCommit, treePath string,
 	line int64, old bool, numbersOfLine int,
-) (_ string, retErr error) {
-	diffOutput, diffFinish, err := getRepoRawDiffForFile(repo.Ctx, repo, startCommit, endCommit, RawDiffNormal, treePath)
+) (ret string, retErr error) {
+	cmd, err := getRepoRawDiffForFileCmd(repo.Ctx, repo, startCommit, endCommit, RawDiffNormal, treePath)
 	if err != nil {
-		return "", err
+		return "", fmt.Errorf("getRepoRawDiffForFileCmd: %w", err)
 	}
-	defer func() {
-		err := diffFinish()
-		if retErr == nil {
-			retErr = err // only return command's error if no previous error
-		}
-	}()
-	return CutDiffAroundLine(diffOutput, line, old, numbersOfLine)
+	stdoutReader, stdoutClose := cmd.MakeStdoutPipe()
+	defer stdoutClose()
+	cmd.WithPipelineFunc(func(ctx gitcmd.Context) error {
+		ret, err = CutDiffAroundLine(stdoutReader, line, old, numbersOfLine)
+		return err
+	})
+	return ret, cmd.RunWithStderr(repo.Ctx)
 }
 
 // getRepoRawDiffForFile returns an io.Reader for the diff results of file in given commit ID
 // and a "finish" function to wait for the git command and clean up resources after reading is done.
-func getRepoRawDiffForFile(ctx context.Context, repo *Repository, startCommit, endCommit string, diffType RawDiffType, file string) (io.Reader, func() gitcmd.RunStdError, error) {
+func getRepoRawDiffForFileCmd(_ context.Context, repo *Repository, startCommit, endCommit string, diffType RawDiffType, file string) (*gitcmd.Command, error) {
 	commit, err := repo.GetCommit(endCommit)
 	if err != nil {
-		return nil, nil, err
+		return nil, err
 	}
 	var files []string
 	if len(file) > 0 {
@@ -84,7 +77,7 @@ func getRepoRawDiffForFile(ctx context.Context, repo *Repository, startCommit, e
 		} else {
 			c, err := commit.Parent(0)
 			if err != nil {
-				return nil, nil, err
+				return nil, err
 			}
 			cmd.AddArguments("diff").
 				AddOptionFormat("--find-renames=%s", setting.Git.DiffRenameSimilarityThreshold).
@@ -99,25 +92,15 @@ func getRepoRawDiffForFile(ctx context.Context, repo *Repository, startCommit, e
 		} else {
 			c, err := commit.Parent(0)
 			if err != nil {
-				return nil, nil, err
+				return nil, err
 			}
 			query := fmt.Sprintf("%s...%s", endCommit, c.ID.String())
 			cmd.AddArguments("format-patch", "--no-signature", "--stdout").AddDynamicArguments(query).AddDashesAndList(files...)
 		}
 	default:
-		return nil, nil, util.NewInvalidArgumentErrorf("invalid diff type: %s", diffType)
+		return nil, util.NewInvalidArgumentErrorf("invalid diff type: %s", diffType)
 	}
-
-	stdoutReader, stdoutReaderClose := cmd.MakeStdoutPipe()
-	err = cmd.StartWithStderr(ctx)
-	if err != nil {
-		stdoutReaderClose()
-		return nil, nil, err
-	}
-	return stdoutReader, func() gitcmd.RunStdError {
-		stdoutReaderClose()
-		return cmd.WaitWithStderr()
-	}, nil
+	return cmd, nil
 }
 
 // ParseDiffHunkString parse the diff hunk content and return
@@ -254,7 +237,7 @@ func CutDiffAroundLine(originalDiff io.Reader, line int64, old bool, numbersOfLi
 		}
 	}
 	if err := scanner.Err(); err != nil {
-		return "", err
+		return "", fmt.Errorf("CutDiffAroundLine: scan: %w", err)
 	}
 
 	// No hunk found

modules/git/gitcmd/command.go

@@ -306,6 +306,10 @@ func (c *Command) MakeStdinPipe() (writer PipeWriter, closer func()) {
 // MakeStdoutPipe creates a reader for the command's stdout.
 // The returned closer function must be called by the caller to close the pipe.
 // After the pipe reader is closed, the unread data will be discarded.
+//
+// If the process (git command) still tries to write after the pipe is closed, the Wait error will be "signal: broken pipe".
+// WithPipelineFunc + Run won't return "broken pipe" error in this case if the callback returns no error.
+// But if you are calling Start / Wait family functions, you should either drain the pipe before close it, or handle the Wait error correctly.
 func (c *Command) MakeStdoutPipe() (reader PipeReader, closer func()) {
 	return c.makeStdoutStderr(&c.cmdStdout)
 }