gotosocial/vendor/codeberg.org/gruf/go-store/kv/state.go

package kv

import (
	"io"
	"sync"

	"codeberg.org/gruf/go-errors"
)

var ErrStateClosed = errors.New("store/kv: state closed")

// StateRO provides a read-only window to the store. While this
// state is active during the Read() function window, the entire
// store will be read-locked. The state is thread-safe for concurrent
// use UNTIL the moment that your supplied function to Read() returns,
// then the state has zero guarantees
type StateRO struct {
	store *KVStore
	mutex sync.RWMutex
}

func (st *StateRO) Get(key string) ([]byte, error) {
	// Get state read lock
	st.mutex.RLock()
	defer st.mutex.RUnlock()

	// Check not closed
	if st.store == nil {
		return nil, ErrStateClosed
	}

	// Pass request to store
	return st.store.get(st.store.mutexMap.RLock, key)
}

func (st *StateRO) GetStream(key string) (io.ReadCloser, error) {
	// Get state read lock
	st.mutex.RLock()
	defer st.mutex.RUnlock()

	// Check not closed
	if st.store == nil {
		return nil, ErrStateClosed
	}

	// Pass request to store
	return st.store.getStream(st.store.mutexMap.RLock, key)
}

func (st *StateRO) Has(key string) (bool, error) {
	// Get state read lock
	st.mutex.RLock()
	defer st.mutex.RUnlock()

	// Check not closed
	if st.store == nil {
		return false, ErrStateClosed
	}

	// Pass request to store
	return st.store.has(st.store.mutexMap.RLock, key)
}

func (st *StateRO) Release() {
	// Get state write lock
	st.mutex.Lock()
	defer st.mutex.Unlock()

	// Release the store
	if st.store != nil {
		st.store.mutex.RUnlock()
		st.store = nil
	}
}

// StateRW provides a read-write window to the store. While this
// state is active during the Update() function window, the entire
// store will be locked. The state is thread-safe for concurrent
// use UNTIL the moment that your supplied function to Update() returns,
// then the state has zero guarantees
type StateRW struct {
	store *KVStore
	mutex sync.RWMutex
}

func (st *StateRW) Get(key string) ([]byte, error) {
	// Get state read lock
	st.mutex.RLock()
	defer st.mutex.RUnlock()

	// Check not closed
	if st.store == nil {
		return nil, ErrStateClosed
	}

	// Pass request to store
	return st.store.get(st.store.mutexMap.RLock, key)
}

func (st *StateRW) GetStream(key string) (io.ReadCloser, error) {
	// Get state read lock
	st.mutex.RLock()
	defer st.mutex.RUnlock()

	// Check not closed
	if st.store == nil {
		return nil, ErrStateClosed
	}

	// Pass request to store
	return st.store.getStream(st.store.mutexMap.RLock, key)
}

func (st *StateRW) Put(key string, value []byte) error {
	// Get state read lock
	st.mutex.RLock()
	defer st.mutex.RUnlock()

	// Check not closed
	if st.store == nil {
		return ErrStateClosed
	}

	// Pass request to store
	return st.store.put(st.store.mutexMap.Lock, key, value)
}

func (st *StateRW) PutStream(key string, r io.Reader) error {
	// Get state read lock
	st.mutex.RLock()
	defer st.mutex.RUnlock()

	// Check not closed
	if st.store == nil {
		return ErrStateClosed
	}

	// Pass request to store
	return st.store.putStream(st.store.mutexMap.Lock, key, r)
}

func (st *StateRW) Has(key string) (bool, error) {
	// Get state read lock
	st.mutex.RLock()
	defer st.mutex.RUnlock()

	// Check not closed
	if st.store == nil {
		return false, ErrStateClosed
	}

	// Pass request to store
	return st.store.has(st.store.mutexMap.RLock, key)
}

func (st *StateRW) Delete(key string) error {
	// Get state read lock
	st.mutex.RLock()
	defer st.mutex.RUnlock()

	// Check not closed
	if st.store == nil {
		return ErrStateClosed
	}

	// Pass request to store
	return st.store.delete(st.store.mutexMap.Lock, key)
}

func (st *StateRW) Release() {
	// Get state write lock
	st.mutex.Lock()
	defer st.mutex.Unlock()

	// Release the store
	if st.store != nil {
		st.store.mutex.Unlock()
		st.store = nil
	}
}