fpdart 0.3.0

fpdart: ^0.3.0 copied to clipboard

• Inverted onSome and onNone functions parameters in match method of Option [⚠️ BREAKING CHANGE] (Read more on why 👉 #56)

/// Everywhere you are using `Option.match` you must change this:
final match = option.match(
  (a) => print('Some($a)'),
  () => print('None'), // <- `None` second 👎 
);

/// to this (invert parameters order):
final match = option.match(
  () => print('None'), // <- `None` first 👍
  (a) => print('Some($a)'),
);

• Added traverse and sequence methods (#55)
  • traverseList
  • traverseListWithIndex
  • sequenceList
  • traverseListSeq
  • traverseListWithIndexSeq
  • sequenceListSeq

/// "a40" is invalid 💥
final inputValues = ["10", "20", "30", "a40"];

/// Verify that all the values can be converted to [int] 🔐
///
/// If **any** of them is invalid, then the result is [None] 🙅‍♂️
final traverseOption = inputValues.traverseOption(
  (a) => Option.tryCatch(
    /// If `a` does not contain a valid integer literal a [FormatException] is thrown
    () => int.parse(a),
  ),
);

• Added bindEither method in TaskEither (#58)

/// Chain [Either] to [TaskEither]
TaskEither<String, int> binding =
    TaskEither<String, String>.of("String").bindEither(Either.of(20));

• Added lefts, rights, and partitionEithers methods to Either (#57)

final list = [
  right<String, int>(1),
  right<String, int>(2),
  left<String, int>('a'),
  left<String, int>('b'),
  right<String, int>(3),
];
final result = Either.partitionEithers(list);
expect(result.first, ['a', 'b']);
expect(result.second, [1, 2, 3]);

• Added bimap method to Either, IOEither, and Tuple2 (#57)
• Added mapLeft method to IOEither (#57)
• Added fold method to Option (same as match) (#56)
• Fixed chainFirst for Either, TaskEither, and IOEither when chaining on a failure (Left) (#47) by DevNico 🎉
• Added const to all constructors in which it was missing (#59)
• Minimum environment dart sdk to 2.17.0 ⚠️

environment:
  sdk: ">=2.17.0 <3.0.0"

• Updated README and documentation

  • New tutorial articles
    • How to make API requests with validation in fpdart
    • How to use TaskEither in fpdart
    • Collection of tutorials on fpdart

• Testing improvements (internal)

  • Added testing utils
  • Added Property-based testing using glados
  • Fixed tests for match() method by adding fail in unexpected matched branch

• Contribution improvements

  • Added testing workflow with Github actions (#54)

• Refactoring for mixin breaking change (#42) by TimWhiting 🎉
• Added chainFirst method for the following classes (#39)
  • TaskEither
  • Either
  • IO
  • IOEither
  • State
  • StateAsync
  • Reader

• Added idFuture and identityFuture methods (#38) by f-person 🎉
• Added mapBoth method to Tuple2 (#30)
• Fixed linting warnings
• Fixed issue with upsert method for Map (#37) ⚠️
• Minimum environment dart sdk to 2.16.0 ⚠️

environment:
  sdk: ">=2.16.0 <3.0.0"

• Updated package linting to lints

• New methods to TaskEither, TaskOption, Either, and Option
  • mapLeft (TaskEither)
  • bimap (TaskEither)
  • toTaskEither (Either)
  • toTaskOption (Option)
• New Blog posts and tutorials section in README
  • New blog post How to map an Either to a Future in fpdart

• Completed IORef type implementation, documentation, and testing
  • Merged PR (#25) by purplenoodlesoop 🎉

• Fixed major issue in State and StateAsync implementation [BREAKING CHANGE]
  • Methods flatMap, map, map2, map3, ap, andThen, call, and flatten had an implementation issue that has been now fixed

• Released introduction to Practical Functional Programming
• Completed StateAsync type implementation, documentation, and testing
• Fixed problem with Alt typeclass (#21)
• Added call method to more easily chain functions in Monad and Monad2

• Released two new tutorials on the Option type:
  • Functional Programming Option type – Introduction
  • Chain functions using Option type – Functional Programming
• Added toJson and fromJson methods to Option to use json_serializable to convert Option type to and from Json (using @JsonSerializable)
• Added functional extension methods on Map
• Added composable Predicate type (and &, or |, not ~, xor ^) (#18)

• Released Part 3 of Fpdart, Functional Programming in Dart and Flutter
• Added Pure Functional Flutter app example (pokeapi_functional)
• Added flatMapTask and toTask methods to IO to lift and chain IO with Task
• Added flatMapTask and toTask methods to IOEither to lift and chain IOEither with TaskEither
• Added pattern matching extension methods to bool (boolean.dart)
• Added functions to get random int, double, and bool in a functional way (using IO) (random.dart)
• Added functions, extension methods, Ord, and Eq instances to DateTime (date.dart)

• Released Part 2 of Fpdart, Functional Programming in Dart and Flutter
• Added Compose and Compose2, used to easily compose functions in a chain
• Added curry and uncurry extensions on functions up to 5 parameters
• Completed TaskOption type implementation, documentation, and testing
• Expanded documentation and examples
• Added TaskEither.tryCatchK and Either.tryCatchK, by tim-smart (#10, #11) 🎉

• Released Part 1 of Fpdart, Functional Programming in Dart and Flutter
• Added functional extension methods on Iterable (List)
• Completed IOEither type implementation, documentation, and testing
• Added constF function
• Added option and optionOf (same as dartz)
• Added Either.right(r) factory constructor to Either class (same as Either.of(r)) (#3)
• Added example on reading local file using TaskEither (read_write_file)
• Added more examples
• Added constant constructors to Eq and variants, by mateusfccp (#4) 🎉

• Completed State type implementation, documentation, and testing
• Completed Reader type implementation, documentation, and testing
• Completed IO type implementation, documentation, and testing
• Merged PR (#2) by jacobaraujo7 🎉
  • Added right and left functions to create instance of Either
  • Added id function (same as identity)
  • Added fold method to Either (same as match)
  • Added bind method to Either (same as flatMap)
  • Added bindFuture method to Either, which returns TaskEither

• Completed Unit type documentation
• Completed Task type implementation, documentation, and testing
• Completed TaskEither type implementation, documentation, and testing
• Completed implementation, documentation, and testing of Foldable instance on Option and Either [BREAKING CHANGE]
• Completed Tuple2 type implementation, documentation, and testing [BREAKING CHANGE]
• Renamed fold method of Foldable to foldLeft [BREAKING CHANGE]
• Updated methods API (foldRight, foldLeft, etc.) of Foldable instances (Option, Either, Tuple) [BREAKING CHANGE]
• IList not longer working correctly (waiting for a better solution for immutable collections) [BREAKING CHANGE]

• Changed name of type Maybe to Option to be inline with fp-ts, cats, and dartz [BREAKING CHANGE]

First major release:

Types #

• Either
• IList
• Maybe
• Reader
• State
• Task
• TaskEither
• Tuple
• Unit

Typeclasses #

• Alt
• Applicative
• Band
• BoundedSemilattice
• CommutativeGroup
• CommutativeMonoid
• CommutativeSemigroup
• Eq
• Extend
• Filterable
• Foldable
• Functor
• Group
• Hash
• HKT
• Monad
• Monoid
• Order
• PartialOrder
• Semigroup
• Semilattice

Examples #

• Either
• curry
• Maybe
• Reader
• State

• Eq
• Hash
• PartialOrder