update args and summary

Author: jneprz

src/sftp/azext_sftp/_help.py

@@ -9,7 +9,7 @@
 
 helps['sftp'] = """
     type: group
-    short-summary: Commands to connect to Azure Storage Accounts via SFTP
+    short-summary: Generate SSH certificates and access Azure Storage blob data via SFTP
     long-summary: |
         These commands allow you to generate certificates and connect to Azure Storage Accounts using SFTP.
 
@@ -46,16 +46,16 @@
         The certificate can be used with 'az sftp connect' or with standard SFTP clients.
     examples:
         - name: Generate a certificate using an existing public key
-          text: az sftp cert --public-key-file ~/.ssh/id_rsa.pub --file ~/my_cert.pub
+          text: az sftp cert --public-key-file ~/.ssh/id_rsa.pub --output-file ~/my_cert.pub
         - name: Generate a certificate and create a new key pair in the same directory
-          text: az sftp cert --file ~/my_cert.pub
+          text: az sftp cert --output-file ~/my_cert.pub
         - name: Generate a certificate with custom SSH client folder
-          text: az sftp cert --file ~/my_cert.pub --ssh-client-folder "C:\\Program Files\\OpenSSH"
+          text: az sftp cert --output-file ~/my_cert.pub --ssh-client-folder "C:\\Program Files\\OpenSSH"
 """
 
 helps['sftp connect'] = """
     type: command
-    short-summary: Connect to Azure Storage Account via SFTP
+    short-summary: Access Azure Storage blob data via SFTP
     long-summary: |
         Establish an SFTP connection to an Azure Storage Account.
 

src/sftp/azext_sftp/_params.py

@@ -8,11 +8,11 @@
 def load_arguments(self, _):
 
     with self.argument_context('sftp cert') as c:
-        c.argument('cert_path', options_list=['--file', '-f'],
+        c.argument('cert_path', options_list=['--output-file', '-o'],
                    help='The file path to write the SSH cert to, defaults to public key path with -aadcert.pub appended')
         c.argument('public_key_file', options_list=['--public-key-file', '-p'],
                    help='The RSA public key file path. If not provided, '
-                   'generated key pair is stored in the same directory as --file.')
+                   'generated key pair is stored in the same directory as --output-file.')
         c.argument('ssh_client_folder', options_list=['--ssh-client-folder'],
                    help='Folder path that contains ssh executables (ssh-keygen, ssh). '
                    'Default to ssh executables in your PATH or C:\\Windows\\System32\\OpenSSH on Windows.')

src/sftp/azext_sftp/custom.py

@@ -24,7 +24,7 @@ def sftp_cert(cmd, cert_path=None, public_key_file=None, ssh_client_folder=None)
     logger.debug("Starting SFTP certificate generation")
 
     if not cert_path and not public_key_file:
-        raise azclierror.RequiredArgumentMissingError("--file or --public-key-file must be provided.")
+        raise azclierror.RequiredArgumentMissingError("--output-file or --public-key-file must be provided.")
 
     if cert_path:
         cert_path = os.path.expanduser(cert_path)

src/sftp/azext_sftp/tests/latest/test_custom.py

@@ -713,7 +713,7 @@ def test_sftp_cert_error_cases(self):
         """Test sftp cert error handling with invalid argument combinations."""
         # Test cases: (cert_path, public_key_file, setup_mocks, expected_exception, expected_message, description)
         test_cases = [
-            (None, None, {}, azclierror.RequiredArgumentMissingError, "--file or --public-key-file must be provided", "no_arguments"),
+            (None, None, {}, azclierror.RequiredArgumentMissingError, "--output-file or --public-key-file must be provided", "no_arguments"),
             ("/bad/cert.pub", None, {"expanduser_return": "/bad/cert.pub", "isdir_return": False}, azclierror.InvalidArgumentValueError, "folder doesn't exist", "invalid_directory"),
         ]
 

src/sftp/setup.py

@@ -44,7 +44,7 @@
 setup(
     name='sftp',
     version=VERSION,
-    description='Secure connections to Azure Storage via SFTP with SSH certificates.',
+    description='Secure access to Azure Storage blob data via SFTP with SSH certificates.',
     author='Microsoft Corporation',
     author_email='azpycli@microsoft.com',
     # TODO: change to your extension source code repo if the code will not be put in azure-cli-extensions repo