dart_either

https://pub.dev/packages/dart_either/versions/2.1.0

• Promoted Either.parSequenceN and Either.parTraverseN from experimental to stable.
• Added complete API docs and examples for Either.parSequenceN and Either.parTraverseN.
• Added unit tests for Either.parSequenceN and Either.parTraverseN, including concurrency-limit and short-circuit cases.
• Added @useResult annotations to public APIs that should not be ignored (for example: isLeft, isRight, map, flatMap, swap, exists, all, toEitherStream, left, right, and others).

API migration notes

• Either.parSequenceN changed from positional parameters to named parameters:

  // Before (2.0.0)
  Either.parSequenceN<String, int>(functions, n);
  
  // Now (2.1.0)
  Either.parSequenceN<String, int>(
    functions: functions,
    maxConcurrent: n,
  );

• Either.parTraverseN changed from positional parameters to named parameters:

  // Before (2.0.0)
  Either.parTraverseN<String, int, int>(values, mapper, n);
  
  // Now (2.1.0)
  Either.parTraverseN<String, int, int>(
    values: values,
    mapper: mapper,
    maxConcurrent: n,
  );

• maxConcurrent controls concurrency.
  • Pass a number (for example 2) to limit concurrency.
  • Pass null for unlimited concurrency.

• Promoted Either.parSequenceN and Either.parTraverseN from experimental to stable.
• Added complete API docs and examples for Either.parSequenceN and Either.parTraverseN.
• Added unit tests for Either.parSequenceN and Either.parTraverseN, including concurrency-limit and short-circuit cases.
• Added @useResult annotations to public APIs that should not be ignored (for example: isLeft, isRight, map, flatMap, swap, exists, all, toEitherStream, left, right, and others).

API migration notes

• Either.parSequenceN changed from positional parameters to named parameters:

  // Before (2.0.0)
  Either.parSequenceN<String, int>(functions, n);
  
  // Now (2.1.0)
  Either.parSequenceN<String, int>(
    functions: functions,
    maxConcurrent: n,
  );
  

• Either.parTraverseN changed from positional parameters to named parameters:

  // Before (2.0.0)
  Either.parTraverseN<String, int, int>(values, mapper, n);
  
  // Now (2.1.0)
  Either.parTraverseN<String, int, int>(
    values: values,
    mapper: mapper,
    maxConcurrent: n,
  );
  

• maxConcurrent controls concurrency.
  • Pass a number (for example 2) to limit concurrency.
  • Pass null for unlimited concurrency.

https://pub.dev/packages/dart_either/versions/2.0.0

• Require Dart 3.0.0 or higher >=3.0.0 <4.0.0.

• Make Either a sealed class, EitherEffect a sealed class, and ControlError a final class.
  Now you can use exhaustive switch expressions on Either instances.

  final Either<String, int> either = Either.right(10);
  
  // Use the `when` method to handle
  either.when(
    ifLeft: (l) => print('Left: $l'),
    ifRight: (r) => print('Right: $r'),
  ); // Prints Right: Either.Right(10)
  
  // Or use Dart 3.0 switch expression syntax 🤘
  print(
    switch (either) {
      Left() => 'Left: $either',
      Right() => 'Right: $either',
    },
  ); // Prints Right: Either.Right(10)

What's Changed

• chore(deps): update codecov/codecov-action action to v3.1.1 by @renovate in #11
• chore(deps): update dart-lang/setup-dart action to v1.4 by @renovate in #12
• chore(deps): update codecov/codecov-action action to v3.1.2 by @renovate in #13
• chore(deps): update codecov/codecov-action action to v3.1.6 by @renovate in #14
• fix(deps): update dependency http to v1 - autoclosed by @renovate in #15
• chore(deps): update actions/checkout action to v4 by @renovate in #17
• chore(deps): update codecov/codecov-action action to v4 by @renovate in #19
• dart 3.0.0, switch expression, sealed class by @hoc081098 in #23

Full Changelog: 1.0.0...2.0.0

• Require Dart 3.0.0 or higher >=3.0.0 <4.0.0.

• Make Either a sealed class, EitherEffect a sealed class, and ControlError a final class. Now you can use exhaustive switch expressions on Either instances.

  final Either<String, int> either = Either.right(10);
  
  // Use the `when` method to handle
  either.when(
    ifLeft: (l) => print('Left: $l'),
    ifRight: (r) => print('Right: $r'),
  ); // Prints Right: Either.Right(10)
  
  // Or use Dart 3.0 switch expression syntax 🤘
  print(
    switch (either) {
      Left() => 'Left: $either',
      Right() => 'Right: $either',
    },
  ); // Prints Right: Either.Right(10)
  

https://pub.dev/packages/dart_either/versions/1.0.0

• This is our first stable release.

Full Changelog: 0.0.1...1.0.0

• This is our first stable release.

Full Changelog: 1.0.0-beta05...1.0.0-beta06

Full Changelog: 1.0.0-beta04...1.0.0-beta05

What's Changed

• refactor impl by @hoc081098 in #10

Full Changelog: 1.0.0-beta03...1.0.0-beta04

TBD
Full Changelog: 1.0.0-beta02...1.0.0-beta03

TBD
Full Changelog: 1.0.0-beta01...1.0.0-beta02

TBD

Full Changelog: 0.0.1...1.0.0-beta01

0.0.1 - Apr 27, 2021

• Initial version, created by Stagehand

• Initial version, created by Stagehand