# GitStats

> GitHub projelerindeki katkı dağılımını saf JavaScript ile tabloya döken küçük bir araç ve kullanım rehberi.

Source: https://omergulcicek.com/blog/gitstats

Merhaba!

GitHub'ta herhangi bir projede **Insights** sekmesinden **Contributors** linkine tıklarsak, o projeye kimin ne kadar katkı yaptığını detaylı olarak görebiliriz. Kişinin projeye kaç kod satır kod ekleyip/sildiğini ya da kaç commit yaptığını rakamsal olarak ve tarih çizelgesinde grafiksel olarakta görebiliyoruz.

Örnek olarak [Google'ın Fonts projesi](https://github.com/google/fonts/graphs/contributors)ni seçtim. Burada her kullanıcı bilgileri _Box_ sınıfı içerisinde tutulmuş. Şimdi biraz daha teknik bilgi gerektiren kısma geçip, bu veriler ile nasıl yüzdelik hesaplaması yapabileceğimizi gösterelim.

### Başlarken

İlk olarak bu Box kutularını bir değişkende dizi halinde tutmak için querySelectorAll(); fonksiyonunu kullandım.

```javascript
var lists = document.querySelectorAll(".contrib-person .Box");
```

Ardından toplam commit sayısını, kullanıcı adı, kullanıcının commit'i, yüzdelik katkısını tutmak için değişkenlerini tanımladım.

```javascript
var totalCommits = 0;
var username, commit, percent;
```

Kişilerin bilgilerini tutabileceğim bir **githubPercent** objesi ve değişkenleri set edebilmek için **gitHub** adında bir fonksiyon tanımladım.

```javascript
var githubPercent = {};

function gitHub(username, commit, percent) {
	this.username = username;
	this.commit = commit;
	this.percent = percent;
}
```

### Toplam Commit Sayısı

Toplam commit sayısı sayfada görülmüyor; sadece kişilerin toplam katkısı var. O zaman öncelikle bir döngü ile her kullanıcının katkılarını toplayarak toplam commit sayısına erişelim. Aşağıdaki JavaScript döngüsünde _Box_ sınıfına ait etiketin içerisinde commit sayısına erişip bu ifadeyi tam sayıya çevirdim.

```javascript
Array.prototype.forEach.call(lists, function (el, i) {
	totalCommits += parseInt(
		el.querySelector(".cmeta .link-gray").text.replace(",", "")
	);
});
```

### Yüzdelik Katkı İstatistikleri

Tekrardan bir döngü oluşturarak bu sefer; kullanıcı adı, commit sayısı çekiyoruz. Commit sayısını, toplam commit sayısına bölerek de yüzdelik olarak değeri elde etmiş olacağız. Son olarak bu değerleri fonksiyona gönderip bunu da objemize ekliyoruz.

```javascript
Array.prototype.forEach.call(lists, function (el, i) {
	username = el.querySelector("a.text-normal").text;
	commit = parseInt(el.querySelector(".cmeta .link-gray").text.replace(",", ""));
	percent = parseFloat((commit / totalCommits) * 100).toFixed(2);
	githubPercent[i] = new gitHub(username, commit, percent);
});
```

JavaScript'te console.log() fonksiyonu ile ekrana objeyi yazabiliriz fakat daha açıklayıcı olması açısından console.table() fonksiyonunu kullanmayı daha doğru buldum. Google'ın fonts projesinde testimizi yapıyorduk. GitStats kodlarını konsola yazdığımızda hangi kullanıcının ne kadar katkı sağladığını tablo halinde görebiliyoruz.

### GitHub Rest API

**GitStats** kodlarının çalışması için mecburen GitHub'tan proje ile ilgili sayfayı açıp konsoldan çalıştırabiliyoruz. Ajax isteği gönderip herhangi bir sayfadan bu verileri çekebilir miyiz diye kısa bir araştırma yapmıştım fakat konsola yazdığım kodlarda güvenlik engeline takıldım.

Bu verilere uzaktan erişip aynı çalışma mantığını **GitHub Rest API** kullanarak tekrardan geliştirmek istiyorum. GitStats sadece kişisel olarak JavaScript ile haşır neşirliğim artsın diye yapılmış bir minik projeydi. API ile tamamladığım taktirde v2 olarak projeyi güncelleyip yeni bir makale ile yapılışını anlatacağım.
