Skip to content

Commit 4130c00

Browse files
mgallienmgallien
authored
Merge pull request #9321 from nextcloud/i2h3/doc/test-cases
Added first test case documentation
2 parents 26774df + 7c4478e commit 4130c00

17 files changed

+361
-0
lines changed

‎doc/test-cases/README.md‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
<!--
2+
- SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
3+
- SPDX-License-Identifier: GPL-2.0-or-later
4+
-->
5+
6+
# Test Process
7+
8+
This is the first step to improve our release process by introducing a formalized and documented test process as a part of it.
9+
We keep it simple for now and rely on Markdown files with a fixed template.
10+
This enables versioning tied directly to our project and also lowers the entry barrier to the whole topic while adding minimal overhead.
11+
12+
**These test cases and the testing as part of the release process is not binding!** We are testing the waters for now and adjust course along the way.
13+
14+
## Categories
15+
16+
- **Smoke Tests** (`/smoke`): Critical functionality that must work for a build to be viable.
17+
- **Regression Tests** (`/regression`): Core features that should remain stable across releases.
18+
- **Integration Tests** (`/integration`): Client-server interactions and external dependencies.
19+
20+
## Test Case Format
21+
22+
Please have a look at the already existing test cases.
23+
We are still evaluating which format works best for us.

‎doc/test-cases/integration/linux/.gitignore‎

Whitespace-only changes.

‎doc/test-cases/integration/macos-file-provider/TC-1000-delete-a-file.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
<!--
2+
- SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
3+
- SPDX-License-Identifier: GPL-2.0-or-later
4+
-->
5+
6+
# TC-1000: Delete a File
7+
8+
- **Platform:** All
9+
- **Related Issues:** None yet
10+
11+
## Description
12+
13+
A file moved to the trash locally should also be moved likewise on the server while appearing in the local and remote trash.
14+
15+
## Preconditions
16+
17+
- Have a fresh Nextcloud account with the default demo content
18+
- Have an account and file provider domain set up and ready on macOS
19+
- macOS trash is empty
20+
21+
## Test Steps
22+
23+
| Step | Action | Expected Result |
24+
|------|--------|-----------------|
25+
| 1 | Open Finder | The sidebar lists a location called "Nextcloud" |
26+
| 2 | Select the "Nextcloud" location | The items in the Nextcloud user's root folder appear in Finder |
27+
| 3 | Open the context menu on "Nextcloud intro.mp4" | A menu item to move it to the trash is listed |
28+
| 4 | Select the menu item to move it to the trash | The file disappears from the Finder window |
29+
| 5 | Open the trash from the Dock | "Nextcloud intro.mp4" now is located there as the only item |
30+
31+
## Expected Results
32+
33+
- The item moved to the trash does not appear in its original location anymore
34+
- The item moved to the trash does appear in the macOS trash
35+
- The item moved to the trash does appear in the Nextcloud trash web user interface

‎doc/test-cases/integration/macos-file-provider/TC-1001-restore-a-file.md‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
<!--
2+
- SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
3+
- SPDX-License-Identifier: GPL-2.0-or-later
4+
-->
5+
6+
# TC-1001: Restore a File
7+
8+
- **Platform:** All
9+
- **Related Issues:** None yet
10+
11+
## Description
12+
13+
A previously deleted file can be restored to its original location.
14+
15+
## Preconditions
16+
17+
- The steps of [TC-1000: Delete a File](TC-1000-delete-a-file.md)
18+
19+
## Test Steps
20+
21+
| Step | Action | Expected Result |
22+
|------|--------|-----------------|
23+
| 1 | Open the trash from the Dock | "Nextcloud intro.mp4" now is located there as the only item |
24+
| 2 | Open the context menu on "Nextcloud intro.mp4" | A menu item to restore it is listed |
25+
| 3 | Select the menu item to restore it | The file disappears from the Finder window which presents the trash content |
26+
27+
## Expected Results
28+
29+
- The item restored from the trash does not appear in the trash anymore
30+
- The item restored from the trash does appear in the original folder in Finder again
31+
- The item restored from the trash does appear in the original folder in the Nextcloud web user interface again

‎doc/test-cases/integration/macos-file-provider/TC-1002-empty-the-trash.md‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
<!--
2+
- SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
3+
- SPDX-License-Identifier: GPL-2.0-or-later
4+
-->
5+
6+
# TC-1002: Empty the Trash
7+
8+
- **Platform:** macOS (File Provider)
9+
- **Related Issues:** None yet
10+
11+
## Description
12+
13+
When emptying the trash of macOS, an item should be removed permanently on the local device as on the Nextcloud server.
14+
15+
## Preconditions
16+
17+
- The steps of [TC-1000: Delete a File](tc-1000-delete-a-file.md)
18+
19+
## Test Steps
20+
21+
| Step | Action | Expected Result |
22+
|------|--------|-----------------|
23+
| 1 | Open the trash from the Dock | "Nextcloud intro.mp4" now is located there as the only item |
24+
| 2 | Click the button to empty the trash in the Finder header bar | The trash is emptied and left without content |
25+
26+
## Expected Results
27+
28+
- The deleted item does not appear in its original folder in Finder anymore
29+
- The deleted item does not appear in the trash in Finder anymore
30+
- The deleted item does not appear in its original folder in the Nextcloud web user interface anymore
31+
- The deleted item does not appear in the trash in the Nextcloud web user interface anymore

‎doc/test-cases/integration/macos-file-provider/TC-1003-delete-a-file-on-the-server.md‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
<!--
2+
- SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
3+
- SPDX-License-Identifier: GPL-2.0-or-later
4+
-->
5+
6+
# TC-1003: Delete a File on the Server
7+
8+
- **Platform:** All
9+
- **Related Issues:** None yet
10+
11+
## Description
12+
13+
When moving a file into the trash in the Nextcloud web user interface, it should vanish from the file provider domain and not show up in the local trash.
14+
15+
## Preconditions
16+
17+
- Have a file in the Nextcloud account. For clarity, it will be referred to as "Test.md" from here on but can be named arbitrarily
18+
- Have the client and account set up on a Mac with file provider domain enabled
19+
- See the file in question in Finder in the file provider domain location
20+
21+
## Test Steps
22+
23+
| Step | Action | Expected Result |
24+
|------|--------|-----------------|
25+
| 1 | Open the Nextcloud web user interface | See the file "Test.md" to delete |
26+
| 2 | Delete the file in the web user interface | The file "Test.md" appears in the trash in the web user interface |
27+
28+
## Expected Results
29+
30+
- The deleted item does not appear in its original folder in Finder anymore
31+
- The deleted item does also not appear in the trash in Finder
32+
- The deleted item does not appear in its original folder in the Nextcloud web user interface anymore
33+
- The deleted item does appear in the trash in the Nextcloud web user interface

‎doc/test-cases/integration/macos-file-provider/TC-1004-empty-the-trash-on-the-server.md‎

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
<!--
2+
- SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
3+
- SPDX-License-Identifier: GPL-2.0-or-later
4+
-->
5+
6+
# TC-1004: Empty the Trash on the Server
7+
8+
- **Platform:** macOS (File Provider)
9+
- **Related Issues:** None yet
10+
11+
## Description
12+
13+
When emptying the trash in the Nextcloud web user interface, a previously and locally deleted file should also vanish from the local trash.
14+
15+
## Preconditions
16+
17+
- The steps of [TC-1000: Delete a File](tc-1000-delete-a-file.md)
18+
19+
## Test Steps
20+
21+
| Step | Action | Expected Result |
22+
|------|--------|-----------------|
23+
| 1 | Open the trash in the Nextcloud web user interface | See the file "Nextcloud intro.mp4" to delete |
24+
| 2 | Empty the deleted files in the Nextcloud web user interface | All items disappear from the user interface |
25+
26+
## Expected Results
27+
28+
- The item does not appear in its original location anymore
29+
- The item does not appear in the macOS trash
30+
- The item no longer appears in the Nextcloud web user interface listing the trash content

‎doc/test-cases/integration/macos/.gitignore‎

Whitespace-only changes.

‎doc/test-cases/integration/windows-virtual-files/.gitignore‎

Whitespace-only changes.

‎doc/test-cases/integration/windows/.gitignore‎

Whitespace-only changes.

0 commit comments

Comments
 (0)