persistent

type Picker interface {
	strpick.Picker

	// SoftRemove removes a string from the Picker without removing it from the
	// underlying database. A subsequent Add or LoadDB call will restore its
	// current generation.
	SoftRemove(string) error
	// SoftRemoveAll removes strings from the Picker without removing them from
	// the underlying database. A subsequent Add or LoadDB call will restore
	// their current generations.
	SoftRemoveAll([]string) error

	// LoadDB loads all existing data from the database.
	// Calling this is not necessary, but can be substantially more efficient
	// than calling Add or AddAll.
	LoadDB() error

	// Initialize is equivalent to AddAll but is more efficient when dealing with
	// the majority of the contents of the DB.
	Initialize([]string) error

	// CleanDB deletes any strings not currently present (returned by Values())
	// in this Picker from the database. This includes any strings that have been
	// removed using SoftRemove().
	CleanDB() error
	// DumpDB loads all existing data from the database and returns it as a list
	// of key, value pairs.
	// Useful for debugging or to satisfy curiosity
	DumpDB() ([]kv, error)
}