Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

Move compatibility for non github.com targets to `github.With<THING>` options

Aberta
  • Algo errado?
#4,237 6 comentários 2 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
5/5
Tempo estimado
Mais de uma semana
Facilidade para iniciantes
35/100
Tipo de issue
Funcionalidade
Clareza
Razoavelmente clara
Status de atividade
Pouca atividade
Stack de tecnologia
go
Domínio
api, backend-api-design

Direção de pesquisa

Comece revisando a configuração padrão do cliente, a opção existente github.WithEnterpriseURLs e as verificações de compatibilidade descritas na proposta. Rastreie como as versões da API e os destinos que não são github.com são configurados atualmente. Considera-se concluído quando o comportamento proposto de WithAPIVersion, WithAdvancedServer e WithEnterpriseCloud estiver projetado e implementado de forma consistente, e a opção obsoleta tiver sido tratada.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

I propose that all compatibility functionality not required for the github.com target be removed from the default client setup and only be included via a github.With<THING> option. This (hopefully) would make the default client surface area simpler to understand. The justification for this is that you already need to use github.WithEnterpriseURLs to target non github.com. I propose the following changes to adopt this pattern, with the potential for other capabilities (such as enabling/disabling preview endpoints) to be added later.

  • Default to the latest API version (2026-03-10)
    • Functions that require a specific version now check against the client version and error if not valid
  • Add github.WithAPIVersion to explicitly set a version
    • Set at the client/service level
  • Add github.WithAdvancedServer to enable GHAS support
    • Better validation of inputs
    • Support setting version
    • Add compatibility accordingly
  • Add github.WithEnterpriseCloud to enable GHEC support
    • Better validation of inputs
  • Deprecate github.WithEnterpriseURLs

I'd appreciate any feedback on this proposal.

cc: @gmlewis - @alexandear - @zyfy29 - @Not-Dhananjay-Mishra - @munlicode

Linguagem predominante
Go
Estrelas
11.3k
Forks
2.5k
Merge médio
1d 2h
PRs com merge (30d)
41

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de google/go-github

Todas as issues de google/go-github

Issues semelhantes

Mais issues de Go

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.