Flutter Deep Analyzer 🔍 #

A comprehensive static analysis tool for Flutter and Dart projects. Analyzes architecture, code quality, best practices, security vulnerabilities, race conditions, performance issues, and memory leaks.

Features #

Installation #

Add to your pubspec.yaml:

dev_dependencies:
  flutter_deep_analyzer:
    path: ./flutter_deep_analyzer  # Local usage

Usage #

Basic Analysis #

# Run interactive mode (asks for language, category, format, path)
dart run flutter_deep_analyzer analyze

# Full analysis on current directory
dart run flutter_deep_analyzer analyze .

# Security-only analysis
dart run flutter_deep_analyzer analyze --category=security .

# JSON report output
dart run flutter_deep_analyzer analyze --format=json --output=report.json .

# HTML report output
dart run flutter_deep_analyzer analyze --format=html --output=report.html .

# Markdown report output
dart run flutter_deep_analyzer analyze --format=markdown --output=report.md .

Configuration #

Add to your project's analysis_options.yaml:

flutter_deep_analyzer:
  rules:
    architecture:
      god_class_threshold: 10
      max_inheritance_depth: 3
      max_file_lines: 300
      max_constructor_params: 7
    code_quality:
      cyclomatic_complexity_threshold: 10
      max_method_lines: 50
      max_nesting_depth: 4
    security:
      enabled: true
    performance:
      build_complexity_threshold: 80
  exclude:
    - "**/*.g.dart"
    - "**/*.freezed.dart"
    - "**/generated/**"

Scoring System #

Each category and the overall project are scored from 0 to 100:

Penalty weights: Error = -5, Warning = -2, Info = -0.5, Style = -0.25

Output Formats #

• Console — Colorful terminal output with emojis and progress bars
• JSON — Machine-readable for CI/CD integration
• HTML — Modern dark theme report viewable in browser
• Markdown — Visually rich format perfect for GitHub, GitLab, and IDEs

Publishing to pub.dev #

See the Publishing section below.

License #

MIT

Flutter Deep Analyzer 🔍 (Türkçe) #

Flutter ve Dart projeleri için kapsamlı statik analiz aracı. Mimari, kod kalitesi, best practice, güvenlik açıkları, race condition, performans ve bellek sızıntılarını analiz eder.

Özellikler #

Kurulum #

pubspec.yaml dosyanıza ekleyin:

dev_dependencies:
  flutter_deep_analyzer:
    path: ./flutter_deep_analyzer  # Lokal kullanım

Kullanım #

# İnteraktif mod (Dil, Kategori, Format ve Dizin seçimi sorar)
dart run flutter_deep_analyzer analyze

# Tüm kategorilerde mevcut dizinde analiz
dart run flutter_deep_analyzer analyze .

# Sadece güvenlik analizi
dart run flutter_deep_analyzer analyze --category=security .

# JSON rapor çıktısı
dart run flutter_deep_analyzer analyze --format=json --output=report.json .

# HTML rapor çıktısı
dart run flutter_deep_analyzer analyze --format=html --output=report.html .

# Markdown rapor çıktısı
dart run flutter_deep_analyzer analyze --format=markdown --output=report.md .

Konfigürasyon #

Projenizin analysis_options.yaml dosyasına ekleyin:

flutter_deep_analyzer:
  rules:
    architecture:
      god_class_threshold: 10
      max_inheritance_depth: 3
      max_file_lines: 300
      max_constructor_params: 7
    code_quality:
      cyclomatic_complexity_threshold: 10
      max_method_lines: 50
      max_nesting_depth: 4
    security:
      enabled: true
    performance:
      build_complexity_threshold: 80
  exclude:
    - "**/*.g.dart"
    - "**/*.freezed.dart"
    - "**/generated/**"

Puanlama Sistemi #

Her kategori ve genel proje 0-100 arası puanlanır:

Ceza ağırlıkları: Error = -5, Warning = -2, Info = -0.5, Style = -0.25

Çıktı Formatları #

• Console — Renkli, emoji destekli terminal çıktısı
• JSON — CI/CD entegrasyonu için makine tarafından okunabilir
• HTML — Tarayıcıda açılabilir modern dark theme rapor
• Markdown — GitHub, GitLab ve IDE'lerde görüntülemek için çok uygun görsel format

pub.dev'e Yayınlama #

1. Ön Hazırlık #

# pubspec.yaml'ın doğru olduğundan emin olun
# Gerekli alanlar: name, version, description, repository, environment

# CHANGELOG.md oluşturun
touch CHANGELOG.md

# LICENSE dosyası oluşturun
touch LICENSE

2. pubspec.yaml Kontrol Listesi #

pubspec.yaml'da şu alanların dolu olması gerekir:

name: flutter_deep_analyzer
description: >
  A comprehensive static analysis tool for Flutter and Dart projects.
  Analyzes architecture, code quality, best practices, security,
  race conditions, performance, and memory leaks.
version: 0.1.0
repository: https://github.com/KULLANICI_ADINIZ/flutter_deep_analyzer
homepage: https://github.com/KULLANICI_ADINIZ/flutter_deep_analyzer
issue_tracker: https://github.com/KULLANICI_ADINIZ/flutter_deep_analyzer/issues
topics:
  - analyzer
  - linter
  - static-analysis
  - code-quality
  - flutter

3. Yayınlama Öncesi Kontrol #

# Dry-run ile yayınlama simülasyonu (gerçekten yayınlamaz)
dart pub publish --dry-run

Bu komut şunları kontrol eder:

• pubspec.yaml geçerli mi
• README.md var mı
• CHANGELOG.md var mı
• LICENSE var mı
• Paket boyutu limitleri
• Bağımlılık sorunları

4. Google Hesabı ile Giriş #

dart pub login

Tarayıcı açılır ve Google hesabınızla giriş yaparsınız.

5. Yayınla #

dart pub publish

⚠️ DİKKAT: pub.dev'e yayınlanan paketler geri alınamaz! İlk yayından önce --dry-run ile kontrol edin.

6. Versiyon Güncelleme #

Yeni versiyonlarda:

1. pubspec.yaml'da version'ı güncelleyin
2. CHANGELOG.md'ye değişiklikleri yazın
3. dart pub publish ile tekrar yayınlayın

pub.dev Puan Kriterleri #

pub.dev otomatik puan verir. Yüksek puan için:

• ✅ README.md detaylı olmalı
• ✅ CHANGELOG.md bulunmalı
• ✅ LICENSE dosyası olmalı
• ✅ Tüm public API'lar dökümante edilmeli (dartdoc)
• ✅ dart analyze sıfır hata
• ✅ dart format uygulanmış olmalı
• ✅ Platform desteği belirtilmeli
• ✅ example/ klasörü ile örnek proje