Dart: Configuração de Ambiente Dart e Toolchain

# Passo 1: Verificar instalação
dart --version

# Passo 2: Criar primeiro projeto
dart create hello_dart

# Passo 3: Executar
cd hello_dart && dart run

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

# Instalar via Chocolatey (executar como Administrador)
choco install dart-sdk

# Verificar instalação
dart --version
# Saída esperada: Dart SDK version: 3.x.x

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

# Instalar via Homebrew
brew tap dart-lang/dart
brew install dart

# Verificar instalação
dart --version

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

# Adicionar repositório APT do Dart
sudo apt-get update
sudo apt-get install apt-transport-https
sudo sh -c 'wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add -'
sudo sh -c 'wget -qO- https://storage.googleapis.com/download.dartlang.org/linux/debian/dart_stable.list > /etc/apt/sources.list.d/dart_stable.list'

# Instalar Dart SDK
sudo apt-get update
sudo apt-get install dart

# Verificar instalação
dart --version

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

# Verificar se dart está no PATH
which dart    # macOS/Linux
where dart    # Windows

# Se não encontrado, adicionar ao PATH manualmente
# macOS/Linux: adicionar ao ~/.bashrc ou ~/.zshrc
export PATH="$PATH:/usr/lib/dart/bin"

# Windows: adicionar o diretório bin do Dart SDK ao PATH do Sistema

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Dart: Run",
      "type": "dart",
      "request": "launch",
      "program": "bin/main.dart"
    }
  ]
}

# Executar um único arquivo
dart run bin/main.dart

# Executar um projeto (usando pubspec.yaml)
dart run

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

# Compilar para executável autônomo
dart compile exe bin/main.dart -o datapipeline

# Executar o executável
./datapipeline

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

# Formatar todos os arquivos Dart no diretório atual
dart format .

# Formatar arquivo específico
dart format lib/main.dart

# Verificar formatação sem modificar arquivos
dart format --set-exit-if-changed .

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

# Analisar projeto atual
dart analyze

# Analisar com infos fatais
dart analyze --fatal-infos

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

# Criar aplicação de console
dart create -t console-simple my_pipeline

# Estrutura do projeto
# my_pipeline/
# ├── bin/
# │   └── my_pipeline.dart    # Ponto de entrada
# ├── lib/
# │   └── my_pipeline.dart    # Código da biblioteca
# ├── test/
# │   └── my_pipeline_test.dart
# ├── pubspec.yaml            # Dependências
# └── analysis_options.yaml   # Regras de lint

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

name: datapipeline
description: Uma ferramenta CLI para análise de dados de e-commerce
version: 1.0.0

environment:
  sdk: ^3.0.0

dependencies:
  args: ^2.4.2
  http: ^1.2.0
  csv: ^6.0.0

dev_dependencies:
  test: ^1.24.0
  build_runner: ^2.4.0

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

// Primeiro programa Dart da Alice
void main() {
  print('Hello, Dart!');
  print('Bem-vindo ao projeto DataPipeline.');
}

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

Hello, Dart!
Bem-vindo ao projeto DataPipeline.

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

// Hello World com argumentos de linha de comando
void main(List<String> arguments) {
  final name = arguments.isNotEmpty ? arguments[0] : 'World';
  print('Hello, $name!');

  if (arguments.length > 1) {
    print('Argumentos adicionais: ${arguments.sublist(1)}');
  }
}

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

Hello, Alice!
Argumentos adicionais: [--verbose]

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

// Parsing de argumentos CLI profissional com pacote args
import 'package:args/args.dart';

void main(List<String> arguments) {
  final parser = ArgParser()
    ..addOption('name', abbr: 'n', defaultsTo: 'World', help: 'Seu nome')
    ..addFlag('verbose', abbr: 'v', defaultsTo: false, help: 'Mostrar saída detalhada');

  final results = parser.parse(arguments);
  final name = results['name'] as String;
  final verbose = results['verbose'] as bool;

  print('Hello, $name!');
  if (verbose) {
    print('Executando em modo verbose');
  }
}

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

// ============================================
// DataPipeline CLI - Configuração Inicial
// Um esqueleto de ferramenta CLI profissional
// ============================================

import 'package:args/args.dart';

const String version = '1.0.0';

void main(List<String> arguments) {
  final parser = ArgParser()
    ..addFlag('version', abbr: 'v', negatable: false, help: 'Mostrar versão')
    ..addFlag('help', abbr: 'h', negatable: false, help: 'Mostrar ajuda')
    ..addOption('input', abbr: 'i', help: 'Caminho da fonte de dados de entrada')
    ..addOption('output', abbr: 'o', defaultsTo: 'report.json', help: 'Caminho do arquivo de saída')
    ..addOption('format', allowed: ['json', 'csv', 'html'], defaultsTo: 'json', help: 'Formato de saída')
    ..addFlag('verbose', help: 'Ativar log detalhado');

  try {
    final results = parser.parse(arguments);

    if (results['help'] as bool) {
      print('DataPipeline - Ferramenta CLI de análise de e-commerce');
      print(parser.usage);
      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;

    if (input == null) {
      print('Erro: --input é obrigatório');
      print(parser.usage);
      return;
    }

    print('=== DataPipeline v$version ===');
    if (verbose) {
      print('Input:  $input');
      print('Output: $output');
      print('Format: $format');
    }
    print('Processando dados de: $input');
    print('Relatório salvo em: $output (formato $format)');
  } on FormatException catch (e) {
    print('Erro: ${e.message}');
    print(parser.usage);
  }
}

> **Saída:** Execute em um DartPad local ou com `dart run`. Todos os exemplos do curso Dart são baseados em Dart 3.x / Flutter 3.x. Os resultados podem variar ligeiramente com a versão do SDK.

=== DataPipeline v1.0.0 ===
Input:  orders.csv
Output: report.json
Format: json
Processando dados de: orders.csv
Relatório salvo em: report.json (formato json)