GitGeo

Gitgeo

Descubra a geografia do software de código aberto. Explore os locais geográficos dos desenvolvedores de software associados a um pacote de repositórios do GitHub ou um python (Pypi).

Veja, por exemplo, a geografia dos colaboradores das solicitações do pacote Python.

Por que usar Gitgeo?

• Curiosidade
• Gerenciamento da comunidade de software de código aberto
• Pesquisa sobre ecossistemas de software de código aberto
• Conformidade com segurança de TI

Redação relacionada

• Blog de visão geral gitgeo
• Gitgeo aplicado ao Blog de Ciência de Dados Python de código aberto

Instalação

pip install gitgeo

Ou:

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

Uso

(requer conexão à Internet)

• Primeiro, crie um ou mais tokens de acesso pessoal do GitHub.

• Segundo, execute esses comandos na linha de comando para definir variáveis ​​ambientais:

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

• Como alternativa, para usar vários tokens, crie um arquivo chamado tokens.txt no diretório do código e insira um token de acesso pessoal do github em cada linha.

• Terceiro, execute esses comandos na linha de comando:

gitgeo --package [package_name]

gitgeo --repo [github_repo_url]

Por exemplo:

>>> gitgeo --package requests

 -------------------
Pacote: solicitações
-------------------
Colaborador, localização
* indica o mantenedor do Pypi
-----------------------
Kennethreitz42 | Virginia, EUA
Lukasa * | Londres, Inglaterra
Sigmavirus24 | Madison, Wi
NatePrewitt * | Nenhum
slingamn | Nenhum
Brauliovm | Málaga e Granada, Espanha
dpursehouse | Kawasaki
jgorset | Oslo, Noruega
...

Ou:

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

 -------------------
Github Repo: PSF/solicitações
-------------------
Colaborador, localização
-----------------------
Kennethreitz42 | Virginia, EUA | Estados Unidos
Lukasa | Londres, Inglaterra | Reino Unido
Sigmavirus24 | Madison, Wi | Estados Unidos
NatePrewitt | Nenhum | Nenhum
...

Existem outras opções de linha de comando também:

Adicione --summary para obter os resultados resumidos pelo país. por exemplo

>>> gitgeo --package requests --summary

 -------------------
Pacote: solicitações
Github Repo: PSF/solicitações
-------------------
País | # De colaboradores
-----------------------------
Estados Unidos 37
Nenhum 23
Reino Unido 4
Canadá 4
Alemanha 4
Suíça 4
Espanha 2
Rússia 2
...

Adicione --map Ao usar a opção --repo para criar um mapa HTML salvo na pasta Resultados. Veja a imagem acima para obter um exemplo estático. O mapa real inclui capacidade de zoom e dica de ferramenta.

Adicionar --ouput_csv para produzir CSV de resultados para a pasta de resultados.

Para criar um CSV de colaboradores de muitos repositórios, insira repositórios em linhas separadas no arquivo repos.txt. Em seguida, use o sinalizador --multirepo .

Adicione multirepo_map e, em seguida, um nome de arquivo para criar um mapa de CSV OUPUT. A saída CSV deve estar localizada na pasta de resultados.

Adicione --num e especifique um múltiplo de 100 de 100 (padrão) a 500 para especificar o número de colaboradores analisados ​​por repo.

Executar testes:

pytest

Quer contribuir?

• Abra um pr. Estamos felizes em aceitar solicitações de tração. Utilizamos preto e pylint e pydocstyle, embora estejamos felizes em ajudar se você nunca usou essas ferramentas antes.
• Abra um problema. Diga -nos seu problema ou uma funcionalidade que você deseja.
• Deseja ajudar a construir uma comunidade relacionada ao Gitgeo e ferramentas de exploração de ecossistemas de software de código aberto similares? Envie um e -mail para [email protected].