Dart Data Class Generator installs statistics

Dart Data Class Generator

Create dart data classes easily, fast and without writing boilerplate or running code generation.

Features

The generator can generate the constructor, copyWith, toMap, fromMap, toJson, fromJson, toString, operator == and hashCode methods for a class based on class properties or raw JSON.

Additionally the generator has a couple of useful quickfixes to speed up your development process. See the Additional Features Section for more.

If this extension is helpful to you, consider giving it a star on GitHub or leave a review on the Visual Studio Marketplace :heart:

Create Data Classes Based on Class Properties

Usage

You can generate data classes either by the quick fix dialog or by running a command. In the quick fix dialog you have the option to not only generate whole data classes but also only specific methods. The command has the advantage of being able to generate multiple classes at the same time.

Quick fix

• Create a class with properties.
• Place your cursor on the first line of the class, the constructor or a field.
• Hit CTRL + . to open the quick fix dialog.
• Choose one of the available options.

Command

• Create a class with properties.
• Hit CTRL + P to open the command dialog.
• Search for Dart Data Class Generator: Generate from class properties and hit enter.
• When there are multiple classes in the current file, choose the ones you'd like to create data classes of in the dialog.

It is also possible to run the generator on an existing data class (e.g. when some parameters changed). The generator will then try to find the changes and replace the class with its updated version. Note that custom changes to generated functions may be overriden.

You can also customize the generator for example to use Equatable for value equality. See the Settings section for more options.

Enums

In order for enums to be correctly serialized from and to JSON, please annotate them using a comment like so:

// enum
final Enum myEnum;

Usage with Equatable

Although using the generator is fast, it still doesn't spare you from all the boiler plate necessary, which can be visually distracting. To reduce the amount of boiler plate needed, the generator works with Equatable. Just extend the class with Equatable or mix with EquatableMixin and the generator will use Equatable for value equality.

<img width="512" src="https://github.com/huang12zheng/Dart-Data-Class-Generator/raw/HEAD/assets/equatable_demo.gif"/>

You can also use the setting dart_data_class_generator.useEquatable, if you always want to use Equatable for value equality.

Create Data Classes Based on JSON (Beta)

Usage

• Create an empty dart file.
• Paste the raw JSON without modifying it into the otherwise empty file.
• Hit CTRL + P to open the command dialog.
• Search for Dart Data Class Generator: Generate from JSON and hit enter.
• Type in a class name in the input dialog. This will be the name of the top level class if the JSON contains nested objects, all other class names will be infered from the JSON keys.
• When there are nested objects in the JSON, a dialog will be appear if you want to seperate the classes into multiple files or if all classes should be in the same file.

Note:
This feature is still in beta!
Many API's return numbers like 0 or 1 as an integer and not as a double even when they otherwise are. Thus the generator may confuse a value that is usually a double as an int.

Additional Features

The extension includes some additional quick fixes that might be useful to you:

Import refactoring

Sort imports alphabetically and bring them into the correct format easily.

<img width="512" src="https://github.com/huang12zheng/Dart-Data-Class-Generator/raw/HEAD/assets/import_demo.gif"/>

Settings

You can customize the generator to only generate the functions you want in your settings file.…