model

Documentation

Overview

Package model implements repository abstraction and file pulling mechanisms

Index

• Constants
• Variables
• type ClusterConfigMismatch
• type ConnectionInfo
• type Model
  • func NewModel(indexDir string, cfg *config.Configuration, clientName, clientVersion string) *Model
  • func (m *Model) AddConnection(rawConn io.Closer, protoConn protocol.Connection)
  • func (m *Model) AddRepo(cfg config.RepositoryConfiguration)
  • func (m *Model) CleanRepos()
  • func (m *Model) Close(node string, err error)
  • func (m *Model) ClusterConfig(nodeID string, config protocol.ClusterConfigMessage)
  • func (m *Model) ConnectedTo(nodeID string) bool
  • func (m *Model) ConnectionStats() map[string]ConnectionInfo
  • func (m *Model) CurrentGlobalFile(repo string, file string) scanner.File
  • func (m *Model) CurrentRepoFile(repo string, file string) scanner.File
  • func (m *Model) GlobalSize(repo string) (files, deleted int, bytes int64)
  • func (m *Model) Index(nodeID string, repo string, fs []protocol.FileInfo)
  • func (m *Model) IndexUpdate(nodeID string, repo string, fs []protocol.FileInfo)
  • func (m *Model) LoadIndexes(dir string)
  • func (m *Model) LocalSize(repo string) (files, deleted int, bytes int64)
  • func (m *Model) NeedFilesRepo(repo string) []scanner.File
  • func (m *Model) NeedSize(repo string) (files int, bytes int64)
  • func (m *Model) Override(repo string)
  • func (m *Model) ReplaceLocal(repo string, fs []scanner.File)
  • func (m *Model) Request(nodeID, repo, name string, offset int64, size int) ([]byte, error)
  • func (m *Model) SaveIndexes(dir string)
  • func (m *Model) ScanRepo(repo string) error
  • func (m *Model) ScanRepos()
  • func (m *Model) StartRepoRO(repo string)
  • func (m *Model) StartRepoRW(repo string, threads int)
  • func (m *Model) State(repo string) string
  • func (m *Model) Version(repo string) uint64

Constants

const (
	RepoIdle repoState = iota
	RepoScanning
	RepoSyncing
	RepoCleaning
)

const (
	MaxChangeHistory = 4
)

Variables

var (
	ErrNoSuchFile = errors.New("no such file")
	ErrInvalid    = errors.New("file is invalid")
)

Types

type ClusterConfigMismatch

type ClusterConfigMismatch error

type ConnectionInfo

type ConnectionInfo struct {
	protocol.Statistics
	Address       string
	ClientVersion string
	Completion    int
}

type Model

type Model struct {
	// contains filtered or unexported fields
}

func NewModel

func NewModel(indexDir string, cfg *config.Configuration, clientName, clientVersion string) *Model

NewModel creates and starts a new model. The model starts in read-only mode, where it sends index information to connected peers and responds to requests for file data without altering the local repository in any way.

func (*Model) AddConnection

func (m *Model) AddConnection(rawConn io.Closer, protoConn protocol.Connection)

AddConnection adds a new peer connection to the model. An initial index will be sent to the connected peer, thereafter index updates whenever the local repository changes.

func (*Model) AddRepo

func (m *Model) AddRepo(cfg config.RepositoryConfiguration)

func (*Model) CleanRepos

func (m *Model) CleanRepos()

func (*Model) Close

func (m *Model) Close(node string, err error)

Close removes the peer from the model and closes the underlying connection if possible. Implements the protocol.Model interface.

func (*Model) ClusterConfig

func (m *Model) ClusterConfig(nodeID string, config protocol.ClusterConfigMessage)

func (*Model) ConnectedTo

func (m *Model) ConnectedTo(nodeID string) bool

ConnectedTo returns true if we are connected to the named node.

func (*Model) ConnectionStats

func (m *Model) ConnectionStats() map[string]ConnectionInfo

ConnectionStats returns a map with connection statistics for each connected node.

func (*Model) CurrentGlobalFile

func (m *Model) CurrentGlobalFile(repo string, file string) scanner.File

func (*Model) CurrentRepoFile

func (m *Model) CurrentRepoFile(repo string, file string) scanner.File

func (*Model) GlobalSize

func (m *Model) GlobalSize(repo string) (files, deleted int, bytes int64)

GlobalSize returns the number of files, deleted files and total bytes for all files in the global model.

func (*Model) Index

func (m *Model) Index(nodeID string, repo string, fs []protocol.FileInfo)

Index is called when a new node is connected and we receive their full index. Implements the protocol.Model interface.

func (*Model) IndexUpdate

func (m *Model) IndexUpdate(nodeID string, repo string, fs []protocol.FileInfo)

IndexUpdate is called for incremental updates to connected nodes' indexes. Implements the protocol.Model interface.

func (*Model) LoadIndexes

func (m *Model) LoadIndexes(dir string)

func (*Model) LocalSize

func (m *Model) LocalSize(repo string) (files, deleted int, bytes int64)

LocalSize returns the number of files, deleted files and total bytes for all files in the local repository.

func (*Model) NeedFilesRepo

func (m *Model) NeedFilesRepo(repo string) []scanner.File

NeedFiles returns the list of currently needed files and the total size.

func (*Model) NeedSize

func (m *Model) NeedSize(repo string) (files int, bytes int64)

NeedSize returns the number and total size of currently needed files.

func (*Model) Override

func (m *Model) Override(repo string)

func (*Model) ReplaceLocal

func (m *Model) ReplaceLocal(repo string, fs []scanner.File)

ReplaceLocal replaces the local repository index with the given list of files.

func (*Model) Request

func (m *Model) Request(nodeID, repo, name string, offset int64, size int) ([]byte, error)

Request returns the specified data segment by reading it from local disk. Implements the protocol.Model interface.

func (*Model) SaveIndexes

func (m *Model) SaveIndexes(dir string)

func (*Model) ScanRepo

func (m *Model) ScanRepo(repo string) error

func (*Model) ScanRepos

func (m *Model) ScanRepos()

func (*Model) StartRepoRO

func (m *Model) StartRepoRO(repo string)

StartRO starts read only processing on the current model. When in read only mode the model will announce files to the cluster but not pull in any external changes.

func (*Model) StartRepoRW

func (m *Model) StartRepoRW(repo string, threads int)

StartRW starts read/write processing on the current model. When in read/write mode the model will attempt to keep in sync with the cluster by pulling needed files from peer nodes.

func (*Model) State

func (m *Model) State(repo string) string

func (*Model) Version

func (m *Model) Version(repo string) uint64

Version returns the change version for the given repository. This is guaranteed to increment if the contents of the local or global repository has changed.