Git Product home page Git Product logo

event_kit's Introduction

event_kit

This is a simple library for implementing event subscription APIs. This project is inspired by event-kit.

Build Status Coverage Status

Implementing Event Subscription APIs

import 'package:event_kit/event_kit.dart';

class User {
  final Emitter<String> _emitter = new Emitter<String>();

  String _name = '';

  Disposable onDidChangeName(void handler(String name)) =>
      _emitter.on('did-change-name', handler);

  void set name(String name) {
    if (_name != name) {
      _name = name;
      _emitter.emit('did-change-name', [name]);
    }
  }
}

In the example above, we implement onDidChangeName on the user object, which will register callbacks to be invoked whenever the user's name changes. To do so, we make use of an internal Emitter instance. We use on to subscribe the given callback in onDidChangeName, and emit in setName to notify subscribers. Finally, when the User instance is destroyed we call dispose on the emitter to unsubscribe all subscribers.

Consuming Event Subscription APIs

Emitter.on returns a Disposable instance, which has a dispose method. To unsubscribe, simply call dispose on the returned object.

import 'package:event_kit/event_kit.dart';

var subscription = user.onDidChangeName((name) => print('My name is ${name}'));
// Later, to unsubscribe...
subscription.dispose();

You can also use CompositeDisposable to combine disposable instances together.

import 'package:event_kit/event_kit.dart';

var subscriptions = new CompositeDisposable();
subscriptions.add(user1.onDidChangeName((name) => print('User 1: ${name}')));
subscriptions.add(user2.onDidChangeName((name) => print('User 2: ${name}')));

// Later, to unsubscribe from *both*...
subscriptions.dispose();

Features and bugs

Please file feature requests and bugs at the issue tracker.

event_kit's People

Contributors

dynaxis avatar

Stargazers

Kwang Yul Seo avatar Vitaliy Vostrikov avatar

Watchers

James Cloos avatar Kwang Yul Seo avatar

event_kit's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.