The carapace-bin from carapace-sh

waypoint

add completions

artifact.go
artifact_build.go
artifact_list.go
artifact_listBuilds.go
artifact_push.go
authMethod.go
authMethod_delete.go
authMethod_inspect.go
authMethod_list.go
authMethod_set.go
authMethod_set_oidc.go
build.go
config.go
config_get.go
config_set.go
config_sourceGet.go
config_sourceSet.go
config_sync.go
context.go
context_clear.go
context_create.go
context_delete.go
context_inspect.go
context_list.go
context_rename.go
context_set.go
context_use.go
context_verify.go
deploy.go
deployment.go
deployment_deploy.go
deployment_destroy.go
deployment_list.go
destroy.go
docs.go
exec.go
fmt.go
hostname.go
hostname_delete.go
hostname_list.go
hostname_register.go
init.go
install.go
login.go
logs.go
project.go
project_apply.go
project_inspect.go
project_list.go
release.go
release_list.go
root.go
runner.go
runner_agent.go
runner_profile.go
runner_profile_inspect.go
runner_profile_list.go
runner_profile_set.go
server.go
server_bootstrap.go
server_configSet.go
server_install.go
server_restore.go
server_run.go
server_snapshot.go
server_uninstall.go
server_upgrade.go
status.go
ui.go
up.go
user.go
user_inspect.go
user_invite.go
user_modify.go
user_token.go
version.go
workspace.go
workspace_inspect.go
workspace_list.go

performance tweaks

with increasing amount of completers might need to use yaegi to only initialize the needed command (assuming all init methods are called on invokation - need to check this)

performance: only run init() for relevant completer

fish: erased functions still get autoloaded

completions need to be invoked once before they can be replaced so that they are not autoloaded:

complete --do-complete 'chown ' > /dev/null
complete --erase -c 'chown'
complete -c 'chown' -f -a '(_carapace_lazy chown)'

needs: fish-shell/fish-shell#6716

pprof

https://medium.com/@lightcone/how-to-profile-go-programs-c6c00e8f2ebf
https://flaviocopes.com/golang-profiling/

use an environment variable (e.g. CARAPACE_PROFILEDIR) so that multiple can be creating during actual use

related #136

kubectl

Basic Commands (Beginner):

Basic Commands (Intermediate):

explain Documentation of resources
get Display one or many resources
edit Edit a resource on the server
delete Delete resources by filenames, stdin, resources and names, or by resources and label selector

Deploy Commands:

rollout Manage the rollout of a resource
- history View rollout history
- pause Mark the provided resource as paused
- restart Restart a resource
- resume Resume a paused resource
- status Show the status of the rollout
- undo Undo a previous rollout
scale Set a new size for a Deployment, ReplicaSet or Replication Controller
autoscale Auto-scale a Deployment, ReplicaSet, or ReplicationController

Cluster Management Commands:

Troubleshooting and Debugging Commands:

Advanced Commands:

diff Diff live version against would-be applied version
apply Apply a configuration to a resource by filename or stdin
patch Update field(s) of a resource using strategic merge patch
replace Replace a resource by filename or stdin
wait Experimental: Wait for a specific condition on one or many resources.
convert Convert config files between different API versions
kustomize Build a kustomization target from a directory or a remote url.

Settings Commands:

label Update the labels on a resource
annotate Update the annotations on a resource
completion Output shell completion code for the specified shell (bash or zsh)

Other Commands:

add Standalone() invocation to all commands

to suppress default complete command

git

git root command

Main Porcelain Commands

Ancillary Commands / Manipulators

Ancillary Commands / Interrogators

Interacting with Others

Low-level Commands / Manipulators

Low-level Commands / Interrogators

Low-level Commands / Syncing Repositories

daemon A really simple server for Git repositories
fetch-pack Receive missing objects from another repository
http-backend Server side implementation of Git over HTTP
send-pack Push objects over Git protocol to another repository
update-server-info Update auxiliary info file to help dumb servers

Low-level Commands / Internal Helpers

External commands

clang-format

git: support `-C`

work on different folders

see https://rsteube.github.io/carapace/carapace/action/chDir.html

faas-cli

needs some tests as some completions are probably not correct

platform is likely to be wrong
namespace shoud be considered in actions

kubectl cleanup

#236

completions need to use namespace/file/host from current invokation if changed from default
do some tests

maven

completion caching (like gradle)
plugin goals from parent pom
plugins not configured in root xml (pluginmanagement, profiles, ..?)
different repository location than default (environment variable, settings)

chown: fails to complete group

chown --from games:<TAB>

bash - fails: won't complete second part
fish - ok
elvish - ok
powershell - ok
zsh - fails

 (eval):1: parse error near `$(carapace chown zsh...'
_arguments:453: command not found:  eval $(carapace chown zsh '_chown##from' hown --from games

carascrape

add some command similar to caraparse to scrape go commands (like kubectl)

crude code used to prepare kubetl for caraparse parsing:

func scrape(cmd *cobra.Command) {
	if cmd.Hidden {
		return
	}

    text := make([]string, 0)

	text = append(text,  fmt.Sprint(uid.Command(cmd)))
	text = append(text,  fmt.Sprint(cmd.Name()))
	text = append(text,  fmt.Sprint(cmd.Short))
	cmd.LocalFlags().VisitAll(func(f *pflag.Flag) {
		val := ""
		if f.Value.Type() != "bool" {
			val = "VAL"
		}

        usage := strings.Split(f.Usage, "\n")[0]
        if len(usage) > 100 {
            usage = usage[:100]
        }

		if f.Shorthand == "" {
			text = append(text,  fmt.Sprintf("--%v %v  %v", f.Name, val, usage))
		} else {
			text = append(text,  fmt.Sprintf("-%v, --%v %v  %v", f.Shorthand, f.Name, val, usage))
		}
	})
    _ = ioutil.WriteFile("out/" + uid.Command(cmd) + ".txt", []byte(strings.Join(text, "\n")), 0644)

	for _, subcmd := range cmd.Commands() {
		scrape(subcmd)
	}
}

Configure descriptions format

First of all let me say I am totally amazed by carapace. I discovered it thanks to your PR cli/cli#2728 and was blown away when I discovered what it can do.

One minor thing I'd like to ask/request is how to change the format used for the descriptions?

In my ZSH setup using the standard completion source (e.g. for gh) the descriptions are separated by --, which I like.

After loading carapace (source <(carapace gh zsh)) the descriptions change to this format (using parentheses)

If possible I'd like to keep my existing description format so that it stays uniform across different commands.

Here's my zshrc for reference: https://github.com/disrupted/dotfiles/blob/4957c485b2b7bf2a73af9393bf8d599fd6afbfec/.zshrc

ssh

finalize ssh completer

bindings
options
host definitions

go:generate

use go:generate to create cmd/completers.go and completers/*/main.go

update asciicast

update readme with new asciicast that does not use docker-compose

rg: add missing completions

add missing completions to rg (ripgrep)

background service where carapace runs in background and provides completion over socket communication.
will set CARAPACE_SOCKET=/somefile environment variable and if this exists (assume a server is running) generate the lazy loaded completion scripts with callback snippet that invokes nc instead of the carapace binary.

This should improve performance.

GODEBUG=inittrace=1 go run . 2>&1 | grep 'init github.com/rsteube/carapace-bin/comp
leters' | awk '{print $5" "$6" "$2}' | sort -r

# 5.9 ms github.com/rsteube/carapace-bin/completers/kubectl_completer/cmd
# 2.6 ms github.com/rsteube/carapace-bin/completers/git_completer/cmd
# 2.4 ms github.com/rsteube/carapace-bin/completers/docker_completer/cmd
# 1.0 ms github.com/rsteube/carapace-bin/completers/cargo_completer/cmd
# 0.55 ms github.com/rsteube/carapace-bin/completers/vlc_completer/cmd
# 0.53 ms github.com/rsteube/carapace-bin/completers/tar_completer/cmd
# 0.43 ms github.com/rsteube/carapace-bin/completers/adb_completer/cmd
# 0.39 ms github.com/rsteube/carapace-bin/completers/nmcli_completer/cmd

related #136

repeatable flags
environment variables
use http config changes in actions
test and fix completions

repo host not parsed in every command (completion should skip first element)
caching (labels)
test and fix completions

remote package completion
local package completion
project dependency completion
reuse commands/completion from pub

aws: support binary release

related aws/aws-cli#6344

add gorelease config

set binary name to carapace
add caraparse as secondary build

carapace-sh / carapace-bin Goto Github PK

carapace-bin's Introduction

carapace-bin

Getting Started

carapace-bin's People

Contributors

Stargazers

Watchers

Forkers

carapace-bin's Issues

Recommend Projects

Recommend Topics

Recommend Org

Jobs