git stats
3.2.0
$ git-statsStatistiques GIT locales, y compris les calendriers de contributions de type GitHub.
Je serais curieux de voir votre calendrier avec tous vos commits. Ping me sur Twitter ( @ionicabizau ). ? Jusque-là, voici mon calendrier:
Installation
Usage
Documentation
Comment contribuer
Vous pouvez installer le package globalement et l'utiliser comme outil de ligne de commande:
# Install the package globally
npm i -g git-stats
# 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 Ensuite, exécutez git-stats --help et voyez ce que l'outil CLI peut faire.
$ git-stats --help
Usage: git-stats [options]
Local git statistics including GitHub-like contributions calendars.
Options:
-r, --raw Outputs a dump of the raw JSON data.
-g, --global-activity Shows global activity calendar in the current
repository.
-d, --data <path> Sets a custom data store file.
-l, --light Enables the light theme.
-n, --disable-ansi Forces the tool not to use ANSI styles.
-A, --author Filter author related contributions in the current
repository.
-a, --authors Shows a pie chart with the author related
contributions in the current repository.
-u, --until <date> Optional end date.
-s, --since <date> Optional start date.
--record <data> Records a new commit. Don't use this unless you are
a mad scientist. If you are a developer just use
this option as part of the module.
-h, --help Displays this help.
-v, --version Displays version information.
Examples:
$ git-stats # Default behavior (stats in the last year)
$ git-stats -l # Light mode
$ git-stats -s '1 January, 2012' # All the commits from 1 January 2012 to now
$ git-stats -s '1 January, 2012' -u '31 December, 2012' # All the commits from 2012
Your commit history is kept in ~/.git-stats by default. You can create
~/.git-stats-config.js to specify different defaults.
Documentation can be found at https://github.com/IonicaBizau/git-stats.
Je sais que ce n'est pas agréable de commencer votre calendrier Git Commit à partir de zéro. C'est pourquoi j'ai créé git-stats-importer - un outil qui importe ou supprime les commits des référentiels sélectionnés.
Découvrez-le ici: https://github.com/ionicabizau/git-stats-impporter
L'utilisation est simple:
# 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 --deleteOui, c'est aussi possible. J'ai construit un outil qui télécharge puis importe tous les engagements que vous avez poussés à GitHub et Bitbucket!
# 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 Si vous souhaitez visualiser les calendriers qui apparaissent sur les profils GitHub, vous pouvez le faire en utilisant ghcal .
# Install ghcal
$ npm install -g ghcal
# Check out @alysonla's contributions
$ ghcal -u alysonlaPour une documentation plus détaillée, consultez le référentiel: https://github.com/ionicabizau/ghcal.
Si vous souhaitez obtenir encore plus de statistiques GitHub dans votre terminal, vous voudrez peut-être essayer github-stats - c'est comme git-stats mais avec des données tirées de GitHub.
Vous pouvez modifier le comportement Git-Stats à l'aide d'un fichier de configuration dans votre répertoire domestique: ~/.git-stats-config.js .
Ce fichier doit exporter un objet, comme ci-dessous (les défaillances sont répertoriées):
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"
// [DEPRECATED] First day of the week https://github.com/IonicaBizau/git-stats/issues/121
, 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
} ; Puisqu'il s'agit d'un fichier JS, vous pouvez require d'autres modules là-bas.
git-stats --raw Sorte le format JSON RAW qui peut être consommé par d'autres outils pour générer des résultats tels que des fichiers HTML ou des images.
git-stats-html interprète les données JSON et génère un fichier HTML. Exemple:
# Install git-stats-html
npm install -g git-stats-html
# Export the data from the last year (generate out.html)
git-stats --raw | git-stats-html -o out.html
# Export data since 2015 (save the results in out.html)
git-stats --since ' 1 January 2015 ' --raw | ./bin/git-stats-html -o out.html --big
Après avoir le fichier HTML, nous pouvons générer un fichier image à l'aide pageres par @sinSorHus :
# Install pageres
npm install -g pageres-cli
# Generate the image from HTML
pageres out.html 775x250
git-stats fonctionne bien dans les émulateurs terminaux soutenant les styles ANSI. Cela devrait bien fonctionner sur Linux et OS X.
Si vous exécutez git-stats pour afficher le graphique sur Windows, veuillez utiliser un terminal qui peut afficher correctement les couleurs ANSI.
Le terminal Cygwin est connu pour fonctionner, tandis que l'invite de commande Windows et le bash Git ne le font pas. Les améliorations sont plus que les bienvenues! ?
Voici un exemple comment utiliser ce package comme bibliothèque. Pour l'installer localement, en tant que bibliothèque, vous pouvez utiliser npm install git-stats (ou yarn add git-stats ):
// Dependencies
var GitStats = require ( "git-stats" ) ;
// Create the GitStats instance
var g1 = new GitStats ( ) ;
// Display the ansi calendar
g1 . ansiCalendar ( {
theme : "DARK"
} , function ( err , data ) {
console . log ( err || data ) ;
} ) ; Il existe peu de façons d'obtenir de l'aide:
Pour une référence complète de l'API, consultez le fichier documentation.md.
Vous avez une idée? Vous avez trouvé un bug? Voyez comment contribuer.
J'ouvrive presque tout ce que je peux, et j'essaie de répondre à tous ceux qui ont besoin d'aide en utilisant ces projets. De toute évidence, cela prend du temps. Vous pouvez intégrer et utiliser ces projets dans vos applications gratuitement ! Vous pouvez même modifier le code source et redistribuer (même le revendre).
Cependant, si vous en tirez un profit ou si vous voulez simplement m'encourager à continuer de créer des choses, il y a peu de façons de le faire:
Mettant en vedette et partageant les projets que vous aimez
- j'aime les livres! Je me souviendrai de vous après des années si vous m'en achetez un. ?
- Vous pouvez faire des dons uniques via PayPal. J'achèterai probablement un café thé. ?
—Sésignez un don mensuel récurrent et vous obtiendrez des nouvelles intéressantes sur ce que je fais (des choses que je ne partage pas avec tout le monde).
Bitcoin - Vous pouvez m'envoyer des bitcoins à cette adresse (ou scanner le code ci-dessous): 1P9BRsmazNQcuyTxEqveUsnf5CERdq35V6
Merci! ❤️
Si vous utilisez cette bibliothèque dans l'un de vos projets, ajoutez-le dans cette liste.
git-stats-importergit-stats-fcc-importerMit © ionică bizău
