Dart パッケージ管理 — pub エコシステムと依存関係

dependencies:
  http: ^1.2.0       # 1.x と互換、安全なマイナー/パッチ更新
  args: ^2.4.2        # 2.x と互換
  csv: ^6.0.0         # 6.x と互換

name: datapipeline
description: A CLI tool for e-commerce data analytics processing million-level orders
version: 1.0.0
homepage: https://github.com/bob/datapipeline
repository: https://github.com/bob/datapipeline
documentation: https://datapipeline.dev/docs

environment:
  sdk: ^3.0.0

dependencies:
  # CLI 引数解析
  args: ^2.4.2
  # API 呼び出し用 HTTP クライアント
  http: ^1.2.0
  # CSV ファイルパース
  csv: ^6.0.0
  # SQLite データベースサポート
  sqlite3: ^2.4.0
  # パス操作ユーティリティ
  path: ^1.9.0
  # ロギングフレームワーク
  logging: ^1.2.0
  # YAML 設定パース
  yaml: ^3.1.2

dev_dependencies:
  # テストフレームワーク
  test: ^1.24.0
  # コード生成ランナー
  build_runner: ^2.4.0
  # JSON シリアライゼーション
  json_serializable: ^6.7.0
  # Lint ルール
  lints: ^3.0.0

dependency_overrides:
  # 一時的：バージョン競合の解決
  # transitive: ^1.0.0

executables:
  datapipeline: datapipeline

dependencies:
  # キャレット構文: ^1.2.3 = >=1.2.3 <2.0.0
  package_a: ^1.2.3

  # 範囲構文
  package_b: ">=1.2.3 <2.0.0"

  # 最小バージョン
  package_c: ">=1.2.3"

  # 任意バージョン（危険！）
  package_d: any

  # 厳密バージョン
  package_e: "1.2.3"

  # Git 依存関係
  package_f:
    git:
      url: https://github.com/user/package_f.git
      ref: main

  # パス依存関係（ローカル開発）
  package_g:
    path: ../package_g

# シナリオ：package_a は http ^0.13.0 を要求、package_b は http ^1.0.0 を要求
# これはメジャーバージョンの競合 - 互換性なし！

# 解決策 1：package_a を http ^1.0.0 をサポートするバージョンに更新
# 解決策 2：dependency_overrides を使用（最後の手段）
dependencies:
  http: ^1.2.0

dependency_overrides:
  http: ^1.2.0  # 特定バージョンを強制

# DataPipeline パッケージ選択基準：
#
# args (pub points: 140/140, likes: 300+)
#   - 公式 Dart チームパッケージ
#   - 安定した API、よく文書化されている
#   - CLI 引数解析に最適
#
# http (pub points: 140/140, likes: 1000+)
#   - 公式 Dart チームパッケージ
#   - 標準 HTTP クライアント
#   - インターセプターとストリーミングをサポート
#
# csv (pub points: 130/140, likes: 100+)
#   - コミュニティパッケージ
#   - CSV パース/書き込みを処理
#   - アクティブなメンテナンス
#
# json_serializable (pub points: 140/140, likes: 500+)
#   - Google パッケージ
#   - JSON のコード生成
#   - 型安全、AOT 対応

dependencies:
  # パブリック git リポジトリ
  custom_client:
    git:
      url: https://github.com/bob/custom_client.git
      ref: v1.0.0  # タグ、ブランチ、またはコミット

  # プライベート git リポジトリ (SSH)
  internal_sdk:
    git:
      url: git@github.com:bob/internal_sdk.git
      ref: main

  # git リポジトリ内の特定パス
  shared_utils:
    git:
      url: https://github.com/bob/monorepo.git
      path: packages/shared_utils
      ref: stable

# ローカル開発とテスト用
dependencies:
  core_lib:
    path: ../core_lib

  shared_models:
    path: ./packages/shared_models

name: datapipeline
description: E-commerce analytics CLI tool for processing million-level orders
version: 1.0.0

environment:
  sdk: ^3.0.0

dependencies:
  # CLI フレームワーク
  args: ^2.4.2
  # コンソール出力フォーマット
  cli_util: ^0.4.1
  # HTTP クライアント
  http: ^1.2.0
  # CSV パース
  csv: ^6.0.0
  # JSON シリアライゼーション
  json_annotation: ^4.8.0
  # パスユーティリティ
  path: ^1.9.0
  # ロギング
  logging: ^1.2.0
  # YAML 設定
  yaml: ^3.1.2

dev_dependencies:
  # テスト
  test: ^1.24.0
  # モック
  mockito: ^5.4.0
  # コード生成
  build_runner: ^2.4.0
  json_serializable: ^6.7.0
  # リント
  lints: ^3.0.0
  # カバレッジ
  coverage: ^1.6.0

// ============================================
// DataPipeline 依存関係管理デモ
// 主要依存関係の使い方を示す
// ============================================

import 'package:args/args.dart';
import 'package:path/path.dart' as p;

const String version = '1.0.0';

class DataPipelineCli {
  final ArgParser parser;

  DataPipelineCli()
      : parser = ArgParser()
          ..addFlag('version', abbr: 'v', negatable: false, help: 'Show version')
          ..addFlag('help', abbr: 'h', negatable: false, help: 'Show help')
          ..addOption('input', abbr: 'i', help: 'Input data source')
          ..addOption('output', abbr: 'o', defaultsTo: 'report.json', help: 'Output path')
          ..addOption('format', allowed: ['json', 'csv', 'html'], defaultsTo: 'json')
          ..addFlag('verbose', abbr: 'V', help: 'Verbose logging')
          ..addOption('batch-size', defaultsTo: '10000', help: 'Records per batch');

  Future<void> run(List<String> arguments) async {
    try {
      final results = parser.parse(arguments);

      if (results['help'] as bool) {
        _printHelp();
        return;
      }

      if (results['version'] as bool) {
        print('DataPipeline v$version');
        return;
      }

      final input = results['input'] as String?;
      final output = results['output'] as String;
      final format = results['format'] as String;
      final verbose = results['verbose'] as bool;
      final batchSize = int.parse(results['batch-size'] as String);

      if (input == null) {
        print('Error: --input is required');
        _printHelp();
        return;
      }

      // path パッケージをクロスプラットフォームパスに使用
      final inputPath = p.normalize(input);
      final outputPath = p.normalize(output);
      final ext = p.extension(inputPath);

      print('=== DataPipeline v$version ===');
      if (verbose) {
        print('Input:      $inputPath (${ext.isEmpty ? "unknown" : ext})');
        print('Output:     $outputPath');
        print('Format:     $format');
        print('Batch size: $batchSize records');
        print('SDK:        ${_getSdkInfo()}');
      }

      print('Processing: $inputPath → $outputPath ($format)');
    } on FormatException catch (e) {
      print('Argument error: ${e.message}');
      print(parser.usage);
    }
  }

  void _printHelp() {
    print('DataPipeline - E-commerce analytics CLI tool');
    print('');
    print('Usage: datapipeline [options]');
    print(parser.usage);
  }

  String _getSdkInfo() {
    // 実際のプロジェクトでは dart:io Platform を使用
    return 'Dart 3.x';
  }
}

void main(List<String> arguments) async {
  final cli = DataPipelineCli();
  await cli.run(arguments);
}

> 出力： ローカルの DartPad または `dart run` で実行してください。この Dart コースの全例は Dart 3.x / Flutter 3.x ベースです。SDK バージョンにより結果が多少異なる場合があります。

=== DataPipeline v1.0.0 ===
Input:      orders.csv (.csv)
Output:     report.json
Format:     json
Batch size: 10000 records
SDK:        Dart 3.x
Processing: orders.csv → report.json (json)