GitGeo

Gitgeo

Découvrez la géographie des logiciels open source. Explorez les emplacements géographiques des développeurs de logiciels associés à un référentiel GitHub ou à un package Python (PYPI).

Voir, par exemple, la géographie des contributeurs aux demandes de package Python.

Pourquoi utiliser Gitgeo?

• Curiosité
• Gestion de la communauté des logiciels open source
• Recherche sur les écosystèmes de logiciels open source
• Conformité de la sécurité informatique

Écriture connexe

• Blog de vue d'ensemble de Gitgeo
• Gitgeo a appliqué au blog de la science des données Python open source

Installation

pip install gitgeo

Ou:

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

Usage

(nécessite une connexion Internet)

• Tout d'abord, créez un ou plusieurs jetons d'accès personnel GitHub.

• Deuxièmement, exécutez ces commandes dans la ligne de commande pour définir les variables environnementales:

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

• Alternativement, pour utiliser plusieurs jetons, créez un fichier appelé tokens.txt dans le répertoire du code et entrez un jeton d'accès personnel GitHub sur chaque ligne.

• Troisièmement, exécutez ces commandes dans la ligne de commande:

gitgeo --package [package_name]

gitgeo --repo [github_repo_url]

Par exemple:

>>> gitgeo --package requests

 -----------------
Package: Demandes
-----------------
Contributeur, emplacement
* Indique le mainteneur PYPI
---------------------
Kennethreitz42 | Virginie, États-Unis
Lukasa * | Londres, Angleterre
Sigmavirus24 | Madison, WI
NatePrewitt * | Aucun
SLINGAMN | Aucun
Brauliovm | Malaga et Grenade, Espagne
DPURSEHOUSE | Kawasaki
JGORSET | Oslo, Norvège
...

Ou:

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

 -----------------
GitHub Repo: PSF / Demandes
-----------------
Contributeur, emplacement
---------------------
Kennethreitz42 | Virginie, États-Unis | États-Unis
Lukasa | Londres, Angleterre | Royaume-Uni
Sigmavirus24 | Madison, WI | États-Unis
NatePrewitt | Aucun | Aucun
...

Il existe également d'autres options de ligne de commande:

Ajouter --summary pour que les résultats résument par le pays. par exemple

>>> gitgeo --package requests --summary

 -----------------
Package: Demandes
GitHub Repo: PSF / Demandes
-----------------
Pays | # Des contributeurs
---------------------------
États-Unis 37
Aucun 23
Royaume-Uni 4
Canada 4
Allemagne 4
Suisse 4
Espagne 2
Russie 2
...

Ajoutez --map lors de l'utilisation de l'option --repo pour créer une carte HTML enregistrée dans le dossier des résultats. Voir l'image ci-dessus pour l'exemple statique. La carte réelle inclut le zoom et la capacité d'info-bulle.

Ajouter --ouput_csv pour sortir CSV du dossier des résultats aux résultats.

Pour créer un CSV de contributeurs à partir de nombreux référentiels, entrez des référentiels sur des lignes distinctes dans le fichier repos.txt. Ensuite, utilisez le drapeau --multirepo .

Ajoutez multirepo_map puis un nom de fichier pour créer une carte de CSV ouput. La sortie CSV doit être située dans le dossier de résultats.

Ajoutez --num et spécifiez un multiple de 100 de 100 (par défaut) à 500 pour spécifier le nombre de contributeurs analysés par repo.

Exécutez des tests:

pytest

Vous voulez contribuer?

• Ouvrez un pr. Nous sommes heureux d'accepter les demandes de traction. Nous utilisons Black et Pylint et Pydocstyle, bien que nous soyons heureux de vous aider si vous n'avez pas utilisé ces outils auparavant.
• Ouvrez un problème. Dites-nous votre problème ou une fonctionnalité que vous souhaitez.
• Vous voulez aider à construire une communauté liée à Gitgeo et à des outils d'exploration d'écosystème de logiciels open source similaires? Veuillez envoyer un e-mail à [email protected].