Documentation
¶
Index ¶
- Constants
- Variables
- func ChecksumForAsset(checksums []byte, assetName string) (string, error)
- func CrossCompile(opts CrossCompileOpts) error
- func DownloadLatestRelease(arch, destPath string) error
- func DownloadRelease(ver, arch, destPath string) error
- func ExtractFullsendFromTarGz(r io.Reader, destPath string) error
- func FetchReleaseFile(ctx context.Context, ver, name string, maxSize int64) ([]byte, error)
- func FetchSourceTree(version, destDir string) error
- func IsReleasedVersion(v string) bool
- func ModuleRoot() (string, error)
- func ResolveExplicit(path, arch string) error
- func ResolveLatestReleaseTag(ctx context.Context) (string, error)
- func ValidArch(arch string) bool
- func ValidateLinuxBinary(path, arch string) error
- func ValidateSourceRoot(dir string) error
- type AcquireResult
- type CrossCompileOpts
- type Source
- type VendorOpts
- type VendorRoot
Constants ¶
const DefaultArch = "amd64"
DefaultArch is the architecture used for vendored binaries (linux/amd64 GHA runners).
Variables ¶
var ErrReleaseFileNotFound = errors.New("not found")
ErrReleaseFileNotFound is returned by FetchReleaseFile when the release or the asset does not exist.
var HTTPClient = &http.Client{Timeout: 120 * time.Second}
HTTPClient is used for release downloads. Tests may override. Not safe for concurrent test mutation.
var ReleaseBaseURL = "https://github.com/fullsend-ai/fullsend/releases/download"
ReleaseBaseURL is the GitHub releases download base URL. Tests may override. Not safe for concurrent test mutation.
var SourceArchiveBaseURL = "https://github.com/fullsend-ai/fullsend/archive/refs/tags"
SourceArchiveBaseURL is the GitHub source archive base URL. Tests may override.
Functions ¶
func ChecksumForAsset ¶ added in v0.55.0
ChecksumForAsset returns the lowercase hex SHA256 recorded for assetName in the contents of a GoReleaser checksums.txt.
func CrossCompile ¶
func CrossCompile(opts CrossCompileOpts) error
CrossCompile builds a Linux fullsend binary and writes it to DestPath. Requires the Go toolchain and a fullsend module checkout (go env GOMOD).
func DownloadLatestRelease ¶
DownloadLatestRelease resolves the latest release tag from the GitHub API and downloads the Linux binary for the given arch.
func DownloadRelease ¶
DownloadRelease downloads the fullsend binary for linux/{arch} from the GitHub Release matching the given version, verifies its SHA256 checksum against the release checksums.txt, and writes it to destPath.
func ExtractFullsendFromTarGz ¶
ExtractFullsendFromTarGz reads a tar.gz stream and extracts the "fullsend" binary to destPath.
func FetchReleaseFile ¶ added in v0.55.0
FetchReleaseFile downloads the release asset named name from the GitHub Release for ver ("0.4.0" or "v0.4.0") and returns its contents. It fails when the asset is larger than maxSize bytes.
func FetchSourceTree ¶ added in v0.19.0
FetchSourceTree downloads the fullsend source tree for the given release version and extracts it into destDir (module root contents, not wrapped).
func IsReleasedVersion ¶
IsReleasedVersion returns true if version looks like a release tag (e.g. "0.4.0", "v0.4.0") rather than a dev build (e.g. "dev", "0.4.0-3-gabcdef", "0.4.0-vendored").
func ModuleRoot ¶
ModuleRoot returns the fullsend module root directory, or an error if not inside a Go module checkout.
func ResolveExplicit ¶
ResolveExplicit validates that path is a Linux ELF for arch.
func ResolveLatestReleaseTag ¶ added in v0.55.0
ResolveLatestReleaseTag returns the tag of the latest non-prerelease fullsend GitHub Release.
func ValidateLinuxBinary ¶
ValidateLinuxBinary checks that the file at path is a Linux ELF executable for the expected architecture. Returns a descriptive error if the file is missing, not ELF, not Linux, or the wrong architecture.
func ValidateSourceRoot ¶ added in v0.19.0
ValidateSourceRoot checks that dir is a fullsend module checkout.
Types ¶
type AcquireResult ¶
type AcquireResult struct {
TmpDir string // caller must RemoveAll when non-empty
Path string
Source Source
}
AcquireResult holds the path to an acquired binary and metadata for callers.
func ResolveForRun ¶
func ResolveForRun(version, arch string) (AcquireResult, error)
ResolveForRun obtains a Linux binary using the run policy: release download (if released) → cross-compile → latest release.
func ResolveForVendor ¶
func ResolveForVendor(opts VendorOpts) (AcquireResult, error)
ResolveForVendor obtains a Linux binary using the vendoring policy: cross-compile from resolved source root → matching release (released CLI only) → fail.
func ResolveForVendorFromRoot ¶ added in v0.19.0
func ResolveForVendorFromRoot(rootPath, version, arch string) (AcquireResult, error)
ResolveForVendorFromRoot cross-compiles from an already-resolved source tree, falling back to release download when cross-compilation is unavailable.
type CrossCompileOpts ¶
type CrossCompileOpts struct {
Version string // CLI version to embed (before stamp suffix)
Arch string
DestPath string
VersionStamp string // e.g. "-vendored", "-crosscompiled", or ""
SourceDir string // optional module root; defaults to ModuleRoot()
}
CrossCompileOpts configures a cross-compilation build.
type VendorOpts ¶ added in v0.19.0
VendorOpts configures binary resolution for vendoring.
type VendorRoot ¶ added in v0.19.0
type VendorRoot struct {
Path string
Cleanup func()
}
VendorRoot holds a resolved fullsend source tree for vendoring.
func ResolveVendorRoot ¶ added in v0.19.0
func ResolveVendorRoot(sourceDir, version string) (VendorRoot, error)
ResolveVendorRoot resolves a fullsend source tree for vendoring content and cross-compilation. Precedence: explicit sourceDir → ModuleRoot() → GitHub source fetch (released CLI only).