cache

Documentation

Index

• Variables
• func AsyncRefreshCache(dirs []string, author string, cacheFilePath string, excludedPatterns []string, ...)
• func CleanCache(cacheFilePath string) error
• func InitCache()
• func LoadCache(filePath string) error
• func QuickNeedsRefresh(refreshInterval time.Duration) bool
• func RefreshCache(dirs []string, author string, cacheFilePath string, excludedPatterns []string, ...) error
• func SaveCache(filePath string) error
• type AuthorStats
• type CacheManager
  • func NewCacheManager(cachePath string) *CacheManager
  • func (cm *CacheManager) GetCommits(options QueryOptions) []scan.CommitHistory
  • func (cm *CacheManager) Load() error
  • func (cm *CacheManager) Refresh() error
  • func (cm *CacheManager) RefreshInBackground()
  • func (cm *CacheManager) Save() error
  • func (cm *CacheManager) StartBackgroundRefresh(interval time.Duration)
• type CacheUpdate
• type CommitCache
• type DisplayStats
• type QueryOptions
• type RepoDisplayStats

Variables

var Cache = &cacheProxy{}

Cache is now a proxy to the manager's cache

Functions

func AsyncRefreshCache

func AsyncRefreshCache(dirs []string, author string, cacheFilePath string, excludedPatterns []string, excludedPaths []string)

AsyncRefreshCache performs a non-blocking cache refresh

func CleanCache

func CleanCache(cacheFilePath string) error

CleanCache removes the cache file and resets the in-memory cache

func InitCache

func InitCache()

InitCache - Initializes the cache manager

func LoadCache

func LoadCache(filePath string) error

LoadCache - loads repository metadata from cache file

func QuickNeedsRefresh

func QuickNeedsRefresh(refreshInterval time.Duration) bool

QuickNeedsRefresh performs a fast check if refresh is needed

func RefreshCache

func RefreshCache(dirs []string, author string, cacheFilePath string, excludedPatterns []string, excludedPaths []string) error

RefreshCache - updates the cache with fresh data

func SaveCache

func SaveCache(filePath string) error

SaveCache - saves the cache to disk

Types

type AuthorStats

type AuthorStats struct {
	TotalCommits  int
	ActiveDays    map[string]bool
	CurrentStreak int
	LongestStreak int
	Languages     map[string]int
	PeakHours     map[int]int
	LastActivity  time.Time
}

AuthorStats holds aggregated statistics for an author

type CacheManager

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

CacheManager handles all cache operations

func NewCacheManager

func NewCacheManager(cachePath string) *CacheManager

NewCacheManager creates a new cache manager instance

func (*CacheManager) GetCommits

func (cm *CacheManager) GetCommits(options QueryOptions) []scan.CommitHistory

GetCommits retrieves commits based on query options

func (*CacheManager) Load

func (cm *CacheManager) Load() error

Load reads the cache from disk

func (*CacheManager) Refresh

func (cm *CacheManager) Refresh() error

Refresh updates the cache with fresh data

func (*CacheManager) RefreshInBackground

func (cm *CacheManager) RefreshInBackground()

RefreshInBackground performs a non-blocking cache refresh

func (*CacheManager) Save

func (cm *CacheManager) Save() error

Save persists the cache to disk

func (*CacheManager) StartBackgroundRefresh

func (cm *CacheManager) StartBackgroundRefresh(interval time.Duration)

StartBackgroundRefresh initiates background refresh with specified interval

type CacheUpdate

type CacheUpdate struct {
	Type    string
	RepoID  string
	Changes int
}

CacheUpdate represents a cache update notification

type CommitCache

type CommitCache struct {
	// Core data
	Commits  map[string][]scan.CommitHistory // repo -> commits
	Authors  map[string]AuthorStats          // author -> stats
	LastSync time.Time
	Version  string

	// Performance optimizations
	CommitIndex map[string]map[string]bool // hash -> repo -> exists
	DateIndex   map[string][]string        // YYYY-MM-DD -> commit hashes
	AuthorIndex map[string][]string        // author -> commit hashes

	// Pre-calculated display data
	DisplayStats DisplayStats

	// Metadata
	Repositories map[string]scan.RepoMetadata
}

CommitCache represents the optimized cache structure

type DisplayStats

type DisplayStats struct {
	WeeklyTotal    int
	WeeklyDiff     int
	DailyAverage   float64
	TotalAdditions int
	TotalDeletions int
	PeakHour       int
	PeakCommits    int
	LanguageStats  map[string]int
	RepoStats      []RepoDisplayStats
	LastUpdate     time.Time
}

DisplayStats holds pre-calculated statistics for display

type QueryOptions

type QueryOptions struct {
	Author     string
	Repository string
	Since      time.Time
	Until      time.Time
}

QueryOptions defines parameters for commit queries

type RepoDisplayStats

type RepoDisplayStats struct {
	Name           string
	WeeklyCommits  int
	CurrentStreak  int
	LongestStreak  int
	Additions      int
	Deletions      int
	LastCommitTime time.Time
}

RepoDisplayStats holds pre-calculated statistics for a repository