yujunjun/datahub
2
0
Fork 0
mirror of https://github.com/datahub-project/datahub.git synced 2025-12-06 07:34:37 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(datahub-lite): small improvement for zsh tab completion (#7085)

Browse Source
This commit is contained in:
Shirshanka Das 2023-01-19 09:04:44 -08:00 committed by GitHub
parent 8323128437
commit d6f3feb2d7
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 5 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
docs/datahub_lite.md
View File

@ -545,9 +545,9 @@ DataHub Lite is a very new project. Do not use it for production use-cases. The
### Tab Completion ### Tab Completion
Using the datahub lite commands like `ls` or `get` is much more pleasant when you have tab completion enabled on your shell. Tab completion is supported on the command line through the [Click Shell completion](https://click.palletsprojects.com/en/8.1.x/shell-completion/) module. Using the datahub lite commands like `ls` or `get` is much more pleasant when you have tab completion enabled on your shell. Tab completion is supported on the command line through the [Click Shell completion](https://click.palletsprojects.com/en/8.1.x/shell-completion/) module.
To set up shell completion for your shell, follow the instructions below: To set up shell completion for your shell, follow the instructions below based on your shell variant:
#### Option 1 (inline eval) #### Option 1: Inline eval (easy, less performant)
<Tabs> <Tabs>
<TabItem value="zsh" label="Zsh" default> <TabItem value="zsh" label="Zsh" default>
@ -570,7 +570,7 @@ eval "$(_DATAHUB_COMPLETE=bash_source datahub)"
</Tabs> </Tabs>
#### Option 2 (external completion script) #### Option 2: External completion script (recommended, better performance)
Using eval means that the command is invoked and evaluated every time a shell is started, which can delay shell responsiveness. To speed it up, write the generated script to a file, then source that. Using eval means that the command is invoked and evaluated every time a shell is started, which can delay shell responsiveness. To speed it up, write the generated script to a file, then source that.
@ -580,7 +580,8 @@ Using eval means that the command is invoked and evaluated every time a shell is
Save the script somewhere. Save the script somewhere.
```shell ```shell
_DATAHUB_COMPLETE=zsh_source datahub > ~/.datahub-complete.zsh # the additional sed patches completion to be path oriented and not add spaces between each completed token
_DATAHUB_COMPLETE=zsh_source datahub | sed 's;compadd;compadd -S /;' > ~/.datahub-complete.zsh
``` ```
Source the file in ~/.zshrc. Source the file in ~/.zshrc.