MNT: Final Annotation

[welli7ngton]

• add annotation to the Application session and '_fix_retina_element' function.

[welli7ngton]

I wonder what would be the right annotation to Backend.WIN_32, and the dict annotation would be enough for the **selectors?

I've used this docs as reference.

[welli7ngton]

I'm not sure if this Box type was a good option.

[joao-voltarelli]

I think it's okay to use it this way, but I can do some tests to validate it.

[joao-voltarelli]

Hi @welli7ngton!

Just a few notes about the type annotations in the "Application" section.

I think that in the annotation for the backend parameter, we can use the Backend class itself. This class is just a string enum with the options that can be used; in this case it will be Backend.WIN_32 (by default) or Backend.UIA.

backend: Backend = Backend.WIN_32

Here are more details:

botcity-framework-core-python/botcity/core/application/utils.py

Line 6 in 8c8c344

class Backend(str, enum.Enum):

---

Regarding the appropriate type for **selectors, since they represent arbitrary named arguments (**kwargs), I think using just 'dict' would not be ideal since, in this case, it would indicate that **selectors are a single dictionary.

Since these parameters refer to element selectors (reference here), they can be of different types (str, int, bool, etc.). So, in this case, an option could use the type notation like: dict[str, Any]. This indicates that each passed selector will be considered a dictionary where the key is a string (selector name), and the value can be of any type.

**connection_selectors: dict[str, Any]

Newer versions of Python seem to have some more efficient ways of doing this type annotation for **kwargs, but I think they are not compatible with older versions of Python. Here are some references I found:

• https://rednafi.com/python/annotate_args_and_kwargs/
• https://peps.python.org/pep-0692/

So at least for now, I think there would be no problem using it in the way I mentioned.

[joao-voltarelli]

@welli7ngton Merging this PR with the last type annotations. Thanks for the contribution!