tarstream

README

tarstream

golang library for streaming files from filesystem as a tar format

Documentation

Index

• func GenVec(files []string) (TarVec, []PositionInfo, error)
• func Validate(r io.Reader) (*tar.Header, error)
• type Datavec
• type PositionInfo
• type TarVec
  • func (tv TarVec) GetSize() int64
  • func (tv *TarVec) Read(b []byte) (int, error)
  • func (tv *TarVec) Seek(offset int64, whence int) (int64, error)

Functions

func GenVec

func GenVec(files []string) (TarVec, []PositionInfo, error)

GenVec generates the tarvec and positioninfo from a list of files

func Validate

func Validate(r io.Reader) (*tar.Header, error)

Validate gets and validates the next header within the tarfile

Types

type Datavec

type Datavec interface {
	GetSize() int64
	Open() error
	Close()
	ReadAt(b []byte, off int64) (int, error)
}

Datavec is an interface for all vector types

type PositionInfo

type PositionInfo struct {
	Name   string
	Offset int64
	Size   int64
}

PositionInfo stores information on where files get placed in the tarball

type TarVec

type TarVec struct {
	Dvecs []Datavec
	Pos   int64
	Size  int64
}

TarVec is an array of datavecs representing a tarball

func (TarVec) GetSize

func (tv TarVec) GetSize() int64

GetSize gets the size of the tarball represented by the tarvec

func (*TarVec) Read

func (tv *TarVec) Read(b []byte) (int, error)

Read the data represented by the tarvec

func (*TarVec) Seek

func (tv *TarVec) Seek(offset int64, whence int) (int64, error)

Seek the virtual offset of the tarvec