Fixing documentation and adding some improvements

Author: SeqLaz

docs/docs/examples.md

@@ -58,27 +58,27 @@ In this example, we'll use the `jq` tool to parse the JSON response and retrieve
 === ":material-bash: Bash"
 
     ```bash
-    qfieldcloud-cli --json login 'ninjamaster' 'secret_password123' | jq .session_token
+    qfieldcloud-cli --json login 'ninjamaster' 'secret_password123' | jq '.token'
     ```
 
 === ":material-powershell: PowerShell"
 
     ```powershell
-    qfieldcloud-cli --json login "ninjamaster" "secret_password123" | jq ".session_token"
+    (qfieldcloud-cli --json login "ninjamaster" "secret_password123" | ConvertFrom-Json).token
     ```
 
 This command will output only the session token, which can be stored in an environment variable for future use:
 
 === ":material-bash: Bash"
 
     ```bash
-    export QFIELDCLOUD_TOKEN=$(qfieldcloud-cli --json login 'ninjamaster' 'secret_password123' | jq -r .session_token)
+    export QFIELDCLOUD_TOKEN=$(qfieldcloud-cli --json login 'ninjamaster' 'secret_password123' | jq -r '.token')
     ```
 
 === ":material-powershell: PowerShell"
 
     ```powershell
-    $env:QFIELDCLOUD_TOKEN = (qfieldcloud-cli --json login "ninjamaster" "secret_password123" | jq ".session_token")
+    $env:QFIELDCLOUD_TOKEN = (qfieldcloud-cli --json login "ninjamaster" "secret_password123" | ConvertFrom-Json).token
     ```
 
 ### Create a project
@@ -181,6 +181,66 @@ To view all files in a specific project:
     qfieldcloud-cli list-files "123e4567-e89b-12d3-a456-426614174000"
     ```
 
+### Download Files for Backup
+
+Once the package job is complete, download the project files for backup. To download all files or filter specific ones (e.g., `.jpg` files):
+
+=== ":material-bash: Bash"
+
+    ```bash
+    qfieldcloud-cli download-files '123e4567-e89b-12d3-a456-426614174000' '/home/ninjamaster/backup_folder/DCIM/2024-11-10/' --filter '*.jpg'
+    ```
+
+=== ":material-powershell: PowerShell"
+
+    ```powershell
+    qfieldcloud-cli download-files "123e4567-e89b-12d3-a456-426614174000" "C:\Users\ninjamaster\backup_folder\DCIM\2024-11-10\" --filter "*.jpg"
+    ```
+
+If files already exist locally and you want to overwrite them, use the `--force-download` option:
+
+=== ":material-bash: Bash"
+
+    ```bash
+    qfieldcloud-cli download-files '123e4567-e89b-12d3-a456-426614174000' '/home/ninjamaster/backup_folder/DCIM/2024-11-10/' --force-download
+    ```
+
+=== ":material-powershell: PowerShell"
+
+    ```powershell
+    qfieldcloud-cli download-files "123e4567-e89b-12d3-a456-426614174000" "C:\Users\ninjamaster\backup_folder\DCIM\2024-11-10\" --force-download
+    ```
+
+### Delete Files to Save Space
+
+To free up storage on QFieldCloud, you can delete unnecessary files, such as `.jpg` files:
+
+=== ":material-bash: Bash"
+
+    ```bash
+    qfieldcloud-cli delete-files '123e4567-e89b-12d3-a456-426614174000' --filter '*.jpg'
+    ```
+
+=== ":material-powershell: PowerShell"
+
+    ```powershell
+    qfieldcloud-cli delete-files "123e4567-e89b-12d3-a456-426614174000" --filter "*.jpg"
+    ```
+
+You can also delete specific files by specifying their exact path:
+
+=== ":material-bash: Bash"
+
+    ```bash
+    qfieldcloud-cli delete-files '123e4567-e89b-12d3-a456-426614174000' 'DCIM/tree-202411202334943.jpg'
+    ```
+
+=== ":material-powershell: PowerShell"
+
+    ```powershell
+    qfieldcloud-cli delete-files "123e4567-e89b-12d3-a456-426614174000" "DCIM\tree-202411202334943.jpg"
+    ```
+
 ### Manage Members and Collaborators
 
 The collaborative nature of QFieldCloud naturally involves other people in the fieldwork.
@@ -375,67 +435,6 @@ Suppose your company packages the project every morning at 8:47 AM.:
 
     This triggers the package job daily at the specified time. For more information about [schtasks](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/schtasks).
 
-
-### Download Files for Backup
-
-Once the package job is complete, download the project files for backup. To download all files or filter specific ones (e.g., `.jpg` files):
-
-=== ":material-bash: Bash"
-
-    ```bash
-    qfieldcloud-cli package-download '123e4567-e89b-12d3-a456-426614174000' '/home/ninjamaster/backup_folder/DCIM/2024-11-10/' --filter '*.jpg'
-    ```
-
-=== ":material-powershell: PowerShell"
-
-    ```powershell
-    qfieldcloud-cli package-download "123e4567-e89b-12d3-a456-426614174000" "C:\Users\ninjamaster\backup_folder\DCIM\2024-11-10\" --filter "*.jpg"
-    ```
-
-If files already exist locally and you want to overwrite them, use the `--force-download` option:
-
-=== ":material-bash: Bash"
-
-    ```bash
-    qfieldcloud-cli package-download '123e4567-e89b-12d3-a456-426614174000' '/home/ninjamaster/backup_folder/DCIM/2024-11-10/' --force-download
-    ```
-
-=== ":material-powershell: PowerShell"
-
-    ```powershell
-    qfieldcloud-cli package-download "123e4567-e89b-12d3-a456-426614174000" "C:\Users\ninjamaster\backup_folder\DCIM\2024-11-10\" --force-download
-    ```
-
-### Delete Files to Save Space
-
-To free up storage on QFieldCloud, you can delete unnecessary files, such as `.jpg` files:
-
-=== ":material-bash: Bash"
-
-    ```bash
-    qfieldcloud-cli delete-files '123e4567-e89b-12d3-a456-426614174000' --filter '*.jpg'
-    ```
-
-=== ":material-powershell: PowerShell"
-
-    ```powershell
-    qfieldcloud-cli delete-files "123e4567-e89b-12d3-a456-426614174000" --filter "*.jpg"
-    ```
-
-You can also delete specific files by specifying their exact path:
-
-=== ":material-bash: Bash"
-
-    ```bash
-    qfieldcloud-cli delete-files '123e4567-e89b-12d3-a456-426614174000' 'DCIM/tree-202411202334943.jpg'
-    ```
-
-=== ":material-powershell: PowerShell"
-
-    ```powershell
-    qfieldcloud-cli delete-files "123e4567-e89b-12d3-a456-426614174000" "DCIM\tree-202411202334943.jpg"
-    ```
-
 ### Delete a Project
 
 To permanently delete a project (be cautious—this action cannot be undone):

qfieldcloud_sdk/cli.py

@@ -126,7 +126,7 @@ def cli(
 
         qfieldcloud-cli login user pass
 
-        qfieldcloud-cli -u user -p pass -U https://localhost/api/v1/ list-projects
+        qfieldcloud-cli -u user -p pass -U https://app.qfield.cloud/api/v1/ list-projects
     """
     ctx.ensure_object(dict)
     ctx.obj["client"] = sdk.Client(url, verify_ssl, token=token)
@@ -143,13 +143,12 @@ def cli(
 def login(ctx: Context, username, password) -> None:
     """Login to QFieldCloud."""
 
-    log(f"Log in {username}…")
-
     user_data = ctx.obj["client"].login(username, password)
 
     if ctx.obj["format_json"]:
         print_json(user_data)
     else:
+        log(f"Log in {username}…")
         log(f'Welcome to QFieldCloud, {user_data["username"]}.')
         log(
             "QFieldCloud has generated a secret token to identify you. "