Inaccurate type comment in functions for azure-cosmos package

[sl-sandy]

• Package Name: azure-cosmos
• Package Version: 4.0.0
• Operating System: win10
• Python Version: 3.8

Describe the bug
For the query related functions in container.py which has the optional "parameters", all theses functions comment the parameters with type Optional[List[str]]. This leads to code highlit and warning in IDE.

To Reproduce
Steps to reproduce the behavior:

container.query_items(

    query='SELECT * FROM products p WHERE p.productModel = @model',

        parameters=[

            dict(name='@model', value='Model 7')

        ],

    enable_cross_partition_query=True

)

When using this demo code, IDE will give a warning on the type of "parameters".

Expected behavior
Change the type comment of "parameters" of query functions to Optional[List[dict]].

[kaerm]

sl-sandy thanks for reporting this, adding Steve Faulkner (@southpolesteve) and Anna Tisch (@annatisch) to take a look at this

[adeolemon]

sl-sandy which IDE were you using?

[sl-sandy]

@notlaforge My IDE is the Pycharm community. I tried version 2019.3 and 2020.1 and both can reproduce this.