feat: Add mobile endpoint for Web Atoms

[dpgraham]

Implements an endpoint mobile: webAtoms which calls the Espresso web atoms API. The call provides JSON that provides an optional webView element, and then list of atoms to execute.

e.g.)

{
      webviewElement: webviewEl.value,
      forceJavascriptEnabled: true,
      methodChain: [
        {name: 'withElement', atom: {name: 'findElement', locator: {using: 'ID', value: 'i_am_a_textbox'}}},
        {name: 'perform', atom: {name: 'webKeys', args: 'Hello world'}},
        {name: 'withElement', atom: {name: 'findElement', locator: {using: 'ID', value: 'i am a link'}}},
        {name: 'perform', atom: 'webClick'},
      ]
    }

calls...

onWebView(theWebView)
  .forceJavascriptEnabled(true)
  .withElement(findElement(Locator.ID, "i_am_a_textbox"))
  .perform(webKeys("Hello world))
  .withElement(findElement(Locator.ID, "i am a link"))
  .perform(webClick())

Also added KReflectionUtils which implements reflection using Kotlin.

[jlipps]

why expose this as a mobile command? i thought the idea was that we would switch context into the webview, and from then on all commands would ultimately generate atoms internally, but the user wouldn't know that as it's just an implementation detail?

[dpgraham]

@jlipps this is a stopgap. I wanted to add this capability to see if there's interest in it. Also because the other option would require a lot more effort and I would like this available in the meantime.

[mykola-mokhnach]

does kotlin allow to use switch?

[dpgraham]

In this case, I can't use switch because I couldn't find anything for the JsonPrimitive that returns the type. I had to go check the types individually.

[mykola-mokhnach]

Kotlin, actually has when operator, which might be in use here. Check https://superkotlin.com/kotlin-when-statement/

[mykola-mokhnach]

I would expect to see some docstring here especially about opts JSON format

[dpgraham]

I'll add it to the mobile documents section in appium.io

[mykola-mokhnach]

do we have any required fields in opts?

[dpgraham]

Just methodChain.... I'll add that.

[mykola-mokhnach]

I like the tests

[mykola-mokhnach]

Would you mind to also add a link containing a list of available atoms?

[dpgraham]

Done

[mykola-mokhnach]

there is also ?: operator ;)

[mykola-mokhnach]

!is is also valid