Fix [FEATURE] Implement Queue wrapper with gitauto model

[gitauto-ai[bot]]

Original issue: #82

What is the feature

Implement a Queue wrapper to provide a standardized interface for queue operations.

Why we need the feature

A Queue wrapper is essential for abstracting the underlying queue implementation, allowing for easier maintenance and potential future changes to the queue system without affecting the rest of the codebase. It also promotes code reusability and cleaner architecture.

How to implement and why

1. Create a new Queue class: This class will serve as the wrapper for the queue operations.

   • File: src/Queue.php
   • Reason: Centralizes queue operations in one place.

2. Define the interface for the Queue: This will include methods like enqueue, dequeue, peek, and isEmpty.

   • File: src/IQueue.php
   • Reason: Ensures that any queue implementation adheres to a standard interface.

3. Implement the Queue class: Implement the methods defined in the interface.

   • File: src/Queue.php
   • Reason: Provides the actual functionality for the queue operations.

4. Write unit tests for the Queue class: Ensure that all methods work as expected.

   • File: tests/QueueTest.php
   • Reason: Validates the functionality and reliability of the Queue wrapper.

5. Update documentation: Add usage examples and explanations in the documentation.

   • File: docs/user-guide/queue.md
   • Reason: Helps developers understand how to use the new Queue wrapper.

By following these steps, we ensure a robust and maintainable implementation of the Queue wrapper.

Test these changes locally

git checkout -b gitauto/issue-#82-46321562-6dd3-453c-b0c5-466db60854c4
git pull origin gitauto/issue-#82-46321562-6dd3-453c-b0c5-466db60854c4

[deepsource-io[bot]]

Here's the code health analysis summary for commits baf8448..36f620f. View details on DeepSource ↗.

Analysis Summary

Analyzer	Status	Summary	Link
Test coverage	✅ Success		View Check ↗
SQL	✅ Success		View Check ↗
Secrets	✅ Success		View Check ↗
PHP	❌ Failure	❗ 12 occurences introduced	View Check ↗
Docker	✅ Success		View Check ↗

Code Coverage Report

Metric	Aggregate	Php
Branch Coverage	100%	100%
Composite Coverage	95.4% (up 0.1% from main)	95.4% (up 0.1% from main)
Line Coverage	95.4% (up 0.1% from main)	95.4% (up 0.1% from main)

---

💡 If you’re a repository administrator, you can configure the quality gates from the settings.

[codacy-production[bot]]

Coverage summary from Codacy

See diff coverage on Codacy

Coverage variation	Diff coverage
:white_check_mark: +0.09% (target: -1.00%)	:white_check_mark: 100.00%

Coverage variation details

| | Coverable lines | Covered lines | Coverage | | ------------- | ------------- | ------------- | ------------- | | Common ancestor commit (baf84488619f94cf366424f6ecf4864fefc75356) | 212 | 202 | 95.28% | | | Head commit (36f620ffb67957c87ac5cef4db41bde56ace07db) | 216 (+4) | 206 (+4) | 95.37% (**+0.09%**) | **Coverage variation** is the difference between the coverage for the head and common ancestor commits of the pull request branch: ` - `

Diff coverage details

| | Coverable lines | Covered lines | Diff coverage | | ------------- | ------------- | ------------- | ------------- | | Pull request (#171) | 4 | 4 | **100.00%** | **Diff coverage** is the percentage of lines that are covered by tests out of the coverable lines that the pull request added or modified: `/ * 100%`

See your quality gate settings    Change summary preferences

---

_{:rocket: Don’t miss a bit, follow what’s new on Codacy.}

_{Codacy stopped sending the deprecated coverage status on June 5th, 2024. Learn more}

[github-actions[bot]]

Infisical secrets check: :white_check_mark: No secrets leaked!

Scan results:

12:11AM INF scanning for exposed secrets...
12:11AM INF 126 commits scanned.
12:11AM INF scan completed in 411ms
12:11AM INF no leaks found

[sonarcloud[bot]]

Quality Gate passed

Issues
2 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarCloud

[codecov[bot]]

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Project coverage is 95.26%. Comparing base (baf8448) to head (36f620f).

Additional details and impacted files

```diff @@ Coverage Diff @@ ## main #171 +/- ## ========================================== + Coverage 95.16% 95.26% +0.09% ========================================== Files 7 8 +1 Lines 207 211 +4 ========================================== + Hits 197 201 +4 Misses 10 10 ```

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.