glesica/dcdg.dart

⚡ Sinh biểu đồ lớp UML từ mã Dart chỉ bằng một lệnh

dart pub global run dcdg — xong.

dcdg.dart là tiện ích dòng lệnh đọc một Dart package và tự động sinh biểu đồ lớp UML (hoặc tương tự). Không cần vẽ tay, không cần copy mã vào trình chỉnh sửa đồ họa — chỉ cần chạy lệnh trong thư mục project.

✨ Điểm nổi bật

• Xuất PlantUML mặc định: kết quả mặc định là file PlantUML, có thể lưu trực tiếp qua tùy chọn -o
• Hỗ trợ Mermaid: truyền -b mermaid để xuất sang định dạng Mermaid thay vì PlantUML
• Không cấu hình phức tạp: chạy ngay trong thư mục Dart package, không cần thiết lập thêm
• Filter output: --help liệt kê các tùy chọn lọc thành phần nào xuất hiện trong biểu đồ
• Dễ mở rộng định dạng: file lib/src/builders có ví dụ triển khai định dạng DOT để tham khảo khi thêm format mới
• Test fixtures có sẵn: thư mục test/fixtures/ chứa các package Dart giả để thử nghiệm nhanh

💡 Vì sao đáng chú ý

dcdg.dart giải quyết đúng nỗi đau của lập trình viên Dart: tài liệu lớp (class diagram) nhanh lỗi thời sau mỗi lần refactor. Công cụ này sinh đồ thị trực tiếp từ mã nguồn, nên biểu đồ luôn đồng bộ với code. Việc hỗ trợ cả PlantUML và Mermaid giúp linh hoạt tích hợp vào nhiều workflow tài liệu khác nhau — từ Confluence đến README trên GitHub.

Đối với team đang duy trì package Dart lớn, dcdg.dart tiết kiệm đáng kể thời gian so với việc vẽ UML thủ công hoặc dùng công cụ đồ họa riêng. Chỉ cần một lệnh, bạn có bản đồ toàn bộ cấu trúc lớp, mối quan hệ kế thừa và phụ thuộc.

---

#UML #Dart #PlantUML #Mermaid #OpenSource #TiniX