Skip to content

Latest commit

 

History

History
50 lines (39 loc) · 1.95 KB

README.md

File metadata and controls

50 lines (39 loc) · 1.95 KB
Raw

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.