github

package

v0.13.0 Latest Latest Go to latest Published: Mar 27, 2026 License: Apache-2.0 Imports: 13 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/thumbrise/autosolve

Links

Open Source Insights

Documentation ¶

Index ¶

Variables
type Client
- func NewClient(logger *slog.Logger, cfg *config.Github, transport *Transport, ...) *Client
- func (p *Client) GetMostUpdatedIssues(ctx context.Context, request Request) (Response, error)
- func (p *Client) GetRepository(ctx context.Context, owner, repo string) (*github.Repository, error)
type Cursor
type DomainMapper
- func NewDomainMapper() *DomainMapper
- func (d *DomainMapper) MapIssue(issue *github.Issue) *entities.Issue
- func (d *DomainMapper) MapIssues(issues []*github.Issue) ([]*entities.Issue, error)
type RateLimitError
- func (e *RateLimitError) Error() string
- func (e *RateLimitError) Unwrap() error
type Request
type Response
type Transport
- func NewTransport(throttler *limit.MinIntervalThrottler) *Transport
- func (t *Transport) RoundTrip(req *http.Request) (*http.Response, error)

Constants ¶

This section is empty.

Variables ¶

View Source

var ErrUnexpectedNilResponse = errors.New("go-github returned nil response without error")

Functions ¶

This section is empty.

Types ¶

type Client ¶ added in v0.7.0

type Client struct {
	// contains filtered or unexported fields
}

func NewClient ¶ added in v0.7.0

func NewClient(logger *slog.Logger, cfg *config.Github, transport *Transport, domainMapper *DomainMapper) *Client

func (*Client) GetMostUpdatedIssues ¶ added in v0.7.0

func (p *Client) GetMostUpdatedIssues(ctx context.Context, request Request) (Response, error)

GetMostUpdatedIssues fetches issues from the given repository, sorted by update time (oldest first).

The client is stateless per repository — owner and repo come from Request. Rate limiting is handled transparently by the underlying http.RoundTripper.

Returns a domain-facing Response that never exposes go-github types. Response.NotModified is true when the server returned 304 (ETag matched).

Errors are classified via mapError: transient failures (network, rate limit, 5xx) carry httperr sentinels, permanent failures (401, 404, 422) are returned as-is. Rate limit errors are wrapped in RateLimitError with RetryAfter.

func (*Client) GetRepository ¶ added in v0.12.0

func (p *Client) GetRepository(ctx context.Context, owner, repo string) (*github.Repository, error)

GetRepository fetches repository metadata from GitHub API. Used by preflight to validate repository existence and accessibility.

type Cursor ¶ added in v0.13.0

type Cursor struct {
	ETag  string
	Limit int
	Page  int
	Since time.Time
}

Cursor carries pagination and conditional-request state for a single API call. Built by the domain layer from SyncCursor; interpreted by Client.

type DomainMapper ¶ added in v0.13.0

type DomainMapper struct{}

func NewDomainMapper ¶ added in v0.13.0

func NewDomainMapper() *DomainMapper

func (*DomainMapper) MapIssue ¶ added in v0.13.0

func (d *DomainMapper) MapIssue(issue *github.Issue) *entities.Issue

func (*DomainMapper) MapIssues ¶ added in v0.13.0

func (d *DomainMapper) MapIssues(issues []*github.Issue) ([]*entities.Issue, error)

type RateLimitError ¶ added in v0.13.0

type RateLimitError struct {
	RetryAfter time.Duration
	Err        error
}

RateLimitError is a domain-visible rate limit error. It carries RetryAfter so the caller can sleep precisely until the limit resets. Does NOT depend on go-github — domain imports only this type.

func (*RateLimitError) Error ¶ added in v0.13.0

func (e *RateLimitError) Error() string

func (*RateLimitError) Unwrap ¶ added in v0.13.0

func (e *RateLimitError) Unwrap() error

type Request ¶ added in v0.13.0

type Request struct {
	Owner      string
	Repository string
	Cursor     Cursor
}

Request identifies the repository and cursor for a GitHub API call.

type Response ¶ added in v0.13.0

type Response struct {
	// Issues contains the fetched domain entities. Nil when NotModified is true.
	Issues []*entities.Issue

	// NextCursor is the recommended cursor for the next request.
	// The domain layer persists it as SyncCursor.
	NextCursor Cursor

	// NotModified is true when the server returned 304 (ETag matched).
	// Issues is nil and NextCursor is unchanged in this case.
	NotModified bool
}

Response is the domain-facing result of a GitHub API call. It isolates the domain from go-github types — *github.Response never leaves this package.

type Transport ¶ added in v0.13.0

type Transport struct {
	// contains filtered or unexported fields
}

Transport is an http.RoundTripper that ... TODO: add full responsibility description

func NewTransport ¶ added in v0.13.0

func NewTransport(throttler *limit.MinIntervalThrottler) *Transport

func (*Transport) RoundTrip ¶ added in v0.13.0

func (t *Transport) RoundTrip(req *http.Request) (*http.Response, error)

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL