README
¶
Grupo de Estudos de Golang 
Exemplos antigos
Os exemplos estão sendo reescritos, muita coisa antiga precisa ser ajustada e melhorada. Os exemplos antigos estão no diretório "nao_tratados".
Comunidade
Um pouco de história
Por volta de 2015 eu estava procurando uma linguagem de programação moderna que atendesse a alguns critérios que considero importantes, deveria ser simples, compilada, abrangente e com uma boa comunidade. Com capacidade para criar executáveis multiplataforma e que aproveitasse as características de multi-processamento das máquinas modernas.
Go caiu como uma luva e comecei a usar nos meus projetos. No início de 2016 no ABC Makerspace criei um pequeno curso, o Go-Hands-On e de lá iniciamos o que acabaria se tornando o grupo de estudos.
Desde aquela época os objetivos do grupo continuam praticamente os mesmos, estudar a linguagem de programação Go e tecnologias relacionadas, dar apoio para quem está iniciando assim como manter atualizados os programadores mais experientes, criar conteúdo em português falado no Brasil.
No dia 11 de maio de 2016 criei o repositório do Grupo de Estudos de Golang no GitHub, essa se tornou nossa data de início oficial. De lá para cá fizemos centenas de encontros, praticamente toda semana, escrevemos muitos exemplos, gravamos muitos vídeos, mas o mais importante é que conhecemos muita gente boa disposta a ajudar e compartilhar o que sabe.
Esse material doi criado com ajuda de inumeras pessoas, sinta-se a vontade para usar, compartilhar e melhorar.
Instalando
A instalação do Go é bastatnte simples, o caminho mais direto é baixar o instalador para a sua plataforma e executá-lo, ou se preferir baixar os binarios.
Em ambienes UNIX/Linux geralmente é comum instalar o Go em /usr/local/go ou $HOME/go, e em ambientes Windows em C:\Go.
Apos a instalação é necessário configurar a variável PATH para que o sistema operacional possa encontrar o compilador.
Versõs antigas do Go exigiam que outras variaveis fossem condiguradas, hoje essas configurações são opcionais.
Lembre! Caso esteja usando algum anti-virus, é necessário adicionar o diretório de instalação do Go e seu diretório de projetos na lista de exceções. É comum que o anti-virus bloqueie a execução de programas compilados com Go e as vezes de forma silenciosa.
Download
Faça o download do instalador correspondente ao seu sistema operacional ou dos binarios em https://go.dev/dl/.
Microsoft Windows
Apos executar o instalador, Go estará instalada em
C:\Go
Mac OS X
Apos executar o instaldor, Go estará instalada em:
/usr/local/go
Mac OS X - Alternativa - Usando Homebrew
Se você usa o Homebrew, o Go pode ser instalado com dois simples comandos:
brew update
brew install go
Linux
Você pode descompactar o arquivo tar.gz em /usr/local ou $HOME e configurar a variável PATH.
tar -C /usr/local -xzf go1.22.0.linux-amd64.tar.gz
Perguntas frequentes
Qual framework, ORM, banco de dados, etc. usar?
O que é migration?
Qual paradigma/padrão de projeto usar em Go.
Porque o tratamento de erro é tão verborragico?
Como fazer boas perguntas e dar boas respostas
Algumas dicas para melhorar a interação com o grupo quando for enviar perguntas ou respostas.
Especifique o Problema:
- Deixe claro qual é o problema que você está enfrentando. Uma descrição precisa auxiliará os outros a entenderem e oferecerem soluções.
Demonstração do Código:
- Forneça um trecho de código, e inclua a saída esperada e atual. Isso dará aos outros uma ideia melhor do que está acontecendo.
Ambiente de Desenvolvimento:
- Mencione a versão do Go que você está usando e outras configurações de ambiente que possam ser relevantes para o problema, como o sistema operacional, por exemplo.
Formato é importante:
- Formate sua pergunta de maneira clara e legível, com uso adequado de marcações, para facilitar a leitura por outros membros do grupo.
Revise o Texto:
-
Antes de perguntar utilize as ferramentas de busca. Mesmo que não encontre a resposta, isso ajudará a formular sua dúvida de maneira mais clara.
-
Consulte nosso FAQ e o código de conduta.
-
Ao formular uma pergunta, inclua as etapas que já tentou para resolver o problema.
-
Mantenha a pergunta concisa; perguntas mais curtas tendem a ser respondidas mais rapidamente.
-
É útil demonstrar o problema com um trecho de código. Evite enviar imagens da tela; em vez disso, crie um pequeno exemplo que ilustre a dúvida ou problema em poucas linhas.
-
Se desejar, use o The Go Playground. No entanto, esteja ciente de que o playground grava os exemplos compartilhados, então evite colocar dados ou códigos sensíveis.
-
Se ninguém responder sua pergunta, não se preocupe. Pode ser que ninguém tenha a resposta no momento. Não leve para o lado pessoal.
-
Respeite a opinião dos outros. Nós programadores temos fortes opiniões sobre o que é melhor e adoramos discutir o melhor de tudo: melhor procedimento, melhor editor, melhor sistema operacional, etc. Seja objetivo e não prolongue discussões.
-
Quando escrever, evite anglicismos mas tente se manter próximo da forma popular da língua. Por exemplo: nós adotamos alguns anglicismos como mouse, kernel, etc. são comuns e aceitáveis. Aqui tem algumas substituições úteis.
-
Quando responder ao grupo, seja exemplar e lembre-se de que você é a referência que outros programadores seguirão.
Como contribuir
Primeiros passos
De uma olhada nas issues e veja se o que você quer fazer já não esta sendo discutido, se estiver ótimo, participe da discussão e de suas ideias caso não esteja você pode criar uma nova issue para discutirmos ou se preferir pode também mandar diretamente um pull request, só não esqueça de descrever muito bem o que você quer mudar/adicionar.
Formato
Material novo idealmente deve ser organizados em diretórios e ter três arquivos, um README.md descrevendo o exemplo, um exemplo.go contendo o exemplo propriamente dito e um exemplo_test.go.
exemplo/README.md
exemplo/exemplo.go
exemplo/exemplo_test.go
Cuidado com o código
Antes de mandar um pull request formate seu código com go fmt. Também é uma boa ideia passar uma ferramenta de analize estatica como golint por exemplo.
Não se prolongue demais
Uma das características que é importante manter são exemplos curtos e de fácil entendimento, tenta fazer com que os exemplos caibam em uma tela, tudo bem se não for possível, apenas mantenha isso em mente.
Exemplos rápidos, curtos, diretos e de fácil entendimento são nossa meta.
Inclua seus exemplos no The Go Playground
Inclua um link sob os exemplos que você escrever apontando para o https://play.golang.org, dessa fora o leitor pode testar seu exemplo imediatamente. Obviamente isso não é possivel com qualquer exemplo, mas onde for possivel é bom colocar.
Arquivo README.md e Rodapé
Discuta com os outros desenvolvedores o melhor lugar para colocar o seu tutorial na lista do arquivo README.md, a ideia é que os tutoriais estejam em ordem complexidade.
Enviando uma contribuição
- Faça um fork do projeto.
- Crie uma branch com as suas modificações
git checkout -b exemplo-fantastico. - Faça commit das suas alterações
git commit -m 'Implementação do novo exemplo fantástico'. - Faça um push na sua branch
git push origin exemplo-fantastico. - Faça um pull request com suas alterações.
Licença de uso
Esse material é livre, sob a licença Creative Commons, CC BY-SA. você pode usar da forma que preferir, apenas lembre de citar a fonte, não apenas copie, no lugar disso acrescente, melhore e compartilhe, assim todos ganhamos.
Directories