Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
103 lines (60 loc) · 5.04 KB

CONTRIBUTING.md

File metadata and controls

103 lines (60 loc) · 5.04 KB

Contributing

Pode contribuir a vontade, você será sempre bem-vindo(a). Mas temos algumas regras para serem seguidas.

Adicionar/Atualizar funcionalidades

Você olhou a aplicação e pensou em alguma funcionalidade que deveria ser adicionada no projeto ? 😮

Então, você tem duas opções:

Criando uma issue

Na página do projeto, você pode clicar no botão Issues e na página irá aparecer um botão new issue, então é só selecionar e seguir os seguintes passos:

  • Selecione o tipo da sua issue: Bug ou Feature.
  • Dê um bom nome a sua issue.
  • Detalhe bem sobre qual objetivo da issue.
  • Imagens caso possível.
  • Selecione labels para sua issue.
  • Por fim, clique em Submit new issue.

Clonar o repositório

Na página inicial do repositório tem um botão Fork. Ao clicar é só esperar concluir o fork. E então ele irá criar o repositório na sua conta. E agora é só clonar em sua máquina, assim:

git clone https://github.com/<nome_de_usuario>/PyGraph

Ao concluir, você terá o repositório em seu computador e então é só abrir em seu editor preferido e fazer suas modificações.

Ao terminar suas modificações, você deve commitar suas alterações, mas primeiro:

git add .

O comando acima irá preparar todos os arquivos modificados para serem commitados(você deve estar dentro da pasta do projeto para usar o comando). Agora é só commitar as alterações:

git commit -m "<Sua_Mensagem>"

E por fim, você irá enviar as alterações para o repositório remoto:

git push origin master

Mas isso só irá alterar no seu fork, o repositório oficial não vai ter suas alterações e agora ? 😕

Calma, agora que entra o Pull Request ou PR

Contribuir com implementação:

Depois de ter realizado o fork e o clone do projeto, escolhido seu editor de texto favorito, nós amamos o VSCode, mas fique a vontade para escolher o seu. Então é hora da codificação.

Mas calma ai, antes de qualquer coisa, você deve escolher uma issue que pretender trabalhar. Se a issue que trata sobre a funcionalidade não existir, você deve criar e dizer que esta trabalhando nela, caso ela exista você deve dizer lá(caso não já tenha alguém) que pretende trabalhar na issue. E após feito isso, agora sim você está pronto para codificação.

Entendendo as pastas:

O projeto se encontra na pasta py_graph_t, estamos aceitando dicas de nomes para biblioteca também 😊 .

  • Na pasta edges : Encontra-se todos os arquivos sobre arestas de um grafo, todas as implementações de uma aresta irão estar nessa pasta. Por exemplo, quando existir um grafo com arestas que possuem pesos, essa aresta será criada dentro dessa pasta, herdando da classe base de aresta(SimpleEdge).

  • Na pasta vertex : Encontra-se todos os arquivos sobre vértices de um grafo, todas as implementações de um vértice irão estar nessa pasta. Por exemplo, quando existir um grafo com vértices que possuem um dado a ser salvo, esse vértice será criado dentro dessa pasta, herdando da classe base de vértice(SimpleVertex).

Depois de implementar sua solução/funcionalidade:

Muito bem. Agora só falta uma coisinha para abrir sua PR e ela ser aceita, Testes. Muita gente não gosta, nós sabemos, mas são eles que garantem que todo nosso código esteja funcionando. Assim facilitando muito a vida dos desenvolvedores.

Testes:

Para os testes nós optamos por usar o pytest, visto que é bem aceito pela comunidade Python e bastante fácil de usar.

  • Primeiro você precisa instalar o pytest:

    $ pip3 install -U pytest❯ pytest --version

  • Para testar se tudo funcionou bem, digite no terminal:

    $ pytest --version

    • Se a saída for a mesma que abaixo(podendo mudar a versão) esta tudo correto:

    This is pytest version 5.2.0, imported from /home/rickecr/.local/lib/python3.6/site-packages/pytest.py

E agora é só criar sua classe de teste, caso a classe de teste para a classe que você fez a funcionalidade ainda não exista. Você deve criar os testes para a(s) sua(s) funcionalidade(s), tentando pegar todos os casos extremos, sabemos que é dificil também.

E após realizar os testes, você está pronto para realizar sua PR e ser feliz com o mundo OpenSource.

Realizando uma Pull Request - PR

Na página do seu fork irá aparecer uma mensagem em amarelo solicitando que você faça uma Pull Request para o repositório original. Ao clicar irá abrir uma página para você preencher as informações sobre sua PR.

  • Referencie a issue em que você está trabalhando usando #<numero_da_issue>

  • Descreva suas modificações

  • Espere pela avaliação da sua PR, e pode ocorrer de pedimos algumas alterações a seres feitas