Folder hierarchy in Postman - Test Execution Trace

Test Overview

This test checks that the Postman collection folder hierarchy is correctly structured. It verifies that the main folder contains the expected subfolders and requests.

Test Code - unittest

Postman

import unittest
from postman_collection import Collection

class TestFolderHierarchy(unittest.TestCase):
    def setUp(self):
        # Load the Postman collection JSON file
        with open('collection.json', 'r') as file:
            self.collection = Collection(file.read())

    def test_main_folder_contains_subfolders(self):
        main_folders = [item for item in self.collection.items if item.name == 'Main Folder']
        self.assertTrue(main_folders, 'Main Folder not found')
        main_folder = main_folders[0]
        subfolder_names = [item.name for item in main_folder.items]
        expected_subfolders = ['Subfolder A', 'Subfolder B']
        for folder in expected_subfolders:
            self.assertIn(folder, subfolder_names, f'{folder} not found in Main Folder')

    def test_subfolder_contains_requests(self):
        main_folder = next(item for item in self.collection.items if item.name == 'Main Folder')
        subfolder_a = next(item for item in main_folder.items if item.name == 'Subfolder A')
        request_names = [item.name for item in subfolder_a.items if hasattr(item, 'request')]
        expected_requests = ['Get User', 'Create User']
        for req in expected_requests:
            self.assertIn(req, request_names, f'Request {req} not found in Subfolder A')

if __name__ == '__main__':
    unittest.main()

Execution Trace - 6 Steps

Step	Action	System State	Assertion	Result
1	Test starts	Test runner initialized, collection.json file loaded	-	PASS
2	Find 'Main Folder' in collection items	Collection parsed, folders and requests loaded	Assert 'Main Folder' exists	PASS
3	Check 'Main Folder' contains 'Subfolder A' and 'Subfolder B'	'Main Folder' items listed	Assert 'Subfolder A' and 'Subfolder B' are present	PASS
4	Find 'Subfolder A' inside 'Main Folder'	'Subfolder A' items loaded	-	PASS
5	Check 'Subfolder A' contains requests 'Get User' and 'Create User'	Requests inside 'Subfolder A' listed	Assert 'Get User' and 'Create User' requests exist	PASS
6	Test ends	All assertions passed	-	PASS

Failure Scenario

Failing Condition: Expected folder or request is missing in the collection hierarchy

Execution Trace Quiz - 3 Questions

What does the test verify first in the Postman collection?

A That all requests have valid URLs

B That the 'Main Folder' exists in the collection

C That the collection has no duplicate requests

D That the collection runs successfully

Key Result

Always verify the folder and request structure in your Postman collections to ensure tests target the correct elements and avoid false failures.