compfile

README

🌳 Go Bonzai™ File Completer

Provides the regular shell completion most expect for files and directories with the trailing slash added to directories for quick visualization. Nothing special beyond that (colors, emojis, etc.)

Style Guidelines

• Everything through go fmt or equiv, no exceptions
• In Vim set textwidth=72 (not 80 to line numbers fit)
• Use /* */ for package documentation comment, // elsewhere
• Smallest possible names for given scope while still clear
• Favor additional packages (possibly in internal) over long names
• Package globals that will be used a lot can be single capital
• Must be good reason to use more than 4 character pkg name
• Avoid unnecessary comments
• Use "deciduous tree" emoji 🌳 to mark Bonzai stuff

Legal

Copyright 2022 Robert S. Muhlestein (mailto:rob@rwx.gg) SPDX-License-Identifier: Apache-2.0

"Bonzai" and "bonzai" are legal trademarks of Robert S. Muhlestein but can be used freely to refer to the Bonzai™ project https://github.com/rwxrob/bonzai without limitation. To avoid potential developer confusion, intentionally using these trademarks to refer to other projects --- free or proprietary --- is prohibited.

Changelog

• Expand ~ to user's home directory
• Complete relative paths ./ and ../

z rm ../
../cowsay/     ../.git/       ../go.mod      ../isosec/     ../main.go
../README.md ../getrc/      ../.gitignore  ../go.sum      ../LICENSE
../nullptr/    ../sl/

• Re-implement entriesWithSlash and isDir functions, previously re-used from rwxrob/fs library. This library logs out errors to stderr (instead of returning them) and thus ruins the UX.

z rm ~/Druntime error: index out of range [0] with length 0

• Support for completing multiple arguments. The last argument is the one which gets completed, instead of limiting it to args[0].

z rm cowsay/cowsay.go isosec/
isosec/isosec.go  isosec/parse.go

Documentation

Overview

Package compfile is a completion driver for Bonzai command trees and fulfills the bonzai.Completer. See Complete method for details.

Index

• func New() *comp

Functions

func New

func New() *comp

New returns a pointer to a struct that fulfills bonzai.Completer. This can be called from within Z.Cmd assignment:

var Cmd = &Z.Cmd{
  Name: `some`,
  Comp: compfile.New(),
}