persist

Documentation

Index

• Variables
• func Load(meta Metadata, data interface{}, r io.Reader) error
• func LoadFile(meta Metadata, data interface{}, filename string) error
• func NewSafeFile(filename string) (*safeFile, error)
• func RandomSuffix() string
• func Save(meta Metadata, data interface{}, w io.Writer) error
• func SaveFile(meta Metadata, data interface{}, filename string) error
• type BoltDatabase
  • func OpenDatabase(md Metadata, filename string) (*BoltDatabase, error)
  • func (db *BoltDatabase) CloseDatabase() error
• type Metadata

Variables

var (
	ErrNilEntry  = errors.New("entry does not exist")
	ErrNilBucket = errors.New("bucket does not exist")
)

var (
	ErrBadVersion = errors.New("incompatible version")
	ErrBadHeader  = errors.New("wrong header")
)

var NilDB nildb

NilDB is a db whose methods are no-ops. Calls to Block will return the zero value of types.Block. Calls to Height will return 0.

Functions

func Load

func Load(meta Metadata, data interface{}, r io.Reader) error

Load loads json data from a reader.

func LoadFile

func LoadFile(meta Metadata, data interface{}, filename string) error

LoadFile loads json data from a file.

func NewSafeFile

func NewSafeFile(filename string) (*safeFile, error)

func RandomSuffix

func RandomSuffix() string

RandomSuffix returns a 20 character base32 suffix for a filename. There are 100 bits of entropy, and a very low probability of colliding with existing files unintentionally.

func Save

func Save(meta Metadata, data interface{}, w io.Writer) error

Save saves json data to a writer.

func SaveFile

func SaveFile(meta Metadata, data interface{}, filename string) error

SaveFile saves json data to a file.

Types

type BoltDatabase

type BoltDatabase struct {
	Metadata
	*bolt.DB
}

func OpenDatabase

func OpenDatabase(md Metadata, filename string) (*BoltDatabase, error)

openDatabase opens a database filename and checks metadata

func (*BoltDatabase) CloseDatabase

func (db *BoltDatabase) CloseDatabase() error

CloseDatabase saves the bolt database to a file, and updates metadata

type Metadata

type Metadata struct {
	Header, Version string
}

Metadata contains the header and version of the data being stored.