Files
gitea-tea/internal/terminal/safe_writer.go
T
bircni b86fcb2ff5 fix(pr): strip terminal control sequences from pr diff on a terminal
pr diff copied the server's patch bytes straight to stdout, so a pull
request could change the terminal title, clear the screen or move the
cursor of whoever viewed its diff. Add terminal.SafeWriter, which
filters streamed server text like terminal.SafeText when stdout is a
terminal, and use it for pr diff. Piped output stays byte-exact, so
`tea pr diff N | git apply` keeps working.

Signed-off-by: bircni <bircni@icloud.com>
2026-10-11 21:49:14 +02:00

86 lines
2.0 KiB
Go

// Copyright 2026 The Gitea Authors. All rights reserved.
// SPDX-License-Identifier: MIT
package terminal
import (
"io"
"unicode"
"unicode/utf8"
)
// maxSGRLength bounds how many bytes of a possible SGR sequence are held back between writes.
const maxSGRLength = 32
// SafeWriter returns w unchanged when tty is false, so piped output stays byte-exact.
// On a terminal it filters streamed server text like SafeText, and with allowSGR it keeps
// SGR color sequences (ESC [ ... m) while dropping every other escape sequence's ESC.
func SafeWriter(w io.Writer, tty, allowSGR bool) io.Writer {
if !tty {
return w
}
return &safeWriter{w: w, allowSGR: allowSGR}
}
type safeWriter struct {
w io.Writer
allowSGR bool
// pending holds a rune or SGR sequence split across writes.
pending []byte
}
func (s *safeWriter) Write(p []byte) (int, error) {
data := append(s.pending, p...)
out := make([]byte, 0, len(data))
i := 0
for i < len(data) {
if s.allowSGR && data[i] == '\x1b' {
n, complete := sgrLength(data[i:])
if !complete {
break
}
if n == 0 {
i++
continue
}
out = append(out, data[i:i+n]...)
i += n
continue
}
if !utf8.FullRune(data[i:]) {
break
}
r, size := utf8.DecodeRune(data[i:])
if r == '\t' || r == '\n' || !(unicode.IsControl(r) || unicode.Is(unicode.Cf, r)) {
out = utf8.AppendRune(out, r)
}
i += size
}
s.pending = append(s.pending[:0], data[i:]...)
if _, err := s.w.Write(out); err != nil {
return 0, err
}
return len(p), nil
}
// sgrLength returns the length of the SGR sequence at the start of b, which begins with ESC,
// or 0 when b starts another escape sequence. complete is false while b may be a truncated SGR sequence.
func sgrLength(b []byte) (n int, complete bool) {
if len(b) < 2 {
return 0, false
}
if b[1] != '[' {
return 0, true
}
for j := 2; j < len(b); j++ {
c := b[j]
if c == 'm' {
return j + 1, true
}
if j >= maxSGRLength || ((c < '0' || c > '9') && c != ';' && c != ':') {
return 0, true
}
}
return 0, false
}