Add Url::of()

[onairmarc]

Summary by CodeRabbit

• Chores
  • Updated GitHub Actions workflows to use latest action versions for improved stability and features.
  • Updated build and release automation processes.
  • Updated development environment configuration to ignore additional IDE-related files.
  • Updated internal URL handling utilities for improved consistency.

[coderabbitai]

Walkthrough

Version upgrades to GitHub Actions workflows from v2 to v3, configuration updates to IDE ignore rules, and addition of a factory method to the Url class with modified null-handling behavior in the decode method.

Changes

Cohort / File(s)	Summary
GitHub Actions Workflow Upgrades .github/workflows/_preRelease.yml, .github/workflows/_release.yml	Updated createRelease action from v2 to v3; no behavioral changes.
Pull Request Workflow Modernization .github/workflows/_pullRequest.yml	Upgraded multiple actions and workflows to v3: formatPullRequestTitle (added repository and token inputs), php/codeStyle, php_staticAnalysis.yml (from larastan), php_test.yml (from php_pest.yml, removed enforceCoverage and runParallel, added codeCovToken), and github_dependabotAutoMerge.
IDE Configuration .idea/.gitignore	Added four new ignore entries for Copilot data migration XML files.
Source Code Enhancement src/Objects/Http/Url.php	Added public static factory method Url::of(string $url = ""): Uri; imported Illuminate\Support\Uri; changed Url::decode null-input handling to return null.
Repository Maintenance .git-blame-ignore-revs	Added single commit hash to ignored revisions for blame.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

• Review the workflow action version upgrades across three files for consistency and compatibility
• Verify new workflow action inputs (repository, token, codeCovToken) are correctly configured
• Examine the Url::decode null-handling change and its potential impact on calling code
• Confirm PHP factory method signature aligns with Uri interface expectations

Poem

A rabbit hops through versions new,
From v2 workflows to v3—phew!
With factories built and nulls replaced,
The codebase modernizes with grace! 🐰✨

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	You can run @coderabbitai generate docstrings to improve docstring coverage.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check	✅ Passed	The PR title "Add Url::of()" is directly related to the changeset, as a new public static factory method Url::of() was indeed added to src/Objects/Http/Url.php. However, the pull request encompasses multiple changes beyond this single feature, including workflow action version upgrades across three GitHub workflow files (from v2 to v3), updates to .idea/.gitignore for Copilot data migration files, a modification to .git-blame-ignore-revs, and changes to the Url::decode method in the same file. The title focuses on one significant functional change rather than covering the broader scope of infrastructure and configuration updates included in the PR.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch add-url-of

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 PHPStan (2.1.31)

Invalid configuration:
Unexpected item 'parameters › cognitive_complexity'.

---

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

[coderabbitai]

Actionable comments posted: 1

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 9fd3fac and 96647a0.

📒 Files selected for processing (6)

• .git-blame-ignore-revs (1 hunks)
• .github/workflows/_preRelease.yml (1 hunks)
• .github/workflows/_pullRequest.yml (4 hunks)
• .github/workflows/_release.yml (1 hunks)
• .idea/.gitignore (1 hunks)
• src/Objects/Http/Url.php (2 hunks)

🔇 Additional comments (10)

src/Objects/Http/Url.php (1)

24-31: LGTM - Improved clarity.

The explicit return null statement makes the method's behavior clearer when handling null input, even though it's functionally equivalent to the previous implicit behavior.

.git-blame-ignore-revs (1)

53-53: LGTM.

Adding a commit to the git-blame ignore list is routine maintenance.

.github/workflows/_release.yml (1)

19-25: LGTM - Routine action upgrade.

The upgrade from v2 to v3 of the createRelease action appears to be routine maintenance, with all inputs remaining unchanged.

.github/workflows/_preRelease.yml (1)

17-24: LGTM - Routine action upgrade.

Consistent with the release workflow, this upgrades the createRelease action to v3 while maintaining all existing inputs.

.idea/.gitignore (1)

7-10: LGTM.

Adding IDE-specific files to gitignore is standard practice.

.github/workflows/_pullRequest.yml (5)

31-36: LGTM - Action upgraded with additional inputs.

The formatPullRequestTitle action has been upgraded to v3 with the addition of repository and token inputs, which aligns with security best practices.

---

45-48: LGTM - Action upgraded.

The codeStyle action upgrade to v3 maintains the existing inputs.

---

53-57: LGTM - Workflow reference updated.

The static analysis workflow has been updated to the v3 version with consistent inputs.

---

62-69: Note: Test workflow inputs have changed.

The test workflow has been upgraded to v3 with the removal of enforceCoverage and runParallel options. The codeCovToken has been moved to the secrets section, which is a better practice for handling sensitive data.

---

74-74: LGTM - Workflow reference updated.

The dependabot auto-merge workflow has been updated to the v3 version.