Added docstrings and minor clean ups.

* Removed unused import for ``urlparse``;
* Added docstrings and/or docstring 'stubs' for all classes and methods.
* Added some documentation.
* Switched string interpolation to use ``<string>.format()`` instead.
Merge pull request #1 from omaciel/first-cleanup

Added docstrings and minor clean ups.
Improves documentation