go-forge/forge.go

package forge

// Forge is the top-level client for the Forgejo API.
//
// Usage:
//
//	ctx := context.Background()
//	f := forge.NewForge("https://forge.lthn.ai", "token")
//	repo, err := f.Repos.Get(ctx, forge.Params{"owner": "core", "repo": "go-forge"})
type Forge struct {
	client *Client

	Repos         *RepoService
	Issues        *IssueService
	Pulls         *PullService
	Orgs          *OrgService
	Users         *UserService
	Teams         *TeamService
	Admin         *AdminService
	Branches      *BranchService
	Releases      *ReleaseService
	Labels        *LabelService
	Webhooks      *WebhookService
	Notifications *NotificationService
	Packages      *PackageService
	Actions       *ActionsService
	Contents      *ContentService
	Wiki          *WikiService
	Misc          *MiscService
	Commits       *CommitService
	Milestones    *MilestoneService
	ActivityPub   *ActivityPubService
}

// NewForge creates a new Forge client.
//
// Usage:
//
//	ctx := context.Background()
//	f := forge.NewForge("https://forge.lthn.ai", "token")
//	repos, err := f.Repos.ListOrgRepos(ctx, "core")
func NewForge(url, token string, opts ...Option) *Forge {
	c := NewClient(url, token, opts...)
	f := &Forge{client: c}
	f.Repos = newRepoService(c)
	f.Issues = newIssueService(c)
	f.Pulls = newPullService(c)
	f.Orgs = newOrgService(c)
	f.Users = newUserService(c)
	f.Teams = newTeamService(c)
	f.Admin = newAdminService(c)
	f.Branches = newBranchService(c)
	f.Releases = newReleaseService(c)
	f.Labels = newLabelService(c)
	f.Webhooks = newWebhookService(c)
	f.Notifications = newNotificationService(c)
	f.Packages = newPackageService(c)
	f.Actions = newActionsService(c)
	f.Contents = newContentService(c)
	f.Wiki = newWikiService(c)
	f.Misc = newMiscService(c)
	f.Commits = newCommitService(c)
	f.Milestones = newMilestoneService(c)
	f.ActivityPub = newActivityPubService(c)
	return f
}

// Client returns the underlying HTTP client.
//
// Usage:
//
//	client := f.Client()
func (f *Forge) Client() *Client { return f.client }