How to create pygtk entry with placeholder like in HTML 5 input element?
You can use PyGobject instead of pygtk, and then setting a placeholder is a piece of cake:
    entry.set_placeholder_text("some string")
Pygtk entry placeholder