shttp

package

v1.0.0 Latest Latest Go to latest Published: Mar 17, 2025 License: Apache-2.0, BSD-3-Clause Imports: 7 Imported by: 0

Details

An implementation of io.ReaderAt that works via GET and the Range header.

This was discussed in an article for Gopher Academy in 2017.

This section is empty.

This section is empty.

This section is empty.

type HttpClient interface {
	Do(req *http.Request) (*http.Response, error)
}

type Logger interface {
	Infof(format string, args ...interface{})
	Debugf(format string, args ...interface{})
}

type SeekingHTTP struct {
	URL    string
	Client HttpClient

	Logger Logger
	// contains filtered or unexported fields
}

SeekingHTTP uses a series of HTTP GETs with Range headers to implement io.ReadSeeker and io.ReaderAt.

func New(url string) *SeekingHTTP

New initializes a SeekingHTTP for the given URL. The SeekingHTTP.Client field may be set before the first call to Read or Seek.

func (s *SeekingHTTP) Close() error

func (s *SeekingHTTP) Read(buf []byte) (int, error)

func (s *SeekingHTTP) ReadAt(buf []byte, off int64) (n int, err error)

ReadAt reads len(buf) bytes into buf starting at offset off.

func (s *SeekingHTTP) Seek(offset int64, whence int) (int64, error)

Seek sets the offset for the next Read.

func (s *SeekingHTTP) SetLogger(logger Logger)

func (s *SeekingHTTP) Size() (int64, error)

Size uses an HTTP HEAD to find out how many bytes are available in total.