Merge pull request #867 from globus/release-3.29.0

Release v3.29.0

docs/changelog.rst

@@ -12,6 +12,44 @@ to a major new version of the SDK.
 
 .. scriv-insert-here
 
+.. _changelog-3.29.0:
+
+v3.29.0 (2023-10-12)
+--------------------
+
+Changed
+~~~~~~~
+
+- The inheritance structure used for Globus Auth client classes has changed.
+  (:pr:`849`)
+
+  - A new class, ``AuthLoginClient``, is the base for ``NativeAppAuthClient``
+    and ``ConfidentialAppAuthClient``. These classes no longer inherit from
+    ``AuthClient``, and therefore no longer inherit certain methods which would
+    never succeed if called.
+
+  - ``AuthClient`` is now the only class which provides functionality
+    for accessing Globus Auth APIs.
+
+  - ``AuthClient`` no longer includes methods for OAuth 2 login flows which
+    would only be valid to call on ``AuthLoginClient`` subclasses.
+
+Deprecated
+~~~~~~~~~~
+
+- Several features of Auth client classes are now deprecated. (:pr:`849`)
+
+  - Setting ``AuthClient.client_id`` or accessing it as an attribute
+    is deprecated and will emit a warning.
+
+  - ``ConfidentialAppAuthClient.get_identities`` has been preserved as a valid
+    call, but will emit a warning. Users wishing to access this API via client
+    credentials should prefer to get an access token using a client credential
+    callout, and then use that token to call ``AuthClient.get_identities()``.
+
+- The ``AuthClient.oauth2_userinfo`` method has been deprecated in favor of
+  ``AuthClient.userinfo``. Callers should prefer the new method name. (:pr:`865`)
+
 .. _changelog-3.28.0:
 
 v3.28.0 (2023-08-30)

src/globus_sdk/version.py

@@ -1,3 +1,3 @@
 # single source of truth for package version,
 # see https://packaging.python.org/en/latest/single_source_version/
-__version__ = "3.28.0"
+__version__ = "3.29.0"