badger

README

go-ds-badger

Datastore implementation using badger as backend.

Documentation

https://godoc.org/github.com/ipfs/go-ds-badger

Contribute

Feel free to join in. All welcome. Open an issue!

This repository falls under the IPFS Code of Conduct.

Want to hack on IPFS?

License

MIT

Documentation

Index

• Variables
• type Datastore
  • func NewDatastore(path string, options *Options) (*Datastore, error)
  • func (d *Datastore) Batch() (ds.Batch, error)
  • func (d *Datastore) Close() error
  • func (d *Datastore) CollectGarbage() error
  • func (d *Datastore) Delete(key ds.Key) error
  • func (d *Datastore) DiskUsage() (uint64, error)
  • func (d *Datastore) Get(key ds.Key) (value []byte, err error)
  • func (d *Datastore) GetExpiration(key ds.Key) (time.Time, error)
  • func (d *Datastore) GetSize(key ds.Key) (size int, err error)
  • func (d *Datastore) Has(key ds.Key) (bool, error)
  • func (d *Datastore) IsThreadSafe()
  • func (d *Datastore) NewTransaction(readOnly bool) (ds.Txn, error)
  • func (d *Datastore) Put(key ds.Key, value []byte) error
  • func (d *Datastore) PutWithTTL(key ds.Key, value []byte, ttl time.Duration) error
  • func (d *Datastore) Query(q dsq.Query) (dsq.Results, error)
  • func (d *Datastore) SetTTL(key ds.Key, ttl time.Duration) error
• type Options

Variables

var DefaultOptions = Options{

	Options: badger.DefaultOptions,
	// contains filtered or unexported fields
}

Types

type Datastore

type Datastore struct {
	DB *badger.DB
	// contains filtered or unexported fields
}

func NewDatastore

func NewDatastore(path string, options *Options) (*Datastore, error)

NewDatastore creates a new badger datastore.

DO NOT set the Dir and/or ValuePath fields of opt, they will be set for you.

func (*Datastore) Batch

func (d *Datastore) Batch() (ds.Batch, error)

func (*Datastore) Close

func (d *Datastore) Close() error

func (*Datastore) CollectGarbage

func (d *Datastore) CollectGarbage() error

func (*Datastore) Delete

func (d *Datastore) Delete(key ds.Key) error

func (*Datastore) DiskUsage

func (d *Datastore) DiskUsage() (uint64, error)

DiskUsage implements the PersistentDatastore interface. It returns the sum of lsm and value log files sizes in bytes.

func (*Datastore) Get

func (d *Datastore) Get(key ds.Key) (value []byte, err error)

func (*Datastore) GetExpiration

func (d *Datastore) GetExpiration(key ds.Key) (time.Time, error)

func (*Datastore) GetSize

func (d *Datastore) GetSize(key ds.Key) (size int, err error)

func (*Datastore) Has

func (d *Datastore) Has(key ds.Key) (bool, error)

func (*Datastore) IsThreadSafe

func (d *Datastore) IsThreadSafe()

func (*Datastore) NewTransaction

func (d *Datastore) NewTransaction(readOnly bool) (ds.Txn, error)

NewTransaction starts a new transaction. The resulting transaction object can be mutated without incurring changes to the underlying Datastore until the transaction is Committed.

func (*Datastore) Put

func (d *Datastore) Put(key ds.Key, value []byte) error

func (*Datastore) PutWithTTL

func (d *Datastore) PutWithTTL(key ds.Key, value []byte, ttl time.Duration) error

func (*Datastore) Query

func (d *Datastore) Query(q dsq.Query) (dsq.Results, error)

func (*Datastore) SetTTL

func (d *Datastore) SetTTL(key ds.Key, ttl time.Duration) error

type Options

type Options struct {
	badger.Options
	// contains filtered or unexported fields
}

Options are the badger datastore options, reexported here for convenience.