Merge pull request #47 from I-RzR-I/feature/IndexEnumerable

Feature/index enumerable

Author: I-RzR-I

docs/CHANGELOG.md

@@ -1,3 +1,7 @@
+### **v4.5.0.7408** [[RzR](mailto:108324929+I-RzR-I@users.noreply.github.com)] 11-02-2026
+* [a4fd120] (RzR) -> Auto commit uncommited files
+* [bae196d] (RzR) -> Add enumerable method `SelectWithIsLast` and `WithObservable`
+
 ### **v4.4.0.8476** [[RzR](mailto:108324929+I-RzR-I@users.noreply.github.com)] 19-01-2026
 * [0b54e4a] (RzR) -> Add `T` extension methods: `GetPropertyValue`, `GetPropertyStringValue`, `GetPropertyValue`, `ChangePropertyValue`.
 * [ee95f35] (RzR) -> Add `string` extension methods: `RemoveStartChars`, `RemoveEndChars`.

src/DomainCommonExtensions/ArraysExtensions/EnumerableExtensions.cs

@@ -856,5 +856,78 @@ public static bool HasAny<TSource>(this IEnumerable<TSource> source, Func<TSourc
 
             return false;
         }
+
+        /// -------------------------------------------------------------------------------------------------
+        /// <summary>
+        ///     Is last.
+        /// </summary>
+        /// <typeparam name="T">Generic type parameter.</typeparam>
+        /// <param name="source">The source enumerator.</param>
+        /// <remarks>
+        ///     Using this method, the enumerator will advance.
+        /// </remarks>
+        /// <returns>
+        ///     True if last, false if not.
+        /// </returns>
+        /// =================================================================================================
+        public static bool IsLast<T>(this IEnumerator<T> source)
+        {
+            if (source.IsNull())
+                return true;
+
+            return source.MoveNext().IsFalse();
+        }
+
+        /// -------------------------------------------------------------------------------------------------
+        /// <summary>
+        ///     Is last.
+        /// </summary>
+        /// <typeparam name="TKey">Type of the key.</typeparam>
+        /// <typeparam name="TValue">Type of the value.</typeparam>
+        /// <param name="source">The source enumerator.</param>
+        /// <remarks>
+        ///     Using this method, the enumerator will advance.
+        /// </remarks>
+        /// <returns>
+        ///     True if last, false if not.
+        /// </returns>
+        /// =================================================================================================
+        public static bool IsLast<TKey, TValue>(
+            this IEnumerator<KeyValuePair<TKey, TValue>> source)
+        {
+            if (source.IsNull())
+                return true;
+
+            return source.MoveNext().IsFalse();
+        }
+
+        /// -------------------------------------------------------------------------------------------------
+        /// <summary>
+        ///     Enumerates select with is last in this collection.
+        /// </summary>
+        /// <typeparam name="T">Generic type parameter.</typeparam>
+        /// <param name="source">The source for this extension method.</param>
+        /// <returns>
+        ///     An enumerator that allows foreach to be used to process select with is last in this
+        ///     collection.
+        /// </returns>
+        /// =================================================================================================
+        public static IEnumerable<TupleResult<T, bool>> SelectWithIsLast<T>(
+            this IEnumerable<T> source)
+        {
+            using var e = source.GetEnumerator();
+            if (e.MoveNext().IsFalse())
+                yield break;
+
+            var current = e.Current;
+
+            while (e.MoveNext())
+            {
+                yield return TupleResult.Create(current, false);
+                current = e.Current;
+            }
+
+            yield return TupleResult.Create(current, true);
+        }
     }
 }

src/DomainCommonExtensions/ArraysExtensions/ObservableEnumeratorExtensions.cs

@@ -0,0 +1,77 @@
+// ***********************************************************************
+//  Assembly         : RzR.Shared.Extensions.DomainCommonExtensions
+//  Author           : RzR
+//  Created On       : 2026-01-28 22:01
+// 
+//  Last Modified By : RzR
+//  Last Modified On : 2026-02-11 20:07
+// ***********************************************************************
+//  <copyright file="ObservableEnumeratorExtensions.cs" company="RzR SOFT & TECH">
+//   Copyright © RzR. All rights reserved.
+//  </copyright>
+// 
+//  <summary>
+//  </summary>
+// ***********************************************************************
+
+#region U S A G E S
+
+using System;
+using System.Collections.Generic;
+using DomainCommonExtensions.Collections;
+using DomainCommonExtensions.Utilities.Ensure;
+
+#endregion
+
+namespace DomainCommonExtensions.ArraysExtensions
+{
+    /// -------------------------------------------------------------------------------------------------
+    /// <summary>
+    ///     An observable enumerator extensions.
+    /// </summary>
+    /// =================================================================================================
+    public static class ObservableEnumeratorExtensions
+    {
+        /// -------------------------------------------------------------------------------------------------
+        /// <summary>
+        ///     An IEnumerable&lt;T&gt; extension method that convert to observable.
+        /// </summary>
+        /// <exception cref="ArgumentNullException">
+        ///     Thrown when one or more required arguments are null.
+        /// </exception>
+        /// <typeparam name="T">Generic type parameter.</typeparam>
+        /// <param name="source">The source to act on.</param>
+        /// <returns>
+        ///     An ObservableEnumerator&lt;T&gt;
+        /// </returns>
+        /// =================================================================================================
+        public static ObservableEnumerator<T> WithObservable<T>(
+            this IEnumerable<T> source)
+        {
+            DomainEnsure.IsNotNull(source, nameof(source));
+
+            return new ObservableEnumerator<T>(source);
+        }
+
+        /// -------------------------------------------------------------------------------------------------
+        /// <summary>
+        ///     An IEnumerable&lt;T&gt; extension method that convert to observable.
+        /// </summary>
+        /// <exception cref="ArgumentNullException">
+        ///     Thrown when one or more required arguments are null.
+        /// </exception>
+        /// <typeparam name="T">Generic type parameter.</typeparam>
+        /// <param name="enumerator">The enumerator to act on.</param>
+        /// <returns>
+        ///     An ObservableEnumerator&lt;T&gt;
+        /// </returns>
+        /// =================================================================================================
+        public static ObservableEnumerator<T> WithObservable<T>(
+            this IEnumerator<T> enumerator)
+        {
+            DomainEnsure.IsNotNull(enumerator, nameof(enumerator));
+
+            return new ObservableEnumerator<T>(enumerator);
+        }
+    }
+}

src/DomainCommonExtensions/Collections/IndexableEnumerable.cs

@@ -113,6 +113,16 @@ public IndexableEnumerable(List<T> list)
             : this((IList<T>)list)
         { }
 
+        /// -------------------------------------------------------------------------------------------------
+        /// <summary>
+        ///     Initializes a new instance of the <see cref="IndexableEnumerable{T}"/> class.
+        /// </summary>
+        /// <param name="list">(Immutable) the list.</param>
+        /// =================================================================================================
+        public IndexableEnumerable(IEnumerable<T> list)
+            : this((IList<T>)list)
+        { }
+
         /// -------------------------------------------------------------------------------------------------
         /// <summary>
         ///     Initializes the index enumerable.
@@ -145,6 +155,17 @@ public IndexableEnumerable(List<T> list)
         /// </returns>
         /// =================================================================================================
         public static IIndexableEnumerable<T> Initialize(List<T> list) => new IndexableEnumerable<T>(list);
+
+        /// -------------------------------------------------------------------------------------------------
+        /// <summary>
+        ///     Initializes the index enumerable.
+        /// </summary>
+        /// <param name="list">(Immutable) the list.</param>
+        /// <returns>
+        ///     An IIndexableEnumerable&lt;T&gt;
+        /// </returns>
+        /// =================================================================================================
+        public static IIndexableEnumerable<T> Initialize(IEnumerable<T> list) => new IndexableEnumerable<T>(list);
 
         /// <inheritdoc />
         public T this[int index] => _list[index];