Getting started with Mercurial: A tutorial

The concluding part of this series will be the installation and typical usage of Tortoise Mercurial, a user friendly GUI front-end for Mercurial. It is commonly referred to as TortoiseHg (the chemical symbol for mercury).

This will be a fairly simple tutorial to follow as each description is followed by a screenshot. These screenshots were taken on Windows XP, but they will be pretty similar in other OSes

Download Tortoise mercurial from the Bitbucket site. There are installables for Windows as well as for Linux. Installation on Windows is fairly straightforward as it is wizard-based.

1. Create a new folder for keeping your art assets. This will be your project folder. In this screenshot (click for a larger image), I have created a project folder for the purpose of composing this series of blog posts. Simply right-click, and select ‘Create Repository here’ under the TortoiseHg sub-menu:

   

2. The defaults in the ‘Create Repository’ dialogs are fine. Just click Create.

   

3. The new repository has been created. That was easy, wasn’t it?

   

4. Now, enter the project folder and view the changes. On some OSes, you might see nothing here. These files are not intended to be seen or modified, hence they might be hidden. You can safely ignore them.

   

5. This is a screenshot of a new file that I am editing (using Emacs editor) inside the project folder. I am ready to check-in this file.

   

6. Now, you will need to add this new file to your repository. Let’s skip that and directly perform a commit. We will be later given a chance to add this file.

   

7. Here you can see our newly added file as unchecked. This means that this file is not yet under version control

   

8. Go ahead and mark the check box next to this file

   

9. In the edit box above, you can add a short comment about this commit. Since this is the initial commit, my comment is simply ‘First Commit’

   

10. Mercurial acknowledges the successful commit with the name(s) of the committed files

    

11. Notice that your file has a green tick icon indicating a successful check-in

    

12. Many hours and many check-ins later, my post is nearly close to completion. I commit this version as well.

    

13. In the commit dialog, notice the Repository Explorer in the menu.

    

14. You can view the history of changes in reverse chronological order. You can right click on any of them to compare the changes or revert back to an earlier version.

    

15. Simply clicking on each version will show the diff (in UNIX format) between the consecutive versions in the lower right window.

    

16. You can perform a revert by selecting the Revert option.

    

17. As indicated by the warning, your current file will be overwritten to an older version. But subsequently you can revert to the latest version as well, so this is not too much of an issue.

    

That’s pretty much all you need to know to use Tortoise Hg. Hope you found this series informative!

Without sounding too cliched, let me say that some of the best things in life are not expensive. Here are some of the best things you can buy for less than Rs. 8K (around $160):

Wifi Router

This is a blessing for those with frequently off working hours calls or if you have multiple laptops. The convenience of being able to work near the balcony enjoying the quiet scenery and sipping tea is divine.

Small Water Heater

This is a pet peeve of mine. Hot water is absolutely essential for a bath. Even in summer. Yep. Nothing gives you a better satisfaction that a hot bath after a warm day. And in Mangalore it’s either raining in buckets or it’s hot and humid. I would recommend that you go for a 8l one if you want a good tradeoff between heating time and power consumption.

Portable Harddisk

I am sure most of us have tried using CDs for backing up all those wonderful photos and songs we have. The problem is – CD are not really great for organising data. It is readonly and once you burn it, there is no way to go back and change it. There are, of course, other problems like limited space and suceptibility to scratches.

Harddisk prices have gone down… a lot. So there is really no excuse for not getting one. There are sub-terrabyte ones at throwaway prices. I recommend the Western Digital’s handy Passport 500 GB.

Ebooks

Can anyone guess what’s the most heaviest thing to transport? Yep, it is undoubtedly books. The weight of a carton of books can exceed that of a TV, Microwave or even a carton full of iron boxes. I think everyone who love books would have had to part with them if they have had to travel a lot. They would have given away most of it to friends or relatives, never to see them back again.

This is sad. I don’t like giving away books. Neither do I want to kill my desire to create a personal library. I suggest an eco-friendly compromise – make a digital library. Do invest in Ebooks and Audio books. I have invested heavily in a collection that I am sure I can use anywhere once ebook readers become more cheaper. For now, I don’t mind reading them on my laptop. And yes, my library weighs less than a kilo ;)

Gamepad

I am a guy who is always tempted to buy game consoles. I have made up my mind a hundred times to buy a playstation or a nintendo, only to find that the latest PC is much better at it. And you know what PCs are always ahead in terms of sheer processing power. Except that they have clumsy input devices. Ever tried to play a racing game with a keyboard? Then you will know what I am talking about.

This is easily fixable. A USB gamepad (which looks like a PS2 Gamepad) comes in for less than Rs. 500. It is a great value for money. It has all the 4 way controls, shoulder buttons and 2 joysticks. Plus it has a built-in vibrator (no batteries needed)! I am planning to go for a second one. Now you can safely give your PC to your 5-year old cousin to play Mario Kart without fearing that he with smash your keyboard to bits shouting ‘Maaario’:)

Decent Mattress

Some one rightly said that we spend one-thirds of our life on a mattress. So why not in a really good one? There are cots in the market all the way from Rs 200 to branded mattresses worth several tens of thousands. Go for a really good branded mattress. It might cost a couple of grand, but you will not lose sleep over it ;)

Portable Home-kit

A briefcase sized kit that contains a small drill, spanners, measuring tape, pipe wrench, screwdriver set etc costs less that Rs. 2000 these days. I think it is well worth the price.

Those were, in my opinion, the best little things that don’t cost you a fortune. What are the ones you feel give you great value for money? Do add in your comments.

The talk was about creating a simple casual game using Pyglet called ‘FruitCatch’. The source code is really small and very readable. I also compared Pyglet with Pygame and why I prefer Pyglet (in certain situations:)). The demo showed the working game in the end.

You can download the game source code and presentation slides (PDF) here. I’ve shared this with the organisers as well, so it will be put up at the http://in.pycon.org/ site as well

UPDATE: The video of the lightning talk is now available and has been added below:

I’m 01100110 01100101 01100101 01101100 01101001 01101110 01100111 00100000 01101100 01110101 01100011 01101011 01111001 00001010

I will explain in this post how to crack this simple code with the help of some Python one-liners (Google’s favourite language). If you are a Google aspirant (who isn’t? ;) ), this might help you clear the interview. So pay attention.

To most people it is immediately obvious that it is a text encoded in binary. Since each binary word is 8 characters long, it is most probably written in the extended 8-bit ASCII code. In fact, it is and you can read this with a simple ASCII chart.

But they have made it slightly difficult for you by writing in binary. Since most charts would provide you a lookup from decimal or hexadecimal numbers to ASCII representations only. So how do you convert from binary to decimal? It’s quite simple:

decimal = lambda s: sum(int(j) * pow(2,i) for i,j in enumerate(reversed(s)))

This line defines a function decimal which works in a manner similar to how we would manually convert binary numbers into decimal. Each position is multiplied by increasing powers of two from the right. Then, these numbers are added together. for e.g. ‘1010′ will be 1 * 8 + 0 * 4 + 1 * 2 + 0 * 1 = 10.

Next, we split the binary part of the tweet string and apply the decimal function on each part

tweet = "01100110 01100101 01100101 01101100 01101001 01101110 01100111 00100000 01101100 01110101 01100011 01101011 01111001 00001010"
print ''.join(chr(decimal(s)) for s in tweet.split())

The result is something that you might have already guessed seeing the first 2 words:

“I’m feeling lucky\n”

Hope you learnt some interesting python constructs. If there are other ways of decoding this in Python, please comment below.

1. There will be more demand in Indian IT companies for PHP skills similar to Perl scripting skills these days :mrgreen:
2. There will be soon be a viable competitor to the immensely popular Wordpress blogging platform from the Python/Ruby world

I have nothing against Wordpress. In fact, it is one of the easiest tools to deploy. But with tools like cPanel, deployment could be no longer a deciding factor for blogging platforms.

Coming back to the topic of Python Web Frameworks, there is a multitude of options. I have used some of these framworks and found them to be ‘pythonic’ in different ways:

• Django Well documented. Tightly Coupled and ‘Batteries Included’
• Pylons Extremely flexibility to Plug and Play components. ‘Fun to Hack’
• web.py Great for beginners. Entire framework ‘fits in your head’

Pylons looks most appealing to me. So far it looks like the underdog largely overshadowed by Django’s presence lacking the marketing or love it deserves. A few weeks back I would have complained about the lack of Pylons tutorials on the web. A google search brought up several links pointing to the wiki tutorial. As many have pointed out, the wiki tutorial is too long and complicated for beginners. It would easily put off a beginner. It took me quite some time to realise that the best place to start learning Pylons is the Pylons Documentation itself and the best Pylons tutorial is the Flickr Search. Going through the documentation is almost feels like reading a book with every concept explained in detail.

Pylons currently seems to the having an edge over Django for enterprise application due to its well tested interface with SQLAlchemy. Django seems to be having a fairly recent branch for SQLAlchemy integration. Pylons typically uses Python eggs and VirtualEnv for deployment which is might seem a little complex to beginners, but once you try it once it is actually quite convenient. Most of the installation can be done from the command-line and it will be nearly an independent sandbox for Pylons development. However it might take sometime to understand other aspects of using python eggs such as uninstallation and creation of new eggs. I haven’t had much success with making a portable version of my Pylons installation on Windows though :(

My favourite templating engine is Genshi because it is very designer friendly(which also means it works with the tools a Designer has, not just that it is easy for a Designer to learn). I can easily do all HTML designing directly on my Genshi templates because they are valid HTML or XML documents. Almost all of Genshi’s logic can be hidden away as attributes which is a great idea. In fact, the templates are even valid XML which makes the creation of valid HTML pages a much more natural experience. Almost all XML tools and even HTML tools like Tidy will work flawlessly on Genshi templates due to these reasons.

Once you get used to Genshi’s templates, you might even use them for static web site designing. I am sure it will save you a lot of time whenever those last minute ’sidebar redesigns for every page’ pops up.

I have 5 simple yet useful tips below, which I have tested with a GNU Emacs 23.0.0.1 (i386-mingw-nt5.1.2600) running on Windows XP.

Tip 1: Starting off With a Prettier Emacs

Most of us customize the fonts, colours and window position of Emacs. In fact, I have found that dark backgrounds are much suited to Emacs than the default light background. However, when Emacs starts up, it annoyingly shows the default fonts and colours first. As your .emacs files load, it jumps around and changes colours quite noticeably.

You can avoid this annoyance by making a simple registry modification. Create a new .reg file say set-frame-and-fonts.reg and copy paste the following lines. Open the file to add the changes to the registry. Restart Emacs and enjoy the difference!

REGEDIT4
[HKEY_CURRENT_USER\SOFTWARE\GNU\Emacs]
"Emacs.Foreground"="black"
"Emacs.Background"="#f5f5f5"
"Emacs.Font"="-outline-Consolas-normal-r-normal-normal-12-90-96-96-c-*-iso8859-1"
"Emacs.Geometry"="100x35+0+0"

Caveat: The lines above are my preferred colours, fonts and window positions. Your’s could be different. Please customize to your taste.

Tip #2: Add “Open In Emacs” option to all Files

This will be indispensable once you are more used to Emacs. You will feel like opening anything and everything with it. And being the one true swiss-army-chainsaw it is, you will be delighted at the enormous no: of filetypes that Emacs supports out of the box.

This .reg file add an “Open in Emacs” option in Windows Explorer when you right click on any file. Copy the following lines to a .reg file say Add-Emacs-To-Open-Any-File.reg and open it to add the changes to the registry. Make sure that you have modified the path below to point to your emacs installation path (mine is in D: drive). The emacsclientw.exe resides in the same place where your runemacs.exe resides (right-clicking on the emacs icon, generally shows you this).

Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\*\Shell\Open In Emacs\Command]
@="\"D:\\Program Files\\Emacs23\\bin\\emacsclientw.exe\" -a \"D:\\Program Files\\Emacs23\\bin\\runemacs.exe\" \"%1\""

Tip #3: Goodbye Capslock

If you use Emacs a lot, you will find that you have to use the Ctrl key a lot. You might find your left thumb getting strained after prolonged use. The easiest solution for this is to reassign a less used key as the Ctrl key. Most people choose the Caps Lock key for this purpose. It is surprisingly not that much useful and soon you will forget that such a key ever existed.

Whenever I searched, I found that most people swap the Ctrl and Caps Lock keys. However, this is irritating as I might still want to use the old Ctrl key if I press it accidentally. Here is how to replace Caps Lock with the Ctrl Key.

Copy the following lines to a .reg file say replace_caps.reg and open it to add the changes to the registry. Now just reboot and you are done!

REGEDIT4

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Keyboard Layout]
"Scancode Map"=hex:00,00,00,00,00,00,00,00,02,00,00,00,1d,00,3a,00,00,00,00,00

Yes, it takes some time to “unlearn” and “learn” the new key position, but trust me it’s worth the effort.

Tip #4: Use a Spell Checker

A spell checker is something I feel should be a part of any editor. Here is how to enable on the fly spell checking in Emacs.

1. Install aspell
2. Add the following lines to your .emacs file (adjust the path to aspell accordingly)

Elisp:

;; aspell is the spell checker that works for me
(setq-default ispell-program-name "D:\\Arun\\Home\\bin\\aspell.exe")
(setq text-mode-hook '(lambda()
                         (flyspell-mode t)       ; spellchek (sic) on the fly
                         ))

Tip #5: Setup a Postscript Printer

By default, you can pretty-print all your documents directly from emacs. But this requires configuring a postscript printer. There is a nice package called Ghostscript which takes care of doing this.

1. Download and install Ghostscript from here say at D:\gs

2. Download and install GSView from here say at D:\gs\gsview

3. Then add the following lines to your .emacs file:

Elisp:

(if (string= system-name "CORPLAPTP65") ; Works in office only
    (progn
      ;;  Windows printer
      (setq-default ps-lpr-command (expand-file-name "/gs/gsview/gsprint.exe"))
      (setq-default ps-printer-name t)
      (setq-default ps-printer-name-option nil)
      (setq ps-lpr-switches '("-query")) ; show printer dialog
      (setq ps-right-header '("/pagenumberstring load" ps-time-stamp-mon-dd-yyyy))))

Caveat: Be sure to switch to a light background color scheme before you print, else your fonts will be so light that they won’t be readable!

Decaffeination

Her heavily mascaraed eyes flicked towards me across the cubicle barrier. I made a futile attempt to pretend that I didn’t notice it. Her blank glance meant only one thing – ‘Aren’t you ready, yet?’ A meeting reminder has suddenly started flashing wildly on my computer screen. Just then somebody just slammed shut a printer tray diagonally behind me. Also the distinct soft thuds of a stilettos striding on the wooden floor again far behind me sounds like war drums. The typically inaudible chatter hundreds of fingers frantically tapping computer keys and depressing mouse buttons have suddenly become unbearably loud. A mixed feeling of sickness and growing anger is brewing in my tummy. I realize I have suddenly become perfectly still.

She stands up from her seat in one slow lazy motion. Her usual aloof expression almost certainly didn’t convey intelligence as she presumed. Rather it smacks of snobbishness. This time I don’t make a futile pretence of ignoring her, on the contrary I decide to acknowledge it. To further affirm my stubbornness in this matter, my chin dips slightly lower down my chest and my eyes dart across its breadth of my computer screen like a skilled Bharatanatyam dancer. The 12 page report I need just a mouse click away. Yet, my hand is still waving the mouse like silly as if waiting for a cue. Then suddenly I got my cue.

“We have the weekly meeting now, right?”

“Hmm…. Oh, right. Just a minute, Sonia”

She tries one of her sly smiles which rather disappear in the flashes of her red glossy lips “Can you take the printouts? I’m too lazy to hunt for it”

Damn you why me? – I wonder. “Sure, no problem”

You can call it the worst part of the day for a meeting or anything for that matter. At quarter past two just after lunch. Not that a BurgerKing bean burger meal is a particularly sumptuous or satisfying lunch. It just had to weigh down in my belly enough to trigger a mid-afternoon sleep. Not that this drowsy state would affect my performance in this meeting in any manner. In fact, sleep walking would be an ideal strategy to tackle the 15 odd weekly report meetings that I have these days. An impassive reading of the itemized colour coded action points, some vague summary of the tasks performed and a quiet nod to each speaker is all that is needed. No insights, no lateral thinking and god forbid no technical jargon. Paradoxically, being in charge of an IT project the last thing anyone would like to mention in such meetings is anything technical. The ‘tech’ stuff is usually so low level that isn’t worth mentioning. It is at end of the chain, the operational level. It’s not that you would be scoffed at or even rebuked for talking ‘tech’. But it would be quite apparent that it is slipping through the tunnels between everyone’s ears. More importantly it would be a career suicide for an IT consultant like me.

We never needed so many meetings. Originally there was just ONE. It was appropriately on a Wednesday morning. Everyone would promptly appear and we would kick off by reading out the consolidated 4 page report. But then Middle East project became our responsibility and they still wanted the same deadlines. We threw our hands up saying we simply didn’t have enough flack. It was true. Most of us Indians put in around 12 hours a day. We had drawn out things so tight that we would barely make it to the Haloween release. A certain German manager in fact didn’t quite appreciate this. Almost callously he claimed that we were underutilized. Like we were donkeys pulling a chariot when we could have actually galloped like horses. So he felt the best thing would be to track everything. From the code reviews to the lunch breaks. Every single bit of it. Perhaps it made him feel that he finally had the whip. Nonetheless, things were actually not improving in any manner.

The report heavy with graphs slowly loads up on my screen. I’m just a key press away from printing it. I pickup up my dark hardbound notebook in one hand and my extra strong, extra sweetened cup of tea in the other. I will badly need the latter in the next one hour. In fact I’ll actually need 3 such cups. But for now – this will do. This one was freshly brewed a minute ago. A minute ago when I punched the code 53 on the machine for the eight time today. When a Styrofoam cup popped down from within and the machine started whirring loudly. The tiny nozzles above the cup started spurting some liquids and steam in a premeditated sequence. They built up a foam which made delicious noises as it rose to the brim. Without even looking I picked up the cup timed to perfection as the last drop dripped down to the cup. One minute later, I look at the cup now, the foam is still intact. Perfecto, I murmured.

Then I catapult from my seat and press the print button and dash towards the printer. As the pages spew into the tray, my notebook appears like an enormous chainsaw and I’m mentally sawing down one big tree after another. I collect 24 pages of single sided print on bond quality paper for stapling. My stapler makes a vacant click reminding me that it was devoid of pins since last week. Without even thinking twice I pick up the nearest stapler and the deed is done.

All the while Sonia was waiting armed with her spiral bound notebook, office supplied pen and the bloody same aloof expression. She had worn her usual black jumper and black trousers. As popular wisdom goes Black can be quite flattering for women wishing to look slim. Honestly, it hardly helped much on her 150 pound frame. I gave a tiny smile indicating that I’m ready. That smile got amplified, sugar coated, mixed with a hint of a yawn and flashed back to me in bright red lips. I tried to mildly joke something about the recently proliferation of reports. She chortled in her usually highly pitched tone, which almost startled me in mid motion.

“Would anybody from CHIRP apps join us?” she mouthed in her heavily south Brit accent.

“I suppose not. Neither Jennifer or Kiran accepted the meeting request. I guess they have no outstanding tasks this week.”

“Hmmm, I suppose they don’t. But we can still dial them up from the conference room”

I didn’t quite hear her last sentence. I guess her 3 inch heels rhythmically pounding the carpeted floor was drowning it. A short tuft of hair over her forehead kept vibrating in rhythm. Her exaggerated movement came to an abrupt stop. I reached out and punched the lift button.

She kept watching impatiently at the LED display of the lift. I looked though the bright window at the end of the alley. It was a warm day in London today and a perfect time to be outdoors. I could see a group of young identically dressed balle dancers by the streets walking to the nearby park. Some were leaping and spinning with graceful ease. Further across, little chubby English children played hopscotch or sat on seesaws in the park. A pale thin young woman was sitting against a short cherry tree and was half amused by her over enthusiastic chestnut coloured Doberman. Her cheerful face couldn’t hide her longing, but right now, the sun and her life looked bright.

The lift opened with a ring. As the doors slid open, a tall slender formally dressed black Brit rushed out. He was momentarily confused which way to turn. He chose right and decided to run. Sonia stepped in almost immediately. I dragged myself in. She lifted her manicured fingers all the way up to button 14. Thanks to the extra 3 inches she didn’t have to try too hard.

‘Kapil, going home for Diwali?’

I could almost feel the nausea now. ‘No’, I replied.

‘Hmm… why?’, she enquired

In a low voice I replied, ‘Not that many leaves left actually’

‘Bummer. Don’t worry, we can celebrate it over here this time.’

I looked at her face hoping she was joking. Hell, she wasn’t! After all it isn’t quite surprising actually. She looked unmistakable like any other Punjabi girl. Except perhaps for her bobbed silky looking hair dyed in psychedelic colours. Except perhaps for her near perfect south Brit accent. Except for her childhood, which perhaps had fleeting trips to Punjab once in a year, which would now be more of a repulsive memory of a poverty stricken country.

Of course she wasn’t an Indian. She wouldn’t know what it is like to be home at Diwali. More importantly she wouldn’t know what it is like not to be home at Diwali. An ignoramus. A cross cultural freak. A word that’s stripped of its etymology. Pathetic!

I tried to smile. She smiled back, this time more meaningfully. Did she actually peek into the mind of Kapil Sharma for a moment? I cannot say. Perhaps she did. Perhaps she did look a bit pretty now. She had wide telling eyes. I had forgotten.

The lift pulled itself to a halt. As I stepped outside I heard a familiar voice to my left. It was my project manager, Hari. Meticulously dressed in a cream pinstripe shirt and black blazer, he was slowly pacing about the walkway. To a casual observer, he could be seen as loudly talking and gesturing to an invisible person, almost like a lunatic. But, a thin wire dangling in front of him is the sole proof of his sanity. He must be speaking via his hands-free to his offshore project manager over a teleconference. His voice is barely audible but one can sense that things are not quite happy there.

As I walked the wire seemed more like a leash around Hari’s neck. The mobile he held in one hand seemed to have firmly held its other end. It seemed to have slowly tightened its grip on Hari, till his thickly mustached lips moved and muttered something out of sheer compulsion. He never saw me. I turned and realized Sonia was already entering the meeting room.

I entered the tiny room with a circular table and few plush plastic chairs. I handed over Sonia’s copy of the report to her. I placed my black notebook and tea on the mahogany table just next to her. I opened my notebook and leaved through the notes of all my earlier meetings. I found a blank page and scribbled down the date at the upper left corner. As I’m about to write, I’m now aware of a familiar feeling in me. I’m still wondering – which meeting is this?