Mercurial and Xojo
Code and Version Control go together like peanut butter and jelly
Issue: 12.4 (July/August 2014)
Author: Craig Boyd
Author Bio: Craig Boyd is currently an Oracle DBA for a well-known national retailer. But in his 17 years of IT experience, he has been everything from a PC Technician, iSeries System Administrator, iSeries Programmer, Sr. Technical Lead, and Data Modeler. He lives in the great state of Texas with his wife and two kids.
Article Description: No description available.
Article Length (in bytes): 26,548
Starting Page Number: 34
Article Number: 12408
Related Web Link(s):
Excerpt of article text...
Git has received plenty of attention from the Xojo community so I thought I would introduce everyone to my favorite distributed version control software: Mercurial. In this article I will walk you through the basic usage of Mercurial for version control. I won't cover the install process because, frankly, there are plenty of tutorials on that. I will also use the command line for this article because it is universal. (By that I mean that the commands are the same regardless of the platform.) Lastly, I will show you how to clone your project to BitBucket (
http://bitbuckett.org) which is a great place for hosting your source code.
I am using Mercurial 2.7 (the current version is 2.9) and Xojo 2013r4.1. I provide this information as a point of reference only. We will not be doing anything that is specific to these versions.
Both Git and Mercurial are
distributedversion control systems. What this means is that every repository is a complete copy of the source and there is no central repository that acts as the hub. That is not to say that you can't do something like that, but the way Git and Mercurial work, that is not required.
I prefer Mercurial because it is very simple and straightforward. For me the learning curve just to do basic version control was about a day or less.
I have created a simple project that is literally a "Hello World" kind of project. It is a desktop application with a single window and a button that, when clicked, will display a message box. I have not saved the project yet. First let's make sure that we have Mercurial in our path. Go to your OS shell and type "
<enter>. You should get a list of basic commands. If you don't, then Mercurial is either not in your path or not installed at all. Again, I won't go into any OS-specific details. There are plenty of articles already out there showing you how to install Mercurial for your OS platform. To get the specific version of Mercurial you are using, type "
<enter>. That command will return something like the following:
...End of Excerpt. Please purchase the magazine to read the full article.