eventified_generator 0.1.1 copy "eventified_generator: ^0.1.1" to clipboard
eventified_generator: ^0.1.1 copied to clipboard

Transform method calls to a stream of events.

Eventified #

Transform method calls to a stream of events.

Getting started #

Add these dependencies to your pubspec.yaml file:

dependencies:
  eventified: 

dev_dependencies:
  build_runner:
  eventified_generator: 

Usage #

1. Declaring methods #

Start by declaring a class which defines a set of public methods, with a set of arguments. Annotate this class with the @eventified annotation.

Add a part 'example.g.dart'; declaration at the top of your file.

The return type of the methods must be void.

import 'package:eventified/eventified.dart';

part 'example.g.dart';

@eventified
abstract class Example {
  void hello({
    required bool world,
    String? name,
  });

  void world(String name);
}

2. Generate event classes and the stream implementation. #

Run the build runner in your project by running this command line:

dart run build_runner build

If you are using flutter, use flutter pub run build_runner build instead.

3. Use implementation #

/// Create an instance from the `Streamed` generated implementation. 
final streamed = StreamedExample();

/// Listen for events from the `stream`.
streamed.stream.listen((event) {
print(event);
});

/// Call methods to trigger corresponding events.
streamed
..hello(world: false, name: 'Jeff')
..world('john');

/// The previous calls prints this to console :
///
/// HelloExampleEvent(
///   world : false,
///   name : Jeff,
/// )
/// WorldExampleEvent(
///   name : john,
/// )

/// Closes the underlying stream.
streamed.dispose();

Advanced usage #

The generated classes and behaviours can be customized with annotations.

Custom event names #

You can set a baseEvent name, and specific event names.

@Eventified(baseEvent: 'MyEvent')
abstract class ExampleCustomEventNames {
  @Event(name: 'HelloEvent')
  void hello({
    required bool world,
    String? name,
  });

  @Event(name: 'WorldEvent')
  void world(String name);
}

Add metadata #

You can generate a $metadata property which allows to reflects the event and its arguments at runtime. This might be particularly useful for serialization purpose.

@Eventified(metadata: true)
abstract class Example {
  void hello({
    required bool world,
    String? name,
  });

  void world(String name);
}

The metadata keys can also be customized independently with Event and EventArgument annotations.

@Eventified(metadata: true)
abstract class Example {
  @Event(metadata: 'Hello')
  void hello({
    required bool world,
    @EventArgument(metadata: 'Name') String? name,
  });

  void world(String name);
}

Examples #

See the example project.

0
likes
100
pub points
32%
popularity

Publisher

unverified uploader

Transform method calls to a stream of events.

Repository (GitHub)
View/report issues

Documentation

API reference

License

MIT (LICENSE)

Dependencies

analyzer, build, code_builder, dart_style, eventified, recase, source_gen

More

Packages that depend on eventified_generator