GitGeo

Gitgeo

Temukan geografi perangkat lunak sumber terbuka. Jelajahi lokasi geografis pengembang perangkat lunak yang terkait dengan repositori GitHub atau paket Python (PYPI).

Lihat, misalnya, geografi kontributor untuk permintaan paket Python.

Mengapa menggunakan gitgeo?

• Keingintahuan
• Manajemen Komunitas Perangkat Lunak Sumber Terbuka
• Penelitian tentang Ekosistem Perangkat Lunak Sumber Terbuka
• Kepatuhan keamanan TI

Tulisan terkait

• Blog Ikhtisar Gitgeo
• Gitgeo diterapkan pada blog sains data python open source

Instalasi

pip install gitgeo

Atau:

git clone https://github.com/IQTLabs/GitGeo

Penggunaan

(Membutuhkan koneksi internet)

• Pertama, buat satu atau lebih token akses pribadi GitHub.

• Kedua, jalankan perintah ini di baris perintah untuk mengatur variabel lingkungan:

   export GITHUB_USERNAME= ' [github_username] '
  export GITHUB_TOKEN= ' [github_token] '

• Atau, untuk menggunakan beberapa token, membuat file yang disebut Tokens.txt di direktori kode dan memasukkan token akses pribadi GitHub pada setiap baris.

• Ketiga, jalankan perintah ini di baris perintah:

gitgeo --package [package_name]

gitgeo --repo [github_repo_url]

Misalnya:

>>> gitgeo --package requests

 -----------------
Paket: Permintaan
-----------------
Kontributor, Lokasi
* menunjukkan pemeliharaan pypi
---------------------
Kennethreitz42 | Virginia, AS
Lukasa * | London, Inggris
sigmavirus24 | Madison, WI
Nateprewitt * | Tidak ada
slingamn | Tidak ada
Brauliovm | Malaga & Granada, Spanyol
dpursehouse | Kawasaki
jgorset | Oslo, Norwegia
...

Atau:

>>> gitgeo --repo www.github.com/psf/requests

 -----------------
Repo GitHub: PSF/Permintaan
-----------------
Kontributor, Lokasi
---------------------
Kennethreitz42 | Virginia, AS | Amerika Serikat
Lukasa | London, Inggris | Inggris
sigmavirus24 | Madison, WI | Amerika Serikat
nateprewitt | Tidak ada | Tidak ada
...

Ada juga opsi baris perintah lainnya:

Tambahkan --summary untuk mendapatkan hasil yang dirangkum berdasarkan negara. misalnya

>>> gitgeo --package requests --summary

 -----------------
Paket: Permintaan
Repo GitHub: PSF/Permintaan
-----------------
Negara | # Kontributor
---------------------------
Amerika Serikat 37
Tidak ada 23
United Kingdom 4
Kanada 4
Jerman 4
Swiss 4
Spanyol 2
Rusia 2
...

Tambahkan --map Saat menggunakan opsi --repo untuk membuat peta HTML yang disimpan di folder hasil. Lihat gambar di atas untuk contoh statis. Peta nyata termasuk zooming dan kemampuan tooltip.

Tambahkan --ouput_csv ke output CSV hasil ke folder hasil.

Untuk membuat CSV kontributor dari banyak repositori, masukkan repositori pada baris terpisah dalam file repos.txt. Kemudian gunakan bendera --multirepo .

Tambahkan multirepo_map dan kemudian nama file untuk membuat peta csv ouput. Output CSV harus ditempatkan di folder hasil.

Tambahkan --num dan tentukan kelipatan 100 dari 100 (default) ke 500 untuk menentukan jumlah kontributor yang dianalisis per repo.

Jalankan tes:

pytest

Ingin berkontribusi?

• Buka PR. Kami senang menerima permintaan tarik. Kami menggunakan Black dan Pylint dan Pydocstyle, meskipun kami senang membantu jika Anda belum pernah menggunakan alat -alat itu sebelumnya.
• Buka masalah. Beri tahu kami masalah Anda atau fungsionalitas yang Anda inginkan.
• Ingin membantu membangun komunitas yang terkait dengan gitgeo dan alat eksplorasi ekosistem perangkat lunak open source serupa? Silakan kirim email ke [email protected].