You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+40-28
Original file line number
Diff line number
Diff line change
@@ -1,9 +1,11 @@
1
+
1
2
[](#)
2
3
3
4
# `$ git-stats`[][paypal-donations][](https://www.npmjs.com/package/git-stats)[](https://www.npmjs.com/package/git-stats)[](https://www.codementor.io/johnnyb?utm_source=github&utm_medium=button&utm_term=johnnyb&utm_campaign=github)
4
5
5
6
> Local git statistics including GitHub-like contributions calendars.
6
7
8
+
7
9
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:
8
10
9
11

@@ -12,49 +14,53 @@ I'd be curious to see your calendar with all your commits. Ping me on Twitter ([
12
14
13
15
-[Installation](#installation)
14
16
-[Usage](#usage)
15
-
17
+
16
18
-[Importing and deleting commits](#importing-and-deleting-commits)
17
19
-[Importing all the commits from GitHub and BitBucket](#importing-all-the-commits-from-github-and-bitbucket)
18
20
-[What about the GitHub Contributions calendar?](#what-about-the-github-contributions-calendar)
19
-
21
+
20
22
-[Documentation](#documentation)
21
23
-[How to contribute](#how-to-contribute)
22
24
23
-
## Installation
25
+
26
+
## :cloud: Installation
24
27
25
28
You can install the package globally and use it as command line tool:
Then, run `git-stats --help` and see what the CLI tool can do.
36
41
37
-
```sh
42
+
43
+
```
38
44
$ git-stats --help
39
45
Usage: git-stats [options]
40
46
41
47
Options:
42
-
-s, --since <date> Optional start date.
43
-
-u, --until <date> Optional end date.
44
-
-n, --no-ansi Forces the tool not to use ANSI styles.
45
-
-l, --light Enables the light theme.
46
-
-a, --authors Shows a pie chart with the author related
47
-
contributions in the current repository.
48
-
-g, --global-activity Shows global activity calendar in the current
49
-
repository.
50
-
-d, --data <path> Sets a custom data store file.
51
-
-f, --first-day <day> Sets the first day of the week.
52
-
--record <data> Records a new commit. Don't use this unless you
48
+
-s, --since <date> Optional start date.
49
+
-u, --until <date> Optional end date.
50
+
-n, --no-ansi Forces the tool not to use ANSI styles.
51
+
-l, --light Enables the light theme.
52
+
-a, --authors Shows a pie chart with the author related
53
+
contributions in the current repository.
54
+
-g, --global-activity Shows global activity calendar in the current
55
+
repository.
56
+
-d, --data <path> Sets a custom data store file.
57
+
-f, --first-day <day> Sets the first day of the week.
58
+
--record <data> Records a new commit. Don't use this unless you
53
59
are a mad scientist. If you are a developer, just
54
-
use this option as part of the module.
55
-
-r, --raw Outputs a dump of the raw JSON data.
56
-
-h, --help Displays this help.
57
-
-v, --version Displays version information.
60
+
use this option as part of the module.
61
+
-r, --raw Outputs a dump of the raw JSON data.
62
+
-h, --help Displays this help.
63
+
-v, --version Displays version information.
58
64
59
65
Examples:
60
66
git-stats # Default behavior (stats in the last year)
@@ -167,14 +173,18 @@ If you run `git-stats` to display graph on Windows, please use a terminal that c
167
173
168
174
Cygwin Terminal is known to work, while Windows Command Prompt and Git Bash do not. Improvements are more than welcome! :dizzy:
169
175
170
-
## Example
176
+
177
+
## :clipboard: Example
178
+
171
179
172
180
Here is an example how to use this package as library. To install it locally, as library, you can do that using `npm`:
173
181
174
182
```sh
175
183
$ npm i --save git-stats
176
184
```
177
185
186
+
187
+
178
188
```js
179
189
// Dependencies
180
190
var GitStats =require("git-stats");
@@ -190,23 +200,25 @@ g1.ansiCalendar({
190
200
});
191
201
```
192
202
193
-
## Documentation
203
+
## :memo:Documentation
194
204
195
205
For full API reference, see the [DOCUMENTATION.md][docs] file.
196
206
197
-
## Press Highlights
207
+
## :newspaper:Press Highlights
198
208
199
209
-[*A GitHub-like contributions calendar, but locally, with all your git commits*, The Changelog](https://changelog.com/github-like-contributions-calendar-locally-git-commits/)
200
210
201
-
## How to contribute
211
+
212
+
## :yum: How to contribute
202
213
Have an idea? Found a bug? See [how to contribute][contributing].
203
214
204
-
## Where is this library used?
215
+
## :dizzy:Where is this library used?
205
216
If you are using this library in one of your projects, add it in this list. :sparkles:
0 commit comments