Project

General

Profile

Actions

Bug #20294

open

`async` argument of `create` methods is difficult to use in SDKs

Added by Brett Smith about 1 year ago. Updated about 1 year ago.

Status:
New
Priority:
Normal
Assigned To:
-
Category:
API
Target version:
Story points:
-

Description

Specifically in the Python SDK, async is a reserved keyword. You have to put the argument in a dictionary and apply it with **kwargs.

I'm guessing Python is not the only language affected by this issue. It may be harder to work around in other languages too.

We should give the argument a new canonical name and support async for backwards compatibility.

Actions #1

Updated by Peter Amstutz about 1 year ago

We should double check if 'async' even does anything.

At one point we had made some operations optionally 'async' because they took too long but eventually we ended up fixing the performance so the async flag was no longer necessary, but I think we kept the parameter to avoid breaking anything that was using it.

Actions

Also available in: Atom PDF