Add Tasks API support to Python Client [sc-66753]

[keith-chartmogul]

This PR adds support for the Tasks API to the SDK.

The spec for this project can be found here.

Customer Additions

chartmogul.Customer.tasks(config, uuid='cus_5915ee5a-babd-406b-b8ce-d207133fb4cb', cursor='aabbcc', per_page=20)
chartmogul.Customer.createTask(config, uuid='cus_5915ee5a-babd-406b-b8ce-d207133fb4cb', data={})

Task Additions

chartmogul.Task.create(config, data={})
chartmogul.Task.all(config, cursor='aabbcc', per_page=20, customer_uuid='cus_5915ee5a-babd-406b-b8ce-d207133fb4cb')
chartmogul.Task.retrieve(config, uuid='5915ee5a-babd-406b-b8ce-d207133fb4cb')
chartmogul.Task.patch(config, uuid='5915ee5a-babd-406b-b8ce-d207133fb4cb')
chartmogul.Task.destroy(config, uuid='5915ee5a-babd-406b-b8ce-d207133fb4cb')

[keith-chartmogul]

I noticed that all of the developer site links were out-of-date, so I updated to the latest ones here.

[keith-chartmogul]

I'm coordinating with Dijana and Koen to make sure that this documentation will be made live soon. If you go to this link now there is currently nothing available.

[keith-chartmogul]

I cannot find a differentiation between Customer Attributes and Custom Attributes in the developer documentation, so I used the same link for both.

[pkopac]

Please bump up minor version, ie. _.x._ https://semver.org

[keith-chartmogul]

Please bump up minor version, ie. _.x._ https://semver.org

I'll bump the version in a separate release PR. 👍

[pkopac]

BTW it's OK to drop support for python versions that are EOL: https://devguide.python.org/versions/
But those still maintained need to be green.

[keith-chartmogul]

BTW it's OK to drop support for python versions that are EOL: https://devguide.python.org/versions/ But those still maintained need to be green.

I'll do that in a separate PR as well. I don't want to mix whatever is required for that with the changes in this PR, but I will be sure to do it before I release a new version of the SDK. 🫡

[briwa]

I'll do that in a separate PR as well. I don't want to mix whatever is required for that with the changes in this PR, but I will be sure to do it before I release a new version of the SDK. 🫡

@keith-chartmogul I guess what Petr meant is that you should drop the versions in this PR because the specs for some of the versions are failing in this PR (example) (cmiiw @pkopac). But strangely enough, the latest versions (3.9 and above) are the ones that are failing, so you might want to look into that in this PR before merging

[briwa]

There's a potential bug from the implementation. Feel free to dismiss this if it's irrelevant

[briwa]

[major] I think this field should have allow_none=True since completed_at can be null. And as usual, you can verify this in the spec -- try passing "completed_at: null" in the taskEntry JSON in the test cases. See this similar issue: #92

[keith-chartmogul]

Good call! I adjusted the resource definition and altered one of the test cases to provide None for the completed_at field when creating a task. Should be all good to go on this part now. 🫡

[pkopac]

If the test suite failures are not related to this PR, coordinate with @swember and one of you fix it in a separate PR, then both rebase. Sounds good? The tests need to be green before merging to ensure SDK stability.

[keith-chartmogul]

If the test suite failures are not related to this PR, coordinate with @swember and one of you fix it in a separate PR, then both rebase. Sounds good? The tests need to be green before merging to ensure SDK stability.

@pkopac Everything's all fixed now. Dmitriy merged a PR that he had opened from late last week and his changes fixed the broken tests, which he was also seeing in his PR. @briwa Could you take a look at my latest changes? 🙏

[briwa]

LGTM

[keith-chartmogul]

@briwa @SoeunSona @pkopac After speaking with Briwa yesterday I decided to bump the version in this PR rather than separate that part out into another PR. It seems pushing an extra commit did not clear the received approvals, so I just wanted to make sure that everyone was aware of the extra bit that I pushed since receiving your approvals. 👍

[qlty-cloud-legacy]

Code Climate has analyzed commit b17ef74 and detected 0 issues on this pull request.

The test coverage on the diff in this pull request is 100.0% (50% is the threshold).

This pull request will bring the total coverage in the repository to 98.5% (0.0% change).

View more on Code Climate.