refactor(normalize_url): improve query parameter handling and sorting

[Ahmed-Tawfik94]

Summary

#1489
Added inline comments to the query parameter processing section in the normalize_url function to improve code readability and maintainability. This clarifies the steps for parsing, filtering, and rebuilding query parameters, making the logic easier to understand for future developers. No functional changes were made—only documentation enhancements.

Fixes code clarity issues in URL normalization logic.

List of files changed and why

• utils.py: Added inline comments to the query parameter handling code in the normalize_url function. This explains the "explode, mutate, then rebuild" process, including parsing query strings, filtering tracking parameters, and sorting/rebuilding parameters for consistent output.

How Has This Been Tested?

• Ran the normalize_url function with various URLs containing query parameters to ensure the code executes without errors and produces expected output.
• Verified that the added comments do not affect functionality by running unit tests for URL normalization (assuming existing tests cover this; no new tests were added since this is purely a documentation change).
• Checked for syntax errors and ensured the file imports and runs correctly in the project environment.

Checklist:

• My code follows the style guidelines of this project (comments are concise and follow Python docstring conventions).
• I have performed a self-review of my own code (verified comments are accurate and non-intrusive).
• I have commented my code, particularly in hard-to-understand areas (added explanations for each key step in query processing).
• I have made corresponding changes to the documentation (not applicable; this is internal code documentation).
• I have added/updated unit tests that prove my fix is effective or that my feature works (no functional changes, so existing tests suffice).
• New and existing unit tests pass locally with my changes (confirmed no regressions in URL normalization behavior).

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fix/case_senstive_params

Tip

👮 Agentic pre-merge checks are now available in preview!

Pro plan users can now enable pre-merge checks in their settings to enforce checklists before merging PRs.

• Built-in checks – Quickly apply ready-made checks to enforce title conventions, require pull request descriptions that follow templates, validate linked issues for compliance, and more.
• Custom agentic checks – Define your own rules using CodeRabbit’s advanced agentic capabilities to enforce organization-specific policies and workflows. For example, you can instruct CodeRabbit’s agent to verify that API documentation is updated whenever API schema files are modified in a PR. Note: Upto 5 custom checks are currently allowed during the preview period. Pricing for this feature will be announced in a few weeks.

Please see the documentation for more information.

Example:

reviews:
  pre_merge_checks:
    custom_checks:
      - name: "Undocumented Breaking Changes"
        mode: "warning"
        instructions: |
          Pass/fail criteria: All breaking changes to public APIs, CLI flags, environment variables, configuration keys, database schemas, or HTTP/GraphQL endpoints must be documented in the "Breaking Change" section of the PR description and in CHANGELOG.md. Exclude purely internal or private changes (e.g., code not exported from package entry points or explicitly marked as internal).

Please share your feedback with us on this Discord post.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}