GitGeo

Gitgeo

Descubra la geografía del software de código abierto. Explore las ubicaciones geográficas de los desarrolladores de software asociados con un repositorio de GitHub o un paquete Python (PYPI).

Ver, por ejemplo, la geografía de los contribuyentes a las solicitudes del paquete de Python.

¿Por qué usar Gitgeo?

• Curiosidad
• Gestión comunitaria de software de código abierto
• Investigación sobre ecosistemas de software de código abierto
• Cumplimiento de seguridad de TI

Escritura relacionada

• Blog de descripción general de Gitgeo
• Gitgeo aplicado al Blog de ciencia de datos de Python de código abierto

Instalación

pip install gitgeo

O:

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

Uso

(requiere conexión a Internet)

• Primero, cree uno o más tokens de acceso personal GitHub.

• En segundo lugar, ejecute estos comandos en la línea de comando para establecer variables ambientales:

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

• Alternativamente, para usar múltiples tokens, cree un archivo llamado tokens.txt en el directorio del código e ingrese un token de acceso personal GitHub en cada línea.

• Tercero, ejecute estos comandos en la línea de comando:

gitgeo --package [package_name]

gitgeo --repo [github_repo_url]

Por ejemplo:

>>> gitgeo --package requests

 -----------------
Paquete: solicitudes
-----------------
Colaborador, ubicación
* Indica el mantenedor de Pypi
---------------------
Kennethreitz42 | Virginia, EE. UU.
Lukasa * | Londres, Inglaterra
sigmavirus24 | Madison, WI
nateprewitt * | Ninguno
Slingamn | Ninguno
Brauliovm | Málaga y Granada, España
dpursehouse | Kawasaki
Jgorset | Oslo, Noruega
...

O:

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

 -----------------
Repo de GitHub: PSF/Solicitudes
-----------------
Colaborador, ubicación
---------------------
Kennethreitz42 | Virginia, EE. UU. | Estados Unidos
Lukasa | Londres, Inglaterra | Reino Unido
sigmavirus24 | Madison, WI | Estados Unidos
nateprewitt | Ninguno | Ninguno
...

También hay otras opciones de línea de comando:

Agregue --summary para obtener los resultados resumidos por el país. p.ej

>>> gitgeo --package requests --summary

 -----------------
Paquete: solicitudes
Repo de GitHub: PSF/Solicitudes
-----------------
País | # De contribuyentes
---------------------------
Estados Unidos 37
Ninguno 23
Reino Unido 4
Canadá 4
Alemania 4
Suiza 4
España 2
Rusia 2
...

Agregue --map cuando use la opción --repo para crear un mapa HTML guardado en la carpeta de resultados. Vea la imagen de arriba para el ejemplo estático. El mapa real incluye el zoom y la capacidad de información sobre herramientas.

Agregar --ouput_csv para emitir CSV de resultados a la carpeta de resultados.

Para crear un CSV de contribuyentes de muchos repositorios, ingrese repositorios en líneas separadas en el archivo repos.txt. Luego use la bandera --multirepo .

Agregue multirepo_map y luego un nombre de archivo para crear un mapa de CSV OUPT. La salida de CSV debe ubicarse en la carpeta de resultados.

Agregue --num y especifique un múltiplo de 100 de 100 (predeterminado) a 500 para especificar el número de contribuyentes analizados por repos.

Ejecutar pruebas:

pytest

¿Quieres contribuir?

• Abre un PR. Estamos contentos de aceptar solicitudes de extracción. Usamos Black, Pylint y Pydocstyle, aunque nos complace ayudar si no ha usado esas herramientas antes.
• Abra un problema. Cuéntanos tu problema o una funcionalidad que quieras.
• ¿Quiere ayudar a construir una comunidad relacionada con Gitgeo y herramientas similares de exploración de ecosistemas de software de código abierto? Envíe un correo electrónico a [email protected].