Skip to content

Georift/own-contribution-graph

Repository files navigation

own-contribution-graph

Say your company doesn't use GitHub, but you still want to continue your contribution graph on your GitHub account.

This tool will scan local repositories, and create a new repository with a series of empty commits that replicate your contributions seen in the local repositories.

Usage

Create a configuration file in JSON:

{
	"sourceRepositories": {
		"paths": [
			"<path-to-repo>",
			"<path-to-directory-containing-multiple-repos>/*"
		],
		"possibleBranchNames": ["origin/master", "origin/main"],
		"authorEmails": ["<email>"]
	},
	"contributionsRepository": {
		"path": "<repo-path>",
		"remote": "origin [email protected]:<username>/<repository>.git",
		"includeRepositoryNameInCommits": true
	}
}

Notes:

  • sourceRepositories:
    • paths contains the paths of the local repositories to scan; a path can be:
      • directly a path to a Git repository,
      • or a path to a directory containing multiple Git repositories, in this case, the path must end with /*.
    • possibleBranchNames contains the branch names that will be looked for in the local repositories; once a branch is found, commits will be looked for in it.
    • authorEmails contains a list of email addresses; the tool will retrieve commits made by these emails addresses.
  • contributionsRepository:
    • path contains the path to the contribution repository; it needs to not exist the first time the tool is run.
    • remote (optional) contains the name and URL of a remote to add to the repo; this will allow you to easily run git push, potentially with --force, afterwards
    • includeRepositoryNameInCommits (optional), if true, the name of the repository will be included in commit messages.

Run owncontributiongraph and provide it with the path to the config file:

owncontributiongraph --config=<json-config-file-path>

Push this repo to GitHub, or anywhere else.

On subsequent runs, only new commits will be added to the contribution repository.

About

Replicate contributions from external git hosts to GitHub

Resources

Stars

Watchers

Forks

Packages

No packages published