cmd

Documentation

Index

• Constants
• Variables
• func RunAnalyze(cmd *cobra.Command, args []string) error
• func RunClear(cmd *cobra.Command, args []string) error
• func RunFetch(cmd *cobra.Command, args []string) error

Constants

const AccessTokenDesc = "GitHub access token for authorized rate limits"

AccessTokenDesc describes usage.

const CacheDirDesc = "directory for storing cached GitHub API responses"

CacheDirDesc describes usage.

const RepoDesc = "GitHub owner and repository, formatted as :owner/:repo"

RepoDesc describes usage.

Variables

var AccessToken string

AccessToken is used to access repo stars and gain non-authorized rate limits.

var AnalyzeCmd = &cobra.Command{
	Use:   "analyze --repo=:owner/:repo",
	Short: "analyze previously fetched and saved GitHub stargazer data",
	Long: `

Analyzes the previously fetched and saved GitHub stargazer data. The
following analyses are run:

    - Cumulative stars (week timestamp and star count)
    - Correlated repos (count of occurrences of other starred & subscribed repos)
    - Correlation histogram (50 bins of occurrence counts)
    - Stargazer report (name, email(?), date starred, correlation score,
      correlated repos, raw activity, raw activity repos, correlated activity,
      correlated activity repos
`,
	Example: `  stargazers analyze --repo=cockroachdb/cockroach`,
	RunE:    RunAnalyze,
}

AnalyzeCmd analyzes previously fetched GitHub stargazer data.

var CacheDir string

CacheDir specifies where to store cached JSON responses.

var ClearCmd = &cobra.Command{
	Use:   "clear --repo=:owner/:repo",
	Short: "clear cached GitHub API responses",
	Long: `
Clears all GitHub API responses which have been cached in the repo-specific
--cache subdirectory.
`,
	Example: `  stargazers clear --repo=cockroachdb/cockroach`,
	RunE:    RunClear,
}

ClearCmd clears cached GitHub API responses.

var FetchCmd = &cobra.Command{
	Use:   "fetch --repo=:owner/:repo --token=:access_token",
	Short: "recursively fetch all stargazer github data",
	Long: `
Recursively fetch all stargazer github data starting with the list of
stargazers for the specified :owner/:repo and then descending into
each stargazer's followers, other starred repos, and subscribed
repos. Each subscribed repo is further queried for that stargazer's
contributions in terms of additions, deletions, and commits. All
fetched data is cached by URL.
`,
	Example: `  stargazers fetch --repo=cockroachdb/cockroach --token=f87456b1112dadb2d831a5792bf2ca9a6afca7bc`,
	RunE:    RunFetch,
}

FetchCmd recursively fetches stargazer github data.

var Repo string

Repo specifies the the owner and repository in :owner/:repo format.

Functions

func RunAnalyze

func RunAnalyze(cmd *cobra.Command, args []string) error

RunAnalyze fetches saved stargazer info for the specified repo and runs the analysis reports.

func RunClear

func RunClear(cmd *cobra.Command, args []string) error

RunClear clears all cached GitHub API responses for the specified repo.

func RunFetch

func RunFetch(cmd *cobra.Command, args []string) error

RunFetch recursively queries all relevant github data for the specified owner and repo.