1 TCER: containerized deployment x86-64 TRS-001

Relevant test environment and configuration details

  • Software deviations: aligned with test case specifications
  • Hardware deviations: aligned with test case specifications

Test execution results

Here we report the results in terms of step-wise alignments or deviations with respect to the expected outcome of the covered test case.

Test case step 1: Clone repository

  • 0 = flawless

Test case step 2: Start Docker Desktop

  • 0 = flawless: Docker Desktop was already running

Test case step 3: Open the C5-DEC repository in VS Code

  • 0 = flawless

Test case step 4: Reopen in container with options

  • 0 = flawless: the pop-up "Reopen in Container" appeared. When clicked, the two expected options (shown in the test case image) were presented in VS Code

Test case step 5: Build the CAD dev container

  • 0 = flawless: the image was created without errors when selecting the C5-DEC CAD dev container option

Test case step 6: Open a terminal and a shell

  • 0 = flawless: a terminal and a poetry shell were manually created. The expected outcome is in alignment with the expected outcome shown in TSS-001.

Defect summary description

Defect-free test execution, i.e., defect category: 0 = flawless

Text execution evidence

See linked files (if any), e.g., screenshots, logs, etc.

Comments

N/A

Guide

  • Defect category: 0 = flawless; 1 = insignificant defect; 2 = minor defect; 3 = major defect; 4 = critical defect
  • Verification method (VM): Test (T), Review of design (R), Inspection (I), Analysis (A)

Parent links: TSS-001 TC: Test containerized deployment on x86-64

Attribute Value
test-date 2025-05-02
tester IVS
defect-category 0 = flawless
passed-steps 6
failed-steps 0
not-executed-steps 0
release-version 1.0
verification-method T

2 TCER: containerized deployment arm64 TRS-002

Relevant test environment and configuration details

  • Software deviations: aligned with test case specifications
  • Hardware deviations: aligned with test case specifications

Test execution results

Test case step 1: Clone repository

  • 0 = flawless

Test case step 2: Open the C5-DEC repository in VS Code

  • 0 = flawless

Test case step 3: Reopen in container with options

  • 0 = flawless: the pop-up "Reopen in Container" appeared. When clicked, the two expected options (shown in the test case image) were presented in VS Code

Test case step 4: Build the CAD dev container

  • 0 = flawless: when selecting the C5-DEC CAD dev container option, the image was created without errors after approx. 3-4 minutes

Test case step 5: Open a terminal and a shell

  • 0 = flawless: a terminal and a poetry shell were manually created. The expected outcome is in alignment with the expected outcome shown in TSS-002. Furthermore, the c5dec TUI was opened when running c5dec, once inside the c5dec folder.

Defect summary description

Defect-free test execution, i.e., defect category: 0 = flawless

Text execution evidence

See linked files (if any), e.g., screenshots, logs, etc.

Comments

N/A

Guide

  • Defect category: 0 = flawless; 1 = insignificant defect; 2 = minor defect; 3 = major defect; 4 = critical defect
  • Verification method (VM): Test (T), Review of design (R), Inspection (I), Analysis (A)

Parent links: TSS-002 TC: Test containerized deployment on arm64

Attribute Value
test-date 2025-05-02
tester IVS
defect-category 0 = flawless
passed-steps 5
failed-steps 0
not-executed-steps 0
release-version 1.0
verification-method T

3 TCER: PQ cryptography container TRS-003

Relevant test environment and configuration details

  • Software deviations: aligned with test case specifications
  • Hardware deviations: N/A

Test execution results

Test case step 1: Clone the C5-DEC repository

  • 0 = flawless

Test case step 2: Open the project in VS Code

  • 0 = flawless

Test case step 3: Reopen in container with the option "C5-DEC cryptography dev container"

  • 0 = flawless: the container is opened successfully

Test case step 4: Get a list of the available quantum-safe signature algorithms

  • 0 = flawless: the output list corresponds to the expected outcome described in TSS-003

Test case step 5: Get a list of the available quantum-safe KEM algorithms

  • 0 = flawless: the list of the available quantum-safe KEM algorithms corresponds to the expected outcome described in TSS-003

Defect summary description

Defect-free test execution, i.e., defect category: 0 = flawless

Text execution evidence

See linked files (if any), e.g., screenshots, logs, etc.

Comments

If we want to open the 'C5-DEC cryptography dev container' while already in VS Code and using the C5-DEC CAD container, the "Reopen in Container" option is not available. This happens more generally when trying to switch between the two C5-DEC containers.

However, this behavior is not related with C5-DEC but with the VS Code dev containers extension. The workaround is to "Reopen folder locally" for the "Reopen in Container" option to become available again.

Guide

  • Defect category: 0 = flawless; 1 = insignificant defect; 2 = minor defect; 3 = major defect; 4 = critical defect
  • Verification method (VM): Test (T), Review of design (R), Inspection (I), Analysis (A)

Parent links: TSS-003 TC: Test PQ cryptography container

Attribute Value
test-date 2025-05-02
tester IVS
defect-category 0 = flawless
passed-steps 5
failed-steps 0
not-executed-steps 0
release-version 1.0
verification-method T

4 TCER: Test DocEngine TRS-004

Relevant test environment and configuration details

  • Software deviations: aligned with test case specification
  • Hardware deviations: N/A

Test execution results

Test case step 1: Open the C5-DEC CAD container in VS Code and activate the Python environment in the root folder

  • 0 = flawless

Test case step 2: Go to the execution path of C5DEC CAD

  • 0 = flawless

Test case step 3: Use quarto to render a PDF document

  • 0 = flawless: the quarto command run successfully without showing error messages in the terminal; the PDF file was generated in the folder ~/c5dec/assets/report/_output/C5-DEC-CAD-DocEngine.pdf.

Defect summary description

Defect-free test execution, i.e., defect category: 0 = flawless

Text execution evidence

See the file referred below in this test case report.

Comments

The final message in the terminal indicates Output created: _output/C5-DEC-CAD-DocEngine.pdf. While this path is correct w.r.t to the root of the quarto project, it is not correct w.r.t. to the execution path and it might be confusing. If the implementation effort is minimal, it would be better to show the complete path, i.e., ~/c5dec/assets/report/_output/C5-DEC-CAD-DocEngine.pdf.

Guide

  • Defect category: 0 = flawless; 1 = insignificant defect; 2 = minor defect; 3 = major defect; 4 = critical defect
  • Verification method (VM): Test (T), Review of design (R), Inspection (I), Analysis (A)

docs/specs/trs/assets/C5-DEC-CAD-DocEngine-evidence.pdf

Parent links: TSS-004 TC: Test DocEngine

Attribute Value
test-date 2025-05-02
tester IVS
defect-category 0 = flawless
passed-steps 3
failed-steps 0
not-executed-steps 0
release-version 1.0
verification-method T

5 TCER: creation of empty C5-DEC-based project TRS-005

Relevant test environment and configuration details

  • Software deviations: aligned with test case specification

Test execution results

Test case step 1: Go to the c5dec root folder

  • 0 = flawless

Test case step 2: Run the c5dec new command

  • 0 = flawless: The command ran without errors, printing the following output log:
Starting C5-DEC CAD...
For usage instructions, run: ./c5dec.sh help
Executing C5-DEC CAD CLI command new...
Copied project folder to /home/alab/c5dec/myproject
Renamed devcontainer folder to /home/alab/c5dec/myproject/.devcontainer
Renamed template_devcontainer.json to /home/alab/c5dec/myproject/.devcontainer/devcontainer.json
Updated /home/alab/c5dec/myproject/.devcontainer/devcontainer.json with user=user
Updated /home/alab/c5dec/myproject/dev.Dockerfile with user=user
Updated /home/alab/c5dec/myproject/Dockerfile with user=user
Updated /home/alab/c5dec/myproject/build-c5dec.sh with username user and project name myproject
Renamed script /home/alab/c5dec/myproject/build-c5dec.sh to /home/alab/c5dec/myproject/build-myproject.sh
Updated /home/alab/c5dec/myproject/c5dec.sh with username user and project name myproject
Renamed script /home/alab/c5dec/myproject/c5dec.sh to /home/alab/c5dec/myproject/myproject.sh
Updated /home/alab/c5dec/myproject/pyproject.toml with username user and project name myproject
Renamed script /home/alab/c5dec/myproject/pyproject.toml to /home/alab/c5dec/myproject/pyproject.toml
Renamed /home/alab/c5dec/myproject/docs/specs/tra/template_doorstop.yml to /home/alab/c5dec/myproject/docs/specs/tra/.doorstop.yml
Renamed /home/alab/c5dec/myproject/docs/specs/trs/template_doorstop.yml to /home/alab/c5dec/myproject/docs/specs/trs/.doorstop.yml
Renamed /home/alab/c5dec/myproject/docs/specs/srs/template_doorstop.yml to /home/alab/c5dec/myproject/docs/specs/srs/.doorstop.yml
Renamed /home/alab/c5dec/myproject/docs/specs/swd/template_doorstop.yml to /home/alab/c5dec/myproject/docs/specs/swd/.doorstop.yml
Renamed /home/alab/c5dec/myproject/docs/specs/trb/template_doorstop.yml to /home/alab/c5dec/myproject/docs/specs/trb/.doorstop.yml
Renamed /home/alab/c5dec/myproject/docs/specs/tss/template_doorstop.yml to /home/alab/c5dec/myproject/docs/specs/tss/.doorstop.yml
Renamed /home/alab/c5dec/myproject/docs/specs/tst/template_doorstop.yml to /home/alab/c5dec/myproject/docs/specs/tst/.doorstop.yml
Renamed /home/alab/c5dec/myproject/docs/specs/mrs/template_doorstop.yml to /home/alab/c5dec/myproject/docs/specs/mrs/.doorstop.yml
Renamed /home/alab/c5dec/myproject/docs/specs/arc/template_doorstop.yml to /home/alab/c5dec/myproject/docs/specs/arc/.doorstop.yml
Deleted the copied project folder /home/alab/c5dec/myproject
Created ZIP archive at /home/alab/c5dec/myproject.zip

Test case step 3: Verify creation of a zipped project file

  • 0 = flawless: the ZIP file myproject.zip was in the list output by ls

Test case step 4: Unzip and access the project folder

  • 0 = flawless: after unzipping the file, the structure of the internal folders was aligned with the one shown in the "Expected outcome" of the test case specification.

Defect summary description

Defect-free test execution, i.e., defect category: 0 = flawless

Text execution evidence

See log in test case step 2 above.

Comments

N/A

Guide

  • Defect category: 0 = flawless; 1 = insignificant defect; 2 = minor defect; 3 = major defect; 4 = critical defect
  • Verification method (VM): Test (T), Review of design (R), Inspection (I), Analysis (A)

Parent links: TSS-005 TC: Test the creation of an empty C5-DEC-based project

Attribute Value
test-date 2025-05-06
tester IVS
defect-category 0 = flawless
passed-steps 4
failed-steps 0
not-executed-steps 0
release-version 1.0
verification-method T, I

6 TCER: build and run an empty created project TRS-006

Relevant test environment and configuration details

  • Software deviations: aligned with test case specification
  • Hardware deviations: N/A

Test execution results

Test case step 1: Go to the myproject folder

  • 0 = flawless

Test case step 2: Run the build script

  • 0 = flawless: the log showed a healthy built of the images myproject:v1.0 and myproject-dev:v1.0
Building myproject images...
[+] Building 3.8s (20/20) FINISHED                                                               docker:desktop-linux
 => [internal] load build definition from Dockerfile                                                             0.0s
...
 => => writing image sha256:c8a9121fa2a7f1cdedb6cb06e68cfc0321681cf0c37148aefb026c18d8d61008                     0.0s
 => => naming to docker.io/library/myproject:v1.0                                                                0.0s
...

[+] Building 38.2s (24/29)                                                                       docker:desktop-linux
[+] Building 63.0s (30/30) FINISHED                                                              docker:desktop-linux
 => [internal] load build definition from dev.Dockerfile
...
=> => writing image sha256:cf96ad7b07c3327dd0c315ddb11fc3450cf73fd6516ad8615f0838aeba7c20ab                      0.0s
=> => naming to docker.io/library/myproject-dev:v1.0
...

Test case step 3: Verify that the images exist

  • 0 = flawless: the images myproject-dev and myproject, each with tag v1.0 appear in the output of the executed command
REPOSITORY                               TAG       IMAGE ID       CREATED          SIZE
myproject-dev                            v1.0      cf96ad7b07c3   13 minutes ago   3.12GB
myproject                                v1.0      c8a9121fa2a7   14 minutes ago   1.86GB

Test case step 4: Run the help of myproject

  • 0 = flawless: the command showed the following output:
~/myproject % ./myproject.sh help
Starting myproject...
For usage instructions, run: ./myproject.sh help
---
./myproject.sh
... to open the myproject CLI help menu
./myproject.sh session
... to start an interactive myproject session
./myproject.sh <command>
... to run a myproject CLI command
./myproject.sh <command> -h
... to get help for a myproject CLI command
---

Test case step 5: Run myproject in a container

  • 0 = flawless: an interactive shell within the container was created for the default user:
~/myproject % ./myproject.sh session
Starting myproject...
For usage instructions, run: ./myproject.sh help
Launching an interactive myproject session...
user@f8e418686013:~/myproject/myproject$

Test case step 6: Dependencies correctly installed

  • 0 = flawless: the version of doorstop corresponds with the expected outcome for step 6 in TSS-006.

Test case step 7: Exit the session

  • 0 = flawless: the container shell was closed and the control was given back to the terminal shell

Defect summary description

Defect-free test execution, i.e., defect category: 0 = flawless

Text execution evidence

See logs in the steps above.

Comments

N/A

Guide

  • Defect category: 0 = flawless; 1 = insignificant defect; 2 = minor defect; 3 = major defect; 4 = critical defect
  • Verification method (VM): Test (T), Review of design (R), Inspection (I), Analysis (A)

Parent links: TSS-006 TC: Test build and run of new project via scripts

Attribute Value
test-date 2025-05-06
tester IVS
defect-category 0 = flawless
passed-steps 7
failed-steps 0
not-executed-steps 0
release-version 1.0
verification-method T

7 TCER: New project in VS Code TRS-007

Relevant test environment and configuration details

  • Software deviations: aligned with test case specification
  • Hardware deviations: N/A

Test execution results

Test case step 1: Open myproject in VS Code.

  • 0 = flawless

Test case step 2: Select the "Reopen in Container" option or use the command palette to reopen in a container.

  • 0 = flawless: the container environment was successfully initialized.

Test case step 3: Open a terminal in VS Code and run poetry shell

  • 0 = flawless: the poetry shell command successfully activated the environment as shown in the expected outcome.

Test case step 4: Verify that dependencies are installed by checking the version of quarto.

  • 0 = flawless: The quarto -V command returned the expected version 1.6.43. Moreover, the other suggested dependencies were verified successfully.

Defect summary description

Defect-free test execution, i.e., defect category: 0 = flawless

Text execution evidence

N/A

Comments

N/A

Guide

  • Defect category: 0 = flawless; 1 = insignificant defect; 2 = minor defect; 3 = major defect; 4 = critical defect
  • Verification method (VM): Test (T), Review of design (R), Inspection (I), Analysis (A)

Parent links: TSS-007 TC: Test new project in VS Code

Attribute Value
test-date 2025-05-06
tester IVS
defect-category 0 = flawless
passed-steps 4
failed-steps 0
not-executed-steps 0
release-version 1.0
verification-method T