|
|
|
@ -99,6 +99,31 @@ the name. In fact, I think we have our new theme song.
|
|
|
|
|
Method directly from one matching the Method function signature in a
|
|
|
|
|
callable, high-level library.
|
|
|
|
|
|
|
|
|
|
* **Only bash completion planned.** Zsh, Powershell, and Fish have no
|
|
|
|
|
equivalent to `complete -C` (which allows any executable to provide
|
|
|
|
|
its own completion) This forces inferior dependencies on overly verbose
|
|
|
|
|
external "completer" scripts written in only those languages for
|
|
|
|
|
those specific shells. This dependency completely negates any
|
|
|
|
|
possibility of providing modular completers and composable commands
|
|
|
|
|
that carry their own completion logic. This one objective fact alone
|
|
|
|
|
should give every pause before opting to use one of these inferior
|
|
|
|
|
shells for their command line interactions. Bonzai commands leverage
|
|
|
|
|
this best-of-breed completion functionality of bash to provide an
|
|
|
|
|
unlimited number of completion methods and combinations. The
|
|
|
|
|
equivalent implementations, perhaps as an export collected from all
|
|
|
|
|
composed commands providing their shell equivalent of completion
|
|
|
|
|
scripts, would be preposterously large (even though `kubectl` requires
|
|
|
|
|
12637 lines of bash just for its basic completion). Bonzai uses Go
|
|
|
|
|
itself to manage that completion --- drawing on a rich collection of
|
|
|
|
|
completers included in the standard Bonzai module --- and provides
|
|
|
|
|
documented shortcut aliases when completion is not available (h|help,
|
|
|
|
|
for example).
|
|
|
|
|
|
|
|
|
|
* **Bonzai commands may default to `cmd.Shell` or `cmd.Help`** These
|
|
|
|
|
provide help information and optional interactive assistance
|
|
|
|
|
including tab completion in runtime environments that do not have
|
|
|
|
|
`complete -C foo foo` enabled.
|
|
|
|
|
|
|
|
|
|
## Acknowledgements
|
|
|
|
|
|
|
|
|
|
The <https://twitch.tv/rwxrob> community has been constantly involved
|
|
|
|
@ -113,7 +138,7 @@ 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 cmdbox project
|
|
|
|
|
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.
|
|
|
|
|