feat: added function Slice.Replace

[bkrukowski]

Summary by Sourcery

Add the Slice.Replace function to allow replacing a segment of a slice with new elements, and include tests to validate its functionality.

New Features:

• Introduce the Slice.Replace function to replace a segment of a slice with new elements.

Tests:

• Add tests for the Slice.Replace function to verify its behavior when replacing elements and when the replacement is not possible.

[sourcery-ai]

Reviewer's Guide by Sourcery

This PR adds a new Replace method to the Slice type that allows replacing a range of elements with new values. The implementation uses the built-in copy function to perform the replacement, and includes proper bounds checking to ensure safe operation.

No diagrams generated as the changes look simple and do not need a visual representation.

File-Level Changes

Change	Details	Files
Added new Replace method to replace a range of elements in a slice	Implemented bounds checking to validate index and replacement length Used built-in copy function to perform the element replacement Added return value to indicate success/failure of operation	slice.go
Added example tests for the new Replace method	Added successful replacement example showing basic usage Added failure case example demonstrating bounds checking	example_test.go

---

Tips and commands

Interacting with Sourcery

• Trigger a new review: Comment @sourcery-ai review on the pull request.
• Continue discussions: Reply directly to Sourcery's review comments.
• Generate a GitHub issue from a review comment: Ask Sourcery to create an
  issue from a review comment by replying to it.
• Generate a pull request title: Write @sourcery-ai anywhere in the pull
  request title to generate a title at any time.
• Generate a pull request summary: Write @sourcery-ai summary anywhere in
  the pull request body to generate a PR summary at any time. You can also use
  this command to specify where the summary should be inserted.

Customizing Your Experience

Access your dashboard to:

• Enable or disable review features such as the Sourcery-generated pull request
  summary, the reviewer's guide, and others.
• Change the review language.
• Add, remove or edit custom review instructions.
• Adjust other review settings.

Getting Help

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.

[sourcery-ai]

Hey @bkrukowski - I've reviewed your changes and they look great!

Here's what I looked at during the review

• 🟡 General issues: 1 issue found
• 🟢 Security: all looks good
• 🟢 Testing: all looks good
• 🟢 Complexity: all looks good
• 🟢 Documentation: all looks good

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

_{Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.}