forge

Oct 2, 2026

Changes in this version

type AzureDevOpsForge

+ func (a *AzureDevOpsForge) UpdateRelease(ctx context.Context, releaseID string, meta ReleaseMeta) error

type Forge

+ UpdateRelease func(ctx context.Context, releaseID string, meta ReleaseMeta) error

type GitHubForge

+ func (g *GitHubForge) UpdateRelease(ctx context.Context, releaseID string, meta ReleaseMeta) error

type GitLabForge

+ func (g *GitLabForge) UpdateRelease(ctx context.Context, releaseID string, meta ReleaseMeta) error

type GiteaForge

+ func (g *GiteaForge) UpdateRelease(ctx context.Context, releaseID string, meta ReleaseMeta) error

+ type ReleaseMeta struct

+ Description string

+ Name string

+ Type ReleaseType

Aug 19, 2026

Changes in this version

type ReleaseAsset

+ External bool

+ LinkType string

Aug 4, 2026

Changes in this version

+ func KnownProviders() []string

+ func NormalizeTopic(s string) (normalized string, changed bool)

type AzureDevOpsForge

+ func (a *AzureDevOpsForge) DeleteReleaseAsset(ctx context.Context, releaseID, assetID string) error

+ func (a *AzureDevOpsForge) DownloadReleaseAsset(ctx context.Context, asset ReleaseAsset) (io.ReadCloser, error)

+ func (a *AzureDevOpsForge) ListReleaseAssets(ctx context.Context, releaseID string) ([]ReleaseAsset, error)

+ func (a *AzureDevOpsForge) UpdateReleaseNotes(ctx context.Context, releaseID, body string) error

type Forge

+ DeleteReleaseAsset func(ctx context.Context, releaseID, assetID string) error

+ DownloadReleaseAsset func(ctx context.Context, asset ReleaseAsset) (io.ReadCloser, error)

+ ListReleaseAssets func(ctx context.Context, releaseID string) ([]ReleaseAsset, error)

+ UpdateReleaseNotes func(ctx context.Context, releaseID, body string) error

type GitHubForge

+ func (g *GitHubForge) DeleteReleaseAsset(ctx context.Context, releaseID, assetID string) error

+ func (g *GitHubForge) DownloadReleaseAsset(ctx context.Context, asset ReleaseAsset) (io.ReadCloser, error)

+ func (g *GitHubForge) ListReleaseAssets(ctx context.Context, releaseID string) ([]ReleaseAsset, error)

+ func (g *GitHubForge) UpdateReleaseNotes(ctx context.Context, releaseID, body string) error

+ func (g *GitHubForge) UpdateRepoMetadata(ctx context.Context, meta RepoMetadata) (MetadataOutcome, error)

type GitLabForge

+ func (g *GitLabForge) DeleteReleaseAsset(ctx context.Context, releaseID, assetID string) error

+ func (g *GitLabForge) DownloadReleaseAsset(ctx context.Context, asset ReleaseAsset) (io.ReadCloser, error)

+ func (g *GitLabForge) ListReleaseAssets(ctx context.Context, releaseID string) ([]ReleaseAsset, error)

+ func (g *GitLabForge) UpdateReleaseNotes(ctx context.Context, releaseID, body string) error

+ func (g *GitLabForge) UpdateRepoMetadata(ctx context.Context, meta RepoMetadata) (MetadataOutcome, error)

type GiteaForge

+ func (g *GiteaForge) DeleteReleaseAsset(ctx context.Context, releaseID, assetID string) error

+ func (g *GiteaForge) DownloadReleaseAsset(ctx context.Context, asset ReleaseAsset) (io.ReadCloser, error)

+ func (g *GiteaForge) ListReleaseAssets(ctx context.Context, releaseID string) ([]ReleaseAsset, error)

+ func (g *GiteaForge) UpdateReleaseNotes(ctx context.Context, releaseID, body string) error

+ func (g *GiteaForge) UpdateRepoMetadata(ctx context.Context, meta RepoMetadata) (MetadataOutcome, error)

+ type MetadataOutcome struct

+ Set []string

+ Skipped []string

+ Warnings []string

+ type MetadataSetter interface

+ UpdateRepoMetadata func(ctx context.Context, meta RepoMetadata) (MetadataOutcome, error)

+ type ReleaseAsset struct

+ Digest string

+ ID string

+ Name string

+ Size int64

+ URL string

type ReleaseOptions

+ Type ReleaseType

+ type ReleaseType int

+ const ReleaseTypeAuto

+ const ReleaseTypeLatest

+ const ReleaseTypePrerelease

+ func ReleaseTypeFromPrerelease(prerelease bool) ReleaseType

+ type RepoMetadata struct

+ Description string

+ LogoPath string

+ Topics []string

+ Website string

Jul 11, 2026

Changes in this version

type AzureDevOpsForge

+ func (a *AzureDevOpsForge) DeletePackageVersion(ctx context.Context, packageName, version string) error

+ func (a *AzureDevOpsForge) ListPackageVersions(ctx context.Context, packageName string) ([]PackageVersion, error)

+ func (a *AzureDevOpsForge) PublishPackageFile(ctx context.Context, opts PublishPackageOptions) (*PublishedPackage, error)

type Forge

+ DeletePackageVersion func(ctx context.Context, packageName, version string) error

+ ListPackageVersions func(ctx context.Context, packageName string) ([]PackageVersion, error)

+ PublishPackageFile func(ctx context.Context, opts PublishPackageOptions) (*PublishedPackage, error)

type GitHubForge

+ func (g *GitHubForge) DeletePackageVersion(ctx context.Context, packageName, version string) error

+ func (g *GitHubForge) ListPackageVersions(ctx context.Context, packageName string) ([]PackageVersion, error)

+ func (g *GitHubForge) PublishPackageFile(ctx context.Context, opts PublishPackageOptions) (*PublishedPackage, error)

type GitLabForge

+ func (g *GitLabForge) DeletePackageVersion(ctx context.Context, packageName, version string) error

+ func (g *GitLabForge) ListPackageVersions(ctx context.Context, packageName string) ([]PackageVersion, error)

+ func (g *GitLabForge) PublishPackageFile(ctx context.Context, opts PublishPackageOptions) (*PublishedPackage, error)

type GiteaForge

+ func (g *GiteaForge) DeletePackageVersion(ctx context.Context, packageName, version string) error

+ func (g *GiteaForge) ListPackageVersions(ctx context.Context, packageName string) ([]PackageVersion, error)

+ func (g *GiteaForge) PublishPackageFile(ctx context.Context, opts PublishPackageOptions) (*PublishedPackage, error)

+ type PackageVersion struct

+ CreatedAt time.Time

+ ID string

+ Version string

type Provider

+ func ParseProvider(s string) Provider

+ type PublishPackageOptions struct

+ FileName string

+ FilePath string

+ PackageName string

+ Version string

+ type PublishedPackage struct

+ FileName string

+ PackageName string

+ PullURL string

+ Version string

type ReleaseLink

+ DirectAssetPath string

Jun 4, 2026

Changes in this version

+ type AzureDevOpsForge struct

+ BaseURL string

+ Project string

+ Repo string

+ Token string

+ func NewAzureDevOps(baseURL string) *AzureDevOpsForge

+ func (a *AzureDevOpsForge) AddReleaseLink(ctx context.Context, releaseID string, link ReleaseLink) error

+ func (a *AzureDevOpsForge) BranchHeadSHA(ctx context.Context, branch string) (string, error)

+ func (a *AzureDevOpsForge) CancelPipeline(ctx context.Context, pipelineID string) error

+ func (a *AzureDevOpsForge) CommitFile(ctx context.Context, opts CommitFileOptions) error

+ func (a *AzureDevOpsForge) CommitFiles(ctx context.Context, opts CommitFilesOptions) (*CommitResult, error)

+ func (a *AzureDevOpsForge) CreateMR(ctx context.Context, opts MROptions) (*MR, error)

+ func (a *AzureDevOpsForge) CreateRelease(ctx context.Context, opts ReleaseOptions) (*Release, error)

+ func (a *AzureDevOpsForge) CreateTag(ctx context.Context, tagName, ref string) error

+ func (a *AzureDevOpsForge) DefaultBranch(ctx context.Context) (string, error)

+ func (a *AzureDevOpsForge) DeleteRelease(ctx context.Context, tagName string) error

+ func (a *AzureDevOpsForge) DeleteTag(ctx context.Context, tagName string) error

+ func (a *AzureDevOpsForge) DownloadJobArtifact(ctx context.Context, ref, jobName, artifactPath string) ([]byte, error)

+ func (a *AzureDevOpsForge) GetFileContent(ctx context.Context, path, ref string) ([]byte, error)

+ func (a *AzureDevOpsForge) ListReleases(ctx context.Context) ([]ReleaseInfo, error)

+ func (a *AzureDevOpsForge) Provider() Provider

+ func (a *AzureDevOpsForge) UploadAsset(ctx context.Context, releaseID string, asset Asset) error

+ type ForgejoForge struct

+ func NewForgejo(baseURL string) *ForgejoForge

+ func (f *ForgejoForge) Provider() Provider

type Provider

+ const AzureDevOps

+ const Forgejo

type ReleaseInfo

+ Description string

+ Draft bool

+ Name string

+ Prerelease bool

Apr 4, 2026

Changes in this version

+ type BasicFactory struct

+ BaseURL string

+ CredPrefix string

+ ProviderName string

+ func (f *BasicFactory) ForRepo(ctx context.Context, repo string) (Forge, error)

+ type Factory interface

+ ForRepo func(ctx context.Context, repo string) (Forge, error)

type Forge

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

+ GetFileContent func(ctx context.Context, path, ref string) ([]byte, error)

type GitHubForge

+ func (g *GitHubForge) DefaultBranch(ctx context.Context) (string, error)

+ func (g *GitHubForge) GetFileContent(ctx context.Context, path, ref string) ([]byte, error)

type GitLabForge

+ func (g *GitLabForge) DefaultBranch(ctx context.Context) (string, error)

+ func (g *GitLabForge) GetFileContent(ctx context.Context, path, ref string) ([]byte, error)

type GiteaForge

+ func (g *GiteaForge) DefaultBranch(ctx context.Context) (string, error)

+ func (g *GiteaForge) GetFileContent(ctx context.Context, path, ref string) ([]byte, error)

Mar 27, 2026

Changes in this version

type Forge

+ func NewFromAccessory(provider, baseURL, projectID, credPrefix string) (Forge, error)

Mar 16, 2026

Changes in this version

type Forge

+ CreateTag func(ctx context.Context, tagName, ref string) error

+ DeleteTag func(ctx context.Context, tagName string) error

type GitHubForge

+ func (g *GitHubForge) CreateTag(ctx context.Context, tagName, ref string) error

+ func (g *GitHubForge) DeleteTag(ctx context.Context, tagName string) error

type GitLabForge

+ func (g *GitLabForge) CreateTag(ctx context.Context, tagName, ref string) error

+ func (g *GitLabForge) DeleteTag(ctx context.Context, tagName string) error

type GiteaForge

+ func (g *GiteaForge) CreateTag(ctx context.Context, tagName, ref string) error

+ func (g *GiteaForge) DeleteTag(ctx context.Context, tagName string) error

Mar 13, 2026

Changes in this version

+ var ErrBranchMoved = errors.New("target branch moved during commit")

+ var ErrNotSupported = errors.New("operation not supported by this forge")

+ func BaseURL(remoteURL string) string

+ type APIError struct

+ Body string

+ Method string

+ StatusCode int

+ URL string

+ func (e *APIError) Error() string

+ type Asset struct

+ FilePath string

+ MIMEType string

+ Name string

+ type CommitFileOptions struct

+ Branch string

+ Content []byte

+ Message string

+ Path string

+ type CommitFilesOptions struct

+ Branch string

+ ExpectedSHA string

+ Files []FileAction

+ Message string

+ type CommitResult struct

+ SHA string

+ type FileAction struct

+ Content []byte

+ Delete bool

+ Path string

+ type Forge interface

+ AddReleaseLink func(ctx context.Context, releaseID string, link ReleaseLink) error

+ BranchHeadSHA func(ctx context.Context, branch string) (string, error)

+ CancelPipeline func(ctx context.Context, pipelineID string) error

+ CommitFile func(ctx context.Context, opts CommitFileOptions) error

+ CommitFiles func(ctx context.Context, opts CommitFilesOptions) (*CommitResult, error)

+ CreateMR func(ctx context.Context, opts MROptions) (*MR, error)

+ CreateRelease func(ctx context.Context, opts ReleaseOptions) (*Release, error)

+ DeleteRelease func(ctx context.Context, tagName string) error

+ DownloadJobArtifact func(ctx context.Context, ref, jobName, artifactPath string) ([]byte, error)

+ ListReleases func(ctx context.Context) ([]ReleaseInfo, error)

+ Provider func() Provider

+ UploadAsset func(ctx context.Context, releaseID string, asset Asset) error

+ type GitHubForge struct

+ BaseURL string

+ Owner string

+ Repo string

+ Token string

+ func NewGitHub(baseURL string) *GitHubForge

+ func (g *GitHubForge) AddReleaseLink(ctx context.Context, releaseID string, link ReleaseLink) error

+ func (g *GitHubForge) BranchHeadSHA(ctx context.Context, branch string) (string, error)

+ func (g *GitHubForge) CancelPipeline(ctx context.Context, pipelineID string) error

+ func (g *GitHubForge) CommitFile(ctx context.Context, opts CommitFileOptions) error

+ func (g *GitHubForge) CommitFiles(ctx context.Context, opts CommitFilesOptions) (*CommitResult, error)

+ func (g *GitHubForge) CreateMR(ctx context.Context, opts MROptions) (*MR, error)

+ func (g *GitHubForge) CreateRelease(ctx context.Context, opts ReleaseOptions) (*Release, error)

+ func (g *GitHubForge) DeleteRelease(ctx context.Context, tagName string) error

+ func (g *GitHubForge) DownloadJobArtifact(ctx context.Context, ref, jobName, artifactPath string) ([]byte, error)

+ func (g *GitHubForge) ListReleases(ctx context.Context) ([]ReleaseInfo, error)

+ func (g *GitHubForge) Provider() Provider

+ func (g *GitHubForge) UploadAsset(ctx context.Context, releaseID string, asset Asset) error

+ type GitLabForge struct

+ BaseURL string

+ ProjectID string

+ Token string

+ func NewGitLab(baseURL string) *GitLabForge

+ func (g *GitLabForge) AddReleaseLink(ctx context.Context, releaseID string, link ReleaseLink) error

+ func (g *GitLabForge) BranchHeadSHA(ctx context.Context, branch string) (string, error)

+ func (g *GitLabForge) CancelPipeline(ctx context.Context, pipelineID string) error

+ func (g *GitLabForge) CommitFile(ctx context.Context, opts CommitFileOptions) error

+ func (g *GitLabForge) CommitFiles(ctx context.Context, opts CommitFilesOptions) (*CommitResult, error)

+ func (g *GitLabForge) CreateMR(ctx context.Context, opts MROptions) (*MR, error)

+ func (g *GitLabForge) CreateRelease(ctx context.Context, opts ReleaseOptions) (*Release, error)

+ func (g *GitLabForge) DeleteRelease(ctx context.Context, tagName string) error

+ func (g *GitLabForge) DownloadJobArtifact(ctx context.Context, ref, jobName, artifactPath string) ([]byte, error)

+ func (g *GitLabForge) ListReleases(ctx context.Context) ([]ReleaseInfo, error)

+ func (g *GitLabForge) Provider() Provider

+ func (g *GitLabForge) UploadAsset(ctx context.Context, releaseID string, asset Asset) error

+ type GiteaForge struct

+ BaseURL string

+ Owner string

+ Repo string

+ Token string

+ func NewGitea(baseURL string) *GiteaForge

+ func (g *GiteaForge) AddReleaseLink(ctx context.Context, releaseID string, link ReleaseLink) error

+ func (g *GiteaForge) BranchHeadSHA(ctx context.Context, branch string) (string, error)

+ func (g *GiteaForge) CancelPipeline(ctx context.Context, pipelineID string) error

+ func (g *GiteaForge) CommitFile(ctx context.Context, opts CommitFileOptions) error

+ func (g *GiteaForge) CommitFiles(ctx context.Context, opts CommitFilesOptions) (*CommitResult, error)

+ func (g *GiteaForge) CreateMR(ctx context.Context, opts MROptions) (*MR, error)

+ func (g *GiteaForge) CreateRelease(ctx context.Context, opts ReleaseOptions) (*Release, error)

+ func (g *GiteaForge) DeleteRelease(ctx context.Context, tagName string) error

+ func (g *GiteaForge) DownloadJobArtifact(ctx context.Context, ref, jobName, artifactPath string) ([]byte, error)

+ func (g *GiteaForge) ListReleases(ctx context.Context) ([]ReleaseInfo, error)

+ func (g *GiteaForge) Provider() Provider

+ func (g *GiteaForge) UploadAsset(ctx context.Context, releaseID string, asset Asset) error

+ type MR struct

+ ID string

+ URL string

+ type MROptions struct

+ Description string

+ Draft bool

+ SourceBranch string

+ TargetBranch string

+ Title string

+ type Provider string

+ const GitHub

+ const GitLab

+ const Gitea

+ const Unknown

+ func DetectProvider(remoteURL string) Provider

+ type Release struct

+ ID string

+ URL string

+ type ReleaseInfo struct

+ CreatedAt time.Time

+ ID string

+ TagName string

+ type ReleaseLink struct

+ LinkType string

+ Name string

+ URL string

+ type ReleaseOptions struct

+ Description string

+ Draft bool

+ Name string

+ Prerelease bool

+ Ref string

+ TagName string