project

Documentation

Index

• Constants
• func Detect(patterns []MapPattern, args ...DetecterArg) (Result, DetectorID)
• func Filter(h heartbeat.Heartbeat, config FilterConfig) error
• func FindFileOrDirectory(directory, filename string) (string, bool)
• func WithDetection(config Config) heartbeat.HandleOption
• func WithFiltering(config FilterConfig) heartbeat.HandleOption
• func Write(folder, project string) error
• type Config
• type Detecter
• type DetecterArg
• type DetectorID
  • func (d DetectorID) String() string
• type File
  • func (f File) Detect() (Result, bool, error)
  • func (File) ID() DetectorID
• type FilterConfig
• type Git
  • func (g Git) Detect() (Result, bool, error)
  • func (Git) ID() DetectorID
• type Map
  • func (m Map) Detect() (Result, bool, error)
  • func (Map) ID() DetectorID
• type MapPattern
• type Mercurial
  • func (m Mercurial) Detect() (Result, bool, error)
  • func (Mercurial) ID() DetectorID
• type Result
  • func DetectWithRevControl(submodulePatterns []regex.Regex, args ...DetecterArg) Result
• type Subversion
  • func (s Subversion) Detect() (Result, bool, error)
  • func (Subversion) ID() DetectorID
• type Tfvc
  • func (t Tfvc) Detect() (Result, bool, error)
  • func (Tfvc) ID() DetectorID

Constants

const (
	// WakaTimeProjectFile is the special file which if present should contain the project name and optional branch name
	// that will be used instead of the auto-detected project and branch names.
	WakaTimeProjectFile = ".wakatime-project"
)

Functions

func Detect

func Detect(patterns []MapPattern, args ...DetecterArg) (Result, DetectorID)

Detect finds the current project and branch from config plugins.

func Filter

func Filter(h heartbeat.Heartbeat, config FilterConfig) error

Filter determines, following the passed in configurations, if a heartbeat should be skipped.

func FindFileOrDirectory

func FindFileOrDirectory(directory, filename string) (string, bool)

FindFileOrDirectory searches for a file or directory named `filename`. Search starts in `directory` and will traverse through all parent directories. `directory` may also be a file, and in that case will start from the file's directory.

func WithDetection

func WithDetection(config Config) heartbeat.HandleOption

WithDetection finds the current project and branch. First looks for a .wakatime-project file or project map. Second, uses the --project arg. Third, try to auto-detect using a revision control repository. Last, uses the --alternate-project arg.

func WithFiltering

func WithFiltering(config FilterConfig) heartbeat.HandleOption

WithFiltering initializes and returns a heartbeat handle option, which can be used in a heartbeat processing pipeline to filter heartbeats following the provided configurations.

func Write

func Write(folder, project string) error

Write saves wakatime project file.

Types

type Config

type Config struct {
	// HideProjectNames determines if the project name should be obfuscated by matching its path.
	HideProjectNames []regex.Regex
	// Patterns contains the overridden project name per path.
	MapPatterns []MapPattern
	// SubmodulePatterns contains the paths to validate for submodules.
	SubmodulePatterns []regex.Regex
}

Config contains project detection configurations.

type Detecter

type Detecter interface {
	Detect() (Result, bool, error)
	ID() DetectorID
}

Detecter is a common interface for project.

type DetecterArg

type DetecterArg struct {
	Filepath  string
	ShouldRun bool
}

DetecterArg determines for a given path if it needs to run.

type DetectorID

type DetectorID int

DetectorID represents a detector ID.

const (
	// UnknownDetector is the detector ID used when not detected.
	UnknownDetector DetectorID = iota
	// FileDetector is the detector ID for file detector.
	FileDetector
	// MapDetector is the detector ID for map detector.
	MapDetector
	// GitDetector is the detector ID for git detector.
	GitDetector
	// MercurialDetector is the detector ID for mercurial detector.
	MercurialDetector
	// SubversionDetector is the detector ID for subversion detector.
	SubversionDetector
	// TfvcDetector is the detector ID for tfvc detector.
	TfvcDetector
)

func (DetectorID) String

func (d DetectorID) String() string

String implements fmt.Stringer interface.

type File

type File struct {
	Filepath string
}

File contains file data.

func (File) Detect

func (f File) Detect() (Result, bool, error)

Detect get information from a .wakatime-project file about the project for a given file. First line of .wakatime-project sets the project name. Second line sets the current branch name.

func (File) ID

func (File) ID() DetectorID

ID returns its id.

type FilterConfig

type FilterConfig struct {
	// ExcludeUnknownProject determines if heartbeat should be skipped when the project cannot be detected.
	ExcludeUnknownProject bool
}

FilterConfig contains project filtering configurations.

type Git

type Git struct {
	// Filepath contains the entity path.
	Filepath string
	// SubmodulePatterns will be matched against the submodule path and if matching, will skip it.
	SubmodulePatterns []regex.Regex
}

Git contains git data.

func (Git) Detect

func (g Git) Detect() (Result, bool, error)

Detect gets information about the git project for a given file. It tries to return a project and branch name.

func (Git) ID

func (Git) ID() DetectorID

ID returns its id.

type Map

type Map struct {
	Filepath string
	Patterns []MapPattern
}

Map contains map data.

func (Map) Detect

func (m Map) Detect() (Result, bool, error)

Detect use the ~/.wakatime.cfg file to set custom project names by matching files with regex patterns. Project maps go under the [projectmap] config section.

For example:

[projectmap]
/home/user/projects/foo = new project name
/home/user/projects/bar(\d+)/ = project{0}

Will result in file '/home/user/projects/foo/src/main.c' to have project name 'new project name' and file '/home/user/projects/bar42/main.c' to have project name 'project42'.

func (Map) ID

func (Map) ID() DetectorID

ID returns its id.

type MapPattern

type MapPattern struct {
	// Name is the project name.
	Name string
	// Regex is the regular expression for a specific path.
	Regex regex.Regex
}

MapPattern contains [projectmap] data.

type Mercurial

type Mercurial struct {
	// Filepath contains the entity path.
	Filepath string
}

Mercurial contains mercurial data.

func (Mercurial) Detect

func (m Mercurial) Detect() (Result, bool, error)

Detect gets information about the mercurial project for a given file.

func (Mercurial) ID

func (Mercurial) ID() DetectorID

ID returns its id.

type Result

type Result struct {
	Project string
	Branch  string
	Folder  string
}

Result contains the result of Detect().

func DetectWithRevControl

func DetectWithRevControl(submodulePatterns []regex.Regex, args ...DetecterArg) Result

DetectWithRevControl finds the current project and branch from rev control.

type Subversion

type Subversion struct {
	// Filepath contains the entity path.
	Filepath string
}

Subversion contains svn data.

func (Subversion) Detect

func (s Subversion) Detect() (Result, bool, error)

Detect gets information about the svn project for a given file.

func (Subversion) ID

func (Subversion) ID() DetectorID

ID returns its id.

type Tfvc

type Tfvc struct {
	// Filepath contains the entity path.
	Filepath string
}

Tfvc contains tfvc data.

func (Tfvc) Detect

func (t Tfvc) Detect() (Result, bool, error)

Detect gets information about the tfvc project for a given file.

func (Tfvc) ID

func (Tfvc) ID() DetectorID

ID returns its id.