attributable 0.1.2

  • Installing
  • Versions
  • 54


Allows you to easily define getters/setters for attributes on your class and invoke callbacks when those attributes change.


A simple example may look like this:

import 'package:attributable';

class Button extends Object with Attributable {

  final List attribute_names = ['caption', 'color', 'enabled'];

  final Map attribute_callbacks = {
    'default' : (attr_name, self) => print("Attribute $attr_name now has a new value: ${self.attributes[attr_name]}"), 
    'caption' : (attr_name, self) => print("Caption is now '${self.caption}'"), 
    'enabled' : (attr_name, self) => print("Enabled is now set to '${self.enabled}'") 

  // Don't forget noSuchMethod() definition here (see below) or it won't work!


The default callback is invoked if no other callback for the given attribute is defined. Obviously, you may omit it, so nothing happens when your attribute changes.

So now we can create instances of our class and set attributes on them:

main() {

  var button = new Button();

  button.caption = "New caption"; // => Caption is now 'New caption' 
  button.enabled = true;          // => Enabled is now set to 'true' 
  button.color   = 'green';       // => Attribute color now has a new value: green


There's also a method which allows updating many attributes all at once:

button.updateAttributes({ 'caption': 'New caption', 'color': 'green'});

Needless to say, callbacks will also be invoked for the attributes listed. The updateAttributes() is slightly more powerful, see documenation to learn more.

IMPORTANT: at this point, in order for this to work, it is not enough to simply mix this abstract class into your class, you also have to define noSuchMethod() callback manually in your class, so that it looks something like the following:

noSuchMethod(Invocation i) {  
  try {
    return prvt_noSuchGetterOrSetter(i);
  } on NoSuchAttributeException {

The Invocation object gets passed into the prvt_noSuchGetterOrSetter(i) which then checks if any attribute with such a name are defined on the class. If not, then we return control to your class and it gets to call its original noSuchMethod() method, which, most likely, will generate an exception. Of course, if your class has its own noSuchMethod() functionality, you'd have take it into account and construct the method accordingly.

See /example/button.dart for an example (you can run it from the terminal).

1. Depend on it

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

  attributable: "^0.1.2"

2. Install it

You can install packages from the command line:

with pub:

$ pub get

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

3. Import it

Now in your Dart code, you can use:

import 'package:attributable/attributable.dart';
Version Uploaded Documentation Archive
0.1.2 Mar 27, 2017 Go to the documentation of attributable 0.1.2 Download attributable 0.1.2 archive
0.1.1 Oct 9, 2016 Go to the documentation of attributable 0.1.1 Download attributable 0.1.1 archive
0.1.0 May 20, 2016 Go to the documentation of attributable 0.1.0 Download attributable 0.1.0 archive


We analyzed this package on Apr 23, 2018, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

  • Dart: 2.0.0-dev.49.0
  • pana: 0.10.6


Describes how popular the package is relative to other packages. [more]
31 / 100
Code health derived from static analysis. [more]
79 / 100
Reflects how tidy and up-to-date the package is. [more]
74 / 100
Overall score:
Weighted score of the above. [more]
Learn more about scoring.


Detected platforms: web, other

Primary library: package:attributable/attributable.dart with components: mirrors.


  • Maintain

    Changelog entries help clients to follow the progress in your code.

  • Fix analysis and formatting issues.

    Analysis or formatting checks reported 4 warnings 1 hint.

    Strong-mode analysis of lib/attributable.dart gave the following warning:

    line: 73 col: 7
    Functions can't include return statements both with and without values.

  • Package is pre-v1 release.

    While there is nothing inherently wrong with versions of 0.*.*, it usually means that the author is still experimenting with the general direction API.

  • Maintain an example.

    Create a short demo in the example/ directory to show how to use this package. Common file name patterns include: main.dart, example.dart or you could also use attributable.dart.


Package Constraint Resolved Available
Dev dependencies
test >=0.12.0