scan

Documentation

Index

• func IsInDateRange(date time.Time, dateRange DateRange) bool
• type CommitHistory
• type DailyStats
• type DateCache
  • func NewDateCache() *DateCache
  • func (dc *DateCache) Add(dateStr string, date time.Time)
  • func (dc *DateCache) GetParsedDate(dateStr string) (time.Time, bool)
  • func (dc *DateCache) GetYMD(dateStr string) (string, bool)
• type DateRange
  • func GetCurrentWeekRange() DateRange
  • func GetMonthRange(monthsBack int) DateRange
  • func GetPreviousWeekRange() DateRange
• type RepoMetadata
  • func FetchRepoMetadata(repoPath string) RepoMetadata
  • func ScanDirectories(dirs []string, author string, shouldExclude func(string) bool) ([]RepoMetadata, error)
  • func (m *RepoMetadata) CalculatePeakHours() []TimeSlot
  • func (m *RepoMetadata) CalculateVelocity() VelocityMetrics
  • func (m *RepoMetadata) GetCommitTrend(days int) map[string]int
  • func (m *RepoMetadata) GetLanguageDistribution() map[string]float64
  • func (m *RepoMetadata) ValidateData() ValidationResult
• type StreakInfo
• type TimeSlot
• type ValidationResult
• type VelocityMetrics

Functions

func IsInDateRange

func IsInDateRange(date time.Time, dateRange DateRange) bool

IsInDateRange checks if a date falls within a date range The range is inclusive of the start date and exclusive of the end date

Types

type CommitHistory

type CommitHistory struct {
	Date        time.Time `json:"date"`
	Hash        string    `json:"hash"`
	MessageHead string    `json:"message_head"`
	Author      string    `json:"author"`
	FileCount   int       `json:"file_count"`
	Additions   int       `json:"additions"`
	Deletions   int       `json:"deletions"`
}

type DailyStats

type DailyStats struct {
	Date    time.Time `json:"date"`
	Commits int       `json:"commits"`
	Lines   int       `json:"lines"`
	Files   int       `json:"files"`
}

type DateCache

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

Add at the top of the file

func NewDateCache

func NewDateCache() *DateCache

func (*DateCache) Add

func (dc *DateCache) Add(dateStr string, date time.Time)

func (*DateCache) GetParsedDate

func (dc *DateCache) GetParsedDate(dateStr string) (time.Time, bool)

func (*DateCache) GetYMD

func (dc *DateCache) GetYMD(dateStr string) (string, bool)

type DateRange

type DateRange struct {
	Start time.Time
	End   time.Time
}

DateRange represents a time period with start (inclusive) and end (exclusive) dates

func GetCurrentWeekRange

func GetCurrentWeekRange() DateRange

GetCurrentWeekRange returns the date range for the current week (Monday to Sunday)

func GetMonthRange

func GetMonthRange(monthsBack int) DateRange

GetMonthRange returns the date range for the specified number of months back

func GetPreviousWeekRange

func GetPreviousWeekRange() DateRange

GetPreviousWeekRange returns the date range for the previous week (Monday to Sunday)

type RepoMetadata

type RepoMetadata struct {
	Path             string    `json:"path"`
	LastCommit       time.Time `json:"last_commit"`
	CommitCount      int       `json:"commit_count"`
	CurrentStreak    int       `json:"current_streak"`
	LongestStreak    int       `json:"longest_streak"`
	WeeklyCommits    int       `json:"weekly_commits"`
	LastWeeksCommits int       `json:"last_weeks_commits"`
	MonthlyCommits   int       `json:"monthly_commits"`
	MostActiveDay    string    `json:"most_active_day"`
	LastActivity     string    `json:"last_activity"`
	AuthorVerified   bool      `json:"author_verified"`
	Dormant          bool      `json:"dormant"`

	CommitHistory []CommitHistory       `json:"commit_history"`
	DailyStats    map[string]DailyStats `json:"daily_stats"`
	LastAnalyzed  time.Time             `json:"last_analyzed"`
	TotalLines    int                   `json:"total_lines"`
	TotalFiles    int                   `json:"total_files"`
	Languages     map[string]int        `json:"languages"`
	Contributors  map[string]int        `json:"contributors"`
}

func FetchRepoMetadata

func FetchRepoMetadata(repoPath string) RepoMetadata

FetchRepoMetadata - gets metadata for a single repository

func ScanDirectories

func ScanDirectories(dirs []string, author string, shouldExclude func(string) bool) ([]RepoMetadata, error)

ScanDirectories - scans for Git repositories in the specified directories

func (*RepoMetadata) CalculatePeakHours

func (m *RepoMetadata) CalculatePeakHours() []TimeSlot

func (*RepoMetadata) CalculateVelocity

func (m *RepoMetadata) CalculateVelocity() VelocityMetrics

func (*RepoMetadata) GetCommitTrend

func (m *RepoMetadata) GetCommitTrend(days int) map[string]int

func (*RepoMetadata) GetLanguageDistribution

func (m *RepoMetadata) GetLanguageDistribution() map[string]float64

func (*RepoMetadata) ValidateData

func (m *RepoMetadata) ValidateData() ValidationResult

type StreakInfo

type StreakInfo struct {
	Current int
	Longest int
}

Add this new function to track both current and longest streaks

type TimeSlot

type TimeSlot struct {
	Hour    int `json:"hour"`
	Commits int `json:"commits"`
	Lines   int `json:"lines"`
}

TimeSlot represents a 24-hour time period divided into slots

type ValidationResult

type ValidationResult struct {
	Valid  bool
	Issues []string
}

ValidationResult holds the results of data validation

type VelocityMetrics

type VelocityMetrics struct {
	DailyAverage float64    `json:"daily_average"`
	WeeklyTrend  float64    `json:"weekly_trend"`  // Percentage change from previous week
	MonthlyTrend float64    `json:"monthly_trend"` // Percentage change from previous month
	PeakHours    []TimeSlot `json:"peak_hours"`
}

VelocityMetrics represents coding velocity over different time periods