TestManager

TestManager is a local desktop application for managing manual software tests.

The application allows users to create and manage:

• manual test cases,
• test plans,
• test plan executions,
• execution results,
• defects and defect lifecycle,
• reports,
• project data stored in readable YAML files.

TestManager is intended for local/manual testing workflows. It is not a test automation framework.

---

How to run the application

Download and unpack the provided TestManager package.

Inside the unpacked folder, run:

TestManager.exe

Do not move TestManager.exe outside of its folder. The application requires additional internal files located next to the executable.

---

Creating a new project

After starting the application:

Project -> Create New Test Project

Choose a target directory and provide a project name.

TestManager will create the required project structure automatically.

---

Opening an existing project

To open an existing TestManager project:

Project -> Open Project Folder

Select the root folder of the project, the folder that contains:

project.yaml

---

Example project

This repository contains an example project:

example_project

You can use it to quickly test the application.

To open it:

Project -> Open Project Folder

Then select the example_project directory.

---

Basic workflow

A typical workflow looks like this:

1. Create or open a project.
2. Create manual test cases.
3. Create a test plan from selected test cases.
4. Run a test plan execution.
5. Fill in execution results, comments, and defects.
6. Review generated reports.
7. Manage reported defects in the Defect Manager.

---

Main application areas

Test Cases

Use this area to create, edit, and review manual test cases.

Each test case can contain:

• title,
• priority,
• status,
• tags,
• requirements,
• preconditions,
• test steps,
• expected results,
• change history.

Test Plans

Use test plans to group selected test cases into a planned execution scope.

Executions

Use executions to manually run a test plan and record results.

Each test case execution can be marked as:

• passed,
• failed,
• blocked,
• skipped,
• not run.

Defects

Defects can be created during test plan execution or manually from the Defect Manager.

Supported defect lifecycle statuses:

• open,
• retest,
• fixed,
• rejected,
• closed.

---

Project data

TestManager stores project data as local YAML files.

Example project structure:

project.yaml
metadata/
test_cases/
histories/
test_plans/
executions/
defects/
attachments/
reports/

This makes the project easy to inspect, archive, and version control.

---

Notes for testers

This is an early test version of the application.

When testing, please report:

• application crashes,
• unclear workflows,
• missing information,
• incorrect saved data,
• problems with opening or saving projects,
• issues with generated reports,
• suggestions for improving the GUI.

When reporting a problem, please include:

• what you were trying to do,
• what happened,
• what you expected to happen,
• screenshot if possible,
• project or test data if relevant.

---

Contact

Author: Jakub Marciniak

Email: jakub.marciniak.app@gmail.com

LinkedIn: https://www.linkedin.com/in/jakub-marciniak-33586b150/