proposed backslash-python API

Here is what I thought the backslash-python API should look like.

Where there is TODO: it's a discussion I have with you/myself about the correct way to go

NOTHING is set in stone. Don't hesitate to change the whole thing if you think it is needed.
(Where there is Yotam - it's because the original version was Yotam's - feel free to handle it as well :))


I would like to avoid adding a separate method to each new query we add. Let's stick to a simple 'get_all', receiving a possible set of query parameters, and have a separate 'advanced' version which will return the same iterator interface, but receive the actual query to perform as a parameter...

If we later on discover some extremely useful shortcuts, then we can formalize them into a separate API.