github.com/Kolosok86/http@v0.1.2/httputil/httputil.go (about)

     1  // Copyright 2014 The Go Authors. All rights reserved.
     2  // Use of this source code is governed by a BSD-style
     3  // license that can be found in the LICENSE file.
     4  
     5  // Package httputil provides HTTP utility functions, complementing the
     6  // more common ones in the net/http package.
     7  package httputil
     8  
     9  import (
    10  	"io"
    11  
    12  	"github.com/Kolosok86/http/internal"
    13  )
    14  
    15  // NewChunkedReader returns a new chunkedReader that translates the data read from r
    16  // out of HTTP "chunked" format before returning it.
    17  // The chunkedReader returns io.EOF when the final 0-length chunk is read.
    18  //
    19  // NewChunkedReader is not needed by normal applications. The http package
    20  // automatically decodes chunking when reading response bodies.
    21  func NewChunkedReader(r io.Reader) io.Reader {
    22  	return internal.NewChunkedReader(r)
    23  }
    24  
    25  // NewChunkedWriter returns a new chunkedWriter that translates writes into HTTP
    26  // "chunked" format before writing them to w. Closing the returned chunkedWriter
    27  // sends the final 0-length chunk that marks the end of the stream but does
    28  // not send the final CRLF that appears after trailers; trailers and the last
    29  // CRLF must be written separately.
    30  //
    31  // NewChunkedWriter is not needed by normal applications. The http
    32  // package adds chunking automatically if handlers don't set a
    33  // Content-Length header. Using NewChunkedWriter inside a handler
    34  // would result in double chunking or chunking with a Content-Length
    35  // length, both of which are wrong.
    36  func NewChunkedWriter(w io.Writer) io.WriteCloser {
    37  	return internal.NewChunkedWriter(w)
    38  }
    39  
    40  // ErrLineTooLong is returned when reading malformed chunked data
    41  // with lines that are too long.
    42  var ErrLineTooLong = internal.ErrLineTooLong