P4V Custom Tools

This project contains some example custom tools for P4V plus a simple installer to make it easier for users to install.

They are currently written in Powershell to make it easier to use in Corporate systems - there is normally no need to install anything to make things run.

The ideas are applicable to tools written in other languages (although deployment of the runtime environment needs to be thought about).

Tools

Open in Swarm

This is a simple script which is on the right click menu for when files or folders are selected. It opens that file or folder in Swarm for the relevant server.

It does this by reading the property P4.Swarm.URL and creating the appropriate URL starting with that prefix.

Dependencies

• Powershell - typically 4.0+
• p4.exe in path
• default browser is the right one to use for Swarm

Installation

This provides automatic installer to make life easier for users.

Installer.ps1

This is the main installer and is written to be fairly generic.

On Windows you can run it by right-clicking > Run with powershell.

It uses the script Install-P4VTools.ps1 to do the actual work.

Install-P4VTools.ps1

This copies the tool(s) to the appropriate local directory and then customizes the P4V settings file. (This is c:\users\<username>\.p4qt\customtools.xml). It will only add the tool once - if run again it will not change anything. It should not break any existing custom tools.

Can be customised easily, e.g. editing the following to install in a different directory. $HOME expands to c:\users\<username> by default

$installpath = "$HOME\P4V_TOOLS"

Can be customized for other tools too.