Cleaner API, more comments, generator, toward py3k

Use simpler names for modules variables.
Detailled commets for each functions, with doctests.
Add a generator proxy.
Add a dirty argument parser that do not depend of argparse.
Separate args parser in private functions.
Clean the code.