git-stats/package.json

{
  "name": "git-stats",
  "version": "2.9.0",
  "description": "Local git statistics including GitHub-like contributions calendars.",
  "main": "lib/index.js",
  "bin": {
    "git-stats": "./bin/git-stats"
  },
  "scripts": {
    "test": "node test",
    "postinstall": "node scripts/migration/2.0.0.js"
  },
  "author": "Ionică Bizău <bizauionica@gmail.com> (http://ionicabizau.net)",
  "contributors": [
    "Gnab <as0n@gnab.fr>",
    "William Boman <william@redwill.se>",
    "Fabian Furger <mystyfly@gmail.com>"
  ],
  "license": "MIT",
  "devDependencies": {},
  "repository": {
    "type": "git",
    "url": "https://github.com/IonicaBizau/git-stats.git"
  },
  "keywords": [
    "git",
    "stats",
    "github",
    "cli"
  ],
  "bugs": {
    "url": "https://github.com/IonicaBizau/git-stats/issues"
  },
  "homepage": "https://github.com/IonicaBizau/git-stats",
  "dependencies": {
    "abs": "^1.0.0",
    "bug-killer": "^4.0.0",
    "cli-gh-cal": "^1.0.0",
    "cli-pie": "^2.0.0",
    "clp": "^3.0.0",
    "deffy": "2.0.0",
    "gitlog-parser": "0.0.4",
    "gry": "^4.0.0",
    "is-there": "^4.0.0",
    "moment": "^2.9.0",
    "r-json": "^1.0.0",
    "typpy": "^2.1.0",
    "ul": "^5.0.0",
    "w-json": "^1.0.0",
    "iterate-object": "^1.1.0"
  },
  "blah": {
    "h_img": "http://i.imgur.com/Q7TQYHx.png",
    "description": [
      {
        "p": "I'd be curious to see your calendar with all your commits. Ping me on Twitter ([**@IonicaBizau**](https://twitter.com/IonicaBizau)). :smile: Until then, here's my calendar:"
      },
      {
        "img": {
          "source": "http://i.imgur.com/PpM0i3v.png"
        }
      },
      {
        "h2": "Contents"
      },
      {
        "ul": [
          "[Installation](#installation)",
          [
            "[Usage](#usage)",
            {
              "ul": [
                "[Importing and deleting commits](#importing-and-deleting-commits)",
                "[Importing all the commits from GitHub and BitBucket](#importing-all-the-commits-from-github-and-bitbucket)",
                "[What about the GitHub Contributions calendar?](#what-about-the-github-contributions-calendar)"
              ]
            }
          ],
          "[Documentation](#documentation)",
          "[How to contribute](#how-to-contribute)"
        ]
      }
    ],
    "installation_command": {
      "language": "sh",
      "content": [
        "# Install the package globally",
        "npm i -g <%- _.pack.name %>",
        "# Initialize git hooks",
        "# This is for tracking the new commits",
        "curl -s https://raw.githubusercontent.com/IonicaBizau/git-stats/master/scripts/init-git-post-commit | bash"
      ]
    },
    "installation": [
      {
        "h2": "Usage"
      },
      {
        "h3": "Importing and deleting commits"
      },
      {
        "p": [
          "I know it's not nice to start your git commit calendar from scratch. That's why I created [`git-stats-importer`](https://github.com/IonicaBizau/git-stats-importer)–a tool which imports or deletes the commits from selected repositories.",
          "Check it out here: https://github.com/IonicaBizau/git-stats-importer",
          "The usage is simple:"
        ]
      },
      {
        "code": {
          "language": "sh",
          "content": [
            "# Install the importer tool",
            "$ npm install -g git-stats-importer",
            "",
            "# Go to the repository you want to import",
            "$ cd path/to/my-repository",
            "",
            "# Import the commits",
            "$ git-stats-importer",
            "",
            "# ...or delete them if that's a dummy repository",
            "$ git-stats-importer --delete"
          ]
        }
      },
      {
        "h3": "Importing all the commits from GitHub and BitBucket"
      },
      {
        "p": "Yes, that's also possible. I [built a tool which downloads and then imports all the commits you have pushed to GitHub and BitBucket](https://github.com/IonicaBizau/repository-downloader)!"
      },
      {
        "code": {
          "language": "sh",
          "content": [
            "# Download the repository downloader",
            "$ git clone https://github.com/IonicaBizau/repository-downloader.git",
            "",
            "# Go to repository downloader",
            "$ cd repository-downloader",
            "",
            "# Install the dependencies",
            "$ npm install",
            "",
            "# Start downloading and importing",
            "$ ./start"
          ]
        }
      },
      {
        "h3": "What about the GitHub Contributions calendar?"
      },
      {
        "p": "If you want to visualize the calendars that appear on GitHub profiles, you can do that using [`ghcal`](https://github.com/IonicaBizau/ghcal)."
      },
      {
        "code": {
          "language": "sh",
          "content": [
            "# Install ghcal",
            "$ npm install -g ghcal",
            "",
            "# Check out @alysonla's contributions",
            "$ ghcal -u alysonla"
          ]
        }
      },
      {
        "p": [
          "For more detailed documentation, check out the repository: https://github.com/IonicaBizau/ghcal.",
          "If want to get even more GitHub stats in your terminal, you may want to try [`github-stats`](https://github.com/IonicaBizau/github-stats)--this is like `git-stats` but with data taken from GitHub."
        ]
      },
      {
        "h2": "Using the configuration file"
      },
      {
        "p": [
          "You can tweak the git-stats behavior using a configuration file in your home directory: `~/.git-stats-config.js`.",
          "This file should export an object, like below (defaults are listed):"
        ]
      },
      {
        "code": {
          "language": "js",
          "content": [
            "module.exports = {",
            "    // \"DARK\", \"LIGHT\" or an object interpreted by IonicaBizau/node-git-stats-colors",
            "    \"theme\": \"DARK\"",
            "",
            "    // The file where the commit hashes will be stored",
            "  , \"path\": \"~/.git-stats\"",
            "",
            "    // First day of the week",
            "  , first_day: \"Sun\"",
            "",
            "    // This defaults to *one year ago*",
            "    // It can be any parsable date",
            "  , since: undefined",
            "",
            "    // This defaults to *now*",
            "    // It can be any parsable date",
            "  , until: undefined",
            "",
            "    // Don't show authors by default",
            "    // If true, this will enable the authors pie",
            "  , authors: false",
            "",
            "    // No global activity by default",
            "    // If true, this will enable the global activity calendar in the current project",
            "  , global_activity: false",
            "};"
          ]
        }
      },
      {
        "p": "Since it's a js file, you can `require` any other modules there."
      },
      {
        "h2": "Cross-platform compatibility"
      },
      {
        "p": [
          "`git-stats` is working fine in terminal emulators supporting ANSI styles. It should work fine on Linux and OS X.",
          "If you run `git-stats` to display graph on Windows, please use a terminal that can properly display ANSI colors.",
          "Cygwin Terminal is known to work, while Windows Command Prompt and Git Bash do not. Improvements are more than welcome! :dizzy:"
        ]
      }
    ],
    "press": {
      "ul": [
        "[*A GitHub-like contributions calendar, but locally, with all your git commits*, The Changelog](https://changelog.com/github-like-contributions-calendar-locally-git-commits/)"
      ]
    }
  }
}