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
<!-- Please do not edit this file. Edit the `blah` field in the `package.json` instead. If in doubt, open an issue. -->
2
2
3
3
4
+
5
+
6
+
7
+
8
+
9
+
4
10
[](#)
5
11
12
+
13
+
14
+
15
+
16
+
17
+
18
+
19
+
20
+
21
+
6
22
# `$ git-stats`
7
23
8
24
[![Support me on Patreon][badge_patreon]][patreon][![Buy me a book][badge_amazon]][amazon][![PayPal][badge_paypal_donate]][paypal-donations][](https://github.com/IonicaBizau/ama)[](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)
9
25
10
26
<ahref="https://www.buymeacoffee.com/H96WwChMy"target="_blank"><imgsrc="https://www.buymeacoffee.com/assets/img/custom_images/yellow_img.png"alt="Buy Me A Coffee"></a>
11
27
28
+
29
+
30
+
31
+
32
+
33
+
12
34
> Local git statistics including GitHub-like contributions calendars.
13
35
14
36
37
+
38
+
39
+
40
+
41
+
15
42
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:
16
43
17
-

44
+

18
45
19
46
## Contents
20
47
@@ -30,6 +57,17 @@ I'd be curious to see your calendar with all your commits. Ping me on Twitter ([
30
57
-[How to contribute](#yum-how-to-contribute)
31
58
32
59
60
+
61
+
62
+
63
+
64
+
65
+
66
+
67
+
68
+
69
+
70
+
33
71
## :cloud: Installation
34
72
35
73
You can install the package globally and use it as command line tool:
@@ -56,18 +94,18 @@ Local git statistics including GitHub-like contributions calendars.
56
94
57
95
Options:
58
96
-r, --raw Outputs a dump of the raw JSON data.
59
-
--record <data> Records a new commit. Don't use this unless you are
60
-
a mad scientist. If you are a developer just use
61
-
this option as part of the module.
62
-
-s, --since <date> Optional start date.
63
-
-u, --until <date> Optional end date.
64
97
-g, --global-activity Shows global activity calendar in the current
65
98
repository.
66
-
-n, --disable-ansi Forces the tool not to use ANSI styles.
67
-
-l, --light Enables the light theme.
68
99
-d, --data <path> Sets a custom data store file.
100
+
-l, --light Enables the light theme.
101
+
-n, --disable-ansi Forces the tool not to use ANSI styles.
69
102
-a, --authors Shows a pie chart with the author related
70
103
contributions in the current repository.
104
+
-u, --until <date> Optional end date.
105
+
-s, --since <date> Optional start date.
106
+
--record <data> Records a new commit. Don't use this unless you are
107
+
a mad scientist. If you are a developer just use
108
+
this option as part of the module.
71
109
-h, --help Displays this help.
72
110
-v, --version Displays version information.
73
111
@@ -83,6 +121,12 @@ Your commit history is kept in ~/.git-stats by default. You can create
83
121
Documentation can be found at https://github.com/IonicaBizau/git-stats.
84
122
```
85
123
124
+
125
+
126
+
127
+
128
+
129
+
86
130
## Usage
87
131
88
132
### Importing and deleting commits
@@ -123,20 +167,6 @@ $ cd repository-downloader
123
167
# Install the dependencies
124
168
$ npm install
125
169
126
-
# Enter your username and password for GitHub and BitBucket into the config.json
git-stats --since '1 January 2015' --raw |./bin/git-stats-html -o out.html --big
225
255
226
256
```
227
257
@@ -255,18 +285,17 @@ If you run `git-stats` to display graph on Windows, please use a terminal that c
255
285
Cygwin Terminal is known to work, while Windows Command Prompt and Git Bash do not. Improvements are more than welcome! :dizzy:
256
286
257
287
258
-
## :clipboard: Example
259
288
260
289
261
-
Here is an example how to use this package as library. To install it locally, as library, you can do that using `npm` (or `yarn`):
262
290
263
-
```sh
264
-
# Using npm
265
-
npm install --save git-stats
266
291
267
-
# Using yarn
268
-
yarn add git-stats
269
-
```
292
+
293
+
294
+
## :clipboard: Example
295
+
296
+
297
+
298
+
Here is an example how to use this package as library. To install it locally, as library, you can use `npm install git-stats` (or `yarn add git-stats`):
270
299
271
300
272
301
@@ -287,32 +316,53 @@ g1.ansiCalendar({
287
316
288
317
289
318
319
+
320
+
321
+
322
+
323
+
324
+
325
+
326
+
290
327
## :question: Get Help
291
328
292
329
There are few ways to get help:
293
330
331
+
332
+
294
333
1. Please [post questions on Stack Overflow](https://stackoverflow.com/questions/ask). You can open issues with questions, as long you add a link to your Stack Overflow question.
295
334
2. For bug reports and feature requests, open issues. :bug:
296
-
297
335
3. For direct and quick help, you can [use Codementor](https://www.codementor.io/johnnyb). :rocket:
298
336
299
337
300
338
339
+
340
+
301
341
## :memo: Documentation
302
342
303
343
For full API reference, see the [DOCUMENTATION.md][docs] file.
304
344
345
+
346
+
347
+
348
+
349
+
305
350
## :newspaper: Press Highlights
306
351
307
352
-[*A GitHub-like contributions calendar, but locally, with all your git commits*, The Changelog](https://changelog.com/github-like-contributions-calendar-locally-git-commits/)
308
353
309
354
355
+
356
+
357
+
358
+
359
+
360
+
310
361
## :yum: How to contribute
311
362
Have an idea? Found a bug? See [how to contribute][contributing].
312
363
313
364
314
365
## :sparkling_heart: Support my projects
315
-
316
366
I open-source almost everything I can, and I try to reply to everyone needing help using these projects. Obviously,
317
367
this takes time. You can integrate and use these projects in your applications *for free*! You can even change the source code and redistribute (even resell it).
318
368
@@ -331,28 +381,53 @@ However, if you get some profit from this or just want to encourage me to contin
331
381
Thanks! :heart:
332
382
333
383
384
+
385
+
386
+
387
+
388
+
389
+
390
+
391
+
392
+
393
+
394
+
395
+
396
+
397
+
334
398
## :dizzy: Where is this library used?
335
399
If you are using this library in one of your projects, add it in this list. :sparkles:
336
400
401
+
-`git-stats-fcc-importer`
402
+
-`git-stats-importer`
403
+
404
+
405
+
406
+
407
+
408
+
409
+
410
+
411
+
337
412
338
-
- [`git-stats-fcc-importer`](https://github.com/cmal/git-stats-fcc-importer#readme) (by Yu Zhao)—git-stats importer for FreeCodeCamp users
339
-
- [`git-stats-importer`](https://github.com/IonicaBizau/git-stats-importer)—Imports your commits from a repository into git-stats history.
0 commit comments