redux 4.0.0

  • Readme
  • Changelog
  • Example
  • Installing
  • 99

redux.dart #

Build Status codecov

Redux for Dart using generics for typed State. It includes a rich ecosystem of Docs, Middleware, Dev Tools and can be combined with Flutter using the flutter_redux package.

Docs #

  • Motivation and Principles - Learn why Redux might make sense for your app and the principles behind it.
  • Basics - Introduction to the core concepts in Redux
  • Combining Reducers - combineReducers works a bit differently in Dart than it does in JS. Learn why, and how to combine reducers in a type-safe way!
  • Async with Middleware - Learn how to make async calls, such as to a web service or local database, with Redux.
  • Use Selectors to Query Data in the Store - Learn how to write functions to provide consistent access to data in your App State.
  • API Documentation - Rich documentation included in the source code and generated by DartDoc.

Flutter Examples #

To integrate Redux.dart with Flutter, please use the flutter_redux package.

Beginner #

Intermediate #

Advanced #

Web Examples #

See the example/ directory for a few simple examples of the basics of Redux.

To launch the examples in your browser:

  1. Run pub serve example from this directory
  2. Open http://localhost:8080

Middleware #

  • redux_logging - Connects a Logger to a Store, and can print out actions as they're dispatched to your console.
  • redux_thunk - Allows you to dispatch functions that perform async work as actions.
  • redux_future - For handling Dart Futures that are dispatched as Actions.
  • redux_epics - Middleware that allows you to work with Dart Streams of Actions to perform async work.

Dev Tools #

The redux_dev_tools library allows you to create a DevToolsStore during dev mode in place of a normal Redux Store.

This DevToolsStore will act exactly like a normal Store at first. However, it will also allow you to travel back and forth throughout the States of your app or recompute the State of your app by replaying all actions through your reducers. This works perfectly with Hot Reloading!

You can combine the DevToolsStore with your own UI to travel in time, or use one of the existing options for the platform you're working with:

Additional Utilities #

  • reselect - Efficiently derive data from your Redux Store with memoized functions.
  • redux_persist - Persist Redux State, works for Web and Flutter

Usage #

import 'package:redux/redux.dart';

// Create typed actions. You will dispatch these in order to
// update the state of your application.
enum Actions {
  increment,
  decrement,
}

// Create a Reducer. A reducer is a pure function that takes the 
// current State (int) and the Action that was dispatched. It should
// combine the two into a new state without mutating the state passed
// in! After the state is updated, the store will emit the update to 
// the `onChange` stream.
// 
// Because reducers are pure functions, they should not perform any 
// side-effects, such as making an HTTP request or logging messages
// to a console. For that, use Middleware.
int counterReducer(int state, action) {
  if (action == Actions.increment) {
    return state + 1;
  } else if (action == Actions.decrement) {
    return state - 1;
  }
  
  return state;
}

// A piece of middleware that will log all actions with a timestamp
// to your console!
// 
// Note, this is just an example of how to write your own Middleware.
// See the redux_logging package on pub for a pre-built logging 
// middleware.
loggingMiddleware(Store<int> store, action, NextDispatcher next) {
  print('${new DateTime.now()}: $action');

  next(action);
}

main() {
  // Create the store with our Reducer and Middleware
  final store = new Store<int>(
    counterReducer, 
    initialState: 0, 
    middleware: [loggingMiddleware],
  );

  // Render our State right away
  render(store.state);
  
  // Listen to store changes, and re-render when the state is updated
  store.onChange.listen(render);

  // Attach a click handler to a button. When clicked, the `INCREMENT` action
  // will be dispatched. It will then run through the reducer, updating the 
  // state.
  //
  // After the state changes, the html will be re-rendered by our `onChange`
  // listener above. 
  querySelector('#increment').onClick.listen((_) {
    store.dispatch(Actions.increment);
  });
}

render(int state) {
  querySelector('#value').innerHtml = '${state}';
}

4.0.0 #

  • dispatch returns the provided action
  • Removed Dart 1.x support
  • Enforce Pedantic package lint rules
  • Enforce public_member_api_docs lint rule and add docs to missing parts
  • Update travis.yml with support for dartfmt, analysis, and code coverage
  • Add coverage badge to root README
  • Pub.dev updates
    • Longer description
    • https for package url
    • update example folder to include README

3.0.1 #

  • Update README based on feedback

3.0.0 #

  • Dart 2 support
  • Remove ReducerBinding, use TypedReducer
  • Remove combineTypedReducer. Use combineReducers with normal reducers & TypedReducers.
  • Remove MiddlewareBinding, use TypedMiddleware.
  • Remove combineTypedMiddleware -- no longer needed! Just create a normal List<Middleware<State>>!

2.1.1 #

  • Ensure the repo is 100% healthy.

2.1.0 #

  • Add the distinct option. If set to true, the Store will not emit onChange events if the new State that is returned from your [reducer] in response to an Action is equal to the previous state. False by default.

2.0.4 #

  • Use absolute urls to fix broken links in documentation on Pub.

2.0.3 #

  • Add MOAR documentation

2.0.2 #

  • Add type-safe combineTypedReducers and combineTypedMiddleware functions

2.0.1 #

  • Add documentation highlighting the redux ecosystem

2.0.0 #

  • Breaking API Changes:
    • Reducer is now a typedef. Use ReducerClass<State> if you'd like to continue to use a class interface.
    • Middleware is now a typedef. Use MiddlewareClass<State> as a replacement for the old Middleware<State, Action>
    • A teardown method has been added. Use it to shut down the store in the middle of your application lifecycle if you no longer need the store.
  • Added more docs

example/README.md

Examples #

  • Counter example - an example of how to search as a user types, demonstrating both the Middleware and Epic approaches.
  • Middleware example - an example of how to search as a user types, demonstrating both the Middleware and Epic approaches.
  • Combining Reducers example - a port of the standard "Counter Button" example from Flutter

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:


dependencies:
  redux: ^4.0.0

2. Install it

You can install packages from the command line:

with pub:


$ pub get

with Flutter:


$ flutter pub get

Alternatively, your editor might support pub get or flutter pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


import 'package:redux/redux.dart';
  
Popularity:
Describes how popular the package is relative to other packages. [more]
98
Health:
Code health derived from static analysis. [more]
100
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
100
Overall:
Weighted score of the above. [more]
99
Learn more about scoring.

We analyzed this package on Dec 6, 2019, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

  • Dart: 2.6.1
  • pana: 0.12.21

Platforms

Detected platforms: Flutter, web, other

No platform restriction found in primary library package:redux/redux.dart.

Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=2.0.0 <3.0.0
Dev dependencies
coverage >=0.13.0 <0.14.0
pedantic >=1.8.0+1 <2.0.0
test >=1.0.0 <2.0.0