uSTL: Queue, Deque and Pair

[TheAihopGG]

closes #35

Summary by Sourcery

This pull request introduces three new utility classes: UDeque, UQueue, and UPair, each designed to simplify common operations for double-ended queues, queues, and pairs respectively. Comprehensive documentation for each class has also been added.

• New Features:
  • Introduced UDeque class to simplify working with double-ended queues, including methods for adding, removing, and accessing elements at both ends.
  • Introduced UQueue class to simplify working with queues, including methods for adding, removing, and accessing the head element.
  • Introduced UPair class to simplify working with pairs, including methods for accessing and setting the first and second elements.
• Documentation:
  • Added documentation for UDeque in examples/udeque.md covering creation, element access, addition, deletion, and iteration.
  • Added documentation for UQueue in examples/uqueue.md covering creation, element access, addition, deletion, and iteration.
  • Added documentation for UPair in examples/upair.md covering creation, element access, setting values, and length calculation.

[sourcery-ai[bot]]

Reviewer's Guide by Sourcery

This pull request introduces three new classes: UDeque, UQueue, and UPair, each with their respective methods for simplified operations. Comprehensive documentation and usage examples for each class are provided in new markdown files.

File-Level Changes

Files	Changes
examples/udeque.md ufpy/udeque.py	Introduced UDeque class and provided comprehensive documentation and usage examples.
examples/uqueue.md ufpy/uqueue.py	Introduced UQueue class and provided comprehensive documentation and usage examples.
examples/upair.md ufpy/upair.py	Introduced UPair class and provided comprehensive documentation and usage examples.

---

Tips

- Trigger a new Sourcery review by commenting `@sourcery-ai review` on the pull request. - You can change your review settings at any time by accessing your [dashboard](https://app.sourcery.ai): - Enable or disable the Sourcery-generated pull request summary or reviewer's guide; - Change the review language; - You can always [contact us](mailto:support@sourcery.ai) if you have any questions or feedback.

[bleudev]

Because of stack, queue, pair and deque are from c++ stl, i want to move all this features in ustl package. Can you do this?

[bleudev]

@sourcery-ai review