Para quem está iniciando ou mesmo pessoas experientes em desenvolvimento de software, mais cedo ou mais tarde, você precisará compartilhar trechos do seu código com alguém. Por que? Seja para exemplificar uma solução legal, seja para tirar uma dúvida com a comunidade ou compartilhar uma informação em formato de texto qualquer.
O gist é uma ferramenta do GitHub feita para esses compartilhamentos ou nas palavras do GitHub: Compartilhar código, notas ou trechos de código instantaneamente. Ainda com as mesmas capacidades de um repositório normal de receber forks, comentários, etc…
Para acessar seus gists, basta estar logado na sua conta do GitHub e no dropdown onde tem a sua foto de perfil e selecionar “Seus gists” (Your gists)
Listando os seus gists
Não tem nenhum ou nunca usou? Sem problemas. Vamos criar nosso primeiro gist.
Criando um gist
Criando um novo gist
Um gist é composto de uma descrição, arquivos com nome (e extensão, importante para receber um highlight em palavras reservados) e corpo. E se é público ou secreto (nessa segunda opção, todos que tiverem o link terão acesso).
Vamos usar um problema de automação de testes usando Ruby, RSpec e Cucumber para exemplificar nosso primeiro gist. Iniciaremos postando nosso arquivo de Steps, para alguém ver o que pode estar dando errado. Ao final, o gist será criado e o link disponível para compartilhamento.
Acrescentando arquivos a um mesmo gist
Com frequência, você precisa exibir mais de um trecho de código ou arquivo para compartilhar o cenário completo para a análise de terceiros. No nosso cenário, vamos incluir o arquivo .feature . Basta editar o seu gist selecionando a opção “Adicionar arquivo”
Adicionando arquivo
Seguindo os mesmos passos anteriores, adicionamos o novo arquivo, o que dará a seguinte cara para nosso gist:
gist com um segundo arquivo
Para finalizar o cenário, vamos adicionar ao gist nosso Gemfile assim nossos colegas podem ter uma visão mais apurada de como está rodando nossa aplicação.
Conclusão
Use o gist para ajudar aos outros colegas, instrutores e até o StackOverflow a ajudarem você. Acesse esse link para visualizar como ficou nosso gist no final.
Top comments (0)