GlobusApp login, logout, and login_required

[derek-globus]

Closes #1036

Added

• Added login(...), logout(...), and login_required(...) to the
  experimental GlobusApp construct.

  • login(...) initiates a login flow if:

    • the current entity requires a login to satisfy local scope requirements or
    • auth_params/force=True is passed to the method.

  • logout(...) remove and revokes the current entity's app-associated tokens.

  • login_required(...) returns a boolean indicating whether the app believes
    a login is required to satisfy local scope requirements.

Removed

• Made run_login_flow private in the experimental GlobusApp construct.
  Usage sites should be replaced with either app.login() or
  app.login(force=True).

  • Old Usage

    ```python
    app = UserApp("my-app", client_id="<my-client-id>")
    app.run_login_flow()
    ```
    

  • New Usage

    ```python
    app = UserApp("my-app", client_id="<my-client-id>")
    app.login(force=True)
    ```
    

---

📚 Documentation preview 📚: https://globus-sdk-python--1041.org.readthedocs.build/en/1041/

[derek-globus]

Potentially worth calling this out in the changelog as well. Wasn't sure whether it rose to that level

[derek-globus]

I'd love to link out to another doc here expanding on what can be passed but the two candidates I looked at were:

• SDK Docs on GAREs which don't enumerate the list of valid options.
• Auth API Docs on Authorize Code Grant which includes additional items beyond those that go strictly into a GAREData object.

[ada-globus]

Suggested change

	* `auth_params` are provided
	* `force` is set to True
	* `self.login_required()` evaluates to True
	* ``auth_params`` are provided,
	* ``force`` is set to True, or
	* ``self.login_required()`` evaluates to True.

[ada-globus]

Looks like part of this change is missing? I can check others, but might be a little bit before I can swing back through.

[derek-globus]

Oh my mistake. I didn't see the list-form part of the suggestion here, just the "``" to replace "`" enveloping.

I can update to that style as well.

[derek-globus]

Updated in latest rev.

[derek-globus]

Rebased from main to resolve these changes against #1040

[ada-globus]

🙌