gitforge

A shared Go library providing common abstractions for working with Git hosting platforms (forges). Used by autobump and autoupdate.

Features

• Multi-Provider Support: GitHub, GitLab, and Azure DevOps with a unified interface
• Repository Discovery: Automatically list repositories from organizations/groups
• Pull Request Management: Create PRs/MRs and check for existing ones
• File Operations: Read files, list trees, check file existence via API
• Local Git Operations: Branch, commit, push (SSH/HTTPS) via go-git
• Commit Signing: GPG signing with keyring export and passphrase support
• Changelog Processing: Full Keep-a-Changelog toolkit (version calculation, deduplication, entry insertion)
• Configuration: Token resolution (inline, ${ENV_VAR}, file path), config file discovery
• Registry Pattern: Factory-based provider and discoverer registries

Installation

go get github.com/rios0rios0/gitforge

Architecture

gitforge/
├── domain/
│   ├── entities/         # Core business objects (Repository, PullRequest, etc.)
│   └── repositories/     # Provider interfaces (ForgeProvider, FileAccessProvider, etc.)
├── infrastructure/
│   ├── providers/        # GitHub, GitLab, Azure DevOps implementations
│   ├── git/              # Local git operations (go-git)
│   ├── signing/          # GPG and SSH commit signing
│   ├── config/           # YAML configuration loading
│   └── registry/         # Provider and discoverer registries
└── support/              # Utility functions (file I/O, HTTP, URL manipulation)

Provider Interfaces

The library uses Go interface composition:

• ForgeProvider: Core interface (URL matching, discovery, PR creation, auth)
• FileAccessProvider: Extends with API-based file operations (read, list, tags, branch creation)
• LocalGitAuthProvider: Extends with local go-git authentication (service type, transport, auth methods)

Each concrete provider implements all three interfaces. Consumers type-assert to the level they need.

License

See LICENSE file for details.