// Copyright (C) 2017-2018 Luke Shumaker // // This program is free software: you can redistribute it and/or modify // it under the terms of the GNU Affero General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU Affero General Public License for more details. // // You should have received a copy of the GNU Affero General Public License // along with this program. If not, see . // Package textproto implements low-level details of the fast-import // format. // // This package deals with parsing and marshalling idiosyncratic // datatypes used by the format (Ident tuples, 18-bit Mode numbers, // oddly-quoted Path strings), and abstracting over special-case // commands that break the "line-based" nature of the format (the // "data" command, responses to the "cat-blob" command). package textproto import ( "bufio" "fmt" "io" "strconv" "strings" ) // FIReader is a low-level parser of a fast-import stream. type FIReader struct { r *bufio.Reader line *string err error } // NewFIReader creates a new FIReader parser. func NewFIReader(r io.Reader) *FIReader { return &FIReader{ r: bufio.NewReader(r), } } // ReadLine reads a "line" from the stream; with special handling for // the "data" command, which isn't really a single line, but rather // contains arbitrary binary data. func (fir *FIReader) ReadLine() (line string, err error) { for len(line) <= 1 { line, err = fir.r.ReadString('\n') if err != nil { return } } if strings.HasPrefix(line, "data ") { if line[5:7] == "<<" { // Delimited format delim := line[7 : len(line)-1] suffix := "\n" + delim + "\n" for !strings.HasSuffix(line, suffix) { var _line string _line, err = fir.r.ReadString('\n') line += _line if err != nil { return } } } else { // Exact byte count format var size int size, err = strconv.Atoi(line[5 : len(line)-1]) if err != nil { return } data := make([]byte, size) _, err = io.ReadFull(fir.r, data) line += string(data) } } return } // FIWriter is a low-level marshaller of a fast-import stream. type FIWriter struct { w io.Writer } // NewFIWriter creates a new FIWriter marshaller. func NewFIWriter(w io.Writer) *FIWriter { return &FIWriter{ w: w, } } // WriteLine writes an ordinary line to the stream; arguments are // handled similarly to fmt.Println. func (fiw *FIWriter) WriteLine(a ...interface{}) error { _, err := fmt.Fprintln(fiw.w, a...) return err } // WriteData writes a 'data' command to the stream. func (fiw *FIWriter) WriteData(data string) error { err := fiw.WriteLine("data", len(data)) if err != nil { return err } _, err = io.WriteString(fiw.w, data) return err } // CatBlobReader is a low-level parser of an fast-import auxiliary // "cat-blob" stream. type CatBlobReader struct { r *bufio.Reader } // NewCatBlobReader creates a new CatBlobReader parser. func NewCatBlobReader(r io.Reader) *CatBlobReader { return &CatBlobReader{ r: bufio.NewReader(r), } } // ReadLine reads a response from the stream; with special handling // for responses to "cat-blob" commands, which contain multiple // newline characters. func (cbr *CatBlobReader) ReadLine() (line string, err error) { for len(line) <= 1 { line, err = cbr.r.ReadString('\n') if err != nil { return } } // get-mark : LF // cat-blob : SP 'blob' SP LF LF // ls : SP ('blob' | 'tree' | 'commit') SP HT LF // ls : 'missing' SP LF // decide if we have a cat-blob result if len(line) <= 46 || line[40:46] != " blob " { return } for _, b := range line[:40] { if !(('0' <= b && b <= '9') || ('a' <= b && b <= 'f')) { return } } // we have a cat-blob result var size int size, err = strconv.Atoi(line[46 : len(line)-1]) if err != nil { return } data := make([]byte, size+1) _, err = io.ReadFull(cbr.r, data) line += string(data[:size]) return } // CatBlobWriter is a low-level marshaller for an auxiliary cat-blob // stream. type CatBlobWriter struct { w io.Writer } // NewCatBlobWriter creates a new CatBlobWriter marshaller. func NewCatBlobWriter(w io.Writer) *CatBlobWriter { return &CatBlobWriter{ w: w, } } // WriteLine writes a response (to a command OTHER THAN "cat-blob") to // the stream; arguments are handled similarly to fmt.Println. // // Use WriteBlob instead to write responses to "cat-blob" commands. func (cbw *CatBlobWriter) WriteLine(a ...interface{}) error { _, err := fmt.Fprintln(cbw.w, a...) return err } // WriteBlob writes a response to a "cat-blob" command to the stream. func (cbw *CatBlobWriter) WriteBlob(sha1 string, data string) error { err := cbw.WriteLine(sha1, "blob", len(data)) if err != nil { return err } _, err = io.WriteString(cbw.w, data) return err }