Update SDK notebooks to include improved authentication ux from planet-client-python#1200

[tbarsballe]

Updates the four SDK notebooks, changing:

if not auth.is_initialized():
    auth.user_login(allow_open_browser=False, allow_tty_prompt=True)

to

auth.ensure_initialized(allow_open_browser=False, allow_tty_prompt=True)

This is a new utility method added in SDK v3.2.0, which is functionally the same as the prior block, except it also checks to see if the refresh token is expired, and performs a new login if it is (this could happen if a user had previously logged in, and then not made any calls to the SDK for a while).

See also: planetlabs/planet-client-python#1200

[matthew-ballard]

I tried this in colab, and it hung. so I interrupted, and it semes to be hung on the sleep.

[/usr/local/lib/python3.12/dist-packages/planet_auth/oidc/api_clients/token_api_client.py](https://localhost:8080/#) in _polling_checked_call(self, token_params, timeout, poll_interval, auth_enricher)
     95             now_time = time.time()
     96             if (now_time - start_time) < timeout:
---> 97                 time.sleep(poll_interval)
     98             else:
     99                 # We expect a expired_token error code, but the caller could

KeyboardInterrupt:

If this "checks to see if the refresh token is expired, and performs a new login if it is" - will that work in a notebook environment?

[tbarsballe]

I tried this in colab, and it hung. so I interrupted, and it semes to be hung on the sleep.

[/usr/local/lib/python3.12/dist-packages/planet_auth/oidc/api_clients/token_api_client.py](https://localhost:8080/#) in _polling_checked_call(self, token_params, timeout, poll_interval, auth_enricher)
     95             now_time = time.time()
     96             if (now_time - start_time) < timeout:
---> 97                 time.sleep(poll_interval)
     98             else:
     99                 # We expect a expired_token error code, but the caller could

KeyboardInterrupt:

If this "checks to see if the refresh token is expired, and performs a new login if it is" - will that work in a notebook environment?

Interesting. I've tested it both as a local notebook, and in Docker, and those worked fine. I'm not sure why collab is having trouble.

[tbarsballe]

@matthew-ballard I just tried it out myself in collab, and the login part worked fine for me. Did you click the auth link and click "Authorize"?

[matthew-ballard]

ah you can disregard, it works. you are right, I just confirmed but did not authorized, I was logged into a temp trial account so I don't usually authorize 😄

[matthew-ballard]

only request would be to change the contributing guide auth snippet

[carl-adams-planet]

LGTM