Documentation
¶
Index ¶
- Variables
- func Completion(shell string, w io.Writer) error
- func EnsureHarness(reqs []require.Requirement, flowPath ...string) (string, error)
- func ExecHarness(bin string, args []string) int
- func Print(w interface{ ... })
- func PrintCommandHelp(w io.Writer, command string) bool
- func PrintTopHelp(w io.Writer)
- func Run(args []string) int
- func RunEmbedded(ctx context.Context, source string, args []string) int
- func RunEmbeddedWithBundles(ctx context.Context, source string, args []string, bundles []core.Bundle) int
- func RunPath(ctx context.Context, args []string) int
- func RunWithBundles(args []string, bundles []core.Bundle) int
- func SelfBuild(ctx context.Context) error
- func SourceRequires(path string) ([]require.Requirement, error)
- type LintIssue
- type Step
- type StepLogger
Constants ¶
This section is empty.
Variables ¶
var ( Version = "dev" Commit = unknownValue BuiltAt = unknownValue )
var ErrCompletionEmpty = errors.New("completion: nothing to complete")
ErrCompletionEmpty is reserved for future dynamic completions that may return nothing. Kept for API stability.
var SupportedShells = []string{"bash", "zsh", "pwsh", "powershell"}
SupportedShells lists the shells for which completion scripts exist.
Functions ¶
func Completion ¶
Completion writes a completion script for the named shell to w.
func EnsureHarness ¶
func EnsureHarness(reqs []require.Requirement, flowPath ...string) (string, error)
EnsureHarness builds or reuses a runner binary linked with exactly the external modules declared by reqs.
func ExecHarness ¶
func PrintTopHelp ¶
func RunEmbeddedWithBundles ¶
func SelfBuild ¶
SelfBuild rebuilds the running nexssflow binary in place, injecting VCS metadata from the source directory. It replaces the manual `go install` step for developers who want consistent version output.
func SourceRequires ¶
func SourceRequires(path string) ([]require.Requirement, error)
Types ¶
type LintIssue ¶
type LintIssue struct {
File string `json:"file"`
Line int `json:"line,omitempty"`
Kind string `json:"kind"`
Message string `json:"message"`
}
LintIssue is one problem found in a .nflow source. The shape is stable — the CLI prints it as JSON so tooling and editors can consume it. File is always a real path (never a synthetic label).
type Step ¶
type Step struct {
// contains filtered or unexported fields
}
Step is one in-flight build step. Exactly one terminal method should be called; further calls are ignored.
type StepLogger ¶
type StepLogger struct {
// contains filtered or unexported fields
}
StepLogger prints numbered build steps. In an interactive terminal it animates a spinner while a step is running. When stdout is redirected to a file or a pipe, the spinner is disabled so CI logs stay clean.
func NewStepLogger ¶
func NewStepLogger(w io.Writer, total int) *StepLogger
NewStepLogger returns a logger that will print at most total steps.
func (*StepLogger) Start ¶
func (l *StepLogger) Start(label, detail string) *Step
Start begins a step. In a TTY it launches the spinner goroutine.
Source Files
¶
Directories
¶
| Path | Synopsis |
|---|---|
|
Package selftest runs the Nexss Flow self-test suite: a feature-by- feature check of every registered bundle, run in-process against the binary's own compiler and runtime.
|
Package selftest runs the Nexss Flow self-test suite: a feature-by- feature check of every registered bundle, run in-process against the binary's own compiler and runtime. |