uqload_downloader_dart 1.0.2

A Dart library for downloading videos from UQLoad.io

example/example.dart

import 'package:uqload_downloader_dart/uqload_downloader_dart.dart';

/// Exemple complet d'utilisation de UQLoad Downloader Dart
void main() async {
  print('🎬 === Exemple UQLoad Downloader Dart ===\n');

  // URL d'exemple UQLoad (remplacez par une vraie URL pour tester)
  const String videoUrl = 'https://uqload.cx/embed-abc123def456.html';

  // Exemple 1: Récupérer les informations d'une vidéo
  await demonstrateVideoInfo(videoUrl);

  // Exemple 2: Téléchargement avec barre de progression
  await demonstrateDownloadWithProgress(videoUrl);

  // Exemple 3: Téléchargement simple
  await demonstrateSimpleDownload(videoUrl);

  // Exemple 4: Validation d'URL et utilitaires
  demonstrateUtilities();

  print('\n✅ Tous les exemples sont terminés !');
  print('💡 Pour tester avec une vraie vidéo, remplacez l\'URL dans le code.');
}

/// Exemple: Récupération des informations d'une vidéo
Future<void> demonstrateVideoInfo(String url) async {
  print('📋 === Récupération des informations vidéo ===');

  try {
    final downloader = UQLoad(url: url);

    print('🔍 Récupération des informations...');
    final info = await downloader.getVideoInfo();

    print('✅ Informations récupérées:');
    print('   📹 Titre: ${info.title}');
    print('   📐 Résolution: ${info.resolution ?? 'Inconnue'}');
    print('   ⏱️  Durée: ${info.duration ?? 'Inconnue'}');
    print('   💾 Taille: ${sizeOfFmt(info.size)}');
    print('   🔗 URL directe: ${info.url.substring(0, 50)}...');
  } catch (e) {
    print('❌ Erreur: $e');
  }
  print('');
}

/// Exemple: Téléchargement avec callback de progression
Future<void> demonstrateDownloadWithProgress(String url) async {
  print('📥 === Téléchargement avec barre de progression ===');

  ProgressBar? progressBar;

  // Callback de progression personnalisé
  void onProgress(int downloaded, int total) {
    // Initialiser la barre de progression à la première utilisation
    progressBar ??= ProgressBar(total: total);
    progressBar!.update(downloaded);
  }

  try {
    final downloader = UQLoad(
      url: url,
      outputFile: 'ma_video_avec_progress',
      outputDir: './downloads',
      onProgressCallback: onProgress,
    );

    print('🚀 Démarrage du téléchargement avec progression...');
    await downloader.download();
    print('\n✅ Téléchargement terminé avec succès !');
  } catch (e) {
    print('❌ Erreur lors du téléchargement: $e');
  }
  print('');
}

/// Exemple: Téléchargement simple sans progression
Future<void> demonstrateSimpleDownload(String url) async {
  print('⬇️  === Téléchargement simple ===');

  try {
    // Téléchargement basique
    final downloader = UQLoad(url: url, outputFile: 'ma_video_simple');

    print('📥 Téléchargement en cours...');
    await downloader.download();
    print('✅ Téléchargement terminé !');
  } catch (e) {
    print('❌ Erreur: $e');
  }
  print('');
}

/// Exemple: Utilisation des fonctions utilitaires
void demonstrateUtilities() {
  print('🛠️  === Fonctions utilitaires ===');

  // Test de validation d'URL
  final urls = [
    'https://uqload.cx/embed-abc123def456.html',
    'https://uqload.co/embed-xyz789.html',
    'https://google.com',
    'invalid-url',
  ];

  print('🔗 Validation des URLs:');
  for (final url in urls) {
    final isValid = isUqloadUrl(url);
    final status = isValid ? '✅' : '❌';
    print('   $status $url');
  }

  // Test de formatage des tailles
  print('\n📊 Formatage des tailles:');
  final sizes = [1024, 1048576, 1073741824, 1234567890];
  for (final size in sizes) {
    print('   $size bytes = ${sizeOfFmt(size)}');
  }

  // Test de nettoyage des caractères spéciaux
  print('\n🧹 Nettoyage des noms de fichiers:');
  final filenames = [
    'Vidéo Test@#File!.mp4',
    'Mon Film [2024].avi',
    'Série/Episode\\1.mkv',
  ];
  for (final filename in filenames) {
    print('   "$filename" → "${removeSpecialCharacters(filename)}"');
  }

  print('');
}