dartool 0.1.0

A Hutool-style toolkit for Dart: strings, collections, dates, regex, validation, conversion and more.

dartool

A Hutool-style toolkit for Dart -- simple, unified and out-of-the-box.

dartool is the pure-Dart core package of the dartool project. It has zero Flutter dependencies, so it works in both Flutter apps and pure Dart CLI / server projects. Inspired by Hutool, it follows the philosophy of "one method for one problem -- modular, on-demand, no bloat."

Features

• Modular -- pick only what you need, no unnecessary dependencies
• Pure Dart -- zero Flutter dependency, usable in CLI and server projects
• Unified API -- consistent naming, friendly parameters, ready to use
• Well tested -- unit tests for every core module
• Dart 3 + null-safe -- built on Dart 3.9 SDK with lints

Installation

dependencies:
  dartool: ^0.1.0-dev.2

dart pub get

Quick Start

import 'package:dartool/dartool.dart';

void main() {
  // String utilities
  print(StrUtil.isBlank('   '));               // true
  print(StrUtil.toCamelCase('hello_world'));   // helloWorld

  // Collection utilities
  print(CollectionUtil.isEmpty([]));            // true
  print(CollectionUtil.distinct([3, 1, 2, 1]));   // [3, 1, 2]

  // Date utilities
  print(DateUtil.formatNow());                  // 2026-09-21 12:00:00

  // Validation utilities
  print(ValidateUtil.isEmail('[e-mail]'));       // true
  print(ValidateUtil.isPhone('13800138000'));   // true

  // ID generation
  print(IdUtil.uuid());                         // xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

  // Color utilities
  print(ColorUtil.toHex(0xFF4080FF));           // #4080FF
  print(ColorUtil.hexToInt('#4080ff'));         // 0xFF4080FF

  // Crypto utilities
  print(CryptoUtil.md5('hello'));               // 5d41402abc4b2a76b9719d911017c592
  print(CryptoUtil.base64Encode('hello'));      // aGVsbG8=

  // Result container
  final r = Result.success('ok');
  print(r.isSuccess);                           // true

  // Optional container
  final op = Optional.of('hello');
  print(op.getOrElse('default'));                 // hello
}

API Overview

Class	Description
StrUtil	String blank checks, case conversion, trimming, truncation, camel/snake conversion
CollectionUtil	Collection empty checks, dedup, pagination, flatten, grouping
DateUtil	Formatting, parsing, timestamp conversion, relative time, timezones
RegexUtil	Common regex patterns (phone, email, URL, ID card) and matchers
EnumUtil	Enum name/value resolution, iteration
ValidateUtil	Data validation (non-null, email, phone, ID card, range)
ConvertUtil	Type conversion (String <-> num <-> bool <-> DateTime) with fallbacks
IdUtil	UUID, snowflake ID, short unique ID generation
ColorUtil	Color conversion (ARGB int <-> hex), luminance, interpolation
CryptoUtil	Base64 / Hex encoding, MD5 / SHA1 / SHA256 / SHA512 hashing, HMAC, XOR obfuscation
Optional	Null-safe value container (Java Optional style)
Result	Success / failure container with data or error

Development

# Install melos (from workspace root)
dart pub global activate melos
melos bootstrap

# Develop inside this package
cd packages/dartool
dart analyze
dart test

Documentation

• API docs are generated by dart doc
• Source code contains detailed documentation comments
• 中文文档

Contributing

Issues and PRs are welcome. Follow Conventional Commits, respect the lints rules, and add tests for new features.

License

MIT