Skip to content

v0.3.0

Choose a tag to compare

@github-actions github-actions released this 26 Oct 18:27
Immutable release. Only release title and notes can be modified.
8282f08

CONGA v0.3.0 replaces ConfigLoader with the Bootstrapper lifecycle hook and adds completion toggles for aliases and descriptions.

🚀 Highlights

  • Bootstrapper lifecycle hook: Bootstrap(ctx, *conga.Bootstrap) runs before config resolution. It can load .env files from flag-derived paths and supply a ConfigDocument that overlays file configuration key by key (#70).
  • Completion toggles: CONGA_COMPLETION_ALIASES and CONGA_COMPLETION_DESCRIPTIONS control whether aliases and descriptions appear, in every shell (#76).

⚠ Breaking Changes & Migration

  • ConfigLoader replaced by Bootstrapper (#70):

    • conga.ConfigLoader, ConfigLoaderFunc, and ConfigContext are removed. Implement Bootstrap(ctx context.Context, b *conga.Bootstrap) error on the root command, build the same ConfigDocument, and pass it to b.SetConfig. b.LookupEnv and b.Path replace ConfigContext.LookupEnv and CommandPath.
    • A ConfigLoader replaced configuration file resolution. SetConfig overlays file configuration key by key instead, so files found through decoders and search paths now load as well.
    // Before
    app.ConfigOptions(conga.ConfigLoader(func(ctx conga.ConfigContext, root *CLI) (*conga.ConfigDocument, error) {
    	return loadDocument(root)
    }))
    
    // After
    func (c *CLI) Bootstrap(ctx context.Context, b *conga.Bootstrap) error {
    	document, err := loadDocument(c)
    	if err != nil {
    		return err
    	}
    
    	b.SetConfig(document)
    
    	return nil
    }

✨ Features

  • completion: Add the CONGA_COMPLETION_ALIASES and CONGA_COMPLETION_DESCRIPTIONS toggles, mark aliases on the wire, and honour the zsh verbose and show-aliases styles (#76). (Renamed after the application in v0.4.0.)

🐛 Bug Fixes

  • completion: Honour the zsh list-separator style in list-colors patterns, so both columns keep their colours (#77).

📚 Documentation

  • website: Reframe the bootstrap docs as domain document loading (#78).

Full Changelog: v0.2.0...v0.3.0

Requirements: Go 1.27+ · Docs · pkg.go.dev