Skip to content

Latest commit

 

History

History
80 lines (53 loc) · 3.03 KB

README.md

File metadata and controls

80 lines (53 loc) · 3.03 KB
Raw

op-desafios

Este repositório contém as soluções para os desafios em http://osprogramadores.com/desafios.

Como contribuir

  1. Faça um fork deste repositório clicando no botão Fork no canto superior da tela.

  2. Faça um clone do repositório para a sua estação de trabalho:

    $ git clone https://github.com/<seu_usuario>/op-desafios

  3. Entre no diretorio criado pelo git (op-desafios).

  4. Crie um remote apontando para o repositório dos OsProgramadores:

    $ git remote add upstream https://github.com/OsProgramadores/op-desafios

  5. Uma vez feito o fork, crie um branch de trabalho (por exemplo, "dev")

    $ git checkout -b dev

  6. Trabalhe normalmente no branch de desenvolvimento. Quando estiver satisfeito com o resultado, faça o commit e o push com:

    $ git push origin dev

  7. O branch usado no "git checkout" tem que casar com o branch usado no "git push".

  8. Entre no github e abra um Pull Request (PR).

  9. Fique atento a erros na página do Pull Request (indicando que os testes de integração falharam) ou comentários dos admins. Se alterações forem necessárias, modifique o fonte e faça outro "git commit" seguido de "git push origin dev". Não é necessário fechar o PR e abrir outro.

Estrutura de diretórios

Ao criar um novo programa, mantenha a estrutura abaixo:

desafio-01/
  seu_usuario_no_github/
    linguagem-feature/
      arquivos com a sua solução
      README.md <-- comentários, opcional.
    ...
desafio-02/
  seu_usuario_no_github/
    linguagem-feature/
      arquivos com a sua solução
    ...

  • Linguagem é a linguagem em que o seu programa foi feito (em minúsculas). Olhe os outros casos de nomes de linguagens usadas no repo e mantenha o padrão.

  • feature é um diferenciador de uma feature dentro da linguagem. Por exemplo, dois programas em python usando duas libraries, uma chamada foo e uma chamada bar, ficariam em dois diretorios separados: python-libfoo e python-libbar. Só submeta mais de uma versão por linguagem se a diferença no programa for significativa.

  • Arquivos com espaços ou caracteres não ASCII (acentos, emoji, etc) não serão aceitos no repositório.

Observações para linguagens específicas

Python

  1. Apenas python3 é suportado.

  2. Use espaços (não tabs!) para indentar o seu código.

  3. Use indentação em 4 espaços.

  4. Cheque o seu código com o pylint antes de enviar. O arquivo de configuração usado pelo depo está em travis-ci/pylint3.rc. Para checar o seu programa, rode:

    $ pylint --rcfile=<diretorio_do_seu_repo>/travis-ci/pylint3.rc <nome_do_seu_arquivo.py>

  5. Pull Requests contendo código em Python serão automaticamente verificados pelo pylint. Ao submeter um PR, observe a tela do PR e verifique se a integração falhou. Em caso de erro, clique no link e verifique as mensagens de erro do pylint. Corrija o código, faça outro submit e push.

Em caso de problemas ou dúvidas, entre em contato com um dos administradores.