Prefer "paramters" over "args" for function documentation.

Author: carl-adams-planet

src/planet_auth/auth_client.py

@@ -255,7 +255,7 @@ def login(
         Authentication parameters are specific to each implementation. Consult
         subclass documentation for details.
 
-        Args:
+        Parameters:
             allow_open_browser: specify whether login is permitted to open
                 a browser window.
             allow_tty_prompt: specify whether login is permitted to request
@@ -289,7 +289,7 @@ def device_login_complete(self, initiated_login_data: Dict) -> Credential:
         """
         Complete a login process that was initiated by a call to `device_login_initiate()`.
 
-        Args:
+        Parameters:
             initiated_login_data: The dictionary that was returned by `device_login_initiate()`
 
         Returns:

src/planet_auth/oidc/auth_client.py

@@ -404,7 +404,7 @@ def login(
         flow. The base implementation here handles common config fallback
         behaviors. Concrete subclasses must implement the flow specific logic
         in a _oidc_flow_login() method.
-        Args:
+        Parameters:
             allow_open_browser: specify whether login is permitted to open
                 a browser window.
             allow_tty_prompt: specify whether login is permitted to request
@@ -435,7 +435,7 @@ def _warn_password_kwarg(self, **kwargs):
         Helper function for _oidc_flow_login implementations to offer guidance to users
         and developers when options are unnecessary and will be ignored.
         """
-        if "password" in kwargs:
+        if "password" in kwParameters:
             if kwargs["password"]:
                 # Safety check. "password" is a legitimate kwarg for some OAuth flows
                 # like Resource Owner Flow.  But, it should never be provided to the client
@@ -461,7 +461,7 @@ def _warn_ignored_kwargs(self, ignore_kws: list, **kwargs):
         is a problem we can anticipate.
         """
         for ignore_kw in ignore_kws:
-            if ignore_kw in kwargs:
+            if ignore_kw in kwParameters:
                 if kwargs[ignore_kw]:
                     auth_logger.debug(
                         msg=f'Ignoring "{ignore_kw}" argument to login. '
@@ -488,7 +488,7 @@ def refresh(
     ) -> FileBackedOidcCredential:
         """
         Refresh auth tokens using the provided refresh token
-        Args:
+        Parameters:
             refresh_token: the refresh token to use.
             requested_scopes: a list of strings specifying the scopes to
                 request during the token refresh. If not specified, server

src/planet_auth/oidc/auth_clients/auth_code_flow.py

@@ -118,7 +118,7 @@ def _oidc_flow_login(
         flow with PKCE.  The Auth Code flow is inherently user interactive,
         and one of allow_tty_prompt or allow_open_browser must be true.
 
-        Args:
+        Parameters:
             allow_open_browser: specify whether login is permitted to open
                 a browser window.
             allow_tty_prompt: specify whether login is permitted to request

src/planet_auth/oidc/auth_clients/device_code_flow.py

@@ -86,7 +86,7 @@ def device_login_initiate(
         to prompt the user.  After prompting the user, `device_login_complete()`
         should be called to complete the login process.
 
-        Args:
+        Parameters:
             requested_scopes: a list of strings specifying the scopes to
                 request.
             requested_audiences: a list of strings specifying the audiences
@@ -115,7 +115,7 @@ def device_login_complete(self, initiated_login_data: dict) -> FileBackedOidcCre
         Obtain tokens from the OIDC auth server using the Device Code OAuth
         flow. This method completes the process initiated by a call to `device_login_initiate()`.
 
-        Args:
+        Parameters:
             initiated_login_data: The dictionary returned from a successful call to
                 `device_login_initiate()`
          Returns:
@@ -147,7 +147,7 @@ def _oidc_flow_login(
         Obtain tokens from the OIDC auth server using the Device Code OAuth
         flow.
 
-        Args:
+        Parameters:
             requested_scopes: a list of strings specifying the scopes to
                 request.
             requested_audiences: a list of strings specifying the audiences