Difficult to tell if you've failed to connect to a wifi network

[RichardoC]

Describe the bug
I maintain https://github.com/RichardoC/wifi-switcher for connecting to enable a tildagon to connect to multiple wifi networks. Currently, it's difficult to tell whether this worked correctly due to the following 2 pieces of behaviour

1. Wifi.connect(ssid, password) doesn't have any return, so you can't tell if it worked
2. If the tildagon is already connected to a wifi access point, calling wifi.connect(ssid,password) will be ignored, and it will stay connected to the old wifi access point.

I can work around both of these in my app, but I wanted to check whether there was an appetite to change anything in the current wifi module to make this a bit more ergonomic

Version: [v1.10.0]

Thanks!

[futureshape]

@RichardoC as I understand it from the official MicroPython docs and sample code Wifi.connect() is asynchronous, it triggers a background task to attempt to connect to the wifi, and you have to monitor yourself if it’s connected using isconnected() and/or status(). This is all in the standard MicroPython implementation so it’s unlikely to change for this badge.

[RichardoC]

It's difficult to tell which of these are from default micropython, and which are actually part of the badge software. Could there be some annotation in the docs to make it clearer?

[futureshape]

I was partly wrong 😞 there is some wifi wrapper code that's part of the badge firmware.

However this still calls the standard Micropython network.WLAN module behind the scenes, which doesn't return anything as connecting is asynchronous.

As far as I can tell, the only place that lists out all the TildagonOS-specific APIs is here: https://tildagon.badge.emfcamp.org/tildagon-apps/reference/reference/

But it's not 100% complete (for example, it doesn't document the wifi methods even though they're used in some app examples)