[mayureshsonawane17]

Summary

Fixes #756.

This PR introduces an optional ignore_order: bool = False parameter to matchers.json_params_matcher(). When ignore_order=True, elements within JSON lists/arrays (both top-level and nested) are matched without regard to ordering, using recursive multiset equality.

Key Changes

• Added _compare_json helper in responses/matchers.py supporting order-insensitive list comparison.
• Added ignore_order: bool = False argument to json_params_matcher with full backwards compatibility.
• Added unit tests in responses/tests/test_matchers.py for reordered lists, nested dictionary structures, duplicate elements, and length mismatches.
• Updated README.rst with documentation and an example of ignore_order=True usage.

Test Plan

• Ran pytest responses/tests/test_matchers.py (57 passed).
• Ran full test suite pytest responses/tests/ (254 passed cleanly).

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want reviews to match your repository better? Bugbot Learning can learn team-specific rules from PR activity. A team admin can enable Learning in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 603ce1d. Configure here.}

[cursor]

Inverted empty-body matching condition

Medium Severity

Refactoring the match condition inverted the None check. json_params_matcher with params=None no longer accepts an empty JSON object body, and params={} now matches a missing request body. Both differ from the previous request_body is None short-circuit.

 

^{Reviewed by Cursor Bugbot for commit 603ce1d. Configure here.}