Help us shape the future of Go! Take the 2026 Go Developer Survey

Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

githubsync

package

Go to main page

Versions in this module

v0

v0.2.5

Nov 1, 2026

v0.2.4

Oct 31, 2026

v0.2.3

Oct 29, 2026

v0.2.2

Oct 29, 2026

Changes in this version

type Admission

+ Notification *Notification

type Follow

+ Muted bool

+ type Notification struct

+ Body string

+ Title string

type Repository

+ Notify bool

type Service

+ func (s *Service) SetNotify(ctx context.Context, ownerID string, repositoryID int64, notify bool) error

type Store

+ PullRequestHead func(ctx context.Context, repositoryID int64, number int) (head string, opened bool, err error)

+ SetMuted func(ctx context.Context, ownerID string, repositoryID int64, muted bool) error

v0.2.1

Oct 26, 2026

Changes in this version

+ var ErrForbidden = errors.New("GitHub repository is not accessible to this account")

+ var ErrInvalidResult = errors.New("fetch result does not match the leased pull request")

+ var ErrLeaseLost = errors.New("fetch lease lost")

+ var ErrNotConnected = errors.New("GitHub is not connected")

+ var ErrNotFound = errors.New("not found")

+ var ErrReconnect = errors.New("GitHub authorization expired or was revoked; connect again")

+ var ErrSignature = errors.New("invalid webhook signature")

+ type Admission struct

+ OwnerID string

+ Request ingestion.Request

+ type Connection struct

+ AccessExpiresAt int64

+ AccessToken []byte

+ ConnectedAt int64

+ Login string

+ OwnerID string

+ RefreshExpiresAt int64

+ RefreshToken []byte

+ Status string

+ UserID int64

+ type Follow struct

+ CreatedAt int64

+ FullName string

+ InstallationID int64

+ OwnerID string

+ RepositoryID int64

+ Status string

+ VerifiedAt int64

+ type GitHub interface

+ AppSlug func(ctx context.Context) (string, error)

+ AuthorizeURL func(state, redirectURI string) string

+ Exchange func(ctx context.Context, code, redirectURI string) (github.UserToken, error)

+ InstallationToken func(ctx context.Context, installationID int64, repositoryIDs []int64, ...) (github.Token, error)

+ OpenPullRequests func(ctx context.Context, installationID int64, fullName string) ([]github.PullRequest, error)

+ PullRequest func(ctx context.Context, installationID int64, fullName string, number int) (github.PullRequest, error)

+ Refresh func(ctx context.Context, refreshToken string) (github.UserToken, error)

+ User func(ctx context.Context, accessToken string) (github.Account, error)

+ UserRepositories func(ctx context.Context, accessToken string) ([]github.Repository, error)

+ VerifyWebhook func(body []byte, signature256 string) bool

+ type Lease struct

+ Attempt int

+ Generation int64

+ Ref PullRequestRef

+ RetentionRun string

+ Token string

+ type Options struct

+ Now func() time.Time

+ PublicURL string

+ TokenKey []byte

+ type PullRequestRef struct

+ FullName string

+ InstallationID int64

+ Number int

+ RepositoryID int64

+ type Repository struct

+ Followed bool

+ FullName string

+ ID int64

+ Lost bool

+ Private bool

+ type Service struct

+ func New(store Store, client GitHub, options Options) (*Service, error)

+ func (s *Service) Complete(ctx context.Context, ownerID, state, code string) error

+ func (s *Service) Connect(ctx context.Context, ownerID string) (string, error)

+ func (s *Service) Disconnect(ctx context.Context, ownerID string) error

+ func (s *Service) Finish(ctx context.Context, result fetchprotocol.Result) error

+ func (s *Service) Follow(ctx context.Context, ownerID string, repositoryID int64) error

+ func (s *Service) Followers(ctx context.Context, repositoryID int64) ([]string, error)

+ func (s *Service) Lease(ctx context.Context) (*fetchprotocol.Job, error)

+ func (s *Service) Reconcile(ctx context.Context) error

+ func (s *Service) Repositories(ctx context.Context, ownerID string) ([]Repository, error)

+ func (s *Service) Resync(ctx context.Context, ownerID string) error

+ func (s *Service) Status(ctx context.Context, ownerID string) (Status, error)

+ func (s *Service) Unfollow(ctx context.Context, ownerID string, repositoryID int64) error

+ func (s *Service) Webhook(ctx context.Context, event, delivery, signature string, body []byte) error

+ type Status struct

+ Connected bool

+ InstallURL string

+ Login string

+ State string

+ type Store interface

+ ClaimRefresh func(ctx context.Context, token string, now, leaseUntil int64) (Lease, error)

+ CompleteRefresh func(ctx context.Context, lease Lease, state string, admissions []Admission, ...) error

+ Connection func(ctx context.Context, ownerID string) (Connection, error)

+ Connections func(ctx context.Context) ([]Connection, error)

+ DeleteConnection func(ctx context.Context, ownerID string) error

+ DeleteFollow func(ctx context.Context, ownerID string, repositoryID int64) error

+ Follows func(ctx context.Context, ownerID string) ([]Follow, error)

+ KnownOpen func(ctx context.Context, repositoryID int64) ([]int, error)

+ Leased func(ctx context.Context, repositoryID int64, number int, token string, now int64) (Lease, []byte, error)

+ LoseInstallation func(ctx context.Context, installationID int64, repositoryIDs []int64) error

+ PutConnection func(ctx context.Context, connection Connection) error

+ PutFollow func(ctx context.Context, follow Follow) error

+ PutOAuthState func(ctx context.Context, hash, ownerID string, expiresAt int64) error

+ RecordDelivery func(ctx context.Context, id, event string, now int64) error

+ RecordLease func(ctx context.Context, lease Lease, leased []byte, now int64) error

+ ReleaseRefresh func(ctx context.Context, lease Lease, retryAt int64, detail string) error

+ RepositoryFollows func(ctx context.Context, repositoryID int64) ([]Follow, error)

+ RequestRefresh func(ctx context.Context, ref PullRequestRef, retentionRun string, now int64) error

+ RevokeUser func(ctx context.Context, userID int64) error

+ SeenDelivery func(ctx context.Context, id string) (bool, error)

+ TakeOAuthState func(ctx context.Context, hash string, now int64) (string, error)