gh-fake-git-history

Fake GitHub Commits

A command-line tool to fake your GitHub activity ¯\(ツ)/¯. Forked from https://github.com/artiebits/fake-git-history

This tool was forked by @github/insights so that we can maintain a version of the tool for populating fake commit history for use in integration testing. See docs here for more info.

This tool has been published as an NPM package here https://www.npmjs.com/package/gh-fake-git-history.

How To Use

1. Make sure you have Git and Node.js installed on your machine.

2. Create a new repository:

   mkdir my-history
   cd my-history
   touch foo.txt
   git init

3. From within the my-history directory, generate your commits:

   npx gh-fake-git-history --startDate "2020/09/01" --endDate "2020/09/04"

   It will generate changes to the file for every day within the provided date range. You'll see some output like the following:

   // ♥ npx gh-fake-git-history "2020/09/01" --endDate "2020/09/04"
   ⠋ Generating your GitHub activity
   Adding 15 lines...
   Adding 95 lines...
   Removing 69 lines...
   Adding 36 lines...
   ✔ Generating your GitHub activity
   
   ┌──────────────────────────────────────────────────────────────────────────────────────────────────────┐
   │                                                                                                      │
   │                                 Success! 4 commits have been created.                                 │
   │                                                                                                      │
   └──────────────────────────────────────────────────────────────────────────────────────────────────────┘
   

   This will result in some git history being generated like the following:

   [16:34:46] (master) my-history
   // ♥ git log
   commit 1faf416ec3ed4d52eb237ac9fbb9f3193e6ca38c (HEAD -> master)
   Author: SophieDeBenedetto <[e-mail]>
   Date:   Fri Sep 4 15:30:00 2020 -0400
   
      added 4 lines
   
   commit 7b4c9ca257374b40b7b65c4deb34229b84914a45
   Author: SophieDeBenedetto <[e-mail]>
   Date:   Fri Sep 4 11:03:00 2020 -0400
   
      removed 81 lines
   
   commit 99948f84dbee96f914ade739442ce5991507712f
   Author: SophieDeBenedetto <[e-mail]>
   Date:   Thu Sep 3 12:20:00 2020 -0400
   
      modified 30 lines
   
   commit 2d0e1a04dfea7ec7f1191f3ad5f898a55a13f2b0
   Author: SophieDeBenedetto <[e-mail]>
   Date:   Thu Sep 3 10:16:00 2020 -0400
   
      modified 91 lines
   
   ...
   

4. Push the my-history repo to some dummy repo that Insights has set up for the purpose of creating dummy data for integration testing. For example, see this repo that had fake generated git history pushed to it.

Done! Go take a look at your GitHub profile 😉

Customizations

--commitsPerDay

Specify how many commits should be created for every single day. Default is 0,3 which means it will randomly make from 0 to 3 commits a day. Example:

npx fake-git-history --commitsPerDay "0,5"

--workdaysOnly

Use it if you don't want to commit on weekends. Example:

npx fake-git-history --workdaysOnly

--startDate and --endDate

By default, the script generates GitHub commits for every day within the last year. If you want to generate activity for a specific dates, then use these options:

npx fake-git-history --startDate "2020/09/01" --endDate "2020/09/30"

Development

To contribute to this project:

• Clone down the repo
• Run npm install
• Make any changes to src/ files
• Execute the tool manually via `node ./src/cli.js --startDate "2020/09/01" --endDate "2020/09/04"