Repolode
Enviar
google

google/go-github

Biblioteca cliente em Go para acessar a GitHub v3 REST API, com serviços tipados para repositórios, organizações, issues e muito mais.

Ver no GitHubSite
Estrelas
11,340
Forks
2,569
Issues abertas
29
Último commit
há 7 horas

O que é?

go-github é uma biblioteca cliente em Go para a GitHub REST API v3. A biblioteca permite criar um cliente e usá-lo por meio de grupos de serviços que espelham a estrutura da documentação da GitHub API, como Repositories, Organizations e Pull Requests. As requisições e respostas são representadas como structs de Go, para que quem usa a biblioteca trabalhe com dados tipados em vez de JSON bruto.

A biblioteca cobre questões comuns ao chamar a API diretamente. Inclui autenticação baseada em token, funções auxiliares para detectar erros de limite de requisições primário e secundário, paginação por número de página ou cursores de string, além de métodos iteradores baseados no pacote iter do Go. Também oferece structs e funções de validação para analisar payloads de webhooks do GitHub.

O projeto tem como alvo as duas versões principais mais recentes do Go e é mantido como um módulo Go com caminhos de importação versionados. O cache de requisições condicionais fica a cargo de um transporte HTTP com cache, que o projeto recomenda usar junto com o cliente.

Recursos principais

  • 01Structs tipadas de Go para requisições e respostas da GitHub REST API.
  • 02Cliente organizado por serviços para corresponder à documentação da GitHub API.
  • 03Opções de autenticação por token e GitHub App.
  • 04Funções auxiliares para detectar erros de limite de requisições primário e secundário.
  • 05Suporte à paginação com iteradores por número de página e por cursor.
  • 06Structs e validadores para analisar eventos de webhook do GitHub.

Casos de uso

  • Criar bots ou ferramentas de CI em Go que leem ou atualizam repositórios, issues e pull requests.
  • Desenvolver backends de GitHub App que processam eventos de webhook em Go.
  • Automatizar tarefas de administração de organizações, como listar membros ou gerenciar equipes.
  • Escrever testes do comportamento da GitHub API usando uma biblioteca de mocks.

Início rápido

  1. 1

    Instale a biblioteca no seu módulo Go

    go get github.com/google/go-github/v93
  2. 2

    Importe o pacote no seu código Go

  3. 3

    Crie um cliente e chame os serviços da API

Antes de usar

  • É necessário usar uma versão recente da toolchain do Go; a versão mínima exigida é a versão major N-1 do Go.
  • A maioria dos endpoints exige um token de acesso, então você precisa configurar a autenticação antes de fazer muitas chamadas.

Tópicos

#github-api#golang#go-library#rest-api#webhooks#github#go#hacktoberfest

Perguntas frequentes

O que é go-github?
Biblioteca cliente em Go para acessar a GitHub v3 REST API, com serviços tipados para repositórios, organizações, issues e muito mais. go-github é uma biblioteca cliente em Go para a GitHub REST API v3. A biblioteca permite criar um cliente e usá-lo por meio de grupos de serviços que espelham a estrutura da documentação da GitHub API, como Repositories, Organizations e Pull Requests. As requisições e respostas são representadas como structs de Go, para que quem usa a biblioteca trabalhe com dados tipados em vez de JSON bruto.
go-github é gratuito? Qual é a licença?
go-github é open source sob a licença BSD-3-Clause. Confira os termos da licença antes de usá-lo em produtos comerciais.
go-github ainda é mantido?
Manutenção ativa. O último commit de go-github foi em 7 de nov. de 2026.
Para que posso usar go-github?
Criar bots ou ferramentas de CI em Go que leem ou atualizam repositórios, issues e pull requests. Desenvolver backends de GitHub App que processam eventos de webhook em Go. Automatizar tarefas de administração de organizações, como listar membros ou gerenciar equipes. Escrever testes do comportamento da GitHub API usando uma biblioteca de mocks.
Como instalar go-github?
Instale a biblioteca no seu módulo Go: go get github.com/google/go-github/v93 Importe o pacote no seu código Go Crie um cliente e chame os serviços da API
Onde consigo go-github?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/google/go-github

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados