api feedback

[iloveitaly]

love todoist, but the API bindings need some love:

• no example code, at least with any complexity
• changelog was really basic for such a massive change
• get_projects() returns an iterator, but it only has a single iteration. This is odd. You should just iterate through the first batch list and then pull from the network when you need to
• docs should be linked on the GH homepage url and the broken docs/ folder content should be removed. Also there are broken links in the readme.
• Seems to assume UTC dates but doesn't make that clear. You would expect if you send over a datetime.now() with the computer TZ it would include all activity up to datetime

[goncalossilva]

Hey @iloveitaly, thanks for the feedback!

get_projects() returns an iterator, but it only has a single iteration. This is odd. You should just iterate through the first batch list and then pull from the network when you need to

This is only true if you have just a handful of projects. If you have more than 20 (IIRC?), there will be multiple pages.

docs should be linked on the GH homepage url and the broken docs/ folder content should be removed. Also there are broken links in the readme.

They are. Do you mean something else?

Seems to assume UTC dates but doesn't make that clear. You would expect if you send over a datetime.now() with the computer TZ it would include all activity up to datetime

How can we make that clearer?