property_map 0.0.16

PropertyMap allows you to quickly implement property bags in dart. It consists of 2 main classes: PropertyMap and PropertyList. PropertyMap is a wrapper around Map<String, dynamic>. PropertyList is a [...]

property_map

Introduction

PropertyMap allows you to quickly implement property bags in dart. It consists of 2 main classes: PropertyMap and PropertyList.

PropertyMap is a wrapper around Map<String, dynamic>. PropertyList is a wrapper around List

By default, they can only take simple objects (as defined in dart:json) and Serializable objects. The configuration object passed to the constructor allows you to modify this behavior if needed.

Features

• Rapid implementation of property bags.
• Can restrict contents to simple types (as defined in dart:json) and Serializable objects. This is the default.

Getting Started

1. Add the following to your project's pubspec.yaml and run pub install.

dependencies:
  property_map:
    git: https://github.com/sethillgard/property_map.git

2. Add the correct import for your project.

import 'package:property_map/property_map.dart';

Example

1. Initialize an AssetManager:

main() {
  // Create a PropertyMap
  var data = new PropertyMap();

  // Just add properties.
  data.name = "Daniel";
  data.age = 25;

  // [] works too, if you prefer it.
  data['phone'] = "621-222-1155";

  // Add a List. It will be automatically converted to a PropertyList 
  // (recursively).
  data.enemies = ['Lucia', 'John', 'Alex'];

  // But exposes the same API.
  data.enemies.add('Susan');

  // Maps are converted to PropertyMaps (also recursively).
  data.games = {'important': true, 'fun':true, 'numberOwned':9999};

  // You can simply keep adding properties to nested maps.
  data.games.favorites = ['Braid', 'Portal'];
  
  // Add nested maps and lists. Values get validated and converted automatically.
  data.test = {'a':{'b':[0,1,2]}};

  // Read values.
  print(data.name);				    // Daniel
  print(data.games.favorites[0]);	// Braid
  print(data.test.a.b[1]);	        // 1

  // Serialize them all.
  print(data.toJson());
}