isolate_manager 0.1.0

A plugin helps you to create multiple isolates for a function, keep it running and comunicate with it.

Isolate Manager

A plugin helps you to create multiple isolates for a function, keep it running and comunicate with it.

BASIC USAGE (Use build-in function)

There are multiple ways to use this package, the only thing to notice that the function have to be a static or top-level function to make it works.

Step 1: Create a top-level or static function

double add(dynamic value) => value[0] + value[1];

Step 2: Create IsolateManager instance for that function

IsolateManager<int> isolateManager = IsolateManager.create(numOfIsolates: 4, isolateFunction: add);

Step 3: Initialize the instance

await isolateManager.start();

Send and receive data

// add([10, 20])
final result = await isolateManager.compute([10, 20]);

You can listen to the result as stream

isolateManager.stream.listen((result) => print(result));

Build your widget with StreamBuilder

StreamBuilder(
  stream: isolateManager.stream,
  builder: (context, snapshot) {
    if (!snapshot.hasData) {
      return const Center(
        child: CircularProgressIndicator(),
      );
    }
    return Text(
        'Result of the `add` function: ${snapshot.data}');
  },
),

---

ENHANCED USAGE (Use your own function)

You can control everything with this method when you want to create multiple isolates for a function.

Step 1: Create a function of this form

// Create your own function here
void isolateFunction(dynamic params) {
  // Initial the controller for child isolate
  final controller = IsolateManagerController<double>(params);

  // Initial anything here. This area of codes only run once

  // Listen to the message receiving from main isolate
  controller.onIsolateMessage.listen((message) {
    // Do your stuff here
    final result = add(message[0], message[1]);
    
    // Send value back to your main process in stream [onMessage]
    controller.sendResult(result);
  });
}

Step 2: Create IsolateManager instance for your own function

IsolateManager<int> isolateManager = IsolateManager.createOwnIsolate(numOfIsolates: 4, isolateFunction: isolateFunction);

Now you can use everything like the above from this step

Limitation

Support web platform with limited features. The package use Future to provide the same features to Isolate.

Contributions

• This plugin as an extenstion for isolate_contactor: pub | git
• If you encounter any problems or feel the library is missing a feature, please feel free to open an issue. Pull request are also welcome.

To-do list

• Add real isolate for web platform with service-worker.js.