mirror of
https://github.com/hanzoai/forge.git
synced 2026-10-30 15:00:39 +00:00
zeekayandHanzo Dev
9a07b4d089
2978 files. The fork is 2026-07-15 (rebrand: gitea.dev -> github.com/hanzoai/git), so 2026 is the year, and "Copyright 2026 Hanzo AI, Inc." was already the form used by the handful of files that had ours. Shape is now: // Copyright 2026 Hanzo AI, Inc. All rights reserved. // Copyright 2015 The Gogs Authors. All rights reserved. // Copyright 2019 The Gitea Authors. All rights reserved. // SPDX-License-Identifier: MIT Ours on top, theirs retained verbatim. Retained because MIT requires it, and separately because they are true — those authors did write that code. Not renamed to "The Git Authors": Git is a different project under a different license, and putting its name here would attribute this code to people who have nothing to do with it. Adding our line is the fix; overwriting theirs would have been both a licence violation and a false statement. gofmt still reports import-order drift in some of these files. It predates this change (verified against a stash) and is left alone rather than burying a one-line-per-file legal change under 3000 files of unrelated reordering. Build clean. Co-authored-by: Hanzo Dev <[email protected]>
85 lines
2.6 KiB
Go
85 lines
2.6 KiB
Go
// Copyright 2026 Hanzo AI, Inc. All rights reserved.
|
|
// Copyright 2022 The Gitea Authors. All rights reserved.
|
|
// SPDX-License-Identifier: MIT
|
|
|
|
package foreachref
|
|
|
|
import (
|
|
"encoding/hex"
|
|
"fmt"
|
|
"io"
|
|
"strings"
|
|
)
|
|
|
|
var (
|
|
nullChar = []byte("\x00")
|
|
dualNullChar = []byte("\x00\x00")
|
|
)
|
|
|
|
// Format supports specifying and parsing an output format for 'git
|
|
// for-each-ref'. See git-for-each-ref(1) for available fields.
|
|
type Format struct {
|
|
// fieldNames hold %(fieldname)s to be passed to the '--format' flag of
|
|
// for-each-ref. See git-for-each-ref(1) for available fields.
|
|
fieldNames []string
|
|
|
|
// fieldDelim is the character sequence that is used to separate fields
|
|
// for each reference. fieldDelim and refDelim should be selected to not
|
|
// interfere with each other and to not be present in field values.
|
|
fieldDelim []byte
|
|
// fieldDelimStr is a string representation of fieldDelim. Used to save
|
|
// us from repetitive reallocation whenever we need the delimiter as a
|
|
// string.
|
|
fieldDelimStr string
|
|
// refDelim is the character sequence used to separate reference from
|
|
// each other in the output. fieldDelim and refDelim should be selected
|
|
// to not interfere with each other and to not be present in field
|
|
// values.
|
|
refDelim []byte
|
|
}
|
|
|
|
// NewFormat creates a forEachRefFormat using the specified fieldNames. See
|
|
// git-for-each-ref(1) for available fields.
|
|
func NewFormat(fieldNames ...string) Format {
|
|
return Format{
|
|
fieldNames: fieldNames,
|
|
fieldDelim: nullChar,
|
|
fieldDelimStr: string(nullChar),
|
|
refDelim: dualNullChar,
|
|
}
|
|
}
|
|
|
|
// Flag returns a for-each-ref --format flag value that captures the fieldNames.
|
|
func (f Format) Flag() string {
|
|
var formatFlag strings.Builder
|
|
for i, field := range f.fieldNames {
|
|
// field key and field value
|
|
fmt.Fprintf(&formatFlag, "%s %%(%s)", field, field)
|
|
|
|
if i < len(f.fieldNames)-1 {
|
|
// note: escape delimiters to allow control characters as
|
|
// delimiters. For example, '%00' for null character or '%0a'
|
|
// for newline.
|
|
formatFlag.WriteString(f.hexEscaped(f.fieldDelim))
|
|
}
|
|
}
|
|
formatFlag.WriteString(f.hexEscaped(f.refDelim))
|
|
return formatFlag.String()
|
|
}
|
|
|
|
// Parser returns a Parser capable of parsing 'git for-each-ref' output produced
|
|
// with this Format.
|
|
func (f Format) Parser(r io.Reader) *Parser {
|
|
return NewParser(r, f)
|
|
}
|
|
|
|
// hexEscaped produces hex-escaped characters from a string. For example, "\n\0"
|
|
// would turn into "%0a%00".
|
|
func (f Format) hexEscaped(delim []byte) string {
|
|
var escaped strings.Builder
|
|
for i := range delim {
|
|
escaped.WriteString("%" + hex.EncodeToString([]byte{delim[i]}))
|
|
}
|
|
return escaped.String()
|
|
}
|