Deprecate whereNotNull from IterableNullableExtensions

CHANGELOG.md

@@ -4,6 +4,9 @@
 - Shuffle `IterableExtension.sample` results.
 - Fix `mergeSort` when the runtime iterable generic is a subtype of the static
   generic.
+- Deprecate `whereNotNull()` from `IterableNullableExtension`. Use `nonNulls`
+  instead - this is an equivalent extension available in Dart core since
+  version 3.0.
 - Require Dart `^3.1.0`
 - Mark "mixin" classes as `mixin`.
 

lib/src/iterable_extensions.dart

@@ -611,6 +611,7 @@ extension IterableNullableExtension<T extends Object> on Iterable<T?> {
   /// of this iterable, in their original iteration order.
   ///
   /// For an `Iterable<X?>`, this method is equivalent to `.whereType<X>()`.
+  @Deprecated('Use .nonNulls instead.')
   Iterable<T> whereNotNull() sync* {
     for (var element in this) {
       if (element != null) yield element;

test/extensions_test.dart

@@ -866,23 +866,6 @@ void main() {
         });
       });
     });
-    group('of nullable', () {
-      group('.whereNotNull', () {
-        test('empty', () {
-          expect(iterable(<int?>[]).whereNotNull(), isEmpty);
-        });
-        test('single', () {
-          expect(iterable(<int?>[null]).whereNotNull(), isEmpty);
-          expect(iterable(<int?>[1]).whereNotNull(), [1]);
-        });
-        test('multiple', () {
-          expect(iterable(<int?>[1, 3, 5]).whereNotNull(), [1, 3, 5]);
-          expect(iterable(<int?>[null, null, null]).whereNotNull(), isEmpty);
-          expect(
-              iterable(<int?>[1, null, 3, null, 5]).whereNotNull(), [1, 3, 5]);
-        });
-      });
-    });
     group('of number', () {
       group('.sum', () {
         test('empty', () {