git tuto

Tutorial do Git

Esse repositório ajudará você a praticar o básico do fluxo do GitHub e como trabalhar em projetos de código aberto.

Aqui está um link para uma apresentação para o Git em geral: https://docs.google.com/presentation/d/1vfsg__2-t7xjygkfs9hfpkmaomn1je0v0h7glyy1au/edit?usp=Sharing

Passos

Essas etapas assumem que você instalou o Git localmente, que criou uma conta do GitHub e adicionou sua chave SSH local a ela.

1. Bifurque este repositório, usando o botão do garfo no canto superior direito.

2. Clone o seu repositório bifurcado localmente. git clone [email protected]:<your-github-handle>/git-tuto.git

3. Adicione o projeto original como um repositório distante. git remote add upstream https://github.com/zaccharieramzi/git-tuto.git

4. Crie uma nova filial para adicionar seu nome à lista de pessoas que participaram do tutorial. git checkout -b <your-name-or-pseudonym>

5. Adicione seu nome ao arquivo participants.csv . echo '<your-name-or-pseudonym>,n' >> participants.csv

6. Palco e cometer suas mudanças. git add participants.csv && git commit -m'Added <your-name-or-pseudonym> to the participants file'

7. Empurre sua filial local para o seu repositório distante. git push origin <the-name-of-your-branch>

8. Abra uma nova solicitação de tração (PR): https://github.com/zaccharieramzi/git-tuto/compare. Você tem um exemplo de relações públicas aqui.

9. Itera com feedback.

10. Depois que o PR estiver (esmagado e) mesclado, não se esqueça de atualizar o repositório local ( git checkout master && git pull upstream master ) e seu repositório distante ( git push origin master ).

Tutorial de integração contínua

Visão geral da integração contínua

Depois de entender como o fluxo do GitHub funciona, você pode tentar participar do tutorial de integração contínua (IC). Mas primeiro, o que é CI? O CI é um processo que pode ser melhor descrito como o teste contínuo do código, pois as peças são adicionadas a ele. Isso garante que uma nova adição à base de código não altere inesperadamente o comportamento do código.

Muitas ferramentas existem, mas usaremos aqui apenas o Travis CI. Para configurá -lo, você só precisa se registrar no site deles, adicione seu repositório à lista de repositórios assistidos e adicione um arquivo de configuração Travis ao seu projeto. O arquivo de configuração Travis é um arquivo YAML que contém uma lista de instruções sobre como executar os testes corretamente.

Passos

Isso pressupõe que você tenha tomado as medidas 1-4 do tutorial do Git.

1. Adicione um arquivo _function.py à pasta Funções.

2. Neste arquivo, escreva uma função simples que possa ser facilmente testada. Um exemplo é o meu arquivo de função. A função não precisa ser sobre números, mas pode ser sobre todas as estruturas de dados internas que o Python fornece.

3. Adicione um teste de unidade correspondente para esta nova função. Um exemplo de um teste de unidade correspondente é meu.

4. Execute as etapas 6-10 do Git-Tutorial com a pequena exceção de que você precisa ter uma mensagem de confirmação mais adequada.

Contribuindo

Você é livre para sugerir melhorias na apresentação e neste tutorial usando os problemas deste repositório. Uma primeira boa contribuição pode ser, por exemplo, adicionar as diretrizes contribuintes.