{"id":15814,"date":"2018-08-13T08:29:21","date_gmt":"2018-08-13T15:29:21","guid":{"rendered":"https:\/\/www.sapien.com\/blog\/?p=15814"},"modified":"2018-08-13T08:29:21","modified_gmt":"2018-08-13T15:29:21","slug":"customizing-git-commands","status":"publish","type":"post","link":"https:\/\/dev.sapien.com\/blog\/2018\/08\/13\/customizing-git-commands\/","title":{"rendered":"Customizing Git Commands"},"content":{"rendered":"

We recently added Git support to PrimalScript and, subsequently, to PowerShell Studio. You can read about it here<\/a>.<\/p>\n

As promised in the previous post, I will tell you a little bit more about how this works, how you can customize it, and what we have planned for it in the future.<\/p>\n

The MS SCC API (Microsoft Source Code Control API) has become old and not very broadly supported, and even Microsoft does not seem to be interested in updating or expanding the interface. However, virtually all source code control systems support a command line interface, so we here at SAPIEN decided to use only command line tools for our new source control interface\u2014Universal Version Control System.<\/p>\n

PrimalScript detects a source code control system through the presence of a configuration file. I will use Git as the example throughout this article, but this information easily applies to any command line driven system. The same mechanisms that apply to PrimalScript also apply to PowerShell Studio.<\/p>\n

Take a peek at the following folder after you have installed the latest version of PrimalScript or PowerShell Studio: C:\\ProgramData\\SAPIEN\\Version Control Providers<\/p>\n

\"image\"<\/a><\/p>\n

The file ‘Git.inf’ is what tells PrimalScript that there is a Source Control Provider named ‘Git’.<\/p>\n

\"image\"<\/a><\/p>\n

Let\u2019s examine the ‘Git.inf’ file to see how things work.<\/p>\n

\"image\"<\/a><\/p>\n

The \u2018Detect\u2019 section is what tells PrimalScript about the system. The presence of a ‘Folder’ named \u2018.git\u2019 indicates that the commands herein apply to any file in a folder containing such a subfolder. \u2018System\u2019 indicates the path to a file that can be used to detect if the system is installed. If you installed Git in a different location than the default, you will need to edit the path.\u00a0‘Name’ is the display name.<\/p>\n

\"image\"<\/a><\/p>\n

The \u2018Commands\u2019 section lists all available commands for this particular Source Control System. For each command listed here, there must be a corresponding section in the file containing its data. We will use the \u2018Add\u2019 command as an example.<\/p>\n

Before we get to that, let’s take a brief look at the icons used in the user interface. The folder containing ‘Git.inf’ also contains a \u2018Git Images\u2019 folder. Its name is derived from the system, so \u2018Git.inf\u2019 implies there is a \u2018Git Images\u2019 folder.<\/p>\n

\"image\"<\/a><\/p>\n

The name of each command listed corresponds to a png file in the ‘Git Images’ folder. These are the images used in PrimalScript\u2019s user interface.<\/p>\n

\"image\"<\/a><\/p>\n

If you do not like a particular icon we chose, you can easily substitute your own.<\/p>\n

Now back to the commands.<\/p>\n

\"image\"<\/a><\/p>\n

As the name implies, the \u2018Add\u2019 command adds a file to the repository for that current folder. We have received some feedback that users would like to enter their own initial command rather than us just hard-wiring \u2018Initial commit\u2019, so I will show you how to do that.<\/p>\n

Each command can have any number of command line instructions which are executed in order, and PrimalScript will wait for each command to complete before executing the next one.
\nFor the \u2019Add\u2019 command we have two command line instructions:<\/p>\n

git add %FILE%
\ngit commit -m “Initial commit” %FILE%<\/span><\/p>\n

Anything in this file bracketed by % characters is considered a macro. The only macro resolved by PrimalScript at this time is %FILE%. It will resolve into the full path of the currently active editor file. Any other macro will be resolved by prompting the user.<\/p>\n

Let\u2019s take a look at the \u2018Commit\u2019 command, which already prompts the user for a comment.<\/p>\n

\"image\"<\/a><\/p>\n

You see a macro %MESSAGE% here. PrimalScript has no idea what that is, so it looks for a value in the inf file \u201cMESSAGE=\u201d and uses the corresponding text to prompt for a value.<\/p>\n

<\/p>\n

You can apply that same mechanism to the \u2018Add\u2019 command.<\/p>\n

\"image\"<\/a><\/p>\n

Save ‘Git.inf’ and restart PrimalScript. The inf file is loaded on startup, so any changes made to it will require an application restart.<\/p>\n

After saving the inf file and restarting PrimalScript, when you add a file to Git you will be prompted for an initial comment.<\/p>\n

\"image\"<\/a><\/p>\n

There is currently one caveat\u2014please make sure to make a backup of any modifications you make to the inf file. Since this is under development and subject to change without notice, any time you install an update the inf file will be overwritten and replaced with the standard version.<\/p>\n

In the future, we will provide a mechanism for \u2018User\u2019 versus \u2018System\u2019 files. For now, you should assume that any changes made will be erased by an update and will need to be reapplied.<\/p>\n

We have quite a number of features and improvements planned. We love to hear from you, so feel free to provide additional feedback or suggestions in the feedback section of our forum<\/a>.<\/p>\n

 <\/p>\n","protected":false},"excerpt":{"rendered":"

We recently added Git support to PrimalScript and, subsequently, to PowerShell Studio. You can read about it here. As promised in the previous post, I will tell you a little bit more about how this works, how you can customize it, and what we have planned for it in the future. The MS SCC API […]<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[703,410,21],"tags":[786,1016,37,321],"class_list":["post-15814","post","type-post","status-publish","format-standard","hentry","category-powershell-studio","category-primalscript-software-news","category-software-news","tag-git","tag-powershell-studio","tag-primalscript","tag-version-control"],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/15814","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/comments?post=15814"}],"version-history":[{"count":15,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/15814\/revisions"}],"predecessor-version":[{"id":15830,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/15814\/revisions\/15830"}],"wp:attachment":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/media?parent=15814"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/categories?post=15814"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/tags?post=15814"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}