cv 0.1.3
cv: ^0.1.3 copied to clipboard

Content Values map helpers. Define objects that can be converted to/from maps.

cv #

Content Values map helpers.

These helpers are about mapping map fields to named fields and vice versa. Key features:

  • Object to Map conversion
  • Map to Object conversion
  • No code generation
  • All objects are mutable
  • Deals with null and undefined values
  • Field type is final and strongly enforced
  • All fields have final key and mutable values


  • A field value must be access through a getter (value or v)

Usage #

A model can define by defining fields in the following way:

import 'package:cv/cv.dart';

class Note extends CvModelBase {
  final title = CvField<String>('title');
  final content = CvField<String>('content');
  final date = CvField<DateTime>('date');

  /// List of the fields of the model
  List<CvField> get fields => [title, content, date];

You can convert the object to a map:

var note = Note()
  ..title.v = 'My note'
  ..content.v = 'My note context' = DateTime(2021, 08, 16);
expect(note.toMap(), {
  'title': 'My note',
  'content': 'My note context',
  'date': DateTime(2021, 08, 16)

and from a map:

var note = Note();
  'title': 'My note',
  'content': 'My note context',
  'date': DateTime(2021, 08, 16)
expect(note.title.v, 'My note');

For convenience, extension on Map are created to simply call .cv<Type>() on map to convert them to object:

// Add the builder once
cvAddBuilder<Note>((_) => Note());

// Any map can be converted to a note object
var note = {'title': 'My note'}.cv<Note>();
expect(note.title.v, 'My note');

Why #

  • Relying on code generator always adds a level of build complexity (and build failure risk).
  • No setup needed other than adding the package
  • Having mutable values can lead to more mistakes though. But well, you know what your are doing and it is convenient
  • In Java, I used to like ContentValues in Android, having a little more control than a regular HashMap.
  • In Java, I also used to like Gson for its simplicity: just define a class.

Git setup #

Usage #

In your pubspec.yaml:

      url: git://
      ref: null_safety
      path: packages/cv
    version: '>=0.1.0'
pub points

Content Values map helpers. Define objects that can be converted to/from maps.

Repository (GitHub)
View/report issues


API reference


BSD-2-Clause (LICENSE)


collection, meta


Packages that depend on cv