Context sensitive auto-completion using PowerShell, PowerTab and GIT

Powertab is an Awesome PowerShell TabExpansion extension. It extends the default PowerShell autocompletion and shows the results like:

The best part is that it is easily customizable.

One way to customize it is by editing it Tab Expansion database file which is located in your powershell profile directory:

TabExpansion.xml

To display some simple git commands in autocompletion all the following entries to it:

<Custom>
  <Filter>git</Filter>
  <Text>status</Text>
  <Type>Custom</Type>
</Custom>
<Custom>
  <Filter>git</Filter>
  <Text>add .</Text>
  <Type>Custom</Type>
</Custom>
<Custom>
  <Filter>git</Filter>
  <Text>pull</Text>
  <Type>Custom</Type>
</Custom>
<Custom>
  <Filter>git</Filter>
  <Text>push</Text>
  <Type>Custom</Type>
</Custom>
<Custom>
  <Filter>git</Filter>
  <Text>commit -m ""</Text>
  <Type>Custom</Type>
</Custom>
<Custom>
  <Filter>git</Filter>
  <Text>commit -a -m ""</Text>
  <Type>Custom</Type>
</Custom>

To invoke this list add the following to TabExpansion.ps1 file which should be in the source directory:

'git(.*)' {
  if(Test-Path .git) {
    $global:dsTabExpansion.Tables['Custom'].select("filter = 'git' AND type = 'Custom'") | % {$_.text} | Invoke-TabItemSelector  -SelectionHandler $SelectionHandler
  }
}

This should be added in the Main tabcompletion block inside the switch statement. The function is basically matching the current command name with git and then invoking autocompletion.

Now when you type git<tab> then the output should look like below:

I am sure this is not the best way to do custom autocompletion but i couldn’t find an easier way.

This is all static stuff. To add dynamic autocompletion (like providing branch names) add following to the TabExpansion.ps1 file:

'git(.*)' {
  if(Test-Path .git) {
    # git checkout
    if($lastBlock -match 'git checkout'){
      git branch | %{ if($_ -match "^\*?\s*(.*)"){ $matches[1] } } | Invoke-TabItemSelector  -SelectionHandler $SelectionHandler
    }
    else{
      $global:dsTabExpansion.Tables['Custom'].select("filter = 'git' AND type = 'Custom'") | % {$_.text} | Invoke-TabItemSelector  -SelectionHandler $SelectionHandler
    }
  }
}

Now when you type git checkout <tab> then it should show the following in the autocomplete list:

This function checks if the user has entered git checkout as the command then it runs the git branch command, parses it and shows the result as autocomplete list.

Here are couple more commands that I wrote while trying this out:

'git(.*)' {
  if(Test-Path .git) {
    # git checkout
    if($lastBlock -match 'git checkout'){
      git branch | %{ if($_ -match "^\*?\s*(.*)"){ $matches[1] } } | Invoke-TabItemSelector  -SelectionHandler $SelectionHandler
    }
    
    # git add
    Elseif($lastBlock -match 'git add'){
      $s = $False ; git status | %{ if($s -eq $True -and $_ -match "^#\s{1,1}(\S.+)$"){ $matches[1] } ElseIf($_ -match 'Untracked files:'){ $s = $True } } | Invoke-TabItemSelector  -SelectionHandler $SelectionHandler
    }
    
    # git rm
    Elseif($lastBlock -match 'git rm'){
      git status | %{ if($_ -match "^#\s+deleted:\s+(\S.+)$"){ $matches[1] } } | Invoke-TabItemSelector  -SelectionHandler $SelectionHandler
    }
    
    else{
      $global:dsTabExpansion.Tables['Custom'].select("filter = 'git' AND type = 'Custom'") | % {$_.text} | Invoke-TabItemSelector  -SelectionHandler $SelectionHandler
    }
  }
}

These will autocomplete parameters for git add and git rm commands by running the git status command and parsing the output.

For example:

I think a lot more interesting stuff can be created using PowerTab and GIT.

Update 1:

Turns out as pointed by MOW that there is a much easier way to add custom expansions instead of editing the TabExpansion.xml file.

Just run this command inside PowerShell:

Invoke-TabExpansionEditor

It will open up a dialog box like:

Here custom items can be added by clicking the Custom link and then the database change can by saved by running the command:

Export-tabExpansionDataBase

Monday, October 13th, 2008 GIT, powershell, ruby, vista, windows

5 Comments to Context sensitive auto-completion using PowerShell, PowerTab and GIT

Great stuff !

a tip, try

Invoke-TabExpansionEditor

and see if you like that better to change the database.

Enjoy,
Greetings /\/\o\/\/

/\/\o\/\/ on October 13th, 2008

PS. another thing I noted

you can use custom additions to Powertab Without editing the source by using ^[tab] behind the filter

e.g.

git^[tab]

you can change this shortcut here :

$PowerTabConfig.ShortcutChars

CustomFunction : #
Invoke : &
Custom : ^
Alias : @
Partial : %
Native : !

Greetings again,
/\/\o\/\/

/\/\o\/\/ on October 13th, 2008

Thanks for the Tips MOW.
I will surely try out Invoke-TabExpansionEditor and update this post.

Yes I noticed that you can add custom auto-completion using the ^ character. But that is one extra character to type. I will look for a cleaner way to add this functionality.

techblogger on October 14th, 2008

Great creative idea. I took your GIT post and did it for Subversion.

http://dougfinke.com/blog/?p=488

Looks like I need to copy you again :)

Doug on October 14th, 2008

@Doug: I will be looking forward to your post again :)

techblogger on October 14th, 2008

Gaurav

All About Everything