armyknife_exceptions 1.0.0+2

Utilities for exceptions.

Golang のerrorsパッケージのような例外トレース Util を提供する Dart ライブラリです。例外の内部にある例外を取り出したり、例外チェーンをトレースすることができます。

Features

• 例外のアンラップ: 例外の内部にある例外を取り出すことができる
• 例外の検索: 指定の型の例外を例外チェーンから検索できる
• 例外チェーンの列挙: 例外に含まれるすべての例外を列挙できる
• カスタムアンラッパー: 独自の例外アンラップ処理を追加できる

Getting started

pubspec.yamlに依存関係を追加してください：

dependencies:
  armyknife_exceptions: ^1.0.0

その後、pub getを実行してパッケージをインストールしてください。

Usage

基本的な使用例

import 'package:armyknife_exceptions/armyknife_exceptions.dart';

void main() {
  try {
    // 何らかの処理
    throwNestedException();
  } catch (e) {
    if (e is Exception) {
      // 例外チェーンをすべて列挙
      for (final exception in Exceptions.unwrap(e)) {
        print('Exception: $exception');
      }

      // 特定の型の例外を検索
      final specificException = Exceptions.find<ArgumentError>(e);
      if (specificException != null) {
        print('Found ArgumentError: $specificException');
      }
    }
  }
}

カスタムアンラッパーの追加

// カスタム例外アンラップ処理を追加
Exceptions.addUnwrapper((exception) {
  if (exception is YourCustomException) {
    return exception.innerException;
  }
  return null;
});

Additional information

このパッケージは、Dart の例外処理をより柔軟にするために開発されました。Golang のerrorsパッケージからインスピレーションを得ており、例外チェーンの処理を簡単にします。

パッケージに関する質問や問題があれば、GitHub の Issue で報告してください。