Project Description
The IseHg project is an add-on for the Windows PowerShell ISE, that allows you to easily perform basic Mercurial source control functions.

If you are a heavy user of the PowerShell Integrated Scripting Editor (ISE), and frequently perform source control actions, such as adding files, removing files, committing changes, and checking file status, then this module will be of great value to you. Using easy to remember keyboard shortcuts, you can perform these basic functions, and enhance your productivity without leaving the ISE.

There are five Mercurial functions provided in the initial version of the IseHg module. The functions and keyboard shortcuts are included in the table below.

Command Keyboard Shortcut Alternate Keyboard Shortcut Notes
Init CTRL + SHIFT + I ALT + A, M, I Creates a new Mercurial repository in the current working directory.
Add CTRL + SHIFT + A ALT + A, M, A Adds the currently selected file to a Mercurial repository
Remove CTRL + SHIFT + V ALT + A, M, V Removes the currently selected file from a Mercurial repository
Commit CTRL + SHIFT + C ALT + A, M, C Commits changes to the current file to its Mercurial repository
Status CTRL + SHIFT + S ALT + A, M, S Retrieves the status of a file in its repository




Most of the functions in this module do not require input, as they operate on either the current file, or current working directory. The Commit operation does pop up a dialog box that asks for a commit message, however. This dialog can be seen in the screenshot below.


Installation

To install the IseHg module, you should first install the TortoiseHg tools. After doing this, you can download and extract the IseHg module into your PowerShell modules directory. To find an appropriate modules directory, use the $env:PSModulePath environment variable from PowerShell.

Once you have extracted / installed the module to the appropriate directory, you can call Import-Module -Name IseHg; to import the module into your ISE environment. To remove the module, and clean up the add-on menus, run the command: Remove-Module -Name IseHg;

PowerShell 5.0 Preview

If you're using the Windows Management Framework Core 5.0 Preview, you can install the IseHg module from the PowerShellGet module gallery! To do this, simply run:

Install-Module -Name IseHg -Scope CurrentUser;

Cleanliness

This PowerShell module is easy to install or remove, just like any other module. Additionally, when you remove this module from the PowerShell ISE, it will clean up all of its menu items! You don't have to worry about leftover crud in your session, when utilizing IseHg!

Last edited Jun 20, 2014 at 3:47 PM by pcgeek86, version 10