Now that the library is growing would be interesting having a web page generated with sphinx describing the API. The code could be commented a bit more.