Enhance functionalities

[kaliv0]

@sourcery-ai review

Summary by Sourcery

Add support for creating finite ordered streams using a condition predicate, creating streams from ranges and range objects, reading and writing plain text files, handling None values when creating streams, discarding falsy values during filter mapping, adding close handlers to streams, enumerating stream elements, calculating averages, retrieving the first or last element of a stream, and appending to plain text files. Improve documentation and add leetcode examples.

New Features:

• Add from_range() to create streams from ranges and range objects.
• Add support for plain text files in FileStream.
• Add of_nullable() to handle None values when creating streams.
• Add discard_falsy parameter to filter_map() to discard falsy values.
• Add on_close() to add close handlers to streams.
• Add enumerate() to get stream elements with their indices.
• Add average() to calculate the average of stream elements.
• Add take_first() and take_last() to retrieve the first or last element of a stream.
• Add support for appending to plain text files in FileStream.

Tests:

• Add tests for new features and examples.

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

Attention: Patch coverage is 98.81890% with 3 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
pyrio/decorators/dispatcher.py	92.30%	2 Missing ⚠️
pyrio/streams/file_stream.py	98.75%	1 Missing ⚠️

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Flag	Coverage Δ
unittests	98.39% <98.81%> (+0.26%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
pyrio/decorators/__init__.py	100.00% <100.00%> (ø)
pyrio/decorators/handler.py	96.00% <100.00%> (ø)
pyrio/decorators/mapper.py	100.00% <100.00%> (ø)
pyrio/exceptions/__init__.py	100.00% <100.00%> (ø)
pyrio/exceptions/exception.py	100.00% <100.00%> (ø)
pyrio/iterators/__init__.py	100.00% <100.00%> (ø)
pyrio/iterators/itertools_mixin.py	99.32% <100.00%> (ø)
pyrio/iterators/stream_generator.py	100.00% <100.00%> (ø)
pyrio/streams/__init__.py	100.00% <100.00%> (ø)
pyrio/streams/base_stream.py	98.25% <100.00%> (+0.14%)	⬆️
... and 6 more

[sourcery-ai]

🧙 Sourcery is reviewing your pull request!

---

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.