GH1033 Add overloads of engine for pd.read_json

[loicdiridollou]

• Closes Added new argument engine to read_json() to support parsing JSON with pyarrow by specifying engine="pyarrow" #1033
• Tests added: Please use assert_type() to assert the type of any return value

[loicdiridollou]

For engine="pyarrow", you are forced to pass lines=True and you can not pass a StringIO buffer, it has to be a file path or a ReadBuffer[bytes].

[Dr-Irv]

I'm a little concerned about the misuse of ellipses with default arguments. Ellipses should only be used in an argument when the argument is optional. When you want a specific result to happen as a result of the argument being specified, you don't use ellipses. The overloads that require values to be specified (i.e., the ones without ellipses) should come before the ones that use ellipses. And the ones with ellipses should have "broad" types. So writing something like engine: Literal["pyarrow"] = ... can't be correct, because the default value of engine is ujson, so if the stub is to work without specification of that parameter it would be engine: Literal["ujson", "pyarrow"] = ... .

[Dr-Irv]

Almost there

[Dr-Irv]

thanks @loicdiridollou