publish

package
v0.11.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 18, 2026 License: Apache-2.0 Imports: 22 Imported by: 0

Documentation

Overview

Package publish is aicoded publish and aicoded status: it checks a commit of an app, sends it to the platform's delivery pipeline as a git bundle, and reads the outcome. git runs only with constant arguments, and revisions go on its standard input.

Index

Constants

This section is empty.

Variables

View Source
var ErrTimeout = errors.New("the publish has not ended in time")

ErrTimeout is the error of Wait when the publish has not ended in time.

Functions

func Outcome

func Outcome(p platform.Publish) error

Outcome returns the error of a publish whose commit the platform could not read, E-PUB-014, or whose delivery pipeline could not finish, E-PUB-011, and otherwise nil.

func Settle

func Settle(ctx context.Context, c *platform.Client, dir string, p platform.Publish) (string, error)

Settle clears the draft of the app in dir once p, a publish that carried it, has passed, as migrations.Settle does, and returns a line for the builder about the draft, or "". It does nothing while p runs.

func SettlePending

func SettlePending(ctx context.Context, c *platform.Client, dir string) (string, error)

SettlePending settles, as Settle does, the publish that last carried the draft of the app in dir, once it has ended. While that publish runs and the app has a draft, it refuses with E-MIG-001, since a publish now would send the draft a second time. A publish the platform does not know is forgotten. When the platform cannot say, it leaves it for later.

func Wait

func Wait(ctx context.Context, c *platform.Client, id string, every, limit time.Duration, progress io.Writer) (platform.Publish, error)

Wait asks the platform for the publish id every every, until it ends, ctx ends or limit has passed, which is ErrTimeout. It writes each status before the end to progress, and returns the last answer. A request that fails in a way that may pass, such as one with no answer, is made again at the next turn, and the fifth such failure in a row ends the wait.

func WriteText

func WriteText(w io.Writer, p platform.Publish) error

WriteText writes the publish as aicoded publish and aicoded status print it: what was published, each step with its outcome, the problems as aicoded check prints them, each note after "note: ", which checks ran, the change record, the decision on releasing it, an approver's decline, and a last line with the status, which counts the problems of a failed publish.

Types

type CheckError

type CheckError struct {
	Report check.Report
	// contains filtered or unexported fields
}

CheckError is E-PUB-004, with the report of aicoded check, which found problems.

func (*CheckError) Error

func (e *CheckError) Error() string

func (*CheckError) Unwrap

func (e *CheckError) Unwrap() error

type Commit

type Commit struct {
	// Dir is the app's folder, the top level of its git repository.
	Dir     string
	App     string
	SHA     string
	Summary string
	// Migration is the app's draft, .aicoded/migration.sql, which the publish carries, or "".
	Migration string
}

Commit is a commit of an app that Prepare checked.

func Prepare

func Prepare(ctx context.Context, dir string, opts Options) (Commit, error)

Prepare checks the commit HEAD of the app in dir, before any of it leaves the computer: dir holds aicoded.yaml and is the top level of a git repository with a commit (E-PUB-001); git is 2.31 or later (E-PUB-012); neither the commit nor the index holds the draft (E-MIG-001); nothing is left uncommitted but the draft and the cache of the published migrations (E-PUB-002); opts.App, when set, is the app's name (E-PUB-003); and aicoded check --frozen --no-tests finds no problem, with no replace line allowed (E-PUB-004, a *CheckError). The commit carries the draft that aicoded check checked.

type Options

type Options struct {
	// App, when set, must be the name of the app in the folder.
	App string
	// Summary says what changed, for the change record; "" takes the subject of the commit.
	Summary string
}

Options are the choices of a publish.

type Sent

type Sent struct {
	ID  string
	App string
	SHA string
	// CreatedApp is set when the publish created the app, which the builder now owns.
	CreatedApp bool
}

Sent is a publish the platform took.

func Send

func Send(ctx context.Context, c *platform.Client, cm Commit) (Sent, error)

Send sends the commit to the platform's delivery pipeline: the history since the app's base, which it asks the platform for, or all of it, and the draft. An archived app is E-PUB-006, and a commit the app has published already E-PUB-007. When another publish changes the base meanwhile, it asks again and sends once more. The cache of the published migrations then keeps the publish that carried the draft, so that Settle can clear the draft once it passed.

Jump to

Keyboard shortcuts

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