posh-tabcomplete 0.1.0

Blazing fast tab completion for powershell.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

# posh-tabcomplete


Blazing fast tab completion for powershell.

Features:
* Fast startup and execution using `nu-engine`
* Extendable using `.nu` files, with built in support for commmon tasks like `git` and `npm run`

By default, [completions.nu](./resource/completions.nu) is used. An alternative `.nu` file can be specified in the `TABCOMPLETE_FILE` environment variable.

## Installation


### Step 1. Install


| Repository      | Instructions                             |
| --------------- | ---------------------------------------  |
| **[crates.io]** | `cargo install posh-tabcomplete --locked`|


### Step 2. Setup powershell

```pwsh
Invoke-Expression (&tabcomplete init | Get-Content)
```

[crates.io]: https://crates.io/crates/starship

## Built in completions

* [git completions](https://github.com/nushell/nu_scripts/blob/main/custom-completions/git/git-completions.nu). These are also combined with [git auto generated completions](https://github.com/nushell/nu_scripts/blob/main/custom-completions/auto-generate/completions/git.nu)
* [npm completions](https://github.com/nushell/nu_scripts/blob/main/custom-completions/npm/npm-completions.nu)
* [cargo completions](https://github.com/nushell/nu_scripts/blob/main/custom-completions/cargo/cargo-completions.nu)

## Benchmarks


Benchmark | Results
----------|-----------
`benchmark/init` - startup time | tabcomplete: 102ms, posh-git: 432ms (4.24x faster)
`benchmark/complete` - tab completion (100 branches) | tabcomplete: 71ms, posh-git: 172ms (2.42x faster)

## Aliases / Function support

Functions are supported. For example, this would add completion for `gco `, as if it was `git checkout `:
```pwsh
function gco() { git checkout $args }
```

There is no support for alias completions at this time.