Migrate from provider to context_plus

[passsy]

I'd like to have a quick small guide how to migrate from provider to context_plus.

Basic usage works, but I'd like to know if I can migrate more advanced topics like ProxyProvider or sub scopes.

[s0nerik]

I've almost finished the site with various usage examples. Hopefully, I'll publish it towards the end of the next week. Will let you know.

Regarding the migration, there won't be 1:1 correspondence, but I believe context_plus supports the same amount of usecases as Provider, or maybe even more.

You can:

• Create value eagerly and have it auto-disposed via .bind() (~Provider(lazy: false)
• Create value lazily and have it auto-disposed via .bindLazy() (~Provider(lazy: true)
• Provide an already created value via .bindValue() (~ValueProvider)
• Provide a value based on other values via .bind(key: ), .bindLazy(key: ) (~ProxyProvider). Example:

  final value1 = value1Listenable.watch(context);
  final value2 = value2Listenable.watch(context);
  final value3 = _value3Ref.bind(
    context,
    () => Value3(value1, value2),
    key: (value1, value2),
  );

  Now, whenever value1 or value2 changes, the Value3 will get recreated. Works more-or-less like keys on widgets.
• Track asynchronous operations state outside the widget tree with AsyncListenable and provide it either via Ref<AsyncListenable>.bind() or as a part of some other object.

Also, Ref<AnimationController> and a couple of other types of refs provide an additional vsync parameter so that you can create and bind them easily as well.

The whole API is intentionally kept minimal-ish:

Ref.bind() - create eagerly, then bind
Ref.bindLazy() - bind, then create lazily upon first request
Ref.bindValue() - just bind
(Stream/Future/Listenable/ValueListenable/AsyncListenable/Ref<Stream>/Ref<Future>/Ref<Listenable>/Ref<ValueListenable>/Ref<AsyncListenable>/...).watch() - rebuild on any notification
(Stream/Future/Listenable/ValueListenable/AsyncListenable/Ref<Stream>/Ref<Future>/Ref<Listenable>/Ref<ValueListenable>/Ref<AsyncListenable>/...).watchOnly() - rebuild only when selected value changes upon notification

Hope that helps. Stay tuned for the site, I love how it pans out so far.

[s0nerik]

@yousefak007 I've created a separate issue to track the potential Ref.bindProxy() implementation. Feel free to comment there: #16