build

package

v0.7.1 Latest Latest Go to latest Published: Oct 6, 2026 License: MIT Imports: 9 Imported by: 0

Details

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

Repository

github.com/gombit-dev/gombit

Links

Open Source Insights

Documentation ¶

Overview ¶

Package build implements `gombit build --embed`: Vite production build, collectstatic into internal/web/static, and `go build` of a single binary that serves API + static + SPA fallback. Split deploy stays the default (C5); embedding is opt-in.

Index ¶

Constants
Variables
func CollectStatic(srcDir, dstDir string) error
func Run(ctx context.Context, opts Options) error
type CommandFunc
type LookPathFunc
type Options

Constants ¶

View Source

const (
	// DefaultOut is the server binary path when --out is omitted.
	DefaultOut = "bin/server"
)

Variables ¶

View Source

var ErrEmbedRequired = errors.New("build: split deploy is the default (C5). Embedding the Vite frontend is opt-in; pass --embed to collectstatic frontend/dist into internal/web/static and compile a single binary that serves API + static + SPA fallback")

ErrEmbedRequired is returned when gombit build is invoked without --embed. Split deploy stays the default (C5).

Functions ¶

func CollectStatic ¶

func CollectStatic(srcDir, dstDir string) error

CollectStatic copies srcDir (frontend/dist) into dstDir (internal/web/static), replacing previous assets but leaving .keep and never touching embed.go.

func Run ¶

func Run(ctx context.Context, opts Options) error

Run performs the embed production build from an application directory.

Types ¶

type CommandFunc ¶

type CommandFunc func(name string, args ...string) *exec.Cmd

CommandFunc starts a subprocess. Tests replace this with short-lived fakes.

type LookPathFunc ¶

type LookPathFunc func(file string) (string, error)

LookPathFunc locates an executable. Tests replace this to simulate npm/go.

type Options ¶

type Options struct {
	WorkDir  string
	Out      string
	Embed    bool
	DryRun   bool
	Stdout   io.Writer
	Stderr   io.Writer
	LookPath LookPathFunc
	Command  CommandFunc
}

Options configures `gombit build --embed`.

Source Files ¶

View all Source files

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