Carl/sdk integration work button up (#3)

* WIP

* enhance version command

* skip user prompts with a CLI options.

* docs

* JWT util command

* linting

* add discovery to the command line util

* hide unimplemented commands

Author: carl-adams-planet

src/planet_auth/auth_client.py

@@ -450,6 +450,26 @@ def userinfo_from_access_token(self, access_token: str) -> dict:
             message="User information lookup is not implemented for the current authentication mechanism"
         )
 
+    def oidc_discovery(self) -> dict:
+        """
+        Query the authorization server's OIDC discovery endpoint for server information.
+        Returns:
+            Returns the OIDC discovery dictionary.
+        """
+        raise AuthClientException(
+            message="OIDC discovery is not implemented for the current authentication mechanism."
+        )
+
+    # def oauth_discovery(self) -> dict:
+    #     """
+    #     Query the authorization server's OAuth2 discovery endpoint for server information.
+    #     Returns:
+    #         Returns the OAuth2 discovery dictionary.
+    #     """
+    #     raise AuthClientException(
+    #         message="OAuth2 discovery is not implemented for the current authentication mechanism."
+    #     )
+
     def get_scopes(self) -> List[str]:
         """
         Query the authorization server for a list of scopes.

src/planet_auth/oidc/auth_client.py

@@ -588,6 +588,14 @@ def userinfo_from_access_token(self, access_token: str) -> dict:
         """
         return self.userinfo_client().userinfo_from_access_token(access_token=access_token)
 
+    def oidc_discovery(self) -> dict:
+        """
+        Query the authorization server's OIDC discovery endpoint for server information.
+        Returns:
+            Returns the OIDC discovery dictionary.
+        """
+        return self._discovery()
+
     def get_scopes(self) -> List[str]:
         """
         Query the authorization server for a list of scopes.

src/planet_auth_utils/__init__.py

@@ -39,6 +39,7 @@
     cmd_oauth_revoke_access_token,
     cmd_oauth_revoke_refresh_token,
     cmd_oauth_userinfo,
+    cmd_oauth_discovery,
     cmd_oauth_list_scopes,
     cmd_oauth_print_access_token,
 )
@@ -103,6 +104,7 @@
     "cmd_oauth_revoke_access_token",
     "cmd_oauth_revoke_refresh_token",
     "cmd_oauth_userinfo",
+    "cmd_oauth_discovery",
     "cmd_oauth_list_scopes",
     "cmd_oauth_print_access_token",
     "cmd_pllegacy",

src/planet_auth_utils/commands/cli/jwt_cmd.py

@@ -225,7 +225,7 @@ def cmd_jwt_validate_oauth(ctx, token, token_file, audience, issuer, human_reada
     )
 
 
-@cmd_jwt.command("validate-rs256")
+@cmd_jwt.command("validate-rs256", hidden=True)
 @click.pass_context
 @opt_human_readable
 @opt_token
@@ -239,7 +239,7 @@ def cmd_jwt_validate_rs256(ctx, token, token_file, human_readable):
     raise NotImplementedError("Command not implemented")
 
 
-@cmd_jwt.command("validate-hs512")
+@cmd_jwt.command("validate-hs512", hidden=True)
 @click.pass_context
 @opt_human_readable
 @opt_token

src/planet_auth_utils/commands/cli/oauth_cmd.py

@@ -163,6 +163,18 @@ def cmd_oauth_list_scopes(ctx):
         print_obj([])
 
 
+@cmd_oauth.command("discovery")
+@click.pass_context
+@recast_exceptions_to_click(AuthException, FileNotFoundError)
+def cmd_oauth_discovery(ctx):
+    """
+    Look up OAuth server discovery information.
+    """
+    auth_client = ctx.obj["AUTH"].auth_client()
+    discovery_json = auth_client.oidc_discovery()
+    print_obj(discovery_json)
+
+
 @cmd_oauth.command("validate-access-token")
 @click.pass_context
 @opt_human_readable