搜尋套件、儲存庫與 APP 分類

套件詳情v10.2.0

dogs_core

專注於開發體驗的通用物件映射與序列化庫。

AndroidiOSWebmacOSWindowsLinux
近 30 天下載
294
喜歡數
12
Pub 分數
140

安裝套件

flutter pub add dogs_core

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

dogs_core 是一個用於高效物件映射與序列化的 Dart 套件,重視開發者體驗(DX)。它能以最少的樣板程式碼實現 Dart 物件與 JSON 之間的無縫轉換,利用程式碼產生確保類型安全性與效能。適用於需要跨平台強大資料處理的應用程式,支援所有主要的 Flutter 目標平台,包括 Android、iOS、Web、macOS、Windows 和 Linux。該套件透過自動產生序列化邏輯,簡化了與 API 和本機資料模型的互動。

適用情境

  • API 數據解析
  • 本地狀態管理
  • 跨平台資料持久化
  • 模型轉換
  • 即時資料同步
  • 設定載入

主要特色

  • 代碼生成的序列化
  • 零執行時開銷
  • 類型安全的映射
  • 最小化樣板
  • 支援所有 Flutter 平台
  • 可擴展的註釋系統

適合對象

  • 開發者尋求快速序列化
  • 具有複雜數據模型的項目
  • 團隊優先考慮DX
  • 跨平台 Flutter 應用
  • 依賴JSON API的應用程式

使用建議

  • 需要代碼生成步驟
  • 標註的學習曲線
  • 對 build_runner 的依賴
  • 有限的執行時間自訂
  • 不適用於動態資料結構

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

Frosty Dart Object Graphs pub Build gitbook

DOGs (Dart Object Graphs) is a serialization and object-mapping library for Dart that turns your classes into introspectable, immutable, and easily validated data models across multiple formats.

Documentation | Discord | Pub Package

@serializable
class Person with Dataclass<Person> {

  @LengthRange(max: 128)
  final String name;

  @Minimum(18)
  final int age;

  @SizeRange(max: 16)
  @Regex("((_)?[a-z]+[A-Za-z0-9]*)+")
  final Set<String>? tags;

  Person(this.name, this.age, this.tags);

}
  • 🐦 Concise Define immutable dataclasses with a simple annotation and mixin. toString, equals, hashCode, and builders are generated automatically. No equatable, no copyWith, no additional boilerplate.
  • 🚀 Fast Optimized serialization and deserialization with performance on par or better than alternatives. JSON support is built in with zero extra dependencies.
  • 🧩 Extensible Replace or extend any part of the pipeline. Add new formats, validators, projections, or field converters. Works with custom Flutter types through the integration package.
  • 📦 Adaptive Multiple formats supported out of the box: JSON, YAML, TOML, CBOR. Schema generation enables dynamic use cases like server-driven forms.
  • 📚 Documented Comprehensive documentation and examples
  • ⚡ Developer-friendly All generated code goes into a single dogs.g.dart. Models remain clean and free of part directives. Builders and nullable copy methods are exposed centrally.

Format Support

  • JSON (included in dogs_core)
  • YAML pub
  • TOML pub
  • CBOR pub

Core Package pub

  • Json
    The core package comes with json support out of the box and requires no additional dependencies.

  • Builders & Nullable Copy
    We provide a nullable copy method that also works with null values, as well as autogenerated builders, similar to built_value. Both let you create immutable objects with a simple and fluent api.

  • Structures
    Every serializable class has an introspectable generated DogStructure that provides runtime access to the class's fields, annotations, factories and metadata. Together with the extensible core system, you can build powerful reflection-like functionality without the need for custom code generation or mirrors.

  • Dataclasses
    Using our dataclass mixin automatically implements toString, equals and hashCode for your serializable classes. This removes the requirement for a package like equatable or ungodly amounts of boilerplate code, that is hard to maintain and distracting.

  • Projections
    Dogs offers a powerful projection api, which enables you to transform your objects into other objects, without having to write additional boilerplate code with brittle copyWith invocations and hard coded key names.

  • Polymorphism
    Dogs supports polymorphic serialization, which enables you to serialize and deserialize objects of different types. You can even use interfaces and abstract classes as types, including Object.

  • Validation
    Using the validation api, you can easily validate your objects, without having the struggle of writing your own validation logic for most common use cases. Translation of messages and custom validators are supported as well.

  • JsonSchema-like Schema (preview)
    Dogs offers a schema generation api, which allows you to dynamically export and parse a subset of json-schema. This enables advanced dynamic uses cases such as partially server-driven forms when used in combination with the flutter integration.

Package on pub.dev
Documentation

Flutter pub

Use our flutter integration to easily create forms for any serializable object, without having to write boilerplate code. The databinding system supports all primitive field types and can easily be extended to support custom field types and layouts. This package also provides converters for commonly used flutter types, like Color, Offset, Size, Rect, etc.

Package on pub.dev
Documentation

✨ Non-Intrusive Code Generation ✨

Dogs takes a different approach to generated code. Instead of scattering part files across your models, all generated output lives in a single dogs.g.dart file at the root of your lib folder. This makes development smoother and far less error-prone. No more missing part statements or fragile imports.

Even better: your model definitions stay clean. You never need to reference generated code inside them. The only time you’ll interact with generated code directly is when using builders, which are neatly exported through the central dogs.g.dart.

This design keeps Dogs non-intrusive and future-proof. While part files may be added later for flexibility, you will never be required to reference generated code from within your model definition files.

所屬分類

依賴

依賴清單 4 項

原始碼儲存庫

使用此套件的專案

暫無相關資料。