offline

Documentation

Index

• Constants
• func CountHeartbeats(filepath string) (int, error)
• func QueueFilepath(v *viper.Viper) (string, error)
• func QueueFilepathLegacy(v *viper.Viper) (string, error)
• func ReadHeartbeats(filepath string, limit int) ([]heartbeat.Heartbeat, error)
• func Sync(filepath string, syncLimit int) func(next heartbeat.Handle) error
• func WithQueue(filepath string) heartbeat.HandleOption
• func WithSync(filepath string, syncLimit int) heartbeat.HandleOption
• type ErrOpenDB
  • func (e ErrOpenDB) Error() string
  • func (ErrOpenDB) ExitCode() int
  • func (e ErrOpenDB) Message() string
  • func (ErrOpenDB) SendDiagsOnErrors() bool
  • func (ErrOpenDB) ShouldLogError() bool
• type Noop
  • func (Noop) SendHeartbeats(_ []heartbeat.Heartbeat) ([]heartbeat.Result, error)
• type Queue
  • func NewQueue(tx *bolt.Tx) *Queue
  • func (q *Queue) Count() (int, error)
  • func (q *Queue) PopMany(limit int) ([]heartbeat.Heartbeat, error)
  • func (q *Queue) PushMany(hh []heartbeat.Heartbeat) error
  • func (q *Queue) ReadMany(limit int) ([]heartbeat.Heartbeat, error)

Constants

const (

	// PrintMaxDefault is the default maximum number of heartbeats to print.
	PrintMaxDefault = 10
	// RateLimitDefaultSeconds is the default seconds between sending heartbeats
	// to the API. If not enough time has passed, heartbeats are saved to the offline queue.
	RateLimitDefaultSeconds = 120
	// SendLimit is the maximum number of heartbeats, which will be sent at once
	// to the WakaTime API.
	SendLimit = 25
	// SyncMaxDefault is the default maximum number of heartbeats from the
	// offline queue, which will be synced upon sending heartbeats to the API.
	SyncMaxDefault = 1000
)

Functions

func CountHeartbeats

func CountHeartbeats(filepath string) (int, error)

CountHeartbeats returns the total number of heartbeats in the offline db.

func QueueFilepath

func QueueFilepath(v *viper.Viper) (string, error)

QueueFilepath returns the path for offline queue db file. If the resource directory cannot be detected, it defaults to the current directory.

func QueueFilepathLegacy

func QueueFilepathLegacy(v *viper.Viper) (string, error)

QueueFilepathLegacy returns the path for offline queue db file. If the user's $HOME folder cannot be detected, it defaults to the current directory. This is used to support the old db file name and will be removed in the future.

func ReadHeartbeats

func ReadHeartbeats(filepath string, limit int) ([]heartbeat.Heartbeat, error)

ReadHeartbeats reads the informed heartbeats in the offline db.

func Sync

func Sync(filepath string, syncLimit int) func(next heartbeat.Handle) error

Sync returns a function to send queued heartbeats to the WakaTime API.

func WithQueue

func WithQueue(filepath string) heartbeat.HandleOption

WithQueue initializes and returns a heartbeat handle option, which can be used in a heartbeat processing pipeline for automatic handling of failures of heartbeat sending to the API. Upon inability to send due to missing or failing connection to API, failed sending or errors returned by API, the heartbeats will be temporarily stored in a DB and sending will be retried at next usages of the wakatime cli.

func WithSync

func WithSync(filepath string, syncLimit int) heartbeat.HandleOption

WithSync initializes and returns a heartbeat handle option, which can be used in a heartbeat processing pipeline to pop heartbeats from offline queue and send the heartbeats to WakaTime API.

Types

type ErrOpenDB

type ErrOpenDB struct {
	Err error
}

ErrOpenDB is an error returned when the database cannot be opened.

func (ErrOpenDB) Error

func (e ErrOpenDB) Error() string

Error method to implement error interface.

func (ErrOpenDB) ExitCode

func (ErrOpenDB) ExitCode() int

ExitCode method to implement wakaerror.Error interface.

func (ErrOpenDB) Message

func (e ErrOpenDB) Message() string

Message method to implement wakaerror.Error interface.

func (ErrOpenDB) SendDiagsOnErrors

func (ErrOpenDB) SendDiagsOnErrors() bool

SendDiagsOnErrors method to implement wakaerror.SendDiagsOnErrors interface.

func (ErrOpenDB) ShouldLogError

func (ErrOpenDB) ShouldLogError() bool

ShouldLogError method to implement wakaerror.ShouldLogError interface.

type Noop

type Noop struct{}

Noop is a noop api client, used by offline.SaveHeartbeats.

func (Noop) SendHeartbeats

func (Noop) SendHeartbeats(_ []heartbeat.Heartbeat) ([]heartbeat.Result, error)

SendHeartbeats always returns an error.

type Queue

type Queue struct {
	Bucket string
	// contains filtered or unexported fields
}

Queue is a db client to temporarily store heartbeats in bolt db, in case heartbeat sending to wakatime api is not possible. Transaction handling is left to the user via the passed in transaction.

func NewQueue

func NewQueue(tx *bolt.Tx) *Queue

NewQueue creates a new instance of Queue.

func (*Queue) Count

func (q *Queue) Count() (int, error)

Count returns the total number of heartbeats in the offline db.

func (*Queue) PopMany

func (q *Queue) PopMany(limit int) ([]heartbeat.Heartbeat, error)

PopMany retrieves heartbeats with the specified ids from db.

func (*Queue) PushMany

func (q *Queue) PushMany(hh []heartbeat.Heartbeat) error

PushMany stores the provided heartbeats in the db.

func (*Queue) ReadMany

func (q *Queue) ReadMany(limit int) ([]heartbeat.Heartbeat, error)

ReadMany reads heartbeats from db without deleting them.